@gramatr/mcp 0.8.0 → 0.8.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gramatr/mcp",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "grāmatr — Intelligence middleware for AI agents. Pre-classifies every request, injects relevant memory and behavioral context, enforces data quality, and maintains session continuity across Claude, ChatGPT, Codex, Cursor, Gemini, and any MCP-compatible client.",
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {
@@ -45,6 +45,7 @@
   },
   "files": [
     "dist",
+    "scripts/postinstall.mjs",
     "LICENSE"
   ],
   "dependencies": {
@@ -58,6 +59,7 @@
     "vitest": "^4.0.18"
   },
   "scripts": {
+    "postinstall": "node scripts/postinstall.mjs",
     "build": "tsc --build && node ./scripts/build-binary.mjs",
     "build:types": "tsc --build",
     "build:binary": "bun build --compile src/bin/gramatr-mcp.ts --define __GRAMATR_VERSION__=\\\"${npm_package_version}\\\" --outfile dist/gramatr",

package/scripts/postinstall.mjs

@@ -0,0 +1,115 @@
+/**
+ * postinstall.mjs — Auto-download the pre-compiled gramatr binary for the user's platform.
+ *
+ * Runs on `npm install @gramatr/client`. Detects platform + arch, downloads
+ * the matching binary from the GitHub Release, and installs it to
+ * ~/.gramatr/bin/gramatr.
+ *
+ * Design constraints:
+ *   - Pure Node.js (no external dependencies, no bun)
+ *   - Node 18+ (native fetch)
+ *   - Graceful failure: logs a warning but always exits 0
+ *   - ISC-A: npm install must not fail if GitHub is unreachable
+ */
+
+import { createWriteStream } from "node:fs";
+import { chmod, mkdir, rename, unlink } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { pipeline } from "node:stream/promises";
+import { Readable } from "node:stream";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+
+// Download from the PUBLIC repo (gramatr/mcp), not the private monorepo (gramatr/gramatr).
+const GITHUB_RELEASE_BASE =
+  "https://github.com/gramatr/mcp/releases/download";
+
+/** Map (platform, arch) to the binary asset name. */
+function getBinaryName(platform, arch) {
+  const map = {
+    "linux-x64": "gramatr-linux-x64",
+    "linux-arm64": "gramatr-linux-arm64",
+    "darwin-x64": "gramatr-darwin-x64",
+    "darwin-arm64": "gramatr-darwin-arm64",
+    "win32-x64": "gramatr-windows-x64.exe",
+  };
+
+  const key = `${platform}-${arch}`;
+  return map[key] ?? null;
+}
+
+/** Read version from the package's own package.json. */
+function getVersion() {
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  const require = createRequire(import.meta.url);
+  const pkg = require(join(__dirname, "..", "package.json"));
+  return pkg.version;
+}
+
+/** Download a file from `url` to `dest`, following redirects (fetch handles them). */
+async function downloadBinary(url, dest) {
+  const response = await fetch(url, { redirect: "follow" });
+
+  if (!response.ok) {
+    throw new Error(
+      `Download failed: HTTP ${response.status} ${response.statusText}`,
+    );
+  }
+
+  const tempDest = `${dest}.tmp`;
+  const body = Readable.fromWeb(response.body);
+  const fileStream = createWriteStream(tempDest);
+
+  try {
+    await pipeline(body, fileStream);
+    await rename(tempDest, dest);
+  } catch (err) {
+    // Clean up partial download
+    await unlink(tempDest).catch(() => {});
+    throw err;
+  }
+}
+
+async function main() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  const binaryName = getBinaryName(platform, arch);
+  if (!binaryName) {
+    console.warn(
+      `[gramatr] Unsupported platform: ${platform}-${arch}. ` +
+        "Skipping binary download. You can install manually from " +
+        "https://github.com/gramatr/gramatr/releases",
+    );
+    return;
+  }
+
+  const version = getVersion();
+  const url = `${GITHUB_RELEASE_BASE}/v${version}/${binaryName}`;
+
+  const installDir = join(homedir(), ".gramatr", "bin");
+  const isWindows = platform === "win32";
+  const installPath = join(installDir, isWindows ? "gramatr.exe" : "gramatr");
+
+  console.log(`[gramatr] Downloading ${binaryName} v${version}...`);
+
+  await mkdir(installDir, { recursive: true });
+  await downloadBinary(url, installPath);
+
+  if (!isWindows) {
+    await chmod(installPath, 0o755);
+  }
+
+  console.log(`[gramatr] Installed to ${installPath}`);
+}
+
+main().catch((err) => {
+  console.warn(
+    `[gramatr] Binary download failed: ${err.message}. ` +
+      "This is non-fatal — you can install manually from " +
+      "https://github.com/gramatr/gramatr/releases",
+  );
+  // Always exit 0 — never break npm install
+  process.exit(0);
+});