@maudecode/talaria-web 0.0.0

package/dist/workspace/git.d.ts

@@ -0,0 +1,204 @@
+export declare const GIT_TIMEOUT_MS = 5000;
+export declare const GIT_REMOTE_TIMEOUT_MS = 60000;
+export declare const STATUS_FILE_LIMIT = 500;
+export declare const STATUS_CACHE_TTL_MS = 2000;
+export declare const STATUS_CACHE_LIMIT = 32;
+export declare const DIFF_SIZE_LIMIT: number;
+export declare const COMMIT_MESSAGE_DIFF_LIMIT: number;
+export declare const WORKSPACE_GIT_DESTRUCTIVE_ENV = "HERMES_WEBUI_WORKSPACE_GIT_DESTRUCTIVE";
+export declare class GitWorkspaceError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+export interface GitContext {
+    workspace: string;
+    repoRoot: string;
+    workspacePrefix: string;
+}
+export interface GitFile {
+    path: string;
+    old_path: string | null;
+    workspace_path: string;
+    status: string;
+    staged: boolean;
+    unstaged: boolean;
+    untracked: boolean;
+    ignored: boolean;
+    conflict: boolean;
+    additions: number;
+    deletions: number;
+    binary: boolean;
+}
+export interface GitTotals {
+    changed: number;
+    staged: number;
+    unstaged: number;
+    untracked: number;
+    conflicts: number;
+}
+export interface GitStatus {
+    is_git: boolean;
+    branch?: string;
+    upstream?: string;
+    ahead?: number;
+    behind?: number;
+    totals?: GitTotals;
+    files?: GitFile[];
+    truncated?: boolean;
+    noise_filtering?: {
+        filemode_only: number;
+        crlf_only: number;
+        active: boolean;
+    };
+}
+export interface GitRef {
+    name: string;
+    sha: string;
+    updated: number;
+    updated_relative: string;
+    author: string;
+    subject: string;
+    upstream: string;
+    ahead: number;
+    behind: number;
+}
+export interface GitBranches {
+    is_git: true;
+    current: string;
+    detached: boolean;
+    head: string;
+    local: GitRef[];
+    remote: GitRef[];
+    upstream: string;
+    ahead: number;
+    behind: number;
+}
+export interface GitDiff {
+    path: string;
+    kind: string;
+    binary: boolean;
+    too_large: boolean;
+    additions: number;
+    deletions: number;
+    diff: string;
+}
+export interface GitRunnerDeps {
+    env: Record<string, string | undefined>;
+    /** Generates commit messages from a prompt (sidecar `aux.complete`). */
+    now?: () => number;
+}
+interface RunOptions {
+    timeoutMs?: number;
+    check?: boolean;
+    env?: Record<string, string>;
+    destructive?: boolean;
+    forceDestructiveHardening?: boolean;
+    disableFilterAttributes?: boolean;
+    neutralizeFilterPrograms?: boolean;
+    neutralizeRemoteHelpers?: boolean;
+    input?: string;
+}
+export interface GitResult {
+    status: number;
+    stdout: string;
+    stderr: string;
+}
+export declare function classifyGitError(message: string, args?: string[]): string;
+export declare class GitRunner {
+    readonly deps: GitRunnerDeps;
+    private readonly locks;
+    private readonly statusCache;
+    private readonly generations;
+    constructor(deps: GitRunnerDeps);
+    destructiveEnabled(): boolean;
+    private cleanEnv;
+    private now;
+    private rawGit;
+    private configNamesForScope;
+    private namesLocalAndWorktree;
+    private filterNames;
+    private mergeDriverNames;
+    private remoteHelperNames;
+    private static legal;
+    hasRepoLocalFilters(cwd: string): boolean;
+    run(ctxOrCwd: GitContext | string, args: string[], opts?: RunOptions): GitResult;
+    resolveContext(workspace: string): GitContext | null;
+    private static workspacePathspec;
+    private static repoRel;
+    private static workspaceRel;
+    private withMutationLock;
+    private static resolveGitDir;
+    private statusFingerprint;
+    private cachedStatus;
+    private storeStatus;
+    invalidateStatusCache(repoRoot: string): void;
+    private static statusCode;
+    private parseNumstat;
+    private collectNumstat;
+    /** An untracked file's bytes through the anchored walk (no symlinked component), or null when unreadable/too large. */
+    private static readUntracked;
+    private static countUntrackedFile;
+    status(workspace: string, opts?: {
+        useCache?: boolean;
+    }): GitStatus;
+    private branchAheadBehind;
+    private forEachRef;
+    branches(workspace: string): GitBranches;
+    private validateLocalBranch;
+    private validateRemoteBranch;
+    private validateCheckoutStart;
+    private validateNewBranchName;
+    private dirtyWorktree;
+    private currentCheckoutLabel;
+    private static stashSubjectParts;
+    private branchSwitchStashes;
+    private restoreBranchSwitchStashLocked;
+    private validateCheckoutRequestLocked;
+    private performCheckoutLocked;
+    private static remoteMessage;
+    checkout(workspace: string, ref: string, mode: string, opts?: {
+        newBranch?: string | null;
+        track?: boolean;
+        dirtyMode?: string;
+    }): Promise<Record<string, unknown>>;
+    stashAndCheckout(workspace: string, ref: string, mode: string, opts?: {
+        newBranch?: string | null;
+        track?: boolean;
+    }): Promise<Record<string, unknown>>;
+    private static syntheticUntrackedDiff;
+    diff(workspace: string, path: string, kind?: string): GitDiff;
+    private static cleanPaths;
+    private static pathspecs;
+    private blockFilteredDestructiveWrite;
+    private requireContext;
+    stage(workspace: string, paths: Iterable<unknown>): Promise<GitStatus>;
+    unstage(workspace: string, paths: Iterable<unknown>): Promise<GitStatus>;
+    discard(workspace: string, paths: Iterable<unknown>, opts?: {
+        deleteUntracked?: boolean;
+    }): Promise<GitStatus>;
+    private stagedDiffText;
+    private static capDiff;
+    private selectedTempIndexEnv;
+    private selectedFiles;
+    private selectedDiffText;
+    private static fileLines;
+    selectedCommitMessagePrompt(workspace: string, paths: Iterable<unknown>): CommitMessagePrompt;
+    stagedCommitMessagePrompt(workspace: string): CommitMessagePrompt;
+    commit(workspace: string, message: string): Promise<Record<string, unknown>>;
+    commitSelected(workspace: string, message: string, paths: Iterable<unknown>): Promise<Record<string, unknown>>;
+    private branchName;
+    fetch(workspace: string): Promise<Record<string, unknown>>;
+    pull(workspace: string): Promise<Record<string, unknown>>;
+    push(workspace: string): Promise<Record<string, unknown>>;
+}
+export interface CommitMessagePrompt {
+    system_prompt: string;
+    user_prompt: string;
+    truncated: boolean;
+    status: GitStatus;
+}
+export declare const COMMIT_MESSAGE_SYSTEM_PROMPT = "When writing commit messages, PR titles, or PR descriptions:\n\n- Inspect the staged diff before suggesting a commit message.\n- Do not use vague subjects like \"update\", \"improve\", \"refine\", \"misc changes\", \"fix stuff\", or \"various changes\".\n- For large commits, write a concise subject plus a short body with 2-5 bullets summarizing the main areas changed.\n- The subject should describe the actual user-facing result or bug fixed, not just broad implementation activity.\n- Keep wording short, clear, and natural.\n- Never mention AI, Cursor, Zed, agents, or similar tooling in commits, branch names, PR titles, or PR descriptions.\n- Never add your own thoughts or questions into the commit message, the commit message is definitive in nature.\n\nReturn only the commit message text. Do not wrap it in Markdown fences.";
+export declare function cleanGeneratedCommitMessage(message: unknown): string;
+/** Ensure a git repository exists at `dir` (tests and the worktree helper). */
+export declare function ensureDir(dir: string): void;
+export {};