principles-disciple 1.6.0 → 1.7.0

package/dist/commands/context.js

@@ -1,5 +1,6 @@
 import * as fs from 'fs';
 import * as path from 'path';
+import { defaultContextConfig } from '../types.js';
 import { loadContextInjectionConfig } from '../hooks/prompt.js';
 /**
  * Get workspace directory from context
@@ -185,7 +186,8 @@ function applyPreset(workspaceDir, preset, isZh) {
                 thinkingOs: false,
                 trustScore: true,
                 reflectionLog: false,
-                projectFocus: 'off'
+                projectFocus: 'off',
+                evolutionContext: { ...defaultContextConfig.evolutionContext }
             };
             break;
         case 'standard':
@@ -193,7 +195,8 @@ function applyPreset(workspaceDir, preset, isZh) {
                 thinkingOs: true,
                 trustScore: true,
                 reflectionLog: false,
-                projectFocus: 'off'
+                projectFocus: 'off',
+                evolutionContext: { ...defaultContextConfig.evolutionContext }
             };
             break;
         case 'full':
@@ -201,7 +204,8 @@ function applyPreset(workspaceDir, preset, isZh) {
                 thinkingOs: true,
                 trustScore: true,
                 reflectionLog: true,
-                projectFocus: 'summary'
+                projectFocus: 'summary',
+                evolutionContext: { ...defaultContextConfig.evolutionContext }
             };
             break;
     }

package/dist/commands/evolution-status.d.ts

@@ -0,0 +1,4 @@
+import type { PluginCommandContext } from '../openclaw-sdk.js';
+export declare function handleEvolutionStatusCommand(ctx: PluginCommandContext): {
+    text: string;
+};

package/dist/commands/evolution-status.js

@@ -0,0 +1,138 @@
+import { EvolutionReducerImpl } from '../core/evolution-reducer.js';
+import { normalizeLanguage } from '../i18n/commands.js';
+import { getAgentScorecard } from '../core/trust-engine.js';
+import { EventLogService } from '../core/event-log.js';
+import * as fs from 'fs';
+import * as path from 'path';
+function getQueueStats(workspaceDir) {
+    const stateDir = path.join(workspaceDir, '.state', 'principles');
+    const queuePath = path.join(stateDir, 'evolution_queue.json');
+    let pending = 0;
+    let completed = 0;
+    let inProgress = 0;
+    try {
+        if (fs.existsSync(queuePath)) {
+            const queue = JSON.parse(fs.readFileSync(queuePath, 'utf-8'));
+            for (const item of queue) {
+                if (item.status === 'completed') {
+                    completed++;
+                }
+                else if (item.status === 'in_progress') {
+                    inProgress++;
+                }
+                else {
+                    pending++;
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore errors, return zeros
+    }
+    return { pending, completed, inProgress };
+}
+function getCurrentPain(workspaceDir) {
+    const stateDir = path.join(workspaceDir, '.state', 'principles');
+    const painFlagPath = path.join(stateDir, '.pain_flag');
+    try {
+        if (fs.existsSync(painFlagPath)) {
+            const data = JSON.parse(fs.readFileSync(painFlagPath, 'utf-8'));
+            return {
+                painScore: data.score || 0,
+                painSource: data.source || 'none'
+            };
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return { painScore: 0, painSource: 'none' };
+}
+export function handleEvolutionStatusCommand(ctx) {
+    const workspaceDir = ctx.config?.workspaceDir || process.cwd();
+    const reducer = new EvolutionReducerImpl({ workspaceDir });
+    const stats = reducer.getStats();
+    // Get Trust Score
+    let trustScore = 0;
+    let trustStage = 1;
+    try {
+        const scorecard = getAgentScorecard(workspaceDir);
+        trustScore = scorecard.trust_score ?? 0;
+        trustStage = trustScore >= 80 ? 4 : trustScore >= 60 ? 3 : trustScore >= 30 ? 2 : 1;
+    }
+    catch {
+        // Ignore errors, use defaults
+    }
+    // Get EventLog for GFI and Pain stats
+    let gfiPeak = 0;
+    let painSignals = 0;
+    try {
+        const stateDir = path.join(workspaceDir, '.state', 'principles');
+        const eventLog = EventLogService.get(stateDir);
+        const today = new Date().toISOString().split('T')[0];
+        const dailyStats = eventLog.getDailyStats(today);
+        gfiPeak = dailyStats.gfi?.peak ?? 0;
+        painSignals = dailyStats.pain?.signalsDetected ?? 0;
+    }
+    catch {
+        // Ignore errors, use defaults
+    }
+    // Get Queue Stats
+    const queueStats = getQueueStats(workspaceDir);
+    // Get Current Pain
+    const currentPain = getCurrentPain(workspaceDir);
+    // Determine language - handle both 'zh' and 'zh-CN' formats
+    const rawLang = ctx.config?.language || 'en';
+    const lang = normalizeLanguage(rawLang);
+    if (lang === 'zh') {
+        const lines = [
+            '📈 Evolution 状态',
+            '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
+            '',
+            `🛡️ Trust Score: ${trustScore}/100 (Stage ${trustStage})`,
+            `😴 GFI Peak: ${gfiPeak.toFixed(1)}`,
+            `⚡ Current Pain: ${currentPain.painScore} pts (${currentPain.painSource})`,
+            `📈 Pain Signals Today: ${painSignals}`,
+            '',
+            '📊 Evolution Rules',
+            '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
+            `- 候选原则: ${stats.candidateCount}`,
+            `- 观察期原则: ${stats.probationCount}`,
+            `- 生效原则: ${stats.activeCount}`,
+            `- 已废弃原则: ${stats.deprecatedCount}`,
+            `- 最近晋升时间: ${stats.lastPromotedAt ?? '无'}`,
+            '',
+            '📋 Evolution Queue',
+            '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
+            `- 待处理: ${queueStats.pending} 项`,
+            `- 进行中: ${queueStats.inProgress} 项`,
+            `- 已完成: ${queueStats.completed} 项`,
+        ];
+        return { text: lines.join('\n') };
+    }
+    // English
+    const lines = [
+        '📈 Evolution Status',
+        '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
+        '',
+        `🛡️ Trust Score: ${trustScore}/100 (Stage ${trustStage})`,
+        `😴 GFI Peak: ${gfiPeak.toFixed(1)}`,
+        `⚡ Current Pain: ${currentPain.painScore} pts (${currentPain.painSource})`,
+        `📈 Pain Signals Today: ${painSignals}`,
+        '',
+        '📊 Evolution Rules',
+        '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
+        `- candidate principles: ${stats.candidateCount}`,
+        `- probation principles: ${stats.probationCount}`,
+        `- active principles: ${stats.activeCount}`,
+        `- deprecated principles: ${stats.deprecatedCount}`,
+        `- last promoted: ${stats.lastPromotedAt ?? 'none'}`,
+        '',
+        '📋 Evolution Queue',
+        '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
+        `- Pending: ${queueStats.pending}`,
+        `- In Progress: ${queueStats.inProgress}`,
+        `- Completed: ${queueStats.completed}`,
+    ];
+    return { text: lines.join('\n') };
+}

package/dist/commands/export.d.ts

@@ -0,0 +1,2 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+export declare function handleExportCommand(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/export.js

@@ -0,0 +1,45 @@
+import { WorkspaceContext } from '../core/workspace-context.js';
+function isZh(ctx) {
+    return String(ctx.config?.language || 'en').startsWith('zh');
+}
+export function handleExportCommand(ctx) {
+    const workspaceDir = ctx.config?.workspaceDir || process.cwd();
+    const zh = isZh(ctx);
+    const args = (ctx.args || '').trim();
+    const [subcommand = 'corrections'] = args.split(/\s+/).filter(Boolean);
+    const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
+    if (subcommand !== 'analytics' && subcommand !== 'corrections') {
+        return {
+            text: zh
+                ? '无效的导出类型。请使用 `analytics` 或 `corrections [--redacted]`。'
+                : 'Invalid export target. Use `analytics` or `corrections [--redacted]`.',
+        };
+    }
+    try {
+        if (subcommand === 'analytics') {
+            const result = wctx.trajectory.exportAnalytics();
+            return {
+                text: zh
+                    ? `已导出 analytics 快照到 ${result.filePath}，共 ${result.count} 条聚合记录。`
+                    : `Exported analytics snapshot to ${result.filePath} (${result.count} aggregated rows).`,
+            };
+        }
+        const redacted = args.includes('--redacted');
+        const result = wctx.trajectory.exportCorrections({
+            mode: redacted ? 'redacted' : 'raw',
+            approvedOnly: true,
+        });
+        return {
+            text: zh
+                ? `已导出纠错样本到 ${result.filePath}，模式 ${result.mode}，共 ${result.count} 条。`
+                : `Exported correction samples to ${result.filePath} (mode=${result.mode}, count=${result.count}).`,
+        };
+    }
+    catch {
+        return {
+            text: zh
+                ? '导出失败，请检查日志。'
+                : 'Export failed. Check logs.',
+        };
+    }
+}

package/dist/commands/focus.js

@@ -9,9 +9,10 @@
  */
 import * as fs from 'fs';
 import * as path from 'path';
+import { randomUUID } from 'node:crypto';
 import { WorkspaceContext } from '../core/workspace-context.js';
 import { getHistoryDir, backupToHistory, cleanupHistory, extractVersion, extractDate, } from '../core/focus-history.js';
-import { agentSpawnTool } from '../tools/agent-spawn.js';
+import { createAgentSpawnTool } from '../tools/agent-spawn.js';
 /**
  * 清理 Markdown 代码块围栏
  * 移除开头的 ```lang 和结尾的 ```
@@ -329,14 +330,16 @@ If no milestones to record, leave ===MEMORY=== section empty.`;
     let memoryUpdated = false;
     try {
         // 调用子智能体进行压缩
-        const result = await agentSpawnTool.execute({
+        const tool = createAgentSpawnTool(api);
+        const result = await tool.execute(`focus-compress-${randomUUID()}`, {
             agentType: 'reporter', // 使用 reporter 类型，适合总结和压缩
             task: compressPrompt,
-        }, api);
+        });
         // 解析输出，提取 MEMORY 和 COMPRESSED 部分
-        if (result && result.trim()) {
-            const memoryMatch = result.match(/===MEMORY===([\s\S]*?)===COMPRESSED===/);
-            const compressedMatch = result.match(/===COMPRESSED===([\s\S]*?)$/);
+        const resultText = result?.content?.[0]?.text || '';
+        if (resultText.trim()) {
+            const memoryMatch = resultText.match(/===MEMORY===([\s\S]*?)===COMPRESSED===/);
+            const compressedMatch = resultText.match(/===COMPRESSED===([\s\S]*?)$/);
             if (compressedMatch && compressedMatch[1].trim()) {
                 // 清理 Markdown 代码块围栏
                 compressedContent = stripMarkdownFence(compressedMatch[1]);

package/dist/commands/pain.js

@@ -93,6 +93,14 @@ export function handlePainCommand(ctx) {
         const newScore = wctx.trust.getScore();
         return { text: isZh ? `✅ 智能体信任分已重置为初始值 (${newScore})。` : `✅ Agent trust score has been reset to initial value (${newScore}).` };
     }
+    if (args === 'data') {
+        const stats = wctx.trajectory.getDataStats();
+        return {
+            text: isZh
+                ? `轨迹数据状态\n- 数据库: ${stats.dbPath}\n- 助手轮次: ${stats.assistantTurns}\n- 用户轮次: ${stats.userTurns}\n- 工具调用: ${stats.toolCalls}\n- 痛感事件: ${stats.painEvents}\n- 待审核样本: ${stats.pendingSamples}\n- 已通过样本: ${stats.approvedSamples}\n- Blob 字节数: ${stats.blobBytes}\n- 最近写入: ${stats.lastIngestAt ?? 'none'}`
+                : `Trajectory Data Status\n- DB: ${stats.dbPath}\n- assistant turns: ${stats.assistantTurns}\n- user turns: ${stats.userTurns}\n- tool calls: ${stats.toolCalls}\n- pain events: ${stats.painEvents}\n- pending samples: ${stats.pendingSamples}\n- approved samples: ${stats.approvedSamples}\n- blob bytes: ${stats.blobBytes}\n- last ingest: ${stats.lastIngestAt ?? 'none'}`
+        };
+    }
     // Default: Show status
     const session = sessionId ? getSession(sessionId) : undefined;
     const gfi = session ? session.currentGfi : 0;

package/dist/commands/principle-rollback.d.ts

@@ -0,0 +1,4 @@
+import type { PluginCommandContext } from '../openclaw-sdk.js';
+export declare function handlePrincipleRollbackCommand(ctx: PluginCommandContext): {
+    text: string;
+};

package/dist/commands/principle-rollback.js

@@ -0,0 +1,22 @@
+import { EvolutionReducerImpl } from '../core/evolution-reducer.js';
+export function handlePrincipleRollbackCommand(ctx) {
+    const workspaceDir = ctx.config?.workspaceDir || process.cwd();
+    const argText = (ctx.args || '').trim();
+    const [principleId = '', ...reasonParts] = argText.split(/\s+/);
+    const reason = (reasonParts.join(' ') || 'manual rollback').trim();
+    const isZh = ctx.config?.language?.startsWith('zh');
+    if (!principleId) {
+        return { text: isZh ? '用法: /pd-principle-rollback <principleId> [reason]' : 'Usage: /pd-principle-rollback <principleId> [reason]' };
+    }
+    const reducer = new EvolutionReducerImpl({ workspaceDir });
+    const principle = reducer.getPrincipleById(principleId);
+    if (!principle) {
+        return { text: isZh ? `未找到原则: ${principleId}` : `Principle not found: ${principleId}` };
+    }
+    reducer.rollbackPrinciple(principleId, reason);
+    return {
+        text: isZh
+            ? `✅ 已回滚原则 ${principleId}\n原因: ${reason}`
+            : `✅ Rolled back principle ${principleId}\nReason: ${reason}`,
+    };
+}

package/dist/commands/samples.d.ts

@@ -0,0 +1,2 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+export declare function handleSamplesCommand(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/samples.js

@@ -0,0 +1,55 @@
+import { WorkspaceContext } from '../core/workspace-context.js';
+function isZh(ctx) {
+    return String(ctx.config?.language || 'en').startsWith('zh');
+}
+export function handleSamplesCommand(ctx) {
+    const workspaceDir = ctx.config?.workspaceDir || process.cwd();
+    const zh = isZh(ctx);
+    const args = (ctx.args || '').trim();
+    const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
+    if (args.startsWith('review ')) {
+        const [, decision = '', sampleId = '', ...noteParts] = args.split(/\s+/);
+        if (decision !== 'approve' && decision !== 'reject') {
+            return {
+                text: zh
+                    ? '无效的审核动作。请使用 `review approve <sample-id> [note]` 或 `review reject <sample-id> [note]`。'
+                    : 'Invalid review action. Use `review approve <sample-id> [note]` or `review reject <sample-id> [note]`.',
+            };
+        }
+        if (!sampleId) {
+            return {
+                text: zh
+                    ? '缺少 sample-id。'
+                    : 'Missing sample-id.',
+            };
+        }
+        const normalizedDecision = decision === 'approve' ? 'approved' : 'rejected';
+        const note = noteParts.join(' ').trim();
+        let record;
+        try {
+            record = wctx.trajectory.reviewCorrectionSample(sampleId, normalizedDecision, note);
+        }
+        catch (error) {
+            return {
+                text: zh
+                    ? `审核样本失败：${sampleId}`
+                    : `Failed to review sample: ${sampleId}`,
+            };
+        }
+        return {
+            text: zh
+                ? `样本 ${record.sampleId} 已标记为 ${record.reviewStatus}。`
+                : `Sample ${record.sampleId} marked as ${record.reviewStatus}.`,
+        };
+    }
+    const samples = wctx.trajectory.listCorrectionSamples('pending');
+    if (samples.length === 0) {
+        return { text: zh ? '当前没有待审核纠错样本。' : 'No pending correction samples.' };
+    }
+    const lines = samples.map((sample) => `- ${sample.sampleId} | session=${sample.sessionId} | score=${sample.qualityScore}`);
+    return {
+        text: zh
+            ? `待审核纠错样本:\n${lines.join('\n')}`
+            : `Pending correction samples:\n${lines.join('\n')}`,
+    };
+}

package/dist/core/config.d.ts

@@ -65,6 +65,11 @@ export interface TrustSettings {
 }
 export interface PainSettings {
     language: 'en' | 'zh';
+    trajectory?: {
+        blob_inline_threshold_bytes?: number;
+        busy_timeout_ms?: number;
+        orphan_blob_grace_days?: number;
+    };
     thresholds: {
         pain_trigger: number;
         cognitive_paralysis_input: number;

package/dist/core/control-ui-db.d.ts

@@ -0,0 +1,68 @@
+export interface ThinkingModelEventInput {
+    sessionId: string;
+    runId: string;
+    assistantTurnId: number;
+    modelId: string;
+    matchedPattern: string;
+    scenarioJson: unknown;
+    toolContextJson: unknown;
+    painContextJson: unknown;
+    principleContextJson: unknown;
+    triggerExcerpt: string;
+    createdAt: string;
+}
+export interface ControlUiDatabaseOptions {
+    workspaceDir: string;
+    busyTimeoutMs?: number;
+}
+export interface RecentThinkingContext {
+    toolCalls: Array<{
+        id: number;
+        toolName: string;
+        outcome: 'success' | 'failure' | 'blocked';
+        errorType: string | null;
+        errorMessage: string | null;
+        createdAt: string;
+    }>;
+    painEvents: Array<{
+        id: number;
+        source: string;
+        score: number;
+        reason: string | null;
+        createdAt: string;
+    }>;
+    gateBlocks: Array<{
+        id: number;
+        toolName: string;
+        reason: string;
+        filePath: string | null;
+        createdAt: string;
+    }>;
+    userCorrections: Array<{
+        id: number;
+        correctionCue: string | null;
+        rawExcerpt: string | null;
+        createdAt: string;
+    }>;
+    principleEvents: Array<{
+        id: number;
+        principleId: string | null;
+        eventType: string;
+        createdAt: string;
+    }>;
+}
+export declare class ControlUiDatabase {
+    private readonly workspaceDir;
+    private readonly dbPath;
+    private readonly blobDir;
+    private readonly db;
+    constructor(opts: ControlUiDatabaseOptions);
+    dispose(): void;
+    recordThinkingModelEvent(input: ThinkingModelEventInput): number;
+    getRecentThinkingContext(sessionId: string, beforeCreatedAt: string, limit?: number): RecentThinkingContext;
+    all<T>(sql: string, ...params: unknown[]): T[];
+    get<T>(sql: string, ...params: unknown[]): T | undefined;
+    restoreRawText(inlineText?: string | null, blobRef?: string | null): string;
+    private initSchema;
+    private withWrite;
+}