@coralai/sps-cli 0.89.21 → 0.90.0

package/dist/core/memory2/claudeMdRule.js

@@ -1,73 +0,0 @@
-/**
- * @module        core/memory2/claudeMdRule
- * @description   往项目 `.claude/CLAUDE.md` 幂等注入「本地记忆(memory_*)」托管块。与 codegraph
- *                同机制:只管理 START..END 之间;用户内容原样保留;不存在→追加、已存在→更新、
- *                无文件→新建。规则告诉 agent:开工先 memory_recall,收尾把可复用结论 memory_save。
- * @layer         core
- * @boundedContext memory
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-const START = '<!-- sps:memory:start — auto-managed by sps (regenerated on init/doctor); edit outside these markers -->';
-const END = '<!-- sps:memory:end -->';
-/** 块内正文(不含标记)。改规则改这里,重跑 init/doctor 即更新到所有项目。 */
-const RULE = `## Project memory — recall first, save what's reusable (MANDATORY)
-
-This project has a **local memory**: conventions, decisions, gotchas, and patterns
-that earlier workers on THIS project already learned. It has likely been built
-before — the non-obvious decisions and the traps are already recorded. **Recalling
-them is not optional; it is how you avoid repeating failures this project already
-solved and re-deciding things already settled.** The prompt only tells you HOW MANY
-memories exist — the content is NOT injected. You must pull it.
-
-**Every task, follow this protocol:**
-
-1. **Before writing any code — RECALL.** Call \`memory_recall\` with the key terms of
-   the card (mechanic/file names, the exact thing you're about to build). It returns
-   id + title + snippet for the top hits (project + global scope). Then
-   \`memory_read <id>\` the relevant ones for full text, and apply what you find.
-2. **Hit a non-obvious problem mid-task — RECALL again** with the symptom (the error,
-   the surprising behavior). Someone may have already hit and solved it.
-3. **Settled something reusable — SAVE.** After you (a) establish a convention,
-   (b) make a non-obvious decision, or (c) hit a gotcha worth not repeating, call
-   \`memory_save\` with a short \`title\` + concise \`body\` + \`category\`
-   (convention/decision/gotcha/pattern/reference/note). Default scope = this project;
-   only \`scope: "global"\` for something true across ALL projects.
-
-A worker who recalls first is faster and never re-discovers a solved failure on the
-user's time. Skipping recall = repeating known mistakes.
-
-If the \`memory_*\` tools aren't in your session, use the shell:
-\`sps memory recall <project> "<query>"\` / \`sps memory save <project> --title "…" --body "…"\`.
-
-**Never save:** secrets/tokens/credentials, deploy addresses, customer data, full
-paths with sensitive data, or anything the code/git history already records.`;
-function escapeRegex(s) {
-    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-/**
- * 幂等确保 `<repoDir>/.claude/CLAUDE.md` 含记忆托管块。
- * @returns created=新建文件 / appended=追加块 / updated=更新块 / unchanged=已最新。
- */
-export function ensureMemoryRuleBlock(repoDir) {
-    const claudeMd = join(repoDir, '.claude', 'CLAUDE.md');
-    const block = `${START}\n\n${RULE}\n\n${END}`;
-    if (!existsSync(claudeMd)) {
-        mkdirSync(dirname(claudeMd), { recursive: true });
-        writeFileSync(claudeMd, `# Project Rules (Claude Code Worker)\n\n${block}\n`);
-        return 'created';
-    }
-    const content = readFileSync(claudeMd, 'utf-8');
-    const re = new RegExp(`${escapeRegex(START)}[\\s\\S]*?${escapeRegex(END)}`);
-    if (re.test(content)) {
-        const next = content.replace(re, block);
-        if (next === content)
-            return 'unchanged';
-        writeFileSync(claudeMd, next);
-        return 'updated';
-    }
-    const sep = content.endsWith('\n') ? '\n' : '\n\n';
-    writeFileSync(claudeMd, `${content}${sep}${block}\n`);
-    return 'appended';
-}
-//# sourceMappingURL=claudeMdRule.js.map

package/dist/core/memory2/claudeMdRule.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"claudeMdRule.js","sourceRoot":"","sources":["../../../src/core/memory2/claudeMdRule.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,KAAK,GAAG,0GAA0G,CAAC;AACzH,MAAM,GAAG,GAAG,yBAAyB,CAAC;AAEtC,iDAAiD;AACjD,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6EA8BgE,CAAC;AAE9E,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAID;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,GAAG,KAAK,OAAO,IAAI,OAAO,GAAG,EAAE,CAAC;IAE9C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,aAAa,CAAC,QAAQ,EAAE,2CAA2C,KAAK,IAAI,CAAC,CAAC;QAC9E,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,aAAa,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5E,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACxC,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,WAAW,CAAC;QACzC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IACnD,aAAa,CAAC,QAAQ,EAAE,GAAG,OAAO,GAAG,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC;IACtD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/core/memory2/ftsIndex.d.ts

@@ -1,8 +0,0 @@
-import { type SearchHit, type SearchOpts } from './retrieve.js';
-import type { ScopeRef } from './types.js';
-/**
- * FTS5 检索。返回 SearchHit[] 表示"走了 DB 路";返回 null 表示"未启用/不可用"→ 调用方回退内存。
- * 排序仍用内存 searchEntries(FTS 仅预筛候选),故结果与纯内存一致。
- */
-export declare function ftsRecall(refs: ScopeRef[], query: string, opts?: SearchOpts): SearchHit[] | null;
-//# sourceMappingURL=ftsIndex.d.ts.map

package/dist/core/memory2/ftsIndex.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ftsIndex.d.ts","sourceRoot":"","sources":["../../../src/core/memory2/ftsIndex.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAA2B,MAAM,eAAe,CAAC;AAEzF,OAAO,KAAK,EAAe,QAAQ,EAAE,MAAM,YAAY,CAAC;AAoHxD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,SAAS,EAAE,GAAG,IAAI,CAgCpG"}

package/dist/core/memory2/ftsIndex.js

@@ -1,172 +0,0 @@
-/**
- * @module        core/memory2/ftsIndex
- * @description   可选 FTS5 加速层(设计 §4 第二级)。**markdown 仍是唯一真源**,本索引是**派生、可重建**的
- *                只读加速器:大 store 时用 FTS5 把候选从几千缩到几十,排序仍交给内存 BM25(searchEntries)
- *                → 结果与纯内存一致、只更快。门控:node:sqlite 可用(Node 22.5+)+ 条目数 ≥ 阈值 +
- *                未被 SPS_MEMORY_INDEX=off 关;任一不满足或任何异常 → 返回 null,调用方静默回退内存。
- *                与 codegraph 共用 `node:sqlite`;索引落 `~/.coral/memory/index.db`。
- * @layer         core
- * @boundedContext memory
- */
-import { existsSync, readdirSync, statSync } from 'node:fs';
-import { createRequire } from 'node:module';
-import { join } from 'node:path';
-import { searchEntries, tokenize } from './retrieve.js';
-import { listAllScopes, listEntries, memoryRoot, scopeDir } from './store.js';
-/** 条目数达到此阈值才值得用 FTS5('auto' 模式下);'on' 忽略阈值。 */
-const INDEX_MIN_ENTRIES = 500;
-function indexMode() {
-    const v = (process.env.SPS_MEMORY_INDEX ?? 'auto').toLowerCase();
-    return v === 'off' ? 'off' : v === 'on' ? 'on' : 'auto';
-}
-// node:sqlite 惰性探测(旧 Node < 22.5 不存在)。undefined=没试过,null=不可用。
-const nodeRequire = createRequire(import.meta.url);
-let DatabaseSyncCtor;
-function loadSqlite() {
-    if (DatabaseSyncCtor === undefined) {
-        try {
-            DatabaseSyncCtor = nodeRequire('node:sqlite').DatabaseSync ?? null;
-        }
-        catch {
-            DatabaseSyncCtor = null; // 旧 Node / 未编译 sqlite → 回退内存
-        }
-    }
-    return DatabaseSyncCtor;
-}
-function indexPath() { return join(memoryRoot(), 'index.db'); }
-/** 全库指纹(不解析正文,只 readdir+stat):文件总数 + 最新 mtime。变了就重建。 */
-function fingerprint() {
-    let count = 0;
-    let maxMtime = 0;
-    for (const ref of listAllScopes()) {
-        const dir = join(scopeDir(ref), 'entries');
-        if (!existsSync(dir))
-            continue;
-        for (const name of readdirSync(dir)) {
-            if (!name.endsWith('.md'))
-                continue;
-            count++;
-            try {
-                const m = statSync(join(dir, name)).mtimeMs;
-                if (m > maxMtime)
-                    maxMtime = m;
-            }
-            catch { /* 文件刚被删 */ }
-        }
-    }
-    return { count, maxMtime };
-}
-function openDb() {
-    const Ctor = loadSqlite();
-    if (!Ctor)
-        return null;
-    try {
-        const db = new Ctor(indexPath());
-        db.exec(`
-      CREATE TABLE IF NOT EXISTS meta (k TEXT PRIMARY KEY, v TEXT);
-      CREATE TABLE IF NOT EXISTS entries (
-        id TEXT PRIMARY KEY, scope TEXT, project TEXT, agentId TEXT,
-        title TEXT, tags TEXT, category TEXT, source TEXT, salience INTEGER,
-        created TEXT, updated TEXT, body TEXT
-      );
-      CREATE VIRTUAL TABLE IF NOT EXISTS fts USING fts5(id UNINDEXED, tokens);
-    `);
-        return db;
-    }
-    catch {
-        return null; // fts5 不可用 / 打不开 → 回退内存
-    }
-}
-/** 若指纹变化则全量重建索引(markdown → DB)。 */
-function ensureFresh(db) {
-    const fp = fingerprint();
-    const stored = db.prepare('SELECT v FROM meta WHERE k=?').get('fingerprint')?.v;
-    const cur = `${fp.count}:${Math.round(fp.maxMtime)}`;
-    if (stored === cur)
-        return;
-    db.exec('DELETE FROM entries; DELETE FROM fts;');
-    const insE = db.prepare(`INSERT INTO entries (id,scope,project,agentId,title,tags,category,source,salience,created,updated,body)
-    VALUES (?,?,?,?,?,?,?,?,?,?,?,?)`);
-    const insF = db.prepare('INSERT INTO fts (id, tokens) VALUES (?, ?)');
-    for (const ref of listAllScopes()) {
-        for (const e of listEntries(ref)) {
-            insE.run(e.id, e.scope, e.project ?? null, ref.scope === 'agent' ? ref.agentId : null, e.title, JSON.stringify(e.tags), e.category, e.source, e.salience, e.created, e.updated, e.body);
-            insF.run(e.id, tokenize(`${e.title} ${e.tags.join(' ')} ${e.body}`).join(' '));
-        }
-    }
-    db.prepare('INSERT OR REPLACE INTO meta (k,v) VALUES (?,?)').run('fingerprint', cur);
-}
-function rowToEntry(r) {
-    return {
-        id: String(r.id), title: String(r.title), scope: r.scope,
-        category: r.category, tags: JSON.parse(String(r.tags || '[]')),
-        salience: Number(r.salience), uses: Number(r.uses) || 0, source: r.source,
-        project: r.project ? String(r.project) : undefined,
-        created: String(r.created), updated: String(r.updated), body: String(r.body),
-    };
-}
-/** 作用域集 → SQL WHERE 片段 + 参数(匹配任一 ref)。 */
-function scopeWhere(refs) {
-    const clauses = [];
-    const params = [];
-    for (const r of refs) {
-        if (r.scope === 'global')
-            clauses.push("scope='global'");
-        else if (r.scope === 'project') {
-            clauses.push('(scope=\'project\' AND project=?)');
-            params.push(r.project);
-        }
-        else {
-            clauses.push('(scope=\'agent\' AND agentId=?)');
-            params.push(r.agentId);
-        }
-    }
-    return { sql: clauses.length ? `(${clauses.join(' OR ')})` : '0', params };
-}
-/** 总条目数(门控用;复用指纹的 count,不解析正文)。 */
-function totalCount() { return fingerprint().count; }
-/**
- * FTS5 检索。返回 SearchHit[] 表示"走了 DB 路";返回 null 表示"未启用/不可用"→ 调用方回退内存。
- * 排序仍用内存 searchEntries(FTS 仅预筛候选),故结果与纯内存一致。
- */
-export function ftsRecall(refs, query, opts = {}) {
-    const mode = indexMode();
-    if (mode === 'off')
-        return null;
-    if (!loadSqlite())
-        return null;
-    if (mode === 'auto' && totalCount() < INDEX_MIN_ENTRIES)
-        return null;
-    const db = openDb();
-    if (!db)
-        return null;
-    try {
-        ensureFresh(db);
-        const where = scopeWhere(refs);
-        const qTokens = tokenize(query);
-        let rows;
-        if (qTokens.length === 0) {
-            // 空查询:该作用域全集交给 searchEntries 按 salience/新鲜度排(镜像内存路)。
-            rows = db.prepare(`SELECT * FROM entries WHERE ${where.sql}`).all(...where.params);
-        }
-        else {
-            // FTS MATCH 预筛:任一 token 命中即候选;取较宽候选(limit*40,上限 400)再交内存精排。
-            const match = qTokens.map((t) => `"${t.replace(/"/g, '')}"`).join(' OR ');
-            const cap = Math.min(400, (opts.limit ?? 6) * 40);
-            rows = db.prepare(`SELECT e.* FROM fts JOIN entries e ON e.id = fts.id
-         WHERE fts MATCH ? AND ${where.sql} ORDER BY bm25(fts) LIMIT ?`).all(match, ...where.params, cap);
-        }
-        const candidates = rows.map(rowToEntry);
-        return searchEntries(candidates, query, opts);
-    }
-    catch {
-        return null; // 任何 DB 异常 → 回退内存
-    }
-    finally {
-        try {
-            db.close();
-        }
-        catch { /* ignore */ }
-    }
-}
-//# sourceMappingURL=ftsIndex.js.map

package/dist/core/memory2/ftsIndex.js.map

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

package/dist/core/memory2/gc.d.ts

@@ -1,9 +0,0 @@
-import type { ScopeRef } from './types.js';
-export interface GcStats {
-    purged: number;
-    deduped: number;
-    kept: number;
-}
-/** 对单作用域做 gc(持锁)。返回统计。 */
-export declare function gcScope(ref: ScopeRef): Promise<GcStats>;
-//# sourceMappingURL=gc.d.ts.map

package/dist/core/memory2/gc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gc.d.ts","sourceRoot":"","sources":["../../../src/core/memory2/gc.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAe,QAAQ,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAUD,0BAA0B;AAC1B,wBAAsB,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAwB7D"}

package/dist/core/memory2/gc.js

@@ -1,45 +0,0 @@
-/**
- * @module        core/memory2/gc
- * @description   记忆收敛(设计 §6 · §5):硬删 tombstone + 去重收敛(正文归一化相同 → 留最优、软删其余)。
- *                变更类操作,持作用域锁串行(withScopeLock)避免读-判-删竞态。衰减暂不做(需调参,
- *                避免过度设计;留待引入使用频次统计后再定)。
- * @layer         core
- * @boundedContext memory
- */
-import { normalizeForDedup } from './capture.js';
-import { writeMemoryIndex } from './digest.js';
-import { withScopeLock } from './lock.js';
-import { deleteEntry, listEntries, purgeTombstones } from './store.js';
-/** 挑一组重复里保留哪条:salience 高优先,再 updated 新,再 human>agent>capture。 */
-function pickBest(group) {
-    const rank = (s) => (s === 'human' ? 2 : s === 'agent' ? 1 : 0);
-    return group.slice().sort((a, b) => b.salience - a.salience || b.updated.localeCompare(a.updated) || rank(b.source) - rank(a.source))[0];
-}
-/** 对单作用域做 gc(持锁)。返回统计。 */
-export async function gcScope(ref) {
-    return withScopeLock(ref, () => {
-        const purged = purgeTombstones(ref);
-        const entries = listEntries(ref);
-        const groups = new Map();
-        for (const e of entries) {
-            const k = normalizeForDedup(e.body);
-            if (!k)
-                continue; // 空正文不参与去重
-            (groups.get(k) ?? groups.set(k, []).get(k)).push(e);
-        }
-        let deduped = 0;
-        for (const group of groups.values()) {
-            if (group.length < 2)
-                continue;
-            const keep = pickBest(group);
-            for (const e of group) {
-                if (e.id !== keep.id && deleteEntry(ref, e.id))
-                    deduped++;
-            }
-        }
-        if (deduped > 0 || purged > 0)
-            writeMemoryIndex(ref);
-        return { purged, deduped, kept: listEntries(ref).length };
-    });
-}
-//# sourceMappingURL=gc.js.map

package/dist/core/memory2/gc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"gc.js","sourceRoot":"","sources":["../../../src/core/memory2/gc.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AASvE,iEAAiE;AACjE,SAAS,QAAQ,CAAC,KAAoB;IACpC,MAAM,IAAI,GAAG,CAAC,CAAwB,EAAU,EAAE,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACjC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CACjG,CAAC,CAAC,CAAE,CAAC;AACR,CAAC;AAED,0BAA0B;AAC1B,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAa;IACzC,OAAO,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE;QAC7B,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAEpC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,CAAC;gBAAE,SAAS,CAAC,WAAW;YAC7B,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;YAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,IAAI,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;oBAAE,OAAO,EAAE,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,IAAI,OAAO,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC;YAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACrD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/memory2/lock.d.ts

@@ -1,12 +0,0 @@
-import type { ScopeRef } from './types.js';
-/**
- * 持作用域锁跑 fn。**等锁是 await,不是忙等**;fn 本身仍是同步的(临界区就是几个同步文件操作)。
- * 拿不到锁则重试至 timeoutMs;超时抛错。fn 结束(含抛错)必释放锁。陈旧锁自动回收。
- *
- * 🔴 曾经是 `while (Date.now() < end) {}`,注释写着"避免引入 async 传染" ——
- * 代价是**最坏单核跑满 5 秒且事件循环完全停摆**(审计 E11)。
- * 实测生产调用方只有 `gcScope` 一个,而它的两个上游本来就在 async 里,
- * 所谓的"传染"只有两处 `.map` 要改成 `Promise.all` —— 远比烧掉一个核便宜。
- */
-export declare function withScopeLock<T>(ref: ScopeRef, fn: () => T, timeoutMs?: number): Promise<T>;
-//# sourceMappingURL=lock.d.ts.map

package/dist/core/memory2/lock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../src/core/memory2/lock.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO3C;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CA8BhG"}

package/dist/core/memory2/lock.js

@@ -1,61 +0,0 @@
-/**
- * @module        core/memory2/lock
- * @description   作用域级互斥锁(设计 §6):变更类操作(gc/promote/migrate 的批量搬移)串行化,
- *                避免"读-判-删"竞态。基于 mkdir 原子性(POSIX)——目录建成即持锁;陈旧锁按 mtime 回收。
- *                创建/单条 save 走无冲突的一条一文件,**不需**此锁;仅多步读改删才用。
- * @layer         core
- * @boundedContext memory
- */
-import { existsSync, mkdirSync, rmdirSync, statSync } from 'node:fs';
-import { join } from 'node:path';
-import { scopeDir } from './store.js';
-const STALE_MS = 60_000; // 超 60s 的锁视为陈旧(持锁进程已死),强制回收
-const RETRY_MS = 50;
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-/**
- * 持作用域锁跑 fn。**等锁是 await,不是忙等**;fn 本身仍是同步的(临界区就是几个同步文件操作)。
- * 拿不到锁则重试至 timeoutMs;超时抛错。fn 结束(含抛错)必释放锁。陈旧锁自动回收。
- *
- * 🔴 曾经是 `while (Date.now() < end) {}`,注释写着"避免引入 async 传染" ——
- * 代价是**最坏单核跑满 5 秒且事件循环完全停摆**(审计 E11)。
- * 实测生产调用方只有 `gcScope` 一个,而它的两个上游本来就在 async 里,
- * 所谓的"传染"只有两处 `.map` 要改成 `Promise.all` —— 远比烧掉一个核便宜。
- */
-export async function withScopeLock(ref, fn, timeoutMs = 5_000) {
-    const dir = scopeDir(ref);
-    mkdirSync(dir, { recursive: true });
-    const lockDir = join(dir, '.lock');
-    const deadline = Date.now() + timeoutMs;
-    for (;;) {
-        try {
-            mkdirSync(lockDir); // 原子:已存在则抛 EEXIST
-            break;
-        }
-        catch {
-            // 已被占:陈旧则回收,否则重试
-            try {
-                if (Date.now() - statSync(lockDir).mtimeMs > STALE_MS) {
-                    rmdirSync(lockDir);
-                    continue;
-                }
-            }
-            catch {
-                continue; // 锁刚被别人释放 → 重试抢
-            }
-            if (Date.now() > deadline)
-                throw new Error(`memory scope lock timeout: ${dir}`);
-            await sleep(RETRY_MS);
-        }
-    }
-    try {
-        return fn();
-    }
-    finally {
-        try {
-            if (existsSync(lockDir))
-                rmdirSync(lockDir);
-        }
-        catch { /* best effort */ }
-    }
-}
-//# sourceMappingURL=lock.js.map

package/dist/core/memory2/lock.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/core/memory2/lock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,4BAA4B;AACrD,MAAM,QAAQ,GAAG,EAAE,CAAC;AAEpB,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAEnF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,GAAa,EAAE,EAAW,EAAE,SAAS,GAAG,KAAK;IAClF,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1B,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,SAAS,CAAC;QACR,IAAI,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB;YACtC,MAAM;QACR,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;YACjB,IAAI,CAAC;gBACH,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC;oBACtD,SAAS,CAAC,OAAO,CAAC,CAAC;oBACnB,SAAS;gBACX,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,CAAC,gBAAgB;YAC5B,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;YAChF,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YAAC,IAAI,UAAU,CAAC,OAAO,CAAC;gBAAE,SAAS,CAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAClF,CAAC;AACH,CAAC"}

package/dist/core/memory2/migrate.d.ts

@@ -1,12 +0,0 @@
-import type { ScopeRef } from './types.js';
-/** 迁移一个旧作用域目录的根级 *.md(跳 MEMORY.md / entries/ 子目录)。返回迁移条数。 */
-export declare function migrateOldDir(oldDir: string, ref: ScopeRef): number;
-/** 迁移单个项目的旧记忆 → v2(projects/<project>/*.md → projects/<project>/entries/)。 */
-export declare function migrateProject(project: string): number;
-/** 迁移全部:旧 user → global;agents/<id> → agent scope;projects/<p> → project scope。 */
-export declare function migrateAll(): {
-    global: number;
-    agents: number;
-    projects: number;
-};
-//# sourceMappingURL=migrate.d.ts.map

package/dist/core/memory2/migrate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/core/memory2/migrate.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAkB,QAAQ,EAAE,MAAM,YAAY,CAAC;AAa3D,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,MAAM,CA8BnE;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,mFAAmF;AACnF,wBAAgB,UAAU,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CA2CjF"}

package/dist/core/memory2/migrate.js

@@ -1,119 +0,0 @@
-/**
- * @module        core/memory2/migrate
- * @description   把旧文件记忆(~/.coral/memory/{user,agents/<id>,projects/<p>}/*.md,frontmatter
- *                name/description/type)迁到 v2 entry 格式,内容不丢。设计 §8。
- *                旧文件在作用域目录根;v2 entry 写进 <scope>/entries/ —— 同目录不冲突。
- * @layer         core
- * @boundedContext memory
- */
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
-import { join } from 'node:path';
-import { parseFrontmatter } from '../flatfile/frontmatter.js';
-import { writeMemoryIndex } from './digest.js';
-import { memoryRoot, saveEntry, scopeDir } from './store.js';
-/** 旧 type → v2 category。 */
-function mapCategory(type) {
-    switch (type) {
-        case 'convention': return 'convention';
-        case 'decision': return 'decision';
-        case 'reference': return 'reference';
-        case 'lesson': return 'note';
-        default: return 'note';
-    }
-}
-/** 迁移一个旧作用域目录的根级 *.md(跳 MEMORY.md / entries/ 子目录)。返回迁移条数。 */
-export function migrateOldDir(oldDir, ref) {
-    if (!existsSync(oldDir))
-        return 0;
-    let n = 0;
-    for (const name of readdirSync(oldDir)) {
-        if (!name.endsWith('.md') || name === 'MEMORY.md')
-            continue;
-        const p = join(oldDir, name);
-        try {
-            if (statSync(p).isDirectory())
-                continue;
-        }
-        catch {
-            continue;
-        }
-        const { data, body } = parseFrontmatter(readFileSync(p, 'utf-8'));
-        const title = typeof data.name === 'string' && data.name ? data.name : name.replace(/\.md$/, '');
-        const desc = typeof data.description === 'string' ? data.description : '';
-        const cat = mapCategory(data.type);
-        const text = body.trim() || desc || title;
-        try {
-            saveEntry(ref, {
-                title,
-                body: desc && !text.includes(desc) ? `${desc}\n\n${text}` : text,
-                category: cat,
-                salience: cat === 'convention' || cat === 'reference' ? 4 : 3,
-                source: 'human',
-            });
-            n++;
-        }
-        catch {
-            // 命中高危脱敏被丢弃 → 跳过这条,不阻断整体迁移。
-        }
-    }
-    return n;
-}
-/** 迁移单个项目的旧记忆 → v2(projects/<project>/*.md → projects/<project>/entries/)。 */
-export function migrateProject(project) {
-    const ref = { scope: 'project', project };
-    const n = migrateOldDir(scopeDir(ref), ref);
-    if (n > 0)
-        writeMemoryIndex(ref);
-    return n;
-}
-/** 迁移全部:旧 user → global;agents/<id> → agent scope;projects/<p> → project scope。 */
-export function migrateAll() {
-    const root = memoryRoot();
-    let global = 0;
-    let agents = 0;
-    let projects = 0;
-    // 旧 user → global
-    const userDir = join(root, 'user');
-    if (existsSync(userDir)) {
-        const ref = { scope: 'global' };
-        global += migrateOldDir(userDir, ref);
-        if (global)
-            writeMemoryIndex(ref);
-    }
-    // agents/<id>(旧根级 *.md → 该 agent scope entries/)
-    const agentsDir = join(root, 'agents');
-    if (existsSync(agentsDir)) {
-        for (const id of readdirSync(agentsDir)) {
-            const dir = join(agentsDir, id);
-            try {
-                if (!statSync(dir).isDirectory())
-                    continue;
-            }
-            catch {
-                continue;
-            }
-            const ref = { scope: 'agent', agentId: id };
-            const c = migrateOldDir(dir, ref);
-            if (c)
-                writeMemoryIndex(ref);
-            agents += c;
-        }
-    }
-    // projects/<p>
-    const projectsDir = join(root, 'projects');
-    if (existsSync(projectsDir)) {
-        for (const p of readdirSync(projectsDir)) {
-            const dir = join(projectsDir, p);
-            try {
-                if (!statSync(dir).isDirectory())
-                    continue;
-            }
-            catch {
-                continue;
-            }
-            projects += migrateProject(p);
-        }
-    }
-    return { global, agents, projects };
-}
-//# sourceMappingURL=migrate.js.map

package/dist/core/memory2/migrate.js.map

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

package/dist/core/memory2/recallResult.d.ts

@@ -1,19 +0,0 @@
-import type { ScopeRef } from './types.js';
-export interface RecallHit {
-    /** `<backend>:<原始 id>`。今天只有 `local:`。 */
-    id: string;
-    source: 'local';
-    title: string;
-    snippet: string;
-    score: number;
-    scope?: string;
-    project?: string;
-    category?: string;
-    tags?: string[];
-}
-/** 按 scope 召回,转成对外形状。**同步实现,签名保持 async** —— 调用方三处都在 await。 */
-export declare function recallHits(refs: ScopeRef[], query: string, opts?: {
-    tags?: string[];
-    limit?: number;
-}): Promise<RecallHit[]>;
-//# sourceMappingURL=recallResult.d.ts.map

package/dist/core/memory2/recallResult.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"recallResult.d.ts","sourceRoot":"","sources":["../../../src/core/memory2/recallResult.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,8DAA8D;AAC9D,wBAAsB,UAAU,CAC9B,IAAI,EAAE,QAAQ,EAAE,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C,OAAO,CAAC,SAAS,EAAE,CAAC,CActB"}

package/dist/core/memory2/recallResult.js

@@ -1,33 +0,0 @@
-/**
- * @module        core/memory2/recallResult
- * @description   召回结果的对外形状 —— 带来源标记与 `<backend>:<id>` 前缀。
- *
- * @layer         core
- * @boundedContext memory
- *
- * 🔴 **为什么保留 `source` 与 id 前缀,即使今天只有本地一个后端**:
- *    它们不是给"多后端"用的装饰,是给**调用方**用的 ——
- *    `memory_read` 拿到一个 id 要知道去哪儿读回全文。去掉前缀就得靠猜。
- *
- * ⚠️ 这个形状此前长在 `external/federate.ts` 里(agentmemory 那次接入的产物),
- *    随它一起被删会连累三个调用点改签名。**结果形状是本地的事,不该住在外部适配器里** ——
- *    这正是那次接入没设计好的一个具体样本。
- */
-import { recall } from './retrieve.js';
-/** 按 scope 召回,转成对外形状。**同步实现,签名保持 async** —— 调用方三处都在 await。 */
-export async function recallHits(refs, query, opts = {}) {
-    const limit = opts.limit ?? 6;
-    const hits = recall(refs, query, { ...(opts.tags ? { tags: opts.tags } : {}), limit });
-    return hits.slice(0, limit).map((h) => ({
-        id: `local:${h.entry.id}`,
-        source: 'local',
-        title: h.entry.title,
-        snippet: h.entry.body.slice(0, 200),
-        score: h.score,
-        scope: h.entry.scope,
-        ...(h.entry.project ? { project: h.entry.project } : {}),
-        category: h.entry.category,
-        tags: h.entry.tags,
-    }));
-}
-//# sourceMappingURL=recallResult.js.map

package/dist/core/memory2/recallResult.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"recallResult.js","sourceRoot":"","sources":["../../../src/core/memory2/recallResult.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAgBvC,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAgB,EAChB,KAAa,EACb,OAA4C,EAAE;IAE9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,EAAE,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE;QACzB,MAAM,EAAE,OAAgB;QACxB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK;QACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACnC,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK;QACpB,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ;QAC1B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI;KACnB,CAAC,CAAC,CAAC;AACN,CAAC"}