@jack200714/mafw 4.5.1

package/gateway/dist/core/hooks/session-ending.js

@@ -0,0 +1,123 @@
+"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.sessionEndingHook = sessionEndingHook;
+const logger_1 = require("../utils/logger");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const state_1 = require("../utils/state");
+async function sessionEndingHook(hookContext) {
+    const sessionId = hookContext.sessionId;
+    const projectDir = hookContext.projectDir || process.cwd();
+    const mafwDir = path.join(projectDir, '.mafw');
+    const stateDir = path.join(mafwDir, 'state');
+    // Pre-compact protection: detect high-energy memories (goal-independent)
+    try {
+        const parametricDir = path.join(projectDir, '.mafw/parametric');
+        if (fs.existsSync(parametricDir)) {
+            const files = fs.readdirSync(parametricDir).filter(f => f.endsWith('.json'));
+            let highEnergyCount = 0;
+            for (const file of files) {
+                try {
+                    const data = JSON.parse(fs.readFileSync(path.join(parametricDir, file), 'utf-8'));
+                    if ((data.energy_score || data.energy || 0) > 0.8)
+                        highEnergyCount++;
+                }
+                catch { /* skip unparseable files */ }
+            }
+            if (highEnergyCount > 0) {
+                logger_1.log.info(`[mafw:pre-compact] Preserving ${highEnergyCount} high-energy memories`);
+            }
+        }
+    }
+    catch { /* ignore parametric errors */ }
+    // 1. 遍历所有 state 文件，找到包含该 sessionId 的 goal
+    if (!fs.existsSync(stateDir)) {
+        logger_1.log.warn(`[hook:session-ending] State directory not found: ${stateDir}`);
+        return;
+    }
+    const stateFiles = fs.readdirSync(stateDir).filter(f => f.endsWith('.json'));
+    let targetGoalId = null;
+    let targetPhase = null;
+    for (const file of stateFiles) {
+        const statePath = path.join(stateDir, file);
+        try {
+            const state = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+            for (const [phase, session] of Object.entries(state.sessions || {})) {
+                const sess = session;
+                if (sess.id === sessionId && sess.active) {
+                    targetGoalId = state.goalId;
+                    targetPhase = phase;
+                    break;
+                }
+            }
+            if (targetGoalId)
+                break;
+        }
+        catch (err) {
+            logger_1.log.warn(`[hook:session-ending] Failed to parse ${file}: ${err.message}`);
+        }
+    }
+    if (!targetGoalId) {
+        logger_1.log.warn(`[hook:session-ending] No active state found for session ${sessionId}`);
+        return;
+    }
+    // 2. 鍏滃簳妫€鏌ワ細濡傛灉 state 鐨?nextAction 杩樻槸 WAIT_PHASE_COMPLETE锛?
+    // 璇存槑 Skill Entry 娌℃潵寰楀強鏇存柊 state锛堝紓甯告垨瓒呮椂锛?
+    try {
+        const state = await (0, state_1.loadState)(targetGoalId, projectDir);
+        if (state.nextAction === 'WAIT_PHASE_COMPLETE') {
+            logger_1.log.warn(`[hook:session-ending] Session ${sessionId} (${targetPhase}) ended without state update for ${targetGoalId}`);
+            // 鍐欏叆寮傚父鐘舵€侊紝璁?Scheduler 閲嶅缓
+            await (0, state_1.updateState)(targetGoalId, {
+                nextAction: `CREATE_${targetPhase.toUpperCase()}_SESSION`,
+                error: 'session_ended_without_state_update',
+                sessions: {
+                    ...state.sessions,
+                    [targetPhase]: {
+                        ...state.sessions[targetPhase],
+                        destroyedAt: new Date().toISOString(),
+                        active: false
+                    }
+                }
+            }, projectDir);
+        }
+        else {
+        }
+    }
+    catch (err) {
+        logger_1.log.error(`[hook:session-ending] Failed to load state for ${targetGoalId}: ${err.message}`);
+    }
+}

package/gateway/dist/core/hooks/session-start.js

@@ -0,0 +1,51 @@
+"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.sessionStartHook = sessionStartHook;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+async function sessionStartHook(ctx, options) {
+    const projectDir = ctx.projectDir || process.cwd();
+    const mafwDir = options?.mafwDir || path.join(projectDir, '.mafw');
+    const goalDir = path.join(mafwDir, 'goals');
+    if (fs.existsSync(goalDir)) {
+        const files = fs.readdirSync(goalDir).filter(f => f.endsWith('.md'));
+        if (files.length > 0) {
+            const latest = files.sort().reverse()[0];
+            const goalPath = path.join(goalDir, latest);
+            const goalContent = fs.readFileSync(goalPath, 'utf-8');
+        }
+    }
+}

package/gateway/dist/core/hooks/tool-before.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolBeforeHook = toolBeforeHook;
+async function toolBeforeHook(ctx) {
+}

package/gateway/dist/core/hooks/tool-executed.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolExecutedHook = toolExecutedHook;
+const observation_capture_1 = require("./observation-capture");
+async function toolExecutedHook(hookContext) {
+    const { toolName, output, projectDir } = hookContext;
+    if (output.length > 1000) {
+        const truncated = output.length > 2000 ? output.slice(0, 500) + '\n... [TRUNCATED] ...\n' + output.slice(-500) : output;
+    }
+    await (0, observation_capture_1.captureObservation)({ toolName, output, args: '' });
+}

package/gateway/dist/core/hooks/user-prompt.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userPromptHook = userPromptHook;
+async function userPromptHook(ctx) {
+    if (!ctx.text)
+        return;
+}

package/gateway/dist/core/index.js

@@ -0,0 +1,119 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.archiveWorktree = exports.writeLesson = exports.buildReviewPrompt = exports.buildPlanPrompt = exports.buildTaskPrompt = exports.RemoteCliConnector = exports.toolExecutedHook = exports.sessionEndingHook = exports.GitHubConnector = exports.GitUtils = exports.StatusManager = exports.initState = exports.stateExists = exports.extractGoalId = exports.loadReview = exports.loadReceipts = exports.loadWaves = exports.loadGoal = exports.loadRequest = exports.loadState = exports.updateState = exports.MemoryIndexManager = exports.CompressionVerifier = exports.LessonCompactor = exports.SessionPruner = exports.T1ToT2Compressor = exports.T1Store = exports.DeltaMerger = exports.TriggerMatcher = exports.DeltaValidator = exports.MemoryExtractor = exports.DeltaInjector = exports.ParametricStore = exports.WaveExecutor = exports.DegradationStrategy = exports.ReportGenerator = exports.LessonManager = exports.TaskBranchManager = exports.GoalWorktreeManager = exports.startNextLoop = exports.shouldStartNextLoop = exports.updateWaveProgress = exports.markSessionDestroyed = exports.recordSession = exports.canExecuteInPhase = exports.getCurrentPhase = exports.transitionPhase = exports.MafwPlugin = void 0;
+const logger_1 = require("./utils/logger");
+/**
+ * MAFW Loop Agent —Plugin Main Entry Point (v4.1)
+ *
+ * Re-exports all modules for easy consumption.
+ */
+// 鈹€鈹€ Plugin 鈹€鈹€
+var plugin_1 = require("./plugin");
+Object.defineProperty(exports, "MafwPlugin", { enumerable: true, get: function () { return __importDefault(plugin_1).default; } });
+// 鈹€鈹€ Engine 鈹€鈹€
+var phase_orchestrator_1 = require("./engine/phase-orchestrator");
+Object.defineProperty(exports, "transitionPhase", { enumerable: true, get: function () { return phase_orchestrator_1.transitionPhase; } });
+Object.defineProperty(exports, "getCurrentPhase", { enumerable: true, get: function () { return phase_orchestrator_1.getCurrentPhase; } });
+Object.defineProperty(exports, "canExecuteInPhase", { enumerable: true, get: function () { return phase_orchestrator_1.canExecuteInPhase; } });
+Object.defineProperty(exports, "recordSession", { enumerable: true, get: function () { return phase_orchestrator_1.recordSession; } });
+Object.defineProperty(exports, "markSessionDestroyed", { enumerable: true, get: function () { return phase_orchestrator_1.markSessionDestroyed; } });
+Object.defineProperty(exports, "updateWaveProgress", { enumerable: true, get: function () { return phase_orchestrator_1.updateWaveProgress; } });
+Object.defineProperty(exports, "shouldStartNextLoop", { enumerable: true, get: function () { return phase_orchestrator_1.shouldStartNextLoop; } });
+Object.defineProperty(exports, "startNextLoop", { enumerable: true, get: function () { return phase_orchestrator_1.startNextLoop; } });
+var goal_worktree_manager_1 = require("./engine/goal-worktree-manager");
+Object.defineProperty(exports, "GoalWorktreeManager", { enumerable: true, get: function () { return goal_worktree_manager_1.GoalWorktreeManager; } });
+var task_branch_manager_1 = require("./engine/task-branch-manager");
+Object.defineProperty(exports, "TaskBranchManager", { enumerable: true, get: function () { return task_branch_manager_1.TaskBranchManager; } });
+var lesson_manager_1 = require("./engine/lesson-manager");
+Object.defineProperty(exports, "LessonManager", { enumerable: true, get: function () { return lesson_manager_1.LessonManager; } });
+var report_generator_1 = require("./engine/report-generator");
+Object.defineProperty(exports, "ReportGenerator", { enumerable: true, get: function () { return report_generator_1.ReportGenerator; } });
+var degradation_1 = require("./engine/degradation");
+Object.defineProperty(exports, "DegradationStrategy", { enumerable: true, get: function () { return degradation_1.DegradationStrategy; } });
+var wave_executor_1 = require("./engine/wave-executor");
+Object.defineProperty(exports, "WaveExecutor", { enumerable: true, get: function () { return wave_executor_1.WaveExecutor; } });
+// 鈹€鈹€ Memory (L3 Parametric) 鈹€鈹€
+var store_1 = require("./memory/store");
+Object.defineProperty(exports, "ParametricStore", { enumerable: true, get: function () { return store_1.ParametricStore; } });
+var injector_1 = require("./memory/injector");
+Object.defineProperty(exports, "DeltaInjector", { enumerable: true, get: function () { return injector_1.DeltaInjector; } });
+var extractor_1 = require("./memory/extractor");
+Object.defineProperty(exports, "MemoryExtractor", { enumerable: true, get: function () { return extractor_1.MemoryExtractor; } });
+var validator_1 = require("./memory/validator");
+Object.defineProperty(exports, "DeltaValidator", { enumerable: true, get: function () { return validator_1.DeltaValidator; } });
+var matcher_1 = require("./memory/matcher");
+Object.defineProperty(exports, "TriggerMatcher", { enumerable: true, get: function () { return matcher_1.TriggerMatcher; } });
+var merger_1 = require("./memory/merger");
+Object.defineProperty(exports, "DeltaMerger", { enumerable: true, get: function () { return merger_1.DeltaMerger; } });
+// 鈹€鈹€ Memory (T1 Observations / Harmonic) 鈹€鈹€
+var t1_store_1 = require("./memory/t1-store");
+Object.defineProperty(exports, "T1Store", { enumerable: true, get: function () { return t1_store_1.T1Store; } });
+var t1_to_t2_compressor_1 = require("./memory/t1-to-t2-compressor");
+Object.defineProperty(exports, "T1ToT2Compressor", { enumerable: true, get: function () { return t1_to_t2_compressor_1.T1ToT2Compressor; } });
+// 鈹€鈹€ Compression (L1, L2) 鈹€鈹€
+var session_pruner_1 = require("./compression/session-pruner");
+Object.defineProperty(exports, "SessionPruner", { enumerable: true, get: function () { return session_pruner_1.SessionPruner; } });
+var lesson_compactor_1 = require("./compression/lesson-compactor");
+Object.defineProperty(exports, "LessonCompactor", { enumerable: true, get: function () { return lesson_compactor_1.LessonCompactor; } });
+var compression_verifier_1 = require("./compression/compression-verifier");
+Object.defineProperty(exports, "CompressionVerifier", { enumerable: true, get: function () { return compression_verifier_1.CompressionVerifier; } });
+var memory_index_1 = require("./compression/memory-index");
+Object.defineProperty(exports, "MemoryIndexManager", { enumerable: true, get: function () { return memory_index_1.MemoryIndexManager; } });
+// 鈹€鈹€ Utils 鈹€鈹€
+var state_1 = require("./utils/state");
+Object.defineProperty(exports, "updateState", { enumerable: true, get: function () { return state_1.updateState; } });
+Object.defineProperty(exports, "loadState", { enumerable: true, get: function () { return state_1.loadState; } });
+Object.defineProperty(exports, "loadRequest", { enumerable: true, get: function () { return state_1.loadRequest; } });
+Object.defineProperty(exports, "loadGoal", { enumerable: true, get: function () { return state_1.loadGoal; } });
+Object.defineProperty(exports, "loadWaves", { enumerable: true, get: function () { return state_1.loadWaves; } });
+Object.defineProperty(exports, "loadReceipts", { enumerable: true, get: function () { return state_1.loadReceipts; } });
+Object.defineProperty(exports, "loadReview", { enumerable: true, get: function () { return state_1.loadReview; } });
+Object.defineProperty(exports, "extractGoalId", { enumerable: true, get: function () { return state_1.extractGoalId; } });
+Object.defineProperty(exports, "stateExists", { enumerable: true, get: function () { return state_1.stateExists; } });
+Object.defineProperty(exports, "initState", { enumerable: true, get: function () { return state_1.initState; } });
+var status_1 = require("./utils/status");
+Object.defineProperty(exports, "StatusManager", { enumerable: true, get: function () { return status_1.StatusManager; } });
+var git_1 = require("./utils/git");
+Object.defineProperty(exports, "GitUtils", { enumerable: true, get: function () { return git_1.GitUtils; } });
+var github_1 = require("./utils/github");
+Object.defineProperty(exports, "GitHubConnector", { enumerable: true, get: function () { return github_1.GitHubConnector; } });
+// 鈹€鈹€ Hooks 鈹€鈹€
+var session_ending_1 = require("./hooks/session-ending");
+Object.defineProperty(exports, "sessionEndingHook", { enumerable: true, get: function () { return session_ending_1.sessionEndingHook; } });
+var tool_executed_1 = require("./hooks/tool-executed");
+Object.defineProperty(exports, "toolExecutedHook", { enumerable: true, get: function () { return tool_executed_1.toolExecutedHook; } });
+// 鈹€鈹€ Tools 鈹€鈹€
+var remote_cli_1 = require("./tools/remote-cli");
+Object.defineProperty(exports, "RemoteCliConnector", { enumerable: true, get: function () { return remote_cli_1.RemoteCliConnector; } });
+var run_execute_wave_1 = require("./tools/run-execute-wave");
+Object.defineProperty(exports, "buildTaskPrompt", { enumerable: true, get: function () { return run_execute_wave_1.buildTaskPrompt; } });
+var run_plan_1 = require("./tools/run-plan");
+Object.defineProperty(exports, "buildPlanPrompt", { enumerable: true, get: function () { return run_plan_1.buildPlanPrompt; } });
+var run_review_1 = require("./tools/run-review");
+Object.defineProperty(exports, "buildReviewPrompt", { enumerable: true, get: function () { return run_review_1.buildReviewPrompt; } });
+var write_lesson_1 = require("./tools/write-lesson");
+Object.defineProperty(exports, "writeLesson", { enumerable: true, get: function () { return write_lesson_1.writeLesson; } });
+var archive_worktree_1 = require("./tools/archive-worktree");
+Object.defineProperty(exports, "archiveWorktree", { enumerable: true, get: function () { return archive_worktree_1.archiveWorktree; } });
+// 鈹€鈹€ Types 鈹€鈹€
+__exportStar(require("./types/parametric"), exports);
+__exportStar(require("./types/compression"), exports);
+__exportStar(require("./types/state"), exports);
+logger_1.log.info('[MAFW Plugin] v4.1 loaded —Phase Relay + TMEM + Automation');

package/gateway/dist/core/langchain/agent-adapter.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeAgentAdapter = exports.BaseSingleActionAgent = void 0;
+class BaseSingleActionAgent {
+    lc_namespace;
+}
+exports.BaseSingleActionAgent = BaseSingleActionAgent;
+class CodeAgentAdapter extends BaseSingleActionAgent {
+    services;
+    instruction;
+    goalId;
+    lc_namespace = ["mafw", "agent"];
+    constructor(services, instruction, goalId) {
+        super();
+        this.services = services;
+        this.instruction = instruction;
+        this.goalId = goalId;
+    }
+    get inputKeys() {
+        return ["input"];
+    }
+    get outputKeys() {
+        return ["output"];
+    }
+    async plan(_steps, _callbacks, _config) {
+        const session = await this.services.client.session.create({ directory: this.instruction });
+        try {
+            await this.services.client.session.promptAsync({ sessionID: session.id, parts: [{ type: 'text', text: this.instruction }] });
+            return {
+                returnValues: { output: 'delegated_to_opencode' },
+                log: `Delegated to OpenCode SDK: ${this.instruction}`,
+            };
+        }
+        finally {
+            await this.services.client.session.delete({ sessionID: session.id });
+        }
+    }
+}
+exports.CodeAgentAdapter = CodeAgentAdapter;

package/gateway/dist/core/langchain/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseReviewVerdict = exports.createAgentNode = exports.MAFWMemory = exports.MAFWRetriever = exports.CodeAgentAdapter = void 0;
+var agent_adapter_1 = require("./agent-adapter");
+Object.defineProperty(exports, "CodeAgentAdapter", { enumerable: true, get: function () { return agent_adapter_1.CodeAgentAdapter; } });
+var retriever_1 = require("./retriever");
+Object.defineProperty(exports, "MAFWRetriever", { enumerable: true, get: function () { return retriever_1.MAFWRetriever; } });
+var memory_1 = require("./memory");
+Object.defineProperty(exports, "MAFWMemory", { enumerable: true, get: function () { return memory_1.MAFWMemory; } });
+var node_runner_1 = require("./node-runner");
+Object.defineProperty(exports, "createAgentNode", { enumerable: true, get: function () { return node_runner_1.createAgentNode; } });
+Object.defineProperty(exports, "parseReviewVerdict", { enumerable: true, get: function () { return node_runner_1.parseReviewVerdict; } });

package/gateway/dist/core/langchain/memory.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAFWMemory = void 0;
+const logger_1 = require("../utils/logger");
+const memory_1 = require("@langchain/core/memory");
+class MAFWMemory extends memory_1.BaseMemory {
+    harmonicIndex;
+    parametricStore;
+    lc_namespace = ["mafw", "memory"];
+    get memoryKeys() {
+        return ["l3_constraints", "hot_memories"];
+    }
+    constructor(harmonicIndex, parametricStore) {
+        super();
+        this.harmonicIndex = harmonicIndex;
+        this.parametricStore = parametricStore;
+    }
+    async loadMemoryVariables(_values) {
+        const hot_memories = this.harmonicIndex
+            ? this.harmonicIndex.search("", 5)
+                .map((e) => e.primary_abstraction)
+                .join("\n")
+            : "";
+        const l3_constraints = this.parametricStore
+            ? this.parametricStore.loadAll()
+                .map((c) => `[${c.type}] ${c.rule || c.prompt_delta || c.pattern_template || ''}`)
+                .join("\n")
+            : "";
+        return { hot_memories, l3_constraints };
+    }
+    async saveContext(_input, _output) {
+        logger_1.log.info("[MAFWMemory] Agent output:", JSON.stringify(_output));
+    }
+}
+exports.MAFWMemory = MAFWMemory;

package/gateway/dist/core/langchain/node-runner.js

@@ -0,0 +1,115 @@
+"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.parseReviewVerdict = void 0;
+exports.createAgentNode = createAgentNode;
+const langgraph_1 = require("@langchain/langgraph");
+const review_parser_1 = require("../langgraph/review-parser");
+Object.defineProperty(exports, "parseReviewVerdict", { enumerable: true, get: function () { return review_parser_1.parseReviewVerdict; } });
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const NODE_CONFIGS = {
+    plan: {
+        skillCommand: '/skill mafw-plan',
+        interruptLabel: 'awaiting_plan',
+        phaseName: 'PLANNING',
+        phaseCompleteName: 'PLANNING_COMPLETE',
+        getResultFile: (state) => path.join(state.mafwDir, 'waves.json'),
+        parseResult: (filePath, state) => {
+            JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+            return { wavePlanPath: filePath, round: state.round };
+        },
+        errorMessage: 'waves.json not found after plan',
+    },
+    execute: {
+        skillCommand: '/skill mafw-execute',
+        interruptLabel: 'awaiting_execution',
+        phaseName: 'EXECUTING',
+        phaseCompleteName: 'EXECUTING_COMPLETE',
+        getResultFile: (state) => path.join(state.mafwDir, 'receipts', state.goalId, 'loop-receipt.json'),
+        parseResult: (filePath) => {
+            JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+            return { receiptPath: filePath };
+        },
+        errorMessage: 'receipts not found after execute',
+    },
+    review: {
+        skillCommand: '/skill mafw-review',
+        interruptLabel: 'awaiting_review',
+        phaseName: 'REVIEWING',
+        phaseCompleteName: 'REVIEWING_COMPLETE',
+        getResultFile: (state) => path.join(state.mafwDir, 'reviews', `${state.goalId}-loop${state.round}.md`),
+        parseResult: (filePath) => {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const verdict = (0, review_parser_1.parseReviewVerdict)(content);
+            return {
+                reviewVerdict: verdict.verdict,
+                reviewReportPath: filePath,
+                reviewFeedback: verdict.feedback,
+            };
+        },
+        errorMessage: 'review report not found',
+    },
+};
+function createAgentNode(type) {
+    const config = NODE_CONFIGS[type];
+    return async function agentNode(state, options) {
+        const { client, syncToFile } = options;
+        const { goalId, projectDir } = state;
+        syncToFile({ ...state, phase: config.phaseName });
+        const session = await client.session.create({ directory: projectDir });
+        const sessionId = session.id;
+        options.onSessionCreated?.({ goalId: goalId, sessionId, phase: type, loop: state.round });
+        const prompt = `${config.skillCommand} ${goalId}`;
+        // Memory injection is handled by the `withMemoryInjection` interceptor
+        // applied in createInProcessClient(). No inline memory injection needed here.
+        await client.session.promptAsync({ sessionID: sessionId, parts: [{ type: 'text', text: prompt }] });
+        (0, langgraph_1.interrupt)(config.interruptLabel);
+        const filePath = config.getResultFile(state);
+        if (!fs.existsSync(filePath)) {
+            return { lastError: config.errorMessage, reviewVerdict: 'ERROR' };
+        }
+        let result;
+        try {
+            result = config.parseResult(filePath, state);
+        }
+        catch (err) {
+            return { lastError: `Invalid ${type} result at ${filePath}: ${err.message}`, reviewVerdict: 'ERROR' };
+        }
+        await client.session.delete({ sessionID: sessionId });
+        syncToFile({ ...result, phase: config.phaseCompleteName });
+        return result;
+    };
+}

package/gateway/dist/core/langchain/retriever.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAFWRetriever = void 0;
+const retrievers_1 = require("@langchain/core/retrievers");
+const documents_1 = require("@langchain/core/documents");
+class MAFWRetriever extends retrievers_1.BaseRetriever {
+    lc_namespace = ["mafw", "retriever"];
+    harmonicIndex;
+    defaultLimit;
+    constructor(harmonicIndex, defaultLimit = 20) {
+        super();
+        this.harmonicIndex = harmonicIndex;
+        this.defaultLimit = defaultLimit;
+    }
+    async _getRelevantDocuments(query) {
+        const entries = this.harmonicIndex.search(query, this.defaultLimit);
+        return entries.map(entry => new documents_1.Document({
+            pageContent: entry.primary_abstraction,
+            metadata: {
+                id: entry.id,
+                type: entry.type,
+                tier: entry.tier,
+                energy: entry.energy,
+            },
+        }));
+    }
+}
+exports.MAFWRetriever = MAFWRetriever;