principles-disciple 1.37.0 → 1.39.0

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.37.0",
+  "version": "1.39.0",
   "skills": [
     "./skills"
   ],

package/package.json

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

package/src/commands/capabilities.ts

@@ -3,6 +3,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
+import { atomicWriteFileSync } from '../utils/io.js';
 
 const TOOLS_TO_SCAN = [
   { name: 'rg', cmd: ['rg', '--version'] },
@@ -43,7 +44,7 @@ function scanEnvironment(wctx: WorkspaceContext): any {
   if (!fs.existsSync(capsDir)) {
     fs.mkdirSync(capsDir, { recursive: true });
   }
-  fs.writeFileSync(capsPath, JSON.stringify(capabilities, null, 2), 'utf8');
+  atomicWriteFileSync(capsPath, JSON.stringify(capabilities, null, 2));
 
   return capabilities;
 }

package/src/commands/context.ts

@@ -1,6 +1,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+import { atomicWriteFileSync } from '../utils/io.js';
 import type { ContextInjectionConfig} from '../types.js';
 import { defaultContextConfig } from '../types.js';
 import { loadContextInjectionConfig } from '../hooks/prompt.js';
@@ -40,7 +41,7 @@ function saveConfig(workspaceDir: string, config: ContextInjectionConfig): boole
         profile.contextInjection = config;
         
         // Write back
-        fs.writeFileSync(profilePath, JSON.stringify(profile, null, 2), 'utf-8');
+        atomicWriteFileSync(profilePath, JSON.stringify(profile, null, 2));
         return true;
     } catch (e) {
         console.error(`[PD:Context] Failed to save config: ${String(e)}`);
@@ -99,7 +100,7 @@ function showStatus(workspaceDir: string, isZh: boolean): string {
  * Toggle a boolean setting
  */
  
-// eslint-disable-next-line @typescript-eslint/max-params
+ 
 function toggleSetting(
     workspaceDir: string,
     key: 'thinkingOs' | 'reflectionLog',
@@ -215,7 +216,7 @@ function applyPreset(
     isZh: boolean
 ): string {
      
-    // eslint-disable-next-line @typescript-eslint/init-declarations
+     
     let config: ContextInjectionConfig;
     
     switch (preset) {
@@ -318,7 +319,7 @@ export function handleContextCommand(ctx: PluginCommandContext): PluginCommandRe
     const isZh = (ctx.config?.language as string) === 'zh';
     
      
-    // eslint-disable-next-line @typescript-eslint/init-declarations
+     
     let result: string;
     
     switch (subCommand) {

package/src/commands/focus.ts

@@ -12,6 +12,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import type { PluginCommandContext, PluginCommandResult, OpenClawPluginApi } from '../openclaw-sdk.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
+import { atomicWriteFileSync } from '../utils/io.js';
 import {
   getHistoryDir,
   backupToHistory,
@@ -283,7 +284,7 @@ async function compressFocus(
 
   // 5. 压缩内容
    
-  // eslint-disable-next-line @typescript-eslint/init-declarations
+   
   let compressedContent: string;
   try {
     compressedContent = compressFocusContent(oldContent, workspaceDir);
@@ -304,7 +305,7 @@ async function compressFocus(
   const newLines = newContent.split('\n').length;
   const savedLines = oldLines - newLines;
 
-  fs.writeFileSync(focusPath, newContent, 'utf-8');
+  atomicWriteFileSync(focusPath, newContent);
 
   const milestoneNote = milestonesArchived
     ? isZh
@@ -410,7 +411,7 @@ function rollbackFocus(workspaceDir: string, index: number, isZh: boolean): stri
       `**状态**: ROLLBACK (from v${restoredVersion})`
     );
 
-  fs.writeFileSync(focusPath, restoredContent, 'utf-8');
+  atomicWriteFileSync(focusPath, restoredContent);
 
   if (isZh) {
     return `✅ **回滚成功**
@@ -481,7 +482,7 @@ export async function handleFocusCommand(
   const isZh = (ctx.config?.language as string) === 'zh';
 
    
-  // eslint-disable-next-line @typescript-eslint/init-declarations
+   
   let result: string;
 
   switch (subCommand) {

package/src/commands/nocturnal-train.ts

@@ -26,6 +26,7 @@ import * as path from 'path';
 import * as fs from 'fs';
 import { execFileSync, spawn } from 'child_process';
 import { fileURLToPath } from 'url';
+import { atomicWriteFileSync } from '../utils/io.js';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
 import {
   type TrainerBackendKind,
@@ -264,8 +265,8 @@ Hardware tiers:
       if (!fs.existsSync(workspaceCheckpointsDir)) {
         fs.mkdirSync(workspaceCheckpointsDir, { recursive: true });
       }
-      fs.writeFileSync(trainerSpecPath, JSON.stringify(spec, null, 2), 'utf-8');
-      fs.writeFileSync(workspaceSpecPath, JSON.stringify(spec, null, 2), 'utf-8');
+      atomicWriteFileSync(trainerSpecPath, JSON.stringify(spec, null, 2));
+      atomicWriteFileSync(workspaceSpecPath, JSON.stringify(spec, null, 2));
 
       // --- Auto-run mode: execute trainer immediately ---
       // This closes the gap in the create-experiment -> trainer -> import-result chain.
@@ -282,10 +283,10 @@ Hardware tiers:
         if (!fs.existsSync(specDir)) {
           fs.mkdirSync(specDir, { recursive: true });
         }
-        fs.writeFileSync(specPath, JSON.stringify(spec, null, 2), 'utf-8');
+        atomicWriteFileSync(specPath, JSON.stringify(spec, null, 2));
 
          
-        // eslint-disable-next-line @typescript-eslint/init-declarations
+         
         let trainerResult!: TrainingExperimentResult;
 
         try {
@@ -395,7 +396,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
+         
         let processed: { checkpointId: string; checkpointRef: string } | null;
         try {
           processed = program.processResult({
@@ -537,7 +538,7 @@ Next steps:
         }
       }
 
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/init-declarations -- 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);
@@ -569,7 +570,7 @@ Next steps:
       // Process the result
       const program = new TrainingProgram(workspaceDir);
        
-      // eslint-disable-next-line @typescript-eslint/init-declarations
+       
       let processed: { checkpointId: string; checkpointRef: string } | null;
       try {
         processed = program.processResult({
@@ -757,15 +758,15 @@ Next steps:
         }
 
         // Destructure benchmark result - delta property contains the actual delta value
-        // eslint-disable-next-line @typescript-eslint/prefer-destructuring
+         
         delta = benchmarkResult.delta.delta;
-        // eslint-disable-next-line @typescript-eslint/prefer-destructuring
+         
         baselineScore = benchmarkResult.delta.baselineScore;
-        // eslint-disable-next-line @typescript-eslint/prefer-destructuring
+         
         candidateScore = benchmarkResult.delta.candidateScore;
-        // eslint-disable-next-line @typescript-eslint/prefer-destructuring
+         
         benchmarkId = benchmarkResult.benchmarkId;
-        // eslint-disable-next-line @typescript-eslint/prefer-destructuring
+         
         verdict = benchmarkResult.verdict;
       } else {
         // Manual mode: require explicit delta and verdict

package/src/commands/pd-reflect.ts

@@ -7,6 +7,7 @@
 
 import type { PluginCommandDefinition, PluginCommandContext, PluginCommandResult, OpenClawPluginApi } from '../openclaw-sdk.js';
 import { acquireQueueLock, EVOLUTION_QUEUE_LOCK_SUFFIX } from '../service/evolution-worker.js';
+import { atomicWriteFileSync } from '../utils/io.js';
 import * as fs from 'fs';
 import * as path from 'path';
 
@@ -22,7 +23,7 @@ export const handlePdReflect: PluginCommandDefinition = {
   requireAuth: false,
   handler: async (ctx: PdReflectContext): Promise<PluginCommandResult> => {
     try {
-      // eslint-disable-next-line @typescript-eslint/prefer-destructuring
+       
       const workspaceDir = ctx.workspaceDir;
       if (!workspaceDir) {
         return { text: 'Cannot determine workspace directory. Ensure you are in an active workspace.', isError: true };
@@ -33,7 +34,7 @@ export const handlePdReflect: PluginCommandDefinition = {
 
       // Acquire lock before modifying queue
       const releaseLock = await acquireQueueLock(queuePath, ctx.api?.logger, EVOLUTION_QUEUE_LOCK_SUFFIX);
-      // eslint-disable-next-line @typescript-eslint/init-declarations
+       
       let taskId: string | undefined;
       try {
         let rawQueue: unknown[] = [];
@@ -71,7 +72,7 @@ export const handlePdReflect: PluginCommandDefinition = {
           maxRetries: 1,
         });
 
-        fs.writeFileSync(queuePath, JSON.stringify(rawQueue, null, 2), 'utf8');
+        atomicWriteFileSync(queuePath, JSON.stringify(rawQueue, null, 2));
       } finally {
         releaseLock();
       }

package/src/commands/promote-impl.ts

@@ -30,6 +30,7 @@ import { WorkspaceContext } from '../core/workspace-context.js';
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
 import type { Implementation } from '../types/principle-tree-schema.js';
 import { withLock } from '../utils/file-lock.js';
+import { atomicWriteFileSync } from '../utils/io.js';
 
 function getAllImplementations(stateDir: string): Implementation[] {
   const ledger = loadLedger(stateDir);
@@ -227,7 +228,7 @@ function _handlePromoteImpl(options: PromoteImplOptions): PluginCommandResult {
     promotedAt: new Date().toISOString(),
   };
   withLock(eventPath, () => {
-    fs.writeFileSync(eventPath, JSON.stringify(promotionEvent, null, 2), 'utf-8');
+    atomicWriteFileSync(eventPath, JSON.stringify(promotionEvent, null, 2));
   });
   try {
     refreshPrincipleLifecycle(workspaceDir, stateDir);

package/src/commands/rollback-impl.ts

@@ -16,6 +16,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { withLock } from '../utils/file-lock.js';
+import { atomicWriteFileSync } from '../utils/io.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 import { refreshPrincipleLifecycle } from '../core/principle-internalization/lifecycle-refresh.js';
 import {
@@ -59,12 +60,12 @@ export function handleRollbackImplCommand(ctx: PluginCommandContext): PluginComm
   // List active
   if (subcommand === 'list' || subcommand === '') {
      
-    // eslint-disable-next-line @typescript-eslint/no-use-before-define
+     
     return _handleListActiveRollback(stateDir, isZh);
   }
 
    
-  // eslint-disable-next-line @typescript-eslint/no-use-before-define
+   
   return _handleRollbackImpl(workspaceDir, stateDir, implId, reason, isZh, ctx.sessionId);
 }
 
@@ -107,7 +108,7 @@ function _handleListActiveRollback(
 }
 
  
-// eslint-disable-next-line @typescript-eslint/max-params
+ 
 function _handleRollbackImpl(
   workspaceDir: string,
   stateDir: string,
@@ -143,7 +144,7 @@ function _handleRollbackImpl(
   transitionImplementationState(stateDir, implId, 'disabled');
 
    
-  // eslint-disable-next-line @typescript-eslint/init-declarations
+   
   let restoredMessage: string;
 
   if (previousActiveId && allImpls.some((i) => i.id === previousActiveId)) {
@@ -188,7 +189,7 @@ function _handleRollbackImpl(
   const rollbackTimestamp = new Date().toISOString().replace(/[:.]/g, '-');
   const rollbackPath = path.join(rollbackDir, `${rollbackTimestamp}.json`);
   withLock(rollbackPath, () => {
-    fs.writeFileSync(rollbackPath, JSON.stringify(rollbackRecord, null, 2), 'utf-8');
+    atomicWriteFileSync(rollbackPath, JSON.stringify(rollbackRecord, null, 2));
   });
   try {
     refreshPrincipleLifecycle(workspaceDir, stateDir);

package/src/core/adaptive-thresholds.ts

@@ -24,6 +24,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { withLock } from '../utils/file-lock.js';
+import { atomicWriteFileSync } from '../utils/io.js';
 
 // ---------------------------------------------------------------------------
 // Constants
@@ -227,9 +228,7 @@ function writeState(stateDir: string, state: ThresholdPersistenceState): void {
   }
 
   withLock(statePath, () => {
-    const tmpPath = `${statePath}.tmp`;
-    fs.writeFileSync(tmpPath, JSON.stringify(state, null, 2), 'utf-8');
-    fs.renameSync(tmpPath, statePath);
+    atomicWriteFileSync(statePath, JSON.stringify(state, null, 2));
   });
 }
 
@@ -301,7 +300,7 @@ export function getEffectiveThresholds(stateDir: string): ThresholdValues {
  * @returns UpdateThresholdResult
  */
  
-// eslint-disable-next-line @typescript-eslint/max-params
+ 
 export function updateThresholdState(
   stateDir: string,
   thresholdName: ThresholdName,

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

@@ -18,6 +18,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { withLock } from '../utils/file-lock.js';
+import { atomicWriteFileSync } from '../utils/io.js';
 
 // ---------------------------------------------------------------------------
 // Types
@@ -130,12 +131,12 @@ export function writeManifest(
   const manifestPath = path.join(assetRoot, MANIFEST_FILENAME);
   ensureDir(assetRoot);
   withLock(manifestPath, () => {
-    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+    atomicWriteFileSync(manifestPath, JSON.stringify(manifest, null, 2));
   });
 }
 
  
-// eslint-disable-next-line @typescript-eslint/max-params
+ 
 export function writeEntrySource(
   stateDir: string,
   implId: string,
@@ -147,7 +148,7 @@ export function writeEntrySource(
   const entryPath = path.join(assetRoot, entryFile);
   ensureDir(assetRoot);
   withLock(entryPath, () => {
-    fs.writeFileSync(entryPath, sourceCode, 'utf-8');
+    atomicWriteFileSync(entryPath, sourceCode);
   });
 }
 
@@ -191,7 +192,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
+ 
 export function createImplementationAssetDir(
   stateDir: string,
   implId: string,
@@ -219,7 +220,7 @@ export function createImplementationAssetDir(
     ensureDir(assetRoot);
     ensureDir(replaysDir);
     if (!fs.existsSync(entryPath)) {
-      fs.writeFileSync(entryPath, entrySource, 'utf-8');
+      atomicWriteFileSync(entryPath, entrySource);
     }
   });
 

package/src/core/config.ts

@@ -1,5 +1,6 @@
 import * as fs from 'fs';
 import * as path from 'path';
+import { atomicWriteFileSync } from '../utils/io.js';
 
 export interface DeepReflectionSettings {
     enabled: boolean;
@@ -257,7 +258,7 @@ export class PainConfig {
             if (!fs.existsSync(dir)) {
                 fs.mkdirSync(dir, { recursive: true });
             }
-            fs.writeFileSync(this.filePath, JSON.stringify(this.settings, null, 2), 'utf8');
+            atomicWriteFileSync(this.filePath, JSON.stringify(this.settings, null, 2));
             console.log(`[PD:Config] Settings saved to ${this.filePath}`);
         } catch (e) {
             console.error(`[PD:Config] Failed to save settings: ${String(e)}`);
@@ -291,7 +292,7 @@ export class PainConfig {
      * Basic validation for critical settings
      */
      
-    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+     
     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/correction-cue-learner.ts

@@ -22,6 +22,7 @@ import {
   MAX_CORRECTION_KEYWORDS,
 } from './correction-types.js';
 import { checkCooldown } from '../service/nocturnal-runtime.js';
+import { atomicWriteFileSync } from '../utils/io.js';
 
 const KEYWORD_STORE_FILE = 'correction_keywords.json';
 
@@ -109,11 +110,9 @@ export function saveCorrectionKeywordStore(
   store: CorrectionKeywordStore
 ): void {
   const filePath = path.join(stateDir, KEYWORD_STORE_FILE);
-  const tmpPath = filePath + '.tmp';
 
   fs.mkdirSync(stateDir, { recursive: true });
-  fs.writeFileSync(tmpPath, JSON.stringify(store, null, 2), 'utf-8');
-  fs.renameSync(tmpPath, filePath);
+  atomicWriteFileSync(filePath, JSON.stringify(store, null, 2));
 
   // Invalidate cache so the next read re-loads from disk (D-05)
   _correctionCueCache = null;
@@ -151,9 +150,12 @@ export class CorrectionCueLearner {
 
   /**
    * Checks whether text contains a correction cue (D-11).
+   * Pure read-only — does NOT modify the store.
    * Normalisation is equivalent to the original detectCorrectionCue():
    *   trim → lowercase → strip punctuation
    * Returns weighted score based on keyword accuracy (D-39-03, D-39-04).
+   *
+   * To record hits/TPs, call recordHit() and recordTruePositive() separately.
    */
   match(text: string): CorrectionMatchResult {
     const normalized = text
@@ -167,19 +169,15 @@ export class CorrectionCueLearner {
     for (const keyword of this.store.keywords) {
       if (normalized.includes(keyword.term.toLowerCase())) {
         // D-39-03, D-39-04: Weighted score formula
-        // score = weight x ((TP + 1) / (TP + FP + 2))
-        // +2 smoothing: new keywords (TP=0, FP=0) get accuracy=0.5
+        // No history (tp=0, fp=0) → accuracy = 1 (trust raw weight)
+        // Has history → accuracy = tp / (tp + fp) (proportional to true positive rate)
         const tp = keyword.truePositiveCount ?? 0;
         const fp = keyword.falsePositiveCount ?? 0;
-        const accuracy = (tp + 1) / (tp + fp + 2);
+        const accuracy = (tp + fp) > 0 ? tp / (tp + fp) : 1;
         const score = keyword.weight * accuracy;
 
         totalScore += score;
         matchedTerms.push(keyword.term);
-
-        // Increment hitCount
-        keyword.hitCount = (keyword.hitCount ?? 0) + 1;
-        keyword.lastHitAt = new Date().toISOString();
       }
     }
 
@@ -199,17 +197,40 @@ export class CorrectionCueLearner {
     };
   }
 
+  /**
+   * Records a keyword hit (for hitCount/FPR tracking).
+   * Increments hitCount and updates lastHitAt for all matched terms.
+   * Intentionally does NOT flush — hitCount is best-effort analytics,
+   * persisted by the next recordTruePositive() or flush() call.
+   */
+  recordHits(terms: string[]): void {
+    for (const term of terms) {
+      const keywordIndex = this.store.keywords.findIndex(k => k.term.toLowerCase() === term.toLowerCase());
+      if (keywordIndex < 0) continue;
+      const keyword = this.store.keywords[keywordIndex];
+      this.store.keywords[keywordIndex] = {
+        ...keyword,
+        hitCount: (keyword.hitCount ?? 0) + 1,
+        lastHitAt: new Date().toISOString(),
+      };
+    }
+  }
+
   /**
    * Records a confirmed true positive for the given keyword term.
-   * Increments both hitCount and truePositiveCount.
+   * Increments truePositiveCount atomically.
    */
   recordTruePositive(term: string): void {
     const keyword = this.store.keywords.find(k => k.term.toLowerCase() === term.toLowerCase());
     if (!keyword) return;
 
     keyword.truePositiveCount = (keyword.truePositiveCount ?? 0) + 1;
-    keyword.hitCount = (keyword.hitCount ?? 0) + 1;
-    keyword.lastHitAt = new Date().toISOString();
+
+    // Update in-store reference
+    const keywordIndex = this.store.keywords.findIndex(k => k.term.toLowerCase() === term.toLowerCase());
+    if (keywordIndex >= 0) {
+      this.store.keywords[keywordIndex] = { ...keyword };
+    }
 
     this.flush();
   }
@@ -217,18 +238,25 @@ export class CorrectionCueLearner {
   /**
    * Records a confirmed false positive for the given keyword term.
    * CORR-10: Decreases keyword weight by 20% (x0.8 multiplicative factor).
+   * D-39-17: Keywords at very low weight (<0.1) still match but contribute minimally.
    */
   recordFalsePositive(term: string): void {
     const keyword = this.store.keywords.find(k => k.term.toLowerCase() === term.toLowerCase());
     if (!keyword) return;
 
     keyword.falsePositiveCount = (keyword.falsePositiveCount ?? 0) + 1;
-    keyword.hitCount = (keyword.hitCount ?? 0) + 1;
 
     // D-39-15: Multiplicative weight decay x0.8 on confirmed FP
     keyword.weight = Math.max(MIN_KEYWORD_WEIGHT, keyword.weight * 0.8);
     keyword.lastHitAt = new Date().toISOString();
 
+    // Update in-store reference
+    const keywordIndex = this.store.keywords.findIndex(k => k.term.toLowerCase() === term.toLowerCase());
+    if (keywordIndex >= 0) {
+      this.store.keywords[keywordIndex] = { ...keyword };
+    }
+
+    // D-39-16: Apply decay BEFORE flush to disk
     this.flush();
   }
 

package/src/core/correction-types.ts

@@ -45,7 +45,7 @@ export interface CorrectionKeywordStore {
 export interface CorrectionMatchResult {
   /** Whether any keyword matched */
   matched: boolean;
-  /** The first matched term (empty array when no match) */
+  /** Matched terms (empty array when no match; may be truncated to first N items) */
   matchedTerms: string[];
   /** Weighted score (0-1) based on keyword weight and accuracy */
   score: number;

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

@@ -29,6 +29,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { withLockAsync } from '../utils/file-lock.js';
+import { atomicWriteFileSync } from '../utils/io.js';
 
 const DIAGNOSTICIAN_TASKS_FILE = 'diagnostician_tasks.json';
 
@@ -83,16 +84,14 @@ export async function addDiagnosticianTask(
   const filePath = resolveTasksPath(stateDir);
   await withLockAsync(filePath, async () => {
      
-    // eslint-disable-next-line @typescript-eslint/no-use-before-define
+     
     const store = readTaskStoreSync(filePath);
     store.tasks[taskId] = {
       prompt,
       createdAt: new Date().toISOString(),
       status: 'pending',
     };
-    const tmpPath = filePath + '.tmp';
-    fs.writeFileSync(tmpPath, JSON.stringify(store, null, 2), 'utf8');
-    fs.renameSync(tmpPath, filePath);
+    atomicWriteFileSync(filePath, JSON.stringify(store, null, 2));
   });
 }
 
@@ -106,13 +105,11 @@ export async function completeDiagnosticianTask(
 ): Promise<void> {
   const filePath = resolveTasksPath(stateDir);
   await withLockAsync(filePath, async () => {
+
      
-    // eslint-disable-next-line @typescript-eslint/no-use-before-define
     const store = readTaskStoreSync(filePath);
     delete store.tasks[taskId];
-    const tmpPath = filePath + '.tmp';
-    fs.writeFileSync(tmpPath, JSON.stringify(store, null, 2), 'utf8');
-    fs.renameSync(tmpPath, filePath);
+    atomicWriteFileSync(filePath, JSON.stringify(store, null, 2));
   });
 }
 

package/src/core/dictionary.ts

@@ -1,5 +1,6 @@
 import * as fs from 'fs';
 import * as path from 'path';
+import { atomicWriteFileSync } from '../utils/io.js';
 
 export type RuleType = 'regex' | 'exact_match';
 
@@ -116,7 +117,7 @@ export class PainDictionary {
         }
     }
 
-    // eslint-disable-next-line complexity -- complexity 13, refactor candidate
+     
     match(text: string): { ruleId: string; severity: number } | undefined {
         if (shouldIgnorePainProtocolText(text)) return undefined;
 
@@ -154,7 +155,7 @@ export class PainDictionary {
             if (!fs.existsSync(this.stateDir)) {
                 fs.mkdirSync(this.stateDir, { recursive: true });
             }
-            fs.writeFileSync(this.filePath, JSON.stringify(this.data, null, 2), 'utf8');
+            atomicWriteFileSync(this.filePath, JSON.stringify(this.data, null, 2));
         } catch (e) {
             console.error('[PD] Failed to flush pain_dictionary.json:', e);
         }

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

@@ -14,6 +14,7 @@
 
 import * as fs from 'fs';
 import * as path from 'path';
+import { atomicWriteFileSync } from '../utils/io.js';
 import type {
   EmpathyKeywordStore,
   EmpathyKeywordEntry,
@@ -81,7 +82,7 @@ export function loadKeywordStore(stateDir: string, language?: 'zh' | 'en'): Empa
     if (!fs.existsSync(filePath)) {
       const store = createDefaultKeywordStore(language);
        
-      // eslint-disable-next-line @typescript-eslint/no-use-before-define
+       
       saveKeywordStore(stateDir, store);
       return store;
     }
@@ -94,7 +95,7 @@ export function loadKeywordStore(stateDir: string, language?: 'zh' | 'en'): Empa
       console.warn('[PD:Empathy] Invalid keyword store format, creating default');
       const store = createDefaultKeywordStore(language);
        
-      // eslint-disable-next-line @typescript-eslint/no-use-before-define
+       
       saveKeywordStore(stateDir, store);
       return store;
     }
@@ -104,7 +105,7 @@ export function loadKeywordStore(stateDir: string, language?: 'zh' | 'en'): Empa
     console.warn(`[PD:Empathy] Failed to load keyword store: ${e}`);
     const store = createDefaultKeywordStore(language);
      
-    // eslint-disable-next-line @typescript-eslint/no-use-before-define
+     
     saveKeywordStore(stateDir, store);
     return store;
   }
@@ -123,7 +124,7 @@ export function saveKeywordStore(stateDir: string, store: EmpathyKeywordStore):
   }
 
   store.lastUpdated = new Date().toISOString();
-  fs.writeFileSync(filePath, JSON.stringify(store, null, 2), 'utf8');
+  atomicWriteFileSync(filePath, JSON.stringify(store, null, 2));
 }
 
 // =========================================================================