orca/src/preload/api/git-operation-api.ts

import type {
  GitCommitAction,
  GitCommitActionResult
} from '../../shared/git/commands/git-commit-action'
import type {
  GitForkSyncExpectedUpstream,
  GitForkSyncResult
} from '../../shared/git/remotes/git-fork-sync'
import type { TuiAgent } from '../../shared/agent-launch/catalog/tui-agent'
import type { GitPushTarget } from '../../shared/worktree/types'
import type { GitStageWorktreeScope } from '../../shared/git/paths/git-stage-worktree-scope'
import type { ConflictResolution } from '../../shared/source-control/listing/source-control-entry-actions'
import type { HostedReviewProvider } from '../../shared/source-control/hosted-review/hosted-review-contracts'
import type { ResolvedSourceControlAiGenerationParams } from '../../shared/source-control/ai/source-control-ai-operation-resolution'
import type { SourceControlAiSettings } from '../../shared/source-control/ai/settings/source-control-ai-settings-types'
import type { TextGenerationFailureFields } from '../../shared/text-generation-failure-copy'

export type GitOperationApi = {
  appendGitignore: (args: { worktreePath: string; folderName: string }) => Promise<boolean>
  abortMerge: (args: { worktreePath: string; connectionId?: string }) => Promise<void>
  abortRebase: (args: { worktreePath: string; connectionId?: string }) => Promise<void>
  fetch: (args: {
    worktreePath: string
    connectionId?: string
    pushTarget?: GitPushTarget
  }) => Promise<void>
  syncFork: (args: {
    worktreePath: string
    connectionId?: string
    expectedUpstream: GitForkSyncExpectedUpstream
  }) => Promise<GitForkSyncResult>
  push: (args: {
    worktreePath: string
    publish?: boolean
    forceWithLease?: boolean
    connectionId?: string
    pushTarget?: GitPushTarget
  }) => Promise<void>
  pull: (args: {
    worktreePath: string
    connectionId?: string
    pushTarget?: GitPushTarget
  }) => Promise<void>
  fastForward: (args: {
    worktreePath: string
    connectionId?: string
    pushTarget?: GitPushTarget
  }) => Promise<void>
  rebaseFromBase: (args: {
    worktreePath: string
    baseRef: string
    connectionId?: string
  }) => Promise<void>
  commit: (args: {
    worktreePath: string
    message: string
    connectionId?: string
  }) => Promise<{ success: boolean; error?: string }>
  createBranch: (args: {
    worktreePath: string
    name: string
    startPoint: string
    connectionId?: string
  }) => Promise<GitCommitActionResult>
  cherryPick: (args: {
    worktreePath: string
    commitId: string
    connectionId?: string
  }) => Promise<GitCommitActionResult>
  revert: (args: {
    worktreePath: string
    commitId: string
    connectionId?: string
  }) => Promise<GitCommitActionResult>
  sequencerAbort: (args: {
    worktreePath: string
    operation: GitCommitAction
    connectionId?: string
  }) => Promise<void>
  sequencerContinue: (args: {
    worktreePath: string
    operation: GitCommitAction
    connectionId?: string
  }) => Promise<GitCommitActionResult | void>
  completeMerge: (args: {
    worktreePath: string
    connectionId?: string
  }) => Promise<{ success: boolean; error?: string }>
  generateCommitMessage: (args: {
    worktreePath: string
    /** Raw (unstripped) worktree meta key; validated against worktreePath in main. */
    worktreeId?: string
    repoId?: string
    connectionId?: string
    sourceControlAiResolvedParams?: ResolvedSourceControlAiGenerationParams
    sourceControlAi?: SourceControlAiSettings
    agentCmdOverrides?: Partial<Record<TuiAgent, string>>
  }) => Promise<
    | { success: true; message: string; agentLabel?: string }
    | ({ success: false; canceled?: boolean } & TextGenerationFailureFields)
  >
  cancelGenerateCommitMessage: (args: {
    worktreePath: string
    connectionId?: string
  }) => Promise<void>
  generatePullRequestFields: (args: {
    worktreePath: string
    /** Raw (unstripped) worktree meta key; validated against worktreePath in main. */
    worktreeId?: string
    repoId?: string
    base: string
    title: string
    body: string
    draft: boolean
    provider?: HostedReviewProvider
    useTemplate?: boolean
    connectionId?: string
    sourceControlAiResolvedParams?: ResolvedSourceControlAiGenerationParams
    sourceControlAi?: SourceControlAiSettings
    agentCmdOverrides?: Partial<Record<TuiAgent, string>>
  }) => Promise<
    | {
        success: true
        fields: { base: string; title: string; body: string; draft: boolean }
        agentLabel?: string
        branchChangedByPreparation?: boolean
      }
    | ({
        success: false
        canceled?: boolean
        branchChangedByPreparation?: boolean
      } & TextGenerationFailureFields)
  >
  cancelGeneratePullRequestFields: (args: {
    worktreePath: string
    connectionId?: string
  }) => Promise<void>
  stage: (args: { worktreePath: string; filePath: string; connectionId?: string }) => Promise<void>
  resolveConflict: (args: {
    worktreePath: string
    filePath: string
    resolution: ConflictResolution
    connectionId?: string
  }) => Promise<void>
  bulkStage: (args: {
    worktreePath: string
    filePaths: string[]
    connectionId?: string
    scope?: GitStageWorktreeScope
  }) => Promise<void>
  unstage: (args: {
    worktreePath: string
    filePath: string
    connectionId?: string
  }) => Promise<void>
  bulkUnstage: (args: {
    worktreePath: string
    filePaths: string[]
    connectionId?: string
  }) => Promise<void>
  discard: (args: {
    worktreePath: string
    filePath: string
    connectionId?: string
  }) => Promise<void>
  bulkDiscard: (args: {
    worktreePath: string
    filePaths: string[]
    connectionId?: string
  }) => Promise<void>
}