Skip to content

chore: add graphify knowledge graph output - #26

Merged
slverma merged 1 commit into
mainfrom
graphify
Jul 29, 2026
Merged

chore: add graphify knowledge graph output#26
slverma merged 1 commit into
mainfrom
graphify

Conversation

@slverma

@slverma slverma commented Jul 29, 2026

Copy link
Copy Markdown
Owner

Description

Summary

  • Adds graphify-out/graph.json, graph.html, GRAPH_REPORT.md, and .graphify_labels.json — a generated knowledge graph of the codebase (700 nodes, 1163 edges, 80 communities) produced by /graphify, so anyone can browse the architecture without re-running extraction.
  • Updates .gitignore to exclude local/derived graphify state (.graphify_python, .graphify_root, cache/, manifest.json, cost.json) that is either machine-specific (absolute paths, mtimes) or per-run telemetry that would generate noisy diffs on rebuild.

Notes

  • graph.html is a self-contained interactive viewer — open directly in a browser.
  • GRAPH_REPORT.md has the human-readable audit: god nodes, community breakdown, surprising/ambiguous connections, and suggested follow-up questions.
  • One node ID (scripts/deploy.sh's bash-entrypoint node) was manually corrected from an absolute-path-derived ID to scripts_deploy_sh__entry, matching the relative-path convention every other node uses.

Test plan

  • Verified graph.json is valid JSON
  • Swept all tracked graphify-out/ files for leaked local paths (git grep) — none found
  • Open graphify-out/graph.html in a browser and confirm it renders

Commits the generated graphify-out/ artifacts (graph.json, GRAPH_REPORT.md,
graph.html) so teammates can browse the codebase graph without re-running
extraction. Excludes .graphify_python, .graphify_root, cache/,
manifest.json, and cost.json, which are local machine state / per-run
telemetry rather than shareable graph content.

Renames the scripts/deploy.sh bash-entrypoint node from an absolute-path-
derived ID to scripts_deploy_sh__entry, matching the relative-path ID
convention every other node uses (graphify's bash extractor builds that
one node's ID from the raw path it's given, which leaked the local
checkout path since AST extraction was run with absolute paths).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@slverma
slverma merged commit b56e785 into main Jul 29, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant