Skip to content

Schemas and Specs

darkstar edited this page Oct 3, 2026 · 2 revisions

Schemas & Specs

🔒 Immutable schema boundaries

These are versioned and never silently redefined; a backward-incompatible change needs a new version:

Schema Covers
diagprint.canonical/v1 canonical diagnostic identity and fingerprints
diagprint.history.run/v2 one hash-chained history run
diagprint.forensics.case-file/v1 why case files
diagprint.forensics.timeline/v1 timeline output
diagprint.forensics.git-provenance/v1 blame bindings
diagprint.capsule/v1 scan capsules

📄 Specification documents

Spec
canonical-v1 canonical identity
delta-v1 semantic report deltas
receipt-v1 remediation and artifact receipts
artifact-writer transactional artifact persistence
forensics-v1 case files
forensics-timeline-v1 timelines
forensics-git-provenance-v1 Git provenance
forensics-relationship-graph-v1 relationship graph
forensics-remediation-replay-v1 replay
ecosystem-bridges-roadmap bridges

🧭 Data flow

Diagnostic / Reporter → DiagnosticReport → canonical identity / render / history
DiagnosticHistory → why → timeline → Git provenance / blame
Diagnostic → Suggestion → Fixer / FixPlan → RemediationReceipt
SourceCache → SourceSnapshot → SourceRevision → CapturedDiagnostic

History labels are opaque, caller-controlled strings. Provenance is not causation.

← 📦 Features & Crates  ·  🛡️ Safety Model →

🩺 diagprint

⚡ Start

🧱 Build

📤 Ship

🔧 Fix

🔬 Investigate

🛠️ Project


🌐 Site · 📖 docs.rs · 📦 crates.io

Clone this wiki locally