principles-disciple 1.5.4 → 1.7.0

package/dist/commands/context.d.ts

@@ -0,0 +1,5 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+/**
+ * Main command handler
+ */
+export declare function handleContextCommand(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/context.js

@@ -0,0 +1,312 @@
+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
+ */
+function getWorkspaceDir(ctx) {
+    const workspaceDir = ctx.config?.workspaceDir || process.cwd();
+    if (!workspaceDir) {
+        throw new Error('[PD:Context] workspaceDir is required but not provided');
+    }
+    return workspaceDir;
+}
+/**
+ * Save context injection config to PROFILE.json
+ */
+function saveConfig(workspaceDir, config) {
+    const profilePath = path.join(workspaceDir, '.principles', 'PROFILE.json');
+    try {
+        // Ensure directory exists
+        const dir = path.dirname(profilePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Load existing profile or create new one
+        let profile = {};
+        if (fs.existsSync(profilePath)) {
+            const raw = fs.readFileSync(profilePath, 'utf-8');
+            profile = JSON.parse(raw);
+        }
+        // Update contextInjection
+        profile.contextInjection = config;
+        // Write back
+        fs.writeFileSync(profilePath, JSON.stringify(profile, null, 2), 'utf-8');
+        return true;
+    }
+    catch (e) {
+        console.error(`[PD:Context] Failed to save config: ${String(e)}`);
+        return false;
+    }
+}
+/**
+ * Format project focus value for display
+ */
+function formatProjectFocus(value, isZh) {
+    const labels = {
+        full: { zh: '📦 完整', en: '📦 Full' },
+        summary: { zh: '📝 摘要', en: '📝 Summary' },
+        off: { zh: '❌ 关闭', en: '❌ Off' }
+    };
+    return labels[value][isZh ? 'zh' : 'en'];
+}
+/**
+ * Show current context injection status
+ */
+function showStatus(workspaceDir, isZh) {
+    const config = loadContextInjectionConfig(workspaceDir);
+    if (isZh) {
+        return `
+📊 **上下文注入状态**
+
+| 内容 | 状态 | 说明 |
+|------|------|------|
+| 核心原则 | ✅ 始终开启 | 不可关闭 |
+| 思维模型 | ${config.thinkingOs ? '✅ 开启' : '❌ 关闭'} | /pd-context thinking on/off |
+| 信任分数 | ${config.trustScore ? '✅ 开启' : '❌ 关闭'} | /pd-context trust on/off |
+| 反思日志 | ${config.reflectionLog ? '✅ 开启' : '❌ 关闭'} | /pd-context reflection on/off |
+| 项目上下文 | ${formatProjectFocus(config.projectFocus, isZh)} | /pd-context focus full/summary/off |
+
+💡 输入 \`/pd-context help\` 查看更多选项
+`.trim();
+    }
+    else {
+        return `
+📊 **Context Injection Status**
+
+| Content | Status | Control |
+|---------|--------|---------|
+| Core Principles | ✅ Always ON | Not configurable |
+| Thinking OS | ${config.thinkingOs ? '✅ ON' : '❌ OFF'} | /pd-context thinking on/off |
+| Trust Score | ${config.trustScore ? '✅ ON' : '❌ OFF'} | /pd-context trust on/off |
+| Reflection Log | ${config.reflectionLog ? '✅ ON' : '❌ OFF'} | /pd-context reflection on/off |
+| Project Context | ${formatProjectFocus(config.projectFocus, isZh)} | /pd-context focus full/summary/off |
+
+💡 Type \`/pd-context help\` for more options
+`.trim();
+    }
+}
+/**
+ * Toggle a boolean setting
+ */
+function toggleSetting(workspaceDir, key, value, isZh) {
+    const config = loadContextInjectionConfig(workspaceDir);
+    const oldValue = config[key];
+    if (value === 'on') {
+        config[key] = true;
+    }
+    else if (value === 'off') {
+        config[key] = false;
+    }
+    else {
+        return isZh
+            ? `❌ 无效值: "${value}"。使用 "on" 或 "off"。`
+            : `❌ Invalid value: "${value}". Use "on" or "off".`;
+    }
+    const newValue = config[key];
+    const keyName = isZh
+        ? { thinkingOs: '思维模型', trustScore: '信任分数', reflectionLog: '反思日志' }[key]
+        : key;
+    // No change needed
+    if (oldValue === newValue) {
+        return isZh
+            ? `ℹ️ ${keyName} 已经是 ${newValue ? '开启' : '关闭'} 状态`
+            : `ℹ️ ${keyName} is already ${newValue ? 'ON' : 'OFF'}`;
+    }
+    if (saveConfig(workspaceDir, config)) {
+        // Verify the save by re-reading
+        const verifyConfig = loadContextInjectionConfig(workspaceDir);
+        const verifyValue = verifyConfig[key];
+        if (verifyValue !== newValue) {
+            return isZh
+                ? `⚠️ ${keyName} 保存后验证失败，请重试`
+                : `⚠️ ${keyName} verification failed after save, please retry`;
+        }
+        const arrow = isZh ? '→' : '→';
+        const oldLabel = oldValue ? (isZh ? '开启' : 'ON') : (isZh ? '关闭' : 'OFF');
+        const newLabel = newValue ? (isZh ? '开启' : 'ON') : (isZh ? '关闭' : 'OFF');
+        return isZh
+            ? `✅ ${keyName} 已更新: ${oldLabel} ${arrow} ${newLabel}\n\n💡 下次对话时生效`
+            : `✅ ${keyName} updated: ${oldLabel} ${arrow} ${newLabel}\n\n💡 Takes effect on next turn`;
+    }
+    else {
+        return isZh
+            ? `❌ 保存配置失败`
+            : `❌ Failed to save configuration`;
+    }
+}
+/**
+ * Set project focus mode
+ */
+function setProjectFocus(workspaceDir, value, isZh) {
+    const config = loadContextInjectionConfig(workspaceDir);
+    const oldValue = config.projectFocus;
+    const validModes = ['full', 'summary', 'off'];
+    if (!validModes.includes(value)) {
+        return isZh
+            ? `❌ 无效值: "${value}"。使用 "full"、"summary" 或 "off"。`
+            : `❌ Invalid value: "${value}". Use "full", "summary", or "off".`;
+    }
+    const newValue = value;
+    config.projectFocus = newValue;
+    // No change needed
+    if (oldValue === newValue) {
+        return isZh
+            ? `ℹ️ 项目上下文已经是 ${formatProjectFocus(newValue, isZh)} 状态`
+            : `ℹ️ Project context is already ${formatProjectFocus(newValue, isZh)}`;
+    }
+    if (saveConfig(workspaceDir, config)) {
+        // Verify the save by re-reading
+        const verifyConfig = loadContextInjectionConfig(workspaceDir);
+        if (verifyConfig.projectFocus !== newValue) {
+            return isZh
+                ? `⚠️ 项目上下文保存后验证失败，请重试`
+                : `⚠️ Project context verification failed after save, please retry`;
+        }
+        const arrow = '→';
+        return isZh
+            ? `✅ 项目上下文已更新: ${formatProjectFocus(oldValue, isZh)} ${arrow} ${formatProjectFocus(newValue, isZh)}\n\n💡 下次对话时生效`
+            : `✅ Project context updated: ${formatProjectFocus(oldValue, isZh)} ${arrow} ${formatProjectFocus(newValue, isZh)}\n\n💡 Takes effect on next turn`;
+    }
+    else {
+        return isZh
+            ? `❌ 保存配置失败`
+            : `❌ Failed to save configuration`;
+    }
+}
+/**
+ * Apply a preset configuration
+ */
+function applyPreset(workspaceDir, preset, isZh) {
+    let config;
+    switch (preset) {
+        case 'minimal':
+            config = {
+                thinkingOs: false,
+                trustScore: true,
+                reflectionLog: false,
+                projectFocus: 'off',
+                evolutionContext: { ...defaultContextConfig.evolutionContext }
+            };
+            break;
+        case 'standard':
+            config = {
+                thinkingOs: true,
+                trustScore: true,
+                reflectionLog: false,
+                projectFocus: 'off',
+                evolutionContext: { ...defaultContextConfig.evolutionContext }
+            };
+            break;
+        case 'full':
+            config = {
+                thinkingOs: true,
+                trustScore: true,
+                reflectionLog: true,
+                projectFocus: 'summary',
+                evolutionContext: { ...defaultContextConfig.evolutionContext }
+            };
+            break;
+    }
+    if (saveConfig(workspaceDir, config)) {
+        const presetName = isZh
+            ? { minimal: '最小模式', standard: '标准模式', full: '完整模式' }[preset]
+            : `${preset} mode`;
+        return isZh
+            ? `✅ 已应用预设: ${presetName}\n\n${showStatus(workspaceDir, isZh)}`
+            : `✅ Applied preset: ${presetName}\n\n${showStatus(workspaceDir, isZh)}`;
+    }
+    else {
+        return isZh
+            ? `❌ 保存配置失败`
+            : `❌ Failed to save configuration`;
+    }
+}
+/**
+ * Show help message
+ */
+function showHelp(isZh) {
+    if (isZh) {
+        return `
+📖 **/pd-context 命令帮助**
+
+**查看状态**:
+\`/pd-context status\` - 显示当前上下文注入状态
+
+**单项控制**:
+\`/pd-context thinking on/off\` - 开关思维模型
+\`/pd-context trust on/off\` - 开关信任分数
+\`/pd-context reflection on/off\` - 开关反思日志
+\`/pd-context focus full/summary/off\` - 设置项目上下文模式
+
+**预设模式**:
+\`/pd-context minimal\` - 最小模式（仅信任分数）
+\`/pd-context standard\` - 标准模式（原则+思维模型+信任分数）
+\`/pd-context full\` - 完整模式（全部开启）
+
+**注意**: 核心原则始终注入，不可关闭。
+`.trim();
+    }
+    else {
+        return `
+📖 **/pd-context Command Help**
+
+**View Status**:
+\`/pd-context status\` - Show current context injection status
+
+**Individual Control**:
+\`/pd-context thinking on/off\` - Toggle Thinking OS
+\`/pd-context trust on/off\` - Toggle Trust Score
+\`/pd-context reflection on/off\` - Toggle Reflection Log
+\`/pd-context focus full/summary/off\` - Set Project Context mode
+
+**Presets**:
+\`/pd-context minimal\` - Minimal mode (trust score only)
+\`/pd-context standard\` - Standard mode (principles + thinking + trust)
+\`/pd-context full\` - Full mode (all enabled)
+
+**Note**: Core Principles are always injected and cannot be disabled.
+`.trim();
+    }
+}
+/**
+ * Main command handler
+ */
+export function handleContextCommand(ctx) {
+    const workspaceDir = getWorkspaceDir(ctx);
+    const args = (ctx.args || '').trim().split(/\s+/);
+    const subCommand = args[0]?.toLowerCase() || 'status';
+    const value = args[1]?.toLowerCase() || '';
+    // Detect language from context
+    const isZh = ctx.config?.language === 'zh';
+    let result;
+    switch (subCommand) {
+        case 'status':
+            result = showStatus(workspaceDir, isZh);
+            break;
+        case 'thinking':
+            result = toggleSetting(workspaceDir, 'thinkingOs', value, isZh);
+            break;
+        case 'trust':
+            result = toggleSetting(workspaceDir, 'trustScore', value, isZh);
+            break;
+        case 'reflection':
+            result = toggleSetting(workspaceDir, 'reflectionLog', value, isZh);
+            break;
+        case 'focus':
+            result = setProjectFocus(workspaceDir, value, isZh);
+            break;
+        case 'minimal':
+        case 'standard':
+        case 'full':
+            result = applyPreset(workspaceDir, subCommand, isZh);
+            break;
+        case 'help':
+            result = showHelp(isZh);
+            break;
+        default:
+            result = showHelp(isZh);
+    }
+    return { text: result };
+}

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.d.ts

@@ -0,0 +1,14 @@
+/**
+ * /pd-focus 命令 - 管理 CURRENT_FOCUS.md
+ *
+ * 功能：
+ * - status: 查看当前状态和历史版本
+ * - compress: 手动压缩并备份
+ * - history: 查看历史版本列表
+ * - rollback: 回滚到指定历史版本
+ */
+import type { PluginCommandContext, PluginCommandResult, OpenClawPluginApi } from '../openclaw-sdk.js';
+/**
+ * 处理 /pd-focus 命令
+ */
+export declare function handleFocusCommand(ctx: PluginCommandContext, api: OpenClawPluginApi): Promise<PluginCommandResult>;