@clipboard-health/groundcrew 4.4.0 → 4.6.0

package/dist/commands/doctor.js

@@ -14,6 +14,7 @@ import { resolveWorkspaceKind } from "../lib/workspaces.js";
 // Tokenization stops after this many non-flag tokens. Two is enough to
 // catch wrapper + wrapped CLI commands like `safehouse claude --foo`.
 const MAX_TOKENS_PER_CMD = 2;
+const SHIPPED_DEFAULT_MODEL_NAMES = ["claude", "codex"];
 async function checkCmd(cmd, required, hint) {
     const path = await which(cmd);
     const resolvedHint = path ?? hint;
@@ -103,14 +104,29 @@ function commandTokensToCheck(cmd) {
     }
     return result;
 }
-function gatherToolTokens(config) {
-    const all = new Set();
-    for (const definition of Object.values(config.models.definitions)) {
+function gatherToolTargets(config) {
+    const all = new Map();
+    for (const [modelName, definition] of Object.entries(config.models.definitions)) {
         for (const token of commandTokensToCheck(definition.cmd)) {
-            all.add(token);
+            const hint = modelCliHint(modelName, token);
+            if (!all.has(token) || all.get(token) === undefined) {
+                all.set(token, hint);
+            }
         }
     }
-    return [...all];
+    return [...all].map(([token, hint]) => (hint === undefined ? { token } : { token, hint }));
+}
+function modelCliHint(modelName, token) {
+    if (token !== modelName) {
+        return undefined;
+    }
+    if (!isShippedDefaultModelName(modelName)) {
+        return undefined;
+    }
+    return `install ${token} or disable it in crew.config.ts: \`models.definitions.${modelName} = { disabled: true }\``;
+}
+function isShippedDefaultModelName(value) {
+    return value === "claude" || value === "codex";
 }
 function format(check) {
     let tag;
@@ -163,11 +179,11 @@ export async function doctor() {
         checkDir(config.workspace.projectDir, "workspace.projectDir"),
         localCapability,
     ];
-    const toolTokens = gatherToolTokens(config);
-    for (const token of toolTokens) {
+    const toolTargets = gatherToolTargets(config);
+    for (const { token, hint } of toolTargets) {
         const required = localCapability.ok;
         // oxlint-disable-next-line no-await-in-loop -- doctor reports tools in deterministic order
-        const check = await checkCmd(token, required, required ? undefined : "required for local runs");
+        const check = await checkCmd(token, required, required ? hint : "required for local runs");
         checks.push(check);
     }
     const usageGatedModels = gatedModels(config);

package/dist/commands/init.d.ts

@@ -4,7 +4,10 @@
  * the shipped `crew.config.example.ts` so a fresh install skips the manual
  * `cp` dance documented in the README.
  */
+import { type LocalRunnerSetting } from "../lib/config.ts";
+declare const INIT_MODELS: readonly ["claude", "codex"];
 type InitConfigScope = "global" | "local";
+type InitModel = (typeof INIT_MODELS)[number];
 interface InitConfigOptions {
     /** Where to write the config. Defaults to "local" (cwd). */
     scope?: InitConfigScope;
@@ -14,6 +17,16 @@ interface InitConfigOptions {
     dryRun?: boolean;
     /** Override for the working directory; defaults to `process.cwd()`. */
     cwd?: string;
+    /** Pre-fill workspace.projectDir in the generated config. */
+    projectDir?: string;
+    /** Pre-fill workspace.knownRepositories in the generated config. */
+    repositories?: string[];
+    /** Pre-fill local.runner in the generated config. */
+    runner?: LocalRunnerSetting;
+    /** Keep one shipped default model enabled and disable the other. */
+    model?: InitModel;
+    /** Override the source template path. */
+    examplePath?: string;
 }
 type InitConfigOutcome = "dry-run-would-write" | "exists" | "wrote";
 interface InitConfigResult {

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,KAAK,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1C,UAAU,iBAAiB;IACzB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,KAAK,iBAAiB,GAAG,qBAAqB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpE,UAAU,gBAAgB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAoB5E;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjE"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAUlF,QAAA,MAAM,WAAW,YAAI,QAAQ,EAAE,OAAO,CAAU,CAAC;AAEjD,KAAK,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;AAC1C,KAAK,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C,UAAU,iBAAiB;IACzB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qDAAqD;IACrD,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,oEAAoE;IACpE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,KAAK,iBAAiB,GAAG,qBAAqB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpE,UAAU,gBAAgB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAoB5E;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAWjE"}

package/dist/commands/init.js

@@ -4,16 +4,21 @@
  * the shipped `crew.config.example.ts` so a fresh install skips the manual
  * `cp` dance documented in the README.
  */
-import { copyFileSync, existsSync, mkdirSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
+import { LOCAL_RUNNER_SETTINGS } from "../lib/config.js";
+import { shellSingleQuote } from "../lib/shell.js";
 import { log, writeOutput } from "../lib/util.js";
 import { xdgConfigPath } from "../lib/xdg.js";
 const CONFIG_FILE_NAME = "crew.config.ts";
 const EXAMPLE_FILE_NAME = "crew.config.example.ts";
+const DEFAULT_EXAMPLE_PROJECT_DIR = "~/dev/groundcrew";
+const INIT_USAGE = "Usage: crew init [--global | --local] [--force] [--dry-run] [--project-dir <dir>] [--repo <owner/repo>]... [--runner <auto|safehouse|sdx|none>] [--model <claude|codex>]";
+const INIT_MODELS = ["claude", "codex"];
 export function initConfig(options = {}) {
     const scope = options.scope ?? "local";
     const cwd = options.cwd ?? process.cwd();
-    const source = resolveExamplePath();
+    const source = options.examplePath ?? resolveExamplePath();
     const destination = destinationFor({ scope, cwd });
     if (existsSync(destination) && options.force !== true) {
         log(`[exists] ${destination} — pass --force to overwrite`);
@@ -24,7 +29,7 @@ export function initConfig(options = {}) {
         return { destination, outcome: "dry-run-would-write" };
     }
     mkdirSync(dirname(destination), { recursive: true });
-    copyFileSync(source, destination);
+    writeFileSync(destination, renderConfig(source, options));
     log(`[wrote] ${destination}`);
     return { destination, outcome: "wrote" };
 }
@@ -36,24 +41,27 @@ export async function initConfigCli(argv) {
         return;
     }
     if (result.outcome === "wrote") {
-        writeOutput("");
-        writeOutput("Next steps:");
-        writeOutput(`  - Edit ${result.destination}`);
-        writeOutput("  - Set workspace.projectDir, workspace.knownRepositories");
-        writeOutput("  - Export GROUNDCREW_LINEAR_API_KEY (or LINEAR_API_KEY)");
-        writeOutput("  - Assign Linear tickets to yourself and add an agent-* label to opt them in");
-        writeOutput("  - Verify with `crew doctor`");
+        writeInitGuidance(result.destination, options);
     }
 }
 function parseArguments(argv) {
     let scope;
     let force = false;
     let dryRun = false;
-    for (const argument of argv) {
+    let projectDir;
+    const repositories = [];
+    let runner;
+    let model;
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        /* v8 ignore next 3 @preserve -- loop bounds keep argv[index] defined */
+        if (argument === undefined) {
+            continue;
+        }
         if (argument === "--global" || argument === "--local") {
             const next = argument === "--global" ? "global" : "local";
             if (scope !== undefined && scope !== next) {
-                throw new Error("crew init: --global and --local are mutually exclusive.\nUsage: crew init [--global | --local] [--force] [--dry-run]");
+                throw new Error(`crew init: --global and --local are mutually exclusive.\n${INIT_USAGE}`);
             }
             scope = next;
             continue;
@@ -66,9 +74,44 @@ function parseArguments(argv) {
             dryRun = true;
             continue;
         }
-        throw new Error(`Unknown option: ${argument}\nUsage: crew init [--global | --local] [--force] [--dry-run]`);
+        if (argument === "--project-dir") {
+            projectDir = readOptionValue(argv, index, argument);
+            index += 1;
+            continue;
+        }
+        if (argument === "--repo") {
+            repositories.push(readOptionValue(argv, index, argument));
+            index += 1;
+            continue;
+        }
+        if (argument === "--runner") {
+            runner = parseRunner(readOptionValue(argv, index, argument));
+            index += 1;
+            continue;
+        }
+        if (argument === "--model") {
+            model = parseModel(readOptionValue(argv, index, argument));
+            index += 1;
+            continue;
+        }
+        throw new Error(`Unknown option: ${argument}\n${INIT_USAGE}`);
+    }
+    const parsed = {
+        scope: scope ?? "local",
+        force,
+        dryRun,
+        repositories,
+    };
+    if (projectDir !== undefined) {
+        parsed.projectDir = projectDir;
     }
-    return { scope: scope ?? "local", force, dryRun };
+    if (runner !== undefined) {
+        parsed.runner = runner;
+    }
+    if (model !== undefined) {
+        parsed.model = model;
+    }
+    return parsed;
 }
 function destinationFor(args) {
     if (args.scope === "global") {
@@ -81,3 +124,127 @@ function resolveExamplePath() {
     // after build; the example ships at the package root in both cases.
     return resolve(import.meta.dirname, "..", "..", EXAMPLE_FILE_NAME);
 }
+function readOptionValue(argv, index, flag) {
+    const value = argv[index + 1];
+    if (value === undefined || value.length === 0 || value.startsWith("-")) {
+        throw new Error(`crew init ${flag}: value is required\n${INIT_USAGE}`);
+    }
+    return value;
+}
+function parseRunner(value) {
+    if (isLocalRunnerSetting(value)) {
+        return value;
+    }
+    throw new Error(`crew init --runner must be one of ${LOCAL_RUNNER_SETTINGS.join(", ")}`);
+}
+function parseModel(value) {
+    if (isInitModel(value)) {
+        return value;
+    }
+    throw new Error(`crew init --model must be one of ${INIT_MODELS.join(", ")}`);
+}
+function isLocalRunnerSetting(value) {
+    return value === "auto" || value === "safehouse" || value === "sdx" || value === "none";
+}
+function isInitModel(value) {
+    return value === "claude" || value === "codex";
+}
+function tsString(value) {
+    return JSON.stringify(value);
+}
+function renderConfig(source, options) {
+    let contents = readFileSync(source, "utf8");
+    if (options.projectDir !== undefined) {
+        contents = replaceRequired(contents, `projectDir: ${tsString(DEFAULT_EXAMPLE_PROJECT_DIR)}`, `projectDir: ${tsString(options.projectDir)}`, "--project-dir");
+    }
+    if (options.repositories !== undefined && options.repositories.length > 0) {
+        contents = replaceRequired(contents, 'knownRepositories: ["your-org/your-repo"]', `knownRepositories: [${options.repositories.map(tsString).join(", ")}]`, "--repo");
+    }
+    if (options.runner !== undefined) {
+        contents = replaceRequired(contents, `  // local: { runner: "auto" },`, `  local: { runner: ${tsString(options.runner)} },`, "--runner");
+    }
+    if (options.model !== undefined) {
+        contents = replaceRequired(contents, "  // prompts: {", `${modelBlock(options.model)}\n  // prompts: {`, "--model");
+    }
+    return contents;
+}
+function replaceRequired(contents, search, replacement, flag) {
+    if (!contents.includes(search)) {
+        throw new Error(`crew init ${flag}: template anchor not found in ${EXAMPLE_FILE_NAME}`);
+    }
+    return contents.replace(search, replacement);
+}
+function modelBlock(model) {
+    const disabled = model === "claude" ? "codex" : "claude";
+    return [
+        "  models: {",
+        `    default: ${tsString(model)},`,
+        "    definitions: {",
+        `      ${disabled}: { disabled: true },`,
+        "    },",
+        "  },",
+        "",
+    ].join("\n");
+}
+function writeInitGuidance(destination, options) {
+    writeOutput("");
+    writeOutput("Next steps:");
+    writeOutput(`  - Review ${destination}`);
+    if (options.projectDir === undefined ||
+        options.repositories === undefined ||
+        options.repositories.length === 0) {
+        writeOutput("  - Set workspace.projectDir and workspace.knownRepositories");
+    }
+    writeCloneGuidance(options);
+    writeOutput("  - If using Linear, export your API key:");
+    writeOutput('      export GROUNDCREW_LINEAR_API_KEY="lin_api_..."');
+    writeOutput("  - In Linear, assign tickets to yourself and add an agent-* label to opt them in");
+    writeOutput("  - Validate and start:");
+    writeOutput("      crew doctor");
+    writeOutput("      crew run --watch");
+}
+function writeCloneGuidance(options) {
+    if (options.repositories === undefined || options.repositories.length === 0) {
+        return;
+    }
+    writeOutput("  - Clone configured repositories:");
+    writeOutput(`      ${projectDirAssignment(options.projectDir ?? DEFAULT_EXAMPLE_PROJECT_DIR)}`);
+    for (const repository of options.repositories) {
+        for (const command of cloneCommands(repository)) {
+            writeOutput(`      ${command}`);
+        }
+    }
+}
+function projectDirAssignment(projectDir) {
+    if (projectDir === "~") {
+        return 'PROJECT_DIR="$HOME"';
+    }
+    if (projectDir.startsWith("~/")) {
+        return `PROJECT_DIR="$HOME/${escapeDoubleQuotedShellValue(projectDir.slice(2))}"`;
+    }
+    return `PROJECT_DIR=${shellSingleQuote(projectDir)}`;
+}
+function cloneCommands(repository) {
+    const parts = repository.split("/");
+    const [owner, name, extra] = parts;
+    if (owner !== undefined && name !== undefined && extra === undefined) {
+        return [
+            `mkdir -p "$PROJECT_DIR/${owner}"`,
+            `git clone git@github.com:${owner}/${name}.git "$PROJECT_DIR/${owner}/${name}"`,
+        ];
+    }
+    return [
+        'mkdir -p "$PROJECT_DIR"',
+        `git clone <REMOTE_URL_FOR_${repository}> "$PROJECT_DIR/${repository}"`,
+    ];
+}
+function escapeDoubleQuotedShellValue(value) {
+    let escaped = "";
+    for (const character of value) {
+        escaped +=
+            character === '"' || character === "\\" || character === "$" || character === "`"
+                ? `\\${character}`
+                : character;
+    }
+    return escaped;
+}

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;AA6gBD,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;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"}

package/dist/commands/status.js

@@ -68,8 +68,14 @@ function ticketWorkspaceText(probe, ticket) {
     if (probe.kind === "unavailable") {
         return workspaceProbeUnavailableLine(probe);
     }
+    if (isWorkspaceExited(probe, ticket)) {
+        return "exited";
+    }
     return probe.names.has(ticket) ? "live" : "not live";
 }
+function isWorkspaceExited(probe, ticket) {
+    return probe.kind === "ok" && probe.exitedNames?.has(ticket) === true;
+}
 function formatRunState(state) {
     if (state === undefined) {
         return "(none)";
@@ -116,6 +122,17 @@ function writeRecentLogs(config, ticket) {
     writeSection("Recent logs");
     writeOutput(logLines.join("\n"));
 }
+async function exitedWorkspaceAccessHint(config, probe, ticket) {
+    if (!isWorkspaceExited(probe, ticket)) {
+        return undefined;
+    }
+    try {
+        return await withLogOutputSuppressed(async () => await workspaces.accessHint(config, ticket));
+    }
+    catch {
+        return undefined;
+    }
+}
 function formatTicketLine(ticket, runState, sourceStatus) {
     const parts = [`ticket: ${ticket}`];
     if (sourceStatus.kind === "found") {
@@ -154,10 +171,14 @@ async function writeTicketStatus(config, rawTicket) {
         withLogOutputSuppressed(async () => await workspaces.probe(config)),
         readTicketSourceStatus(config, ticket),
     ]);
+    const accessHint = await exitedWorkspaceAccessHint(config, workspaceProbe, ticket);
     writeOutput(formatTicketLine(ticket, runState, sourceStatus));
     writeTicketTitle(runState, sourceStatus);
     writeOutput(`run: ${formatRunState(runState)}`);
     writeOutput(`workspace: ${ticketWorkspaceText(workspaceProbe, ticket)}`);
+    if (accessHint !== undefined) {
+        writeOutput(`attach: ${accessHint.command}`);
+    }
     await writeTicketWorktrees(config, ticket);
     writeRecentLogs(config, ticket);
 }
@@ -202,22 +223,26 @@ function formatDuration(ms) {
 /**
  * Combined human-readable state for the inventory row. Surfaces RunState
  * lifecycle and flags the two interesting disagreements with the workspace
- * probe — `(session dead)` when we recorded a running dispatch but no
- * session is alive, and `(stray session)` when a session is alive without
- * any recorded dispatch. `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. 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.
  */
 function inventoryStateText(runState, probe, ticket, now) {
     const lifecycle = runState?.state ?? "idle";
     const duration = runStateDurationMs(runState, now);
     const flags = [];
     if (probe.kind === "ok") {
-        const sessionLive = probe.names.has(ticket);
-        if (lifecycle === "idle" && sessionLive) {
-            flags.push("stray session");
+        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");
         }
-        if ((lifecycle === "running" || lifecycle === "resumed") && !sessionLive) {
+        else if ((lifecycle === "running" || lifecycle === "resumed") && !sessionPresent) {
             flags.push("session dead");
         }
     }
@@ -231,9 +256,11 @@ function inventoryStateText(runState, probe, ticket, now) {
  * probe disagree. Returned commands are safe defaults; the user is free to
  * ignore them and use `attach:` + `pr:` to investigate first.
  *
- * - Stray session (live session, no run-state record) → `crew cleanup` to
- *   tear down the orphaned worktree + close the session.
- * - Session dead (run-state says running/resumed, no live session) →
+ * - Stray session (session present, no run-state record) -> `crew cleanup`
+ *   to tear down the orphaned worktree and close the session.
+ * - Session exited (run-state says running/resumed, kept dead tmux window)
+ *   -> attach first so the failed command remains available for inspection.
+ * - Session dead (run-state says running/resumed, no session present) ->
  *   `crew resume` to bring the agent back; the worktree is preserved.
  *
  * No hint when the probe is unavailable (we genuinely don't know whether
@@ -244,11 +271,17 @@ function inventoryHint(runState, probe, ticket) {
         return undefined;
     }
     const lifecycle = runState?.state ?? "idle";
-    const sessionLive = probe.names.has(ticket);
-    if (lifecycle === "idle" && sessionLive) {
-        return `run 'crew cleanup ${ticket}' to clear this stray session`;
+    const sessionPresent = probe.names.has(ticket);
+    const sessionExited = isWorkspaceExited(probe, ticket);
+    if (lifecycle === "idle" && sessionPresent) {
+        return sessionExited
+            ? `run 'crew cleanup ${ticket}' to clear this stray exited session`
+            : `run 'crew cleanup ${ticket}' to clear this stray session`;
+    }
+    if ((lifecycle === "running" || lifecycle === "resumed") && sessionExited) {
+        return `attach to inspect scrollback, then run 'crew resume ${ticket}'`;
     }
-    if ((lifecycle === "running" || lifecycle === "resumed") && !sessionLive) {
+    if ((lifecycle === "running" || lifecycle === "resumed") && !sessionPresent) {
         return `run 'crew resume ${ticket}' to bring the session back`;
     }
     return undefined;

package/dist/lib/tmuxAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tmuxAdapter.d.ts","sourceRoot":"","sources":["../../src/lib/tmuxAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,OAAO,EAIb,MAAM,uBAAuB,CAAC;AAY/B,eAAO,MAAM,WAAW,EAAE,OAgEzB,CAAC"}
+{"version":3,"file":"tmuxAdapter.d.ts","sourceRoot":"","sources":["../../src/lib/tmuxAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,OAAO,EAIb,MAAM,uBAAuB,CAAC;AAY/B,eAAO,MAAM,WAAW,EAAE,OA+DzB,CAAC"}

package/dist/lib/tmuxAdapter.js

@@ -17,8 +17,7 @@ export const tmuxAdapter = {
     async open(spec, signal) {
         await ensureTmuxSession(signal);
         const target = tmuxTarget(spec.name);
-        const keepDeadWindowsEnv = readEnvironmentVariable("GROUNDCREW_KEEP_DEAD_WINDOWS");
-        const keepDeadWindows = keepDeadWindowsEnv !== undefined && keepDeadWindowsEnv.length > 0;
+        const keepDeadWindows = shouldKeepDeadWindows();
         await runWorkspaceCommand("tmux", [
             "new-window",
             "-d",
@@ -54,7 +53,7 @@ export const tmuxAdapter = {
             // oxlint-disable-next-line unicorn/no-useless-undefined -- undefined marks the workspace backend as unavailable.
             return undefined;
         }
-        return parseTmuxWindows(probe.output);
+        return parseTmuxWindows(probe.output, { includeExited: shouldKeepDeadWindows() });
     },
     async close(name, signal) {
         try {
@@ -78,6 +77,10 @@ export const tmuxAdapter = {
 function tmuxTarget(name) {
     return `${TMUX_SESSION}:${name}`;
 }
+function shouldKeepDeadWindows() {
+    const keepDeadWindowsEnv = readEnvironmentVariable("GROUNDCREW_KEEP_DEAD_WINDOWS");
+    return keepDeadWindowsEnv === "1";
+}
 function isTmuxNotFoundError(error) {
     // runCommand surfaces the child's stderr in error.message, so the "no
     // server" / "missing session" / "can't find window" signatures are visible
@@ -130,7 +133,7 @@ async function ensureTmuxSession(signal) {
         }
     }
 }
-function parseTmuxWindows(output) {
+function parseTmuxWindows(output, options = {}) {
     const items = [];
     for (const line of output.split("\n")) {
         if (line.length === 0) {
@@ -147,10 +150,11 @@ function parseTmuxWindows(output) {
         // pane_dead != 0 means the command exited and the window is a zombie
         // (only happens when remain-on-exit is on; defense in depth in case a
         // user-globally-set value beats our per-window override).
-        if (deadFlag !== undefined && deadFlag !== "0") {
+        const isExited = deadFlag !== undefined && deadFlag !== "0";
+        if (isExited && options.includeExited !== true) {
             continue;
         }
-        items.push({ name });
+        items.push(isExited ? { name, state: "exited" } : { name });
     }
     return items;
 }

package/dist/lib/workspaceAdapter.d.ts

@@ -10,6 +10,8 @@ export type WorkspaceKind = "cmux" | "tmux";
 export interface Workspace {
     /** Ticket id; the join key callers use. */
     name: string;
+    /** Omitted means live, for backends that do not expose an exited state. */
+    state?: "exited";
 }
 export interface WorkspaceStatus {
     text: string;
@@ -37,6 +39,7 @@ export interface OpenSpec {
 export type WorkspaceProbe = {
     kind: "ok";
     names: Set<string>;
+    exitedNames?: Set<string>;
 } | {
     kind: "unavailable";
     error?: unknown;
@@ -60,7 +63,7 @@ export type WorkspaceCloseResult = {
 export interface Adapter {
     open(spec: OpenSpec, signal?: AbortSignal): Promise<void>;
     /**
-     * Live workspaces only. Returns:
+     * Known workspaces. Returns:
      * - `Workspace[]` when the adapter probe succeeded (may be empty).
      * - `undefined` when the adapter binary failed in a way that doesn't
      *   distinguish "no live workspaces" from "couldn't ask".

package/dist/lib/workspaceAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspaceAdapter.d.ts","sourceRoot":"","sources":["../../src/lib/workspaceAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,wBAAwB,GAChC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D;;;;;OAKG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC,CAAC;IAC7D,0DAA0D;IAC1D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzE;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;CAC3D;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAE7D"}
+{"version":3,"file":"workspaceAdapter.d.ts","sourceRoot":"","sources":["../../src/lib/workspaceAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,wBAAwB,GAChC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D;;;;;OAKG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC,CAAC;IAC7D,0DAA0D;IAC1D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzE;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;CAC3D;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAE7D"}

package/dist/lib/workspaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../src/lib/workspaces.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE1E,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,oBAAoB,CAAC;IAChC,QAAQ,EAAE,aAAa,CAAC;IACxB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,gBAAgB,GAAG,mBAAmB,CAUtF;AAsDD,iBAAe,eAAe,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAezB;AAED,iBAAe,sBAAsB,CACnC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAG1C;AAED,iBAAe,kBAAkB,CAC/B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAenC;AAED,eAAO,MAAM,UAAU;IACf,IAAI,SAAS,cAAc,QAAQ,QAAQ,WAAW,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvF,KAAK;IACC,KAAK,SACD,cAAc,QAChB,MAAM,WACH,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAIhC,SAAS;IACT,UAAU;CACX,CAAC"}
+{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../src/lib/workspaces.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE1E,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,oBAAoB,CAAC;IAChC,QAAQ,EAAE,aAAa,CAAC;IACxB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,gBAAgB,GAAG,mBAAmB,CAUtF;AAsDD,iBAAe,eAAe,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAED,iBAAe,sBAAsB,CACnC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAG1C;AAED,iBAAe,kBAAkB,CAC/B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAenC;AAED,eAAO,MAAM,UAAU;IACf,IAAI,SAAS,cAAc,QAAQ,QAAQ,WAAW,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvF,KAAK;IACC,KAAK,SACD,cAAc,QAChB,MAAM,WACH,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAIhC,SAAS;IACT,UAAU;CACX,CAAC"}

package/dist/lib/workspaces.js

@@ -74,7 +74,9 @@ async function probeWorkspaces(config, signal) {
     if (raw === undefined) {
         return { kind: "unavailable" };
     }
-    return { kind: "ok", names: new Set(raw.map((ws) => ws.name)) };
+    const names = new Set(raw.map((ws) => ws.name));
+    const exitedNames = new Set(raw.filter((ws) => ws.state === "exited").map((ws) => ws.name));
+    return exitedNames.size === 0 ? { kind: "ok", names } : { kind: "ok", names, exitedNames };
 }
 async function accessHintForWorkspace(config, name, signal) {
     const adapter = await adapterFor(config, signal);

package/docs/adr/0001-groundcrew-uses-but-does-not-provision-sandboxes.md

@@ -0,0 +1,17 @@
+# Groundcrew uses sandboxes but does not provision them
+
+**Status:** Accepted and implemented. Implementation is tracked under STAFF-1033 and its slices.
+
+Groundcrew launches agent processes _inside_ an isolation backend (safehouse on macOS, sdx/Docker Sandboxes elsewhere, or `none`), but it no longer manages the lifecycle of those sandboxes. We removed `crew sandbox` (ensure/regenerate/auth/rm/list), the auth-recipe machinery, and `lib/dockerSandbox.ts` because they duplicated functionality `sbx` already provides — wrapping someone else's CLI to be marginally more ergonomic cost ~1100 LOC and pulled sandbox-provisioning concepts (templates, kits, auth recipes, git defaults) into groundcrew's config surface for no proportional benefit.
+
+## Considered Options
+
+- **Keep the sdx lifecycle commands** — rejected: they reimplement `sbx run`/`sbx exec` setup flows, and every concept they expose (`authRecipes`, `template`, `kits`, `gitDefaults`) is a sandbox concern, not an orchestration concern.
+- **Generalize the launch wrap to a user-supplied template string** — rejected for now: the build-time-secrets and `.groundcrew/setup.sh` plumbing inside the sdx wrap is awkward to express in a user template. Kept a small `safehouse | sdx | none` WRAP enum in core instead.
+
+## Consequences
+
+- The launch **WRAP** stays in core (`launchCommand.ts`): given an agent command + worktree + secrets + sandbox name, produce the shell string that runs the agent under the chosen backend.
+- First-time sandbox setup is now a manual `sbx` workflow the user runs themselves; the README points to it. Groundcrew assumes the sandbox already exists at launch.
+- Linux/WSL users are unaffected at launch time — they keep the sdx WRAP — but no longer get groundcrew-driven provisioning.
+- Removed config keys (`sandbox.authRecipes`, `sandbox.gitDefaults`, sdx lifecycle fields like `template`/`kits`) hard-fail with an actionable message, matching the existing `config.ts` precedent for removed shapes.

package/docs/adr/0002-one-ticket-source-path-linear-is-an-adapter.md

@@ -0,0 +1,17 @@
+# One ticket-source path; Linear is just an adapter
+
+**Status:** Accepted; not yet implemented. Implementation is tracked under STAFF-1033 / STAFF-1034 (lands PR #89). The past/present tense below describes the decided end state, not the current code — at time of writing `orchestrator.ts` still calls `boardSource.fetch()` and `boardSource.ts` still exists.
+
+There is a single path from board state to dispatch: `Source[] → Board → Dispatcher`. Linear is a `TicketSource` adapter like any other; the dispatcher and eligibility code never import Linear-specific logic. We deleted the legacy `boardSource.ts → dispatcher` path (which made Linear the only source that could actually start agents) and moved the live Linear logic into `src/lib/adapters/linear/`, because the half-wired parallel architecture meant declared shell sources validated at startup but contributed zero tickets to dispatch — defeating the entire pluggable-source point.
+
+## Considered Options
+
+- **Keep `boardSource.ts` as a Linear fast-path and wire extras alongside it** — rejected: two paths from board to dispatch is exactly the coupling that let Linear concepts leak into the dispatcher. The whole value is symmetry — every source, including Linear, reaches dispatch the same way.
+
+## Consequences
+
+- The canonical seam is the `Issue` contract: a source emits `model` and `repository`, or the ticket is ignored (`isGroundcrewIssue` keys off exactly that). Consumers branch on the canonical `CanonicalStatus` enum, never on a source's native status names.
+- **Linear-specific** concepts live in the adapter: `agent-*` label parsing, `agent-any` routing, sub-issue/parent detection, assigned-to-viewer + label selection policy.
+- **Canonical** concepts stay in eligibility so every source benefits: blocker classification (sources populate `blockers[]`) and exhausted-model gating (sources pick a `model`).
+- This was a pure internal refactor with no user-visible change — Linear keeps working identically — so it carried no migration cost and landed before the breaking v5 cuts.
+- Changing the Linear selection mechanism (assigned + labeled) is now an adapter-local change that does not touch the engine.