Skip to content

docs: daily maintenance loop — fix CLI doc generator, restore param tables - #105

Open
nj-io wants to merge 2 commits into
mainfrom
docs/maintenance-2026-06-15
Open

nj-io wants to merge 2 commits into
mainfrom
docs/maintenance-2026-06-15

Conversation

@nj-io

@nj-io nj-io commented Jun 15, 2026

Copy link
Copy Markdown
Owner

Summary

  • Fixed generate_cli_docs.py Typer 0.26 compatibility — Typer 0.26 uses TyperOption/TyperArgument classes that don't inherit from click.Option/click.Argument, so the doc generator silently dropped all argument/option tables. Added typer.core types to isinstance checks.
  • Restored all CLI doc param tables — regenerated 24 CLI reference docs with the fixed script; 1135 lines of argument/option tables restored across 23 files.
  • Enriched group-level help text for 4 CLI command groups with terse labels: manual, setup, decision, media (both in source Typer definitions and __init__.py add_typer() calls)
  • Updated DOC_STATUS.md: last_run_date to 2026-06-18, all recurring checks passing

Recurring Checks (all passing)

  • CLI docs fresh — regenerated with fixed script
  • mkdocs.yml nav ↔ site-docs/cli/ files match (24/24)
  • OAuth env vars use OAuth 2.0 names
  • ruff check passes
  • mypy — 28 errors, all pre-existing import-untyped / no-any-return
  • All CLI docstrings enriched
  • pipeline.md accurate
  • narrative-arcs.md uses episode_tags, strategy-scoped
  • Non-interactive CLI equivalents documented
  • All CLI groups have enriched help text

Backlog (unchanged — no approvals found)

State

  • last_run_commit: 1afe4f1 (unchanged — no new code commits since last run)
  • last_run_date: 2026-06-15 → 2026-06-18

https://claude.ai/code/session_01TE3pBYZHRWnP1CgYqz5XRN

claude added 2 commits June 15, 2026 02:10
Enriched group-level help text for manual, setup, decision, and media
CLI command groups. Regenerated CLI reference docs to match current
source. Updated DOC_STATUS.md recurring checks to 2026-06-15.

https://claude.ai/code/session_014N4og9FYquDTAP1JeWmi2T
…_docs.py

Typer 0.26 uses TyperOption/TyperArgument classes that don't inherit from
click.Option/click.Argument, so isinstance checks in the doc generator
silently dropped all argument and option tables. Add typer.core types to
the isinstance tuples so the generator works with both old and new Typer.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TE3pBYZHRWnP1CgYqz5XRN
@nj-io nj-io changed the title docs: daily maintenance loop — 2026-06-15 docs: daily maintenance loop — fix CLI doc generator, restore param tables Jun 18, 2026
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.

2 participants