token-goat 2.3.0 → 2.4.0

package/README.md

@@ -356,7 +356,7 @@ To upgrade cleanly:
 | Command | What it does |
 |---------|-------------|
 | `token-goat symbol <name>` | Jump to a symbol definition. Add `--all-projects` to search across every indexed repo. |
-| `token-goat read "file::symbol"` | Pull one function or class, not the whole file. Supports qualified lookups: `read "file.py::Class.method"`. |
+| `token-goat read "file::symbol"` | Pull one function or class, not the whole file. Supports qualified lookups (`read "file.py::Class.method"`) and line ranges: `read "file.py@10-40"` for lines 10 to 40 inclusive, or `read "file.py@42"` for one line. Line ranges read straight from disk, so they work on any file, including paths outside an indexed project. |
 | `token-goat section "doc.md::Heading"` | Pull one Markdown section by heading. Near-miss headings auto-redirect (difflib ratio ≥ 0.75) with a `(redirected from: …)` marker. Disambiguate duplicates with `"doc.md::Heading#2"`. |
 | `token-goat skill-section "<name>::<heading>"` | Extract a named section from an installed skill without reading the full skill file. |
 | `token-goat skeleton "file"` | Show all signatures in a file without bodies — typically 70–90% fewer tokens than a full read. |

package/dist/token-goat.mjs

@@ -9493,7 +9493,7 @@ init_define_import_meta_env();
 import { createRequire } from "node:module";
 function resolveVersion() {
   if (true) {
-    return "2.3.0";
+    return "2.4.0";
   }
   const require2 = createRequire(import.meta.url);
   const pkg = require2("../package.json");
@@ -31060,7 +31060,47 @@ function parseReadSpec(spec) {
   if (colonIdx === -1) return { file: spec };
   return { file: spec.slice(0, colonIdx), symbol: spec.slice(colonIdx + 2) };
 }
+function parseLineRange(spec) {
+  const m = /^(.+)@(\d+)(?:-(\d+))?$/.exec(spec);
+  if (m === null) return null;
+  const start = parseInt(m[2], 10);
+  const end = m[3] !== void 0 ? parseInt(m[3], 10) : start;
+  return { file: m[1], start, end };
+}
+function runLineRange(range, opts) {
+  const { file, start, end } = range;
+  if (start < 1) {
+    emitErr(`Invalid line range: start must be >= 1 (got ${start})`);
+    return 1;
+  }
+  if (end < start) {
+    emitErr(`Invalid line range: end (${end}) is before start (${start})`);
+    return 1;
+  }
+  const text = readFileText(file);
+  if (text === null) {
+    emitErr(`Could not read: ${file}`);
+    return 1;
+  }
+  const allLines = text.split(/\r?\n/);
+  if (allLines.length > 1 && allLines[allLines.length - 1] === "") allLines.pop();
+  if (start > allLines.length) {
+    emitErr(`Line ${start} is past end of file (${allLines.length} lines): ${file}`);
+    return 1;
+  }
+  const clampedEnd = Math.min(end, allLines.length);
+  const slice = allLines.slice(start - 1, clampedEnd);
+  if (opts.json === true) {
+    emit(JSON.stringify({ file, start, end: clampedEnd, lines: slice }, null, 2));
+    return 0;
+  }
+  const tok = Math.ceil(slice.join("\n").length / 4);
+  emit([`# lines ${start}-${clampedEnd} of ${allLines.length} (~${tok} tok)`, slice.join("\n")].join("\n"));
+  return 0;
+}
 function runRead(opts) {
+  const range = parseLineRange(opts.spec);
+  if (range !== null) return runLineRange(range, opts);
   const { file, symbol } = parseReadSpec(opts.spec);
   if (symbol === void 0 || symbol === "") {
     const text = readFileText(file);

package/package.json

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