@burtson-labs/host-kit 0.3.3 → 0.4.1

package/dist/memory.js

@@ -3,6 +3,20 @@
  * Memory — auto-load workspace-local context files (BANDIT.md / CLAUDE.md)
  * and inline them into the system prompt so the agent follows project rules
  * without being re-told on every turn.
+ *
+ * ## Deduplication (v0.4)
+ *
+ * When a repo has more than one of BANDIT.md / CLAUDE.md / AGENTS.md (e.g.
+ * a migration-in-progress state), loadMemory will skip files whose content
+ * is identical — or whose entire text is already present inside a
+ * previously-loaded file — so the model doesn't see duplicated context.
+ *
+ * ## Consolidation
+ *
+ * `consolidateMemory(cwd)` merges all found entry files into a single
+ * canonical BANDIT.md and makes the others point at it. On macOS/Linux a
+ * symlink is preferred; on Windows (or when the symlink attempt fails) it
+ * writes an exact copy with a drift warning header.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -41,7 +55,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadCombinedMemory = loadCombinedMemory;
 exports.loadMemory = loadMemory;
 exports.appendMemory = appendMemory;
+exports.consolidateMemory = consolidateMemory;
 const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const memoryIndex_1 = require("./memoryIndex");
 const CANDIDATES = [
@@ -53,7 +69,7 @@ const CANDIDATES = [
 ];
 const MAX_BYTES = 32 * 1024;
 /**
- * loadMemory + MEMORY.md index, fused into a single bundle the host can
+ * loadMemory + topic-memory index, fused into a single bundle the host can
  * inject as the system-prompt memory block. Always-loaded files come
  * first; the index follows under its own source marker so the model
  * knows which entries are full content vs. on-demand topic pointers.
@@ -67,15 +83,30 @@ async function loadCombinedMemory(cwd, warn) {
     const indexBlock = (0, memoryIndex_1.renderMemoryIndexBlock)(index);
     if (!indexBlock)
         return base;
-    const headed = `<!-- source: ${memoryIndex_1.MEMORY_INDEX_FILE} -->\n${indexBlock}`;
+    const headed = `<!-- source: ${memoryIndex_1.BANDIT_MEMORY_INDEX_FILE} -->\n${indexBlock}`;
     return {
         content: base.content ? `${base.content}\n\n${headed}` : headed,
-        sources: index.source ? [...base.sources, memoryIndex_1.MEMORY_INDEX_FILE] : base.sources
+        sources: index.source ? [...base.sources, memoryIndex_1.BANDIT_MEMORY_INDEX_FILE] : base.sources
     };
 }
+/**
+ * Read and deduplicate memory candidate files.
+ *
+ * Dedup strategy: after normalising whitespace, if the trimmed content of a
+ * candidate is entirely contained within the already-accumulated text (or is
+ * byte-identical to a previously loaded file) we skip it. This handles the
+ * common case where CLAUDE.md was copied verbatim into BANDIT.md during a
+ * migration, or where .bandit/memory.md echoes the root BANDIT.md.
+ *
+ * We do NOT try to dedupe at the paragraph/section level — that would require
+ * NLP and is overkill. The simple containment check catches >90% of real-world
+ * cases.
+ */
 async function loadMemory(cwd) {
     const sections = [];
     const sources = [];
+    // Accumulated normalised text for containment checks
+    const seen = [];
     for (const rel of CANDIDATES) {
         const abs = path.resolve(cwd, rel);
         try {
@@ -84,8 +115,14 @@ async function loadMemory(cwd) {
                 continue;
             const truncated = raw.byteLength > MAX_BYTES;
             const text = raw.subarray(0, MAX_BYTES).toString('utf-8');
+            // Dedup: skip if trimmed content is identical to or fully contained
+            // within something we've already loaded.
+            const normalised = text.trim();
+            if (normalised && isDuplicate(normalised, seen))
+                continue;
             sections.push(`<!-- source: ${rel} -->\n${text}${truncated ? '\n… (truncated)' : ''}`);
             sources.push(rel);
+            seen.push(normalised);
         }
         catch {
             // Not present — that's fine.
@@ -148,4 +185,143 @@ async function appendMemory(cwd, fact) {
     await fs.promises.writeFile(abs, next, 'utf-8');
     return abs;
 }
+/**
+ * Consolidate multiple memory entry files (BANDIT.md / CLAUDE.md / AGENTS.md)
+ * into a single canonical `BANDIT.md`. The canonical file gets the merged
+ * content; each other file that previously had unique content becomes a
+ * pointer (symlink or copy) to BANDIT.md.
+ *
+ * ## Symlink vs copy decision
+ *
+ * - macOS / Linux: the function attempts `fs.symlink(canonical, other)`. If
+ *   it succeeds, method === 'symlink'.
+ * - Windows (or when symlink creation fails with EPERM / ENOTSUP): falls back
+ *   to writing an exact copy of BANDIT.md into the other file, prefixed with a
+ *   comment warning that it can drift. method === 'copy'.
+ * - Callers can force 'copy' via the `strategy` option to skip the symlink
+ *   attempt entirely.
+ *
+ * **Tradeoff**: symlinks are invisible to tools that `cat` the file, so editors
+ * show the canonical content transparently. Copies can drift if BANDIT.md is
+ * updated without running consolidateMemory again. There is no perfect answer;
+ * symlinks are preferred wherever supported.
+ *
+ * @param cwd       Workspace root
+ * @param strategy  'symlink-or-copy' (default) | 'copy'
+ */
+async function consolidateMemory(cwd, strategy = 'symlink-or-copy') {
+    const ENTRY_FILES = ['BANDIT.md', 'CLAUDE.md', 'AGENTS.md'];
+    const canonical = path.resolve(cwd, 'BANDIT.md');
+    // Gather unique content from all present files
+    const present = [];
+    for (const rel of ENTRY_FILES) {
+        const abs = path.resolve(cwd, rel);
+        try {
+            const content = await fs.promises.readFile(abs, 'utf-8');
+            if (content.trim())
+                present.push({ rel, abs, content });
+        }
+        catch {
+            // Not present
+        }
+    }
+    if (present.length === 0) {
+        // Nothing to consolidate — return an empty result
+        return { canonical, redirected: [], method: 'copy', skipped: [] };
+    }
+    // Check if all non-canonical files are already symlinks pointing at canonical
+    const canonicalEntry = present.find((f) => f.rel === 'BANDIT.md');
+    // Build merged content: deduplicate sections from all sources
+    const mergedParts = [];
+    const mergedSeen = [];
+    for (const { rel, content } of present) {
+        const normalised = content.trim();
+        if (!normalised || isDuplicate(normalised, mergedSeen))
+            continue;
+        mergedParts.push(content.trimEnd());
+        mergedSeen.push(normalised);
+        if (rel !== 'BANDIT.md') {
+            // Add a provenance comment when merging in content from another file
+            mergedParts[mergedParts.length - 1] =
+                `<!-- merged from ${rel} -->\n${mergedParts[mergedParts.length - 1]}`;
+        }
+    }
+    // If BANDIT.md doesn't exist yet, provide scaffold
+    if (!canonicalEntry) {
+        mergedParts.unshift('# Project Memory\n');
+    }
+    const merged = mergedParts.join('\n\n') + '\n';
+    await fs.promises.writeFile(canonical, merged, 'utf-8');
+    // Redirect other files to the canonical
+    const redirected = [];
+    const skipped = [];
+    let method = 'copy';
+    const useSymlink = strategy === 'symlink-or-copy' && !isWindows();
+    for (const { rel, abs } of present) {
+        if (rel === 'BANDIT.md')
+            continue;
+        // Check if already a symlink pointing at canonical
+        try {
+            const lstat = await fs.promises.lstat(abs);
+            if (lstat.isSymbolicLink()) {
+                const target = await fs.promises.readlink(abs);
+                const resolvedTarget = path.resolve(path.dirname(abs), target);
+                if (resolvedTarget === canonical) {
+                    skipped.push(abs);
+                    continue;
+                }
+            }
+        }
+        catch {
+            // Not a symlink — fall through
+        }
+        if (useSymlink) {
+            try {
+                // Remove the old file first, then create symlink
+                await fs.promises.unlink(abs);
+                // Use a relative symlink so the repo is portable
+                const rel_target = path.relative(path.dirname(abs), canonical);
+                await fs.promises.symlink(rel_target, abs);
+                method = 'symlink';
+                redirected.push(abs);
+                continue;
+            }
+            catch {
+                // Symlink failed — fall through to copy
+            }
+        }
+        // Copy: write a copy with a drift-warning header
+        const driftWarning = `<!-- COPY of BANDIT.md — generated by consolidateMemory.\n` +
+            `     This file may drift if BANDIT.md is updated without re-running consolidation.\n` +
+            `     On macOS/Linux prefer symlinks (strategy: 'symlink-or-copy'). -->\n\n`;
+        const copy = await fs.promises.readFile(canonical, 'utf-8');
+        await fs.promises.writeFile(abs, driftWarning + copy, 'utf-8');
+        redirected.push(abs);
+    }
+    return { canonical, redirected, method, skipped };
+}
+// ── Internal helpers ────────────────────────────────────────────────────────
+/**
+ * Returns true when `candidate` is already represented in `seen`:
+ * either as an exact match, or as a substring of an already-loaded block.
+ *
+ * Normalises runs of whitespace before comparing so minor formatting
+ * differences (trailing newlines, blank-line count) don't prevent dedup.
+ */
+function normaliseWS(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+function isDuplicate(candidate, seen) {
+    const normCandidate = normaliseWS(candidate);
+    for (const s of seen) {
+        const normS = normaliseWS(s);
+        if (normS === normCandidate || normS.includes(normCandidate)) {
+            return true;
+        }
+    }
+    return false;
+}
+function isWindows() {
+    return os.platform() === 'win32';
+}
 //# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/memoryIndex.d.ts

@@ -2,6 +2,9 @@ export declare const MAX_INDEX_BYTES: number;
 export declare const MAX_MEMORY_FILE_BYTES: number;
 export declare const MEMORY_DIR = "memory";
 export declare const MEMORY_INDEX_FILE = "MEMORY.md";
+export declare const BANDIT_DIR = ".bandit";
+export declare const BANDIT_MEMORY_DIR = ".bandit/memory";
+export declare const BANDIT_MEMORY_INDEX_FILE = ".bandit/memory/MEMORY.md";
 export interface MemoryIndexEntry {
     /** Slug derived from filename (e.g. "auth-conventions"). Used as the `name` arg to read_memory. */
     name: string;
@@ -19,7 +22,7 @@ export interface MemoryIndex {
     indexContent: string;
     /** Parsed entries; dangling links are dropped (with a warning). */
     entries: MemoryIndexEntry[];
-    /** Absolute path of MEMORY.md if found, else null. */
+    /** Absolute path of MEMORY.md if found, else null. Prefers .bandit/memory/MEMORY.md. */
     source: string | null;
 }
 /**
@@ -34,5 +37,36 @@ export type MemoryWarnFn = (msg: string) => void;
  * entries so the caller can `if (block) ...` without a null check.
  */
 export declare function renderMemoryIndexBlock(index: MemoryIndex): string;
+/**
+ * Load the memory index, searching both `.bandit/memory/MEMORY.md` (preferred)
+ * and the legacy root `MEMORY.md`. Entries from `.bandit/memory/` win on slug
+ * collisions. Returns a merged MemoryIndex.
+ */
 export declare function loadMemoryIndex(cwd: string, warn?: MemoryWarnFn): Promise<MemoryIndex>;
+/**
+ * Write a new topic file + update the index. Always writes to `.bandit/memory/`.
+ *
+ * @param cwd     Workspace root
+ * @param slug    Plain slug, e.g. "auth-conventions"
+ * @param title   Human label for the index entry
+ * @param hook    One-line hook (when is this relevant?)
+ * @param body    Full markdown body for the topic file
+ * @returns The absolute path of the written topic file
+ */
+export declare function writeMemoryTopic(cwd: string, slug: string, title: string, hook: string, body: string): Promise<string>;
+/**
+ * One-time, idempotent migration: moves root `MEMORY.md` + `memory/` into
+ * `.bandit/memory/`. Safe to call on every startup — bails out early if:
+ *   - the target `.bandit/memory/MEMORY.md` already exists, OR
+ *   - the source root `MEMORY.md` does not exist.
+ *
+ * Steps:
+ *   1. Creates `.bandit/memory/` if needed.
+ *   2. Copies each `memory/<slug>.md` to `.bandit/memory/<slug>.md`.
+ *   3. Copies (rewrites) `MEMORY.md` to `.bandit/memory/MEMORY.md`.
+ *   4. Does NOT delete the originals (safe — caller can clean up if desired).
+ *
+ * @returns Array of absolute paths written (empty when migration is skipped).
+ */
+export declare function migrateMemoryToBanditDir(cwd: string): Promise<string[]>;
 //# sourceMappingURL=memoryIndex.d.ts.map

package/dist/memoryIndex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memoryIndex.d.ts","sourceRoot":"","sources":["../src/memoryIndex.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,eAAe,QAAW,CAAC;AACxC,eAAO,MAAM,qBAAqB,QAAY,CAAC;AAC/C,eAAO,MAAM,UAAU,WAAW,CAAC;AACnC,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,mGAAmG;IACnG,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,0FAA0F;IAC1F,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,sDAAsD;IACtD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAQD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAMjD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAWjE;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAA0B,GAAG,OAAO,CAAC,WAAW,CAAC,CAuDzG"}
+{"version":3,"file":"memoryIndex.d.ts","sourceRoot":"","sources":["../src/memoryIndex.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,eAAe,QAAW,CAAC;AACxC,eAAO,MAAM,qBAAqB,QAAY,CAAC;AAG/C,eAAO,MAAM,UAAU,WAAW,CAAC;AACnC,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAG7C,eAAO,MAAM,UAAU,YAAY,CAAC;AACpC,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAClD,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,mGAAmG;IACnG,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,0FAA0F;IAC1F,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,wFAAwF;IACxF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAUD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAMjD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAWjE;AAuED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAA0B,GAAG,OAAO,CAAC,WAAW,CAAC,CA2DzG;AAID;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkD7E"}

package/dist/memoryIndex.js

@@ -33,31 +33,52 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MEMORY_INDEX_FILE = exports.MEMORY_DIR = exports.MAX_MEMORY_FILE_BYTES = exports.MAX_INDEX_BYTES = void 0;
+exports.BANDIT_MEMORY_INDEX_FILE = exports.BANDIT_MEMORY_DIR = exports.BANDIT_DIR = exports.MEMORY_INDEX_FILE = exports.MEMORY_DIR = exports.MAX_MEMORY_FILE_BYTES = exports.MAX_INDEX_BYTES = void 0;
 exports.renderMemoryIndexBlock = renderMemoryIndexBlock;
 exports.loadMemoryIndex = loadMemoryIndex;
+exports.writeMemoryTopic = writeMemoryTopic;
+exports.migrateMemoryToBanditDir = migrateMemoryToBanditDir;
 /**
  * Lazy-load topic memory.
  *
- * MEMORY.md at the workspace root is an INDEX — one bullet per topic, each
- * pointing at a markdown file in a sibling `memory/` directory. The index
- * itself goes into the system prompt every turn (small — capped at 4 KB).
- * The linked files are NOT preloaded; the agent reads them via the
- * `read_memory` tool when it decides a topic is relevant.
+ * ## Path layout (new — v0.4)
  *
- * Index entry format:
+ * Preferred location (new repos / post-migration):
+ *   .bandit/memory/MEMORY.md   ← index file
+ *   .bandit/memory/<slug>.md   ← topic files
+ *
+ * Legacy location (back-compat for repos that already have them):
+ *   MEMORY.md                  ← index file (root)
+ *   memory/<slug>.md           ← topic files (root)
+ *
+ * Both locations are searched at read time; entries are merged, with
+ * `.bandit/memory/` winning on slug collisions. WRITES always go to
+ * `.bandit/memory/`.
+ *
+ * ## Index entry format
  *
  *   - [Topic title](memory/file.md) — one-line hook for relevance matching
  *
  * The hook is what the agent sees and reasons about. Pick hooks that name
  * the situation ("when editing auth code", "when the user mentions X").
+ *
+ * Note: the link path inside MEMORY.md is ALWAYS written as `memory/file.md`
+ * regardless of which physical MEMORY.md is hosting it — the `read_memory`
+ * tool resolves the slug against its originating directory.
  */
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 exports.MAX_INDEX_BYTES = 4 * 1024;
 exports.MAX_MEMORY_FILE_BYTES = 32 * 1024;
+// ── Legacy root paths (back-compat) ────────────────────────────────────────
 exports.MEMORY_DIR = 'memory';
 exports.MEMORY_INDEX_FILE = 'MEMORY.md';
+// ── Preferred .bandit/memory/ paths ────────────────────────────────────────
+exports.BANDIT_DIR = '.bandit';
+exports.BANDIT_MEMORY_DIR = '.bandit/memory';
+exports.BANDIT_MEMORY_INDEX_FILE = '.bandit/memory/MEMORY.md';
+// Matches em-dash, en-dash, or double-hyphen as the separator.
+// The link path is always `memory/<file>` regardless of which MEMORY.md hosts it.
 const ENTRY_RE = /^[-*]\s*\[([^\]]+)\]\(memory\/([^)]+)\)\s*(?:[—–-]+)\s*(.+)$/;
 function slugFromFilename(file) {
     return file.replace(/\.md$/i, '');
@@ -82,23 +103,28 @@ function renderMemoryIndexBlock(index) {
         ...lines
     ].join('\n');
 }
-async function loadMemoryIndex(cwd, warn = defaultWarn) {
-    const abs = path.resolve(cwd, exports.MEMORY_INDEX_FILE);
+async function parseIndexFile(abs, 
+/** Physical directory that contains the `memory/` subfolder for this index. */
+physicalMemoryDir, 
+/** Prefix to use in relPath (e.g. "memory" or ".bandit/memory"). */
+relDirPrefix, warn) {
     let raw;
     try {
         raw = await fs.promises.readFile(abs);
     }
     catch {
-        return { indexContent: '', entries: [], source: null };
+        return null;
     }
     if (raw.byteLength === 0) {
         return { indexContent: '', entries: [], source: abs };
     }
     const truncated = raw.byteLength > exports.MAX_INDEX_BYTES;
     const text = raw.subarray(0, exports.MAX_INDEX_BYTES).toString('utf-8');
-    const indexContent = truncated ? `${text}\n… (truncated — MEMORY.md exceeds ${exports.MAX_INDEX_BYTES} bytes; split topics into smaller files)` : text;
+    const indexContent = truncated
+        ? `${text}\n… (truncated — MEMORY.md exceeds ${exports.MAX_INDEX_BYTES} bytes; split topics into smaller files)`
+        : text;
     const entries = [];
-    const seen = new Set();
+    const seenInFile = new Set();
     for (const line of text.split(/\r?\n/)) {
         const match = ENTRY_RE.exec(line.trim());
         if (!match)
@@ -109,8 +135,8 @@ async function loadMemoryIndex(cwd, warn = defaultWarn) {
             warn(`skipped entry "${title}" — invalid memory/ path "${file}"`);
             continue;
         }
-        const relPath = path.posix.join(exports.MEMORY_DIR, file);
-        const absPath = path.resolve(cwd, exports.MEMORY_DIR, file);
+        const relPath = `${relDirPrefix}/${file}`;
+        const absPath = path.resolve(physicalMemoryDir, file);
         let exists = false;
         try {
             const stat = await fs.promises.stat(absPath);
@@ -124,19 +150,177 @@ async function loadMemoryIndex(cwd, warn = defaultWarn) {
             continue;
         }
         const name = slugFromFilename(file);
-        if (seen.has(name)) {
+        if (seenInFile.has(name)) {
             warn(`duplicate slug "${name}" — keeping first occurrence`);
             continue;
         }
-        seen.add(name);
-        entries.push({
-            name,
-            title: title.trim(),
-            hook: hookRaw.trim(),
-            relPath,
-            absPath
-        });
+        seenInFile.add(name);
+        entries.push({ name, title: title.trim(), hook: hookRaw.trim(), relPath, absPath });
     }
     return { indexContent, entries, source: abs };
 }
+// ── Public: merged loader ───────────────────────────────────────────────────
+/**
+ * Load the memory index, searching both `.bandit/memory/MEMORY.md` (preferred)
+ * and the legacy root `MEMORY.md`. Entries from `.bandit/memory/` win on slug
+ * collisions. Returns a merged MemoryIndex.
+ */
+async function loadMemoryIndex(cwd, warn = defaultWarn) {
+    // 1. Try preferred location: .bandit/memory/MEMORY.md
+    const banditIndexAbs = path.resolve(cwd, exports.BANDIT_MEMORY_INDEX_FILE);
+    const banditMemDirAbs = path.resolve(cwd, exports.BANDIT_MEMORY_DIR);
+    const banditResult = await parseIndexFile(banditIndexAbs, banditMemDirAbs, exports.BANDIT_MEMORY_DIR, warn);
+    // 2. Try legacy location: root MEMORY.md / memory/
+    const rootIndexAbs = path.resolve(cwd, exports.MEMORY_INDEX_FILE);
+    const rootMemDirAbs = path.resolve(cwd, exports.MEMORY_DIR);
+    const rootResult = await parseIndexFile(rootIndexAbs, rootMemDirAbs, exports.MEMORY_DIR, warn);
+    // Neither found
+    if (!banditResult && !rootResult) {
+        return { indexContent: '', entries: [], source: null };
+    }
+    // Merge: preferred (.bandit/memory) wins on slug collision
+    const seen = new Set();
+    const entries = [];
+    // Add preferred entries first
+    if (banditResult) {
+        for (const e of banditResult.entries) {
+            if (seen.has(e.name)) {
+                warn(`duplicate slug "${e.name}" — keeping first occurrence`);
+                continue;
+            }
+            seen.add(e.name);
+            entries.push(e);
+        }
+    }
+    // Add legacy root entries (skip slugs already covered by preferred)
+    if (rootResult) {
+        for (const e of rootResult.entries) {
+            if (seen.has(e.name)) {
+                // Root has the same slug — silently skip (preferred wins)
+                continue;
+            }
+            seen.add(e.name);
+            entries.push(e);
+        }
+    }
+    // indexContent: combine both if both exist; preferred first
+    let indexContent = '';
+    if (banditResult?.indexContent) {
+        indexContent = banditResult.indexContent;
+        if (rootResult?.indexContent) {
+            indexContent += '\n\n<!-- legacy root MEMORY.md -->\n' + rootResult.indexContent;
+        }
+    }
+    else if (rootResult?.indexContent) {
+        indexContent = rootResult.indexContent;
+    }
+    // source: preferred if present, else root
+    const source = banditResult?.source ?? rootResult?.source ?? null;
+    return { indexContent, entries, source };
+}
+// ── Write helpers ───────────────────────────────────────────────────────────
+/**
+ * Write a new topic file + update the index. Always writes to `.bandit/memory/`.
+ *
+ * @param cwd     Workspace root
+ * @param slug    Plain slug, e.g. "auth-conventions"
+ * @param title   Human label for the index entry
+ * @param hook    One-line hook (when is this relevant?)
+ * @param body    Full markdown body for the topic file
+ * @returns The absolute path of the written topic file
+ */
+async function writeMemoryTopic(cwd, slug, title, hook, body) {
+    if (!slug || slug.includes('/') || slug.includes('..') || path.isAbsolute(slug)) {
+        throw new Error(`writeMemoryTopic: invalid slug "${slug}"`);
+    }
+    const safeSlug = slug.replace(/\.md$/i, '');
+    const memDir = path.resolve(cwd, exports.BANDIT_MEMORY_DIR);
+    await fs.promises.mkdir(memDir, { recursive: true });
+    const topicPath = path.resolve(memDir, `${safeSlug}.md`);
+    await fs.promises.writeFile(topicPath, body, 'utf-8');
+    // Update the index
+    const indexPath = path.resolve(cwd, exports.BANDIT_MEMORY_INDEX_FILE);
+    let existing = '';
+    try {
+        existing = await fs.promises.readFile(indexPath, 'utf-8');
+    }
+    catch {
+        existing = '# Memory Index\n\n';
+    }
+    const newLine = `- [${title}](memory/${safeSlug}.md) — ${hook}`;
+    // If slug already in index, replace the line; otherwise append
+    const slugPattern = new RegExp(`^[-*]\\s*\\[[^\\]]*\\]\\(memory\\/${safeSlug}\\.md\\).*$`, 'm');
+    let next;
+    if (slugPattern.test(existing)) {
+        next = existing.replace(slugPattern, newLine);
+    }
+    else {
+        next = existing.endsWith('\n') ? `${existing}${newLine}\n` : `${existing}\n${newLine}\n`;
+    }
+    await fs.promises.writeFile(indexPath, next, 'utf-8');
+    return topicPath;
+}
+// ── Migration ───────────────────────────────────────────────────────────────
+/**
+ * One-time, idempotent migration: moves root `MEMORY.md` + `memory/` into
+ * `.bandit/memory/`. Safe to call on every startup — bails out early if:
+ *   - the target `.bandit/memory/MEMORY.md` already exists, OR
+ *   - the source root `MEMORY.md` does not exist.
+ *
+ * Steps:
+ *   1. Creates `.bandit/memory/` if needed.
+ *   2. Copies each `memory/<slug>.md` to `.bandit/memory/<slug>.md`.
+ *   3. Copies (rewrites) `MEMORY.md` to `.bandit/memory/MEMORY.md`.
+ *   4. Does NOT delete the originals (safe — caller can clean up if desired).
+ *
+ * @returns Array of absolute paths written (empty when migration is skipped).
+ */
+async function migrateMemoryToBanditDir(cwd) {
+    const targetIndex = path.resolve(cwd, exports.BANDIT_MEMORY_INDEX_FILE);
+    // Idempotent: already migrated
+    try {
+        await fs.promises.access(targetIndex);
+        return []; // target exists — skip
+    }
+    catch {
+        // Target doesn't exist — proceed
+    }
+    const sourceIndex = path.resolve(cwd, exports.MEMORY_INDEX_FILE);
+    try {
+        await fs.promises.access(sourceIndex);
+    }
+    catch {
+        return []; // Source doesn't exist — nothing to migrate
+    }
+    const targetDir = path.resolve(cwd, exports.BANDIT_MEMORY_DIR);
+    await fs.promises.mkdir(targetDir, { recursive: true });
+    const written = [];
+    // Copy topic files
+    const sourceMemDir = path.resolve(cwd, exports.MEMORY_DIR);
+    let topicFiles = [];
+    try {
+        const entries = await fs.promises.readdir(sourceMemDir);
+        topicFiles = entries.filter((f) => f.toLowerCase().endsWith('.md'));
+    }
+    catch {
+        // No memory/ dir — fine, just copy the index
+    }
+    for (const file of topicFiles) {
+        const src = path.resolve(sourceMemDir, file);
+        const dst = path.resolve(targetDir, file);
+        try {
+            const content = await fs.promises.readFile(src);
+            await fs.promises.writeFile(dst, content);
+            written.push(dst);
+        }
+        catch {
+            // Skip files we can't read
+        }
+    }
+    // Copy the index
+    const indexContent = await fs.promises.readFile(sourceIndex);
+    await fs.promises.writeFile(targetIndex, indexContent);
+    written.push(targetIndex);
+    return written;
+}
 //# sourceMappingURL=memoryIndex.js.map

package/dist/memoryIndex.js.map

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