@sansavision/atlas 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# atlas-context
+
+> Atlas Context Engine — MCP-native context engine for AI coding agents.
+
+This npm package is a thin wrapper around the native `atlas` and `atlas-mcp` binaries.
+The correct binary for your platform is fetched automatically during `npm install`.
+
+## Requirements
+
+- Node.js ≥ 18
+- Internet access during install (binary is downloaded from GitHub Releases)
+
+## Installation
+
+```bash
+npm install -g atlas-context
+# or locally in a project
+npm install atlas-context
+```
+
+## CLI usage
+
+```bash
+# Index a repository
+atlas index /path/to/repo
+
+# Start the MCP server (stdio transport)
+atlas-mcp
+
+# Start the MCP server (HTTP transport on port 8080)
+atlas-mcp --port 8080
+
+# Run full help
+atlas --help
+atlas-mcp --help
+```
+
+## Programmatic usage (Node.js)
+
+```js
+const { startMcpServer } = require('atlas-context');
+
+// Spawn atlas-mcp in the current working directory
+const server = startMcpServer(['--port', '8080']);
+server.on('close', (code) => console.log(`atlas-mcp exited with code ${code}`));
+```
+
+## Supported platforms
+
+| Platform         | Target triple                   |
+|------------------|---------------------------------|
+| Linux x86_64     | `x86_64-unknown-linux-musl`     |
+| macOS arm64      | `aarch64-apple-darwin`          |
+| macOS x86_64     | `x86_64-apple-darwin`           |
+| Windows x86_64   | `x86_64-pc-windows-msvc`        |
+
+## Building from source
+
+See the [main repository](https://github.com/atlas-context/atlas#building) for
+Rust build instructions.
+
+## License
+
+MIT

package/bin/atlas-mcp.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+// bin/atlas-mcp.js — thin shim: exec the native atlas-mcp binary (MCP server).
+
+"use strict";
+
+const { spawnSync } = require("child_process");
+const os = require("os");
+const path = require("path");
+const fs = require("fs");
+
+const name = os.platform() === "win32" ? "atlas-mcp.exe" : "atlas-mcp";
+const binary = path.join(__dirname, name);
+
+if (!fs.existsSync(binary)) {
+  console.error(
+    "atlas-mcp: native binary not found.\n" +
+      "Try reinstalling: npm install atlas-context\n" +
+      "Or build from source: https://github.com/atlas-context/atlas#building",
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+
+if (result.error) {
+  console.error("atlas-mcp: failed to launch binary:", result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 0);

package/bin/atlas.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+// bin/atlas.js — thin shim: exec the native atlas binary.
+
+"use strict";
+
+const { spawnSync } = require("child_process");
+const os = require("os");
+const path = require("path");
+const fs = require("fs");
+
+const name = os.platform() === "win32" ? "atlas.exe" : "atlas";
+const binary = path.join(__dirname, name);
+
+if (!fs.existsSync(binary)) {
+  console.error(
+    "atlas: native binary not found.\n" +
+      "Try reinstalling: npm install @sansavision/atlas\n" +
+      "Or build from source: https://github.com/sansavision/atlas#building",
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+
+if (result.error) {
+  console.error("atlas: failed to launch binary:", result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 0);

package/index.js

@@ -0,0 +1,67 @@
+"use strict";
+
+/**
+ * atlas-context — programmatic Node.js interface.
+ *
+ * For most use-cases you only need the CLI binaries (`atlas` / `atlas-mcp`)
+ * that are installed into your PATH.  Import this module when you want to
+ * launch the MCP server from Node code.
+ */
+
+const { spawn } = require("child_process");
+const os = require("os");
+const path = require("path");
+
+/**
+ * Absolute path to the `atlas` CLI binary for the current platform.
+ * Returns null when the binary hasn't been downloaded yet.
+ *
+ * @returns {string|null}
+ */
+function binaryPath() {
+  const name = os.platform() === "win32" ? "atlas.exe" : "atlas";
+  const p = path.join(__dirname, "bin", name);
+  try {
+    require("fs").accessSync(p);
+    return p;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Absolute path to the `atlas-mcp` MCP server binary.
+ * Returns null when the binary hasn't been downloaded yet.
+ *
+ * @returns {string|null}
+ */
+function mcpBinaryPath() {
+  const name = os.platform() === "win32" ? "atlas-mcp.exe" : "atlas-mcp";
+  const p = path.join(__dirname, "bin", name);
+  try {
+    require("fs").accessSync(p);
+    return p;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Launch the `atlas-mcp` MCP server and return the child process.
+ *
+ * @param {string[]} [args]  Extra CLI arguments (e.g. ['--port', '8080'])
+ * @param {object}   [opts]  Options forwarded to `child_process.spawn`
+ * @returns {import('child_process').ChildProcess}
+ */
+function startMcpServer(args = [], opts = {}) {
+  const bin = mcpBinaryPath();
+  if (!bin) {
+    throw new Error(
+      "atlas-mcp binary not found. " +
+        "Reinstall the package to trigger the download: npm install atlas-context",
+    );
+  }
+  return spawn(bin, args, { stdio: "inherit", ...opts });
+}
+
+module.exports = { binaryPath, mcpBinaryPath, startMcpServer };

package/install.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+// postinstall — download the correct Atlas binary for the current platform.
+
+"use strict";
+
+const os = require("os");
+const fs = require("fs");
+const path = require("path");
+const https = require("https");
+const { execFileSync } = require("child_process");
+
+// ── Platform detection ───────────────────────────────────────────────────────
+
+/** Map Node's (platform, arch) to the Rust target triple used in release archives. */
+function detectTarget() {
+  const p = os.platform();
+  const a = os.arch();
+
+  if (p === "linux" && a === "x64") return "x86_64-unknown-linux-musl";
+  if (p === "darwin" && a === "arm64") return "aarch64-apple-darwin";
+  if (p === "darwin" && a === "x64") return "x86_64-apple-darwin";
+  if (p === "win32" && a === "x64") return "x86_64-pc-windows-msvc";
+
+  throw new Error(
+    `Unsupported platform: ${p}/${a}. ` +
+      "See https://github.com/atlas-context/atlas for build-from-source instructions.",
+  );
+}
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+function downloadTo(url, destPath) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(destPath);
+
+    function get(u) {
+      https
+        .get(u, (res) => {
+          if (res.statusCode === 301 || res.statusCode === 302) {
+            return get(res.headers.location);
+          }
+          if (res.statusCode !== 200) {
+            return reject(new Error(`HTTP ${res.statusCode} downloading ${u}`));
+          }
+          res.pipe(file);
+          file.on("finish", () => file.close(resolve));
+        })
+        .on("error", reject);
+    }
+
+    get(url);
+  });
+}
+
+async function extractArchive(archivePath, destDir) {
+  if (archivePath.endsWith(".tar.gz")) {
+    // Use the system tar — available on Linux, macOS, and Windows 10+
+    execFileSync(
+      "tar",
+      ["xzf", archivePath, "-C", destDir, "atlas", "atlas-mcp"],
+      { stdio: "inherit" },
+    );
+  } else if (archivePath.endsWith(".zip")) {
+    // Node 18+ has a built-in unzip via child process; fall back to PowerShell
+    execFileSync(
+      "powershell",
+      [
+        "-NoProfile",
+        "-Command",
+        `Expand-Archive -Path "${archivePath}" -DestinationPath "${destDir}" -Force`,
+      ],
+      { stdio: "inherit" },
+    );
+  } else {
+    throw new Error(`Unknown archive format: ${archivePath}`);
+  }
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const pkg = require("./package.json");
+  const version = pkg.version;
+  const target = detectTarget();
+  const isWindows = os.platform() === "win32";
+  const ext = isWindows ? ".zip" : ".tar.gz";
+
+  const archiveName = `atlas-v${version}-${target}${ext}`;
+  const downloadUrl = `https://github.com/sansavision/atlas/releases/download/v${version}/${archiveName}`;
+
+  const binDir = path.join(__dirname, "bin");
+  fs.mkdirSync(binDir, { recursive: true });
+
+  const tmpArchive = path.join(os.tmpdir(), archiveName);
+
+  console.log(`atlas-context: downloading ${archiveName}…`);
+
+  try {
+    await downloadTo(downloadUrl, tmpArchive);
+    await extractArchive(tmpArchive, binDir);
+    fs.rmSync(tmpArchive, { force: true });
+
+    // Make binaries executable on POSIX
+    if (!isWindows) {
+      fs.chmodSync(path.join(binDir, "atlas"), 0o755);
+      fs.chmodSync(path.join(binDir, "atlas-mcp"), 0o755);
+    }
+
+    console.log("atlas-context: binaries installed successfully.");
+  } catch (err) {
+    // Non-fatal: user can still build from source
+    console.warn(`atlas-context: binary download failed — ${err.message}`);
+    console.warn(
+      "You can build from source: https://github.com/sansavision/atlas#building",
+    );
+    process.exit(0); // Don't fail `npm install`
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,43 @@
+{
+    "name": "@sansavision/atlas",
+    "version": "0.1.0",
+    "description": "Atlas Context Engine — MCP-native context engine for AI coding agents",
+    "private": false,
+    "publishConfig": {
+        "access": "restricted",
+        "registry": "https://registry.npmjs.org"
+    },
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "ai",
+        "context",
+        "coding-agent",
+        "llm"
+    ],
+    "homepage": "https://github.com/sansavision/atlas",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/sansavision/atlas.git"
+    },
+    "bugs": {
+        "url": "https://github.com/sansavision/atlas/issues"
+    },
+    "license": "MIT",
+    "engines": {
+        "node": ">=18"
+    },
+    "bin": {
+        "atlas": "./bin/atlas.js",
+        "atlas-mcp": "./bin/atlas-mcp.js"
+    },
+    "scripts": {
+        "postinstall": "node install.js"
+    },
+    "files": [
+        "install.js",
+        "bin/",
+        "index.js",
+        "README.md"
+    ]
+}