@camaradesuk/git-worktree-tools 1.3.0 → 1.4.1

package/dist/e2e/helpers/scenario-harness.js

@@ -0,0 +1,360 @@
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+const DEFAULT_OPTIONS = {
+    baseBranch: 'main',
+    userEmail: 'test@test.com',
+    userName: 'Test User',
+};
+/**
+ * Execute a git command in a directory
+ */
+function git(args, cwd, options = {}) {
+    try {
+        return execSync(`git ${args}`, {
+            cwd,
+            encoding: 'utf8',
+            stdio: options.stdio || 'pipe',
+        }).trim();
+    }
+    catch (error) {
+        if (options.stdio === 'ignore') {
+            return '';
+        }
+        throw error;
+    }
+}
+/**
+ * Create base repository structure with origin
+ */
+function createBaseRepo(tempDir, options) {
+    const originPath = path.join(tempDir, 'origin.git');
+    const repoPath = path.join(tempDir, 'main-repo');
+    // Create bare origin
+    fs.mkdirSync(originPath);
+    git('init --bare', originPath);
+    // Create working repo
+    fs.mkdirSync(repoPath);
+    git('init', repoPath);
+    git(`config user.email "${options.userEmail}"`, repoPath);
+    git(`config user.name "${options.userName}"`, repoPath);
+    // Create initial commit
+    fs.writeFileSync(path.join(repoPath, 'README.md'), '# Test Repository\n');
+    git('add .', repoPath);
+    git('commit -m "Initial commit"', repoPath);
+    // Rename to main branch
+    git(`branch -M ${options.baseBranch}`, repoPath, { stdio: 'ignore' });
+    // Add origin and push
+    git(`remote add origin "${originPath}"`, repoPath);
+    git(`push -u origin ${options.baseBranch}`, repoPath, { stdio: 'ignore' });
+    return { repoPath, originPath };
+}
+/**
+ * Create Scenario 1: main_clean_same
+ * On main, same as origin/main, clean working tree
+ */
+function createMainCleanSame(tempDir, options) {
+    const { repoPath, originPath } = createBaseRepo(tempDir, options);
+    return {
+        scenario: 'main_clean_same',
+        repoPath,
+        originPath,
+        tempDir,
+        cleanup: () => fs.rmSync(tempDir, { recursive: true, force: true }),
+    };
+}
+/**
+ * Create Scenario 2a: main_staged_same
+ * On main, same as origin/main, has staged changes
+ */
+function createMainStagedSame(tempDir, options) {
+    const { repoPath, originPath } = createBaseRepo(tempDir, options);
+    // Create and stage a new file
+    fs.writeFileSync(path.join(repoPath, 'staged-file.ts'), 'export const x = 1;\n');
+    git('add staged-file.ts', repoPath);
+    return {
+        scenario: 'main_staged_same',
+        repoPath,
+        originPath,
+        tempDir,
+        cleanup: () => fs.rmSync(tempDir, { recursive: true, force: true }),
+    };
+}
+/**
+ * Create Scenario 2b: main_unstaged_same
+ * On main, same as origin/main, has unstaged changes
+ */
+function createMainUnstagedSame(tempDir, options) {
+    const { repoPath, originPath } = createBaseRepo(tempDir, options);
+    // Create an untracked file
+    fs.mkdirSync(path.join(repoPath, 'docs'), { recursive: true });
+    fs.writeFileSync(path.join(repoPath, 'docs', 'new-file.md'), '# New documentation\n');
+    return {
+        scenario: 'main_unstaged_same',
+        repoPath,
+        originPath,
+        tempDir,
+        cleanup: () => fs.rmSync(tempDir, { recursive: true, force: true }),
+    };
+}
+/**
+ * Create Scenario 2c: main_both_same
+ * On main, same as origin/main, has both staged and unstaged changes
+ */
+function createMainBothSame(tempDir, options) {
+    const { repoPath, originPath } = createBaseRepo(tempDir, options);
+    // Create and stage one file
+    fs.writeFileSync(path.join(repoPath, 'staged-file.ts'), 'export const staged = true;\n');
+    git('add staged-file.ts', repoPath);
+    // Create an untracked file
+    fs.writeFileSync(path.join(repoPath, 'unstaged-file.ts'), 'export const unstaged = true;\n');
+    return {
+        scenario: 'main_both_same',
+        repoPath,
+        originPath,
+        tempDir,
+        cleanup: () => fs.rmSync(tempDir, { recursive: true, force: true }),
+    };
+}
+/**
+ * Create Scenario 3: main_clean_ahead
+ * On main, ahead of origin/main, clean working tree
+ */
+function createMainCleanAhead(tempDir, options) {
+    const { repoPath, originPath } = createBaseRepo(tempDir, options);
+    // Create a local commit (not pushed)
+    fs.writeFileSync(path.join(repoPath, 'local-feature.ts'), 'export const feature = 1;\n');
+    git('add .', repoPath);
+    git('commit -m "Add local feature"', repoPath);
+    return {
+        scenario: 'main_clean_ahead',
+        repoPath,
+        originPath,
+        tempDir,
+        cleanup: () => fs.rmSync(tempDir, { recursive: true, force: true }),
+    };
+}
+/**
+ * Create Scenario 4: main_changes_ahead
+ * On main, ahead of origin/main, has uncommitted changes
+ */
+function createMainChangesAhead(tempDir, options) {
+    const { repoPath, originPath } = createBaseRepo(tempDir, options);
+    // Create a local commit (not pushed)
+    fs.writeFileSync(path.join(repoPath, 'local-feature.ts'), 'export const feature = 1;\n');
+    git('add .', repoPath);
+    git('commit -m "Add local feature"', repoPath);
+    // Create uncommitted changes
+    fs.writeFileSync(path.join(repoPath, 'work-in-progress.ts'), 'export const wip = true;\n');
+    return {
+        scenario: 'main_changes_ahead',
+        repoPath,
+        originPath,
+        tempDir,
+        cleanup: () => fs.rmSync(tempDir, { recursive: true, force: true }),
+    };
+}
+/**
+ * Create Scenario 5: branch_same_as_main
+ * On feature branch at same commit as main, clean
+ */
+function createBranchSameAsMain(tempDir, options) {
+    const { repoPath, originPath } = createBaseRepo(tempDir, options);
+    // Create a branch at the same commit as main
+    git('checkout -b feature-branch', repoPath);
+    return {
+        scenario: 'branch_same_as_main',
+        repoPath,
+        originPath,
+        tempDir,
+        cleanup: () => fs.rmSync(tempDir, { recursive: true, force: true }),
+    };
+}
+/**
+ * Create Scenario 6: branch_ancestor
+ * On feature branch that is already merged into main (ancestor)
+ */
+function createBranchAncestor(tempDir, options) {
+    const { repoPath, originPath } = createBaseRepo(tempDir, options);
+    // Create a feature branch
+    git('checkout -b old-feature', repoPath);
+    // Go back to main and add commits that include this branch's point
+    git(`checkout ${options.baseBranch}`, repoPath);
+    fs.writeFileSync(path.join(repoPath, 'new-main-feature.ts'), 'export const newer = 1;\n');
+    git('add .', repoPath);
+    git('commit -m "Add newer feature on main"', repoPath);
+    // Go back to the old feature branch (which is now an ancestor of main)
+    git('checkout old-feature', repoPath);
+    return {
+        scenario: 'branch_ancestor',
+        repoPath,
+        originPath,
+        tempDir,
+        cleanup: () => fs.rmSync(tempDir, { recursive: true, force: true }),
+    };
+}
+/**
+ * Create Scenario 7: branch_divergent
+ * On feature branch with commits not in main
+ */
+function createBranchDivergent(tempDir, options) {
+    const { repoPath, originPath } = createBaseRepo(tempDir, options);
+    // Create a feature branch with unique commits
+    git('checkout -b divergent-feature', repoPath);
+    fs.writeFileSync(path.join(repoPath, 'feature.ts'), 'export const feature = 1;\n');
+    git('add .', repoPath);
+    git('commit -m "Add feature"', repoPath);
+    return {
+        scenario: 'branch_divergent',
+        repoPath,
+        originPath,
+        tempDir,
+        cleanup: () => fs.rmSync(tempDir, { recursive: true, force: true }),
+    };
+}
+/**
+ * Create Scenario 8: branch_with_changes
+ * On feature branch with uncommitted changes
+ */
+function createBranchWithChanges(tempDir, options) {
+    const { repoPath, originPath } = createBaseRepo(tempDir, options);
+    // Create a feature branch with a commit
+    git('checkout -b feature-with-changes', repoPath);
+    fs.writeFileSync(path.join(repoPath, 'feature.ts'), 'export const feature = 1;\n');
+    git('add .', repoPath);
+    git('commit -m "Add feature"', repoPath);
+    // Add uncommitted changes
+    fs.writeFileSync(path.join(repoPath, 'wip.ts'), 'export const wip = true;\n');
+    return {
+        scenario: 'branch_with_changes',
+        repoPath,
+        originPath,
+        tempDir,
+        cleanup: () => fs.rmSync(tempDir, { recursive: true, force: true }),
+    };
+}
+/**
+ * Create Scenario 9: detached_head
+ * In detached HEAD state
+ */
+function createDetachedHead(tempDir, options) {
+    const { repoPath, originPath } = createBaseRepo(tempDir, options);
+    // Get current commit SHA
+    const sha = git('rev-parse HEAD', repoPath);
+    // Checkout the SHA directly (detached HEAD)
+    git(`checkout ${sha}`, repoPath, { stdio: 'ignore' });
+    return {
+        scenario: 'detached_head',
+        repoPath,
+        originPath,
+        tempDir,
+        cleanup: () => fs.rmSync(tempDir, { recursive: true, force: true }),
+    };
+}
+/**
+ * Create Scenario 10: pr_worktree
+ * Running from a PR worktree
+ */
+function createPrWorktree(tempDir, options) {
+    const { repoPath, originPath } = createBaseRepo(tempDir, options);
+    // Create a feature branch
+    git('checkout -b pr-feature', repoPath);
+    fs.writeFileSync(path.join(repoPath, 'feature.ts'), 'export const feature = 1;\n');
+    git('add .', repoPath);
+    git('commit -m "Add feature"', repoPath);
+    // Go back to main
+    git(`checkout ${options.baseBranch}`, repoPath);
+    // Create a worktree with PR naming pattern
+    const worktreePath = path.join(tempDir, 'main-repo.pr42');
+    git(`worktree add "${worktreePath}" pr-feature`, repoPath);
+    return {
+        scenario: 'pr_worktree',
+        repoPath,
+        originPath,
+        tempDir,
+        worktreePath,
+        cleanup: () => {
+            // Remove worktree first
+            try {
+                git('worktree prune', repoPath, { stdio: 'ignore' });
+            }
+            catch {
+                // Ignore
+            }
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        },
+    };
+}
+/**
+ * Create a git repository in a specific scenario state
+ *
+ * @param scenario - The scenario to create
+ * @param options - Configuration options
+ * @returns Setup information with cleanup function
+ */
+export function createScenario(scenario, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    // Create temp directory with proper path resolution for cross-platform
+    const tempDir = fs.realpathSync.native(fs.mkdtempSync(path.join(os.tmpdir(), `e2e-scenario-${scenario}-`)));
+    const creators = {
+        main_clean_same: createMainCleanSame,
+        main_staged_same: createMainStagedSame,
+        main_unstaged_same: createMainUnstagedSame,
+        main_both_same: createMainBothSame,
+        main_clean_ahead: createMainCleanAhead,
+        main_changes_ahead: createMainChangesAhead,
+        branch_same_as_main: createBranchSameAsMain,
+        branch_ancestor: createBranchAncestor,
+        branch_divergent: createBranchDivergent,
+        branch_with_changes: createBranchWithChanges,
+        detached_head: createDetachedHead,
+        pr_worktree: createPrWorktree,
+    };
+    const creator = creators[scenario];
+    if (!creator) {
+        throw new Error(`Unknown scenario: ${scenario}`);
+    }
+    return creator(tempDir, opts);
+}
+/**
+ * All available scenarios
+ */
+export const ALL_SCENARIOS = [
+    'main_clean_same',
+    'main_staged_same',
+    'main_unstaged_same',
+    'main_both_same',
+    'main_clean_ahead',
+    'main_changes_ahead',
+    'branch_same_as_main',
+    'branch_ancestor',
+    'branch_divergent',
+    'branch_with_changes',
+    'detached_head',
+    'pr_worktree',
+];
+/**
+ * Create all scenarios at once (useful for parallel testing)
+ *
+ * @param options - Configuration options
+ * @returns Map of scenario to setup
+ */
+export function createAllScenarios(options = {}) {
+    const setups = new Map();
+    for (const scenario of ALL_SCENARIOS) {
+        setups.set(scenario, createScenario(scenario, options));
+    }
+    return setups;
+}
+/**
+ * Clean up all scenarios from a map
+ *
+ * @param setups - Map of scenario setups to clean
+ */
+export function cleanupAllScenarios(setups) {
+    for (const setup of setups.values()) {
+        setup.cleanup();
+    }
+}
+//# sourceMappingURL=scenario-harness.js.map

package/dist/e2e/helpers/scenario-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-harness.js","sourceRoot":"","sources":["../../../src/e2e/helpers/scenario-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAiCpB,MAAM,eAAe,GAA8B;IACjD,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,eAAe;IAC1B,QAAQ,EAAE,WAAW;CACtB,CAAC;AAEF;;GAEG;AACH,SAAS,GAAG,CAAC,IAAY,EAAE,GAAW,EAAE,UAAyC,EAAE;IACjF,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE;YAC7B,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM;SAC/B,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CACrB,OAAe,EACf,OAAkC;IAKlC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAEjD,qBAAqB;IACrB,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACzB,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAE/B,sBAAsB;IACtB,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACvB,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtB,GAAG,CAAC,sBAAsB,OAAO,CAAC,SAAS,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1D,GAAG,CAAC,qBAAqB,OAAO,CAAC,QAAQ,GAAG,EAAE,QAAQ,CAAC,CAAC;IAExD,wBAAwB;IACxB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,qBAAqB,CAAC,CAAC;IAC1E,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvB,GAAG,CAAC,4BAA4B,EAAE,QAAQ,CAAC,CAAC;IAE5C,wBAAwB;IACxB,GAAG,CAAC,aAAa,OAAO,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEtE,sBAAsB;IACtB,GAAG,CAAC,sBAAsB,UAAU,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnD,GAAG,CAAC,kBAAkB,OAAO,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE3E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,OAAe,EAAE,OAAkC;IAC9E,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,OAAO;QACL,QAAQ,EAAE,iBAAiB;QAC3B,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,OAAe,EAAE,OAAkC;IAC/E,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,8BAA8B;IAC9B,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE,uBAAuB,CAAC,CAAC;IACjF,GAAG,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IAEpC,OAAO;QACL,QAAQ,EAAE,kBAAkB;QAC5B,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAC7B,OAAe,EACf,OAAkC;IAElC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,2BAA2B;IAC3B,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,uBAAuB,CAAC,CAAC;IAEtF,OAAO;QACL,QAAQ,EAAE,oBAAoB;QAC9B,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,OAAe,EAAE,OAAkC;IAC7E,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,4BAA4B;IAC5B,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE,+BAA+B,CAAC,CAAC;IACzF,GAAG,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IAEpC,2BAA2B;IAC3B,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,iCAAiC,CAAC,CAAC;IAE7F,OAAO;QACL,QAAQ,EAAE,gBAAgB;QAC1B,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,OAAe,EAAE,OAAkC;IAC/E,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,qCAAqC;IACrC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,6BAA6B,CAAC,CAAC;IACzF,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvB,GAAG,CAAC,+BAA+B,EAAE,QAAQ,CAAC,CAAC;IAE/C,OAAO;QACL,QAAQ,EAAE,kBAAkB;QAC5B,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAC7B,OAAe,EACf,OAAkC;IAElC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,qCAAqC;IACrC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,6BAA6B,CAAC,CAAC;IACzF,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvB,GAAG,CAAC,+BAA+B,EAAE,QAAQ,CAAC,CAAC;IAE/C,6BAA6B;IAC7B,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,EAAE,4BAA4B,CAAC,CAAC;IAE3F,OAAO;QACL,QAAQ,EAAE,oBAAoB;QAC9B,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAC7B,OAAe,EACf,OAAkC;IAElC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,6CAA6C;IAC7C,GAAG,CAAC,4BAA4B,EAAE,QAAQ,CAAC,CAAC;IAE5C,OAAO;QACL,QAAQ,EAAE,qBAAqB;QAC/B,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,OAAe,EAAE,OAAkC;IAC/E,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,0BAA0B;IAC1B,GAAG,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAC;IAEzC,mEAAmE;IACnE,GAAG,CAAC,YAAY,OAAO,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC,CAAC;IAChD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,EAAE,2BAA2B,CAAC,CAAC;IAC1F,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvB,GAAG,CAAC,uCAAuC,EAAE,QAAQ,CAAC,CAAC;IAEvD,uEAAuE;IACvE,GAAG,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IAEtC,OAAO;QACL,QAAQ,EAAE,iBAAiB;QAC3B,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAC,OAAe,EAAE,OAAkC;IAChF,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,8CAA8C;IAC9C,GAAG,CAAC,+BAA+B,EAAE,QAAQ,CAAC,CAAC;IAC/C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,6BAA6B,CAAC,CAAC;IACnF,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvB,GAAG,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAC;IAEzC,OAAO;QACL,QAAQ,EAAE,kBAAkB;QAC5B,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAC9B,OAAe,EACf,OAAkC;IAElC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,wCAAwC;IACxC,GAAG,CAAC,kCAAkC,EAAE,QAAQ,CAAC,CAAC;IAClD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,6BAA6B,CAAC,CAAC;IACnF,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvB,GAAG,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAC;IAEzC,0BAA0B;IAC1B,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,4BAA4B,CAAC,CAAC;IAE9E,OAAO;QACL,QAAQ,EAAE,qBAAqB;QAC/B,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,OAAe,EAAE,OAAkC;IAC7E,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,yBAAyB;IACzB,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IAE5C,4CAA4C;IAC5C,GAAG,CAAC,YAAY,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEtD,OAAO;QACL,QAAQ,EAAE,eAAe;QACzB,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,OAAe,EAAE,OAAkC;IAC3E,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAElE,0BAA0B;IAC1B,GAAG,CAAC,wBAAwB,EAAE,QAAQ,CAAC,CAAC;IACxC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,6BAA6B,CAAC,CAAC;IACnF,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvB,GAAG,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAC;IAEzC,kBAAkB;IAClB,GAAG,CAAC,YAAY,OAAO,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC,CAAC;IAEhD,2CAA2C;IAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAC1D,GAAG,CAAC,iBAAiB,YAAY,cAAc,EAAE,QAAQ,CAAC,CAAC;IAE3D,OAAO;QACL,QAAQ,EAAE,aAAa;QACvB,QAAQ;QACR,UAAU;QACV,OAAO;QACP,YAAY;QACZ,OAAO,EAAE,GAAG,EAAE;YACZ,wBAAwB;YACxB,IAAI,CAAC;gBACH,GAAG,CAAC,gBAAgB,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvD,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,QAAkB,EAAE,UAA2B,EAAE;IAC9E,MAAM,IAAI,GAA8B,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IAE3E,uEAAuE;IACvE,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CACpC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,gBAAgB,QAAQ,GAAG,CAAC,CAAC,CACpE,CAAC;IAEF,MAAM,QAAQ,GAGV;QACF,eAAe,EAAE,mBAAmB;QACpC,gBAAgB,EAAE,oBAAoB;QACtC,kBAAkB,EAAE,sBAAsB;QAC1C,cAAc,EAAE,kBAAkB;QAClC,gBAAgB,EAAE,oBAAoB;QACtC,kBAAkB,EAAE,sBAAsB;QAC1C,mBAAmB,EAAE,sBAAsB;QAC3C,eAAe,EAAE,oBAAoB;QACrC,gBAAgB,EAAE,qBAAqB;QACvC,mBAAmB,EAAE,uBAAuB;QAC5C,aAAa,EAAE,kBAAkB;QACjC,WAAW,EAAE,gBAAgB;KAC9B,CAAC;IAEF,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB;IAChD,iBAAiB;IACjB,kBAAkB;IAClB,oBAAoB;IACpB,gBAAgB;IAChB,kBAAkB;IAClB,oBAAoB;IACpB,qBAAqB;IACrB,iBAAiB;IACjB,kBAAkB;IAClB,qBAAqB;IACrB,eAAe;IACf,aAAa;CACL,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA2B,EAAE;IAC9D,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAElD,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAoC;IACtE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/e2e/helpers/test-context.d.ts

@@ -0,0 +1,120 @@
+import type { Scenario } from '../../lib/state-detection.js';
+import { type GhMockSetup, type GhMockOptions } from './gh-mock.js';
+import { type ScenarioOptions } from './scenario-harness.js';
+/**
+ * Options for creating a test context
+ */
+export interface TestContextOptions {
+    /** Scenario to create (if provided, creates a scenario-specific repo) */
+    scenario?: Scenario;
+    /** Options for the scenario */
+    scenarioOptions?: ScenarioOptions;
+    /** Options for the gh mock */
+    ghMockOptions?: GhMockOptions;
+    /** Skip the gh mock (for tests that don't need it) */
+    skipGhMock?: boolean;
+    /** Create a bare minimum repo instead of a full scenario */
+    minimalRepo?: boolean;
+}
+/**
+ * Test context containing all test resources
+ */
+export interface TestContext {
+    /** Temp directory containing all test resources */
+    tempDir: string;
+    /** Path to the test repository */
+    repoDir: string;
+    /** Path to the origin (bare) repository */
+    originDir?: string;
+    /** Path to worktree (if created) */
+    worktreeDir?: string;
+    /** The scenario that was created (if any) */
+    scenario?: Scenario;
+    /** The gh mock setup */
+    ghMock?: GhMockSetup;
+    /** Environment variables to use when running CLI commands */
+    env: NodeJS.ProcessEnv;
+    /** Clean up all resources */
+    cleanup: () => void;
+    /** Reset the repo to a clean state */
+    reset: () => void;
+}
+/**
+ * Create a test context with isolated resources
+ *
+ * @param options - Context options
+ * @returns Test context with cleanup
+ */
+export declare function createTestContext(options?: TestContextOptions): TestContext;
+/**
+ * Vitest fixture factory for test contexts
+ *
+ * Usage:
+ * ```typescript
+ * describe('my tests', () => {
+ *   let ctx: TestContext;
+ *
+ *   beforeAll(() => {
+ *     ctx = createTestContext({ scenario: 'main_clean_same' });
+ *   });
+ *
+ *   afterAll(() => {
+ *     ctx.cleanup();
+ *   });
+ *
+ *   beforeEach(() => {
+ *     ctx.reset();
+ *   });
+ * });
+ * ```
+ */
+export declare function useTestContext(options?: TestContextOptions): {
+    create: () => TestContext;
+    cleanup: (ctx: TestContext) => void;
+    reset: (ctx: TestContext) => void;
+};
+/**
+ * Create multiple test contexts for different scenarios
+ *
+ * @param scenarios - List of scenarios to create
+ * @param options - Common options for all contexts
+ * @returns Map of scenario to context
+ */
+export declare function createMultiScenarioContexts(scenarios: Scenario[], options?: Omit<TestContextOptions, 'scenario'>): Map<Scenario, TestContext>;
+/**
+ * Clean up all contexts from a map
+ *
+ * @param contexts - Map of contexts to clean up
+ */
+export declare function cleanupAllContexts(contexts: Map<Scenario, TestContext>): void;
+/**
+ * Helper to add a file to the test repo
+ */
+export declare function addFile(ctx: TestContext, relativePath: string, content: string, options?: {
+    stage?: boolean;
+    commit?: boolean;
+    message?: string;
+}): void;
+/**
+ * Helper to create a branch in the test repo
+ */
+export declare function createBranch(ctx: TestContext, branchName: string, options?: {
+    checkout?: boolean;
+    from?: string;
+}): void;
+/**
+ * Helper to create a worktree in the test repo
+ */
+export declare function createWorktree(ctx: TestContext, worktreePath: string, branchName: string, options?: {
+    create?: boolean;
+}): string;
+/**
+ * Helper to get git status info
+ */
+export declare function getGitStatus(ctx: TestContext): {
+    branch: string;
+    staged: string[];
+    unstaged: string[];
+    untracked: string[];
+};
+//# sourceMappingURL=test-context.d.ts.map

package/dist/e2e/helpers/test-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-context.d.ts","sourceRoot":"","sources":["../../../src/e2e/helpers/test-context.ts"],"names":[],"mappings":"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"}