@coreyuan/vector-mind 1.0.49 → 1.0.53

package/dist/file-indexing.js

@@ -0,0 +1,243 @@
+import fs from "node:fs";
+import path from "node:path";
+import { INDEX_MAX_CODE_BYTES, INDEX_MAX_DOC_BYTES, INDEX_SKIP_MINIFIED, PENDING_FLUSH_MS, PENDING_PRUNE_EVERY, } from "./config.js";
+import { getContentChunkKind, isContentIndexableFile, isSymbolIndexableFile, looksLikeGeneratedFile, looksLikeMinifiedBundle, shouldIgnorePath, } from "./path-rules.js";
+import { extractSymbols } from "./symbols.js";
+import { logActivity } from "./activity-log.js";
+import { safeJson } from "./tool-output.js";
+let fileIndexingContext = null;
+const pendingChangeBuffer = new Map();
+let pendingChangeFlushTimer = null;
+let pendingEventsSincePrune = 0;
+export function configureFileIndexing(context) {
+    fileIndexingContext = context;
+}
+function requireFileIndexingContext() {
+    if (!fileIndexingContext)
+        throw new Error("[VectorMind] file indexing context is not configured");
+    return fileIndexingContext;
+}
+function hasDb() {
+    return !!requireFileIndexingContext().getDb();
+}
+function getDb() {
+    const db = requireFileIndexingContext().getDb();
+    if (!db)
+        throw new Error("[VectorMind] database is not initialized");
+    return db;
+}
+function getProjectRoot() {
+    return requireFileIndexingContext().getProjectRoot();
+}
+function normalizeToDbPath(inputPath) {
+    return requireFileIndexingContext().normalizeToDbPath(inputPath);
+}
+function getIndexFileSymbolsTx() {
+    return requireFileIndexingContext().getIndexFileSymbolsTx();
+}
+function getDeleteFileChunkItemsStatement() {
+    return requireFileIndexingContext().getDeleteFileChunkItemsStatement();
+}
+function getInsertMemoryItemStatement() {
+    return requireFileIndexingContext().getInsertMemoryItemStatement();
+}
+function getUpsertPendingChangeStatement() {
+    return requireFileIndexingContext().getUpsertPendingChangeStatement();
+}
+function getDeleteSymbolsForFileStatement() {
+    return requireFileIndexingContext().getDeleteSymbolsForFileStatement();
+}
+function sha256Hex(input) {
+    return requireFileIndexingContext().sha256Hex(input);
+}
+function prunePendingChanges() {
+    requireFileIndexingContext().prunePendingChanges();
+}
+function chunkTextByLines(content, opts) {
+    const lines = content.split(/\r?\n/);
+    if (lines.length === 0)
+        return [];
+    const chunks = [];
+    let startLine = 1;
+    let currentLines = [];
+    let currentChars = 0;
+    for (let idx = 0; idx < lines.length; idx++) {
+        const line = lines[idx];
+        const nextChars = currentChars + line.length + 1;
+        const nextLines = currentLines.length + 1;
+        if (currentLines.length > 0 && (nextChars > opts.maxChars || nextLines > opts.maxLines)) {
+            const endLine = startLine + currentLines.length - 1;
+            chunks.push({ startLine, endLine, content: currentLines.join("\n") });
+            startLine = idx + 1;
+            currentLines = [];
+            currentChars = 0;
+        }
+        currentLines.push(line);
+        currentChars += line.length + 1;
+    }
+    if (currentLines.length > 0) {
+        const endLine = startLine + currentLines.length - 1;
+        chunks.push({ startLine, endLine, content: currentLines.join("\n") });
+    }
+    return chunks;
+}
+function indexFileContentChunks(dbFilePath, absPath, content) {
+    const kind = getContentChunkKind(absPath);
+    if (!kind)
+        return 0;
+    const opts = kind === "code_chunk"
+        ? { maxChars: 10_000, maxLines: 200 }
+        : { maxChars: 14_000, maxLines: 260 };
+    const chunks = chunkTextByLines(content, opts);
+    const ext = path.extname(absPath).toLowerCase();
+    const metadata = safeJson({ ext });
+    const tx = getDb().transaction(() => {
+        getDeleteFileChunkItemsStatement().run(dbFilePath);
+        for (const chunk of chunks) {
+            const title = `${dbFilePath}#L${chunk.startLine}-L${chunk.endLine}`;
+            const contentHash = sha256Hex(chunk.content);
+            getInsertMemoryItemStatement().run(kind, title, chunk.content, dbFilePath, chunk.startLine, chunk.endLine, null, metadata, contentHash);
+        }
+    });
+    try {
+        tx();
+    }
+    catch (err) {
+        console.error("[vectormind] failed to index file chunks:", dbFilePath, err);
+    }
+    return chunks.length;
+}
+export function flushPendingChangeBuffer() {
+    if (!hasDb())
+        return;
+    if (pendingChangeFlushTimer) {
+        clearTimeout(pendingChangeFlushTimer);
+        pendingChangeFlushTimer = null;
+    }
+    if (!pendingChangeBuffer.size)
+        return;
+    const entries = Array.from(pendingChangeBuffer.entries());
+    pendingChangeBuffer.clear();
+    try {
+        const tx = getDb().transaction(() => {
+            for (const [filePath, event] of entries) {
+                getUpsertPendingChangeStatement().run(filePath, event);
+            }
+        });
+        tx();
+    }
+    catch (err) {
+        console.error("[vectormind] failed to flush pending change buffer:", err);
+    }
+    logActivity("pending_flush", {
+        entries: entries.length,
+        sample: entries.slice(0, 10).map(([file_path, last_event]) => ({ file_path, last_event })),
+    });
+    pendingEventsSincePrune += entries.length;
+    if (pendingEventsSincePrune >= PENDING_PRUNE_EVERY) {
+        pendingEventsSincePrune = 0;
+        prunePendingChanges();
+    }
+}
+export function recordPendingChange(absPath, event) {
+    if (shouldIgnorePath(absPath, getProjectRoot()))
+        return;
+    const track = isSymbolIndexableFile(absPath) || isContentIndexableFile(absPath);
+    if (!track)
+        return;
+    const filePath = normalizeToDbPath(absPath);
+    pendingChangeBuffer.set(filePath, event);
+    if (pendingChangeFlushTimer)
+        return;
+    if (PENDING_FLUSH_MS === 0) {
+        flushPendingChangeBuffer();
+        return;
+    }
+    pendingChangeFlushTimer = setTimeout(flushPendingChangeBuffer, PENDING_FLUSH_MS);
+}
+export function indexFile(absPath, reason) {
+    if (shouldIgnorePath(absPath, getProjectRoot()))
+        return;
+    const indexSymbols = isSymbolIndexableFile(absPath);
+    const indexContent = isContentIndexableFile(absPath);
+    if (!indexSymbols && !indexContent)
+        return;
+    const kind = getContentChunkKind(absPath);
+    if (!kind)
+        return;
+    let stat;
+    try {
+        stat = fs.statSync(absPath);
+    }
+    catch {
+        return;
+    }
+    if (!stat.isFile())
+        return;
+    const maxBytes = kind === "code_chunk" ? INDEX_MAX_CODE_BYTES : INDEX_MAX_DOC_BYTES;
+    if (maxBytes > 0 && stat.size > maxBytes)
+        return;
+    let content;
+    try {
+        content = fs.readFileSync(absPath, "utf8");
+    }
+    catch {
+        return;
+    }
+    if (content.includes("\u0000"))
+        return;
+    const ext = path.extname(absPath).toLowerCase();
+    const filePath = normalizeToDbPath(absPath);
+    if (INDEX_SKIP_MINIFIED &&
+        kind === "code_chunk" &&
+        (ext === ".js" || ext === ".mjs" || ext === ".cjs" || ext === ".css") &&
+        looksLikeMinifiedBundle(content)) {
+        logActivity("index_skip", { file_path: filePath, reason: "minified_bundle", bytes: stat.size });
+        return;
+    }
+    if (kind === "code_chunk" && stat.size >= 20_000 && looksLikeGeneratedFile(content)) {
+        logActivity("index_skip", { file_path: filePath, reason: "generated_file", bytes: stat.size });
+        return;
+    }
+    let symbolCount = 0;
+    let chunkCount = 0;
+    if (indexSymbols) {
+        const symbols = extractSymbols(absPath, content);
+        symbolCount = symbols.length;
+        try {
+            getIndexFileSymbolsTx()?.(filePath, symbols);
+        }
+        catch (err) {
+            console.error("[vectormind] failed to index symbols:", filePath, err);
+        }
+    }
+    if (indexContent) {
+        chunkCount = indexFileContentChunks(filePath, absPath, content);
+    }
+    logActivity("index_file", {
+        file_path: filePath,
+        reason,
+        symbols: symbolCount,
+        chunks: chunkCount,
+        bytes: stat.size,
+    });
+}
+export function removeFileIndexes(absPath) {
+    if (shouldIgnorePath(absPath, getProjectRoot()))
+        return;
+    const filePath = normalizeToDbPath(absPath);
+    try {
+        getDeleteSymbolsForFileStatement().run(filePath);
+    }
+    catch (err) {
+        console.error("[vectormind] failed to remove symbols:", filePath, err);
+    }
+    try {
+        getDeleteFileChunkItemsStatement().run(filePath);
+    }
+    catch (err) {
+        console.error("[vectormind] failed to remove file chunks:", filePath, err);
+    }
+    logActivity("remove_file", { file_path: filePath });
+}
+//# sourceMappingURL=file-indexing.js.map

package/dist/file-indexing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-indexing.js","sourceRoot":"","sources":["../src/file-indexing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAe5C,IAAI,mBAAmB,GAA+B,IAAI,CAAC;AAE3D,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAA8B,CAAC;AAClE,IAAI,uBAAuB,GAA0B,IAAI,CAAC;AAC1D,IAAI,uBAAuB,GAAG,CAAC,CAAC;AAEhC,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,mBAAmB,GAAG,OAAO,CAAC;AAChC,CAAC;AAED,SAAS,0BAA0B;IACjC,IAAI,CAAC,mBAAmB;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAClG,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,SAAS,KAAK;IACZ,OAAO,CAAC,CAAC,0BAA0B,EAAE,CAAC,KAAK,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,KAAK;IACZ,MAAM,EAAE,GAAG,0BAA0B,EAAE,CAAC,KAAK,EAAE,CAAC;IAChD,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACrE,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,0BAA0B,EAAE,CAAC,cAAc,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,OAAO,0BAA0B,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,qBAAqB;IAC5B,OAAO,0BAA0B,EAAE,CAAC,qBAAqB,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,gCAAgC;IACvC,OAAO,0BAA0B,EAAE,CAAC,gCAAgC,EAAE,CAAC;AACzE,CAAC;AAED,SAAS,4BAA4B;IACnC,OAAO,0BAA0B,EAAE,CAAC,4BAA4B,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,+BAA+B;IACtC,OAAO,0BAA0B,EAAE,CAAC,+BAA+B,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,gCAAgC;IACvC,OAAO,0BAA0B,EAAE,CAAC,gCAAgC,EAAE,CAAC;AACzE,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,0BAA0B,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,mBAAmB;IAC1B,0BAA0B,EAAE,CAAC,mBAAmB,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,gBAAgB,CACvB,OAAe,EACf,IAA4C;IAE5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,YAAY,GAAa,EAAE,CAAC;IAChC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,MAAM,SAAS,GAAG,YAAY,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QAE1C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,IAAI,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxF,MAAM,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtE,SAAS,GAAG,GAAG,GAAG,CAAC,CAAC;YACpB,YAAY,GAAG,EAAE,CAAC;YAClB,YAAY,GAAG,CAAC,CAAC;QACnB,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,YAAY,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AACD,SAAS,sBAAsB,CAC7B,UAAkB,EAClB,OAAe,EACf,OAAe;IAEf,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IAEpB,MAAM,IAAI,GACR,IAAI,KAAK,YAAY;QACnB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE;QACrC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAEnC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QAClC,gCAAgC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,GAAG,UAAU,KAAK,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;YACpE,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7C,4BAA4B,EAAE,CAAC,GAAG,CAChC,IAAI,EACJ,KAAK,EACL,KAAK,CAAC,OAAO,EACb,UAAU,EACV,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,OAAO,EACb,IAAI,EACJ,QAAQ,EACR,WAAW,CACZ,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,EAAE,EAAE,CAAC;IACP,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAGD,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO;IACrB,IAAI,uBAAuB,EAAE,CAAC;QAC5B,YAAY,CAAC,uBAAuB,CAAC,CAAC;QACtC,uBAAuB,GAAG,IAAI,CAAC;IACjC,CAAC;IACD,IAAI,CAAC,mBAAmB,CAAC,IAAI;QAAE,OAAO;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,mBAAmB,CAAC,KAAK,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAClC,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxC,+BAA+B,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,EAAE,EAAE,CAAC;IACP,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,qDAAqD,EAAE,GAAG,CAAC,CAAC;IAC5E,CAAC;IAED,WAAW,CAAC,eAAe,EAAE;QAC3B,OAAO,EAAE,OAAO,CAAC,MAAM;QACvB,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;KAC3F,CAAC,CAAC;IAEH,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;IAC1C,IAAI,uBAAuB,IAAI,mBAAmB,EAAE,CAAC;QACnD,uBAAuB,GAAG,CAAC,CAAC;QAC5B,mBAAmB,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,KAAyB;IAC5E,IAAI,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;QAAE,OAAO;IACxD,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,IAAI,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChF,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC5C,mBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,uBAAuB;QAAE,OAAO;IACpC,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;QAC3B,wBAAwB,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IACD,uBAAuB,GAAG,UAAU,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,MAAmB;IAC5D,IAAI,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;QAAE,OAAO;IACxD,MAAM,YAAY,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY;QAAE,OAAO;IAE3C,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;QAAE,OAAO;IAC3B,MAAM,QAAQ,GAAG,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,mBAAmB,CAAC;IACpF,IAAI,QAAQ,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,QAAQ;QAAE,OAAO;IAEjD,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO;IAEvC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC5C,IACE,mBAAmB;QACnB,IAAI,KAAK,YAAY;QACrB,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM,CAAC;QACrE,uBAAuB,CAAC,OAAO,CAAC,EAChC,CAAC;QACD,WAAW,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAChG,OAAO;IACT,CAAC;IACD,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,IAAI,MAAM,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;QACpF,WAAW,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/F,OAAO;IACT,CAAC;IAED,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC;YACH,qBAAqB,EAAE,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,UAAU,GAAG,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED,WAAW,CAAC,YAAY,EAAE;QACxB,SAAS,EAAE,QAAQ;QACnB,MAAM;QACN,OAAO,EAAE,WAAW;QACpB,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,IAAI,CAAC,IAAI;KACjB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,IAAI,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;QAAE,OAAO;IACxD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,gCAAgC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC;QACH,gCAAgC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7E,CAAC;IACD,WAAW,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/dist/fix-patterns.d.ts

@@ -0,0 +1,58 @@
+import type { ToolHandlerContext } from "./tool-handlers/context.js";
+import type { MemoryItemRow, RequirementRow } from "./types.js";
+export type FixPatternInput = {
+    symptom: string;
+    root_cause: string;
+    invariant: string;
+    applies_when?: string[];
+    avoid_regression?: string[];
+    verification?: string[];
+    verification_gaps?: string[];
+};
+export type FixPatternMatchInput = {
+    intent?: string;
+    files?: string[];
+    planned_changes?: Array<{
+        file?: string;
+        change?: string;
+        requirement_refs?: string[];
+    }>;
+    requirement?: RequirementRow | null;
+    limit?: number;
+    candidateLimit?: number;
+};
+export type RelevantFixPattern = {
+    memory_id: number;
+    symptom: string;
+    root_cause: string;
+    invariant: string;
+    applies_when: string[];
+    avoid_regression: string[];
+    relevance_score: number;
+    reason: string;
+    updated_at: string;
+};
+export type FixPatternQualitySignals = {
+    advisory_only: true;
+    does_not_control_model_reasoning: true;
+    does_not_control_host_runtime: true;
+    does_not_replace_model_judgment: true;
+    does_not_change_ok_or_safe_to_edit: true;
+    does_not_expand_requirement_scope: true;
+    relevant_fix_patterns: RelevantFixPattern[];
+    note: string;
+};
+export declare function normalizeFixPattern(input: FixPatternInput): FixPatternInput;
+export declare function buildFixPatternContent(pattern: FixPatternInput, intent: string, files: string[]): string;
+export declare function buildFixPatternMetadata(args: {
+    pattern: FixPatternInput;
+    intent: string;
+    files: string[];
+    requirement_id: number;
+    source_change_ids: number[];
+    verification?: string[];
+    verification_gaps?: string[];
+}): string | null;
+export declare function fixPatternFromRow(row: MemoryItemRow): FixPatternInput | null;
+export declare function collectRelevantFixPatterns(context: ToolHandlerContext, input: FixPatternMatchInput): RelevantFixPattern[];
+export declare function buildFixPatternQualitySignals(relevant: RelevantFixPattern[]): FixPatternQualitySignals;

package/dist/fix-patterns.js

@@ -0,0 +1,347 @@
+import { isHiddenFromDefaultRecall, parseMetadataJson } from "./memory-recall.js";
+import { oneLine, safeJson } from "./tool-output.js";
+const STOPWORDS = new Set([
+    "a",
+    "an",
+    "and",
+    "are",
+    "as",
+    "at",
+    "be",
+    "by",
+    "for",
+    "from",
+    "has",
+    "have",
+    "if",
+    "in",
+    "into",
+    "is",
+    "it",
+    "its",
+    "of",
+    "on",
+    "or",
+    "that",
+    "the",
+    "this",
+    "to",
+    "with",
+    "add",
+    "change",
+    "changed",
+    "changing",
+    "fix",
+    "path",
+    "paths",
+    "refresh",
+    "smoke",
+    "test",
+    "update",
+]);
+const GENERIC_PATH_SEGMENTS = new Set([
+    "src",
+    "lib",
+    "app",
+    "core",
+    "test",
+    "tests",
+    "spec",
+    "specs",
+    "ts",
+    "tsx",
+    "js",
+    "jsx",
+    "mjs",
+    "cjs",
+    "rs",
+    "go",
+    "py",
+    "cs",
+    "java",
+    "kt",
+    "php",
+    "rb",
+    "md",
+]);
+function normalizeText(input) {
+    return (input ?? "").normalize("NFKC").toLowerCase();
+}
+function cleanList(values, limit = 8) {
+    if (!Array.isArray(values))
+        return [];
+    const result = [];
+    for (const raw of values) {
+        if (typeof raw !== "string")
+            continue;
+        const value = raw.replace(/\s+/g, " ").trim();
+        if (!value)
+            continue;
+        result.push(value);
+        if (result.length >= limit)
+            break;
+    }
+    return result;
+}
+export function normalizeFixPattern(input) {
+    return {
+        symptom: input.symptom.replace(/\s+/g, " ").trim(),
+        root_cause: input.root_cause.replace(/\s+/g, " ").trim(),
+        invariant: input.invariant.replace(/\s+/g, " ").trim(),
+        applies_when: cleanList(input.applies_when),
+        avoid_regression: cleanList(input.avoid_regression),
+        verification: cleanList(input.verification),
+        verification_gaps: cleanList(input.verification_gaps),
+    };
+}
+export function buildFixPatternContent(pattern, intent, files) {
+    const p = normalizeFixPattern(pattern);
+    const lines = [
+        "Fix pattern advisory memory.",
+        "",
+        `Symptom: ${p.symptom}`,
+        `Root cause: ${p.root_cause}`,
+        `Invariant: ${p.invariant}`,
+    ];
+    if (p.applies_when?.length) {
+        lines.push("", "Applies when:");
+        for (const item of p.applies_when)
+            lines.push(`- ${item}`);
+    }
+    if (p.avoid_regression?.length) {
+        lines.push("", "Avoid regression:");
+        for (const item of p.avoid_regression)
+            lines.push(`- ${item}`);
+    }
+    if (p.verification?.length) {
+        lines.push("", "Verified:");
+        for (const item of p.verification)
+            lines.push(`- ${item}`);
+    }
+    if (p.verification_gaps?.length) {
+        lines.push("", "Verification gaps:");
+        for (const item of p.verification_gaps)
+            lines.push(`- ${item}`);
+    }
+    if (files.length) {
+        lines.push("", "Source files:");
+        for (const file of files.slice(0, 20))
+            lines.push(`- ${file}`);
+    }
+    lines.push("", `Source change intent: ${intent}`);
+    lines.push("", "Boundary: advisory quality signal only; do not expand the current requirement scope based only on this memory.");
+    return lines.join("\n");
+}
+export function buildFixPatternMetadata(args) {
+    const pattern = normalizeFixPattern({
+        ...args.pattern,
+        verification: args.pattern.verification?.length ? args.pattern.verification : args.verification,
+        verification_gaps: args.pattern.verification_gaps?.length
+            ? args.pattern.verification_gaps
+            : args.verification_gaps,
+    });
+    return safeJson({
+        status: "current",
+        memory_type: "fix_pattern",
+        advisory_only: true,
+        does_not_control_model_reasoning: true,
+        does_not_control_host_runtime: true,
+        does_not_replace_model_judgment: true,
+        does_not_change_ok_or_safe_to_edit: true,
+        does_not_expand_requirement_scope: true,
+        requirement_id: args.requirement_id,
+        source_change_ids: args.source_change_ids,
+        source_files: args.files,
+        source_intent_preview: oneLine(args.intent, 240),
+        fix_pattern: pattern,
+    });
+}
+function extractTokens(raw) {
+    const text = normalizeText(raw);
+    const tokens = new Set();
+    for (const token of text.match(/[a-z0-9_./:@#-]{2,}/g) ?? []) {
+        if (!STOPWORDS.has(token))
+            tokens.add(token);
+        for (const part of token.split(/[^a-z0-9]+/).filter((p) => p.length >= 2)) {
+            if (!STOPWORDS.has(part))
+                tokens.add(part);
+        }
+    }
+    for (const seq of text.match(/\p{Script=Han}+/gu) ?? []) {
+        if (seq.length >= 2 && seq.length <= 18)
+            tokens.add(seq);
+        for (const n of [2, 3, 4]) {
+            if (seq.length < n)
+                continue;
+            for (let i = 0; i <= seq.length - n; i++)
+                tokens.add(seq.slice(i, i + n));
+        }
+    }
+    return Array.from(tokens)
+        .filter((token) => token.length >= 2 && !STOPWORDS.has(token))
+        .sort((a, b) => b.length - a.length)
+        .slice(0, 80);
+}
+function pathSegments(paths) {
+    const result = new Set();
+    for (const path of paths) {
+        const normalized = normalizeText(path).replaceAll("\\", "/");
+        for (const part of normalized.split(/[/.#:_-]+/)) {
+            if (part.length >= 2 && !STOPWORDS.has(part) && !GENERIC_PATH_SEGMENTS.has(part))
+                result.add(part);
+        }
+        if (normalized && normalized.split("/").length > 1)
+            result.add(normalized);
+    }
+    return result;
+}
+function recencyWeight(updatedAt) {
+    const t = Date.parse(updatedAt.endsWith("Z") ? updatedAt : `${updatedAt}Z`);
+    if (!Number.isFinite(t))
+        return 0;
+    const ageDays = Math.max(0, (Date.now() - t) / 86_400_000);
+    if (ageDays <= 2)
+        return 1.2;
+    if (ageDays <= 14)
+        return 0.7;
+    if (ageDays <= 60)
+        return 0.35;
+    return 0;
+}
+export function fixPatternFromRow(row) {
+    const meta = parseMetadataJson(row.metadata_json);
+    const raw = meta.fix_pattern;
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const obj = raw;
+    if (typeof obj.symptom !== "string" ||
+        typeof obj.root_cause !== "string" ||
+        typeof obj.invariant !== "string") {
+        return null;
+    }
+    return normalizeFixPattern({
+        symptom: obj.symptom,
+        root_cause: obj.root_cause,
+        invariant: obj.invariant,
+        applies_when: cleanList(obj.applies_when),
+        avoid_regression: cleanList(obj.avoid_regression),
+        verification: cleanList(obj.verification),
+        verification_gaps: cleanList(obj.verification_gaps),
+    });
+}
+function matchInputText(input) {
+    const planned = (input.planned_changes ?? [])
+        .map((change) => `${change.change ?? ""} ${(change.requirement_refs ?? []).join(" ")}`)
+        .join("\n");
+    return [
+        input.intent ?? "",
+        planned,
+        input.intent || input.files?.length || planned ? "" : input.requirement?.title ?? "",
+        input.intent || input.files?.length || planned ? "" : input.requirement?.context_data ?? "",
+    ].join("\n");
+}
+function rowText(row, pattern) {
+    const meta = parseMetadataJson(row.metadata_json);
+    const sourceFiles = cleanList(meta.source_files, 40);
+    return [
+        row.title ?? "",
+        row.content,
+        pattern.symptom,
+        pattern.root_cause,
+        pattern.invariant,
+        pattern.applies_when?.join("\n") ?? "",
+        pattern.avoid_regression?.join("\n") ?? "",
+    ].join("\n");
+}
+function scoreFixPattern(row, pattern, input) {
+    const inputText = matchInputText(input);
+    const queryTokens = extractTokens(inputText);
+    if (!queryTokens.length)
+        return { score: 0, reasonParts: [] };
+    const rowNormalized = normalizeText(rowText(row, pattern));
+    let tokenMatches = 0;
+    let score = 0;
+    for (const token of queryTokens) {
+        if (!rowNormalized.includes(token))
+            continue;
+        tokenMatches += 1;
+        score += Math.min(3.2, Math.max(0.8, token.length / 3));
+    }
+    const inputPaths = pathSegments(input.files ?? []);
+    const meta = parseMetadataJson(row.metadata_json);
+    const sourceFiles = cleanList(meta.source_files, 40);
+    const sourcePathSegments = pathSegments(sourceFiles);
+    let pathMatches = 0;
+    for (const segment of inputPaths) {
+        if (sourcePathSegments.has(segment))
+            pathMatches += 1;
+    }
+    if (pathMatches)
+        score += Math.min(8, pathMatches * 2.2);
+    if (tokenMatches >= Math.min(3, queryTokens.length))
+        score += 2;
+    score += recencyWeight(row.updated_at);
+    const reasonParts = [];
+    if (tokenMatches)
+        reasonParts.push(`${tokenMatches} text tokens`);
+    if (pathMatches)
+        reasonParts.push(`${pathMatches} path terms`);
+    if (row.updated_at)
+        reasonParts.push("recentness considered");
+    return { score, reasonParts };
+}
+export function collectRelevantFixPatterns(context, input) {
+    const text = matchInputText(input).trim();
+    if (!text)
+        return [];
+    const limit = Math.max(0, Math.min(3, input.limit ?? 3));
+    if (limit <= 0)
+        return [];
+    const candidateLimit = Math.max(limit, Math.min(50, input.candidateLimit ?? 50));
+    const rows = context
+        .getDb()
+        .prepare(`SELECT id, kind, title, content, file_path, start_line, end_line, req_id, metadata_json, content_hash, created_at, updated_at
+       FROM memory_items
+       WHERE kind = 'fix_pattern'
+       ORDER BY updated_at DESC, id DESC
+       LIMIT ?`)
+        .all(candidateLimit);
+    const matches = rows
+        .filter((row) => !isHiddenFromDefaultRecall(row))
+        .map((row) => {
+        const pattern = fixPatternFromRow(row);
+        if (!pattern)
+            return null;
+        const { score, reasonParts } = scoreFixPattern(row, pattern, input);
+        if (score < 11)
+            return null;
+        return {
+            memory_id: row.id,
+            symptom: pattern.symptom,
+            root_cause: pattern.root_cause,
+            invariant: pattern.invariant,
+            applies_when: pattern.applies_when ?? [],
+            avoid_regression: pattern.avoid_regression ?? [],
+            relevance_score: Number(score.toFixed(2)),
+            reason: `Matched current intent/files against prior explicit fix_pattern memory (${reasonParts.join(", ") || "lexical overlap"}). Advisory only; do not expand current requirement scope from this signal.`,
+            updated_at: row.updated_at,
+        };
+    })
+        .filter((item) => item !== null)
+        .sort((a, b) => b.relevance_score - a.relevance_score || b.memory_id - a.memory_id)
+        .slice(0, limit);
+    return matches;
+}
+export function buildFixPatternQualitySignals(relevant) {
+    return {
+        advisory_only: true,
+        does_not_control_model_reasoning: true,
+        does_not_control_host_runtime: true,
+        does_not_replace_model_judgment: true,
+        does_not_change_ok_or_safe_to_edit: true,
+        does_not_expand_requirement_scope: true,
+        relevant_fix_patterns: relevant,
+        note: "Fix pattern matches are historical quality reminders only. They must not block work, change ok/safe flags, control host execution, or expand the current requirement scope.",
+    };
+}
+//# sourceMappingURL=fix-patterns.js.map