principles-disciple 1.7.1 → 1.7.2

package/dist/utils/file-lock.js

@@ -10,6 +10,16 @@
  */
 import * as fs from 'fs';
 import * as path from 'path';
+export class LockAcquisitionError extends Error {
+    filePath;
+    lockPath;
+    constructor(message, filePath, lockPath) {
+        super(message);
+        this.name = 'LockAcquisitionError';
+        this.filePath = filePath;
+        this.lockPath = lockPath;
+    }
+}
 /** 默认锁选项 */
 const DEFAULT_OPTIONS = {
     maxRetries: 50,
@@ -134,15 +144,39 @@ function calculateBackoff(attempt, baseMs, maxMs) {
     const jitter = exponentialDelay * 0.2 * Math.random();
     return Math.floor(exponentialDelay + jitter);
 }
-/**
- * 同步 sleep
- */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
 function sleepSync(ms) {
     const end = Date.now() + ms;
     while (Date.now() < end) {
-        // busy wait（同步函数无法使用 setTimeout）
+        // busy wait for synchronous retry
     }
 }
+function buildLockError(filePath, lockPath) {
+    const holderPid = readLockPid(lockPath);
+    const holderStatus = holderPid !== null
+        ? (isProcessAlive(holderPid) ? `alive (PID ${holderPid})` : `dead (PID ${holderPid})`)
+        : 'unknown';
+    return new LockAcquisitionError(`Failed to acquire lock for ${filePath}. Lock holder: ${holderStatus}.`, filePath, lockPath);
+}
+function tryAcquireWithStaleCleanup(filePath, opts, pid) {
+    const lockPath = filePath + opts.lockSuffix;
+    if (tryAcquireLock(lockPath, pid)) {
+        const actualPid = readLockPid(lockPath);
+        if (actualPid === pid) {
+            return { lockPath, pid, acquiredAt: Date.now() };
+        }
+    }
+    cleanupStaleLock(lockPath, opts.lockStaleMs);
+    if (tryAcquireLock(lockPath, pid)) {
+        const actualPid = readLockPid(lockPath);
+        if (actualPid === pid) {
+            return { lockPath, pid, acquiredAt: Date.now() };
+        }
+    }
+    return null;
+}
 /**
  * 获取文件锁
  *
@@ -153,37 +187,33 @@ function sleepSync(ms) {
  */
 export function acquireLock(filePath, options = {}) {
     const opts = { ...DEFAULT_OPTIONS, ...options };
-    const lockPath = filePath + opts.lockSuffix;
     const pid = process.pid;
     for (let attempt = 0; attempt < opts.maxRetries; attempt++) {
-        // 1. 尝试原子获取锁
-        if (tryAcquireLock(lockPath, pid)) {
-            // 2. 二次验证：确保我们真的持有锁
-            const actualPid = readLockPid(lockPath);
-            if (actualPid === pid) {
-                return {
-                    lockPath,
-                    pid,
-                    acquiredAt: Date.now(),
-                };
-            }
-            // PID 不匹配，说明被其他进程抢占，继续重试
+        const ctx = tryAcquireWithStaleCleanup(filePath, opts, pid);
+        if (ctx) {
+            return ctx;
         }
-        // 3. 获取失败，检查是否需要清理过期锁
-        cleanupStaleLock(lockPath, opts.lockStaleMs);
-        // 4. 计算退避时间并等待
         if (attempt < opts.maxRetries - 1) {
             const delay = calculateBackoff(attempt, opts.baseRetryDelayMs, opts.maxRetryDelayMs);
             sleepSync(delay);
         }
     }
-    // 5. 所有重试都失败，抛出异常（不静默丢弃！）
-    const holderPid = readLockPid(lockPath);
-    const holderStatus = holderPid !== null
-        ? (isProcessAlive(holderPid) ? `alive (PID ${holderPid})` : `dead (PID ${holderPid})`)
-        : 'unknown';
-    throw new Error(`Failed to acquire lock for ${filePath} after ${opts.maxRetries} attempts. ` +
-        `Lock holder: ${holderStatus}. Consider increasing maxRetries or checking for zombie processes.`);
+    throw buildLockError(filePath, filePath + opts.lockSuffix);
+}
+export async function acquireLockAsync(filePath, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const pid = process.pid;
+    for (let attempt = 0; attempt < opts.maxRetries; attempt++) {
+        const ctx = tryAcquireWithStaleCleanup(filePath, opts, pid);
+        if (ctx) {
+            return ctx;
+        }
+        if (attempt < opts.maxRetries - 1) {
+            const delay = calculateBackoff(attempt, opts.baseRetryDelayMs, opts.maxRetryDelayMs);
+            await sleep(delay);
+        }
+    }
+    throw buildLockError(filePath, filePath + opts.lockSuffix);
 }
 /**
  * 释放文件锁
@@ -210,6 +240,15 @@ export function withLock(filePath, fn, options = {}) {
         releaseLock(ctx);
     }
 }
+export async function withLockAsync(filePath, fn, options = {}) {
+    const ctx = await acquireLockAsync(filePath, options);
+    try {
+        return await fn();
+    }
+    finally {
+        releaseLock(ctx);
+    }
+}
 /**
  * 异步版本的文件锁（使用 Promise 链）
  *

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
-{
+{
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Evolutionary programming agent framework with strategic guardrails and reflection loops.",
-  "version": "1.7.1",
+  "version": "1.7.2",
   "skills": [
     "./skills"
   ],
@@ -17,7 +17,7 @@
           "zh"
         ],
         "default": "zh",
-        "description": "系统提示词和交互语言 (默认推荐: zh)"
+        "description": "绯荤粺鎻愮ず璇嶅拰浜や簰璇█ (榛樿鎺ㄨ崘: zh)"
       },
       "auditLevel": {
         "type": "string",
@@ -27,7 +27,7 @@
           "high"
         ],
         "default": "medium",
-        "description": "安全防爆级别：\n- low: 极客模式，几乎不拦截，AI 可以自由飞翔。\n- medium (推荐): 平衡模式，允许 AI 大胆尝试，但拦截毁灭性操作。\n- high: 严格模式，所有大范围修改都需要你明确授权。"
+        "description": "瀹夊叏闃茬垎绾у埆锛歕n- low: 鏋佸妯″紡锛屽嚑涔庝笉鎷︽埅锛孉I 鍙互鑷敱椋炵繑銆俓n- medium (鎺ㄨ崘): 骞宠　妯″紡锛屽厑璁?AI 澶ц儐灏濊瘯锛屼絾鎷︽埅姣佺伃鎬ф搷浣溿€俓n- high: 涓ユ牸妯″紡锛屾墍鏈夊ぇ鑼冨洿淇敼閮介渶瑕佷綘鏄庣‘鎺堟潈銆?
       },
       "riskPaths": {
         "type": "array",
@@ -35,17 +35,17 @@
           "type": "string"
         },
         "default": [],
-        "description": "自定义高危目录（例如 .git/, prod_db/）。AI 试图修改这些目录前，将被强制拦截并要求出具安全计划。"
+        "description": "鑷畾涔夐珮鍗辩洰褰曪紙渚嬪 .git/, prod_db/锛夈€侫I 璇曞浘淇敼杩欎簺鐩綍鍓嶏紝灏嗚寮哄埗鎷︽埅骞惰姹傚嚭鍏峰畨鍏ㄨ鍒掋€?
       },
       "deep_reflection": {
         "type": "object",
         "additionalProperties": false,
-        "description": "当 AI 遇到复杂问题或连续报错时，是否允许它停下来进行深度自我反思？",
+        "description": "褰?AI 閬囧埌澶嶆潅闂鎴栬繛缁姤閿欐椂锛屾槸鍚﹀厑璁稿畠鍋滀笅鏉ヨ繘琛屾繁搴﹁嚜鎴戝弽鎬濓紵",
         "properties": {
           "enabled": {
             "type": "boolean",
             "default": true,
-            "description": "开启 AI 深度反思功能"
+            "description": "寮€鍚?AI 娣卞害鍙嶆€濆姛鑳?
           },
           "mode": {
             "type": "string",
@@ -54,7 +54,7 @@
               "forced"
             ],
             "default": "auto",
-            "description": "auto: 遇到困难自动触发; forced: 每次回答前都强制反思(极耗时间，不推荐)"
+            "description": "auto: 閬囧埌鍥伴毦鑷姩瑙﹀彂; forced: 姣忔鍥炵瓟鍓嶉兘寮哄埗鍙嶆€?鏋佽€楁椂闂达紝涓嶆帹鑽?"
           }
         }
       }
@@ -62,17 +62,18 @@
   },
   "uiHints": {
     "language": {
-      "label": "交互语言"
+      "label": "浜や簰璇█"
     },
     "auditLevel": {
-      "label": "防爆拦截级别",
+      "label": "闃茬垎鎷︽埅绾у埆",
       "placeholder": "medium"
     },
     "riskPaths": {
-      "label": "☠️ 绝对高危目录 (空表示不设限)"
+      "label": "鈽狅笍 缁濆楂樺嵄鐩綍 (绌鸿〃绀轰笉璁鹃檺)"
     },
     "deep_reflection": {
-      "label": "💡 AI 深度反思功能"
+      "label": "馃挕 AI 娣卞害鍙嶆€濆姛鑳?
     }
   }
 }
+

package/package.json

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