siclaw 0.1.2 → 0.1.4

package/dist/memory/overview-generator.js

@@ -0,0 +1,233 @@
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Build a concise knowledge overview from workspace directories.
+ * Scans repos/, docs/, and investigations/ (topic files no longer injected).
+ * Pure sync filesystem scan — no DB dependency.
+ * Returns empty string if no knowledge files exist.
+ */
+export function buildKnowledgeOverview(opts) {
+    const { memoryDir, reposDir, docsDir, investigationPatterns } = opts;
+    const TOTAL_BUDGET = 1200;
+    const investigationsDir = path.join(memoryDir, "investigations");
+    const repoEntries = reposDir ? scanRepos(reposDir) : [];
+    const docEntries = docsDir ? scanDocs(docsDir) : [];
+    const investigationEntries = scanInvestigations(investigationsDir);
+    const hasPatterns = investigationPatterns && investigationPatterns.length > 0;
+    if (repoEntries.length === 0 &&
+        docEntries.length === 0 &&
+        investigationEntries.length === 0 &&
+        !hasPatterns) {
+        return "";
+    }
+    const parts = ["## Knowledge Overview"];
+    let currentLen = parts[0].length;
+    // --- Code Repositories (~400 chars budget) ---
+    if (repoEntries.length > 0) {
+        const header = "\n\n### Code Repositories\n| Repo | Files | Top languages |\n|------|-------|--------------|";
+        const rows = [];
+        let sectionLen = header.length;
+        for (const entry of repoEntries) {
+            const langs = entry.topExtensions.length > 0 ? entry.topExtensions.join(", ") : "-";
+            const row = `\n| ${entry.name} | ${entry.fileCount} | ${langs} |`;
+            if (currentLen + sectionLen + row.length > TOTAL_BUDGET - 800)
+                break; // reserve for docs + investigations + footer
+            rows.push(row);
+            sectionLen += row.length;
+        }
+        if (rows.length > 0) {
+            parts.push(header + rows.join(""));
+            currentLen += sectionLen;
+        }
+    }
+    // --- Documentation (~300 chars budget) ---
+    if (docEntries.length > 0) {
+        const header = "\n\n### Documentation\n| Category | Files |\n|----------|-------|";
+        const rows = [];
+        let sectionLen = header.length;
+        for (const entry of docEntries) {
+            const row = `\n| ${entry.category} | ${entry.fileCount} |`;
+            if (currentLen + sectionLen + row.length > TOTAL_BUDGET - 400)
+                break; // reserve for investigations + footer
+            rows.push(row);
+            sectionLen += row.length;
+        }
+        if (rows.length > 0) {
+            parts.push(header + rows.join(""));
+            currentLen += sectionLen;
+        }
+    }
+    // --- Recent Investigations (~300 chars budget) ---
+    if (investigationEntries.length > 0 || (investigationPatterns && investigationPatterns.length > 0)) {
+        const maxInvestigations = currentLen > TOTAL_BUDGET - 600 ? 3 : 5;
+        const entries = investigationEntries.slice(0, maxInvestigations);
+        const header = "\n\n### Recent Investigations";
+        const lines = entries.map(e => `\n- ${e.date}: ${e.question}`);
+        // Append pattern summary if available
+        if (investigationPatterns && investigationPatterns.length > 0) {
+            const patternStr = investigationPatterns.map(p => `${p.category} (${p.count}x)`).join(", ");
+            lines.push(`\n- Patterns: ${patternStr}`);
+        }
+        const section = header + lines.join("");
+        if (currentLen + section.length <= TOTAL_BUDGET - 100) {
+            parts.push(section);
+            currentLen += section.length;
+        }
+    }
+    // --- Footer ---
+    const hasWorkspace = repoEntries.length > 0 || docEntries.length > 0;
+    const footer = hasWorkspace
+        ? '\n\nUse `read` to view files in repos/ or docs/, or `memory_search` to find specific facts.'
+        : '\n\nUse `memory_search` to find specific facts from past sessions or investigations.';
+    parts.push(footer);
+    return parts.join("");
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Check if a Dirent is a directory, following symlinks. */
+function isDir(parentDir, entry) {
+    if (entry.isDirectory())
+        return true;
+    if (entry.isSymbolicLink()) {
+        try {
+            return fs.statSync(path.join(parentDir, entry.name)).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Scanners
+// ---------------------------------------------------------------------------
+/**
+ * Scan repos/ — list top-level subdirectories with recursive file count and top 3 extensions.
+ */
+function scanRepos(reposDir) {
+    if (!fs.existsSync(reposDir))
+        return [];
+    let entries;
+    try {
+        entries = fs.readdirSync(reposDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const repos = [];
+    for (const entry of entries) {
+        if (!isDir(reposDir, entry))
+            continue;
+        const repoPath = path.join(reposDir, entry.name);
+        const { fileCount, extensionCounts } = countFilesRecursive(repoPath);
+        const topExtensions = getTopExtensions(extensionCounts, 3);
+        repos.push({ name: entry.name, fileCount, topExtensions });
+    }
+    // Sort by file count descending
+    repos.sort((a, b) => b.fileCount - a.fileCount);
+    return repos;
+}
+/**
+ * Recursively count files and tally extensions in a directory.
+ * Skips hidden directories (starting with .) and node_modules.
+ */
+function countFilesRecursive(dir) {
+    const extensionCounts = new Map();
+    let fileCount = 0;
+    const walk = (d) => {
+        let items;
+        try {
+            items = fs.readdirSync(d, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const item of items) {
+            if (item.name.startsWith(".") || item.name === "node_modules")
+                continue;
+            if (item.isDirectory()) {
+                walk(path.join(d, item.name));
+            }
+            else if (item.isFile()) {
+                fileCount++;
+                const ext = path.extname(item.name);
+                if (ext) {
+                    extensionCounts.set(ext, (extensionCounts.get(ext) ?? 0) + 1);
+                }
+            }
+        }
+    };
+    walk(dir);
+    return { fileCount, extensionCounts };
+}
+function getTopExtensions(counts, n) {
+    return [...counts.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, n)
+        .map(([ext]) => ext);
+}
+/**
+ * Scan docs/ — list subdirectories with file counts, plus top-level files as "(root)".
+ */
+function scanDocs(docsDir) {
+    if (!fs.existsSync(docsDir))
+        return [];
+    let items;
+    try {
+        items = fs.readdirSync(docsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const entries = [];
+    let rootFileCount = 0;
+    for (const item of items) {
+        if (isDir(docsDir, item)) {
+            const subPath = path.join(docsDir, item.name);
+            const { fileCount } = countFilesRecursive(subPath);
+            entries.push({ category: item.name, fileCount });
+        }
+        else if (item.isFile() || item.isSymbolicLink()) {
+            rootFileCount++;
+        }
+    }
+    if (rootFileCount > 0) {
+        entries.push({ category: "(root)", fileCount: rootFileCount });
+    }
+    // Sort by file count descending, (root) last if tied
+    entries.sort((a, b) => b.fileCount - a.fileCount || (a.category === "(root)" ? 1 : -1));
+    return entries;
+}
+function scanInvestigations(investigationsDir) {
+    if (!fs.existsSync(investigationsDir))
+        return [];
+    let files;
+    try {
+        files = fs.readdirSync(investigationsDir).filter(f => f.endsWith(".md"));
+    }
+    catch {
+        return [];
+    }
+    // Sort by filename descending (filenames are date-based: YYYY-MM-DD-HH-MM-SS.md)
+    files.sort((a, b) => b.localeCompare(a));
+    const entries = [];
+    for (const file of files.slice(0, 5)) {
+        try {
+            // Read only first 300 bytes to extract the title
+            const content = fs.readFileSync(path.join(investigationsDir, file), "utf-8");
+            const head = content.slice(0, 300);
+            const titleMatch = head.match(/^# Investigation:\s*(.+)/m);
+            const question = titleMatch ? titleMatch[1].trim() : file.replace(/\.md$/, "");
+            // Parse date from filename (YYYY-MM-DD-HH-MM-SS.md → YYYY-MM-DD)
+            const dateMatch = file.match(/^(\d{4}-\d{2}-\d{2})/);
+            const date = dateMatch ? dateMatch[1] : "unknown";
+            entries.push({ date, question });
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=overview-generator.js.map

package/dist/memory/overview-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview-generator.js","sourceRoot":"","sources":["../../src/memory/overview-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAa7B;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAkB;IACvD,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAC;IACrE,MAAM,YAAY,GAAG,IAAI,CAAC;IAE1B,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAEjE,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;IAEnE,MAAM,WAAW,GAAG,qBAAqB,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9E,IACE,WAAW,CAAC,MAAM,KAAK,CAAC;QACxB,UAAU,CAAC,MAAM,KAAK,CAAC;QACvB,oBAAoB,CAAC,MAAM,KAAK,CAAC;QACjC,CAAC,WAAW,EACZ,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,uBAAuB,CAAC,CAAC;IAClD,IAAI,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEjC,gDAAgD;IAChD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,8FAA8F,CAAC;QAE9G,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACpF,MAAM,GAAG,GAAG,OAAO,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,SAAS,MAAM,KAAK,IAAI,CAAC;YAClE,IAAI,UAAU,GAAG,UAAU,GAAG,GAAG,CAAC,MAAM,GAAG,YAAY,GAAG,GAAG;gBAAE,MAAM,CAAC,6CAA6C;YACnH,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACf,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC;QAC3B,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACnC,UAAU,IAAI,UAAU,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,mEAAmE,CAAC;QAEnF,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,OAAO,KAAK,CAAC,QAAQ,MAAM,KAAK,CAAC,SAAS,IAAI,CAAC;YAC3D,IAAI,UAAU,GAAG,UAAU,GAAG,GAAG,CAAC,MAAM,GAAG,YAAY,GAAG,GAAG;gBAAE,MAAM,CAAC,sCAAsC;YAC5G,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACf,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC;QAC3B,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACnC,UAAU,IAAI,UAAU,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,qBAAqB,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QACnG,MAAM,iBAAiB,GAAG,UAAU,GAAG,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG,+BAA+B,CAAC;QAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE/D,sCAAsC;QACtC,IAAI,qBAAqB,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5F,KAAK,CAAC,IAAI,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAExC,IAAI,UAAU,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,GAAG,GAAG,EAAE,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,YAAY;QACzB,CAAC,CAAC,6FAA6F;QAC/F,CAAC,CAAC,sFAAsF,CAAC;IAC3F,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEnB,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAsBD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,4DAA4D;AAC5D,SAAS,KAAK,CAAC,SAAiB,EAAE,KAAgB;IAChD,IAAI,KAAK,CAAC,WAAW,EAAE;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC;YAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,KAAK,CAAC;QAAC,CAAC;IACrG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;GAEG;AACH,SAAS,SAAS,CAAC,QAAgB;IACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAExC,IAAI,OAAoB,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC;YAAE,SAAS;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACrE,MAAM,aAAa,GAAG,gBAAgB,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,GAAW;IACtC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE;QACzB,IAAI,KAAkB,CAAC;QACvB,IAAI,CAAC;YACH,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc;gBAAE,SAAS;YACxE,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAChC,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBACzB,SAAS,EAAE,CAAC;gBACZ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpC,IAAI,GAAG,EAAE,CAAC;oBACR,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA2B,EAAE,CAAS;IAC9D,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SACzB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,OAAe;IAC/B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,IAAI,KAAkB,CAAC;IACvB,IAAI,CAAC;QACH,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,EAAE,SAAS,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACnD,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAClD,aAAa,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,qDAAqD;IACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CAAC,iBAAyB;IACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjD,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzC,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,iDAAiD;YACjD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAC7E,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACnC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC3D,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAE/E,iEAAiE;YACjE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAElD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/memory/session-summarizer.d.ts

@@ -2,6 +2,7 @@
  * Session Summarizer — extracts conversation from JSONL and saves as memory markdown.
  *
  * Called during session release to persist conversation context for future memory search.
+ * saveSessionKnowledge() delegates to saveSessionMemory() (LLM topic extraction disabled).
  */
 export interface SaveSessionMemoryOpts {
     /** Path to the session directory containing .jsonl files */
@@ -11,9 +12,36 @@ export interface SaveSessionMemoryOpts {
     /** Maximum number of user/assistant messages to include (default: 15) */
     maxMessages?: number;
 }
+export interface SaveSessionKnowledgeOpts extends SaveSessionMemoryOpts {
+}
+interface ExtractedMessage {
+    role: "user" | "assistant";
+    text: string;
+}
+/**
+ * Find the most recent .jsonl file in the session directory.
+ */
+export declare function findLatestJsonl(sessionDir: string): string | null;
+/**
+ * Extract user and assistant messages from a JSONL session file.
+ */
+export declare function extractMessages(jsonlPath: string): Promise<ExtractedMessage[]>;
 /**
  * Save a session's conversation to a memory markdown file.
  *
  * @returns The written file path, or null if nothing was saved.
  */
 export declare function saveSessionMemory(opts: SaveSessionMemoryOpts): Promise<string | null>;
+/**
+ * Save session knowledge.
+ *
+ * LLM-driven topic extraction is disabled — topic files produced more noise than signal
+ * in SRE scenarios (stale state, duplicate facts, 20KB injection drowning skill instructions).
+ * Now delegates to saveSessionMemory() which writes a raw conversation dump that is still
+ * searchable via memory_search.
+ *
+ * @returns Array of saved file paths, or null if nothing was saved.
+ *          Return type must remain `string[] | null` — callers depend on it.
+ */
+export declare function saveSessionKnowledge(opts: SaveSessionKnowledgeOpts): Promise<string[] | null>;
+export {};

package/dist/memory/session-summarizer.js

@@ -2,16 +2,19 @@
  * Session Summarizer — extracts conversation from JSONL and saves as memory markdown.
  *
  * Called during session release to persist conversation context for future memory search.
+ * saveSessionKnowledge() delegates to saveSessionMemory() (LLM topic extraction disabled).
  */
 import fs from "node:fs";
 import path from "node:path";
 import readline from "node:readline";
+// NOTE: knowledge-extractor and topic-consolidator imports removed.
+// Topic extraction + consolidation disabled — see memory simplification design doc.
 const DEFAULT_MAX_MESSAGES = 15;
 const MIN_MESSAGES_TO_SAVE = 3;
 /**
  * Find the most recent .jsonl file in the session directory.
  */
-function findLatestJsonl(sessionDir) {
+export function findLatestJsonl(sessionDir) {
     let files;
     try {
         files = fs.readdirSync(sessionDir).filter((f) => f.endsWith(".jsonl"));
@@ -47,7 +50,7 @@ function extractText(content) {
 /**
  * Extract user and assistant messages from a JSONL session file.
  */
-async function extractMessages(jsonlPath) {
+export async function extractMessages(jsonlPath) {
     const messages = [];
     const stream = fs.createReadStream(jsonlPath, { encoding: "utf-8" });
     const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
@@ -136,4 +139,19 @@ export async function saveSessionMemory(opts) {
     console.log(`[session-summarizer] Saved session memory to ${finalPath} (${messages.length} messages)`);
     return finalPath;
 }
+/**
+ * Save session knowledge.
+ *
+ * LLM-driven topic extraction is disabled — topic files produced more noise than signal
+ * in SRE scenarios (stale state, duplicate facts, 20KB injection drowning skill instructions).
+ * Now delegates to saveSessionMemory() which writes a raw conversation dump that is still
+ * searchable via memory_search.
+ *
+ * @returns Array of saved file paths, or null if nothing was saved.
+ *          Return type must remain `string[] | null` — callers depend on it.
+ */
+export async function saveSessionKnowledge(opts) {
+    const raw = await saveSessionMemory(opts);
+    return raw ? [raw] : null;
+}
 //# sourceMappingURL=session-summarizer.js.map

package/dist/memory/session-summarizer.js.map

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

package/dist/memory/temporal-decay.js

@@ -9,7 +9,7 @@ export const DEFAULT_TEMPORAL_DECAY = {
     halfLifeDays: 30,
 };
 const DAY_MS = 24 * 60 * 60 * 1000;
-const DATED_MEMORY_RE = /(?:^|\/)(\d{4})-(\d{2})-(\d{2})\.md$/;
+const DATED_MEMORY_RE = /(?:^|\/)(\d{4})-(\d{2})-(\d{2})(?:-\d{4}(?:-\d+)?)?\.md$/;
 function toDecayLambda(halfLifeDays) {
     if (!Number.isFinite(halfLifeDays) || halfLifeDays <= 0)
         return 0;
@@ -33,7 +33,7 @@ function isEvergreen(filePath) {
     const normalized = filePath.replaceAll("\\", "/").replace(/^\.\//, "");
     if (normalized === "MEMORY.md" || normalized === "memory.md")
         return true;
-    // Non-dated files under memory/ are topic files (evergreen)
+    // Non-dated files under memory/ (PROFILE.md, legacy topics, user-written) are evergreen
     if (normalized.startsWith("memory/") && !DATED_MEMORY_RE.test(normalized))
         return true;
     return false;

package/dist/memory/temporal-decay.js.map

@@ -1 +1 @@
-{"version":3,"file":"temporal-decay.js","sourceRoot":"","sources":["../../src/memory/temporal-decay.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"temporal-decay.js","sourceRoot":"","sources":["../../src/memory/temporal-decay.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,OAAO,EAAE,IAAI;IACb,YAAY,EAAE,EAAE;CACjB,CAAC;AAEF,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACnC,MAAM,eAAe,GAAG,0DAA0D,CAAC;AAEnF,SAAS,aAAa,CAAC,YAAoB;IACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC;AACjC,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB;IACjC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;IAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5B,IAAI,MAAM,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,KAAK,GAAG,EAAE,CAAC;QAC1G,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvE,IAAI,UAAU,KAAK,WAAW,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC1E,wFAAwF;IACxF,IAAI,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACvF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAY,EACZ,SAAuC,EAAE,EACzC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE;IAElB,MAAM,EAAE,OAAO,GAAG,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,sBAAsB,CAAC,YAAY,EAAE,GAAG,MAAM,CAAC;IAChH,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAErD,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IAEhC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACvB,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC;QAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QACjD,OAAO,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,UAAU,EAAE,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/memory/topic-consolidator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * DISABLED — no production callsites. Reactivate when a config flag for topic
+ * consolidation is implemented (paired with knowledge-extractor.ts reactivation).
+ *
+ * Topic Consolidator — LLM-driven deduplication and merging of topic files.
+ *
+ * When topic files accumulate many date sections and facts over time, this module
+ * consolidates them: deduplicates, resolves contradictions (newer wins), and
+ * rewrites to a clean merged format.
+ *
+ * Triggered after saveSessionKnowledge when thresholds are met.
+ */
+/**
+ * Check if a topic file needs consolidation based on thresholds.
+ * Returns false if already consolidated today.
+ */
+export declare function shouldConsolidate(filePath: string): boolean;
+/**
+ * Analyze a topic file for consolidation eligibility.
+ * Returns { factCount } if consolidation is needed, null otherwise.
+ */
+export declare function analyzeTopicFile(filePath: string): {
+    factCount: number;
+} | null;
+/**
+ * Consolidate a single topic file using LLM.
+ * Reads the file, calls LLM to deduplicate and resolve contradictions,
+ * then rewrites the file in clean format.
+ */
+export declare function consolidateTopicFile(filePath: string, llmConfig: {
+    apiKey: string;
+    baseUrl: string;
+    model?: string;
+}): Promise<void>;
+/**
+ * Check modified topic files and consolidate any that exceed thresholds.
+ * Called fire-and-forget after mergeTopicFiles.
+ */
+export declare function triggerConsolidationIfNeeded(memoryDir: string, modifiedFiles: string[], llmConfig: {
+    apiKey: string;
+    baseUrl: string;
+    model?: string;
+}): Promise<void>;
+/**
+ * Scan all topic files and consolidate any that need it.
+ * Used as a catch-up check on new session creation.
+ */
+export declare function consolidateAllPending(memoryDir: string, llmConfig: {
+    apiKey: string;
+    baseUrl: string;
+    model?: string;
+}, maxFilesPerRun?: number): Promise<void>;

package/dist/memory/topic-consolidator.js

@@ -0,0 +1,197 @@
+/**
+ * DISABLED — no production callsites. Reactivate when a config flag for topic
+ * consolidation is implemented (paired with knowledge-extractor.ts reactivation).
+ *
+ * Topic Consolidator — LLM-driven deduplication and merging of topic files.
+ *
+ * When topic files accumulate many date sections and facts over time, this module
+ * consolidates them: deduplicates, resolves contradictions (newer wins), and
+ * rewrites to a clean merged format.
+ *
+ * Triggered after saveSessionKnowledge when thresholds are met.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { llmCompleteWithTool } from "../tools/deep-search/sub-agent.js";
+// ---------------------------------------------------------------------------
+// Thresholds
+// ---------------------------------------------------------------------------
+const MIN_DATE_SECTIONS = 5;
+const MIN_FACT_LINES = 20;
+// Guard against concurrent consolidation of the same file in LocalSpawner mode
+// (single process, shared filesystem). In K8s mode, topics are pod-scoped so
+// cross-pod races don't occur; the mtime optimistic lock is the safety net there.
+const consolidationInProgress = new Set();
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Check if a topic file needs consolidation based on thresholds.
+ * Returns false if already consolidated today.
+ */
+export function shouldConsolidate(filePath) {
+    return analyzeTopicFile(filePath) !== null;
+}
+/**
+ * Analyze a topic file for consolidation eligibility.
+ * Returns { factCount } if consolidation is needed, null otherwise.
+ */
+export function analyzeTopicFile(filePath) {
+    let content;
+    try {
+        content = fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    // Skip if already consolidated today
+    const consolidatedMatch = content.match(/^Last consolidated:\s*(\d{4}-\d{2}-\d{2})/m);
+    if (consolidatedMatch) {
+        const today = new Date().toISOString().slice(0, 10);
+        if (consolidatedMatch[1] === today)
+            return null;
+    }
+    const lines = content.split("\n");
+    const factCount = lines.filter(l => l.startsWith("- ")).length;
+    // Count date sections (## YYYY-MM-DD)
+    const dateSections = lines.filter(l => /^## \d{4}-\d{2}-\d{2}/.test(l)).length;
+    if (dateSections >= MIN_DATE_SECTIONS)
+        return { factCount };
+    if (factCount >= MIN_FACT_LINES)
+        return { factCount };
+    return null;
+}
+const CONSOLIDATION_SCHEMA = {
+    type: "object",
+    properties: {
+        consolidated_facts: {
+            type: "array",
+            items: { type: "string" },
+            description: "Deduplicated, merged list of facts. Each is a concise, self-contained statement.",
+        },
+        changes_summary: {
+            type: "string",
+            description: "Brief summary of what was changed (e.g. 'merged 3 duplicate facts, resolved 1 contradiction')",
+        },
+    },
+    required: ["consolidated_facts", "changes_summary"],
+};
+/**
+ * Consolidate a single topic file using LLM.
+ * Reads the file, calls LLM to deduplicate and resolve contradictions,
+ * then rewrites the file in clean format.
+ */
+export async function consolidateTopicFile(filePath, llmConfig) {
+    if (consolidationInProgress.has(filePath)) {
+        console.log(`[topic-consolidator] Skipping ${path.basename(filePath)}: consolidation already in progress`);
+        return;
+    }
+    consolidationInProgress.add(filePath);
+    try {
+        await doConsolidateTopicFile(filePath, llmConfig);
+    }
+    finally {
+        consolidationInProgress.delete(filePath);
+    }
+}
+async function doConsolidateTopicFile(filePath, llmConfig) {
+    const mtimeBefore = fs.statSync(filePath).mtimeMs;
+    const content = fs.readFileSync(filePath, "utf-8");
+    // Extract the topic title from the first heading
+    const titleMatch = content.match(/^# (.+)/m);
+    const topicTitle = titleMatch ? titleMatch[1].trim() : path.basename(filePath, ".md");
+    const prompt = `You are a knowledge consolidation system. Below is a topic file containing facts accumulated over multiple sessions. Your job is to produce a clean, deduplicated list of facts.
+
+<topic_file>
+${content}
+</topic_file>
+
+Rules:
+1. **Semantic dedup**: Merge facts that say the same thing in different words into one concise statement
+2. **Contradiction resolution**: When two facts contradict each other, keep the NEWER one (facts from date sections appearing earlier in the file are newer, as new sections are prepended)
+3. **Delete superseded facts**: If a newer fact updates/replaces an older one, only keep the newer version
+4. **Preserve all unique information**: Do NOT discard facts that are unique and non-redundant
+5. **Do NOT invent new information**: Only reorganize and deduplicate what exists
+6. **Keep facts concise and self-contained**: Each fact should be understandable on its own
+
+Call the consolidate_knowledge tool with the merged result.`;
+    const { toolArgs } = await llmCompleteWithTool(undefined, prompt, "consolidate_knowledge", "Submit consolidated knowledge facts", CONSOLIDATION_SCHEMA, { apiKey: llmConfig.apiKey, baseUrl: llmConfig.baseUrl, model: llmConfig.model });
+    if (!toolArgs || !Array.isArray(toolArgs.consolidated_facts) || toolArgs.consolidated_facts.length === 0) {
+        console.warn(`[topic-consolidator] LLM returned empty result for ${path.basename(filePath)}, skipping`);
+        return;
+    }
+    // Sanity check: reject overly aggressive consolidation (possible prompt injection or LLM error)
+    const originalFactCount = content.split("\n").filter(l => l.startsWith("- ")).length;
+    if (originalFactCount > 0 && toolArgs.consolidated_facts.length < originalFactCount * 0.3) {
+        console.warn(`[topic-consolidator] Consolidation too aggressive for ${path.basename(filePath)} (${originalFactCount} → ${toolArgs.consolidated_facts.length}), skipping`);
+        return;
+    }
+    // Optimistic lock: check mtime hasn't changed since we read the file
+    const mtimeAfter = fs.statSync(filePath).mtimeMs;
+    if (mtimeAfter !== mtimeBefore) {
+        console.warn(`[topic-consolidator] File ${path.basename(filePath)} was modified during consolidation, skipping write`);
+        return;
+    }
+    const today = new Date().toISOString().slice(0, 10);
+    const factsBlock = toolArgs.consolidated_facts.map(f => `- ${f}`).join("\n");
+    const newContent = `Last consolidated: ${today}\n# ${topicTitle}\n\n${factsBlock}\n`;
+    fs.writeFileSync(filePath, newContent, "utf-8");
+    console.log(`[topic-consolidator] Consolidated ${path.basename(filePath)}: ${toolArgs.changes_summary}`);
+}
+/**
+ * Check modified topic files and consolidate any that exceed thresholds.
+ * Called fire-and-forget after mergeTopicFiles.
+ */
+export async function triggerConsolidationIfNeeded(memoryDir, modifiedFiles, llmConfig) {
+    for (const filePath of modifiedFiles) {
+        // Only process files in topics/
+        const topicsDir = path.join(memoryDir, "topics");
+        if (!filePath.startsWith(topicsDir + path.sep))
+            continue;
+        if (shouldConsolidate(filePath)) {
+            try {
+                await consolidateTopicFile(filePath, llmConfig);
+            }
+            catch (err) {
+                console.warn(`[topic-consolidator] Failed to consolidate ${path.basename(filePath)}:`, err);
+            }
+        }
+    }
+}
+/**
+ * Scan all topic files and consolidate any that need it.
+ * Used as a catch-up check on new session creation.
+ */
+export async function consolidateAllPending(memoryDir, llmConfig, maxFilesPerRun = 5) {
+    const topicsDir = path.join(memoryDir, "topics");
+    if (!fs.existsSync(topicsDir))
+        return;
+    let files;
+    try {
+        files = fs.readdirSync(topicsDir).filter(f => f.endsWith(".md"));
+    }
+    catch {
+        return;
+    }
+    // Prioritize files with the most fact lines (highest consolidation value)
+    const candidates = files
+        .map(file => {
+        const filePath = path.join(topicsDir, file);
+        const analysis = analyzeTopicFile(filePath);
+        if (!analysis)
+            return null;
+        return { file, filePath, factCount: analysis.factCount };
+    })
+        .filter((c) => c !== null)
+        .sort((a, b) => b.factCount - a.factCount)
+        .slice(0, maxFilesPerRun);
+    for (const { file, filePath } of candidates) {
+        try {
+            await consolidateTopicFile(filePath, llmConfig);
+        }
+        catch (err) {
+            console.warn(`[topic-consolidator] Catch-up consolidation failed for ${file}:`, err);
+        }
+    }
+}
+//# sourceMappingURL=topic-consolidator.js.map