principles-disciple 1.7.5 → 1.7.8

package/dist/commands/context.js

@@ -64,7 +64,6 @@ function showStatus(workspaceDir, isZh) {
 |------|------|------|
 | 核心原则 | ✅ 始终开启 | 不可关闭 |
 | 思维模型 | ${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 |
 
@@ -79,7 +78,6 @@ function showStatus(workspaceDir, isZh) {
 |---------|--------|---------|
 | 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 |
 
@@ -106,7 +104,7 @@ function toggleSetting(workspaceDir, key, value, isZh) {
     }
     const newValue = config[key];
     const keyName = isZh
-        ? { thinkingOs: '思维模型', trustScore: '信任分数', reflectionLog: '反思日志' }[key]
+        ? { thinkingOs: '思维模型', reflectionLog: '反思日志' }[key]
         : key;
     // No change needed
     if (oldValue === newValue) {
@@ -184,7 +182,6 @@ function applyPreset(workspaceDir, preset, isZh) {
         case 'minimal':
             config = {
                 thinkingOs: false,
-                trustScore: true,
                 reflectionLog: false,
                 projectFocus: 'off',
                 evolutionContext: { ...defaultContextConfig.evolutionContext }
@@ -193,7 +190,6 @@ function applyPreset(workspaceDir, preset, isZh) {
         case 'standard':
             config = {
                 thinkingOs: true,
-                trustScore: true,
                 reflectionLog: false,
                 projectFocus: 'off',
                 evolutionContext: { ...defaultContextConfig.evolutionContext }
@@ -202,7 +198,6 @@ function applyPreset(workspaceDir, preset, isZh) {
         case 'full':
             config = {
                 thinkingOs: true,
-                trustScore: true,
                 reflectionLog: true,
                 projectFocus: 'summary',
                 evolutionContext: { ...defaultContextConfig.evolutionContext }
@@ -236,13 +231,12 @@ function showHelp(isZh) {
 
 **单项控制**:
 \`/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 minimal\` - 最小模式（仅核心原则）
+\`/pd-context standard\` - 标准模式（原则+思维模型）
 \`/pd-context full\` - 完整模式（全部开启）
 
 **注意**: 核心原则始终注入，不可关闭。
@@ -257,13 +251,12 @@ function showHelp(isZh) {
 
 **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 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.
@@ -288,9 +281,6 @@ export function handleContextCommand(ctx) {
         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;

package/dist/commands/evolution-status.js

@@ -1,33 +1,12 @@
 import { EvolutionReducerImpl } from '../core/evolution-reducer.js';
 import { normalizeLanguage } from '../i18n/commands.js';
 import { RuntimeSummaryService } from '../service/runtime-summary-service.js';
-function formatAge(ageSeconds, lang) {
-    if (ageSeconds === null) {
-        return '--';
-    }
-    if (ageSeconds < 60) {
-        return lang === 'zh' ? `${ageSeconds} \u79d2` : `${ageSeconds}s`;
-    }
-    const minutes = Math.floor(ageSeconds / 60);
-    if (minutes < 60) {
-        return lang === 'zh' ? `${minutes} \u5206\u949f` : `${minutes}m`;
-    }
-    const hours = Math.floor(minutes / 60);
-    if (hours < 24) {
-        return lang === 'zh' ? `${hours} \u5c0f\u65f6` : `${hours}h`;
-    }
-    const days = Math.floor(hours / 24);
-    return lang === 'zh' ? `${days} \u5929` : `${days}d`;
-}
 function formatNumber(value) {
     if (value === null || Number.isNaN(value)) {
         return '--';
     }
     return Number.isInteger(value) ? String(value) : value.toFixed(1);
 }
-function formatStage(value) {
-    return value === null ? '--' : String(value);
-}
 function formatSources(sources) {
     if (sources.length === 0) {
         return '--';
@@ -44,7 +23,6 @@ function buildEnglishOutput(workspaceDir, sessionId, warnings, stats, summary) {
         '================',
         '',
         'Control Plane',
-        `- Legacy Trust: ${formatNumber(summary.legacyTrust.score)}/100 (stage ${formatStage(summary.legacyTrust.stage)}, legacy/frozen, ${summary.legacyTrust.rewardPolicy})`,
         `- 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})` : ''}`,
@@ -53,9 +31,11 @@ function buildEnglishOutput(workspaceDir, sessionId, warnings, stats, summary) {
         '',
         'Evolution',
         `- Queue: pending ${summary.evolution.queue.pending}, in_progress ${summary.evolution.queue.inProgress}, completed ${summary.evolution.queue.completed} (${summary.evolution.dataQuality})`,
-        `- Directive (derived from queue, compatibility only): ${summary.evolution.directive.exists ? 'present' : 'missing'}, active ${summary.evolution.directive.active === null ? '--' : summary.evolution.directive.active ? 'yes' : 'no'}, age ${formatAge(summary.evolution.directive.ageSeconds, 'en')}`,
-        `- Directive Task: ${summary.evolution.directive.taskPreview ?? '--'}`,
-        `- Phase 3: ready ${summary.phase3.phase3ShadowEligible ? 'yes' : 'no'}, queueTruthReady ${summary.phase3.queueTruthReady ? 'yes' : 'no'}, trustInputReady ${summary.phase3.trustInputReady ? 'yes' : 'no'}, eligible ${summary.phase3.evolutionEligible}, rejected ${summary.phase3.evolutionRejected}${summary.phase3.evolutionRejectedReasons.length > 0 ? ` (${summary.phase3.evolutionRejectedReasons.slice(0, 3).join(', ')})` : ''}${summary.phase3.trustRejectedReasons.length > 0 ? `; trust ${summary.phase3.trustRejectedReasons.slice(0, 2).join(', ')}` : ''}`,
+        `- 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}`,
@@ -79,34 +59,35 @@ function buildEnglishOutput(workspaceDir, sessionId, warnings, stats, summary) {
 }
 function buildChineseOutput(workspaceDir, sessionId, warnings, stats, summary) {
     const lines = [
-        '\u8fdb\u5316\u72b6\u6001',
+        '进化状态',
         '================',
         '',
-        '\u63a7\u5236\u9762',
-        `- Legacy Trust: ${formatNumber(summary.legacyTrust.score)}/100\uff08\u9636\u6bb5 ${formatStage(summary.legacyTrust.stage)}\uff0clegacy/frozen\uff0c${summary.legacyTrust.rewardPolicy}\uff09`,
-        `- \u4f1a\u8bdd GFI: \u5f53\u524d ${formatNumber(summary.gfi.current)}\uff0c\u5cf0\u503c ${formatNumber(summary.gfi.peak)}\uff08${summary.gfi.dataQuality}\uff09`,
-        `- GFI \u6765\u6e90: ${formatSources(summary.gfi.sources)}`,
-        `- Pain Flag: ${summary.pain.activeFlag ? 'active' : 'inactive'}${summary.pain.activeFlagSource ? `\uff08${summary.pain.activeFlagSource}\uff09` : ''}`,
-        `- \u6700\u8fd1 Pain \u4fe1\u53f7: ${summary.pain.lastSignal ? `${summary.pain.lastSignal.source}${summary.pain.lastSignal.reason ? ` - ${summary.pain.lastSignal.reason}` : ''}` : '--'}`,
-        `- Gate \u4e8b\u4ef6: block ${formatNumber(summary.gate.recentBlocks)}\uff0cbypass ${formatNumber(summary.gate.recentBypasses)}\uff08${summary.gate.dataQuality}\uff09`,
+        '控制面',
+        `- 会话 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}）`,
         '',
-        '\u8fdb\u5316',
-        `- \u961f\u5217: pending ${summary.evolution.queue.pending}\uff0cin_progress ${summary.evolution.queue.inProgress}\uff0ccompleted ${summary.evolution.queue.completed}\uff08${summary.evolution.dataQuality}\uff09`,
-        `- Directive\uff08\u7531\u961f\u5217\u6d3e\u751f\uff0c\u517c\u5bb9\u4ec5\uff09: ${summary.evolution.directive.exists ? 'present' : 'missing'}\uff0cactive ${summary.evolution.directive.active === null ? '--' : summary.evolution.directive.active ? 'yes' : 'no'}\uff0cage ${formatAge(summary.evolution.directive.ageSeconds, 'zh')}`,
-        `- Directive \u4efb\u52a1: ${summary.evolution.directive.taskPreview ?? '--'}`,
-        `- Phase 3: ready ${summary.phase3.phase3ShadowEligible ? 'yes' : 'no'}\uff0cqueueTruthReady ${summary.phase3.queueTruthReady ? 'yes' : 'no'}\uff0ctrustInputReady ${summary.phase3.trustInputReady ? 'yes' : 'no'}\uff0celigible ${summary.phase3.evolutionEligible}\uff0crejected ${summary.phase3.evolutionRejected}${summary.phase3.evolutionRejectedReasons.length > 0 ? `\uff08${summary.phase3.evolutionRejectedReasons.slice(0, 3).join(', ')}\uff09` : ''}${summary.phase3.trustRejectedReasons.length > 0 ? `\uff1btrust ${summary.phase3.trustRejectedReasons.slice(0, 2).join(', ')}` : ''}`,
+        '进化',
+        `- 队列: 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})`,
         '',
-        '\u539f\u5219\u7edf\u8ba1',
-        `- \u5019\u9009\u539f\u5219: ${stats.candidateCount}`,
-        `- \u89c2\u5bdf\u671f\u539f\u5219: ${stats.probationCount}`,
-        `- \u751f\u6548\u539f\u5219: ${stats.activeCount}`,
-        `- \u5df2\u5e9f\u5f03\u539f\u5219: ${stats.deprecatedCount}`,
-        `- \u6700\u8fd1\u664b\u5347: ${stats.lastPromotedAt ?? '\u65e0'}`,
+        '原则统计',
+        `- 候选原则: ${stats.candidateCount}`,
+        `- 观察期原则: ${stats.probationCount}`,
+        `- 生效原则: ${stats.activeCount}`,
+        `- 已废弃原则: ${stats.deprecatedCount}`,
+        `- 最近晋升: ${stats.lastPromotedAt ?? '无'}`,
         '',
-        '\u5143\u6570\u636e',
-        `- \u5de5\u4f5c\u533a: ${workspaceDir}`,
-        `- Session: ${sessionId ?? '--'}\uff08${summary.metadata.selectedSessionReason}\uff09`,
-        `- \u751f\u6210\u65f6\u95f4: ${summary.metadata.generatedAt}`,
+        '元数据',
+        `- 工作区: ${workspaceDir}`,
+        `- Session: ${sessionId ?? '--'}（${summary.metadata.selectedSessionReason}）`,
+        `- 生成时间: ${summary.metadata.generatedAt}`,
     ];
     if (warnings.length > 0) {
         lines.push('', '警告');

package/dist/commands/export.js

@@ -1,4 +1,5 @@
 import { WorkspaceContext } from '../core/workspace-context.js';
+import { exportORPOSamples, listExports } from '../core/nocturnal-export.js';
 function isZh(ctx) {
     return String(ctx.config?.language || 'en').startsWith('zh');
 }
@@ -6,16 +7,68 @@ 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 parts = args.split(/\s+/).filter(Boolean);
+    const [subcommand = 'corrections'] = parts;
     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 === '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 = {
+                    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 {

package/dist/commands/nocturnal-review.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Nocturnal Review Command — Human Review Queue for Nocturnal Dataset
+ * =================================================================
+ *
+ * PURPOSE: Provide human review gateway before training export.
+ * Reviews operate on nocturnal dataset records, NOT on artifact files directly.
+ *
+ * COMMAND SHAPE:
+ *   pd-nocturnal-review list                        — list pending review samples
+ *   pd-nocturnal-review approve <fingerprint> [reason]  — approve for training
+ *   pd-nocturnal-review reject <fingerprint> [reason]  — reject sample
+ *   pd-nocturnal-review show <fingerprint>           — show sample lineage summary
+ *   pd-nocturnal-review set-family <fingerprint> <family> — set target model family
+ *   pd-nocturnal-review stats                        — show dataset statistics
+ *
+ * DESIGN CONSTRAINTS:
+ *   - Review state lives in dataset registry, not in artifacts
+ *   - approve/reject require reason (unless default is provided)
+ *   - Rejected samples cannot enter export
+ *   - Superseded samples cannot enter export
+ *   - No Web UI (CLI only)
+ */
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+export declare function handleNocturnalReviewCommand(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/nocturnal-review.js

@@ -0,0 +1,265 @@
+/**
+ * Nocturnal Review Command — Human Review Queue for Nocturnal Dataset
+ * =================================================================
+ *
+ * PURPOSE: Provide human review gateway before training export.
+ * Reviews operate on nocturnal dataset records, NOT on artifact files directly.
+ *
+ * COMMAND SHAPE:
+ *   pd-nocturnal-review list                        — list pending review samples
+ *   pd-nocturnal-review approve <fingerprint> [reason]  — approve for training
+ *   pd-nocturnal-review reject <fingerprint> [reason]  — reject sample
+ *   pd-nocturnal-review show <fingerprint>           — show sample lineage summary
+ *   pd-nocturnal-review set-family <fingerprint> <family> — set target model family
+ *   pd-nocturnal-review stats                        — show dataset statistics
+ *
+ * DESIGN CONSTRAINTS:
+ *   - Review state lives in dataset registry, not in artifacts
+ *   - approve/reject require reason (unless default is provided)
+ *   - Rejected samples cannot enter export
+ *   - Superseded samples cannot enter export
+ *   - No Web UI (CLI only)
+ */
+import * as fs from 'fs';
+import { listDatasetRecords, getDatasetRecord, updateReviewStatus, updateTargetModelFamily, getDatasetStats, } from '../core/nocturnal-dataset.js';
+function isZh(ctx) {
+    return String(ctx.config?.language || 'en').startsWith('zh');
+}
+function formatRecord(record, includeDetails = false) {
+    const lines = [];
+    lines.push(`  sampleFingerprint: ${record.sampleFingerprint.substring(0, 16)}...`);
+    lines.push(`  artifactId: ${record.artifactId}`);
+    lines.push(`  sessionId: ${record.sessionId}`);
+    lines.push(`  principleId: ${record.principleId}`);
+    lines.push(`  targetModelFamily: ${record.targetModelFamily ?? '(none)'}`);
+    lines.push(`  reviewStatus: ${record.reviewStatus}`);
+    if (record.reviewReason) {
+        lines.push(`  reviewReason: ${record.reviewReason}`);
+    }
+    lines.push(`  createdAt: ${new Date(record.createdAt).toLocaleString('en-US')}`);
+    if (includeDetails) {
+        const artifactPath = record.artifactPath;
+        if (fs.existsSync(artifactPath)) {
+            try {
+                const content = fs.readFileSync(artifactPath, 'utf-8');
+                const artifact = JSON.parse(content);
+                lines.push(`  artifact: ${artifactPath}`);
+                if (artifact.badDecision) {
+                    lines.push(`  badDecision: ${artifact.badDecision.substring(0, 80)}...`);
+                }
+                if (artifact.betterDecision) {
+                    lines.push(`  betterDecision: ${artifact.betterDecision.substring(0, 80)}...`);
+                }
+                if (artifact.rationale) {
+                    lines.push(`  rationale: ${artifact.rationale.substring(0, 80)}...`);
+                }
+            }
+            catch {
+                lines.push(`  artifact: (could not read)`);
+            }
+        }
+        else {
+            lines.push(`  artifact: ${artifactPath} (MISSING)`);
+        }
+    }
+    return lines.join('\n');
+}
+function statusLabel(status, zh) {
+    const labels = {
+        pending_review: { zh: '待审核', en: 'pending_review' },
+        approved_for_training: { zh: '已批准', en: 'approved_for_training' },
+        rejected: { zh: '已拒绝', en: 'rejected' },
+        superseded: { zh: '已替代', en: 'superseded' },
+    };
+    return labels[status][zh ? 'zh' : 'en'];
+}
+export function handleNocturnalReviewCommand(ctx) {
+    const workspaceDir = ctx.config?.workspaceDir || process.cwd();
+    const zh = isZh(ctx);
+    const args = (ctx.args || '').trim();
+    const parts = args.split(/\s+/).filter(Boolean);
+    const [action = 'list'] = parts;
+    try {
+        if (action === 'list') {
+            const pending = listDatasetRecords(workspaceDir, { reviewStatus: 'pending_review' });
+            const all = listDatasetRecords(workspaceDir);
+            if (pending.length === 0) {
+                return {
+                    text: zh
+                        ? '没有待审核的 nocturnal 样本。'
+                        : 'No pending nocturnal samples for review.',
+                };
+            }
+            const lines = pending.map((r) => {
+                const label = statusLabel(r.reviewStatus, zh);
+                return `[${label}] ${r.sampleFingerprint.substring(0, 16)}... | ${r.principleId} | ${r.targetModelFamily ?? '(no family)'}`;
+            });
+            return {
+                text: zh
+                    ? `待审核样本 (${pending.length}/${all.length}):\n${lines.join('\n')}\n\n使用 /pd-nocturnal-review show <fingerprint> 查看详情。`
+                    : `Pending review samples (${pending.length}/${all.length}):\n${lines.join('\n')}\n\nUse /pd-nocturnal-review show <fingerprint> for details.`,
+            };
+        }
+        if (action === 'show') {
+            const fingerprint = parts[1];
+            if (!fingerprint) {
+                return {
+                    text: zh
+                        ? '用法: /pd-nocturnal-review show <fingerprint>'
+                        : 'Usage: /pd-nocturnal-review show <fingerprint>',
+                };
+            }
+            const record = getDatasetRecord(workspaceDir, fingerprint);
+            if (!record) {
+                return {
+                    text: zh
+                        ? `未找到样本: ${fingerprint}`
+                        : `Sample not found: ${fingerprint}`,
+                };
+            }
+            const details = formatRecord(record, true);
+            return {
+                text: zh
+                    ? `样本详情:\n${details}`
+                    : `Sample details:\n${details}`,
+            };
+        }
+        if (action === 'approve') {
+            const fingerprint = parts[1];
+            const reason = parts.slice(2).join(' ') || (zh ? 'Approved by human reviewer' : 'Approved by human reviewer');
+            if (!fingerprint) {
+                return {
+                    text: zh
+                        ? '用法: /pd-nocturnal-review approve <fingerprint> [reason]'
+                        : 'Usage: /pd-nocturnal-review approve <fingerprint> [reason]',
+                };
+            }
+            const record = getDatasetRecord(workspaceDir, fingerprint);
+            if (!record) {
+                return {
+                    text: zh
+                        ? `未找到样本: ${fingerprint}`
+                        : `Sample not found: ${fingerprint}`,
+                };
+            }
+            if (record.reviewStatus === 'approved_for_training') {
+                return {
+                    text: zh
+                        ? `样本已是 approved_for_training 状态。`
+                        : `Sample is already approved_for_training.`,
+                };
+            }
+            if (record.reviewStatus === 'rejected') {
+                return {
+                    text: zh
+                        ? `样本已被 rejected，需要先重置为 pending_review 才能重新审核。`
+                        : `Sample is rejected. Reset to pending_review first before re-reviewing.`,
+                };
+            }
+            if (record.reviewStatus === 'superseded') {
+                return {
+                    text: zh
+                        ? `样本已被 superseded，无法更改。`
+                        : `Sample is superseded and cannot be changed.`,
+                };
+            }
+            const updated = updateReviewStatus(workspaceDir, fingerprint, 'approved_for_training', reason);
+            return {
+                text: zh
+                    ? `样本已批准用于训练:\n  fingerprint: ${updated.sampleFingerprint.substring(0, 16)}...\n  principleId: ${updated.principleId}\n  targetModelFamily: ${updated.targetModelFamily ?? '(none)'}\n  reason: ${updated.reviewReason}`
+                    : `Sample approved for training:\n  fingerprint: ${updated.sampleFingerprint.substring(0, 16)}...\n  principleId: ${updated.principleId}\n  targetModelFamily: ${updated.targetModelFamily ?? '(none)'}\n  reason: ${updated.reviewReason}`,
+            };
+        }
+        if (action === 'reject') {
+            const fingerprint = parts[1];
+            const reason = parts.slice(2).join(' ') || (zh ? 'Rejected by human reviewer' : 'Rejected by human reviewer');
+            if (!fingerprint) {
+                return {
+                    text: zh
+                        ? '用法: /pd-nocturnal-review reject <fingerprint> [reason]'
+                        : 'Usage: /pd-nocturnal-review reject <fingerprint> [reason]',
+                };
+            }
+            const record = getDatasetRecord(workspaceDir, fingerprint);
+            if (!record) {
+                return {
+                    text: zh
+                        ? `未找到样本: ${fingerprint}`
+                        : `Sample not found: ${fingerprint}`,
+                };
+            }
+            if (record.reviewStatus === 'rejected') {
+                return {
+                    text: zh
+                        ? `样本已是 rejected 状态。`
+                        : `Sample is already rejected.`,
+                };
+            }
+            if (record.reviewStatus === 'superseded') {
+                return {
+                    text: zh
+                        ? `样本已被 superseded，无法更改。`
+                        : `Sample is superseded and cannot be changed.`,
+                };
+            }
+            const updated = updateReviewStatus(workspaceDir, fingerprint, 'rejected', reason);
+            return {
+                text: zh
+                    ? `样本已拒绝:\n  fingerprint: ${updated.sampleFingerprint.substring(0, 16)}...\n  reason: ${updated.reviewReason}`
+                    : `Sample rejected:\n  fingerprint: ${updated.sampleFingerprint.substring(0, 16)}...\n  reason: ${updated.reviewReason}`,
+            };
+        }
+        if (action === 'set-family') {
+            const fingerprint = parts[1];
+            const family = parts[2];
+            if (!fingerprint || !family) {
+                return {
+                    text: zh
+                        ? '用法: /pd-nocturnal-review set-family <fingerprint> <model-family>'
+                        : 'Usage: /pd-nocturnal-review set-family <fingerprint> <model-family>',
+                };
+            }
+            const record = getDatasetRecord(workspaceDir, fingerprint);
+            if (!record) {
+                return {
+                    text: zh
+                        ? `未找到样本: ${fingerprint}`
+                        : `Sample not found: ${fingerprint}`,
+                };
+            }
+            if (record.reviewStatus === 'superseded') {
+                return {
+                    text: zh
+                        ? `样本已被 superseded，无法修改模型家族。`
+                        : `Sample is superseded and cannot be modified.`,
+                };
+            }
+            const updated = updateTargetModelFamily(workspaceDir, fingerprint, family);
+            return {
+                text: zh
+                    ? `已设置目标模型家族:\n  fingerprint: ${updated.sampleFingerprint.substring(0, 16)}...\n  targetModelFamily: ${updated.targetModelFamily}`
+                    : `Target model family set:\n  fingerprint: ${updated.sampleFingerprint.substring(0, 16)}...\n  targetModelFamily: ${updated.targetModelFamily}`,
+            };
+        }
+        if (action === 'stats') {
+            const stats = getDatasetStats(workspaceDir);
+            return {
+                text: zh
+                    ? `Nocturnal Dataset 统计:\n  总样本数: ${stats.total}\n  待审核: ${stats.pendingReview}\n  已批准训练: ${stats.approvedForTraining}\n  已拒绝: ${stats.rejected}\n  已替代: ${stats.superseded}\n  可导出 (按家族): ${Object.entries(stats.exportReadyByFamily).map(([f, c]) => `${f}: ${c}`).join(', ') || '无'}`
+                    : `Nocturnal Dataset Stats:\n  Total: ${stats.total}\n  Pending review: ${stats.pendingReview}\n  Approved for training: ${stats.approvedForTraining}\n  Rejected: ${stats.rejected}\n  Superseded: ${stats.superseded}\n  Export-ready (by family): ${Object.entries(stats.exportReadyByFamily).map(([f, c]) => `${f}: ${c}`).join(', ') || 'none'}`,
+            };
+        }
+        return {
+            text: zh
+                ? `未知操作: ${action}\n用法:\n  /pd-nocturnal-review list\n  /pd-nocturnal-review show <fingerprint>\n  /pd-nocturnal-review approve <fingerprint> [reason]\n  /pd-nocturnal-review reject <fingerprint> [reason]\n  /pd-nocturnal-review set-family <fingerprint> <model-family>\n  /pd-nocturnal-review stats`
+                : `Unknown action: ${action}\nUsage:\n  /pd-nocturnal-review list\n  /pd-nocturnal-review show <fingerprint>\n  /pd-nocturnal-review approve <fingerprint> [reason]\n  /pd-nocturnal-review reject <fingerprint> [reason]\n  /pd-nocturnal-review set-family <fingerprint> <model-family>\n  /pd-nocturnal-review stats`,
+        };
+    }
+    catch (err) {
+        return {
+            text: zh
+                ? `审核操作失败: ${String(err)}`
+                : `Review operation failed: ${String(err)}`,
+        };
+    }
+}

package/dist/commands/nocturnal-rollout.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Nocturnal Rollout Command Handler
+ * =================================
+ *
+ * Plugin command handler for nocturnal rollout and promotion operations.
+ * Provides commands for:
+ * - evaluate-promotion: Evaluate if checkpoint passes promotion gate
+ * - advance-promotion: Advance checkpoint promotion state
+ * - bind: Bind checkpoint to worker profile
+ * - enable-routing: Enable routing for a profile
+ * - disable-routing: Disable routing for a profile
+ * - rollback: Rollback deployment to previous checkpoint
+ * - status: Show deployment status for profiles
+ * - show-promotion: Show promotion record for a checkpoint
+ *
+ * Usage:
+ *   /nocturnal-rollout evaluate-promotion <checkpointId> [--profile=<profile>]
+ *   /nocturnal-rollout advance-promotion <checkpointId> [--profile=<profile>] [--review]
+ *   /nocturnal-rollout bind <checkpointId> --profile=<profile>
+ *   /nocturnal-rollout enable-routing <profile>
+ *   /nocturnal-rollout disable-routing <profile>
+ *   /nocturnal-rollout rollback <profile>
+ *   /nocturnal-rollout status [--profile=<profile>]
+ *   /nocturnal-rollout show-promotion <checkpointId>
+ */
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+export declare function handleNocturnalRolloutCommand(ctx: PluginCommandContext): PluginCommandResult;