docs: daily maintenance loop — 2026-05-28 through 2026-05-30

[nj-io]

Summary

• Fix CLI doc generator for Typer 0.26 — generate_cli_docs.py used isinstance(p, click.Option) / click.Argument checks that silently fail with Typer 0.26, where TyperOption/TyperArgument no longer inherit from click.Option/click.Argument. Without this fix, 113 commands lose their Options/Arguments tables in generated docs.
• Enrich 10 terse CLI group help texts — arc, bot, config, decision, draft, inspect, manual, media, memory, snapshot (terse 2–4 word labels → descriptive sentences explaining what each group does). Updated in both module-level Typer() calls and add_typer() calls.
• Regenerate CLI docs — 12 files updated with new help text
• Add ruff format recurring check to DOC_STATUS.md
• Re-verify all 11 recurring checks on 2026-05-30 — all pass

Changes since last merged run (10 commits)

• Release 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 and open maintenance PRs — no items approved for implementation.

All recurring checks pass (re-verified 2026-05-30)

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
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 (10 groups enriched; all 24 have descriptive help)

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)
• Testing guide
• E2E test reference

State

• last_run_commit: e0675da → 1afe4f1
• last_run_date: 2026-04-16 → 2026-05-30
• Changes since last run: 10 commits

Note: Supersedes #95, #94, #93, #92, #91, #90, #89, #88, #87, #86, #85, #83, #82 — earlier open maintenance PRs covering the same period.

https://claude.ai/code/session_012iqGdFWNevsMyeXPmSmK2n