@vibe-validate/git 0.17.0-rc.11 → 0.17.0-rc.13

package/dist/index.d.ts

@@ -14,4 +14,6 @@ export { extractYamlContent, extractYamlWithPreamble } from './yaml-detection.js
 export { isGitRepository, getGitDir, getRepositoryRoot, getCurrentBranch, getHeadCommitSha, getHeadTreeSha, verifyRef, verifyRefOrThrow, hasNotesRef } from './git-commands.js';
 export { executeGitCommand, execGitCommand, tryGitCommand, validateGitRef, validateNotesRef, validateTreeHash, type GitExecutionOptions, type GitExecutionResult } from './git-executor.js';
 export { addNote, readNote, removeNote, listNotes, hasNote, listNotesRefs, removeNotesRefs, getNotesRefSha } from './git-notes.js';
+export { getPartiallyStagedFiles } from './staging.js';
+export { isCurrentBranchBehindTracking } from './tracking-branch.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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;AAGjC,OAAO,EACL,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,OAAO,EACP,QAAQ,EACR,UAAU,EACV,SAAS,EACT,OAAO,EACP,aAAa,EACb,eAAe,EACf,cAAc,EACf,MAAM,gBAAgB,CAAC"}
+{"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;AAGjC,OAAO,EACL,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,OAAO,EACP,QAAQ,EACR,UAAU,EACV,SAAS,EACT,OAAO,EACP,aAAa,EACb,eAAe,EACf,cAAc,EACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,uBAAuB,EACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,6BAA6B,EAC9B,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -22,4 +22,8 @@ export { isGitRepository, getGitDir, getRepositoryRoot, getCurrentBranch, getHea
 export { executeGitCommand, execGitCommand, tryGitCommand, validateGitRef, validateNotesRef, validateTreeHash } from './git-executor.js';
 // Git notes operations (high-level abstraction)
 export { addNote, readNote, removeNote, listNotes, hasNote, listNotesRefs, removeNotesRefs, getNotesRefSha } from './git-notes.js';
+// Git staging detection (prevent partially staged files in pre-commit)
+export { getPartiallyStagedFiles } from './staging.js';
+// Git tracking branch detection (check if current branch is behind remote)
+export { isCurrentBranchBehindTracking } from './tracking-branch.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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;AAEjC,qCAAqC;AACrC,OAAO,EACL,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB,wBAAwB;AACxB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,4DAA4D;AAC5D,OAAO,EACL,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAGjB,MAAM,mBAAmB,CAAC;AAE3B,gDAAgD;AAChD,OAAO,EACL,OAAO,EACP,QAAQ,EACR,UAAU,EACV,SAAS,EACT,OAAO,EACP,aAAa,EACb,eAAe,EACf,cAAc,EACf,MAAM,gBAAgB,CAAC"}
+{"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;AAEjC,qCAAqC;AACrC,OAAO,EACL,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB,wBAAwB;AACxB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,4DAA4D;AAC5D,OAAO,EACL,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAGjB,MAAM,mBAAmB,CAAC;AAE3B,gDAAgD;AAChD,OAAO,EACL,OAAO,EACP,QAAQ,EACR,UAAU,EACV,SAAS,EACT,OAAO,EACP,aAAa,EACb,eAAe,EACf,cAAc,EACf,MAAM,gBAAgB,CAAC;AAExB,uEAAuE;AACvE,OAAO,EACL,uBAAuB,EACxB,MAAM,cAAc,CAAC;AAEtB,2EAA2E;AAC3E,OAAO,EACL,6BAA6B,EAC9B,MAAM,sBAAsB,CAAC"}

package/dist/staging.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Git Staging Detection
+ *
+ * Detects partially staged files to prevent validation mismatches.
+ *
+ * ## The Problem
+ *
+ * If a file has BOTH staged and unstaged changes:
+ * 1. vibe-validate validates the FULL working tree state (staged + unstaged)
+ * 2. git commit only commits the STAGED portion
+ * 3. Result: Validated code != committed code
+ *
+ * ## Solution
+ *
+ * Pre-commit hook must detect and block partially staged files.
+ * Users can:
+ * - Stage all changes: `git add <file>`
+ * - Unstage all changes: `git restore --staged <file>`
+ * - Skip validation: `git commit --no-verify` (not recommended)
+ */
+/**
+ * Get list of files with partially staged changes
+ *
+ * A file is "partially staged" if it has BOTH:
+ * - Changes in the staging area (git diff --cached)
+ * - Changes in the working tree (git diff)
+ *
+ * This indicates the user staged some changes but not others,
+ * which is incompatible with validation.
+ *
+ * @returns Array of file paths with partially staged changes, empty if none
+ *
+ * @example
+ * ```typescript
+ * const files = getPartiallyStagedFiles();
+ * if (files.length > 0) {
+ *   console.error('Partially staged files detected:', files);
+ *   console.error('Stage all changes with: git add ' + files.join(' '));
+ * }
+ * ```
+ */
+export declare function getPartiallyStagedFiles(): string[];
+//# sourceMappingURL=staging.d.ts.map

package/dist/staging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.d.ts","sourceRoot":"","sources":["../src/staging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAWH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAkClD"}

package/dist/staging.js

@@ -0,0 +1,77 @@
+/**
+ * Git Staging Detection
+ *
+ * Detects partially staged files to prevent validation mismatches.
+ *
+ * ## The Problem
+ *
+ * If a file has BOTH staged and unstaged changes:
+ * 1. vibe-validate validates the FULL working tree state (staged + unstaged)
+ * 2. git commit only commits the STAGED portion
+ * 3. Result: Validated code != committed code
+ *
+ * ## Solution
+ *
+ * Pre-commit hook must detect and block partially staged files.
+ * Users can:
+ * - Stage all changes: `git add <file>`
+ * - Unstage all changes: `git restore --staged <file>`
+ * - Skip validation: `git commit --no-verify` (not recommended)
+ */
+import { execSync } from 'node:child_process';
+const GIT_TIMEOUT = 30000;
+const GIT_OPTIONS = {
+    encoding: 'utf8',
+    timeout: GIT_TIMEOUT,
+    stdio: ['pipe', 'pipe', 'ignore'],
+};
+/**
+ * Get list of files with partially staged changes
+ *
+ * A file is "partially staged" if it has BOTH:
+ * - Changes in the staging area (git diff --cached)
+ * - Changes in the working tree (git diff)
+ *
+ * This indicates the user staged some changes but not others,
+ * which is incompatible with validation.
+ *
+ * @returns Array of file paths with partially staged changes, empty if none
+ *
+ * @example
+ * ```typescript
+ * const files = getPartiallyStagedFiles();
+ * if (files.length > 0) {
+ *   console.error('Partially staged files detected:', files);
+ *   console.error('Stage all changes with: git add ' + files.join(' '));
+ * }
+ * ```
+ */
+export function getPartiallyStagedFiles() {
+    try {
+        // Get list of files with staged changes
+        const stagedOutput = execSync('git diff --name-only --cached', GIT_OPTIONS);
+        const stagedFiles = stagedOutput
+            .trim()
+            .split('\n')
+            .filter(Boolean);
+        // No staged files = no partially staged files
+        if (stagedFiles.length === 0) {
+            return [];
+        }
+        // Get list of files with unstaged changes
+        const unstagedOutput = execSync('git diff --name-only', GIT_OPTIONS);
+        const unstagedFiles = new Set(unstagedOutput
+            .trim()
+            .split('\n')
+            .filter(Boolean));
+        // Find intersection: files that appear in BOTH staged and unstaged
+        const partiallyStagedFiles = stagedFiles.filter((file) => unstagedFiles.has(file));
+        return partiallyStagedFiles;
+    }
+    catch {
+        // Not a git repository, or git command failed
+        // Return empty array - let pre-commit continue and fail elsewhere if needed
+        return [];
+    }
+}
+//# sourceMappingURL=staging.js.map

package/dist/staging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.js","sourceRoot":"","sources":["../src/staging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,WAAW,GAAG;IAClB,QAAQ,EAAE,MAAe;IACzB,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAA+B;CAChE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,uBAAuB;IACrC,IAAI,CAAC;QACH,wCAAwC;QACxC,MAAM,YAAY,GAAG,QAAQ,CAAC,+BAA+B,EAAE,WAAW,CAAC,CAAC;QAC5E,MAAM,WAAW,GAAG,YAAY;aAC7B,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC,CAAC;QAEnB,8CAA8C;QAC9C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,0CAA0C;QAC1C,MAAM,cAAc,GAAG,QAAQ,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC;QACrE,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,cAAc;aACX,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC,CACnB,CAAC;QAEF,mEAAmE;QACnE,MAAM,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACvD,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CACxB,CAAC;QAEF,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;QAC9C,4EAA4E;QAC5E,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/tracking-branch.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Git Tracking Branch Detection
+ *
+ * Detects if current branch is behind its remote tracking branch.
+ *
+ * ## The Problem
+ *
+ * If you're working on local `fix-issue-X` and someone else pushes to `origin/fix-issue-X`:
+ * 1. Your local branch is now behind the remote tracking branch
+ * 2. If you commit and push, you may create conflicts or lose their changes
+ * 3. You should pull/merge before committing
+ *
+ * ## Solution
+ *
+ * Pre-commit hook should detect and warn when current branch is behind its tracking branch.
+ */
+/**
+ * Check if current branch is behind its remote tracking branch
+ *
+ * @returns Number of commits behind (0 = up to date), or null if no tracking branch
+ *
+ * @example
+ * ```typescript
+ * const behindBy = isCurrentBranchBehindTracking();
+ * if (behindBy === null) {
+ *   console.log('No remote tracking branch');
+ * } else if (behindBy > 0) {
+ *   console.error(`Behind by ${behindBy} commit(s)`);
+ *   console.error('Pull changes with: git pull');
+ * }
+ * ```
+ */
+export declare function isCurrentBranchBehindTracking(): number | null;
+//# sourceMappingURL=tracking-branch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-branch.d.ts","sourceRoot":"","sources":["../src/tracking-branch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,GAAG,IAAI,CAmC7D"}

package/dist/tracking-branch.js

@@ -0,0 +1,66 @@
+/**
+ * Git Tracking Branch Detection
+ *
+ * Detects if current branch is behind its remote tracking branch.
+ *
+ * ## The Problem
+ *
+ * If you're working on local `fix-issue-X` and someone else pushes to `origin/fix-issue-X`:
+ * 1. Your local branch is now behind the remote tracking branch
+ * 2. If you commit and push, you may create conflicts or lose their changes
+ * 3. You should pull/merge before committing
+ *
+ * ## Solution
+ *
+ * Pre-commit hook should detect and warn when current branch is behind its tracking branch.
+ */
+import { execSync } from 'node:child_process';
+const GIT_TIMEOUT = 30000;
+const GIT_OPTIONS = {
+    encoding: 'utf8',
+    timeout: GIT_TIMEOUT,
+    stdio: ['pipe', 'pipe', 'ignore'],
+};
+/**
+ * Check if current branch is behind its remote tracking branch
+ *
+ * @returns Number of commits behind (0 = up to date), or null if no tracking branch
+ *
+ * @example
+ * ```typescript
+ * const behindBy = isCurrentBranchBehindTracking();
+ * if (behindBy === null) {
+ *   console.log('No remote tracking branch');
+ * } else if (behindBy > 0) {
+ *   console.error(`Behind by ${behindBy} commit(s)`);
+ *   console.error('Pull changes with: git pull');
+ * }
+ * ```
+ */
+export function isCurrentBranchBehindTracking() {
+    try {
+        // Get the upstream tracking branch for current branch
+        // Example output: "origin/fix-issue-X"
+        // Throws error if no upstream configured
+        const trackingBranch = execSync('git rev-parse --abbrev-ref --symbolic-full-name @{u}', GIT_OPTIONS).trim();
+        if (!trackingBranch) {
+            // No tracking branch
+            return null;
+        }
+        // Count commits behind: HEAD..@{u}
+        // This shows commits in tracking branch that are not in HEAD
+        const behindOutput = execSync('git rev-list --count HEAD..@{u}', GIT_OPTIONS).trim();
+        const behindCount = Number.parseInt(behindOutput, 10);
+        // Return 0 if parsing failed (defensive)
+        return Number.isNaN(behindCount) ? 0 : behindCount;
+    }
+    catch (error) {
+        // Check if error is "no upstream configured" (expected for new branches)
+        if (error instanceof Error && error.message.includes('no upstream')) {
+            return null;
+        }
+        // Other errors (not in git repo, etc.) - return null
+        return null;
+    }
+}
+//# sourceMappingURL=tracking-branch.js.map

package/dist/tracking-branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-branch.js","sourceRoot":"","sources":["../src/tracking-branch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,WAAW,GAAG;IAClB,QAAQ,EAAE,MAAe;IACzB,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAA+B;CAChE,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,6BAA6B;IAC3C,IAAI,CAAC;QACH,sDAAsD;QACtD,uCAAuC;QACvC,yCAAyC;QACzC,MAAM,cAAc,GAAG,QAAQ,CAC7B,sDAAsD,EACtD,WAAW,CACZ,CAAC,IAAI,EAAE,CAAC;QAET,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,qBAAqB;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,mCAAmC;QACnC,6DAA6D;QAC7D,MAAM,YAAY,GAAG,QAAQ,CAC3B,iCAAiC,EACjC,WAAW,CACZ,CAAC,IAAI,EAAE,CAAC;QAET,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAEtD,yCAAyC;QACzC,OAAO,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,qDAAqD;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-validate/git",
-  "version": "0.17.0-rc.11",
+  "version": "0.17.0-rc.13",
   "description": "Git utilities for vibe-validate - tree hash calculation, branch sync, and post-merge cleanup",
   "type": "module",
   "main": "./dist/index.js",