owlrunkit 0.18.3 → 0.19.0

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

@@ -0,0 +1,146 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-project-event-v3.schema.json",
+  "title": "OwlCoda RunKit Team Project Event V3",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "eventId",
+    "type",
+    "occurredAt",
+    "deliveryId",
+    "projectId",
+    "projectDefinitionSha256",
+    "assignmentId",
+    "workItemId",
+    "producerId",
+    "targetWorkspaceRef",
+    "targetHead",
+    "entrySnapshotRef",
+    "entrySnapshotSha256",
+    "deliveryPacketSha256",
+    "deliveryCandidateFingerprint",
+    "workspaceSnapshotFingerprint",
+    "overlayStatus",
+    "candidateFiles",
+    "changedPaths",
+    "toolCachePaths",
+    "dependencyEnvironmentPaths",
+    "unchangedPacketPaths",
+    "outOfScopeSourcePaths",
+    "targetSnapshot",
+    "proven",
+    "notProven",
+    "targetWritePerformed",
+    "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamProjectEventV3" },
+    "eventId": { "$ref": "#/$defs/id" },
+    "type": { "const": "source_delivery_imported" },
+    "occurredAt": { "type": "string", "minLength": 24 },
+    "deliveryId": { "$ref": "#/$defs/id" },
+    "projectId": { "$ref": "#/$defs/id" },
+    "projectDefinitionSha256": { "$ref": "#/$defs/sha256Ref" },
+    "assignmentId": { "$ref": "#/$defs/id" },
+    "workItemId": { "$ref": "#/$defs/id" },
+    "producerId": { "$ref": "#/$defs/id" },
+    "targetWorkspaceRef": { "type": "string", "minLength": 1 },
+    "targetHead": { "type": "string", "pattern": "^([a-f0-9]{40}|[a-f0-9]{64})$" },
+    "entrySnapshotRef": { "type": ["string", "null"] },
+    "entrySnapshotSha256": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+    "deliveryPacketSha256": { "$ref": "#/$defs/sha256Ref" },
+    "deliveryCandidateFingerprint": { "$ref": "#/$defs/sha256" },
+    "workspaceSnapshotFingerprint": { "$ref": "#/$defs/sha256Ref" },
+    "overlayStatus": { "enum": ["candidate_only", "attested", "attested_with_non_source_changes"] },
+    "candidateFiles": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "sha256"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "sha256": { "$ref": "#/$defs/sha256" }
+        }
+      }
+    },
+    "changedPaths": { "$ref": "#/$defs/strings" },
+    "toolCachePaths": { "$ref": "#/$defs/strings" },
+    "dependencyEnvironmentPaths": { "$ref": "#/$defs/strings" },
+    "unchangedPacketPaths": { "$ref": "#/$defs/strings" },
+    "outOfScopeSourcePaths": { "type": "array", "maxItems": 0 },
+    "targetSnapshot": {
+      "$ref": "https://owlcoda.dev/schemas/runkit/trust/workspace-snapshot-v1.schema.json"
+    },
+    "proven": { "$ref": "#/$defs/nonEmptyStrings" },
+    "notProven": { "$ref": "#/$defs/nonEmptyStrings" },
+    "targetWritePerformed": { "const": false },
+    "authorizationGranted": { "const": false }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "sha256Ref": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "nonEmptyStrings": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+  },
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitTeamProjectEventV3",
+      "eventId": "source-delivery-delivery-1",
+      "type": "source_delivery_imported",
+      "occurredAt": "2026-08-12T08:02:00.000Z",
+      "deliveryId": "delivery-1",
+      "projectId": "external-delivery-project",
+      "projectDefinitionSha256": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+      "assignmentId": "assign-1",
+      "workItemId": "source-change",
+      "producerId": "luna-max",
+      "targetWorkspaceRef": "/workspace",
+      "targetHead": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "entrySnapshotRef": null,
+      "entrySnapshotSha256": null,
+      "deliveryPacketSha256": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+      "deliveryCandidateFingerprint": "c851c3894a37a00c786719b252d2884606b28f2100bfc0e70acc32853b7ea720",
+      "workspaceSnapshotFingerprint": "sha256:ef3eb2c4af62ed5bf0c3fa9e46169fcf48204cc2e9580835f8849b94007a67f0",
+      "overlayStatus": "candidate_only",
+      "candidateFiles": [
+        {
+          "path": "src/main.mjs",
+          "sha256": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+        }
+      ],
+      "changedPaths": [],
+      "toolCachePaths": [],
+      "dependencyEnvironmentPaths": [],
+      "unchangedPacketPaths": [],
+      "outOfScopeSourcePaths": [],
+      "targetSnapshot": {
+        "schemaVersion": "OwlCodaWorkspaceSnapshotV1",
+        "repositoryIdentity": "local:/workspace",
+        "headCommit": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+        "trackedTreeIdentity": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+        "submodules": [],
+        "dirtyOverlay": [
+          {
+            "path": "src/main.mjs",
+            "state": "modified",
+            "sha256": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+          }
+        ],
+        "dependencyLockfiles": [],
+        "excludedRoots": [".owlcoda/runkit"],
+        "ignoredPathsBound": false,
+        "policyVersion": "workspace-snapshot-v1",
+        "sourceFingerprint": "sha256:ef3eb2c4af62ed5bf0c3fa9e46169fcf48204cc2e9580835f8849b94007a67f0"
+      },
+      "proven": ["The candidate file hashes match the target workspace."],
+      "notProven": ["Tests and integration were not proven."],
+      "targetWritePerformed": false,
+      "authorizationGranted": false
+    }
+  ]
+}

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

@@ -0,0 +1,142 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-project-event-v4.schema.json",
+  "title": "OwlCoda RunKit Team Project Event V4",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "eventId", "type", "occurredAt"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamProjectEventV4" },
+    "eventId": { "$ref": "#/$defs/id" },
+    "type": { "enum": ["upstream_reopened", "responsibility_transferred"] },
+    "occurredAt": { "type": "string", "minLength": 24 },
+    "reopenId": { "$ref": "#/$defs/id" },
+    "transferId": { "$ref": "#/$defs/id" },
+    "assignmentId": { "$ref": "#/$defs/id" },
+    "previousAssignmentId": { "$ref": "#/$defs/id" },
+    "previousCheckpointEventId": { "$ref": "#/$defs/id" },
+    "checkpointEventId": { "$ref": "#/$defs/id" },
+    "handoffEventId": { "$ref": "#/$defs/id" },
+    "assignmentEventId": { "$ref": "#/$defs/id" },
+    "workItemId": { "$ref": "#/$defs/id" },
+    "triggerWorkItemId": { "$ref": "#/$defs/id" },
+    "fromAgentId": { "$ref": "#/$defs/id" },
+    "reviewerAgentId": { "$ref": "#/$defs/id" },
+    "toAgentId": { "$ref": "#/$defs/id" },
+    "reason": { "type": "string", "minLength": 1 },
+    "summary": { "type": "string", "minLength": 1 },
+    "state": {
+      "enum": ["active", "waiting_dependency", "waiting_decision", "verifying", "ready_to_integrate"]
+    },
+    "completedUnits": { "type": "integer", "minimum": 0 },
+    "evidenceRefs": { "$ref": "#/$defs/nonEmptyStrings" },
+    "blockerRefs": { "$ref": "#/$defs/strings" },
+    "decisionRefs": { "$ref": "#/$defs/strings" },
+    "nextAction": { "type": "string", "minLength": 1 },
+    "sourceFingerprint": { "type": "string", "pattern": "^(sha256:)?[a-f0-9]{64}$" }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "type": { "const": "upstream_reopened" } },
+        "required": ["type"]
+      },
+      "then": {
+        "required": [
+          "reopenId",
+          "assignmentId",
+          "previousAssignmentId",
+          "previousCheckpointEventId",
+          "workItemId",
+          "triggerWorkItemId",
+          "fromAgentId",
+          "reviewerAgentId",
+          "toAgentId",
+          "reason",
+          "evidenceRefs",
+          "nextAction"
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": { "type": { "const": "responsibility_transferred" } },
+        "required": ["type"]
+      },
+      "then": {
+        "required": [
+          "transferId",
+          "assignmentId",
+          "previousAssignmentId",
+          "checkpointEventId",
+          "handoffEventId",
+          "assignmentEventId",
+          "workItemId",
+          "fromAgentId",
+          "toAgentId",
+          "state",
+          "summary",
+          "evidenceRefs",
+          "blockerRefs",
+          "decisionRefs",
+          "nextAction"
+        ]
+      }
+    }
+  ],
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "strings": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "nonEmptyStrings": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    }
+  },
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitTeamProjectEventV4",
+      "eventId": "upstream-reopened-source-defect-001",
+      "type": "upstream_reopened",
+      "occurredAt": "2026-08-12T10:07:00.000Z",
+      "reopenId": "source-defect-001",
+      "assignmentId": "reopen-source-defect-001",
+      "previousAssignmentId": "assign-source",
+      "previousCheckpointEventId": "checkpoint-source-done",
+      "workItemId": "source",
+      "triggerWorkItemId": "acceptance",
+      "fromAgentId": "source-writer",
+      "reviewerAgentId": "reviewer",
+      "toAgentId": "source-writer",
+      "reason": "Acceptance found a source defect.",
+      "evidenceRefs": ["receipt:acceptance-failure"],
+      "nextAction": "Repair source and produce a fresh candidate."
+    },
+    {
+      "schemaVersion": "OwlCodaRunKitTeamProjectEventV4",
+      "eventId": "responsibility-transferred-engine-a-to-b",
+      "type": "responsibility_transferred",
+      "occurredAt": "2026-08-12T11:01:00.000Z",
+      "transferId": "engine-a-to-b",
+      "assignmentId": "transfer-engine-a-to-b",
+      "previousAssignmentId": "assign-engine-a",
+      "checkpointEventId": "transfer-checkpoint-engine-a-to-b",
+      "handoffEventId": "transfer-handoff-engine-a-to-b",
+      "assignmentEventId": "transfer-assignment-engine-a-to-b",
+      "workItemId": "engine",
+      "fromAgentId": "agent-a",
+      "toAgentId": "agent-b",
+      "state": "active",
+      "summary": "Parser complete; serializer remains.",
+      "evidenceRefs": ["receipt:parser"],
+      "blockerRefs": [],
+      "decisionRefs": [],
+      "nextAction": "Implement serializer."
+    }
+  ]
+}

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

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-project-status-v2.schema.json",
+  "title": "OwlCoda RunKit Team Project Status V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "projectId", "objective", "overall", "counts", "milestones", "workstreams", "workItems", "agents", "readyQueue", "criticalWorkItems", "openDecisions", "resolvedDecisions", "deferredVerifications", "openDeferredVerificationIds", "integrationGates", "dataCandidates", "sourceDeliveries", "projectTruthHash", "authorizationGranted", "headline", "dominantGap", "nextAction", "nextActorId", "exitCode"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamProjectStatusV2" },
+    "status": { "const": "team_project_status" },
+    "projectId": { "type": "string", "minLength": 1 },
+    "objective": { "type": "string", "minLength": 1 },
+    "overall": { "enum": ["planned", "active", "active_with_blockers", "completed"] },
+    "counts": { "type": "object" },
+    "milestones": { "type": "array", "items": { "type": "object" } },
+    "workstreams": { "type": "array", "items": { "type": "object" } },
+    "workItems": { "type": "array", "items": { "type": "object" } },
+    "agents": { "type": "array", "items": { "type": "object" } },
+    "readyQueue": { "type": "array", "items": { "type": "string" } },
+    "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" } },
+    "sourceDeliveries": { "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": [{
+    "schemaVersion": "OwlCodaRunKitTeamProjectStatusV2",
+    "status": "team_project_status",
+    "projectId": "release-0184",
+    "objective": "Import a frozen external delivery",
+    "overall": "active",
+    "counts": {},
+    "milestones": [],
+    "workstreams": [],
+    "workItems": [],
+    "agents": [],
+    "readyQueue": [],
+    "criticalWorkItems": [],
+    "openDecisions": [],
+    "resolvedDecisions": [],
+    "deferredVerifications": [],
+    "openDeferredVerificationIds": [],
+    "integrationGates": [],
+    "dataCandidates": [],
+    "sourceDeliveries": [],
+    "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/usage-mode-recommendation-v2.schema.json

@@ -0,0 +1,136 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/usage-mode-recommendation-v2.json",
+  "title": "OwlCoda RunKit Usage Mode Recommendation V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "status",
+    "requestedMode",
+    "recommendedMode",
+    "continuity",
+    "assurance",
+    "triggerReasons",
+    "rejectedLighterModes",
+    "estimatedOverhead",
+    "nextCommand",
+    "downgrade",
+    "authorityBoundary",
+    "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitUsageModeRecommendationV2" },
+    "status": { "enum": ["mode_recommended", "mode_status"] },
+    "requestedMode": { "enum": ["auto", "off", "light", "managed", "formal"] },
+    "recommendedMode": { "enum": ["off", "light", "managed", "formal"] },
+    "continuity": { "enum": ["none", "project_driver"] },
+    "assurance": { "enum": ["none", "quick", "formal"] },
+    "triggerReasons": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "rejectedLighterModes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["mode", "reasonCodes"],
+        "properties": {
+          "mode": { "enum": ["off", "light", "managed"] },
+          "reasonCodes": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "estimatedOverhead": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["additionalSteps", "evidenceArtifacts"],
+      "properties": {
+        "additionalSteps": { "type": "integer", "minimum": 0 },
+        "evidenceArtifacts": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "nextCommand": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "string", "minLength": 1 }
+      ]
+    },
+    "downgrade": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["allowed", "reasonCodes"],
+      "properties": {
+        "allowed": { "type": "boolean" },
+        "reasonCodes": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "authorityBoundary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["authorizationGranted", "git", "release", "deployment", "production", "business"],
+      "properties": {
+        "authorizationGranted": { "const": false },
+        "git": { "const": false },
+        "release": { "const": false },
+        "deployment": { "const": false },
+        "production": { "const": false },
+        "business": { "const": false }
+      }
+    },
+    "authorizationGranted": { "const": false },
+    "preferenceSource": { "const": "default_auto" },
+    "persistedPreference": { "type": "null" }
+  },
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitUsageModeRecommendationV2",
+      "status": "mode_recommended",
+      "requestedMode": "auto",
+      "recommendedMode": "managed",
+      "continuity": "project_driver",
+      "assurance": "quick",
+      "triggerReasons": ["cross_session_continuity", "single_bounded_verification"],
+      "rejectedLighterModes": [
+        {
+          "mode": "off",
+          "reasonCodes": ["cross_session_continuity", "single_bounded_verification"]
+        },
+        {
+          "mode": "light",
+          "reasonCodes": ["cross_session_continuity", "single_bounded_verification"]
+        }
+      ],
+      "estimatedOverhead": {
+        "additionalSteps": 3,
+        "evidenceArtifacts": 2
+      },
+      "nextCommand": "npx --no-install owlrunkit project status --workspace '.'",
+      "downgrade": {
+        "allowed": true,
+        "reasonCodes": []
+      },
+      "authorityBoundary": {
+        "authorizationGranted": false,
+        "git": false,
+        "release": false,
+        "deployment": false,
+        "production": false,
+        "business": false
+      },
+      "authorizationGranted": false
+    }
+  ]
+}