trove-cli 0.0.0-stage → 0.3.2

package/dist/core/lessons/memo.js.map

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

package/dist/core/lessons/merge.d.ts

@@ -0,0 +1,39 @@
+/** 阶段 6:合并与冲突处理。把候选记忆与现有记忆比对,产出 add/patch/append/skip 四种操作。 */
+import type { MemoryCandidate } from './extract.js';
+import type { LlmProvider } from './llm.js';
+export interface ExistingMemory {
+    type: string;
+    path: string;
+    title: string;
+    content: string;
+}
+export type MemoryOp = {
+    op: 'add';
+    type: string;
+    path: string;
+    title: string;
+    content: string;
+    supersedePath?: string;
+    evidence: number[];
+} | {
+    op: 'patch';
+    type: string;
+    path: string;
+    title: string;
+    content: string;
+    before: string;
+} | {
+    op: 'append';
+    type: string;
+    path: string;
+    content: string;
+} | {
+    op: 'skip';
+    type: string;
+    title: string;
+    reason: string;
+};
+export interface MergeDeps {
+    llm: LlmProvider;
+}
+export declare function mergeMemories(candidates: MemoryCandidate[], existing: ExistingMemory[], deps: MergeDeps): Promise<MemoryOp[]>;

package/dist/core/lessons/merge.js

@@ -0,0 +1,79 @@
+import { buildFilename, getMemoryType } from './schema.js';
+const TITLE_MIN = 10;
+export async function mergeMemories(candidates, existing, deps) {
+    const ops = [];
+    for (const c of candidates) {
+        const op = await resolve(c, existing, deps);
+        if (op)
+            ops.push(op);
+    }
+    return ops;
+}
+async function resolve(c, existing, deps) {
+    const title = c.title.trim();
+    if (title.length < TITLE_MIN)
+        return { op: 'skip', type: c.type, title, reason: 'title_too_short' };
+    const schema = getMemoryType(c.type);
+    if (!schema)
+        return { op: 'skip', type: c.type, title, reason: 'unknown_type' };
+    const path = buildFilename(schema, { title, slug: c.slug });
+    const sameType = existing.filter((e) => e.type === c.type);
+    const samePath = sameType.find((e) => e.path === path);
+    if (schema.mergeOp === 'append') {
+        if (samePath) {
+            // 幂等:相同正文已存在则跳过,不重复追加(重跑/重复学习不翻倍)
+            if (samePath.content.includes(c.content.trim()))
+                return null;
+            return { op: 'append', type: c.type, path, content: c.content };
+        }
+        return { op: 'add', type: c.type, path, title, content: c.content, evidence: c.evidence };
+    }
+    if (schema.mergeOp === 'patch') {
+        if (samePath) {
+            const merged = await mergeContent(c, samePath, deps.llm);
+            return { op: 'patch', type: c.type, path, title, content: merged, before: samePath.content };
+        }
+        return { op: 'add', type: c.type, path, title, content: c.content, evidence: c.evidence };
+    }
+    // mergeOp === 'add':每条独立新建;仅结论冲突时归档旧记忆。
+    if (samePath)
+        return null; // 同类型同路径 = 重复记忆,幂等跳过(重跑不翻倍)
+    if (sameType.length > 0) {
+        const conflict = await detectConflict(c, sameType, deps.llm);
+        if (conflict)
+            return { op: 'add', type: c.type, path, title, content: c.content, supersedePath: conflict.path, evidence: c.evidence };
+    }
+    return { op: 'add', type: c.type, path, title, content: c.content, evidence: c.evidence };
+}
+const MERGE_SCHEMA = {
+    type: 'object',
+    properties: { content: { type: 'string' } },
+    required: ['content'],
+};
+async function mergeContent(c, existing, llm) {
+    const prompt = (getMemoryType(c.type)?.mergePrompt ?? '')
+        .replace('{summary}', `标题:${c.title}\n正文:${c.content}`)
+        .replace('{existing}', existing.content);
+    const raw = await llm.generate(prompt, MERGE_SCHEMA, 'learn:merge');
+    return typeof raw?.content === 'string' ? raw.content : c.content;
+}
+const CONFLICT_SCHEMA = {
+    type: 'object',
+    properties: { conflict: { type: 'boolean' }, path: { type: 'string' } },
+    required: ['conflict'],
+};
+async function detectConflict(c, sameType, llm) {
+    const prompt = [
+        `判断新记忆是否与现有记忆结论冲突。`,
+        `新记忆:标题:${c.title}\n正文:${c.content}`,
+        '现有记忆:',
+        sameType.map((e) => `- ${e.path}: ${e.content}`).join('\n'),
+    ].join('\n');
+    const raw = await llm.generate(prompt, CONFLICT_SCHEMA, 'learn:conflict');
+    if (raw?.conflict !== true)
+        return null;
+    const p = typeof raw.path === 'string' ? raw.path : undefined;
+    const matched = p ? sameType.find((e) => e.path === p) : undefined;
+    return matched ?? sameType[0] ?? null;
+}
+//# sourceMappingURL=merge.js.map

package/dist/core/lessons/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../src/core/lessons/merge.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAmB3D,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAA6B,EAC7B,QAA0B,EAC1B,IAAe;IAEf,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,EAAE;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,CAAkB,EAAE,QAA0B,EAAE,IAAe;IACpF,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IACpG,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAChF,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAEvD,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,IAAI,QAAQ,EAAE,CAAC;YACb,kCAAkC;YAClC,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7D,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAClE,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5F,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YACzD,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC/F,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5F,CAAC;IACD,wCAAwC;IACxC,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC,CAAC,4BAA4B;IACvD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxI,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC5F,CAAC;AAED,MAAM,YAAY,GAA4B;IAC5C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAC3C,QAAQ,EAAE,CAAC,SAAS,CAAC;CACtB,CAAC;AAEF,KAAK,UAAU,YAAY,CAAC,CAAkB,EAAE,QAAwB,EAAE,GAAgB;IACxF,MAAM,MAAM,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,WAAW,IAAI,EAAE,CAAC;SACtD,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;SACtD,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAwB,MAAM,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IAC3F,OAAO,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACpE,CAAC;AAED,MAAM,eAAe,GAA4B;IAC/C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IACvE,QAAQ,EAAE,CAAC,UAAU,CAAC;CACvB,CAAC;AAEF,KAAK,UAAU,cAAc,CAAC,CAAkB,EAAE,QAA0B,EAAE,GAAgB;IAC5F,MAAM,MAAM,GAAG;QACb,mBAAmB;QACnB,UAAU,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,OAAO,EAAE;QACpC,OAAO;QACP,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KAC5D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAyC,MAAM,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC;IAClH,IAAI,GAAG,EAAE,QAAQ,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,CAAC,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9D,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,OAAO,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC"}

package/dist/core/lessons/queue.d.ts

@@ -0,0 +1,6 @@
+/** 读队列;文件缺失或损坏按空队处理,不拖垮调用方。 */
+export declare function readLearnQueue(path: string): Promise<string[]>;
+/** 追加 ids 到队尾,去重(已存在的不动);sync 每轮入队与 learn 每 tick 出队互斥。 */
+export declare function enqueueLearn(path: string, ids: string[]): Promise<void>;
+/** 移除指定 ids(处理完/失败都算「已处理」),保留其余。 */
+export declare function removeLearn(path: string, ids: string[]): Promise<void>;

package/dist/core/lessons/queue.js

@@ -0,0 +1,52 @@
+/** learn 待办队列:sync 把「本轮新会话」追加进来,learn 循环按批取出并移除。崩溃重启后不丢。 */
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { acquireLock } from '../lock.js';
+/** 读队列;文件缺失或损坏按空队处理,不拖垮调用方。 */
+export async function readLearnQueue(path) {
+    try {
+        const raw = await readFile(path, 'utf8');
+        const v = JSON.parse(raw);
+        return Array.isArray(v) ? v.filter((x) => typeof x === 'string') : [];
+    }
+    catch {
+        return [];
+    }
+}
+async function writeLearnQueue(path, ids) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp-${Math.random().toString(36).slice(2)}`;
+    await writeFile(tmp, JSON.stringify(ids, null, 2) + '\n', 'utf8');
+    await rename(tmp, path);
+}
+/** 追加 ids 到队尾,去重(已存在的不动);sync 每轮入队与 learn 每 tick 出队互斥。 */
+export async function enqueueLearn(path, ids) {
+    if (ids.length === 0)
+        return;
+    const release = await acquireLock(`${path}.lock`);
+    try {
+        const existing = await readLearnQueue(path);
+        const seen = new Set(existing);
+        for (const id of ids)
+            seen.add(id);
+        await writeLearnQueue(path, [...seen]);
+    }
+    finally {
+        await release();
+    }
+}
+/** 移除指定 ids(处理完/失败都算「已处理」),保留其余。 */
+export async function removeLearn(path, ids) {
+    if (ids.length === 0)
+        return;
+    const release = await acquireLock(`${path}.lock`);
+    try {
+        const existing = await readLearnQueue(path);
+        const drop = new Set(ids);
+        await writeLearnQueue(path, existing.filter((id) => !drop.has(id)));
+    }
+    finally {
+        await release();
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/core/lessons/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../src/core/lessons/queue.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QACrC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,GAAa;IACxD,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,GAAG,IAAI,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAClE,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,GAAa;IAC5D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC7B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,IAAI,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/B,KAAK,MAAM,EAAE,IAAI,GAAG;YAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,eAAe,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,GAAa;IAC3D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC7B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,IAAI,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/core/lessons/recent.d.ts

@@ -0,0 +1,21 @@
+import type { LibraryIndex, MergedSession } from '../library/schema.js';
+import type { LessonProviderDeps, ExtractionOutcome } from './learn.js';
+/** 按 startedAt 降序取最近 limit 个会话;缺 startedAt 的排到末尾(视为最旧)。 */
+export declare function pickRecentSessions(index: LibraryIndex, limit?: number): MergedSession[];
+/** 项目聚类统计:同类(cwd 尾两段)会话的频繁度与规模,供「近期方向」区分一次性 vs 常驻。 */
+export interface ProjectStat {
+    count: number;
+    first?: string;
+    last?: string;
+    events: number;
+}
+/** 全量索引按项目聚类:会话数、首次/最近时间、累计事件数。无 cwd 不聚类(视为一次性)。 */
+export declare function buildProjectStats(index: LibraryIndex): Map<string, ProjectStat>;
+/** 渲染最近会话清单:每行 日期 | 项目 | 主题 | 频繁度,交给 mergePrompt 让 LLM 分档总结方向。 */
+export declare function renderRecentList(sessions: MergedSession[], stats?: Map<string, ProjectStat>): string;
+/** 输入指纹:最近会话的身份+时间+事件规模,新会话、排序或规模变化即变;用于滚动幂等,输入不变不重跑 LLM。 */
+export declare function recentInputHash(sessions: MergedSession[]): string;
+/** recent 渠道编排:幂等键 audit/recent-matters.json 的 inputHash 字段,hash 不变则 skip(滚动不无谓烧 token)。 */
+export declare function learnRecentMatters(vaultRoot: string, deps?: LessonProviderDeps, opts?: {
+    force?: boolean;
+}): Promise<ExtractionOutcome>;

package/dist/core/lessons/recent.js

@@ -0,0 +1,111 @@
+/** 「近期方向」跨会话聚合:从统一索引取最近 N 个会话的时间/项目(cwd)/主题(firstText),
+ * 渲染成清单交给 merge 层用 recent_matters 的 mergePrompt 重写全文,落盘 preferences/recent_matters.md。
+ * 与单会话 extract(recent_matters 已从中移除)互补:后者抽「当下这个会话」,这里总结「最近整体方向」。 */
+import { createHash } from 'node:crypto';
+import { libraryLessonsDir } from '../layout.js';
+import { loadLibraryIndex, rebuildUnifiedIndex } from '../library/index-file.js';
+import { ensureLessonsLayout } from './layout.js';
+import { LocalStorageAdapter } from './storage.js';
+import { readLlmConfig } from './config.js';
+import { DeepSeekLlm } from './llm.js';
+import { loadExistingMemories } from './existing.js';
+import { mergeMemories } from './merge.js';
+import { applyOperations } from './write.js';
+import { buildMemoryDiff, readSessionDiff, writeMemoryDiff } from './audit.js';
+/** 聚合窗口:最近多少个会话参与「近期方向」总结。shortcut: 要调再抽配置。 */
+const RECENT_SESSION_LIMIT = 30;
+/** 按 startedAt 降序取最近 limit 个会话;缺 startedAt 的排到末尾(视为最旧)。 */
+export function pickRecentSessions(index, limit = RECENT_SESSION_LIMIT) {
+    return Object.values(index.sessions)
+        .sort((a, b) => ((b.startedAt ?? '') > (a.startedAt ?? '') ? 1 : -1))
+        .slice(0, limit);
+}
+/** 项目标识:cwd 取最后两段(如 orca/trove、du/teamwork-repos),去掉 /Users/admin 等前缀噪音;无 cwd 返回空串。 */
+function projectOf(cwd) {
+    if (!cwd)
+        return '';
+    return cwd.split('/').filter(Boolean).slice(-2).join('/');
+}
+/** 主题:firstText 优先,按码点截断到 100 字(不切断 emoji 代理对);空则回退 title。 */
+function topicOf(s) {
+    const t = (s.firstText ?? s.title ?? '').trim().replace(/\s+/g, ' ');
+    return t.length > 100 ? `${[...t].slice(0, 100).join('')}…` : t;
+}
+/** 会话事件总数:variants 求和,作为「投入规模」信号(讨论深浅)。 */
+function totalEvents(s) {
+    return s.variants.reduce((n, v) => n + v.events, 0);
+}
+/** 全量索引按项目聚类:会话数、首次/最近时间、累计事件数。无 cwd 不聚类(视为一次性)。 */
+export function buildProjectStats(index) {
+    const map = new Map();
+    for (const s of Object.values(index.sessions)) {
+        const project = projectOf(s.cwd);
+        if (!project)
+            continue;
+        const st = map.get(project) ?? { count: 0, events: 0 };
+        st.count += 1;
+        st.events += totalEvents(s);
+        const t = s.startedAt;
+        if (t) {
+            if (!st.first || t < st.first)
+                st.first = t;
+            if (!st.last || t > st.last)
+                st.last = t;
+        }
+        map.set(project, st);
+    }
+    return map;
+}
+/** 单行第 4 段:频繁度(同类次数·首末时间)与事件规模;无 stats 时只标事件数。 */
+function freqLabel(s, stats) {
+    const project = projectOf(s.cwd);
+    const st = project ? stats?.get(project) : undefined;
+    const parts = [];
+    if (st && st.count > 1) {
+        parts.push(`同类 ${st.count} 次`);
+        if (st.first && st.last && st.first !== st.last)
+            parts.push(`${st.first.slice(0, 10)}~${st.last.slice(0, 10)}`);
+    }
+    parts.push(`事件 ${totalEvents(s)} 条`);
+    return parts.join(' · ');
+}
+/** 渲染最近会话清单:每行 日期 | 项目 | 主题 | 频繁度,交给 mergePrompt 让 LLM 分档总结方向。 */
+export function renderRecentList(sessions, stats) {
+    const lines = sessions.map((s) => {
+        const date = (s.startedAt ?? '').slice(0, 10) || '(无时间)';
+        const project = projectOf(s.cwd) || '(项目未知)';
+        const topic = topicOf(s) || '(无主题)';
+        return `- ${date} | ${project} | ${topic} | ${freqLabel(s, stats)}`;
+    });
+    return ['以下为最近会话清单(按时间倒序):', ...lines].join('\n');
+}
+/** 输入指纹:最近会话的身份+时间+事件规模,新会话、排序或规模变化即变;用于滚动幂等,输入不变不重跑 LLM。 */
+export function recentInputHash(sessions) {
+    const body = sessions.map((s) => `${s.harness}:${s.session}@${s.startedAt ?? ''}#${totalEvents(s)}`).join('\n');
+    return createHash('sha256').update(body).digest('hex');
+}
+/** recent 渠道编排:幂等键 audit/recent-matters.json 的 inputHash 字段,hash 不变则 skip(滚动不无谓烧 token)。 */
+export async function learnRecentMatters(vaultRoot, deps = {}, opts = {}) {
+    await ensureLessonsLayout(vaultRoot);
+    const storage = new LocalStorageAdapter(libraryLessonsDir(vaultRoot));
+    const index = (await loadLibraryIndex(vaultRoot)) ?? (await rebuildUnifiedIndex(vaultRoot));
+    const sessions = pickRecentSessions(index);
+    if (sessions.length === 0)
+        return { skipReason: 'no_sessions' };
+    const hash = recentInputHash(sessions);
+    const prev = await readSessionDiff(storage, 'recent-matters');
+    if (!opts.force && prev?.inputHash === hash)
+        return { skipReason: 'unchanged' };
+    const llm = deps.llm ?? new DeepSeekLlm(readLlmConfig(deps.config));
+    const candidates = [
+        { type: 'preferences/recent_matters', title: '用户近期工作方向聚合', content: renderRecentList(sessions, buildProjectStats(index)), evidence: [] },
+    ];
+    const existing = await loadExistingMemories(storage);
+    const ops = await mergeMemories(candidates, existing, { llm });
+    await applyOperations(ops, { storage, now: deps.now, source: 'recent-matters' });
+    const diff = buildMemoryDiff(ops, { sessionId: 'recent-matters', project: 'cross-session' });
+    const withHash = { ...diff, inputHash: hash };
+    await writeMemoryDiff(withHash, storage);
+    return { diff: withHash };
+}
+//# sourceMappingURL=recent.js.map

package/dist/core/lessons/recent.js.map

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

package/dist/core/lessons/schema.d.ts

@@ -0,0 +1,26 @@
+/** 17 类记忆类型的 Schema 定义与校验。类型标识 key 统一用复数目录前缀(0.2 口径)。 */
+export type MergeOp = 'add' | 'patch' | 'append';
+export interface MemoryTypeSchema {
+    /** 唯一标识,如 `experiences/debug_pattern`。 */
+    key: string;
+    /** 一级目录,用于 INDEX 分区:preferences/entities/experiences/events/resources。 */
+    category: string;
+    /** 相对 lessons 根的文件名模板,含 `{slug}`/`{name}` 占位符或 `YYYY-MM-DD`。 */
+    filename: string;
+    mergeOp: MergeOp;
+    /** 提取提示词,引用 `{summary}`/`{events}` 占位符。 */
+    extractionPrompt: string;
+    /** 合并提示词,仅 patch 类需要,引用 `{summary}`/`{existing}`。 */
+    mergePrompt?: string;
+}
+export declare function validateMemoryTypes(defs: MemoryTypeSchema[]): void;
+export declare function listMemoryTypes(): MemoryTypeSchema[];
+export declare function getMemoryType(key: string): MemoryTypeSchema | undefined;
+/** 语义化 slug:小写、非法字符折成 `-`,保留 Unicode 字母数字(中文)。 */
+export declare function slugify(title: string): string;
+export declare function buildFilename(schema: MemoryTypeSchema, opts?: {
+    title?: string;
+    slug?: string;
+    name?: string;
+    date?: string;
+}): string;

package/dist/core/lessons/schema.js

@@ -0,0 +1,64 @@
+/** 17 类记忆类型的 Schema 定义与校验。类型标识 key 统一用复数目录前缀(0.2 口径)。 */
+function ex(kind) {
+    return `从会话 {summary} 与事件 {events} 中提取 ${kind} 相关记忆。`;
+}
+function merge(kind) {
+    return `把新提取的 ${kind} 相关 {summary} 合并进现有 {existing},去重、冲突以新为准、保留 evidence。`;
+}
+const DEFS = [
+    // 偏好 5 类(patch 合并到固定文件):画像聚焦「当前使用用户」,其余各司其职
+    { key: 'preferences/profile', category: 'preferences', filename: 'preferences/profile.md', mergeOp: 'patch', extractionPrompt: '围绕「当前使用用户」做用户画像:提取用户信息,覆盖 我是谁(姓名/身份)、年龄、职责(岗位/角色)、工作背景(经历/技术方向)、人际关系(同事/上下级/合作方)。只写会话中真实出现且确定的信息,推断或空值不写。', mergePrompt: '把新提取的用户画像 {summary} 合并进现有 {existing}:按 我是谁/年龄/职责/工作背景/人际关系 补齐缺失维度,同维度以新为准,去重并保留 evidence,不丢既有有效信息。' },
+    { key: 'preferences/coding_style', category: 'preferences', filename: 'preferences/coding_style.md', mergeOp: 'patch', extractionPrompt: '编码风格:用户偏好的代码规范、命名、注释、语言/框架取舍与工程习惯(测试、类型、目录结构等)。', mergePrompt: merge('编码风格') },
+    { key: 'preferences/writing_style', category: 'preferences', filename: 'preferences/writing_style.md', mergeOp: 'patch', extractionPrompt: '写作风格:用户偏好的语言(简体中文等)、语气、排版、用词与行文习惯。', mergePrompt: merge('写作风格') },
+    { key: 'preferences/dialogue_style', category: 'preferences', filename: 'preferences/dialogue_style.md', mergeOp: 'patch', extractionPrompt: '对话风格:用户对 AI 回复的称呼、口吻、详略与格式(列表/代码块、是否解释步骤)等偏好。', mergePrompt: merge('对话风格') },
+    { key: 'preferences/recent_matters', category: 'preferences', filename: 'preferences/recent_matters.md', mergeOp: 'patch', extractionPrompt: '最近事项:由跨会话聚合(recent.ts)按时间+项目+主题生成,不走单会话提取。', mergePrompt: '根据最近会话清单 {summary} 重写用户近期工作方向 {existing}。清单按会话时间倒序,每行含 日期|项目(cwd)|主题|频繁度(同类会话数·首次~最近时间·事件条数)。据此把近期事项分三档组织:①持续方向(同项目反复出现,同类≥2次或时间跨度长,长期推进);②近期一次性(仅1次、规模小,临时问题);③高优先级(对公司业务或个人很重要:上线、事故、决策、面试、健康、家庭等,结合主题文本判断重要性)。每档内按讨论频繁度与最近时间排序;已完成或久未出现的旧方向可移除,保持「近期」时效。' },
+    // 实体 5 类(卡片式,同名合并)
+    { key: 'entities/project', category: 'entities', filename: 'entities/projects/{slug}/overview.md', mergeOp: 'patch', extractionPrompt: ex('项目'), mergePrompt: merge('项目') },
+    { key: 'entities/people', category: 'entities', filename: 'entities/people/{name}.md', mergeOp: 'patch', extractionPrompt: ex('人物'), mergePrompt: merge('人物') },
+    { key: 'entities/organization', category: 'entities', filename: 'entities/organizations/{name}.md', mergeOp: 'patch', extractionPrompt: ex('组织'), mergePrompt: merge('组织') },
+    { key: 'entities/tool', category: 'entities', filename: 'entities/tools/{name}.md', mergeOp: 'patch', extractionPrompt: ex('工具'), mergePrompt: merge('工具') },
+    { key: 'entities/tech', category: 'entities', filename: 'entities/tech/{name}.md', mergeOp: 'patch', extractionPrompt: ex('技术栈'), mergePrompt: merge('技术栈') },
+    // 经验 4 类(debug/gotcha/correction 独立 add;workflow 合并 patch)
+    { key: 'experiences/debug_pattern', category: 'experiences', filename: 'experiences/debug-{slug}.md', mergeOp: 'add', extractionPrompt: ex('调试模式(错误现象→根因→解法)') },
+    { key: 'experiences/workflow', category: 'experiences', filename: 'experiences/workflow-{slug}.md', mergeOp: 'patch', extractionPrompt: ex('操作流程'), mergePrompt: merge('操作流程') },
+    { key: 'experiences/gotcha', category: 'experiences', filename: 'experiences/gotcha-{slug}.md', mergeOp: 'add', extractionPrompt: ex('陷阱坑') },
+    { key: 'experiences/correction', category: 'experiences', filename: 'experiences/correction-{slug}.md', mergeOp: 'add', extractionPrompt: ex('纠正教训(用户纠正了 AI 什么)') },
+    // 决策 1 类(add 独立,不合并)
+    { key: 'events/decision', category: 'events', filename: 'events/YYYY-MM-DD-decided-{slug}.md', mergeOp: 'add', extractionPrompt: ex('决策(用户拍板的方向/取舍)') },
+    // 资源 3 类(append 追加,不去重)
+    { key: 'resources/doc', category: 'resources', filename: 'resources/docs/{slug}.md', mergeOp: 'append', extractionPrompt: ex('文档资源') },
+    { key: 'resources/repo', category: 'resources', filename: 'resources/repos/{slug}.md', mergeOp: 'append', extractionPrompt: ex('代码仓库资源') },
+    { key: 'resources/link', category: 'resources', filename: 'resources/links/{slug}.md', mergeOp: 'append', extractionPrompt: ex('链接资源') },
+];
+export function validateMemoryTypes(defs) {
+    for (const d of defs) {
+        if (!d.key || !d.category || !d.filename || !d.mergeOp) {
+            throw new Error(`Memory Schema 缺字段:${JSON.stringify(d)}`);
+        }
+        if (!d.extractionPrompt)
+            throw new Error(`缺少提取提示词:${d.key}`);
+        if (d.mergeOp === 'patch' && !d.mergePrompt)
+            throw new Error(`缺少合并提示词:${d.key}`);
+    }
+}
+export function listMemoryTypes() {
+    validateMemoryTypes(DEFS);
+    return DEFS;
+}
+export function getMemoryType(key) {
+    return listMemoryTypes().find((t) => t.key === key);
+}
+/** 语义化 slug:小写、非法字符折成 `-`,保留 Unicode 字母数字(中文)。 */
+export function slugify(title) {
+    const s = title.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, '-').replace(/^-+|-+$/g, '');
+    return s || 'item';
+}
+export function buildFilename(schema, opts = {}) {
+    const slug = opts.slug ?? slugify(opts.title ?? '');
+    const date = opts.date ?? new Date().toISOString().slice(0, 10);
+    return schema.filename
+        .replace(/\{slug\}/g, slug)
+        .replace(/\{name\}/g, opts.name ?? slug)
+        .replace(/YYYY-MM-DD/g, date);
+}
+//# sourceMappingURL=schema.js.map

package/dist/core/lessons/schema.js.map

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

package/dist/core/lessons/select.d.ts

@@ -0,0 +1,19 @@
+/** 会话选择(Stage 3):只排除「仍在进行中」的会话;然后过滤掉噪音事件,保留完整对话内容(文字永不删),瘦身交给后续 Jev 压缩。纯确定性,不调模型。 */
+import type { Event } from '../events/schema.js';
+export type SkipReason = 'in_progress';
+export type SessionSelection = {
+    status: 'selected';
+    events: Event[];
+} | {
+    status: 'skipped';
+    reason: SkipReason;
+};
+export declare function selectSession(events: Event[], now?: Date): SessionSelection;
+/** 超长文本截断:前 600 + `...` + 后 600;省略标记 3 字符,叠在 1200 内容预算之上。按码点切,emoji 等代理对不会被劈开(按码元切会产生孤立代理项,导致 JSON.stringify 输出非法 \udXXX 转义)。 */
+export declare function truncateText(text: string): string;
+/** 有内容事件:user/assistant 文字消息、tool_call、tool_result(成功与失败都保留)。system/reasoning/meta 等模板噪音在此丢弃。 */
+export declare function isContentfulEvent(e: Event): boolean;
+export declare function filterEvents(events: Event[]): Event[];
+/** 按 seq 排序后取首尾各 40(≤80 条);≤80 时原样返回(已排序)。 */
+export declare function truncateEvents(events: Event[]): Event[];
+export declare function truncateEvent(e: Event): Event;

package/dist/core/lessons/select.js

@@ -0,0 +1,55 @@
+export function selectSession(events, now = new Date()) {
+    if (now.getTime() - updatedAtMs(events) < 5 * 60 * 1000) {
+        return { status: 'skipped', reason: 'in_progress' };
+    }
+    return { status: 'selected', events: filterEvents(events) };
+}
+/** 会话最后活动时间 = 事件里最大的可解析 ts(毫秒);无有效 ts 记为 0,视为早就结束。 */
+function updatedAtMs(events) {
+    let max = 0;
+    for (const e of events) {
+        const t = Date.parse(e.ts ?? '');
+        if (Number.isFinite(t) && t > max)
+            max = t;
+    }
+    return max;
+}
+const TRUNCATE_MAX = 1200;
+/** 超长文本截断:前 600 + `...` + 后 600;省略标记 3 字符,叠在 1200 内容预算之上。按码点切,emoji 等代理对不会被劈开(按码元切会产生孤立代理项,导致 JSON.stringify 输出非法 \udXXX 转义)。 */
+export function truncateText(text) {
+    if (text.length <= TRUNCATE_MAX)
+        return text;
+    const chars = [...text];
+    return chars.length <= TRUNCATE_MAX ? text : `${chars.slice(0, 600).join('')}...${chars.slice(-600).join('')}`;
+}
+/** 有内容事件:user/assistant 文字消息、tool_call、tool_result(成功与失败都保留)。system/reasoning/meta 等模板噪音在此丢弃。 */
+export function isContentfulEvent(e) {
+    if (e.kind === 'message')
+        return e.role === 'user' || e.role === 'assistant';
+    if (e.kind === 'tool_call')
+        return true;
+    if (e.kind === 'tool_result')
+        return true;
+    return false;
+}
+export function filterEvents(events) {
+    return events.filter(isContentfulEvent);
+}
+/** 按 seq 排序后取首尾各 40(≤80 条);≤80 时原样返回(已排序)。 */
+export function truncateEvents(events) {
+    const sorted = [...events].sort((a, b) => a.seq - b.seq);
+    if (sorted.length <= 80)
+        return sorted;
+    return [...sorted.slice(0, 40), ...sorted.slice(-40)];
+}
+// shortcut: 只截断顶层 text 与字符串 result.output,parts/tool.input 不截,等阶段 5 需要时再补。
+export function truncateEvent(e) {
+    const out = { ...e };
+    if (out.text)
+        out.text = truncateText(out.text);
+    if (typeof out.result?.output === 'string') {
+        out.result = { ...out.result, output: truncateText(out.result.output) };
+    }
+    return out;
+}
+//# sourceMappingURL=select.js.map

package/dist/core/lessons/select.js.map

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

package/dist/core/lessons/sidecar.d.ts

@@ -0,0 +1,23 @@
+/** Sidecar 分层存储(L0/L1/L2):为 lessons 各目录生成 .abstract.md(L0) 与 .overview.md(L1),自底向上刷新。 */
+import type { StorageAdapter } from './storage.js';
+export interface SidecarDir {
+    /** 相对 lessons 根的目录路径;根为 ''。 */
+    path: string;
+    /** H1 标题(也是该目录的中文名)。 */
+    name: string;
+    /** 一句话简介(= L0 正文,亦为 L1 的 Brief)。 */
+    brief: string;
+}
+export declare const SIDECAR_DIRS: SidecarDir[];
+/** 从 L1 提取 Brief(H1 之后、首个 ## 之前的那段话),作为 L0 正文的唯一来源。 */
+export declare function extractBrief(overviewText: string): string;
+/** 强制重建根 + 5 大类目录的 sidecar;返回写入的相对路径。 */
+export declare function refreshSidecars(storage: StorageAdapter, opts?: {
+    trigger?: string;
+    now?: () => Date;
+}): Promise<string[]>;
+/** 写入记忆后标记目录变脏:L0/L1 未跨 10% 阈值时只递增 pending,否则整目录刷新。 */
+export declare function touchSidecars(storage: StorageAdapter, dirPaths: string[], opts?: {
+    trigger?: string;
+    now?: () => Date;
+}): Promise<string[]>;