@nanopm/cli 0.1.8 → 0.1.11

package/dist/index.js

@@ -156,7 +156,8 @@ var NEEDS_GO_AHEAD = /* @__PURE__ */ new Set(["execute_after_validation"]);
 function requiresGoAhead(autonomy2) {
   return NEEDS_GO_AHEAD.has(autonomy2);
 }
-function capCapabilities(requested, autonomy2) {
+function capCapabilities(requested, autonomy2, opts = {}) {
+  if (opts.asked) return [...requested];
   const denied = CAPPED_BELOW[autonomy2];
   const granted = requested.filter((c) => !denied.has(c));
   if (granted.includes("write_repo") && requiresGoAhead(autonomy2) && !granted.includes("ask_user")) {
@@ -387,6 +388,12 @@ var SkillManifestSchema = z2.object({
     },
     { message: "timeout_deep must look like 3h, 5m, 90s" }
   ).optional(),
+  /**
+   * Run only when the founder asks for it on one item, by a click or a command, never by Nano on
+   * its own: the autonomy dial, which governs what Nano does unasked, does not cap it
+   * (`capCapabilities`). A build is the one today (docs/⏳nanopm-75-build-it.md, settled 2).
+   */
+  asked: z2.boolean().default(false),
   /** The first user message sent to the harness, unless the job params provide one. */
   prompt: z2.string().min(1),
   /**
@@ -628,14 +635,6 @@ var SECRET_PATTERNS = [
   "**/credentials.json",
   "**/service-account*.json"
 ];
-function looksLikeASecret(path) {
-  const base = path.replace(/\\/g, "/").split("/").pop() ?? "";
-  return SECRET_PATTERNS.some((pattern) => {
-    const glob = pattern.replace(/^\*\*\//, "");
-    const re = new RegExp(`^${glob.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*")}$`);
-    return re.test(base);
-  });
-}
 
 // ../shared/src/stream.ts
 function formatStreamEvent(event) {
@@ -944,7 +943,7 @@ var AFTER_DEEP = {
 function daemonQueues(skill, depth = 0, parent = null, deep = false) {
   if (deep) return depth >= CHAIN_DEPTH_MAX ? [] : AFTER_DEEP[skill] ?? [];
   const theirs = new Set(SQL_OWNED[skill] ?? []);
-  return chainedAfter(skill, depth, parent).filter((next2) => !theirs.has(next2));
+  return chainedAfter(skill, depth, parent).filter((next) => !theirs.has(next));
 }
 var NOT_CHAINED_BY_DAEMON = ["ingest"];
 var CHAIN_DEPTH_MAX = 3;
@@ -954,7 +953,7 @@ function chainedAfter(skill, depth = 0, parent = null) {
   const gates = ONLY_AFTER[skill] ?? {};
   const bars2 = NEVER_AFTER[skill] ?? {};
   return (CHAINED[skill] ?? []).filter(
-    (next2) => (!gates[next2] || parent !== null && gates[next2].includes(parent)) && !(parent !== null && bars2[next2]?.includes(parent))
+    (next) => (!gates[next] || parent !== null && gates[next].includes(parent)) && !(parent !== null && bars2[next]?.includes(parent))
   );
 }
 var CHAINED_SKILLS = [...new Set(Object.values(CHAINED).flatMap((s) => s ?? []))];
@@ -974,7 +973,7 @@ var SKILL_SENTENCE = {
   direction: "working out where this is going",
   solutions: "proposing options",
   review: "reviewing",
-  next: "building",
+  build: "building",
   ask: "answering a question",
   want: "shaping what you want",
   ingest: "watching the numbers",
@@ -982,22 +981,22 @@ var SKILL_SENTENCE = {
   spec: "writing specs"
 };
 function skillSentence(skill, opts = {}) {
-  if (skill === "next") return opts.ref ? `building ${opts.ref}` : "building an option";
+  if (skill === "build") return opts.ref ? `building ${opts.ref}` : "building an option";
   return SKILL_SENTENCE[skill] ?? `running ${skill}`;
 }
 
 // ../shared/src/time.ts
 var DAYS = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
 function describeNextRun(schedule, now = /* @__PURE__ */ new Date(), opts = {}) {
-  const next2 = new Date(schedule.next_due_at);
+  const next = new Date(schedule.next_due_at);
   const local = new Intl.DateTimeFormat("en-GB", {
     timeZone: schedule.timezone,
     weekday: "long",
     hour: "2-digit",
     minute: "2-digit",
     hour12: false
-  }).format(next2);
-  const hours = Math.round((next2.getTime() - now.getTime()) / 36e5);
+  }).format(next);
+  const hours = Math.round((next.getTime() - now.getTime()) / 36e5);
   const when = hours < 1 ? "any minute" : hours < 36 ? `in ${hours}h` : `in ${Math.round(hours / 24)} days`;
   return opts.timezone === false ? `${local}, ${when}` : `${local} ${schedule.timezone}, ${when}`;
 }
@@ -2018,10 +2017,10 @@ function placeRanks(crew, pinned) {
     while (slots[at] !== null && at > 0) at -= 1;
     slots[at] = id;
   }
-  let next2 = 0;
+  let next = 0;
   for (let i = 0; i < total; i += 1) {
     if (slots[i] !== null) continue;
-    slots[i] = loose[next2++] ?? null;
+    slots[i] = loose[next++] ?? null;
   }
   const out = /* @__PURE__ */ new Map();
   slots.forEach((id, i) => id && out.set(id, i + 1));
@@ -2672,7 +2671,7 @@ import { z as z9 } from "zod";
 var PITCH_LINE_KEYS = ["what", "who", "need"];
 var PITCH_TOPIC = "identity";
 var PITCH_KEY = /^pitch-/;
-var pitchKey = (line, next2 = false) => `pitch-${line}${next2 ? "-next" : ""}`;
+var pitchKey = (line, next = false) => `pitch-${line}${next ? "-next" : ""}`;
 var PITCH_LINE_TITLE = { what: "What it is", who: "Who it is for", need: "What they come for" };
 
 // ../shared/src/pitch-crew.ts
@@ -2724,7 +2723,7 @@ var DIRECTION_ROWS = ["mission", "vision"];
 var MISSION_TOPIC = "mission";
 var VISION_TOPIC = "vision";
 var DIRECTION_KEY = /^(?:mission|vision)(?:-next)?$/;
-var directionKey = (row, next2 = false) => `${row}${next2 ? "-next" : ""}`;
+var directionKey = (row, next = false) => `${row}${next ? "-next" : ""}`;
 var DIRECTION_ROW_TITLE = { mission: "Mission", vision: "Vision" };
 
 // ../shared/src/direction-crew.ts
@@ -3483,7 +3482,7 @@ function foldRound(r) {
     }
   }
   const answer = TalkAnswer.safeParse(r.result);
-  const failed = r.status === "failed" || r.status === "cancelled";
+  const failed2 = r.status === "failed" || r.status === "cancelled";
   const error = r.error ?? {};
   return {
     id: r.id,
@@ -3494,8 +3493,8 @@ function foldRound(r) {
     depth: params.data.depth,
     actions: [...actions.values()],
     answer: answer.success ? answer.data : null,
-    state: r.status === "succeeded" ? "done" : failed ? "failed" : "working",
-    ...failed ? { error: error.code === "timeout" ? "That took too long. Send it again?" : r.status === "cancelled" ? "Stopped." : `I couldn\u2019t answer${error.message ? `: ${clip(error.message, 140)}` : "."}` } : {},
+    state: r.status === "succeeded" ? "done" : failed2 ? "failed" : "working",
+    ...failed2 ? { error: error.code === "timeout" ? "That took too long. Send it again?" : r.status === "cancelled" ? "Stopped." : `I couldn\u2019t answer${error.message ? `: ${clip(error.message, 140)}` : "."}` } : {},
     ...doing ? { doing } : {}
   };
 }
@@ -3522,7 +3521,7 @@ var PROBLEM_TOOLS = ["propose_problems", "add_evidence", "flag_duplicate", "file
 var READ_WEB_TOOLS = ["web_search", "web_fetch"];
 var STORE_TOOLS = ["app_store_search", "play_store_search"];
 var MARKET_TOOLS = ["write_market"];
-var WRITE_REPO_TOOLS = ["remove_files"];
+var BUILD_TOOLS = ["build_plan", "build_step"];
 var ALL_MEMORY_TOOLS = [
   ...MEMORY_READ_TOOLS,
   ...MEMORY_WRITE_TOOLS,
@@ -3532,7 +3531,7 @@ var ALL_MEMORY_TOOLS = [
   ...PROBLEM_TOOLS,
   ...READ_WEB_TOOLS,
   ...MARKET_TOOLS,
-  ...WRITE_REPO_TOOLS,
+  ...BUILD_TOOLS,
   ...TALK_TOOLS,
   "last_review",
   "list_problems",
@@ -3574,7 +3573,7 @@ function claudeCodeToolFlags(capabilities, opts = {}) {
       tools.add(t);
       allowed.add(`${t}(${pathRule(workspace)})`);
     }
-    for (const t of WRITE_REPO_TOOLS) allowed.add(mcpTool(t));
+    for (const t of BUILD_TOOLS) allowed.add(mcpTool(t));
   } else {
     for (const t of WRITE_TOOLS) disallowed.add(t);
   }
@@ -3632,7 +3631,7 @@ function claudeCodeToolFlags(capabilities, opts = {}) {
     allowed.delete(t);
     disallowed.add(t);
   }
-  return { tools: [...tools], allowedTools: [...allowed], disallowedTools: [...disallowed] };
+  return { tools: [...tools], allowedTools: [...allowed], disallowedTools: [...disallowed], permissionMode: tools.has("Bash") ? "auto" : "default" };
 }
 
 // ../daemon/src/adapters/claude-code/sandbox.ts
@@ -3674,10 +3673,18 @@ function buildSandboxSettings(home) {
   }
   return { permissions: { deny, defaultMode: "default" } };
 }
-function sandboxSettingsFor(home, grantedTools) {
+function sandboxSettingsFor(home, grantedTools, network = []) {
   const settings = buildSandboxSettings(home);
   const granted = new Set(grantedTools);
   settings.permissions.deny = settings.permissions.deny.filter((rule) => !granted.has(rule));
+  if (granted.has("Bash")) {
+    settings.sandbox = {
+      enabled: true,
+      allowUnsandboxedCommands: false,
+      failIfUnavailable: true,
+      network: { allowedDomains: network.filter((h) => !/(^|\.)github(usercontent)?\.com$/.test(h)) }
+    };
+  }
   return settings;
 }
 
@@ -3818,8 +3825,8 @@ function classifyExit(stderr, aborted) {
   if (t.includes("not logged in") || t.includes("invalid api key") || t.includes("authentication") || t.includes("subscription") || t.includes("please run /login") || t.includes("oauth")) {
     return { code: "auth", message: "Claude Code is not logged in on this machine. Run `claude login` or set ANTHROPIC_API_KEY." };
   }
-  const tail2 = stderr.trim().split("\n").slice(-3).join(" ").trim();
-  return { code: "harness_error", message: tail2 || "claude exited without a result" };
+  const tail = stderr.trim().split("\n").slice(-3).join(" ").trim();
+  return { code: "harness_error", message: tail || "claude exited without a result" };
 }
 
 // ../daemon/src/adapters/claude-code/index.ts
@@ -3856,10 +3863,10 @@ var ClaudeCodeAdapter = class {
       const result = parsePrintResult(stdout);
       return result?.is_error ? { ok: false, message: result.result ?? "claude reported an error" } : { ok: true, message: `claude answered in ${result?.subtype ?? "success"}` };
     } catch (err) {
-      const failed = err;
-      const reported = parsePrintResult(failed.stdout)?.result;
+      const failed2 = err;
+      const reported = parsePrintResult(failed2.stdout)?.result;
       if (reported) return { ok: false, message: reported };
-      const text2 = failed.stderr?.trim() || failed.message || String(err);
+      const text2 = failed2.stderr?.trim() || failed2.message || String(err);
       return { ok: false, message: classifyExit(text2, false).message };
     }
   }
@@ -3895,9 +3902,9 @@ var ClaudeCodeAdapter = class {
     child.stderr.on("data", (chunk) => {
       stderr += chunk.toString();
     });
-    const exit = new Promise((resolve6) => {
-      child.on("close", (code) => resolve6(code));
-      child.on("error", () => resolve6(127));
+    const exit = new Promise((resolve5) => {
+      child.on("close", (code) => resolve5(code));
+      child.on("error", () => resolve5(127));
     });
     const parser = new StreamParser();
     let searched = false;
@@ -3937,7 +3944,7 @@ var ClaudeCodeAdapter = class {
       "--append-system-prompt",
       spec2.systemPrompt,
       "--permission-mode",
-      "default",
+      flags.permissionMode,
       "--max-turns",
       String(spec2.maxTurns),
       "--setting-sources",
@@ -3986,7 +3993,7 @@ var ClaudeCodeAdapter = class {
     await writeFile2(mcpConfigPath, JSON.stringify({ mcpServers }), { mode: 384 });
     const settingsPath = join3(spec2.runDir, "settings.json");
     const flags = claudeCodeToolFlags(spec2.capabilities, { workspace: spec2.cwd, harnessWeb: spec2.harnessWeb, without: spec2.withoutTools });
-    await writeFile2(settingsPath, JSON.stringify(sandboxSettingsFor(spec2.env.HOME ?? "", flags.tools)), { mode: 384 });
+    await writeFile2(settingsPath, JSON.stringify(sandboxSettingsFor(spec2.env.HOME ?? "", flags.tools, spec2.network)), { mode: 384 });
     const child = spawn(this.claudePath, this.buildArgs(spec2, mcpConfigPath, settingsPath), {
       cwd: spec2.cwd,
       env: spec2.env,
@@ -4005,9 +4012,9 @@ var ClaudeCodeAdapter = class {
       stderr += chunk.toString();
       if (stderr.length > 64e3) stderr = stderr.slice(-32e3);
     });
-    const exit = new Promise((resolve6) => {
-      child.on("close", (code, signal) => resolve6({ code, signal }));
-      child.on("error", () => resolve6({ code: 127, signal: null }));
+    const exit = new Promise((resolve5) => {
+      child.on("close", (code, signal) => resolve5({ code, signal }));
+      child.on("error", () => resolve5({ code: 127, signal: null }));
     });
     const parser = new StreamParser(spec2.outputSchema !== void 0);
     try {
@@ -4042,10 +4049,10 @@ function parsePrintResult(stdout) {
 }
 
 // ../daemon/src/daemon.ts
-import { mkdir as mkdir5, readdir as readdir2, readFile as readFile7, rm as rm4, writeFile as writeFile4 } from "fs/promises";
+import { mkdir as mkdir6, readdir as readdir3, readFile as readFile9, rm as rm5, writeFile as writeFile6 } from "fs/promises";
 import { openSync, closeSync, unlinkSync, writeFileSync, readFileSync as readFileSyncNode, mkdirSync } from "fs";
 import { hostname as hostname2 } from "os";
-import { join as join11 } from "path";
+import { join as join13 } from "path";
 import { setTimeout as sleep } from "timers/promises";
 
 // ../daemon/src/awake.ts
@@ -4114,8 +4121,8 @@ async function installVersion(version, home = homedir2()) {
     });
     return { ok: true };
   } catch (err) {
-    const failed = err;
-    return { ok: false, why: (failed.stderr?.trim() || failed.message || String(err)).split("\n").slice(-3).join(" ") };
+    const failed2 = err;
+    return { ok: false, why: (failed2.stderr?.trim() || failed2.message || String(err)).split("\n").slice(-3).join(" ") };
   }
 }
 function autoUpdateOff(home = homedir2()) {
@@ -4177,15 +4184,15 @@ function stripLiterals(sql) {
   };
   while (i < n) {
     const c = sql[i];
-    const next2 = sql[i + 1];
-    if (c === "-" && next2 === "-") {
+    const next = sql[i + 1];
+    if (c === "-" && next === "-") {
       const end = sql.indexOf("\n", i);
       const stop2 = end === -1 ? n : end;
       blank(i, stop2);
       i = stop2;
       continue;
     }
-    if (c === "/" && next2 === "*") {
+    if (c === "/" && next === "*") {
       let depth = 1;
       let k = i + 2;
       while (k < n && depth > 0) {
@@ -5273,14 +5280,142 @@ async function sendDigestFor(client, accessToken, jobId, fetchImpl = fetch) {
 }
 
 // ../daemon/src/deploys.ts
+import { execFile as execFile4 } from "child_process";
+import { promisify as promisify4 } from "util";
+
+// ../daemon/src/repo.ts
 import { execFile as execFile3 } from "child_process";
+import { readFile as readFile2, rm as rm3, writeFile as writeFile4 } from "fs/promises";
+import { join as join5 } from "path";
+
+// ../shared/src/build.ts
+var BUILD_SKILL = "build";
+var BUILD_STEPS_MIN = 1;
+var BUILD_STEPS_MAX = 8;
+var BUILD_STEP_MAX = 120;
+var BUILD_RESUMES_MAX = 3;
+var BUILD_TRAILER = "Co-Authored-By: NanoPM <noreply@nanopm.app>";
+var BUILD_COLUMNS = "id, ref, title, status, actor, agent_spec, spec";
+function buildRefusal(solution, opts = {}) {
+  if (solution.actor === "founder") return `${solution.ref} is yours to do, not Nano's to build.`;
+  if (!["proposed", "accepted", "building"].includes(solution.status)) return `${solution.ref} is ${solution.status}: only a solution on the roadmap can be built.`;
+  if (!solution.agent_spec) return `${solution.ref} has no agent spec yet. Write its specs first: nanopm spec ${solution.ref} --write`;
+  const open = solution.spec?.questions?.length ?? 0;
+  if (open && !opts.anyway) {
+    return `${solution.ref} still has ${open} question${open === 1 ? "" : "s"} for you. Answer ${open === 1 ? "it" : "them"} in its spec, or build anyway: nanopm build ${solution.ref} --anyway`;
+  }
+  return null;
+}
+function stepsLeft(plan, done) {
+  return (plan ?? []).map((_, i) => i).filter((i) => !done.has(i));
+}
+function buildDir(home, jobId) {
+  return `${home.replace(/\/+$/, "")}/.cache/nanopm/builds/${jobId}`;
+}
+function buildBranch(ref, title) {
+  const slug = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40).replace(/-+$/, "");
+  return `nano/${ref.toLowerCase()}${slug ? `-${slug}` : ""}`;
+}
+var REGISTRIES = {
+  "package-lock.json": ["registry.npmjs.org"],
+  "npm-shrinkwrap.json": ["registry.npmjs.org"],
+  "pnpm-lock.yaml": ["registry.npmjs.org"],
+  "yarn.lock": ["registry.yarnpkg.com", "registry.npmjs.org"],
+  "bun.lockb": ["registry.npmjs.org"],
+  "bun.lock": ["registry.npmjs.org"],
+  "poetry.lock": ["pypi.org", "files.pythonhosted.org"],
+  "uv.lock": ["pypi.org", "files.pythonhosted.org"],
+  "Pipfile.lock": ["pypi.org", "files.pythonhosted.org"],
+  "requirements.txt": ["pypi.org", "files.pythonhosted.org"],
+  "Cargo.lock": ["crates.io", "index.crates.io", "static.crates.io"],
+  "Gemfile.lock": ["rubygems.org", "index.rubygems.org"],
+  "go.sum": ["proxy.golang.org", "sum.golang.org"],
+  "composer.lock": ["repo.packagist.org"]
+};
+function buildNetwork(rootFiles) {
+  return [...new Set(rootFiles.flatMap((f) => REGISTRIES[f] ?? []))].sort();
+}
+async function queueBuild(client, ask7) {
+  const { data, error: readError } = await client.from("solutions").select(BUILD_COLUMNS).eq("project_id", ask7.projectId).eq("ref", ask7.ref).is("superseded_by", null).maybeSingle();
+  if (readError) throw new Error(`could not read the solution: ${pgMessage(readError)}`);
+  if (!data) throw new Error(`No solution ${ask7.ref} on the Roadmap.`);
+  const solution = data;
+  const refused = buildRefusal(solution, { anyway: ask7.anyway });
+  if (refused) throw new Error(refused);
+  const { data: job, error } = await client.from("jobs").insert({
+    project_id: ask7.projectId,
+    skill: BUILD_SKILL,
+    requested_by: ask7.userId,
+    trigger: "user",
+    target_daemon_id: ask7.daemonId,
+    params: { solution_id: solution.id, repo_path: ask7.repoPath, ...ask7.anyway ? { anyway: true } : {} }
+  }).select("id").single();
+  if (error?.code === "23505") throw new Error("A build of this product is already running. One at a time: `nanopm status` says where it is.");
+  if (error || !job) throw new Error(`could not queue the build: ${error ? pgMessage(error) : "no row"}`);
+  return { jobId: job.id, solution };
+}
+
+// ../daemon/src/repo.ts
 import { promisify as promisify3 } from "util";
 var execFileAsync3 = promisify3(execFile3);
-var SETTLE_HOURS = 3;
-var MIN_COMMITS = 3;
-async function git(cwd, args) {
-  const { stdout } = await execFileAsync3("git", ["-C", cwd, ...args], { timeout: 2e4, maxBuffer: 1024 * 1024 });
-  return stdout.trim();
+var MAX_BUFFER = 4 * 1024 * 1024;
+var TIMEOUT_MS = 6e4;
+var LOCKED = {
+  GIT_CONFIG_COUNT: "2",
+  GIT_CONFIG_KEY_0: "core.hooksPath",
+  GIT_CONFIG_VALUE_0: "/dev/null",
+  GIT_CONFIG_KEY_1: "core.fsmonitor",
+  GIT_CONFIG_VALUE_1: "false"
+};
+async function exec(cmd, repo, args, timeoutMs = TIMEOUT_MS) {
+  if (typeof repo === "string") return execFileAsync3(cmd, cmd === "git" ? ["-C", repo, ...args] : args, { cwd: repo, maxBuffer: MAX_BUFFER, timeout: timeoutMs });
+  await writeFile4(join5(repo.dir, ".git"), `gitdir: ${repo.admin}
+`);
+  await writeFile4(join5(repo.admin, "commondir"), repo.commondir);
+  await rm3(join5(repo.admin, "config.worktree"), { force: true });
+  return execFileAsync3(cmd, args, { cwd: repo.dir, env: { ...process.env, GIT_DIR: repo.admin, GIT_WORK_TREE: repo.dir, ...LOCKED }, maxBuffer: MAX_BUFFER, timeout: timeoutMs });
+}
+async function git(repo, args, timeoutMs = TIMEOUT_MS) {
+  return (await exec("git", repo, args, timeoutMs)).stdout.trim();
+}
+var RepoError = class extends Error {
+};
+async function commitAll(cwd, message, note) {
+  await git(cwd, ["add", "-A"]);
+  const staged = await git(cwd, ["diff", "--cached", "--name-only"]).catch(() => "");
+  if (!staged) return null;
+  await git(cwd, ["commit", "--no-verify", "-m", message, ...note ? ["-m", note] : [], "-m", `Written by NanoPM. Review before merging.
+
+${BUILD_TRAILER}`]);
+  const sha = await git(cwd, ["rev-parse", "--short", "HEAD"]);
+  return { sha, ...await diffStat(cwd) };
+}
+async function diffStat(cwd) {
+  const numstat = await git(cwd, ["show", "--numstat", "--format=", "HEAD"]).catch(() => "");
+  let files = 0;
+  let insertions = 0;
+  let deletions = 0;
+  for (const line of numstat.split("\n").filter(Boolean)) {
+    const [add2 = "", del = ""] = line.split("	");
+    files += 1;
+    insertions += Number(add2) || 0;
+    deletions += Number(del) || 0;
+  }
+  return { files, insertions, deletions };
+}
+async function pushBranch(cwd, name) {
+  if (!await originUrl(cwd)) return { pushed: false, reason: "this repository has no origin remote" };
+  try {
+    const { stderr } = await exec("git", cwd, ["push", "--no-verify", "--set-upstream", "origin", name], 12e4);
+    return { pushed: true, reviewUrl: reviewUrlFrom(stderr) };
+  } catch (err) {
+    const text2 = errorMessage(err);
+    return { pushed: false, reason: text2.split("\n").slice(-3).join(" ").trim() || "git push failed" };
+  }
+}
+function reviewUrlFrom(pushOutput) {
+  const match = /https?:\/\/\S+/.exec(pushOutput);
+  return match?.[0]?.replace(/[).,]+$/, "");
 }
 async function defaultBranch(cwd) {
   try {
@@ -5290,9 +5425,78 @@ async function defaultBranch(cwd) {
     return git(cwd, ["rev-parse", "--abbrev-ref", "HEAD"]).catch(() => "HEAD");
   }
 }
+async function originUrl(cwd) {
+  return git(cwd, ["remote", "get-url", "origin"]).catch(() => "");
+}
+async function baseRef(cwd, branch) {
+  if (!await originUrl(cwd)) return branch;
+  await git(cwd, ["fetch", "--quiet", "origin", branch], 12e4).catch(() => "");
+  return await git(cwd, ["rev-parse", "--verify", "--quiet", `origin/${branch}`]).catch(() => "") ? `origin/${branch}` : branch;
+}
+async function addWorktree(clone, dir, branch) {
+  if (!await git(clone, ["rev-parse", "HEAD"]).catch(() => "")) throw new RepoError("this repository has no commits yet; make the first commit, then build");
+  const existing = await git(clone, ["branch", "--list", branch]).catch(() => "");
+  if (existing.trim()) throw new RepoError(`branch ${branch} already exists. Delete it or finish what is on it first.`);
+  const base = await defaultBranch(clone);
+  const onto = await baseRef(clone, base);
+  await git(clone, ["worktree", "add", "-b", branch, dir, onto]);
+  const admin = await git(dir, ["rev-parse", "--absolute-git-dir"]);
+  const worktree = { dir, admin, commondir: await readFile2(join5(admin, "commondir"), "utf8") };
+  return { base, fork: await git(worktree, ["rev-parse", "HEAD"]), worktree };
+}
+async function removeWorktree(clone, dir) {
+  await git(clone, ["worktree", "remove", "--force", dir]).catch(() => "");
+}
+async function commonGitDir(cwd) {
+  return git(cwd, ["rev-parse", "--path-format=absolute", "--git-common-dir"]);
+}
+async function commitsSinceFork(cwd, fork) {
+  return Number(await git(cwd, ["rev-list", "--count", `${fork}..HEAD`]).catch(() => "0")) || 0;
+}
+async function rebaseOnto(cwd, base) {
+  const onto = await baseRef(cwd, base);
+  try {
+    await git(cwd, ["rebase", "--no-verify", onto], 12e4);
+    return { ok: true };
+  } catch {
+    const files = (await git(cwd, ["diff", "--name-only", "--diff-filter=U"]).catch(() => "")).split("\n").filter(Boolean);
+    await git(cwd, ["rebase", "--abort"]).catch(() => "");
+    return { ok: false, files };
+  }
+}
+async function gh(cwd, args) {
+  return (await exec("gh", cwd, args, 12e4)).stdout.trim();
+}
+async function ghReady(cwd) {
+  if (!/github\.com[:/]/.test(await originUrl(cwd))) return "this repository has no GitHub origin, so there is nowhere to open a pull request";
+  try {
+    await gh(cwd, ["auth", "status"]);
+    return null;
+  } catch (err) {
+    return /ENOENT/.test(errorMessage(err)) ? "the GitHub CLI is not installed on this machine: brew install gh, then gh auth login" : "the GitHub CLI is not signed in on this machine: run gh auth login in your terminal";
+  }
+}
+async function openPullRequest(cwd, pr) {
+  try {
+    const out = await gh(cwd, ["pr", "create", "--draft", "--head", pr.branch, "--base", pr.base, "--title", pr.title, "--body", pr.body]);
+    const url = reviewUrlFrom(out) ?? out.split("\n").at(-1) ?? "";
+    return { ok: true, url, number: Number(/\/pull\/(\d+)/.exec(url)?.[1] ?? 0) };
+  } catch (err) {
+    return { ok: false, reason: errorMessage(err).split("\n").filter(Boolean).slice(-2).join(" ") || "gh pr create failed" };
+  }
+}
+
+// ../daemon/src/deploys.ts
+var execFileAsync4 = promisify4(execFile4);
+var SETTLE_HOURS = 3;
+var MIN_COMMITS = 3;
+async function git2(cwd, args) {
+  const { stdout } = await execFileAsync4("git", ["-C", cwd, ...args], { timeout: 2e4, maxBuffer: 1024 * 1024 });
+  return stdout.trim();
+}
 async function commitsSince(cwd, since) {
   const branch = await defaultBranch(cwd);
-  const out = await git(cwd, ["log", branch, `--since=${since.toISOString()}`, "--format=%cI"]);
+  const out = await git2(cwd, ["log", branch, `--since=${since.toISOString()}`, "--format=%cI"]);
   const stamps = out.split("\n").filter(Boolean);
   return { count: stamps.length, newestAt: stamps[0] ? new Date(stamps[0]) : null };
 }
@@ -5376,16 +5580,16 @@ async function reviewWithoutData(client, job) {
 
 // ../daemon/src/skills.ts
 import { existsSync as existsSync2, readdirSync } from "fs";
-import { readFile as readFile2 } from "fs/promises";
-import { dirname as dirname2, join as join5, resolve as resolve2 } from "path";
+import { readFile as readFile3 } from "fs/promises";
+import { dirname as dirname2, join as join6, resolve as resolve2 } from "path";
 function findSkillsDir(env = process.env) {
   if (env.NANOPM_SKILLS_DIR) return env.NANOPM_SKILLS_DIR;
   const candidates = [
-    join5(process.cwd(), "skills"),
+    join6(process.cwd(), "skills"),
     ...process.argv[1] ? [resolve2(dirname2(process.argv[1]), "..", "skills")] : []
   ];
   for (const dir of candidates) {
-    if (existsSync2(join5(dir, "onboard", "skill.json"))) return dir;
+    if (existsSync2(join6(dir, "onboard", "skill.json"))) return dir;
   }
   throw new Error(`Cannot find the skills directory (tried ${candidates.join(", ")}). Set NANOPM_SKILLS_DIR.`);
 }
@@ -5395,9 +5599,9 @@ function skillDirs(skillsDir, env = process.env) {
 }
 async function loadSkill(name, skillsDir = findSkillsDir()) {
   if (!/^[a-z][a-z0-9-]*$/.test(name)) throw new Error(`Invalid skill name "${name}"`);
-  const dir = skillDirs(skillsDir).map((d) => join5(d, name)).find((d) => existsSync2(join5(d, "skill.json")));
+  const dir = skillDirs(skillsDir).map((d) => join6(d, name)).find((d) => existsSync2(join6(d, "skill.json")));
   if (!dir) throw new Error(`Unknown skill "${name}"`);
-  const raw = JSON.parse(await readFile2(join5(dir, "skill.json"), "utf8"));
+  const raw = JSON.parse(await readFile3(join6(dir, "skill.json"), "utf8"));
   let manifest;
   try {
     manifest = parseSkillManifest(raw);
@@ -5406,7 +5610,7 @@ async function loadSkill(name, skillsDir = findSkillsDir()) {
   }
   const tainted = taintedByTheWeb(manifest);
   if (tainted) throw new Error(`the "${name}" skill cannot be loaded: ${tainted}`);
-  const body = await readFile2(join5(dir, "SKILL.md"), "utf8");
+  const body = await readFile3(join6(dir, "SKILL.md"), "utf8");
   return { manifest, body, dir };
 }
 var NOT_WITH_READ_WEB = ["write_memory", "problems", "propose", "review", "write_repo", "run_commands"];
@@ -5441,7 +5645,7 @@ function renderPrompt(template, params) {
 var NEEDS_THE_REQUESTERS_CLONE = ["write_repo", "run_commands"];
 var NEEDS_THE_REQUESTERS_IDENTITY = /* @__PURE__ */ new Set(["want", "start"]);
 async function clonelessSkills(skillsDir = findSkillsDir()) {
-  const names = readdirSync(skillsDir, { withFileTypes: true }).filter((d) => d.isDirectory() && existsSync2(join5(skillsDir, d.name, "skill.json"))).map((d) => d.name);
+  const names = readdirSync(skillsDir, { withFileTypes: true }).filter((d) => d.isDirectory() && existsSync2(join6(skillsDir, d.name, "skill.json"))).map((d) => d.name);
   const out = [];
   for (const name of names) {
     try {
@@ -5568,9 +5772,9 @@ async function runProblemMapping(ports) {
       if (cycle === 1 && ports.collect) {
         const maxTurns = Math.min(8, MAPPING_TURN_LIMIT - (usage?.turns ?? 0) - 2);
         await ports.checkpoint("collector.started", { maxTurns: Math.max(0, maxTurns), startedAt: Date.now() });
-        let next2 = null;
+        let next = null;
         try {
-          next2 = await ports.collect(proposal.investigation, signal, maxTurns);
+          next = await ports.collect(proposal.investigation, signal, maxTurns);
         } catch (err) {
           signal.throwIfAborted();
           failure2 = errorMessage(err);
@@ -5578,13 +5782,13 @@ async function runProblemMapping(ports) {
           usage = sumUsage(usage, spent);
           await ports.checkpoint("collector", { usage: spent, failed: failure2 });
         }
-        if (!next2 && !failure2) await ports.checkpoint("collector", { unavailable: true });
+        if (!next && !failure2) await ports.checkpoint("collector", { unavailable: true });
         signal.throwIfAborted();
-        if (next2) {
-          if (next2.usage.turns > 0) usage = sumUsage(usage, next2.usage);
-          await ports.checkpoint("collector", { usage: next2.usage });
+        if (next) {
+          if (next.usage.turns > 0) usage = sumUsage(usage, next.usage);
+          await ports.checkpoint("collector", { usage: next.usage });
           if ((usage?.turns ?? 0) >= MAPPING_TURN_LIMIT) throw new Error("Collection exhausted the shared turn budget.");
-          snapshot3 = copySnapshot(next2.snapshot);
+          snapshot3 = copySnapshot(next.snapshot);
           feedback = { previous_proposal: proposal, instruction: proposal.investigation.collector === "sources" ? "The seen sources you named are now in the snapshot in full. Reconsider the proposal with them, then return the final version." : "Reconsider the proposal with the collected findings, then return the final version." };
           await ports.checkpoint("collection", { snapshot_hash: mappingHash(snapshot3), request: proposal.investigation });
           continue;
@@ -5770,8 +5974,8 @@ async function askAgainIfUnanswered(attempt7, say, role7) {
 var UNANSWERED = /structured[ _]output|returned no result/i;
 
 // ../daemon/src/site.ts
-import { readFile as readFile3 } from "fs/promises";
-import { join as join6 } from "path";
+import { readFile as readFile4 } from "fs/promises";
+import { join as join7 } from "path";
 var SITE_PATHS = ["/", "/about", "/pricing"];
 var PAGE_CHARS = 6e3;
 var SITE_TIMEOUT_MS = 2e4;
@@ -5894,7 +6098,7 @@ function siteFromSearch(name, hits) {
 }
 async function read(repoRoot, name) {
   try {
-    const text2 = await readFile3(join6(repoRoot, name), "utf8");
+    const text2 = await readFile4(join7(repoRoot, name), "utf8");
     return text2.length > 2e5 ? null : text2;
   } catch {
     return null;
@@ -5948,8 +6152,8 @@ async function fromReadme(repoRoot) {
 }
 
 // ../daemon/src/repo-docs.ts
-import { readFile as readFile4, readdir, stat } from "fs/promises";
-import { join as join7, relative } from "path";
+import { readFile as readFile5, readdir, stat } from "fs/promises";
+import { join as join8, relative } from "path";
 var WRITTEN = /(persona|audience|customer|user-research|research\/|icp|segment)/i;
 var ABOUT_PEOPLE = /(persona|audience|customer|user-research|research\/|interview|feedback|survey|verbatim|voice|icp|segment)/i;
 var DOC = /\.(md|mdx|txt)$/i;
@@ -5967,7 +6171,7 @@ async function readDocs(cwd, opts = {}) {
       return;
     }
     for (const entry of entries) {
-      const full = join7(dir, entry.name);
+      const full = join8(dir, entry.name);
       if (SKIP.test(`/${relative(cwd, full)}`)) continue;
       if (entry.isDirectory()) await walk(full, depth + 1);
       else if (DOC.test(entry.name) && (!opts.onlyAboutPeople || ABOUT_PEOPLE.test(relative(cwd, full)))) found.push(full);
@@ -5979,7 +6183,7 @@ async function readDocs(cwd, opts = {}) {
   for (const path of found.slice(0, DOCS_MAX)) {
     try {
       if ((await stat(path)).size > 4e5) continue;
-      out.push({ path: relative(cwd, path), text: (await readFile4(path, "utf8")).slice(0, DOC_CHARS) });
+      out.push({ path: relative(cwd, path), text: (await readFile5(path, "utf8")).slice(0, DOC_CHARS) });
     } catch {
     }
   }
@@ -6451,10 +6655,10 @@ function rank(candidates, readings, verdict, faults) {
   const order = (lands) => DIRECTION_SHAPE_ORDER.indexOf(lands);
   return candidates.filter((c) => readings.some((r) => r.lands === c.lands)).map((candidate) => {
     const v = verdict.verdicts.find((x) => x.lands === candidate.lands);
-    const failed = v?.failed ?? [];
-    const fatal = failed.filter((t) => MUST_PASS_TESTS.includes(t.test));
+    const failed2 = v?.failed ?? [];
+    const fatal = failed2.filter((t) => MUST_PASS_TESTS.includes(t.test));
     const gates = faults.get(candidate.lands) ?? [];
-    const answered = /* @__PURE__ */ new Set([...v?.passed ?? [], ...failed.map((t) => t.test)]);
+    const answered = /* @__PURE__ */ new Set([...v?.passed ?? [], ...failed2.map((t) => t.test)]);
     const unanswered = MUST_PASS_TESTS.filter((t) => !answered.has(t));
     const reservations = [
       ...fatal.map((t) => `${t.test} \u2014 ${t.because}`),
@@ -6527,17 +6731,17 @@ async function publish2(client, projectId, job, winner, current, because, confid
   for (const row of DIRECTION_ROWS) {
     const content = winner[row].trim();
     const base = current.find((r) => r.topic === row && r.key === directionKey(row));
-    const next2 = current.find((r) => r.topic === row && r.key === directionKey(row, true));
+    const next = current.find((r) => r.topic === row && r.key === directionKey(row, true));
     const sources2 = [
       ...winner.restsOn.map((ref) => ({ kind: "memory", ref, note: because })),
       ...runnerUp && runnerUp[row]?.trim() && runnerUp[row].trim() !== content ? [{ kind: CONSIDERED, ref: runnerUp.lands, note: runnerUp[row].trim() }] : []
     ];
     if (base?.provenance === "stated") {
       if (base.content.trim() === content) {
-        if (next2) await retire(client, projectId, next2.id, "withdrawn: the crew now agrees with your line");
+        if (next) await retire(client, projectId, next.id, "withdrawn: the crew now agrees with your line");
         continue;
       }
-      await write2(client, projectId, jobId, row, { key: directionKey(row, true), content, confidence, sources: sources2, supersedes: next2?.id ?? null });
+      await write2(client, projectId, jobId, row, { key: directionKey(row, true), content, confidence, sources: sources2, supersedes: next?.id ?? null });
       proposed.push(row);
     } else {
       if (base && base.content.trim() === content) continue;
@@ -6758,17 +6962,17 @@ async function publish3(client, projectId, job, winner, current, because, runner
   for (const line of PITCH_LINE_KEYS) {
     const content = winner[line].trim();
     const base = current.find((r) => r.key === pitchKey(line));
-    const next2 = current.find((r) => r.key === pitchKey(line, true));
+    const next = current.find((r) => r.key === pitchKey(line, true));
     const sources2 = [
       ...winner.restsOn.map((ref) => ({ kind: "memory", ref, note: because })),
       ...runnerUp && !sameLine(runnerUp[line], content) ? [{ kind: CONSIDERED, ref: runnerUp.form, note: runnerUp[line].trim() }] : []
     ];
     if (base?.provenance === "stated") {
       if (sameLine(base.content, content)) {
-        if (next2) await retire2(client, projectId, next2.id, "withdrawn: the crew now agrees with your line");
+        if (next) await retire2(client, projectId, next.id, "withdrawn: the crew now agrees with your line");
         continue;
       }
-      await write3(client, projectId, jobId, { key: pitchKey(line, true), title: PITCH_LINE_TITLE[line], content, confidence: winner.confidence, sources: sources2, supersedes: next2?.id ?? null });
+      await write3(client, projectId, jobId, { key: pitchKey(line, true), title: PITCH_LINE_TITLE[line], content, confidence: winner.confidence, sources: sources2, supersedes: next?.id ?? null });
       proposed.push(line);
     } else {
       if (base && sameLine(base.content, content)) continue;
@@ -7023,10 +7227,10 @@ async function runMarketJob({ client, job, adapter, spec: spec2, onEvent }) {
 }
 async function writeRow(client, projectId, job, rows2, item) {
   const base = rows2.find((r) => r.key === item.key);
-  const next2 = rows2.find((r) => r.key === `${item.key}-next`);
+  const next = rows2.find((r) => r.key === `${item.key}-next`);
   if (base && base.content.trim() === item.content) return { kind: "written" };
   if (base?.provenance === "stated") {
-    await write4(client, projectId, job.id, { ...item, key: `${item.key}-next`, supersedes: next2?.id ?? null });
+    await write4(client, projectId, job.id, { ...item, key: `${item.key}-next`, supersedes: next?.id ?? null });
     return { kind: "written" };
   }
   const held = keepsTheLine(job, base, item.confidence);
@@ -7782,7 +7986,7 @@ ${body}
 // ../daemon/src/crew.ts
 import { randomUUID as randomUUID8 } from "crypto";
 import { mkdir as mkdir2 } from "fs/promises";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 var READ_ONLY = {
   read_repo: /^(Read|Glob|Grep)$/,
   read_data: /(^|__)(list_connections|describe_source|query)$/
@@ -7797,7 +8001,7 @@ async function attempt6({ adapter, spec: spec2, onEvent, skill: skillName, name,
   if (skill.manifest.capabilities.some((c) => !holds.includes(c))) throw new Error(`The ${name} may not hold tools.`);
   const refused = grant.find((c) => !READ_ONLY[c] || !skill.manifest.capabilities.includes(c));
   if (refused) throw new Error(`The ${name} may not hold ${refused}.`);
-  const runDir = dir ? join8(spec2.runDir, dir) : spec2.runDir;
+  const runDir = dir ? join9(spec2.runDir, dir) : spec2.runDir;
   if (dir) await mkdir2(runDir, { recursive: true, mode: 448 });
   let result;
   let usage = null;
@@ -8595,7 +8799,7 @@ function critiqueWording(o, v, reworked) {
   return { problem: problem && problem.length <= PROBLEM_MAX ? problem : o.problem, description: v.description?.trim() || o.description };
 }
 function shape(o, input) {
-  const resolve6 = (ids, stance) => ids.map((id) => {
+  const resolve5 = (ids, stance) => ids.map((id) => {
     const source = input.cites.get(id.trim().toUpperCase());
     if (!source) input.unresolved?.add(id.trim());
     return source;
@@ -8607,7 +8811,7 @@ function shape(o, input) {
     if (source) quoted.push({ ...source, note: clip3(stripContactDetails(e.quote), 140), stance: "supports" });
   }
   const quotedRefs = new Set(quoted.map((q) => q.ref));
-  const cited = [...resolve6(o.restsOn, "supports"), ...resolve6(o.against.filter((id) => !supporting.has(id.trim().toUpperCase())), "contradicts")].filter((c) => !(c.stance === "supports" && quotedRefs.has(c.ref)));
+  const cited = [...resolve5(o.restsOn, "supports"), ...resolve5(o.against.filter((id) => !supporting.has(id.trim().toUpperCase())), "contradicts")].filter((c) => !(c.stance === "supports" && quotedRefs.has(c.ref)));
   const all = [...quoted, ...cited];
   let sources2 = all.filter((c, i) => all.findIndex((x) => x.kind === c.kind && x.ref === c.ref && x.stance === c.stance && x.note === c.note) === i);
   if (!sources2.some((s) => s.stance === "supports")) sources2 = [{ kind: "inference", ref: "nanopm", note: null, stance: "supports" }, ...sources2];
@@ -8897,11 +9101,11 @@ async function runSolutionsJob({ client, job, adapter, spec: spec2, onEvent }) {
     await journal("solutions.citations", `${ids.length} citation${ids.length === 1 ? "" : "s"} named nothing the crew was handed, and ${ids.length === 1 ? "was" : "were"} left out: ${ids.slice(0, 12).join(", ")}.`);
   }
   const recorded = results.filter((r) => "kept" in r);
-  const failed = results.filter((r) => "failed" in r);
+  const failed2 = results.filter((r) => "failed" in r);
   const took = `Took ${duration(Date.now() - started)}${timings.length ? `: ${timings.map((t) => `${t.what} ${duration(t.ms)}`).join(", ")}` : ""}.`;
   const summary = [
-    deep ? leaves.length ? recorded.length ? `Deep dive on \u201C${clip3(leaves[0].problem, 120)}\u201D: kept ${recorded[0].kept.map((t) => `\u201C${t}\u201D`).join(", ")}.` : `Deep dive on \u201C${clip3(leaves[0].problem, 120)}\u201D: nothing recorded \u2014 ${failed[0]?.failed ?? "no solution came back"}.` : "Deep dive: nothing to think through." : `Flash: solutions for ${recorded.length} of ${leaves.length} problem${leaves.length === 1 ? "" : "s"} in ${branches.length} branch${branches.length === 1 ? "" : "es"}.`,
-    !deep && failed.length ? `Not recorded: ${failed.map((f) => `${f.leaf.ref} (${f.failed})`).join("; ")}.` : "",
+    deep ? leaves.length ? recorded.length ? `Deep dive on \u201C${clip3(leaves[0].problem, 120)}\u201D: kept ${recorded[0].kept.map((t) => `\u201C${t}\u201D`).join(", ")}.` : `Deep dive on \u201C${clip3(leaves[0].problem, 120)}\u201D: nothing recorded \u2014 ${failed2[0]?.failed ?? "no solution came back"}.` : "Deep dive: nothing to think through." : `Flash: solutions for ${recorded.length} of ${leaves.length} problem${leaves.length === 1 ? "" : "s"} in ${branches.length} branch${branches.length === 1 ? "" : "es"}.`,
+    !deep && failed2.length ? `Not recorded: ${failed2.map((f) => `${f.leaf.ref} (${f.failed})`).join("; ")}.` : "",
     skipped.length ? `Skipped: ${skipped.join("; ")}.` : "",
     took
   ].filter(Boolean).join(" ");
@@ -9071,9 +9275,9 @@ async function flashBranch(ctx, w, n, places) {
     const why = clip3(error instanceof Error ? error.message : String(error), 300);
     for (const leaf of w.leaves) if (!out.some((o) => o.leaf === leaf)) out.push({ leaf, failed: why });
   }
-  const failed = out.filter((o) => "failed" in o);
-  if (failed.length) {
-    await ctx.journal("solutions.failed", `\u201C${name}\u201D could not finish: ${failed.map((f) => `${f.leaf.ref} \u2014 ${f.failed}`).join("; ")}. The other branches were not held.`);
+  const failed2 = out.filter((o) => "failed" in o);
+  if (failed2.length) {
+    await ctx.journal("solutions.failed", `\u201C${name}\u201D could not finish: ${failed2.map((f) => `${f.leaf.ref} \u2014 ${f.failed}`).join("; ")}. The other branches were not held.`);
   }
   return out;
 }
@@ -9234,6 +9438,9 @@ function gateOne(ctx, w, leaf) {
   return { draft, refused };
 }
 function draftOf(ctx, w) {
+  return { ...draftFields(w), sources: resolve3(ctx, w.restsOn) };
+}
+function draftFields(w) {
   const headline = w.changelog.headline.trim().replace(/\s+/g, " ");
   const room = CHANGELOG_MAX - headline.length - 1;
   return {
@@ -9243,8 +9450,7 @@ function draftOf(ctx, w) {
     steps: w.steps.map((s) => ({ do: s.do.trim().replace(/\s+/g, " "), who: s.who, ...s.checks ? { checks: true } : {} })),
     size: w.size,
     assumption: clipOrNull(w.worksIf, WORKS_IF_MAX),
-    reasoning: wholeSentences(w.why, WHY_THIS_MAX),
-    sources: resolve3(ctx, w.restsOn)
+    reasoning: wholeSentences(w.why, WHY_THIS_MAX)
   };
 }
 function resolve3(ctx, ids) {
@@ -9312,14 +9518,13 @@ async function readRoadmap(client, projectId) {
 var SPEC_SKILL = "spec";
 var SPEC_MINUTES = 5;
 var SPEC_STEPS = {
-  brief: { says: "Writing what your users will see, and how we\u2019ll know", label: "Writing the brief" },
-  agent: { says: "Turning the brief into a spec a coding agent can build from", label: "Writing the agent spec" },
+  solution: { says: "Writing what your users will see, and how we\u2019ll know", label: "Writing what your users will see" },
+  agent: { says: "Turning the solution into a spec a coding agent can build from", label: "Writing the agent spec" },
   review: { says: "Reading both as you would, then as a coding agent would", label: "Checking both as a coding agent would" }
 };
-function briefRefusal(brief2) {
-  if (!brief2.in_short.trim()) return "it does not say in short what we build";
-  if (!brief2.experience.some((s) => s.trim())) return "it does not walk through the experience";
-  if (!brief2.measure.signal.trim()) return "it does not say how we will know";
+function specRefusal(spec2) {
+  if (!spec2.experience.some((s) => s.trim())) return "it does not walk through the experience";
+  if (!spec2.measure.signal.trim()) return "it does not say how we will know";
   return null;
 }
 function agentSpecRefusal(markdown) {
@@ -9327,19 +9532,25 @@ function agentSpecRefusal(markdown) {
   if (!/^##\s+Acceptance criteria\b/im.test(markdown)) return "it has no acceptance criteria";
   return null;
 }
-function specsRefusal({ brief: brief2, markdown }) {
-  const b = briefRefusal(brief2);
-  if (b) return `the brief ${b}`;
+function specsRefusal({ spec: spec2, markdown }) {
+  const b = specRefusal(spec2);
+  if (b) return `the spec ${b}`;
   const a = agentSpecRefusal(markdown);
   return a ? `the agent spec ${a}` : null;
 }
+function specRecord(mode, answer) {
+  if (mode === "write") return { spec: answer.spec, markdown: answer.markdown, solution: null };
+  if (!answer.solution) throw new Error("a rework writes the whole solution again, and this one came back without it");
+  return { spec: answer.spec, markdown: answer.markdown, solution: answer.solution };
+}
 function specSolutionOf(params) {
   const id = params?.solution;
   return typeof id === "string" ? id : null;
 }
 async function queueSpecs(client, ask7) {
+  const mode = ask7.mode ?? "write";
   const [{ data: solution }, { data: active }, { data: clone }] = await Promise.all([
-    client.from("solutions").select("id, ref, status, opportunity_id").eq("project_id", ask7.projectId).eq("ref", ask7.ref.trim().toUpperCase()).maybeSingle(),
+    client.from("solutions").select("id, ref, status, opportunity_id, specced_at").eq("project_id", ask7.projectId).eq("ref", ask7.ref.trim().toUpperCase()).maybeSingle(),
     client.from("jobs").select("params").eq("project_id", ask7.projectId).eq("skill", SPEC_SKILL).in("status", [...ACTIVE_STATUSES]),
     // The clone on the machine that will run it: the daemon reads the code only in its own (`resolveCwd`).
     client.from("clones").select("repo_path").eq("project_id", ask7.projectId).eq("daemon_id", ask7.daemonId).maybeSingle()
@@ -9347,13 +9558,15 @@ async function queueSpecs(client, ask7) {
   if (!solution || !solution.opportunity_id) throw new Error(`No solution ${ask7.ref.toUpperCase()} on the Roadmap.`);
   if (solution.status === "rejected") throw new Error(`${solution.ref} was thrown out: it gets no specs.`);
   if ((active ?? []).some((j) => specSolutionOf(j.params) === solution.id)) throw new Error(`Nano is already writing the specs of ${solution.ref}.`);
+  if (mode === "write" && solution.specced_at) throw new Error(`${solution.ref} has its specs already: rework the solution to write it all again.`);
+  if (mode === "rework" && !solution.specced_at) throw new Error(`${solution.ref} has no specs yet: write them first.`);
   const { data, error } = await client.from("jobs").insert({
     project_id: ask7.projectId,
     skill: SPEC_SKILL,
     requested_by: ask7.userId,
     trigger: "user",
     target_daemon_id: ask7.daemonId,
-    params: { solution: solution.id, ...clone?.repo_path ? { repo_path: clone.repo_path } : {} }
+    params: { solution: solution.id, ...mode === "rework" ? { rework: true } : {}, ...clone?.repo_path ? { repo_path: clone.repo_path } : {} }
   }).select("id").single();
   if (error?.code === "23505") throw new Error(`Nano is already writing the specs of ${solution.ref}.`);
   if (error || !data) throw new Error(error?.message ?? "could not ask Nano for the specs");
@@ -9364,40 +9577,30 @@ async function queueSpecs(client, ask7) {
 import { z as z15 } from "zod";
 var SpecParams = z15.object({
   solution: z15.guid(),
+  /** *Rework the solution* (spec 74): the whole solution written again, as a new version. */
+  rework: z15.literal(true).optional(),
   repo_path: z15.string().optional(),
   background: z15.boolean().optional()
 }).strict();
 function specAsk(params) {
   const parsed = SpecParams.safeParse(params);
-  if (parsed.success) return { ok: true, solution: parsed.data.solution };
+  if (parsed.success) return { ok: true, solution: parsed.data.solution, mode: parsed.data.rework ? "rework" : "write" };
   const issue = parsed.error.issues[0];
   const unknown2 = issue.code === "unrecognized_keys" ? issue.keys?.join(", ") : null;
   return { ok: false, why: unknown2 ? `this run does not take ${unknown2}` : `${issue.path.join(".") || "params"}: ${issue.message}` };
 }
-var Journey = z15.object({
-  kind: z15.literal("journey"),
-  steps: z15.array(prose(1)).max(9).describe('The user\u2019s path, three to seven steps, each a few words from their side of the screen: "Opens the trial", "Picks a closed search".'),
-  fork: z15.object({
-    after: z15.number().int().describe("The step the path forks after, counted from 1."),
-    when: prose(1).describe('When it forks, a few words: "No closed search".'),
-    then: prose(1).describe("Where it goes instead, a few words.")
-  }).nullable().default(null).describe("One fork at most, only when the path really splits.")
+var Diagram = z15.object({
+  caption: prose(1).describe('What it shows, a few words: "Starting the trial on a closed search".'),
+  mermaid: z15.string().min(1).max(4e3).describe("The diagram in Mermaid syntax, whichever type helps most: flowchart, sequenceDiagram, stateDiagram-v2, journey, or a flowchart with two subgraphs for before and after. At most about twelve nodes, labels of a few words in quotes. No styling: no classDef, style, colours, click or links.")
 });
-var BeforeAfter = z15.object({
-  kind: z15.literal("before_after"),
-  before: z15.array(prose(1)).max(6).describe("What the user lives today, two to five short lines."),
-  after: z15.array(prose(1)).max(6).describe("What they will live, two to five short lines, side by side with before.")
-});
-var BriefFields = {
-  questions: z15.array(z15.object({ ask: prose(1).describe("The question, one sentence."), blocks: prose(1).describe('What it blocks, a few words: "what the trial screen says".') })).max(5).default([]).describe("To finish this brief: up to three questions only the founder can answer. Decide everything else yourself."),
-  in_short: prose(1).describe("In short: three sentences at most \u2014 what we build, for whom, what changes for them. The first could be read alone."),
-  diagrams: z15.array(z15.discriminatedUnion("kind", [Journey, BeforeAfter])).max(2).default([]).describe("At most two. The journey whenever the experience has three steps or more; before and after when the solution changes something the product already does."),
+var SpecFields = {
+  questions: z15.array(z15.object({ ask: prose(1).describe("The question, one sentence."), blocks: prose(1).describe('What it blocks, a few words: "what the trial screen says".') })).max(5).default([]).describe("Questions for you: up to three questions only the founder can answer, and any place the code shows the solution as settled is wrong. Decide everything else yourself."),
+  in_short: prose(1).describe("In short: three sentences at most \u2014 what we build, for whom, what changes for them. The first could be read alone. Read first, right after the problem: not the proposed solution again, its gist."),
+  diagrams: z15.array(Diagram).max(2).default([]).describe("Optional: only when a drawing makes it faster to understand than the words. At most two, in Mermaid, the shape that helps most."),
   experience: z15.array(prose(1)).max(8).describe("The experience: three to six steps, in the present tense, from the user\u2019s side of the screen. Under a hypothesis, the founder\u2019s check comes first, in one line."),
-  build: z15.array(prose(1)).max(8).describe("What we build: three to six points, in users\u2019 words \u2014 what is true the day it ships."),
   wont_do: z15.array(z15.object({ what: prose(1), why: prose(1) })).max(6).default([]).describe("What we won\u2019t do: two to four points, each with why or when."),
   measure: z15.object({
     signal: prose(1).describe("The signal, one sentence: who \xB7 does what \xB7 how many \xB7 by when. Small numbers for a product with few users. Never a baseline you did not measure."),
-    wrong_if: prose(1).describe("We were wrong if\u2026, one sentence. Under a hypothesis, it can show the problem itself wrong."),
     existing: z15.array(z15.object({ name: prose(1).describe("The event as the product records it, exactly."), counts: prose(1).describe("What it counts here, and where you found it.") })).max(8).default([]).describe("Events the product already records that measure this, found in the code or in the connected source. Only what you found."),
     added: z15.array(
       z15.object({
@@ -9411,22 +9614,26 @@ var BriefFields = {
   dependencies: z15.array(prose(1)).max(6).default([]).describe('What must exist first. Empty when nothing: the page says None. No analytics tool in the product: "An analytics tool" is one.')
 };
 var Notes2 = prose().nullable().default(null).describe("A sentence or two, for the Journal.");
-var BriefAnswer = z15.object({
-  ...BriefFields,
-  code: z15.array(z15.object({ path: z15.string().max(200), holds: prose(1).describe("What it holds that matters here, one line.") })).max(16).default([]).describe("The files you read that matter for this change, each with what it holds, for the agent spec\u2019s *Start here*. Empty when the code was not there."),
+var Code = z15.array(z15.object({ path: z15.string().max(200), holds: prose(1).describe("What it holds that matters here, one line.") })).max(16).default([]).describe("The files you read that matter for this change, each with what it holds, for the agent spec\u2019s *Start here*. Empty when the code was not there.");
+var Rewritten = Written.omit({ restsOn: true });
+var SolutionAnswer = z15.object({
+  solution: Rewritten.nullable().default(null).describe('Only when the snapshot says mode "rework": the whole solution, written again. Null in mode "write": those fields are settled.'),
+  ...SpecFields,
+  code: Code,
   notes: Notes2
 });
+var AgentMarkdown = z15.string().min(1).max(6e4);
 var AgentAnswer = z15.object({
-  markdown: prose(1).max(6e4).describe("The agent spec, whole, in markdown, with the sections named in your instructions."),
+  markdown: AgentMarkdown.describe("The agent spec, whole, in markdown, with the sections named in your instructions."),
   notes: Notes2
 });
 var ReviewAnswer = z15.object({
-  brief: z15.object(BriefFields).describe("The brief, whole, corrected where it failed a reader; as it was where it did not."),
-  markdown: prose(1).max(6e4).describe("The agent spec, whole, corrected; as it was where it did not fail."),
+  spec: z15.object(SpecFields).describe("The solution\u2019s sections, whole, corrected where they failed a reader; as they were where they did not."),
+  markdown: AgentMarkdown.describe("The agent spec, whole, corrected; as it was where it did not fail."),
   exchanges: z15.array(z15.object({ asked: prose(1).describe("What the coding agent would have had to guess, as its question, one short sentence."), did: prose(1).describe("What you did: decided it (and what), or left it to the founder.") })).max(5).default([]).describe("Two to five: the questions a coding agent asked of the spec, and what you did about each. They go in the Journal."),
   changed: z15.array(z15.string().max(200)).max(10).default([]).describe("What you changed, a line each, for the Journal.")
 });
-var SCHEMAS7 = { brief: BriefAnswer, agent: AgentAnswer, review: ReviewAnswer };
+var SCHEMAS7 = { solution: SolutionAnswer, agent: AgentAnswer, review: ReviewAnswer };
 function parseSpecAnswer(role7, json2) {
   return SCHEMAS7[role7].parse(json2);
 }
@@ -9435,32 +9642,32 @@ function specOutputSchema(role7) {
 }
 
 // ../daemon/src/git.ts
-import { execFile as execFile4 } from "child_process";
-import { promisify as promisify4 } from "util";
-var execFileAsync4 = promisify4(execFile4);
-var MAX_BUFFER = 4 * 1024 * 1024;
+import { execFile as execFile5 } from "child_process";
+import { promisify as promisify5 } from "util";
+var execFileAsync5 = promisify5(execFile5);
+var MAX_BUFFER2 = 4 * 1024 * 1024;
 var WIKI_DIR = ".nanopm/wiki/docs";
-async function git2(cwd, args) {
-  const { stdout } = await execFileAsync4("git", ["-C", cwd, ...args], { maxBuffer: MAX_BUFFER, timeout: 2e4 });
+async function git3(cwd, args) {
+  const { stdout } = await execFileAsync5("git", ["-C", cwd, ...args], { maxBuffer: MAX_BUFFER2, timeout: 2e4 });
   return stdout.trim();
 }
 async function listTrackedFiles(cwd) {
-  const lines = (args) => git2(cwd, args).then((out) => out ? out.split("\n") : [], () => []);
+  const lines = (args) => git3(cwd, args).then((out) => out ? out.split("\n") : [], () => []);
   const [files, wiki] = await Promise.all([lines(["ls-files"]), lines(["ls-files", "--others", "--ignored", "--exclude-standard", "--", WIKI_DIR])]);
   return { files, wiki };
 }
 async function headCommit(cwd) {
-  return git2(cwd, ["rev-parse", "--short", "HEAD"]).then((sha) => sha || null, () => null);
+  return git3(cwd, ["rev-parse", "--short", "HEAD"]).then((sha) => sha || null, () => null);
 }
 async function collectGitDigest(cwd, recent = 30) {
   try {
-    await git2(cwd, ["rev-parse", "--git-dir"]);
+    await git3(cwd, ["rev-parse", "--git-dir"]);
   } catch {
     return null;
   }
   const safe = async (args) => {
     try {
-      return await git2(cwd, args);
+      return await git3(cwd, args);
     } catch {
       return "";
     }
@@ -9557,6 +9764,7 @@ async function runSpecsJob({ client, job, adapter, spec: spec2, onEvent }) {
   const solution = row;
   if (!solution?.opportunity_id) throw new Error("That solution is not on the Roadmap.");
   if (solution.status === "rejected") throw new Error(`${solution.ref} was thrown out: it gets no specs.`);
+  const mode = asked.mode;
   const clone = typeof job.params?.repo_path === "string";
   const [all, card, stance, numbers, connections, commit] = await Promise.all([
     readOpportunities(client, projectId),
@@ -9571,16 +9779,8 @@ async function runSpecsJob({ client, job, adapter, spec: spec2, onEvent }) {
   const path = leaf ? pathOf(tree, leaf.id) : [];
   const known = {
     today: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
-    solution: {
-      ref: solution.ref,
-      title: solution.title,
-      proposed_solution: solution.description,
-      future_changelog: parseChangelog(solution.changelog),
-      plan: solution.steps,
-      size: solution.size,
-      works_if: solution.assumption,
-      why: solution.reasoning
-    },
+    mode,
+    solution: snapshotOf({ ref: solution.ref, title: solution.title, description: solution.description, changelog: solution.changelog ?? "", steps: solution.steps, size: solution.size ?? "small", assumption: solution.assumption, reasoning: solution.reasoning }),
     problem: leaf ? problemOf(tree, leaf) : null,
     part_of: path.slice(1).map((p) => p.problem),
     objective: lensOf(card.goals),
@@ -9590,27 +9790,37 @@ async function runSpecsJob({ client, job, adapter, spec: spec2, onEvent }) {
     numbers
   };
   const reads = clone ? `the code read at ${commit ?? "its current commit"}` : "no clone here, so the code is not read";
-  await journal("spec.read", `Writing the specs of \u201C${clip3(solution.title, 80)}\u201D (${solution.ref}): ${reads}; ${connections.length ? `${connections.length} connected source${connections.length === 1 ? "" : "s"}` : "no analytics connected"}.`);
+  const doing = mode === "rework" ? "Reworking" : "Writing the specs of";
+  await journal("spec.read", `${doing} \u201C${clip3(solution.title, 80)}\u201D (${solution.ref}): ${reads}; ${connections.length ? `${connections.length} connected source${connections.length === 1 ? "" : "s"}` : "no analytics connected"}.`);
   const ctx = { adapter, spec: spec2, onEvent };
   const timings = [];
-  const time = (what, cost) => timings.push({ what, ms: cost.ms });
+  const time = (what2, cost) => timings.push({ what: what2, ms: cost.ms });
   const repo = clone ? { repository: "the working directory", why_no_repository: null } : { repository: null, why_no_repository: "No clone of the product rode along with this run: work from what the snapshot says the product does." };
   const writerGrant = [...clone ? ["read_repo"] : [], ...connections.length ? ["read_data"] : []];
-  const brief2 = await ask3(ctx, "brief", { grant: writerGrant, prompt: { ...known, ...repo, connections } });
-  time("brief", brief2.cost);
-  const { code, notes: briefNotes, ...draft } = brief2.answer;
-  await step("spec.brief", `Brief written: ${count(draft.build.length, "point")} built, ${count(draft.questions.length, "question")} for you, ${count(draft.measure.added.length, "new event")}.${briefNotes ? ` ${briefNotes}` : ""}`, brief2.cost);
+  const writing = { grant: writerGrant, prompt: { ...known, ...repo, connections } };
+  const written = await ask3(ctx, "solution", writing);
+  time("solution", written.cost);
+  const { solution: rewritten, code, notes, ...draft } = written.answer;
+  const fields = mode === "rework" && rewritten ? draftFields(rewritten) : null;
+  const wrote = fields ? `Solution written again: \u201C${clip3(fields.title, 80)}\u201D` : `Sections written: ${count(draft.experience.length, "step")} of the experience`;
+  await step("spec.solution", `${wrote}, ${count(draft.questions.length, "question")} for you, ${count(draft.measure.added.length, "new event")}.${notes ? ` ${notes}` : ""}`, written.cost);
+  const whole = fields ? snapshotOf({ ref: solution.ref, ...fields }) : known.solution;
+  const first = specRecord(mode, { spec: draft, markdown: "", solution: fields });
+  const unreadable = specRefusal(first.spec) ?? (first.solution && leaf ? solutionRefusal(first.solution, leaf) : null);
+  if (unreadable) throw new Error(`The solution cannot be recorded: ${unreadable}.`);
+  const target = await recordSections(client, { projectId, jobId: job.id, solution, spec: first.spec, fields: first.solution });
+  await journal("spec.sections", first.solution ? `${target.ref} \u201C${clip3(first.solution.title, 80)}\u201D takes ${solution.ref}\u2019s place on the board; its agent spec is on its way.` : `Sections on the sheet; the agent spec is on its way.`);
   const agent = await ask3(ctx, "agent", {
     grant: clone ? ["read_repo"] : [],
-    prompt: { today: known.today, ref: solution.ref, commit: commit ?? "not read", ...repo, brief: draft, code, solution: known.solution, problem: known.problem, product: known.product, constraints: stance }
+    prompt: { today: known.today, ref: target.ref, commit: commit ?? "not read", ...repo, solution: whole, spec: draft, code, problem: known.problem, product: known.product, constraints: stance }
   });
   time("agent spec", agent.cost);
   await step("spec.agent", `Agent spec written.${agent.answer.notes ? ` ${agent.answer.notes}` : ""}`, agent.cost);
-  let final = { brief: draft, markdown: agent.answer.markdown };
+  let final = { spec: first.spec, markdown: agent.answer.markdown };
   try {
-    const review2 = await ask3(ctx, "review", { prompt: { brief: draft, markdown: agent.answer.markdown, solution: known.solution, problem: known.problem } });
+    const review2 = await ask3(ctx, "review", { prompt: { mode, solution: whole, spec: draft, markdown: agent.answer.markdown, problem: known.problem } });
     time("review", review2.cost);
-    const reviewed = { brief: review2.answer.brief, markdown: review2.answer.markdown };
+    const reviewed = { spec: review2.answer.spec, markdown: review2.answer.markdown };
     const refused2 = specsRefusal(reviewed);
     if (refused2) await journal("spec.review_kept_out", `The review\u2019s version was left out (${refused2}): the writers\u2019 drafts are recorded.`);
     else final = reviewed;
@@ -9624,19 +9834,15 @@ async function runSpecsJob({ client, job, adapter, spec: spec2, onEvent }) {
     await journal("spec.review_failed", `The review did not finish (${clip3(errorMessage(err), 200)}): the writers\u2019 drafts are recorded.`);
   }
   const refused = specsRefusal(final);
-  if (refused) throw new Error(`The specs cannot be read: ${refused}.`);
-  const { error: published } = await client.rpc("publish_spec", {
-    p_project_id: projectId,
-    p_solution_id: solution.id,
-    p_brief: final.brief,
-    p_agent_spec: final.markdown
-  });
+  if (refused) throw new Error(`The specs cannot be recorded: ${refused}.`);
+  const { error: published } = await client.rpc("publish_solution_spec", { p_project_id: projectId, p_solution_id: target.id, p_spec: final.spec, p_agent_spec: final.markdown });
   if (published) throw new Error(`could not record the specs: ${published.message}`);
-  const summary = `Specs of \u201C${clip3(solution.title, 80)}\u201D (${solution.ref}) written: the brief, with ${count(final.brief.questions.length, "question")} for you, and the agent spec. Took ${duration(Date.now() - started)}: ${timings.map((t) => `${t.what} ${duration(t.ms)}`).join(", ")}.`;
+  const what = first.solution ? `\u201C${clip3(solution.title, 80)}\u201D (${solution.ref}) reworked as ${target.ref} \u201C${clip3(first.solution.title, 80)}\u201D` : `Specs of \u201C${clip3(solution.title, 80)}\u201D (${solution.ref}) written`;
+  const summary = `${what}: ${count(final.spec.questions.length, "question")} for you, and the agent spec. Took ${duration(Date.now() - started)}: ${timings.map((t) => `${t.what} ${duration(t.ms)}`).join(", ")}.`;
   await journal("spec.summary", summary);
   return { status: "succeeded", result: summary };
 }
-var ROLE_NAME = { brief: "spec brief writer", agent: "spec agent writer", review: "spec reviewer" };
+var ROLE_NAME = { solution: "spec solution writer", agent: "spec agent writer", review: "spec reviewer" };
 async function ask3(ctx, role7, call2) {
   const cost = await runRole({
     adapter: ctx.adapter,
@@ -9653,6 +9859,33 @@ async function ask3(ctx, role7, call2) {
   });
   return { answer: stripDeep(parseSpecAnswer(role7, JSON.parse(cost.text))), cost };
 }
+async function recordSections(client, r) {
+  if (!r.fields) {
+    const { error: error2 } = await client.rpc("publish_solution_spec", { p_project_id: r.projectId, p_solution_id: r.solution.id, p_spec: r.spec });
+    if (error2) throw new Error(`could not record the sections: ${error2.message}`);
+    return { id: r.solution.id, ref: r.solution.ref };
+  }
+  const f = r.fields;
+  const { data, error } = await client.rpc("rework_spec", {
+    p_project_id: r.projectId,
+    p_solution_id: r.solution.id,
+    p_job_id: r.jobId,
+    p_title: f.title,
+    p_description: f.description ?? "",
+    p_changelog: f.changelog,
+    p_steps: f.steps,
+    p_size: f.size,
+    p_assumption: f.assumption ?? "",
+    p_reasoning: f.reasoning,
+    p_spec: r.spec
+  });
+  const made = data?.[0];
+  if (error || !made) throw new Error(`could not record the reworked solution: ${error?.message ?? "no new version"}`);
+  return made;
+}
+function snapshotOf(s) {
+  return { ref: s.ref, title: s.title, proposed_solution: s.description, future_changelog: parseChangelog(s.changelog), plan: s.steps, size: s.size, works_if: s.assumption, why: s.reasoning };
+}
 function problemOf(tree, leaf) {
   return { ref: placeOf(tree, leaf.id) ?? leaf.ref, problem: leaf.problem, description: leaf.description ?? null, status: leaf.evidence_status, confirmed_by_founder: leaf.status === "confirmed" };
 }
@@ -9824,13 +10057,13 @@ var told = (r) => ({
 });
 
 // ../daemon/src/objective-definitions.ts
-import { execFile as execFile5 } from "child_process";
+import { execFile as execFile6 } from "child_process";
 import { randomUUID as randomUUID11 } from "crypto";
 import { existsSync as existsSync3 } from "fs";
-import { mkdir as mkdir3, readFile as readFile5 } from "fs/promises";
-import { join as join9 } from "path";
-import { promisify as promisify5 } from "util";
-var execFileAsync5 = promisify5(execFile5);
+import { mkdir as mkdir3, readFile as readFile6 } from "fs/promises";
+import { join as join10 } from "path";
+import { promisify as promisify6 } from "util";
+var execFileAsync6 = promisify6(execFile6);
 var DEFINITIONS_TIMEOUT_MS = 9e4;
 var DEFINITIONS_THINKING_TOKENS = 2e3;
 var READ_TOOLS3 = /* @__PURE__ */ new Set(["Read", "Glob", "Grep", "StructuredOutput"]);
@@ -9839,7 +10072,7 @@ var COUNTING_LINES_MAX = 80;
 var PER_FILE = 4;
 async function countingLines(cwd) {
   try {
-    const { stdout } = await execFileAsync5("git", ["grep", "-n", "-I", "-i", "-E", COUNTING, "--", ".", ":!*lock*", ":!*.min.*", ":!*.map", ":!*.svg", ":!*.snap"], {
+    const { stdout } = await execFileAsync6("git", ["grep", "-n", "-I", "-i", "-E", COUNTING, "--", ".", ":!*lock*", ":!*.min.*", ":!*.map", ":!*.svg", ":!*.snap"], {
       cwd,
       maxBuffer: 16 * 1024 * 1024,
       timeout: 5e3
@@ -9864,7 +10097,7 @@ function pickLines(raw) {
 }
 async function killRecorded(runDir) {
   try {
-    const pid = Number((await readFile5(join9(runDir, "harness.pid"), "utf8")).trim());
+    const pid = Number((await readFile6(join10(runDir, "harness.pid"), "utf8")).trim());
     if (pid > 1) process.kill(pid, "SIGKILL");
   } catch {
   }
@@ -9884,7 +10117,7 @@ async function readDefinitions({ adapter, spec: spec2, publish: publish5, journa
   if (!hasRepo) return give({}, "No repository to read: the card offers the common definitions.", "ok");
   try {
     const skill = await loadSkill("define-objective");
-    const runDir = join9(spec2.runDir, "definitions");
+    const runDir = join10(spec2.runDir, "definitions");
     await mkdir3(runDir, { recursive: true, mode: 448 });
     const schema = definitionsOutputSchema();
     const [lines, listed] = await Promise.all([countingLines(spec2.cwd), listTrackedFiles(spec2.cwd)]);
@@ -9946,7 +10179,7 @@ ${renderTrackedFiles(listed.files, void 0, listed.wiki)}
     if (!result) throw new Error("no answer");
     const parsed = DefinitionsAnswer.safeParse(JSON.parse(result));
     if (!parsed.success) throw new Error("an answer in the wrong shape");
-    const checked = checkProposals(parsed.data, (file) => existsSync3(join9(spec2.cwd, file)));
+    const checked = checkProposals(parsed.data, (file) => existsSync3(join10(spec2.cwd, file)));
     const definitions2 = lever ? checked[lever] ? { [lever]: checked[lever] } : {} : checked;
     const kept = Object.values(definitions2).reduce((n, list) => n + (list?.length ?? 0), 0);
     const read6 = Object.values(definitions2).flat().filter((d) => d?.found).length;
@@ -10220,9 +10453,9 @@ function localDate(timezone, at) {
 // ../daemon/src/run-job.ts
 import { randomUUID as randomUUID12 } from "crypto";
 import { existsSync as existsSync4 } from "fs";
-import { mkdir as mkdir4, readFile as readFile6, rm as rm3 } from "fs/promises";
-import { homedir as homedir3, tmpdir } from "os";
-import { join as join10, resolve as resolve4 } from "path";
+import { mkdir as mkdir5, readFile as readFile8, rm as rm4 } from "fs/promises";
+import { homedir as homedir4, tmpdir } from "os";
+import { join as join12, resolve as resolve4 } from "path";
 
 // ../daemon/src/events.ts
 var JobEventWriter = class {
@@ -10302,195 +10535,166 @@ function lighten(value) {
   return value ?? null;
 }
 
-// ../daemon/src/repo.ts
-import { execFile as execFile6 } from "child_process";
-import { promisify as promisify6 } from "util";
-var execFileAsync6 = promisify6(execFile6);
-var MAX_BUFFER2 = 4 * 1024 * 1024;
-var TIMEOUT_MS = 6e4;
-async function git3(cwd, args, timeoutMs = TIMEOUT_MS) {
-  const { stdout } = await execFileAsync6("git", ["-C", cwd, ...args], { maxBuffer: MAX_BUFFER2, timeout: timeoutMs });
-  return stdout.trim();
-}
-var RepoError = class extends Error {
-};
-function branchName(ref) {
-  const slug = ref.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-  if (!slug) throw new RepoError(`"${ref}" has no letters or digits to make a branch name from`);
-  return `nanopm/${slug}`;
-}
-async function readState(cwd) {
-  try {
-    await git3(cwd, ["rev-parse", "--git-dir"]);
-  } catch {
-    throw new RepoError(`${cwd} is not a git repository`);
-  }
-  const [branch, head, status2, remoteUrl] = await Promise.all([
-    git3(cwd, ["branch", "--show-current"]).catch(() => ""),
-    git3(cwd, ["rev-parse", "HEAD"]).catch(() => ""),
-    git3(cwd, ["status", "--porcelain"]).catch(() => ""),
-    git3(cwd, ["remote", "get-url", "origin"]).catch(() => "")
-  ]);
-  const dirty = status2.split("\n").filter(Boolean).map((l) => l.slice(3));
-  return { branch, head, clean: dirty.length === 0, dirty, hasRemote: Boolean(remoteUrl), remoteUrl: remoteUrl || void 0 };
-}
-async function ensureCleanTree(cwd) {
-  const state = await readState(cwd);
-  if (!state.head) {
-    throw new RepoError("this repository has no commits yet; make the first commit, then run nanopm next");
-  }
-  if (!state.clean) {
-    const shown = state.dirty.slice(0, 5).join(", ");
-    const more = state.dirty.length > 5 ? `, and ${state.dirty.length - 5} more` : "";
-    throw new RepoError(
-      `the working tree has uncommitted changes (${shown}${more}). NanoPM commits only its own work, so commit or stash yours first.`
-    );
-  }
-  return state;
-}
-async function createBranch(cwd, name) {
-  const existing = await git3(cwd, ["branch", "--list", name]).catch(() => "");
-  if (existing.trim()) {
-    throw new RepoError(`branch ${name} already exists. Delete it or finish what is on it first.`);
-  }
-  await git3(cwd, ["checkout", "-b", name]);
-}
-async function commitAll(cwd, message) {
-  await git3(cwd, ["add", "-A"]);
-  const staged = await git3(cwd, ["diff", "--cached", "--name-only"]).catch(() => "");
-  if (!staged) return null;
-  await git3(cwd, ["commit", "-m", message, "-m", "Written by NanoPM. Review before merging."]);
-  const sha = await git3(cwd, ["rev-parse", "--short", "HEAD"]);
-  return { sha, ...await diffStat(cwd) };
-}
-async function diffStat(cwd) {
-  const numstat = await git3(cwd, ["show", "--numstat", "--format=", "HEAD"]).catch(() => "");
-  let files = 0;
-  let insertions = 0;
-  let deletions = 0;
-  for (const line of numstat.split("\n").filter(Boolean)) {
-    const [add2 = "", del = ""] = line.split("	");
-    files += 1;
-    insertions += Number(add2) || 0;
-    deletions += Number(del) || 0;
-  }
-  return { files, insertions, deletions };
-}
-async function pushBranch(cwd, name) {
-  const state = await readState(cwd);
-  if (!state.hasRemote) return { pushed: false, reason: "this repository has no origin remote" };
+// ../daemon/src/build-job.ts
+import { mkdir as mkdir4, readdir as readdir2, readFile as readFile7, writeFile as writeFile5 } from "fs/promises";
+import { homedir as homedir3 } from "os";
+import { join as join11 } from "path";
+var PLAN_TOOL = "mcp__nanopm__build_plan";
+var STEP_TOOL = "mcp__nanopm__build_step";
+var CLAUDE_CODE_MIN = "2.1.283";
+async function prepareBuild(client, job, clone, adapter) {
+  const params = job.params ?? {};
+  const dir = buildDir(homedir3(), job.id);
+  let made = false;
   try {
-    const { stderr } = await execFileAsync6("git", ["-C", cwd, "push", "--set-upstream", "origin", name], {
-      maxBuffer: MAX_BUFFER2,
-      timeout: 12e4
-    });
-    return { pushed: true, reviewUrl: reviewUrlFrom(stderr) };
+    const [solution, machine] = await Promise.all([loadSolution(client, job.project_id, String(params.solution_id ?? "")), machineRefusal(adapter)]);
+    const refused = buildRefusal(solution, { anyway: params.anyway === true }) ?? machine;
+    if (refused) return { ok: false, outcome: failed(refused) };
+    const branch = buildBranch(solution.ref, solution.title);
+    await mkdir4(join11(dir, ".."), { recursive: true, mode: 448 });
+    const { base, fork, worktree } = await addWorktree(clone, dir, branch);
+    made = true;
+    await handOverTheSpec(worktree, solution.agent_spec);
+    await startSolution(client, job.project_id, solution.ref, job.id);
+    return { ok: true, build: { solution, clone, dir, worktree, branch, base, fork, network: buildNetwork(await readdir2(dir)) } };
   } catch (err) {
-    const text2 = errorMessage(err);
-    return { pushed: false, reason: text2.split("\n").slice(-3).join(" ").trim() || "git push failed" };
+    if (made) await removeWorktree(clone, dir);
+    return { ok: false, outcome: failed(errorMessage(err)) };
   }
 }
-function reviewUrlFrom(pushOutput) {
-  const match = /https?:\/\/\S+/.exec(pushOutput);
-  return match?.[0]?.replace(/[).,]+$/, "");
-}
-async function checkout(cwd, ref) {
-  await git3(cwd, ["checkout", ref]);
-}
-async function deleteBranch(cwd, name) {
-  await git3(cwd, ["branch", "-D", name]).catch(() => "");
-}
-async function changedFiles(cwd) {
-  const status2 = await git3(cwd, ["status", "--porcelain"]).catch(() => "");
-  return status2.split("\n").filter(Boolean).map((line) => line.slice(3).trim()).map((path) => path.includes(" -> ") ? path.split(" -> ")[1].trim() : path).map((path) => path.replace(/^"|"$/g, ""));
-}
+async function runBuildJob(input) {
+  const { client, job, adapter, spec: spec2, events, log, verifyCommand: verifyCommand2 } = input;
+  const { solution, clone, dir, worktree, branch, base, fork } = input.build;
+  await log("build.start", `building ${solution.ref} on ${branch}, in a copy of your code`);
+  await events.write("text", { text: `Working on ${branch}, in a copy of your code. Your own checkout is not touched.` });
+  let plan = null;
+  const done = /* @__PURE__ */ new Set();
+  let usage;
+  let said = "";
+  const stop2 = async (message, opts = { keep: true }) => {
+    await unstartSolution(client, job.project_id, solution.ref, solution.status).catch(() => void 0);
+    if (opts.keep) await commitAll(worktree, `${solution.ref}: unfinished \u2014 ${solution.title}`).catch(() => null);
+    else await removeWorktree(clone, dir);
+    return { ...failed(opts.keep ? `${message}. What was done is on ${branch}, in ${dir}.` : message), usage };
+  };
+  const session2 = async (prompt, resume2) => {
+    let end;
+    for await (const event of adapter.run({ ...spec2, prompt, resumeSessionId: resume2 ? spec2.sessionId : void 0 })) {
+      await input.onEvent(event);
+      if (event.type === "tool_use" && event.tool === PLAN_TOOL && !plan) {
+        plan = stepsOf(event.input);
+        if (plan) await events.write("plan", { steps: plan });
+      } else if (event.type === "tool_result" && event.tool === STEP_TOOL && !event.isError) {
+        const { step, summary } = event.input ?? {};
+        const index = Number(step) - 1;
+        if (Number.isInteger(index) && index >= 0 && !done.has(index)) {
+          const says = plan?.[index] ?? `step ${index + 1}`;
+          const commit = await commitAll(worktree, `${solution.ref}: ${says}`, summary);
+          done.add(index);
+          await events.write("step", { step: index + 1, says, commit: commit?.sha ?? null, files: commit?.files ?? 0 });
+        }
+      } else if (event.type === "finished") {
+        usage = sumUsage(usage, event.usage);
+        said = event.result;
+        end = { status: "succeeded" };
+      } else if (event.type === "failed") {
+        end = { status: "failed", error: { code: event.code, message: event.message } };
+      }
+    }
+    return end?.status === "succeeded" ? null : end ?? failed("the agent produced no result");
+  };
+  const check = verifyCommand2 ? `
 
-// ../daemon/src/next-run.ts
-async function loadAcceptedSolution(client, projectId, solutionId) {
-  const { data, error } = await client.from("solutions").select("id, ref, title, reasoning, status, assumption, eval, sources").eq("id", solutionId).eq("project_id", projectId).is("superseded_by", null).maybeSingle();
+The project's own check is \`${verifyCommand2}\`. Run it before your last build_step, fix what it reports, and give its result under *How I checked it*.` : "";
+  let ended = await session2(spec2.prompt + check, false);
+  for (let resumes = 0; !ended && !(plan && !stepsLeft(plan, done).length); resumes += 1) {
+    if (resumes >= BUILD_RESUMES_MAX) {
+      const left = stepsLeft(plan, done).length;
+      return stop2(plan ? `Nano stopped with ${left} step${left === 1 ? "" : "s"} of its plan left` : "Nano stopped without saying its plan");
+    }
+    ended = await session2(carryOn(plan, done), true);
+  }
+  if (ended) return stop2(ended.error?.message ?? "the build stopped");
+  await commitAll(worktree, `${solution.ref}: ${solution.title}`);
+  if (!await commitsSinceFork(worktree, fork)) return stop2("the build finished without changing anything", { keep: false });
+  const rebased = await rebaseOnto(worktree, base);
+  if (!rebased.ok) return stop2(`${base} moved while Nano was building, and the same files changed on both sides: ${rebased.files.join(", ") || "see git status"}`);
+  const [pushed, noPr, page] = await Promise.all([pushBranch(worktree, branch), ghReady(worktree), solutionPage(client, job.project_id, solution.ref)]);
+  if (!pushed.pushed) return stop2(`the push failed: ${pushed.reason}`);
+  const pr = noPr ? null : await openPullRequest(worktree, { branch, base, title: `${solution.ref}: ${solution.title}`, body: prBody(said, page) });
+  if (pr && !pr.ok) return { ...failed(`the branch ${branch} is pushed, but GitHub refused the pull request: ${pr.reason}${pushed.reviewUrl ? `. Open it yourself: ${pushed.reviewUrl}` : ""}`), usage };
+  if (pr) {
+    await events.write("pr", { number: pr.number, url: pr.url });
+    await log("build.pr", `draft pull request #${pr.number} for ${solution.ref}`);
+  }
+  await removeWorktree(clone, dir);
+  return {
+    status: "succeeded",
+    result: [
+      said.trim(),
+      "",
+      pr ? `Draft pull request #${pr.number} \xB7 ${pr.url}` : `Pushed ${branch}. No pull request: ${noPr}.${pushed.reviewUrl ? ` ${pushed.reviewUrl}` : ""}`
+    ].filter(Boolean).join("\n"),
+    data: { branch, session: spec2.sessionId, ...pr ? { pr: { number: pr.number, url: pr.url } } : { review_url: pushed.reviewUrl ?? null } },
+    usage
+  };
+}
+var failed = (message) => ({ status: "failed", error: { code: "harness_error", message } });
+async function loadSolution(client, projectId, id) {
+  const { data, error } = await client.from("solutions").select(BUILD_COLUMNS).eq("id", id).eq("project_id", projectId).is("superseded_by", null).maybeSingle();
   if (error) throw new Error(`could not read the solution: ${error.message}`);
   if (!data) throw new Error("that solution is not on this project any more");
-  if (data.status !== "accepted" && data.status !== "building") {
-    throw new Error(`${data.ref} is ${data.status}. Only a solution you accepted can be built.`);
-  }
-  return { ...data, sources: data.sources ?? [] };
-}
-async function startSolution(client, projectId, ref, jobId) {
-  const { error } = await client.rpc("start_solution", { p_project_id: projectId, p_ref: ref, p_job_id: jobId });
-  if (error && !/only an accepted solution/.test(error.message)) throw new Error(pgMessage(error));
-}
-async function unstartSolution(client, projectId, ref) {
-  await client.rpc("unstart_solution", { p_project_id: projectId, p_ref: ref });
+  return data;
 }
-function renderSolution(solution) {
-  const lines = [`${solution.ref}  ${solution.title}`, "", `Why: ${solution.reasoning}`];
-  if (solution.assumption) lines.push(`Bets on: ${solution.assumption}`);
-  if (solution.eval) lines.push(`We'll know: ${solution.eval}`);
-  if (solution.sources.length) {
-    lines.push(`Rests on: ${solution.sources.map((s) => `${s.kind}:${s.ref}`).join(", ")}`);
+async function machineRefusal(adapter) {
+  const found = await adapter.detect();
+  const version = /\d+\.\d+\.\d+/.exec(found.version ?? "")?.[0];
+  if (version && !newer(CLAUDE_CODE_MIN, version)) return null;
+  return `a build needs Claude Code ${CLAUDE_CODE_MIN} or later on this machine${found.version ? ` (it has ${found.version})` : ""}: run claude update`;
+}
+async function handOverTheSpec(worktree, agentSpec) {
+  await mkdir4(join11(worktree.dir, ".nanopm"), { recursive: true });
+  await writeFile5(join11(worktree.dir, ".nanopm", "SPEC.md"), agentSpec);
+  const exclude = join11(await commonGitDir(worktree), "info", "exclude");
+  const current = await readFile7(exclude, "utf8").catch(() => "");
+  if (!current.split("\n").includes(".nanopm/")) {
+    await mkdir4(join11(exclude, ".."), { recursive: true });
+    await writeFile5(exclude, `${current}${current && !current.endsWith("\n") ? "\n" : ""}.nanopm/
+`);
   }
-  return lines.join("\n");
 }
-async function openRepoSession(cwd, ref) {
-  const state = await ensureCleanTree(cwd);
-  if (!state.branch) {
-    throw new RepoError("this repository has a detached HEAD; check out a branch first");
-  }
-  const branch = branchName(ref);
-  await createBranch(cwd, branch);
-  return { branch, baseBranch: state.branch };
+function stepsOf(input) {
+  const steps = input?.steps;
+  return Array.isArray(steps) && steps.length && steps.every((s) => typeof s === "string") ? steps : null;
 }
-async function closeRepoSession(cwd, session2, item) {
-  return closeBranch(cwd, session2, `${item.ref}: ${item.title}`, { commitErrorThrows: true });
+function carryOn(plan, done) {
+  if (!plan) return "You stopped before saying your plan. Call build_plan with it now, then build it step by step, calling build_step after each.";
+  const left = stepsLeft(plan, done);
+  return [
+    `Steps ${left.map((i) => i + 1).join(", ")} of your plan are not done yet:`,
+    ...left.map((i) => `${i + 1}. ${plan[i]}`),
+    "",
+    "Check git log and git status to see where you are, then carry on: finish each step, run its checks, and call build_step after it. Do not run anything in the background."
+  ].join("\n");
 }
-async function abandonRepoSession(cwd, session2, item) {
-  return closeBranch(cwd, session2, item ? `${item.ref}: ${item.title}` : "WIP: nanopm did not finish", { commitErrorThrows: false });
+async function solutionPage(client, projectId, ref) {
+  const { data } = await client.from("projects").select("slug").eq("id", projectId).maybeSingle();
+  return data?.slug ? `${webUrl()}/p/${data.slug}/roadmap/${ref}` : null;
 }
-async function closeBranch(cwd, session2, message, { commitErrorThrows }) {
-  let commit;
-  try {
-    commit = await commitAll(cwd, message);
-  } catch (err) {
-    await checkout(cwd, session2.baseBranch).catch(() => void 0);
-    if (commitErrorThrows) throw err;
-    commit = null;
-  }
-  if (!commit) {
-    await checkout(cwd, session2.baseBranch).catch(() => void 0);
-    await deleteBranch(cwd, session2.branch);
-    return { branch: session2.branch, pushed: false, note: "nothing was changed, so no branch was kept" };
-  }
-  const push = await pushBranch(cwd, session2.branch);
-  await checkout(cwd, session2.baseBranch).catch(() => void 0);
-  return {
-    branch: session2.branch,
-    commit,
-    pushed: push.pushed,
-    reviewUrl: push.reviewUrl,
-    note: push.pushed ? void 0 : `not pushed: ${push.reason}`
-  };
+function prBody(said, page) {
+  return [
+    said.trim(),
+    page ? `
+The solution and its spec: ${page}` : "",
+    "\n\u2014 Built by NanoPM with Claude Code. A draft: review before merging."
+  ].filter(Boolean).join("\n");
 }
-async function finishSolution(client, job, solution, result) {
-  const sources2 = [{ kind: "branch", ref: result.branch }];
-  if (result.commit?.sha) sources2.push({ kind: "git", ref: result.commit.sha });
-  if (result.reviewUrl) sources2.push({ kind: "url", ref: result.reviewUrl });
-  sources2.push({ kind: "job", ref: job.id });
-  const { error } = await client.rpc("finish_solution", {
-    p_project_id: job.project_id,
-    p_ref: solution.ref,
-    p_job_id: job.id,
-    p_sources: sources2
-  });
-  if (error) throw new Error(`the work is committed on ${result.branch}, but recording it failed: ${error.message}`);
-}
-function renderRepoResult(result) {
-  if (!result.commit) return result.note ?? "nothing changed";
-  const { files, insertions, deletions } = result.commit;
-  const stat2 = `${files} file${files === 1 ? "" : "s"} changed, ${insertions} insertion${insertions === 1 ? "" : "s"}, ${deletions} deletion${deletions === 1 ? "" : "s"}`;
-  const lines = [`${result.branch} \xB7 ${result.commit.sha} \xB7 ${stat2}`];
-  if (result.reviewUrl) lines.push(result.reviewUrl);
-  else if (result.note) lines.push(result.note);
-  return lines.join("\n");
+async function startSolution(client, projectId, ref, jobId) {
+  const { error } = await client.rpc("start_solution", { p_project_id: projectId, p_ref: ref, p_job_id: jobId });
+  if (error) throw new Error(pgMessage(error));
+}
+async function unstartSolution(client, projectId, ref, was) {
+  await client.rpc("unstart_solution", { p_project_id: projectId, p_ref: ref, p_to: was === "proposed" ? "proposed" : "accepted" });
 }
 
 // ../daemon/src/run-job.ts
@@ -10508,107 +10712,6 @@ async function askAboutSite(opts) {
   });
 }
 
-// ../daemon/src/verify.ts
-import { spawn as spawn3 } from "child_process";
-var VERIFY_TIMEOUT_MS = 10 * 6e4;
-var OUTPUT_TAIL = 4e3;
-var DEFINES_THE_COMMAND = [
-  /(^|\/)package\.json$/,
-  /(^|\/)(package-lock\.json|pnpm-lock\.yaml|yarn\.lock|bun\.lockb)$/,
-  /(^|\/)(Makefile|justfile|Justfile|Taskfile\.ya?ml)$/,
-  /(^|\/)\.husky\//,
-  /(^|\/)\.github\//,
-  /(^|\/)(pyproject\.toml|uv\.lock|Cargo\.toml|Cargo\.lock|Gemfile|Gemfile\.lock)$/
-];
-function pathsNamedIn(command) {
-  return command.split(/[\s;&|()<>]+/).filter((t) => /[/.]/.test(t) && !/^-/.test(t) && t.length > 2).map((t) => t.replace(/^\.\//, "").replace(/^["']|["']$/g, ""));
-}
-function guardVerify(changed, command) {
-  for (const file of changed) {
-    const pattern = DEFINES_THE_COMMAND.find((p) => p.test(file));
-    if (pattern) {
-      return `the change touched ${file}, which decides what the verify command does, so the command was not run`;
-    }
-  }
-  const named = pathsNamedIn(command);
-  for (const file of changed) {
-    if (named.some((n) => file === n || file.endsWith(`/${n}`) || n.endsWith(file))) {
-      return `the change touched ${file}, which the verify command runs, so the command was not run`;
-    }
-  }
-  return null;
-}
-async function verify(opts) {
-  const skipped = guardVerify(opts.changed, opts.command);
-  if (skipped) return { ran: false, passed: false, skipped, output: "", durationMs: 0, timedOut: false };
-  return runCommand(opts);
-}
-async function runCommand(opts) {
-  const timeoutMs = opts.timeoutMs ?? VERIFY_TIMEOUT_MS;
-  const startedAt = Date.now();
-  const child = spawn3("sh", ["-c", opts.command], {
-    cwd: opts.cwd,
-    env: opts.env,
-    stdio: ["ignore", "pipe", "pipe"]
-  });
-  let output = "";
-  const collect6 = (chunk) => {
-    output += chunk.toString();
-    if (output.length > OUTPUT_TAIL * 4) output = output.slice(-OUTPUT_TAIL * 2);
-  };
-  child.stdout.on("data", collect6);
-  child.stderr.on("data", collect6);
-  let timedOut = false;
-  const timer = setTimeout(() => {
-    timedOut = true;
-    child.kill("SIGTERM");
-    setTimeout(() => child.kill("SIGKILL"), 5e3).unref();
-  }, timeoutMs);
-  const onAbort = () => child.kill("SIGTERM");
-  opts.signal?.addEventListener("abort", onAbort, { once: true });
-  const exitCode = await new Promise((resolve6) => {
-    child.on("close", (code) => resolve6(code));
-    child.on("error", () => resolve6(127));
-  });
-  clearTimeout(timer);
-  opts.signal?.removeEventListener("abort", onAbort);
-  return {
-    ran: true,
-    passed: exitCode === 0 && !timedOut,
-    output: tail(output, OUTPUT_TAIL),
-    exitCode: exitCode ?? void 0,
-    durationMs: Date.now() - startedAt,
-    timedOut
-  };
-}
-function tail(text2, max) {
-  const trimmed = text2.trimEnd();
-  if (trimmed.length <= max) return trimmed;
-  return `\u2026 ${trimmed.slice(-max)}`;
-}
-function renderVerifyResult(result, command) {
-  if (!result.ran) return result.skipped ?? "no verify command is set for this project";
-  const secs = (result.durationMs / 1e3).toFixed(0);
-  if (result.timedOut) return `the check NanoPM could not run itself, \`${command}\`, did not finish within ${secs}s and was stopped`;
-  return result.passed ? `the check NanoPM could not run itself, \`${command}\`, passed in ${secs}s` : `the check NanoPM could not run itself, \`${command}\`, failed (exit ${result.exitCode}) after ${secs}s`;
-}
-function retryPrompt(result, command) {
-  return [
-    `Your change does not pass this project's own check.`,
-    ``,
-    `The daemon ran \`${command}\` in the repository root and it failed with exit ${result.exitCode}.`,
-    `You did not run this and cannot run it; this output is the only evidence you get.`,
-    ``,
-    "```",
-    result.output || "(the command produced no output)",
-    "```",
-    ``,
-    `Fix what this reports, in the files you already changed where possible. Do not disable`,
-    `the check, do not edit what the command runs, and do not change unrelated code to make`,
-    `it pass. If the failure is not caused by your change, say so plainly and stop.`
-  ].join("\n");
-}
-
 // ../daemon/src/run-job.ts
 var QUICK_RUNS = { reword: runRewordJob, talk: runTalkJob };
 async function runJob(job, ctx) {
@@ -10660,8 +10763,8 @@ async function runJob(job, ctx) {
   return outcome;
 }
 async function execute(job, skill, ctx, events) {
-  const runDir = join10(nanopmHome(), "run", job.id);
-  await mkdir4(runDir, { recursive: true, mode: 448 });
+  const runDir = join12(nanopmHome(), "run", job.id);
+  await mkdir5(runDir, { recursive: true, mode: 448 });
   const resumeSessionId = job.resume_of ? await sessionOf(ctx.client, job.resume_of) : void 0;
   const sessionId = resumeSessionId ?? randomUUID12();
   await ctx.client.from("jobs").update({ harness_session_id: sessionId }).eq("id", job.id);
@@ -10705,14 +10808,14 @@ async function execute(job, skill, ctx, events) {
       clearTimeout(timer);
       clearInterval(heartbeat2);
       clearInterval(cancelPoll);
-      await rm3(runDir, { recursive: true, force: true });
+      await rm4(runDir, { recursive: true, force: true });
     }
   }
   const quickRun2 = QUICK_RUNS[job.skill];
   if (quickRun2) {
     const cwd2 = scratchDir(job.id);
     try {
-      await mkdir4(cwd2, { recursive: true, mode: 448 });
+      await mkdir5(cwd2, { recursive: true, mode: 448 });
       const caps = skill.manifest.capabilities;
       return await quickRun2({
         client: ctx.client,
@@ -10732,13 +10835,22 @@ async function execute(job, skill, ctx, events) {
       clearTimeout(timer);
       clearInterval(heartbeat2);
       clearInterval(cancelPoll);
-      await rm3(runDir, { recursive: true, force: true });
-      await rm3(cwd2, { recursive: true, force: true });
+      await rm4(runDir, { recursive: true, force: true });
+      await rm4(cwd2, { recursive: true, force: true });
     }
   }
-  const capabilities = capCapabilities(skill.manifest.capabilities, autonomy2);
+  const capabilities = capCapabilities(skill.manifest.capabilities, autonomy2, { asked: skill.manifest.asked && job.requested_by === ctx.userId });
   const harnessWeb = await claudeSearches(searchProvider);
-  const cwd = await resolveCwd(ctx, job, params, scratchDir(job.id), capabilities.includes("write_repo"));
+  let cwd = await resolveCwd(ctx, job, params, scratchDir(job.id), capabilities.includes("write_repo"));
+  const prepared = job.skill === BUILD_SKILL ? await prepareBuild(ctx.client, job, cwd, adapter) : null;
+  if (prepared && !prepared.ok) {
+    clearTimeout(timer);
+    clearInterval(heartbeat2);
+    clearInterval(cancelPoll);
+    return prepared.outcome;
+  }
+  const build2 = prepared?.build;
+  if (build2) cwd = build2.dir;
   const definitionsRead = job.skill === "onboard" && !job.resume_of ? readDefinitions({
     adapter,
     spec: { cwd, runDir, systemPrompt: "", prompt: "", capabilities: [], mcp: [], maxTurns: 1, sessionId, env: harnessEnv(timeoutMs), signal: abort.signal },
@@ -10762,29 +10874,6 @@ async function execute(job, skill, ctx, events) {
     const read6 = site.pages.length ? `read ${site.pages.map((p) => new URL(p.url).pathname).join(", ")} on ${site.host}` : `could not read ${site.host}`;
     await logActivity(ctx, job, "scan.site", site.missed.length ? `${read6} (${site.missed.length} not read)` : read6);
   }
-  let item;
-  let session2;
-  if (capabilities.includes("write_repo")) {
-    const solutionId = params.solution_id;
-    if (typeof solutionId !== "string" || !solutionId) {
-      clearTimeout(timer);
-      clearInterval(heartbeat2);
-      clearInterval(cancelPoll);
-      return { status: "failed", error: { code: "harness_error", message: "this job names no solution to build" } };
-    }
-    try {
-      item = await loadAcceptedSolution(ctx.client, job.project_id, solutionId);
-      session2 = await openRepoSession(cwd, item.ref);
-      await startSolution(ctx.client, job.project_id, item.ref, job.id);
-      params.item = renderSolution(item);
-      await logActivity(ctx, job, "repo.branch", `working on ${session2.branch}`);
-    } catch (err) {
-      clearTimeout(timer);
-      clearInterval(heartbeat2);
-      clearInterval(cancelPoll);
-      return { status: "failed", error: { code: "harness_error", message: errorMessage(err) } };
-    }
-  }
   const spec2 = {
     cwd,
     runDir,
@@ -10804,20 +10893,21 @@ async function execute(job, skill, ctx, events) {
     ].filter(Boolean).join("\n\n"),
     capabilities,
     harnessWeb,
+    network: build2?.network,
     withoutTools: skill.manifest.withoutTools,
     // The workspace reaches the memory server only for a job that changes files; that is
-    // what lets `remove_files` refuse everywhere else.
+    // what lets the build's tools refuse everywhere else.
     mcp: ctx.mcpServers?.(job, timeoutMs, capabilities.includes("write_repo") ? cwd : void 0) ?? [],
     model: skill.manifest.model,
     maxTurns: skill.manifest.maxTurns,
     sessionId,
     resumeSessionId,
-    env: harnessEnv(timeoutMs),
+    // Print mode kills a background task when the turn ends; a build waits on its commands (§9).
+    env: build2 ? { ...harnessEnv(timeoutMs), CLAUDE_CODE_DISABLE_BACKGROUND_TASKS: "1" } : harnessEnv(timeoutMs),
     signal: abort.signal
   };
   const verifyCommand2 = project?.preferences?.verify_command?.trim() || null;
   let outcome;
-  let verified;
   let webCalls = 0;
   const onHarnessEvent = async (event) => {
     await events.harness(event);
@@ -10835,9 +10925,27 @@ async function execute(job, skill, ctx, events) {
     return result;
   };
   try {
-    if (job.skill === "personas") {
+    if (build2) {
       try {
-        return await runPersonaJob({ client: ctx.client, job, adapter, spec: spec2, onEvent: onHarnessEvent });
+        return await runBuildJob({
+          client: ctx.client,
+          job,
+          adapter,
+          build: build2,
+          spec: spec2,
+          verifyCommand: verifyCommand2,
+          events,
+          onEvent: onHarnessEvent,
+          log: (step, summary, result) => logActivity(ctx, job, step, summary, result ? { outcome: result } : {})
+        });
+      } catch (error) {
+        if (cancelled) return { status: "cancelled" };
+        return { status: "failed", error: { code: timedOut ? "timeout" : "harness_error", message: errorMessage(error) } };
+      }
+    }
+    if (job.skill === "personas") {
+      try {
+        return await runPersonaJob({ client: ctx.client, job, adapter, spec: spec2, onEvent: onHarnessEvent });
       } catch (error) {
         if (cancelled) return { status: "cancelled" };
         return { status: "failed", error: { code: timedOut ? "timeout" : "harness_error", message: errorMessage(error) } };
@@ -10915,83 +11023,23 @@ async function execute(job, skill, ctx, events) {
         return { status: "failed", error: { code: timedOut ? "timeout" : "harness_error", message: errorMessage(error) } };
       }
     }
-    for (let attempt7 = 1; attempt7 <= 2; attempt7 += 1) {
-      const attemptSpec = attempt7 === 1 ? spec2 : { ...spec2, prompt: retryPrompt(verified, verifyCommand2), resumeSessionId: sessionId };
-      let attemptOutcome;
-      webCalls = 0;
-      for await (const event of adapter.run(attemptSpec)) {
-        await onHarnessEvent(event);
-        if (event.type === "finished") {
-          attemptOutcome = { status: "succeeded", result: event.result, usage: event.usage };
-        } else if (event.type === "failed") {
-          attemptOutcome = { status: "failed", error: { code: event.code, message: event.message } };
-        }
+    for await (const event of adapter.run(spec2)) {
+      await onHarnessEvent(event);
+      if (event.type === "finished") {
+        outcome = { status: "succeeded", result: event.result, usage: event.usage };
+      } else if (event.type === "failed") {
+        outcome = { status: "failed", error: { code: event.code, message: event.message } };
       }
-      if (attemptOutcome) await noteIfItNeverSearched(attemptOutcome, capabilities.includes("read_web"));
-      outcome = mergeAttempts(outcome, attemptOutcome);
-      if (attemptOutcome?.status !== "succeeded" || !session2 || !verifyCommand2) break;
-      verified = await verify({
-        cwd,
-        command: verifyCommand2,
-        env: harnessEnv(timeoutMs),
-        changed: await changedFiles(cwd),
-        signal: abort.signal
-      });
-      await logActivity(ctx, job, "repo.verify", renderVerifyResult(verified, verifyCommand2), {
-        outcome: verified.passed ? "ok" : "error",
-        usage: { duration_ms: verified.durationMs }
-      });
-      await events.write("text", { text: renderVerifyResult(verified, verifyCommand2) });
-      if (verified.passed || !verified.ran || attempt7 === 2) break;
     }
+    if (outcome) await noteIfItNeverSearched(outcome, capabilities.includes("read_web"));
   } finally {
     clearTimeout(timer);
     clearInterval(heartbeat2);
     clearInterval(cancelPoll);
     await definitionsRead;
-    await rm3(runDir, { recursive: true, force: true });
-  }
-  if (outcome?.status === "succeeded" && verified && verified.ran && !verified.passed) {
-    outcome = {
-      ...outcome,
-      status: "failed",
-      error: {
-        code: "harness_error",
-        message: `${renderVerifyResult(verified, verifyCommand2)}. The work is on the branch; the solution stays accepted.`
-      }
-    };
-  }
-  if (outcome?.status === "succeeded") {
-    if (!session2 || !item) return outcome;
-    try {
-      const repo = await closeRepoSession(cwd, session2, item);
-      await logActivity(ctx, job, "repo.commit", renderRepoResult(repo).split("\n")[0]);
-      if (!repo.commit) {
-        await unstartSolution(ctx.client, job.project_id, item.ref).catch(() => void 0);
-        return {
-          ...outcome,
-          status: "failed",
-          error: { code: "harness_error", message: "the skill finished without changing anything" }
-        };
-      }
-      await finishSolution(ctx.client, job, item, repo);
-      return { ...outcome, result: [outcome.result, "", renderRepoResult(repo)].filter((l) => l !== void 0).join("\n") };
-    } catch (err) {
-      return {
-        ...outcome,
-        status: "failed",
-        error: { code: "harness_error", message: errorMessage(err) }
-      };
-    }
-  }
-  if (session2) {
-    const kept = await abandonRepoSession(cwd, session2, verified?.ran && !verified.passed ? item : void 0).catch(() => void 0);
-    if (item) await unstartSolution(ctx.client, job.project_id, item.ref).catch(() => void 0);
-    if (kept?.commit) {
-      await logActivity(ctx, job, "repo.commit", renderRepoResult(kept).split("\n")[0], { outcome: "error" });
-      if (outcome) outcome = { ...outcome, result: [outcome.result, "", renderRepoResult(kept)].filter(Boolean).join("\n") };
-    }
+    await rm4(runDir, { recursive: true, force: true });
   }
+  if (outcome?.status === "succeeded") return outcome;
   if (cancelled) return { status: "cancelled" };
   if (timedOut) {
     return { status: "failed", error: { code: "timeout", message: `exceeded the ${skill.manifest.timeout} cap` } };
@@ -11002,10 +11050,6 @@ async function sessionOf(client, jobId) {
   const { data } = await client.from("jobs").select("harness_session_id").eq("id", jobId).maybeSingle();
   return data?.harness_session_id ?? void 0;
 }
-function mergeAttempts(first, second) {
-  if (!first?.usage || !second?.usage) return second ?? first;
-  return { ...second, usage: sumUsage(first.usage, second.usage) };
-}
 async function askForTheSite(ctx, job, project, events) {
   const started = Date.now();
   const search = await searchForSite(project.name);
@@ -11031,7 +11075,7 @@ function harnessWebFor(searchProvider, machineCanSearch) {
 }
 async function machineWebSearch() {
   try {
-    const parsed = JSON.parse(await readFile6(join10(nanopmHome(), "daemon.json"), "utf8"));
+    const parsed = JSON.parse(await readFile8(join12(nanopmHome(), "daemon.json"), "utf8"));
     return parsed.webSearch === true;
   } catch {
     return false;
@@ -11073,7 +11117,7 @@ function buildHeader(job, project, cwd, harnessWeb = false, memory = false) {
   return lines.join("\n");
 }
 function scratchDir(jobId) {
-  return join10(tmpdir(), `nanopm-run-${jobId}`);
+  return join12(tmpdir(), `nanopm-run-${jobId}`);
 }
 async function resolveCwd(ctx, job, params, fallback, mustBeTheClone = false) {
   const refuse2 = (why) => {
@@ -11082,12 +11126,12 @@ async function resolveCwd(ctx, job, params, fallback, mustBeTheClone = false) {
   const requested = params.repo_path;
   if (typeof requested !== "string" || !requested) {
     if (mustBeTheClone) refuse2("the job named no repository");
-    await mkdir4(fallback, { recursive: true, mode: 448 });
+    await mkdir5(fallback, { recursive: true, mode: 448 });
     return fallback;
   }
   if (!job.project_id) {
     if (mustBeTheClone) refuse2("the job belongs to no project");
-    await mkdir4(fallback, { recursive: true, mode: 448 });
+    await mkdir5(fallback, { recursive: true, mode: 448 });
     return fallback;
   }
   const { data: clone } = await ctx.client.from("clones").select("repo_path").eq("project_id", job.project_id).eq("daemon_id", ctx.daemonId).maybeSingle();
@@ -11095,12 +11139,12 @@ async function resolveCwd(ctx, job, params, fallback, mustBeTheClone = false) {
   if (!allowed || resolve4(allowed) !== resolve4(requested)) {
     if (mustBeTheClone) refuse2(`${requested} is not the clone recorded for this project on this machine. Run any \`nanopm\` command inside your clone here to record it`);
     console.error(`job ${job.id}: repo_path ${requested} is not this machine's clone; running in a scratch directory instead`);
-    await mkdir4(fallback, { recursive: true, mode: 448 });
+    await mkdir5(fallback, { recursive: true, mode: 448 });
     return fallback;
   }
   if (existsSync4(allowed)) return resolve4(allowed);
   if (mustBeTheClone) refuse2(`${allowed} is not on this machine any more`);
-  await mkdir4(fallback, { recursive: true, mode: 448 });
+  await mkdir5(fallback, { recursive: true, mode: 448 });
   return fallback;
 }
 function asData8(label, body) {
@@ -11109,10 +11153,10 @@ ${body}
 </${label}>`;
 }
 function harnessEnv(timeoutMs, source = process.env) {
-  const home = source.HOME ?? homedir3();
+  const home = source.HOME ?? homedir4();
   const env = {
     HOME: home,
-    PATH: [source.PATH ?? "/usr/local/bin:/usr/bin:/bin", join10(home, ".local", "bin")].join(":"),
+    PATH: [source.PATH ?? "/usr/local/bin:/usr/bin:/bin", join12(home, ".local", "bin")].join(":"),
     MCP_TOOL_TIMEOUT: String(timeoutMs)
   };
   for (const key of ["USER", "LANG", "TMPDIR", "SHELL", "ANTHROPIC_API_KEY", "CLAUDE_CONFIG_DIR"]) {
@@ -11289,12 +11333,12 @@ async function chainAfter(auth, job, outcome, log) {
   const parent = job.parent_job_id ? await parentOf(auth, job.parent_job_id) : null;
   const own = job.params ?? {};
   const deep = own.depth === "deep" && job.trigger === "hook";
-  const next2 = daemonQueues(job.skill, 0, parent?.skill ?? null, deep);
-  if (!next2.length) return;
+  const next = daemonQueues(job.skill, 0, parent?.skill ?? null, deep);
+  if (!next.length) return;
   if (await chainDepth(auth, job) >= CHAIN_DEPTH_MAX) return;
   const from = deep ? own.repo_path : parent?.params?.repo_path;
   const repo = typeof from === "string" ? { repo_path: from } : null;
-  for (const skill of next2) {
+  for (const skill of next) {
     const params = { ...repo ?? {}, ...deep ? { depth: "deep", background: true } : {} };
     const { data, error } = await auth.client.from("jobs").insert({
       project_id: job.project_id,
@@ -11377,7 +11421,7 @@ var heldInThisProcess = false;
 function acquireLock() {
   if (heldInThisProcess) throw new Error("a nanopm daemon is already running in this process");
   mkdirSync(nanopmHome(), { recursive: true, mode: 448 });
-  const path = join11(nanopmHome(), "daemon.pid");
+  const path = join13(nanopmHome(), "daemon.pid");
   for (; ; ) {
     try {
       const fd = openSync(path, "wx");
@@ -11464,13 +11508,13 @@ async function reclaimOwnJobs(client, daemonId) {
 async function harnessPids(runDir) {
   const dirs = [runDir];
   try {
-    for (const d of await readdir2(runDir, { withFileTypes: true })) if (d.isDirectory()) dirs.push(join11(runDir, d.name));
+    for (const d of await readdir3(runDir, { withFileTypes: true })) if (d.isDirectory()) dirs.push(join13(runDir, d.name));
   } catch {
   }
   const pids = [];
   for (const dir of dirs) {
     try {
-      const pid = Number((await readFile7(join11(dir, "harness.pid"), "utf8")).trim());
+      const pid = Number((await readFile9(join13(dir, "harness.pid"), "utf8")).trim());
       if (pid > 1) pids.push(pid);
     } catch {
     }
@@ -11478,20 +11522,20 @@ async function harnessPids(runDir) {
   return pids;
 }
 async function killOrphanedHarness(jobId) {
-  const runDir = join11(nanopmHome(), "run", jobId);
+  const runDir = join13(nanopmHome(), "run", jobId);
   for (const pid of await harnessPids(runDir)) {
     try {
       process.kill(pid, "SIGTERM");
     } catch {
     }
   }
-  await rm4(runDir, { recursive: true, force: true });
+  await rm5(runDir, { recursive: true, force: true });
 }
 async function registerDaemon(auth, version, opts = {}) {
-  const path = join11(nanopmHome(), "daemon.json");
+  const path = join13(nanopmHome(), "daemon.json");
   let identity = null;
   try {
-    identity = JSON.parse(await readFile7(path, "utf8"));
+    identity = JSON.parse(await readFile9(path, "utf8"));
   } catch {
     identity = null;
   }
@@ -11529,8 +11573,8 @@ async function registerDaemon(auth, version, opts = {}) {
   return data.id;
 }
 async function rememberDaemon(id, shared = false) {
-  await mkdir5(nanopmHome(), { recursive: true, mode: 448 });
-  await writeFile4(join11(nanopmHome(), "daemon.json"), JSON.stringify({ id, shared }, null, 2) + "\n", { mode: 384 });
+  await mkdir6(nanopmHome(), { recursive: true, mode: 448 });
+  await writeFile6(join13(nanopmHome(), "daemon.json"), JSON.stringify({ id, shared }, null, 2) + "\n", { mode: 384 });
 }
 async function heartbeat(client, daemonId) {
   await client.from("daemons").update({ status: "online", last_seen_at: (/* @__PURE__ */ new Date()).toISOString() }).eq("id", daemonId);
@@ -11881,48 +11925,6 @@ function refuseFetch(url, allowlist, open = false) {
   return `${host} is not on this project's allowlist, so it was not read. The founder can allow it: if it is a competitor, \`nanopm market confirm <ref>\` on the entry that names them, or \`nanopm market add <name> ${host}\`. Until then, search results and the sites already allowed are what there is.`;
 }
 
-// ../memory-mcp/src/repo-rules.ts
-import { lstat, unlink } from "fs/promises";
-import { relative as relative3, resolve as resolve5, sep as sep2 } from "path";
-var REMOVE_MAX = 50;
-function refuseRemove(workspace, requested) {
-  const root2 = resolve5(workspace);
-  const target = resolve5(root2, requested);
-  const rel = relative3(root2, target);
-  if (!rel || rel.startsWith("..") || rel.startsWith(`..${sep2}`)) return "outside the workspace";
-  if (rel === ".git" || rel.startsWith(`.git${sep2}`)) return "inside .git";
-  if (looksLikeASecret(rel)) return "looks like a secret, which the agent may neither read nor remove";
-  return null;
-}
-async function removeFiles(workspace, paths) {
-  const out = [];
-  for (const requested of paths.slice(0, REMOVE_MAX)) {
-    const refusal = refuseRemove(workspace, requested);
-    if (refusal) {
-      out.push({ path: requested, removed: false, reason: refusal });
-      continue;
-    }
-    const target = resolve5(workspace, requested);
-    try {
-      const stat2 = await lstat(target);
-      if (stat2.isSymbolicLink()) {
-        out.push({ path: requested, removed: false, reason: "a symlink; what it points at is not touched" });
-        continue;
-      }
-      if (stat2.isDirectory()) {
-        out.push({ path: requested, removed: false, reason: "a directory; name the files in it" });
-        continue;
-      }
-      await unlink(target);
-      out.push({ path: requested, removed: true });
-    } catch (err) {
-      const code = err.code;
-      out.push({ path: requested, removed: false, reason: code === "ENOENT" ? "not there" : err instanceof Error ? err.message : String(err) });
-    }
-  }
-  return out;
-}
-
 // ../memory-mcp/src/problem-rules.ts
 import { z as z20 } from "zod";
 var STATEMENT_MAX = 300;
@@ -12297,7 +12299,7 @@ ${renderMap()}`,
       }
     },
     async ({ ref, outcome, note }) => {
-      return json(await finishSolution2(ctx, ref, outcome, note));
+      return json(await finishSolution(ctx, ref, outcome, note));
     }
   );
   server.registerTool(
@@ -12397,20 +12399,20 @@ ${renderMap()}`,
     }
   );
   server.registerTool(
-    "remove_files",
+    "build_plan",
     {
-      description: "Delete files in the repository you are working in. Paths relative to the repository root, at most 50. Refused: anything outside the repository, inside .git, a symlink, a directory, or a file that looks like a secret. A file you mean to delete should be deleted with this, not emptied or replaced with a note \u2014 a stub is not a deletion.",
-      inputSchema: { paths: z21.array(z21.string().min(1).max(500)).min(1).max(REMOVE_MAX) }
+      description: `Say the plan before you change anything: ${BUILD_STEPS_MIN} to ${BUILD_STEPS_MAX} steps, in order, each one change the founder can recognise, in their words (at most ${BUILD_STEP_MAX} characters). The last step is your own check of the whole change. Call it once; the founder sees it as a checklist.`,
+      inputSchema: { steps: z21.array(z21.string().min(3).max(BUILD_STEP_MAX)).min(BUILD_STEPS_MIN).max(BUILD_STEPS_MAX) }
     },
-    async ({ paths }) => {
-      if (!ctx.workspace) return failure("this job has no repository to remove files from");
-      const outcomes = await removeFiles(ctx.workspace, paths);
-      const removed = outcomes.filter((o) => o.removed).map((o) => o.path);
-      await logActivity2(ctx, "repo.remove", `removed ${removed.length} of ${paths.length} files${removed.length ? `: ${trim2(removed.join(", "), 200)}` : ""}`, {
-        outcome: removed.length === paths.length ? "ok" : "error"
-      });
-      return json({ outcomes, note: removed.length ? "Removed. The commit at the end of this job will record the deletions." : "Nothing was removed." });
-    }
+    async ({ steps }) => ctx.workspace ? json({ recorded: steps.length, note: "Recorded. Build step 1 now; call build_step when it is done." }) : failure("this job builds nothing")
+  );
+  server.registerTool(
+    "build_step",
+    {
+      description: "A step of your plan is done and its checks pass: NanoPM commits the worktree now, with the step as the message, and ticks it for the founder. Call it once per step, in order, after the step works. Do not run git commit yourself.",
+      inputSchema: { step: z21.number().int().min(1).max(BUILD_STEPS_MAX), summary: z21.string().min(3).max(300) }
+    },
+    async ({ step }) => ctx.workspace ? json({ step, note: "Committed by NanoPM. Go on with the next step, or stop when the plan is done." }) : failure("this job builds nothing")
   );
   server.registerTool(
     "web_search",
@@ -13197,7 +13199,7 @@ async function markFast(ctx, problemRef) {
   await logActivity2(ctx, "problems.fast", `${problem.ref} is one small change`);
   return { problem: problem.ref, fast: true };
 }
-async function finishSolution2(ctx, ref, outcome, note) {
+async function finishSolution(ctx, ref, outcome, note) {
   if (ctx.actor === "mapping-review") throw new Error("A targeted collection cannot decide solution outcomes.");
   const upper = ref.toUpperCase();
   const { data: current } = await ctx.client.from("solutions").select("status").eq("project_id", ctx.projectId).eq("ref", upper).is("superseded_by", null).maybeSingle();
@@ -13495,7 +13497,8 @@ var MEMORY_TOOL_NAMES = [
   "play_store_search",
   "list_market",
   "write_market",
-  "remove_files",
+  "build_plan",
+  "build_step",
   // Talk to Nano (docs/✅nanopm-68-talk-to-nano.md): the map read, and changed as the founder asked.
   ...TALK_TOOLS
 ];
@@ -13506,7 +13509,7 @@ async function startMemoryServer(env = process.env) {
 }
 
 // src/commands/add.ts
-import { readFile as readFile9 } from "fs/promises";
+import { readFile as readFile11 } from "fs/promises";
 
 // src/project.ts
 import { execFile as execFile7 } from "child_process";
@@ -13514,11 +13517,11 @@ import { basename } from "path";
 import { promisify as promisify7 } from "util";
 
 // src/local.ts
-import { readFile as readFile8 } from "fs/promises";
-import { join as join12 } from "path";
+import { readFile as readFile10 } from "fs/promises";
+import { join as join14 } from "path";
 async function localDaemonId() {
   try {
-    const parsed = JSON.parse(await readFile8(join12(nanopmHome(), "daemon.json"), "utf8"));
+    const parsed = JSON.parse(await readFile10(join14(nanopmHome(), "daemon.json"), "utf8"));
     return parsed.id ?? null;
   } catch {
     return null;
@@ -13653,7 +13656,7 @@ async function add(file, opts) {
     text2 = await readStdin();
   } else {
     try {
-      text2 = await readFile9(file, "utf8");
+      text2 = await readFile11(file, "utf8");
     } catch {
       throw new Error(`could not read ${file}`);
     }
@@ -13668,7 +13671,7 @@ async function add(file, opts) {
 }
 
 // src/commands/run.ts
-import { readFile as readFile10 } from "fs/promises";
+import { readFile as readFile12 } from "fs/promises";
 import { createInterface as createInterface2 } from "readline/promises";
 import { setTimeout as sleep3 } from "timers/promises";
 
@@ -13835,7 +13838,7 @@ function phaseOf(tool) {
   if (name === "query") return "data";
   if (name === "web_search" || name === "web_fetch") return "web";
   if (REVIEW_WRITES.has(name)) return "review";
-  if (name === "remove_files") return "build";
+  if (name === "build_plan" || name === "build_step") return "build";
   return null;
 }
 function touched(tool, input) {
@@ -14000,7 +14003,7 @@ function questionBlock(p) {
 
 // src/commands/run.ts
 async function answersFromFile(path) {
-  const raw = JSON.parse(await readFile10(path, "utf8"));
+  const raw = JSON.parse(await readFile12(path, "utf8"));
   const entries = raw.map((a) => typeof a === "string" ? { answer: a } : a);
   return scriptedAnswerer(entries);
 }
@@ -14223,15 +14226,15 @@ async function askOne(auth, projectId, question, daemonId, opts, out) {
 // src/commands/daemon-service.ts
 import { execFile as execFile8 } from "child_process";
 import { existsSync as existsSync5 } from "fs";
-import { mkdir as mkdir6, readFile as readFile11, rm as rm5, writeFile as writeFile5 } from "fs/promises";
-import { homedir as homedir4 } from "os";
-import { join as join13 } from "path";
+import { mkdir as mkdir7, readFile as readFile13, rm as rm6, writeFile as writeFile7 } from "fs/promises";
+import { homedir as homedir5 } from "os";
+import { join as join15 } from "path";
 import { promisify as promisify8 } from "util";
 
 // package.json
 var package_default = {
   name: "@nanopm/cli",
-  version: "0.1.8",
+  version: "0.1.11",
   description: "An autonomous product manager for builders who run several small products. Runs on your machine, drives your own coding harness.",
   type: "module",
   license: "MIT",
@@ -14283,10 +14286,10 @@ var VERSION = package_default.version;
 var execFileAsync8 = promisify8(execFile8);
 var LAUNCHD_LABEL = "pm.nano.daemon";
 function plistPath() {
-  return join13(homedir4(), "Library", "LaunchAgents", `${LAUNCHD_LABEL}.plist`);
+  return join15(homedir5(), "Library", "LaunchAgents", `${LAUNCHD_LABEL}.plist`);
 }
 function daemonLogPath() {
-  return join13(nanopmHome(), "daemon.log");
+  return join15(nanopmHome(), "daemon.log");
 }
 function renderPlist(opts) {
   const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
@@ -14345,13 +14348,13 @@ async function installDaemon(out = (l) => console.log(l), opts = {}) {
   out(web.ok ? "Claude's own search answers; searches go through your subscription." : `Claude's search is not available on this machine (${web.message}); searches use DuckDuckGo.`);
   const bin = process.argv[1];
   if (!bin) throw new Error("cannot locate the nanopm binary");
-  const home = homedir4();
-  const path = [process.env.PATH ?? "/usr/local/bin:/usr/bin:/bin", join13(home, ".local", "bin")].join(":");
-  await mkdir6(join13(home, "Library", "LaunchAgents"), { recursive: true });
-  await mkdir6(nanopmHome(), { recursive: true, mode: 448 });
+  const home = homedir5();
+  const path = [process.env.PATH ?? "/usr/local/bin:/usr/bin:/bin", join15(home, ".local", "bin")].join(":");
+  await mkdir7(join15(home, "Library", "LaunchAgents"), { recursive: true });
+  await mkdir7(nanopmHome(), { recursive: true, mode: 448 });
   if (opts.shared !== void 0) await rememberShared(opts.shared);
   await found({ ...detection, authenticated: true });
-  await writeFile5(plistPath(), renderPlist({ node: process.execPath, bin, home, path, logPath: daemonLogPath(), nanopmHome: nanopmHome() }), { mode: 420 });
+  await writeFile7(plistPath(), renderPlist({ node: process.execPath, bin, home, path, logPath: daemonLogPath(), nanopmHome: nanopmHome() }), { mode: 420 });
   const target = guiTarget();
   await execFileAsync8("launchctl", ["bootout", target, plistPath()]).catch(() => void 0);
   await execFileAsync8("launchctl", ["bootstrap", target, plistPath()]);
@@ -14372,7 +14375,7 @@ async function uninstallDaemon(out = (l) => console.log(l)) {
   requireMac();
   const target = guiTarget();
   await execFileAsync8("launchctl", ["bootout", target, plistPath()]).catch(() => void 0);
-  await rm5(plistPath(), { force: true });
+  await rm6(plistPath(), { force: true });
   out(`Removed ${LAUNCHD_LABEL}.`);
 }
 async function daemonStatus(out = (l) => console.log(l)) {
@@ -14399,7 +14402,7 @@ async function daemonStatus(out = (l) => console.log(l)) {
 }
 async function daemonLogs(lines = 50) {
   try {
-    const text2 = await readFile11(daemonLogPath(), "utf8");
+    const text2 = await readFile13(daemonLogPath(), "utf8");
     return text2.trimEnd().split("\n").slice(-lines).join("\n");
   } catch {
     return `no log at ${daemonLogPath()} yet`;
@@ -14407,41 +14410,41 @@ async function daemonLogs(lines = 50) {
 }
 async function localWebSearch() {
   try {
-    const parsed = JSON.parse(await readFile11(join13(nanopmHome(), "daemon.json"), "utf8"));
+    const parsed = JSON.parse(await readFile13(join15(nanopmHome(), "daemon.json"), "utf8"));
     return parsed.webSearch === true;
   } catch {
     return false;
   }
 }
 async function rememberWebSearch(webSearch2) {
-  const path = join13(nanopmHome(), "daemon.json");
+  const path = join15(nanopmHome(), "daemon.json");
   let parsed = {};
   try {
-    parsed = JSON.parse(await readFile11(path, "utf8"));
+    parsed = JSON.parse(await readFile13(path, "utf8"));
   } catch {
     parsed = {};
   }
-  await mkdir6(nanopmHome(), { recursive: true, mode: 448 });
-  await writeFile5(path, JSON.stringify({ ...parsed, webSearch: webSearch2 }, null, 2) + "\n", { mode: 384 });
+  await mkdir7(nanopmHome(), { recursive: true, mode: 448 });
+  await writeFile7(path, JSON.stringify({ ...parsed, webSearch: webSearch2 }, null, 2) + "\n", { mode: 384 });
 }
 async function localShared() {
   try {
-    const parsed = JSON.parse(await readFile11(join13(nanopmHome(), "daemon.json"), "utf8"));
+    const parsed = JSON.parse(await readFile13(join15(nanopmHome(), "daemon.json"), "utf8"));
     return Boolean(parsed.shared);
   } catch {
     return false;
   }
 }
 async function rememberShared(shared) {
-  const path = join13(nanopmHome(), "daemon.json");
+  const path = join15(nanopmHome(), "daemon.json");
   let parsed = {};
   try {
-    parsed = JSON.parse(await readFile11(path, "utf8"));
+    parsed = JSON.parse(await readFile13(path, "utf8"));
   } catch {
     parsed = {};
   }
-  await mkdir6(nanopmHome(), { recursive: true, mode: 448 });
-  await writeFile5(path, JSON.stringify({ ...parsed, shared }, null, 2) + "\n", { mode: 384 });
+  await mkdir7(nanopmHome(), { recursive: true, mode: 448 });
+  await writeFile7(path, JSON.stringify({ ...parsed, shared }, null, 2) + "\n", { mode: 384 });
 }
 
 // src/format/log.ts
@@ -14684,497 +14687,141 @@ The install line does the same: curl -fsSL https://nanopm.app/install | sh`);
   out(await restartDaemon() ? `Updated ${VERSION} \u2192 ${latest}; the daemon restarted on it.` : `Updated ${VERSION} \u2192 ${latest}.`);
 }
 
-// src/format/roadmap.ts
-var SHAPE = {
-  proposed: { mark: "\u25CB", colour: ANSI.amber, label: "proposed" },
-  accepted: { mark: "\u25D0", colour: ANSI.green, label: "accepted" },
-  building: { mark: "\u25D4", colour: ANSI.blue, label: "building" },
-  rejected: { mark: "\u2298", colour: ANSI.red, label: "rejected" },
-  done: { mark: "\u25CF", colour: ANSI.green, label: "done" },
-  dropped: { mark: "\u2298", colour: ANSI.dim, label: "dropped" }
-};
-var WORK_KINDS = /* @__PURE__ */ new Set(["branch", "git", "url", "job"]);
-function renderRoadmapItem(item, opts, problem, builtBy) {
-  const paint = painter(opts.color);
-  const shape2 = SHAPE[item.status] ?? { mark: "\xB7", colour: "", label: item.status };
-  const out = [`${paint(shape2.colour, shape2.mark)} ${paint(ANSI.bold, item.ref)}  ${item.title}`];
-  if (problem) out.push(paint(ANSI.dim, `  answers ${problem.ref}  ${clip(problem.statement, Math.max(30, columns() - 20))}`));
-  out.push("");
-  for (const line of wrap(item.reasoning, Math.max(40, columns() - 4))) out.push(`  ${line}`);
-  out.push("");
-  const facts = [
-    ["status", shape2.label + (item.outcome ? ` \xB7 ${item.outcome}${item.outcome_note ? `: ${item.outcome_note}` : ""}` : "")],
-    ["rank", String(item.rank)],
-    ["who", item.actor === "founder" ? "you" : "NanoPM"],
-    ["bets on", item.assumption ?? "\u2014"],
-    ["we'll know", item.eval ?? "\u2014"]
-  ];
-  for (const [k, v] of facts) out.push(paint(ANSI.dim, `  ${k.padEnd(9)} ${v}`));
-  const sources2 = item.sources ?? [];
-  const restsOn = sources2.filter((s) => !WORK_KINDS.has(s.kind));
-  if (restsOn.length) {
-    out.push(paint(ANSI.dim, `  ${"rests on".padEnd(9)} ${restsOn.map((s) => `${s.kind}:${s.ref}`).join(", ")}`));
-  }
-  const where = renderWhere(sources2);
-  if (where) out.push(paint(ANSI.dim, `  ${"where".padEnd(9)} ${where}${builtBy ? ` \xB7 built by ${builtBy}` : ""}`));
-  return out.join("\n");
-}
-function renderWhere(sources2) {
-  const branch = sources2.find((s) => s.kind === "branch")?.ref;
-  const commit = sources2.find((s) => s.kind === "git")?.ref;
-  const url = sources2.find((s) => s.kind === "url")?.ref;
-  return [branch, commit, url].filter(Boolean).join(" \xB7 ");
+// src/commands/autonomy.ts
+async function readAutonomy(client, projectId) {
+  const { data } = await client.from("project_preferences").select("autonomy").eq("project_id", projectId).maybeSingle();
+  return data?.autonomy ?? "propose";
 }
-var VERB = {
-  want: { text: "wanted", colour: ANSI.amber },
-  confirm: { text: "confirmed", colour: ANSI.green },
-  drop: { text: "dropped", colour: ANSI.red },
-  merge: { text: "merged into", colour: ANSI.blue },
-  separate: { text: "kept apart", colour: ANSI.blue },
-  weight: { text: "weighed", colour: ANSI.blue },
-  area: { text: "filed", colour: ANSI.blue },
-  accept: { text: "accepted", colour: ANSI.green },
-  reject: { text: "rejected", colour: ANSI.red },
-  first: { text: "put first", colour: ANSI.blue },
-  done: { text: "did", colour: ANSI.green },
-  dismiss: { text: "dismissed", colour: ANSI.red }
+var EXPLAINED = {
+  propose: "NanoPM reads and proposes. It never changes a file.",
+  execute_after_validation: "NanoPM changes files, on its own branch, after showing you what it will do and waiting for a yes.",
+  execute_then_report: "NanoPM acts first and tells you after. Not available yet."
 };
-function renderDecisions(rows2, opts) {
-  const paint = painter(opts.color);
-  if (!rows2.length) return "No decisions yet.";
-  const out = [];
-  for (const row of rows2) {
-    const when = row.created_at.slice(0, 10);
-    const verb = VERB[row.kind] ?? { text: row.kind, colour: ANSI.blue };
-    const about = row.solutions ? `${paint(ANSI.dim, row.solutions.ref)} ${row.solutions.title}` : row.problems ? paint(ANSI.dim, row.problems.ref) : row.market_entries ? `${paint(ANSI.dim, row.market_entries.ref)} ${row.market_entries.competitor ?? ""}`.trimEnd() : "";
-    const by = row.by ? paint(ANSI.dim, ` \xB7 by ${row.by}`) : "";
-    out.push(`${paint(ANSI.dim, when)}  ${paint(verb.colour, verb.text)} ${about}${by}`.trimEnd());
-    if (row.body) {
-      for (const line of wrap(row.body, 72)) out.push(paint(ANSI.dim, `              ${line}`));
+async function autonomy(level, opts) {
+  const auth = await authenticate();
+  const project = await resolveProject(auth.client, { projectId: opts.projectId, cwd: opts.cwd });
+  const current = await readAutonomy(auth.client, project.id);
+  if (!level) {
+    const lines = [`${project.name} is on "${current}".`, ""];
+    for (const l of AUTONOMY_LEVELS) {
+      lines.push(`  ${l === current ? "\u25CF" : "\u25CB"} ${l.padEnd(26)} ${EXPLAINED[l]}`);
     }
+    lines.push("", "  nanopm autonomy <level>");
+    return lines.join("\n");
   }
-  return out.join("\n");
-}
-var HUE = ["\x1B[34m", "\x1B[35m", "\x1B[36m", "\x1B[32m", "\x1B[95m"];
-function themesOf(tree) {
-  return new Map(tree.map((b) => [b.id, { name: themeName(b), colour: HUE[themeHue(tree, b) - 1] }]));
-}
-function sizeWord(size, paint) {
-  return size === "big" ? `${paint(ANSI.bold, "\u25AA")} ${SIZE_WORD.big}` : size === "small" ? paint(ANSI.dim, SIZE_WORD.small) : "";
+  const wanted = level.trim();
+  if (!AUTONOMY_LEVELS.includes(wanted)) {
+    throw new Error(`"${level}" is not a level. Pick one of: ${AUTONOMY_LEVELS.join(", ")}.`);
+  }
+  if (wanted === "execute_then_report") {
+    throw new Error(
+      "execute_then_report is not available yet. NanoPM asks before it changes anything until the review loop has been used in anger."
+    );
+  }
+  if (wanted === current) return `${project.name} is already on "${current}".`;
+  const { error } = await auth.client.from("project_preferences").update({ autonomy: wanted }).eq("project_id", project.id);
+  if (error) {
+    throw new Error(`could not change the dial: ${error.message}`);
+  }
+  return [`${project.name} is now on "${wanted}".`, EXPLAINED[wanted]].join("\n");
 }
-function renderSolutionsBoard(board, opts) {
-  const paint = painter(opts.color);
-  const width = Math.max(40, columns());
-  const themes = themesOf(board.tree);
-  const out = [`${paint(ANSI.bold, "Roadmap")}${board.objective ? `  ${paint(ANSI.dim, `${board.objective.lever} \u2014 ${board.objective.sentence}`)}` : ""}`];
-  const chips = board.tree.flatMap((b) => {
-    const n = board.cards.filter((c) => c.branch.id === b.id).length;
-    const t = themes.get(b.id);
-    return n ? [`${paint(t.colour, "\u25CF")} ${t.name} ${paint(ANSI.dim, String(n))}`] : [];
-  });
-  const legend = chips.reduce((lines, chip) => {
-    const last = lines.at(-1);
-    if (last !== void 0 && visibleLength(last) + 3 + visibleLength(chip) <= width) lines[lines.length - 1] = `${last}   ${chip}`;
-    else lines.push(chip);
-    return lines;
-  }, []);
-  out.push("", ...legend);
-  if (!board.cards.some((c) => c.pick.placed_by === "founder")) out.push(paint(ANSI.dim, "Nano placed these in the order of your opportunity map. Move them where you want them."));
-  const refWidth = Math.max(5, ...board.cards.map((c) => c.pick.ref.length));
-  const gutter = " ".repeat(refWidth + 4);
-  const titleWidth = Math.min(Math.max(...board.cards.map((c) => c.pick.title.length)), width - gutter.length - 8);
-  for (const h of HORIZONS) {
-    const column = board.cards.filter((c) => c.horizon === h);
-    out.push("", `${paint(ANSI.bold, HORIZON_WORD[h])}  ${paint(ANSI.dim, String(column.length))}`);
-    if (!column.length) out.push(paint(ANSI.dim, `  Move a card here: nanopm roadmap move <ref> ${h}`));
-    for (const c of column) {
-      const t = themes.get(c.branch.id);
-      out.push(`  ${paint(ANSI.dim, c.pick.ref.padEnd(refWidth))}  ${paint(t.colour, "\u25CF")} ${paint(ANSI.dim, t.name)}`);
-      out.push(`${gutter}${clip(c.pick.title, titleWidth).padEnd(titleWidth)}  ${sizeWord(c.pick.size, paint)}`.trimEnd());
-      const depth = board.working.get(c.leaf.id);
-      if (depth) out.push(`${gutter}${paint(ANSI.blue, "\u25CF")} ${paint(ANSI.dim, WORK_WORD[depth])}`);
+async function verifyCommand(command, opts) {
+  const auth = await authenticate();
+  const project = await resolveProject(auth.client, { projectId: opts.projectId, cwd: opts.cwd });
+  const { data } = await auth.client.from("project_preferences").select("verify_command").eq("project_id", project.id).maybeSingle();
+  const current = data?.verify_command ?? null;
+  if (!command && !opts.clear) {
+    if (!current) {
+      return [
+        `${project.name} has no check, so nothing verifies what NanoPM writes.`,
+        "",
+        '  nanopm verify "npm run lint && npm test"',
+        "",
+        "A build runs it in its sandboxed copy of the repository before its last step,",
+        "fixes what it reports, and says the result in the pull request."
+      ].join("\n");
     }
+    return [`${project.name} verifies with:`, "", `  ${current}`, "", '  nanopm verify "<command>" \xB7 nanopm verify --clear'].join("\n");
   }
-  if (board.earlier) out.push("", paint(ANSI.bold, "On the problem list"), "", board.earlier);
-  out.push(
-    "",
-    paint(ANSI.dim, 'nanopm roadmap <ref> \xB7 nanopm roadmap move <ref> now|next|later [position] \xB7 nanopm reject <ref> ["why"]'),
-    paint(ANSI.dim, "nanopm opportunities brainstorm <ref> [--deep]: solutions to another problem, or deeper ones")
-  );
-  return out.join("\n");
+  const next = opts.clear ? null : command.trim();
+  if (next !== null && !next) throw new Error('a check needs a command: nanopm verify "npm test"');
+  const { error } = await auth.client.from("project_preferences").update({ verify_command: next }).eq("project_id", project.id);
+  if (error) throw new Error(`could not save the check: ${error.message}`);
+  if (next === null) return `${project.name} no longer runs a check. Nothing will verify what NanoPM writes.`;
+  return [`${project.name} will verify with:`, "", `  ${next}`, "", "A build runs it in its sandboxed copy of the repository before its last step."].join("\n");
 }
-function renderSolutionSheet(s, at, opts) {
+
+// src/format/opportunities.ts
+function renderOpportunities(rows2, lens, opts) {
   const paint = painter(opts.color);
   const width = Math.max(40, columns());
-  const theme = at.branch ? themesOf(at.tree).get(at.branch.id) : void 0;
   const out = [];
-  if (theme) out.push(`${paint(theme.colour, "\u25CF")} ${paint(ANSI.dim, theme.name)}`);
-  const size = sizeWord(s.size, paint);
-  out.push(`${paint(ANSI.dim, s.ref)}  ${paint(ANSI.bold, s.title)}${size ? `  ${size}` : ""}`);
-  const pad = " ".repeat(12);
-  const heading = (text2) => out.push("", `  ${paint(ANSI.bold, text2)}`);
-  heading("Problem we are solving");
-  if (at.leaf) {
-    const solves = wrap(at.leaf.problem, width - 6 - at.leaf.ref.length - 2);
-    solves[solves.length - 1] += `  ${paint(ANSI.dim, at.leaf.ref)}`;
-    for (const line of solves) out.push(`    ${line}`);
-    if (at.branch && at.branch.id !== at.leaf.id) {
-      for (const line of wrap(`Part of: ${at.branch.problem} ${at.branch.ref}`, width - 6)) out.push(`    ${paint(ANSI.dim, line)}`);
-    }
-  } else {
-    out.push(paint(ANSI.dim, "    The problem it answered is no longer on the map."));
+  if (!lens) return "No objective yet: the map is drawn for it. Say what matters most right now on Your business, then `nanopm opportunities run`.";
+  out.push(`${paint(ANSI.bold, "Opportunities")}  ${paint(ANSI.dim, `${lens.lever} \u2014 ${lens.sentence}`)}`);
+  out.push(paint(ANSI.dim, lens.definition ? `Counts: ${lens.definition}` : "What it counts is not defined yet: drawn against the lever and your sentence."));
+  if (opts.previous) out.push(paint(ANSI.amber, "Drawn for your previous objective. `nanopm opportunities run` draws it for this one."));
+  if (!rows2.length) {
+    out.push("", "No map yet. `nanopm opportunities run` draws it from what NanoPM knows; add --deep to check it against your users, code and data.");
+    return out.join("\n");
   }
-  const described = paragraphs(s.description);
-  if (described.length) {
-    heading("Proposed solution");
-    described.forEach((p, i) => {
-      if (i) out.push("");
-      for (const line of wrap(p, width - 6)) out.push(`    ${line}`);
-    });
-  }
-  const changelog = parseChangelog(s.changelog);
-  if (changelog) {
-    heading("Future changelog");
-    for (const line of wrap(changelog.headline, width - 6)) out.push(`    ${paint(ANSI.bold, line)}`);
-    for (const point of changelog.points) wrap(point, width - 8).forEach((line, i) => out.push(`    ${i ? " " : "\u2022"} ${line}`));
-  }
-  if (s.steps.length) {
-    heading("Plan");
-    s.steps.forEach((step, i) => {
-      const who = STEP_WHO_WORD[step.who] ?? step.who;
-      wrap(step.do, width - pad.length - 8).forEach((line, j) => out.push(`${j ? pad : `    \u2610 ${who.padEnd(6)}`}${line}`));
-      if (step.checks) out.push(pad + paint(ANSI.amber, i === 0 ? "checks the problem first" : "checks the problem"));
-    });
-  }
-  const card = at.leaf ? at.cards.find((c) => c.leaf.id === at.leaf.id) : void 0;
-  const others = card ? card.others.filter((o) => o.id !== s.id) : [];
-  out.push("");
-  if (s.status === "rejected") out.push(paint(ANSI.dim, "  Thrown out."));
-  else if (card?.pick.id === s.id) {
-    const column = at.cards.filter((c) => c.horizon === card.horizon);
-    const yours = s.placed_by === "founder" ? ", where you put it" : "";
-    out.push(paint(ANSI.dim, `  On the board: ${HORIZON_WORD[card.horizon]}, ${column.indexOf(card) + 1} of ${column.length}${yours}.`));
-  } else out.push(paint(ANSI.dim, card ? `  Not on the board: ${card.pick.ref} is this problem's card.` : "  Not on the board."));
-  if (others.length) out.push(paint(ANSI.dim, `  Other solutions to this problem: ${others.map((o) => o.ref).join(", ")}.`));
-  if (s.status === "proposed") {
-    const move = card?.pick.id === s.id ? `nanopm roadmap move ${s.ref} now|next|later [position] \xB7 ` : "";
-    out.push(paint(ANSI.dim, `  ${move}nanopm reject ${s.ref} ["why"]`));
+  const tree = liveTree(rows2);
+  const live = rows2.filter(isLive);
+  const evidenced = live.filter((r) => r.evidence_status === "evidence_backed").length;
+  out.push(paint(ANSI.dim, `${live.length} on the map: ${evidenced} evidence-backed, ${live.length - evidenced} hypotheses \u2014 what users or their behaviour have not shown yet.`));
+  const who = (r) => r.personas.map((p) => opts.names?.get(p) ?? p).join(", ");
+  const one = (r, place) => {
+    const indent = "  ".repeat(r.depth - 1);
+    const yours = r.status === "confirmed" ? paint(ANSI.green, " yours") : "";
+    out.push("", `${indent}${paint(ANSI.bold, place.padStart(2))}  ${r.depth === 1 ? paint(ANSI.bold, r.problem) : r.problem}${yours}  ${paint(ANSI.dim, r.ref)}`);
+    const pad = `${indent}    `;
+    const facts = [PRIORITY_WORD[r.priority], EVIDENCE_STATUS_WORD[r.evidence_status], NEXT_ACTION_WORD[r.next_action], who(r)].filter(Boolean).join(" \xB7 ");
+    out.push(`${pad}${paint(ANSI.dim, facts)}`);
+    const gist = r.description ? paragraphs(r.description)[0] : null;
+    if (gist) for (const l of wrap(gist, width - pad.length)) out.push(`${pad}${l}`);
+    if (r.learn) for (const l of wrap(`To learn more: ${r.learn}`, width - pad.length)) out.push(`${pad}${paint(ANSI.dim, l)}`);
+    if (r.founder_rank !== null && r.now_rank) out.push(`${pad}${paint(ANSI.dim, `Its place is yours; NanoPM would now put it at #${r.now_rank}.`)}`);
+    if (r.reconsider) for (const l of wrap(`Worth reconsidering: ${r.reconsider}`, width - pad.length)) out.push(`${pad}${paint(ANSI.amber, l)}`);
+    for (const c of r.children) one(c, `${place}.${c.rank}`);
+  };
+  for (const r of tree) one(r, String(r.rank));
+  const aside = rows2.filter((r) => r.status === "set_aside");
+  if (aside.length) {
+    out.push("", paint(ANSI.bold, `Set aside (${aside.length})`));
+    for (const r of aside) out.push(`  ${paint(ANSI.dim, r.ref.padEnd(8))} ${r.problem}${r.set_aside_reason ? paint(ANSI.dim, ` \u2014 ${r.set_aside_reason}`) : ""}`);
   }
+  out.push("", paint(ANSI.dim, '`nanopm opportunities confirm <ref>`, `set-aside <ref> "why"`, `move <ref> <place>`, `reword <ref> "\u2026"`, `brainstorm <ref> [--deep]`, `run [--deep] [--note "\u2026"] [--use signals,data,repo,market] [--skip \u2026]`.'));
   return out.join("\n");
 }
 
-// src/format/problems.ts
-var SHAPE2 = {
-  candidate: { mark: "\u25CB", colour: ANSI.dim, label: "candidate" },
-  confirmed: { mark: "\u25C9", colour: ANSI.amber, label: "confirmed" },
-  addressed: { mark: "\u25CF", colour: ANSI.green, label: "addressed" },
-  dropped: { mark: "\u2298", colour: ANSI.dim, label: "dropped" }
-};
-function renderImportance(problem, opts) {
-  const paint = painter(opts.color);
-  if (problem.importance_basis === "evidence") {
-    return paint(ANSI.bold, String(Math.round(problem.importance)).padStart(3));
-  }
-  const value = problem.importance;
-  const word = value >= 67 ? "high" : value >= 34 ? "med" : value > 0 ? "low" : "\u2014";
-  return paint(ANSI.dim, `~${word}`.padStart(5));
-}
-function renderProblems(problems2, duplicates, opts) {
-  const paint = painter(opts.color);
-  if (!problems2.length) {
-    return [
-      "No problems on the list yet.",
-      "",
-      paint(ANSI.dim, "  nanopm review     reads your data, then works out what they say about your users"),
-      paint(ANSI.dim, "  nanopm opportunities         what to work on, for your objective")
-    ].join("\n");
-  }
-  const refWidth = Math.max(...problems2.map((p) => p.ref.length));
-  const out = [];
-  const map = groupProblemMap(problems2.map((p) => ({ ...p, parentRef: p.parent_ref })));
-  const ordered = [...map.branches.flatMap((b) => [b.parent, ...b.children]), ...map.unplaced];
-  for (const problem of ordered) {
-    const shape2 = SHAPE2[problem.status] ?? { mark: "\xB7", colour: ANSI.dim, label: problem.status };
-    const score = renderImportance(problem, opts);
-    const head = `${paint(shape2.colour, shape2.mark)} ${paint(ANSI.dim, problem.ref.padEnd(refWidth))} ${score}  ${problem.parent_ref ? paint(ANSI.dim, "\u21B3 ") : ""}${clip(firstSentence(problem.statement), Math.max(40, columns() - refWidth - 14))}`;
-    out.push(head);
-    if (problem.mapping) out.push(paint(ANSI.dim, `  ${problem.mapping.level === 1 ? "Need" : "Difficulty"} \xB7 ${problem.mapping.knowledge} \xB7 ${problem.mapping.origin === "expert_inference" ? "expert inference" : "source analysis"}`));
-    const indent = `  ${" ".repeat(refWidth)}      `;
-    const tail2 = problem.proofs > 0 ? `${problem.proofs} proof${problem.proofs === 1 ? "" : "s"}${problem.proof_kinds?.length ? ` \xB7 ${problem.proof_kinds.join(", ")}` : ""}` : problem.importance_note ? `no proof yet \xB7 ${problem.importance_note}` : "no proof yet";
-    out.push(paint(ANSI.dim, indent + clip(tail2, Math.max(40, columns() - indent.length))));
-  }
-  const unproven = problems2.filter((p) => p.proofs === 0).length;
-  if (unproven) {
-    out.push("");
-    out.push(
-      paint(
-        ANSI.dim,
-        `${unproven} of ${problems2.length} rest on judgement, not proof. A tilde marks those.`
-      )
-    );
-  }
-  if (duplicates.length) {
-    out.push("");
-    for (const pair of duplicates.slice(0, 3)) {
-      const why = pair.flagged ? `NanoPM is not sure ${pair.a} and ${pair.b} are different problems` : `${pair.a} and ${pair.b} read alike`;
-      out.push(paint(ANSI.amber, `? ${why}`));
-    }
-    out.push(paint(ANSI.dim, `  nanopm decisions        why \xB7 nanopm problems merge ${duplicates[0].b} ${duplicates[0].a}`));
-  }
-  if (opts.manualMerges !== void 0) {
-    out.push("");
-    out.push(
-      paint(
-        ANSI.dim,
-        `${opts.manualMerges} merge${opts.manualMerges === 1 ? "" : "s"} you have had to make by hand.`
-      )
-    );
-  }
-  out.push("");
-  out.push(paint(ANSI.dim, "  nanopm problems <ref> \xB7 nanopm problems merge <from> <into> \xB7 nanopm problems weight <ref> <0-100>"));
-  return out.join("\n");
-}
-function renderProblem(problem, evidence2, addressedBy, opts) {
+// src/format/needs.ts
+var MARK = { observed: "\u25CF", stated: "\u2013", inferred: "\u25CB" };
+function renderNeeds(persona, tree, opts) {
   const paint = painter(opts.color);
-  const shape2 = SHAPE2[problem.status] ?? { mark: "\xB7", colour: ANSI.dim, label: problem.status };
-  const width = columns();
+  const width = Math.max(40, columns());
   const out = [];
-  out.push(`${paint(shape2.colour, shape2.mark)} ${paint(ANSI.dim, problem.ref)}  ${paint(ANSI.bold, shape2.label)}`);
-  out.push("");
-  for (const line of wrap(problem.statement, width)) out.push(line);
-  out.push("");
-  const facts = [];
-  const m = problem.mapping ?? null;
-  if (m) {
-    const story = problemStory(m, { proofs: problem.proofs, kinds: problem.proof_kinds ?? [], provenance: problem.provenance ?? "inferred", authorKind: problem.author_kind ?? "nanopm", createdAt: problem.created_at ?? "" });
-    out.push(...wrap(story.story, width));
-    out.push("");
-    out.push(...wrap(story.doubt, width).map((l) => paint(ANSI.dim, l)));
-    out.push(...wrap(story.assumes ? `${story.test} ${story.assumes}` : story.test, width).map((l) => paint(ANSI.dim, l)));
-    out.push("");
-    out.push(paint(ANSI.dim, "how I got here"));
-    facts.push(["kind", `${m.level === 1 ? "a need" : "a difficulty"} \xB7 ${m.knowledge} \xB7 ${m.origin === "expert_inference" ? "expert inference" : "source analysis"}`]);
-    if (m.parent_reason) facts.push(["grouping", m.parent_reason]);
-  }
-  if (problem.segment) facts.push(["who", problem.segment]);
-  facts.push([
-    "weight",
-    problem.importance_basis === "evidence" ? `${Math.round(problem.importance)} from ${problem.proofs} piece${problem.proofs === 1 ? "" : "s"} of proof` : `${Math.round(problem.importance)}, a judgement${problem.importance_note ? ` \u2014 ${problem.importance_note}` : ""}`
-  ]);
-  if (problem.parent_ref) facts.push(["part of", problem.parent_ref]);
-  for (const [label, value] of facts) {
-    out.push(`${paint(ANSI.dim, label.padEnd(9))}${clip(value, width - 9)}`);
-  }
-  if (evidence2.length) {
-    out.push("");
-    out.push(paint(ANSI.dim, "sources"));
-    for (const item of evidence2) {
-      const when = (item.occurred_at ?? item.created_at).slice(0, 10);
-      const where = item.metric_key ?? item.source_ref ?? item.kind;
-      for (const line of wrap(item.body, width - 2)) out.push(`  ${line}`);
-      out.push(paint(ANSI.dim, `  \u2014 ${item.relation ?? "supports"} \xB7 ${item.kind} \xB7 ${where} \xB7 ${when}`));
-    }
-  } else {
-    out.push("");
-    out.push(paint(ANSI.dim, "No proof yet. This ranking is a judgement, and the next review may settle it."));
+  const counts = needCounts(tree);
+  out.push(`${paint(ANSI.bold, `${persona.name}\u2019s needs`)}  ${paint(ANSI.dim, `${counts.needs} needs \xB7 ${counts.difficulties + counts.precise} difficulties`)}`);
+  if (!tree.length) {
+    out.push("", `Nothing mapped yet. \`nanopm needs --refresh ${persona.slug}\` maps it in depth; add --short for a quick pass.`);
+    return out.join("\n");
   }
-  if (addressedBy.length) {
+  const line = (n, depth) => {
+    const indent = "  ".repeat(depth);
+    const lead = n.level === 1 ? `${n.emoji ?? " "} ` : `${MARK[n.provenance]} `;
+    const where = n.provenance === "inferred" ? paint(ANSI.dim, ` guess ${n.confidence ?? 0}%`) : n.sources.length ? paint(ANSI.dim, ` ${n.sources.length} source${n.sources.length === 1 ? "" : "s"}`) : "";
+    const state = n.status === "dropped" ? paint(ANSI.dim, " dropped") : n.status === "confirmed" || n.author_kind === "user" ? "" : paint(ANSI.amber, " to review");
+    const label = n.status === "dropped" ? paint(ANSI.dim, n.label) : n.level === 1 ? paint(ANSI.bold, n.label) : n.label;
+    const body = wrap(`${label}${where}${state}${n.proposal ? paint(ANSI.amber, " \xB7 NanoPM suggests a new wording") : ""}`, width - indent.length - 12);
+    out.push(`${indent}${lead}${paint(ANSI.dim, n.ref.padEnd(8))} ${body[0] ?? ""}`);
+    for (const more of body.slice(1)) out.push(`${indent}           ${more}`);
+    for (const c of n.children) line(c, depth + 1);
+  };
+  for (const need of tree) {
     out.push("");
-    out.push(paint(ANSI.dim, "addressed by"));
-    for (const item of addressedBy) {
-      out.push(`  ${paint(ANSI.dim, item.ref)}  ${clip(item.title, width - 12)} ${paint(ANSI.dim, `(${item.status})`)}`);
-    }
+    line(need, 0);
   }
-  out.push("");
-  out.push(paint(ANSI.dim, "  nanopm problems \xB7 nanopm roadmap"));
-  return out.join("\n");
-}
-
-// src/format/tree.ts
-var SOLUTION_SHAPE = {
-  proposed: { mark: "\u25CB", colour: ANSI.amber, label: "proposed" },
-  accepted: { mark: "\u25D0", colour: ANSI.green, label: "accepted" },
-  building: { mark: "\u25D4", colour: ANSI.blue, label: "building" },
-  done: { mark: "\u25CF", colour: ANSI.green, label: "done" },
-  rejected: { mark: "\u2298", colour: ANSI.red, label: "rejected" },
-  dropped: { mark: "\u2298", colour: ANSI.dim, label: "dropped" }
-};
-var PROBLEM_SHAPE = {
-  candidate: { mark: "\u25CB", colour: ANSI.dim },
-  confirmed: { mark: "\u25C9", colour: ANSI.amber },
-  addressed: { mark: "\u25CF", colour: ANSI.green },
-  dropped: { mark: "\u2298", colour: ANSI.dim }
-};
-var NO_AREA = "no area yet";
-var SHOWN = /* @__PURE__ */ new Set(["proposed", "accepted", "building", "done"]);
-function renderTree(problems2, solutions, strategy, opts) {
-  const paint = painter(opts.color);
-  const out = [];
-  const width = Math.max(40, columns());
-  if (strategy) {
-    out.push(paint(ANSI.bold, "Strategy"));
-    for (const line of wrap(strategy, width - 4)) out.push(`  ${line}`);
-    out.push("");
-  }
-  const shown = solutions.filter((s) => SHOWN.has(s.status));
-  const open = problems2.filter((p) => p.status !== "dropped" && (!opts.alongside || shown.some((s) => s.problem_id === p.id)));
-  if (opts.alongside && !open.length) return "";
-  if (!open.length && !shown.length) {
-    out.push("No problems yet. `nanopm opportunities` shows what to work on.");
-    return out.join("\n");
-  }
-  const byProblem = /* @__PURE__ */ new Map();
-  for (const s of shown) byProblem.set(s.problem_id, [...byProblem.get(s.problem_id) ?? [], s]);
-  const refWidth = Math.max(...[...open.map((p) => p.ref), ...shown.map((s) => s.ref)].map((r) => r.length), 5);
-  for (const [area, rows2] of groupByArea(open)) {
-    out.push(paint(ANSI.bold, area));
-    for (const p of rows2) {
-      const shape2 = PROBLEM_SHAPE[p.status] ?? { mark: "\xB7", colour: "" };
-      const kind = p.kind === "founder" ? paint(ANSI.dim, " (founder)") : "";
-      const proof = p.proofs ? `${p.proofs} proof${p.proofs === 1 ? "" : "s"}` : "no proof";
-      const tail2 = `${renderImportance(p, opts)}  ${paint(ANSI.dim, proof)}`;
-      const head = `  ${paint(shape2.colour, shape2.mark)} ${paint(ANSI.dim, p.ref.padEnd(refWidth))}  `;
-      out.push(head + clip(p.statement, Math.max(30, width - visibleLength(head) - visibleLength(tail2) - 2)) + kind + "  " + tail2);
-      const under = byProblem.get(p.id) ?? [];
-      if (!under.length) {
-        out.push(paint(ANSI.dim, `    ${" ".repeat(refWidth + 2)}  no solution yet`));
-        continue;
-      }
-      for (const s of under) out.push(...solutionLines(s, refWidth, width, paint));
-    }
-    out.push("");
-  }
-  const waiting = shown.filter((s) => s.status === "proposed").length;
-  if (waiting) {
-    out.push(`${waiting} waiting on you.`);
-    out.push(paint(ANSI.dim, '  nanopm accept <ref> \xB7 nanopm reject <ref> "why" \xB7 nanopm roadmap <ref> \xB7 nanopm roadmap --board'));
-  } else if (!opts.alongside) {
-    out.push(paint(ANSI.dim, "Nothing waiting on you."));
-  }
-  return out.join("\n").trimEnd();
-}
-function solutionLines(s, refWidth, width, paint, indent = 6) {
-  const shape2 = SOLUTION_SHAPE[s.status] ?? { mark: "\xB7", colour: "", label: s.status };
-  const pad = " ".repeat(indent);
-  const STATE = { accepted: "chosen", building: "building", done: "done" };
-  const tail2 = s.actor === "founder" ? "yours to do" : s.outcome ? s.outcome : s.status === "proposed" ? s.assumption ? clip(s.assumption, 40) : null : STATE[s.status] ?? null;
-  const badge = tail2 ? paint(ANSI.dim, `  ${tail2}`) : "";
-  const head = `${pad}${paint(shape2.colour, shape2.mark)} ${paint(ANSI.dim, s.ref.padEnd(refWidth))}  `;
-  const lines = [head + clip(s.title, Math.max(30, width - visibleLength(head) - visibleLength(badge))) + badge];
-  const reason2 = `${pad}  ${" ".repeat(refWidth)}  `;
-  lines.push(paint(ANSI.dim, reason2 + clip(firstSentence(s.reasoning), Math.max(30, width - reason2.length))));
-  return lines;
-}
-function groupByArea(problems2) {
-  const groups = /* @__PURE__ */ new Map();
-  for (const p of problems2) {
-    const area = p.area ?? NO_AREA;
-    groups.set(area, [...groups.get(area) ?? [], p]);
-  }
-  const named = [...groups.entries()].filter(([a]) => a !== NO_AREA);
-  const rest = groups.get(NO_AREA);
-  return rest ? [...named, [NO_AREA, rest]] : named;
-}
-var BOARD_COLUMNS = [
-  { status: "proposed", label: "Proposed" },
-  { status: "accepted", label: "Chosen" },
-  { status: "building", label: "Building" },
-  { status: "done", label: "Done" }
-];
-function renderBoard(problems2, solutions, opts) {
-  const paint = painter(opts.color);
-  const out = [];
-  const byId = new Map(problems2.map((p) => [p.id, p]));
-  const width = Math.max(40, columns());
-  const refWidth = Math.max(...solutions.map((s) => s.ref.length), 5);
-  for (const col of BOARD_COLUMNS) {
-    const rows2 = solutions.filter((s) => s.status === col.status);
-    out.push(`${paint(ANSI.bold, col.label)} ${paint(ANSI.dim, String(rows2.length))}`);
-    if (!rows2.length) out.push(paint(ANSI.dim, "  \u2014"));
-    for (const s of rows2) {
-      const shape2 = SOLUTION_SHAPE[s.status];
-      const problem = byId.get(s.problem_id);
-      const head = `  ${paint(shape2.colour, shape2.mark)} ${paint(ANSI.dim, s.ref.padEnd(refWidth))}  `;
-      out.push(head + clip(s.title, Math.max(30, width - visibleLength(head))));
-      const under = [problem ? `${problem.ref} ${clip(problem.statement, 50)}` : "its problem was dropped", s.assumption ? clip(s.assumption, 40) : null].filter(Boolean).join(" \xB7 ");
-      out.push(paint(ANSI.dim, `  ${" ".repeat(refWidth + 2)}  ${under}`));
-    }
-    out.push("");
-  }
-  return out.join("\n").trimEnd();
-}
-
-// src/format/opportunities.ts
-function renderOpportunities(rows2, lens, opts) {
-  const paint = painter(opts.color);
-  const width = Math.max(40, columns());
-  const out = [];
-  if (!lens) return "No objective yet: the map is drawn for it. Say what matters most right now on Your business, then `nanopm opportunities run`.";
-  out.push(`${paint(ANSI.bold, "Opportunities")}  ${paint(ANSI.dim, `${lens.lever} \u2014 ${lens.sentence}`)}`);
-  out.push(paint(ANSI.dim, lens.definition ? `Counts: ${lens.definition}` : "What it counts is not defined yet: drawn against the lever and your sentence."));
-  if (opts.previous) out.push(paint(ANSI.amber, "Drawn for your previous objective. `nanopm opportunities run` draws it for this one."));
-  if (!rows2.length) {
-    out.push("", "No map yet. `nanopm opportunities run` draws it from what NanoPM knows; add --deep to check it against your users, code and data.");
-    return out.join("\n");
-  }
-  const tree = liveTree(rows2);
-  const live = rows2.filter(isLive);
-  const evidenced = live.filter((r) => r.evidence_status === "evidence_backed").length;
-  out.push(paint(ANSI.dim, `${live.length} on the map: ${evidenced} evidence-backed, ${live.length - evidenced} hypotheses \u2014 what users or their behaviour have not shown yet.`));
-  const who = (r) => r.personas.map((p) => opts.names?.get(p) ?? p).join(", ");
-  const one = (r, place) => {
-    const indent = "  ".repeat(r.depth - 1);
-    const yours = r.status === "confirmed" ? paint(ANSI.green, " yours") : "";
-    out.push("", `${indent}${paint(ANSI.bold, place.padStart(2))}  ${r.depth === 1 ? paint(ANSI.bold, r.problem) : r.problem}${yours}  ${paint(ANSI.dim, r.ref)}`);
-    const pad = `${indent}    `;
-    const facts = [PRIORITY_WORD[r.priority], EVIDENCE_STATUS_WORD[r.evidence_status], NEXT_ACTION_WORD[r.next_action], who(r)].filter(Boolean).join(" \xB7 ");
-    out.push(`${pad}${paint(ANSI.dim, facts)}`);
-    const gist = r.description ? paragraphs(r.description)[0] : null;
-    if (gist) for (const l of wrap(gist, width - pad.length)) out.push(`${pad}${l}`);
-    if (r.learn) for (const l of wrap(`To learn more: ${r.learn}`, width - pad.length)) out.push(`${pad}${paint(ANSI.dim, l)}`);
-    if (r.founder_rank !== null && r.now_rank) out.push(`${pad}${paint(ANSI.dim, `Its place is yours; NanoPM would now put it at #${r.now_rank}.`)}`);
-    if (r.reconsider) for (const l of wrap(`Worth reconsidering: ${r.reconsider}`, width - pad.length)) out.push(`${pad}${paint(ANSI.amber, l)}`);
-    for (const c of r.children) one(c, `${place}.${c.rank}`);
-  };
-  for (const r of tree) one(r, String(r.rank));
-  const aside = rows2.filter((r) => r.status === "set_aside");
-  if (aside.length) {
-    out.push("", paint(ANSI.bold, `Set aside (${aside.length})`));
-    for (const r of aside) out.push(`  ${paint(ANSI.dim, r.ref.padEnd(8))} ${r.problem}${r.set_aside_reason ? paint(ANSI.dim, ` \u2014 ${r.set_aside_reason}`) : ""}`);
-  }
-  out.push("", paint(ANSI.dim, '`nanopm opportunities confirm <ref>`, `set-aside <ref> "why"`, `move <ref> <place>`, `reword <ref> "\u2026"`, `brainstorm <ref> [--deep]`, `run [--deep] [--note "\u2026"] [--use signals,data,repo,market] [--skip \u2026]`.'));
-  return out.join("\n");
-}
-
-// src/format/needs.ts
-var MARK = { observed: "\u25CF", stated: "\u2013", inferred: "\u25CB" };
-function renderNeeds(persona, tree, opts) {
-  const paint = painter(opts.color);
-  const width = Math.max(40, columns());
-  const out = [];
-  const counts = needCounts(tree);
-  out.push(`${paint(ANSI.bold, `${persona.name}\u2019s needs`)}  ${paint(ANSI.dim, `${counts.needs} needs \xB7 ${counts.difficulties + counts.precise} difficulties`)}`);
-  if (!tree.length) {
-    out.push("", `Nothing mapped yet. \`nanopm needs --refresh ${persona.slug}\` maps it in depth; add --short for a quick pass.`);
-    return out.join("\n");
-  }
-  const line = (n, depth) => {
-    const indent = "  ".repeat(depth);
-    const lead = n.level === 1 ? `${n.emoji ?? " "} ` : `${MARK[n.provenance]} `;
-    const where = n.provenance === "inferred" ? paint(ANSI.dim, ` guess ${n.confidence ?? 0}%`) : n.sources.length ? paint(ANSI.dim, ` ${n.sources.length} source${n.sources.length === 1 ? "" : "s"}`) : "";
-    const state = n.status === "dropped" ? paint(ANSI.dim, " dropped") : n.status === "confirmed" || n.author_kind === "user" ? "" : paint(ANSI.amber, " to review");
-    const label = n.status === "dropped" ? paint(ANSI.dim, n.label) : n.level === 1 ? paint(ANSI.bold, n.label) : n.label;
-    const body = wrap(`${label}${where}${state}${n.proposal ? paint(ANSI.amber, " \xB7 NanoPM suggests a new wording") : ""}`, width - indent.length - 12);
-    out.push(`${indent}${lead}${paint(ANSI.dim, n.ref.padEnd(8))} ${body[0] ?? ""}`);
-    for (const more of body.slice(1)) out.push(`${indent}           ${more}`);
-    for (const c of n.children) line(c, depth + 1);
-  };
-  for (const need of tree) {
-    out.push("");
-    line(need, 0);
-  }
-  out.push("", paint(ANSI.dim, `\u25CF observed  \u2013 stated by you  \u25CB NanoPM\u2019s guess. \`nanopm needs confirm <ref>\`, \`nanopm needs drop <ref> "why"\`, \`nanopm needs dig <ref>\`.`));
-  if (opts.others?.length) out.push(paint(ANSI.dim, `Other personas: ${opts.others.join(", ")}.`));
+  out.push("", paint(ANSI.dim, `\u25CF observed  \u2013 stated by you  \u25CB NanoPM\u2019s guess. \`nanopm needs confirm <ref>\`, \`nanopm needs drop <ref> "why"\`, \`nanopm needs dig <ref>\`.`));
+  if (opts.others?.length) out.push(paint(ANSI.dim, `Other personas: ${opts.others.join(", ")}.`));
   return out.join("\n");
 }
 
@@ -15335,51 +14982,471 @@ async function setAsideOpportunity(ref, why, opts) {
   await rpc2("set_aside_opportunity", { p_ref: ref, p_reason: why ?? "not now" }, opts);
   return `${ref.toUpperCase()} is set aside for this objective, with the narrower problems under it. It comes back if the objective changes.`;
 }
-async function moveOpportunity(ref, place, opts) {
-  const rank2 = Number(place);
-  if (!Number.isInteger(rank2) || rank2 < 1) throw new Error("say where: nanopm opportunities move <ref> <place>, a place from 1");
-  await rpc2("move_opportunity", { p_ref: ref, p_rank: rank2 }, opts);
-  return `${ref.toUpperCase()} is at #${rank2} among its siblings, and the place is yours. Moved above a higher priority, it takes that priority.`;
+async function moveOpportunity(ref, place, opts) {
+  const rank2 = Number(place);
+  if (!Number.isInteger(rank2) || rank2 < 1) throw new Error("say where: nanopm opportunities move <ref> <place>, a place from 1");
+  await rpc2("move_opportunity", { p_ref: ref, p_rank: rank2 }, opts);
+  return `${ref.toUpperCase()} is at #${rank2} among its siblings, and the place is yours. Moved above a higher priority, it takes that priority.`;
+}
+async function rewordOpportunity(ref, problem, opts) {
+  const text2 = problem?.trim().replace(/\s+/g, " ") ?? "";
+  if (!text2) throw new Error('say it: nanopm opportunities reword <ref> "the problem, in your words"');
+  if (text2.length > PROBLEM_MAX) throw new Error(`one line, under ${PROBLEM_MAX} characters`);
+  await rpc2("restate_opportunity", { p_ref: ref, p_problem: text2 }, opts);
+  return `Kept in your words: ${text2}`;
+}
+var AWAKE_MS = 12e4;
+async function awakeDaemon(client, userId) {
+  const since = new Date(Date.now() - AWAKE_MS).toISOString();
+  const [{ data }, local] = await Promise.all([
+    client.from("daemons").select("id, hostname").eq("user_id", userId).in("status", ["online", "running"]).gte("last_seen_at", since).order("last_seen_at", { ascending: false }),
+    localDaemonId()
+  ]);
+  return data?.find((d) => d.id === local) ?? data?.[0] ?? null;
+}
+async function brainstorm(ref, opts) {
+  const auth = await authenticate();
+  const project = await resolveProject(auth.client, { projectId: opts.projectId, cwd: opts.cwd });
+  const [lens, all, busy] = await Promise.all([lensOf2(auth.client, project.id), loadOpportunities(auth.client, project.id), workingOn(auth.client, project.id)]);
+  const deep = Boolean(opts.deep);
+  const plan = brainstormPlan(shownMap(all, lens?.key ?? null).shown, ref, deep, new Set(busy.keys()));
+  const daemon = await awakeDaemon(auth.client, auth.userId);
+  if (!daemon) throw new Error("Your machine is asleep: none of your daemons has been seen in the last two minutes, so nothing was queued. `nanopm daemon install` starts it; then brainstorm again.");
+  const repo = deep ? await detectRepo(opts.cwd) : null;
+  if (repo) await rememberClone(auth.client, project.id, repo.root);
+  for (const params of plan.jobs) {
+    const { error } = await auth.client.from("jobs").insert({ project_id: project.id, skill: SOLUTIONS_SKILL, params: { ...params, ...repo ? { repo_path: repo.root } : {} }, requested_by: auth.userId, trigger: "user", target_daemon_id: daemon.id });
+    if (error) throw new Error(`could not queue the brainstorm: ${error.message}`);
+  }
+  const n = plan.leaves.length;
+  const minutes = deep ? DEEP_MINUTES * n : FLASH_MINUTES;
+  const what = plan.problem.children.length ? `the ${n} narrower problem${n === 1 ? "" : "s"} under ${plan.problem.ref}` : `${plan.problem.ref} \u201C${clip(plan.problem.problem, 60)}\u201D`;
+  const how = deep ? `${DEPTH_WORD.deep}${n > 1 ? ", one after the other" : ""}` : `${DEPTH_WORD.quick}, a first pass`;
+  const out = [`${deep ? "Going deeper on" : "Brainstorming"} ${what}: ${how}, about ${minutes} minutes on ${daemon.hostname}.`];
+  if (plan.problem.children.length) for (const l of plan.leaves) out.push(`  ${l.ref.padEnd(8)} ${clip(l.problem, Math.max(30, columns() - 11))}`);
+  if (plan.busy) out.push(`${plan.busy} left out: Nano is already finding solutions to ${plan.busy === 1 ? "it" : "them"}.`);
+  out.push("The solutions land on `nanopm roadmap`.");
+  return out.join("\n");
+}
+
+// src/format/roadmap.ts
+var SHAPE = {
+  proposed: { mark: "\u25CB", colour: ANSI.amber, label: "proposed" },
+  accepted: { mark: "\u25D0", colour: ANSI.green, label: "accepted" },
+  building: { mark: "\u25D4", colour: ANSI.blue, label: "building" },
+  rejected: { mark: "\u2298", colour: ANSI.red, label: "rejected" },
+  done: { mark: "\u25CF", colour: ANSI.green, label: "done" },
+  dropped: { mark: "\u2298", colour: ANSI.dim, label: "dropped" }
+};
+var WORK_KINDS = /* @__PURE__ */ new Set(["branch", "git", "url", "job"]);
+function renderRoadmapItem(item, opts, problem, builtBy) {
+  const paint = painter(opts.color);
+  const shape2 = SHAPE[item.status] ?? { mark: "\xB7", colour: "", label: item.status };
+  const out = [`${paint(shape2.colour, shape2.mark)} ${paint(ANSI.bold, item.ref)}  ${item.title}`];
+  if (problem) out.push(paint(ANSI.dim, `  answers ${problem.ref}  ${clip(problem.statement, Math.max(30, columns() - 20))}`));
+  out.push("");
+  for (const line of wrap(item.reasoning, Math.max(40, columns() - 4))) out.push(`  ${line}`);
+  out.push("");
+  const facts = [
+    ["status", shape2.label + (item.outcome ? ` \xB7 ${item.outcome}${item.outcome_note ? `: ${item.outcome_note}` : ""}` : "")],
+    ["rank", String(item.rank)],
+    ["who", item.actor === "founder" ? "you" : "NanoPM"],
+    ["bets on", item.assumption ?? "\u2014"],
+    ["we'll know", item.eval ?? "\u2014"]
+  ];
+  for (const [k, v] of facts) out.push(paint(ANSI.dim, `  ${k.padEnd(9)} ${v}`));
+  const sources2 = item.sources ?? [];
+  const restsOn = sources2.filter((s) => !WORK_KINDS.has(s.kind));
+  if (restsOn.length) {
+    out.push(paint(ANSI.dim, `  ${"rests on".padEnd(9)} ${restsOn.map((s) => `${s.kind}:${s.ref}`).join(", ")}`));
+  }
+  const where = renderWhere(sources2);
+  if (where) out.push(paint(ANSI.dim, `  ${"where".padEnd(9)} ${where}${builtBy ? ` \xB7 built by ${builtBy}` : ""}`));
+  return out.join("\n");
+}
+function renderWhere(sources2) {
+  const branch = sources2.find((s) => s.kind === "branch")?.ref;
+  const commit = sources2.find((s) => s.kind === "git")?.ref;
+  const url = sources2.find((s) => s.kind === "url")?.ref;
+  return [branch, commit, url].filter(Boolean).join(" \xB7 ");
+}
+var VERB = {
+  want: { text: "wanted", colour: ANSI.amber },
+  confirm: { text: "confirmed", colour: ANSI.green },
+  drop: { text: "dropped", colour: ANSI.red },
+  merge: { text: "merged into", colour: ANSI.blue },
+  separate: { text: "kept apart", colour: ANSI.blue },
+  weight: { text: "weighed", colour: ANSI.blue },
+  area: { text: "filed", colour: ANSI.blue },
+  accept: { text: "accepted", colour: ANSI.green },
+  reject: { text: "rejected", colour: ANSI.red },
+  first: { text: "put first", colour: ANSI.blue },
+  done: { text: "did", colour: ANSI.green },
+  dismiss: { text: "dismissed", colour: ANSI.red }
+};
+function renderDecisions(rows2, opts) {
+  const paint = painter(opts.color);
+  if (!rows2.length) return "No decisions yet.";
+  const out = [];
+  for (const row of rows2) {
+    const when = row.created_at.slice(0, 10);
+    const verb = VERB[row.kind] ?? { text: row.kind, colour: ANSI.blue };
+    const about = row.solutions ? `${paint(ANSI.dim, row.solutions.ref)} ${row.solutions.title}` : row.problems ? paint(ANSI.dim, row.problems.ref) : row.market_entries ? `${paint(ANSI.dim, row.market_entries.ref)} ${row.market_entries.competitor ?? ""}`.trimEnd() : "";
+    const by = row.by ? paint(ANSI.dim, ` \xB7 by ${row.by}`) : "";
+    out.push(`${paint(ANSI.dim, when)}  ${paint(verb.colour, verb.text)} ${about}${by}`.trimEnd());
+    if (row.body) {
+      for (const line of wrap(row.body, 72)) out.push(paint(ANSI.dim, `              ${line}`));
+    }
+  }
+  return out.join("\n");
+}
+var HUE = ["\x1B[34m", "\x1B[35m", "\x1B[36m", "\x1B[32m", "\x1B[95m"];
+function themesOf(tree) {
+  return new Map(tree.map((b) => [b.id, { name: themeName(b), colour: HUE[themeHue(tree, b) - 1] }]));
+}
+function sizeWord(size, paint) {
+  return size === "big" ? `${paint(ANSI.bold, "\u25AA")} ${SIZE_WORD.big}` : size === "small" ? paint(ANSI.dim, SIZE_WORD.small) : "";
+}
+function renderSolutionsBoard(board, opts) {
+  const paint = painter(opts.color);
+  const width = Math.max(40, columns());
+  const themes = themesOf(board.tree);
+  const out = [`${paint(ANSI.bold, "Roadmap")}${board.objective ? `  ${paint(ANSI.dim, `${board.objective.lever} \u2014 ${board.objective.sentence}`)}` : ""}`];
+  const chips = board.tree.flatMap((b) => {
+    const n = board.cards.filter((c) => c.branch.id === b.id).length;
+    const t = themes.get(b.id);
+    return n ? [`${paint(t.colour, "\u25CF")} ${t.name} ${paint(ANSI.dim, String(n))}`] : [];
+  });
+  const legend = chips.reduce((lines, chip) => {
+    const last = lines.at(-1);
+    if (last !== void 0 && visibleLength(last) + 3 + visibleLength(chip) <= width) lines[lines.length - 1] = `${last}   ${chip}`;
+    else lines.push(chip);
+    return lines;
+  }, []);
+  out.push("", ...legend);
+  if (!board.cards.some((c) => c.pick.placed_by === "founder")) out.push(paint(ANSI.dim, "Nano placed these in the order of your opportunity map. Move them where you want them."));
+  const refWidth = Math.max(5, ...board.cards.map((c) => c.pick.ref.length));
+  const gutter = " ".repeat(refWidth + 4);
+  const titleWidth = Math.min(Math.max(...board.cards.map((c) => c.pick.title.length)), width - gutter.length - 8);
+  for (const h of HORIZONS) {
+    const column = board.cards.filter((c) => c.horizon === h);
+    out.push("", `${paint(ANSI.bold, HORIZON_WORD[h])}  ${paint(ANSI.dim, String(column.length))}`);
+    if (!column.length) out.push(paint(ANSI.dim, `  Move a card here: nanopm roadmap move <ref> ${h}`));
+    for (const c of column) {
+      const t = themes.get(c.branch.id);
+      out.push(`  ${paint(ANSI.dim, c.pick.ref.padEnd(refWidth))}  ${paint(t.colour, "\u25CF")} ${paint(ANSI.dim, t.name)}`);
+      out.push(`${gutter}${clip(c.pick.title, titleWidth).padEnd(titleWidth)}  ${sizeWord(c.pick.size, paint)}`.trimEnd());
+      const depth = board.working.get(c.leaf.id);
+      if (depth) out.push(`${gutter}${paint(ANSI.blue, "\u25CF")} ${paint(ANSI.dim, WORK_WORD[depth])}`);
+    }
+  }
+  if (board.earlier) out.push("", paint(ANSI.bold, "On the problem list"), "", board.earlier);
+  out.push(
+    "",
+    paint(ANSI.dim, 'nanopm roadmap <ref> \xB7 nanopm roadmap move <ref> now|next|later [position] \xB7 nanopm reject <ref> ["why"]'),
+    paint(ANSI.dim, "nanopm opportunities brainstorm <ref> [--deep]: solutions to another problem, or deeper ones")
+  );
+  return out.join("\n");
+}
+function renderSolutionSheet(s, at, opts) {
+  const paint = painter(opts.color);
+  const width = Math.max(40, columns());
+  const theme = at.branch ? themesOf(at.tree).get(at.branch.id) : void 0;
+  const out = [];
+  if (theme) out.push(`${paint(theme.colour, "\u25CF")} ${paint(ANSI.dim, theme.name)}`);
+  const size = sizeWord(s.size, paint);
+  out.push(`${paint(ANSI.dim, s.ref)}  ${paint(ANSI.bold, s.title)}${size ? `  ${size}` : ""}`);
+  const pad = " ".repeat(12);
+  const heading = (text2) => out.push("", `  ${paint(ANSI.bold, text2)}`);
+  heading("Problem we are solving");
+  if (at.leaf) {
+    const solves = wrap(at.leaf.problem, width - 6 - at.leaf.ref.length - 2);
+    solves[solves.length - 1] += `  ${paint(ANSI.dim, at.leaf.ref)}`;
+    for (const line of solves) out.push(`    ${line}`);
+    if (at.branch && at.branch.id !== at.leaf.id) {
+      for (const line of wrap(`Part of: ${at.branch.problem} ${at.branch.ref}`, width - 6)) out.push(`    ${paint(ANSI.dim, line)}`);
+    }
+  } else {
+    out.push(paint(ANSI.dim, "    The problem it answered is no longer on the map."));
+  }
+  const described = paragraphs(s.description);
+  if (described.length) {
+    heading("Proposed solution");
+    described.forEach((p, i) => {
+      if (i) out.push("");
+      for (const line of wrap(p, width - 6)) out.push(`    ${line}`);
+    });
+  }
+  const changelog = parseChangelog(s.changelog);
+  if (changelog) {
+    heading("Future changelog");
+    for (const line of wrap(changelog.headline, width - 6)) out.push(`    ${paint(ANSI.bold, line)}`);
+    for (const point of changelog.points) wrap(point, width - 8).forEach((line, i) => out.push(`    ${i ? " " : "\u2022"} ${line}`));
+  }
+  if (s.steps.length) {
+    heading("Plan");
+    s.steps.forEach((step, i) => {
+      const who = STEP_WHO_WORD[step.who] ?? step.who;
+      wrap(step.do, width - pad.length - 8).forEach((line, j) => out.push(`${j ? pad : `    \u2610 ${who.padEnd(6)}`}${line}`));
+      if (step.checks) out.push(pad + paint(ANSI.amber, i === 0 ? "checks the problem first" : "checks the problem"));
+    });
+  }
+  const card = at.leaf ? at.cards.find((c) => c.leaf.id === at.leaf.id) : void 0;
+  const others = card ? card.others.filter((o) => o.id !== s.id) : [];
+  out.push("");
+  if (s.status === "rejected") out.push(paint(ANSI.dim, "  Thrown out."));
+  else if (card?.pick.id === s.id) {
+    const column = at.cards.filter((c) => c.horizon === card.horizon);
+    const yours = s.placed_by === "founder" ? ", where you put it" : "";
+    out.push(paint(ANSI.dim, `  On the board: ${HORIZON_WORD[card.horizon]}, ${column.indexOf(card) + 1} of ${column.length}${yours}.`));
+  } else out.push(paint(ANSI.dim, card ? `  Not on the board: ${card.pick.ref} is this problem's card.` : "  Not on the board."));
+  if (others.length) out.push(paint(ANSI.dim, `  Other solutions to this problem: ${others.map((o) => o.ref).join(", ")}.`));
+  if (s.status === "proposed") {
+    const move = card?.pick.id === s.id ? `nanopm roadmap move ${s.ref} now|next|later [position] \xB7 ` : "";
+    out.push(paint(ANSI.dim, `  ${move}nanopm reject ${s.ref} ["why"]`));
+  }
+  return out.join("\n");
+}
+
+// src/format/problems.ts
+var SHAPE2 = {
+  candidate: { mark: "\u25CB", colour: ANSI.dim, label: "candidate" },
+  confirmed: { mark: "\u25C9", colour: ANSI.amber, label: "confirmed" },
+  addressed: { mark: "\u25CF", colour: ANSI.green, label: "addressed" },
+  dropped: { mark: "\u2298", colour: ANSI.dim, label: "dropped" }
+};
+function renderImportance(problem, opts) {
+  const paint = painter(opts.color);
+  if (problem.importance_basis === "evidence") {
+    return paint(ANSI.bold, String(Math.round(problem.importance)).padStart(3));
+  }
+  const value = problem.importance;
+  const word = value >= 67 ? "high" : value >= 34 ? "med" : value > 0 ? "low" : "\u2014";
+  return paint(ANSI.dim, `~${word}`.padStart(5));
+}
+function renderProblems(problems2, duplicates, opts) {
+  const paint = painter(opts.color);
+  if (!problems2.length) {
+    return [
+      "No problems on the list yet.",
+      "",
+      paint(ANSI.dim, "  nanopm review     reads your data, then works out what they say about your users"),
+      paint(ANSI.dim, "  nanopm opportunities         what to work on, for your objective")
+    ].join("\n");
+  }
+  const refWidth = Math.max(...problems2.map((p) => p.ref.length));
+  const out = [];
+  const map = groupProblemMap(problems2.map((p) => ({ ...p, parentRef: p.parent_ref })));
+  const ordered = [...map.branches.flatMap((b) => [b.parent, ...b.children]), ...map.unplaced];
+  for (const problem of ordered) {
+    const shape2 = SHAPE2[problem.status] ?? { mark: "\xB7", colour: ANSI.dim, label: problem.status };
+    const score = renderImportance(problem, opts);
+    const head = `${paint(shape2.colour, shape2.mark)} ${paint(ANSI.dim, problem.ref.padEnd(refWidth))} ${score}  ${problem.parent_ref ? paint(ANSI.dim, "\u21B3 ") : ""}${clip(firstSentence(problem.statement), Math.max(40, columns() - refWidth - 14))}`;
+    out.push(head);
+    if (problem.mapping) out.push(paint(ANSI.dim, `  ${problem.mapping.level === 1 ? "Need" : "Difficulty"} \xB7 ${problem.mapping.knowledge} \xB7 ${problem.mapping.origin === "expert_inference" ? "expert inference" : "source analysis"}`));
+    const indent = `  ${" ".repeat(refWidth)}      `;
+    const tail = problem.proofs > 0 ? `${problem.proofs} proof${problem.proofs === 1 ? "" : "s"}${problem.proof_kinds?.length ? ` \xB7 ${problem.proof_kinds.join(", ")}` : ""}` : problem.importance_note ? `no proof yet \xB7 ${problem.importance_note}` : "no proof yet";
+    out.push(paint(ANSI.dim, indent + clip(tail, Math.max(40, columns() - indent.length))));
+  }
+  const unproven = problems2.filter((p) => p.proofs === 0).length;
+  if (unproven) {
+    out.push("");
+    out.push(
+      paint(
+        ANSI.dim,
+        `${unproven} of ${problems2.length} rest on judgement, not proof. A tilde marks those.`
+      )
+    );
+  }
+  if (duplicates.length) {
+    out.push("");
+    for (const pair of duplicates.slice(0, 3)) {
+      const why = pair.flagged ? `NanoPM is not sure ${pair.a} and ${pair.b} are different problems` : `${pair.a} and ${pair.b} read alike`;
+      out.push(paint(ANSI.amber, `? ${why}`));
+    }
+    out.push(paint(ANSI.dim, `  nanopm decisions        why \xB7 nanopm problems merge ${duplicates[0].b} ${duplicates[0].a}`));
+  }
+  if (opts.manualMerges !== void 0) {
+    out.push("");
+    out.push(
+      paint(
+        ANSI.dim,
+        `${opts.manualMerges} merge${opts.manualMerges === 1 ? "" : "s"} you have had to make by hand.`
+      )
+    );
+  }
+  out.push("");
+  out.push(paint(ANSI.dim, "  nanopm problems <ref> \xB7 nanopm problems merge <from> <into> \xB7 nanopm problems weight <ref> <0-100>"));
+  return out.join("\n");
+}
+function renderProblem(problem, evidence2, addressedBy, opts) {
+  const paint = painter(opts.color);
+  const shape2 = SHAPE2[problem.status] ?? { mark: "\xB7", colour: ANSI.dim, label: problem.status };
+  const width = columns();
+  const out = [];
+  out.push(`${paint(shape2.colour, shape2.mark)} ${paint(ANSI.dim, problem.ref)}  ${paint(ANSI.bold, shape2.label)}`);
+  out.push("");
+  for (const line of wrap(problem.statement, width)) out.push(line);
+  out.push("");
+  const facts = [];
+  const m = problem.mapping ?? null;
+  if (m) {
+    const story = problemStory(m, { proofs: problem.proofs, kinds: problem.proof_kinds ?? [], provenance: problem.provenance ?? "inferred", authorKind: problem.author_kind ?? "nanopm", createdAt: problem.created_at ?? "" });
+    out.push(...wrap(story.story, width));
+    out.push("");
+    out.push(...wrap(story.doubt, width).map((l) => paint(ANSI.dim, l)));
+    out.push(...wrap(story.assumes ? `${story.test} ${story.assumes}` : story.test, width).map((l) => paint(ANSI.dim, l)));
+    out.push("");
+    out.push(paint(ANSI.dim, "how I got here"));
+    facts.push(["kind", `${m.level === 1 ? "a need" : "a difficulty"} \xB7 ${m.knowledge} \xB7 ${m.origin === "expert_inference" ? "expert inference" : "source analysis"}`]);
+    if (m.parent_reason) facts.push(["grouping", m.parent_reason]);
+  }
+  if (problem.segment) facts.push(["who", problem.segment]);
+  facts.push([
+    "weight",
+    problem.importance_basis === "evidence" ? `${Math.round(problem.importance)} from ${problem.proofs} piece${problem.proofs === 1 ? "" : "s"} of proof` : `${Math.round(problem.importance)}, a judgement${problem.importance_note ? ` \u2014 ${problem.importance_note}` : ""}`
+  ]);
+  if (problem.parent_ref) facts.push(["part of", problem.parent_ref]);
+  for (const [label, value] of facts) {
+    out.push(`${paint(ANSI.dim, label.padEnd(9))}${clip(value, width - 9)}`);
+  }
+  if (evidence2.length) {
+    out.push("");
+    out.push(paint(ANSI.dim, "sources"));
+    for (const item of evidence2) {
+      const when = (item.occurred_at ?? item.created_at).slice(0, 10);
+      const where = item.metric_key ?? item.source_ref ?? item.kind;
+      for (const line of wrap(item.body, width - 2)) out.push(`  ${line}`);
+      out.push(paint(ANSI.dim, `  \u2014 ${item.relation ?? "supports"} \xB7 ${item.kind} \xB7 ${where} \xB7 ${when}`));
+    }
+  } else {
+    out.push("");
+    out.push(paint(ANSI.dim, "No proof yet. This ranking is a judgement, and the next review may settle it."));
+  }
+  if (addressedBy.length) {
+    out.push("");
+    out.push(paint(ANSI.dim, "addressed by"));
+    for (const item of addressedBy) {
+      out.push(`  ${paint(ANSI.dim, item.ref)}  ${clip(item.title, width - 12)} ${paint(ANSI.dim, `(${item.status})`)}`);
+    }
+  }
+  out.push("");
+  out.push(paint(ANSI.dim, "  nanopm problems \xB7 nanopm roadmap"));
+  return out.join("\n");
+}
+
+// src/format/tree.ts
+var SOLUTION_SHAPE = {
+  proposed: { mark: "\u25CB", colour: ANSI.amber, label: "proposed" },
+  accepted: { mark: "\u25D0", colour: ANSI.green, label: "accepted" },
+  building: { mark: "\u25D4", colour: ANSI.blue, label: "building" },
+  done: { mark: "\u25CF", colour: ANSI.green, label: "done" },
+  rejected: { mark: "\u2298", colour: ANSI.red, label: "rejected" },
+  dropped: { mark: "\u2298", colour: ANSI.dim, label: "dropped" }
+};
+var PROBLEM_SHAPE = {
+  candidate: { mark: "\u25CB", colour: ANSI.dim },
+  confirmed: { mark: "\u25C9", colour: ANSI.amber },
+  addressed: { mark: "\u25CF", colour: ANSI.green },
+  dropped: { mark: "\u2298", colour: ANSI.dim }
+};
+var NO_AREA = "no area yet";
+var SHOWN = /* @__PURE__ */ new Set(["proposed", "accepted", "building", "done"]);
+function renderTree(problems2, solutions, strategy, opts) {
+  const paint = painter(opts.color);
+  const out = [];
+  const width = Math.max(40, columns());
+  if (strategy) {
+    out.push(paint(ANSI.bold, "Strategy"));
+    for (const line of wrap(strategy, width - 4)) out.push(`  ${line}`);
+    out.push("");
+  }
+  const shown = solutions.filter((s) => SHOWN.has(s.status));
+  const open = problems2.filter((p) => p.status !== "dropped" && (!opts.alongside || shown.some((s) => s.problem_id === p.id)));
+  if (opts.alongside && !open.length) return "";
+  if (!open.length && !shown.length) {
+    out.push("No problems yet. `nanopm opportunities` shows what to work on.");
+    return out.join("\n");
+  }
+  const byProblem = /* @__PURE__ */ new Map();
+  for (const s of shown) byProblem.set(s.problem_id, [...byProblem.get(s.problem_id) ?? [], s]);
+  const refWidth = Math.max(...[...open.map((p) => p.ref), ...shown.map((s) => s.ref)].map((r) => r.length), 5);
+  for (const [area, rows2] of groupByArea(open)) {
+    out.push(paint(ANSI.bold, area));
+    for (const p of rows2) {
+      const shape2 = PROBLEM_SHAPE[p.status] ?? { mark: "\xB7", colour: "" };
+      const kind = p.kind === "founder" ? paint(ANSI.dim, " (founder)") : "";
+      const proof = p.proofs ? `${p.proofs} proof${p.proofs === 1 ? "" : "s"}` : "no proof";
+      const tail = `${renderImportance(p, opts)}  ${paint(ANSI.dim, proof)}`;
+      const head = `  ${paint(shape2.colour, shape2.mark)} ${paint(ANSI.dim, p.ref.padEnd(refWidth))}  `;
+      out.push(head + clip(p.statement, Math.max(30, width - visibleLength(head) - visibleLength(tail) - 2)) + kind + "  " + tail);
+      const under = byProblem.get(p.id) ?? [];
+      if (!under.length) {
+        out.push(paint(ANSI.dim, `    ${" ".repeat(refWidth + 2)}  no solution yet`));
+        continue;
+      }
+      for (const s of under) out.push(...solutionLines(s, refWidth, width, paint));
+    }
+    out.push("");
+  }
+  const waiting = shown.filter((s) => s.status === "proposed").length;
+  if (waiting) {
+    out.push(`${waiting} waiting on you.`);
+    out.push(paint(ANSI.dim, '  nanopm accept <ref> \xB7 nanopm reject <ref> "why" \xB7 nanopm roadmap <ref> \xB7 nanopm roadmap --board'));
+  } else if (!opts.alongside) {
+    out.push(paint(ANSI.dim, "Nothing waiting on you."));
+  }
+  return out.join("\n").trimEnd();
 }
-async function rewordOpportunity(ref, problem, opts) {
-  const text2 = problem?.trim().replace(/\s+/g, " ") ?? "";
-  if (!text2) throw new Error('say it: nanopm opportunities reword <ref> "the problem, in your words"');
-  if (text2.length > PROBLEM_MAX) throw new Error(`one line, under ${PROBLEM_MAX} characters`);
-  await rpc2("restate_opportunity", { p_ref: ref, p_problem: text2 }, opts);
-  return `Kept in your words: ${text2}`;
+function solutionLines(s, refWidth, width, paint, indent = 6) {
+  const shape2 = SOLUTION_SHAPE[s.status] ?? { mark: "\xB7", colour: "", label: s.status };
+  const pad = " ".repeat(indent);
+  const STATE = { accepted: "chosen", building: "building", done: "done" };
+  const tail = s.actor === "founder" ? "yours to do" : s.outcome ? s.outcome : s.status === "proposed" ? s.assumption ? clip(s.assumption, 40) : null : STATE[s.status] ?? null;
+  const badge = tail ? paint(ANSI.dim, `  ${tail}`) : "";
+  const head = `${pad}${paint(shape2.colour, shape2.mark)} ${paint(ANSI.dim, s.ref.padEnd(refWidth))}  `;
+  const lines = [head + clip(s.title, Math.max(30, width - visibleLength(head) - visibleLength(badge))) + badge];
+  const reason2 = `${pad}  ${" ".repeat(refWidth)}  `;
+  lines.push(paint(ANSI.dim, reason2 + clip(firstSentence(s.reasoning), Math.max(30, width - reason2.length))));
+  return lines;
 }
-var AWAKE_MS = 12e4;
-async function awakeDaemon(client, userId) {
-  const since = new Date(Date.now() - AWAKE_MS).toISOString();
-  const [{ data }, local] = await Promise.all([
-    client.from("daemons").select("id, hostname").eq("user_id", userId).in("status", ["online", "running"]).gte("last_seen_at", since).order("last_seen_at", { ascending: false }),
-    localDaemonId()
-  ]);
-  return data?.find((d) => d.id === local) ?? data?.[0] ?? null;
+function groupByArea(problems2) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const p of problems2) {
+    const area = p.area ?? NO_AREA;
+    groups.set(area, [...groups.get(area) ?? [], p]);
+  }
+  const named = [...groups.entries()].filter(([a]) => a !== NO_AREA);
+  const rest = groups.get(NO_AREA);
+  return rest ? [...named, [NO_AREA, rest]] : named;
 }
-async function brainstorm(ref, opts) {
-  const auth = await authenticate();
-  const project = await resolveProject(auth.client, { projectId: opts.projectId, cwd: opts.cwd });
-  const [lens, all, busy] = await Promise.all([lensOf2(auth.client, project.id), loadOpportunities(auth.client, project.id), workingOn(auth.client, project.id)]);
-  const deep = Boolean(opts.deep);
-  const plan = brainstormPlan(shownMap(all, lens?.key ?? null).shown, ref, deep, new Set(busy.keys()));
-  const daemon = await awakeDaemon(auth.client, auth.userId);
-  if (!daemon) throw new Error("Your machine is asleep: none of your daemons has been seen in the last two minutes, so nothing was queued. `nanopm daemon install` starts it; then brainstorm again.");
-  const repo = deep ? await detectRepo(opts.cwd) : null;
-  if (repo) await rememberClone(auth.client, project.id, repo.root);
-  for (const params of plan.jobs) {
-    const { error } = await auth.client.from("jobs").insert({ project_id: project.id, skill: SOLUTIONS_SKILL, params: { ...params, ...repo ? { repo_path: repo.root } : {} }, requested_by: auth.userId, trigger: "user", target_daemon_id: daemon.id });
-    if (error) throw new Error(`could not queue the brainstorm: ${error.message}`);
+var BOARD_COLUMNS = [
+  { status: "proposed", label: "Proposed" },
+  { status: "accepted", label: "Chosen" },
+  { status: "building", label: "Building" },
+  { status: "done", label: "Done" }
+];
+function renderBoard(problems2, solutions, opts) {
+  const paint = painter(opts.color);
+  const out = [];
+  const byId = new Map(problems2.map((p) => [p.id, p]));
+  const width = Math.max(40, columns());
+  const refWidth = Math.max(...solutions.map((s) => s.ref.length), 5);
+  for (const col of BOARD_COLUMNS) {
+    const rows2 = solutions.filter((s) => s.status === col.status);
+    out.push(`${paint(ANSI.bold, col.label)} ${paint(ANSI.dim, String(rows2.length))}`);
+    if (!rows2.length) out.push(paint(ANSI.dim, "  \u2014"));
+    for (const s of rows2) {
+      const shape2 = SOLUTION_SHAPE[s.status];
+      const problem = byId.get(s.problem_id);
+      const head = `  ${paint(shape2.colour, shape2.mark)} ${paint(ANSI.dim, s.ref.padEnd(refWidth))}  `;
+      out.push(head + clip(s.title, Math.max(30, width - visibleLength(head))));
+      const under = [problem ? `${problem.ref} ${clip(problem.statement, 50)}` : "its problem was dropped", s.assumption ? clip(s.assumption, 40) : null].filter(Boolean).join(" \xB7 ");
+      out.push(paint(ANSI.dim, `  ${" ".repeat(refWidth + 2)}  ${under}`));
+    }
+    out.push("");
   }
-  const n = plan.leaves.length;
-  const minutes = deep ? DEEP_MINUTES * n : FLASH_MINUTES;
-  const what = plan.problem.children.length ? `the ${n} narrower problem${n === 1 ? "" : "s"} under ${plan.problem.ref}` : `${plan.problem.ref} \u201C${clip(plan.problem.problem, 60)}\u201D`;
-  const how = deep ? `${DEPTH_WORD.deep}${n > 1 ? ", one after the other" : ""}` : `${DEPTH_WORD.quick}, a first pass`;
-  const out = [`${deep ? "Going deeper on" : "Brainstorming"} ${what}: ${how}, about ${minutes} minutes on ${daemon.hostname}.`];
-  if (plan.problem.children.length) for (const l of plan.leaves) out.push(`  ${l.ref.padEnd(8)} ${clip(l.problem, Math.max(30, columns() - 11))}`);
-  if (plan.busy) out.push(`${plan.busy} left out: Nano is already finding solutions to ${plan.busy === 1 ? "it" : "them"}.`);
-  out.push("The solutions land on `nanopm roadmap`.");
-  return out.join("\n");
+  return out.join("\n").trimEnd();
 }
 
 // src/commands/roadmap.ts
@@ -15539,8 +15606,8 @@ async function decide(kind, ref, body, opts) {
   const row = Array.isArray(data) ? data[0] : void 0;
   if (!row) throw new Error(`nothing changed for ${ref}`);
   if (onMap) {
-    const next2 = card?.others[0];
-    const after = !card ? "" : next2 ? ` ${next2.ref} \u201C${next2.title}\u201D takes its card in ${HORIZON_WORD[card.horizon]}.` : ` Its card leaves the board: nothing else answers ${card.leaf.ref} yet. \`nanopm opportunities brainstorm ${card.leaf.ref}\` finds more.`;
+    const next = card?.others[0];
+    const after = !card ? "" : next ? ` ${next.ref} \u201C${next.title}\u201D takes its card in ${HORIZON_WORD[card.horizon]}.` : ` Its card leaves the board: nothing else answers ${card.leaf.ref} yet. \`nanopm opportunities brainstorm ${card.leaf.ref}\` finds more.`;
     return `Thrown out: ${row.ref}${body?.trim() ? ` \u2014 ${body.trim()}` : ""}.${after}`;
   }
   const verb = kind === "accept" ? "Accepted" : "Rejected";
@@ -15557,123 +15624,36 @@ function normalizeRef(input, items) {
   return given;
 }
 
-// src/commands/next.ts
-async function next(opts) {
+// src/commands/build.ts
+async function build(ref, opts) {
   const { renderer, out } = rendererFor(opts.out);
   const auth = await authenticate();
   const project = await resolveProject(auth.client, { projectId: opts.projectId, cwd: opts.cwd });
-  const autonomy2 = await readAutonomy(auth.client, project.id);
-  if (autonomy2 === "propose") {
-    throw new Error(
-      `${project.name} is on "propose", so NanoPM may look but not touch.
-  nanopm autonomy execute_after_validation   to let it change files, asking you first`
-    );
-  }
-  const { data: items, error } = await auth.client.from("solutions").select("id, ref, title, rank, status").eq("project_id", project.id).is("superseded_by", null).eq("status", "accepted").eq("actor", "nanopm").order("rank");
-  if (error) throw new Error(`could not read the solutions: ${error.message}`);
-  const accepted = items ?? [];
-  if (!accepted.length) {
-    throw new Error("nothing is accepted yet. Run `nanopm roadmap`, then `nanopm accept <ref>`.");
-  }
-  let item = accepted[0];
-  if (opts.ref) {
-    const wanted = normalizeRef(opts.ref, accepted);
-    const found = accepted.find((i) => i.ref === wanted);
-    if (!found) {
-      throw new Error(`${opts.ref} is not an accepted solution NanoPM can build. Accepted: ${accepted.map((i) => i.ref).join(", ")}.`);
-    }
-    item = found;
-  }
   const repo = await detectRepo(opts.cwd);
-  if (!repo) throw new Error("run this inside the repository, so NanoPM changes the clone you are looking at");
+  if (!repo) throw new Error("run this inside the repository, so NanoPM builds from the clone you are looking at");
+  const [daemon, local, { data: refs }] = await Promise.all([
+    awakeDaemon(auth.client, auth.userId),
+    localDaemonId(),
+    auth.client.from("solutions").select("ref").eq("project_id", project.id).is("superseded_by", null)
+  ]);
+  if (!local || daemon?.id !== local) throw new Error("This machine\u2019s daemon is asleep, so nothing was queued. `nanopm daemon install` starts it; then build again.");
   await rememberClone(auth.client, project.id, repo.root);
-  const daemonId = await localDaemonId();
-  const { data: job, error: queueError } = await auth.client.from("jobs").insert({
-    project_id: project.id,
-    skill: "next",
-    params: { solution_id: item.id, repo_path: repo.root },
-    requested_by: auth.userId,
-    target_daemon_id: daemonId
-  }).select("id").single();
-  if (queueError || !job) throw new Error(`could not queue the work: ${queueError?.message}`);
-  out(`${item.ref}  ${item.title}`);
+  const { jobId, solution } = await queueBuild(auth.client, {
+    projectId: project.id,
+    userId: auth.userId,
+    daemonId: local,
+    ref: normalizeRef(ref, refs ?? []),
+    repoPath: repo.root,
+    anyway: opts.anyway
+  });
+  out(`${solution.ref}  ${solution.title}`);
   const answerer = opts.answersFile ? await answersFromFile(opts.answersFile) : answersFromTerminal(out);
-  return streamJob(auth.client, job.id, { pollMs: 700, out, renderer, cancelSignal: opts.cancelSignal, answerer, verbose: verboseWanted() });
-}
-async function readAutonomy(client, projectId) {
-  const { data } = await client.from("project_preferences").select("autonomy").eq("project_id", projectId).maybeSingle();
-  return data?.autonomy ?? "propose";
-}
-var EXPLAINED = {
-  propose: "NanoPM reads and proposes. It never changes a file.",
-  execute_after_validation: "NanoPM changes files, on its own branch, after showing you what it will do and waiting for a yes.",
-  execute_then_report: "NanoPM acts first and tells you after. Not available yet."
-};
-async function autonomy(level, opts) {
-  const auth = await authenticate();
-  const project = await resolveProject(auth.client, { projectId: opts.projectId, cwd: opts.cwd });
-  const current = await readAutonomy(auth.client, project.id);
-  if (!level) {
-    const lines = [`${project.name} is on "${current}".`, ""];
-    for (const l of AUTONOMY_LEVELS) {
-      lines.push(`  ${l === current ? "\u25CF" : "\u25CB"} ${l.padEnd(26)} ${EXPLAINED[l]}`);
-    }
-    lines.push("", "  nanopm autonomy <level>");
-    return lines.join("\n");
-  }
-  const wanted = level.trim();
-  if (!AUTONOMY_LEVELS.includes(wanted)) {
-    throw new Error(`"${level}" is not a level. Pick one of: ${AUTONOMY_LEVELS.join(", ")}.`);
-  }
-  if (wanted === "execute_then_report") {
-    throw new Error(
-      "execute_then_report is not available yet. NanoPM asks before it changes anything until the review loop has been used in anger."
-    );
-  }
-  if (wanted === current) return `${project.name} is already on "${current}".`;
-  const { error } = await auth.client.from("project_preferences").update({ autonomy: wanted }).eq("project_id", project.id);
-  if (error) {
-    throw new Error(`could not change the dial: ${error.message}`);
-  }
-  return [`${project.name} is now on "${wanted}".`, EXPLAINED[wanted]].join("\n");
-}
-async function verifyCommand(command, opts) {
-  const auth = await authenticate();
-  const project = await resolveProject(auth.client, { projectId: opts.projectId, cwd: opts.cwd });
-  const { data } = await auth.client.from("project_preferences").select("verify_command").eq("project_id", project.id).maybeSingle();
-  const current = data?.verify_command ?? null;
-  if (!command && !opts.clear) {
-    if (!current) {
-      return [
-        `${project.name} has no check, so nothing verifies what NanoPM writes.`,
-        "",
-        '  nanopm verify "npm run lint && npm test"',
-        "",
-        "The daemon runs it in the repository root after a change and before the solution is",
-        "marked done. A failure goes back to NanoPM once, to fix."
-      ].join("\n");
-    }
-    return [`${project.name} verifies with:`, "", `  ${current}`, "", '  nanopm verify "<command>" \xB7 nanopm verify --clear'].join("\n");
-  }
-  const next2 = opts.clear ? null : command.trim();
-  if (next2 !== null && !next2) throw new Error('a check needs a command: nanopm verify "npm test"');
-  const { error } = await auth.client.from("project_preferences").update({ verify_command: next2 }).eq("project_id", project.id);
-  if (error) throw new Error(`could not save the check: ${error.message}`);
-  if (next2 === null) return `${project.name} no longer runs a check. Nothing will verify what NanoPM writes.`;
-  return [
-    `${project.name} will verify with:`,
-    "",
-    `  ${next2}`,
-    "",
-    "It runs in the repository root. If your change touches what the command itself runs \u2014",
-    "package.json, a lockfile, the script it calls \u2014 the check is skipped and you are told,",
-    "because an agent that can rewrite its own examiner is not being examined."
-  ].join("\n");
+  return streamJob(auth.client, jobId, { pollMs: 700, out, renderer, cancelSignal: opts.cancelSignal, answerer, verbose: verboseWanted() });
 }
 
 // src/detect-sources.ts
-import { readFile as readFile12 } from "fs/promises";
-import { join as join14 } from "path";
+import { readFile as readFile14 } from "fs/promises";
+import { join as join16 } from "path";
 var ENV_FILES = [".env", ".env.local", ".env.development.local", ".env.development", ".env.example"];
 var POSTGRES_KEYS = [
   "DATABASE_URL",
@@ -15723,7 +15703,7 @@ async function envFiles(repoRoot) {
   const out = [];
   for (const file of ENV_FILES) {
     try {
-      out.push({ file, env: parseEnv(await readFile12(join14(repoRoot, file), "utf8")) });
+      out.push({ file, env: parseEnv(await readFile14(join16(repoRoot, file), "utf8")) });
     } catch {
       continue;
     }
@@ -15783,7 +15763,7 @@ function describeUrl(url) {
 // src/format/closing.ts
 function closingLines(project, exit, env = process.env, mode = "onboard") {
   if (exit !== 0) return [];
-  const build = mode === "start" ? `nanopm accept <ref> takes an option; when one needs code, in its repo: nanopm onboard --project ${project.id ?? "<id>"} attaches it, then nanopm next builds it` : "nanopm accept <ref> takes an option, nanopm next builds it";
+  const build2 = mode === "start" ? `nanopm accept <ref> takes an option; when one needs code, in its repo: nanopm onboard --project ${project.id ?? "<id>"} attaches it, then nanopm build <ref> builds it` : "nanopm spec <ref> --write writes its specs, nanopm build <ref> builds it";
   const chain = chainedAfter(mode).map((skill) => skillSentence(skill));
   return [
     "",
@@ -15791,7 +15771,7 @@ function closingLines(project, exit, env = process.env, mode = "onboard") {
     ...chain.length ? [`NanoPM is now ${joinAnd(chain)}; the Roadmap fills in as it goes. Watch it at ${webUrl(env)}/p/${project.slug}/journal`] : [],
     // The map is no longer chained after onboarding, so the first three clauses are what
     // builds it: what users said, where they leave traces, then the map that reads both.
-    `Next: nanopm add <file> adds what users said \xB7 nanopm connect adds where they leave traces \xB7 nanopm opportunities run ranks what to work on \xB7 ${build} \xB7 nanopm schedule weekly monday 7 sets the review`,
+    `Next: nanopm add <file> adds what users said \xB7 nanopm connect adds where they leave traces \xB7 nanopm opportunities run ranks what to work on \xB7 ${build2} \xB7 nanopm schedule weekly monday 7 sets the review`,
     "With a partner: nanopm invite <email> prints a link; they open it, or in their clone: nanopm login, then nanopm join <code>"
   ];
 }
@@ -15937,7 +15917,9 @@ async function spec(ref, opts) {
   const wanted = ref.trim().toUpperCase();
   const { data: solution } = await auth.client.from("solutions").select("id, ref, title, agent_spec").eq("project_id", project.id).eq("ref", wanted).maybeSingle();
   if (!solution) throw new Error(`no solution ${wanted}. Run \`nanopm roadmap\` to see them.`);
-  if (!opts.write) {
+  if (opts.write && opts.rework) throw new Error("--write or --rework, not both.");
+  const mode = opts.rework ? "rework" : opts.write ? "write" : null;
+  if (!mode) {
     if (!solution.agent_spec) return `${solution.ref} has no specs yet: \`nanopm spec ${solution.ref} --write\`, or *Write the specs* on its sheet.`;
     return solution.agent_spec.trimEnd();
   }
@@ -15945,11 +15927,9 @@ async function spec(ref, opts) {
   if (!daemon) throw new Error("Your machine is asleep: none of your daemons has been seen in the last two minutes, so nothing was queued. `nanopm daemon install` starts it; then ask again.");
   const repo = await detectRepo(opts.cwd);
   if (repo) await rememberClone(auth.client, project.id, repo.root);
-  await queueSpecs(auth.client, { projectId: project.id, userId: auth.userId, daemonId: daemon.id, ref: solution.ref });
-  return [
-    `Writing the specs of ${solution.ref} \u201C${clip(solution.title, 60)}\u201D: the brief and the agent spec, about ${SPEC_MINUTES} minutes on ${daemon.hostname}${repo ? ", reading this code" : ""}.`,
-    `They land on its sheet; \`nanopm spec ${solution.ref}\` prints the agent spec.`
-  ].join("\n");
+  await queueSpecs(auth.client, { projectId: project.id, userId: auth.userId, daemonId: daemon.id, ref: solution.ref, mode });
+  const where = `about ${SPEC_MINUTES} minutes on ${daemon.hostname}${repo ? ", reading this code" : ""}`;
+  return mode === "rework" ? [`Reworking ${solution.ref} \u201C${clip(solution.title, 60)}\u201D: the whole solution and its agent spec, ${where}.`, "The new version takes its card on the Roadmap; `nanopm roadmap` names it."].join("\n") : [`Writing the specs of ${solution.ref} \u201C${clip(solution.title, 60)}\u201D: what it lacks and the agent spec, ${where}.`, `They land on its sheet; \`nanopm spec ${solution.ref}\` prints the agent spec.`].join("\n");
 }
 
 // src/commands/want.ts
@@ -16492,7 +16472,7 @@ async function seedWatches(watches2, read6) {
 }
 
 // src/commands/watch.ts
-import { readFile as readFile13 } from "fs/promises";
+import { readFile as readFile15 } from "fs/promises";
 function cursorFor(source, watchId) {
   const all = source.cursor ?? {};
   return all[watchId] ?? {};
@@ -16553,7 +16533,7 @@ async function addWatch(labelOrId, id, opts) {
   const paint = painter(color);
   if (!labelOrId || !id) throw new Error('say which feed and what to call it: nanopm watch add <source> <id> --query "\u2026"');
   if (opts.query && opts.queryFile) throw new Error("--query or --query-file, not both");
-  const query = opts.queryFile ? await readFile13(opts.queryFile, "utf8") : opts.query ?? "";
+  const query = opts.queryFile ? await readFile15(opts.queryFile, "utf8") : opts.query ?? "";
   const watch = watchInput(id, query, opts);
   const auth = await authenticate();
   const project = await resolveProject(auth.client, { projectId: opts.projectId, cwd: opts.cwd });
@@ -16740,9 +16720,9 @@ async function review(opts) {
   }
   const usable = connections.filter((c) => c.status === "ok");
   if (!usable.length) {
-    const failed = connections.map((c) => c.label).join(", ");
+    const failed2 = connections.map((c) => c.label).join(", ");
     throw new Error(
-      `no connection is working (${failed}), so a review would have nothing to read.
+      `no connection is working (${failed2}), so a review would have nothing to read.
   nanopm connect --list                      see what is wrong`
     );
   }
@@ -17377,12 +17357,12 @@ function renderDirection(rows2) {
   const out = [];
   for (const line of DIRECTION_ROWS) {
     const row = rows2.find((r) => r.key === directionKey(line));
-    const next2 = rows2.find((r) => r.key === directionKey(line, true));
+    const next = rows2.find((r) => r.key === directionKey(line, true));
     out.push(`${DIRECTION_ROW_TITLE[line]}${mark(row)}`);
     out.push(`  ${row?.content ?? "\u2014"}`);
-    if (next2) {
-      const because = reasonOf2(next2.sources);
-      out.push(`  proposed: ${next2.content}${because ? `  \xB7 ${because}` : ""}`);
+    if (next) {
+      const because = reasonOf2(next.sources);
+      out.push(`  proposed: ${next.content}${because ? `  \xB7 ${because}` : ""}`);
     }
   }
   out.push("Objective");
@@ -17422,13 +17402,13 @@ function render2(rows2) {
   const out = [];
   for (const line of PITCH_LINE_KEYS) {
     const row = rows2.find((r) => r.key === pitchKey(line));
-    const next2 = rows2.find((r) => r.key === pitchKey(line, true));
+    const next = rows2.find((r) => r.key === pitchKey(line, true));
     const mark2 = row && row.provenance !== "stated" ? `  \xB7 to review${row.confidence != null ? ` (${row.confidence}% sure)` : ""}` : "";
     out.push(`${PITCH_LINE_TITLE[line]}${mark2}`);
     out.push(`  ${row?.content ?? "\u2014"}`);
-    if (next2) {
-      const because = reasonOf3(next2.sources);
-      out.push(`  proposed: ${next2.content}${because ? `  \xB7 ${because}` : ""}`);
+    if (next) {
+      const because = reasonOf3(next.sources);
+      out.push(`  proposed: ${next.content}${because ? `  \xB7 ${because}` : ""}`);
     }
   }
   return out.join("\n");
@@ -17486,7 +17466,7 @@ async function invite(email, opts) {
   const [, ...rest] = inviteLines({ name: project.name, code, email: email.trim().toLowerCase(), web: webUrl() });
   return [`Invite to ${paint(ANSI.bold, project.name)}: ${paint(ANSI.bold, code)}`, ...rest.map((l) => l ? paint(ANSI.dim, l) : l)].join("\n");
 }
-async function join15(code, opts) {
+async function join17(code, opts) {
   const normalized2 = code.trim().toUpperCase();
   if (!INVITE_CODE.test(normalized2)) throw new Error(`that does not look like an invite code: ten letters and digits, like ${"K7PQ2XM9RT"}`);
   const repo = await detectRepo(opts.cwd);
@@ -17941,8 +17921,8 @@ function buildProgram() {
     }
     console.log(await roadmap(ref, { cwd: process.cwd(), projectId: opts.project, board: opts.board, color: colorOf(opts) }));
   });
-  program.command("spec <ref>").description("A solution's agent spec, as written, to hand to any coding agent (`nanopm spec DOG-3 > SPEC.md`); `--write` asks Nano for its specs \u2014 the solution brief and the agent spec \u2014 reading this code, read-only").option("--project <id>", "project id (default: the project of the current repo)").option("--write", "write the specs, or write them again").action(async (ref, opts) => {
-    console.log(await spec(ref, { cwd: process.cwd(), projectId: opts.project, write: opts.write }));
+  program.command("spec <ref>").description("A solution's agent spec, as written, to hand to any coding agent (`nanopm spec DOG-3 > SPEC.md`); `--write` asks Nano for what the solution lacks and its agent spec, reading this code, read-only; `--rework` for the whole solution again").option("--project <id>", "project id (default: the project of the current repo)").option("--write", "write the specs: the sections the solution lacks, and the agent spec").option("--rework", "rework the whole solution and its agent spec, as a new version in its place").action(async (ref, opts) => {
+    console.log(await spec(ref, { cwd: process.cwd(), projectId: opts.project, write: opts.write, rework: opts.rework }));
   });
   for (const [kind, help] of [
     ["accept", "Accept a solution; NanoPM builds it when you ask, or you do it and say so with 'nanopm done'"],
@@ -18187,7 +18167,7 @@ function buildProgram() {
     console.log(await invite(email, { cwd: process.cwd(), projectId: opts.project, color: colorOf(opts) }));
   });
   program.command("join <code>").description("Join a project you were invited to, from inside your clone of its repository").option("--no-color", "plain output").action(async (code, opts) => {
-    console.log(await join15(code, { cwd: process.cwd(), color: colorOf(opts) }));
+    console.log(await join17(code, { cwd: process.cwd(), color: colorOf(opts) }));
   });
   program.command("members").description("Who is on this project, and whether their daemon is awake").option("--project <id>", "project id (default: the project of the current repo)").option("--no-color", "plain output").action(async (opts) => {
     console.log(await members({ cwd: process.cwd(), projectId: opts.project, color: colorOf(opts) }));
@@ -18209,16 +18189,10 @@ function buildProgram() {
   program.command("status").description("What is happening with this product: next review, what is waiting on you, whether the daemon is awake").option("--project <id>", "project id (default: the project of the current repo)").option("--no-color", "plain output").action(async (opts) => {
     console.log(await status({ cwd: process.cwd(), projectId: opts.project, color: colorOf(opts) }));
   });
-  program.command("next [ref]").description("Build an accepted solution, or the top one: a branch, a diff, and a pull request").option("--project <id>", "project id (default: the project of the current repo)").option("--ref <ref>", "same as the positional argument").option("--answers <file>", "answer its questions from a file instead of the terminal").action(async (ref, opts) => {
+  program.command("build <ref>").description("Build a solution from its agent spec, in a copy of this repository, to a draft pull request").option("--project <id>", "project id (default: the project of the current repo)").option("--anyway", "build although its questions for you are not answered").option("--answers <file>", "answer its questions from a file instead of the terminal").action(async (ref, opts) => {
     const cancel = new AbortController();
     process.once("SIGINT", () => cancel.abort());
-    process.exitCode = await next({
-      cwd: process.cwd(),
-      projectId: opts.project,
-      ref: ref ?? opts.ref,
-      answersFile: opts.answers,
-      cancelSignal: cancel.signal
-    });
+    process.exitCode = await build(ref, { cwd: process.cwd(), projectId: opts.project, anyway: opts.anyway, answersFile: opts.answers, cancelSignal: cancel.signal });
   });
   program.command("autonomy [level]").description("How far NanoPM may go on its own: read it, or set it").option("--project <id>", "project id (default: the project of the current repo)").action(async (level, opts) => {
     console.log(await autonomy(level, { cwd: process.cwd(), projectId: opts.project }));