chatroom-cli 1.30.1 → 1.32.1

package/dist/infrastructure/git/git-reader.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Git command execution wrappers.
+ *
+ * All functions return discriminated unions — no throws.
+ * Errors from git (non-zero exit) or missing git installation are
+ * captured and returned as `{ status: 'error' }` or `{ status: 'not_found' }`.
+ */
+import type { DiffStat, GitBranchResult, GitCommit, GitCommitDetailResult, GitDiffStatResult, GitFullDiffResult, GitPullRequest } from './types.js';
+/**
+ * Returns `true` if `workingDir` is inside a git repository.
+ * Returns `false` for non-git directories, missing git, or any error.
+ */
+export declare function isGitRepo(workingDir: string): Promise<boolean>;
+/**
+ * Returns the current branch name for the repository at `workingDir`.
+ *
+ * For a detached HEAD, returns `{ status: 'available', branch: 'HEAD' }`.
+ * For a non-git directory, returns `{ status: 'not_found' }`.
+ */
+export declare function getBranch(workingDir: string): Promise<GitBranchResult>;
+/**
+ * Returns `true` if the working tree has uncommitted changes (staged or unstaged).
+ * Returns `false` for a clean tree, empty repo, or non-git directory.
+ */
+export declare function isDirty(workingDir: string): Promise<boolean>;
+/**
+ * Parses `--stat` output into a `DiffStat`.
+ * Input: the summary line, e.g. "3 files changed, 45 insertions(+), 12 deletions(-)"
+ * Returns zero values if the tree is clean or the line cannot be parsed.
+ *
+ * Exported for direct unit testing.
+ */
+export declare function parseDiffStatLine(statLine: string): DiffStat;
+/**
+ * Returns diff statistics (files changed, insertions, deletions) for the current
+ * working tree against HEAD (`git diff HEAD --stat`).
+ *
+ * Returns zero-value stats for a clean tree (no changes).
+ */
+export declare function getDiffStat(workingDir: string): Promise<GitDiffStatResult>;
+/**
+ * Returns the full unified diff for the current working tree against HEAD.
+ * Content is capped at `FULL_DIFF_MAX_BYTES` (500 KB).
+ *
+ * Note: Binary files appear as "Binary files differ" in the output — handled
+ * transparently (no special treatment needed; output is valid UTF-8 text).
+ */
+export declare function getFullDiff(workingDir: string): Promise<GitFullDiffResult>;
+/**
+ * Returns diff statistics for a PR (diff between origin/<baseBranch> and HEAD).
+ * Uses three-dot syntax to diff from the merge-base.
+ */
+export declare function getPRDiffStat(workingDir: string, baseBranch: string): Promise<GitDiffStatResult>;
+/**
+ * Returns the full unified PR diff (diff between origin/<baseBranch> and HEAD).
+ * Uses three-dot syntax to diff from the merge-base.
+ * Content is capped at `FULL_DIFF_MAX_BYTES` (500 KB).
+ */
+export declare function getPRDiff(workingDir: string, baseBranch: string): Promise<GitFullDiffResult>;
+/**
+ * Returns the diff for a specific PR by number using `gh pr diff <number>`.
+ * Content is capped at `FULL_DIFF_MAX_BYTES` (500 KB).
+ */
+export declare function getPRDiffByNumber(cwd: string, prNumber: number): Promise<GitFullDiffResult>;
+/**
+ * Returns up to `count` recent commits from the current branch.
+ * Default: 20 commits. Optional `skip` to paginate (0-based offset).
+ *
+ * Returns an empty array for an empty repository (no commits).
+ * Returns an empty array for non-git directories (does not throw).
+ */
+export declare function getRecentCommits(workingDir: string, count?: number, skip?: number): Promise<GitCommit[]>;
+/**
+ * Returns the full diff for a specific commit SHA (`git show <sha>`).
+ * Content is capped at `FULL_DIFF_MAX_BYTES` (500 KB).
+ *
+ * Returns `{ status: 'not_found' }` if the SHA does not exist in the
+ * repository, or if the repository has no commits yet (empty repo).
+ */
+export declare function getCommitDetail(workingDir: string, sha: string): Promise<GitCommitDetailResult>;
+/**
+ * Returns commit metadata (message, author, date) for a specific SHA.
+ *
+ * Uses `git log -1 --format=...` with null-byte separators for safe parsing.
+ * Returns `null` if the SHA is not found or the directory is not a git repo.
+ */
+export declare function getCommitMetadata(workingDir: string, sha: string): Promise<{
+    message: string;
+    author: string;
+    date: string;
+} | null>;
+/**
+ * Parse a git remote URL into an `owner/repo` slug.
+ * Handles both HTTPS and SSH URL formats, with or without `.git` suffix.
+ *
+ * Examples:
+ *   https://github.com/owner/repo.git → owner/repo
+ *   https://github.com/owner/repo     → owner/repo
+ *   git@github.com:owner/repo.git     → owner/repo
+ *   git@github.com:owner/repo         → owner/repo
+ *
+ * Returns `null` if the URL cannot be parsed.
+ *
+ * Exported for unit testing.
+ */
+export declare function parseRepoSlug(remoteUrl: string): string | null;
+/**
+ * Get the `owner/repo` slug for the `origin` remote of the repository at `cwd`.
+ *
+ * Returns `null` if:
+ * - The `origin` remote does not exist
+ * - The URL cannot be parsed
+ * - Any error occurs (graceful degradation)
+ *
+ * Exported for unit testing.
+ */
+export declare function getOriginRepoSlug(cwd: string): Promise<string | null>;
+/**
+ * Get open pull requests for the given branch using `gh pr list`.
+ *
+ * Returns an empty array if:
+ * - The `gh` CLI is not installed
+ * - The user is not authenticated with `gh`
+ * - There are no open PRs for the branch
+ * - Any error occurs (graceful degradation)
+ */
+export declare function getOpenPRsForBranch(cwd: string, branch: string): Promise<GitPullRequest[]>;
+/**
+ * Get all pull requests (open, closed, merged) for the repository using `gh pr list`.
+ * Returns up to 20 most recent PRs.
+ */
+export declare function getAllPRs(cwd: string): Promise<GitPullRequest[]>;
+/** A commit entry from `gh pr view --json commits`. */
+export interface PRCommitEntry {
+    sha: string;
+    shortSha: string;
+    message: string;
+    author: string;
+    date: string;
+}
+/**
+ * Get the list of commits for a specific PR number.
+ * Uses `gh pr view <number> --json commits`.
+ */
+export declare function getPRCommits(cwd: string, prNumber: number): Promise<PRCommitEntry[]>;
+/** A single git remote entry (from `git remote -v`). */
+export interface GitRemoteEntry {
+    /** Remote name (e.g. 'origin', 'upstream'). */
+    name: string;
+    /** Remote URL (HTTPS or SSH). */
+    url: string;
+}
+/**
+ * Get all configured git remotes for the repository at `cwd`.
+ *
+ * Runs `git remote -v` and deduplicates (keeping fetch entries).
+ * Returns an empty array if no remotes are configured or the command fails.
+ */
+export declare function getRemotes(cwd: string): Promise<GitRemoteEntry[]>;
+/**
+ * Returns the number of commits on the current branch that are ahead of the
+ * tracking remote branch (i.e. unpushed commits).
+ *
+ * Uses `git rev-list --count @{upstream}..HEAD` which counts commits reachable
+ * from HEAD but not from the upstream tracking branch.
+ *
+ * Returns 0 if:
+ *  - There is no upstream configured for the current branch
+ *  - The repository has no commits
+ *  - The directory is not a git repository
+ *  - Any other error occurs
+ *
+ * This is intentionally lenient — unpushed count is supplementary info and
+ * should never cause the git state push to fail.
+ */
+export declare function getCommitsAhead(workingDir: string): Promise<number>;
+/** A single CI/CD check run. */
+export interface CommitStatusCheckRun {
+    name: string;
+    status: string;
+    conclusion: string | null;
+}
+/** Combined commit status check result. */
+export interface CommitStatusCheck {
+    /** Overall combined status: 'success' | 'failure' | 'pending' | 'error' | 'neutral' */
+    state: string;
+    /** Individual check runs */
+    checkRuns: CommitStatusCheckRun[];
+    /** Total number of status checks */
+    totalCount: number;
+}
+/**
+ * Get CI/CD commit status checks for a given ref (branch or SHA).
+ *
+ * Uses `gh api` to fetch check runs and combined commit status.
+ * Returns null if `gh` is unavailable or any error occurs (non-blocking).
+ */
+export declare function getCommitStatusChecks(cwd: string, ref: string): Promise<CommitStatusCheck | null>;
+/**
+ * Get the default branch name for the repository (e.g. 'main', 'master').
+ *
+ * Uses `gh api` to query the repo metadata.
+ * Returns null if `gh` is unavailable or any error occurs.
+ */
+export declare function getDefaultBranch(cwd: string): Promise<string | null>;
+//# sourceMappingURL=git-reader.d.ts.map

package/dist/infrastructure/git/git-reader.d.ts.map

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