@winspan/claude-forge 0.1.1

package/dist/distill/index.js

@@ -0,0 +1,104 @@
+import { DistillPrompts } from './prompts.js';
+import { DistillWriter } from './writer.js';
+import { logger } from '../utils/logger.js';
+export class DistillEngine {
+    storage;
+    api;
+    writer;
+    claudeMdEngine;
+    distillCount = 0;
+    refineInterval;
+    constructor(storage, api, claudeMdEngine, refineInterval = 3) {
+        this.storage = storage;
+        this.api = api;
+        this.writer = new DistillWriter();
+        this.claudeMdEngine = claudeMdEngine || null;
+        this.refineInterval = refineInterval;
+    }
+    async distillSession(sessionId, projectPath) {
+        // 1. 收集未蒸馏事件
+        const events = this.storage.getUndistilledEvents(sessionId, projectPath);
+        if (events.length === 0) {
+            logger.info(`会话 ${sessionId} 无未蒸馏事件${projectPath ? ` (${projectPath})` : ''}`);
+            return false;
+        }
+        // 从事件中获取 project_path（用于写入蒸馏结果）
+        const resolvedProjectPath = projectPath || events[0].project_path;
+        logger.info(`正在蒸馏会话 ${sessionId} 的 ${events.length} 条事件 (${resolvedProjectPath})`);
+        try {
+            // 2. 构造 prompt 并调用 Claude API
+            const prompt = DistillPrompts.buildDistillPrompt(events);
+            const response = await this.api.complete(prompt, 'distill');
+            // 3. 解析响应并写入文件
+            const { decisions, timeline } = this.parseResponse(response);
+            if (decisions) {
+                this.writer.writeDecisions(resolvedProjectPath, decisions);
+            }
+            if (timeline) {
+                this.writer.writeTimeline(resolvedProjectPath, timeline);
+            }
+            // 4. 标记事件为已蒸馏
+            const eventIds = events.map((e) => e.event_id);
+            this.storage.markEventsDistilled(eventIds);
+            logger.info(`蒸馏完成：已处理 ${eventIds.length} 条事件`);
+            // 5. 蒸馏后尝试细化 CLAUDE.md（每 N 次触发一次）
+            this.distillCount++;
+            if (this.claudeMdEngine && this.distillCount % this.refineInterval === 0) {
+                const distilledContent = [decisions, timeline].filter(Boolean).join('\n\n');
+                try {
+                    await this.claudeMdEngine.refine(resolvedProjectPath, distilledContent, events);
+                }
+                catch (refineErr) {
+                    logger.warn(`CLAUDE.md 细化已跳过：${refineErr}`);
+                }
+            }
+            return true;
+        }
+        catch (err) {
+            logger.error(`蒸馏失败：${err}`);
+            return false;
+        }
+    }
+    async distillProject(projectPath) {
+        // 查找项目下所有有未蒸馏事件的会话
+        const sessions = this.storage.querySessions({ project_path: projectPath });
+        let count = 0;
+        for (const session of sessions) {
+            const undistilled = this.storage.countEvents({
+                session_id: session.session_id,
+                project_path: projectPath,
+                distilled: false,
+            });
+            if (undistilled > 0) {
+                const success = await this.distillSession(session.session_id, projectPath);
+                if (success)
+                    count++;
+            }
+        }
+        return count;
+    }
+    parseResponse(response) {
+        let decisions = null;
+        let timeline = null;
+        // 提取 DECISIONS 部分
+        const decisionsMatch = response.match(/###\s*DECISIONS\s*\n([\s\S]*?)(?=###\s*TIMELINE|$)/i);
+        if (decisionsMatch) {
+            decisions = decisionsMatch[1].trim();
+            if (decisions === '无显著决策')
+                decisions = null;
+        }
+        // 提取 TIMELINE 部分
+        const timelineMatch = response.match(/###\s*TIMELINE\s*\n([\s\S]*?)$/i);
+        if (timelineMatch) {
+            timeline = timelineMatch[1].trim();
+            if (timeline === '无显著变更')
+                timeline = null;
+        }
+        // 如果没有匹配到标记格式，把整个响应作为决策记录
+        if (!decisions && !timeline && response.trim()) {
+            decisions = response.trim();
+        }
+        return { decisions, timeline };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/distill/index.js.map

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

package/dist/distill/prompts.d.ts

@@ -0,0 +1,6 @@
+import type { ForgeEvent } from '../types/index.js';
+export declare class DistillPrompts {
+    static buildDistillPrompt(events: ForgeEvent[]): string;
+    static buildResumePrompt(lastDistill: string, recentEvents: ForgeEvent[]): string;
+}
+//# sourceMappingURL=prompts.d.ts.map

package/dist/distill/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/distill/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAMpD,qBAAa,cAAc;IACzB,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM;IA4CvD,MAAM,CAAC,iBAAiB,CACtB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,UAAU,EAAE,GACzB,MAAM;CA2BV"}

package/dist/distill/prompts.js

@@ -0,0 +1,77 @@
+import { truncateToolPayload } from '../utils/truncate.js';
+/** 纯读操作工具名集合，蒸馏时过滤掉以减少噪音 */
+const READ_ONLY_TOOLS = new Set(['Read', 'Glob', 'Grep', 'LS', 'Cat']);
+export class DistillPrompts {
+    static buildDistillPrompt(events) {
+        // 过滤纯读操作（PostToolUse + 只读工具），保留写操作和所有 PreToolUse
+        const filtered = events.filter((e) => {
+            if (e.hook_type !== 'PostToolUse')
+                return true;
+            return !READ_ONLY_TOOLS.has(e.tool_name || '');
+        });
+        // 紧凑行格式，避免 JSON 缩进带来的 token 浪费
+        const eventSummary = filtered.map((e) => {
+            const input = e.tool_input ? truncateToolPayload(e.tool_input, 150) : '';
+            const output = e.tool_output ? truncateToolPayload(e.tool_output, 150) : '';
+            const parts = [e.timestamp, e.hook_type, e.tool_name || 'N/A'];
+            if (input)
+                parts.push(`in:${input}`);
+            if (output)
+                parts.push(`out:${output}`);
+            return parts.join(' | ');
+        }).join('\n');
+        return `你是一个项目决策记录助手。基于以下 Claude Code 工具调用事件流，提取关键决策和项目时间线。
+
+## 事件流（原始 ${events.length} 条，过滤读操作后 ${filtered.length} 条）
+
+${eventSummary}
+
+## 要求
+
+请输出以下两部分内容，使用 Markdown 格式：
+
+### DECISIONS
+提取关键决策，每条决策格式：
+- **[时间]** [决策内容] — 原因：[为什么做这个决定]
+
+只记录有意义的决策（如创建文件、修改架构、选择方案等），忽略琐碎的读取操作。
+
+### TIMELINE
+提取项目时间线，每条格式：
+- **[时间]** [做了什么] | 涉及文件：[文件列表]
+
+注意：
+1. 只提取关键变更，不要列出每一个操作
+2. 决策要包含上下文和理由
+3. 用中文输出
+4. 如果事件流中没有有意义的决策或变更，输出"无显著决策"或"无显著变更"`;
+    }
+    static buildResumePrompt(lastDistill, recentEvents) {
+        const eventSummary = recentEvents.slice(-10).map((e) => {
+            const input = e.tool_input ? truncateToolPayload(e.tool_input, 150) : '';
+            const parts = [e.timestamp, e.hook_type, e.tool_name || 'N/A'];
+            if (input)
+                parts.push(`in:${input}`);
+            return parts.join(' | ');
+        }).join('\n');
+        return `基于以下信息，生成一段精炼的工作续接上下文（不超过 500 字）：
+
+## 上次蒸馏摘要
+${lastDistill || '（无历史蒸馏记录）'}
+
+## 中断后的最近事件（${recentEvents.length} 条）
+${eventSummary}
+
+## 输出格式
+
+你上次在这个项目中的工作被中断了，以下是上下文摘要：
+- **正在做**：[任务描述]
+- **做到哪了**：[最后完成的步骤]
+- **还剩什么**：[未完成的部分]
+- **最后的决策**：[关键决策点]
+- **未解决的问题**：[如有]
+
+注意：用中文输出，保持精炼。`;
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/dist/distill/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/distill/prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,4BAA4B;AAC5B,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAEvE,MAAM,OAAO,cAAc;IACzB,MAAM,CAAC,kBAAkB,CAAC,MAAoB;QAC5C,iDAAiD;QACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACnC,IAAI,CAAC,CAAC,SAAS,KAAK,aAAa;gBAAE,OAAO,IAAI,CAAC;YAC/C,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,+BAA+B;QAC/B,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACtC,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC;YAC/D,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;YACrC,IAAI,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,EAAE,CAAC,CAAC;YACxC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;;YAEC,MAAM,CAAC,MAAM,aAAa,QAAQ,CAAC,MAAM;;EAEnD,YAAY;;;;;;;;;;;;;;;;;;;;uCAoByB,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,iBAAiB,CACtB,WAAmB,EACnB,YAA0B;QAE1B,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACrD,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC;YAC/D,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;YACrC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;;;EAGT,WAAW,IAAI,WAAW;;cAEd,YAAY,CAAC,MAAM;EAC/B,YAAY;;;;;;;;;;;eAWC,CAAC;IACd,CAAC;CACF"}

package/dist/distill/trigger.d.ts

@@ -0,0 +1,40 @@
+import type { StorageEngine } from '../storage/index.js';
+import { DistillEngine } from './index.js';
+export type TriggerCondition = 'stop_hook' | 'event_threshold' | 'timer' | 'pipeline_advance' | 'manual';
+export declare class DistillTrigger {
+    private engine;
+    private storage;
+    private eventThreshold;
+    private timerHandle;
+    private activeProjects;
+    private readonly distillLock;
+    constructor(engine: DistillEngine, storage: StorageEngine, eventThreshold?: number);
+    /**
+     * 启动定时蒸馏（每 intervalMs 毫秒自动检查并蒸馏）
+     */
+    startTimer(intervalMs?: number): void;
+    /**
+     * 停止定时蒸馏
+     */
+    stopTimer(): void;
+    /**
+     * 带互斥锁的蒸馏（同一项目不会并发执行）
+     */
+    private distillWithLock;
+    /**
+     * 定时器触发：对所有活跃项目进行蒸馏
+     */
+    private timerTick;
+    /**
+     * 跟踪活跃项目（由 daemon 在收到事件时调用）
+     */
+    trackProject(sessionId: string, projectPath: string): void;
+    onStopHook(sessionId: string, projectPath?: string): Promise<void>;
+    checkEventThreshold(sessionId: string, projectPath?: string): Promise<boolean>;
+    /**
+     * Pipeline 阶段推进时触发蒸馏
+     */
+    onPipelineAdvance(sessionId: string, projectPath: string, phase: string): Promise<void>;
+    manualDistill(sessionId?: string, projectPath?: string): Promise<number>;
+}
+//# sourceMappingURL=trigger.d.ts.map

package/dist/distill/trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../src/distill/trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI3C,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,iBAAiB,GAAG,OAAO,GAAG,kBAAkB,GAAG,QAAQ,CAAC;AAEzG,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAA+C;IAClE,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;gBAGtD,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,aAAa,EACtB,cAAc,GAAE,MAAW;IAO7B;;OAEG;IACH,UAAU,CAAC,UAAU,GAAE,MAAsB,GAAG,IAAI;IAepD;;OAEG;IACH,SAAS,IAAI,IAAI;IAQjB;;OAEG;YACW,eAAe;IAQ7B;;OAEG;YACW,SAAS;IAmBvB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAIpD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlE,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA+BpF;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvF,aAAa,CACjB,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC;CAYnB"}

package/dist/distill/trigger.js

@@ -0,0 +1,127 @@
+import { logger } from '../utils/logger.js';
+import { MutexLock } from '../utils/mutex-lock.js';
+export class DistillTrigger {
+    engine;
+    storage;
+    eventThreshold;
+    timerHandle = null;
+    activeProjects = new Map(); // projectPath → sessionId
+    distillLock = new MutexLock('Distill');
+    constructor(engine, storage, eventThreshold = 20) {
+        this.engine = engine;
+        this.storage = storage;
+        this.eventThreshold = eventThreshold;
+    }
+    /**
+     * 启动定时蒸馏（每 intervalMs 毫秒自动检查并蒸馏）
+     */
+    startTimer(intervalMs = 5 * 60 * 1000) {
+        if (this.timerHandle)
+            return;
+        this.timerHandle = setInterval(async () => {
+            await this.timerTick();
+        }, intervalMs);
+        // 不阻止进程退出
+        if (this.timerHandle.unref) {
+            this.timerHandle.unref();
+        }
+        logger.info(`蒸馏定时器已启动（间隔：${intervalMs / 1000}s）`);
+    }
+    /**
+     * 停止定时蒸馏
+     */
+    stopTimer() {
+        if (this.timerHandle) {
+            clearInterval(this.timerHandle);
+            this.timerHandle = null;
+            logger.info('蒸馏定时器已停止');
+        }
+    }
+    /**
+     * 带互斥锁的蒸馏（同一项目不会并发执行）
+     */
+    async distillWithLock(sessionId, projectPath, _trigger) {
+        const result = await this.distillLock.runExclusive(projectPath, () => this.engine.distillSession(sessionId, projectPath));
+        return result ?? false;
+    }
+    /**
+     * 定时器触发：对所有活跃项目进行蒸馏
+     */
+    async timerTick() {
+        for (const [projectPath, sessionId] of this.activeProjects) {
+            const count = this.storage.countEvents({
+                session_id: sessionId,
+                project_path: projectPath,
+                distilled: false,
+            });
+            if (count >= 80) { // 定时触发时阈值更低（80 条就值得蒸馏）
+                logger.info(`[定时器] 正在蒸馏 ${projectPath} 的 ${count} 条事件`);
+                try {
+                    await this.distillWithLock(sessionId, projectPath, 'timer');
+                }
+                catch (err) {
+                    logger.warn(`[定时器] ${projectPath} 蒸馏失败：${err}`);
+                }
+            }
+        }
+    }
+    /**
+     * 跟踪活跃项目（由 daemon 在收到事件时调用）
+     */
+    trackProject(sessionId, projectPath) {
+        this.activeProjects.set(projectPath, sessionId);
+    }
+    async onStopHook(sessionId, projectPath) {
+        logger.info(`Stop 钩子触发，会话 ${sessionId}${projectPath ? ` (${projectPath})` : ''}`);
+        if (projectPath) {
+            await this.distillWithLock(sessionId, projectPath, 'stop_hook');
+            this.activeProjects.delete(projectPath);
+        }
+        else {
+            await this.engine.distillSession(sessionId, projectPath);
+        }
+    }
+    async checkEventThreshold(sessionId, projectPath) {
+        const filters = {
+            session_id: sessionId,
+            distilled: false,
+        };
+        if (projectPath) {
+            filters.project_path = projectPath;
+        }
+        const count = this.storage.countEvents(filters);
+        if (count >= this.eventThreshold) {
+            // 已有蒸馏在进行中，静默跳过，避免重复日志
+            if (projectPath && this.distillLock.isLocked(projectPath)) {
+                return true;
+            }
+            logger.info(`事件阈值已达到（${count}/${this.eventThreshold}），会话 ${sessionId}`);
+            if (projectPath) {
+                await this.distillWithLock(sessionId, projectPath, 'event_threshold');
+            }
+            else {
+                await this.engine.distillSession(sessionId, projectPath);
+            }
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Pipeline 阶段推进时触发蒸馏
+     */
+    async onPipelineAdvance(sessionId, projectPath, phase) {
+        logger.info(`[Pipeline] 阶段推进至 ${phase}，触发蒸馏`);
+        await this.distillWithLock(sessionId, projectPath, 'pipeline_advance');
+    }
+    async manualDistill(sessionId, projectPath) {
+        if (sessionId) {
+            const success = await this.engine.distillSession(sessionId);
+            return success ? 1 : 0;
+        }
+        if (projectPath) {
+            return this.engine.distillProject(projectPath);
+        }
+        return 0;
+    }
+}
+//# sourceMappingURL=trigger.js.map

package/dist/distill/trigger.js.map

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

package/dist/distill/writer.d.ts

@@ -0,0 +1,15 @@
+export declare class DistillWriter {
+    private ensureDir;
+    writeDecisions(projectPath: string, content: string): void;
+    writeTimeline(projectPath: string, content: string): void;
+    readLastDecisions(projectPath: string, lines?: number): string;
+    /**
+     * 追加条目并在超过 MAX_ENTRIES 时自动归档旧条目
+     */
+    private appendWithRotation;
+    /**
+     * 将溢出的旧条目追加到归档文件
+     */
+    private archiveEntries;
+}
+//# sourceMappingURL=writer.d.ts.map

package/dist/distill/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/distill/writer.ts"],"names":[],"mappings":"AAQA,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS;IAQjB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAU1D,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAUzD,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,MAAM;IAQlE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;OAEG;IACH,OAAO,CAAC,cAAc;CAYvB"}

package/dist/distill/writer.js

@@ -0,0 +1,73 @@
+import fs from 'fs';
+import path from 'path';
+/** 每个文件保留的最大条目数 */
+const MAX_ENTRIES = 20;
+/** 条目分隔符 */
+const ENTRY_SEPARATOR = '\n---\n';
+export class DistillWriter {
+    ensureDir(projectPath) {
+        const forgeDir = path.join(projectPath, '.claude-forge');
+        if (!fs.existsSync(forgeDir)) {
+            fs.mkdirSync(forgeDir, { recursive: true });
+        }
+        return forgeDir;
+    }
+    writeDecisions(projectPath, content) {
+        const dir = this.ensureDir(projectPath);
+        const filePath = path.join(dir, 'decisions.md');
+        const header = '# 决策日志';
+        const timestamp = new Date().toISOString().split('T')[0];
+        const entry = `## ${timestamp}\n\n${content}`;
+        this.appendWithRotation(filePath, header, entry, dir);
+    }
+    writeTimeline(projectPath, content) {
+        const dir = this.ensureDir(projectPath);
+        const filePath = path.join(dir, 'timeline.md');
+        const header = '# 项目时间线';
+        const timestamp = new Date().toISOString().split('T')[0];
+        const entry = `## ${timestamp}\n\n${content}`;
+        this.appendWithRotation(filePath, header, entry, dir);
+    }
+    readLastDecisions(projectPath, lines = 20) {
+        const filePath = path.join(projectPath, '.claude-forge', 'decisions.md');
+        if (!fs.existsSync(filePath))
+            return '';
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return content.split('\n').slice(-lines).join('\n');
+    }
+    /**
+     * 追加条目并在超过 MAX_ENTRIES 时自动归档旧条目
+     */
+    appendWithRotation(filePath, header, newEntry, forgeDir) {
+        let entries = [];
+        if (fs.existsSync(filePath)) {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            // 解析：跳过 header，按分隔符拆分条目
+            const body = content.replace(/^#[^\n]*\n+/, '');
+            entries = body.split(ENTRY_SEPARATOR).filter(e => e.trim().length > 0);
+        }
+        entries.push(newEntry);
+        // 超过上限 → 旧条目归档
+        if (entries.length > MAX_ENTRIES) {
+            const overflow = entries.splice(0, entries.length - MAX_ENTRIES);
+            this.archiveEntries(forgeDir, filePath, overflow);
+        }
+        // 重写文件：header + 保留的条目
+        const output = header + '\n\n' + entries.join(ENTRY_SEPARATOR) + ENTRY_SEPARATOR;
+        fs.writeFileSync(filePath, output, 'utf-8');
+    }
+    /**
+     * 将溢出的旧条目追加到归档文件
+     */
+    archiveEntries(forgeDir, originalPath, entries) {
+        const archiveDir = path.join(forgeDir, 'archive');
+        if (!fs.existsSync(archiveDir)) {
+            fs.mkdirSync(archiveDir, { recursive: true });
+        }
+        const baseName = path.basename(originalPath);
+        const archivePath = path.join(archiveDir, baseName);
+        const archiveContent = entries.join(ENTRY_SEPARATOR) + ENTRY_SEPARATOR;
+        fs.appendFileSync(archivePath, archiveContent, 'utf-8');
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/distill/writer.js.map

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

package/dist/doc-sync/index.d.ts

@@ -0,0 +1,21 @@
+import type { ForgeEvent } from '../types/index.js';
+import type { ClaudeAPI } from '../utils/claude-api.js';
+/**
+ * 从会话事件中提取本次被修改的文件路径（去重）
+ */
+export declare function extractChangedFiles(events: ForgeEvent[]): string[];
+/**
+ * 递归扫描 projectPath 下所有 .md 文件（排除常见无关目录）
+ */
+export declare function findProjectDocs(projectPath: string): string[];
+export declare class DocSyncEngine {
+    private readonly api;
+    constructor(api: ClaudeAPI);
+    /**
+     * 主入口：根据本次会话事件，找出受影响的文档并更新
+     */
+    sync(sessionId: string, projectPath: string, events: ForgeEvent[]): Promise<void>;
+    private detectAffectedDocs;
+    private updateDoc;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/doc-sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/doc-sync/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AASxD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAUlE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB7D;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAE3C;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YA8BzE,kBAAkB;YA6BlB,SAAS;CA2FxB"}