token-goat 2.9.16 → 2.9.17

package/dist/token-goat.core.mjs

@@ -2,33 +2,33 @@ import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
 import {
   run
-} from "./token-goat-chunk-Z5VPAXTC.mjs";
-import "./token-goat-chunk-2PCFAQAS.mjs";
-import "./token-goat-chunk-EJCY6KHO.mjs";
+} from "./token-goat-chunk-7VQMOBPQ.mjs";
+import "./token-goat-chunk-IDHWKNKZ.mjs";
+import "./token-goat-chunk-CICJFVIH.mjs";
 import "./token-goat-chunk-LMFO66YD.mjs";
-import "./token-goat-chunk-UMXD2M7O.mjs";
-import "./token-goat-chunk-XOHTFRDH.mjs";
-import "./token-goat-chunk-5USHO7B6.mjs";
-import "./token-goat-chunk-DMQ32ZSR.mjs";
+import "./token-goat-chunk-HRUGS6CO.mjs";
+import "./token-goat-chunk-PKNOHVWP.mjs";
+import "./token-goat-chunk-C26ZBGBC.mjs";
+import "./token-goat-chunk-26YUO7MP.mjs";
 import "./token-goat-chunk-LKSXAMJB.mjs";
-import "./token-goat-chunk-NQZCSVN2.mjs";
-import "./token-goat-chunk-2IEIBVVD.mjs";
-import "./token-goat-chunk-NAMH252H.mjs";
-import "./token-goat-chunk-GIMGT34T.mjs";
+import "./token-goat-chunk-CPHVXKNU.mjs";
+import "./token-goat-chunk-W2GUUQAQ.mjs";
+import "./token-goat-chunk-THBLW56G.mjs";
+import "./token-goat-chunk-KZPO4DWC.mjs";
 import "./token-goat-chunk-3BTK54F3.mjs";
-import "./token-goat-chunk-MA5BZ2KI.mjs";
+import "./token-goat-chunk-66224KCZ.mjs";
 import "./token-goat-chunk-XTQAOTSO.mjs";
 import "./token-goat-chunk-AH6QILZM.mjs";
-import "./token-goat-chunk-YPS64ACE.mjs";
-import "./token-goat-chunk-BFNTLGVA.mjs";
-import "./token-goat-chunk-63QWJ6UM.mjs";
-import "./token-goat-chunk-R3X5TCPB.mjs";
-import "./token-goat-chunk-H3DXI6VD.mjs";
+import "./token-goat-chunk-SWRKVA3J.mjs";
+import "./token-goat-chunk-73GXYYZR.mjs";
+import "./token-goat-chunk-BK3RPPTK.mjs";
+import "./token-goat-chunk-MWSVUKVV.mjs";
+import "./token-goat-chunk-2VASS5VR.mjs";
 import "./token-goat-chunk-EEIDFMEM.mjs";
 import "./token-goat-chunk-OSUFN2FV.mjs";
 import {
   installEpipeGuard
-} from "./token-goat-chunk-3H6FQT62.mjs";
+} from "./token-goat-chunk-UBZCON6N.mjs";
 import "./token-goat-chunk-ERTXEKB6.mjs";
 import "./token-goat-chunk-Y4AFKTHK.mjs";
 import "./token-goat-chunk-GMOUBOX4.mjs";

package/docs/cli.md

@@ -74,6 +74,7 @@ token-goat pdf-extract manual.pdf --pages 12-15 --layout --head 120
 | `token-goat imports "file"` | Show the import graph for a file one level deep. Accepts a comma-separated file list (`"a,b,c"`) to cover several files in one call, one clearly-headed block per file; extra space-separated file arguments are reported in a note naming that comma form instead of being silently dropped. `--grep <pattern>` only shows imports whose MODULE SPECIFIER matches this regex (literal substring if it is not valid regex), applied before `--json`'s truncation; when it matches nothing among real imports, the output names the active filter instead of reading like the file has no imports at all. |
 | `token-goat dep-docs <package>` | Extract one installed npm package's README, `package.json` metadata, and (if resolvable) a compact `.d.ts` signature outline, instead of grepping `node_modules`. |
 | `token-goat find "<query>"` | Find the FILES defining a symbol whose name matches a pattern: a case-insensitive substring scan over indexed symbol names, emitting the distinct file paths. When no name contains the pattern, falls back to an edit-distance match so a mistyped name still lands (`getUserr` → `getUser`) — the same ranking `Did you mean:` uses. The fallback runs only when the substring pass found nothing, so an exact match is never reordered or displaced, and a query near nothing still reports a clean miss instead of unrelated names. A recovered match names what it actually matched on stderr rather than silently answering for a name you didn't type; `--json` marks it with `fuzzy: true` and `matchedNames`, both absent on an exact hit. `--limit <n>` caps the file count. Matches on NAMES only — for meaning-based search over file content use `token-goat semantic`. |
+| `token-goat locate <spec>` | Locate a symbol or landmark with exact line spans across the project or in a specific file. Supports `name` or `file::name`, with fuzzy edit-distance fallback when no exact match is found. `--file <path>` restricts search to a specific file; `--limit <n>` caps results; `--json` emits the shared envelope with exact line spans. |
 | `token-goat similar "file::symbol"` | Find the top-k symbols most similar to a given symbol, via full-text search over symbol names and bodies. Also accepts `read`'s `symbol@LINE` anchor to pick out an otherwise-ambiguous candidate. |
 | `token-goat test-for "file"` | Find test file(s) for an implementation file and list their test functions. `--json`'s `testFile` renders root-relative when a project root resolves, absolute when none does, matching plain-text output. `--json` emits the shared `{items, truncated, totalCount}` envelope — the same shape `symbol`/`refs`/`skeleton`/`outline --json` return, present whether or not truncation occurred, so a script never has to branch on shape. |
 | `token-goat dead` | Surface functions, methods, and classes with no recorded callers in the project index. Private names and common entry points (`main`, `app`, etc.) are excluded by default. `--include-private` lifts the underscore filter; `--kind` narrows to specific symbol types, comma-separated for a union (`--kind function,method`) — an unrecognized kind errors instead of silently reading as a clean codebase; `--top N` caps output; `--json` for structured output. `--exclude-tests` hides dead symbols DEFINED in a test file (opt-in — omitted, output is unchanged); prints a note naming how many were hidden. `--grep <pattern>` only shows dead symbols whose NAME matches this regex (literal substring if it is not valid regex), applied before `--top`'s slice; when it matches nothing among dead symbols that do exist, the output names the active filter instead of reading like a genuinely clean codebase. Results are a heuristic lead — dynamic dispatch and external callers are invisible to static indexing. `--json` emits both `file` and `filePath` with the identical value, root-relative when a project root resolves, absolute when none does, matching plain-text output; `file` is retained for this release only and will be removed in a future release, `filePath` is the spelling to migrate to (matching `symbol`/`types --json`). `--json` emits the shared `{items, truncated, totalCount}` envelope — the same shape `symbol`/`refs`/`skeleton`/`outline --json` return, present whether or not truncation occurred, so a script never has to branch on shape. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "token-goat",
-  "version": "2.9.16",
+  "version": "2.9.17",
   "description": "Surgical token-reduction companion for Claude Code and other AI coding agents",
   "type": "module",
   "main": "./dist/token-goat.mjs",