@ulpi/codemap 0.3.12 → 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
@@ -5924,13 +5924,10 @@ function registerInit(program2) {
     console.log(`  ${chalk3.cyan("codemap search")}   Search your code`);
     console.log(`  ${chalk3.cyan("codemap serve")}    Start MCP server`);
     console.log();
-    printAgentSnippet();
+    await showAgentSnippet(program2.opts().cwd || process.cwd());
   });
 }
-function printAgentSnippet() {
-  console.log(chalk3.bold("Add to your CLAUDE.md / agents.md / rules:"));
-  console.log(chalk3.dim("\u2500".repeat(60)));
-  console.log(`
+var AGENT_SNIPPET = `
 ## Code Intelligence (codemap)
 
 This project is indexed with codemap for semantic code search,
@@ -5942,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) |
@@ -5959,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) |
@@ -5972,14 +5971,39 @@ 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
 - **Navigation**: \`get_file_rank\` to identify the most important files
-`.trim());
+- **Cross-project**: Any \`codemap-<name>\` MCP servers (e.g. \`codemap-frontend\`) are connected projects \u2014 use their tools to search and trace dependencies across your stack
+`.trim();
+async function showAgentSnippet(projectDir) {
+  console.log(chalk3.bold("Agent configuration snippet:"));
+  console.log(chalk3.dim("\u2500".repeat(60)));
+  console.log(AGENT_SNIPPET);
   console.log();
   console.log(chalk3.dim("\u2500".repeat(60)));
-  console.log(chalk3.dim("Copy the above into your CLAUDE.md, .cursorrules, or agent config."));
+  const claudeMdPath = path11.join(projectDir, "CLAUDE.md");
+  const exists = fs13.existsSync(claudeMdPath);
+  const prompt = exists ? `Append this to ${chalk3.cyan("CLAUDE.md")}? (Y/n): ` : `Create ${chalk3.cyan("CLAUDE.md")} with this content? (Y/n): `;
+  const answer = await ask(prompt);
+  if (answer.toLowerCase() !== "n") {
+    if (exists) {
+      const current = fs13.readFileSync(claudeMdPath, "utf-8");
+      if (current.includes("## Code Intelligence (codemap)")) {
+        console.log(chalk3.yellow("CLAUDE.md already contains a codemap section. Skipping."));
+      } else {
+        fs13.appendFileSync(claudeMdPath, "\n\n" + AGENT_SNIPPET + "\n");
+        console.log(chalk3.green("Appended to ") + chalk3.cyan("CLAUDE.md"));
+      }
+    } else {
+      fs13.writeFileSync(claudeMdPath, AGENT_SNIPPET + "\n");
+      console.log(chalk3.green("Created ") + chalk3.cyan("CLAUDE.md"));
+    }
+  } else {
+    console.log(chalk3.dim("Skipped. You can copy the snippet above manually."));
+  }
   console.log();
   console.log(chalk3.bold("Multi-project setup"));
   console.log();
@@ -7222,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 {}
@@ -7371,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)");
@@ -7395,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.12",
+  "version": "0.3.14",
   "type": "module",
   "description": "Standalone code intelligence CLI — hybrid vector + BM25 search, dependency analysis, PageRank",
   "bin": {