Add integration docs and synthetic command examples

docs/cli.md

@@ -136,28 +136,28 @@ Merge with a speaker map and report output:
 
 ```sh
 go run ./cmd/seriatim merge \
-  --input-file speaker-a.json \
-  --input-file speaker-b.json \
-  --speakers speakers.yml \
-  --output-file merged.json \
-  --report-file merge-report.json
+  --input-file examples/minimal-merge/input-alice.json \
+  --input-file examples/minimal-merge/input-bob.json \
+  --speakers examples/minimal-merge/speakers.yml \
+  --output-file /tmp/seriatim-example-merge.json \
+  --report-file /tmp/seriatim-example-merge-report.json
 ```
 
 Trim to a segment subset:
 
 ```sh
 go run ./cmd/seriatim trim \
-  --input-file merged.json \
-  --output-file trimmed.json \
-  --keep "1-20,25"
+  --input-file examples/trim/input-full.json \
+  --output-file /tmp/seriatim-example-trim.json \
+  --keep "1-2"
 ```
 
 Normalize an external transcript JSON file:
 
 ```sh
 go run ./cmd/seriatim normalize \
-  --input-file external.json \
-  --output-file normalized.json
+  --input-file examples/normalize/object-with-segments.json \
+  --output-file /tmp/seriatim-example-normalize-object.json
 ```
 
 ## Exit and errors
@@ -171,6 +171,10 @@ go run ./cmd/seriatim normalize \
 - Configuration reference: [config.md](config.md)
 - Operations guide: [operations.md](operations.md)
 - Troubleshooting: [troubleshooting.md](troubleshooting.md)
+- Integration notes:
+  - [integrations/whisperx-json.md](integrations/whisperx-json.md)
+  - [integrations/output-schemas.md](integrations/output-schemas.md)
+- Synthetic examples: [../examples/README.md](../examples/README.md)
 - Public output schemas:
   - [../schema/minimal-output.schema.json](../schema/minimal-output.schema.json)
   - [../schema/intermediate-output.schema.json](../schema/intermediate-output.schema.json)