imprnt 0.1.3 → 0.1.4-edge.88

package/dist/cli.js

@@ -1879,6 +1879,28 @@ var init_tags = __esm(() => {
 var exports_recall = {};
 import { lstatSync as lstatSync2, readdirSync as readdirSync6, readFileSync as readFileSync11 } from "node:fs";
 import { basename as basename4, join as join12, relative as relative4 } from "node:path";
+function stemWord(w) {
+  if (w.length <= 3)
+    return w;
+  if (/[a-z]$/.test(w) === false)
+    return w;
+  if (w.endsWith("sses"))
+    return w.slice(0, -2);
+  if (w.endsWith("ies") && w.length > 4)
+    return w.slice(0, -3) + "y";
+  if (w.endsWith("ss") || w.endsWith("us") || w.endsWith("is")) {} else if (w.endsWith("s") && !w.endsWith("ous"))
+    w = w.slice(0, -1);
+  if (w.length > 4 && w.endsWith("ing")) {
+    const base = w.slice(0, -3);
+    if (base.length >= 3)
+      w = /([bdfglmnprt])\1$/.test(base) ? base.slice(0, -1) : base;
+  } else if (w.length > 3 && w.endsWith("ed")) {
+    const base = w.slice(0, -2);
+    if (base.length >= 3)
+      w = /([bdfglmnprt])\1$/.test(base) ? base.slice(0, -1) : base;
+  }
+  return w;
+}
 function walk2(dir2) {
   const out = [];
   for (const entry of readdirSync6(dir2)) {
@@ -1902,7 +1924,53 @@ function walk2(dir2) {
   }
   return out;
 }
-var args2, vault2, limit = 15, positional2, query, vocab, MAX_SYNONYM_NGRAM, STOPWORDS, tokenize = (text2) => text2.normalize("NFC").toLowerCase().replace(/['’]/gu, "").split(/[^\p{L}\p{N}]+/u).filter(Boolean), phraseSynonymTokens = (q) => {
+function bestPassages(absPath, n) {
+  let raw = "";
+  try {
+    raw = stripBom(readFileSync11(absPath, "utf8"));
+  } catch {
+    return [];
+  }
+  const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  const body2 = fmMatch ? raw.slice(fmMatch.index + fmMatch[0].length) : raw;
+  const paras = body2.split(/\n\s*\n/).map((p) => p.trim()).filter((p) => p.length > 0);
+  if (paras.length <= n)
+    return paras;
+  const scoredParas = paras.map((p) => {
+    const tf = new Map;
+    for (const t of tokenize(p))
+      tf.set(t, (tf.get(t) ?? 0) + 1);
+    let plen = 0;
+    for (const c of tf.values())
+      plen += c;
+    let sc = 0;
+    const used = new Set;
+    for (const group of scoringGroups) {
+      let best = 0, bv = "";
+      for (const v of group) {
+        if (used.has(v))
+          continue;
+        const x = bm25Term(tf.get(v) ?? 0, plen, variantIdf.get(v) ?? 0);
+        if (x > best) {
+          best = x;
+          bv = v;
+        }
+      }
+      if (best > 0) {
+        sc += best;
+        used.add(bv);
+      }
+    }
+    return { p, sc };
+  });
+  const keep = new Set(scoredParas.slice().sort((a, b) => b.sc - a.sc).slice(0, n).filter((x) => x.sc > 0).map((x) => x.p));
+  const out = paras.filter((p) => keep.has(p));
+  return out.length ? out : paras.slice(0, n);
+}
+var args2, vault2, limit = 15, gap = 0, passages = 0, proximity = false, coverage = false, stem = false, positional2, query, vocab, MAX_SYNONYM_NGRAM, STOPWORDS, tokenize = (text2) => {
+  const raw = text2.normalize("NFC").toLowerCase().replace(/['’]/gu, "").split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+  return stem ? raw.map(stemWord) : raw;
+}, phraseSynonymTokens = (q) => {
   const out = [];
   const words = q.normalize("NFC").toLowerCase().split(/[\s-]+/).map((w) => w.replace(/^[^\p{L}\p{N}]+|[^\p{L}\p{N}]+$/gu, "")).filter(Boolean);
   for (let n = Math.min(words.length, MAX_SYNONYM_NGRAM);n >= 2; n--) {
@@ -1916,14 +1984,14 @@ var args2, vault2, limit = 15, positional2, query, vocab, MAX_SYNONYM_NGRAM, STO
     }
   }
   return out;
-}, rawTerms, contentTerms, baseTerms, queryTerms, CONTROL2, files, TITLE_BOOST = 3, TAG_BOOST = 2, SUMMARY_BOOST = 1, BODY_BOOST = 1, docs, df, N, avgdl, K1 = 1.5, B = 0.75, idf = (term) => {
+}, rawTerms, contentTerms, baseTerms, queryTerms, queryVariantSet, CONTROL2, files, TITLE_BOOST = 3, TAG_BOOST = 2, SUMMARY_BOOST = 1, BODY_BOOST = 1, docs, df, N, avgdl, K1 = 1.5, B = 0.75, PROX_WINDOW = 25, PROX_WEIGHT = 0.35, idf = (term) => {
   const n = df.get(term) ?? 0;
   return Math.max(0, Math.log(1 + (N - n + 0.5) / (n + 0.5)));
 }, bm25Term = (tf, dl, termIdf) => {
   if (tf <= 0)
     return 0;
   return termIdf * (tf * (K1 + 1)) / (tf + K1 * (1 - B + B * (dl / avgdl)));
-}, variantIdf, hits, scoringGroups, shown, expanded;
+}, variantIdf, hits, scoringGroups, cut, shown, expanded;
 var init_recall = __esm(() => {
   init_tags();
   init_moc();
@@ -1950,12 +2018,42 @@ var init_recall = __esm(() => {
         process.exit(1);
       }
       limit = n;
+    } else if (args2[i] === "--proximity") {
+      proximity = true;
+    } else if (args2[i] === "--coverage") {
+      coverage = true;
+    } else if (args2[i] === "--stem") {
+      stem = true;
+    } else if (args2[i] === "--passages") {
+      const tok = args2[++i];
+      if (tok === undefined || !/^[0-9]+$/.test(tok)) {
+        console.error("--passages must be a positive integer");
+        process.exit(1);
+      }
+      const n = parseInt(tok, 10);
+      if (!Number.isFinite(n) || n <= 0) {
+        console.error("--passages must be a positive integer");
+        process.exit(1);
+      }
+      passages = n;
+    } else if (args2[i] === "--gap") {
+      const tok = args2[++i];
+      if (tok === undefined || !/^0?\.[0-9]+$/.test(tok)) {
+        console.error("--gap must be a ratio between 0 and 1 (e.g. 0.25)");
+        process.exit(1);
+      }
+      const g = parseFloat(tok);
+      if (!Number.isFinite(g) || g <= 0 || g >= 1) {
+        console.error("--gap must be a ratio between 0 and 1 (e.g. 0.25)");
+        process.exit(1);
+      }
+      gap = g;
     } else
       positional2.push(args2[i]);
   }
   query = positional2.join(" ").trim();
   if (!query) {
-    console.error('usage: imprnt recall "<query>" [--vault DIR] [--limit N]');
+    console.error('usage: imprnt recall "<query>" [--vault DIR] [--limit N] [--gap R] [--passages N] [--proximity] [--coverage] [--stem]');
     process.exit(1);
   }
   vocab = loadTags(vault2);
@@ -2063,6 +2161,7 @@ var init_recall = __esm(() => {
   contentTerms = rawTerms.filter((w) => !STOPWORDS.has(w));
   baseTerms = contentTerms.length ? contentTerms : rawTerms;
   queryTerms = baseTerms.map((w) => [...new Set([w, ...tokenize(normalize(vocab, w))])]);
+  queryVariantSet = new Set(queryTerms.flat());
   for (const t of phraseSynonymTokens(query)) {
     if (!STOPWORDS.has(t))
       queryTerms.push([t]);
@@ -2099,11 +2198,26 @@ var init_recall = __esm(() => {
     add(tokenize(aliases), TITLE_BOOST);
     add(tags.flatMap(tokenize), TAG_BOOST);
     add(tokenize(summary), SUMMARY_BOOST);
-    add(tokenize(body2), BODY_BOOST);
+    const bodyTokens = tokenize(body2);
+    add(bodyTokens, BODY_BOOST);
+    let pos;
+    if (proximity) {
+      pos = new Map;
+      for (let bi = 0;bi < bodyTokens.length; bi++) {
+        const t = bodyTokens[bi];
+        if (!queryVariantSet.has(t))
+          continue;
+        const arr = pos.get(t);
+        if (arr)
+          arr.push(bi);
+        else
+          pos.set(t, [bi]);
+      }
+    }
     let len = 0;
     for (const c of tf.values())
       len += c;
-    docs.push({ path, tf, len });
+    docs.push({ path, tf, len, pos });
     for (const term of tf.keys())
       df.set(term, (df.get(term) ?? 0) + 1);
   }
@@ -2136,23 +2250,69 @@ var init_recall = __esm(() => {
         scored.add(bestVariant);
       }
     }
-    if (score > 0)
+    if (score > 0) {
+      if (coverage && scoringGroups.length > 1) {
+        score *= 0.5 + 0.5 * (scored.size / scoringGroups.length);
+      }
+      if (proximity && d.pos && scored.size > 1) {
+        const present = [...scored].filter((t) => d.pos.has(t));
+        let bonus = 0;
+        for (let x = 0;x < present.length; x++) {
+          for (let y = x + 1;y < present.length; y++) {
+            const a = d.pos.get(present[x]), b = d.pos.get(present[y]);
+            let best = Infinity;
+            for (let ia = 0, ib = 0;ia < a.length && ib < b.length; ) {
+              const dist = Math.abs(a[ia] - b[ib]);
+              if (dist < best)
+                best = dist;
+              if (a[ia] < b[ib])
+                ia++;
+              else
+                ib++;
+            }
+            if (best < PROX_WINDOW) {
+              const w = Math.min(variantIdf.get(present[x]) ?? 0, variantIdf.get(present[y]) ?? 0);
+              bonus += PROX_WEIGHT * w * (1 - best / PROX_WINDOW);
+            }
+          }
+        }
+        score += bonus;
+      }
       hits.push({ path: relative4(vault2, d.path), score: Math.round(score * 100) / 100 });
+    }
   }
   hits.sort((a, b) => b.score - a.score || a.path.localeCompare(b.path));
   if (!hits.length) {
     console.log(`no matches for "${query}" in ${vault2}`);
     process.exit(0);
   }
-  shown = hits.slice(0, limit);
+  cut = Math.min(limit, hits.length);
+  if (gap > 0) {
+    for (let i = 1;i < cut; i++) {
+      if (hits[i].score < gap * hits[i - 1].score) {
+        cut = i;
+        break;
+      }
+    }
+  }
+  shown = hits.slice(0, cut);
   expanded = queryTerms.map((g) => g.join("|")).join(" ");
-  console.log(`recall "${query}" [${expanded}] — ${hits.length} match(es)${hits.length > shown.length ? `, showing top ${shown.length}` : ""}, BM25-ranked:
+  console.log(`recall "${query}" [${expanded}] - ${hits.length} match(es)${hits.length > shown.length ? `, showing top ${shown.length}` : ""}, BM25-ranked:
 `);
-  for (const h of shown)
+  for (const h of shown) {
     console.log(`  [${h.score.toFixed(2)}] ${h.path}`);
+    if (passages > 0) {
+      for (const p of bestPassages(join12(vault2, h.path), passages)) {
+        for (const line of p.split(`
+`))
+          console.log(`      ${line}`);
+        console.log("");
+      }
+    }
+  }
   if (hits.length > shown.length) {
     console.log(`
-  … ${hits.length - shown.length} lower-ranked hit(s) hidden. Raise with --limit if needed; usually you don't.`);
+  ... ${hits.length - shown.length} lower-ranked hit(s) hidden. Raise with --limit if needed. Usually you do not.`);
   }
 });
 
@@ -2261,11 +2421,11 @@ var init_snapshot = __esm(() => {
         continue;
       }
       const ext = extname2(rel);
-      const stem = rel.slice(0, rel.length - ext.length);
-      let relD = `${stem}-${hash2.slice(0, 8)}${ext}`;
+      const stem2 = rel.slice(0, rel.length - ext.length);
+      let relD = `${stem2}-${hash2.slice(0, 8)}${ext}`;
       let n = 2;
       while (existsSync11(join13(destRoot, relD)) && Buffer.compare(readFileSync12(join13(destRoot, relD)), srcBytes2) !== 0) {
-        relD = `${stem}-${hash2.slice(0, 8)}-${n}${ext}`;
+        relD = `${stem2}-${hash2.slice(0, 8)}-${n}${ext}`;
         n++;
       }
       rawPath2 = join13(destRoot, relD);
@@ -2661,19 +2821,177 @@ all plugin checks passed.`);
   }
 });
 
-// scripts/cli.ts
-var exports_cli = {};
-import { cpSync as cpSync3, mkdirSync as mkdirSync5, chmodSync, existsSync as existsSync13, readFileSync as readFileSync14, lstatSync as lstatSync4, statSync as statSync9, realpathSync as realpathSync2 } from "node:fs";
+// scripts/vault.ts
+var exports_vault = {};
 import { spawnSync as spawnSync4 } from "node:child_process";
-import { join as join15, dirname as dirname4, resolve as resolve6, basename as basename6 } from "node:path";
+import { existsSync as existsSync13, mkdirSync as mkdirSync5, readdirSync as readdirSync9, statSync as statSync9 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
+import { basename as basename6, dirname as dirname4, join as join15, resolve as resolve6 } from "node:path";
+function noteCount(project) {
+  const root = join15(project, "vault");
+  if (!existsSync13(root))
+    return 0;
+  let n = 0;
+  const walk3 = (dir2, atRoot) => {
+    for (const e of readdirSync9(dir2, { withFileTypes: true })) {
+      if (e.name.startsWith(".") || e.name.startsWith("_"))
+        continue;
+      if (e.isSymbolicLink())
+        continue;
+      if (atRoot && CONTROL3.has(e.name))
+        continue;
+      if (e.isDirectory())
+        walk3(join15(dir2, e.name), false);
+      else if (e.name.endsWith(".md"))
+        n++;
+    }
+  };
+  try {
+    walk3(root, true);
+  } catch {}
+  return n;
+}
+function resolveTarget(token) {
+  const reg = readRegistry();
+  if (token) {
+    if (reg.vaults[token])
+      return { name: token, path: reg.vaults[token] };
+    const p = expand(token);
+    if (isVaultProject(p)) {
+      const named = Object.entries(reg.vaults).find(([, v]) => v === p)?.[0];
+      return { name: named ?? basename6(p), path: p };
+    }
+    console.error(`no vault called "${token}", and ${p} is not a vault project`);
+    console.error(`known: ${Object.keys(reg.vaults).join(", ") || "(none registered — run `imprnt init`)"}`);
+    process.exit(1);
+  }
+  const name = reg.default ?? Object.keys(reg.vaults)[0];
+  const path = name ? reg.vaults[name] : undefined;
+  if (!name || !path) {
+    console.error("no vault registered — run `imprnt init`");
+    process.exit(1);
+  }
+  return { name, path };
+}
+function tar(...a) {
+  const r = spawnSync4("tar", a, { stdio: ["ignore", "inherit", "inherit"] });
+  if (r.error) {
+    console.error(`tar is not available: ${r.error.message}`);
+    process.exit(1);
+  }
+  return r.status ?? 1;
+}
+var args5, sub, flag = (name) => {
+  const i = args5.indexOf(name);
+  return i >= 0 ? args5[i + 1] : undefined;
+}, positionals, expand = (p) => resolve6(p.startsWith("~/") ? join15(homedir4(), p.slice(2)) : p), CONTROL3;
+var init_vault = __esm(() => {
+  init_registry();
+  args5 = process.argv.slice(2);
+  sub = args5[0];
+  positionals = args5.slice(1).filter((a, i, all2) => !a.startsWith("--") && !(i > 0 && all2[i - 1]?.startsWith("--")));
+  CONTROL3 = new Set(["index.md", "hot.md", "log.md", "_tags.md"]);
+  switch (sub) {
+    case "list": {
+      const reg = readRegistry();
+      const names = Object.keys(reg.vaults);
+      if (!names.length) {
+        console.log("no vaults registered — run `imprnt init`");
+        break;
+      }
+      const def = reg.default ?? names[0];
+      for (const n of names) {
+        const p = reg.vaults[n];
+        const live = isVaultProject(p);
+        const mark = n === def ? "*" : " ";
+        const detail = live ? `${noteCount(p)} notes` : "MISSING — the path is registered but holds no vault";
+        console.log(`${mark} ${n.padEnd(12)} ${p}  (${detail})`);
+      }
+      console.log("\n* = default (what `imp` and `imprnt context` resolve to)");
+      break;
+    }
+    case "archive": {
+      const { name, path } = resolveTarget(positionals[0]);
+      if (!isVaultProject(path)) {
+        console.error(`${path} is not a vault project`);
+        process.exit(1);
+      }
+      const outDir = expand(flag("--out") ?? ".");
+      mkdirSync5(outDir, { recursive: true });
+      const stamp = new Date().toISOString().slice(0, 10);
+      const out = join15(outDir, `${name}-${stamp}.tar.gz`);
+      if (tar("czf", out, "-C", dirname4(path), basename6(path)) !== 0) {
+        console.error("archive failed");
+        process.exit(1);
+      }
+      if (tar("tzf", out) !== 0) {
+        console.error(`${out} does not read back — treat it as no archive at all`);
+        process.exit(1);
+      }
+      const size = (statSync9(out).size / 1024 / 1024).toFixed(1);
+      console.log(`archived ${name} (${noteCount(path)} notes) → ${out}  ${size} MB, verified`);
+      console.log(`restore with: imprnt vault restore ${out} <dir>`);
+      break;
+    }
+    case "restore": {
+      const src3 = expand(positionals[0] ?? "");
+      const dest2 = expand(positionals[1] ?? "");
+      if (!positionals[0] || !positionals[1]) {
+        console.error("usage: imprnt vault restore <archive.tar.gz> <dir>");
+        process.exit(1);
+      }
+      if (!existsSync13(src3)) {
+        console.error(`no archive at ${src3}`);
+        process.exit(1);
+      }
+      if (existsSync13(dest2) && readdirSync9(dest2).length) {
+        console.error(`${dest2} is not empty — restore into a new directory, then move it`);
+        process.exit(1);
+      }
+      mkdirSync5(dest2, { recursive: true });
+      if (tar("xzf", src3, "-C", dest2) !== 0) {
+        console.error("restore failed");
+        process.exit(1);
+      }
+      const inner = readdirSync9(dest2).map((e) => join15(dest2, e)).filter((p) => statSync9(p).isDirectory());
+      const project = inner.find((p) => isVaultProject(p)) ?? (isVaultProject(dest2) ? dest2 : undefined);
+      if (!project) {
+        console.error(`extracted, but ${dest2} holds no vault project — check the archive`);
+        process.exit(1);
+      }
+      console.log(`restored ${noteCount(project)} notes → ${project}`);
+      console.log(`register it with: cd ${project} && imprnt init`);
+      break;
+    }
+    default:
+      console.log(`imprnt vault — the vault as its own object
+
+  imprnt vault list                        vaults registered on this machine
+  imprnt vault archive [name|path]         one verified tarball  (--out <dir>)
+  imprnt vault restore <archive> <dir>     put one back
+
+Create one with \`imprnt init\`. There is no \`vault delete\`: removing knowledge is a
+human act with rm and a path, not a subcommand a script or an agent can reach.
+
+A vault means something with no agent attached. An agent with no vault is a process
+pointed at nothing — so the vault outlives whatever reads it.`);
+      process.exit(sub && sub !== "help" && sub !== "--help" ? 1 : 0);
+  }
+});
+
+// scripts/cli.ts
+var exports_cli = {};
+import { cpSync as cpSync3, mkdirSync as mkdirSync6, chmodSync, existsSync as existsSync14, readFileSync as readFileSync14, lstatSync as lstatSync4, statSync as statSync10, realpathSync as realpathSync2 } from "node:fs";
+import { spawnSync as spawnSync5 } from "node:child_process";
+import { join as join16, dirname as dirname5, resolve as resolve7, basename as basename7 } from "node:path";
+import { homedir as homedir5 } from "node:os";
 import { fileURLToPath } from "node:url";
 import { createInterface as createInterface2 } from "node:readline/promises";
 function pluginRoot() {
   const local = projectRoot();
   if (process.env.IMPRNT_ROOT || process.env.IMPRINT_ROOT)
     return local;
-  if (existsSync13(join15(local, "vault")) || existsSync13(join15(local, "CLAUDE.local.md")))
+  if (existsSync14(join16(local, "vault")) || existsSync14(join16(local, "CLAUDE.local.md")))
     return local;
   return registeredRoot() ?? local;
 }
@@ -2697,29 +3015,29 @@ function requireVaultHome() {
   }
   return home;
 }
-function resolvePath(input, base = process.cwd(), home = homedir4()) {
+function resolvePath(input, base = process.cwd(), home = homedir5()) {
   let p = input;
   if (p === "~")
     p = home;
   else if (p.startsWith("~/"))
-    p = join15(home, p.slice(2));
-  return resolve6(base, p);
+    p = join16(home, p.slice(2));
+  return resolve7(base, p);
 }
-function initPositional(args5) {
-  return args5.find((a) => !a.startsWith("-"));
+function initPositional(args6) {
+  return args6.find((a) => !a.startsWith("-"));
 }
 function physicalTarget(target) {
   let existing = target;
   const tail = [];
-  while (!existsSync13(existing)) {
-    const parent = dirname4(existing);
+  while (!existsSync14(existing)) {
+    const parent = dirname5(existing);
     if (parent === existing)
       return target;
-    tail.unshift(basename6(existing));
+    tail.unshift(basename7(existing));
     existing = parent;
   }
   try {
-    return tail.length ? join15(realpathSync2(existing), ...tail) : realpathSync2(existing);
+    return tail.length ? join16(realpathSync2(existing), ...tail) : realpathSync2(existing);
   } catch {
     return target;
   }
@@ -2735,7 +3053,7 @@ function controlSlot(dst) {
     return "blocked-directory";
   if (st.isSymbolicLink()) {
     try {
-      return statSync9(dst).isFile() ? "keep" : "blocked-symlink";
+      return statSync10(dst).isFile() ? "keep" : "blocked-symlink";
     } catch {
       return "blocked-symlink";
     }
@@ -2754,11 +3072,11 @@ var init_cli = __esm(async () => {
   init_moc();
   init_registry();
   init_launch();
-  here = dirname4(fileURLToPath(import.meta.url));
-  pkgRoot = join15(here, "..");
+  here = dirname5(fileURLToPath(import.meta.url));
+  pkgRoot = join16(here, "..");
   [cmd, ...rest] = process.argv.slice(2);
   asImp = globalThis.__IMPRNT_IMP__ === true;
-  if (["ingest", "recall", "snapshot", "check"].includes(cmd))
+  if (["ingest", "recall", "snapshot", "check", "vault"].includes(cmd))
     process.argv.splice(2, 1);
   switch (cmd) {
     case "ingest":
@@ -2773,6 +3091,9 @@ var init_cli = __esm(async () => {
     case "check":
       await Promise.resolve().then(() => (init_check(), exports_check));
       break;
+    case "vault":
+      await Promise.resolve().then(() => (init_vault(), exports_vault));
+      break;
     case "hot": {
       const vault5 = vaultArg();
       const review2 = openNeedsReview(vault5);
@@ -2782,8 +3103,8 @@ var init_cli = __esm(async () => {
           console.log(r);
         console.log("");
       }
-      const p = join15(vault5, "hot.md");
-      if (!existsSync13(p)) {
+      const p = join16(vault5, "hot.md");
+      if (!existsSync14(p)) {
         console.error(`no hot.md at ${p} — run \`imprnt init\``);
         process.exit(1);
       }
@@ -2799,8 +3120,8 @@ var init_cli = __esm(async () => {
     }
     case "context": {
       const home = requireVaultHome();
-      const contract = join15(home, "CLAUDE.md");
-      if (!existsSync13(contract)) {
+      const contract = join16(home, "CLAUDE.md");
+      if (!existsSync14(contract)) {
         console.error(`no CLAUDE.md at ${home} — run \`imprnt init\` there to drop the contract`);
         process.exit(1);
       }
@@ -2883,8 +3204,8 @@ var init_cli = __esm(async () => {
       const proj = pluginRoot();
       if (proj !== process.cwd())
         console.error(`(targeting vault project: ${proj})`);
-      const [sub, ...specs] = rest;
-      if (sub === "list") {
+      const [sub2, ...specs] = rest;
+      if (sub2 === "list") {
         const dirs = listPluginDirs(proj);
         console.log("plugins:");
         if (!dirs.length)
@@ -2899,7 +3220,7 @@ available to add: ${available.join(", ")}`);
 enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
         break;
       }
-      if (sub === "add") {
+      if (sub2 === "add") {
         let from;
         let force = false;
         const names = [];
@@ -2963,7 +3284,7 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
           process.exit(1);
         break;
       }
-      if (sub === "rm") {
+      if (sub2 === "rm") {
         let purge = false;
         const names = [];
         for (const s of specs) {
@@ -3003,9 +3324,9 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
       process.exit(1);
     }
     case "global": {
-      const globalDir = process.env.CLAUDE_CONFIG_DIR || join15(homedir4(), ".claude");
-      const [sub, ...gargs] = rest;
-      if (sub === "list") {
+      const globalDir = process.env.CLAUDE_CONFIG_DIR || join16(homedir5(), ".claude");
+      const [sub2, ...gargs] = rest;
+      if (sub2 === "list") {
         const enabled = listGlobalModules(globalDir);
         const onDisk = installedGlobalDirs(globalDir);
         console.log(`global modules (in ${globalDir}/imprnt/):`);
@@ -3019,7 +3340,7 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
         console.log("\nthese load in every imp session (not a plain `claude`). enable: imprnt global add <name>   disable: imprnt global rm <name> [--purge]");
         break;
       }
-      if (sub === "add") {
+      if (sub2 === "add") {
         let from;
         const names = [];
         for (let i = 0;i < gargs.length; i++) {
@@ -3038,8 +3359,8 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
         }
         const name = names[0];
         const proj = pluginRoot();
-        const srcDir = from ? resolve6(from) : join15(proj, "plugins", name);
-        if (!existsSync13(srcDir)) {
+        const srcDir = from ? resolve7(from) : join16(proj, "plugins", name);
+        if (!existsSync14(srcDir)) {
           console.error(`global add ${name}: no source - ${from ? `--from path not found: ${srcDir}` : `no plugins/${name}/ to promote; pass --from <dir>`}`);
           process.exit(1);
         }
@@ -3051,7 +3372,7 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
         console.log(r.changed ? `enabled ${name} globally → loads in every imp session (copied to ${globalDir}/imprnt/${name}/)` : `${name} already enabled globally (refreshed the copy)`);
         break;
       }
-      if (sub === "rm") {
+      if (sub2 === "rm") {
         let purge = false;
         const names = [];
         for (const a of gargs) {
@@ -3083,7 +3404,7 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
       } else if (process.stdin.isTTY && process.stdout.isTTY) {
         const inPlace = isVaultProject(process.cwd());
         const display = inPlace ? process.cwd() : "~/imprnt";
-        const fallback = inPlace ? process.cwd() : join15(homedir4(), "imprnt");
+        const fallback = inPlace ? process.cwd() : join16(homedir5(), "imprnt");
         const rl = createInterface2({ input: process.stdin, output: process.stdout });
         const answer = (await rl.question(`vault location [${display}]: `)).trim();
         rl.close();
@@ -3092,7 +3413,7 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
         target = process.cwd();
       }
       const toCwd = target === process.cwd();
-      const rel = (sub) => toCwd ? `./${sub}` : join15(target, sub);
+      const rel = (sub2) => toCwd ? `./${sub2}` : join16(target, sub2);
       const lexicalEnclosing = projectRoot(target);
       const physical = physicalTarget(target);
       const physicalEnclosing = projectRoot(physical);
@@ -3105,15 +3426,15 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
       const domains = ["identity", "health", "finances", "work", "life", "projects"];
       const forms = ["events", "mistakes"];
       const vaultDirs = [...entities, ...domains, ...forms];
-      const vaultPath = join15(target, "vault");
-      const vaultExisted = existsSync13(vaultPath);
+      const vaultPath = join16(target, "vault");
+      const vaultExisted = existsSync14(vaultPath);
       let createdDirs = 0;
       for (const d of ["", "vault", ...vaultDirs.map((t) => `vault/${t}`), "raw"]) {
-        const abs = d ? join15(target, d) : target;
-        if (!existsSync13(abs))
+        const abs = d ? join16(target, d) : target;
+        if (!existsSync14(abs))
           createdDirs++;
         try {
-          mkdirSync5(abs, { recursive: true });
+          mkdirSync6(abs, { recursive: true });
         } catch (e) {
           console.error(`cannot create ${d ? rel(d) : target}: ${e instanceof Error ? e.message : String(e)}`);
           process.exit(1);
@@ -3125,29 +3446,29 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
       };
       const added = [];
       for (const f of ["index.md", "hot.md", "log.md", "_tags.md"]) {
-        const dst = join15(vaultPath, f);
+        const dst = join16(vaultPath, f);
         const slot = controlSlot(dst);
         if (slot.startsWith("blocked")) {
           console.error(blockedMsg(`vault/${f}`, slot));
           process.exit(1);
         }
         if (slot === "create") {
-          cpSync3(join15(pkgRoot, "templates", f), dst);
+          cpSync3(join16(pkgRoot, "templates", f), dst);
           added.push(`vault/${f}`);
         }
       }
-      const claudeMd = join15(target, "CLAUDE.md");
+      const claudeMd = join16(target, "CLAUDE.md");
       const cmSlot = controlSlot(claudeMd);
       if (cmSlot.startsWith("blocked")) {
         console.error(blockedMsg("CLAUDE.md", cmSlot));
         process.exit(1);
       }
-      if (cmSlot === "create" && existsSync13(join15(pkgRoot, "CLAUDE.md"))) {
-        cpSync3(join15(pkgRoot, "CLAUDE.md"), claudeMd);
+      if (cmSlot === "create" && existsSync14(join16(pkgRoot, "CLAUDE.md"))) {
+        cpSync3(join16(pkgRoot, "CLAUDE.md"), claudeMd);
         added.push("CLAUDE.md");
       }
       try {
-        const prevMode = statSync9(target).mode & 511;
+        const prevMode = statSync10(target).mode & 511;
         chmodSync(target, 448);
         if (prevMode !== 448)
           console.log(`locked ${target} to owner-only (chmod 700, was ${prevMode.toString(8).padStart(3, "0")})`);
@@ -3169,8 +3490,8 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
         console.log(`  + ${rel("raw")} for immutable by-source snapshots`);
         console.log("next: type `imp` to talk, or ingest a source (`imprnt ingest <file>`), then `imprnt check`.");
       } else {
-        const noteCount = collectNotes(vaultPath).length;
-        console.log(`found existing vault at ${rel("vault")} — ${noteCount} note${noteCount === 1 ? "" : "s"}, left untouched`);
+        const noteCount2 = collectNotes(vaultPath).length;
+        console.log(`found existing vault at ${rel("vault")} — ${noteCount2} note${noteCount2 === 1 ? "" : "s"}, left untouched`);
         if (added.length)
           console.log(`  added missing control file${added.length === 1 ? "" : "s"}: ${added.join(", ")}`);
         else if (createdDirs)
@@ -3185,9 +3506,9 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
       const isHelp = cmd === "help" || cmd === "--help" || cmd === "-h";
       const bare = cmd === undefined;
       if (cmd && !isHelp && !bare && !cmd.startsWith("-")) {
-        const modScript = join15(pluginRoot(), "plugins", cmd, `${cmd}.js`);
-        if (existsSync13(modScript)) {
-          const proc = spawnSync4(process.execPath, [modScript, ...rest], { stdio: "inherit" });
+        const modScript = join16(pluginRoot(), "plugins", cmd, `${cmd}.js`);
+        if (existsSync14(modScript)) {
+          const proc = spawnSync5(process.execPath, [modScript, ...rest], { stdio: "inherit" });
           process.exit(proc.status ?? 1);
         }
       }
@@ -3230,6 +3551,7 @@ engine (same subcommands under \`imp\` or \`imprnt\`):
   imprnt global add <name> [--from D]      enable a behavior module (e.g. anti-slop) in EVERY imp session (imp injects it; ~/.claude/CLAUDE.md is never touched); bare name promotes a project plugin
   imprnt global rm <name> [--purge]        disable a global module; --purge deletes the global copy
   imprnt global list                       show globally-enabled modules
+  imprnt vault list|archive|restore        the vault as its own object — outlives any agent
   imprnt <module> <command> [...]          run an installed module's command (e.g. \`imprnt session-host login\`, \`imprnt kleinanzeigen sync\`) — no \`node\` paths
 
 layout: entities (people · orgs · holdings) · domains (identity · health · finances · work · life · projects) · forms (events · mistakes)