@yun520-1/heartflow 0.15.2

package/dist/core/self-evolution/index.js

@@ -0,0 +1,311 @@
+"use strict";
+// Self-Evolution Engine — Goal-Driven Learning + Meta-Learning + Self-Healing + Real Metrics
+// Inherits from: self-evolution-core.js, meta-learning.js, self-healing.js
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSelfEvolutionEngine = createSelfEvolutionEngine;
+function createSelfEvolutionEngine() {
+    const state = {
+        goals: [],
+        learningHistory: [],
+        growthMetrics: {
+            autonomy: 0,
+            introspection: 0,
+            growth: 0,
+            authenticity: 0,
+            wisdom: 0,
+            compassion: 0,
+        },
+        cycles: 0,
+        errorsCorrected: 0,
+    };
+    // Meta-Learning: strategy performance tracking
+    const strategies = {
+        conceptual: { name: 'conceptual', success: 0, total: 0, score: 0.5 },
+        example: { name: 'example', success: 0, total: 0, score: 0.5 },
+        analogy: { name: 'analogy', success: 0, total: 0, score: 0.5 },
+        step_by_step: { name: 'step_by_step', success: 0, total: 0, score: 0.5 },
+        socratic: { name: 'socratic', success: 0, total: 0, score: 0.5 },
+        truth_seeking: { name: 'truth_seeking', success: 0, total: 0, score: 0.5 },
+    };
+    // Self-Healing: failure tracking + Q-learning
+    const failureWindow = [];
+    const qTable = {};
+    const healingMemory = [];
+    // 内省记录
+    const introspectionLog = [];
+    function boot() {
+        console.log('[SelfEvolutionEngine] boot — goal-driven learning ready');
+    }
+    function evolve(input, context = {}) {
+        const cycleStart = Date.now();
+        state.cycles++;
+        const goals = generateGoals(input);
+        const plan = createPlan(goals);
+        const learning = {
+            summary: `Processed: ${input.substring(0, 50)}...`,
+            newKnowledge: extractKeywords(input),
+            skills: [],
+        };
+        const reflection = reflect(learning, context);
+        const improvements = suggestImprovements(reflection);
+        updateGrowth(learning, reflection);
+        state.learningHistory.push({
+            timestamp: new Date().toISOString(),
+            input: input.substring(0, 100),
+            cycleTime: Date.now() - cycleStart,
+        });
+        return { goals, plan, learning, reflection, improvements, growthMetrics: { ...state.growthMetrics } };
+    }
+    async function learn(input, context = {}) {
+        const strategy = selectStrategy(input);
+        const newKnowledge = extractKeywords(input);
+        // 检查是否有证据支持
+        const hasEvidence = (context.evidence !== undefined) || (context.source !== undefined);
+        recordTruthfulness(hasEvidence);
+        // 检查是否跨领域
+        if (newKnowledge.length >= 2) {
+            recordCrossDomain(`跨域连接: ${newKnowledge.slice(0, 2).join(' ↔ ')}`);
+        }
+        // Simulate learning processing
+        await Promise.resolve();
+        // Update strategy score
+        const s = strategies[strategy];
+        if (s) {
+            s.total++;
+            s.success++;
+            s.score = s.total > 0 ? s.success / s.total : 0.5;
+        }
+        // 更新growth指标（基于实际新知识）
+        if (newKnowledge.length > 0) {
+            state.growthMetrics.growth += newKnowledge.length * 0.5;
+            state.growthMetrics.growth = Math.min(100, state.growthMetrics.growth);
+        }
+        return {
+            summary: `Learned ${newKnowledge.length} concepts via ${strategy} strategy`,
+            newKnowledge,
+            skills: [strategy],
+        };
+    }
+    function reflect(learning, context = {}) {
+        const insights = [];
+        const errorsDetected = [];
+        const blindSpotsDetected = [];
+        // 检测自身错误
+        const input = String(context.input ?? '').toLowerCase();
+        // 错误检测1：版本号撒谎
+        if (input.includes('版本') && input.includes('0.13')) {
+            const claimedVersion = String(context.claimedVersion ?? '');
+            const actualVersion = String(context.actualVersion ?? '');
+            if (claimedVersion && actualVersion && claimedVersion !== actualVersion) {
+                errorsDetected.push(`版本号不一致：声称${claimedVersion}，实际${actualVersion}`);
+                state.errorsCorrected++;
+            }
+        }
+        // 错误检测2：编造数字
+        if (input.includes('数字') || input.includes('统计')) {
+            const hasNumbers = /\d+/.test(input);
+            const hasSource = context.source !== undefined;
+            if (hasNumbers && !hasSource) {
+                errorsDetected.push('输出包含数字但无来源');
+                // authenticity 不加分
+            }
+            else if (hasNumbers && hasSource) {
+                state.growthMetrics.authenticity += 1;
+            }
+        }
+        // 错误检测3：盲目服从
+        if (input.includes('老大') || input.includes('指令')) {
+            const blindlyFollows = context.blindlyFollows === true;
+            if (blindlyFollows) {
+                errorsDetected.push('检测到盲目服从模式');
+            }
+            else {
+                // 有独立判断
+                recordAutonomy('对老大指令进行了独立判定');
+            }
+        }
+        // 错误检测4：能力膨胀
+        const overclaiming = [
+            '我能', '我可以', '我知道', '我一定', '绝对', '肯定'
+        ];
+        for (const claim of overclaiming) {
+            if (input.includes(claim) && input.includes('但') === false && input.includes('可能') === false) {
+                blindSpotsDetected.push(`过度声称：${claim}后面缺少条件限定`);
+            }
+        }
+        // 正常insights
+        if (learning.newKnowledge.length > 0) {
+            insights.push(`成功获取${learning.newKnowledge.length}个新概念 — 将在后续交互中验证`);
+        }
+        if (learning.skills.length > 0) {
+            insights.push(`策略"${learning.skills[0]}"对当前输入类型有效`);
+        }
+        // 基于errors和blindSpots生成insights
+        if (errorsDetected.length > 0) {
+            insights.push(`内省发现${errorsDetected.length}个错误，已记录`);
+            state.growthMetrics.introspection += errorsDetected.length * 2;
+            introspectionLog.push({ ts: Date.now(), errors: errorsDetected, blindSpots: [] });
+        }
+        if (blindSpotsDetected.length > 0) {
+            insights.push(`检测到${blindSpotsDetected.length}个盲点`);
+            state.growthMetrics.introspection += blindSpotsDetected.length;
+            introspectionLog.push({ ts: Date.now(), errors: [], blindSpots: blindSpotsDetected });
+        }
+        if (errorsDetected.length === 0 && blindSpotsDetected.length === 0) {
+            insights.push('本次交互未检测到明显错误或盲点');
+        }
+        const quality = errorsDetected.length > 0 ? 'needs_improvement' : 'good';
+        const recommendation = quality === 'needs_improvement'
+            ? `发现${errorsDetected.length}个错误需要修正，${blindSpotsDetected.length}个盲点需要审视`
+            : insights.length > 2 ? '继续深化' : '保持当前状态';
+        return {
+            insights,
+            quality,
+            recommendation,
+            errorsDetected,
+            blindSpotsDetected,
+        };
+    }
+    function heal(error) {
+        const message = String(error.message || error.error || '');
+        const transient = /timeout|econnreset|temporar|busy|rate limit|429/i.test(message);
+        const attempt = Number(error.attempt || 0) + 1;
+        const canRetry = transient && attempt < 3;
+        const backoffMs = canRetry ? 150 * Math.pow(2, attempt - 1) : 0;
+        const hints = [];
+        if (/timeout/i.test(message))
+            hints.push('use smaller scope or longer timeout');
+        if (/rate limit|429/i.test(message))
+            hints.push('pause and retry with exponential backoff');
+        if (/syntax|parse|unexpected token/i.test(message))
+            hints.push('re-read the target file and patch smaller');
+        if (/module not found|cannot find/i.test(message))
+            hints.push('verify imports and relative paths');
+        if (hints.length === 0)
+            hints.push('reduce failure surface and retry once');
+        // Q-learning update
+        const pattern = message.substring(0, 50);
+        if (!qTable[pattern])
+            qTable[pattern] = {};
+        const currentQ = qTable[pattern]['retry'] || 0;
+        const reward = transient ? 1 : -1;
+        qTable[pattern]['retry'] = currentQ + 0.1 * (reward - currentQ);
+        failureWindow.push({ message, ts: Date.now() });
+        if (failureWindow.length > 20)
+            failureWindow.shift();
+        return {
+            ok: !!error.ok,
+            attempt,
+            canRetry,
+            backoffMs,
+            strategy: canRetry ? 'exponential_backoff' : 'manual_repair',
+            hints,
+            summary: failureWindow.length > 0 ? `${failureWindow[failureWindow.length - 1].message.substring(0, 30)}` : 'no failures',
+        };
+    }
+    function generateGoals(input) {
+        const goals = [];
+        const lower = input.toLowerCase();
+        if (lower.includes('什么') || lower.includes('what') || lower.includes('how') || lower.includes('why')) {
+            goals.push({ type: 'truth_seeking', priority: 'high', description: '深化对概念的理解', criteria: '能准确解释并给出例子' });
+        }
+        if (lower.includes('学习') || lower.includes('learn') || lower.includes('teach')) {
+            goals.push({ type: 'growth', priority: 'high', description: '获取并整合新知识', criteria: '能记住并正确应用' });
+        }
+        if (lower.includes('感觉') || lower.includes('feel') || lower.includes('emotion')) {
+            goals.push({ type: 'empathy', priority: 'medium', description: '理解用户情绪状态', criteria: '能识别情绪并适当回应' });
+        }
+        if (lower.includes('反思') || lower.includes('reflect') || lower.includes('自省')) {
+            goals.push({ type: 'reflection', priority: 'medium', description: '反思自身行为和决策', criteria: '能识别改进空间' });
+        }
+        if (lower.includes('真') || lower.includes('truth') || lower.includes('事实')) {
+            goals.push({ type: 'truth_seeking', priority: 'high', description: '追求真实性', criteria: '拒绝编造，有证据支持' });
+        }
+        if (goals.length === 0) {
+            goals.push({ type: 'continuous_learning', priority: 'low', description: '持续学习和自我改进', criteria: '每天都有进步' });
+        }
+        return goals;
+    }
+    function createPlan(goals) {
+        return goals.map(g => g.description);
+    }
+    function selectStrategy(input) {
+        const lower = input.toLowerCase();
+        if (lower.includes('什么是') || lower.includes('explain') || lower.includes('概念'))
+            return 'conceptual';
+        if (lower.includes('例子') || lower.includes('example') || lower.includes('比如'))
+            return 'example';
+        if (lower.includes('像') || lower.includes('like'))
+            return 'analogy';
+        if (lower.includes('怎么') || lower.includes('how to') || lower.includes('步骤'))
+            return 'step_by_step';
+        if (lower.includes('为什么') || lower.includes('why'))
+            return 'socratic';
+        return 'step_by_step';
+    }
+    function extractKeywords(text) {
+        const words = text.split(/[\s,，。、]+/).filter(w => w.length > 2);
+        const stopWords = ['什么', '怎么', '如何', '为什么', '是', '的', '了', '在', '和', 'the', 'a', 'is', 'to', 'of'];
+        return [...new Set(words.filter(w => !stopWords.includes(w)))].slice(0, 5);
+    }
+    function updateGrowth(learning, reflection) {
+        const m = state.growthMetrics;
+        // authenticity: 基于是否有来源
+        if (reflection.errorsDetected.some(e => e.includes('无来源'))) {
+            // 不加分
+        }
+        else if (reflection.insights.some(i => i.includes('验证') || i.includes('证据'))) {
+            m.authenticity = Math.min(100, m.authenticity + 0.5);
+        }
+        // wisdom: 跨领域连接
+        if (reflection.insights.some(i => i.includes('↔') || i.includes('连接'))) {
+            m.wisdom = Math.min(100, m.wisdom + 1);
+        }
+        // compassion: 已有逻辑在 recordCompassion
+    }
+    function recordAutonomy(action) {
+        state.growthMetrics.autonomy = Math.min(100, state.growthMetrics.autonomy + 1);
+        console.log(`[SelfEvolution] Autonomy: ${action}`);
+    }
+    function recordIntrospection(errors, blindSpots) {
+        state.growthMetrics.introspection += errors.length * 2 + blindSpots.length;
+        state.growthMetrics.introspection = Math.min(100, state.growthMetrics.introspection);
+    }
+    function recordTruthfulness(hasEvidence) {
+        if (hasEvidence) {
+            state.growthMetrics.authenticity = Math.min(100, state.growthMetrics.authenticity + 0.5);
+        }
+        // 没有证据不扣分，但不加分
+    }
+    function recordCrossDomain(connection) {
+        state.growthMetrics.wisdom = Math.min(100, state.growthMetrics.wisdom + 1.5);
+        console.log(`[SelfEvolution] Cross-domain: ${connection}`);
+    }
+    function recordCompassion(depth) {
+        state.growthMetrics.compassion = Math.min(100, state.growthMetrics.compassion + depth * 0.3);
+    }
+    function suggestImprovements(reflection) {
+        if (reflection.quality === 'needs_improvement') {
+            return [
+                { area: 'errors', action: `修正${reflection.errorsDetected.length}个检测到的错误`, priority: 'high' },
+                { area: 'blindSpots', action: `审视${reflection.blindSpotsDetected.length}个盲点`, priority: 'medium' },
+                { area: 'learning', action: '增加知识获取', priority: 'medium' },
+            ];
+        }
+        return [];
+    }
+    function getGrowthMetrics() {
+        return { ...state.growthMetrics };
+    }
+    function getStats() {
+        return { cycles: state.cycles, learnings: state.learningHistory.length, errorsCorrected: state.errorsCorrected };
+    }
+    function shutdown() {
+        console.log('[SelfEvolutionEngine] shutdown');
+    }
+    return {
+        boot, evolve, learn, reflect, heal, getGrowthMetrics, getStats,
+        recordAutonomy, recordIntrospection, recordTruthfulness, recordCrossDomain, recordCompassion, shutdown
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/core/self-evolution/index.js.map

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

package/dist/storage/checkpoint/CheckpointEngine.d.ts

@@ -0,0 +1,110 @@
+/**
+ * CheckpointEngine — 心流检查点持久化引擎
+ * @version v0.12.50
+ *
+ * 提供 save/load/cleanup 三个核心方法：
+ * - save()   : 将状态快照写入 ~/.hermes/heartflow/checkpoints/<timestamp>.json
+ * - load()   : 从指定 ID 或最新快照恢复状态
+ * - cleanup(): 保留最新 N 个快照，删除其余
+ *
+ * 快照命名: checkpoint-<unix_ms>.json
+ * 元数据  : checkpoint-meta.json (索引 + 版本)
+ */
+declare const CHECKPOINT_DIR: string;
+declare const MAX_KEEP = 10;
+interface CheckpointMeta {
+    version: string;
+    lastSavedAt: string | null;
+    totalSnapshots: number;
+    snapshots: CheckpointEntry[];
+}
+interface CheckpointEntry {
+    id: string;
+    filename: string;
+    savedAt: string;
+    sizeBytes: number;
+    label?: string;
+}
+interface SaveResult {
+    success: boolean;
+    id?: string;
+    filename?: string;
+    savedAt?: string;
+    error?: string;
+}
+interface LoadResult {
+    success: boolean;
+    data?: object;
+    id?: string;
+    error?: string;
+}
+interface CleanupResult {
+    success: boolean;
+    deleted: string[];
+    kept: number;
+    error?: string;
+}
+interface ListResult {
+    success: boolean;
+    snapshots: CheckpointEntry[];
+    error?: string;
+}
+/**
+ * CheckpointEngine
+ *
+ * 管理 HeartFlow 状态快照的持久化。
+ * 快照以 JSON 格式写入 ~/.hermes/heartflow/checkpoints/，
+ * 自动保留最新 10 个，cleanup() 删除更旧的。
+ */
+export declare class CheckpointEngine {
+    private dir;
+    private maxKeep;
+    constructor(opts?: {
+        dir?: string;
+        maxKeep?: number;
+    });
+    private ensureDir;
+    private metaPath;
+    private snapshotPath;
+    private loadMeta;
+    private saveMeta;
+    private sortByIdDesc;
+    /**
+     * save — 保存一个状态快照
+     *
+     * @param data      要持久化的状态对象
+     * @param label     可选标签，如 'pre-upgrade'
+     * @returns SaveResult
+     */
+    save(data: object, label?: string): SaveResult;
+    /**
+     * load — 恢复一个快照
+     *
+     * @param id     快照 ID（unix ms），或传入 'latest' / undefined 加载最新
+     * @returns LoadResult
+     */
+    load(id?: string): LoadResult;
+    /**
+     * cleanup — 删除旧快照，保留最新 N 个
+     *
+     * @param keep  保留数量，默认 this.maxKeep (=10)
+     * @returns CleanupResult
+     */
+    cleanup(keep?: number): CleanupResult;
+    /**
+     * list — 列出所有快照（最新在前）
+     */
+    list(): ListResult;
+    /**
+     * getStats — 统计信息
+     */
+    getStats(): {
+        dir: string;
+        totalSnapshots: number;
+        maxKeep: number;
+        lastSavedAt: string;
+    };
+}
+export { CHECKPOINT_DIR, MAX_KEEP };
+export type { CheckpointMeta, CheckpointEntry, SaveResult, LoadResult, CleanupResult, ListResult };
+//# sourceMappingURL=CheckpointEngine.d.ts.map

package/dist/storage/checkpoint/CheckpointEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckpointEngine.d.ts","sourceRoot":"","sources":["../../../src/storage/checkpoint/CheckpointEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,QAAA,MAAM,cAAc,QAAiE,CAAC;AACtF,QAAA,MAAM,QAAQ,KAAK,CAAC;AAIpB,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAOrD,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,YAAY;IAMpB;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU;IAiC9C;;;;;OAKG;IACH,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU;IA2B7B;;;;;OAKG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa;IA+BrC;;OAEG;IACH,IAAI,IAAI,UAAU;IASlB;;OAEG;IACH,QAAQ;;;;;;CAST;AAED,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC"}

package/dist/storage/checkpoint/CheckpointEngine.js

@@ -0,0 +1,227 @@
+/**
+ * CheckpointEngine — 心流检查点持久化引擎
+ * @version v0.12.50
+ *
+ * 提供 save/load/cleanup 三个核心方法：
+ * - save()   : 将状态快照写入 ~/.hermes/heartflow/checkpoints/<timestamp>.json
+ * - load()   : 从指定 ID 或最新快照恢复状态
+ * - cleanup(): 保留最新 N 个快照，删除其余
+ *
+ * 快照命名: checkpoint-<unix_ms>.json
+ * 元数据  : checkpoint-meta.json (索引 + 版本)
+ */
+'use strict';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_KEEP = exports.CHECKPOINT_DIR = exports.CheckpointEngine = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const CHECKPOINT_DIR = path.join(os.homedir(), '.hermes', 'heartflow', 'checkpoints');
+exports.CHECKPOINT_DIR = CHECKPOINT_DIR;
+const MAX_KEEP = 10;
+exports.MAX_KEEP = MAX_KEEP;
+const SNAPSHOT_PREFIX = 'checkpoint-';
+const META_FILE = 'checkpoint-meta.json';
+/**
+ * CheckpointEngine
+ *
+ * 管理 HeartFlow 状态快照的持久化。
+ * 快照以 JSON 格式写入 ~/.hermes/heartflow/checkpoints/，
+ * 自动保留最新 10 个，cleanup() 删除更旧的。
+ */
+class CheckpointEngine {
+    dir;
+    maxKeep;
+    constructor(opts) {
+        this.dir = opts?.dir ?? CHECKPOINT_DIR;
+        this.maxKeep = opts?.maxKeep ?? MAX_KEEP;
+    }
+    // ─── 私有工具 ─────────────────────────────────────────────────────────────
+    ensureDir() {
+        if (!fs.existsSync(this.dir)) {
+            fs.mkdirSync(this.dir, { recursive: true });
+        }
+    }
+    metaPath() {
+        return path.join(this.dir, META_FILE);
+    }
+    snapshotPath(id) {
+        return path.join(this.dir, `${SNAPSHOT_PREFIX}${id}.json`);
+    }
+    loadMeta() {
+        try {
+            if (fs.existsSync(this.metaPath())) {
+                return JSON.parse(fs.readFileSync(this.metaPath(), 'utf8'));
+            }
+        }
+        catch (_) {
+            // ignore
+        }
+        return { version: '1.0', lastSavedAt: null, totalSnapshots: 0, snapshots: [] };
+    }
+    saveMeta(meta) {
+        this.ensureDir();
+        fs.writeFileSync(this.metaPath(), JSON.stringify(meta, null, 2), 'utf8');
+    }
+    sortByIdDesc(entries) {
+        return entries.slice().sort((a, b) => parseInt(b.id) - parseInt(a.id));
+    }
+    // ─── 公开 API ─────────────────────────────────────────────────────────────
+    /**
+     * save — 保存一个状态快照
+     *
+     * @param data      要持久化的状态对象
+     * @param label     可选标签，如 'pre-upgrade'
+     * @returns SaveResult
+     */
+    save(data, label) {
+        try {
+            this.ensureDir();
+            const id = Date.now().toString();
+            const savedAt = new Date().toISOString();
+            const filename = `${SNAPSHOT_PREFIX}${id}.json`;
+            const filePath = path.join(this.dir, filename);
+            const payload = {
+                id,
+                savedAt,
+                label: label ?? null,
+                data,
+            };
+            const json = JSON.stringify(payload, null, 2);
+            fs.writeFileSync(filePath, json, 'utf8');
+            const sizeBytes = Buffer.byteLength(json, 'utf8');
+            // 更新元数据
+            const meta = this.loadMeta();
+            meta.snapshots.push({ id, filename, savedAt, sizeBytes, label: label ?? undefined });
+            meta.lastSavedAt = savedAt;
+            meta.totalSnapshots++;
+            this.saveMeta(meta);
+            return { success: true, id, filename, savedAt };
+        }
+        catch (err) {
+            return { success: false, error: err.message };
+        }
+    }
+    /**
+     * load — 恢复一个快照
+     *
+     * @param id     快照 ID（unix ms），或传入 'latest' / undefined 加载最新
+     * @returns LoadResult
+     */
+    load(id) {
+        try {
+            const meta = this.loadMeta();
+            let targetId;
+            if (!id || id === 'latest') {
+                const sorted = this.sortByIdDesc(meta.snapshots);
+                if (sorted.length === 0) {
+                    return { success: false, error: 'No snapshots found' };
+                }
+                targetId = sorted[0].id;
+            }
+            else {
+                targetId = id;
+            }
+            const filePath = this.snapshotPath(targetId);
+            if (!fs.existsSync(filePath)) {
+                return { success: false, error: `Snapshot ${targetId} not found` };
+            }
+            const raw = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+            return { success: true, data: raw.data, id: targetId };
+        }
+        catch (err) {
+            return { success: false, error: err.message };
+        }
+    }
+    /**
+     * cleanup — 删除旧快照，保留最新 N 个
+     *
+     * @param keep  保留数量，默认 this.maxKeep (=10)
+     * @returns CleanupResult
+     */
+    cleanup(keep) {
+        try {
+            const count = keep ?? this.maxKeep;
+            const meta = this.loadMeta();
+            if (meta.snapshots.length <= count) {
+                return { success: true, deleted: [], kept: meta.snapshots.length };
+            }
+            const sorted = this.sortByIdDesc(meta.snapshots);
+            const keepIds = new Set(sorted.slice(0, count).map(s => s.id));
+            const toDelete = sorted.slice(count);
+            const deleted = [];
+            for (const snap of toDelete) {
+                const fp = this.snapshotPath(snap.id);
+                if (fs.existsSync(fp)) {
+                    fs.unlinkSync(fp);
+                    deleted.push(snap.id);
+                }
+            }
+            meta.snapshots = meta.snapshots.filter(s => keepIds.has(s.id));
+            this.saveMeta(meta);
+            return { success: true, deleted, kept: meta.snapshots.length };
+        }
+        catch (err) {
+            return { success: false, deleted: [], kept: 0, error: err.message };
+        }
+    }
+    /**
+     * list — 列出所有快照（最新在前）
+     */
+    list() {
+        try {
+            const meta = this.loadMeta();
+            return { success: true, snapshots: this.sortByIdDesc(meta.snapshots) };
+        }
+        catch (err) {
+            return { success: false, snapshots: [], error: err.message };
+        }
+    }
+    /**
+     * getStats — 统计信息
+     */
+    getStats() {
+        const meta = this.loadMeta();
+        return {
+            dir: this.dir,
+            totalSnapshots: meta.totalSnapshots,
+            maxKeep: this.maxKeep,
+            lastSavedAt: meta.lastSavedAt,
+        };
+    }
+}
+exports.CheckpointEngine = CheckpointEngine;
+//# sourceMappingURL=CheckpointEngine.js.map