trove-cli 0.0.0-stage → 0.3.2

package/dist/core/lessons/analyze.js

@@ -0,0 +1,107 @@
+import { truncateText } from './select.js';
+const SUMMARY_SCHEMA = {
+    type: 'object',
+    properties: {
+        topic: { type: 'string' },
+        intent: { type: 'string' },
+        outcome: { type: 'string', enum: ['success', 'failure', 'partial', 'trivial'] },
+        keySteps: { type: 'array', items: { type: 'string' } },
+        hasError: { type: 'boolean' },
+        hasCorrection: { type: 'boolean' },
+        hasWorkflow: { type: 'boolean' },
+    },
+    required: ['topic', 'intent', 'outcome', 'keySteps', 'hasError', 'hasCorrection', 'hasWorkflow'],
+};
+const CLASSIFY_SCHEMA = {
+    type: 'object',
+    properties: {
+        preferences: { type: 'boolean' },
+        entities: { type: 'boolean' },
+        experiences: { type: 'boolean' },
+        events: { type: 'boolean' },
+        resources: { type: 'boolean' },
+    },
+    required: ['preferences', 'entities', 'experiences', 'events', 'resources'],
+};
+const SCORE_TASK_SUCCESS_MIN = 0.5;
+const SCORE_MEAN_MIN = 0.6;
+export async function summarizeSession(events, llm) {
+    const raw = await llm.generate(renderEvents(events), SUMMARY_SCHEMA, 'learn:summarize');
+    return validateSummary(raw);
+}
+export async function classifySession(summary, llm) {
+    const raw = await llm.generate(JSON.stringify(summary), CLASSIFY_SCHEMA, 'learn:classify');
+    return validateClassification(raw);
+}
+export function anyCategory(c) {
+    return c.preferences || c.entities || c.experiences || c.events || c.resources;
+}
+/** 阶段 4 总入口:摘要 → 分类 → 打分,任一不达标即跳过并说明原因。 */
+export async function analyzeSession(events, deps) {
+    const summary = await summarizeSession(events, deps.llm);
+    if (summary.outcome === 'trivial')
+        return { status: 'skip', reason: 'trivial' };
+    const classification = await classifySession(summary, deps.llm);
+    if (!anyCategory(classification))
+        return { status: 'skip', reason: 'no_category' };
+    // 只传有界转录而非完整 Event 对象:后者带未截断的 parts/tool.input/非字符串 output/extra,
+    // 体积远超 Jev 输入上限,会触发 max_tokens_exceeded。
+    const scores = await deps.jev.score({ summary, transcript: renderEvents(events) });
+    if (scores.taskSuccess < SCORE_TASK_SUCCESS_MIN || scores.meanScore < SCORE_MEAN_MIN) {
+        return { status: 'skip', reason: 'low_score', scores };
+    }
+    return { status: 'continue', summary, classification };
+}
+function validateSummary(raw) {
+    if (typeof raw !== 'object' || raw === null) {
+        throw new Error(`摘要解析失败:期望对象,得到 ${JSON.stringify(raw)}`);
+    }
+    const r = raw;
+    const outcome = r.outcome;
+    if (outcome !== 'success' && outcome !== 'failure' && outcome !== 'partial' && outcome !== 'trivial') {
+        throw new Error(`摘要 outcome 非法:${JSON.stringify(outcome)}`);
+    }
+    const steps = Array.isArray(r.keySteps) ? r.keySteps.map((s) => String(s)) : [];
+    return {
+        topic: String(r.topic ?? ''),
+        intent: String(r.intent ?? ''),
+        outcome,
+        keySteps: steps,
+        hasError: Boolean(r.hasError),
+        hasCorrection: Boolean(r.hasCorrection),
+        hasWorkflow: Boolean(r.hasWorkflow),
+    };
+}
+function validateClassification(raw) {
+    if (typeof raw !== 'object' || raw === null) {
+        throw new Error(`分类解析失败:期望对象,得到 ${JSON.stringify(raw)}`);
+    }
+    const r = raw;
+    return {
+        preferences: Boolean(r.preferences),
+        entities: Boolean(r.entities),
+        experiences: Boolean(r.experiences),
+        events: Boolean(r.events),
+        resources: Boolean(r.resources),
+    };
+}
+export function renderEvents(events) {
+    return events
+        .map((e) => {
+        const text = e.text ?? (typeof e.result?.output === 'string' ? e.result.output : '');
+        const kind = e.kind === 'tool_result' && e.result?.status === 'error' ? 'error' : e.kind;
+        let line = `[${e.seq}] ${kind}${text ? `: ${text}` : ''}`;
+        // 溯源:raw 文件行号 + tool 入参(可能含 URL/路径),供 resources 记忆完全可溯源。
+        if (e.raw)
+            line += ` @${e.raw.path}:${e.raw.line}`;
+        if (e.tool?.input !== undefined) {
+            const input = typeof e.tool.input === 'string' ? e.tool.input : JSON.stringify(e.tool.input);
+            // 截断:Write/Edit 等工具的入参可能含整篇文件内容,不截会让转录超模型上限。
+            if (input && input !== 'undefined')
+                line += ` (input: ${truncateText(input)})`;
+        }
+        return line;
+    })
+        .join('\n');
+}
+//# sourceMappingURL=analyze.js.map

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

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

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

@@ -0,0 +1,51 @@
+/** 阶段 8:审计日志。把阶段 6 的操作转成可回溯的 memory_diff 并落盘,提供人可读摘要。 */
+import type { MemoryOp } from './merge.js';
+import type { StorageAdapter } from './storage.js';
+export interface AddEntry {
+    uri: string;
+    title: string;
+    evidence: number[];
+}
+export interface UpdateEntry {
+    uri: string;
+    title: string;
+    before: string;
+    after: string;
+}
+export interface AppendEntry {
+    uri: string;
+}
+export interface SkipEntry {
+    type: string;
+    title: string;
+    reason: string;
+}
+export interface MemoryDiff {
+    session_id: string;
+    project: string;
+    extracted_at: string;
+    /** 可选:跨会话聚合(recent)的输入指纹,用于滚动幂等;会话/memo 渠道无此字段。 */
+    inputHash?: string;
+    operations: {
+        adds: AddEntry[];
+        updates: UpdateEntry[];
+        appends: AppendEntry[];
+        skips: SkipEntry[];
+    };
+    summary: {
+        adds: number;
+        updates: number;
+        appends: number;
+        skips: number;
+    };
+}
+export interface AuditContext {
+    sessionId: string;
+    project: string;
+    extractedAt?: string;
+}
+export declare function buildMemoryDiff(ops: MemoryOp[], ctx: AuditContext): MemoryDiff;
+export declare function writeMemoryDiff(diff: MemoryDiff, storage: StorageAdapter): Promise<void>;
+export declare function readLatestDiff(storage: StorageAdapter): Promise<MemoryDiff | null>;
+export declare function readSessionDiff(storage: StorageAdapter, sessionId: string): Promise<MemoryDiff | null>;
+export declare function formatDiff(diff: MemoryDiff): string;

package/dist/core/lessons/audit.js

@@ -0,0 +1,57 @@
+const LATEST_DIFF = 'memory_diff.json';
+export function buildMemoryDiff(ops, ctx) {
+    const adds = [];
+    const updates = [];
+    const appends = [];
+    const skips = [];
+    for (const op of ops) {
+        if (op.op === 'add')
+            adds.push({ uri: op.path, title: op.title, evidence: op.evidence });
+        else if (op.op === 'patch')
+            updates.push({ uri: op.path, title: op.title, before: op.before, after: op.content });
+        else if (op.op === 'append')
+            appends.push({ uri: op.path });
+        else
+            skips.push({ type: op.type, title: op.title, reason: op.reason });
+    }
+    return {
+        session_id: ctx.sessionId,
+        project: ctx.project,
+        extracted_at: ctx.extractedAt ?? new Date().toISOString(),
+        operations: { adds, updates, appends, skips },
+        summary: { adds: adds.length, updates: updates.length, appends: appends.length, skips: skips.length },
+    };
+}
+export async function writeMemoryDiff(diff, storage) {
+    const json = JSON.stringify(diff, null, 2);
+    await storage.write(LATEST_DIFF, json);
+    await storage.write(`audit/${diff.session_id}.json`, json);
+}
+export async function readLatestDiff(storage) {
+    return readDiffAt(storage, LATEST_DIFF);
+}
+export async function readSessionDiff(storage, sessionId) {
+    return readDiffAt(storage, `audit/${sessionId}.json`);
+}
+async function readDiffAt(storage, path) {
+    const text = await storage.read(path);
+    if (text === null)
+        return null;
+    return JSON.parse(text);
+}
+export function formatDiff(diff) {
+    const s = diff.summary;
+    if (s.adds + s.updates + s.appends + s.skips === 0)
+        return '本次无新增记忆';
+    const lines = [`本次新增 ${s.adds} 条、更新 ${s.updates} 条、追加 ${s.appends} 条、跳过 ${s.skips} 条`];
+    for (const a of diff.operations.adds)
+        lines.push(`  新增: ${a.title} (${a.uri})`);
+    for (const u of diff.operations.updates)
+        lines.push(`  更新: ${u.title} (${u.uri})`);
+    for (const a of diff.operations.appends)
+        lines.push(`  追加: ${a.uri}`);
+    for (const sk of diff.operations.skips)
+        lines.push(`  跳过: ${sk.title}（${sk.reason}）`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=audit.js.map

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

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

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

@@ -0,0 +1,5 @@
+/** LLM 分析前的 Jev 快速压缩:只保留关键 tool 调用对,user/assistant 文字永不删。参照 fast-jev-compaction。 */
+import type { Event } from '../events/schema.js';
+import type { JevProvider } from './jev.js';
+/** 对已过滤的 events 做 Jev 快速压缩;jev 不支持或判定失败时降级为确定性截断。 */
+export declare function compactEvents(events: Event[], jev: JevProvider): Promise<Event[]>;

package/dist/core/lessons/compaction.js

@@ -0,0 +1,58 @@
+import { renderEvents } from './analyze.js';
+import { truncateEvent, truncateEvents } from './select.js';
+const KEEP_THRESHOLD = 0.5;
+/** 调用对少于此数不值得调 Jev,直接走确定性兜底。 */
+const MIN_CALLS_TO_COMPACT = 15;
+/** 压缩后渲染文本的字符预算 ≈ 30k token(按 4 字符/token 粗估)。 */
+const MAX_RENDER_CHARS = 30_000 * 4;
+/** 对已过滤的 events 做 Jev 快速压缩;jev 不支持或判定失败时降级为确定性截断。 */
+export async function compactEvents(events, jev) {
+    const calls = collectCalls(events);
+    if (calls.length <= MIN_CALLS_TO_COMPACT || !jev.keepCalls)
+        return truncateFallback(events);
+    const questions = {};
+    for (const c of calls) {
+        questions[c.id] = { instructions: '该工具调用及其结果,是否为沉淀本会话可复用经验所必需的关键信息?' };
+    }
+    let keep;
+    try {
+        keep = await jev.keepCalls(renderEvents(events), questions);
+    }
+    catch {
+        // 压缩 best-effort:判定失败退回确定性截断,不让一次 noul 请求拖垮整条提取。
+        return truncateFallback(events);
+    }
+    const drop = new Set();
+    for (const c of calls) {
+        if ((keep[c.id] ?? KEEP_THRESHOLD) < KEEP_THRESHOLD) {
+            drop.add(c.callSeq);
+            if (c.resultSeq !== undefined)
+                drop.add(c.resultSeq);
+        }
+    }
+    const kept = events.filter((e) => !drop.has(e.seq)).map(truncateEvent);
+    // 压缩后仍超预算则整体退回确定性截断,保证 LLM 输入有界。
+    return renderEvents(kept).length > MAX_RENDER_CHARS ? truncateFallback(events) : kept;
+}
+/** 确定性兜底:首尾各 40 条 + 单字段 1200 字符截断。 */
+function truncateFallback(events) {
+    return truncateEvents(events).map(truncateEvent);
+}
+/** 提取 tool_call,按 call_id 关联其 tool_result;无 call_id 的 call 用 seq 作键。孤儿 result 不在返回中,天然保留。 */
+function collectCalls(events) {
+    const resultSeqByCall = new Map();
+    for (const e of events) {
+        const callId = e.kind === 'tool_result' ? e.result?.call_id : undefined;
+        if (callId)
+            resultSeqByCall.set(callId, e.seq);
+    }
+    const calls = [];
+    for (const e of events) {
+        if (e.kind !== 'tool_call')
+            continue;
+        const callId = e.tool?.call_id;
+        calls.push({ id: callId ?? String(e.seq), callSeq: e.seq, resultSeq: callId ? resultSeqByCall.get(callId) : undefined });
+    }
+    return calls;
+}
+//# sourceMappingURL=compaction.js.map

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

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

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

@@ -0,0 +1,15 @@
+/** 模型端点配置读取:从 ~/.trove/config.json 的 llm/jev 段读取,缺配置时明确报错而非静默失败。 */
+import type { Config } from '../../config.js';
+export interface LlmConfig {
+    baseUrl: string;
+    model: string;
+    apiKey: string;
+}
+export interface JevConfig {
+    apiKey: string;
+    model: string;
+    /** 缺省用官方端点;可指向代理/镜像 */
+    baseUrl?: string;
+}
+export declare function readLlmConfig(config?: Pick<Config, 'llm'>): LlmConfig;
+export declare function readJevConfig(config?: Pick<Config, 'jev'>): JevConfig;

package/dist/core/lessons/config.js

@@ -0,0 +1,31 @@
+export function readLlmConfig(config) {
+    const baseUrl = config?.llm?.baseUrl;
+    const model = config?.llm?.model;
+    const apiKey = config?.llm?.apiKey;
+    if (!baseUrl || !model || !apiKey) {
+        const missing = [
+            ['llm.baseUrl', baseUrl],
+            ['llm.model', model],
+            ['llm.apiKey', apiKey],
+        ]
+            .filter(([, v]) => !v)
+            .map(([k]) => k);
+        throw new Error(`缺少 LLM 配置:${missing.join('、')};请用 trove config set llm.baseUrl/llm.model/llm.apiKey 写入 ~/.trove/config.json`);
+    }
+    return { baseUrl, model, apiKey };
+}
+export function readJevConfig(config) {
+    const apiKey = config?.jev?.apiKey;
+    const model = config?.jev?.model;
+    if (!apiKey || !model) {
+        const missing = [
+            ['jev.apiKey', apiKey],
+            ['jev.model', model],
+        ]
+            .filter(([, v]) => !v)
+            .map(([k]) => k);
+        throw new Error(`缺少 Jev 配置:${missing.join('、')};请用 trove config set jev.apiKey/jev.model 写入 ~/.trove/config.json`);
+    }
+    return { apiKey, model, ...(config?.jev?.baseUrl ? { baseUrl: config.jev.baseUrl } : {}) };
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/lessons/config.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,aAAa,CAAC,MAA4B;IACxD,MAAM,OAAO,GAAG,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC;IACjC,MAAM,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC;IACnC,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG;YACd,CAAC,aAAa,EAAE,OAAO,CAAC;YACxB,CAAC,WAAW,EAAE,KAAK,CAAC;YACpB,CAAC,YAAY,EAAE,MAAM,CAAC;SACvB;aACE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;aACrB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,+EAA+E,CAAC,CAAC;IACjI,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAA4B;IACxD,MAAM,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC;IACjC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG;YACd,CAAC,YAAY,EAAE,MAAM,CAAC;YACtB,CAAC,WAAW,EAAE,KAAK,CAAC;SACrB;aACE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;aACrB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;IACrH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7F,CAAC"}

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

@@ -0,0 +1,4 @@
+/** 阶段 6 前置:从 lessons 目录读回现有记忆,供合并去重。只认带合法 frontmatter 的记忆文件,忽略审计/归档/元数据。 */
+import type { ExistingMemory } from './merge.js';
+import type { StorageAdapter } from './storage.js';
+export declare function loadExistingMemories(storage: StorageAdapter): Promise<ExistingMemory[]>;

package/dist/core/lessons/existing.js

@@ -0,0 +1,22 @@
+import { parseFrontmatter, stripFrontmatter } from './frontmatter.js';
+/** 非记忆文件(元数据/审计),不参与合并。 */
+const NON_MEMORY = new Set(['INDEX.md', '.overview.md', 'memory_diff.json', 'README.md']);
+export async function loadExistingMemories(storage) {
+    const files = await storage.list();
+    const out = [];
+    for (const path of files) {
+        if (path.startsWith('archive/') || path.startsWith('audit/'))
+            continue;
+        if (NON_MEMORY.has(path))
+            continue;
+        const text = await storage.read(path);
+        if (text === null)
+            continue;
+        const fm = parseFrontmatter(text);
+        if (!fm)
+            continue;
+        out.push({ type: fm.type, path, title: fm.title, content: (stripFrontmatter(text) ?? '').trim() });
+    }
+    return out;
+}
+//# sourceMappingURL=existing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"existing.js","sourceRoot":"","sources":["../../../src/core/lessons/existing.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEtE,2BAA2B;AAC3B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,CAAC,CAAC,CAAC;AAE1F,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAuB;IAChE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,SAAS;QACvE,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACnC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QAC5B,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,21 @@
+/** 阶段 5:五类记忆提取器。按分类结果只跑为真的类别,产出带 evidence 的候选记忆;敏感信息与空候选在此过滤。 */
+import type { Event } from '../events/schema.js';
+import type { LlmProvider } from './llm.js';
+import type { Classification, SessionSummary } from './analyze.js';
+export interface MemoryCandidate {
+    /** 记忆类型 key,如 `experiences/debug_pattern`。 */
+    type: string;
+    title: string;
+    content: string;
+    slug?: string;
+    /** 来源事件 seq,必须落在输入事件范围内。 */
+    evidence: number[];
+}
+export interface ExtractDeps {
+    llm: LlmProvider;
+    /** 已有记忆的渲染文本,供提取器去重参考;缺省为空。 */
+    existing?: string;
+}
+/** 只跑分类为真的提取器,汇总各自候选。 */
+export declare function extractMemories(summary: SessionSummary, classification: Classification, events: Event[], deps: ExtractDeps): Promise<MemoryCandidate[]>;
+export declare function scrubSecrets(text: string): string;

package/dist/core/lessons/extract.js

@@ -0,0 +1,106 @@
+import { renderEvents } from './analyze.js';
+import { getMemoryType } from './schema.js';
+const TYPES_BY_CATEGORY = {
+    preferences: ['preferences/profile', 'preferences/coding_style', 'preferences/writing_style', 'preferences/dialogue_style'],
+    entities: ['entities/project', 'entities/people', 'entities/organization', 'entities/tool', 'entities/tech'],
+    experiences: ['experiences/debug_pattern', 'experiences/workflow', 'experiences/gotcha', 'experiences/correction'],
+    events: ['events/decision'],
+    resources: ['resources/doc', 'resources/repo', 'resources/link'],
+};
+const CATEGORY_LABEL = {
+    preferences: '偏好',
+    entities: '实体',
+    experiences: '经验',
+    events: '决策',
+    resources: '资源',
+};
+const CANDIDATE_SCHEMA = {
+    type: 'object',
+    properties: {
+        memories: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    type: { type: 'string' },
+                    title: { type: 'string' },
+                    content: { type: 'string', description: '记忆正文,用结构化 Markdown 输出:1~3 个 `##` 小节(按内容自然分段),每节 1~3 条 `-` 要点,不要整段纯文本。' },
+                    slug: { type: 'string' },
+                    evidence: { type: 'array', items: { type: 'integer' } },
+                },
+                required: ['type', 'title', 'content', 'evidence'],
+            },
+        },
+    },
+    required: ['memories'],
+};
+/** 只跑分类为真的提取器,汇总各自候选。 */
+export async function extractMemories(summary, classification, events, deps) {
+    const out = [];
+    for (const category of Object.keys(TYPES_BY_CATEGORY)) {
+        if (!classification[category])
+            continue;
+        out.push(...(await extractCategory(category, summary, events, deps)));
+    }
+    return out;
+}
+async function extractCategory(category, summary, events, deps) {
+    const allowed = TYPES_BY_CATEGORY[category];
+    const prompt = [
+        `从会话中提取「${CATEGORY_LABEL[category]}」类记忆,type 只能是:${allowed.join('、')}。`,
+        '每条记忆的 content 用结构化 Markdown 输出:1~3 个 `##` 小节(如背景/要点/结论),每节 1~3 条 `-` 要点;不要输出一整段纯文本。',
+        ...(category === 'preferences'
+            ? ['各 type 提取口径:', ...allowed.map((t) => `- ${t}: ${getMemoryType(t)?.extractionPrompt ?? ''}`)]
+            : []),
+        ...(category === 'resources'
+            ? ['资源类记忆的 content 必须包含来源:URL(http/https)或文件路径(事件里的 @path:line),做到完全可溯源。']
+            : []),
+        `摘要:${JSON.stringify(summary)}`,
+        '事件:',
+        renderEvents(events),
+        ...(deps.existing ? [`已有记忆(避免重复提取):${deps.existing}`] : []),
+    ].join('\n');
+    const raw = await deps.llm.generate(prompt, CANDIDATE_SCHEMA, 'learn:extract');
+    const list = Array.isArray(raw?.memories) ? raw.memories : [];
+    const validTypes = new Set(allowed);
+    const seqs = new Set(events.map((e) => e.seq));
+    const out = [];
+    for (const item of list) {
+        const c = parseCandidate(item, validTypes, seqs);
+        if (c)
+            out.push(c);
+    }
+    return out;
+}
+function parseCandidate(raw, validTypes, seqs) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const r = raw;
+    const type = String(r.type ?? '');
+    if (!validTypes.has(type))
+        return null;
+    const title = scrubSecrets(String(r.title ?? '').trim());
+    const content = scrubSecrets(String(r.content ?? '').trim());
+    if (!title || !content)
+        return null;
+    const evidence = Array.isArray(r.evidence)
+        ? r.evidence.map((n) => Number(n)).filter((n) => Number.isInteger(n) && seqs.has(n))
+        : [];
+    if (evidence.length === 0)
+        return null;
+    const slug = typeof r.slug === 'string' && r.slug.trim() ? r.slug : undefined;
+    return { type, title, content, slug, evidence };
+}
+// shortcut: 敏感值抹除走关键词正则,覆盖常见密钥形态;命中即整段替换为 [REDACTED]。
+const SECRET_PATTERNS = [
+    /AKIA[0-9A-Z]{16}/g,
+    /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g,
+    /(?:password|passwd|token|secret|api[_-]?key|access[_-]?key|private[_-]?key)\s*[=:]\s*["']?[^\s"'`,;]+["']?/gi,
+];
+export function scrubSecrets(text) {
+    let out = text;
+    for (const re of SECRET_PATTERNS)
+        out = out.replace(re, '[REDACTED]');
+    return out;
+}
+//# sourceMappingURL=extract.js.map

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

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

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

@@ -0,0 +1,29 @@
+/** 记忆文件 frontmatter 规范:三类记忆共用的前置字段与缺省值。scope 只允许 global 或 project:<slug>。 */
+export interface FrontmatterInput {
+    type: string;
+    title: string;
+    tags?: string[];
+    scope?: string;
+    source?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    supersededBy?: string;
+}
+export declare function isValidScope(scope: string): boolean;
+/** 解析后的 frontmatter 字段(与 FrontmatterInput 对称)。 */
+export interface ParsedFrontmatter {
+    type: string;
+    title: string;
+    tags: string[];
+    scope: string;
+    source: string | null;
+    createdAt?: string;
+    updatedAt?: string;
+    supersededBy?: string;
+}
+/** 反向解析 renderFrontmatter 的输出;无合法 frontmatter 或缺 type 返回 null。 */
+export declare function parseFrontmatter(text: string): ParsedFrontmatter | null;
+/** 返回 frontmatter 之后的正文;无合法 frontmatter 返回 null。 */
+export declare function stripFrontmatter(text: string): string | null;
+/** 渲染成 YAML frontmatter;字符串用 JSON 序列化(JSON 字符串是合法 YAML 双引号标量)。 */
+export declare function renderFrontmatter(input: FrontmatterInput): string;