@code-abyss/cli 0.3.0

package/README.md

@@ -0,0 +1,25 @@
+# @code-abyss/cli
+
+**abyss** — the code graph your agent checks before it edits.
+
+npm wrapper that downloads the prebuilt `abyss` binary from
+[GitHub Releases](https://github.com/telagod/abyss/releases) on install
+(Node 18+ fetch + system tar, zero npm dependencies).
+
+```sh
+npm install -g @code-abyss/cli
+abyss index          # build the code graph (~150ms on a 100-file repo)
+abyss context <file> # callers / dependencies / hotspot before you edit
+abyss mcp            # MCP server (8 tools) over stdio
+```
+
+- Call-graph resolution: 97.2% gated precision vs SCIP ground truth (gin corpus)
+- Languages: Rust, Go, TypeScript, JavaScript, Python, Java, and more
+- Temporal intelligence: hotspot scores and co-change coupling from git history
+- Agent hooks: `abyss hook pre-edit` warns about external callers before edits
+
+Full docs, eval methodology, and source: [telagod/abyss](https://github.com/telagod/abyss).
+
+Prefer cargo? `cargo binstall code-abyss` or `cargo install code-abyss`.
+
+License: Apache-2.0

package/bin/abyss.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+// Shim: forwards to the platform binary downloaded by install.js.
+"use strict";
+
+const path = require("path");
+const { spawnSync, execFileSync } = require("child_process");
+const fs = require("fs");
+
+const bin = path.join(
+  __dirname,
+  process.platform === "win32" ? "abyss-bin.exe" : "abyss-bin"
+);
+
+if (!fs.existsSync(bin)) {
+  // postinstall may have been skipped (--ignore-scripts); fetch lazily.
+  try {
+    execFileSync(process.execPath, [path.join(__dirname, "..", "install.js")], {
+      stdio: ["ignore", "inherit", "inherit"],
+    });
+  } catch {
+    process.exit(1);
+  }
+}
+
+const r = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+process.exit(r.status === null ? 1 : r.status);

package/install.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+// Downloads the prebuilt abyss binary for this platform from GitHub Releases.
+// Zero npm dependencies: node fetch + system tar (bsdtar on Windows handles .zip).
+"use strict";
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { execFileSync } = require("child_process");
+
+const VERSION = require("./package.json").version;
+const REPO = "telagod/abyss";
+
+function target() {
+  const arch = { x64: "x86_64", arm64: "aarch64" }[process.arch];
+  if (!arch) return null;
+  switch (process.platform) {
+    case "linux":
+      return `${arch}-unknown-linux-gnu`;
+    case "darwin":
+      return `${arch}-apple-darwin`;
+    case "win32":
+      return arch === "x86_64" ? "x86_64-pc-windows-msvc" : null;
+    default:
+      return null;
+  }
+}
+
+function assetName(t) {
+  return process.platform === "win32" ? `abyss-${t}.zip` : `abyss-${t}.tar.gz`;
+}
+
+function binPath() {
+  return path.join(
+    __dirname,
+    "bin",
+    process.platform === "win32" ? "abyss-bin.exe" : "abyss-bin"
+  );
+}
+
+async function main() {
+  const t = target();
+  if (!t) {
+    console.error(
+      `[abyss] unsupported platform: ${process.platform}/${process.arch} — ` +
+        `build from source: https://github.com/${REPO}#install`
+    );
+    process.exit(1);
+  }
+
+  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${assetName(t)}`;
+  console.error(`[abyss] downloading ${url}`);
+
+  const res = await fetch(url, { redirect: "follow" });
+  if (!res.ok) {
+    console.error(
+      `[abyss] download failed (HTTP ${res.status}). ` +
+        `Try: curl -fsSL https://raw.githubusercontent.com/${REPO}/main/install.sh | bash`
+    );
+    process.exit(1);
+  }
+
+  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "abyss-"));
+  const archive = path.join(tmp, assetName(t));
+  fs.writeFileSync(archive, Buffer.from(await res.arrayBuffer()));
+
+  // bsdtar (bundled with Windows 10+) extracts both .tar.gz and .zip
+  execFileSync("tar", ["-xf", archive, "-C", tmp]);
+
+  const extracted = path.join(
+    tmp,
+    process.platform === "win32" ? "abyss.exe" : "abyss"
+  );
+  fs.mkdirSync(path.dirname(binPath()), { recursive: true });
+  fs.copyFileSync(extracted, binPath());
+  fs.chmodSync(binPath(), 0o755);
+  fs.rmSync(tmp, { recursive: true, force: true });
+
+  console.error(`[abyss] installed ${binPath()}`);
+}
+
+main().catch((e) => {
+  console.error(`[abyss] install failed: ${e.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@code-abyss/cli",
+  "version": "0.3.0",
+  "description": "abyss — the code graph your agent checks before it edits. npm wrapper that downloads the prebuilt binary.",
+  "bin": {
+    "abyss": "bin/abyss.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "files": [
+    "bin/abyss.js",
+    "install.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/telagod/abyss.git"
+  },
+  "homepage": "https://github.com/telagod/abyss#readme",
+  "license": "Apache-2.0",
+  "keywords": [
+    "code-index",
+    "call-graph",
+    "mcp",
+    "agent",
+    "tree-sitter"
+  ]
+}