@clipboard-health/groundcrew 4.10.0 → 4.10.2

package/dist/commands/cleanupWorkspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cleanupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/cleanupWorkspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMnE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAwBD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE"}
+{"version":3,"file":"cleanupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/cleanupWorkspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQnE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAwBD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE"}

package/dist/commands/cleanupWorkspace.js

@@ -1,6 +1,8 @@
 import { loadConfig } from "../lib/config.js";
+import { readRunState, removeRunState } from "../lib/runState.js";
 import { recordCleanedUpRuns } from "../lib/runStateCleanup.js";
 import { log } from "../lib/util.js";
+import { workspaces } from "../lib/workspaces.js";
 import { worktrees } from "../lib/worktrees.js";
 import { logTeardown } from "./teardownReporter.js";
 function parseArguments(argv) {
@@ -26,7 +28,21 @@ export async function cleanupWorkspace(config, options) {
     const { ticket, force = false } = options;
     const entries = worktrees.findByTicket(config, ticket);
     if (entries.length === 0) {
-        log(`No worktree found for ${ticket}; nothing to clean up.`);
+        if (readRunState(config, ticket) === undefined) {
+            log(`No worktree found for ${ticket}; nothing to clean up.`);
+            return;
+        }
+        const workspaceProbe = await workspaces.probe(config);
+        if (workspaceProbe.kind === "unavailable") {
+            log(`No worktree found for ${ticket}; workspace probe unavailable, leaving run-state intact.`);
+            return;
+        }
+        if (workspaceProbe.names.has(ticket)) {
+            log(`No worktree found for ${ticket}; workspace still present; leaving run-state intact.`);
+            return;
+        }
+        removeRunState(config, ticket);
+        log(`No worktree found for ${ticket}; cleared stale run-state.`);
         return;
     }
     const result = await worktrees.teardown(config, entries, { force });

package/dist/commands/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAanE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAkjBD,wBAAsB,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/F;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7D"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAanE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAonBD,wBAAsB,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/F;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7D"}

package/dist/commands/status.js

@@ -76,11 +76,14 @@ function ticketWorkspaceText(probe, ticket) {
 function isWorkspaceExited(probe, ticket) {
     return probe.kind === "ok" && probe.exitedNames?.has(ticket) === true;
 }
-function formatRunState(state) {
+function formatRunState(state, flags = []) {
     if (state === undefined) {
         return "(none)";
     }
-    const summary = `${state.state}; model=${state.model}; updated=${state.updatedAt}; resumes=${state.resumeCount}`;
+    // Only the leading lifecycle token gains the reconciliation flags; the
+    // `;`-separated detail (model/updated/resumes/reason) is preserved verbatim.
+    const lifecycle = flags.length === 0 ? state.state : `${state.state} (${flags.join(", ")})`;
+    const summary = `${lifecycle}; model=${state.model}; updated=${state.updatedAt}; resumes=${state.resumeCount}`;
     const detail = state.reason ?? state.detail;
     return detail === undefined ? summary : `${summary}; ${detail}`;
 }
@@ -174,7 +177,7 @@ async function writeTicketStatus(config, rawTicket) {
     const accessHint = await exitedWorkspaceAccessHint(config, workspaceProbe, ticket);
     writeOutput(formatTicketLine(ticket, runState, sourceStatus));
     writeTicketTitle(runState, sourceStatus);
-    writeOutput(`run: ${formatRunState(runState)}`);
+    writeOutput(`run: ${formatRunState(runState, runProbeFlags(runState, workspaceProbe, ticket))}`);
     writeOutput(`workspace: ${ticketWorkspaceText(workspaceProbe, ticket)}`);
     if (accessHint !== undefined) {
         writeOutput(`attach: ${accessHint.command}`);
@@ -220,32 +223,43 @@ function formatDuration(ms) {
     const hours = Math.floor((ms - days * MS_PER_DAY) / MS_PER_HOUR);
     return hours === 0 ? `${days}d` : `${days}d ${hours}h`;
 }
+/**
+ * Probe-reconciliation flags shared by the inventory row and the per-ticket
+ * `run:` line. Flags the two interesting disagreements between the recorded
+ * RunState lifecycle and the live workspace probe: a running/resumed dispatch
+ * with a missing or exited session, and an idle row with a stray live or
+ * exited session. `probe.kind === "unavailable"` is "we don't know" and yields
+ * no flags. Excludes the duration token, which only the inventory row appends.
+ */
+function runProbeFlags(runState, probe, ticket) {
+    if (probe.kind !== "ok") {
+        return [];
+    }
+    const lifecycle = runState?.state ?? "idle";
+    const sessionPresent = probe.names.has(ticket);
+    const sessionExited = isWorkspaceExited(probe, ticket);
+    const flags = [];
+    if (lifecycle === "idle" && sessionPresent) {
+        flags.push(sessionExited ? "stray exited session" : "stray session");
+    }
+    if ((lifecycle === "running" || lifecycle === "resumed") && sessionExited) {
+        flags.push("session exited");
+    }
+    else if ((lifecycle === "running" || lifecycle === "resumed") && !sessionPresent) {
+        flags.push("session dead");
+    }
+    return flags;
+}
 /**
  * Combined human-readable state for the inventory row. Surfaces RunState
  * lifecycle and flags the two interesting disagreements with the workspace
- * probe. A recorded running dispatch can have a missing or exited session;
- * an idle row can have a stray live or exited session. `probe.kind ===
- * "unavailable"` is treated as "we don't know" and never produces a suffix.
- * When the row is actively running, appends the elapsed wall-clock time since
- * dispatch.
+ * probe via `runProbeFlags`. When the row is actively running, appends the
+ * elapsed wall-clock time since dispatch.
  */
 function inventoryStateText(runState, probe, ticket, now) {
     const lifecycle = runState?.state ?? "idle";
+    const flags = runProbeFlags(runState, probe, ticket);
     const duration = runStateDurationMs(runState, now);
-    const flags = [];
-    if (probe.kind === "ok") {
-        const sessionPresent = probe.names.has(ticket);
-        const sessionExited = isWorkspaceExited(probe, ticket);
-        if (lifecycle === "idle" && sessionPresent) {
-            flags.push(sessionExited ? "stray exited session" : "stray session");
-        }
-        if ((lifecycle === "running" || lifecycle === "resumed") && sessionExited) {
-            flags.push("session exited");
-        }
-        else if ((lifecycle === "running" || lifecycle === "resumed") && !sessionPresent) {
-            flags.push("session dead");
-        }
-    }
     if (duration !== undefined) {
         flags.push(formatDuration(duration));
     }
@@ -459,6 +473,43 @@ function writeQueueSections(boardResult) {
 function inProgressCount(issues) {
     return issues.filter((issue) => issue.status === "in-progress").length;
 }
+/**
+ * In-progress board issues that have no local worktree. These count toward the
+ * `slots: N/M used` total but are absent from the Worktrees section (their
+ * worktree was removed, or lives outside this config's projectDir /
+ * knownRepositories), so without this they'd be counted yet invisible. Worktree
+ * tickets are lowercased, so the natural id is lowercased before matching.
+ */
+function inProgressWithoutWorktree(issues, worktreeTickets) {
+    return issues
+        .filter((issue) => issue.status === "in-progress")
+        .filter((issue) => !worktreeTickets.has(naturalIdFromCanonical(issue.id).toLowerCase()))
+        .toSorted((left, right) => left.id.localeCompare(right.id));
+}
+function writeInProgressIssue(issue) {
+    const naturalId = naturalIdFromCanonical(issue.id);
+    writeOutput(issue.url === undefined ? naturalId : `${naturalId}  ${issue.url}`);
+    writeOutput(inventoryField("title", issue.title));
+    if (issue.repository !== undefined) {
+        writeOutput(inventoryField("repo", issue.repository));
+    }
+}
+function writeInProgressWithoutWorktree(boardResult, worktreeTickets) {
+    if (boardResult.kind !== "ok") {
+        return;
+    }
+    const issues = inProgressWithoutWorktree(boardResult.issues, worktreeTickets);
+    if (issues.length === 0) {
+        return;
+    }
+    writeSection("In progress (no local worktree)");
+    for (const [index, issue] of issues.entries()) {
+        if (index > 0) {
+            writeOutput();
+        }
+        writeInProgressIssue(issue);
+    }
+}
 async function writeInventoryStatus(config) {
     // Banner ("groundcrew status\n=================") dropped: the command
     // you just ran already tells you what report you're looking at, and the
@@ -469,6 +520,7 @@ async function writeInventoryStatus(config) {
     const worktreeTickets = new Set(worktrees.list(config).map((entry) => entry.ticket));
     writeStraySessions(probe, worktreeTickets);
     const boardResult = await boardResultPromise;
+    writeInProgressWithoutWorktree(boardResult, worktreeTickets);
     if (boardResult.kind === "ok") {
         const used = inProgressCount(boardResult.issues);
         writeOutput();

package/docs/commands.md

@@ -4,7 +4,7 @@
 
 `crew status <TICKET>` prints a read-only snapshot for one ticket: cached title and URL when present, recorded run state, live workspace presence, matching worktrees, git dirtiness, PR links for matching branches, recent log lines when present, and the ticket status from the configured ticket source.
 
-`crew status` with no ticket prints the current inventory: known worktrees with cached ticket metadata, workspace/run-state agreement, attach hints, worktree paths, PR links, and stray sessions reported by the configured backend. Local diagnostics are printed before ticket-source fetches complete. When the source fetch succeeds, status also prints slot usage plus Queue/Blocked sections for eligible Todo tickets. If the source fetch fails, Queue shows `unavailable: <reason>` and the slots line is omitted.
+`crew status` with no ticket prints the current inventory: known worktrees with cached ticket metadata, workspace/run-state agreement, attach hints, worktree paths, PR links, and stray sessions reported by the configured backend. Local diagnostics are printed before ticket-source fetches complete. When the source fetch succeeds, status also prints any in-progress source tickets with no local worktree, slot usage, and Queue/Blocked sections for eligible Todo tickets. Worktree-less in-progress rows include the ticket title, URL when the source provides one, and repository when the source resolves one. If the source fetch fails, Queue shows `unavailable: <reason>` and the slots line is omitted.
 
 Status is informational only. Use `crew cleanup <TICKET>` to tear down stale worktrees and `crew resume <TICKET>` to reopen preserved work.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.10.0",
+  "version": "4.10.2",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",
@@ -68,14 +68,14 @@
     "verify": "node scripts/verifyAll.mts"
   },
   "dependencies": {
-    "@clipboard-health/clearance": "1.1.7",
+    "@clipboard-health/clearance": "1.1.13",
     "@linear/sdk": "86.0.0",
     "cosmiconfig": "9.0.1",
     "tslib": "2.8.1",
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@clipboard-health/ai-rules": "2.21.0",
+    "@clipboard-health/ai-rules": "2.21.1",
     "@clipboard-health/oxlint-config": "1.9.4",
     "@nx/js": "22.7.3",
     "@tsconfig/node24": "24.0.4",

package/static/demo-fixture.sh

@@ -16,12 +16,20 @@ tmux rename-window 'crew run --watch'
 tmux set-option -g status off
 tmux set-option -g pane-border-status top
 tmux set-option -g pane-border-format ' #{?#{m:codex*,#{pane_title}},#[fg=#fbbf24],#{?#{m:claude*,#{pane_title}},#[fg=#60a5fa],#[fg=#77d94e]}}#[bold]#{pane_title}#[default] '
-tmux set-option -g pane-border-style 'fg=#3f3f46'
-tmux set-option -g pane-active-border-style 'fg=#77d94e'
+# Use one divider color for active and inactive panes. tmux highlights only the
+# active-adjacent segment of a shared divider, so a distinct active color makes a
+# single divider render two-tone (and the dim half reads as "missing"). A uniform
+# color keeps every divider a clean, continuous line. Accent lives in pane titles.
+tmux set-option -g pane-border-style 'fg=#52525b'
+tmux set-option -g pane-active-border-style 'fg=#52525b'
 tmux set-option -g remain-on-exit on
 
 printf '\033]2;groundcrew\033\\'
 
+# This agent script prints 12 lines into a split pane. The pane heights are set
+# by `Set Height` in demo.tape (see the note there) so all 12 fit without
+# scrolling — a scrolling pane makes its top border drift. If you add or remove
+# output lines here, keep that height in sync.
 demo_agent_script="$(mktemp "${TMPDIR:-/tmp}/groundcrew-vhs-agent.XXXXXX")"
 trap 'rm -f "${demo_agent_script}"' EXIT
 cat >"${demo_agent_script}" <<'SH'
@@ -60,7 +68,10 @@ printf '%sEditing in isolated branch...%s\n' "${dim}" "${reset}"
 sleep 0.5
 printf '%sRunning verification...%s\n' "${dim}" "${reset}"
 sleep 0.5
-printf '%s%s✓ Ready for review.%s\n' "${green}" "${bold}" "${reset}"
+# No trailing newline: keeps the final line flush against the pane bottom so the
+# pane never has to scroll a phantom empty line (which VHS renders as the top
+# border drifting down).
+printf '%s%s✓ Ready for review.%s' "${green}" "${bold}" "${reset}"
 
 while :; do
   sleep 60
@@ -107,5 +118,8 @@ crew() {
   sleep 0.7
 
   demo_log "${c_dim}Queue clear · next poll in 60s${c_reset}"
-  sleep 8
+  tmux refresh-client
+  # Hold the fully-settled layout on screen. Must outlast the tape's trailing
+  # Sleep so the orchestrator pane never drops back to a shell prompt on camera.
+  sleep 20
 }

package/static/demo.tape

@@ -8,7 +8,11 @@ Require ttyd
 
 Set Shell "bash"
 Set Width 1320
-Set Height 560
+# 690px ≈ 28 terminal rows. The right column splits into two stacked agent panes
+# of ~13 content rows each, sized to hold the demo-fixture.sh agent script's
+# 12-line output without scrolling (a scrolling pane makes its top border drift).
+# Grow this if that output grows past ~13 lines.
+Set Height 690
 Set FontSize 16
 Set FontFamily "Menlo"
 Set Padding 16
@@ -35,7 +39,8 @@ Sleep 1.0
 Type "crew run --watch"
 Sleep 0.4
 Enter
-Sleep 9
+# ~8s of action, then hold the settled layout long enough to read all three panes.
+Sleep 15
 
 Hide
 Type "tmux -f /dev/null -L groundcrew-demo kill-session -t groundcrew"