Skip to content

Incident Response

Intent

This page defines what constitutes a security-relevant incident in crushr and how such incidents are handled.

Guarantees

  • Incidents are surfaced explicitly rather than hidden behind convenience behavior
  • Unverified or unsafe output is contained before trust-bearing use
  • Analysis is driven by structured evidence where available
  • Resolution must improve determinism, reporting, or boundaries
  • No repair behavior is implied by incident handling

Behavior

Incident definition

An incident is any condition where:

  • archive integrity is compromised
  • verification fails unexpectedly
  • recovery behavior violates documented guarantees
  • system behavior contradicts published invariants

Response process

  1. Detect
  2. failure surfaced via verification, inspection, extraction, recovery, or user report

  3. Contain

  4. prevent further processing of unverified data
  5. fail the operation immediately where required

  6. Analyze

  7. use structured outputs to determine failure scope
  8. identify affected regions, invariants, or behaviors

  9. Report

  10. provide explicit machine-readable output describing failure
  11. no silent handling

  12. Resolve

  13. correct the underlying implementation or documentation defect
  14. add regression tests or documentation updates as needed

Boundaries / Non-goals

Incident response does not include automatic repair of corrupted data, heuristic reconstruction, or silent recovery.

Non-goals:

  • No best-effort reconstruction
  • No hidden failure smoothing
  • No compression-first tradeoffs
  • No external decode dependencies

Principle

All incidents must result in increased determinism, better reporting, or clearer system boundaries.