owlrunkit 0.17.1 → 0.18.0

package/scripts/runkit-contract/schemas/team-project-event-v1.schema.json

@@ -8,7 +8,7 @@
   "properties": {
     "schemaVersion": { "const": "OwlCodaRunKitTeamProjectEventV1" },
     "eventId": { "$ref": "#/$defs/id" },
-    "type": { "enum": ["agent_assigned", "checkpoint_recorded", "handoff_recorded", "decision_opened", "decision_resolved", "integration_gate_passed", "data_candidate_recorded"] },
+    "type": { "enum": ["agent_assigned", "checkpoint_recorded", "handoff_recorded", "decision_opened", "decision_resolved", "integration_gate_passed", "verification_deferred", "verification_closed", "data_candidate_recorded"] },
     "occurredAt": { "type": "string", "minLength": 24 },
     "assignmentId": { "$ref": "#/$defs/id" },
     "supersedesAssignmentId": { "$ref": "#/$defs/id" },
@@ -35,6 +35,12 @@
     "resolution": { "type": "string", "minLength": 1 },
     "rationale": { "type": "string", "minLength": 1 },
     "gateId": { "$ref": "#/$defs/id" },
+    "verificationId": { "$ref": "#/$defs/id" },
+    "checkIds": { "$ref": "#/$defs/ids" },
+    "reason": { "type": "string", "minLength": 1 },
+    "dueGateId": { "$ref": "#/$defs/id" },
+    "disposition": { "enum": ["verified", "no_longer_required"] },
+    "decisionIds": { "$ref": "#/$defs/ids" },
     "candidateId": { "$ref": "#/$defs/id" },
     "sourceRef": { "type": "string", "minLength": 1 },
     "rights": { "type": "string", "minLength": 1 },
@@ -76,6 +82,14 @@
       "if": { "properties": { "type": { "const": "integration_gate_passed" } }, "required": ["type"] },
       "then": { "required": ["gateId", "summary", "evidenceRefs"] }
     },
+    {
+      "if": { "properties": { "type": { "const": "verification_deferred" } }, "required": ["type"] },
+      "then": { "required": ["verificationId", "workItemId", "ownerAgentId", "checkIds", "reason", "dueGateId"] }
+    },
+    {
+      "if": { "properties": { "type": { "const": "verification_closed" } }, "required": ["type"] },
+      "then": { "required": ["verificationId", "disposition", "summary", "evidenceRefs", "decisionIds"] }
+    },
     {
       "if": { "properties": { "type": { "const": "data_candidate_recorded" } }, "required": ["type"] },
       "then": { "required": ["candidateId", "sourceRef", "rights", "inputRef", "outputRef", "decisionRef", "verificationRefs", "outcomeRef", "version"] }
@@ -83,6 +97,7 @@
   ],
   "$defs": {
     "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "ids": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
     "strings": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
   },
   "examples": [{

package/scripts/runkit-contract/schemas/team-project-status-v1.schema.json

@@ -4,7 +4,7 @@
   "title": "OwlCoda RunKit Team Project Status V1",
   "type": "object",
   "additionalProperties": false,
-  "required": ["schemaVersion", "status", "projectId", "objective", "overall", "counts", "milestones", "workstreams", "workItems", "agents", "readyQueue", "criticalWorkItems", "openDecisions", "resolvedDecisions", "integrationGates", "dataCandidates", "projectTruthHash", "authorizationGranted", "exitCode"],
+  "required": ["schemaVersion", "status", "projectId", "objective", "overall", "counts", "milestones", "workstreams", "workItems", "agents", "readyQueue", "criticalWorkItems", "openDecisions", "resolvedDecisions", "deferredVerifications", "openDeferredVerificationIds", "integrationGates", "dataCandidates", "projectTruthHash", "authorizationGranted", "headline", "dominantGap", "nextAction", "nextActorId", "exitCode"],
   "properties": {
     "schemaVersion": { "const": "OwlCodaRunKitTeamProjectStatusV1" },
     "status": { "const": "team_project_status" },
@@ -20,10 +20,29 @@
     "criticalWorkItems": { "type": "array", "items": { "type": "string" } },
     "openDecisions": { "type": "array", "items": { "type": "object" } },
     "resolvedDecisions": { "type": "array", "items": { "type": "object" } },
+    "deferredVerifications": { "type": "array", "items": { "type": "object" } },
+    "openDeferredVerificationIds": { "type": "array", "items": { "type": "string" } },
     "integrationGates": { "type": "array", "items": { "type": "object" } },
     "dataCandidates": { "type": "array", "items": { "type": "object" } },
     "projectTruthHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
     "authorizationGranted": { "const": false },
+    "headline": { "type": "string", "minLength": 1 },
+    "dominantGap": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "id", "title", "workItemId", "agentId", "reason", "truthRefs"],
+      "properties": {
+        "kind": { "enum": ["decision", "failed_work", "work_item", "deferred_verification", "integration_gate", "none"] },
+        "id": { "type": ["string", "null"] },
+        "title": { "type": ["string", "null"] },
+        "workItemId": { "type": ["string", "null"] },
+        "agentId": { "type": ["string", "null"] },
+        "reason": { "type": ["string", "null"] },
+        "truthRefs": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+      }
+    },
+    "nextAction": { "type": ["string", "null"] },
+    "nextActorId": { "type": ["string", "null"] },
     "exitCode": { "const": 0 }
   },
   "examples": [{
@@ -41,10 +60,24 @@
     "criticalWorkItems": [],
     "openDecisions": [],
     "resolvedDecisions": [],
+    "deferredVerifications": [],
+    "openDeferredVerificationIds": [],
     "integrationGates": [],
     "dataCandidates": [],
     "projectTruthHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
     "authorizationGranted": false,
+    "headline": "Dominant gap: none; owner: unassigned; blocker: none; next: none.",
+    "dominantGap": {
+      "kind": "none",
+      "id": null,
+      "title": null,
+      "workItemId": null,
+      "agentId": null,
+      "reason": null,
+      "truthRefs": ["project/definition.json"]
+    },
+    "nextAction": null,
+    "nextActorId": null,
     "exitCode": 0
   }]
 }

package/scripts/runkit-contract/schemas/team-project-successor-receipt-v1.schema.json

@@ -0,0 +1,204 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-project-successor-receipt-v1.schema.json",
+  "title": "OwlCoda RunKit Team Project Successor Receipt V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "status",
+    "transitionId",
+    "phase",
+    "occurredAt",
+    "reason",
+    "requestSha256",
+    "receiptPath",
+    "from",
+    "to",
+    "archive",
+    "repositoryActions",
+    "authorizationGranted",
+    "receiptSha256"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamProjectSuccessorReceiptV1" },
+    "status": { "const": "team_project_successor" },
+    "transitionId": { "$ref": "#/$defs/id" },
+    "phase": { "enum": ["prepared", "archived", "active_installed", "completed"] },
+    "occurredAt": { "type": "string", "format": "date-time" },
+    "reason": { "type": "string", "minLength": 1 },
+    "requestSha256": { "$ref": "#/$defs/hash" },
+    "receiptPath": { "type": "string", "minLength": 1 },
+    "from": { "$ref": "#/$defs/projectFrom" },
+    "to": { "$ref": "#/$defs/projectTo" },
+    "archive": { "$ref": "#/$defs/archive" },
+    "repositoryActions": { "$ref": "#/$defs/actions" },
+    "authorizationGranted": { "const": false },
+    "receiptSha256": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
+    },
+    "hash": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "definition": {
+      "type": "object"
+    },
+    "projectFrom": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "projectId",
+        "definition",
+        "definitionRawSha256",
+        "definitionCanonicalSha256",
+        "projectTruthHash",
+        "eventCount"
+      ],
+      "properties": {
+        "projectId": { "$ref": "#/$defs/id" },
+        "definition": { "$ref": "#/$defs/definition" },
+        "definitionRawSha256": { "$ref": "#/$defs/hash" },
+        "definitionCanonicalSha256": { "$ref": "#/$defs/hash" },
+        "projectTruthHash": { "$ref": "#/$defs/hash" },
+        "eventCount": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "projectTo": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "projectId",
+        "definitionSourcePath",
+        "definitionSourceSha256",
+        "definition",
+        "definitionRawSha256",
+        "definitionCanonicalSha256",
+        "projectTruthHash",
+        "eventCount"
+      ],
+      "properties": {
+        "projectId": { "$ref": "#/$defs/id" },
+        "definitionSourcePath": { "type": "string", "minLength": 1 },
+        "definitionSourceSha256": { "$ref": "#/$defs/hash" },
+        "definition": { "$ref": "#/$defs/definition" },
+        "definitionRawSha256": { "$ref": "#/$defs/hash" },
+        "definitionCanonicalSha256": { "$ref": "#/$defs/hash" },
+        "projectTruthHash": { "$ref": "#/$defs/hash" },
+        "eventCount": { "const": 0 }
+      }
+    },
+    "archiveFile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "byteLength", "sha256"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "byteLength": { "type": "integer", "minimum": 0 },
+        "sha256": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "archive": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "manifestAlgorithm", "manifestSha256", "directories", "files", "sealPolicy"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "manifestAlgorithm": { "const": "sha256-canonical-json-v1" },
+        "manifestSha256": { "$ref": "#/$defs/hash" },
+        "directories": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "files": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/archiveFile" }
+        },
+        "sealPolicy": { "$ref": "#/$defs/sealPolicy" }
+      }
+    },
+    "sealPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["policy", "regularFileMode", "directoryMode"],
+      "properties": {
+        "policy": { "const": "posix-owner-write-denied-v1" },
+        "regularFileMode": { "const": "0444" },
+        "directoryMode": { "const": "0555" }
+      }
+    },
+    "actions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["staged", "committed", "pushed", "tagged", "published", "deployed"],
+      "properties": {
+        "staged": { "const": false },
+        "committed": { "const": false },
+        "pushed": { "const": false },
+        "tagged": { "const": false },
+        "published": { "const": false },
+        "deployed": { "const": false }
+      }
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitTeamProjectSuccessorReceiptV1",
+    "status": "team_project_successor",
+    "transitionId": "transition-001",
+    "phase": "completed",
+    "occurredAt": "2026-08-09T08:00:00.000Z",
+    "reason": "Begin the next bounded project.",
+    "requestSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "receiptPath": ".owlcoda/runkit/project-successor-transitions/transition-001.json",
+    "from": {
+      "projectId": "project-old",
+      "definition": {},
+      "definitionRawSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "definitionCanonicalSha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+      "projectTruthHash": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+      "eventCount": 3
+    },
+    "to": {
+      "projectId": "project-new",
+      "definitionSourcePath": "/workspace/next-project.json",
+      "definitionSourceSha256": "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+      "definition": {},
+      "definitionRawSha256": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
+      "definitionCanonicalSha256": "1111111111111111111111111111111111111111111111111111111111111111",
+      "projectTruthHash": "2222222222222222222222222222222222222222222222222222222222222222",
+      "eventCount": 0
+    },
+    "archive": {
+      "path": ".owlcoda/runkit/project-archives/project-old-dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd-4444444444444444444444444444444444444444444444444444444444444444",
+      "manifestAlgorithm": "sha256-canonical-json-v1",
+      "manifestSha256": "4444444444444444444444444444444444444444444444444444444444444444",
+      "directories": ["events"],
+      "files": [{
+        "path": "definition.json",
+        "byteLength": 512,
+        "sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+      }],
+      "sealPolicy": {
+        "policy": "posix-owner-write-denied-v1",
+        "regularFileMode": "0444",
+        "directoryMode": "0555"
+      }
+    },
+    "repositoryActions": {
+      "staged": false,
+      "committed": false,
+      "pushed": false,
+      "tagged": false,
+      "published": false,
+      "deployed": false
+    },
+    "authorizationGranted": false,
+    "receiptSha256": "5555555555555555555555555555555555555555555555555555555555555555"
+  }]
+}