13 repositories, 13 bugs: what open source taught me about my own tool

说明与用途

一款从源代码生成架构图的工具在13个仓库中发现13个错误后进行了改进。修复了包前缀匹配、嵌套类型导入、静态导入、排除build目录、非src Rust crate以及Kotlin/Java混合命名空间等问题。更新后的工具现在能生成准确的图表，未解析引用极少。

问题

A tool that generates architecture diagrams from source code must correctly resolve all references; otherwise it silently drops or misrepresents dependencies, leading to misleading diagrams.

结果

The updated tool accurately resolves dependencies across Java, Kotlin, Go, Rust, JavaScript, TypeScript, and Python, producing diagrams with no unresolved references in most test cases.

工作流

• 1. Run the tool against a repository using npx mirofy-cli map .
• 2. Inspect the generated HTML diagram for gaps and missing edges
• 3. Identify language‑specific resolution issues (e.g., package prefixes, nested types, static imports, build directories, non‑src crates, test crates, fun interfaces, snake‑case constants, mixed Kotlin/Java namespaces)
• 4. Update the resolver logic to handle each case correctly
• 5. Re‑run the tool and verify that gaps are reduced or eliminated
• 6. Repeat for additional repositories to ensure robustness

证据

Across the thirteen repositories: 278,982 facts from 85,930 files. Four came out with zero unresolved references.

来源

The rule the tool works by: Nothing is drawn that cannot be cited. Every edge in the output carries the file, the line and the commit that justifies it.

来源