feat(labor): request-centric labor-market contract

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-labor-market-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-labor-market-examples
 	@echo "OK: validate"
 
+validate-labor-market-examples:
+	python3 -m pip install --user jsonschema >/dev/null
+	python3 tools/validate_labor_market_examples.py
+
 validate-control-plane-examples:
 	python3 -m pip install --user jsonschema >/dev/null
 	python3 tools/validate_control_plane_examples.py

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

@@ -0,0 +1,10 @@
+{
+  "id": "urn:srcos:trust-event:eng-coop-completion-01",
+  "type": "TrustEvent",
+  "specVersion": "2.0.0",
+  "subjectRef": "urn:srcos:party:eng-cooperative-4471",
+  "kind": "completion",
+  "requestRef": "urn:srcos:labor-request:smelter-audit-0001",
+  "evidenceRef": "urn:srcos:attestation:audit/site",
+  "issuedAt": "2026-07-25T00:00:00Z"
+}

schemas/FitScore.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.srcos.ai/v2/FitScore.json",
+  "title": "FitScore",
+  "description": "Scores the FIT between a specific request and a specific response. By charter rule the platform scores request↔response fit and MUST NOT publish a universal human-worth / global employability score — hence requestRef AND responseRef are both required and there is no subject-only score.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "type",
+    "specVersion",
+    "requestRef",
+    "responseRef",
+    "fit"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^urn:srcos:fit-score:",
+      "description": "Stable URN. Pattern: urn:srcos:fit-score:<local-id>"
+    },
+    "type": {
+      "const": "FitScore",
+      "description": "Discriminator — always \"FitScore\"."
+    },
+    "specVersion": {
+      "type": "string",
+      "description": "Spec version, e.g. \"2.0.0\"."
+    },
+    "requestRef": {
+      "type": "string",
+      "pattern": "^urn:srcos:labor-request:",
+      "description": "Required — fit is always request-scoped."
+    },
+    "responseRef": {
+      "type": "string",
+      "pattern": "^urn:srcos:labor-response:",
+      "description": "Required — fit is always response-scoped. No global score exists."
+    },
+    "rubric": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1
+      },
+      "description": "Per-dimension fit (0..1) against the request's evaluation criteria."
+    },
+    "fit": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "description": "Overall request↔response fit (0..1)."
+    },
+    "confidence": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1
+    },
+    "missingEvidence": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "description": "Evidence the reviewer still needs to raise confidence."
+    }
+  }
+}

schemas/LaborAward.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.srcos.ai/v2/LaborAward.json",
+  "title": "LaborAward",
+  "description": "The accepted working arrangement — records the selected response, terms, milestones, payment model, and obligations, and anchors the work ledger that tracks fulfillment.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "type",
+    "specVersion",
+    "requestRef",
+    "responseRef",
+    "terms",
+    "paymentModel"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^urn:srcos:labor-award:",
+      "description": "Stable URN. Pattern: urn:srcos:labor-award:<local-id>"
+    },
+    "type": {
+      "const": "LaborAward",
+      "description": "Discriminator — always \"LaborAward\"."
+    },
+    "specVersion": {
+      "type": "string",
+      "description": "Spec version, e.g. \"2.0.0\"."
+    },
+    "requestRef": {
+      "type": "string",
+      "pattern": "^urn:srcos:labor-request:"
+    },
+    "responseRef": {
+      "type": "string",
+      "pattern": "^urn:srcos:labor-response:"
+    },
+    "terms": {
+      "type": "string",
+      "minLength": 1
+    },
+    "paymentModel": {
+      "type": "string",
+      "enum": [
+        "fixed",
+        "hourly",
+        "milestone",
+        "equity",
+        "stipend"
+      ]
+    },
+    "milestones": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "title",
+          "status"
+        ],
+        "properties": {
+          "title": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "pending",
+              "in_progress",
+              "delivered",
+              "approved",
+              "disputed"
+            ]
+          },
+          "proofRef": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        }
+      }
+    },
+    "obligations": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "description": "Obligations both parties accept."
+    },
+    "trustEventRefs": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "pattern": "^urn:srcos:trust-event:"
+      },
+      "description": "Trust events emitted over the life of the award."
+    }
+  }
+}