@jack200714/mafw 4.5.1

package/gateway/dist/core/langgraph/checkpointer.js

@@ -0,0 +1,200 @@
+"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.FileCheckpointer = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const langgraph_1 = require("@langchain/langgraph");
+class FileCheckpointer extends langgraph_1.BaseCheckpointSaver {
+    baseDir;
+    constructor(baseDir) {
+        super();
+        this.baseDir = baseDir;
+    }
+    threadDir(threadId) {
+        return path.join(this.baseDir, 'checkpoints', threadId);
+    }
+    stepPath(threadId, step) {
+        return path.join(this.threadDir(threadId), `step_${String(step).padStart(7, '0')}.json`);
+    }
+    metadataPath(threadId) {
+        return path.join(this.threadDir(threadId), 'metadata.json');
+    }
+    nextStep(threadId) {
+        const dir = this.threadDir(threadId);
+        if (!fs.existsSync(dir))
+            return 1;
+        const files = fs.readdirSync(dir).filter(f => f.startsWith('step_'));
+        if (files.length === 0)
+            return 1;
+        const maxStep = Math.max(...files.map(f => parseInt(f.replace('step_', '').replace('.json', ''), 10)));
+        return maxStep + 1;
+    }
+    async get(config) {
+        const { thread_id } = config.configurable ?? {};
+        if (!thread_id)
+            return undefined;
+        const dir = this.threadDir(thread_id);
+        if (!fs.existsSync(dir))
+            return undefined;
+        const files = fs.readdirSync(dir).filter(f => f.startsWith('step_'));
+        if (files.length === 0)
+            return undefined;
+        const maxStep = Math.max(...files.map(f => parseInt(f.replace('step_', '').replace('.json', ''), 10)));
+        const data = JSON.parse(fs.readFileSync(this.stepPath(thread_id, maxStep), 'utf-8'));
+        return {
+            v: 1,
+            id: `${thread_id}-step-${maxStep}`,
+            ts: data.ts,
+            channel_values: data.state,
+            channel_versions: {},
+            versions_seen: {},
+        };
+    }
+    async getTuple(config) {
+        const { thread_id } = config.configurable ?? {};
+        if (!thread_id)
+            return undefined;
+        const dir = this.threadDir(thread_id);
+        if (!fs.existsSync(dir))
+            return undefined;
+        const files = fs.readdirSync(dir).filter(f => f.startsWith('step_'));
+        if (files.length === 0)
+            return undefined;
+        const maxStep = Math.max(...files.map(f => parseInt(f.replace('step_', '').replace('.json', ''), 10)));
+        const cpPath = this.stepPath(thread_id, maxStep);
+        const data = JSON.parse(fs.readFileSync(cpPath, 'utf-8'));
+        const checkpoint = {
+            v: 1,
+            id: `${thread_id}-step-${maxStep}`,
+            ts: data.ts,
+            channel_values: data.state,
+            channel_versions: {},
+            versions_seen: {},
+        };
+        const metaPath = this.metadataPath(thread_id);
+        let metadata;
+        if (fs.existsSync(metaPath)) {
+            const meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+            metadata = { step: meta.step };
+        }
+        return {
+            config,
+            checkpoint,
+            metadata,
+            parentConfig: undefined,
+        };
+    }
+    async put(config, checkpoint, metadata, newVersions) {
+        const { thread_id } = config.configurable ?? {};
+        if (!thread_id)
+            return config;
+        const dir = this.threadDir(thread_id);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const step = (metadata?.step) ?? this.nextStep(thread_id);
+        const state = checkpoint.state ?? checkpoint.channel_values ?? {};
+        const data = {
+            thread_id,
+            node_id: checkpoint.node_id || '',
+            ts: checkpoint.ts || new Date().toISOString(),
+            state,
+        };
+        fs.writeFileSync(this.stepPath(thread_id, step), JSON.stringify(data, null, 2), 'utf-8');
+        fs.writeFileSync(this.metadataPath(thread_id), JSON.stringify({ step, retries: metadata?.retries ?? 0, lastError: metadata?.lastError }, null, 2), 'utf-8');
+        return config;
+    }
+    async *list(config, options) {
+        const { thread_id } = config.configurable ?? {};
+        if (!thread_id)
+            return;
+        const dir = this.threadDir(thread_id);
+        if (!fs.existsSync(dir))
+            return;
+        let files = fs.readdirSync(dir).filter(f => f.startsWith('step_')).sort();
+        if (options?.before?.configurable?.checkpoint_id) {
+            const beforeStep = parseInt(options.before.configurable.checkpoint_id.replace('step_', ''), 10);
+            if (!isNaN(beforeStep)) {
+                files = files.filter(f => {
+                    const step = parseInt(f.replace('step_', '').replace('.json', ''), 10);
+                    return step < beforeStep;
+                });
+            }
+        }
+        const toRead = options?.limit ? files.slice(-options.limit) : files;
+        for (const f of toRead) {
+            const data = JSON.parse(fs.readFileSync(path.join(dir, f), 'utf-8'));
+            const step = parseInt(f.replace('step_', '').replace('.json', ''), 10);
+            const checkpoint = {
+                v: 1,
+                id: `${thread_id}-step-${step}`,
+                ts: data.ts,
+                channel_values: data.state,
+                channel_versions: {},
+                versions_seen: {},
+            };
+            yield { config: { configurable: { thread_id, checkpoint_id: `step_${String(step).padStart(7, '0')}` } }, checkpoint };
+        }
+    }
+    async putWrites(config, writes, taskId) {
+        // no-op for simple file-based storage
+    }
+    async deleteThread(threadId) {
+        const dir = this.threadDir(threadId);
+        if (fs.existsSync(dir)) {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+    }
+    async getCurrentState(threadId) {
+        const metaPath = this.metadataPath(threadId);
+        const dir = this.threadDir(threadId);
+        if (!fs.existsSync(dir) || !fs.existsSync(metaPath))
+            return null;
+        const meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+        const files = fs.readdirSync(dir).filter(f => f.startsWith('step_'));
+        if (files.length === 0)
+            return null;
+        const maxStep = Math.max(...files.map(f => parseInt(f.replace('step_', '').replace('.json', ''), 10)));
+        const cp = JSON.parse(fs.readFileSync(this.stepPath(threadId, maxStep), 'utf-8'));
+        return {
+            round: cp.state.round ?? 1,
+            phase: cp.state.phase ?? 'UNKNOWN',
+            verdict: cp.state.reviewVerdict ?? 'FAIL',
+            lastError: meta.lastError,
+        };
+    }
+}
+exports.FileCheckpointer = FileCheckpointer;

package/gateway/dist/core/langgraph/graph.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routeAfterReview = routeAfterReview;
+exports.routeAfterPlan = routeAfterPlan;
+exports.buildExecutionGraph = buildExecutionGraph;
+const langgraph_1 = require("@langchain/langgraph");
+const loop_state_1 = require("./loop-state");
+function routeAfterReview(state) {
+    if (state.lastError)
+        return "archive_fail";
+    if (state.reviewVerdict === "PASS")
+        return "archive_success";
+    if (state.round >= state.maxRounds)
+        return "archive_max_retries";
+    if (state.pendingQuestion)
+        return "askUser";
+    return "plan";
+}
+function routeAfterPlan(state) {
+    if (state.pendingQuestion)
+        return "askUser";
+    return "execute";
+}
+function buildExecutionGraph(options) {
+    const workflow = new langgraph_1.StateGraph(loop_state_1.LoopState)
+        .addNode("plan", options.plan, {
+        retryPolicy: { maxAttempts: 2 },
+    })
+        .addNode("askUser", options.askUser)
+        .addNode("execute", options.execute, {
+        retryPolicy: { maxAttempts: 2 },
+    })
+        .addNode("review", options.review, {
+        retryPolicy: { maxAttempts: 2 },
+    })
+        .addNode("archive_success", options.archiveSuccess)
+        .addNode("archive_fail", options.archiveFail)
+        .addNode("archive_max_retries", options.archiveMaxRetries)
+        .addEdge("__start__", "plan")
+        .addConditionalEdges("plan", routeAfterPlan, {
+        askUser: "askUser",
+        execute: "execute",
+    })
+        .addEdge("askUser", "plan")
+        .addEdge("execute", "review")
+        .addConditionalEdges("review", routeAfterReview, {
+        plan: "plan",
+        askUser: "askUser",
+        archive_success: "archive_success",
+        archive_fail: "archive_fail",
+        archive_max_retries: "archive_max_retries",
+    })
+        .addEdge("archive_success", langgraph_1.END)
+        .addEdge("archive_fail", langgraph_1.END)
+        .addEdge("archive_max_retries", langgraph_1.END);
+    return workflow.compile();
+}

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

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgentNode = exports.FileCheckpointer = exports.syncToDashboard = exports.archiveMaxRetriesNode = exports.archiveFailNode = exports.archiveSuccessNode = exports.parseReviewVerdict = exports.reviewNode = exports.executeNode = exports.planNode = exports.buildExecutionGraph = exports.routeAfterReview = exports.LoopState = void 0;
+var loop_state_1 = require("./loop-state");
+Object.defineProperty(exports, "LoopState", { enumerable: true, get: function () { return loop_state_1.LoopState; } });
+var graph_1 = require("./graph");
+Object.defineProperty(exports, "routeAfterReview", { enumerable: true, get: function () { return graph_1.routeAfterReview; } });
+Object.defineProperty(exports, "buildExecutionGraph", { enumerable: true, get: function () { return graph_1.buildExecutionGraph; } });
+var plan_node_1 = require("./nodes/plan.node");
+Object.defineProperty(exports, "planNode", { enumerable: true, get: function () { return plan_node_1.planNode; } });
+var execute_node_1 = require("./nodes/execute.node");
+Object.defineProperty(exports, "executeNode", { enumerable: true, get: function () { return execute_node_1.executeNode; } });
+var review_node_1 = require("./nodes/review.node");
+Object.defineProperty(exports, "reviewNode", { enumerable: true, get: function () { return review_node_1.reviewNode; } });
+Object.defineProperty(exports, "parseReviewVerdict", { enumerable: true, get: function () { return review_node_1.parseReviewVerdict; } });
+var archive_node_1 = require("./nodes/archive.node");
+Object.defineProperty(exports, "archiveSuccessNode", { enumerable: true, get: function () { return archive_node_1.archiveSuccessNode; } });
+Object.defineProperty(exports, "archiveFailNode", { enumerable: true, get: function () { return archive_node_1.archiveFailNode; } });
+Object.defineProperty(exports, "archiveMaxRetriesNode", { enumerable: true, get: function () { return archive_node_1.archiveMaxRetriesNode; } });
+var sync_node_1 = require("./nodes/sync.node");
+Object.defineProperty(exports, "syncToDashboard", { enumerable: true, get: function () { return sync_node_1.syncToDashboard; } });
+var checkpointer_1 = require("./checkpointer");
+Object.defineProperty(exports, "FileCheckpointer", { enumerable: true, get: function () { return checkpointer_1.FileCheckpointer; } });
+var node_runner_1 = require("../langchain/node-runner");
+Object.defineProperty(exports, "createAgentNode", { enumerable: true, get: function () { return node_runner_1.createAgentNode; } });

package/gateway/dist/core/langgraph/loop-state.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoopState = void 0;
+const langgraph_1 = require("@langchain/langgraph");
+exports.LoopState = langgraph_1.Annotation.Root({
+    goalId: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a,
+    }),
+    projectDir: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a,
+    }),
+    mafwDir: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a,
+    }),
+    round: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a ?? 0,
+        default: () => 1,
+    }),
+    maxRounds: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a ?? 0,
+        default: () => 3,
+    }),
+    wavePlanPath: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a,
+        default: () => null,
+    }),
+    receiptPath: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a,
+        default: () => null,
+    }),
+    reviewVerdict: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a,
+        default: () => "FAIL",
+    }),
+    reviewReportPath: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a,
+        default: () => null,
+    }),
+    reviewFeedback: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a,
+        default: () => "",
+    }),
+    lastError: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a,
+        default: () => null,
+    }),
+    phase: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a,
+        default: () => null,
+    }),
+    draftPlan: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a,
+        default: () => null,
+    }),
+    pendingQuestion: (0, langgraph_1.Annotation)({
+        value: (a, b) => b === undefined ? a : b,
+        default: () => null,
+    }),
+    userResponse: (0, langgraph_1.Annotation)({
+        value: (a, b) => b === undefined ? a : b,
+        default: () => null,
+    }),
+    sameSigCount: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a ?? 0,
+        default: () => 0,
+    }),
+    stateVersion: (0, langgraph_1.Annotation)({
+        value: (a, b) => b ?? a ?? 0,
+        default: () => 0,
+    }),
+});

package/gateway/dist/core/langgraph/nodes/archive.node.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.archiveSuccessNode = archiveSuccessNode;
+exports.archiveFailNode = archiveFailNode;
+exports.archiveMaxRetriesNode = archiveMaxRetriesNode;
+const logger_1 = require("../../utils/logger");
+async function archiveSuccessNode(state, options) {
+    const { archiveGoal, syncToFile } = options;
+    logger_1.log.info(`[LangGraph] Goal ${state.goalId} PASSED after ${state.round} round(s)`);
+    syncToFile({ ...state, phase: 'ARCHIVED' });
+    await archiveGoal(state.goalId);
+    return {};
+}
+async function archiveFailNode(state, options) {
+    const { archiveGoal, syncToFile } = options;
+    logger_1.log.error(`[LangGraph] Goal ${state.goalId} FAILED: ${state.lastError}`);
+    syncToFile({ ...state, phase: 'FAILED' });
+    await archiveGoal(state.goalId);
+    return {};
+}
+async function archiveMaxRetriesNode(state, options) {
+    const { archiveGoal, syncToFile } = options;
+    logger_1.log.error(`[LangGraph] Goal ${state.goalId} max retries (${state.maxRounds}) reached`);
+    syncToFile({ ...state, phase: 'FAILED' });
+    await archiveGoal(state.goalId);
+    return {};
+}

package/gateway/dist/core/langgraph/nodes/execute.node.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeNode = void 0;
+const node_runner_1 = require("../../langchain/node-runner");
+exports.executeNode = (0, node_runner_1.createAgentNode)('execute');

package/gateway/dist/core/langgraph/nodes/plan.node.js

@@ -0,0 +1,101 @@
+"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.planNode = planNode;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+function generateQuestionId() {
+    return `q_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+async function finalizeWithAnswer(state) {
+    return {
+        draftPlan: null,
+        pendingQuestion: null,
+        userResponse: null,
+        round: state.round,
+        wavePlanPath: state.wavePlanPath ?? null,
+        reviewFeedback: state.userResponse?.answer
+            ? `Plan refined with user input: ${state.userResponse.answer}`
+            : undefined,
+    };
+}
+async function planNode(state, services) {
+    const { client, syncToFile } = services;
+    const { goalId, projectDir } = state;
+    syncToFile({ ...state, phase: 'PLANNING' });
+    if (state.draftPlan && state.userResponse) {
+        const refined = await finalizeWithAnswer(state);
+        syncToFile({ ...refined, phase: 'PLANNING_COMPLETE' });
+        return { ...refined, draftPlan: null, pendingQuestion: null, userResponse: null };
+    }
+    const session = await client.session.create({ directory: projectDir });
+    const sessionId = session.id;
+    services.onSessionCreated?.({ goalId: goalId, sessionId, phase: 'plan', loop: state.round });
+    await client.session.promptAsync({ sessionID: sessionId, parts: [{ type: 'text', text: `/skill mafw-plan ${goalId}` }] });
+    const wavePlanPath = path.join(state.mafwDir, 'waves.json');
+    if (!fs.existsSync(wavePlanPath)) {
+        return { lastError: 'waves.json not found after plan', reviewVerdict: 'ERROR' };
+    }
+    let wavesData;
+    try {
+        wavesData = JSON.parse(fs.readFileSync(wavePlanPath, 'utf-8'));
+    }
+    catch (err) {
+        return { lastError: `Invalid waves.json: ${err.message}`, reviewVerdict: 'ERROR' };
+    }
+    const needsClarification = wavesData.status === 'need_clarification';
+    const result = {
+        wavePlanPath,
+        round: state.round,
+        draftPlan: needsClarification ? wavesData : null,
+        pendingQuestion: needsClarification
+            ? {
+                questionId: generateQuestionId(),
+                node: 'plan',
+                loop: state.round,
+                questions: wavesData.ambiguities || [],
+                askedAt: new Date().toISOString(),
+            }
+            : null,
+    };
+    try {
+        await client.session.delete({ sessionID: sessionId });
+    }
+    catch {
+        // non-fatal: session may have already been cleaned up
+    }
+    syncToFile({ ...result, phase: 'PLANNING_COMPLETE' });
+    return result;
+}

package/gateway/dist/core/langgraph/nodes/review.node.js

@@ -0,0 +1,89 @@
+"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.reviewNode = reviewNode;
+const signature_detector_1 = require("../signature-detector");
+const review_parser_1 = require("../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"));
+/** Maximum number of times the same signature question can be asked before forcing a decision */
+const MAX_SAME_SIG_QUESTIONS = 3;
+function generateQuestionId() {
+    return `q_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+async function reviewNode(state, services) {
+    const { client, syncToFile } = services;
+    const { goalId, projectDir } = state;
+    syncToFile({ ...state, phase: 'REVIEWING' });
+    const session = await client.session.create({ directory: projectDir });
+    const sessionId = session.id;
+    services.onSessionCreated?.({ goalId: goalId, sessionId, phase: 'review', loop: state.round });
+    await client.session.promptAsync({ sessionID: sessionId, parts: [{ type: 'text', text: `/skill mafw-review ${goalId}` }] });
+    const reviewPath = path.join(state.mafwDir, 'reviews', `${state.goalId}-loop${state.round}.md`);
+    if (!fs.existsSync(reviewPath)) {
+        return { lastError: 'review report not found', reviewVerdict: 'ERROR' };
+    }
+    const content = fs.readFileSync(reviewPath, 'utf-8');
+    const verdict = (0, review_parser_1.parseReviewVerdict)(content);
+    const result = {
+        reviewVerdict: verdict.verdict,
+        reviewReportPath: reviewPath,
+        reviewFeedback: verdict.feedback,
+        round: state.round + 1,
+        stateVersion: (state.stateVersion ?? 0) + 1,
+    };
+    if (verdict.verdict === 'FAIL' && state.round < state.maxRounds) {
+        const prevFeedback = state.reviewFeedback;
+        const sameSignature = prevFeedback && (0, signature_detector_1.matchesSignature)(prevFeedback, verdict.feedback);
+        const sameSigCount = state.sameSigCount;
+        const newSameSigCount = sameSignature ? sameSigCount + 1 : 1;
+        // Only ask user if we haven't exceeded the cap
+        if (sameSignature && newSameSigCount >= 2 && newSameSigCount <= MAX_SAME_SIG_QUESTIONS) {
+            result.pendingQuestion = {
+                questionId: generateQuestionId(),
+                node: 'review',
+                loop: state.round,
+                questions: [`Review keeps failing with same issue: ${verdict.feedback}. Continue retrying?`],
+                askedAt: new Date().toISOString(),
+            };
+        }
+        result.sameSigCount = newSameSigCount;
+    }
+    await client.session.delete({ sessionID: sessionId });
+    syncToFile({ ...result, phase: 'REVIEWING_COMPLETE' });
+    return result;
+}

package/gateway/dist/core/langgraph/nodes/sync.node.js

@@ -0,0 +1,70 @@
+"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.syncToDashboard = syncToDashboard;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+function syncToDashboard(state) {
+    const statePath = path.join(state.mafwDir, 'state', `${state.goalId}.json`);
+    const dir = path.dirname(statePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const nextAction = state.reviewVerdict === 'PASS'
+        ? 'COMPLETED'
+        : state.lastError
+            ? 'FAILED'
+            : 'WAIT_PHASE_COMPLETE';
+    const dashboardState = {
+        version: '2',
+        goalId: state.goalId,
+        loop: state.round,
+        phase: nextAction === 'COMPLETED'
+            ? 'ARCHIVED'
+            : nextAction === 'FAILED'
+                ? 'FAILED'
+                : 'PLANNING',
+        nextAction,
+        wavePlanPath: state.wavePlanPath,
+        receiptPath: state.receiptPath,
+        reviewVerdict: state.reviewVerdict,
+        reviewFeedback: state.reviewFeedback,
+        error: state.lastError || null,
+        updatedAt: new Date().toISOString(),
+    };
+    const tmpPath = `${statePath}.tmp`;
+    fs.writeFileSync(tmpPath, JSON.stringify(dashboardState, null, 2), 'utf-8');
+    fs.renameSync(tmpPath, statePath);
+}