@noir-ai/cli 1.3.0-beta.6 → 1.4.0-beta.2

package/dist/bin.js

@@ -1,28 +1,36 @@
 #!/usr/bin/env node
 import {
-  doctor,
   serve
-} from "./chunk-3QMQXBII.js";
+} from "./chunk-A5W2E3X2.js";
 import {
   init
-} from "./chunk-J2Y3BOVK.js";
+} from "./chunk-SVFQGAOF.js";
 import {
   EXIT,
   NoirCliError,
+  accessibleMode,
+  badge,
+  c,
+  definitionList,
+  doctor,
   fail,
   handleError,
   inferExitCode,
   info,
   isInteractive,
+  json,
   log,
+  requireInteractive,
   table,
+  tip,
+  useColor,
   warn
-} from "./chunk-OF4OO5W6.js";
+} from "./chunk-YES5UCU5.js";
 
 // src/bin.ts
 import { realpathSync } from "fs";
 import { pathToFileURL } from "url";
-import { SUPPORTED_HOSTS as SUPPORTED_HOSTS2 } from "@noir-ai/adapters";
+import { SUPPORTED_HOSTS } from "@noir-ai/adapters";
 import { NOIR_VERSION as NOIR_VERSION3 } from "@noir-ai/core";
 import { Command, Option } from "commander";
 
@@ -219,7 +227,7 @@ async function contextSearch(opts) {
   renderSearch(data, opts);
 }
 function renderSearch(data, opts) {
-  const flag = data.degraded ? " [degraded: BM25-only]" : "";
+  const flag = data.degraded ? `  ${badge("warn", "degraded: BM25-only")}` : "";
   const trunc = data.truncated ? " (budget hit \u2014 results truncated)" : "";
   log(
     `context search \u2014 ${data.hits.length} hit${data.hits.length === 1 ? "" : "s"} \xB7 ${data.mode} \xB7 ${data.consumedTokens} tokens${flag}${trunc}`,
@@ -263,17 +271,16 @@ async function contextIndex(opts) {
 }
 function renderIndex(data, paths, opts) {
   const scope = paths && paths.length > 0 ? paths.join(", ") : ".";
-  const flag = data.degraded ? " [degraded: vectors skipped]" : "";
+  const flag = data.degraded ? `  ${badge("warn", "degraded: vectors skipped")}` : "";
   log(`context index \u2014 ${scope}${flag}`, opts);
-  table(
+  definitionList(
     [
-      { Field: "Indexed (new)", Value: data.indexed },
-      { Field: "Skipped (unchanged)", Value: data.skipped },
-      { Field: "Deleted (removed)", Value: data.deleted },
-      { Field: "Failed", Value: data.failed },
-      { Field: "Total chunks", Value: data.totalChunks }
+      { label: "Indexed (new)", value: data.indexed },
+      { label: "Skipped (unchanged)", value: data.skipped },
+      { label: "Deleted (removed)", value: data.deleted },
+      { label: "Failed", value: data.failed },
+      { label: "Total chunks", value: data.totalChunks }
     ],
-    ["Field", "Value"],
     opts
   );
   if (data.failed > 0) {
@@ -297,18 +304,17 @@ function describeEmbedder(e) {
   return `${e.kind} \xB7 ${model} (${e.dim}-dim)`;
 }
 function renderStatus(data, opts) {
-  const flag = data.degraded ? " [degraded]" : "";
+  const flag = data.degraded ? `  ${badge("warn", "degraded")}` : "";
   log(`context status \u2014 ${data.projectId}${flag}`, opts);
-  table(
+  definitionList(
     [
-      { Field: "Project", Value: data.projectId },
-      { Field: "Docs", Value: data.docCount },
-      { Field: "Vectors", Value: data.vecCount },
-      { Field: "Indexed files", Value: data.indexedFiles },
-      { Field: "Embedder", Value: describeEmbedder(data.embedder) },
-      { Field: "Degraded", Value: data.degraded ? "yes" : "no" }
+      { label: "Project", value: data.projectId },
+      { label: "Docs", value: data.docCount },
+      { label: "Vectors", value: data.vecCount },
+      { label: "Indexed files", value: data.indexedFiles },
+      { label: "Embedder", value: describeEmbedder(data.embedder) },
+      { label: "Degraded", value: data.degraded ? "yes" : "no" }
     ],
-    ["Field", "Value"],
     opts
   );
 }
@@ -461,191 +467,676 @@ async function daemonRestart(opts) {
   await daemonStart(opts);
 }
 
-// src/commands/home.ts
-import { SUPPORTED_HOSTS } from "@noir-ai/adapters";
-import { loadProjectInfo as loadProjectInfo3 } from "@noir-ai/core";
-
-// src/banner.ts
-import gradient from "gradient-string";
-import pc from "picocolors";
-var NOIR_BLOCK = [
-  "\u2588\u2588\u2588\u2557   \u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 ",
-  "\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557 \u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557",
-  "\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551 \u2588\u2588\u2551   \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D",
-  "\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551 \u2588\u2588\u2551   \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551",
-  "\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551 \u2588\u2588\u2551  \u2588\u2588\u2551",
-  "\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D"
-];
-var NOIR_GRADIENT = gradient("#2c5282", "#3b82f6", "#7dd3fc");
-var NOIR_TAGLINE = "discipline, context, and memory layer for agentic CLIs";
-function renderBanner(opts = {}) {
-  const width = opts.width ?? process.stdout.columns ?? 80;
-  const color = opts.color ?? true;
-  if (width < 50) {
-    return color ? `${pc.magenta("\u25C6")} noir` : "\u25C6 noir";
-  }
-  const block = NOIR_BLOCK.join("\n");
-  return color ? NOIR_GRADIENT.multiline(block) : block;
-}
-function shouldShowBanner(opts) {
-  if (opts.quiet === true || opts.json === true) return false;
-  const v = process.env.NOIR_NO_BANNER;
-  if (v !== void 0 && v !== "") return false;
-  return true;
-}
+// src/commands/handoff.ts
+import { mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+import {
+  defaultHandoffBlock,
+  hostLaunchDirective,
+  resolveAdapter
+} from "@noir-ai/adapters";
+import { loadProjectInfo as loadProjectInfo4, NOIR_DIR } from "@noir-ai/core";
 
-// src/commands/home.ts
-function tryProject() {
+// src/commands/status.ts
+import { loadProjectInfo as loadProjectInfo3, NOIR_VERSION as NOIR_VERSION2 } from "@noir-ai/core";
+async function tryTool(caller, name, args) {
   try {
-    const info2 = loadProjectInfo3(process.cwd());
-    return { id: info2.id, name: info2.name, host: info2.config.host };
+    return await caller.callTool(name, args);
   } catch {
     return null;
   }
 }
-var COMMANDS_HINT = "Commands: init \xB7 create \xB7 sync \xB7 status \xB7 context \xB7 memory \xB7 skills \xB7 task \xB7 daemon \xB7 doctor";
-function hostDirection(host) {
-  const others = SUPPORTED_HOSTS.filter((h) => h !== host);
-  return `\u2192 host: ${host}. Open \`${host}\` to start development \u2014 Noir set the rules, skills, and memory; ${host} runs the code. (other hosts: ${others.join(", ")})`;
-}
-async function home(opts, deps) {
-  if (isInteractive(opts)) {
-    await runMenu(opts, deps);
-    return;
-  }
-  if (opts.json === true) {
-    await deps.dispatch(["status", "--json"]);
-    return;
-  }
-  await deps.dispatch(["status"]);
+function pickStore(s) {
+  if (s?.ok !== true) return null;
+  return {
+    docCount: s.docCount,
+    vecCount: s.vecCount,
+    dbPath: s.dbPath,
+    degraded: s.degraded === true
+  };
 }
-async function runMenu(opts, deps) {
-  const clack = await import("@clack/prompts");
-  const project = tryProject();
-  if (shouldShowBanner(opts)) {
-    const host = project?.host ?? "claude";
-    process.stderr.write(
-      `
-${renderBanner()}
-${NOIR_TAGLINE}
-
-${hostDirection(host)}
-${COMMANDS_HINT}
-
-`
-    );
-  }
-  clack.intro(project ? `noir \u2014 ${project.name}` : "noir");
-  const choice = await clack.select({
-    message: "What would you like to do?",
-    initialValue: "status",
-    options: [
-      { value: "status", label: "Status", hint: "project + daemon + store snapshot" },
-      { value: "index", label: "Index project", hint: "(re)index files into context" },
-      { value: "recall", label: "Recall memory", hint: "search cross-session memory" },
-      { value: "next", label: "Next task", hint: "suggest next phase + skill" },
-      { value: "daemon", label: "Start daemon", hint: "foreground daemon" },
-      { value: "sync", label: "Sync skills", hint: "re-emit builtin skills" },
-      { value: "exit", label: "Exit" }
-    ]
-  });
-  if (clack.isCancel(choice)) {
-    clack.cancel("Cancelled.");
-    fail(EXIT.CANCELLED, "cancelled", opts);
-  }
-  const argv = await argvForChoice(choice, clack, opts);
-  if (argv === null) {
-    clack.outro("bye");
-    return;
-  }
-  await deps.dispatch(argv);
-  clack.outro("done");
+function describeEmbedder2(e) {
+  if (!e || e.kind === "none") return "none (BM25-only)";
+  const model = typeof e.model === "string" && e.model.length > 0 ? e.model : "<unset>";
+  return `${e.kind} \xB7 ${model} (${e.dim}-dim)`;
 }
-async function argvForChoice(choice, clack, opts) {
-  switch (choice) {
-    case "status":
-      return ["status"];
-    case "index":
-      return ["context", "index"];
-    case "next":
-      return ["task", "next"];
-    case "daemon":
-      return ["daemon", "start"];
-    case "sync":
-      return ["sync"];
-    case "exit":
-      return null;
-    case "recall": {
-      const query = await clack.text({
-        message: "Recall query:",
-        placeholder: "e.g. auth flow, ContextEngine, deploy steps"
-      });
-      if (clack.isCancel(query)) {
-        clack.cancel("Cancelled.");
-        fail(EXIT.CANCELLED, "cancelled", opts);
-      }
-      return ["memory", "recall", String(query)];
-    }
-    default:
-      return null;
-  }
+function pickContext(c2) {
+  if (c2?.ok !== true) return null;
+  return {
+    docCount: c2.docCount,
+    vecCount: c2.vecCount,
+    indexedFiles: c2.indexedFiles,
+    embedder: describeEmbedder2(c2.embedder),
+    degraded: c2.degraded === true
+  };
 }
-
-// src/commands/memory.ts
-function parseLimit2(raw, label, opts) {
-  if (raw === void 0) return void 0;
-  const n = Number(raw);
-  if (!Number.isInteger(n) || n <= 0) {
-    fail(EXIT.USAGE, `${label}: --limit must be a positive integer (got '${raw}')`, opts);
-  }
-  return n;
+function pickWorkflow(w) {
+  if (w?.ok !== true) return null;
+  return {
+    taskId: w.taskId,
+    phase: w.phase,
+    state: w.state,
+    mode: w.mode,
+    nextGate: w.nextGate,
+    degraded: w.degraded === true
+  };
 }
-function splitCsv(raw) {
-  if (raw === void 0) return void 0;
-  const out = raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
-  return out.length > 0 ? out : void 0;
+function pickMemory(m) {
+  if (m?.ok !== true || !Array.isArray(m.sessions)) return null;
+  let observations = 0;
+  for (const s of m.sessions) observations += s.count;
+  return { sessions: m.sessions.length, observations };
 }
-function toHit2(raw) {
-  const h = raw ?? {};
-  const arr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
+function buildPayload(project, probe, host, store, context, workflow, memory) {
   return {
-    id: typeof h.id === "string" ? h.id : "",
-    type: typeof h.type === "string" ? h.type : "",
-    score: typeof h.score === "number" ? h.score : 0,
-    content: typeof h.content === "string" ? h.content : "",
-    concepts: arr(h.concepts),
-    files: arr(h.files),
-    ts: typeof h.ts === "number" ? h.ts : 0,
-    importance: typeof h.importance === "number" ? h.importance : 0,
-    source: typeof h.source === "string" ? h.source : ""
+    noir: NOIR_VERSION2,
+    project: { id: project.id, name: project.name },
+    host: project.config.host,
+    daemon: {
+      running: probe.running,
+      ...probe.pid !== void 0 ? { pid: probe.pid } : {},
+      ...probe.uptimeSec !== void 0 ? { uptimeSec: probe.uptimeSec } : {},
+      ...host && typeof host.transport === "string" ? { transport: host.transport } : {}
+    },
+    store: pickStore(store),
+    context: pickContext(context),
+    workflow: pickWorkflow(workflow),
+    memory: pickMemory(memory)
   };
 }
-function failTool2(label, envelope, opts) {
-  const detail = envelope.error ?? envelope.reason ?? "unknown failure";
-  fail(EXIT.ERROR, `${label}: ${detail}`, opts);
+function formatDuration(sec) {
+  if (typeof sec !== "number" || sec < 0) return "unknown";
+  if (sec < 60) return `${sec}s`;
+  if (sec < 3600) return `${Math.floor(sec / 60)}m ${sec % 60}s`;
+  return `${Math.floor(sec / 3600)}h ${Math.floor(sec % 3600 / 60)}m`;
 }
-function stamp(ts) {
-  if (typeof ts !== "number" || ts <= 0) return "-";
-  return new Date(ts).toISOString().replace("T", " ").replace(/\..*$/, "Z");
+function describeDaemon(d) {
+  if (!d.running) return "not running (start with `noir daemon start`)";
+  const pid = typeof d.pid === "number" ? `pid ${d.pid}` : "pid unknown";
+  const up = typeof d.uptimeSec === "number" ? `, up ${formatDuration(d.uptimeSec)}` : "";
+  const transport = typeof d.transport === "string" ? `, ${d.transport}` : "";
+  return `running (${pid}${up}${transport})`;
 }
-async function memoryRecall(opts) {
-  const limit = parseLimit2(opts.limit, "memory recall", opts);
-  const res = await callDaemonTool(opts, "memory_recall", {
-    query: opts.query,
-    ...limit === void 0 ? {} : { limit }
-  });
-  if (res.ok !== true) failTool2("memory recall", res, opts);
-  const hits = Array.isArray(res.results) ? res.results.map(toHit2) : [];
-  const data = { query: opts.query, hits, degraded: res.degraded === true };
+function describeStore(s) {
+  if (!s) return "unavailable (store engine not wired)";
+  const flag = s.degraded ? `  ${badge("warn", "degraded: read-only")}` : "";
+  return `${s.docCount} docs / ${s.vecCount} vecs${flag}`;
+}
+function describeContext(c2) {
+  if (!c2) return "unavailable (context engine not wired)";
+  const flag = c2.degraded ? `  ${badge("warn", "degraded")}` : "";
+  return `${c2.docCount} docs, ${c2.vecCount} vecs, ${c2.indexedFiles} files \xB7 embedder ${c2.embedder}${flag}`;
+}
+function describeWorkflow(w) {
+  if (!w) return "no active task";
+  const gate = w.nextGate ? ` \u2192 next gate: ${w.nextGate}` : "";
+  const flag = w.degraded ? `  ${badge("warn", "degraded")}` : "";
+  return `${w.phase} (${w.state}, ${w.mode}) \xB7 task ${w.taskId}${gate}${flag}`;
+}
+function describeMemory(m) {
+  if (!m) return "unavailable (memory engine not wired)";
+  return `${m.observations} observations across ${m.sessions} session${m.sessions === 1 ? "" : "s"}`;
+}
+function renderHuman(p, opts) {
+  log(`noir status \u2014 ${p.project.name} (${p.project.id})`, opts);
+  definitionList(
+    [
+      { label: "Project", value: `${p.project.name} (${p.project.id})` },
+      { label: "Host", value: p.host },
+      { label: "Noir", value: p.noir },
+      { label: "Daemon", value: describeDaemon(p.daemon) },
+      { label: "Store", value: describeStore(p.store) },
+      { label: "Context", value: describeContext(p.context) },
+      { label: "Workflow", value: describeWorkflow(p.workflow) },
+      { label: "Memory", value: describeMemory(p.memory) }
+    ],
+    opts
+  );
+}
+async function gatherStatusPayload(opts) {
+  const project = loadProjectInfo3(process.cwd());
+  const probe = await probeDaemon(opts);
+  let host = null;
+  let store = null;
+  let context = null;
+  let workflow = null;
+  let memory = null;
+  if (probe.running) {
+    await withRunningDaemon(
+      opts,
+      async (caller) => {
+        host = await tryTool(caller, "host_status");
+        store = await tryTool(caller, "store_status");
+        context = await tryTool(caller, "context_status");
+        workflow = await tryTool(caller, "workflow_status");
+        memory = await tryTool(caller, "memory_sessions");
+      },
+      probe
+    );
+  }
+  return buildPayload(project, probe, host, store, context, workflow, memory);
+}
+async function status(opts) {
+  const payload = await gatherStatusPayload(opts);
   if (opts.json === true) {
-    process.stdout.write(`${JSON.stringify({ ok: true, data })}
+    process.stdout.write(`${JSON.stringify({ ok: true, data: payload })}
 `);
     return;
   }
-  renderRecall(data.query, hits, data.degraded, opts);
+  renderHuman(payload, opts);
+}
+
+// src/commands/task.ts
+var PHASE_SKILL = {
+  intake: "noir-intake",
+  clarify: "noir-clarify",
+  spec: "noir-spec",
+  plan: "noir-plan",
+  execute: "noir-execute",
+  verify: "noir-verify",
+  document: "noir-document"
+};
+function skillFor(phase) {
+  if (typeof phase !== "string") return null;
+  return PHASE_SKILL[phase] ?? null;
+}
+async function fetchStatus(opts, taskId) {
+  const args = typeof taskId === "string" && taskId.length > 0 ? { taskId } : {};
+  const res = await callDaemonTool(
+    opts,
+    "workflow_status",
+    args
+  );
+  if (res.ok === true) return res;
+  const detail = res.error ?? "task not found";
+  fail(EXIT.NOT_FOUND, `task: ${detail}`, opts);
+}
+function formatStamp(ms) {
+  if (typeof ms !== "number" || ms <= 0) return "-";
+  return new Date(ms).toISOString().replace("T", " ").replace(/\..*$/, "Z");
+}
+function renderStatusRow(s, opts) {
+  const flag = s.degraded === true ? `  ${badge("warn", "degraded")}` : "";
+  log(`task status \u2014 ${s.taskId}${flag}`, opts);
+  definitionList(
+    [
+      { label: "Task", value: s.taskId },
+      { label: "Phase", value: s.phase },
+      { label: "State", value: s.state },
+      { label: "Mode", value: s.mode },
+      { label: "Next gate", value: s.nextGate ?? "\u2014" },
+      { label: "Updated", value: formatStamp(s.updatedAt) }
+    ],
+    opts
+  );
+}
+async function taskStatus(opts) {
+  const s = await fetchStatus(opts, opts.id);
+  if (opts.json === true) {
+    process.stdout.write(`${JSON.stringify({ ok: true, data: s })}
+`);
+    return;
+  }
+  renderStatusRow(s, opts);
+}
+async function taskNext(opts) {
+  const s = await fetchStatus(opts);
+  const suggestion = skillFor(s.phase);
+  const nextSkill = skillFor(s.nextGate);
+  const data = {
+    taskId: s.taskId,
+    phase: s.phase,
+    state: s.state,
+    mode: s.mode,
+    nextGate: s.nextGate,
+    suggestion,
+    nextSkill,
+    degraded: s.degraded === true
+  };
+  if (opts.json === true) {
+    process.stdout.write(`${JSON.stringify({ ok: true, data })}
+`);
+    return;
+  }
+  const flag = data.degraded ? `  ${badge("warn", "degraded")}` : "";
+  log(`task next \u2014 ${s.taskId} \xB7 phase ${s.phase} (${s.state}, ${s.mode})${flag}`, opts);
+  if (s.nextGate) {
+    info(`next gate: ${s.nextGate}`, opts);
+  } else {
+    info("no further gate ahead (past verify, or stopped).", opts);
+  }
+  if (suggestion) info(`skill for current phase (${s.phase}): ${suggestion}`, opts);
+  if (nextSkill) info(`skill for next gate (${s.nextGate}): ${nextSkill}`, opts);
+  if (!suggestion && !nextSkill) {
+    info("run `noir skills list` to see applicable skills.", opts);
+  }
+}
+async function taskNew(opts) {
+  let mode;
+  if (opts.mode !== void 0) {
+    if (opts.mode !== "full" && opts.mode !== "quick") {
+      fail(EXIT.USAGE, `task new: invalid mode '${opts.mode}' (expected 'full' or 'quick')`, opts);
+    }
+    mode = opts.mode;
+  }
+  const res = await callDaemonTool(
+    opts,
+    "workflow_start",
+    {
+      taskId: opts.slug,
+      slug: opts.slug,
+      ...mode === void 0 ? {} : { mode }
+    }
+  );
+  if (res.ok !== true) {
+    const detail = typeof res.error === "string" && res.error.length > 0 ? res.error : "start failed";
+    fail(EXIT.ERROR, `task new --slug ${opts.slug}: ${detail}`, opts);
+  }
+  if (opts.json === true) {
+    process.stdout.write(`${JSON.stringify({ ok: true, data: res })}
+`);
+    return;
+  }
+  renderStatusRow(res, opts);
+}
+async function taskAdvance(opts) {
+  const args = {};
+  if (typeof opts.to === "string" && opts.to.length > 0) {
+    if (!Object.keys(PHASE_SKILL).includes(opts.to)) {
+      fail(EXIT.USAGE, `task advance: invalid phase '${opts.to}'`, opts);
+    }
+    args.to = opts.to;
+  }
+  if (typeof opts.force === "string" && opts.force.length > 0) {
+    args.force = { reason: opts.force };
+  }
+  const res = await callDaemonTool(
+    opts,
+    "workflow_advance",
+    args
+  );
+  if (res.ok !== true) {
+    const detail = typeof res.error === "string" && res.error.length > 0 ? res.error : "advance failed";
+    fail(EXIT.ERROR, `task advance: ${detail}`, opts);
+  }
+  if (typeof opts.to === "string" && opts.to === "verify") {
+    tip("run `noir handoff` for a ready-to-paste host prompt", opts);
+  }
+  if (opts.json === true) {
+    process.stdout.write(`${JSON.stringify({ ok: true, data: res })}
+`);
+    return;
+  }
+  renderStatusRow(res, opts);
+}
+
+// src/commands/handoff.ts
+var SEED_LIMIT = 5;
+function heading(name, id) {
+  return `# Noir handoff \u2014 ${name} (${id})`;
+}
+function renderMarkdown(p) {
+  const lines = [];
+  lines.push(heading(p.project.name, p.project.id));
+  lines.push("");
+  if (p.task) {
+    const gate = p.task.nextGate ?? "\u2014";
+    lines.push(`**Phase:** ${p.task.phase} \u2014 next gate: ${gate}`);
+  } else {
+    lines.push("**Phase:** no active task");
+  }
+  lines.push("");
+  lines.push("## Open host");
+  lines.push(p.directive);
+  lines.push("");
+  lines.push("## Next step");
+  if (p.task?.nextSkill) {
+    lines.push(`Run \`${p.task.nextSkill}\` \u2014 the host's next gate skill.`);
+  } else {
+    lines.push("No further gate ahead (past verify, or no active task).");
+  }
+  lines.push("");
+  lines.push("## Extracted context (seed)");
+  if (p.contextSeed && p.contextSeed.length > 0) {
+    for (const h of p.contextSeed) {
+      lines.push(`- \`${h.path}\` (score ${h.score.toFixed(4)})`);
+      const snip = h.snippet.trim();
+      if (snip.length > 0) lines.push(`  > ${snip.replace(/\n/g, "\n  > ")}`);
+    }
+  } else if (p.degraded.embedderMissing) {
+    lines.push(
+      "_Embedder unavailable \u2014 degraded to BM25-only or no hits. Start `noir daemon start` for live context._"
+    );
+  } else {
+    lines.push("_No context hits (or daemon down). Start `noir daemon start` for live context._");
+  }
+  lines.push("");
+  lines.push("## Extracted memory (seed)");
+  if (p.memorySeed && p.memorySeed.length > 0) {
+    for (const m of p.memorySeed) {
+      lines.push(`- \`${m.id}\` \u2014 ${m.summary}`);
+    }
+  } else {
+    lines.push(
+      "_No memory observations (or daemon down). Start `noir daemon start` for live memory._"
+    );
+  }
+  lines.push("");
+  lines.push("## Live data \u2014 call these from the host (already wired via the host MCP config)");
+  lines.push("- `noir.workflow_status` \xB7 `noir.context_search` \xB7 `noir.memory_recall`");
+  if (p.degraded.daemonDown) {
+    lines.push("");
+    lines.push("> **Note:** daemon not running \u2014 start `noir daemon start` for live task/memory.");
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function toContextHit(raw) {
+  const h = raw ?? {};
+  return {
+    path: typeof h.path === "string" ? h.path : "<unknown>",
+    score: typeof h.score === "number" ? h.score : 0,
+    snippet: typeof h.snippet === "string" ? h.snippet : ""
+  };
+}
+function observationSummary(raw) {
+  const obs = raw.observation;
+  if (obs && typeof obs === "object") {
+    const content = obs.content;
+    if (typeof content === "string" && content.length > 0) {
+      return content.length > 160 ? `${content.slice(0, 157)}\u2026` : content;
+    }
+    const type = obs.type;
+    if (typeof type === "string") return `(${type})`;
+  }
+  return "";
+}
+function toMemoryHit(raw) {
+  const h = raw ?? {};
+  return {
+    id: typeof h.id === "string" ? h.id : "<unknown>",
+    summary: observationSummary(h)
+  };
+}
+function toHostPayload(p) {
+  return {
+    project: p.project,
+    host: p.host,
+    task: p.task
+  };
+}
+function resolveDirective(root, p) {
+  const ctx = { root };
+  const adapter = resolveAdapter(p.host);
+  const hostPayload = toHostPayload(p);
+  if (typeof adapter.emitHandoff === "function") {
+    return adapter.emitHandoff(ctx, hostPayload);
+  }
+  return defaultHandoffBlock(ctx, hostPayload);
+}
+function handoffFilePath(root, taskId, projectId) {
+  const id = typeof taskId === "string" && taskId.length > 0 ? taskId : projectId;
+  return join(root, NOIR_DIR, "handoff", `${id}.md`);
+}
+async function extractSeeds(opts, probe, query) {
+  if (!probe.running) return { context: null, memory: null };
+  let context = null;
+  let memory = null;
+  await withRunningDaemon(
+    opts,
+    async (caller) => {
+      const ctxRes = await tryTool(caller, "context_search", {
+        query,
+        limit: SEED_LIMIT
+      });
+      if (ctxRes && ctxRes.ok !== false && Array.isArray(ctxRes.results)) {
+        context = ctxRes.results.slice(0, SEED_LIMIT).map(toContextHit).filter((h) => h.path !== "<unknown>" || h.snippet.length > 0);
+      }
+      const memRes = await tryTool(caller, "memory_recall", {
+        query,
+        limit: SEED_LIMIT
+      });
+      if (memRes && memRes.ok !== false && Array.isArray(memRes.results)) {
+        memory = memRes.results.slice(0, SEED_LIMIT).map(toMemoryHit).filter((h) => h.summary.length > 0);
+      }
+    },
+    probe
+  );
+  return { context, memory };
+}
+async function probeOnly(opts) {
+  return probeDaemon(opts);
+}
+async function handoff(opts) {
+  const project = loadProjectInfo4(process.cwd());
+  const host = project.config.host;
+  const snapshot = await gatherStatusPayload(opts);
+  const probe = await probeOnly(opts);
+  const task = snapshot.workflow ? {
+    taskId: snapshot.workflow.taskId,
+    phase: snapshot.workflow.phase,
+    nextGate: snapshot.workflow.nextGate,
+    nextSkill: skillFor(snapshot.workflow.nextGate) ?? skillFor(snapshot.workflow.phase)
+  } : null;
+  const query = task?.taskId ?? project.name;
+  const { context, memory } = await extractSeeds(opts, probe, query);
+  const full = {
+    project: { id: project.id, name: project.name },
+    host,
+    directive: "",
+    // filled after the host payload is assembled (below)
+    task,
+    contextSeed: context,
+    memorySeed: memory,
+    degraded: {
+      daemonDown: !probe.running,
+      embedderMissing: context === null && probe.running
+    }
+  };
+  full.directive = resolveDirective(project.root, full);
+  if (opts.json === true) {
+    process.stdout.write(`${JSON.stringify({ ok: true, data: full })}
+`);
+    return;
+  }
+  const md = renderMarkdown(full);
+  if (opts.write === true) {
+    const path = handoffFilePath(project.root, task?.taskId, project.id);
+    mkdirSync(join(project.root, NOIR_DIR, "handoff"), { recursive: true });
+    writeFileSync(path, md, "utf8");
+    info(`handoff written to ${path}`, opts);
+    return;
+  }
+  process.stdout.write(md);
+}
+
+// src/commands/home.ts
+import { hostLaunchDirective as hostLaunchDirective2 } from "@noir-ai/adapters";
+import { loadProjectInfo as loadProjectInfo5 } from "@noir-ai/core";
+
+// src/banner.ts
+import gradient from "gradient-string";
+var NOIR_BLOCK = [
+  "\u2588\u2588\u2588\u2557   \u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 ",
+  "\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557 \u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557",
+  "\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551 \u2588\u2588\u2551   \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D",
+  "\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551 \u2588\u2588\u2551   \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551",
+  "\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551 \u2588\u2588\u2551  \u2588\u2588\u2551",
+  "\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D"
+];
+var NOIR_GRADIENT = gradient("#2c5282", "#3b82f6", "#7dd3fc");
+var NOIR_TAGLINE = "discipline, context, and memory layer for agentic CLIs";
+function renderBanner(opts = {}) {
+  const width = opts.width ?? process.stdout.columns ?? 80;
+  const colorOn = opts.color !== false && useColor();
+  if (width < 50) {
+    return colorOn ? `${c.accent("\u25C6")} noir` : "\u25C6 noir";
+  }
+  const block = NOIR_BLOCK.join("\n");
+  if (!colorOn) return block;
+  if (accessibleMode()) {
+    return block.split("\n").map((line) => c.accent(line)).join("\n");
+  }
+  return NOIR_GRADIENT.multiline(block);
+}
+function shouldShowBanner(opts) {
+  if (opts.quiet === true || opts.json === true) return false;
+  const v = process.env.NOIR_NO_BANNER;
+  if (v !== void 0 && v !== "") return false;
+  return true;
+}
+
+// src/commands/home.ts
+function tryProject() {
+  try {
+    const info2 = loadProjectInfo5(process.cwd());
+    return { id: info2.id, name: info2.name, host: info2.config.host };
+  } catch {
+    return null;
+  }
+}
+var COMMANDS_HINT = "Commands: init \xB7 create \xB7 sync \xB7 status \xB7 context \xB7 memory \xB7 skills \xB7 task \xB7 daemon \xB7 doctor";
+async function home(opts, deps) {
+  if (isInteractive(opts) && opts.tui !== false) {
+    await runMenu(opts, deps);
+    return;
+  }
+  if (opts.json === true) {
+    await deps.dispatch(["status", "--json"]);
+    return;
+  }
+  await deps.dispatch(["status"]);
+}
+async function runMenu(opts, deps) {
+  const clack = await import("@clack/prompts");
+  const project = tryProject();
+  if (shouldShowBanner(opts)) {
+    const host = project?.host ?? "claude";
+    process.stderr.write(
+      `
+${renderBanner()}
+${NOIR_TAGLINE}
+
+${hostLaunchDirective2(host)}
+${COMMANDS_HINT}
+
+`
+    );
+  }
+  clack.intro(project ? `noir \u2014 ${project.name}` : "noir");
+  const choice = await clack.select({
+    message: "What would you like to do?",
+    initialValue: "status",
+    options: [
+      { value: "status", label: "Status", hint: "project + daemon + store snapshot" },
+      { value: "index", label: "Index project", hint: "(re)index files into context" },
+      { value: "recall", label: "Recall memory", hint: "search cross-session memory" },
+      { value: "next", label: "Next task", hint: "suggest next phase + skill" },
+      { value: "handoff", label: "Handoff", hint: "ready-to-paste host prompt" },
+      { value: "daemon", label: "Start daemon", hint: "foreground daemon" },
+      { value: "sync", label: "Sync skills", hint: "re-emit builtin skills" },
+      { value: "exit", label: "Exit" }
+    ]
+  });
+  if (clack.isCancel(choice)) {
+    clack.cancel("Cancelled.");
+    fail(EXIT.CANCELLED, "cancelled", opts);
+  }
+  const argv = await argvForChoice(choice, clack, opts);
+  if (argv === null) {
+    clack.outro("bye");
+    return;
+  }
+  await deps.dispatch(argv);
+  clack.outro("done");
+}
+async function argvForChoice(choice, clack, opts) {
+  switch (choice) {
+    case "status":
+      return ["status"];
+    case "index":
+      return ["context", "index"];
+    case "next":
+      return ["task", "next"];
+    case "handoff":
+      return ["handoff"];
+    case "daemon":
+      return ["daemon", "start"];
+    case "sync":
+      return ["sync"];
+    case "exit":
+      return null;
+    case "recall": {
+      const query = await clack.text({
+        message: "Recall query:",
+        placeholder: "e.g. auth flow, ContextEngine, deploy steps"
+      });
+      if (clack.isCancel(query)) {
+        clack.cancel("Cancelled.");
+        fail(EXIT.CANCELLED, "cancelled", opts);
+      }
+      return ["memory", "recall", String(query)];
+    }
+    default:
+      return null;
+  }
+}
+
+// src/commands/memory.ts
+function parseLimit2(raw, label, opts) {
+  if (raw === void 0) return void 0;
+  const n = Number(raw);
+  if (!Number.isInteger(n) || n <= 0) {
+    fail(EXIT.USAGE, `${label}: --limit must be a positive integer (got '${raw}')`, opts);
+  }
+  return n;
+}
+function splitCsv(raw) {
+  if (raw === void 0) return void 0;
+  const out = raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  return out.length > 0 ? out : void 0;
+}
+function toHit2(raw) {
+  const h = raw ?? {};
+  const arr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
+  return {
+    id: typeof h.id === "string" ? h.id : "",
+    type: typeof h.type === "string" ? h.type : "",
+    score: typeof h.score === "number" ? h.score : 0,
+    content: typeof h.content === "string" ? h.content : "",
+    concepts: arr(h.concepts),
+    files: arr(h.files),
+    ts: typeof h.ts === "number" ? h.ts : 0,
+    importance: typeof h.importance === "number" ? h.importance : 0,
+    source: typeof h.source === "string" ? h.source : ""
+  };
+}
+function failTool2(label, envelope, opts) {
+  const detail = envelope.error ?? envelope.reason ?? "unknown failure";
+  fail(EXIT.ERROR, `${label}: ${detail}`, opts);
+}
+function stamp(ts) {
+  if (typeof ts !== "number" || ts <= 0) return "-";
+  return new Date(ts).toISOString().replace("T", " ").replace(/\..*$/, "Z");
+}
+async function memoryRecall(opts) {
+  const limit = parseLimit2(opts.limit, "memory recall", opts);
+  const res = await callDaemonTool(opts, "memory_recall", {
+    query: opts.query,
+    ...limit === void 0 ? {} : { limit }
+  });
+  if (res.ok !== true) failTool2("memory recall", res, opts);
+  const hits = Array.isArray(res.results) ? res.results.map(toHit2) : [];
+  const data = { query: opts.query, hits, degraded: res.degraded === true };
+  if (opts.json === true) {
+    process.stdout.write(`${JSON.stringify({ ok: true, data })}
+`);
+    return;
+  }
+  renderRecall(data.query, hits, data.degraded, opts);
 }
 function renderRecall(query, hits, degraded, opts) {
-  const flag = degraded ? " [degraded: BM25-only]" : "";
+  const flag = degraded ? `  ${badge("warn", "degraded: BM25-only")}` : "";
   log(
     `memory recall \u2014 ${hits.length} hit${hits.length === 1 ? "" : "s"} for '${query}'${flag}`,
     opts
@@ -707,9 +1198,9 @@ async function resolveContent(opts) {
 function renderObservation(obs, opts) {
   const rows = [];
   for (const key of ["id", "type", "importance", "ts", "source", "project", "sessionId"]) {
-    if (obs[key] !== void 0) rows.push({ Field: key, Value: obs[key] });
+    if (obs[key] !== void 0) rows.push({ label: key, value: obs[key] });
   }
-  if (rows.length > 0) table(rows, ["Field", "Value"], opts);
+  if (rows.length > 0) definitionList(rows, opts);
   const content = obs.content;
   if (typeof content === "string") log(`
 ${content}`, opts);
@@ -806,7 +1297,7 @@ async function memoryConsolidate(opts) {
 
 // src/commands/skills.ts
 import { claudeAdapter } from "@noir-ai/adapters";
-import { loadProjectInfo as loadProjectInfo4 } from "@noir-ai/core";
+import { loadProjectInfo as loadProjectInfo6 } from "@noir-ai/core";
 import {
   discoverAll,
   emitSkillsToDir
@@ -835,400 +1326,111 @@ var CATEGORY = {
   "noir-worktree": "git",
   "noir-recall": "memory",
   "noir-remember": "memory",
-  "noir-checkpoint": "memory",
-  "noir-context": "context",
-  "noir-frontend": "domain",
-  "noir-backend": "domain",
-  "noir-doctor": "meta",
-  "noir-skill-author": "meta",
-  "noir-sync": "meta",
-  "noir-wrap": "meta"
-};
-function categoryOf(name) {
-  const mapped = CATEGORY[name];
-  if (mapped !== void 0) return mapped;
-  return name.replace(/^noir-/, "") || "general";
-}
-function toRow(s, kind = "builtin") {
-  const description = typeof s.frontmatter.description === "string" ? s.frontmatter.description : "";
-  return { name: s.name, category: categoryOf(s.name), description, kind };
-}
-function truncate(text, max) {
-  if (text.length <= max) return text;
-  const slice = text.slice(0, Math.max(0, max - 1));
-  const boundary = slice.lastIndexOf(" ");
-  const head = boundary > 0 ? slice.slice(0, boundary) : slice;
-  return `${head.trimEnd()}\u2026`;
-}
-async function skillsList(opts) {
-  let builtins;
-  let integrations;
-  try {
-    const all = discoverAll();
-    builtins = all.builtins;
-    integrations = all.integrations;
-  } catch (err) {
-    fail(
-      EXIT.ERROR,
-      `skills list: could not discover skills (${err instanceof Error ? err.message : String(err)})`,
-      opts
-    );
-  }
-  const rows = [
-    ...builtins.map((b) => toRow(b, "builtin")),
-    ...integrations.map((i) => toRow(i, "integration"))
-  ];
-  const data = { count: rows.length, skills: rows };
-  if (opts.json === true) {
-    process.stdout.write(`${JSON.stringify({ ok: true, data })}
-`);
-    return;
-  }
-  const intCount = integrations.length;
-  const banner = intCount > 0 ? `noir skills \u2014 ${rows.length} skill${rows.length === 1 ? "" : "s"} (${builtins.length} builtin, ${intCount} integration${intCount === 1 ? "" : "s"})` : `noir skills \u2014 ${rows.length} builtin skill${rows.length === 1 ? "" : "s"}`;
-  log(banner, opts);
-  table(
-    rows.map((r) => ({
-      Skill: r.name,
-      Kind: r.kind,
-      Category: r.category,
-      Description: truncate(r.description, 80)
-    })),
-    ["Skill", "Kind", "Category", "Description"],
-    opts
-  );
-}
-async function skillsSync(opts) {
-  const root = process.cwd();
-  const project = loadProjectInfo4(root);
-  if (!claudeAdapter.skillsDir) {
-    const data2 = {
-      emitted: [],
-      references: 0,
-      host: project.config.host,
-      reason: "no-skill-emitter"
-    };
-    if (opts.json === true) {
-      process.stdout.write(`${JSON.stringify({ ok: true, data: data2 })}
-`);
-      return;
-    }
-    info("This host has no skill emitter; nothing to sync.", opts);
-    return;
-  }
-  const dir = claudeAdapter.skillsDir({ root });
-  const summary = await emitSkillsToDir(dir);
-  const pruned = summary.pruned ?? [];
-  const data = {
-    emitted: summary.emitted,
-    references: summary.references,
-    dir,
-    pruned
-  };
-  if (opts.json === true) {
-    process.stdout.write(`${JSON.stringify({ ok: true, data })}
-`);
-    return;
-  }
-  log(
-    `Synced ${summary.emitted.length} Noir skill${summary.emitted.length === 1 ? "" : "s"} to ${dir}.`,
-    opts
-  );
-  if (pruned.length > 0) {
-    warn(
-      `Pruned ${pruned.length} stale noir-* skill dir${pruned.length === 1 ? "" : "s"}: ${pruned.join(", ")}`,
-      opts
-    );
-  }
-}
-
-// src/commands/status.ts
-import { loadProjectInfo as loadProjectInfo5, NOIR_VERSION as NOIR_VERSION2 } from "@noir-ai/core";
-async function tryTool(caller, name) {
-  try {
-    return await caller.callTool(name);
-  } catch {
-    return null;
-  }
-}
-function pickStore(s) {
-  if (s?.ok !== true) return null;
-  return {
-    docCount: s.docCount,
-    vecCount: s.vecCount,
-    dbPath: s.dbPath,
-    degraded: s.degraded === true
-  };
-}
-function describeEmbedder2(e) {
-  if (!e || e.kind === "none") return "none (BM25-only)";
-  const model = typeof e.model === "string" && e.model.length > 0 ? e.model : "<unset>";
-  return `${e.kind} \xB7 ${model} (${e.dim}-dim)`;
-}
-function pickContext(c) {
-  if (c?.ok !== true) return null;
-  return {
-    docCount: c.docCount,
-    vecCount: c.vecCount,
-    indexedFiles: c.indexedFiles,
-    embedder: describeEmbedder2(c.embedder),
-    degraded: c.degraded === true
-  };
-}
-function pickWorkflow(w) {
-  if (w?.ok !== true) return null;
-  return {
-    taskId: w.taskId,
-    phase: w.phase,
-    state: w.state,
-    mode: w.mode,
-    nextGate: w.nextGate,
-    degraded: w.degraded === true
-  };
-}
-function pickMemory(m) {
-  if (m?.ok !== true || !Array.isArray(m.sessions)) return null;
-  let observations = 0;
-  for (const s of m.sessions) observations += s.count;
-  return { sessions: m.sessions.length, observations };
-}
-function buildPayload(project, probe, host, store, context, workflow, memory) {
-  return {
-    noir: NOIR_VERSION2,
-    project: { id: project.id, name: project.name },
-    host: project.config.host,
-    daemon: {
-      running: probe.running,
-      ...probe.pid !== void 0 ? { pid: probe.pid } : {},
-      ...probe.uptimeSec !== void 0 ? { uptimeSec: probe.uptimeSec } : {},
-      ...host && typeof host.transport === "string" ? { transport: host.transport } : {}
-    },
-    store: pickStore(store),
-    context: pickContext(context),
-    workflow: pickWorkflow(workflow),
-    memory: pickMemory(memory)
-  };
-}
-function formatDuration(sec) {
-  if (typeof sec !== "number" || sec < 0) return "unknown";
-  if (sec < 60) return `${sec}s`;
-  if (sec < 3600) return `${Math.floor(sec / 60)}m ${sec % 60}s`;
-  return `${Math.floor(sec / 3600)}h ${Math.floor(sec % 3600 / 60)}m`;
-}
-function describeDaemon(d) {
-  if (!d.running) return "not running (start with `noir daemon start`)";
-  const pid = typeof d.pid === "number" ? `pid ${d.pid}` : "pid unknown";
-  const up = typeof d.uptimeSec === "number" ? `, up ${formatDuration(d.uptimeSec)}` : "";
-  const transport = typeof d.transport === "string" ? `, ${d.transport}` : "";
-  return `running (${pid}${up}${transport})`;
-}
-function describeStore(s) {
-  if (!s) return "unavailable (store engine not wired)";
-  const flag = s.degraded ? " [degraded: read-only]" : "";
-  return `${s.docCount} docs / ${s.vecCount} vecs${flag}`;
-}
-function describeContext(c) {
-  if (!c) return "unavailable (context engine not wired)";
-  const flag = c.degraded ? " [degraded]" : "";
-  return `${c.docCount} docs, ${c.vecCount} vecs, ${c.indexedFiles} files \xB7 embedder ${c.embedder}${flag}`;
-}
-function describeWorkflow(w) {
-  if (!w) return "no active task";
-  const gate = w.nextGate ? ` \u2192 next gate: ${w.nextGate}` : "";
-  const flag = w.degraded ? " [degraded]" : "";
-  return `${w.phase} (${w.state}, ${w.mode}) \xB7 task ${w.taskId}${gate}${flag}`;
+  "noir-checkpoint": "memory",
+  "noir-context": "context",
+  "noir-frontend": "domain",
+  "noir-backend": "domain",
+  "noir-doctor": "meta",
+  "noir-skill-author": "meta",
+  "noir-sync": "meta",
+  "noir-wrap": "meta"
+};
+function categoryOf(name) {
+  const mapped = CATEGORY[name];
+  if (mapped !== void 0) return mapped;
+  return name.replace(/^noir-/, "") || "general";
 }
-function describeMemory(m) {
-  if (!m) return "unavailable (memory engine not wired)";
-  return `${m.observations} observations across ${m.sessions} session${m.sessions === 1 ? "" : "s"}`;
+function toRow(s, kind = "builtin") {
+  const description = typeof s.frontmatter.description === "string" ? s.frontmatter.description : "";
+  return { name: s.name, category: categoryOf(s.name), description, kind };
 }
-function renderHuman(p, opts) {
-  log(`noir status \u2014 ${p.project.name} (${p.project.id})`, opts);
-  table(
-    [
-      { Field: "Project", Value: `${p.project.name} (${p.project.id})` },
-      { Field: "Host", Value: p.host },
-      { Field: "Noir", Value: p.noir },
-      { Field: "Daemon", Value: describeDaemon(p.daemon) },
-      { Field: "Store", Value: describeStore(p.store) },
-      { Field: "Context", Value: describeContext(p.context) },
-      { Field: "Workflow", Value: describeWorkflow(p.workflow) },
-      { Field: "Memory", Value: describeMemory(p.memory) }
-    ],
-    ["Field", "Value"],
-    opts
-  );
+function truncate(text, max) {
+  if (text.length <= max) return text;
+  const slice = text.slice(0, Math.max(0, max - 1));
+  const boundary = slice.lastIndexOf(" ");
+  const head = boundary > 0 ? slice.slice(0, boundary) : slice;
+  return `${head.trimEnd()}\u2026`;
 }
-async function status(opts) {
-  const project = loadProjectInfo5(process.cwd());
-  const probe = await probeDaemon(opts);
-  let host = null;
-  let store = null;
-  let context = null;
-  let workflow = null;
-  let memory = null;
-  if (probe.running) {
-    await withRunningDaemon(
-      opts,
-      async (caller) => {
-        host = await tryTool(caller, "host_status");
-        store = await tryTool(caller, "store_status");
-        context = await tryTool(caller, "context_status");
-        workflow = await tryTool(caller, "workflow_status");
-        memory = await tryTool(caller, "memory_sessions");
-      },
-      probe
+async function skillsList(opts) {
+  let builtins;
+  let integrations;
+  try {
+    const all = discoverAll();
+    builtins = all.builtins;
+    integrations = all.integrations;
+  } catch (err) {
+    fail(
+      EXIT.ERROR,
+      `skills list: could not discover skills (${err instanceof Error ? err.message : String(err)})`,
+      opts
     );
   }
-  const payload = buildPayload(project, probe, host, store, context, workflow, memory);
+  const rows = [
+    ...builtins.map((b) => toRow(b, "builtin")),
+    ...integrations.map((i) => toRow(i, "integration"))
+  ];
+  const data = { count: rows.length, skills: rows };
   if (opts.json === true) {
-    process.stdout.write(`${JSON.stringify({ ok: true, data: payload })}
+    process.stdout.write(`${JSON.stringify({ ok: true, data })}
 `);
     return;
   }
-  renderHuman(payload, opts);
-}
-
-// src/commands/task.ts
-var PHASE_SKILL = {
-  intake: "noir-intake",
-  clarify: "noir-clarify",
-  spec: "noir-spec",
-  plan: "noir-plan",
-  execute: "noir-execute",
-  verify: "noir-verify",
-  document: "noir-document"
-};
-function skillFor(phase) {
-  if (typeof phase !== "string") return null;
-  return PHASE_SKILL[phase] ?? null;
-}
-async function fetchStatus(opts, taskId) {
-  const args = typeof taskId === "string" && taskId.length > 0 ? { taskId } : {};
-  const res = await callDaemonTool(
-    opts,
-    "workflow_status",
-    args
-  );
-  if (res.ok === true) return res;
-  const detail = res.error ?? "task not found";
-  fail(EXIT.NOT_FOUND, `task: ${detail}`, opts);
-}
-function formatStamp(ms) {
-  if (typeof ms !== "number" || ms <= 0) return "-";
-  return new Date(ms).toISOString().replace("T", " ").replace(/\..*$/, "Z");
-}
-function renderStatusRow(s, opts) {
-  const flag = s.degraded === true ? " [degraded]" : "";
-  log(`task status \u2014 ${s.taskId}${flag}`, opts);
+  const intCount = integrations.length;
+  const banner = intCount > 0 ? `noir skills \u2014 ${rows.length} skill${rows.length === 1 ? "" : "s"} (${builtins.length} builtin, ${intCount} integration${intCount === 1 ? "" : "s"})` : `noir skills \u2014 ${rows.length} builtin skill${rows.length === 1 ? "" : "s"}`;
+  log(banner, opts);
   table(
-    [
-      { Field: "Task", Value: s.taskId },
-      { Field: "Phase", Value: s.phase },
-      { Field: "State", Value: s.state },
-      { Field: "Mode", Value: s.mode },
-      { Field: "Next gate", Value: s.nextGate ?? "\u2014" },
-      { Field: "Updated", Value: formatStamp(s.updatedAt) }
-    ],
-    ["Field", "Value"],
+    rows.map((r) => ({
+      Skill: r.name,
+      Kind: r.kind,
+      Category: r.category,
+      Description: truncate(r.description, 80)
+    })),
+    ["Skill", "Kind", "Category", "Description"],
     opts
   );
 }
-async function taskStatus(opts) {
-  const s = await fetchStatus(opts, opts.id);
-  if (opts.json === true) {
-    process.stdout.write(`${JSON.stringify({ ok: true, data: s })}
+async function skillsSync(opts) {
+  const root = process.cwd();
+  const project = loadProjectInfo6(root);
+  if (!claudeAdapter.skillsDir) {
+    const data2 = {
+      emitted: [],
+      references: 0,
+      host: project.config.host,
+      reason: "no-skill-emitter"
+    };
+    if (opts.json === true) {
+      process.stdout.write(`${JSON.stringify({ ok: true, data: data2 })}
 `);
+      return;
+    }
+    info("This host has no skill emitter; nothing to sync.", opts);
     return;
   }
-  renderStatusRow(s, opts);
-}
-async function taskNext(opts) {
-  const s = await fetchStatus(opts);
-  const suggestion = skillFor(s.phase);
-  const nextSkill = skillFor(s.nextGate);
+  const dir = claudeAdapter.skillsDir({ root });
+  const summary = await emitSkillsToDir(dir);
+  const pruned = summary.pruned ?? [];
   const data = {
-    taskId: s.taskId,
-    phase: s.phase,
-    state: s.state,
-    mode: s.mode,
-    nextGate: s.nextGate,
-    suggestion,
-    nextSkill,
-    degraded: s.degraded === true
+    emitted: summary.emitted,
+    references: summary.references,
+    dir,
+    pruned
   };
   if (opts.json === true) {
     process.stdout.write(`${JSON.stringify({ ok: true, data })}
 `);
     return;
   }
-  const flag = data.degraded ? " [degraded]" : "";
-  log(`task next \u2014 ${s.taskId} \xB7 phase ${s.phase} (${s.state}, ${s.mode})${flag}`, opts);
-  if (s.nextGate) {
-    info(`next gate: ${s.nextGate}`, opts);
-  } else {
-    info("no further gate ahead (past verify, or stopped).", opts);
-  }
-  if (suggestion) info(`skill for current phase (${s.phase}): ${suggestion}`, opts);
-  if (nextSkill) info(`skill for next gate (${s.nextGate}): ${nextSkill}`, opts);
-  if (!suggestion && !nextSkill) {
-    info("run `noir skills list` to see applicable skills.", opts);
-  }
-}
-async function taskNew(opts) {
-  let mode;
-  if (opts.mode !== void 0) {
-    if (opts.mode !== "full" && opts.mode !== "quick") {
-      fail(EXIT.USAGE, `task new: invalid mode '${opts.mode}' (expected 'full' or 'quick')`, opts);
-    }
-    mode = opts.mode;
-  }
-  const res = await callDaemonTool(
-    opts,
-    "workflow_start",
-    {
-      taskId: opts.slug,
-      slug: opts.slug,
-      ...mode === void 0 ? {} : { mode }
-    }
-  );
-  if (res.ok !== true) {
-    const detail = typeof res.error === "string" && res.error.length > 0 ? res.error : "start failed";
-    fail(EXIT.ERROR, `task new --slug ${opts.slug}: ${detail}`, opts);
-  }
-  if (opts.json === true) {
-    process.stdout.write(`${JSON.stringify({ ok: true, data: res })}
-`);
-    return;
-  }
-  renderStatusRow(res, opts);
-}
-async function taskAdvance(opts) {
-  const args = {};
-  if (typeof opts.to === "string" && opts.to.length > 0) {
-    if (!Object.keys(PHASE_SKILL).includes(opts.to)) {
-      fail(EXIT.USAGE, `task advance: invalid phase '${opts.to}'`, opts);
-    }
-    args.to = opts.to;
-  }
-  if (typeof opts.force === "string" && opts.force.length > 0) {
-    args.force = { reason: opts.force };
-  }
-  const res = await callDaemonTool(
-    opts,
-    "workflow_advance",
-    args
+  log(
+    `Synced ${summary.emitted.length} Noir skill${summary.emitted.length === 1 ? "" : "s"} to ${dir}.`,
+    opts
   );
-  if (res.ok !== true) {
-    const detail = typeof res.error === "string" && res.error.length > 0 ? res.error : "advance failed";
-    fail(EXIT.ERROR, `task advance: ${detail}`, opts);
-  }
-  if (opts.json === true) {
-    process.stdout.write(`${JSON.stringify({ ok: true, data: res })}
-`);
-    return;
+  if (pruned.length > 0) {
+    warn(
+      `Pruned ${pruned.length} stale noir-* skill dir${pruned.length === 1 ? "" : "s"}: ${pruned.join(", ")}`,
+      opts
+    );
   }
-  renderStatusRow(res, opts);
 }
 
 // src/bin.ts
@@ -1251,7 +1453,15 @@ function toCliOptions(g) {
     json: g.json === true,
     quiet: g.quiet === true,
     verbose: g.verbose === true,
-    input: g.input !== false
+    input: g.input !== false,
+    // TUI policy — additive only. `--tui`/`--no-tui` land on `tui`
+    // (true/false; absent when neither flag is given). Spread conditionally so
+    // the default-args case (no flag) does NOT add a `tui` key — keeps the
+    // exact-shape assertions in bin.test.ts green.
+    ...g.tui === true || g.tui === false ? { tui: g.tui === true } : {},
+    // `--no-tips` is stored under `tips` (default true; flag ⇒ false). Map to
+    // the additive `noTips` spelling used by CliOptions + `tip()`.
+    ...g.tips === false ? { noTips: true } : {}
   };
 }
 function toStatusOptions(g) {
@@ -1266,9 +1476,38 @@ function parseHost(raw) {
   if (raw === void 0) return void 0;
   return raw;
 }
+var DEPRECATIONS = [];
+function commandPath(cmd) {
+  const path = [];
+  let c2 = cmd;
+  while (c2 !== null) {
+    path.unshift(c2.name());
+    c2 = c2.parent;
+  }
+  return path;
+}
+function emitDeprecationHintsFor(cmd, opts) {
+  if (DEPRECATIONS.length === 0) return;
+  const rel = commandPath(cmd).slice(1);
+  for (const d of DEPRECATIONS) {
+    if (d.oldArgv.every((a, i) => rel[i] === a)) {
+      tip(
+        `\`noir ${d.oldArgv.join(" ")}\` is deprecated since v${d.since}; use \`noir ${d.newArgv.join(" ")}\`.`,
+        opts
+      );
+    }
+  }
+}
 function createProgram() {
   const program2 = new Command();
-  program2.name("noir").description("Noir \u2014 discipline, context, and memory layer for agentic CLIs.").version(NOIR_VERSION3, "-v, --version").addOption(new Option("--json", "emit machine-readable JSON to stdout")).addOption(new Option("--no-input", "never prompt; error if input is required")).addOption(new Option("--quiet", "suppress non-essential diagnostics")).addOption(new Option("--verbose", "show additional diagnostic detail")).addOption(new Option("--cwd <path>", "run as if started in <path>")).exitOverride((err) => {
+  program2.name("noir").description("Noir \u2014 discipline, context, and memory layer for agentic CLIs.").version(NOIR_VERSION3, "-v, --version").addOption(new Option("--json", "emit machine-readable JSON to stdout")).addOption(new Option("--no-input", "never prompt; error if input is required")).addOption(new Option("--quiet", "suppress non-essential diagnostics")).addOption(new Option("--verbose", "show additional diagnostic detail")).addOption(new Option("--cwd <path>", "run as if started in <path>")).addOption(
+    new Option("--tui", "prefer the interactive home menu for bare `noir` (advisory; TTY-only)")
+  ).addOption(
+    new Option(
+      "--no-tui",
+      "route bare `noir` to the non-interactive `status` path even in a TTY"
+    )
+  ).addOption(new Option("--no-tips", "suppress redirect / deprecation hints on stderr")).exitOverride((err) => {
     throw err;
   }).configureOutput({
     // Stream discipline: --help/--version → stdout (conventional; users pipe
@@ -1294,6 +1533,7 @@ function createProgram() {
     const nonInteractive = opts.json === true || opts.input === false;
     if (nonInteractive) process.env.NOIR_NON_INTERACTIVE = "1";
     else delete process.env.NOIR_NON_INTERACTIVE;
+    emitDeprecationHintsFor(actionCmd, toCliOptions(opts));
   });
   program2.command("init").description("scaffold Noir in the current project (.noir/, .mcp.json, CLAUDE.md, skills)").option("--transport <transport>", "stdio | streamable-http (default: stdio)", "stdio").option("--url <url>", "streamable-http daemon URL (localhost only)").option(
     "--upgrade",
@@ -1306,39 +1546,45 @@ function createProgram() {
     new Option(
       "--host <id>",
       "target agentic CLI (default: claude) \u2014 drives host-side emission"
-    ).choices(SUPPORTED_HOSTS2)
+    ).choices(SUPPORTED_HOSTS)
   ).action(
-    async (opts) => {
+    async (opts, cmd) => {
       const transport = opts.transport === "streamable-http" ? "streamable-http" : "stdio";
       const upgrade = opts.upgrade === true;
       const force = opts.force === true;
       const host = parseHost(opts.host);
-      await init(process.cwd(), {
+      const result = await init(process.cwd(), {
         transport,
         url: opts.url,
         ...upgrade ? { upgrade } : {},
         ...force ? { force } : {},
         ...host !== void 0 ? { host } : {}
       });
+      if (cmd.optsWithGlobals().json === true && result !== void 0) {
+        json({ ok: true, data: result });
+      }
     }
   );
   program2.command("create [dir]").description("bootstrap the Noir AI layer in a new or empty directory").option("--transport <transport>", "stdio | streamable-http (default: stdio)", "stdio").option("--url <url>", "streamable-http daemon URL (localhost only)").option("--force", "re-scaffold even if already initialized (bypasses the already-init no-op)").addOption(
     new Option(
       "--host <id>",
       "target agentic CLI (default: claude) \u2014 drives host-side emission"
-    ).choices(SUPPORTED_HOSTS2)
+    ).choices(SUPPORTED_HOSTS)
   ).action(
-    async (dir, opts) => {
+    async (dir, opts, cmd) => {
       const transport = opts.transport === "streamable-http" ? "streamable-http" : "stdio";
       const force = opts.force === true;
       const host = parseHost(opts.host);
-      const { create } = await import("./create-VK7JX6IB.js");
-      await create(dir, {
+      const { create } = await import("./create-7ERBL42K.js");
+      const result = await create(dir, {
         transport,
         url: opts.url,
         ...force ? { force } : {},
         ...host !== void 0 ? { host } : {}
       });
+      if (cmd.optsWithGlobals().json === true && result !== void 0) {
+        json({ ok: true, data: result });
+      }
     }
   );
   program2.command("sync").description(
@@ -1348,7 +1594,15 @@ function createProgram() {
     "overwrite differing regenerated files without prompting (bypasses the conflict menu)"
   ).option(
     "--merge",
-    "three-way merge managed regions (preserve hand-edits inside <!-- noir:* --> markers)"
+    "three-way merge managed regions (default since 1.3.0; flag kept for compatibility)"
+  ).addOption(
+    // Opt OUT of managed-region merge (restore strip-replace). Commander
+    // stores `--no-merge-regions` under `mergeRegions` (default true; flag →
+    // false). Bare `noir sync` keeps the merge default (true).
+    new Option(
+      "--no-merge-regions",
+      "strip-replace managed regions (discard hand-edits inside <!-- noir:* --> markers)"
+    )
   ).addOption(
     // S10: optional `--host` override. When omitted, sync reads host from
     // `.noir/config.yml` (whatever `noir init --host <id>` persisted). The
@@ -1356,22 +1610,25 @@ function createProgram() {
     new Option(
       "--host <id>",
       "override the configured host (advanced; default reads .noir/config.yml)"
-    ).choices(SUPPORTED_HOSTS2)
-  ).action(async (opts) => {
-    const { sync } = await import("./sync-7XFGCRJN.js");
-    const host = parseHost(opts.host);
-    const force = opts.force === true;
-    const merge = opts.merge === true;
-    if (host === void 0 && !force && !merge) {
-      await sync(process.cwd());
-    } else {
-      await sync(process.cwd(), {
+    ).choices(SUPPORTED_HOSTS)
+  ).action(
+    async (opts, cmd) => {
+      const { sync } = await import("./sync-SCAF6Z5H.js");
+      const host = parseHost(opts.host);
+      const force = opts.force === true;
+      const merge = opts.merge === true;
+      const noMergeRegions = opts.mergeRegions === false;
+      const result = host === void 0 && !force && !merge && !noMergeRegions ? await sync(process.cwd()) : await sync(process.cwd(), {
         ...host !== void 0 ? { host } : {},
         ...force ? { force } : {},
-        ...merge ? { merge } : {}
+        ...merge ? { merge } : {},
+        ...noMergeRegions ? { mergeManagedRegions: false } : {}
       });
+      if (cmd.optsWithGlobals().json === true) {
+        json({ ok: true, data: result });
+      }
     }
-  });
+  );
   const mcpCmd = program2.command("mcp").description("MCP server control");
   mcpCmd.command("serve").description("run the Noir MCP server (stdio, or via the shared daemon)").option("--stdio", "force the stdio transport").action(async (opts) => {
     await serve({ stdio: opts.stdio === true });
@@ -1443,7 +1700,7 @@ function createProgram() {
   contextGrp.action(() => {
     throw new NoirCliError(EXIT.USAGE, "Usage: noir context search|index|status");
   });
-  const memoryGrp = program2.command("memory").description("memory engine (S7)");
+  const memoryGrp = program2.command("memory").description("memory engine");
   memoryGrp.command("recall").description("recall memories for a query").argument("<query>", "recall query").option("--limit <n>", "max results", "10").action(async (...args) => {
     const cmd = trailingCmd(args);
     const g = cmd.optsWithGlobals();
@@ -1508,7 +1765,7 @@ function createProgram() {
   skillsGrp.action(() => {
     throw new NoirCliError(EXIT.USAGE, "Usage: noir skills list|sync");
   });
-  const taskGrp = program2.command("task").description("workflow task control (S4)");
+  const taskGrp = program2.command("task").description("workflow task control");
   taskGrp.command("new").description("start a new workflow task").requiredOption("--slug <slug>", "task slug").option("--mode <mode>", "full | quick").action(async (...args) => {
     const cmd = trailingCmd(args);
     const g = cmd.optsWithGlobals();
@@ -1547,6 +1804,34 @@ function createProgram() {
   taskGrp.action(() => {
     throw new NoirCliError(EXIT.USAGE, "Usage: noir task new|status|advance|next");
   });
+  function buildHandoffOptions(g) {
+    return { ...toCliOptions(g), ...g.write === true ? { write: true } : {} };
+  }
+  program2.command("handoff").description("emit a ready-to-paste host handoff prompt").option("--write", "persist to .noir/handoff/<id>.md (gitignored)").action(async (...args) => {
+    await handoff(buildHandoffOptions(trailingCmd(args).optsWithGlobals()));
+  });
+  program2.command("wrap").description("session-end alias for `noir handoff`").option("--write", "persist to .noir/handoff/<id>.md (gitignored)").action(async (...args) => {
+    await handoff(buildHandoffOptions(trailingCmd(args).optsWithGlobals()));
+  });
+  program2.command("tui").description("interactive Ink dashboard (host \xB7 phase \xB7 daemon + /command dispatch)").action(async (...args) => {
+    const g = actionGlobals(args);
+    const opts = toCliOptions(g);
+    requireInteractive(opts, "`noir tui`");
+    const tuiUrl = new URL("./tui/index.js", import.meta.url).href;
+    const { runTui } = await import(
+      /* @vite-ignore */
+      tuiUrl
+    );
+    const dispatch = async (argv) => {
+      const sub = createProgram();
+      try {
+        await sub.parseAsync([...argv], { from: "user" });
+      } catch (err) {
+        handleError(err);
+      }
+    };
+    await runTui(opts, dispatch);
+  });
   const homeDeps = {
     dispatch: async (argv) => {
       const sub = createProgram();
@@ -1593,9 +1878,11 @@ if (isMainModule) {
   void run(process.argv.slice(2));
 }
 export {
+  DEPRECATIONS,
   EXIT,
   NoirCliError,
   createProgram,
+  emitDeprecationHintsFor,
   fail,
   inferExitCode,
   program,