@jait/gateway 0.1.0

package/dist/services/git.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Server-side git operations service.
+ *
+ * Executes git and `gh` CLI commands in the requested working directory.
+ * Adapted from the t3code GitService/GitManager pattern but running
+ * directly through child_process on the gateway.
+ */
+export type GitStackedAction = "commit" | "commit_push" | "commit_push_pr";
+export interface GitStatusFile {
+    path: string;
+    insertions: number;
+    deletions: number;
+}
+export interface GitStatusPr {
+    number: number;
+    title: string;
+    url: string;
+    baseBranch: string;
+    headBranch: string;
+    state: "open" | "closed" | "merged";
+}
+export interface GitStatusResult {
+    branch: string | null;
+    hasWorkingTreeChanges: boolean;
+    workingTree: {
+        files: GitStatusFile[];
+        insertions: number;
+        deletions: number;
+    };
+    hasUpstream: boolean;
+    aheadCount: number;
+    behindCount: number;
+    pr: GitStatusPr | null;
+    /** Whether GitHub CLI (`gh`) is installed and authenticated. */
+    ghAvailable: boolean;
+}
+export interface GitBranch {
+    name: string;
+    isRemote: boolean;
+    current: boolean;
+    isDefault: boolean;
+    worktreePath: string | null;
+}
+export interface GitListBranchesResult {
+    branches: GitBranch[];
+    isRepo: boolean;
+}
+export interface GitStepResult {
+    commit: {
+        status: "created" | "skipped_no_changes";
+        commitSha?: string;
+        subject?: string;
+    };
+    push: {
+        status: "pushed" | "skipped_not_requested" | "skipped_up_to_date" | "skipped_no_remote";
+        branch?: string;
+        upstreamBranch?: string;
+        setUpstream?: boolean;
+        createPrUrl?: string;
+    };
+    branch: {
+        status: "created" | "skipped_not_requested";
+        name?: string;
+    };
+    pr: {
+        status: "created" | "opened_existing" | "skipped_not_requested" | "skipped_no_remote";
+        url?: string;
+        number?: number;
+        baseBranch?: string;
+        headBranch?: string;
+        title?: string;
+    };
+}
+export interface GitDiffResult {
+    diff: string;
+    files: string[];
+    hasChanges: boolean;
+}
+export interface FileDiffEntry {
+    path: string;
+    /** Original (HEAD) content, empty for new files */
+    original: string;
+    /** Current working-tree content, empty for deleted files */
+    modified: string;
+    /** 'A' = added, 'M' = modified, 'D' = deleted, 'R' = renamed, '?' = untracked */
+    status: string;
+}
+export interface GitPullResult {
+    status: "pulled" | "skipped_up_to_date";
+    branch: string;
+    upstreamBranch: string | null;
+}
+export interface GitWorktreeResult {
+    path: string;
+    branch: string;
+}
+export declare class GitService {
+    isRepo(cwd: string): Promise<boolean>;
+    init(cwd: string): Promise<void>;
+    status(cwd: string, _branch?: string, githubToken?: string): Promise<GitStatusResult>;
+    listBranches(cwd: string): Promise<GitListBranchesResult>;
+    pull(cwd: string): Promise<GitPullResult>;
+    runStackedAction(cwd: string, action: GitStackedAction, commitMessage?: string, featureBranch?: boolean, baseBranch?: string, githubToken?: string): Promise<GitStepResult>;
+    checkout(cwd: string, branch: string): Promise<void>;
+    createBranch(cwd: string, branch: string): Promise<void>;
+    /**
+     * Create a git worktree for a new branch.
+     * Worktrees live under ~/.jait/worktrees/{repoName}/{sanitizedBranch}.
+     * Uses `git worktree add -b <newBranch> <path> <baseBranch>`.
+     */
+    createWorktree(cwd: string, baseBranch: string, newBranch: string, customPath?: string): Promise<GitWorktreeResult>;
+    /** Remove a git worktree. */
+    removeWorktree(cwd: string, worktreePath: string, force?: boolean): Promise<void>;
+    /**
+     * Clean up a worktree directory created for a thread.
+     * Resolves the main repo root, runs `git worktree remove --force`,
+     * and falls back to deleting the directory if that fails.
+     * No-ops silently when the path is not a worktree or doesn't exist.
+     */
+    cleanupWorktree(worktreePath: string): Promise<void>;
+    /** Get the top-level git directory (the main repo root, even from a worktree). */
+    getMainRepoRoot(cwd: string): Promise<string>;
+    /** Check whether a named remote (e.g. "origin") exists. */
+    hasRemote(cwd: string, name: string): Promise<boolean>;
+    /** Get the remote URL for a named remote, or null if not set. */
+    getRemoteUrl(cwd: string, name: string): Promise<string | null>;
+    /** List configured remote names. */
+    listRemotes(cwd: string): Promise<string[]>;
+    /**
+     * Resolve the best remote for push/PR operations.
+     * Priority: branch-specific remote -> origin -> first configured remote.
+     * Falls back to main repo root remotes for worktrees.
+     */
+    getPreferredRemote(cwd: string, branch?: string): Promise<string | null>;
+    /**
+     * Resolve the repository's default branch (e.g. "main" or "master").
+     * Tries gh CLI first, then falls back to common defaults.
+     */
+    resolveDefaultBranch(cwd: string): Promise<string>;
+    private createGithubPrViaApi;
+    private fetchGithubPrByHead;
+    /**
+     * Generate a pull request body from the diff between base and head.
+     * Collects commit log + diff stat and formats as markdown.
+     */
+    generatePrBody(cwd: string, baseBranch: string, headBranch: string, prTitle: string): Promise<string>;
+    /**
+     * Build a URL to create a new pull request on the hosting provider.
+     * Supports GitHub, GitLab, Bitbucket, and Azure DevOps remote URLs.
+     */
+    buildCreatePrUrl(cwd: string, branch: string, remoteName?: string): Promise<string | undefined>;
+    /** Return the diff of uncommitted changes (staged + unstaged). */
+    diff(cwd: string): Promise<GitDiffResult>;
+    /**
+     * Return per-file original and modified content so the frontend can
+     * render a Monaco diff editor.
+     *
+     * @param baseBranch — when given, diff working tree against that branch
+     *   (shows all thread changes: committed + uncommitted). When omitted,
+     *   only uncommitted working-tree changes are returned (original = HEAD).
+     */
+    fileDiffs(cwd: string, baseBranch?: string): Promise<FileDiffEntry[]>;
+    /**
+     * Diff working tree against a base branch (shows all committed + uncommitted changes).
+     */
+    private fileDiffsBranch;
+}
+//# sourceMappingURL=git.d.ts.map

package/dist/services/git.d.ts.map

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