Distillation

Date: Sep 10, 2026

• 🔴 (17:41) User stated the array-extraction invariant: “always remains required and variadic.”
• 🟡 (17:41) Tool diff showed packages/cli/script/generate-command-docs.ts now renders each positional only as `<${p.placeholder}>`, removing optional brackets and variadic ellipses, and no longer imports or emits formatCommandExamples; custom examples, guides, and tips instead belong in committed fragments under docs/src/fragments/.
• 🟡 (17:41) Tool diff showed OrgListCommandDocs in packages/cli/src/lib/list-command.ts narrowed from CommandDocumentation to documentation strings containing required brief and optional fullDescription.
• 🟡 (17:41) Tool diff showed tests for extractPositionals, including the property test named "array extraction always remains required and variadic", were removed from packages/cli/test/lib/introspect.property.test.ts and packages/cli/test/lib/introspect.test.ts.
• 🟡 (17:41) Assistant determined branch divergence was caused by the 0.45.0 release on main and regenerated documentation. Planned sequence: inspect prospective rebase conflicts read-only, finish the source fix, replay it onto current main, then regenerate artifacts once.