[mick-gsk]

Closes #779. I opened it as a good-first-issue; a contributor magnet only works once contributors exist, and shipping it widens the audience now.

Measured on real Go repositories

	files	speaks on
cobra	36	0.0 %
gin	99	2.0 %

gin's two are real — Binding is defined in both binding.go and binding_nomsgpack.go.

Two decisions worth naming

Methods on receivers are not indexed. #779 argued for including them, since func (s *Store) Validate() is package-level API in Go. The noise measurement that came between then and now argued louder: String, Error, Read and Close sit on every type in a package, and methods are excluded in Python and TypeScript for exactly that reason. Evidence beat the plan, and the test says so.

Trailing-segment matching is reserved for Go. Go imports carry the whole module path (github.com/org/repo/internal/db) while the repository knows itself as internal/db, so the resolver drops leading segments until something matches — no go.mod parsing. Applying that rule to TypeScript would resolve lodash/fp onto a directory named fp, and date-fns has one. test_trailing_segment_matching_is_reserved_for_go pins the boundary.

The type (...) block form is deliberately unsupported: matching names at one indent level would also match struct fields, and a struct field read as a type declaration is precisely the invented symbol these patterns exist to prevent.

A bug in the measurement tool

gin reported zero cross-directory imports. That was too clean, and the same instinct has now paid off twice (#783).

measure_boundary_reach called import_to_dir without a suffix, so every Go module path fell through the TypeScript branch and resolved to nothing — a tidy zero for a signal that was working fine. With the suffix passed:

gin  boundary reach: 21 files import across a directory over 14 distinct edges;
     writing 7 of them fresh (7.1%) would announce a first-ever crossing

cobra stays at 0, correctly — it is essentially one package.

Verification

134 guard tests (11 new), all nine gates, both Go repositories within the noise budget, ruff and mypy clean, markdownlint clean.

🤖 Generated with Claude Code

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.