imprnt 0.1.4-edge.88 → 0.1.4-edge.89

package/CLAUDE.md

@@ -94,7 +94,20 @@ vault/
 
 **holdings/ vs reference: the cut is CHANGING STATE, not the word "tool."** Anything you follow over time is a holding: a premium, a dose, a balance, a status, a renewal. A paid subscription with a cost/renewal (a transit pass) is a holding even if you'd call it a "service." Static stuff with no state to track is **not** a holding: a free CLI, your dotfiles, tech-stack preferences are pure reference → file them in their domain (`work/`, `health/`). This cut is what keeps `holdings/` a real tracked-entity type instead of drifting back into a `things/` junk drawer.
 
-**Domains are user-defined.** One person's set is `identity/ health/ finances/ work/ life/`. A consultant's would add `clients/`, a researcher's `topics/`. imprnt ships the mechanism + sensible defaults, not a fixed domain set. `type:` in frontmatter (below) records *what each note is* even when it sits in a domain folder, so nothing is lost by filing topically.
+**Domains are user-defined, and the vault declares them.** One person's set is `identity/ health/ finances/ work/ life/`. A consultant's would add `clients/`, a researcher's `topics/`. imprnt ships the mechanism + sensible defaults, not a fixed domain set — `vault/_folders.md` is where a vault says which of its folders hold **entities**, which hold **domains**, which hold **forms**, and which hold a **mount**. No file means the shipped defaults, so nothing changes until you want it to.
+
+```markdown
+## Entities
+people, orgs, holdings
+
+## Domains
+identity, health, finances, work, life, clients
+
+## Mounts
+household
+```
+
+A **mount** is the fourth role and the one the defaults have no name for: a folder holding a tree that is complete on its own and maintained elsewhere — a shared repo checked out inside `vault/`, an imported corpus. Its notes are not part of this vault's entity graph, so `check` does not ask them to link one. Without that, every note under a folder the defaults never heard of is reported disconnected forever with nothing the owner can do, and permanent noise in `_needs-review.md` is worse than no check at all. An absent section keeps its default; an empty one is a deliberate "none". `type:` in frontmatter (below) records *what each note is* even when it sits in a domain folder, so nothing is lost by filing topically.
 
 ## Frontmatter contract
 

package/dist/cli.js

@@ -2454,11 +2454,72 @@ var init_snapshot = __esm(() => {
     console.log(`  next: the LLM reads raw/${dest}/ and fans sources out into vault notes (source: raw/${dest}/...).`);
 });
 
+// scripts/lib/folders.ts
+import { existsSync as existsSync12, readFileSync as readFileSync13 } from "node:fs";
+import { join as join14 } from "node:path";
+function section2(text2, name) {
+  return text2.match(new RegExp(`##\\s*${name}\\s*\\n([\\s\\S]*?)(?:\\n##\\s|\\s*$)`, "i"))?.[1] ?? "";
+}
+function folderTokens(line) {
+  const t = line.trim();
+  if (t === "" || t.startsWith("#") || t.startsWith("<!--") || t.startsWith(">"))
+    return [];
+  return t.replace(/^[-*]\s+/, "").split(",").map((s) => s.trim().normalize("NFC").toLowerCase()).filter((s) => FOLDER_TOKEN.test(s));
+}
+function read(text2, name, fallback) {
+  const found = [];
+  for (const line of section2(text2, name).split(/\r?\n/))
+    found.push(...folderTokens(line));
+  return new RegExp(`##\\s*${name}\\s*\\n`, "i").test(text2) ? new Set(found) : new Set(fallback);
+}
+function loadFolders(vault4) {
+  const p = join14(vault4, "_folders.md");
+  if (!existsSync12(p)) {
+    return {
+      entities: new Set(DEFAULT_ENTITIES),
+      domains: new Set(DEFAULT_DOMAINS),
+      forms: new Set(DEFAULT_FORMS),
+      mounts: new Set,
+      declared: false
+    };
+  }
+  let text2 = "";
+  try {
+    text2 = readFileSync13(p, "utf8");
+  } catch {
+    return { entities: new Set(DEFAULT_ENTITIES), domains: new Set(DEFAULT_DOMAINS), forms: new Set(DEFAULT_FORMS), mounts: new Set, declared: false };
+  }
+  const roles = {
+    entities: read(text2, "Entities", DEFAULT_ENTITIES),
+    domains: read(text2, "Domains", DEFAULT_DOMAINS),
+    forms: read(text2, "Forms", DEFAULT_FORMS),
+    mounts: read(text2, "Mounts", []),
+    declared: true
+  };
+  for (const f of roles.entities) {
+    roles.domains.delete(f);
+    roles.forms.delete(f);
+    roles.mounts.delete(f);
+  }
+  for (const f of roles.mounts) {
+    roles.domains.delete(f);
+    roles.forms.delete(f);
+  }
+  return roles;
+}
+var DEFAULT_ENTITIES, DEFAULT_DOMAINS, DEFAULT_FORMS, FOLDER_TOKEN;
+var init_folders = __esm(() => {
+  DEFAULT_ENTITIES = ["people", "orgs", "holdings"];
+  DEFAULT_DOMAINS = ["identity", "health", "finances", "work", "life"];
+  DEFAULT_FORMS = ["events", "mistakes", "projects"];
+  FOLDER_TOKEN = /^[\p{L}\p{N}_-]+$/u;
+});
+
 // scripts/check.ts
 var exports_check = {};
-import { readdirSync as readdirSync8, readFileSync as readFileSync13, statSync as statSync8, existsSync as existsSync12, writeFileSync as writeFileSync10 } from "node:fs";
+import { readdirSync as readdirSync8, readFileSync as readFileSync14, statSync as statSync8, existsSync as existsSync13, writeFileSync as writeFileSync10 } from "node:fs";
 import { spawnSync as spawnSync3 } from "node:child_process";
-import { join as join14, relative as relative6, dirname as dirname3 } from "node:path";
+import { join as join15, relative as relative6, dirname as dirname3 } from "node:path";
 import { homedir as homedir3 } from "node:os";
 function resolves(target) {
   const t = target.trim().replace(/^\.\//, "").replace(/\.md$/, "");
@@ -2485,9 +2546,9 @@ function hostMemoryStores() {
   const override = process.env.IMPRNT_HOST_MEMORY_DIR;
   if (override)
     return [override];
-  const configDir = process.env.CLAUDE_CONFIG_DIR || join14(homedir3(), ".claude");
-  const projectsDir = join14(configDir, "projects");
-  if (!existsSync12(projectsDir))
+  const configDir = process.env.CLAUDE_CONFIG_DIR || join15(homedir3(), ".claude");
+  const projectsDir = join15(configDir, "projects");
+  if (!existsSync13(projectsDir))
     return [];
   let entries;
   try {
@@ -2495,7 +2556,7 @@ function hostMemoryStores() {
   } catch {
     return [];
   }
-  return entries.map((p) => join14(projectsDir, p, "memory")).filter((d) => {
+  return entries.map((p) => join15(projectsDir, p, "memory")).filter((d) => {
     try {
       return statSync8(d).isDirectory();
     } catch {
@@ -2505,17 +2566,17 @@ function hostMemoryStores() {
 }
 function memoryIndexHasContent(dir2) {
   try {
-    return readFileSync13(join14(dir2, "MEMORY.md"), "utf8").split(/\r?\n/).some((l) => l.trim() !== "" && l.trim() !== "# Memory index");
+    return readFileSync14(join15(dir2, "MEMORY.md"), "utf8").split(/\r?\n/).some((l) => l.trim() !== "" && l.trim() !== "# Memory index");
   } catch {
     return false;
   }
 }
 function syncNeedsReview(lines2) {
-  const p = join14(vault4, "_needs-review.md");
-  const exists = existsSync12(p);
+  const p = join15(vault4, "_needs-review.md");
+  const exists = existsSync13(p);
   if (!exists && lines2.length === 0)
     return "none";
-  const prev = exists ? readFileSync13(p, "utf8") : `---
+  const prev = exists ? readFileSync14(p, "utf8") : `---
 type: needs-review
 ---
 
@@ -2524,7 +2585,7 @@ type: needs-review
 `;
   const b = prev.indexOf(REVIEW_BEGIN);
   const e = b !== -1 ? prev.indexOf(REVIEW_END, b + REVIEW_BEGIN.length) : -1;
-  const section2 = `${REVIEW_BEGIN}
+  const section3 = `${REVIEW_BEGIN}
 ${lines2.join(`
 `)}
 ${REVIEW_END}
@@ -2538,22 +2599,23 @@ ${REVIEW_END}
     } else {
       after = prev.slice(b + REVIEW_BEGIN.length).replace(/^\n/, "");
     }
-    next = before + (lines2.length ? section2 : "") + after;
+    next = before + (lines2.length ? section3 : "") + after;
   } else {
     if (lines2.length === 0)
       return "none";
     next = (prev.endsWith(`
 `) ? prev : prev + `
-`) + section2;
+`) + section3;
   }
   if (next !== prev || !exists)
     writeFileSync10(p, next);
   return lines2.length ? "written" : "cleared";
 }
-var args4, vault4, all = false, ENTITY_FOLDERS, DOMAIN_FOLDERS2, LINK, notes, allSlugs, folderOf, byBasename, orphans, disconnected, domainIssues, untagged, review, referencedRaw, tagVocab, hasRealTag = (tags) => tags.some((t) => /[\p{L}\p{N}]/u.test(normalize(tagVocab, t))), hasTagsFile, addedTags, dupPairs, manifest3, rawEntries, norm = (p) => p.replace(/^\.\//, "").replace(/^.*\/raw\//, "raw/").replace(/\.md$/, ""), refNorm, uncovered, memoryStores, strayStores, strayCount, REVIEW_BEGIN = "<!-- imprnt-check:begin (regenerated by `imprnt check` - do not edit between the markers) -->", REVIEW_END = "<!-- imprnt-check:end -->", cap = (xs, n = 25) => xs.slice(0, n).concat(xs.length > n ? [`  … +${xs.length - n} more`] : []), count, folders, synced, issues;
+var args4, vault4, all = false, roles, ENTITY_FOLDERS, DOMAIN_FOLDERS2, MOUNT_FOLDERS, LINK, notes, allSlugs, folderOf, byBasename, orphans, disconnected, domainIssues, untagged, review, referencedRaw, tagVocab, hasRealTag = (tags) => tags.some((t) => /[\p{L}\p{N}]/u.test(normalize(tagVocab, t))), hasTagsFile, addedTags, dupPairs, manifest3, rawEntries, norm = (p) => p.replace(/^\.\//, "").replace(/^.*\/raw\//, "raw/").replace(/\.md$/, ""), refNorm, uncovered, memoryStores, strayStores, strayCount, REVIEW_BEGIN = "<!-- imprnt-check:begin (regenerated by `imprnt check` - do not edit between the markers) -->", REVIEW_END = "<!-- imprnt-check:end -->", cap = (xs, n = 25) => xs.slice(0, n).concat(xs.length > n ? [`  … +${xs.length - n} more`] : []), count, folders, synced, issues;
 var init_check = __esm(() => {
   init_roots();
   init_moc();
+  init_folders();
   init_tags();
   init_manifest();
   args4 = process.argv.slice(2);
@@ -2569,12 +2631,14 @@ var init_check = __esm(() => {
     } else if (args4[i] === "--all")
       all = true;
   }
-  if (!existsSync12(vault4)) {
+  if (!existsSync13(vault4)) {
     console.error(`no vault at ${vault4} — run \`imprnt init\` first`);
     process.exit(1);
   }
-  ENTITY_FOLDERS = new Set(["people", "orgs", "holdings"]);
-  DOMAIN_FOLDERS2 = new Set(["identity", "health", "finances", "work", "life"]);
+  roles = loadFolders(vault4);
+  ENTITY_FOLDERS = roles.entities;
+  DOMAIN_FOLDERS2 = roles.domains;
+  MOUNT_FOLDERS = roles.mounts;
   LINK = /\[\[([^\]|#]+)(?:#[^\]|]+)?(?:\|[^\]]+)?\]\]/g;
   notes = collectNotes(vault4);
   allSlugs = new Set(notes.map((n) => n.slug));
@@ -2592,7 +2656,7 @@ var init_check = __esm(() => {
   referencedRaw = new Set;
   tagVocab = loadTags(vault4);
   for (const n of notes) {
-    const raw = readFileSync13(n.path, "utf8");
+    const raw = readFileSync14(n.path, "utf8");
     const fm2 = frontmatter(raw);
     const links = [...stripCode(raw).matchAll(LINK)].map((m) => m[1].trim()).filter((l) => !l.startsWith("raw/"));
     for (const l of links)
@@ -2600,7 +2664,7 @@ var init_check = __esm(() => {
         orphans.push(`  ${n.slug}  →  [[${l}]]`);
         review.push(`- [ ] orphan link [[${l}]] — from [[${n.slug}]], target note missing`);
       }
-    if (!ENTITY_FOLDERS.has(n.folder) && !links.some(linksEntity)) {
+    if (!ENTITY_FOLDERS.has(n.folder) && !MOUNT_FOLDERS.has(n.folder) && !links.some(linksEntity)) {
       disconnected.push(`  ${n.slug}`);
       review.push(`- [ ] disconnected note [[${n.slug}]] — links no entity`);
     }
@@ -2620,7 +2684,7 @@ var init_check = __esm(() => {
     for (const s of fmList(fm2, "sources"))
       referencedRaw.add(s.replace(/^\[\[/, "").replace(/\]\]$/, "").replace(/^\.\//, ""));
   }
-  hasTagsFile = existsSync12(join14(vault4, "_tags.md"));
+  hasTagsFile = existsSync13(join15(vault4, "_tags.md"));
   addedTags = [];
   dupPairs = [];
   if (hasTagsFile) {
@@ -2692,7 +2756,7 @@ var init_check = __esm(() => {
   strayStores = memoryStores.map((dir2) => {
     let files3 = [];
     try {
-      if (existsSync12(dir2))
+      if (existsSync13(dir2))
         files3 = readdirSync8(dir2).filter((f) => f.endsWith(".md") && f !== "MEMORY.md").sort();
     } catch (e) {
       console.error(`⚠ host auto-memory sweep: could not read ${dir2} (${e instanceof Error ? e.message : String(e)}) - skipping it`);
@@ -2704,8 +2768,14 @@ var init_check = __esm(() => {
   strayCount = strayStores.reduce((n, s) => n + s.files.length, 0);
   for (const s of strayStores)
     review.push(`- [ ] host auto-memory not empty — ${s.files.length} note(s) in ${s.dir}; migrate knowledge → vault notes, behavior → a CLAUDE.local.md fragment, then empty it`);
-  console.log(`imprnt check — ${notes.length} notes in ${vault4}
-`);
+  console.log(`imprnt check — ${notes.length} notes in ${vault4}`);
+  if (roles.declared) {
+    const parts = [`entities: ${[...ENTITY_FOLDERS].join(" ") || "(none)"}`, `domains: ${[...DOMAIN_FOLDERS2].join(" ") || "(none)"}`];
+    if (MOUNT_FOLDERS.size)
+      parts.push(`mounts: ${[...MOUNT_FOLDERS].join(" ")}`);
+    console.log(`folder roles from _folders.md — ${parts.join(", ")}`);
+  }
+  console.log("");
   if (orphans.length) {
     console.log(`⚠ orphan links (${orphans.length}) — target note missing:`);
     console.log(cap(orphans).join(`
@@ -2778,18 +2848,18 @@ var init_check = __esm(() => {
 ${issues} thing(s) to look at above.` : `
 clean.`);
   if (all) {
-    const pluginsDir = join14(projectRoot(), "plugins");
+    const pluginsDir = join15(projectRoot(), "plugins");
     const checks = [];
-    if (existsSync12(pluginsDir)) {
+    if (existsSync13(pluginsDir)) {
       for (const entry of readdirSync8(pluginsDir)) {
         let isDir2 = false;
         try {
-          isDir2 = statSync8(join14(pluginsDir, entry)).isDirectory();
+          isDir2 = statSync8(join15(pluginsDir, entry)).isDirectory();
         } catch {
           continue;
         }
-        const p = join14(pluginsDir, entry, "check.js");
-        if (isDir2 && existsSync12(p))
+        const p = join15(pluginsDir, entry, "check.js");
+        if (isDir2 && existsSync13(p))
           checks.push(p);
       }
     }
@@ -2824,12 +2894,12 @@ all plugin checks passed.`);
 // scripts/vault.ts
 var exports_vault = {};
 import { spawnSync as spawnSync4 } from "node:child_process";
-import { existsSync as existsSync13, mkdirSync as mkdirSync5, readdirSync as readdirSync9, statSync as statSync9 } from "node:fs";
+import { existsSync as existsSync14, 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";
+import { basename as basename6, dirname as dirname4, join as join16, resolve as resolve6 } from "node:path";
 function noteCount(project) {
-  const root = join15(project, "vault");
-  if (!existsSync13(root))
+  const root = join16(project, "vault");
+  if (!existsSync14(root))
     return 0;
   let n = 0;
   const walk3 = (dir2, atRoot) => {
@@ -2841,7 +2911,7 @@ function noteCount(project) {
       if (atRoot && CONTROL3.has(e.name))
         continue;
       if (e.isDirectory())
-        walk3(join15(dir2, e.name), false);
+        walk3(join16(dir2, e.name), false);
       else if (e.name.endsWith(".md"))
         n++;
     }
@@ -2884,7 +2954,7 @@ function tar(...a) {
 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;
+}, positionals, expand = (p) => resolve6(p.startsWith("~/") ? join16(homedir4(), p.slice(2)) : p), CONTROL3;
 var init_vault = __esm(() => {
   init_registry();
   args5 = process.argv.slice(2);
@@ -2919,7 +2989,7 @@ var init_vault = __esm(() => {
       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`);
+      const out = join16(outDir, `${name}-${stamp}.tar.gz`);
       if (tar("czf", out, "-C", dirname4(path), basename6(path)) !== 0) {
         console.error("archive failed");
         process.exit(1);
@@ -2940,11 +3010,11 @@ var init_vault = __esm(() => {
         console.error("usage: imprnt vault restore <archive.tar.gz> <dir>");
         process.exit(1);
       }
-      if (!existsSync13(src3)) {
+      if (!existsSync14(src3)) {
         console.error(`no archive at ${src3}`);
         process.exit(1);
       }
-      if (existsSync13(dest2) && readdirSync9(dest2).length) {
+      if (existsSync14(dest2) && readdirSync9(dest2).length) {
         console.error(`${dest2} is not empty — restore into a new directory, then move it`);
         process.exit(1);
       }
@@ -2953,7 +3023,7 @@ var init_vault = __esm(() => {
         console.error("restore failed");
         process.exit(1);
       }
-      const inner = readdirSync9(dest2).map((e) => join15(dest2, e)).filter((p) => statSync9(p).isDirectory());
+      const inner = readdirSync9(dest2).map((e) => join16(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`);
@@ -2981,9 +3051,9 @@ pointed at nothing — so the vault outlives whatever reads it.`);
 
 // 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 { cpSync as cpSync3, mkdirSync as mkdirSync6, chmodSync, existsSync as existsSync15, readFileSync as readFileSync15, 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 { join as join17, 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";
@@ -2991,7 +3061,7 @@ function pluginRoot() {
   const local = projectRoot();
   if (process.env.IMPRNT_ROOT || process.env.IMPRINT_ROOT)
     return local;
-  if (existsSync14(join16(local, "vault")) || existsSync14(join16(local, "CLAUDE.local.md")))
+  if (existsSync15(join17(local, "vault")) || existsSync15(join17(local, "CLAUDE.local.md")))
     return local;
   return registeredRoot() ?? local;
 }
@@ -3020,7 +3090,7 @@ function resolvePath(input, base = process.cwd(), home = homedir5()) {
   if (p === "~")
     p = home;
   else if (p.startsWith("~/"))
-    p = join16(home, p.slice(2));
+    p = join17(home, p.slice(2));
   return resolve7(base, p);
 }
 function initPositional(args6) {
@@ -3029,7 +3099,7 @@ function initPositional(args6) {
 function physicalTarget(target) {
   let existing = target;
   const tail = [];
-  while (!existsSync14(existing)) {
+  while (!existsSync15(existing)) {
     const parent = dirname5(existing);
     if (parent === existing)
       return target;
@@ -3037,7 +3107,7 @@ function physicalTarget(target) {
     existing = parent;
   }
   try {
-    return tail.length ? join16(realpathSync2(existing), ...tail) : realpathSync2(existing);
+    return tail.length ? join17(realpathSync2(existing), ...tail) : realpathSync2(existing);
   } catch {
     return target;
   }
@@ -3073,7 +3143,7 @@ var init_cli = __esm(async () => {
   init_registry();
   init_launch();
   here = dirname5(fileURLToPath(import.meta.url));
-  pkgRoot = join16(here, "..");
+  pkgRoot = join17(here, "..");
   [cmd, ...rest] = process.argv.slice(2);
   asImp = globalThis.__IMPRNT_IMP__ === true;
   if (["ingest", "recall", "snapshot", "check", "vault"].includes(cmd))
@@ -3103,12 +3173,12 @@ var init_cli = __esm(async () => {
           console.log(r);
         console.log("");
       }
-      const p = join16(vault5, "hot.md");
-      if (!existsSync14(p)) {
+      const p = join17(vault5, "hot.md");
+      if (!existsSync15(p)) {
         console.error(`no hot.md at ${p} — run \`imprnt init\``);
         process.exit(1);
       }
-      console.log(readFileSync14(p, "utf8"));
+      console.log(readFileSync15(p, "utf8"));
       break;
     }
     case "lair": {
@@ -3120,12 +3190,12 @@ var init_cli = __esm(async () => {
     }
     case "context": {
       const home = requireVaultHome();
-      const contract = join16(home, "CLAUDE.md");
-      if (!existsSync14(contract)) {
+      const contract = join17(home, "CLAUDE.md");
+      if (!existsSync15(contract)) {
         console.error(`no CLAUDE.md at ${home} — run \`imprnt init\` there to drop the contract`);
         process.exit(1);
       }
-      process.stdout.write(readFileSync14(contract, "utf8"));
+      process.stdout.write(readFileSync15(contract, "utf8"));
       break;
     }
     case "agent": {
@@ -3324,7 +3394,7 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
       process.exit(1);
     }
     case "global": {
-      const globalDir = process.env.CLAUDE_CONFIG_DIR || join16(homedir5(), ".claude");
+      const globalDir = process.env.CLAUDE_CONFIG_DIR || join17(homedir5(), ".claude");
       const [sub2, ...gargs] = rest;
       if (sub2 === "list") {
         const enabled = listGlobalModules(globalDir);
@@ -3359,8 +3429,8 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
         }
         const name = names[0];
         const proj = pluginRoot();
-        const srcDir = from ? resolve7(from) : join16(proj, "plugins", name);
-        if (!existsSync14(srcDir)) {
+        const srcDir = from ? resolve7(from) : join17(proj, "plugins", name);
+        if (!existsSync15(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);
         }
@@ -3404,7 +3474,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() : join16(homedir5(), "imprnt");
+        const fallback = inPlace ? process.cwd() : join17(homedir5(), "imprnt");
         const rl = createInterface2({ input: process.stdin, output: process.stdout });
         const answer = (await rl.question(`vault location [${display}]: `)).trim();
         rl.close();
@@ -3413,7 +3483,7 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
         target = process.cwd();
       }
       const toCwd = target === process.cwd();
-      const rel = (sub2) => toCwd ? `./${sub2}` : join16(target, sub2);
+      const rel = (sub2) => toCwd ? `./${sub2}` : join17(target, sub2);
       const lexicalEnclosing = projectRoot(target);
       const physical = physicalTarget(target);
       const physicalEnclosing = projectRoot(physical);
@@ -3426,12 +3496,12 @@ 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 = join16(target, "vault");
-      const vaultExisted = existsSync14(vaultPath);
+      const vaultPath = join17(target, "vault");
+      const vaultExisted = existsSync15(vaultPath);
       let createdDirs = 0;
       for (const d of ["", "vault", ...vaultDirs.map((t) => `vault/${t}`), "raw"]) {
-        const abs = d ? join16(target, d) : target;
-        if (!existsSync14(abs))
+        const abs = d ? join17(target, d) : target;
+        if (!existsSync15(abs))
           createdDirs++;
         try {
           mkdirSync6(abs, { recursive: true });
@@ -3446,25 +3516,25 @@ 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 = join16(vaultPath, f);
+        const dst = join17(vaultPath, f);
         const slot = controlSlot(dst);
         if (slot.startsWith("blocked")) {
           console.error(blockedMsg(`vault/${f}`, slot));
           process.exit(1);
         }
         if (slot === "create") {
-          cpSync3(join16(pkgRoot, "templates", f), dst);
+          cpSync3(join17(pkgRoot, "templates", f), dst);
           added.push(`vault/${f}`);
         }
       }
-      const claudeMd = join16(target, "CLAUDE.md");
+      const claudeMd = join17(target, "CLAUDE.md");
       const cmSlot = controlSlot(claudeMd);
       if (cmSlot.startsWith("blocked")) {
         console.error(blockedMsg("CLAUDE.md", cmSlot));
         process.exit(1);
       }
-      if (cmSlot === "create" && existsSync14(join16(pkgRoot, "CLAUDE.md"))) {
-        cpSync3(join16(pkgRoot, "CLAUDE.md"), claudeMd);
+      if (cmSlot === "create" && existsSync15(join17(pkgRoot, "CLAUDE.md"))) {
+        cpSync3(join17(pkgRoot, "CLAUDE.md"), claudeMd);
         added.push("CLAUDE.md");
       }
       try {
@@ -3506,8 +3576,8 @@ 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 = join16(pluginRoot(), "plugins", cmd, `${cmd}.js`);
-        if (existsSync14(modScript)) {
+        const modScript = join17(pluginRoot(), "plugins", cmd, `${cmd}.js`);
+        if (existsSync15(modScript)) {
           const proc = spawnSync5(process.execPath, [modScript, ...rest], { stdio: "inherit" });
           process.exit(proc.status ?? 1);
         }

package/dist/imp.js

@@ -2454,11 +2454,72 @@ var init_snapshot = __esm(() => {
     console.log(`  next: the LLM reads raw/${dest}/ and fans sources out into vault notes (source: raw/${dest}/...).`);
 });
 
+// scripts/lib/folders.ts
+import { existsSync as existsSync12, readFileSync as readFileSync13 } from "node:fs";
+import { join as join14 } from "node:path";
+function section2(text2, name) {
+  return text2.match(new RegExp(`##\\s*${name}\\s*\\n([\\s\\S]*?)(?:\\n##\\s|\\s*$)`, "i"))?.[1] ?? "";
+}
+function folderTokens(line) {
+  const t = line.trim();
+  if (t === "" || t.startsWith("#") || t.startsWith("<!--") || t.startsWith(">"))
+    return [];
+  return t.replace(/^[-*]\s+/, "").split(",").map((s) => s.trim().normalize("NFC").toLowerCase()).filter((s) => FOLDER_TOKEN.test(s));
+}
+function read(text2, name, fallback) {
+  const found = [];
+  for (const line of section2(text2, name).split(/\r?\n/))
+    found.push(...folderTokens(line));
+  return new RegExp(`##\\s*${name}\\s*\\n`, "i").test(text2) ? new Set(found) : new Set(fallback);
+}
+function loadFolders(vault4) {
+  const p = join14(vault4, "_folders.md");
+  if (!existsSync12(p)) {
+    return {
+      entities: new Set(DEFAULT_ENTITIES),
+      domains: new Set(DEFAULT_DOMAINS),
+      forms: new Set(DEFAULT_FORMS),
+      mounts: new Set,
+      declared: false
+    };
+  }
+  let text2 = "";
+  try {
+    text2 = readFileSync13(p, "utf8");
+  } catch {
+    return { entities: new Set(DEFAULT_ENTITIES), domains: new Set(DEFAULT_DOMAINS), forms: new Set(DEFAULT_FORMS), mounts: new Set, declared: false };
+  }
+  const roles = {
+    entities: read(text2, "Entities", DEFAULT_ENTITIES),
+    domains: read(text2, "Domains", DEFAULT_DOMAINS),
+    forms: read(text2, "Forms", DEFAULT_FORMS),
+    mounts: read(text2, "Mounts", []),
+    declared: true
+  };
+  for (const f of roles.entities) {
+    roles.domains.delete(f);
+    roles.forms.delete(f);
+    roles.mounts.delete(f);
+  }
+  for (const f of roles.mounts) {
+    roles.domains.delete(f);
+    roles.forms.delete(f);
+  }
+  return roles;
+}
+var DEFAULT_ENTITIES, DEFAULT_DOMAINS, DEFAULT_FORMS, FOLDER_TOKEN;
+var init_folders = __esm(() => {
+  DEFAULT_ENTITIES = ["people", "orgs", "holdings"];
+  DEFAULT_DOMAINS = ["identity", "health", "finances", "work", "life"];
+  DEFAULT_FORMS = ["events", "mistakes", "projects"];
+  FOLDER_TOKEN = /^[\p{L}\p{N}_-]+$/u;
+});
+
 // scripts/check.ts
 var exports_check = {};
-import { readdirSync as readdirSync8, readFileSync as readFileSync13, statSync as statSync8, existsSync as existsSync12, writeFileSync as writeFileSync10 } from "node:fs";
+import { readdirSync as readdirSync8, readFileSync as readFileSync14, statSync as statSync8, existsSync as existsSync13, writeFileSync as writeFileSync10 } from "node:fs";
 import { spawnSync as spawnSync3 } from "node:child_process";
-import { join as join14, relative as relative6, dirname as dirname3 } from "node:path";
+import { join as join15, relative as relative6, dirname as dirname3 } from "node:path";
 import { homedir as homedir3 } from "node:os";
 function resolves(target) {
   const t = target.trim().replace(/^\.\//, "").replace(/\.md$/, "");
@@ -2485,9 +2546,9 @@ function hostMemoryStores() {
   const override = process.env.IMPRNT_HOST_MEMORY_DIR;
   if (override)
     return [override];
-  const configDir = process.env.CLAUDE_CONFIG_DIR || join14(homedir3(), ".claude");
-  const projectsDir = join14(configDir, "projects");
-  if (!existsSync12(projectsDir))
+  const configDir = process.env.CLAUDE_CONFIG_DIR || join15(homedir3(), ".claude");
+  const projectsDir = join15(configDir, "projects");
+  if (!existsSync13(projectsDir))
     return [];
   let entries;
   try {
@@ -2495,7 +2556,7 @@ function hostMemoryStores() {
   } catch {
     return [];
   }
-  return entries.map((p) => join14(projectsDir, p, "memory")).filter((d) => {
+  return entries.map((p) => join15(projectsDir, p, "memory")).filter((d) => {
     try {
       return statSync8(d).isDirectory();
     } catch {
@@ -2505,17 +2566,17 @@ function hostMemoryStores() {
 }
 function memoryIndexHasContent(dir2) {
   try {
-    return readFileSync13(join14(dir2, "MEMORY.md"), "utf8").split(/\r?\n/).some((l) => l.trim() !== "" && l.trim() !== "# Memory index");
+    return readFileSync14(join15(dir2, "MEMORY.md"), "utf8").split(/\r?\n/).some((l) => l.trim() !== "" && l.trim() !== "# Memory index");
   } catch {
     return false;
   }
 }
 function syncNeedsReview(lines2) {
-  const p = join14(vault4, "_needs-review.md");
-  const exists = existsSync12(p);
+  const p = join15(vault4, "_needs-review.md");
+  const exists = existsSync13(p);
   if (!exists && lines2.length === 0)
     return "none";
-  const prev = exists ? readFileSync13(p, "utf8") : `---
+  const prev = exists ? readFileSync14(p, "utf8") : `---
 type: needs-review
 ---
 
@@ -2524,7 +2585,7 @@ type: needs-review
 `;
   const b = prev.indexOf(REVIEW_BEGIN);
   const e = b !== -1 ? prev.indexOf(REVIEW_END, b + REVIEW_BEGIN.length) : -1;
-  const section2 = `${REVIEW_BEGIN}
+  const section3 = `${REVIEW_BEGIN}
 ${lines2.join(`
 `)}
 ${REVIEW_END}
@@ -2538,22 +2599,23 @@ ${REVIEW_END}
     } else {
       after = prev.slice(b + REVIEW_BEGIN.length).replace(/^\n/, "");
     }
-    next = before + (lines2.length ? section2 : "") + after;
+    next = before + (lines2.length ? section3 : "") + after;
   } else {
     if (lines2.length === 0)
       return "none";
     next = (prev.endsWith(`
 `) ? prev : prev + `
-`) + section2;
+`) + section3;
   }
   if (next !== prev || !exists)
     writeFileSync10(p, next);
   return lines2.length ? "written" : "cleared";
 }
-var args4, vault4, all = false, ENTITY_FOLDERS, DOMAIN_FOLDERS2, LINK, notes, allSlugs, folderOf, byBasename, orphans, disconnected, domainIssues, untagged, review, referencedRaw, tagVocab, hasRealTag = (tags) => tags.some((t) => /[\p{L}\p{N}]/u.test(normalize(tagVocab, t))), hasTagsFile, addedTags, dupPairs, manifest3, rawEntries, norm = (p) => p.replace(/^\.\//, "").replace(/^.*\/raw\//, "raw/").replace(/\.md$/, ""), refNorm, uncovered, memoryStores, strayStores, strayCount, REVIEW_BEGIN = "<!-- imprnt-check:begin (regenerated by `imprnt check` - do not edit between the markers) -->", REVIEW_END = "<!-- imprnt-check:end -->", cap = (xs, n = 25) => xs.slice(0, n).concat(xs.length > n ? [`  … +${xs.length - n} more`] : []), count, folders, synced, issues;
+var args4, vault4, all = false, roles, ENTITY_FOLDERS, DOMAIN_FOLDERS2, MOUNT_FOLDERS, LINK, notes, allSlugs, folderOf, byBasename, orphans, disconnected, domainIssues, untagged, review, referencedRaw, tagVocab, hasRealTag = (tags) => tags.some((t) => /[\p{L}\p{N}]/u.test(normalize(tagVocab, t))), hasTagsFile, addedTags, dupPairs, manifest3, rawEntries, norm = (p) => p.replace(/^\.\//, "").replace(/^.*\/raw\//, "raw/").replace(/\.md$/, ""), refNorm, uncovered, memoryStores, strayStores, strayCount, REVIEW_BEGIN = "<!-- imprnt-check:begin (regenerated by `imprnt check` - do not edit between the markers) -->", REVIEW_END = "<!-- imprnt-check:end -->", cap = (xs, n = 25) => xs.slice(0, n).concat(xs.length > n ? [`  … +${xs.length - n} more`] : []), count, folders, synced, issues;
 var init_check = __esm(() => {
   init_roots();
   init_moc();
+  init_folders();
   init_tags();
   init_manifest();
   args4 = process.argv.slice(2);
@@ -2569,12 +2631,14 @@ var init_check = __esm(() => {
     } else if (args4[i] === "--all")
       all = true;
   }
-  if (!existsSync12(vault4)) {
+  if (!existsSync13(vault4)) {
     console.error(`no vault at ${vault4} — run \`imprnt init\` first`);
     process.exit(1);
   }
-  ENTITY_FOLDERS = new Set(["people", "orgs", "holdings"]);
-  DOMAIN_FOLDERS2 = new Set(["identity", "health", "finances", "work", "life"]);
+  roles = loadFolders(vault4);
+  ENTITY_FOLDERS = roles.entities;
+  DOMAIN_FOLDERS2 = roles.domains;
+  MOUNT_FOLDERS = roles.mounts;
   LINK = /\[\[([^\]|#]+)(?:#[^\]|]+)?(?:\|[^\]]+)?\]\]/g;
   notes = collectNotes(vault4);
   allSlugs = new Set(notes.map((n) => n.slug));
@@ -2592,7 +2656,7 @@ var init_check = __esm(() => {
   referencedRaw = new Set;
   tagVocab = loadTags(vault4);
   for (const n of notes) {
-    const raw = readFileSync13(n.path, "utf8");
+    const raw = readFileSync14(n.path, "utf8");
     const fm2 = frontmatter(raw);
     const links = [...stripCode(raw).matchAll(LINK)].map((m) => m[1].trim()).filter((l) => !l.startsWith("raw/"));
     for (const l of links)
@@ -2600,7 +2664,7 @@ var init_check = __esm(() => {
         orphans.push(`  ${n.slug}  →  [[${l}]]`);
         review.push(`- [ ] orphan link [[${l}]] — from [[${n.slug}]], target note missing`);
       }
-    if (!ENTITY_FOLDERS.has(n.folder) && !links.some(linksEntity)) {
+    if (!ENTITY_FOLDERS.has(n.folder) && !MOUNT_FOLDERS.has(n.folder) && !links.some(linksEntity)) {
       disconnected.push(`  ${n.slug}`);
       review.push(`- [ ] disconnected note [[${n.slug}]] — links no entity`);
     }
@@ -2620,7 +2684,7 @@ var init_check = __esm(() => {
     for (const s of fmList(fm2, "sources"))
       referencedRaw.add(s.replace(/^\[\[/, "").replace(/\]\]$/, "").replace(/^\.\//, ""));
   }
-  hasTagsFile = existsSync12(join14(vault4, "_tags.md"));
+  hasTagsFile = existsSync13(join15(vault4, "_tags.md"));
   addedTags = [];
   dupPairs = [];
   if (hasTagsFile) {
@@ -2692,7 +2756,7 @@ var init_check = __esm(() => {
   strayStores = memoryStores.map((dir2) => {
     let files3 = [];
     try {
-      if (existsSync12(dir2))
+      if (existsSync13(dir2))
         files3 = readdirSync8(dir2).filter((f) => f.endsWith(".md") && f !== "MEMORY.md").sort();
     } catch (e) {
       console.error(`⚠ host auto-memory sweep: could not read ${dir2} (${e instanceof Error ? e.message : String(e)}) - skipping it`);
@@ -2704,8 +2768,14 @@ var init_check = __esm(() => {
   strayCount = strayStores.reduce((n, s) => n + s.files.length, 0);
   for (const s of strayStores)
     review.push(`- [ ] host auto-memory not empty — ${s.files.length} note(s) in ${s.dir}; migrate knowledge → vault notes, behavior → a CLAUDE.local.md fragment, then empty it`);
-  console.log(`imprnt check — ${notes.length} notes in ${vault4}
-`);
+  console.log(`imprnt check — ${notes.length} notes in ${vault4}`);
+  if (roles.declared) {
+    const parts = [`entities: ${[...ENTITY_FOLDERS].join(" ") || "(none)"}`, `domains: ${[...DOMAIN_FOLDERS2].join(" ") || "(none)"}`];
+    if (MOUNT_FOLDERS.size)
+      parts.push(`mounts: ${[...MOUNT_FOLDERS].join(" ")}`);
+    console.log(`folder roles from _folders.md — ${parts.join(", ")}`);
+  }
+  console.log("");
   if (orphans.length) {
     console.log(`⚠ orphan links (${orphans.length}) — target note missing:`);
     console.log(cap(orphans).join(`
@@ -2778,18 +2848,18 @@ var init_check = __esm(() => {
 ${issues} thing(s) to look at above.` : `
 clean.`);
   if (all) {
-    const pluginsDir = join14(projectRoot(), "plugins");
+    const pluginsDir = join15(projectRoot(), "plugins");
     const checks = [];
-    if (existsSync12(pluginsDir)) {
+    if (existsSync13(pluginsDir)) {
       for (const entry of readdirSync8(pluginsDir)) {
         let isDir2 = false;
         try {
-          isDir2 = statSync8(join14(pluginsDir, entry)).isDirectory();
+          isDir2 = statSync8(join15(pluginsDir, entry)).isDirectory();
         } catch {
           continue;
         }
-        const p = join14(pluginsDir, entry, "check.js");
-        if (isDir2 && existsSync12(p))
+        const p = join15(pluginsDir, entry, "check.js");
+        if (isDir2 && existsSync13(p))
           checks.push(p);
       }
     }
@@ -2824,12 +2894,12 @@ all plugin checks passed.`);
 // scripts/vault.ts
 var exports_vault = {};
 import { spawnSync as spawnSync4 } from "node:child_process";
-import { existsSync as existsSync13, mkdirSync as mkdirSync5, readdirSync as readdirSync9, statSync as statSync9 } from "node:fs";
+import { existsSync as existsSync14, 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";
+import { basename as basename6, dirname as dirname4, join as join16, resolve as resolve6 } from "node:path";
 function noteCount(project) {
-  const root = join15(project, "vault");
-  if (!existsSync13(root))
+  const root = join16(project, "vault");
+  if (!existsSync14(root))
     return 0;
   let n = 0;
   const walk3 = (dir2, atRoot) => {
@@ -2841,7 +2911,7 @@ function noteCount(project) {
       if (atRoot && CONTROL3.has(e.name))
         continue;
       if (e.isDirectory())
-        walk3(join15(dir2, e.name), false);
+        walk3(join16(dir2, e.name), false);
       else if (e.name.endsWith(".md"))
         n++;
     }
@@ -2884,7 +2954,7 @@ function tar(...a) {
 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;
+}, positionals, expand = (p) => resolve6(p.startsWith("~/") ? join16(homedir4(), p.slice(2)) : p), CONTROL3;
 var init_vault = __esm(() => {
   init_registry();
   args5 = process.argv.slice(2);
@@ -2919,7 +2989,7 @@ var init_vault = __esm(() => {
       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`);
+      const out = join16(outDir, `${name}-${stamp}.tar.gz`);
       if (tar("czf", out, "-C", dirname4(path), basename6(path)) !== 0) {
         console.error("archive failed");
         process.exit(1);
@@ -2940,11 +3010,11 @@ var init_vault = __esm(() => {
         console.error("usage: imprnt vault restore <archive.tar.gz> <dir>");
         process.exit(1);
       }
-      if (!existsSync13(src3)) {
+      if (!existsSync14(src3)) {
         console.error(`no archive at ${src3}`);
         process.exit(1);
       }
-      if (existsSync13(dest2) && readdirSync9(dest2).length) {
+      if (existsSync14(dest2) && readdirSync9(dest2).length) {
         console.error(`${dest2} is not empty — restore into a new directory, then move it`);
         process.exit(1);
       }
@@ -2953,7 +3023,7 @@ var init_vault = __esm(() => {
         console.error("restore failed");
         process.exit(1);
       }
-      const inner = readdirSync9(dest2).map((e) => join15(dest2, e)).filter((p) => statSync9(p).isDirectory());
+      const inner = readdirSync9(dest2).map((e) => join16(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`);
@@ -2981,9 +3051,9 @@ pointed at nothing — so the vault outlives whatever reads it.`);
 
 // 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 { cpSync as cpSync3, mkdirSync as mkdirSync6, chmodSync, existsSync as existsSync15, readFileSync as readFileSync15, 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 { join as join17, 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";
@@ -2991,7 +3061,7 @@ function pluginRoot() {
   const local = projectRoot();
   if (process.env.IMPRNT_ROOT || process.env.IMPRINT_ROOT)
     return local;
-  if (existsSync14(join16(local, "vault")) || existsSync14(join16(local, "CLAUDE.local.md")))
+  if (existsSync15(join17(local, "vault")) || existsSync15(join17(local, "CLAUDE.local.md")))
     return local;
   return registeredRoot() ?? local;
 }
@@ -3020,7 +3090,7 @@ function resolvePath(input, base = process.cwd(), home = homedir5()) {
   if (p === "~")
     p = home;
   else if (p.startsWith("~/"))
-    p = join16(home, p.slice(2));
+    p = join17(home, p.slice(2));
   return resolve7(base, p);
 }
 function initPositional(args6) {
@@ -3029,7 +3099,7 @@ function initPositional(args6) {
 function physicalTarget(target) {
   let existing = target;
   const tail = [];
-  while (!existsSync14(existing)) {
+  while (!existsSync15(existing)) {
     const parent = dirname5(existing);
     if (parent === existing)
       return target;
@@ -3037,7 +3107,7 @@ function physicalTarget(target) {
     existing = parent;
   }
   try {
-    return tail.length ? join16(realpathSync2(existing), ...tail) : realpathSync2(existing);
+    return tail.length ? join17(realpathSync2(existing), ...tail) : realpathSync2(existing);
   } catch {
     return target;
   }
@@ -3073,7 +3143,7 @@ var init_cli = __esm(async () => {
   init_registry();
   init_launch();
   here = dirname5(fileURLToPath(import.meta.url));
-  pkgRoot = join16(here, "..");
+  pkgRoot = join17(here, "..");
   [cmd, ...rest] = process.argv.slice(2);
   asImp = globalThis.__IMPRNT_IMP__ === true;
   if (["ingest", "recall", "snapshot", "check", "vault"].includes(cmd))
@@ -3103,12 +3173,12 @@ var init_cli = __esm(async () => {
           console.log(r);
         console.log("");
       }
-      const p = join16(vault5, "hot.md");
-      if (!existsSync14(p)) {
+      const p = join17(vault5, "hot.md");
+      if (!existsSync15(p)) {
         console.error(`no hot.md at ${p} — run \`imprnt init\``);
         process.exit(1);
       }
-      console.log(readFileSync14(p, "utf8"));
+      console.log(readFileSync15(p, "utf8"));
       break;
     }
     case "lair": {
@@ -3120,12 +3190,12 @@ var init_cli = __esm(async () => {
     }
     case "context": {
       const home = requireVaultHome();
-      const contract = join16(home, "CLAUDE.md");
-      if (!existsSync14(contract)) {
+      const contract = join17(home, "CLAUDE.md");
+      if (!existsSync15(contract)) {
         console.error(`no CLAUDE.md at ${home} — run \`imprnt init\` there to drop the contract`);
         process.exit(1);
       }
-      process.stdout.write(readFileSync14(contract, "utf8"));
+      process.stdout.write(readFileSync15(contract, "utf8"));
       break;
     }
     case "agent": {
@@ -3324,7 +3394,7 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
       process.exit(1);
     }
     case "global": {
-      const globalDir = process.env.CLAUDE_CONFIG_DIR || join16(homedir5(), ".claude");
+      const globalDir = process.env.CLAUDE_CONFIG_DIR || join17(homedir5(), ".claude");
       const [sub2, ...gargs] = rest;
       if (sub2 === "list") {
         const enabled = listGlobalModules(globalDir);
@@ -3359,8 +3429,8 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
         }
         const name = names[0];
         const proj = pluginRoot();
-        const srcDir = from ? resolve7(from) : join16(proj, "plugins", name);
-        if (!existsSync14(srcDir)) {
+        const srcDir = from ? resolve7(from) : join17(proj, "plugins", name);
+        if (!existsSync15(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);
         }
@@ -3404,7 +3474,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() : join16(homedir5(), "imprnt");
+        const fallback = inPlace ? process.cwd() : join17(homedir5(), "imprnt");
         const rl = createInterface2({ input: process.stdin, output: process.stdout });
         const answer = (await rl.question(`vault location [${display}]: `)).trim();
         rl.close();
@@ -3413,7 +3483,7 @@ enable: imprnt plugin add <name>   disable: imprnt plugin rm <name> [--purge]`);
         target = process.cwd();
       }
       const toCwd = target === process.cwd();
-      const rel = (sub2) => toCwd ? `./${sub2}` : join16(target, sub2);
+      const rel = (sub2) => toCwd ? `./${sub2}` : join17(target, sub2);
       const lexicalEnclosing = projectRoot(target);
       const physical = physicalTarget(target);
       const physicalEnclosing = projectRoot(physical);
@@ -3426,12 +3496,12 @@ 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 = join16(target, "vault");
-      const vaultExisted = existsSync14(vaultPath);
+      const vaultPath = join17(target, "vault");
+      const vaultExisted = existsSync15(vaultPath);
       let createdDirs = 0;
       for (const d of ["", "vault", ...vaultDirs.map((t) => `vault/${t}`), "raw"]) {
-        const abs = d ? join16(target, d) : target;
-        if (!existsSync14(abs))
+        const abs = d ? join17(target, d) : target;
+        if (!existsSync15(abs))
           createdDirs++;
         try {
           mkdirSync6(abs, { recursive: true });
@@ -3446,25 +3516,25 @@ 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 = join16(vaultPath, f);
+        const dst = join17(vaultPath, f);
         const slot = controlSlot(dst);
         if (slot.startsWith("blocked")) {
           console.error(blockedMsg(`vault/${f}`, slot));
           process.exit(1);
         }
         if (slot === "create") {
-          cpSync3(join16(pkgRoot, "templates", f), dst);
+          cpSync3(join17(pkgRoot, "templates", f), dst);
           added.push(`vault/${f}`);
         }
       }
-      const claudeMd = join16(target, "CLAUDE.md");
+      const claudeMd = join17(target, "CLAUDE.md");
       const cmSlot = controlSlot(claudeMd);
       if (cmSlot.startsWith("blocked")) {
         console.error(blockedMsg("CLAUDE.md", cmSlot));
         process.exit(1);
       }
-      if (cmSlot === "create" && existsSync14(join16(pkgRoot, "CLAUDE.md"))) {
-        cpSync3(join16(pkgRoot, "CLAUDE.md"), claudeMd);
+      if (cmSlot === "create" && existsSync15(join17(pkgRoot, "CLAUDE.md"))) {
+        cpSync3(join17(pkgRoot, "CLAUDE.md"), claudeMd);
         added.push("CLAUDE.md");
       }
       try {
@@ -3506,8 +3576,8 @@ 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 = join16(pluginRoot(), "plugins", cmd, `${cmd}.js`);
-        if (existsSync14(modScript)) {
+        const modScript = join17(pluginRoot(), "plugins", cmd, `${cmd}.js`);
+        if (existsSync15(modScript)) {
           const proc = spawnSync5(process.execPath, [modScript, ...rest], { stdio: "inherit" });
           process.exit(proc.status ?? 1);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imprnt",
-  "version": "0.1.4-edge.88",
+  "version": "0.1.4-edge.89",
   "stable": true,
   "description": "Deterministic-first, plain-markdown knowledge vault. Code does the bulk transform. The LLM only touches the irreducibly-semantic 20%. Native grep plus BM25 retrieval, zero MCP on the vault.",
   "type": "module",