Skip to content

Commit c516779

Browse files
mdhellermdheller
authored
feat(contracts): cockpit contract pack — agentic-os / triparty / labor / supply-risk (#195)
Consolidates the four handoff-spec contracts that back the client-vue cockpit program into one canonical pack (each was PR #191-194): - agentic-os: AgentPod, Opportunity, ReadinessScore, CaptureCadence, CaptureDelta, SharedLibrary (VA capture as the agentic OS over the stack) - triparty: NettingCell, TripartyBundle (governed-triparty marketplace) - labor-market: LaborRequest, LaborResponse, FitScore, LaborAward, TrustEvent (request-centric; fit is scored request<->response, never a global human-worth score) - supply-chain-risk: RiskNode, RiskPath, RiskCluster, RiskIndicator (BIAN op-risk / FICO) All 17 schemas + 17 examples validate; Makefile aggregates the four new targets into `make validate`.
1 parent 7ce1a3e commit c516779

39 files changed

Lines changed: 2315 additions & 2 deletions

‎Makefile‎

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,24 @@
1-
.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
1+
.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
22

3-
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
3+
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
44
@echo "OK: validate"
55

6+
validate-agentic-os-examples:
7+
python3 -m pip install --user jsonschema >/dev/null
8+
python3 tools/validate_agentic_os_examples.py
9+
10+
validate-triparty-examples:
11+
python3 -m pip install --user jsonschema >/dev/null
12+
python3 tools/validate_triparty_examples.py
13+
14+
validate-labor-market-examples:
15+
python3 -m pip install --user jsonschema >/dev/null
16+
python3 tools/validate_labor_market_examples.py
17+
18+
validate-supply-chain-risk-examples:
19+
python3 -m pip install --user jsonschema >/dev/null
20+
python3 tools/validate_supply_chain_risk_examples.py
21+
622
validate-control-plane-examples:
723
python3 -m pip install --user jsonschema >/dev/null
824
python3 tools/validate_control_plane_examples.py

‎examples/agent_pod.json‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
{
2+
"id": "urn:srcos:agent-pod:capture-lead",
3+
"type": "AgentPod",
4+
"specVersion": "2.0.0",
5+
"role": "Capture Lead",
6+
"mandate": "Own pursuit strategy, buyer map, milestones, and decisions.",
7+
"inputs": [
8+
"signals",
9+
"updates",
10+
"Q&A",
11+
"competitive intel"
12+
],
13+
"outputs": [
14+
"pursuit plan",
15+
"gate decisions",
16+
"action backlog"
17+
],
18+
"repoAnchors": [
19+
"sociosphere",
20+
"socioprophet"
21+
],
22+
"status": "active",
23+
"choirRole": "governance-sentinel",
24+
"agentSessionRef": "urn:srcos:session:capture-lead-run-01"
25+
}

‎examples/capture_cadence.json‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
{
2+
"id": "urn:srcos:capture-cadence:standard-8wk",
3+
"type": "CaptureCadence",
4+
"specVersion": "2.0.0",
5+
"name": "Standard 8-week capture sprint",
6+
"currentWeek": 4,
7+
"weeks": [
8+
{
9+
"week": 0,
10+
"objective": "Intake + normalize",
11+
"portfolioDeliverable": "update OS, partner map, pod coverage",
12+
"cellDeliverable": "opportunity brief + buyer/problem memo",
13+
"minReadiness": 0.2,
14+
"exitDecision": "pursue / watch / pause"
15+
},
16+
{
17+
"week": 4,
18+
"objective": "Artifact pack v1",
19+
"portfolioDeliverable": "synchronize all cell artifacts",
20+
"cellDeliverable": "30-day artifact pack, storyboard, compliance skeleton",
21+
"minReadiness": 0.5,
22+
"exitDecision": "Gate 1 complete"
23+
},
24+
{
25+
"week": 8,
26+
"objective": "Delta sprint",
27+
"portfolioDeliverable": "ingest live text and replan in <=72h",
28+
"cellDeliverable": "delta memo, reprioritized backlog, owner resets",
29+
"minReadiness": 0.8,
30+
"exitDecision": "go-forward after delta"
31+
}
32+
]
33+
}

‎examples/capture_delta.json‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
{
2+
"id": "urn:srcos:capture-delta:health-devsecops-qa",
3+
"type": "CaptureDelta",
4+
"specVersion": "2.0.0",
5+
"opportunityRef": "urn:srcos:opportunity:health-devsecops",
6+
"kind": "Industry-day Q&A",
7+
"monitorSource": "OIT Industry Day site / VOA",
8+
"expected": "2026-04-17",
9+
"responseSlaHours": 24,
10+
"requiredOutput": "delta memo + requirement updates",
11+
"status": "Watching"
12+
}

‎examples/fit_score.json‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
{
2+
"id": "urn:srcos:fit-score:smelter-audit-0001-r2",
3+
"type": "FitScore",
4+
"specVersion": "2.0.0",
5+
"requestRef": "urn:srcos:labor-request:smelter-audit-0001",
6+
"responseRef": "urn:srcos:labor-response:smelter-audit-0001-r2",
7+
"rubric": {
8+
"domain competence": 0.9,
9+
"independence": 1.0,
10+
"turnaround": 0.8
11+
},
12+
"fit": 0.9,
13+
"confidence": 0.85,
14+
"missingEvidence": [
15+
"conflict-of-interest declaration"
16+
]
17+
}

‎examples/labor_award.json‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
{
2+
"id": "urn:srcos:labor-award:smelter-audit-0001",
3+
"type": "LaborAward",
4+
"specVersion": "2.0.0",
5+
"requestRef": "urn:srcos:labor-request:smelter-audit-0001",
6+
"responseRef": "urn:srcos:labor-response:smelter-audit-0001-r2",
7+
"terms": "Fixed $52k, 3 milestones, independence maintained.",
8+
"paymentModel": "milestone",
9+
"milestones": [
10+
{
11+
"title": "On-site inspection",
12+
"status": "delivered",
13+
"proofRef": "urn:srcos:attestation:audit/site"
14+
},
15+
{
16+
"title": "Analysis",
17+
"status": "in_progress"
18+
},
19+
{
20+
"title": "Signed report",
21+
"status": "pending"
22+
}
23+
],
24+
"obligations": [
25+
"maintain independence",
26+
"disclose conflicts"
27+
],
28+
"trustEventRefs": [
29+
"urn:srcos:trust-event:eng-coop-completion-01"
30+
]
31+
}

‎examples/labor_request.json‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
{
2+
"id": "urn:srcos:labor-request:smelter-audit-0001",
3+
"type": "LaborRequest",
4+
"specVersion": "2.0.0",
5+
"requestType": "review",
6+
"requesterRef": "urn:srcos:party:chuquicamata-smelter",
7+
"objective": "Independent audit of smelter emissions controls before the next regulatory window.",
8+
"outcome": "Signed audit report + remediation punch-list.",
9+
"compensation": {
10+
"transparency": "disclosed",
11+
"model": "fixed",
12+
"minAmount": 40000,
13+
"maxAmount": 60000,
14+
"currency": "USD"
15+
},
16+
"schedule": "3-week engagement",
17+
"responseDeadline": "2026-07-20T00:00:00Z",
18+
"evaluationCriteria": [
19+
"domain competence",
20+
"independence",
21+
"turnaround"
22+
],
23+
"status": "shortlisting"
24+
}

‎examples/labor_response.json‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
{
2+
"id": "urn:srcos:labor-response:smelter-audit-0001-r2",
3+
"type": "LaborResponse",
4+
"specVersion": "2.0.0",
5+
"requestRef": "urn:srcos:labor-request:smelter-audit-0001",
6+
"responderRef": "urn:srcos:party:eng-cooperative-4471",
7+
"approach": "Two-auditor team; on-site week 1, analysis week 2, report week 3.",
8+
"terms": "Fixed $52k; independence attested; no prior work for requester.",
9+
"proposedPricing": 52000,
10+
"availability": "starts 2026-07-22",
11+
"evidenceRefs": [
12+
"urn:srcos:attestation:eng-coop/prior-audits"
13+
],
14+
"status": "shortlisted"
15+
}

‎examples/netting_cell.json‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
{
2+
"id": "urn:srcos:netting-cell:cu-trade-0001",
3+
"type": "NettingCell",
4+
"specVersion": "2.0.0",
5+
"legs": [
6+
{
7+
"party": "urn:srcos:party:antofagasta-port",
8+
"role": "A",
9+
"valueRef": "asset://copper-cathode/500t",
10+
"proofRef": "urn:srcos:attestation:antofagasta/bill-of-lading"
11+
},
12+
{
13+
"party": "urn:srcos:party:shanghai-buyer",
14+
"role": "B",
15+
"valueRef": "asset://ASI/1.16M",
16+
"capabilityRef": "cap://import-license/cn"
17+
},
18+
{
19+
"party": "urn:srcos:party:clearing-verifier",
20+
"role": "C",
21+
"proofRef": "urn:srcos:attestation:route-anf-sha/delivery"
22+
}
23+
],
24+
"stage": "Verified",
25+
"truthClass": "ATTESTED",
26+
"admissibility": "release",
27+
"bundleRefs": [
28+
"urn:srcos:triparty-bundle:cu-trade-0001-fill",
29+
"urn:srcos:triparty-bundle:cu-trade-0001-verify"
30+
],
31+
"policyKernelRef": "policy://triparty/release-guard",
32+
"reserveRef": "reserve://asi/primary",
33+
"netAmount": 1160000,
34+
"asset": "ASI",
35+
"supplyChainRef": "hg:route/anf-sha"
36+
}

‎examples/opportunity.json‎

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
{
2+
"id": "urn:srcos:opportunity:health-devsecops",
3+
"type": "Opportunity",
4+
"specVersion": "2.0.0",
5+
"name": "Health Services DevSecOps",
6+
"cluster": "Health",
7+
"missionOwner": "PDS",
8+
"buyingProblem": "Sustain legacy health apps while modernizing safely outside the Oracle Health baseline.",
9+
"priorities": [
10+
"VistA sustainment",
11+
"modernization",
12+
"MUMPS"
13+
],
14+
"deliveryPattern": "Continuity-plus-modernization delivery cell; governed DevSecOps; legacy transition discipline.",
15+
"reuseRepos": [
16+
"prophet-platform",
17+
"prophet-platform-standards",
18+
"agentplane",
19+
"policy-fabric",
20+
"sociosphere"
21+
],
22+
"podRefs": [
23+
"urn:srcos:agent-pod:capture-lead",
24+
"urn:srcos:agent-pod:technical-solution",
25+
"urn:srcos:agent-pod:compliance-matrix",
26+
"urn:srcos:agent-pod:evidence-qa"
27+
],
28+
"sharedLibraryRefs": [
29+
"urn:srcos:shared-library:canonical-operating-model",
30+
"urn:srcos:shared-library:transition-in",
31+
"urn:srcos:shared-library:release-gates"
32+
],
33+
"readinessRef": "urn:srcos:readiness-score:health-devsecops",
34+
"deltaRefs": [
35+
"urn:srcos:capture-delta:health-devsecops-qa"
36+
],
37+
"partnerLane": "Health IT SI; VistA/MUMPS niche partner",
38+
"winTheme": "We preserve continuity while industrializing governed modernization with low-regret migration paths.",
39+
"status": "Active",
40+
"workroomRef": "workroom://health-devsecops",
41+
"controlRoomRef": "controlroom://health-devsecops",
42+
"telos": {
43+
"objective": "Intelligence serves human flourishing",
44+
"constraints": [
45+
"non-domination",
46+
"consent",
47+
"dignity"
48+
]
49+
},
50+
"evidenceRefs": [
51+
"urn:srcos:attestation:health-devsecops/win-theme"
52+
]
53+
}

0 commit comments

Comments
 (0)