@software-dlc/cli 0.157.2

package/dist/local/workspace-integration-runtime.js

@@ -0,0 +1,419 @@
+import { introducedDanglingDocumentEmbeds } from './document-embeds.js';
+import { composeGraphProjection } from './projection.js';
+import { graphClaimChanges, readBuiltView } from './workspace-built-content.js';
+import { localGraphRootHash } from './workspace-graph-store.js';
+import { withWorkspaceOperationLock } from './workspace-lock.js';
+import { mergeLocalPortableGraphs } from './workspace-merge.js';
+import { workspaceControlDirectory, workspaceProjectionDirectory } from './workspace-paths.js';
+import { resolveLocalGraphConflicts } from './workspace-resolution.js';
+import { assertGraphChangesWithinTaskScope, assertNodeTypeRulesOnChangedNodes, assertNoRetiredKeysOnChangedNodes } from './workspace-scope.js';
+import { assertIntroducedVocabularyAdmitted } from './workspace-admission.js';
+export class LocalWorkspaceIntegrationRuntime {
+    store;
+    graphs;
+    authority;
+    commits;
+    materialize_projection;
+    constructor(store, graphs, authority, commits, materialize_projection) {
+        this.store = store;
+        this.graphs = graphs;
+        this.authority = authority;
+        this.commits = commits;
+        this.materialize_projection = materialize_projection;
+    }
+    async enqueue(input) {
+        const { workspace: coordinator } = await this.authority.requireCurrent(input.actor_workspace_id);
+        const child = this.requireWorkspace(input.child_workspace_id);
+        const refusal = this.store.decisions.integrationRefusal(child.id);
+        if (refusal)
+            throw new Error(refusal);
+        const child_commit_id = input.child_commit_id ?? child.head_sdlc_commit_id;
+        const base_graph = await this.commits.readGraph(this.store.history.findMergeBase(coordinator.head_sdlc_commit_id, child_commit_id));
+        const child_graph = await this.commits.readGraph(child_commit_id);
+        assertGraphChangesWithinTaskScope({
+            base_graph,
+            current_graph: child_graph,
+            task_scope: this.store.getWorkspaceTaskScope(child.id)
+        });
+        assertNoRetiredKeysOnChangedNodes({
+            base_graph,
+            current_graph: child_graph
+        });
+        assertNodeTypeRulesOnChangedNodes({
+            base_graph,
+            current_graph: child_graph
+        });
+        assertIntroducedVocabularyAdmitted({
+            base_graph,
+            graph: child_graph,
+            admission: this.store.admissions.get()
+        });
+        const queue_entry = this.store.history.enqueueChildCommit({
+            actor_workspace_id: coordinator.id,
+            child_workspace_id: child.id,
+            child_commit_id
+        });
+        if (input.gate) {
+            if (queue_entry.status !== 'queued' &&
+                !this.store.built_content.queueGate(queue_entry.id)) {
+                throw new Error('This commit already integrated without a gate; a gate merge needs a later commit.');
+            }
+            this.store.built_content.setQueueGate(queue_entry.id, input.gate);
+        }
+        else if (this.store.built_content.queueGate(queue_entry.id)) {
+            if (queue_entry.status !== 'integrated') {
+                throw new Error('This commit is already queued under a gate; run the integration before landing it.');
+            }
+            // A plan often lands with no commit after its gate: the same commit
+            // queues again, as a landing.
+            this.store.built_content.requeueAsLanding(queue_entry.id);
+            return this.store.history
+                .listIntegrationQueue(coordinator.id)
+                .find((entry) => entry.id === queue_entry.id);
+        }
+        return queue_entry;
+    }
+    /** The coordinator's graph as built (see workspace-built-content.ts). */
+    async readBuiltView(input) {
+        const coordinator = this.requireWorkspace(input.coordinator_workspace_id);
+        return readBuiltView({
+            graph: await this.commits.readGraph(coordinator.head_sdlc_commit_id),
+            pending: this.store.built_content.listPendingClaimContent(coordinator.id),
+            readGraph: (commit_id) => this.commits.readGraph(commit_id)
+        });
+    }
+    async integrate(input) {
+        const { workspace: coordinator } = await this.authority.requireCurrent(input.actor_workspace_id);
+        const max_retries = this.retryBudget(input.max_retries, 'Integration');
+        return withWorkspaceOperationLock({
+            control_dir: workspaceControlDirectory(coordinator),
+            operation: 'integrate',
+            run: async () => {
+                // Claims recorded before the store kept their content get it once, so
+                // the built view stops reading their commits' graphs.
+                await this.store.built_content.fillPendingClaimContent({
+                    coordinator_workspace_id: coordinator.id,
+                    readGraph: (commit_id) => this.commits.readGraph(commit_id)
+                });
+                for (let attempt = 0; attempt <= max_retries; attempt += 1) {
+                    const result = await this.integrateAttempt(coordinator.id, input);
+                    if (result.status === 'retrying' && attempt < max_retries)
+                        continue;
+                    return result;
+                }
+                throw new Error('Integration retry loop exited unexpectedly.');
+            }
+        });
+    }
+    async reconcile(input) {
+        const { workspace: coordinator } = await this.authority.requireCurrent(input.actor_workspace_id);
+        const max_retries = this.retryBudget(input.max_retries, 'Reconciliation');
+        if (coordinator.source_workspace_id !== input.source_workspace_id) {
+            throw new Error('Source must match the recorded source workspace.');
+        }
+        return withWorkspaceOperationLock({
+            control_dir: workspaceControlDirectory(coordinator),
+            operation: 'reconcile-source',
+            run: async () => {
+                for (let attempt = 0; attempt <= max_retries; attempt += 1) {
+                    const result = await this.reconcileAttempt(coordinator.id, input);
+                    if (result.status === 'retrying' && attempt < max_retries)
+                        continue;
+                    return result;
+                }
+                throw new Error('Reconciliation retry loop exited unexpectedly.');
+            }
+        });
+    }
+    async integrateAttempt(coordinator_id, input) {
+        const coordinator = this.requireWorkspace(coordinator_id);
+        await this.assertProjectionClean(coordinator);
+        // An entry queued before its workspace joined a Decision waits for the
+        // Selection without holding up the rest of the queue.
+        const candidates = this.store.history
+            .listIntegrationQueue(coordinator.id)
+            .filter((entry) => entry.status === 'queued' &&
+            !this.store.decisions.integrationRefusal(entry.child_workspace_id));
+        if (!candidates.length)
+            return { version: 1, status: 'empty' };
+        const coordinator_graph = await this.commits.readGraph(coordinator.head_sdlc_commit_id);
+        // Likewise an entry the vocabulary admission gate refuses: every publish
+        // turn rewrites the record, so it may refuse what it admitted at enqueue.
+        // The entry waits, queued, for its capability; the first refusal is thrown
+        // only when no entry can go.
+        const admission = this.store.admissions.get();
+        let picked = null;
+        let refusal = null;
+        for (const entry of candidates) {
+            // A plan reconciled with the coordinator shares the work it took in; its
+            // own changes are those since that point, not since it first forked.
+            const merge_base_commit_id = this.store.history.findMergeBase(coordinator.head_sdlc_commit_id, entry.child_commit_id);
+            const base_graph = await this.commits.readGraph(merge_base_commit_id);
+            const child_graph = await this.commits.readGraph(entry.child_commit_id);
+            // What the plan itself introduces, against its merge base: a mismatch
+            // that only merging with another plan creates stays the validator's
+            // warning.
+            // An entry queued before the node-type rule waits the same way, so it
+            // never holds the plans behind it (iss-477).
+            try {
+                assertIntroducedVocabularyAdmitted({
+                    base_graph,
+                    graph: child_graph,
+                    admission
+                });
+                assertNodeTypeRulesOnChangedNodes({
+                    base_graph,
+                    current_graph: child_graph
+                });
+            }
+            catch (error) {
+                refusal ??= error;
+                continue;
+            }
+            picked = {
+                queue_entry: entry,
+                merge_base_commit_id,
+                base_graph,
+                child_graph
+            };
+            break;
+        }
+        if (!picked)
+            throw refusal;
+        const { queue_entry, merge_base_commit_id, base_graph, child_graph } = picked;
+        const child = this.requireWorkspace(queue_entry.child_workspace_id);
+        const task_scope = this.store.getWorkspaceTaskScope(child.id);
+        assertGraphChangesWithinTaskScope({
+            base_graph,
+            current_graph: child_graph,
+            task_scope
+        });
+        assertNoRetiredKeysOnChangedNodes({
+            base_graph,
+            current_graph: child_graph
+        });
+        const deterministic_merge_result = mergeLocalPortableGraphs({
+            base_graph,
+            coordinator_graph,
+            child_graph
+        });
+        let merge_result = deterministic_merge_result;
+        let resolution_attempts = [];
+        if (deterministic_merge_result.status === 'blocked_conflict' &&
+            input.conflict_resolver) {
+            const resolution_result = await resolveLocalGraphConflicts({
+                base_graph,
+                coordinator_graph,
+                child_graph,
+                merge_result: deterministic_merge_result,
+                task_scope,
+                resolver: input.conflict_resolver,
+                budget: input.resolution_budget,
+                allow_network_resolver: input.allow_network_resolver,
+                persist_candidate_graph: (graph) => this.graphs.writeGraph(graph)
+            });
+            resolution_attempts = resolution_result.attempts;
+            if (resolution_result.status !== 'blocked_conflict') {
+                merge_result = resolution_result.merge_result;
+            }
+        }
+        if (merge_result.status !== 'blocked_conflict') {
+            await this.graphs.writeGraph(merge_result.graph);
+        }
+        // Embeds neither side left dangling but the merge does: one plan removed
+        // an entity that the other plan's Document embeds. Reported, never refused.
+        const embed_warnings = merge_result.status === 'clean'
+            ? introducedDanglingDocumentEmbeds({
+                base_graph: coordinator_graph,
+                graph: merge_result.graph
+            }).filter((warning) => introducedDanglingDocumentEmbeds({
+                base_graph: child_graph,
+                graph: merge_result.graph
+            }).some((other) => other.node_id === warning.node_id &&
+                other.block_id === warning.block_id))
+            : [];
+        const gate = this.store.built_content.queueGate(queue_entry.id);
+        const claim_changes = gate && merge_result.status === 'clean'
+            ? graphClaimChanges({
+                before_graph: coordinator_graph,
+                after_graph: merge_result.graph
+            })
+            : [];
+        const result = this.store.history.integrateNext({
+            actor_workspace_id: coordinator.id,
+            expected_head_commit_id: coordinator.head_sdlc_commit_id,
+            expected_queue_entry_id: queue_entry.id,
+            merge_base_commit_id,
+            merge_result,
+            resolution_attempts,
+            // A gate merge leaves its claims pending; a landing builds them.
+            in_transaction: (commit) => {
+                if (gate) {
+                    this.store.built_content.recordGateMerge({
+                        coordinator_workspace_id: coordinator.id,
+                        work_stream_workspace_id: child.id,
+                        gate,
+                        before_commit_id: coordinator.head_sdlc_commit_id,
+                        before_graph: coordinator_graph,
+                        gate_commit_id: commit.id,
+                        gate_graph: merge_result.status === 'clean'
+                            ? merge_result.graph
+                            : coordinator_graph,
+                        changes: claim_changes
+                    });
+                }
+                else {
+                    this.store.built_content.completeLanding({
+                        coordinator_workspace_id: coordinator.id,
+                        work_stream_workspace_id: child.id
+                    });
+                }
+            },
+            validation_evidence: [
+                'complete graph validation passed',
+                ...(resolution_attempts.length > 0
+                    ? ['bounded conflict resolution firewall passed']
+                    : []),
+                ...(embed_warnings.length > 0
+                    ? [
+                        `Document embeds left dangling by this integration: ${embed_warnings
+                            .map((w) => `${w.node_id}#${w.block_id} -> ${w.entity_kind} ${w.entity_id}`)
+                            .join(', ')}`
+                    ]
+                    : [])
+            ]
+        });
+        if (result.status === 'integrated' && embed_warnings.length > 0) {
+            result.document_embed_warnings = embed_warnings;
+        }
+        if (result.status === 'integrated') {
+            // A gate merge is not a landing: the Decision stays selected until the
+            // winner's code lands.
+            if (!gate) {
+                this.store.decisions.markLanded({
+                    workspace_id: child.id,
+                    landed_commit_id: result.commit.id
+                });
+            }
+            await this.materialize_projection({
+                projection_dir: workspaceProjectionDirectory(coordinator),
+                graph: merge_result.status === 'clean'
+                    ? merge_result.graph
+                    : coordinator_graph
+            });
+        }
+        return result;
+    }
+    async reconcileAttempt(coordinator_id, input) {
+        const coordinator = this.requireWorkspace(coordinator_id);
+        const source = this.requireWorkspace(input.source_workspace_id);
+        await this.assertProjectionClean(coordinator);
+        const last_observed_source_commit_id = this.store.history.lastReconciledSourceCommit(coordinator.id) ??
+            coordinator.fork_sdlc_commit_id;
+        if (!this.store.history.isAncestor(last_observed_source_commit_id, source.head_sdlc_commit_id)) {
+            throw new Error('Source workspace history diverged from the last observed source commit.');
+        }
+        if (this.store.history.isAncestor(source.head_sdlc_commit_id, coordinator.head_sdlc_commit_id)) {
+            return {
+                version: 1,
+                status: 'current',
+                source_commit_id: source.head_sdlc_commit_id,
+                child_commit_id: coordinator.head_sdlc_commit_id
+            };
+        }
+        const merge_base_commit_id = this.store.history.findMergeBase(coordinator.head_sdlc_commit_id, source.head_sdlc_commit_id);
+        const base_graph = await this.commits.readGraph(merge_base_commit_id);
+        const coordinator_graph = await this.commits.readGraph(coordinator.head_sdlc_commit_id);
+        const source_graph = await this.commits.readGraph(source.head_sdlc_commit_id);
+        const task_scope = this.store.getWorkspaceTaskScope(coordinator.id);
+        assertGraphChangesWithinTaskScope({
+            base_graph,
+            current_graph: coordinator_graph,
+            task_scope
+        });
+        const deterministic_merge_result = mergeLocalPortableGraphs({
+            base_graph,
+            coordinator_graph,
+            child_graph: source_graph
+        });
+        let merge_result = deterministic_merge_result;
+        let resolution_attempts = [];
+        if (deterministic_merge_result.status === 'blocked_conflict' &&
+            input.conflict_resolver) {
+            const resolution_result = await resolveLocalGraphConflicts({
+                base_graph,
+                coordinator_graph,
+                child_graph: source_graph,
+                merge_result: deterministic_merge_result,
+                task_scope,
+                scope_base_graph: source_graph,
+                resolver: input.conflict_resolver,
+                budget: input.resolution_budget,
+                allow_network_resolver: input.allow_network_resolver,
+                persist_candidate_graph: (graph) => this.graphs.writeGraph(graph)
+            });
+            resolution_attempts = resolution_result.attempts;
+            if (resolution_result.status !== 'blocked_conflict') {
+                merge_result = resolution_result.merge_result;
+            }
+        }
+        if (merge_result.status !== 'blocked_conflict') {
+            assertGraphChangesWithinTaskScope({
+                base_graph: source_graph,
+                current_graph: merge_result.graph,
+                task_scope
+            });
+            await this.graphs.writeGraph(merge_result.graph);
+        }
+        const result = this.store.history.reconcileSource({
+            actor_workspace_id: coordinator.id,
+            source_workspace_id: source.id,
+            expected_child_commit_id: coordinator.head_sdlc_commit_id,
+            expected_source_commit_id: source.head_sdlc_commit_id,
+            merge_base_commit_id,
+            merge_result,
+            resolution_attempts,
+            validation_evidence: resolution_attempts.length > 0
+                ? [
+                    'complete graph validation passed',
+                    'bounded conflict resolution firewall passed',
+                    'source-relative task scope passed'
+                ]
+                : [
+                    'complete graph validation passed',
+                    'source-relative task scope passed'
+                ]
+        });
+        if (result.status === 'reconciled') {
+            if (merge_result.status !== 'clean') {
+                throw new Error('Reconciled history result did not retain a clean graph candidate.');
+            }
+            await this.materialize_projection({
+                projection_dir: workspaceProjectionDirectory(coordinator),
+                graph: merge_result.graph
+            });
+        }
+        return result;
+    }
+    retryBudget(value, operation) {
+        const budget = value ?? 3;
+        if (!Number.isInteger(budget) || budget < 0 || budget > 16) {
+            throw new Error(`${operation} retry budget must be from 0 through 16.`);
+        }
+        return budget;
+    }
+    requireWorkspace(workspace_id) {
+        const workspace = this.store.getWorkspace(workspace_id);
+        if (!workspace)
+            throw new Error('Local workspace was not found.');
+        return workspace;
+    }
+    async assertProjectionClean(workspace) {
+        const { graph } = await composeGraphProjection(workspaceProjectionDirectory(workspace), undefined, { base: () => this.commits.readGraph(workspace.head_sdlc_commit_id) });
+        if (localGraphRootHash(graph) !==
+            this.commits.root(workspace.head_sdlc_commit_id)) {
+            throw new Error('Workspace projection has uncommitted changes; commit them before this operation.');
+        }
+    }
+}
+//# sourceMappingURL=workspace-integration-runtime.js.map

package/dist/local/workspace-integration-runtime.js.map

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

package/dist/local/workspace-lock.d.ts

@@ -0,0 +1,7 @@
+export declare function withWorkspaceOperationLock<T>(input: {
+    control_dir: string;
+    operation: string;
+    run: () => Promise<T>;
+    timeout_ms?: number;
+}): Promise<T>;
+//# sourceMappingURL=workspace-lock.d.ts.map

package/dist/local/workspace-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-lock.d.ts","sourceRoot":"","sources":["../../src/local/workspace-lock.ts"],"names":[],"mappings":"AAqKA,wBAAsB,0BAA0B,CAAC,CAAC,EAAE,KAAK,EAAE;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,CAAC,CAAC,CAgGb"}

package/dist/local/workspace-lock.js

@@ -0,0 +1,211 @@
+import { checkOperation, setOperationPhase, currentOperation, OperationError } from './operation.js';
+import { randomUUID } from 'node:crypto';
+import { link, mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+const LOCK_TOKEN_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+const CLAIM_FILE_PATTERN = new RegExp(`^\\.workspace-operation-(${LOCK_TOKEN_PATTERN.source.slice(1, -1)})\\.lock$`);
+const RECOVERY_FILE_PATTERN = new RegExp(`^\\.workspace-operation-recovery-(${LOCK_TOKEN_PATTERN.source.slice(1, -1)})\\.lock$`);
+function parseLockMetadata(value) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' ||
+        parsed === null ||
+        !('version' in parsed) ||
+        parsed.version !== 1 ||
+        !('token' in parsed) ||
+        typeof parsed.token !== 'string' ||
+        !('pid' in parsed) ||
+        typeof parsed.pid !== 'number' ||
+        !Number.isInteger(parsed.pid) ||
+        !('operation' in parsed) ||
+        typeof parsed.operation !== 'string' ||
+        !('created_at' in parsed) ||
+        typeof parsed.created_at !== 'string') {
+        return null;
+    }
+    return parsed;
+}
+function processIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        const code = typeof error === 'object' && error !== null && 'code' in error
+            ? error.code
+            : null;
+        return code !== 'ESRCH';
+    }
+}
+async function readLockMetadata(path) {
+    try {
+        return parseLockMetadata(await readFile(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+async function removeOwnedLock(lock_path, token) {
+    const metadata = await readLockMetadata(lock_path);
+    if (metadata?.token === token)
+        await rm(lock_path, { force: true });
+}
+async function recoveryIsActive(control_dir) {
+    const entries = await readdir(control_dir, { withFileTypes: true });
+    let active = false;
+    for (const entry of entries) {
+        if (!RECOVERY_FILE_PATTERN.test(entry.name))
+            continue;
+        if (!entry.isFile()) {
+            active = true;
+            continue;
+        }
+        const recovery_path = join(control_dir, entry.name);
+        const metadata = await readLockMetadata(recovery_path);
+        if (!metadata || processIsAlive(metadata.pid)) {
+            active = true;
+            continue;
+        }
+        await rm(recovery_path, { force: true });
+    }
+    return active;
+}
+async function removeDeadClaims(control_dir) {
+    const entries = await readdir(control_dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isFile() || !CLAIM_FILE_PATTERN.test(entry.name))
+            continue;
+        const claim_path = join(control_dir, entry.name);
+        const metadata = await readLockMetadata(claim_path);
+        if (metadata && !processIsAlive(metadata.pid)) {
+            await rm(claim_path, { force: true });
+        }
+    }
+}
+async function removeDeadLock(input) {
+    if (processIsAlive(input.observed.pid))
+        return false;
+    const recovery_token = randomUUID();
+    const recovery_path = join(input.control_dir, `.workspace-operation-recovery-${recovery_token}.lock`);
+    const recovery_metadata = {
+        version: 1,
+        token: recovery_token,
+        pid: process.pid,
+        operation: `recover:${input.operation}`,
+        created_at: new Date().toISOString()
+    };
+    await writeFile(recovery_path, JSON.stringify(recovery_metadata), {
+        encoding: 'utf8',
+        mode: 0o600,
+        flag: 'wx'
+    });
+    try {
+        const current = await readLockMetadata(input.lock_path);
+        if (!current ||
+            current.token !== input.observed.token ||
+            processIsAlive(current.pid)) {
+            return false;
+        }
+        await rm(input.lock_path, { force: true });
+        return true;
+    }
+    finally {
+        await rm(recovery_path, { force: true });
+    }
+}
+export async function withWorkspaceOperationLock(input) {
+    setOperationPhase('lock_wait');
+    const context = currentOperation();
+    const timeout_ms = input.timeout_ms ?? 5_000;
+    if (!Number.isInteger(timeout_ms) || timeout_ms < 0 || timeout_ms > 60_000) {
+        throw new Error('Workspace lock timeout must be from 0 through 60000 ms.');
+    }
+    await mkdir(input.control_dir, { recursive: true, mode: 0o700 });
+    const lock_path = join(input.control_dir, 'workspace-operation.lock');
+    const token = randomUUID();
+    const claim_path = join(input.control_dir, `.workspace-operation-${token}.lock`);
+    const metadata = {
+        version: 1,
+        token,
+        pid: process.pid,
+        operation: input.operation,
+        created_at: new Date().toISOString()
+    };
+    await writeFile(claim_path, JSON.stringify(metadata), {
+        encoding: 'utf8',
+        mode: 0o600,
+        flag: 'wx'
+    });
+    const started_at = Date.now();
+    try {
+        await removeDeadClaims(input.control_dir);
+        while (true) {
+            checkOperation();
+            if (await recoveryIsActive(input.control_dir)) {
+                if (Date.now() - started_at >= timeout_ms) {
+                    throw context
+                        ? new OperationError('lock_busy', context.operation)
+                        : new Error(`Workspace is busy with another operation: ${input.operation}`);
+                }
+                await delay(25, undefined, { signal: context?.signal });
+                continue;
+            }
+            try {
+                await link(claim_path, lock_path);
+                if (await recoveryIsActive(input.control_dir)) {
+                    await removeOwnedLock(lock_path, token);
+                    if (Date.now() - started_at >= timeout_ms) {
+                        throw context
+                            ? new OperationError('lock_busy', context.operation)
+                            : new Error(`Workspace is busy with another operation: ${input.operation}`);
+                    }
+                    await delay(25, undefined, { signal: context?.signal });
+                    continue;
+                }
+                break;
+            }
+            catch (error) {
+                const code = typeof error === 'object' && error !== null && 'code' in error
+                    ? error.code
+                    : null;
+                if (code !== 'EEXIST')
+                    throw error;
+                const observed = await readLockMetadata(lock_path);
+                if (observed &&
+                    (await removeDeadLock({
+                        control_dir: input.control_dir,
+                        lock_path,
+                        observed,
+                        operation: input.operation
+                    }))) {
+                    continue;
+                }
+                if (Date.now() - started_at >= timeout_ms) {
+                    throw context
+                        ? new OperationError('lock_busy', context.operation)
+                        : new Error(`Workspace is busy with another operation: ${input.operation}`);
+                }
+                await delay(25, undefined, { signal: context?.signal });
+            }
+        }
+        await rm(claim_path, { force: true });
+        setOperationPhase('local');
+        return await input.run();
+    }
+    finally {
+        await rm(claim_path, { force: true });
+        try {
+            await removeOwnedLock(lock_path, token);
+        }
+        catch {
+            // A missing lock is already released; a replacement lock is never removed.
+        }
+    }
+}
+//# sourceMappingURL=workspace-lock.js.map