principles-disciple 1.16.0 → 1.17.0

package/README.md

@@ -17,12 +17,21 @@ This plugin integrates with OpenClaw to provide an evolutionary programming fram
 
 ### Slash Commands
 
+All commands support **short aliases** for easier input:
+
+| Short | Full Command | Description |
+|-------|--------------|-------------|
+| `/pdi` | `/pd-init` | Initialize workspace |
+| `/pdb` | `/pd-bootstrap` | Scan environment tools |
+| `/pdr` | `/pd-research` | Research tools and capabilities |
+| `/pdt` | `/pd-thinking` | Manage thinking models |
+| `/pdrl` | `/pd-reflect` | Manually trigger nocturnal reflection |
+| `/pdd` | `/pd-daily` | Configure and send daily report |
+| `/pdg` | `/pd-grooming` | Workspace cleanup |
+| `/pdh` | `/pd-help` | Show command reference |
+
 | Command | Description |
 |---------|-------------|
-| `/pd-init` | Initialize workspace |
-| `/pd-bootstrap` | Scan environment tools |
-| `/pd-research` | Research tools and capabilities |
-| `/pd-thinking` | Manage thinking models |
 | `/pd-status` | View evolution status |
 | `/pd-context` | Control context injection |
 | `/pd-focus` | Focus file management |
@@ -34,7 +43,6 @@ This plugin integrates with OpenClaw to provide an evolutionary programming fram
 | `/nocturnal-train` | Nocturnal training operations |
 | `/nocturnal-rollout` | Nocturnal rollout and promotion |
 | `/pd-workflow-debug` | Debug workflow state |
-| `/pd-help` | Show command reference |
 
 ### Tools
 

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Evolutionary programming agent framework with strategic guardrails and reflection loops.",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "skills": [
     "./skills"
   ],
@@ -76,8 +76,8 @@
     }
   },
   "buildFingerprint": {
-    "gitSha": "a320b37a2418",
-    "bundleMd5": "6a5838169d98e4e6419e736dd034d93a",
-    "builtAt": "2026-04-09T13:57:36.081Z"
+    "gitSha": "bce835db37a0",
+    "bundleMd5": "9e44177badb37ac423669fd187bf2667",
+    "builtAt": "2026-04-10T14:01:23.050Z"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "Native OpenClaw plugin for Principles Disciple",
   "type": "module",
   "main": "./dist/bundle.js",

package/src/commands/archive-impl.ts

@@ -51,13 +51,13 @@ export function handleArchiveImplCommand(ctx: PluginCommandContext): PluginComma
 
   // 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);
 }
 
@@ -94,7 +94,7 @@ function _handleListArchivable(
   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,

package/src/commands/capabilities.ts

@@ -24,7 +24,7 @@ function scanEnvironment(wctx: WorkspaceContext): any {
         available: true,
         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
+      // 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 };
     }

package/src/commands/context.ts

@@ -98,7 +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',
@@ -213,7 +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) {
@@ -314,7 +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

@@ -69,7 +69,7 @@ function _handleListActive(
   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,

package/src/commands/evolution-status.ts

@@ -45,7 +45,7 @@ function formatRouteRecommendations(
     .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,
@@ -97,7 +97,7 @@ 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,

package/src/commands/focus.ts

@@ -281,7 +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);
@@ -477,7 +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) {

package/src/commands/nocturnal-train.ts

@@ -270,12 +270,12 @@ Hardware tiers:
       // This closes the gap in the create-experiment -> trainer -> import-result chain.
       // NOTE: This blocks until training completes (could be minutes).
       if (runNow) {
-        // eslint-disable-next-line @typescript-eslint/no-shadow -- Reason: shadowing is intentional - inner block scoping for trainer execution
+         
         const {spec} = createResult;
         const baseDir = TRAINER_SCRIPTS_DIR;
         const scriptPath = path.join(baseDir, 'main.py');
         const specPath = path.join(baseDir, `experiment-${spec.experimentId}.json`);
-        // eslint-disable-next-line @typescript-eslint/no-shadow -- Reason: shadowing is intentional - inner block scoping for trainer output directory
+         
         const {outputDir} = spec;
         const resultFilePath = path.join(outputDir, `result-${spec.experimentId}.json`);
 
@@ -286,7 +286,7 @@ Hardware tiers:
         }
         fs.writeFileSync(specPath, JSON.stringify(spec, null, 2), 'utf-8');
 
-        // eslint-disable-next-line @typescript-eslint/init-declarations, @typescript-eslint/consistent-type-imports -- Reason: type assertion required - trainer result type from external contract module
+         
         let trainerResult!: import('../core/external-training-contract.js').TrainingExperimentResult;
 
         try {
@@ -394,7 +394,7 @@ Hardware tiers:
 
         // Process trainer result (register checkpoint)
         // dry_run returns null (no checkpoint); other statuses throw on error
-        // eslint-disable-next-line @typescript-eslint/init-declarations -- Reason: assigned in try block immediately after declaration
+         
         let processed: { checkpointId: string; checkpointRef: string } | null;
         try {
           processed = program.processResult({
@@ -536,7 +536,7 @@ Next steps:
         }
       }
 
-      // eslint-disable-next-line @typescript-eslint/init-declarations, @typescript-eslint/no-explicit-any -- Reason: JSON.parse returns dynamic JSON - type unknown at parse time, narrowed via type narrowing below
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Reason: JSON.parse returns dynamic JSON - type unknown at parse time, narrowed via type narrowing below
       let result: any;
       try {
         result = JSON.parse(resultJson);
@@ -567,7 +567,7 @@ Next steps:
 
       // Process the result
       const program = new TrainingProgram(workspaceDir);
-      // eslint-disable-next-line @typescript-eslint/init-declarations -- Reason: assigned in try block immediately after declaration
+       
       let processed: { checkpointId: string; checkpointRef: string } | null;
       try {
         processed = program.processResult({

package/src/commands/pain.ts

@@ -96,7 +96,7 @@ export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResul
 
     // Handle empathy subcommand
     if (args.startsWith('empathy')) {
-        // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: mutual recursion between main handler and empathy subcommand handler - reordering would break logical grouping
+         
         return handleEmpathySubcommand(wctx, args, sessionId, isZh);
     }
 
@@ -126,7 +126,7 @@ export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResul
     const gfiBar = createProgressBar(gfi, 100, 15);
     
     // Determine Mental Mode (aligned with prompt.ts logic)
-    // eslint-disable-next-line no-useless-assignment -- Reason: initial value unused due to immediate reassignment - keeping for type inference compatibility
+     
     let mentalMode = '';
     if (isZh) {
         if (gfi >= 70) mentalMode = '🚑 救赎模式 (HUMBLE_RECOVERY)';
@@ -139,7 +139,7 @@ export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResul
     }
     
     // Determine health status based on GFI
-    // eslint-disable-next-line no-useless-assignment -- Reason: initial values unused due to immediate reassignment in all branches
+     
     let healthLabel = 'Healthy';
     let suggestionText = '';
 
@@ -218,7 +218,7 @@ export function handlePainCommand(ctx: PluginCommandContext): PluginCommandResul
 /**
  * Handle /pd-status empathy subcommand
  */
-// eslint-disable-next-line @typescript-eslint/max-params -- Reason: empathy subcommand requires all 4 context params - refactoring would break API
+ 
 function handleEmpathySubcommand(
     wctx: WorkspaceContext,
     args: string,

package/src/commands/pd-reflect.ts

@@ -0,0 +1,87 @@
+/**
+ * PD Reflect Command (/pd-reflect)
+ *
+ * Manually trigger a sleep_reflection task, bypassing idle check.
+ * This command must operate on an explicitly resolved active workspace.
+ */
+
+import { PluginCommandDefinition, PluginCommandContext, PluginCommandResult, OpenClawPluginApi } from '../openclaw-sdk.js';
+import { acquireQueueLock, EVOLUTION_QUEUE_LOCK_SUFFIX } from '../service/evolution-worker.js';
+import * as fs from 'fs';
+import * as path from 'path';
+
+interface PdReflectContext extends PluginCommandContext {
+  api?: OpenClawPluginApi;
+  workspaceDir?: string;
+}
+
+export const handlePdReflect: PluginCommandDefinition = {
+  name: 'pd-reflect',
+  description: 'Manually trigger Nocturnal sleep reflection pipeline',
+  acceptsArgs: false,
+  requireAuth: false,
+  handler: async (ctx: PdReflectContext): Promise<PluginCommandResult> => {
+    try {
+      const workspaceDir = ctx.workspaceDir;
+      if (!workspaceDir) {
+        return { text: 'Cannot determine workspace directory. Ensure you are in an active workspace.', isError: true };
+      }
+
+      const stateDir = path.join(workspaceDir, '.state');
+      const queuePath = path.join(stateDir, 'evolution_queue.json');
+
+      // Acquire lock before modifying queue
+      const releaseLock = await acquireQueueLock(queuePath, ctx.api?.logger, EVOLUTION_QUEUE_LOCK_SUFFIX);
+      let taskId: string | undefined;
+      try {
+        let rawQueue: unknown[] = [];
+        try {
+          rawQueue = JSON.parse(fs.readFileSync(queuePath, 'utf8')) as unknown[];
+        } catch {
+          rawQueue = [];
+        }
+
+        const hasPending = rawQueue.some((item: unknown) => {
+          const task = item as Record<string, string> | undefined;
+          return task?.taskKind === 'sleep_reflection' && (task?.status === 'pending' || task?.status === 'in_progress');
+        });
+        if (hasPending) {
+          return { text: 'A sleep_reflection task is already pending. Wait for it to complete or fail.' };
+        }
+
+        const now = new Date();
+        taskId = `manual_${now.getTime().toString(36).slice(-8)}`;
+        const nowIso = now.toISOString();
+
+        rawQueue.push({
+          id: taskId,
+          taskKind: 'sleep_reflection',
+          priority: 'high',
+          score: 50,
+          source: 'manual',
+          reason: 'Manual reflection triggered via /pd-reflect',
+          trigger_text_preview: 'User commanded /pd-reflect',
+          timestamp: nowIso,
+          enqueued_at: nowIso,
+          status: 'pending',
+          traceId: taskId,
+          retryCount: 0,
+          maxRetries: 1,
+        });
+
+        fs.writeFileSync(queuePath, JSON.stringify(rawQueue, null, 2), 'utf8');
+      } finally {
+        releaseLock();
+      }
+
+      return {
+        text: `Nocturnal reflection task enqueued: \`${taskId}\`\n\nIt will be processed in the next evolution worker cycle (~15s). Check .state/nocturnal/samples/ for results.`,
+      };
+    } catch (error) {
+      return {
+        text: `Failed to trigger reflection: ${String(error)}`,
+        isError: true,
+      };
+    }
+  },
+};

package/src/commands/rollback-impl.ts

@@ -57,11 +57,11 @@ export function handleRollbackImplCommand(ctx: PluginCommandContext): PluginComm
 
   // List active
   if (subcommand === 'list' || subcommand === '') {
-    // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: Mutual recursion between helper functions - reordering would break logical grouping
+     
     return _handleListActiveRollback(stateDir, isZh);
   }
 
-  // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: Mutual recursion between helper functions - reordering would break logical grouping
+   
   return _handleRollbackImpl(workspaceDir, stateDir, implId, reason, isZh, ctx.sessionId);
 }
 
@@ -103,7 +103,7 @@ function _handleListActiveRollback(
   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 _handleRollbackImpl(
   workspaceDir: string,
   stateDir: string,
@@ -138,7 +138,7 @@ function _handleRollbackImpl(
   // Step 1: Current active -> disabled
   transitionImplementationState(stateDir, implId, 'disabled');
 
-  // eslint-disable-next-line @typescript-eslint/init-declarations -- Reason: assigned immediately in if/else branches before use
+   
   let restoredMessage: string;
 
   if (previousActiveId && allImpls.some((i) => i.id === previousActiveId)) {

package/src/commands/rollback.ts

@@ -44,9 +44,9 @@ Usage:
         };
     }
 
-    // eslint-disable-next-line @typescript-eslint/init-declarations -- Reason: assigned immediately in if/else branches before use
+     
     let eventId: string | null;
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars, no-unused-vars -- Reason: triggerMethod is reserved for future extension - tracking rollback trigger source
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars -- Reason: triggerMethod is reserved for future extension - tracking rollback trigger source
     const _triggerMethod = 'user_command' as const;
 
     if (args === 'last') {

package/src/commands/samples.ts

@@ -29,11 +29,11 @@ export function handleSamplesCommand(ctx: PluginCommandContext): PluginCommandRe
     }
     const normalizedDecision = decision === 'approve' ? 'approved' : 'rejected';
     const note = noteParts.join(' ').trim();
-    // eslint-disable-next-line @typescript-eslint/init-declarations -- assigned in try block, catch has early return
+     
     let record;
     try {
       record = wctx.trajectory.reviewCorrectionSample(sampleId, normalizedDecision, note);
-    /* eslint-disable @typescript-eslint/no-unused-vars, no-unused-vars -- Reason: error handling only - returning failure response */
+    /* eslint-disable @typescript-eslint/no-unused-vars -- Reason: error handling only - returning failure response */
     } catch (error) {
       return {
         text: zh

package/src/commands/workflow-debug.ts

@@ -20,7 +20,7 @@ function formatState(state: string): string {
     return `${icon} ${state}`;
 }
 
-// eslint-disable-next-line @typescript-eslint/max-params -- Reason: debug output builder requires all context parameters - refactoring would break API
+ 
 function buildOutput(
     workflowId: string,
     summary: ReturnType<InstanceType<typeof WorkflowStore>['getWorkflow']>,

package/src/config/errors.ts

@@ -15,7 +15,7 @@
 export class PdError extends Error {
   constructor(
     message: string,
-    // eslint-disable-next-line no-unused-vars -- public parameter property, accessed externally
+     
     public readonly code: string,
     options?: { cause?: unknown }
   ) {

package/src/core/adaptive-thresholds.ts

@@ -300,7 +300,7 @@ export function getEffectiveThresholds(stateDir: string): ThresholdValues {
  * @param reason - Reason for the adjustment (required for tracking)
  * @returns UpdateThresholdResult
  */
-// eslint-disable-next-line @typescript-eslint/max-params -- Reason: threshold state update requires all parameters - refactoring would break API
+ 
 export function updateThresholdState(
   stateDir: string,
   thresholdName: ThresholdName,

package/src/core/code-implementation-storage.ts

@@ -134,7 +134,7 @@ export function writeManifest(
   });
 }
 
-// eslint-disable-next-line @typescript-eslint/max-params -- Reason: entry source writer requires state + id + source - refactoring would break API
+ 
 export function writeEntrySource(
   stateDir: string,
   implId: string,
@@ -189,7 +189,7 @@ export function loadEntrySource(stateDir: string, implId: string): string | null
  *
  * Idempotent: calling again with the same implId will NOT overwrite an existing entry.js.
  */
-// eslint-disable-next-line @typescript-eslint/max-params -- Reason: asset dir creation requires state + id + version - refactoring would break API
+ 
 export function createImplementationAssetDir(
   stateDir: string,
   implId: string,

package/src/core/config.ts

@@ -290,7 +290,7 @@ export class PainConfig {
     /**
      * Basic validation for critical settings
      */
-    // eslint-disable-next-line @typescript-eslint/class-methods-use-this -- Reason: validate is a pure validation function that modifies settings in place, no this reference needed
+     
     private validate(settings: PainSettings): void {
         // Ensure intervals are positive
         if (settings.intervals.worker_poll_ms < 1000) settings.intervals.worker_poll_ms = 15 * 60 * 1000;

package/src/core/diagnostician-task-store.ts

@@ -82,7 +82,7 @@ export async function addDiagnosticianTask(
 ): Promise<void> {
   const filePath = resolveTasksPath(stateDir);
   await withLockAsync(filePath, async () => {
-    // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: function defined later in file, hoisting pattern
+     
     const store = readTaskStoreSync(filePath);
     store.tasks[taskId] = {
       prompt,
@@ -105,7 +105,7 @@ export async function completeDiagnosticianTask(
 ): Promise<void> {
   const filePath = resolveTasksPath(stateDir);
   await withLockAsync(filePath, async () => {
-    // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: function defined later in file, hoisting pattern
+     
     const store = readTaskStoreSync(filePath);
     delete store.tasks[taskId];
     const tmpPath = filePath + '.tmp';

package/src/core/empathy-keyword-matcher.ts

@@ -80,7 +80,7 @@ export function loadKeywordStore(stateDir: string, language?: 'zh' | 'en'): Empa
   try {
     if (!fs.existsSync(filePath)) {
       const store = createDefaultKeywordStore(language);
-      // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: function defined later in file, hoisting pattern
+       
       saveKeywordStore(stateDir, store);
       return store;
     }
@@ -92,7 +92,7 @@ export function loadKeywordStore(stateDir: string, language?: 'zh' | 'en'): Empa
     if (!parsed.terms || !parsed.stats || !parsed.version) {
       console.warn('[PD:Empathy] Invalid keyword store format, creating default');
       const store = createDefaultKeywordStore(language);
-      // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: function defined later in file, hoisting pattern
+       
       saveKeywordStore(stateDir, store);
       return store;
     }
@@ -101,7 +101,7 @@ export function loadKeywordStore(stateDir: string, language?: 'zh' | 'en'): Empa
   } catch (e) {
     console.warn(`[PD:Empathy] Failed to load keyword store: ${e}`);
     const store = createDefaultKeywordStore(language);
-    // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: function defined later in file, hoisting pattern
+     
     saveKeywordStore(stateDir, store);
     return store;
   }

package/src/core/event-log.ts

@@ -107,7 +107,7 @@ export class EventLog {
     this.record('warn', 'failure', sessionId, { message, ...context });
   }
   
-  // eslint-disable-next-line @typescript-eslint/max-params -- Reason: event record requires type + category + session + data - refactoring would break internal API
+   
   private record(
     type: EventType, 
     category: EventCategory, 
@@ -134,7 +134,7 @@ export class EventLog {
     }
   }
 
-  // eslint-disable-next-line @typescript-eslint/class-methods-use-this -- Reason: utility method doesn't require this - pure function
+   
   private formatDate(date: Date): string {
     return date.toISOString().split('T')[0];
   }
@@ -160,7 +160,7 @@ export class EventLog {
     }
 
     if (entry.type === 'tool_call') {
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars, no-unused-vars -- Reason: data used for type narrowing only, actual fields accessed via stats
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars -- Reason: data used for type narrowing only, actual fields accessed via stats
       const _data = entry.data as unknown as ToolCallEventData;
       stats.tools.total++;
       if (entry.category === 'success') stats.tools.success++;
@@ -243,7 +243,7 @@ export class EventLog {
     return this.eventBuffer.map((entry) => ({ ...entry, data: { ...entry.data } }));
   }
 
-  // eslint-disable-next-line @typescript-eslint/class-methods-use-this -- Reason: getEventDedupKey is a pure key-generation function, no this reference needed
+   
   private getEventDedupKey(entry: EventLogEntry): string {
     const eventId = typeof (entry.data as { eventId?: unknown } | undefined)?.eventId === 'string'
       ? String((entry.data as { eventId?: string }).eventId)
@@ -459,7 +459,7 @@ export class EventLog {
    * Rollback an empathy event by ID.
    * Returns the rolled back score, or 0 if event not found.
    */
-  // eslint-disable-next-line @typescript-eslint/max-params -- Reason: rollback requires eventId + sessionId + reason + triggeredBy - refactoring would break API
+   
   rollbackEmpathyEvent(eventId: string, sessionId: string | undefined, reason: string, triggeredBy: 'user_command' | 'natural_language' | 'system'): number {
     const allEvents = this.getMergedEvents();
     let foundEvent: { entry: EventLogEntry; data: PainSignalEventData } | null = null;

package/src/core/evolution-engine.ts

@@ -323,7 +323,7 @@ export class EvolutionEngine {
 
   // ===== 事件管理 =====
 
-  // eslint-disable-next-line @typescript-eslint/max-params -- Reason: event creation requires all event fields - refactoring would break internal structure
+   
   private createEvent(
     type: 'success' | 'failure',
     taskHash: string,
@@ -385,7 +385,7 @@ export class EvolutionEngine {
     return this.createNewScorecard();
   }
 
-  // eslint-disable-next-line @typescript-eslint/class-methods-use-this -- Reason: createNewScorecard is a factory function, no this reference needed
+   
   private createNewScorecard(): EvolutionScorecard {
     const now = new Date().toISOString();
     return {
@@ -444,7 +444,7 @@ export class EvolutionEngine {
     } catch (e) {
       console.error(`[Evolution] Failed to save scorecard: ${String(e)}`);
       this.scheduleRetrySave();
-      /* eslint-disable @typescript-eslint/no-unused-vars, no-unused-vars -- Reason: intentionally ignored - cleanup failure should not mask original error */
+      /* eslint-disable @typescript-eslint/no-unused-vars -- Reason: intentionally ignored - cleanup failure should not mask original error */
       try { fs.unlinkSync(tempPath); } catch (_e) {
         // Cleanup failure intentionally ignored - should not mask original error
       }
@@ -527,7 +527,7 @@ export class EvolutionEngine {
 
   // ===== 工具方法 =====
 
-  // eslint-disable-next-line @typescript-eslint/class-methods-use-this -- Reason: generateId is a pure utility function, no this reference needed
+   
   private generateId(): string {
     return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
   }

package/src/core/evolution-logger.ts

@@ -264,7 +264,7 @@ export class EvolutionLogger {
     durationMs?: number;
     principlesGenerated?: number;
   }): void {
-    // eslint-disable-next-line @typescript-eslint/init-declarations -- assigned in all if/else branches
+     
     let summary: string;
     if (params.resolution === 'marker_detected' || params.resolution === 'late_marker_principle_created') {
       summary = `任务 ${params.taskId} 完成，已生成 ${params.principlesGenerated || 0} 条原则`;

package/src/core/evolution-reducer.ts

@@ -22,7 +22,7 @@ import type {
 import { isCompleteDetectorMetadata } from './evolution-types.js';
 import { updateTrainingStore } from './principle-tree-ledger.js';
 
-/* eslint-disable no-unused-vars -- Reason: interface method params are type signatures, implementations use actual values */
+ 
 export interface EvolutionReducer {
 
   emit(_event: EvolutionLoopEvent): void;
@@ -72,7 +72,7 @@ export interface EvolutionReducer {
     lastPromotedAt: string | null;
   };
 }
-/* eslint-enable no-unused-vars */
+ 
 
 const PROBATION_SUCCESS_THRESHOLD = 3;
 const CIRCUIT_BREAKER_THRESHOLD = 3;
@@ -663,7 +663,7 @@ export class EvolutionReducerImpl implements EvolutionReducer {
     });
   }
 
-  // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars -- Reason: event timestamp intentionally unused, only data payload matters
+   
   private onPainDetected(data: PainDetectedData, _eventTs: string): void {
     const trigger = String(data.reason ?? data.source ?? 'unknown trigger');