@karmaniverous/jeeves-meta-openclaw 0.10.4 → 0.10.5

package/dist/cli.js

@@ -15403,14 +15403,14 @@ const SECTION_ORDER = [
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.5.4` placeholder is replaced by
+ * The `0.5.5` placeholder is replaced by
  * `@rollup/plugin-replace` during the build with the actual version
  * from `package.json`. This ensures the correct version survives
  * when consumers bundle core into their own dist (where runtime
  * `import.meta.url`-based resolution would find the wrong package.json).
  */
 /** The core library version from package.json (inlined at build time). */
-const CORE_VERSION = '0.5.4';
+const CORE_VERSION = '0.5.5';
 
 /**
  * Workspace and config root initialization.
@@ -15459,7 +15459,7 @@ const STALE_LOCK_MS = 120_000;
 /** Default core version when none provided. */
 const DEFAULT_CORE_VERSION = CORE_VERSION;
 /** Lock retry options. */
-const LOCK_RETRIES = { retries: 5, minTimeout: 100, maxTimeout: 1000 };
+const LOCK_RETRIES = { retries: 0 };
 /** Maximum rename retry attempts on EPERM. */
 const ATOMIC_WRITE_MAX_RETRIES = 3;
 /** Delay between EPERM retries in milliseconds. */
@@ -15502,26 +15502,15 @@ function atomicWrite(filePath, content) {
         }
     }
 }
-/**
- * Execute a callback while holding a file lock.
- *
- * @remarks
- * Acquires a lock on the file, executes the callback, and releases
- * the lock in a finally block. The lock uses a 2-minute stale threshold
- * and retries up to 5 times.
- *
- * @param filePath - Absolute path to the file to lock.
- * @param fn - Async callback to execute while holding the lock.
- */
-async function withFileLock(filePath, fn) {
+async function withLock(targetPath, fn, options, onLockError) {
     let release;
     try {
-        release = await properLockfileExports.lock(filePath, {
-            stale: STALE_LOCK_MS,
-            retries: LOCK_RETRIES,
-        });
+        release = await properLockfileExports.lock(targetPath, options);
         await fn();
     }
+    catch (error) {
+        throw error;
+    }
     finally {
         if (release) {
             try {
@@ -15533,6 +15522,23 @@ async function withFileLock(filePath, fn) {
         }
     }
 }
+/**
+ * Execute a callback while holding a file lock.
+ *
+ * @remarks
+ * Acquires a lock on the file, executes the callback, and releases
+ * the lock in a finally block. The lock uses a 2-minute stale threshold
+ * and retries up to 5 times.
+ *
+ * @param filePath - Absolute path to the file to lock.
+ * @param fn - Async callback to execute while holding the lock.
+ */
+async function withFileLock(filePath, fn) {
+    await withLock(filePath, fn, {
+        stale: STALE_LOCK_MS,
+        retries: LOCK_RETRIES,
+    });
+}
 /** Core shared config section. */
 const workspaceCoreConfigSchema = object({
     /** Workspace root path. */

package/dist/index.js

@@ -1,4 +1,4 @@
-import fs, { existsSync, readFileSync, mkdirSync, writeFileSync, unlinkSync, renameSync, cpSync } from 'node:fs';
+import fs, { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync, renameSync, cpSync } from 'node:fs';
 import path, { join, dirname, basename } from 'node:path';
 import { randomUUID } from 'node:crypto';
 import require$$0$4 from 'path';
@@ -15480,14 +15480,14 @@ const PLATFORM_COMPONENTS = [
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.5.4` placeholder is replaced by
+ * The `0.5.5` placeholder is replaced by
  * `@rollup/plugin-replace` during the build with the actual version
  * from `package.json`. This ensures the correct version survives
  * when consumers bundle core into their own dist (where runtime
  * `import.meta.url`-based resolution would find the wrong package.json).
  */
 /** The core library version from package.json (inlined at build time). */
-const CORE_VERSION = '0.5.4';
+const CORE_VERSION = '0.5.5';
 
 /**
  * Workspace and config root initialization.
@@ -15568,7 +15568,11 @@ const STALE_LOCK_MS = 120_000;
 /** Default core version when none provided. */
 const DEFAULT_CORE_VERSION = CORE_VERSION;
 /** Lock retry options. */
-const LOCK_RETRIES = { retries: 5, minTimeout: 100, maxTimeout: 1000 };
+const LOCK_RETRIES = { retries: 0 };
+/** Workspace lock retry options. */
+const WORKSPACE_LOCK_RETRIES = { retries: 0 };
+/** Workspace lock file name. */
+const WORKSPACE_LOCK_FILE = 'jeeves.lock';
 /** Maximum rename retry attempts on EPERM. */
 const ATOMIC_WRITE_MAX_RETRIES = 3;
 /** Delay between EPERM retries in milliseconds. */
@@ -15611,26 +15615,18 @@ function atomicWrite(filePath, content) {
         }
     }
 }
-/**
- * Execute a callback while holding a file lock.
- *
- * @remarks
- * Acquires a lock on the file, executes the callback, and releases
- * the lock in a finally block. The lock uses a 2-minute stale threshold
- * and retries up to 5 times.
- *
- * @param filePath - Absolute path to the file to lock.
- * @param fn - Async callback to execute while holding the lock.
- */
-async function withFileLock(filePath, fn) {
+async function withLock(targetPath, fn, options, onLockError) {
     let release;
     try {
-        release = await properLockfileExports.lock(filePath, {
-            stale: STALE_LOCK_MS,
-            retries: LOCK_RETRIES,
-        });
+        release = await properLockfileExports.lock(targetPath, options);
         await fn();
     }
+    catch (error) {
+        if (onLockError?.(error)) {
+            return;
+        }
+        throw error;
+    }
     finally {
         if (release) {
             try {
@@ -15642,6 +15638,44 @@ async function withFileLock(filePath, fn) {
         }
     }
 }
+/**
+ * Execute a callback while holding a file lock.
+ *
+ * @remarks
+ * Acquires a lock on the file, executes the callback, and releases
+ * the lock in a finally block. The lock uses a 2-minute stale threshold
+ * and retries up to 5 times.
+ *
+ * @param filePath - Absolute path to the file to lock.
+ * @param fn - Async callback to execute while holding the lock.
+ */
+async function withFileLock(filePath, fn) {
+    await withLock(filePath, fn, {
+        stale: STALE_LOCK_MS,
+        retries: LOCK_RETRIES,
+    });
+}
+/**
+ * Execute a callback while holding the workspace cycle lock.
+ *
+ * @remarks
+ * Acquires a lock on `{workspacePath}/jeeves.lock`, executes the callback,
+ * and releases the lock in a finally block. If the lock is already held,
+ * returns silently so the caller can skip this cycle.
+ *
+ * @param workspacePath - Absolute workspace path.
+ * @param fn - Async callback to execute while holding the lock.
+ */
+async function withWorkspaceLock(workspacePath, fn) {
+    const lockPath = join(workspacePath, WORKSPACE_LOCK_FILE);
+    writeFileSync(lockPath, '', { flag: 'a' });
+    await withLock(lockPath, fn, {
+        stale: STALE_LOCK_MS,
+        retries: WORKSPACE_LOCK_RETRIES,
+    }, (error) => error instanceof Error &&
+        'code' in error &&
+        error.code === 'ELOCKED');
+}
 
 /**
  * Shared internal utility functions.
@@ -15973,7 +16007,7 @@ function buildHeartbeatSection(entries) {
  *
  * @remarks
  * Replaces everything from `# Jeeves Platform Status` to EOF.
- * Preserves user content above the heading. Uses file-level locking.
+ * Preserves user content above the heading.
  *
  * @param filePath - Absolute path to HEARTBEAT.md.
  * @param entries - Component entries to write.
@@ -17194,7 +17228,7 @@ function stripForeignMarkers(content, currentMarkers) {
  * - `block`: Replaces the entire managed block (SOUL.md, AGENTS.md).
  * - `section`: Upserts a named H2 section within the managed block (TOOLS.md).
  *
- * Provides file-level locking, version-stamp convergence, and atomic writes.
+ * Provides version-stamp convergence and atomic writes.
  */
 /**
  * Update a managed section in a file.
@@ -18572,6 +18606,7 @@ class ComponentWriter {
     configDir;
     gatewayUrl;
     pendingCleanups = new Set();
+    cyclePromise;
     /** @internal */
     constructor(component, options) {
         this.component = component;
@@ -18584,7 +18619,9 @@ class ComponentWriter {
     }
     /** Whether the writer timer is currently running or pending its first cycle. */
     get isRunning() {
-        return this.jitterTimeout !== undefined || this.timer !== undefined;
+        return (this.jitterTimeout !== undefined ||
+            this.timer !== undefined ||
+            this.cyclePromise !== undefined);
     }
     /**
      * Start the writer timer.
@@ -18602,8 +18639,7 @@ class ComponentWriter {
         const jitterMs = Math.floor(Math.random() * intervalMs);
         this.jitterTimeout = setTimeout(() => {
             this.jitterTimeout = undefined;
-            void this.cycle();
-            this.timer = setInterval(() => void this.cycle(), intervalMs);
+            this.scheduleNextCycle(0, intervalMs);
         }, jitterMs);
     }
     /** Stop the writer timer. */
@@ -18613,10 +18649,19 @@ class ComponentWriter {
             this.jitterTimeout = undefined;
         }
         if (this.timer) {
-            clearInterval(this.timer);
+            clearTimeout(this.timer);
             this.timer = undefined;
         }
     }
+    scheduleNextCycle(delayMs, intervalMs) {
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            void this.cycle().finally(() => {
+                if (this.isRunning)
+                    this.scheduleNextCycle(intervalMs, intervalMs);
+            });
+        }, delayMs);
+    }
     /**
      * Execute a single write cycle.
      *
@@ -18627,44 +18672,54 @@ class ComponentWriter {
      * 4. Run HEARTBEAT health orchestration.
      */
     async cycle() {
+        if (this.cyclePromise)
+            return this.cyclePromise;
+        this.cyclePromise = this.runCycle().finally(() => {
+            this.cyclePromise = undefined;
+        });
+        return this.cyclePromise;
+    }
+    async runCycle() {
         try {
             const workspacePath = getWorkspacePath();
             const toolsPath = join(workspacePath, WORKSPACE_FILES.tools);
-            // 1. Write the component's TOOLS.md section
-            const toolsContent = this.component.generateToolsContent();
-            await updateManagedSection(toolsPath, toolsContent, {
-                mode: 'section',
-                sectionId: this.component.sectionId,
-                markers: TOOLS_MARKERS,
-                coreVersion: CORE_VERSION,
-            });
-            // 2. Platform content maintenance
-            await refreshPlatformContent({
-                coreVersion: CORE_VERSION,
-                componentName: this.component.name,
-                componentVersion: this.component.version,
-                servicePackage: this.component.servicePackage,
-                pluginPackage: this.component.pluginPackage,
-            });
-            // 3. Cleanup escalation
-            if (this.gatewayUrl) {
-                scanAndEscalateCleanup([
-                    { filePath: toolsPath, markerIdentity: 'TOOLS' },
-                    {
-                        filePath: join(workspacePath, WORKSPACE_FILES.soul),
-                        markerIdentity: 'SOUL',
-                    },
-                    {
-                        filePath: join(workspacePath, WORKSPACE_FILES.agents),
-                        markerIdentity: 'AGENTS',
-                    },
-                ], this.gatewayUrl, this.pendingCleanups);
-            }
-            // 4. HEARTBEAT orchestration
-            await runHeartbeatCycle({
-                workspacePath,
-                coreConfigDir: getCoreConfigDir(),
-                configRoot: getConfigRoot$1(),
+            await withWorkspaceLock(workspacePath, async () => {
+                // 1. Write the component's TOOLS.md section
+                const toolsContent = this.component.generateToolsContent();
+                await updateManagedSection(toolsPath, toolsContent, {
+                    mode: 'section',
+                    sectionId: this.component.sectionId,
+                    markers: TOOLS_MARKERS,
+                    coreVersion: CORE_VERSION,
+                });
+                // 2. Platform content maintenance
+                await refreshPlatformContent({
+                    coreVersion: CORE_VERSION,
+                    componentName: this.component.name,
+                    componentVersion: this.component.version,
+                    servicePackage: this.component.servicePackage,
+                    pluginPackage: this.component.pluginPackage,
+                });
+                // 3. Cleanup escalation
+                if (this.gatewayUrl) {
+                    scanAndEscalateCleanup([
+                        { filePath: toolsPath, markerIdentity: 'TOOLS' },
+                        {
+                            filePath: join(workspacePath, WORKSPACE_FILES.soul),
+                            markerIdentity: 'SOUL',
+                        },
+                        {
+                            filePath: join(workspacePath, WORKSPACE_FILES.agents),
+                            markerIdentity: 'AGENTS',
+                        },
+                    ], this.gatewayUrl, this.pendingCleanups);
+                }
+                // 4. HEARTBEAT orchestration
+                await runHeartbeatCycle({
+                    workspacePath,
+                    coreConfigDir: getCoreConfigDir(),
+                    configRoot: getConfigRoot$1(),
+                });
             });
         }
         catch (err) {

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "jeeves-meta-openclaw",
   "name": "Jeeves Meta",
   "description": "Knowledge synthesis tools — trigger synthesis, view status, manage entities.",
-  "version": "0.10.4",
+  "version": "0.10.5",
   "skills": [
     "dist/skills/jeeves-meta"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-meta-openclaw",
-  "version": "0.10.4",
+  "version": "0.10.5",
   "author": "Jason Williscroft",
   "description": "OpenClaw plugin for jeeves-meta — synthesis tools and virtual rule registration",
   "license": "BSD-3-Clause",