feat: add human-friendly architecture dashboard#551
Open
kluacisco888 wants to merge 5 commits intosafishamsi:v4from
Open
feat: add human-friendly architecture dashboard#551kluacisco888 wants to merge 5 commits intosafishamsi:v4from
kluacisco888 wants to merge 5 commits intosafishamsi:v4from
Conversation
safishamsi#524 graphify-out excluded from source scan
…ard, label dedup, chunk-suffix prompt block
ea6da92 to
afe053a
Compare
Add dashboard.py that generates a single-page HTML architecture overview from graph.json, designed for human team members and onboarding. - Merges fine-grained Leiden communities into 5-10 macro-modules - Auto-detects architectural layers (frontend/backend/engine/data/tools/tests) - Renders Mermaid.js flowchart with layered subgraphs and directional arrows - Module cards with key files, top nodes, and cross-module dependencies - PageRank-based recommended reading order for new team members - LLM-optional: auto-infers names, accepts override names and descriptions - CLI: graphify dashboard [--graph path] [--output path] - Skill: auto-generates in Step 6c of /graphify pipeline - No new dependencies (Mermaid.js via CDN)
afe053a to
0c22041
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
dashboard.pythat generates a single-page HTML architecture overview fromgraph.jsonMotivation
The current outputs (
GRAPH_REPORT.md,graph.html) are optimized for AI consumption. For human team members — especially during onboarding — a 453-line report and a 1953-node force graph are overwhelming. This dashboard provides a simplified, human-first view of the same data.What's included
New:
graphify/dashboard.py(~500 lines)merge_communities()— groups fine-grained communities into 5-10 macro-modules by cross-community edge density + directory structure_macro_metadata()— extracts node count, file count, key files, top nodes, inter-module dependencies_infer_module_name()— auto-names modules from directory structure and node labelsbuild_description_prompt()— generates a prompt for the host LLM to produce one-line business descriptions_reading_order()— PageRank-based recommended reading order for new team membersgenerate_dashboard()— public API, accepts optionalnamesanddescriptionsoverridesgraph.htmlModified:
graphify/__main__.pygraphify dashboardCLI command with--graphand--outputflagsModified:
graphify/skill.md/graphifypipelineUsage
Design decisions