whaojie797-design/diagram-drift

README 摘要

diagram-drift Detect drift between a Mermaid architecture diagram and the codebase it describes. 架构图漂移检测器：给 Agent 一份 Mermaid 架构图（ graph / flowchart ）和一个代码库， check 会精准报告「图里画的节点代码里还有没有、图中断言的依赖关系代码里是否成立」。 Before / After Before — An architecture diagram is decoration. Nobody re-checks it against the code, so it slowly lies: a deleted module is still drawn, an edge claims a dependency that no longer exists. After — A precise drift report: which nodes in the diagram have no matching definition in code, which diagram edges the code doesn't actually honor, and which real modules the diagram forgot to draw. What it does - check — parse a Mermaid graph / flowchart , scan the codebase for definitions ( class / def /module names) and import/call relationships, then classify every node and edge. - report — re-render the last DRIFT REPORT.md from the store. - Output — DRIFT REPORT.md (human) + drift-state.json (machine-readable, so an agent can read it directly). - Zero third-party dependencies — pure standard library; Python uses ast , JS/TS/Go and other languages use regex heuristics. No pip install . Drift types Type Meaning Severity missing-in-code A diagram node has no matching definition/m…

分类