@clipboard-health/groundcrew 4.0.3 → 4.2.0

package/README.md

@@ -63,7 +63,9 @@ npm install -g @clipboard-health/groundcrew
 crew init && $EDITOR crew.config.ts
 
 # 4. Clone the repos referenced in your config
-crew setup repos
+PROJECT_DIR="$HOME/dev/c"
+mkdir -p "$PROJECT_DIR/OWNER"
+git clone git@github.com:OWNER/REPO.git "$PROJECT_DIR/OWNER/REPO"
 
 # 5. Export your Linear API key
 export GROUNDCREW_LINEAR_API_KEY="lin_api_..."
@@ -86,14 +88,35 @@ crew status [<TICKET>]                                   # inspect current state
 crew run                                                 # one-shot orchestration
 crew run --watch                                         # poll forever
 crew start <TICKET>                                      # provision + launch one ticket now
-crew setup repos [<repo>...] [--dry-run]                 # clone known repos via gh
 crew stop <TICKET> [--reason <text>]                     # stop workspace, keep worktree
 crew resume <TICKET>                                     # reopen a paused ticket
 crew cleanup <TICKET>                                    # tear down every worktree for a ticket
+crew upgrade [<version>]                                 # reinstall crew globally through npm
 ```
 
 Deprecated aliases still work but print a warning and will be removed in the next major version: `crew interrupt` → `crew stop`, `crew run --ticket <TICKET>` → `crew start <TICKET>`, `crew doctor --ticket <TICKET>` → `crew status <TICKET>`.
 
+## Manual Repository Bootstrap
+
+Groundcrew no longer clones repositories for you. For each `workspace.knownRepositories` entry,
+clone the repository into `workspace.projectDir` using the same relative path that appears in the
+config. For an `OWNER/REPO` entry:
+
+```bash
+PROJECT_DIR="$HOME/dev/c"
+mkdir -p "$PROJECT_DIR/OWNER"
+git clone git@github.com:OWNER/REPO.git "$PROJECT_DIR/OWNER/REPO"
+```
+
+HTTPS works the same way if you do not use SSH:
+
+```bash
+git clone https://github.com/OWNER/REPO.git "$PROJECT_DIR/OWNER/REPO"
+```
+
+Bare-name entries do not include an owner, so choose the correct remote URL yourself and clone it to
+`$PROJECT_DIR/<name>`. `crew setup repos` now exits non-zero and points back to this section.
+
 ## Configuration
 
 Two keys are required; everything else has a default.
@@ -143,7 +166,7 @@ Resolution order: `GROUNDCREW_CONFIG` → cosmiconfig project-walk from cwd (any
 | `models.definitions.<name>.cmd`         | —                   | Shell command launched for the model. Runs in the worktree through the resolved `local.runner`. `{{worktree}}` is replaced before launch; `{{sandbox}}` expands to the sbx sandbox name under the sdx runner and an empty string otherwise.                                                                                                                             |
 | `models.definitions.<name>.color`       | —                   | Color for the workspace status pill (cmux only; tmux silently drops it).                                                                                                                                                                                                                                                                                                |
 | `models.definitions.<name>.usage`       | optional            | If set, codexbar usage is fetched for this model and gated by `sessionLimitPercentage`. Falls back to default when unset, with gating enabled for known models. When `usage.codexbar.source` is omitted, groundcrew uses `oauth` for Codex/Claude on macOS, `auto` for other macOS providers, and `cli` elsewhere. Set to `{ disabled: true }` to disable usage gating. |
-| `models.definitions.<name>.sandbox`     | optional            | Docker Sandboxes binding for the model. Required at launch when `local.runner` resolves to `sdx`. Fields: `agent` (required sbx agent name), `template`, `kits`, `setupCommand` (override for the inside-sandbox setup script).                                                                                                                                         |
+| `models.definitions.<name>.sandbox`     | optional            | Docker Sandboxes binding for the model. Required at launch when `local.runner` resolves to `sdx`. Fields: `agent` (required sbx agent name) and `setupCommand` (override for the inside-sandbox setup script). Groundcrew assumes the `groundcrew-<agent>` sandbox already exists.                                                                                      |
 | `models.definitions.<name>.disabled`    | optional            | When set to exactly `true`, drops the named shipped default (`claude` or `codex`). Doctor skips probing it; `agent-<name>` labels fall back to `models.default` with a warning.                                                                                                                                                                                         |
 | `prompts.initial`                       | unattended template | First message sent to the agent. Placeholders: `{{ticket}}`, `{{worktree}}`, `{{title}}`, `{{description}}`. Override this from `crew.config.ts` for team-specific statuses, tools, plugins, or review loops.                                                                                                                                                           |
 | `workspaceKind`                         | `"auto"`            | Terminal session manager. `"auto"` picks `cmux` when on PATH, else `tmux`. Set to `"cmux"` or `"tmux"` to fail loudly when the chosen backend is missing.                                                                                                                                                                                                               |
@@ -188,9 +211,17 @@ Watch `${XDG_CACHE_HOME:-$HOME/.cache}/clearance/clearance.log` for `DENY` lines
 <details>
 <summary>Docker Sandboxes (sdx) setup</summary>
 
-Each model that runs under `sdx` needs a `sandbox: { agent: "<sbx-agent>" }` block in `crew.config.ts`. Groundcrew names sandboxes `groundcrew-<agent>` (e.g. `groundcrew-claude`) and reuses one sandbox per agent across repos and tickets. First-time agent auth happens inside the sandbox the first time it launches. To bootstrap manually instead, run `sbx create --name groundcrew-<agent> <agent> <projectDir>` once.
+Each model that runs under `sdx` needs a `sandbox: { agent: "<sbx-agent>" }` block in `crew.config.ts`. Groundcrew addresses the sandbox as `groundcrew-<agent>` (e.g. `groundcrew-claude`) and reuses one existing sandbox per agent across repos and tickets.
 
-Groundcrew auto-creates sandboxes when missing but never deletes them — they persist across tickets and `crew cleanup`. Auth state lives inside the sandbox, so deleting it forces a re-login. Manage with `sbx ls` / `sbx rm`.
+First-time setup is manual:
+
+```bash
+sbx create --name groundcrew-claude claude <projectDir>
+sbx exec -it groundcrew-claude claude auth login
+sbx exec -it groundcrew-claude gh auth login
+```
+
+Replace `claude` with the sbx agent for the model and `<projectDir>` with `workspace.projectDir` from `crew.config.ts`. Manage lifecycle and auth with `sbx` directly (`sbx ls`, `sbx exec`, `sbx rm`). Groundcrew does not create, authenticate, regenerate, list, or remove sandboxes.
 
 </details>
 
@@ -238,7 +269,7 @@ In Progress (state.type=started) — Multi-event extractor: year inference can p
 
 ### `crew start <TICKET>`
 
-Provisions and launches one ticket immediately, bypassing orchestrator eligibility. Use it to dispatch a specific ticket on demand — including unlabeled tickets that `crew run` ignores. (Replaces the deprecated `crew run --ticket <TICKET>`.)
+Launches one ticket immediately, bypassing orchestrator eligibility. Use it to dispatch a specific ticket on demand — including unlabeled tickets that `crew run` ignores. (Replaces the deprecated `crew run --ticket <TICKET>`.)
 
 ```bash
 crew start HRD-442
@@ -500,13 +531,6 @@ The handoff is `<your cmd> "<prompt>"`. `claude`, `codex`, and `cursor-agent` al
 
 </details>
 
-<details>
-<summary><code>crew setup repos</code> only auto-clones <code>owner/repo</code> entries</summary>
-
-Bare-name entries in `workspace.knownRepositories` (e.g. `"api"` rather than `"clipboardhealth/api"`) are skipped with a hint to clone manually — the command refuses to guess the owner. After a partial setup, the exit code is non-zero so CI gates notice; rerun is idempotent once you clone the bare ones into `<projectDir>/<name>` yourself.
-
-</details>
-
 ## Development
 
 Clone the repo and the `crew` / `crew:op` scripts execute straight from TypeScript source — no build step needed.

package/crew.config.example.ts

@@ -73,24 +73,11 @@ export default {
   // // macOS when you need an agent to use Docker safely.
   // local: { runner: "auto" },
   //
-  // // Additional auth recipes for `crew sandbox auth <model> <tool>`. The
-  // // shipped recipes (claude/codex/cursor agents + github tool) are merged
-  // // with whatever you declare here; your recipe wins on key collision.
-  // // Describe each tool's in-sandbox login + status commands and a regex
-  // // that matches its logged-in output. Omit `kind` for cross-cutting
-  // // tools that should appear in every sandbox's picker; set
-  // // `kind: "agent"` to scope a recipe to a single sbx agent.
-  // sandbox: {
-  //   authRecipes: {
-  //     gcloud: {
-  //       displayName: "gcloud",
-  //       binary: "gcloud",
-  //       loginArgs: ["auth", "login", "--no-launch-browser"],
-  //       statusArgs: ["auth", "list", "--filter=status:ACTIVE", "--format=value(account)"],
-  //       authenticatedPattern: /@/,
-  //     },
-  //   },
-  // },
+  // // Groundcrew does not create or authenticate sdx sandboxes. For an sdx
+  // // model, create the matching sandbox yourself before first launch:
+  // //   sbx create --name groundcrew-claude claude ~/dev/groundcrew
+  // //   sbx exec -it groundcrew-claude claude auth login
+  // //   sbx exec -it groundcrew-claude gh auth login
   //
   // prompts: {
   //   // Keep personal workflow instructions next to this config, for example

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAwQA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCvD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAmPA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCvD"}

package/dist/cli.js

@@ -5,16 +5,21 @@ import { initConfigCli } from "./commands/init.js";
 import { interruptWorkspaceCli } from "./commands/interruptWorkspace.js";
 import { orchestrate } from "./commands/orchestrator.js";
 import { resumeWorkspaceCli } from "./commands/resumeWorkspace.js";
-import { sandboxCli } from "./commands/sandbox/index.js";
-import { setupReposCli } from "./commands/setupRepos.js";
 import { setupWorkspaceCli } from "./commands/setupWorkspace.js";
 import { statusCli } from "./commands/status.js";
 import { createDefaultUpgradeCliOptions, upgradeCli } from "./commands/upgrade.js";
-import { computeUpgradeNudge, defaultUpgradeCheckCachePath, fetchLatestVersion, } from "./lib/upgrade.js";
-import { errorMessage, parseDryRunPositionals, readEnvironmentVariable, readTicketArgument, writeError, writeOutput, } from "./lib/util.js";
-const NUDGE_TTL_MS = 6 * 60 * 60 * 1000;
-const NUDGE_FETCH_TIMEOUT_MS = 1000;
+import { errorMessage, parseDryRunPositionals, readTicketArgument, writeError, writeOutput, } from "./lib/util.js";
+const REMOVED_SANDBOX_COMMAND_MESSAGE = [
+    "`crew sandbox` is no longer supported.",
+    "Groundcrew now launches agents inside existing sbx sandboxes but does not list, create, regenerate, authenticate, or remove them.",
+    "Use the manual `sbx` workflow in README.md#docker-sandboxes-sdx-setup, then keep `models.definitions.<model>.sandbox.agent` in crew.config.ts so launches can address the existing sandbox.",
+].join("\n");
 const requireFromCli = createRequire(import.meta.url);
+const SETUP_REPOS_REMOVED_MESSAGE = [
+    "crew setup repos was removed.",
+    "Clone repositories manually with git clone into workspace.projectDir.",
+    "See README.md#manual-repository-bootstrap for the replacement workflow.",
+].join(" ");
 /**
  * Prints a deprecation warning to stderr naming the canonical command and that
  * the old form is removed in the next major, then lets the caller proceed.
@@ -23,13 +28,12 @@ function warnDeprecated(forms) {
     writeError(`crew ${forms.oldForm} is deprecated and will be removed in the next major version; use crew ${forms.newForm} instead.`);
 }
 function setupUsage() {
-    return "Usage: crew setup repos [--dry-run] [<repo>...]";
+    return `Usage: crew setup repos\n\n${SETUP_REPOS_REMOVED_MESSAGE}`;
 }
 async function setupCli(argv) {
-    const [verb, ...rest] = argv;
+    const [verb] = argv;
     if (verb === "repos") {
-        await setupReposCli(rest);
-        return;
+        throw new Error(SETUP_REPOS_REMOVED_MESSAGE);
     }
     throw new Error(setupUsage());
 }
@@ -76,27 +80,10 @@ async function startCli(argv) {
 async function upgradeCliInvoke(argv) {
     const metadata = packageMetadata();
     await upgradeCli(argv, async () => await createDefaultUpgradeCliOptions({
-        currentVersion: metadata.version,
         packageName: metadata.name,
         cliMetaUrl: import.meta.url,
     }));
 }
-async function maybeRunUpgradeNudge(metadata) {
-    const message = await computeUpgradeNudge({
-        currentVersion: metadata.version,
-        packageName: metadata.name,
-        cachePath: defaultUpgradeCheckCachePath(),
-        ttlMs: NUDGE_TTL_MS,
-        fetchTimeoutMs: NUDGE_FETCH_TIMEOUT_MS,
-        registry: readEnvironmentVariable("npm_config_registry"),
-        noUpgradeCheck: readEnvironmentVariable("GROUNDCREW_NO_UPGRADE_CHECK") === "1",
-        now: Date.now,
-        fetcher: fetchLatestVersion,
-    });
-    if (message !== undefined) {
-        writeError(message);
-    }
-}
 function doctorTicketAlias(argv) {
     if (argv[0] !== "--ticket") {
         return undefined;
@@ -132,7 +119,7 @@ const SUBCOMMANDS = {
         invoke: runCli,
     },
     start: {
-        summary: "Provision and launch one ticket immediately, bypassing eligibility",
+        summary: "Launch one ticket immediately, bypassing eligibility",
         usage: "<ticket> [--dry-run]",
         invoke: startCli,
     },
@@ -170,34 +157,28 @@ const SUBCOMMANDS = {
         usage: "<ticket>",
         invoke: resumeWorkspaceCli,
     },
-    sandbox: {
-        summary: "Manage Docker Sandboxes (sbx) for configured models",
-        usage: "<list|ensure|regenerate|auth|rm> [...args]",
-        invoke: sandboxCli,
-    },
     setup: {
-        summary: "Project-level setup commands (currently: repos)",
-        usage: "repos [--dry-run] [<repo>...]",
+        summary: "Removed repository bootstrap command",
+        usage: "repos",
+        hidden: true,
         invoke: setupCli,
     },
     upgrade: {
         summary: "Install the latest version of crew (or pin to a specific version)",
-        usage: "[<version>] [--check]",
+        usage: "[<version>]",
         invoke: upgradeCliInvoke,
     },
 };
 function printHelp() {
-    const width = Math.max(...Object.keys(SUBCOMMANDS).map((key) => key.length));
+    const visibleCommands = Object.entries(SUBCOMMANDS).filter(([, command]) => command.hidden !== true && command.deprecated !== true);
+    const width = Math.max(...visibleCommands.map(([key]) => key.length));
     writeOutput("Usage: crew <command> [...args]\n");
     writeOutput("Options:");
     writeOutput("  -h, --help     Show help");
     writeOutput("  -v, --version  Print version");
     writeOutput("");
     writeOutput("Commands:");
-    for (const [name, command] of Object.entries(SUBCOMMANDS)) {
-        if (command.deprecated === true) {
-            continue;
-        }
+    for (const [name, command] of visibleCommands) {
         writeOutput(`  ${name.padEnd(width)}  ${command.summary}`);
         writeOutput(`  ${" ".repeat(width)}  → crew ${name} ${command.usage}`);
     }
@@ -224,6 +205,11 @@ export async function run(argv) {
         writeOutput(packageVersion());
         return;
     }
+    if (subcommand === "sandbox") {
+        writeError(REMOVED_SANDBOX_COMMAND_MESSAGE);
+        process.exitCode = 1;
+        return;
+    }
     const command = SUBCOMMANDS[subcommand];
     if (!command) {
         writeError(`Unknown command: ${subcommand}\n`);
@@ -231,14 +217,6 @@ export async function run(argv) {
         process.exitCode = 1;
         return;
     }
-    if (subcommand !== "upgrade") {
-        try {
-            await maybeRunUpgradeNudge(packageMetadata());
-        }
-        catch {
-            // Passive nudge is never load-bearing; never block the user's command.
-        }
-    }
     try {
         await command.invoke(rest);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"resumeWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/resumeWorkspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAcnE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AA6HD,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Df;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}
+{"version":3,"file":"resumeWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/resumeWorkspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAcnE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AA6HD,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}

package/dist/commands/resumeWorkspace.js

@@ -1,6 +1,6 @@
 import { fetchResolvedIssue } from "../lib/boardSource.js";
 import { loadConfig } from "../lib/config.js";
-import { ensureAgentSandbox, openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
+import { openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
 import { buildLaunchCommand } from "../lib/launchCommand.js";
 import { readRunState, recordRunState } from "../lib/runState.js";
 import { removeStagedPrompt, stageBuildSecrets, stagePromptText, stageWorkspaceLaunchCommand, } from "../lib/stagedLaunch.js";
@@ -117,7 +117,6 @@ export async function resumeWorkspace(config, options) {
         text: renderResumePrompt(context),
     });
     const secretsFile = stageBuildSecrets(stagedPrompt.directory);
-    await ensureAgentSandbox({ config, definition, sandboxName });
     const launchCommand = buildLaunchCommand({
         definition,
         promptFile: stagedPrompt.file,

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

@@ -1 +1 @@
-{"version":3,"file":"setupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/setupWorkspace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAenE,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAWD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAqBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,qBAAqB,EAC9B,UAAU,GAAE,wBAA6B,GACxC,OAAO,CAAC,IAAI,CAAC,CA6Gf;AAwHD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CAoBf"}
+{"version":3,"file":"setupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/setupWorkspace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAenE,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAWD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAqBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,qBAAqB,EAC9B,UAAU,GAAE,wBAA6B,GACxC,OAAO,CAAC,IAAI,CAAC,CAsGf;AAwHD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/commands/setupWorkspace.js

@@ -1,7 +1,7 @@
 import { rmSync } from "node:fs";
 import { fetchResolvedIssue } from "../lib/boardSource.js";
 import { loadConfig } from "../lib/config.js";
-import { ensureAgentSandbox, openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
+import { openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
 import { buildLaunchCommand } from "../lib/launchCommand.js";
 import { createLinearIssueStatusUpdater } from "../lib/linearIssueStatus.js";
 import { recordRunState } from "../lib/runState.js";
@@ -80,12 +80,6 @@ export async function setupWorkspace(config, options, runOptions = {}) {
         const stagedPrompt = stagePrompt({ config, ticket, ticketDetails, worktreeName });
         promptDir = stagedPrompt.directory;
         const secretsFile = stageBuildSecrets(promptDir);
-        await ensureAgentSandbox({
-            config,
-            definition,
-            sandboxName,
-            ...(signal === undefined ? {} : { signal }),
-        });
         const launchCommand = buildLaunchCommand({
             definition,
             promptFile: stagedPrompt.file,

package/dist/commands/upgrade.d.ts

@@ -1,22 +1,12 @@
 import { type InstallKind, type NpmRunResult } from "../lib/npmGlobal.ts";
-import { type VersionFetcher } from "../lib/upgrade.ts";
 export interface UpgradeCliOptions {
-    currentVersion: string;
     packageName: string;
     resolveInstall: () => Promise<UpgradeInstallDetails>;
-    fetcher: VersionFetcher;
     runInstall: (options: {
         packageName: string;
         version: string;
         npmBin: string;
     }) => Promise<NpmRunResult>;
-    registry?: string | undefined;
-    fetchTimeoutMs: number;
-    /** Path of the upgrade-availability cache that the nudge reads. We prime
-     * it from `--check` and the default install path so the next non-upgrade
-     * subcommand can render the nudge without paying the network cost. */
-    cachePath: string;
-    now: () => number;
 }
 export interface UpgradeInstallDetails {
     installKind: InstallKind;
@@ -26,7 +16,6 @@ export interface UpgradeInstallDetails {
 export type UpgradeCliOptionsInput = UpgradeCliOptions | (() => Promise<UpgradeCliOptions>);
 export declare function upgradeCli(argv: string[], optionsInput: UpgradeCliOptionsInput): Promise<void>;
 export interface CreateUpgradeOptionsArgs {
-    currentVersion: string;
     packageName: string;
     cliMetaUrl: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,YAAY,EAElB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACrD,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,CAAC,OAAO,EAAE;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB;;0EAEsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAQD,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,GAAG,CAAC,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;AA0D5F,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EAAE,EACd,YAAY,EAAE,sBAAsB,GACnC,OAAO,CAAC,IAAI,CAAC,CAyCf;AAyFD,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CA2B5B"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,YAAY,EAElB,MAAM,qBAAqB,CAAC;AAK7B,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACrD,UAAU,EAAE,CAAC,OAAO,EAAE;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAOD,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,GAAG,CAAC,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAiD5F,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EAAE,EACd,YAAY,EAAE,sBAAsB,GACnC,OAAO,CAAC,IAAI,CAAC,CAkBf;AAsCD,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAqB5B"}

package/dist/commands/upgrade.js

@@ -1,46 +1,36 @@
 import { runCommand } from "../lib/commandRunner.js";
 import { which } from "../lib/host.js";
 import { classifyInstall, createDefaultNpmSpawner, detectInstallPath, detectIsSymlink, detectNpmRootGlobal, runNpmInstallGlobal, } from "../lib/npmGlobal.js";
-import { compareVersions, defaultUpgradeCheckCachePath, fetchAndPrimeUpgradeCheckCache, fetchLatestVersion, parseVersion, } from "../lib/upgrade.js";
-import { errorMessage, readEnvironmentVariable, writeError, writeOutput } from "../lib/util.js";
-const EXPLICIT_FETCH_TIMEOUT_MS = 5000;
+import { writeError, writeOutput } from "../lib/util.js";
+const DEFAULT_UPGRADE_TARGET = "latest";
 function parseArgs(argv) {
-    let check = false;
-    let pinnedVersion;
+    let version;
     for (const arg of argv) {
         if (arg === "--help" || arg === "-h") {
             return { kind: "help" };
         }
-        if (arg === "--check") {
-            check = true;
-            continue;
-        }
         if (arg.startsWith("-")) {
             return { kind: "error", message: `crew upgrade: unknown argument: ${arg}` };
         }
-        if (pinnedVersion !== undefined) {
+        if (arg.length === 0) {
+            return { kind: "error", message: "crew upgrade: version cannot be empty" };
+        }
+        if (version !== undefined) {
             return { kind: "error", message: "crew upgrade: too many positional arguments" };
         }
-        pinnedVersion = arg;
-    }
-    if (check && pinnedVersion !== undefined) {
-        return { kind: "error", message: "crew upgrade: --check does not accept a version argument" };
-    }
-    if (check) {
-        return { kind: "check" };
+        version = arg;
     }
-    return { kind: "install", pinnedVersion };
+    return { kind: "install", version: version ?? DEFAULT_UPGRADE_TARGET };
 }
 function printHelp() {
-    writeOutput("Usage: crew upgrade [<version>] [--check]");
+    writeOutput("Usage: crew upgrade [<version>]");
     writeOutput("");
-    writeOutput("Install the latest version of crew.");
+    writeOutput("Install crew globally through npm.");
     writeOutput("");
     writeOutput("Arguments:");
-    writeOutput("  <version>      Install an exact version (upgrade or downgrade)");
+    writeOutput("  <version>      Install an exact version or npm tag (default: latest)");
     writeOutput("");
     writeOutput("Options:");
-    writeOutput("  --check        Report availability without installing");
     writeOutput("  -h, --help     Show this help");
 }
 function refusalMessage(kind, installPath, packageName) {
@@ -64,34 +54,11 @@ export async function upgradeCli(argv, optionsInput) {
         return;
     }
     const options = await resolveOptions(optionsInput);
-    if (parsed.kind === "check") {
-        await runCheck(options);
-        return;
-    }
-    let targetVersion;
-    if (parsed.pinnedVersion === undefined) {
-        const fetched = await fetchOrFail(options);
-        if (fetched === undefined) {
-            return;
-        }
-        if (compareVersions(options.currentVersion, fetched) >= 0) {
-            writeOutput(`crew is up to date (${fetched})`);
-            return;
-        }
-        targetVersion = fetched;
-    }
-    else {
-        const resolved = resolvePinnedVersion(options, parsed.pinnedVersion);
-        if (resolved === undefined) {
-            return;
-        }
-        targetVersion = resolved;
-    }
     const npmBin = await resolveGlobalNpmBin(options);
     if (npmBin === undefined) {
         return;
     }
-    await runInstallAndReport(options, npmBin, targetVersion);
+    await runInstallAndReport(options, npmBin, parsed.version);
 }
 async function resolveGlobalNpmBin(options) {
     const install = await options.resolveInstall();
@@ -107,53 +74,6 @@ async function resolveGlobalNpmBin(options) {
     }
     return install.npmBin;
 }
-async function runCheck(options) {
-    const latest = await fetchOrFail(options);
-    if (latest === undefined) {
-        return;
-    }
-    if (compareVersions(options.currentVersion, latest) >= 0) {
-        writeOutput(`crew is up to date (${latest})`);
-        return;
-    }
-    writeOutput(`${latest} available (you are on ${options.currentVersion}); run \`crew upgrade\``);
-}
-async function fetchOrFail(options) {
-    try {
-        return await fetchAndPrimeUpgradeCheckCache({
-            packageName: options.packageName,
-            cachePath: options.cachePath,
-            fetchTimeoutMs: options.fetchTimeoutMs,
-            registry: options.registry,
-            now: options.now,
-            fetcher: options.fetcher,
-        });
-    }
-    catch (error) {
-        writeError(`crew upgrade: could not reach npm registry: ${errorMessage(error)}`);
-        process.exitCode = 1;
-        return undefined;
-    }
-}
-function resolvePinnedVersion(options, pinnedVersion) {
-    try {
-        parseVersion(pinnedVersion);
-    }
-    catch (error) {
-        writeError(`crew upgrade: ${errorMessage(error)}`);
-        process.exitCode = 1;
-        return undefined;
-    }
-    if (options.currentVersion === pinnedVersion) {
-        writeOutput(`crew is already on ${pinnedVersion}`);
-        return undefined;
-    }
-    const cmp = compareVersions(options.currentVersion, pinnedVersion);
-    if (cmp > 0) {
-        writeOutput(`downgrading ${options.currentVersion} → ${pinnedVersion}`);
-    }
-    return pinnedVersion;
-}
 async function runInstallAndReport(options, npmBin, version) {
     const result = await options.runInstall({
         packageName: options.packageName,
@@ -164,13 +84,12 @@ async function runInstallAndReport(options, npmBin, version) {
         return;
     }
     if (result.sawEacces) {
-        writeError("crew upgrade: install failed with EACCES (permission denied). Your global npm prefix may require elevated permissions — see https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally");
+        writeError("crew upgrade: install failed with EACCES (permission denied). Your global npm prefix may require elevated permissions - see https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally");
     }
     process.exitCode = result.exitCode;
 }
 export async function createDefaultUpgradeCliOptions(args) {
     return {
-        currentVersion: args.currentVersion,
         packageName: args.packageName,
         resolveInstall: async () => {
             const installPath = detectInstallPath(args.cliMetaUrl);
@@ -183,14 +102,9 @@ export async function createDefaultUpgradeCliOptions(args) {
             });
             return { installKind, installPath, npmBin };
         },
-        fetcher: fetchLatestVersion,
         runInstall: async (options) => await runNpmInstallGlobal({
             ...options,
             spawner: createDefaultNpmSpawner(process.stderr),
         }),
-        fetchTimeoutMs: EXPLICIT_FETCH_TIMEOUT_MS,
-        registry: readEnvironmentVariable("npm_config_registry"),
-        cachePath: defaultUpgradeCheckCachePath(),
-        now: Date.now,
     };
 }

package/dist/lib/agentLaunch.d.ts

@@ -10,12 +10,6 @@ export declare function prepareAgentLaunch(input: {
     purpose: "runs" | "resumes";
     signal?: AbortSignal;
 }): Promise<PreparedAgentLaunch>;
-export declare function ensureAgentSandbox(input: {
-    config: ResolvedConfig;
-    definition: ModelDefinition;
-    sandboxName: string | undefined;
-    signal?: AbortSignal;
-}): Promise<void>;
 export declare function openAgentWorkspace(input: {
     config: ResolvedConfig;
     name: string;

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

@@ -1 +1 @@
-{"version":3,"file":"agentLaunch.d.ts","sourceRoot":"","sources":["../../src/lib/agentLaunch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOhF,UAAU,mBAAmB;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA6B/B;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,eAAe,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}
+{"version":3,"file":"agentLaunch.d.ts","sourceRoot":"","sources":["../../src/lib/agentLaunch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOhF,UAAU,mBAAmB;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA6B/B;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}

package/dist/lib/agentLaunch.js

@@ -1,8 +1,7 @@
-import { resolve } from "node:path";
 import { ensureClearance } from "@clipboard-health/clearance";
-import { ensureSandbox, sandboxNameFor } from "./dockerSandbox.js";
 import { detectHostCapabilities } from "./host.js";
 import { assertLocalRunnerRequirements, resolveLocalRunner } from "./localRunner.js";
+import { sandboxNameFor } from "./sandboxName.js";
 import { log, sleep } from "./util.js";
 import { workspaces } from "./workspaces.js";
 export async function prepareAgentLaunch(input) {
@@ -31,16 +30,6 @@ export async function prepareAgentLaunch(input) {
         : undefined;
     return { runner, sandboxName };
 }
-export async function ensureAgentSandbox(input) {
-    if (input.sandboxName !== undefined && input.definition.sandbox !== undefined) {
-        await ensureSandbox({
-            sandboxName: input.sandboxName,
-            sandbox: input.definition.sandbox,
-            mountPath: resolve(input.config.workspace.projectDir),
-            gitDefaults: input.config.sandbox.gitDefaults,
-        }, input.signal);
-    }
-}
 export async function openAgentWorkspace(input) {
     const spec = {
         name: input.name,

package/dist/lib/cmuxAdapter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * cmux Workspace backend. cmux is the macOS TUI; workspaces surface in its
+ * own app, so `accessHint` has nothing concise to emit. cmux can paint a
+ * per-workspace status pill, which `open` applies best-effort.
+ */
+import { type Adapter } from "./workspaceAdapter.ts";
+export declare const cmuxAdapter: Adapter;
+//# sourceMappingURL=cmuxAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmuxAdapter.d.ts","sourceRoot":"","sources":["../../src/lib/cmuxAdapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,OAAO,EAIb,MAAM,uBAAuB,CAAC;AAG/B,eAAO,MAAM,WAAW,EAAE,OA6EzB,CAAC"}