docs: daily maintenance loop — 2026-06-26

[nj-io]

Summary

• Fix CLI doc generator and help --json for Typer 0.26 — generate_cli_docs.py and cli/__init__.py used isinstance(p, click.Option) / isinstance(p, click.Argument) checks that silently broke when Typer 0.26 decoupled TyperOption/TyperArgument from Click's class hierarchy. All option/argument tables (1135 lines) were being silently dropped from regenerated docs. Fixed by importing and checking against both type families.
• Enrich 10 CLI group help texts — arc, bot, config, decision, draft, inspect, manual, media, memory, snapshot upgraded from terse 2–4 word labels to descriptive multi-sentence help
• Regenerate CLI docs — 11 files updated with enriched descriptions and restored option tables
• All 11 recurring checks pass — ruff check, ruff format, mypy (28 pre-existing), CLI doc freshness, mkdocs nav, OAuth naming, pipeline accuracy, narrative-arcs accuracy, non-interactive CLI equivalents, group help enrichment

Changes since last run (11 commits)

• Release 0.13.0 (content vehicles, advisory flow, diagnostics)
• PR fix: add auto_postable check to schedule_optimal and schedule_custom #78 — auto_postable check fix for bot schedule buttons
• PR docs: daily maintenance loop — 2026-04-16 #79 — previous docs maintenance run (merged into develop → main)

No new backlog approvals

Checked PR #79, #81, #108 comments — no items approved for implementation.

Waiting for review

No new items this run. 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 #108, #107, #106, #105, #104, #103, #102, #101, #100, #99 and earlier open maintenance PRs covering the same period.

State

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

https://claude.ai/code/session_01SJ95dRUDN5yzcqYsWXMJUf

---

Generated by Claude Code