heides 0.13.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AbduljabbarBXR
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# heides (npm installer)
+
+Installs the prebuilt [HEIDES](https://github.com/AbduljabbarBXR/heides) binary for your platform and exposes the `heides` command. HEIDES is a deterministic code analysis harness that gives AI agents senses, memory and judgment for code.
+
+```bash
+npm install -g heides
+heides --help
+```
+
+On install, the matching binary is downloaded from GitHub Releases into the package `bin/` folder. No Rust toolchain needed.
+
+## Supported platforms
+
+| OS | Arch | Asset |
+|----|------|-------|
+| Linux (glibc) | x64 | `heides-x86_64-unknown-linux-gnu` |
+| macOS | arm64 | `heides-aarch64-apple-darwin` |
+| macOS | x64 | `heides-x86_64-apple-darwin` |
+| Windows | x64 | `heides-x86_64-pc-windows-msvc.exe` |
+
+Not listed, e.g. Linux arm64, Android, or musl/Alpine: the installer stops with a clear error. Install from source instead (`cargo install heides`) or pick a build from the [releases page](https://github.com/AbduljabbarBXR/heides/releases).
+
+## Usage
+
+Same as the native binary:
+
+```bash
+heides scan .
+heides check .
+heides mcp   # MCP server over stdio for agents
+```
+
+## Versions
+
+npm package version tracks the HEIDES release version. `heides@0.13.1` installs HEIDES 0.13.1.
+
+## Uninstall
+
+```bash
+npm uninstall -g heides
+```
+
+## License
+
+MIT. See [LICENSE](./LICENSE). Binary builds follow the [HEIDES repo license](https://github.com/AbduljabbarBXR/heides).

package/bin/heides.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/* heides launcher. Runs the platform binary downloaded by postinstall. */
+"use strict";
+
+const { spawnSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+
+function binaryPath() {
+  const exe = process.platform === "win32" ? "heides.exe" : "heides";
+  return path.join(__dirname, exe);
+}
+
+function main() {
+  const bin = binaryPath();
+  if (!fs.existsSync(bin)) {
+    console.error("heides: binary not found. Reinstall with: npm install -g heides");
+    process.exit(1);
+  }
+  const result = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+  if (result.error) {
+    console.error(`heides: could not run the binary (${result.error.message}).`);
+    console.error("Your platform may need a different build:");
+    console.error("https://github.com/AbduljabbarBXR/heides/releases");
+    process.exit(1);
+  }
+  process.exit(result.status === null ? 1 : result.status);
+}
+
+if (require.main === module) main();
+
+module.exports = { binaryPath };

package/install.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/*
+ * heides npm installer.
+ * Downloads the prebuilt HEIDES binary for the current platform from
+ * GitHub Releases into ./bin/ next to the launcher.
+ */
+"use strict";
+
+const fs = require("fs");
+const https = require("https");
+const os = require("os");
+const path = require("path");
+
+const VERSION = require("./package.json").version;
+const REPO = "AbduljabbarBXR/heides";
+const BIN_NAME = "heides";
+
+const ASSETS = {
+  "linux-x64": "heides-x86_64-unknown-linux-gnu",
+  "darwin-arm64": "heides-aarch64-apple-darwin",
+  "darwin-x64": "heides-x86_64-apple-darwin",
+  "win32-x64": "heides-x86_64-pc-windows-msvc.exe",
+};
+
+function currentKey() {
+  if (process.env.HEIDES_TEST_PLATFORM) return process.env.HEIDES_TEST_PLATFORM;
+  return `${process.platform}-${process.arch}`;
+}
+
+function assetFor(key) {
+  return ASSETS[key] || null;
+}
+
+function exeName() {
+  return process.platform === "win32" ? `${BIN_NAME}.exe` : BIN_NAME;
+}
+
+function isMusl() {
+  try {
+    if (fs.existsSync("/etc/alpine-release")) return true;
+    const osRelease = fs.readFileSync("/etc/os-release", "utf8");
+    return /(^|\n)ID_LIKE=.*musl/.test(osRelease) || /(^|\n)ID=alpine/.test(osRelease);
+  } catch {
+    return false;
+  }
+}
+
+function download(url, dest, redirects = 5) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, { headers: { "User-Agent": "heides-npm-installer" } }, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          if (redirects === 0) return reject(new Error("too many redirects"));
+          res.resume();
+          return resolve(download(res.headers.location, dest, redirects - 1));
+        }
+        if (res.statusCode !== 200) {
+          res.resume();
+          return reject(new Error(`download failed: HTTP ${res.statusCode} for ${url}`));
+        }
+        const out = fs.createWriteStream(dest, { mode: 0o755 });
+        res.pipe(out);
+        out.on("finish", () => resolve());
+        out.on("error", reject);
+      })
+      .on("error", reject);
+  });
+}
+
+async function main() {
+  const key = currentKey();
+  const asset = assetFor(key);
+  if (!asset) {
+    console.error(`heides: no prebuilt binary for ${process.platform}-${process.arch}.`);
+    console.error("Install from source instead: cargo install heides");
+    console.error(`Or pick a build manually: https://github.com/${REPO}/releases`);
+    process.exit(1);
+  }
+  if (process.platform === "linux" && isMusl()) {
+    console.error("heides: prebuilt binaries are glibc linked and will not run on musl (Alpine).");
+    console.error("Install from source instead: cargo install heides");
+    process.exit(1);
+  }
+  const binDir = path.join(__dirname, "bin");
+  fs.mkdirSync(binDir, { recursive: true });
+  const dest = path.join(binDir, exeName());
+  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${asset}`;
+  console.log(`heides: downloading ${asset} ...`);
+  await download(url, dest);
+  if (process.platform !== "win32") fs.chmodSync(dest, 0o755);
+  console.log(`heides: installed ${dest}`);
+}
+
+if (require.main === module) {
+  main().catch((err) => {
+    console.error(`heides install failed: ${err.message}`);
+    process.exit(1);
+  });
+}
+
+module.exports = { assetFor, currentKey, exeName, isMusl, VERSION };

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "heides",
+  "version": "0.13.1",
+  "description": "HEIDES installer. Downloads the prebuilt HEIDES binary for your platform and exposes the heides command. Deterministic code analysis harness for AI agents.",
+  "bin": {
+    "heides": "bin/heides.js"
+  },
+  "scripts": {
+    "postinstall": "node ./install.js",
+    "test": "node ./test.js"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "heides",
+    "code-analysis",
+    "static-analysis",
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "cli",
+    "binary"
+  ],
+  "author": "AbduljabbarBXR",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AbduljabbarBXR/heides.git",
+    "directory": "npm"
+  },
+  "homepage": "https://github.com/AbduljabbarBXR/heides#readme",
+  "bugs": {
+    "url": "https://github.com/AbduljabbarBXR/heides/issues"
+  },
+  "files": [
+    "bin/",
+    "install.js",
+    "test.js",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/test.js

@@ -0,0 +1,14 @@
+"use strict";
+// Unit tests for the installer mapping. No dependencies. Run: npm test
+const assert = require("assert");
+const { assetFor } = require("./install.js");
+
+assert.strictEqual(assetFor("linux-x64"), "heides-x86_64-unknown-linux-gnu");
+assert.strictEqual(assetFor("darwin-arm64"), "heides-aarch64-apple-darwin");
+assert.strictEqual(assetFor("darwin-x64"), "heides-x86_64-apple-darwin");
+assert.strictEqual(assetFor("win32-x64"), "heides-x86_64-pc-windows-msvc.exe");
+assert.strictEqual(assetFor("linux-arm64"), null);
+assert.strictEqual(assetFor("android-arm64"), null);
+assert.strictEqual(assetFor("freebsd-x64"), null);
+
+console.log("heides installer mapping: 7/7 ok");