What's new in v0.2.0
Mine the "why"
Code comments and docstrings are now first-class graph nodes. Module, class, and function docstrings are extracted automatically. Inline comments tagged # NOTE:, # IMPORTANT:, # HACK:, # WHY:, # RATIONALE:, # TODO:, # FIXME: become rationale_for nodes connected to the code entity they explain. Doc files now extract design rationale and architectural decisions too - not just structure, but why things were built that way.
Confidence scores on every edge
Every INFERRED edge now carries a confidence_score (0.0-1.0). EXTRACTED edges are always 1.0. INFERRED edges score 0.4-0.9 based on how certain the model was. AMBIGUOUS edges score 0.1-0.3. You know not just what was guessed but how confident.
Semantic similarity edges
Cross-file conceptual links with no structural connection. Two functions solving the same problem without calling each other, a class in code and a concept in a paper describing the same algorithm. Tagged semantically_similar_to with a confidence score.
Hyperedges
Group relationships connecting 3+ nodes that pairwise edges cannot express. All classes implementing a shared protocol, all functions in an auth flow, all concepts from a paper section forming one coherent idea. Stored in a top-level hyperedges array in graph.json.
Git hooks - post-checkout added
graphify hook install now installs both post-commit (existing) and post-checkout (new). The graph rebuilds automatically when you switch branches, not just when you commit.
Claude Code PreToolUse hook
graphify claude install now also writes a .claude/settings.json hook that fires before every Glob and Grep call. If a graphify knowledge graph exists, Claude is reminded to check it before searching raw files. Ensures the graph is actually used during research, not bypassed.
Obsidian output opt-in
Obsidian vault generation (--obsidian) is now opt-in. Default output is graph.html + graph.json + GRAPH_REPORT.md. Large repos were generating thousands of files by default.
Upgrade
pip install --upgrade graphifyy
graphify install