@clipboard-health/groundcrew 4.0.2 → 4.1.0

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

@@ -0,0 +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"}

package/dist/lib/workspaceAdapter.js

@@ -0,0 +1,17 @@
+/**
+ * Shared contract for Workspace backends. A Workspace is the host-side
+ * terminal session that runs an agent for one ticket; `Workspace.name` is
+ * the ticket id callers key on. The cmux and tmux adapters implement this
+ * interface in their own files (`cmuxAdapter.ts`, `tmuxAdapter.ts`);
+ * `workspaces.ts` resolves and fronts them. This is internal cleanup, not a
+ * plugin contract — nothing here is a published extension point.
+ */
+import { runCommandAsync } from "./commandRunner.js";
+export async function runWorkspaceCommand(command, arguments_, signal) {
+    return signal === undefined
+        ? await runCommandAsync(command, arguments_)
+        : await runCommandAsync(command, arguments_, { signal });
+}
+export function isSignalAborted(signal) {
+    return signal?.aborted === true;
+}

package/dist/lib/workspaces.d.ts

@@ -1,62 +1,15 @@
 /**
- * Workspace adapter — opens/lists/closes the host-side terminal session
+ * Workspace facade — opens/lists/closes the host-side terminal session
  * that runs an agent for one ticket. `Workspace.name` is the ticket id;
- * callers key on it. Adapters do their own internal lookup when their
- * backend uses opaque refs.
+ * callers key on it. The cmux and tmux backends live in their own files
+ * (`cmuxAdapter.ts`, `tmuxAdapter.ts`) behind the shared `Adapter`
+ * interface in `workspaceAdapter.ts`; this module resolves which one to
+ * use, caches it per config, and exposes the `workspaces` API.
  */
 import type { ResolvedConfig, WorkspaceKindSetting } from "./config.ts";
 import { type HostCapabilities } from "./host.ts";
-export type WorkspaceKind = "cmux" | "tmux";
-export interface Workspace {
-    /** Ticket id; the join key callers use. */
-    name: string;
-}
-export interface WorkspaceStatus {
-    text: string;
-    color?: string;
-    icon?: string;
-}
-export interface WorkspaceAccessHint {
-    kind: "attachCommand";
-    command: string;
-}
-export interface OpenSpec {
-    /** Ticket id; becomes the workspace's name. */
-    name: string;
-    /** Working directory the workspace runs in. */
-    cwd: string;
-    /** Shell string the workspace executes (host setup + agent exec). */
-    command: string;
-    /** Optional status painting. Adapters that can't paint silently drop it. */
-    status?: WorkspaceStatus;
-}
-/**
- * `unavailable` is "we don't know" — never treat it as "empty," or callers
- * would close every live workspace by deduction.
- */
-export type WorkspaceProbe = {
-    kind: "ok";
-    names: Set<string>;
-} | {
-    kind: "unavailable";
-    error?: unknown;
-};
-export type WorkspaceInterruptResult = {
-    kind: "interrupted";
-} | {
-    kind: "missing";
-} | {
-    kind: "unavailable";
-    error?: unknown;
-};
-export type WorkspaceCloseResult = {
-    kind: "closed";
-} | {
-    kind: "missing";
-} | {
-    kind: "unavailable";
-    error?: unknown;
-};
+import { type OpenSpec, type WorkspaceAccessHint, type WorkspaceCloseResult, type WorkspaceInterruptResult, type WorkspaceKind, type WorkspaceProbe } from "./workspaceAdapter.ts";
+export type { OpenSpec, Workspace, WorkspaceAccessHint, WorkspaceCloseResult, WorkspaceInterruptResult, WorkspaceKind, WorkspaceProbe, WorkspaceStatus, } from "./workspaceAdapter.ts";
 export interface WorkspaceResolution {
     requested: WorkspaceKindSetting;
     resolved: WorkspaceKind;
@@ -77,5 +30,4 @@ export declare const workspaces: {
     interrupt: typeof interruptWorkspace;
     accessHint(config: ResolvedConfig, name: string, signal?: AbortSignal): Promise<WorkspaceAccessHint | undefined>;
 };
-export {};
 //# sourceMappingURL=workspaces.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../src/lib/workspaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAI1E,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;AAwU7C,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;AAgOD,iBAAe,eAAe,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAezB;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;IACH,UAAU,SACN,cAAc,QAChB,MAAM,WACH,WAAW,GACnB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;CAI5C,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,CAezB;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;IACH,UAAU,SACN,cAAc,QAChB,MAAM,WACH,WAAW,GACnB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;CAI5C,CAAC"}

package/dist/lib/workspaces.js

@@ -1,263 +1,15 @@
 /**
- * Workspace adapter — opens/lists/closes the host-side terminal session
+ * Workspace facade — opens/lists/closes the host-side terminal session
  * that runs an agent for one ticket. `Workspace.name` is the ticket id;
- * callers key on it. Adapters do their own internal lookup when their
- * backend uses opaque refs.
+ * callers key on it. The cmux and tmux backends live in their own files
+ * (`cmuxAdapter.ts`, `tmuxAdapter.ts`) behind the shared `Adapter`
+ * interface in `workspaceAdapter.ts`; this module resolves which one to
+ * use, caches it per config, and exposes the `workspaces` API.
  */
-import { runCommandAsync } from "./commandRunner.js";
+import { cmuxAdapter } from "./cmuxAdapter.js";
 import { detectHostCapabilities } from "./host.js";
-import { shellSingleQuote } from "./shell.js";
-import { errorMessage, log, readEnvironmentVariable } from "./util.js";
-async function runWorkspaceCommand(command, arguments_, signal) {
-    return signal === undefined
-        ? await runCommandAsync(command, arguments_)
-        : await runCommandAsync(command, arguments_, { signal });
-}
-function isSignalAborted(signal) {
-    return signal?.aborted === true;
-}
-function parseCmuxList(output) {
-    // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- cmux --json list-workspaces always emits this shape
-    const parsed = JSON.parse(output);
-    const items = [];
-    /* v8 ignore next @preserve -- cmux always emits a workspaces field; default keeps the loop safe */
-    for (const ws of parsed.workspaces ?? []) {
-        if (typeof ws.title !== "string" || ws.title.length === 0) {
-            continue;
-        }
-        const id = pickCmuxId(ws);
-        if (id === undefined) {
-            log(`cmux list-workspaces returned workspace "${ws.title}" without a usable id or ref; skipping`);
-            continue;
-        }
-        items.push({ title: ws.title, id });
-    }
-    return items;
-}
-/**
- * The stable workspace handle cmux v2 expects in JSON-RPC params. Prefer
- * the UUID; fall back to the legacy `workspace:N` short ref when older
- * cmux builds don't surface it. Returns `undefined` when neither is
- * available — cmux v2 `workspace.close` rejects titles, so we must never
- * forward `title` as a workspace handle.
- */
-function pickCmuxId(ws) {
-    if (typeof ws.id === "string" && ws.id.length > 0) {
-        return ws.id;
-    }
-    if (typeof ws.ref === "string" && ws.ref.length > 0) {
-        return ws.ref;
-    }
-    return undefined;
-}
-async function listCmuxRaw(signal) {
-    try {
-        return parseCmuxList(await runWorkspaceCommand("cmux", ["--json", "list-workspaces"], signal));
-    }
-    catch (error) {
-        if (isSignalAborted(signal)) {
-            throw error;
-        }
-        log(`cmux list-workspaces failed: ${errorMessage(error)}`);
-        return undefined;
-    }
-}
-function extractCmuxOpenId(output) {
-    try {
-        // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- cmux --json prints a workspace_id/ref object
-        const parsed = JSON.parse(output);
-        const uuid = parsed.workspace_id ?? parsed.id ?? "";
-        if (uuid.length > 0) {
-            return uuid;
-        }
-        const ref = parsed.workspace_ref ?? parsed.ref ?? "";
-        if (ref.length > 0) {
-            return ref;
-        }
-    }
-    catch {
-        /* not JSON; fall through to regex */
-    }
-    const match = /workspace:\d+/.exec(output);
-    return match ? match[0] : undefined;
-}
-/**
- * Inspect `cmux current-workspace`. When groundcrew is itself launched
- * inside a cmux SSH workspace, `workspace.create` lands the new workspace
- * on the local (macOS) cmux app rather than the remote where the agent's
- * worktree lives. We can't replicate cmux's full SSH bootstrap
- * (relay_port, daemon, etc.) from the remote side, so we instead wrap the
- * agent launch command in a plain `ssh` to the same destination. Returns
- * `undefined` when there is nothing to inherit, leaving callers free to
- * launch locally as usual.
- */
-async function probeCurrentCmuxRemote(signal) {
-    if (readEnvironmentVariable("CMUX_WORKSPACE_ID") === undefined) {
-        return undefined;
-    }
-    let output;
-    try {
-        output = await runWorkspaceCommand("cmux", ["--json", "current-workspace"], signal);
-    }
-    catch (error) {
-        if (isSignalAborted(signal)) {
-            throw error;
-        }
-        // CMUX_WORKSPACE_ID is set, so we are inside a cmux workspace and a
-        // probe failure means we cannot tell whether this is an SSH context.
-        // Silently degrading to the local path would point cmux at a working
-        // directory that lives on a remote host; surface the failure instead
-        // so the caller can roll the worktree back rather than launch into
-        // the void.
-        throw new Error(`cmux current-workspace probe failed while CMUX_WORKSPACE_ID is set: ${errorMessage(error)}`, { cause: error });
-    }
-    try {
-        // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- cmux --json current-workspace shape per v2 API
-        const parsed = JSON.parse(output);
-        const remote = parsed.workspace?.remote;
-        if (remote === undefined ||
-            remote.connected !== true ||
-            remote.transport !== "ssh" ||
-            typeof remote.destination !== "string" ||
-            remote.destination.length === 0) {
-            return undefined;
-        }
-        const inherited = { destination: remote.destination };
-        if (typeof remote.port === "number") {
-            inherited.port = remote.port;
-        }
-        if (typeof remote.identity_file === "string" && remote.identity_file.length > 0) {
-            inherited.identity_file = remote.identity_file;
-        }
-        if (Array.isArray(remote.ssh_options) && remote.ssh_options.length > 0) {
-            inherited.ssh_options = remote.ssh_options;
-        }
-        return inherited;
-    }
-    catch (error) {
-        // Same reasoning as the command-failure branch above: with
-        // CMUX_WORKSPACE_ID set, malformed JSON means we cannot decide
-        // between local and SSH context, so refuse rather than silently
-        // launching at the wrong working directory.
-        throw new Error(`cmux current-workspace returned malformed output while CMUX_WORKSPACE_ID is set: ${errorMessage(error)}`, { cause: error });
-    }
-}
-/**
- * Compose an `ssh -t <destination> -- <cd && cmd>` invocation that lands
- * a new cmux workspace's terminal on the same SSH remote where
- * groundcrew is running. Path-bearing fields (`cwd`, the launch script
- * inside `command`) stay valid because the remote shell evaluates them.
- * The outermost return value is a single shell string suitable for
- * `cmux new-workspace --command`.
- */
-function buildSshWrappedCommand(spec, remote) {
-    const remoteShell = `cd ${shellSingleQuote(spec.cwd)} && ${spec.command}`;
-    const sshTokens = ["ssh", "-t"];
-    if (remote.port !== undefined) {
-        sshTokens.push("-p", String(remote.port));
-    }
-    if (remote.identity_file !== undefined) {
-        sshTokens.push("-i", shellSingleQuote(remote.identity_file));
-    }
-    for (const option of remote.ssh_options ?? []) {
-        sshTokens.push("-o", shellSingleQuote(option));
-    }
-    sshTokens.push(shellSingleQuote(remote.destination), "--", shellSingleQuote(remoteShell));
-    return sshTokens.join(" ");
-}
-async function applyCmuxStatus(workspaceId, status, signal) {
-    const arguments_ = ["set-status", "model", status.text];
-    if (status.icon !== undefined) {
-        arguments_.push("--icon", status.icon);
-    }
-    if (status.color !== undefined) {
-        arguments_.push("--color", status.color);
-    }
-    arguments_.push("--workspace", workspaceId);
-    await runWorkspaceCommand("cmux", arguments_, signal);
-}
-async function closeCmuxWorkspace(workspaceId, signal) {
-    await runWorkspaceCommand("cmux", ["close-workspace", "--workspace", workspaceId], signal);
-}
-function isCmuxSetStatusUnsupported(error) {
-    return errorMessage(error).includes('unknown command "set-status"');
-}
-const cmuxAdapter = {
-    async open(spec, signal) {
-        const inheritedRemote = await probeCurrentCmuxRemote(signal);
-        const newWorkspaceArguments = ["--json", "new-workspace", "--name", spec.name];
-        if (inheritedRemote === undefined) {
-            newWorkspaceArguments.push("--cwd", spec.cwd, "--command", spec.command);
-        }
-        else {
-            // Skip --cwd: the path is on the SSH remote and would fall back to
-            // $HOME (macOS) when cmux tries to chdir locally. The wrapped ssh
-            // command does its own `cd` on the remote side.
-            newWorkspaceArguments.push("--command", buildSshWrappedCommand(spec, inheritedRemote));
-        }
-        const output = await runWorkspaceCommand("cmux", newWorkspaceArguments, signal);
-        const workspaceId = extractCmuxOpenId(output);
-        if (workspaceId === undefined) {
-            log(`cmux new-workspace returned unrecognized output for ${spec.name}; if a workspace was created, run \`cmux close-workspace\` manually.`);
-            throw new Error(`Unexpected cmux output: ${output}`);
-        }
-        if (spec.status !== undefined) {
-            try {
-                await applyCmuxStatus(workspaceId, spec.status, signal);
-            }
-            catch (error) {
-                // Status pills are best-effort. cmux v2+ dropped `set-status` entirely,
-                // so swallow that specific gap silently; surface anything else so a real
-                // regression doesn't hide behind the same swallow.
-                if (!isCmuxSetStatusUnsupported(error)) {
-                    log(`cmux set-status failed for ${spec.name} (continuing): ${errorMessage(error)}`);
-                }
-            }
-        }
-    },
-    async list(signal) {
-        const raw = await listCmuxRaw(signal);
-        return raw?.map((ws) => ({ name: ws.title }));
-    },
-    async close(name, signal) {
-        const raw = await listCmuxRaw(signal);
-        if (raw === undefined) {
-            // cmux v2 `workspace.close` rejects titles, so forwarding `name`
-            // would always fail. The list failure has already been logged by
-            // `listCmuxRaw`; bail rather than guarantee a downstream error.
-            log(`cmux close-workspace skipped for ${name}: list-workspaces failed, no usable id`);
-            return { kind: "unavailable" };
-        }
-        const match = raw.find((ws) => ws.title === name);
-        if (match === undefined) {
-            return { kind: "missing" };
-        }
-        try {
-            await closeCmuxWorkspace(match.id, signal);
-            return { kind: "closed" };
-        }
-        catch (error) {
-            if (isSignalAborted(signal)) {
-                throw error;
-            }
-            const remaining = await listCmuxRaw(signal);
-            if (remaining === undefined) {
-                return { kind: "unavailable", error };
-            }
-            const isStillPresent = remaining.some((ws) => ws.title === name);
-            if (!isStillPresent) {
-                return { kind: "closed" };
-            }
-            throw error;
-        }
-    },
-    accessHint(_name) {
-        // cmux is a TUI; users surface workspaces by launching the cmux app,
-        // not a shell command. No useful hint to emit.
-        // oxlint-disable-next-line unicorn/no-useless-undefined -- explicit signal that the backend has no hint
-        return undefined;
-    },
-};
+import { tmuxAdapter } from "./tmuxAdapter.js";
+import { isSignalAborted, } from "./workspaceAdapter.js";
 export function resolveWorkspaceKind(arguments_) {
     const { config, host } = arguments_;
     const requested = config.workspaceKind;
@@ -290,154 +42,6 @@ function failIfBinaryUnavailable(kind, host) {
         throw new Error(`workspaceKind '${kind}' is set but the ${kind} binary is not on PATH. Install ${kind} or change the setting.`);
     }
 }
-const TMUX_SESSION = "groundcrew";
-// `tmux new-session -d -s …` always creates one initial window. Without
-// `-n`, that window is named after the running shell (e.g. "0" / "zsh") and
-// would surface from `list()` as a phantom workspace. We name it with this
-// sentinel and filter it out — it stays around as a placeholder so the
-// session doesn't collapse when the last ticket window closes.
-const TMUX_IDLE_WINDOW = "_groundcrew_idle";
-function tmuxTarget(name) {
-    return `${TMUX_SESSION}:${name}`;
-}
-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
-    // without a separate stderr probe.
-    const message = errorMessage(error);
-    return (message.includes("no server running") ||
-        message.includes("can't find session") ||
-        message.includes("can't find window"));
-}
-async function probeTmuxList(format, signal) {
-    try {
-        return {
-            status: "ok",
-            output: await runWorkspaceCommand("tmux", ["list-windows", "-t", TMUX_SESSION, "-F", format], signal),
-        };
-    }
-    catch (error) {
-        if (isSignalAborted(signal)) {
-            throw error;
-        }
-        if (isTmuxNotFoundError(error)) {
-            return { status: "missing" };
-        }
-        return { status: "failed", reason: errorMessage(error) };
-    }
-}
-async function ensureTmuxSession(signal) {
-    try {
-        await runWorkspaceCommand("tmux", ["has-session", "-t", TMUX_SESSION], signal);
-        return;
-    }
-    catch (error) {
-        if (isSignalAborted(signal)) {
-            throw error;
-        }
-        /* session missing or server down; create it */
-    }
-    try {
-        await runWorkspaceCommand("tmux", ["new-session", "-d", "-s", TMUX_SESSION, "-n", TMUX_IDLE_WINDOW], signal);
-    }
-    catch (error) {
-        if (isSignalAborted(signal)) {
-            throw error;
-        }
-        try {
-            await runWorkspaceCommand("tmux", ["has-session", "-t", TMUX_SESSION], signal);
-        }
-        catch {
-            throw error;
-        }
-    }
-}
-function parseTmuxWindows(output) {
-    const items = [];
-    for (const line of output.split("\n")) {
-        if (line.length === 0) {
-            continue;
-        }
-        const [name, deadFlag] = line.split("\t");
-        /* v8 ignore next 3 @preserve -- split on a non-empty string always yields a non-empty first element */
-        if (name === undefined || name.length === 0) {
-            continue;
-        }
-        if (name === TMUX_IDLE_WINDOW) {
-            continue;
-        }
-        // 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") {
-            continue;
-        }
-        items.push({ name });
-    }
-    return items;
-}
-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;
-        await runWorkspaceCommand("tmux", [
-            "new-window",
-            "-d",
-            "-t",
-            TMUX_SESSION,
-            "-n",
-            spec.name,
-            "-c",
-            spec.cwd,
-            spec.command,
-            ";",
-            "set-window-option",
-            "-t",
-            target,
-            "remain-on-exit",
-            keepDeadWindows ? "on" : "off",
-            ";",
-            "set-window-option",
-            "-t",
-            target,
-            "allow-rename",
-            "off",
-        ], signal);
-        // tmux can't paint status pills; spec.status is silently dropped.
-    },
-    async list(signal) {
-        const probe = await probeTmuxList("#{window_name}\t#{pane_dead}", signal);
-        if (probe.status === "missing") {
-            return [];
-        }
-        if (probe.status === "failed") {
-            log(`tmux list-windows failed: ${probe.reason}`);
-            // oxlint-disable-next-line unicorn/no-useless-undefined -- undefined marks the workspace backend as unavailable.
-            return undefined;
-        }
-        return parseTmuxWindows(probe.output);
-    },
-    async close(name, signal) {
-        try {
-            await runWorkspaceCommand("tmux", ["kill-window", "-t", tmuxTarget(name)], signal);
-            return { kind: "closed" };
-        }
-        catch (error) {
-            if (isSignalAborted(signal)) {
-                throw error;
-            }
-            if (isTmuxNotFoundError(error)) {
-                return { kind: "missing" };
-            }
-            throw error;
-        }
-    },
-    accessHint(name) {
-        return { kind: "attachCommand", command: `tmux attach -t ${tmuxTarget(name)}` };
-    },
-};
 // Per-config cache: production resolves the adapter once at first use
 // (loadConfig returns a frozen, cached instance); each test uses a fresh
 // config object so the cache invalidates naturally between tests.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.0.2",
+  "version": "4.1.0",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",
@@ -68,7 +68,6 @@
   },
   "dependencies": {
     "@clipboard-health/clearance": "1.0.8",
-    "@inquirer/checkbox": "5.1.5",
     "@linear/sdk": "86.0.0",
     "cosmiconfig": "9.0.1",
     "tslib": "2.8.1",

package/dist/commands/sandbox/auth.d.ts

@@ -1,3 +0,0 @@
-import type { ResolvedConfig } from "../../lib/config.ts";
-export declare function runAuth(config: ResolvedConfig, argv: string[]): Promise<void>;
-//# sourceMappingURL=auth.d.ts.map

package/dist/commands/sandbox/auth.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/commands/sandbox/auth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAuNtE,wBAAsB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAcnF"}