mustflow 2.112.8 → 2.112.9

package/dist/core/active-run-locks.js

@@ -9,6 +9,7 @@ const LOCK_ROOT_RELATIVE_PATH = '.mustflow/state/locks';
 export const ACTIVE_RUN_LOCK_ID_ENV = 'MUSTFLOW_ACTIVE_RUN_LOCK_ID';
 const LOCK_MUTEX_STALE_MS = 30_000;
 const LOCK_MUTEX_WAIT_MS = 1_000;
+const RUN_STATE_UPDATE_MUTEX_WAIT_MS = 35_000;
 const LOCK_MUTEX_SLEEP_MS = 25;
 const LOCK_MUTEX_SLEEP_BUFFER = new Int32Array(new SharedArrayBuffer(4));
 const LOCK_MUTEX_RECOVERY_DIRECTORY = 'mutex.recovery';
@@ -342,13 +343,14 @@ function recoverStaleMutexWithoutOwner(mutex) {
         releaseRecovery();
     }
 }
-function acquireMutex(projectRoot) {
+function acquireMutex(projectRoot, options = {}) {
     const root = activeLockRoot(projectRoot);
     const mutex = activeLockMutexDirectory(projectRoot);
     const ownerPath = path.join(mutex, 'owner.json');
     const ownerToken = sha256(`${process.pid}:${Date.now()}:${process.hrtime.bigint()}`);
     mkdirSync(root, { recursive: true });
     const startedAt = Date.now();
+    const waitMs = options.waitMs ?? LOCK_MUTEX_WAIT_MS;
     while (true) {
         try {
             mkdirSync(mutex);
@@ -378,7 +380,7 @@ function acquireMutex(projectRoot) {
             if (!error || typeof error !== 'object' || !('code' in error) || error.code !== 'EEXIST') {
                 throw error;
             }
-            if (Date.now() - startedAt > LOCK_MUTEX_WAIT_MS) {
+            if (Date.now() - startedAt > waitMs) {
                 const owner = readMutexOwner(ownerPath);
                 if (owner) {
                     if (mutexOwnerIsStale(owner) && recoverStaleMutexWithOwner(mutex, ownerPath, owner)) {
@@ -414,6 +416,15 @@ function acquireMutex(projectRoot) {
         }
     }
 }
+export function withRunStateUpdateMutex(projectRoot, callback) {
+    const releaseMutex = acquireMutex(projectRoot, { waitMs: RUN_STATE_UPDATE_MUTEX_WAIT_MS });
+    try {
+        return callback();
+    }
+    finally {
+        releaseMutex();
+    }
+}
 export function inspectActiveRunLocks(projectRoot, contract, intentName) {
     const effects = normalizeCommandEffects(projectRoot, contract, intentName);
     const records = readActiveRecords(projectRoot);

package/dist/core/run-performance-history.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
+import { withRunStateUpdateMutex } from './active-run-locks.js';
 import { writeJsonFileInsideWithoutSymlinks } from './safe-filesystem.js';
 const PERFORMANCE_HISTORY_SCHEMA_VERSION = '1';
 const PERFORMANCE_HISTORY_DIR = path.join('.mustflow', 'state', 'perf');
@@ -318,14 +319,16 @@ export function recordRunPerformanceHistory(projectRoot, receipt) {
         return;
     }
     try {
-        const historyDir = path.join(projectRoot, PERFORMANCE_HISTORY_DIR);
-        const samplesPath = path.join(historyDir, PERFORMANCE_SAMPLES_FILE);
-        const summaryPath = path.join(historyDir, PERFORMANCE_SUMMARY_FILE);
-        const samples = enforceSizeLimit(pruneSamples([...readSamples(samplesPath), sample], sample.observed_day), sample.observed_day);
-        const samplesFile = createSamplesFile(samples);
-        const summaryFile = createSummary(samples, sample.observed_day);
-        writeJsonFileInsideWithoutSymlinks(projectRoot, samplesPath, samplesFile);
-        writeJsonFileInsideWithoutSymlinks(projectRoot, summaryPath, summaryFile);
+        withRunStateUpdateMutex(projectRoot, () => {
+            const historyDir = path.join(projectRoot, PERFORMANCE_HISTORY_DIR);
+            const samplesPath = path.join(historyDir, PERFORMANCE_SAMPLES_FILE);
+            const summaryPath = path.join(historyDir, PERFORMANCE_SUMMARY_FILE);
+            const samples = enforceSizeLimit(pruneSamples([...readSamples(samplesPath), sample], sample.observed_day), sample.observed_day);
+            const samplesFile = createSamplesFile(samples);
+            const summaryFile = createSummary(samples, sample.observed_day);
+            writeJsonFileInsideWithoutSymlinks(projectRoot, samplesPath, samplesFile);
+            writeJsonFileInsideWithoutSymlinks(projectRoot, summaryPath, summaryFile);
+        });
     }
     catch {
         // Performance history is a local optimization hint. A write failure must not affect command execution.

package/dist/core/run-profile.js

@@ -1,5 +1,6 @@
 import { performance } from 'node:perf_hooks';
 import path from 'node:path';
+import { withRunStateUpdateMutex } from './active-run-locks.js';
 import { writeJsonFileInsideWithoutSymlinks } from './safe-filesystem.js';
 const RUN_PROFILE_SCHEMA_VERSION = '1';
 const RUN_PROFILE_ENV = 'MUSTFLOW_RUN_PROFILE';
@@ -75,7 +76,9 @@ export class RunProfiler {
             profile_path: getProfileRelativePath(),
         };
         const profilePath = path.join(input.projectRoot, RUN_PROFILE_DIR, LATEST_RUN_PROFILE);
-        writeJsonFileInsideWithoutSymlinks(input.projectRoot, profilePath, profile);
+        withRunStateUpdateMutex(input.projectRoot, () => {
+            writeJsonFileInsideWithoutSymlinks(input.projectRoot, profilePath, profile);
+        });
     }
     recordPhase(name, startedAtMs) {
         this.phases.push({

package/dist/core/run-receipt.js

@@ -1,5 +1,6 @@
 import { createHash } from 'node:crypto';
 import path from 'node:path';
+import { withRunStateUpdateMutex } from './active-run-locks.js';
 import { createStateRunId } from './atomic-state-write.js';
 import { COMMAND_OUTPUT_LIMIT_SCOPE } from './command-output-limits.js';
 import { decodeUtf8Tail } from './bounded-output.js';
@@ -295,9 +296,11 @@ export function writeRunReceipt(projectRoot, receipt, policy) {
     if (relativeToRunDir.startsWith('..') || path.isAbsolute(relativeToRunDir)) {
         throw new Error(`Run receipt path must stay inside ${RUN_RECEIPT_DIR}`);
     }
-    writeJsonFileInsideWithoutSymlinks(projectRoot, receiptPath, receipt);
-    writeJsonFileInsideWithoutSymlinks(projectRoot, latestPath, receipt);
-    if (policy) {
-        updateRunReceiptState(projectRoot, policy);
-    }
+    withRunStateUpdateMutex(projectRoot, () => {
+        writeJsonFileInsideWithoutSymlinks(projectRoot, receiptPath, receipt);
+        writeJsonFileInsideWithoutSymlinks(projectRoot, latestPath, receipt);
+        if (policy) {
+            updateRunReceiptState(projectRoot, policy);
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mustflow",
-  "version": "2.112.8",
+  "version": "2.112.9",
   "description": "Agent workflow documents and CLI for mustflow repository roots.",
   "type": "module",
   "license": "MIT-0",

package/templates/default/manifest.toml

@@ -1,6 +1,6 @@
 id = "default"
 name = "default"
-version = "2.112.8"
+version = "2.112.9"
 description = "Minimal workflow for LLM agents to read, edit, and verify their work in a repository."
 common_root = "common"
 locales_root = "locales"