@holt-os/holt 0.5.1 → 0.6.0

package/README.md

@@ -37,7 +37,7 @@ During `holt init` you:
 1. **Trust the folder.**
 2. **Choose brains** (claude, codex, gemini). Holt installs any you pick that are missing.
 3. **Sign in.** For a newly installed brain, Holt starts that tool's own login (browser or its own prompt). Holt never stores your credentials.
-4. **Pick a default** brain and, optionally, a **launch command** (a short word like `ai` that runs `holt chat`).
+4. **Pick a default** brain and, optionally, a **launch command**: a short word like `ai` that starts `holt chat`. Holt installs it as a tiny launcher next to its own binary, so it works immediately in the same terminal, no sourcing or restart needed.
 5. **Enable semantic memory.** If you say yes, Holt sets up a local [Ollama](https://ollama.com) with a small embed model so recall works by meaning, fully offline.
 
 ## Using it
@@ -63,6 +63,8 @@ The point of `/brain`: Holt owns the transcript, so you can start a thread on on
 
 Every exchange is saved to `<folder>/.holt/memory/turns.jsonl`, private and local. On each message, Holt recalls the most relevant moments from your *past* sessions in that folder and hands them to the brain, so it remembers what you told it last week.
 
+When you end a chat, Holt asks the brain to distill 1 to 5 durable facts from the session (decisions, preferences, key names, numbers) and writes them to a human-readable `<folder>/.holt/memory/facts.md` you can read and edit. Those facts are also embedded and ranked slightly higher than raw turns during recall, so the signal rises to the top over time. See them with `holt memory facts`. Turn it off by setting `memory.extractFacts` to `false` in `config.json`.
+
 Two recall modes, picked automatically:
 
 - **Semantic** (best): a local [Ollama](https://ollama.com) with an embedding model, which `holt init` offers to set up for you. Recall matches by meaning: asking "who owns my apartment" finds "my landlord is called Pieter". No API keys, nothing leaves your machine.
@@ -72,6 +74,7 @@ Inspect it any time:
 
 ```bash
 holt memory                    # stats for this folder
+holt memory facts              # show the distilled facts (facts.md)
 holt memory search <query>     # find remembered moments
 holt memory embed              # embed older moments for semantic recall
 holt memory clear              # wipe this folder's memory
@@ -155,7 +158,7 @@ Small strongly-typed **TypeScript core**, zero runtime dependencies: command dis
 Built in always-shippable phases toward a full-vision v1:
 
 0. **Skeleton and chat**: trust, init with install and sign-in, chat, brain switching with kept context *(shipped)*
-1. **Memory**: per-folder store, semantic recall via local embeddings with keyword fallback, streaming replies *(shipped)*
+1. **Memory**: per-folder store, semantic recall, streaming replies, and distilled facts per session *(shipped)*
 2. **Any LLM directly**: API brains with your own key, HTML or Markdown output *(shipped)*
 3. **Skills**: portable SKILL.md skills, create/add/run *(shipped)*
 4. **Knowledge graph**: see and navigate your own memory with `holt graph` *(shipped)*

package/dist/cli.js

@@ -121,7 +121,7 @@ function defaultConfig() {
     const d = BRAIN_DEFS[id];
     brains[id] = { id, label: d.label, command: d.command, args: [...d.args], enabled: false };
   }
-  return { version: 3, defaultBrain: null, brains, apiBrains: [], outputFormat: "markdown" };
+  return { version: 4, defaultBrain: null, brains, apiBrains: [], outputFormat: "markdown", memory: { extractFacts: true } };
 }
 function loadConfig() {
   const path = wsConfigPath();
@@ -132,11 +132,14 @@ function loadConfig() {
     const brains = cfg.brains ?? {};
     for (const id of BRAIN_IDS) if (!brains[id]) brains[id] = base.brains[id];
     return {
-      version: 3,
+      version: 4,
       defaultBrain: cfg.defaultBrain ?? null,
       brains,
       apiBrains: Array.isArray(cfg.apiBrains) ? cfg.apiBrains : [],
-      outputFormat: cfg.outputFormat === "html" ? "html" : "markdown"
+      outputFormat: cfg.outputFormat === "html" ? "html" : "markdown",
+      memory: {
+        extractFacts: cfg.memory && typeof cfg.memory.extractFacts === "boolean" ? cfg.memory.extractFacts : true
+      }
     };
   } catch {
     return null;
@@ -248,17 +251,58 @@ function runBrain(brain, prompt, onChunk) {
 
 // src/alias.ts
 import { homedir as homedir2 } from "os";
-import { join as join3 } from "path";
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, existsSync as existsSync3 } from "fs";
+import { join as join3, dirname, delimiter } from "path";
+import {
+  readFileSync as readFileSync3,
+  writeFileSync as writeFileSync3,
+  existsSync as existsSync3,
+  mkdirSync as mkdirSync3,
+  rmSync,
+  chmodSync,
+  realpathSync
+} from "fs";
 var START = "# >>> holt launch alias >>>";
 var END = "# <<< holt launch alias <<<";
+var SHIM_MARKER = "# holt launcher";
+var GLOBAL_DIR2 = join3(homedir2(), ".holt");
+var LAUNCHER_STATE = join3(GLOBAL_DIR2, "launcher.json");
 function rcFile() {
   const shell = process.env.SHELL || "";
   if (shell.includes("zsh")) return join3(homedir2(), ".zshrc");
   if (shell.includes("bash")) return join3(homedir2(), ".bashrc");
   return join3(homedir2(), ".profile");
 }
-function installAlias(name) {
+function readState() {
+  try {
+    return JSON.parse(readFileSync3(LAUNCHER_STATE, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function writeState(state) {
+  mkdirSync3(GLOBAL_DIR2, { recursive: true });
+  if (state) writeFileSync3(LAUNCHER_STATE, JSON.stringify(state, null, 2) + "\n", "utf8");
+  else if (existsSync3(LAUNCHER_STATE)) rmSync(LAUNCHER_STATE);
+}
+function pathDirs() {
+  return (process.env.PATH || "").split(delimiter).filter(Boolean);
+}
+function launcherBinDir() {
+  const dirs = pathDirs();
+  const candidates = [];
+  const invoked = process.argv[1];
+  if (invoked) candidates.push(dirname(invoked));
+  candidates.push(dirname(process.execPath));
+  for (const dir of candidates) {
+    if (!dirs.includes(dir)) continue;
+    try {
+      if (dirs.includes(dir) || dirs.includes(realpathSync(dir))) return dir;
+    } catch {
+    }
+  }
+  return null;
+}
+function installRcAlias(name) {
   const file = rcFile();
   const block = `${START}
 alias ${name}="holt chat"
@@ -269,30 +313,80 @@ ${END}`;
     if (re.test(content)) content = content.replace(re, block);
     else content = content.replace(/\n*$/, "\n") + block + "\n";
     writeFileSync3(file, content, "utf8");
-    return { ok: true, file };
+    writeState({ name, kind: "rc", file });
+    return { ok: true, kind: "rc", file, immediate: false };
   } catch (e) {
-    return { ok: false, file, message: `Could not write ${file}: ${e.message}` };
+    return { ok: false, kind: "none", file, immediate: false, message: `Could not write ${file}: ${e.message}` };
   }
 }
-function currentAlias() {
-  const file = rcFile();
-  try {
-    const m = readFileSync3(file, "utf8").match(/alias\s+([^\s=]+)="holt chat"/);
-    return m ? m[1] : null;
-  } catch {
-    return null;
+function installAlias(name) {
+  removeAlias();
+  if (process.platform !== "win32") {
+    const binDir = launcherBinDir();
+    if (binDir) {
+      const file = join3(binDir, name);
+      if (existsSync3(file)) {
+        try {
+          if (!readFileSync3(file, "utf8").includes(SHIM_MARKER)) {
+            return { ok: false, kind: "none", file, immediate: false, message: `"${name}" already exists at ${file}. Pick another word.` };
+          }
+        } catch {
+          return { ok: false, kind: "none", file, immediate: false, message: `"${name}" already exists at ${file}. Pick another word.` };
+        }
+      }
+      try {
+        writeFileSync3(file, `#!/bin/sh
+${SHIM_MARKER}
+exec holt chat "$@"
+`, "utf8");
+        chmodSync(file, 493);
+        writeState({ name, kind: "bin", file });
+        return { ok: true, kind: "bin", file, immediate: true };
+      } catch {
+      }
+    }
   }
+  return installRcAlias(name);
 }
 function removeAlias() {
+  const state = readState();
+  if (state?.kind === "bin" && existsSync3(state.file)) {
+    try {
+      if (readFileSync3(state.file, "utf8").includes(SHIM_MARKER)) rmSync(state.file);
+    } catch {
+    }
+  }
   const file = rcFile();
   try {
     if (existsSync3(file)) {
       const content = readFileSync3(file, "utf8").replace(new RegExp(`\\n*${START}[\\s\\S]*?${END}\\n*`), "\n");
       writeFileSync3(file, content, "utf8");
     }
-    return { ok: true, file };
+    writeState(null);
+    return { ok: true, kind: "none", file, immediate: true };
   } catch (e) {
-    return { ok: false, file, message: e.message };
+    writeState(null);
+    return { ok: false, kind: "none", file, immediate: true, message: e.message };
+  }
+}
+function currentAlias() {
+  const state = readState();
+  if (state) {
+    if (state.kind === "bin") {
+      try {
+        if (existsSync3(state.file) && readFileSync3(state.file, "utf8").includes(SHIM_MARKER)) return state.name;
+      } catch {
+        return null;
+      }
+      return null;
+    }
+    return state.name;
+  }
+  try {
+    const m = readFileSync3(rcFile(), "utf8").match(/alias\s+([^\s=]+)="holt chat"/);
+    return m ? m[1] : null;
+  } catch {
+    return null;
   }
 }
 
@@ -313,7 +407,7 @@ function runInteractive(cmd, args) {
 }
 
 // src/memory.ts
-import { appendFileSync, readFileSync as readFileSync4, writeFileSync as writeFileSync4, existsSync as existsSync4, mkdirSync as mkdirSync3, rmSync, statSync } from "fs";
+import { appendFileSync, readFileSync as readFileSync4, writeFileSync as writeFileSync4, existsSync as existsSync4, mkdirSync as mkdirSync4, rmSync as rmSync2, statSync } from "fs";
 import { join as join4 } from "path";
 import { randomUUID } from "crypto";
 var OLLAMA_URL = process.env.HOLT_OLLAMA_URL || "http://127.0.0.1:11434";
@@ -324,6 +418,9 @@ function memDir() {
 function memPath() {
   return join4(memDir(), "turns.jsonl");
 }
+function factsMdPath() {
+  return join4(memDir(), "facts.md");
+}
 function newSessionId() {
   return randomUUID().slice(0, 8);
 }
@@ -373,18 +470,64 @@ function loadTurns() {
   return out;
 }
 function appendTurn(t) {
-  mkdirSync3(memDir(), { recursive: true });
+  mkdirSync4(memDir(), { recursive: true });
   appendFileSync(memPath(), JSON.stringify(t) + "\n", "utf8");
 }
 function clearMemory() {
-  if (existsSync4(memPath())) rmSync(memPath());
+  if (existsSync4(memPath())) rmSync2(memPath());
+}
+function normalizeFact(s) {
+  return s.toLowerCase().replace(/\s+/g, " ").trim().replace(/[.,;:!?]+$/, "");
+}
+var FACTS_HEADER = "# Holt facts\n\nDistilled memories for this folder. Safe to edit by hand.\n";
+async function saveFact(content, session) {
+  const clean = content.trim();
+  if (!clean) return false;
+  const norm2 = normalizeFact(clean);
+  for (const t of loadTurns()) {
+    if (t.role === "fact" && normalizeFact(t.content) === norm2) return false;
+  }
+  if (existsSync4(factsMdPath())) {
+    for (const line of readFileSync4(factsMdPath(), "utf8").split("\n")) {
+      const l = line.trim();
+      if (!l.startsWith("- ")) continue;
+      if (normalizeFact(l.slice(2)) === norm2) return false;
+    }
+  }
+  mkdirSync4(memDir(), { recursive: true });
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  let existing = existsSync4(factsMdPath()) ? readFileSync4(factsMdPath(), "utf8") : "";
+  if (!existing) existing = FACTS_HEADER;
+  const headings = existing.match(/^## (\d{4}-\d{2}-\d{2})/gm);
+  const lastHeading = headings && headings.length ? headings[headings.length - 1] : null;
+  const needsHeading = lastHeading !== `## ${today}`;
+  let addition = "";
+  if (needsHeading) {
+    if (!existing.endsWith("\n")) addition += "\n";
+    addition += `
+## ${today}
+`;
+  }
+  addition += `- ${clean}
+`;
+  writeFileSync4(factsMdPath(), existing + addition, "utf8");
+  appendTurn({
+    id: randomUUID().slice(0, 8),
+    ts: Date.now(),
+    session,
+    role: "fact",
+    content: clean,
+    emb: await embed(clean) ?? void 0
+  });
+  return true;
 }
 function memStats() {
   const turns = loadTurns();
   const sessions = new Set(turns.map((t) => t.session)).size;
   const withEmbeddings = turns.filter((t) => Array.isArray(t.emb)).length;
+  const facts = turns.filter((t) => t.role === "fact").length;
   const bytes = existsSync4(memPath()) ? statSync(memPath()).size : 0;
-  return { turns: turns.length, sessions, withEmbeddings, bytes };
+  return { turns: turns.length, facts, sessions, withEmbeddings, bytes };
 }
 function cosine(a, b) {
   let dot = 0;
@@ -412,6 +555,7 @@ function keywordScore(q, text) {
   for (const w of q) if (t.has(w)) hit++;
   return hit / q.size;
 }
+var FACT_BOOST = 1.15;
 async function recall(query, currentSession, k = 4) {
   const past = loadTurns().filter((t) => t.session !== currentSession);
   if (past.length === 0) return [];
@@ -422,7 +566,10 @@ async function recall(query, currentSession, k = 4) {
     let score = 0;
     if (qEmb && Array.isArray(turn.emb)) score = cosine(qEmb, turn.emb);
     else score = keywordScore(qTok, turn.content);
-    if (score > (qEmb && Array.isArray(turn.emb) ? 0.35 : 0.15)) scored.push({ turn, score });
+    if (score > (qEmb && Array.isArray(turn.emb) ? 0.35 : 0.15)) {
+      if (turn.role === "fact") score *= FACT_BOOST;
+      scored.push({ turn, score });
+    }
   }
   scored.sort((a, b) => b.score - a.score);
   return scored.slice(0, k);
@@ -442,7 +589,7 @@ async function backfillEmbeddings(onProgress) {
     done++;
     if (onProgress) onProgress(done, missing.length);
   }
-  mkdirSync3(memDir(), { recursive: true });
+  mkdirSync4(memDir(), { recursive: true });
   writeFileSync4(memPath(), turns.map((t) => JSON.stringify(t)).join("\n") + "\n", "utf8");
   return { embedded, total: missing.length };
 }
@@ -572,9 +719,10 @@ async function runSettings(ask) {
     } else if (choice === "a") {
       const name = (await ask("  launch command (blank to reset to holt): ") ?? "").trim();
       if (name && name !== "holt") {
-        if (isInstalled(name)) console.log(c.dim(`  note: "${name}" already exists; the alias will shadow it in new shells.`));
         const r = installAlias(name);
-        console.log(r.ok ? c.green(`  alias "${name}" -> holt chat added to ${r.file} (run: source ${r.file})`) : c.red("  " + r.message));
+        if (r.ok && r.immediate) console.log(c.green(`  "${name}" is ready to use right now.`));
+        else if (r.ok) console.log(c.green(`  alias "${name}" added to ${r.file}. Run: source ${r.file} (new terminals will not need it).`));
+        else console.log(c.red("  " + r.message));
       } else {
         removeAlias();
         console.log(c.dim("  reset to holt."));
@@ -646,12 +794,16 @@ Default brain? [${chosen.join("/")}] (${defPick}): `) ?? "").trim();
   const defaultBrain = chosen.includes(dans) ? dans : defPick;
   const aliasAns = (await ask('Launch command? Type a custom word like "ai", or press enter to keep "holt": ') ?? "").trim();
   let aliasNote = "";
-  let aliasRcFile = "";
+  let aliasNeedsSource = "";
+  let aliasWorked = false;
   if (aliasAns && aliasAns !== "holt") {
-    if (isInstalled(aliasAns)) console.log(c.dim(`  note: "${aliasAns}" already exists; the alias will shadow it in new shells.`));
     const r = installAlias(aliasAns);
-    if (r.ok) aliasRcFile = r.file;
-    aliasNote = r.ok ? c.green(`  alias "${aliasAns}" -> holt chat added to ${r.file}`) : c.red("  " + r.message);
+    aliasWorked = r.ok;
+    if (r.ok && r.immediate) aliasNote = c.green(`  "${aliasAns}" is ready to use right now (launcher at ${r.file}).`);
+    else if (r.ok) {
+      aliasNote = c.green(`  alias "${aliasAns}" -> holt chat added to ${r.file}`);
+      aliasNeedsSource = r.file;
+    } else aliasNote = c.red("  " + r.message);
   }
   let wantMemorySetup = false;
   const embedReady = await embeddingsAvailable();
@@ -708,9 +860,11 @@ Default brain? [${chosen.join("/")}] (${defPick}): `) ?? "").trim();
   console.log("\n" + c.green("Saved to ./.holt/config.json"));
   if (aliasNote) console.log(aliasNote);
   if (cfg.defaultBrain) {
-    if (aliasRcFile) {
+    if (aliasWorked && !aliasNeedsSource) {
+      console.log("Start chatting:  " + c.accent(aliasAns) + "\n");
+    } else if (aliasNeedsSource) {
       console.log("\nStart chatting:");
-      console.log("  " + c.accent(`source ${aliasRcFile}`) + c.dim("   (once; new terminals will not need it)"));
+      console.log("  " + c.accent(`source ${aliasNeedsSource}`) + c.dim("   (once; new terminals will not need it)"));
       console.log("  " + c.accent(aliasAns) + "\n");
       console.log(c.dim("  Or right now, without sourcing: holt chat\n"));
     } else {
@@ -877,6 +1031,115 @@ async function runApiBrain(brain, prompt, onChunk) {
   return { ok: false, text: `${brain.provider} returned an empty reply.` };
 }
 
+// src/facts.ts
+var MIN_EXCHANGES_FOR_EXTRACTION = 3;
+var MAX_TRANSCRIPT_TURNS = 20;
+var MAX_TURN_CHARS = 1e3;
+function buildExtractionPrompt(history) {
+  const recent = history.slice(-MAX_TRANSCRIPT_TURNS);
+  const transcript = recent.map((t) => `${t.role === "user" ? "USER" : "ASSISTANT"}: ${t.content.slice(0, MAX_TURN_CHARS)}`).join("\n\n");
+  const lines = [
+    "Given this conversation, extract 1 to 5 durable facts worth remembering long-term.",
+    "Output ONLY a JSON array of strings, no prose, no code fences.",
+    "",
+    "Rules:",
+    "- Keep decisions, outcomes, stable preferences, key names, dates, and numbers.",
+    "- Skip pleasantries, one-off questions, and generic advice.",
+    "- Make each fact self-contained so it reads on its own in a future session.",
+    "- If nothing is worth saving, output exactly []",
+    "",
+    "Good examples:",
+    '- "User decided to target the Netherlands as the primary job market, HSM visa route."',
+    '- "HDFC EMI is 17,394 rupees per month with 29 payments remaining as of March 2026."',
+    "",
+    "Bad examples (do NOT output these):",
+    '- "User asked a question about their finances."',
+    '- "The assistant gave some helpful advice."',
+    "",
+    "Conversation:",
+    transcript,
+    "",
+    "JSON array:"
+  ];
+  return lines.join("\n");
+}
+function firstBalancedArray(s) {
+  const start = s.indexOf("[");
+  if (start < 0) return null;
+  let depth = 0;
+  let inStr = false;
+  let esc = false;
+  for (let i = start; i < s.length; i++) {
+    const ch = s[i];
+    if (inStr) {
+      if (esc) esc = false;
+      else if (ch === "\\") esc = true;
+      else if (ch === '"') inStr = false;
+      continue;
+    }
+    if (ch === '"') inStr = true;
+    else if (ch === "[") depth++;
+    else if (ch === "]") {
+      depth--;
+      if (depth === 0) {
+        const slice = s.slice(start, i + 1);
+        try {
+          const parsed = JSON.parse(slice);
+          return Array.isArray(parsed) ? parsed : null;
+        } catch {
+          return null;
+        }
+      }
+    }
+  }
+  return null;
+}
+function norm(s) {
+  return s.toLowerCase().replace(/\s+/g, " ").trim().replace(/[.,;:!?]+$/, "");
+}
+function parseFacts(raw) {
+  let s = (raw || "").trim();
+  s = s.replace(/^```(?:json)?\s*/i, "").replace(/```\s*$/i, "").trim();
+  const m = s.match(/\[[\s\S]*\]/);
+  if (!m) return [];
+  let arr = null;
+  try {
+    arr = JSON.parse(m[0]);
+  } catch {
+    arr = firstBalancedArray(s);
+  }
+  if (!Array.isArray(arr)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const item of arr) {
+    if (typeof item !== "string") continue;
+    const v = String(item).trim();
+    if (v.length <= 10) continue;
+    const key = norm(v);
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(v);
+    if (out.length >= 5) break;
+  }
+  return out;
+}
+async function extractAndSaveFacts(active, cfg, history, session) {
+  try {
+    if (Math.floor(history.length / 2) < MIN_EXCHANGES_FOR_EXTRACTION) return 0;
+    const prompt = buildExtractionPrompt(history);
+    const res = active.kind === "cli" ? await runBrain(cfg.brains[active.id], prompt) : await runApiBrain(active.brain, prompt);
+    if (!res.ok) return 0;
+    const facts = parseFacts(res.text);
+    let saved = 0;
+    for (const f of facts) {
+      if (await saveFact(f, session)) saved++;
+    }
+    return saved;
+  } catch {
+    return 0;
+  }
+}
+
 // src/output.ts
 import { writeFileSync as writeFileSync5 } from "fs";
 import { join as join5 } from "path";
@@ -1203,7 +1466,7 @@ async function chat() {
   const stats = memStats();
   console.log("\n" + c.accent("Holt") + c.dim(`  brain: ${active.label}`));
   console.log(c.dim(
-    `Memory: ${stats.turns} moments from ${stats.sessions} session${stats.sessions === 1 ? "" : "s"} in this folder (recall: ${embedOk ? "embeddings via local Ollama" : "keyword match"}).`
+    `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.`));
@@ -1245,7 +1508,7 @@ async function chat() {
           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.sessions} sessions, ${s.withEmbeddings} embedded, ${(s.bytes / 1024).toFixed(1)} KB in ./.holt/memory/`));
+          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;
@@ -1353,6 +1616,14 @@ async function chat() {
       console.log(c.red("\n  " + res.text + "\n"));
     }
   }
+  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 {
+    }
+  }
   close();
   console.log(c.dim("\nBye.\n"));
 }
@@ -1374,6 +1645,7 @@ async function login(which) {
 }
 
 // src/commands/memory.ts
+import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
 async function memoryCmd(sub, rest = []) {
   const { ask, close } = createReader();
   if (!await ensureTrusted(ask)) {
@@ -1407,7 +1679,7 @@ async function memoryCmd(sub, rest = []) {
     }
     const missing = loadTurns().filter((t) => !Array.isArray(t.emb)).length;
     if (missing === 0) {
-      console.log(c.dim("\n  All moments already have embeddings.\n"));
+      console.log(c.dim("\n  All memories already have embeddings.\n"));
       close();
       return;
     }
@@ -1415,7 +1687,18 @@ async function memoryCmd(sub, rest = []) {
     const r = await backfillEmbeddings((done, total) => {
       process.stdout.write(`\r  embedding ${done}/${total}...`);
     });
-    console.log("\n" + c.green(`  Done. ${r.embedded} of ${r.total} moments embedded.`) + "\n");
+    console.log("\n" + c.green(`  Done. ${r.embedded} of ${r.total} memories embedded.`) + "\n");
+    close();
+    return;
+  }
+  if (action === "facts") {
+    if (!existsSync6(factsMdPath())) {
+      console.log(c.dim("\n  No facts distilled yet. They form when you end a chat session.\n"));
+      close();
+      return;
+    }
+    const body = readFileSync6(factsMdPath(), "utf8").trim();
+    console.log("\n" + body + "\n");
     close();
     return;
   }
@@ -1442,6 +1725,7 @@ async function memoryCmd(sub, rest = []) {
   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)`);
@@ -1451,20 +1735,21 @@ async function memoryCmd(sub, rest = []) {
   ${s.turns - s.withEmbeddings} moments lack embeddings. Run "holt memory embed" to upgrade them to semantic recall.`));
   }
   console.log(c.dim("\n  holt memory search <query>   find remembered moments"));
-  console.log(c.dim("  holt memory embed            embed older moments for semantic recall"));
+  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 clear            wipe this folder's memory\n"));
   close();
 }
 
 // src/commands/skill.ts
 import {
-  mkdirSync as mkdirSync4,
+  mkdirSync as mkdirSync5,
   writeFileSync as writeFileSync6,
-  readFileSync as readFileSync6,
-  existsSync as existsSync6,
+  readFileSync as readFileSync7,
+  existsSync as existsSync7,
   readdirSync as readdirSync2,
   statSync as statSync3,
-  rmSync as rmSync2,
+  rmSync as rmSync3,
   cpSync,
   mkdtempSync
 } from "fs";
@@ -1514,7 +1799,7 @@ function isGitUrl(s) {
   return s.includes("://") || s.endsWith(".git") || s.startsWith("git@");
 }
 function findSkillDir(root) {
-  if (existsSync6(join7(root, "SKILL.md"))) return root;
+  if (existsSync7(join7(root, "SKILL.md"))) return root;
   let subs = [];
   try {
     subs = readdirSync2(root).filter((f) => {
@@ -1527,7 +1812,7 @@ function findSkillDir(root) {
   } catch {
     return null;
   }
-  const withSkill = subs.filter((f) => existsSync6(join7(root, f, "SKILL.md")));
+  const withSkill = subs.filter((f) => existsSync7(join7(root, f, "SKILL.md")));
   if (withSkill.length === 1) return join7(root, withSkill[0]);
   return null;
 }
@@ -1580,13 +1865,13 @@ function cmdCreate(name, global) {
   }
   const scope = global ? "global" : "workspace";
   const dir = join7(skillsRoot(scope), clean);
-  if (existsSync6(dir)) {
+  if (existsSync7(dir)) {
     console.log(c.red(`
   A ${scope} skill named "${clean}" already exists.`));
     console.log(c.dim("  " + dir + "\n"));
     return;
   }
-  mkdirSync4(dir, { recursive: true });
+  mkdirSync5(dir, { recursive: true });
   writeFileSync6(join7(dir, "SKILL.md"), SKILL_TEMPLATE(clean), "utf8");
   console.log(c.green(`
   Created ${scope} skill "${clean}".`));
@@ -1614,7 +1899,7 @@ function cmdAdd(source, global) {
       fetched = tempDir;
     } else {
       fetched = resolve(source);
-      if (!existsSync6(fetched)) {
+      if (!existsSync7(fetched)) {
         console.log(c.red(`
   No such path: ${fetched}
 `));
@@ -1628,7 +1913,7 @@ function cmdAdd(source, global) {
     }
     let skillName = "";
     try {
-      const { data } = parseFrontmatter(readFileSync6(join7(skillDir, "SKILL.md"), "utf8"));
+      const { data } = parseFrontmatter(readFileSync7(join7(skillDir, "SKILL.md"), "utf8"));
       skillName = sanitizeName(data.name || "");
     } catch {
       skillName = "";
@@ -1639,23 +1924,23 @@ function cmdAdd(source, global) {
       return;
     }
     const dest = join7(skillsRoot(scope), skillName);
-    if (existsSync6(dest)) {
+    if (existsSync7(dest)) {
       console.log(c.red(`
   A ${scope} skill named "${skillName}" already exists.`));
       console.log(c.dim("  " + dest + "\n"));
       return;
     }
-    mkdirSync4(skillsRoot(scope), { recursive: true });
+    mkdirSync5(skillsRoot(scope), { recursive: true });
     cpSync(skillDir, dest, { recursive: true });
     const nestedGit = join7(dest, ".git");
-    if (existsSync6(nestedGit)) rmSync2(nestedGit, { recursive: true, force: true });
+    if (existsSync7(nestedGit)) rmSync3(nestedGit, { recursive: true, force: true });
     console.log(c.green(`
   Installed ${scope} skill "${skillName}".`));
     console.log(c.dim("  " + join7(dest, "SKILL.md") + "\n"));
   } finally {
-    if (tempDir && existsSync6(tempDir)) {
+    if (tempDir && existsSync7(tempDir)) {
       try {
-        rmSync2(tempDir, { recursive: true, force: true });
+        rmSync3(tempDir, { recursive: true, force: true });
       } catch {
       }
     }
@@ -1669,7 +1954,7 @@ async function cmdRemove(name, ask) {
   }
   const wsDir = join7(skillsRoot("workspace"), clean);
   const globalDir = join7(skillsRoot("global"), clean);
-  const target = existsSync6(wsDir) ? wsDir : existsSync6(globalDir) ? globalDir : "";
+  const target = existsSync7(wsDir) ? wsDir : existsSync7(globalDir) ? globalDir : "";
   if (!target) {
     console.log(c.dim(`
   No skill named "${clean}" found.
@@ -1680,7 +1965,7 @@ async function cmdRemove(name, ask) {
   const a = (await ask(`
   Delete ${scope} skill "${clean}"? [y/N] `) ?? "").trim().toLowerCase();
   if (a === "y" || a === "yes") {
-    rmSync2(target, { recursive: true, force: true });
+    rmSync3(target, { recursive: true, force: true });
     console.log(c.green("  Removed.\n"));
   } else {
     console.log(c.dim("  Kept.\n"));
@@ -1727,8 +2012,8 @@ async function skillCmd(sub, rest = []) {
 }
 
 // src/commands/graph.ts
-import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync5 } from "fs";
-import { join as join8, dirname, resolve as resolve2 } from "path";
+import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync6 } from "fs";
+import { join as join8, dirname as dirname2, resolve as resolve2 } from "path";
 import { spawn as spawn3 } from "child_process";
 
 // src/graphview.ts
@@ -2393,7 +2678,7 @@ async function graph(args = []) {
     edges: g.edges.length
   });
   const outPath = opts.out ? resolve2(opts.out) : join8(wsHoltDir(), "graph.html");
-  mkdirSync5(dirname(outPath), { recursive: true });
+  mkdirSync6(dirname2(outPath), { recursive: true });
   writeFileSync7(outPath, html, "utf8");
   console.log("\n" + c.accent("Memory graph built") + c.dim("  (this folder)"));
   console.log(`  nodes    ${g.nodes.length}  (${turns.length} turns, ${conceptCount} concepts)`);
@@ -2408,7 +2693,7 @@ async function graph(args = []) {
 }
 
 // src/cli.ts
-var VERSION = "0.5.1";
+var VERSION = "0.6.0";
 var BANNER = `
   \u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557
   \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551  \u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holt-os/holt",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "An open-source personal agent OS: any LLM, private memory you can see and walk.",
   "type": "module",
   "license": "MIT",