graph

What it draws

One HTML file, no server: the codanna index rendered as a pie chart of symbols. Each top-level module owns a wedge sized by its share; inside a wedge symbols fill rings from the centre outwards, best-connected first, so hubs sit near the middle and leaves on the rim. Unlinked symbols form their own inner group. Above the disc a heatmap shows symbols added per day (each symbol dated by the oldest surviving line of its span, via git blame). Hover or click a symbol to see its edge web and the connected symbols; the legend hides (eye) or highlights (label) modules and submodules; the ribbon under the heatmap brushes a date range (drag its handles, use the date fields, or click a year chip) and Refresh replays the codebase growing oldest-first.

Run

node ${CLAUDE_SKILL_DIR}/graph.mjs                      # whole index, Calls edges, default kinds
node ${CLAUDE_SKILL_DIR}/graph.mjs --root crate::indexing   # one module family
node ${CLAUDE_SKILL_DIR}/graph.mjs --relation calls,uses,implements,extends
node ${CLAUDE_SKILL_DIR}/graph.mjs --kinds function,method,struct,trait --dates none --light

• Runs codanna dump in the project (--from graph.jsonl reuses a saved dump, --binary PATH picks the binary)
• Output: .codanna/visualizations/graph-disc-<timestamp>.html, opened in the browser (--no-open to skip, --out FILE to place it)
• --group <wedge>[/<tint>] -- wedge axis module (default), language, or kind; tint axis module (default), kind, or visibility. The wedge is the angle (share, neighbours adjacent); the tint is the legend tree inside it (three biggest get their own shade, the rest pool). module/kind keeps the structure and shows what each module is made of; language/module for polyglot indexes; module/visibility for API surface per module; kind/module is a census (edges cross everywhere)
• --root PREFIX scopes to a module prefix (crate:: is dropped, ./::// all separate segments); applies to the module segments whatever the wedge axis
• --kinds defaults to Function, Method, Struct, Class, Trait, Enum, Interface, TypeAlias, Constant, Macro
• --relation defaults to calls; any of calls, uses, implements, extends, defines, comma-separated
• --dates blame|git|none -- blame (default) dates every symbol by the oldest surviving line of its span (git blame -M over the working tree; per-file JSON cache at .codanna/visualizations/dates-cache.json keyed by content hash, so warm runs spawn no blame -- delete the file to reset); git uses the file's first-commit day (cheap, but a refactor reads as mass birth); none leaves the timeline and heatmap empty
• --unlinked include|drop -- drop removes symbols with no edge over the chosen relations at build time (smaller file, smaller disc); in the page, the legend eye on (unlinked) hides the same set with the cascade animation
• --name NAME sets the title (default: project directory name); --light builds the light theme