@vibe-validate/git 0.18.4 → 0.19.0-rc.10

package/dist/staging.js

@@ -20,6 +20,49 @@
  */
 import { executeGitCommand } from './git-executor.js';
 const GIT_TIMEOUT = 30000;
+const GIT_NAME_ONLY_FLAG = '--name-only';
+/**
+ * Get list of staged files (files in git index)
+ *
+ * Returns file paths relative to repository root for all files
+ * currently staged (Added, Copied, Modified, or Renamed).
+ *
+ * @param cwd - Working directory (defaults to process.cwd())
+ * @returns Array of staged file paths, empty if none or not a git repo
+ *
+ * @example
+ * ```typescript
+ * const files = getStagedFiles();
+ * if (files.length > 0) {
+ *   console.log('Staged files:', files);
+ * }
+ * ```
+ */
+export function getStagedFiles(cwd = process.cwd()) {
+    try {
+        const result = executeGitCommand([
+            'diff',
+            '--cached',
+            GIT_NAME_ONLY_FLAG,
+            '--diff-filter=ACMR', // Added, Copied, Modified, Renamed (not Deleted)
+        ], {
+            cwd,
+            timeout: GIT_TIMEOUT,
+            ignoreErrors: true,
+        });
+        if (!result.success || !result.stdout) {
+            return [];
+        }
+        return result.stdout
+            .split('\n')
+            .map((f) => f.trim())
+            .filter((f) => f.length > 0);
+    }
+    catch {
+        // Not a git repository, or git command failed
+        return [];
+    }
+}
 /**
  * Get list of files with partially staged changes
  *
@@ -44,7 +87,7 @@ const GIT_TIMEOUT = 30000;
 export function getPartiallyStagedFiles() {
     try {
         // Get list of files with staged changes
-        const stagedResult = executeGitCommand(['diff', '--name-only', '--cached'], {
+        const stagedResult = executeGitCommand(['diff', GIT_NAME_ONLY_FLAG, '--cached'], {
             timeout: GIT_TIMEOUT,
             ignoreErrors: true
         });
@@ -60,7 +103,7 @@ export function getPartiallyStagedFiles() {
             return [];
         }
         // Get list of files with unstaged changes
-        const unstagedResult = executeGitCommand(['diff', '--name-only'], {
+        const unstagedResult = executeGitCommand(['diff', GIT_NAME_ONLY_FLAG], {
             timeout: GIT_TIMEOUT,
             ignoreErrors: true
         });

package/dist/staging.js.map

@@ -1 +1 @@
-{"version":3,"file":"staging.js","sourceRoot":"","sources":["../src/staging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,GAAG,KAAK,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,uBAAuB;IACrC,IAAI,CAAC;QACH,wCAAwC;QACxC,MAAM,YAAY,GAAG,iBAAiB,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE;YAC1E,OAAO,EAAE,WAAW;YACpB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM;aACpC,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,iBAAiB,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE;YAChE,OAAO,EAAE,WAAW;YACpB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,cAAc,CAAC,MAAM;aAClB,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC,CACnB,CAAC;QAEF,mEAAmE;QACnE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACjC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CACxB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;QAC9C,4EAA4E;QAC5E,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}
+{"version":3,"file":"staging.js","sourceRoot":"","sources":["../src/staging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEzC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACxD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,iBAAiB,CAC9B;YACE,MAAM;YACN,UAAU;YACV,kBAAkB;YAClB,oBAAoB,EAAE,iDAAiD;SACxE,EACD;YACE,GAAG;YACH,OAAO,EAAE,WAAW;YACpB,YAAY,EAAE,IAAI;SACnB,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACtC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,MAAM,CAAC,MAAM;aACjB,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;QAC9C,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,uBAAuB;IACrC,IAAI,CAAC;QACH,wCAAwC;QACxC,MAAM,YAAY,GAAG,iBAAiB,CAAC,CAAC,MAAM,EAAE,kBAAkB,EAAE,UAAU,CAAC,EAAE;YAC/E,OAAO,EAAE,WAAW;YACpB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM;aACpC,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,iBAAiB,CAAC,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAAE;YACrE,OAAO,EAAE,WAAW;YACpB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,cAAc,CAAC,MAAM;aAClB,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC,CACnB,CAAC;QAEF,mEAAmE;QACnE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACjC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CACxB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;QAC9C,4EAA4E;QAC5E,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/test-helpers.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Git Test Helpers
+ *
+ * Centralized git operations for test setup and verification.
+ * Single source of truth for git commands in tests.
+ *
+ * Security: All git command execution happens here, not scattered across tests.
+ * Auditability: One place to review for security vulnerabilities.
+ * Consistency: All tests use same patterns for git operations.
+ */
+/**
+ * Initialize a git repository for testing
+ *
+ * @param repoPath - Path to initialize as git repo
+ *
+ * @example
+ * const testDir = mkdtempSync(join(tmpdir(), 'test-'));
+ * initTestRepo(testDir);
+ */
+export declare function initTestRepo(repoPath: string): void;
+/**
+ * Configure git user for test repository
+ *
+ * @param repoPath - Path to git repository
+ * @param email - User email (default: test@example.com)
+ * @param name - User name (default: Test User)
+ *
+ * @example
+ * configTestUser(testDir);
+ * configTestUser(testDir, 'custom@example.com', 'Custom User');
+ */
+export declare function configTestUser(repoPath: string, email?: string, name?: string): void;
+/**
+ * Stage files in test repository
+ *
+ * @param repoPath - Path to git repository
+ * @param files - Files to stage (default: all files)
+ *
+ * @example
+ * stageTestFiles(testDir);
+ * stageTestFiles(testDir, ['file1.txt', 'file2.txt']);
+ */
+export declare function stageTestFiles(repoPath: string, files?: string[]): void;
+/**
+ * Create a commit in test repository
+ *
+ * @param repoPath - Path to git repository
+ * @param message - Commit message
+ *
+ * @example
+ * commitTestChanges(testDir, 'Initial commit');
+ */
+export declare function commitTestChanges(repoPath: string, message: string): void;
+/**
+ * Get tree hash for current HEAD
+ *
+ * @param repoPath - Path to git repository
+ * @returns Tree hash
+ *
+ * @example
+ * const treeHash = getTestTreeHash(testDir);
+ */
+export declare function getTestTreeHash(repoPath: string): string;
+/**
+ * Read git note for object
+ *
+ * @param repoPath - Path to git repository
+ * @param notesRef - Notes ref (e.g., 'refs/notes/vibe-validate/validate')
+ * @param object - Object hash to read note for
+ * @returns Note content or null if not found
+ *
+ * @example
+ * const note = readTestNote(testDir, 'refs/notes/vibe-validate/validate', treeHash);
+ */
+export declare function readTestNote(repoPath: string, notesRef: string, object: string): string | null;
+/**
+ * Setup a complete test repository with initial commit
+ *
+ * Combines: init, config user, create file, stage, commit
+ *
+ * @param repoPath - Path to initialize as git repo
+ * @param initialFile - Initial file to create (default: README.md)
+ * @param initialContent - Content for initial file (default: "# Test")
+ *
+ * @example
+ * const testDir = mkdtempSync(join(tmpdir(), 'test-'));
+ * setupTestRepoWithCommit(testDir);
+ */
+export declare function setupTestRepoWithCommit(repoPath: string, initialFile?: string, initialContent?: string): void;
+/**
+ * Configure git submodule protocol settings for local file URLs
+ *
+ * Required for testing submodules with file:// URLs
+ *
+ * @param repoPath - Path to git repository
+ *
+ * @example
+ * configTestSubmoduleProtocol(testDir);
+ */
+export declare function configTestSubmoduleProtocol(repoPath: string): void;
+/**
+ * Get current HEAD commit hash
+ *
+ * @param repoPath - Path to git repository
+ * @returns Commit SHA
+ *
+ * @example
+ * const commitHash = getTestCommitHash(testDir);
+ */
+export declare function getTestCommitHash(repoPath: string): string;
+/**
+ * Register a submodule in git index
+ *
+ * Low-level operation to add submodule entry without cloning
+ *
+ * @param repoPath - Path to git repository
+ * @param commitHash - Submodule commit hash
+ * @param submodulePath - Relative path for submodule
+ *
+ * @example
+ * registerTestSubmodule(testDir, 'abc123...', 'libs/auth');
+ */
+export declare function registerTestSubmodule(repoPath: string, commitHash: string, submodulePath: string): void;
+/**
+ * Initialize git submodules (register in .git/config)
+ *
+ * @param repoPath - Path to git repository
+ *
+ * @example
+ * initTestSubmodules(testDir);
+ */
+export declare function initTestSubmodules(repoPath: string): void;
+/**
+ * Add a submodule to the repository
+ *
+ * @param repoPath - Path to git repository
+ * @param submoduleUrl - URL of submodule repository
+ * @param submodulePath - Relative path where submodule should be placed
+ *
+ * @example
+ * addTestSubmodule(testDir, '/tmp/sub-repo', 'libs/auth');
+ */
+export declare function addTestSubmodule(repoPath: string, submoduleUrl: string, submodulePath: string): void;
+//# sourceMappingURL=test-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,SAAqB,EAC1B,IAAI,SAAc,GACjB,IAAI,CAGN;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAU,GAAG,IAAI,CAE9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY9F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,WAAW,SAAc,EACzB,cAAc,SAAa,GAC1B,IAAI,CASN;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAElE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,IAAI,CAMN;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,IAAI,CAMN"}

package/dist/test-helpers.js

@@ -0,0 +1,195 @@
+/**
+ * Git Test Helpers
+ *
+ * Centralized git operations for test setup and verification.
+ * Single source of truth for git commands in tests.
+ *
+ * Security: All git command execution happens here, not scattered across tests.
+ * Auditability: One place to review for security vulnerabilities.
+ * Consistency: All tests use same patterns for git operations.
+ */
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { safeExecSync, safeExecResult } from '@vibe-validate/utils';
+/**
+ * Initialize a git repository for testing
+ *
+ * @param repoPath - Path to initialize as git repo
+ *
+ * @example
+ * const testDir = mkdtempSync(join(tmpdir(), 'test-'));
+ * initTestRepo(testDir);
+ */
+export function initTestRepo(repoPath) {
+    safeExecSync('git', ['init'], { cwd: repoPath, stdio: 'pipe' });
+}
+/**
+ * Configure git user for test repository
+ *
+ * @param repoPath - Path to git repository
+ * @param email - User email (default: test@example.com)
+ * @param name - User name (default: Test User)
+ *
+ * @example
+ * configTestUser(testDir);
+ * configTestUser(testDir, 'custom@example.com', 'Custom User');
+ */
+export function configTestUser(repoPath, email = 'test@example.com', name = 'Test User') {
+    safeExecSync('git', ['config', 'user.email', email], { cwd: repoPath, stdio: 'pipe' });
+    safeExecSync('git', ['config', 'user.name', name], { cwd: repoPath, stdio: 'pipe' });
+}
+/**
+ * Stage files in test repository
+ *
+ * @param repoPath - Path to git repository
+ * @param files - Files to stage (default: all files)
+ *
+ * @example
+ * stageTestFiles(testDir);
+ * stageTestFiles(testDir, ['file1.txt', 'file2.txt']);
+ */
+export function stageTestFiles(repoPath, files = ['.']) {
+    safeExecSync('git', ['add', ...files], { cwd: repoPath, stdio: 'pipe' });
+}
+/**
+ * Create a commit in test repository
+ *
+ * @param repoPath - Path to git repository
+ * @param message - Commit message
+ *
+ * @example
+ * commitTestChanges(testDir, 'Initial commit');
+ */
+export function commitTestChanges(repoPath, message) {
+    safeExecSync('git', ['commit', '-m', message], { cwd: repoPath, stdio: 'pipe' });
+}
+/**
+ * Get tree hash for current HEAD
+ *
+ * @param repoPath - Path to git repository
+ * @returns Tree hash
+ *
+ * @example
+ * const treeHash = getTestTreeHash(testDir);
+ */
+export function getTestTreeHash(repoPath) {
+    const result = safeExecSync('git', ['rev-parse', 'HEAD:'], {
+        cwd: repoPath,
+        encoding: 'utf-8',
+        stdio: 'pipe',
+    });
+    return result.trim();
+}
+/**
+ * Read git note for object
+ *
+ * @param repoPath - Path to git repository
+ * @param notesRef - Notes ref (e.g., 'refs/notes/vibe-validate/validate')
+ * @param object - Object hash to read note for
+ * @returns Note content or null if not found
+ *
+ * @example
+ * const note = readTestNote(testDir, 'refs/notes/vibe-validate/validate', treeHash);
+ */
+export function readTestNote(repoPath, notesRef, object) {
+    const result = safeExecResult('git', ['notes', '--ref', notesRef, 'show', object], {
+        cwd: repoPath,
+        encoding: 'utf-8',
+        stdio: 'pipe',
+    });
+    if (result.status !== 0) {
+        return null;
+    }
+    return result.stdout.trim();
+}
+/**
+ * Setup a complete test repository with initial commit
+ *
+ * Combines: init, config user, create file, stage, commit
+ *
+ * @param repoPath - Path to initialize as git repo
+ * @param initialFile - Initial file to create (default: README.md)
+ * @param initialContent - Content for initial file (default: "# Test")
+ *
+ * @example
+ * const testDir = mkdtempSync(join(tmpdir(), 'test-'));
+ * setupTestRepoWithCommit(testDir);
+ */
+export function setupTestRepoWithCommit(repoPath, initialFile = 'README.md', initialContent = '# Test\n') {
+    initTestRepo(repoPath);
+    configTestUser(repoPath);
+    // Create initial file
+    writeFileSync(join(repoPath, initialFile), initialContent);
+    stageTestFiles(repoPath);
+    commitTestChanges(repoPath, 'Initial commit');
+}
+/**
+ * Configure git submodule protocol settings for local file URLs
+ *
+ * Required for testing submodules with file:// URLs
+ *
+ * @param repoPath - Path to git repository
+ *
+ * @example
+ * configTestSubmoduleProtocol(testDir);
+ */
+export function configTestSubmoduleProtocol(repoPath) {
+    safeExecSync('git', ['config', 'protocol.file.allow', 'always'], { cwd: repoPath, stdio: 'pipe' });
+}
+/**
+ * Get current HEAD commit hash
+ *
+ * @param repoPath - Path to git repository
+ * @returns Commit SHA
+ *
+ * @example
+ * const commitHash = getTestCommitHash(testDir);
+ */
+export function getTestCommitHash(repoPath) {
+    const result = safeExecSync('git', ['rev-parse', 'HEAD'], {
+        cwd: repoPath,
+        encoding: 'utf-8',
+        stdio: 'pipe',
+    });
+    return result.trim();
+}
+/**
+ * Register a submodule in git index
+ *
+ * Low-level operation to add submodule entry without cloning
+ *
+ * @param repoPath - Path to git repository
+ * @param commitHash - Submodule commit hash
+ * @param submodulePath - Relative path for submodule
+ *
+ * @example
+ * registerTestSubmodule(testDir, 'abc123...', 'libs/auth');
+ */
+export function registerTestSubmodule(repoPath, commitHash, submodulePath) {
+    safeExecSync('git', ['update-index', '--add', '--cacheinfo', `160000,${commitHash},${submodulePath}`], { cwd: repoPath, stdio: 'pipe' });
+}
+/**
+ * Initialize git submodules (register in .git/config)
+ *
+ * @param repoPath - Path to git repository
+ *
+ * @example
+ * initTestSubmodules(testDir);
+ */
+export function initTestSubmodules(repoPath) {
+    safeExecSync('git', ['submodule', 'init'], { cwd: repoPath, stdio: 'pipe' });
+}
+/**
+ * Add a submodule to the repository
+ *
+ * @param repoPath - Path to git repository
+ * @param submoduleUrl - URL of submodule repository
+ * @param submodulePath - Relative path where submodule should be placed
+ *
+ * @example
+ * addTestSubmodule(testDir, '/tmp/sub-repo', 'libs/auth');
+ */
+export function addTestSubmodule(repoPath, submoduleUrl, submodulePath) {
+    safeExecSync('git', ['-c', 'protocol.file.allow=always', 'submodule', 'add', submoduleUrl, submodulePath], { cwd: repoPath, stdio: 'pipe' });
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/test-helpers.js.map

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

package/dist/tree-hash.d.ts

@@ -10,7 +10,7 @@
  * git stash create includes timestamps, making hashes non-deterministic.
  * git write-tree produces content-based hashes only (no timestamps).
  */
-import type { TreeHash } from './types.js';
+import type { TreeHash, TreeHashResult } from './types.js';
 /**
  * Get deterministic git tree hash representing current working tree state
  *
@@ -19,18 +19,55 @@ import type { TreeHash } from './types.js';
  * 2. Copy current index to temporary index
  * 3. Mark untracked files with --intent-to-add in temp index
  * 4. Calculate tree hash with git write-tree using temp index
- * 5. Clean up temp index file
+ * 5. Detect and process git submodules (recursive)
+ * 6. Return parent hash + optional submodule hashes
+ * 7. Clean up temp index file
  *
  * 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)
  *
+ * Submodule Support (Issue #120):
+ * - Detects submodules via `git submodule status`
+ * - Recursively calculates tree hash for each submodule
+ * - Returns TreeHashResult with parent hash + submodule hashes
+ * - Working tree changes in submodules invalidate cache
+ * - Git notes store full result for state reconstruction
+ *
+ * IMPORTANT: This function returns a structured result object, NOT a composite hash.
+ * Git notes store the TreeHashResult as-is. The hash field is the parent repo's
+ * standard Git SHA-1 hash (40 hex characters). The optional submoduleHashes field
+ * records each submodule's tree hash separately.
+ *
+ * Cache key format in git notes (v0.19.0+):
+ * - Parent-only repos: Use parent hash directly (backward compatible)
+ * - Repos with submodules: Use parent hash + submodule metadata
+ * - Result structure stored in git notes for state reconstruction
+ *
  * CRITICAL: Uses GIT_INDEX_FILE to avoid corrupting real index during git commit hooks
  *
- * @returns Git tree SHA-1 hash (40 hex characters) as branded TreeHash type
+ * @returns TreeHashResult containing:
+ *   - hash: Parent repository tree hash (Git SHA-1, 40 hex chars)
+ *   - submoduleHashes: Optional record of submodule paths to tree hashes
+ *
+ * @example
+ * // Repository without submodules (0.18.x compatible)
+ * const result = await getGitTreeHash();
+ * // { hash: 'abc123...' }
+ *
+ * @example
+ * // Repository with submodules (v0.19.0+)
+ * const result = await getGitTreeHash();
+ * // {
+ * //   hash: 'abc123...',  // Parent repo hash
+ * //   submoduleHashes: {
+ * //     'libs/auth': 'xyz789...'
+ * //   }
+ * // }
+ *
  * @throws Error if not in a git repository or git command fails
  */
-export declare function getGitTreeHash(): Promise<TreeHash>;
+export declare function getGitTreeHash(): Promise<TreeHashResult>;
 /**
  * Get tree hash for HEAD commit (committed state only, no working tree changes)
  *
@@ -46,4 +83,49 @@ export declare function getHeadTreeHash(): Promise<TreeHash>;
  * @returns true if working tree differs from HEAD, false if clean
  */
 export declare function hasWorkingTreeChanges(): Promise<boolean>;
+/**
+ * Submodule information from git submodule status
+ * @internal Exported for testing
+ */
+export interface SubmoduleInfo {
+    /** Submodule path relative to repo root */
+    path: string;
+    /** Status character (' '=clean, '+'=modified, '-'=uninitialized, 'U'=conflict) */
+    status: string;
+}
+/**
+ * Get list of git submodules in current repository
+ *
+ * Parses output of `git submodule status` to detect submodules.
+ * Returns empty array if no submodules or command fails.
+ *
+ * Output format: " abc123 libs/auth (heads/main)"
+ *                 ^^^^^^  ^^^^^^^^^ (description)
+ *                 hash    path
+ *
+ * @returns Array of submodule information
+ *
+ * @example
+ * const submodules = getSubmodules();
+ * // [{ path: 'libs/auth', status: ' ' }, { path: 'vendor/foo', status: '+' }]
+ *
+ * @internal Exported for testing
+ */
+export declare function getSubmodules(): SubmoduleInfo[];
+/**
+ * Calculate tree hash for a git submodule (recursive)
+ *
+ * Changes to submodule directory, calculates tree hash, then returns to original directory.
+ * This is recursive - if the submodule has its own submodules, they will be included.
+ *
+ * @param submodulePath - Path to submodule relative to current directory
+ * @returns Tree hash result for the submodule
+ *
+ * @example
+ * const result = await getSubmoduleTreeHash('libs/auth');
+ * // Returns TreeHashResult for libs/auth submodule
+ *
+ * @internal Exported for testing
+ */
+export declare function getSubmoduleTreeHash(submodulePath: string): Promise<TreeHashResult>;
 //# sourceMappingURL=tree-hash.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tree-hash.d.ts","sourceRoot":"","sources":["../src/tree-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA+G3C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,CAuFxD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,QAAQ,CAAC,CAUzD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAS9D"}
+{"version":3,"file":"tree-hash.d.ts","sourceRoot":"","sources":["../src/tree-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA+G3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,wBAAsB,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,CA2I9D;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,QAAQ,CAAC,CAUzD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAS9D;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,IAAI,aAAa,EAAE,CAgD/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CASzF"}