Skip to content

docs: add Truth Plane enforcement plan (surfaces, egress gate, incident semantics)#3

Merged
mdheller merged 3 commits intomainfrom
docs/truth-plane-enforcement-20260414
Apr 15, 2026
Merged

docs: add Truth Plane enforcement plan (surfaces, egress gate, incident semantics)#3
mdheller merged 3 commits intomainfrom
docs/truth-plane-enforcement-20260414

Conversation

@mdheller
Copy link
Copy Markdown
Member

Adds docs/TRUTH_PLANE.md describing how the SourceOS substrate enforces the canonical contract layer: truth surfaces + delta surfaces generation/attestation, default-deny frontier egress with short-lived grants, runtime truth capture, and explicit Freeze→Fork→Kill incident semantics.

Boundary preserved: contract shapes live in SourceOS-Linux/sourceos-spec; this repo implements enforcement. See docs/BOUNDARIES.md.

@mdheller
Copy link
Copy Markdown
Member Author

@copilot fix failed checks

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 15, 2026

@copilot fix failed checks

Fixed in commit dc75a6f. I investigated the failed CI runs, reproduced the markdownlint failures locally, and updated the two Truth Plane docs to satisfy lint rules. Local markdownlint "**/*.md" now passes.

@mdheller mdheller merged commit a0823e1 into main Apr 15, 2026
2 checks passed
@mdheller mdheller deleted the docs/truth-plane-enforcement-20260414 branch April 15, 2026 21:15
Copy link
Copy Markdown
Member Author

Update: added docs/TRUTH_PLANE_IMPLEMENTATION.md (v0 implementation slice) to the PR branch.

This pins the first end-to-end enforcement slice:

  • default-deny frontier egress + short-lived allow windows + replay cache
  • minimal TruthSurface emitter (system.sealed)
  • minimal DeltaSurface emitter (system.sealed)
  • incident.freeze (phase 1)

Next: wire these behaviors to the canonical contracts in SourceOS-Linux/sourceos-spec (TruthSurface.json, DeltaSurface.json, incident-events.schema.json).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants