principles-disciple 1.127.0 → 1.128.0

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

@@ -0,0 +1,18 @@
+/**
+ * Archive Implementation Command — CLI `/pd-archive-impl`
+ * ========================================================
+ *
+ * PURPOSE: Permanently archive an implementation (disabled -> archived,
+ * active -> archived, or candidate -> archived).
+ *
+ * Used for permanent cleanup of implementations that are no longer relevant.
+ */
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+/**
+ * Handle the /pd-archive-impl command.
+ *
+ * Usage:
+ *   /pd-archive-impl <implId>   - Archive an implementation
+ *   /pd-archive-impl list       - List archivable implementations
+ */
+export declare function handleArchiveImplCommand(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/archive-impl.js

@@ -0,0 +1,105 @@
+/**
+ * Archive Implementation Command — CLI `/pd-archive-impl`
+ * ========================================================
+ *
+ * PURPOSE: Permanently archive an implementation (disabled -> archived,
+ * active -> archived, or candidate -> archived).
+ *
+ * Used for permanent cleanup of implementations that are no longer relevant.
+ */
+import { WorkspaceContext } from '../core/workspace-context.js';
+import { refreshPrincipleLifecycle } from '../core/principle-internalization/lifecycle-refresh.js';
+import { loadLedger, transitionImplementationState, updateImplementation, } from '../core/principle-tree-ledger.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
+import { normalizeCommandArgs } from '../utils/io.js';
+/**
+ * Get all implementations from the ledger.
+ */
+function getAllImplementations(stateDir) {
+    const ledger = loadLedger(stateDir);
+    return Object.values(ledger.tree.implementations);
+}
+/**
+ * Valid archive transitions: disabled -> archived, active -> archived, candidate -> archived
+ */
+function canArchive(state) {
+    return ['disabled', 'active', 'candidate'].includes(state);
+}
+/**
+ * Handle the /pd-archive-impl command.
+ *
+ * Usage:
+ *   /pd-archive-impl <implId>   - Archive an implementation
+ *   /pd-archive-impl list       - List archivable implementations
+ */
+export function handleArchiveImplCommand(ctx) {
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'archive-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] || '';
+    // Subcommand: list
+    if (subcommand === 'list') {
+        return _handleListArchivable(stateDir, isZh);
+    }
+    // Archive by ID
+    const targetId = subcommand;
+    return _handleArchiveImpl(workspaceDir, stateDir, targetId, isZh);
+}
+function _handleListArchivable(stateDir, isZh) {
+    const allImpls = getAllImplementations(stateDir);
+    const archivable = allImpls.filter((impl) => canArchive(impl.lifecycleState || 'candidate'));
+    if (archivable.length === 0) {
+        return {
+            text: isZh
+                ? '\n\u2139\ufe0f \u6ca1\u6709\u53ef\u5f52\u6863\u7684\u5b9e\u73b0\u3002'
+                : '\n\u2139\ufe0f No implementations available to archive.',
+        };
+    }
+    let output = isZh ? '\n\ud83d\udccb \u53ef\u5f52\u6863\u5b9e\u73b0\n' : '\n\ud83d\udccb Available Implementations to Archive\n';
+    output += `${'='.repeat(50)}\n`;
+    for (const impl of archivable) {
+        const stateLabel = impl.lifecycleState || 'candidate';
+        output += `  ${impl.id}\n`;
+        output += `    Rule: ${impl.ruleId} | State: ${stateLabel}\n\n`;
+    }
+    output += isZh
+        ? '\u7528\u6cd5: /pd-archive-impl <implId>'
+        : 'Usage: /pd-archive-impl <implId>';
+    return { text: output };
+}
+function _handleArchiveImpl(workspaceDir, stateDir, implId, isZh) {
+    const allImpls = getAllImplementations(stateDir);
+    const target = allImpls.find((i) => i.id === implId);
+    if (!target) {
+        return {
+            text: isZh
+                ? `\u274c \u672a\u627e\u5230\u5b9e\u73b0: ${implId}`
+                : `\u274c Implementation not found: ${implId}`,
+        };
+    }
+    const currentState = target.lifecycleState || 'candidate';
+    if (!canArchive(currentState)) {
+        return {
+            text: isZh
+                ? `\u274c \u5b9e\u73b0 ${implId} \u4e0d\u80fd\u4ece ${currentState} \u5f52\u6863\u3002\u5df2\u5f52\u6863\u7684\u5b9e\u73b0\u4e0d\u80fd\u518d\u6b21\u5f52\u6863\u3002`
+                : `\u274c Implementation ${implId} cannot be archived from state: ${currentState}. Archived implementations cannot be archived again.`,
+        };
+    }
+    transitionImplementationState(stateDir, implId, 'archived');
+    updateImplementation(stateDir, implId, {
+        archivedAt: new Date().toISOString(),
+    });
+    try {
+        refreshPrincipleLifecycle(workspaceDir, stateDir);
+    }
+    catch (err) {
+        console.warn('[archive-impl] Lifecycle refresh failed:', err instanceof Error ? err.stack : err);
+    }
+    return {
+        text: isZh
+            ? `\n\u2705 \u5b9e\u73b0\u5df2\u5f52\u6863: ${implId}\n   \u72b6\u6001: ${currentState} -> archived`
+            : `\n\u2705 Implementation archived: ${implId}\n   State: ${currentState} -> archived`,
+    };
+}

package/dist/commands/capabilities.d.ts

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

package/dist/commands/capabilities.js

@@ -0,0 +1,76 @@
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { WorkspaceContext } from '../core/workspace-context.js';
+import { atomicWriteFileSync, normalizeCommandArgs } from '../utils/io.js';
+import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.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) {
+    const tools = {};
+    for (const tool of TOOLS_TO_SCAN) {
+        try {
+            const [versionLine] = execSync(tool.cmd.join(' '), { stdio: ['ignore', 'pipe', 'ignore'] }).toString().split('\n');
+            tools[tool.name] = {
+                available: true,
+                version: versionLine.trim(),
+            };
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars -- Reason: catch parameter intentionally unused - we only care that the command failed
+        }
+        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 });
+    }
+    atomicWriteFileSync(capsPath, JSON.stringify(capabilities, null, 2));
+    return capabilities;
+}
+export function handleBootstrapTools(ctx) {
+    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'capabilities');
+    const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
+    try {
+        const caps = scanEnvironment(wctx);
+        const toolsMap = caps.tools;
+        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) {
+    const category = normalizeCommandArgs(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.d.ts

@@ -0,0 +1,5 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+/**
+ * Main command handler
+ */
+export declare function handleContextCommand(ctx: PluginCommandContext): PluginCommandResult;

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

@@ -1,57 +1,48 @@
- 
 import * as fs from 'fs';
 import * as path from 'path';
-import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
 import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
 import { atomicWriteFileSync, normalizeCommandArgs } from '../utils/io.js';
-import type { ContextInjectionConfig} from '../types.js';
 import { defaultContextConfig } from '../types.js';
 import { loadContextInjectionConfig } from '../hooks/prompt.js';
-
 /**
  * Get workspace directory from context
  */
-function getWorkspaceDir(ctx: PluginCommandContext): string {
+function getWorkspaceDir(ctx) {
     // resolvePluginCommandWorkspaceDir throws on failure — never returns falsy
     return resolvePluginCommandWorkspaceDir(ctx, 'context');
 }
-
 /**
  * Save context injection config to PROFILE.json
  */
-function saveConfig(workspaceDir: string, config: ContextInjectionConfig): boolean {
+function saveConfig(workspaceDir, config) {
     const profilePath = path.join(workspaceDir, '.principles', 'PROFILE.json');
-    
     try {
         // Ensure directory exists
         const dir = path.dirname(profilePath);
         if (!fs.existsSync(dir)) {
             fs.mkdirSync(dir, { recursive: true });
         }
-        
         // Load existing profile or create new one
-        let profile: Record<string, unknown> = {};
+        let profile = {};
         if (fs.existsSync(profilePath)) {
             const raw = fs.readFileSync(profilePath, 'utf-8');
             profile = JSON.parse(raw);
         }
-        
         // Update contextInjection
         profile.contextInjection = config;
-        
         // Write back
         atomicWriteFileSync(profilePath, JSON.stringify(profile, null, 2));
         return true;
-    } catch (e) {
+    }
+    catch (e) {
         console.error(`[PD:Context] Failed to save config: ${String(e)}`);
         return false;
     }
 }
-
 /**
  * Format project focus value for display
  */
-function formatProjectFocus(value: 'full' | 'summary' | 'off', isZh: boolean): string {
+function formatProjectFocus(value, isZh) {
     const labels = {
         full: { zh: '📦 完整', en: '📦 Full' },
         summary: { zh: '📝 摘要', en: '📝 Summary' },
@@ -59,13 +50,11 @@ function formatProjectFocus(value: 'full' | 'summary' | 'off', isZh: boolean): s
     };
     return labels[value][isZh ? 'zh' : 'en'];
 }
-
 /**
  * Show current context injection status
  */
-function showStatus(workspaceDir: string, isZh: boolean): string {
+function showStatus(workspaceDir, isZh) {
     const config = loadContextInjectionConfig(workspaceDir);
-    
     if (isZh) {
         return `
 📊 **上下文注入状态**
@@ -78,7 +67,8 @@ function showStatus(workspaceDir: string, isZh: boolean): string {
 
 💡 输入 \`/pd-context help\` 查看更多选项
 `.trim();
-    } else {
+    }
+    else {
         return `
 📊 **Context Injection Status**
 
@@ -92,97 +82,75 @@ function showStatus(workspaceDir: string, isZh: boolean): string {
 `.trim();
     }
 }
-
 /**
  * Toggle a boolean setting
  */
- 
- 
-function toggleSetting(
-    workspaceDir: string,
-    key: 'thinkingOs',
-    value: string,
-    isZh: boolean
-): string {
+function toggleSetting(workspaceDir, key, value, isZh) {
     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 {
+    }
+    else {
         return isZh
             ? `❌ 无效值: "${value}"。使用 "on" 或 "off"。`
             : `❌ Invalid value: "${value}". Use "on" or "off".`;
     }
-
     const newValue = config[key];
     const keyName = isZh
         ? { thinkingOs: '思维模型' }[key]
         : key;
-    
     // No change needed
     if (oldValue === newValue) {
         return isZh
             ? `ℹ️ ${keyName} 已经是 ${newValue ? '开启' : '关闭'} 状态`
             : `ℹ️ ${keyName} is already ${newValue ? 'ON' : 'OFF'}`;
     }
-    
     if (saveConfig(workspaceDir, config)) {
         // Verify the save by re-reading
         const verifyConfig = loadContextInjectionConfig(workspaceDir);
         const verifyValue = verifyConfig[key];
-        
         if (verifyValue !== newValue) {
             return isZh
                 ? `⚠️ ${keyName} 保存后验证失败，请重试`
                 : `⚠️ ${keyName} verification failed after save, please retry`;
         }
-        
         const arrow = isZh ? '→' : '→';
         const oldLabel = oldValue ? (isZh ? '开启' : 'ON') : (isZh ? '关闭' : 'OFF');
         const newLabel = newValue ? (isZh ? '开启' : 'ON') : (isZh ? '关闭' : 'OFF');
-        
         return isZh
             ? `✅ ${keyName} 已更新: ${oldLabel} ${arrow} ${newLabel}\n\n💡 下次对话时生效`
             : `✅ ${keyName} updated: ${oldLabel} ${arrow} ${newLabel}\n\n💡 Takes effect on next turn`;
-    } else {
+    }
+    else {
         return isZh
             ? `❌ 保存配置失败`
             : `❌ Failed to save configuration`;
     }
 }
-
 /**
  * Set project focus mode
  */
-function setProjectFocus(
-    workspaceDir: string,
-    value: string,
-    isZh: boolean
-): string {
+function setProjectFocus(workspaceDir, value, isZh) {
     const config = loadContextInjectionConfig(workspaceDir);
     const oldValue = config.projectFocus;
-    const validModes = ['full', 'summary', 'off'] as const;
-    type FocusMode = typeof validModes[number];
-    
-    if (!validModes.includes(value as FocusMode)) {
+    const validModes = ['full', 'summary', 'off'];
+    if (!validModes.includes(value)) {
         return isZh
             ? `❌ 无效值: "${value}"。使用 "full"、"summary" 或 "off"。`
             : `❌ Invalid value: "${value}". Use "full", "summary", or "off".`;
     }
-    
-    const newValue = value as FocusMode;
+    const newValue = value;
     config.projectFocus = newValue;
-    
     // No change needed
     if (oldValue === newValue) {
         return isZh
             ? `ℹ️ 项目上下文已经是 ${formatProjectFocus(newValue, isZh)} 状态`
             : `ℹ️ Project context is already ${formatProjectFocus(newValue, isZh)}`;
     }
-    
     if (saveConfig(workspaceDir, config)) {
         // Verify the save by re-reading
         const verifyConfig = loadContextInjectionConfig(workspaceDir);
@@ -191,31 +159,22 @@ function setProjectFocus(
                 ? `⚠️ 项目上下文保存后验证失败，请重试`
                 : `⚠️ Project context verification failed after save, please retry`;
         }
-        
         const arrow = '→';
-        
         return isZh
-            ? `✅ 项目上下文已更新: ${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 {
+            ? `✅ 项目上下文已更新: ${formatProjectFocus(oldValue, isZh)} ${arrow} ${formatProjectFocus(newValue, isZh)}\n\n💡 下次对话时生效`
+            : `✅ Project context updated: ${formatProjectFocus(oldValue, isZh)} ${arrow} ${formatProjectFocus(newValue, isZh)}\n\n💡 Takes effect on next turn`;
+    }
+    else {
         return isZh
             ? `❌ 保存配置失败`
             : `❌ Failed to save configuration`;
     }
 }
-
 /**
  * Apply a preset configuration
  */
-function applyPreset(
-    workspaceDir: string,
-    preset: 'minimal' | 'standard' | 'full',
-    isZh: boolean
-): string {
-     
-     
-    let config: ContextInjectionConfig;
-    
+function applyPreset(workspaceDir, preset, isZh) {
+    let config;
     switch (preset) {
         case 'minimal':
             config = {
@@ -239,7 +198,6 @@ function applyPreset(
             };
             break;
     }
-    
     if (saveConfig(workspaceDir, config)) {
         const presetName = isZh
             ? { minimal: '最小模式', standard: '标准模式', full: '完整模式' }[preset]
@@ -247,17 +205,17 @@ function applyPreset(
         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: boolean): string {
+function showHelp(isZh) {
     if (isZh) {
         return `
 📖 **/pd-context 命令帮助**
@@ -277,7 +235,8 @@ function showHelp(isZh: boolean): string {
 
 **注意**: 核心原则始终注入，不可关闭。
 `.trim();
-    } else {
+    }
+    else {
         return `
 📖 **/pd-context Command Help**
 
@@ -298,24 +257,17 @@ function showHelp(isZh: boolean): string {
 `.trim();
     }
 }
-
 /**
  * Main command handler
  */
-     
-export function handleContextCommand(ctx: PluginCommandContext): PluginCommandResult {
+export function handleContextCommand(ctx) {
     const workspaceDir = getWorkspaceDir(ctx);
     const args = normalizeCommandArgs(ctx.args).trim().split(/\s+/);
     const subCommand = args[0]?.toLowerCase() || 'status';
     const value = args[1]?.toLowerCase() || '';
-    
     // Detect language from context
-    const isZh = (ctx.config?.language as string) === 'zh';
-    
-     
-     
-    let result: string;
-    
+    const isZh = ctx.config?.language === 'zh';
+    let result;
     switch (subCommand) {
         case 'status':
             result = showStatus(workspaceDir, isZh);
@@ -337,6 +289,5 @@ export function handleContextCommand(ctx: PluginCommandContext): PluginCommandRe
         default:
             result = showHelp(isZh);
     }
-    
     return { text: result };
 }

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

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

package/dist/commands/disable-impl.js

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

package/dist/commands/evolution-status.d.ts

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