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
12 changes: 12 additions & 0 deletions docs/CODE_MAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -324,6 +324,18 @@ Plan: `docs/intent/symbol-graph/`. Backlog area `area-symbol-graph` in `pgm/data
| Folder contents on graph boxes (children by LOC as a colored strip; "Largest inside" in the hover card) | `viz/deps/metrics.ts` (`viewContents`, `stripSegments`); `ContentsStrip` and `NodeCard` in `viz/deps/DependencyCanvas.tsx` |
| Local dependency-graph fixtures for layout tests (gitignored `__fixtures__/local/`) | `scripts/capture-dep-graph.sh` |

Graph legibility rules (keep these when you change the layout or canvas):

- Speed comes first. No legibility change may slow loading, focus or drill.
- Every box is one uniform grid cell. A box never spans rows, because the router needs free gutters from end to end. A folder shows its size with a bar and summary lines inside its cell.
- `rankPackings` packs a mid-level view to the viewport's shape (aspect within 0.5–2×), not into a long strip.
- Neighbors group by package or folder, then by owning file, from the hierarchy, not from clustering. Each group is contiguous in its column with a labeled frame. Ordering runs per group first, then inside the group.
- A file that exports one used symbol draws as that symbol, with the file name as quiet context.
- Color and LOC join on the client by `absPath` against the treemap tree (`metrics.ts`). The graph payload carries no metrics. A metric switch re-tints without relayout. A box with no treemap match gets a neutral fill and no LOC.
- Edge bundles spread by edge count (`bundleOffsets` in `layout.ts`), capped so a large trunk stays one trunk.
- Compare mode shares `layoutViewSync`, so its tests must stay green after a layout change.
- Commit no private repository's graph JSON. Use srcly's own fixture, small synthetic graphs, or the gitignored local fixtures.

### Client: UI primitives

| Primitive | Where |
Expand Down
17 changes: 17 additions & 0 deletions docs/initiative-history.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
[
{
"title": "Dependency graph legibility",
"slug": "dependency-graph-legibility",
"outcome": "completed",
"retired_at": "2026-11-12",
"summary": "The dependency graph now packs mid-level views to the viewport, draws two-line boxes with distinct, size-aware folders, groups neighbors by package then file, takes color and LOC from the treemap, and spreads edge bundles. Reconciled against origin/main 0bfb05ba.",
"reason": "All five milestones merged on 2026-10-15 (#50, #56, #58, #60, #61).",
"documentation": [
"docs/CODE_MAP.md"
],
"revision": "0bfb05ba",
"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)."
]
}
]
134 changes: 0 additions & 134 deletions docs/intent/dependency-graph-legibility/implementation-plan.md

This file was deleted.

Loading
Loading