principles-disciple 1.127.0 → 1.129.0

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

@@ -1,45 +1,37 @@
 import { resetFriction, getSession } from '../core/session-tracker.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
-import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
 import { normalizeCommandArgs } from '../utils/io.js';
 import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
-import type { EmpathyEventStats } from '../types/event-types.js';
-import type { EvolutionLoopEvent } from '../core/evolution-types.js';
 import { computeHash } from '../utils/hashing.js';
 import { PainToPrincipleService, PrincipleTreeLedgerAdapter } from '@principles/core/runtime-v2';
 import { loadPdConfigForPlugin } from '../core/pd-config-loader.js';
-
 /**
  * Creates a visual progress bar (e.g., [██████░░░░])
  */
-function createProgressBar(value: number, max: number, length = 10): string {
+function createProgressBar(value, max, length = 10) {
     const filledLength = Math.round((value / max) * length);
     const emptyLength = length - filledLength;
     return `[${'█'.repeat(filledLength)}${'░'.repeat(emptyLength)}]`;
 }
-
 /**
  * Creates a mini bar for daily trends
  */
-function createMiniBar(count: number, max: number, length = 6): string {
+function createMiniBar(count, max, length = 6) {
     const filledLength = Math.round((count / max) * length);
     return '█'.repeat(filledLength) + '░'.repeat(length - filledLength);
 }
-
 /**
  * Format empathy stats for display
  */
-function formatEmpathyCard(stats: EmpathyEventStats, range: string, isZh: boolean): string {
+function formatEmpathyCard(stats, range, isZh) {
     if (stats.totalEvents === 0 && stats.dedupedCount === 0) {
         return isZh
             ? `🫀 **情绪事件统计** (${range})\n   暂无数据`
             : `🫀 **Empathy Events** (${range})\n   No data available`;
     }
-
-    const lines: string[] = [];
+    const lines = [];
     lines.push(isZh ? `🫀 **情绪事件统计** (${range})` : `🫀 **Empathy Events** (${range})`);
     lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-
     // Total events
     const totalLabel = isZh ? '📊 总事件' : '📊 Total Events';
     lines.push(`${totalLabel}: ${stats.totalEvents} 次`);
@@ -47,7 +39,6 @@ function formatEmpathyCard(stats: EmpathyEventStats, range: string, isZh: boolea
     lines.push(`   ├─ 😠 moderate: ${stats.bySeverity.moderate} 次 (${stats.scoreBySeverity.moderate}分)`);
     lines.push(`   └─ 😡 severe: ${stats.bySeverity.severe} 次 (${stats.scoreBySeverity.severe}分)`);
     lines.push('');
-
     // Dedupe hit rate
     const dedupeRate = (stats.dedupeHitRate * 100).toFixed(0);
     const dedupeLabel = isZh ? '🔄 去重命中率' : '🔄 Dedupe Hit Rate';
@@ -56,14 +47,12 @@ function formatEmpathyCard(stats: EmpathyEventStats, range: string, isZh: boolea
         lines.push(isZh ? '   ↳ 避免了重复惩罚' : '   ↳ Prevented duplicate penalties');
     }
     lines.push('');
-
     // Rollback info
     if (stats.rollbackCount > 0) {
         const rollbackLabel = isZh ? '↩️ 已回滚' : '↩️ Rolled Back';
         lines.push(`${rollbackLabel}: ${stats.rollbackCount} 次 (${stats.rolledBackScore}分)`);
         lines.push('');
     }
-
     // Daily trend
     if (stats.dailyTrend.length > 1) {
         const trendLabel = isZh ? '📈 趋势 (按天)' : '📈 Trend (by day)';
@@ -75,45 +64,28 @@ function formatEmpathyCard(stats: EmpathyEventStats, range: string, isZh: boolea
             lines.push(`   ${dateStr}: ${bar} ${day.count}次`);
         }
     }
-
     // Detection mode distribution
     if (stats.byDetectionMode.structured > 0 || stats.byDetectionMode.legacy_tag > 0) {
         lines.push('');
         const modeLabel = isZh ? '🔍 检测模式' : '🔍 Detection Mode';
         lines.push(`${modeLabel}: 结构化 ${stats.byDetectionMode.structured} | 标签 ${stats.byDetectionMode.legacy_tag}`);
     }
-
     return lines.join('\n');
 }
-
-/**
- * Extended context interface that includes sessionId injected by the plugin framework.
- * PluginCommandContext does not include sessionId in its type definition.
- */
-interface SessionAwareCommandContext extends PluginCommandContext {
-  sessionId: string;
-}
-
 /**
  * Handles the /pd-status command
  */
-export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResult {
+export function handlePainCommand(ctx) {
     const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'pain');
-    
     const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
-    const lang = (ctx.config?.language as string) || 'en';
+    const lang = ctx.config?.language || 'en';
     const isZh = lang === 'zh';
-    const { sessionId } = ctx as SessionAwareCommandContext;
-
+    const { sessionId } = ctx;
     const args = normalizeCommandArgs(ctx.args).trim();
-
     // Handle empathy subcommand
     if (args.startsWith('empathy')) {
-         
-         
         return handleEmpathySubcommand(wctx, args, sessionId, isZh);
     }
-
     if (args === 'reset') {
         if (sessionId) {
             resetFriction(sessionId);
@@ -121,7 +93,6 @@ export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResul
         }
         return { text: isZh ? `❌ 无法识别当前会话。` : `❌ Session ID not found. Use /pd-status reset in a chat session.` };
     }
-
     if (args === 'data') {
         const stats = wctx.trajectory.getDataStats();
         return {
@@ -130,31 +101,23 @@ export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResul
                 : `Trajectory Data Status\n- DB: ${stats.dbPath}\n- assistant turns: ${stats.assistantTurns}\n- user turns: ${stats.userTurns}\n- tool calls: ${stats.toolCalls}\n- pain events: ${stats.painEvents}\n- pending samples: ${stats.pendingSamples}\n- approved samples: ${stats.approvedSamples}\n- blob bytes: ${stats.blobBytes}\n- last ingest: ${stats.lastIngestAt ?? 'none'}`
         };
     }
-
     // Default: Show status
     const session = sessionId ? getSession(sessionId) : undefined;
     const gfi = session ? session.currentGfi : 0;
-    const {dictionary} = wctx;
+    const { dictionary } = wctx;
     const stats = dictionary.getStats();
-    
     const gfiBar = createProgressBar(gfi, 100, 15);
-    
     // Determine Mental Mode (aligned with prompt.ts logic)
-     
     const mentalMode = isZh
         ? gfi >= 70 ? '🚑 救赎模式 (HUMBLE_RECOVERY)'
-        : gfi >= 40 ? '🤝 安抚模式 (CONCILIATORY)'
-        : '⚡ 高效模式 (EFFICIENT)'
+            : gfi >= 40 ? '🤝 安抚模式 (CONCILIATORY)'
+                : '⚡ 高效模式 (EFFICIENT)'
         : gfi >= 70 ? '🚑 HUMBLE_RECOVERY'
-        : gfi >= 40 ? '🤝 CONCILIATORY'
-        : '⚡ EFFICIENT';
-    
+            : gfi >= 40 ? '🤝 CONCILIATORY'
+                : '⚡ EFFICIENT';
     // Determine health status based on GFI
-     
-     
-    let healthLabel: string;
+    let healthLabel;
     let suggestionText = '';
-
     if (isZh) {
         if (gfi > 80) {
             healthLabel = '极度疲劳 🔴';
@@ -163,10 +126,14 @@ export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResul
    1. 执行 \`/pd-status reset\` 清零疲劳值。
    2. 如果当前上下文太乱，考虑使用 \`/clear\` 开启新会话。`;
         }
-        else if (gfi > 50) healthLabel = '遇到阻力 🟡';
-        else if (gfi > 20) healthLabel = '轻微受挫 🟢';
-        else healthLabel = '运转良好 🟢';
-    } else {
+        else if (gfi > 50)
+            healthLabel = '遇到阻力 🟡';
+        else if (gfi > 20)
+            healthLabel = '轻微受挫 🟢';
+        else
+            healthLabel = '运转良好 🟢';
+    }
+    else {
         if (gfi > 80) {
             healthLabel = 'Critical 🔴';
             suggestionText = `
@@ -175,11 +142,13 @@ export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResul
    2. Ask the AI to reflect deeply before continuing.
    3. Consider starting a new session with \`/clear\`.`;
         }
-        else if (gfi > 50) healthLabel = 'High Friction 🟡';
-        else if (gfi > 20) healthLabel = 'Minor Issues 🟢';
-        else healthLabel = 'Healthy 🟢';
+        else if (gfi > 50)
+            healthLabel = 'High Friction 🟡';
+        else if (gfi > 20)
+            healthLabel = 'Minor Issues 🟢';
+        else
+            healthLabel = 'Healthy 🟢';
     }
-
     // Get session empathy stats for inline display
     const sessionEmpathy = sessionId ? wctx.eventLog.getEmpathyStats('session', sessionId) : null;
     let empathyInline = '';
@@ -188,7 +157,6 @@ export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResul
             ? `\n🫀 **情绪事件 (当前会话)**: ${sessionEmpathy.totalEvents} 次 (${sessionEmpathy.totalPenaltyScore}分)`
             : `\n🫀 **Empathy Events (Session)**: ${sessionEmpathy.totalEvents} (${sessionEmpathy.totalPenaltyScore}pts)`;
     }
-
     if (isZh) {
         let text = `📊 **Principles Disciple - 系统健康度监控**\n`;
         text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
@@ -199,14 +167,15 @@ export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResul
         text += `\n\n🧠 **痛苦进化词典**: 已吸收 ${stats.totalRules} 条规则\n`;
         text += `   ↳ 累计帮您拦截了 ${stats.totalHits} 次无效操作\n`;
         text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
-        
         if (suggestionText) {
             text += suggestionText;
-        } else {
+        }
+        else {
             text += `*💡 提示: 使用 \`/pd-status empathy\` 查看详细情绪事件统计。*`;
         }
         return { text };
-    } else {
+    }
+    else {
         let text = `📊 **Principles Disciple - System Health Monitor**\n`;
         text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
         text += `💊 **Current Friction (GFI)**: ${gfiBar} ${gfi}/100\n`;
@@ -216,37 +185,30 @@ export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResul
         text += `\n\n🧠 **Evolution Dictionary**: ${stats.totalRules} active rules\n`;
         text += `   ↳ Successfully blocked ${stats.totalHits} invalid operations\n`;
         text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
-        
         if (suggestionText) {
             text += suggestionText;
-        } else {
+        }
+        else {
             text += `*💡 Hint: Use \`/pd-status empathy\` to view detailed empathy event statistics.*`;
         }
         return { text };
     }
 }
-
 /**
  * Handle /pd-status empathy subcommand
  */
- 
-     
-function handleEmpathySubcommand(
-    wctx: WorkspaceContext,
-    args: string,
-    sessionId: string | undefined,
-    isZh: boolean
-): PluginCommandResult {
+function handleEmpathySubcommand(wctx, args, sessionId, isZh) {
     // Parse range argument
-    let range: 'today' | 'week' | 'session' = 'today';
+    let range = 'today';
     if (args.includes('--week') || args.includes('-w')) {
         range = 'week';
-    } else if (args.includes('--session') || args.includes('-s')) {
+    }
+    else if (args.includes('--session') || args.includes('-s')) {
         range = 'session';
-    } else if (args.includes('--today') || args.includes('-t')) {
+    }
+    else if (args.includes('--today') || args.includes('-t')) {
         range = 'today';
     }
-
     // Validate session range
     if (range === 'session' && !sessionId) {
         return {
@@ -255,131 +217,118 @@ function handleEmpathySubcommand(
                 : `❌ Session not found. Use this command in a chat session.`
         };
     }
-
     const stats = wctx.eventLog.getEmpathyStats(range, sessionId);
     const rangeLabel = isZh
         ? { today: '今天', week: '最近 7 天', session: '当前会话' }[range]
         : { today: 'Today', week: 'Last 7 Days', session: 'Current Session' }[range];
-
     let text = formatEmpathyCard(stats, rangeLabel, isZh);
-
     // Add usage hint
     if (range === 'today') {
         text += isZh
             ? `\n\n*💡 使用 \`/pd-status empathy --week\` 查看周统计，\`--session\` 查看会话统计。*`
             : `\n\n*💡 Use \`/pd-status empathy --week\` for weekly stats, \`--session\` for session stats.*`;
     }
-
     return { text };
 }
-
-export async function handlePainReportCommand(ctx: PluginCommandContext): Promise<PluginCommandResult> {
-  const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'pain-report');
-  const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
-  const lang = (ctx.config?.language as string) || 'en';
-  const isZh = lang === 'zh';
-  const { sessionId } = ctx as SessionAwareCommandContext;
-  const args = normalizeCommandArgs(ctx.args).trim();
-
-  if (!args) {
-    return {
-      text: isZh
-        ? '❌ 请提供 pain reason。用法: `/pd-pain <描述你遇到的问题>`'
-        : '❌ Please provide a pain reason. Usage: `/pd-pain <describe the issue you encountered>`',
-    };
-  }
-
-  if (!sessionId || sessionId === 'unknown') {
-    return {
-      text: isZh
-        ? '❌ 无法获取当前会话 ID。请在 OpenClaw 对话会话中使用此命令。'
-        : '❌ Session ID not available. Please use this command in an OpenClaw chat session.',
-    };
-  }
-
-  const painId = `manual_${Date.now()}_${computeHash(sessionId).slice(0, 8)}`;
-  const painData = {
-    painId,
-    painType: 'user_frustration' as const,
-    source: 'manual',
-    reason: args,
-    score: 90,
-    sessionId,
-    agentId: 'openclaw-host',
-    provenance: 'openclaw_context_bound' as const,
-  };
-
-  try {
-    const ledgerAdapter = new PrincipleTreeLedgerAdapter({ stateDir: wctx.stateDir });
-    // PRI-306: Load .pd/config.yaml for config-driven runtime binding
-    const configResult = loadPdConfigForPlugin(wctx.workspaceDir);
-    const service = new PainToPrincipleService({
-      workspaceDir: wctx.workspaceDir,
-      stateDir: wctx.stateDir,
-      ledgerAdapter,
-      owner: 'openclaw-plugin',
-      autoIntakeEnabled: true,
-      effectiveConfig: configResult.effective,
-      getEnvVar: (name: string) => process.env[name],
-    });
-
-    const result = await service.recordPain({
-      painId: painData.painId,
-      painType: painData.painType,
-      source: painData.source,
-      reason: painData.reason,
-      score: painData.score,
-      sessionId: painData.sessionId,
-      agentId: painData.agentId,
-      provenance: painData.provenance,
-      recordObservability: true,
-    });
-
-    if (result.status === 'succeeded') {
-      wctx.evolutionReducer.emitSync({
-        ts: new Date().toISOString(),
-        type: 'pain_detected',
-        data: painData,
-      } as EvolutionLoopEvent);
-
-      return {
-        text: isZh
-          ? `✅ Pain 已记录 (context-bound)\n\n📋 **Pain ID**: ${painId}\n📝 **Reason**: ${args}\n🔗 **Provenance**: openclaw_context_bound\n📌 **Session**: ${sessionId}\n\n系统将基于当前会话上下文进行诊断。`
-          : `✅ Pain recorded (context-bound)\n\n📋 **Pain ID**: ${painId}\n📝 **Reason**: ${args}\n🔗 **Provenance**: openclaw_context_bound\n📌 **Session**: ${sessionId}\n\nThe system will diagnose using current session context.`,
-      };
+export async function handlePainReportCommand(ctx) {
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'pain-report');
+    const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
+    const lang = ctx.config?.language || 'en';
+    const isZh = lang === 'zh';
+    const { sessionId } = ctx;
+    const args = normalizeCommandArgs(ctx.args).trim();
+    if (!args) {
+        return {
+            text: isZh
+                ? '❌ 请提供 pain reason。用法: `/pd-pain <描述你遇到的问题>`'
+                : '❌ Please provide a pain reason. Usage: `/pd-pain <describe the issue you encountered>`',
+        };
     }
-
-    if (result.status === 'retried') {
-      const errorInfo = result.failureCategory
-        ? (isZh ? `\n⚠️ **错误类别**: ${result.failureCategory}` : `\n⚠️ **Error category**: ${result.failureCategory}`)
-        : '';
-      const messageInfo = result.message
-        ? (isZh ? `\n📝 **详情**: ${result.message}` : `\n📝 **Detail**: ${result.message}`)
-        : '';
-      return {
-        text: isZh
-          ? `✅ Pain 已记录，诊断任务已进入重试\n\n📋 **Pain ID**: ${result.painId}\n🔧 **Task ID**: ${result.taskId}${errorInfo}${messageInfo}\n\n诊断任务将在后台自动重试。使用 \`/pd-status\` 查看任务状态。`
-          : `✅ Pain recorded, diagnosis task entered retry\n\n📋 **Pain ID**: ${result.painId}\n🔧 **Task ID**: ${result.taskId}${errorInfo}${messageInfo}\n\nThe diagnosis task will retry automatically in the background. Use \`/pd-status\` to check task status.`,
-      };
+    if (!sessionId || sessionId === 'unknown') {
+        return {
+            text: isZh
+                ? '❌ 无法获取当前会话 ID。请在 OpenClaw 对话会话中使用此命令。'
+                : '❌ Session ID not available. Please use this command in an OpenClaw chat session.',
+        };
     }
-
-    // status === 'failed' | 'skipped' | 'degraded' — pain was NOT accepted
-    const reasonInfo = result.failureCategory
-      ? (isZh ? `\n⚠️ **原因**: ${result.failureCategory}` : `\n⚠️ **Reason**: ${result.failureCategory}`)
-      : '';
-    const messageInfo = result.message
-      ? (isZh ? `\n📝 **详情**: ${result.message}` : `\n📝 **Detail**: ${result.message}`)
-      : '';
-    return {
-      text: isZh
-        ? `❌ Pain 记录未成功 (status: ${result.status})${reasonInfo}${messageInfo}\n\n请检查系统日志或使用 \`/pd-status\` 查看状态。`
-        : `❌ Pain recording not accepted (status: ${result.status})${reasonInfo}${messageInfo}\n\nCheck system logs or use \`/pd-status\` for status.`,
+    const painId = `manual_${Date.now()}_${computeHash(sessionId).slice(0, 8)}`;
+    const painData = {
+        painId,
+        painType: 'user_frustration',
+        source: 'manual',
+        reason: args,
+        score: 90,
+        sessionId,
+        agentId: 'openclaw-host',
+        provenance: 'openclaw_context_bound',
     };
-  } catch (err) {
-    return {
-      text: isZh
-        ? `❌ Pain 记录失败: ${String(err)}。请检查系统日志或重试。`
-        : `❌ Failed to record pain: ${String(err)}. Check system logs or try again.`,
-    };
-  }
+    try {
+        const ledgerAdapter = new PrincipleTreeLedgerAdapter({ stateDir: wctx.stateDir });
+        // PRI-306: Load .pd/config.yaml for config-driven runtime binding
+        const configResult = loadPdConfigForPlugin(wctx.workspaceDir);
+        const service = new PainToPrincipleService({
+            workspaceDir: wctx.workspaceDir,
+            stateDir: wctx.stateDir,
+            ledgerAdapter,
+            owner: 'openclaw-plugin',
+            autoIntakeEnabled: true,
+            effectiveConfig: configResult.effective,
+            getEnvVar: (name) => process.env[name],
+        });
+        const result = await service.recordPain({
+            painId: painData.painId,
+            painType: painData.painType,
+            source: painData.source,
+            reason: painData.reason,
+            score: painData.score,
+            sessionId: painData.sessionId,
+            agentId: painData.agentId,
+            provenance: painData.provenance,
+            recordObservability: true,
+        });
+        if (result.status === 'succeeded') {
+            wctx.evolutionReducer.emitSync({
+                ts: new Date().toISOString(),
+                type: 'pain_detected',
+                data: painData,
+            });
+            return {
+                text: isZh
+                    ? `✅ Pain 已记录 (context-bound)\n\n📋 **Pain ID**: ${painId}\n📝 **Reason**: ${args}\n🔗 **Provenance**: openclaw_context_bound\n📌 **Session**: ${sessionId}\n\n系统将基于当前会话上下文进行诊断。`
+                    : `✅ Pain recorded (context-bound)\n\n📋 **Pain ID**: ${painId}\n📝 **Reason**: ${args}\n🔗 **Provenance**: openclaw_context_bound\n📌 **Session**: ${sessionId}\n\nThe system will diagnose using current session context.`,
+            };
+        }
+        if (result.status === 'retried') {
+            const errorInfo = result.failureCategory
+                ? (isZh ? `\n⚠️ **错误类别**: ${result.failureCategory}` : `\n⚠️ **Error category**: ${result.failureCategory}`)
+                : '';
+            const messageInfo = result.message
+                ? (isZh ? `\n📝 **详情**: ${result.message}` : `\n📝 **Detail**: ${result.message}`)
+                : '';
+            return {
+                text: isZh
+                    ? `✅ Pain 已记录，诊断任务已进入重试\n\n📋 **Pain ID**: ${result.painId}\n🔧 **Task ID**: ${result.taskId}${errorInfo}${messageInfo}\n\n诊断任务将在后台自动重试。使用 \`/pd-status\` 查看任务状态。`
+                    : `✅ Pain recorded, diagnosis task entered retry\n\n📋 **Pain ID**: ${result.painId}\n🔧 **Task ID**: ${result.taskId}${errorInfo}${messageInfo}\n\nThe diagnosis task will retry automatically in the background. Use \`/pd-status\` to check task status.`,
+            };
+        }
+        // status === 'failed' | 'skipped' | 'degraded' — pain was NOT accepted
+        const reasonInfo = result.failureCategory
+            ? (isZh ? `\n⚠️ **原因**: ${result.failureCategory}` : `\n⚠️ **Reason**: ${result.failureCategory}`)
+            : '';
+        const messageInfo = result.message
+            ? (isZh ? `\n📝 **详情**: ${result.message}` : `\n📝 **Detail**: ${result.message}`)
+            : '';
+        return {
+            text: isZh
+                ? `❌ Pain 记录未成功 (status: ${result.status})${reasonInfo}${messageInfo}\n\n请检查系统日志或使用 \`/pd-status\` 查看状态。`
+                : `❌ Pain recording not accepted (status: ${result.status})${reasonInfo}${messageInfo}\n\nCheck system logs or use \`/pd-status\` for status.`,
+        };
+    }
+    catch (err) {
+        return {
+            text: isZh
+                ? `❌ Pain 记录失败: ${String(err)}。请检查系统日志或重试。`
+                : `❌ Failed to record pain: ${String(err)}. Check system logs or try again.`,
+        };
+    }
 }

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

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

package/dist/commands/principle-rollback.js

@@ -0,0 +1,26 @@
+import { WorkspaceContext } from '../core/workspace-context.js';
+import { normalizeCommandArgs } from '../utils/io.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
+export function handlePrincipleRollbackCommand(ctx) {
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'principle-rollback');
+    const argText = normalizeCommandArgs(ctx.args).trim();
+    const [principleId = '', ...reasonParts] = argText.split(/\s+/);
+    const reason = (reasonParts.join(' ') || 'manual rollback').trim();
+    const isZh = ctx.config?.language?.startsWith('zh');
+    if (!principleId) {
+        return { text: isZh ? '用法: /pd-principle-rollback <principleId> [reason]' : 'Usage: /pd-principle-rollback <principleId> [reason]' };
+    }
+    // #207/#210: Use WorkspaceContext to get evolutionReducer with stateDir
+    const wctx = WorkspaceContext.fromHookContext({ workspaceDir });
+    const reducer = wctx.evolutionReducer;
+    const principle = reducer.getPrincipleById(principleId);
+    if (!principle) {
+        return { text: isZh ? `未找到原则: ${principleId}` : `Principle not found: ${principleId}` };
+    }
+    reducer.rollbackPrinciple(principleId, reason);
+    return {
+        text: isZh
+            ? `✅ 已回滚原则 ${principleId}\n原因: ${reason}`
+            : `✅ Rolled back principle ${principleId}\nReason: ${reason}`,
+    };
+}

package/dist/commands/promote-impl.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Promote Implementation Command — CLI `/pd-promote-impl`
+ * ========================================================
+ *
+ * PURPOSE: Manually promote a candidate implementation to active status
+ * after replay evaluation review.
+ *
+ * FLOW:
+ *   1. List candidates with replay reports
+ *   2. Show replay report summary for selected candidate
+ *   3. Ask for confirmation
+ *   4. On confirm: transition candidate->active, demote previous active->disabled
+ *
+ * VALIDATION:
+ *   - Candidate must have at least one replay report with 'pass' decision
+ *   - Only candidate -> active is valid for promotion
+ *   - NOTE (PRI-230): The legacy replay generation path has been retired.
+ *     This command is temporarily unavailable for implementations without
+ *     pre-existing replay reports until a Runtime V2 replay entry is wired.
+ */
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+export declare function handlePromoteImplCommand(ctx: PluginCommandContext): PluginCommandResult;