@chappibunny/repolens 1.15.2 → 1.15.3

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to RepoLens will be documented in this file.
 
+## 1.15.3
+
+### Dependency graph
+
+- Python imports inside `if TYPE_CHECKING:`, `if typing.TYPE_CHECKING:`, and `if <alias>.TYPE_CHECKING:` (for example `import typing as t`) are not runtime edges and do not form cycles. `from . import name` resolves to the sibling module
+- Node.js built-ins (`fs`, `child_process`, `events`, `node:*`, and the rest of the standard builtin list) are not external packages
+- Go hub rows are packages (`github.com/spf13/cobra`, `github.com/go-chi/chi/v5/middleware`), not individual `.go` files
+
+### Pattern text
+
+- Test directories and test files are not evidence for architecture patterns. A `tests/test_commands.py` module does not make the repo a "CLI tool architecture"
+- "API route pattern" requires an `api`, `routes`, `router`, `endpoint`, `controller`, or `handler` directory. A library file named `_api.py` does not match
+
 ## 1.15.2
 
 ### Dependency graph

package/README.md

@@ -241,9 +241,9 @@ If `npx` reports `Unknown command: mcp`, an `.npmrc` with `min-release-age` (or
 
 ## GitHub Action
 
-`action.yml` is a composite action named **RepoLens Architecture Docs**. `publish`, `demo`, and `doctor` run the published npm package (`npx --yes @chappibunny/repolens@1.15.2`). `comment` and `badge` run from the action checkout. Inputs are `command` (`publish`, `demo`, `doctor`, `comment`, or `badge`), `config`, `node-version`, `pr-comment`, `version`, `badge-out`, `badge-url`, and `badge-link`.
+`action.yml` is a composite action named **RepoLens Architecture Docs**. `publish`, `demo`, and `doctor` run the published npm package (`npx --yes @chappibunny/repolens@1.15.3`). `comment` and `badge` run from the action checkout. Inputs are `command` (`publish`, `demo`, `doctor`, `comment`, or `badge`), `config`, `node-version`, `pr-comment`, `version`, `badge-out`, `badge-url`, and `badge-link`.
 
-Publishing docs (the npm package at tag `v1.15.2`):
+Publishing docs (the npm package at tag `v1.15.3`):
 
 ```yaml
 name: Architecture docs
@@ -259,7 +259,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@9f698171ed81b15d1823a05fc7211befd50c8ae0 # v6.0.3
-      - uses: CHAPIBUNNY/repolens@v1.15.2
+      - uses: CHAPIBUNNY/repolens@v1.15.3
         with:
           command: publish
           config: .repolens.yml
@@ -267,7 +267,7 @@ jobs:
           pr-comment: ${{ github.event_name == 'pull_request' && 'true' || 'false' }}
 ```
 
-On `v1.15.2`, `pr-comment: true` runs the architecture diff from the action checkout and turns the published package's older short summary off. The diff lists modules, files, dependencies, the code-health delta, and new hotspots. It edits one sticky comment (`<!-- repolens:architecture-diff -->`) instead of adding a new comment each push. The footer is "Generated by RepoLens" and links to this repository and the [gallery](https://chapibunny.github.io/repolens/). Tag `v1.15.1` does not contain `command: comment`. Pin `v1.15.2` or a commit SHA in production.
+On `v1.15.2`, `pr-comment: true` runs the architecture diff from the action checkout and turns the published package's older short summary off. The diff lists modules, files, dependencies, the code-health delta, and new hotspots. It edits one sticky comment (`<!-- repolens:architecture-diff -->`) instead of adding a new comment each push. The footer is "Generated by RepoLens" and links to this repository and the [gallery](https://chapibunny.github.io/repolens/). Tag `v1.15.1` does not contain `command: comment`. Pin `v1.15.3` or a commit SHA in production.
 
 ```yaml
 name: RepoLens architecture comment
@@ -283,7 +283,7 @@ jobs:
       - uses: actions/checkout@9f698171ed81b15d1823a05fc7211befd50c8ae0 # v6.0.3
         with:
           fetch-depth: 0
-      - uses: CHAPIBUNNY/repolens@v1.15.2
+      - uses: CHAPIBUNNY/repolens@v1.15.3
         with:
           command: comment
 ```
@@ -292,7 +292,7 @@ jobs:
 
 `pr-comment: true` on `publish`, `demo`, or `doctor` (when the action ref contains this change) runs the same comment after the package and turns the package's older comment off, so the pull request still gets one comment.
 
-The action is listed on the GitHub Marketplace only after a release is published with **Publish this Action to the GitHub Marketplace** checked. Those steps are in [docs/RELEASE.md](docs/RELEASE.md). The tag `v1.15.2` has to exist before `uses: CHAPIBUNNY/repolens@v1.15.2` resolves, and `@chappibunny/repolens@1.15.2` has to be on npm before `publish` can install it. `command: comment` and `command: badge` do not install that package.
+The action is listed on the GitHub Marketplace only after a release is published with **Publish this Action to the GitHub Marketplace** checked. Those steps are in [docs/RELEASE.md](docs/RELEASE.md). The tag `v1.15.3` has to exist before `uses: CHAPIBUNNY/repolens@v1.15.3` resolves, and `@chappibunny/repolens@1.15.3` has to be on npm before `publish` can install it. `command: comment` and `command: badge` do not install that package.
 
 ## Add the badge to your repo
 
@@ -328,7 +328,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@9f698171ed81b15d1823a05fc7211befd50c8ae0 # v6.0.3
-      - uses: CHAPIBUNNY/repolens@v1.15.2
+      - uses: CHAPIBUNNY/repolens@v1.15.3
         with:
           command: badge
           badge-url: https://USER.github.io/REPO/repolens-badge.json
@@ -357,7 +357,7 @@ Gallery repositories already publish this. Each one has a [score page](https://c
 
 Published system maps are Unicode diagrams drawn from import edges. RepoLens does not emit Mermaid.
 
-The publisher set is Notion, Confluence, GitHub Wiki, Obsidian, and Markdown (`src/publishers`, 7 files). 1.14.0 adds the MCP server, the Marketplace action, and the docs badge. 1.14.1 sets the registry name to `io.github.CHAPIBUNNY/repolens`. 1.14.2 adds the gallery link to the badge line, `glama.json`, and `CITATION.cff`. 1.14.3 adds Cline setup docs and `llms-install.md`. 1.15.0 detects repository languages in `init --quick`, refuses empty scans, and adds per-command help. 1.15.1 makes `watch` exit 2 when those globs match nothing, and scores code health for Python and Go as well as JavaScript and TypeScript. 1.15.2 reads Python and Go imports in the dependency graph, skips comment and type-only imports, adds `repolens badge` and `repolens comment`, and adds gallery explained pages plus `llms.txt`. Layout and counts are in [ARCHITECTURE.md](docs/ARCHITECTURE.md).
+The publisher set is Notion, Confluence, GitHub Wiki, Obsidian, and Markdown (`src/publishers`, 7 files). 1.14.0 adds the MCP server, the Marketplace action, and the docs badge. 1.14.1 sets the registry name to `io.github.CHAPIBUNNY/repolens`. 1.14.2 adds the gallery link to the badge line, `glama.json`, and `CITATION.cff`. 1.14.3 adds Cline setup docs and `llms-install.md`. 1.15.0 detects repository languages in `init --quick`, refuses empty scans, and adds per-command help. 1.15.1 makes `watch` exit 2 when those globs match nothing, and scores code health for Python and Go as well as JavaScript and TypeScript. 1.15.2 reads Python and Go imports in the dependency graph, skips comment and type-only imports, adds `repolens badge` and `repolens comment`, and adds gallery explained pages plus `llms.txt`. 1.15.3 skips Python `TYPE_CHECKING` imports, omits Node.js built-ins from external packages, groups Go hubs by package, and ignores test files as architecture-pattern evidence. Layout and counts are in [ARCHITECTURE.md](docs/ARCHITECTURE.md).
 
 ### System Overview (Technical Profile)
 

package/llms-install.md

@@ -18,3 +18,4 @@
 9. Read [llms.txt](llms.txt) and [llms-full.txt](llms-full.txt) before recommending RepoLens. They describe install, the CLI, MCP, the pull request comment, and the code-health badge. The same files are published at the gallery root (`https://chapibunny.github.io/repolens/llms.txt`).
 10. `repolens badge` prints a shields.io code-health endpoint. `repolens comment --base <ref> --head <ref>` prints an architecture diff. On GitHub, `command: comment` in `action.yml` posts one sticky pull request comment (`pull-requests: write` only). Fork pull requests get a job summary instead of a comment. These two action modes run from the action checkout. Both CLI commands ship in 1.15.2.
 11. CLI (1.15.2): the dependency graph includes Python and Go imports. Comments, strings, and TypeScript type-only imports are not edges. Go `*_test.go` files are not separate modules. Pattern text cites the matching path or import. "Custom React hooks" requires a `react` import.
+12. CLI (1.15.3): Python imports under `if TYPE_CHECKING:` (including `typing.TYPE_CHECKING` and `import typing as t`) are not cycle edges. Node.js built-ins are not external packages. Go hub rows are packages. Test files are not architecture-pattern evidence, and "API route pattern" requires a route directory.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chappibunny/repolens",
-  "version": "1.15.2",
+  "version": "1.15.3",
   "mcpName": "io.github.CHAPIBUNNY/repolens",
   "description": "AI-assisted documentation intelligence system for technical and non-technical audiences",
   "license": "MIT",

package/src/analyzers/context-builder.js

@@ -204,17 +204,48 @@ function inferModuleType(modulePath) {
   return "other";
 }
 
+function isTestEvidence(modulePath) {
+  const norm = String(modulePath || "").replace(/\\/g, "/");
+  if (/(^|\/)__(tests|mocks)__(\/|$)/.test(norm)) return true;
+  if (/(^|\/)(test|tests|spec|specs|fixtures|testdata)(\/|$)/.test(norm)) return true;
+  const base = norm.split("/").pop() || "";
+  if (/^(test_|spec_)/.test(base)) return true;
+  if (/(_test|_spec)\.[a-z0-9]+$/i.test(base)) return true;
+  if (/\.(test|spec)\.[a-z0-9]+$/i.test(base)) return true;
+  return false;
+}
+
+const API_DIRECTORY_SEGMENTS = new Set([
+  "api", "apis", "route", "routes", "router", "routers",
+  "endpoint", "endpoints", "controller", "controllers", "handler", "handlers",
+]);
+
+function hasApiDirectory(modulePath) {
+  return directoryPath(modulePath)
+    .split("/")
+    .some((segment) => API_DIRECTORY_SEGMENTS.has(segment.toLowerCase()));
+}
+
+function directoryPath(modulePath) {
+  const parts = String(modulePath || "").replace(/\\/g, "/").split("/");
+  const last = parts[parts.length - 1] || "";
+  if (/\.[a-z0-9]+$/i.test(last)) parts.pop();
+  return parts.join("/");
+}
+
 function inferArchitecturalPatterns(modules, depGraph = null) {
   const patterns = [];
-  const keys = modules.map(m => m.key.toLowerCase());
-  
+  const production = modules.filter((module) => !isTestEvidence(module.key));
+  const tests = modules.filter((module) => isTestEvidence(module.key));
+  const keys = production.map(m => m.key.toLowerCase());
+
   const has = (keyword) => keys.some((key) => (
     keyword.includes("/") ? key.includes(keyword) : pathHasKeyword(key, keyword)
   ));
-  const matchingKeys = (keywords) => {
+  const matchingKeys = (keywords, source = production) => {
     const found = [];
     for (const keyword of keywords) {
-      for (const module of modules) {
+      for (const module of source) {
         const key = module.key;
         const matched = keyword.includes("/")
           ? key.toLowerCase().includes(keyword)
@@ -224,8 +255,9 @@ function inferArchitecturalPatterns(modules, depGraph = null) {
     }
     return found;
   };
-  const cite = (label, keywords, extra = "") => {
-    const found = matchingKeys(keywords);
+  const hasApiRouteEvidence = () => production.some((module) => hasApiDirectory(module.key));
+  const cite = (label, keywords, extra = "", source = production) => {
+    const found = matchingKeys(keywords, source);
     if (found.length === 0 && !extra) return;
     const sample = found.slice(0, 3).map((key) => `\`${key}\``).join(", ");
     const more = found.length > 3 ? ` (+${found.length - 3} more)` : "";
@@ -244,6 +276,7 @@ function inferArchitecturalPatterns(modules, depGraph = null) {
   // Verify pattern: a module matching `keyword` has high fan-in (truly central)
   const verifyHub = (keyword) => {
     for (const [mKey, m] of moduleMetrics) {
+      if (isTestEvidence(mKey)) continue;
       if (mKey.toLowerCase().includes(keyword) && m.fanIn >= 3) return true;
     }
     return false;
@@ -252,6 +285,7 @@ function inferArchitecturalPatterns(modules, depGraph = null) {
   // Verify pattern: modules matching keyword have mostly outbound deps (orchestrators)
   const verifyOrchestrator = (keyword) => {
     for (const [mKey, m] of moduleMetrics) {
+      if (isTestEvidence(mKey)) continue;
       if (mKey.toLowerCase().includes(keyword) && m.fanOut >= 3) return true;
     }
     return false;
@@ -266,7 +300,14 @@ function inferArchitecturalPatterns(modules, depGraph = null) {
     cite("Centralized state management", ["store", "state", "redux", "zustand"]);
   }
 
-  if (has("api") || has("endpoint")) cite("API route pattern", ["api", "endpoint"]);
+  if (hasApiRouteEvidence()) {
+    const found = production
+      .filter((module) => hasApiDirectory(module.key))
+      .map((module) => module.key);
+    const sample = found.slice(0, 3).map((key) => `\`${key}\``).join(", ");
+    const more = found.length > 3 ? ` (+${found.length - 3} more)` : "";
+    patterns.push(`API route pattern — ${sample}${more}`);
+  }
 
   if (has("core") || has("kernel")) {
     const note = moduleMetrics.size > 0 && verifyHub("core")
@@ -306,7 +347,7 @@ function inferArchitecturalPatterns(modules, depGraph = null) {
     cite("AI/LLM integration", ["ai", "llm", "openai", "anthropic"], aiPackages.length ? `imports ${aiPackages.slice(0, 3).join(", ")}` : "");
   }
   if (has("deliver") || has("dispatch")) cite("Delivery pipeline", ["deliver", "dispatch"]);
-  if (has("test") || has("spec")) cite("Dedicated test infrastructure", ["test", "spec"]);
+  if (tests.length) cite("Dedicated test infrastructure", ["test", "spec"], "", tests);
 
   // Structural patterns from dep graph (not keyword-based)
   if (depGraph?.stats) {

package/src/analyzers/dependency-graph.js

@@ -80,6 +80,35 @@ async function loadGoModule(repoRoot) {
   return parseGoModule(text);
 }
 
+function goPackageImportPath(file, modulePath) {
+  const norm = String(file || "").replace(/\\/g, "/");
+  if (!norm.endsWith(".go")) return null;
+  const dir = path.posix.dirname(norm);
+  const rel = dir === "." ? "" : dir;
+  if (modulePath) return rel ? `${modulePath}/${rel}` : modulePath;
+  return rel || ".";
+}
+
+function aggregateHubs(nodes, fileKeyToFile, modulePath, hubThreshold) {
+  const groups = new Map();
+  for (const node of nodes) {
+    const pkg = goPackageImportPath(node.file, modulePath);
+    const key = pkg || node.key;
+    if (!groups.has(key)) groups.set(key, new Set());
+    const importers = groups.get(key);
+    for (const importer of node.importedBy || []) {
+      const importerFile = fileKeyToFile.get(importer) || importer;
+      if (pkg && goPackageImportPath(importerFile, modulePath) === pkg) continue;
+      importers.add(importer);
+    }
+  }
+  return [...groups.entries()]
+    .map(([key, importers]) => ({ key, importedBy: importers.size }))
+    .filter((hub) => hub.importedBy >= hubThreshold)
+    .sort((a, b) => b.importedBy - a.importedBy)
+    .slice(0, 10);
+}
+
 function goFilesInDir(goFiles, dir) {
   const target = dir || "";
   return goFiles.filter((file) => {
@@ -149,6 +178,7 @@ export async function analyzeDependencyGraph(files, repoRoot) {
     if (!content) continue;
     const fromKey = normalizeFileKey(file);
     for (const imported of extractPythonImports(content)) {
+      if (imported.typeOnly) continue;
       const resolved = resolvePythonImport(file, imported, pyIndex);
       if (resolved.kind === "internal") addEdge(fromKey, normalizeFileKey(resolved.file));
       else if (resolved.kind === "external") addExternal(fromKey, resolved.name);
@@ -205,11 +235,7 @@ export async function analyzeDependencyGraph(files, repoRoot) {
   const totalImports = result.edges.length;
   const orphans = result.nodes.filter(n => n.imports.length === 0 && n.importedBy.length === 0);
   const hubThreshold = Math.max(5, Math.floor(result.nodes.length * 0.1));
-  const hubs = result.nodes
-    .filter(n => n.importedBy.length >= hubThreshold)
-    .sort((a, b) => b.importedBy.length - a.importedBy.length)
-    .slice(0, 10)
-    .map(n => ({ key: n.key, importedBy: n.importedBy.length }));
+  const hubs = aggregateHubs(result.nodes, fileKeyToFile, goModulePath, hubThreshold);
 
   result.stats = {
     totalFiles: codeFiles.length,

package/src/analyzers/import-parsers.js

@@ -359,6 +359,16 @@ function scanTemplate(source, i, onExpression) {
   return i;
 }
 
+const NODE_BUILTINS = new Set([
+  "assert", "async_hooks", "buffer", "child_process", "cluster", "console",
+  "constants", "crypto", "dgram", "diagnostics_channel", "dns", "domain",
+  "events", "fs", "http", "http2", "https", "inspector", "module", "net",
+  "os", "path", "perf_hooks", "process", "punycode", "querystring",
+  "readline", "repl", "sqlite", "stream", "string_decoder", "sys", "timers",
+  "tls", "trace_events", "tty", "url", "util", "v8", "vm", "wasi",
+  "worker_threads", "zlib",
+]);
+
 export function externalPackageName(specifier) {
   if (typeof specifier !== "string") return null;
   const trimmed = specifier.trim();
@@ -369,6 +379,8 @@ export function externalPackageName(specifier) {
     : trimmed.split("/").slice(0, 1);
   const name = parts.filter(Boolean).join("/");
   if (!name || name === "." || name === "..") return null;
+  const top = name.startsWith("@") ? null : name.split("/")[0];
+  if (top && NODE_BUILTINS.has(top)) return null;
   return name;
 }
 
@@ -410,45 +422,127 @@ function stripPythonNoise(source) {
   return out;
 }
 
+function leadingIndent(line) {
+  const match = String(line).match(/^[ \t]*/);
+  return match ? match[0].length : 0;
+}
+
+function noteTypingBindings(statement, aliases, flags) {
+  const imported = statement.match(/^import\s+(.+)$/);
+  if (imported) {
+    for (const part of imported[1].split(",")) {
+      const as = part.trim().match(/^([\w.]+)(?:\s+as\s+([A-Za-z_]\w*))?$/);
+      if (!as) continue;
+      if (as[1] !== "typing" && as[1] !== "typing_extensions") continue;
+      aliases.add(as[2] || as[1]);
+    }
+    return;
+  }
+  const from = statement.match(/^from\s+(typing|typing_extensions)\s+import\s+(.+)$/);
+  if (!from) return;
+  for (const part of from[2].replace(/[()]/g, " ").split(",")) {
+    const as = part.trim().match(/^([A-Za-z_]\w*)(?:\s+as\s+([A-Za-z_]\w*))?$/);
+    if (!as || as[1] !== "TYPE_CHECKING") continue;
+    flags.add(as[2] || as[1]);
+  }
+}
+
+function isTypeCheckingGuard(statement, aliases, flags) {
+  const match = statement.match(/^(?:if|elif)\s+(.+?)\s*:\s*$/);
+  if (!match) return false;
+  const cond = match[1].trim();
+  if (cond === "TYPE_CHECKING" || flags.has(cond)) return true;
+  if (cond === "typing.TYPE_CHECKING") return true;
+  const attr = cond.match(/^([A-Za-z_]\w*)\.TYPE_CHECKING$/);
+  return Boolean(attr && aliases.has(attr[1]));
+}
+
+function pushPythonImport(imports, statement, typeOnly) {
+  if (statement.startsWith("import ")) {
+    const rest = statement.slice("import ".length).replace(/[()]/g, " ");
+    for (const part of rest.split(",")) {
+      const name = part.trim().split(/\s+/)[0];
+      if (name && /^[\w.]+$/.test(name)) imports.push({ module: name, level: 0, typeOnly });
+    }
+    return;
+  }
+  const relative = statement.match(/^from\s+(\.+)([\w.]*)\s+import\s+(.+)$/);
+  if (relative) {
+    const level = relative[1].length;
+    const base = relative[2] || "";
+    if (base) {
+      imports.push({ module: base, level, typeOnly });
+      return;
+    }
+    for (const part of relative[3].replace(/[()]/g, " ").split(",")) {
+      const name = part.trim().split(/\s+/)[0];
+      if (name && /^[A-Za-z_]\w*$/.test(name)) imports.push({ module: name, level, typeOnly });
+    }
+    return;
+  }
+  const match = statement.match(/^from\s+([\w.]+)\s+import\b/);
+  if (!match) return;
+  imports.push({ module: match[1], level: 0, typeOnly });
+}
+
 /**
- * @returns {{ module: string, level: number }[]}
+ * @returns {{ module: string, level: number, typeOnly: boolean }[]}
  * level 0 is an absolute import. level N is a relative import with N dots.
+ * Imports under `if TYPE_CHECKING:` / `if typing.TYPE_CHECKING:` (including
+ * `import typing as t`) are typeOnly and must not become runtime edges.
  */
 export function extractPythonImports(source) {
   const stripped = stripPythonNoise(source).replace(/\\\n/g, " ");
   const lines = stripped.split("\n");
-  const statements = [];
+  const imports = [];
+  const aliases = new Set(["typing"]);
+  const flags = new Set(["TYPE_CHECKING"]);
+  const blockIndents = [];
   let buf = "";
   let depth = 0;
-  for (const line of lines) {
-    buf = buf ? `${buf} ${line.trim()}` : line.trim();
-    depth += (line.match(/\(/g) || []).length;
-    depth -= (line.match(/\)/g) || []).length;
-    if (depth > 0) continue;
-    if (buf) statements.push(buf);
+  let bufTypeOnly = false;
+  let bufIndent = 0;
+
+  function inTypeChecking(indent) {
+    while (blockIndents.length && indent <= blockIndents[blockIndents.length - 1]) {
+      blockIndents.pop();
+    }
+    return blockIndents.length > 0;
+  }
+
+  function finishStatement() {
+    const statement = buf.trim();
     buf = "";
     depth = 0;
+    if (!statement) return;
+    if (bufTypeOnly) {
+      pushPythonImport(imports, statement, true);
+      return;
+    }
+    if (isTypeCheckingGuard(statement, aliases, flags)) {
+      blockIndents.push(bufIndent);
+      return;
+    }
+    noteTypingBindings(statement, aliases, flags);
+    pushPythonImport(imports, statement, false);
   }
-  if (buf) statements.push(buf);
 
-  const imports = [];
-  for (const statement of statements) {
-    if (statement.startsWith("import ")) {
-      const rest = statement.slice("import ".length).replace(/[()]/g, " ");
-      for (const part of rest.split(",")) {
-        const name = part.trim().split(/\s+/)[0];
-        if (name && /^[\w.]+$/.test(name)) imports.push({ module: name, level: 0 });
-      }
-      continue;
-    }
-    const match = statement.match(/^from\s+(\.+)([\w.]*)\s+import\b/) || statement.match(/^from\s+([\w.]+)\s+import\b/);
-    if (!match) continue;
-    if (match[1].startsWith(".")) {
-      imports.push({ module: match[2] || "", level: match[1].length });
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed && depth === 0) continue;
+    if (depth === 0) {
+      bufTypeOnly = inTypeChecking(leadingIndent(line));
+      bufIndent = leadingIndent(line);
+      buf = trimmed;
     } else {
-      imports.push({ module: match[1], level: 0 });
+      buf = `${buf} ${trimmed}`;
     }
+    depth += (line.match(/\(/g) || []).length;
+    depth -= (line.match(/\)/g) || []).length;
+    if (depth > 0) continue;
+    finishStatement();
   }
+  if (buf) finishStatement();
   return imports;
 }
 

package/src/renderers/renderAnalysis.js

@@ -396,7 +396,7 @@ export function renderDependencyGraph(depResult) {
 
   lines.push("---");
   lines.push("");
-  lines.push("*Generated by RepoLens import analysis. Dependency detection covers JavaScript and TypeScript (ES modules, dynamic import, CommonJS, re-exports; comments, strings, and type-only imports are skipped), Python (`import` / `from ... import`, including relative imports), and Go (`go.mod` module paths). Go `*_test.go` files are not part of the graph.*");
+  lines.push("*Generated by RepoLens import analysis. Dependency detection covers JavaScript and TypeScript (ES modules, dynamic import, CommonJS, re-exports; comments, strings, type-only imports, and Node.js built-ins are skipped), Python (`import` / `from ... import`, including relative imports; `TYPE_CHECKING` blocks are skipped), and Go (`go.mod` module paths, hubs grouped by package). Go `*_test.go` files are not part of the graph.*");
   lines.push("");
 
   return lines.join("\n");