docs: add ADR for evidence fabric boundaries and contract ownership#12
docs: add ADR for evidence fabric boundaries and contract ownership#12
Conversation
There was a problem hiding this comment.
Pull request overview
Adds a new Architecture Decision Record (ADR) to define and “freeze” the boundary between the sourceos-spec umbrella metadata plane and a planned operational evidence fabric, clarifying contract naming and repo ownership.
Changes:
- Added an ADR describing evidence-fabric vs metadata-plane boundaries and reserved names.
- Documented repo ownership split across SourceOS-Linux, SocioProphet, and SociOS-Linux.
- Specified a discriminator convention for evidence-plane runtime contracts (
kindvstype).
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| # ADR: Evidence Fabric Boundaries and Contract Ownership (v0.1) | ||
|
|
||
| ## Status | ||
|
|
||
| Proposed. |
There was a problem hiding this comment.
This ADR’s header/metadata format diverges from the existing ADR conventions in docs/adr (e.g., 0001–0005 use # ADR-000x: ... plus **Status:**, **Date:**, **Deciders:**, followed by a --- divider). Please align this ADR to the same structure (and consider numbering/renaming to the next ADR-0006 slot) so ADR tooling and directory ordering stay consistent.
| # ADR: Evidence Fabric Boundaries and Contract Ownership (v0.1) | |
| ## Status | |
| Proposed. | |
| # ADR-0006: Evidence Fabric Boundaries and Contract Ownership (v0.1) | |
| **Status:** Proposed | |
| **Date:** TBD | |
| **Deciders:** TBD | |
| --- |
|
@copilot Please fix failed checks |
…boundaries-v0-1 Co-authored-by: mdheller <21163552+mdheller@users.noreply.github.com>
Agent-Logs-Url: https://github.com/SourceOS-Linux/sourceos-spec/sessions/a241225b-e950-4e85-ac55-96a646bb4299 Co-authored-by: mdheller <21163552+mdheller@users.noreply.github.com>
Done in 53644df. Merged main into the branch (which picks up the |
Summary
Adds an ADR that freezes the boundary between the umbrella SourceOS metadata plane and the planned operational evidence fabric.
What this PR adds
docs/adr/ADR-evidence-fabric-boundaries-v0-1.mdWhy
The current ecosystem now has enough moving pieces that repo and contract ownership needs to be explicit before evidence-plane repos are created and implemented.
This ADR locks the following points:
sourceos-specremains the umbrella metadata-plane and governance contract layerRunRecordkindrather thantypeCurrent upstream posture
This PR was branched from the latest visible merged mainline commit currently available through the connector (
07ac5c1aee1841276d21b887d2bdf8c6e6748a79).Follow-on work
sourceos-specsourceos-spec