principles-disciple 1.5.4 → 1.7.0

package/dist/tools/deep-reflect.js

@@ -1,9 +1,81 @@
 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');
+    const memoryDir = path.dirname(reflectionLogPath);
+    // Ensure memory directory exists
+    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',
@@ -40,97 +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 (finalStatus.status === 'ok') { // 👈 对齐官方状态码
-                const rawMessages = await subagentRuntime.getSessionMessages({ sessionKey });
-                let insights = '';
-                if (rawMessages.assistantTexts && Array.isArray(rawMessages.assistantTexts)) {
-                    insights = rawMessages.assistantTexts.join('\n');
+            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 {
+                        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
-                    });
-                }
-                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'}
@@ -141,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' | 'error' | 'warn';
-export type EventCategory = 'success' | 'failure' | 'detected' | 'blocked' | 'approved' | 'enqueued' | 'completed' | 'promoted' | 'passed' | 'changed';
+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.
  */
@@ -42,6 +42,14 @@ export interface PainSignalEventData {
     source: 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;
@@ -67,6 +75,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;
@@ -106,6 +121,18 @@ export interface DeepReflectionEventData {
     /** 发现的风险数量 */
     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;
@@ -128,6 +155,59 @@ export interface PainStats {
     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;
@@ -214,6 +294,8 @@ export interface DailyStats {
     errors: ErrorStats;
     /** Pain signal statistics */
     pain: PainStats;
+    /** Empathy Engine event statistics */
+    empathy: EmpathyEventStats;
     /** GFI statistics */
     gfi: GfiStats;
     /** Evolution statistics */

package/dist/types/event-types.js

@@ -34,6 +34,39 @@ export function createEmptyDailyStats(date) {
             avgScore: 0,
             maxScore: 0,
         },
+        empathy: {
+            totalEvents: 0,
+            dedupedCount: 0,
+            dedupeHitRate: 0,
+            totalPenaltyScore: 0,
+            rolledBackScore: 0,
+            rollbackCount: 0,
+            bySeverity: {
+                mild: 0,
+                moderate: 0,
+                severe: 0,
+            },
+            scoreBySeverity: {
+                mild: 0,
+                moderate: 0,
+                severe: 0,
+            },
+            byDetectionMode: {
+                structured: 0,
+                legacy_tag: 0,
+            },
+            byOrigin: {
+                assistant_self_report: 0,
+                user_manual: 0,
+                system_infer: 0,
+            },
+            confidenceDistribution: {
+                high: 0,
+                medium: 0,
+                low: 0,
+            },
+            dailyTrend: [],
+        },
         gfi: {
             peak: 0,
             samples: 0,

package/dist/types.d.ts

@@ -1 +1,53 @@
 export type { PluginCommandContext, PluginCommandResult } from './openclaw-sdk.js';
+/**
+ * Context Injection Configuration
+ * Controls what content gets injected into the LLM prompt.
+ *
+ * NOTE: Core Principles (PRINCIPLES.md) are ALWAYS injected and cannot be disabled.
+ * 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;
+    /** Project context (CURRENT_FOCUS.md) mode */
+    projectFocus: ProjectFocusMode;
+    /** Reflection log - can be toggled */
+    reflectionLog: boolean;
+    /** Trust score awareness - can be toggled */
+    trustScore: boolean;
+    /** Evolution task context injection settings */
+    evolutionContext: EvolutionContextConfig;
+}
+/**
+ * Default context injection configuration
+ * Based on user requirements:
+ * - principles: always on (not configurable)
+ * - thinkingOs: true (can be turned off)
+ * - projectFocus: 'off' (default closed, user can enable)
+ * - reflectionLog: true (default on)
+ * - trustScore: true (can be turned off)
+ */
+export declare const defaultContextConfig: ContextInjectionConfig;
+/**
+ * Reflection log entry structure
+ */
+export interface ReflectionLogEntry {
+    timestamp: string;
+    context: string;
+    insights: string;
+    modelId?: string;
+    depth?: number;
+}
+/**
+ * Reflection log retention configuration
+ */
+export declare const reflectionLogRetentionDays = 7;