@cesarandreslopez/occ 0.8.11 → 0.9.0

package/dist/src/git/api.js

@@ -0,0 +1,247 @@
+import path from 'node:path';
+import { createTokenizer, estimateTokenCount, resolveTokenizerName } from '../tokens.js';
+import { buildDiffRangeArgs, GitError, gitVersion, resolveDiffRange, runGit, runGitRaw } from './client.js';
+import { aggregateChurn, parseDiffPatchHunks, parseLogNumstatZ, parseLogRecords, parseNameStatusZ, parseNumstatZ, } from './parse.js';
+const DEFAULT_NOISE_EXCLUDES = [
+    ':(exclude)package-lock.json',
+    ':(exclude)pnpm-lock.yaml',
+    ':(exclude)yarn.lock',
+    ':(exclude)*.min.js',
+    ':(exclude)*.map',
+    ':(exclude)dist/**',
+    ':(exclude)build/**',
+    ':(exclude)vendor/**',
+    ':(exclude)**/__generated__/**',
+    ':(exclude)*.snap',
+];
+const LOG_FORMAT = 'tformat:%H%x1f%h%x1f%an%x1f%ae%x1f%aI%x1f%cI%x1f%s%x1f%b';
+const LINE_LOG_FORMAT = 'tformat:%x1e%H%x1f%h%x1f%an%x1f%aI%x1f%s';
+function repoRootFromOptions(options) {
+    return path.resolve(options.repoRoot ?? options.cwd ?? process.cwd());
+}
+function rangeResolutionOptions(options) {
+    const { maxBuffer: _maxBuffer, allowExitCodes: _allowExitCodes, ...rest } = options;
+    return rest;
+}
+function pathspecs(options, includeDefaultExcludes = true) {
+    const specs = [];
+    specs.push(...(options.paths ?? []));
+    if (includeDefaultExcludes)
+        specs.push(...DEFAULT_NOISE_EXCLUDES);
+    specs.push(...(options.excludePaths ?? []));
+    return specs;
+}
+function withPathspecs(args, specs) {
+    return [...args, '--', ...specs];
+}
+async function resolveRangeAndVersion(options) {
+    const repoRoot = repoRootFromOptions(options);
+    const rangeOptions = rangeResolutionOptions(options);
+    const range = await resolveDiffRange(rangeOptions);
+    const version = await gitVersion(repoRoot, rangeOptions).catch(() => undefined);
+    return { range, version, repoRoot };
+}
+function sumNumstat(stats) {
+    let added = 0;
+    let deleted = 0;
+    let binaryFiles = 0;
+    for (const stat of stats) {
+        if (stat.binary)
+            binaryFiles++;
+        added += stat.added ?? 0;
+        deleted += stat.deleted ?? 0;
+    }
+    return { added, deleted, binaryFiles };
+}
+function countPatchFiles(patch) {
+    return patch.split(/\r?\n/).filter(line => line.startsWith('diff --git ')).length;
+}
+function rangeSpec(range) {
+    if (range.base && range.head)
+        return `${range.base}..${range.head}`;
+    return range.head;
+}
+function toFileHistoryEntry(commit, added = null, deleted = null) {
+    return { ...commit, added, deleted };
+}
+function parseLineHistory(output) {
+    return output
+        .split('\x1e')
+        .map(record => record.trim())
+        .filter(Boolean)
+        .map(record => {
+        const [hash, shortHash, authorName, authorDate, subject] = record.split('\x1f');
+        return {
+            hash,
+            shortHash,
+            authorName,
+            authorEmail: '',
+            authorDate,
+            committerDate: authorDate,
+            subject,
+            added: null,
+            deleted: null,
+        };
+    });
+}
+export async function resolveGitRange(options = {}) {
+    return resolveDiffRange(options);
+}
+export async function getGitChangedFiles(options = {}) {
+    const { range, version, repoRoot } = await resolveRangeAndVersion(options);
+    const args = withPathspecs(['diff', '--no-color', '--name-status', '-M', '-z', ...buildDiffRangeArgs(range, version)], pathspecs(options));
+    const result = await runGitRaw(args, { ...options, repoRoot });
+    return parseNameStatusZ(result.stdout);
+}
+export async function getGitDiffSummary(options = {}) {
+    const { range, version, repoRoot } = await resolveRangeAndVersion(options);
+    const specs = pathspecs(options);
+    const fileResult = await runGitRaw(withPathspecs(['diff', '--no-color', '--name-status', '-M', '-z', ...buildDiffRangeArgs(range, version)], specs), { ...options, repoRoot });
+    const numstatResult = await runGitRaw(withPathspecs(['diff', '--no-color', '--numstat', '-M', '-z', ...buildDiffRangeArgs(range, version)], specs), { ...options, repoRoot });
+    const files = parseNameStatusZ(fileResult.stdout);
+    const numstat = parseNumstatZ(numstatResult.stdout);
+    const binaryByPath = new Set(numstat.filter(entry => entry.binary).map(entry => entry.path));
+    const enrichedFiles = files.map(file => (binaryByPath.has(file.path) ? { ...file, binary: true } : file));
+    const totals = sumNumstat(numstat);
+    return {
+        range,
+        files: enrichedFiles,
+        numstat,
+        totalAdded: totals.added,
+        totalDeleted: totals.deleted,
+        filesChanged: files.length,
+        binaryFiles: totals.binaryFiles,
+    };
+}
+export async function getGitDiffPatch(options = {}) {
+    const { range, version, repoRoot } = await resolveRangeAndVersion(options);
+    const specs = pathspecs(options);
+    const args = withPathspecs(['diff', '--no-color', ...buildDiffRangeArgs(range, version)], specs);
+    const tokenBudget = options.tokenBudget;
+    try {
+        const result = await runGit(args, { ...options, repoRoot });
+        const tokenizerName = resolveTokenizerName(options.tokenizer);
+        const tokenizer = tokenBudget ? await createTokenizer(tokenizerName) : undefined;
+        const fullPatch = result.stdout;
+        const fullTokens = tokenizer ? tokenizer.count(fullPatch) : estimateTokenCount(fullPatch);
+        const truncated = tokenBudget != null && fullTokens > tokenBudget;
+        const patch = truncated && tokenizer ? tokenizer.slice(fullPatch, 0, tokenBudget) : fullPatch;
+        const tokensUsed = tokenizer ? tokenizer.count(patch) : estimateTokenCount(patch);
+        const filesIncluded = countPatchFiles(patch);
+        const changedFiles = await getGitChangedFiles(rangeResolutionOptions(options)).catch(() => []);
+        return {
+            range,
+            patch,
+            truncated,
+            tokensUsed,
+            tokenBudget,
+            filesIncluded,
+            filesOmitted: Math.max(0, changedFiles.length - filesIncluded),
+        };
+    }
+    catch (error) {
+        if (error instanceof GitError && error.code === 'max-buffer') {
+            const changedFiles = await getGitChangedFiles(rangeResolutionOptions(options)).catch(() => []);
+            return {
+                range,
+                patch: '',
+                truncated: true,
+                tokensUsed: 0,
+                tokenBudget,
+                filesIncluded: 0,
+                filesOmitted: changedFiles.length,
+            };
+        }
+        throw error;
+    }
+}
+export async function getGitDiffHunks(options = {}) {
+    const { range, version, repoRoot } = await resolveRangeAndVersion(options);
+    const result = await runGit(withPathspecs(['diff', '--no-color', '--unified=0', ...buildDiffRangeArgs(range, version)], pathspecs(options)), { ...options, repoRoot });
+    return parseDiffPatchHunks(result.stdout, range);
+}
+export async function getGitDiffFunctionContext(options = {}) {
+    const { range, version, repoRoot } = await resolveRangeAndVersion(options);
+    const result = await runGit(withPathspecs(['diff', '--no-color', '-W', '--unified=3', ...buildDiffRangeArgs(range, version)], pathspecs(options)), { ...options, repoRoot });
+    return parseDiffPatchHunks(result.stdout, range, { includeLineText: true });
+}
+export async function getGitCommitHistory(options = {}) {
+    const { range, repoRoot } = await resolveRangeAndVersion(options);
+    const limit = options.limit ?? 50;
+    const args = ['log', '--no-color', '-z', `--format=${LOG_FORMAT}`, `--max-count=${limit + 1}`];
+    if (options.since)
+        args.push(`--since=${options.since}`);
+    const spec = rangeSpec(range);
+    if (spec)
+        args.push(spec);
+    const result = await runGitRaw(withPathspecs(args, pathspecs(options)), { ...options, repoRoot });
+    const commits = parseLogRecords(result.stdout);
+    const truncated = commits.length > limit;
+    return {
+        commits: commits.slice(0, limit),
+        total: Math.min(commits.length, limit),
+        truncated,
+        pathFilter: options.paths?.[0],
+    };
+}
+export async function getGitFileHistory(options) {
+    const repoRoot = repoRootFromOptions(options);
+    const limit = options.limit ?? 50;
+    if (options.lineRange) {
+        const lineArg = `${options.lineRange.start},${options.lineRange.end}:${options.path}`;
+        let result = await runGit(['log', '--no-color', '-L', lineArg, `--format=${LINE_LOG_FORMAT}`, `--max-count=${limit}`, 'HEAD'], { ...options, repoRoot }).catch(async (error) => {
+            if (error instanceof GitError && /has only \d+ lines/i.test(error.stderr ?? error.message)) {
+                return runGit([
+                    'log',
+                    '--no-color',
+                    '-L',
+                    `${options.lineRange?.start},${options.lineRange?.start}:${options.path}`,
+                    `--format=${LINE_LOG_FORMAT}`,
+                    `--max-count=${limit}`,
+                    'HEAD',
+                ], { ...options, repoRoot });
+            }
+            throw error;
+        });
+        const entries = parseLineHistory(result.stdout).slice(0, limit);
+        return {
+            path: options.path,
+            lineRange: options.lineRange,
+            entries,
+            total: entries.length,
+            truncated: entries.length > limit,
+        };
+    }
+    const args = ['log', '--no-color', '-z', `--format=${LOG_FORMAT}`, `--max-count=${limit + 1}`];
+    if (options.follow)
+        args.push('--follow');
+    if (options.since)
+        args.push(`--since=${options.since}`);
+    args.push('HEAD');
+    const result = await runGitRaw(withPathspecs(args, [options.path]), { ...options, repoRoot });
+    const commits = parseLogRecords(result.stdout).map(commit => toFileHistoryEntry(commit));
+    const truncated = commits.length > limit;
+    return {
+        path: options.path,
+        entries: commits.slice(0, limit),
+        total: Math.min(commits.length, limit),
+        truncated,
+    };
+}
+export async function getGitChurnSummary(options = {}) {
+    const { range, repoRoot } = await resolveRangeAndVersion(options);
+    const args = ['log', '--no-color', '-z', `--format=${LOG_FORMAT}`, '--numstat'];
+    if (options.since)
+        args.push(`--since=${options.since}`);
+    const spec = rangeSpec(range);
+    if (spec)
+        args.push(spec);
+    const result = await runGitRaw(withPathspecs(args, pathspecs(options)), { ...options, repoRoot });
+    const records = parseLogNumstatZ(result.stdout);
+    const summary = aggregateChurn(records, range, options.sort ?? 'churn');
+    if (options.limit != null) {
+        return { ...summary, entries: summary.entries.slice(0, options.limit) };
+    }
+    return summary;
+}
+//# sourceMappingURL=api.js.map

package/dist/src/git/api.js.map

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

package/dist/src/git/client.d.ts

@@ -0,0 +1,48 @@
+import type { GitRange, GitRepoInfo } from './types.js';
+export type GitErrorCode = 'git-missing' | 'not-a-repo' | 'bad-ref' | 'merge-base-failed' | 'timeout' | 'max-buffer' | 'git-failed' | 'not-implemented';
+export declare class GitError extends Error {
+    readonly code: GitErrorCode;
+    readonly exitCode?: number;
+    readonly stderr?: string;
+    constructor(code: GitErrorCode, message: string, options?: {
+        cause?: unknown;
+        exitCode?: number;
+        stderr?: string;
+    });
+}
+export interface RunGitOptions {
+    cwd?: string;
+    repoRoot?: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    maxBuffer?: number;
+    allowExitCodes?: readonly number[];
+}
+export interface RunGitResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    argv: string[];
+    cwd: string;
+}
+export interface RunGitRawResult {
+    stdout: Buffer;
+    stderr: string;
+    exitCode: number;
+    argv: string[];
+    cwd: string;
+}
+export declare const GIT_GLOBAL_ARGS: readonly ["--no-pager", "-c", "color.ui=false", "-c", "core.quotePath=false", "-c", "core.autocrlf=false", "--no-optional-locks"];
+export declare function runGit(args: readonly string[], options?: RunGitOptions): Promise<RunGitResult>;
+export declare function runGitRaw(args: readonly string[], options?: RunGitOptions): Promise<RunGitRawResult>;
+export declare function preflightRepo(repoRoot?: string, options?: RunGitOptions): Promise<GitRepoInfo>;
+export declare function gitVersion(repoRoot?: string, options?: RunGitOptions): Promise<string>;
+export declare function detectDefaultBase(repoRoot?: string, options?: RunGitOptions): Promise<string | undefined>;
+export declare function gitMergeBase(base: string, head?: string, options?: RunGitOptions): Promise<string>;
+export interface ResolveDiffRangeOptions extends RunGitOptions {
+    base?: string;
+    head?: string;
+    staged?: boolean;
+}
+export declare function resolveDiffRange(options?: ResolveDiffRangeOptions): Promise<GitRange>;
+export declare function buildDiffRangeArgs(range: GitRange, version?: string): string[];

package/dist/src/git/client.js

@@ -0,0 +1,336 @@
+import { execFile } from 'node:child_process';
+import { realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { OccAbortError } from '../errors.js';
+import { abortIfNeeded } from '../utils.js';
+export class GitError extends Error {
+    code;
+    exitCode;
+    stderr;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = 'GitError';
+        this.code = code;
+        this.exitCode = options?.exitCode;
+        this.stderr = options?.stderr;
+    }
+}
+export const GIT_GLOBAL_ARGS = [
+    '--no-pager',
+    '-c',
+    'color.ui=false',
+    '-c',
+    'core.quotePath=false',
+    '-c',
+    'core.autocrlf=false',
+    '--no-optional-locks',
+];
+const DEFAULT_MAX_BUFFER = 64 * 1024 * 1024;
+const DEFAULT_TIMEOUT_MS = 60_000;
+const DEFAULT_HEAD = 'HEAD';
+function resolveCwd(options) {
+    return path.resolve(options.repoRoot ?? options.cwd ?? process.cwd());
+}
+function firstStderrLine(stderr, fallback) {
+    const first = stderr
+        .split(/\r?\n/)
+        .map(line => line.trim())
+        .find(Boolean);
+    return first ?? fallback;
+}
+function isAbortError(error) {
+    return error.name === 'AbortError' || error.code === 'ABORT_ERR';
+}
+function classifyGitFailure(error, stderr) {
+    if (error.code === 'ENOENT')
+        return 'git-missing';
+    if (error.code === 'ERR_CHILD_PROCESS_STDIO_MAXBUFFER')
+        return 'max-buffer';
+    if (error.killed)
+        return 'timeout';
+    if (/not a git repository/i.test(stderr))
+        return 'not-a-repo';
+    if (/bad revision|unknown revision|ambiguous argument|Needed a single revision/i.test(stderr))
+        return 'bad-ref';
+    return 'git-failed';
+}
+function toGitError(error, stderr) {
+    const code = classifyGitFailure(error, stderr);
+    const exitCode = typeof error.code === 'number' ? error.code : undefined;
+    return new GitError(code, firstStderrLine(stderr, error.message), {
+        cause: error,
+        exitCode,
+        stderr: stderr.trim(),
+    });
+}
+function normalizeStderr(stderr) {
+    return Buffer.isBuffer(stderr) ? stderr.toString('utf8') : stderr;
+}
+function isAllowedExit(code, allowedExitCodes) {
+    return code === 0 || (allowedExitCodes?.includes(code) ?? false);
+}
+function execGit(args, options, encoding) {
+    abortIfNeeded(options.signal);
+    const cwd = resolveCwd(options);
+    const argv = [...GIT_GLOBAL_ARGS, ...args];
+    const maxBuffer = options.maxBuffer ?? DEFAULT_MAX_BUFFER;
+    const timeout = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    return new Promise((resolve, reject) => {
+        execFile('git', argv, {
+            cwd,
+            maxBuffer,
+            timeout,
+            signal: options.signal,
+            encoding,
+        }, (error, stdout, stderr) => {
+            const stderrText = normalizeStderr(stderr);
+            if (!error) {
+                resolve({ stdout, stderr: stderrText, exitCode: 0, argv, cwd });
+                return;
+            }
+            if (isAbortError(error)) {
+                reject(new OccAbortError());
+                return;
+            }
+            const exitCode = typeof error.code === 'number' ? error.code : undefined;
+            if (exitCode != null && isAllowedExit(exitCode, options.allowExitCodes)) {
+                resolve({ stdout, stderr: stderrText, exitCode, argv, cwd });
+                return;
+            }
+            reject(toGitError(error, stderrText));
+        });
+    });
+}
+export async function runGit(args, options = {}) {
+    return execGit(args, options, 'utf8');
+}
+export async function runGitRaw(args, options = {}) {
+    return execGit(args, options, 'buffer');
+}
+function fallbackRepoInfo(repoRoot, gitVersionValue) {
+    const info = {
+        repoRoot: path.resolve(repoRoot),
+        isDirty: false,
+        shallow: false,
+        detached: false,
+    };
+    if (gitVersionValue)
+        info.gitVersion = gitVersionValue;
+    return info;
+}
+export async function preflightRepo(repoRoot = process.cwd(), options = {}) {
+    let version;
+    try {
+        version = await gitVersion(repoRoot, options);
+    }
+    catch {
+        return fallbackRepoInfo(repoRoot);
+    }
+    const baseOptions = { ...options, repoRoot };
+    const inside = await runGit(['rev-parse', '--is-inside-work-tree'], {
+        ...baseOptions,
+        allowExitCodes: [128],
+    }).catch(() => undefined);
+    if (!inside || inside.exitCode !== 0 || inside.stdout.trim() !== 'true') {
+        return fallbackRepoInfo(repoRoot, version);
+    }
+    const rootResult = await runGit(['rev-parse', '--show-toplevel'], baseOptions).catch(() => undefined);
+    const resolvedRoot = rootResult?.stdout.trim()
+        ? await realpath(rootResult.stdout.trim()).catch(() => path.resolve(rootResult.stdout.trim()))
+        : path.resolve(repoRoot);
+    const repoOptions = { ...options, repoRoot: resolvedRoot };
+    const headResult = await runGit(['rev-parse', '--verify', '--quiet', 'HEAD'], {
+        ...repoOptions,
+        allowExitCodes: [1],
+    }).catch(() => undefined);
+    const head = headResult?.exitCode === 0 ? headResult.stdout.trim() : undefined;
+    const branchResult = await runGit(['symbolic-ref', '--quiet', '--short', 'HEAD'], {
+        ...repoOptions,
+        allowExitCodes: [1],
+    }).catch(() => undefined);
+    const currentBranch = branchResult?.exitCode === 0 ? branchResult.stdout.trim() : undefined;
+    const detached = head != null && branchResult?.exitCode === 1;
+    const shallowResult = await runGit(['rev-parse', '--is-shallow-repository'], repoOptions).catch(() => undefined);
+    const shallow = shallowResult?.stdout.trim() === 'true';
+    const dirtyResult = await runGitRaw(['status', '--porcelain=v1', '-z'], {
+        ...repoOptions,
+        allowExitCodes: [128],
+    }).catch(() => undefined);
+    const isDirty = dirtyResult?.exitCode === 0 ? dirtyResult.stdout.length > 0 : false;
+    const defaultBranch = await detectDefaultBase(resolvedRoot, options).catch(() => undefined);
+    const info = {
+        repoRoot: resolvedRoot,
+        isDirty,
+        shallow,
+        detached,
+        gitVersion: version,
+    };
+    if (defaultBranch)
+        info.defaultBranch = defaultBranch;
+    if (head)
+        info.head = head;
+    if (currentBranch)
+        info.currentBranch = currentBranch;
+    return info;
+}
+export async function gitVersion(repoRoot = process.cwd(), options = {}) {
+    const result = await runGit(['version'], { ...options, repoRoot });
+    return result.stdout.trim();
+}
+async function verifyCommit(repoRoot, ref, options = {}) {
+    if (ref.startsWith('-')) {
+        throw new GitError('bad-ref', `Invalid ref "${ref}".`);
+    }
+    const result = await runGit(['rev-parse', '--verify', '--quiet', `${ref}^{commit}`], {
+        ...options,
+        repoRoot,
+        allowExitCodes: [1],
+    });
+    if (result.exitCode !== 0)
+        return undefined;
+    return result.stdout.trim() || undefined;
+}
+async function requireCommit(repoRoot, ref, options = {}) {
+    const resolved = await verifyCommit(repoRoot, ref, options);
+    if (!resolved)
+        throw new GitError('bad-ref', `Invalid ref "${ref}".`);
+    return resolved;
+}
+export async function detectDefaultBase(repoRoot = process.cwd(), options = {}) {
+    const originHead = await runGit(['symbolic-ref', '--quiet', '--short', 'refs/remotes/origin/HEAD'], {
+        ...options,
+        repoRoot,
+        allowExitCodes: [1],
+    }).catch(() => undefined);
+    const originHeadRef = originHead?.exitCode === 0 ? originHead.stdout.trim() : undefined;
+    if (originHeadRef && (await verifyCommit(repoRoot, originHeadRef, options)))
+        return originHeadRef;
+    for (const candidate of ['main', 'master', 'origin/main', 'origin/master', 'develop', 'trunk']) {
+        if (await verifyCommit(repoRoot, candidate, options))
+            return candidate;
+    }
+    const upstream = await runGit(['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{upstream}'], {
+        ...options,
+        repoRoot,
+        allowExitCodes: [128],
+    }).catch(() => undefined);
+    if (!upstream || upstream.exitCode !== 0)
+        return undefined;
+    const upstreamRef = upstream.stdout.trim();
+    const branch = await runGit(['symbolic-ref', '--quiet', '--short', 'HEAD'], {
+        ...options,
+        repoRoot,
+        allowExitCodes: [1],
+    }).catch(() => undefined);
+    const branchRemoteRef = branch?.exitCode === 0 ? `origin/${branch.stdout.trim()}` : undefined;
+    if (upstreamRef && upstreamRef !== branchRemoteRef && (await verifyCommit(repoRoot, upstreamRef, options))) {
+        return upstreamRef;
+    }
+    return undefined;
+}
+export async function gitMergeBase(base, head = DEFAULT_HEAD, options = {}) {
+    const repoRoot = resolveCwd(options);
+    await requireCommit(repoRoot, base, options);
+    await requireCommit(repoRoot, head, options);
+    const result = await runGit(['merge-base', base, head], {
+        ...options,
+        repoRoot,
+        allowExitCodes: [1],
+    });
+    const mergeBase = result.stdout.trim();
+    if (result.exitCode !== 0 || mergeBase.length === 0) {
+        throw new GitError('merge-base-failed', `Could not find a merge base for "${base}" and "${head}".`, {
+            exitCode: result.exitCode,
+            stderr: result.stderr.trim(),
+        });
+    }
+    return mergeBase;
+}
+function workingTreeRange() {
+    return { kind: 'working-tree', describe: 'working tree' };
+}
+function stagedRange(head) {
+    const range = { kind: 'staged', describe: 'staged' };
+    if (head) {
+        range.head = DEFAULT_HEAD;
+        range.resolvedHead = head;
+    }
+    return range;
+}
+export async function resolveDiffRange(options = {}) {
+    const repoRoot = resolveCwd(options);
+    const info = await preflightRepo(repoRoot, options);
+    if (!info.head && !info.currentBranch) {
+        throw new GitError('not-a-repo', 'Not a git repository.');
+    }
+    if (options.staged)
+        return stagedRange(info.head);
+    if (!info.head)
+        return workingTreeRange();
+    const explicitRange = options.base != null || options.head != null;
+    if (!explicitRange && info.isDirty)
+        return workingTreeRange();
+    const base = options.base ?? (await detectDefaultBase(info.repoRoot, options));
+    const head = options.head ?? DEFAULT_HEAD;
+    if (!base)
+        return workingTreeRange();
+    const resolvedBase = await requireCommit(info.repoRoot, base, options);
+    const resolvedHead = await requireCommit(info.repoRoot, head, options);
+    try {
+        const mergeBase = await gitMergeBase(base, head, { ...options, repoRoot: info.repoRoot });
+        return {
+            base,
+            head,
+            kind: 'three-dot',
+            mergeBase,
+            resolvedBase,
+            resolvedHead,
+            describe: `${base}...${head}`,
+        };
+    }
+    catch (error) {
+        if (!(error instanceof GitError) || error.code !== 'merge-base-failed')
+            throw error;
+        return {
+            base,
+            head,
+            kind: 'two-dot',
+            resolvedBase,
+            resolvedHead,
+            describe: `${base}..${head}`,
+        };
+    }
+}
+function parseGitVersion(version) {
+    const match = version?.match(/(\d+)\.(\d+)/);
+    if (!match)
+        return undefined;
+    return { major: Number.parseInt(match[1], 10), minor: Number.parseInt(match[2], 10) };
+}
+function supportsMergeBaseDiff(version) {
+    const parsed = parseGitVersion(version);
+    if (!parsed)
+        return true;
+    return parsed.major > 2 || (parsed.major === 2 && parsed.minor >= 30);
+}
+export function buildDiffRangeArgs(range, version) {
+    if (range.kind === 'working-tree')
+        return [];
+    if (range.kind === 'staged')
+        return ['--cached'];
+    if (range.kind === 'three-dot') {
+        if (supportsMergeBaseDiff(version) && range.base && range.head) {
+            return ['--merge-base', range.base, range.head];
+        }
+        if (range.mergeBase)
+            return [range.mergeBase, range.head ?? DEFAULT_HEAD];
+    }
+    if (range.base && range.head)
+        return [range.base, range.head];
+    if (range.resolvedBase && range.resolvedHead)
+        return [range.resolvedBase, range.resolvedHead];
+    if (range.head)
+        return [range.head];
+    return [];
+}
+//# sourceMappingURL=client.js.map