feat: add source control git graph (#1969)

Co-authored-by: Orca <help@stably.ai>
2026-09-23 00:02:29 +00:00 · 2026-05-16 04:44:44 -04:00
parent cc8488c5ee
commit ab53fb5c9e
51 changed files with 3694 additions and 179 deletions
@@ -0,0 +1,157 @@
+import { readBlobAtOid, type GitBufferExec, type GitExec } from './git-handler-ops'
+import { buildDiffResult, parseBranchDiff, parseBranchDiffNumstat } from './git-handler-utils'
+
+const FULL_GIT_OBJECT_ID_PATTERN = /^(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$/
+
+function assertFullGitObjectId(value: string, label: string): void {
+  if (!FULL_GIT_OBJECT_ID_PATTERN.test(value)) {
+    throw new Error(`${label} must be a full git object id`)
+  }
+}
+
+export async function commitCompare(git: GitExec, worktreePath: string, commitId: string) {
+  assertFullGitObjectId(commitId, 'commitId')
+  let commitOid = ''
+  try {
+    const { stdout } = await git(
+      ['rev-parse', '--verify', '--end-of-options', `${commitId}^{commit}`],
+      worktreePath
+    )
+    commitOid = stdout.trim()
+  } catch {
+    return {
+      summary: {
+        commitOid: '',
+        parentOid: null,
+        compareRef: commitId,
+        baseRef: 'parent',
+        changedFiles: 0,
+        status: 'invalid-commit',
+        errorMessage: `Commit ${commitId} could not be resolved in this repository.`
+      },
+      entries: []
+    }
+  }
+
+  const summary = {
+    commitOid,
+    parentOid: null as string | null,
+    compareRef: commitOid.slice(0, 7),
+    baseRef: 'empty tree',
+    changedFiles: 0,
+    status: 'ready' as const
+  }
+
+  try {
+    const { stdout: parentsOut } = await git(
+      ['rev-list', '--parents', '-n', '1', commitOid],
+      worktreePath
+    )
+    const [, firstParent] = parentsOut.trim().split(/\s+/)
+    summary.parentOid = firstParent ?? null
+    summary.baseRef = firstParent ? firstParent.slice(0, 7) : 'empty tree'
+
+    // Why: root commits have no parent tree; diff-tree --root asks git to
+    // compare against the repository's empty tree without hardcoding hash format.
+    const diffArgs = summary.parentOid
+      ? [
+          '-c',
+          'core.quotePath=false',
+          'diff',
+          '--name-status',
+          '-M',
+          '-C',
+          summary.parentOid,
+          commitOid
+        ]
+      : [
+          '-c',
+          'core.quotePath=false',
+          'diff-tree',
+          '--root',
+          '--no-commit-id',
+          '--name-status',
+          '-r',
+          '-M',
+          '-C',
+          commitOid
+        ]
+    const numstatArgs = summary.parentOid
+      ? [
+          '-c',
+          'core.quotePath=false',
+          'diff',
+          '--numstat',
+          '-M',
+          '-C',
+          summary.parentOid,
+          commitOid
+        ]
+      : [
+          '-c',
+          'core.quotePath=false',
+          'diff-tree',
+          '--root',
+          '--no-commit-id',
+          '--numstat',
+          '-r',
+          '-M',
+          '-C',
+          commitOid
+        ]
+    const [{ stdout }, { stdout: numstat }] = await Promise.all([
+      git(diffArgs, worktreePath),
+      git(numstatArgs, worktreePath)
+    ])
+    const entries = parseBranchDiff(stdout, parseBranchDiffNumstat(numstat))
+    summary.changedFiles = entries.length
+    return { summary, entries }
+  } catch (error) {
+    return {
+      summary: {
+        ...summary,
+        status: 'error',
+        errorMessage: error instanceof Error ? error.message : 'Failed to load commit diff'
+      },
+      entries: []
+    }
+  }
+}
+
+export async function commitDiffEntry(
+  gitBuffer: GitBufferExec,
+  worktreePath: string,
+  args: {
+    commitOid: string
+    parentOid?: string | null
+    filePath: string
+    oldPath?: string
+  }
+) {
+  assertFullGitObjectId(args.commitOid, 'commitOid')
+  if (args.parentOid) {
+    assertFullGitObjectId(args.parentOid, 'parentOid')
+  }
+  try {
+    const oldPath = args.oldPath ?? args.filePath
+    const left = args.parentOid
+      ? await readBlobAtOid(gitBuffer, worktreePath, args.parentOid, oldPath)
+      : { content: '', isBinary: false }
+    const right = await readBlobAtOid(gitBuffer, worktreePath, args.commitOid, args.filePath)
+    return buildDiffResult(
+      left.content,
+      right.content,
+      left.isBinary,
+      right.isBinary,
+      args.filePath
+    )
+  } catch {
+    return {
+      kind: 'text',
+      originalContent: '',
+      modifiedContent: '',
+      originalIsBinary: false,
+      modifiedIsBinary: false
+    }
+  }
+}