@framers/agentos 0.13.64 → 0.13.65

package/dist/cognition/memory/io/MarkdownExporter.js

@@ -9,6 +9,16 @@
  * The `gray-matter` library is used to serialise the front-matter block so
  * that the same library can later round-trip back via `MarkdownImporter`.
  *
+ * A trace's scope, type and id name its folders and its file, so each is held
+ * to the name rule in `core/utils/pathName` before anything is written, and the
+ * file's resolved path must lie inside the export folder. Below the export
+ * folder no folder or file is made or written through a link, symbolic or
+ * hard, and two traces whose files would be one where names ignore case are
+ * not both written. A trace that fails any of these is left out and reported
+ * in the export's result. The checks run as each folder is made and each file
+ * opened; Node has no `openat`, so a process that swaps a folder below the
+ * export folder for a link while the export runs is outside what they stop.
+ *
  * ## Folder layout
  * ```
  * {outputDir}/
@@ -26,8 +36,29 @@
  * @module memory/io/MarkdownExporter
  */
 import fs from 'node:fs/promises';
+import { constants as fsConstants } from 'node:fs';
 import path from 'node:path';
 import { writeFrontMatter } from '../../../core/utils/frontMatter.js';
+import { pathNameProblem, resolveInsideFolder } from '../../../core/utils/pathName.js';
+/**
+ * The flags a trace's file is opened with: for writing, made when missing, and, where the platform has the flag
+ * (`O_NOFOLLOW`, which Windows lacks), never through a symbolic link in the file's own place. The file is emptied
+ * only once the open file shows it has no second name.
+ */
+const OPEN_FLAGS = fsConstants.O_WRONLY |
+    fsConstants.O_CREAT |
+    (fsConstants.O_NOFOLLOW !== undefined ? fsConstants.O_NOFOLLOW : 0);
+/** The codes an open with `O_NOFOLLOW` fails with when a symbolic link holds the file's place (EMLINK on FreeBSD). */
+const LINK_OPEN_CODES = new Set(['ELOOP', 'EMLINK']);
+/** Thrown by `traceRelativePath` for a trace whose scope, type or id is not a safe name; the export reports it. */
+class RefusedTraceName extends Error {
+    constructor(field, problem) {
+        super(`the trace's ${field} is not a safe file or folder name (${problem})`);
+        this.field = field;
+        this.problem = problem;
+        this.name = 'RefusedTraceName';
+    }
+}
 // ---------------------------------------------------------------------------
 // MarkdownExporter
 // ---------------------------------------------------------------------------
@@ -53,15 +84,66 @@ export class MarkdownExporter {
     /**
      * Export all memory traces as `.md` files into `outputDir`.
      *
-     * Directories are created on demand (equivalent to `mkdir -p`).
+     * Directories are created on demand, one name at a time. A trace is not
+     * written, and is reported in the result, when its scope, type or id is not
+     * a safe file or folder name, when its file would lie outside `outputDir`,
+     * when a folder or file in its place under `outputDir` is a symbolic link or
+     * its file has a second name (a hard link), or when an older trace's file is
+     * the same file where names ignore case. Every other trace is written.
      *
      * @param outputDir - Root directory to write the Markdown vault into.
      * @param _options  - Optional export configuration (currently unused but
      *   accepted for API consistency with other exporters).
+     * @returns The traces left out, with the reason for each.
      */
     async export(outputDir, _options) {
-        const traces = await this.brain.all('SELECT id, type, scope, content, strength, created_at, tags FROM memory_traces WHERE deleted = 0');
-        await Promise.all(traces.map((trace) => this._writeTrace(outputDir, trace)));
+        // Oldest first, so of two traces whose files would be one, the older is written.
+        const traces = await this.brain.all('SELECT id, type, scope, content, strength, created_at, tags FROM memory_traces WHERE deleted = 0 ORDER BY created_at, id');
+        // Every trace is placed before any folder is made or file written.
+        const refused = [];
+        const placed = [];
+        const taken = new Set();
+        for (const trace of traces) {
+            const place = this._placeTrace(outputDir, trace);
+            if (typeof place !== 'string') {
+                refused.push(place);
+                continue;
+            }
+            // Paths that differ only in case or in Unicode form name one file where names ignore case (macOS, Windows).
+            const key = place.normalize('NFC').toLowerCase();
+            if (taken.has(key)) {
+                refused.push({ id: String(trace.id), field: 'path', problem: 'collision' });
+                continue;
+            }
+            taken.add(key);
+            placed.push({ file: place, trace });
+        }
+        // The export folder is the caller's: it is made when missing and used as it is, even when it is a link. Below
+        // it, every folder is made one name at a time, and no folder or file is written through a link.
+        await fs.mkdir(outputDir, { recursive: true });
+        const root = path.resolve(outputDir);
+        const linkFree = new Map();
+        const writable = [];
+        for (const entry of placed) {
+            const folder = path.dirname(entry.file);
+            let free = linkFree.get(folder);
+            if (free === undefined) {
+                free = await makeFoldersOutsideLinks(root, path.relative(root, folder));
+                linkFree.set(folder, free);
+            }
+            if (free) {
+                writable.push(entry);
+            }
+            else {
+                refused.push({ id: String(entry.trace.id), field: 'path', problem: 'link' });
+            }
+        }
+        const written = await Promise.all(writable.map(({ file, trace }) => this._writeTrace(file, trace)));
+        for (const refusal of written) {
+            if (refusal)
+                refused.push(refusal);
+        }
+        return { refused };
     }
     // -------------------------------------------------------------------------
     // Protected helpers (overridden by ObsidianExporter)
@@ -97,32 +179,130 @@ export class MarkdownExporter {
     /**
      * Determine the relative file path for a trace within the output directory.
      *
-     * Default: `{scope}/{type}/{id}.md`
+     * Default: `{scope}/{type}/{id}.md`. Each of the three must be a safe file
+     * or folder name (see `pathNameProblem`), or the trace is refused. Whatever
+     * a subclass returns, the export writes the file only when its resolved
+     * path lies inside the output directory.
      *
      * @param trace - The trace row.
      * @returns Relative path string (no leading slash).
+     * @throws When the trace's scope, type or id is not a safe name; the export
+     *   reports such a trace in its result instead of writing it.
      */
     traceRelativePath(trace) {
-        return path.join(trace.scope, trace.type, `${trace.id}.md`);
+        return path.join(traceName(trace, 'scope'), traceName(trace, 'type'), `${traceName(trace, 'id')}.md`);
     }
     // -------------------------------------------------------------------------
     // Private helpers
     // -------------------------------------------------------------------------
     /**
-     * Write a single trace to disk.
-     *
-     * Creates any missing parent directories before writing.
+     * The absolute path of a trace's file inside `outputDir`, or the reason the
+     * trace is refused: a scope, type or id that is not a safe name, or a path
+     * outside `outputDir`.
      *
      * @param outputDir - Root output directory.
-     * @param trace     - Trace row to serialise.
+     * @param trace     - The trace row.
      */
-    async _writeTrace(outputDir, trace) {
-        const relPath = this.traceRelativePath(trace);
-        const absPath = path.join(outputDir, relPath);
-        // Ensure parent directory exists.
-        await fs.mkdir(path.dirname(absPath), { recursive: true });
-        const content = this.buildFileContent(trace);
-        await fs.writeFile(absPath, content, 'utf8');
+    _placeTrace(outputDir, trace) {
+        let relPath;
+        try {
+            relPath = this.traceRelativePath(trace);
+        }
+        catch (err) {
+            if (!(err instanceof RefusedTraceName))
+                throw err;
+            return { id: String(trace.id), field: err.field, problem: err.problem };
+        }
+        return resolveInsideFolder(outputDir, [relPath]) ?? { id: String(trace.id), field: 'path', problem: 'outside' };
+    }
+    /**
+     * Write a single trace to disk, into a folder already made, and never
+     * through a link. A symbolic link in the file's place is refused before the
+     * open, and where the platform has `O_NOFOLLOW` the open refuses one put
+     * there since. A file with a second name (a hard link) is the same file as
+     * that name, which may be outside the export folder, so the open file is
+     * refused before it is emptied.
+     *
+     * @param file  - Absolute path of the trace's file, inside the output directory.
+     * @param trace - Trace row to serialise.
+     * @returns The refusal when a link holds the file's place, or null once the file is written.
+     */
+    async _writeTrace(file, trace) {
+        const linked = { id: String(trace.id), field: 'path', problem: 'link' };
+        if ((await lstatOrNull(file))?.isSymbolicLink())
+            return linked;
+        const handle = await fs.open(file, OPEN_FLAGS).catch((err) => {
+            if (LINK_OPEN_CODES.has(String(err.code)))
+                return null;
+            throw err;
+        });
+        if (handle === null)
+            return linked;
+        try {
+            if ((await handle.stat()).nlink > 1)
+                return linked;
+            await handle.truncate(0);
+            await handle.writeFile(this.buildFileContent(trace), 'utf8');
+            return null;
+        }
+        finally {
+            await handle.close();
+        }
+    }
+}
+/** The entry at `file` itself, a link not followed, or null when there is none. */
+async function lstatOrNull(file) {
+    try {
+        return await fs.lstat(file);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+/**
+ * Make the folders `relative` names under `root`, one name at a time, and stop at a link. A folder this makes is
+ * never a link, so a file written into it stays under `root`.
+ *
+ * @param root     - The export folder.
+ * @param relative - The folder's path under `root`.
+ * @returns True when every folder is in place and none of them is a link.
+ */
+async function makeFoldersOutsideLinks(root, relative) {
+    let dir = root;
+    for (const name of relative.split(path.sep).filter((part) => part.length > 0)) {
+        dir = path.join(dir, name);
+        const entry = await lstatOrNull(dir);
+        if (entry) {
+            if (entry.isSymbolicLink())
+                return false;
+            continue;
+        }
+        try {
+            await fs.mkdir(dir);
+        }
+        catch (err) {
+            if (err.code !== 'EEXIST')
+                throw err;
+            // Something was put there since the look: look again.
+            if ((await fs.lstat(dir)).isSymbolicLink())
+                return false;
+        }
     }
+    return true;
+}
+/**
+ * The trace's `field` as one file or folder name: its value as text, once the
+ * name rule accepts it.
+ *
+ * @throws RefusedTraceName when the value is not a safe name.
+ */
+function traceName(trace, field) {
+    const name = String(trace[field]);
+    const problem = pathNameProblem(name);
+    if (problem)
+        throw new RefusedTraceName(field, problem);
+    return name;
 }
 //# sourceMappingURL=MarkdownExporter.js.map

package/dist/cognition/memory/io/MarkdownExporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"MarkdownExporter.js","sourceRoot":"","sources":["../../../../src/cognition/memory/io/MarkdownExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAiBtE,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;OAEG;IACH,YAA+B,KAAY;QAAZ,UAAK,GAAL,KAAK,CAAO;IAAG,CAAC;IAE/C,4EAA4E;IAC5E,aAAa;IACb,4EAA4E;IAE5E;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,QAAwB;QACtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CACjC,kGAAkG,CACnG,CAAC;QAEF,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC;IAED,4EAA4E;IAC5E,qDAAqD;IACrD,4EAA4E;IAE5E;;;;;;;;OAQG;IACO,gBAAgB,CAAC,KAAe;QACxC,IAAI,IAAI,GAAa,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAa,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;QAED,0EAA0E;QAC1E,iDAAiD;QACjD,OAAO,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE;YACrC,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI;YACJ,SAAS,EAAE,KAAK,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACO,iBAAiB,CAAC,KAAe;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E;;;;;;;OAOG;IACK,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,KAAe;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE9C,kCAAkC;QAClC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3D,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;CACF"}
+{"version":3,"file":"MarkdownExporter.js","sourceRoot":"","sources":["../../../../src/cognition/memory/io/MarkdownExporter.ts"],"names":[],"mappings":"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"}

package/dist/cognition/memory/io/ObsidianExporter.d.ts

@@ -21,7 +21,7 @@
  *
  * @module memory/io/ObsidianExporter
  */
-import type { ExportOptions } from './facade/types.js';
+import type { ExportOptions, ExportResult } from './facade/types.js';
 import { MarkdownExporter } from './MarkdownExporter.js';
 /** Raw row shape from the `memory_traces` table (subset used here). */
 interface TraceRow {
@@ -54,13 +54,15 @@ export declare class ObsidianExporter extends MarkdownExporter {
      * Export all memory traces as Obsidian-flavoured `.md` files.
      *
      * Pre-fetches all knowledge-edge relationships into an in-memory cache,
-     * then delegates to the parent `export()` method. Directory creation and
-     * file writing are handled there; only `buildFileContent` is overridden.
+     * then delegates to the parent `export()` method. Directory creation,
+     * file writing and the checks on each trace's path are handled there; only
+     * `buildFileContent` is overridden.
      *
      * @param outputDir - Root directory to write the Obsidian vault into.
      * @param options   - Optional export configuration.
+     * @returns The traces left out, with the reason for each.
      */
-    export(outputDir: string, options?: ExportOptions): Promise<void>;
+    export(outputDir: string, options?: ExportOptions): Promise<ExportResult>;
     /**
      * Build Obsidian-flavoured Markdown for a trace.
      *

package/dist/cognition/memory/io/ObsidianExporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObsidianExporter.d.ts","sourceRoot":"","sources":["../../../../src/cognition/memory/io/ObsidianExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOzD,uEAAuE;AACvE,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAYD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB,CAA+B;IAMzD;;;;;;;;;OASG;IACY,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhF;;;;;;;;;;OAUG;cACgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAwC5D;;;;;OAKG;YACW,qBAAqB;CA4BpC"}
+{"version":3,"file":"ObsidianExporter.d.ts","sourceRoot":"","sources":["../../../../src/cognition/memory/io/ObsidianExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOzD,uEAAuE;AACvE,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAYD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB,CAA+B;IAMzD;;;;;;;;;;;OAWG;IACY,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAUxF;;;;;;;;;;OAUG;cACgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAwC5D;;;;;OAKG;YACW,qBAAqB;CA4BpC"}

package/dist/cognition/memory/io/ObsidianExporter.js

@@ -53,16 +53,18 @@ export class ObsidianExporter extends MarkdownExporter {
      * Export all memory traces as Obsidian-flavoured `.md` files.
      *
      * Pre-fetches all knowledge-edge relationships into an in-memory cache,
-     * then delegates to the parent `export()` method. Directory creation and
-     * file writing are handled there; only `buildFileContent` is overridden.
+     * then delegates to the parent `export()` method. Directory creation,
+     * file writing and the checks on each trace's path are handled there; only
+     * `buildFileContent` is overridden.
      *
      * @param outputDir - Root directory to write the Obsidian vault into.
      * @param options   - Optional export configuration.
+     * @returns The traces left out, with the reason for each.
      */
     async export(outputDir, options) {
         // Pre-fetch all related nodes so buildFileContent can use them synchronously.
         await this._prefetchRelatedNodes();
-        await super.export(outputDir, options);
+        return super.export(outputDir, options);
     }
     // -------------------------------------------------------------------------
     // Overridden helpers

package/dist/cognition/memory/io/ObsidianExporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObsidianExporter.js","sourceRoot":"","sources":["../../../../src/cognition/memory/io/ObsidianExporter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ObsidianExporter.js","sourceRoot":"","sources":["../../../../src/cognition/memory/io/ObsidianExporter.ts"],"names":[],"mappings":"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"}

package/dist/cognition/memory/io/facade/Memory.d.ts

@@ -20,7 +20,7 @@
 import type { MemoryTrace } from '../../core/types.js';
 import type { CompileResult } from '../../../substrate/memory/wiki/types.js';
 import type { ITool } from '../../../../core/tools/ITool.js';
-import type { MemoryConfig, RememberOptions, RecallOptions, IngestOptions, IngestResult, ExportOptions, ImportOptions, ImportResult, ConsolidationResult, MemoryHealth } from './types.js';
+import type { MemoryConfig, RememberOptions, RecallOptions, IngestOptions, IngestResult, ExportOptions, ExportResult, ImportOptions, ImportResult, ConsolidationResult, MemoryHealth } from './types.js';
 import type { IKnowledgeGraph, KnowledgeEntity, KnowledgeRelation } from '../../retrieval/graph/knowledge/IKnowledgeGraph.js';
 import type { RetrievalFeedback } from '../../retrieval/feedback/RetrievalFeedbackSignal.js';
 /**
@@ -212,7 +212,10 @@ export declare class Memory {
     /**
      * Compile recent (non-wiki) traces into the markdown wiki, then re-index.
      * Reads the wiki's watermark, folds every trace created since into pages, and
-     * advances the watermark. No-op when no wiki is attached.
+     * advances the watermark. No-op when no wiki is attached. A batch whose
+     * compile rejects, such as on a page write that fails for want of disk space
+     * or permission, leaves the watermark where it was, so the next compile
+     * starts from that batch again.
      *
      * @param opts.reason - What triggered this compile (telemetry + compiler hint).
      */
@@ -300,10 +303,18 @@ export declare class Memory {
      * - `.sqlite` / `.db` -> SQLite file copy
      * - directory path -> Markdown or Obsidian (based on `options.format`)
      *
+     * A Markdown or Obsidian export writes one file per trace, in folders named
+     * after the trace's scope and type, and leaves out a trace whose scope, type
+     * or id is not a safe file or folder name, whose place in the export folder
+     * holds a link, symbolic or hard, or whose file would be an older trace's
+     * where names ignore case; the result lists each one left out. No file is
+     * written outside the export folder.
+     *
      * @param outputPath - Path to write the export to.
      * @param options    - Optional format and content controls.
+     * @returns The traces the export left out, with the reason for each.
      */
-    export(outputPath: string, options?: ExportOptions): Promise<void>;
+    export(outputPath: string, options?: ExportOptions): Promise<ExportResult>;
     /**
      * Import memory data from a file or directory.
      *

package/dist/cognition/memory/io/facade/Memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Memory.d.ts","sourceRoot":"","sources":["../../../../../src/cognition/memory/io/facade/Memory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Memory.d.ts","sourceRoot":"","sources":["../../../../../src/cognition/memory/io/facade/Memory.ts"],"names":[],"mappings":"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"}

package/dist/cognition/memory/io/facade/Memory.js

@@ -641,7 +641,10 @@ export class Memory {
     /**
      * Compile recent (non-wiki) traces into the markdown wiki, then re-index.
      * Reads the wiki's watermark, folds every trace created since into pages, and
-     * advances the watermark. No-op when no wiki is attached.
+     * advances the watermark. No-op when no wiki is attached. A batch whose
+     * compile rejects, such as on a page write that fails for want of disk space
+     * or permission, leaves the watermark where it was, so the next compile
+     * starts from that batch again.
      *
      * @param opts.reason - What triggered this compile (telemetry + compiler hint).
      */
@@ -672,7 +675,9 @@ export class Memory {
             if (traces.length < BATCH)
                 break;
         }
-        if (aggregate.pagesWritten.length > 0) {
+        // A page reported in conflicts may still be on disk (its file written before the catalog failed), so the
+        // index runs after any compile that wrote or reported a page; it re-embeds only pages whose text changed.
+        if (aggregate.pagesWritten.length > 0 || aggregate.conflicts.length > 0) {
             await this._wiki.store.index();
         }
         return aggregate;
@@ -979,8 +984,16 @@ export class Memory {
      * - `.sqlite` / `.db` -> SQLite file copy
      * - directory path -> Markdown or Obsidian (based on `options.format`)
      *
+     * A Markdown or Obsidian export writes one file per trace, in folders named
+     * after the trace's scope and type, and leaves out a trace whose scope, type
+     * or id is not a safe file or folder name, whose place in the export folder
+     * holds a link, symbolic or hard, or whose file would be an older trace's
+     * where names ignore case; the result lists each one left out. No file is
+     * written outside the export folder.
+     *
      * @param outputPath - Path to write the export to.
      * @param options    - Optional format and content controls.
+     * @returns The traces the export left out, with the reason for each.
      */
     async export(outputPath, options) {
         await this._initPromise;
@@ -990,25 +1003,23 @@ export class Memory {
                 const { JsonExporter } = await import('../JsonExporter.js');
                 const exporter = new JsonExporter(this._brain);
                 await exporter.export(outputPath, options);
-                break;
+                return { refused: [] };
             }
             case 'markdown': {
                 const { MarkdownExporter } = await import('../MarkdownExporter.js');
                 const exporter = new MarkdownExporter(this._brain);
-                await exporter.export(outputPath, options);
-                break;
+                return exporter.export(outputPath, options);
             }
             case 'obsidian': {
                 const { ObsidianExporter } = await import('../ObsidianExporter.js');
                 const exporter = new ObsidianExporter(this._brain);
-                await exporter.export(outputPath, options);
-                break;
+                return exporter.export(outputPath, options);
             }
             case 'sqlite': {
                 const { SqliteExporter } = await import('../SqliteExporter.js');
                 const exporter = new SqliteExporter(this._brain);
                 await exporter.export(outputPath, options);
-                break;
+                return { refused: [] };
             }
             default: {
                 throw new Error(`Memory.export(): unsupported format "${format}".`);