@remnic/core 9.69.48 → 9.69.50

package/dist/chunk-UD6W67JM.js

@@ -0,0 +1,260 @@
+import {
+  OKF_RESERVED_BASENAMES
+} from "./chunk-PCEYGOSL.js";
+import {
+  normalizeProjectionPreview
+} from "./chunk-SCU65EZI.js";
+import {
+  writeFileAtomically
+} from "./chunk-AW4QUFQF.js";
+import {
+  RECALL_FALLBACK_DIRS
+} from "./chunk-VS2IYZRU.js";
+
+// src/directory-sidecars.ts
+import { createHash } from "crypto";
+import { lstatSync, readFileSync, readdirSync, statSync, unlinkSync } from "fs";
+import path from "path";
+var DIRECTORY_SIDECAR_BASENAME = "overview.md";
+var DIRECTORY_SIDECAR_MARKER = "<!-- remnic-directory-sidecar -->";
+var ABSTRACT_MAX_CHARS = 256;
+var OVERVIEW_MAX_CHARS = 4e3;
+var DEFAULT_QUERY_LIMIT = 5;
+var RESERVED_CHILD_BASENAMES = Object.freeze({
+  ...OKF_RESERVED_BASENAMES,
+  [DIRECTORY_SIDECAR_BASENAME]: true
+});
+function listEntries(dir) {
+  try {
+    return readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+}
+function isRealDirectory(entryPath) {
+  try {
+    const stats = lstatSync(entryPath);
+    return !stats.isSymbolicLink() && stats.isDirectory();
+  } catch {
+    return false;
+  }
+}
+function memoryChildren(dir) {
+  return listEntries(dir).filter((entry) => entry.isFile() && !RESERVED_CHILD_BASENAMES[entry.name] && entry.name.endsWith(".md")).map((entry) => entry.name).sort((a, b) => a.localeCompare(b));
+}
+function directoryChildren(dir) {
+  return listEntries(dir).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort((a, b) => a.localeCompare(b));
+}
+function directoryFingerprint(dir) {
+  const hash = createHash("sha256");
+  for (const name of memoryChildren(dir)) {
+    try {
+      const stats = statSync(path.join(dir, name));
+      hash.update(`f|${name}|${stats.size}|${Math.trunc(stats.mtimeMs)}
+`);
+    } catch {
+      hash.update(`f|${name}|missing
+`);
+    }
+  }
+  for (const name of directoryChildren(dir)) {
+    hash.update(`d|${name}|${directoryFingerprint(path.join(dir, name))}
+`);
+  }
+  return hash.digest("hex");
+}
+function readFileOrNull(target) {
+  try {
+    return readFileSync(target, "utf8");
+  } catch {
+    return null;
+  }
+}
+function parseSidecar(content) {
+  if (!content.startsWith(DIRECTORY_SIDECAR_MARKER)) return null;
+  const fingerprint = /^fingerprint: ([0-9a-f]{64})$/m.exec(content)?.[1];
+  if (!fingerprint) return null;
+  const abstract = /^## Abstract\n([^\n]+)$/m.exec(content)?.[1] ?? "";
+  const overviewStart = content.indexOf("## Abstract");
+  const overview = overviewStart === -1 ? "" : content.slice(overviewStart, overviewStart + OVERVIEW_MAX_CHARS).trim();
+  const childCount = (content.match(/^\* .+$/gm) ?? []).length;
+  return { abstract, overview, childCount, fingerprint };
+}
+function sidecarPath(dir) {
+  return path.join(dir, DIRECTORY_SIDECAR_BASENAME);
+}
+function renderSidecar(dir, fingerprint, childAbstracts) {
+  const children = memoryChildren(dir);
+  const childDirs = directoryChildren(dir).filter((name) => childAbstracts.has(path.join(dir, name)));
+  if (children.length === 0 && childDirs.length === 0) return null;
+  const previews = children.map((name) => {
+    try {
+      return normalizeProjectionPreview(readFileSync(path.join(dir, name), "utf8"), 120);
+    } catch {
+      return "";
+    }
+  });
+  const titles = children.map(
+    (name, index) => previews[index].split(" ").slice(0, 8).join(" ") || name.replace(/\.md$/, "")
+  );
+  const abstract = normalizeProjectionPreview(
+    `${path.basename(dir)}/ \u2014 ${children.length} memories: ${titles.slice(0, 5).join(" \xB7 ")}`,
+    ABSTRACT_MAX_CHARS
+  );
+  const lines = [
+    DIRECTORY_SIDECAR_MARKER,
+    `fingerprint: ${fingerprint}`,
+    `# ${path.basename(dir)}/ overview`,
+    "",
+    "## Abstract",
+    abstract,
+    "",
+    "## Children"
+  ];
+  for (const [index, name] of children.entries()) {
+    lines.push(`* ${name} \u2014 ${previews[index]}`);
+  }
+  for (const name of childDirs) {
+    lines.push(`### ${name}/`);
+    lines.push(childAbstracts.get(path.join(dir, name)) ?? "");
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function scopeRoots(memoryDir) {
+  const roots = [memoryDir];
+  const namespacesRoot = path.join(memoryDir, "namespaces");
+  for (const entry of listEntries(namespacesRoot)) {
+    if (entry.isDirectory() && isRealDirectory(path.join(namespacesRoot, entry.name))) {
+      roots.push(path.join(namespacesRoot, entry.name));
+    }
+  }
+  return roots;
+}
+function collectSidecarDirs(scopeRoot) {
+  const dirs = [];
+  const walk = (dir, isCategoryRoot) => {
+    let carries = memoryChildren(dir).length > 0;
+    for (const name of directoryChildren(dir)) {
+      carries = walk(path.join(dir, name), false) || carries;
+    }
+    const hasSidecar = readFileOrNull(sidecarPath(dir))?.startsWith(DIRECTORY_SIDECAR_MARKER) === true;
+    if (isCategoryRoot || carries || hasSidecar) dirs.push(dir);
+    return carries;
+  };
+  for (const category of RECALL_FALLBACK_DIRS) {
+    const categoryDir = path.join(scopeRoot, category);
+    if (!isRealDirectory(categoryDir)) continue;
+    walk(categoryDir, true);
+  }
+  return dirs;
+}
+async function runDirectorySidecarMaintenance(memoryDir, enabled) {
+  const written = [];
+  const removed = [];
+  for (const scope of scopeRoots(memoryDir)) {
+    const childAbstracts = /* @__PURE__ */ new Map();
+    for (const dir of collectSidecarDirs(scope)) {
+      const target = sidecarPath(dir);
+      const raw = readFileOrNull(target);
+      const existing = raw !== null && raw.startsWith(DIRECTORY_SIDECAR_MARKER) ? raw : null;
+      if (!enabled) {
+        if (existing !== null) {
+          unlinkSync(target);
+          removed.push(target);
+        }
+        continue;
+      }
+      const next = renderSidecar(dir, directoryFingerprint(dir), childAbstracts);
+      if (next === null) {
+        if (existing !== null) {
+          unlinkSync(target);
+          removed.push(target);
+        }
+        continue;
+      }
+      const parsedNext = parseSidecar(next);
+      if (parsedNext) childAbstracts.set(dir, parsedNext.abstract);
+      if (raw === next) continue;
+      if (existing === null && raw !== null) continue;
+      await writeFileAtomically(target, next);
+      written.push(target);
+    }
+  }
+  return { written, removed };
+}
+async function loadDirectorySidecar(dir, options = {}) {
+  const refresh = options.refresh !== false;
+  const target = sidecarPath(dir);
+  const stored = readFileOrNull(target);
+  const generated = stored !== null && stored.startsWith(DIRECTORY_SIDECAR_MARKER);
+  const parsed = generated ? parseSidecar(stored) : null;
+  const fingerprint = directoryFingerprint(dir);
+  if (parsed !== null && (parsed.fingerprint === fingerprint || !refresh)) {
+    return {
+      dir,
+      abstract: parsed.abstract,
+      overview: parsed.overview,
+      childCount: parsed.childCount,
+      fresh: parsed.fingerprint === fingerprint
+    };
+  }
+  if (!refresh) return null;
+  const childAbstracts = /* @__PURE__ */ new Map();
+  for (const name of directoryChildren(dir)) {
+    const child = await loadDirectorySidecar(path.join(dir, name));
+    if (child) childAbstracts.set(path.join(dir, name), child.abstract);
+  }
+  const next = renderSidecar(dir, directoryFingerprint(dir), childAbstracts);
+  if (next === null) {
+    if (generated) unlinkSync(target);
+    return null;
+  }
+  if (readFileOrNull(target) !== next) {
+    if (stored !== null && !generated) {
+      return null;
+    }
+    await writeFileAtomically(target, next);
+  }
+  const refreshed = parseSidecar(next);
+  return refreshed ? {
+    dir,
+    abstract: refreshed.abstract,
+    overview: refreshed.overview,
+    childCount: refreshed.childCount,
+    fresh: true
+  } : null;
+}
+async function findDirectorySidecarsForQuery(memoryDir, query, options = {}) {
+  const scope = options.namespace ? path.join(memoryDir, "namespaces", options.namespace) : memoryDir;
+  if (!isRealDirectory(scope)) return [];
+  const terms = query.toLowerCase().split(/[^a-z0-9]+/).filter((term) => term.length >= 2);
+  const matches = [];
+  for (const root of scopeRoots(scope)) {
+    for (const dir of collectSidecarDirs(root)) {
+      const sidecar = await loadDirectorySidecar(dir);
+      if (!sidecar) continue;
+      const abstractLower = sidecar.abstract.toLowerCase();
+      const overviewLower = sidecar.overview.toLowerCase();
+      let score = 0;
+      for (const term of terms) {
+        if (abstractLower.includes(term)) score += 3;
+        else if (overviewLower.includes(term)) score += 1;
+      }
+      if (score > 0) matches.push({ ...sidecar, score });
+    }
+  }
+  matches.sort((a, b) => b.score - a.score || a.dir.localeCompare(b.dir));
+  const limit = options.limit ?? DEFAULT_QUERY_LIMIT;
+  return matches.filter((candidate) => !matches.some((other) => other.dir.startsWith(`${candidate.dir}${path.sep}`))).slice(0, limit);
+}
+
+export {
+  DIRECTORY_SIDECAR_BASENAME,
+  DIRECTORY_SIDECAR_MARKER,
+  directoryFingerprint,
+  runDirectorySidecarMaintenance,
+  loadDirectorySidecar,
+  findDirectorySidecarsForQuery
+};
+//# sourceMappingURL=chunk-UD6W67JM.js.map

package/dist/chunk-UD6W67JM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/directory-sidecars.ts"],"sourcesContent":["/**\n * @remnic/core — per-directory abstract/overview sidecars (issue #2977).\n *\n * One derived `overview.md` per memory directory (category roots and every\n * directory beneath them, including `namespaces/<ns>/` subtrees), rendered\n * bottom-up from existing memory content:\n *\n *   - the ABSTRACT is a single line (<=256 chars) composed from child titles;\n *   - the OVERVIEW body lists one preview line per child memory and embeds\n *     each child DIRECTORY's abstract, so a parent summarizes its subtree\n *     without embedding full child overviews.\n *\n * Determinism: no LLM, no embeddings. Content is assembled with the same\n * preview machinery the OKF index files use (`normalizeProjectionPreview`).\n *\n * Invalidation: each sidecar stores a content-free fingerprint of its subtree\n * (child name|size|mtime for files, recursive fingerprints for child dirs).\n * Any add/edit/delete anywhere below a directory changes its fingerprint, so\n * `loadDirectorySidecar` can detect staleness with `readdir`+`stat` alone and\n * refresh without reading child memory files first. Eager regeneration runs\n * through {@link runDirectorySidecarMaintenance}; lazy refresh on read covers\n * direct-write paths that bypass scheduled maintenance (Gotcha #43).\n *\n * Isolation: sidecars are derived artifacts, excluded from generic recall via\n * `isGenericRecallExcludedPath` (basename match, the same tradeoff OKF makes\n * for `index.md`/`log.md`) while staying full-text searchable. Files at the\n * sidecar path WITHOUT the marker are user content: never overwritten, never\n * removed.\n */\n\nimport { createHash } from \"node:crypto\";\nimport { lstatSync, readFileSync, readdirSync, statSync, unlinkSync } from \"node:fs\";\nimport path from \"node:path\";\n\nimport { writeFileAtomically } from \"./maintenance/atomic-file.js\";\nimport { normalizeProjectionPreview } from \"./memory-projection-format.js\";\nimport { OKF_RESERVED_BASENAMES } from \"./okf/type-mapping.js\";\nimport { RECALL_FALLBACK_DIRS } from \"./utils/category-dir.js\";\n\nexport const DIRECTORY_SIDECAR_BASENAME = \"overview.md\";\nexport const DIRECTORY_SIDECAR_MARKER = \"<!-- remnic-directory-sidecar -->\";\n\nconst ABSTRACT_MAX_CHARS = 256;\nconst OVERVIEW_MAX_CHARS = 4000;\nconst DEFAULT_QUERY_LIMIT = 5;\n\n/** Basenames never treated as child memories (ours plus OKF's reserved ones). */\nconst RESERVED_CHILD_BASENAMES: Readonly<Record<string, true>> = Object.freeze({\n  ...OKF_RESERVED_BASENAMES,\n  [DIRECTORY_SIDECAR_BASENAME]: true,\n});\n\nexport interface DirectorySidecar {\n  /** Absolute directory the sidecar describes. */\n  readonly dir: string;\n  /** Single-line L0 abstract (<=256 chars). */\n  readonly abstract: string;\n  /** Abstract plus the per-child preview body (<=4000 chars). */\n  readonly overview: string;\n  /** Number of memory `.md` children in this directory. */\n  readonly childCount: number;\n  /** False when the stored fingerprint no longer matches the subtree. */\n  readonly fresh: boolean;\n}\n\nexport interface DirectorySidecarMatch extends DirectorySidecar {\n  readonly score: number;\n}\n\nexport interface DirectorySidecarReport {\n  written: string[];\n  removed: string[];\n}\n\ninterface ParsedSidecar {\n  abstract: string;\n  overview: string;\n  childCount: number;\n  fingerprint: string;\n}\n\nfunction listEntries(dir: string) {\n  try {\n    return readdirSync(dir, { withFileTypes: true });\n  } catch {\n    return [];\n  }\n}\n\n/** Root check that refuses symlinks (fs-boundary rule, PRs #1938/#1999). */\nfunction isRealDirectory(entryPath: string): boolean {\n  try {\n    const stats = lstatSync(entryPath);\n    return !stats.isSymbolicLink() && stats.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nfunction memoryChildren(dir: string): string[] {\n  // Dirent.isFile() is false for symlinks, so a linked memory never enters the corpus.\n  return listEntries(dir)\n    .filter((entry) => entry.isFile() && !RESERVED_CHILD_BASENAMES[entry.name] && entry.name.endsWith(\".md\"))\n    .map((entry) => entry.name)\n    .sort((a, b) => a.localeCompare(b));\n}\n\nfunction directoryChildren(dir: string): string[] {\n  // Dirent.isDirectory() is false for symlinks (fs-boundary rule, PRs #1938/#1999).\n  return listEntries(dir)\n    .filter((entry) => entry.isDirectory())\n    .map((entry) => entry.name)\n    .sort((a, b) => a.localeCompare(b));\n}\n\n/**\n * Content-free subtree fingerprint: sha256 over sorted child descriptors.\n * Files contribute `name|size|mtimeMs`; directories contribute their own\n * recursive fingerprint, so any change below a directory invalidates every\n * ancestor. Reads no file contents.\n */\nexport function directoryFingerprint(dir: string): string {\n  const hash = createHash(\"sha256\");\n  for (const name of memoryChildren(dir)) {\n    try {\n      const stats = statSync(path.join(dir, name));\n      hash.update(`f|${name}|${stats.size}|${Math.trunc(stats.mtimeMs)}\\n`);\n    } catch {\n      hash.update(`f|${name}|missing\\n`);\n    }\n  }\n  for (const name of directoryChildren(dir)) {\n    hash.update(`d|${name}|${directoryFingerprint(path.join(dir, name))}\\n`);\n  }\n  return hash.digest(\"hex\");\n}\n\nfunction readFileOrNull(target: string): string | null {\n  try {\n    return readFileSync(target, \"utf8\");\n  } catch {\n    return null;\n  }\n}\n\nfunction parseSidecar(content: string): ParsedSidecar | null {\n  if (!content.startsWith(DIRECTORY_SIDECAR_MARKER)) return null;\n  const fingerprint = /^fingerprint: ([0-9a-f]{64})$/m.exec(content)?.[1];\n  if (!fingerprint) return null;\n  const abstract = /^## Abstract\\n([^\\n]+)$/m.exec(content)?.[1] ?? \"\";\n  const overviewStart = content.indexOf(\"## Abstract\");\n  const overview =\n    overviewStart === -1 ? \"\" : content.slice(overviewStart, overviewStart + OVERVIEW_MAX_CHARS).trim();\n  // The `* name — preview` child bullets are the rendered child count.\n  const childCount = (content.match(/^\\* .+$/gm) ?? []).length;\n  return { abstract, overview, childCount, fingerprint };\n}\n\nfunction sidecarPath(dir: string): string {\n  return path.join(dir, DIRECTORY_SIDECAR_BASENAME);\n}\n\nfunction renderSidecar(dir: string, fingerprint: string, childAbstracts: Map<string, string>): string | null {\n  const children = memoryChildren(dir);\n  const childDirs = directoryChildren(dir).filter((name) => childAbstracts.has(path.join(dir, name)));\n  if (children.length === 0 && childDirs.length === 0) return null;\n\n  const previews = children.map((name) => {\n    try {\n      return normalizeProjectionPreview(readFileSync(path.join(dir, name), \"utf8\"), 120);\n    } catch {\n      return \"\";\n    }\n  });\n  const titles = children.map(\n    (name, index) => previews[index].split(\" \").slice(0, 8).join(\" \") || name.replace(/\\.md$/, \"\"),\n  );\n  const abstract = normalizeProjectionPreview(\n    `${path.basename(dir)}/ — ${children.length} memories: ${titles.slice(0, 5).join(\" · \")}`,\n    ABSTRACT_MAX_CHARS,\n  );\n\n  const lines = [\n    DIRECTORY_SIDECAR_MARKER,\n    `fingerprint: ${fingerprint}`,\n    `# ${path.basename(dir)}/ overview`,\n    \"\",\n    \"## Abstract\",\n    abstract,\n    \"\",\n    \"## Children\",\n  ];\n  for (const [index, name] of children.entries()) {\n    lines.push(`* ${name} — ${previews[index]}`);\n  }\n  for (const name of childDirs) {\n    lines.push(`### ${name}/`);\n    lines.push(childAbstracts.get(path.join(dir, name)) ?? \"\");\n  }\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n/** Scope roots whose category subtrees carry sidecars: the memory root plus every namespace root. */\nfunction scopeRoots(memoryDir: string): string[] {\n  const roots = [memoryDir];\n  const namespacesRoot = path.join(memoryDir, \"namespaces\");\n  for (const entry of listEntries(namespacesRoot)) {\n    if (entry.isDirectory() && isRealDirectory(path.join(namespacesRoot, entry.name))) {\n      roots.push(path.join(namespacesRoot, entry.name));\n    }\n  }\n  return roots;\n}\n\n/**\n * Every directory that should carry a sidecar, deepest first (post-order) so\n * parents render after their children and can embed child abstracts.\n */\nfunction collectSidecarDirs(scopeRoot: string): string[] {\n  const dirs: string[] = [];\n  const walk = (dir: string, isCategoryRoot: boolean): boolean => {\n    let carries = memoryChildren(dir).length > 0;\n    for (const name of directoryChildren(dir)) {\n      carries = walk(path.join(dir, name), false) || carries;\n    }\n    // A directory that stopped carrying memories must still be visited so its\n    // orphaned sidecar can be pruned or rewritten (cache-invalidation completeness).\n    const hasSidecar = readFileOrNull(sidecarPath(dir))?.startsWith(DIRECTORY_SIDECAR_MARKER) === true;\n    if (isCategoryRoot || carries || hasSidecar) dirs.push(dir);\n    return carries;\n  };\n  for (const category of RECALL_FALLBACK_DIRS) {\n    const categoryDir = path.join(scopeRoot, category);\n    if (!isRealDirectory(categoryDir)) continue;\n    walk(categoryDir, true);\n  }\n  return dirs;\n}\n\n/**\n * Regenerate directory sidecars incrementally. Unchanged sidecars are left\n * untouched; emptied directories lose theirs; user files at the sidecar path\n * (no marker) are never written or removed. With `enabled: false` every\n * generated sidecar is removed — the OKF index-maintenance contract.\n */\nexport async function runDirectorySidecarMaintenance(\n  memoryDir: string,\n  enabled: boolean,\n): Promise<DirectorySidecarReport> {\n  const written: string[] = [];\n  const removed: string[] = [];\n  for (const scope of scopeRoots(memoryDir)) {\n    const childAbstracts = new Map<string, string>();\n    for (const dir of collectSidecarDirs(scope)) {\n      const target = sidecarPath(dir);\n      const raw = readFileOrNull(target);\n      const existing = raw !== null && raw.startsWith(DIRECTORY_SIDECAR_MARKER) ? raw : null;\n      if (!enabled) {\n        if (existing !== null) {\n          unlinkSync(target);\n          removed.push(target);\n        }\n        continue;\n      }\n      const next = renderSidecar(dir, directoryFingerprint(dir), childAbstracts);\n      if (next === null) {\n        if (existing !== null) {\n          unlinkSync(target);\n          removed.push(target);\n        }\n        continue;\n      }\n      const parsedNext = parseSidecar(next);\n      if (parsedNext) childAbstracts.set(dir, parsedNext.abstract);\n      if (raw === next) continue;\n      if (existing === null && raw !== null) continue; // user-authored file: hands off\n      await writeFileAtomically(target, next);\n      written.push(target);\n    }\n  }\n  return { written, removed };\n}\n\n/**\n * Read a directory's sidecar for retrieval. By default a stale sidecar is\n * refreshed in place (child directories first), which is what makes direct\n * writes that bypass maintenance still converge. With `{ refresh: false }`\n * the stored sidecar is returned as-is with `fresh: false` so callers can\n * observe staleness without writes.\n */\nexport async function loadDirectorySidecar(\n  dir: string,\n  options: { refresh?: boolean } = {},\n): Promise<DirectorySidecar | null> {\n  const refresh = options.refresh !== false;\n  const target = sidecarPath(dir);\n  const stored = readFileOrNull(target);\n  const generated = stored !== null && stored.startsWith(DIRECTORY_SIDECAR_MARKER);\n  const parsed = generated ? parseSidecar(stored) : null;\n  const fingerprint = directoryFingerprint(dir);\n  if (parsed !== null && (parsed.fingerprint === fingerprint || !refresh)) {\n    return {\n      dir,\n      abstract: parsed.abstract,\n      overview: parsed.overview,\n      childCount: parsed.childCount,\n      fresh: parsed.fingerprint === fingerprint,\n    };\n  }\n  if (!refresh) return null;\n\n  // Refresh bottom-up so this directory's body embeds current child abstracts.\n  const childAbstracts = new Map<string, string>();\n  for (const name of directoryChildren(dir)) {\n    const child = await loadDirectorySidecar(path.join(dir, name));\n    if (child) childAbstracts.set(path.join(dir, name), child.abstract);\n  }\n  const next = renderSidecar(dir, directoryFingerprint(dir), childAbstracts);\n  if (next === null) {\n    if (generated) unlinkSync(target);\n    return null;\n  }\n  if (readFileOrNull(target) !== next) {\n    if (stored !== null && !generated) {\n      // User-authored file at the sidecar path: serve nothing rather than clobber it.\n      return null;\n    }\n    await writeFileAtomically(target, next);\n  }\n  const refreshed = parseSidecar(next);\n  return refreshed\n    ? {\n        dir,\n        abstract: refreshed.abstract,\n        overview: refreshed.overview,\n        childCount: refreshed.childCount,\n        fresh: true,\n      }\n    : null;\n}\n\n/**\n * Overview-query primitive for hierarchical retrieval (layer 1 of #2977):\n * score every sidecar's abstract (+3 per query term) and overview (+1 per\n * term) lexically, then return the most specific matches — when both a\n * directory and its descendant match, only the descendant is kept, matching\n * the drill-down semantics the full retrieval mode will build on.\n */\nexport async function findDirectorySidecarsForQuery(\n  memoryDir: string,\n  query: string,\n  options: { namespace?: string; limit?: number } = {},\n): Promise<DirectorySidecarMatch[]> {\n  const scope = options.namespace ? path.join(memoryDir, \"namespaces\", options.namespace) : memoryDir;\n  if (!isRealDirectory(scope)) return [];\n  const terms = query\n    .toLowerCase()\n    .split(/[^a-z0-9]+/)\n    .filter((term) => term.length >= 2);\n\n  const matches: DirectorySidecarMatch[] = [];\n  for (const root of scopeRoots(scope)) {\n    for (const dir of collectSidecarDirs(root)) {\n      const sidecar = await loadDirectorySidecar(dir);\n      if (!sidecar) continue;\n      const abstractLower = sidecar.abstract.toLowerCase();\n      const overviewLower = sidecar.overview.toLowerCase();\n      let score = 0;\n      for (const term of terms) {\n        if (abstractLower.includes(term)) score += 3;\n        else if (overviewLower.includes(term)) score += 1;\n      }\n      if (score > 0) matches.push({ ...sidecar, score });\n    }\n  }\n  matches.sort((a, b) => b.score - a.score || a.dir.localeCompare(b.dir));\n\n  const limit = options.limit ?? DEFAULT_QUERY_LIMIT;\n  return matches\n    .filter((candidate) => !matches.some((other) => other.dir.startsWith(`${candidate.dir}${path.sep}`)))\n    .slice(0, limit);\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-5KBI2MOC.js → chunk-UI6R2YUB.js}

@@ -318,4 +318,4 @@ export {
   readProjectedHarmonicGraph,
   searchHarmonicRetrieval
 };
-//# sourceMappingURL=chunk-5KBI2MOC.js.map
+//# sourceMappingURL=chunk-UI6R2YUB.js.map

package/dist/{chunk-V7IONNTJ.js → chunk-UVEBBXB5.js}

@@ -1,7 +1,7 @@
 import {
   RECALL_DISCLOSURE_LEVELS,
   isRecallDisclosure
-} from "./chunk-WQW6KPVC.js";
+} from "./chunk-PQWICTRO.js";
 
 // src/recall-navigate-disclosure.ts
 function disclosureRank(level) {
@@ -27,4 +27,4 @@ export {
   disclosureRank,
   planDisclosureStep
 };
-//# sourceMappingURL=chunk-V7IONNTJ.js.map
+//# sourceMappingURL=chunk-UVEBBXB5.js.map

package/dist/{chunk-I6IJDTRP.js → chunk-VBRS7Z3O.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-DBB5JPSL.js";
 import {
   isGenericRecallExcludedPath
-} from "./chunk-DE4ZGH2N.js";
+} from "./chunk-2IVHOQRY.js";
 import {
   shouldFilterSupersededFromRecall
 } from "./chunk-5WITETWU.js";
@@ -69,4 +69,4 @@ export {
   filterRecentScanMemoriesForStateView,
   indexStateViewAnnotatedResults
 };
-//# sourceMappingURL=chunk-I6IJDTRP.js.map
+//# sourceMappingURL=chunk-VBRS7Z3O.js.map

package/dist/{chunk-XEHLYA5Z.js → chunk-W6V7JN2E.js}

@@ -7,10 +7,10 @@ import {
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-YXWMZAAN.js";
+} from "./chunk-D7QX26FF.js";
 import {
   StorageManager
-} from "./chunk-MNG536IS.js";
+} from "./chunk-D2XUSZ24.js";
 import {
   normalizeProjectionPreview,
   normalizeProjectionTags
@@ -1005,4 +1005,4 @@ export {
   verifyMemoryProjection,
   repairMemoryProjection
 };
-//# sourceMappingURL=chunk-XEHLYA5Z.js.map
+//# sourceMappingURL=chunk-W6V7JN2E.js.map

package/dist/{chunk-NNFB4CU4.js → chunk-X6B2QWXW.js}

@@ -1,7 +1,7 @@
 import {
   SupportPassportError,
   getOperation
-} from "./chunk-KPYMORPQ.js";
+} from "./chunk-OQZYHCWM.js";
 import {
   abortError,
   isAbortError
@@ -499,4 +499,4 @@ export {
   buildSupportPassportPublicRequestHandler,
   composeSupportPassportExternalRequestHandlers
 };
-//# sourceMappingURL=chunk-NNFB4CU4.js.map
+//# sourceMappingURL=chunk-X6B2QWXW.js.map

package/dist/{chunk-BNX2TUSF.js → chunk-XTMABIFW.js}

@@ -3,7 +3,7 @@ import {
   getOperation,
   operationRequiresAuthorizedNamespace,
   operationUsesPrincipalNamespace
-} from "./chunk-KPYMORPQ.js";
+} from "./chunk-OQZYHCWM.js";
 import {
   assertOperationAuthorizationAllowed
 } from "./chunk-MZWSOLMT.js";
@@ -60,4 +60,4 @@ export {
   authorizationProbeNamespaces,
   authorizationProbeRequiresPrincipalNamespace
 };
-//# sourceMappingURL=chunk-BNX2TUSF.js.map
+//# sourceMappingURL=chunk-XTMABIFW.js.map

package/dist/{chunk-QLCMOHRE.js → chunk-XUKUMBP3.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-MNG536IS.js";
+} from "./chunk-D2XUSZ24.js";
 import {
   normalizeEntityName
 } from "./chunk-YXZG5TVN.js";
@@ -957,4 +957,4 @@ export {
   resolveBriefingSaveDir,
   briefingFilename
 };
-//# sourceMappingURL=chunk-QLCMOHRE.js.map
+//# sourceMappingURL=chunk-XUKUMBP3.js.map

package/dist/{chunk-EZ25VE3G.js → chunk-YNDLCWXS.js}

@@ -1,9 +1,9 @@
-import {
-  graphSnapshotFromMemoryDir
-} from "./chunk-44442YCH.js";
 import {
   diffGraphSnapshots
 } from "./chunk-AUDJPF4N.js";
+import {
+  graphSnapshotFromMemoryDir
+} from "./chunk-44442YCH.js";
 
 // src/dashboard-runtime.ts
 import { createHash, timingSafeEqual } from "crypto";
@@ -370,4 +370,4 @@ var GraphDashboardServer = class {
 export {
   GraphDashboardServer
 };
-//# sourceMappingURL=chunk-EZ25VE3G.js.map
+//# sourceMappingURL=chunk-YNDLCWXS.js.map

package/dist/{chunk-EWBDJQ5Y.js → chunk-ZBAQMSEY.js}

@@ -1,10 +1,10 @@
 import {
   parseXrayFormat
-} from "./chunk-55XWRL6F.js";
+} from "./chunk-DH536WT2.js";
 import {
   RECALL_DISCLOSURE_LEVELS,
   isRecallDisclosure
-} from "./chunk-WQW6KPVC.js";
+} from "./chunk-PQWICTRO.js";
 
 // src/recall-xray-cli.ts
 function parseXrayDisclosureFlag(value) {
@@ -50,4 +50,4 @@ export {
   parseXrayBudgetFlag,
   parseXrayCliOptions
 };
-//# sourceMappingURL=chunk-EWBDJQ5Y.js.map
+//# sourceMappingURL=chunk-ZBAQMSEY.js.map

package/dist/{chunk-MQT3WP3F.js → chunk-ZUNYFDI4.js}

@@ -1,6 +1,6 @@
 import {
   listNamespaces
-} from "./chunk-OS4JVTHR.js";
+} from "./chunk-6525YIYL.js";
 import {
   capabilityAllowsNamespace
 } from "./chunk-MZWSOLMT.js";
@@ -282,4 +282,4 @@ export {
   computeServiceCorpusWatermarks,
   computeServiceCorpusCensus
 };
-//# sourceMappingURL=chunk-MQT3WP3F.js.map
+//# sourceMappingURL=chunk-ZUNYFDI4.js.map

package/dist/{cli-Bbndoc6k.d.ts → cli-BHDMJqJS.d.ts}

@@ -1,16 +1,16 @@
 import { CompoundingPromotionReport } from './compounding/engine.js';
 import { ConversationIndexBackendInspection } from './conversation-index/backend.js';
 import { MigrateObservationsResult } from './maintenance/migrate-observations.js';
-import { M as MemoryFile, m as MemoryFrontmatter, x as MemoryStatus, ad as BehaviorSignalEvent, Q as QmdSearchResult, ai as BulkImportResult, an as MemoryActionEvent, K as MemoryLifecycleEvent } from './types-DgDaoY61.js';
-import { C as ConversationIndexCoordinator, T as TierMigrationCoordinator, O as Orchestrator } from './orchestrator-Cirjo3ZB.js';
-import { S as StorageManager } from './storage-mD2YQ8_2.js';
+import { M as MemoryFile, m as MemoryFrontmatter, x as MemoryStatus, ad as BehaviorSignalEvent, Q as QmdSearchResult, ai as BulkImportResult, an as MemoryActionEvent, K as MemoryLifecycleEvent } from './types-DCB90q3g.js';
+import { C as ConversationIndexCoordinator, T as TierMigrationCoordinator, O as Orchestrator } from './orchestrator-BTqT3F6X.js';
+import { S as StorageManager } from './storage-DNQWtOSM.js';
 import { TrustZoneDemoSeedResult, TrustZoneName, TrustZonePromotionResult, TrustZoneStoreStatus } from './trust-zones.js';
-import { f as EngramAccessService } from './access-service-DUkTWyZS.js';
+import { f as EngramAccessService } from './access-service-BZaC-RZw.js';
 import { Writable, Readable } from 'node:stream';
 import { ResolveSecretRefFn } from './resolve-auth-token.js';
 import { CausalTrajectoryStoreStatus } from './causal-trajectory.js';
 import { C as ConnectorRunResult, a as ConnectorsOutputFormat } from './connectors-cli-2iaQ5tX2.js';
-import { P as ProcessBatchFn } from './pipeline-DK79FrgH.js';
+import { P as ProcessBatchFn } from './pipeline-CgO2Sd4O.js';
 import { RuntimePolicyValues } from './policy-runtime.js';
 import { MemoryGovernanceRunResult, MemoryGovernanceSummary, MemoryGovernanceMetrics, MemoryGovernanceQualityScore, MemoryGovernanceReviewQueueEntry, MemoryGovernanceAppliedAction, MemoryGovernanceTransitionReport, MemoryGovernanceManifest, MemoryGovernanceRestoreManifest, RestoreMemoryGovernanceRunResult } from './maintenance/memory-governance.js';
 import { RebuildMemoryProjectionResult, RepairMemoryProjectionResult, VerifyMemoryProjectionResult } from './maintenance/rebuild-memory-projection.js';

package/dist/cli.d.ts

@@ -1,17 +1,17 @@
 import './compounding/engine.js';
 import './conversation-index/backend.js';
 import './maintenance/migrate-observations.js';
-import './types-DgDaoY61.js';
-import './orchestrator-Cirjo3ZB.js';
-import './storage-mD2YQ8_2.js';
+import './types-DCB90q3g.js';
+import './orchestrator-BTqT3F6X.js';
+import './storage-DNQWtOSM.js';
 import './trust-zones.js';
-export { c as AccessHttpServeCliCommandOptions, d as ArchiveObservationsCliCommandOptions, e as AuditMemoryCliCommandOptions, B as BulkImportCliCommandOptions, C as CliApi, g as CliCommand, h as CliProgram, i as CompatCliCommandOptions, j as ConnectorsRunCliOutputOptions, k as ConversationIndexHealthCliOrchestrator, D as DashboardStartCliCommandOptions, l as DedupeCandidate, E as ExactDedupePlan, G as GraphHealthCliCommandOptions, M as MemoryActionAuditCliCommandOptions, m as MemoryActionAuditCliNamespaceSummary, n as MemoryActionAuditCliReport, o as MemoryGovernanceCliCommandOptions, q as MemoryGovernanceReportCliCommandOptions, s as MemoryGovernanceRestoreCliCommandOptions, t as MemoryReviewDispositionCliCommandOptions, u as MemoryTimelineCliCommandOptions, v as MigrateCliOrchestrator, w as MigrateCliReport, x as MigrateObservationsCliCommandOptions, P as PolicyDiffCliReport, y as PolicyDiffEntry, z as PolicyRollbackCliReport, F as PolicyStatusCliReport, H as PolicyTuningCliOrchestrator, R as RebuildMemoryLifecycleLedgerCliCommandOptions, I as RebuildMemoryProjectionCliCommandOptions, J as RebuildObservationsCliCommandOptions, K as RepairMemoryProjectionCliCommandOptions, L as ReplayCliCommandOptions, N as ReplayCliOrchestrator, O as RouteCliCommandOptions, S as SessionIntegrityCliCommandOptions, Q as SessionRepairCliCommandOptions, T as TailscaleStatusCliCommandOptions, U as TailscaleSyncCliCommandOptions, V as TierMigrateCliAdapter, W as TierMigrateCoordinatorCliAdapter, X as TierMigrateLegacyCliAdapter, Y as TierStatusCliAdapter, Z as TierStatusCoordinatorCliAdapter, _ as TierStatusLegacyCliAdapter, $ as TrainingExportCliCommandOptions, a0 as VerifyMemoryProjectionCliCommandOptions, a1 as WebDavServeCliCommandOptions, a2 as WorkProjectCliCommandOptions, a3 as WorkTaskCliCommandOptions, a4 as emitConnectorsRunCliResult, a5 as filterNormalMemorySearchResults, a6 as hasDestructivePurgeFailures, a7 as isNormalRetrievalVisibleMemory, a8 as listMemoryMarkdownFilePaths, a9 as parseDurationToMs, aa as parseStrictCliDate, ab as planAggressiveDuplicateDeletions, ac as planExactDuplicateDeletions, ad as registerCli, ae as resolveAccessPrincipalOverride, af as resolveMemoryDirForNamespace, ag as runAbstractionNodeStatusCliCommand, ah as runAccessHttpServeCliCommand, ai as runAccessHttpStatusCliCommand, aj as runAccessHttpStopCliCommand, ak as runAccessMcpServeCliCommand, al as runArchiveObservationsCliCommand, r as runAuditMemoryCliCommand, am as runBenchmarkBaselineReportCliCommand, an as runBenchmarkBaselineSnapshotCliCommand, ao as runBenchmarkCiGateCliCommand, ap as runBenchmarkImportCliCommand, aq as runBenchmarkStatusCliCommand, ar as runBenchmarkStoredBaselineCiGateCliCommand, as as runBenchmarkValidateCliCommand, b as runBulkImportCliCommand, at as runCausalTrajectoryStatusCliCommand, au as runCommitmentLifecycleCliCommand, av as runCommitmentRecordCliCommand, aw as runCommitmentSetStateCliCommand, ax as runCommitmentStatusCliCommand, ay as runCompatCliCommand, az as runCompoundingPromoteCliCommand, aA as runConversationIndexHealthCliCommand, aB as runConversationIndexInspectCliCommand, aC as runConversationIndexRebuildCliCommand, aD as runCueAnchorStatusCliCommand, aE as runDashboardStartCliCommand, aF as runDashboardStatusCliCommand, aG as runDashboardStopCliCommand, aH as runGraphHealthCliCommand, aI as runHarmonicSearchCliCommand, aJ as runMemoryActionAuditCliCommand, aK as runMemoryGovernanceCliCommand, aL as runMemoryGovernanceReportCliCommand, aM as runMemoryGovernanceRestoreCliCommand, aN as runMemoryReviewDispositionCliCommand, aO as runMemoryTimelineCliCommand, aP as runMigrateNormalizeFrontmatterCliCommand, aQ as runMigrateObservationsCliCommand, aR as runMigrateRechunkCliCommand, aS as runMigrateReextractCliCommand, aT as runMigrateRescoreImportanceCliCommand, aU as runObjectiveStateStatusCliCommand, aV as runPolicyDiffCliCommand, aW as runPolicyRollbackCliCommand, aX as runPolicyStatusCliCommand, aY as runRebuildMemoryLifecycleLedgerCliCommand, aZ as runRebuildMemoryProjectionCliCommand, a_ as runRebuildObservationsCliCommand, a$ as runRepairMemoryProjectionCliCommand, b0 as runReplayCliCommand, b1 as runResumeBundleBuildCliCommand, b2 as runResumeBundleRecordCliCommand, b3 as runResumeBundleStatusCliCommand, b4 as runRouteCliCommand, b5 as runSemanticRulePromoteCliCommand, b6 as runSemanticRuleVerifyCliCommand, b7 as runSessionCheckCliCommand, b8 as runSessionRepairCliCommand, b9 as runTailscaleStatusCliCommand, ba as runTailscaleSyncCliCommand, bb as runTierMigrateCliCommand, bc as runTierStatusCliCommand, bd as runTrainingExportCliCommand, be as runTrustZoneDemoSeedCliCommand, bf as runTrustZonePromoteCliCommand, bg as runTrustZoneStatusCliCommand, bh as runUtilityLearningCliCommand, bi as runUtilityLearningStatusCliCommand, bj as runUtilityTelemetryRecordCliCommand, bk as runUtilityTelemetryStatusCliCommand, bl as runVerifiedRecallSearchCliCommand, bm as runVerifyMemoryProjectionCliCommand, bn as runWebDavServeCliCommand, bo as runWebDavStopCliCommand, bp as runWorkProductRecallSearchCliCommand, bq as runWorkProductRecordCliCommand, br as runWorkProductStatusCliCommand, bs as runWorkProjectCliCommand, bt as runWorkTaskCliCommand } from './cli-Bbndoc6k.js';
-import './access-service-DUkTWyZS.js';
+export { c as AccessHttpServeCliCommandOptions, d as ArchiveObservationsCliCommandOptions, e as AuditMemoryCliCommandOptions, B as BulkImportCliCommandOptions, C as CliApi, g as CliCommand, h as CliProgram, i as CompatCliCommandOptions, j as ConnectorsRunCliOutputOptions, k as ConversationIndexHealthCliOrchestrator, D as DashboardStartCliCommandOptions, l as DedupeCandidate, E as ExactDedupePlan, G as GraphHealthCliCommandOptions, M as MemoryActionAuditCliCommandOptions, m as MemoryActionAuditCliNamespaceSummary, n as MemoryActionAuditCliReport, o as MemoryGovernanceCliCommandOptions, q as MemoryGovernanceReportCliCommandOptions, s as MemoryGovernanceRestoreCliCommandOptions, t as MemoryReviewDispositionCliCommandOptions, u as MemoryTimelineCliCommandOptions, v as MigrateCliOrchestrator, w as MigrateCliReport, x as MigrateObservationsCliCommandOptions, P as PolicyDiffCliReport, y as PolicyDiffEntry, z as PolicyRollbackCliReport, F as PolicyStatusCliReport, H as PolicyTuningCliOrchestrator, R as RebuildMemoryLifecycleLedgerCliCommandOptions, I as RebuildMemoryProjectionCliCommandOptions, J as RebuildObservationsCliCommandOptions, K as RepairMemoryProjectionCliCommandOptions, L as ReplayCliCommandOptions, N as ReplayCliOrchestrator, O as RouteCliCommandOptions, S as SessionIntegrityCliCommandOptions, Q as SessionRepairCliCommandOptions, T as TailscaleStatusCliCommandOptions, U as TailscaleSyncCliCommandOptions, V as TierMigrateCliAdapter, W as TierMigrateCoordinatorCliAdapter, X as TierMigrateLegacyCliAdapter, Y as TierStatusCliAdapter, Z as TierStatusCoordinatorCliAdapter, _ as TierStatusLegacyCliAdapter, $ as TrainingExportCliCommandOptions, a0 as VerifyMemoryProjectionCliCommandOptions, a1 as WebDavServeCliCommandOptions, a2 as WorkProjectCliCommandOptions, a3 as WorkTaskCliCommandOptions, a4 as emitConnectorsRunCliResult, a5 as filterNormalMemorySearchResults, a6 as hasDestructivePurgeFailures, a7 as isNormalRetrievalVisibleMemory, a8 as listMemoryMarkdownFilePaths, a9 as parseDurationToMs, aa as parseStrictCliDate, ab as planAggressiveDuplicateDeletions, ac as planExactDuplicateDeletions, ad as registerCli, ae as resolveAccessPrincipalOverride, af as resolveMemoryDirForNamespace, ag as runAbstractionNodeStatusCliCommand, ah as runAccessHttpServeCliCommand, ai as runAccessHttpStatusCliCommand, aj as runAccessHttpStopCliCommand, ak as runAccessMcpServeCliCommand, al as runArchiveObservationsCliCommand, r as runAuditMemoryCliCommand, am as runBenchmarkBaselineReportCliCommand, an as runBenchmarkBaselineSnapshotCliCommand, ao as runBenchmarkCiGateCliCommand, ap as runBenchmarkImportCliCommand, aq as runBenchmarkStatusCliCommand, ar as runBenchmarkStoredBaselineCiGateCliCommand, as as runBenchmarkValidateCliCommand, b as runBulkImportCliCommand, at as runCausalTrajectoryStatusCliCommand, au as runCommitmentLifecycleCliCommand, av as runCommitmentRecordCliCommand, aw as runCommitmentSetStateCliCommand, ax as runCommitmentStatusCliCommand, ay as runCompatCliCommand, az as runCompoundingPromoteCliCommand, aA as runConversationIndexHealthCliCommand, aB as runConversationIndexInspectCliCommand, aC as runConversationIndexRebuildCliCommand, aD as runCueAnchorStatusCliCommand, aE as runDashboardStartCliCommand, aF as runDashboardStatusCliCommand, aG as runDashboardStopCliCommand, aH as runGraphHealthCliCommand, aI as runHarmonicSearchCliCommand, aJ as runMemoryActionAuditCliCommand, aK as runMemoryGovernanceCliCommand, aL as runMemoryGovernanceReportCliCommand, aM as runMemoryGovernanceRestoreCliCommand, aN as runMemoryReviewDispositionCliCommand, aO as runMemoryTimelineCliCommand, aP as runMigrateNormalizeFrontmatterCliCommand, aQ as runMigrateObservationsCliCommand, aR as runMigrateRechunkCliCommand, aS as runMigrateReextractCliCommand, aT as runMigrateRescoreImportanceCliCommand, aU as runObjectiveStateStatusCliCommand, aV as runPolicyDiffCliCommand, aW as runPolicyRollbackCliCommand, aX as runPolicyStatusCliCommand, aY as runRebuildMemoryLifecycleLedgerCliCommand, aZ as runRebuildMemoryProjectionCliCommand, a_ as runRebuildObservationsCliCommand, a$ as runRepairMemoryProjectionCliCommand, b0 as runReplayCliCommand, b1 as runResumeBundleBuildCliCommand, b2 as runResumeBundleRecordCliCommand, b3 as runResumeBundleStatusCliCommand, b4 as runRouteCliCommand, b5 as runSemanticRulePromoteCliCommand, b6 as runSemanticRuleVerifyCliCommand, b7 as runSessionCheckCliCommand, b8 as runSessionRepairCliCommand, b9 as runTailscaleStatusCliCommand, ba as runTailscaleSyncCliCommand, bb as runTierMigrateCliCommand, bc as runTierStatusCliCommand, bd as runTrainingExportCliCommand, be as runTrustZoneDemoSeedCliCommand, bf as runTrustZonePromoteCliCommand, bg as runTrustZoneStatusCliCommand, bh as runUtilityLearningCliCommand, bi as runUtilityLearningStatusCliCommand, bj as runUtilityTelemetryRecordCliCommand, bk as runUtilityTelemetryStatusCliCommand, bl as runVerifiedRecallSearchCliCommand, bm as runVerifyMemoryProjectionCliCommand, bn as runWebDavServeCliCommand, bo as runWebDavStopCliCommand, bp as runWorkProductRecallSearchCliCommand, bq as runWorkProductRecordCliCommand, br as runWorkProductStatusCliCommand, bs as runWorkProjectCliCommand, bt as runWorkTaskCliCommand } from './cli-BHDMJqJS.js';
+import './access-service-BZaC-RZw.js';
 import 'node:stream';
 import './resolve-auth-token.js';
 import './causal-trajectory.js';
 import './connectors-cli-2iaQ5tX2.js';
-import './pipeline-DK79FrgH.js';
+import './pipeline-CgO2Sd4O.js';
 import './policy-runtime.js';
 import './maintenance/memory-governance.js';
 import './maintenance/rebuild-memory-projection.js';
@@ -51,6 +51,7 @@ import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
 import './recall-navigation-config.js';
+import './recall-recognition-tier.js';
 import './active-context-config.js';
 import './local-llm-config.js';
 import './semantic-merge-config.js';
@@ -76,7 +77,7 @@ import './runtime/child-process.js';
 import './briefing.js';
 import './buffer.js';
 import './extraction-faithfulness.js';
-import './local-llm-DH4tWtck.js';
+import './local-llm-BXYC-mbU.js';
 import './model-registry.js';
 import './fallback-llm.js';
 import './fallback-llm-codex-subscription.js';
@@ -84,14 +85,14 @@ import './cli-fallback.js';
 import './resolve-provider-secret.js';
 import './transcript.js';
 import './summarizer.js';
-import './maintenance-n6yeTQhR.js';
-import './catalog-Bns9zpl3.js';
+import './maintenance-zJiLsKBY.js';
+import './catalog-DK2eHhax.js';
 import './namespaces/search.js';
 import './utility-runtime.js';
 import './tier-routing.js';
 import './lifecycle.js';
 import './orchestration/compression-guideline-coordinator.js';
-import './semantic-consolidation-BrAWKVcm.js';
+import './semantic-consolidation-DEzRyeyn.js';
 import './connectors/codex-materialize.js';
 import './logger.js';
 import './embedding-fallback.js';
@@ -103,23 +104,23 @@ import './harmonic-retrieval.js';
 import './trust-score-stage.js';
 import './trust-score.js';
 import './included-memories.js';
-import './dependency-propagation-delivery-B-LvcDaq.js';
+import './dependency-propagation-delivery-BMkR4gmY.js';
 import './boxes.js';
 import './namespaces/storage.js';
 import './threading.js';
-import './scope-profiles-BgPQx9iE.js';
+import './scope-profiles-Bg1rB-Dp.js';
 import './recall-xray.js';
 import './memory-provenance.js';
 import './user-model.js';
 import './recall-context-composition.js';
-import './generic-recall-paths-Bfc7zigS.js';
+import './generic-recall-paths-BCRtXU32.js';
 import './live-connectors-runner.js';
 import './framework-CNDn2164.js';
 import './relevance.js';
 import './negative.js';
 import './session-observer-state.js';
 import './semantic-BalR6EXU.js';
-import './service-CqHOTg87.js';
+import './service-DGEIDOeD.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';
@@ -140,7 +141,7 @@ import './types-B1VHaf2w.js';
 import './transfer/capsule-import.js';
 import './transfer/types.js';
 import './recall-navigation.js';
-import './access-namespace-preflight-CetF9ziA.js';
+import './access-namespace-preflight-C1q3XuAc.js';
 import './access-token-capabilities.js';
 import 'node:async_hooks';
 import './recall-explain-renderer.js';
@@ -148,7 +149,7 @@ import './access-citation.js';
 import './access-health-types.js';
 import './corpus-watermark.js';
 import './replica-divergence.js';
-import './tagging-CiAVA-ID.js';
+import './tagging-CPVwgadt.js';
 import './explicit-capture.js';
 import './graph-write-lock.js';
 import './access-wearables-meetings-surface.js';