docs/ARCHITECTURE.md

Architecture — v0.1.0

CREATOR INPUT
→ SOURCE REGISTERED
→ EVENTS REGISTERED
→ CHRONOLOGY MAPPED
→ CAUSAL FAMILIES COLLAPSED
→ DISCRIMINATOR PREDICTIONS FROZEN
→ HYPOTHESES FROZEN
→ PRESSURE TESTED
→ MINIMUM-CUT CANDIDATES
→ SOURCE-RETURN REQUESTS
→ HUMAN REVIEW PACKET
→ DETERMINISTIC ZIP + SHA-256 SIDECAR

Governing invariants

• Receipt remains the authority.
• Witness does not become automatic authority.
• Agreement does not become proof.
• Missing platform-controlled evidence does not erase an observed event.
• Corrections append descendants; they do not overwrite ancestors.
• Creator-defined content topology is preserved without system-inferred ideological labels.
• L5 attributed cause and L6 intent/motive are blocked.
• Comparison and publication remain separately gated.

Main modules

• lib/hashing.py — source-byte SHA-256.
• lib/canonical_json.py — stable JSON and deterministic ZIP serialization.
• lib/temporal_ratchet.py — event ancestry and correction integrity.
• lib/claim_ladder.py — claim-level authority limits.
• lib/consent_gate.py — comparison and publication separation.
• lib/sensitive_data.py — narrow fail-closed text/filename scan.
• lib/dpio_reader.py — deterministic causal-family, prediction, hypothesis, and minimum-cut route.
• lib/validation.py — Draft 2020-12 schema plus semantic invariants.
• lib/packet_builder.py — governed packet compilation and export.