@coralai/sps-cli 0.58.14 → 0.58.16

package/dist/core/memory2/claudeMdRule.js

@@ -0,0 +1,65 @@
+/**
+ * @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 past decisions, record new ones)
+
+This project has a **local memory** — a small store of conventions, decisions,
+gotchas, and patterns learned on earlier tasks. A digest is injected at the top of
+your prompt inside a \`<memory>\` block; use these tools for the rest.
+
+**When to use it:**
+
+1. **At task start — recall.** Before designing, call \`memory_recall\` with the
+   key terms of the card to pull anything relevant that isn't already in the
+   injected digest (project + global scope). Use \`memory_read <id>\` for full text.
+2. **When you settle something reusable — save.** After you establish a convention,
+   make a non-obvious decision, or hit a gotcha worth not repeating, call
+   \`memory_save\` with a short \`title\` + concise \`body\`. Pick a \`category\`
+   (convention/decision/gotcha/pattern/reference/note). Default scope is this
+   project; only pass \`scope: "global"\` for something true across all projects.
+
+If the \`memory_*\` tools aren't available in your session, the same operations
+are on the shell: \`sps memory recall <project> "<query>"\` and
+\`sps memory save <project> --title "..." --body "..."\`.
+
+**Don't save:** secrets/tokens/credentials, deploy addresses, customer data, or
+anything the code/git history already records. Keep entries short and durable.`;
+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

@@ -0,0 +1 @@
+{"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;;;;;;;;;;;;;;;;;;;;;;+EAsBkE,CAAC;AAEhF,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/config.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module        core/memory2/config
+ * @description   记忆 v2 运行模式(设计 §8)。SPS_MEMORY_MODE = local(默认)| local+external |
+ *                external | none。此处只做「本地读写是否启用」这个**当前真需要**的判定:mode=none
+ *                → 本地注入/捕获全关。
+ *
+ *                ⚠️ 刻意未实现(YAGNI,设计 §4/§5 明列「按需、默认关、需要才建」):
+ *                  - external / local+external 的外部后端适配器与合并(RRF)——无已接外部后端、无 scale 压力;
+ *                  - FTS5 加速(仅 store 很大且 node:sqlite 可用时才值得);
+ *                  - embedding 向量混检、LLM 蒸馏。
+ *                需求出现时,在此扩 `memoryMode()` 的分支 + 加一层可选适配器即可,基线纯本地永远能跑。
+ * @layer         core
+ * @boundedContext memory
+ */
+export type MemoryMode = 'local' | 'local+external' | 'external' | 'none';
+/** 读运行模式。未配置/非法值 → 'local'。 */
+export declare function memoryMode(): MemoryMode;
+/** 记忆整体是否关闭(mode=none):关则本地注入与捕获都不做。 */
+export declare function isMemoryOff(): boolean;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/core/memory2/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,gBAAgB,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1E,+BAA+B;AAC/B,wBAAgB,UAAU,IAAI,UAAU,CAIvC;AAED,wCAAwC;AACxC,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/dist/core/memory2/config.js

@@ -0,0 +1,26 @@
+/**
+ * @module        core/memory2/config
+ * @description   记忆 v2 运行模式(设计 §8)。SPS_MEMORY_MODE = local(默认)| local+external |
+ *                external | none。此处只做「本地读写是否启用」这个**当前真需要**的判定:mode=none
+ *                → 本地注入/捕获全关。
+ *
+ *                ⚠️ 刻意未实现(YAGNI,设计 §4/§5 明列「按需、默认关、需要才建」):
+ *                  - external / local+external 的外部后端适配器与合并(RRF)——无已接外部后端、无 scale 压力;
+ *                  - FTS5 加速(仅 store 很大且 node:sqlite 可用时才值得);
+ *                  - embedding 向量混检、LLM 蒸馏。
+ *                需求出现时,在此扩 `memoryMode()` 的分支 + 加一层可选适配器即可,基线纯本地永远能跑。
+ * @layer         core
+ * @boundedContext memory
+ */
+/** 读运行模式。未配置/非法值 → 'local'。 */
+export function memoryMode() {
+    const raw = (process.env.SPS_MEMORY_MODE ?? '').toLowerCase();
+    if (raw === 'none' || raw === 'external' || raw === 'local+external')
+        return raw;
+    return 'local';
+}
+/** 记忆整体是否关闭(mode=none):关则本地注入与捕获都不做。 */
+export function isMemoryOff() {
+    return memoryMode() === 'none';
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/memory2/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,+BAA+B;AAC/B,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9D,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,gBAAgB;QAAE,OAAO,GAAG,CAAC;IACjF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,EAAE,KAAK,MAAM,CAAC;AACjC,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { MemoryEntry, ScopeRef } from './types.js';
+export interface DigestOpts {
+    /** 标题清单最多列几条(默认 60)。 */
+    maxTitles?: number;
+    /** 内联几条高 salience 正文(默认 6)。 */
+    maxBodies?: number;
+    /** 每条正文最多字符(默认 500)。 */
+    bodyChars?: number;
+}
+/** 生成 digest markdown(标题清单 + top 高 salience 正文)。 */
+export declare function buildDigest(entries: MemoryEntry[], opts?: DigestOpts): string;
+/** 把某作用域的 digest 落成 <scope>/MEMORY.md(派生,可重建)。 */
+export declare function writeMemoryIndex(ref: ScopeRef): void;
+/** 供注入用:多作用域合并的紧凑 digest(标题清单;正文靠相关性注入另给)。 */
+export declare function buildInjectionDigest(refs: ScopeRef[], opts?: DigestOpts): string;
+//# sourceMappingURL=digest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../../src/core/memory2/digest.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,GAAE,UAAe,GAAG,MAAM,CA0BjF;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAKpD;AAED,8CAA8C;AAC9C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,GAAE,UAAe,GAAG,MAAM,CAGpF"}

package/dist/core/memory2/digest.js

@@ -0,0 +1,52 @@
+/**
+ * @module        core/memory2/digest
+ * @description   从 entries 派生「常驻摘要 digest」(设计 §1B 渐进式披露):标题清单 +
+ *                高 salience 条目正文,有 token 预算。digest 每次派活/开会话必注入;
+ *                也落成 <scope>/MEMORY.md(人类可读、派生、勿手改)。
+ * @layer         core
+ * @boundedContext memory
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { scopeDir } from './store.js';
+import { listEntries } from './store.js';
+/** 生成 digest markdown(标题清单 + top 高 salience 正文)。 */
+export function buildDigest(entries, opts = {}) {
+    const maxTitles = opts.maxTitles ?? 60;
+    const maxBodies = opts.maxBodies ?? 6;
+    const bodyChars = opts.bodyChars ?? 500;
+    if (entries.length === 0)
+        return '';
+    // salience 高→低,再新鲜度
+    const ranked = entries.slice().sort((a, b) => b.salience - a.salience || b.updated.localeCompare(a.updated));
+    const lines = ['# 记忆摘要', ''];
+    lines.push('## 索引');
+    for (const e of ranked.slice(0, maxTitles)) {
+        const tags = e.tags.length ? ` #${e.tags.join(' #')}` : '';
+        lines.push(`- [${e.id}] (${e.category}, s${e.salience}) ${e.title}${tags}`);
+    }
+    if (ranked.length > maxTitles)
+        lines.push(`- …还有 ${ranked.length - maxTitles} 条(用 memory_recall 检索)`);
+    const bodies = ranked.slice(0, maxBodies);
+    if (bodies.length) {
+        lines.push('', '## 高显著度');
+        for (const e of bodies) {
+            const body = e.body.length > bodyChars ? `${e.body.slice(0, bodyChars)}…` : e.body;
+            lines.push('', `### ${e.title}`, body);
+        }
+    }
+    return lines.join('\n').trim();
+}
+/** 把某作用域的 digest 落成 <scope>/MEMORY.md(派生,可重建)。 */
+export function writeMemoryIndex(ref) {
+    const dir = scopeDir(ref);
+    mkdirSync(dir, { recursive: true });
+    const digest = buildDigest(listEntries(ref));
+    writeFileSync(join(dir, 'MEMORY.md'), digest ? `${digest}\n` : '');
+}
+/** 供注入用:多作用域合并的紧凑 digest(标题清单;正文靠相关性注入另给)。 */
+export function buildInjectionDigest(refs, opts = {}) {
+    const all = refs.flatMap((r) => (existsSync(scopeDir(r)) ? listEntries(r) : []));
+    return buildDigest(all, { maxBodies: 0, ...opts });
+}
+//# sourceMappingURL=digest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"digest.js","sourceRoot":"","sources":["../../../src/core/memory2/digest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAYzC,oDAAoD;AACpD,MAAM,UAAU,WAAW,CAAC,OAAsB,EAAE,OAAmB,EAAE;IACvE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;IACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,oBAAoB;IACpB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAE7G,MAAM,KAAK,GAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,SAAS,wBAAwB,CAAC,CAAC;IAEtG,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACnF,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,gBAAgB,CAAC,GAAa;IAC5C,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1B,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,oBAAoB,CAAC,IAAgB,EAAE,OAAmB,EAAE;IAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjF,OAAO,WAAW,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"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,wBAAgB,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAwB9C"}

package/dist/core/memory2/gc.js

@@ -0,0 +1,45 @@
+/**
+ * @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 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

@@ -0,0 +1 @@
+{"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,UAAU,OAAO,CAAC,GAAa;IACnC,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/inject.d.ts

@@ -0,0 +1,16 @@
+import type { ScopeRef } from './types.js';
+export interface InjectOpts {
+    /** 相关正文注入几条(默认 5)。 */
+    topK?: number;
+    /** 每条正文最多字符(默认 400)。 */
+    bodyChars?: number;
+    /** digest 标题清单上限(默认 40)。 */
+    maxTitles?: number;
+}
+/**
+ * 拼 `<memory>` 注入块。无任何记忆时返回 ''(派活方据此决定是否 prepend)。
+ * @param refs   作用域集(worker: [project, global];harness: [agent, global])。
+ * @param query  当前任务文本(卡片 prompt / 首轮消息),用于相关性 top-K;空则只出 digest。
+ */
+export declare function buildMemoryInjection(refs: ScopeRef[], query: string, opts?: InjectOpts): string;
+//# sourceMappingURL=inject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../../src/core/memory2/inject.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,MAAM,CAuBnG"}

package/dist/core/memory2/inject.js

@@ -0,0 +1,45 @@
+/**
+ * @module        core/memory2/inject
+ * @description   读路注入(设计 §3):派活/开会话前把记忆拼成 `<memory>` 块 = 常驻 digest
+ *                (标题清单)+ 按当前任务文本相关性检索的 top-K 正文。worker 走 project+global,
+ *                harness 走 agent+global。agent 无关——只产出文本,由派活方 prepend 进 prompt。
+ * @layer         core
+ * @boundedContext memory
+ */
+import { existsSync } from 'node:fs';
+import { isMemoryOff } from './config.js';
+import { buildInjectionDigest } from './digest.js';
+import { recall } from './retrieve.js';
+import { scopeDir } from './store.js';
+/**
+ * 拼 `<memory>` 注入块。无任何记忆时返回 ''(派活方据此决定是否 prepend)。
+ * @param refs   作用域集(worker: [project, global];harness: [agent, global])。
+ * @param query  当前任务文本(卡片 prompt / 首轮消息),用于相关性 top-K;空则只出 digest。
+ */
+export function buildMemoryInjection(refs, query, opts = {}) {
+    if (isMemoryOff())
+        return ''; // mode=none:不注入
+    const present = refs.filter((r) => existsSync(scopeDir(r)));
+    if (present.length === 0)
+        return '';
+    const topK = opts.topK ?? 5;
+    const bodyChars = opts.bodyChars ?? 400;
+    const digest = buildInjectionDigest(present, { maxTitles: opts.maxTitles ?? 40 });
+    const hits = query.trim() ? recall(present, query, { limit: topK }) : [];
+    const parts = [];
+    if (digest)
+        parts.push(digest);
+    if (hits.length) {
+        const rel = ['## 相关记忆'];
+        for (const h of hits) {
+            const e = h.entry;
+            const body = e.body.length > bodyChars ? `${e.body.slice(0, bodyChars)}…` : e.body;
+            rel.push('', `### ${e.title} [${e.scope}/${e.category}]`, body);
+        }
+        parts.push(rel.join('\n'));
+    }
+    if (parts.length === 0)
+        return '';
+    return `<memory>\n${parts.join('\n\n')}\n</memory>`;
+}
+//# sourceMappingURL=inject.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inject.js","sourceRoot":"","sources":["../../../src/core/memory2/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAYtC;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAgB,EAAE,KAAa,EAAE,OAAmB,EAAE;IACzF,IAAI,WAAW,EAAE;QAAE,OAAO,EAAE,CAAC,CAAC,gBAAgB;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;IACxC,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC,CAAC;IAElF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,GAAG,GAAa,CAAC,SAAS,CAAC,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;YAClB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACnF,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,GAAG,EAAE,IAAI,CAAC,CAAC;QAClE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,aAAa,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;AACtD,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { ScopeRef } from './types.js';
+/**
+ * 持作用域锁跑 fn(同步)。拿不到锁则忙等重试至 timeoutMs;超时抛错。fn 结束(含抛错)必释放锁。
+ * 陈旧锁(mtime 超 STALE_MS)自动回收。
+ */
+export declare function withScopeLock<T>(ref: ScopeRef, fn: () => T, timeoutMs?: number): T;
+//# sourceMappingURL=lock.d.ts.map

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

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

package/dist/core/memory2/lock.js

@@ -0,0 +1,59 @@
+/**
+ * @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;
+function sleepBusy(ms) {
+    const end = Date.now() + ms;
+    while (Date.now() < end) { /* 忙等:锁竞争窗口极短,避免引入 async 传染 */ }
+}
+/**
+ * 持作用域锁跑 fn(同步)。拿不到锁则忙等重试至 timeoutMs;超时抛错。fn 结束(含抛错)必释放锁。
+ * 陈旧锁(mtime 超 STALE_MS)自动回收。
+ */
+export 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}`);
+            sleepBusy(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

@@ -0,0 +1 @@
+{"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,SAAS,SAAS,CAAC,EAAU;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IAC5B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,8BAA8B,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAI,GAAa,EAAE,EAAW,EAAE,SAAS,GAAG,KAAK;IAC5E,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,SAAS,CAAC,QAAQ,CAAC,CAAC;QACtB,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

@@ -0,0 +1,12 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,119 @@
+/**
+ * @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, readFileSync, readdirSync, 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

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

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

@@ -0,0 +1,21 @@
+/** 测试用:清空追加规则缓存(改了 SPS_MEMORY_ROOT/redact.rules 后调用)。 */
+export declare function resetRedactCache(): void;
+export interface RedactResult {
+    title: string;
+    body: string;
+    /** true=命中高危,整条应丢弃(title/body 不可用)。 */
+    dropped: boolean;
+    /** 命中的规则 label(去重),供调 debug 日志——不含原文。 */
+    reasons: string[];
+}
+/**
+ * 对一条记忆(title+body 合起来判)做脱敏。命中 drop 规则→dropped=true;否则对命中 mask 规则的片段打码。
+ * SPS_MEMORY_REDACT=off 时原样返回。
+ */
+export declare function redactEntry(title: string, body: string): RedactResult;
+/** 写入被拒(命中高危):调用方据此提示"已丢弃"。 */
+export declare class RedactedEntryDropped extends Error {
+    readonly reasons: string[];
+    constructor(reasons: string[]);
+}
+//# sourceMappingURL=redact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../../src/core/memory2/redact.ts"],"names":[],"mappings":"AAuEA,yDAAyD;AACzD,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CA+BrE;AAED,+BAA+B;AAC/B,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBACf,OAAO,EAAE,MAAM,EAAE;CAK9B"}