Skip to content

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

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

docs: add ADR for evidence fabric boundaries and contract ownership#13
mdheller merged 1 commit intomainfrom
docs/evidence-fabric-boundaries-v0-1-rebased

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 rebased onto the current visible main base exposed by the connector (1dfa4b6067904fc1ebd5c708b3dcd8c379659159).

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 formalize/“freeze” the boundary between the umbrella SourceOS metadata-plane contracts and a separate operational evidence-fabric contract family (including ownership and naming/discriminator rules).

Changes:

  • Introduces an ADR describing evidence-fabric boundaries, reserved names, and the kind vs type discriminator rule.
  • Documents repo ownership split across SourceOS-Linux, SocioProphet, and SociOS-Linux.

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

@@ -0,0 +1,123 @@
# ADR: Evidence Fabric Boundaries and Contract Ownership (v0.1)
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.

ADR filenames and titles in this repo follow the numbered pattern (e.g., docs/adr/0005-... with a # ADR-0005: ... heading). Consider renaming this to the next available number (currently 0006-...) and updating the H1 to match, so it stays consistent with the existing ADR index/sorting.

Suggested change
# ADR: Evidence Fabric Boundaries and Contract Ownership (v0.1)
# ADR-0006: Evidence Fabric Boundaries and Contract Ownership (v0.1)

Copilot uses AI. Check for mistakes.
Comment on lines +3 to +6
## 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.

The ADR header metadata format here diverges from the project ADR template: other ADRs use a top metadata block like **Status:** ..., **Date:** ... (and sometimes **Deciders:** ...) followed by a --- divider. Updating this ADR to match the template will keep the collection uniform and easier to scan.

Suggested change
## Status
Proposed.
**Status:** Proposed
---

Copilot uses AI. Check for mistakes.
@mdheller mdheller merged commit b45886d into main Apr 9, 2026
8 checks passed
@mdheller mdheller deleted the docs/evidence-fabric-boundaries-v0-1-rebased branch April 9, 2026 13:40
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