principles-disciple 1.11.0 → 1.13.0

package/src/core/evolution-reducer.ts

@@ -20,19 +20,29 @@ import type {
   PrincipleSuggestedRule,
 } from './evolution-types.js';
 import { isCompleteDetectorMetadata } from './evolution-types.js';
+import { updateTrainingStore, createPrinciple } from './principle-tree-ledger.js';
+import type { LedgerPrinciple } from './principle-tree-ledger.js';
 
+ 
 export interface EvolutionReducer {
-  emit(event: EvolutionLoopEvent): void;
-  emitSync(event: EvolutionLoopEvent): void;
+
+  emit(_event: EvolutionLoopEvent): void;
+
+  emitSync(_event: EvolutionLoopEvent): void;
   getEventLog(): EvolutionLoopEvent[];
   getCandidatePrinciples(): Principle[];
   getProbationPrinciples(): Principle[];
   getActivePrinciples(): Principle[];
-  getPrincipleById(id: string): Principle | null;
-  promote(principleId: string, reason?: string): void;
-  deprecate(principleId: string, reason: string): void;
-  rollbackPrinciple(principleId: string, reason: string): void;
-  recordProbationFeedback(principleId: string, success: boolean): void;
+
+  getPrincipleById(_id: string): Principle | null;
+
+  promote(_principleId: string, _reason?: string): void;
+
+  deprecate(_principleId: string, _reason: string): void;
+
+  rollbackPrinciple(_principleId: string, _reason: string): void;
+
+  recordProbationFeedback(_principleId: string, _success: boolean): void;
   /**
    * Creates a new principle with generalized trigger/action from diagnostician.
    * Called after diagnostician analysis to create principle directly.
@@ -47,6 +57,8 @@ export interface EvolutionReducer {
     detectorMetadata?: PrincipleDetectorSpec;
     /** Highly abstracted principle text — if absent, falls back to action-based title */
     abstractedPrinciple?: string;
+    /** Associated core axiom (e.g., "T-01") */
+    coreAxiomId?: string;
     // ── Principle-Tree metadata (Phase 1, optional) ──
     priority?: 'P0' | 'P1' | 'P2';
     scope?: 'general' | 'domain';
@@ -61,6 +73,7 @@ export interface EvolutionReducer {
     lastPromotedAt: string | null;
   };
 }
+ 
 
 const PROBATION_SUCCESS_THRESHOLD = 3;
 const CIRCUIT_BREAKER_THRESHOLD = 3;
@@ -72,14 +85,16 @@ export class EvolutionReducerImpl implements EvolutionReducer {
   private readonly blacklistPath: string;
   private readonly principlesPath: string;
   private readonly workspaceDir: string;
+  private readonly stateDir: string | undefined;
   private readonly memoryEvents: EvolutionLoopEvent[] = [];
   private readonly principles = new Map<string, Principle>();
   private readonly failureStreak = new Map<string, number>();
   private lastPromotedAt: string | null = null;
   private isReplaying = false;
 
-  constructor(opts: { workspaceDir: string }) {
+  constructor(opts: { workspaceDir: string; stateDir?: string }) {
     this.workspaceDir = opts.workspaceDir;
+    this.stateDir = opts.stateDir;
     const resolver = new PathResolver({ workspaceDir: opts.workspaceDir });
     this.streamPath = resolver.resolve('EVOLUTION_STREAM');
     this.lockTargetPath = resolver.resolve('EVOLUTION_LOCK');
@@ -222,6 +237,7 @@ export class EvolutionReducerImpl implements EvolutionReducer {
     evaluability?: PrincipleEvaluatorLevel;
     detectorMetadata?: PrincipleDetectorSpec;
     abstractedPrinciple?: string;
+    coreAxiomId?: string;
     priority?: 'P0' | 'P1' | 'P2';
     scope?: 'general' | 'domain';
     domain?: string;
@@ -237,17 +253,18 @@ export class EvolutionReducerImpl implements EvolutionReducer {
       return null;
     }
 
-    // Evaluability defaults to 'manual_only' — the only way to get auto-trainable
-    // is to explicitly provide valid detectorMetadata.
-    // Enforce: deterministic/weak_heuristic requires complete detectorMetadata to be present.
-    let evaluability: PrincipleEvaluatorLevel = params.evaluability ?? 'manual_only';
-    if (evaluability !== 'manual_only' && !isCompleteDetectorMetadata(params.detectorMetadata)) {
+    // Evaluability defaults to 'weak_heuristic' — allows basic pattern-matching
+    // evaluation without requiring full detectorMetadata.
+    // #212: Only 'deterministic' requires complete detectorMetadata.
+    // 'weak_heuristic' can work with just the trigger pattern.
+    let evaluability: PrincipleEvaluatorLevel = params.evaluability ?? 'weak_heuristic';
+    if (evaluability === 'deterministic' && !isCompleteDetectorMetadata(params.detectorMetadata)) {
       SystemLogger.log(
         this.workspaceDir,
         'EVALUABILITY_DOWNGRADED',
-        `Principle for painId "${params.painId}" requested evaluability="${evaluability}" without detectorMetadata — downgrading to "manual_only". Provide valid detectorMetadata to enable auto-training.`
+        `Principle for painId "${params.painId}" requested evaluability="deterministic" without detectorMetadata — downgrading to "weak_heuristic". Provide valid detectorMetadata for deterministic evaluation.`
       );
-      evaluability = 'manual_only';
+      evaluability = 'weak_heuristic';
     }
 
     // Check if a principle already exists for this painId
@@ -265,16 +282,17 @@ export class EvolutionReducerImpl implements EvolutionReducer {
       existingPrinciple.version += 1;
       if (params.evaluability !== undefined) {
         // Apply normalization (params.evaluability may be invalid without complete metadata)
+        // #212: Only 'deterministic' requires detectorMetadata; 'weak_heuristic' does not.
         const normalizedEvaluability = (() => {
-          if (params.evaluability === 'manual_only' || isCompleteDetectorMetadata(params.detectorMetadata)) {
-            return params.evaluability;
+          if (params.evaluability === 'deterministic' && !isCompleteDetectorMetadata(params.detectorMetadata)) {
+            SystemLogger.log(
+              this.workspaceDir,
+              'EVALUABILITY_DOWNGRADED',
+              `Principle update for painId "${params.painId}" requested evaluability="deterministic" without detectorMetadata — downgrading to "weak_heuristic".`
+            );
+            return 'weak_heuristic';
           }
-          SystemLogger.log(
-            this.workspaceDir,
-            'EVALUABILITY_DOWNGRADED',
-            `Principle update for painId "${params.painId}" requested evaluability="${params.evaluability}" without detectorMetadata — downgrading to "manual_only".`
-          );
-          return 'manual_only';
+          return params.evaluability;
         })();
         existingPrinciple.evaluability = normalizedEvaluability;
       }
@@ -328,6 +346,7 @@ export class EvolutionReducerImpl implements EvolutionReducer {
         ? structuredClone(params.detectorMetadata)
         : undefined,
       abstractedPrinciple: params.abstractedPrinciple,
+      coreAxiomId: params.coreAxiomId,
 
       // ── Principle-Tree metadata (Phase 1, optional) ──
       priority: params.priority ?? 'P1',
@@ -362,6 +381,61 @@ export class EvolutionReducerImpl implements EvolutionReducer {
       SystemLogger.log(this.workspaceDir, 'PRINCIPLE_SYNC_WARN', `Principle ${principleId} created in memory but failed to sync to PRINCIPLES.md — manual file check required`);
     }
 
+    // #204: Write to training store so listEvaluablePrinciples() can find this principle
+    // Phase 11: Also write to tree.principles for Rule/Implementation layer support
+    if (this.stateDir) {
+      try {
+        // Determine initial internalization status based on evaluability:
+        // - manual_only: prompt_only (can only be evaluated manually)
+        // - deterministic/weak_heuristic: needs_training (auto-evaluable, ready for training)
+        const initialStatus = evaluability === 'manual_only' ? 'prompt_only' : 'needs_training';
+        
+        updateTrainingStore(this.stateDir, (trainingStore) => {
+          trainingStore[principleId] = {
+            principleId,
+            evaluability,
+            internalizationStatus: initialStatus,
+            applicableOpportunityCount: 0,
+            observedViolationCount: 0,
+            complianceRate: 0,
+            violationTrend: 0,
+            generatedSampleCount: 0,
+            approvedSampleCount: 0,
+            includedTrainRunIds: [],
+            deployedCheckpointIds: [],
+          };
+        });
+        SystemLogger.log(this.workspaceDir, 'TRAINING_STORE_UPDATED', `Principle ${principleId} added to training store with evaluability=${evaluability}, internalizationStatus=${initialStatus}`);
+
+        // Phase 11: Also create principle in tree.principles for Rule/Implementation layer
+        const treePrinciple: LedgerPrinciple = {
+          id: principleId,
+          version: 1,
+          text: principle.text,
+          coreAxiomId: principle.coreAxiomId,
+          triggerPattern: params.triggerPattern,
+          action: params.action,
+          status: principle.status,
+          priority: principle.priority ?? 'P1',
+          scope: principle.scope ?? 'general',
+          domain: principle.domain,
+          evaluability,
+          valueScore: 0,
+          adherenceRate: 0,
+          painPreventedCount: 0,
+          derivedFromPainIds: [params.painId],
+          ruleIds: [],
+          conflictsWithPrincipleIds: [],
+          createdAt: now,
+          updatedAt: now,
+        };
+        createPrinciple(this.stateDir, treePrinciple);
+        SystemLogger.log(this.workspaceDir, 'TREE_PRINCIPLE_CREATED', `Principle ${principleId} added to tree.principles`);
+      } catch (err) {
+        SystemLogger.log(this.workspaceDir, 'TRAINING_STORE_UPDATE_FAILED', `Failed to update training store for ${principleId}: ${String(err)}`);
+      }
+    }
+
     SystemLogger.log(
       this.workspaceDir,
       'PRINCIPLE_CREATED',
@@ -400,7 +474,7 @@ export class EvolutionReducerImpl implements EvolutionReducer {
 
         const header = `### ${principle.id}:`;
         const existingIdx = content.indexOf(header);
-        const formatted = this.formatPrincipleForFile(principle, content);
+        const formatted = EvolutionReducerImpl.formatPrincipleForFile(principle, content);
 
         if (existingIdx >= 0) {
           const nextPrincipleRe = /\n### [A-Za-z0-9_-]+:/g;
@@ -423,7 +497,7 @@ export class EvolutionReducerImpl implements EvolutionReducer {
     }
   }
 
-  private detectPrincipleLanguage(content: string): 'zh' | 'en' {
+  private static detectPrincipleLanguage(content: string): 'zh' | 'en' {
     if (!content) return 'zh';
     const zhMarkers = ['原则', '触发', '必须', '禁止', '验证', '例外', '来源'];
     const enMarkers = ['Trigger', 'Constraint', 'Must', 'Forbidden', 'Verification', 'Exceptions', 'Source'];
@@ -434,8 +508,8 @@ export class EvolutionReducerImpl implements EvolutionReducer {
     return zhCount >= enCount ? 'zh' : 'en';
   }
 
-  private formatPrincipleForFile(principle: Principle, existingContent: string): string {
-    const lang = this.detectPrincipleLanguage(existingContent);
+  private static formatPrincipleForFile(principle: Principle, existingContent: string): string {
+    const lang = EvolutionReducerImpl.detectPrincipleLanguage(existingContent);
     const title = principle.abstractedPrinciple
       ? (principle.abstractedPrinciple.length > 60 ? principle.abstractedPrinciple.slice(0, 57) + '...' : principle.abstractedPrinciple)
       : (principle.text.length > 60 ? principle.text.slice(0, 57) + '...' : principle.text);
@@ -550,6 +624,9 @@ export class EvolutionReducerImpl implements EvolutionReducer {
       if (data.abstractedPrinciple) {
         existing.abstractedPrinciple = data.abstractedPrinciple;
       }
+      if (data.coreAxiomId) {
+        existing.coreAxiomId = data.coreAxiomId;
+      }
       return;
     }
 
@@ -577,6 +654,7 @@ export class EvolutionReducerImpl implements EvolutionReducer {
         : undefined,
       // Restore abstractedPrinciple from event if present
       abstractedPrinciple: data.abstractedPrinciple,
+      coreAxiomId: data.coreAxiomId,
     };
     this.principles.set(principle.id, principle);
   }
@@ -612,7 +690,8 @@ export class EvolutionReducerImpl implements EvolutionReducer {
     });
   }
 
-  private onPainDetected(data: PainDetectedData, eventTs: string): void {
+   
+  private onPainDetected(data: PainDetectedData, _eventTs: string): void {
     const trigger = String(data.reason ?? data.source ?? 'unknown trigger');
 
     // Defense in depth: protocol/system tokens must never become principles,
@@ -703,15 +782,15 @@ export class EvolutionReducerImpl implements EvolutionReducer {
     fs.writeFileSync(this.blacklistPath, JSON.stringify(list, null, 2), 'utf8');
   }
 
-  private loadBlacklist(): Array<{ painId?: string; pattern?: string; reason: string; rolledBackAt: string }> {
+  private loadBlacklist(): { painId?: string; pattern?: string; reason: string; rolledBackAt: string }[] {
     if (!fs.existsSync(this.blacklistPath)) return [];
     try {
-      return JSON.parse(fs.readFileSync(this.blacklistPath, 'utf8')) as Array<{
+      return JSON.parse(fs.readFileSync(this.blacklistPath, 'utf8')) as {
         painId?: string;
         pattern?: string;
         reason: string;
         rolledBackAt: string;
-      }>;
+      }[];
     } catch (e) {
       SystemLogger.log(this.workspaceDir, 'EVOLUTION_WARN', `failed to parse blacklist: ${String(e)}`);
       return [];

package/src/core/evolution-types.ts

@@ -10,11 +10,17 @@
 
 // ===== 等级定义 =====
 
+ 
 export enum EvolutionTier {
+  // eslint-disable-next-line no-unused-vars -- Reason: enum members are used via EvolutionTier.Seed syntax - bare names unused but required for enum structure
   Seed = 1,      // 起步：150行 + 3文件 + 子智能体（现代 AI 能力已足够强）
+  // eslint-disable-next-line no-unused-vars -- Reason: enum members are used via EvolutionTier.Sprout syntax - bare names unused but required for enum structure
   Sprout = 2,    // 成长：300行 + 5文件
+  // eslint-disable-next-line no-unused-vars -- Reason: enum members are used via EvolutionTier.Sapling syntax - bare names unused but required for enum structure
   Sapling = 3,   // 独当：500行 + 10文件 + 风险路径
+  // eslint-disable-next-line no-unused-vars -- Reason: enum members are used via EvolutionTier.Tree syntax - bare names unused but required for enum structure
   Tree = 4,      // 专家：1000行 + 20文件
+  // eslint-disable-next-line no-unused-vars -- Reason: enum members are used via EvolutionTier.Forest syntax - bare names unused but required for enum structure
   Forest = 5     // 大师：完全自主
 }
 
@@ -312,6 +318,8 @@ export interface Principle {
    detectorMetadata?: PrincipleDetectorSpec;
   /** Highly abstracted principle text suitable for PRINCIPLES.md */
   abstractedPrinciple?: string;
+  /** Associated core axiom (e.g., "T-01") */
+  coreAxiomId?: string;
 
   // ── Principle-Tree metadata (Phase 1, optional) ──
 
@@ -406,6 +414,8 @@ export interface CandidateCreatedData {
   detectorMetadata?: PrincipleDetectorSpec;
   /** Optional abstracted principle title (≤40 chars) — preserved on replay */
   abstractedPrinciple?: string;
+  /** Associated core axiom (e.g., "T-01") */
+  coreAxiomId?: string;
 }
 
 export interface PrinciplePromotedData {

package/src/core/external-training-contract.ts

@@ -403,6 +403,7 @@ export function computeConfigFingerprint(config: Partial<TrainingHyperparameters
  * If the file cannot be read, falls back to path+count hash (legacy behavior).
  */
 export function computeDatasetFingerprint(exportPath: string, sampleCount: number): string {
+  // eslint-disable-next-line @typescript-eslint/init-declarations -- assigned in try, catch has fallback return
   let contentHash: string;
   try {
     const content = fs.readFileSync(exportPath, 'utf-8');

package/src/core/focus-history.ts

@@ -41,10 +41,10 @@ export interface WorkingMemorySnapshot {
   };
   
   // 活动问题
-  activeProblems: Array<{
+  activeProblems: {
     problem: string;
     approach?: string;
-  }>;
+  }[];
   
   // 下一步行动
   nextActions: string[];
@@ -56,7 +56,7 @@ export interface WorkingMemorySnapshot {
 function logError(message: string, error?: unknown): void {
   const timestamp = new Date().toISOString();
   const errorStr = error instanceof Error ? error.message : String(error);
-  // eslint-disable-next-line no-console
+   
   console.error(`[focus-history] ${timestamp} ERROR: ${message}${errorStr ? ' - ' + errorStr : ''}`);
 }
 
@@ -78,7 +78,7 @@ export function getHistoryDir(focusPath: string): string {
  * 支持整数和小数版本（如 v1, v1.1, v1.2）
  */
 export function extractVersion(content: string): string {
-  const match = content.match(/\*\*版本\*\*:\s*v([\d.]+)/i);
+  const match = /\*\*版本\*\*:\s*v([\d.]+)/i.exec(content);
   return match ? match[1] : '1';
 }
 
@@ -86,8 +86,8 @@ export function extractVersion(content: string): string {
  * 从 CURRENT_FOCUS.md 提取更新日期
  */
 export function extractDate(content: string): string {
-  const match = content.match(/\*\*更新\*\*:\s*(\d{4}-\d{2}-\d{2})/);
-  return match ? match[1] : new Date().toISOString().split('T')[0];
+  const [, dateStr] = /\*\*更新\*\*:\s*(\d{4}-\d{2}-\d{2})/.exec(content) ?? [];
+  return dateStr ?? new Date().toISOString().split('T')[0];
 }
 
 /**
@@ -228,7 +228,7 @@ export function compressFocus(focusPath: string, newContent: string): {
   const versionParts = oldVersion.split('.');
   const majorVersion = parseInt(versionParts[0], 10) || 1;
   const newVersion = `${majorVersion + 1}`;
-  const today = new Date().toISOString().split('T')[0];
+  const [today] = new Date().toISOString().split('T');
 
   // 更新版本号和日期
   const updatedContent = newContent
@@ -265,7 +265,7 @@ export function compressFocus(focusPath: string, newContent: string): {
  * @param content CURRENT_FOCUS.md 内容
  * @param maxLines 最大行数
  */
-export function extractSummary(content: string, maxLines: number = 30): string {
+export function extractSummary(content: string, maxLines = 30): string {
   const lines = content.split('\n');
   const sections: { [key: string]: string[] } = {
     header: [],      // 标题和元数据
@@ -361,7 +361,7 @@ const MAX_NEXT_ACTIONS = 5;
  * @returns 提取的工作记忆快照
  */
 export function extractWorkingMemory(
-  messages: Array<{ role?: string; content?: string | unknown[] }>,
+  messages: { role?: string; content?: string | unknown[] }[],
   workspaceDir?: string
 ): WorkingMemorySnapshot {
   const snapshot: WorkingMemorySnapshot = {
@@ -378,7 +378,7 @@ export function extractWorkingMemory(
 
   for (const msg of recentMessages) {
     let text = '';
-    const toolUses: Array<{ name: string; input: Record<string, unknown> }> = [];
+    const toolUses: { name: string; input: Record<string, unknown> }[] = [];
     
     if (typeof msg.content === 'string') {
       text = msg.content;
@@ -428,6 +428,7 @@ export function extractWorkingMemory(
             toolUse.name === 'write_file' || toolUse.name === 'create_file' ? 'created' : 'modified';
           
           // 尝试从文本中提取描述
+          // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: mutual recursion between helper functions - reordering would break logical grouping
           const description = extractDescription(text, filePath);
           
           snapshot.artifacts.push({
@@ -442,16 +443,20 @@ export function extractWorkingMemory(
     if (!text) continue;
 
     // 从文本中提取文件操作（备用方式）
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: mutual recursion between helper functions - reordering would break logical grouping
     extractFileArtifacts(text, snapshot.artifacts, workspaceDir);
 
     // 提取问题
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: mutual recursion between helper functions - reordering would break logical grouping
     extractProblems(text, snapshot.activeProblems);
 
     // 提取下一步
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: mutual recursion between helper functions - reordering would break logical grouping
     extractNextActions(text, snapshot.nextActions);
   }
 
   // 去重和限制数量
+  // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: mutual recursion between helper functions - reordering would break logical grouping
   snapshot.artifacts = deduplicateArtifacts(snapshot.artifacts).slice(-MAX_ARTIFACTS);
   snapshot.activeProblems = snapshot.activeProblems.slice(-MAX_PROBLEMS);
   snapshot.nextActions = snapshot.nextActions.slice(-MAX_NEXT_ACTIONS);
@@ -470,10 +475,11 @@ function extractFileArtifacts(
   // 匹配 write_file, replace 工具调用
   // 格式: file_path: "/path/to/file" 或 absolute_path: "/path/to/file"
   const filePathRegex = /(?:file_path|absolute_path)["']?\s*[:=]\s*["']([^"']+\.(ts|js|json|md|yaml|yml|py|sh|mjs|cjs))["']/gi;
-  
+
+  // eslint-disable-next-line @typescript-eslint/init-declarations -- Reason: assigned immediately in while loop condition before use
   let match;
   while ((match = filePathRegex.exec(text)) !== null) {
-    const filePath = match[1];
+    const [, filePath] = match;
     
     // 跳过 node_modules 和配置文件
     if (filePath.includes('node_modules') || 
@@ -500,6 +506,7 @@ function extractFileArtifacts(
     }
 
     // 尝试提取描述（从附近的文本）
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: mutual recursion between helper functions - reordering would break logical grouping
     const description = extractDescription(text, filePath);
 
     artifacts.push({
@@ -512,10 +519,10 @@ function extractFileArtifacts(
   // 匹配更通用的文件路径格式（如代码块中的路径）
   // 格式: `path/to/file.ts` 或 "path/to/file.ts"
   // 只匹配明确的代码相关路径
-  const genericPathRegex = /[`"']([a-zA-Z0-9_\-\/]+\.(ts|js|mjs|cjs|py))[`"']/g;
+  const genericPathRegex = /[`"']([a-zA-Z0-9_./]+\.(ts|js|mjs|cjs|py))[`"']/g;
   
   while ((match = genericPathRegex.exec(text)) !== null) {
-    const filePath = match[1];
+    const [, filePath] = match;
     
     // 跳过太短、node_modules、配置文件
     if (filePath.length < 10 || 
@@ -532,8 +539,9 @@ function extractFileArtifacts(
       continue;
     }
 
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: mutual recursion between helper functions - reordering would break logical grouping
     const description = extractDescription(text, filePath);
-    
+
     artifacts.push({
       path: filePath,
       action: 'modified',
@@ -575,10 +583,11 @@ function extractDescription(text: string, filePath: string): string {
  */
 function extractProblems(
   text: string,
-  problems: Array<{ problem: string; approach?: string }>
+  problems: { problem: string; approach?: string }[]
 ): void {
   // 问题模式（匹配问题描述）
   const problemPattern = /(?:问题|problem|error|错误|失败|failed)[:：]\s*([^\n]{5,100})/gi;
+  // eslint-disable-next-line @typescript-eslint/init-declarations -- Reason: assigned immediately in while loop condition before use
   let match;
   while ((match = problemPattern.exec(text)) !== null) {
     const content = match[1].trim();
@@ -621,6 +630,7 @@ function extractNextActions(text: string, actions: string[]): void {
   ];
 
   for (const pattern of patterns) {
+    // eslint-disable-next-line @typescript-eslint/init-declarations -- Reason: assigned immediately in while loop condition before use
     let match;
     while ((match = pattern.exec(text)) !== null) {
       const action = match[1].trim();
@@ -671,7 +681,7 @@ export function parseWorkingMemorySection(content: string): WorkingMemorySnapsho
   };
 
   // 解析 last updated
-  const updatedMatch = wmContent.match(/Last updated:\s*([^\n]+)/i);
+  const updatedMatch = /Last updated:\s*([^\n]+)/i.exec(wmContent);
   if (updatedMatch) {
     snapshot.lastUpdated = updatedMatch[1].trim();
   }
@@ -679,6 +689,7 @@ export function parseWorkingMemorySection(content: string): WorkingMemorySnapsho
   // 解析文件记录表格
   // | 文件路径 | 操作 | 描述 |
   const tableRegex = /\|\s*`?([^`|\n]+)`?\s*\|\s*(created|modified|deleted)\s*\|\s*([^|\n]*)\s*\|/gi;
+  // eslint-disable-next-line @typescript-eslint/init-declarations -- Reason: assigned immediately in while loop condition before use
   let match;
   while ((match = tableRegex.exec(wmContent)) !== null) {
     snapshot.artifacts.push({
@@ -715,8 +726,9 @@ export function parseWorkingMemorySection(content: string): WorkingMemorySnapsho
  */
 export function mergeWorkingMemory(content: string, snapshot: WorkingMemorySnapshot): string {
   const wmIndex = content.indexOf(WORKING_MEMORY_SECTION);
-  
+
   // 生成 Working Memory 章节
+  // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: mutual recursion between helper functions - reordering would break logical grouping
   const wmSection = generateWorkingMemorySection(snapshot);
   
   if (wmIndex === -1) {
@@ -727,7 +739,7 @@ export function mergeWorkingMemory(content: string, snapshot: WorkingMemorySnaps
     const beforeWm = content.substring(0, wmIndex);
     // 查找下一个 ## 标题（如果有的话）
     const afterWm = content.substring(wmIndex);
-    const nextSectionMatch = afterWm.substring(WORKING_MEMORY_SECTION.length).match(/\n##\s/);
+    const nextSectionMatch = /\n##\s/.exec(afterWm.substring(WORKING_MEMORY_SECTION.length));
     
     if (nextSectionMatch && nextSectionMatch.index !== undefined) {
       const nextSectionStart = WORKING_MEMORY_SECTION.length + nextSectionMatch.index;
@@ -973,7 +985,7 @@ export function extractMilestones(content: string): {
 
     // 提取文件引用（从工作记忆）
     if (inWorkingMemory) {
-      const fileMatch = trimmed.match(/^\|\s*`?([^`|\n]+)`?\s*\|/);
+      const fileMatch = /^\|\s*`?([^`|\n]+)`?\s*\|/.exec(trimmed);
       if (fileMatch && !fileMatch[1].includes('文件路径')) {
         fileArtifacts.push(fileMatch[1].trim());
       }
@@ -998,7 +1010,7 @@ export function archiveMilestonesToDaily(
     return null;
   }
 
-  const dateStr = new Date().toISOString().split('T')[0];
+  const [dateStr] = new Date().toISOString().split('T');
   const memoryDir = path.join(workspaceDir, 'memory');
   const dailyLogPath = path.join(memoryDir, `${dateStr}.md`);
   const timestamp = new Date().toISOString();
@@ -1088,7 +1100,7 @@ export function cleanupStaleInfo(
       }
 
       // 提取文件路径
-      const match = trimmed.match(/^\|\s*`?([^`|\n]+)`?\s*\|/);
+      const match = /^\|\s*`?([^`|\n]+)`?\s*\|/.exec(trimmed);
       if (match) {
         const filePath = match[1].trim();
         artifactCount++;
@@ -1211,7 +1223,7 @@ export function autoCompressFocus(
 
   // 5. 递增版本号和日期
   const newVersion = `${parseInt(version, 10) + 1}`;
-  const today = new Date().toISOString().split('T')[0];
+  const [today] = new Date().toISOString().split('T');
   newContent = newContent
     .replace(/\*\*版本\*\*:\s*v[\d.]+/i, `**版本**: v${newVersion}`)
     .replace(/\*\*更新\*\*:\s*\d{4}-\d{2}-\d{2}/, `**更新**: ${today}`);
@@ -1350,7 +1362,7 @@ export function recoverFromTemplate(
     let template = fs.readFileSync(templatePath, 'utf-8');
 
     // 替换日期占位符
-    const today = new Date().toISOString().split('T')[0];
+    const [today] = new Date().toISOString().split('T');
     template = template.replace(/{YYYY-MM-DD}/g, today);
 
     // 备份损坏的文件（如果存在）
@@ -1393,7 +1405,9 @@ export function recoverFromTemplate(
 export function safeReadCurrentFocus(
   focusPath: string,
   extensionRoot: string,
+  /* eslint-disable no-unused-vars -- Reason: type-only callback parameter names in function type */
   logger?: { warn?: (msg: string) => void; info?: (msg: string) => void }
+  /* eslint-enable no-unused-vars */
 ): {
   content: string;
   recovered: boolean;

package/src/core/hygiene/tracker.ts

@@ -1,7 +1,8 @@
 import * as fs from 'fs';
 import * as path from 'path';
-import { HygieneStats, createEmptyHygieneStats, PersistenceAction } from '../../types/hygiene-types.js';
-import { PluginLogger } from '../../openclaw-sdk.js';
+import type { HygieneStats, PersistenceAction } from '../../types/hygiene-types.js';
+import { createEmptyHygieneStats } from '../../types/hygiene-types.js';
+import type { PluginLogger } from '../../openclaw-sdk.js';
 
 /**
  * HygieneTracker - Tracks agent behavior regarding workspace organization and persistence.
@@ -28,7 +29,7 @@ export class HygieneTracker {
   }
 
   private loadStats(): HygieneStats {
-    const today = new Date().toISOString().split('T')[0];
+    const [today] = new Date().toISOString().split('T');
     if (fs.existsSync(this.statsFile)) {
       try {
         const content = fs.readFileSync(this.statsFile, 'utf-8');
@@ -45,7 +46,10 @@ export class HygieneTracker {
           const backupPath = `${this.statsFile}.bak`;
           fs.renameSync(this.statsFile, backupPath);
           this.logger?.warn(`[PD] Corrupted hygiene stats backed up to ${backupPath}`);
-        } catch (_renameErr) {}
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars, no-unused-vars -- Reason: catch parameter intentionally unused - error handling only
+        } catch (_renameErr) {
+          // Empty - corrupted stats backup is non-fatal
+        }
       }
     }
     return createEmptyHygieneStats(today);
@@ -55,7 +59,7 @@ export class HygieneTracker {
     let allStats: Record<string, HygieneStats> = {};
     
     // Check if we need to rotate date (reset currentStats if date changed)
-    const today = new Date().toISOString().split('T')[0];
+    const [today] = new Date().toISOString().split('T');
     if (this.currentStats.date !== today) {
       this.currentStats = createEmptyHygieneStats(today);
     }
@@ -108,7 +112,7 @@ export class HygieneTracker {
 
   getStats(): HygieneStats {
     // Check for date change on every get
-    const today = new Date().toISOString().split('T')[0];
+    const [today] = new Date().toISOString().split('T');
     if (this.currentStats.date !== today) {
       this.currentStats = createEmptyHygieneStats(today);
     }

package/src/core/init.ts

@@ -34,7 +34,7 @@ function hasOutdatedCoreGuidance(file: string, content: string): boolean {
  * Ensures that the workspace has the necessary template files for Principles Disciple.
  * This function flattens 'core' templates to the root so OpenClaw can find them.
  */
-export function ensureWorkspaceTemplates(api: OpenClawPluginApi, workspaceDir: string, language: string = 'en') {
+export function ensureWorkspaceTemplates(api: OpenClawPluginApi, workspaceDir: string, language = 'en') {
     try {
         const __filename = fileURLToPath(import.meta.url);
         const __dirname = path.dirname(__filename);
@@ -43,6 +43,7 @@ export function ensureWorkspaceTemplates(api: OpenClawPluginApi, workspaceDir: s
         const commonTemplatesDir = path.resolve(__dirname, '..', '..', 'templates', 'workspace');
         if (fs.existsSync(commonTemplatesDir)) {
             api.logger.info(`[PD] Syncing workspace templates: ${workspaceDir}...`);
+            // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: copyRecursiveSync is defined later in this file, called here for organizational reasons
             copyRecursiveSync(commonTemplatesDir, workspaceDir, api);
         }
 
@@ -84,6 +85,7 @@ export function ensureWorkspaceTemplates(api: OpenClawPluginApi, workspaceDir: s
             if (!fs.existsSync(painDestDir)) {
                 fs.mkdirSync(painDestDir, { recursive: true });
             }
+            // eslint-disable-next-line @typescript-eslint/no-use-before-define -- Reason: copyRecursiveSync is defined later in this file, called here for organizational reasons
             copyRecursiveSync(painTemplatesDir, painDestDir, api);
         }
 
@@ -108,6 +110,7 @@ export function ensureWorkspaceTemplates(api: OpenClawPluginApi, workspaceDir: s
  * Standard recursive copy that preserves directory structure.
  * Special handling: maps 'okr' directory to 'memory/okr' for runtime compatibility.
  */
+ 
 function copyRecursiveSync(srcDir: string, destDir: string, api: OpenClawPluginApi | { logger: PluginLogger }) {
     const items = fs.readdirSync(srcDir);
 
@@ -140,7 +143,7 @@ function copyRecursiveSync(srcDir: string, destDir: string, api: OpenClawPluginA
 /**
  * Ensures that the state directory has the necessary files (like pain_dictionary.json).
  */
-export function ensureStateTemplates(ctx: { logger: PluginLogger }, stateDir: string, language: string = 'en') {
+export function ensureStateTemplates(ctx: { logger: PluginLogger }, stateDir: string, language = 'en') {
     try {
         const __filename = fileURLToPath(import.meta.url);
         const __dirname = path.dirname(__filename);