principles-disciple 1.11.0 → 1.13.0

package/src/http/principles-console-route.ts

@@ -7,6 +7,8 @@ import { getEvolutionQueryService } from '../service/evolution-query-service.js'
 import { HealthQueryService } from '../service/health-query-service.js';
 import { TrajectoryRegistry } from '../core/trajectory.js';
 import { getCentralDatabase } from '../service/central-database.js';
+import { CentralOverviewService } from '../service/central-overview-service.js';
+import { CentralHealthService } from '../service/central-health-service.js';
 
 const ROUTE_PREFIX = '/plugins/principles';
 const API_PREFIX = `${ROUTE_PREFIX}/api`;
@@ -92,6 +94,7 @@ function createService(api: OpenClawPluginApi): ControlUiQueryService {
   return new ControlUiQueryService(workspaceDir);
 }
 
+/* eslint-disable @typescript-eslint/max-params -- Reason: Route handler requires api, pathname, req, and res */
 function handleApiRoute(
   api: OpenClawPluginApi,
   pathname: string,
@@ -99,6 +102,7 @@ function handleApiRoute(
   res: ServerResponse,
 ): Promise<boolean> | boolean {
   // Check authentication for API routes
+  /* eslint-disable @typescript-eslint/no-use-before-define -- Reason: validateGatewayAuth is defined later in the file */
   if (!validateGatewayAuth(req)) {
     json(res, 401, { error: 'unauthorized', message: 'Valid Gateway token required.' });
     return true;
@@ -137,61 +141,12 @@ function handleApiRoute(
   if (pathname === `${API_PREFIX}/central/overview` && method === 'GET') {
     const days = parseDays(url.searchParams.get('days'));
     return done(() => {
-      const centralDb = getCentralDatabase();
-      const stats = centralDb.getOverviewStats();
-      const trend = centralDb.getDailyTrend(days);
-      const regressions = centralDb.getTopRegressions(5);
-      const thinkingStats = centralDb.getThinkingModelStats();
-      const workspaces = centralDb.getWorkspaces();
-      
-      return {
-        workspaceDir: 'central',
-        generatedAt: new Date().toISOString(),
-        dataFreshness: workspaces.length > 0 ? (workspaces[0].lastSync ?? null) : null,
-        dataSource: 'central_aggregated_db',
-        runtimeControlPlaneSource: 'all_workspaces',
-        summary: {
-          repeatErrorRate: stats.totalToolCalls > 0 
-            ? stats.totalFailures / stats.totalToolCalls 
-            : 0,
-          userCorrectionRate: stats.totalToolCalls > 0 
-            ? stats.totalCorrections / stats.totalToolCalls 
-            : 0,
-          pendingSamples: stats.pendingSamples,
-          approvedSamples: stats.approvedSamples,
-          thinkingCoverageRate: stats.totalToolCalls > 0 
-            ? stats.totalThinkingEvents / stats.totalToolCalls 
-            : 0,
-          painEvents: stats.totalPainEvents,
-          principleEventCount: 0,
-          gateBlocks: 0,
-          taskOutcomes: 0,
-        },
-        dailyTrend: trend,
-        topRegressions: regressions,
-        sampleQueue: {
-          counters: {
-            pending: stats.pendingSamples,
-            approved: stats.approvedSamples,
-            rejected: stats.rejectedSamples,
-          },
-          preview: [],
-        },
-        thinkingSummary: {
-          activeModels: thinkingStats.activeModels,
-          dormantModels: thinkingStats.totalModels - thinkingStats.activeModels,
-          effectiveModels: thinkingStats.models.filter(m => m.coverageRate > 0.1).length,
-          coverageRate: stats.totalToolCalls > 0 
-            ? stats.totalThinkingEvents / stats.totalToolCalls 
-            : 0,
-        },
-        centralInfo: {
-          workspaceCount: stats.workspaceCount,
-          enabledWorkspaceCount: stats.enabledWorkspaceCount,
-          workspaces: stats.workspaceNames,
-          enabledWorkspaces: stats.enabledWorkspaceNames,
-        },
-      };
+      const centralOverviewService = new CentralOverviewService();
+      try {
+        return centralOverviewService.getOverview(days);
+      } finally {
+        centralOverviewService.dispose();
+      }
     });
   }
 
@@ -224,7 +179,14 @@ function handleApiRoute(
     });
   }
 
-  const workspaceConfigMatch = pathname.match(/^\/plugins\/principles\/api\/central\/workspaces\/([^/]+)$/);
+  // === Central Health: per-workspace health indicators ===
+  if (pathname === `${API_PREFIX}/central/health` && method === 'GET') {
+    return done(() => {
+      return new CentralHealthService().getAllWorkspaceHealth();
+    });
+  }
+
+  const workspaceConfigMatch = /^\/plugins\/principles\/api\/central\/workspaces\/([^/]+)$/.exec(pathname);
   if (workspaceConfigMatch && method === 'GET') {
     return done(() => {
       const centralDb = getCentralDatabase();
@@ -238,7 +200,7 @@ function handleApiRoute(
   if (workspaceConfigMatch && method === 'PATCH') {
     return (async () => {
       try {
-        const body = await readJsonBody(req) as Record<string, unknown>;
+        const body = await readJsonBody(req);
         const centralDb = getCentralDatabase();
         const workspaceName = decodeURIComponent(workspaceConfigMatch[1]);
         centralDb.updateWorkspaceConfig(workspaceName, {
@@ -264,7 +226,7 @@ function handleApiRoute(
   if (pathname === `${API_PREFIX}/central/workspaces` && method === 'POST') {
     return (async () => {
       try {
-        const body = await readJsonBody(req) as Record<string, unknown>;
+        const body = await readJsonBody(req);
         const name = typeof body.name === 'string' ? body.name : '';
         const workspacePath = typeof body.path === 'string' ? body.path : '';
         if (!name || !workspacePath) {
@@ -299,7 +261,7 @@ function handleApiRoute(
     }));
   }
 
-  const sampleDetailMatch = pathname.match(/^\/plugins\/principles\/api\/samples\/([^/]+)$/);
+  const sampleDetailMatch = /^\/plugins\/principles\/api\/samples\/([^/]+)$/.exec(pathname);
   if (sampleDetailMatch && method === 'GET') {
     try {
       const detail = service.getSampleDetail(decodeURIComponent(sampleDetailMatch[1]));
@@ -318,7 +280,7 @@ function handleApiRoute(
     }
   }
 
-  const sampleReviewMatch = pathname.match(/^\/plugins\/principles\/api\/samples\/([^/]+)\/review$/);
+  const sampleReviewMatch = /^\/plugins\/principles\/api\/samples\/([^/]+)\/review$/.exec(pathname);
   if (sampleReviewMatch && method === 'POST') {
     return (async () => {
       try {
@@ -355,7 +317,7 @@ function handleApiRoute(
     return done(() => service.getThinkingOverview());
   }
 
-  const thinkingDetailMatch = pathname.match(/^\/plugins\/principles\/api\/thinking\/models\/([^/]+)$/);
+  const thinkingDetailMatch = /^\/plugins\/principles\/api\/thinking\/models\/([^/]+)$/.exec(pathname);
   if (thinkingDetailMatch && method === 'GET') {
     try {
       const detail = service.getThinkingModelDetail(decodeURIComponent(thinkingDetailMatch[1]));
@@ -414,7 +376,7 @@ function handleApiRoute(
     });
   }
 
-  const evolutionTraceMatch = pathname.match(/^\/plugins\/principles\/api\/evolution\/trace\/([^/]+)$/);
+  const evolutionTraceMatch = /^\/plugins\/principles\/api\/evolution\/trace\/([^/]+)$/.exec(pathname);
   if (evolutionTraceMatch && method === 'GET') {
     const evoService = evolutionService();
     try {
@@ -590,8 +552,8 @@ function validateGatewayAuth(req: IncomingMessage): boolean {
     // No token configured, allow all requests
     return true;
   }
-  const authHeader = (req.headers?.['authorization'] as string) || '';
-  const tokenMatch = authHeader.match(/^Bearer\s+(.+)$/i);
+  const authHeader = (req.headers?.authorization as string) || '';
+  const tokenMatch = /^Bearer\s+(.+)$/i.exec(authHeader);
   const providedToken = tokenMatch?.[1];
   return providedToken === gatewayToken;
 }
@@ -611,7 +573,7 @@ export function createPrinciplesConsoleRoutes(api: OpenClawPluginApi): OpenClawP
     async handler(req, res) {
       if (!api.rootDir) { text(res, 500, 'Plugin rootDir not available'); return true; }
       const url = new URL(req.url || ROUTE_PREFIX, 'http://127.0.0.1');
-      const pathname = url.pathname;
+      const {pathname} = url;
       const method = (req.method || 'GET').toUpperCase();
 
       // Skip API routes - they'll be handled by the API route
@@ -653,7 +615,7 @@ export function createPrinciplesConsoleRoutes(api: OpenClawPluginApi): OpenClawP
     match: 'prefix',
     async handler(req, res) {
       const url = new URL(req.url || API_PREFIX, 'http://127.0.0.1');
-      const pathname = url.pathname;
+      const {pathname} = url;
       return handleApiRoute(api, pathname, req, res);
     },
   };
@@ -663,7 +625,8 @@ export function createPrinciplesConsoleRoutes(api: OpenClawPluginApi): OpenClawP
 
 // Legacy export for backwards compatibility
 export function createPrinciplesConsoleRoute(api: OpenClawPluginApi): OpenClawPluginHttpRouteParams {
-  const routes = createPrinciplesConsoleRoutes(api);
+  // Side effect: registers all console routes via createPrinciplesConsoleRoutes
+  createPrinciplesConsoleRoutes(api);
   // Return the combined behavior - this will be called from index.ts
   return {
     path: ROUTE_PREFIX,
@@ -672,7 +635,7 @@ export function createPrinciplesConsoleRoute(api: OpenClawPluginApi): OpenClawPl
     async handler(req, res) {
       if (!api.rootDir) { text(res, 500, 'Plugin rootDir not available'); return true; }
       const url = new URL(req.url || ROUTE_PREFIX, 'http://127.0.0.1');
-      const pathname = url.pathname;
+      const {pathname} = url;
       const method = (req.method || 'GET').toUpperCase();
 
       if (!pathname.startsWith(ROUTE_PREFIX)) {

package/src/i18n/commands.ts

@@ -99,7 +99,7 @@ export function getCommandDescription(name: string, lang: string): string {
   if (!descriptions) {
     return name;
   }
-  return descriptions[normalizedLang] || descriptions['en'] || name;
+  return descriptions[normalizedLang] || descriptions.en || name;
 }
 
 /**
@@ -111,7 +111,7 @@ export function getAllCommandDescriptions(lang: string): Record<string, string>
   const normalizedLang = normalizeLanguage(lang);
   const result: Record<string, string> = {};
   for (const [name, descriptions] of Object.entries(commandDescriptions)) {
-    result[name] = descriptions[normalizedLang] || descriptions['en'] || name;
+    result[name] = descriptions[normalizedLang] || descriptions.en || name;
   }
   return result;
 }

package/src/index.ts

@@ -15,8 +15,6 @@ import type {
   PluginHookSubagentSpawningEvent,
   PluginHookSubagentSpawningResult,
   PluginHookSubagentContext,
-  PluginHookBeforeMessageWriteEvent,
-  PluginHookBeforeMessageWriteResult,
 } from './openclaw-sdk.js';
 import * as crypto from 'crypto';
 import type { WorkerProfile } from './core/model-deployment-registry.js';
@@ -30,7 +28,6 @@ import { handleAfterToolCall } from './hooks/pain.js';
 import { handleBeforeReset, handleBeforeCompaction, handleAfterCompaction } from './hooks/lifecycle.js';
 import { handleLlmOutput } from './hooks/llm.js';
 import { handleSubagentEnded } from './hooks/subagent.js';
-import { handleBeforeMessageWrite } from './hooks/message-sanitize.js';
 import * as TrajectoryCollector from './hooks/trajectory-collector.js';
 import { handleInitStrategy, handleManageOkr } from './commands/strategy.js';
 import { handleBootstrapTools, handleResearchTools } from './commands/capabilities.js';
@@ -39,6 +36,10 @@ import { handlePainCommand } from './commands/pain.js';
 import { handleContextCommand } from './commands/context.js';
 import { handleFocusCommand } from './commands/focus.js';
 import { handleRollbackCommand } from './commands/rollback.js';
+import { handlePromoteImplCommand } from './commands/promote-impl.js';
+import { handleDisableImplCommand } from './commands/disable-impl.js';
+import { handleArchiveImplCommand } from './commands/archive-impl.js';
+import { handleRollbackImplCommand } from './commands/rollback-impl.js';
 import { handleEvolutionStatusCommand } from './commands/evolution-status.js';
 import { handlePrincipleRollbackCommand } from './commands/principle-rollback.js';
 import { handleExportCommand } from './commands/export.js';
@@ -49,8 +50,11 @@ import { handleNocturnalRolloutCommand } from './commands/nocturnal-rollout.js';
 import { handleWorkflowDebugCommand } from './commands/workflow-debug.js';
 import { EvolutionWorkerService } from './service/evolution-worker.js';
 import { TrajectoryService } from './service/trajectory-service.js';
+import { PDTaskService } from './core/pd-task-service.js';
+import { CentralSyncService } from './service/central-sync-service.js';
 import { ensureWorkspaceTemplates } from './core/init.js';
 import { migrateDirectoryStructure } from './core/migration.js';
+import { runMigrationIfNeeded } from './core/principle-tree-migration.js';
 import { SystemLogger } from './core/system-logger.js';
 import { createDeepReflectTool } from './tools/deep-reflect.js';
 import { PathResolver, resolveWorkspaceDirFromApi } from './core/path-resolver.js';
@@ -79,6 +83,16 @@ function computeRuntimeShadowTaskFingerprint(event: PluginHookSubagentSpawningEv
   return crypto.createHash('sha256').update(JSON.stringify(payload)).digest('hex').slice(0, 16);
 }
 
+import { resolveValidWorkspaceDir, validateWorkspaceDir } from './core/workspace-dir-validation.js';
+
+function resolveToolHookWorkspaceDir(
+  ctx: { workspaceDir?: string; agentId?: string },
+  api: OpenClawPluginApi,
+  source: string,
+): string {
+  return resolveValidWorkspaceDir(ctx, api, { source });
+}
+
 const plugin = {
   name: "Principles Disciple",
   description: "Evolutionary programming agent framework with strategic guardrails and reflection loops.",
@@ -88,6 +102,20 @@ const plugin = {
     PathResolver.setExtensionRoot(api.rootDir ?? '.');
     api.registerHttpRoute(createPrinciplesConsoleRoute(api));
 
+    // ── Startup Health Check: Verify workspaceDir resolution ──
+    // Catches OpenClaw context bugs early (e.g., missing workspaceDir in tool hooks)
+    setTimeout(() => {
+      const testCtx = { agentId: 'main' };
+      const toolWorkspaceDir = resolveToolHookWorkspaceDir(testCtx, api, 'startup.health_check');
+      const toolIssue = validateWorkspaceDir(toolWorkspaceDir);
+      if (toolIssue) {
+        api.logger.error(`[PD:health] Tool hook workspaceDir is INVALID: "${toolWorkspaceDir}" - ${toolIssue}`);
+        api.logger.error(`[PD:health] Tool hook events will be written to the WRONG .state directory!`);
+      } else {
+        api.logger.info(`[PD:health] Tool hook workspaceDir OK: "${toolWorkspaceDir}"`);
+      }
+    }, 1000);
+
     const language = (api.pluginConfig?.language as string) || 'en';
 
     // ── Hook: Prompt Building ──
@@ -98,6 +126,9 @@ const plugin = {
           const workspaceDir = ctx.workspaceDir || api.resolvePath('.');
           if (!workspaceInitialized && workspaceDir) {
             migrateDirectoryStructure(api, workspaceDir);
+            // Phase 11: Migrate trainingStore principles to tree.principles
+            const { stateDir } = WorkspaceContext.fromHookContext({ workspaceDir });
+            runMigrationIfNeeded(stateDir, workspaceDir);
             ensureWorkspaceTemplates(api, workspaceDir, language);
             SystemLogger.log(workspaceDir, 'SYSTEM_BOOT', `Principles Disciple online. Language: ${language}`);
             workspaceInitialized = true;
@@ -127,22 +158,23 @@ const plugin = {
     api.on(
       'before_tool_call',
       (event: PluginHookBeforeToolCallEvent, ctx: PluginHookToolContext): PluginHookBeforeToolCallResult | void => {
-        const workspaceDir = ctx.workspaceDir || api.resolvePath('.');
+        const workspaceDir = resolveToolHookWorkspaceDir(ctx, api, 'before_tool_call');
         try {
           const pluginConfig = api.pluginConfig ?? {};
-          const logger = api.logger;
+          const {logger} = api;
           const result = handleBeforeToolCall(event, { ...ctx, workspaceDir, pluginConfig, logger });
-          
+
           WorkspaceContext.fromHookContext({ workspaceDir }).eventLog.recordHookExecution({
             hook: 'before_tool_call'
-          });
-          
+          }, { flushImmediately: true });
+
           return result;
         } catch (err) {
-          WorkspaceContext.fromHookContext({ workspaceDir }).eventLog.recordHookExecution({
+          const fallbackDir = resolveToolHookWorkspaceDir(ctx, api, 'before_tool_call');
+          WorkspaceContext.fromHookContext({ workspaceDir: fallbackDir }).eventLog.recordHookExecution({
             hook: 'before_tool_call',
             error: String(err)
-          });
+          }, { flushImmediately: true });
           api.logger.error(`[PD] Error in before_tool_call: ${String(err)}`);
         }
       }
@@ -152,20 +184,21 @@ const plugin = {
     api.on(
       'after_tool_call',
       (event: PluginHookAfterToolCallEvent, ctx: PluginHookToolContext): void => {
-        const workspaceDir = ctx.workspaceDir || api.resolvePath('.');
+        const workspaceDir = resolveToolHookWorkspaceDir(ctx, api, 'after_tool_call');
         try {
           const pluginConfig = api.pluginConfig ?? {};
           // Pass api separately to handleAfterToolCall to maintain type safety
           handleAfterToolCall(event, { ...ctx, workspaceDir, pluginConfig }, api);
-          
+
           WorkspaceContext.fromHookContext({ workspaceDir }).eventLog.recordHookExecution({
             hook: 'after_tool_call'
-          });
+          }, { flushImmediately: true });
         } catch (err) {
-          WorkspaceContext.fromHookContext({ workspaceDir }).eventLog.recordHookExecution({
+          const fallbackDir = resolveToolHookWorkspaceDir(ctx, api, 'after_tool_call');
+          WorkspaceContext.fromHookContext({ workspaceDir: fallbackDir }).eventLog.recordHookExecution({
             hook: 'after_tool_call',
             error: String(err)
-          });
+          }, { flushImmediately: true });
           api.logger.error(`[PD:EmpathyObserver] Error in after_tool_call: ${String(err)}`);
         }
       }
@@ -175,10 +208,10 @@ const plugin = {
     api.on(
       'llm_output',
       (event: PluginHookLlmOutputEvent, ctx: PluginHookAgentContext): void => {
-        const workspaceDir = ctx.workspaceDir || api.resolvePath('.');
+        const workspaceDir = resolveToolHookWorkspaceDir(ctx as unknown as Record<string, unknown>, api, 'llm_output');
         try {
           handleLlmOutput(event, { ...ctx, workspaceDir });
-          
+
           WorkspaceContext.fromHookContext({ workspaceDir }).eventLog.recordHookExecution({
             hook: 'llm_output',
             sessionId: ctx.sessionId
@@ -194,28 +227,16 @@ const plugin = {
       }
     );
 
-    // ── Hook: Message Sanitization ──
-    api.on(
-      'before_message_write',
-      (event: PluginHookBeforeMessageWriteEvent): PluginHookBeforeMessageWriteResult | void => {
-        try {
-          return handleBeforeMessageWrite(event);
-        } catch (err) {
-          api.logger.error(`[PD] Error in before_message_write: ${String(err)}`);
-        }
-      }
-    );
-
     // ── Hook: Trajectory Collection (Behavior Evolution Phase 0) ──
     // Note: after_tool_call and llm_output are safe to collect
-    // before_message_write conflicts with message-sanitize, skipping for now
     api.on(
       'after_tool_call',
       (event: PluginHookAfterToolCallEvent, ctx: PluginHookToolContext): void => {
         try {
-          const workspaceDir = ctx.workspaceDir || api.resolvePath('.');
+          const workspaceDir = resolveToolHookWorkspaceDir(ctx, api, 'trajectory.after_tool_call');
           TrajectoryCollector.handleAfterToolCall(event, { ...ctx, workspaceDir });
-        } catch (err) {
+          // eslint-disable-next-line @typescript-eslint/no-unused-vars -- Reason: catch binding intentionally unused
+        } catch (_err) {
           // Non-critical: don't log, just skip
         }
       }
@@ -225,9 +246,10 @@ const plugin = {
       'llm_output',
       (event: PluginHookLlmOutputEvent, ctx: PluginHookAgentContext): void => {
         try {
-          const workspaceDir = ctx.workspaceDir || api.resolvePath('.');
+          const workspaceDir = resolveToolHookWorkspaceDir(ctx as unknown as Record<string, unknown>, api, 'trajectory.llm_output');
           TrajectoryCollector.handleLlmOutput(event, { ...ctx, workspaceDir });
-        } catch (err) {
+          // eslint-disable-next-line @typescript-eslint/no-unused-vars -- Reason: catch binding intentionally unused
+        } catch (_err) {
           // Non-critical: don't log, just skip
         }
       }
@@ -236,7 +258,8 @@ const plugin = {
     // ── Hook: Subagent Loop Closure ──
     api.on(
       'subagent_spawning',
-      (event: PluginHookSubagentSpawningEvent, ctx: PluginHookSubagentContext): void | PluginHookSubagentSpawningResult => {
+       
+      (event: PluginHookSubagentSpawningEvent, _ctx: PluginHookSubagentContext): void | PluginHookSubagentSpawningResult => {
         try {
           // Resolve workspace via official API, falling back to PathResolver
           const workspaceDir = resolveWorkspaceDirFromApi(api, event.agentId) || '.';
@@ -259,7 +282,7 @@ const plugin = {
 
           if (shouldRecordShadow) {
             const observation = recordShadowRouting(workspaceDir, {
-              checkpointId: decision.activeCheckpointId!,
+              checkpointId: decision.activeCheckpointId!, // eslint-disable-line @typescript-eslint/no-non-null-assertion -- Reason: !!decision.activeCheckpointId guard above ensures truthiness
               workerProfile: agentId as WorkerProfile,
               taskFingerprint: computeRuntimeShadowTaskFingerprint(event),
             });
@@ -327,6 +350,8 @@ const plugin = {
       EvolutionWorkerService.api = api;
       api.registerService(EvolutionWorkerService);
       api.registerService(TrajectoryService);
+      api.registerService(PDTaskService);
+      api.registerService(CentralSyncService);
     } catch (err) {
       api.logger.error(`[PD] Failed to register EvolutionWorkerService: ${String(err)}`);
     }
@@ -366,8 +391,8 @@ const plugin = {
     api.registerCommand({
       name: "pd-daily",
       description: getCommandDescription('pd-daily', language),
-      handler: (_ctx) => {
-        return { text: language === 'zh' 
+      handler: () => {
+        return { text: language === 'zh'
           ? "请执行 pd-daily 技能来配置并发送进化日报。系统将引导你完成配置流程，包括发送时间、渠道和报告风格偏好。"
           : "Please execute the pd-daily skill to configure and send your daily evolution report. The system will guide you through the configuration process." };
       }
@@ -376,7 +401,7 @@ const plugin = {
     api.registerCommand({
       name: "pd-grooming",
       description: getCommandDescription('pd-grooming', language),
-      handler: (_ctx) => {
+      handler: () => {
         return { text: language === 'zh'
           ? "请执行 pd-grooming 技能来执行大扫除。例如输入: '执行 pd-grooming 技能'"
           : "Please execute the pd-grooming skill to clean up. For example: 'Execute pd-grooming skill'" };
@@ -386,7 +411,7 @@ const plugin = {
     api.registerCommand({
       name: "pd-help",
       description: getCommandDescription('pd-help', language),
-      handler: (_ctx) => {
+      handler: () => {
         if (language === 'zh') {
           return { text: `
 📖 **Principles Disciple 命令大全**
@@ -687,6 +712,71 @@ const plugin = {
       }
     });
 
+    // ── Implementation Lifecycle Commands (Phase 13) ──
+    api.registerCommand({
+      name: "pd-promote-impl",
+      description: 'Promote a candidate implementation to active [list|show <id>|<id>]',
+      acceptsArgs: true,
+      handler: (ctx) => {
+        try {
+          const workspaceDir = api.resolvePath('.');
+          if (ctx.config) ctx.config.workspaceDir = workspaceDir;
+          return handlePromoteImplCommand(ctx);
+        } catch (err) {
+          api.logger.error(`[PD] Command /pd-promote-impl failed: ${String(err)}`);
+          return { text: language === 'zh' ? '\u547d\u4ee4\u6267\u884c\u5931\u8d25\uff0c\u8bf7\u68c0\u67e5\u65e5\u5fd7\u3002' : 'Command failed. Check logs.' };
+        }
+      }
+    });
+
+    api.registerCommand({
+      name: "pd-disable-impl",
+      description: 'Disable an active implementation [list|<id> --reason "..."]',
+      acceptsArgs: true,
+      handler: (ctx) => {
+        try {
+          const workspaceDir = api.resolvePath('.');
+          if (ctx.config) ctx.config.workspaceDir = workspaceDir;
+          return handleDisableImplCommand(ctx);
+        } catch (err) {
+          api.logger.error(`[PD] Command /pd-disable-impl failed: ${String(err)}`);
+          return { text: language === 'zh' ? '\u547d\u4ee4\u6267\u884c\u5931\u8d25\uff0c\u8bf7\u68c0\u67e5\u65e5\u5fd7\u3002' : 'Command failed. Check logs.' };
+        }
+      }
+    });
+
+    api.registerCommand({
+      name: "pd-archive-impl",
+      description: 'Archive an implementation permanently [list|<id>]',
+      acceptsArgs: true,
+      handler: (ctx) => {
+        try {
+          const workspaceDir = api.resolvePath('.');
+          if (ctx.config) ctx.config.workspaceDir = workspaceDir;
+          return handleArchiveImplCommand(ctx);
+        } catch (err) {
+          api.logger.error(`[PD] Command /pd-archive-impl failed: ${String(err)}`);
+          return { text: language === 'zh' ? '\u547d\u4ee4\u6267\u884c\u5931\u8d25\uff0c\u8bf7\u68c0\u67e5\u65e5\u5fd7\u3002' : 'Command failed. Check logs.' };
+        }
+      }
+    });
+
+    api.registerCommand({
+      name: "pd-rollback-impl",
+      description: 'Rollback current active implementation to previous active [list|<id> --reason "..."]',
+      acceptsArgs: true,
+      handler: (ctx) => {
+        try {
+          const workspaceDir = api.resolvePath('.');
+          if (ctx.config) ctx.config.workspaceDir = workspaceDir;
+          return handleRollbackImplCommand(ctx);
+        } catch (err) {
+          api.logger.error(`[PD] Command /pd-rollback-impl failed: ${String(err)}`);
+          return { text: language === 'zh' ? '\u547d\u4ee4\u6267\u884c\u5931\u8d25\uff0c\u8bf7\u68c0\u67e5\u65e5\u5fd7\u3002' : 'Command failed. Check logs.' };
+        }
+      }
+    });
+
     api.registerTool(createDeepReflectTool(api));
   }
 };