principles-disciple 1.8.1 → 1.8.3

package/src/tools/deep-reflect.ts

@@ -0,0 +1,349 @@
+import type { OpenClawPluginApi } from '../openclaw-sdk.js';
+import { Type } from '@sinclair/typebox';
+import * as fs from 'fs';
+import * as path from 'node:path';
+import { EventLogService } from '../core/event-log.js';
+import { buildCritiquePromptV2 } from './critique-prompt.js';
+import { resolvePdPath } from '../core/paths.js';
+import { resolveWorkspaceDirFromApi } from '../core/path-resolver.js';
+import { reflectionLogRetentionDays } from '../types.js';
+import {
+    DeepReflectWorkflowManager,
+    deepReflectWorkflowSpec,
+    type DeepReflectTaskInput,
+} from '../service/subagent-workflow/index.js';
+
+function writeToReflectionLog(
+    workspaceDir: string,
+    context: string,
+    insights: string,
+    modelId?: string,
+    depth?: number
+): void {
+    const reflectionLogPath = resolvePdPath(workspaceDir, 'REFLECTION_LOG');
+    const memoryDir = path.dirname(reflectionLogPath);
+    if (!fs.existsSync(memoryDir)) {
+        fs.mkdirSync(memoryDir, { recursive: true });
+    }
+
+    const timestamp = new Date().toISOString();
+    const entry = `
+---
+## Reflection at ${timestamp}
+**Model**: ${modelId || 'auto-select'}
+**Depth**: ${depth || 2}
+
+### Context
+${context.substring(0, 500)}${context.length > 500 ? '...' : ''}
+
+### Insights
+${insights}
+
+`;
+
+    const header = `# Reflection Log\n\n> Auto-generated by Deep Reflection Tool\n> Retention: ${reflectionLogRetentionDays} days\n`;
+
+    let existingContent = '';
+    if (fs.existsSync(reflectionLogPath)) {
+        existingContent = fs.readFileSync(reflectionLogPath, 'utf8');
+    }
+
+    const newContent = header + entry + existingContent.replace(header, '');
+
+    const tempPath = `${reflectionLogPath}.tmp`;
+    fs.writeFileSync(tempPath, newContent, 'utf8');
+    fs.renameSync(tempPath, reflectionLogPath);
+}
+
+function cleanupReflectionLog(workspaceDir: string): void {
+    const reflectionLogPath = resolvePdPath(workspaceDir, 'REFLECTION_LOG');
+
+    if (!fs.existsSync(reflectionLogPath)) return;
+
+    const content = fs.readFileSync(reflectionLogPath, 'utf8');
+    const cutoffDate = new Date();
+    cutoffDate.setDate(cutoffDate.getDate() - reflectionLogRetentionDays);
+
+    const entryPattern = /---\n## Reflection at (\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2})/g;
+    const parts = content.split(entryPattern);
+
+    const header = parts[0];
+    const validEntries: string[] = [];
+
+    for (let i = 1; i < parts.length; i += 2) {
+        const timestamp = parts[i];
+        const entryContent = parts[i + 1] || '';
+
+        const entryDate = new Date(timestamp);
+        if (entryDate >= cutoffDate) {
+            validEntries.push(`---\n## Reflection at ${timestamp}${entryContent}`);
+        }
+    }
+
+    if (validEntries.length < (parts.length - 1) / 2) {
+        const newContent = header + validEntries.join('');
+
+        const tempPath = `${reflectionLogPath}.tmp`;
+        fs.writeFileSync(tempPath, newContent, 'utf8');
+        fs.renameSync(tempPath, reflectionLogPath);
+    }
+}
+
+interface DeepReflectionConfig {
+    enabled: boolean;
+    mode: 'auto' | 'forced' | 'disabled';
+    auto_trigger_conditions: {
+        min_tool_calls: number;
+        error_rate_threshold: number;
+        high_gfi_threshold: number;
+    };
+    modelsDir?: string;
+    timeout_ms?: number;
+}
+
+const DEFAULT_CONFIG: DeepReflectionConfig = {
+    enabled: true,
+    mode: 'auto',
+    auto_trigger_conditions: {
+        min_tool_calls: 5,
+        error_rate_threshold: 0.3,
+        high_gfi_threshold: 70
+    },
+    timeout_ms: 60000
+};
+
+function safeLog(
+    api: OpenClawPluginApi | undefined,
+    level: 'info' | 'debug' | 'warn' | 'error',
+    message: string
+): void {
+    try {
+        if (api?.logger && typeof api.logger[level] === 'function') {
+            api.logger[level](message);
+        }
+    } catch {
+        // Never recurse on logger failures
+    }
+}
+
+function loadConfig(workspaceDir: string | undefined, api: OpenClawPluginApi): DeepReflectionConfig {
+    if (!workspaceDir) return DEFAULT_CONFIG;
+    const configPath = resolvePdPath(workspaceDir, 'PAIN_SETTINGS');
+    try {
+        if (fs.existsSync(configPath)) {
+            const raw = fs.readFileSync(configPath, 'utf-8');
+            const settings = JSON.parse(raw);
+            return { ...DEFAULT_CONFIG, ...settings.deep_reflection };
+        }
+    } catch (err) {
+        safeLog(api, 'warn', `[DeepReflect] Failed to load config: ${String(err)}`);
+    }
+    return DEFAULT_CONFIG;
+}
+
+function readStringParam(rawParams: Record<string, unknown>, key: string): string | undefined {
+    const value = rawParams[key];
+    if (typeof value === 'string') return value.trim() || undefined;
+
+    const snakeKey = key.replace(/([A-Z])/g, '_$1').toLowerCase();
+    const snakeValue = rawParams[snakeKey];
+    if (typeof snakeValue === 'string') return snakeValue.trim() || undefined;
+
+    return undefined;
+}
+
+function readNumberParam(rawParams: Record<string, unknown>, key: string): number | undefined {
+    const value = rawParams[key];
+    if (typeof value === 'number') return value;
+
+    const snakeKey = key.replace(/([A-Z])/g, '_$1').toLowerCase();
+    const snakeValue = rawParams[snakeKey];
+    if (typeof snakeValue === 'number') return snakeValue;
+
+    return undefined;
+}
+
+export function createDeepReflectTool(api: OpenClawPluginApi) {
+    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。' }))
+        }),
+
+        async execute(
+            _toolCallId: string,
+            rawParams: Record<string, unknown>
+        ): Promise<{ content: Array<{ type: string; text: string }> }> {
+            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)。'
+                    }]
+                };
+            }
+
+            const effectiveWorkspaceDir =
+                (api.config?.workspaceDir as string)
+                || resolveWorkspaceDirFromApi(api)
+                || 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.`);
+            }
+
+            const stateDir = resolvePdPath(effectiveWorkspaceDir, 'STATE_DIR');
+            const eventLog = EventLogService.get(stateDir, api.logger);
+
+            try {
+                // Use workspaceDir as parentSessionId proxy (OpenClaw does not expose sessionId to tools)
+                const parentSessionId = effectiveWorkspaceDir.replace(/[^a-zA-Z0-9_-]/g, '_').substring(0, 64);
+
+                const manager = new DeepReflectWorkflowManager({
+                    workspaceDir: effectiveWorkspaceDir,
+                    logger: api.logger,
+                    subagent: api.runtime.subagent as any,
+                });
+
+                const taskInput: DeepReflectTaskInput = { context, depth, model_id };
+
+                const handle = await manager.startWorkflow(deepReflectWorkflowSpec, {
+                    parentSessionId,
+                    workspaceDir: effectiveWorkspaceDir,
+                    taskInput,
+                });
+
+                // Wait for workflow completion via polling
+                const startTime = Date.now();
+                const timeoutMs = config.timeout_ms ?? 60000;
+                const pollInterval = 500;
+
+                while (Date.now() - startTime < timeoutMs) {
+                    await new Promise(resolve => setTimeout(resolve, pollInterval));
+                    const workflow = (manager as any).store.getWorkflow(handle.workflowId);
+                    if (!workflow) break;
+
+                    if (workflow.state === 'completed') {
+                        // Extract insights from reflection log (written by persistResult)
+                        const reflectionLogPath = resolvePdPath(effectiveWorkspaceDir, 'REFLECTION_LOG');
+                        let insights = '';
+                        if (fs.existsSync(reflectionLogPath)) {
+                            const content = fs.readFileSync(reflectionLogPath, 'utf8');
+                            // Extract most recent entry
+                            const match = content.match(/### Insights\n([\s\S]*?)(?=---|$)/);
+                            if (match) {
+                                insights = match[1].trim();
+                            }
+                        }
+
+                        if (eventLog) {
+                            eventLog.recordDeepReflection(handle.childSessionKey, {
+                                modelId: model_id || 'auto-select',
+                                modelSelectionMode: model_id ? 'manual' : 'auto',
+                                depth,
+                                contextPreview: context.substring(0, 200),
+                                resultPreview: insights.substring(0, 300),
+                                durationMs: Date.now() - startTime,
+                                passed: true,
+                                timeout: false
+                            });
+                        }
+
+                        manager.dispose();
+
+                        return {
+                            content: [{
+                                type: 'text',
+                                text: `
+# 💎 Deep Reflection Insights
+---
+**Selected Model(s)**: ${model_id || 'auto-select'}
+**Reflection Depth**: ${depth}
+**Analysis Duration**: ${((Date.now() - startTime) / 1000).toFixed(1)}s
+
+${insights || '反思完成，详见 REFLECTION_LOG。'}
+
+---
+*Generated by Principles Disciple Meta-Cognitive Engine*
+`.trim()
+                            }]
+                        };
+                    }
+
+                    if (workflow.state === 'terminal_error' || workflow.state === 'expired') {
+                        manager.dispose();
+                        throw new Error(`Deep-reflect workflow failed: ${workflow.state}`);
+                    }
+                }
+
+                manager.dispose();
+                return {
+                    content: [{
+                        type: 'text',
+                        text: '⚠️ 反思任务执行超时。你可以尝试减少上下文长度或增加深度。'
+                    }]
+                };
+
+            } catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                safeLog(api, 'error', `[DeepReflect] Reflection failed: ${errorMsg}`);
+
+                if (eventLog) {
+                    eventLog.recordDeepReflection('deep-reflect-error', {
+                        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
+                    });
+                }
+
+                return {
+                    content: [{
+                        type: 'text',
+                        text: `❌ 反思执行失败: ${errorMsg}。请检查 API 配置或网络连接。`
+                    }]
+                };
+            }
+        }
+    };
+}
+
+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/tools/model-index.js → src/tools/model-index.ts}

@@ -1,81 +1,97 @@
 import * as fs from 'fs';
 import * as path from 'path';
+import type { OpenClawPluginApi } from '../openclaw-sdk.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
+
 // 安全日志函数
-function safeLog(api, level, message) {
+function safeLog(
+    api: OpenClawPluginApi | undefined,
+    level: 'info' | 'debug' | 'warn' | 'error',
+    message: string
+): void {
     try {
         if (api?.logger && typeof api.logger[level] === 'function') {
             api.logger[level](message);
         }
-    }
-    catch {
+    } catch {
         // Ignore logging errors
     }
 }
+
 /**
  * 默认消息
  */
 const DEFAULT_MESSAGE = '（暂无扩展思维模型）';
+
 /**
  * 索引文件最大大小（字节）
  */
 const MAX_INDEX_SIZE = 50 * 1024; // 50KB
+
 /**
  * 加载自定义配置
  */
-function loadCustomConfig(wctx) {
+function loadCustomConfig(wctx: WorkspaceContext): { modelsDir?: string } | undefined {
     try {
         const config = wctx.config;
         const modelsDir = config.get('deep_reflection.modelsDir');
         if (typeof modelsDir === 'string' && modelsDir.trim()) {
             return { modelsDir: modelsDir.trim() };
         }
-    }
-    catch {
+    } catch {
         // Ignore config errors
     }
     return undefined;
 }
+
 /**
  * 加载模型索引并返回格式化后的字符串
- *
+ * 
  * @param workspaceDir 工作区目录
  * @param api OpenClaw 插件 API
  * @returns 格式化后的模型索引内容或默认消息
  */
-export function loadModelIndex(workspaceDir, api) {
-    if (!workspaceDir)
-        return DEFAULT_MESSAGE;
+export function loadModelIndex(
+    workspaceDir: string,
+    api?: OpenClawPluginApi
+): string {
+    if (!workspaceDir) return DEFAULT_MESSAGE;
+
     try {
         const wctx = WorkspaceContext.fromHookContext({ workspaceDir });
         const customConfig = loadCustomConfig(wctx);
-        let modelsDir;
+        
+        let modelsDir: string;
         if (customConfig?.modelsDir) {
-            modelsDir = path.isAbsolute(customConfig.modelsDir)
-                ? customConfig.modelsDir
+            modelsDir = path.isAbsolute(customConfig.modelsDir) 
+                ? customConfig.modelsDir 
                 : path.join(workspaceDir, customConfig.modelsDir);
+            
             // 👈 关键修复：显式输出测试用例期待的 debug 日志
             safeLog(api, 'debug', `[DeepReflect] Using custom models dir: ${modelsDir}`);
-        }
-        else {
+        } else {
             modelsDir = wctx.resolve('MODELS_DIR');
         }
+
         const indexPath = path.join(modelsDir, '_INDEX.md');
+
         if (!fs.existsSync(indexPath)) {
             if (fs.existsSync(modelsDir)) {
                 safeLog(api, 'warn', `[DeepReflect] _INDEX.md not found but ${modelsDir.replace(workspaceDir, '')} exists. Please create an index file.`);
             }
             return DEFAULT_MESSAGE;
         }
+
         const stats = fs.statSync(indexPath);
         if (stats.size > MAX_INDEX_SIZE) {
             safeLog(api, 'warn', `[DeepReflect] Index file too large (${stats.size} bytes). Max is ${MAX_INDEX_SIZE}.`);
             return DEFAULT_MESSAGE;
         }
+
         const content = fs.readFileSync(indexPath, 'utf-8');
         return content.trim() || DEFAULT_MESSAGE;
-    }
-    catch (err) {
+
+    } catch (err) {
         safeLog(api, 'warn', `[DeepReflect] Failed to load model index: ${String(err)}`);
         return DEFAULT_MESSAGE;
     }