git-chopstick-core 0.1.13 → 0.1.15

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.1.15] — 2026-06-13
+
+### Added
+- **`includeBare` option for `getRepositories`**: Bare repository detection is now implemented. Uses a heuristic check (`HEAD` + `objects/` + `refs/` via `stat`) to detect bare repos without spawning git processes. Bare repos are added to results but their internal directories (`objects/`, `refs/`, etc.) are not traversed.
+- **`getRepositoriesSummary(rootPath, options?)`**: Combines `getRepositories` + `getRepositorySummary` for an instant workspace overview. Silently omits bare repos and unborn HEADs from results.
+- **Integration tests**: 4 new tests covering `getRepositoriesSummary` (2) and `includeBare` (2). Total: 60 tests.
+
+---
+
 ## [0.1.13] — 2026-06-13
 
 ### Added
@@ -192,6 +201,7 @@
 
 ---
 
+[0.1.15]: https://github.com/parkiyong/git-chopstick-core/releases/tag/v0.1.15
 [0.1.13]: https://github.com/parkiyong/git-chopstick-core/releases/tag/v0.1.13
 [0.1.11]: https://github.com/parkiyong/git-chopstick-core/releases/tag/v0.1.11
 [0.1.10]: https://github.com/parkiyong/git-chopstick-core/releases/tag/v0.1.10
@@ -205,4 +215,4 @@
 [0.1.2]: https://github.com/parkiyong/git-chopstick-core/releases/tag/v0.1.2
 [0.1.1]: https://github.com/parkiyong/git-chopstick-core/releases/tag/v0.1.1
 [0.1.0]: https://github.com/parkiyong/git-chopstick-core/releases/tag/v0.1.0
-[Unreleased]: https://github.com/parkiyong/git-chopstick-core/compare/v0.1.13...HEAD
+[Unreleased]: https://github.com/parkiyong/git-chopstick-core/compare/v0.1.15...HEAD

package/dist/git/discover.d.ts

@@ -1,4 +1,5 @@
 import { Repository } from '../models/repository.js';
+import type { RepositorySummary } from './rev-parse.js';
 /**
  * Options for {@link getRepositories}.
  */
@@ -35,3 +36,21 @@ export interface GetRepositoriesOptions {
  * }
  */
 export declare function getRepositories(rootPath: string, options?: GetRepositoriesOptions): Promise<ReadonlyArray<Repository>>;
+/**
+ * Discover git repositories in a directory tree and return a summary
+ * for each one.
+ *
+ * Combines {@link getRepositories} and {@link getRepositorySummary} into
+ * a single call — useful for getting an instant overview of a monorepo
+ * workspace without iterating over results manually.
+ *
+ * Repositories that fail to produce a summary (bare repos, detached HEAD
+ * with no commits, etc.) are silently omitted from the result.
+ *
+ * @example
+ * const summaries = await getRepositoriesSummary('/path/to/monorepo')
+ * for (const s of summaries) {
+ *   console.log(`${s.path}: ${s.currentBranch ?? '(detached)'} @ ${s.head.slice(0, 7)}`)
+ * }
+ */
+export declare function getRepositoriesSummary(rootPath: string, options?: GetRepositoriesOptions): Promise<ReadonlyArray<RepositorySummary>>;

package/dist/git/discover.js

@@ -2,6 +2,7 @@ import { opendir, stat } from 'fs/promises';
 import { join, resolve } from 'path';
 import { Repository } from '../models/repository.js';
 import { directoryExists } from '../lib/directory-exists.js';
+import { getRepositorySummary } from './rev-parse.js';
 const defaultSkipDirs = new Set([
     'node_modules',
     '.git',
@@ -35,10 +36,6 @@ const defaultSkipDirs = new Set([
  */
 export async function getRepositories(rootPath, options = {}) {
     const { depth = 5, skipDirs = defaultSkipDirs, includeBare = false, } = options;
-    if (includeBare) {
-        throw new Error('Bare repository detection is not yet implemented. ' +
-            'Set includeBare to false (default) or omit it.');
-    }
     if (!(await directoryExists(rootPath))) {
         return [];
     }
@@ -58,6 +55,28 @@ export async function getRepositories(rootPath, options = {}) {
             return false;
         }
     }
+    /**
+     * Check if a directory looks like a bare git repository.
+     *
+     * A bare repo has the git internals (HEAD, objects, refs) directly in
+     * the directory rather than inside a `.git` subdirectory.
+     *
+     * This is a heuristic that checks for the essential bare-repo indicators
+     * without spawning a git process (which would be too slow for large trees).
+     */
+    async function isBareRepo(dirPath) {
+        try {
+            const [headStat, objectsStat, refsStat] = await Promise.all([
+                stat(join(dirPath, 'HEAD')),
+                stat(join(dirPath, 'objects')),
+                stat(join(dirPath, 'refs')),
+            ]);
+            return headStat.isFile() && objectsStat.isDirectory() && refsStat.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
     /**
      * Recursively walk a directory tree looking for repos.
      */
@@ -73,13 +92,19 @@ export async function getRepositories(rootPath, options = {}) {
             return;
         }
         seen.add(resolved);
-        // Check if this directory is itself a repo
+        // Check if this directory is itself a regular repo (has .git directory/file)
         if (await hasGitDir(resolved)) {
             repos.push(new Repository(resolved, repos.length));
             // Continue recursing — the parent repo may contain nested repos
             // (e.g. monorepo workspaces where the root is a repo AND packages
             //  have their own .git directories)
         }
+        else if (includeBare && (await isBareRepo(resolved))) {
+            repos.push(new Repository(resolved, repos.length));
+            // Don't recurse into bare repos — the subdirectories are git internals
+            // (objects/, refs/, etc.) and not the working tree
+            return;
+        }
         // Recurse into subdirectories
         let dir;
         try {
@@ -121,4 +146,32 @@ export async function getRepositories(rootPath, options = {}) {
     await walk(resolvedRoot, 0);
     return repos;
 }
+/**
+ * Discover git repositories in a directory tree and return a summary
+ * for each one.
+ *
+ * Combines {@link getRepositories} and {@link getRepositorySummary} into
+ * a single call — useful for getting an instant overview of a monorepo
+ * workspace without iterating over results manually.
+ *
+ * Repositories that fail to produce a summary (bare repos, detached HEAD
+ * with no commits, etc.) are silently omitted from the result.
+ *
+ * @example
+ * const summaries = await getRepositoriesSummary('/path/to/monorepo')
+ * for (const s of summaries) {
+ *   console.log(`${s.path}: ${s.currentBranch ?? '(detached)'} @ ${s.head.slice(0, 7)}`)
+ * }
+ */
+export async function getRepositoriesSummary(rootPath, options = {}) {
+    const repos = await getRepositories(rootPath, options);
+    const results = await Promise.allSettled(repos.map(r => getRepositorySummary(r.path)));
+    const summaries = [];
+    for (const result of results) {
+        if (result.status === 'fulfilled' && result.value !== null) {
+            summaries.push(result.value);
+        }
+    }
+    return summaries;
+}
 //# sourceMappingURL=discover.js.map

package/dist/git/discover.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "git-chopstick-core",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/__tests__/integration.test.ts

@@ -4,7 +4,7 @@ import { execSync } from 'child_process'
 import { tmpdir } from 'os'
 import { join } from 'path'
 import {
-  Repository, getRepositories, getStatus, getWorkingDirectoryChanges, getWorkingDirectoryChangesDetailed, fileChangeSummaryToWorkingDirectoryFile, DiffSelectionType, getCommits, getBranches,
+  Repository, getRepositories, getRepositoriesSummary, getStatus, getWorkingDirectoryChanges, getWorkingDirectoryChangesDetailed, fileChangeSummaryToWorkingDirectoryFile, DiffSelectionType, getCommits, getBranches,
   createCommit, createBranch, deleteLocalBranch, renameBranch,
   getCurrentBranch, getRepositoryType, getRepositorySummary,
   getRemoteUrl, getRemotesFromPath, getAllTags,
@@ -610,6 +610,90 @@ describe('getRepositories', () => {
     expect(repos).toEqual([])
     execSync(`rm -rf ${nonRepoPath}`)
   })
+
+  it('detects bare repos when includeBare is true', async () => {
+    const root = mkdtempSync(join(tmpdir(), 'gcctest-bare-'))
+    execSync(`git init ${root}`, { stdio: 'pipe' })
+    execSync(`git -C ${root} commit --allow-empty -m 'init'`, { stdio: 'pipe' })
+
+    // Create a bare repo inside the tree
+    const bare = join(root, 'shared.git')
+    execSync(`mkdir -p ${bare}`)
+    execSync(`git init --bare ${bare}`, { stdio: 'pipe' })
+
+    // Without includeBare, should not find the bare repo
+    const reposWithout = await getRepositories(root)
+    expect(reposWithout.length).toBe(1)
+    expect(reposWithout[0].path).toBe(root)
+
+    // With includeBare, should find both
+    const reposWith = await getRepositories(root, { includeBare: true })
+    expect(reposWith.length).toBe(2)
+
+    const bareFound = reposWith.find(r => r.path === bare)
+    expect(bareFound).toBeTruthy()
+
+    execSync(`rm -rf ${root}`)
+  })
+
+  it('does not recurse into bare repo internals', async () => {
+    const root = mkdtempSync(join(tmpdir(), 'gcctest-bare-internals-'))
+    execSync(`git init ${root}`, { stdio: 'pipe' })
+    execSync(`git -C ${root} commit --allow-empty -m 'init'`, { stdio: 'pipe' })
+
+    const bare = join(root, 'project.git')
+    execSync(`mkdir -p ${bare}`)
+    execSync(`git init --bare ${bare}`, { stdio: 'pipe' })
+
+    const repos = await getRepositories(root, { includeBare: true })
+    // Should only be 2: the root repo and the bare repo. Subdirs of the bare
+    // repo like objects/, refs/ should NOT be discovered as separate repos.
+    expect(repos.length).toBe(2)
+
+    execSync(`rm -rf ${root}`)
+  })
+})
+
+describe('getRepositoriesSummary', () => {
+  it('returns summaries for all repos in a monorepo', async () => {
+    const root = mkdtempSync(join(tmpdir(), 'gcctest-summaries-'))
+    execSync(`git init ${root}`, { stdio: 'pipe' })
+    execSync(`git -C ${root} commit --allow-empty -m 'init'`, { stdio: 'pipe' })
+
+    const pkg = join(root, 'packages', 'pkg-a')
+    execSync(`mkdir -p ${pkg}`)
+    execSync(`git init ${pkg}`, { stdio: 'pipe' })
+    execSync(`git -C ${pkg} commit --allow-empty -m 'init pkg-a'`, { stdio: 'pipe' })
+
+    const summaries = await getRepositoriesSummary(root)
+    expect(summaries.length).toBe(2)
+
+    for (const s of summaries) {
+      expect(s.path).toBeTruthy()
+      expect(s.head).toMatch(/^[a-f0-9]{40}$/)
+      expect(s.currentBranch).toBe('main')
+    }
+
+    execSync(`rm -rf ${root}`)
+  })
+
+  it('skips repos that fail to produce a summary (bare repos)', async () => {
+    const root = mkdtempSync(join(tmpdir(), 'gcctest-bare-summary-'))
+    execSync(`git init ${root}`, { stdio: 'pipe' })
+    execSync(`git -C ${root} commit --allow-empty -m 'init'`, { stdio: 'pipe' })
+
+    // Create a bare repo inside the tree
+    const bare = join(root, 'bare-repo')
+    execSync(`mkdir -p ${bare}`)
+    execSync(`git init --bare ${bare}`, { stdio: 'pipe' })
+
+    const summaries = await getRepositoriesSummary(root)
+    // The bare repo should be silently skipped
+    expect(summaries.length).toBe(1)
+    expect(summaries[0].path).toBe(root)
+
+    execSync(`rm -rf ${root}`)
+  })
 })
 
 describe('addRemote', () => {