create-principles-disciple 1.0.0 → 1.74.0

package/plugin/dist/commands/context.js

@@ -0,0 +1,293 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
+import { atomicWriteFileSync, normalizeCommandArgs } from '../utils/io.js';
+import { defaultContextConfig } from '../types.js';
+import { loadContextInjectionConfig } from '../hooks/prompt.js';
+/**
+ * Get workspace directory from context
+ */
+function getWorkspaceDir(ctx) {
+    // resolvePluginCommandWorkspaceDir throws on failure — never returns falsy
+    return resolvePluginCommandWorkspaceDir(ctx, 'context');
+}
+/**
+ * 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
+        atomicWriteFileSync(profilePath, JSON.stringify(profile, null, 2));
+        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 |
+| 项目上下文 | ${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 |
+| 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: '思维模型' }[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,
+                projectFocus: 'off',
+                evolutionContext: { ...defaultContextConfig.evolutionContext }
+            };
+            break;
+        case 'standard':
+            config = {
+                thinkingOs: true,
+                projectFocus: 'off',
+                evolutionContext: { ...defaultContextConfig.evolutionContext }
+            };
+            break;
+        case 'full':
+            config = {
+                thinkingOs: 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 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 reflection on/off\` - Toggle Reflection Log
+\`/pd-context focus full/summary/off\` - Set Project Context mode
+
+**Presets**:
+\`/pd-context minimal\` - Minimal mode (core principles only)
+\`/pd-context standard\` - Standard mode (principles + thinking)
+\`/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 = normalizeCommandArgs(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 '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/plugin/dist/commands/disable-impl.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Disable Implementation Command — CLI `/pd-disable-impl`
+ * ========================================================
+ *
+ * PURPOSE: Manually disable an active implementation (e.g., regression in production).
+ *
+ * FLOW:
+ *   1. List active implementations
+ *   2. Select target, ask for reason
+ *   3. Transition active -> disabled (or candidate -> disabled)
+ *   4. Record disabledAt, disabledBy, disabledReason
+ */
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+/**
+ * Handle the /pd-disable-impl command.
+ *
+ * Usage:
+ *   /pd-disable-impl list                        - List active implementations
+ *   /pd-disable-impl <implId>                    - Disable an implementation
+ *   /pd-disable-impl <implId> --reason "<reason>" - Disable with reason
+ */
+export declare function handleDisableImplCommand(ctx: PluginCommandContext): PluginCommandResult;

package/plugin/dist/commands/disable-impl.js

@@ -0,0 +1,118 @@
+/**
+ * Disable Implementation Command — CLI `/pd-disable-impl`
+ * ========================================================
+ *
+ * PURPOSE: Manually disable an active implementation (e.g., regression in production).
+ *
+ * FLOW:
+ *   1. List active implementations
+ *   2. Select target, ask for reason
+ *   3. Transition active -> disabled (or candidate -> disabled)
+ *   4. Record disabledAt, disabledBy, disabledReason
+ */
+import { WorkspaceContext } from '../core/workspace-context.js';
+import { refreshPrincipleLifecycle } from '../core/principle-internalization/lifecycle-refresh.js';
+import { loadLedger, transitionImplementationState, updateImplementation, getAllowedTransitions, } from '../core/principle-tree-ledger.js';
+import { normalizeCommandArgs } from '../utils/io.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
+/**
+ * Get all implementations from the ledger.
+ */
+function getAllImplementations(stateDir) {
+    const ledger = loadLedger(stateDir);
+    return Object.values(ledger.tree.implementations);
+}
+function _handleListActive(stateDir, isZh) {
+    const allImpls = getAllImplementations(stateDir);
+    const activeImpls = allImpls.filter((impl) => impl.lifecycleState === 'active' || impl.lifecycleState === 'candidate');
+    if (activeImpls.length === 0) {
+        return {
+            text: isZh
+                ? '\n\u2139\ufe0f \u6ca1\u6709\u53ef\u7981\u7528\u7684\u5b9e\u73b0\u3002'
+                : '\n\u2139\ufe0f No implementations available to disable.',
+        };
+    }
+    let output = isZh
+        ? '\n\ud83d\udccb \u53ef\u7981\u7528\u5b9e\u73b0\n'
+        : '\n\ud83d\udccb Available Implementations to Disable\n';
+    output += `${'='.repeat(50)}\n`;
+    for (const impl of activeImpls) {
+        const stateLabel = impl.lifecycleState || 'candidate';
+        output += `  ${impl.id}\n`;
+        output += `    Rule: ${impl.ruleId} | State: ${stateLabel} | Version: ${impl.version}\n`;
+        if (impl.disabledReason) {
+            output += `    Previous reason: ${impl.disabledReason}\n`;
+        }
+        output += '\n';
+    }
+    output += isZh
+        ? `\u7528\u6cd5: /pd-disable-impl <implId> --reason "\u539f\u56e0"`
+        : `Usage: /pd-disable-impl <implId> --reason "reason"`;
+    return { text: output };
+}
+function _handleDisableImpl(workspaceDir, stateDir, implId, reason, isZh, sessionId) {
+    const allImpls = getAllImplementations(stateDir);
+    const target = allImpls.find((i) => i.id === implId);
+    if (!target) {
+        return {
+            text: isZh
+                ? `\u274c \u672a\u627e\u5230\u5b9e\u73b0: ${implId}`
+                : `\u274c Implementation not found: ${implId}`,
+        };
+    }
+    const currentState = target.lifecycleState || 'candidate';
+    // Validate: active -> disabled or candidate -> disabled
+    if (currentState !== 'active' && currentState !== 'candidate') {
+        const allowed = getAllowedTransitions(currentState);
+        return {
+            text: isZh
+                ? `\u274c \u5b9e\u73b0 ${implId} \u5f53\u524d\u72b6\u6001: ${currentState}\n\u5141\u8bb8\u8fc7\u6e21: ${allowed.join(', ') || '\u65e0\u8fc7\u6e21'}`
+                : `\u274c Implementation ${implId} is in state: ${currentState}\nAllowed transitions: ${allowed.join(', ') || 'none'}`,
+        };
+    }
+    const reasonText = reason || (isZh ? '\u7528\u6237\u624b\u52a8\u7981\u7528' : 'User manual disable');
+    transitionImplementationState(stateDir, implId, 'disabled');
+    updateImplementation(stateDir, implId, {
+        disabledAt: new Date().toISOString(),
+        disabledBy: sessionId || 'manual',
+        disabledReason: reasonText,
+    });
+    try {
+        refreshPrincipleLifecycle(workspaceDir, stateDir);
+    }
+    catch (err) {
+        console.warn('[disable-impl] Lifecycle refresh failed:', err instanceof Error ? err.stack : err);
+    }
+    return {
+        text: isZh
+            ? `\n\u2705 \u5b9e\u73b0\u5df2\u7981\u7528: ${implId}\n   \u72b6\u6001: ${currentState} -> disabled\n   \u539f\u56e0: ${reasonText}`
+            : `\n\u2705 Implementation disabled: ${implId}\n   State: ${currentState} -> disabled\n   Reason: ${reasonText}`,
+    };
+}
+/**
+ * Handle the /pd-disable-impl command.
+ *
+ * Usage:
+ *   /pd-disable-impl list                        - List active implementations
+ *   /pd-disable-impl <implId>                    - Disable an implementation
+ *   /pd-disable-impl <implId> --reason "<reason>" - Disable with reason
+ */
+export function handleDisableImplCommand(ctx) {
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'disable-impl');
+    const { stateDir } = WorkspaceContext.fromHookContext({ ...ctx, workspaceDir });
+    const lang = ctx.config?.language || 'en';
+    const isZh = lang === 'zh';
+    const args = normalizeCommandArgs(ctx.args).trim();
+    // Parse args: [implId] [--reason "..."]
+    const parts = args.split(/\s+/);
+    const subcommand = parts[0] || '';
+    const implId = subcommand === 'list' ? '' : subcommand;
+    const reasonMatch = (/--reason\s+"([^"]+)"/.exec(args)) || (/--reason\s+(\S+)/.exec(args));
+    const reason = reasonMatch ? reasonMatch[1] : null;
+    // Subcommand: list
+    if (subcommand === 'list' || subcommand === '') {
+        return _handleListActive(stateDir, isZh);
+    }
+    // Disable
+    return _handleDisableImpl(workspaceDir, stateDir, implId, reason, isZh, ctx.sessionId);
+}

package/plugin/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/plugin/dist/commands/evolution-status.js

@@ -0,0 +1,187 @@
+import * as path from 'path';
+import { WorkflowFunnelLoader } from '../core/workflow-funnel-loader.js';
+import { resolvePdPath } from '../core/paths.js';
+import { WorkspaceContext } from '../core/workspace-context.js';
+import { normalizeLanguage } from '../i18n/commands.js';
+import { RuntimeSummaryService } from '../service/runtime-summary-service.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
+function formatNumber(value) {
+    if (value === null || Number.isNaN(value)) {
+        return '--';
+    }
+    return Number.isInteger(value) ? String(value) : value.toFixed(1);
+}
+function formatSources(sources) {
+    if (sources.length === 0) {
+        return '--';
+    }
+    return sources
+        .map((source) => source.score === undefined
+        ? source.source
+        : `${source.source}(${formatNumber(source.score)})`)
+        .join(', ');
+}
+function formatRouteRecommendations(recommendations, emptyLabel) {
+    if (recommendations.length === 0) {
+        return emptyLabel;
+    }
+    return recommendations
+        .slice(0, 3)
+        .map((recommendation) => `${recommendation.principleId}:${recommendation.route}@${formatNumber(recommendation.confidence)}`)
+        .join(', ');
+}
+function buildEnglishOutput(workspaceDir, sessionId, warnings, stats, summary, recommendations) {
+    const lines = [
+        'Evolution Status',
+        '================',
+        '',
+        'Control Plane',
+        `- Session GFI: current ${formatNumber(summary.gfi.current)}, peak ${formatNumber(summary.gfi.peak)} (${summary.gfi.dataQuality})`,
+        `- GFI Sources: ${formatSources(summary.gfi.sources)}`,
+        `- Pain Flag: ${summary.pain.activeFlag ? 'active' : 'inactive'}${summary.pain.activeFlagSource ? ` (${summary.pain.activeFlagSource})` : ''}`,
+        `- Last Pain Signal: ${summary.pain.lastSignal ? `${summary.pain.lastSignal.source}${summary.pain.lastSignal.reason ? ` - ${summary.pain.lastSignal.reason}` : ''}` : '--'}`,
+        `- Gate Events: blocks ${formatNumber(summary.gate.recentBlocks)}, bypasses ${formatNumber(summary.gate.recentBypasses)} (${summary.gate.dataQuality})`,
+        '',
+        'Evolution',
+        `- Queue: pending ${summary.evolution.queue.pending}, in_progress ${summary.evolution.queue.inProgress}, completed ${summary.evolution.queue.completed} (${summary.evolution.dataQuality})`,
+        `- Legacy Directive File: ${summary.phase3.legacyDirectiveFilePresent ? 'present' : 'missing'} (compatibility-only display artifact)`,
+        '- Note: Legacy directive file is NOT a truth source for Phase 3 eligibility. Queue is the only authoritative execution truth source.',
+        `- Active Evolution Task: ${summary.evolution.directive.taskPreview ?? '--'}`,
+        `- Phase 3: ready ${summary.phase3.phase3ShadowEligible ? 'yes' : 'no'}, queueTruthReady ${summary.phase3.queueTruthReady ? 'yes' : 'no'}, eligible ${summary.phase3.evolutionEligible}, reference_only ${summary.phase3.evolutionReferenceOnly}, rejected ${summary.phase3.evolutionRejected}${summary.phase3.evolutionReferenceOnlyReasons.length > 0 ? ` (reference ${summary.phase3.evolutionReferenceOnlyReasons.slice(0, 2).join(', ')})` : ''}${summary.phase3.evolutionRejectedReasons.length > 0 ? ` (${summary.phase3.evolutionRejectedReasons.slice(0, 3).join(', ')})` : ''}`,
+        `- Phase 3 Legacy Directive File: ${summary.phase3.directiveStatus} (${summary.phase3.directiveIgnoredReason})`,
+        '',
+        // D: Heartbeat Diagnostician chain
+        'Heartbeat Diagnostician (Pain → Principle)',
+        `- Pending tasks: ${summary.runtimeDiagnosis.pendingTasks}`,
+        `- Tasks written today: ${summary.runtimeDiagnosis.tasksWrittenToday}`,
+        `- Reports written today: ${summary.runtimeDiagnosis.reportsWrittenToday}`,
+        `- Candidates created today: ${summary.runtimeDiagnosis.candidatesCreatedToday}`,
+        `- Heartbeats injected today: ${summary.runtimeDiagnosis.heartbeatsInjectedToday}`,
+        '',
+        'Principles',
+        `- candidate principles: ${stats.candidateCount}`,
+        `- probation principles: ${stats.probationCount}`,
+        `- active principles: ${stats.activeCount}`,
+        `- deprecated principles: ${stats.deprecatedCount}`,
+        `- last promoted: ${stats.lastPromotedAt ?? 'none'}`,
+        `- internalization routes: ${formatRouteRecommendations(recommendations, '--')}`,
+        '',
+        'Metadata',
+        `- workspace: ${workspaceDir}`,
+        `- session: ${sessionId ?? '--'} (${summary.metadata.selectedSessionReason})`,
+        `- generatedAt: ${summary.metadata.generatedAt}`,
+    ];
+    // E: YAML-driven Workflow Funnels (Phase 6)
+    if (summary.workflowFunnels && summary.workflowFunnels.length > 0) {
+        lines.push('');
+        for (const funnel of summary.workflowFunnels) {
+            lines.push(`Workflow Funnel: ${funnel.funnelLabel}`);
+            for (const stage of funnel.stages) {
+                lines.push(`  - ${stage.label}: ${stage.count}`);
+            }
+        }
+    }
+    if (warnings.length > 0) {
+        lines.push('', 'Warnings');
+        for (const warning of warnings) {
+            lines.push(`- ${warning}`);
+        }
+    }
+    return lines.join('\n');
+}
+function buildChineseOutput(workspaceDir, sessionId, warnings, stats, summary, recommendations) {
+    const lines = [
+        '进化状态',
+        '================',
+        '',
+        '控制面',
+        `- 会话 GFI: 当前 ${formatNumber(summary.gfi.current)}，峰值 ${formatNumber(summary.gfi.peak)} (${summary.gfi.dataQuality})`,
+        `- GFI 来源: ${formatSources(summary.gfi.sources)}`,
+        `- Pain Flag: ${summary.pain.activeFlag ? 'active' : 'inactive'}${summary.pain.activeFlagSource ? ` (${summary.pain.activeFlagSource})` : ''}`,
+        `- 最近 Pain 信号: ${summary.pain.lastSignal ? `${summary.pain.lastSignal.source}${summary.pain.lastSignal.reason ? ` - ${summary.pain.lastSignal.reason}` : ''}` : '--'}`,
+        `- Gate 事件: block ${formatNumber(summary.gate.recentBlocks)}，bypass ${formatNumber(summary.gate.recentBypasses)} (${summary.gate.dataQuality})`,
+        '',
+        '进化',
+        `- 队列: pending ${summary.evolution.queue.pending}，in_progress ${summary.evolution.queue.inProgress}，completed ${summary.evolution.queue.completed} (${summary.evolution.dataQuality})`,
+        `- Legacy Directive File: ${summary.phase3.legacyDirectiveFilePresent ? 'present' : 'missing'}（仅兼容展示）`,
+        '- 注意：Legacy directive file 不是 Phase 3 合格性的真实来源，队列才是唯一权威的执行真相。',
+        `- 当前进化任务: ${summary.evolution.directive.taskPreview ?? '--'}`,
+        `- Phase 3: ready ${summary.phase3.phase3ShadowEligible ? 'yes' : 'no'}，queueTruthReady ${summary.phase3.queueTruthReady ? 'yes' : 'no'}，eligible ${summary.phase3.evolutionEligible}，reference_only ${summary.phase3.evolutionReferenceOnly}，rejected ${summary.phase3.evolutionRejected}${summary.phase3.evolutionReferenceOnlyReasons.length > 0 ? ` (reference ${summary.phase3.evolutionReferenceOnlyReasons.slice(0, 2).join(', ')})` : ''}${summary.phase3.evolutionRejectedReasons.length > 0 ? ` (${summary.phase3.evolutionRejectedReasons.slice(0, 3).join(', ')})` : ''}`,
+        `- Phase 3 Legacy Directive File: ${summary.phase3.directiveStatus} (${summary.phase3.directiveIgnoredReason})`,
+        '',
+        // D: Heartbeat Diagnostician chain
+        '心跳诊断链路（Pain → 原则）',
+        `- 等待处理: ${summary.runtimeDiagnosis.pendingTasks}`,
+        `- 今日写入任务: ${summary.runtimeDiagnosis.tasksWrittenToday}`,
+        `- 今日写入报告: ${summary.runtimeDiagnosis.reportsWrittenToday}`,
+        `- 今日创建候选: ${summary.runtimeDiagnosis.candidatesCreatedToday}`,
+        `- 今日心跳注入: ${summary.runtimeDiagnosis.heartbeatsInjectedToday}`,
+        '',
+        '原则统计',
+        `- 候选原则: ${stats.candidateCount}`,
+        `- 观察期原则: ${stats.probationCount}`,
+        `- 生效原则: ${stats.activeCount}`,
+        `- 已废弃原则: ${stats.deprecatedCount}`,
+        `- 最近晋升: ${stats.lastPromotedAt ?? '无'}`,
+        `- 内化路由: ${formatRouteRecommendations(recommendations, '--')}`,
+        '',
+        '元数据',
+        `- 工作区: ${workspaceDir}`,
+        `- Session: ${sessionId ?? '--'} (${summary.metadata.selectedSessionReason})`,
+        `- 生成时间: ${summary.metadata.generatedAt}`,
+    ];
+    // E: YAML驱动的Workflow Funnels (Phase 6)
+    if (summary.workflowFunnels && summary.workflowFunnels.length > 0) {
+        lines.push('');
+        for (const funnel of summary.workflowFunnels) {
+            lines.push(`Workflow 漏斗: ${funnel.funnelLabel}`);
+            for (const stage of funnel.stages) {
+                lines.push(`  - ${stage.label}: ${stage.count}`);
+            }
+        }
+    }
+    if (warnings.length > 0) {
+        lines.push('', '警告');
+        for (const warning of warnings) {
+            lines.push(`- ${warning}`);
+        }
+    }
+    return lines.join('\n');
+}
+export function handleEvolutionStatusCommand(ctx) {
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'evolution-status');
+    const sessionId = ctx.sessionId ?? null;
+    // #207/#210: Use WorkspaceContext to get evolutionReducer with stateDir
+    const wctx = WorkspaceContext.fromHookContext({ workspaceDir });
+    const reducer = wctx.evolutionReducer;
+    const stats = reducer.getStats();
+    // D-12 / YAML-FUNNEL-02: WorkflowFunnelLoader owns funnel lifecycle per workspace
+    const stateDir = path.dirname(resolvePdPath(workspaceDir, 'WORKFLOWS_YAML'));
+    const loader = new WorkflowFunnelLoader(stateDir);
+    loader.watch();
+    try {
+        const summary = RuntimeSummaryService.getSummary(workspaceDir, {
+            sessionId,
+            loaderWarnings: loader.getWarnings(),
+            funnels: loader.getAllFunnels(),
+        });
+        const recommendations = WorkspaceContext.fromHookContext({ workspaceDir })
+            .principleLifecycle
+            .recomputeAll()
+            .map((assessment) => assessment.routeRecommendation);
+        const rawLang = ctx.config?.language || 'en';
+        const lang = normalizeLanguage(rawLang);
+        const warnings = summary.metadata.warnings.slice(0, 12);
+        if (lang === 'zh') {
+            return {
+                text: buildChineseOutput(workspaceDir, summary.metadata.sessionId, warnings, stats, summary, recommendations),
+            };
+        }
+        return {
+            text: buildEnglishOutput(workspaceDir, summary.metadata.sessionId, warnings, stats, summary, recommendations),
+        };
+    }
+    finally {
+        loader.dispose(); // YAML-FUNNEL-02: guarantee cleanup on all exit paths
+    }
+}

package/plugin/dist/commands/export.d.ts

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