basemind 0.0.1

package/README.md

@@ -0,0 +1,55 @@
+# basemind
+
+**Give your AI coding agent a brain for your repo.**
+
+basemind is a code-map MCP server: it indexes your codebase into a queryable map
+so AI coding agents — Claude Code, Cursor, Continue, anything that speaks
+[MCP](https://modelcontextprotocol.io) — get instant semantic answers about your
+code. Where is this defined? Who calls it? When did it change? What's churning?
+
+Sub-millisecond queries. 300+ languages out of the box. Local-only. Built in Rust.
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/Goldziher/basemind/blob/main/LICENSE)
+[![npm](https://img.shields.io/npm/v/basemind.svg)](https://www.npmjs.com/package/basemind)
+
+## Install
+
+```bash
+npm install -g basemind
+```
+
+The installer downloads the appropriate pre-compiled Rust binary for your
+platform (macOS, Linux, Windows; x86_64 + arm64) from
+[GitHub Releases](https://github.com/Goldziher/basemind/releases) on first
+install.
+
+## Quickstart
+
+```bash
+cd /path/to/your/repo
+basemind scan        # index the working tree
+basemind serve       # run the MCP stdio server
+```
+
+Wire `basemind serve` into Claude Code (`~/.claude.json`) or any MCP client:
+
+```json
+{
+  "mcpServers": {
+    "basemind": {
+      "command": "basemind",
+      "args": ["serve"],
+      "cwd": "/abs/path/to/your/repo"
+    }
+  }
+}
+```
+
+## Documentation
+
+Full docs, architecture, and the complete MCP tool table at
+[github.com/Goldziher/basemind](https://github.com/Goldziher/basemind).
+
+## License
+
+[MIT](https://github.com/Goldziher/basemind/blob/main/LICENSE).

package/index.js

@@ -0,0 +1,8 @@
+const path = require("node:path");
+const os = require("node:os");
+
+const binaryName = os.type() === "Windows_NT" ? "basemind.exe" : "basemind";
+
+module.exports = {
+  binaryPath: path.join(__dirname, "bin", binaryName),
+};

package/install.js

@@ -0,0 +1,143 @@
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const https = require("node:https");
+const http = require("node:http");
+const tar = require("tar");
+const AdmZip = require("adm-zip");
+
+const { version } = require("./package.json");
+
+function getPlatformTriple() {
+  const type = os.type();
+  const arch = os.arch();
+
+  if (type === "Windows_NT") {
+    if (arch === "x64") return "x86_64-pc-windows-gnu";
+    if (arch === "ia32") throw new Error("32-bit Windows is not supported");
+  }
+
+  if (type === "Linux") {
+    if (arch === "x64") return "x86_64-unknown-linux-gnu";
+    if (arch === "arm64") return "aarch64-unknown-linux-gnu";
+    return "x86_64-unknown-linux-gnu";
+  }
+
+  if (type === "Darwin") {
+    if (arch === "x64") return "x86_64-apple-darwin";
+    if (arch === "arm64") return "aarch64-apple-darwin";
+    return "x86_64-apple-darwin";
+  }
+
+  throw new Error(`Unsupported platform: ${type} ${arch}`);
+}
+
+function getBinaryUrl() {
+  const platform = getPlatformTriple();
+  const baseUrl = `https://github.com/Goldziher/basemind/releases/download/v${version}`;
+  const ext = platform.includes("windows") ? "zip" : "tar.gz";
+  return `${baseUrl}/basemind-${platform}.${ext}`;
+}
+
+function downloadWithRedirects(url, dest, maxRedirects = 5) {
+  return new Promise((resolve, reject) => {
+    if (maxRedirects <= 0) {
+      return reject(new Error("Too many redirects"));
+    }
+
+    const urlObj = new URL(url);
+    const client = urlObj.protocol === "https:" ? https : http;
+
+    const req = client.get(
+      url,
+      {
+        headers: {
+          "User-Agent": "basemind-npm-wrapper",
+        },
+      },
+      (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          return downloadWithRedirects(res.headers.location, dest, maxRedirects - 1)
+            .then(resolve)
+            .catch(reject);
+        }
+
+        if (res.statusCode !== 200) {
+          return reject(new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`));
+        }
+
+        const file = fs.createWriteStream(dest);
+        res.pipe(file);
+
+        file.on("finish", () => {
+          file.close();
+          resolve();
+        });
+
+        file.on("error", (err) => {
+          fs.unlink(dest, () => {});
+          reject(err);
+        });
+      },
+    );
+
+    req.on("error", reject);
+    req.setTimeout(30000, () => {
+      req.destroy();
+      reject(new Error("Download timeout"));
+    });
+  });
+}
+
+async function installBinary() {
+  try {
+    const url = getBinaryUrl();
+    const isZip = url.endsWith(".zip");
+    const binDir = path.join(__dirname, "bin");
+    const archivePath = path.join(binDir, isZip ? "basemind.zip" : "basemind.tar.gz");
+    const binaryName = os.type() === "Windows_NT" ? "basemind.exe" : "basemind";
+    const binaryPath = path.join(binDir, binaryName);
+
+    if (!fs.existsSync(binDir)) {
+      fs.mkdirSync(binDir, { recursive: true });
+    }
+
+    if (fs.existsSync(binaryPath)) {
+      return;
+    }
+
+    console.log(`Downloading basemind binary from ${url}...`);
+
+    await downloadWithRedirects(url, archivePath);
+
+    console.log("Extracting binary...");
+
+    if (isZip) {
+      const zip = new AdmZip(archivePath);
+      const entry = zip.getEntries().find((e) => e.entryName.endsWith(binaryName));
+      if (!entry) {
+        throw new Error("Binary not found in downloaded archive");
+      }
+      zip.extractEntryTo(entry, binDir, false, true);
+    } else {
+      await tar.extract({
+        file: archivePath,
+        cwd: binDir,
+        filter: (entryPath) => entryPath.endsWith(binaryName),
+      });
+    }
+
+    fs.unlinkSync(archivePath);
+
+    if (os.type() !== "Windows_NT") {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    console.log("basemind binary installed successfully!");
+  } catch (error) {
+    console.error("Error installing basemind binary:", error.message);
+    process.exit(1);
+  }
+}
+
+installBinary();

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "basemind",
+  "version": "0.0.1",
+  "description": "Code-map MCP server + scanner — content-addressed, Fjall-backed inverted index over tree-sitter outlines",
+  "main": "index.js",
+  "bin": {
+    "basemind": "bin/basemind"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "keywords": [
+    "mcp",
+    "tree-sitter",
+    "code-map",
+    "scanner",
+    "indexer",
+    "basemind"
+  ],
+  "author": "Na'aman Hirschfeld",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Goldziher/basemind.git"
+  },
+  "homepage": "https://github.com/Goldziher/basemind#readme",
+  "bugs": {
+    "url": "https://github.com/Goldziher/basemind/issues"
+  },
+  "dependencies": {
+    "adm-zip": "^0.5.12",
+    "tar": "^6.0.0"
+  },
+  "files": [
+    "index.js",
+    "install.js",
+    "bin/"
+  ],
+  "engines": {
+    "node": ">=14"
+  }
+}