@jack200714/mafw 4.5.1

package/gateway/dist/core/tools/archive-worktree.js

@@ -0,0 +1,208 @@
+"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.archiveWorktree = archiveWorktree;
+exports.mergeMemoryFromWorktree = mergeMemoryFromWorktree;
+const logger_1 = require("../utils/logger");
+/**
+ * Archive Worktree Tool —Archive tool 鍑芥暟
+ *
+ * 鑱岃矗锛?
+ *   1. 鍚堝苟 Goal 鍒嗘敮鍒?main
+ *   2. 从 worktree 提取独有记忆到主项目
+ *   3. 生成报告
+ *   4. 更新 STATUS.md
+ *   5. 清理临时资源
+ *
+ * 被 Scheduler 在 ARCHIVE 阶段调用。
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const goal_worktree_manager_1 = require("../engine/goal-worktree-manager");
+const minhash_merger_1 = require("../memory/minhash-merger");
+const harmonic_types_1 = require("../memory/harmonic-types");
+/**
+ * 执行 Archive 流程
+ */
+async function archiveWorktree(context) {
+    const { goalId, projectDir, loopCount } = context;
+    logger_1.log.info(`[archive-worktree] Archiving goal ${goalId}`);
+    const worktreeManager = new goal_worktree_manager_1.GoalWorktreeManager(projectDir);
+    const info = await worktreeManager.getCurrentInfo(goalId);
+    // 1. 在 git 合并前，从 worktree 提取独有记忆
+    let fusionResult = null;
+    if (info.worktreeDir !== projectDir) {
+        fusionResult = await mergeMemoryFromWorktree(info.worktreeDir, projectDir);
+        if (fusionResult.added > 0 || fusionResult.conflicts > 0) {
+            logger_1.log.info(`[archive-worktree] Memory fusion: ${fusionResult.added} added, ${fusionResult.conflicts} conflicts`);
+        }
+    }
+    // 2. 鍚堝苟 Goal 鍒嗘敮鍒?main
+    try {
+        await worktreeManager.archive(info, 'merge');
+        logger_1.log.info(`[archive-worktree] Merged goal/${goalId} into main`);
+    }
+    catch (err) {
+        logger_1.log.error(`[archive-worktree] Merge failed: ${err.message}`);
+        throw err;
+    }
+    // 3. 生成报告
+    await generateReport(goalId, projectDir, loopCount, fusionResult);
+    // 4. 更新 STATUS.md
+    updateStatusArchive(goalId, projectDir);
+    logger_1.log.info(`[archive-worktree] Goal ${goalId} archived successfully`);
+}
+/**
+ * 从 worktree 提取独有记忆到主项目
+ */
+async function mergeMemoryFromWorktree(sourceDir, targetDir) {
+    const sourceMafw = path.join(sourceDir, '.mafw');
+    const targetMafw = path.join(targetDir, '.mafw');
+    const { HarmonicUnitFileStore } = await import('../../memory/harmonic-file-store.js');
+    // Read the source worktree's memories via the harmonic index + OKF store
+    // (the legacy `memory/memories.json` layout was replaced by OKF + index and
+    // is deleted by the data-dir migration, so reading it would silently no-op).
+    const sourceStore = new HarmonicUnitFileStore(sourceMafw);
+    const sourceIndex = sourceStore.indexManager_().getIndex();
+    if (sourceIndex.entries.length === 0) {
+        return { added: 0, conflicts: 0, fusionLog: false };
+    }
+    const sourceUnits = [];
+    for (const entry of sourceIndex.entries) {
+        const unit = await sourceStore.read(entry.id);
+        if (unit)
+            sourceUnits.push(unit);
+    }
+    if (sourceUnits.length === 0) {
+        return { added: 0, conflicts: 0, fusionLog: false };
+    }
+    const store = new HarmonicUnitFileStore(targetMafw);
+    const minhash = new minhash_merger_1.MinHashMerger();
+    const targetIndex = store.indexManager_().getIndex();
+    let added = 0;
+    let conflicts = 0;
+    for (const srcUnit of sourceUnits) {
+        if (srcUnit.type === 'episodic')
+            continue;
+        const srcSig = minhash.generateSignature(srcUnit.primary_abstraction || '');
+        let bestSim = 0;
+        for (const tgtEntry of targetIndex.entries) {
+            const tgtSig = minhash.generateSignature(tgtEntry.primary_abstraction || '');
+            const sim = minhash.similarity(srcSig, tgtSig);
+            if (sim > bestSim)
+                bestSim = sim;
+        }
+        if (bestSim > 0.6) {
+            conflicts++;
+        }
+        else {
+            const origId = srcUnit.id;
+            srcUnit.id = (0, harmonic_types_1.generateHarmonicId)();
+            srcUnit.energy = 0.4;
+            srcUnit.merged_from = [origId];
+            const now = new Date().toISOString();
+            srcUnit.created_at = now;
+            srcUnit.updated_at = now;
+            await store.write(srcUnit);
+            added++;
+        }
+    }
+    if (added > 0 || conflicts > 0) {
+        const fusionLogPath = path.join(targetMafw, 'fusion-log.jsonl');
+        const logEntry = JSON.stringify({
+            timestamp: new Date().toISOString(),
+            source_worktree: sourceDir,
+            added,
+            conflicts,
+        });
+        fs.appendFileSync(fusionLogPath, logEntry + '\n', 'utf-8');
+        return { added, conflicts, fusionLog: true };
+    }
+    return { added: 0, conflicts: 0, fusionLog: false };
+}
+/**
+ * 鐢熸垚鎶ュ憡锛堝惈铻嶅悎缁撴灉锛?
+ */
+async function generateReport(goalId, projectDir, loopCount, fusion) {
+    const reportsDir = path.join(projectDir, '.mafw/reports');
+    if (!fs.existsSync(reportsDir)) {
+        fs.mkdirSync(reportsDir, { recursive: true });
+    }
+    let fusionSection = '';
+    if (fusion && (fusion.added > 0 || fusion.conflicts > 0)) {
+        fusionSection = `
+## Memory Fusion
+
+- New memories extracted: ${fusion.added}
+- Conflicts detected: ${fusion.conflicts}
+- Fusion log: .mafw/fusion-log.jsonl
+`;
+    }
+    const reportPath = path.join(reportsDir, `${goalId}.md`);
+    const report = `# Report: ${goalId}
+
+## Summary
+
+- Goal: ${goalId}
+- Loops: ${loopCount}
+- Status: COMPLETED
+- Completed: ${new Date().toISOString()}
+
+## Artifacts
+
+- Plan: waves.json
+- Receipts: receipts/${goalId}/
+- Reviews: reviews/${goalId}-loop*.md
+## Notes
+
+Goal completed successfully after ${loopCount} loop(s).
+${fusionSection}`;
+    fs.writeFileSync(reportPath, report, 'utf-8');
+    logger_1.log.info(`[archive-worktree] Report generated: ${reportPath}`);
+}
+/**
+ * 鏇存柊 STATUS.md 涓?COMPLETED
+ */
+function updateStatusArchive(goalId, projectDir) {
+    const statusPath = path.join(projectDir, '.mafw/STATUS.md');
+    if (!fs.existsSync(statusPath)) {
+        return;
+    }
+    const content = fs.readFileSync(statusPath, 'utf-8');
+    // 鏇存柊瀵瑰簲 Goal 鐨勭姸鎬?
+    const updated = content.replace(new RegExp(`(goalId: "${goalId}"[\s\S]*?state:) "[^"]*"`, 'g'), `$1 "COMPLETED"`);
+    fs.writeFileSync(statusPath, updated, 'utf-8');
+    logger_1.log.info(`[archive-worktree] STATUS.md updated for ${goalId}`);
+}

package/gateway/dist/core/tools/remote-cli.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoteCliConnector = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+/**
+ * Remote CLI Connector — 唯一的 Connector
+ *
+ * 职责：
+ *   1. 同步本地代码到远程
+ *   2. 在远程执行命令（编译、测试）
+ *   3. 拉取远程测试结果
+ *
+ * 使用场景：
+ *   - Execute 阶段：remote-cli sync
+ *   - Review 阶段：remote-cli run（拉取测试结果）
+ */
+class RemoteCliConnector {
+    /**
+     * 同步本地目录到远程
+     */
+    async sync(config) {
+        const { localDir, remoteHost, remoteDir } = config;
+        try {
+            const result = await execAsync(`remote-cli sync --project "${localDir}" --host ${remoteHost} --remote-dir "${remoteDir}"`);
+            return {
+                success: true,
+                output: result.stdout + result.stderr
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: err.message + (err.stderr || '')
+            };
+        }
+    }
+    /**
+     * 在远程执行命令
+     */
+    async run(config) {
+        const { host, command, cwd } = config;
+        try {
+            const result = await execAsync(`remote-cli run --host ${host} --cwd "${cwd}" -- "${command}"`);
+            return {
+                success: true,
+                output: result.stdout + result.stderr,
+                exitCode: 0
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: err.message + (err.stderr || ''),
+                exitCode: err.code || 1
+            };
+        }
+    }
+    /**
+     * 拉取远程文件内容
+     */
+    async fetch(config) {
+        const { host, remotePath } = config;
+        try {
+            const result = await execAsync(`remote-cli run --host ${host} -- "cat ${remotePath}"`);
+            return {
+                success: true,
+                content: result.stdout
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                content: err.message
+            };
+        }
+    }
+    /**
+     * 获取远程测试结果（解析格式）
+     */
+    async fetchTestResults(config) {
+        const result = await this.fetch({
+            host: config.host,
+            remotePath: config.resultPath
+        });
+        if (!result.success) {
+            return { coverage: 0, errors: 0, raw: result.content };
+        }
+        return parseTestResults(result.content);
+    }
+}
+exports.RemoteCliConnector = RemoteCliConnector;
+/**
+ * 解析测试结果
+ */
+function parseTestResults(raw) {
+    // 简单解析：查找 coverage 和 errors
+    const coverageMatch = raw.match(/coverage[\s:]+(\d+\.?\d*)%?/i);
+    const errorsMatch = raw.match(/errors?[\s:]+(\d+)/i);
+    return {
+        coverage: coverageMatch ? parseFloat(coverageMatch[1]) : 0,
+        errors: errorsMatch ? parseInt(errorsMatch[1], 10) : 0,
+        raw
+    };
+}

package/gateway/dist/core/tools/run-ask-user.js

@@ -0,0 +1,79 @@
+"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.askUser = askUser;
+exports.getUnansweredQuestions = getUnansweredQuestions;
+exports.recordAnswer = recordAnswer;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const QUESTIONS_DIR = '.mafw/user-questions';
+async function askUser(input) {
+    const dir = path.join(process.cwd(), QUESTIONS_DIR);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const questionId = `q_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`;
+    const questionPath = path.join(dir, `${questionId}.json`);
+    const data = { questionId, ...input, timestamp: new Date().toISOString(), answered: false, answer: null };
+    fs.writeFileSync(questionPath, JSON.stringify(data, null, 2), 'utf-8');
+    return { success: true, questionId, questionPath };
+}
+function getUnansweredQuestions(goalId) {
+    const dir = path.join(process.cwd(), QUESTIONS_DIR);
+    if (!fs.existsSync(dir))
+        return [];
+    return fs.readdirSync(dir).filter(f => f.endsWith('.json')).map(f => {
+        const data = JSON.parse(fs.readFileSync(path.join(dir, f), 'utf-8'));
+        if (goalId && data.goalId !== goalId)
+            return null;
+        if (data.answered === false)
+            return { ...data, filePath: path.join(dir, f) };
+        return null;
+    }).filter(Boolean);
+}
+function recordAnswer(questionId, answer) {
+    const dir = path.join(process.cwd(), QUESTIONS_DIR);
+    if (!fs.existsSync(dir))
+        return false;
+    const p = path.join(dir, `${questionId}.json`);
+    if (fs.existsSync(p)) {
+        const data = JSON.parse(fs.readFileSync(p, 'utf-8'));
+        data.answered = true;
+        data.answer = answer;
+        data.answeredAt = new Date().toISOString();
+        fs.writeFileSync(p, JSON.stringify(data, null, 2), 'utf-8');
+        return true;
+    }
+    return false;
+}

package/gateway/dist/core/tools/run-execute-wave.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Run Execute Wave Tool — Execute Wave tool 函数
+ *
+ * 职责：
+ *   1. 执行单个 Wave 内的所有 Task
+ *   2. 每个 Task 在独立 Git 分支上执行
+ *   3. 调用 LLM 编写代码
+ *   4. 合并 Wave 结果
+ *
+ * 被 mafw-execute/entry.ts 调用。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTaskPrompt = buildTaskPrompt;
+exports.parseTaskResult = parseTaskResult;
+/**
+ * 构建 Task Prompt
+ */
+function buildTaskPrompt(task, worktreeDir) {
+    return `# Task: ${task.id}\n\n${task.description}\n\n## Affected Files\n\n${(task.affected_files || []).join('\n')}\n\n## Instructions\n\nImplement this task. Write the code to the affected files.\nWorktree: ${worktreeDir}\n`;
+}
+/**
+ * 解析 Task 执行结果
+ */
+function parseTaskResult(content) {
+    // 简化实现：提取代码块
+    const codeBlocks = content.match(/```[\s\S]*?```/g) || [];
+    return {
+        files: [],
+        code: codeBlocks.join('\n')
+    };
+}

package/gateway/dist/core/tools/run-plan.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPlanPrompt = buildPlanPrompt;
+/**
+ * Build the prompt for the Plan Agent.
+ * Library version - shared by skill entries and other consumers.
+ */
+function buildPlanPrompt(options) {
+    const { goal, lessons, deltas, handoff, loopNum } = options;
+    let prompt = `# Plan Agent —Loop ${loopNum}\n\n`;
+    prompt += `## Goal Charter\n\n${goal}\n\n`;
+    if (handoff) {
+        prompt += `## Handoff from Loop ${loopNum - 1}\n\n${handoff.summary}\n\n`;
+    }
+    if (lessons.length > 0) {
+        prompt += `## Lessons Learned (L2)\n\n`;
+        for (const lesson of lessons) {
+            prompt += `- ${lesson}\n`;
+        }
+        prompt += '\n';
+    }
+    if (deltas.length > 0) {
+        prompt += `## Parametric Constraints (L3)\n\n`;
+        for (const delta of deltas) {
+            if (delta.type === 'constraint') {
+                prompt += `- ${delta.type}: ${delta.rule}\n`;
+            }
+            else if (delta.type === 'prompt') {
+                prompt += `- ${delta.type}: ${delta.prompt_delta}\n`;
+            }
+            else if (delta.type === 'pattern') {
+                prompt += `- ${delta.type}: ${delta.pattern_template}\n`;
+            }
+        }
+        prompt += '\n';
+    }
+    prompt += `## Instructions\n\n`;
+    prompt += `Generate a detailed execution plan with waves and tasks.\n`;
+    prompt += `Output format: JSON with "waves" and "tasks" arrays.\n`;
+    prompt += `Each task must have: id, description, affected_files, acceptance_criteria.\n`;
+    return prompt;
+}

package/gateway/dist/core/tools/run-record-feedback.js

@@ -0,0 +1,55 @@
+"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.ENERGY_DELTAS = void 0;
+exports.recordFeedback = recordFeedback;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const FEEDBACK_DIR = '.mafw/user-feedback';
+exports.ENERGY_DELTAS = {
+    thumbs_up: 0.2,
+    thumbs_down: -0.1,
+    correction: 0.0
+};
+async function recordFeedback(input) {
+    const dir = path.join(process.cwd(), FEEDBACK_DIR);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const feedbackId = `fb_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`;
+    const energyDelta = exports.ENERGY_DELTAS[input.type] || 0;
+    const data = { feedbackId, ...input, energyDelta, timestamp: new Date().toISOString() };
+    fs.writeFileSync(path.join(dir, `${feedbackId}.json`), JSON.stringify(data, null, 2), 'utf-8');
+    return { success: true, feedbackId, energyDelta, comment: input.comment };
+}

package/gateway/dist/core/tools/run-review.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildReviewPrompt = buildReviewPrompt;
+/**
+ * Build the prompt for the Review Agent.
+ * Library version - shared by skill entries and other consumers.
+ */
+function buildReviewPrompt(options) {
+    const { receipts, diff, metrics, boundaries, remoteResults, goal } = options;
+    let prompt = `# Review Agent\n\n`;
+    prompt += `## Goal Charter\n\n${goal}\n\n`;
+    prompt += `## Execution Receipts\n\n`;
+    for (const r of receipts) {
+        prompt += `### Wave ${r.waveId || 'unknown'}\n\n`;
+        prompt += `Status: ${r.status}\n`;
+        if (r.tasks) {
+            for (const t of r.tasks) {
+                prompt += `- Task ${t.taskId}: ${t.status}\n`;
+            }
+        }
+        prompt += '\n';
+    }
+    prompt += `## Code Changes\n\n\`\`\`diff\n${diff}\n\`\`\`\n\n`;
+    prompt += `## Metrics\n\n`;
+    for (const [key, value] of Object.entries(metrics)) {
+        prompt += `- ${key}: target ${value.target}${value.unit}\n`;
+    }
+    prompt += '\n';
+    prompt += `## Boundaries\n\n`;
+    for (const b of boundaries) {
+        prompt += `- ${b}\n`;
+    }
+    prompt += '\n';
+    if (remoteResults) {
+        prompt += `## Remote Test Results\n\n`;
+        prompt += `Success: ${remoteResults.success}\n`;
+        prompt += `Output: ${remoteResults.output}\n\n`;
+    }
+    prompt += `## Instructions\n\n`;
+    prompt += `Review the execution results against the goal charter, metrics, and boundaries.\n`;
+    prompt += `Return a JSON with:\n`;
+    prompt += `- verdict: "PASS" or "FAIL"\n`;
+    prompt += `- reason: explanation\n`;
+    prompt += `- metrics: actual metric values\n`;
+    return prompt;
+}

package/gateway/dist/core/tools/write-lesson.js

@@ -0,0 +1,97 @@
+"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.writeLesson = writeLesson;
+const logger_1 = require("../utils/logger");
+/**
+ * Write Lesson Tool —鍐欏叆 Lesson tool 鍑芥暟
+ *
+ * 鑱岃矗锛?
+ *   1. 灏?Review 澶辫触缁撴灉鍐欏叆 lessons/{goalId}-loop{loop}.md
+ *   2. 鏍煎紡鍖?Lesson 缁撴瀯
+ *
+ * 琚?mafw-review/entry.ts 璋冪敤銆?
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * 写入 Lesson 文件
+ */
+function writeLesson(data, projectDir = '.') {
+    const { goalId, loop, reason, metrics, domain = 'general', task = 'unknown' } = data;
+    const lessonsDir = path.join(projectDir, '.mafw/lessons');
+    if (!fs.existsSync(lessonsDir)) {
+        fs.mkdirSync(lessonsDir, { recursive: true });
+    }
+    const lessonPath = path.join(lessonsDir, `${goalId}-loop${loop}.md`);
+    const content = formatLesson(data);
+    fs.writeFileSync(lessonPath, content, 'utf-8');
+    logger_1.log.info(`[write-lesson] Written: ${lessonPath}`);
+    return lessonPath;
+}
+/**
+ * 格式化 Lesson 内容
+ */
+function formatLesson(data) {
+    const { goalId, loop, reason, metrics, domain, task } = data;
+    return `# Lesson: ${goalId} —Loop ${loop}
+
+## Trigger
+
+Review failed: ${reason}
+
+## Context
+
+- Goal: ${goalId}
+- Loop: ${loop}
+- Domain: ${domain}
+- Task: ${task}
+
+## Metrics
+
+${Object.entries(metrics).map(([k, v]) => `- ${k}: ${v}`).join('\n')}
+
+## Root Cause
+
+${reason}
+
+## Recommendation
+
+Address the above issues in the next loop.
+
+---
+_generated: ${new Date().toISOString()}_
+`;
+}