principles-disciple 1.8.1 → 1.8.2

package/src/commands/capabilities.ts

@@ -0,0 +1,85 @@
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { WorkspaceContext } from '../core/workspace-context.js';
+
+const TOOLS_TO_SCAN = [
+  { name: 'rg', cmd: ['rg', '--version'] },
+  { name: 'sg', cmd: ['sg', '--version'] },
+  { name: 'fd', cmd: ['fd', '--version'] },
+  { name: 'qmd', cmd: ['qmd', '--version'] },
+  { name: 'ast-grep', cmd: ['ast-grep', '--version'] },
+  { name: 'shellcheck', cmd: ['shellcheck', '--version'] },
+];
+
+function scanEnvironment(wctx: WorkspaceContext): any {
+  const tools: Record<string, { available: boolean; version?: string }> = {};
+
+  for (const tool of TOOLS_TO_SCAN) {
+    try {
+      const output = execSync(tool.cmd.join(' '), { stdio: ['ignore', 'pipe', 'ignore'] }).toString();
+      tools[tool.name] = {
+        available: true,
+        version: output.split('\n')[0].trim(),
+      };
+    } catch (_e) {
+      tools[tool.name] = { available: false };
+    }
+  }
+
+  const capabilities = {
+    platform: process.platform,
+    arch: process.arch,
+    node: process.version,
+    tools,
+    timestamp: new Date().toISOString(),
+  };
+
+  const capsPath = wctx.resolve('SYSTEM_CAPABILITIES');
+  const capsDir = path.dirname(capsPath);
+  if (!fs.existsSync(capsDir)) {
+    fs.mkdirSync(capsDir, { recursive: true });
+  }
+  fs.writeFileSync(capsPath, JSON.stringify(capabilities, null, 2), 'utf8');
+
+  return capabilities;
+}
+
+export function handleBootstrapTools(ctx: PluginCommandContext): PluginCommandResult {
+  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
+
+  try {
+    const caps = scanEnvironment(wctx);
+    const toolsMap = caps.tools as Record<string, { available: boolean }>;
+    const available = Object.entries(toolsMap)
+      .filter(([, data]) => data.available)
+      .map(([name]) => `\`${name}\``)
+      .join(', ');
+
+    return {
+      text:
+        `🔍 Environment perception complete.\n` +
+        `**Detected tools:** ${available || '(none)'}\n` +
+        `**Platform:** ${process.platform}\n` +
+        `Capabilities saved to \`.state/SYSTEM_CAPABILITIES.json\`.`,
+    };
+  } catch (err) {
+    return { text: `❌ bootstrap-tools failed: ${err instanceof Error ? err.message : String(err)}` };
+  }
+}
+
+export function handleResearchTools(ctx: PluginCommandContext): PluginCommandResult {
+  const category = ctx.args?.trim() || "modern high-performance CLI tools for coding and architecture";
+  
+  return {
+    text:
+      `🚀 **Tool Evolution Research Initiated**\n\n` +
+      `**Instructions for Agent:**\n` +
+      `1. Use \`google_web_search\` or \`web_search_exa\` to find the latest tools in the category: "${category}".\n` +
+      `2. Compare findings with current capabilities in \`.state/SYSTEM_CAPABILITIES.json\`.\n` +
+      `3. Focus on tools that improve speed (like \`rg\`, \`sg\`), documentation (like \`qmd\`), or automation.\n` +
+      `4. Output a "Tool Upgrade Proposal" with installation commands and justification.`,
+  };
+}

package/{dist/commands/context.js → src/commands/context.ts}

@@ -1,49 +1,56 @@
 import * as fs from 'fs';
 import * as path from 'path';
-import { defaultContextConfig } from '../types.js';
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { ContextInjectionConfig, 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();
+function getWorkspaceDir(ctx: PluginCommandContext): string {
+    const workspaceDir = (ctx.config?.workspaceDir as string) || 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) {
+function saveConfig(workspaceDir: string, config: ContextInjectionConfig): boolean {
     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 = {};
+        let profile: Record<string, unknown> = {};
         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) {
+    } catch (e) {
         console.error(`[PD:Context] Failed to save config: ${String(e)}`);
         return false;
     }
 }
+
 /**
  * Format project focus value for display
  */
-function formatProjectFocus(value, isZh) {
+function formatProjectFocus(value: 'full' | 'summary' | 'off', isZh: boolean): string {
     const labels = {
         full: { zh: '📦 完整', en: '📦 Full' },
         summary: { zh: '📝 摘要', en: '📝 Summary' },
@@ -51,11 +58,13 @@ function formatProjectFocus(value, isZh) {
     };
     return labels[value][isZh ? 'zh' : 'en'];
 }
+
 /**
  * Show current context injection status
  */
-function showStatus(workspaceDir, isZh) {
+function showStatus(workspaceDir: string, isZh: boolean): string {
     const config = loadContextInjectionConfig(workspaceDir);
+    
     if (isZh) {
         return `
 📊 **上下文注入状态**
@@ -69,8 +78,7 @@ function showStatus(workspaceDir, isZh) {
 
 💡 输入 \`/pd-context help\` 查看更多选项
 `.trim();
-    }
-    else {
+    } else {
         return `
 📊 **Context Injection Status**
 
@@ -85,75 +93,95 @@ function showStatus(workspaceDir, isZh) {
 `.trim();
     }
 }
+
 /**
  * Toggle a boolean setting
  */
-function toggleSetting(workspaceDir, key, value, isZh) {
+function toggleSetting(
+    workspaceDir: string,
+    key: 'thinkingOs' | 'reflectionLog',
+    value: string,
+    isZh: boolean
+): string {
     const config = loadContextInjectionConfig(workspaceDir);
     const oldValue = config[key];
+    
     if (value === 'on') {
         config[key] = true;
-    }
-    else if (value === 'off') {
+    } else if (value === 'off') {
         config[key] = false;
-    }
-    else {
-        return isZh
+    } else {
+        return isZh 
             ? `❌ 无效值: "${value}"。使用 "on" 或 "off"。`
             : `❌ Invalid value: "${value}". Use "on" or "off".`;
     }
+    
     const newValue = config[key];
-    const keyName = isZh
+    const keyName = isZh 
         ? { thinkingOs: '思维模型', 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 {
+    } else {
         return isZh
             ? `❌ 保存配置失败`
             : `❌ Failed to save configuration`;
     }
 }
+
 /**
  * Set project focus mode
  */
-function setProjectFocus(workspaceDir, value, isZh) {
+function setProjectFocus(
+    workspaceDir: string,
+    value: string,
+    isZh: boolean
+): string {
     const config = loadContextInjectionConfig(workspaceDir);
     const oldValue = config.projectFocus;
-    const validModes = ['full', 'summary', 'off'];
-    if (!validModes.includes(value)) {
+    const validModes = ['full', 'summary', 'off'] as const;
+    type FocusMode = typeof validModes[number];
+    
+    if (!validModes.includes(value as FocusMode)) {
         return isZh
             ? `❌ 无效值: "${value}"。使用 "full"、"summary" 或 "off"。`
             : `❌ Invalid value: "${value}". Use "full", "summary", or "off".`;
     }
-    const newValue = value;
+    
+    const newValue = value as FocusMode;
     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);
@@ -162,22 +190,29 @@ function setProjectFocus(workspaceDir, value, 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 {
+            ? `✅ 项目上下文已更新: ${formatProjectFocus(oldValue as FocusMode, isZh)} ${arrow} ${formatProjectFocus(newValue, isZh)}\n\n💡 下次对话时生效`
+            : `✅ Project context updated: ${formatProjectFocus(oldValue as FocusMode, 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;
+function applyPreset(
+    workspaceDir: string,
+    preset: 'minimal' | 'standard' | 'full',
+    isZh: boolean
+): string {
+    let config: ContextInjectionConfig;
+    
     switch (preset) {
         case 'minimal':
             config = {
@@ -204,6 +239,7 @@ function applyPreset(workspaceDir, preset, isZh) {
             };
             break;
     }
+    
     if (saveConfig(workspaceDir, config)) {
         const presetName = isZh
             ? { minimal: '最小模式', standard: '标准模式', full: '完整模式' }[preset]
@@ -211,17 +247,17 @@ function applyPreset(workspaceDir, preset, isZh) {
         return isZh
             ? `✅ 已应用预设: ${presetName}\n\n${showStatus(workspaceDir, isZh)}`
             : `✅ Applied preset: ${presetName}\n\n${showStatus(workspaceDir, isZh)}`;
-    }
-    else {
+    } else {
         return isZh
             ? `❌ 保存配置失败`
             : `❌ Failed to save configuration`;
     }
 }
+
 /**
  * Show help message
  */
-function showHelp(isZh) {
+function showHelp(isZh: boolean): string {
     if (isZh) {
         return `
 📖 **/pd-context 命令帮助**
@@ -241,8 +277,7 @@ function showHelp(isZh) {
 
 **注意**: 核心原则始终注入，不可关闭。
 `.trim();
-    }
-    else {
+    } else {
         return `
 📖 **/pd-context Command Help**
 
@@ -263,17 +298,21 @@ function showHelp(isZh) {
 `.trim();
     }
 }
+
 /**
  * Main command handler
  */
-export function handleContextCommand(ctx) {
+export function handleContextCommand(ctx: PluginCommandContext): PluginCommandResult {
     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;
+    const isZh = (ctx.config?.language as string) === 'zh';
+    
+    let result: string;
+    
     switch (subCommand) {
         case 'status':
             result = showStatus(workspaceDir, isZh);
@@ -298,5 +337,6 @@ export function handleContextCommand(ctx) {
         default:
             result = showHelp(isZh);
     }
+    
     return { text: result };
 }

package/src/commands/evolution-status.ts

@@ -0,0 +1,146 @@
+import { EvolutionReducerImpl } from '../core/evolution-reducer.js';
+import { normalizeLanguage } from '../i18n/commands.js';
+import { RuntimeSummaryService } from '../service/runtime-summary-service.js';
+import type { PluginCommandContext } from '../openclaw-sdk.js';
+
+function formatNumber(value: number | null): string {
+  if (value === null || Number.isNaN(value)) {
+    return '--';
+  }
+  return Number.isInteger(value) ? String(value) : value.toFixed(1);
+}
+
+function formatSources(
+  sources: Array<{ source: string; score?: number }>
+): string {
+  if (sources.length === 0) {
+    return '--';
+  }
+
+  return sources
+    .map((source) =>
+      source.score === undefined
+        ? source.source
+        : `${source.source}(${formatNumber(source.score)})`
+    )
+    .join(', ');
+}
+
+function buildEnglishOutput(
+  workspaceDir: string,
+  sessionId: string | null,
+  warnings: string[],
+  stats: ReturnType<EvolutionReducerImpl['getStats']>,
+  summary: ReturnType<typeof RuntimeSummaryService.getSummary>
+): string {
+  const lines: string[] = [
+    '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})`,
+    '',
+    'Principles',
+    `- candidate principles: ${stats.candidateCount}`,
+    `- probation principles: ${stats.probationCount}`,
+    `- active principles: ${stats.activeCount}`,
+    `- deprecated principles: ${stats.deprecatedCount}`,
+    `- last promoted: ${stats.lastPromotedAt ?? 'none'}`,
+    '',
+    'Metadata',
+    `- workspace: ${workspaceDir}`,
+    `- session: ${sessionId ?? '--'} (${summary.metadata.selectedSessionReason})`,
+    `- generatedAt: ${summary.metadata.generatedAt}`,
+  ];
+
+  if (warnings.length > 0) {
+    lines.push('', 'Warnings');
+    for (const warning of warnings) {
+      lines.push(`- ${warning}`);
+    }
+  }
+
+  return lines.join('\n');
+}
+
+function buildChineseOutput(
+  workspaceDir: string,
+  sessionId: string | null,
+  warnings: string[],
+  stats: ReturnType<EvolutionReducerImpl['getStats']>,
+  summary: ReturnType<typeof RuntimeSummaryService.getSummary>
+): string {
+  const lines: string[] = [
+    '进化状态',
+    '================',
+    '',
+    '控制面',
+    `- 会话 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 合格性的真实源。队列是唯一权威的执行真实源。`,
+    `- 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})`,
+    '',
+    '原则统计',
+    `- 候选原则: ${stats.candidateCount}`,
+    `- 观察期原则: ${stats.probationCount}`,
+    `- 生效原则: ${stats.activeCount}`,
+    `- 已废弃原则: ${stats.deprecatedCount}`,
+    `- 最近晋升: ${stats.lastPromotedAt ?? '无'}`,
+    '',
+    '元数据',
+    `- 工作区: ${workspaceDir}`,
+    `- Session: ${sessionId ?? '--'}（${summary.metadata.selectedSessionReason}）`,
+    `- 生成时间: ${summary.metadata.generatedAt}`,
+  ];
+
+  if (warnings.length > 0) {
+    lines.push('', '警告');
+    for (const warning of warnings) {
+      lines.push(`- ${warning}`);
+    }
+  }
+
+  return lines.join('\n');
+}
+
+export function handleEvolutionStatusCommand(ctx: PluginCommandContext): { text: string } {
+  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const sessionId = (ctx as { sessionId?: string | null }).sessionId ?? null;
+  const reducer = new EvolutionReducerImpl({ workspaceDir });
+  const stats = reducer.getStats();
+  const summary = RuntimeSummaryService.getSummary(workspaceDir, { sessionId });
+  const rawLang = (ctx.config?.language as string) || '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),
+    };
+  }
+
+  return {
+    text: buildEnglishOutput(workspaceDir, summary.metadata.sessionId, warnings, stats, summary),
+  };
+}

package/src/commands/export.ts

@@ -0,0 +1,111 @@
+import { WorkspaceContext } from '../core/workspace-context.js';
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { exportORPOSamples, listExports } from '../core/nocturnal-export.js';
+
+function isZh(ctx: PluginCommandContext): boolean {
+  return String(ctx.config?.language || 'en').startsWith('zh');
+}
+
+export function handleExportCommand(ctx: PluginCommandContext): PluginCommandResult {
+  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const zh = isZh(ctx);
+  const args = (ctx.args || '').trim();
+  const parts = args.split(/\s+/).filter(Boolean);
+  const [subcommand = 'corrections'] = parts;
+  const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
+
+  try {
+    if (subcommand === 'orpo') {
+      // Nocturnal ORPO export
+      // Usage: pd-export orpo [--family=<targetModelFamily>]
+      const familyArg = parts.find((p) => p.startsWith('--family='));
+      const targetModelFamily = familyArg ? familyArg.split('=')[1] : undefined;
+
+      const result = exportORPOSamples(workspaceDir, targetModelFamily);
+
+      if (!result.success) {
+        const reasonMap: Record<string, string> = {
+          no_approved_samples: zh
+            ? '没有已批准的样本'
+            : 'No approved samples',
+          family_mismatch: zh
+            ? '没有找到指定模型家族的已批准样本'
+            : 'No approved samples for the specified target model family',
+          all_samples_missing_artifacts: zh
+            ? '所有样本的 artifact 文件都缺失'
+            : 'All sample artifact files are missing',
+        };
+        return {
+          text: zh
+            ? `ORPO 导出失败: ${reasonMap[result.emptyReason ?? ''] ?? result.error}`
+            : `ORPO export failed: ${reasonMap[result.emptyReason ?? ''] ?? result.error}`,
+        };
+      }
+
+      return {
+        text: zh
+          ? `已导出 ORPO 决策点样本到 ${result.manifest!.exportPath}，` +
+              `共 ${result.manifest!.sampleCount} 条，模型家族: ${result.manifest!.targetModelFamily}，` +
+              `数据集指纹: ${result.manifest!.datasetFingerprint.substring(0, 16)}...`
+          : `Exported ORPO decision-point samples to ${result.manifest!.exportPath}, ` +
+              `${result.manifest!.sampleCount} samples, target: ${result.manifest!.targetModelFamily}, ` +
+              `dataset fingerprint: ${result.manifest!.datasetFingerprint.substring(0, 16)}...`,
+      };
+    }
+
+    if (subcommand === 'orpo-list') {
+      // List previous ORPO exports
+      const exports = listExports(workspaceDir);
+      if (exports.length === 0) {
+        return {
+          text: zh
+            ? '没有找到 ORPO 导出记录。'
+            : 'No ORPO exports found.',
+        };
+      }
+      const lines = exports.slice(0, 10).map((e) =>
+        `- ${e.exportId.substring(0, 8)}... | ${e.sampleCount} samples | ${e.targetModelFamily} | ${new Date(e.createdAt).toLocaleDateString()}`
+      );
+      return {
+        text: zh
+          ? `ORPO 导出记录:\n${lines.join('\n')}`
+          : `ORPO exports:\n${lines.join('\n')}`,
+      };
+    }
+
+    if (subcommand !== 'analytics' && subcommand !== 'corrections') {
+      return {
+        text: zh
+          ? '无效的导出类型。请使用 `analytics`、`corrections [--redacted]` 或 `orpo [--family=<target>]`。'
+          : 'Invalid export target. Use `analytics`, `corrections [--redacted]`, or `orpo [--family=<target>]`',
+      };
+    }
+
+    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.',
+    };
+  }
+}