token-goat 2.8.6 → 2.9.2

package/dist/{token-goat-chunk-XAWIELXH.mjs → token-goat-chunk-FXAPKVRG.mjs}

@@ -29,6 +29,7 @@ import {
   formatCsvTable,
   getEmbeddingCoverage,
   getFileEntry,
+  getTrackedFiles,
   indexFileSync,
   isAvailable,
   isBlobStale,
@@ -42,6 +43,7 @@ import {
   mergeNearbyHits,
   ocrImage,
   ocrIntegrityFailed,
+  parseIpv6Groups,
   parseWhereSpecs,
   pathEqClause,
   probeImageMeta,
@@ -66,7 +68,7 @@ import {
   walkProject,
   yamlLineClosesQuote,
   yamlOpenQuoteAfter
-} from "./token-goat-chunk-DK4VLLYB.mjs";
+} from "./token-goat-chunk-LJ3CHCTT.mjs";
 import {
   Database,
   PER_FILE_COUNTERFACTUAL_CEILING,
@@ -120,36 +122,11 @@ import {
   unsupportedLanguageName,
   windowsCmdQuoteArg,
   withExtension
-} from "./token-goat-chunk-2JZ66BBE.mjs";
+} from "./token-goat-chunk-UZ2NFOOZ.mjs";
 import {
   registerReset
 } from "./token-goat-chunk-AO2QD2AG.mjs";
 
-// src/repomap.ts
-import * as fs from "fs";
-import * as path from "path";
-function getTrackedFiles(cwd = process.cwd()) {
-  try {
-    let dir = cwd;
-    let onlyFile = "";
-    try {
-      if (fs.statSync(cwd).isFile()) {
-        dir = path.dirname(cwd);
-        onlyFile = path.basename(cwd);
-      }
-    } catch {
-    }
-    const args = onlyFile === "" ? ["ls-files"] : ["ls-files", "--error-unmatch", "--", onlyFile];
-    const result = runGit(args, { cwd: dir });
-    if (result.exitCode !== 0 || !result.stdout) {
-      return [];
-    }
-    return result.stdout.split("\n").filter((line) => line.trim().length > 0).map((rel) => path.join(dir, rel));
-  } catch {
-    return [];
-  }
-}
-
 // src/section_reader.ts
 import { readFileSync } from "node:fs";
 function parseHeadingSpec(spec, headers) {
@@ -477,8 +454,8 @@ import { execFileSync, spawnSync as spawnSync2 } from "node:child_process";
 import { randomUUID } from "node:crypto";
 
 // src/read_commands.ts
-import * as fs5 from "node:fs";
-import * as path5 from "node:path";
+import * as fs4 from "node:fs";
+import * as path4 from "node:path";
 
 // src/json_query.ts
 function jsonType(value) {
@@ -2371,24 +2348,32 @@ function collectionTagName(state, event, defaultTagName) {
 function isMappingTag(tag) {
   return tag.nodeKind === "mapping";
 }
+function chargeMergeWork(state) {
+  state.totalMergeKeys++;
+  if (state.maxTotalMergeKeys !== -1 && state.totalMergeKeys > state.maxTotalMergeKeys) throwError$1(state, `merge keys exceeded maxTotalMergeKeys (${state.maxTotalMergeKeys})`);
+}
 function mergeKeys(state, frame, source, sourceTag) {
+  chargeMergeWork(state);
   for (const sourceKey of sourceTag.keys(source)) {
-    if (state.maxTotalMergeKeys !== -1 && ++state.totalMergeKeys > state.maxTotalMergeKeys) throwError$1(state, `merge keys exceeded maxTotalMergeKeys (${state.maxTotalMergeKeys})`);
+    chargeMergeWork(state);
     if (frame.tag.has(frame.value, sourceKey)) continue;
     const err = frame.tag.addPair(frame.value, sourceKey, sourceTag.get(source, sourceKey));
     if (err) throwError$1(state, err);
-    (frame.overridable ??= /* @__PURE__ */ new Set()).add(sourceKey);
+    frame.overridable ??= /* @__PURE__ */ new Set();
+    frame.overridable.add(sourceKey);
   }
 }
 function mergeSource(state, frame, source, sourceTag) {
   state.position = frame.keyPosition;
   if (isMappingTag(sourceTag)) mergeKeys(state, frame, source, sourceTag);
-  else if (sourceTag.nodeKind === "sequence" && Array.isArray(source)) for (const element of source) {
-    const elementTag = state.nodeTags.get(element);
-    if (!elementTag) throwError$1(state, "cannot merge mappings; the provided source object is unacceptable");
-    mergeKeys(state, frame, element, elementTag);
-  }
-  else throwError$1(state, "cannot merge mappings; the provided source object is unacceptable");
+  else if (sourceTag.nodeKind === "sequence" && Array.isArray(source)) {
+    if (source.length > 100) throwError$1(state, "abnormal merge sequence size");
+    for (const element of source) {
+      const elementTag = state.nodeTags.get(element);
+      if (!elementTag) throwError$1(state, "cannot merge mappings; the provided source object is unacceptable");
+      mergeKeys(state, frame, element, elementTag);
+    }
+  } else throwError$1(state, "cannot merge mappings; the provided source object is unacceptable");
 }
 function addMappingValue(state, frame, key, value, tag) {
   state.position = frame.keyPosition;
@@ -2731,6 +2716,24 @@ function testDocumentSeparator(state, position = state.position) {
   }
   return false;
 }
+function skipByteOrderMark(state) {
+  if (state.position === state.lineStart && state.input.charCodeAt(state.position) === 65279) {
+    state.position++;
+    state.lineStart = state.position;
+  }
+}
+function testDocumentBoundary(state) {
+  if (state.position !== state.lineStart) return false;
+  if (testDocumentSeparator(state)) return true;
+  if (state.input.charCodeAt(state.position) !== 65279) return false;
+  const snapshot = snapshotState(state);
+  skipByteOrderMark(state);
+  skipSeparationSpace(state, true);
+  const ch = state.input.charCodeAt(state.position);
+  const result = state.position === state.lineStart && (ch === 37 || ch === 45 && testDocumentSeparator(state));
+  restoreState(state, snapshot);
+  return result;
+}
 function skipUntilLineEnd(state) {
   let ch = state.input.charCodeAt(state.position);
   while (ch !== 0 && !isEol(ch)) ch = state.input.charCodeAt(++state.position);
@@ -2914,7 +2917,7 @@ function readBlockScalar(state, parentIndent, props) {
       } else if (column > 0) valueEnd = linePosition + column;
       break;
     }
-    if (linePosition === state.lineStart && testDocumentSeparator(state, linePosition)) break;
+    if (testDocumentBoundary(state)) break;
     if (!detectedIndent && contentIndent === -1 && isEol(first)) maxLeadingIndent = Math.max(maxLeadingIndent, column);
     if (!detectedIndent && contentIndent === -1 && !isEol(first)) {
       if (first === 9 && column < parentIndent) {
@@ -2967,7 +2970,7 @@ function readPlainScalar(state, nodeIndent, nodeContext, props) {
   const inFlow = nodeContext === CONTEXT_FLOW_IN;
   let multiline = false;
   while (ch !== 0) {
-    if (state.position === state.lineStart && testDocumentSeparator(state)) break;
+    if (testDocumentBoundary(state)) break;
     if (ch === 58) {
       const following = state.input.charCodeAt(state.position + 1);
       if (isWsOrEolOrEnd(following) || inFlow && isFlowIndicator(following)) break;
@@ -3324,7 +3327,7 @@ function readDocument(state) {
   const documentEvent = state.events[documentEventIndex];
   if (documentEvent?.type === EVENT_ID.DOCUMENT) documentEvent.explicitEnd = explicitEnd;
   addPopEvent(state);
-  if (!explicitEnd && state.position < state.length && !(state.position === state.lineStart && testDocumentSeparator(state))) throwError(state, "end of the stream or a document separator is expected");
+  if (!explicitEnd && state.position < state.length && !testDocumentBoundary(state)) throwError(state, "end of the stream or a document separator is expected");
 }
 function parseEvents(input, options) {
   const length = input.length;
@@ -3345,8 +3348,8 @@ function parseEvents(input, options) {
   };
   const nullpos = input.indexOf("\0");
   if (nullpos !== -1) YAMLException.throwAt(input, nullpos, "null byte is not allowed in input", state.filename);
-  if (state.input.charCodeAt(state.position) === 65279) state.position++;
   while (state.position < state.length) {
+    skipByteOrderMark(state);
     skipSeparationSpace(state, true);
     if (state.position >= state.length) break;
     const documentStart = state.position;
@@ -3387,27 +3390,108 @@ function load(input, options) {
   if (documents.length === 1) return documents[0];
   throw new YAMLException("expected a single document in the stream, but found more");
 }
-var ESCAPE_SEQUENCES = {};
-ESCAPE_SEQUENCES[0] = "\\0";
-ESCAPE_SEQUENCES[7] = "\\a";
-ESCAPE_SEQUENCES[8] = "\\b";
-ESCAPE_SEQUENCES[9] = "\\t";
-ESCAPE_SEQUENCES[10] = "\\n";
-ESCAPE_SEQUENCES[11] = "\\v";
-ESCAPE_SEQUENCES[12] = "\\f";
-ESCAPE_SEQUENCES[13] = "\\r";
-ESCAPE_SEQUENCES[27] = "\\e";
-ESCAPE_SEQUENCES[34] = '\\"';
-ESCAPE_SEQUENCES[92] = "\\\\";
-ESCAPE_SEQUENCES[133] = "\\N";
-ESCAPE_SEQUENCES[160] = "\\_";
-ESCAPE_SEQUENCES[8232] = "\\L";
-ESCAPE_SEQUENCES[8233] = "\\P";
+function hasBit(mask, bit) {
+  return (mask & 1 << bit) !== 0;
+}
+var DEFAULT_SCALAR_STYLE_RULES = {
+  applyQuoteFlowKeysOption,
+  doubleQuoteForInvisibles,
+  doubleQuoteWhitespaceOnly,
+  applyForceQuotesOption,
+  tryLongOrMultilineAsBlock,
+  quoteInvalidPlain,
+  fallbackToDoubleQuoted
+};
+function _preferredQuotedStyle(layout) {
+  if (layout.presenterOptions.quoteStyle === "single" && hasBit(layout.allowedStylesMask, SCALAR_STYLE.SINGLE_QUOTED)) return SCALAR_STYLE.SINGLE_QUOTED;
+  return SCALAR_STYLE.DOUBLE_QUOTED;
+}
+function applyQuoteFlowKeysOption(layout) {
+  if (!layout.presenterOptions.quoteFlowKeys) return;
+  if (!layout.isKey || !layout.flowOnly || layout.style !== SCALAR_STYLE.PLAIN) return;
+  layout.style = SCALAR_STYLE.DOUBLE_QUOTED;
+}
+function doubleQuoteForInvisibles(layout) {
+  if (layout.style === SCALAR_STYLE.PLAIN && /[\t\x7F-\xA0\u2028\u2029\uFEFF\uFFFE\uFFFF]/.test(layout.node.value)) layout.style = SCALAR_STYLE.DOUBLE_QUOTED;
+}
+function doubleQuoteWhitespaceOnly(layout) {
+  if (layout.style === SCALAR_STYLE.PLAIN && /^\s+$/.test(layout.node.value)) layout.style = SCALAR_STYLE.DOUBLE_QUOTED;
+}
+function applyForceQuotesOption(layout) {
+  if (!layout.presenterOptions.forceQuotes) return;
+  if (layout.isKey || layout.style !== SCALAR_STYLE.PLAIN) return;
+  layout.style = layout.node.value.includes("\n") ? SCALAR_STYLE.DOUBLE_QUOTED : _preferredQuotedStyle(layout);
+}
+function tryLongOrMultilineAsBlock(layout) {
+  if (layout.style !== SCALAR_STYLE.PLAIN || layout.isKey) return;
+  const value = layout.node.value;
+  const multiline = value.indexOf("\n") !== -1;
+  if (!hasBit(layout.allowedStylesMask, SCALAR_STYLE.LITERAL_BLOCK)) {
+    if (multiline) layout.style = SCALAR_STYLE.DOUBLE_QUOTED;
+    return;
+  }
+  const w = layout.presenterOptions.lineWidth;
+  if (w === -1) {
+    if (multiline) layout.style = SCALAR_STYLE.LITERAL_BLOCK;
+    return;
+  }
+  const availableWidth = Math.max(Math.min(w, 40), w - layout.shiftOfContent);
+  let position = 0;
+  let shouldFold = false;
+  while (position <= value.length) {
+    let lineEnd = value.length;
+    const nextLineBreak = value.indexOf("\n", position);
+    if (nextLineBreak !== -1) lineEnd = nextLineBreak;
+    const line = value.slice(position, lineEnd);
+    if (line.length > availableWidth && line[0] !== " " && / [^ \t]/.test(line)) shouldFold = true;
+    if (nextLineBreak === -1) break;
+    position = nextLineBreak + 1;
+  }
+  if (shouldFold) layout.style = SCALAR_STYLE.FOLDED_BLOCK;
+  else if (multiline) layout.style = SCALAR_STYLE.LITERAL_BLOCK;
+}
+function quoteInvalidPlain(layout) {
+  if (layout.style === SCALAR_STYLE.PLAIN && !hasBit(layout.allowedStylesMask, SCALAR_STYLE.PLAIN)) layout.style = _preferredQuotedStyle(layout);
+}
+function fallbackToDoubleQuoted(layout) {
+  if (!hasBit(layout.allowedStylesMask, layout.style)) layout.style = SCALAR_STYLE.DOUBLE_QUOTED;
+}
+var SRC_C_PRINTABLE = "[\\x09\\x0A\\x0D\\x20-\\x7E\\x85\\xA0-\\uD7FF\\uE000-\\uFFFD\\u{10000}-\\u{10FFFF}]";
+var SRC_B_CHAR = "[\\n\\r]";
+var SRC_C_BYTE_ORDER_MARK = "\\uFEFF";
+var SRC_S_WHITE = "[ \\t]";
+var SRC_NB_CHAR = `(?:(?!(?:${SRC_B_CHAR}|${SRC_C_BYTE_ORDER_MARK}))${SRC_C_PRINTABLE})`;
+var SRC_NS_CHAR = `(?:(?!${SRC_S_WHITE})${SRC_NB_CHAR})`;
+var SRC_NB_JSON = "[\\x09\\x20-\\uD7FF\\uE000-\\uFFFF\\u{10000}-\\u{10FFFF}]";
+var SRC_C_INDICATOR = "[-?:,\\[\\]{}#&*!|>'\"%@`]";
+var SRC_C_FLOW_INDICATOR = "[,\\[\\]{}]";
+var SRC_NS_PLAIN_SAFE_FLOW_OUT = SRC_NS_CHAR;
+var SRC_NS_PLAIN_SAFE_FLOW_IN = `(?:(?!${SRC_C_FLOW_INDICATOR})${SRC_NS_CHAR})`;
+var SRC_NS_PLAIN_FIRST_FLOW_OUT = `(?:(?:(?!${SRC_C_INDICATOR})${SRC_NS_CHAR})|[?:-](?=${SRC_NS_PLAIN_SAFE_FLOW_OUT}))`;
+var SRC_NS_PLAIN_FIRST_FLOW_IN = `(?:(?:(?!${SRC_C_INDICATOR})${SRC_NS_CHAR})|[?:-](?=${SRC_NS_PLAIN_SAFE_FLOW_IN}))`;
+var SRC_NS_PLAIN_CHAR_FLOW_OUT = `(?:(?:(?![:#])${SRC_NS_PLAIN_SAFE_FLOW_OUT})|:(?=${SRC_NS_PLAIN_SAFE_FLOW_OUT}))#*`;
+var SRC_NS_PLAIN_CHAR_FLOW_IN = `(?:(?:(?![:#])${SRC_NS_PLAIN_SAFE_FLOW_IN})|:(?=${SRC_NS_PLAIN_SAFE_FLOW_IN}))#*`;
+var SRC_NB_NS_PLAIN_IN_LINE_FLOW_OUT = `(?:${SRC_S_WHITE}*${SRC_NS_PLAIN_CHAR_FLOW_OUT})*`;
+var SRC_NB_NS_PLAIN_IN_LINE_FLOW_IN = `(?:${SRC_S_WHITE}*${SRC_NS_PLAIN_CHAR_FLOW_IN})*`;
+var SRC_NS_PLAIN_ONE_LINE_FLOW_OUT = `${SRC_NS_PLAIN_FIRST_FLOW_OUT}#*${SRC_NB_NS_PLAIN_IN_LINE_FLOW_OUT}`;
+var SRC_NS_PLAIN_ONE_LINE_FLOW_IN = `${SRC_NS_PLAIN_FIRST_FLOW_IN}#*${SRC_NB_NS_PLAIN_IN_LINE_FLOW_IN}`;
+var SRC_NS_PLAIN_ONE_LINE_BLOCK_KEY = SRC_NS_PLAIN_ONE_LINE_FLOW_OUT;
+var SRC_NS_PLAIN_ONE_LINE_FLOW_KEY = SRC_NS_PLAIN_ONE_LINE_FLOW_IN;
+var SRC_S_NS_PLAIN_NEXT_LINE_FLOW_OUT = `\\n+${SRC_NS_PLAIN_CHAR_FLOW_OUT}${SRC_NB_NS_PLAIN_IN_LINE_FLOW_OUT}`;
+var SRC_S_NS_PLAIN_NEXT_LINE_FLOW_IN = `\\n+${SRC_NS_PLAIN_CHAR_FLOW_IN}${SRC_NB_NS_PLAIN_IN_LINE_FLOW_IN}`;
+var SRC_NS_PLAIN_MULTI_LINE_FLOW_OUT = `${SRC_NS_PLAIN_ONE_LINE_FLOW_OUT}(?:${SRC_S_NS_PLAIN_NEXT_LINE_FLOW_OUT})*`;
+var SRC_NS_PLAIN_MULTI_LINE_FLOW_IN = `${SRC_NS_PLAIN_ONE_LINE_FLOW_IN}(?:${SRC_S_NS_PLAIN_NEXT_LINE_FLOW_IN})*`;
+var NS_PLAIN_FLOW_OUT = new RegExp(`^(?:${SRC_NS_PLAIN_MULTI_LINE_FLOW_OUT})$`, "u");
+var NS_PLAIN_FLOW_IN = new RegExp(`^(?:${SRC_NS_PLAIN_MULTI_LINE_FLOW_IN})$`, "u");
+var NS_PLAIN_BLOCK_KEY = new RegExp(`^(?:${SRC_NS_PLAIN_ONE_LINE_BLOCK_KEY})$`, "u");
+var NS_PLAIN_FLOW_KEY = new RegExp(`^(?:${SRC_NS_PLAIN_ONE_LINE_FLOW_KEY})$`, "u");
+var NB_SINGLE_ONE_LINE = new RegExp(`^(?:${SRC_NB_JSON})*$`, "u");
+var NB_SINGLE_MULTI_LINE = new RegExp(`^(?:${SRC_NB_JSON}|\\n)*$`, "u");
+var BLOCK_SCALAR_CONTENT = new RegExp(`^(?:${SRC_NB_CHAR}|\\n)*$`, "u");
 var DEFAULT_PRESENTER_OPTIONS = {
   indent: 2,
   seqNoIndent: false,
   seqInlineFirst: true,
-  sortKeys: false,
   lineWidth: 80,
   flowBracketPadding: false,
   flowSkipCommaSpace: false,
@@ -3415,6 +3499,7 @@ var DEFAULT_PRESENTER_OPTIONS = {
   quoteFlowKeys: false,
   quoteStyle: "single",
   forceQuotes: false,
+  scalarStyleRules: Object.keys(DEFAULT_SCALAR_STYLE_RULES).map((name) => Reflect.get(DEFAULT_SCALAR_STYLE_RULES, name)),
   tagBeforeAnchor: false
 };
 var DEFAULT_DUMP_OPTIONS = {
@@ -3423,6 +3508,7 @@ var DEFAULT_DUMP_OPTIONS = {
   skipInvalid: false,
   noRefs: false,
   flowLevel: -1,
+  sortKeys: false,
   transform: () => {
   }
 };
@@ -3444,11 +3530,11 @@ var CHOMPING_STRIP = CHOMPING_MODE.STRIP;
 var CHOMPING_KEEP = CHOMPING_MODE.KEEP;
 
 // src/openapi_query.ts
-import * as path2 from "node:path";
+import * as path from "node:path";
 var HTTP_METHODS = ["get", "put", "post", "delete", "options", "head", "patch", "trace"];
 function parseOpenApiSpec(text, filePath) {
   text = stripBom(text);
-  const ext = path2.extname(filePath).toLowerCase();
+  const ext = path.extname(filePath).toLowerCase();
   if (ext === ".yaml" || ext === ".yml") return load(text);
   if (ext === ".json") return JSON.parse(text);
   try {
@@ -3802,24 +3888,24 @@ ${c.body}`).join("\n\n");
 }
 
 // src/sqlite_query.ts
-import * as fs2 from "node:fs";
+import * as fs from "node:fs";
 var SQLITE_QUERY_ROW_CAP = 5e3;
 var SQLITE_MAGIC = Buffer.from([83, 81, 76, 105, 116, 101, 32, 102, 111, 114, 109, 97, 116, 32, 51, 0]);
 function readMagicBytes(filePath) {
   let fd;
   try {
-    fd = fs2.openSync(filePath, "r");
+    fd = fs.openSync(filePath, "r");
   } catch {
     return null;
   }
   try {
     const buf = Buffer.alloc(SQLITE_MAGIC.length);
-    const bytesRead = fs2.readSync(fd, buf, 0, buf.length, 0);
+    const bytesRead = fs.readSync(fd, buf, 0, buf.length, 0);
     return bytesRead === buf.length ? buf : null;
   } catch {
     return null;
   } finally {
-    fs2.closeSync(fd);
+    fs.closeSync(fd);
   }
 }
 function isSqliteFile(filePath) {
@@ -3827,7 +3913,7 @@ function isSqliteFile(filePath) {
   return magic !== null && magic.equals(SQLITE_MAGIC);
 }
 function openReadonlySqlite(filePath) {
-  if (!fs2.existsSync(filePath)) {
+  if (!fs.existsSync(filePath)) {
     throw new Error(`file not found: ${filePath}`);
   }
   if (!isSqliteFile(filePath)) {
@@ -4530,8 +4616,8 @@ function formatConflictSummaries(summaries) {
 
 // src/screenshot.ts
 import dns from "node:dns/promises";
-import fs3 from "node:fs";
-import path3 from "node:path";
+import fs2 from "node:fs";
+import path2 from "node:path";
 var loadPuppeteer = createLazyModuleLoader(
   async () => await import("puppeteer-core"),
   "screenshot disabled (puppeteer-core unavailable)"
@@ -4540,7 +4626,7 @@ var PLAYWRIGHT_CHROME_SUBDIRS = ["chrome-win64", "chrome-win"];
 function findPlaywrightChromium(msPlaywrightDir) {
   let entries;
   try {
-    entries = fs3.readdirSync(msPlaywrightDir);
+    entries = fs2.readdirSync(msPlaywrightDir);
   } catch {
     return [];
   }
@@ -4548,7 +4634,7 @@ function findPlaywrightChromium(msPlaywrightDir) {
   const candidates = [];
   for (const m of versioned) {
     for (const sub of PLAYWRIGHT_CHROME_SUBDIRS) {
-      candidates.push(path3.join(msPlaywrightDir, m[0], sub, "chrome.exe"));
+      candidates.push(path2.join(msPlaywrightDir, m[0], sub, "chrome.exe"));
     }
   }
   return candidates;
@@ -4559,33 +4645,33 @@ function platformCandidatePaths() {
     const programFiles = process.env["PROGRAMFILES"];
     const programFilesX86 = process.env["PROGRAMFILES(X86)"];
     const localAppData = process.env["LOCALAPPDATA"];
-    if (programFiles) candidates2.push(path3.join(programFiles, "Google", "Chrome", "Application", "chrome.exe"));
-    if (programFilesX86) candidates2.push(path3.join(programFilesX86, "Google", "Chrome", "Application", "chrome.exe"));
+    if (programFiles) candidates2.push(path2.join(programFiles, "Google", "Chrome", "Application", "chrome.exe"));
+    if (programFilesX86) candidates2.push(path2.join(programFilesX86, "Google", "Chrome", "Application", "chrome.exe"));
     if (localAppData) {
-      candidates2.push(path3.join(localAppData, "Google", "Chrome", "Application", "chrome.exe"));
-      candidates2.push(...findPlaywrightChromium(path3.join(localAppData, "ms-playwright")));
+      candidates2.push(path2.join(localAppData, "Google", "Chrome", "Application", "chrome.exe"));
+      candidates2.push(...findPlaywrightChromium(path2.join(localAppData, "ms-playwright")));
     }
     return candidates2;
   }
   if (process.platform === "darwin") {
     const home2 = process.env["HOME"];
     const candidates2 = ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"];
-    if (home2) candidates2.push(...findPlaywrightChromium(path3.join(home2, "Library", "Caches", "ms-playwright")));
+    if (home2) candidates2.push(...findPlaywrightChromium(path2.join(home2, "Library", "Caches", "ms-playwright")));
     return candidates2;
   }
   const home = process.env["HOME"];
   const candidates = ["/usr/bin/google-chrome-stable", "/usr/bin/google-chrome", "/usr/bin/chromium-browser", "/usr/bin/chromium"];
-  if (home) candidates.push(...findPlaywrightChromium(path3.join(home, ".cache", "ms-playwright")));
+  if (home) candidates.push(...findPlaywrightChromium(path2.join(home, ".cache", "ms-playwright")));
   return candidates;
 }
 function resolveBrowserExecutablePath(explicit) {
-  if (explicit && fs3.existsSync(explicit)) return explicit;
+  if (explicit && fs2.existsSync(explicit)) return explicit;
   const cfgPath = loadConfig().screenshot.chrome_path;
-  if (cfgPath && fs3.existsSync(cfgPath)) return cfgPath;
+  if (cfgPath && fs2.existsSync(cfgPath)) return cfgPath;
   const envPath = process.env["TOKEN_GOAT_CHROME_PATH"];
-  if (envPath && fs3.existsSync(envPath)) return envPath;
+  if (envPath && fs2.existsSync(envPath)) return envPath;
   for (const candidate of platformCandidatePaths()) {
-    if (fs3.existsSync(candidate)) return candidate;
+    if (fs2.existsSync(candidate)) return candidate;
   }
   return null;
 }
@@ -4598,43 +4684,6 @@ function isBlockedIpv4Octets(a, b) {
   if (a === 0) return true;
   return false;
 }
-function parseIpv6Groups(text) {
-  let rest = text;
-  const zoneAt = rest.indexOf("%");
-  if (zoneAt !== -1) rest = rest.slice(0, zoneAt);
-  if (!/^[0-9a-f:.]+$/i.test(rest) || !rest.includes(":")) return null;
-  const lastColon = rest.lastIndexOf(":");
-  const tail = rest.slice(lastColon + 1);
-  if (tail.includes(".")) {
-    const quad = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(tail);
-    if (!quad) return null;
-    const octets = [Number(quad[1]), Number(quad[2]), Number(quad[3]), Number(quad[4])];
-    if (octets.some((n) => n > 255)) return null;
-    const hi = octets[0] << 8 | octets[1];
-    const lo = octets[2] << 8 | octets[3];
-    rest = `${rest.slice(0, lastColon + 1)}${hi.toString(16)}:${lo.toString(16)}`;
-  }
-  const parseGroup = (g) => /^[0-9a-f]{1,4}$/i.test(g) ? parseInt(g, 16) : null;
-  const halves = rest.split("::");
-  if (halves.length > 2) return null;
-  let parts;
-  if (halves.length === 2) {
-    const left = halves[0].length > 0 ? halves[0].split(":") : [];
-    const right = halves[1].length > 0 ? halves[1].split(":") : [];
-    if (left.length + right.length > 7) return null;
-    parts = [...left, ...Array(8 - left.length - right.length).fill("0"), ...right];
-  } else {
-    parts = rest.split(":");
-    if (parts.length !== 8) return null;
-  }
-  const groups = [];
-  for (const part of parts) {
-    const value = parseGroup(part);
-    if (value === null) return null;
-    groups.push(value);
-  }
-  return groups;
-}
 function isBlockedIpv6(groups) {
   if (groups.every((g) => g === 0)) return true;
   if (groups.slice(0, 7).every((g) => g === 0) && groups[7] === 1) return true;
@@ -4892,7 +4941,7 @@ async function takeScreenshot(url, destPath, opts) {
 }
 
 // src/notes.ts
-import * as fs4 from "node:fs";
+import * as fs3 from "node:fs";
 var WHOLE_FILE_NOTE_SYMBOL = "";
 function toNoteRow(row) {
   return {
@@ -4917,7 +4966,7 @@ function resolveSymbolMatch(filePath, symbolName, dbPath = globalDbPath()) {
 }
 function bodyFromSource(entry) {
   try {
-    return fs4.readFileSync(entry.filePath, "utf8").split(/\r?\n/).slice(Math.max(0, entry.lineStart - 1), entry.lineEnd).join("\n");
+    return fs3.readFileSync(entry.filePath, "utf8").split(/\r?\n/).slice(Math.max(0, entry.lineStart - 1), entry.lineEnd).join("\n");
   } catch {
     return "";
   }
@@ -4968,7 +5017,7 @@ function isNoteStale(note, dbPath = globalDbPath()) {
 
 // src/ts_refs.ts
 import { createRequire } from "node:module";
-import * as path4 from "node:path";
+import * as path3 from "node:path";
 var _require = createRequire(import.meta.url);
 var MAX_CANDIDATE_FILES = 50;
 var _ts = null;
@@ -4999,7 +5048,7 @@ registerReset(() => {
 var TS_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx", ".mts", ".cts"]);
 var TS_JS_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"]);
 function isTsPath(filePath) {
-  return TS_EXTENSIONS.has(path4.extname(filePath).toLowerCase());
+  return TS_EXTENSIONS.has(path3.extname(filePath).toLowerCase());
 }
 function resolveTypedRefs(input) {
   const ts = loadTs();
@@ -5029,7 +5078,7 @@ function resolveTypedRefs(input) {
   if (defSymbol === null) return null;
   const out = [];
   for (const ref of input.candidates) {
-    if (!TS_JS_EXTENSIONS.has(path4.extname(ref.filePath).toLowerCase())) {
+    if (!TS_JS_EXTENSIONS.has(path3.extname(ref.filePath).toLowerCase())) {
       out.push(ref);
       continue;
     }
@@ -5055,12 +5104,12 @@ function buildScopedProgram(ts, rootNames, searchFrom) {
     resolveJsonModule: true,
     esModuleInterop: true
   };
-  const configPath = ts.findConfigFile(path4.dirname(searchFrom), ts.sys.fileExists, "tsconfig.json");
+  const configPath = ts.findConfigFile(path3.dirname(searchFrom), ts.sys.fileExists, "tsconfig.json");
   if (configPath !== void 0) {
     try {
       const raw = ts.readConfigFile(configPath, ts.sys.readFile);
       if (raw.error === void 0) {
-        const parsed = ts.parseJsonConfigFileContent(raw.config, ts.sys, path4.dirname(configPath));
+        const parsed = ts.parseJsonConfigFileContent(raw.config, ts.sys, path3.dirname(configPath));
         Object.assign(options, parsed.options);
       }
     } catch {
@@ -5164,7 +5213,7 @@ var STRUCTURED_MISS_MAX_NODES = 2e4;
 var REFS_TOP_SCAN_LIMIT = 2e4;
 function fileExists(p) {
   try {
-    fs5.statSync(p);
+    fs4.statSync(p);
     return true;
   } catch {
     return false;
@@ -5195,30 +5244,30 @@ function withPinnedReads(pins, fn) {
   }
 }
 function readPinnedBytes(p, pinned) {
-  const fd = fs5.openSync(p, fs5.constants.O_RDONLY);
+  const fd = fs4.openSync(p, fs4.constants.O_RDONLY);
   try {
-    const actual = fileIdentity(fs5.fstatSync(fd, { bigint: true }));
+    const actual = fileIdentity(fs4.fstatSync(fd, { bigint: true }));
     if (actual !== pinned) {
       throw new ConfinementIdentityError(
         `refused: "${p}" changed identity between validation and read (validated ${pinned}, opened ${actual}). The file was replaced or redirected after the confinement check, so the read was not performed.`
       );
     }
-    return fs5.readFileSync(fd);
+    return fs4.readFileSync(fd);
   } finally {
-    fs5.closeSync(fd);
+    fs4.closeSync(fd);
   }
 }
 function verifyPinnedIdentity(p, pinned) {
-  const fd = fs5.openSync(p, fs5.constants.O_RDONLY);
+  const fd = fs4.openSync(p, fs4.constants.O_RDONLY);
   try {
-    const actual = fileIdentity(fs5.fstatSync(fd, { bigint: true }));
+    const actual = fileIdentity(fs4.fstatSync(fd, { bigint: true }));
     if (actual !== pinned) {
       throw new ConfinementIdentityError(
         `refused: "${p}" changed identity between validation and read (validated ${pinned}, opened ${actual}). The file was replaced or redirected after the confinement check, so the read was not performed.`
       );
     }
   } finally {
-    fs5.closeSync(fd);
+    fs4.closeSync(fd);
   }
 }
 function verifyStillAbsent(p) {
@@ -5236,7 +5285,7 @@ function verifyPin(p, pinned) {
   verifyPinnedIdentity(p, pinned);
 }
 function indexFileSyncPinned(resolvedPath, dbPath) {
-  const pinned = activePins?.get(pinKey(path5.resolve(resolvedPath)));
+  const pinned = activePins?.get(pinKey(path4.resolve(resolvedPath)));
   if (pinned === void 0) {
     indexFileSync(resolvedPath, dbPath);
     return;
@@ -5258,21 +5307,21 @@ function indexFileSyncPinned(resolvedPath, dbPath) {
   indexFileSync(resolvedPath, dbPath, bytes);
 }
 function readFileText(p) {
-  const pinned = activePins?.get(pinKey(path5.resolve(p)));
+  const pinned = activePins?.get(pinKey(path4.resolve(p)));
   try {
     if (pinned === ABSENT_PIN) {
       verifyStillAbsent(p);
       return null;
     }
     if (pinned !== void 0) return redactIfDotenv(p, decodeSource(readPinnedBytes(p, pinned)));
-    return redactIfDotenv(p, decodeSource(fs5.readFileSync(p)));
+    return redactIfDotenv(p, decodeSource(fs4.readFileSync(p)));
   } catch (err) {
     if (err instanceof ConfinementIdentityError) throw err;
     return null;
   }
 }
 function readFileBytes(p) {
-  const pinned = activePins?.get(pinKey(path5.resolve(p)));
+  const pinned = activePins?.get(pinKey(path4.resolve(p)));
   try {
     if (pinned === ABSENT_PIN) {
       verifyStillAbsent(p);
@@ -5283,9 +5332,9 @@ function readFileBytes(p) {
       if (bytes.length > MAX_ZIP_INPUT_BYTES) throw new ZipInputTooLargeError(p, bytes.length, MAX_ZIP_INPUT_BYTES);
       return bytes;
     }
-    const stat = fs5.statSync(p);
+    const stat = fs4.statSync(p);
     if (stat.size > MAX_ZIP_INPUT_BYTES) throw new ZipInputTooLargeError(p, stat.size, MAX_ZIP_INPUT_BYTES);
-    return fs5.readFileSync(p);
+    return fs4.readFileSync(p);
   } catch (err) {
     if (err instanceof ConfinementIdentityError || err instanceof ZipInputTooLargeError) throw err;
     return null;
@@ -5304,7 +5353,7 @@ var STALE_WARNING = "\u26A0 STALE: index is older than the file on disk (worker
 var DELETED_WARNING = "\u26A0 DELETED: this file is no longer on disk \u2014 what follows is what the index last saw of it";
 var DELETED_TAG = "\u26A0 DELETED: file no longer on disk";
 function fileIsGone(absPath) {
-  if (!path5.isAbsolute(absPath)) return false;
+  if (!path4.isAbsolute(absPath)) return false;
   return fileIsAbsent(absPath);
 }
 function staleWarning(resolvedPath) {
@@ -5372,12 +5421,18 @@ function sumFileSizes(filePaths) {
   let total = 0;
   for (const fp of new Set(filePaths)) {
     try {
-      total += Math.min(fs5.statSync(fp).size, PER_FILE_COUNTERFACTUAL_CEILING);
+      total += Math.min(fs4.statSync(fp).size, PER_FILE_COUNTERFACTUAL_CEILING);
     } catch {
     }
   }
   return total;
 }
+function refsSearchBaselineBytes(rows) {
+  let total = 0;
+  for (const ref of rows) total += Buffer.byteLength(`${refsDisplayPath(ref.filePath)}:${ref.line}: ${ref.context}
+`, "utf8");
+  return total;
+}
 function recordReadStat(kind, fullSourceBytes, emittedText, detail) {
   const emittedBytes = Buffer.byteLength(emittedText, "utf8");
   const bytesSaved = Math.max(1, fullSourceBytes - emittedBytes);
@@ -5550,7 +5605,7 @@ function findStructuredKeyPath(name, filePaths) {
     if (!isYaml && !lower.endsWith(".json")) continue;
     let size;
     try {
-      size = fs5.statSync(filePath).size;
+      size = fs4.statSync(filePath).size;
     } catch {
       continue;
     }
@@ -6088,7 +6143,7 @@ ${sub.text}`);
   return { text, code: 1 };
 }
 function resolveAgainstProjectRoot(file, projectRoot) {
-  return projectRoot !== void 0 && !path5.isAbsolute(file) ? path5.resolve(projectRoot, file) : file;
+  return projectRoot !== void 0 && !path4.isAbsolute(file) ? path4.resolve(projectRoot, file) : file;
 }
 function literalHeadingExists(filePath, heading) {
   const ordinalMatch = /^([^#\r\n]+)#(\d+)$/.exec(heading);
@@ -6112,7 +6167,7 @@ function runSection(opts) {
   }
   const result = readSection(filePath, heading, readFileText);
   if (result === null) {
-    if (!fs5.existsSync(filePath)) {
+    if (!fs4.existsSync(filePath)) {
       return { text: `File not found: '${filePath}'`, code: 1 };
     }
     const ordSpec = /^(.*?)#(\d+)$/.exec(heading);
@@ -6199,7 +6254,7 @@ function runSectionCrossFile(pairs, opts) {
     textBlocks.push(`${key}:
 ${sub.text}`);
   }
-  const resolvePath = (f) => opts.projectRoot !== void 0 && !path5.isAbsolute(f) ? path5.resolve(opts.projectRoot, f) : f;
+  const resolvePath = (f) => opts.projectRoot !== void 0 && !path4.isAbsolute(f) ? path4.resolve(opts.projectRoot, f) : f;
   const text = opts.json === true ? JSON.stringify(jsonOut, null, 2) : textBlocks.join("\n\n");
   if (anyFound) {
     const fullSourceBytes = sumFileSizes(Array.from(distinctFiles, resolvePath));
@@ -6272,7 +6327,7 @@ function renderRefsTargets(targets, opts, {
   const jsonOut = {};
   let anyFound = false;
   const lines = [];
-  const refFilePaths = [];
+  const refRows = [];
   for (const { file, symbol, key } of targets) {
     const queryOpts = { name: symbol };
     if (opts.excludeTests === true || opts.grep !== void 0) queryOpts.limit = REFS_TOP_SCAN_LIMIT;
@@ -6298,7 +6353,7 @@ function renderRefsTargets(targets, opts, {
       results = results.slice(0, opts.limit ?? 100);
     }
     if (results.length > 0) anyFound = true;
-    refFilePaths.push(...results.map((r) => r.filePath));
+    refRows.push(...results);
     if (opts.json === true) {
       const hiddenByGrep = matchesGrep !== void 0 ? preGrepCount - (filteredTotal ?? results.length) : 0;
       const withHidden = (payload) => ({ ...payload, ...annotateHiddenByGrep && hiddenByGrep > 0 ? { hiddenByGrep } : {} });
@@ -6340,7 +6395,7 @@ function renderRefsTargets(targets, opts, {
       if (notice !== null) lines.push(`  token-goat: ${notice}`);
     }
   }
-  const fullSourceBytes = sumFileSizes(refFilePaths);
+  const fullSourceBytes = refsSearchBaselineBytes(refRows);
   if (opts.json === true) {
     const text2 = JSON.stringify(jsonOut, null, 2);
     emit(text2);
@@ -6449,7 +6504,7 @@ function runRefsSingle(opts) {
     }
     return 1;
   }
-  const fullSourceBytes = sumFileSizes(results.map((r) => r.filePath));
+  const fullSourceBytes = refsSearchBaselineBytes(results);
   if (opts.json === true) {
     let payload;
     if (opts.top !== void 0) {
@@ -6522,7 +6577,7 @@ function renderCallerGroups(refs, contextLines = 0) {
   return lines;
 }
 function noSymbolsMessage(displayPath, resolvedPath) {
-  if (!fs5.existsSync(resolvedPath)) {
+  if (!fs4.existsSync(resolvedPath)) {
     return `Could not read: ${displayPath}`;
   }
   const lang = unsupportedLanguageName(resolvedPath);
@@ -7361,10 +7416,10 @@ function runConflicts(opts) {
   if (opts.path === void 0) {
     files = walkProject(process.cwd()).files;
   } else {
-    const abs = path5.resolve(opts.path);
+    const abs = path4.resolve(opts.path);
     let stat;
     try {
-      stat = fs5.statSync(abs);
+      stat = fs4.statSync(abs);
     } catch {
       emitErr(`Could not read: ${opts.path}`);
       return 1;
@@ -7399,7 +7454,7 @@ async function runPdfExtractText(file, pagesSpec, layout = false) {
   if (!fileExists(file)) {
     throw new Error(`Could not read: ${file}`);
   }
-  const data = fs5.readFileSync(file);
+  const data = fs4.readFileSync(file);
   const result = await extractPdfText(new Uint8Array(data), pagesSpec, layout);
   return result.text;
 }
@@ -7407,21 +7462,21 @@ async function runPdfOutline(file) {
   if (!fileExists(file)) {
     throw new Error(`Could not read: ${file}`);
   }
-  const data = fs5.readFileSync(file);
+  const data = fs4.readFileSync(file);
   return extractPdfOutline(new Uint8Array(data));
 }
 async function runPdfMeta(file) {
   if (!fileExists(file)) {
     throw new Error(`Could not read: ${file}`);
   }
-  const data = fs5.readFileSync(file);
+  const data = fs4.readFileSync(file);
   return extractPdfMeta(new Uint8Array(data));
 }
 async function runPdfLocate(file, pattern, opts) {
   if (!fileExists(file)) {
     throw new Error(`Could not read: ${file}`);
   }
-  const data = fs5.readFileSync(file);
+  const data = fs4.readFileSync(file);
   return locatePdfPages(new Uint8Array(data), pattern, opts);
 }
 async function runImageMeta(file) {
@@ -7431,7 +7486,7 @@ async function runImageMeta(file) {
   if (!isImagePath(file)) {
     throw new Error(`Not an image file: ${file}`);
   }
-  const data = fs5.readFileSync(file);
+  const data = fs4.readFileSync(file);
   const bytes = data.length;
   let probe;
   try {
@@ -7463,7 +7518,7 @@ async function runImageText(file) {
   if (!isImagePath(file)) {
     throw new Error(`Not an image file: ${file}`);
   }
-  const data = fs5.readFileSync(file);
+  const data = fs4.readFileSync(file);
   const ocr = await ocrImage(data);
   if (ocr === null) {
     if (ocrIntegrityFailed()) {
@@ -8167,7 +8222,7 @@ function runGrep(opts) {
     if (activePins !== null) {
       let realDir;
       try {
-        realDir = foldRealpath(fs5.realpathSync(dir));
+        realDir = foldRealpath(fs4.realpathSync(dir));
       } catch {
         return;
       }
@@ -8176,12 +8231,12 @@ function runGrep(opts) {
       visitedRealDirs.add(realDir);
     }
     try {
-      for (const entry of fs5.readdirSync(dir)) {
+      for (const entry of fs4.readdirSync(dir)) {
         if (entry.startsWith(".")) continue;
-        const full = path5.join(dir, entry);
+        const full = path4.join(dir, entry);
         let lst;
         try {
-          lst = fs5.lstatSync(full);
+          lst = fs4.lstatSync(full);
         } catch {
           continue;
         }
@@ -8189,7 +8244,7 @@ function runGrep(opts) {
         if (lst.isSymbolicLink()) {
           let real;
           try {
-            real = fs5.realpathSync(full);
+            real = fs4.realpathSync(full);
           } catch {
             continue;
           }
@@ -8198,7 +8253,7 @@ function runGrep(opts) {
         }
         let stat;
         try {
-          stat = fs5.statSync(target);
+          stat = fs4.statSync(target);
         } catch {
           continue;
         }
@@ -8218,16 +8273,16 @@ function runGrep(opts) {
       emitErr(`Path not found: ${searchPath}`);
       return 1;
     }
-    const stat = fs5.statSync(searchPath);
+    const stat = fs4.statSync(searchPath);
     if (stat.isDirectory()) {
-      const pinned = activePins?.get(pinKey(path5.resolve(searchPath)));
+      const pinned = activePins?.get(pinKey(path4.resolve(searchPath)));
       if (pinned !== void 0) verifyPin(searchPath, pinned);
       let boundaryReal;
       try {
-        boundaryReal = fs5.realpathSync(searchPath);
+        boundaryReal = fs4.realpathSync(searchPath);
       } catch (err) {
         if (pinned === void 0) {
-          boundaryReal = path5.resolve(searchPath);
+          boundaryReal = path4.resolve(searchPath);
         } else {
           throw new ConfinementIdentityError(
             `refused: "${searchPath}" could not be resolved after validation (${String(err)}). The path may have been replaced or redirected after the confinement check, so the search was not performed.`
@@ -8358,7 +8413,7 @@ function runConfigGet(opts) {
     emit(value);
     return 0;
   }
-  const ext = path5.extname(opts.file).toLowerCase();
+  const ext = path4.extname(opts.file).toLowerCase();
   if (ext === ".json") {
     try {
       let obj = JSON.parse(text);
@@ -8481,7 +8536,7 @@ function runExports(opts) {
       names.push(s.name);
     }
   }
-  const ext = path5.extname(opts.file).toLowerCase();
+  const ext = path4.extname(opts.file).toLowerCase();
   const text = readFileText(diskPath);
   if (text === null && symbols.length === 0) {
     emitErr(`Could not read: ${opts.file}`);
@@ -8818,9 +8873,9 @@ function extractImports(text, ext) {
   return found;
 }
 function importsExtensionFor(filePath) {
-  const base = path5.basename(filePath).toLowerCase();
+  const base = path4.basename(filePath).toLowerCase();
   if (base === "makefile" || base === "gnumakefile" || base === "bsdmakefile") return ".mk";
-  return path5.extname(filePath);
+  return path4.extname(filePath);
 }
 function runImports(opts) {
   const multiFiles = parseMultiFileSpec(opts.file);
@@ -8912,7 +8967,7 @@ async function runSemantic(query, opts) {
   }
   const n = opts.limit !== void 0 && Number.isFinite(opts.limit) ? opts.limit : 20;
   if (opts.projectRoot !== void 0) {
-    if (!path5.isAbsolute(opts.projectRoot) || !fs5.existsSync(opts.projectRoot) || !fs5.statSync(opts.projectRoot).isDirectory()) {
+    if (!path4.isAbsolute(opts.projectRoot) || !fs4.existsSync(opts.projectRoot) || !fs4.statSync(opts.projectRoot).isDirectory()) {
       const message = `token-goat: projectRoot must be an absolute, existing directory, got '${opts.projectRoot}'`;
       if (opts.json === true) {
         return { text: JSON.stringify({ error: message }, null, 2), code: 1 };
@@ -9150,6 +9205,318 @@ function runNoteList(opts = {}) {
   return { text: lines.join("\n"), code: 0 };
 }
 
+// src/import_graph.ts
+import * as fs5 from "node:fs";
+import * as path5 from "node:path";
+var DIRECT_PROBE_EXTENSIONS = ["", ".ts", ".tsx", ".js", ".jsx", ".mts", ".mjs", ".cjs", ".cts", ".py"];
+var INDEX_PROBE_EXTENSIONS = [".ts", ".js", ".tsx", ".jsx", ".mts", ".cts"];
+function buildImportGraph(cwd) {
+  const files = getTrackedFiles(cwd);
+  const filesByFoldedPath = /* @__PURE__ */ new Map();
+  for (const f of files) filesByFoldedPath.set(foldPath(f), f);
+  const resolve5 = (fromFile, spec) => {
+    if (!spec.startsWith(".")) return null;
+    const dir = path5.dirname(fromFile);
+    const strippedSpec = spec.replace(/\.(m?js|cjs)$/, "");
+    const base = path5.resolve(dir, strippedSpec);
+    for (const ext of DIRECT_PROBE_EXTENSIONS) {
+      const match = filesByFoldedPath.get(foldPath(base + ext));
+      if (match !== void 0) return match;
+    }
+    const idx = path5.join(base, "index");
+    for (const ext of INDEX_PROBE_EXTENSIONS) {
+      const match = filesByFoldedPath.get(foldPath(idx + ext));
+      if (match !== void 0) return match;
+    }
+    return null;
+  };
+  const graph = /* @__PURE__ */ new Map();
+  const importedBy = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    let text;
+    try {
+      text = fs5.readFileSync(file, "utf8");
+    } catch {
+      continue;
+    }
+    const internal = [];
+    for (const spec of extractImports(text, importsExtensionFor(file))) {
+      const resolved = resolve5(file, spec);
+      if (resolved === null) continue;
+      internal.push(resolved);
+      let importers = importedBy.get(resolved);
+      if (importers === void 0) {
+        importers = /* @__PURE__ */ new Set();
+        importedBy.set(resolved, importers);
+      }
+      importers.add(file);
+    }
+    graph.set(file, internal);
+  }
+  return { files, graph, importedBy, resolve: resolve5 };
+}
+
+// src/modules.ts
+var WEAK_MODULARITY = 0.3;
+var MAX_PASSES = 32;
+var GAIN_EPSILON = 1e-12;
+function emptyGraph(n) {
+  return { n, adj: Array.from({ length: n }, () => /* @__PURE__ */ new Map()), degree: new Array(n).fill(0), m: 0 };
+}
+function addEdge(g, a, b, w) {
+  if (a === b) {
+    g.adj[a].set(a, (g.adj[a].get(a) ?? 0) + w);
+    g.degree[a] += 2 * w;
+  } else {
+    g.adj[a].set(b, (g.adj[a].get(b) ?? 0) + w);
+    g.adj[b].set(a, (g.adj[b].get(a) ?? 0) + w);
+    g.degree[a] += w;
+    g.degree[b] += w;
+  }
+  g.m += w;
+}
+function localMoving(g) {
+  const community = Array.from({ length: g.n }, (_, i) => i);
+  const tot = g.degree.slice();
+  const twoM = 2 * g.m;
+  let movedEver = false;
+  if (twoM === 0) return { community, moved: false };
+  for (let pass = 0; pass < MAX_PASSES; pass++) {
+    let improved = false;
+    for (let i = 0; i < g.n; i++) {
+      const ki = g.degree[i];
+      const ci = community[i];
+      const links = /* @__PURE__ */ new Map();
+      for (const [j, w] of g.adj[i]) {
+        if (j === i) continue;
+        const cj = community[j];
+        links.set(cj, (links.get(cj) ?? 0) + w);
+      }
+      tot[ci] = tot[ci] - ki;
+      let bestC = ci;
+      let bestGain = (links.get(ci) ?? 0) - tot[ci] * ki / twoM;
+      for (const c of [...links.keys()].sort((a, b) => a - b)) {
+        if (c === ci) continue;
+        const gain = links.get(c) - tot[c] * ki / twoM;
+        if (gain > bestGain + GAIN_EPSILON) {
+          bestGain = gain;
+          bestC = c;
+        }
+      }
+      tot[bestC] = tot[bestC] + ki;
+      community[i] = bestC;
+      if (bestC !== ci) {
+        improved = true;
+        movedEver = true;
+      }
+    }
+    if (!improved) break;
+  }
+  return { community, moved: movedEver };
+}
+function densify(community) {
+  const firstMember = /* @__PURE__ */ new Map();
+  for (let i = 0; i < community.length; i++) {
+    const c = community[i];
+    if (!firstMember.has(c)) firstMember.set(c, i);
+  }
+  const ordered = [...firstMember.entries()].sort((a, b) => a[1] - b[1]).map(([c]) => c);
+  const remap = /* @__PURE__ */ new Map();
+  ordered.forEach((c, idx) => remap.set(c, idx));
+  return { dense: community.map((c) => remap.get(c)), count: ordered.length };
+}
+function modularityOf(g, partition) {
+  const twoM = 2 * g.m;
+  if (twoM === 0) return null;
+  const internal = /* @__PURE__ */ new Map();
+  const tot = /* @__PURE__ */ new Map();
+  for (let i = 0; i < g.n; i++) {
+    const ci = partition[i];
+    tot.set(ci, (tot.get(ci) ?? 0) + g.degree[i]);
+    for (const [j, w] of g.adj[i]) {
+      if (j < i) continue;
+      if (partition[j] === ci) internal.set(ci, (internal.get(ci) ?? 0) + w);
+    }
+  }
+  let q = 0;
+  for (const [c, t] of tot) {
+    q += 2 * (internal.get(c) ?? 0) / twoM - (t / twoM) ** 2;
+  }
+  return q;
+}
+function louvain(g) {
+  let current = g;
+  let mapping = Array.from({ length: g.n }, (_, i) => i);
+  for (let level = 0; level < MAX_PASSES; level++) {
+    const { community, moved } = localMoving(current);
+    const { dense, count } = densify(community);
+    mapping = mapping.map((c) => dense[c]);
+    if (!moved || count === current.n) break;
+    const next = emptyGraph(count);
+    for (let i = 0; i < current.n; i++) {
+      for (const [j, w] of current.adj[i]) {
+        if (j < i) continue;
+        addEdge(next, dense[i], dense[j], w);
+      }
+    }
+    current = next;
+  }
+  return mapping;
+}
+function commonDirLabel(files) {
+  const dirs = new Set(files.map(dirOf));
+  if (dirs.size === 1) {
+    const only = [...dirs][0];
+    return only === "." ? "." : `${only}/`;
+  }
+  const segmentLists = files.map((f) => {
+    const parts = f.split("/");
+    parts.pop();
+    return parts;
+  });
+  const first = segmentLists[0];
+  if (first === void 0) return null;
+  const prefix = [];
+  for (let i = 0; i < first.length; i++) {
+    const seg = first[i];
+    if (!segmentLists.every((s) => s[i] === seg)) break;
+    prefix.push(seg);
+  }
+  return prefix.length === 0 ? null : `${prefix.join("/")}/`;
+}
+function dirOf(file) {
+  const idx = file.lastIndexOf("/");
+  return idx === -1 ? "." : file.slice(0, idx);
+}
+function detectModules(imports, cwd, top) {
+  const { files, graph } = imports;
+  const root = getDisplayRoot(cwd);
+  const degreeOf = /* @__PURE__ */ new Map();
+  const bump = (f) => {
+    degreeOf.set(f, (degreeOf.get(f) ?? 0) + 1);
+  };
+  for (const [from, targets] of graph) {
+    for (const to of targets) {
+      if (from === to) continue;
+      bump(from);
+      bump(to);
+    }
+  }
+  const connected = files.filter((f) => (degreeOf.get(f) ?? 0) > 0);
+  const isolatedCount = files.length - connected.length;
+  if (connected.length === 0) {
+    return { modules: [], modulesTotal: 0, modularity: null, isolatedCount, crossImports: [], crossImportsTotal: 0, noEdges: true };
+  }
+  const ordered = [...connected].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+  const idOf = /* @__PURE__ */ new Map();
+  ordered.forEach((f, i) => idOf.set(f, i));
+  const g = emptyGraph(ordered.length);
+  const pairWeight = /* @__PURE__ */ new Map();
+  for (const [from, targets] of graph) {
+    const a = idOf.get(from);
+    if (a === void 0) continue;
+    for (const to of targets) {
+      const b = idOf.get(to);
+      if (b === void 0 || a === b) continue;
+      const key = a < b ? `${a}:${b}` : `${b}:${a}`;
+      pairWeight.set(key, (pairWeight.get(key) ?? 0) + 1);
+    }
+  }
+  for (const key of [...pairWeight.keys()].sort()) {
+    const [a, b] = key.split(":").map(Number);
+    addEdge(g, a, b, pairWeight.get(key));
+  }
+  const partition = louvain(g);
+  const modularity = modularityOf(g, partition);
+  const membersOf = /* @__PURE__ */ new Map();
+  for (let i = 0; i < ordered.length; i++) {
+    const c = partition[i];
+    const list = membersOf.get(c);
+    if (list === void 0) membersOf.set(c, [ordered[i]]);
+    else list.push(ordered[i]);
+  }
+  const inModuleDegree = /* @__PURE__ */ new Map();
+  for (const [from, targets] of graph) {
+    const a = idOf.get(from);
+    if (a === void 0) continue;
+    for (const to of targets) {
+      const b = idOf.get(to);
+      if (b === void 0 || a === b || partition[a] !== partition[b]) continue;
+      inModuleDegree.set(from, (inModuleDegree.get(from) ?? 0) + 1);
+      inModuleDegree.set(to, (inModuleDegree.get(to) ?? 0) + 1);
+    }
+  }
+  const built = [...membersOf.entries()].map(([c, absFiles]) => {
+    const display = absFiles.map((f) => toDisplayPath(root, f)).sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+    const coreAbs = [...absFiles].sort((a, b) => (inModuleDegree.get(b) ?? 0) - (inModuleDegree.get(a) ?? 0) || (a < b ? -1 : a > b ? 1 : 0))[0];
+    return { community: c, core: toDisplayPath(root, coreAbs), commonDir: commonDirLabel(display), files: display, directories: new Set(display.map(dirOf)).size };
+  }).sort((a, b) => b.files.length - a.files.length || (a.core < b.core ? -1 : a.core > b.core ? 1 : 0) || (a.files[0] < b.files[0] ? -1 : 1));
+  const indexOfCommunity = /* @__PURE__ */ new Map();
+  built.forEach((m, i) => indexOfCommunity.set(m.community, i + 1));
+  const coreOfIndex = /* @__PURE__ */ new Map();
+  built.forEach((m, i) => coreOfIndex.set(i + 1, m.core));
+  const crossCount = /* @__PURE__ */ new Map();
+  for (const [from, targets] of graph) {
+    const a = idOf.get(from);
+    if (a === void 0) continue;
+    const ca = indexOfCommunity.get(partition[a]);
+    if (ca === void 0) continue;
+    for (const to of targets) {
+      const b = idOf.get(to);
+      if (b === void 0) continue;
+      const cb = indexOfCommunity.get(partition[b]);
+      if (cb === void 0 || ca === cb) continue;
+      const key = `${ca}:${cb}`;
+      crossCount.set(key, (crossCount.get(key) ?? 0) + 1);
+    }
+  }
+  const allCross = [...crossCount.entries()].map(([key, imports2]) => {
+    const [fromIndex, toIndex] = key.split(":").map(Number);
+    return { fromIndex, toIndex, fromCore: coreOfIndex.get(fromIndex), toCore: coreOfIndex.get(toIndex), imports: imports2 };
+  }).sort((a, b) => b.imports - a.imports || a.fromIndex - b.fromIndex || a.toIndex - b.toIndex);
+  const modules = built.slice(0, top).map((m, i) => ({ index: i + 1, core: m.core, commonDir: m.commonDir, files: m.files, size: m.files.length, directories: m.directories }));
+  return {
+    modules,
+    modulesTotal: built.length,
+    modularity,
+    isolatedCount,
+    crossImports: allCross.slice(0, top),
+    crossImportsTotal: allCross.length,
+    noEdges: false
+  };
+}
+function renderModules(result, top) {
+  const lines = [];
+  if (result.noEdges) {
+    lines.push(`modules: none. No file in this project imports another by a relative path, so there is nothing to group (${countNoun(result.isolatedCount, "file")} checked).`);
+    return lines;
+  }
+  const q = result.modularity;
+  const strength = q === null ? "" : q < WEAK_MODULARITY ? `, modularity ${q.toFixed(2)} -- weak, so treat this grouping as a hint rather than a finding` : `, modularity ${q.toFixed(2)}`;
+  lines.push(result.modules.length < result.modulesTotal ? `modules (top ${result.modules.length} of ${result.modulesTotal}${strength}):` : `modules (${result.modulesTotal} found${strength}):`);
+  for (const m of result.modules) {
+    const where = m.commonDir === null ? `across ${m.directories} directories` : m.commonDir === "." ? "all in the repository root" : `all in ${m.commonDir}`;
+    lines.push(`  #${m.index} ${m.size} files	${m.core}	(${where})`);
+  }
+  if (result.isolatedCount > 0) {
+    lines.push(`  ${result.isolatedCount} files are in no module (they neither import nor are imported within the project).`);
+  }
+  if (result.crossImportsTotal === 0) {
+    lines.push("cross-module imports: none. Every import stays inside its own module.");
+  } else {
+    lines.push(
+      result.crossImports.length < result.crossImportsTotal ? `cross-module imports (top ${result.crossImports.length} of ${result.crossImportsTotal} pairs):` : `cross-module imports (${result.crossImportsTotal} pairs):`
+    );
+    for (const c of result.crossImports) {
+      lines.push(`  ${c.imports} imports	#${c.fromIndex} ${c.fromCore} -> #${c.toIndex} ${c.toCore}`);
+    }
+  }
+  if (result.modules.length < result.modulesTotal && result.crossImports.some((c) => c.fromIndex > top || c.toIndex > top)) {
+    lines.push(`  (a #N above ${top} refers to a module the --top cap left out; raise --top to see it.)`);
+  }
+  return lines;
+}
+
 // src/graph_commands.ts
 var DEFAULT_REF_QUERY_LIMIT = 500;
 var ALL_SYMBOLS_IN_FILE_LIMIT = 1e4;
@@ -10237,53 +10604,11 @@ function runArch(opts) {
   }
   const cwd = opts.cwd ?? process.cwd();
   const top = opts.top ?? 10;
-  const files = getTrackedFiles(cwd);
+  const { files, graph, importedBy, resolve: resolve5 } = buildImportGraph(cwd);
   if (files.length === 0 && opts.json !== true) {
     emit2(`no tracked files found under '${toDisplayPath(getDisplayRoot(cwd), cwd)}' (is it a git repo?). Nothing to analyse.`);
     return 0;
   }
-  const filesByFoldedPath = /* @__PURE__ */ new Map();
-  for (const f of files) filesByFoldedPath.set(foldPath(f), f);
-  const graph = /* @__PURE__ */ new Map();
-  const importedBy = /* @__PURE__ */ new Map();
-  const resolveRelImport = (fromFile, spec) => {
-    if (!spec.startsWith(".")) return null;
-    const dir = path6.dirname(fromFile);
-    const strippedSpec = spec.replace(/\.(m?js|cjs)$/, "");
-    const base = path6.resolve(dir, strippedSpec);
-    for (const ext of ["", ".ts", ".tsx", ".js", ".jsx", ".mts", ".mjs", ".cjs", ".cts", ".py"]) {
-      const candidate = base + ext;
-      const match = filesByFoldedPath.get(foldPath(candidate));
-      if (match !== void 0) return match;
-    }
-    const idx = path6.join(base, "index");
-    for (const ext of [".ts", ".js", ".tsx", ".jsx", ".mts", ".cts"]) {
-      const candidate = idx + ext;
-      const match = filesByFoldedPath.get(foldPath(candidate));
-      if (match !== void 0) return match;
-    }
-    return null;
-  };
-  for (const file of files) {
-    let text;
-    try {
-      text = fs6.readFileSync(file, "utf8");
-    } catch {
-      continue;
-    }
-    const ext = importsExtensionFor(file);
-    const rawImports = extractImports(text, ext);
-    const internal = [];
-    for (const spec of rawImports) {
-      const resolved = resolveRelImport(file, spec);
-      if (resolved !== null) {
-        internal.push(resolved);
-        if (!importedBy.has(resolved)) importedBy.set(resolved, /* @__PURE__ */ new Set());
-        importedBy.get(resolved).add(file);
-      }
-    }
-    graph.set(file, internal);
-  }
   const allHubs = [...importedBy.entries()].sort((a, b) => b[1].size - a[1].size).map(([f, importers]) => ({ file: f, importedBy: importers.size }));
   const hubsTotal = allHubs.length;
   const hubs = allHubs.slice(0, top);
@@ -10291,8 +10616,10 @@ function runArch(opts) {
   const entryPointsTotal = allEntryPoints.length;
   const entryPoints = allEntryPoints.slice(0, top);
   const { cycles, truncated: cyclesTruncated } = findCyclesCapped(graph);
+  const moduleResult = opts.modules === true ? detectModules({ files, graph, importedBy, resolve: resolve5 }, cwd, top) : null;
   if (opts.json === true) {
-    emit2(JSON.stringify({ hubs, hubsTotal, hubsTruncated: hubs.length < hubsTotal, entryPoints, entryPointsTotal, entryPointsTruncated: entryPoints.length < entryPointsTotal, cycles, ...cyclesTruncated ? { cyclesTruncated: true } : {} }, null, 2));
+    const modulePayload = moduleResult === null ? {} : { modules: moduleResult.modules, modulesTotal: moduleResult.modulesTotal, modulesTruncated: moduleResult.modules.length < moduleResult.modulesTotal, modularity: moduleResult.modularity, isolatedCount: moduleResult.isolatedCount, crossImports: moduleResult.crossImports, crossImportsTotal: moduleResult.crossImportsTotal, crossImportsTruncated: moduleResult.crossImports.length < moduleResult.crossImportsTotal, noImportEdges: moduleResult.noEdges };
+    emit2(JSON.stringify({ hubs, hubsTotal, hubsTruncated: hubs.length < hubsTotal, entryPoints, entryPointsTotal, entryPointsTruncated: entryPoints.length < entryPointsTotal, cycles, ...cyclesTruncated ? { cyclesTruncated: true } : {}, ...modulePayload }, null, 2));
     return 0;
   }
   emit2(hubs.length < hubsTotal ? `hubs (top ${hubs.length} of ${hubsTotal} most-imported):` : `hubs (${hubsTotal} most-imported):`);
@@ -10301,6 +10628,7 @@ function runArch(opts) {
   for (const e of entryPoints) emit2(`  ${toDisplayPath(getDisplayRoot(opts.cwd), e.file)}`);
   emit2(cyclesTruncated ? `cycles (first ${cycles.length}, truncated at the ${MAX_CYCLES}-cycle enumeration limit: more cycles exist):` : `cycles (${cycles.length} found):`);
   for (const c of cycles) emit2(`  ${c.map((f) => toDisplayPath(getDisplayRoot(opts.cwd), f)).join(" -> ")}`);
+  if (moduleResult !== null) for (const line of renderModules(moduleResult, top)) emit2(line);
   return 0;
 }
 function runBlame(opts) {
@@ -10556,10 +10884,10 @@ function resolveHandoff(name, opts = {}) {
 }
 
 export {
-  getTrackedFiles,
   extractSection,
   readSection,
   listSections,
+  buildImportGraph,
   ALL_SYMBOLS_IN_FILE_LIMIT,
   enclosingSymbol,
   runCallers,
@@ -10651,5 +10979,5 @@ export {
 /*! Bundled license information:
 
 js-yaml/dist/js-yaml.mjs:
-  (*! js-yaml 5.3.0 https://github.com/nodeca/js-yaml @license MIT *)
+  (*! js-yaml 5.4.1 https://github.com/nodeca/js-yaml @license MIT *)
 */