@tablation/crew 0.77.0 → 0.78.0

package/README.md

@@ -263,6 +263,7 @@ crew inbox [--member NAME]    your tickets across every workspace
 crew connect WS[/PROJECT]     resolve a workspace/project's ids into the state tree
 crew repos add [ROUTE] [NAME] [PATH]  attach a local checkout to a route in crew.yaml, creating its Repos row if missing (--dry-run previews)
 crew repos list ROUTE         the checkouts a route has, and the tracker Repos row each matches
+crew repos check [PATH]        validate a checkout's .crew.yaml (parse, release readiness, hook syntax) without attaching it (--route ROUTE, --strict, --json)
 crew repos hooks [ROUTE] NAME  suggest test/build hooks for a checkout (--write route|repo [--replace] writes them, --clear route removes them, --recipes, --hook KEY=CMD, --agent, --json)
 crew install [--replace]     write and load this platform's scheduler unit (macOS: clears a crew installed from another path)
 crew uninstall [--all]        unload and remove it (--all: every crew launchd unit, whichever path it came from)

package/dist/cli.js

@@ -9041,10 +9041,10 @@ function doctorSelftestLines(stored, toolchains) {
 }
 
 // src/cli.ts
-import { resolve as resolve5, dirname as dirname20, join as join37, basename as basename11 } from "path";
+import { resolve as resolve5, dirname as dirname20, join as join37, basename as basename12 } from "path";
 import { fileURLToPath } from "url";
 import { hostname as hostname2, homedir as homedir10 } from "os";
-import { spawnSync as spawnSync6 } from "child_process";
+import { spawnSync as spawnSync7 } from "child_process";
 import { parse as parseYaml2 } from "yaml";
 
 // src/argv.ts
@@ -14393,12 +14393,107 @@ async function showLogEntry(route, entryId, opts = {}) {
   };
 }
 
+// src/repos-check.ts
+import { spawnSync as spawnSync6 } from "child_process";
+import { readFileSync as readFileSync24 } from "fs";
+import { basename as basename8 } from "path";
+var POSIX_SHELL = /^(?:ba|z|da|k|a|mk)?sh$|^fish$/;
+function checkHookSyntax(script, shell) {
+  const spec = resolveShell(shell);
+  const name = basename8(spec.bin).replace(/\.exe$/i, "").toLowerCase();
+  let run2;
+  if (POSIX_SHELL.test(name)) {
+    run2 = spawnSync6(spec.bin, ["-n"], { input: script, encoding: "utf8" });
+  } else if (/^(pwsh|powershell)$/.test(name)) {
+    const parse3 = "$e=$null;[void][System.Management.Automation.Language.Parser]::ParseInput($env:CREW_CHECK_SCRIPT,[ref]$null,[ref]$e);if($e){$e|ForEach-Object{[Console]::Error.WriteLine($_.Message)};exit 1}";
+    run2 = spawnSync6(spec.bin, ["-NoProfile", "-NonInteractive", "-Command", parse3], {
+      encoding: "utf8",
+      env: { ...process.env, CREW_CHECK_SCRIPT: script }
+    });
+  } else {
+    return { status: "unchecked", message: `no syntax check for ${spec.bin}` };
+  }
+  if (run2.error) return { status: "unchecked", message: `cannot run ${spec.bin}: ${run2.error.message}` };
+  if (run2.status === 0) return { status: "ok" };
+  const message = `${run2.stderr ?? ""}${run2.stdout ?? ""}`.trim() || `${spec.bin} exited ${run2.status}`;
+  return { status: "error", message };
+}
+function renderSamples(cfg, dir) {
+  const checkout = basename8(dir.replace(/[/\\]+$/, ""));
+  const tagged = { key: "ISSUE-123", title: "Fix the widget", role: "dev", tag: "TABL-123", prefix: "tabl", lowercase: cfg.branch.lowercase };
+  const untagged = { key: "ISSUE-123", title: "Fix the widget", role: "dev", lowercase: cfg.branch.lowercase };
+  return [["with a project tag", tagged], ["without a project tag", untagged]].map(([label, ctx]) => {
+    const branch = renderBranchName(effectiveBranchTemplate(cfg, ctx.prefix), ctx);
+    const worktree = effectiveWorktreeDirName(cfg, dir, branch, "123", (t) => renderWorktreeName(t, { ...ctx, dir: checkout }));
+    return { case: label, branch, worktree };
+  });
+}
+function checkRepoSpec(dir, opts = {}) {
+  const empty = { parsed: null, effective: null, readiness: [], hooks: [], shadowed: [], samples: [] };
+  const file = findRepoConfig(dir);
+  if (!file) {
+    return { ...empty, file: null, error: `no .crew.yaml, .crew.yml or .crew.json in ${dir}`, exitCode: 1 };
+  }
+  let parsed;
+  try {
+    parsed = parseRepoConfig(readFileSync24(file, "utf8"), file);
+  } catch (e) {
+    if (!(e instanceof RepoConfigError)) throw e;
+    return { ...empty, file, error: e.message, exitCode: 1 };
+  }
+  const effective = resolveRepoConfig(parsed, opts.ship, dir);
+  const readiness = validateEffective(effective);
+  const hooks = Object.keys(effective.hooks).map((name) => ({
+    name,
+    label: hookLabel(effective, name),
+    syntax: checkHookSyntax(effective.hooks[name], effective.shell)
+  }));
+  const failed = hooks.some((h) => h.syntax.status === "error");
+  return {
+    file,
+    parsed,
+    effective,
+    readiness,
+    hooks,
+    shadowed: effective.shadowed,
+    samples: renderSamples(effective, dir),
+    error: null,
+    exitCode: failed || opts.strict && readiness.length > 0 ? 1 : 0
+  };
+}
+function renderRepoCheck(r) {
+  if (r.error) return `${r.file ?? "crew repos check"}: ${r.error}
+`;
+  const e = r.effective;
+  const lines = [
+    `${r.file}`,
+    `  platform           ${e.platform}`,
+    `  release.mode       ${e.release.mode}`,
+    `  release.versioning ${e.release.versioning}`,
+    `  branch.base        ${e.branch.base}`,
+    `  branch.name        ${e.branch.name}`,
+    `  branch.push        ${e.branch.push}`
+  ];
+  for (const s of r.samples) lines.push(`  ${s.case}: branch ${s.branch}, worktree ../${s.worktree}`);
+  lines.push(r.hooks.length ? "  hooks" : "  hooks              none");
+  for (const h of r.hooks) {
+    const named = h.label !== e.hooks[h.name] ? ` (${h.label})` : "";
+    const syntax = h.syntax.status === "ok" ? "syntax ok" : h.syntax.status === "unchecked" ? `syntax not checked: ${h.syntax.message}` : "syntax ERROR";
+    lines.push(`    ${h.name}${named}: ${syntax}`);
+    if (h.syntax.status === "error") lines.push(...(h.syntax.message ?? "").split("\n").map((l) => `      ${l}`));
+  }
+  if (r.shadowed.length) lines.push(`  this ship declares ${r.shadowed.join(", ")}, and the file overrides it \u2014 the file wins`);
+  for (const p of r.readiness) lines.push(`  - release readiness: ${p}`);
+  return `${lines.join("\n")}
+`;
+}
+
 // src/repos-hooks.ts
 import { isMap as isMap2, parseDocument as parseDocument3, YAMLMap } from "yaml";
 
 // src/repos-cmd.ts
 import { homedir as homedir9 } from "os";
-import { basename as basename8, join as join28, resolve as resolve3 } from "path";
+import { basename as basename9, join as join28, resolve as resolve3 } from "path";
 import { isMap, isSeq, parseDocument as parseDocument2, stringify as stringify2 } from "yaml";
 var ReposError = class extends Error {
 };
@@ -14470,7 +14565,7 @@ function configuredRepos(text, route, base) {
     });
   }
   const dir = m.get("dir");
-  return dir ? [{ name: basename8(String(dir)), dir: expandDir(String(dir), base) }] : [];
+  return dir ? [{ name: basename9(String(dir)), dir: expandDir(String(dir), base) }] : [];
 }
 function cloneBaseOf(text, route, base, isCheckout) {
   const m = routeMapOf(parseDocument2(text), route);
@@ -14559,7 +14654,7 @@ function planRepoAdd(i) {
     throw new ReposError(`${target} is already configured on route ${i.route}`);
   }
   const matched = matchRepoName(i.origin, i.resolved);
-  const name = matched ?? i.name ?? normalizeRemote(i.origin)?.split("/").pop() ?? basename8(target);
+  const name = matched ?? i.name ?? normalizeRemote(i.origin)?.split("/").pop() ?? basename9(target);
   let warning;
   if (!matched) {
     const known = Object.values(i.resolved?.repoNames ?? {});
@@ -15075,7 +15170,7 @@ ${run2.err}` });
 }
 
 // src/sample-ticket.ts
-import { basename as basename9, dirname as dirname17, join as join29 } from "path";
+import { basename as basename10, dirname as dirname17, join as join29 } from "path";
 var SAMPLE_REPO = "crew-sample";
 var SAMPLE_REMOTE = `local/${SAMPLE_REPO}`;
 var SAMPLE_MARKER = "sample: true";
@@ -15191,8 +15286,8 @@ function schedulerInstalled(plan, exists, crontab) {
 }
 
 // src/worktree-sweep.ts
-import { existsSync as existsSync27, readFileSync as readFileSync24, readdirSync as readdirSync8 } from "fs";
-import { basename as basename10, dirname as dirname18, join as join30, resolve as resolve4 } from "path";
+import { existsSync as existsSync27, readFileSync as readFileSync25, readdirSync as readdirSync8 } from "fs";
+import { basename as basename11, dirname as dirname18, join as join30, resolve as resolve4 } from "path";
 function planWorktreeSweep(target, tickets, contract) {
   const terminal = new Set(contract.statuses.resolved.filter((s) => s !== contract.statuses.verified));
   const verified = contract.statuses.verified;
@@ -15223,7 +15318,7 @@ function ticketForWorktree(w, byNumber, contract) {
     const t = num ? byNumber.get(num) : void 0;
     if (t && ticketStems(t).has(stem)) return t;
   }
-  const dir = basename10(w.path);
+  const dir = basename11(w.path);
   const m = DIR_NUMBER.exec(dir);
   if (m && byNumber.has(m[1])) return byNumber.get(m[1]);
   if (!w.branch) {
@@ -15239,7 +15334,7 @@ function worktreeTicketNumbers(target) {
       const n = /-(\d+)$/.exec(BRANCH_STEM.exec(w.branch)?.[1] ?? "")?.[1];
       if (n) nums.add(n);
     }
-    const m = DIR_NUMBER_SUFFIXED.exec(basename10(w.path));
+    const m = DIR_NUMBER_SUFFIXED.exec(basename11(w.path));
     if (m) nums.add(m[1]);
   }
   for (const d of siblingWorktreeDirs(target)) nums.add(d.number);
@@ -15247,7 +15342,7 @@ function worktreeTicketNumbers(target) {
 }
 function siblingWorktreeDirs(target) {
   const parent = dirname18(target.dir.replace(/[/\\]+$/, ""));
-  const stem = `${basename10(target.dir.replace(/[/\\]+$/, ""))}-`;
+  const stem = `${basename11(target.dir.replace(/[/\\]+$/, ""))}-`;
   const registered = new Set(worktrees(target.dir).map((w) => resolve4(w.path)));
   let names;
   try {
@@ -15272,7 +15367,7 @@ function orphanedWorktreeDirs(target, tickets, contract) {
 }
 function warnOrphanedWorktreeDirs(paths, log, held) {
   for (const p of paths) {
-    const number = DIR_NUMBER_SUFFIXED.exec(basename10(p))?.[1];
+    const number = DIR_NUMBER_SUFFIXED.exec(basename11(p))?.[1];
     const when = held && number ? noteHeldWorktree(held.state, { repo: held.repo, path: p, ticket: number, status: "deployed", reason: "orphaned directory" }) : "first";
     if (when) {
       log.warn(`orphaned directory ${p}: its ticket is deployed but it is not a registered worktree; the sweep will not delete it \u2014 remove it by hand`, { step: "worktree" });
@@ -15362,7 +15457,7 @@ function isHandBackMerge(path, base) {
   if (!msgPath) return false;
   let first;
   try {
-    first = readFileSync24(resolve4(path, msgPath), "utf8").split("\n")[0] ?? "";
+    first = readFileSync25(resolve4(path, msgPath), "utf8").split("\n")[0] ?? "";
   } catch {
     return false;
   }
@@ -15416,7 +15511,7 @@ function isTicketBranch(name, base, stems) {
 }
 function sweepCandidatesExist(cwd, base) {
   const linked = worktrees(cwd).slice(1);
-  if (linked.some((w) => DIR_NUMBER_SUFFIXED.test(basename10(w.path)) || w.branch && BRANCH_STEM.test(w.branch))) return true;
+  if (linked.some((w) => DIR_NUMBER_SUFFIXED.test(basename11(w.path)) || w.branch && BRANCH_STEM.test(w.branch))) return true;
   if (siblingWorktreeDirs({ name: "", dir: cwd }).length) return true;
   return localBranches(cwd).some((b) => b !== base && /-\d+(?:-.*)?$/.test(b));
 }
@@ -15512,13 +15607,13 @@ function planEventsSweep(stateDir, retentionDays, now = Date.now()) {
 }
 
 // src/cli.ts
-import { realpathSync as realpathSync3, readFileSync as readFileSync30, existsSync as existsSync34, mkdirSync as mkdirSync22, writeFileSync as writeFileSync23, rmSync as rmSync15, unlinkSync as unlinkSync5, copyFileSync as copyFileSync2, renameSync as renameSync3, statSync as statSync10, readdirSync as readdirSync14 } from "fs";
+import { realpathSync as realpathSync3, readFileSync as readFileSync31, existsSync as existsSync34, mkdirSync as mkdirSync22, writeFileSync as writeFileSync23, rmSync as rmSync15, unlinkSync as unlinkSync5, copyFileSync as copyFileSync2, renameSync as renameSync3, statSync as statSync10, readdirSync as readdirSync14 } from "fs";
 import { createInterface } from "readline/promises";
 import { dirname as dirOf, resolve as resolvePath } from "path";
 
 // src/ssh-keys.ts
 import { execFileSync as execFileSync6 } from "child_process";
-import { existsSync as existsSync29, mkdirSync as mkdirSync18, readFileSync as readFileSync25, chmodSync } from "fs";
+import { existsSync as existsSync29, mkdirSync as mkdirSync18, readFileSync as readFileSync26, chmodSync } from "fs";
 import { dirname as dirname19, join as join32 } from "path";
 var SshKeyError = class extends Error {
 };
@@ -15552,7 +15647,7 @@ function ensureShipSshKeypair(stateDir) {
   if (!existsSync29(publicKeyPath)) {
     throw new SshKeyError(`${privateKeyPath} exists but ${publicKeyPath} does not \u2014 regenerate or restore it`);
   }
-  const publicKey = readFileSync25(publicKeyPath, "utf8").trim();
+  const publicKey = readFileSync26(publicKeyPath, "utf8").trim();
   return { privateKeyPath, publicKeyPath, publicKey };
 }
 function sshKeygenAvailable() {
@@ -15769,7 +15864,7 @@ function syncAllPassengerCheckouts(cfg) {
 
 // src/tunnel.ts
 import { spawn as spawn5 } from "child_process";
-import { existsSync as existsSync30, mkdirSync as mkdirSync19, readFileSync as readFileSync26, writeFileSync as writeFileSync20, unlinkSync as unlinkSync3, readdirSync as readdirSync10 } from "fs";
+import { existsSync as existsSync30, mkdirSync as mkdirSync19, readFileSync as readFileSync27, writeFileSync as writeFileSync20, unlinkSync as unlinkSync3, readdirSync as readdirSync10 } from "fs";
 import { randomInt } from "crypto";
 import { join as join33 } from "path";
 var DEFAULT_SPAWN_OPTIONS = { stdio: "ignore", detached: true };
@@ -15844,7 +15939,7 @@ function readPersistedTunnel(stateDir, workspaceId) {
   const path = tunnelStatePath(stateDir, workspaceId);
   if (!existsSync30(path)) return void 0;
   try {
-    return JSON.parse(readFileSync26(path, "utf8"));
+    return JSON.parse(readFileSync27(path, "utf8"));
   } catch {
     return void 0;
   }
@@ -16071,7 +16166,7 @@ async function unregisterEndpoint(workspaceId, info, d) {
 import { createServer as createHttpServer } from "http";
 import { spawn as spawn6 } from "child_process";
 import { randomBytes } from "crypto";
-import { existsSync as existsSync31, mkdirSync as mkdirSync20, readFileSync as readFileSync27, writeFileSync as writeFileSync21, unlinkSync as unlinkSync4, readdirSync as readdirSync11 } from "fs";
+import { existsSync as existsSync31, mkdirSync as mkdirSync20, readFileSync as readFileSync28, writeFileSync as writeFileSync21, unlinkSync as unlinkSync4, readdirSync as readdirSync11 } from "fs";
 import { join as join34 } from "path";
 
 // src/secret-compare.ts
@@ -16167,7 +16262,7 @@ function readPersistedSyncDaemon(stateDir, workspaceId) {
   const path = syncDaemonStatePath(stateDir, workspaceId);
   if (!existsSync31(path)) return void 0;
   try {
-    return JSON.parse(readFileSync27(path, "utf8"));
+    return JSON.parse(readFileSync28(path, "utf8"));
   } catch {
     return void 0;
   }
@@ -16284,11 +16379,11 @@ function describeCause(err) {
 }
 
 // src/daemon.ts
-import { existsSync as existsSync33, mkdirSync as mkdirSync21, readFileSync as readFileSync29, readdirSync as readdirSync13, rmSync as rmSync14, statSync as statSync9, writeFileSync as writeFileSync22 } from "fs";
+import { existsSync as existsSync33, mkdirSync as mkdirSync21, readFileSync as readFileSync30, readdirSync as readdirSync13, rmSync as rmSync14, statSync as statSync9, writeFileSync as writeFileSync22 } from "fs";
 import { join as join36 } from "path";
 
 // src/interrupted.ts
-import { existsSync as existsSync32, readdirSync as readdirSync12, readFileSync as readFileSync28 } from "fs";
+import { existsSync as existsSync32, readdirSync as readdirSync12, readFileSync as readFileSync29 } from "fs";
 import { join as join35 } from "path";
 var INTERRUPTED_MARKER = calloutHeader("NOTE", "Interrupted");
 function interruptedComment(b) {
@@ -16310,7 +16405,7 @@ function runFinished(streamPath) {
   const path = `${streamPath}.meta.json`;
   if (!existsSync32(path)) return false;
   try {
-    return JSON.parse(readFileSync28(path, "utf8")).running !== true;
+    return JSON.parse(readFileSync29(path, "utf8")).running !== true;
   } catch {
     return true;
   }
@@ -16467,7 +16562,7 @@ function noteDaemonStarted(stateDir, now = Date.now()) {
 }
 function readDaemonStarted(stateDir) {
   try {
-    const v = JSON.parse(readFileSync29(daemonStampFor(stateDir), "utf8")).startedAt;
+    const v = JSON.parse(readFileSync30(daemonStampFor(stateDir), "utf8")).startedAt;
     return typeof v === "number" ? v : null;
   } catch {
     return null;
@@ -17018,6 +17113,7 @@ function usage(problem, requested = false) {
   crew skills sync [route]      push only crew's skill files (e.g. grill-me) into the workspace Agent Skills table
   crew ship rename NAME [--json] rename this ship in crew.yaml and on every workspace's Ships row
   crew repos add [ROUTE] [NAME] [PATH]  attach a local checkout to a route in crew.yaml (--dry-run previews)
+  crew repos check [PATH]       validate a checkout's .crew.yaml without attaching it (--route ROUTE, --strict, --json)
   crew repos clone [ROUTE] NAME  clone a Repos row's remote into the route directory and attach it (--dir PATH, --dry-run, --json)
   crew repos hooks [ROUTE] NAME suggest test/build hooks for a checkout (--agent, --write route|repo, --recipes, --json)
   crew repos list ROUTE         the checkouts a route has, with the tracker's Repos row each matches (--json: every Repos row too)
@@ -17116,6 +17212,22 @@ var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
   "worktree"
 ]);
 if (!KNOWN_COMMANDS.has(command)) usage(`unknown command "${command}"`);
+function runReposCheck(dir, ship) {
+  const report = checkRepoSpec(dir, { ship, strict: flag("strict") });
+  if (flag("json")) {
+    const { exitCode: _exit, ...rest } = report;
+    process.stdout.write(`${JSON.stringify(rest)}
+`);
+  } else {
+    process.stdout.write(renderRepoCheck(report));
+  }
+  process.exitCode = report.exitCode;
+}
+var reposCheckBare = command === "repos" && positional[1] === "check" && !value("route") && positional.length < 4;
+if (reposCheckBare) {
+  runReposCheck(resolvePath(positional[2] ?? "."));
+  process.exit(process.exitCode ?? 0);
+}
 function findSyncRoute(c, name) {
   if (!name && c.routes.length > 1) {
     throw new ConfigError(`this ship has ${c.routes.length} routes \u2014 name one: ${c.routes.map((r) => r.route).join(", ")}`);
@@ -17502,7 +17614,7 @@ if (command === "passenger-sync-daemon") {
 `
         );
         if (!dryRun) {
-          spawnSync6("systemctl", ["--user", "disable", "--now", `${label}.timer`], { cwd: CREW_HOME });
+          spawnSync7("systemctl", ["--user", "disable", "--now", `${label}.timer`], { cwd: CREW_HOME });
           try {
             unlinkSync5(staleTimer);
           } catch {
@@ -17542,7 +17654,7 @@ if (command === "passenger-sync-daemon") {
   async function doctorFix(o) {
     const routes = await Promise.all(routesInScope(cfg.routes, named).map((c) => gatherHealth({ route: c.route, enabled: c.enabled, hasRepos: reposOf(c).length > 0 }, () => routeProblems(c))));
     const unitExists = (p) => existsSync34(p);
-    const crontab = o.host === "linux" ? spawnSync6("crontab", ["-l"], { encoding: "utf8" }).stdout ?? "" : "";
+    const crontab = o.host === "linux" ? spawnSync7("crontab", ["-l"], { encoding: "utf8" }).stdout ?? "" : "";
     const schedulerAbsent = o.host !== "windows" ? !schedulerInstalled(planInstall(cfg.ship, CREW_HOME, o.host, detectSystemd(), "run"), unitExists, crontab) : true;
     const plan = planFix({ routes, schedulerAbsent, host: o.host });
     for (const n of plan.notes) process.stdout.write(`fix: ${n}
@@ -17558,7 +17670,7 @@ if (command === "passenger-sync-daemon") {
       for (const a of plan.actions) {
         if (a.kind === "enable") {
           if (prompter && !await prompter.confirm(`Route ${a.route} passes every check \u2014 set enabled: true in ${cfg.configFile}?`, false)) continue;
-          writeFileSync23(cfg.configFile, planEnable(readFileSync30(cfg.configFile, "utf8"), a.route));
+          writeFileSync23(cfg.configFile, planEnable(readFileSync31(cfg.configFile, "utf8"), a.route));
           enabledSound.add(a.route);
           changed2.push(`enabled route ${a.route} in ${cfg.configFile}`);
         } else {
@@ -18559,7 +18671,7 @@ ${changed2.map((c) => `  - ${c}
           }
           let failed = false;
           for (const cmd2 of commands) {
-            const res2 = spawnSync6(cmd2[0], cmd2.slice(1), { cwd: CREW_HOME, encoding: "utf8" });
+            const res2 = spawnSync7(cmd2[0], cmd2.slice(1), { cwd: CREW_HOME, encoding: "utf8" });
             if (res2.stdout) process.stdout.write(res2.stdout);
             if (res2.stderr) process.stderr.write(res2.stderr);
             if (cmd2 === control.startCommand && (res2.error || res2.status !== 0)) {
@@ -18577,7 +18689,7 @@ ${changed2.map((c) => `  - ${c}
 `);
           break;
         }
-        const res = spawnSync6(cmd[0], cmd.slice(1), { cwd: CREW_HOME, encoding: "utf8" });
+        const res = spawnSync7(cmd[0], cmd.slice(1), { cwd: CREW_HOME, encoding: "utf8" });
         if (res.stdout) process.stdout.write(res.stdout);
         if (res.stderr) process.stderr.write(res.stderr);
         if (daemonSub !== "status" && (res.error || res.status !== 0)) {
@@ -18828,7 +18940,7 @@ ${changed2.map((c) => `  - ${c}
 `);
       if (!dryRun) {
         const resolvedPath = resolvedPathFor(cfg.ship.stateDir, target.route);
-        const raw = existsSync34(resolvedPath) ? JSON.parse(readFileSync30(resolvedPath, "utf8")) : {};
+        const raw = existsSync34(resolvedPath) ? JSON.parse(readFileSync31(resolvedPath, "utf8")) : {};
         raw.agentSkills = result.agentSkills;
         mkdirSync22(dirOf(resolvedPath), { recursive: true });
         writeFileSync23(resolvedPath, `${JSON.stringify(raw, null, 2)}
@@ -18854,7 +18966,7 @@ ${changed2.map((c) => `  - ${c}
         throw e;
       }
       const oldName = cfg.ship.name;
-      writeFileSync23(cfg.configFile, setShipNameInYaml(readFileSync30(cfg.configFile, "utf8"), newName));
+      writeFileSync23(cfg.configFile, setShipNameInYaml(readFileSync31(cfg.configFile, "utf8"), newName));
       cfg.ship.name = newName;
       let renameMachineId;
       try {
@@ -18897,11 +19009,37 @@ ${changed2.map((c) => `  - ${c}
     case "repos": {
       const sub = positional[1];
       const usage2 = () => {
-        process.stderr.write("crew repos add [workspace/project] [name] [path] [--name N] [--project P] [--dry-run] [--no-create]\ncrew repos clone [workspace/project] <name> [--dir PATH] [--dry-run] [--json]\ncrew repos list <workspace/project> [--json]\ncrew repos hooks [workspace/project] <name> [--suggest] [--agent] [--write route|repo [--replace]] [--clear route] [--recipes ID,ID] [--hook KEY=CMD ...] [--json]\n");
+        process.stderr.write("crew repos add [workspace/project] [name] [path] [--name N] [--project P] [--dry-run] [--no-create]\ncrew repos clone [workspace/project] <name> [--dir PATH] [--dry-run] [--json]\ncrew repos list <workspace/project> [--json]\ncrew repos check [PATH | --route ROUTE [PATH] | ROUTE NAME] [--strict] [--json]\ncrew repos hooks [workspace/project] <name> [--suggest] [--agent] [--write route|repo [--replace]] [--clear route] [--recipes ID,ID] [--hook KEY=CMD ...] [--json]\n");
         process.exit(2);
       };
-      if (sub !== "add" && sub !== "list" && sub !== "clone" && sub !== "hooks") usage2();
-      const configText = readFileSync30(cfg.configFile, "utf8");
+      if (sub !== "add" && sub !== "list" && sub !== "clone" && sub !== "hooks" && sub !== "check") usage2();
+      const configText = readFileSync31(cfg.configFile, "utf8");
+      if (sub === "check") {
+        try {
+          const routeArg = value("route") ?? positional[2];
+          const found = cfg.routes.find((r) => r.route === routeArg);
+          if (!found) throw new ReposError(`no route "${routeArg}" in the config (have: ${cfg.routes.map((r) => r.route).join(", ") || "none"})`);
+          const named2 = value("route") ? void 0 : positional[3];
+          const dir = named2 ? repoDirOf(configText, dirname20(cfg.configFile), found.route, named2) : resolvePath(positional[value("route") ? 2 : 3] ?? ".");
+          const target = reposOf(found).find((t) => resolvePath(t.dir) === dir || t.name === named2);
+          const o = target ? found.repoOverrides[target.name] : void 0;
+          runReposCheck(dir, {
+            hooks: { ...found.hooks, ...o?.hooks },
+            labels: { ...found.labels, ...o?.labels },
+            release: mergeRouteRelease(found.release, o?.release),
+            branch: { ...found.branch, ...o?.branch },
+            worktrees: { prefix: shipWorktreePrefixFor(found), nameOverride: o?.worktreeName }
+          });
+        } catch (e) {
+          if (e instanceof ReposError) {
+            process.stderr.write(`crew repos: ${e.message}
+`);
+            process.exit(2);
+          }
+          throw e;
+        }
+        break;
+      }
       if (sub === "hooks") {
         try {
           const a = parseHooksArgs(positional.slice(2), routeNamesOf(configText));
@@ -18915,7 +19053,7 @@ ${changed2.map((c) => `  - ${c}
             }
           }, read: (r) => {
             try {
-              return readFileSync30(resolvePath(dir, r), "utf8");
+              return readFileSync31(resolvePath(dir, r), "utf8");
             } catch {
               return void 0;
             }
@@ -19056,7 +19194,7 @@ ${changed2.map((c) => `  - ${c}
       let resolvedRemotes;
       if (existsSync34(resolvedFile)) {
         try {
-          resolvedRemotes = JSON.parse(readFileSync30(resolvedFile, "utf8"));
+          resolvedRemotes = JSON.parse(readFileSync31(resolvedFile, "utf8"));
         } catch {
         }
       }
@@ -19077,7 +19215,7 @@ ${changed2.map((c) => `  - ${c}
               isCheckout,
               repoHasHooks: (d) => REPO_CONFIG_FILENAMES.some((f) => {
                 try {
-                  return Object.keys(parseRepoConfig(readFileSync30(resolvePath(d, f), "utf8"), f).hooks).length > 0;
+                  return Object.keys(parseRepoConfig(readFileSync31(resolvePath(d, f), "utf8"), f).hooks).length > 0;
                 } catch {
                   return false;
                 }
@@ -19186,7 +19324,7 @@ ${changed2.map((c) => `  - ${c}
           process.stdout.write(`created Repos row ${String(rowPayload.name)} (${String(rowPayload.remote)}) ${created.id}
 `);
           if (existsSync34(resolvedFile)) {
-            const raw = JSON.parse(readFileSync30(resolvedFile, "utf8"));
+            const raw = JSON.parse(readFileSync31(resolvedFile, "utf8"));
             raw.repoNames = { ...raw.repoNames, [created.id]: String(rowPayload.name) };
             raw.repoRemotes = { ...raw.repoRemotes, [created.id]: String(rowPayload.remote) };
             writeFileSync23(resolvedFile, `${JSON.stringify(raw, null, 2)}
@@ -19544,7 +19682,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
           process.exit(2);
         }
         if (found.shipNameAdopted && !dryRun) {
-          writeFileSync23(cfg.configFile, setShipNameInYaml(readFileSync30(cfg.configFile, "utf8"), found.shipNameAdopted));
+          writeFileSync23(cfg.configFile, setShipNameInYaml(readFileSync31(cfg.configFile, "utf8"), found.shipNameAdopted));
           cfg.ship.name = found.shipNameAdopted;
         }
         if (found.shipRow) {
@@ -19590,7 +19728,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
         const hadPreviousFile = existsSync34(resolvedPath);
         if (hadPreviousFile) {
           try {
-            previous = JSON.parse(readFileSync30(resolvedPath, "utf8"));
+            previous = JSON.parse(readFileSync31(resolvedPath, "utf8"));
           } catch {
           }
         }
@@ -20475,7 +20613,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
       };
       const droppedRoutes = [];
       try {
-        const rawCfg = parseYaml2(readFileSync30(cfg.configFile, "utf8"));
+        const rawCfg = parseYaml2(readFileSync31(cfg.configFile, "utf8"));
         for (const r of rawCfg?.routes ?? []) {
           if (typeof r?.route !== "string" || cfg.routes.some((x) => x.route === r.route)) continue;
           try {
@@ -20511,7 +20649,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
       }
       const host = hostPlatform();
       const control = host === "windows" ? null : planDaemonControl(CREW_HOME, host, detectSystemd());
-      const unitStatus = control?.statusCommand ? spawnSync6(control.statusCommand[0], control.statusCommand.slice(1), { cwd: CREW_HOME, encoding: "utf8" }) : null;
+      const unitStatus = control?.statusCommand ? spawnSync7(control.statusCommand[0], control.statusCommand.slice(1), { cwd: CREW_HOME, encoding: "utf8" }) : null;
       const unitRunning = unitStatus !== null && !unitStatus.error && unitStatus.status === 0;
       if (!unitRunning) {
         process.stdout.write("crew reload: no daemon unit is running \u2014 nothing to reload (the next run reads crew.yaml fresh)\n");
@@ -20523,7 +20661,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
       process.stdout.write("crew reload: requested \u2014 the daemon finishes its in-flight pass, then relaunches with the new config\n");
       if (flag("now") && control?.stopCommand && control.startCommand) {
         for (const cmd of [control.stopCommand, control.startCommand]) {
-          const res = spawnSync6(cmd[0], cmd.slice(1), { cwd: CREW_HOME, encoding: "utf8" });
+          const res = spawnSync7(cmd[0], cmd.slice(1), { cwd: CREW_HOME, encoding: "utf8" });
           if (cmd === control.startCommand && (res.error || res.status !== 0)) {
             process.stderr.write(`crew reload: ${cmd.join(" ")} exited ${res.status ?? "error"}
 `);
@@ -20569,7 +20707,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
     }
     case "log": {
       try {
-        const text = readFileSync30(cfg.ship.logFile, "utf8").split("\n");
+        const text = readFileSync31(cfg.ship.logFile, "utf8").split("\n");
         process.stdout.write(`${text.slice(-(Number(value("tail")) || 40)).join("\n")}
 `);
       } catch {
@@ -20592,7 +20730,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
       };
       if (!route.resolved) fail(`route ${route.route} is not connected \u2014 run \`crew connect\` first`);
       const tracker = new Tracker(route, cfg.ship);
-      const configText = readFileSync30(cfg.configFile, "utf8");
+      const configText = readFileSync31(cfg.configFile, "utf8");
       const cfgBase = dirname20(cfg.configFile);
       const configured = configuredRepos(configText, route.route, cfgBase);
       const dir = configured.find((r) => r.name === SAMPLE_REPO)?.dir ?? sampleDir(configured.map((r) => r.dir), route.reposBasePath, route.route.split("/")[0]);
@@ -20630,14 +20768,14 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
         if (row) {
           await tracker.deleteRepoRow(row.id);
           if (existsSync34(resolvedFile)) {
-            const raw = JSON.parse(readFileSync30(resolvedFile, "utf8"));
+            const raw = JSON.parse(readFileSync31(resolvedFile, "utf8"));
             if (raw.repoNames) delete raw.repoNames[row.id];
             if (raw.repoRemotes) delete raw.repoRemotes[row.id];
             writeFileSync23(resolvedFile, `${JSON.stringify(raw, null, 2)}
 `);
           }
         }
-        if (existsSync34(join37(dir, ".git")) && basename11(dir) === SAMPLE_REPO) rmSync15(dir, { recursive: true, force: true });
+        if (existsSync34(join37(dir, ".git")) && basename12(dir) === SAMPLE_REPO) rmSync15(dir, { recursive: true, force: true });
         say("removed", { dir, closed }, `removed the sample repo${closed.length ? `, closed ${closed.join(", ")}` : ""}`);
         break;
       }
@@ -20653,7 +20791,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
         writeFileSync23(join37(dir, "README.md"), SAMPLE_README);
         writeFileSync23(join37(dir, ".crew.yaml"), SAMPLE_CREW_YAML);
         const g = (...a) => {
-          const r = spawnSync6("git", a, { cwd: dir, encoding: "utf8" });
+          const r = spawnSync7("git", a, { cwd: dir, encoding: "utf8" });
           if (r.status !== 0) fail(`git ${a[0]} failed in ${dir}: ${(r.stderr || r.stdout).trim()}`);
         };
         g("init", "-b", "main");
@@ -20670,7 +20808,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
         });
         repoId = (await tracker.createRepoRow(payload)).id;
         if (existsSync34(resolvedFile)) {
-          const raw = JSON.parse(readFileSync30(resolvedFile, "utf8"));
+          const raw = JSON.parse(readFileSync31(resolvedFile, "utf8"));
           raw.repoNames = { ...raw.repoNames, [repoId]: SAMPLE_REPO };
           raw.repoRemotes = { ...raw.repoRemotes, [repoId]: SAMPLE_REMOTE };
           writeFileSync23(resolvedFile, `${JSON.stringify(raw, null, 2)}
@@ -20901,7 +21039,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
               // `synthesis-tabl-123`. `worktreePrefix` above is kept for
               // config-provenance display; this is the field that actually
               // describes where a worktree lands by default.
-              worktreeDirPattern: r.config.worktrees.name ?? (r.config.provenance["worktrees.prefix"] !== "default" ? `${r.config.worktrees.prefix}<number>` : `${basename11(r.dir.replace(/[/\\]+$/, ""))}-<branch>`),
+              worktreeDirPattern: r.config.worktrees.name ?? (r.config.provenance["worktrees.prefix"] !== "default" ? `${r.config.worktrees.prefix}<number>` : `${basename12(r.dir.replace(/[/\\]+$/, ""))}-<branch>`),
               worktreeParent: resolvePath(r.dir, "..")
             })),
             waiting: waiting ? { ticket: waiting.ticket, since: waiting.since, streak: fairness.streak() } : null
@@ -21068,7 +21206,7 @@ routes:            ${cfg.routes.map((c) => c.route).join(", ")}
         const unitPlan = planInstall(cfg.ship, CREW_HOME, host, detectSystemd(), "run");
         const abandons = unitAbandonsAgents(unitPlan, (p) => {
           try {
-            return readFileSync30(p, "utf8");
+            return readFileSync31(p, "utf8");
           } catch {
             return null;
           }
@@ -21111,7 +21249,7 @@ routes:            ${cfg.routes.map((c) => c.route).join(", ")}
       );
       for (const r of await resolvedRepos(route)) {
         const { config } = r;
-        const worktreePattern = config.worktrees.name ?? (config.provenance["worktrees.prefix"] !== "default" ? `${config.worktrees.prefix}<number>` : `${basename11(r.dir.replace(/[/\\]+$/, ""))}-${effectiveBranchTemplate(config, void 0)}`);
+        const worktreePattern = config.worktrees.name ?? (config.provenance["worktrees.prefix"] !== "default" ? `${config.worktrees.prefix}<number>` : `${basename12(r.dir.replace(/[/\\]+$/, ""))}-${effectiveBranchTemplate(config, void 0)}`);
         process.stdout.write(
           `${`repo ${r.name}:`.padEnd(19)}${r.dir}
                    worktrees at ../${worktreePattern} (${config.provenance["worktrees.name"] ?? config.provenance["worktrees.prefix"] ?? "default"}), branch ${config.branch.name}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tablation/crew",
-  "version": "0.77.0",
+  "version": "0.78.0",
   "description": "A standing team of headless agents that picks work off a Tablation board, does it on a machine you control, and reports back.",
   "type": "module",
   "license": "MIT",