@remnic/core 9.3.644 → 9.3.645

package/dist/{chunk-GYITUZFT.js → chunk-A4BTPHIN.js}

@@ -82,7 +82,42 @@ import {
 import { access, readdir, readFile, stat, writeFile, mkdir, unlink, appendFile, open } from "fs/promises";
 import { appendFileSync, createReadStream, mkdirSync, statSync } from "fs";
 import { createHash } from "crypto";
+import path2 from "path";
+
+// src/utils/category-dir.ts
 import path from "path";
+var CATEGORY_DIR_MAP = {
+  correction: "corrections",
+  question: "questions",
+  preference: "preferences",
+  decision: "decisions",
+  moment: "moments",
+  commitment: "commitments",
+  principle: "principles",
+  rule: "rules",
+  skill: "skills",
+  relationship: "relationships",
+  procedure: "procedures",
+  reasoning_trace: "reasoning-traces"
+};
+var ALL_CATEGORY_DIRS = [
+  "facts",
+  ...Object.values(CATEGORY_DIR_MAP)
+];
+var RECALL_NON_MEMORY_DIRS = /* @__PURE__ */ new Set(["questions"]);
+var RECALL_FALLBACK_DIRS = ALL_CATEGORY_DIRS.filter(
+  (dir) => !RECALL_NON_MEMORY_DIRS.has(dir)
+);
+var ALL_CATEGORY_KEYS = [
+  "fact",
+  ...Object.keys(CATEGORY_DIR_MAP)
+];
+function getCategoryDir(memoryDir, category) {
+  const dir = Object.hasOwn(CATEGORY_DIR_MAP, category) ? CATEGORY_DIR_MAP[category] : void 0;
+  return dir ? path.join(memoryDir, dir) : path.join(memoryDir, "facts");
+}
+
+// src/storage.ts
 var ARTIFACT_SEARCH_STOPWORDS = /* @__PURE__ */ new Set([
   "a",
   "an",
@@ -666,17 +701,17 @@ var KNOWN_ENTITY_FILENAME_PREFIXES = /* @__PURE__ */ new Set([
   "topic"
 ]);
 function inferEntityTypeFromFilename(pathRel) {
-  const basename = path.basename(pathRel, ".md").toLowerCase();
+  const basename = path2.basename(pathRel, ".md").toLowerCase();
   const separator = basename.indexOf("-");
   if (separator <= 0) return void 0;
   const candidate = basename.slice(0, separator);
   return KNOWN_ENTITY_FILENAME_PREFIXES.has(candidate) ? candidate : void 0;
 }
 function normalizeFrontmatterForPath(frontmatter, pathRel, content = "") {
-  const normalizedPath = pathRel.split(path.sep).join("/");
+  const normalizedPath = pathRel.split(path2.sep).join("/");
   let normalizedFrontmatter = frontmatter;
   if (normalizedPath === "entities" || normalizedPath.startsWith("entities/") || normalizedPath.includes("/entities/")) {
-    const basename = path.basename(pathRel, ".md");
+    const basename = path2.basename(pathRel, ".md");
     const inferredType = inferEntityTypeFromContent(content) || inferEntityTypeFromFilename(pathRel) || "entity";
     const existingTags = Array.isArray(frontmatter.tags) ? frontmatter.tags : [];
     normalizedFrontmatter = {
@@ -743,8 +778,8 @@ var ContentHashIndex = class _ContentHashIndex {
   secureStoreKeyProvider;
   secureStoreWriteKeyProvider;
   memoryDir;
-  constructor(stateDir, secureStoreKeyProvider = () => null, secureStoreWriteKeyProvider = secureStoreKeyProvider, memoryDir = path.dirname(stateDir)) {
-    this.filePath = path.join(stateDir, "fact-hashes.txt");
+  constructor(stateDir, secureStoreKeyProvider = () => null, secureStoreWriteKeyProvider = secureStoreKeyProvider, memoryDir = path2.dirname(stateDir)) {
+    this.filePath = path2.join(stateDir, "fact-hashes.txt");
     this.secureStoreKeyProvider = secureStoreKeyProvider;
     this.secureStoreWriteKeyProvider = secureStoreWriteKeyProvider;
     this.memoryDir = memoryDir;
@@ -791,7 +826,7 @@ var ContentHashIndex = class _ContentHashIndex {
   /** Persist index to disk if changed. */
   async save() {
     if (!this.dirty) return;
-    await mkdir(path.dirname(this.filePath), { recursive: true });
+    await mkdir(path2.dirname(this.filePath), { recursive: true });
     await writeMaybeEncryptedFile(
       this.filePath,
       [...this.hashes].join("\n") + "\n",
@@ -1858,7 +1893,7 @@ var StorageManager = class _StorageManager {
         void 0,
         this.baseDir
       );
-      const rel = path.relative(this.baseDir, filePath).split(path.sep).join("/");
+      const rel = path2.relative(this.baseDir, filePath).split(path2.sep).join("/");
       return `${rel}:${version.versionId}`;
     } catch (err) {
       log.warn(
@@ -1873,13 +1908,13 @@ var StorageManager = class _StorageManager {
   }
   identityFilePath(workspaceDir, namespace) {
     const rawNamespace = typeof namespace === "string" ? namespace.trim() : "";
-    if (!rawNamespace) return path.join(workspaceDir, "IDENTITY.md");
+    if (!rawNamespace) return path2.join(workspaceDir, "IDENTITY.md");
     const safeNamespace = rawNamespace.replace(/[^a-zA-Z0-9._-]/g, "-");
-    return path.join(workspaceDir, `IDENTITY.${safeNamespace}.md`);
+    return path2.join(workspaceDir, `IDENTITY.${safeNamespace}.md`);
   }
   versionFilePath(kind) {
     const fileName = kind === "memory-status" ? ".memory-status-version.log" : kind === "artifact-write" ? ".artifact-write-version.log" : ".cold-write-version.log";
-    return path.join(this.stateDir, fileName);
+    return path2.join(this.stateDir, fileName);
   }
   bumpSharedVersion(kind, fallbackMap) {
     const filePath = this.versionFilePath(kind);
@@ -1925,7 +1960,7 @@ var StorageManager = class _StorageManager {
   // memories.
   // -------------------------------------------------------------------------
   get wearablesDir() {
-    return path.join(this.baseDir, WEARABLES_DIR_NAME);
+    return path2.join(this.baseDir, WEARABLES_DIR_NAME);
   }
   /**
    * Resolve the on-disk path for a source/day transcript. Throws on
@@ -1943,7 +1978,7 @@ var StorageManager = class _StorageManager {
         `invalid wearable transcript date '${String(date)}' \u2014 expected YYYY-MM-DD`
       );
     }
-    return path.join(this.wearablesDir, sourceId, `${date}.md`);
+    return path2.join(this.wearablesDir, sourceId, `${date}.md`);
   }
   async writeWearableDayTranscript(sourceId, date, serialized) {
     const targetPath = this.wearableTranscriptPath(sourceId, date);
@@ -1981,7 +2016,7 @@ var StorageManager = class _StorageManager {
       if (!/^[a-z][a-z0-9-]{0,63}$/.test(source)) continue;
       let entries;
       try {
-        entries = await readdir(path.join(this.wearablesDir, source));
+        entries = await readdir(path2.join(this.wearablesDir, source));
       } catch (err) {
         if (err.code === "ENOENT") continue;
         throw err;
@@ -2064,25 +2099,25 @@ var StorageManager = class _StorageManager {
     });
   }
   get factsDir() {
-    return path.join(this.baseDir, "facts");
+    return path2.join(this.baseDir, "facts");
   }
   get correctionsDir() {
-    return path.join(this.baseDir, "corrections");
+    return path2.join(this.baseDir, "corrections");
   }
   get proceduresDir() {
-    return path.join(this.baseDir, "procedures");
+    return path2.join(this.baseDir, "procedures");
   }
   get reasoningTracesDir() {
-    return path.join(this.baseDir, "reasoning-traces");
+    return path2.join(this.baseDir, "reasoning-traces");
   }
   get entitiesDir() {
-    return path.join(this.baseDir, "entities");
+    return path2.join(this.baseDir, "entities");
   }
   resolveEntityFilePath(name) {
     if (typeof name !== "string") return null;
-    const filePath = path.resolve(this.entitiesDir, `${name}.md`);
-    const relative = path.relative(this.entitiesDir, filePath);
-    if (relative === "" || relative.startsWith("..") || path.isAbsolute(relative)) {
+    const filePath = path2.resolve(this.entitiesDir, `${name}.md`);
+    const relative = path2.relative(this.entitiesDir, filePath);
+    if (relative === "" || relative.startsWith("..") || path2.isAbsolute(relative)) {
       return null;
     }
     return filePath;
@@ -2094,10 +2129,10 @@ var StorageManager = class _StorageManager {
     return writeMaybeEncryptedFile(filePath, content, this.resolveWriteKey(), {}, this.baseDir);
   }
   assertManagedStoragePath(filePath, method) {
-    const resolved = path.resolve(filePath);
-    const base = path.resolve(this.baseDir);
-    const rel = path.relative(base, resolved);
-    if (rel === "" || rel === ".." || rel.startsWith(`..${path.sep}`) || path.isAbsolute(rel)) {
+    const resolved = path2.resolve(filePath);
+    const base = path2.resolve(this.baseDir);
+    const rel = path2.relative(base, resolved);
+    if (rel === "" || rel === ".." || rel.startsWith(`..${path2.sep}`) || path2.isAbsolute(rel)) {
       throw new Error(`${method}: file path escapes memory dir`);
     }
     return resolved;
@@ -2109,7 +2144,7 @@ var StorageManager = class _StorageManager {
   async digestOfflineSyncFile(filePath) {
     const target = this.assertManagedStoragePath(filePath, "storage.digestOfflineSyncFile");
     const st = await stat(target);
-    const relPath = path.relative(this.baseDir, target).split(path.sep).join("/");
+    const relPath = path2.relative(this.baseDir, target).split(path2.sep).join("/");
     const cache = await this.loadOfflineSyncDigestCache();
     const cached = cache.get(relPath);
     if (cached && cached.statBytes === st.size && cached.mtimeMs === st.mtimeMs && cached.ctimeMs === st.ctimeMs && !cached.encrypted) {
@@ -2170,7 +2205,7 @@ var StorageManager = class _StorageManager {
         const bytes = typeof record.bytes === "number" ? record.bytes : NaN;
         const sha256 = typeof record.sha256 === "string" ? record.sha256 : "";
         const encrypted = record.encrypted === true;
-        if (cachePath.length === 0 || cachePath === ".." || cachePath.startsWith("../") || path.isAbsolute(cachePath) || !Number.isFinite(statBytes) || !Number.isFinite(mtimeMs) || !Number.isFinite(ctimeMs) || !Number.isFinite(bytes) || !/^[a-f0-9]{64}$/i.test(sha256)) {
+        if (cachePath.length === 0 || cachePath === ".." || cachePath.startsWith("../") || path2.isAbsolute(cachePath) || !Number.isFinite(statBytes) || !Number.isFinite(mtimeMs) || !Number.isFinite(ctimeMs) || !Number.isFinite(bytes) || !/^[a-f0-9]{64}$/i.test(sha256)) {
           continue;
         }
         cache.set(cachePath, { statBytes, mtimeMs, ctimeMs, encrypted, sha256, bytes });
@@ -2212,7 +2247,7 @@ var StorageManager = class _StorageManager {
       const cache = this.offlineSyncDigestCache;
       if (!cache) return;
       const entries = [...cache.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([entryPath, entry]) => ({ path: entryPath, ...entry }));
-      await mkdir(path.dirname(this.offlineSyncDigestCachePath), { recursive: true });
+      await mkdir(path2.dirname(this.offlineSyncDigestCachePath), { recursive: true });
       await writeFile(
         this.offlineSyncDigestCachePath,
         `${JSON.stringify({ version: 1, entries })}
@@ -2266,10 +2301,10 @@ var StorageManager = class _StorageManager {
       if (isErrnoCode(error, "ENOENT")) return;
       throw error;
     });
-    if (filePath.includes(`${path.sep}cold${path.sep}`)) {
+    if (filePath.includes(`${path2.sep}cold${path2.sep}`)) {
       this.invalidateColdMemoriesCache();
     }
-    if (filePath.includes(`${path.sep}artifacts${path.sep}`)) {
+    if (filePath.includes(`${path2.sep}artifacts${path2.sep}`)) {
       this.bumpArtifactWriteVersion();
     }
     this.bumpMemoryStatusVersion();
@@ -2297,7 +2332,7 @@ var StorageManager = class _StorageManager {
   }
   async appendStorageSecureFileUnlocked(filePath, content) {
     const writeKey = this.resolveWriteKey();
-    await mkdir(path.dirname(filePath), { recursive: true });
+    await mkdir(path2.dirname(filePath), { recursive: true });
     if (writeKey === null) {
       try {
         if (isEncryptedFile(await readFile(filePath))) {
@@ -2320,16 +2355,16 @@ var StorageManager = class _StorageManager {
     await writeMaybeEncryptedFile(filePath, `${existing}${content}`, writeKey, {}, this.baseDir);
   }
   get stateDir() {
-    return path.join(this.baseDir, "state");
+    return path2.join(this.baseDir, "state");
   }
   get offlineSyncDigestCachePath() {
-    return path.join(this.baseDir, ".offline-sync", "digest-cache.v1.json");
+    return path2.join(this.baseDir, ".offline-sync", "digest-cache.v1.json");
   }
   get entitySynthesisQueuePath() {
-    return path.join(this.stateDir, "entity-synthesis-queue.json");
+    return path2.join(this.stateDir, "entity-synthesis-queue.json");
   }
   get factHashIndexReadyPath() {
-    return path.join(this.stateDir, "fact-hashes.ready");
+    return path2.join(this.stateDir, "fact-hashes.ready");
   }
   async getFactHashIndex() {
     if (this.factHashIndex) {
@@ -2396,7 +2431,7 @@ var StorageManager = class _StorageManager {
         );
       }
       await factHashIndex.save();
-      await mkdir(path.dirname(this.factHashIndexReadyPath), { recursive: true });
+      await mkdir(path2.dirname(this.factHashIndexReadyPath), { recursive: true });
       await writeFile(this.factHashIndexReadyPath, "v1\n", "utf-8");
       this.factHashIndexAuthoritative = true;
     })().finally(() => {
@@ -2405,55 +2440,55 @@ var StorageManager = class _StorageManager {
     await this.factHashIndexAuthoritativePromise;
   }
   get questionsDir() {
-    return path.join(this.baseDir, "questions");
+    return path2.join(this.baseDir, "questions");
   }
   get artifactsDir() {
-    return path.join(this.baseDir, "artifacts");
+    return path2.join(this.baseDir, "artifacts");
   }
   get identityDir() {
-    return path.join(this.baseDir, "identity");
+    return path2.join(this.baseDir, "identity");
   }
   get identityAnchorPath() {
-    return path.join(this.identityDir, "identity-anchor.md");
+    return path2.join(this.identityDir, "identity-anchor.md");
   }
   get identityIncidentsDir() {
-    return path.join(this.identityDir, "incidents");
+    return path2.join(this.identityDir, "incidents");
   }
   get identityAuditsWeeklyDir() {
-    return path.join(this.identityDir, "audits", "weekly");
+    return path2.join(this.identityDir, "audits", "weekly");
   }
   get identityAuditsMonthlyDir() {
-    return path.join(this.identityDir, "audits", "monthly");
+    return path2.join(this.identityDir, "audits", "monthly");
   }
   get identityImprovementLoopsPath() {
-    return path.join(this.identityDir, "improvement-loops.md");
+    return path2.join(this.identityDir, "improvement-loops.md");
   }
   get identityReflectionsPath() {
-    return path.join(this.identityDir, "reflections.md");
+    return path2.join(this.identityDir, "reflections.md");
   }
   get profilePath() {
-    return path.join(this.baseDir, "profile.md");
+    return path2.join(this.baseDir, "profile.md");
   }
   get memoryActionsPath() {
-    return path.join(this.stateDir, "memory-actions.jsonl");
+    return path2.join(this.stateDir, "memory-actions.jsonl");
   }
   get memoryLifecycleLedgerPath() {
-    return path.join(this.stateDir, "memory-lifecycle-ledger.jsonl");
+    return path2.join(this.stateDir, "memory-lifecycle-ledger.jsonl");
   }
   get compressionGuidelinesPath() {
-    return path.join(this.stateDir, "compression-guidelines.md");
+    return path2.join(this.stateDir, "compression-guidelines.md");
   }
   get compressionGuidelineDraftPath() {
-    return path.join(this.stateDir, "compression-guidelines.draft.md");
+    return path2.join(this.stateDir, "compression-guidelines.draft.md");
   }
   get compressionGuidelineStatePath() {
-    return path.join(this.stateDir, "compression-guideline-state.json");
+    return path2.join(this.stateDir, "compression-guideline-state.json");
   }
   get compressionGuidelineDraftStatePath() {
-    return path.join(this.stateDir, "compression-guideline-draft-state.json");
+    return path2.join(this.stateDir, "compression-guideline-draft-state.json");
   }
   get behaviorSignalsPath() {
-    return path.join(this.stateDir, "behavior-signals.jsonl");
+    return path2.join(this.stateDir, "behavior-signals.jsonl");
   }
   /**
    * Buffer surprise telemetry ledger (issue #563 PR 3).
@@ -2466,7 +2501,7 @@ var StorageManager = class _StorageManager {
    * governance sweeps can treat it uniformly.
    */
   get bufferSurpriseLedgerPath() {
-    return path.join(this.stateDir, "buffer-surprise-ledger.jsonl");
+    return path2.join(this.stateDir, "buffer-surprise-ledger.jsonl");
   }
   /**
    * Load user-defined entity aliases from config/aliases.json in the memory store.
@@ -2474,7 +2509,7 @@ var StorageManager = class _StorageManager {
    * Call this once at startup (e.g. from orchestrator.initialize()).
    */
   async loadAliases() {
-    const aliasPath = path.join(this.baseDir, "config", "aliases.json");
+    const aliasPath = path2.join(this.baseDir, "config", "aliases.json");
     try {
       const raw = await readFile(aliasPath, "utf-8");
       const parsed = JSON.parse(raw);
@@ -2488,9 +2523,9 @@ var StorageManager = class _StorageManager {
   }
   async ensureDirectories() {
     const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    await mkdir(path.join(this.factsDir, today), { recursive: true });
-    await mkdir(path.join(this.proceduresDir, today), { recursive: true });
-    await mkdir(path.join(this.reasoningTracesDir, today), { recursive: true });
+    await mkdir(path2.join(this.factsDir, today), { recursive: true });
+    await mkdir(path2.join(this.proceduresDir, today), { recursive: true });
+    await mkdir(path2.join(this.reasoningTracesDir, today), { recursive: true });
     await mkdir(this.correctionsDir, { recursive: true });
     await mkdir(this.entitiesDir, { recursive: true });
     await mkdir(this.stateDir, { recursive: true });
@@ -2500,7 +2535,7 @@ var StorageManager = class _StorageManager {
     await mkdir(this.identityIncidentsDir, { recursive: true });
     await mkdir(this.identityAuditsWeeklyDir, { recursive: true });
     await mkdir(this.identityAuditsMonthlyDir, { recursive: true });
-    await mkdir(path.join(this.baseDir, "config"), { recursive: true });
+    await mkdir(path2.join(this.baseDir, "config"), { recursive: true });
   }
   async writeMemory(category, content, options = {}) {
     await this.ensureDirectories();
@@ -2570,15 +2605,15 @@ ${sanitized.text}
 `;
     let filePath;
     if (category === "correction") {
-      filePath = path.join(this.correctionsDir, `${id}.md`);
+      filePath = path2.join(this.correctionsDir, `${id}.md`);
     } else if (category === "procedure") {
-      await mkdir(path.join(this.proceduresDir, today), { recursive: true });
-      filePath = path.join(this.proceduresDir, today, `${id}.md`);
+      await mkdir(path2.join(this.proceduresDir, today), { recursive: true });
+      filePath = path2.join(this.proceduresDir, today, `${id}.md`);
     } else if (category === "reasoning_trace") {
-      await mkdir(path.join(this.reasoningTracesDir, today), { recursive: true });
-      filePath = path.join(this.reasoningTracesDir, today, `${id}.md`);
+      await mkdir(path2.join(this.reasoningTracesDir, today), { recursive: true });
+      filePath = path2.join(this.reasoningTracesDir, today, `${id}.md`);
     } else {
-      filePath = path.join(this.factsDir, today, `${id}.md`);
+      filePath = path2.join(this.factsDir, today, `${id}.md`);
     }
     await this.snapshotBeforeWrite(filePath, "write");
     await writeMaybeEncryptedFile(filePath, fileContent, this.resolveWriteKey(), {}, this.baseDir);
@@ -2693,7 +2728,7 @@ ${sanitized.text}
     await this.ensureDirectories();
     const now = /* @__PURE__ */ new Date();
     const day = now.toISOString().slice(0, 10);
-    const dir = path.join(this.artifactsDir, day);
+    const dir = path2.join(this.artifactsDir, day);
     await mkdir(dir, { recursive: true });
     const id = `artifact-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
     const fm = {
@@ -2717,7 +2752,7 @@ ${sanitized.text}
       log.warn(`artifact content rejected for ${id}; violations=${sanitized.violations.join(", ")}`);
       return "";
     }
-    const filePath = path.join(dir, `${id}.md`);
+    const filePath = path2.join(dir, `${id}.md`);
     await writeMaybeEncryptedFile(filePath, `${serializeFrontmatter(fm)}
 
 ${sanitized.text}
@@ -2745,7 +2780,7 @@ ${sanitized.text}
         try {
           const entries = await readdir(dir, { withFileTypes: true });
           for (const entry of entries) {
-            const fullPath = path.join(dir, entry.name);
+            const fullPath = path2.join(dir, entry.name);
             if (entry.isDirectory()) {
               await readDir(fullPath);
               continue;
@@ -2811,7 +2846,7 @@ ${sanitized.text}
       log.debug(`fuzzy match: "${normalized}" \u2192 existing "${match}"`);
       normalized = match;
     }
-    const filePath = path.join(this.entitiesDir, `${normalized}.md`);
+    const filePath = path2.join(this.entitiesDir, `${normalized}.md`);
     let entity = {
       name,
       type,
@@ -3046,7 +3081,7 @@ ${sanitized.text}
    * per-process in-memory cache safe across process boundaries.
    */
   invalidateColdMemoriesCache() {
-    const coldRoot = path.join(this.baseDir, "cold");
+    const coldRoot = path2.join(this.baseDir, "cold");
     _StorageManager.coldMemoriesCache.delete(coldRoot);
     this.bumpColdWriteVersion();
   }
@@ -3074,7 +3109,7 @@ ${sanitized.text}
         const entries = await readdir(dir, { withFileTypes: true });
         const subdirs = [];
         for (const entry of entries) {
-          const fullPath = path.join(dir, entry.name);
+          const fullPath = path2.join(dir, entry.name);
           if (entry.isDirectory()) {
             subdirs.push(fullPath);
           } else if (entry.name.endsWith(".md")) {
@@ -3087,10 +3122,9 @@ ${sanitized.text}
       } catch {
       }
     };
-    await collectPaths(this.factsDir);
-    await collectPaths(this.proceduresDir);
-    await collectPaths(this.reasoningTracesDir);
-    await collectPaths(this.correctionsDir);
+    for (const dir of RECALL_FALLBACK_DIRS) {
+      await collectPaths(path2.join(this.baseDir, dir));
+    }
     return filePaths;
   }
   async readParsedMemoriesFromPaths(filePaths, batchSize) {
@@ -3158,7 +3192,7 @@ ${sanitized.text}
     const correctionPaths = [];
     const factPaths = [];
     for (const filePath of filePaths) {
-      if (filePath === this.correctionsDir || filePath.startsWith(`${this.correctionsDir}${path.sep}`)) {
+      if (filePath === this.correctionsDir || filePath.startsWith(`${this.correctionsDir}${path2.sep}`)) {
         correctionPaths.push(filePath);
       } else {
         factPaths.push(filePath);
@@ -3278,7 +3312,7 @@ ${sanitized.text}
         const entries = await readdir(dir, { withFileTypes: true });
         const subdirs = [];
         for (const entry of entries) {
-          const fullPath = path.join(dir, entry.name);
+          const fullPath = path2.join(dir, entry.name);
           if (entry.isDirectory()) {
             subdirs.push(fullPath);
           } else if (entry.name.endsWith(".md")) {
@@ -3307,7 +3341,7 @@ ${sanitized.text}
       try {
         const entries = await readdir(dir, { withFileTypes: true });
         for (const entry of entries) {
-          const fullPath = path.join(dir, entry.name);
+          const fullPath = path2.join(dir, entry.name);
           if (entry.isDirectory()) {
             await readDir(fullPath);
           } else if (entry.name.endsWith(".md")) {
@@ -3352,11 +3386,11 @@ ${sanitized.text}
           content: parsed.content
         };
       }
-      const normalizedPath = filePath.split(path.sep).join("/");
+      const normalizedPath = filePath.split(path2.sep).join("/");
       if (normalizedPath.includes("/entities/") && filePath.endsWith(".md")) {
         const entity = parseEntityFile(raw, this.entitySchemas);
         if (!entity.name) return null;
-        const nameWithoutExt = path.basename(filePath, ".md");
+        const nameWithoutExt = path2.basename(filePath, ".md");
         const fileMtime = entity.updated || await stat(filePath).then((s) => s.mtime.toISOString()).catch(() => (/* @__PURE__ */ new Date(0)).toISOString());
         return {
           path: filePath,
@@ -3380,7 +3414,7 @@ ${sanitized.text}
     }
   }
   resolveTierRootDir(tier) {
-    return tier === "cold" ? path.join(this.baseDir, "cold") : this.baseDir;
+    return tier === "cold" ? path2.join(this.baseDir, "cold") : this.baseDir;
   }
   resolveMemoryDateDir(memory) {
     const preferred = memory.frontmatter.created || memory.frontmatter.updated;
@@ -3395,18 +3429,18 @@ ${sanitized.text}
   buildTierMemoryPath(memory, tier) {
     const root = this.resolveTierRootDir(tier);
     if (this.isArtifactMemory(memory)) {
-      return path.join(root, "artifacts", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
+      return path2.join(root, "artifacts", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
     }
     if (memory.frontmatter.category === "correction") {
-      return path.join(root, "corrections", `${memory.frontmatter.id}.md`);
+      return path2.join(root, "corrections", `${memory.frontmatter.id}.md`);
     }
     if (memory.frontmatter.category === "procedure") {
-      return path.join(root, "procedures", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
+      return path2.join(root, "procedures", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
     }
     if (memory.frontmatter.category === "reasoning_trace") {
-      return path.join(root, "reasoning-traces", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
+      return path2.join(root, "reasoning-traces", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
     }
-    return path.join(root, "facts", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
+    return path2.join(root, "facts", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
   }
   async writeMemoryFileAtomic(targetPath, memory) {
     const fileContent = `${serializeFrontmatter(memory.frontmatter)}
@@ -3418,8 +3452,8 @@ ${memory.content}
   }
   async moveMemoryToPath(memory, targetPath) {
     await this.writeMemoryFileAtomic(targetPath, memory);
-    const sourcePath = path.resolve(memory.path);
-    const destPath = path.resolve(targetPath);
+    const sourcePath = path2.resolve(memory.path);
+    const destPath = path2.resolve(targetPath);
     if (sourcePath !== destPath) {
       try {
         await unlink(memory.path);
@@ -3434,8 +3468,8 @@ ${memory.content}
   }
   async migrateMemoryToTier(memory, targetTier) {
     const targetPath = this.buildTierMemoryPath(memory, targetTier);
-    const sourcePath = path.resolve(memory.path);
-    const destPath = path.resolve(targetPath);
+    const sourcePath = path2.resolve(memory.path);
+    const destPath = path2.resolve(targetPath);
     if (sourcePath === destPath) {
       return { changed: false, targetPath };
     }
@@ -3461,7 +3495,7 @@ ${memory.content}
     return { changed: true, targetPath };
   }
   get archiveDir() {
-    return path.join(this.baseDir, "archive");
+    return path2.join(this.baseDir, "archive");
   }
   /**
    * Archive a memory by moving it from facts/ to archive/YYYY-MM-DD/.
@@ -3472,7 +3506,7 @@ ${memory.content}
     try {
       const now = lifecycle?.at ?? /* @__PURE__ */ new Date();
       const today = now.toISOString().slice(0, 10);
-      const destDir = path.join(this.archiveDir, today);
+      const destDir = path2.join(this.archiveDir, today);
       await mkdir(destDir, { recursive: true });
       const updatedFm = {
         ...memory.frontmatter,
@@ -3484,7 +3518,7 @@ ${memory.content}
 
 ${memory.content}
 `;
-      const destPath = path.join(destDir, path.basename(memory.path));
+      const destPath = path2.join(destDir, path2.basename(memory.path));
       await writeMaybeEncryptedFile(destPath, fileContent, this.resolveWriteKey(), {}, this.baseDir);
       await unlink(memory.path);
       this.invalidateAllMemoriesCache();
@@ -3646,7 +3680,7 @@ ${memory.content}
 `;
     await writeMaybeEncryptedFile(memory.path, fileContent, this.resolveWriteKey(), {}, this.baseDir);
     this.invalidateAllMemoriesCache();
-    if (memory.path.includes(`${path.sep}cold${path.sep}`)) {
+    if (memory.path.includes(`${path2.sep}cold${path2.sep}`)) {
       this.invalidateColdMemoriesCache();
     }
     try {
@@ -3718,7 +3752,7 @@ ${memory.content}
     return deleted;
   }
   async loadBuffer() {
-    const bufferPath = path.join(this.stateDir, "buffer.json");
+    const bufferPath = path2.join(this.stateDir, "buffer.json");
     try {
       const raw = await this.readStorageSecureFile(bufferPath);
       return JSON.parse(raw);
@@ -3730,11 +3764,11 @@ ${memory.content}
   }
   async saveBuffer(state) {
     await this.ensureDirectories();
-    const bufferPath = path.join(this.stateDir, "buffer.json");
+    const bufferPath = path2.join(this.stateDir, "buffer.json");
     await this.writeStorageSecureFile(bufferPath, JSON.stringify(state, null, 2));
   }
   async loadMeta() {
-    const metaPath = path.join(this.stateDir, "meta.json");
+    const metaPath = path2.join(this.stateDir, "meta.json");
     try {
       const raw = await this.readStorageSecureFile(metaPath);
       const parsed = JSON.parse(raw);
@@ -3768,7 +3802,7 @@ ${memory.content}
   }
   async saveMeta(state) {
     await this.ensureDirectories();
-    const metaPath = path.join(this.stateDir, "meta.json");
+    const metaPath = path2.join(this.stateDir, "meta.json");
     await this.writeStorageSecureFile(metaPath, JSON.stringify(state, null, 2));
   }
   async appendMemoryActionEvents(events) {
@@ -3938,7 +3972,7 @@ ${memory.content}
   async appendReextractJobs(events) {
     if (events.length === 0) return 0;
     await this.ensureDirectories();
-    const filePath = path.join(this.stateDir, "reextract-jobs.jsonl");
+    const filePath = path2.join(this.stateDir, "reextract-jobs.jsonl");
     const lines = events.map((event) => JSON.stringify(event)).join("\n") + "\n";
     try {
       await this.appendStorageSecureFile(filePath, lines);
@@ -3951,7 +3985,7 @@ ${memory.content}
   }
   async readReextractJobs(limit = 200) {
     const safeLimit = Number.isFinite(limit) ? Math.max(1, Math.min(1e3, Math.floor(limit))) : 200;
-    const filePath = path.join(this.stateDir, "reextract-jobs.jsonl");
+    const filePath = path2.join(this.stateDir, "reextract-jobs.jsonl");
     try {
       const raw = await this.readStorageSecureFile(filePath);
       const lines = raw.split("\n").filter((line) => line.trim().length > 0);
@@ -4205,7 +4239,7 @@ ${memory.content}
     const date = nowIso.slice(0, 10);
     const id = this.generateId("incident");
     const incident = createContinuityIncidentRecord(id, input, nowIso);
-    const filePath = path.join(this.identityIncidentsDir, `${date}-${id}.md`);
+    const filePath = path2.join(this.identityIncidentsDir, `${date}-${id}.md`);
     await this.writeStorageSecureFile(filePath, serializeContinuityIncident(incident));
     return { ...incident, filePath };
   }
@@ -4218,7 +4252,7 @@ ${memory.content}
       const incidents = [];
       for (const file of candidates) {
         if (incidents.length >= cappedLimit) break;
-        const filePath = path.join(this.identityIncidentsDir, file);
+        const filePath = path2.join(this.identityIncidentsDir, file);
         try {
           const raw = await this.readStorageSecureFile(filePath);
           const parsed = parseContinuityIncident(raw);
@@ -4249,7 +4283,7 @@ ${memory.content}
     await this.ensureDirectories();
     const safeKey = this.sanitizeIdentityAuditKey(key);
     const dir = period === "weekly" ? this.identityAuditsWeeklyDir : this.identityAuditsMonthlyDir;
-    const filePath = path.join(dir, `${safeKey}.md`);
+    const filePath = path2.join(dir, `${safeKey}.md`);
     await this.writeStorageSecureFile(filePath, content);
     return filePath;
   }
@@ -4257,7 +4291,7 @@ ${memory.content}
     try {
       const safeKey = this.sanitizeIdentityAuditKey(key);
       const dir = period === "weekly" ? this.identityAuditsWeeklyDir : this.identityAuditsMonthlyDir;
-      return await this.readStorageSecureFile(path.join(dir, `${safeKey}.md`));
+      return await this.readStorageSecureFile(path2.join(dir, `${safeKey}.md`));
     } catch (err) {
       if (err instanceof Error && err.message === "Invalid identity audit key") return null;
       if (!isErrnoCode(err, "ENOENT")) throw err;
@@ -4321,12 +4355,12 @@ ${memory.content}
     const fileNames = await this.readContinuityIncidentFileNames();
     const directMatch = fileNames.find((name) => name.endsWith(`-${id}.md`));
     if (directMatch) {
-      const directPath = path.join(this.identityIncidentsDir, directMatch);
+      const directPath = path2.join(this.identityIncidentsDir, directMatch);
       const parsed = await this.readContinuityIncidentFile(directPath);
       if (parsed?.id === id) return directPath;
     }
     for (const fileName of fileNames) {
-      const filePath = path.join(this.identityIncidentsDir, fileName);
+      const filePath = path2.join(this.identityIncidentsDir, fileName);
       const parsed = await this.readContinuityIncidentFile(filePath);
       if (parsed?.id === id) return filePath;
     }
@@ -4356,7 +4390,7 @@ ${question}
 
 **Context:** ${context}
 `;
-    const filePath = path.join(this.questionsDir, `${id}.md`);
+    const filePath = path2.join(this.questionsDir, `${id}.md`);
     await writeFile(filePath, content, "utf-8");
     log.debug(`wrote question ${id} to ${filePath}`);
     this.invalidateQuestionsCache();
@@ -4380,7 +4414,7 @@ ${question}
       const questions = [];
       for (const file of files) {
         if (!file.endsWith(".md")) continue;
-        const filePath = path.join(this.questionsDir, file);
+        const filePath = path2.join(this.questionsDir, file);
         const raw = await readMaybeEncryptedFile(filePath, this._secureStoreKey, this.baseDir);
         const parsed = this.parseQuestionFile(raw, filePath);
         if (parsed) {
@@ -4403,7 +4437,7 @@ ${question}
     if (!match) return null;
     const frontmatterStr = match[1];
     const body = match[2].trim();
-    const id = this.extractFrontmatterValue(frontmatterStr, "id") ?? path.basename(filePath, ".md");
+    const id = this.extractFrontmatterValue(frontmatterStr, "id") ?? path2.basename(filePath, ".md");
     const created = this.extractFrontmatterValue(frontmatterStr, "created") ?? "";
     const priority = parseFloat(
       this.extractFrontmatterValue(frontmatterStr, "priority") ?? "0.5"
@@ -4465,11 +4499,11 @@ ${question}
     } catch {
     }
     const hygiene = opts?.hygiene;
-    const rotateEnabled = hygiene?.enabled === true && hygiene.rotateEnabled === true && Array.isArray(hygiene.rotatePaths) && hygiene.rotatePaths.includes(path.basename(identityPath));
+    const rotateEnabled = hygiene?.enabled === true && hygiene.rotateEnabled === true && Array.isArray(hygiene.rotatePaths) && hygiene.rotatePaths.includes(path2.basename(identityPath));
     if (rotateEnabled) {
       const maxBytes = hygiene.rotateMaxBytes;
       if (existing.length > maxBytes) {
-        const archiveDir = path.join(workspaceDir, hygiene.archiveDir);
+        const archiveDir = path2.join(workspaceDir, hygiene.archiveDir);
         const { newContent } = await rotateMarkdownFileToArchive({
           filePath: identityPath,
           archiveDir,
@@ -4563,7 +4597,7 @@ ${reflection}
    * Deduplicates by target+label.
    */
   async addEntityRelationship(name, rel) {
-    const filePath = path.join(this.entitiesDir, `${name}.md`);
+    const filePath = path2.join(this.entitiesDir, `${name}.md`);
     let entity;
     try {
       const content = await this.readStorageSecureFile(filePath);
@@ -4588,7 +4622,7 @@ ${reflection}
    * Prepends to the beginning, prunes oldest entries beyond maxEntries.
    */
   async addEntityActivity(name, entry, maxEntries) {
-    const filePath = path.join(this.entitiesDir, `${name}.md`);
+    const filePath = path2.join(this.entitiesDir, `${name}.md`);
     let entity;
     try {
       const content = await this.readStorageSecureFile(filePath);
@@ -4611,7 +4645,7 @@ ${reflection}
    * Add an alias to an entity file. Deduplicates.
    */
   async addEntityAlias(name, alias) {
-    const filePath = path.join(this.entitiesDir, `${name}.md`);
+    const filePath = path2.join(this.entitiesDir, `${name}.md`);
     let entity;
     try {
       const content = await this.readStorageSecureFile(filePath);
@@ -4632,7 +4666,7 @@ ${reflection}
    * Set or rewrite the synthesis layer of an entity file.
    */
   async updateEntitySynthesis(name, synthesis, options = {}) {
-    const filePath = path.join(this.entitiesDir, `${name}.md`);
+    const filePath = path2.join(this.entitiesDir, `${name}.md`);
     let entity;
     try {
       const content = await this.readStorageSecureFile(filePath);
@@ -4670,7 +4704,7 @@ ${reflection}
     const updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     let synthesisTimelineCount;
     try {
-      const filePath = path.join(this.entitiesDir, `${name}.md`);
+      const filePath = path2.join(this.entitiesDir, `${name}.md`);
       const content = await this.readStorageSecureFile(filePath);
       synthesisTimelineCount = parseEntityFile(content, this.entitySchemas).timeline.length;
     } catch (err) {
@@ -4753,7 +4787,7 @@ ${reflection}
       if (!raw) continue;
       const serialized = serializeEntityFile(parseEntityFile(raw, this.entitySchemas), this.entitySchemas);
       if (raw.trimEnd() === serialized.trimEnd()) continue;
-      await this.writeStorageSecureFile(path.join(this.entitiesDir, `${entityName}.md`), serialized);
+      await this.writeStorageSecureFile(path2.join(this.entitiesDir, `${entityName}.md`), serialized);
       migrated += 1;
     }
     if (migrated > 0) {
@@ -4789,7 +4823,7 @@ ${reflection}
         const results = await Promise.all(
           batch.map(async (entry) => {
             try {
-              return await this.readStorageSecureFile(path.join(this.entitiesDir, entry));
+              return await this.readStorageSecureFile(path2.join(this.entitiesDir, entry));
             } catch (err) {
               if (err instanceof SecureStoreLockedError) throw err;
               if (!isErrnoCode(err, "ENOENT")) throw err;
@@ -4935,7 +4969,7 @@ ${rows.join("\n")}
           extraSections: []
         };
         for (const file of files) {
-          const filePath = path.join(this.entitiesDir, file);
+          const filePath = path2.join(this.entitiesDir, file);
           try {
             const content = await this.readStorageSecureFile(filePath);
             const parsed = parseEntityFile(content, this.entitySchemas);
@@ -5066,10 +5100,10 @@ ${rows.join("\n")}
         }
         mergedEntity.created = mergedEntity.created || mergedEntity.updated || (/* @__PURE__ */ new Date()).toISOString();
         mergedEntity.updated = mergedEntity.updated || (/* @__PURE__ */ new Date()).toISOString();
-        const canonicalPath = path.join(this.entitiesDir, `${canonical}.md`);
+        const canonicalPath = path2.join(this.entitiesDir, `${canonical}.md`);
         await this.writeStorageSecureFile(canonicalPath, serializeEntityFile(mergedEntity, this.entitySchemas));
         for (const file of files) {
-          const filePath = path.join(this.entitiesDir, file);
+          const filePath = path2.join(this.entitiesDir, file);
           if (filePath !== canonicalPath) {
             try {
               await unlink(filePath);
@@ -5168,7 +5202,7 @@ ${memory.content}
     const filePaths = await this.collectActiveMemoryPaths();
     const foundIds = /* @__PURE__ */ new Set();
     for (const filePath of filePaths) {
-      const basename = path.basename(filePath, ".md");
+      const basename = path2.basename(filePath, ".md");
       if (wantedIds.has(basename)) {
         foundIds.add(basename);
         if (foundIds.size === wantedIds.size) break;
@@ -5268,15 +5302,15 @@ ${sanitized.text}
 `;
     let filePath;
     if (category === "correction") {
-      filePath = path.join(this.correctionsDir, `${id}.md`);
+      filePath = path2.join(this.correctionsDir, `${id}.md`);
     } else if (category === "procedure") {
-      await mkdir(path.join(this.proceduresDir, today), { recursive: true });
-      filePath = path.join(this.proceduresDir, today, `${id}.md`);
+      await mkdir(path2.join(this.proceduresDir, today), { recursive: true });
+      filePath = path2.join(this.proceduresDir, today, `${id}.md`);
     } else if (category === "reasoning_trace") {
-      await mkdir(path.join(this.reasoningTracesDir, today), { recursive: true });
-      filePath = path.join(this.reasoningTracesDir, today, `${id}.md`);
+      await mkdir(path2.join(this.reasoningTracesDir, today), { recursive: true });
+      filePath = path2.join(this.reasoningTracesDir, today, `${id}.md`);
     } else {
-      filePath = path.join(this.factsDir, today, `${id}.md`);
+      filePath = path2.join(this.factsDir, today, `${id}.md`);
     }
     await this.writeStorageSecureFile(filePath, fileContent);
     log.debug(`wrote chunk ${id} (${chunkIndex + 1}/${chunkTotal}) to ${filePath}`);
@@ -5345,14 +5379,14 @@ Reason: ${reason}`, {
   // Memory Summarization (Phase 4A)
   // ---------------------------------------------------------------------------
   get summariesDir() {
-    return path.join(this.baseDir, "summaries");
+    return path2.join(this.baseDir, "summaries");
   }
   /**
    * Write a memory summary.
    */
   async writeSummary(summary) {
     await mkdir(this.summariesDir, { recursive: true });
-    const filePath = path.join(this.summariesDir, `${summary.id}.json`);
+    const filePath = path2.join(this.summariesDir, `${summary.id}.json`);
     await this.writeStorageSecureFile(filePath, JSON.stringify(summary, null, 2));
     log.debug(`wrote summary ${summary.id}`);
   }
@@ -5365,7 +5399,7 @@ Reason: ${reason}`, {
       const summaries = [];
       for (const file of files) {
         if (!file.endsWith(".json")) continue;
-        const filePath = path.join(this.summariesDir, file);
+        const filePath = path2.join(this.summariesDir, file);
         const raw = await this.readStorageSecureFile(filePath);
         summaries.push(JSON.parse(raw));
       }
@@ -5426,7 +5460,7 @@ ${memory.content}
    * Save topic scores to meta.json.
    */
   async saveTopics(topics) {
-    const metaPath = path.join(this.stateDir, "topics.json");
+    const metaPath = path2.join(this.stateDir, "topics.json");
     await mkdir(this.stateDir, { recursive: true });
     await this.writeStorageSecureFile(metaPath, JSON.stringify({ topics, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2));
     log.debug(`saved ${topics.length} topic scores`);
@@ -5435,7 +5469,7 @@ ${memory.content}
    * Load topic scores from meta.json.
    */
   async loadTopics() {
-    const metaPath = path.join(this.stateDir, "topics.json");
+    const metaPath = path2.join(this.stateDir, "topics.json");
     try {
       const raw = await this.readStorageSecureFile(metaPath);
       return JSON.parse(raw);
@@ -5513,6 +5547,9 @@ ${memory.content}
 };
 
 export {
+  ALL_CATEGORY_DIRS,
+  ALL_CATEGORY_KEYS,
+  getCategoryDir,
   normalizeEntityName,
   ContentHashIndex,
   stripAttributesSuffix,
@@ -5524,4 +5561,4 @@ export {
   serializeEntityFile,
   StorageManager
 };
-//# sourceMappingURL=chunk-GYITUZFT.js.map
+//# sourceMappingURL=chunk-A4BTPHIN.js.map