Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs/CODE_MAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -181,6 +181,14 @@ A metric is its analyzer plus one catalog entry; the step-by-step checklist is `
| Before/after dependency graphs on one union layout (changed files center, importers left, imports right; added/removed edges; ghosts for absent files; "used by N" hubs; linked pan/zoom; expand) | `client/src/compare/CompareGraph.tsx`, model in `client/src/compare/graphModel.ts` (feeds `viz/deps/layout.ts:layoutViewSync`) |
| Shared bits (status icon, diffstat, health, magnitude and split bars), labels/formatting/health | `client/src/compare/bits.tsx`, `client/src/compare/metrics.ts` |

Ref picker rules:

- A PR's base is the merge-base of its own `baseRefName` and its head, as GitHub diffs it. PRs are often stacked, so the default branch is the wrong base.
- `gh` is a seam with a timeout and a stated failure reason. Without `gh` or a network, the picker still lists worktrees and branches, and free-text refs still work.
- The picker hides prunable worktrees. A worktree head is scanned in place. Compare never changes any worktree's state.
- A commit's result is cached by SHA. The stepper pre-warms the next commit, so stepping through a PR does not repeat cold scans.
- Phase timings show where a slow first run spends its time.

### Client: app shell and first run

| Feature | Where |
Expand Down
15 changes: 15 additions & 0 deletions docs/initiative-history.json
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,20 @@
"follow_ups": [
"Peripheral ideas C13-C15 (peek in context, surface a folder's most-used items, quieter dashed edges) were not planned milestones. Later work covers part of them: expand in place (#84, #91) and hub badges (#64)."
]
},
{
"title": "Compare ref picker: PRs, worktrees, commits",
"slug": "compare-ref-picker",
"outcome": "completed",
"retired_at": "2026-11-12",
"summary": "Compare now resolves pr:<n> refs through a gh seam with phase timings, offers a picker over PRs, worktrees and branches, compares another worktree on disk as the head, and steps through a PR commit by commit. Reconciled against origin/main 0bfb05ba.",
"reason": "All four milestones merged on 2026-10-15 (#47, #52, #54, #59).",
"documentation": [
"docs/CODE_MAP.md"
],
"revision": "0bfb05ba",
"follow_ups": [
"Evaluate dependency compare on a real PR (claim C7). Nothing tracks it."
]
}
]
115 changes: 0 additions & 115 deletions docs/intent/compare-ref-picker/implementation-plan.md

This file was deleted.

Loading
Loading