memtrace 0.3.55 → 0.3.56

package/install.js

@@ -33,6 +33,11 @@ function getBinaryPath() {
   }
   const ext = os.platform() === "win32" ? ".exe" : "";
   const binaryName = `memtrace${ext}`;
+  try {
+    return require.resolve(`${pkg}/bin/${binaryName}`);
+  } catch {
+    selfHealPlatformPackage();
+  }
   try {
     return require.resolve(`${pkg}/bin/${binaryName}`);
   } catch {
@@ -43,6 +48,27 @@ function getBinaryPath() {
   }
 }
 
+function buildSelfHealInstallArgs(packageDir, versioned) {
+  return ["install", "--prefix", packageDir, "--no-save", "--include=optional", versioned];
+}
+
+function buildSelfHealEnv(env) {
+  const next = { ...env };
+
+  // During `npm install -g memtrace`, npm exposes global-mode config through
+  // the environment. A nested `npm install` can inherit that and install the
+  // platform package into the global prefix instead of this package directory.
+  delete next.npm_config_global;
+  delete next.NPM_CONFIG_GLOBAL;
+  next.npm_config_global = "false";
+
+  return next;
+}
+
+function getPinnedPlatformVersion(packageJson, platformPackage) {
+  return packageJson.optionalDependencies?.[platformPackage] ?? packageJson.version;
+}
+
 // ── Optional-dep self-heal ───────────────────────────────────────────────────
 //
 // `optionalDependencies` is supposed to fan out platform binaries
@@ -57,15 +83,15 @@ function getBinaryPath() {
 function selfHealPlatformPackage() {
   const key = getPlatformKey();
   const pkg = PLATFORM_MAP[key];
-  if (!pkg) return; // unsupported platform — getBinaryPath will surface it later
+  if (!pkg) return false; // unsupported platform — getBinaryPath will surface it later
   try {
     require.resolve(`${pkg}/package.json`);
-    return; // already installed via optionalDependencies
+    return true; // already installed via optionalDependencies
   } catch (_) {
     // not installed — fall through to install
   }
   const ourPkg = require("./package.json");
-  const versioned = `${pkg}@${ourPkg.version}`;
+  const versioned = `${pkg}@${getPinnedPlatformVersion(ourPkg, pkg)}`;
   console.log(
     `memtrace: optional platform dep ${pkg} was not installed; ` +
     `running 'npm install ${versioned}' to fetch it…`
@@ -78,11 +104,11 @@ function selfHealPlatformPackage() {
   // `test/spawn-helper.test.js` for the full regression coverage.
   const result = spawnSync(
     platformBinary("npm", process.platform),
-    ["install", "--no-save", versioned],
+    buildSelfHealInstallArgs(__dirname, versioned),
     spawnOptionsForPlatform(process.platform, {
       cwd: __dirname,
       stdio: "inherit",
-      env: process.env,
+      env: buildSelfHealEnv(process.env),
     })
   );
   if (result.status !== 0) {
@@ -90,7 +116,9 @@ function selfHealPlatformPackage() {
       `memtrace: self-heal install of ${versioned} failed (exit ${result.status}). ` +
       `Run manually: npm install -g memtrace --include=optional`
     );
+    return false;
   }
+  return true;
 }
 
 // ── Main postinstall ─────────────────────────────────────────────────────────
@@ -176,4 +204,10 @@ if (require.main === module) {
   }
 }
 
-module.exports = { getBinaryPath };
+module.exports = {
+  getBinaryPath,
+  selfHealPlatformPackage,
+  buildSelfHealEnv,
+  buildSelfHealInstallArgs,
+  getPinnedPlatformVersion,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memtrace",
-  "version": "0.3.55",
+  "version": "0.3.56",
   "description": "Code intelligence graph — MCP server + AI agent skills + visualization UI",
   "keywords": [
     "mcp",