feat(agentic-os): canonical contract for the agentic operating system

Makefile

@@ -1,8 +1,12 @@
-.PHONY: validate validate-control-plane-examples validate-nlboot-examples validate-lattice-data-governai-examples validate-ops-history-examples validate-runtime-observability-examples validate-interpretability-examples validate-lifecycle-boundary-examples validate-svf-contracts validate-sync-cycle-receipts validate-onboarding-examples validate-runtime-causality-examples
+.PHONY: validate validate-control-plane-examples validate-nlboot-examples validate-lattice-data-governai-examples validate-ops-history-examples validate-runtime-observability-examples validate-interpretability-examples validate-lifecycle-boundary-examples validate-svf-contracts validate-sync-cycle-receipts validate-onboarding-examples validate-runtime-causality-examples validate-agentic-os-examples
 
-validate: validate-control-plane-examples validate-nlboot-examples validate-lattice-data-governai-examples validate-ops-history-examples validate-runtime-observability-examples validate-interpretability-examples validate-lifecycle-boundary-examples validate-svf-contracts validate-sync-cycle-receipts validate-onboarding-examples validate-runtime-causality-examples
+validate: validate-control-plane-examples validate-nlboot-examples validate-lattice-data-governai-examples validate-ops-history-examples validate-runtime-observability-examples validate-interpretability-examples validate-lifecycle-boundary-examples validate-svf-contracts validate-sync-cycle-receipts validate-onboarding-examples validate-runtime-causality-examples validate-agentic-os-examples
 	@echo "OK: validate"
 
+validate-agentic-os-examples:
+	python3 -m pip install --user jsonschema >/dev/null
+	python3 tools/validate_agentic_os_examples.py
+
 validate-control-plane-examples:
 	python3 -m pip install --user jsonschema >/dev/null
 	python3 tools/validate_control_plane_examples.py

examples/agent_pod.json

@@ -0,0 +1,25 @@
+{
+  "id": "urn:srcos:agent-pod:capture-lead",
+  "type": "AgentPod",
+  "specVersion": "2.0.0",
+  "role": "Capture Lead",
+  "mandate": "Own pursuit strategy, buyer map, milestones, and decisions.",
+  "inputs": [
+    "signals",
+    "updates",
+    "Q&A",
+    "competitive intel"
+  ],
+  "outputs": [
+    "pursuit plan",
+    "gate decisions",
+    "action backlog"
+  ],
+  "repoAnchors": [
+    "sociosphere",
+    "socioprophet"
+  ],
+  "status": "active",
+  "choirRole": "governance-sentinel",
+  "agentSessionRef": "urn:srcos:session:capture-lead-run-01"
+}

examples/capture_cadence.json

@@ -0,0 +1,33 @@
+{
+  "id": "urn:srcos:capture-cadence:standard-8wk",
+  "type": "CaptureCadence",
+  "specVersion": "2.0.0",
+  "name": "Standard 8-week capture sprint",
+  "currentWeek": 4,
+  "weeks": [
+    {
+      "week": 0,
+      "objective": "Intake + normalize",
+      "portfolioDeliverable": "update OS, partner map, pod coverage",
+      "cellDeliverable": "opportunity brief + buyer/problem memo",
+      "minReadiness": 0.2,
+      "exitDecision": "pursue / watch / pause"
+    },
+    {
+      "week": 4,
+      "objective": "Artifact pack v1",
+      "portfolioDeliverable": "synchronize all cell artifacts",
+      "cellDeliverable": "30-day artifact pack, storyboard, compliance skeleton",
+      "minReadiness": 0.5,
+      "exitDecision": "Gate 1 complete"
+    },
+    {
+      "week": 8,
+      "objective": "Delta sprint",
+      "portfolioDeliverable": "ingest live text and replan in <=72h",
+      "cellDeliverable": "delta memo, reprioritized backlog, owner resets",
+      "minReadiness": 0.8,
+      "exitDecision": "go-forward after delta"
+    }
+  ]
+}

examples/capture_delta.json

@@ -0,0 +1,12 @@
+{
+  "id": "urn:srcos:capture-delta:health-devsecops-qa",
+  "type": "CaptureDelta",
+  "specVersion": "2.0.0",
+  "opportunityRef": "urn:srcos:opportunity:health-devsecops",
+  "kind": "Industry-day Q&A",
+  "monitorSource": "OIT Industry Day site / VOA",
+  "expected": "2026-04-17",
+  "responseSlaHours": 24,
+  "requiredOutput": "delta memo + requirement updates",
+  "status": "Watching"
+}

examples/opportunity.json

@@ -0,0 +1,53 @@
+{
+  "id": "urn:srcos:opportunity:health-devsecops",
+  "type": "Opportunity",
+  "specVersion": "2.0.0",
+  "name": "Health Services DevSecOps",
+  "cluster": "Health",
+  "missionOwner": "PDS",
+  "buyingProblem": "Sustain legacy health apps while modernizing safely outside the Oracle Health baseline.",
+  "priorities": [
+    "VistA sustainment",
+    "modernization",
+    "MUMPS"
+  ],
+  "deliveryPattern": "Continuity-plus-modernization delivery cell; governed DevSecOps; legacy transition discipline.",
+  "reuseRepos": [
+    "prophet-platform",
+    "prophet-platform-standards",
+    "agentplane",
+    "policy-fabric",
+    "sociosphere"
+  ],
+  "podRefs": [
+    "urn:srcos:agent-pod:capture-lead",
+    "urn:srcos:agent-pod:technical-solution",
+    "urn:srcos:agent-pod:compliance-matrix",
+    "urn:srcos:agent-pod:evidence-qa"
+  ],
+  "sharedLibraryRefs": [
+    "urn:srcos:shared-library:canonical-operating-model",
+    "urn:srcos:shared-library:transition-in",
+    "urn:srcos:shared-library:release-gates"
+  ],
+  "readinessRef": "urn:srcos:readiness-score:health-devsecops",
+  "deltaRefs": [
+    "urn:srcos:capture-delta:health-devsecops-qa"
+  ],
+  "partnerLane": "Health IT SI; VistA/MUMPS niche partner",
+  "winTheme": "We preserve continuity while industrializing governed modernization with low-regret migration paths.",
+  "status": "Active",
+  "workroomRef": "workroom://health-devsecops",
+  "controlRoomRef": "controlroom://health-devsecops",
+  "telos": {
+    "objective": "Intelligence serves human flourishing",
+    "constraints": [
+      "non-domination",
+      "consent",
+      "dignity"
+    ]
+  },
+  "evidenceRefs": [
+    "urn:srcos:attestation:health-devsecops/win-theme"
+  ]
+}

examples/readiness_score.json

@@ -0,0 +1,29 @@
+{
+  "id": "urn:srcos:readiness-score:health-devsecops",
+  "type": "ReadinessScore",
+  "specVersion": "2.0.0",
+  "opportunityRef": "urn:srcos:opportunity:health-devsecops",
+  "dimensions": {
+    "buyerProblem": 3,
+    "solutionHypothesis": 2,
+    "sharedLibraries": 3,
+    "agentPod": 2,
+    "partnerArchetype": 2,
+    "namedPartnerTargets": 0,
+    "oemLane": 1,
+    "artifactPack": 2,
+    "deltaControl": 2,
+    "questions": 1,
+    "pricing": 0,
+    "pastPerformance": 0
+  },
+  "total": 18,
+  "max": 36,
+  "readinessPct": 50,
+  "rag": "Amber",
+  "nextGate": "Gate 1",
+  "evidenceRefs": [
+    "urn:srcos:attestation:health-devsecops/buyer-problem"
+  ],
+  "policyRef": "policy://capture/burden-of-proof/gate-1"
+}

examples/shared_library.json

@@ -0,0 +1,13 @@
+{
+  "id": "urn:srcos:shared-library:release-gates",
+  "type": "SharedLibrary",
+  "specVersion": "2.0.0",
+  "name": "Quality / release gates",
+  "standardizes": "Validation, test automation, release readiness, defect policy.",
+  "repoAnchors": [
+    "agentplane",
+    "prophet-platform-standards",
+    "sourceos-spec"
+  ],
+  "usedBy": "All build/run objectives"
+}

schemas/AgentPod.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.srcos.ai/v2/AgentPod.json",
+  "title": "AgentPod",
+  "description": "A standard agent pod: a named role with a mandate, typed inputs/outputs, and repo anchors. The unit of staffing in the agentic operating system; the pod URN is the same one referenced by AgentMachineReceipt.agentPodRef.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "type",
+    "specVersion",
+    "role",
+    "mandate",
+    "inputs",
+    "outputs",
+    "repoAnchors"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^urn:srcos:agent-pod:",
+      "description": "Stable URN identifier. Pattern: urn:srcos:agent-pod:<local-id>"
+    },
+    "type": {
+      "const": "AgentPod",
+      "description": "Discriminator constant — always \"AgentPod\"."
+    },
+    "specVersion": {
+      "type": "string",
+      "description": "Spec version of this document, e.g. \"2.0.0\"."
+    },
+    "role": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human role name, e.g. \"Capture Lead\"."
+    },
+    "mandate": {
+      "type": "string",
+      "minLength": 1,
+      "description": "What the pod owns."
+    },
+    "inputs": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "description": "Core inputs the pod consumes."
+    },
+    "outputs": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "description": "Core artifacts the pod produces."
+    },
+    "repoAnchors": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "description": "Estate repositories this pod's patterns anchor to."
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "active",
+        "shadow",
+        "paused"
+      ],
+      "description": "Operational status of the pod."
+    },
+    "choirRole": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "prophet-mesh agent-choir role this pod aligns to (e.g. \"planning-agent\", \"governance-sentinel\"). The choir is the canonical role vocabulary; this pod is its capture-side projection."
+    },
+    "agentSessionRef": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "pattern": "^urn:srcos:session:",
+      "description": "The AgentSession URN when this pod is executing (the Perceive→Reason→Act→Verify loop)."
+    }
+  }
+}

schemas/CaptureCadence.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.srcos.ai/v2/CaptureCadence.json",
+  "title": "CaptureCadence",
+  "description": "The governed capture cadence: a fixed sprint of weeks, each with objectives, deliverables, a minimum-readiness gate, and an exit decision.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "type",
+    "specVersion",
+    "weeks"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^urn:srcos:capture-cadence:",
+      "description": "Stable URN identifier. Pattern: urn:srcos:capture-cadence:<local-id>"
+    },
+    "type": {
+      "const": "CaptureCadence",
+      "description": "Discriminator constant — always \"CaptureCadence\"."
+    },
+    "specVersion": {
+      "type": "string",
+      "description": "Spec version of this document, e.g. \"2.0.0\"."
+    },
+    "name": {
+      "type": "string"
+    },
+    "weeks": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "week",
+          "objective",
+          "minReadiness",
+          "exitDecision"
+        ],
+        "properties": {
+          "week": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "objective": {
+            "type": "string"
+          },
+          "portfolioDeliverable": {
+            "type": "string"
+          },
+          "cellDeliverable": {
+            "type": "string"
+          },
+          "minReadiness": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          },
+          "exitDecision": {
+            "type": "string"
+          }
+        }
+      },
+      "description": "Ordered cadence weeks."
+    },
+    "currentWeek": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Where the portfolio currently sits."
+    }
+  }
+}