docs: daily maintenance loop — 2026-06-08

[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 option/argument tables from generated CLI docs. Added _is_option()/_is_argument() helpers that check both class trees.
• Enrich 4 draft CLI docstrings — approve, schedule, post-now, quick-approve now document that non-auto-postable vehicles (e.g. articles) are redirected to advisory flow (matches behavior from PR fix: add auto_postable check to schedule_optimal and schedule_custom #78).
• Regenerate CLI docs — draft.md updated with enriched docstrings.
• Update DOC_STATUS.md — all 11 recurring checks pass, dates bumped to 2026-06-08, added ruff format check.

Changes since last run (11 commits)

• PR fix: add auto_postable check to schedule_optimal and schedule_custom #78 — auto_postable check added to bot scheduling + CLI draft commands
• PR docs: daily maintenance loop — 2026-04-16 #79 — Previous docs maintenance loop (merged 2026-04-16)
• PR Release: content vehicles, advisory flow, diagnostics #80 — develop → main merge
• PR chore(main): release 0.13.0 #81 — Release v0.13.0

No new backlog approvals

Checked PR #79, #98, #100 comments — no items approved for implementation.

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

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

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 #100, #99, #98, #97, #96, #95, #94, #93, #92, #91 and earlier open maintenance PRs covering the same period.

State

• last_run_commit: e0675da → 1afe4f1
• last_run_date: 2026-04-16 → 2026-06-08

https://claude.ai/code/session_01QFNuM4x4CwPeYKXBbr7sDi

---

Generated by Claude Code