@vibe-validate/git 0.9.0

package/README.md

@@ -0,0 +1,136 @@
+# @vibe-validate/git
+
+Git utilities for vibe-validate - deterministic tree hash calculation, branch synchronization, and post-merge cleanup.
+
+## Features
+
+- **Deterministic Git Tree Hash**: Content-based hashing using `git write-tree` (no timestamps)
+- **Branch Sync Checking**: Safe branch synchronization verification without auto-merging
+- **Post-Merge Cleanup**: Automated cleanup of merged branches after PR completion
+
+## Installation
+
+```bash
+npm install @vibe-validate/git
+```
+
+## Usage
+
+### Git Tree Hash (Deterministic)
+
+Calculate a content-based hash of the working tree including staged, unstaged, and untracked files:
+
+```typescript
+import { getGitTreeHash } from '@vibe-validate/git';
+
+const treeHash = await getGitTreeHash();
+console.log(`Tree hash: ${treeHash}`);
+// Deterministic - same content = same hash (no timestamp variance)
+```
+
+### Branch Sync Checking
+
+Check if the current branch is behind origin/main without auto-merging:
+
+```typescript
+import { BranchSyncChecker } from '@vibe-validate/git';
+
+const checker = new BranchSyncChecker();
+const result = await checker.checkSync();
+
+if (!result.isUpToDate) {
+  console.log(`Branch is ${result.behindBy} commits behind origin/main`);
+  console.log('Manual merge required');
+}
+```
+
+### Post-Merge Cleanup
+
+Clean up local branches after PR merge:
+
+```typescript
+import { PostPRMergeCleanup } from '@vibe-validate/git';
+
+const cleanup = new PostPRMergeCleanup();
+const result = await cleanup.runCleanup();
+
+console.log(`Deleted ${result.branchesDeleted.length} merged branches`);
+```
+
+## API Reference
+
+### `getGitTreeHash()`
+
+Returns a deterministic content-based hash of the working tree.
+
+**Implementation Details:**
+- Uses `git add --intent-to-add .` to mark untracked files (without staging)
+- Uses `git write-tree` for content-based hashing (no timestamps)
+- Resets index after hash calculation
+- Falls back to `HEAD^{tree}` if no changes exist
+
+**Returns:** `Promise<string>` - Git tree SHA-1 hash
+
+### `BranchSyncChecker`
+
+Class for checking branch synchronization status.
+
+**Methods:**
+- `checkSync()`: Check if current branch is behind origin/main
+- `printStatus(result)`: Display formatted status information
+- `getExitCode(result)`: Get appropriate exit code (0=ok, 1=needs merge, 2=error)
+
+### `PostPRMergeCleanup`
+
+Class for post-merge cleanup operations.
+
+**Methods:**
+- `runCleanup()`: Execute complete cleanup workflow
+  1. Switch to main branch
+  2. Sync main with origin/main
+  3. Delete merged branches
+  4. Prune remote references
+
+## Design Decisions
+
+### Deterministic Git Tree Hash
+
+**Problem**: `git stash create` includes timestamps, making hashes non-deterministic.
+
+**Solution**: Use `git write-tree` with intent-to-add for untracked files:
+
+```typescript
+// Old approach (non-deterministic - includes timestamps)
+git stash create  // Different hash on each run even with same content
+
+// New approach (deterministic - content-based only)
+git add --intent-to-add .  // Mark untracked files (no staging)
+git write-tree              // Content-based hash (no timestamps)
+git reset                   // Restore index to clean state
+```
+
+**Benefits:**
+- Same content always produces same hash
+- Enables reliable validation state caching
+- Includes all files (staged, unstaged, untracked)
+- No side effects (index restored after hash)
+
+### Safe Branch Sync
+
+**Philosophy**: Never auto-merge. Always require manual conflict resolution.
+
+**Why:**
+- Preserves visibility of conflicts
+- Prevents accidental code overwrites
+- Explicit developer control over merges
+
+### Post-Merge Cleanup
+
+**Safety Features:**
+- Only deletes branches confirmed merged into main
+- Never deletes main branch
+- Provides clear feedback on all operations
+
+## License
+
+MIT

package/dist/branch-sync.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Smart Branch Sync Checker
+ *
+ * Safely checks if the current branch is behind a remote branch without auto-merging.
+ * Provides clear status reporting and next-step instructions.
+ *
+ * Key safety features:
+ * - Never auto-merges (preserves conflict visibility)
+ * - Clear exit codes for CI/agent integration
+ * - Explicit instructions when manual intervention needed
+ * - Cross-platform compatibility
+ */
+declare const GIT_OPTIONS: {
+    timeout: number;
+    encoding: "utf8";
+    maxBuffer: number;
+};
+export interface SyncCheckResult {
+    isUpToDate: boolean;
+    behindBy: number;
+    currentBranch: string;
+    hasRemote: boolean;
+    error?: string;
+}
+export type ExecAsyncFunction = (command: string, options: typeof GIT_OPTIONS) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export interface SyncCheckOptions {
+    remoteBranch?: string;
+    execAsync?: ExecAsyncFunction;
+}
+/**
+ * Branch Sync Checker
+ *
+ * Checks if current branch is behind a remote branch
+ */
+export declare class BranchSyncChecker {
+    private readonly remoteBranch;
+    private readonly execAsync;
+    constructor(options?: SyncCheckOptions);
+    /**
+     * Check if the current branch is synchronized with remote branch
+     *
+     * @returns Promise resolving to sync status information
+     */
+    checkSync(): Promise<SyncCheckResult>;
+    private getCurrentBranch;
+    private hasRemoteBranch;
+    private fetchRemote;
+    private getCommitsBehind;
+    /**
+     * Get appropriate exit code based on sync result
+     *
+     * @param result - The sync check result
+     * @returns Exit code (0=success, 1=needs merge, 2=error)
+     */
+    getExitCode(result: SyncCheckResult): number;
+}
+/**
+ * Convenience function for quick sync checking
+ *
+ * @param options - Sync check options
+ * @returns Sync check result
+ */
+export declare function checkBranchSync(options?: SyncCheckOptions): Promise<SyncCheckResult>;
+export {};
+//# sourceMappingURL=branch-sync.d.ts.map

package/dist/branch-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-sync.d.ts","sourceRoot":"","sources":["../src/branch-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,QAAA,MAAM,WAAW;;;;CAIhB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,WAAW,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE9H,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;gBAElC,OAAO,GAAE,gBAAqB;IAK1C;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;YA0C7B,gBAAgB;YAUhB,eAAe;YASf,WAAW;YAUX,gBAAgB;IAW9B;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM;CAK7C;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAG9F"}

package/dist/branch-sync.js

@@ -0,0 +1,139 @@
+/**
+ * Smart Branch Sync Checker
+ *
+ * Safely checks if the current branch is behind a remote branch without auto-merging.
+ * Provides clear status reporting and next-step instructions.
+ *
+ * Key safety features:
+ * - Never auto-merges (preserves conflict visibility)
+ * - Clear exit codes for CI/agent integration
+ * - Explicit instructions when manual intervention needed
+ * - Cross-platform compatibility
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const GIT_TIMEOUT = 10000; // 10 seconds timeout for git operations
+const GIT_OPTIONS = {
+    timeout: GIT_TIMEOUT,
+    encoding: 'utf8',
+    maxBuffer: 1024 * 1024 // 1MB buffer
+};
+/**
+ * Branch Sync Checker
+ *
+ * Checks if current branch is behind a remote branch
+ */
+export class BranchSyncChecker {
+    remoteBranch;
+    execAsync;
+    constructor(options = {}) {
+        this.remoteBranch = options.remoteBranch || 'origin/main';
+        this.execAsync = options.execAsync || promisify(exec);
+    }
+    /**
+     * Check if the current branch is synchronized with remote branch
+     *
+     * @returns Promise resolving to sync status information
+     */
+    async checkSync() {
+        try {
+            // Get current branch name
+            const currentBranch = await this.getCurrentBranch();
+            // Check if remote branch exists
+            const hasRemote = await this.hasRemoteBranch();
+            if (!hasRemote) {
+                return {
+                    isUpToDate: true,
+                    behindBy: 0,
+                    currentBranch,
+                    hasRemote: false,
+                    error: `No remote branch ${this.remoteBranch} found`
+                };
+            }
+            // Fetch latest from remote
+            await this.fetchRemote();
+            // Check how many commits behind
+            const behindBy = await this.getCommitsBehind();
+            return {
+                isUpToDate: behindBy === 0,
+                behindBy,
+                currentBranch,
+                hasRemote: true
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                isUpToDate: false,
+                behindBy: -1,
+                currentBranch: 'unknown',
+                hasRemote: false,
+                error: errorMessage
+            };
+        }
+    }
+    async getCurrentBranch() {
+        try {
+            const { stdout } = await this.execAsync('git rev-parse --abbrev-ref HEAD', GIT_OPTIONS);
+            return stdout.trim();
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Not in a git repository or unable to determine current branch: ${errorMessage}`);
+        }
+    }
+    async hasRemoteBranch() {
+        try {
+            await this.execAsync(`git rev-parse --verify ${this.remoteBranch}`, GIT_OPTIONS);
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    async fetchRemote() {
+        try {
+            const [remote, branch] = this.remoteBranch.split('/');
+            await this.execAsync(`git fetch --quiet ${remote} ${branch}`, GIT_OPTIONS);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to fetch from ${this.remoteBranch}: ${errorMessage}`);
+        }
+    }
+    async getCommitsBehind() {
+        try {
+            const { stdout } = await this.execAsync(`git rev-list --count HEAD..${this.remoteBranch}`, GIT_OPTIONS);
+            const count = parseInt(stdout.trim(), 10);
+            return isNaN(count) ? 0 : count;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to check commits behind: ${errorMessage}`);
+        }
+    }
+    /**
+     * Get appropriate exit code based on sync result
+     *
+     * @param result - The sync check result
+     * @returns Exit code (0=success, 1=needs merge, 2=error)
+     */
+    getExitCode(result) {
+        if (result.error)
+            return 2; // Error condition
+        if (!result.hasRemote)
+            return 0; // No remote, consider OK
+        return result.isUpToDate ? 0 : 1; // 0 = up to date, 1 = needs merge
+    }
+}
+/**
+ * Convenience function for quick sync checking
+ *
+ * @param options - Sync check options
+ * @returns Sync check result
+ */
+export async function checkBranchSync(options = {}) {
+    const checker = new BranchSyncChecker(options);
+    return checker.checkSync();
+}
+//# sourceMappingURL=branch-sync.js.map

package/dist/branch-sync.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @vibe-validate/git
+ *
+ * Git utilities for vibe-validate - deterministic tree hash calculation,
+ * branch synchronization, and post-merge cleanup.
+ *
+ * @packageDocumentation
+ */
+export { getGitTreeHash, getHeadTreeHash, hasWorkingTreeChanges } from './tree-hash.js';
+export { BranchSyncChecker, checkBranchSync, type SyncCheckResult, type SyncCheckOptions } from './branch-sync.js';
+export { PostPRMergeCleanup, cleanupMergedBranches, type CleanupResult, type CleanupOptions } from './post-merge-cleanup.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,cAAc,EACd,eAAe,EACf,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @vibe-validate/git
+ *
+ * Git utilities for vibe-validate - deterministic tree hash calculation,
+ * branch synchronization, and post-merge cleanup.
+ *
+ * @packageDocumentation
+ */
+// Tree hash calculation (deterministic, content-based)
+export { getGitTreeHash, getHeadTreeHash, hasWorkingTreeChanges } from './tree-hash.js';
+// Branch sync checking (safe, no auto-merge)
+export { BranchSyncChecker, checkBranchSync } from './branch-sync.js';
+// Post-merge cleanup (delete merged branches)
+export { PostPRMergeCleanup, cleanupMergedBranches } from './post-merge-cleanup.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uDAAuD;AACvD,OAAO,EACL,cAAc,EACd,eAAe,EACf,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,6CAA6C;AAC7C,OAAO,EACL,iBAAiB,EACjB,eAAe,EAGhB,MAAM,kBAAkB,CAAC;AAE1B,8CAA8C;AAC9C,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EAGtB,MAAM,yBAAyB,CAAC"}

package/dist/post-merge-cleanup.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Post-PR Merge Cleanup Tool
+ *
+ * Comprehensive post-PR cleanup workflow that:
+ * 1. Switches to main branch
+ * 2. Syncs main branch with remote origin
+ * 3. Deletes local branches that have been merged
+ * 4. Provides clean workspace for next PR
+ *
+ * Safe operations:
+ * - Only deletes branches that are confirmed merged
+ * - Never deletes the current main branch or unmerged branches
+ * - Provides clear feedback on all actions taken
+ */
+export interface CleanupResult {
+    success: boolean;
+    error?: string;
+    branchesDeleted: string[];
+    currentBranch: string;
+    mainSynced: boolean;
+}
+export interface CleanupOptions {
+    mainBranch?: string;
+    remoteName?: string;
+    dryRun?: boolean;
+}
+/**
+ * Post-PR Merge Cleanup
+ *
+ * Cleans up merged branches and syncs main branch after PR merge
+ */
+export declare class PostPRMergeCleanup {
+    private readonly mainBranch;
+    private readonly remoteName;
+    private readonly dryRun;
+    constructor(options?: CleanupOptions);
+    /**
+     * Run comprehensive post-PR merge cleanup workflow
+     */
+    runCleanup(): Promise<CleanupResult>;
+    /**
+     * Get the current git branch name
+     */
+    private getCurrentBranch;
+    /**
+     * Switch to main branch
+     */
+    private switchToMain;
+    /**
+     * Sync main branch with remote origin
+     */
+    private syncMainBranch;
+    /**
+     * Fetch remote branch information
+     */
+    private fetchRemoteInfo;
+    /**
+     * Find and delete branches that have been merged
+     */
+    private deleteMergedBranches;
+    /**
+     * Check if a branch has been merged into main
+     */
+    private isBranchMerged;
+    /**
+     * Clean up remote tracking references
+     */
+    private pruneRemoteReferences;
+}
+/**
+ * Convenience function for quick cleanup
+ *
+ * @param options - Cleanup options
+ * @returns Cleanup result
+ */
+export declare function cleanupMergedBranches(options?: CleanupOptions): Promise<CleanupResult>;
+//# sourceMappingURL=post-merge-cleanup.d.ts.map

package/dist/post-merge-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-merge-cleanup.d.ts","sourceRoot":"","sources":["../src/post-merge-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,GAAE,cAAmB;IAMxC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC;IAqC1C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkD5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAW9B;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAGhG"}

package/dist/post-merge-cleanup.js

@@ -0,0 +1,221 @@
+/**
+ * Post-PR Merge Cleanup Tool
+ *
+ * Comprehensive post-PR cleanup workflow that:
+ * 1. Switches to main branch
+ * 2. Syncs main branch with remote origin
+ * 3. Deletes local branches that have been merged
+ * 4. Provides clean workspace for next PR
+ *
+ * Safe operations:
+ * - Only deletes branches that are confirmed merged
+ * - Never deletes the current main branch or unmerged branches
+ * - Provides clear feedback on all actions taken
+ */
+import { execSync } from 'child_process';
+const TIMEOUT = 30000; // 30 seconds timeout for git operations
+/**
+ * Post-PR Merge Cleanup
+ *
+ * Cleans up merged branches and syncs main branch after PR merge
+ */
+export class PostPRMergeCleanup {
+    mainBranch;
+    remoteName;
+    dryRun;
+    constructor(options = {}) {
+        this.mainBranch = options.mainBranch || 'main';
+        this.remoteName = options.remoteName || 'origin';
+        this.dryRun = options.dryRun || false;
+    }
+    /**
+     * Run comprehensive post-PR merge cleanup workflow
+     */
+    async runCleanup() {
+        const result = {
+            success: false,
+            branchesDeleted: [],
+            currentBranch: '',
+            mainSynced: false
+        };
+        try {
+            // Step 1: Get current branch
+            result.currentBranch = this.getCurrentBranch();
+            // Step 2: Switch to main branch
+            this.switchToMain();
+            // Step 3: Sync main branch with remote
+            this.syncMainBranch();
+            result.mainSynced = true;
+            // Step 4: Fetch remote branch information
+            this.fetchRemoteInfo();
+            // Step 5: Find and delete merged branches
+            result.branchesDeleted = this.deleteMergedBranches();
+            // Step 6: Clean up remote tracking branches
+            this.pruneRemoteReferences();
+            result.success = true;
+            return result;
+        }
+        catch (error) {
+            result.error = error instanceof Error ? error.message : String(error);
+            return result;
+        }
+    }
+    /**
+     * Get the current git branch name
+     */
+    getCurrentBranch() {
+        try {
+            return execSync('git branch --show-current', {
+                encoding: 'utf8',
+                timeout: TIMEOUT
+            }).trim();
+        }
+        catch (error) {
+            throw new Error(`Failed to get current branch: ${error}`);
+        }
+    }
+    /**
+     * Switch to main branch
+     */
+    switchToMain() {
+        try {
+            execSync(`git checkout ${this.mainBranch}`, {
+                encoding: 'utf8',
+                timeout: TIMEOUT,
+                stdio: ['pipe', 'pipe', 'pipe']
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to switch to ${this.mainBranch} branch: ${error}`);
+        }
+    }
+    /**
+     * Sync main branch with remote origin
+     */
+    syncMainBranch() {
+        try {
+            // Fetch latest changes from remote
+            execSync(`git fetch ${this.remoteName} ${this.mainBranch}`, {
+                encoding: 'utf8',
+                timeout: TIMEOUT,
+                stdio: ['pipe', 'pipe', 'pipe']
+            });
+            // Fast-forward merge remote/main
+            execSync(`git merge ${this.remoteName}/${this.mainBranch} --ff-only`, {
+                encoding: 'utf8',
+                timeout: TIMEOUT,
+                stdio: ['pipe', 'pipe', 'pipe']
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to sync ${this.mainBranch} branch: ${error}`);
+        }
+    }
+    /**
+     * Fetch remote branch information
+     */
+    fetchRemoteInfo() {
+        try {
+            execSync(`git fetch ${this.remoteName} --prune`, {
+                encoding: 'utf8',
+                timeout: TIMEOUT,
+                stdio: ['pipe', 'pipe', 'pipe']
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch remote info: ${error}`);
+        }
+    }
+    /**
+     * Find and delete branches that have been merged
+     */
+    deleteMergedBranches() {
+        try {
+            // Get list of local branches (excluding main)
+            const allBranches = execSync('git branch --format="%(refname:short)"', {
+                encoding: 'utf8',
+                timeout: TIMEOUT
+            })
+                .trim()
+                .split('\n')
+                .filter(branch => branch && branch !== this.mainBranch && !branch.startsWith('*'));
+            const deletedBranches = [];
+            for (const branch of allBranches) {
+                if (this.isBranchMerged(branch)) {
+                    if (this.dryRun) {
+                        deletedBranches.push(branch);
+                        continue;
+                    }
+                    try {
+                        execSync(`git branch -d "${branch}"`, {
+                            encoding: 'utf8',
+                            timeout: TIMEOUT,
+                            stdio: ['pipe', 'pipe', 'pipe']
+                        });
+                        deletedBranches.push(branch);
+                    }
+                    catch (deleteError) {
+                        // Try force delete if regular delete fails
+                        try {
+                            execSync(`git branch -D "${branch}"`, {
+                                encoding: 'utf8',
+                                timeout: TIMEOUT,
+                                stdio: ['pipe', 'pipe', 'pipe']
+                            });
+                            deletedBranches.push(branch);
+                        }
+                        catch (forceDeleteError) {
+                            // Couldn't delete - skip this branch
+                        }
+                    }
+                }
+            }
+            return deletedBranches;
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * Check if a branch has been merged into main
+     */
+    isBranchMerged(branch) {
+        try {
+            const mergedBranches = execSync(`git branch --merged ${this.mainBranch} --format="%(refname:short)"`, {
+                encoding: 'utf8',
+                timeout: TIMEOUT
+            });
+            return mergedBranches.includes(branch);
+        }
+        catch (error) {
+            // If we can't determine merge status, don't delete the branch
+            return false;
+        }
+    }
+    /**
+     * Clean up remote tracking references
+     */
+    pruneRemoteReferences() {
+        try {
+            execSync(`git remote prune ${this.remoteName}`, {
+                encoding: 'utf8',
+                timeout: TIMEOUT,
+                stdio: ['pipe', 'pipe', 'pipe']
+            });
+        }
+        catch (error) {
+            // Non-critical operation - don't fail on error
+        }
+    }
+}
+/**
+ * Convenience function for quick cleanup
+ *
+ * @param options - Cleanup options
+ * @returns Cleanup result
+ */
+export async function cleanupMergedBranches(options = {}) {
+    const cleanup = new PostPRMergeCleanup(options);
+    return cleanup.runCleanup();
+}
+//# sourceMappingURL=post-merge-cleanup.js.map

package/dist/post-merge-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-merge-cleanup.js","sourceRoot":"","sources":["../src/post-merge-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,wCAAwC;AAgB/D;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IACZ,UAAU,CAAS;IACnB,UAAU,CAAS;IACnB,MAAM,CAAU;IAEjC,YAAY,UAA0B,EAAE;QACtC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,MAAM,GAAkB;YAC5B,OAAO,EAAE,KAAK;YACd,eAAe,EAAE,EAAE;YACnB,aAAa,EAAE,EAAE;YACjB,UAAU,EAAE,KAAK;SAClB,CAAC;QAEF,IAAI,CAAC;YACH,6BAA6B;YAC7B,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAE/C,gCAAgC;YAChC,IAAI,CAAC,YAAY,EAAE,CAAC;YAEpB,uCAAuC;YACvC,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;YAEzB,0CAA0C;YAC1C,IAAI,CAAC,eAAe,EAAE,CAAC;YAEvB,0CAA0C;YAC1C,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAErD,4CAA4C;YAC5C,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAE7B,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,OAAO,MAAM,CAAC;QAEhB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,2BAA2B,EAAE;gBAC3C,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,YAAY;QAClB,IAAI,CAAC;YACH,QAAQ,CAAC,gBAAgB,IAAI,CAAC,UAAU,EAAE,EAAE;gBAC1C,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,UAAU,YAAY,KAAK,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc;QACpB,IAAI,CAAC;YACH,mCAAmC;YACnC,QAAQ,CAAC,aAAa,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE;gBAC1D,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;YAEH,iCAAiC;YACjC,QAAQ,CAAC,aAAa,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,YAAY,EAAE;gBACpE,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;QAEL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,UAAU,YAAY,KAAK,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe;QACrB,IAAI,CAAC;YACH,QAAQ,CAAC,aAAa,IAAI,CAAC,UAAU,UAAU,EAAE;gBAC/C,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,oBAAoB;QAC1B,IAAI,CAAC;YACH,8CAA8C;YAC9C,MAAM,WAAW,GAAG,QAAQ,CAAC,wCAAwC,EAAE;gBACrE,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,OAAO;aACjB,CAAC;iBACC,IAAI,EAAE;iBACN,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,MAAM,KAAK,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAErF,MAAM,eAAe,GAAa,EAAE,CAAC;YAErC,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;gBACjC,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;oBAChC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;wBAChB,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;wBAC7B,SAAS;oBACX,CAAC;oBAED,IAAI,CAAC;wBACH,QAAQ,CAAC,kBAAkB,MAAM,GAAG,EAAE;4BACpC,QAAQ,EAAE,MAAM;4BAChB,OAAO,EAAE,OAAO;4BAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;yBAChC,CAAC,CAAC;wBACH,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC/B,CAAC;oBAAC,OAAO,WAAW,EAAE,CAAC;wBACrB,2CAA2C;wBAC3C,IAAI,CAAC;4BACH,QAAQ,CAAC,kBAAkB,MAAM,GAAG,EAAE;gCACpC,QAAQ,EAAE,MAAM;gCAChB,OAAO,EAAE,OAAO;gCAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;6BAChC,CAAC,CAAC;4BACH,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;wBAC/B,CAAC;wBAAC,OAAO,gBAAgB,EAAE,CAAC;4BAC1B,qCAAqC;wBACvC,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,eAAe,CAAC;QAEzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,MAAc;QACnC,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,QAAQ,CAAC,uBAAuB,IAAI,CAAC,UAAU,8BAA8B,EAAE;gBACpG,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC;YAEH,OAAO,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,8DAA8D;YAC9D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACK,qBAAqB;QAC3B,IAAI,CAAC;YACH,QAAQ,CAAC,oBAAoB,IAAI,CAAC,UAAU,EAAE,EAAE;gBAC9C,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+CAA+C;QACjD,CAAC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,UAA0B,EAAE;IACtE,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO,OAAO,CAAC,UAAU,EAAE,CAAC;AAC9B,CAAC"}

package/dist/tree-hash.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Deterministic Git Tree Hash Calculation
+ *
+ * Provides content-based hashing of working tree state including:
+ * - Staged changes (index)
+ * - Unstaged changes (working tree modifications)
+ * - Untracked files
+ *
+ * CRITICAL FIX: Uses git write-tree instead of git stash create for determinism.
+ * git stash create includes timestamps, making hashes non-deterministic.
+ * git write-tree produces content-based hashes only (no timestamps).
+ */
+/**
+ * Get deterministic git tree hash representing current working tree state
+ *
+ * Implementation:
+ * 1. Mark untracked files with --intent-to-add (no actual staging)
+ * 2. Calculate tree hash with git write-tree (content-based, no timestamps)
+ * 3. Reset index to clean state (no side effects)
+ *
+ * Why this is better than git stash create:
+ * - git stash create: includes timestamps in commit → different hash each time
+ * - git write-tree: content-based only → same content = same hash (deterministic)
+ *
+ * @returns Git tree SHA-1 hash (40 hex characters)
+ * @throws Error if not in a git repository or git command fails
+ */
+export declare function getGitTreeHash(): Promise<string>;
+/**
+ * Get tree hash for HEAD commit (committed state only, no working tree changes)
+ *
+ * This is useful for comparing committed state vs working tree state.
+ *
+ * @returns Git tree SHA-1 hash of HEAD commit
+ * @throws Error if not in a git repository or HEAD doesn't exist
+ */
+export declare function getHeadTreeHash(): Promise<string>;
+/**
+ * Check if working tree has any changes compared to HEAD
+ *
+ * @returns true if working tree differs from HEAD, false if clean
+ */
+export declare function hasWorkingTreeChanges(): Promise<boolean>;
+//# sourceMappingURL=tree-hash.d.ts.map

package/dist/tree-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-hash.d.ts","sourceRoot":"","sources":["../src/tree-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CA6CtD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAQvD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAS9D"}

package/dist/tree-hash.js

@@ -0,0 +1,110 @@
+/**
+ * Deterministic Git Tree Hash Calculation
+ *
+ * Provides content-based hashing of working tree state including:
+ * - Staged changes (index)
+ * - Unstaged changes (working tree modifications)
+ * - Untracked files
+ *
+ * CRITICAL FIX: Uses git write-tree instead of git stash create for determinism.
+ * git stash create includes timestamps, making hashes non-deterministic.
+ * git write-tree produces content-based hashes only (no timestamps).
+ */
+import { execSync } from 'child_process';
+const GIT_TIMEOUT = 10000; // 10 seconds
+const GIT_OPTIONS = {
+    encoding: 'utf8',
+    timeout: GIT_TIMEOUT,
+    stdio: ['pipe', 'pipe', 'ignore'],
+};
+/**
+ * Get deterministic git tree hash representing current working tree state
+ *
+ * Implementation:
+ * 1. Mark untracked files with --intent-to-add (no actual staging)
+ * 2. Calculate tree hash with git write-tree (content-based, no timestamps)
+ * 3. Reset index to clean state (no side effects)
+ *
+ * Why this is better than git stash create:
+ * - git stash create: includes timestamps in commit → different hash each time
+ * - git write-tree: content-based only → same content = same hash (deterministic)
+ *
+ * @returns Git tree SHA-1 hash (40 hex characters)
+ * @throws Error if not in a git repository or git command fails
+ */
+export async function getGitTreeHash() {
+    try {
+        // Check if we're in a git repository
+        execSync('git rev-parse --is-inside-work-tree', GIT_OPTIONS);
+        // Step 1: Mark all untracked files with --intent-to-add
+        // This adds them to the index WITHOUT staging their content
+        // --force: include ignored files for complete state tracking
+        try {
+            execSync('git add --intent-to-add --all --force', {
+                ...GIT_OPTIONS,
+                stdio: ['pipe', 'pipe', 'pipe'] // Capture stderr for error handling
+            });
+        }
+        catch (addError) {
+            // If no untracked files, git add fails with "nothing to add"
+            // This is fine - just means we only have tracked files
+            const errorMessage = addError instanceof Error ? addError.message : String(addError);
+            if (!errorMessage.includes('nothing')) {
+                // Real error - re-throw
+                throw addError;
+            }
+        }
+        // Step 2: Get tree hash (content-based, no timestamps)
+        const treeHash = execSync('git write-tree', GIT_OPTIONS).trim();
+        // Step 3: Reset index to clean state (remove intent-to-add marks)
+        // This ensures no side effects from our hash calculation
+        execSync('git reset', GIT_OPTIONS);
+        return treeHash;
+    }
+    catch (error) {
+        // Handle not-in-git-repo case
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('not a git repository')) {
+            // Not in git repo - fall back to timestamp-based hash
+            console.warn('⚠️  Not in git repository, using timestamp-based hash');
+            return `nogit-${Date.now()}`;
+        }
+        // Other git errors
+        throw new Error(`Failed to calculate git tree hash: ${errorMessage}`);
+    }
+}
+/**
+ * Get tree hash for HEAD commit (committed state only, no working tree changes)
+ *
+ * This is useful for comparing committed state vs working tree state.
+ *
+ * @returns Git tree SHA-1 hash of HEAD commit
+ * @throws Error if not in a git repository or HEAD doesn't exist
+ */
+export async function getHeadTreeHash() {
+    try {
+        const treeHash = execSync('git rev-parse HEAD^{tree}', GIT_OPTIONS).trim();
+        return treeHash;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to get HEAD tree hash: ${errorMessage}`);
+    }
+}
+/**
+ * Check if working tree has any changes compared to HEAD
+ *
+ * @returns true if working tree differs from HEAD, false if clean
+ */
+export async function hasWorkingTreeChanges() {
+    try {
+        const workingTreeHash = await getGitTreeHash();
+        const headTreeHash = await getHeadTreeHash();
+        return workingTreeHash !== headTreeHash;
+    }
+    catch (error) {
+        // If we can't determine, assume there are changes (safe default)
+        return true;
+    }
+}
+//# sourceMappingURL=tree-hash.js.map

package/dist/tree-hash.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@vibe-validate/git",
+  "version": "0.9.0",
+  "description": "Git utilities for vibe-validate - tree hash calculation, branch sync, and post-merge cleanup",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "git",
+    "validation",
+    "tree-hash",
+    "branch-sync",
+    "cleanup",
+    "sdlc"
+  ],
+  "author": "Jeff Dutton",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jdutton/vibe-validate.git",
+    "directory": "packages/git"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  }
+}