@tablation/crew 0.72.3 → 0.73.0

package/README.md

@@ -263,7 +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 hooks [ROUTE] NAME  suggest test/build hooks for a checkout (--write route|repo writes them, --recipes, --hook KEY=CMD, --agent, --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

@@ -8692,6 +8692,7 @@ var VALUE_FLAGS = /* @__PURE__ */ new Set([
   "area",
   "base-url",
   "choose",
+  "clear",
   "dir",
   "extra-path",
   "harness",
@@ -14363,7 +14364,7 @@ function repoDirOf(text, base, route, name) {
   }
   return hit.dir;
 }
-function planRouteHooks(text, route, name, hooks) {
+function planRouteHooks(text, route, name, hooks, opts = {}) {
   const doc = parseDocument3(text);
   if (doc.errors.length > 0) throw new ReposError(`config is not valid YAML \u2014 ${doc.errors[0].message}`);
   const m = routeMapOf(doc, route);
@@ -14388,15 +14389,34 @@ function planRouteHooks(text, route, name, hooks) {
   }
   const written = [];
   const kept = [];
+  const replaced = [];
   for (const [k, v] of Object.entries(hooks)) {
     if (v === void 0) continue;
-    if (hooksMap.has(k)) kept.push(k);
+    if (hooksMap.has(k) && !opts.replace) kept.push(k);
     else {
+      if (hooksMap.has(k)) replaced.push(k);
       hooksMap.set(k, v);
       written.push(k);
     }
   }
-  return { text: String(doc), written, kept };
+  return { text: String(doc), written, kept, replaced };
+}
+function clearRouteHooks(text, route, name) {
+  const doc = parseDocument3(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 repos = m.get("repos", true);
+  let target = m;
+  if (isMap2(repos)) {
+    const entry = repos.get(name, true);
+    if (!isMap2(entry)) return { text, removed: [] };
+    target = entry;
+  }
+  const current = target.get("hooks", true);
+  if (!isMap2(current)) return { text, removed: [] };
+  const removed = current.items.map((i) => String(i.key.value ?? i.key));
+  target.delete("hooks");
+  return { text: String(doc), removed };
 }
 function starterRepoConfig(hooks, release) {
   const lines = [
@@ -18358,7 +18378,7 @@ ${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] [--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 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();
@@ -18384,6 +18404,10 @@ ${changed2.map((c) => `  - ${c}
           const suggestion = suggestHooks(files);
           const write = value("write");
           if (write !== void 0 && write !== "route" && write !== "repo") throw new ReposError(`--write takes "route" or "repo" (got "${write}")`);
+          const clear2 = value("clear");
+          if (clear2 !== void 0 && clear2 !== "route") throw new ReposError(`--clear takes "route" (got "${clear2}")`);
+          if (clear2 && (write || flag("suggest") || flag("agent"))) throw new ReposError("--clear cannot be combined with --write, --suggest or --agent");
+          if (flag("replace") && write !== "route") throw new ReposError("--replace only applies with --write route");
           const recipeIds = (value("recipes") ?? "").split(",").map((x) => x.trim()).filter((x) => x && x !== "none");
           if (recipeIds.length > 0 && !write) throw new ReposError("--recipes only applies with --write route|repo");
           if (flag("agent") && write) throw new ReposError("--agent is read-only; drop --write (write the sniffed hooks, then re-run --agent to compare)");
@@ -18411,20 +18435,26 @@ ${changed2.map((c) => `  - ${c}
           const base2 = selectRecipes(suggestion, recipeIds);
           const picked = { ...base2, hooks: { ...base2.hooks, ...overrides } };
           let written;
+          let cleared;
+          if (clear2) {
+            const plan = clearRouteHooks(configText, a.route, a.name);
+            if (plan.removed.length > 0) writeFileSync23(cfg.configFile, plan.text);
+            cleared = { file: cfg.configFile, removed: plan.removed };
+          }
           if (write && suggestion.source === null && recipeIds.length === 0 && hookSpecs.length === 0) throw new ReposError(`nothing to write: ${suggestion.notes[0]}`);
           if (write === "route") {
-            const plan = planRouteHooks(configText, a.route, a.name, picked.hooks);
+            const plan = planRouteHooks(configText, a.route, a.name, picked.hooks, { replace: flag("replace") });
             writeFileSync23(cfg.configFile, plan.text);
-            written = { target: "route", file: cfg.configFile, hooks: plan.written, kept: plan.kept };
+            written = { target: "route", file: cfg.configFile, hooks: plan.written, kept: plan.kept, replaced: plan.replaced };
           } else if (write === "repo") {
             const have = existingRepoConfig(files);
             if (have) throw new ReposError(`${resolvePath(dir, have)} already exists; not overwriting it`);
             const file = resolvePath(dir, ".crew.yaml");
             writeFileSync23(file, starterRepoConfig(picked.hooks, picked.release), { flag: "wx" });
-            written = { target: "repo", file, hooks: Object.keys(picked.hooks), kept: [] };
+            written = { target: "repo", file, hooks: Object.keys(picked.hooks), kept: [], replaced: [] };
           }
           if (flag("json")) {
-            process.stdout.write(`${JSON.stringify({ route: a.route, repo: a.name, dir, ...suggestion, agent, agentError, written: written ?? null })}
+            process.stdout.write(`${JSON.stringify({ route: a.route, repo: a.name, dir, ...suggestion, agent, agentError, written: written ?? null, cleared: cleared ?? null })}
 `);
           } else {
             if (suggestion.source) process.stdout.write(`${a.name}: proposed from ${suggestion.source}
@@ -18445,8 +18475,12 @@ ${changed2.map((c) => `  - ${c}
             }
             if (agentError) process.stderr.write(`crew repos: --agent failed (${agentError.reason}): ${agentError.message}
 `);
+            if (cleared) process.stdout.write(cleared.removed.length ? `removed route hooks ${cleared.removed.join(", ")} from ${cleared.file}
+` : "no route hooks to remove\n");
             if (written) {
               process.stdout.write(`wrote ${written.hooks.join(", ") || "nothing new"} to ${written.file}
+`);
+              if (written.replaced.length) process.stdout.write(`replaced route hooks: ${written.replaced.join(", ")}
 `);
               if (written.kept.length) process.stdout.write(`kept existing route hooks: ${written.kept.join(", ")}
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tablation/crew",
-  "version": "0.72.3",
+  "version": "0.73.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",