@jack200714/mafw 4.5.1

package/gateway/dist/core/langgraph/review-parser.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseReviewVerdict = parseReviewVerdict;
+const FENCED_BLOCK_RE = /```mafw-review\s*\n([\s\S]*?)```/;
+function parseReviewVerdict(content) {
+    if (!content || content.trim().length === 0) {
+        return { verdict: 'ERROR', feedback: 'Review response is empty' };
+    }
+    const fenced = content.match(FENCED_BLOCK_RE);
+    if (fenced) {
+        try {
+            const data = JSON.parse(fenced[1].trim());
+            if (typeof data.verdict !== 'string') {
+                return { verdict: 'ERROR', feedback: 'mafw-review block missing verdict field' };
+            }
+            return {
+                verdict: data.verdict === 'PASS' ? 'PASS' : 'FAIL',
+                feedback: data.reason || data.feedback || JSON.stringify(data.metrics || {}),
+            };
+        }
+        catch {
+            return { verdict: 'ERROR', feedback: 'Malformed mafw-review JSON block' };
+        }
+    }
+    try {
+        const data = JSON.parse(content);
+        return {
+            verdict: data.verdict === 'PASS' ? 'PASS' : 'FAIL',
+            feedback: data.reason || data.feedback || JSON.stringify(data.metrics || {}),
+        };
+    }
+    catch {
+        return { verdict: 'ERROR', feedback: 'Review report has no machine-readable verdict block' };
+    }
+}

package/gateway/dist/core/langgraph/signature-detector.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchesSignature = matchesSignature;
+function matchesSignature(prevFeedback, currentFeedback) {
+    const normalize = (s) => s.toLowerCase().trim().replace(/[\s\p{P}]+/gu, ' ').replace(/^\s+|\s+$/g, '');
+    const a = normalize(prevFeedback);
+    const b = normalize(currentFeedback);
+    // Exact match after normalization
+    if (a === b)
+        return true;
+    // Check if one contains the other (handles minor phrasing differences)
+    if (a.includes(b) || b.includes(a))
+        return true;
+    // Jaccard similarity on words (handles reordering and minor additions)
+    const wordsA = new Set(a.split(/\s+/));
+    const wordsB = new Set(b.split(/\s+/));
+    const intersection = new Set([...wordsA].filter(w => wordsB.has(w)));
+    const union = new Set([...wordsA, ...wordsB]);
+    if (union.size === 0)
+        return false;
+    const jaccard = intersection.size / union.size;
+    return jaccard >= 0.7; // 70% word overlap threshold
+}

package/gateway/dist/core/manager/goal-snapshot.js

@@ -0,0 +1,73 @@
+"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.collectActiveGoals = collectActiveGoals;
+exports.buildGoalSnapshot = buildGoalSnapshot;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const TERMINAL_ACTIONS = new Set(['COMPLETED', 'FAILED']);
+function collectActiveGoals(mafwDir) {
+    const stateDir = path.join(mafwDir, 'state');
+    if (!fs.existsSync(stateDir))
+        return [];
+    const entries = [];
+    for (const file of fs.readdirSync(stateDir).filter(f => f.endsWith('.json'))) {
+        try {
+            const s = JSON.parse(fs.readFileSync(path.join(stateDir, file), 'utf-8'));
+            if (TERMINAL_ACTIONS.has(s.nextAction))
+                continue;
+            const pendingQ = s.pendingQuestion
+                ? (Array.isArray(s.pendingQuestion.questions) ? s.pendingQuestion.questions.length : 1)
+                : 0;
+            entries.push({
+                goalId: s.goalId || file.replace('.json', ''),
+                title: s.title || s.goalId || file.replace('.json', ''),
+                phase: s.phase || 'UNKNOWN',
+                round: s.round ?? 0,
+                pendingQuestions: pendingQ,
+            });
+        }
+        catch { /* skip corrupt state */ }
+    }
+    return entries;
+}
+function buildGoalSnapshot(mafwDir, opts) {
+    const maxGoals = opts?.maxGoals ?? 10;
+    const goals = collectActiveGoals(mafwDir);
+    if (goals.length === 0)
+        return null;
+    const lines = goals.slice(0, maxGoals).map(g => `- ${g.goalId}: ${g.title} [phase=${g.phase} round=${g.round}${g.pendingQuestions > 0 ? ` pendingQ=${g.pendingQuestions}` : ''}]`);
+    return `<goal-snapshot>\n${lines.join('\n')}\n</goal-snapshot>`;
+}

package/gateway/dist/core/manager/milestone-push.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MilestonePushNotifier = void 0;
+exports.milestoneDedupeKey = milestoneDedupeKey;
+const logger_1 = require("../utils/logger");
+// Milestones worth notifying the manager about. Phase transitions are emitted
+// by syncToFile (index.ts buildNodeOptions) on the shared event bus; terminal
+// verdicts arrive via onArchived (archiveGoal is the single convergence point
+// of all verdict paths). Execution rounds are deliberately NOT milestones.
+const MILESTONE_PHASES = new Set(['PLANNING_COMPLETE', 'REVIEWING_COMPLETE', 'ASKING_USER']);
+// Langgraph replays node side effects on crash recovery, so the same
+// transition can be emitted twice — the dedupe key must include stateVersion
+// and be persisted (gateway DB), never an in-process Set.
+function milestoneDedupeKey(goalId, phase, stateVersion) {
+    return `${goalId}:${phase}:${stateVersion ?? 0}`;
+}
+class MilestonePushNotifier {
+    deps;
+    flushDelayMs;
+    queues = new Map();
+    timers = new Map();
+    constructor(deps, flushDelayMs = 5000) {
+        this.deps = deps;
+        this.flushDelayMs = flushDelayMs;
+    }
+    onPhaseTransition(data) {
+        if (!data.projectDir || !MILESTONE_PHASES.has(data.phase))
+            return;
+        const state = this.deps.readGoalState(data.goalId, data.projectDir);
+        const key = milestoneDedupeKey(data.goalId, data.phase, state?.stateVersion ?? data.loop);
+        if (this.deps.wasNotified(key))
+            return;
+        this.deps.markNotified(key);
+        this.enqueue(data.projectDir, formatMilestoneLine(data.goalId, state?.title || data.goalId, data.phase, state?.reviewVerdict));
+    }
+    onArchived(goalId, projectDir, verdict) {
+        const state = this.deps.readGoalState(goalId, projectDir);
+        const key = milestoneDedupeKey(goalId, `ARCHIVED:${verdict}`, state?.stateVersion);
+        if (this.deps.wasNotified(key))
+            return;
+        this.deps.markNotified(key);
+        this.enqueue(projectDir, formatMilestoneLine(goalId, state?.title || goalId, `ARCHIVED(${verdict})`));
+    }
+    // Per-project coalescing: bursts of transitions collapse into one message.
+    enqueue(projectDir, line) {
+        const q = this.queues.get(projectDir) || [];
+        q.push(line);
+        this.queues.set(projectDir, q);
+        if (this.timers.has(projectDir))
+            return;
+        this.timers.set(projectDir, setTimeout(() => { void this.flush(projectDir); }, this.flushDelayMs));
+    }
+    async flush(projectDir) {
+        this.timers.delete(projectDir);
+        const lines = this.queues.get(projectDir) || [];
+        this.queues.delete(projectDir);
+        if (lines.length === 0)
+            return;
+        const session = this.deps.getManagerSession(projectDir);
+        if (!session?.sessionId)
+            return;
+        const text = `[MAFW GOAL 里程碑]\n${lines.join('\n')}\n(系统通知)`;
+        try {
+            await this.deps.promptNoReply(session.sessionId, text);
+        }
+        catch (err) {
+            logger_1.log.warn(`[MilestonePush] push failed (fail-open): ${err.message}`);
+        }
+    }
+    dispose() {
+        for (const t of this.timers.values())
+            clearTimeout(t);
+        this.timers.clear();
+        this.queues.clear();
+    }
+}
+exports.MilestonePushNotifier = MilestonePushNotifier;
+function formatMilestoneLine(goalId, title, phase, verdict) {
+    const v = verdict ? ` verdict=${verdict}` : '';
+    return `- ${goalId} (${title}): ${phase}${v}`;
+}

package/gateway/dist/core/manager/question-ledger.js

@@ -0,0 +1,121 @@
+"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.QuestionLedger = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class QuestionLedger {
+    ledgerPath;
+    constructor(mafwDir) {
+        this.ledgerPath = path.join(mafwDir, 'question-ledger.jsonl');
+    }
+    appendQuestionEvent(event) {
+        const dir = path.dirname(this.ledgerPath);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        fs.appendFileSync(this.ledgerPath, JSON.stringify(event) + '\n', 'utf-8');
+    }
+    getQuestionState(questionId) {
+        if (!fs.existsSync(this.ledgerPath))
+            return null;
+        const lines = fs.readFileSync(this.ledgerPath, 'utf-8').trim().split('\n');
+        let lastEvent = null;
+        for (const line of lines) {
+            try {
+                const evt = JSON.parse(line);
+                if (evt.questionId === questionId)
+                    lastEvent = evt;
+            }
+            catch { }
+        }
+        if (!lastEvent)
+            return null;
+        switch (lastEvent.type) {
+            case 'asked': return 'pending';
+            case 'answered': return 'answered';
+            case 'cancelled': return 'cancelled';
+            case 'orphaned': return 'orphaned';
+            default: return null;
+        }
+    }
+    listPendingQuestions(goalId) {
+        if (!fs.existsSync(this.ledgerPath))
+            return [];
+        const events = [];
+        const lines = fs.readFileSync(this.ledgerPath, 'utf-8').trim().split('\n');
+        for (const line of lines) {
+            try {
+                events.push(JSON.parse(line));
+            }
+            catch { }
+        }
+        const lastByQid = new Map();
+        for (const evt of events) {
+            lastByQid.set(evt.questionId, evt);
+        }
+        const pending = [];
+        for (const [, last] of lastByQid) {
+            if (last.type === 'asked') {
+                if (goalId && last.goalId !== goalId)
+                    continue;
+                pending.push({
+                    questionId: last.questionId,
+                    goalId: last.goalId,
+                    node: last.node || 'plan',
+                    loop: last.loop || 0,
+                    questions: last.questions || [],
+                    askedAt: last.askedAt || '',
+                    state: 'pending',
+                });
+            }
+        }
+        return pending;
+    }
+    bootReconcile(activeCheckpoints) {
+        const pending = this.listPendingQuestions();
+        for (const q of pending) {
+            if (!activeCheckpoints.has(q.goalId)) {
+                this.appendQuestionEvent({
+                    type: 'orphaned',
+                    questionId: q.questionId,
+                    goalId: q.goalId,
+                    orphanedAt: new Date().toISOString(),
+                    reason: 'checkpoint not found during boot reconcile',
+                });
+            }
+        }
+    }
+}
+exports.QuestionLedger = QuestionLedger;

package/gateway/dist/core/manager/system-rule-templates.js

@@ -0,0 +1,76 @@
+"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.RETIRED_RULE_IDS = exports.MANAGER_RULE_TEMPLATES = void 0;
+exports.ensureManagerRules = ensureManagerRules;
+const logger_1 = require("../utils/logger");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// Manager milestone notifications moved to MilestonePushNotifier
+// (core/manager/milestone-push.ts) — the cron/event wake rules were dead code
+// (legacy manager-session.json path, un-emitted events, unwritten reportedAt).
+exports.MANAGER_RULE_TEMPLATES = {};
+exports.RETIRED_RULE_IDS = ['manager-report-completed', 'manager-report-failed', 'manager-report-question'];
+function ensureManagerRules(mafwDir) {
+    const autoDir = path.join(mafwDir, 'automations');
+    if (!fs.existsSync(autoDir)) {
+        fs.mkdirSync(autoDir, { recursive: true });
+    }
+    for (const id of exports.RETIRED_RULE_IDS) {
+        const rulePath = path.join(autoDir, `${id}.json`);
+        if (fs.existsSync(rulePath)) {
+            fs.rmSync(rulePath);
+            logger_1.log.info(`[Scheduler] Retired dead rule: ${id}`);
+        }
+    }
+    for (const [id, template] of Object.entries(exports.MANAGER_RULE_TEMPLATES)) {
+        const rulePath = path.join(autoDir, `${id}.json`);
+        if (!fs.existsSync(rulePath)) {
+            fs.writeFileSync(rulePath, JSON.stringify(template, null, 2), 'utf-8');
+            logger_1.log.info(`[Scheduler] Created system rule: ${id}`);
+        }
+        else {
+            try {
+                const existing = JSON.parse(fs.readFileSync(rulePath, 'utf-8'));
+                if (existing.enabled !== template.enabled) {
+                    logger_1.log.info(`[Scheduler] Rule ${id} exists with user override (enabled: ${existing.enabled}) —keeping user value`);
+                }
+            }
+            catch {
+                fs.writeFileSync(rulePath, JSON.stringify(template, null, 2), 'utf-8');
+            }
+        }
+    }
+}