From 8f4c262a06154e7826b0cfa1a0c0fda0d2761389 Mon Sep 17 00:00:00 2001
From: mdheller <21163552+mdheller@users.noreply.github.com>
Date: Fri, 3 Apr 2026 23:15:09 -0400
Subject: [PATCH 1/4] Add session artifact scaffold for agent-plane runtime
 receipts

---
 schemas/session-artifact.schema.v0.1.json | 57 +++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 schemas/session-artifact.schema.v0.1.json

diff --git a/schemas/session-artifact.schema.v0.1.json b/schemas/session-artifact.schema.v0.1.json
new file mode 100644
index 0000000..7c319b7
--- /dev/null
+++ b/schemas/session-artifact.schema.v0.1.json
@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Agentplane Session Artifact v0.1",
+  "type": "object",
+  "required": [
+    "kind",
+    "bundle",
+    "capturedAt",
+    "sessionRef",
+    "status"
+  ],
+  "properties": {
+    "kind": {
+      "const": "SessionArtifact"
+    },
+    "bundle": {
+      "type": "string"
+    },
+    "capturedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "sessionRef": {
+      "type": "string",
+      "pattern": "^urn:srcos:session:"
+    },
+    "status": {
+      "enum": [
+        "success",
+        "failure",
+        "paused",
+        "deferred",
+        "canceled"
+      ]
+    },
+    "receiptRef": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "pattern": "^urn:srcos:receipt:session:"
+    },
+    "runArtifactRef": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "replayArtifactRef": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "additionalProperties": false
+}

From 25593d682d993ba446c85f6561c9d0370193f465 Mon Sep 17 00:00:00 2001
From: mdheller <21163552+mdheller@users.noreply.github.com>
Date: Fri, 3 Apr 2026 23:15:52 -0400
Subject: [PATCH 2/4] Add promotion artifact scaffold for review and promotion
 flow

---
 schemas/promotion-artifact.schema.v0.1.json | 39 +++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 schemas/promotion-artifact.schema.v0.1.json

diff --git a/schemas/promotion-artifact.schema.v0.1.json b/schemas/promotion-artifact.schema.v0.1.json
new file mode 100644
index 0000000..c863ca0
--- /dev/null
+++ b/schemas/promotion-artifact.schema.v0.1.json
@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Agentplane Promotion Artifact v0.1",
+  "type": "object",
+  "required": [
+    "kind",
+    "bundle",
+    "capturedAt",
+    "promotionReceiptRef",
+    "promotedObjectRef"
+  ],
+  "properties": {
+    "kind": {
+      "const": "PromotionArtifact"
+    },
+    "bundle": {
+      "type": "string"
+    },
+    "capturedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "promotionReceiptRef": {
+      "type": "string",
+      "pattern": "^urn:srcos:receipt:promotion:"
+    },
+    "promotedObjectRef": {
+      "type": "string"
+    },
+    "reviewSessionRef": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "pattern": "^urn:srcos:session:"
+    }
+  },
+  "additionalProperties": false
+}

From d7ed72daae0486e9bde0cf7d8fcfcc7b7fb25ac8 Mon Sep 17 00:00:00 2001
From: mdheller <21163552+mdheller@users.noreply.github.com>
Date: Fri, 3 Apr 2026 23:16:18 -0400
Subject: [PATCH 3/4] Add reversal artifact scaffold for rollback flow

---
 schemas/reversal-artifact.schema.v0.1.json | 39 ++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 schemas/reversal-artifact.schema.v0.1.json

diff --git a/schemas/reversal-artifact.schema.v0.1.json b/schemas/reversal-artifact.schema.v0.1.json
new file mode 100644
index 0000000..eb16c12
--- /dev/null
+++ b/schemas/reversal-artifact.schema.v0.1.json
@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Agentplane Reversal Artifact v0.1",
+  "type": "object",
+  "required": [
+    "kind",
+    "bundle",
+    "capturedAt",
+    "sourcePromotionReceiptRef",
+    "reversalHandle"
+  ],
+  "properties": {
+    "kind": {
+      "const": "ReversalArtifact"
+    },
+    "bundle": {
+      "type": "string"
+    },
+    "capturedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "sourcePromotionReceiptRef": {
+      "type": "string",
+      "pattern": "^urn:srcos:receipt:promotion:"
+    },
+    "reversalHandle": {
+      "type": "string"
+    },
+    "status": {
+      "enum": [
+        "started",
+        "succeeded",
+        "failed"
+      ]
+    }
+  },
+  "additionalProperties": false
+}

From 15c1f38deabc41fc352d9790ff88069c42999e48 Mon Sep 17 00:00:00 2001
From: mdheller <21163552+mdheller@users.noreply.github.com>
Date: Fri, 3 Apr 2026 23:16:44 -0400
Subject: [PATCH 4/4] Add bundle schema patch fragment for agent-plane runtime
 fields

---
 schemas/bundle.schema.patch.json | 38 ++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 schemas/bundle.schema.patch.json

diff --git a/schemas/bundle.schema.patch.json b/schemas/bundle.schema.patch.json
new file mode 100644
index 0000000..8c531f5
--- /dev/null
+++ b/schemas/bundle.schema.patch.json
@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "description": "JSON Merge Patch-style fragment showing new agent-runtime fields to add under spec.",
+  "spec": {
+    "sessionPolicyRef": {
+      "type": "string"
+    },
+    "skillRefs": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "memoryNamespace": {
+      "type": "string"
+    },
+    "worktreeStrategy": {
+      "enum": [
+        "none",
+        "existing",
+        "create-temp",
+        "named"
+      ]
+    },
+    "rolloutFlags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "telemetrySink": {
+      "type": "string"
+    },
+    "receiptSchemaVersion": {
+      "type": "string"
+    }
+  }
+}