feat: Java/Kotlin findings entries and docs — completes JVM import graph (issue-2, PR 3/3) (#32)

Author: NehharShah

README.md

@@ -120,7 +120,7 @@ on the knowledge graph discovers your rules — and vice versa.
 | Branch classification | `git for-each-ref` + `--merged` ancestry vs the integration branch (auto-detects `staging`/`develop`), cross-referenced with every PR's head ref via `gh` — distinguishes true merges from squash-merges from abandoned work |
 | PR catalog | `gh pr list --state all` — open / merged / closed-unmerged, full appendix table |
 | Module inventory | Filesystem walk with LOC per directory, language detection, generated-code flagging |
-| Import graph | Go: `import` blocks resolved against `go.mod` module paths · Python: stdlib `ast` incl. relative imports · JS/TS: relative `import`/`require` resolution · Rust: `use` declarations resolved against Cargo crate names (cross-crate) and `src/` module trees (intra-crate). Directory→directory edges with counts |
+| Import graph | Go: `import` blocks resolved against `go.mod` module paths · Python: stdlib `ast` incl. relative imports · JS/TS: relative `import`/`require` resolution · Rust: `use` declarations resolved against Cargo crate names (cross-crate) and `src/` module trees (intra-crate) · Java/Kotlin: imports resolved by longest prefix against `package` declarations. Directory→directory edges with counts |
 | Ops surface | CI workflow names, Dockerfiles, compose files, Helm charts, Makefile targets, config/docs/test/migration dirs |
 | Timeline | Merged PRs grouped by month with conventional-commit scope frequencies (replaced by agent-written eras after enrichment) |
 
@@ -143,13 +143,16 @@ schema — everything else stays deterministic and reproducible.
 - **Rust**: `use` declarations only — macro-generated imports, re-export
   chains, and `[dependencies] path = …` (non-workspace) crates are not
   resolved; `crate::` paths ground only in module dirs/files that exist.
+- **Java/Kotlin**: explicit imports only — same-package references (no import
+  needed) and fully-qualified inline names produce no edges; when a package is
+  declared only in test roots, edges resolve there.
 - Branch `ahead` counts use one batched git call on git ≥ 2.41, with a
   per-branch fallback on older git.
 
 ## Roadmap
 
 - [x] Rust import graph
-- [ ] Java / Kotlin import graphs
+- [x] Java / Kotlin import graphs
 - [ ] `--exclude` glob patterns
 - [ ] `llms.txt` emission alongside KNOWLEDGE_GRAPH.md
 - [ ] tsconfig `paths` alias resolution

src/repokg/findings.py

@@ -23,6 +23,12 @@
     "Rust": ("medium", "regex `use` parsing resolved against Cargo [package] "
                        "names and src/ module dirs; macros, re-exports and "
                        "path-dependencies are not resolved"),
+    "Java": ("high", "imports resolved by longest prefix against package "
+                     "declarations (language ground truth); test source roots "
+                     "excluded as targets when a main root declares the package"),
+    "Kotlin": ("high", "same package-declaration resolution as Java, incl. "
+                       "Kotlin's collapsed directory convention; `as` aliases "
+                       "handled, extension-function call sites are not imports"),
 }
 
 

tests/test_validate.py

@@ -57,7 +57,9 @@ def test_build_and_render(self):
             ],
             "edges": [{"from": "a", "to": "b", "lang": "JS/TS", "count": 1},
                       {"from": "a", "to": "b", "lang": "Go", "count": 2},
-                      {"from": "a", "to": "c", "lang": "Rust", "count": 1}],
+                      {"from": "a", "to": "c", "lang": "Rust", "count": 1},
+                      {"from": "a", "to": "d", "lang": "Java", "count": 1},
+                      {"from": "a", "to": "d", "lang": "Kotlin", "count": 1}],
             "modules": [{"path": "gen/pb", "generated": True}],
             "prs": [{"number": 1}],
             "github_note": "",
@@ -71,6 +73,8 @@ def test_build_and_render(self):
         self.assertEqual(confs["1 Go edges"], "high")
         self.assertEqual(confs["1 JS/TS edges"], "medium")
         self.assertEqual(confs["1 Rust edges"], "medium")
+        self.assertEqual(confs["1 Java edges"], "high")
+        self.assertEqual(confs["1 Kotlin edges"], "high")
         self.assertEqual(confs["1 modules flagged generated"], "low")
         self.assertTrue(any("Fork PRs" in n for n in notes))
         text = render_text(found, notes)