@clipboard-health/groundcrew 4.1.0 → 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.
@@ -508,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/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAuQA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CvD"}
+{"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,20 +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 { 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.
@@ -27,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());
 }
@@ -80,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;
@@ -175,28 +158,27 @@ const SUBCOMMANDS = {
         invoke: resumeWorkspaceCli,
     },
     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}`);
     }
@@ -235,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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",

package/dist/commands/setupRepos.d.ts

@@ -1,44 +0,0 @@
-/**
- * `crew setup repos` — clone every entry of `workspace.knownRepositories`
- * that does not already exist under `workspace.projectDir`. Entries
- * shaped `<owner>/<repo>` are cloned via `gh repo clone`; bare-name
- * entries are skipped with a hint, because they have no canonical URL
- * we can guess at without involving the user's gh login. Idempotent.
- */
-import { type ResolvedConfig } from "../lib/config.ts";
-export interface SetupReposOptions {
-    /** Print the plan without running any clone. */
-    dryRun?: boolean;
-    /**
-     * Restrict the action to this subset of `knownRepositories`. Each entry
-     * must match an entry in the config or the call rejects before any side
-     * effect.
-     */
-    only?: readonly string[];
-}
-export type SetupReposSkipKind = "bare-name" | "invalid-repository" | "invalid-target";
-export interface SetupReposSkip {
-    repo: string;
-    kind: SetupReposSkipKind;
-    reason: string;
-}
-export interface SetupReposResult {
-    /** Entries already present under `projectDir`. */
-    existing: string[];
-    /** Entries that would be cloned in dry-run mode. */
-    planned: string[];
-    /** Entries successfully cloned this run. */
-    cloned: string[];
-    /** Entries skipped with a reason (e.g. bare names, invalid targets). */
-    skipped: SetupReposSkip[];
-    /** Entries that failed during clone. */
-    failed: {
-        repo: string;
-        error: Error;
-    }[];
-    /** True when `gh` is missing and at least one clone was needed. */
-    ghMissing: boolean;
-}
-export declare function setupRepos(config: ResolvedConfig, options: SetupReposOptions): Promise<SetupReposResult>;
-export declare function setupReposCli(argv: string[]): Promise<void>;
-//# sourceMappingURL=setupRepos.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"setupRepos.d.ts","sourceRoot":"","sources":["../../src/commands/setupRepos.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAInE,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;AAEvF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,wEAAwE;IACxE,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,wCAAwC;IACxC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,EAAE,CAAC;IACzC,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;CACpB;AA6JD,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA0D3B;AAcD,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAajE"}

package/dist/commands/setupRepos.js

@@ -1,212 +0,0 @@
-/**
- * `crew setup repos` — clone every entry of `workspace.knownRepositories`
- * that does not already exist under `workspace.projectDir`. Entries
- * shaped `<owner>/<repo>` are cloned via `gh repo clone`; bare-name
- * entries are skipped with a hint, because they have no canonical URL
- * we can guess at without involving the user's gh login. Idempotent.
- */
-import { mkdirSync, opendirSync, statSync } from "node:fs";
-import { dirname, isAbsolute, relative, resolve } from "node:path";
-import { runCommandAsync } from "../lib/commandRunner.js";
-import { loadConfig } from "../lib/config.js";
-import { which } from "../lib/host.js";
-import { errorMessage, log, parseDryRunPositionals, writeOutput } from "../lib/util.js";
-function emptyResult() {
-    return {
-        existing: [],
-        planned: [],
-        cloned: [],
-        skipped: [],
-        failed: [],
-        ghMissing: false,
-    };
-}
-function selectRepositories(config, only) {
-    if (only === undefined) {
-        return config.workspace.knownRepositories;
-    }
-    const known = new Set(config.workspace.knownRepositories);
-    const unknown = only.filter((entry) => !known.has(entry));
-    if (unknown.length > 0) {
-        throw new Error(`Repositories not in workspace.knownRepositories: ${unknown.join(", ")}. Known: ${config.workspace.knownRepositories.join(", ")}`);
-    }
-    return only;
-}
-function pathExists(path) {
-    return statSync(path, { throwIfNoEntry: false }) !== undefined;
-}
-function isDirectoryEmpty(path) {
-    const directory = opendirSync(path);
-    try {
-        return directory.readSync() === null;
-    }
-    finally {
-        directory.closeSync();
-    }
-}
-function existingTargetPlan(target) {
-    const stats = statSync(target, { throwIfNoEntry: false });
-    if (stats === undefined) {
-        return "clone";
-    }
-    if (!stats.isDirectory()) {
-        return "skip-invalid";
-    }
-    if (pathExists(resolve(target, ".git"))) {
-        return "existing";
-    }
-    return isDirectoryEmpty(target) ? "clone" : "skip-invalid";
-}
-function isInsideProjectDir(projectDir, target) {
-    const relativeTarget = relative(projectDir, target);
-    return (relativeTarget.length > 0 && !relativeTarget.startsWith("..") && !isAbsolute(relativeTarget));
-}
-function repositoryEntryPlan(repo) {
-    const parts = repo.split("/");
-    if (parts.length === 1) {
-        return "bare-name";
-    }
-    if (parts.length === 2 && parts.every((part) => part.length > 0)) {
-        return "clone";
-    }
-    return "invalid-repository";
-}
-function bareNameSkip(repo, target) {
-    return {
-        repo,
-        kind: "bare-name",
-        reason: `bare name needs owner/ prefix to auto-clone; clone manually into ${target}`,
-    };
-}
-function invalidTargetSkip(repo, target) {
-    return {
-        repo,
-        kind: "invalid-target",
-        reason: `target exists but is not a git repository or empty directory: ${target}`,
-    };
-}
-function invalidRepositorySkip(repo, target) {
-    return {
-        repo,
-        kind: "invalid-repository",
-        reason: `repository must be owner/repo to auto-clone; clone manually into ${target}`,
-    };
-}
-function escapingTargetSkip(repo, projectDir, target) {
-    return {
-        repo,
-        kind: "invalid-repository",
-        reason: `repository resolves outside workspace.projectDir (${projectDir}): ${target}`,
-    };
-}
-function planClones(config, repositories) {
-    const projectDir = resolve(config.workspace.projectDir);
-    const toClone = [];
-    const existing = [];
-    const skipped = [];
-    const seen = new Set();
-    for (const entry of repositories) {
-        if (seen.has(entry)) {
-            continue;
-        }
-        seen.add(entry);
-        const target = resolve(projectDir, entry);
-        if (!isInsideProjectDir(projectDir, target)) {
-            skipped.push(escapingTargetSkip(entry, projectDir, target));
-            continue;
-        }
-        const targetPlan = existingTargetPlan(target);
-        if (targetPlan === "existing") {
-            existing.push(entry);
-            continue;
-        }
-        if (targetPlan === "skip-invalid") {
-            skipped.push(invalidTargetSkip(entry, target));
-            continue;
-        }
-        const repositoryPlan = repositoryEntryPlan(entry);
-        if (repositoryPlan === "bare-name") {
-            skipped.push(bareNameSkip(entry, target));
-            continue;
-        }
-        if (repositoryPlan === "invalid-repository") {
-            skipped.push(invalidRepositorySkip(entry, target));
-            continue;
-        }
-        toClone.push(entry);
-    }
-    return { toClone, existing, skipped };
-}
-export async function setupRepos(config, options) {
-    const repositories = selectRepositories(config, options.only);
-    const plan = planClones(config, repositories);
-    const result = emptyResult();
-    result.existing = plan.existing;
-    result.skipped = plan.skipped;
-    for (const entry of plan.existing) {
-        log(`[exists] ${entry}`);
-    }
-    for (const { repo, reason } of plan.skipped) {
-        log(`[skip] ${repo} — ${reason}`);
-    }
-    if (options.dryRun === true) {
-        result.planned = plan.toClone;
-        for (const entry of plan.toClone) {
-            log(`[dry-run] would clone ${entry}`);
-        }
-        return result;
-    }
-    if (plan.toClone.length === 0) {
-        return result;
-    }
-    const ghPath = await which("gh");
-    if (ghPath === undefined) {
-        result.ghMissing = true;
-        writeOutput("gh CLI not found - install GitHub CLI from https://cli.github.com/ (or clone the missing repos manually).");
-        return result;
-    }
-    const projectDir = resolve(config.workspace.projectDir);
-    // Sequential on purpose: each `gh repo clone` inherits stdio for progress
-    // bars and auth prompts. Parallel clones would interleave output and make
-    // any interactive 2FA prompt unanswerable.
-    for (const entry of plan.toClone) {
-        const target = resolve(projectDir, entry);
-        log(`[clone] ${entry} → ${target}`);
-        try {
-            mkdirSync(dirname(target), { recursive: true });
-            // oxlint-disable-next-line no-await-in-loop -- see comment above
-            await runCommandAsync("gh", ["repo", "clone", entry, target], {
-                stdio: "inherit",
-                timeoutMs: 0,
-            });
-            result.cloned.push(entry);
-        }
-        catch (error) {
-            const wrapped = error instanceof Error ? error : new Error(errorMessage(error));
-            log(`[fail]  ${entry}: ${wrapped.message}`);
-            result.failed.push({ repo: entry, error: wrapped });
-        }
-    }
-    return result;
-}
-function parseArguments(argv) {
-    const { dryRun, positionals } = parseDryRunPositionals(argv, "crew setup repos [--dry-run] [<repo>...]");
-    const options = { dryRun };
-    if (positionals.length > 0) {
-        options.only = positionals;
-    }
-    return options;
-}
-export async function setupReposCli(argv) {
-    const options = parseArguments(argv);
-    const config = await loadConfig();
-    const result = await setupRepos(config, options);
-    if (result.ghMissing || result.failed.length > 0) {
-        process.exitCode = 1;
-        return;
-    }
-    // Remaining skips mean setup is incomplete — signal that to CI gates.
-    if (result.skipped.length > 0) {
-        process.exitCode = 1;
-    }
-}

package/dist/lib/upgrade.d.ts

@@ -1,66 +0,0 @@
-interface Version {
-    major: number;
-    minor: number;
-    patch: number;
-}
-export declare function parseVersion(version: string): Version;
-export declare function compareVersions(a: string, b: string): -1 | 0 | 1;
-export declare function normalizeRegistry(registry: string | undefined): string;
-export interface FetchOptions {
-    timeoutMs: number;
-    registry?: string | undefined;
-}
-export declare function fetchLatestVersion(packageName: string, options: FetchOptions): Promise<string>;
-export interface UpgradeCheckCacheEntry {
-    latest: string;
-    fetchedAt: number;
-    registry: string;
-}
-export interface PrimeUpgradeCheckCacheOptions {
-    path: string;
-    latest: string;
-    registry?: string | undefined;
-    now: () => number;
-}
-export type UpgradeCheckCacheResult = {
-    kind: "missing";
-} | {
-    kind: "fresh";
-    entry: UpgradeCheckCacheEntry;
-} | {
-    kind: "stale";
-    entry: UpgradeCheckCacheEntry;
-};
-export declare function defaultUpgradeCheckCachePath(): string;
-export declare function readUpgradeCheckCache(path: string, options: {
-    now: () => number;
-    ttlMs: number;
-    registry?: string | undefined;
-}): UpgradeCheckCacheResult;
-export declare function writeUpgradeCheckCache(path: string, entry: UpgradeCheckCacheEntry): void;
-export declare function primeUpgradeCheckCache(options: PrimeUpgradeCheckCacheOptions): void;
-export declare function composeNudgeMessage(current: string, latest: string): string | undefined;
-export type VersionFetcher = (packageName: string, options: FetchOptions) => Promise<string>;
-export interface FetchAndPrimeUpgradeCheckCacheOptions {
-    packageName: string;
-    cachePath: string;
-    fetchTimeoutMs: number;
-    registry?: string | undefined;
-    now: () => number;
-    fetcher: VersionFetcher;
-}
-export declare function fetchAndPrimeUpgradeCheckCache(options: FetchAndPrimeUpgradeCheckCacheOptions): Promise<string>;
-export interface ComputeUpgradeNudgeOptions {
-    currentVersion: string;
-    packageName: string;
-    cachePath: string;
-    ttlMs: number;
-    fetchTimeoutMs: number;
-    registry?: string | undefined;
-    noUpgradeCheck: boolean;
-    now: () => number;
-    fetcher: VersionFetcher;
-}
-export declare function computeUpgradeNudge(options: ComputeUpgradeNudgeOptions): Promise<string | undefined>;
-export {};
-//# sourceMappingURL=upgrade.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/lib/upgrade.ts"],"names":[],"mappings":"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"}

package/dist/lib/upgrade.js

@@ -1,178 +0,0 @@
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-import { errorMessage, readEnvironmentVariable } from "./util.js";
-const NUMERIC_IDENTIFIER_PATTERN = String.raw `0|[1-9]\d*`;
-const VERSION_RE = new RegExp(String.raw `^(${NUMERIC_IDENTIFIER_PATTERN})\.(${NUMERIC_IDENTIFIER_PATTERN})\.(${NUMERIC_IDENTIFIER_PATTERN})$`);
-export function parseVersion(version) {
-    const match = VERSION_RE.exec(version);
-    if (!match) {
-        throw new Error(`invalid version: ${JSON.stringify(version)}`);
-    }
-    return {
-        // oxlint-disable typescript/no-non-null-assertion -- VERSION_RE guarantees groups 1–3 on match; group 4 is optional.
-        major: Number.parseInt(match[1], 10),
-        minor: Number.parseInt(match[2], 10),
-        patch: Number.parseInt(match[3], 10),
-        // oxlint-enable typescript/no-non-null-assertion
-    };
-}
-export function compareVersions(a, b) {
-    const left = parseVersion(a);
-    const right = parseVersion(b);
-    for (const key of ["major", "minor", "patch"]) {
-        if (left[key] !== right[key]) {
-            return left[key] > right[key] ? 1 : -1;
-        }
-    }
-    return 0;
-}
-const DEFAULT_REGISTRY = "https://registry.npmjs.org";
-export function normalizeRegistry(registry) {
-    return (registry ?? DEFAULT_REGISTRY).replace(/\/$/, "");
-}
-function encodePackageNameForRegistry(packageName) {
-    return encodeURIComponent(packageName).replace(/^%40/, "@");
-}
-export async function fetchLatestVersion(packageName, options) {
-    const registry = normalizeRegistry(options.registry);
-    const url = `${registry}/${encodePackageNameForRegistry(packageName)}/latest`;
-    const controller = new AbortController();
-    const timer = setTimeout(() => {
-        controller.abort();
-    }, options.timeoutMs);
-    try {
-        let response;
-        try {
-            response = await fetch(url, { signal: controller.signal });
-        }
-        catch (error) {
-            throw new Error(`registry request failed: ${errorMessage(error)}`, { cause: error });
-        }
-        if (!response.ok) {
-            throw new Error(`registry returned ${response.status} for ${url}`);
-        }
-        const body = await response.json();
-        if (typeof body !== "object" || body === null || !("version" in body)) {
-            throw new TypeError(`registry response missing 'version' field`);
-        }
-        const { version } = body;
-        if (typeof version !== "string") {
-            throw new TypeError(`registry response 'version' field is not a string`);
-        }
-        parseVersion(version);
-        return version;
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
-export function defaultUpgradeCheckCachePath() {
-    const override = readEnvironmentVariable("XDG_CACHE_HOME");
-    const base = override === undefined || override.length === 0 ? join(homedir(), ".cache") : override;
-    return join(base, "groundcrew", "upgrade-check.json");
-}
-function parseCacheEntry(value) {
-    if (typeof value !== "object" || value === null) {
-        return undefined;
-    }
-    const candidate = value;
-    if (typeof candidate.latest !== "string" ||
-        typeof candidate.fetchedAt !== "number" ||
-        typeof candidate.registry !== "string") {
-        return undefined;
-    }
-    try {
-        parseVersion(candidate.latest);
-    }
-    catch {
-        return undefined;
-    }
-    return { latest: candidate.latest, fetchedAt: candidate.fetchedAt, registry: candidate.registry };
-}
-export function readUpgradeCheckCache(path, options) {
-    let raw;
-    try {
-        raw = readFileSync(path, "utf8");
-    }
-    catch {
-        return { kind: "missing" };
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        return { kind: "missing" };
-    }
-    const entry = parseCacheEntry(parsed);
-    if (!entry) {
-        return { kind: "missing" };
-    }
-    if (entry.registry !== normalizeRegistry(options.registry)) {
-        return { kind: "missing" };
-    }
-    const ageMs = options.now() - entry.fetchedAt;
-    return ageMs >= options.ttlMs ? { kind: "stale", entry } : { kind: "fresh", entry };
-}
-export function writeUpgradeCheckCache(path, entry) {
-    mkdirSync(dirname(path), { recursive: true });
-    writeFileSync(path, JSON.stringify(entry));
-}
-function writeUpgradeCheckCacheBestEffort(path, entry) {
-    try {
-        writeUpgradeCheckCache(path, entry);
-    }
-    catch {
-        // Upgrade-check cache writes are best-effort; callers should keep using current data.
-    }
-}
-export function primeUpgradeCheckCache(options) {
-    writeUpgradeCheckCacheBestEffort(options.path, {
-        latest: options.latest,
-        fetchedAt: options.now(),
-        registry: normalizeRegistry(options.registry),
-    });
-}
-export function composeNudgeMessage(current, latest) {
-    if (compareVersions(current, latest) >= 0) {
-        return undefined;
-    }
-    return `[crew] ${latest} available — run \`crew upgrade\` (you have ${current})`;
-}
-export async function fetchAndPrimeUpgradeCheckCache(options) {
-    const latest = await options.fetcher(options.packageName, {
-        timeoutMs: options.fetchTimeoutMs,
-        registry: options.registry,
-    });
-    primeUpgradeCheckCache({
-        path: options.cachePath,
-        latest,
-        registry: options.registry,
-        now: options.now,
-    });
-    return latest;
-}
-export async function computeUpgradeNudge(options) {
-    if (options.noUpgradeCheck) {
-        return undefined;
-    }
-    const cacheResult = readUpgradeCheckCache(options.cachePath, {
-        now: options.now,
-        ttlMs: options.ttlMs,
-        registry: options.registry,
-    });
-    if (cacheResult.kind === "fresh") {
-        return composeNudgeMessage(options.currentVersion, cacheResult.entry.latest);
-    }
-    try {
-        const latest = await fetchAndPrimeUpgradeCheckCache(options);
-        return composeNudgeMessage(options.currentVersion, latest);
-    }
-    catch {
-        if (cacheResult.kind === "stale") {
-            return composeNudgeMessage(options.currentVersion, cacheResult.entry.latest);
-        }
-        return undefined;
-    }
-}