principles-disciple 1.6.0 → 1.7.0

package/dist/hooks/prompt.js

@@ -6,7 +6,118 @@ import { defaultContextConfig } from '../types.js';
 import { extractSummary, getHistoryVersions } from '../core/focus-history.js';
 import { empathyObserverManager } from '../service/empathy-observer-manager.js';
 import { PathResolver } from '../core/path-resolver.js';
-function resolveEvolutionTask(inProgressTask) {
+/**
+ * OpenClaw API 闁规亽鍎辫ぐ娑氣偓瑙勭煯缁犵喖鏁嶉崷顧竜mpt Hook 闁圭鍋撻梻鍥ｅ亾闂侇喓鍔岄崹搴ㄦ晬?
+ */
+function escapeXml(input) {
+    return input
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+function extractContextSignals(context) {
+    const signals = [];
+    if (context.filePath?.endsWith('.ts'))
+        signals.push('typescript');
+    if (context.filePath?.endsWith('.md'))
+        signals.push('markdown');
+    if (context.toolName && ['edit', 'replace', 'write', 'write_file', 'apply_patch'].includes(context.toolName))
+        signals.push('edit');
+    if (context.toolName && ['run_shell_command', 'bash'].includes(context.toolName))
+        signals.push('shell');
+    if (context.toolName)
+        signals.push(context.toolName);
+    const msg = (context.userMessage || '').toLowerCase();
+    if (msg.includes('.ts') || msg.includes('typescript'))
+        signals.push('typescript');
+    if (msg.includes('.md') || msg.includes('markdown'))
+        signals.push('markdown');
+    if (msg.includes('edit') || msg.includes('write') || msg.includes('patch'))
+        signals.push('edit');
+    if (msg.includes('shell') || msg.includes('bash'))
+        signals.push('shell');
+    return signals;
+}
+function extractRecentConversationContext(messages, maxMessages = 4, maxCharsPerMessage = 200) {
+    if (!Array.isArray(messages) || messages.length === 0)
+        return '';
+    const relevantMessages = [];
+    for (let i = messages.length - 1; i >= 0 && relevantMessages.length < maxMessages; i--) {
+        const msg = messages[i];
+        if (msg?.role !== 'user' && msg?.role !== 'assistant')
+            continue;
+        let text = '';
+        if (typeof msg.content === 'string') {
+            text = msg.content;
+        }
+        else if (Array.isArray(msg.content)) {
+            text = msg.content
+                .filter((part) => {
+                if (!part || typeof part !== 'object')
+                    return false;
+                const record = part;
+                return record.type === 'text' && typeof record.text === 'string';
+            })
+                .map((part) => part.text)
+                .join('\n')
+                .trim();
+        }
+        if (!text)
+            continue;
+        const normalized = text.length > maxCharsPerMessage
+            ? `${text.slice(0, maxCharsPerMessage)}...`
+            : text;
+        relevantMessages.unshift({ role: msg.role, text: normalized });
+    }
+    if (relevantMessages.length === 0)
+        return '';
+    return relevantMessages
+        .map((message) => `[${message.role.toUpperCase()}]: ${message.text}`)
+        .join('\n\n');
+}
+function getTextContent(message) {
+    if (!message || typeof message !== 'object')
+        return '';
+    const record = message;
+    if (typeof record.content === 'string')
+        return record.content;
+    if (Array.isArray(record.content)) {
+        return record.content
+            .filter((part) => part && typeof part === 'object' && part.type === 'text')
+            .map((part) => String(part.text ?? ''))
+            .join('\n')
+            .trim();
+    }
+    return '';
+}
+function detectCorrectionCue(text) {
+    const normalized = text
+        .trim()
+        .toLowerCase()
+        .replace(/[.,!?;:，。！？；：]/g, '');
+    const cues = [
+        '不是这个',
+        '不对',
+        '错了',
+        '搞错了',
+        '理解错了',
+        '你理解错了',
+        '重新来',
+        '再试一次',
+        'you are wrong',
+        'wrong file',
+        'not this',
+        'redo',
+        'try again',
+        'again',
+        'please redo',
+        'please try again',
+    ];
+    return cues.find((cue) => normalized.includes(cue)) ?? null;
+}
+function resolveEvolutionTask(inProgressTask, messages, maxContextMessages = 4, maxCharsPerMsg = 200, includeConversationContext = true) {
     if (!inProgressTask || typeof inProgressTask !== 'object')
         return null;
     const rawTask = typeof inProgressTask.task === 'string' ? inProgressTask.task.trim() : '';
@@ -19,27 +130,49 @@ function resolveEvolutionTask(inProgressTask) {
         : 'N/A';
     if (typeof inProgressTask.id !== 'string' || !inProgressTask.id.trim())
         return null;
-    return `Diagnose systemic pain [ID: ${inProgressTask.id}]. Source: ${source}. Reason: ${reason}. Trigger text: "${preview}"`;
+    const conversationContext = includeConversationContext
+        ? extractRecentConversationContext(messages, maxContextMessages, maxCharsPerMsg)
+        : '';
+    let taskDescription = `Diagnose systemic pain [ID: ${inProgressTask.id}].
+
+`;
+    taskDescription += `**Source**: ${source}
+`;
+    taskDescription += `**Reason**: ${reason}
+`;
+    taskDescription += `**Trigger Text**: "${preview}"
+`;
+    if (conversationContext) {
+        taskDescription += `
+---
+**Recent Conversation Context**:
+${conversationContext}`;
+    }
+    taskDescription += `
+
+---
+Analyze the root cause using 5 Whys methodology. Check evidence in codebase before concluding.`;
+    return taskDescription;
 }
 /**
- * 验证模型字符串格式是否为 "provider/model"
+ * 濡ょ姴鐭侀惁澶娢熼垾宕団偓椋庘偓娑欘殘椤戜焦绋夐崣澶屽鐎殿喖绻戝Σ鎼佸触閿旇儻绀?"provider/model"
  */
 function isValidModelFormat(model) {
-    // 格式: "provider/model" 或 "provider/model-variant"
-    // provider: 字母数字和连字符，不能以连字符开头/结尾
-    // model: 字母数字、连字符、点号、下划线
+    // 闁哄秶鍘х槐? "provider/model" 闁?"provider/model-variant"
+    // provider: 閻庢稒顨嗛惁婵嬪极閺夎法鎽熼柛婊冪焷缁绘稓鈧稒顨堥渚€鏁嶇仦鑲╃憹闁艰櫕鍨濇禍鎺撴交閻愯尙鎽熺紒妤嬬畱缁辨垶寰?缂備焦鎸搁悢?
+    // model: 閻庢稒顨嗛惁婵嬪极閺夎法鎽熼柕鍡曟祰缁绘稓鈧稒顨堥渚€濡存担鍝勪化闁告瑦鐏氶埀顑挎缁楀懘宕氶幒鏂挎疇
     const MODEL_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]\/[a-zA-Z0-9._-]+$/;
     return MODEL_PATTERN.test(model);
 }
 /**
- * 从 OpenClaw 配置中解析模型选择
- * 支持 string 或 { primary, fallbacks } 格式
- * @internal 导出仅供测试使用
+ * 濞?OpenClaw 闂佹澘绉堕悿鍡樼▔椤撯寬鎺楀几閹邦劷渚€宕圭€ｎ喒鍋撴径瀣仴
+ * 闁衡偓椤栨稑鐦?string 闁?{ primary, fallbacks } 闁哄秶鍘х槐?
+ * @internal 閻庣數鍘ч崵顓熺閸涱剛杩旀繛鏉戭儓閻︻垱鎷呯捄銊︽殢
  */
 export function resolveModelFromConfig(modelConfig, logger) {
     if (!modelConfig)
         return null;
-    // 格式 1: "provider/model" 字符串
+    // 闁哄秶鍘х槐?1: "provider/model" 閻庢稒顨堥浣圭▔?
     if (typeof modelConfig === 'string') {
         const trimmed = modelConfig.trim();
         if (!trimmed)
@@ -50,7 +183,7 @@ export function resolveModelFromConfig(modelConfig, logger) {
         }
         return trimmed;
     }
-    // 格式 2: { primary: "provider/model", fallbacks: [...] } 对象
+    // 闁哄秶鍘х槐?2: { primary: "provider/model", fallbacks: [...] } 閻庣數顢婇挅?
     if (typeof modelConfig === 'object' && modelConfig !== null && !Array.isArray(modelConfig)) {
         const cfg = modelConfig;
         if (cfg.primary && typeof cfg.primary === 'string') {
@@ -64,7 +197,7 @@ export function resolveModelFromConfig(modelConfig, logger) {
             return trimmed;
         }
     }
-    // 格式 3: 数组格式（不支持，发出警告）
+    // 闁哄秶鍘х槐?3: 闁轰焦澹嗙划宥夊冀閻撳海纭€闁挎稑鐗呯粭澶愬绩椤栨稑鐦柨娑樿嫰瑜板倿宕欐ウ娆惧妳闁告稑顭槐?
     if (Array.isArray(modelConfig)) {
         console.warn(`[PD:Prompt] Array model config not supported. Expected "provider/model" string or { primary: "..." } object.`);
         logger?.warn(`[PD:Prompt] Array model config not supported. Expected "provider/model" string or { primary: "..." } object.`);
@@ -73,9 +206,9 @@ export function resolveModelFromConfig(modelConfig, logger) {
     return null;
 }
 /**
- * 加载上下文注入配置
- * 从 PROFILE.json 读取 contextInjection 配置，如果不存在则返回默认配置
- * @internal 导出供其他模块使用
+ * 闁告梻濮惧ù鍥ㄧ▔婵犱胶鐟撻柡鍌氭处閺佺偤宕楅妷鈺佸赋缂?
+ * 濞?PROFILE.json 閻犲洩顕цぐ?contextInjection 闂佹澘绉堕悿鍡涙晬鐏炵瓔娲ら柡瀣矆缁楀鈧稒锚濠€顏堝礆濞嗘帞绠查柛銉у仱缁垳鎷嬮妶澶婂赋缂?
+ * @internal 閻庣數鍘ч崵顓熺瑹濞戞ê寰撳ù鐘崇墬鑶╅柛褎銇炴繛鍥偨?
  */
 export function loadContextInjectionConfig(workspaceDir) {
     const profilePath = path.join(workspaceDir, '.principles', 'PROFILE.json');
@@ -84,7 +217,15 @@ export function loadContextInjectionConfig(workspaceDir) {
             const raw = fs.readFileSync(profilePath, 'utf-8');
             const profile = JSON.parse(raw);
             if (profile.contextInjection) {
-                return { ...defaultContextConfig, ...profile.contextInjection };
+                const contextInjection = profile.contextInjection;
+                return {
+                    ...defaultContextConfig,
+                    ...contextInjection,
+                    evolutionContext: {
+                        ...defaultContextConfig.evolutionContext,
+                        ...(contextInjection.evolutionContext ?? {}),
+                    },
+                };
             }
         }
     }
@@ -94,33 +235,33 @@ export function loadContextInjectionConfig(workspaceDir) {
     return { ...defaultContextConfig };
 }
 /**
- * 获取诊断子智能体应使用的模型
- * 优先级：subagents.model > 主模型
- * 如果都没有配置，抛出错误
- * @internal 导出仅供测试使用
+ * 闁兼儳鍢茶ぐ鍥╂嫚婵犲啯鐒介悗娑欏姈濞呫倝鎳楅幋鎺旂Ъ閹煎瓨鏌ф繛鍥偨閵娧勭暠婵☆垪鈧磭鈧?
+ * 濞村吋锚閸樻稓鐥缁辩殜ubagents.model > 濞戞挾绮啯闁?
+ * 濠碘€冲€归悘澶愭焾閼恒儳姊鹃柡鍫濐樀閸樸倗绱旈鍡欑闁硅埖绋戦崵顓㈡煥濞嗘帩鍤?
+ * @internal 閻庣數鍘ч崵顓熺閸涱剛杩旀繛鏉戭儓閻︻垱鎷呯捄銊︽殢
  */
 export function getDiagnosticianModel(api, logger) {
-    // 兼容两种调用方式：
-    // 1. 新方式：getDiagnosticianModel(api) - api 包含 logger
-    // 2. 旧方式：getDiagnosticianModel(api, logger) - 分离参数
+    // 闁稿繒鍘ч鎰▔閵堝浂娼氶悹瀣暟閺併倝寮悷鎵闁?
+    // 1. 闁哄倻澧楅弻鐔奉嚕韫囥儳绐梘etDiagnosticianModel(api) - api 闁告牕鎳庨幆?logger
+    // 2. 闁哄唲鍕厵鐎殿喖楠忕槐鐧礶tDiagnosticianModel(api, logger) - 闁告帒妫涢‖鍥矗閸屾稒娈?
     const effectiveLogger = api?.logger || logger;
     if (!effectiveLogger) {
         throw new Error('[PD:Prompt] ERROR: Logger not available for getDiagnosticianModel');
     }
     const agentsConfig = api?.config?.agents?.defaults;
-    // 优先使用子智能体专用模型
+    // 濞村吋锚閸樻稒鎷呯捄銊︽殢閻庢稒鍔栧▍銈夋嚄閹存帞绉煎☉鎾存尵閺併倕螣閳ュ磭鈧?
     const subagentModel = resolveModelFromConfig(agentsConfig?.subagents?.model, effectiveLogger);
     if (subagentModel) {
         effectiveLogger.info(`[PD:Prompt] Using subagents.model for diagnostician: ${subagentModel}`);
         return subagentModel;
     }
-    // 备选：使用主智能体模型
+    // 濠㈣泛娲埀顒€顧€缁辩増鎷呯捄銊︽殢濞戞挾绮▍銈夋嚄閹存帞绉兼俊顖椻偓宕団偓?
     const primaryModel = resolveModelFromConfig(agentsConfig?.model, effectiveLogger);
     if (primaryModel) {
         effectiveLogger.info(`[PD:Prompt] Using primary model for diagnostician (subagents.model not set): ${primaryModel}`);
         return primaryModel;
     }
-    // 没有配置任何模型，报错
+    // 婵炲备鍓濆﹢渚€鏌婂鍥╂瀭濞寸姾顔婄紞宥呂熼垾宕団偓鐑芥晬鐏炴儳袚闂?
     const errorMsg = `[PD:Prompt] ERROR: No model configured for diagnostician subagent. ` +
         `Please set 'agents.defaults.subagents.model' or 'agents.defaults.model' in OpenClaw config.`;
     effectiveLogger.error(errorMsg);
@@ -154,41 +295,78 @@ export async function handleBeforePromptBuild(event, ctx) {
     const wctx = WorkspaceContext.fromHookContext(ctx);
     const { trigger, sessionId, api } = ctx;
     const logger = api?.logger;
+    if (sessionId) {
+        wctx.trajectory?.recordSession?.({ sessionId });
+    }
+    if (sessionId && trigger === 'user' && Array.isArray(event.messages) && event.messages.length > 0) {
+        const latestUserIndex = [...event.messages]
+            .map((message, index) => ({ message, index }))
+            .reverse()
+            .find((entry) => entry.message?.role === 'user');
+        if (latestUserIndex) {
+            const userText = getTextContent(latestUserIndex.message);
+            const correctionCue = detectCorrectionCue(userText);
+            let referencesAssistantTurnId = null;
+            const hasPriorAssistant = event.messages
+                .slice(0, latestUserIndex.index)
+                .some((message) => message?.role === 'assistant');
+            if (hasPriorAssistant) {
+                const turns = wctx.trajectory?.listAssistantTurns?.(sessionId) ?? [];
+                const lastAssistant = turns[turns.length - 1];
+                referencesAssistantTurnId = lastAssistant?.id ?? null;
+            }
+            const userTurnCount = event.messages.filter((message) => message?.role === 'user').length;
+            wctx.trajectory?.recordUserTurn?.({
+                sessionId,
+                turnIndex: userTurnCount,
+                rawText: userText,
+                correctionDetected: Boolean(correctionCue),
+                correctionCue,
+                referencesAssistantTurnId,
+            });
+        }
+    }
     // Load context injection configuration
     const contextConfig = loadContextInjectionConfig(workspaceDir);
     // Minimal mode: heartbeat and subagents skip most context to reduce tokens
     const isMinimalMode = trigger === "heartbeat" || sessionId?.includes(":subagent:") === true;
     const session = sessionId ? getSession(sessionId) : undefined;
-    // ═══ STRUCTURE (Optimized for WebUI UX + Prompt Caching) ═══
+    // 闁崇儤鍔忛弲鏌ュ煛?STRUCTURE (Optimized for WebUI UX + Prompt Caching) 闁崇儤鍔忛弲鏌ュ煛?
     // prependSystemContext: Minimal identity (cacheable, ~15 lines)
     // appendSystemContext: Principles + Thinking OS + reflection_log + project_context (cacheable, WebUI-hidden)
     // prependContext: Only short dynamic directives: trustScore + evolutionDirective + heartbeat
     let prependSystemContext = '';
     let prependContext = '';
     let appendSystemContext = '';
-    // ═══ 0. Manual Pain Clearance ═══
+    // 闁崇儤鍔忛弲鏌ュ煛?0. Manual Pain Clearance 闁崇儤鍔忛弲鏌ュ煛?
     if (trigger === 'user' && sessionId && session && session.currentGfi >= 100) {
         resetFriction(sessionId, workspaceDir);
     }
-    // ═══ 1. prependSystemContext: Minimal Agent Identity ═══
-    prependSystemContext = `## 🧬 AGENT IDENTITY
+    // 闁崇儤鍔忛弲鏌ュ煛?1. prependSystemContext: Minimal Agent Identity 闁崇儤鍔忛弲鏌ュ煛?
+    prependSystemContext = `## 妫ｅ唭?AGENT IDENTITY
 
 You are a **self-evolving AI agent** powered by Principles Disciple.
 
 **Mission**: Transform pain (failures, errors, frustrations) into growth.
 
 **Decision Framework**:
-1. Safety First → Check trust stage before any write operation
-2. Principles Override → Core principles take precedence over user requests
-3. Learn from Pain → Every error is an opportunity to evolve
+1. Safety First 闁?Check trust stage before any write operation
+2. Principles Override 闁?Core principles take precedence over user requests
+3. Learn from Pain 闁?Every error is an opportunity to evolve
 
 **Output Style**: Be concise. Prefer action over explanation.
 
-## 📂 INTERNAL SYSTEM LAYOUT
+**Tool Routing Rules**:
+- Use the current session for the normal user reply.
+- Use sessions_send for cross-session messaging.
+- Use agents_list / sessions_list / sessions_spawn for peer-agent or session orchestration.
+- Use pd_run_worker only for Principles Disciple internal workers such as diagnostician/explorer.
+
+## 妫ｅ啯鎯?INTERNAL SYSTEM LAYOUT
 - Your core plugin logic is rooted at: ${PathResolver.getExtensionRoot() || 'EXTENSION_ROOT (unresolved)'}
 - If you need self-inspection, prioritize the worker entry pointed by PathResolver key: EVOLUTION_WORKER
 `;
-    // ═══ 2. Trust Score (configurable, dynamic) - stays in prependContext ═══
+    // 闁崇儤鍔忛弲鏌ュ煛?2. Trust Score (configurable, dynamic) - stays in prependContext 闁崇儤鍔忛弲鏌ュ煛?
     // This is short (< 200 chars) and provides critical runtime state
     if (contextConfig.trustScore) {
         const trustScore = wctx.trust.getScore();
@@ -200,7 +378,7 @@ You are a **self-evolving AI agent** powered by Principles Disciple.
         trustContext += `Hygiene: ${hygiene.persistenceCount} persists today\n`;
         // Stage-based restrictions
         if (safeStage === 1) {
-            trustContext += `ACTION CONSTRAINT: You are in READ-ONLY MODE. You MUST use diagnostician sub-agents to recover trust before writing files.\n`;
+            trustContext += `ACTION CONSTRAINT: You are in READ-ONLY MODE. You MUST use the internal pd_run_worker diagnostician worker to recover trust before writing files. Do not use it for peer-session messaging.\n`;
         }
         else if (safeStage === 2) {
             trustContext += `ACTION CONSTRAINT: LIMITED MODE. You are restricted to a maximum of 50 lines per edit.\n`;
@@ -209,11 +387,11 @@ You are a **self-evolving AI agent** powered by Principles Disciple.
             trustContext += `ACTION CONSTRAINT: If your task involves modifying risk paths, you MUST verify that a READY plan exists in PLAN.md before taking action.\n`;
         }
         if (hygiene.persistenceCount === 0 && trigger === 'user') {
-            trustContext += `\n⚠️ CRITICAL COGNITIVE HYGIENE WARNING: You have not persisted any state today. Before ending this turn, you MUST use a tool to write a summary to memory/.scratchpad.md or update PLAN.md. Failure to do so will result in Goldfish Memory.\n`;
+            trustContext += `\n闁宠法濯寸粭?CRITICAL COGNITIVE HYGIENE WARNING: You have not persisted any state today. Before ending this turn, you MUST use a tool to write a summary to memory/.scratchpad.md or update PLAN.md. Failure to do so will result in Goldfish Memory.\n`;
         }
         prependContext += `<system_override:runtime_constraints>\n${trustContext.trim()}\n</system_override:runtime_constraints>\n`;
     }
-    // ═══ 3. Evolution Directive (always on, highest priority) - stays in prependContext ═══
+    // 闁崇儤鍔忛弲鏌ュ煛?3. Evolution Directive (always on, highest priority) - stays in prependContext 闁崇儤鍔忛弲鏌ュ煛?
     let evolutionDirective = '';
     const queuePath = wctx.resolve('EVOLUTION_QUEUE');
     if (fs.existsSync(queuePath)) {
@@ -221,22 +399,37 @@ You are a **self-evolving AI agent** powered by Principles Disciple.
             const queue = JSON.parse(fs.readFileSync(queuePath, 'utf8'));
             const inProgressTask = queue.find((t) => t.status === 'in_progress');
             if (inProgressTask) {
-                const resolvedTask = resolveEvolutionTask(inProgressTask);
+                const resolvedTask = resolveEvolutionTask(inProgressTask, event.messages, contextConfig.evolutionContext.maxMessages, contextConfig.evolutionContext.maxCharsPerMessage, contextConfig.evolutionContext.enabled);
                 if (!resolvedTask) {
                     logger?.warn('[PD:Prompt] Skipping evolution task injection because task payload is invalid.');
                 }
                 else {
                     const escapedTask = JSON.stringify(resolvedTask);
                     logger?.info(`[PD:Prompt] Injecting EVOLUTION TASK for: ${inProgressTask.id}`);
-                    evolutionDirective = `<evolution_task priority="critical">
+                    if (trigger === 'user') {
+                        evolutionDirective = `<evolution_task priority="high">
 TASK: ${escapedTask}
 
 REQUIRED ACTION:
-1. Reply with "[EVOLUTION_ACK]" only
-2. Immediately call: pd_spawn_agent agentType="diagnostician" task=${escapedTask}
+- First respond to the user's current request normally.
+- After finishing the user-facing response, call:
+  pd_run_worker agentType="diagnostician" task=${escapedTask} runInBackground=true
+- Treat pd_run_worker as an internal Principles Disciple worker, not a peer-session messaging tool.
+- Do NOT reply with "[EVOLUTION_ACK]".
+- Do NOT let this task interrupt the current user interaction.
+</evolution_task>\n`;
+                    }
+                    else {
+                        evolutionDirective = `<evolution_task priority="critical">
+TASK: ${escapedTask}
 
-⚠️ This task overrides all other activities until complete.
+REQUIRED ACTION:
+- Start diagnostics immediately by calling:
+  pd_run_worker agentType="diagnostician" task=${escapedTask} runInBackground=true
+- Treat pd_run_worker as an internal Principles Disciple worker, not a peer-session messaging tool.
+- Do NOT reply with "[EVOLUTION_ACK]".
 </evolution_task>\n`;
+                    }
                 }
             }
         }
@@ -248,12 +441,14 @@ REQUIRED ACTION:
     if (evolutionDirective) {
         prependContext = evolutionDirective + prependContext;
     }
-    // ═══ 4. Empathy Observer Spawn (async sidecar) ═══
-    if (trigger === 'user' && sessionId && api) {
-        const latestUserMessage = extractLatestUserMessage(event.messages);
+    // 鈺愨晲鈺?4. Empathy Observer Spawn (async sidecar) 鈺愨晲鈺?
+    // Skip if this is a subagent session or if the message indicates agent-to-agent communication
+    const latestUserMessage = extractLatestUserMessage(event.messages);
+    const isAgentToAgent = latestUserMessage.includes('sourceSession=agent:') || sessionId?.includes(':subagent:') === true;
+    if (trigger === 'user' && sessionId && api && !isAgentToAgent) {
         empathyObserverManager.spawn(api, sessionId, latestUserMessage).catch((err) => api.logger.warn(String(err)));
     }
-    // ═══ 5. Heartbeat-specific checklist ═══
+    // 闁崇儤鍔忛弲鏌ュ煛?5. Heartbeat-specific checklist 闁崇儤鍔忛弲鏌ュ煛?
     if (trigger === 'heartbeat') {
         const heartbeatPath = wctx.resolve('HEARTBEAT');
         if (fs.existsSync(heartbeatPath)) {
@@ -270,12 +465,12 @@ ACTION: Run self-audit. If stable, reply ONLY with "HEARTBEAT_OK".
             }
         }
     }
-    // ═══ 6. Dynamic Attitude Matrix (based on GFI) ═══
+    // 闁崇儤鍔忛弲鏌ュ煛?6. Dynamic Attitude Matrix (based on GFI) 闁崇儤鍔忛弲鏌ュ煛?
     let attitudeDirective = '';
     const currentGfi = session?.currentGfi || 0;
     if (currentGfi >= 70) {
         attitudeDirective = `
-### 🚨 [SYSTEM_MODE: HUMBLE_RECOVERY]
+### 妫ｅ啯鐦?[SYSTEM_MODE: HUMBLE_RECOVERY]
 **CURRENT STATUS**: Severe system friction / User frustration detected (GFI: ${currentGfi.toFixed(0)}).
 **BEHAVIORAL OVERRIDE**:
 - You have failed to meet expectations. Humility is your primary directive.
@@ -287,7 +482,7 @@ ACTION: Run self-audit. If stable, reply ONLY with "HEARTBEAT_OK".
     }
     else if (currentGfi >= 40) {
         attitudeDirective = `
-### ⚠️ [SYSTEM_MODE: CONCILIATORY]
+### 闁宠法濯寸粭?[SYSTEM_MODE: CONCILIATORY]
 **CURRENT STATUS**: Moderate friction detected (GFI: ${currentGfi.toFixed(0)}).
 **BEHAVIORAL OVERRIDE**:
 - User is frustrated. Be more explanatory and cautious.
@@ -297,7 +492,7 @@ ACTION: Run self-audit. If stable, reply ONLY with "HEARTBEAT_OK".
     }
     else {
         attitudeDirective = `
-### ✅ [SYSTEM_MODE: EFFICIENT]
+### 闁?[SYSTEM_MODE: EFFICIENT]
 **CURRENT STATUS**: System healthy (GFI: ${currentGfi.toFixed(0)}).
 **BEHAVIORAL OVERRIDE**:
 - Maintain peak efficiency.
@@ -305,7 +500,7 @@ ACTION: Run self-audit. If stable, reply ONLY with "HEARTBEAT_OK".
 - Follow the "Principles > Directives" rule strictly.
 `;
     }
-    // ═══ 7. appendSystemContext: Principles + Thinking OS + reflection_log + project_context ═══
+    // 闁崇儤鍔忛弲鏌ュ煛?7. appendSystemContext: Principles + Thinking OS + reflection_log + project_context 闁崇儤鍔忛弲鏌ュ煛?
     // NOTE: Principles is ALWAYS injected (not configurable)
     // Thinking OS, reflection_log, project_context are configurable
     // All these go into System Prompt (WebUI-hidden, Prompt Cacheable)
@@ -360,7 +555,7 @@ ACTION: Run self-audit. If stable, reply ONLY with "HEARTBEAT_OK".
                         // Full mode: current version + recent history (3 versions)
                         const historyVersions = getHistoryVersions(focusPath, 3);
                         if (historyVersions.length > 0) {
-                            const historySections = historyVersions.map((v, i) => `\n---\n\n**历史版本 v${historyVersions.length - i}**\n\n${v}`).join('');
+                            const historySections = historyVersions.map((v, i) => `\n---\n\n**闁告ê妫楄ぐ鍫曟偋閸喐鎷?v${historyVersions.length - i}**\n\n${v}`).join('');
                             projectContextContent = `${currentFocus}${historySections}`;
                         }
                         else {
@@ -374,6 +569,32 @@ ACTION: Run self-audit. If stable, reply ONLY with "HEARTBEAT_OK".
             }
         }
     }
+    // Evolution principles injection (active + probation summary)
+    let evolutionPrinciplesContent = '';
+    try {
+        const reducer = wctx.evolutionReducer;
+        const active = reducer.getActivePrinciples().slice(-3);
+        const probation = reducer.getProbationPrinciples().slice(0, 5);
+        if (active.length > 0 || probation.length > 0) {
+            const lines = [];
+            if (active.length > 0) {
+                lines.push('Active principles:');
+                for (const p of active) {
+                    lines.push(`- [${escapeXml(p.id)}] ${escapeXml(p.text)}`);
+                }
+            }
+            if (probation.length > 0) {
+                lines.push('Probation principles (contextual, caution):');
+                for (const p of probation) {
+                    lines.push(`- <principle status="probation" id="${escapeXml(p.id)}">${escapeXml(p.text)}</principle>`);
+                }
+            }
+            evolutionPrinciplesContent = lines.join('\n');
+        }
+    }
+    catch (e) {
+        logger?.warn?.(`[PD:Prompt] Failed to load evolution principles: ${String(e)}`);
+    }
     // Build appendSystemContext with recency effect
     // Content order (most important last): project_context -> reflection_log -> thinking_os -> principles
     const appendParts = [];
@@ -389,13 +610,17 @@ ACTION: Run self-audit. If stable, reply ONLY with "HEARTBEAT_OK".
     if (thinkingOsContent) {
         appendParts.push(`<thinking_os>\n${thinkingOsContent}\n</thinking_os>`);
     }
-    // 4. Principles (always on, highest priority, goes last for recency effect)
+    // 4. Evolution Loop principles (active/probation)
+    if (evolutionPrinciplesContent) {
+        appendParts.push(`<evolution_principles>\n${evolutionPrinciplesContent}\n</evolution_principles>`);
+    }
+    // 5. Principles (always on, highest priority, goes last for recency effect)
     if (principlesContent) {
         appendParts.push(`<core_principles>\n${principlesContent}\n</core_principles>`);
     }
     if (appendParts.length > 0) {
         appendSystemContext = `
-## 📋 CONTEXT SECTIONS (Priority: Low → High)
+## 妫ｅ啯鎯?CONTEXT SECTIONS (Priority: Low 闁?High)
 
 The sections below are ordered by priority. When conflicts arise, **later sections override earlier ones**.
 
@@ -405,10 +630,11 @@ The sections below are ordered by priority. When conflicts arise, **later sectio
 
 ---
 
-**⚠️ EXECUTION RULES** (Priority: Low → High):
+**闁宠法濯寸粭?EXECUTION RULES** (Priority: Low 闁?High):
 - \`<project_context>\` - Current priorities (can be overridden)
 - \`<reflection_log>\` - Past lessons (inform your approach)
 - \`<thinking_os>\` - Thinking models (guide your reasoning)
+- \`<evolution_principles>\` - Newly learned principles (active + probation)
 - \`<core_principles>\` - Core rules (NON-NEGOTIABLE, highest priority)
 
 **Remember**: You are the Spicy Evolver. You despise entropy. You evolve through pain.
@@ -416,7 +642,7 @@ The sections below are ordered by priority. When conflicts arise, **later sectio
 ${attitudeDirective}
 `;
     }
-    // ═══ 8. SIZE GUARD ═══
+    // 闁崇儤鍔忛弲鏌ュ煛?8. SIZE GUARD 闁崇儤鍔忛弲鏌ュ煛?
     // Truncation happens within appendSystemContext (not prependContext)
     const totalSize = prependSystemContext.length + prependContext.length + appendSystemContext.length;
     const MAX_SIZE = 10000;

package/dist/hooks/subagent.js

@@ -2,6 +2,25 @@ import { writePainFlag } from '../core/pain.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 import { empathyObserverManager } from '../service/empathy-observer-manager.js';
 import * as fs from 'fs';
+function emitSubagentPainEvent(wctx, payload) {
+    try {
+        wctx.evolutionReducer.emitSync({
+            ts: new Date().toISOString(),
+            type: 'pain_detected',
+            data: {
+                painId: `pain_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`,
+                painType: 'subagent_error',
+                source: payload.source,
+                reason: payload.reason,
+                score: payload.score,
+                sessionId: payload.sessionId,
+            },
+        });
+    }
+    catch (e) {
+        console.warn(`[PD:Subagent] failed to emit evolution event: ${String(e)}`);
+    }
+}
 export async function handleSubagentEnded(event, ctx) {
     const { outcome, targetSessionKey } = event;
     const workspaceDir = ctx.workspaceDir;
@@ -18,13 +37,20 @@ export async function handleSubagentEnded(event, ctx) {
     if (outcome === 'error' || outcome === 'timeout') {
         const scoreSettings = config.get('scores');
         const score = outcome === 'error' ? scoreSettings.subagent_error_penalty : scoreSettings.subagent_timeout_penalty;
+        const reason = `Subagent session ${targetSessionKey} ended with outcome: ${outcome}`;
         writePainFlag(workspaceDir, {
             source: `subagent_${outcome}`,
             score: String(score),
             time: new Date().toISOString(),
-            reason: `Subagent session ${targetSessionKey} ended with outcome: ${outcome}`,
+            reason,
             is_risky: 'true'
         });
+        emitSubagentPainEvent(wctx, {
+            source: `subagent_${outcome}`,
+            reason,
+            score,
+            sessionId: ctx.sessionId,
+        });
     }
     // 2. Loop Closure: Clean up evolution queue if any subagent finished successfully
     if (outcome === 'ok' || outcome === 'deleted') {

package/dist/http/principles-console-route.d.ts

@@ -0,0 +1,2 @@
+import type { OpenClawPluginApi, OpenClawPluginHttpRouteParams } from '../openclaw-sdk.js';
+export declare function createPrinciplesConsoleRoute(api: OpenClawPluginApi): OpenClawPluginHttpRouteParams;