docs: daily maintenance loop — 2026-06-27

[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 typer.core and checking against both type families.
• Fix CI failures from Typer 0.26 type decoupling — 2 mypy arg-type errors in cli/__init__.py (help command Context/get_help type mismatch) fixed with type: ignore[arg-type]; 3 test failures in test_quickstart.py fixed by catching both click.exceptions.Exit and typer.Exit
• Enrich 12 CLI group help texts — arc, bot, config, decision, draft, inspect, logs, manual, media, memory, snapshot, and test upgraded from terse 2–4 word labels to descriptive multi-sentence help (both in source Typer() constructors and add_typer() calls)
• Regenerate CLI docs — 13 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 (24/24), OAuth naming, pipeline accuracy, narrative-arcs accuracy, non-interactive CLI equivalents, group help enrichment

Changes since last merged run (11 commits)

• Release 0.13.0 (chore(main): release 0.13.0 #81) — 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, #80, #81, #110 comments — no items approved for implementation.

2026-07-08 run

No new commits on develop since last run. All 11 recurring checks re-verified and pass. Found and fixed terse project intro subgroup help text (was "Manage per-platform introduction status." → enriched with introduction concept, subcommand guidance). Regenerated CLI docs (project.md updated). Updated check dates to 2026-07-08.

2026-07-07 run

No new commits since last run. All 11 recurring checks re-verified and pass. Updated check dates to 2026-07-07.

2026-07-06 run

No new commits since last run. All 11 recurring checks re-verified and pass. Updated check dates to 2026-07-06.

2026-07-05 run

No new commits since last run. All 11 recurring checks re-verified and pass. Updated check dates to 2026-07-05.

2026-07-03 run

No new commits since last run. All 11 recurring checks re-verified and pass. Updated check dates to 2026-07-03.

2026-07-02 run

No new commits on develop since last run. All 11 recurring checks re-verified and pass. Fixed test CLI group help text (was terse "Test commit evaluation." → enriched with dry-run, --output, --compare context). Regenerated CLI docs (2 files updated). Updated check dates to 2026-07-02.

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, create/suggest paths)
• Testing guide
• E2E test reference

Note: Supersedes #109, #108, #107, #106, #105, #104, #103, #102, #101, #100 and earlier open maintenance PRs covering the same period.

State

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