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
9 changes: 9 additions & 0 deletions docs/CODE_MAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -345,6 +345,15 @@ 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` |

Dependency view design:

- The server emits one language-neutral graph at the finest level it can resolve: a folder → file → symbol hierarchy plus edges flagged type-only, test, external or barrel. TypeScript and Python differ only in how they fill this contract.
- The client does all roll-up and budgeting (about 30–50 labeled boxes). A drill stays local and makes no request. The server caches the graph with the analysis.
- Groups come from folders and module boundaries, never from auto-clustering. Focus sits in the center, dependents to the left and dependencies to the right. Extra columns come from layering inside a side, still one hop out.
- External packages, tests and type-only imports are hidden by default. Barrels and `__init__` re-exports pass through to the defining module. External packages roll up by package, not by import string.
- Layout is our own grid and channel router in three pure stages: view model, grid layout, render. ELK was tried and dropped, because its packing and bundling could not be steered. Boxes never move after layout, because moving them is what made edges cross boxes.
- Edge thickness or a count shows aggregation, not color.

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

- Speed comes first. No legibility change may slow loading, focus or drill.
Expand Down
13 changes: 13 additions & 0 deletions docs/initiative-history.json
Original file line number Diff line number Diff line change
Expand Up @@ -56,5 +56,18 @@
],
"revision": "0bfb05ba",
"follow_ups": []
},
{
"title": "Multi-scale dependency view",
"slug": "dependency-view",
"outcome": "completed",
"retired_at": "2026-11-12",
"summary": "A multi-scale dependency view replaced the legacy graph: one language-neutral folder → file → symbol contract for TypeScript and Python, client-side roll-up, a custom grid and channel layout, and symbol-level focus. Reconciled against origin/main 0bfb05ba.",
"reason": "All five milestones were marked completed and their PRs merged on 2026-10-15 (#14, #16, #18, #21, #26).",
"documentation": [
"docs/CODE_MAP.md"
],
"revision": "0bfb05ba",
"follow_ups": []
}
]
122 changes: 0 additions & 122 deletions docs/intent/dependency-view/implementation-plan.md

This file was deleted.

Loading
Loading