docs: daily maintenance loop — 2026-06-25

[nj-io]

Summary

• Fix CLI doc generator for Typer 0.26 — generate_cli_docs.py used isinstance(p, click.Option) / isinstance(p, click.Argument) checks that silently broke when Typer 0.26 decoupled TyperOption/TyperArgument from Click's class hierarchy. All option/argument tables were being silently dropped from regenerated docs. Fixed by importing and checking against both type families.
• Enrich 12 CLI group help texts — arc, bot, config, decision, draft, inspect, logs, manual, media, memory, snapshot, account upgraded from terse one-liners to descriptive multi-sentence help
• Regenerate CLI docs — all 24 files updated with enriched descriptions and restored option tables
• All 10 recurring checks pass — ruff check, ruff format, mypy (28 pre-existing), CLI doc freshness, mkdocs nav, OAuth naming, pipeline accuracy, narrative-arcs accuracy, non-interactive CLI equivalents, group help enrichment

Changes since last run (11 commits)

• Release 0.13.0 (content vehicles, advisory flow, diagnostics)
• PR fix: add auto_postable check to schedule_optimal and schedule_custom #78 — auto_postable check fix for bot schedule buttons
• PR docs: daily maintenance loop — 2026-04-16 #79 — previous docs maintenance run (merged into develop → main)

No new backlog approvals

Checked PR #79, #80, #81 comments — no items approved for implementation.

Waiting for review

No new items this run. Existing backlog unchanged:

• Targets concept page
• Topics concept page
• Routing concept page
• Web dashboard usage guide (feat: cross-post references with abstract adapter interface #19)
• Workflow tutorials (Develop #20)
• examples/ directory (feat: snapshots, decision rewind, cross-post references, and E2E overhaul #22)
• Scheduling deep-dive
• config.md expansion (rate_limits, identities, content_strategies, etc.)
• pipeline.md update (content vehicles, advisory flow)
• Testing guide
• E2E test reference

State

• last_run_commit: e0675da → 1afe4f1
• Changes since last run: 11 commits
• last_run_date: 2026-04-16 → 2026-06-25

https://claude.ai/code/session_01CDeYhFViKdTTBVhpLiDoZb

---

Generated by Claude Code