Generate CLI docs from Go code (#2736)
* Generate CLI docs from Go code
This implements CLI documentation generation using cobra/doc, building on
the work started in #1696.
Changes:
- Add tools/gendocs/ Go tool to generate CLI reference docs
- Generate docs/cli.md from cobra command definitions
- Add mise tasks: docs:cli and docs:cli:check
- Run CLI docs check in CI alongside llms.txt check
- Update AGENTS.md with CLI docs maintenance instructions
Fixes #1696
* Add dependency from docs:llm to docs:cli task
This ensures CLI docs are always generated before being included in llms.txt
Co-authored-by: bfirsh <40906+bfirsh@users.noreply.github.com>
* Restore docs/cli.md that was accidentally deleted
Co-authored-by: bfirsh <40906+bfirsh@users.noreply.github.com>
---------
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: bfirsh <40906+bfirsh@users.noreply.github.com>
