docs: daily maintenance loop — 2026-06-01 through 2026-06-03

[nj-io]

Summary

• Fix generate_cli_docs.py Typer 0.26.4 compatibility: TyperOption/TyperArgument no longer subclass click.Option/click.Argument in Typer 0.26.4, causing all option/argument tables to be silently dropped from generated CLI docs. Added typer.core type checks as fallback.
• Fix _cmd_to_dict() Typer 0.26.x compatibility (CI fix): Same isinstance issue affected the help --json command — options and arguments were silently dropped from JSON output. Applied the same typer.core fallback pattern. Added type annotation for global_options and type: ignore for Typer/Click context interop.
• Fix quickstart tests for Typer 0.26.x: Tests caught click.exceptions.Exit but Typer now raises typer.Exit (a distinct type). Updated to catch (typer.Exit, SystemExit).
• Enrich 10 terse CLI group help texts: arc, bot, config, decision, draft, inspect, manual, media, memory, snapshot — terse 2–4 word labels replaced with descriptive sentences explaining what each group does. All 24 CLI groups now have enriched help.
• Enrich advisory flow docstrings: approve, schedule, post-now, and quick-approve now document that non-auto-postable content vehicles (e.g. articles) are redirected to advisory flow — matches behavior added in PR fix: add auto_postable check to schedule_optimal and schedule_custom #78.
• Regenerate CLI docs: 11 files updated (10 group pages + index + draft.md).
• Add ruff format recurring check to DOC_STATUS.md.
• Update DOC_STATUS.md: All 11 recurring checks pass, dates updated to 2026-06-03.

Changes since last merged run (11 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 #79, #80, #81, #78 comments — only Codecov bot and release-please bot, no items approved for implementation.

All recurring checks pass (verified 2026-06-03)

Check	Status
CLI docs fresh	PASS (after generator fix)
mkdocs.yml nav matches files	PASS (24/24)
OAuth 2.0 env vars in config.md	PASS
ruff check	PASS
ruff format	PASS
mypy (28 pre-existing errors only)	PASS (fixed 3 Typer/Click type errors)
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

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 #97, #96, #95, #94, #93, #92, #91, #90, #89, #88, #87, #86, #85, #83, #82 — earlier open maintenance PRs covering the same period.

State

• last_run_commit: e0675da → 1afe4f1
• last_run_date: 2026-04-16 → 2026-06-03
• 2026-06-03: Fixed CI failures (Typer 0.26.x compat in _cmd_to_dict + quickstart tests)

https://claude.ai/code/session_01FEp3zRR4RoWLdUNr5LFAv3