@paraharness/git 0.0.0-stage → 0.1.0

package/dist/executors/internal/porcelain-v2-parser.d.ts

@@ -0,0 +1,49 @@
+import type { GitWorktreeHandle, ToolEffect } from '@paraharness/core';
+import type { ComputeWorktreeStatusOptions } from './compute-worktree-status-options.js';
+import type { WorktreeStatusSnapshot } from './worktree-status-snapshot.js';
+/**
+ * Parses NUL-delimited `git status --porcelain=v2 -z --no-renames --untracked-files=all` output into `WorktreeStatusSnapshot`.
+ *
+ * Hashes every dirty tracked and untracked file via `computePathModeAndSha256` while filtering out `excludeGlobs`.
+ *
+ * @param {string}                       worktreePath - Worktree directory path.
+ * @param {string}                       rawStdout    - Raw NUL-delimited stdout from `git status --porcelain=v2 -z`.
+ * @param {ComputeWorktreeStatusOptions} [options]    - Optional exclusion globs and baseline ignored path set.
+ *
+ * @returns {Promise<WorktreeStatusSnapshot>} Parsed worktree status snapshot.
+ */
+export declare function parsePorcelainV2Records(worktreePath: string, rawStdout: string, options?: ComputeWorktreeStatusOptions): Promise<WorktreeStatusSnapshot>;
+/**
+ * Finds the 0-based index of the `n`-th space character in `input`.
+ *
+ * Used to extract repository-relative file paths containing spaces from porcelain v2 records.
+ *
+ * @param {string} input - Porcelain v2 record line.
+ * @param {number} count - 1-based space occurrence count to locate.
+ *
+ * @returns {number} Character index of the `count`-th space, or `-1` if fewer spaces exist.
+ */
+export declare function nthSpaceIndex(input: string, count: number): number;
+/**
+ * Checks whether any `.gitignore` or `**\/.gitignore` entry differs between two status maps.
+ *
+ * Triggers `--ignored=matching` scanning in `diffEffects` when a subprocess modifies `.gitignore`.
+ *
+ * @param {Readonly<Record<string, string>>} beforeMap - Baseline status map from `fromCheckpoint`.
+ * @param {Readonly<Record<string, string>>} afterMap  - Current status map.
+ *
+ * @returns {boolean} `true` if any `.gitignore` path was added, modified, or deleted.
+ */
+export declare function hasGitignoreChanged(beforeMap: Readonly<Record<string, string>>, afterMap: Readonly<Record<string, string>>): boolean;
+/**
+ * Builds the `fs:effect` `ToolEffect` list from the symmetric difference of worktree paths.
+ *
+ * Queries `git cat-file -e <baseRef>:<path>` for `existingPathsAtBaseRef` and reads `proposedContent` for UTF-8 files.
+ *
+ * @param {GitWorktreeHandle} handle       - Active worktree handle.
+ * @param {readonly string[]} symDiffPaths - Sorted paths in the symmetric status difference.
+ *
+ * @returns {Promise<readonly ToolEffect[]>} Frozen `ToolEffect` tuple (empty when `symDiffPaths` is empty).
+ */
+export declare function buildFsDiffToolEffects(handle: GitWorktreeHandle, symDiffPaths: readonly string[]): Promise<readonly ToolEffect[]>;
+//# sourceMappingURL=porcelain-v2-parser.d.ts.map

package/dist/executors/internal/porcelain-v2-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"porcelain-v2-parser.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/porcelain-v2-parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AAMzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAuC5E;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,sBAAsB,CAAC,CA4CjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CASlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC3C,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACzC,OAAO,CAQT;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,iBAAiB,EACzB,YAAY,EAAE,SAAS,MAAM,EAAE,GAC9B,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CA0BhC"}

package/dist/executors/internal/porcelain-v2-parser.js

@@ -0,0 +1,165 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { compileWorktreeExcludeMatcher, computePathModeAndSha256, } from './file-digest-and-globs.js';
+import { runGitCommand } from './git-cli-runner.js';
+/**
+ * Expands a newly ignored directory or file entry (`! <relPath>`) into its underlying files and records their digests.
+ *
+ * @param {CollectNewlyIgnoredFilesParams} params - Ignored file collection parameters.
+ *
+ * @returns {Promise<void>} Resolves once all matching ignored files under `params.relPath` are hashed into `params.statusMap`.
+ */
+async function collectNewlyIgnoredFiles(params) {
+    const lsFilesOutput = await runGitCommand({
+        cwd: params.worktreePath,
+        args: ['ls-files', '--others', '-i', '--exclude-standard', '-z', '--', params.relPath],
+    });
+    for (const subPath of lsFilesOutput.stdout.split('\0')) {
+        if (subPath.length > 0 && !params.isExcluded(subPath)) {
+            params.statusMap[subPath] = await computePathModeAndSha256(path.join(params.worktreePath, subPath));
+        }
+    }
+}
+/**
+ * Parses NUL-delimited `git status --porcelain=v2 -z --no-renames --untracked-files=all` output into `WorktreeStatusSnapshot`.
+ *
+ * Hashes every dirty tracked and untracked file via `computePathModeAndSha256` while filtering out `excludeGlobs`.
+ *
+ * @param {string}                       worktreePath - Worktree directory path.
+ * @param {string}                       rawStdout    - Raw NUL-delimited stdout from `git status --porcelain=v2 -z`.
+ * @param {ComputeWorktreeStatusOptions} [options]    - Optional exclusion globs and baseline ignored path set.
+ *
+ * @returns {Promise<WorktreeStatusSnapshot>} Parsed worktree status snapshot.
+ */
+export async function parsePorcelainV2Records(worktreePath, rawStdout, options) {
+    const isExcluded = compileWorktreeExcludeMatcher(options?.excludeGlobs);
+    const statusMap = {};
+    const untrackedPaths = new Set();
+    const deletedPaths = new Set();
+    const ignoredPaths = [];
+    for (const record of rawStdout.split('\0')) {
+        if (record.length === 0)
+            continue;
+        if (record.startsWith('? ')) {
+            const relPath = record.slice(2);
+            if (isExcluded(relPath))
+                continue;
+            untrackedPaths.add(relPath);
+            statusMap[relPath] = await computePathModeAndSha256(path.join(worktreePath, relPath));
+            continue;
+        }
+        if (record.startsWith('! ')) {
+            const relPath = record.slice(2);
+            ignoredPaths.push(relPath);
+            if (options?.includeMatchingIgnored &&
+                options.baselineIgnoredPaths !== undefined &&
+                !options.baselineIgnoredPaths.has(relPath) &&
+                !isExcluded(relPath)) {
+                await collectNewlyIgnoredFiles({
+                    worktreePath,
+                    relPath,
+                    isExcluded,
+                    statusMap,
+                });
+            }
+            continue;
+        }
+        if (!record.startsWith('1 ') && !record.startsWith('u '))
+            continue;
+        const spaceIdx = record.startsWith('1 ') ? nthSpaceIndex(record, 8) : nthSpaceIndex(record, 10);
+        if (spaceIdx === -1)
+            continue;
+        const relPath = record.slice(spaceIdx + 1);
+        if (isExcluded(relPath))
+            continue;
+        const rawDigest = await computePathModeAndSha256(path.join(worktreePath, relPath));
+        const digest = rawDigest === '040000:directory' ? 'DELETED' : rawDigest;
+        statusMap[relPath] = digest;
+        if (digest === 'DELETED')
+            deletedPaths.add(relPath);
+    }
+    return Object.freeze({ statusMap: Object.freeze(statusMap), untrackedPaths, deletedPaths, ignoredPaths: Object.freeze(ignoredPaths) });
+}
+/**
+ * Finds the 0-based index of the `n`-th space character in `input`.
+ *
+ * Used to extract repository-relative file paths containing spaces from porcelain v2 records.
+ *
+ * @param {string} input - Porcelain v2 record line.
+ * @param {number} count - 1-based space occurrence count to locate.
+ *
+ * @returns {number} Character index of the `count`-th space, or `-1` if fewer spaces exist.
+ */
+export function nthSpaceIndex(input, count) {
+    let seen = 0;
+    for (let i = 0; i < input.length; i += 1) {
+        if (input[i] === ' ') {
+            seen += 1;
+            if (seen === count)
+                return i;
+        }
+    }
+    return -1;
+}
+/**
+ * Checks whether any `.gitignore` or `**\/.gitignore` entry differs between two status maps.
+ *
+ * Triggers `--ignored=matching` scanning in `diffEffects` when a subprocess modifies `.gitignore`.
+ *
+ * @param {Readonly<Record<string, string>>} beforeMap - Baseline status map from `fromCheckpoint`.
+ * @param {Readonly<Record<string, string>>} afterMap  - Current status map.
+ *
+ * @returns {boolean} `true` if any `.gitignore` path was added, modified, or deleted.
+ */
+export function hasGitignoreChanged(beforeMap, afterMap) {
+    for (const key of Object.keys(beforeMap)) {
+        if ((key === '.gitignore' || key.endsWith('/.gitignore')) && beforeMap[key] !== afterMap[key])
+            return true;
+    }
+    for (const key of Object.keys(afterMap)) {
+        if ((key === '.gitignore' || key.endsWith('/.gitignore')) && beforeMap[key] !== afterMap[key])
+            return true;
+    }
+    return false;
+}
+/**
+ * Builds the `fs:effect` `ToolEffect` list from the symmetric difference of worktree paths.
+ *
+ * Queries `git cat-file -e <baseRef>:<path>` for `existingPathsAtBaseRef` and reads `proposedContent` for UTF-8 files.
+ *
+ * @param {GitWorktreeHandle} handle       - Active worktree handle.
+ * @param {readonly string[]} symDiffPaths - Sorted paths in the symmetric status difference.
+ *
+ * @returns {Promise<readonly ToolEffect[]>} Frozen `ToolEffect` tuple (empty when `symDiffPaths` is empty).
+ */
+export async function buildFsDiffToolEffects(handle, symDiffPaths) {
+    if (symDiffPaths.length === 0)
+        return Object.freeze([]);
+    const existingPathsAtBaseRef = [];
+    const proposedContent = {};
+    for (const relPath of symDiffPaths) {
+        const checkBase = await runGitCommand({
+            cwd: handle.worktreePath,
+            args: ['cat-file', '-e', `${handle.baseRef}:${relPath}`],
+            allowNonZeroExit: true,
+        });
+        if (checkBase.exitCode === 0)
+            existingPathsAtBaseRef.push(relPath);
+        const content = await readFile(path.join(handle.worktreePath, relPath), 'utf8').catch(() => undefined);
+        if (content !== undefined)
+            proposedContent[relPath] = content;
+    }
+    return Object.freeze([
+        Object.freeze({
+            kind: 'fs:effect',
+            mutatesScope: true,
+            attributes: Object.freeze({
+                mode: 'write',
+                paths: Object.freeze([...symDiffPaths]),
+                existingPathsAtBaseRef: Object.freeze(existingPathsAtBaseRef),
+                proposedContent: Object.freeze(proposedContent),
+            }),
+        }),
+    ]);
+}
+//# sourceMappingURL=porcelain-v2-parser.js.map

package/dist/executors/internal/porcelain-v2-parser.js.map

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

package/dist/executors/internal/resolve-effective-base-branch.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Resolves `baseBranch` against `origin/main` before rebasing in `git.commitAndPush`.
+ *
+ * Falls back to `'main'` when a prerequisite branch was squash-merged and deleted, or throws if closed unmerged.
+ *
+ * @param {string} cwd                 - Worktree directory path.
+ * @param {string} candidateBaseBranch - Recorded base branch name on the worktree handle.
+ * @param {string} preStepBaseRef      - Recorded `baseRef` commit SHA prior to `commitAndPush`.
+ *
+ * @returns {Promise<string>} Resolved upstream branch name (`'main'` or active prerequisite branch).
+ */
+export declare function resolveEffectiveBaseBranch(cwd: string, candidateBaseBranch: string, preStepBaseRef: string): Promise<string>;
+//# sourceMappingURL=resolve-effective-base-branch.d.ts.map

package/dist/executors/internal/resolve-effective-base-branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-effective-base-branch.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/resolve-effective-base-branch.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,mBAAmB,EAAE,MAAM,EAC3B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/dist/executors/internal/resolve-effective-base-branch.js

@@ -0,0 +1,38 @@
+import { runGitCommand } from './git-cli-runner.js';
+/**
+ * Resolves `baseBranch` against `origin/main` before rebasing in `git.commitAndPush`.
+ *
+ * Falls back to `'main'` when a prerequisite branch was squash-merged and deleted, or throws if closed unmerged.
+ *
+ * @param {string} cwd                 - Worktree directory path.
+ * @param {string} candidateBaseBranch - Recorded base branch name on the worktree handle.
+ * @param {string} preStepBaseRef      - Recorded `baseRef` commit SHA prior to `commitAndPush`.
+ *
+ * @returns {Promise<string>} Resolved upstream branch name (`'main'` or active prerequisite branch).
+ */
+export async function resolveEffectiveBaseBranch(cwd, candidateBaseBranch, preStepBaseRef) {
+    if (candidateBaseBranch === 'main')
+        return 'main';
+    const remoteBranch = await runGitCommand({
+        cwd,
+        args: ['rev-parse', '--verify', `refs/remotes/origin/${candidateBaseBranch}`],
+        allowNonZeroExit: true,
+    });
+    const isAncestor = await runGitCommand({
+        cwd,
+        args: ['merge-base', '--is-ancestor', preStepBaseRef, 'refs/remotes/origin/main'],
+        allowNonZeroExit: true,
+    });
+    const cherryRes = await runGitCommand({
+        cwd,
+        args: ['cherry', 'refs/remotes/origin/main', preStepBaseRef],
+        allowNonZeroExit: true,
+    });
+    const allCommitsApplied = cherryRes.exitCode === 0 && !cherryRes.stdout.split('\n').some((line) => line.startsWith('+ '));
+    if (isAncestor.exitCode === 0 || allCommitsApplied)
+        return 'main';
+    if (remoteBranch.exitCode === 0)
+        return candidateBaseBranch;
+    throw new Error(`Prerequisite branch '${candidateBaseBranch}' was closed or deleted on origin without merging into 'origin/main'.`);
+}
+//# sourceMappingURL=resolve-effective-base-branch.js.map

package/dist/executors/internal/resolve-effective-base-branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-effective-base-branch.js","sourceRoot":"","sources":["../../../src/executors/internal/resolve-effective-base-branch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,GAAW,EACX,mBAA2B,EAC3B,cAAsB;IAEtB,IAAI,mBAAmB,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAClD,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC;QACvC,GAAG;QACH,IAAI,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,uBAAuB,mBAAmB,EAAE,CAAC;QAC7E,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC;QACrC,GAAG;QACH,IAAI,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,0BAA0B,CAAC;QACjF,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC;QACpC,GAAG;QACH,IAAI,EAAE,CAAC,QAAQ,EAAE,0BAA0B,EAAE,cAAc,CAAC;QAC5D,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IACH,MAAM,iBAAiB,GAAG,SAAS,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1H,IAAI,UAAU,CAAC,QAAQ,KAAK,CAAC,IAAI,iBAAiB;QAAE,OAAO,MAAM,CAAC;IAClE,IAAI,YAAY,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAC5D,MAAM,IAAI,KAAK,CACb,wBAAwB,mBAAmB,uEAAuE,CACnH,CAAC;AACJ,CAAC"}

package/dist/executors/internal/squash-rebase-and-push.d.ts

@@ -0,0 +1,14 @@
+import type { GitCommitAndPushNode, GitWorktreeHandle, StepExecutionContext } from '@paraharness/core';
+/**
+ * Executes the atomic squash, rebase, verify, and `--force-with-lease` push sequence for `git.commitAndPush`.
+ *
+ * Persists `inFlightCommitAndPush` before mutating `HEAD` and rolls back to `preStepHeadSha` on any failure.
+ *
+ * @param {GitCommitAndPushNode<unknown>}           node        - Commit-and-push step AST node.
+ * @param {unknown}                                 parsedInput - Validated step input payload.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx         - Active step execution context.
+ *
+ * @returns {Promise<void>} Resolves once the squashed branch is pushed and `rootHandle` lineage is updated.
+ */
+export declare function runSquashRebaseAndPush(node: GitCommitAndPushNode<unknown>, parsedInput: unknown, ctx: StepExecutionContext<GitWorktreeHandle>): Promise<void>;
+//# sourceMappingURL=squash-rebase-and-push.d.ts.map

package/dist/executors/internal/squash-rebase-and-push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"squash-rebase-and-push.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/squash-rebase-and-push.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAwM3B;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,oBAAoB,CAAC,OAAO,CAAC,EACnC,WAAW,EAAE,OAAO,EACpB,GAAG,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAwDf"}

package/dist/executors/internal/squash-rebase-and-push.js

@@ -0,0 +1,192 @@
+import { readHarnessMeta, runGitCommand, updateWorktreeHandleInPlace, writeHarnessMeta, } from './git-cli-runner.js';
+import { evaluateWorktreeCheck } from './git-merge-train-bisect.js';
+import { gitWorktreeFlushCleanParentChanges } from './git-worktree-flush-and-prune.js';
+import { resolveEffectiveCheckpointPolicy } from './git-worktree-reattach.js';
+import { resolveEffectiveBaseBranch } from './resolve-effective-base-branch.js';
+/**
+ * Resolves symbolic `EnvRef` entries configured on `node.env` via `ctx.resolveEnv`.
+ *
+ * @param {GitCommitAndPushNode<unknown>}           node - Commit-and-push step AST node.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx  - Active step execution context.
+ *
+ * @returns {Readonly<Record<string, string | undefined>>} Resolved environment variable map.
+ */
+function resolveCommitAndPushEnv(node, ctx) {
+    const env = {};
+    if (node.env !== undefined) {
+        for (const [key, refOrValue] of Object.entries(node.env)) {
+            env[key] = ctx.resolveEnv(refOrValue);
+        }
+    }
+    return Object.freeze(env);
+}
+/**
+ * Rolls back an interrupted or failed `git.commitAndPush` execution to `preStepHeadSha` and `preStepBaseRef`.
+ *
+ * @param {GitWorktreeHandle}                             rootHandle - Active root worktree handle.
+ * @param {HarnessMetaRecord}                             meta       - Current `harness-meta.json` record containing `inFlightCommitAndPush`.
+ * @param {Readonly<Record<string, string | undefined>>}  env        - Resolved environment variables.
+ *
+ * @returns {Promise<void>} Resolves once `HEAD`, `baseRef`, and `harness-meta.json` are restored.
+ */
+async function rollbackFailedCommitAndPush(rootHandle, meta, env) {
+    const inFlight = meta.inFlightCommitAndPush;
+    if (inFlight === undefined)
+        return;
+    const cwd = rootHandle.worktreePath;
+    await runGitCommand({ cwd, args: ['rebase', '--abort'], env, allowNonZeroExit: true });
+    await runGitCommand({ cwd, args: ['reset', '--hard', inFlight.preStepHeadSha], env });
+    const restoredMeta = {
+        ...meta,
+        baseRef: inFlight.preStepBaseRef,
+        inFlightCommitAndPush: undefined,
+    };
+    await writeHarnessMeta(rootHandle.gitDirPath, restoredMeta);
+    updateWorktreeHandleInPlace(rootHandle, {
+        baseRef: inFlight.preStepBaseRef,
+        headRef: inFlight.preStepHeadSha,
+    });
+}
+/**
+ * Fetches `origin`, resolves the effective stacked-PR base branch, synthesizes a single squashed commit over
+ * `preStepBaseRef`, and rebases `HEAD` onto `origin/<resolvedBaseBranch>`.
+ *
+ * @param {SquashRebasePhaseParams} params - Squash and rebase phase parameters.
+ *
+ * @returns {Promise<readonly [string, string]>} Tuple of `[resolvedBaseBranch, upstreamSha]`.
+ */
+async function squashAndRebaseOntoUpstream(params) {
+    const { rootHandle, inFlightMeta, preStepHeadSha, preStepBaseRef, commitMessage, env, } = params;
+    const cwd = rootHandle.worktreePath;
+    await runGitCommand({
+        cwd,
+        args: ['fetch', 'origin'],
+        env,
+        allowNonZeroExit: true,
+    });
+    const resolvedBaseBranch = await resolveEffectiveBaseBranch(cwd, inFlightMeta.baseBranch || rootHandle.baseBranch || 'main', preStepBaseRef);
+    const treeSha = (await runGitCommand({
+        cwd,
+        args: ['rev-parse', `${preStepHeadSha}^{tree}`],
+        env,
+    })).stdout.trim();
+    const squashedSha = (await runGitCommand({
+        cwd,
+        args: ['commit-tree', treeSha, '-p', preStepBaseRef, '-m', commitMessage],
+        env,
+    })).stdout.trim();
+    await runGitCommand({ cwd, args: ['reset', '--hard', squashedSha], env });
+    const remoteRefCheck = await runGitCommand({
+        cwd,
+        args: [
+            'rev-parse',
+            '--verify',
+            `refs/remotes/origin/${resolvedBaseBranch}`,
+        ],
+        env,
+        allowNonZeroExit: true,
+    });
+    const upstreamRef = remoteRefCheck.exitCode === 0
+        ? `refs/remotes/origin/${resolvedBaseBranch}`
+        : resolvedBaseBranch;
+    const upstreamSha = (await runGitCommand({ cwd, args: ['rev-parse', upstreamRef], env })).stdout.trim();
+    await runGitCommand({
+        cwd,
+        args: ['rebase', '--onto', upstreamSha, preStepBaseRef, 'HEAD'],
+        env,
+    });
+    return [resolvedBaseBranch, upstreamSha];
+}
+/**
+ * Pushes the verified `HEAD` commit to `origin` with `--force-with-lease` and updates `harness-meta.json` and `rootHandle`.
+ *
+ * @param {SquashRebasePhaseParams} params             - Push and finalization parameters.
+ * @param {string}                  resolvedBaseBranch - Resolved effective base branch name.
+ * @param {string}                  upstreamSha        - Commit SHA of `origin/<resolvedBaseBranch>`.
+ *
+ * @returns {Promise<void>} Resolves once `origin` is updated and `rootHandle` lineage is finalized.
+ */
+async function pushAndFinalizeRootLineage(params, resolvedBaseBranch, upstreamSha) {
+    const { rootHandle, inFlightMeta, targetBranch, env } = params;
+    const cwd = rootHandle.worktreePath;
+    await runGitCommand({
+        cwd,
+        args: [
+            'push',
+            '--force-with-lease',
+            'origin',
+            `HEAD:refs/heads/${targetBranch}`,
+        ],
+        env,
+    });
+    const pushedCommitSha = (await runGitCommand({ cwd, args: ['rev-parse', 'HEAD'], env })).stdout.trim();
+    await writeHarnessMeta(rootHandle.gitDirPath, {
+        ...inFlightMeta,
+        baseRef: upstreamSha,
+        baseBranch: resolvedBaseBranch,
+        branchName: targetBranch,
+        inFlightCommitAndPush: undefined,
+    });
+    updateWorktreeHandleInPlace(rootHandle, {
+        baseRef: upstreamSha,
+        baseBranch: resolvedBaseBranch,
+        branchName: targetBranch,
+        headRef: pushedCommitSha,
+    });
+}
+/**
+ * Executes the atomic squash, rebase, verify, and `--force-with-lease` push sequence for `git.commitAndPush`.
+ *
+ * Persists `inFlightCommitAndPush` before mutating `HEAD` and rolls back to `preStepHeadSha` on any failure.
+ *
+ * @param {GitCommitAndPushNode<unknown>}           node        - Commit-and-push step AST node.
+ * @param {unknown}                                 parsedInput - Validated step input payload.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx         - Active step execution context.
+ *
+ * @returns {Promise<void>} Resolves once the squashed branch is pushed and `rootHandle` lineage is updated.
+ */
+export async function runSquashRebaseAndPush(node, parsedInput, ctx) {
+    const rootHandle = ctx.scopeHandle;
+    const cwd = rootHandle.worktreePath;
+    const scopeNode = ctx.scopeNode?.type === 'git:cow-worktree' ? ctx.scopeNode : undefined;
+    const effectivePolicy = scopeNode !== undefined
+        ? resolveEffectiveCheckpointPolicy(scopeNode)
+        : undefined;
+    const env = resolveCommitAndPushEnv(node, ctx);
+    await gitWorktreeFlushCleanParentChanges(rootHandle, effectivePolicy?.excludeGlobs);
+    const preStepHeadSha = (await runGitCommand({ cwd, args: ['rev-parse', 'HEAD'], env })).stdout.trim();
+    const initialMeta = await readHarnessMeta(rootHandle.gitDirPath);
+    const preStepBaseRef = initialMeta.baseRef;
+    const targetBranch = node.branch(parsedInput);
+    const commitMessage = node.message(parsedInput);
+    const inFlightMeta = {
+        ...initialMeta,
+        inFlightCommitAndPush: { preStepHeadSha, preStepBaseRef, targetBranch },
+    };
+    await writeHarnessMeta(rootHandle.gitDirPath, inFlightMeta);
+    const phaseParams = {
+        rootHandle,
+        inFlightMeta,
+        preStepHeadSha,
+        preStepBaseRef,
+        targetBranch,
+        commitMessage,
+        env,
+    };
+    try {
+        const [resolvedBaseBranch, upstreamSha] = await squashAndRebaseOntoUpstream(phaseParams);
+        const verifyCheck = scopeNode?.reconcileStrategy?.verifyWith;
+        if (verifyCheck !== undefined) {
+            const checkOutcome = await evaluateWorktreeCheck(verifyCheck, ctx);
+            if (!checkOutcome.ok) {
+                throw new Error(`Reconcile verification check '${verifyCheck.id}' failed: ${checkOutcome.deficits.join('; ')}`);
+            }
+        }
+        await pushAndFinalizeRootLineage(phaseParams, resolvedBaseBranch, upstreamSha);
+    }
+    catch (err) {
+        await rollbackFailedCommitAndPush(rootHandle, inFlightMeta, env);
+        throw err;
+    }
+}
+//# sourceMappingURL=squash-rebase-and-push.js.map

package/dist/executors/internal/squash-rebase-and-push.js.map

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

package/dist/executors/internal/staged-checkpoint-tree-result.d.ts

@@ -0,0 +1,13 @@
+import type { OversizedUntrackedBlobRecord } from '../git-checkpoint-payload.js';
+/**
+ * Staged checkpoint tree SHA and spilled oversized untracked blob metadata.
+ */
+export interface StagedCheckpointTreeResult {
+    /** Resolved `HEAD` commit SHA at the moment the checkpoint was staged. */
+    readonly headSha: string;
+    /** Root Git tree SHA produced by `git write-tree` on the temporary index. */
+    readonly treeSha: string;
+    /** Map of repository-relative untracked paths exceeding `maxUntrackedBytes` to spilled blob descriptors. */
+    readonly oversizedUntrackedBlobs: Readonly<Record<string, OversizedUntrackedBlobRecord>>;
+}
+//# sourceMappingURL=staged-checkpoint-tree-result.d.ts.map

package/dist/executors/internal/staged-checkpoint-tree-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staged-checkpoint-tree-result.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/staged-checkpoint-tree-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4GAA4G;IAC5G,QAAQ,CAAC,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC,CAAC;CAC1F"}

package/dist/executors/internal/staged-checkpoint-tree-result.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=staged-checkpoint-tree-result.js.map

package/dist/executors/internal/staged-checkpoint-tree-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staged-checkpoint-tree-result.js","sourceRoot":"","sources":["../../../src/executors/internal/staged-checkpoint-tree-result.ts"],"names":[],"mappings":""}

package/dist/executors/internal/stateless-merge-tree-result.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Stateless 3-way `git merge-tree --write-tree -z` execution result.
+ */
+export interface StatelessMergeTreeResult {
+    /** Whether the 3-way merge completed without file-level or content-level conflicts. */
+    readonly clean: boolean;
+    /** Top-level Git tree SHA synthesized by `git merge-tree --write-tree`. */
+    readonly mergedTreeSha: string;
+    /** Posix-normalized repository-relative paths that suffered 3-way merge conflicts. */
+    readonly conflictedPaths: readonly string[];
+}
+//# sourceMappingURL=stateless-merge-tree-result.d.ts.map

package/dist/executors/internal/stateless-merge-tree-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateless-merge-tree-result.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/stateless-merge-tree-result.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sFAAsF;IACtF,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C"}

package/dist/executors/internal/stateless-merge-tree-result.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stateless-merge-tree-result.js.map

package/dist/executors/internal/stateless-merge-tree-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateless-merge-tree-result.js","sourceRoot":"","sources":["../../../src/executors/internal/stateless-merge-tree-result.ts"],"names":[],"mappings":""}

package/dist/executors/internal/synthesized-working-tree-commit.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Synthesized tree SHA and commit SHA produced by staging a worktree's state into a temporary index.
+ */
+export interface SynthesizedWorkingTreeCommit {
+    /** Root Git tree SHA produced by `git write-tree` against the temporary index. */
+    readonly treeSha: string;
+    /** Synthesized Git commit SHA produced by `git commit-tree` over `parentCommitSha`. */
+    readonly commitSha: string;
+}
+//# sourceMappingURL=synthesized-working-tree-commit.d.ts.map

package/dist/executors/internal/synthesized-working-tree-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesized-working-tree-commit.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/synthesized-working-tree-commit.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/dist/executors/internal/synthesized-working-tree-commit.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=synthesized-working-tree-commit.js.map

package/dist/executors/internal/synthesized-working-tree-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesized-working-tree-commit.js","sourceRoot":"","sources":["../../../src/executors/internal/synthesized-working-tree-commit.ts"],"names":[],"mappings":""}

package/dist/executors/internal/worktree-integrity-verdict.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Worktree-local `.git` and `node_modules` integrity verification verdict.
+ */
+export interface WorktreeIntegrityVerdict {
+    /** Whether all worktree-local `.git` metadata and `node_modules` match the baseline checkpoint. */
+    readonly intact: boolean;
+    /** Human-readable description of the tampered artifact when `intact` is `false`. */
+    readonly reason?: string;
+}
+//# sourceMappingURL=worktree-integrity-verdict.d.ts.map

package/dist/executors/internal/worktree-integrity-verdict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-integrity-verdict.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/worktree-integrity-verdict.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mGAAmG;IACnG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,oFAAoF;IACpF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/executors/internal/worktree-integrity-verdict.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worktree-integrity-verdict.js.map

package/dist/executors/internal/worktree-integrity-verdict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-integrity-verdict.js","sourceRoot":"","sources":["../../../src/executors/internal/worktree-integrity-verdict.ts"],"names":[],"mappings":""}

package/dist/executors/internal/worktree-status-snapshot.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Structured porcelain v2 status snapshot returned by `computeWorktreeStatusMap`.
+ *
+ * Separates tracked/untracked dirty file digests (`statusMap`), untracked path keys (`untrackedPaths`),
+ * tracked deleted path keys (`deletedPaths`), and matched ignored paths (`ignoredPaths`).
+ */
+export interface WorktreeStatusSnapshot {
+    /** Map from repository-relative file path to `${mode}:${sha256}` (or `'DELETED'`). */
+    readonly statusMap: Readonly<Record<string, string>>;
+    /** Set of repository-relative paths reported as untracked (`?`). */
+    readonly untrackedPaths: ReadonlySet<string>;
+    /** Set of repository-relative tracked paths deleted in the working tree. */
+    readonly deletedPaths: ReadonlySet<string>;
+    /** List of ignored paths reported when `--ignored=matching` is active. */
+    readonly ignoredPaths: readonly string[];
+}
+//# sourceMappingURL=worktree-status-snapshot.d.ts.map

package/dist/executors/internal/worktree-status-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-status-snapshot.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/worktree-status-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,sFAAsF;IACtF,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,oEAAoE;IACpE,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7C,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C"}