owlrunkit 0.21.0 → 0.22.0

package/scripts/runkit-contract/schemas/team-delivery-status-v3.schema.json

@@ -0,0 +1,113 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-delivery-status-v3.schema.json",
+  "title": "OwlCoda RunKit Team Delivery Status V3",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "status", "graphSource", "persistedTeamGraph", "projectId",
+    "projectTruthHash", "projectOverall", "recommendation", "lanes", "pathConflicts",
+    "acceptanceGaps", "ownerTransitions", "externalGates", "deliveryLifecycle",
+    "unmodeledCandidateLanes", "warnings", "warningSummary", "advisorySummary",
+    "nextAction", "dispatch", "authorityBoundary", "authorizationGranted", "exitCode"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamDeliveryStatusV3" },
+    "status": { "const": "team_delivery_status" },
+    "graphSource": { "const": "project_driver" },
+    "persistedTeamGraph": { "const": false },
+    "projectId": { "$ref": "#/$defs/nullableText" },
+    "projectTruthHash": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^[a-f0-9]{64}$" }] },
+    "projectOverall": { "$ref": "#/$defs/text" },
+    "recommendation": {
+      "type": "object", "additionalProperties": false,
+      "required": ["teamCoordinationMode", "coordination", "reasonCodes"],
+      "properties": {
+        "teamCoordinationMode": { "enum": ["off", "team"] },
+        "coordination": { "enum": ["none", "project_driver_team"] },
+        "reasonCodes": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "lanes": { "type": "array", "items": { "$ref": "team-delivery-status-v2.schema.json#/$defs/lane" } },
+    "pathConflicts": { "type": "array", "items": { "$ref": "team-delivery-status-v2.schema.json#/$defs/pathConflict" } },
+    "acceptanceGaps": { "type": "array", "items": { "$ref": "team-delivery-status-v2.schema.json#/$defs/acceptanceGap" } },
+    "ownerTransitions": { "type": "array", "items": { "$ref": "team-delivery-status-v2.schema.json#/$defs/ownerTransition" } },
+    "externalGates": { "type": "array", "items": { "$ref": "team-delivery-status-v2.schema.json#/$defs/externalGate" } },
+    "deliveryLifecycle": { "oneOf": [{ "type": "null" }, { "$ref": "team-delivery-status-v2.schema.json#/$defs/deliveryLifecycle" }] },
+    "unmodeledCandidateLanes": { "type": "array", "items": { "$ref": "team-delivery-status-v2.schema.json#/$defs/candidateLane" } },
+    "warnings": { "type": "array", "items": { "$ref": "#/$defs/advisory" } },
+    "warningSummary": { "$ref": "#/$defs/emptySummary" },
+    "advisorySummary": { "$ref": "#/$defs/advisorySummary" },
+    "nextAction": { "$ref": "#/$defs/nullableText" },
+    "dispatch": { "$ref": "team-delivery-status-v2.schema.json#/$defs/dispatch" },
+    "authorityBoundary": { "$ref": "team-delivery-status-v2.schema.json#/$defs/authorityBoundary" },
+    "authorizationGranted": { "const": false },
+    "exitCode": { "const": 0 }
+  },
+  "$defs": {
+    "text": { "type": "string", "minLength": 1 },
+    "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "nonemptyStrings": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "advisory": {
+      "type": "object", "additionalProperties": false,
+      "required": ["code", "workItemId", "message", "truthRefs", "severity", "blocking", "requiredAtGate", "recommendedAction"],
+      "properties": {
+        "code": { "const": "no_bound_verification_receipt" },
+        "workItemId": { "$ref": "#/$defs/text" },
+        "message": { "$ref": "#/$defs/text" },
+        "truthRefs": { "$ref": "#/$defs/nonemptyStrings" },
+        "severity": { "const": "advisory" },
+        "blocking": { "const": false },
+        "requiredAtGate": { "const": false },
+        "recommendedAction": { "enum": ["no_retroactive_action_required", "bind_quick_or_formal_receipt_if_reusable_evidence_is_required"] }
+      }
+    },
+    "advisoryGroup": {
+      "type": "object", "additionalProperties": false,
+      "required": ["code", "severity", "blocking", "count", "workItemIds", "requiredAtGate", "recommendedAction"],
+      "properties": {
+        "code": { "const": "no_bound_verification_receipt" },
+        "severity": { "const": "advisory" },
+        "blocking": { "const": false },
+        "count": { "type": "integer", "minimum": 1 },
+        "workItemIds": { "$ref": "#/$defs/nonemptyStrings" },
+        "requiredAtGate": { "const": false },
+        "recommendedAction": { "enum": ["no_retroactive_action_required", "bind_quick_or_formal_receipt_if_reusable_evidence_is_required", "review_individual_warning_actions"] }
+      }
+    },
+    "emptySummary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["count", "groups"],
+      "properties": {
+        "count": { "const": 0 },
+        "groups": { "type": "array", "maxItems": 0 }
+      }
+    },
+    "advisorySummary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["count", "groups"],
+      "properties": {
+        "count": { "type": "integer", "minimum": 0 },
+        "groups": { "type": "array", "items": { "$ref": "#/$defs/advisoryGroup" } }
+      }
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitTeamDeliveryStatusV3",
+    "status": "team_delivery_status",
+    "graphSource": "project_driver",
+    "persistedTeamGraph": false,
+    "projectId": null,
+    "projectTruthHash": null,
+    "projectOverall": "not_initialized",
+    "recommendation": { "teamCoordinationMode": "off", "coordination": "none", "reasonCodes": ["project_driver_not_initialized"] },
+    "lanes": [], "pathConflicts": [], "acceptanceGaps": [], "ownerTransitions": [],
+    "externalGates": [], "deliveryLifecycle": null, "unmodeledCandidateLanes": [],
+    "warnings": [], "warningSummary": { "count": 0, "groups": [] },
+    "advisorySummary": { "count": 0, "groups": [] }, "nextAction": null,
+    "dispatch": { "mode": "none", "permitted": false, "nextCommand": null },
+    "authorityBoundary": { "agentDispatch": false, "git": false, "release": false, "deployment": false, "production": false, "business": false, "automation": false, "money": false },
+    "authorizationGranted": false, "exitCode": 0
+  }]
+}

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

@@ -0,0 +1,120 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://owlcoda.com/schemas/runkit/team-recommendation-v2.schema.json",
+  "title": "OwlCoda RunKit Team Recommendation V2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "status", "project", "continuity", "coordination",
+    "assurance", "reasonCodes", "rejectedLighterModes", "lanes",
+    "pathConflicts", "acceptanceGaps", "ownerTransitions", "estimatedOverhead",
+    "nextCommand", "dispatch", "authorityBoundary", "authorizationGranted",
+    "exitCode", "teamCoordinationMode"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "OwlCodaRunKitTeamRecommendationV2" },
+    "status": { "const": "team_delivery_recommended" },
+    "project": {
+      "type": "object", "additionalProperties": false,
+      "required": ["present", "projectId", "projectTruthHash", "overall"],
+      "properties": {
+        "present": { "type": "boolean" },
+        "projectId": { "$ref": "#/$defs/nullableText" },
+        "projectTruthHash": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^[a-f0-9]{64}$" }] },
+        "overall": { "$ref": "#/$defs/nullableText" }
+      }
+    },
+    "teamCoordinationMode": { "enum": ["off", "team"] },
+    "continuity": { "enum": ["none", "project_driver"] },
+    "coordination": { "enum": ["none", "project_driver_team"] },
+    "assurance": {
+      "type": "object", "additionalProperties": false,
+      "required": ["changed", "selection", "reason"],
+      "properties": {
+        "changed": { "const": false },
+        "selection": { "const": "unchanged" },
+        "reason": { "const": "team_delivery_does_not_select_assurance" }
+      }
+    },
+    "reasonCodes": { "$ref": "#/$defs/strings" },
+    "rejectedLighterModes": {
+      "type": "array",
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["mode", "reasonCodes"],
+        "properties": { "mode": { "const": "off" }, "reasonCodes": { "$ref": "#/$defs/nonemptyStrings" } }
+      }
+    },
+    "lanes": { "type": "array", "items": { "$ref": "#/$defs/lane" } },
+    "pathConflicts": { "type": "array", "items": { "$ref": "#/$defs/pathConflict" } },
+    "acceptanceGaps": { "type": "array", "items": { "$ref": "#/$defs/acceptanceGap" } },
+    "ownerTransitions": { "type": "array", "items": { "$ref": "#/$defs/ownerTransition" } },
+    "estimatedOverhead": {
+      "type": "object", "additionalProperties": false,
+      "required": ["additionalOperatorSteps", "potentialPortablePackets"],
+      "properties": {
+        "additionalOperatorSteps": { "type": "integer", "minimum": 0 },
+        "potentialPortablePackets": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "nextCommand": { "$ref": "#/$defs/nullableText" },
+    "dispatch": { "$ref": "#/$defs/dispatch" },
+    "authorityBoundary": { "$ref": "#/$defs/authorityBoundary" },
+    "authorizationGranted": { "const": false },
+    "exitCode": { "const": 0 }
+  },
+  "$defs": {
+    "text": { "type": "string", "minLength": 1 },
+    "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
+    "strings": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "nonemptyStrings": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } },
+    "lane": {
+      "type": "object", "additionalProperties": false,
+      "required": ["workItemId", "title", "status", "agentId", "dependencies", "unresolvedDependencies", "ownedPaths", "actionable", "parallelEligible", "coordinationFacts"],
+      "properties": {
+        "workItemId": { "$ref": "#/$defs/text" }, "title": { "$ref": "#/$defs/text" },
+        "status": { "$ref": "#/$defs/text" }, "agentId": { "$ref": "#/$defs/nullableText" },
+        "dependencies": { "$ref": "#/$defs/strings" }, "unresolvedDependencies": { "$ref": "#/$defs/strings" },
+        "ownedPaths": { "$ref": "#/$defs/nonemptyStrings" }, "actionable": { "type": "boolean" },
+        "parallelEligible": { "type": "boolean" }, "coordinationFacts": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "pathConflict": {
+      "type": "object", "additionalProperties": false,
+      "required": ["leftWorkItemId", "leftPath", "rightWorkItemId", "rightPath"],
+      "properties": { "leftWorkItemId": { "$ref": "#/$defs/text" }, "leftPath": { "$ref": "#/$defs/text" }, "rightWorkItemId": { "$ref": "#/$defs/text" }, "rightPath": { "$ref": "#/$defs/text" } }
+    },
+    "acceptanceGap": {
+      "type": "object", "additionalProperties": false,
+      "required": ["workItemId", "code", "message"],
+      "properties": { "workItemId": { "$ref": "#/$defs/text" }, "code": { "const": "verification_model_family_unbound" }, "message": { "$ref": "#/$defs/text" } }
+    },
+    "ownerTransition": {
+      "type": "object", "additionalProperties": false,
+      "required": ["workItemId", "facts"],
+      "properties": { "workItemId": { "$ref": "#/$defs/text" }, "facts": { "$ref": "#/$defs/nonemptyStrings" } }
+    },
+    "dispatch": {
+      "type": "object", "additionalProperties": false,
+      "required": ["mode", "permitted", "nextCommand"],
+      "properties": { "mode": { "const": "none" }, "permitted": { "const": false }, "nextCommand": { "type": "null" } }
+    },
+    "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 } }
+    }
+  },
+  "examples": [{
+    "schemaVersion": "OwlCodaRunKitTeamRecommendationV2", "status": "team_delivery_recommended",
+    "project": { "present": false, "projectId": null, "projectTruthHash": null, "overall": null },
+    "teamCoordinationMode": "off", "continuity": "none", "coordination": "none",
+    "assurance": { "changed": false, "selection": "unchanged", "reason": "team_delivery_does_not_select_assurance" },
+    "reasonCodes": ["project_driver_not_initialized"], "rejectedLighterModes": [], "lanes": [],
+    "pathConflicts": [], "acceptanceGaps": [], "ownerTransitions": [],
+    "estimatedOverhead": { "additionalOperatorSteps": 0, "potentialPortablePackets": 0 },
+    "nextCommand": null, "dispatch": { "mode": "none", "permitted": false, "nextCommand": null },
+    "authorityBoundary": { "agentDispatch": false, "git": false, "release": false, "deployment": false, "production": false, "business": false, "automation": false, "money": false },
+    "authorizationGranted": false, "exitCode": 0
+  }]
+}

package/scripts/runkit-contract/sync-release-identity.mjs

@@ -252,7 +252,7 @@ export function verifyReleaseIdentitySurfacesV1(input) {
     if (registryGatedArtifact) {
       const rollback = releasePolicy.rollbackRelease.version;
       return markdown.includes(
-        `Bundled release artifact: standalone \`owlrunkit@${core.coreVersion}\``,
+        `Bundled registry-gated artifact: standalone \`owlrunkit@${core.coreVersion}\``,
       )
         && markdown.includes(
           `provenance for \`owlrunkit@${core.coreVersion}\` is independently verified`,

package/scripts/runkit-contract/team-delivery.mjs

@@ -678,6 +678,16 @@ export function recommendTeamDeliveryV1({ workspaceRoot } = {}) {
   return recommendationFromProject(currentProjectStatus(workspaceRoot), workspaceRoot);
 }
 
+export function recommendTeamDeliveryV2(input = {}) {
+  const legacy = recommendTeamDeliveryV1(input);
+  const { recommendedMode, ...rest } = legacy;
+  return {
+    ...rest,
+    schemaVersion: "OwlCodaRunKitTeamRecommendationV2",
+    teamCoordinationMode: recommendedMode,
+  };
+}
+
 function teamDeliveryStatusFromProject(project, workspaceRoot) {
   const recommendation = recommendationFromProject(project, workspaceRoot);
   return {
@@ -770,6 +780,29 @@ export function readTeamDeliveryStatusV2({ workspaceRoot } = {}) {
   };
 }
 
+export function readTeamDeliveryStatusV3({ workspaceRoot } = {}) {
+  const legacy = readTeamDeliveryStatusV2({ workspaceRoot });
+  const warnings = legacy.warnings.map(warning => (
+    warning.code === "no_bound_verification_receipt"
+      ? { ...warning, severity: "advisory" }
+      : warning
+  ));
+  const actionableWarnings = warnings.filter(warning => warning.severity !== "advisory");
+  const advisories = warnings.filter(warning => warning.severity === "advisory");
+  return {
+    ...legacy,
+    schemaVersion: "OwlCodaRunKitTeamDeliveryStatusV3",
+    recommendation: {
+      teamCoordinationMode: legacy.recommendation.recommendedMode,
+      coordination: legacy.recommendation.coordination,
+      reasonCodes: [...legacy.recommendation.reasonCodes],
+    },
+    warnings,
+    warningSummary: aggregateWarningSummary(actionableWarnings),
+    advisorySummary: aggregateWarningSummary(advisories),
+  };
+}
+
 function bindPacketToProject(packet, project, definition, issueCodes) {
   if (!projectBindingValid(packet.projectBinding)) return;
   if (project === null) {
@@ -975,6 +1008,22 @@ export function formatTeamDeliveryRecommendationHumanV1(result) {
   ].join("\n");
 }
 
+export function formatTeamDeliveryRecommendationHumanV2(result) {
+  return [
+    `Team coordination: ${result.teamCoordinationMode}`,
+    `Continuity: ${result.continuity}`,
+    `Coordination: ${result.coordination}`,
+    `Why: ${result.reasonCodes.join(", ") || "none"}`,
+    `Lanes: ${result.lanes.length}`,
+    `Path conflicts: ${result.pathConflicts.length}`,
+    `Acceptance gaps: ${result.acceptanceGaps.length}`,
+    `Next: ${result.nextCommand ?? "none"}`,
+    "Agent dispatch: not permitted.",
+    "Authority: no Git, release, deployment, production, business, automation, or money authorization granted.",
+    "",
+  ].join("\n");
+}
+
 export function formatTeamDeliveryStatusHumanV1(result) {
   return [
     `Team Delivery: ${result.recommendation.recommendedMode}`,
@@ -1018,6 +1067,32 @@ export function formatTeamDeliveryStatusHumanV2(result) {
   ].join("\n");
 }
 
+export function formatTeamDeliveryStatusHumanV3(result) {
+  return [
+    `Team coordination: ${result.recommendation.teamCoordinationMode}`,
+    `Project: ${result.projectId ?? "not initialized"}`,
+    `Project state: ${result.projectOverall}`,
+    `Graph source: ${result.graphSource}`,
+    `Persisted team graph: ${result.persistedTeamGraph ? "yes" : "no"}`,
+    `Lanes: ${result.lanes.length}`,
+    `Path conflicts: ${result.pathConflicts.length}`,
+    `Acceptance gaps: ${result.acceptanceGaps.length}`,
+    `External Gates: ${result.externalGates.length}`,
+    `Unmodeled candidate lanes: ${result.unmodeledCandidateLanes.length}`,
+    `Delivery: ${result.deliveryLifecycle?.currentStage ?? "not initialized"}`,
+    ...(result.warningSummary.count > 0
+      ? [`Warnings: ${result.warningSummary.count} (${result.warningSummary.groups.map(group => `${group.code}:${group.count}`).join(", ")})`]
+      : []),
+    ...(result.advisorySummary.count > 0
+      ? [`Advisories: ${result.advisorySummary.count} (${result.advisorySummary.groups.map(group => `${group.code}:${group.count}`).join(", ")})`]
+      : []),
+    `Next: ${result.nextAction ?? "none"}`,
+    "Agent dispatch: not permitted.",
+    "Authority: not granted.",
+    "",
+  ].join("\n");
+}
+
 export function formatTeamPacketValidationHumanV1(result) {
   return [
     `Team packet: ${result.status}`,

package/scripts/runkit-contract/team-project.mjs

@@ -4475,6 +4475,36 @@ export function readTeamProjectStatusV4({ workspaceRoot }) {
   };
 }
 
+export function readTeamProjectHookSourceV1({ workspaceRoot }) {
+  const loaded = loadProject(workspaceRoot);
+  const normalizedRecords = loaded.events
+    .map(({ event, ref }) => ({
+      event: validateEventShape(event, loaded.definition),
+      ref,
+    }))
+    .sort((left, right) => compareEventFacts(left.event, right.event));
+  const rawProjectTruthHash = sha256(canonical({
+    definition: loaded.definition,
+    events: loaded.events.map(row => row.event),
+  }));
+  const normalizedStatus = projectStatus(
+    loaded.definition,
+    normalizedRecords,
+    loaded.root,
+  );
+  const status = {
+    ...statusV4DeliveryProjection({
+      ...normalizedStatus,
+      projectTruthHash: rawProjectTruthHash,
+    }),
+    exitCode: 0,
+  };
+  return {
+    status,
+    latestProjectFactAt: normalizedRecords.at(-1)?.event.occurredAt ?? null,
+  };
+}
+
 export function readTeamProjectHandoffWaitV1({ workspaceRoot }) {
   const { root, projectRoot: rootPath } = projectRoot(workspaceRoot);
   if (!existsSync(path.join(rootPath, "definition.json"))) {
@@ -4545,7 +4575,10 @@ export function readTeamProjectHandoffWaitV1({ workspaceRoot }) {
   };
 }
 
-export function buildTeamProjectTakeoverV2({ workspaceRoot, agentId }) {
+function buildTeamProjectTakeover(
+  { workspaceRoot, agentId },
+  { includeTerminalFallback = true } = {},
+) {
   safeIdentifier(agentId, "agentId");
   const loaded = loadProject(workspaceRoot);
   const status = projectStatus(loaded.definition, loaded.events, loaded.root);
@@ -4555,7 +4588,7 @@ export function buildTeamProjectTakeoverV2({ workspaceRoot, agentId }) {
     && row.pendingHandoff === null
   ))
     ?? responsibilities.find(row => !["completed", "failed"].includes(row.status))
-    ?? responsibilities.at(-1)
+    ?? (includeTerminalFallback ? responsibilities.at(-1) : null)
     ?? null;
   const pendingForCurrent = current?.pendingHandoff ?? null;
   const pendingForAgent = status.workItems.find(row => (
@@ -4676,6 +4709,10 @@ export function buildTeamProjectTakeoverV2({ workspaceRoot, agentId }) {
   };
 }
 
+export function buildTeamProjectTakeoverV2(input) {
+  return buildTeamProjectTakeover(input);
+}
+
 export function buildTeamProjectTakeoverV1(input) {
   const {
     staleHandoffs: _staleHandoffs,
@@ -4720,6 +4757,29 @@ export function buildTeamProjectTakeoverV3(input) {
   };
 }
 
+export function buildTeamProjectTakeoverV4(input) {
+  const legacy = buildTeamProjectTakeover(input, { includeTerminalFallback: false });
+  const status = readTeamProjectStatusV3({ workspaceRoot: input.workspaceRoot });
+  const byId = new Map(status.workItems.map(row => [row.workItemId, row]));
+  return {
+    ...legacy,
+    schemaVersion: "OwlCodaRunKitTeamProjectTakeoverV4",
+    projectHeadline: status.headline,
+    dominantGap: status.dominantGap,
+    projectNextAction: status.nextAction,
+    projectNextActorId: status.nextActorId,
+    currentResponsibility: legacy.currentResponsibility
+      ? byId.get(legacy.currentResponsibility.workItemId) ?? null
+      : null,
+    allResponsibilities: legacy.allResponsibilities
+      .map(row => byId.get(row.workItemId))
+      .filter(Boolean),
+    deliveryDisposition: status.deliveryDisposition,
+    warnings: status.warnings,
+    authorizationGranted: false,
+  };
+}
+
 export function formatTeamProjectStatusHumanV1(status) {
   const nextAction = status.nextAction === null ? "none" : singleLine(status.nextAction);
   return [