docs: daily maintenance loop — 2026-06-11 through 2026-06-13

[nj-io]

Summary

• Fix generate_cli_docs.py for Typer 0.26.7 — TyperOption/TyperArgument no longer inherit from click.Option/click.Argument, so isinstance checks silently dropped all options/arguments tables from generated CLI docs (1135 lines lost). Added _is_option()/_is_argument() helpers that check both class trees.
• Fix help --json command for Typer 0.26.7 — same isinstance issue in cli/__init__.py caused options and arguments to be silently dropped from JSON output. Applied the same fix.
• Enrich 11 terse CLI group help texts — arc, bot, config, decision, draft, inspect, logs, manual, media, memory, snapshot (terse 2–4 word labels → descriptive sentences explaining what each group does). All 24 CLI groups now have enriched help.
• Regenerate CLI docs — 12 files updated with enriched descriptions.
• Add ruff format recurring check to DOC_STATUS.md.
• Update all recurring check dates to 2026-06-13 (all 11 checks pass, re-verified).

Changes since last merged run (10 commits)

• Release 0.12.0 (chore(main): release 0.12.0 #74) and 0.13.0 (chore(main): release 0.13.0 #81)
• develop → main merge (Release: content vehicles, advisory flow, diagnostics #80)
• Previous docs maintenance merged (docs: daily maintenance loop — 2026-04-16 #79)
• Advisory auto_postable check in bot scheduling (fix: add auto_postable check to schedule_optimal and schedule_custom #78)
• Ruff format fixes + loop config update

No new backlog approvals

Checked PR #104 and #79 comments — only Codecov bot, no items approved for implementation.

All recurring checks pass (re-verified 2026-06-13)

Check	Status
CLI docs fresh (after generator fix)	PASS
mkdocs.yml nav matches files (24/24)	PASS
OAuth 2.0 env vars in config.md	PASS
ruff check	PASS
ruff format	PASS
mypy (28 pre-existing errors only)	PASS
CLI docstrings enriched	PASS
pipeline.md two-stage eval	PASS
narrative-arcs.md episode_tags	PASS
Non-interactive CLI equivalents	PASS
All group help text enriched	PASS (all 24 groups)

Waiting for review

No new items. 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, create/suggest paths)
• Testing guide
• E2E test reference

Note: Supersedes #103, #102, #101, #100, #99, #98, #97, #96, #95, #94, #93 and earlier open maintenance PRs covering the same period.

https://claude.ai/code/session_016zD9Z67JC2TnzaJ4Vh12mp