opensquid 0.5.395

package/dist/setup/migrate/auto_memory_importer.js

@@ -0,0 +1,163 @@
+/**
+ * Orchestrates the auto-memory → opensquid sync (G.6 + MAU.1).
+ *
+ * Reads every `*.md` (minus `MEMORY.md`, the index) in a source directory,
+ * parses each via the reader, and reconciles it against the libSQL MemoryStore
+ * (retire-Rust RES-5b — engine-free):
+ *   - name not present              → `store.create`  (imported)
+ *   - name present, content changed → `store.update`  (refreshed)
+ *   - name present, content same    → no-op           (skipped)
+ *
+ * Identity: the auto-memory file's frontmatter `name` field. Engine
+ * `MemoryListRow` has no `name` column, so the slug round-trips through
+ * `origin.host` via the `IMPORT_HOST_PREFIX` marker. `fetchExistingImportIndex`
+ * pages `memory.list` once and returns a `name → { id }` map; the caller passes
+ * it in via `opts.existingIndex` so iteration is purely local.
+ *
+ * Refresh detection (MAU.1): `MemoryListRow` carries no `content`, and
+ * `memoryUpdate` cannot write `origin` — so a content hash stashed in
+ * `origin.host` would go stale after an update and re-trigger forever. Instead,
+ * for an existing entry we `memoryGet({ id })` (returns the FULL body) and
+ * compare against the file body; equal → skip, differ → update. After an update
+ * the stored content matches the file, so the next run no-ops (self-terminating).
+ * `dryRun` performs NO engine reads or writes — it reports existing entries as
+ * `skipped` (a coarse preview; refresh detection needs a live read).
+ *
+ * Scope mapping (Phase-2 lock): feedback / user / reference → user-scope;
+ * project → project-scope. All imports tagged `authored_by: 'user'`
+ * (auto-memory is by definition user-authored → eviction-immune).
+ *
+ * `fileWhitelist` is the G.7 hook hand-off: when set, only basenames in the
+ * list are candidates. Undefined → all `.md` files except `MEMORY.md`.
+ *
+ * Imports from: node:fs, node:path, ./memory_store_handle.js, ./auto_memory_reader.js.
+ * Imported by: setup/cli/memory.ts, auto_memory_snapshot.ts, auto_memory_importer.test.ts.
+ */
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { folded } from './memory_store_handle.js';
+import { readAutoMemory } from './auto_memory_reader.js';
+const TYPE_TO_SCOPE = {
+    user: 'user',
+    feedback: 'user',
+    reference: 'user',
+    project: { project: '' },
+};
+/** Marker that lets us re-derive the auto-memory `name` slug from the engine row. */
+export const IMPORT_HOST_PREFIX = 'opensquid-import:auto-memory:';
+export async function importAutoMemoryDir(dir, store, opts) {
+    const allFiles = (await fs.readdir(dir)).filter((f) => f.endsWith('.md') && f !== 'MEMORY.md');
+    const files = opts.fileWhitelist
+        ? allFiles.filter((f) => opts.fileWhitelist.includes(f))
+        : allFiles;
+    const result = { imported: 0, refreshed: 0, skipped: 0, errors: [] };
+    for (const file of files) {
+        const path = join(dir, file);
+        try {
+            const parsed = await readAutoMemory(path);
+            const name = parsed.frontmatter.name;
+            const rawScope = TYPE_TO_SCOPE[parsed.frontmatter.metadata.type] ?? 'user';
+            // libSQL scope is a string tag; serialize the MemoryScope (project's value is '' here → 'project').
+            const scope = typeof rawScope === 'string' ? rawScope : 'project';
+            const existing = opts.existingIndex.get(name);
+            if (existing === undefined) {
+                if (!opts.dryRun) {
+                    const created = await store.create({
+                        name,
+                        description: parsed.frontmatter.description,
+                        body: parsed.body,
+                        scope,
+                        namespace: scope === 'project' ? (opts.namespace ?? null) : null,
+                    });
+                    // Track in-map so the same name twice in one run reconciles, not re-creates.
+                    opts.existingIndex.set(name, { id: created.id });
+                }
+                result.imported += 1;
+                continue;
+            }
+            // Existing entry. dryRun is read-free → report as skipped (coarse preview).
+            if (opts.dryRun) {
+                result.skipped += 1;
+                continue;
+            }
+            const current = await store.get(existing.id);
+            // MF.2 (H3): refresh on a body OR DESCRIPTION change. libSQL memory is content-only — the
+            // description folds into content (`description\n\nbody`), so the single folded compare covers
+            // BOTH a body and a description edit (re-index either way). A missing row (current===null) is
+            // treated as changed → re-create via update path's caller; here defensively refresh.
+            const want = folded(parsed.frontmatter.description, parsed.body);
+            if (current?.content !== want) {
+                await store.update(existing.id, {
+                    description: parsed.frontmatter.description,
+                    body: parsed.body,
+                    scope,
+                });
+                result.refreshed += 1;
+            }
+            else {
+                result.skipped += 1;
+            }
+        }
+        catch (e) {
+            result.errors.push({ path, reason: e.message });
+        }
+    }
+    return result;
+}
+/**
+ * Returns a `name → { id }` map of auto-memory entries already in the store, via
+ * `store.listImportIndex()` (which pages the libSQL memory rows + extracts the slug from the
+ * `origin:import:` marker tag). Non-import rows (no marker) are ignored.
+ *
+ * The caller passes the map to `importAutoMemoryDir` (so iteration is local) and to
+ * `pruneOrphanedImports` (MAU.2). The `{ id }` lets the importer `store.get` / `store.update` the
+ * right row on refresh.
+ */
+export async function fetchExistingImportIndex(store) {
+    // The libSQL store pages internally + maps the `origin:import:<name>` tag → {id} (RES-5a/5b).
+    return store.listImportIndex();
+}
+/**
+ * Deletion propagation (MAU.2): remove engine memories whose auto-memory source
+ * file no longer exists, so the derived recall index reflects the source.
+ *
+ * Marker-guarded: only entries in `existingIndex` (i.e. carrying the
+ * `IMPORT_HOST_PREFIX` marker) are deletion candidates — engine-native and
+ * user-`memorize`d entries are never in that map, so they are structurally
+ * unreachable here. `force: true` because import entries are tagged
+ * `authored_by: 'user'` (eviction-immune); the marker + an absent source is the
+ * authority, and pruning a derived copy does not evict a hand-authored lesson.
+ *
+ * Safety net for the on-disk set: an entry is kept if its name matches EITHER a
+ * file's frontmatter `name` (authoritative; handles name != basename) OR a
+ * file's basename. The basename fallback means a transiently-malformed file
+ * (which `readAutoMemory` would throw on) still protects its engine copy from
+ * being orphaned by a parse error.
+ *
+ * `dryRun` counts candidates without deleting.
+ */
+export async function pruneOrphanedImports(dir, store, existingIndex, opts) {
+    const files = (await fs.readdir(dir)).filter((f) => f.endsWith('.md') && f !== 'MEMORY.md');
+    const onDisk = new Set();
+    for (const f of files) {
+        onDisk.add(f.replace(/\.md$/, '')); // basename fallback (name usually == basename)
+        try {
+            const parsed = await readAutoMemory(join(dir, f));
+            onDisk.add(parsed.frontmatter.name); // authoritative name (handles name != basename)
+        }
+        catch {
+            // Malformed file → keep only the basename guard; never let a parse error
+            // orphan (delete) its engine copy.
+        }
+    }
+    let pruned = 0;
+    for (const [name, entry] of existingIndex) {
+        if (!onDisk.has(name)) {
+            if (!opts.dryRun)
+                await store.delete(entry.id);
+            pruned += 1;
+        }
+    }
+    return { pruned };
+}
+//# sourceMappingURL=auto_memory_importer.js.map

package/dist/setup/migrate/auto_memory_importer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto_memory_importer.js","sourceRoot":"","sources":["../../../src/setup/migrate/auto_memory_importer.ts"],"names":[],"mappings":"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"}

package/dist/setup/migrate/auto_memory_reader.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Parses a Claude Code auto-memory file (G.6).
+ *
+ * Auto-memory files live at `~/.claude/projects/<encoded-path>/memory/<name>.md`.
+ * Shape: YAML frontmatter delimited by `---` lines, then a markdown body.
+ *
+ *   ---
+ *   name: foo-bar
+ *   description: "..."
+ *   metadata:
+ *     type: feedback | user | project | reference
+ *     originSessionId: <uuid>      # optional
+ *     node_type: memory            # optional
+ *   ---
+ *   <markdown body, may itself contain `---` separators>
+ *
+ * Strict Zod validation on the frontmatter; the body is preserved verbatim
+ * (re-joined with `---` so embedded HRs survive the round-trip).
+ *
+ * No I/O beyond `fs.readFile`. No engine knowledge — purely a file-format
+ * parser. The importer (auto_memory_importer.ts) is the side-effect layer.
+ *
+ * Imports from: node:fs, yaml, zod.
+ * Imported by: auto_memory_importer.ts, auto_memory_reader.test.ts.
+ */
+import { z } from 'zod';
+/**
+ * Accept BOTH the current nested shape (`metadata: { type }`) and the LEGACY
+ * flat shape (`type:` at the frontmatter top level, no `metadata:` block) —
+ * older auto-memory files predate the nested convention. A `z.preprocess`
+ * normalizes the flat form into `metadata` before validation, so the
+ * "record everything" backfill (MAU.6) never drops a memory just because its
+ * frontmatter is older. The `type` data is present either way → scope stays
+ * correct (no silent mis-scope to a default).
+ */
+export declare const AutoMemoryFrontmatter: z.ZodEffects<z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    metadata: z.ZodObject<{
+        type: z.ZodEnum<["user", "feedback", "project", "reference"]>;
+        originSessionId: z.ZodOptional<z.ZodString>;
+        node_type: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "user" | "project" | "feedback" | "reference";
+        originSessionId?: string | undefined;
+        node_type?: string | undefined;
+    }, {
+        type: "user" | "project" | "feedback" | "reference";
+        originSessionId?: string | undefined;
+        node_type?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    metadata: {
+        type: "user" | "project" | "feedback" | "reference";
+        originSessionId?: string | undefined;
+        node_type?: string | undefined;
+    };
+}, {
+    name: string;
+    description: string;
+    metadata: {
+        type: "user" | "project" | "feedback" | "reference";
+        originSessionId?: string | undefined;
+        node_type?: string | undefined;
+    };
+}>, {
+    name: string;
+    description: string;
+    metadata: {
+        type: "user" | "project" | "feedback" | "reference";
+        originSessionId?: string | undefined;
+        node_type?: string | undefined;
+    };
+}, unknown>;
+export type ParsedAutoMemoryFrontmatter = z.infer<typeof AutoMemoryFrontmatter>;
+export interface ParsedAutoMemory {
+    frontmatter: ParsedAutoMemoryFrontmatter;
+    body: string;
+    source_path: string;
+}
+export declare function readAutoMemory(path: string): Promise<ParsedAutoMemory>;
+//# sourceMappingURL=auto_memory_reader.d.ts.map

package/dist/setup/migrate/auto_memory_reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto_memory_reader.d.ts","sourceRoot":"","sources":["../../../src/setup/migrate/auto_memory_reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAcjC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEhF,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,2BAA2B,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AA0BD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiB5E"}

package/dist/setup/migrate/auto_memory_reader.js

@@ -0,0 +1,99 @@
+/**
+ * Parses a Claude Code auto-memory file (G.6).
+ *
+ * Auto-memory files live at `~/.claude/projects/<encoded-path>/memory/<name>.md`.
+ * Shape: YAML frontmatter delimited by `---` lines, then a markdown body.
+ *
+ *   ---
+ *   name: foo-bar
+ *   description: "..."
+ *   metadata:
+ *     type: feedback | user | project | reference
+ *     originSessionId: <uuid>      # optional
+ *     node_type: memory            # optional
+ *   ---
+ *   <markdown body, may itself contain `---` separators>
+ *
+ * Strict Zod validation on the frontmatter; the body is preserved verbatim
+ * (re-joined with `---` so embedded HRs survive the round-trip).
+ *
+ * No I/O beyond `fs.readFile`. No engine knowledge — purely a file-format
+ * parser. The importer (auto_memory_importer.ts) is the side-effect layer.
+ *
+ * Imports from: node:fs, yaml, zod.
+ * Imported by: auto_memory_importer.ts, auto_memory_reader.test.ts.
+ */
+import { promises as fs } from 'node:fs';
+import yaml from 'yaml';
+import { z } from 'zod';
+const MemoryMetadata = z.object({
+    type: z.enum(['user', 'feedback', 'project', 'reference']),
+    originSessionId: z.string().optional(),
+    node_type: z.string().optional(),
+});
+/**
+ * Accept BOTH the current nested shape (`metadata: { type }`) and the LEGACY
+ * flat shape (`type:` at the frontmatter top level, no `metadata:` block) —
+ * older auto-memory files predate the nested convention. A `z.preprocess`
+ * normalizes the flat form into `metadata` before validation, so the
+ * "record everything" backfill (MAU.6) never drops a memory just because its
+ * frontmatter is older. The `type` data is present either way → scope stays
+ * correct (no silent mis-scope to a default).
+ */
+export const AutoMemoryFrontmatter = z.preprocess((raw) => {
+    if (raw !== null && typeof raw === 'object') {
+        const o = raw;
+        if (o.metadata === undefined && o.type !== undefined) {
+            return {
+                ...o,
+                metadata: { type: o.type, originSessionId: o.originSessionId, node_type: o.node_type },
+            };
+        }
+    }
+    return raw;
+}, z.object({ name: z.string().min(1), description: z.string().min(1), metadata: MemoryMetadata }));
+/**
+ * Line-scan splitter. We walk the file line-by-line and stop at the SECOND
+ * `---` (the closing delimiter), then return everything after it verbatim.
+ * This preserves bodies containing their own `---` thematic-break HRs —
+ * the naïve `raw.split(/^---$/m)` approach would shred those out and we'd
+ * never get them back.
+ */
+function splitFrontmatter(raw) {
+    const lines = raw.split('\n');
+    if (lines[0] !== '---')
+        return null;
+    let closeIdx = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i] === '---') {
+            closeIdx = i;
+            break;
+        }
+    }
+    if (closeIdx < 0)
+        return null;
+    return {
+        yaml: lines.slice(1, closeIdx).join('\n'),
+        body: lines.slice(closeIdx + 1).join('\n'),
+    };
+}
+export async function readAutoMemory(path) {
+    const raw = await fs.readFile(path, 'utf-8');
+    const split = splitFrontmatter(raw);
+    if (!split) {
+        throw new Error(`${path}: no YAML frontmatter (expected ---...--- block)`);
+    }
+    let fmObj;
+    try {
+        fmObj = yaml.parse(split.yaml);
+    }
+    catch (e) {
+        throw new Error(`${path}: malformed YAML in frontmatter: ${e.message}`);
+    }
+    const parsed = AutoMemoryFrontmatter.safeParse(fmObj);
+    if (!parsed.success) {
+        throw new Error(`${path}: invalid frontmatter shape: ${parsed.error.message}`);
+    }
+    return { frontmatter: parsed.data, body: split.body.trim(), source_path: path };
+}
+//# sourceMappingURL=auto_memory_reader.js.map

package/dist/setup/migrate/auto_memory_reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto_memory_reader.js","sourceRoot":"","sources":["../../../src/setup/migrate/auto_memory_reader.ts"],"names":[],"mappings":"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"}

package/dist/setup/migrate/auto_memory_snapshot.d.ts

@@ -0,0 +1,33 @@
+/**
+ * G.7 incremental auto-memory snapshot — periodic catch-up importer.
+ *
+ * Re-runs G.6's `importAutoMemoryDir` on auto-memory files modified since the
+ * last snapshot timestamp recorded at `<opensquidHome>/.last-auto-memory-snapshot`
+ * (an ASCII Number.toString() of `Date.now()` ms-precision).
+ *
+ * First-run semantics: snapshot file absent / unreadable / non-numeric → treat
+ * `lastSnapshot = 0` so every `.md` file (minus `MEMORY.md`) is considered
+ * "new" and gets the full G.6 import path. Per-file dedup via G.6's
+ * `existingNames` set still prevents re-importing names already in the engine.
+ *
+ * Atomicity note: the snapshot timestamp is written AFTER `importAutoMemoryDir`
+ * returns, even when `result.errors.length > 0`. Rationale: per-file errors are
+ * usually parse failures on malformed files (the same files would fail on the
+ * next run too). Loop-avoidance > replay-on-transient-fail for this verb. If
+ * the importer THROWS (engine-down, fs error mid-readdir), we never reach the
+ * write — so the next run still picks up the same window.
+ *
+ * Strict-greater comparison (`mtimeMs > lastSnapshot`) avoids re-importing a
+ * file modified at exactly the snapshot timestamp. The ms resolution of
+ * `Date.now()` makes simultaneous-modification edge cases statistically rare,
+ * but the strict inequality is the principled choice.
+ *
+ * Imports from: node:fs, node:path, ../../engine/client.js,
+ *   ./auto_memory_importer.js.
+ * Imported by: src/setup/cli/memory.ts, auto_memory_snapshot.test.ts.
+ */
+import { type ImportResult } from './auto_memory_importer.js';
+import type { MemoryStore } from './memory_store_handle.js';
+export declare const SNAPSHOT_FILE = ".last-auto-memory-snapshot";
+export declare function snapshotAuto(autoMemoryDir: string, opensquidHome: string, store: MemoryStore): Promise<ImportResult>;
+//# sourceMappingURL=auto_memory_snapshot.d.ts.map

package/dist/setup/migrate/auto_memory_snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto_memory_snapshot.d.ts","sourceRoot":"","sources":["../../../src/setup/migrate/auto_memory_snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,aAAa,+BAA+B,CAAC;AAY1D,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,YAAY,CAAC,CAuBvB"}

package/dist/setup/migrate/auto_memory_snapshot.js

@@ -0,0 +1,67 @@
+/**
+ * G.7 incremental auto-memory snapshot — periodic catch-up importer.
+ *
+ * Re-runs G.6's `importAutoMemoryDir` on auto-memory files modified since the
+ * last snapshot timestamp recorded at `<opensquidHome>/.last-auto-memory-snapshot`
+ * (an ASCII Number.toString() of `Date.now()` ms-precision).
+ *
+ * First-run semantics: snapshot file absent / unreadable / non-numeric → treat
+ * `lastSnapshot = 0` so every `.md` file (minus `MEMORY.md`) is considered
+ * "new" and gets the full G.6 import path. Per-file dedup via G.6's
+ * `existingNames` set still prevents re-importing names already in the engine.
+ *
+ * Atomicity note: the snapshot timestamp is written AFTER `importAutoMemoryDir`
+ * returns, even when `result.errors.length > 0`. Rationale: per-file errors are
+ * usually parse failures on malformed files (the same files would fail on the
+ * next run too). Loop-avoidance > replay-on-transient-fail for this verb. If
+ * the importer THROWS (engine-down, fs error mid-readdir), we never reach the
+ * write — so the next run still picks up the same window.
+ *
+ * Strict-greater comparison (`mtimeMs > lastSnapshot`) avoids re-importing a
+ * file modified at exactly the snapshot timestamp. The ms resolution of
+ * `Date.now()` makes simultaneous-modification edge cases statistically rare,
+ * but the strict inequality is the principled choice.
+ *
+ * Imports from: node:fs, node:path, ../../engine/client.js,
+ *   ./auto_memory_importer.js.
+ * Imported by: src/setup/cli/memory.ts, auto_memory_snapshot.test.ts.
+ */
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { resolveRecallScope } from '../../rag/scope.js';
+import { fetchExistingImportIndex, importAutoMemoryDir, } from './auto_memory_importer.js';
+export const SNAPSHOT_FILE = '.last-auto-memory-snapshot';
+async function readSnapshotTimestamp(snapshotPath) {
+    try {
+        const raw = await fs.readFile(snapshotPath, 'utf-8');
+        const n = Number(raw.trim());
+        return Number.isFinite(n) && n >= 0 ? n : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+export async function snapshotAuto(autoMemoryDir, opensquidHome, store) {
+    const snapshotPath = join(opensquidHome, SNAPSHOT_FILE);
+    const lastSnapshot = await readSnapshotTimestamp(snapshotPath);
+    const allFiles = (await fs.readdir(autoMemoryDir)).filter((f) => f.endsWith('.md') && f !== 'MEMORY.md');
+    const recent = [];
+    for (const f of allFiles) {
+        const stat = await fs.stat(join(autoMemoryDir, f));
+        if (stat.mtimeMs > lastSnapshot)
+            recent.push(f);
+    }
+    const existingIndex = await fetchExistingImportIndex(store);
+    const result = await importAutoMemoryDir(autoMemoryDir, store, {
+        dryRun: false,
+        existingIndex,
+        fileWhitelist: recent,
+        // T-memory-scope-isolation: tag `project`-scoped imports with the current project's umbrella.
+        namespace: (await resolveRecallScope()).namespace,
+    });
+    // Ensure opensquidHome exists before writing the timestamp file.
+    await fs.mkdir(opensquidHome, { recursive: true });
+    await fs.writeFile(snapshotPath, Date.now().toString(), 'utf-8');
+    return result;
+}
+//# sourceMappingURL=auto_memory_snapshot.js.map

package/dist/setup/migrate/auto_memory_snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto_memory_snapshot.js","sourceRoot":"","sources":["../../../src/setup/migrate/auto_memory_snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GAEpB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,CAAC,MAAM,aAAa,GAAG,4BAA4B,CAAC;AAE1D,KAAK,UAAU,qBAAqB,CAAC,YAAoB;IACvD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,aAAqB,EACrB,aAAqB,EACrB,KAAkB;IAElB,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CACvD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,CAC9C,CAAC;IACF,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,OAAO,GAAG,YAAY;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,KAAK,EAAE;QAC7D,MAAM,EAAE,KAAK;QACb,aAAa;QACb,aAAa,EAAE,MAAM;QACrB,8FAA8F;QAC9F,SAAS,EAAE,CAAC,MAAM,kBAAkB,EAAE,CAAC,CAAC,SAAS;KAClD,CAAC,CAAC;IACH,iEAAiE;IACjE,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/setup/migrate/memory_drift.d.ts

@@ -0,0 +1,45 @@
+/**
+ * MAU.4 — fail-loud memory drift-detector (read-only diagnosis).
+ *
+ * Compares the auto-memory source files against the engine's import-marked
+ * entries and reports divergence in three categories:
+ *   - missing  — a memory on disk that the engine has no import entry for
+ *   - stale    — present in both but the engine content differs from disk
+ *   - orphaned — an import-marked engine entry whose source .md is gone
+ *
+ * This is the clause that makes a silent "the sync never ran" impossible to
+ * recur: after a session-boundary reconcile (MAU.3) the store should be in
+ * sync, so a NON-empty drift is a real bug to surface LOUDLY
+ * ([[project_opensquid_runtime_failure_handling]]).
+ *
+ * READ-ONLY: it never writes/deletes (diagnosis only — mutation is MAU.1/2/3's
+ * job). It must NOT swallow engine errors into a falsely-clean report — engine
+ * failures propagate (throw) so the caller surfaces them, never reporting
+ * `inSync: true` on a failed probe.
+ *
+ * Stale detection mirrors MAU.1: compare `memoryGet(id).content` against the
+ * reader-trimmed file body (NOT a stored hash — `memoryUpdate` can't write a
+ * hash, so content-compare is the single source of truth).
+ *
+ * Imports from: node:fs, node:path, ../../engine/client.js,
+ *   ./auto_memory_importer.js, ./auto_memory_reader.js.
+ * Imported by: src/setup/cli/doctor.ts (memory section); memory_drift.test.ts.
+ */
+import { type MemoryStore } from './memory_store_handle.js';
+export interface MemoryDrift {
+    inSync: boolean;
+    /** On disk, no import entry in the engine. */
+    missing: string[];
+    /** In both, but engine content differs from the disk body. */
+    stale: string[];
+    /** Import-marked engine entry whose source .md is gone. */
+    orphaned: string[];
+    total: {
+        disk: number;
+        engineImported: number;
+    };
+}
+export declare function computeMemoryDrift(dir: string, store: MemoryStore): Promise<MemoryDrift>;
+/** One-line human summary for `opensquid doctor`. */
+export declare function renderMemoryDrift(d: MemoryDrift): string;
+//# sourceMappingURL=memory_drift.d.ts.map

package/dist/setup/migrate/memory_drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory_drift.d.ts","sourceRoot":"","sources":["../../../src/setup/migrate/memory_drift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGpE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CA8C9F;AAED,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAOxD"}

package/dist/setup/migrate/memory_drift.js

@@ -0,0 +1,92 @@
+/**
+ * MAU.4 — fail-loud memory drift-detector (read-only diagnosis).
+ *
+ * Compares the auto-memory source files against the engine's import-marked
+ * entries and reports divergence in three categories:
+ *   - missing  — a memory on disk that the engine has no import entry for
+ *   - stale    — present in both but the engine content differs from disk
+ *   - orphaned — an import-marked engine entry whose source .md is gone
+ *
+ * This is the clause that makes a silent "the sync never ran" impossible to
+ * recur: after a session-boundary reconcile (MAU.3) the store should be in
+ * sync, so a NON-empty drift is a real bug to surface LOUDLY
+ * ([[project_opensquid_runtime_failure_handling]]).
+ *
+ * READ-ONLY: it never writes/deletes (diagnosis only — mutation is MAU.1/2/3's
+ * job). It must NOT swallow engine errors into a falsely-clean report — engine
+ * failures propagate (throw) so the caller surfaces them, never reporting
+ * `inSync: true` on a failed probe.
+ *
+ * Stale detection mirrors MAU.1: compare `memoryGet(id).content` against the
+ * reader-trimmed file body (NOT a stored hash — `memoryUpdate` can't write a
+ * hash, so content-compare is the single source of truth).
+ *
+ * Imports from: node:fs, node:path, ../../engine/client.js,
+ *   ./auto_memory_importer.js, ./auto_memory_reader.js.
+ * Imported by: src/setup/cli/doctor.ts (memory section); memory_drift.test.ts.
+ */
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { fetchExistingImportIndex } from './auto_memory_importer.js';
+import { folded } from './memory_store_handle.js';
+import { readAutoMemory } from './auto_memory_reader.js';
+export async function computeMemoryDrift(dir, store) {
+    // Disk side: name → FOLDED content (`description\n\nbody`). libSQL memory is content-only, so the
+    // disk side MUST fold to match the stored content (comparing folded-vs-bare would report every
+    // import as stale). A malformed file (reader throws) is skipped — a reader concern, not store drift.
+    const diskByName = new Map();
+    const files = (await fs.readdir(dir)).filter((f) => f.endsWith('.md') && f !== 'MEMORY.md');
+    for (const f of files) {
+        try {
+            const parsed = await readAutoMemory(join(dir, f));
+            diskByName.set(parsed.frontmatter.name, folded(parsed.frontmatter.description, parsed.body));
+        }
+        catch {
+            // malformed frontmatter — not comparable; skip (not counted as drift here)
+        }
+    }
+    // Store side: name → { id } for import-marked entries. Errors here PROPAGATE
+    // (no catch) so a failed probe never masquerades as inSync.
+    const index = await fetchExistingImportIndex(store);
+    const missing = [];
+    const stale = [];
+    for (const [name, content] of diskByName) {
+        const entry = index.get(name);
+        if (entry === undefined) {
+            missing.push(name);
+            continue;
+        }
+        const current = await store.get(entry.id);
+        if (current?.content !== content)
+            stale.push(name);
+    }
+    const orphaned = [];
+    for (const name of index.keys()) {
+        if (!diskByName.has(name))
+            orphaned.push(name);
+    }
+    missing.sort();
+    stale.sort();
+    orphaned.sort();
+    return {
+        inSync: missing.length === 0 && stale.length === 0 && orphaned.length === 0,
+        missing,
+        stale,
+        orphaned,
+        total: { disk: diskByName.size, engineImported: index.size },
+    };
+}
+/** One-line human summary for `opensquid doctor`. */
+export function renderMemoryDrift(d) {
+    if (d.inSync)
+        return `memory: in sync (${String(d.total.engineImported)} indexed)`;
+    const parts = [];
+    if (d.missing.length > 0)
+        parts.push(`${String(d.missing.length)} missing`);
+    if (d.stale.length > 0)
+        parts.push(`${String(d.stale.length)} stale`);
+    if (d.orphaned.length > 0)
+        parts.push(`${String(d.orphaned.length)} orphaned`);
+    return `memory: DRIFT — ${parts.join(', ')} (disk ${String(d.total.disk)}, indexed ${String(d.total.engineImported)})`;
+}
+//# sourceMappingURL=memory_drift.js.map

package/dist/setup/migrate/memory_drift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory_drift.js","sourceRoot":"","sources":["../../../src/setup/migrate/memory_drift.ts"],"names":[],"mappings":"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"}