Skip to content

Commit 2efa913

Browse files
committed
contracts: add shared content/build/release family design note
1 parent 649965d commit 2efa913

1 file changed

Lines changed: 57 additions & 0 deletions

File tree

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Shared Content / Build / Release Family v0
2+
3+
This additive contract family introduces shared object shapes that can be reused across:
4+
5+
- SourceOS artifact definitions and release lanes
6+
- socios build / promotion automation
7+
- workstation execution evidence
8+
- office/editor export and publication lanes
9+
- platform bundle publication
10+
- catalog and promotion surfaces
11+
12+
## Design intent
13+
14+
The goal is not to force all domains into one execution engine.
15+
The goal is to let all domains share one object-language for:
16+
17+
- desired content
18+
- frozen overlays and inputs
19+
- build requests
20+
- releases
21+
- enrollment/consumption profiles
22+
- evidence bundles
23+
- catalog entries
24+
- access profiles
25+
26+
This keeps governance, provenance, and lifecycle semantics aligned even when the
27+
runtime/build substrate differs.
28+
29+
## Object family
30+
31+
- `ContentSpec`
32+
- `OverlayBundle`
33+
- `BuildRequest`
34+
- `ReleaseManifest`
35+
- `EnrollmentProfile`
36+
- `EvidenceBundle`
37+
- `CatalogEntry`
38+
- `AccessProfile`
39+
40+
## Boundaries
41+
42+
These schemas are additive. They do **not** replace:
43+
- `ReleaseReceipt`
44+
- `RunRecord`
45+
- `PolicyDecision`
46+
- `CapabilityToken`
47+
- existing fog / agent-plane / governance families
48+
49+
Instead, they provide a cross-domain object layer that those families can reference.
50+
51+
## Follow-on
52+
53+
The next tranche after this family lands should add:
54+
- example payloads
55+
- fixture validation
56+
- explicit bindings from runner/evidence/catalog implementations
57+
- transport-boundary notes for local subprocess IPC vs remote TriTRPC transport

0 commit comments

Comments
 (0)