create-principles-disciple 1.92.0 → 1.93.0

package/plugin/dist/hooks/trajectory-collector.js

@@ -1,127 +1,79 @@
 /**
  * Trajectory Collector - message write trajectory recording
  *
- * Records message data to memory/trajectories/ JSONL files.
- * PRI-347 removed tool_call and llm_output JSONL writers (no consumers).
- * PRI-346 will repurpose handleBeforeMessageWrite for SQLite collection.
+ * Fallback trajectory collection when llm_output is blocked by missing
+ * allowConversationAccess. before_message_write is NOT in
+ * CONVERSATION_HOOK_NAMES so OpenClaw always delivers it.
+ *
+ * SQLite writes are enqueued to an async queue because before_message_write is
+ * a SYNCHRONOUS OpenClaw hook — the handler must return immediately. better-sqlite3
+ * is synchronous, so calling it directly would block the message-write main path.
+ * Trade-off: in degradation mode the last few queued writes may be lost on
+ * process exit; this is acceptable because degradation mode is already caused
+ * by a config problem (missing allowConversationAccess), and the primary
+ * llm_output path is authoritative when authorized.
+ *
+ * JSONL writing was removed (no consumers — verified zero readers across the
+ * codebase; PRI-347 already removed tool_call/llm_output JSONL writers).
+ *
+ * ERR-002: fallback errors are logged, never silent.
+ * ERR-001/005: content is sanitized before persisting.
  */
-import * as fs from 'fs';
-import * as path from 'path';
 import { MAX_STRING_LENGTH } from '../config/defaults/runtime.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 import { SystemLogger } from '../core/system-logger.js';
 import { sanitizeForEvidence } from './message-sanitize.js';
 import { checkConversationAccessConfig } from '../core/config-health.js';
-const TRAJECTORY_DIR = 'memory/trajectories/';
-// 敏感字段匹配正则
-const SENSITIVE_KEY_PATTERN = /password|token|authorization|secret|api[_-]?key|credential|cookie|session/i;
-/**
- * 递归脱敏处理：遍历对象/数组，移除敏感字段值
- */
-function scrubSensitive(obj, depth = 0) {
-    // 防止无限递归
-    if (depth > 10)
-        return '[MAX_DEPTH]';
-    // 处理 null/undefined
-    if (obj == null)
-        return obj;
-    // 处理基本类型
-    if (typeof obj !== 'object') {
-        if (typeof obj === 'string' && obj.length > MAX_STRING_LENGTH) {
-            return obj.slice(0, MAX_STRING_LENGTH) + '...[truncated]';
-        }
-        return obj;
-    }
-    // 处理数组
-    if (Array.isArray(obj)) {
-        return obj.map(item => scrubSensitive(item, depth + 1));
-    }
-    // 处理对象
-    const result = {};
-    for (const [key, value] of Object.entries(obj)) {
-        if (SENSITIVE_KEY_PATTERN.test(key)) {
-            result[key] = '[REDACTED]';
-        }
-        else {
-            result[key] = scrubSensitive(value, depth + 1);
-        }
-    }
-    return result;
-}
 /**
- * 异步写入队列 - 确保有序、非阻塞写入
+ * Async write queue — ensures ordered, non-blocking execution of SQLite writes.
+ * before_message_write is a sync hook; SQLite I/O must not block it.
+ *
+ * Tasks are deferred to the microtask queue via `queueMicrotask` so the sync
+ * hook handler returns before any synchronous better-sqlite3 work runs.
  */
 class AsyncWriteQueue {
     queue = [];
     processing = false;
-    async enqueue(task) {
+    enqueue(task) {
         this.queue.push(task);
         if (!this.processing) {
-            this.processNext();
+            this.processing = true;
+            queueMicrotask(() => { void this.processNext(); });
         }
     }
     async processNext() {
-        if (this.queue.length === 0) {
-            this.processing = false;
-            return;
-        }
-        this.processing = true;
-        const task = this.queue.shift();
-        if (!task) {
-            this.processing = false;
-            return;
+        while (this.queue.length > 0) {
+            const task = this.queue.shift();
+            if (!task)
+                break;
+            try {
+                await task();
+            }
+            catch (err) {
+                // EP-03/ERR-002: safety net — tasks should catch their own errors with
+                // structured logging. This catches bugs where a task's try/catch is
+                // missing or re-throws. Never silently swallow (ERR-002).
+                console.warn('[PD:trajectory-queue] uncaught task error:', err);
+            }
         }
-        try {
-            await task();
-        }
-        catch {
-            // Silently fail - trajectory collection should not block main functionality
-        }
-        // 处理下一个任务
-        this.processNext();
+        this.processing = false;
     }
 }
-// 全局写入队列实例
 const writeQueue = new AsyncWriteQueue();
-// 目录缓存（避免重复检查）
-const dirCache = new Map();
 /**
- * 确保轨迹目录存在（异步）
+ * Extract text content from a message (string or content-part array).
  */
-async function ensureTrajectoryDirAsync(workspaceDir) {
-    const dir = path.join(workspaceDir, TRAJECTORY_DIR);
-    if (dirCache.get(dir)) {
-        return dir;
-    }
-    try {
-        await fs.promises.mkdir(dir, { recursive: true });
-        dirCache.set(dir, true);
+function extractContent(content) {
+    if (typeof content === 'string') {
+        return content;
     }
-    catch {
-        // 目录可能已存在，忽略错误
-        dirCache.set(dir, true);
+    if (Array.isArray(content)) {
+        return content
+            .filter((part) => part && typeof part === 'object' && part.type === 'text')
+            .map((part) => part.text)
+            .join('\n');
     }
-    return dir;
-}
-/**
- * 获取今日轨迹文件名
- */
-function getTodayFilename() {
-    const now = new Date();
-    const year = now.getUTCFullYear();
-    const month = String(now.getUTCMonth() + 1).padStart(2, '0');
-    return `${year}-${month}-${String(now.getUTCDate()).padStart(2, '0')}.jsonl`;
-}
-/**
- * 写入轨迹记录（JSON Lines 格式）- 异步版本
- */
-function writeTrajectoryRecord(workspaceDir, record) {
-    const line = JSON.stringify(record) + '\n';
-    writeQueue.enqueue(async () => {
-        const dir = await ensureTrajectoryDirAsync(workspaceDir);
-        const filepath = path.join(dir, getTodayFilename());
-        await fs.promises.appendFile(filepath, line, 'utf8');
-    });
+    return '';
 }
 /**
  * PRI-346: Message write hook with SQLite fallback trajectory recording.
@@ -131,7 +83,9 @@ function writeTrajectoryRecord(workspaceDir, record) {
  * CONVERSATION_HOOK_NAMES, so it always fires — making it the natural fallback.
  *
  * De-duplication: only writes to SQLite when llm_output is blocked (unauthorized).
- * When llm_output is working (authorized), this hook degrades to JSONL-only.
+ * When llm_output is working (authorized), this hook is a no-op.
+ *
+ * SQLite writes are async-queued (see file header) to avoid blocking the sync hook.
  *
  * ERR-002: structured observability when fallback fires.
  * ERR-001/005: content is sanitized before persisting.
@@ -146,73 +100,58 @@ export function handleBeforeMessageWrite(event, ctx) {
     // Only record user and assistant messages
     if (msg.role !== 'user' && msg.role !== 'assistant')
         return;
-    // Extract text content (consistent with existing implementation)
-    let content = '';
-    if (typeof msg.content === 'string') {
-        content = msg.content;
-    }
-    else if (Array.isArray(msg.content)) {
-        content = msg.content
-            .filter((part) => part && typeof part === 'object' && part.type === 'text')
-            .map((part) => part.text)
-            .join('\n');
-    }
-    // Sanitize content preview for JSONL
-    const sanitizedPreview = scrubSensitive(content.slice(0, 200));
-    // Existing JSONL write (always, for backward compatibility)
-    writeTrajectoryRecord(workspaceDir, {
-        type: 'message',
-        timestamp: new Date().toISOString(),
-        sessionId: event.sessionKey || event.sessionId || 'unknown',
-        role: msg.role,
-        contentLength: content.length,
-        contentPreview: typeof sanitizedPreview === 'string' ? sanitizedPreview : '[sanitized]',
-        agentId: event.agentId || null,
-        fallback: 'before_message_write',
-    });
     // ── SQLite fallback (PRI-346): only when conversation hooks are blocked ──
     const accessCheck = checkConversationAccessConfig(ctx.pluginConfig);
     if (accessCheck.authorized) {
         // llm_output is working — do NOT duplicate write to SQLite (de-dup, case D)
         return;
     }
-    // Conversation hooks blocked — this hook is the fallback trajectory writer
+    // Conversation hooks blocked — this hook is the fallback trajectory writer.
+    // Enqueue SQLite writes to avoid blocking the sync before_message_write hook.
+    const logger = ctx.logger;
+    const content = extractContent(msg.content);
+    const sessionId = event.sessionKey ?? ctx.sessionId ?? 'unknown';
+    const createdAt = new Date().toISOString();
     if (msg.role === 'assistant') {
-        try {
-            const wctx = WorkspaceContext.fromHookContext({ workspaceDir, logger: ctx.logger });
-            const sanitized = sanitizeForEvidence(content.slice(0, MAX_STRING_LENGTH), workspaceDir);
-            const sessionId = event.sessionKey ?? ctx.sessionId ?? 'unknown';
-            wctx.trajectory?.recordAssistantTurn?.({
-                sessionId,
-                runId: 'before_message_write_fallback',
-                provider: 'unknown',
-                model: 'unknown',
-                rawText: content,
-                sanitizedText: sanitized,
-                usageJson: {},
-                empathySignalJson: { detected: false, severity: 'mild', confidence: 1 },
-                createdAt: new Date().toISOString(),
-            });
-        }
-        catch (err) {
-            ctx.logger?.warn?.(`[PD:before_message_write] SQLite fallback write failed: ${String(err)}`);
-        }
+        writeQueue.enqueue(async () => {
+            try {
+                const wctx = WorkspaceContext.fromHookContext({ workspaceDir, logger });
+                const sanitized = sanitizeForEvidence(content.slice(0, MAX_STRING_LENGTH), workspaceDir);
+                wctx.trajectory?.recordAssistantTurn?.({
+                    sessionId,
+                    runId: 'before_message_write_fallback',
+                    provider: 'unknown',
+                    model: 'unknown',
+                    rawText: content,
+                    sanitizedText: sanitized,
+                    usageJson: {},
+                    empathySignalJson: { detected: false, severity: 'mild', confidence: 1 },
+                    createdAt,
+                });
+            }
+            catch (err) {
+                // EP-03/ERR-002: observable degradation, never silent
+                logger?.warn?.(`[PD:before_message_write] SQLite fallback write failed: ${String(err)}`);
+            }
+        });
     }
     else if (msg.role === 'user') {
-        try {
-            const wctx = WorkspaceContext.fromHookContext({ workspaceDir, logger: ctx.logger });
-            const sessionId = event.sessionKey ?? ctx.sessionId ?? 'unknown';
-            wctx.trajectory?.recordUserTurn?.({
-                sessionId,
-                turnIndex: 0,
-                rawText: content.slice(0, MAX_STRING_LENGTH),
-                correctionDetected: false,
-                createdAt: new Date().toISOString(),
-            });
-        }
-        catch (err) {
-            ctx.logger?.warn?.(`[PD:before_message_write] SQLite user turn fallback failed: ${String(err)}`);
-        }
+        writeQueue.enqueue(async () => {
+            try {
+                const wctx = WorkspaceContext.fromHookContext({ workspaceDir, logger });
+                wctx.trajectory?.recordUserTurn?.({
+                    sessionId,
+                    turnIndex: 0,
+                    rawText: content.slice(0, MAX_STRING_LENGTH),
+                    correctionDetected: false,
+                    createdAt,
+                });
+            }
+            catch (err) {
+                // EP-03/ERR-002: observable degradation, never silent
+                logger?.warn?.(`[PD:before_message_write] SQLite user turn fallback failed: ${String(err)}`);
+            }
+        });
     }
     // ERR-002: Structured observability — no silent fallback
     SystemLogger.log(workspaceDir, 'CONVERSATION_HOOK_BLOCKED', JSON.stringify({

package/plugin/dist/index.js

@@ -266,6 +266,9 @@ const plugin = {
             }
         }));
         // ── Hook: Pain & Trust ──
+        // timeoutMs=10s: OpenClaw has no default timeout for after_tool_call; without
+        // this a stuck SQLite write (busy_timeout=5000ms) leaks the handler promise.
+        // 10s gives 2x headroom over busy_timeout. fail-open means agent is unaffected.
         api.on('after_tool_call', guardHook('hook:after_tool_call', api.logger, (event, ctx) => {
             const wsResult = resolveHookWorkspaceDir(ctx, api, 'after_tool_call');
             if (!wsResult.ok) {
@@ -294,8 +297,10 @@ const plugin = {
                 }, { flushImmediately: true });
                 api.logger.error(`[PD:EmpathyObserver] Error in after_tool_call: ${String(err)}`);
             }
-        }));
+        }), { timeoutMs: 10_000 });
         // ── Hook: LLM Analysis ──
+        // timeoutMs=10s: OpenClaw has no default timeout for llm_output; without
+        // this a stuck SQLite write leaks the handler promise. See after_tool_call.
         api.on('llm_output', guardHook('hook:llm_output', api.logger, (event, ctx) => {
             const wsResult = resolveHookWorkspaceDir(ctx, api, 'llm_output');
             if (!wsResult.ok) {
@@ -325,7 +330,7 @@ const plugin = {
                 });
                 api.logger.error(`[PD] Error in llm_output: ${String(err)}`);
             }
-        }));
+        }), { timeoutMs: 10_000 });
         // ── Hook: Lifecycle ──
         api.on('before_reset', guardHook('hook:before_reset', api.logger, (event, ctx) => {
             const wsResult = resolveHookWorkspaceDir(ctx, api, 'before_reset');

package/plugin/dist/openclaw-sdk.d.ts

@@ -151,7 +151,10 @@ export interface OpenClawPluginApi {
             text: (content: string, code?: number) => void;
         }) => boolean | Promise<boolean>;
     }) => void;
-    on: (event: string, handler: (...args: any[]) => unknown) => void;
+    on: (event: string, handler: (...args: any[]) => unknown, opts?: {
+        priority?: number;
+        timeoutMs?: number;
+    }) => void;
 }
 export interface PluginHookBeforePromptBuildEvent {
     agentId?: string;

package/plugin/dist/service/evolution-worker.js

@@ -93,7 +93,8 @@ export function purgeStaleFailedTasks(queue, logger) {
     // Remove purged items from the queue (mutates in place)
     const purgedIds = new Set(purged.map((t) => t.id));
     for (let i = queue.length - 1; i >= 0; i--) {
-        if (purgedIds.has(queue[i].id))
+        const task = queue[i];
+        if (task && purgedIds.has(task.id))
             queue.splice(i, 1);
     }
     const summary = Object.entries(byReason)
@@ -377,17 +378,20 @@ async function processDetectionQueue(wctx, api, eventLog) {
                 if (wctx.trajectory) {
                     const searchResults = wctx.trajectory.searchPainEvents(text, 5);
                     if (searchResults.length > 0) {
+                        const topResult = searchResults[0];
+                        if (!topResult)
+                            continue;
                         // Found similar pain events - record as L3 semantic hit
                         if (eventLog) {
                             eventLog.recordRuleMatch(undefined, {
                                 ruleId: 'l3_semantic',
                                 layer: 'L3',
-                                severity: searchResults[0].score,
+                                severity: topResult.score,
                                 textPreview: text.substring(0, 100)
                             });
                         }
                         // Update detection funnel cache with L3 hit result
-                        funnel.updateCache(text, { detected: true, severity: searchResults[0].score });
+                        funnel.updateCache(text, { detected: true, severity: topResult.score });
                         // Don't track as candidate - this is a confirmed L3 hit
                         if (logger)
                             logger.info(`[PD:EvolutionWorker] L3 semantic hit: found ${searchResults.length} similar pain events for "${text.substring(0, 50)}..."`);

package/plugin/dist/service/internalization-auto-consumer-service.js

@@ -1,4 +1,5 @@
-import { createRuntimeStateHandle, InternalizationOrchestrator, DreamerRunner, DefaultDreamerValidator, PiAiRuntimeAdapter, L2AgentLoopAdapter, buildL2PrincipleReaderFromLedger, loadLedger, OpenClawCliRuntimeAdapter, storeEmitter, resolveRuntimeConfigFromPdConfig, isRuntimeConfigError, computeConsumerDecision, InternalizationQueueReadModel, MVP_CORE_TASK_KINDS, } from '@principles/core/runtime-v2';
+import { createRuntimeStateHandle, InternalizationOrchestrator, DreamerRunner, DefaultDreamerValidator, PiAiRuntimeAdapter, L2AgentLoopAdapter, buildL2PrincipleReaderFromLedger, OpenClawCliRuntimeAdapter, storeEmitter, resolveRuntimeConfigFromPdConfig, isRuntimeConfigError, computeConsumerDecision, InternalizationQueueReadModel, MVP_CORE_TASK_KINDS, } from '@principles/core/runtime-v2';
+import { loadLedger } from '@principles/core/principle-tree-ledger';
 import { loadPdConfigForPlugin, loadFeatureFlagFromConfig } from '../core/pd-config-loader.js';
 import { SystemLogger } from '../core/system-logger.js';
 const INTERNALIZATION_AUTO_CONSUMER_INTERVAL_MS = 120_000;

package/plugin/dist/service/runtime-summary-service.js

@@ -290,7 +290,10 @@ export class RuntimeSummaryService {
         if (sessions.length === 0) {
             return { session: null, reason: 'none' };
         }
-        return { session: sessions[0], reason: 'latest_active' };
+        const session = sessions[0];
+        if (!session)
+            return { session: null, reason: 'none' };
+        return { session, reason: 'latest_active' };
     }
     static mergeSessionSnapshots(persistedSessions, workspaceDir) {
         const merged = new Map();
@@ -392,6 +395,8 @@ export class RuntimeSummaryService {
                         if (!m)
                             continue;
                         const fileDate = m[1];
+                        if (!fileDate)
+                            continue;
                         if (fileDate > newestDate) {
                             newestDate = fileDate;
                             bestFile = path.join(dir, file);
@@ -463,6 +468,8 @@ export class RuntimeSummaryService {
     static findLastPainSignal(events, sessionId) {
         for (let i = events.length - 1; i >= 0; i--) {
             const entry = events[i];
+            if (!entry)
+                continue;
             if (entry.type !== 'pain_signal')
                 continue;
             if (sessionId && entry.sessionId !== sessionId)

package/plugin/dist/service/workflow-watchdog.js

@@ -32,7 +32,8 @@ export async function runWorkflowWatchdog(wctx, api, logger) {
                     const ageMin = Math.round((now - wf.created_at) / 60000);
                     details.push(`stale_active: ${wf.workflow_id} (${wf.workflow_type}, ${ageMin}min old)`);
                     const events = store.getEvents(wf.workflow_id);
-                    const lastEventReason = events.length > 0 ? events[events.length - 1].reason : 'unknown';
+                    const lastEvent = events[events.length - 1];
+                    const lastEventReason = lastEvent ? lastEvent.reason : 'unknown';
                     if (isExpectedSubagentError(lastEventReason)) {
                         logger?.debug?.(`[PD:Watchdog] Skipping stale active workflow ${wf.workflow_id}: expected subagent error (${lastEventReason})`);
                         continue;

package/plugin/dist/utils/retry.js

@@ -245,11 +245,13 @@ export function percentile(values, p) {
     const n = sorted.length;
     // For small samples, use median to avoid overfitting
     if (n < 10) {
-        return sorted[Math.floor(n / 2)];
+        const median = sorted[Math.floor(n / 2)];
+        return median ?? 0;
     }
     // Standard percentile calculation (nearest-rank method)
     const rank = Math.ceil((p / 100) * n);
-    return sorted[Math.min(rank, n) - 1];
+    const result = sorted[Math.min(rank, n) - 1];
+    return result ?? 0;
 }
 /**
  * Clamp timeout to safe bounds.
@@ -317,6 +319,9 @@ export function computeAdaptiveTimeout(history, fallbackMs, options = {}) {
     const sorted = [...history].sort((a, b) => a - b);
     const rank = Math.ceil((p / 100) * sorted.length);
     const pValue = sorted[Math.min(rank, sorted.length) - 1];
+    if (pValue === undefined) {
+        return Math.max(minTimeoutMs, Math.min(maxTimeoutMs, fallbackMs));
+    }
     const adaptive = pValue * safetyMultiplier;
     return Math.max(minTimeoutMs, Math.min(maxTimeoutMs, Math.round(adaptive)));
 }

package/plugin/dist/utils/session-key.js

@@ -13,6 +13,9 @@ export function extractAgentIdFromSessionKey(sessionKey) {
     const match = /^agent:([^:]+):/.exec(sessionKey);
     if (!match)
         return undefined;
-    const agentId = match[1].trim();
+    const raw = match[1];
+    if (!raw)
+        return undefined;
+    const agentId = raw.trim();
     return agentId || undefined;
 }

package/core/dist/io.d.ts

@@ -1,35 +0,0 @@
-/**
- * I/O utilities for @principles/core SDK.
- *
- * Provides atomic file write operations that are crash-safe.
- * No dependencies on openclaw-plugin — self-contained.
- */
-/**
- * AsyncQueueLock — lightweight in-process async queue lock.
- * Serializes async operations on the same key within a single Node.js process.
- * NOT a distributed lock — use for CLI-in-process concurrency only.
- */
-export declare class AsyncQueueLock {
-    private readonly queues;
-    /**
-     * Execute a function while holding an exclusive lock on the given key.
-     * Uses a promise chain to serialize operations — only one operation runs at a time
-     * for any given key within this process.
-     *
-     * @param key - Lock key (e.g. file path to serialize)
-     * @param fn - Async function to execute
-     */
-    withLock<T>(key: string, fn: () => Promise<T>): Promise<T>;
-}
-/**
- * Atomic file write — write to temp file then rename.
- *
- * Prevents corruption if process crashes mid-write.
- * On Windows, retries with exponential backoff on EPERM/EBUSY/EACCES
- * to handle transient file locks.
- *
- * @param filePath - Target file path
- * @param data - Content to write (UTF-8 string)
- */
-export declare function atomicWriteFileSync(filePath: string, data: string): void;
-//# sourceMappingURL=io.d.ts.map

package/core/dist/io.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAE3D;;;;;;;OAOG;IACG,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAkBjE;AAQD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAiCxE"}

package/core/dist/io.js

@@ -1,95 +0,0 @@
-/**
- * I/O utilities for @principles/core SDK.
- *
- * Provides atomic file write operations that are crash-safe.
- * No dependencies on openclaw-plugin — self-contained.
- */
-import * as fs from 'fs';
-/**
- * AsyncQueueLock — lightweight in-process async queue lock.
- * Serializes async operations on the same key within a single Node.js process.
- * NOT a distributed lock — use for CLI-in-process concurrency only.
- */
-export class AsyncQueueLock {
-    queues = new Map();
-    /**
-     * Execute a function while holding an exclusive lock on the given key.
-     * Uses a promise chain to serialize operations — only one operation runs at a time
-     * for any given key within this process.
-     *
-     * @param key - Lock key (e.g. file path to serialize)
-     * @param fn - Async function to execute
-     */
-    async withLock(key, fn) {
-        const lockPath = key;
-        let resolveRelease;
-        const releasePromise = new Promise(r => { resolveRelease = r; });
-        const previousQueue = this.queues.get(lockPath) || Promise.resolve();
-        const currentQueue = previousQueue.then(() => releasePromise);
-        this.queues.set(lockPath, currentQueue);
-        try {
-            await previousQueue;
-            return await fn();
-        }
-        finally {
-            resolveRelease?.();
-            if (this.queues.get(lockPath) === currentQueue) {
-                this.queues.delete(lockPath);
-            }
-        }
-    }
-}
-// Sync mutex: promise chain for synchronous code sections that need serialization.
-// Use for single-process CLI tools that need atomic file access within the same process.
-// NOT a distributed lock — each process gets its own chain on import.
-const RENAME_MAX_RETRIES = 3;
-const RENAME_BASE_DELAY_MS = 50;
-/**
- * Atomic file write — write to temp file then rename.
- *
- * Prevents corruption if process crashes mid-write.
- * On Windows, retries with exponential backoff on EPERM/EBUSY/EACCES
- * to handle transient file locks.
- *
- * @param filePath - Target file path
- * @param data - Content to write (UTF-8 string)
- */
-export function atomicWriteFileSync(filePath, data) {
-    const tmpPath = filePath + '.tmp';
-    fs.writeFileSync(tmpPath, data, 'utf8');
-    let lastError;
-    for (let attempt = 0; attempt < RENAME_MAX_RETRIES; attempt++) {
-        try {
-            fs.renameSync(tmpPath, filePath);
-            return;
-        }
-        catch (err) {
-            lastError = err;
-            const { code } = /** @type {{ code?: string }} */ err;
-            // Only retry on Windows transient lock errors
-            if (code === 'EPERM' || code === 'EBUSY' || code === 'EACCES') {
-                if (attempt < RENAME_MAX_RETRIES - 1) {
-                    const delay = RENAME_BASE_DELAY_MS * Math.pow(2, attempt);
-                    // Synchronous sleep using a tight spin with accessSync yield
-                    const waitUntil = Date.now() + delay;
-                    while (Date.now() < waitUntil) {
-                        try {
-                            fs.accessSync?.(tmpPath);
-                        }
-                        catch { /* ignore */ }
-                    }
-                }
-                continue;
-            }
-            // Non-retryable error — throw immediately
-            break;
-        }
-    }
-    // Clean up temp file on failure
-    try {
-        fs.unlinkSync(tmpPath);
-    }
-    catch { /* best effort */ }
-    throw lastError ?? new Error('atomicWriteFileSync: rename failed');
-}
-//# sourceMappingURL=io.js.map

package/core/dist/io.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"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"}