graphify-dotnet

graphify-dotnet

Trigger On

• graphify, graphify run, graphify watch, graphify benchmark, or graphify config
• generating graph.json, graph.html, graph.svg, graph.cypher, GRAPH_REPORT.md, obsidian/, or wiki/
• building onboarding maps, architecture snapshots, or dependency-discovery artifacts from a repository
• choosing between AST-only extraction and AI-enriched semantic extraction
• pushing graph output into Neo4j, Obsidian, wiki docs, or CI artifacts

Workflow

1. Confirm the problem is structural discovery, architecture review, onboarding, or graph export. If the user only needs one symbol lookup, one bug fix, or one dependency trace, normal repo search and tests are cheaper than a full graph run.
2. Install and verify the tool before doing anything else:

   dotnet --version
   dotnet tool install -g graphify-dotnet
   graphify --version
   

3. Start with a bounded AST-only run so the first output is fast and deterministic:

   graphify run ./src --format json,html,report --provider none --verbose
   

4. Review outputs in this order:
   • GRAPH_REPORT.md for quick signal
   • graph.html for visual exploration
   • graph.json for scripting and downstream tooling
5. Add AI enrichment only when inferred relationships or conceptual grouping matter more than strict syntax-only structure.
6. Expand export formats for the real consumer:
   • svg for static docs and PRs
   • neo4j for graph queries
   • obsidian,wiki for knowledge-base or onboarding flows
7. Use watch for iterative architecture work, but rerun a clean run periodically because deletes and renames can leave stale references behind.
8. Run benchmark only after you already trust the generated graph.json; its value is comparative token-reduction evidence, not billing-grade accounting.

Architecture

flowchart LR
  A["Repository or subtree"] --> B["graphify run / watch"]
  B --> C{"AI provider configured?"}
  C -->|No| D["AST extraction only"]
  C -->|Yes| E["AST + semantic extraction"]
  D --> F["Knowledge graph + Louvain communities"]
  E --> F
  F --> G{"Output target"}
  G -->|Human review| H["graph.html + GRAPH_REPORT.md"]
  G -->|Automation| I["graph.json"]
  G -->|Static docs| J["graph.svg"]
  G -->|Knowledge base| K["obsidian/ or wiki/"]
  G -->|Graph queries| L["graph.cypher for Neo4j"]