@jack200714/mafw 4.5.1

package/dist/hooks/memory-guide.js

@@ -0,0 +1,47 @@
+"use strict";
+// OptMem-style memory guide: injected into the system prompt (every turn) so
+// the agent actively operates the harmonic memory system instead of relying on
+// passive recall injection alone. Modeled on OptMem's `## Memory` block
+// (https://github.com/VictorTaelin/OptMem): mandatory write-on-learning,
+// search-when-unsure, and subagents never touch memory tools.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMemoryGuide = buildMemoryGuide;
+exports.memoryGuideHook = memoryGuideHook;
+const GUIDE_HEADER = `<memory-guide>`;
+const GUIDE_FOOTER = `</memory-guide>`;
+const GUIDE_BODY = `## 记忆
+
+你的长期记忆由 MAFW 谐波记忆系统管理，跨会话、压缩与模型更替存续。
+不主动记录，你将无法记得过去的决定、偏好与教训。
+
+### 工作中：主动写入（必做）
+- 学到新知识、用户明确陈述的偏好与约束、完成的重要工作、踩过的坑
+  → 调用 mafw_add_memory（按内容选择 semantic / episodic / procedural，附 cueAnchors 关键词，每条一句话）
+- 不写冗余记忆
+
+### 需要旧记忆：主动检索与取回
+- 新任务开始、或不确定此事是否已知 → 调用 mafw_search_hybrid 检索
+- <recall> 指针（#mem-xxxxxx）要依据其内容行动前 → 调用 mafw_get_memory(id 用 #mem- 后 6 位) 取全文
+
+### 披露层（pinned）
+- 用户身份/画像、长期偏好与约束 → mafw_add_memory 时 pinned: true（每轮保证注入）；任务相关、易变内容不要 pin
+- 偏好/事实变了 → 新写一条并带 supersedes: 旧id（旧版自动失效，历史保留）
+- 需要 pin/unpin 已有记忆 → mafw_pin_memory
+
+### 便签板（sticky）
+- 用户说"记下来 / 记住 / 别忘了" → mafw_add_memory 时带 sticky: true（默认 7 天，stickyDays 可调）
+  → 便签板上每轮必见，到期自动下架（记忆本体保留可检索）
+- 事已办完 → mafw_pin_memory { id, sticky: false } 下架；需要延期 → sticky: true + stickyDays 续期
+
+### 子代理
+子代理不得调用 mafw_add_memory / mafw_search_hybrid（防止重复写入），由父会话统一管理`;
+function buildMemoryGuide() {
+    return `${GUIDE_HEADER}\n${GUIDE_BODY}\n${GUIDE_FOOTER}`;
+}
+function memoryGuideHook(input, output) {
+    if (!output.system)
+        output.system = [];
+    output.system.push(buildMemoryGuide());
+    return output;
+}
+//# sourceMappingURL=memory-guide.js.map

package/dist/hooks/memory-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-guide.js","sourceRoot":"","sources":["../../src/hooks/memory-guide.ts"],"names":[],"mappings":";AAAA,6EAA6E;AAC7E,+EAA+E;AAC/E,wEAAwE;AACxE,yEAAyE;AACzE,8DAA8D;;AAgC9D,4CAEC;AAED,0CAIC;AAtCD,MAAM,YAAY,GAAG,gBAAgB,CAAA;AACrC,MAAM,YAAY,GAAG,iBAAiB,CAAA;AAEtC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;8DAyB2C,CAAA;AAE9D,SAAgB,gBAAgB;IAC9B,OAAO,GAAG,YAAY,KAAK,UAAU,KAAK,YAAY,EAAE,CAAA;AAC1D,CAAC;AAED,SAAgB,eAAe,CAAC,KAAU,EAAE,MAAW;IACrD,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,CAAC,MAAM,GAAG,EAAE,CAAA;IACtC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAA;IACtC,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/hooks/observation-capture.d.ts

@@ -0,0 +1,17 @@
+export interface Observation {
+    type: 'observation';
+    tool: string;
+    args: string;
+    output: string;
+    timestamp: string;
+    summary: string;
+}
+export interface CaptureResult {
+    observation?: Observation;
+}
+export declare function captureObservation(ctx: {
+    toolName: string;
+    output: string;
+    args?: string;
+}): Promise<CaptureResult>;
+//# sourceMappingURL=observation-capture.d.ts.map

package/dist/hooks/observation-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-capture.d.ts","sourceRoot":"","sources":["../../src/hooks/observation-capture.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,aAAa,CAAC,CAiBzB"}

package/dist/hooks/observation-capture.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.captureObservation = captureObservation;
+async function captureObservation(ctx) {
+    const outputLength = ctx.output?.length || 0;
+    const summary = outputLength > 200
+        ? ctx.output.substring(0, 100) + '...' + ctx.output.substring(outputLength - 100)
+        : ctx.output;
+    return {
+        observation: {
+            type: 'observation',
+            tool: ctx.toolName,
+            args: ctx.args || '',
+            output: ctx.output || '',
+            timestamp: new Date().toISOString(),
+            summary
+        }
+    };
+}
+//# sourceMappingURL=observation-capture.js.map

package/dist/hooks/observation-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-capture.js","sourceRoot":"","sources":["../../src/hooks/observation-capture.ts"],"names":[],"mappings":";;AAaA,gDAqBC;AArBM,KAAK,UAAU,kBAAkB,CAAC,GAIxC;IACC,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,YAAY,GAAG,GAAG;QAChC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,GAAG,GAAG,CAAC;QACjF,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;IAGf,OAAO;QACL,WAAW,EAAE;YACX,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,GAAG,CAAC,QAAQ;YAClB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;YACpB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;YACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO;SACR;KACF,CAAC;AACJ,CAAC"}

package/dist/hooks/session-compacting.d.ts

@@ -0,0 +1,6 @@
+export interface SessionCompactingContext {
+    sessionID: string;
+    projectDir?: string;
+}
+export declare function sessionCompactingHook(ctx: SessionCompactingContext): Promise<void>;
+//# sourceMappingURL=session-compacting.d.ts.map

package/dist/hooks/session-compacting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-compacting.d.ts","sourceRoot":"","sources":["../../src/hooks/session-compacting.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CACxF"}

package/dist/hooks/session-compacting.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionCompactingHook = sessionCompactingHook;
+async function sessionCompactingHook(ctx) {
+}
+//# sourceMappingURL=session-compacting.js.map

package/dist/hooks/session-compacting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-compacting.js","sourceRoot":"","sources":["../../src/hooks/session-compacting.ts"],"names":[],"mappings":";;AAKA,sDACC;AADM,KAAK,UAAU,qBAAqB,CAAC,GAA6B;AACzE,CAAC"}

package/dist/hooks/session-ending.d.ts

@@ -0,0 +1,20 @@
+/**
+ * session-ending Hook — 异常兜底
+ *
+ * 职责：
+ *   1. Session 正常结束时遍历 state 文件反查 sessionId
+ *   2. 检查 state 是否已更新（nextAction !== WAIT_PHASE_COMPLETE）
+ *   3. 如果 Skill Entry 因为异常没来得及更新 state，写入异常状态
+ *   4. Scheduler 下一轮 poll 会读取新 nextAction，重建 Session
+ *
+ * 设计原则：
+ *   - 只兜底，不承载主路径状态更新
+ *   - 遍历所有 state 文件，不假设 sessionId 格式包含 goalId
+ *   - 如果 state 已正常更新，无操作
+ */
+export interface HookContext {
+    sessionId: string;
+    projectDir?: string;
+}
+export declare function sessionEndingHook(hookContext: HookContext): Promise<void>;
+//# sourceMappingURL=session-ending.d.ts.map

package/dist/hooks/session-ending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-ending.d.ts","sourceRoot":"","sources":["../../src/hooks/session-ending.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsF/E"}

package/dist/hooks/session-ending.js

@@ -0,0 +1,113 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionEndingHook = sessionEndingHook;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const state_1 = require("../utils/state");
+async function sessionEndingHook(hookContext) {
+    const sessionId = hookContext.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) {
+                console.log(`[mafw:pre-compact] Preserving ${highEnergyCount} high-energy memories`);
+            }
+        }
+    }
+    catch { /* ignore parametric errors */ }
+    // 1. 遍历所有 state 文件，找到包含该 sessionId 的 goal
+    if (!fs.existsSync(stateDir)) {
+        console.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) {
+            console.warn(`[hook:session-ending] Failed to parse ${file}: ${err.message}`);
+        }
+    }
+    if (!targetGoalId) {
+        console.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') {
+            console.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) {
+        console.error(`[hook:session-ending] Failed to load state for ${targetGoalId}: ${err.message}`);
+    }
+}
+//# sourceMappingURL=session-ending.js.map

package/dist/hooks/session-ending.js.map

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

package/dist/hooks/session-recall.d.ts

@@ -0,0 +1,2 @@
+export declare function sessionRecallHook(input: any, output: any): Promise<any>;
+//# sourceMappingURL=session-recall.d.ts.map

package/dist/hooks/session-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-recall.d.ts","sourceRoot":"","sources":["../../src/hooks/session-recall.ts"],"names":[],"mappings":"AAoEA,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAiC7E"}

package/dist/hooks/session-recall.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionRecallHook = sessionRecallHook;
+const ttl_map_1 = require("../utils/ttl-map");
+const GATEWAY_PORT = process.env.MAFW_SERVER_API_PORT || process.env.MAFW_GATEWAY_PORT || '3000';
+const RECALL_URL = `http://127.0.0.1:${GATEWAY_PORT}/api/recall/context`;
+// Per-session cursor: the ID of the last *real* message processed. Synthetic
+// `<recall>` parts injected by this hook are appended to a real user message's
+// parts (marked `synthetic:true`) and never advance the cursor. TTL releases
+// entries for ended/idle sessions.
+const cursorBySession = new ttl_map_1.TtlMap(24 * 60 * 60 * 1000);
+// Synthetic <recall> parts injected by this hook are appended to real user
+// messages' parts (marked `synthetic:true`). Real messages always carry
+// `info.id`; the <recall> text marker is kept for legacy detection.
+function isInjectedMessage(msg) {
+    if (!msg?.info?.id)
+        return true;
+    if (typeof msg?.content === 'string' && msg.content.trimStart().startsWith('<recall>'))
+        return true;
+    return false;
+}
+function extractText(msg) {
+    if (typeof msg?.content === 'string')
+        return msg.content;
+    if (msg?.parts) {
+        return msg.parts
+            .filter((p) => p.type === 'text' || p.type === 'tool')
+            .map((p) => p.text || p.content || p.input || p.output || JSON.stringify(p))
+            .join(' ');
+    }
+    return '';
+}
+// Incremental messages after the cursor. If the cursor ID is gone (history
+// edited/truncated), fall back to the last 8 real messages — never including
+// synthetic <recall> parts — so injected pointers are not re-processed.
+function getIncrementalMessages(messages, lastId) {
+    const real = messages.filter((m) => !isInjectedMessage(m));
+    if (!lastId)
+        return real;
+    const idx = real.findIndex((m) => m.info?.id === lastId);
+    if (idx === -1)
+        return real.slice(-8);
+    return real.slice(idx + 1);
+}
+function buildQuery(messages) {
+    return messages
+        .map((m) => extractText(m))
+        .join('\n')
+        .slice(0, 500);
+}
+async function fetchRecall(query, sessionID) {
+    if (!query.trim())
+        return { pointers: null };
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 100);
+        const res = await fetch(`${RECALL_URL}?sessionID=${encodeURIComponent(sessionID)}&query=${encodeURIComponent(query)}`, {
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        if (!res.ok)
+            return { pointers: null };
+        const body = await res.json();
+        return {
+            pointers: body?.pointers || null,
+        };
+    }
+    catch {
+        return { pointers: null };
+    }
+}
+async function sessionRecallHook(input, output) {
+    const messages = output?.messages || [];
+    if (messages.length === 0)
+        return output;
+    // The transform hook input is `{}` (no sessionID); recover it from the first
+    // real message's info so per-session cursors stay isolated.
+    const sessionID = input?.sessionID ||
+        messages.find((m) => m.info?.sessionID)?.info?.sessionID ||
+        '';
+    if (!sessionID)
+        return output;
+    const increment = getIncrementalMessages(messages, cursorBySession.get(sessionID));
+    const query = buildQuery(increment);
+    if (!query.trim())
+        return output;
+    const recall = await fetchRecall(query, sessionID);
+    // Advance cursor past the last real message (injected parts excluded).
+    const real = messages.filter((m) => !isInjectedMessage(m));
+    const lastReal = real[real.length - 1];
+    if (lastReal?.info?.id)
+        cursorBySession.set(sessionID, lastReal.info.id);
+    if (recall.pointers) {
+        // Inject into a real user message's parts (valid message shape — a bare
+        // `{ role, content }` push crashes toModelMessagesEffect's parts scan).
+        const lastUser = real.filter((m) => m.info?.role === 'user').pop();
+        if (lastUser && Array.isArray(lastUser.parts)) {
+            lastUser.parts.push({ type: 'text', text: recall.pointers, synthetic: true });
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=session-recall.js.map

package/dist/hooks/session-recall.js.map

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

package/dist/hooks/session-start.d.ts

@@ -0,0 +1,9 @@
+export interface SessionStartContext {
+    sessionId: string;
+    goalId?: string;
+    projectDir?: string;
+}
+export declare function sessionStartHook(ctx: SessionStartContext, options?: {
+    mafwDir?: string;
+}): Promise<void>;
+//# sourceMappingURL=session-start.d.ts.map

package/dist/hooks/session-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAc9G"}

package/dist/hooks/session-start.js

@@ -0,0 +1,42 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __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');
+        }
+    }
+}
+//# sourceMappingURL=session-start.js.map

package/dist/hooks/session-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AASA,4CAcC;AAvBD,uCAAyB;AACzB,2CAA6B;AAQtB,KAAK,UAAU,gBAAgB,CAAC,GAAwB,EAAE,OAA8B;IAC7F,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACnD,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAG5C,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/hooks/tool-before.d.ts

@@ -0,0 +1,10 @@
+export interface ToolBeforeContext {
+    tool: string;
+    sessionID: string;
+    callID?: string;
+    args?: any;
+}
+export declare function toolBeforeHook(ctx: ToolBeforeContext): Promise<{
+    args?: any;
+} | void>;
+//# sourceMappingURL=tool-before.d.ts.map

package/dist/hooks/tool-before.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-before.d.ts","sourceRoot":"","sources":["../../src/hooks/tool-before.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,GAAG,CAAA;CAAE,GAAG,IAAI,CAAC,CAC3F"}

package/dist/hooks/tool-before.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolBeforeHook = toolBeforeHook;
+async function toolBeforeHook(ctx) {
+}
+//# sourceMappingURL=tool-before.js.map

package/dist/hooks/tool-before.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-before.js","sourceRoot":"","sources":["../../src/hooks/tool-before.ts"],"names":[],"mappings":";;AAOA,wCACC;AADM,KAAK,UAAU,cAAc,CAAC,GAAsB;AAC3D,CAAC"}

package/dist/hooks/tool-executed.d.ts

@@ -0,0 +1,19 @@
+/**
+ * tool-executed Hook — 工具输出压缩
+ *
+ * 职责：
+ *   1. 工具输出过大时自动压缩
+ *   2. 触发 L1 压缩：Session Pruner
+ *   3. 只压缩，不修改业务逻辑
+ *
+ * 设计原则：
+ *   - 横切关注点，不承载业务逻辑
+ *   - 压缩阈值：1000 tokens
+ */
+export interface ToolExecutedHookContext {
+    toolName: string;
+    output: string;
+    projectDir?: string;
+}
+export declare function toolExecutedHook(hookContext: ToolExecutedHookContext): Promise<void>;
+//# sourceMappingURL=tool-executed.d.ts.map

package/dist/hooks/tool-executed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executed.d.ts","sourceRoot":"","sources":["../../src/hooks/tool-executed.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ1F"}

package/dist/hooks/tool-executed.js

@@ -0,0 +1,12 @@
+"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: '' });
+}
+//# sourceMappingURL=tool-executed.js.map

package/dist/hooks/tool-executed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executed.js","sourceRoot":"","sources":["../../src/hooks/tool-executed.ts"],"names":[],"mappings":";;AAqBA,4CAQC;AA7BD,+DAA2D;AAqBpD,KAAK,UAAU,gBAAgB,CAAC,WAAoC;IACzE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC;IAErD,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,yBAAyB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1H,CAAC;IAED,MAAM,IAAA,wCAAkB,EAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AAC3D,CAAC"}

package/dist/hooks/user-profile.d.ts

@@ -0,0 +1,2 @@
+export declare function userProfileSystemHook(_input: any, output: any): Promise<any>;
+//# sourceMappingURL=user-profile.d.ts.map

package/dist/hooks/user-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile.d.ts","sourceRoot":"","sources":["../../src/hooks/user-profile.ts"],"names":[],"mappings":"AAQA,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAgBlF"}

package/dist/hooks/user-profile.js

@@ -0,0 +1,30 @@
+"use strict";
+// Disclosure layer injection: fetches the pinned <user-profile> block from the
+// gateway and appends it to the system prompt (after <memory-guide>, so the
+// static prefix stays cacheable). Fail-open: any error/timeout means no block,
+// never an exception — LLM flow must not be blocked by memory injection.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userProfileSystemHook = userProfileSystemHook;
+const GATEWAY_PORT = process.env.MAFW_SERVER_API_PORT || process.env.MAFW_GATEWAY_PORT || '3000';
+const PINNED_URL = `http://127.0.0.1:${GATEWAY_PORT}/api/recall/pinned`;
+async function userProfileSystemHook(_input, output) {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 150);
+        const res = await fetch(PINNED_URL, { signal: controller.signal });
+        clearTimeout(timeout);
+        if (!res.ok)
+            return output;
+        const body = await res.json();
+        if (body?.profile) {
+            if (!output.system)
+                output.system = [];
+            output.system.push(body.profile);
+        }
+    }
+    catch {
+        // fail-open: gateway down / timeout → no disclosure block this turn
+    }
+    return output;
+}
+//# sourceMappingURL=user-profile.js.map

package/dist/hooks/user-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile.js","sourceRoot":"","sources":["../../src/hooks/user-profile.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,4EAA4E;AAC5E,+EAA+E;AAC/E,yEAAyE;;AAKzE,sDAgBC;AAnBD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,CAAA;AAChG,MAAM,UAAU,GAAG,oBAAoB,YAAY,oBAAoB,CAAA;AAEhE,KAAK,UAAU,qBAAqB,CAAC,MAAW,EAAE,MAAW;IAClE,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC,CAAA;QACzD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;QAClE,YAAY,CAAC,OAAO,CAAC,CAAA;QACrB,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,MAAM,CAAA;QAC1B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAS,CAAA;QACpC,IAAI,IAAI,EAAE,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,MAAM,CAAC,MAAM,GAAG,EAAE,CAAA;YACtC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAClC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;IACtE,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/hooks/user-prompt.d.ts

@@ -0,0 +1,9 @@
+export interface UserPromptContext {
+    sessionID: string;
+    messageID?: string;
+    agent?: string;
+    model?: string;
+    text?: string;
+}
+export declare function userPromptHook(ctx: UserPromptContext): Promise<void>;
+//# sourceMappingURL=user-prompt.d.ts.map

package/dist/hooks/user-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-prompt.d.ts","sourceRoot":"","sources":["../../src/hooks/user-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1E"}

package/dist/hooks/user-prompt.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userPromptHook = userPromptHook;
+async function userPromptHook(ctx) {
+    if (!ctx.text)
+        return;
+}
+//# sourceMappingURL=user-prompt.js.map

package/dist/hooks/user-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-prompt.js","sourceRoot":"","sources":["../../src/hooks/user-prompt.ts"],"names":[],"mappings":";;AAQA,wCAEC;AAFM,KAAK,UAAU,cAAc,CAAC,GAAsB;IACzD,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO;AACxB,CAAC"}

package/dist/hooks/voice-guide.d.ts

@@ -0,0 +1,8 @@
+export declare function buildVoiceGuide(): string;
+/** 判断 user 消息是否含音频媒体（media part mime audio/* 或音频指针/文件名）。 */
+export declare function messageHasAudio(msg: any): boolean;
+/** messages.transform：更新会话语音输入状态。 */
+export declare function voiceGuideMessagesHook(input: any, output: any): any;
+/** system.transform：语音输入会话注入引导块。 */
+export declare function voiceGuideSystemHook(input: any, output: any): any;
+//# sourceMappingURL=voice-guide.d.ts.map

package/dist/hooks/voice-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-guide.d.ts","sourceRoot":"","sources":["../../src/hooks/voice-guide.ts"],"names":[],"mappings":"AAoCA,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAajD;AAED,qCAAqC;AACrC,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,CAmBnE;AAED,oCAAoC;AACpC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,CAajE"}