owlrunkit 0.20.0 → 0.22.0

package/scripts/runkit-contract/schemas/delivery-lifecycle-v1.schema.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/delivery-lifecycle-v1.schema.json",
+  "title": "OwlCoda RunKit Delivery Lifecycle V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "lifecycleStatus", "currentStage", "nextRequiredStage",
+    "blockingStage", "blockingExternalGateIds", "stages", "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitDeliveryLifecycleV1" },
+    "lifecycleStatus": { "enum": ["in_progress", "blocked", "completed"] },
+    "currentStage": {
+      "enum": [
+        "work_ledger_incomplete", "work_ledger_complete", "source_accepted",
+        "integrated", "materialized", "deployed", "live_readback_passed", "product_accepted"
+      ]
+    },
+    "nextRequiredStage": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/stageName" }] },
+    "blockingStage": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/stageName" }] },
+    "blockingExternalGateIds": { "$ref": "#/$defs/strings" },
+    "stages": {
+      "type": "array",
+      "minItems": 6,
+      "maxItems": 6,
+      "prefixItems": [
+        { "$ref": "#/$defs/sourceStage" },
+        { "$ref": "#/$defs/integrationStage" },
+        { "$ref": "#/$defs/materializationStage" },
+        { "$ref": "#/$defs/deploymentStage" },
+        { "$ref": "#/$defs/liveReadbackStage" },
+        { "$ref": "#/$defs/productAcceptanceStage" }
+      ],
+      "items": false
+    },
+    "authorizationGranted": { "const": false }
+  },
+  "allOf": [
+    { "if": { "properties": { "currentStage": { "const": "product_accepted" } }, "required": ["currentStage"] }, "then": { "properties": { "lifecycleStatus": { "const": "completed" }, "nextRequiredStage": { "type": "null" }, "blockingStage": { "type": "null" }, "blockingExternalGateIds": { "maxItems": 0 } } } }
+  ],
+  "examples": [
+    {
+      "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
+    }
+  ],
+  "$defs": {
+    "text": { "type": "string", "minLength": 1 },
+    "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
+    "timestamp": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" },
+    "nullableTimestamp": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/timestamp" }] },
+    "stageName": { "enum": ["source", "integration", "materialization", "deployment", "live_readback", "product_acceptance"] },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "stageBase": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "status", "recordId", "ownerAgentId", "summary", "evidenceRefs", "externalGateIds", "occurredAt", "truthRef"],
+      "properties": {
+        "stage": { "$ref": "#/$defs/stageName" },
+        "status": { "type": "string", "minLength": 1 },
+        "recordId": { "$ref": "#/$defs/nullableText" },
+        "ownerAgentId": { "$ref": "#/$defs/nullableText" },
+        "summary": { "$ref": "#/$defs/nullableText" },
+        "evidenceRefs": { "$ref": "#/$defs/strings" },
+        "externalGateIds": { "$ref": "#/$defs/strings" },
+        "occurredAt": { "$ref": "#/$defs/nullableTimestamp" },
+        "truthRef": { "$ref": "#/$defs/nullableText" }
+      }
+    },
+    "sourceStage": { "allOf": [{ "$ref": "#/$defs/stageBase" }, { "properties": { "stage": { "const": "source" }, "status": { "enum": ["pending", "accepted", "rejected"] } } }] },
+    "integrationStage": { "allOf": [{ "$ref": "#/$defs/stageBase" }, { "properties": { "stage": { "const": "integration" }, "status": { "enum": ["pending", "integrated", "rejected"] } } }] },
+    "materializationStage": { "allOf": [{ "$ref": "#/$defs/stageBase" }, { "properties": { "stage": { "const": "materialization" }, "status": { "enum": ["pending", "materialized", "failed"] } } }] },
+    "deploymentStage": { "allOf": [{ "$ref": "#/$defs/stageBase" }, { "properties": { "stage": { "const": "deployment" }, "status": { "enum": ["pending", "deployed", "failed", "rolled_back"] } } }] },
+    "liveReadbackStage": { "allOf": [{ "$ref": "#/$defs/stageBase" }, { "properties": { "stage": { "const": "live_readback" }, "status": { "enum": ["pending", "passed", "failed"] } } }] },
+    "productAcceptanceStage": { "allOf": [{ "$ref": "#/$defs/stageBase" }, { "properties": { "stage": { "const": "product_acceptance" }, "status": { "enum": ["pending", "accepted", "rejected", "deferred"] } } }] }
+  }
+}

package/scripts/runkit-contract/schemas/external-gate-v1.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/external-gate-v1.schema.json",
+  "title": "OwlCoda RunKit External Gate V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "gateId", "title", "requiredFor", "gateStatus",
+    "blocking", "ownerAgentId", "source", "summary", "evidenceRefs",
+    "occurredAt", "truthRefs", "authorizationGranted"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitExternalGateV1" },
+    "gateId": { "$ref": "#/$defs/id" },
+    "title": { "$ref": "#/$defs/text" },
+    "requiredFor": { "$ref": "#/$defs/stage" },
+    "gateStatus": { "enum": ["pending", "passed", "blocked", "deferred"] },
+    "blocking": { "type": "boolean" },
+    "ownerAgentId": { "$ref": "#/$defs/id" },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["adapterId", "ref", "sha256"],
+      "properties": {
+        "adapterId": { "$ref": "#/$defs/id" },
+        "ref": { "$ref": "#/$defs/text" },
+        "sha256": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "summary": { "$ref": "#/$defs/text" },
+    "evidenceRefs": { "$ref": "#/$defs/nonemptyStrings" },
+    "occurredAt": { "$ref": "#/$defs/timestamp" },
+    "truthRefs": { "$ref": "#/$defs/nonemptyStrings" },
+    "authorizationGranted": { "const": false }
+  },
+  "allOf": [
+    { "if": { "properties": { "gateStatus": { "const": "passed" } }, "required": ["gateStatus"] }, "then": { "properties": { "blocking": { "const": false } } }, "else": { "properties": { "blocking": { "const": true } } } }
+  ],
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitExternalGateV1",
+      "gateId": "packaging-l1",
+      "title": "Packaging cross-family L1",
+      "requiredFor": "source",
+      "gateStatus": "pending",
+      "blocking": true,
+      "ownerAgentId": "reviewer",
+      "source": {
+        "adapterId": "product-contract-v1",
+        "ref": "docs/PRODUCT_CONTRACT.md",
+        "sha256": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+      },
+      "summary": "External acceptance remains pending.",
+      "evidenceRefs": ["artifact:product-contract"],
+      "occurredAt": "2026-08-13T00:03:00.000Z",
+      "truthRefs": ["project/events/external-gate-packaging-pending.json"],
+      "authorizationGranted": false
+    }
+  ],
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
+    "text": { "type": "string", "minLength": 1 },
+    "timestamp": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" },
+    "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "stage": { "enum": ["source", "integration", "materialization", "deployment", "live_readback", "product_acceptance"] },
+    "nonemptyStrings": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } }
+  }
+}

package/scripts/runkit-contract/schemas/fleet-skill-upgrade-plan-v1.schema.json

@@ -0,0 +1,140 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.dev/schemas/runkit/fleet-skill-upgrade-plan-v1.schema.json",
+  "title": "OwlCoda RunKit Fleet Skill Upgrade Plan V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "expectedCore", "sharedSkill", "discovery", "affectedProjects", "blockers", "commands", "authorizationGranted"],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitFleetSkillUpgradePlanV1" },
+    "status": { "enum": ["ready", "blocked"] },
+    "expectedCore": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contractVersion", "coreVersion", "coreManifestSha256", "coreSourceRef"],
+      "properties": {
+        "contractVersion": { "const": "0.2" },
+        "coreVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+        "coreManifestSha256": { "$ref": "#/$defs/sha256" },
+        "coreSourceRef": { "type": "string", "pattern": "^artifact:sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "sharedSkill": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["targetRoot", "status", "installedSkillVersion", "installedConfigCoreVersion", "issues"],
+      "properties": {
+        "targetRoot": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["missing", "unmanaged", "drifted", "version_mismatch", "valid"] },
+        "installedSkillVersion": { "type": ["string", "null"] },
+        "installedConfigCoreVersion": { "type": ["string", "null"] },
+        "issues": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "discovery": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["source", "complete", "workspaceCount", "unreachableRoots"],
+          "properties": {
+            "source": { "type": "string", "minLength": 1 },
+            "complete": { "type": "boolean" },
+            "workspaceCount": { "type": "integer", "minimum": 0 },
+            "unreachableRoots": { "$ref": "#/$defs/strings" }
+          }
+        }
+      ]
+    },
+    "affectedProjects": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["workspaceRoot", "configPath", "configCoreVersion", "activeRunIds", "activeLeaseIds", "upgradeSafe"],
+        "properties": {
+          "workspaceRoot": { "type": "string", "minLength": 1 },
+          "configPath": { "type": "string", "minLength": 1 },
+          "configCoreVersion": { "type": ["string", "null"] },
+          "activeRunIds": { "$ref": "#/$defs/strings" },
+          "activeLeaseIds": { "$ref": "#/$defs/strings" },
+          "upgradeSafe": { "type": "boolean" }
+        }
+      }
+    },
+    "blockers": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["code"],
+        "properties": {
+          "code": { "type": "string", "minLength": 1 },
+          "workspaceRoot": { "type": "string", "minLength": 1 },
+          "artifactId": { "type": "string", "minLength": 1 },
+          "detail": { "type": "string", "minLength": 1 }
+        },
+        "additionalProperties": false
+      }
+    },
+    "commands": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["dryRun", "install", "rollback"],
+      "properties": {
+        "dryRun": { "type": "string", "minLength": 1 },
+        "install": { "type": "string", "minLength": 1 },
+        "rollback": { "type": "string", "minLength": 1 }
+      }
+    },
+    "authorizationGranted": { "const": false }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "status": { "const": "ready" } }, "required": ["status"] },
+      "then": { "properties": { "blockers": { "maxItems": 0 } } },
+      "else": { "properties": { "blockers": { "minItems": 1 } } }
+    }
+  ],
+  "examples": [
+    {
+      "schemaVersion": "OwlCodaRunKitFleetSkillUpgradePlanV1",
+      "status": "blocked",
+      "expectedCore": {
+        "contractVersion": "0.2",
+        "coreVersion": "0.22.0",
+        "coreManifestSha256": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+        "coreSourceRef": "artifact:sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+      },
+      "sharedSkill": {
+        "targetRoot": "/opt/codex/skills/owlcoda-runkit",
+        "status": "version_mismatch",
+        "installedSkillVersion": "0.20.0",
+        "installedConfigCoreVersion": "0.20.0",
+        "issues": ["installed_skill_core_version_mismatch"]
+      },
+      "discovery": { "source": "fleet_registry", "complete": true, "workspaceCount": 1, "unreachableRoots": [] },
+      "affectedProjects": [
+        {
+          "workspaceRoot": "/projects/example",
+          "configPath": "/projects/example/.owlcoda/runkit/config.json",
+          "configCoreVersion": "0.20.0",
+          "activeRunIds": ["active-run"],
+          "activeLeaseIds": [],
+          "upgradeSafe": false
+        }
+      ],
+      "blockers": [{ "code": "active_execution", "workspaceRoot": "/projects/example", "artifactId": "active-run" }],
+      "commands": {
+        "dryRun": "npx --no-install owlrunkit fleet skill-plan ...",
+        "install": "node install-codex-skill.mjs install ...",
+        "rollback": "node install-codex-skill.mjs restore ..."
+      },
+      "authorizationGranted": false
+    }
+  ],
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+  }
+}