@holt-os/holt 0.9.0 → 0.10.0

package/dist/cli.js

@@ -41,11 +41,11 @@ function createReader() {
     closed = true;
     while (waiters.length) waiters.shift()(null);
   });
-  const ask = (q) => new Promise((resolve7) => {
+  const ask = (q) => new Promise((resolve8) => {
     if (q) process.stdout.write(q);
-    if (buffer.length) resolve7(buffer.shift());
-    else if (closed) resolve7(null);
-    else waiters.push(resolve7);
+    if (buffer.length) resolve8(buffer.shift());
+    else if (closed) resolve8(null);
+    else waiters.push(resolve8);
   });
   return { ask, close: () => rl.close() };
 }
@@ -243,12 +243,12 @@ function renderPrompt(history, message, memory = []) {
   return parts.join("\n");
 }
 function runBrain(brain, prompt, onChunk) {
-  return new Promise((resolve7) => {
+  return new Promise((resolve8) => {
     let child;
     try {
       child = spawn(brain.command, [...brain.args, prompt], { stdio: ["ignore", "pipe", "pipe"] });
     } catch (e) {
-      resolve7({ ok: false, text: `Could not launch "${brain.command}": ${e.message}` });
+      resolve8({ ok: false, text: `Could not launch "${brain.command}": ${e.message}` });
       return;
     }
     let out = "";
@@ -261,11 +261,11 @@ function runBrain(brain, prompt, onChunk) {
     child.stderr.on("data", (d) => {
       err2 += d.toString();
     });
-    child.on("error", (e) => resolve7({ ok: false, text: `Could not run "${brain.command}": ${e.message}` }));
+    child.on("error", (e) => resolve8({ ok: false, text: `Could not run "${brain.command}": ${e.message}` }));
     child.on("close", (code) => {
       const text = out.trim();
-      if (code === 0 && text) resolve7({ ok: true, text });
-      else resolve7({ ok: false, text: err2.trim() || text || `"${brain.command}" exited with code ${code}` });
+      if (code === 0 && text) resolve8({ ok: true, text });
+      else resolve8({ ok: false, text: err2.trim() || text || `"${brain.command}" exited with code ${code}` });
     });
   });
 }
@@ -435,16 +435,16 @@ function currentAlias() {
 // src/install.ts
 import { spawn as spawn2 } from "child_process";
 function runInteractive(cmd, args) {
-  return new Promise((resolve7) => {
+  return new Promise((resolve8) => {
     let child;
     try {
       child = spawn2(cmd, args, { stdio: "inherit" });
     } catch {
-      resolve7(-1);
+      resolve8(-1);
       return;
     }
-    child.on("error", () => resolve7(-1));
-    child.on("close", (code) => resolve7(code ?? -1));
+    child.on("error", () => resolve8(-1));
+    child.on("close", (code) => resolve8(code ?? -1));
   });
 }
 
@@ -2224,1086 +2224,1123 @@ async function extractAndSaveFacts(active, cfg, history, session) {
   }
 }
 
-// src/output.ts
-import { writeFileSync as writeFileSync7 } from "fs";
-import { join as join8, isAbsolute } from "path";
-function escapeHtml(s) {
-  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}
-function renderInline(text) {
-  const codes = [];
-  let s = text.replace(/`([^`]+)`/g, (_m, code) => {
-    codes.push(`<code>${escapeHtml(code)}</code>`);
-    return `\0${codes.length - 1}\0`;
-  });
-  s = escapeHtml(s);
-  s = s.replace(/\[([^\]]+)\]\((\S*?(?:\([^)\s]*\)[^)\s]*)*)\)/g, (_m, label, url) => {
-    const trimmed = url.trim();
-    const scheme = /^([a-z][a-z0-9+.-]*):/i.exec(trimmed);
-    const safeScheme = !scheme || /^(https?|mailto)$/i.test(scheme[1]);
-    if (!safeScheme) return label;
-    const safe = trimmed.replace(/"/g, "%22");
-    return `<a href="${safe}">${label}</a>`;
-  });
-  s = s.replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
-  s = s.replace(/\*([^*]+)\*/g, "<em>$1</em>");
-  s = s.replace(/(\d+)/g, (_m, i) => codes[Number(i)] ?? "");
-  return s;
+// src/wiki.ts
+import {
+  readFileSync as readFileSync9,
+  writeFileSync as writeFileSync7,
+  existsSync as existsSync8,
+  mkdirSync as mkdirSync7,
+  rmSync as rmSync4,
+  readdirSync as readdirSync2,
+  statSync as statSync3
+} from "fs";
+import { join as join8 } from "path";
+import { totalmem } from "os";
+
+// src/localmodel.ts
+var OLLAMA_URL2 = process.env.HOLT_OLLAMA_URL || "http://127.0.0.1:11434";
+async function localModelStatus(model) {
+  try {
+    const res = await fetch(`${OLLAMA_URL2}/api/tags`, { signal: AbortSignal.timeout(1500) });
+    if (!res.ok) return { reachable: false, hasModel: false };
+    const data = await res.json();
+    const want = model.includes(":") ? model : `${model}:latest`;
+    const hasModel = !!data.models?.some((m) => {
+      const n = m.name || "";
+      return n === model || n === want || n.startsWith(`${model}:`);
+    });
+    return { reachable: true, hasModel };
+  } catch {
+    return { reachable: false, hasModel: false };
+  }
 }
-function markdownToHtmlBody(md) {
-  const lines = md.replace(/\r\n/g, "\n").split("\n");
-  const out = [];
-  let i = 0;
-  let listOpen = false;
-  let paragraph = [];
-  const flushParagraph = () => {
-    if (paragraph.length) {
-      out.push(`<p>${renderInline(paragraph.join(" "))}</p>`);
-      paragraph = [];
-    }
-  };
-  const closeList = () => {
-    if (listOpen) {
-      out.push("</ul>");
-      listOpen = false;
-    }
-  };
-  while (i < lines.length) {
-    const line = lines[i] ?? "";
-    const fence = line.match(/^```(.*)$/);
-    if (fence) {
-      flushParagraph();
-      closeList();
-      const code = [];
-      i++;
-      while (i < lines.length && !/^```/.test(lines[i] ?? "")) {
-        code.push(lines[i] ?? "");
-        i++;
-      }
-      i++;
-      out.push(`<pre><code>${escapeHtml(code.join("\n"))}</code></pre>`);
-      continue;
-    }
-    const h = line.match(/^(#{1,3})\s+(.*)$/);
-    if (h) {
-      flushParagraph();
-      closeList();
-      const level = (h[1] ?? "#").length;
-      out.push(`<h${level}>${renderInline((h[2] ?? "").trim())}</h${level}>`);
-      i++;
-      continue;
-    }
-    const li = line.match(/^\s*[-*]\s+(.*)$/);
-    if (li) {
-      flushParagraph();
-      if (!listOpen) {
-        out.push("<ul>");
-        listOpen = true;
-      }
-      out.push(`<li>${renderInline((li[1] ?? "").trim())}</li>`);
-      i++;
-      continue;
-    }
-    if (line.trim() === "") {
-      flushParagraph();
-      closeList();
-      i++;
-      continue;
+async function localGenerate(model, prompt, timeoutMs = 12e4) {
+  let res;
+  try {
+    res = await fetch(`${OLLAMA_URL2}/api/generate`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ model, prompt, stream: false }),
+      signal: AbortSignal.timeout(timeoutMs)
+    });
+  } catch (e) {
+    return { ok: false, text: `Could not reach local Ollama at ${OLLAMA_URL2}: ${e.message}` };
+  }
+  if (!res.ok) {
+    let body = "";
+    try {
+      body = await res.text();
+    } catch {
     }
-    closeList();
-    paragraph.push(line.trim());
-    i++;
+    return { ok: false, text: `Ollama error ${res.status}: ${body.slice(0, 200)}` };
+  }
+  try {
+    const data = await res.json();
+    const text = (data.response || "").trim();
+    if (text) return { ok: true, text };
+    return { ok: false, text: "Local model returned an empty reply." };
+  } catch (e) {
+    return { ok: false, text: `Could not parse Ollama reply: ${e.message}` };
   }
-  flushParagraph();
-  closeList();
-  return out.join("\n");
 }
-function wrapHtmlPage(body, title = "Holt reply") {
-  return `<!doctype html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>${escapeHtml(title)}</title>
-<style>
-  :root { --bg:#0f1115; --fg:#e7e9ee; --accent:#f0b91e; }
-  * { box-sizing: border-box; }
-  body { margin:0; padding:2rem 1.25rem; background:var(--bg); color:var(--fg);
-         font:16px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif; }
-  main { max-width: 760px; margin: 0 auto; }
-  h1,h2,h3 { color:var(--accent); line-height:1.25; margin:1.4em 0 .5em; }
-  h1 { font-size:1.6rem; } h2 { font-size:1.3rem; } h3 { font-size:1.1rem; }
-  a { color:var(--accent); }
-  code { background:#1b1e26; padding:.1em .35em; border-radius:4px; font-size:.9em; }
-  pre { background:#1b1e26; padding:1rem; border-radius:8px; overflow:auto; }
-  pre code { background:none; padding:0; }
-  ul { padding-left:1.3rem; }
-  p { margin:.7em 0; }
-</style>
-</head>
-<body>
-<main>
-${body}
-</main>
-</body>
-</html>
-`;
+function pullHint(model) {
+  return `ollama pull ${model}`;
 }
-function renderReply(reply, format) {
-  if (format === "html") return wrapHtmlPage(markdownToHtmlBody(reply));
-  return reply.endsWith("\n") ? reply : reply + "\n";
+
+// src/wiki.ts
+function wikiDir() {
+  return join8(wsHoltDir(), "wiki");
 }
-function timestamp() {
-  const d = /* @__PURE__ */ new Date();
-  const p = (n) => String(n).padStart(2, "0");
-  return `${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}-${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`;
+function wikiStatePath() {
+  return join8(wikiDir(), ".state.json");
 }
-function saveReply(reply, format, name) {
-  const ext = format === "html" ? ".html" : ".md";
-  let base = (name ?? "").trim();
-  if (!base) base = `holt-reply-${timestamp()}`;
-  if (isAbsolute(base) || /[\\/]/.test(base) || base === "." || base === "..") {
-    throw new Error('name must be a plain file name in this folder (no "/", "\\", or "..").');
+function wikiIndexPath() {
+  return join8(wikiDir(), "index.md");
+}
+function pagePath(slug) {
+  return join8(wikiDir(), `${slug}.md`);
+}
+function loadState() {
+  try {
+    const s = JSON.parse(readFileSync9(wikiStatePath(), "utf8"));
+    return { lastSyncTs: typeof s.lastSyncTs === "number" ? s.lastSyncTs : 0, updatedAt: s.updatedAt ?? 0 };
+  } catch {
+    return { lastSyncTs: 0, updatedAt: 0 };
   }
-  if (!/\.[a-z0-9]+$/i.test(base)) base += ext;
-  const path = join8(process.cwd(), base);
-  writeFileSync7(path, renderReply(reply, format), "utf8");
-  return path;
 }
-
-// src/commands/chat.ts
-function statusLine(brainLabel, history) {
-  const live = Math.min(history.length, MAX_REPLAY_TURNS);
-  const frac = MAX_REPLAY_TURNS ? live / MAX_REPLAY_TURNS : 0;
-  const pct = Math.round(frac * 100);
-  const mem = memStats().turns;
-  return c.dim("  " + brainLabel + "  ") + c.dim("[") + bar(frac) + c.dim("]") + c.dim(`  ${pct}% context  \xB7  ${mem} in memory`);
+function saveState(s) {
+  mkdirSync7(wikiDir(), { recursive: true });
+  writeFileSync7(wikiStatePath(), JSON.stringify(s, null, 2) + "\n", "utf8");
 }
-function help() {
-  console.log(c.dim([
-    "  commands:",
-    "    /brain [name]     switch brain (CLI or API). context is kept.",
-    "    /memory [query]   memory stats, or preview what a query would recall",
-    '    /skill [name] [input]  run a skill, or list them. "holt skill" manages them.',
-    "    /output [fmt]     show or set output format: markdown | html",
-    "    /save [name]      save the last reply to a file in this folder",
-    "    /setting          configure brains, API brains, and your launch command",
-    "    /clear            forget this session so far (saved memory stays)",
-    "    /help             this list",
-    "    /exit             leave"
-  ].join("\n")));
+function saveSyncMarker(ts) {
+  saveState({ lastSyncTs: ts, updatedAt: Date.now() });
 }
-function resolveActive2(cfg, id) {
-  if (BRAIN_IDS.includes(id)) {
-    const b = cfg.brains[id];
-    return { kind: "cli", id, label: b.label };
+function isPageFile(name) {
+  return name.endsWith(".md") && name !== "index.md";
+}
+function listPageSlugs() {
+  const dir = wikiDir();
+  if (!existsSync8(dir)) return [];
+  try {
+    return readdirSync2(dir).filter(isPageFile).map((f) => f.slice(0, -3)).sort();
+  } catch {
+    return [];
   }
-  const api = findApiBrain(cfg, id);
-  if (api) return { kind: "api", id, label: `${id} (api: ${api.provider}/${api.model})`, brain: api };
-  return null;
 }
-async function chat() {
-  const { ask, close } = createReader();
-  if (!await ensureTrusted(ask)) {
-    close();
-    return;
+function readPage(slug) {
+  const p = pagePath(slug);
+  if (!existsSync8(p)) return null;
+  let raw = "";
+  try {
+    raw = readFileSync9(p, "utf8");
+  } catch {
+    return null;
   }
-  let cfg = loadConfig();
-  if (!cfg || !cfg.defaultBrain) {
-    const a = (await ask(c.dim("No Holt setup in this folder. Set it up now? [Y/n] ")) ?? "").trim().toLowerCase();
-    close();
-    if (a === "n" || a === "no") {
-      console.log(c.dim('  Run "holt init" here when ready.\n'));
-      return;
-    }
-    await init();
-    console.log(c.dim('\nSetup done. Run "holt chat" to start talking.\n'));
-    return;
-  }
-  let active = resolveActive2(cfg, cfg.defaultBrain);
-  if (!active) {
-    const fallback = BRAIN_IDS.find((id) => cfg.brains[id].enabled) ?? cfg.apiBrains[0]?.id ?? null;
-    active = fallback ? resolveActive2(cfg, fallback) : null;
-    if (!active) {
-      close();
-      console.log(c.dim('\nNo brain is ready. Run "holt setting".\n'));
-      return;
-    }
-  }
-  const session = newSessionId();
-  const history = [];
-  let lastReply = "";
-  const embedOk = await embeddingsAvailable();
-  const stats = memStats();
-  console.log("\n" + c.accent("Holt") + c.dim(`  brain: ${active.label}`));
-  console.log(c.dim(
-    `Memory: ${stats.turns} moments (${stats.facts} facts) from ${stats.sessions} session${stats.sessions === 1 ? "" : "s"} in this folder (recall: ${embedOk ? "embeddings via local Ollama" : "keyword match"}).`
-  ));
-  if (embedOk && stats.withEmbeddings < stats.turns) {
-    console.log(c.dim(`  ${stats.turns - stats.withEmbeddings} older moments lack embeddings. Run "holt memory embed" to upgrade them.`));
-  }
-  console.log(c.dim("Type a message. Commands: /brain  /memory  /output  /save  /setting  /clear  /help  /exit"));
-  console.log(statusLine(active.label, history) + "\n");
-  while (true) {
-    const raw = await ask(c.accent("\u203A "));
-    if (raw === null) break;
-    const line = raw.trim();
-    if (!line) continue;
-    let promptOverride = null;
-    if (/^\/skills?\s+\S/.test(line)) {
-      const inv = resolveSkillInvocation(line.replace(/^\/skills\b/, "/skill"));
-      if (!inv) {
-        console.log(c.dim('  no such skill. Try "holt skill list".'));
-        continue;
-      }
-      promptOverride = inv.prompt;
-      console.log(c.dim(`  running skill "${inv.skillName}"...`));
-    } else if (line.startsWith("/")) {
-      const parts = line.slice(1).split(/\s+/);
-      const cmd = (parts[0] || "").toLowerCase();
-      const rest = parts.slice(1).join(" ");
-      const arg = (parts[1] || "").toLowerCase();
-      if (cmd === "exit" || cmd === "quit" || cmd === "q") break;
-      if (cmd === "help" || cmd === "h") {
-        help();
-        continue;
-      }
-      if (cmd === "clear") {
-        history.length = 0;
-        console.log(c.dim("  session context cleared. Saved memory is untouched."));
-        continue;
-      }
-      if (cmd === "memory" || cmd === "mem") {
-        if (rest) {
-          const hits = await recall(rest, session, 5);
-          if (hits.length === 0) console.log(c.dim("  nothing relevant in memory for that."));
-          else for (const h of hits) console.log(c.dim(`  ${h.score.toFixed(2)}  (${h.turn.role}) ${h.turn.content.slice(0, 110).replace(/\s+/g, " ")}`));
-        } else {
-          const s = memStats();
-          console.log(c.dim(`  ${s.turns} moments, ${s.facts} facts, ${s.sessions} sessions, ${s.withEmbeddings} embedded, ${(s.bytes / 1024).toFixed(1)} KB in ./.holt/memory/`));
-          console.log(c.dim('  usage: /memory <query> to preview recall, or "holt memory clear" to wipe.'));
-        }
-        continue;
-      }
-      if (cmd === "output") {
-        const want = arg;
-        if (want === "markdown" || want === "md") {
-          cfg.outputFormat = "markdown";
-          saveConfig(cfg);
-          console.log(c.green("  output format: markdown"));
-        } else if (want === "html") {
-          cfg.outputFormat = "html";
-          saveConfig(cfg);
-          console.log(c.green("  output format: html"));
-        } else if (want) console.log(c.dim("  usage: /output markdown | html"));
-        else console.log(c.dim(`  output format: ${cfg.outputFormat}  (change with /output markdown | html)`));
-        continue;
-      }
-      if (cmd === "save") {
-        if (!lastReply) {
-          console.log(c.dim("  nothing to save yet. Ask something first."));
-          continue;
-        }
-        try {
-          const path = saveReply(lastReply, cfg.outputFormat, rest || void 0);
-          console.log(c.green(`  saved ${cfg.outputFormat} to ${path}`));
-        } catch (e) {
-          console.log(c.red(`  could not save: ${e.message}`));
-        }
-        continue;
-      }
-      if (cmd === "setting" || cmd === "settings") {
-        cfg = await runSettings(ask);
-        const next = cfg.defaultBrain ? resolveActive2(cfg, cfg.defaultBrain) : null;
-        const stillValid = resolveActive2(cfg, active.id);
-        active = stillValid ?? next ?? active;
-        console.log(c.dim(`  brain: ${active.label}`));
-        continue;
-      }
-      if (cmd === "brain") {
-        const cliEnabled = BRAIN_IDS.filter((id) => cfg.brains[id].enabled);
-        const apiIds = cfg.apiBrains.map((a) => a.id);
-        const all = [...cliEnabled, ...apiIds];
-        const rawArg = parts[1] || "";
-        const match = all.find((id) => id.toLowerCase() === rawArg.toLowerCase());
-        if (rawArg && match) {
-          const next = resolveActive2(cfg, match);
-          if (next) {
-            active = next;
-            const turns = Math.floor(history.length / 2);
-            console.log(c.green(`  switched to ${active.label}. Context kept (${turns} turn${turns === 1 ? "" : "s"}).`));
-          }
-        } else if (rawArg) {
-          console.log(c.dim(`  "${rawArg}" is not available. Available: ${all.join(", ") || "none"}`));
-        } else {
-          const cfgRef = cfg;
-          const activeId = active.id;
-          const labels = all.map((id) => {
-            const a = findApiBrain(cfgRef, id);
-            const shown = a ? `${id} (api: ${a.provider}/${a.model})` : id;
-            return id === activeId ? c.accent(shown + " (current)") : shown;
-          });
-          console.log(c.dim("  brains: " + labels.join("   ")));
-          console.log(c.dim("  usage: /brain <name>"));
-        }
-        continue;
-      }
-      if (cmd === "skill" || cmd === "skills") {
-        const names = listSkills().map((s) => s.name);
-        console.log(c.dim("  skills: " + (names.join("  ") || "none") + "   usage: /skill <name> [input]"));
-        continue;
-      }
-      console.log(c.dim(`  unknown command: /${cmd}  (try /help)`));
-      continue;
-    }
-    if (active.kind === "cli" && !isInstalled(cfg.brains[active.id].command)) {
-      console.log(c.red(`  ${active.label} (${cfg.brains[active.id].command}) is not on your PATH. Use /brain to switch or /setting.`));
-      continue;
-    }
-    if (active.kind === "api" && !resolveApiKey(active.brain)) {
-      console.log(c.red(`  ${active.label} has no API key. Use /setting to add one, or /brain to switch.`));
-      continue;
-    }
-    const remembered = await recall(line, session, 4);
-    const label = remembered.length ? `${active.label} is thinking (recalled ${remembered.length} moment${remembered.length === 1 ? "" : "s"})...` : `${active.label} is thinking...`;
-    console.log(c.dim(`  ${label}`) + "\n");
-    const skillsBlock = skillsPromptBlock();
-    const base = renderPrompt(history, line, remembered);
-    const prompt = promptOverride ?? (skillsBlock ? skillsBlock + "\n\n" + base : base);
-    let streamed = false;
-    const onChunk = (chunk2) => {
-      streamed = true;
-      process.stdout.write(chunk2);
-    };
-    const res = active.kind === "cli" ? await runBrain(cfg.brains[active.id], prompt, onChunk) : await runApiBrain(active.brain, prompt, onChunk);
-    if (res.ok) {
-      if (!streamed) console.log(res.text);
-      if (!res.text.endsWith("\n")) console.log("");
-      console.log("");
-      lastReply = res.text;
-      history.push({ role: "user", content: line });
-      history.push({ role: "assistant", content: res.text });
-      const now = Date.now();
-      appendTurn({ id: randomUUID3().slice(0, 8), ts: now, session, role: "user", content: line, emb: await embed(line) ?? void 0 });
-      appendTurn({ id: randomUUID3().slice(0, 8), ts: now, session, role: "assistant", content: res.text, emb: await embed(res.text) ?? void 0 });
-      console.log(statusLine(active.label, history) + "\n");
-    } else {
-      console.log(c.red("\n  " + res.text + "\n"));
-    }
+  const { data, body } = parseFrontmatter(raw);
+  return {
+    slug,
+    title: data.title || slug,
+    updated: data.updated || "",
+    sources: parseSources(data.sources),
+    body
+  };
+}
+function loadPages() {
+  const out = [];
+  for (const slug of listPageSlugs()) {
+    const pg = readPage(slug);
+    if (pg) out.push(pg);
   }
-  if (cfg.memory?.extractFacts !== false) {
-    try {
-      const arg = active.kind === "cli" ? { kind: "cli", id: active.id } : { kind: "api", brain: active.brain };
-      const n = await extractAndSaveFacts(arg, cfg, history, session);
-      if (n > 0) console.log(c.dim(`  distilled ${n} fact${n === 1 ? "" : "s"} from this session.`));
-    } catch {
-    }
+  return out;
+}
+function parseSources(raw) {
+  if (!raw) return [];
+  return raw.replace(/^\[|\]$/g, "").split(/[\s,]+/).map((s) => s.replace(/^["']|["']$/g, "").trim()).filter(Boolean);
+}
+var PAGE_HEADER_NOTE = "Derived page, maintained by Holt. Safe to edit; a rebuild will regenerate it from facts.";
+function renderPage(pg) {
+  const fm = [
+    "---",
+    `title: ${pg.title}`,
+    `updated: ${pg.updated}`,
+    `sources: ${pg.sources.join(", ")}`,
+    "---",
+    "",
+    `> ${PAGE_HEADER_NOTE}`,
+    "",
+    pg.body.trim(),
+    ""
+  ].join("\n");
+  return fm;
+}
+function writePage(pg) {
+  mkdirSync7(wikiDir(), { recursive: true });
+  writeFileSync7(pagePath(pg.slug), renderPage(pg), "utf8");
+}
+var WIKILINK_RE = /\[\[([^\]]+)\]\]/g;
+function extractLinks(body) {
+  const out = [];
+  let m;
+  WIKILINK_RE.lastIndex = 0;
+  while ((m = WIKILINK_RE.exec(body)) !== null) {
+    const target = (m[1] || "").split("|")[0].trim();
+    if (target) out.push(target);
   }
-  close();
-  console.log(c.dim("\nBye.\n"));
+  return out;
 }
-
-// src/commands/login.ts
-async function login(which) {
-  const id = (which || "").toLowerCase();
-  if (!BRAIN_IDS.includes(id)) {
-    if (which) {
-      console.error(`
-  Unknown brain "${which}". Use one of: ${BRAIN_IDS.join(", ")}
-`);
-      process.exitCode = 1;
-    } else {
-      console.log(c.dim(`
-  Usage: holt login <${BRAIN_IDS.join("|")}>
-`));
-    }
-    return;
+function cosine2(a, b) {
+  let dot = 0;
+  let na = 0;
+  let nb = 0;
+  const n = Math.min(a.length, b.length);
+  for (let i = 0; i < n; i++) {
+    const x = a[i];
+    const y = b[i];
+    dot += x * y;
+    na += x * x;
+    nb += y * y;
   }
-  const s = BRAIN_SETUP[id];
-  console.log("\n" + c.accent(`Sign in to ${BRAIN_DEFS[id].label}`));
-  console.log(c.dim(`  Starting "${s.login.join(" ")}". Complete sign-in, then exit that tool.
-`));
-  await runInteractive(s.login[0], s.login.slice(1));
+  return na && nb ? dot / (Math.sqrt(na) * Math.sqrt(nb)) : 0;
 }
-
-// src/commands/memory.ts
-import { existsSync as existsSync8, readFileSync as readFileSync9 } from "fs";
-import { basename } from "path";
-async function memoryCmd(sub, rest = []) {
-  const { ask, close } = createReader();
-  if (!await ensureTrusted(ask)) {
-    close();
-    return;
+var ROUTE_SIMILARITY_THRESHOLD = 0.55;
+async function pageEmbeddings(pages) {
+  const out = [];
+  for (const page of pages) {
+    const emb = await embed(`${page.title}
+${page.body.slice(0, 1500)}`);
+    if (emb) out.push({ page, emb });
   }
-  const action = (sub || "").toLowerCase();
-  if (action === "clear") {
-    const s2 = memStats();
-    if (s2.turns === 0) {
-      console.log(c.dim("\n  Memory is already empty.\n"));
-      close();
-      return;
-    }
-    const a = (await ask(`
-  Delete all ${s2.turns} remembered moments in this folder? [y/N] `) ?? "").trim().toLowerCase();
-    if (a === "y" || a === "yes") {
-      clearMemory();
-      console.log(c.green("  Memory cleared.\n"));
-    } else console.log(c.dim("  Kept.\n"));
-    close();
-    return;
+  return out;
+}
+async function routeFact(content, targets) {
+  const e = await embed(content);
+  if (!e) {
+    return { kind: targets.length ? "existing" : "new", slug: targets[0]?.page.slug ?? "notes", score: 0 };
   }
-  if (action === "embed") {
-    if (!await embeddingsAvailable()) {
-      console.log(c.dim(`
-  No local Ollama with ${EMBED_MODEL} reachable. Run "holt init" to set it up.
-`));
-      close();
-      return;
-    }
-    const missing = loadTurns().filter((t) => !Array.isArray(t.emb)).length;
-    if (missing === 0) {
-      console.log(c.dim("\n  All memories already have embeddings.\n"));
-      close();
-      return;
+  let best = null;
+  let bestScore = -1;
+  for (const t of targets) {
+    const s = cosine2(e, t.emb);
+    if (s > bestScore) {
+      bestScore = s;
+      best = t;
     }
-    console.log("");
-    const r = await backfillEmbeddings((done, total) => {
-      process.stdout.write(`\r  embedding ${done}/${total}...`);
-    });
-    console.log("\n" + c.green(`  Done. ${r.embedded} of ${r.total} memories embedded.`) + "\n");
-    close();
-    return;
   }
-  if (action === "facts") {
-    if (!existsSync8(factsMdPath())) {
-      console.log(c.dim("\n  No facts distilled yet. They form when you end a chat session.\n"));
-      close();
-      return;
-    }
-    const body = readFileSync9(factsMdPath(), "utf8").trim();
-    console.log("\n" + body + "\n");
-    close();
-    return;
+  if (best && bestScore >= ROUTE_SIMILARITY_THRESHOLD) {
+    return { kind: "existing", slug: best.page.slug, score: bestScore };
   }
-  if (action === "search") {
-    const q = rest.join(" ").trim();
-    if (!q) {
-      console.log(c.dim("\n  Usage: holt memory search <query>\n"));
-      close();
-      return;
+  return { kind: "new", slug: proposeSlug(content), score: bestScore < 0 ? 0 : bestScore };
+}
+function proposeSlug(content) {
+  const words2 = content.toLowerCase().replace(/[^a-z0-9\s-]/g, " ").split(/\s+/).filter((w) => w.length > 2 && !ROUTE_STOPWORDS.has(w)).slice(0, 4);
+  const slug = sanitizeName(words2.join("-"));
+  return slug || "notes";
+}
+var ROUTE_STOPWORDS = /* @__PURE__ */ new Set([
+  "the",
+  "and",
+  "that",
+  "this",
+  "with",
+  "from",
+  "for",
+  "was",
+  "are",
+  "has",
+  "have",
+  "will",
+  "user",
+  "their",
+  "they",
+  "about",
+  "into",
+  "per",
+  "via"
+]);
+async function resolveMaintainer(cfg, resolveBrain) {
+  if (cfg.wiki.maintainer === "local") {
+    const model = cfg.wiki.localModel;
+    const status2 = await localModelStatus(model);
+    if (status2.reachable && status2.hasModel) {
+      const m = { kind: "local", model, label: `local (${model})` };
+      return { maintainer: m, report: { maintainer: m, fellBack: false } };
     }
-    const hits = await recall(q, "__none__", 8);
-    console.log("");
-    if (hits.length === 0) console.log(c.dim("  Nothing relevant found."));
-    else for (const h of hits) {
-      const when = new Date(h.turn.ts).toISOString().slice(0, 10);
-      const src = h.workspace ? c.dim(` [${basename(h.workspace)}]`) : "";
-      console.log(
-        `  ${c.accent(h.score.toFixed(2))}  ${c.dim(when)}  (${h.turn.role})${src} ${h.turn.content.slice(0, 100).replace(/\s+/g, " ")}`
-      );
+    const why = status2.reachable ? `local model "${model}" is not pulled. Run: ${pullHint(model)}` : "local Ollama is not reachable.";
+    const brain2 = resolveBrain();
+    if (brain2) {
+      return {
+        maintainer: brain2,
+        report: { maintainer: brain2, fellBack: true, note: `${why} Falling back to ${brain2.label}.` }
+      };
     }
-    console.log("");
-    close();
-    return;
+    return { maintainer: null, report: null };
   }
-  if (action === "global") {
-    globalCmd((rest[0] || "").toLowerCase(), rest.slice(1));
-    close();
-    return;
+  const brain = resolveBrain();
+  if (!brain) return { maintainer: null, report: null };
+  return { maintainer: brain, report: { maintainer: brain, fellBack: false } };
+}
+function resolveBrainMaintainer(cfg) {
+  const id = cfg.defaultBrain;
+  if (!id) return null;
+  if (BRAIN_IDS.includes(id)) {
+    const b = cfg.brains[id];
+    if (!isInstalled(b.command)) return null;
+    return { kind: "cli", id, label: b.label };
   }
-  if (action && !["clear", "embed", "facts", "search", "global"].includes(action)) {
-    console.error(`
-  Unknown memory subcommand: "${sub}". Use: search <query> | facts | embed | global | clear
-`);
-    process.exitCode = 1;
-    close();
-    return;
+  const api = findApiBrain(cfg, id);
+  if (api && resolveApiKey(api)) return { kind: "api", brain: api, label: `${id} (api: ${api.provider}/${api.model})` };
+  return null;
+}
+async function runMaintainer(m, cfg, prompt) {
+  if (m.kind === "cli") return runBrain(cfg.brains[m.id], prompt);
+  if (m.kind === "api") return runApiBrain(m.brain, prompt);
+  const r = await localGenerate(m.model, prompt);
+  return { ok: r.ok, text: r.text };
+}
+function buildPagePrompt(title, existingBody, facts, otherTitles) {
+  const lines = [
+    `You maintain a personal knowledge wiki. Write or update ONE page titled "${title}".`,
+    "Output ONLY the page body in Markdown. No frontmatter, no code fences, no preamble.",
+    "",
+    "Rules:",
+    "- Synthesize the facts into concise, self-contained prose (a few short paragraphs or tight bullets).",
+    "- Merge new facts into the existing text; do not just append. Resolve overlaps. Keep it current.",
+    "- Do not invent anything beyond the facts given.",
+    '- End with a line "## Related" followed by [[Wiki Page]] links to other pages that connect.',
+    "- Use [[double-bracket]] links for any other page you reference."
+  ];
+  if (otherTitles.length) {
+    lines.push("", "Other existing pages you may link to:", ...otherTitles.map((t) => `- ${t}`));
   }
-  const s = memStats();
-  const embedOk = await embeddingsAvailable();
-  const sessions = new Set(loadTurns().map((t) => t.session)).size;
-  console.log("\n" + c.accent("Holt memory") + c.dim("  (this folder)"));
-  console.log(`  moments     ${s.turns}`);
-  console.log(`  facts       ${s.facts}  (./.holt/memory/facts.md)`);
-  console.log(`  sessions    ${sessions}`);
-  console.log(`  embedded    ${s.withEmbeddings} of ${s.turns}`);
-  console.log(`  size        ${(s.bytes / 1024).toFixed(1)} KB  (./.holt/memory/turns.jsonl)`);
-  console.log(`  recall via  ${embedOk ? "embeddings (local Ollama)" : "keyword match (start Ollama with an embed model for semantic recall)"}`);
-  if (embedOk && s.withEmbeddings < s.turns) {
-    console.log(c.dim(`
-  ${s.turns - s.withEmbeddings} moments lack embeddings. Run "holt memory embed" to upgrade them to semantic recall.`));
+  if (existingBody.trim()) {
+    lines.push("", "Current page body:", existingBody.trim());
   }
-  const gEnabled = isGlobalEnabled(workspace());
-  console.log(`  global      ${gEnabled ? c.green("on") + c.dim("  (contributes + reads shared facts)") : c.dim("off  (this folder is isolated, the default)")}`);
-  console.log(c.dim("\n  holt memory search <query>   find remembered moments"));
-  console.log(c.dim("  holt memory facts            show distilled facts (facts.md)"));
-  console.log(c.dim("  holt memory embed            embed older memories for semantic recall"));
-  console.log(c.dim("  holt memory global           share high-value facts across your folders"));
-  console.log(c.dim("  holt memory clear            wipe this folder's memory\n"));
-  close();
+  lines.push("", "New facts to integrate:", ...facts.map((f) => `- ${f}`), "", "Updated page body:");
+  return lines.join("\n");
 }
-function globalCmd(act, rest) {
-  const ws = workspace();
-  if (act === "on") {
-    const already = isGlobalEnabled(ws);
-    const added = enableGlobal(ws);
-    const g = globalStats();
-    if (already) console.log("\n" + c.green("  Global memory already on for this folder."));
-    else console.log("\n" + c.green("  Global memory ON for this folder."));
-    console.log(c.dim(`  Backfilled ${added} fact${added === 1 ? "" : "s"} into the shared store.`));
-    console.log(c.dim(`  New facts here mirror automatically; recall now spans ${g.workspaces} contributing folder${g.workspaces === 1 ? "" : "s"}.
-`));
-    return;
+function emptySummary() {
+  return { created: 0, updated: 0, factsIntegrated: 0 };
+}
+function dedupe(a) {
+  return [...new Set(a)];
+}
+function deriveTitle(content, slug) {
+  const fromSlug = slug.split("-").filter(Boolean).map((w) => w[0].toUpperCase() + w.slice(1)).join(" ");
+  return fromSlug || content.slice(0, 40);
+}
+function stripFrontmatterEcho(text) {
+  let s = text.trim();
+  s = s.replace(/^```(?:markdown|md)?\s*/i, "").replace(/```\s*$/i, "").trim();
+  if (s.startsWith("---")) {
+    const end = s.indexOf("\n---", 3);
+    if (end >= 0) s = s.slice(end + 4).trim();
   }
-  if (act === "off") {
-    const purge = rest.includes("--purge");
-    if (!isGlobalEnabled(ws) && !purge) {
-      console.log("\n" + c.dim("  Global memory is already off for this folder.\n"));
-      return;
+  return s;
+}
+async function foldFacts(cfg, maintainer, facts) {
+  const summary = emptySummary();
+  if (facts.length === 0) return { summary, changed: [] };
+  let pages = loadPages();
+  const targets = await pageEmbeddings(pages);
+  const groups = /* @__PURE__ */ new Map();
+  for (const f of facts) {
+    const decision = await routeFact(f.content, targets);
+    const slug = decision.slug;
+    let isNew = decision.kind === "new";
+    const existingGroup = groups.get(slug);
+    if (existingGroup) {
+      existingGroup.facts.push(f);
+    } else {
+      if (isNew && listPageSlugs().includes(slug)) isNew = false;
+      groups.set(slug, { slug, isNew, facts: [f] });
     }
-    const { purged } = disableGlobal(ws, purge);
-    console.log("\n" + c.green("  Global memory OFF for this folder.") + c.dim("  (recall is local-only again)"));
-    if (purge) console.log(c.dim(`  Purged ${purged} of this folder's row${purged === 1 ? "" : "s"} from the shared store.`));
-    else console.log(c.dim("  This folder's rows stay in the shared store. Re-run with --purge to remove them."));
-    console.log("");
-    return;
   }
-  if (act === "" || act === "status") {
-    const enabled = isGlobalEnabled(ws);
-    const g = globalStats();
-    const contributors = globalWorkspaces();
-    console.log("\n" + c.accent("Holt global memory") + c.dim("  (opt-in, shared facts across your folders)"));
-    console.log(`  this folder    ${enabled ? c.green("on") : c.dim("off (isolated, the default)")}`);
-    console.log(`  contributing   ${g.workspaces} folder${g.workspaces === 1 ? "" : "s"}`);
-    console.log(`  shared facts   ${g.facts}`);
-    console.log(`  size           ${(g.bytes / 1024).toFixed(1)} KB  (${globalMemPath()})`);
-    console.log(`  registry       ${memoryScopesPath()}`);
-    if (contributors.length) {
-      console.log(c.dim("\n  Folders sharing facts:"));
-      for (const w of contributors) console.log(c.dim(`    ${basename(w)}  ${w === ws ? "(this folder)" : w}`));
-    }
-    console.log(c.dim("\n  holt memory global on          share this folder's facts + read others"));
-    console.log(c.dim("  holt memory global off         stop sharing + reading (add --purge to delete rows)"));
-    console.log(c.dim("  holt memory global status      this view\n"));
-    return;
+  const knownTitles = new Set(pages.map((p) => p.title));
+  for (const group of groups.values()) {
+    knownTitles.add(readPage(group.slug)?.title ?? deriveTitle(group.facts[0].content, group.slug));
   }
-  console.error(`
-  Unknown "memory global" action: "${act}". Use: on | off [--purge] | status
-`);
-  process.exitCode = 1;
+  const changed = [];
+  for (const group of groups.values()) {
+    const existing = readPage(group.slug);
+    const title = existing?.title ?? deriveTitle(group.facts[0].content, group.slug);
+    const prompt = buildPagePrompt(
+      title,
+      existing?.body ?? "",
+      group.facts.map((f) => f.content),
+      [...knownTitles].filter((t) => t !== title)
+    );
+    const res = await runMaintainer(maintainer, cfg, prompt);
+    if (!res.ok || !res.text.trim()) continue;
+    const body = stripFrontmatterEcho(res.text);
+    const prevSources = existing?.sources ?? [];
+    const page = {
+      slug: group.slug,
+      title,
+      updated: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+      sources: dedupe([...prevSources, ...group.facts.map((f) => f.id)]),
+      body
+    };
+    writePage(page);
+    changed.push(page);
+    if (existing) summary.updated++;
+    else summary.created++;
+    summary.factsIntegrated += group.facts.length;
+  }
+  pages = loadPages();
+  writeIndex(pages);
+  await indexPagesForRecall(changed);
+  return { summary, changed };
+}
+async function syncWiki(cfg, resolveBrain) {
+  const base = {
+    ...emptySummary(),
+    status: "nothing",
+    freshFacts: 0,
+    maintainer: null,
+    report: null,
+    changed: false
+  };
+  try {
+    const state = loadState();
+    const fresh = factRows().filter((f) => f.ts > state.lastSyncTs);
+    if (fresh.length === 0) return base;
+    base.freshFacts = fresh.length;
+    const { maintainer, report } = await resolveMaintainer(cfg, resolveBrain);
+    base.maintainer = maintainer;
+    base.report = report;
+    if (!maintainer) return { ...base, status: "no-maintainer" };
+    const { summary, changed } = await foldFacts(cfg, maintainer, fresh);
+    const newest = Math.max(state.lastSyncTs, ...fresh.map((f) => f.ts));
+    saveSyncMarker(newest);
+    return {
+      ...summary,
+      status: "ok",
+      freshFacts: fresh.length,
+      maintainer,
+      report,
+      changed: changed.length > 0
+    };
+  } catch {
+    return base;
+  }
+}
+function renderIndex(pages) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const lines = [
+    "---",
+    "title: Wiki Index",
+    `updated: ${today}`,
+    "---",
+    "",
+    "# Wiki",
+    "",
+    "Derived knowledge for this folder. Pages are synthesized from `facts.md` and",
+    "`turns.jsonl` and are regenerable with `holt wiki rebuild`. Open in Obsidian to",
+    "browse the [[links]].",
+    ""
+  ];
+  if (pages.length === 0) {
+    lines.push("_No pages yet. Run `holt wiki sync` after chatting._", "");
+    return lines.join("\n");
+  }
+  lines.push("## Pages", "");
+  for (const pg of [...pages].sort((a, b) => a.title.localeCompare(b.title))) {
+    const when = pg.updated ? ` _(updated ${pg.updated})_` : "";
+    lines.push(`- [[${pg.title}]]${when}`);
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function writeIndex(pages) {
+  mkdirSync7(wikiDir(), { recursive: true });
+  writeFileSync7(wikiIndexPath(), renderIndex(pages), "utf8");
 }
-
-// src/commands/wiki.ts
-import { existsSync as existsSync10, readFileSync as readFileSync11 } from "fs";
-import { join as join10 } from "path";
-import { spawn as spawn3 } from "child_process";
-
-// src/localmodel.ts
-var OLLAMA_URL2 = process.env.HOLT_OLLAMA_URL || "http://127.0.0.1:11434";
-async function localModelStatus(model) {
+var WIKI_SESSION = "wiki";
+function wikiRowId(slug) {
+  return "wiki-" + sanitizeName(slug).slice(0, 24);
+}
+function dropWikiRows(slugs) {
+  const keep = loadTurns().filter((t) => !(t.session === WIKI_SESSION && slugs.has(t.id.replace(/^wiki-/, ""))));
+  return keep;
+}
+async function indexPagesForRecall(pages) {
   try {
-    const res = await fetch(`${OLLAMA_URL2}/api/tags`, { signal: AbortSignal.timeout(1500) });
-    if (!res.ok) return { reachable: false, hasModel: false };
-    const data = await res.json();
-    const want = model.includes(":") ? model : `${model}:latest`;
-    const hasModel = !!data.models?.some((m) => {
-      const n = m.name || "";
-      return n === model || n === want || n.startsWith(`${model}:`);
-    });
-    return { reachable: true, hasModel };
+    if (pages.length === 0) return;
+    const slugs = new Set(pages.map((p) => sanitizeName(p.slug).slice(0, 24)));
+    const kept = dropWikiRows(slugs);
+    mkdirSync7(join8(wsHoltDir(), "memory"), { recursive: true });
+    writeFileSync7(
+      join8(wsHoltDir(), "memory", "turns.jsonl"),
+      kept.map((t) => JSON.stringify(t)).join("\n") + (kept.length ? "\n" : ""),
+      "utf8"
+    );
+    for (const pg of pages) {
+      const content = `${pg.title}
+${pg.body}`.slice(0, 4e3);
+      appendTurn({
+        id: wikiRowId(pg.slug),
+        ts: Date.now(),
+        session: WIKI_SESSION,
+        role: "fact",
+        content,
+        emb: await embed(content) ?? void 0
+      });
+    }
   } catch {
-    return { reachable: false, hasModel: false };
   }
 }
-async function localGenerate(model, prompt, timeoutMs = 12e4) {
-  let res;
+function clearWikiRecallRows() {
   try {
-    res = await fetch(`${OLLAMA_URL2}/api/generate`, {
-      method: "POST",
-      headers: { "content-type": "application/json" },
-      body: JSON.stringify({ model, prompt, stream: false }),
-      signal: AbortSignal.timeout(timeoutMs)
-    });
-  } catch (e) {
-    return { ok: false, text: `Could not reach local Ollama at ${OLLAMA_URL2}: ${e.message}` };
+    const kept = loadTurns().filter((t) => t.session !== WIKI_SESSION);
+    mkdirSync7(join8(wsHoltDir(), "memory"), { recursive: true });
+    writeFileSync7(
+      join8(wsHoltDir(), "memory", "turns.jsonl"),
+      kept.map((t) => JSON.stringify(t)).join("\n") + (kept.length ? "\n" : ""),
+      "utf8"
+    );
+  } catch {
   }
-  if (!res.ok) {
-    let body = "";
+}
+function wipeWiki() {
+  if (existsSync8(wikiDir())) rmSync4(wikiDir(), { recursive: true, force: true });
+}
+function wikiStats() {
+  const slugs = listPageSlugs();
+  let bytes = 0;
+  for (const slug of slugs) {
     try {
-      body = await res.text();
+      bytes += statSync3(pagePath(slug)).size;
     } catch {
     }
-    return { ok: false, text: `Ollama error ${res.status}: ${body.slice(0, 200)}` };
-  }
-  try {
-    const data = await res.json();
-    const text = (data.response || "").trim();
-    if (text) return { ok: true, text };
-    return { ok: false, text: "Local model returned an empty reply." };
-  } catch (e) {
-    return { ok: false, text: `Could not parse Ollama reply: ${e.message}` };
   }
+  return { pages: slugs.length, bytes, lastSyncTs: loadState().lastSyncTs };
 }
-function pullHint(model) {
-  return `ollama pull ${model}`;
+function factRows() {
+  return loadTurns().filter((t) => t.role === "fact" && t.session !== WIKI_SESSION).map((t) => ({ id: t.id, content: t.content, ts: t.ts }));
 }
-
-// src/wiki.ts
-import {
-  readFileSync as readFileSync10,
-  writeFileSync as writeFileSync8,
-  existsSync as existsSync9,
-  mkdirSync as mkdirSync7,
-  rmSync as rmSync4,
-  readdirSync as readdirSync2,
-  statSync as statSync3
-} from "fs";
-import { join as join9 } from "path";
-import { totalmem } from "os";
-function wikiDir() {
-  return join9(wsHoltDir(), "wiki");
+var RAM_RECOMMENDATIONS = [
+  { minGiB: 48, model: "qwen2.5:32b", note: "plenty of headroom for a large local model (~20GB)." },
+  { minGiB: 24, model: "qwen2.5:14b", note: "a 14B model (~9GB) fits comfortably." },
+  { minGiB: 16, model: "qwen2.5:7b", note: "default. ~4.7GB; tight alongside the embed model + editor. An always-on machine is a better host. Alternative: llama3.1:8b." },
+  { minGiB: 0, model: "llama3.2:3b", note: "under 16GB, local is discouraged; if you insist, this ~2GB model is modest quality. The brain maintainer is the better default." }
+];
+function totalGiB() {
+  return Math.round(totalmem() / 1024 ** 3 * 10) / 10;
 }
-function wikiStatePath() {
-  return join9(wikiDir(), ".state.json");
+function recommendLocalModel(gib = totalGiB()) {
+  const tier = RAM_RECOMMENDATIONS.find((r) => gib >= r.minGiB) ?? RAM_RECOMMENDATIONS[RAM_RECOMMENDATIONS.length - 1];
+  return {
+    gib,
+    model: tier.model,
+    note: tier.note,
+    pull: pullHint(tier.model),
+    discourageLocal: gib < 16
+  };
 }
-function wikiIndexPath() {
-  return join9(wikiDir(), "index.md");
+
+// src/output.ts
+import { writeFileSync as writeFileSync8 } from "fs";
+import { join as join9, isAbsolute } from "path";
+function escapeHtml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
-function pagePath(slug) {
-  return join9(wikiDir(), `${slug}.md`);
+function renderInline(text) {
+  const codes = [];
+  let s = text.replace(/`([^`]+)`/g, (_m, code) => {
+    codes.push(`<code>${escapeHtml(code)}</code>`);
+    return `\0${codes.length - 1}\0`;
+  });
+  s = escapeHtml(s);
+  s = s.replace(/\[([^\]]+)\]\((\S*?(?:\([^)\s]*\)[^)\s]*)*)\)/g, (_m, label, url) => {
+    const trimmed = url.trim();
+    const scheme = /^([a-z][a-z0-9+.-]*):/i.exec(trimmed);
+    const safeScheme = !scheme || /^(https?|mailto)$/i.test(scheme[1]);
+    if (!safeScheme) return label;
+    const safe = trimmed.replace(/"/g, "%22");
+    return `<a href="${safe}">${label}</a>`;
+  });
+  s = s.replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+  s = s.replace(/\*([^*]+)\*/g, "<em>$1</em>");
+  s = s.replace(/(\d+)/g, (_m, i) => codes[Number(i)] ?? "");
+  return s;
 }
-function loadState() {
-  try {
-    const s = JSON.parse(readFileSync10(wikiStatePath(), "utf8"));
-    return { lastSyncTs: typeof s.lastSyncTs === "number" ? s.lastSyncTs : 0, updatedAt: s.updatedAt ?? 0 };
-  } catch {
-    return { lastSyncTs: 0, updatedAt: 0 };
+function markdownToHtmlBody(md) {
+  const lines = md.replace(/\r\n/g, "\n").split("\n");
+  const out = [];
+  let i = 0;
+  let listOpen = false;
+  let paragraph = [];
+  const flushParagraph = () => {
+    if (paragraph.length) {
+      out.push(`<p>${renderInline(paragraph.join(" "))}</p>`);
+      paragraph = [];
+    }
+  };
+  const closeList = () => {
+    if (listOpen) {
+      out.push("</ul>");
+      listOpen = false;
+    }
+  };
+  while (i < lines.length) {
+    const line = lines[i] ?? "";
+    const fence = line.match(/^```(.*)$/);
+    if (fence) {
+      flushParagraph();
+      closeList();
+      const code = [];
+      i++;
+      while (i < lines.length && !/^```/.test(lines[i] ?? "")) {
+        code.push(lines[i] ?? "");
+        i++;
+      }
+      i++;
+      out.push(`<pre><code>${escapeHtml(code.join("\n"))}</code></pre>`);
+      continue;
+    }
+    const h = line.match(/^(#{1,3})\s+(.*)$/);
+    if (h) {
+      flushParagraph();
+      closeList();
+      const level = (h[1] ?? "#").length;
+      out.push(`<h${level}>${renderInline((h[2] ?? "").trim())}</h${level}>`);
+      i++;
+      continue;
+    }
+    const li = line.match(/^\s*[-*]\s+(.*)$/);
+    if (li) {
+      flushParagraph();
+      if (!listOpen) {
+        out.push("<ul>");
+        listOpen = true;
+      }
+      out.push(`<li>${renderInline((li[1] ?? "").trim())}</li>`);
+      i++;
+      continue;
+    }
+    if (line.trim() === "") {
+      flushParagraph();
+      closeList();
+      i++;
+      continue;
+    }
+    closeList();
+    paragraph.push(line.trim());
+    i++;
   }
+  flushParagraph();
+  closeList();
+  return out.join("\n");
 }
-function saveState(s) {
-  mkdirSync7(wikiDir(), { recursive: true });
-  writeFileSync8(wikiStatePath(), JSON.stringify(s, null, 2) + "\n", "utf8");
-}
-function saveSyncMarker(ts) {
-  saveState({ lastSyncTs: ts, updatedAt: Date.now() });
-}
-function isPageFile(name) {
-  return name.endsWith(".md") && name !== "index.md";
+function wrapHtmlPage(body, title = "Holt reply") {
+  return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${escapeHtml(title)}</title>
+<style>
+  :root { --bg:#0f1115; --fg:#e7e9ee; --accent:#f0b91e; }
+  * { box-sizing: border-box; }
+  body { margin:0; padding:2rem 1.25rem; background:var(--bg); color:var(--fg);
+         font:16px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif; }
+  main { max-width: 760px; margin: 0 auto; }
+  h1,h2,h3 { color:var(--accent); line-height:1.25; margin:1.4em 0 .5em; }
+  h1 { font-size:1.6rem; } h2 { font-size:1.3rem; } h3 { font-size:1.1rem; }
+  a { color:var(--accent); }
+  code { background:#1b1e26; padding:.1em .35em; border-radius:4px; font-size:.9em; }
+  pre { background:#1b1e26; padding:1rem; border-radius:8px; overflow:auto; }
+  pre code { background:none; padding:0; }
+  ul { padding-left:1.3rem; }
+  p { margin:.7em 0; }
+</style>
+</head>
+<body>
+<main>
+${body}
+</main>
+</body>
+</html>
+`;
 }
-function listPageSlugs() {
-  const dir = wikiDir();
-  if (!existsSync9(dir)) return [];
-  try {
-    return readdirSync2(dir).filter(isPageFile).map((f) => f.slice(0, -3)).sort();
-  } catch {
-    return [];
-  }
+function renderReply(reply, format) {
+  if (format === "html") return wrapHtmlPage(markdownToHtmlBody(reply));
+  return reply.endsWith("\n") ? reply : reply + "\n";
 }
-function readPage(slug) {
-  const p = pagePath(slug);
-  if (!existsSync9(p)) return null;
-  let raw = "";
-  try {
-    raw = readFileSync10(p, "utf8");
-  } catch {
-    return null;
-  }
-  const { data, body } = parseFrontmatter(raw);
-  return {
-    slug,
-    title: data.title || slug,
-    updated: data.updated || "",
-    sources: parseSources(data.sources),
-    body
-  };
+function timestamp() {
+  const d = /* @__PURE__ */ new Date();
+  const p = (n) => String(n).padStart(2, "0");
+  return `${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}-${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`;
 }
-function loadPages() {
-  const out = [];
-  for (const slug of listPageSlugs()) {
-    const pg = readPage(slug);
-    if (pg) out.push(pg);
+function saveReply(reply, format, name) {
+  const ext = format === "html" ? ".html" : ".md";
+  let base = (name ?? "").trim();
+  if (!base) base = `holt-reply-${timestamp()}`;
+  if (isAbsolute(base) || /[\\/]/.test(base) || base === "." || base === "..") {
+    throw new Error('name must be a plain file name in this folder (no "/", "\\", or "..").');
   }
-  return out;
+  if (!/\.[a-z0-9]+$/i.test(base)) base += ext;
+  const path = join9(process.cwd(), base);
+  writeFileSync8(path, renderReply(reply, format), "utf8");
+  return path;
 }
-function parseSources(raw) {
-  if (!raw) return [];
-  return raw.replace(/^\[|\]$/g, "").split(/[\s,]+/).map((s) => s.replace(/^["']|["']$/g, "").trim()).filter(Boolean);
+
+// src/commands/chat.ts
+function statusLine(brainLabel, history) {
+  const live = Math.min(history.length, MAX_REPLAY_TURNS);
+  const frac = MAX_REPLAY_TURNS ? live / MAX_REPLAY_TURNS : 0;
+  const pct = Math.round(frac * 100);
+  const mem = memStats().turns;
+  return c.dim("  " + brainLabel + "  ") + c.dim("[") + bar(frac) + c.dim("]") + c.dim(`  ${pct}% context  \xB7  ${mem} in memory`);
 }
-var PAGE_HEADER_NOTE = "Derived page, maintained by Holt. Safe to edit; a rebuild will regenerate it from facts.";
-function renderPage(pg) {
-  const fm = [
-    "---",
-    `title: ${pg.title}`,
-    `updated: ${pg.updated}`,
-    `sources: ${pg.sources.join(", ")}`,
-    "---",
-    "",
-    `> ${PAGE_HEADER_NOTE}`,
-    "",
-    pg.body.trim(),
-    ""
-  ].join("\n");
-  return fm;
+function help() {
+  console.log(c.dim([
+    "  commands:",
+    "    /brain [name]     switch brain (CLI or API). context is kept.",
+    "    /memory [query]   memory stats, or preview what a query would recall",
+    '    /skill [name] [input]  run a skill, or list them. "holt skill" manages them.',
+    "    /output [fmt]     show or set output format: markdown | html",
+    "    /save [name]      save the last reply to a file in this folder",
+    "    /setting          configure brains, API brains, and your launch command",
+    "    /clear            forget this session so far (saved memory stays)",
+    "    /help             this list",
+    "    /exit             leave"
+  ].join("\n")));
 }
-function writePage(pg) {
-  mkdirSync7(wikiDir(), { recursive: true });
-  writeFileSync8(pagePath(pg.slug), renderPage(pg), "utf8");
+function resolveActive2(cfg, id) {
+  if (BRAIN_IDS.includes(id)) {
+    const b = cfg.brains[id];
+    return { kind: "cli", id, label: b.label };
+  }
+  const api = findApiBrain(cfg, id);
+  if (api) return { kind: "api", id, label: `${id} (api: ${api.provider}/${api.model})`, brain: api };
+  return null;
 }
-var WIKILINK_RE = /\[\[([^\]]+)\]\]/g;
-function extractLinks(body) {
-  const out = [];
-  let m;
-  WIKILINK_RE.lastIndex = 0;
-  while ((m = WIKILINK_RE.exec(body)) !== null) {
-    const target = (m[1] || "").split("|")[0].trim();
-    if (target) out.push(target);
+async function chat() {
+  const { ask, close } = createReader();
+  if (!await ensureTrusted(ask)) {
+    close();
+    return;
+  }
+  let cfg = loadConfig();
+  if (!cfg || !cfg.defaultBrain) {
+    const a = (await ask(c.dim("No Holt setup in this folder. Set it up now? [Y/n] ")) ?? "").trim().toLowerCase();
+    close();
+    if (a === "n" || a === "no") {
+      console.log(c.dim('  Run "holt init" here when ready.\n'));
+      return;
+    }
+    await init();
+    console.log(c.dim('\nSetup done. Run "holt chat" to start talking.\n'));
+    return;
+  }
+  let active = resolveActive2(cfg, cfg.defaultBrain);
+  if (!active) {
+    const fallback = BRAIN_IDS.find((id) => cfg.brains[id].enabled) ?? cfg.apiBrains[0]?.id ?? null;
+    active = fallback ? resolveActive2(cfg, fallback) : null;
+    if (!active) {
+      close();
+      console.log(c.dim('\nNo brain is ready. Run "holt setting".\n'));
+      return;
+    }
+  }
+  const session = newSessionId();
+  const history = [];
+  let lastReply = "";
+  const embedOk = await embeddingsAvailable();
+  const stats = memStats();
+  console.log("\n" + c.accent("Holt") + c.dim(`  brain: ${active.label}`));
+  console.log(c.dim(
+    `Memory: ${stats.turns} moments (${stats.facts} facts) from ${stats.sessions} session${stats.sessions === 1 ? "" : "s"} in this folder (recall: ${embedOk ? "embeddings via local Ollama" : "keyword match"}).`
+  ));
+  if (embedOk && stats.withEmbeddings < stats.turns) {
+    console.log(c.dim(`  ${stats.turns - stats.withEmbeddings} older moments lack embeddings. Run "holt memory embed" to upgrade them.`));
+  }
+  console.log(c.dim("Type a message. Commands: /brain  /memory  /output  /save  /setting  /clear  /help  /exit"));
+  console.log(statusLine(active.label, history) + "\n");
+  while (true) {
+    const raw = await ask(c.accent("\u203A "));
+    if (raw === null) break;
+    const line = raw.trim();
+    if (!line) continue;
+    let promptOverride = null;
+    if (/^\/skills?\s+\S/.test(line)) {
+      const inv = resolveSkillInvocation(line.replace(/^\/skills\b/, "/skill"));
+      if (!inv) {
+        console.log(c.dim('  no such skill. Try "holt skill list".'));
+        continue;
+      }
+      promptOverride = inv.prompt;
+      console.log(c.dim(`  running skill "${inv.skillName}"...`));
+    } else if (line.startsWith("/")) {
+      const parts = line.slice(1).split(/\s+/);
+      const cmd = (parts[0] || "").toLowerCase();
+      const rest = parts.slice(1).join(" ");
+      const arg = (parts[1] || "").toLowerCase();
+      if (cmd === "exit" || cmd === "quit" || cmd === "q") break;
+      if (cmd === "help" || cmd === "h") {
+        help();
+        continue;
+      }
+      if (cmd === "clear") {
+        history.length = 0;
+        console.log(c.dim("  session context cleared. Saved memory is untouched."));
+        continue;
+      }
+      if (cmd === "memory" || cmd === "mem") {
+        if (rest) {
+          const hits = await recall(rest, session, 5);
+          if (hits.length === 0) console.log(c.dim("  nothing relevant in memory for that."));
+          else for (const h of hits) console.log(c.dim(`  ${h.score.toFixed(2)}  (${h.turn.role}) ${h.turn.content.slice(0, 110).replace(/\s+/g, " ")}`));
+        } else {
+          const s = memStats();
+          console.log(c.dim(`  ${s.turns} moments, ${s.facts} facts, ${s.sessions} sessions, ${s.withEmbeddings} embedded, ${(s.bytes / 1024).toFixed(1)} KB in ./.holt/memory/`));
+          console.log(c.dim('  usage: /memory <query> to preview recall, or "holt memory clear" to wipe.'));
+        }
+        continue;
+      }
+      if (cmd === "output") {
+        const want = arg;
+        if (want === "markdown" || want === "md") {
+          cfg.outputFormat = "markdown";
+          saveConfig(cfg);
+          console.log(c.green("  output format: markdown"));
+        } else if (want === "html") {
+          cfg.outputFormat = "html";
+          saveConfig(cfg);
+          console.log(c.green("  output format: html"));
+        } else if (want) console.log(c.dim("  usage: /output markdown | html"));
+        else console.log(c.dim(`  output format: ${cfg.outputFormat}  (change with /output markdown | html)`));
+        continue;
+      }
+      if (cmd === "save") {
+        if (!lastReply) {
+          console.log(c.dim("  nothing to save yet. Ask something first."));
+          continue;
+        }
+        try {
+          const path = saveReply(lastReply, cfg.outputFormat, rest || void 0);
+          console.log(c.green(`  saved ${cfg.outputFormat} to ${path}`));
+        } catch (e) {
+          console.log(c.red(`  could not save: ${e.message}`));
+        }
+        continue;
+      }
+      if (cmd === "setting" || cmd === "settings") {
+        cfg = await runSettings(ask);
+        const next = cfg.defaultBrain ? resolveActive2(cfg, cfg.defaultBrain) : null;
+        const stillValid = resolveActive2(cfg, active.id);
+        active = stillValid ?? next ?? active;
+        console.log(c.dim(`  brain: ${active.label}`));
+        continue;
+      }
+      if (cmd === "brain") {
+        const cliEnabled = BRAIN_IDS.filter((id) => cfg.brains[id].enabled);
+        const apiIds = cfg.apiBrains.map((a) => a.id);
+        const all = [...cliEnabled, ...apiIds];
+        const rawArg = parts[1] || "";
+        const match = all.find((id) => id.toLowerCase() === rawArg.toLowerCase());
+        if (rawArg && match) {
+          const next = resolveActive2(cfg, match);
+          if (next) {
+            active = next;
+            const turns = Math.floor(history.length / 2);
+            console.log(c.green(`  switched to ${active.label}. Context kept (${turns} turn${turns === 1 ? "" : "s"}).`));
+          }
+        } else if (rawArg) {
+          console.log(c.dim(`  "${rawArg}" is not available. Available: ${all.join(", ") || "none"}`));
+        } else {
+          const cfgRef = cfg;
+          const activeId = active.id;
+          const labels = all.map((id) => {
+            const a = findApiBrain(cfgRef, id);
+            const shown = a ? `${id} (api: ${a.provider}/${a.model})` : id;
+            return id === activeId ? c.accent(shown + " (current)") : shown;
+          });
+          console.log(c.dim("  brains: " + labels.join("   ")));
+          console.log(c.dim("  usage: /brain <name>"));
+        }
+        continue;
+      }
+      if (cmd === "skill" || cmd === "skills") {
+        const names = listSkills().map((s) => s.name);
+        console.log(c.dim("  skills: " + (names.join("  ") || "none") + "   usage: /skill <name> [input]"));
+        continue;
+      }
+      console.log(c.dim(`  unknown command: /${cmd}  (try /help)`));
+      continue;
+    }
+    if (active.kind === "cli" && !isInstalled(cfg.brains[active.id].command)) {
+      console.log(c.red(`  ${active.label} (${cfg.brains[active.id].command}) is not on your PATH. Use /brain to switch or /setting.`));
+      continue;
+    }
+    if (active.kind === "api" && !resolveApiKey(active.brain)) {
+      console.log(c.red(`  ${active.label} has no API key. Use /setting to add one, or /brain to switch.`));
+      continue;
+    }
+    const remembered = await recall(line, session, 4);
+    const label = remembered.length ? `${active.label} is thinking (recalled ${remembered.length} moment${remembered.length === 1 ? "" : "s"})...` : `${active.label} is thinking...`;
+    console.log(c.dim(`  ${label}`) + "\n");
+    const skillsBlock = skillsPromptBlock();
+    const base = renderPrompt(history, line, remembered);
+    const prompt = promptOverride ?? (skillsBlock ? skillsBlock + "\n\n" + base : base);
+    let streamed = false;
+    const onChunk = (chunk2) => {
+      streamed = true;
+      process.stdout.write(chunk2);
+    };
+    const res = active.kind === "cli" ? await runBrain(cfg.brains[active.id], prompt, onChunk) : await runApiBrain(active.brain, prompt, onChunk);
+    if (res.ok) {
+      if (!streamed) console.log(res.text);
+      if (!res.text.endsWith("\n")) console.log("");
+      console.log("");
+      lastReply = res.text;
+      history.push({ role: "user", content: line });
+      history.push({ role: "assistant", content: res.text });
+      const now = Date.now();
+      appendTurn({ id: randomUUID3().slice(0, 8), ts: now, session, role: "user", content: line, emb: await embed(line) ?? void 0 });
+      appendTurn({ id: randomUUID3().slice(0, 8), ts: now, session, role: "assistant", content: res.text, emb: await embed(res.text) ?? void 0 });
+      console.log(statusLine(active.label, history) + "\n");
+    } else {
+      console.log(c.red("\n  " + res.text + "\n"));
+    }
   }
-  return out;
-}
-function cosine2(a, b) {
-  let dot = 0;
-  let na = 0;
-  let nb = 0;
-  const n = Math.min(a.length, b.length);
-  for (let i = 0; i < n; i++) {
-    const x = a[i];
-    const y = b[i];
-    dot += x * y;
-    na += x * x;
-    nb += y * y;
+  if (cfg.memory?.extractFacts !== false) {
+    try {
+      const arg = active.kind === "cli" ? { kind: "cli", id: active.id } : { kind: "api", brain: active.brain };
+      const n = await extractAndSaveFacts(arg, cfg, history, session);
+      if (n > 0) console.log(c.dim(`  distilled ${n} fact${n === 1 ? "" : "s"} from this session.`));
+    } catch {
+    }
   }
-  return na && nb ? dot / (Math.sqrt(na) * Math.sqrt(nb)) : 0;
+  if (cfg.wiki?.autoSync) {
+    try {
+      const res = await syncWiki(cfg, () => resolveBrainMaintainer(cfg));
+      if (res.status === "ok" && res.changed) console.log(c.dim("  updated the wiki."));
+    } catch {
+    }
+  }
+  close();
+  console.log(c.dim("\nBye.\n"));
 }
-var ROUTE_SIMILARITY_THRESHOLD = 0.55;
-async function pageEmbeddings(pages) {
-  const out = [];
-  for (const page of pages) {
-    const emb = await embed(`${page.title}
-${page.body.slice(0, 1500)}`);
-    if (emb) out.push({ page, emb });
+
+// src/commands/login.ts
+async function login(which) {
+  const id = (which || "").toLowerCase();
+  if (!BRAIN_IDS.includes(id)) {
+    if (which) {
+      console.error(`
+  Unknown brain "${which}". Use one of: ${BRAIN_IDS.join(", ")}
+`);
+      process.exitCode = 1;
+    } else {
+      console.log(c.dim(`
+  Usage: holt login <${BRAIN_IDS.join("|")}>
+`));
+    }
+    return;
   }
-  return out;
+  const s = BRAIN_SETUP[id];
+  console.log("\n" + c.accent(`Sign in to ${BRAIN_DEFS[id].label}`));
+  console.log(c.dim(`  Starting "${s.login.join(" ")}". Complete sign-in, then exit that tool.
+`));
+  await runInteractive(s.login[0], s.login.slice(1));
 }
-async function routeFact(content, targets) {
-  const e = await embed(content);
-  if (!e) {
-    return { kind: targets.length ? "existing" : "new", slug: targets[0]?.page.slug ?? "notes", score: 0 };
+
+// src/commands/memory.ts
+import { existsSync as existsSync9, readFileSync as readFileSync10 } from "fs";
+import { basename } from "path";
+async function memoryCmd(sub, rest = []) {
+  const { ask, close } = createReader();
+  if (!await ensureTrusted(ask)) {
+    close();
+    return;
   }
-  let best = null;
-  let bestScore = -1;
-  for (const t of targets) {
-    const s = cosine2(e, t.emb);
-    if (s > bestScore) {
-      bestScore = s;
-      best = t;
+  const action = (sub || "").toLowerCase();
+  if (action === "clear") {
+    const s2 = memStats();
+    if (s2.turns === 0) {
+      console.log(c.dim("\n  Memory is already empty.\n"));
+      close();
+      return;
     }
+    const a = (await ask(`
+  Delete all ${s2.turns} remembered moments in this folder? [y/N] `) ?? "").trim().toLowerCase();
+    if (a === "y" || a === "yes") {
+      clearMemory();
+      console.log(c.green("  Memory cleared.\n"));
+    } else console.log(c.dim("  Kept.\n"));
+    close();
+    return;
   }
-  if (best && bestScore >= ROUTE_SIMILARITY_THRESHOLD) {
-    return { kind: "existing", slug: best.page.slug, score: bestScore };
-  }
-  return { kind: "new", slug: proposeSlug(content), score: bestScore < 0 ? 0 : bestScore };
-}
-function proposeSlug(content) {
-  const words2 = content.toLowerCase().replace(/[^a-z0-9\s-]/g, " ").split(/\s+/).filter((w) => w.length > 2 && !ROUTE_STOPWORDS.has(w)).slice(0, 4);
-  const slug = sanitizeName(words2.join("-"));
-  return slug || "notes";
-}
-var ROUTE_STOPWORDS = /* @__PURE__ */ new Set([
-  "the",
-  "and",
-  "that",
-  "this",
-  "with",
-  "from",
-  "for",
-  "was",
-  "are",
-  "has",
-  "have",
-  "will",
-  "user",
-  "their",
-  "they",
-  "about",
-  "into",
-  "per",
-  "via"
-]);
-async function resolveMaintainer(cfg, resolveBrain) {
-  if (cfg.wiki.maintainer === "local") {
-    const model = cfg.wiki.localModel;
-    const status2 = await localModelStatus(model);
-    if (status2.reachable && status2.hasModel) {
-      const m = { kind: "local", model, label: `local (${model})` };
-      return { maintainer: m, report: { maintainer: m, fellBack: false } };
+  if (action === "embed") {
+    if (!await embeddingsAvailable()) {
+      console.log(c.dim(`
+  No local Ollama with ${EMBED_MODEL} reachable. Run "holt init" to set it up.
+`));
+      close();
+      return;
     }
-    const why = status2.reachable ? `local model "${model}" is not pulled. Run: ${pullHint(model)}` : "local Ollama is not reachable.";
-    const brain2 = resolveBrain();
-    if (brain2) {
-      return {
-        maintainer: brain2,
-        report: { maintainer: brain2, fellBack: true, note: `${why} Falling back to ${brain2.label}.` }
-      };
+    const missing = loadTurns().filter((t) => !Array.isArray(t.emb)).length;
+    if (missing === 0) {
+      console.log(c.dim("\n  All memories already have embeddings.\n"));
+      close();
+      return;
     }
-    return { maintainer: null, report: null };
+    console.log("");
+    const r = await backfillEmbeddings((done, total) => {
+      process.stdout.write(`\r  embedding ${done}/${total}...`);
+    });
+    console.log("\n" + c.green(`  Done. ${r.embedded} of ${r.total} memories embedded.`) + "\n");
+    close();
+    return;
   }
-  const brain = resolveBrain();
-  if (!brain) return { maintainer: null, report: null };
-  return { maintainer: brain, report: { maintainer: brain, fellBack: false } };
-}
-async function runMaintainer(m, cfg, prompt) {
-  if (m.kind === "cli") return runBrain(cfg.brains[m.id], prompt);
-  if (m.kind === "api") return runApiBrain(m.brain, prompt);
-  const r = await localGenerate(m.model, prompt);
-  return { ok: r.ok, text: r.text };
-}
-function buildPagePrompt(title, existingBody, facts, otherTitles) {
-  const lines = [
-    `You maintain a personal knowledge wiki. Write or update ONE page titled "${title}".`,
-    "Output ONLY the page body in Markdown. No frontmatter, no code fences, no preamble.",
-    "",
-    "Rules:",
-    "- Synthesize the facts into concise, self-contained prose (a few short paragraphs or tight bullets).",
-    "- Merge new facts into the existing text; do not just append. Resolve overlaps. Keep it current.",
-    "- Do not invent anything beyond the facts given.",
-    '- End with a line "## Related" followed by [[Wiki Page]] links to other pages that connect.',
-    "- Use [[double-bracket]] links for any other page you reference."
-  ];
-  if (otherTitles.length) {
-    lines.push("", "Other existing pages you may link to:", ...otherTitles.map((t) => `- ${t}`));
+  if (action === "facts") {
+    if (!existsSync9(factsMdPath())) {
+      console.log(c.dim("\n  No facts distilled yet. They form when you end a chat session.\n"));
+      close();
+      return;
+    }
+    const body = readFileSync10(factsMdPath(), "utf8").trim();
+    console.log("\n" + body + "\n");
+    close();
+    return;
   }
-  if (existingBody.trim()) {
-    lines.push("", "Current page body:", existingBody.trim());
+  if (action === "search") {
+    const q = rest.join(" ").trim();
+    if (!q) {
+      console.log(c.dim("\n  Usage: holt memory search <query>\n"));
+      close();
+      return;
+    }
+    const hits = await recall(q, "__none__", 8);
+    console.log("");
+    if (hits.length === 0) console.log(c.dim("  Nothing relevant found."));
+    else for (const h of hits) {
+      const when = new Date(h.turn.ts).toISOString().slice(0, 10);
+      const src = h.workspace ? c.dim(` [${basename(h.workspace)}]`) : "";
+      console.log(
+        `  ${c.accent(h.score.toFixed(2))}  ${c.dim(when)}  (${h.turn.role})${src} ${h.turn.content.slice(0, 100).replace(/\s+/g, " ")}`
+      );
+    }
+    console.log("");
+    close();
+    return;
   }
-  lines.push("", "New facts to integrate:", ...facts.map((f) => `- ${f}`), "", "Updated page body:");
-  return lines.join("\n");
-}
-function renderIndex(pages) {
-  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  const lines = [
-    "---",
-    "title: Wiki Index",
-    `updated: ${today}`,
-    "---",
-    "",
-    "# Wiki",
-    "",
-    "Derived knowledge for this folder. Pages are synthesized from `facts.md` and",
-    "`turns.jsonl` and are regenerable with `holt wiki rebuild`. Open in Obsidian to",
-    "browse the [[links]].",
-    ""
-  ];
-  if (pages.length === 0) {
-    lines.push("_No pages yet. Run `holt wiki sync` after chatting._", "");
-    return lines.join("\n");
+  if (action === "global") {
+    globalCmd((rest[0] || "").toLowerCase(), rest.slice(1));
+    close();
+    return;
   }
-  lines.push("## Pages", "");
-  for (const pg of [...pages].sort((a, b) => a.title.localeCompare(b.title))) {
-    const when = pg.updated ? ` _(updated ${pg.updated})_` : "";
-    lines.push(`- [[${pg.title}]]${when}`);
+  if (action && !["clear", "embed", "facts", "search", "global"].includes(action)) {
+    console.error(`
+  Unknown memory subcommand: "${sub}". Use: search <query> | facts | embed | global | clear
+`);
+    process.exitCode = 1;
+    close();
+    return;
   }
-  lines.push("");
-  return lines.join("\n");
-}
-function writeIndex(pages) {
-  mkdirSync7(wikiDir(), { recursive: true });
-  writeFileSync8(wikiIndexPath(), renderIndex(pages), "utf8");
-}
-var WIKI_SESSION = "wiki";
-function wikiRowId(slug) {
-  return "wiki-" + sanitizeName(slug).slice(0, 24);
-}
-function dropWikiRows(slugs) {
-  const keep = loadTurns().filter((t) => !(t.session === WIKI_SESSION && slugs.has(t.id.replace(/^wiki-/, ""))));
-  return keep;
-}
-async function indexPagesForRecall(pages) {
-  try {
-    if (pages.length === 0) return;
-    const slugs = new Set(pages.map((p) => sanitizeName(p.slug).slice(0, 24)));
-    const kept = dropWikiRows(slugs);
-    mkdirSync7(join9(wsHoltDir(), "memory"), { recursive: true });
-    writeFileSync8(
-      join9(wsHoltDir(), "memory", "turns.jsonl"),
-      kept.map((t) => JSON.stringify(t)).join("\n") + (kept.length ? "\n" : ""),
-      "utf8"
-    );
-    for (const pg of pages) {
-      const content = `${pg.title}
-${pg.body}`.slice(0, 4e3);
-      appendTurn({
-        id: wikiRowId(pg.slug),
-        ts: Date.now(),
-        session: WIKI_SESSION,
-        role: "fact",
-        content,
-        emb: await embed(content) ?? void 0
-      });
-    }
-  } catch {
+  const s = memStats();
+  const embedOk = await embeddingsAvailable();
+  const sessions = new Set(loadTurns().map((t) => t.session)).size;
+  console.log("\n" + c.accent("Holt memory") + c.dim("  (this folder)"));
+  console.log(`  moments     ${s.turns}`);
+  console.log(`  facts       ${s.facts}  (./.holt/memory/facts.md)`);
+  console.log(`  sessions    ${sessions}`);
+  console.log(`  embedded    ${s.withEmbeddings} of ${s.turns}`);
+  console.log(`  size        ${(s.bytes / 1024).toFixed(1)} KB  (./.holt/memory/turns.jsonl)`);
+  console.log(`  recall via  ${embedOk ? "embeddings (local Ollama)" : "keyword match (start Ollama with an embed model for semantic recall)"}`);
+  if (embedOk && s.withEmbeddings < s.turns) {
+    console.log(c.dim(`
+  ${s.turns - s.withEmbeddings} moments lack embeddings. Run "holt memory embed" to upgrade them to semantic recall.`));
   }
+  const gEnabled = isGlobalEnabled(workspace());
+  console.log(`  global      ${gEnabled ? c.green("on") + c.dim("  (contributes + reads shared facts)") : c.dim("off  (this folder is isolated, the default)")}`);
+  console.log(c.dim("\n  holt memory search <query>   find remembered moments"));
+  console.log(c.dim("  holt memory facts            show distilled facts (facts.md)"));
+  console.log(c.dim("  holt memory embed            embed older memories for semantic recall"));
+  console.log(c.dim("  holt memory global           share high-value facts across your folders"));
+  console.log(c.dim("  holt memory clear            wipe this folder's memory\n"));
+  close();
 }
-function clearWikiRecallRows() {
-  try {
-    const kept = loadTurns().filter((t) => t.session !== WIKI_SESSION);
-    mkdirSync7(join9(wsHoltDir(), "memory"), { recursive: true });
-    writeFileSync8(
-      join9(wsHoltDir(), "memory", "turns.jsonl"),
-      kept.map((t) => JSON.stringify(t)).join("\n") + (kept.length ? "\n" : ""),
-      "utf8"
-    );
-  } catch {
+function globalCmd(act, rest) {
+  const ws = workspace();
+  if (act === "on") {
+    const already = isGlobalEnabled(ws);
+    const added = enableGlobal(ws);
+    const g = globalStats();
+    if (already) console.log("\n" + c.green("  Global memory already on for this folder."));
+    else console.log("\n" + c.green("  Global memory ON for this folder."));
+    console.log(c.dim(`  Backfilled ${added} fact${added === 1 ? "" : "s"} into the shared store.`));
+    console.log(c.dim(`  New facts here mirror automatically; recall now spans ${g.workspaces} contributing folder${g.workspaces === 1 ? "" : "s"}.
+`));
+    return;
   }
-}
-function wipeWiki() {
-  if (existsSync9(wikiDir())) rmSync4(wikiDir(), { recursive: true, force: true });
-}
-function wikiStats() {
-  const slugs = listPageSlugs();
-  let bytes = 0;
-  for (const slug of slugs) {
-    try {
-      bytes += statSync3(pagePath(slug)).size;
-    } catch {
+  if (act === "off") {
+    const purge = rest.includes("--purge");
+    if (!isGlobalEnabled(ws) && !purge) {
+      console.log("\n" + c.dim("  Global memory is already off for this folder.\n"));
+      return;
     }
+    const { purged } = disableGlobal(ws, purge);
+    console.log("\n" + c.green("  Global memory OFF for this folder.") + c.dim("  (recall is local-only again)"));
+    if (purge) console.log(c.dim(`  Purged ${purged} of this folder's row${purged === 1 ? "" : "s"} from the shared store.`));
+    else console.log(c.dim("  This folder's rows stay in the shared store. Re-run with --purge to remove them."));
+    console.log("");
+    return;
   }
-  return { pages: slugs.length, bytes, lastSyncTs: loadState().lastSyncTs };
-}
-function factRows() {
-  return loadTurns().filter((t) => t.role === "fact" && t.session !== WIKI_SESSION).map((t) => ({ id: t.id, content: t.content, ts: t.ts }));
-}
-var RAM_RECOMMENDATIONS = [
-  { minGiB: 48, model: "qwen2.5:32b", note: "plenty of headroom for a large local model (~20GB)." },
-  { minGiB: 24, model: "qwen2.5:14b", note: "a 14B model (~9GB) fits comfortably." },
-  { minGiB: 16, model: "qwen2.5:7b", note: "default. ~4.7GB; tight alongside the embed model + editor. An always-on machine is a better host. Alternative: llama3.1:8b." },
-  { minGiB: 0, model: "llama3.2:3b", note: "under 16GB, local is discouraged; if you insist, this ~2GB model is modest quality. The brain maintainer is the better default." }
-];
-function totalGiB() {
-  return Math.round(totalmem() / 1024 ** 3 * 10) / 10;
-}
-function recommendLocalModel(gib = totalGiB()) {
-  const tier = RAM_RECOMMENDATIONS.find((r) => gib >= r.minGiB) ?? RAM_RECOMMENDATIONS[RAM_RECOMMENDATIONS.length - 1];
-  return {
-    gib,
-    model: tier.model,
-    note: tier.note,
-    pull: pullHint(tier.model),
-    discourageLocal: gib < 16
-  };
+  if (act === "" || act === "status") {
+    const enabled = isGlobalEnabled(ws);
+    const g = globalStats();
+    const contributors = globalWorkspaces();
+    console.log("\n" + c.accent("Holt global memory") + c.dim("  (opt-in, shared facts across your folders)"));
+    console.log(`  this folder    ${enabled ? c.green("on") : c.dim("off (isolated, the default)")}`);
+    console.log(`  contributing   ${g.workspaces} folder${g.workspaces === 1 ? "" : "s"}`);
+    console.log(`  shared facts   ${g.facts}`);
+    console.log(`  size           ${(g.bytes / 1024).toFixed(1)} KB  (${globalMemPath()})`);
+    console.log(`  registry       ${memoryScopesPath()}`);
+    if (contributors.length) {
+      console.log(c.dim("\n  Folders sharing facts:"));
+      for (const w of contributors) console.log(c.dim(`    ${basename(w)}  ${w === ws ? "(this folder)" : w}`));
+    }
+    console.log(c.dim("\n  holt memory global on          share this folder's facts + read others"));
+    console.log(c.dim("  holt memory global off         stop sharing + reading (add --purge to delete rows)"));
+    console.log(c.dim("  holt memory global status      this view\n"));
+    return;
+  }
+  console.error(`
+  Unknown "memory global" action: "${act}". Use: on | off [--purge] | status
+`);
+  process.exitCode = 1;
 }
 
 // src/commands/wiki.ts
-function resolveBrainMaintainer(cfg) {
-  const id = cfg.defaultBrain;
-  if (!id) return null;
-  if (BRAIN_IDS.includes(id)) {
-    const b = cfg.brains[id];
-    if (!isInstalled(b.command)) return null;
-    return { kind: "cli", id, label: b.label };
-  }
-  const api = findApiBrain(cfg, id);
-  if (api && resolveApiKey(api)) return { kind: "api", brain: api, label: `${id} (api: ${api.provider}/${api.model})` };
-  return null;
-}
+import { existsSync as existsSync10, readFileSync as readFileSync11 } from "fs";
+import { join as join10 } from "path";
+import { spawn as spawn3 } from "child_process";
 function titleToSlug(title) {
   return proposeSlug(title);
 }
-async function foldFacts(cfg, maintainer, facts) {
-  const summary = { created: 0, updated: 0, factsIntegrated: 0 };
-  if (facts.length === 0) return summary;
-  let pages = loadPages();
-  const targets = await pageEmbeddings(pages);
-  const groups = /* @__PURE__ */ new Map();
-  for (const f of facts) {
-    const decision = await routeFact(f.content, targets);
-    let slug = decision.slug;
-    let isNew = decision.kind === "new";
-    const existingGroup = groups.get(slug);
-    if (existingGroup) {
-      existingGroup.facts.push(f);
-    } else {
-      if (isNew && listPageSlugs().includes(slug)) isNew = false;
-      groups.set(slug, { slug, isNew, facts: [f] });
-    }
-  }
-  const knownTitles = new Set(pages.map((p) => p.title));
-  for (const group of groups.values()) {
-    knownTitles.add(readPage(group.slug)?.title ?? deriveTitle(group.facts[0].content, group.slug));
-  }
-  const changed = [];
-  for (const group of groups.values()) {
-    const existing = readPage(group.slug);
-    const title = existing?.title ?? deriveTitle(group.facts[0].content, group.slug);
-    const prompt = buildPagePrompt(
-      title,
-      existing?.body ?? "",
-      group.facts.map((f) => f.content),
-      [...knownTitles].filter((t) => t !== title)
-    );
-    const res = await runMaintainer(maintainer, cfg, prompt);
-    if (!res.ok || !res.text.trim()) {
-      continue;
-    }
-    const body = stripFrontmatterEcho(res.text);
-    const prevSources = existing?.sources ?? [];
-    const page = {
-      slug: group.slug,
-      title,
-      updated: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
-      sources: dedupe([...prevSources, ...group.facts.map((f) => f.id)]),
-      body
-    };
-    writePage(page);
-    changed.push(page);
-    if (existing) summary.updated++;
-    else summary.created++;
-    summary.factsIntegrated += group.facts.length;
-  }
-  pages = loadPages();
-  writeIndex(pages);
-  await indexPagesForRecall(changed);
-  return summary;
-}
-function dedupe(a) {
-  return [...new Set(a)];
-}
-function deriveTitle(content, slug) {
-  const fromSlug = slug.split("-").filter(Boolean).map((w) => w[0].toUpperCase() + w.slice(1)).join(" ");
-  return fromSlug || content.slice(0, 40);
-}
-function stripFrontmatterEcho(text) {
-  let s = text.trim();
-  s = s.replace(/^```(?:markdown|md)?\s*/i, "").replace(/```\s*$/i, "").trim();
-  if (s.startsWith("---")) {
-    const end = s.indexOf("\n---", 3);
-    if (end >= 0) s = s.slice(end + 4).trim();
-  }
-  return s;
-}
 async function syncCmd(cfg) {
-  const state = loadState();
-  const all = factRows();
-  const fresh = all.filter((f) => f.ts > state.lastSyncTs);
-  if (fresh.length === 0) {
+  const res = await syncWiki(cfg, () => resolveBrainMaintainer(cfg));
+  if (res.status === "nothing") {
     console.log(c.dim("\n  No new facts since the last sync. Nothing to do.\n"));
     return;
   }
-  const { maintainer, report } = await resolveMaintainer(cfg, () => resolveBrainMaintainer(cfg));
-  if (!maintainer) {
+  if (res.status === "no-maintainer") {
+    if (res.report?.note) console.log(c.dim("\n  " + res.report.note));
     console.log(c.red("\n  No maintainer available."));
     console.log(c.dim("  Configure a brain (holt init) or set wiki.maintainer to local with a pulled model.\n"));
     return;
   }
-  if (report?.note) console.log(c.dim("\n  " + report.note));
-  console.log("\n" + c.dim(`  Integrating ${fresh.length} new fact${fresh.length === 1 ? "" : "s"} via ${maintainer.label}...`));
-  const summary = await foldFacts(cfg, maintainer, fresh);
-  const newest = Math.max(state.lastSyncTs, ...fresh.map((f) => f.ts));
-  saveSyncMarker(newest);
+  const maintainer = res.maintainer;
+  if (res.report?.note) console.log(c.dim("\n  " + res.report.note));
+  console.log("\n" + c.dim(`  Integrated ${res.freshFacts} new fact${res.freshFacts === 1 ? "" : "s"} via ${maintainer.label}...`));
   console.log("\n" + c.accent("Wiki synced") + c.dim("  (this folder)"));
-  console.log(`  facts integrated  ${summary.factsIntegrated}`);
-  console.log(`  pages created     ${summary.created}`);
-  console.log(`  pages updated     ${summary.updated}`);
-  console.log(`  maintainer        ${maintainer.label}${report?.fellBack ? c.dim(" (fell back)") : ""}`);
+  console.log(`  facts integrated  ${res.factsIntegrated}`);
+  console.log(`  pages created     ${res.created}`);
+  console.log(`  pages updated     ${res.updated}`);
+  console.log(`  maintainer        ${maintainer.label}${res.report?.fellBack ? c.dim(" (fell back)") : ""}`);
   console.log(c.dim(`
   Wiki: ${wikiDir()}  (open in Obsidian to browse [[links]])
 `));
@@ -3330,7 +3367,7 @@ async function rebuildCmd(cfg, ask) {
   clearWikiRecallRows();
   console.log(c.dim(`
   Rebuilding from ${facts.length} facts via ${maintainer.label}...`));
-  const summary = await foldFacts(cfg, maintainer, facts);
+  const { summary } = await foldFacts(cfg, maintainer, facts);
   saveSyncMarker(Math.max(0, ...facts.map((f) => f.ts)));
   console.log("\n" + c.accent("Wiki rebuilt"));
   console.log(`  pages         ${summary.created}`);
@@ -3353,7 +3390,51 @@ function buildLintPrompt(pages) {
   for (const pg of pages) {
     lines.push("", `### ${pg.title} (${pg.slug})`, pg.body.slice(0, 1200));
   }
-  return lines.join("\n");
+  return lines.join("\n");
+}
+var FIX_BEGIN = "<<<HOLT-PAGE ";
+var FIX_END = "<<<HOLT-END>>>";
+function buildFixPrompt(pages) {
+  const lines = [
+    "You maintain a personal knowledge wiki. Fix quality issues across the pages",
+    "below: resolve CONTRADICTIONS (keep the most recent/consistent statement),",
+    "merge DUPLICATE passages, and add obvious missing [[wikilinks]]. Do not invent",
+    "new facts; only reconcile and de-duplicate what is already written.",
+    "",
+    "Return EVERY page, even unchanged ones, using EXACTLY this format and nothing",
+    "else (no prose, no code fences, no frontmatter):",
+    "",
+    `${FIX_BEGIN}<slug>>>>`,
+    '<corrected page body in Markdown, ending with a "## Related" section of [[links]]>',
+    FIX_END,
+    "",
+    "Pages:"
+  ];
+  for (const pg of pages) {
+    lines.push("", `${FIX_BEGIN}${pg.slug}>>>`, `### ${pg.title}`, pg.body.trim(), FIX_END);
+  }
+  return lines.join("\n");
+}
+function parseFixReply(raw) {
+  const out = /* @__PURE__ */ new Map();
+  const text = raw || "";
+  let i = 0;
+  while (true) {
+    const begin = text.indexOf(FIX_BEGIN, i);
+    if (begin < 0) break;
+    const slugStart = begin + FIX_BEGIN.length;
+    const slugEnd = text.indexOf(">>>", slugStart);
+    if (slugEnd < 0) break;
+    const slug = text.slice(slugStart, slugEnd).trim();
+    const bodyStart = slugEnd + 3;
+    const end = text.indexOf(FIX_END, bodyStart);
+    if (end < 0) break;
+    let body = text.slice(bodyStart, end).trim();
+    body = body.replace(/^###[^\n]*\n+/, "").trim();
+    if (slug && body) out.set(slug, body);
+    i = end + FIX_END.length;
+  }
+  return out;
 }
 async function lintCmd(cfg, fix) {
   const pages = loadPages();
@@ -3367,19 +3448,56 @@ async function lintCmd(cfg, fix) {
     return;
   }
   if (report?.note) console.log(c.dim("\n  " + report.note));
-  if (fix) {
-    console.log(c.dim("\n  Note: --fix can rewrite pages. Put .holt/wiki under git or back it up first."));
-    console.log(c.dim("  For now, lint proposes only; applying edits is left to a future release. Showing the report.\n"));
+  if (!fix) {
+    console.log(c.dim(`
+  Auditing ${pages.length} page${pages.length === 1 ? "" : "s"} via ${maintainer.label}...
+`));
+    const res2 = await runMaintainer(maintainer, cfg, buildLintPrompt(pages));
+    if (!res2.ok || !res2.text.trim()) {
+      console.log(c.dim("  Lint could not produce a report (maintainer returned nothing).\n"));
+      return;
+    }
+    console.log(res2.text.trim() + "\n");
+    return;
   }
+  console.log(c.dim("\n  --fix will rewrite affected pages. Put .holt/wiki under git or back it up first;"));
+  console.log(c.dim('  a bad fix is fully recoverable with "holt wiki rebuild".'));
   console.log(c.dim(`
-  Auditing ${pages.length} page${pages.length === 1 ? "" : "s"} via ${maintainer.label}...
+  Auditing + fixing ${pages.length} page${pages.length === 1 ? "" : "s"} via ${maintainer.label}...
 `));
-  const res = await runMaintainer(maintainer, cfg, buildLintPrompt(pages));
+  const res = await runMaintainer(maintainer, cfg, buildFixPrompt(pages));
   if (!res.ok || !res.text.trim()) {
-    console.log(c.dim("  Lint could not produce a report (maintainer returned nothing).\n"));
+    console.log(c.dim("  Lint --fix could not produce corrections (maintainer returned nothing). Files untouched.\n"));
+    return;
+  }
+  const corrected = parseFixReply(res.text);
+  if (corrected.size === 0) {
+    console.log(c.dim("  No parseable corrections returned. Files untouched.\n"));
+    return;
+  }
+  const byPage = new Map(pages.map((p) => [p.slug, p]));
+  const applied = [];
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  for (const [slug, body] of corrected) {
+    const page = byPage.get(slug);
+    if (!page) continue;
+    if (body.trim() === page.body.trim()) continue;
+    try {
+      writePage({ ...page, body: body.trim(), updated: today });
+      applied.push(page.title);
+    } catch {
+    }
+  }
+  if (applied.length === 0) {
+    console.log(c.dim("  Lint found nothing to change. Pages already clean.\n"));
     return;
   }
-  console.log(res.text.trim() + "\n");
+  console.log("\n" + c.accent("Wiki lint applied") + c.dim("  (this folder)"));
+  console.log(`  pages rewritten   ${applied.length}`);
+  for (const t of applied) console.log(c.dim(`    - ${t}`));
+  console.log(c.dim(`
+  Recover any page with "holt wiki rebuild". Wiki: ${wikiDir()}
+`));
 }
 function listCmd() {
   const slugs = listPageSlugs();
@@ -3420,6 +3538,7 @@ async function statusCmd(cfg) {
   console.log("\n" + c.accent("Holt wiki") + c.dim("  (this folder)"));
   console.log(`  maintainer    ${cfg.wiki.maintainer}`);
   console.log(`  localModel    ${cfg.wiki.localModel}`);
+  console.log(`  auto-sync     ${cfg.wiki.autoSync ? c.green("on") : c.dim("off")}${cfg.wiki.autoSync ? "" : c.dim("  (holt wiki auto on)")}`);
   console.log(`  pages         ${stats.pages}`);
   console.log(`  size          ${(stats.bytes / 1024).toFixed(1)} KB  (./.holt/wiki/)`);
   console.log(`  last sync     ${lastSync}`);
@@ -3434,11 +3553,33 @@ async function statusCmd(cfg) {
   if (rec.discourageLocal) console.log(c.dim("  Local maintenance is discouraged at this RAM; the brain maintainer is recommended."));
   console.log(c.dim(`  Pull it with: ${rec.pull}`));
   console.log(c.dim("\n  holt wiki sync              fold new facts into pages"));
+  console.log(c.dim("  holt wiki auto [on|off]     auto-sync the wiki when a session ends"));
   console.log(c.dim("  holt wiki rebuild           regenerate the whole wiki from facts"));
-  console.log(c.dim("  holt wiki lint              audit for contradictions, duplicates, gaps"));
+  console.log(c.dim("  holt wiki lint [--fix]      audit (and with --fix, apply) contradiction/duplicate fixes"));
   console.log(c.dim("  holt wiki list / show <p>   browse pages"));
   console.log(c.dim("  holt wiki open              open in your default app (Obsidian reads it natively)\n"));
 }
+function autoCmd(cfg, arg) {
+  const want = (arg || "").toLowerCase();
+  if (want === "") {
+    const on2 = cfg.wiki.autoSync === true;
+    console.log("\n" + c.accent("Wiki auto-sync") + c.dim("  (this folder)"));
+    console.log(`  ${on2 ? c.green("on") : c.dim("off")}`);
+    console.log(c.dim("  usage: holt wiki auto on | off"));
+    console.log(c.dim("  When on, the wiki folds new facts in automatically after a chat session"));
+    console.log(c.dim('  or when the Claude Code Stop hook captures facts. No manual "holt wiki sync".\n'));
+    return;
+  }
+  if (want !== "on" && want !== "off") {
+    console.log(c.dim("\n  usage: holt wiki auto on | off\n"));
+    return;
+  }
+  cfg.wiki.autoSync = want === "on";
+  saveConfig(cfg);
+  console.log(
+    want === "on" ? c.green("\n  wiki auto-sync: on") + c.dim("  (syncs at session end)\n") : c.dim("\n  wiki auto-sync: off\n")
+  );
+}
 function setupCmd(cfg) {
   const rec = recommendLocalModel();
   console.log("\n" + c.accent("Local wiki maintainer: model recommendation"));
@@ -3505,6 +3646,9 @@ async function wikiCmd(sub, rest = []) {
       case "sync":
         await syncCmd(cfg);
         break;
+      case "auto":
+        autoCmd(cfg, rest[0] ?? "");
+        break;
       case "rebuild":
         await rebuildCmd(cfg, ask);
         break;
@@ -3530,7 +3674,7 @@ async function wikiCmd(sub, rest = []) {
         break;
       default:
         console.error(`
-  Unknown wiki subcommand: "${sub}". Use: sync | rebuild | lint | list | show <page> | open | status | setup
+  Unknown wiki subcommand: "${sub}". Use: sync | auto | rebuild | lint | list | show <page> | open | status | setup
 `);
         process.exitCode = 1;
     }
@@ -3541,19 +3685,171 @@ async function wikiCmd(sub, rest = []) {
 
 // src/commands/skill.ts
 import {
-  mkdirSync as mkdirSync8,
-  writeFileSync as writeFileSync9,
-  readFileSync as readFileSync12,
-  existsSync as existsSync11,
+  mkdirSync as mkdirSync9,
+  writeFileSync as writeFileSync10,
+  readFileSync as readFileSync13,
+  existsSync as existsSync12,
   readdirSync as readdirSync3,
-  statSync as statSync4,
+  statSync as statSync5,
   rmSync as rmSync5,
   cpSync,
   mkdtempSync
 } from "fs";
-import { join as join11, resolve as resolve2 } from "path";
+import { join as join12, resolve as resolve3 } from "path";
 import { tmpdir } from "os";
 import { spawnSync as spawnSync2 } from "child_process";
+
+// src/registry.ts
+import { readFileSync as readFileSync12, writeFileSync as writeFileSync9, existsSync as existsSync11, mkdirSync as mkdirSync8, statSync as statSync4 } from "fs";
+import { join as join11, isAbsolute as isAbsolute2, resolve as resolve2 } from "path";
+import { pathToFileURL, fileURLToPath } from "url";
+var DEFAULT_REGISTRY_URL = "https://raw.githubusercontent.com/holt-os/registry/main/registry.json";
+var REGISTRY_REPO_URL = "https://github.com/holt-os/registry";
+var CACHE_TTL_MS = 60 * 60 * 1e3;
+function registryCachePath() {
+  return join11(GLOBAL_DIR, "registry-cache.json");
+}
+function registryUrl() {
+  const env = (process.env.HOLT_REGISTRY_URL || "").trim();
+  return env || DEFAULT_REGISTRY_URL;
+}
+function coerceRegistry(value) {
+  if (!value || typeof value !== "object") return null;
+  const obj = value;
+  const skillsRaw = Array.isArray(obj.skills) ? obj.skills : [];
+  const skills = [];
+  for (const row2 of skillsRaw) {
+    if (!row2 || typeof row2 !== "object") continue;
+    const r = row2;
+    const name = typeof r.name === "string" ? r.name.trim() : "";
+    const source = typeof r.source === "string" ? r.source.trim() : "";
+    if (!name || !source) continue;
+    const description = typeof r.description === "string" ? r.description.trim() : "";
+    const author = typeof r.author === "string" ? r.author.trim() : "";
+    const tags = Array.isArray(r.tags) ? r.tags.filter((t) => typeof t === "string").map((t) => t.trim()).filter(Boolean) : void 0;
+    const entry = { name, description, source, author };
+    if (tags && tags.length) entry.tags = tags;
+    skills.push(entry);
+  }
+  const version = typeof obj.version === "number" ? obj.version : 1;
+  return { version, skills };
+}
+function parseRegistry(text) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return null;
+  }
+  return coerceRegistry(parsed);
+}
+function readCache() {
+  try {
+    const path = registryCachePath();
+    if (!existsSync11(path)) return null;
+    const raw = JSON.parse(readFileSync12(path, "utf8"));
+    if (!raw || typeof raw.fetchedAt !== "number" || typeof raw.url !== "string") return null;
+    const registry = coerceRegistry(raw.registry);
+    if (!registry) return null;
+    return { fetchedAt: raw.fetchedAt, url: raw.url, registry };
+  } catch {
+    return null;
+  }
+}
+function writeCache(url, registry) {
+  try {
+    mkdirSync8(GLOBAL_DIR, { recursive: true });
+    const body = { fetchedAt: Date.now(), url, registry };
+    writeFileSync9(registryCachePath(), JSON.stringify(body, null, 2) + "\n", "utf8");
+  } catch {
+  }
+}
+function localPathFor(loc) {
+  if (loc.startsWith("file://")) {
+    try {
+      return fileURLToPath(loc);
+    } catch {
+      return null;
+    }
+  }
+  if (/^https?:\/\//i.test(loc)) return null;
+  return isAbsolute2(loc) ? loc : resolve2(loc);
+}
+var UNREACHABLE_MSG = "no registry reachable; set HOLT_REGISTRY_URL or the community registry is not live yet";
+function loadLocal(path) {
+  try {
+    if (!existsSync11(path)) {
+      return { registry: null, fromCache: false, error: UNREACHABLE_MSG };
+    }
+    const registry = parseRegistry(readFileSync12(path, "utf8"));
+    if (!registry) {
+      return { registry: null, fromCache: false, error: "registry file is not valid JSON" };
+    }
+    return { registry, fromCache: false };
+  } catch {
+    return { registry: null, fromCache: false, error: UNREACHABLE_MSG };
+  }
+}
+async function loadRemote(url) {
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(8e3) });
+    if (!res.ok) {
+      return { registry: null, fromCache: false, error: UNREACHABLE_MSG };
+    }
+    const registry = parseRegistry(await res.text());
+    if (!registry) {
+      return { registry: null, fromCache: false, error: "registry response is not valid JSON" };
+    }
+    return { registry, fromCache: false };
+  } catch {
+    return { registry: null, fromCache: false, error: UNREACHABLE_MSG };
+  }
+}
+async function loadRegistry(opts = {}) {
+  const url = registryUrl();
+  const cached = readCache();
+  const fresh = cached && cached.url === url && Date.now() - cached.fetchedAt < CACHE_TTL_MS;
+  if (!opts.refresh && fresh && cached) {
+    return { registry: cached.registry, fromCache: true };
+  }
+  const local = localPathFor(url);
+  const result = local ? loadLocal(local) : await loadRemote(url);
+  if (result.registry) {
+    writeCache(url, result.registry);
+    return result;
+  }
+  if (cached && cached.url === url) {
+    return { registry: cached.registry, fromCache: true, error: result.error };
+  }
+  return result;
+}
+function searchSkills(skills, query) {
+  const q = query.trim().toLowerCase();
+  if (!q) return [...skills].sort((a, b) => a.name.localeCompare(b.name));
+  const rank = (s) => {
+    if (s.name.toLowerCase().includes(q)) return 0;
+    if (s.description.toLowerCase().includes(q)) return 1;
+    if ((s.tags || []).some((t) => t.toLowerCase().includes(q))) return 2;
+    return 3;
+  };
+  return skills.map((s) => ({ s, r: rank(s) })).filter((x) => x.r < 3).sort((a, b) => a.r !== b.r ? a.r - b.r : a.s.name.localeCompare(b.s.name)).map((x) => x.s);
+}
+function resolveByName(skills, name) {
+  const want = name.trim().toLowerCase();
+  return skills.find((s) => s.name.toLowerCase() === want) || null;
+}
+function buildPublishEntry(input) {
+  const entry = {
+    name: input.name,
+    description: input.description,
+    source: input.source,
+    author: input.author
+  };
+  if (input.tags && input.tags.length) entry.tags = input.tags;
+  return JSON.stringify(entry, null, 2).split("\n").map((l) => "  " + l).join("\n");
+}
+
+// src/commands/skill.ts
 function usage() {
   console.log(c.dim([
     "",
@@ -3562,11 +3858,14 @@ function usage() {
     "  holt skill list                     list installed skills",
     "  holt skill show <name>              print a skill",
     "  holt skill create <name> [--global] scaffold a new skill",
-    "  holt skill add <source> [--global]  install from a git URL or local path",
+    "  holt skill search <query>           find skills in the registry",
+    "  holt skill add <src|name> [--global] install from a git URL, path, or registry name",
+    "  holt skill publish [<name>]         prepare a skill for the registry (prints a PR entry)",
     "  holt skill remove <name>            delete a skill",
     "",
     "  --global installs into ~/.holt/skills (available in every folder).",
     "  Without it, skills live in this folder at ./.holt/skills.",
+    "  search/add-by-name use the registry (HOLT_REGISTRY_URL or the community index).",
     ""
   ].join("\n")));
 }
@@ -3597,12 +3896,12 @@ function isGitUrl(s) {
   return s.includes("://") || s.endsWith(".git") || s.startsWith("git@");
 }
 function findSkillDir(root) {
-  if (existsSync11(join11(root, "SKILL.md"))) return root;
+  if (existsSync12(join12(root, "SKILL.md"))) return root;
   let subs = [];
   try {
     subs = readdirSync3(root).filter((f) => {
       try {
-        return statSync4(join11(root, f)).isDirectory();
+        return statSync5(join12(root, f)).isDirectory();
       } catch {
         return false;
       }
@@ -3610,8 +3909,8 @@ function findSkillDir(root) {
   } catch {
     return null;
   }
-  const withSkill = subs.filter((f) => existsSync11(join11(root, f, "SKILL.md")));
-  if (withSkill.length === 1) return join11(root, withSkill[0]);
+  const withSkill = subs.filter((f) => existsSync12(join12(root, f, "SKILL.md")));
+  if (withSkill.length === 1) return join12(root, withSkill[0]);
   return null;
 }
 function cmdList() {
@@ -3651,7 +3950,7 @@ function cmdShow(name) {
   const { skill, body } = loaded;
   console.log("\n" + c.accent(skill.name) + c.dim(`  (${skill.scope})`));
   if (skill.description) console.log("  " + skill.description);
-  console.log(c.dim("  " + join11(skill.dir, "SKILL.md")));
+  console.log(c.dim("  " + join12(skill.dir, "SKILL.md")));
   console.log("");
   console.log(c.dim(body));
   console.log("");
@@ -3663,60 +3962,55 @@ function cmdCreate(name, global) {
     return;
   }
   const scope = global ? "global" : "workspace";
-  const dir = join11(skillsRoot(scope), clean);
-  if (existsSync11(dir)) {
+  const dir = join12(skillsRoot(scope), clean);
+  if (existsSync12(dir)) {
     console.error(c.red(`
   A ${scope} skill named "${clean}" already exists.`));
     console.error(c.dim("  " + dir + "\n"));
     process.exitCode = 1;
     return;
   }
-  mkdirSync8(dir, { recursive: true });
-  writeFileSync9(join11(dir, "SKILL.md"), SKILL_TEMPLATE(clean), "utf8");
+  mkdirSync9(dir, { recursive: true });
+  writeFileSync10(join12(dir, "SKILL.md"), SKILL_TEMPLATE(clean), "utf8");
   console.log(c.green(`
   Created ${scope} skill "${clean}".`));
-  console.log(c.dim("  " + join11(dir, "SKILL.md")));
+  console.log(c.dim("  " + join12(dir, "SKILL.md")));
   console.log(c.dim('  Edit it, then run it in chat with "/skill ' + clean + '".\n'));
 }
-function cmdAdd(source, global) {
-  if (!source) {
-    console.log(c.dim("\n  Usage: holt skill add <git-url|path> [--global]\n"));
-    return;
-  }
-  const scope = global ? "global" : "workspace";
+function installFromSource(source, scope) {
   let fetched = "";
   let tempDir = "";
   try {
     if (isGitUrl(source)) {
-      tempDir = mkdtempSync(join11(tmpdir(), "holt-skill-"));
+      tempDir = mkdtempSync(join12(tmpdir(), "holt-skill-"));
       console.log(c.dim(`
   Cloning ${source} ...`));
       const res = spawnSync2("git", ["clone", "--depth", "1", source, tempDir], { stdio: "ignore" });
       if (res.status !== 0) {
         console.error(c.red("  Clone failed. Check the URL and that git is installed.\n"));
         process.exitCode = 1;
-        return;
+        return false;
       }
       fetched = tempDir;
     } else {
-      fetched = resolve2(source);
-      if (!existsSync11(fetched)) {
+      fetched = resolve3(source);
+      if (!existsSync12(fetched)) {
         console.error(c.red(`
   No such path: ${fetched}
 `));
         process.exitCode = 1;
-        return;
+        return false;
       }
     }
     const skillDir = findSkillDir(fetched);
     if (!skillDir) {
       console.error(c.red("\n  Could not find a SKILL.md at the source root or in a single subfolder.\n"));
       process.exitCode = 1;
-      return;
+      return false;
     }
     let skillName = "";
     try {
-      const { data } = parseFrontmatter(readFileSync12(join11(skillDir, "SKILL.md"), "utf8"));
+      const { data } = parseFrontmatter(readFileSync13(join12(skillDir, "SKILL.md"), "utf8"));
       skillName = sanitizeName(data.name || "");
     } catch {
       skillName = "";
@@ -3725,25 +4019,26 @@ function cmdAdd(source, global) {
     if (!skillName) {
       console.error(c.red("\n  Could not determine a valid skill name.\n"));
       process.exitCode = 1;
-      return;
+      return false;
     }
-    const dest = join11(skillsRoot(scope), skillName);
-    if (existsSync11(dest)) {
+    const dest = join12(skillsRoot(scope), skillName);
+    if (existsSync12(dest)) {
       console.error(c.red(`
   A ${scope} skill named "${skillName}" already exists.`));
       console.error(c.dim("  " + dest + "\n"));
       process.exitCode = 1;
-      return;
+      return false;
     }
-    mkdirSync8(skillsRoot(scope), { recursive: true });
+    mkdirSync9(skillsRoot(scope), { recursive: true });
     cpSync(skillDir, dest, { recursive: true });
-    const nestedGit = join11(dest, ".git");
-    if (existsSync11(nestedGit)) rmSync5(nestedGit, { recursive: true, force: true });
+    const nestedGit = join12(dest, ".git");
+    if (existsSync12(nestedGit)) rmSync5(nestedGit, { recursive: true, force: true });
     console.log(c.green(`
   Installed ${scope} skill "${skillName}".`));
-    console.log(c.dim("  " + join11(dest, "SKILL.md") + "\n"));
+    console.log(c.dim("  " + join12(dest, "SKILL.md") + "\n"));
+    return true;
   } finally {
-    if (tempDir && existsSync11(tempDir)) {
+    if (tempDir && existsSync12(tempDir)) {
       try {
         rmSync5(tempDir, { recursive: true, force: true });
       } catch {
@@ -3751,15 +4046,140 @@ function cmdAdd(source, global) {
     }
   }
 }
+async function cmdAdd(source, global, refresh) {
+  if (!source) {
+    console.log(c.dim("\n  Usage: holt skill add <git-url|path|name> [--global]\n"));
+    return;
+  }
+  const scope = global ? "global" : "workspace";
+  if (isGitUrl(source) || existsSync12(resolve3(source))) {
+    installFromSource(source, scope);
+    return;
+  }
+  const { registry, error } = await loadRegistry({ refresh });
+  if (!registry) {
+    console.error(c.red(`
+  "${source}" is not a git URL or a local path, and the registry is unavailable.`));
+    console.error(c.dim("  " + (error || "no registry reachable") + "\n"));
+    process.exitCode = 1;
+    return;
+  }
+  const hit = resolveByName(registry.skills, source);
+  if (!hit) {
+    console.error(c.red(`
+  No skill named "${source}" in the registry.`));
+    console.error(c.dim('  Try "holt skill search ' + source + '" to find one.\n'));
+    process.exitCode = 1;
+    return;
+  }
+  console.log(c.dim(`
+  Resolved "${hit.name}" -> ${hit.source}`));
+  installFromSource(hit.source, scope);
+}
+async function cmdSearch(query, refresh) {
+  const { registry, error, fromCache } = await loadRegistry({ refresh });
+  if (!registry) {
+    console.error(c.red("\n  Registry unavailable."));
+    console.error(c.dim("  " + (error || "no registry reachable") + "\n"));
+    process.exitCode = 1;
+    return;
+  }
+  const hits = searchSkills(registry.skills, query);
+  if (hits.length === 0) {
+    const what = query.trim() ? `matching "${query.trim()}"` : "in the registry";
+    console.log(c.dim(`
+  No skills ${what}.
+`));
+    return;
+  }
+  const nameW = Math.max(4, ...hits.map((s) => s.name.length));
+  const authorW = Math.max(6, ...hits.map((s) => (s.author || "").length));
+  console.log(
+    "\n" + c.accent("Registry") + c.dim("  " + registryUrl() + (fromCache ? "  (cached)" : ""))
+  );
+  console.log(
+    "  " + c.dim("name".padEnd(nameW)) + "  " + c.dim("author".padEnd(authorW)) + "  " + c.dim("description")
+  );
+  for (const s of hits) {
+    const desc = s.description.length > 56 ? s.description.slice(0, 55) + "\u2026" : s.description;
+    console.log(
+      "  " + c.bold(s.name.padEnd(nameW)) + "  " + c.dim((s.author || "").padEnd(authorW)) + "  " + (desc || c.dim("(no description)"))
+    );
+    console.log("  " + " ".repeat(nameW) + "  " + " ".repeat(authorW) + "  " + c.dim(s.source));
+  }
+  console.log(c.dim('\n  Install one with "holt skill add <name>".\n'));
+}
+function cmdPublish(name) {
+  let skillName = "";
+  let description = "";
+  let sourceHint = "";
+  if (name) {
+    const loaded = loadSkill(name);
+    if (!loaded) {
+      console.error(c.red(`
+  No skill named "${sanitizeName(name)}". Try "holt skill list".
+`));
+      process.exitCode = 1;
+      return;
+    }
+    let raw = "";
+    try {
+      raw = readFileSync13(join12(loaded.skill.dir, "SKILL.md"), "utf8");
+    } catch {
+      console.error(c.red("\n  Could not read the skill's SKILL.md.\n"));
+      process.exitCode = 1;
+      return;
+    }
+    const { data } = parseFrontmatter(raw);
+    skillName = sanitizeName(data.name || loaded.skill.name);
+    description = (data.description || loaded.skill.description || "").trim();
+  } else {
+    const file = join12(process.cwd(), "SKILL.md");
+    if (!existsSync12(file)) {
+      console.error(c.red("\n  No SKILL.md in the current directory, and no skill name given."));
+      console.error(c.dim("  Usage: holt skill publish [<name>]\n"));
+      process.exitCode = 1;
+      return;
+    }
+    const { data } = parseFrontmatter(readFileSync13(file, "utf8"));
+    skillName = sanitizeName(data.name || process.cwd().split(/[\\/]/).pop() || "");
+    description = (data.description || "").trim();
+    sourceHint = process.cwd();
+  }
+  if (!skillName || !description) {
+    console.error(c.red("\n  This skill is missing a name or description in its SKILL.md frontmatter."));
+    console.error(c.dim("  Both are required to publish. Add:  name: <name>  and  description: <one line>\n"));
+    process.exitCode = 1;
+    return;
+  }
+  const entry = buildPublishEntry({
+    name: skillName,
+    description,
+    source: sourceHint || `https://github.com/<you>/${skillName}`,
+    author: "<your name or handle>",
+    tags: []
+  });
+  console.log("\n" + c.accent(`Publish "${skillName}" to the Holt skill registry`));
+  console.log(c.dim("  The registry is a git-based JSON index. Publishing = opening a PR that adds your entry.\n"));
+  console.log(c.dim("  1. Push this skill to a public git repo (or note a subpath spec Holt can clone)."));
+  console.log(c.dim('  2. Add this entry to the "skills" array in registry.json:'));
+  console.log("");
+  console.log(entry);
+  console.log("");
+  console.log(c.dim('     Replace the "source" (your public git URL or path) and "author" fields.'));
+  console.log(c.dim("  3. Open a pull request against the registry repo:"));
+  console.log(c.dim("     " + REGISTRY_REPO_URL));
+  console.log(c.dim('\n  No push happens here. Once merged, anyone can "holt skill add ' + skillName + '".\n'));
+}
 async function cmdRemove(name, ask) {
   const clean = sanitizeName(name || "");
   if (!clean) {
     console.log(c.dim("\n  Usage: holt skill remove <name>\n"));
     return;
   }
-  const wsDir = join11(skillsRoot("workspace"), clean);
-  const globalDir = join11(skillsRoot("global"), clean);
-  const target = existsSync11(wsDir) ? wsDir : existsSync11(globalDir) ? globalDir : "";
+  const wsDir = join12(skillsRoot("workspace"), clean);
+  const globalDir = join12(skillsRoot("global"), clean);
+  const target = existsSync12(wsDir) ? wsDir : existsSync12(globalDir) ? globalDir : "";
   if (!target) {
     console.error(c.dim(`
   No skill named "${clean}" found.
@@ -3784,7 +4204,8 @@ async function skillCmd(sub, rest = []) {
     return;
   }
   const global = rest.includes("--global");
-  const args = rest.filter((a) => a !== "--global");
+  const refresh = rest.includes("--refresh");
+  const args = rest.filter((a) => a !== "--global" && a !== "--refresh");
   const action = (sub || "").toLowerCase();
   try {
     switch (action) {
@@ -3800,9 +4221,16 @@ async function skillCmd(sub, rest = []) {
       case "new":
         cmdCreate(args[0], global);
         break;
+      case "search":
+      case "find":
+        await cmdSearch(args.join(" "), refresh);
+        break;
       case "add":
       case "install":
-        cmdAdd(args[0], global);
+        await cmdAdd(args[0], global, refresh);
+        break;
+      case "publish":
+        cmdPublish(args[0]);
         break;
       case "remove":
       case "rm":
@@ -3819,10 +4247,74 @@ async function skillCmd(sub, rest = []) {
 }
 
 // src/commands/graph.ts
-import { writeFileSync as writeFileSync10, mkdirSync as mkdirSync9, existsSync as existsSync12 } from "fs";
-import { join as join12, dirname as dirname2, resolve as resolve3 } from "path";
+import { writeFileSync as writeFileSync11, mkdirSync as mkdirSync10, existsSync as existsSync13 } from "fs";
+import { join as join14, dirname as dirname3, resolve as resolve4 } from "path";
 import { spawn as spawn4 } from "child_process";
 
+// src/communities.ts
+var MAX_ITERS = 30;
+function detectCommunities(input) {
+  const { nodeIds, edges } = input;
+  const order = nodeIds.slice();
+  const idx = /* @__PURE__ */ new Map();
+  order.forEach((id, i) => idx.set(id, i));
+  const adj = order.map(() => /* @__PURE__ */ new Map());
+  for (const e of edges) {
+    const a = idx.get(e.source);
+    const b = idx.get(e.target);
+    if (a === void 0 || b === void 0 || a === b) continue;
+    const am = adj[a];
+    const bm = adj[b];
+    am.set(b, (am.get(b) || 0) + 1);
+    bm.set(a, (bm.get(a) || 0) + 1);
+  }
+  const label = order.map((_, i) => i);
+  for (let iter = 0; iter < MAX_ITERS; iter++) {
+    let changed = false;
+    for (let i = 0; i < order.length; i++) {
+      const neigh = adj[i];
+      if (neigh.size === 0) continue;
+      const tally = /* @__PURE__ */ new Map();
+      for (const [j, w] of neigh) {
+        const lj = label[j];
+        tally.set(lj, (tally.get(lj) || 0) + w);
+      }
+      let best = label[i];
+      let bestW = -1;
+      for (const [lab, w] of tally) {
+        if (w > bestW || w === bestW && lab < best) {
+          best = lab;
+          bestW = w;
+        }
+      }
+      if (best !== label[i]) {
+        label[i] = best;
+        changed = true;
+      }
+    }
+    if (!changed) break;
+  }
+  const remap = /* @__PURE__ */ new Map();
+  const community = /* @__PURE__ */ new Map();
+  const members = /* @__PURE__ */ new Map();
+  for (let i = 0; i < order.length; i++) {
+    const raw = label[i];
+    let cid = remap.get(raw);
+    if (cid === void 0) {
+      cid = String(remap.size);
+      remap.set(raw, cid);
+    }
+    const id = order[i];
+    community.set(id, cid);
+    const arr = members.get(cid);
+    if (arr) arr.push(id);
+    else members.set(cid, [id]);
+  }
+  const sizes = /* @__PURE__ */ new Map();
+  for (const [cid, arr] of members) sizes.set(cid, arr.length);
+  return { community, members, sizes, count: members.size };
+}
+
 // src/graphview.ts
 var STOPWORDS = /* @__PURE__ */ new Set([
   "the",
@@ -4017,6 +4509,49 @@ function mergeGraphs(a, b) {
   }
   return { nodes, edges: [...a.edges, ...b.edges] };
 }
+function buildCodeGraph(files, edges) {
+  const nodes = [];
+  const ids = new Set(files.map((f) => f.id));
+  for (const f of files) {
+    const snippet = f.content.replace(/\s+/g, " ").trim().slice(0, 180);
+    nodes.push({
+      id: f.id,
+      kind: f.kind === "code" ? "file" : "doc",
+      label: shortPath(f.id),
+      path: f.id,
+      ext: f.ext,
+      topDir: f.topDir,
+      snippet
+    });
+  }
+  const out = [];
+  for (const e of edges) {
+    if (!ids.has(e.source) || !ids.has(e.target)) continue;
+    out.push({ source: e.source, target: e.target, kind: e.kind, width: e.kind === "dep" ? 1.5 : 1.5 });
+  }
+  return { nodes, edges: out };
+}
+function shortPath(p) {
+  const parts = p.split("/");
+  return parts.length <= 2 ? p : parts.slice(-2).join("/");
+}
+function assignCommunities(graph2) {
+  const nodeIds = graph2.nodes.map((n) => n.id);
+  const idSet = new Set(nodeIds);
+  const edges = graph2.edges.filter((e) => idSet.has(e.source) && idSet.has(e.target)).map((e) => ({ source: e.source, target: e.target }));
+  const { community } = detectCommunities({ nodeIds, edges });
+  const degree = /* @__PURE__ */ new Map();
+  for (const id of nodeIds) degree.set(id, 0);
+  for (const e of edges) {
+    degree.set(e.source, (degree.get(e.source) || 0) + 1);
+    degree.set(e.target, (degree.get(e.target) || 0) + 1);
+  }
+  for (const n of graph2.nodes) {
+    n.community = community.get(n.id);
+    n.degree = degree.get(n.id) || 0;
+  }
+  return graph2;
+}
 function escapeForScript(json) {
   return json.replace(/<\/(script)/gi, "<\\/$1").replace(/<!--/g, "<\\u0021--");
 }
@@ -4123,7 +4658,9 @@ function renderGraphHtml(graph2, meta) {
   <div class="row"><span class="swatch" style="background:var(--cyan)"></span>assistant</div>
   <div class="row"><span class="swatch" style="background:var(--violet)"></span>concept</div>
   <div class="row"><span class="swatch" style="background:#5bd66f"></span>wiki page</div>
-  <div class="row"><span class="swatch" style="background:var(--line);border:1px solid var(--muted)"></span>ring = session</div>
+  <div class="row"><span class="swatch" style="background:#e2704a"></span>code file</div>
+  <div class="row"><span class="swatch" style="background:#4a90d9"></span>doc file</div>
+  <div class="row"><span class="swatch" style="background:var(--line);border:1px solid var(--muted)"></span>ring = session / community</div>
 </div>
 <div id="hint">drag to pan &middot; wheel to zoom &middot; click a node &middot; Esc to clear</div>
 <div id="empty">This graph has no nodes yet.</div>
@@ -4173,10 +4710,17 @@ function renderGraphHtml(graph2, meta) {
   });
 
   function radiusOf(n) {
-    var base = n.kind === "concept" ? 3 : n.kind === "wiki" ? 6 : 5;
+    var base = n.kind === "concept" ? 3 : n.kind === "wiki" ? 6 : (n.kind === "file" || n.kind === "doc") ? 5 : 5;
     return base + Math.min(9, Math.sqrt(n._deg) * 1.6);
   }
 
+  // ---- community tint: a stable hue per community id ----
+  function communityHue(cid) {
+    var k = parseInt(cid, 10);
+    if (isNaN(k)) k = 0;
+    return (k * 137.508) % 360; // golden-angle spread, same trick as sessions
+  }
+
   // ---- initial layout: spread on a spiral so physics has somewhere to start ----
   nodes.forEach(function (n, i) {
     var ang = i * 2.399963;
@@ -4188,7 +4732,7 @@ function renderGraphHtml(graph2, meta) {
 
   // ---- physics ----
   var REPULSION = 5200, SPRING = 0.02, GRAVITY = 0.015, DAMP = 0.86;
-  var restLen = { sequential: 60, semantic: 45, concept: 70 };
+  var restLen = { sequential: 60, semantic: 45, concept: 70, dep: 55, link: 55, wikilink: 55 };
 
   function step() {
     var i, j, n, m, dx, dy, d2, d, f;
@@ -4254,12 +4798,14 @@ function renderGraphHtml(graph2, meta) {
   function roleColor(n) {
     if (n.kind === "wiki") return "#5bd66f";
     if (n.kind === "concept") return "#9a8cff";
+    if (n.kind === "file") return "#e2704a";
+    if (n.kind === "doc") return "#4a90d9";
     return n.role === "user" ? "#f0b91e" : "#35d0d6";
   }
 
   function matchesQuery(n) {
     if (!query) return false;
-    var hay = (n.label || "") + " " + (n.content || "");
+    var hay = (n.label || "") + " " + (n.content || "") + " " + (n.path || "") + " " + (n.snippet || "");
     return hay.toLowerCase().indexOf(query) >= 0;
   }
 
@@ -4279,7 +4825,7 @@ function renderGraphHtml(graph2, meta) {
       }
       ctx.globalAlpha = dim;
       ctx.lineWidth = Math.max(0.4, lk.width * view.scale * 0.5);
-      ctx.strokeStyle = lk.kind === "semantic" ? "#35d0d6" : lk.kind === "concept" ? "#9a8cff" : lk.kind === "wikilink" ? "#5bd66f" : "#4a5262";
+      ctx.strokeStyle = lk.kind === "semantic" ? "#35d0d6" : lk.kind === "concept" ? "#9a8cff" : lk.kind === "wikilink" ? "#5bd66f" : lk.kind === "dep" ? "#e2704a" : lk.kind === "link" ? "#4a90d9" : "#4a5262";
       ctx.beginPath(); ctx.moveTo(a.x, a.y); ctx.lineTo(b.x, b.y); ctx.stroke();
     }
     ctx.globalAlpha = 1;
@@ -4293,12 +4839,17 @@ function renderGraphHtml(graph2, meta) {
       var faded = (highlightSet && !highlightSet.has(n.id)) || (query && !matchesQuery(n));
       ctx.globalAlpha = faded ? 0.18 : 1;
 
-      // session ring
+      // session ring (turns) or community ring (files/docs)
       if (n.kind === "turn") {
         ctx.beginPath();
         ctx.arc(p.x, p.y, r + 2.4, 0, Math.PI * 2);
         ctx.strokeStyle = "hsl(" + sessionHue(n.session) + ",70%,58%)";
         ctx.lineWidth = 1.6; ctx.stroke();
+      } else if ((n.kind === "file" || n.kind === "doc") && n.community != null) {
+        ctx.beginPath();
+        ctx.arc(p.x, p.y, r + 2.4, 0, Math.PI * 2);
+        ctx.strokeStyle = "hsl(" + communityHue(n.community) + ",70%,58%)";
+        ctx.lineWidth = 2; ctx.stroke();
       }
 
       ctx.beginPath();
@@ -4310,10 +4861,13 @@ function renderGraphHtml(graph2, meta) {
         ctx.lineWidth = 2; ctx.strokeStyle = "#ffffff"; ctx.stroke();
       }
 
-      // concept + wiki labels always; turn labels when zoomed in
-      if (n.kind === "concept" || n.kind === "wiki" || view.scale > 1.4) {
+      // concept + wiki labels always; file/doc when zoomed a little; turn labels when zoomed in
+      var showLabel = n.kind === "concept" || n.kind === "wiki"
+        || ((n.kind === "file" || n.kind === "doc") && view.scale > 0.9)
+        || view.scale > 1.4;
+      if (showLabel) {
         ctx.globalAlpha = faded ? 0.25 : 0.9;
-        ctx.fillStyle = n.kind === "wiki" ? "#5bd66f" : "#e7e9ee";
+        ctx.fillStyle = n.kind === "wiki" ? "#5bd66f" : n.kind === "file" ? "#e2704a" : n.kind === "doc" ? "#4a90d9" : "#e7e9ee";
         ctx.font = (n.kind === "wiki" ? 12 : n.kind === "concept" ? 11 : 10) + "px ui-monospace, monospace";
         ctx.fillText(n.label, p.x + r + 4, p.y + 3);
       }
@@ -4380,6 +4934,8 @@ function renderGraphHtml(graph2, meta) {
           ? ("concept &middot; in " + (hov.freq || 0) + " turns")
           : hov.kind === "wiki"
           ? "wiki page"
+          : (hov.kind === "file" || hov.kind === "doc")
+          ? (esc(hov.path || "") + " &middot; " + hov._deg + " links" + (hov.community != null ? " &middot; community " + esc(String(hov.community)) : ""))
           : (esc(hov.session || "") + (when ? " &middot; " + when : ""));
         tooltip.innerHTML = "<div>" + esc(hov.label) + "</div><div class='t-meta'>" + meta + "</div>";
         tooltip.style.display = "block";
@@ -4426,6 +4982,9 @@ function renderGraphHtml(graph2, meta) {
     if (n.kind === "concept" || n.kind === "wiki") {
       highlightSet = neighbors(n.id); // light up its connected nodes
       closePanel();
+    } else if (n.kind === "file" || n.kind === "doc") {
+      highlightSet = neighbors(n.id); // light up dependencies/links
+      openPanel(n);
     } else {
       highlightSet = null;
       openPanel(n);
@@ -4439,6 +4998,18 @@ function renderGraphHtml(graph2, meta) {
 
   // ---- side panel ----
   function openPanel(n) {
+    if (n.kind === "file" || n.kind === "doc") {
+      document.getElementById("p-session").textContent = (n.kind === "file" ? "code" : "doc") + (n.ext ? " (." + n.ext + ")" : "");
+      document.getElementById("p-dot").style.background = roleColor(n);
+      document.getElementById("p-role").textContent = n.path || n.label || "";
+      document.getElementById("p-role").style.color = roleColor(n);
+      // textContent keeps any <script>/<img onerror> in the path or snippet inert.
+      document.getElementById("p-content").textContent = n.snippet || "";
+      document.getElementById("p-time").textContent =
+        (n.community != null ? "community " + n.community + "  |  " : "") + (n._deg || 0) + " links";
+      panel.classList.add("open");
+      return;
+    }
     document.getElementById("p-session").textContent = n.session || "";
     document.getElementById("p-dot").style.background = "hsl(" + sessionHue(n.session) + ",70%,58%)";
     document.getElementById("p-role").textContent = n.role || "";
@@ -4473,14 +5044,376 @@ function renderGraphHtml(graph2, meta) {
 `;
 }
 
+// src/ingest.ts
+import { readdirSync as readdirSync4, readFileSync as readFileSync14, statSync as statSync6 } from "fs";
+import { join as join13, relative, sep, extname, dirname as dirname2, basename as basename2 } from "path";
+var CODE_EXT = /* @__PURE__ */ new Set([
+  "js",
+  "jsx",
+  "ts",
+  "tsx",
+  "mjs",
+  "cjs",
+  "py",
+  "go",
+  "rb",
+  "rs",
+  "java",
+  "kt",
+  "kts",
+  "swift",
+  "c",
+  "h",
+  "cc",
+  "cpp",
+  "hpp",
+  "cs",
+  "php",
+  "scala",
+  "sh",
+  "bash"
+]);
+var DOC_EXT = /* @__PURE__ */ new Set(["md", "mdx", "txt", "rst"]);
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  ".holt",
+  "dist",
+  "build",
+  ".next",
+  "coverage",
+  "out",
+  "target",
+  "vendor",
+  "__pycache__",
+  ".venv",
+  "venv",
+  ".cache",
+  "tmp",
+  ".idea",
+  ".vscode"
+]);
+var MAX_FILES = 2e3;
+var MAX_FILE_BYTES = 400 * 1024;
+var MAX_TOTAL_BYTES = 64 * 1024 * 1024;
+function toPosix(p) {
+  return sep === "/" ? p : p.split(sep).join("/");
+}
+function ingestFolder(root, want = { code: true, docs: true }) {
+  const files = [];
+  const skipped = { dirs: 0, tooBig: 0, unreadable: 0, hitFileCap: false, hitByteCap: false };
+  let totalBytes = 0;
+  const stack = [root];
+  while (stack.length) {
+    const dir = stack.pop();
+    let entries;
+    try {
+      entries = readdirSync4(dir).sort((a, b) => a.localeCompare(b));
+    } catch {
+      skipped.unreadable++;
+      continue;
+    }
+    const subdirs = [];
+    for (const name of entries) {
+      if (files.length >= MAX_FILES) {
+        skipped.hitFileCap = true;
+        break;
+      }
+      const full = join13(dir, name);
+      let st;
+      try {
+        st = statSync6(full);
+      } catch {
+        skipped.unreadable++;
+        continue;
+      }
+      if (st.isDirectory()) {
+        if (name.startsWith(".") || SKIP_DIRS.has(name)) {
+          skipped.dirs++;
+          continue;
+        }
+        subdirs.push(full);
+        continue;
+      }
+      if (!st.isFile()) continue;
+      const ext = extname(name).slice(1).toLowerCase();
+      const isCode = CODE_EXT.has(ext);
+      const isDoc = DOC_EXT.has(ext);
+      if (!isCode && !isDoc) continue;
+      if (isCode && !want.code) continue;
+      if (isDoc && !want.docs) continue;
+      if (st.size > MAX_FILE_BYTES) {
+        skipped.tooBig++;
+        continue;
+      }
+      if (totalBytes + st.size > MAX_TOTAL_BYTES) {
+        skipped.hitByteCap = true;
+        continue;
+      }
+      let content;
+      try {
+        content = readFileSync14(full, "utf8");
+      } catch {
+        skipped.unreadable++;
+        continue;
+      }
+      totalBytes += st.size;
+      const rel = toPosix(relative(root, full)) || name;
+      const firstSlash = rel.indexOf("/");
+      const topDir = firstSlash < 0 ? "." : rel.slice(0, firstSlash);
+      files.push({
+        id: rel,
+        path: rel,
+        kind: isCode ? "code" : "doc",
+        ext,
+        topDir,
+        content
+      });
+    }
+    if (files.length >= MAX_FILES) {
+      skipped.hitFileCap = true;
+    }
+    for (let i = subdirs.length - 1; i >= 0; i--) stack.push(subdirs[i]);
+  }
+  const byId = new Set(files.map((f) => f.id));
+  const edges = extractEdges(files, byId);
+  return { files, edges, skipped };
+}
+function extractEdges(files, byId) {
+  const edges = [];
+  const seen = /* @__PURE__ */ new Set();
+  const push = (source, target, kind) => {
+    if (source === target) return;
+    const key = source + "\0" + target + "\0" + kind;
+    if (seen.has(key)) return;
+    seen.add(key);
+    edges.push({ source, target, kind });
+  };
+  for (const f of files) {
+    if (f.kind === "code") {
+      for (const spec of codeSpecifiers(f)) {
+        const resolved = resolveCodeSpec(f, spec, byId);
+        if (resolved) push(f.id, resolved, "dep");
+      }
+    } else {
+      for (const spec of docLinks(f.content)) {
+        const resolved = resolveDocLink(f, spec, byId, files);
+        if (resolved) push(f.id, resolved, "link");
+      }
+    }
+  }
+  return edges;
+}
+var JS_FROM_RE = /(?:import|export)\b[^;'"]*?\bfrom\s*['"]([^'"]+)['"]/g;
+var JS_BARE_IMPORT_RE = /\bimport\s*['"]([^'"]+)['"]/g;
+var JS_REQUIRE_RE = /\brequire\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+var JS_DYN_IMPORT_RE = /\bimport\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+var PY_IMPORT_RE = /^[ \t]*import\s+([A-Za-z0-9_.]+)/gm;
+var PY_FROM_RE = /^[ \t]*from\s+(\.*[A-Za-z0-9_.]*)\s+import\b/gm;
+function matchAll(re, text) {
+  const out = [];
+  re.lastIndex = 0;
+  let m;
+  while ((m = re.exec(text)) !== null) {
+    if (m[1]) out.push(m[1]);
+  }
+  return out;
+}
+function codeSpecifiers(f) {
+  if (f.ext === "py") {
+    return [...matchAll(PY_IMPORT_RE, f.content), ...matchAll(PY_FROM_RE, f.content)];
+  }
+  if (["js", "jsx", "ts", "tsx", "mjs", "cjs"].includes(f.ext)) {
+    return [
+      ...matchAll(JS_FROM_RE, f.content),
+      ...matchAll(JS_BARE_IMPORT_RE, f.content),
+      ...matchAll(JS_REQUIRE_RE, f.content),
+      ...matchAll(JS_DYN_IMPORT_RE, f.content)
+    ];
+  }
+  return [];
+}
+var JS_TRY_EXT = ["", ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".d.ts"];
+var JS_INDEX = ["/index.ts", "/index.tsx", "/index.js", "/index.jsx", "/index.mjs"];
+function joinPosix(fromDir, spec) {
+  const parts = (fromDir === "." ? [] : fromDir.split("/")).concat(spec.split("/"));
+  const out = [];
+  for (const part of parts) {
+    if (part === "" || part === ".") continue;
+    if (part === "..") {
+      out.pop();
+      continue;
+    }
+    out.push(part);
+  }
+  return out.join("/");
+}
+function resolveCodeSpec(f, spec, byId) {
+  if (f.ext === "py") return resolvePySpec(f, spec, byId);
+  if (!(spec.startsWith("./") || spec.startsWith("../"))) return null;
+  const fromDir = toPosixDir(f.id);
+  const base = joinPosix(fromDir, spec);
+  for (const ext of JS_TRY_EXT) {
+    const cand = base + ext;
+    if (cand && byId.has(cand)) return cand;
+  }
+  for (const idx of JS_INDEX) {
+    const cand = base + idx;
+    if (byId.has(cand)) return cand;
+  }
+  return null;
+}
+function resolvePySpec(f, spec, byId) {
+  let mod = spec;
+  let up = 0;
+  while (mod.startsWith(".")) {
+    up++;
+    mod = mod.slice(1);
+  }
+  const segs = mod ? mod.split(".") : [];
+  let baseDir = toPosixDir(f.id);
+  if (up > 0) {
+    for (let i = 1; i < up; i++) baseDir = toPosixDir(baseDir + "/x");
+  }
+  const relBase = up > 0 ? joinPosix(baseDir, segs.join("/")) : segs.join("/");
+  const candidates = up > 0 ? [relBase + ".py", relBase + "/__init__.py"] : [
+    relBase + ".py",
+    relBase + "/__init__.py",
+    // absolute import may still be relative to the file's own dir
+    joinPosix(toPosixDir(f.id), segs.join("/")) + ".py"
+  ];
+  for (const cand of candidates) if (cand && byId.has(cand)) return cand;
+  return null;
+}
+function toPosixDir(id) {
+  const d = toPosix(dirname2(id));
+  return d === "" || d === "." ? "." : d;
+}
+var MD_LINK_RE = /\[[^\]]*\]\(([^)\s]+)(?:\s+["'][^"']*["'])?\)/g;
+var WIKILINK_RE2 = /\[\[([^\]]+)\]\]/g;
+function docLinks(content) {
+  const out = [];
+  for (const raw of matchAll(MD_LINK_RE, content)) out.push(raw);
+  WIKILINK_RE2.lastIndex = 0;
+  let m;
+  while ((m = WIKILINK_RE2.exec(content)) !== null) {
+    const target = (m[1] || "").split("|")[0];
+    if (target && target.trim()) out.push(target.trim());
+  }
+  return out;
+}
+function resolveDocLink(f, spec, byId, files) {
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(spec) || spec.startsWith("#") || spec.startsWith("mailto:")) return null;
+  const clean = spec.split("#")[0].split("?")[0].trim();
+  if (!clean) return null;
+  if (clean.includes("/") || clean.includes(".")) {
+    const fromDir = toPosixDir(f.id);
+    const base = joinPosix(fromDir, clean);
+    for (const ext of ["", ".md", ".mdx", ".txt", ".rst"]) {
+      const cand = base + ext;
+      if (cand && byId.has(cand)) return cand;
+    }
+  }
+  const wantName = clean.toLowerCase();
+  for (const cand of files) {
+    if (cand.kind !== "doc") continue;
+    const stem = basename2(cand.id).replace(/\.[^.]+$/, "").toLowerCase();
+    if (stem === wantName) return cand.id;
+  }
+  return null;
+}
+
+// src/graphreport.ts
+var TOP_GOD_NODES = 12;
+var REP_PER_COMMUNITY = 6;
+function degrees(graph2) {
+  const idSet = new Set(graph2.nodes.map((n) => n.id));
+  const deg = /* @__PURE__ */ new Map();
+  for (const n of graph2.nodes) deg.set(n.id, 0);
+  for (const e of graph2.edges) {
+    if (!idSet.has(e.source) || !idSet.has(e.target)) continue;
+    deg.set(e.source, (deg.get(e.source) || 0) + 1);
+    deg.set(e.target, (deg.get(e.target) || 0) + 1);
+  }
+  return deg;
+}
+function reportLabel(n) {
+  return n.path || n.label || n.id;
+}
+function renderReport(graph2, meta) {
+  const date = new Date(meta.generatedAt ?? Date.now()).toISOString().slice(0, 10);
+  const lines = [];
+  lines.push(`# Graph Report - ${meta.workspace}  (${date})`);
+  lines.push("");
+  if (graph2.nodes.length === 0) {
+    lines.push("## Summary");
+    lines.push("- 0 nodes, 0 edges, 0 communities.");
+    lines.push("- Nothing to ingest here yet. Run `holt graph --code` or `holt graph --docs`");
+    lines.push("  in a folder with source or docs, then `holt graph report`.");
+    lines.push("");
+    return lines.join("\n") + "\n";
+  }
+  const deg = degrees(graph2);
+  const idSet = new Set(graph2.nodes.map((n) => n.id));
+  const validEdges = graph2.edges.filter((e) => idSet.has(e.source) && idSet.has(e.target));
+  const commMembers = /* @__PURE__ */ new Map();
+  for (const n of graph2.nodes) {
+    const cid = n.community ?? "0";
+    const arr = commMembers.get(cid);
+    if (arr) arr.push(n);
+    else commMembers.set(cid, [n]);
+  }
+  const communityCount = commMembers.size;
+  const fileCount = graph2.nodes.filter((n) => n.kind === "file").length;
+  const docCount = graph2.nodes.filter((n) => n.kind === "doc").length;
+  lines.push("## Summary");
+  lines.push(`- ${graph2.nodes.length} nodes, ${validEdges.length} edges, ${communityCount} communities detected`);
+  lines.push(`- Ingested: ${fileCount} code files, ${docCount} docs`);
+  lines.push("- Community algorithm: label propagation (deterministic, zero dependency)");
+  lines.push("");
+  lines.push("## God Nodes (most connected - your core files)");
+  const ranked = graph2.nodes.slice().sort((a, b) => (deg.get(b.id) || 0) - (deg.get(a.id) || 0) || reportLabel(a).localeCompare(reportLabel(b))).filter((n) => (deg.get(n.id) || 0) > 0).slice(0, TOP_GOD_NODES);
+  if (ranked.length === 0) {
+    lines.push("- None: no nodes have any edges yet (nothing links to anything).");
+  } else {
+    ranked.forEach((n, i) => {
+      const d = deg.get(n.id) || 0;
+      const cid = n.community ?? "0";
+      lines.push(`${i + 1}. \`${reportLabel(n)}\` - ${d} edges (community ${cid})`);
+    });
+  }
+  lines.push("");
+  lines.push("## Communities");
+  const sortedComms = [...commMembers.entries()].sort(
+    (a, b) => b[1].length - a[1].length || a[0].localeCompare(b[0])
+  );
+  for (const [cid, members] of sortedComms) {
+    lines.push("");
+    lines.push(`### Community ${cid} (${members.length} nodes)`);
+    const reps = members.slice().sort((a, b) => (deg.get(b.id) || 0) - (deg.get(a.id) || 0) || reportLabel(a).localeCompare(reportLabel(b))).slice(0, REP_PER_COMMUNITY).map((n) => reportLabel(n));
+    const extra = members.length - reps.length;
+    const shown = reps.join(", ");
+    lines.push(`Representative: ${shown}${extra > 0 ? ` (+${extra} more)` : ""}`);
+  }
+  lines.push("");
+  return lines.join("\n") + "\n";
+}
+
 // src/commands/graph.ts
 function parseArgs(args) {
-  const opts = { open: true };
+  const opts = { open: true, code: false, docs: false, report: false };
   for (let i = 0; i < args.length; i++) {
     const a = args[i];
-    if (a === "--no-open") opts.open = false;
+    if (a === "report") opts.report = true;
+    else if (a === "--no-open") opts.open = false;
     else if (a === "--wiki") opts.wiki = true;
     else if (a === "--no-wiki") opts.wiki = false;
+    else if (a === "--code") opts.code = true;
+    else if (a === "--docs") opts.docs = true;
+    else if (a === "--all") {
+      opts.code = true;
+      opts.docs = true;
+    } else if (a === "--report") opts.report = true;
     else if (a === "--out") opts.out = args[++i];
     else if (a && a.startsWith("--out=")) opts.out = a.slice("--out=".length);
   }
@@ -4518,15 +5451,55 @@ async function graph(args = []) {
   }
   close();
   const opts = parseArgs(args);
+  if (opts.report && !opts.code && !opts.docs) {
+    opts.code = true;
+    opts.docs = true;
+  }
+  const ingestCode = opts.code;
+  const ingestDocs = opts.docs;
   const turns = loadTurns();
-  const includeWiki = opts.wiki !== void 0 ? opts.wiki : existsSync12(wikiDir());
+  const includeWiki = opts.wiki !== void 0 ? opts.wiki : existsSync13(wikiDir());
   const wikiPages = includeWiki ? wikiGraphPages() : [];
-  if (turns.length === 0 && wikiPages.length === 0) {
+  let fileNodeCount = 0;
+  let docNodeCount = 0;
+  let codeGraph = null;
+  if (ingestCode || ingestDocs) {
+    const res = ingestFolder(workspace(), { code: ingestCode, docs: ingestDocs });
+    codeGraph = buildCodeGraph(res.files, res.edges);
+    fileNodeCount = codeGraph.nodes.filter((n) => n.kind === "file").length;
+    docNodeCount = codeGraph.nodes.filter((n) => n.kind === "doc").length;
+    const skipNotes = [];
+    if (res.skipped.dirs) skipNotes.push(`${res.skipped.dirs} dirs`);
+    if (res.skipped.tooBig) skipNotes.push(`${res.skipped.tooBig} too-big`);
+    if (res.skipped.unreadable) skipNotes.push(`${res.skipped.unreadable} unreadable`);
+    if (res.skipped.hitFileCap) skipNotes.push("file cap hit");
+    if (res.skipped.hitByteCap) skipNotes.push("byte cap hit");
+    if (skipNotes.length) console.log(c.dim(`  ingest skipped: ${skipNotes.join(", ")}`));
+  }
+  if (turns.length === 0 && wikiPages.length === 0 && !codeGraph) {
     console.log(c.dim('\n  No memory in this folder yet. Have a chat first with "holt chat", then come back.\n'));
+    console.log(c.dim(`  Or ingest this folder's code/docs: "holt graph --code" / "holt graph --docs".
+`));
     return;
   }
   let g = buildGraph(turns);
   if (wikiPages.length) g = mergeGraphs(g, buildWikiGraph(wikiPages));
+  if (codeGraph) g = mergeGraphs(g, codeGraph);
+  if (codeGraph) assignCommunities(g);
+  if (opts.report) {
+    const md = renderReport(g, { workspace: workspace() });
+    const reportPath = opts.out ? resolve4(opts.out) : join14(workspace(), "GRAPH_REPORT.md");
+    mkdirSync10(dirname3(reportPath), { recursive: true });
+    writeFileSync11(reportPath, md, "utf8");
+    const communities = new Set(g.nodes.map((n) => n.community ?? "0")).size;
+    console.log("\n" + c.accent("Graph report written") + c.dim("  (this folder)"));
+    console.log(`  nodes        ${g.nodes.length}  (${fileNodeCount} files, ${docNodeCount} docs)`);
+    console.log(`  edges        ${g.edges.length}`);
+    console.log(`  communities  ${g.nodes.length ? communities : 0}`);
+    console.log(`  file         ${reportPath}
+`);
+    return;
+  }
   const conceptCount = g.nodes.filter((n) => n.kind === "concept").length;
   const wikiCount = g.nodes.filter((n) => n.kind === "wiki").length;
   const sessions = new Set(turns.map((t) => t.session)).size;
@@ -4537,12 +5510,14 @@ async function graph(args = []) {
     concepts: conceptCount,
     edges: g.edges.length
   });
-  const outPath = opts.out ? resolve3(opts.out) : join12(wsHoltDir(), "graph.html");
-  mkdirSync9(dirname2(outPath), { recursive: true });
-  writeFileSync10(outPath, html, "utf8");
+  const outPath = opts.out ? resolve4(opts.out) : join14(wsHoltDir(), "graph.html");
+  mkdirSync10(dirname3(outPath), { recursive: true });
+  writeFileSync11(outPath, html, "utf8");
   console.log("\n" + c.accent("Memory graph built") + c.dim("  (this folder)"));
   const parts = [`${turns.length} turns`, `${conceptCount} concepts`];
   if (wikiCount) parts.push(`${wikiCount} wiki pages`);
+  if (fileNodeCount) parts.push(`${fileNodeCount} code files`);
+  if (docNodeCount) parts.push(`${docNodeCount} docs`);
   console.log(`  nodes    ${g.nodes.length}  (${parts.join(", ")})`);
   console.log(`  edges    ${g.edges.length}`);
   console.log(`  file     ${outPath}`);
@@ -4649,7 +5624,7 @@ function recoverId(line) {
   return null;
 }
 function runMcpServer(opts) {
-  return new Promise((resolve7) => {
+  return new Promise((resolve8) => {
     const stdin = process.stdin;
     let buffer = "";
     let chain = Promise.resolve();
@@ -4701,11 +5676,11 @@ function runMcpServer(opts) {
         processLine(buffer);
         buffer = "";
       }
-      chain.then(() => resolve7()).catch(() => resolve7());
+      chain.then(() => resolve8()).catch(() => resolve8());
     });
     stdin.on("error", (e) => {
       console.error(`[mcp] stdin error: ${e.message}`);
-      chain.then(() => resolve7()).catch(() => resolve7());
+      chain.then(() => resolve8()).catch(() => resolve8());
     });
     stdin.resume();
   });
@@ -4825,7 +5800,7 @@ function holtTools() {
 }
 
 // src/version.ts
-var VERSION = "0.9.0";
+var VERSION = "0.10.0";
 
 // src/commands/mcp.ts
 function printSetup() {
@@ -4871,8 +5846,8 @@ async function mcp(sub, rest = []) {
 }
 
 // src/commands/hook.ts
-import { readFileSync as readFileSync13, writeFileSync as writeFileSync11, existsSync as existsSync13, mkdirSync as mkdirSync10, copyFileSync, realpathSync as realpathSync2 } from "fs";
-import { join as join13, dirname as dirname3 } from "path";
+import { readFileSync as readFileSync15, writeFileSync as writeFileSync12, existsSync as existsSync14, mkdirSync as mkdirSync11, copyFileSync, realpathSync as realpathSync2 } from "fs";
+import { join as join15, dirname as dirname4 } from "path";
 import { homedir as homedir3 } from "os";
 var EVENT = {
   inject: "UserPromptSubmit",
@@ -4883,26 +5858,26 @@ var HOOK_CMD = {
   capture: "holt hook capture"
 };
 function globalSettingsPath() {
-  return join13(homedir3(), ".claude", "settings.json");
+  return join15(homedir3(), ".claude", "settings.json");
 }
 function projectSettingsPath() {
-  return join13(process.cwd(), ".claude", "settings.json");
+  return join15(process.cwd(), ".claude", "settings.json");
 }
 function readSettings(path) {
-  if (!existsSync13(path)) return {};
+  if (!existsSync14(path)) return {};
   try {
-    const parsed = JSON.parse(readFileSync13(path, "utf8"));
+    const parsed = JSON.parse(readFileSync15(path, "utf8"));
     return parsed && typeof parsed === "object" ? parsed : {};
   } catch {
     throw new Error(`could not parse ${path} (not valid JSON) - leaving it untouched`);
   }
 }
 function writeSettings(path, settings) {
-  mkdirSync10(dirname3(path), { recursive: true });
-  writeFileSync11(path, JSON.stringify(settings, null, 2) + "\n", "utf8");
+  mkdirSync11(dirname4(path), { recursive: true });
+  writeFileSync12(path, JSON.stringify(settings, null, 2) + "\n", "utf8");
 }
 function backup(path) {
-  if (!existsSync13(path)) return null;
+  if (!existsSync14(path)) return null;
   const dest = `${path}.holt-bak`;
   try {
     copyFileSync(path, dest);
@@ -4992,7 +5967,7 @@ function remove(rest) {
   const paths = project ? [projectSettingsPath()] : [globalSettingsPath(), projectSettingsPath()];
   let touchedAny = false;
   for (const path of paths) {
-    if (!existsSync13(path)) continue;
+    if (!existsSync14(path)) continue;
     let settings;
     try {
       settings = readSettings(path);
@@ -5022,7 +5997,7 @@ function status(rest) {
   ];
   console.log(c.accent("  Holt ambient hooks"));
   for (const e of entries) {
-    if (!existsSync13(e.path)) {
+    if (!existsSync14(e.path)) {
       console.log(c.dim(`  ${e.label.padEnd(8)} ${e.path}  (no settings file)`));
       continue;
     }
@@ -5042,13 +6017,13 @@ function status(rest) {
   console.log(c.dim("  Runtime hooks only act in trusted Holt folders that already have .holt/memory."));
 }
 function readStdin(timeoutMs) {
-  return new Promise((resolve7) => {
+  return new Promise((resolve8) => {
     let input = "";
     let done = false;
     const finish = () => {
       if (done) return;
       done = true;
-      resolve7(input);
+      resolve8(input);
     };
     try {
       process.stdin.setEncoding("utf8");
@@ -5072,7 +6047,7 @@ function parseHookInput(raw) {
   }
 }
 function enterFolder(cwd) {
-  if (!cwd || !existsSync13(cwd)) return null;
+  if (!cwd || !existsSync14(cwd)) return null;
   try {
     const real = realpathSync2(cwd);
     process.chdir(real);
@@ -5083,7 +6058,7 @@ function enterFolder(cwd) {
 }
 function guardTrusted(real) {
   if (!isTrusted(real)) return false;
-  if (!existsSync13(memDir())) return false;
+  if (!existsSync14(memDir())) return false;
   return true;
 }
 async function inject() {
@@ -5110,7 +6085,7 @@ function readTranscript(path) {
   const out = [];
   let raw;
   try {
-    raw = readFileSync13(path, "utf8");
+    raw = readFileSync15(path, "utf8");
   } catch {
     return out;
   }
@@ -5174,6 +6149,15 @@ async function capture() {
     const n = await extractAndSaveFacts(brain, cfg, history, session);
     if (n > 0) process.stderr.write(`holt hook capture: saved ${n} fact${n === 1 ? "" : "s"} to ${memDir()}
 `);
+    if (cfg.wiki?.autoSync) {
+      const res = await syncWiki(cfg, () => resolveBrainMaintainer(cfg));
+      if (res.status === "ok" && res.changed) {
+        process.stderr.write(
+          `holt hook capture: updated the wiki (${res.created} created, ${res.updated} updated) in ${wikiDir()}
+`
+        );
+      }
+    }
   } catch (e) {
     process.stderr.write("holt hook capture: " + (e instanceof Error ? e.message : String(e)) + "\n");
   }
@@ -5231,8 +6215,8 @@ async function hook(sub, rest = []) {
 }
 
 // src/commands/run.ts
-import { writeFileSync as writeFileSync12 } from "fs";
-import { resolve as resolve4 } from "path";
+import { writeFileSync as writeFileSync13 } from "fs";
+import { resolve as resolve5 } from "path";
 var USAGE3 = [
   "  holt run <task> [options]",
   "",
@@ -5321,9 +6305,9 @@ async function run(args) {
     process.stdout.write("\n");
   }
   if (p.out) {
-    const target = resolve4(process.cwd(), p.out);
+    const target = resolve5(process.cwd(), p.out);
     try {
-      writeFileSync12(target, result.text, "utf8");
+      writeFileSync13(target, result.text, "utf8");
       process.stderr.write(c.dim(`saved to ${target}`) + "\n");
     } catch (e) {
       process.stderr.write(c.red(`Could not write ${target}: ${e.message}`) + "\n");
@@ -5334,38 +6318,38 @@ async function run(args) {
 
 // src/commands/schedule.ts
 import { spawnSync as spawnSync4 } from "child_process";
-import { writeFileSync as writeFileSync14, mkdirSync as mkdirSync12, rmSync as rmSync6, existsSync as existsSync14 } from "fs";
-import { dirname as dirname4 } from "path";
+import { writeFileSync as writeFileSync15, mkdirSync as mkdirSync13, rmSync as rmSync6, existsSync as existsSync15 } from "fs";
+import { dirname as dirname5 } from "path";
 
 // src/scheduler.ts
 import { homedir as homedir4 } from "os";
-import { join as join14 } from "path";
-import { readFileSync as readFileSync14, writeFileSync as writeFileSync13, mkdirSync as mkdirSync11 } from "fs";
+import { join as join16 } from "path";
+import { readFileSync as readFileSync16, writeFileSync as writeFileSync14, mkdirSync as mkdirSync12 } from "fs";
 import { randomUUID as randomUUID4 } from "crypto";
 import { spawnSync as spawnSync3 } from "child_process";
 function schedulesPath() {
-  return join14(GLOBAL_DIR, "schedules.json");
+  return join16(GLOBAL_DIR, "schedules.json");
 }
 function logsDir() {
-  return join14(GLOBAL_DIR, "logs");
+  return join16(GLOBAL_DIR, "logs");
 }
 function logPath(id) {
-  return join14(logsDir(), `${id}.log`);
+  return join16(logsDir(), `${id}.log`);
 }
 function plistPath(id) {
-  return join14(homedir4(), "Library", "LaunchAgents", `com.holt.${id}.plist`);
+  return join16(homedir4(), "Library", "LaunchAgents", `com.holt.${id}.plist`);
 }
 function loadJobs() {
   try {
-    const raw = JSON.parse(readFileSync14(schedulesPath(), "utf8"));
+    const raw = JSON.parse(readFileSync16(schedulesPath(), "utf8"));
     return Array.isArray(raw) ? raw : [];
   } catch {
     return [];
   }
 }
 function saveJobs(jobs) {
-  mkdirSync11(GLOBAL_DIR, { recursive: true });
-  writeFileSync13(schedulesPath(), JSON.stringify(jobs, null, 2) + "\n", "utf8");
+  mkdirSync12(GLOBAL_DIR, { recursive: true });
+  writeFileSync14(schedulesPath(), JSON.stringify(jobs, null, 2) + "\n", "utf8");
 }
 function addJob(job) {
   const jobs = loadJobs();
@@ -5473,7 +6457,7 @@ function appendCronLine(crontab, line) {
   return (base ? base + "\n" : "") + line + "\n";
 }
 function ensureLogsDir() {
-  mkdirSync11(logsDir(), { recursive: true });
+  mkdirSync12(logsDir(), { recursive: true });
 }
 
 // src/commands/schedule.ts
@@ -5499,8 +6483,8 @@ function parseAdd(rest) {
 }
 function installDarwin(job, holtPath) {
   const path = plistPath(job.id);
-  mkdirSync12(dirname4(path), { recursive: true });
-  writeFileSync14(path, buildLaunchdPlist(job, holtPath), "utf8");
+  mkdirSync13(dirname5(path), { recursive: true });
+  writeFileSync15(path, buildLaunchdPlist(job, holtPath), "utf8");
   const res = spawnSync4("launchctl", ["load", "-w", path], { encoding: "utf8" });
   if (res.status === 0) {
     console.log(c.green("  Loaded into launchd."));
@@ -5588,7 +6572,7 @@ function listCmd2() {
 }
 function removeDarwin(id) {
   const path = plistPath(id);
-  if (existsSync14(path)) {
+  if (existsSync15(path)) {
     spawnSync4("launchctl", ["unload", path], { encoding: "utf8" });
     try {
       rmSync6(path);
@@ -5651,29 +6635,29 @@ async function schedule(sub, rest = []) {
 
 // src/commands/routine.ts
 import { spawnSync as spawnSync5 } from "child_process";
-import { writeFileSync as writeFileSync16, mkdirSync as mkdirSync14, rmSync as rmSync7, existsSync as existsSync15 } from "fs";
-import { dirname as dirname5, resolve as resolve5 } from "path";
+import { writeFileSync as writeFileSync17, mkdirSync as mkdirSync15, rmSync as rmSync7, existsSync as existsSync16 } from "fs";
+import { dirname as dirname6, resolve as resolve6 } from "path";
 
 // src/routines.ts
-import { readFileSync as readFileSync15, writeFileSync as writeFileSync15, mkdirSync as mkdirSync13 } from "fs";
-import { join as join15 } from "path";
+import { readFileSync as readFileSync17, writeFileSync as writeFileSync16, mkdirSync as mkdirSync14 } from "fs";
+import { join as join17 } from "path";
 function sanitizeRoutineName(name) {
   return (name || "").trim().toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-");
 }
 function routinesPath() {
-  return join15(GLOBAL_DIR, "routines.json");
+  return join17(GLOBAL_DIR, "routines.json");
 }
 function loadRoutines() {
   try {
-    const raw = JSON.parse(readFileSync15(routinesPath(), "utf8"));
+    const raw = JSON.parse(readFileSync17(routinesPath(), "utf8"));
     return Array.isArray(raw) ? raw : [];
   } catch {
     return [];
   }
 }
 function saveRoutines(routines) {
-  mkdirSync13(GLOBAL_DIR, { recursive: true });
-  writeFileSync15(routinesPath(), JSON.stringify(routines, null, 2) + "\n", "utf8");
+  mkdirSync14(GLOBAL_DIR, { recursive: true });
+  writeFileSync16(routinesPath(), JSON.stringify(routines, null, 2) + "\n", "utf8");
 }
 function findRoutine(name) {
   const want = sanitizeRoutineName(name);
@@ -5733,8 +6717,8 @@ function routineJobId(name) {
 }
 function installDarwin2(job, holtPath) {
   const path = plistPath(job.id);
-  mkdirSync14(dirname5(path), { recursive: true });
-  writeFileSync16(path, buildLaunchdPlist(job, holtPath), "utf8");
+  mkdirSync15(dirname6(path), { recursive: true });
+  writeFileSync17(path, buildLaunchdPlist(job, holtPath), "utf8");
   const res = spawnSync5("launchctl", ["load", "-w", path], { encoding: "utf8" });
   if (res.status === 0) {
     console.log(c.green("  Loaded into launchd."));
@@ -5778,7 +6762,7 @@ function installSchedule(r) {
 }
 function removeScheduleDarwin(id) {
   const path = plistPath(id);
-  if (existsSync15(path)) {
+  if (existsSync16(path)) {
     spawnSync5("launchctl", ["unload", path], { encoding: "utf8" });
     try {
       rmSync7(path);
@@ -5972,9 +6956,9 @@ async function runCmd(rest) {
   if (!quiet && !streamed) process.stdout.write(result.text);
   if (!quiet && (streamed || result.text) && !result.text.endsWith("\n")) process.stdout.write("\n");
   if (outTarget) {
-    const target = resolve5(routine2.workspace, outTarget);
+    const target = resolve6(routine2.workspace, outTarget);
     try {
-      writeFileSync16(target, result.text, "utf8");
+      writeFileSync17(target, result.text, "utf8");
       if (!quiet) process.stderr.write(c.dim(`saved to ${target}`) + "\n");
     } catch (e) {
       process.stderr.write(c.red(`Could not write ${target}: ${e.message}`) + "\n");
@@ -6112,7 +7096,7 @@ async function routine(sub, rest = []) {
 }
 
 // src/commands/notify.ts
-import { readFileSync as readFileSync16 } from "fs";
+import { readFileSync as readFileSync18 } from "fs";
 async function notify(args) {
   const nonFlag = args.filter((a) => a !== "-" && !a.startsWith("--"));
   const wantsStdin = args.includes("-") || !process.stdin.isTTY;
@@ -6145,7 +7129,7 @@ async function notify(args) {
 }
 function readStdin2() {
   try {
-    return readFileSync16(0, "utf8");
+    return readFileSync18(0, "utf8");
   } catch {
     return "";
   }
@@ -6356,8 +7340,8 @@ async function doctor() {
 }
 
 // src/commands/write.ts
-import { writeFileSync as writeFileSync17 } from "fs";
-import { resolve as resolve6 } from "path";
+import { writeFileSync as writeFileSync18 } from "fs";
+import { resolve as resolve7 } from "path";
 
 // src/antiai.ts
 var EM_DASH = String.fromCharCode(8212);
@@ -6535,9 +7519,9 @@ async function write(args) {
   draft = stripEmDash(draft).trimEnd();
   process.stdout.write(draft + "\n");
   if (p.out) {
-    const target = resolve6(process.cwd(), p.out);
+    const target = resolve7(process.cwd(), p.out);
     try {
-      writeFileSync17(target, draft + "\n", "utf8");
+      writeFileSync18(target, draft + "\n", "utf8");
       process.stderr.write(c.dim(`saved to ${target}`) + "\n");
     } catch (e) {
       process.stderr.write(c.red(`Could not write ${target}: ${e.message}`) + "\n");