Skip to content

feat(contracts): add 13-seam registry (SeamDefinition instances) + validator [T6-3] - #49

Merged
mdheller merged 1 commit into
mainfrom
feat/t6-seam-registry
Jul 31, 2026
Merged

feat(contracts): add 13-seam registry (SeamDefinition instances) + validator [T6-3]#49
mdheller merged 1 commit into
mainfrom
feat/t6-seam-registry

Conversation

@mdheller

Copy link
Copy Markdown
Member

Implements T6-3 in the contracts repo (per direction — this is where the estate's contracts live). The 13-seam registry as a machine-readable SeamDefinition contract; runtime enforcement (eBPF, boot-attestation) stays in source-os (deferred to a Linux kernel env).

What

  • contracts/seam-registry.json — 13 seams (SEAM-001..013) as SeamDefinition instances.
  • schemas/seam-definition.schema.json — vendored from sourceos-spec T0-2 (canonical owner noted).
  • tools/validate_seam_registry.py — validates each seam against the schema, asserts all 13 present, SEAM-013 references telemetry, every seam has a gate. Wired into make validate.
  • docs/seam-registry.md — human-readable table.

Verification

  • make validate PY=python3 → exit 0; OK: seam registry — 13 seams validated (SEAM-001..013 present, SEAM-013 telemetry)

Acceptance (T6-3)

  • All 13 seams documented (machine-readable + docs)
  • SEAM-013 references Claude Desktop telemetry
  • Parseable for future tooling import (JSON contract)
  • make validate passes

Closes #48

Machine-readable seam registry: 13 architectural seams (SEAM-001..013) as
SeamDefinition instances (canonical schema SourceOS-Linux/sourceos-spec T0-2,
vendored here with provenance). Each names the boundary, attack vector, gate
requirement, status, priority, and linked repos.

- contracts/seam-registry.json (the contract)
- schemas/seam-definition.schema.json (vendored)
- tools/validate_seam_registry.py: validate each seam + all 13 present +
  SEAM-013 telemetry + non-empty gate_requirements; wired into make validate
- docs/seam-registry.md (human-readable)

Placed in the contracts repo per direction; runtime enforcement (eBPF,
boot-attestation.sh) stays in source-os (deferred to Linux env). make validate
green.
@mdheller
mdheller merged commit 24bbbe6 into main Jul 31, 2026
4 checks passed
@mdheller
mdheller deleted the feat/t6-seam-registry branch July 31, 2026 05:39
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.

feat(contracts): add 13-seam registry (SeamDefinition instances) + validator [T6-3]

1 participant