principles-disciple 1.6.0 → 1.7.1

package/dist/tools/deep-reflect.js

@@ -112,105 +112,176 @@ function loadConfig(workspaceDir, api) {
     }
     return DEFAULT_CONFIG;
 }
-export const deepReflectTool = {
-    name: 'deep_reflect',
-    description: '执行深层次的元认知反思，分析当前任务的潜在风险、逻辑漏洞或架构改进点。',
-    parameters: Type.Object({
-        context: Type.String({ description: '需要反思的任务上下文、代码片段或当前遇到的困难。' }),
-        depth: Type.Optional(Type.Number({ description: '反思深度 (1-3)。1: 快速扫描, 2: 均衡分析, 3: 彻底解构。默认为 2。', minimum: 1, maximum: 3 })),
-        model_id: Type.Optional(Type.String({ description: '可选：强制指定使用的思维模型 ID。' }))
-    }),
-    /**
-     * Tool execution logic
-     * @param workspaceDir Optional parameter for unit testing
-     */
-    async execute(params, api, workspaceDir) {
-        const { context, depth = 2, model_id } = params;
-        if (!context)
-            return '❌ 错误: 必须提供反思上下文 (context)。';
-        // 路径解析优先级：显式传入 > api.config > api.workspaceDir > api.resolvePath
-        const effectiveWorkspaceDir = workspaceDir
-            || api.config?.workspaceDir
-            || api.workspaceDir
-            || api.resolvePath?.('.');
-        if (!effectiveWorkspaceDir) {
-            return `❌ 反思执行失败: Workspace directory is required for deep reflection.。请检查 API 配置或网络连接。`;
-        }
-        const config = loadConfig(effectiveWorkspaceDir, api);
-        if (config.mode === 'disabled' || !config.enabled) {
-            return `⏭️ Deep Reflection 已禁用。`;
-        }
-        if (model_id) {
-            safeLog(api, 'warn', `[DeepReflect] The 'model_id' parameter is deprecated. The agent will now auto-select models based on the context index.`);
-        }
-        const agentId = 'main';
-        const sessionKey = `agent:${agentId}:reflection:${randomUUID()}`;
-        const sessionId = sessionKey.split(':').pop();
-        const stateDir = resolvePdPath(effectiveWorkspaceDir, 'STATE_DIR');
-        const eventLog = EventLogService.get(stateDir, api.logger);
-        try {
-            const extraSystemPrompt = buildCritiquePromptV2({
-                context,
-                depth,
-                model_id,
-                api,
-                workspaceDir: effectiveWorkspaceDir
-            });
-            const startTime = Date.now();
-            const subagentRuntime = api.runtime.subagent;
-            if (!subagentRuntime)
-                throw new Error('OpenClaw subagent runtime not found.');
-            await subagentRuntime.run({
-                sessionKey, // 👈 对齐官方字段
-                message: `请对我当前的任务进行深层次反思。\n\n上下文：${context}`, // 👈 对齐官方字段
-                extraSystemPrompt,
-                deliver: false
-            });
-            const finalStatus = await subagentRuntime.waitForRun({ runId: sessionKey }); // 👈 对齐官方对象传参
-            const duration = Date.now() - startTime;
-            if (finalStatus.status === 'timeout') {
-                return `⚠️ 反思任务执行超时。你可以尝试减少上下文长度或增加深度。`;
+/**
+ * Helper to read string parameter from rawParams
+ * Supports both camelCase and snake_case parameter names
+ */
+function readStringParam(rawParams, key) {
+    const value = rawParams[key];
+    if (typeof value === 'string')
+        return value.trim() || undefined;
+    // Try snake_case alias
+    const snakeKey = key.replace(/([A-Z])/g, '_$1').toLowerCase();
+    const snakeValue = rawParams[snakeKey];
+    if (typeof snakeValue === 'string')
+        return snakeValue.trim() || undefined;
+    return undefined;
+}
+/**
+ * Helper to read number parameter from rawParams
+ * Supports both camelCase and snake_case parameter names
+ */
+function readNumberParam(rawParams, key) {
+    const value = rawParams[key];
+    if (typeof value === 'number')
+        return value;
+    // Try snake_case alias
+    const snakeKey = key.replace(/([A-Z])/g, '_$1').toLowerCase();
+    const snakeValue = rawParams[snakeKey];
+    if (typeof snakeValue === 'number')
+        return snakeValue;
+    return undefined;
+}
+/**
+ * Create Deep Reflect Tool
+ *
+ * Uses factory pattern to capture `api` in closure, following OpenClaw plugin SDK conventions.
+ * The execute signature must be: async (_toolCallId: string, rawParams: Record<string, unknown>)
+ */
+export function createDeepReflectTool(api) {
+    return {
+        name: 'deep_reflect',
+        description: '执行深层次的元认知反思，分析当前任务的潜在风险、逻辑漏洞或架构改进点。',
+        parameters: Type.Object({
+            context: Type.String({ description: '需要反思的任务上下文、代码片段或当前遇到的困难。' }),
+            depth: Type.Optional(Type.Number({ description: '反思深度 (1-3)。1: 快速扫描, 2: 均衡分析, 3: 彻底解构。默认为 2。', minimum: 1, maximum: 3 })),
+            model_id: Type.Optional(Type.String({ description: '可选：强制指定使用的思维模型 ID。' }))
+        }),
+        /**
+         * Tool execution logic
+         *
+         * OpenClaw tool execute signature:
+         * - First parameter: _toolCallId (string) - the tool call ID
+         * - Second parameter: rawParams (Record<string, unknown>) - the actual parameters
+         * - Third parameter (optional): signal (AbortSignal) - for cancellation
+         */
+        async execute(_toolCallId, rawParams) {
+            const context = readStringParam(rawParams, 'context') || '';
+            const depth = readNumberParam(rawParams, 'depth') ?? 2;
+            const model_id = readStringParam(rawParams, 'model_id');
+            if (!context) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: '❌ 错误: 必须提供反思上下文 (context)。'
+                        }]
+                };
+            }
+            // 路径解析优先级：api.config > api.workspaceDir > api.resolvePath
+            const effectiveWorkspaceDir = api.config?.workspaceDir
+                || api.workspaceDir
+                || api.resolvePath?.('.');
+            if (!effectiveWorkspaceDir) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: '❌ 反思执行失败: Workspace directory is required for deep reflection.。请检查 API 配置或网络连接。'
+                        }]
+                };
+            }
+            const config = loadConfig(effectiveWorkspaceDir, api);
+            if (config.mode === 'disabled' || !config.enabled) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: '⏭️ Deep Reflection 已禁用。'
+                        }]
+                };
+            }
+            if (model_id) {
+                safeLog(api, 'warn', `[DeepReflect] The 'model_id' parameter is deprecated. The agent will now auto-select models based on the context index.`);
             }
-            if (finalStatus.status === 'ok') { // 👈 对齐官方状态码
-                const rawMessages = await subagentRuntime.getSessionMessages({ sessionKey });
-                let insights = '';
-                if (rawMessages.assistantTexts && Array.isArray(rawMessages.assistantTexts)) {
-                    insights = rawMessages.assistantTexts.join('\n');
+            const agentId = 'main';
+            const sessionKey = `agent:${agentId}:reflection:${randomUUID()}`;
+            const sessionId = sessionKey.split(':').pop();
+            const stateDir = resolvePdPath(effectiveWorkspaceDir, 'STATE_DIR');
+            const eventLog = EventLogService.get(stateDir, api.logger);
+            try {
+                const extraSystemPrompt = buildCritiquePromptV2({
+                    context,
+                    depth,
+                    model_id,
+                    api,
+                    workspaceDir: effectiveWorkspaceDir
+                });
+                const startTime = Date.now();
+                const subagentRuntime = api.runtime.subagent;
+                if (!subagentRuntime)
+                    throw new Error('OpenClaw subagent runtime not found.');
+                await subagentRuntime.run({
+                    sessionKey,
+                    message: `请对我当前的任务进行深层次反思。\n\n上下文：${context}`,
+                    extraSystemPrompt,
+                    deliver: false
+                });
+                const finalStatus = await subagentRuntime.waitForRun({ runId: sessionKey });
+                const duration = Date.now() - startTime;
+                if (finalStatus.status === 'timeout') {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: '⚠️ 反思任务执行超时。你可以尝试减少上下文长度或增加深度。'
+                            }]
+                    };
                 }
-                else {
-                    const messages = rawMessages.messages || [];
-                    const lastMessage = messages[messages.length - 1];
-                    if (typeof lastMessage?.content === 'string') {
-                        insights = lastMessage.content;
+                if (finalStatus.status === 'ok') {
+                    const rawMessages = await subagentRuntime.getSessionMessages({ sessionKey });
+                    let insights = '';
+                    if (rawMessages.assistantTexts && Array.isArray(rawMessages.assistantTexts)) {
+                        insights = rawMessages.assistantTexts.join('\n');
                     }
-                    else if (Array.isArray(lastMessage?.content)) {
-                        insights = lastMessage.content.filter((c) => c.type === 'text').map((c) => c.text).join('\n');
+                    else {
+                        const messages = rawMessages.messages || [];
+                        const lastMessage = messages[messages.length - 1];
+                        if (typeof lastMessage?.content === 'string') {
+                            insights = lastMessage.content;
+                        }
+                        else if (Array.isArray(lastMessage?.content)) {
+                            insights = lastMessage.content.filter((c) => c.type === 'text').map((c) => c.text).join('\n');
+                        }
                     }
-                }
-                if (insights.includes('REFLECTION_OK')) {
-                    return `✅ 反思完成：当前任务逻辑严密，未发现显著问题。`;
-                }
-                if (eventLog && sessionId) {
-                    eventLog.recordDeepReflection(sessionId, {
-                        modelId: model_id || 'auto-select',
-                        modelSelectionMode: model_id ? 'manual' : 'auto',
-                        depth,
-                        contextPreview: context.substring(0, 200),
-                        resultPreview: insights.substring(0, 300),
-                        durationMs: duration,
-                        passed: true,
-                        timeout: false
-                    });
-                }
-                // Write to reflection log and cleanup old entries
-                try {
-                    writeToReflectionLog(effectiveWorkspaceDir, context, insights, model_id, depth);
-                    cleanupReflectionLog(effectiveWorkspaceDir);
-                }
-                catch (logErr) {
-                    safeLog(api, 'warn', `[DeepReflect] Failed to write reflection log: ${String(logErr)}`);
-                }
-                return `
+                    if (insights.includes('REFLECTION_OK')) {
+                        return {
+                            content: [{
+                                    type: 'text',
+                                    text: '✅ 反思完成：当前任务逻辑严密，未发现显著问题。'
+                                }]
+                        };
+                    }
+                    if (eventLog && sessionId) {
+                        eventLog.recordDeepReflection(sessionId, {
+                            modelId: model_id || 'auto-select',
+                            modelSelectionMode: model_id ? 'manual' : 'auto',
+                            depth,
+                            contextPreview: context.substring(0, 200),
+                            resultPreview: insights.substring(0, 300),
+                            durationMs: duration,
+                            passed: true,
+                            timeout: false
+                        });
+                    }
+                    // Write to reflection log and cleanup old entries
+                    try {
+                        writeToReflectionLog(effectiveWorkspaceDir, context, insights, model_id, depth);
+                        cleanupReflectionLog(effectiveWorkspaceDir);
+                    }
+                    catch (logErr) {
+                        safeLog(api, 'warn', `[DeepReflect] Failed to write reflection log: ${String(logErr)}`);
+                    }
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `
 # 💎 Deep Reflection Insights
 ---
 **Selected Model(s)**: ${model_id || 'auto-select'}
@@ -221,34 +292,52 @@ ${insights}
 
 ---
 *Generated by Principles Disciple Meta-Cognitive Engine*
-`.trim();
+`.trim()
+                            }]
+                    };
+                }
+                else {
+                    throw new Error(`Subagent status: ${finalStatus.status}`);
+                }
             }
-            else {
-                throw new Error(`Subagent status: ${finalStatus.status}`);
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                safeLog(api, 'error', `[DeepReflect] Reflection failed: ${errorMsg}`);
+                if (eventLog && sessionId) {
+                    eventLog.recordDeepReflection(sessionId, {
+                        modelId: model_id || 'auto-select',
+                        modelSelectionMode: model_id ? 'manual' : 'auto',
+                        depth,
+                        contextPreview: context.substring(0, 200),
+                        durationMs: 0,
+                        passed: false,
+                        timeout: errorMsg.toLowerCase().includes('timeout'),
+                        error: errorMsg
+                    });
+                }
+                if (errorMsg === 'API throw')
+                    throw err;
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `❌ 反思执行失败: ${errorMsg}。请检查 API 配置或网络连接。`
+                        }]
+                };
             }
-        }
-        catch (err) {
-            const errorMsg = err instanceof Error ? err.message : String(err);
-            safeLog(api, 'error', `[DeepReflect] Reflection failed: ${errorMsg}`);
-            if (eventLog && sessionId) {
-                eventLog.recordDeepReflection(sessionId, {
-                    modelId: model_id || 'auto-select',
-                    modelSelectionMode: model_id ? 'manual' : 'auto',
-                    depth,
-                    contextPreview: context.substring(0, 200),
-                    durationMs: 0,
-                    passed: false,
-                    timeout: errorMsg.toLowerCase().includes('timeout'),
-                    error: errorMsg
-                });
+            finally {
+                if (api.runtime.subagent)
+                    await api.runtime.subagent.deleteSession({ sessionKey }).catch(() => { });
             }
-            if (errorMsg === 'API throw')
-                throw err;
-            return `❌ 反思执行失败: ${errorMsg}。请检查 API 配置或网络连接。`;
-        }
-        finally {
-            if (api.runtime.subagent)
-                await api.runtime.subagent.deleteSession({ sessionKey }).catch(() => { });
         }
-    }
+    };
+}
+// Legacy export for backward compatibility with tests that call execute directly
+export const deepReflectTool = {
+    name: 'deep_reflect',
+    description: '执行深层次的元认知反思，分析当前任务的潜在风险、逻辑漏洞或架构改进点。',
+    parameters: Type.Object({
+        context: Type.String({ description: '需要反思的任务上下文、代码片段或当前遇到的困难。' }),
+        depth: Type.Optional(Type.Number({ description: '反思深度 (1-3)。1: 快速扫描, 2: 均衡分析, 3: 彻底解构。默认为 2。', minimum: 1, maximum: 3 })),
+        model_id: Type.Optional(Type.String({ description: '可选：强制指定使用的思维模型 ID。' }))
+    }),
 };

package/dist/types/event-types.d.ts

@@ -1,8 +1,8 @@
 /**
  * Event types for structured logging and daily statistics.
  */
-export type EventType = 'tool_call' | 'pain_signal' | 'rule_match' | 'rule_promotion' | 'hook_execution' | 'gate_block' | 'plan_approval' | 'evolution_task' | 'deep_reflection' | 'trust_change' | 'empathy_rollback' | 'error' | 'warn';
-export type EventCategory = 'success' | 'failure' | 'detected' | 'blocked' | 'approved' | 'enqueued' | 'completed' | 'promoted' | 'passed' | 'changed' | 'rolled_back';
+export type EventType = 'tool_call' | 'pain_signal' | 'rule_match' | 'rule_promotion' | 'hook_execution' | 'gate_block' | 'gate_bypass' | 'plan_approval' | 'evolution_task' | 'deep_reflection' | 'trust_change' | 'empathy_rollback' | 'error' | 'warn';
+export type EventCategory = 'success' | 'failure' | 'detected' | 'blocked' | 'bypassed' | 'approved' | 'enqueued' | 'completed' | 'promoted' | 'passed' | 'changed' | 'rolled_back';
 /**
  * Base event structure for JSONL logging.
  */
@@ -40,6 +40,7 @@ export interface ToolCallEventData {
 export interface PainSignalEventData {
     score: number;
     source: string;
+    eventId?: string;
     reason?: string;
     isRisky?: boolean;
     origin?: 'assistant_self_report' | 'user_manual' | 'system_infer';
@@ -75,6 +76,13 @@ export interface GateBlockEventData {
     reason: string;
     planStatus?: string;
 }
+export interface GateBypassEventData {
+    toolName: string;
+    filePath: string;
+    bypassType: 'stage4_architect' | 'plan_approved' | 'whitelisted';
+    trustScore: number;
+    trustStage: number;
+}
 export interface PlanApprovalEventData {
     toolName: string;
     filePath: string;

package/dist/types.d.ts

@@ -7,6 +7,14 @@ export type { PluginCommandContext, PluginCommandResult } from './openclaw-sdk.j
  * This is by design - principles are the foundation of the agent's behavior.
  */
 export type ProjectFocusMode = 'full' | 'summary' | 'off';
+export interface EvolutionContextConfig {
+    /** Enable conversation context in evolution task (default: true) */
+    enabled: boolean;
+    /** Max recent messages included in evolution task (default: 4) */
+    maxMessages: number;
+    /** Max chars per message snippet (default: 200) */
+    maxCharsPerMessage: number;
+}
 export interface ContextInjectionConfig {
     /** Thinking OS (mental models) - can be toggled */
     thinkingOs: boolean;
@@ -16,6 +24,8 @@ export interface ContextInjectionConfig {
     reflectionLog: boolean;
     /** Trust score awareness - can be toggled */
     trustScore: boolean;
+    /** Evolution task context injection settings */
+    evolutionContext: EvolutionContextConfig;
 }
 /**
  * Default context injection configuration

package/dist/types.js

@@ -12,6 +12,11 @@ export const defaultContextConfig = {
     projectFocus: 'off',
     reflectionLog: true,
     trustScore: true,
+    evolutionContext: {
+        enabled: true,
+        maxMessages: 4,
+        maxCharsPerMessage: 200,
+    },
 };
 /**
  * Reflection log retention configuration

package/openclaw.plugin.json

@@ -2,27 +2,38 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Evolutionary programming agent framework with strategic guardrails and reflection loops.",
-  "version": "1.6.0",
-  "skills": ["./skills"],
+  "version": "1.7.1",
+  "skills": [
+    "./skills"
+  ],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
       "language": {
         "type": "string",
-        "enum": ["en", "zh"],
+        "enum": [
+          "en",
+          "zh"
+        ],
         "default": "zh",
         "description": "系统提示词和交互语言 (默认推荐: zh)"
       },
       "auditLevel": {
         "type": "string",
-        "enum": ["low", "medium", "high"],
+        "enum": [
+          "low",
+          "medium",
+          "high"
+        ],
         "default": "medium",
         "description": "安全防爆级别：\n- low: 极客模式，几乎不拦截，AI 可以自由飞翔。\n- medium (推荐): 平衡模式，允许 AI 大胆尝试，但拦截毁灭性操作。\n- high: 严格模式，所有大范围修改都需要你明确授权。"
       },
       "riskPaths": {
         "type": "array",
-        "items": { "type": "string" },
+        "items": {
+          "type": "string"
+        },
         "default": [],
         "description": "自定义高危目录（例如 .git/, prod_db/）。AI 试图修改这些目录前，将被强制拦截并要求出具安全计划。"
       },
@@ -31,16 +42,37 @@
         "additionalProperties": false,
         "description": "当 AI 遇到复杂问题或连续报错时，是否允许它停下来进行深度自我反思？",
         "properties": {
-          "enabled": { "type": "boolean", "default": true, "description": "开启 AI 深度反思功能" },
-          "mode": { "type": "string", "enum": ["auto", "forced"], "default": "auto", "description": "auto: 遇到困难自动触发; forced: 每次回答前都强制反思(极耗时间，不推荐)" }
+          "enabled": {
+            "type": "boolean",
+            "default": true,
+            "description": "开启 AI 深度反思功能"
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "auto",
+              "forced"
+            ],
+            "default": "auto",
+            "description": "auto: 遇到困难自动触发; forced: 每次回答前都强制反思(极耗时间，不推荐)"
+          }
         }
       }
     }
   },
   "uiHints": {
-    "language": { "label": "交互语言" },
-    "auditLevel": { "label": "防爆拦截级别", "placeholder": "medium" },
-    "riskPaths": { "label": "☠️ 绝对高危目录 (空表示不设限)" },
-    "deep_reflection": { "label": "💡 AI 深度反思功能" }
+    "language": {
+      "label": "交互语言"
+    },
+    "auditLevel": {
+      "label": "防爆拦截级别",
+      "placeholder": "medium"
+    },
+    "riskPaths": {
+      "label": "☠️ 绝对高危目录 (空表示不设限)"
+    },
+    "deep_reflection": {
+      "label": "💡 AI 深度反思功能"
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "1.6.0",
+  "version": "1.7.1",
   "description": "Native OpenClaw plugin for Principles Disciple",
   "type": "module",
   "main": "./dist/index.js",
@@ -33,17 +33,23 @@
   },
   "scripts": {
     "build": "tsc",
-    "build:bundle": "node esbuild.config.js",
-    "build:production": "tsc && node esbuild.config.js --production",
+    "build:web": "node scripts/build-web.mjs",
+    "build:bundle": "node esbuild.config.js && node scripts/build-web.mjs",
+    "build:production": "tsc && node esbuild.config.js --production && node scripts/build-web.mjs --production",
     "test": "vitest run",
     "postinstall": "node scripts/install-dependencies.cjs"
   },
   "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/micromatch": "^4.0.10",
     "@types/node": "^25.5.0",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.2",
     "@types/ws": "^8.5.13",
     "@vitest/coverage-v8": "^4.1.0",
     "esbuild": "^0.27.4",
+    "jsdom": "^26.1.0",
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "ws": "^8.18.0"
@@ -58,6 +64,10 @@
   },
   "dependencies": {
     "@sinclair/typebox": "^0.34.48",
-    "micromatch": "^4.0.8"
+    "better-sqlite3": "^11.10.0",
+    "micromatch": "^4.0.8",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-router-dom": "^7.9.4"
   }
 }