owlrunkit 0.22.1 → 0.23.0

package/scripts/runkit-contract/schemas/project-completion-continuity-v1.schema.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/project-completion-continuity-v1.schema.json",
+  "title": "OwlCoda RunKit Project Completion Continuity V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "status", "projectId", "projectTruthHash", "disposition",
+    "targetWorkspaceRef", "baseline", "current", "delta", "nextAction",
+    "readOnly", "writesPerformed", "authorityBoundary", "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitProjectCompletionContinuityV1" },
+    "status": { "enum": ["not_applicable", "baseline_missing", "source_unverifiable", "workspace_drift", "terminal"] },
+    "projectId": { "$ref": "#/$defs/text" },
+    "projectTruthHash": { "$ref": "#/$defs/hash" },
+    "disposition": {
+      "enum": [
+        "project_work_ledger_incomplete",
+        "completed_project_source_baseline_missing",
+        "completed_project_source_unverifiable",
+        "completed_project_with_unmodeled_workspace_drift",
+        "completed_project_terminal"
+      ]
+    },
+    "targetWorkspaceRef": { "$ref": "#/$defs/nullableText" },
+    "baseline": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "deliveryId", "occurredAt", "targetHead", "workspaceSnapshotFingerprint", "truthRef"],
+          "properties": {
+            "kind": { "const": "imported_source_delivery" },
+            "deliveryId": { "$ref": "#/$defs/text" },
+            "occurredAt": { "$ref": "#/$defs/text" },
+            "targetHead": { "$ref": "#/$defs/gitHash" },
+            "workspaceSnapshotFingerprint": { "$ref": "#/$defs/hashRef" },
+            "truthRef": { "$ref": "#/$defs/text" }
+          }
+        }
+      ]
+    },
+    "current": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["headCommit", "workspaceSnapshotFingerprint"],
+          "properties": {
+            "headCommit": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/gitHash" }] },
+            "workspaceSnapshotFingerprint": { "$ref": "#/$defs/hashRef" }
+          }
+        }
+      ]
+    },
+    "delta": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "baselineHead", "currentHead", "headChanged", "trackedTreeChanged",
+            "submodulesChanged", "committedPaths", "overlayPaths",
+            "dependencyEnvironmentPaths", "changedPaths", "changedPathCount",
+            "changedPathsTruncated", "pathEvidenceComplete"
+          ],
+          "properties": {
+            "baselineHead": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/gitHash" }] },
+            "currentHead": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/gitHash" }] },
+            "headChanged": { "type": "boolean" },
+            "trackedTreeChanged": { "type": "boolean" },
+            "submodulesChanged": { "type": "boolean" },
+            "committedPaths": { "$ref": "#/$defs/paths" },
+            "overlayPaths": { "$ref": "#/$defs/paths" },
+            "dependencyEnvironmentPaths": { "$ref": "#/$defs/paths" },
+            "changedPaths": { "$ref": "#/$defs/paths" },
+            "changedPathCount": { "type": "integer", "minimum": 0 },
+            "changedPathsTruncated": { "type": "boolean" },
+            "pathEvidenceComplete": { "type": "boolean" }
+          }
+        }
+      ]
+    },
+    "nextAction": { "$ref": "#/$defs/nullableText" },
+    "readOnly": { "const": true },
+    "writesPerformed": { "const": false },
+    "authorityBoundary": { "$ref": "#/$defs/authorityBoundary" },
+    "authorizationGranted": { "const": false }
+  },
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitProjectCompletionContinuityV1",
+      "status": "baseline_missing",
+      "projectId": "completed-project",
+      "projectTruthHash": "0000000000000000000000000000000000000000000000000000000000000000",
+      "disposition": "completed_project_source_baseline_missing",
+      "targetWorkspaceRef": null,
+      "baseline": null,
+      "current": null,
+      "delta": null,
+      "nextAction": "Review the current workspace and bind an explicit source baseline before deciding whether the project is terminal.",
+      "readOnly": true,
+      "writesPerformed": false,
+      "authorityBoundary": {
+        "agentDispatch": false,
+        "git": false,
+        "release": false,
+        "deployment": false,
+        "production": false,
+        "business": false,
+        "automation": false,
+        "money": false
+      },
+      "authorizationGranted": false
+    }
+  ],
+  "$defs": {
+    "text": { "type": "string", "minLength": 1 },
+    "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "hashRef": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "gitHash": { "type": "string", "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$" },
+    "paths": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "authorityBoundary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["agentDispatch", "git", "release", "deployment", "production", "business", "automation", "money"],
+      "properties": {
+        "agentDispatch": { "const": false },
+        "git": { "const": false },
+        "release": { "const": false },
+        "deployment": { "const": false },
+        "production": { "const": false },
+        "business": { "const": false },
+        "automation": { "const": false },
+        "money": { "const": false }
+      }
+    }
+  }
+}

package/scripts/runkit-contract/schemas/successor-scaffold-v1.schema.json

@@ -0,0 +1,184 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/successor-scaffold-v1.schema.json",
+  "title": "OwlCoda RunKit Successor Scaffold V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "status", "exitCode", "project", "completionContinuity",
+    "unmodeledCandidates", "pathConflicts", "possibleLanes", "draft",
+    "nextAction", "persisted", "readOnly", "writesPerformed",
+    "authorityBoundary", "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitSuccessorScaffoldV1" },
+    "status": { "enum": ["successor_review_required", "successor_baseline_missing", "successor_not_required", "successor_source_unverifiable"] },
+    "exitCode": { "const": 0 },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["projectId", "projectTruthHash", "overall"],
+      "properties": {
+        "projectId": { "$ref": "#/$defs/text" },
+        "projectTruthHash": { "$ref": "#/$defs/hash" },
+        "overall": { "const": "completed" }
+      }
+    },
+    "completionContinuity": { "$ref": "project-completion-continuity-v1.schema.json" },
+    "unmodeledCandidates": {
+      "type": "array",
+      "maxItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["candidateId", "kind", "targetWorkspaceRef", "baselineFingerprint", "currentFingerprint", "changedPaths", "changedPathCount", "changedPathsTruncated", "pathEvidenceComplete"],
+        "properties": {
+          "candidateId": { "const": "workspace-drift" },
+          "kind": { "const": "workspace_source_delta" },
+          "targetWorkspaceRef": { "$ref": "#/$defs/text" },
+          "baselineFingerprint": { "$ref": "#/$defs/hashRef" },
+          "currentFingerprint": { "$ref": "#/$defs/hashRef" },
+          "changedPaths": { "$ref": "#/$defs/paths" },
+          "changedPathCount": { "type": "integer", "minimum": 0 },
+          "changedPathsTruncated": { "type": "boolean" },
+          "pathEvidenceComplete": { "type": "boolean" }
+        }
+      }
+    },
+    "pathConflicts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "historicalWorkItemIds"],
+        "properties": {
+          "path": { "$ref": "#/$defs/text" },
+          "historicalWorkItemIds": { "$ref": "#/$defs/nonemptyStrings" }
+        }
+      }
+    },
+    "possibleLanes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["laneId", "basis", "historicalWorkItemId", "suggestedOwnedPaths", "requiresHumanConfirmation"],
+        "properties": {
+          "laneId": { "$ref": "#/$defs/text" },
+          "basis": { "enum": ["historical_owned_paths_only", "unmatched_paths_only"] },
+          "historicalWorkItemId": { "$ref": "#/$defs/nullableText" },
+          "suggestedOwnedPaths": { "$ref": "#/$defs/nonemptyStrings" },
+          "requiresHumanConfirmation": { "const": true }
+        }
+      }
+    },
+    "draft": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["projectId", "objective", "workItems", "requiresHumanConfirmation"],
+      "properties": {
+        "projectId": { "type": "null" },
+        "objective": { "type": "null" },
+        "workItems": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["draftLaneId", "title", "ownedPaths", "ownerAgentId"],
+            "properties": {
+              "draftLaneId": { "$ref": "#/$defs/text" },
+              "title": { "type": "null" },
+              "ownedPaths": { "$ref": "#/$defs/nonemptyStrings" },
+              "ownerAgentId": { "type": "null" }
+            }
+          }
+        },
+        "requiresHumanConfirmation": { "$ref": "#/$defs/nonemptyStrings" }
+      }
+    },
+    "nextAction": { "$ref": "#/$defs/nullableText" },
+    "persisted": { "const": false },
+    "readOnly": { "const": true },
+    "writesPerformed": { "const": false },
+    "authorityBoundary": { "$ref": "project-completion-continuity-v1.schema.json#/$defs/authorityBoundary" },
+    "authorizationGranted": { "const": false }
+  },
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitSuccessorScaffoldV1",
+      "status": "successor_baseline_missing",
+      "exitCode": 0,
+      "project": {
+        "projectId": "completed-project",
+        "projectTruthHash": "0000000000000000000000000000000000000000000000000000000000000000",
+        "overall": "completed"
+      },
+      "completionContinuity": {
+        "schemaVersion": "OwlCodaRunKitProjectCompletionContinuityV1",
+        "status": "baseline_missing",
+        "projectId": "completed-project",
+        "projectTruthHash": "0000000000000000000000000000000000000000000000000000000000000000",
+        "disposition": "completed_project_source_baseline_missing",
+        "targetWorkspaceRef": "/projects/source",
+        "baseline": null,
+        "current": {
+          "headCommit": "0000000000000000000000000000000000000000",
+          "workspaceSnapshotFingerprint": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
+        },
+        "delta": null,
+        "nextAction": "Review the current workspace and bind an explicit source baseline before deciding whether the project is terminal.",
+        "readOnly": true,
+        "writesPerformed": false,
+        "authorityBoundary": {
+          "agentDispatch": false,
+          "git": false,
+          "release": false,
+          "deployment": false,
+          "production": false,
+          "business": false,
+          "automation": false,
+          "money": false
+        },
+        "authorizationGranted": false
+      },
+      "unmodeledCandidates": [],
+      "pathConflicts": [],
+      "possibleLanes": [],
+      "draft": {
+        "projectId": null,
+        "objective": null,
+        "workItems": [],
+        "requiresHumanConfirmation": [
+          "project_id",
+          "objective",
+          "work_item_boundaries",
+          "owners",
+          "acceptance"
+        ]
+      },
+      "nextAction": "Review the current workspace and bind an explicit source baseline before deciding whether the project is terminal.",
+      "persisted": false,
+      "readOnly": true,
+      "writesPerformed": false,
+      "authorityBoundary": {
+        "agentDispatch": false,
+        "git": false,
+        "release": false,
+        "deployment": false,
+        "production": false,
+        "business": false,
+        "automation": false,
+        "money": false
+      },
+      "authorizationGranted": false
+    }
+  ],
+  "$defs": {
+    "text": { "type": "string", "minLength": 1 },
+    "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "hashRef": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "paths": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "nonemptyStrings": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } }
+  }
+}

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

@@ -0,0 +1,169 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-project-status-v5.schema.json",
+  "title": "OwlCoda RunKit Team Project Status V5",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "status", "projectId", "objective", "overall", "counts",
+    "milestones", "workstreams", "workItems", "agents", "readyQueue",
+    "criticalWorkItems", "openDecisions", "resolvedDecisions",
+    "deferredVerifications", "openDeferredVerificationIds", "integrationGates",
+    "dataCandidates", "sourceDeliveries", "warnings", "externalGates",
+    "deliveryLifecycle", "projectTruthHash", "authorizationGranted",
+    "deliveryDisposition", "headline", "dominantGap", "nextAction",
+    "nextActorId", "completionContinuity", "exitCode"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamProjectStatusV5" },
+    "status": { "const": "team_project_status" },
+    "projectId": { "$ref": "#/$defs/text" },
+    "objective": { "$ref": "#/$defs/text" },
+    "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": { "$ref": "#/$defs/strings" },
+    "criticalWorkItems": { "$ref": "#/$defs/strings" },
+    "openDecisions": { "type": "array", "items": { "type": "object" } },
+    "resolvedDecisions": { "type": "array", "items": { "type": "object" } },
+    "deferredVerifications": { "type": "array", "items": { "type": "object" } },
+    "openDeferredVerificationIds": { "$ref": "#/$defs/strings" },
+    "integrationGates": { "type": "array", "items": { "type": "object" } },
+    "dataCandidates": { "type": "array", "items": { "type": "object" } },
+    "sourceDeliveries": { "type": "array", "items": { "type": "object" } },
+    "warnings": { "type": "array", "items": { "type": "object" } },
+    "externalGates": { "type": "array", "items": { "$ref": "external-gate-v1.schema.json" } },
+    "deliveryLifecycle": { "$ref": "delivery-lifecycle-v1.schema.json" },
+    "projectTruthHash": { "$ref": "#/$defs/hash" },
+    "authorizationGranted": { "const": false },
+    "deliveryDisposition": {
+      "enum": [
+        "work_ledger_incomplete", "work_ledger_complete", "source_accepted",
+        "integrated", "materialized", "deployed", "live_readback_passed", "product_accepted"
+      ]
+    },
+    "headline": { "$ref": "#/$defs/text" },
+    "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", "release_authority", "external_gate", "delivery_stage", "source_baseline", "unmodeled_workspace_drift", "none"] },
+        "id": { "$ref": "#/$defs/nullableText" },
+        "title": { "$ref": "#/$defs/nullableText" },
+        "workItemId": { "$ref": "#/$defs/nullableText" },
+        "agentId": { "$ref": "#/$defs/nullableText" },
+        "reason": { "$ref": "#/$defs/nullableText" },
+        "truthRefs": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "nextAction": { "$ref": "#/$defs/nullableText" },
+    "nextActorId": { "$ref": "#/$defs/nullableText" },
+    "completionContinuity": { "$ref": "project-completion-continuity-v1.schema.json" },
+    "exitCode": { "const": 0 }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "deliveryDisposition": { "const": "product_accepted" } }, "required": ["deliveryDisposition"] },
+      "then": {
+        "properties": {
+          "dominantGap": { "properties": { "kind": { "const": "none" } } },
+          "nextAction": { "type": "null" },
+          "nextActorId": { "type": "null" }
+        }
+      }
+    }
+  ],
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitTeamProjectStatusV5",
+      "status": "team_project_status",
+      "projectId": "completed-project",
+      "objective": "Keep completion continuity honest",
+      "overall": "completed",
+      "counts": {},
+      "milestones": [],
+      "workstreams": [],
+      "workItems": [],
+      "agents": [],
+      "readyQueue": [],
+      "criticalWorkItems": [],
+      "openDecisions": [],
+      "resolvedDecisions": [],
+      "deferredVerifications": [],
+      "openDeferredVerificationIds": [],
+      "integrationGates": [],
+      "dataCandidates": [],
+      "sourceDeliveries": [],
+      "warnings": [],
+      "externalGates": [],
+      "deliveryLifecycle": {
+        "schemaVersion": "OwlCodaRunKitDeliveryLifecycleV1",
+        "lifecycleStatus": "in_progress",
+        "currentStage": "work_ledger_complete",
+        "nextRequiredStage": "source",
+        "blockingStage": null,
+        "blockingExternalGateIds": [],
+        "stages": [
+          { "stage": "source", "status": "pending", "recordId": null, "ownerAgentId": null, "summary": null, "evidenceRefs": [], "externalGateIds": [], "occurredAt": null, "truthRef": null },
+          { "stage": "integration", "status": "pending", "recordId": null, "ownerAgentId": null, "summary": null, "evidenceRefs": [], "externalGateIds": [], "occurredAt": null, "truthRef": null },
+          { "stage": "materialization", "status": "pending", "recordId": null, "ownerAgentId": null, "summary": null, "evidenceRefs": [], "externalGateIds": [], "occurredAt": null, "truthRef": null },
+          { "stage": "deployment", "status": "pending", "recordId": null, "ownerAgentId": null, "summary": null, "evidenceRefs": [], "externalGateIds": [], "occurredAt": null, "truthRef": null },
+          { "stage": "live_readback", "status": "pending", "recordId": null, "ownerAgentId": null, "summary": null, "evidenceRefs": [], "externalGateIds": [], "occurredAt": null, "truthRef": null },
+          { "stage": "product_acceptance", "status": "pending", "recordId": null, "ownerAgentId": null, "summary": null, "evidenceRefs": [], "externalGateIds": [], "occurredAt": null, "truthRef": null }
+        ],
+        "authorizationGranted": false
+      },
+      "projectTruthHash": "0000000000000000000000000000000000000000000000000000000000000000",
+      "authorizationGranted": false,
+      "deliveryDisposition": "work_ledger_complete",
+      "headline": "Dominant gap: source_baseline; an explicit source baseline is missing.",
+      "dominantGap": {
+        "kind": "source_baseline",
+        "id": "last-modeled-source",
+        "title": "Source baseline missing",
+        "workItemId": null,
+        "agentId": null,
+        "reason": "The completed Project Driver ledger has no explicit source snapshot baseline.",
+        "truthRefs": ["project/definition.json"]
+      },
+      "nextAction": "Review the current workspace and bind an explicit source baseline before deciding whether the project is terminal.",
+      "nextActorId": null,
+      "completionContinuity": {
+        "schemaVersion": "OwlCodaRunKitProjectCompletionContinuityV1",
+        "status": "baseline_missing",
+        "projectId": "completed-project",
+        "projectTruthHash": "0000000000000000000000000000000000000000000000000000000000000000",
+        "disposition": "completed_project_source_baseline_missing",
+        "targetWorkspaceRef": null,
+        "baseline": null,
+        "current": null,
+        "delta": null,
+        "nextAction": "Review the current workspace and bind an explicit source baseline before deciding whether the project is terminal.",
+        "readOnly": true,
+        "writesPerformed": false,
+        "authorityBoundary": {
+          "agentDispatch": false,
+          "git": false,
+          "release": false,
+          "deployment": false,
+          "production": false,
+          "business": false,
+          "automation": false,
+          "money": false
+        },
+        "authorizationGranted": false
+      },
+      "exitCode": 0
+    }
+  ],
+  "$defs": {
+    "text": { "type": "string", "minLength": 1 },
+    "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}