tessera-codegraph 0.0.0-stage → 1.2.0

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# tessera-codegraph
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The npm distribution of [Tessera](https://github.com/iamsaquib8/tessera):
+deterministic edit safety for AI coding agents. It installs the prebuilt
+`tessera` binary for your platform. No Rust toolchain or install script is
+needed.
+
+```sh
+npx tessera-codegraph find <symbol>     # one-off
+npm i -g tessera-codegraph               # then: tessera status
+```
+
+## How it works
+
+The `tessera-codegraph` package is a small launcher. The binary ships in one
+optional dependency per platform, and npm installs only the one that matches
+your machine:
+
+| Package | Platform |
+| --- | --- |
+| `tessera-codegraph-darwin-arm64` | macOS, Apple silicon |
+| `tessera-codegraph-darwin-x64` | macOS, Intel |
+| `tessera-codegraph-linux-x64-musl` | Linux x64, any distribution (static) |
+| `tessera-codegraph-linux-arm64-musl` | Linux arm64, any distribution (static) |
+| `tessera-codegraph-win32-x64` | Windows x64 |
+
+Nothing is downloaded at install time, so it works behind proxies and with
+`--ignore-scripts`. If you install with `--omit=optional`, the launcher tells
+you which package is missing.
+
+Other platforms can build from source with `cargo install tessera-codegraph`.
+
+## Maintainers
+
+`.github/workflows/release.yml` publishes these packages after a GitHub release
+is published, using the `NPM_TOKEN` secret.
+`npm/scripts/build-platform-packages.js <version> <archives-dir>` unpacks the
+release archives and stamps the version. Run the tests with
+`node --test npm/test/`.

package/bin/tessera.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawnSync } = require("child_process");
+const { resolveBinary } = require("../lib/resolve");
+
+let bin;
+try {
+  bin = resolveBinary();
+} catch (error) {
+  console.error(`[tessera] ${error.message}`);
+  process.exit(1);
+}
+
+const result = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+if (result.error) {
+  console.error(`[tessera] failed to launch ${bin}: ${result.error.message}`);
+  process.exit(1);
+}
+process.exit(result.status === null ? 1 : result.status);

package/lib/resolve.js

@@ -0,0 +1,43 @@
+"use strict";
+
+const PACKAGES = {
+  "darwin-arm64": "tessera-codegraph-darwin-arm64",
+  "darwin-x64": "tessera-codegraph-darwin-x64",
+  "linux-x64-musl": "tessera-codegraph-linux-x64-musl",
+  "linux-arm64-musl": "tessera-codegraph-linux-arm64-musl",
+  "win32-x64": "tessera-codegraph-win32-x64",
+};
+
+function currentHost() {
+  return { platform: process.platform, arch: process.arch };
+}
+
+// Linux always gets the static musl build: it runs on every distribution,
+// including glibc versions older than the ones release runners link against.
+function platformPackage(host = currentHost()) {
+  let key = `${host.platform}-${host.arch}`;
+  if (host.platform === "linux") key += "-musl";
+  const name = PACKAGES[key];
+  if (!name) {
+    throw new Error(
+      `no prebuilt tessera binary for ${host.platform}/${host.arch}; ` +
+        "install with `cargo install tessera-codegraph` instead"
+    );
+  }
+  return name;
+}
+
+function resolveBinary(host = currentHost(), resolve = require.resolve) {
+  const name = platformPackage(host);
+  const exe = host.platform === "win32" ? "tessera.exe" : "tessera";
+  try {
+    return resolve(`${name}/bin/${exe}`);
+  } catch (error) {
+    throw new Error(
+      `Install failed: package ${name} is missing. ` +
+        "Reinstall without --no-optional / --omit=optional, or use `cargo install tessera-codegraph`."
+    );
+  }
+}
+
+module.exports = { PACKAGES, platformPackage, resolveBinary };

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "tessera-codegraph",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.2.0",
+  "description": "Deterministic edit safety for AI coding agents: blast radius before an edit, verification after it. Prebuilt tessera binary, no Rust toolchain required.",
+  "bin": {
+    "tessera": "bin/tessera.js"
+  },
+  "files": [
+    "bin/tessera.js",
+    "lib/resolve.js"
+  ],
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "ai-agents",
+    "claude-code",
+    "cursor",
+    "codex",
+    "code-graph",
+    "tree-sitter",
+    "refactoring",
+    "static-analysis"
+  ],
+  "homepage": "https://github.com/iamsaquib8/tessera",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iamsaquib8/tessera.git"
+  },
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "tessera-codegraph-darwin-arm64": "1.2.0",
+    "tessera-codegraph-darwin-x64": "1.2.0",
+    "tessera-codegraph-linux-x64-musl": "1.2.0",
+    "tessera-codegraph-linux-arm64-musl": "1.2.0",
+    "tessera-codegraph-win32-x64": "1.2.0"
+  }
+}