owlrunkit 0.20.0 → 0.22.0

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

@@ -9,6 +9,7 @@ import { parseJsonStrict } from "./quick-canonical.mjs";
 import {
   normalizeTeamProjectDefinitionV1,
   readTeamProjectStatusV3,
+  readTeamProjectStatusV4,
   teamProjectDefinitionBindingV1,
 } from "./team-project.mjs";
 
@@ -45,6 +46,10 @@ const TRANSFER_LIFECYCLES = new Set([
   "handoff_ack",
   "old_writer_release",
 ]);
+
+function compareCodeUnits(left, right) {
+  return left < right ? -1 : left > right ? 1 : 0;
+}
 const TRANSFER_VERIFICATION_STATUSES = new Set([
   "source_candidate_unverified",
   "source_candidate_verified",
@@ -470,6 +475,11 @@ function currentProjectStatus(workspaceRoot) {
   return readTeamProjectStatusV3({ workspaceRoot });
 }
 
+function currentProjectStatusV2(workspaceRoot) {
+  if (!existsSync(projectDefinitionPath(workspaceRoot))) return null;
+  return readTeamProjectStatusV4({ workspaceRoot });
+}
+
 function readProjectDefinition(workspaceRoot) {
   const { bytes } = readFileBytesBounded(projectDefinitionPath(workspaceRoot));
   return normalizeTeamProjectDefinitionV1(parseJsonStrict(decodeUtf8Strict(bytes)));
@@ -548,6 +558,32 @@ function uniqueSorted(values) {
   return [...new Set(values)].sort();
 }
 
+function explicitCandidateInventory(project) {
+  if (project === null) return [];
+  return [
+    ...project.dataCandidates.map(candidate => ({
+      laneId: `data-candidate:${candidate.candidateId}`,
+      kind: "data_candidate",
+      artifactId: candidate.candidateId,
+      status: candidate.admissionStatus,
+      sourceRef: candidate.sourceRef,
+      actionable: candidate.admissionStatus !== "eligible_candidate",
+      modeledWorkItemId: null,
+      truthRefs: [...candidate.truthRefs],
+    })),
+    ...project.externalGates.map(gate => ({
+      laneId: `external-gate:${gate.gateId}`,
+      kind: "external_gate",
+      artifactId: gate.gateId,
+      status: gate.gateStatus,
+      sourceRef: gate.source.ref,
+      actionable: gate.blocking,
+      modeledWorkItemId: null,
+      truthRefs: [...gate.truthRefs],
+    })),
+  ].sort((left, right) => compareCodeUnits(left.laneId, right.laneId));
+}
+
 function shellQuote(value) {
   return `'${String(value).replaceAll("'", `'"'"'`)}'`;
 }
@@ -642,9 +678,17 @@ export function recommendTeamDeliveryV1({ workspaceRoot } = {}) {
   return recommendationFromProject(currentProjectStatus(workspaceRoot), workspaceRoot);
 }
 
-export function readTeamDeliveryStatusV1({ workspaceRoot } = {}) {
-  if (!nonEmptyString(workspaceRoot)) throw new Error("workspaceRoot is required.");
-  const project = currentProjectStatus(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 {
     schemaVersion: "OwlCodaRunKitTeamDeliveryStatusV1",
@@ -671,6 +715,94 @@ export function readTeamDeliveryStatusV1({ workspaceRoot } = {}) {
   };
 }
 
+export function readTeamDeliveryStatusV1({ workspaceRoot } = {}) {
+  if (!nonEmptyString(workspaceRoot)) throw new Error("workspaceRoot is required.");
+  return teamDeliveryStatusFromProject(currentProjectStatus(workspaceRoot), workspaceRoot);
+}
+
+function enrichedProjectWarnings(project) {
+  return (project?.warnings ?? []).map((warning) => {
+    const workItem = project.workItems.find(row => row.workItemId === warning.workItemId);
+    const completed = workItem?.status === "completed";
+    return {
+      ...warning,
+      severity: "warning",
+      blocking: false,
+      requiredAtGate: false,
+      recommendedAction: completed
+        ? "no_retroactive_action_required"
+        : "bind_quick_or_formal_receipt_if_reusable_evidence_is_required",
+    };
+  });
+}
+
+function aggregateWarningSummary(warnings) {
+  const groups = new Map();
+  for (const warning of warnings) {
+    const current = groups.get(warning.code) ?? {
+      code: warning.code,
+      severity: warning.severity,
+      blocking: warning.blocking,
+      count: 0,
+      workItemIds: [],
+      requiredAtGate: warning.requiredAtGate,
+      recommendedAction: warning.recommendedAction,
+    };
+    current.count += 1;
+    current.workItemIds.push(warning.workItemId);
+    if (current.recommendedAction !== warning.recommendedAction) {
+      current.recommendedAction = "review_individual_warning_actions";
+    }
+    groups.set(warning.code, current);
+  }
+  return {
+    count: warnings.length,
+    groups: [...groups.values()]
+      .map(group => ({ ...group, workItemIds: uniqueSorted(group.workItemIds) }))
+      .sort((left, right) => compareCodeUnits(left.code, right.code)),
+  };
+}
+
+export function readTeamDeliveryStatusV2({ workspaceRoot } = {}) {
+  if (!nonEmptyString(workspaceRoot)) throw new Error("workspaceRoot is required.");
+  const project = currentProjectStatusV2(workspaceRoot);
+  const legacy = teamDeliveryStatusFromProject(project, workspaceRoot);
+  const warnings = enrichedProjectWarnings(project);
+  return {
+    ...legacy,
+    schemaVersion: "OwlCodaRunKitTeamDeliveryStatusV2",
+    externalGates: project?.externalGates ?? [],
+    deliveryLifecycle: project?.deliveryLifecycle ?? null,
+    unmodeledCandidateLanes: explicitCandidateInventory(project),
+    nextAction: project?.nextAction ?? legacy.nextAction,
+    warnings,
+    warningSummary: aggregateWarningSummary(warnings),
+  };
+}
+
+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) {
@@ -876,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}`,
@@ -886,6 +1034,58 @@ export function formatTeamDeliveryStatusHumanV1(result) {
     `Lanes: ${result.lanes.length}`,
     `Path conflicts: ${result.pathConflicts.length}`,
     `Acceptance gaps: ${result.acceptanceGaps.length}`,
+    ...(result.warningSummary?.count > 0
+      ? [`Warnings: ${result.warningSummary.count} non-blocking (${result.warningSummary.groups.map(group => `${group.code}:${group.count}`).join(", ")})`]
+      : []),
+    `Next: ${result.nextAction ?? "none"}`,
+    "Agent dispatch: not permitted.",
+    "Authority: not granted.",
+    "",
+  ].join("\n");
+}
+
+export function formatTeamDeliveryStatusHumanV2(result) {
+  return [
+    `Team Delivery: ${result.recommendation.recommendedMode}`,
+    `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} non-blocking (${result.warningSummary.groups.map(group => `${group.code}:${group.count}`).join(", ")})`]
+      : []),
+    `Next: ${result.nextAction ?? "none"}`,
+    "Agent dispatch: not permitted.",
+    "Authority: not granted.",
+    "",
+  ].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.",