principles-disciple 1.8.1 → 1.8.3

package/dist/tools/deep-reflect.js

@@ -1,350 +0,0 @@
-import { Type } from '@sinclair/typebox';
-import { randomUUID } from 'node:crypto';
-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 { reflectionLogRetentionDays } from '../types.js';
-/**
- * Write reflection result to reflection-log.md
- * Uses atomic write (temp file + rename) to prevent race conditions
- */
-function writeToReflectionLog(workspaceDir, context, insights, modelId, depth) {
-    const reflectionLogPath = resolvePdPath(workspaceDir, 'REFLECTION_LOG');
-    // Ensure memory directory exists (backward-compatible: create if missing)
-    // Note: resolvePdPath returns the full path; ensure parent dir exists
-    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`;
-    // Read existing content
-    let existingContent = '';
-    if (fs.existsSync(reflectionLogPath)) {
-        existingContent = fs.readFileSync(reflectionLogPath, 'utf8');
-    }
-    const newContent = header + entry + existingContent.replace(header, '');
-    // Atomic write: write to temp file first, then rename
-    const tempPath = `${reflectionLogPath}.tmp`;
-    fs.writeFileSync(tempPath, newContent, 'utf8');
-    fs.renameSync(tempPath, reflectionLogPath);
-}
-/**
- * Clean up reflection log entries older than retention period
- */
-function cleanupReflectionLog(workspaceDir) {
-    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);
-    // Use more precise regex to match ISO timestamp
-    // Pattern: ---\n## Reflection at 2024-01-15T10:30:00
-    const entryPattern = /---\n## Reflection at (\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2})/g;
-    const parts = content.split(entryPattern);
-    // parts[0] = header, then alternates: timestamp, content, timestamp, content...
-    const header = parts[0];
-    const validEntries = [];
-    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('');
-        // Atomic write
-        const tempPath = `${reflectionLogPath}.tmp`;
-        fs.writeFileSync(tempPath, newContent, 'utf8');
-        fs.renameSync(tempPath, reflectionLogPath);
-    }
-}
-const DEFAULT_CONFIG = {
-    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, level, message) {
-    try {
-        if (api?.logger && typeof api.logger[level] === 'function') {
-            api.logger[level](message);
-        }
-    }
-    catch (e) {
-        console.error(`[PD:DeepReflect] Logging failed: ${String(e)}`);
-    }
-}
-function loadConfig(workspaceDir, api) {
-    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;
-}
-/**
- * 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.`);
-            }
-            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) {
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: `❌ Subagent runtime 不可用。\n\n当前运行在 embedded 模式（openclaw agent CLI），该模式不支持深反思功能。\n\n请通过 Gateway 模式运行（openclaw gateway）。`
-                            }]
-                    };
-                }
-                const runResult = await subagentRuntime.run({
-                    sessionKey,
-                    message: `请对我当前的任务进行深层次反思。\n\n上下文：${context}`,
-                    extraSystemPrompt,
-                    deliver: false
-                });
-                const finalStatus = await subagentRuntime.waitForRun({ runId: runResult.runId });
-                const duration = Date.now() - startTime;
-                if (finalStatus.status === 'timeout') {
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: '⚠️ 反思任务执行超时。你可以尝试减少上下文长度或增加深度。'
-                            }]
-                    };
-                }
-                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 {
-                        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 {
-                            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'}
-**Reflection Depth**: ${depth}
-**Analysis Duration**: ${(duration / 1000).toFixed(1)}s
-
-${insights}
-
----
-*Generated by Principles Disciple Meta-Cognitive Engine*
-`.trim()
-                            }]
-                    };
-                }
-                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 配置或网络连接。`
-                        }]
-                };
-            }
-            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/tools/model-index.d.ts

@@ -1,9 +0,0 @@
-import type { OpenClawPluginApi } from '../openclaw-sdk.js';
-/**
- * 加载模型索引并返回格式化后的字符串
- *
- * @param workspaceDir 工作区目录
- * @param api OpenClaw 插件 API
- * @returns 格式化后的模型索引内容或默认消息
- */
-export declare function loadModelIndex(workspaceDir: string, api?: OpenClawPluginApi): string;

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

@@ -1,306 +0,0 @@
-/**
- * Event types for structured logging and daily statistics.
- */
-export type EventType = 'tool_call' | 'pain_signal' | 'rule_match' | 'rule_promotion' | 'hook_execution' | 'gate_block' | 'gate_bypass' | 'plan_approval' | 'evolution_task' | 'deep_reflection' | '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.
- */
-export interface EventLogEntry {
-    /** ISO timestamp */
-    ts: string;
-    /** Date for partitioning (YYYY-MM-DD) */
-    date: string;
-    /** Event type */
-    type: EventType;
-    /** Event category */
-    category: EventCategory;
-    /** Session identifier */
-    sessionId?: string;
-    /** Workspace directory */
-    workspaceDir?: string;
-    /** Event-specific data */
-    data: Record<string, unknown>;
-}
-export interface ToolCallEventData {
-    toolName: string;
-    filePath?: string;
-    error?: string;
-    errorType?: string;
-    gfi?: number;
-    consecutiveErrors?: number;
-    exitCode?: number;
-}
-export interface PainSignalEventData {
-    score: number;
-    source: string;
-    eventId?: string;
-    reason?: string;
-    isRisky?: boolean;
-    origin?: 'assistant_self_report' | 'user_manual' | 'system_infer';
-    severity?: 'mild' | 'moderate' | 'severe';
-    confidence?: number;
-    detection_mode?: 'structured' | 'legacy_tag';
-    deduped?: boolean;
-    trigger_text_excerpt?: string;
-    raw_score?: number;
-    calibrated_score?: number;
-}
-export interface RuleMatchEventData {
-    ruleId: string;
-    layer: 'L1' | 'L2' | 'L3';
-    severity: number;
-    textPreview: string;
-}
-export interface RulePromotionEventData {
-    fingerprint: string;
-    ruleId: string;
-    phrase: string;
-    sampleCount: number;
-    avgSimilarity: number;
-}
-export interface HookExecutionEventData {
-    hookName: string;
-    durationMs?: number;
-    error?: string;
-}
-export interface GateBlockEventData {
-    toolName: string;
-    filePath: string;
-    reason: string;
-    planStatus?: string;
-    /** Source module that triggered the block (for audit trail) */
-    blockSource?: string;
-}
-export interface GateBypassEventData {
-    toolName: string;
-    filePath: string;
-    bypassType: 'stage4_architect' | 'whitelisted';
-}
-export interface PlanApprovalEventData {
-    toolName: string;
-    filePath: string;
-    pattern: string;
-    planStatus: string;
-}
-export interface EvolutionTaskEventData {
-    taskId: string;
-    taskType: string;
-    reason: string;
-}
-export interface DeepReflectionEventData {
-    /** 思维模型 ID (T-01 到 T-09)，向后兼容 */
-    modelId: string;
-    /** 模型选择模式：'manual' = 用户指定 model_id，'auto' = 子智能体自动选择 */
-    modelSelectionMode: 'manual' | 'auto';
-    /** 反思深度 (1-3) */
-    depth: number;
-    /** 上下文摘要（前 200 字符） */
-    contextPreview: string;
-    /** 反思结果摘要 */
-    resultPreview?: string;
-    /** 执行耗时 (ms) */
-    durationMs: number;
-    /** 是否通过（未发现显著问题） */
-    passed: boolean;
-    /** 是否超时 */
-    timeout: boolean;
-    /** 错误信息 */
-    error?: string;
-    /** 输出长度 */
-    outputLength?: number;
-    /** 置信度（从输出中提取） */
-    confidence?: 'LOW' | 'MEDIUM' | 'HIGH';
-    /** 发现的盲点数量 */
-    blindSpotsCount?: number;
-    /** 发现的风险数量 */
-    risksCount?: number;
-}
-export interface EmpathyRollbackEventData {
-    /** Event ID being rolled back */
-    eventId: string;
-    /** Original penalty score that was applied */
-    originalScore: number;
-    /** Session ID where the original event occurred */
-    originalSessionId?: string;
-    /** Reason for rollback (manual, false_positive, etc.) */
-    reason: string;
-    /** Who initiated the rollback */
-    triggeredBy: 'user_command' | 'natural_language' | 'system';
-}
-export interface ToolCallStats {
-    total: number;
-    success: number;
-    failure: number;
-    byTool: Record<string, {
-        success: number;
-        failure: number;
-    }>;
-}
-export interface ErrorStats {
-    total: number;
-    byType: Record<string, number>;
-    byTool: Record<string, number>;
-}
-export interface PainStats {
-    signalsDetected: number;
-    signalsBySource: Record<string, number>;
-    rulesMatched: Record<string, number>;
-    candidatesPromoted: number;
-    avgScore: number;
-    maxScore: number;
-}
-/**
- * Empathy Engine event statistics for tracking emotional signals.
- * Used for /pd-status empathy card and effectiveness metrics.
- */
-export interface EmpathyEventStats {
-    /** Total empathy events detected (excluding deduped) */
-    totalEvents: number;
-    /** Events that were deduped (not counted in totalEvents) */
-    dedupedCount: number;
-    /** Dedupe hit rate (dedupedCount / (totalEvents + dedupedCount)) */
-    dedupeHitRate: number;
-    /** Total penalty score applied */
-    totalPenaltyScore: number;
-    /** Score rolled back via manual rollback */
-    rolledBackScore: number;
-    /** Number of rollback operations */
-    rollbackCount: number;
-    /** Events by severity level */
-    bySeverity: {
-        mild: number;
-        moderate: number;
-        severe: number;
-    };
-    /** Score by severity level */
-    scoreBySeverity: {
-        mild: number;
-        moderate: number;
-        severe: number;
-    };
-    /** Events by detection mode */
-    byDetectionMode: {
-        structured: number;
-        legacy_tag: number;
-    };
-    /** Events by origin */
-    byOrigin: {
-        assistant_self_report: number;
-        user_manual: number;
-        system_infer: number;
-    };
-    /** Confidence distribution */
-    confidenceDistribution: {
-        high: number;
-        medium: number;
-        low: number;
-    };
-    /** Daily trend (last 7 days) */
-    dailyTrend: Array<{
-        date: string;
-        count: number;
-        score: number;
-    }>;
-}
-export interface GfiStats {
-    peak: number;
-    samples: number;
-    total: number;
-    resetCount: number;
-    hourlyDistribution: number[];
-}
-export interface EvolutionStats {
-    tasksEnqueued: number;
-    tasksCompleted: number;
-    rulesPromoted: number;
-}
-export interface HookStats {
-    byType: Record<string, number>;
-    errors: number;
-    totalDurationMs: number;
-}
-export interface DeepReflectionStats {
-    /** 总调用次数 */
-    totalCalls: number;
-    /** 通过次数（未发现问题） */
-    passedCount: number;
-    /** 发现问题的次数 */
-    issuesFoundCount: number;
-    /** 超时次数 */
-    timeoutCount: number;
-    /** 错误次数 */
-    errorCount: number;
-    /** 按模型选择模式统计 */
-    bySelectionMode: {
-        manual: {
-            count: number;
-            avgDurationMs: number;
-            passedCount: number;
-        };
-        auto: {
-            count: number;
-            avgDurationMs: number;
-            passedCount: number;
-        };
-    };
-    /** 按模型统计（向后兼容，仅记录手动指定的 model_id） */
-    byModel: Record<string, {
-        count: number;
-        avgDurationMs: number;
-        passedCount: number;
-    }>;
-    /** 按深度统计 */
-    byDepth: Record<number, number>;
-    /** 总耗时 */
-    totalDurationMs: number;
-    /** 平均耗时 */
-    avgDurationMs: number;
-    /** 发现的总盲点数 */
-    totalBlindSpots: number;
-    /** 发现的总风险数 */
-    totalRisks: number;
-    /** 置信度分布 */
-    confidenceDistribution: {
-        LOW: number;
-        MEDIUM: number;
-        HIGH: number;
-    };
-}
-/**
- * Daily aggregated statistics.
- */
-export interface DailyStats {
-    /** Date (YYYY-MM-DD) */
-    date: string;
-    /** Timestamp when stats were created */
-    createdAt: string;
-    /** Timestamp when stats were last updated */
-    updatedAt: string;
-    /** Tool call statistics */
-    tools: {
-        total: number;
-        success: number;
-        failure: number;
-    };
-    /** Tool call statistics */
-    toolCalls: ToolCallStats;
-    /** Error statistics */
-    errors: ErrorStats;
-    /** Pain signal statistics */
-    pain: PainStats;
-    /** Empathy Engine event statistics */
-    empathy: EmpathyEventStats;
-    /** GFI statistics */
-    gfi: GfiStats;
-    /** Evolution statistics */
-    evolution: EvolutionStats;
-    /** Hook execution statistics */
-    hooks: HookStats;
-    /** Deep Reflection statistics */
-    deepReflection: DeepReflectionStats;
-}
-/**
- * Creates an empty daily stats object.
- */
-export declare function createEmptyDailyStats(date: string): DailyStats;