feat(contracts): cockpit contract pack — agentic-os / triparty / labor / supply-risk

Makefile

@@ -1,8 +1,24 @@
-.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-triparty-examples validate-labor-market-examples validate-supply-chain-risk-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 validate-triparty-examples validate-labor-market-examples validate-supply-chain-risk-examples
 	@echo "OK: validate"
 
+validate-agentic-os-examples:
+	python3 -m pip install --user jsonschema >/dev/null
+	python3 tools/validate_agentic_os_examples.py
+
+validate-triparty-examples:
+	python3 -m pip install --user jsonschema >/dev/null
+	python3 tools/validate_triparty_examples.py
+
+validate-labor-market-examples:
+	python3 -m pip install --user jsonschema >/dev/null
+	python3 tools/validate_labor_market_examples.py
+
+validate-supply-chain-risk-examples:
+	python3 -m pip install --user jsonschema >/dev/null
+	python3 tools/validate_supply_chain_risk_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/fit_score.json

@@ -0,0 +1,17 @@
+{
+  "id": "urn:srcos:fit-score:smelter-audit-0001-r2",
+  "type": "FitScore",
+  "specVersion": "2.0.0",
+  "requestRef": "urn:srcos:labor-request:smelter-audit-0001",
+  "responseRef": "urn:srcos:labor-response:smelter-audit-0001-r2",
+  "rubric": {
+    "domain competence": 0.9,
+    "independence": 1.0,
+    "turnaround": 0.8
+  },
+  "fit": 0.9,
+  "confidence": 0.85,
+  "missingEvidence": [
+    "conflict-of-interest declaration"
+  ]
+}

examples/labor_award.json

@@ -0,0 +1,31 @@
+{
+  "id": "urn:srcos:labor-award:smelter-audit-0001",
+  "type": "LaborAward",
+  "specVersion": "2.0.0",
+  "requestRef": "urn:srcos:labor-request:smelter-audit-0001",
+  "responseRef": "urn:srcos:labor-response:smelter-audit-0001-r2",
+  "terms": "Fixed $52k, 3 milestones, independence maintained.",
+  "paymentModel": "milestone",
+  "milestones": [
+    {
+      "title": "On-site inspection",
+      "status": "delivered",
+      "proofRef": "urn:srcos:attestation:audit/site"
+    },
+    {
+      "title": "Analysis",
+      "status": "in_progress"
+    },
+    {
+      "title": "Signed report",
+      "status": "pending"
+    }
+  ],
+  "obligations": [
+    "maintain independence",
+    "disclose conflicts"
+  ],
+  "trustEventRefs": [
+    "urn:srcos:trust-event:eng-coop-completion-01"
+  ]
+}

examples/labor_request.json

@@ -0,0 +1,24 @@
+{
+  "id": "urn:srcos:labor-request:smelter-audit-0001",
+  "type": "LaborRequest",
+  "specVersion": "2.0.0",
+  "requestType": "review",
+  "requesterRef": "urn:srcos:party:chuquicamata-smelter",
+  "objective": "Independent audit of smelter emissions controls before the next regulatory window.",
+  "outcome": "Signed audit report + remediation punch-list.",
+  "compensation": {
+    "transparency": "disclosed",
+    "model": "fixed",
+    "minAmount": 40000,
+    "maxAmount": 60000,
+    "currency": "USD"
+  },
+  "schedule": "3-week engagement",
+  "responseDeadline": "2026-07-20T00:00:00Z",
+  "evaluationCriteria": [
+    "domain competence",
+    "independence",
+    "turnaround"
+  ],
+  "status": "shortlisting"
+}

examples/labor_response.json

@@ -0,0 +1,15 @@
+{
+  "id": "urn:srcos:labor-response:smelter-audit-0001-r2",
+  "type": "LaborResponse",
+  "specVersion": "2.0.0",
+  "requestRef": "urn:srcos:labor-request:smelter-audit-0001",
+  "responderRef": "urn:srcos:party:eng-cooperative-4471",
+  "approach": "Two-auditor team; on-site week 1, analysis week 2, report week 3.",
+  "terms": "Fixed $52k; independence attested; no prior work for requester.",
+  "proposedPricing": 52000,
+  "availability": "starts 2026-07-22",
+  "evidenceRefs": [
+    "urn:srcos:attestation:eng-coop/prior-audits"
+  ],
+  "status": "shortlisted"
+}

examples/netting_cell.json

@@ -0,0 +1,36 @@
+{
+  "id": "urn:srcos:netting-cell:cu-trade-0001",
+  "type": "NettingCell",
+  "specVersion": "2.0.0",
+  "legs": [
+    {
+      "party": "urn:srcos:party:antofagasta-port",
+      "role": "A",
+      "valueRef": "asset://copper-cathode/500t",
+      "proofRef": "urn:srcos:attestation:antofagasta/bill-of-lading"
+    },
+    {
+      "party": "urn:srcos:party:shanghai-buyer",
+      "role": "B",
+      "valueRef": "asset://ASI/1.16M",
+      "capabilityRef": "cap://import-license/cn"
+    },
+    {
+      "party": "urn:srcos:party:clearing-verifier",
+      "role": "C",
+      "proofRef": "urn:srcos:attestation:route-anf-sha/delivery"
+    }
+  ],
+  "stage": "Verified",
+  "truthClass": "ATTESTED",
+  "admissibility": "release",
+  "bundleRefs": [
+    "urn:srcos:triparty-bundle:cu-trade-0001-fill",
+    "urn:srcos:triparty-bundle:cu-trade-0001-verify"
+  ],
+  "policyKernelRef": "policy://triparty/release-guard",
+  "reserveRef": "reserve://asi/primary",
+  "netAmount": 1160000,
+  "asset": "ASI",
+  "supplyChainRef": "hg:route/anf-sha"
+}

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/risk_cluster.json

@@ -0,0 +1,18 @@
+{
+  "id": "urn:srcos:risk-cluster:trans-pacific-shipping",
+  "type": "RiskCluster",
+  "specVersion": "2.0.0",
+  "clusterName": "Trans-Pacific shipping lanes",
+  "clusterType": "Logistics / route concentration",
+  "providerShares": [
+    0.55,
+    0.25,
+    0.2
+  ],
+  "hhi": 0.39,
+  "blastRadius": 0.6,
+  "timeToRecover": 0.5,
+  "exitDifficulty": 0.7,
+  "residualCommonMode": 0.52,
+  "rating": "High"
+}

examples/risk_indicator.json

@@ -0,0 +1,15 @@
+{
+  "id": "urn:srcos:risk-indicator:tier0-provenance",
+  "type": "RiskIndicator",
+  "specVersion": "2.0.0",
+  "indicatorType": "KRI",
+  "metric": "Tier-0 nodes with verified provenance",
+  "definition": "Share of tier-0 supply-chain nodes with verified provenance attached before admission.",
+  "value": 0.82,
+  "green": ">=95%",
+  "amber": "80-94.9%",
+  "red": "<80%",
+  "band": "amber",
+  "frequency": "Weekly",
+  "owner": "Supply Chain Risk"
+}

examples/risk_node.json

@@ -0,0 +1,30 @@
+{
+  "id": "urn:srcos:risk-node:escondida",
+  "type": "RiskNode",
+  "specVersion": "2.0.0",
+  "nodeRef": "hg:facility/escondida",
+  "criticalService": "Copper cathode supply",
+  "inherent": {
+    "criticality": 0.9,
+    "privilege": 0.4,
+    "execution": 0.2,
+    "opacity": 0.5,
+    "concentration": 0.8,
+    "velocity": 0.3
+  },
+  "inherentScore": 0.62,
+  "controls": {
+    "governance": 0.7,
+    "identityPublish": 0.5,
+    "provenance": 0.6,
+    "integrity": 0.6,
+    "distribution": 0.4,
+    "monitoring": 0.6
+  },
+  "residualScore": 0.34,
+  "rating": "Medium",
+  "controlGaps": [
+    "distribution"
+  ],
+  "note": "World's largest copper mine — high criticality + concentration; water is the swing risk."
+}

examples/risk_path.json

@@ -0,0 +1,15 @@
+{
+  "id": "urn:srcos:risk-path:copper-cathode",
+  "type": "RiskPath",
+  "specVersion": "2.0.0",
+  "criticalService": "Copper cathode · Antofagasta → Shanghai",
+  "serviceOwner": "Copper Capital Syndicate",
+  "nodeRefs": [
+    "urn:srcos:risk-node:escondida",
+    "urn:srcos:risk-node:antofagasta-port",
+    "urn:srcos:risk-node:route-anf-sha"
+  ],
+  "pathRisk": 0.48,
+  "rating": "High",
+  "impactTolerance": "< 2 weeks"
+}