@ulpi/codemap 0.3.13 → 0.3.14

package/README.md

@@ -183,6 +183,22 @@ codemap cycles
 codemap cycles --json
 ```
 
+### `codemap read <file>`
+
+Read and return the full source of a file, or a specific line range.
+
+```bash
+codemap read src/routes/auth.ts
+codemap read src/index.ts --from 10 --to 50
+codemap read src/index.ts --json
+```
+
+| Option | Description |
+|--------|-------------|
+| `--from <line>` | Start line (1-based, inclusive) |
+| `--to <line>` | End line (1-based, inclusive) |
+| `--json` | Output as JSON (includes filePath, totalLines, from, to, content) |
+
 ### `codemap summary <file>`
 
 Show file overview with symbols and size.
@@ -424,7 +440,7 @@ Add to `.mcp.json` in your project root:
 }
 ```
 
-`"codemap"` serves the current project automatically. `"codemap-frontend"` serves a different codebase via `--cwd`. Add as many as you need — each gets its own set of 12 tools (`search_code`, `get_dependencies`, etc.) scoped to that project.
+`"codemap"` serves the current project automatically. `"codemap-frontend"` serves a different codebase via `--cwd`. Add as many as you need — each gets its own set of 13 tools (`search_code`, `read_file`, `get_dependencies`, etc.) scoped to that project.
 
 #### Other Editors
 
@@ -436,6 +452,7 @@ Your AI agent will then have access to tools like `search_code`, `get_dependenci
 
 | Tool | Description |
 |------|-------------|
+| `read_file` | Read full source or a line range (supports `from`/`to` params) |
 | `search_code` | Search code using hybrid vector + BM25 |
 | `search_symbols` | Find functions, classes, and types by name |
 | `get_file_summary` | Get file overview with symbols and size |

package/dist/index.js

@@ -5,7 +5,7 @@ import "./chunk-WR342MP3.js";
 import "./chunk-2OBAJYRP.js";
 
 // src/index.ts
-import path14 from "path";
+import path15 from "path";
 import { fileURLToPath } from "url";
 
 // ../../packages/intelligence/codemap-engine/dist/index.js
@@ -5939,6 +5939,7 @@ symbol lookup, dependency analysis, and PageRank file ranking.
 |------|-------------|
 | \`mcp__codemap__search_code\` | Hybrid vector + BM25 semantic code search |
 | \`mcp__codemap__search_symbols\` | Find functions, classes, types by name |
+| \`mcp__codemap__read_file\` | Read full source or a line range (\`from\`/\`to\` params) |
 | \`mcp__codemap__get_file_summary\` | File overview with symbols and line count |
 | \`mcp__codemap__get_index_stats\` | Index statistics (files, chunks, size) |
 | \`mcp__codemap__get_dependencies\` | Files this file imports (outgoing) |
@@ -5956,6 +5957,7 @@ symbol lookup, dependency analysis, and PageRank file ranking.
 |---------|-------------|
 | \`codemap search <query>\` | Hybrid vector + BM25 semantic code search |
 | \`codemap symbols <query>\` | Find functions, classes, types by name |
+| \`codemap read <file>\` | Read full source or line range (\`--from N --to M\`) |
 | \`codemap summary <file>\` | File overview with symbols and line count |
 | \`codemap status\` | Index statistics (files, chunks, size) |
 | \`codemap deps <file>\` | Files this file imports (outgoing) |
@@ -5969,6 +5971,7 @@ symbol lookup, dependency analysis, and PageRank file ranking.
 
 ### When to Use
 
+- **Reading files**: \`read_file\` to read full source or a line range (e.g. lines 10\u201350) \u2014 works across all connected projects
 - **Before editing**: \`search_code\` or \`search_symbols\` to find relevant files
 - **Understanding impact**: \`get_dependents\` to see what breaks if you change a file
 - **Architecture review**: \`get_coupling_metrics\` and \`find_cycles\` for code health
@@ -7243,8 +7246,11 @@ if [ -f "$mcp_file" ]; then
       for (const [name, config] of Object.entries(servers)) {
         if (config.command !== 'codemap') continue;
         const args = config.args || [];
+        const env = config.env || {};
         const cwdIdx = args.indexOf('--cwd');
-        const cwd = cwdIdx >= 0 && cwdIdx + 1 < args.length ? args[cwdIdx + 1] : '';
+        const cwd = cwdIdx >= 0 && cwdIdx + 1 < args.length
+          ? args[cwdIdx + 1]
+          : (env.CODEMAP_PROJECT_DIR || '');
         console.log(name + '|' + cwd);
       }
     } catch {}
@@ -7392,9 +7398,47 @@ function uninstall() {
   console.log(chalk17.dim("Restart Claude Code for changes to take effect."));
 }
 
+// src/commands/read.ts
+import chalk18 from "chalk";
+import fs19 from "fs";
+import path14 from "path";
+function registerRead(program2) {
+  program2.command("read <file>").description("Read and return the full source of a file (or a line range)").option("--json", "Output as JSON").option("--from <line>", "Start line (1-based)", parseInt).option("--to <line>", "End line (inclusive)", parseInt).action(async (file, opts) => {
+    const projectDir = program2.opts().cwd || process.cwd();
+    const fullPath = path14.resolve(projectDir, file);
+    if (!fs19.existsSync(fullPath)) {
+      console.error(chalk18.red(`File not found: ${file}`));
+      process.exit(1);
+      return;
+    }
+    const raw = fs19.readFileSync(fullPath, "utf-8");
+    const allLines = raw.split("\n");
+    const totalLines = allLines.length;
+    const from = opts.from ?? 1;
+    const to = opts.to ?? totalLines;
+    const startIdx = Math.max(0, from - 1);
+    const endIdx = Math.min(totalLines, to);
+    const lines = allLines.slice(startIdx, endIdx);
+    const content = lines.join("\n");
+    if (opts.json) {
+      console.log(JSON.stringify({
+        filePath: file,
+        totalLines,
+        from,
+        to: endIdx,
+        lineCount: lines.length,
+        sizeBytes: Buffer.byteLength(content, "utf-8"),
+        content
+      }, null, 2));
+      return;
+    }
+    console.log(content);
+  });
+}
+
 // src/index.ts
-var __dirname = path14.dirname(fileURLToPath(import.meta.url));
-var grammarsDir = path14.join(__dirname, "grammars");
+var __dirname = path15.dirname(fileURLToPath(import.meta.url));
+var grammarsDir = path15.join(__dirname, "grammars");
 setGrammarDir(grammarsDir);
 var program = new Command();
 program.name("codemap").description("Code intelligence CLI \u2014 hybrid search, dependency analysis, PageRank").version("0.3.5").option("--cwd <dir>", "Project directory (default: cwd)");
@@ -7416,4 +7460,5 @@ registerCoupling(program);
 registerGraphStats(program);
 registerRebuild(program);
 registerStatusline(program);
+registerRead(program);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ulpi/codemap",
-  "version": "0.3.13",
+  "version": "0.3.14",
   "type": "module",
   "description": "Standalone code intelligence CLI — hybrid vector + BM25 search, dependency analysis, PageRank",
   "bin": {