trove-cli 0.0.0-stage → 0.2.0

package/dist/core/lessons/layout.js

@@ -0,0 +1,56 @@
+/** lessons 目录骨架(0.2 实体化口径)的幂等初始化。INDEX.md 初始为空索引但分区标题齐全。 */
+import { constants } from 'node:fs';
+import { access, mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { libraryLessonsDir } from '../layout.js';
+const SUBDIRS = [
+    'preferences',
+    'entities/projects',
+    'entities/people',
+    'entities/organizations',
+    'entities/tools',
+    'entities/tech',
+    'experiences',
+    'events',
+    'resources/docs',
+    'resources/repos',
+    'resources/links',
+    'archive/preferences',
+    'archive/entities',
+    'archive/experiences',
+    'archive/events',
+    'archive/resources',
+];
+export const INDEX_TEMPLATE = [
+    '# INDEX',
+    '',
+    '## Preferences',
+    '',
+    '## Entities',
+    '',
+    '## Experiences',
+    '',
+    '## Events',
+    '',
+    '## Resources',
+    '',
+].join('\n');
+const OVERVIEW_TEMPLATE = '# 学习沉淀概览\n\n';
+export async function ensureLessonsLayout(vaultRoot) {
+    const root = libraryLessonsDir(vaultRoot);
+    await mkdir(root, { recursive: true });
+    for (const sub of SUBDIRS) {
+        await mkdir(join(root, sub), { recursive: true });
+    }
+    await ensureFile(join(root, 'INDEX.md'), INDEX_TEMPLATE);
+    await ensureFile(join(root, '.overview.md'), OVERVIEW_TEMPLATE);
+}
+async function ensureFile(path, content) {
+    try {
+        await access(path, constants.F_OK);
+    }
+    catch {
+        await writeFile(path, content, 'utf8');
+    }
+}
+//# sourceMappingURL=layout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../src/core/lessons/layout.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,OAAO,GAAG;IACd,aAAa;IACb,mBAAmB;IACnB,iBAAiB;IACjB,wBAAwB;IACxB,gBAAgB;IAChB,eAAe;IACf,aAAa;IACb,QAAQ;IACR,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,qBAAqB;IACrB,kBAAkB;IAClB,qBAAqB;IACrB,gBAAgB;IAChB,mBAAmB;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS;IACT,EAAE;IACF,gBAAgB;IAChB,EAAE;IACF,aAAa;IACb,EAAE;IACF,gBAAgB;IAChB,EAAE;IACF,WAAW;IACX,EAAE;IACF,cAAc;IACd,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,SAAiB;IACzD,MAAM,IAAI,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,cAAc,CAAC,CAAC;IACzD,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,iBAAiB,CAAC,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,OAAe;IACrD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,38 @@
+import type { Event } from '../events/schema.js';
+import type { Config } from '../../config.js';
+import type { LlmProvider } from './llm.js';
+import type { JevProvider } from './jev.js';
+import type { MemoryDiff } from './audit.js';
+export interface LessonProviderDeps {
+    llm?: LlmProvider;
+    jev?: JevProvider;
+    /** 可控时钟,测试注入;缺省系统时间。 */
+    now?: () => Date;
+    /** 覆盖环境变量;缺省读 process.env。 */
+    env?: Record<string, string | undefined>;
+    /** token 用量台账路径;缺省 ~/.trove/usage.jsonl。 */
+    usagePath?: string;
+    /** 模型端点配置(~/.trove/config.json 的 llm/jev 段);缺省由调用方注入。 */
+    config?: Pick<Config, 'llm' | 'jev'>;
+}
+export interface ExtractionOutcome {
+    diff?: MemoryDiff;
+    skipReason?: string;
+}
+/** 从统一索引解析单会话的 canonical 事件;裸 session 错配多个 harness 时报歧义。 */
+export declare function loadSessionEvents(vaultRoot: string, sessionId: string): Promise<Event[]>;
+/** 对单会话跑全链路;被过滤(阶段 4)时不落任何记忆文件,通过 skipReason 区分。 */
+export declare function runLessonExtraction(vaultRoot: string, sessionId: string, deps?: LessonProviderDeps, opts?: {
+    force?: boolean;
+}): Promise<ExtractionOutcome>;
+/**
+ * 从队列取最多 batch 个候选,逐个跑流水线;处理完(成功/被过滤/失败)都出队,失败落 .failed 标记。
+ * 只学队列里的「本轮新会话」,历史会话走 `trove learn <id>` 手动补。缺配置时不 drain 队列。
+ */
+export declare function learnPendingBatch(vaultRoot: string, queuePath: string, deps?: LessonProviderDeps, batch?: number, opts?: {
+    log?: (line: string) => void;
+}): Promise<string | undefined>;
+/** 手动批量学习:取最近 limit 个未学习会话逐条跑提取,与 daemon 队列学习互不影响。 */
+export declare function learnRecentBatch(vaultRoot: string, limit: number, deps?: LessonProviderDeps, opts?: {
+    log?: (line: string) => void;
+}): Promise<string>;

package/dist/core/lessons/learn.js

@@ -0,0 +1,190 @@
+/** 阶段 9:经验提取的编排入口。把「选会话 → 跑流水线 → 批量跳过已审计」接到 CLI 与 daemon。 */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { libraryDir, libraryLessonsDir } from '../layout.js';
+import { trovePaths } from '../../paths.js';
+import { loadLibraryIndex, rebuildUnifiedIndex } from '../library/index-file.js';
+import { ensureLessonsLayout } from './layout.js';
+import { LocalStorageAdapter } from './storage.js';
+import { readLlmConfig, readJevConfig } from './config.js';
+import { DeepSeekLlm, LlmParseError } from './llm.js';
+import { createUsageSink } from './usage.js';
+import { TypeSafeJevScorer } from './jev.js';
+import { buildLessonGraph } from './graph.js';
+import { readLearnQueue, removeLearn } from './queue.js';
+/** 从统一索引解析单会话的 canonical 事件;裸 session 错配多个 harness 时报歧义。 */
+export async function loadSessionEvents(vaultRoot, sessionId) {
+    const index = (await loadLibraryIndex(vaultRoot)) ?? (await rebuildUnifiedIndex(vaultRoot));
+    const matches = Object.values(index.sessions).filter((s) => s.session === sessionId || `${s.harness}:${s.session}` === sessionId);
+    if (matches.length === 0)
+        throw new Error(`没有找到会话:${sessionId}`);
+    if (matches.length > 1) {
+        const keys = matches.map((s) => `${s.harness}:${s.session}`).join('、');
+        throw new Error(`会话 ${sessionId} 存在歧义:命中多个 harness(${keys}),请用 harness:session 指定`);
+    }
+    const s = matches[0];
+    const path = join(libraryDir(vaultRoot), ...s.canonical.path.split('/'));
+    const text = await readFile(path, 'utf8');
+    const events = [];
+    for (const line of text.split('\n')) {
+        if (!line.trim())
+            continue;
+        try {
+            events.push(JSON.parse(line));
+        }
+        catch {
+            // 跳过无法解析的行,镜像 index-file 的容错口径
+        }
+    }
+    return events;
+}
+function resolveProviders(deps) {
+    // 懒构造:LLM/Jev 配置缺失时由调用方决定跳过还是报错,不拖垮无关命令与 daemon。
+    const usagePath = deps.usagePath ?? trovePaths(deps.env?.TROVE_HOME).usageLog;
+    const llm = deps.llm ?? new DeepSeekLlm(readLlmConfig(deps.config), { onUsage: createUsageSink(usagePath) });
+    const jev = deps.jev ?? new TypeSafeJevScorer(readJevConfig(deps.config));
+    return { llm, jev };
+}
+/** 对单会话跑全链路;被过滤(阶段 4)时不落任何记忆文件,通过 skipReason 区分。 */
+export async function runLessonExtraction(vaultRoot, sessionId, deps = {}, opts = {}) {
+    await ensureLessonsLayout(vaultRoot);
+    const storage = new LocalStorageAdapter(libraryLessonsDir(vaultRoot));
+    // 幂等键 = audit/<sessionId>.json:已提取过默认跳过,force 强制重跑(配合 merge 层幂等不翻倍)。
+    if (!opts.force && (await storage.exists(`audit/${sessionId}.json`))) {
+        return { skipReason: 'already_learned' };
+    }
+    const { llm, jev } = resolveProviders(deps);
+    const graph = buildLessonGraph({
+        llm,
+        jev,
+        storage,
+        loadEvents: (id) => loadSessionEvents(vaultRoot, id),
+        now: deps.now,
+    });
+    const out = await graph.invoke({ sessionId }).catch((e) => {
+        // 模型重试后仍输出非 JSON:当跳过忽略,不记失败;落 skipped 标记阻止反复重跑。
+        if (e instanceof LlmParseError)
+            return null;
+        throw e;
+    });
+    if (out === null) {
+        await storage
+            .write(`audit/${sessionId}.skipped.json`, JSON.stringify({ session_id: sessionId, reason: 'llm_parse_failed', at: new Date().toISOString() }, null, 2))
+            .catch(() => { });
+        return { skipReason: 'llm_parse_failed' };
+    }
+    if (out.skip) {
+        // 只在「进行中」豁免:会话尚未结束,等结束后重新进入候选;其余跳过(摘要 trivial/无分类/Jev 低分)落标记,避免反复分析。
+        if (out.skip.reason !== 'in_progress') {
+            // 落盘失败不视为提取失败:最多下次再分析一次,不误报 .failed。
+            await storage
+                .write(`audit/${sessionId}.skipped.json`, JSON.stringify({ session_id: sessionId, reason: out.skip.reason, at: new Date().toISOString() }, null, 2))
+                .catch(() => { });
+        }
+        return { skipReason: out.skip.reason };
+    }
+    return { diff: out.diff };
+}
+/**
+ * 从队列取最多 batch 个候选,逐个跑流水线;处理完(成功/被过滤/失败)都出队,失败落 .failed 标记。
+ * 只学队列里的「本轮新会话」,历史会话走 `trove learn <id>` 手动补。缺配置时不 drain 队列。
+ */
+export async function learnPendingBatch(vaultRoot, queuePath, deps = {}, batch = 3, opts = {}) {
+    const ids = await readLearnQueue(queuePath);
+    if (ids.length === 0)
+        return undefined;
+    let providers;
+    try {
+        providers = resolveProviders(deps);
+    }
+    catch (e) {
+        opts.log?.(`跳过经验提取:${e.message}`);
+        return undefined;
+    }
+    const candidates = ids.slice(0, batch);
+    const storage = new LocalStorageAdapter(libraryLessonsDir(vaultRoot));
+    let extracted = 0;
+    let skipped = 0;
+    let failed = 0;
+    for (const key of candidates) {
+        try {
+            const outcome = await runLessonExtraction(vaultRoot, key, { llm: providers.llm, jev: providers.jev, now: deps.now });
+            if (outcome.skipReason) {
+                skipped++;
+                opts.log?.(`会话 ${key} 未达阈值,跳过:${outcome.skipReason}`);
+            }
+            else {
+                extracted++;
+                const d = outcome.diff?.summary;
+                opts.log?.(`会话 ${key} 提取完成:新增 ${d?.adds ?? 0}、更新 ${d?.updates ?? 0}、跳过 ${d?.skips ?? 0}`);
+            }
+        }
+        catch (e) {
+            failed++;
+            const msg = e.message;
+            // 落失败标记,阻止同一坏会话被反复重跑完整 LLM 流水线;标记可删后重试。
+            await storage.write(`audit/${key}.failed.json`, JSON.stringify({ session_id: key, error: msg, at: new Date().toISOString() }, null, 2)).catch(() => { });
+            opts.log?.(`会话 ${key} 提取失败:${msg}`);
+        }
+    }
+    await removeLearn(queuePath, candidates);
+    const remaining = (await readLearnQueue(queuePath)).length;
+    return `经验提取:新增 ${extracted} · 跳过 ${skipped} · 失败 ${failed} · 待办 ${remaining}`;
+}
+/** 从统一索引按 startedAt 降序取最多 limit 个「未学习」会话 key(harness:session)。 */
+async function recentUnlearnedKeys(vaultRoot, limit) {
+    const index = (await loadLibraryIndex(vaultRoot)) ?? (await rebuildUnifiedIndex(vaultRoot));
+    const storage = new LocalStorageAdapter(libraryLessonsDir(vaultRoot));
+    const entries = Object.values(index.sessions).sort((a, b) => (b.startedAt ?? '') > (a.startedAt ?? '') ? 1 : -1);
+    const keys = [];
+    for (const s of entries) {
+        const key = `${s.harness}:${s.session}`;
+        // 已成功(.json)或已失败(.failed.json)都算已处理;双形式兜底历史裸 session 落盘。
+        const handled = (await storage.exists(`audit/${key}.json`)) ||
+            (await storage.exists(`audit/${s.session}.json`)) ||
+            (await storage.exists(`audit/${key}.failed.json`)) ||
+            (await storage.exists(`audit/${s.session}.failed.json`)) ||
+            (await storage.exists(`audit/${key}.skipped.json`)) ||
+            (await storage.exists(`audit/${s.session}.skipped.json`));
+        if (!handled)
+            keys.push(key);
+        if (keys.length >= limit)
+            break;
+    }
+    return keys;
+}
+/** 手动批量学习:取最近 limit 个未学习会话逐条跑提取,与 daemon 队列学习互不影响。 */
+export async function learnRecentBatch(vaultRoot, limit, deps = {}, opts = {}) {
+    const keys = await recentUnlearnedKeys(vaultRoot, limit);
+    if (keys.length === 0)
+        return '没有可学习的会话(都已学习或索引为空)';
+    // 缺配置在此抛出,与单条 `trove learn <id>` 一致,不静默吞掉手动触发的错误。
+    const { llm, jev } = resolveProviders(deps);
+    const storage = new LocalStorageAdapter(libraryLessonsDir(vaultRoot));
+    let extracted = 0;
+    let skipped = 0;
+    let failed = 0;
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        try {
+            const outcome = await runLessonExtraction(vaultRoot, key, { llm, jev, now: deps.now });
+            if (outcome.skipReason) {
+                skipped++;
+                opts.log?.(`[${i + 1}/${keys.length}] ${key} 未达阈值,跳过:${outcome.skipReason}`);
+            }
+            else {
+                extracted++;
+                const d = outcome.diff?.summary;
+                opts.log?.(`[${i + 1}/${keys.length}] ${key} 完成:新增 ${d?.adds ?? 0}、更新 ${d?.updates ?? 0}、跳过 ${d?.skips ?? 0}`);
+            }
+        }
+        catch (e) {
+            failed++;
+            const msg = e.message;
+            await storage.write(`audit/${key}.failed.json`, JSON.stringify({ session_id: key, error: msg, at: new Date().toISOString() }, null, 2)).catch(() => { });
+            opts.log?.(`[${i + 1}/${keys.length}] ${key} 失败:${msg}`);
+        }
+    }
+    return `经验提取完成:新增 ${extracted} · 跳过 ${skipped} · 失败 ${failed} · 共 ${keys.length} 个会话`;
+}
+//# sourceMappingURL=learn.js.map

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

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

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

@@ -0,0 +1,42 @@
+import type { LlmConfig } from './config.js';
+import type { UsageSink } from './usage.js';
+export interface LlmProvider {
+    /**
+     * 用提示词生成符合给定 JSON Schema 的对象。schema 为 JSON Schema 对象描述。
+     * task 只用于 token 用量归因(如 learn:summarize),不影响生成结果。
+     */
+    generate<T>(prompt: string, schema: Record<string, unknown>, task?: string): Promise<T>;
+}
+export interface DeepSeekLlmOptions {
+    /** 每次调用后上报 token 用量;上报失败不影响生成结果。 */
+    onUsage?: UsageSink;
+}
+/** DeepSeek(OpenAI 兼容)实现:json_object 模式返回纯 JSON,内容手动解析(DeepSeek 不支持 json_schema 的 response_format)。 */
+export declare class DeepSeekLlm implements LlmProvider {
+    private options;
+    private llm;
+    private model;
+    constructor(config: LlmConfig, options?: DeepSeekLlmOptions);
+    generate<T>(prompt: string, schema: Record<string, unknown>, task?: string): Promise<T>;
+    private invokeText;
+}
+export interface MessageUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+/** 从 LangChain AIMessage 提取 token 用量:优先 usage_metadata,回退 OpenAI 的 response_metadata.tokenUsage。 */
+export declare function usageOfMessage(res: unknown): MessageUsage | null;
+/** 模型返回文本无法解析为 JSON 时抛出;区别于网络/服务错误,供上层决定「重试后忽略」还是「记失败」。 */
+export declare class LlmParseError extends Error {
+    constructor(message: string);
+}
+/** 清洗 LLM 返回文本(去掉 ```json 围栏与首尾空白)并解析为对象;失败抛 LlmParseError。 */
+export declare function parseJsonObject<T>(text: string): T;
+export type LlmResponder = (prompt: string, schema: Record<string, unknown>, task?: string) => unknown | Promise<unknown>;
+/** mock 实现:按注入的回调返回固定对象,不发起任何网络请求。 */
+export declare class MockLlm implements LlmProvider {
+    private responder;
+    constructor(responder: LlmResponder);
+    generate<T>(prompt: string, schema: Record<string, unknown>, task?: string): Promise<T>;
+}

package/dist/core/lessons/llm.js

@@ -0,0 +1,106 @@
+/** LLM 抽象:给提示词 + 期望的 JSON 结构,返回解析后的对象。一期接 DeepSeek,测试用 mock 注入固定返回。 */
+import { ChatOpenAI } from '@langchain/openai';
+/** DeepSeek(OpenAI 兼容)实现:json_object 模式返回纯 JSON,内容手动解析(DeepSeek 不支持 json_schema 的 response_format)。 */
+export class DeepSeekLlm {
+    options;
+    llm;
+    model;
+    constructor(config, options = {}) {
+        this.options = options;
+        this.model = config.model;
+        this.llm = new ChatOpenAI({
+            model: config.model,
+            apiKey: config.apiKey,
+            configuration: { baseURL: config.baseUrl },
+            modelKwargs: { response_format: { type: 'json_object' } },
+        });
+    }
+    async generate(prompt, schema, task = 'llm') {
+        // schema 注入 prompt 引导字段;json_object 要求 prompt 含 "json" 字样,故用 JSON Schema 措辞。
+        const full = `${prompt}\n\n按以下 JSON Schema 返回一个 JSON 对象,不要输出其它内容:\n${JSON.stringify(schema)}`;
+        try {
+            return parseJsonObject(await this.invokeText(full, task));
+        }
+        catch (e) {
+            if (!(e instanceof LlmParseError))
+                throw e;
+            // 纠错:模型偶尔无视 json_object 输出非 JSON(如写文档会话),重试一次并把格式约束说死。
+            const retry = `${full}\n\n上次输出不是合法 JSON。忽略原任务,只返回一个 JSON 对象,不要任何解释或原文。`;
+            return parseJsonObject(await this.invokeText(retry, task));
+        }
+    }
+    async invokeText(full, task) {
+        const res = await this.llm.invoke(full);
+        // tokens 已实际消耗:先记账再解析,解析失败也不能漏记;写盘失败不拖垮提取。
+        const usage = usageOfMessage(res);
+        if (usage) {
+            try {
+                await this.options.onUsage?.({ task, model: this.model, ...usage });
+            }
+            catch {
+                // 用量统计失败不影响生成
+            }
+        }
+        return typeof res.content === 'string' ? res.content : JSON.stringify(res.content);
+    }
+}
+/** 从 LangChain AIMessage 提取 token 用量:优先 usage_metadata,回退 OpenAI 的 response_metadata.tokenUsage。 */
+export function usageOfMessage(res) {
+    if (typeof res !== 'object' || res === null)
+        return null;
+    const r = res;
+    if (isObject(r.usage_metadata)) {
+        const m = r.usage_metadata;
+        const usage = normalize(intOf(m.input_tokens), intOf(m.output_tokens), intOf(m.total_tokens));
+        if (usage)
+            return usage;
+    }
+    const response = r.response_metadata;
+    if (isObject(response) && isObject(response.tokenUsage)) {
+        const m = response.tokenUsage;
+        const usage = normalize(intOf(m.promptTokens), intOf(m.completionTokens), intOf(m.totalTokens));
+        if (usage)
+            return usage;
+    }
+    return null;
+}
+function normalize(promptTokens, completionTokens, totalTokens) {
+    const total = totalTokens || promptTokens + completionTokens;
+    return promptTokens + completionTokens + total > 0
+        ? { promptTokens, completionTokens, totalTokens: total }
+        : null;
+}
+function isObject(v) {
+    return typeof v === 'object' && v !== null;
+}
+function intOf(v) {
+    return typeof v === 'number' && Number.isFinite(v) && v >= 0 ? Math.round(v) : 0;
+}
+/** 模型返回文本无法解析为 JSON 时抛出;区别于网络/服务错误,供上层决定「重试后忽略」还是「记失败」。 */
+export class LlmParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'LlmParseError';
+    }
+}
+/** 清洗 LLM 返回文本(去掉 ```json 围栏与首尾空白)并解析为对象;失败抛 LlmParseError。 */
+export function parseJsonObject(text) {
+    const cleaned = text.replace(/^```(?:json)?\s*/i, '').replace(/\s*```$/, '').trim();
+    try {
+        return JSON.parse(cleaned);
+    }
+    catch {
+        throw new LlmParseError(`LLM 返回无法解析为 JSON:${text.slice(0, 200)}`);
+    }
+}
+/** mock 实现:按注入的回调返回固定对象,不发起任何网络请求。 */
+export class MockLlm {
+    responder;
+    constructor(responder) {
+        this.responder = responder;
+    }
+    async generate(prompt, schema, task) {
+        return (await this.responder(prompt, schema, task));
+    }
+}
+//# sourceMappingURL=llm.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { MemoryCandidate } from './extract.js';
+import type { LessonProviderDeps, ExtractionOutcome } from './learn.js';
+/** 纯查表:Claude Code 记忆 type 映射到 trove type,未知 type 返回 undefined。 */
+export declare function mapClaudeMemoType(claudeType: string): string | undefined;
+export interface ClaudeMemo {
+    name: string;
+    description: string;
+    type: string;
+    /** frontmatter 之后的正文(已去首尾空白)。 */
+    body: string;
+}
+/** 解析 Claude Code 记忆文件的 YAML frontmatter。兼容两种变体:顶层 `type:` 或 `metadata:` 块下的 `type:`。 */
+export declare function parseClaudeMemo(text: string): ClaudeMemo | null;
+/** 遍历 claudeRoot/projects/<项目>/memory 下的 .md 记忆文件,解析并映射为候选;排除各项目的 MEMORY.md 索引。 */
+export declare function collectClaudeMemos(claudeRoot: string): Promise<MemoryCandidate[]>;
+/** memo 渠道编排:幂等键 audit/memo-claude-code.json。只构造 LLM(merge 的 patch/conflict 用),不构造 jev。 */
+export declare function learnClaudeMemo(vaultRoot: string, claudeRoot: string, deps?: LessonProviderDeps, opts?: {
+    force?: boolean;
+}): Promise<ExtractionOutcome>;

package/dist/core/lessons/memo.js

@@ -0,0 +1,170 @@
+/** 「memo 渠道」:学习 Claude Code 自带记忆系统(~/.claude/projects/<项目>/memory/*.md)。
+ * 与「会话渠道」(graph.ts)并行:记忆本身已是「标题+正文+明确 type」的结构化内容,
+ * 不归档、不走 select/analyze/extract,直接映射为 MemoryCandidate 复用 merge/write/audit 落盘。 */
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { libraryLessonsDir } from '../layout.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, writeMemoryDiff } from './audit.js';
+import { getMemoryType, slugify } from './schema.js';
+/** Claude Code 记忆 type → trove 17 类 type。映射表硬编码;project→gotcha 是近似兜底,要调再抽配置。 */
+const CLAUDE_MEMO_TYPE_MAP = {
+    user: 'preferences/profile',
+    feedback: 'experiences/correction',
+    project: 'experiences/gotcha',
+    reference: 'resources/doc',
+};
+/** 纯查表:Claude Code 记忆 type 映射到 trove type,未知 type 返回 undefined。 */
+export function mapClaudeMemoType(claudeType) {
+    return CLAUDE_MEMO_TYPE_MAP[claudeType];
+}
+/** 解析 Claude Code 记忆文件的 YAML frontmatter。兼容两种变体:顶层 `type:` 或 `metadata:` 块下的 `type:`。 */
+export function parseClaudeMemo(text) {
+    if (!text.startsWith('---'))
+        return null;
+    const close = text.indexOf('\n---', 4);
+    if (close === -1)
+        return null;
+    const fm = text.slice(4, close);
+    const body = text.slice(close + 4).trim();
+    let name = '';
+    let description = '';
+    let type = '';
+    let inMetadata = false;
+    for (const line of fm.split('\n')) {
+        if (inMetadata) {
+            // metadata 子块:缩进的 type 优先取顶层(顶层已有时不覆盖)
+            const m = /^\s+type\s*:\s*(.*)$/.exec(line);
+            if (m && !type)
+                type = m[1].trim();
+            continue;
+        }
+        if (/^metadata\s*:/.test(line)) {
+            inMetadata = true;
+            continue;
+        }
+        const m = /^(name|description|type)\s*:\s*(.*)$/.exec(line);
+        if (!m)
+            continue;
+        const val = m[2].trim();
+        if (m[1] === 'name')
+            name = val;
+        else if (m[1] === 'description')
+            description = val;
+        else if (m[1] === 'type')
+            type = val;
+    }
+    if (!type)
+        return null;
+    return { name, description, type, body };
+}
+/** 遍历 claudeRoot/projects/<项目>/memory 下的 .md 记忆文件,解析并映射为候选;排除各项目的 MEMORY.md 索引。 */
+export async function collectClaudeMemos(claudeRoot) {
+    const projectsRoot = join(claudeRoot, 'projects');
+    let projects = [];
+    try {
+        projects = (await readdir(projectsRoot, { withFileTypes: true }))
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+    const candidates = [];
+    for (const project of projects) {
+        const memDir = join(projectsRoot, project, 'memory');
+        let files = [];
+        try {
+            files = await readdir(memDir);
+        }
+        catch {
+            continue;
+        }
+        for (const f of files) {
+            if (f === 'MEMORY.md' || !f.endsWith('.md'))
+                continue;
+            let text;
+            try {
+                text = await readFile(join(memDir, f), 'utf8');
+            }
+            catch {
+                continue;
+            }
+            const memo = parseClaudeMemo(text);
+            if (!memo)
+                continue;
+            const troveType = mapClaudeMemoType(memo.type);
+            if (!troveType)
+                continue;
+            const title = (memo.description || memo.name).trim();
+            if (!title || !memo.body.trim())
+                continue;
+            candidates.push({
+                type: troveType,
+                title,
+                content: memo.body.trim(),
+                slug: slugify(memo.name || title),
+                evidence: [],
+            });
+        }
+    }
+    return mergeFixedPatchCandidates(candidates);
+}
+/** patch 到「固定文件名(无占位符)」的同 type 多条合并为一条:merge 层基于同一旧 existing 逐条 patch 会互相覆盖。 */
+function mergeFixedPatchCandidates(candidates) {
+    const groups = new Map();
+    const out = [];
+    for (const c of candidates) {
+        const schema = getMemoryType(c.type);
+        if (schema?.mergeOp === 'patch' && !schema.filename.includes('{')) {
+            const g = groups.get(c.type);
+            if (g)
+                g.push(c);
+            else
+                groups.set(c.type, [c]);
+        }
+        else {
+            out.push(c);
+        }
+    }
+    for (const group of groups.values()) {
+        if (group.length === 1) {
+            out.push(group[0]);
+        }
+        else {
+            out.push({
+                type: group[0].type,
+                title: group[0].title,
+                content: group.map((g) => g.content).join('\n\n'),
+                slug: group[0].slug,
+                evidence: [],
+            });
+        }
+    }
+    return out;
+}
+/** memo 渠道编排:幂等键 audit/memo-claude-code.json。只构造 LLM(merge 的 patch/conflict 用),不构造 jev。 */
+export async function learnClaudeMemo(vaultRoot, claudeRoot, deps = {}, opts = {}) {
+    await ensureLessonsLayout(vaultRoot);
+    const storage = new LocalStorageAdapter(libraryLessonsDir(vaultRoot));
+    if (!opts.force && (await storage.exists('audit/memo-claude-code.json'))) {
+        return { skipReason: 'already_learned' };
+    }
+    const candidates = await collectClaudeMemos(claudeRoot);
+    if (candidates.length === 0)
+        return { skipReason: 'no_memo' };
+    const llm = deps.llm ?? new DeepSeekLlm(readLlmConfig(deps.config));
+    const existing = await loadExistingMemories(storage);
+    const ops = await mergeMemories(candidates, existing, { llm });
+    await applyOperations(ops, { storage, now: deps.now, source: 'memo-claude-code' });
+    const diff = buildMemoryDiff(ops, { sessionId: 'memo-claude-code', project: 'claude-code' });
+    await writeMemoryDiff(diff, storage);
+    return { diff };
+}
+//# sourceMappingURL=memo.js.map