docs/ARCHITECTURE.md

# Architecture — v0.1.0

```text
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.