docs: daily maintenance loop — 2026-05-27

[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.1, where TyperOption no longer inherits from click.Option. Fixed to also match typer.core.TyperOption / TyperArgument. Without this fix, 113 commands lose their Options/Arguments tables in generated docs.
• Enrich 9 remaining terse CLI group help texts — arc, bot, decision, draft, inspect, manual, media, memory, snapshot (terse 2–3 word labels → descriptive sentences explaining what each group does)
• Regenerate CLI docs — 10 files updated with new help text
• Update DOC_STATUS.md — set last_run_commit to 1afe4f1, last_run_date to 2026-05-27, all 10 recurring checks pass

Changes since last run (10 commits)

• Release 0.13.0
• Advisory auto_postable check added to bot scheduling (fix: add auto_postable check to schedule_optimal and schedule_custom #78)
• Previous docs maintenance merged (docs: daily maintenance loop — 2026-04-16 #79)

No new backlog approvals

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

All recurring checks pass

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 (fixed this run — 9 groups enriched)

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

Note: Supersedes #94, #93, #92, #91, #90 and earlier open maintenance PRs covering the same period.

https://claude.ai/code/session_019MCXseJDv9htcsUjfC139g

---

Generated by Claude Code