git-er-done 0.1.18 → 0.1.19

package/README.md

@@ -22,6 +22,8 @@ const GIT_COMMIT_REF = '9f63b23ec99e36a176d73909fc67a39dc3bd56b7'
 
 gitDetails({
   base: GIT_COMMIT_REF,
+  // Optional: specify working directory (defaults to process.cwd())
+  // cwd: '/path/to/repo'
 }).then((git) => {
   /* git data returns
   {
@@ -63,6 +65,38 @@ console.log('Created files:', git.createdFiles)
 console.log('Deleted files:', git.deletedFiles)
 ```
 
+### Running from a Different Directory
+
+All functions support a `cwd` option to run git commands in a different directory:
+
+```js
+const { gitDetails, getCurrentBranch, getLastCommit } = require('git-er-done')
+
+// Run git commands in a different repo
+const git = await gitDetails({
+  base: 'main',
+  cwd: '/path/to/other/repo'
+})
+
+const branch = await getCurrentBranch({ cwd: '/path/to/other/repo' })
+const lastCommit = await getLastCommit({ cwd: '/path/to/other/repo' })
+```
+
+### Comparing Against Uncommitted Changes
+
+Use `includeWorkingChanges` to compare against uncommitted changes in the working directory:
+
+```js
+const { gitDetails } = require('git-er-done')
+
+const git = await gitDetails({
+  base: 'main',
+  includeWorkingChanges: true
+})
+
+console.log('Uncommitted changes:', git.modifiedFiles)
+```
+
 ### Getting Lines of Code Changed
 
 ```js
@@ -210,6 +244,21 @@ const { getGitRoot } = require('git-er-done')
 
 const root = await getGitRoot()
 console.log('Git root:', root) // '/Users/you/your-repo'
+
+// With cwd option
+const otherRoot = await getGitRoot('/path/to/other/repo')
+```
+
+### Getting Current Branch
+
+```js
+const { getCurrentBranch } = require('git-er-done')
+
+const branch = await getCurrentBranch()
+console.log('Current branch:', branch) // 'main'
+
+// With cwd option
+const otherBranch = await getCurrentBranch({ cwd: '/path/to/other/repo' })
 ```
 
 ### Getting File Contents at a Specific Commit
@@ -260,10 +309,12 @@ const { getFirstCommit } = require('git-er-done/get-first-commit')
 const { getLastCommit } = require('git-er-done/get-last-commit')
 const { gitDetails } = require('git-er-done/get-details')
 const { getGitRoot } = require('git-er-done/get-root')
+const { getCurrentBranch } = require('git-er-done/get-current-branch')
 const { getGitFiles } = require('git-er-done/get-files')
 const { getFileAtCommit } = require('git-er-done/get-file-at-commit')
 const { getFileDates, getFileModifiedTimeStamp, getFileCreatedTimeStamp } = require('git-er-done/get-file-dates')
 const { getRemotes, getRemote } = require('git-er-done/get-remotes')
+const { getFormattedDiff } = require('git-er-done/get-diff-formatted')
 ```
 
 ## Examples

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "git-er-done",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "Utility for dealing with modified, created, deleted files since a git commit",
   "main": "src/index.js",
   "types": "types/index.d.ts",

package/src/git/commits/getAllCommits.js

@@ -8,6 +8,8 @@ const { gitDetails } = require('../getDetails')
 
 /**
  * Gets all commits in the repository from first to last
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<CommitInfo[]>} Promise that resolves to array of all commits in chronological order
  * @example
  * const commits = await getAllCommits()
@@ -15,16 +17,17 @@ const { gitDetails } = require('../getDetails')
  *   console.log(`${commit.sha}: ${commit.subject}`)
  * })
  */
-async function getAllCommits() {
-  const firstCommit = await getFirstCommit()
+async function getAllCommits(options) {
+  const firstCommit = await getFirstCommit(options)
   // console.log('firstCommit', firstCommit)
-  const lastCommit = await getLastCommit()
+  const lastCommit = await getLastCommit(options)
   // console.log('lastCommit', lastCommit)
   const data = await gitDetails({
     // base === now
     base: lastCommit.sha,
     // head == start
-    head: firstCommit.sha
+    head: firstCommit.sha,
+    cwd: options && options.cwd
   })
   // console.log('data.commits', data.commits.reverse())
   // process.exit(1)

package/src/git/commits/getFirstCommit.js

@@ -8,18 +8,21 @@ const { spawn } = require('child_process')
 /**
  * Gets the hash of the first commit in the repository
  * Uses git rev-list to find the initial commit with no parents
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<string>} Promise that resolves to the SHA hash of the first commit
  * @throws {Error} Throws if git command fails or if not in a git repository
  * @example
  * const hash = await getFirstCommitHash()
  * // Returns: 'a1b2c3d4e5f6...' (40-character SHA-1 hash)
  */
-function getFirstCommitHash() {
+function getFirstCommitHash(options) {
   return new Promise((resolve, reject) => {
     // git rev-list --max-parents=0 HEAD
     let stdout = ''
     const args = ['rev-list', '--max-parents=0', 'HEAD', '--reverse']
-    const child = spawn('git', args, { env: process.env })
+    const cwd = (options && options.cwd) || process.cwd()
+    const child = spawn('git', args, { env: process.env, cwd })
     child.stdout.on('data', chunk => {
       stdout += chunk
     })
@@ -34,6 +37,8 @@ function getFirstCommitHash() {
 
 /**
  * Gets detailed information about the first commit in the repository
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<CommitInfo>} Promise that resolves to commit details object containing SHA, author, committer, message, branch, and tags
  * @throws {Error} Throws if git command fails or if not in a git repository
  * @example
@@ -42,9 +47,10 @@ function getFirstCommitHash() {
  * console.log('Author:', firstCommit.author.name)
  * console.log('SHA:', firstCommit.sha)
  */
-async function getFirstCommit() {
-  const hash = await getFirstCommitHash()
-  return getCommit(hash)
+async function getFirstCommit(options) {
+  const hash = await getFirstCommitHash(options)
+  const opts = options ? { dst: options.cwd } : undefined
+  return getCommit(hash, opts)
 }
 
 /*

package/src/git/commits/getLastCommit.js

@@ -8,6 +8,8 @@ const { parse, getPrettyFormat, removeSignedOffBy } = require('./utils/pretty-fo
 
 /**
  * Gets detailed information about the last commit in the repository
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<CommitInfo>} Promise that resolves to the last commit details including SHA, author, committer, message, branch, and tags
  * @example
  * const lastCommit = await getLastCommit()
@@ -15,10 +17,11 @@ const { parse, getPrettyFormat, removeSignedOffBy } = require('./utils/pretty-fo
  * console.log('Author:', lastCommit.author.name)
  * console.log('SHA:', lastCommit.sha)
  */
-function getLastCommit() {
+function getLastCommit(options) {
   const command = `git log -1 --pretty=format:"${getPrettyFormat()}" && git rev-parse --abbrev-ref HEAD && git tag --contains HEAD`
   return new Promise((resolve, reject) => {
-    executeCommand(command, (err, res) => {
+    const opts = options ? { dst: options.cwd } : undefined
+    executeCommand(command, opts, (err, res) => {
       if (err) return reject(err)
       resolve(parse(res))
     })
@@ -27,15 +30,18 @@ function getLastCommit() {
 
 /**
  * Gets the current HEAD revision SHA
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<{sha: string, shortSha: string}>} Promise that resolves to object with full and short SHA
  * @example
  * const revision = await getCurrentRevision()
  * console.log('Current SHA:', revision.sha)
  * console.log('Short SHA:', revision.shortSha)
  */
-function getCurrentRevision() {
+function getCurrentRevision(options) {
   return new Promise((resolve, reject) => {
-    executeCommand('git rev-parse HEAD', (err, res) => {
+    const opts = options ? { dst: options.cwd } : undefined
+    executeCommand('git rev-parse HEAD', opts, (err, res) => {
       if (err) return reject(err)
       const sha = res.toString().trim()
       resolve({
@@ -48,14 +54,17 @@ function getCurrentRevision() {
 
 /**
  * Gets the commit message of the current HEAD commit
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<string>} Promise that resolves to the commit message (with Signed-off-by lines removed)
  * @example
  * const message = await getCurrentCommitMessage()
  * console.log('Current commit message:', message)
  */
-function getCurrentCommitMessage() {
+function getCurrentCommitMessage(options) {
   return new Promise((resolve, reject) => {
-    executeCommand('git show -s --format=%B HEAD', (err, res) => {
+    const opts = options ? { dst: options.cwd } : undefined
+    executeCommand('git show -s --format=%B HEAD', opts, (err, res) => {
       if (err) return reject(err)
       resolve(removeSignedOffBy(res.toString()).trim())
     })

package/src/git/getCurrentBranch.js

@@ -3,11 +3,14 @@ const { executeCommand } = require('./utils/exec')
 
 /**
  * Gets the current branch name of the git repository
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<string>} A promise that resolves to the current branch name
  */
-function getCurrentBranch() {
+function getCurrentBranch(options) {
   return new Promise((resolve, reject) => {
-    executeCommand('git rev-parse --abbrev-ref HEAD', (err, res) => {
+    const opts = options ? { dst: options.cwd } : undefined
+    executeCommand('git rev-parse --abbrev-ref HEAD', opts, (err, res) => {
       if (err) return reject(err)
       resolve(res.trim())
     })

package/src/git/getDetails.js

@@ -12,6 +12,7 @@ const { LocalGit } = require('../localGit')
  * @param {string} [opts.from] - Alias for opts.base
  * @param {string} [opts.to] - Alias for opts.head
  * @param {boolean} [opts.includeWorkingChanges=false] - If true, compares against uncommitted changes in working directory instead of HEAD
+ * @param {string} [opts.cwd] - Working directory for git commands (defaults to process.cwd())
  * @returns {Promise<GitDetails>} Promise that resolves to git details including modified/created/deleted files, commits, and utility functions
  * @example
  * // Compare between commits

package/src/git/getDiffFormatted.js

@@ -56,6 +56,7 @@ function getLongestLineLength(diff) {
  * @param {Object} options - Options for getting formatted diff
  * @param {string} options.filePath - Relative path from git root
  * @param {string} [options.gitRootDir] - Absolute path to git root directory (defaults to detected git root)
+ * @param {string} [options.cwd] - Working directory for git commands (defaults to process.cwd())
  * @param {string} [options.baseBranch='master'] - Base branch to compare against
  * @param {boolean} [options.shrinkToLongestLine=false] - Auto-calculate width based on longest line
  * @param {number} [options.leftMargin=0] - Number of spaces to add to the left of each line
@@ -66,6 +67,7 @@ function getLongestLineLength(diff) {
 async function getFormattedDiff({
   filePath,
   gitRootDir,
+  cwd,
   baseBranch = 'master',
   shrinkToLongestLine = false,
   leftMargin = 0,
@@ -76,7 +78,7 @@ async function getFormattedDiff({
     const { formatDiff } = await import('@davidwells/git-split-diffs')
 
     if (!gitRootDir) {
-      gitRootDir = await getGitRoot()
+      gitRootDir = await getGitRoot(cwd)
     }
 
     // Get the diff for this specific file

package/src/git/getGitRoot.js

@@ -1,23 +1,25 @@
-const { executeCommand } = require('./utils/exec')
+const { exec } = require('child_process')
 
 /** @type {Map<string, string>} */
 const gitRootCache = new Map()
 
 /**
  * Gets the root directory of the git repository
+ * @param {string} [cwd] - Working directory to run git command from (defaults to process.cwd())
  * @returns {Promise<string>} A promise that resolves to the root directory path of the git repository
  */
-function getGitRoot() {
+function getGitRoot(cwd) {
   return new Promise((resolve, reject) => {
-    const cwd = process.cwd()
-    const cached = gitRootCache.get(cwd)
+    const dir = cwd || process.cwd()
+    const cached = gitRootCache.get(dir)
     if (cached) {
       return resolve(cached)
     }
-    executeCommand('git rev-parse --show-toplevel', (err, res) => {
+    exec('git rev-parse --show-toplevel', { cwd: dir }, (err, stdout, stderr) => {
       if (err) return reject(err)
-      const root = res.trim()
-      gitRootCache.set(cwd, root)
+      if (stderr) return reject(stderr)
+      const root = stdout.trim()
+      gitRootCache.set(dir, root)
       resolve(root)
     })
   })

package/src/git/gitJSONToGitDSL.js

@@ -13,7 +13,7 @@ module.exports.gitJSONToGitDSL = (gitJSONRep, config) => {
   const getFullDiff = config.getStructuredDiffForFile
     ? null
     : memoize((base, head) => {
-      return config.getFullDiff(base, head)
+      return config.getFullDiff(base, head, config.cwd)
     }, (base, head) => `${base}...${head}`)
   /**
    * Takes a filename, and pulls from the PR the two versions of a file
@@ -31,12 +31,14 @@ module.exports.gitJSONToGitDSL = (gitJSONRep, config) => {
     const baseFile = await config.getFileContents(
       filename,
       config.repo,
-      config.baseSHA
+      config.baseSHA,
+      { cwd: config.cwd }
     )
     const headFile = await config.getFileContents(
       filename,
       config.repo,
-      config.headSHA
+      config.headSHA,
+      { cwd: config.cwd }
     )
     // Parse JSON. `fileContents` returns empty string for files that are
     // missing in one of the refs, ie. when the file is created or deleted.
@@ -110,7 +112,7 @@ module.exports.gitJSONToGitDSL = (gitJSONRep, config) => {
   const linesOfCode = async () => {
     // Use optimized numstat if available (single git command vs hundreds)
     if (config.getNumstat) {
-      return await config.getNumstat(config.baseSHA, config.headSHA)
+      return await config.getNumstat(config.baseSHA, config.headSHA, config.cwd)
     }
 
     // Fallback to original implementation
@@ -190,12 +192,14 @@ module.exports.gitJSONToGitDSL = (gitJSONRep, config) => {
       before: await config.getFileContents(
         filename,
         config.repo,
-        config.baseSHA
+        config.baseSHA,
+        { cwd: config.cwd }
       ),
       after: await config.getFileContents(
         filename,
         config.repo,
-        config.headSHA
+        config.headSHA,
+        { cwd: config.cwd }
       ),
       diff: allLines.map(getContent).join(os.EOL),
       added: allLines

package/src/git/localGetCommits.js

@@ -27,11 +27,17 @@ const formatJSON = `{ "sha": "${sha}", "parents": "${parents}", ${author}, ${com
   committedOn: a[6],
 */
 
-const localGetCommits = (base, head) => {
+/**
+ * Get commits between two refs
+ * @param {string} base - Base ref
+ * @param {string} head - Head ref
+ * @param {string} [cwd] - Working directory (defaults to process.cwd())
+ */
+const localGetCommits = (base, head, cwd) => {
   // @TODO add exclude "subject" and "body" option to ignore parsing issues
   return new Promise(resolve => {
     const args = ['log', `${base}...${head}`, `--pretty=format:${formatJSON}`]
-    const child = spawn('git', args, { env: process.env })
+    const child = spawn('git', args, { env: process.env, cwd: cwd || process.cwd() })
     let stdOut = ''
     let stdErr = ''
     let realCommits = []

package/src/git/localGetDiff.js

@@ -3,7 +3,13 @@ const { spawn } = require('child_process')
 
 const d = debug('localGetDiff')
 
-const localGetDiff = (base, head) => {
+/**
+ * Get git diff between two refs
+ * @param {string} base - Base ref
+ * @param {string} head - Head ref
+ * @param {string} [cwd] - Working directory (defaults to process.cwd())
+ */
+const localGetDiff = (base, head, cwd) => {
   return new Promise((resolve, reject) => {
     // If head is empty/null/undefined, compare against working directory
     // Otherwise use three-dot syntax for commit-to-commit comparison
@@ -12,7 +18,7 @@ const localGetDiff = (base, head) => {
       : ['diff', `${base}...${head}`]
 
     let stdout = ''
-    const child = spawn('git', args, { env: process.env })
+    const child = spawn('git', args, { env: process.env, cwd: cwd || process.cwd() })
     d('> git', args.join(' '))
     child.stdout.on('data', chunk => {
       stdout += chunk

package/src/git/localGetLogsAsJson.js

@@ -6,12 +6,18 @@ const d = debug('localGetJSONCommits')
 var format = "'{%n  ^^^^commit^^^^: ^^^^%H^^^^,%n  ^^^^abbreviated_commit^^^^: ^^^^%h^^^^,%n  ^^^^tree^^^^: ^^^^%T^^^^,%n  ^^^^abbreviated_tree^^^^: ^^^^%t^^^^,%n  ^^^^parent^^^^: ^^^^%P^^^^,%n  ^^^^abbreviated_parent^^^^: ^^^^%p^^^^,%n  ^^^^refs^^^^: ^^^^%D^^^^,%n  ^^^^encoding^^^^: ^^^^%e^^^^,%n  ^^^^subject^^^^: ^^^^%s^^^^,%n  ^^^^sanitized_subject_line^^^^: ^^^^%f^^^^,%n  ^^^^commit_notes^^^^: ^^^^%N^^^^,%n  ^^^^verification_flag^^^^: ^^^^%G?^^^^,%n  ^^^^signer^^^^: ^^^^%GS^^^^,%n  ^^^^signer_key^^^^: ^^^^%GK^^^^,%n  ^^^^author^^^^: {%n    ^^^^name^^^^: ^^^^%aN^^^^,%n    ^^^^email^^^^: ^^^^%aE^^^^,%n    ^^^^date^^^^: ^^^^%aD^^^^%n  },%n  ^^^^commiter^^^^: {%n    ^^^^name^^^^: ^^^^%cN^^^^,%n    ^^^^email^^^^: ^^^^%cE^^^^,%n    ^^^^date^^^^: ^^^^%cD^^^^%n  }%n},'"
 
 // https://gist.github.com/varemenos/e95c2e098e657c7688fd
-function getLogAsJson() {
+/**
+ * Get git log as JSON
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
+ */
+function getLogAsJson(options) {
   return new Promise((resolve, reject) => {
     let stdout = ''
     let result = ''
     const args = ['log', '--pretty=format:' + format] // eslint-disable-line
-    const child = spawn('git', args, { env: process.env })
+    const cwd = (options && options.cwd) || process.cwd()
+    const child = spawn('git', args, { env: process.env, cwd })
     d('> git', args.join(' '))
     try {
       child.stdout.on('data', chunk => {

package/src/git/localGetNumstat.js

@@ -9,13 +9,14 @@ const d = debug('localGetNumstat')
  *
  * @param {string} base - Base commit SHA
  * @param {string} head - Head commit SHA
+ * @param {string} [cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<number>} Total lines of code changed (additions + deletions)
  */
-const localGetNumstat = (base, head) => {
+const localGetNumstat = (base, head, cwd) => {
   return new Promise((resolve, reject) => {
     const args = ['diff', `${base}...${head}`, '--numstat']
     let stdout = ''
-    const child = spawn('git', args, { env: process.env })
+    const child = spawn('git', args, { env: process.env, cwd: cwd || process.cwd() })
     d('> git', args.join(' '))
 
     child.stdout.on('data', chunk => {

package/src/git/utils/exec.js

@@ -1,14 +1,11 @@
-const process = require('child_process')
+const childProcess = require('child_process')
 
 function executeCommand(command, opts, cb) {
-  let dst = __dirname
   const callback = (typeof opts === 'function') ? opts : cb
   const options = (typeof opts === 'object') ? opts : null
-  if (!!options && options.dst) {
-    dst = options.dst
-  }
+  const dst = (options && options.dst) || process.cwd()
 
-  process.exec(command, { cwd: dst }, function(err, stdout, stderr) {
+  childProcess.exec(command, { cwd: dst }, function(err, stdout, stderr) {
     if (err) console.log(err)
     if (stdout === '') {
       callback(new Error('this does not look like a git repo'))

package/src/index.js

@@ -1,11 +1,11 @@
 const { gitDetails } = require('./git/getDetails')
+const { getGitRoot } = require('./git/getGitRoot')
+const { getCurrentBranch } = require('./git/getCurrentBranch')
 const { getCommit } = require('./git/commits/getCommit')
+const { getAllCommits } = require('./git/commits/getAllCommits')
 const { getFirstCommit } = require('./git/commits/getFirstCommit')
 const { getLastCommit } = require('./git/commits/getLastCommit')
-const { getAllCommits } = require('./git/commits/getAllCommits')
 const { getGitFiles } = require('./git/getGitFiles')
-const { getGitRoot } = require('./git/getGitRoot')
-const { getCurrentBranch } = require('./git/getCurrentBranch')
 const { getRemotes, getRemote } = require('./git/remotes/getRemotes')
 const { getFileAtCommit } = require('./git/getFileAtCommit')
 const {

package/src/localGit.js

@@ -26,9 +26,11 @@ class LocalGit {
    * @param {string} [options.to] - Alias for head commit/branch
    * @param {string} [options.head='HEAD'] - The head commit/branch to compare to. Pass empty string '' to compare against working directory
    * @param {boolean} [options.includeWorkingChanges=false] - If true, compares against uncommitted changes in working directory instead of HEAD
+   * @param {string} [options.cwd] - Working directory for git commands (defaults to process.cwd())
    */
   constructor(options) {
     this.options = options
+    this.cwd = options.cwd
     this.getFileContents = path => {
       // eslint-disable-next-line promise/param-names
       return new Promise(res => res(readFileSync(path, 'utf8')))
@@ -55,7 +57,7 @@ class LocalGit {
     if (this.gitDiff) {
       return this.gitDiff
     }
-    this.gitDiff = await localGetDiff(this.base, this.head)
+    this.gitDiff = await localGetDiff(this.base, this.head, this.cwd)
     return this.gitDiff
   }
   /**
@@ -80,6 +82,7 @@ class LocalGit {
   async getPlatformGitRepresentation() {
     const base = this.base
     const head = this.head
+    const cwd = this.cwd
 
     const t0 = DEBUG_TIMING ? Date.now() : 0
     const diff = await this.getGitDiff()
@@ -87,7 +90,7 @@ class LocalGit {
     if (DEBUG_TIMING) console.log(`    ⏱️  getGitDiff: ${t1 - t0}ms`)
 
     // Array of commits
-    const commits = await localGetCommits(base, head)
+    const commits = await localGetCommits(base, head, cwd)
     const t2 = DEBUG_TIMING ? Date.now() : 0
     if (DEBUG_TIMING) console.log(`    ⏱️  localGetCommits: ${t2 - t1}ms`)
 
@@ -96,12 +99,13 @@ class LocalGit {
     const t3 = DEBUG_TIMING ? Date.now() : 0
     if (DEBUG_TIMING) console.log(`    ⏱️  diffToGitJSONDSL: ${t3 - t2}ms (parsing ${diff.split('\n').length} lines of diff)`)
 
-    const gitRoot = await getGitRoot()
+    const gitRoot = await getGitRoot(cwd)
 
     const config = {
       repo: gitRoot,
       baseSHA: base,
       headSHA: head,
+      cwd,
       getFileContents: localGetFileAtSHA,
       getFullDiff: localGetDiff,
       getNumstat: localGetNumstat

package/types/git/commits/getAllCommits.d.ts

@@ -4,6 +4,8 @@ export type CommitInfo = import("../../types").CommitInfo;
  */
 /**
  * Gets all commits in the repository from first to last
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<CommitInfo[]>} Promise that resolves to array of all commits in chronological order
  * @example
  * const commits = await getAllCommits()
@@ -11,4 +13,6 @@ export type CommitInfo = import("../../types").CommitInfo;
  *   console.log(`${commit.sha}: ${commit.subject}`)
  * })
  */
-export function getAllCommits(): Promise<CommitInfo[]>;
+export function getAllCommits(options?: {
+    cwd?: string;
+}): Promise<CommitInfo[]>;

package/types/git/commits/getFirstCommit.d.ts

@@ -1,6 +1,8 @@
 export type CommitInfo = import("../../types").CommitInfo;
 /**
  * Gets detailed information about the first commit in the repository
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<CommitInfo>} Promise that resolves to commit details object containing SHA, author, committer, message, branch, and tags
  * @throws {Error} Throws if git command fails or if not in a git repository
  * @example
@@ -9,17 +11,23 @@ export type CommitInfo = import("../../types").CommitInfo;
  * console.log('Author:', firstCommit.author.name)
  * console.log('SHA:', firstCommit.sha)
  */
-export function getFirstCommit(): Promise<CommitInfo>;
+export function getFirstCommit(options?: {
+    cwd?: string;
+}): Promise<CommitInfo>;
 /**
  * @typedef {import('../../types').CommitInfo} CommitInfo
  */
 /**
  * Gets the hash of the first commit in the repository
  * Uses git rev-list to find the initial commit with no parents
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<string>} Promise that resolves to the SHA hash of the first commit
  * @throws {Error} Throws if git command fails or if not in a git repository
  * @example
  * const hash = await getFirstCommitHash()
  * // Returns: 'a1b2c3d4e5f6...' (40-character SHA-1 hash)
  */
-export function getFirstCommitHash(): Promise<string>;
+export function getFirstCommitHash(options?: {
+    cwd?: string;
+}): Promise<string>;

package/types/git/commits/getLastCommit.d.ts

@@ -4,6 +4,8 @@ export type CommitInfo = import("../../types").CommitInfo;
  */
 /**
  * Gets detailed information about the last commit in the repository
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<CommitInfo>} Promise that resolves to the last commit details including SHA, author, committer, message, branch, and tags
  * @example
  * const lastCommit = await getLastCommit()
@@ -11,24 +13,34 @@ export type CommitInfo = import("../../types").CommitInfo;
  * console.log('Author:', lastCommit.author.name)
  * console.log('SHA:', lastCommit.sha)
  */
-export function getLastCommit(): Promise<CommitInfo>;
+export function getLastCommit(options?: {
+    cwd?: string;
+}): Promise<CommitInfo>;
 /**
  * Gets the current HEAD revision SHA
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<{sha: string, shortSha: string}>} Promise that resolves to object with full and short SHA
  * @example
  * const revision = await getCurrentRevision()
  * console.log('Current SHA:', revision.sha)
  * console.log('Short SHA:', revision.shortSha)
  */
-export function getCurrentRevision(): Promise<{
+export function getCurrentRevision(options?: {
+    cwd?: string;
+}): Promise<{
     sha: string;
     shortSha: string;
 }>;
 /**
  * Gets the commit message of the current HEAD commit
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<string>} Promise that resolves to the commit message (with Signed-off-by lines removed)
  * @example
  * const message = await getCurrentCommitMessage()
  * console.log('Current commit message:', message)
  */
-export function getCurrentCommitMessage(): Promise<string>;
+export function getCurrentCommitMessage(options?: {
+    cwd?: string;
+}): Promise<string>;

package/types/git/getCurrentBranch.d.ts

@@ -1,5 +1,9 @@
 /**
  * Gets the current branch name of the git repository
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<string>} A promise that resolves to the current branch name
  */
-export function getCurrentBranch(): Promise<string>;
+export function getCurrentBranch(options?: {
+    cwd?: string;
+}): Promise<string>;

package/types/git/getDetails.d.ts

@@ -10,6 +10,7 @@ export type GitDetails = import("../types").GitDetails;
  * @param {string} [opts.from] - Alias for opts.base
  * @param {string} [opts.to] - Alias for opts.head
  * @param {boolean} [opts.includeWorkingChanges=false] - If true, compares against uncommitted changes in working directory instead of HEAD
+ * @param {string} [opts.cwd] - Working directory for git commands (defaults to process.cwd())
  * @returns {Promise<GitDetails>} Promise that resolves to git details including modified/created/deleted files, commits, and utility functions
  * @example
  * // Compare between commits
@@ -37,4 +38,5 @@ export function gitDetails(opts?: {
     from?: string;
     to?: string;
     includeWorkingChanges?: boolean;
+    cwd?: string;
 }): Promise<GitDetails>;

package/types/git/getDiffFormatted.d.ts

@@ -3,6 +3,7 @@
  * @param {Object} options - Options for getting formatted diff
  * @param {string} options.filePath - Relative path from git root
  * @param {string} [options.gitRootDir] - Absolute path to git root directory (defaults to detected git root)
+ * @param {string} [options.cwd] - Working directory for git commands (defaults to process.cwd())
  * @param {string} [options.baseBranch='master'] - Base branch to compare against
  * @param {boolean} [options.shrinkToLongestLine=false] - Auto-calculate width based on longest line
  * @param {number} [options.leftMargin=0] - Number of spaces to add to the left of each line
@@ -10,9 +11,10 @@
  * @param {boolean} [options.hideHeader=false] - Remove the file path header from the diff
  * @returns {Promise<string | null>} Formatted diff string or null if no diff
  */
-export function getFormattedDiff({ filePath, gitRootDir, baseBranch, shrinkToLongestLine, leftMargin, width, hideHeader }: {
+export function getFormattedDiff({ filePath, gitRootDir, cwd, baseBranch, shrinkToLongestLine, leftMargin, width, hideHeader }: {
     filePath: string;
     gitRootDir?: string;
+    cwd?: string;
     baseBranch?: string;
     shrinkToLongestLine?: boolean;
     leftMargin?: number;

package/types/git/getGitRoot.d.ts

@@ -1,5 +1,6 @@
 /**
  * Gets the root directory of the git repository
+ * @param {string} [cwd] - Working directory to run git command from (defaults to process.cwd())
  * @returns {Promise<string>} A promise that resolves to the root directory path of the git repository
  */
-export function getGitRoot(): Promise<string>;
+export function getGitRoot(cwd?: string): Promise<string>;

package/types/git/localGetCommits.d.ts

@@ -1,3 +1,9 @@
 export const formatJSON: "{ \"sha\": \"%H\", \"parents\": \"%p\", \"author\": {\"name\": \"%an\", \"email\": \"%ae\" }, \"committer\": {\"name\": \"%cn\", \"email\": \"%ce\" }, \"subject\": \"%s\", \"sanitizedSubject\": \"%f\", \"body\": \"%b\", \"authoredOn\": \"%aI\", \"committedOn\": \"%cI\"},";
-export function localGetCommits(base: any, head: any): Promise<any>;
+/**
+ * Get commits between two refs
+ * @param {string} base - Base ref
+ * @param {string} head - Head ref
+ * @param {string} [cwd] - Working directory (defaults to process.cwd())
+ */
+export function localGetCommits(base: string, head: string, cwd?: string): Promise<any>;
 export function attemptToFix(jsonLikeValue: any): any;

package/types/git/localGetDiff.d.ts

@@ -1 +1,7 @@
-export function localGetDiff(base: any, head: any): Promise<any>;
+/**
+ * Get git diff between two refs
+ * @param {string} base - Base ref
+ * @param {string} head - Head ref
+ * @param {string} [cwd] - Working directory (defaults to process.cwd())
+ */
+export function localGetDiff(base: string, head: string, cwd?: string): Promise<any>;

package/types/git/localGetLogsAsJson.d.ts

@@ -1 +1,8 @@
-export function getLogAsJson(): Promise<any>;
+/**
+ * Get git log as JSON
+ * @param {Object} [options] - Options
+ * @param {string} [options.cwd] - Working directory (defaults to process.cwd())
+ */
+export function getLogAsJson(options?: {
+    cwd?: string;
+}): Promise<any>;

package/types/git/localGetNumstat.d.ts

@@ -4,6 +4,7 @@
  *
  * @param {string} base - Base commit SHA
  * @param {string} head - Head commit SHA
+ * @param {string} [cwd] - Working directory (defaults to process.cwd())
  * @returns {Promise<number>} Total lines of code changed (additions + deletions)
  */
-export function localGetNumstat(base: string, head: string): Promise<number>;
+export function localGetNumstat(base: string, head: string, cwd?: string): Promise<number>;

package/types/localGit.d.ts

@@ -15,6 +15,7 @@ export class LocalGit {
      * @param {string} [options.to] - Alias for head commit/branch
      * @param {string} [options.head='HEAD'] - The head commit/branch to compare to. Pass empty string '' to compare against working directory
      * @param {boolean} [options.includeWorkingChanges=false] - If true, compares against uncommitted changes in working directory instead of HEAD
+     * @param {string} [options.cwd] - Working directory for git commands (defaults to process.cwd())
      */
     constructor(options: {
         from?: string;
@@ -22,6 +23,7 @@ export class LocalGit {
         to?: string;
         head?: string;
         includeWorkingChanges?: boolean;
+        cwd?: string;
     });
     options: {
         from?: string;
@@ -29,7 +31,9 @@ export class LocalGit {
         to?: string;
         head?: string;
         includeWorkingChanges?: boolean;
+        cwd?: string;
     };
+    cwd: string;
     getFileContents: (path: any) => Promise<any>;
     name: string;
     base: string;