shipmyagent 1.0.239 → 1.0.243

package/bin/services/memory/runtime/Indexer.js

@@ -0,0 +1,344 @@
+/**
+ * Memory Indexer（SQLite FTS）。
+ *
+ * 关键点（中文）
+ * - 使用 SQLite + FTS5 做本地检索加速。
+ * - Markdown 仍是事实源，索引可重建。
+ */
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import { mkdirSync } from "node:fs";
+import path from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { getShipMemoryIndexPath } from "../../../main/server/env/Paths.js";
+const INDEX_SCHEMA_VERSION = 1;
+const SNIPPET_MAX_CHARS = 700;
+const CHUNK_MAX_CHARS = 1600;
+const CHUNK_OVERLAP_CHARS = 240;
+function hashText(value) {
+    return crypto.createHash("sha256").update(value).digest("hex");
+}
+function normalizeText(input) {
+    return String(input || "").replace(/\r\n/g, "\n");
+}
+function quoteFtsToken(token) {
+    return `"${token.replace(/"/g, '""')}"`;
+}
+/**
+ * 构建 FTS 查询表达式。
+ */
+export function buildFtsQuery(raw) {
+    const normalized = String(raw || "").trim();
+    if (!normalized)
+        return null;
+    const tokens = normalized
+        .replace(/[^\p{L}\p{N}_-]+/gu, " ")
+        .split(/\s+/)
+        .map((item) => item.trim())
+        .filter(Boolean)
+        .slice(0, 12);
+    if (tokens.length === 0) {
+        return null;
+    }
+    return tokens.map((token) => `${quoteFtsToken(token)}*`).join(" ");
+}
+function bm25RankToScore(rank) {
+    if (!Number.isFinite(rank)) {
+        return 0;
+    }
+    return 1 / (1 + Math.abs(rank));
+}
+function truncateText(value, maxChars) {
+    if (value.length <= maxChars) {
+        return value;
+    }
+    return value.slice(0, maxChars);
+}
+function chunkMarkdown(content) {
+    const lines = normalizeText(content).split("\n");
+    if (lines.length === 0) {
+        return [];
+    }
+    const out = [];
+    let bucket = [];
+    let chars = 0;
+    const flush = () => {
+        if (bucket.length === 0)
+            return;
+        const startLine = bucket[0]?.lineNo ?? 1;
+        const endLine = bucket[bucket.length - 1]?.lineNo ?? startLine;
+        const text = bucket.map((item) => item.line).join("\n").trim();
+        if (text) {
+            out.push({
+                startLine,
+                endLine,
+                text,
+                hash: hashText(text),
+            });
+        }
+    };
+    const carryOverlap = () => {
+        if (bucket.length === 0 || CHUNK_OVERLAP_CHARS <= 0) {
+            bucket = [];
+            chars = 0;
+            return;
+        }
+        let acc = 0;
+        const next = [];
+        for (let i = bucket.length - 1; i >= 0; i -= 1) {
+            const row = bucket[i];
+            if (!row)
+                continue;
+            acc += row.line.length + 1;
+            next.unshift(row);
+            if (acc >= CHUNK_OVERLAP_CHARS)
+                break;
+        }
+        bucket = next;
+        chars = bucket.reduce((sum, item) => sum + item.line.length + 1, 0);
+    };
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i] ?? "";
+        const rowSize = line.length + 1;
+        if (bucket.length > 0 && chars + rowSize > CHUNK_MAX_CHARS) {
+            flush();
+            carryOverlap();
+        }
+        bucket.push({ line, lineNo: i + 1 });
+        chars += rowSize;
+    }
+    flush();
+    return out;
+}
+/**
+ * MemoryIndexManager（单项目单实例）。
+ */
+export class MemoryIndexer {
+    rootPath;
+    dbPath;
+    db;
+    constructor(rootPath) {
+        this.rootPath = rootPath;
+        this.dbPath = getShipMemoryIndexPath(rootPath);
+        const dir = path.dirname(this.dbPath);
+        // 同步创建目录，保证 sqlite 可打开。
+        // 关键点（中文）：这里是启动路径，避免引入异步竞态。
+        mkdirSync(dir, { recursive: true });
+        this.db = new DatabaseSync(this.dbPath);
+        this.ensureSchema();
+    }
+    getRelativeDbPath() {
+        return path.relative(this.rootPath, this.dbPath).replace(/\\/g, "/");
+    }
+    close() {
+        this.db.close();
+    }
+    ensureSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS meta (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS files (
+        path TEXT PRIMARY KEY,
+        source TEXT NOT NULL,
+        hash TEXT NOT NULL,
+        mtime INTEGER NOT NULL,
+        size INTEGER NOT NULL
+      );
+    `);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS chunks (
+        id TEXT PRIMARY KEY,
+        path TEXT NOT NULL,
+        source TEXT NOT NULL,
+        start_line INTEGER NOT NULL,
+        end_line INTEGER NOT NULL,
+        text TEXT NOT NULL,
+        hash TEXT NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_chunks_path ON chunks(path);
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_chunks_source ON chunks(source);
+    `);
+        this.db.exec(`
+      CREATE VIRTUAL TABLE IF NOT EXISTS chunks_fts USING fts5(
+        text,
+        id UNINDEXED,
+        path UNINDEXED,
+        source UNINDEXED,
+        start_line UNINDEXED,
+        end_line UNINDEXED
+      );
+    `);
+        const schemaVersion = this.db
+            .prepare(`SELECT value FROM meta WHERE key = ?`)
+            .get("schema_version");
+        if (schemaVersion?.value !== String(INDEX_SCHEMA_VERSION)) {
+            this.db
+                .prepare(`INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value`)
+                .run("schema_version", String(INDEX_SCHEMA_VERSION));
+        }
+    }
+    listIndexedFiles() {
+        return this.db
+            .prepare(`SELECT path, hash FROM files`)
+            .all();
+    }
+    deleteFileIndex(relPath) {
+        this.db.prepare(`DELETE FROM chunks_fts WHERE path = ?`).run(relPath);
+        this.db.prepare(`DELETE FROM chunks WHERE path = ?`).run(relPath);
+        this.db.prepare(`DELETE FROM files WHERE path = ?`).run(relPath);
+    }
+    writeFileChunks(file, chunks) {
+        const now = Date.now();
+        const insertChunk = this.db.prepare(`INSERT INTO chunks (id, path, source, start_line, end_line, text, hash, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`);
+        const insertFts = this.db.prepare(`INSERT INTO chunks_fts (text, id, path, source, start_line, end_line)
+       VALUES (?, ?, ?, ?, ?, ?)`);
+        for (const chunk of chunks) {
+            const id = hashText(`${file.relPath}:${file.source}:${chunk.startLine}:${chunk.endLine}:${chunk.hash}`);
+            insertChunk.run(id, file.relPath, file.source, chunk.startLine, chunk.endLine, chunk.text, chunk.hash, now);
+            insertFts.run(chunk.text, id, file.relPath, file.source, chunk.startLine, chunk.endLine);
+        }
+    }
+    async sync(files, options) {
+        const totalFiles = files.length;
+        const force = options?.force === true;
+        const existing = new Map(this.listIndexedFiles().map((item) => [item.path, item.hash]));
+        const activePaths = new Set(files.map((item) => item.relPath));
+        let reindexedFiles = 0;
+        let removedFiles = 0;
+        let totalChunks = 0;
+        this.db.exec("BEGIN");
+        try {
+            for (const file of files) {
+                const stat = await fs.stat(file.absPath);
+                const content = normalizeText(await fs.readFile(file.absPath, "utf-8"));
+                const hash = hashText(content);
+                const prevHash = existing.get(file.relPath);
+                if (!force && prevHash === hash) {
+                    continue;
+                }
+                this.deleteFileIndex(file.relPath);
+                const chunks = chunkMarkdown(content);
+                this.writeFileChunks(file, chunks);
+                this.db
+                    .prepare(`INSERT INTO files (path, source, hash, mtime, size)
+             VALUES (?, ?, ?, ?, ?)
+             ON CONFLICT(path) DO UPDATE SET
+               source = excluded.source,
+               hash = excluded.hash,
+               mtime = excluded.mtime,
+               size = excluded.size`)
+                    .run(file.relPath, file.source, hash, stat.mtimeMs, stat.size);
+                reindexedFiles += 1;
+                totalChunks += chunks.length;
+            }
+            for (const stale of existing.keys()) {
+                if (activePaths.has(stale))
+                    continue;
+                this.deleteFileIndex(stale);
+                removedFiles += 1;
+            }
+            this.db
+                .prepare(`INSERT INTO meta (key, value) VALUES (?, ?)
+           ON CONFLICT(key) DO UPDATE SET value = excluded.value`)
+                .run("last_indexed_at", String(Date.now()));
+            this.db.exec("COMMIT");
+        }
+        catch (error) {
+            this.db.exec("ROLLBACK");
+            throw error;
+        }
+        return {
+            totalFiles,
+            reindexedFiles,
+            removedFiles,
+            totalChunks,
+        };
+    }
+    search(params) {
+        const ftsQuery = buildFtsQuery(params.query);
+        if (!ftsQuery) {
+            return [];
+        }
+        const rows = this.db
+            .prepare(`SELECT path, source, start_line, end_line, text, bm25(chunks_fts) AS rank
+         FROM chunks_fts
+         WHERE chunks_fts MATCH ?
+         ORDER BY rank ASC
+         LIMIT ?`)
+            .all(ftsQuery, Math.max(1, params.maxResults * 3));
+        const mapped = rows
+            .map((row) => {
+            const score = bm25RankToScore(row.rank);
+            const citation = row.start_line === row.end_line
+                ? `${row.path}#L${row.start_line}`
+                : `${row.path}#L${row.start_line}-L${row.end_line}`;
+            return {
+                path: row.path,
+                source: row.source,
+                startLine: row.start_line,
+                endLine: row.end_line,
+                score,
+                snippet: truncateText(row.text, SNIPPET_MAX_CHARS),
+                citation,
+            };
+        })
+            .filter((item) => item.score >= params.minScore)
+            .slice(0, params.maxResults);
+        let remain = Math.max(0, params.maxInjectedChars);
+        const clamped = [];
+        for (const item of mapped) {
+            if (remain <= 0)
+                break;
+            if (item.snippet.length <= remain) {
+                clamped.push(item);
+                remain -= item.snippet.length;
+                continue;
+            }
+            clamped.push({
+                ...item,
+                snippet: item.snippet.slice(0, remain),
+            });
+            break;
+        }
+        return clamped;
+    }
+    status() {
+        const filesRow = this.db
+            .prepare(`SELECT COUNT(*) as c FROM files`)
+            .get();
+        const chunksRow = this.db
+            .prepare(`SELECT COUNT(*) as c FROM chunks`)
+            .get();
+        const sourceRows = this.db
+            .prepare(`SELECT source, COUNT(*) as files,
+           (SELECT COUNT(*) FROM chunks c WHERE c.source = f.source) AS chunks
+         FROM files f
+         GROUP BY source`)
+            .all();
+        const orderedSources = ["longterm", "daily", "working"];
+        const sourceCounts = orderedSources.map((source) => {
+            const found = sourceRows.find((item) => item.source === source);
+            return {
+                source,
+                files: found?.files ?? 0,
+                chunks: found?.chunks ?? 0,
+            };
+        });
+        return {
+            files: filesRow?.c ?? 0,
+            chunks: chunksRow?.c ?? 0,
+            sourceCounts,
+        };
+    }
+}
+//# sourceMappingURL=Indexer.js.map

package/bin/services/memory/runtime/Indexer.js.map

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

package/bin/services/memory/runtime/Search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Search.d.ts","sourceRoot":"","sources":["../../../../src/services/memory/runtime/Search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,kCAAkC,CAAC;AAY1C;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CA2D/B"}

package/bin/services/memory/runtime/Search.js

@@ -0,0 +1,65 @@
+/**
+ * Memory Search 运行时。
+ *
+ * 关键点（中文）
+ * - 收敛检索默认参数与容错返回。
+ * - 检索前确保索引同步（dirty 时自动补齐）。
+ */
+import { MEMORY_DEFAULTS, ensureMemoryIndexed, getOrCreateMemoryState, } from "./Store.js";
+function clampNumber(value, min, max) {
+    if (!Number.isFinite(value))
+        return min;
+    return Math.max(min, Math.min(max, value));
+}
+/**
+ * 执行检索。
+ */
+export async function searchMemory(runtime, payload) {
+    const state = getOrCreateMemoryState(runtime);
+    if (!state.enabled) {
+        return {
+            backend: "builtin",
+            mode: "fts",
+            results: [],
+            disabled: true,
+            error: "memory service disabled",
+            action: "Set context.memory.enabled=true or remove the config override.",
+        };
+    }
+    const query = String(payload.query || "").trim();
+    if (!query) {
+        return {
+            backend: "builtin",
+            mode: "fts",
+            results: [],
+        };
+    }
+    const maxResults = Math.floor(clampNumber(Number(payload.maxResults ?? MEMORY_DEFAULTS.maxResults), 1, 20));
+    const minScore = clampNumber(Number(payload.minScore ?? MEMORY_DEFAULTS.minScore), 0, 1);
+    try {
+        await ensureMemoryIndexed(runtime, { reason: "search" });
+        const results = state.indexer.search({
+            query,
+            maxResults,
+            minScore,
+            maxInjectedChars: MEMORY_DEFAULTS.maxInjectedChars,
+        });
+        return {
+            backend: "builtin",
+            mode: "fts",
+            results,
+        };
+    }
+    catch (error) {
+        const message = String(error);
+        return {
+            backend: "builtin",
+            mode: "fts",
+            results: [],
+            disabled: true,
+            error: message,
+            action: "Run `sma memory index --force` to rebuild local memory index.",
+        };
+    }
+}
+//# sourceMappingURL=Search.js.map

package/bin/services/memory/runtime/Search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Search.js","sourceRoot":"","sources":["../../../../src/services/memory/runtime/Search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,SAAS,WAAW,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC1D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAuB,EACvB,OAA4B;IAE5B,MAAM,KAAK,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,yBAAyB;YAChC,MAAM,EAAE,gEAAgE;SACzE,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAC3B,WAAW,CACT,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,eAAe,CAAC,UAAU,CAAC,EACxD,CAAC,EACD,EAAE,CACH,CACF,CAAC;IACF,MAAM,QAAQ,GAAG,WAAW,CAC1B,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC,QAAQ,CAAC,EACpD,CAAC,EACD,CAAC,CACF,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACnC,KAAK;YACL,UAAU;YACV,QAAQ;YACR,gBAAgB,EAAE,eAAe,CAAC,gBAAgB;SACnD,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,KAAK;YACX,OAAO;SACR,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,+DAA+D;SACxE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/bin/services/memory/runtime/Store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../../../../src/services/memory/runtime/Store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,kCAAkC,CAAC;AAO1C,OAAO,EACL,aAAa,EACb,KAAK,qBAAqB,EAC3B,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,eAAe,EAAE,cAM7B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;IACzB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,OAAO,EAAE,aAAa,CAAC;IACvB;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B;;OAEG;IACH,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC1C;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CACtC,CAAC;AA8CF;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgD7B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAGhE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB,CAkBlF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb,IAAI,CAUN;AA4BD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB/E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B9E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAsCvC"}