---

id: ab978b5d-a377-49fe-bb7f-1c6a013a60fe title: Git reader module (log/tree/show/diff/bundle/tarball) state: closed labels:

• area:git assignees: [] milestone: m1-code-tab created: 2026-09-10T03:52:24.202409062Z updated: 2026-09-10T04:04:31.370381550Z

---

Context: All pages need git data via CLI (no libgit2). Shared module used by code/commits/releases/bundle. Tasks:

• Module gitx: resolve_branch(repo, flag|env|main->master), rev_parse_short, log_n(100): sha,subject,author,date, ls_tree(branch, path), show(branch:path)->bytes, diff(sha)->unified text (capped, binary-aware).
• Shells out to git -C <repo> with timeout; non-UTF8 paths handled (lossy display + raw still exact); errors are typed, never panic.
• snapshot(repo, branch, out): git bundle create repo.bundle <branch> + repo.tar.gz via git archive.
• Unit tests with a temp fixture repo (init, 3 commits, branch, binary file). Success rubric:
• Tests green on fixture: log order, ls-tree dirs-first sort, show byte-exact, diff contains expected hunk, bundle clones (git clone repo.bundle works), tarball extracts.
• Missing branch -> loud error naming tried names. Non-repo path -> clean error, exit non-zero.
• No git command exceeds 10s (timeout tested with mocked GIT ceiling? at least timeout plumbed). Swarm: Owl/Platinum. Branch m1/gitx. No HTML in this issue.