Skip to content

Generate Click CLI catalog for docs site - #149

Merged
wasimxyz merged 2 commits into
stagingfrom
watcher-cli-catalog
Jul 15, 2026
Merged

Generate Click CLI catalog for docs site#149
wasimxyz merged 2 commits into
stagingfrom
watcher-cli-catalog

Conversation

@wasimxyz

@wasimxyz wasimxyz commented Jul 15, 2026

Copy link
Copy Markdown
Member

Summary

  • Add a Click tree walker (cli_catalog.py) that dumps the watcher CLI surface to JSON for the docs site
  • Wire make py-watcher-cli-catalog and gitignore the local dump; docs repo commits the snapshot
  • Document the regenerate → copy workflow in AGENTS.md

Test plan

  • uv run pytest watcher/tests/test_cli_catalog.py
  • make py-watcher-cli-catalog writes watcher/cli-catalog.snapshot.json
  • make check-all

Made with Cursor

Walk the watcher Click tree into JSON so data-hub-docs can render and export the command reference without hand-maintaining flag tables.

Co-authored-by: Cursor <cursoragent@cursor.com>
@vercel

vercel Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
data-hub Ready Ready Preview, Comment Jul 15, 2026 3:29pm

Request Review

@wasimxyz wasimxyz self-assigned this Jul 15, 2026
Route `main()` through `write_cli_catalog_snapshot` (was dead code) via a
shared serializer, clarify that the tests are walker smoke checks rather than
a docs-snapshot drift guard, and replace the tautological default-path test
with determinism and write round-trip coverage.

Co-authored-by: Cursor <cursoragent@cursor.com>
@wasimxyz
wasimxyz merged commit 007388c into staging Jul 15, 2026
7 checks passed
@wasimxyz
wasimxyz deleted the watcher-cli-catalog branch July 15, 2026 15:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant