Docs refresh: cover automation, review board, tmux backend, GitLab fixes

[dhilgaertner]

Closes #235

Summary

• Adds docs/automation.md as the canonical guide to Settings → Automation and the full auto-flow lifecycle.
• Updates docs/architecture.md with the dual Ghostty/tmux backend (Add tmux backend behind CROW_TMUX_BACKEND feature flag (#198) #229), the new TerminalRouter dispatch, the Settings tab split (Split automation toggles into dedicated Settings tab #228), and the Review Board surface (Add 'Move to Active' button on completed sessions #188, Reconcile PR links for sessions missing reactive detection #205, Filter projects from review board via exclude list #207, Add bulk delete for sessions in the sidebar #210, Add multi-select and batch Start Review to Review Board #212, Add filtering for tickets list #220, Per-section select all and icon-only cancel button #226, Add quick action buttons to session detail header #231).
• Adds crow rename-terminal (Add ability to rename terminals #206) to docs/cli-reference.md.
• Adds troubleshooting rows for tmux backend missing, Ghostty surface retry (Recover from failed Ghostty surface creation (#217) #218), GitLab nested groups (Fix glab fetch failures from non-repo cwd and nested-group slug truncation #233), GITLAB_HOST silent skip (Fix GitLab fetch failing on GITLAB_HOST mismatch #215), auto-respond not firing, and the silent no-op hook-event behavior (Silently skip hook-event when Crow app is not running #234).
• Adds CROW_TMUX_BACKEND and CROW_HOOK_DEBUG to the docs/configuration.md env-var table.
• Backfills CHANGELOG.md [Unreleased] with every PR from Add session analytics via Claude Code OpenTelemetry #137 through Silently skip hook-event when Crow app is not running #234, grouped by theme.
• Updates README.md features list and docs index for the new automation suite, review board, terminal renaming, and tmux opt-in.
• Appends an "Implementation Status (2026-05)" footer to docs/terminal-runtime-research.md noting Add tmux backend behind CROW_TMUX_BACKEND feature flag (#198) #229 shipped the headless-PTY backend recommended in the original research.

The audit checklist called out as deliverable #1 in the issue is posted as a comment on #235.

Test plan

• git diff --stat main shows only the listed docs/, CHANGELOG.md, and README.md files
• Render each modified doc on GitHub and confirm anchors / cross-links resolve
• Confirm crow --help matches the command list in docs/cli-reference.md (only rename-terminal was missing pre-PR)
• Walk every PR number in the CHANGELOG against git log --since=2026-04-15 main --oneline and confirm each one resolves
• Re-export docs/crow-screenshot.jpeg against the current Settings/Review-Board UI — deferred to a follow-up, called out in the audit comment

🤖 Generated with Claude Code

[dgershman]

Code & Security Review

Critical Issues

None.

Security Review

Strengths:

• Docs-only PR — no executable code changes, so no new attack surface.
• No secrets, credentials, or internal URLs exposed in any of the documentation.
• Troubleshooting guidance correctly avoids embedding tokens or auth secrets (directs users to gh auth status / glab auth status instead).

Concerns:

• None.

Code Quality

Verified:

• All 7 source file paths referenced in docs/architecture.md and docs/automation.md exist in the codebase (TmuxBackend.swift, TerminalRouter.swift, AutoRespondCoordinator.swift, AutomationSettingsView.swift, AppConfig.swift, AppDelegate.swift, IssueTracker.swift).
• Referenced symbols confirmed: SessionTerminal.backend, FeatureFlags.tmuxBackend, TerminalRouter.canSend, ConfigDefaults, AutoRespondSettings.
• All 55 PR numbers in CHANGELOG.md cross-checked against git log main — every one resolves to a merged commit.
• Cross-link anchors verified (e.g., architecture.md#terminal-backends maps to an actual ## Terminal Backends heading).
• crow rename-terminal CLI command confirmed present in TerminalCommands.swift and AppDelegate.swift.

Minor nit (non-blocking):

• docs/automation.md:39 lists Opus 4.7 as a supported model for auto permission mode. As of the current Claude model family (4.6), Opus 4.7 doesn't exist yet. This may be forward-looking or a typo — worth a quick double-check, but not blocking since it documents an external Claude Code requirement rather than Crow logic.

Summary Table

Priority	Issue
🟢 Green	Opus 4.7 model reference in docs/automation.md:39 — verify or remove

Recommendation: Approve. This is a thorough docs refresh covering ~100 PRs worth of features. File references, PR numbers, cross-links, and symbol names all check out against the current codebase. The single nit is cosmetic and non-blocking.

[dgershman]

Code & Security Review

Critical Issues

None.

Security Review

Strengths:

• Documentation-only PR — no executable code changes, so no runtime security impact.
• No secrets, credentials, or internal URLs exposed in the docs.
• Troubleshooting guidance correctly avoids recommending overly-permissive auth scopes.

Concerns:

• None.

Code Quality

Minor issues:

1. docs/automation.md:39 — Lists "Opus 4.7" as a supported model for auto-permission mode. This model doesn't exist yet (the latest is Opus 4.6). The source code at AutomationSettingsView.swift:79 doesn't enumerate specific model names. Consider removing the model list or marking it as "current models supported by Claude Code auto mode" to avoid staleness.

Positive observations:

• All source file paths referenced in the new docs (TerminalRouter.swift, TmuxBackend.swift, AutoRespondCoordinator.swift, AutomationSettingsView.swift, AppConfig.swift) verified to exist at the stated locations.
• Cross-doc anchors (architecture.md#terminal-backends) resolve correctly.
• The new docs/automation.md is well-structured: lifecycle overview → per-toggle Settings reference → per-PR deep dives → "where it lives" table. Good layering for different reader intents.
• CHANGELOG backfill is grouped thematically rather than chronologically — easier to scan.
• Troubleshooting additions are concrete and actionable (e.g., tmux version requirement, glab repo view verification step).

Summary Table

Priority	Issue
🟡 Yellow	docs/automation.md:39 references non-existent "Opus 4.7" model — minor factual inaccuracy
🟢 Green	Consider adding a note that the model list may change and users should check Claude Code's own error message for current supported models

Recommendation: Approve — this is a thorough, well-organized docs refresh that accurately reflects the codebase. The one yellow item (Opus 4.7 reference) is non-blocking and can be fixed in a follow-up or before merge at the author's discretion.