@playcraft/cli 0.1.48-beta → 0.1.50-beta

package/dist/workspace-runtime/batch/deliver.js

@@ -1,26 +1,23 @@
-import { createHash, randomUUID } from 'node:crypto';
-import { lstat, mkdir, readFile, readdir, rm, writeFile } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { lstat, open } from 'node:fs/promises';
 import { join } from 'node:path';
-import { hashOperationPayload, sandboxBatchMemberDeliverSchema } from '@playcraft/common/cloud-workspace/runtime';
-import { findExternalLocalReferences } from '../previews/single-file.js';
+import { hashOperationPayload, sandboxBatchMemberDeliverSchema, } from '@playcraft/common/cloud-workspace/runtime';
 import { workspaceRoot } from '../workspaces/registry.js';
-import { requireBatchContentChanges } from './content-changes.js';
-import { gitRead, gitWrite } from './git.js';
 import { groupExited, runProcessGroup, stopProcessGroup } from './processes.js';
-import { filesystemObjectStore, memberStatus, readMember, readStopMarker, serializeRun, writeMember, } from './records.js';
+import { memberStatus, readMember, readStopMarker, serializeRun, writeMember, } from './records.js';
+/** Base build writes dist/index.html. Channel packaging stays on export playable (`--mode full`). */
 function buildCommand() {
-    return process.env.PLAYCRAFT_BATCH_BUILD_COMMAND
-        ?? 'playcraft build --mode full --platform playcraft --format html --output dist/index.html .';
+    return (process.env.PLAYCRAFT_BATCH_BUILD_COMMAND ?? 'CI=1 playcraft build --mode base --output dist .');
 }
-async function saveExact(root) {
-    await gitWrite(root, ['add', '-A', '.']);
-    const privatePaths = await gitRead(root, ['ls-files', '--', '.playcraft.json', 'playcraft.config.json', ':(glob)**/.playcraft.json', ':(glob)**/playcraft.config.json']);
-    if (privatePaths.trim())
-        throw new Error('batch_private_path');
-    const clean = await gitWrite(root, ['diff', '--cached', '--quiet']).then(() => true, () => false);
-    if (!clean)
-        await gitWrite(root, ['commit', '-m', 'Save batch member']);
-    return (await gitRead(root, ['rev-parse', 'HEAD'])).trim();
+async function readBuiltHtml(root) {
+    const htmlPath = join(root, 'dist', 'index.html');
+    const info = await lstat(htmlPath).catch(() => undefined);
+    if (!info?.isFile() || info.isSymbolicLink())
+        throw new Error('batch_build_failed');
+    const handle = await open(htmlPath, constants.O_RDONLY | constants.O_NOFOLLOW).catch(() => {
+        throw new Error('batch_build_failed');
+    });
+    await handle.close();
 }
 async function prove(record) {
     let stopped = true;
@@ -35,8 +32,11 @@ async function prove(record) {
     }
     return stopped;
 }
-export async function deliverBatchMember(state, body, options) {
-    if (!body || typeof body !== 'object' || !('occupancyId' in body) || !body.occupancyId)
+export async function deliverBatchMember(state, body) {
+    if (!body ||
+        typeof body !== 'object' ||
+        !('occupancyId' in body) ||
+        !body.occupancyId)
         throw new Error('occupancy_required');
     const parsed = sandboxBatchMemberDeliverSchema.safeParse(body);
     if (!parsed.success)
@@ -47,109 +47,127 @@ export async function deliverBatchMember(state, body, options) {
         const existing = await readMember(state, command.runId);
         if (existing && command.ownerFence < existing.ownerFence)
             throw new Error('stale_owner');
-        if (existing?.state === 'completed' && existing.phase === 'deliver' && existing.evidence && existing.commandHash?.deliver === hash && existing.ownerFence === command.ownerFence) {
+        if (existing?.state === 'completed' &&
+            existing.phase === 'deliver' &&
+            existing.evidence &&
+            existing.commandHash?.deliver === hash &&
+            existing.ownerFence === command.ownerFence) {
             return memberStatus(existing);
         }
-        if (await readStopMarker(state, command.runId) && existing?.state === 'completed' && existing.evidence)
+        if ((await readStopMarker(state, command.runId)) &&
+            existing?.state === 'completed' &&
+            existing.evidence)
             return memberStatus(existing);
         if (await readStopMarker(state, command.runId))
             return memberStatus(await markStopped(state, command, existing));
-        if (existing && existing.ownerFence === command.ownerFence && existing.commandHash?.deliver && existing.commandHash.deliver !== hash && existing.state === 'completed') {
+        if (existing &&
+            existing.ownerFence === command.ownerFence &&
+            existing.commandHash?.deliver &&
+            existing.commandHash.deliver !== hash &&
+            existing.state === 'completed') {
             throw new Error('batch_command_conflict');
         }
         const root = await workspaceRoot(state, command.workspaceId, command.directoryName);
         let record = await writeMember(state, {
-            runId: command.runId, ownerFence: command.ownerFence, occupancyId: command.occupancyId, workspaceId: command.workspaceId,
-            directoryName: command.directoryName, phase: 'deliver', state: 'running', writersStopped: false, holding: true, stopRequested: false,
-            processes: existing?.processes ?? [], sessionId: existing?.sessionId, operationId: existing?.operationId, commandHash: { ...existing?.commandHash, deliver: hash },
-            snapshotDigest: existing?.snapshotDigest, branchName: existing?.branchName, updatedAt: new Date().toISOString(),
-            sourceCommit: existing?.sourceCommit ?? state.journal.getWorkspace(command.workspaceId)?.directories?.find(directory => directory.directoryName === command.directoryName)?.sourceCommit,
+            runId: command.runId,
+            ownerFence: command.ownerFence,
+            occupancyId: command.occupancyId,
+            workspaceId: command.workspaceId,
+            directoryName: command.directoryName,
+            phase: 'deliver',
+            state: 'running',
+            writersStopped: false,
+            holding: true,
+            stopRequested: false,
+            processes: existing?.processes ?? [],
+            sessionId: existing?.sessionId,
+            operationId: existing?.operationId,
+            commandHash: { ...existing?.commandHash, deliver: hash },
+            snapshotDigest: existing?.snapshotDigest,
+            branchName: existing?.branchName,
+            updatedAt: new Date().toISOString(),
+            sourceCommit: existing?.sourceCommit ??
+                state.journal
+                    .getWorkspace(command.workspaceId)
+                    ?.directories?.find((directory) => directory.directoryName === command.directoryName)
+                    ?.sourceCommit,
             beforeTree: existing?.beforeTree,
         });
-        const buildRoot = join(state.config.stateDir, 'batch-builds', `${command.runId}-${randomUUID()}`);
         try {
-            const savedCommit = command.fromCommit ?? await saveExact(root);
-            if (command.fromCommit)
-                await gitRead(root, ['cat-file', '-e', `${command.fromCommit}^{commit}`]);
-            await requireBatchContentChanges(root, record.sourceCommit ?? '', savedCommit);
             if (await readStopMarker(state, command.runId))
                 return memberStatus(await markStopped(state, command, record));
-            let pushedCommit;
-            if (command.pushRemote) {
-                const branch = existing?.branchName ?? (await gitRead(root, ['symbolic-ref', '--short', 'HEAD'])).trim();
-                try {
-                    await gitWrite(root, ['push', '--porcelain', 'origin', `${savedCommit}:refs/heads/${branch}`]);
-                }
-                catch {
-                    throw new Error('batch_push_failed');
-                }
-                const remote = (await gitWrite(root, ['ls-remote', 'origin', `refs/heads/${branch}`])).slice(0, savedCommit.length);
-                if (remote !== savedCommit)
-                    throw new Error('batch_push_failed');
-                pushedCommit = savedCommit;
-            }
-            await mkdir(join(buildRoot, '..'), { recursive: true });
-            await gitWrite(join(buildRoot, '..'), ['clone', '--local', '--no-hardlinks', '--no-checkout', '--', root, buildRoot]);
-            await gitWrite(buildRoot, ['checkout', '--detach', savedCommit]);
-            const built = await runProcessGroup(buildRoot, buildCommand(), 'build', async (process) => {
+            const built = await runProcessGroup(root, buildCommand(), 'build', async (process) => {
                 record = await writeMember(state, { ...record, processes: [...record.processes, process] });
             });
-            record = await writeMember(state, { ...record, processes: record.processes.map(process => process.pid === built.process.pid ? built.process : process) });
+            record = await writeMember(state, {
+                ...record,
+                processes: record.processes.map((process) => process.pid === built.process.pid ? built.process : process),
+            });
             if (await readStopMarker(state, command.runId))
                 return memberStatus(await markStopped(state, command, record));
             if (built.code !== 0)
                 throw new Error('batch_build_failed');
-            const htmlPath = join(buildRoot, 'dist', 'index.html');
-            if (!(await lstat(htmlPath).catch(() => undefined))?.isFile())
-                throw new Error('batch_build_failed');
-            const entries = await readdir(join(buildRoot, 'dist'));
-            if (!entries.includes('index.html'))
-                throw new Error('batch_build_failed');
-            const bodyBytes = await readFile(htmlPath);
-            if (findExternalLocalReferences(bodyBytes.toString()).length)
-                throw new Error('batch_verify_failed');
-            const buildDigest = createHash('sha256').update(bodyBytes).digest('hex');
-            const previewRef = `workspaces/${command.workspaceId}/batches/members/${command.runId}/${buildDigest}.html`;
-            const store = options?.objectStore ?? filesystemObjectStore(state);
-            await store.put(previewRef, bodyBytes);
-            const published = await store.get(previewRef);
-            if (createHash('sha256').update(published).digest('hex') !== buildDigest)
-                throw new Error('batch_verify_failed');
-            await mkdir(join(root, 'dist'), { recursive: true });
-            await writeFile(join(root, 'dist', 'index.html'), published);
-            if (createHash('sha256').update(await readFile(join(root, 'dist', 'index.html'))).digest('hex') !== buildDigest)
-                throw new Error('batch_verify_failed');
+            await readBuiltHtml(root);
             const writersStopped = await prove(record);
             if (!writersStopped)
-                return memberStatus(await writeMember(state, { ...record, state: 'stopping', writersStopped: false, holding: true, headCommit: savedCommit }));
+                return memberStatus(await writeMember(state, {
+                    ...record,
+                    state: 'stopping',
+                    writersStopped: false,
+                    holding: true,
+                }));
             if (await readStopMarker(state, command.runId))
-                return memberStatus(await markStopped(state, command, { ...record, headCommit: savedCommit }));
+                return memberStatus(await markStopped(state, command, record));
             record = await writeMember(state, {
-                ...record, state: 'completed', writersStopped: true, holding: false, headCommit: savedCommit, error: undefined,
-                evidence: { savedCommit, ...(pushedCommit ? { pushedCommit } : {}), buildDigest, verified: true, previewRef },
+                ...record,
+                state: 'completed',
+                writersStopped: true,
+                holding: false,
+                error: undefined,
+                evidence: { verified: true },
             });
             return memberStatus(record);
         }
         catch (error) {
-            const code = error instanceof Error && /^[a-z0-9_]+$/.test(error.message) ? error.message : 'batch_deliver_failed';
+            const code = error instanceof Error && /^[a-z0-9_]+$/.test(error.message)
+                ? error.message
+                : 'batch_deliver_failed';
             const writersStopped = await prove(record);
-            record = await writeMember(state, { ...record, state: writersStopped ? 'failed' : 'stopping', writersStopped, holding: !writersStopped, error: code });
+            record = await writeMember(state, {
+                ...record,
+                state: writersStopped ? 'failed' : 'stopping',
+                writersStopped,
+                holding: !writersStopped,
+                error: code,
+            });
             return memberStatus(record);
         }
-        finally {
-            await rm(buildRoot, { recursive: true, force: true });
-        }
     });
 }
 async function markStopped(state, command, existing) {
     if (existing)
         await prove(existing);
     return writeMember(state, {
-        runId: command.runId, ownerFence: command.ownerFence, occupancyId: existing?.occupancyId ?? command.occupancyId,
-        workspaceId: command.workspaceId, directoryName: command.directoryName, phase: 'deliver', state: 'stopped', writersStopped: true,
-        holding: false, stopRequested: true, processes: existing?.processes ?? [], sessionId: existing?.sessionId, operationId: existing?.operationId,
-        headCommit: existing?.headCommit, evidence: existing?.evidence, commandHash: existing?.commandHash, snapshotDigest: existing?.snapshotDigest,
-        branchName: existing?.branchName, updatedAt: new Date().toISOString(),
-        sourceCommit: existing?.sourceCommit, beforeTree: existing?.beforeTree,
+        runId: command.runId,
+        ownerFence: command.ownerFence,
+        occupancyId: existing?.occupancyId ?? command.occupancyId,
+        workspaceId: command.workspaceId,
+        directoryName: command.directoryName,
+        phase: 'deliver',
+        state: 'stopped',
+        writersStopped: true,
+        holding: false,
+        stopRequested: true,
+        processes: existing?.processes ?? [],
+        sessionId: existing?.sessionId,
+        operationId: existing?.operationId,
+        headCommit: existing?.headCommit,
+        evidence: existing?.evidence,
+        commandHash: existing?.commandHash,
+        snapshotDigest: existing?.snapshotDigest,
+        branchName: existing?.branchName,
+        updatedAt: new Date().toISOString(),
+        sourceCommit: existing?.sourceCommit,
+        beforeTree: existing?.beforeTree,
     });
 }

package/dist/workspace-runtime/batch/prepare.js

@@ -6,14 +6,21 @@ import { sandboxBatchMemberPrepareSchema, } from '@playcraft/common/cloud-worksp
 import { registerWorkspaceDirectory } from '../workspaces/directories.js';
 import { workspaceContainerRoot } from '../workspaces/registry.js';
 import { copyCredentialHelpers, gitRead, gitWrite } from './git.js';
-import { digestFiles, readSourceFiles, restoreArchive } from './source-capture.js';
+import { restoreArchive } from './source-capture.js';
 import { groupExited, runProcessGroup } from './processes.js';
 import { filesystemObjectStore, memberStatus, readMember, readSnapshot, readStopMarker, serializeRun, sourceCacheDir, writeMember, } from './records.js';
 const BRANCH = /^remix\/draft-[a-f0-9]{16}$/;
-const LOCKS = ['pnpm-lock.yaml', 'package-lock.json', 'npm-shrinkwrap.json', 'yarn.lock', 'bun.lock', 'bun.lockb'];
+const LOCKS = [
+    'pnpm-lock.yaml',
+    'package-lock.json',
+    'npm-shrinkwrap.json',
+    'yarn.lock',
+    'bun.lock',
+    'bun.lockb',
+];
 export function frozenInstallCommand() {
-    return process.env.PLAYCRAFT_BATCH_INSTALL_COMMAND
-        ?? 'pnpm install --frozen-lockfile --store-dir /var/cache/playcraft/pnpm-store --ignore-scripts';
+    return (process.env.PLAYCRAFT_BATCH_INSTALL_COMMAND ??
+        'pnpm install --frozen-lockfile --store-dir /var/cache/playcraft/pnpm-store --ignore-scripts');
 }
 function hashCommand(value) {
     return createHash('sha256').update(JSON.stringify(value)).digest('hex');
@@ -21,10 +28,17 @@ function hashCommand(value) {
 async function materialize(state, snapshot, destination, store, sourceRoot) {
     const cache = sourceCacheDir(state, snapshot.batchId);
     const cachedDigest = await readFile(`${cache}.digest`, 'utf8').catch(() => '');
-    if (cachedDigest.trim() === snapshot.digest && await lstat(join(cache, '.git')).catch(() => undefined)) {
-        await gitWrite(dirnameOf(destination), ['clone', '--local', '--no-hardlinks', '--', cache, destination]);
-        if (digestFiles(await readSourceFiles(destination)) !== snapshot.digest)
-            throw new Error('batch_snapshot_mismatch');
+    if (cachedDigest.trim() === snapshot.digest &&
+        (await lstat(join(cache, '.git')).catch(() => undefined))) {
+        await gitWrite(dirnameOf(destination), [
+            'clone',
+            '--local',
+            '--no-hardlinks',
+            '--',
+            cache,
+            destination,
+        ]);
+        await assertFrozenCommit(destination, snapshot.commitHash);
         return;
     }
     if (snapshot.remoteRef) {
@@ -41,34 +55,64 @@ async function materialize(state, snapshot, destination, store, sourceRoot) {
             throw new Error('batch_snapshot_mismatch');
         }
         await gitWrite(destination, ['checkout', '--detach', 'FETCH_HEAD']);
-        if ((await gitRead(destination, ['rev-parse', 'HEAD'])).trim() !== snapshot.commitHash)
-            throw new Error('batch_snapshot_mismatch');
-        if (digestFiles(await readSourceFiles(destination)) !== snapshot.digest)
-            throw new Error('batch_snapshot_mismatch');
+        await assertFrozenCommit(destination, snapshot.commitHash);
         return;
     }
     if (!snapshot.artifactKey)
         throw new Error('batch_snapshot_mismatch');
-    const body = await store.get(snapshot.artifactKey).catch(() => { throw new Error('batch_snapshot_mismatch'); });
+    const body = await store.get(snapshot.artifactKey).catch(() => {
+        throw new Error('batch_snapshot_mismatch');
+    });
     await restoreArchive(body, destination, snapshot.digest);
 }
 function dirnameOf(path) {
     return join(path, '..');
 }
+async function assertFrozenCommit(root, commit) {
+    if ((await gitRead(root, ['rev-parse', 'HEAD'])).trim() !== commit)
+        throw new Error('batch_snapshot_mismatch');
+}
+/** A bound workspace keeps origin aligned. A local workspace only needs the branch. */
 async function checkoutBranch(root, branchName, commit, repositoryUrl) {
     await gitWrite(root, ['checkout', '-B', branchName, commit]);
-    const origin = await gitRead(root, ['remote', 'get-url', 'origin']).catch(() => '');
-    if (!origin.trim())
-        await gitWrite(root, ['remote', 'add', 'origin', repositoryUrl]);
-    else if (origin.trim() !== repositoryUrl)
-        await gitWrite(root, ['remote', 'set-url', 'origin', repositoryUrl]);
+    if (repositoryUrl) {
+        const origin = await gitRead(root, ['remote', 'get-url', 'origin']).catch(() => '');
+        if (!origin.trim())
+            await gitWrite(root, ['remote', 'add', 'origin', repositoryUrl]);
+        else if (origin.trim() !== repositoryUrl)
+            await gitWrite(root, ['remote', 'set-url', 'origin', repositoryUrl]);
+    }
+    else {
+        await gitWrite(root, ['remote', 'remove', 'origin']).catch(() => undefined);
+    }
     await gitWrite(root, ['config', 'user.name', 'PlayCraft']);
     await gitWrite(root, ['config', 'user.email', 'playcraft@localhost']);
 }
 async function resumeBranch(repositoryUrl, branchName, commit, destination, sourceRoot) {
-    await gitWrite(dirnameOf(destination), ['clone', '--branch', branchName, '--single-branch', '--', repositoryUrl, destination]);
-    await copyCredentialHelpers(sourceRoot, destination);
-    if ((await gitRead(destination, ['rev-parse', 'HEAD'])).trim() !== commit && !(await gitRead(destination, ['cat-file', '-e', `${commit}^{commit}`]).then(() => true, () => false))) {
+    if (repositoryUrl) {
+        await gitWrite(dirnameOf(destination), [
+            'clone',
+            '--branch',
+            branchName,
+            '--single-branch',
+            '--',
+            repositoryUrl,
+            destination,
+        ]);
+        await copyCredentialHelpers(sourceRoot, destination);
+    }
+    else {
+        await gitWrite(dirnameOf(destination), [
+            'clone',
+            '--local',
+            '--no-hardlinks',
+            '--',
+            sourceRoot,
+            destination,
+        ]);
+    }
+    if ((await gitRead(destination, ['rev-parse', 'HEAD'])).trim() !== commit &&
+        !(await gitRead(destination, ['cat-file', '-e', `${commit}^{commit}`]).then(() => true, () => false))) {
         throw new Error('batch_commit_mismatch');
     }
     await gitWrite(destination, ['checkout', '-B', branchName, commit]);
@@ -102,17 +146,25 @@ export async function assertMemberDependencies(root) {
     if (present[0] !== 'pnpm-lock.yaml')
         throw new Error('dependency_lock_mismatch');
     const lock = await readFile(join(root, 'pnpm-lock.yaml'), 'utf8');
-    if (names.some(name => !lock.includes(`${name}:`) && !lock.includes(`/${name}@`) && !lock.includes(`'${name}'`) && !lock.includes(`"${name}"`))) {
+    if (names.some((name) => !lock.includes(`${name}:`) &&
+        !lock.includes(`/${name}@`) &&
+        !lock.includes(`'${name}'`) &&
+        !lock.includes(`"${name}"`))) {
         throw new Error('dependency_lock_mismatch');
     }
     return 'install';
 }
 export async function prepareBatchMember(state, body, options) {
-    if (!body || typeof body !== 'object' || !('occupancyId' in body) || !body.occupancyId)
+    if (!body ||
+        typeof body !== 'object' ||
+        !('occupancyId' in body) ||
+        !body.occupancyId)
         throw new Error('occupancy_required');
     const parsed = sandboxBatchMemberPrepareSchema.safeParse(body);
     if (!parsed.success)
-        throw new Error(parsed.error.issues.some(issue => issue.path.includes('branchName')) ? 'batch_branch_invalid' : 'invalid_batch_request');
+        throw new Error(parsed.error.issues.some((issue) => issue.path.includes('branchName'))
+            ? 'batch_branch_invalid'
+            : 'invalid_batch_request');
     const command = parsed.data;
     if (!BRANCH.test(command.branchName))
         throw new Error('batch_branch_invalid');
@@ -124,81 +176,142 @@ export async function prepareBatchMember(state, body, options) {
             throw new Error('stale_owner');
         if (marker)
             return memberStatus(await sealStopped(state, command, existing));
-        if (existing && existing.ownerFence === command.ownerFence && existing.commandHash?.prepare === hash && existing.state !== 'running' && existing.state !== 'failed') {
+        if (existing &&
+            existing.ownerFence === command.ownerFence &&
+            existing.commandHash?.prepare === hash &&
+            existing.state !== 'running' &&
+            existing.state !== 'failed') {
             return memberStatus(existing);
         }
-        if (existing && existing.ownerFence === command.ownerFence && existing.commandHash?.prepare && existing.commandHash.prepare !== hash)
+        if (existing &&
+            existing.ownerFence === command.ownerFence &&
+            existing.commandHash?.prepare &&
+            existing.commandHash.prepare !== hash)
             throw new Error('batch_command_conflict');
-        if (existing?.processes.some(process => process.role === 'install' && !process.stopped && !groupExited(process.pid)))
+        if (existing?.processes.some((process) => process.role === 'install' && !process.stopped && !groupExited(process.pid)))
             return memberStatus(existing);
         const snapshot = command.snapshot;
         if ((await readSnapshot(state, snapshot.batchId))?.digest === snapshot.digest) {
             /* The local snapshot record is an accelerator; the command snapshot remains authoritative. */
         }
         let record = await writeMember(state, {
-            runId: command.runId, ownerFence: command.ownerFence, occupancyId: command.occupancyId,
-            workspaceId: command.workspaceId, directoryName: command.directoryName, phase: 'prepare', state: 'running',
-            writersStopped: false, holding: true, stopRequested: false, processes: existing?.processes ?? [],
-            commandHash: { ...existing?.commandHash, prepare: hash }, snapshotDigest: snapshot.digest, branchName: command.branchName,
-            sourceCommit: snapshot.commitHash, beforeTree: existing?.beforeTree,
+            runId: command.runId,
+            ownerFence: command.ownerFence,
+            occupancyId: command.occupancyId,
+            workspaceId: command.workspaceId,
+            directoryName: command.directoryName,
+            phase: 'prepare',
+            state: 'running',
+            writersStopped: false,
+            holding: true,
+            stopRequested: false,
+            processes: existing?.processes ?? [],
+            commandHash: { ...existing?.commandHash, prepare: hash },
+            snapshotDigest: snapshot.digest,
+            branchName: command.branchName,
+            sourceCommit: snapshot.commitHash,
+            beforeTree: existing?.beforeTree,
             updatedAt: new Date().toISOString(),
         });
-        const parent = await workspaceContainerRoot(state, command.workspaceId);
-        const root = join(parent, command.directoryName);
-        const staging = join(parent, `.batch-member-${randomUUID()}`);
-        const binding = state.journal.getWorkspace(command.workspaceId);
-        if (!binding?.repositoryUrl)
-            throw new Error('workspace_not_registered');
-        const sourceRoot = join(parent, snapshot.sourceDirectoryName);
+        let staging;
         try {
-            if (!await lstat(root).catch(() => undefined)) {
+            const parent = await workspaceContainerRoot(state, command.workspaceId);
+            const root = join(parent, command.directoryName);
+            staging = join(parent, `.batch-member-${randomUUID()}`);
+            const binding = state.journal.getWorkspace(command.workspaceId);
+            if (!binding)
+                throw new Error('workspace_not_registered');
+            const repositoryUrl = binding.repositoryUrl ?? undefined;
+            const sourceRoot = join(parent, snapshot.sourceDirectoryName);
+            if (!(await lstat(root).catch(() => undefined))) {
                 await mkdir(parent, { recursive: true });
                 if (command.resumeFromCommit)
-                    await resumeBranch(binding.repositoryUrl, command.branchName, command.resumeFromCommit, staging, sourceRoot);
+                    await resumeBranch(repositoryUrl, command.branchName, command.resumeFromCommit, staging, sourceRoot);
                 else
                     await materialize(state, snapshot, staging, options?.objectStore ?? filesystemObjectStore(state), sourceRoot);
                 const commit = command.resumeFromCommit ?? snapshot.commitHash;
-                await checkoutBranch(staging, command.branchName, commit, binding.repositoryUrl);
+                await checkoutBranch(staging, command.branchName, commit, repositoryUrl);
                 const { rename } = await import('node:fs/promises');
                 await rename(staging, root);
             }
             await registerWorkspaceDirectory(state, {
-                workspaceId: command.workspaceId, directoryName: command.directoryName, remixId: command.remixId,
-                branchName: command.branchName, sourceCommit: command.resumeFromCommit ?? snapshot.commitHash,
+                workspaceId: command.workspaceId,
+                directoryName: command.directoryName,
+                remixId: command.remixId,
+                branchName: command.branchName,
+                sourceCommit: command.resumeFromCommit ?? snapshot.commitHash,
             }, state.acceptedLeaseFence);
             const plan = await assertMemberDependencies(root);
             if (plan === 'install') {
                 const installed = await runProcessGroup(root, frozenInstallCommand(), 'install', async (process) => {
-                    record = await writeMember(state, { ...record, processes: [...record.processes, process] });
+                    record = await writeMember(state, {
+                        ...record,
+                        processes: [...record.processes, process],
+                    });
+                });
+                record = await writeMember(state, {
+                    ...record,
+                    processes: record.processes.map((process) => process.pid === installed.process.pid
+                        ? { ...installed.process, role: 'install' }
+                        : process),
                 });
-                record = await writeMember(state, { ...record, processes: record.processes.map(process => process.pid === installed.process.pid ? { ...installed.process, role: 'install' } : process) });
                 if (await readStopMarker(state, command.runId))
                     return memberStatus(await sealStopped(state, command, record));
                 if (installed.code !== 0)
                     throw new Error('batch_install_failed');
             }
             const head = (await gitRead(root, ['rev-parse', 'HEAD'])).trim();
-            record = await writeMember(state, { ...record, state: 'completed', writersStopped: true, holding: true, headCommit: head, error: undefined });
+            record = await writeMember(state, {
+                ...record,
+                state: 'completed',
+                writersStopped: true,
+                holding: true,
+                headCommit: head,
+                error: undefined,
+            });
             return memberStatus(record);
         }
         catch (error) {
-            const code = error instanceof Error && /^[a-z0-9_]+$/.test(error.message) ? error.message : 'batch_prepare_failed';
-            record = await writeMember(state, { ...record, state: 'failed', writersStopped: true, holding: false, error: code });
+            const code = error instanceof Error && /^[a-z0-9_]+$/.test(error.message)
+                ? error.message
+                : 'batch_prepare_failed';
+            record = await writeMember(state, {
+                ...record,
+                state: 'failed',
+                writersStopped: true,
+                holding: false,
+                error: code,
+            });
             return memberStatus(record);
         }
         finally {
-            await rm(staging, { recursive: true, force: true });
+            if (staging)
+                await rm(staging, { recursive: true, force: true });
         }
     });
 }
 async function sealStopped(state, command, existing) {
     return writeMember(state, {
-        runId: command.runId, ownerFence: Math.max(command.ownerFence, existing?.ownerFence ?? 0), occupancyId: command.occupancyId,
-        workspaceId: command.workspaceId, directoryName: command.directoryName, phase: existing?.phase ?? 'prepare',
-        state: 'stopped', writersStopped: true, holding: false, stopRequested: true, processes: existing?.processes ?? [],
-        sessionId: existing?.sessionId, operationId: existing?.operationId, headCommit: existing?.headCommit, evidence: existing?.evidence,
-        commandHash: existing?.commandHash, snapshotDigest: existing?.snapshotDigest, branchName: existing?.branchName,
-        sourceCommit: existing?.sourceCommit, beforeTree: existing?.beforeTree,
+        runId: command.runId,
+        ownerFence: Math.max(command.ownerFence, existing?.ownerFence ?? 0),
+        occupancyId: command.occupancyId,
+        workspaceId: command.workspaceId,
+        directoryName: command.directoryName,
+        phase: existing?.phase ?? 'prepare',
+        state: 'stopped',
+        writersStopped: true,
+        holding: false,
+        stopRequested: true,
+        processes: existing?.processes ?? [],
+        sessionId: existing?.sessionId,
+        operationId: existing?.operationId,
+        headCommit: existing?.headCommit,
+        evidence: existing?.evidence,
+        commandHash: existing?.commandHash,
+        snapshotDigest: existing?.snapshotDigest,
+        branchName: existing?.branchName,
+        sourceCommit: existing?.sourceCommit,
+        beforeTree: existing?.beforeTree,
         updatedAt: new Date().toISOString(),
     });
 }