repomap-ai 0.1.0

package/README.md

@@ -0,0 +1,91 @@
+# repomap-ai
+
+> Token-efficient repository mapping tool for AI IDEs — npm wrapper for the [repomap](https://pypi.org/project/repomap/) Python package.
+
+RepoMap parses source code with tree-sitter, builds function-level dependency graphs, and outputs compact maps that fit within LLM token budgets. Works with Cursor, VS Code, and any MCP-compatible AI IDE.
+
+## Requirements
+
+- **Node.js** >= 16
+- **Python** >= 3.11 (with pip)
+
+## Usage
+
+### One-time use (no install)
+
+```bash
+npx repomap-ai generate .
+```
+
+### Global install
+
+```bash
+npm install -g repomap-ai
+repomap generate .
+```
+
+### Or install via pip directly
+
+```bash
+pip install repomap
+repomap generate .
+```
+
+## Quick Start
+
+```bash
+# Generate a map of any repository
+npx repomap-ai generate /path/to/your/repo
+
+# Or if you're already inside the repo
+cd /path/to/your/repo
+npx repomap-ai generate .
+
+# With a larger token budget, JSON format
+npx repomap-ai generate . --max-tokens 4000 --format json
+
+# Set up MCP integration for Cursor / VS Code
+npx repomap-ai init .
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `repomap generate .` | Generate a token-budgeted map of the repository |
+| `repomap visual . -o map.html` | Interactive HTML dependency graph |
+| `repomap stats .` | Symbol and edge statistics |
+| `repomap watch .` | Incremental file watcher |
+| `repomap serve . --transport stdio` | Start MCP server for IDE integration |
+| `repomap init .` | Generate `.cursor/mcp.json` and `.vscode/mcp.json` |
+
+## MCP Integration (Cursor / VS Code)
+
+Run `repomap init .` in your repo root to auto-generate config files, then restart your IDE.
+
+Or add manually to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "repomap": {
+      "command": "repomap",
+      "args": ["serve", ".", "--transport", "stdio"]
+    }
+  }
+}
+```
+
+## How It Works
+
+This npm package is a thin wrapper. When you run `npx repomap-ai`, it:
+
+1. Checks if the `repomap` Python CLI is installed
+2. If not, runs `pip install repomap` automatically
+3. Delegates all commands to the Python CLI
+
+The actual implementation lives in the [`repomap` PyPI package](https://pypi.org/project/repomap/).
+
+## License
+
+MIT

package/bin/repomap.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawnSync } = require('child_process');
+
+// Forward every argument after "node bin/repomap.js" to the Python CLI
+const args = process.argv.slice(2);
+
+const result = spawnSync('repomap', args, {
+  stdio: 'inherit',
+  // On Windows, spawn via shell so PATH is resolved correctly
+  shell: process.platform === 'win32',
+});
+
+if (result.error) {
+  if (result.error.code === 'ENOENT') {
+    process.stderr.write(
+      '[repomap-ai] Could not find the "repomap" Python CLI.\n' +
+      '             Try reinstalling: npm install -g repomap-ai\n' +
+      '             Or install directly: pip install repomap\n'
+    );
+    process.exit(1);
+  }
+  throw result.error;
+}
+
+process.exit(result.status ?? 0);

package/install.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+'use strict';
+
+const { execSync, spawnSync } = require('child_process');
+
+const PYPI_PACKAGE = 'repomap';
+const MIN_PYTHON_VERSION = [3, 11];
+
+// ─── Helpers ────────────────────────────────────────────────────────────────
+
+function log(msg) {
+  process.stdout.write('[repomap-ai] ' + msg + '\n');
+}
+
+function err(msg) {
+  process.stderr.write('[repomap-ai] ERROR: ' + msg + '\n');
+}
+
+/** Try running a command; return stdout on success, null on failure. */
+function tryExec(cmd) {
+  try {
+    return execSync(cmd, { stdio: ['ignore', 'pipe', 'ignore'] })
+      .toString()
+      .trim();
+  } catch {
+    return null;
+  }
+}
+
+// ─── Check if repomap CLI is already on PATH ─────────────────────────────────
+
+const alreadyInstalled = tryExec('repomap --version');
+if (alreadyInstalled !== null) {
+  log('repomap is already installed (' + alreadyInstalled + '). Nothing to do.');
+  process.exit(0);
+}
+
+// ─── Detect Python ───────────────────────────────────────────────────────────
+
+function detectPython() {
+  for (const bin of ['python3', 'python']) {
+    const version = tryExec(bin + ' --version');
+    if (!version) continue;
+
+    // version looks like "Python 3.12.0"
+    const match = version.match(/Python (\d+)\.(\d+)/);
+    if (!match) continue;
+
+    const major = parseInt(match[1], 10);
+    const minor = parseInt(match[2], 10);
+    if (
+      major > MIN_PYTHON_VERSION[0] ||
+      (major === MIN_PYTHON_VERSION[0] && minor >= MIN_PYTHON_VERSION[1])
+    ) {
+      return bin;
+    }
+  }
+  return null;
+}
+
+const python = detectPython();
+if (!python) {
+  err(
+    'Python 3.11 or later is required but was not found on your PATH.\n' +
+    '       Install Python from https://python.org/downloads/ and then re-run:\n' +
+    '         npm install -g repomap-ai'
+  );
+  process.exit(1);
+}
+
+log('Found ' + tryExec(python + ' --version') + '. Installing repomap from PyPI…');
+
+// ─── Detect pip ──────────────────────────────────────────────────────────────
+
+function detectPip(pythonBin) {
+  // Prefer running pip as a Python module to guarantee it matches the right interpreter
+  if (tryExec(pythonBin + ' -m pip --version') !== null) {
+    return pythonBin + ' -m pip';
+  }
+  for (const bin of ['pip3', 'pip']) {
+    if (tryExec(bin + ' --version') !== null) return bin;
+  }
+  return null;
+}
+
+const pip = detectPip(python);
+if (!pip) {
+  err(
+    'pip was not found. Install pip by running:\n' +
+    '         ' + python + ' -m ensurepip --upgrade\n' +
+    '       then re-run:\n' +
+    '         npm install -g repomap-ai'
+  );
+  process.exit(1);
+}
+
+// ─── Install repomap ─────────────────────────────────────────────────────────
+
+const result = spawnSync(
+  pip.split(' ')[0],
+  [...pip.split(' ').slice(1), 'install', '--upgrade', PYPI_PACKAGE],
+  { stdio: 'inherit' }
+);
+
+if (result.status !== 0) {
+  err(
+    'pip install failed. You can install manually with:\n' +
+    '         pip install repomap\n' +
+    '       then re-run your command.'
+  );
+  process.exit(result.status || 1);
+}
+
+log('repomap installed successfully! Run: repomap generate .');

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "repomap-ai",
+  "version": "0.1.0",
+  "description": "Token-efficient repository mapping tool for AI IDEs. Thin npm wrapper around the Python repomap package.",
+  "keywords": [
+    "repomap",
+    "ai",
+    "llm",
+    "mcp",
+    "code-analysis",
+    "tree-sitter",
+    "context",
+    "cursor",
+    "vscode"
+  ],
+  "author": "tushar22",
+  "license": "MIT",
+  "homepage": "https://github.com/tushar22/repomap#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tushar22/repomap.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tushar22/repomap/issues"
+  },
+  "bin": {
+    "repomap": "bin/repomap.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "files": [
+    "bin/",
+    "install.js",
+    "README.md"
+  ]
+}