From 2e450950443da8ccc2de6c9f4aa1102f99a949c5 Mon Sep 17 00:00:00 2001
From: mdheller <21163552+mdheller@users.noreply.github.com>
Date: Wed, 15 Apr 2026 22:01:13 -0400
Subject: [PATCH] docs(spec): add LRK contract family note

---
 docs/lrk-contract-family.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 docs/lrk-contract-family.md

diff --git a/docs/lrk-contract-family.md b/docs/lrk-contract-family.md
new file mode 100644
index 0000000..b798639
--- /dev/null
+++ b/docs/lrk-contract-family.md
@@ -0,0 +1,32 @@
+# LRK Contract Family
+
+This document describes the LRK / Semantic Holography contract family that augments the SourceOS/SociOS typed contract layer.
+
+## Contract family
+
+- `TriuneRPC` — canonical action / provenance envelope for semantic and runtime transitions
+- `ProofOfLife` — heartbeat attestation bound to policy hash and slot identity
+- `LifeMirrorState` — lifecycle state for liveness/tamper escalation
+- `B11Surface` — typed, attestable surface for semantic/runtime publication
+- `DeltaSurface` — typed comparison object for attested surface deltas
+
+## Why these are a family
+
+These types are cohesive because they all represent:
+
+1. an observable boundary object,
+2. a local or distributed trust transition,
+3. a machine-validated shape that downstream runtimes must agree on.
+
+## Recommended catalog updates
+
+When this family lands, update:
+- `README.md` schema families section
+- `schemas/README.md` quick reference and family listing
+- semantic context material if/when these become first-class linked data terms
+
+## Downstream consumers
+
+- `agentos-starter` surface collectors and LRK runtime package
+- `workstation-contracts` validation lanes
+- `agentos-spine` runtime state binding and publication