create-principles-disciple 1.0.0 → 1.74.0

package/plugin/dist/commands/pain.js

@@ -0,0 +1,309 @@
+import { resetFriction, getSession } from '../core/session-tracker.js';
+import { WorkspaceContext } from '../core/workspace-context.js';
+import { normalizeCommandArgs } from '../utils/io.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
+import { computeHash } from '../utils/hashing.js';
+import { PainToPrincipleService, PrincipleTreeLedgerAdapter } from '@principles/core/runtime-v2';
+/**
+ * Creates a visual progress bar (e.g., [██████░░░░])
+ */
+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, max, length = 6) {
+    const filledLength = Math.round((count / max) * length);
+    return '█'.repeat(filledLength) + '░'.repeat(length - filledLength);
+}
+/**
+ * Format empathy stats for display
+ */
+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 = [];
+    lines.push(isZh ? `🫀 **情绪事件统计** (${range})` : `🫀 **Empathy Events** (${range})`);
+    lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    // Total events
+    const totalLabel = isZh ? '📊 总事件' : '📊 Total Events';
+    lines.push(`${totalLabel}: ${stats.totalEvents} 次`);
+    lines.push(`   ├─ 😟 mild: ${stats.bySeverity.mild} 次 (${stats.scoreBySeverity.mild}分)`);
+    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';
+    lines.push(`${dedupeLabel}: ${dedupeRate}% (${stats.dedupedCount}/${stats.totalEvents + stats.dedupedCount})`);
+    if (stats.dedupedCount > 0) {
+        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)';
+        lines.push(`${trendLabel}:`);
+        const maxCount = Math.max(...stats.dailyTrend.map(d => d.count), 1);
+        for (const day of stats.dailyTrend) {
+            const bar = createMiniBar(day.count, maxCount, 6);
+            const dateStr = day.date.slice(5); // MM-DD
+            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');
+}
+/**
+ * Handles the /pd-status command
+ */
+export function handlePainCommand(ctx) {
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'pain');
+    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();
+    // Handle empathy subcommand
+    if (args.startsWith('empathy')) {
+        return handleEmpathySubcommand(wctx, args, sessionId, isZh);
+    }
+    if (args === 'reset') {
+        if (sessionId) {
+            resetFriction(sessionId);
+            return { text: isZh ? `✅ 当前会话的 GFI 阻力已强制归零。` : `✅ GFI for current session reset to 0.` };
+        }
+        return { text: isZh ? `❌ 无法识别当前会话。` : `❌ Session ID not found. Use /pd-status reset in a chat session.` };
+    }
+    if (args === 'data') {
+        const stats = wctx.trajectory.getDataStats();
+        return {
+            text: isZh
+                ? `轨迹数据状态\n- 数据库: ${stats.dbPath}\n- 助手轮次: ${stats.assistantTurns}\n- 用户轮次: ${stats.userTurns}\n- 工具调用: ${stats.toolCalls}\n- 痛感事件: ${stats.painEvents}\n- 待审核样本: ${stats.pendingSamples}\n- 已通过样本: ${stats.approvedSamples}\n- Blob 字节数: ${stats.blobBytes}\n- 最近写入: ${stats.lastIngestAt ?? 'none'}`
+                : `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 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 >= 70 ? '🚑 HUMBLE_RECOVERY'
+            : gfi >= 40 ? '🤝 CONCILIATORY'
+                : '⚡ EFFICIENT';
+    // Determine health status based on GFI
+    let healthLabel;
+    let suggestionText = '';
+    if (isZh) {
+        if (gfi > 80) {
+            healthLabel = '极度疲劳 🔴';
+            suggestionText = `
+💡 **建议 (系统检测到您当前遇到较大阻力)**:
+   1. 执行 \`/pd-status reset\` 清零疲劳值。
+   2. 如果当前上下文太乱，考虑使用 \`/clear\` 开启新会话。`;
+        }
+        else if (gfi > 50)
+            healthLabel = '遇到阻力 🟡';
+        else if (gfi > 20)
+            healthLabel = '轻微受挫 🟢';
+        else
+            healthLabel = '运转良好 🟢';
+    }
+    else {
+        if (gfi > 80) {
+            healthLabel = 'Critical 🔴';
+            suggestionText = `
+💡 **Suggestion (High friction detected)**:
+   1. Run \`/pd-status reset\` to clear friction.
+   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 🟢';
+    }
+    // Get session empathy stats for inline display
+    const sessionEmpathy = sessionId ? wctx.eventLog.getEmpathyStats('session', sessionId) : null;
+    let empathyInline = '';
+    if (sessionEmpathy && sessionEmpathy.totalEvents > 0) {
+        empathyInline = isZh
+            ? `\n🫀 **情绪事件 (当前会话)**: ${sessionEmpathy.totalEvents} 次 (${sessionEmpathy.totalPenaltyScore}分)`
+            : `\n🫀 **Empathy Events (Session)**: ${sessionEmpathy.totalEvents} (${sessionEmpathy.totalPenaltyScore}pts)`;
+    }
+    if (isZh) {
+        let text = `📊 **Principles Disciple - 系统健康度监控**\n`;
+        text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
+        text += `💊 **当前疲劳指数 (GFI)**: ${gfiBar} ${gfi}/100\n`;
+        text += `🧠 **当前心智模式**: ${mentalMode}\n`;
+        text += `   ↳ 状态诊断: ${healthLabel}\n`;
+        text += empathyInline;
+        text += `\n\n🧠 **痛苦进化词典**: 已吸收 ${stats.totalRules} 条规则\n`;
+        text += `   ↳ 累计帮您拦截了 ${stats.totalHits} 次无效操作\n`;
+        text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
+        if (suggestionText) {
+            text += suggestionText;
+        }
+        else {
+            text += `*💡 提示: 使用 \`/pd-status empathy\` 查看详细情绪事件统计。*`;
+        }
+        return { text };
+    }
+    else {
+        let text = `📊 **Principles Disciple - System Health Monitor**\n`;
+        text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
+        text += `💊 **Current Friction (GFI)**: ${gfiBar} ${gfi}/100\n`;
+        text += `🧠 **Current Mental Mode**: ${mentalMode}\n`;
+        text += `   ↳ Diagnosis: ${healthLabel}\n`;
+        text += empathyInline;
+        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 {
+            text += `*💡 Hint: Use \`/pd-status empathy\` to view detailed empathy event statistics.*`;
+        }
+        return { text };
+    }
+}
+/**
+ * Handle /pd-status empathy subcommand
+ */
+function handleEmpathySubcommand(wctx, args, sessionId, isZh) {
+    // Parse range argument
+    let range = 'today';
+    if (args.includes('--week') || args.includes('-w')) {
+        range = 'week';
+    }
+    else if (args.includes('--session') || args.includes('-s')) {
+        range = 'session';
+    }
+    else if (args.includes('--today') || args.includes('-t')) {
+        range = 'today';
+    }
+    // Validate session range
+    if (range === 'session' && !sessionId) {
+        return {
+            text: isZh
+                ? `❌ 无法获取会话统计，请在聊天会话中使用此命令。`
+                : `❌ 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) {
+    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 (!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',
+        source: 'manual',
+        reason: args,
+        score: 90,
+        sessionId,
+        agentId: 'openclaw-host',
+        provenance: 'openclaw_context_bound',
+    };
+    try {
+        const ledgerAdapter = new PrincipleTreeLedgerAdapter({ stateDir: wctx.stateDir });
+        const service = new PainToPrincipleService({
+            workspaceDir: wctx.workspaceDir,
+            stateDir: wctx.stateDir,
+            ledgerAdapter,
+            owner: 'openclaw-plugin',
+            autoIntakeEnabled: true,
+        });
+        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.`,
+            };
+        }
+        return {
+            text: isZh
+                ? `⚠️ Pain 记录未成功 (status: ${result.status})。请检查系统日志或使用 \`/pd-status\` 查看状态。`
+                : `⚠️ Pain recording not accepted (status: ${result.status}). Check 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/plugin/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/plugin/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/plugin/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;

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

@@ -0,0 +1,194 @@
+/**
+ * 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 * as fs from 'fs';
+import * as path from 'path';
+import { ReplayEngine, formatReplayReport } from '../core/replay-engine.js';
+import { refreshPrincipleLifecycle } from '../core/principle-internalization/lifecycle-refresh.js';
+import { findActiveImplementation, loadLedger, transitionImplementationState, updateImplementation, } from '../core/principle-tree-ledger.js';
+import { WorkspaceContext } from '../core/workspace-context.js';
+import { normalizeCommandArgs } from '../utils/io.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
+import { withLock } from '../utils/file-lock.js';
+import { atomicWriteFileSync } from '../utils/io.js';
+function getAllImplementations(stateDir) {
+    const ledger = loadLedger(stateDir);
+    return Object.values(ledger.tree.implementations);
+}
+/**
+ * Type predicate: true if impl has lifecycleState of 'candidate' or 'disabled'.
+ * The ledger adds lifecycleState at runtime beyond what's in the manifest interface.
+ */
+function isCandidateOrDisabled(impl) {
+    return impl.lifecycleState === 'candidate' || impl.lifecycleState === 'disabled';
+}
+function _handleListCandidates(stateDir, isZh) {
+    const engine = new ReplayEngine('', stateDir);
+    const allImpls = getAllImplementations(stateDir);
+    const candidates = allImpls.filter(isCandidateOrDisabled);
+    if (candidates.length === 0) {
+        return {
+            text: isZh
+                ? '\nℹ️ 未找到候选实现。\n\n用法: /pd-promote-impl list'
+                : '\nℹ️ No candidate implementations found.\n\nUsage: /pd-promote-impl list',
+        };
+    }
+    let output = isZh ? '\n📋 候选实现列表\n' : '\n📋 Candidate Implementations\n';
+    output += `${'='.repeat(50)}\n`;
+    for (const impl of candidates) {
+        const hasPass = engine.hasPassingReport(impl.id);
+        const passBadge = hasPass
+            ? isZh ? '✅ 有通过报告' : '✅ Has pass report'
+            : isZh ? '❌ 无通过报告' : '❌ No pass report';
+        output += `  ${impl.id}\n`;
+        output += `    Rule: ${impl.ruleId} | Version: ${impl.version}\n`;
+        output += `    Replay: ${passBadge}\n\n`;
+    }
+    return { text: output };
+}
+function _handleShowReport(stateDir, implId, isZh) {
+    const engine = new ReplayEngine('', stateDir);
+    const report = engine.getLatestReport(implId);
+    if (!report) {
+        return {
+            text: isZh
+                ? `❌ 实现 ${implId} 没有回放报告。`
+                : `❌ No replay report found for implementation ${implId}.`,
+        };
+    }
+    return { text: formatReplayReport(report) };
+}
+function _handlePromoteImpl(options) {
+    const { workspaceDir, stateDir, implId, isZh } = options;
+    const engine = new ReplayEngine('', stateDir);
+    const allImpls = getAllImplementations(stateDir);
+    const candidate = allImpls.find((i) => i.id === implId);
+    if (!candidate) {
+        return {
+            text: isZh
+                ? `❌ 未找到实现: ${implId}`
+                : `❌ Implementation not found: ${implId}`,
+        };
+    }
+    const currentState = candidate.lifecycleState || 'candidate';
+    if (currentState !== 'candidate' && currentState !== 'disabled') {
+        return {
+            text: isZh
+                ? `❌ 只能晋升 candidate 或 disabled 状态的实现。当前: ${currentState}`
+                : `❌ Can only promote 'candidate' or 'disabled' implementations. Current: ${currentState}`,
+        };
+    }
+    if (!engine.hasPassingReport(implId)) {
+        return {
+            text: isZh
+                ? `❌ 实现 ${implId} 没有通过的回放报告，晋升被拒绝。\n\nLegacy replay 生成路径已在 PRI-230 退役，当前无可用的 replay 证据生成入口。该命令暂不可用于没有既有 replay 报告的实现。`
+                : `❌ Implementation ${implId} has no passing replay report. Promotion rejected.\n\nThe legacy replay generation path was retired in PRI-230; no replay evidence generation entry is currently available. This command is temporarily unavailable for implementations without pre-existing replay reports.`,
+        };
+    }
+    const report = engine.getLatestReport(implId);
+    let output = '';
+    if (report) {
+        output = `${formatReplayReport(report)}\n`;
+    }
+    if (currentState === 'disabled') {
+        transitionImplementationState(stateDir, implId, 'active');
+        updateImplementation(stateDir, implId, {
+            disabledAt: undefined,
+            disabledBy: undefined,
+            disabledReason: undefined,
+        });
+        try {
+            refreshPrincipleLifecycle(workspaceDir, stateDir);
+        }
+        catch (err) {
+            console.warn('[promote-impl] Lifecycle refresh failed (re-enable):', err instanceof Error ? err.stack : err);
+        }
+        output += isZh
+            ? `\n✅ 实现已重新启用: ${implId}\n   状态: disabled -> active`
+            : `\n✅ Implementation re-enabled: ${implId}\n   State: disabled -> active`;
+        return { text: output };
+    }
+    const activeForRule = findActiveImplementation(stateDir, candidate.ruleId);
+    if (activeForRule) {
+        updateImplementation(stateDir, implId, {
+            previousActive: activeForRule.id,
+        });
+    }
+    transitionImplementationState(stateDir, implId, 'active');
+    if (activeForRule) {
+        transitionImplementationState(stateDir, activeForRule.id, 'disabled');
+        output += isZh
+            ? `\n上一个活跃实现已禁用: ${activeForRule.id}\n   状态: active -> disabled`
+            : `\nPrevious active implementation disabled: ${activeForRule.id}\n   State: active -> disabled`;
+    }
+    const eventsDir = path.join(stateDir, 'principles', 'implementations', implId, 'events');
+    if (!fs.existsSync(eventsDir)) {
+        fs.mkdirSync(eventsDir, { recursive: true });
+    }
+    const eventPath = path.join(eventsDir, 'promotion.json');
+    const promotionEvent = {
+        eventType: 'promotion',
+        implementationId: implId,
+        ruleId: candidate.ruleId,
+        fromState: 'candidate',
+        toState: 'active',
+        previousActive: activeForRule?.id ?? null,
+        replayReportId: report
+            ? report.generatedAt.replace(/[:.]/g, '-')
+            : null,
+        promotedAt: new Date().toISOString(),
+    };
+    withLock(eventPath, () => {
+        atomicWriteFileSync(eventPath, JSON.stringify(promotionEvent, null, 2));
+    });
+    try {
+        refreshPrincipleLifecycle(workspaceDir, stateDir);
+    }
+    catch (err) {
+        console.warn('[promote-impl] Lifecycle refresh failed (promotion):', err instanceof Error ? err.stack : err);
+    }
+    output += isZh
+        ? `\n\n✅ 实现已晋升: ${implId}\n   状态: candidate -> active`
+        : `\n\n✅ Implementation promoted: ${implId}\n   State: candidate -> active`;
+    return { text: output };
+}
+export function handlePromoteImplCommand(ctx) {
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'promote-impl');
+    const { stateDir } = WorkspaceContext.fromHookContext({ ...ctx, workspaceDir });
+    const lang = ctx.config?.language || 'en';
+    const isZh = lang === 'zh';
+    const args = normalizeCommandArgs(ctx.args).trim().split(/\s+/);
+    const subcommand = args[0] || '';
+    const implId = args[1] || '';
+    if (subcommand === 'list' || subcommand === '') {
+        return _handleListCandidates(stateDir, isZh);
+    }
+    if (subcommand === 'show') {
+        if (!implId) {
+            return {
+                text: isZh
+                    ? '请指定要查看的实现ID: /pd-promote-impl show <implId>'
+                    : 'Please specify an implementation ID: /pd-promote-impl show <implId>',
+            };
+        }
+        return _handleShowReport(stateDir, implId, isZh);
+    }
+    return _handlePromoteImpl({ workspaceDir, stateDir, implId: subcommand, isZh });
+}

package/plugin/dist/commands/rollback-impl.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Rollback Implementation Command — CLI `/pd-rollback-impl`
+ * ==========================================================
+ *
+ * PURPOSE: Revert the current active implementation and restore the previous one.
+ *
+ * FLOW:
+ *   1. List active implementations
+ *   2. On confirm: current -> disabled, previous -> active
+ *
+ * SAFETY:
+ *   - If no previous active: current -> disabled (degrades to hard-boundary gates)
+ *   - Rollback records persisted with full audit trail
+ */
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+/**
+ * Handle the /pd-rollback-impl command.
+ *
+ * Usage:
+ *   /pd-rollback-impl list                          - List active implementations
+ *   /pd-rollback-impl <implId>                      - Rollback current active
+ *   /pd-rollback-impl <implId> --reason "<reason>"  - Rollback with reason
+ */
+export declare function handleRollbackImplCommand(ctx: PluginCommandContext): PluginCommandResult;
+/**
+ * Handle natural language rollback request.
+ * Detects phrases like "回滚这个规则实现", "rollback this implementation".
+ */
+export declare function handleNaturalLanguageRollbackImpl(workspaceDir: string, sessionId: string | undefined, reason: string): {
+    success: boolean;
+    message: string;
+};