cclaw-cli 0.48.15 → 0.48.17

package/dist/run-persistence.d.ts

@@ -11,6 +11,13 @@ export interface WriteFlowStateOptions {
      * bootstrap, or explicit recovery; never set from normal stage handlers.
      */
     allowReset?: boolean;
+    /**
+     * When true, skip the internal directory-lock acquisition. The caller
+     * MUST already hold `flowStateLockPath(projectRoot)` for the duration
+     * of this call. Used by run-archive to keep the full archive +
+     * flow-state reset inside one atomic lock window.
+     */
+    skipLock?: boolean;
 }
 export interface ReadFlowStateOptions {
     /**
@@ -26,6 +33,12 @@ export declare class CorruptFlowStateError extends Error {
 }
 export declare function readFlowState(projectRoot: string, options?: ReadFlowStateOptions): Promise<FlowState>;
 export declare function writeFlowState(projectRoot: string, state: FlowState, options?: WriteFlowStateOptions): Promise<void>;
+/**
+ * Exposed path helper so callers that need to serialize a multi-step
+ * state operation with flow-state writes (e.g. run archival) can
+ * acquire the SAME lock directory used internally by `writeFlowState`.
+ */
+export declare function flowStateLockPathFor(projectRoot: string): string;
 interface EnsureRunSystemOptions {
     createIfMissing?: boolean;
 }

package/dist/run-persistence.js

@@ -362,7 +362,7 @@ export async function readFlowState(projectRoot, options = {}) {
 }
 export async function writeFlowState(projectRoot, state, options = {}) {
     await ensureFeatureSystem(projectRoot);
-    await withDirectoryLock(flowStateLockPath(projectRoot), async () => {
+    const doWrite = async () => {
         const statePath = flowStatePath(projectRoot);
         if (!options.allowReset && (await exists(statePath))) {
             try {
@@ -382,9 +382,23 @@ export async function writeFlowState(projectRoot, state, options = {}) {
         }
         const safe = coerceFlowState({ ...state });
         await writeFileSafe(statePath, `${JSON.stringify(safe, null, 2)}\n`, { mode: 0o600 });
-    });
+    };
+    if (options.skipLock) {
+        await doWrite();
+    }
+    else {
+        await withDirectoryLock(flowStateLockPath(projectRoot), doWrite);
+    }
     await syncActiveFeatureSnapshot(projectRoot);
 }
+/**
+ * Exposed path helper so callers that need to serialize a multi-step
+ * state operation with flow-state writes (e.g. run archival) can
+ * acquire the SAME lock directory used internally by `writeFlowState`.
+ */
+export function flowStateLockPathFor(projectRoot) {
+    return flowStateLockPath(projectRoot);
+}
 export async function ensureRunSystem(projectRoot, _options = {}) {
     await ensureFeatureSystem(projectRoot);
     await ensureDir(runsRoot(projectRoot));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cclaw-cli",
-  "version": "0.48.15",
+  "version": "0.48.17",
   "description": "Installer-first flow toolkit for coding agents",
   "type": "module",
   "bin": {