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

说明与用途

最初在13个未见仓库中失败的架构图生成工具，通过改进依赖解析规则，现在能够准确解析Java、Kotlin、Go、Rust、JavaScript、TypeScript和Python等多种语言的依赖，生成无缺口的架构图。

问题

A repository‑analysis tool that draws architecture diagrams failed to resolve references in 13 unseen repositories, producing many false gaps and missing edges.

结果

After applying stricter resolution logic, the tool accurately resolves dependencies across Java, Kotlin, Go, Rust, JavaScript, TypeScript, and Python, producing gap‑free diagrams for most tested repositories.

工作流

• 1. Install the CLI via npm: npm i -g mirofy-cli
• 2. Run the tool against a repository: npx mirofy-cli map .
• 3. Inspect the generated HTML diagram for gaps and edges
• 4. Verify any reported gaps by checking the cited file, line, and commit
• 5. If gaps exist, adjust the source code or report the issue to the tool maintainers

证据

I built a tool that draws architecture diagrams from a repository, where every edge cites the file, line and commit it came from.

来源

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 — click an arrow, see the import statement.

来源

Reads JavaScript, TypeScript, Python, Go, Java, Rust and Kotlin. Resolves against what a repository declares — the module path in go.mod, the package statements in .java files, the paths in Cargo.toml — rather than against directory conventions.

来源