Observe precisely. Reason cautiously. Recover responsibly.
An offline, read-only CLI that turns exported logs, metrics, alerts and deployments into an auditable UTC timeline, competing root-cause hypotheses with counter-evidence, and a blameless postmortem draft, as HTML, Markdown and JSON. Ships 20 portable agent skills.
npx incidentsutra analyze --input ./export --out ./report
npx incidentsutra verify --report ./report/incident-report.json
npx incidentsutra audit --out ./audit
Node.js 20 or newer. No API key, no network, no dependencies. Open report/incident-report.html in a browser.
RFC3339 with explicit offsets only, sorted by instant, nanoseconds kept. Every fact has an evidence ID, source file, record and SHA-256.
Change, dependency, saturation, datastore, latent defect, unknown. Each lists what must be true, what contradicts it and what would disprove it.
Missing metrics, traces and change records are reported as gaps, never filled in. Confidence stays undetermined.
No network client, no process spawn, no eval in product code. Diagnostics are listed read-only and marked not run.
Single-file HTML (no scripts, strict CSP, light and dark), Markdown and JSON, plus a blameless postmortem draft.
Best-effort masking of common secrets and personal data with counts. Published gaps. Not DLP: sanitize upstream.
| Evidence | Result | Reproduce |
|---|---|---|
| Automated tests | 192 pass, 0 fail | npm test |
| Self-audit | 20 checks, audit report | npx incidentsutra audit |
| Synthetic benchmark | 26 case families, 36 expectations | npx incidentsutra benchmark |
| Redaction corpus | 14 synthetic secret classes masked | audit A06 |
| Prompt-injection corpus | 6 hostile payloads change nothing | audit A08 |
| Tamper detection | 6 of 6 mutations caught | audit A10 |
| Dependencies | 0 runtime, 0 dev | npm ls |
| CI | Ubuntu and Windows (Node 20, 22, 24), macOS (Node 24) | Actions |
The audit is an automated self-audit, not a third-party certification. Benchmark labels are synthetic and author-written, so they show internal consistency, not real-world accuracy. Read the full audit write-up, including defects found and fixed.
Install project-locally for your AI coding tool; existing files are never overwritten.
npx incidentsutra skills install --host claude --project .
Claude CodeCursorCodexGemini CLIGitHub Copilot
Roles are instructions, not 20 running models: timeline builder, change detector, hypothesis tester, evidence ledger, privacy guardian, postmortem writer and more. Copying is tested; native activation in each IDE is not. See the agent catalogue.
Problem, value, trust summary.
Commands, inputs, outputs, hypothesis families.
Schemas, ordering, redaction, API.
Data flow, boundaries, decisions.
Step by step for on-call use.
Posture, redaction, licence.
Defects found, checks, limits.
Machine-written, from a real run.
Quick answers.