Skip to content

Operations runbook, support intake, and templates (#274) ​

Status: PASS — docs and templates only; live suites not run Date: 2026-11-16 Parent spec: #268 Ticket: #274 Base: integration/public-release at 196c3f9

Delivered ​

  • Support policy: GitHub Issues channel, private security route, best-effort response targets, evidence checklist, and the redaction rules.
  • Incident runbook: severity, symptom guide, diagnostics (doctor, :logs, log summary, host log), evidence bundle, package rollback, disable-without-uninstall, data recovery, escalation, and post-incident follow-up.
  • Support matrix and known limitations: Linux/tmux support, macOS/Herdr unverified pending #277, Windows out of scope, OpenCode 2.2.6/2.2.7, Node 22.23.4/24.22.1/26.12.1, terminal sizes, and live-suite prerequisites.
  • Bug report and support request issue forms plus issue chooser config, and the pull-request template. Every intake form collects versions, install method, commands, evidence, and redacted diagnostics, and forbids credentials and conversation content.
  • README and documentation index links to the support path.
  • docs:check now requires the support hub, runbook, matrix, issue forms, and PR template, the README/index links, and the redaction warning.

Commands and results ​

CommandResult
node --test --experimental-strip-types src/v2/docs-check.test.tsPass — 10 tests, including the three new support/template checks
npm run verifyPass — strict typecheck; 2,034 tests, 0 failed or skipped
npm run docs:checkPass — contract v7; OpenCode 2.2.6/2.2.7; Node >=22.23.4; live Node 26.12.1

The support checks were observed red before the implementation: a README without the support link, a missing runbook, and a template without the redaction warning each failed the check. They pass after the docs and checkSupport were added.

Verification boundaries ​

  • No product behavior changed. The only executable change is the docs freshness gate.
  • No live suite was run; the ticket is documentation and templates. Existing live evidence remains the platform record.
  • macOS/Herdr was not run. The support matrix says unverified and requires #277 before any macOS claim.
  • No template or runbook requests a credential, token, service descriptor, conversation/memory text, file bytes, or private absolute path. Raw logs are explicitly excluded; redacted field excerpts are requested instead.

Privacy ​

No conversation content, credentials, file bytes, or absolute private paths are committed. Examples use placeholders and generic XDG paths only.

Released under the MIT License.