updated docs again

Author: JoshuaEstes

docs/tools/chorale.md

@@ -15,16 +15,16 @@ Run the commands from the project root:
 
 ```bash
 # create chorale.yaml by scanning packages
-php bin/chorale setup
+chorale setup
 
 # preview changes without modifying files
-php bin/chorale plan --json > plan.json
+chorale plan --json > plan.json
 
 # apply an exported plan
-php bin/chorale apply --file plan.json
+chorale apply --file plan.json
 
 # build and apply a plan in one go
-php bin/chorale run
+chorale run
 ```
 
 Chorale automatically merges all package `composer.json` files into the root `composer.json` so the monorepo can be installed as a single package. Any dependency conflicts are recorded under the `extra.chorale.dependency-conflicts` section for review.

docs/tools/chorale/mirroring.md

@@ -1,5 +1,7 @@
 # Mirroring & Overrides
 
+See also: [Rule Matrix & Examples](rules-matrix.md) for side‑by‑side input→output transformations of each rule.
+
 Chorale can mirror and merge selected keys from the root `composer.json` into each package’s `composer.json`.
 This is fully opt‑in and controlled through `chorale.yaml` rules and per‑package overrides.
 
@@ -79,4 +81,3 @@ targets:
 
 - `plan --json` includes the exact `apply` object per package.
 - Root steps include `meta.delta_*` with counts for added/removed/changed.
-

docs/tools/chorale/plan.md

@@ -13,7 +13,7 @@ The `plan` command is an advanced dry‑run that inspects your monorepo and prin
 ## Usage
 
 ```bash
-php tools/chorale/bin/chorale plan [<vendor/name>] [options]
+chorale plan [<vendor/name>] [options]
 ```
 
 - `<vendor/name>`: Optional composer package name to focus on a single package
@@ -34,25 +34,25 @@ php tools/chorale/bin/chorale plan [<vendor/name>] [options]
 
 ```bash
 # All packages, detailed output
-php tools/chorale/bin/chorale plan
+chorale plan
 
 # Concise one‑liners
-php tools/chorale/bin/chorale plan --concise
+chorale plan --concise
 
 # Show no‑ops too
-php tools/chorale/bin/chorale plan --show-all
+chorale plan --show-all
 
 # JSON output for apply
-php tools/chorale/bin/chorale plan --json > plan.json
+chorale plan --json > plan.json
 
 # Focus on one package by composer name
-php tools/chorale/bin/chorale plan sonsofphp/cache
+chorale plan sonsofphp/cache
 
 # Focused + concise
-php tools/chorale/bin/chorale plan sonsofphp/cache --concise
+chorale plan sonsofphp/cache --concise
 
 # Limit discovery to a folder (path)
-php tools/chorale/bin/chorale plan --paths src/SonsOfPHP/Component/Cache
+chorale plan --paths src/SonsOfPHP/Component/Cache
 ```
 
 ## Output Breakdown
@@ -106,4 +106,3 @@ Example snippet (root update):
 - Use `--concise` for quick scans, and omit it to see exact JSON diffs.
 - Combine the positional `<vendor/name>` with `--json` to isolate and export a single package’s plan.
 - For CI checks, run with `--strict` so the command exits non‑zero when action is required.
-