docs(v0.35.3): comprehensive audit — sweep /trigger→/listen + add missing feature coverage

[Nathan Schram (nathanschram)]

Summary

Audited every issue in the v0.35.3 milestone (26 issues) against the full repo documentation surface and closed the gaps. Single-commit PR, docs-only — no code or version changes.

Issues whose user-facing docs are touched: #205, #206, #207, #208, #211, #213, #269, #271, #294, #297, #333, #377, #378, #379, #380, #402, #403, #407, #409, #410, #438, #471.

Changes

CHANGELOG.md — added missing entry for #297 (/trigger → /listen rename) under ### changes. Note: 3 other issues attached to the v0.35.3 milestone (#224, #228, #239) are not added to CHANGELOG — their fixes shipped in v0.35.0 / v0.35.1rc2 (per close-comment audit). Per release-discipline.md ("no retroactive edits to prior sections"), they remain undocumented in CHANGELOG; their issue close comments cite the actual versions.

/trigger → /listen rename sweep (5 files):

• README.md (commands table, group-chat link)
• docs/reference/commands-and-directives.md
• docs/reference/transports/telegram.md (command list + admin note)
• docs/reference/integration-testing.md (O3 + Q12 test rows)
• docs/explanation/routing-and-sessions.md (pre-routing filter section)

Runner specs:

• gemini/runner.md — --skip-trust default + [gemini] skip_trust = false opt-out (gemini: pass --skip-trust (or GEMINI_CLI_TRUST_WORKSPACE=true) so headless runs work outside pre-trusted folders #471)
• claude/runner.md — post-result idle watchdog + ✓ turn complete meta hint (investigate: Claude CLI session stays alive for ~36 min after final result event (idle-but-alive UX gap) #333), claude_stream_idle_timeout_ms config + Type-A/B classifier (bug: Stream idle timeout - partial response received on long opus 4.7 plan-mode runs (upstream Anthropic API stall) #438)
• amp/runner.md — already correct (no edit)

How-to guides:

• schedule-tasks.md — trigger provenance + /stats triggered/manual breakdown (feat: trigger visibility — indicators, discovery, and run history #271 Tier 3); master pause/resume toggle (feat: master trigger pause toggle in /config menu #294)
• inline-settings.md — new Triggers page section (feat: trigger visibility — indicators, discovery, and run history #271 Tier 2 + feat: master trigger pause toggle in /config menu #294)
• troubleshooting.md — Type-A/B stream idle classification (bug: Stream idle timeout - partial response received on long opus 4.7 plan-mode runs (upstream Anthropic API stall) #438); post-result idle watchdog + ✓ turn complete (investigate: Claude CLI session stays alive for ~36 min after final result event (idle-but-alive UX gap) #333)
• security.md — extended path-redaction coverage (security: stderr sanitisation regex doesn't cover all path formats #208); Pi session dirs 0o700 (security: Pi runner session directory permissions not explicitly set #207)
• subscription-usage.md — /usage debug section (bug: subscription usage footer still unreliable post-#316 — needs investigation + observability #410)
• operations.md — pause status surfacing in /health (feat: master trigger pause toggle in /config menu #294); /usage debug cross-link (bug: subscription usage footer still unreliable post-#316 — needs investigation + observability #410); expanded hot-reload list to include [progress] (feat: hot-reload support for triggers, watchdog, and progress settings #269), [watchdog] (investigate: Claude CLI session stays alive for ~36 min after final result event (idle-but-alive UX gap) #333, bug: Stream idle timeout - partial response received on long opus 4.7 plan-mode runs (upstream Anthropic API stall) #438), [footer], [cost]

README.md — features bullets (scheduled tasks, inline settings) + 4 command table rows (/usage debug, /listen, Triggers page).

Verified

• python3 scripts/validate_release.py → passes (rc6 pre-release skip)
• grep -rnE "/trigger\\b" docs/ README.md → zero non-deprecation hits in production docs (only the legitimate "Renamed from /trigger in v0.35.3" notice in group-chat.md)
• All 22 issues touched have ≥1 file mention; cross-references resolve to existing anchors
• AGENTS.md / GEMINI.md show no drift on the same search terms

Out of scope

• chore(security): dismiss 'HTTP basic authentication header' secret-scanning alert (test fixture) #404 — secret-scanning alert dismissal (admin hygiene, not a doc gap)
• llms-full.txt — 380 KB, ~10 stale /trigger hits. Recommended as a separate follow-up issue rather than hand-edit (regen from current docs is safer)
• [Pi] Model override via /model set doesn't change --provider, blocking cross-provider model swaps #224, Improve error hint for Claude Code session archival failures #228, enhancement: /config toggle button UX is ambiguous for boolean settings #239 — already shipped earlier; no retroactive CHANGELOG edits per repo policy

Test plan

• CI: format, ruff, ty, pytest matrix, build, lockfile, install-test
• Visual smoke: render the changed how-to + reference docs (Zensical) and verify section anchors render correctly
• Cross-doc consistency: grep -rnE "/trigger\\b" docs/ README.md after merge

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 69d769c3-30eb-45f9-be46-85527f3ff481

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/v0.35.3-doc-audit

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}