@paraharness/git 0.0.0-stage → 0.2.0

package/dist/executors/git-executors.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-executors.constants.d.ts","sourceRoot":"","sources":["../../src/executors/git-executors.constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAGtE,qFAAqF;AACrF,eAAO,MAAM,YAAY,EAAE,4BAAmD,CAAC"}

package/dist/executors/git-executors.constants.js

@@ -0,0 +1,4 @@
+import { createGitExecutors } from './create-git-executors.js';
+/** Default frozen `RuntimeExecutorRegistrySlice` instance for `@paraharness/git`. */
+export const gitExecutors = createGitExecutors();
+//# sourceMappingURL=git-executors.constants.js.map

package/dist/executors/git-executors.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-executors.constants.js","sourceRoot":"","sources":["../../src/executors/git-executors.constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,qFAAqF;AACrF,MAAM,CAAC,MAAM,YAAY,GAAiC,kBAAkB,EAAE,CAAC"}

package/dist/executors/git-hooks-and-checks.d.ts

@@ -0,0 +1,51 @@
+import type { AbortHookExecutionInput, CheckEvaluationResult, GitAbortMeta, GitCleanWorkingTreeNode, GitDiscardBranchNode, GitKeepWorktreeNode, GitSnapshotAndResetNode, GitWorktreeHandle, RewindHookExecutionInput, StepExecutionContext } from '@paraharness/core';
+/**
+ * Evaluates a `GitCleanWorkingTreeNode` (`git:clean-working-tree`) conflict-clean check on `ctx.scopeHandle`.
+ *
+ * Prunes resolved entries in `unresolvedConflictPaths` and rejects if any unresolved paths or paired conflict markers remain.
+ *
+ * @param {GitCleanWorkingTreeNode}                 _node  - Passive clean-working-tree check AST node.
+ * @param {void}                                    _input - Unused check input.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx    - Active step execution context.
+ *
+ * @returns {Promise<CheckEvaluationResult>} Check evaluation result listing any remaining conflicted paths.
+ */
+export declare function executeGitCleanWorkingTreeCheck(_node: GitCleanWorkingTreeNode, _input: void, ctx: StepExecutionContext<GitWorktreeHandle>): Promise<CheckEvaluationResult>;
+/**
+ * Executes a `GitSnapshotAndResetNode` (`git.snapshotAndReset()`) abort hook on `input.handle`.
+ *
+ * Idempotently snapshots dirty state over `baseRef` to `refs/harness/aborted/<runId>/<stepExecId>`,
+ * resets the worktree to `baseRef`, and clears `unresolvedConflictPaths`.
+ *
+ * @param {GitSnapshotAndResetNode}                    _node - Passive snapshot-and-reset abort hook AST node.
+ * @param {AbortHookExecutionInput<GitWorktreeHandle>} input - Abort hook execution input with handle and run/step IDs.
+ * @param {StepExecutionContext<GitWorktreeHandle>}    ctx   - Active step execution context.
+ *
+ * @returns {Promise<GitAbortMeta>} Validated `{ abortedSnapshotRef, resetToRef }` abort metadata receipt.
+ */
+export declare function executeGitSnapshotAndResetHook(_node: GitSnapshotAndResetNode, input: AbortHookExecutionInput<GitWorktreeHandle>, ctx: StepExecutionContext<GitWorktreeHandle>): Promise<GitAbortMeta>;
+/**
+ * Executes a `GitKeepWorktreeNode` (`git.keepWorktree()`) rewind hook on `input.handle`.
+ *
+ * Preserves the current working tree, `HEAD`, and `baseRef` in-place across `.rewindTo()` transitions.
+ *
+ * @param {GitKeepWorktreeNode}                         _node  - Passive keep-worktree rewind hook AST node.
+ * @param {RewindHookExecutionInput<GitWorktreeHandle>} _input - Rewind hook execution input.
+ * @param {StepExecutionContext<GitWorktreeHandle>}     _ctx   - Active step execution context.
+ *
+ * @returns {Promise<void>} Resolves immediately without mutating the worktree.
+ */
+export declare function executeGitKeepWorktreeHook(_node: GitKeepWorktreeNode, _input: RewindHookExecutionInput<GitWorktreeHandle>, _ctx: StepExecutionContext<GitWorktreeHandle>): Promise<void>;
+/**
+ * Executes a `GitDiscardBranchNode` (`git.resetWorktree()` / `git.discardBranch()`) rewind hook on `input.handle`.
+ *
+ * Restores `input.handle` to `input.targetStepBaseScopeCheckpoint` (or resets to `handle.baseRef` if absent).
+ *
+ * @param {GitDiscardBranchNode}                        _node - Passive discard-branch rewind hook AST node.
+ * @param {RewindHookExecutionInput<GitWorktreeHandle>} input - Rewind hook execution input.
+ * @param {StepExecutionContext<GitWorktreeHandle>}     ctx   - Active step execution context.
+ *
+ * @returns {Promise<void>} Resolves once the worktree is restored to the target step's base checkpoint.
+ */
+export declare function executeGitDiscardBranchHook(_node: GitDiscardBranchNode, input: RewindHookExecutionInput<GitWorktreeHandle>, ctx: StepExecutionContext<GitWorktreeHandle>): Promise<void>;
+//# sourceMappingURL=git-hooks-and-checks.d.ts.map

package/dist/executors/git-hooks-and-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-hooks-and-checks.d.ts","sourceRoot":"","sources":["../../src/executors/git-hooks-and-checks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AA0C3B;;;;;;;;;;GAUG;AACH,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,uBAAuB,EAC9B,MAAM,EAAE,IAAI,EACZ,GAAG,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAC3C,OAAO,CAAC,qBAAqB,CAAC,CA2BhC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,uBAAuB,EAC9B,KAAK,EAAE,uBAAuB,CAAC,iBAAiB,CAAC,EACjD,GAAG,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAC3C,OAAO,CAAC,YAAY,CAAC,CAgCvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,EACnD,IAAI,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,EAClD,GAAG,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/executors/git-hooks-and-checks.js

@@ -0,0 +1,139 @@
+import { gitCheckpointRestore } from './internal/git-checkpoint-restore.js';
+import { readHarnessMeta, runGitCommand, updateWorktreeHandleInPlace, writeHarnessMeta, } from './internal/git-cli-runner.js';
+import { gitWorktreePruneResolvedConflicts } from './internal/git-worktree-flush-and-prune.js';
+import { synthesizeWorkingTreeCommitOverBase } from './internal/git-worktree-materialize-merge.js';
+import { resolveEffectiveCheckpointPolicy } from './internal/git-worktree-reattach.js';
+import { findWorktreeConflictMarkerPaths } from './internal/parent-fast-forward.js';
+/**
+ * Hard-resets `handle` to `handle.baseRef`, cleans untracked files (preserving `node_modules`),
+ * and clears `unresolvedConflictPaths` in `harness-meta.json` and `handle`.
+ *
+ * @param {GitWorktreeHandle} handle - Worktree handle to reset.
+ *
+ * @returns {Promise<void>} Resolves once the worktree and conflict metadata are reset.
+ */
+async function resetWorktreeToBaseRefAndClearConflicts(handle) {
+    const cwd = handle.worktreePath;
+    await runGitCommand({ cwd, args: ['reset', '--hard', handle.baseRef] });
+    await runGitCommand({
+        cwd,
+        args: ['clean', '-fd', '-e', 'node_modules', '-e', '**/node_modules'],
+    });
+    const meta = await readHarnessMeta(handle.gitDirPath);
+    const emptyConflicts = Object.freeze({});
+    await writeHarnessMeta(handle.gitDirPath, {
+        ...meta,
+        unresolvedConflictPaths: emptyConflicts,
+    });
+    updateWorktreeHandleInPlace(handle, {
+        headRef: handle.baseRef,
+        unresolvedConflictPaths: emptyConflicts,
+    });
+}
+/**
+ * Evaluates a `GitCleanWorkingTreeNode` (`git:clean-working-tree`) conflict-clean check on `ctx.scopeHandle`.
+ *
+ * Prunes resolved entries in `unresolvedConflictPaths` and rejects if any unresolved paths or paired conflict markers remain.
+ *
+ * @param {GitCleanWorkingTreeNode}                 _node  - Passive clean-working-tree check AST node.
+ * @param {void}                                    _input - Unused check input.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx    - Active step execution context.
+ *
+ * @returns {Promise<CheckEvaluationResult>} Check evaluation result listing any remaining conflicted paths.
+ */
+export async function executeGitCleanWorkingTreeCheck(_node, _input, ctx) {
+    const handle = ctx.scopeHandle;
+    const scopeNode = ctx.scopeNode?.type === 'git:cow-worktree' ? ctx.scopeNode : undefined;
+    const effectivePolicy = scopeNode !== undefined
+        ? resolveEffectiveCheckpointPolicy(scopeNode)
+        : undefined;
+    const remaining = await gitWorktreePruneResolvedConflicts(handle);
+    const markerPaths = await findWorktreeConflictMarkerPaths(handle, effectivePolicy?.excludeGlobs);
+    const unresolvedSet = new Set([
+        ...Object.keys(remaining),
+        ...markerPaths,
+    ]);
+    if (unresolvedSet.size === 0) {
+        return { ok: true, deficits: [] };
+    }
+    const sorted = [...unresolvedSet].sort();
+    return {
+        ok: false,
+        deficits: sorted.map((relPath) => `Unresolved git merge conflict in '${relPath}'.`),
+    };
+}
+/**
+ * Executes a `GitSnapshotAndResetNode` (`git.snapshotAndReset()`) abort hook on `input.handle`.
+ *
+ * Idempotently snapshots dirty state over `baseRef` to `refs/harness/aborted/<runId>/<stepExecId>`,
+ * resets the worktree to `baseRef`, and clears `unresolvedConflictPaths`.
+ *
+ * @param {GitSnapshotAndResetNode}                    _node - Passive snapshot-and-reset abort hook AST node.
+ * @param {AbortHookExecutionInput<GitWorktreeHandle>} input - Abort hook execution input with handle and run/step IDs.
+ * @param {StepExecutionContext<GitWorktreeHandle>}    ctx   - Active step execution context.
+ *
+ * @returns {Promise<GitAbortMeta>} Validated `{ abortedSnapshotRef, resetToRef }` abort metadata receipt.
+ */
+export async function executeGitSnapshotAndResetHook(_node, input, ctx) {
+    const handle = input.handle;
+    const cwd = handle.worktreePath;
+    const scopeNode = ctx.scopeNode?.type === 'git:cow-worktree' ? ctx.scopeNode : undefined;
+    const effectivePolicy = scopeNode !== undefined
+        ? resolveEffectiveCheckpointPolicy(scopeNode)
+        : undefined;
+    const sanitizedStepExecId = input.stepExecId.replace(/[:~^?*[\\\s]+/g, '-');
+    const abortedSnapshotRef = `refs/harness/aborted/${input.runId}/${sanitizedStepExecId}`;
+    const synth = await synthesizeWorkingTreeCommitOverBase(handle, handle.baseRef, effectivePolicy?.excludeGlobs);
+    const baseTreeSha = (await runGitCommand({ cwd, args: ['rev-parse', `${handle.baseRef}^{tree}`] })).stdout.trim();
+    const existingRef = await runGitCommand({
+        cwd,
+        args: ['rev-parse', '--verify', abortedSnapshotRef],
+        allowNonZeroExit: true,
+    });
+    if (synth.treeSha !== baseTreeSha || existingRef.exitCode !== 0) {
+        await runGitCommand({
+            cwd,
+            args: ['update-ref', abortedSnapshotRef, synth.commitSha],
+        });
+    }
+    await resetWorktreeToBaseRefAndClearConflicts(handle);
+    return { abortedSnapshotRef, resetToRef: handle.baseRef };
+}
+/**
+ * Executes a `GitKeepWorktreeNode` (`git.keepWorktree()`) rewind hook on `input.handle`.
+ *
+ * Preserves the current working tree, `HEAD`, and `baseRef` in-place across `.rewindTo()` transitions.
+ *
+ * @param {GitKeepWorktreeNode}                         _node  - Passive keep-worktree rewind hook AST node.
+ * @param {RewindHookExecutionInput<GitWorktreeHandle>} _input - Rewind hook execution input.
+ * @param {StepExecutionContext<GitWorktreeHandle>}     _ctx   - Active step execution context.
+ *
+ * @returns {Promise<void>} Resolves immediately without mutating the worktree.
+ */
+export function executeGitKeepWorktreeHook(_node, _input, _ctx) {
+    return Promise.resolve();
+}
+/**
+ * Executes a `GitDiscardBranchNode` (`git.resetWorktree()` / `git.discardBranch()`) rewind hook on `input.handle`.
+ *
+ * Restores `input.handle` to `input.targetStepBaseScopeCheckpoint` (or resets to `handle.baseRef` if absent).
+ *
+ * @param {GitDiscardBranchNode}                        _node - Passive discard-branch rewind hook AST node.
+ * @param {RewindHookExecutionInput<GitWorktreeHandle>} input - Rewind hook execution input.
+ * @param {StepExecutionContext<GitWorktreeHandle>}     ctx   - Active step execution context.
+ *
+ * @returns {Promise<void>} Resolves once the worktree is restored to the target step's base checkpoint.
+ */
+export async function executeGitDiscardBranchHook(_node, input, ctx) {
+    const handle = input.handle;
+    const scopeNode = ctx.scopeNode?.type === 'git:cow-worktree' ? ctx.scopeNode : undefined;
+    const effectivePolicy = scopeNode !== undefined
+        ? resolveEffectiveCheckpointPolicy(scopeNode)
+        : undefined;
+    if (input.targetStepBaseScopeCheckpoint !== undefined) {
+        await gitCheckpointRestore(handle, input.targetStepBaseScopeCheckpoint, effectivePolicy);
+        return;
+    }
+    await resetWorktreeToBaseRefAndClearConflicts(handle);
+}
+//# sourceMappingURL=git-hooks-and-checks.js.map

package/dist/executors/git-hooks-and-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-hooks-and-checks.js","sourceRoot":"","sources":["../../src/executors/git-hooks-and-checks.ts"],"names":[],"mappings":"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"}

package/dist/executors/internal/checkpoint-restore-steps.d.ts

@@ -0,0 +1,50 @@
+import type { GitWorktreeHandle } from '@paraharness/core';
+import type { GitCheckpointPayload } from '../git-checkpoint-payload.js';
+/**
+ * Step 1 of `restoreCheckpoint`: restores `<gitdir>/HEAD`, `info/exclude`, `harness-meta.json`, live index, and `.gitignore` files.
+ *
+ * Ensures subsequent `git status --porcelain=v2` executes under the exact `.gitignore` and `HEAD` state of `fromCheckpoint`.
+ *
+ * @param {GitWorktreeHandle}    handle         - Worktree handle being restored.
+ * @param {GitCheckpointPayload} fromCheckpoint - Target checkpoint payload.
+ * @param {ReadonlySet<string>}  treePaths      - Set of repository-relative paths present in `fromCheckpoint.treeSha`.
+ *
+ * @returns {Promise<void>} Resolves once metadata and `.gitignore` files are restored.
+ */
+export declare function restoreGitdirMetadataAndGitignores(handle: GitWorktreeHandle, fromCheckpoint: GitCheckpointPayload, treePaths: ReadonlySet<string>): Promise<void>;
+/**
+ * Step 2 of `restoreCheckpoint`: unlinks paths in `symDiffPaths` absent from `preservedPaths` and clears directory collisions.
+ *
+ * Prunes empty parent directories up to `handle.worktreePath` after removing added files.
+ *
+ * @param {GitWorktreeHandle}   handle         - Worktree handle being restored.
+ * @param {readonly string[]}   symDiffPaths   - Paths in the symmetric difference between checkpoint and current state.
+ * @param {ReadonlySet<string>} preservedPaths - Union of paths in `fromCheckpoint.treeSha` and `oversizedUntrackedBlobs`.
+ *
+ * @returns {Promise<void>} Resolves once extraneous files and directory collisions are removed.
+ */
+export declare function unlinkAddedAndDirectoryCollisions(handle: GitWorktreeHandle, symDiffPaths: readonly string[], preservedPaths: ReadonlySet<string>): Promise<void>;
+/**
+ * Step 3 of `restoreCheckpoint`: materializes `fromCheckpoint.treeSha` via temporary index and restores live `indexTreeSha`.
+ *
+ * Uses `git checkout-index -f -z --stdin` for targeted `symDiff` restoration or `-f -a` when full checkout is requested.
+ *
+ * @param {GitWorktreeHandle}         handle             - Worktree handle being restored.
+ * @param {GitCheckpointPayload}      fromCheckpoint     - Target checkpoint payload.
+ * @param {readonly string[] | 'ALL'} pathsToMaterialize - Specific paths to materialize, or `'ALL'` on integrity failure.
+ *
+ * @returns {Promise<void>} Resolves once files and live `<gitdir>/index` are restored.
+ */
+export declare function checkoutCheckpointTreeAndRestoreIndex(handle: GitWorktreeHandle, fromCheckpoint: GitCheckpointPayload, pathsToMaterialize: readonly string[] | 'ALL'): Promise<void>;
+/**
+ * Step 4 of `restoreCheckpoint`: copies back oversized untracked blobs and restores `node_modules` if tampered with.
+ *
+ * Restores parent directories, original file modes, and `<gitdir>/harness-ckpt-nm` backup when `nodeModulesDigest` changed.
+ *
+ * @param {GitWorktreeHandle}    handle         - Worktree handle being restored.
+ * @param {GitCheckpointPayload} fromCheckpoint - Target checkpoint payload.
+ *
+ * @returns {Promise<void>} Resolves once all spilled untracked blobs and `node_modules` files are restored.
+ */
+export declare function restoreOversizedUntrackedBlobs(handle: GitWorktreeHandle, fromCheckpoint: GitCheckpointPayload): Promise<void>;
+//# sourceMappingURL=checkpoint-restore-steps.d.ts.map

package/dist/executors/internal/checkpoint-restore-steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-restore-steps.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/checkpoint-restore-steps.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAQzE;;;;;;;;;;GAUG;AACH,wBAAsB,kCAAkC,CACtD,MAAM,EAAE,iBAAiB,EACzB,cAAc,EAAE,oBAAoB,EACpC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,iBAAiB,EACzB,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qCAAqC,CACzD,MAAM,EAAE,iBAAiB,EACzB,cAAc,EAAE,oBAAoB,EACpC,kBAAkB,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,GAC5C,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAqCD;;;;;;;;;GASG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,iBAAiB,EACzB,cAAc,EAAE,oBAAoB,GACnC,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/executors/internal/checkpoint-restore-steps.js

@@ -0,0 +1,184 @@
+import { randomUUID } from 'node:crypto';
+import { lstat, mkdir, readdir, rmdir, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { computeNodeModulesDigest, copyFileCowOrValue } from './file-digest-and-globs.js';
+import { runGitCommand, updateWorktreeHandleInPlace, writeHarnessMeta, } from './git-cli-runner.js';
+/**
+ * Step 1 of `restoreCheckpoint`: restores `<gitdir>/HEAD`, `info/exclude`, `harness-meta.json`, live index, and `.gitignore` files.
+ *
+ * Ensures subsequent `git status --porcelain=v2` executes under the exact `.gitignore` and `HEAD` state of `fromCheckpoint`.
+ *
+ * @param {GitWorktreeHandle}    handle         - Worktree handle being restored.
+ * @param {GitCheckpointPayload} fromCheckpoint - Target checkpoint payload.
+ * @param {ReadonlySet<string>}  treePaths      - Set of repository-relative paths present in `fromCheckpoint.treeSha`.
+ *
+ * @returns {Promise<void>} Resolves once metadata and `.gitignore` files are restored.
+ */
+export async function restoreGitdirMetadataAndGitignores(handle, fromCheckpoint, treePaths) {
+    await writeFile(path.join(handle.gitDirPath, 'HEAD'), fromCheckpoint.headRawContent, 'utf8');
+    if (fromCheckpoint.headRawContent.startsWith('ref:')) {
+        await runGitCommand({ cwd: handle.worktreePath, args: ['update-ref', 'HEAD', fromCheckpoint.headSha] });
+    }
+    const excludePath = path.join(handle.gitDirPath, 'info', 'exclude');
+    if (fromCheckpoint.infoExcludeContent !== null) {
+        await mkdir(path.dirname(excludePath), { recursive: true });
+        await writeFile(excludePath, fromCheckpoint.infoExcludeContent, 'utf8');
+    }
+    else
+        await rm(excludePath, { force: true });
+    await writeHarnessMeta(handle.gitDirPath, fromCheckpoint.meta);
+    updateWorktreeHandleInPlace(handle, {
+        baseRef: fromCheckpoint.meta.baseRef,
+        baseBranch: fromCheckpoint.meta.baseBranch,
+        branchName: fromCheckpoint.meta.branchName,
+        headRef: fromCheckpoint.headSha,
+        unresolvedConflictPaths: Object.freeze({ ...fromCheckpoint.meta.unresolvedConflictPaths }),
+    });
+    const gitignorePaths = [];
+    for (const relPath of treePaths) {
+        if (relPath === '.gitignore' || relPath.endsWith('/.gitignore')) {
+            gitignorePaths.push(relPath);
+        }
+    }
+    if (gitignorePaths.length > 0) {
+        await checkoutCheckpointTreeAndRestoreIndex(handle, fromCheckpoint, gitignorePaths);
+    }
+    await runGitCommand({ cwd: handle.worktreePath, args: ['read-tree', fromCheckpoint.headSha] });
+    const untrackedGitignores = await runGitCommand({
+        cwd: handle.worktreePath,
+        args: ['ls-files', '--others', '-z', '--', '.gitignore', ':(glob)**/.gitignore', ':!node_modules/**', ':!**/node_modules/**'],
+    });
+    for (const rel of untrackedGitignores.stdout.split('\0')) {
+        if (rel.length > 0 && !treePaths.has(rel)) {
+            await rm(path.join(handle.worktreePath, rel), { force: true });
+        }
+    }
+}
+/**
+ * Step 2 of `restoreCheckpoint`: unlinks paths in `symDiffPaths` absent from `preservedPaths` and clears directory collisions.
+ *
+ * Prunes empty parent directories up to `handle.worktreePath` after removing added files.
+ *
+ * @param {GitWorktreeHandle}   handle         - Worktree handle being restored.
+ * @param {readonly string[]}   symDiffPaths   - Paths in the symmetric difference between checkpoint and current state.
+ * @param {ReadonlySet<string>} preservedPaths - Union of paths in `fromCheckpoint.treeSha` and `oversizedUntrackedBlobs`.
+ *
+ * @returns {Promise<void>} Resolves once extraneous files and directory collisions are removed.
+ */
+export async function unlinkAddedAndDirectoryCollisions(handle, symDiffPaths, preservedPaths) {
+    const rootAbs = path.resolve(handle.worktreePath);
+    for (const relPath of symDiffPaths) {
+        const absPath = path.join(handle.worktreePath, relPath);
+        if (!preservedPaths.has(relPath)) {
+            await rm(absPath, { recursive: true, force: true });
+            let parentDir = path.dirname(path.resolve(absPath));
+            while (parentDir.startsWith(rootAbs) && parentDir !== rootAbs) {
+                const entries = await readdir(parentDir).catch(() => ['non-empty']);
+                if (entries.length > 0)
+                    break;
+                await rmdir(parentDir).catch(() => undefined);
+                parentDir = path.dirname(parentDir);
+            }
+            continue;
+        }
+        const stat = await lstat(absPath).catch(() => null);
+        if (stat !== null && stat.isDirectory()) {
+            await rm(absPath, { recursive: true, force: true });
+        }
+    }
+}
+/**
+ * Step 3 of `restoreCheckpoint`: materializes `fromCheckpoint.treeSha` via temporary index and restores live `indexTreeSha`.
+ *
+ * Uses `git checkout-index -f -z --stdin` for targeted `symDiff` restoration or `-f -a` when full checkout is requested.
+ *
+ * @param {GitWorktreeHandle}         handle             - Worktree handle being restored.
+ * @param {GitCheckpointPayload}      fromCheckpoint     - Target checkpoint payload.
+ * @param {readonly string[] | 'ALL'} pathsToMaterialize - Specific paths to materialize, or `'ALL'` on integrity failure.
+ *
+ * @returns {Promise<void>} Resolves once files and live `<gitdir>/index` are restored.
+ */
+export async function checkoutCheckpointTreeAndRestoreIndex(handle, fromCheckpoint, pathsToMaterialize) {
+    const tmpIndex = path.join(handle.gitDirPath, `harness-restore-idx.${process.pid}.${randomUUID()}`);
+    try {
+        await runGitCommand({
+            cwd: handle.worktreePath,
+            args: ['read-tree', fromCheckpoint.treeSha],
+            env: { GIT_INDEX_FILE: tmpIndex },
+        });
+        if (pathsToMaterialize === 'ALL') {
+            await runGitCommand({
+                cwd: handle.worktreePath,
+                args: ['checkout-index', '-f', '-a'],
+                env: { GIT_INDEX_FILE: tmpIndex },
+            });
+        }
+        else if (pathsToMaterialize.length > 0) {
+            await runGitCommand({
+                cwd: handle.worktreePath,
+                args: ['checkout-index', '-f', '-z', '--stdin'],
+                env: { GIT_INDEX_FILE: tmpIndex },
+                stdin: `${pathsToMaterialize.join('\0')}\0`,
+            });
+        }
+    }
+    finally {
+        await rm(tmpIndex, { force: true });
+    }
+    await runGitCommand({ cwd: handle.worktreePath, args: ['read-tree', fromCheckpoint.indexTreeSha] });
+    await runGitCommand({ cwd: handle.worktreePath, args: ['update-index', '--refresh', '-q'], allowNonZeroExit: true });
+}
+/**
+ * Restores `<worktree>/node_modules` from `<gitdir>/harness-ckpt-nm/<digest>` when `node_modules` was mutated.
+ *
+ * @param {GitWorktreeHandle}    handle         - Worktree handle being restored.
+ * @param {GitCheckpointPayload} fromCheckpoint - Target checkpoint payload.
+ *
+ * @returns {Promise<void>} Resolves once `node_modules` matches `fromCheckpoint.nodeModulesDigest`.
+ */
+async function restoreTamperedNodeModulesFromBackup(handle, fromCheckpoint) {
+    const currentNmDigest = await computeNodeModulesDigest(handle.worktreePath);
+    if (currentNmDigest === fromCheckpoint.nodeModulesDigest)
+        return;
+    const nmTarget = path.join(handle.worktreePath, 'node_modules');
+    if (fromCheckpoint.nodeModulesDigest === 'ABSENT') {
+        await rm(nmTarget, { recursive: true, force: true });
+        return;
+    }
+    const nmBackup = path.join(handle.gitDirPath, 'harness-ckpt-nm', fromCheckpoint.nodeModulesDigest);
+    const backupStat = await lstat(nmBackup).catch(() => null);
+    if (backupStat === null || !backupStat.isDirectory())
+        return;
+    await rm(nmTarget, { recursive: true, force: true });
+    const stack = [''];
+    while (stack.length > 0) {
+        const rel = stack.pop() ?? '';
+        const entries = await readdir(path.join(nmBackup, rel), { withFileTypes: true });
+        for (const entry of entries) {
+            const childRel = rel.length === 0 ? entry.name : `${rel}/${entry.name}`;
+            if (entry.isDirectory())
+                stack.push(childRel);
+            else
+                await copyFileCowOrValue(path.join(nmBackup, childRel), path.join(nmTarget, childRel));
+        }
+    }
+}
+/**
+ * Step 4 of `restoreCheckpoint`: copies back oversized untracked blobs and restores `node_modules` if tampered with.
+ *
+ * Restores parent directories, original file modes, and `<gitdir>/harness-ckpt-nm` backup when `nodeModulesDigest` changed.
+ *
+ * @param {GitWorktreeHandle}    handle         - Worktree handle being restored.
+ * @param {GitCheckpointPayload} fromCheckpoint - Target checkpoint payload.
+ *
+ * @returns {Promise<void>} Resolves once all spilled untracked blobs and `node_modules` files are restored.
+ */
+export async function restoreOversizedUntrackedBlobs(handle, fromCheckpoint) {
+    for (const [relPath, blobRecord] of Object.entries(fromCheckpoint.oversizedUntrackedBlobs)) {
+        const srcBlob = path.join(handle.gitDirPath, 'harness-ckpt-blobs', blobRecord.blobKey);
+        const destPath = path.join(handle.worktreePath, relPath);
+        await copyFileCowOrValue(srcBlob, destPath, blobRecord.mode);
+    }
+    await restoreTamperedNodeModulesFromBackup(handle, fromCheckpoint);
+}
+//# sourceMappingURL=checkpoint-restore-steps.js.map

package/dist/executors/internal/checkpoint-restore-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-restore-steps.js","sourceRoot":"","sources":["../../../src/executors/internal/checkpoint-restore-steps.ts"],"names":[],"mappings":"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"}

package/dist/executors/internal/checkpoint-staging-and-integrity.d.ts

@@ -0,0 +1,51 @@
+import type { GitWorktreeHandle } from '@paraharness/core';
+import type { GitCheckpointPayload } from '../git-checkpoint-payload.js';
+import type { StagedCheckpointTreeResult } from './staged-checkpoint-tree-result.js';
+import type { WorktreeIntegrityVerdict } from './worktree-integrity-verdict.js';
+import type { WorktreeStatusSnapshot } from './worktree-status-snapshot.js';
+/**
+ * Stages tracked dirty files and size-bounded untracked files into a temporary git index to produce `treeSha`.
+ *
+ * Spills untracked (`?`) files exceeding `maxUntrackedBytes` into `<gitdir>/harness-ckpt-blobs/` via CoW/value copy.
+ *
+ * @param {GitWorktreeHandle}      handle            - Active worktree handle.
+ * @param {WorktreeStatusSnapshot} snapshot          - Porcelain v2 status snapshot of the worktree.
+ * @param {number}                 maxUntrackedBytes - Byte threshold above which untracked files spill to `harness-ckpt-blobs/`.
+ *
+ * @returns {Promise<StagedCheckpointTreeResult>} Synthesized tree SHA and spilled blob map.
+ */
+export declare function stageCheckpointTreeAndOversizedBlobs(handle: GitWorktreeHandle, snapshot: WorktreeStatusSnapshot, maxUntrackedBytes: number): Promise<StagedCheckpointTreeResult>;
+/**
+ * Verifies worktree-local `.git` metadata (`HEAD`, `indexTreeSha`, `info/exclude`, `harness-meta.json`) and `node_modules` integrity.
+ *
+ * Returns `{ intact: false, reason }` if any worktree-local metadata or `node_modules` tree was mutated by a subprocess.
+ *
+ * @param {GitWorktreeHandle}    handle         - Active worktree handle.
+ * @param {GitCheckpointPayload} fromCheckpoint - Parsed baseline checkpoint payload.
+ *
+ * @returns {Promise<WorktreeIntegrityVerdict>} Integrity verification result.
+ */
+export declare function verifyWorktreeLocalGitIntegrity(handle: GitWorktreeHandle, fromCheckpoint: GitCheckpointPayload): Promise<WorktreeIntegrityVerdict>;
+/**
+ * Lists all repository-relative file paths recorded inside a Git tree object (`git ls-tree -r --name-only -z`).
+ *
+ * Returns a `ReadonlySet<string>` for $O(1)$ membership queries during checkpoint restoration and merge materialization.
+ *
+ * @param {string} worktreePath - Worktree directory path.
+ * @param {string} treeOrCommit - Git tree or commit SHA to list.
+ *
+ * @returns {Promise<ReadonlySet<string>>} Set of repository-relative file paths in `treeOrCommit`.
+ */
+export declare function listTreePaths(worktreePath: string, treeOrCommit: string): Promise<ReadonlySet<string>>;
+/**
+ * Computes the sorted symmetric difference of paths whose `${mode}:${sha256}` status changed between two status maps.
+ *
+ * Includes paths added, deleted, modified, or reverted back to clean `HEAD` between `beforeMap` and `afterMap`.
+ *
+ * @param {Readonly<Record<string, string>>} beforeMap - Baseline status map from `fromCheckpoint`.
+ * @param {Readonly<Record<string, string>>} afterMap  - Current worktree status map.
+ *
+ * @returns {readonly string[]} Lexicographically sorted list of changed repository-relative paths.
+ */
+export declare function computeSymmetricStatusDiff(beforeMap: Readonly<Record<string, string>>, afterMap: Readonly<Record<string, string>>): readonly string[];
+//# sourceMappingURL=checkpoint-staging-and-integrity.d.ts.map

package/dist/executors/internal/checkpoint-staging-and-integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-staging-and-integrity.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/checkpoint-staging-and-integrity.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,8BAA8B,CAAC;AAMtC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;;;;;;;;;GAUG;AACH,wBAAsB,oCAAoC,CACxD,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,sBAAsB,EAChC,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,0BAA0B,CAAC,CA8BrC;AA2ED;;;;;;;;;GASG;AACH,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,iBAAiB,EACzB,cAAc,EAAE,oBAAoB,GACnC,OAAO,CAAC,wBAAwB,CAAC,CAkBnC;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAU9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC3C,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACzC,SAAS,MAAM,EAAE,CAWnB"}