Skip to content

docs: add ADR for evidence fabric boundaries and contract ownership#12

Merged
mdheller merged 3 commits intomainfrom
docs/evidence-fabric-boundaries-v0-1
Apr 9, 2026
Merged

docs: add ADR for evidence fabric boundaries and contract ownership#12
mdheller merged 3 commits intomainfrom
docs/evidence-fabric-boundaries-v0-1

Conversation

@mdheller
Copy link
Copy Markdown
Contributor

@mdheller mdheller commented Apr 9, 2026

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.md

Why

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-spec remains the umbrella metadata-plane and governance contract layer
  • the evidence fabric becomes a distinct operational contract family owned in SocioProphet
  • runtime evidence objects should not reuse umbrella names like RunRecord
  • operational evidence contracts use kind rather than type
  • desktop-facing account and capture surfaces remain with SociOS-Linux

Current upstream posture

This PR was branched from the latest visible merged mainline commit currently available through the connector (07ac5c1aee1841276d21b887d2bdf8c6e6748a79).

Follow-on work

  1. create the dedicated evidence-plane repo family in SocioProphet
  2. align evidence-plane provenance/connector mappings upward to sourceos-spec
  3. avoid absorbing operational custody schemas directly into sourceos-spec

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 (kind vs type).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +1 to +5
# ADR: Evidence Fabric Boundaries and Contract Ownership (v0.1)

## Status

Proposed.
Copy link

Copilot AI Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This ADR’s header/metadata format diverges from the existing ADR conventions in docs/adr (e.g., 00010005 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.

Suggested change
# 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 uses AI. Check for mistakes.
@mdheller
Copy link
Copy Markdown
Contributor Author

mdheller commented Apr 9, 2026

@copilot Please fix failed checks

…boundaries-v0-1

Co-authored-by: mdheller <21163552+mdheller@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

mdheller commented Apr 9, 2026

Superseded by #13 after main moved again during landing. Keeping #12 only as the original first draft branch against the earlier visible base.

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 9, 2026

@copilot Please fix failed checks

Done in 53644df. Merged main into the branch (which picks up the --spec=draft2020 fix for ajv-cli that was causing the JSON schema validation failures), and renamed/reformatted the ADR to 0006-evidence-fabric-boundaries.md following the existing convention (# ADR-0006: ... header, **Status:**/**Date:**/**Deciders:** metadata, --- divider).

@mdheller mdheller marked this pull request as ready for review April 9, 2026 13:34
@mdheller mdheller merged commit 2f37f94 into main Apr 9, 2026
4 checks passed
@mdheller mdheller deleted the docs/evidence-fabric-boundaries-v0-1 branch April 9, 2026 13:37
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.

3 participants