principles-disciple 1.11.0 → 1.13.0

package/src/commands/archive-impl.ts

@@ -0,0 +1,136 @@
+/**
+ * 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 type { Implementation, ImplementationLifecycleState } from '../types/principle-tree-schema.js';
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+
+/**
+ * Get all implementations from the ledger.
+ */
+function getAllImplementations(stateDir: string): Implementation[] {
+  const ledger = loadLedger(stateDir);
+  return Object.values(ledger.tree.implementations);
+}
+
+/**
+ * Valid archive transitions: disabled -> archived, active -> archived, candidate -> archived
+ */
+function canArchive(state: ImplementationLifecycleState): boolean {
+  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: PluginCommandContext): PluginCommandResult {
+  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const {stateDir} = WorkspaceContext.fromHookContext({ ...ctx, workspaceDir });
+  const lang = (ctx.config?.language as string) || 'en';
+  const isZh = lang === 'zh';
+
+  const args = (ctx.args || '').trim().split(/\s+/);
+  const subcommand = args[0] || '';
+
+  // Subcommand: list
+  if (subcommand === 'list') {
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: Mutual recursion between helper functions - reordering would break logical grouping
+    return _handleListArchivable(stateDir, isZh);
+  }
+
+  // Archive by ID
+  const targetId = subcommand;
+  // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: Mutual recursion between helper functions - reordering would break logical grouping
+  return _handleArchiveImpl(workspaceDir, stateDir, targetId, isZh);
+}
+
+function _handleListArchivable(
+  stateDir: string,
+  isZh: boolean
+): PluginCommandResult {
+  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 };
+}
+
+// eslint-disable-next-line @typescript-eslint/max-params -- Reason: Command handler signature must match OpenClaw plugin interface - breaking API change to options objects would affect public contracts
+function _handleArchiveImpl(
+  workspaceDir: string,
+  stateDir: string,
+  implId: string,
+  isZh: boolean
+): PluginCommandResult {
+  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(),
+  });
+  refreshPrincipleLifecycle(workspaceDir, stateDir);
+
+  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/src/commands/capabilities.ts

@@ -13,16 +13,18 @@ const TOOLS_TO_SCAN = [
   { name: 'shellcheck', cmd: ['shellcheck', '--version'] },
 ];
 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Reason: third-party API execSync returns dynamic output - type structure unknown at call site
 function scanEnvironment(wctx: WorkspaceContext): any {
   const tools: Record<string, { available: boolean; version?: string }> = {};
 
   for (const tool of TOOLS_TO_SCAN) {
     try {
-      const output = execSync(tool.cmd.join(' '), { stdio: ['ignore', 'pipe', 'ignore'] }).toString();
+      const [versionLine] = execSync(tool.cmd.join(' '), { stdio: ['ignore', 'pipe', 'ignore'] }).toString().split('\n');
       tools[tool.name] = {
         available: true,
-        version: output.split('\n')[0].trim(),
+        version: versionLine.trim(),
       };
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars, no-unused-vars -- Reason: catch parameter intentionally unused - we only care that the command failed
     } catch (_e) {
       tools[tool.name] = { available: false };
     }

package/src/commands/context.ts

@@ -1,7 +1,8 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
-import { ContextInjectionConfig, defaultContextConfig } from '../types.js';
+import type { ContextInjectionConfig} from '../types.js';
+import { defaultContextConfig } from '../types.js';
 import { loadContextInjectionConfig } from '../hooks/prompt.js';
 
 /**
@@ -97,6 +98,7 @@ function showStatus(workspaceDir: string, isZh: boolean): string {
 /**
  * Toggle a boolean setting
  */
+// eslint-disable-next-line @typescript-eslint/max-params -- Reason: Command handler signature requires specific params - refactoring would break public API contract
 function toggleSetting(
     workspaceDir: string,
     key: 'thinkingOs' | 'reflectionLog',
@@ -211,6 +213,7 @@ function applyPreset(
     preset: 'minimal' | 'standard' | 'full',
     isZh: boolean
 ): string {
+    // eslint-disable-next-line @typescript-eslint/init-declarations -- Reason: assigned in switch block immediately after declaration
     let config: ContextInjectionConfig;
     
     switch (preset) {
@@ -311,6 +314,7 @@ export function handleContextCommand(ctx: PluginCommandContext): PluginCommandRe
     // Detect language from context
     const isZh = (ctx.config?.language as string) === 'zh';
     
+    // eslint-disable-next-line @typescript-eslint/init-declarations -- Reason: assigned in switch block immediately after declaration
     let result: string;
     
     switch (subCommand) {

package/src/commands/disable-impl.ts

@@ -0,0 +1,151 @@
+/**
+ * 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 type { Implementation, ImplementationLifecycleState } from '../types/principle-tree-schema.js';
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+
+/**
+ * Get all implementations from the ledger.
+ */
+function getAllImplementations(stateDir: string): Implementation[] {
+  const ledger = loadLedger(stateDir);
+  return Object.values(ledger.tree.implementations);
+}
+
+function _handleListActive(
+  stateDir: string,
+  isZh: boolean
+): PluginCommandResult {
+  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 };
+}
+
+// eslint-disable-next-line @typescript-eslint/max-params -- Reason: Command handler signature must match OpenClaw plugin interface - breaking API change to options objects would affect public contracts
+function _handleDisableImpl(
+  workspaceDir: string,
+  stateDir: string,
+  implId: string,
+  reason: string | null,
+  isZh: boolean,
+  sessionId?: string,
+): PluginCommandResult {
+  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 as ImplementationLifecycleState);
+    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,
+  });
+  refreshPrincipleLifecycle(workspaceDir, stateDir);
+
+  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: PluginCommandContext): PluginCommandResult {
+  const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
+  const {stateDir} = WorkspaceContext.fromHookContext({ ...ctx, workspaceDir });
+  const lang = (ctx.config?.language as string) || 'en';
+  const isZh = lang === 'zh';
+
+  const args = (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/src/commands/evolution-status.ts

@@ -1,7 +1,9 @@
-import { EvolutionReducerImpl } from '../core/evolution-reducer.js';
+import type { EvolutionReducerImpl } from '../core/evolution-reducer.js';
+import type { InternalizationRouteRecommendation } from '../core/principle-internalization/internalization-routing-policy.js';
+import { WorkspaceContext } from '../core/workspace-context.js';
 import { normalizeLanguage } from '../i18n/commands.js';
-import { RuntimeSummaryService } from '../service/runtime-summary-service.js';
 import type { PluginCommandContext } from '../openclaw-sdk.js';
+import { RuntimeSummaryService } from '../service/runtime-summary-service.js';
 
 function formatNumber(value: number | null): string {
   if (value === null || Number.isNaN(value)) {
@@ -11,7 +13,7 @@ function formatNumber(value: number | null): string {
 }
 
 function formatSources(
-  sources: Array<{ source: string; score?: number }>
+  sources: { source: string; score?: number }[],
 ): string {
   if (sources.length === 0) {
     return '--';
@@ -21,17 +23,36 @@ function formatSources(
     .map((source) =>
       source.score === undefined
         ? source.source
-        : `${source.source}(${formatNumber(source.score)})`
+        : `${source.source}(${formatNumber(source.score)})`,
     )
     .join(', ');
 }
 
+function formatRouteRecommendations(
+  recommendations: InternalizationRouteRecommendation[],
+  emptyLabel: string,
+): string {
+  if (recommendations.length === 0) {
+    return emptyLabel;
+  }
+
+  return recommendations
+    .slice(0, 3)
+    .map(
+      (recommendation) =>
+        `${recommendation.principleId}:${recommendation.route}@${formatNumber(recommendation.confidence)}`,
+    )
+    .join(', ');
+}
+
+// eslint-disable-next-line @typescript-eslint/max-params -- Reason: Command handler signature must match OpenClaw plugin interface - breaking API change to options objects would affect public contracts
 function buildEnglishOutput(
   workspaceDir: string,
   sessionId: string | null,
   warnings: string[],
   stats: ReturnType<EvolutionReducerImpl['getStats']>,
-  summary: ReturnType<typeof RuntimeSummaryService.getSummary>
+  summary: ReturnType<typeof RuntimeSummaryService.getSummary>,
+  recommendations: InternalizationRouteRecommendation[],
 ): string {
   const lines: string[] = [
     'Evolution Status',
@@ -47,7 +68,7 @@ function buildEnglishOutput(
     'Evolution',
     `- Queue: pending ${summary.evolution.queue.pending}, in_progress ${summary.evolution.queue.inProgress}, completed ${summary.evolution.queue.completed} (${summary.evolution.dataQuality})`,
     `- Legacy Directive File: ${summary.phase3.legacyDirectiveFilePresent ? 'present' : 'missing'} (compatibility-only display artifact)`,
-    `- Note: Legacy directive file is NOT a truth source for Phase 3 eligibility. Queue is the only authoritative execution truth source.`,
+    '- Note: Legacy directive file is NOT a truth source for Phase 3 eligibility. Queue is the only authoritative execution truth source.',
     `- Active Evolution Task: ${summary.evolution.directive.taskPreview ?? '--'}`,
     `- Phase 3: ready ${summary.phase3.phase3ShadowEligible ? 'yes' : 'no'}, queueTruthReady ${summary.phase3.queueTruthReady ? 'yes' : 'no'}, eligible ${summary.phase3.evolutionEligible}, reference_only ${summary.phase3.evolutionReferenceOnly}, rejected ${summary.phase3.evolutionRejected}${summary.phase3.evolutionReferenceOnlyReasons.length > 0 ? ` (reference ${summary.phase3.evolutionReferenceOnlyReasons.slice(0, 2).join(', ')})` : ''}${summary.phase3.evolutionRejectedReasons.length > 0 ? ` (${summary.phase3.evolutionRejectedReasons.slice(0, 3).join(', ')})` : ''}`,
     `- Phase 3 Legacy Directive File: ${summary.phase3.directiveStatus} (${summary.phase3.directiveIgnoredReason})`,
@@ -58,6 +79,7 @@ function buildEnglishOutput(
     `- active principles: ${stats.activeCount}`,
     `- deprecated principles: ${stats.deprecatedCount}`,
     `- last promoted: ${stats.lastPromotedAt ?? 'none'}`,
+    `- internalization routes: ${formatRouteRecommendations(recommendations, '--')}`,
     '',
     'Metadata',
     `- workspace: ${workspaceDir}`,
@@ -75,30 +97,32 @@ function buildEnglishOutput(
   return lines.join('\n');
 }
 
+// eslint-disable-next-line @typescript-eslint/max-params -- Reason: Command handler signature must match OpenClaw plugin interface - breaking API change to options objects would affect public contracts
 function buildChineseOutput(
   workspaceDir: string,
   sessionId: string | null,
   warnings: string[],
   stats: ReturnType<EvolutionReducerImpl['getStats']>,
-  summary: ReturnType<typeof RuntimeSummaryService.getSummary>
+  summary: ReturnType<typeof RuntimeSummaryService.getSummary>,
+  recommendations: InternalizationRouteRecommendation[],
 ): string {
   const lines: string[] = [
     '进化状态',
     '================',
     '',
     '控制面',
-    `- 会话 GFI: 当前 ${formatNumber(summary.gfi.current)}，峰值 ${formatNumber(summary.gfi.peak)}（${summary.gfi.dataQuality}）`,
+    `- 会话 GFI: 当前 ${formatNumber(summary.gfi.current)}，峰值 ${formatNumber(summary.gfi.peak)} (${summary.gfi.dataQuality})`,
     `- GFI 来源: ${formatSources(summary.gfi.sources)}`,
-    `- Pain Flag: ${summary.pain.activeFlag ? 'active' : 'inactive'}${summary.pain.activeFlagSource ? `（${summary.pain.activeFlagSource}）` : ''}`,
+    `- Pain Flag: ${summary.pain.activeFlag ? 'active' : 'inactive'}${summary.pain.activeFlagSource ? ` (${summary.pain.activeFlagSource})` : ''}`,
     `- 最近 Pain 信号: ${summary.pain.lastSignal ? `${summary.pain.lastSignal.source}${summary.pain.lastSignal.reason ? ` - ${summary.pain.lastSignal.reason}` : ''}` : '--'}`,
-    `- Gate 事件: block ${formatNumber(summary.gate.recentBlocks)}，bypass ${formatNumber(summary.gate.recentBypasses)}（${summary.gate.dataQuality}）`,
+    `- Gate 事件: block ${formatNumber(summary.gate.recentBlocks)}，bypass ${formatNumber(summary.gate.recentBypasses)} (${summary.gate.dataQuality})`,
     '',
     '进化',
-    `- 队列: pending ${summary.evolution.queue.pending}，in_progress ${summary.evolution.queue.inProgress}，completed ${summary.evolution.queue.completed}（${summary.evolution.dataQuality}）`,
-    `- Legacy Directive File: ${summary.phase3.legacyDirectiveFilePresent ? 'present' : 'missing'} （兼容仅显示产物）`,
-    `- 注：Legacy directive file 不是 Phase 3 合格性的真实源。队列是唯一权威的执行真实源。`,
-    `- Active Evolution Task: ${summary.evolution.directive.taskPreview ?? '--'}`,
-    `- Phase 3: ready ${summary.phase3.phase3ShadowEligible ? 'yes' : 'no'}，queueTruthReady ${summary.phase3.queueTruthReady ? 'yes' : 'no'}，eligible ${summary.phase3.evolutionEligible}，reference_only ${summary.phase3.evolutionReferenceOnly}，rejected ${summary.phase3.evolutionRejected}${summary.phase3.evolutionReferenceOnlyReasons.length > 0 ? `（reference ${summary.phase3.evolutionReferenceOnlyReasons.slice(0, 2).join(', ')}）` : ''}${summary.phase3.evolutionRejectedReasons.length > 0 ? `（${summary.phase3.evolutionRejectedReasons.slice(0, 3).join(', ')}）` : ''}`,
+    `- 队列: pending ${summary.evolution.queue.pending}，in_progress ${summary.evolution.queue.inProgress}，completed ${summary.evolution.queue.completed} (${summary.evolution.dataQuality})`,
+    `- Legacy Directive File: ${summary.phase3.legacyDirectiveFilePresent ? 'present' : 'missing'}（仅兼容展示）`,
+    '- 注意：Legacy directive file 不是 Phase 3 合格性的真实来源，队列才是唯一权威的执行真相。',
+    `- 当前进化任务: ${summary.evolution.directive.taskPreview ?? '--'}`,
+    `- Phase 3: ready ${summary.phase3.phase3ShadowEligible ? 'yes' : 'no'}，queueTruthReady ${summary.phase3.queueTruthReady ? 'yes' : 'no'}，eligible ${summary.phase3.evolutionEligible}，reference_only ${summary.phase3.evolutionReferenceOnly}，rejected ${summary.phase3.evolutionRejected}${summary.phase3.evolutionReferenceOnlyReasons.length > 0 ? ` (reference ${summary.phase3.evolutionReferenceOnlyReasons.slice(0, 2).join(', ')})` : ''}${summary.phase3.evolutionRejectedReasons.length > 0 ? ` (${summary.phase3.evolutionRejectedReasons.slice(0, 3).join(', ')})` : ''}`,
     `- Phase 3 Legacy Directive File: ${summary.phase3.directiveStatus} (${summary.phase3.directiveIgnoredReason})`,
     '',
     '原则统计',
@@ -107,10 +131,11 @@ function buildChineseOutput(
     `- 生效原则: ${stats.activeCount}`,
     `- 已废弃原则: ${stats.deprecatedCount}`,
     `- 最近晋升: ${stats.lastPromotedAt ?? '无'}`,
+    `- 内化路由: ${formatRouteRecommendations(recommendations, '--')}`,
     '',
     '元数据',
     `- 工作区: ${workspaceDir}`,
-    `- Session: ${sessionId ?? '--'}（${summary.metadata.selectedSessionReason}）`,
+    `- Session: ${sessionId ?? '--'} (${summary.metadata.selectedSessionReason})`,
     `- 生成时间: ${summary.metadata.generatedAt}`,
   ];
 
@@ -127,20 +152,40 @@ function buildChineseOutput(
 export function handleEvolutionStatusCommand(ctx: PluginCommandContext): { text: string } {
   const workspaceDir = (ctx.config?.workspaceDir as string) || process.cwd();
   const sessionId = (ctx as { sessionId?: string | null }).sessionId ?? null;
-  const reducer = new EvolutionReducerImpl({ workspaceDir });
+  // #207/#210: Use WorkspaceContext to get evolutionReducer with stateDir
+  const wctx = WorkspaceContext.fromHookContext({ workspaceDir });
+  const reducer = wctx.evolutionReducer;
   const stats = reducer.getStats();
   const summary = RuntimeSummaryService.getSummary(workspaceDir, { sessionId });
+  const recommendations = WorkspaceContext.fromHookContext({ workspaceDir })
+    .principleLifecycle
+    .recomputeAll()
+    .map((assessment) => assessment.routeRecommendation);
   const rawLang = (ctx.config?.language as string) || 'en';
   const lang = normalizeLanguage(rawLang);
   const warnings = summary.metadata.warnings.slice(0, 12);
 
   if (lang === 'zh') {
     return {
-      text: buildChineseOutput(workspaceDir, summary.metadata.sessionId, warnings, stats, summary),
+      text: buildChineseOutput(
+        workspaceDir,
+        summary.metadata.sessionId,
+        warnings,
+        stats,
+        summary,
+        recommendations,
+      ),
     };
   }
 
   return {
-    text: buildEnglishOutput(workspaceDir, summary.metadata.sessionId, warnings, stats, summary),
+    text: buildEnglishOutput(
+      workspaceDir,
+      summary.metadata.sessionId,
+      warnings,
+      stats,
+      summary,
+      recommendations,
+    ),
   };
 }

package/src/commands/export.ts

@@ -42,14 +42,16 @@ export function handleExportCommand(ctx: PluginCommandContext): PluginCommandRes
         };
       }
 
+       
+       
       return {
         text: zh
-          ? `已导出 ORPO 决策点样本到 ${result.manifest!.exportPath}，` +
-              `共 ${result.manifest!.sampleCount} 条，模型家族: ${result.manifest!.targetModelFamily}，` +
-              `数据集指纹: ${result.manifest!.datasetFingerprint.substring(0, 16)}...`
-          : `Exported ORPO decision-point samples to ${result.manifest!.exportPath}, ` +
-              `${result.manifest!.sampleCount} samples, target: ${result.manifest!.targetModelFamily}, ` +
-              `dataset fingerprint: ${result.manifest!.datasetFingerprint.substring(0, 16)}...`,
+          ? `已导出 ORPO 决策点样本到 ${result.manifest!.exportPath}，` + // eslint-disable-line @typescript-eslint/no-non-null-assertion -- Reason: caller guarantees manifest exists via success check
+              `共 ${result.manifest!.sampleCount} 条，模型家族: ${result.manifest!.targetModelFamily}，` + // eslint-disable-line @typescript-eslint/no-non-null-assertion -- Reason: caller guarantees manifest exists via success check
+              `数据集指纹: ${result.manifest!.datasetFingerprint.substring(0, 16)}...` // eslint-disable-line @typescript-eslint/no-non-null-assertion -- Reason: caller guarantees manifest exists via success check
+          : `Exported ORPO decision-point samples to ${result.manifest!.exportPath}, ` + // eslint-disable-line @typescript-eslint/no-non-null-assertion -- Reason: caller guarantees manifest exists via success check
+              `${result.manifest!.sampleCount} samples, target: ${result.manifest!.targetModelFamily}, ` + // eslint-disable-line @typescript-eslint/no-non-null-assertion -- Reason: caller guarantees manifest exists via success check
+              `dataset fingerprint: ${result.manifest!.datasetFingerprint.substring(0, 16)}...`, // eslint-disable-line @typescript-eslint/no-non-null-assertion -- Reason: caller guarantees manifest exists via success check
       };
     }
 

package/src/commands/focus.ts

@@ -10,7 +10,6 @@
 
 import * as fs from 'fs';
 import * as path from 'path';
-import { randomUUID } from 'node:crypto';
 import type { PluginCommandContext, PluginCommandResult, OpenClawPluginApi } from '../openclaw-sdk.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 import {
@@ -24,19 +23,6 @@ import {
   cleanupStaleInfo,
 } from '../core/focus-history.js';
 
-/**
- * 清理 Markdown 代码块围栏
- * 移除开头的 ```lang 和结尾的 ```
- */
-function stripMarkdownFence(content: string): string {
-  let result = content.trim();
-  // 移除开头的代码块标记（如 ```markdown, ```text 等）
-  result = result.replace(/^```[\w]*\n?/, '');
-  // 移除结尾的代码块标记
-  result = result.replace(/\n?```$/, '');
-  return result.trim();
-}
-
 /**
  * 获取工作区目录
  */
@@ -295,6 +281,7 @@ async function compressFocus(
   cleanupHistory(focusPath);
 
   // 5. 压缩内容
+  // eslint-disable-next-line @typescript-eslint/init-declarations -- assigned in both try and catch blocks
   let compressedContent: string;
   try {
     compressedContent = compressFocusContent(oldContent, workspaceDir);
@@ -305,10 +292,9 @@ async function compressFocus(
   }
 
   // 6. 更新版本号和日期
-  const versionParts = oldVersion.split('.');
-  const majorVersion = parseInt(versionParts[0], 10) || 1;
-  const newVersion = `${majorVersion + 1}`;
-  const today = new Date().toISOString().split('T')[0];
+  const [majorVersion] = oldVersion.split('.');
+  const newVersion = `${(parseInt(majorVersion, 10) || 1) + 1}`;
+  const [today] = new Date().toISOString().split('T');
   const newContent = compressedContent
     .replace(/\*\*版本\*\*:\s*v[\d.]+/i, `**版本**: v${newVersion}`)
     .replace(/\*\*更新\*\*:\s*\d{4}-\d{2}-\d{2}/, `**更新**: ${today}`);
@@ -398,7 +384,7 @@ function rollbackFocus(workspaceDir: string, index: number, isZh: boolean): stri
   // 恢复历史版本
   const restoredVersion = extractVersion(historyContent);
   const restoredDate = extractDate(historyContent);
-  const today = new Date().toISOString().split('T')[0];
+  const [today] = new Date().toISOString().split('T');
 
   // 获取最大版本号（从当前文件或历史文件中）
   let maxVersion = parseFloat(restoredVersion) || 1;
@@ -491,6 +477,7 @@ export async function handleFocusCommand(
   // 检测语言（与 context.ts 保持一致）
   const isZh = (ctx.config?.language as string) === 'zh';
 
+  // eslint-disable-next-line @typescript-eslint/init-declarations -- assigned in all switch cases
   let result: string;
 
   switch (subCommand) {
@@ -506,7 +493,7 @@ export async function handleFocusCommand(
       result = await compressFocus(workspaceDir, isZh, api);
       break;
     case 'rollback':
-    case 'rb':
+    case 'rb': {
       const index = parseInt(args[1], 10);
       if (isNaN(index)) {
         result = isZh
@@ -516,6 +503,7 @@ export async function handleFocusCommand(
         result = rollbackFocus(workspaceDir, index, isZh);
       }
       break;
+    }
     case 'help':
     case '--help':
     case '-h':