@tablation/crew 0.115.0 → 0.116.0

package/dist/cli.js

@@ -2382,6 +2382,7 @@ var HOOK_NAMES = [
   "isolate",
   "handoff",
   "preview",
+  "map",
   "ci_status",
   "version",
   "bump",
@@ -3014,6 +3015,7 @@ var ConfigError = class extends Error {
 };
 var DEFAULT_MAX_PERISCOPES = 3;
 var DEFAULT_PERISCOPE_IDLE_MINUTES = 120;
+var DEFAULT_MAP_TOKEN_BUDGET = 1e3;
 function parseCloneScheme(v) {
   if (v === void 0 || v === null || v === "") return void 0;
   if (v === "ssh" || v === "https") return v;
@@ -3106,6 +3108,7 @@ var SHIP_KEYS = /* @__PURE__ */ new Set([
   "previewHost",
   "maxPeriscopes",
   "periscopeIdleMinutes",
+  "mapTokenBudget",
   "secretStore",
   "env",
   "runner",
@@ -3454,6 +3457,10 @@ Create the first of those:
   if (!Number.isInteger(periscopeIdleMinutes) || periscopeIdleMinutes < 1) {
     missing.add(`ship.periscopeIdleMinutes must be a positive integer (got "${shipRaw.periscopeIdleMinutes}")`);
   }
+  const mapTokenBudget = shipRaw.mapTokenBudget === void 0 ? DEFAULT_MAP_TOKEN_BUDGET : Number(shipRaw.mapTokenBudget);
+  if (!Number.isInteger(mapTokenBudget) || mapTokenBudget < 1) {
+    missing.add(`ship.mapTokenBudget must be a positive integer (got "${shipRaw.mapTokenBudget}")`);
+  }
   const secretStoreRaw = shipRaw.secretStore === void 0 ? "auto" : shipRaw.secretStore;
   if (!isSecretStoreMode(secretStoreRaw)) {
     missing.add(`ship.secretStore must be one of ${SECRET_STORE_MODES.join(" | ")} (got "${String(shipRaw.secretStore)}")`);
@@ -3537,6 +3544,7 @@ Create the first of those:
       previewHost: shipRaw.previewHost ? String(shipRaw.previewHost).trim() || void 0 : void 0,
       maxPeriscopes,
       periscopeIdleMinutes,
+      mapTokenBudget,
       secretStore,
       env: parseShipEnv(shipRaw.env)
     },
@@ -4039,6 +4047,7 @@ function runScript(script, opts) {
       stdio: ["ignore", "pipe", "pipe"]
     });
     let output = "";
+    let stdout = "";
     let pending = "";
     const absorb = (buf) => {
       const text2 = buf.toString();
@@ -4049,18 +4058,21 @@ function runScript(script, opts) {
       pending = lines2.pop() ?? "";
       for (const l of lines2) opts.onLine(l);
     };
-    child.stdout.on("data", absorb);
+    child.stdout.on("data", (buf) => {
+      stdout += buf.toString();
+      absorb(buf);
+    });
     child.stderr.on("data", absorb);
     const timer = opts.timeoutMs ? setTimeout(() => child.kill("SIGKILL"), opts.timeoutMs) : void 0;
     child.on("error", (err3) => {
       if (timer) clearTimeout(timer);
       resolvePromise({ code: 127, output: `${output}
-crew: cannot run ${shell.bin}: ${err3.message}` });
+crew: cannot run ${shell.bin}: ${err3.message}`, stdout });
     });
     child.on("close", (code) => {
       if (timer) clearTimeout(timer);
       if (pending && opts.onLine) opts.onLine(pending);
-      resolvePromise({ code: code ?? 1, output });
+      resolvePromise({ code: code ?? 1, output, stdout });
     });
   });
 }
@@ -6280,6 +6292,7 @@ var HOOK_PURPOSE = [
   ["ports", "this worktree's port assignments; prints KEY=value overrides to export"],
   ["handoff", "leave the operator able to open what you built; put its output in your progress comment"],
   ["preview", "start this worktree's dev server for a viewer, bound to CREW_PREVIEW_HOST, detached; its last stdout line is the URL"],
+  ["map", 'prints an outline of the repository; the crew places it under "Repository map" below'],
   ["test", "run the suite"],
   ["build", "build it"],
   ["ci_status", "after you push and before you hand off: exit 0 means CI is green for your branch; on failure fix and push again, and say in your progress comment if it is still pending"]
@@ -6376,6 +6389,13 @@ function repoSection(r, key, heading) {
   }
   return lines2;
 }
+function mapSection(r, heading) {
+  if (r.map) return ["", heading, "", r.map, ""];
+  if (r.mapSkipped) {
+    return ["", `Note: ${r.mapSkipped}. Say so in one line of your progress comment; it does not block the work.`, ""];
+  }
+  return [];
+}
 function renderEnvironment(i) {
   const { route: route2, contract } = i;
   const repos = i.repos;
@@ -6567,12 +6587,16 @@ function renderEnvironment(i) {
     for (const r of repos) {
       lines2.push(...i.sandbox ? ["", `### ${r.name}`] : repoSection(r, key, `### ${r.name} \u2014 \`${r.dir}\``));
       lines2.push("", `Hooks for ${r.name} \u2014 the only commands you should run here:`, "", hookTable(r.config));
+      lines2.push(...mapSection(r, `#### Repository map \u2014 ${r.name}`));
     }
   }
   if (i.repoDir) {
     lines2.push("", `This ticket's work happens in \`${i.repoDir}\`.`);
   }
-  if (only) lines2.push("", "## Hooks \u2014 the only commands you should run", "", hookTable(only.config));
+  if (only) {
+    lines2.push("", "## Hooks \u2014 the only commands you should run", "", hookTable(only.config));
+    lines2.push(...mapSection(only, "## Repository map"));
+  }
   return lines2.join("\n");
 }
 
@@ -17764,6 +17788,49 @@ async function mergeAndRelease(o, decision, fresh, releaseBranch, isolated = fal
   return { merged, conflicts, unbuildable, version, tag, deployed, integrated, confirmed, decision };
 }
 
+// src/repo-map.ts
+var CHARS_PER_TOKEN = 4;
+var MAP_TIMEOUT_MS = 6e4;
+function budgetMap(text2, tokenBudget) {
+  const body = text2.replace(/\s+$/, "");
+  const limit = tokenBudget * CHARS_PER_TOKEN;
+  if (body.length <= limit) return body;
+  const lines2 = body.split("\n");
+  const noteFor = (kept2) => `\u2026 ${lines2.length - kept2} of ${lines2.length} lines cut to fit ship.mapTokenBudget (${tokenBudget} tokens)`;
+  let kept = lines2.length;
+  let size = body.length;
+  while (kept > 0 && size + 1 + noteFor(kept).length > limit) {
+    kept--;
+    size -= lines2[kept].length + 1;
+  }
+  return [...lines2.slice(0, kept), noteFor(kept)].join("\n");
+}
+function loadRepoMap(repo, tokenBudget, shellFallback) {
+  const script = repo.config.hooks.map;
+  if (!script) return Promise.resolve({ skipped: "" });
+  return runScript(script, {
+    cwd: repo.dir,
+    shell: resolveShell(repo.config.shell ?? shellFallback),
+    env: { CREW_REPO: repo.name },
+    timeoutMs: MAP_TIMEOUT_MS
+  }).then(
+    (r) => {
+      if (r.code !== 0) return { skipped: `the \`map\` hook for ${repo.name} exited ${r.code}, so the brief has no repository map` };
+      if (!r.stdout.trim()) return { skipped: `the \`map\` hook for ${repo.name} printed nothing, so the brief has no repository map` };
+      return { text: budgetMap(r.stdout, tokenBudget) };
+    },
+    (e) => ({ skipped: `the \`map\` hook for ${repo.name} could not run (${e instanceof Error ? e.message : String(e)}), so the brief has no repository map` })
+  );
+}
+async function withRepoMaps(repos, tokenBudget, shellFallback) {
+  return Promise.all(repos.map(async (r) => {
+    if (!r.config.hooks.map) return r;
+    const out = await loadRepoMap(r, tokenBudget, shellFallback);
+    if ("skipped" in out) return out.skipped ? { ...r, mapSkipped: out.skipped } : r;
+    return { ...r, map: out.text };
+  }));
+}
+
 // src/failure-alert.ts
 var FAILURE_ALERT_MARKER = calloutHeader("CAUTION", "Failure Alert");
 function findOpenFailureAlert(tickets, headline) {
@@ -21971,7 +22038,7 @@ async function buildEnvironment(route2, ship, ticket) {
   });
   const authorship = await tracker.authorshipProbe().catch(() => null);
   const attachments = await tracker.attachmentsProbe().catch(() => null);
-  return renderEnvironment({ route: route2, userAgent: ship.userAgent, repos, contract, sourceTicket: ticket, authorship, attachments, shipName: ship.name, ...sandboxEnv(ship) });
+  return renderEnvironment({ route: route2, userAgent: ship.userAgent, repos: await withRepoMaps(repos, ship.mapTokenBudget, ship.shell), contract, sourceTicket: ticket, authorship, attachments, shipName: ship.name, ...sandboxEnv(ship) });
 }
 
 // src/control-api.ts
@@ -24137,7 +24204,7 @@ ${changed2.map((c) => `  - ${c}
     return renderEnvironment({
       route: c,
       userAgent: cfg.ship.userAgent,
-      repos: await resolvedRepos(c),
+      repos: await withRepoMaps(await resolvedRepos(c), cfg.ship.mapTokenBudget, cfg.ship.shell),
       contract,
       sourceTicket: ticket,
       authorship: await tracker.authorshipProbe().catch(() => null),

package/package.json

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