@tablation/crew 0.57.0 → 0.58.0

package/README.md

@@ -239,6 +239,7 @@ crew watch [route]             live view of what the crew is doing
 crew status [route]            paused/running state, led by what the operator owes (needs_info assigned to them, needs_planning, ships needing attention)
 crew doctor [route] [--fix]    preflight; --fix enables clean routes, offers crew install
 crew selftest [route] [--toolchain NAME] [--json]   launch each toolchain as a run would and prove it reaches the tracker
+crew sample-ticket [route] [--remove] [--dry-run] [--json]   file one ticket on a throwaway repo that walks the dev, QA and release loop
 crew ports [route]             which checkout owns which ports, and what is up
 crew reap [route]              kill servers left behind by removed worktrees
 crew drop [route] NNN          remove a merged ticket's worktree and branch

package/dist/cli.js

@@ -5104,7 +5104,7 @@ function doctorSelftestLines(stored, toolchains) {
 }
 
 // src/cli.ts
-import { resolve as resolve5, dirname as dirname14, join as join28, basename as basename9 } from "path";
+import { resolve as resolve5, dirname as dirname15, join as join29, basename as basename10 } from "path";
 import { fileURLToPath } from "url";
 import { hostname as hostname2, homedir as homedir8 } from "os";
 import { spawnSync as spawnSync6 } from "child_process";
@@ -7201,6 +7201,25 @@ var Tracker = class {
     if (!model) throw new Error("this workspace has no Repos table");
     return this.client.records.create(model, fields);
   }
+  /** Every `Repos` row as `{ id, name }`, for finding one by name. */
+  async repoRows() {
+    const model = this.route.resolved?.reposModelId;
+    if (!model) return [];
+    return this.client.records.list(model, { limit: 200 });
+  }
+  /** Delete a `Repos` row (`crew sample-ticket --remove`). */
+  async deleteRepoRow(id) {
+    const model = this.route.resolved?.reposModelId;
+    if (!model) throw new Error("this workspace has no Repos table");
+    await this.client.records.remove(model, id);
+  }
+  /** Every ticket filed against one `Repos` row, any status. */
+  async ticketsForRepo(repoId) {
+    return this.client.records.list(this.models.issues, {
+      filters: encodeFilters([{ columnName: this.contract.columns.repo, operator: "EQ", value: repoId }]),
+      limit: 200
+    });
+  }
   /**
    * The Ships rows of this workspace, if it has a Ships table.
    *
@@ -12508,9 +12527,77 @@ async function showLogEntry(route, entryId, opts = {}) {
   };
 }
 
+// src/sample-ticket.ts
+import { basename as basename7, dirname as dirname11, join as join20 } from "path";
+var SAMPLE_REPO = "crew-sample";
+var SAMPLE_REMOTE = `local/${SAMPLE_REPO}`;
+var SAMPLE_MARKER = "sample: true";
+var SAMPLE_CREW_YAML = `version: 1
+platform: unix
+branch:
+  base: main
+hooks:
+  test: "true"
+  build: "true"
+release:
+  mode: integrate
+  versioning: none
+  changelog: false
+`;
+var SAMPLE_README = `# crew-sample
+
+A throwaway repository created by \`crew sample-ticket\`. It exists so the crew
+has something safe to work on: its test and build hooks always pass, it has no
+remote, and \`crew sample-ticket --remove\` deletes it.
+`;
+function sampleDir(existing, reposBase, workspace) {
+  if (existing.length > 0) return join20(dirname11(existing[0]), SAMPLE_REPO);
+  return join20(reposBase, workspace, SAMPLE_REPO);
+}
+var SAMPLE_TITLE = "Sample: add a documented `greet` function with a test";
+function sampleDescription() {
+  return [
+    SAMPLE_MARKER,
+    "",
+    "> This is a sample ticket filed by `crew sample-ticket` on a throwaway repository. Nothing here is real work.",
+    "",
+    "## What",
+    "",
+    "Add `greet.js` exporting `greet(name)`, which returns `Hello, <name>!` (and `Hello, world!` for no name),",
+    "with a JSDoc comment, and `greet.test.js` covering both cases using `node:test`.",
+    "",
+    "## Acceptance",
+    "",
+    '- `greet("Ada")` returns `Hello, Ada!`; `greet()` returns `Hello, world!`.',
+    "- The test file runs with `node --test` and passes.",
+    "- Add a line to the README saying the function exists.",
+    "",
+    "## Notes",
+    "",
+    "The repo has no remote: leave the branch local. The hooks in `.crew.yaml` always pass, so QA is checking the",
+    "diff against the acceptance list above."
+  ].join("\n");
+}
+function isSampleTicket(description) {
+  return (description ?? "").trimStart().startsWith(SAMPLE_MARKER);
+}
+function planSampleTicket(i) {
+  return {
+    title: SAMPLE_TITLE,
+    description: sampleDescription(),
+    report_type: "feature",
+    severity: "s4",
+    reporter_name: "crew sample-ticket",
+    status: i.approvedStatus,
+    project_id: i.projectId,
+    repo_id: i.repoId,
+    ...i.filedBy ? { filed_by_id: i.filedBy } : {}
+  };
+}
+
 // src/repos-cmd.ts
 import { homedir as homedir7 } from "os";
-import { basename as basename7, join as join20, resolve as resolve3 } from "path";
+import { basename as basename8, join as join21, resolve as resolve3 } from "path";
 import { isMap, isSeq, parseDocument, stringify as stringify2 } from "yaml";
 var ReposError = class extends Error {
 };
@@ -12582,7 +12669,7 @@ function configuredRepos(text, route, base) {
     });
   }
   const dir = m.get("dir");
-  return dir ? [{ name: basename7(String(dir)), dir: expandDir(String(dir), base) }] : [];
+  return dir ? [{ name: basename8(String(dir)), dir: expandDir(String(dir), base) }] : [];
 }
 function planRepoAdd(i) {
   const doc = parseDocument(i.text);
@@ -12594,7 +12681,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() ?? basename7(target);
+  const name = matched ?? i.name ?? normalizeRemote(i.origin)?.split("/").pop() ?? basename8(target);
   let warning;
   if (!matched) {
     const known = Object.values(i.resolved?.repoNames ?? {});
@@ -12621,6 +12708,28 @@ function planRepoAdd(i) {
   }
   return { text: String(doc), mode, name, block: renderBlock(m), warning, unmatched: !matched };
 }
+function planRepoRemove(text, base, route, path) {
+  const doc = parseDocument(text);
+  if (doc.errors.length > 0) throw new ReposError(`config is not valid YAML \u2014 ${doc.errors[0].message}`);
+  const m = routeMapOf(doc, route);
+  const target = expandDir(path, base);
+  const existing = configuredRepos(text, route, base);
+  const hit = existing.find((e) => e.dir === target);
+  if (!hit) throw new ReposError(`${target} is not configured on route ${route}`);
+  const repos = m.get("repos", true);
+  if (isMap(repos)) {
+    repos.delete(hit.name);
+    const left = existing.filter((e) => e !== hit);
+    if (left.length === 1) {
+      const pair = m.items.find((p) => p.key.value === "repos");
+      pair.key = doc.createNode("dir");
+      pair.value = doc.createNode(String(repos.get(left[0].name)));
+    } else if (left.length === 0) m.delete("repos");
+  } else {
+    m.delete("dir");
+  }
+  return { text: String(doc), name: hit.name };
+}
 function renderBlock(m) {
   return stringify2([m.toJSON()]).trimEnd();
 }
@@ -12686,7 +12795,7 @@ function planRepoClone(i) {
   }
   const ship = doc.get("ship", true);
   const basePath = String(m.get("reposBasePath") ?? (isMap(ship) ? ship.get("reposBasePath") : void 0) ?? "~/Crew");
-  const target = i.dir ? expandDir(i.dir, i.base) : join20(expandDir(basePath, i.base), i.route.split("/")[0], name);
+  const target = i.dir ? expandDir(i.dir, i.base) : join21(expandDir(basePath, i.base), i.route.split("/")[0], name);
   const add = planRepoAdd({ text: i.text, base: i.base, route: i.route, path: target, origin: remote, resolved: i.resolved, name });
   return { ...add, remote, target };
 }
@@ -12730,7 +12839,7 @@ function schedulerInstalled(plan, exists, crontab) {
 
 // src/worktree-sweep.ts
 import { existsSync as existsSync21, readFileSync as readFileSync15, readdirSync as readdirSync5 } from "fs";
-import { basename as basename8, dirname as dirname12, join as join21, resolve as resolve4 } from "path";
+import { basename as basename9, dirname as dirname13, join as join22, 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;
@@ -12761,7 +12870,7 @@ function ticketForWorktree(w, byNumber, contract) {
     const t = num ? byNumber.get(num) : void 0;
     if (t && ticketStems(t).has(stem)) return t;
   }
-  const dir = basename8(w.path);
+  const dir = basename9(w.path);
   const m = DIR_NUMBER.exec(dir);
   if (m && byNumber.has(m[1])) return byNumber.get(m[1]);
   if (!w.branch) {
@@ -12777,15 +12886,15 @@ 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(basename8(w.path));
+    const m = DIR_NUMBER_SUFFIXED.exec(basename9(w.path));
     if (m) nums.add(m[1]);
   }
   for (const d of siblingWorktreeDirs(target)) nums.add(d.number);
   return [...nums];
 }
 function siblingWorktreeDirs(target) {
-  const parent = dirname12(target.dir.replace(/[/\\]+$/, ""));
-  const stem = `${basename8(target.dir.replace(/[/\\]+$/, ""))}-`;
+  const parent = dirname13(target.dir.replace(/[/\\]+$/, ""));
+  const stem = `${basename9(target.dir.replace(/[/\\]+$/, ""))}-`;
   const registered = new Set(worktrees(target.dir).map((w) => resolve4(w.path)));
   let names;
   try {
@@ -12797,7 +12906,7 @@ function siblingWorktreeDirs(target) {
   for (const name of names) {
     if (!name.startsWith(stem)) continue;
     const m = DIR_NUMBER_SUFFIXED.exec(name);
-    const path = join21(parent, name);
+    const path = join22(parent, name);
     if (m && !registered.has(resolve4(path))) out.push({ path, number: m[1] });
   }
   return out;
@@ -12810,7 +12919,7 @@ function orphanedWorktreeDirs(target, tickets, contract) {
 }
 function warnOrphanedWorktreeDirs(paths, log, held) {
   for (const p of paths) {
-    const number = DIR_NUMBER_SUFFIXED.exec(basename8(p))?.[1];
+    const number = DIR_NUMBER_SUFFIXED.exec(basename9(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" });
@@ -12954,7 +13063,7 @@ function isTicketBranch(name, base, stems) {
 }
 function sweepCandidatesExist(cwd, base) {
   const linked = worktrees(cwd).slice(1);
-  if (linked.some((w) => DIR_NUMBER_SUFFIXED.test(basename8(w.path)) || w.branch && BRANCH_STEM.test(w.branch))) return true;
+  if (linked.some((w) => DIR_NUMBER_SUFFIXED.test(basename9(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));
 }
@@ -13006,13 +13115,13 @@ function applyRemoteBranchCleanup(cwd, remote, branches2, dryRun, log) {
 
 // src/stream-sweep.ts
 import { existsSync as existsSync22, readdirSync as readdirSync6, rmSync as rmSync9, statSync as statSync7 } from "fs";
-import { join as join22 } from "path";
+import { join as join23 } from "path";
 var DAY_MS2 = 24 * 60 * 60 * 1e3;
 function planStreamSweep(stateDir, retentionDays, now = Date.now()) {
-  const dir = join22(stateDir, "streams");
+  const dir = join23(stateDir, "streams");
   if (!existsSync22(dir)) return [];
   const cutoff = now - retentionDays * DAY_MS2;
-  return readdirSync6(dir).map((name) => join22(dir, name)).filter((path) => {
+  return readdirSync6(dir).map((name) => join23(dir, name)).filter((path) => {
     try {
       return statSync7(path).mtimeMs < cutoff;
     } catch {
@@ -13040,7 +13149,7 @@ function applyStreamSweep(paths, dryRun, log) {
 function planEventsSweep(stateDir, retentionDays, now = Date.now()) {
   if (!existsSync22(stateDir)) return [];
   const cutoff = now - retentionDays * DAY_MS2;
-  return readdirSync6(stateDir).filter((name) => ROTATED_EVENTS_RE.test(name)).map((name) => join22(stateDir, name)).filter((path) => {
+  return readdirSync6(stateDir).filter((name) => ROTATED_EVENTS_RE.test(name)).map((name) => join23(stateDir, name)).filter((path) => {
     try {
       return statSync7(path).mtimeMs < cutoff;
     } catch {
@@ -13050,24 +13159,24 @@ function planEventsSweep(stateDir, retentionDays, now = Date.now()) {
 }
 
 // src/cli.ts
-import { readFileSync as readFileSync21, existsSync as existsSync28, mkdirSync as mkdirSync14, writeFileSync as writeFileSync15, unlinkSync as unlinkSync5, copyFileSync as copyFileSync2, renameSync as renameSync2, statSync as statSync9, readdirSync as readdirSync11 } from "fs";
+import { readFileSync as readFileSync21, existsSync as existsSync28, mkdirSync as mkdirSync14, writeFileSync as writeFileSync15, rmSync as rmSync11, unlinkSync as unlinkSync5, copyFileSync as copyFileSync2, renameSync as renameSync2, statSync as statSync9, readdirSync as readdirSync11 } from "fs";
 import { createInterface } from "readline/promises";
 import { dirname as dirOf, resolve as resolvePath } from "path";
 
 // src/ssh-keys.ts
 import { execFileSync as execFileSync3 } from "child_process";
 import { existsSync as existsSync23, mkdirSync as mkdirSync10, readFileSync as readFileSync16, chmodSync } from "fs";
-import { dirname as dirname13, join as join23 } from "path";
+import { dirname as dirname14, join as join24 } from "path";
 var SshKeyError = class extends Error {
 };
 function shipSshKeyPathFor(stateDir) {
-  return join23(stateDir, "ssh", "id_ed25519");
+  return join24(stateDir, "ssh", "id_ed25519");
 }
 function ensureShipSshKeypair(stateDir) {
   const privateKeyPath = shipSshKeyPathFor(stateDir);
   const publicKeyPath = `${privateKeyPath}.pub`;
   if (!existsSync23(privateKeyPath)) {
-    mkdirSync10(dirname13(privateKeyPath), { recursive: true });
+    mkdirSync10(dirname14(privateKeyPath), { recursive: true });
     try {
       execFileSync3("ssh-keygen", [
         "-t",
@@ -13308,7 +13417,7 @@ function syncAllPassengerCheckouts(cfg) {
 import { spawn as spawn4 } from "child_process";
 import { existsSync as existsSync24, mkdirSync as mkdirSync11, readFileSync as readFileSync17, writeFileSync as writeFileSync12, unlinkSync as unlinkSync3, readdirSync as readdirSync7 } from "fs";
 import { randomInt } from "crypto";
-import { join as join24 } from "path";
+import { join as join25 } from "path";
 var DEFAULT_SPAWN_OPTIONS = { stdio: "ignore", detached: true };
 var defaultSpawn = (cmd, args) => spawn4(cmd, args, DEFAULT_SPAWN_OPTIONS);
 var SLUG_ALPHABET = "abcdefghijklmnopqrstuvwxyz0123456789";
@@ -13375,7 +13484,7 @@ function startTunnel(opts) {
   };
 }
 function tunnelStatePath(stateDir, workspaceId) {
-  return join24(stateDir, "passengers", `${workspaceId}.json`);
+  return join25(stateDir, "passengers", `${workspaceId}.json`);
 }
 function readPersistedTunnel(stateDir, workspaceId) {
   const path = tunnelStatePath(stateDir, workspaceId);
@@ -13388,7 +13497,7 @@ function readPersistedTunnel(stateDir, workspaceId) {
 }
 function writePersistedTunnel(stateDir, state) {
   const path = tunnelStatePath(stateDir, state.workspaceId);
-  mkdirSync11(join24(stateDir, "passengers"), { recursive: true });
+  mkdirSync11(join25(stateDir, "passengers"), { recursive: true });
   writeFileSync12(path, `${JSON.stringify(state, null, 2)}
 `);
 }
@@ -13486,7 +13595,7 @@ function syncPassengerTunnels(plans, relayHost, relayPort, privateKeyPath, state
   }
 }
 function readAllPersistedWorkspaceIds(stateDir) {
-  const dir = join24(stateDir, "passengers");
+  const dir = join25(stateDir, "passengers");
   if (!existsSync24(dir)) return [];
   return readdirSync7(dir).filter((f) => f.endsWith(".json") && !f.endsWith("-sync.json")).map((f) => f.slice(0, -".json".length));
 }
@@ -13609,7 +13718,7 @@ import { createServer as createHttpServer } from "http";
 import { spawn as spawn5 } from "child_process";
 import { randomBytes } from "crypto";
 import { existsSync as existsSync25, mkdirSync as mkdirSync12, readFileSync as readFileSync18, writeFileSync as writeFileSync13, unlinkSync as unlinkSync4, readdirSync as readdirSync8 } from "fs";
-import { join as join25 } from "path";
+import { join as join26 } from "path";
 
 // src/secret-compare.ts
 import { timingSafeEqual } from "crypto";
@@ -13698,7 +13807,7 @@ var defaultSpawn2 = (cmd, args, env) => {
   return child;
 };
 function syncDaemonStatePath(stateDir, workspaceId) {
-  return join25(stateDir, "passengers", `${workspaceId}-sync.json`);
+  return join26(stateDir, "passengers", `${workspaceId}-sync.json`);
 }
 function readPersistedSyncDaemon(stateDir, workspaceId) {
   const path = syncDaemonStatePath(stateDir, workspaceId);
@@ -13711,7 +13820,7 @@ function readPersistedSyncDaemon(stateDir, workspaceId) {
 }
 function writePersistedSyncDaemon(stateDir, state) {
   const path = syncDaemonStatePath(stateDir, state.workspaceId);
-  mkdirSync12(join25(stateDir, "passengers"), { recursive: true });
+  mkdirSync12(join26(stateDir, "passengers"), { recursive: true });
   writeFileSync13(path, `${JSON.stringify(state, null, 2)}
 `);
 }
@@ -13732,7 +13841,7 @@ function waitForExit(pid, alive, timeoutMs = 5e3) {
   }
 }
 function readAllPersistedSyncWorkspaceIds(stateDir) {
-  const dir = join25(stateDir, "passengers");
+  const dir = join26(stateDir, "passengers");
   if (!existsSync25(dir)) return [];
   const suffix = "-sync.json";
   return readdirSync8(dir).filter((f) => f.endsWith(suffix)).map((f) => f.slice(0, -suffix.length));
@@ -13791,11 +13900,11 @@ function syncPassengerSyncDaemons(plans, cfg, stateDir, deps = {}) {
 
 // src/daemon.ts
 import { existsSync as existsSync27, mkdirSync as mkdirSync13, readFileSync as readFileSync20, readdirSync as readdirSync10, rmSync as rmSync10, statSync as statSync8, writeFileSync as writeFileSync14 } from "fs";
-import { join as join27 } from "path";
+import { join as join28 } from "path";
 
 // src/interrupted.ts
 import { existsSync as existsSync26, readdirSync as readdirSync9, readFileSync as readFileSync19 } from "fs";
-import { join as join26 } from "path";
+import { join as join27 } from "path";
 var INTERRUPTED_MARKER = calloutHeader("NOTE", "Interrupted");
 function interruptedComment(b) {
   const tree = b.dirty === null ? "The worktree could not be checked." : b.dirty ? "The worktree has uncommitted changes \u2014 they are this seat's own, from that run." : "The worktree is clean.";
@@ -13822,13 +13931,13 @@ function runFinished(streamPath) {
   }
 }
 function orphanedStreams(o) {
-  const dir = join26(o.stateDir, "streams");
+  const dir = join27(o.stateDir, "streams");
   if (!existsSync26(dir)) return [];
   const ownerAlive = o.isOwnerAlive ?? pidAlive;
   const out = [];
   for (const name of readdirSync9(dir)) {
     if (!name.endsWith(".jsonl") || name.endsWith(".events.jsonl")) continue;
-    const streamPath = join26(dir, name);
+    const streamPath = join27(dir, name);
     if (runFinished(streamPath)) continue;
     const sidecar = readRunSidecar(streamPath);
     if (!sidecar || sidecar.route !== o.routeLabel) continue;
@@ -13928,7 +14037,7 @@ function latestMtime(path) {
   if (!stat.isDirectory()) return 0;
   let latest = stat.mtimeMs;
   for (const entry of readdirSync10(path, { withFileTypes: true })) {
-    latest = Math.max(latest, latestMtime(join27(path, entry.name)));
+    latest = Math.max(latest, latestMtime(join28(path, entry.name)));
   }
   return latest;
 }
@@ -13940,10 +14049,10 @@ function makeStaleChecker(paths, opts = {}) {
   return () => computeTreeSignature(paths) !== initial || opts.reloadSentinel !== void 0 && existsSync27(opts.reloadSentinel);
 }
 function reloadSentinelFor(stateDir) {
-  return join27(stateDir, "reload-requested");
+  return join28(stateDir, "reload-requested");
 }
 function daemonStampFor(stateDir) {
-  return join27(stateDir, "daemon.started");
+  return join28(stateDir, "daemon.started");
 }
 function noteDaemonStarted(stateDir, now = Date.now()) {
   mkdirSync13(stateDir, { recursive: true });
@@ -14309,7 +14418,7 @@ async function buildEnvironment(route, ship, ticket) {
 }
 
 // src/cli.ts
-var CREW_HOME = isCompiledBinary(import.meta.url) ? dirname14(process.execPath) : resolve5(dirname14(fileURLToPath(import.meta.url)), "..");
+var CREW_HOME = isCompiledBinary(import.meta.url) ? dirname15(process.execPath) : resolve5(dirname15(fileURLToPath(import.meta.url)), "..");
 var RELEASE_LOCK_TTL_MS = 20 * 60 * 1e3;
 var CYCLE_SECONDS2 = 120;
 var STALE_CYCLES = 3;
@@ -14442,6 +14551,7 @@ function usage() {
   crew reload                    make the running daemon re-read crew.yaml (--now: restart it immediately)
   crew doctor [route] [--fix]    preflight; --fix enables clean routes and offers crew install
   crew selftest [route] [--toolchain NAME] [--json]   launch each toolchain as a run would and prove it reaches the tracker
+  crew sample-ticket [route] [--remove] [--dry-run] [--json]   file one ticket on a throwaway repo that walks the dev, QA and release loop
   crew ports [route]             which checkout owns which ports, and what is up
   crew reap [route]              kill orphaned servers, drop worktrees for closed tickets
   crew drop [route] NNN          remove a merged ticket's worktree and branch
@@ -14865,7 +14975,7 @@ if (command === "passenger-sync-daemon") {
     }
     if (host === "linux" && hasSystemd) {
       const label = labelFor(CREW_HOME, "run");
-      const staleTimer = join28(homedir8(), ".config", "systemd", "user", `${label}.timer`);
+      const staleTimer = join29(homedir8(), ".config", "systemd", "user", `${label}.timer`);
       if (existsSync28(staleTimer)) {
         process.stdout.write(
           `removing stale run timer from before the persistent-service cutover: ${staleTimer}${dryRun ? " (dry run)" : ""}
@@ -15923,7 +16033,7 @@ ${changed2.map((c) => `  - ${c}
         process.exit(1);
       }
       requireArmed("run the daemon loop");
-      const watchPaths = isCompiledBinary(import.meta.url) ? [process.execPath] : [join28(CREW_HOME, "src"), join28(CREW_HOME, "dist"), join28(CREW_HOME, "bin")];
+      const watchPaths = isCompiledBinary(import.meta.url) ? [process.execPath] : [join29(CREW_HOME, "src"), join29(CREW_HOME, "dist"), join29(CREW_HOME, "bin")];
       const configPaths = daemonConfigPaths(cfg);
       watchPaths.push(...configPaths);
       noteDaemonStarted(cfg.ship.stateDir);
@@ -16228,7 +16338,7 @@ ${changed2.map((c) => `  - ${c}
       }
       const originOf = (dir) => gitOk(dir, ["remote", "get-url", "origin"]) ?? void 0;
       const text = configText;
-      const base = dirname14(cfg.configFile);
+      const base = dirname15(cfg.configFile);
       try {
         if (sub === "list") {
           const repos = configuredRepos(text, routeName, base);
@@ -16752,7 +16862,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
           process.stderr.write(`(dry run) would write resolved ids to ${resolvedPath}
 `);
         } else {
-          mkdirSync14(dirname14(resolvedPath), { recursive: true });
+          mkdirSync14(dirname15(resolvedPath), { recursive: true });
           if (hadPreviousFile) copyFileSync2(resolvedPath, `${resolvedPath}.bak`);
           const tmpPath = `${resolvedPath}.tmp${process.pid}`;
           writeFileSync15(tmpPath, `${JSON.stringify(resolved, null, 2)}
@@ -16790,7 +16900,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
             process.stderr.write(`(dry run) would write the minted API key to ${apiKeyFile}
 `);
           } else {
-            mkdirSync14(dirname14(apiKeyFile), { recursive: true });
+            mkdirSync14(dirname15(apiKeyFile), { recursive: true });
             writeFileSync15(apiKeyFile, `${apiKeyVar}=${apiKey}
 `, { mode: 384 });
             process.stderr.write(`API key written to ${apiKeyFile}
@@ -16800,7 +16910,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
         const keyPersisted = keychainBacked || apiKeyFile !== void 0;
         const wizard = firstRun;
         const writeFirstRun = wizard !== void 0 && !dryRun && keyPersisted;
-        const routeDir = value("dir") ?? (writeFirstRun ? join28(DEFAULT_REPOS_BASE_PATH, found.workspaceSlug) : void 0);
+        const routeDir = value("dir") ?? (writeFirstRun ? join29(DEFAULT_REPOS_BASE_PATH, found.workspaceSlug) : void 0);
         const routeBlock = renderConnection(
           found,
           route2,
@@ -17431,6 +17541,121 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
       }
       break;
     }
+    case "sample-ticket": {
+      const json = flag("json");
+      const say = (event, extra, human) => process.stdout.write(json ? `${JSON.stringify({ event, ...extra })}
+` : `${human}
+`);
+      const fail = (msg) => {
+        if (json) process.stdout.write(`${JSON.stringify({ event: "error", message: msg })}
+`);
+        else process.stderr.write(`crew sample-ticket: ${msg}
+`);
+        return process.exit(2);
+      };
+      if (!route.resolved) fail(`route ${route.route} is not connected \u2014 run \`crew connect\` first`);
+      const tracker = new Tracker(route, cfg.ship);
+      const configText = readFileSync21(cfg.configFile, "utf8");
+      const cfgBase = dirname15(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]);
+      const resolvedFile = resolvedPathFor(cfg.ship.stateDir, route.route);
+      const rows = await tracker.repoRows();
+      const row = rows.find((r) => r.name === SAMPLE_REPO);
+      if (flag("remove")) {
+        const closed = [];
+        if (row) {
+          const wontFix = tracker.contract.statuses.wontFix;
+          const resolved = new Set(tracker.contract.statuses.resolved);
+          for (const t of await tracker.ticketsForRepo(row.id)) {
+            if (resolved.has(t.status) || !isSampleTicket(t.description)) continue;
+            if (!dryRun) {
+              await tracker.updateTicket(t.id, {
+                [tracker.contract.columns.status]: wontFix,
+                [tracker.contract.columns.resolutionNote]: "Sample ticket removed by `crew sample-ticket --remove`; obsolete."
+              });
+            }
+            closed.push(t.issue_tag ?? t.issue_id);
+          }
+        }
+        if (dryRun) {
+          say("dry-run", { dir, row: row?.id ?? null, closed }, `would close ${closed.join(", ") || "no tickets"}, delete the Repos row, detach and delete ${dir}`);
+          break;
+        }
+        if (configured.some((r) => r.dir === dir)) {
+          try {
+            writeFileSync15(cfg.configFile, planRepoRemove(configText, cfgBase, route.route, dir).text);
+          } catch (e) {
+            if (e instanceof ReposError) fail(e.message);
+            throw e;
+          }
+        }
+        if (row) {
+          await tracker.deleteRepoRow(row.id);
+          if (existsSync28(resolvedFile)) {
+            const raw = JSON.parse(readFileSync21(resolvedFile, "utf8"));
+            if (raw.repoNames) delete raw.repoNames[row.id];
+            if (raw.repoRemotes) delete raw.repoRemotes[row.id];
+            writeFileSync15(resolvedFile, `${JSON.stringify(raw, null, 2)}
+`);
+          }
+        }
+        if (existsSync28(join29(dir, ".git")) && basename10(dir) === SAMPLE_REPO) rmSync11(dir, { recursive: true, force: true });
+        say("removed", { dir, closed }, `removed the sample repo${closed.length ? `, closed ${closed.join(", ")}` : ""}`);
+        break;
+      }
+      const projectId = route.resolved.areaId ?? resolveRepoProject(await tracker.projectRows(), value("project"));
+      const fresh = !existsSync28(join29(dir, ".git"));
+      if (existsSync28(dir) && fresh && readdirSync11(dir).length > 0) fail(`${dir} exists and is not a git checkout \u2014 move it aside`);
+      if (dryRun) {
+        say("dry-run", { dir, newCheckout: fresh, repoRow: row?.id ?? null }, `would ${fresh ? "create" : "reuse"} ${dir}${row ? "" : ", create the Repos row"}, and file one ${tracker.contract.statuses.approved} ticket`);
+        break;
+      }
+      if (fresh) {
+        mkdirSync14(dir, { recursive: true });
+        writeFileSync15(join29(dir, "README.md"), SAMPLE_README);
+        writeFileSync15(join29(dir, ".crew.yaml"), SAMPLE_CREW_YAML);
+        const g = (...a) => {
+          const r = spawnSync6("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");
+        g("add", ".");
+        g("-c", "user.name=crew", "-c", "user.email=crew@localhost", "commit", "-m", "Initial commit");
+      }
+      let repoId = row?.id;
+      if (!repoId) {
+        const payload = planRepoRow({
+          name: SAMPLE_REPO,
+          origin: SAMPLE_REMOTE,
+          projectId,
+          spec: { platform: "unix", releaseMode: "integrate", ciProvider: "none" }
+        });
+        repoId = (await tracker.createRepoRow(payload)).id;
+        if (existsSync28(resolvedFile)) {
+          const raw = JSON.parse(readFileSync21(resolvedFile, "utf8"));
+          raw.repoNames = { ...raw.repoNames, [repoId]: SAMPLE_REPO };
+          raw.repoRemotes = { ...raw.repoRemotes, [repoId]: SAMPLE_REMOTE };
+          writeFileSync15(resolvedFile, `${JSON.stringify(raw, null, 2)}
+`);
+        }
+      }
+      if (!configured.some((r) => r.dir === dir)) {
+        try {
+          writeFileSync15(cfg.configFile, planRepoAdd({ text: configText, base: cfgBase, route: route.route, path: dir, name: SAMPLE_REPO }).text);
+        } catch (e) {
+          if (e instanceof ReposError) fail(e.message);
+          throw e;
+        }
+      }
+      const ticket = await tracker.fileTicket(
+        planSampleTicket({ projectId, repoId, approvedStatus: tracker.contract.statuses.approved }),
+        route.resolved.seats.dev ?? ""
+      );
+      const tag = ticket.issue_tag ?? ticket.issue_id;
+      say("filed", { ticket: tag, id: ticket.id, dir, repoId }, `filed ${tag} against ${dir}; follow it with \`crew watch\``);
+      break;
+    }
     case "selftest": {
       const wanted = value("toolchain");
       const all = shipToolchains(cfg.ship);
@@ -17609,7 +17834,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>` : `${basename9(r.dir.replace(/[/\\]+$/, ""))}-<branch>`),
+              worktreeDirPattern: r.config.worktrees.name ?? (r.config.provenance["worktrees.prefix"] !== "default" ? `${r.config.worktrees.prefix}<number>` : `${basename10(r.dir.replace(/[/\\]+$/, ""))}-<branch>`),
               worktreeParent: resolvePath(r.dir, "..")
             })),
             waiting: waiting ? { ticket: waiting.ticket, since: waiting.since, streak: fairness.streak() } : null
@@ -17742,7 +17967,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>` : `${basename9(r.dir.replace(/[/\\]+$/, ""))}-${effectiveBranchTemplate(config, void 0)}`);
+        const worktreePattern = config.worktrees.name ?? (config.provenance["worktrees.prefix"] !== "default" ? `${config.worktrees.prefix}<number>` : `${basename10(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.57.0",
+  "version": "0.58.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",