@remnic/core 9.3.663 → 9.3.665

package/dist/{chunk-AX5O25EF.js → chunk-VH6EIKVS.js}

@@ -56,7 +56,7 @@ import {
 } from "./chunk-G7D6GZ5J.js";
 import {
   createVersion
-} from "./chunk-ALEPI75L.js";
+} from "./chunk-VF4XKTX3.js";
 import {
   matchEntitySchemaSection,
   normalizeEntityStructuredSection,
@@ -73,51 +73,21 @@ import {
   readMaybeEncryptedFileBuffer,
   writeMaybeEncryptedFile,
   writeMaybeEncryptedFileFromChunks
-} from "./chunk-ILXTATKK.js";
+} from "./chunk-J2HSAU72.js";
 import {
   parseFlexibleIsoTimestamp
 } from "./chunk-P7FMDTKL.js";
+import {
+  RECALL_FALLBACK_DIRS,
+  categoryDirName,
+  getCategoryDir
+} from "./chunk-VS2IYZRU.js";
 
 // src/storage.ts
 import { access, readdir, readFile, stat, writeFile, mkdir, unlink, appendFile, open } from "fs/promises";
 import { appendFileSync, createReadStream, mkdirSync, readFileSync, 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",
@@ -701,17 +671,17 @@ var KNOWN_ENTITY_FILENAME_PREFIXES = /* @__PURE__ */ new Set([
   "topic"
 ]);
 function inferEntityTypeFromFilename(pathRel) {
-  const basename = path2.basename(pathRel, ".md").toLowerCase();
+  const basename = path.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(path2.sep).join("/");
+  const normalizedPath = pathRel.split(path.sep).join("/");
   let normalizedFrontmatter = frontmatter;
   if (normalizedPath === "entities" || normalizedPath.startsWith("entities/") || normalizedPath.includes("/entities/")) {
-    const basename = path2.basename(pathRel, ".md");
+    const basename = path.basename(pathRel, ".md");
     const inferredType = inferEntityTypeFromContent(content) || inferEntityTypeFromFilename(pathRel) || "entity";
     const existingTags = Array.isArray(frontmatter.tags) ? frontmatter.tags : [];
     normalizedFrontmatter = {
@@ -778,8 +748,8 @@ var ContentHashIndex = class _ContentHashIndex {
   secureStoreKeyProvider;
   secureStoreWriteKeyProvider;
   memoryDir;
-  constructor(stateDir, secureStoreKeyProvider = () => null, secureStoreWriteKeyProvider = secureStoreKeyProvider, memoryDir = path2.dirname(stateDir)) {
-    this.filePath = path2.join(stateDir, "fact-hashes.txt");
+  constructor(stateDir, secureStoreKeyProvider = () => null, secureStoreWriteKeyProvider = secureStoreKeyProvider, memoryDir = path.dirname(stateDir)) {
+    this.filePath = path.join(stateDir, "fact-hashes.txt");
     this.secureStoreKeyProvider = secureStoreKeyProvider;
     this.secureStoreWriteKeyProvider = secureStoreWriteKeyProvider;
     this.memoryDir = memoryDir;
@@ -826,7 +796,7 @@ var ContentHashIndex = class _ContentHashIndex {
   /** Persist index to disk if changed. */
   async save() {
     if (!this.dirty) return;
-    await mkdir(path2.dirname(this.filePath), { recursive: true });
+    await mkdir(path.dirname(this.filePath), { recursive: true });
     await writeMaybeEncryptedFile(
       this.filePath,
       [...this.hashes].join("\n") + "\n",
@@ -1894,7 +1864,7 @@ var StorageManager = class _StorageManager {
         void 0,
         this.baseDir
       );
-      const rel = path2.relative(this.baseDir, filePath).split(path2.sep).join("/");
+      const rel = path.relative(this.baseDir, filePath).split(path.sep).join("/");
       return `${rel}:${version.versionId}`;
     } catch (err) {
       log.warn(
@@ -1909,13 +1879,13 @@ var StorageManager = class _StorageManager {
   }
   identityFilePath(workspaceDir, namespace) {
     const rawNamespace = typeof namespace === "string" ? namespace.trim() : "";
-    if (!rawNamespace) return path2.join(workspaceDir, "IDENTITY.md");
+    if (!rawNamespace) return path.join(workspaceDir, "IDENTITY.md");
     const safeNamespace = rawNamespace.replace(/[^a-zA-Z0-9._-]/g, "-");
-    return path2.join(workspaceDir, `IDENTITY.${safeNamespace}.md`);
+    return path.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 path2.join(this.stateDir, fileName);
+    return path.join(this.stateDir, fileName);
   }
   bumpSharedVersion(kind, fallbackMap) {
     const filePath = this.versionFilePath(kind);
@@ -1962,7 +1932,7 @@ var StorageManager = class _StorageManager {
   // memories.
   // -------------------------------------------------------------------------
   get wearablesDir() {
-    return path2.join(this.baseDir, WEARABLES_DIR_NAME);
+    return path.join(this.baseDir, WEARABLES_DIR_NAME);
   }
   /**
    * Resolve the on-disk path for a source/day transcript. Throws on
@@ -1980,7 +1950,7 @@ var StorageManager = class _StorageManager {
         `invalid wearable transcript date '${String(date)}' \u2014 expected YYYY-MM-DD`
       );
     }
-    return path2.join(this.wearablesDir, sourceId, `${date}.md`);
+    return path.join(this.wearablesDir, sourceId, `${date}.md`);
   }
   async writeWearableDayTranscript(sourceId, date, serialized) {
     const targetPath = this.wearableTranscriptPath(sourceId, date);
@@ -2018,7 +1988,7 @@ var StorageManager = class _StorageManager {
       if (!/^[a-z][a-z0-9-]{0,63}$/.test(source)) continue;
       let entries;
       try {
-        entries = await readdir(path2.join(this.wearablesDir, source));
+        entries = await readdir(path.join(this.wearablesDir, source));
       } catch (err) {
         if (err.code === "ENOENT") continue;
         throw err;
@@ -2101,25 +2071,25 @@ var StorageManager = class _StorageManager {
     });
   }
   get factsDir() {
-    return path2.join(this.baseDir, "facts");
+    return path.join(this.baseDir, "facts");
   }
   get correctionsDir() {
-    return path2.join(this.baseDir, "corrections");
+    return path.join(this.baseDir, "corrections");
   }
   get proceduresDir() {
-    return path2.join(this.baseDir, "procedures");
+    return path.join(this.baseDir, "procedures");
   }
   get reasoningTracesDir() {
-    return path2.join(this.baseDir, "reasoning-traces");
+    return path.join(this.baseDir, "reasoning-traces");
   }
   get entitiesDir() {
-    return path2.join(this.baseDir, "entities");
+    return path.join(this.baseDir, "entities");
   }
   resolveEntityFilePath(name) {
     if (typeof name !== "string") return null;
-    const filePath = path2.resolve(this.entitiesDir, `${name}.md`);
-    const relative = path2.relative(this.entitiesDir, filePath);
-    if (relative === "" || relative.startsWith("..") || path2.isAbsolute(relative)) {
+    const filePath = path.resolve(this.entitiesDir, `${name}.md`);
+    const relative = path.relative(this.entitiesDir, filePath);
+    if (relative === "" || relative.startsWith("..") || path.isAbsolute(relative)) {
       return null;
     }
     return filePath;
@@ -2131,10 +2101,10 @@ var StorageManager = class _StorageManager {
     return writeMaybeEncryptedFile(filePath, content, this.resolveWriteKey(), {}, this.baseDir);
   }
   assertManagedStoragePath(filePath, method) {
-    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)) {
+    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)) {
       throw new Error(`${method}: file path escapes memory dir`);
     }
     return resolved;
@@ -2146,7 +2116,7 @@ var StorageManager = class _StorageManager {
   async digestOfflineSyncFile(filePath) {
     const target = this.assertManagedStoragePath(filePath, "storage.digestOfflineSyncFile");
     const st = await stat(target);
-    const relPath = path2.relative(this.baseDir, target).split(path2.sep).join("/");
+    const relPath = path.relative(this.baseDir, target).split(path.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) {
@@ -2207,7 +2177,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("../") || path2.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("../") || path.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 });
@@ -2249,7 +2219,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(path2.dirname(this.offlineSyncDigestCachePath), { recursive: true });
+      await mkdir(path.dirname(this.offlineSyncDigestCachePath), { recursive: true });
       await writeFile(
         this.offlineSyncDigestCachePath,
         `${JSON.stringify({ version: 1, entries })}
@@ -2302,10 +2272,10 @@ var StorageManager = class _StorageManager {
       if (isErrnoCode(error, "ENOENT")) return;
       throw error;
     });
-    if (filePath.includes(`${path2.sep}cold${path2.sep}`)) {
+    if (filePath.includes(`${path.sep}cold${path.sep}`)) {
       this.invalidateColdMemoriesCache();
     }
-    if (filePath.includes(`${path2.sep}artifacts${path2.sep}`)) {
+    if (filePath.includes(`${path.sep}artifacts${path.sep}`)) {
       this.bumpArtifactWriteVersion();
     }
     this.bumpMemoryStatusVersion();
@@ -2333,7 +2303,7 @@ var StorageManager = class _StorageManager {
   }
   async appendStorageSecureFileUnlocked(filePath, content) {
     const writeKey = this.resolveWriteKey();
-    await mkdir(path2.dirname(filePath), { recursive: true });
+    await mkdir(path.dirname(filePath), { recursive: true });
     if (writeKey === null) {
       try {
         if (isEncryptedFile(await readFile(filePath))) {
@@ -2356,16 +2326,16 @@ var StorageManager = class _StorageManager {
     await writeMaybeEncryptedFile(filePath, `${existing}${content}`, writeKey, {}, this.baseDir);
   }
   get stateDir() {
-    return path2.join(this.baseDir, "state");
+    return path.join(this.baseDir, "state");
   }
   get offlineSyncDigestCachePath() {
-    return path2.join(this.baseDir, ".offline-sync", "digest-cache.v1.json");
+    return path.join(this.baseDir, ".offline-sync", "digest-cache.v1.json");
   }
   get entitySynthesisQueuePath() {
-    return path2.join(this.stateDir, "entity-synthesis-queue.json");
+    return path.join(this.stateDir, "entity-synthesis-queue.json");
   }
   get factHashIndexReadyPath() {
-    return path2.join(this.stateDir, "fact-hashes.ready");
+    return path.join(this.stateDir, "fact-hashes.ready");
   }
   async getFactHashIndex() {
     if (this.factHashIndex) {
@@ -2432,7 +2402,7 @@ var StorageManager = class _StorageManager {
         );
       }
       await factHashIndex.save();
-      await mkdir(path2.dirname(this.factHashIndexReadyPath), { recursive: true });
+      await mkdir(path.dirname(this.factHashIndexReadyPath), { recursive: true });
       await writeFile(this.factHashIndexReadyPath, "v1\n", "utf-8");
       this.factHashIndexAuthoritative = true;
     })().finally(() => {
@@ -2441,55 +2411,55 @@ var StorageManager = class _StorageManager {
     await this.factHashIndexAuthoritativePromise;
   }
   get questionsDir() {
-    return path2.join(this.baseDir, "questions");
+    return path.join(this.baseDir, "questions");
   }
   get artifactsDir() {
-    return path2.join(this.baseDir, "artifacts");
+    return path.join(this.baseDir, "artifacts");
   }
   get identityDir() {
-    return path2.join(this.baseDir, "identity");
+    return path.join(this.baseDir, "identity");
   }
   get identityAnchorPath() {
-    return path2.join(this.identityDir, "identity-anchor.md");
+    return path.join(this.identityDir, "identity-anchor.md");
   }
   get identityIncidentsDir() {
-    return path2.join(this.identityDir, "incidents");
+    return path.join(this.identityDir, "incidents");
   }
   get identityAuditsWeeklyDir() {
-    return path2.join(this.identityDir, "audits", "weekly");
+    return path.join(this.identityDir, "audits", "weekly");
   }
   get identityAuditsMonthlyDir() {
-    return path2.join(this.identityDir, "audits", "monthly");
+    return path.join(this.identityDir, "audits", "monthly");
   }
   get identityImprovementLoopsPath() {
-    return path2.join(this.identityDir, "improvement-loops.md");
+    return path.join(this.identityDir, "improvement-loops.md");
   }
   get identityReflectionsPath() {
-    return path2.join(this.identityDir, "reflections.md");
+    return path.join(this.identityDir, "reflections.md");
   }
   get profilePath() {
-    return path2.join(this.baseDir, "profile.md");
+    return path.join(this.baseDir, "profile.md");
   }
   get memoryActionsPath() {
-    return path2.join(this.stateDir, "memory-actions.jsonl");
+    return path.join(this.stateDir, "memory-actions.jsonl");
   }
   get memoryLifecycleLedgerPath() {
-    return path2.join(this.stateDir, "memory-lifecycle-ledger.jsonl");
+    return path.join(this.stateDir, "memory-lifecycle-ledger.jsonl");
   }
   get compressionGuidelinesPath() {
-    return path2.join(this.stateDir, "compression-guidelines.md");
+    return path.join(this.stateDir, "compression-guidelines.md");
   }
   get compressionGuidelineDraftPath() {
-    return path2.join(this.stateDir, "compression-guidelines.draft.md");
+    return path.join(this.stateDir, "compression-guidelines.draft.md");
   }
   get compressionGuidelineStatePath() {
-    return path2.join(this.stateDir, "compression-guideline-state.json");
+    return path.join(this.stateDir, "compression-guideline-state.json");
   }
   get compressionGuidelineDraftStatePath() {
-    return path2.join(this.stateDir, "compression-guideline-draft-state.json");
+    return path.join(this.stateDir, "compression-guideline-draft-state.json");
   }
   get behaviorSignalsPath() {
-    return path2.join(this.stateDir, "behavior-signals.jsonl");
+    return path.join(this.stateDir, "behavior-signals.jsonl");
   }
   /**
    * Buffer surprise telemetry ledger (issue #563 PR 3).
@@ -2502,7 +2472,7 @@ var StorageManager = class _StorageManager {
    * governance sweeps can treat it uniformly.
    */
   get bufferSurpriseLedgerPath() {
-    return path2.join(this.stateDir, "buffer-surprise-ledger.jsonl");
+    return path.join(this.stateDir, "buffer-surprise-ledger.jsonl");
   }
   /**
    * Entity alias table loaded from THIS store's config/aliases.json.
@@ -2534,7 +2504,7 @@ var StorageManager = class _StorageManager {
     this.loadAliasesSync();
   }
   loadAliasesSync() {
-    const aliasPath = path2.join(this.baseDir, "config", "aliases.json");
+    const aliasPath = path.join(this.baseDir, "config", "aliases.json");
     this.userAliases = {};
     try {
       const raw = readFileSync(aliasPath, "utf-8");
@@ -2559,9 +2529,9 @@ var StorageManager = class _StorageManager {
   }
   async ensureDirectories() {
     const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    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(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(this.correctionsDir, { recursive: true });
     await mkdir(this.entitiesDir, { recursive: true });
     await mkdir(this.stateDir, { recursive: true });
@@ -2571,7 +2541,28 @@ var StorageManager = class _StorageManager {
     await mkdir(this.identityIncidentsDir, { recursive: true });
     await mkdir(this.identityAuditsWeeklyDir, { recursive: true });
     await mkdir(this.identityAuditsMonthlyDir, { recursive: true });
-    await mkdir(path2.join(this.baseDir, "config"), { recursive: true });
+    await mkdir(path.join(this.baseDir, "config"), { recursive: true });
+  }
+  /**
+   * Resolve the on-disk write path for a memory of the given category, creating
+   * the target directory. Category routing goes through the shared
+   * `getCategoryDir()` chokepoint (utils/category-dir.ts → CATEGORY_DIR_MAP) so
+   * decision/preference/moment/etc. outputs land in their dedicated dirs
+   * (`decisions/`, `preferences/`, ...) instead of collapsing into `facts/`
+   * (issue #1546; CLAUDE.md rule 39). `correction` keeps its historical flat
+   * layout (no `<date>` subdir) as the corrections pipeline expects; every other
+   * category — including `fact`/`entity`, which fall back to `facts/` — is dated
+   * as `<dir>/<date>/`. Read/scan/reindex already iterate every category dir
+   * (RECALL_FALLBACK_DIRS; QMD scans baseDir recursively), so writes stay found.
+   */
+  async resolveCategoryWritePath(category, id, today) {
+    if (category === "correction") {
+      await mkdir(this.correctionsDir, { recursive: true });
+      return path.join(this.correctionsDir, `${id}.md`);
+    }
+    const datedDir = path.join(getCategoryDir(this.baseDir, category), today);
+    await mkdir(datedDir, { recursive: true });
+    return path.join(datedDir, `${id}.md`);
   }
   async writeMemory(category, content, options = {}) {
     await this.ensureDirectories();
@@ -2639,18 +2630,7 @@ var StorageManager = class _StorageManager {
 
 ${sanitized.text}
 `;
-    let filePath;
-    if (category === "correction") {
-      filePath = path2.join(this.correctionsDir, `${id}.md`);
-    } else if (category === "procedure") {
-      await mkdir(path2.join(this.proceduresDir, today), { recursive: true });
-      filePath = path2.join(this.proceduresDir, today, `${id}.md`);
-    } else if (category === "reasoning_trace") {
-      await mkdir(path2.join(this.reasoningTracesDir, today), { recursive: true });
-      filePath = path2.join(this.reasoningTracesDir, today, `${id}.md`);
-    } else {
-      filePath = path2.join(this.factsDir, today, `${id}.md`);
-    }
+    const filePath = await this.resolveCategoryWritePath(category, id, today);
     await this.snapshotBeforeWrite(filePath, "write");
     await writeMaybeEncryptedFile(filePath, fileContent, this.resolveWriteKey(), {}, this.baseDir);
     this.invalidateAllMemoriesCache();
@@ -2764,7 +2744,7 @@ ${sanitized.text}
     await this.ensureDirectories();
     const now = /* @__PURE__ */ new Date();
     const day = now.toISOString().slice(0, 10);
-    const dir = path2.join(this.artifactsDir, day);
+    const dir = path.join(this.artifactsDir, day);
     await mkdir(dir, { recursive: true });
     const id = `artifact-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
     const fm = {
@@ -2788,7 +2768,7 @@ ${sanitized.text}
       log.warn(`artifact content rejected for ${id}; violations=${sanitized.violations.join(", ")}`);
       return "";
     }
-    const filePath = path2.join(dir, `${id}.md`);
+    const filePath = path.join(dir, `${id}.md`);
     await writeMaybeEncryptedFile(filePath, `${serializeFrontmatter(fm)}
 
 ${sanitized.text}
@@ -2816,7 +2796,7 @@ ${sanitized.text}
         try {
           const entries = await readdir(dir, { withFileTypes: true });
           for (const entry of entries) {
-            const fullPath = path2.join(dir, entry.name);
+            const fullPath = path.join(dir, entry.name);
             if (entry.isDirectory()) {
               await readDir(fullPath);
               continue;
@@ -2882,7 +2862,7 @@ ${sanitized.text}
       log.debug(`fuzzy match: "${normalized}" \u2192 existing "${match}"`);
       normalized = match;
     }
-    const filePath = path2.join(this.entitiesDir, `${normalized}.md`);
+    const filePath = path.join(this.entitiesDir, `${normalized}.md`);
     let entity = {
       name,
       type,
@@ -3118,7 +3098,7 @@ ${sanitized.text}
    * per-process in-memory cache safe across process boundaries.
    */
   invalidateColdMemoriesCache() {
-    const coldRoot = path2.join(this.baseDir, "cold");
+    const coldRoot = path.join(this.baseDir, "cold");
     _StorageManager.coldMemoriesCache.delete(coldRoot);
     this.bumpColdWriteVersion();
     invalidateAllForDir(this.baseDir);
@@ -3147,7 +3127,7 @@ ${sanitized.text}
         const entries = await readdir(dir, { withFileTypes: true });
         const subdirs = [];
         for (const entry of entries) {
-          const fullPath = path2.join(dir, entry.name);
+          const fullPath = path.join(dir, entry.name);
           if (entry.isDirectory()) {
             subdirs.push(fullPath);
           } else if (entry.name.endsWith(".md")) {
@@ -3161,7 +3141,7 @@ ${sanitized.text}
       }
     };
     for (const dir of RECALL_FALLBACK_DIRS) {
-      await collectPaths(path2.join(this.baseDir, dir));
+      await collectPaths(path.join(this.baseDir, dir));
     }
     return filePaths;
   }
@@ -3230,7 +3210,7 @@ ${sanitized.text}
     const correctionPaths = [];
     const factPaths = [];
     for (const filePath of filePaths) {
-      if (filePath === this.correctionsDir || filePath.startsWith(`${this.correctionsDir}${path2.sep}`)) {
+      if (filePath === this.correctionsDir || filePath.startsWith(`${this.correctionsDir}${path.sep}`)) {
         correctionPaths.push(filePath);
       } else {
         factPaths.push(filePath);
@@ -3316,9 +3296,10 @@ ${sanitized.text}
    * Read all memories from the cold tier by scanning the entire cold/ root
    * tree.  Previously this only scanned cold/facts/ and cold/corrections/, but
    * structuredAttributes can appear on any MemoryCategory (preference, decision,
-   * entity, etc.).  Although buildTierMemoryPath currently routes all
-   * non-correction, non-artifact memories to cold/facts/, scanning the full
-   * coldRoot ensures correctness if that routing ever changes and guards against
+   * entity, etc.).  buildTierMemoryPath now routes each category to its own
+   * cold/<dir>/ subtree via the shared categoryDirName() chokepoint (issue
+   * #1546), so cold decisions/preferences/... live outside cold/facts/.
+   * Scanning the full coldRoot covers every category dir and guards against
    * files placed in unexpected subdirectories during manual operations or future
    * refactors.
    *
@@ -3350,7 +3331,7 @@ ${sanitized.text}
         const entries = await readdir(dir, { withFileTypes: true });
         const subdirs = [];
         for (const entry of entries) {
-          const fullPath = path2.join(dir, entry.name);
+          const fullPath = path.join(dir, entry.name);
           if (entry.isDirectory()) {
             subdirs.push(fullPath);
           } else if (entry.name.endsWith(".md")) {
@@ -3379,7 +3360,7 @@ ${sanitized.text}
       try {
         const entries = await readdir(dir, { withFileTypes: true });
         for (const entry of entries) {
-          const fullPath = path2.join(dir, entry.name);
+          const fullPath = path.join(dir, entry.name);
           if (entry.isDirectory()) {
             await readDir(fullPath);
           } else if (entry.name.endsWith(".md")) {
@@ -3424,11 +3405,11 @@ ${sanitized.text}
           content: parsed.content
         };
       }
-      const normalizedPath = filePath.split(path2.sep).join("/");
+      const normalizedPath = filePath.split(path.sep).join("/");
       if (normalizedPath.includes("/entities/") && filePath.endsWith(".md")) {
         const entity = parseEntityFile(raw, this.entitySchemas);
         if (!entity.name) return null;
-        const nameWithoutExt = path2.basename(filePath, ".md");
+        const nameWithoutExt = path.basename(filePath, ".md");
         const fileMtime = entity.updated || await stat(filePath).then((s) => s.mtime.toISOString()).catch(() => (/* @__PURE__ */ new Date(0)).toISOString());
         return {
           path: filePath,
@@ -3452,7 +3433,7 @@ ${sanitized.text}
     }
   }
   resolveTierRootDir(tier) {
-    return tier === "cold" ? path2.join(this.baseDir, "cold") : this.baseDir;
+    return tier === "cold" ? path.join(this.baseDir, "cold") : this.baseDir;
   }
   resolveMemoryDateDir(memory) {
     const preferred = memory.frontmatter.created || memory.frontmatter.updated;
@@ -3467,18 +3448,13 @@ ${sanitized.text}
   buildTierMemoryPath(memory, tier) {
     const root = this.resolveTierRootDir(tier);
     if (this.isArtifactMemory(memory)) {
-      return path2.join(root, "artifacts", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
+      return path.join(root, "artifacts", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
     }
     if (memory.frontmatter.category === "correction") {
-      return path2.join(root, "corrections", `${memory.frontmatter.id}.md`);
-    }
-    if (memory.frontmatter.category === "procedure") {
-      return path2.join(root, "procedures", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
+      return path.join(root, "corrections", `${memory.frontmatter.id}.md`);
     }
-    if (memory.frontmatter.category === "reasoning_trace") {
-      return path2.join(root, "reasoning-traces", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
-    }
-    return path2.join(root, "facts", this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
+    const dir = categoryDirName(memory.frontmatter.category);
+    return path.join(root, dir, this.resolveMemoryDateDir(memory), `${memory.frontmatter.id}.md`);
   }
   async writeMemoryFileAtomic(targetPath, memory) {
     const fileContent = `${serializeFrontmatter(memory.frontmatter)}
@@ -3490,8 +3466,8 @@ ${memory.content}
   }
   async moveMemoryToPath(memory, targetPath) {
     await this.writeMemoryFileAtomic(targetPath, memory);
-    const sourcePath = path2.resolve(memory.path);
-    const destPath = path2.resolve(targetPath);
+    const sourcePath = path.resolve(memory.path);
+    const destPath = path.resolve(targetPath);
     if (sourcePath !== destPath) {
       try {
         await unlink(memory.path);
@@ -3506,8 +3482,8 @@ ${memory.content}
   }
   async migrateMemoryToTier(memory, targetTier) {
     const targetPath = this.buildTierMemoryPath(memory, targetTier);
-    const sourcePath = path2.resolve(memory.path);
-    const destPath = path2.resolve(targetPath);
+    const sourcePath = path.resolve(memory.path);
+    const destPath = path.resolve(targetPath);
     if (sourcePath === destPath) {
       return { changed: false, targetPath };
     }
@@ -3533,7 +3509,7 @@ ${memory.content}
     return { changed: true, targetPath };
   }
   get archiveDir() {
-    return path2.join(this.baseDir, "archive");
+    return path.join(this.baseDir, "archive");
   }
   /**
    * Archive a memory by moving it from facts/ to archive/YYYY-MM-DD/.
@@ -3544,7 +3520,7 @@ ${memory.content}
     try {
       const now = lifecycle?.at ?? /* @__PURE__ */ new Date();
       const today = now.toISOString().slice(0, 10);
-      const destDir = path2.join(this.archiveDir, today);
+      const destDir = path.join(this.archiveDir, today);
       await mkdir(destDir, { recursive: true });
       const updatedFm = {
         ...memory.frontmatter,
@@ -3556,7 +3532,7 @@ ${memory.content}
 
 ${memory.content}
 `;
-      const destPath = path2.join(destDir, path2.basename(memory.path));
+      const destPath = path.join(destDir, path.basename(memory.path));
       await writeMaybeEncryptedFile(destPath, fileContent, this.resolveWriteKey(), {}, this.baseDir);
       await unlink(memory.path);
       this.invalidateAllMemoriesCache();
@@ -3718,7 +3694,7 @@ ${memory.content}
 `;
     await writeMaybeEncryptedFile(memory.path, fileContent, this.resolveWriteKey(), {}, this.baseDir);
     this.invalidateAllMemoriesCache();
-    if (memory.path.includes(`${path2.sep}cold${path2.sep}`)) {
+    if (memory.path.includes(`${path.sep}cold${path.sep}`)) {
       this.invalidateColdMemoriesCache();
     }
     try {
@@ -3790,7 +3766,7 @@ ${memory.content}
     return deleted;
   }
   async loadBuffer() {
-    const bufferPath = path2.join(this.stateDir, "buffer.json");
+    const bufferPath = path.join(this.stateDir, "buffer.json");
     try {
       const raw = await this.readStorageSecureFile(bufferPath);
       return JSON.parse(raw);
@@ -3802,11 +3778,11 @@ ${memory.content}
   }
   async saveBuffer(state) {
     await this.ensureDirectories();
-    const bufferPath = path2.join(this.stateDir, "buffer.json");
+    const bufferPath = path.join(this.stateDir, "buffer.json");
     await this.writeStorageSecureFile(bufferPath, JSON.stringify(state, null, 2));
   }
   async loadMeta() {
-    const metaPath = path2.join(this.stateDir, "meta.json");
+    const metaPath = path.join(this.stateDir, "meta.json");
     try {
       const raw = await this.readStorageSecureFile(metaPath);
       const parsed = JSON.parse(raw);
@@ -3840,7 +3816,7 @@ ${memory.content}
   }
   async saveMeta(state) {
     await this.ensureDirectories();
-    const metaPath = path2.join(this.stateDir, "meta.json");
+    const metaPath = path.join(this.stateDir, "meta.json");
     await this.writeStorageSecureFile(metaPath, JSON.stringify(state, null, 2));
   }
   async appendMemoryActionEvents(events) {
@@ -4010,7 +3986,7 @@ ${memory.content}
   async appendReextractJobs(events) {
     if (events.length === 0) return 0;
     await this.ensureDirectories();
-    const filePath = path2.join(this.stateDir, "reextract-jobs.jsonl");
+    const filePath = path.join(this.stateDir, "reextract-jobs.jsonl");
     const lines = events.map((event) => JSON.stringify(event)).join("\n") + "\n";
     try {
       await this.appendStorageSecureFile(filePath, lines);
@@ -4023,7 +3999,7 @@ ${memory.content}
   }
   async readReextractJobs(limit = 200) {
     const safeLimit = Number.isFinite(limit) ? Math.max(1, Math.min(1e3, Math.floor(limit))) : 200;
-    const filePath = path2.join(this.stateDir, "reextract-jobs.jsonl");
+    const filePath = path.join(this.stateDir, "reextract-jobs.jsonl");
     try {
       const raw = await this.readStorageSecureFile(filePath);
       const lines = raw.split("\n").filter((line) => line.trim().length > 0);
@@ -4277,7 +4253,7 @@ ${memory.content}
     const date = nowIso.slice(0, 10);
     const id = this.generateId("incident");
     const incident = createContinuityIncidentRecord(id, input, nowIso);
-    const filePath = path2.join(this.identityIncidentsDir, `${date}-${id}.md`);
+    const filePath = path.join(this.identityIncidentsDir, `${date}-${id}.md`);
     await this.writeStorageSecureFile(filePath, serializeContinuityIncident(incident));
     return { ...incident, filePath };
   }
@@ -4290,7 +4266,7 @@ ${memory.content}
       const incidents = [];
       for (const file of candidates) {
         if (incidents.length >= cappedLimit) break;
-        const filePath = path2.join(this.identityIncidentsDir, file);
+        const filePath = path.join(this.identityIncidentsDir, file);
         try {
           const raw = await this.readStorageSecureFile(filePath);
           const parsed = parseContinuityIncident(raw);
@@ -4321,7 +4297,7 @@ ${memory.content}
     await this.ensureDirectories();
     const safeKey = this.sanitizeIdentityAuditKey(key);
     const dir = period === "weekly" ? this.identityAuditsWeeklyDir : this.identityAuditsMonthlyDir;
-    const filePath = path2.join(dir, `${safeKey}.md`);
+    const filePath = path.join(dir, `${safeKey}.md`);
     await this.writeStorageSecureFile(filePath, content);
     return filePath;
   }
@@ -4329,7 +4305,7 @@ ${memory.content}
     try {
       const safeKey = this.sanitizeIdentityAuditKey(key);
       const dir = period === "weekly" ? this.identityAuditsWeeklyDir : this.identityAuditsMonthlyDir;
-      return await this.readStorageSecureFile(path2.join(dir, `${safeKey}.md`));
+      return await this.readStorageSecureFile(path.join(dir, `${safeKey}.md`));
     } catch (err) {
       if (err instanceof Error && err.message === "Invalid identity audit key") return null;
       if (!isErrnoCode(err, "ENOENT")) throw err;
@@ -4393,12 +4369,12 @@ ${memory.content}
     const fileNames = await this.readContinuityIncidentFileNames();
     const directMatch = fileNames.find((name) => name.endsWith(`-${id}.md`));
     if (directMatch) {
-      const directPath = path2.join(this.identityIncidentsDir, directMatch);
+      const directPath = path.join(this.identityIncidentsDir, directMatch);
       const parsed = await this.readContinuityIncidentFile(directPath);
       if (parsed?.id === id) return directPath;
     }
     for (const fileName of fileNames) {
-      const filePath = path2.join(this.identityIncidentsDir, fileName);
+      const filePath = path.join(this.identityIncidentsDir, fileName);
       const parsed = await this.readContinuityIncidentFile(filePath);
       if (parsed?.id === id) return filePath;
     }
@@ -4428,7 +4404,7 @@ ${question}
 
 **Context:** ${context}
 `;
-    const filePath = path2.join(this.questionsDir, `${id}.md`);
+    const filePath = path.join(this.questionsDir, `${id}.md`);
     await writeFile(filePath, content, "utf-8");
     log.debug(`wrote question ${id} to ${filePath}`);
     this.invalidateQuestionsCache();
@@ -4452,7 +4428,7 @@ ${question}
       const questions = [];
       for (const file of files) {
         if (!file.endsWith(".md")) continue;
-        const filePath = path2.join(this.questionsDir, file);
+        const filePath = path.join(this.questionsDir, file);
         const raw = await readMaybeEncryptedFile(filePath, this._secureStoreKey, this.baseDir);
         const parsed = this.parseQuestionFile(raw, filePath);
         if (parsed) {
@@ -4475,7 +4451,7 @@ ${question}
     if (!match) return null;
     const frontmatterStr = match[1];
     const body = match[2].trim();
-    const id = this.extractFrontmatterValue(frontmatterStr, "id") ?? path2.basename(filePath, ".md");
+    const id = this.extractFrontmatterValue(frontmatterStr, "id") ?? path.basename(filePath, ".md");
     const created = this.extractFrontmatterValue(frontmatterStr, "created") ?? "";
     const priority = parseFloat(
       this.extractFrontmatterValue(frontmatterStr, "priority") ?? "0.5"
@@ -4537,11 +4513,11 @@ ${question}
     } catch {
     }
     const hygiene = opts?.hygiene;
-    const rotateEnabled = hygiene?.enabled === true && hygiene.rotateEnabled === true && Array.isArray(hygiene.rotatePaths) && hygiene.rotatePaths.includes(path2.basename(identityPath));
+    const rotateEnabled = hygiene?.enabled === true && hygiene.rotateEnabled === true && Array.isArray(hygiene.rotatePaths) && hygiene.rotatePaths.includes(path.basename(identityPath));
     if (rotateEnabled) {
       const maxBytes = hygiene.rotateMaxBytes;
       if (existing.length > maxBytes) {
-        const archiveDir = path2.join(workspaceDir, hygiene.archiveDir);
+        const archiveDir = path.join(workspaceDir, hygiene.archiveDir);
         const { newContent } = await rotateMarkdownFileToArchive({
           filePath: identityPath,
           archiveDir,
@@ -4635,7 +4611,7 @@ ${reflection}
    * Deduplicates by target+label.
    */
   async addEntityRelationship(name, rel) {
-    const filePath = path2.join(this.entitiesDir, `${name}.md`);
+    const filePath = path.join(this.entitiesDir, `${name}.md`);
     let entity;
     try {
       const content = await this.readStorageSecureFile(filePath);
@@ -4660,7 +4636,7 @@ ${reflection}
    * Prepends to the beginning, prunes oldest entries beyond maxEntries.
    */
   async addEntityActivity(name, entry, maxEntries) {
-    const filePath = path2.join(this.entitiesDir, `${name}.md`);
+    const filePath = path.join(this.entitiesDir, `${name}.md`);
     let entity;
     try {
       const content = await this.readStorageSecureFile(filePath);
@@ -4683,7 +4659,7 @@ ${reflection}
    * Add an alias to an entity file. Deduplicates.
    */
   async addEntityAlias(name, alias) {
-    const filePath = path2.join(this.entitiesDir, `${name}.md`);
+    const filePath = path.join(this.entitiesDir, `${name}.md`);
     let entity;
     try {
       const content = await this.readStorageSecureFile(filePath);
@@ -4704,7 +4680,7 @@ ${reflection}
    * Set or rewrite the synthesis layer of an entity file.
    */
   async updateEntitySynthesis(name, synthesis, options = {}) {
-    const filePath = path2.join(this.entitiesDir, `${name}.md`);
+    const filePath = path.join(this.entitiesDir, `${name}.md`);
     let entity;
     try {
       const content = await this.readStorageSecureFile(filePath);
@@ -4742,7 +4718,7 @@ ${reflection}
     const updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     let synthesisTimelineCount;
     try {
-      const filePath = path2.join(this.entitiesDir, `${name}.md`);
+      const filePath = path.join(this.entitiesDir, `${name}.md`);
       const content = await this.readStorageSecureFile(filePath);
       synthesisTimelineCount = parseEntityFile(content, this.entitySchemas).timeline.length;
     } catch (err) {
@@ -4825,7 +4801,7 @@ ${reflection}
       if (!raw) continue;
       const serialized = serializeEntityFile(parseEntityFile(raw, this.entitySchemas), this.entitySchemas);
       if (raw.trimEnd() === serialized.trimEnd()) continue;
-      await this.writeStorageSecureFile(path2.join(this.entitiesDir, `${entityName}.md`), serialized);
+      await this.writeStorageSecureFile(path.join(this.entitiesDir, `${entityName}.md`), serialized);
       migrated += 1;
     }
     if (migrated > 0) {
@@ -4861,7 +4837,7 @@ ${reflection}
         const results = await Promise.all(
           batch.map(async (entry) => {
             try {
-              return await this.readStorageSecureFile(path2.join(this.entitiesDir, entry));
+              return await this.readStorageSecureFile(path.join(this.entitiesDir, entry));
             } catch (err) {
               if (err instanceof SecureStoreLockedError) throw err;
               if (!isErrnoCode(err, "ENOENT")) throw err;
@@ -5007,7 +4983,7 @@ ${rows.join("\n")}
           extraSections: []
         };
         for (const file of files) {
-          const filePath = path2.join(this.entitiesDir, file);
+          const filePath = path.join(this.entitiesDir, file);
           try {
             const content = await this.readStorageSecureFile(filePath);
             const parsed = parseEntityFile(content, this.entitySchemas);
@@ -5138,10 +5114,10 @@ ${rows.join("\n")}
         }
         mergedEntity.created = mergedEntity.created || mergedEntity.updated || (/* @__PURE__ */ new Date()).toISOString();
         mergedEntity.updated = mergedEntity.updated || (/* @__PURE__ */ new Date()).toISOString();
-        const canonicalPath = path2.join(this.entitiesDir, `${canonical}.md`);
+        const canonicalPath = path.join(this.entitiesDir, `${canonical}.md`);
         await this.writeStorageSecureFile(canonicalPath, serializeEntityFile(mergedEntity, this.entitySchemas));
         for (const file of files) {
-          const filePath = path2.join(this.entitiesDir, file);
+          const filePath = path.join(this.entitiesDir, file);
           if (filePath !== canonicalPath) {
             try {
               await unlink(filePath);
@@ -5240,7 +5216,7 @@ ${memory.content}
     const filePaths = await this.collectActiveMemoryPaths();
     const foundIds = /* @__PURE__ */ new Set();
     for (const filePath of filePaths) {
-      const basename = path2.basename(filePath, ".md");
+      const basename = path.basename(filePath, ".md");
       if (wantedIds.has(basename)) {
         foundIds.add(basename);
         if (foundIds.size === wantedIds.size) break;
@@ -5338,18 +5314,7 @@ ${memory.content}
 
 ${sanitized.text}
 `;
-    let filePath;
-    if (category === "correction") {
-      filePath = path2.join(this.correctionsDir, `${id}.md`);
-    } else if (category === "procedure") {
-      await mkdir(path2.join(this.proceduresDir, today), { recursive: true });
-      filePath = path2.join(this.proceduresDir, today, `${id}.md`);
-    } else if (category === "reasoning_trace") {
-      await mkdir(path2.join(this.reasoningTracesDir, today), { recursive: true });
-      filePath = path2.join(this.reasoningTracesDir, today, `${id}.md`);
-    } else {
-      filePath = path2.join(this.factsDir, today, `${id}.md`);
-    }
+    const filePath = await this.resolveCategoryWritePath(category, id, today);
     await this.writeStorageSecureFile(filePath, fileContent);
     log.debug(`wrote chunk ${id} (${chunkIndex + 1}/${chunkTotal}) to ${filePath}`);
     return id;
@@ -5417,14 +5382,14 @@ Reason: ${reason}`, {
   // Memory Summarization (Phase 4A)
   // ---------------------------------------------------------------------------
   get summariesDir() {
-    return path2.join(this.baseDir, "summaries");
+    return path.join(this.baseDir, "summaries");
   }
   /**
    * Write a memory summary.
    */
   async writeSummary(summary) {
     await mkdir(this.summariesDir, { recursive: true });
-    const filePath = path2.join(this.summariesDir, `${summary.id}.json`);
+    const filePath = path.join(this.summariesDir, `${summary.id}.json`);
     await this.writeStorageSecureFile(filePath, JSON.stringify(summary, null, 2));
     log.debug(`wrote summary ${summary.id}`);
   }
@@ -5437,7 +5402,7 @@ Reason: ${reason}`, {
       const summaries = [];
       for (const file of files) {
         if (!file.endsWith(".json")) continue;
-        const filePath = path2.join(this.summariesDir, file);
+        const filePath = path.join(this.summariesDir, file);
         const raw = await this.readStorageSecureFile(filePath);
         summaries.push(JSON.parse(raw));
       }
@@ -5498,7 +5463,7 @@ ${memory.content}
    * Save topic scores to meta.json.
    */
   async saveTopics(topics) {
-    const metaPath = path2.join(this.stateDir, "topics.json");
+    const metaPath = path.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`);
@@ -5507,7 +5472,7 @@ ${memory.content}
    * Load topic scores from meta.json.
    */
   async loadTopics() {
-    const metaPath = path2.join(this.stateDir, "topics.json");
+    const metaPath = path.join(this.stateDir, "topics.json");
     try {
       const raw = await this.readStorageSecureFile(metaPath);
       return JSON.parse(raw);
@@ -5585,9 +5550,6 @@ ${memory.content}
 };
 
 export {
-  ALL_CATEGORY_DIRS,
-  ALL_CATEGORY_KEYS,
-  getCategoryDir,
   normalizeEntityName,
   ContentHashIndex,
   stripAttributesSuffix,
@@ -5599,4 +5561,4 @@ export {
   serializeEntityFile,
   StorageManager
 };
-//# sourceMappingURL=chunk-AX5O25EF.js.map
+//# sourceMappingURL=chunk-VH6EIKVS.js.map