@tablation/crew 0.54.3 → 0.55.0

package/dist/cli.js

@@ -3283,6 +3283,7 @@ var DEFAULT_CONTRACT = {
     author: "filed_by_id",
     ship: "ship_id",
     heldBy: "held_by_ship_id",
+    resolutionNote: "resolution_note",
     verifiedSha: "verified_sha",
     prRef: "pr_ref",
     position: "position"
@@ -3404,6 +3405,69 @@ function validateContract(c) {
 }
 var EVENT_LOG_MISSING = "the Issues table has no event log \u2014 crew writes its audit trail there (CREW-1574). In the app, open the Issues table's Data & lifecycle tab and turn on Event log, then rerun.";
 
+// src/callout.ts
+var calloutHeader = (kind, label) => `> [!${kind}]
+> **Crew** \u2014 ${label}`;
+var calloutLabelLine = (label) => `> **Crew** \u2014 ${label}`;
+
+// src/gate-red.ts
+var GATE_RED_MARKER = calloutHeader("CAUTION", "Test Gate Red");
+var shaLine = (g) => `Head \`${g.sha.slice(0, 8)}\`.`;
+var GATE_RED_AFTER = 3;
+var lastLines = (output, n) => output.replace(/\u001b\[[0-9;]*m/g, "").trimEnd().split("\n").slice(-n).join("\n");
+function gateRedTickets(merged, merges) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const c of [...merged, ...merges.filter((m) => m.skipReason === "already-merged")]) {
+    if (seen.has(c.ticket.id)) continue;
+    seen.add(c.ticket.id);
+    out.push(c.ticket);
+  }
+  return out;
+}
+function gateRedComment(g) {
+  return `${GATE_RED_MARKER}
+> ${shaLine(g)}
+
+**This ticket is merged on the base, but the release test gate is red \u2014 nothing has shipped.**
+
+The \`test\` hook (\`${g.hook}\`) has failed ${g.count} cycles running on the same head (\`${g.sha.slice(0, 8)}\`). The ticket's commit is on the base and will ship once the gate passes; it is not stranded, and re-setting it to \`verified\` will not help. Last lines of the hook's output:
+
+\`\`\`
+${g.tail}
+\`\`\`
+`;
+}
+var alreadyReported = (ticket, g, events) => events.some((e) => e.record_id === ticket.id && e.event_type === "gate_red" && (e.message ?? "").includes(shaLine(g)));
+
+// src/test-evidence.ts
+var MAX_FAIL_LINES = 20;
+var ANSI = /\u001b\[[0-9;]*m/g;
+var FAIL_LINE = /^\s*(FAIL\b|●\s|not ok\b)/;
+var ERROR_LINE = /\b(?:[A-Z]\w*)?Error\b[:\s]/;
+function failureSummary(output, tailLines = 15) {
+  const lines = output.replace(ANSI, "").trimEnd().split("\n");
+  const names = [];
+  for (const l of lines) {
+    if (FAIL_LINE.test(l) && !names.includes(l.trim())) names.push(l.trim());
+    if (names.length >= MAX_FAIL_LINES) break;
+  }
+  const at = lines.findIndex((l) => ERROR_LINE.test(l));
+  if (names.length === 0 && at < 0) return lastLines(output, tailLines);
+  const parts = [...names];
+  if (at >= 0) parts.push("", ...lines.slice(at, at + 4).map((l) => l.trimEnd()));
+  return parts.join("\n").trim();
+}
+var headLine = (head) => `Candidate head \`${head.slice(0, 8)}\`.`;
+function describeComposition(c) {
+  const rows = c.branches.length ? c.branches.map((b) => `- ${b.key} \`${b.branch}\` @ \`${b.tip.slice(0, 8)}\``).join("\n") : "- (none merged this cycle)";
+  return `${headLine(c.head)} Base before merging \`${c.base.slice(0, 8)}\`. Merged branches:
+
+${rows}
+
+The gate runs on the base plus every verified branch above, not on the base alone: reproduce on that composition.`;
+}
+
 // src/shell.ts
 import { spawn } from "child_process";
 import { platform } from "process";
@@ -3515,7 +3579,13 @@ function describeRelease(o, route) {
     return {
       level: "fail",
       headline: `${route}: release blocked \u2014 tests failed`,
-      detail: "the target stays on the previous release"
+      detail: withHookTail(
+        o.composition ? `the target stays on the previous release
+
+${describeComposition(o.composition)}` : "the target stays on the previous release",
+        o.hookFailure
+      ),
+      ...o.composition ? { head: o.composition.head } : {}
     };
   }
   if (o.stopped === "setup failed") {
@@ -3554,6 +3624,30 @@ function describeRelease(o, route) {
   }
   return null;
 }
+function recoveredFailureHeadlines(o, route) {
+  const setup = `${route}: release blocked \u2014 setup failed`;
+  const tests = `${route}: release blocked \u2014 tests failed`;
+  const build = `${route}: build FAILED`;
+  const deploy = `${route}: deploy FAILED`;
+  if (o.deployed || o.integrated) {
+    return [
+      setup,
+      tests,
+      build,
+      deploy,
+      `${route}: release blocked \u2014 checkout is not on the base branch`,
+      `${route}: release blocked \u2014 working tree is not clean`
+    ];
+  }
+  switch (o.stopped) {
+    case "build failed":
+    case "deploy failed":
+    case "tag push failed":
+      return o.stopped === "deploy failed" ? [setup, tests, build] : [setup, tests];
+    default:
+      return [];
+  }
+}
 
 // src/install.ts
 import { dirname as dirname4, join as join9, extname } from "path";
@@ -6497,11 +6591,6 @@ function materializeBranchForTicket(dir, cfg, t, role, onProblem) {
 import { writeFileSync as writeFileSync7 } from "fs";
 import { join as join11 } from "path";
 
-// src/callout.ts
-var calloutHeader = (kind, label) => `> [!${kind}]
-> **Crew** \u2014 ${label}`;
-var calloutLabelLine = (label) => `> **Crew** \u2014 ${label}`;
-
 // src/stalled.ts
 var STALLED_AFTER_CYCLES = 30;
 var CYCLE_MS = 120 * 1e3;
@@ -7229,36 +7318,6 @@ async function applyStrandedVerified(writer, s, contract, operatorId, memberId,
   }
 }
 
-// src/gate-red.ts
-var GATE_RED_MARKER = calloutHeader("CAUTION", "Test Gate Red");
-var shaLine = (g) => `Head \`${g.sha.slice(0, 8)}\`.`;
-var GATE_RED_AFTER = 3;
-var lastLines = (output, n) => output.replace(/\u001b\[[0-9;]*m/g, "").trimEnd().split("\n").slice(-n).join("\n");
-function gateRedTickets(merged, merges) {
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const c of [...merged, ...merges.filter((m) => m.skipReason === "already-merged")]) {
-    if (seen.has(c.ticket.id)) continue;
-    seen.add(c.ticket.id);
-    out.push(c.ticket);
-  }
-  return out;
-}
-function gateRedComment(g) {
-  return `${GATE_RED_MARKER}
-> ${shaLine(g)}
-
-**This ticket is merged on the base, but the release test gate is red \u2014 nothing has shipped.**
-
-The \`test\` hook (\`${g.hook}\`) has failed ${g.count} cycles running on the same head (\`${g.sha.slice(0, 8)}\`). The ticket's commit is on the base and will ship once the gate passes; it is not stranded, and re-setting it to \`verified\` will not help. Last lines of the hook's output:
-
-\`\`\`
-${g.tail}
-\`\`\`
-`;
-}
-var alreadyReported = (ticket, g, events) => events.some((e) => e.record_id === ticket.id && e.event_type === "gate_red" && (e.message ?? "").includes(shaLine(g)));
-
 // src/agent.ts
 import { spawn as spawn2, spawnSync as spawnSync5 } from "child_process";
 import { readFileSync as readFileSync12, existsSync as existsSync14, statSync as statSync5, mkdirSync as mkdirSync6, writeFileSync as writeFileSync8, createWriteStream, openSync as openSync3, closeSync as closeSync3, readSync } from "fs";
@@ -10693,7 +10752,21 @@ async function mergeAndRelease(o, decision, fresh, releaseBranch, isolated = fal
         const sha = headSha(o.cwd);
         const count = o.state?.noteTestGateFailed?.(sha) ?? 1;
         const gateRed = count >= GATE_RED_AFTER && !o.state?.testGateReported?.(sha) ? { sha, count, hook: hookLabel(o.repo, "test"), tail: lastLines(r.output, 15) } : void 0;
-        return { merged, conflicts, unbuildable, deployed: false, stopped: "tests failed", decision, gateRed };
+        const composition = {
+          head: sha,
+          base: preMerge,
+          branches: merged.filter((c) => c.branch).map((c) => ({
+            key: c.ticket.issue_tag ?? c.ticket.issue_id,
+            branch: c.branch,
+            tip: resolve2(o.cwd, c.branch) ?? ""
+          }))
+        };
+        const hookFailure2 = {
+          hook: "test",
+          label: hookLabel(o.repo, "test"),
+          tail: failureSummary(r.output, HOOK_FAILURE_TAIL_LINES)
+        };
+        return { merged, conflicts, unbuildable, deployed: false, stopped: "tests failed", decision, gateRed, hookFailure: hookFailure2, composition };
       }
       o.state?.clearTestGateFailed?.();
     }
@@ -10865,9 +10938,15 @@ async function applyFailureAlert(writer, n, route, openTickets, memberId, log, d
       return { kind: "commented", issueId: label };
     }
     try {
+      let body = n.detail ?? n.headline;
+      if (n.head && writer.events) {
+        const line = headLine(n.head);
+        const shown = (await writer.events("failure_alert")).some((e) => e.record_id === existing.id && (e.message ?? "").includes(line));
+        if (shown) body = `${n.headline} \u2014 ${line}`;
+      }
       await writer.postEvent(existing.id, `${FAILURE_ALERT_MARKER}
 
-Still failing: ${n.detail ?? n.headline}`, memberId, "failure_alert");
+Still failing: ${body}`, memberId, "failure_alert");
       log.warn(`release failure recurring \u2014 commented on ${label}`, { step: "release" });
       return { kind: "commented", issueId: label };
     } catch (e) {
@@ -10889,12 +10968,64 @@ Still failing: ${n.detail ?? n.headline}`, memberId, "failure_alert");
       ...placement.project_id ? { project_id: placement.project_id } : {}
     }, memberId);
     const label = created.issue_id ? displayKey(created) : created.id;
+    if (n.head) {
+      await writer.postEvent(created.id, `${FAILURE_ALERT_MARKER}
+
+Filed with the evidence above. ${headLine(n.head)}`, memberId, "failure_alert").catch(() => {
+      });
+    }
     log.warn(`release failure \u2014 filed ${label}`, { step: "release" });
     return { kind: "filed", issueId: label };
   } catch (e) {
     return { kind: "failed", why: e.message };
   }
 }
+function alertResolvedStatus(c) {
+  return c.statuses.resolved.find((s) => s === "closed_completed");
+}
+async function applyFailureRecovery(writer, headlines, openTickets, contract, memberId, passed, log, dryRun) {
+  const out = { closed: [], noted: [], failed: [] };
+  const closedStatus = alertResolvedStatus(contract);
+  const closable = /* @__PURE__ */ new Set(["new", contract.statuses.approved, contract.statuses.needsHuman]);
+  for (const headline of headlines) {
+    const alert = findOpenFailureAlert(openTickets, headline);
+    if (!alert) continue;
+    const label = displayKey(alert);
+    const willClose = closedStatus !== void 0 && closable.has(alert.status);
+    if (dryRun) {
+      log.emit(`would ${willClose ? "close" : "note on"} ${label} \u2014 ${passed}`, { step: "release" });
+      continue;
+    }
+    try {
+      await writer.postEvent(
+        alert.id,
+        `${FAILURE_ALERT_MARKER}
+
+Passed: ${passed}.${willClose ? " Closing this alert." : ""}`,
+        memberId,
+        "failure_alert"
+      );
+      if (willClose) {
+        const col = contract.columns;
+        await writer.updateTicket(alert.id, {
+          [contract.columns.status]: closedStatus,
+          [col.resolutionNote]: `Resolved automatically: ${passed}.`,
+          [col.assignee]: null,
+          [col.heldBy]: null
+        });
+        out.closed.push(label);
+        log.emit(`${label} closed \u2014 ${passed}`, { step: "release" });
+      } else {
+        out.noted.push(label);
+        log.emit(`${label} left open \u2014 ${passed}`, { step: "release" });
+      }
+    } catch (e) {
+      out.failed.push(label);
+      log.warn(`could not resolve failure alert ${label}: ${e.message}`, { step: "release" });
+    }
+  }
+  return out;
+}
 
 // src/projects-cmd.ts
 async function buildProjectsReport(routes, open) {
@@ -14792,6 +14923,22 @@ ${changed2.map((c) => `  - ${c}
           });
         }
       }
+      const recovered = recoveredFailureHeadlines(outcome, scope);
+      if (recovered.length) {
+        const passed = outcome.version ? `${scope} released ${outcome.version}` : outcome.deployed || outcome.integrated ? `${scope} release passed` : `${scope} release got past this stage`;
+        await applyFailureRecovery(
+          tracker,
+          recovered,
+          all,
+          tracker.contract,
+          releaseSeat(c),
+          passed,
+          remit,
+          dryRun
+        ).catch((e) => {
+          remit.warn(`could not resolve failure tickets: ${e.message}`, { step: "release" });
+        });
+      }
       if (outcome.buildCulprits?.length) {
         const seat = releaseSeat(c);
         for (const cu of outcome.buildCulprits) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tablation/crew",
-  "version": "0.54.3",
+  "version": "0.55.0",
   "description": "A standing team of headless agents that picks work off a Tablation board, does it on a machine you control, and reports back.",
   "type": "module",
   "license": "MIT",