@synsci/openscience 1.3.4 → 1.3.5-test.3.1

package/bin/openscience

@@ -5,7 +5,93 @@ const fs = require("fs")
 const path = require("path")
 const os = require("os")
 
+const MIN_LINUX_KERNEL = { major: 5, minor: 1 }
+
+function parseKernelVersion(release) {
+  const match = /^(\d+)\.(\d+)/.exec(release)
+  if (!match) return undefined
+  return { major: Number(match[1]), minor: Number(match[2]) }
+}
+
+function linuxKernelProblem(platform = os.platform(), release = os.release()) {
+  if (platform !== "linux") return undefined
+  const version = parseKernelVersion(release)
+  if (!version) return undefined
+  if (
+    version.major > MIN_LINUX_KERNEL.major ||
+    (version.major === MIN_LINUX_KERNEL.major && version.minor >= MIN_LINUX_KERNEL.minor)
+  ) {
+    return undefined
+  }
+  return `Linux kernel ${release} is unsupported. OpenScience's bundled runtime requires kernel 5.1 or newer.`
+}
+
+function detectMusl(platform = os.platform()) {
+  if (platform !== "linux") return false
+  try {
+    return fs.readdirSync("/lib").some((entry) => entry.startsWith("ld-musl-"))
+  } catch {
+    return false
+  }
+}
+
+function expectedPlatformPackages(platform, arch, musl) {
+  const suffix = musl ? "-musl" : ""
+  const name = `openscience-${platform}-${arch}${suffix}`
+  return [`@synsci/${name}`, name]
+}
+
+function pageSize() {
+  if (os.platform() !== "linux") return undefined
+  const result = childProcess.spawnSync("getconf", ["PAGESIZE"], { encoding: "utf8" })
+  return result.status === 0 ? result.stdout.trim() || undefined : undefined
+}
+
+function linuxArm64PageSizeProblem(platform, arch, detectedPageSize) {
+  if (platform !== "linux" || arch !== "arm64" || detectedPageSize === undefined) return undefined
+  const bytes = Number.parseInt(String(detectedPageSize), 10)
+  if (!Number.isFinite(bytes) || bytes === 4096) return undefined
+  return [
+    `Linux ARM64 page size ${bytes} is unsupported by OpenScience's Bun-compiled executable.`,
+    "Use a kernel or VM configured with 4 KB pages.",
+    "Upstream status: https://github.com/oven-sh/bun/issues/17627",
+  ].join(" ")
+}
+
+function runtimeDescription(platform, arch, musl) {
+  const details = [`${platform}-${arch}`]
+  if (platform === "linux") {
+    details.push(musl ? "musl" : "glibc", `kernel ${os.release()}`)
+    const detectedPageSize = pageSize()
+    if (detectedPageSize) details.push(`page size ${detectedPageSize}`)
+  }
+  details.push(`node ${process.version}`)
+  return details.join(", ")
+}
+
+function exitCodeForResult(result) {
+  if (typeof result.status === "number") return result.status
+  if (result.signal) return 128 + (os.constants.signals[result.signal] || 0)
+  return 1
+}
+
 function run(target) {
+  const kernelProblem = linuxKernelProblem()
+  if (kernelProblem) {
+    console.error(kernelProblem)
+    console.error(
+      "Upgrade the host kernel or run OpenScience on a newer VM. CentOS 7's stock 3.10 kernel is not supported.",
+    )
+    process.exit(1)
+  }
+
+  const pageSizeProblem = linuxArm64PageSizeProblem(os.platform(), os.arch(), pageSize())
+  if (pageSizeProblem) {
+    console.error(pageSizeProblem)
+    console.error(`Detected runtime: ${runtimeDescription(os.platform(), os.arch(), detectMusl())}`)
+    process.exit(1)
+  }
+
   // Clean up files that confuse Bun compiled binaries.
   // Install dir stays as ~/.openscience/ until the path-migration follow-up PR.
   const openscienceDir = path.join(os.homedir(), ".openscience")
@@ -28,11 +114,20 @@ function run(target) {
     stdio: "inherit",
   })
   if (result.error) {
-    console.error(result.error.message)
+    console.error(`Failed to launch OpenScience binary at ${target}: ${result.error.message}`)
+    console.error(`Detected runtime: ${runtimeDescription(os.platform(), os.arch(), detectMusl())}`)
     process.exit(1)
   }
-  const code = typeof result.status === "number" ? result.status : 0
-  process.exit(code)
+  if (result.signal) {
+    console.error(
+      `openscience was terminated by ${result.signal}. The prebuilt native binary may be ` +
+        `incompatible with this host (platform ${os.platform()}, arch ${os.arch()}). ` +
+        `Some ARM64 hosts (e.g. 64KB page-size kernels) cannot run the prebuilt binary. ` +
+        `Try reinstalling, set OPENSCIENCE_BIN_PATH to a compatible binary, or report at ` +
+        `https://github.com/synthetic-sciences/openscience/issues`,
+    )
+  }
+  process.exit(exitCodeForResult(result))
 }
 
 // Helper: check if a path points to a real binary (not this wrapper script)
@@ -50,89 +145,104 @@ function isBinary(p) {
   }
 }
 
-// 1. Check OPENSCIENCE_BIN_PATH env var
-const envPath = process.env.OPENSCIENCE_BIN_PATH
-if (envPath && isBinary(envPath)) {
-  run(envPath)
-}
-
-const binary = os.platform() === "win32" ? "openscience.exe" : "openscience"
-const scriptPath = fs.realpathSync(__filename)
-const scriptDir = path.dirname(scriptPath)
-
-const platformMap = { darwin: "darwin", linux: "linux", win32: "windows" }
-const archMap = { x64: "x64", arm64: "arm64", arm: "arm" }
-const platform = platformMap[os.platform()] || os.platform()
-const arch = archMap[os.arch()] || os.arch()
-const base = "openscience-" + platform + "-" + arch
-const scopedBase = "openscience-" + platform + "-" + arch
-
 // Rank matching platform packages instead of trusting readdir order (which
 // is filesystem-dependent): right libc first, exact name before suffixed
 // variants like -baseline, wrong libc only as a last resort.
-const musl = (() => {
-  if (platform !== "linux") return false
-  try {
-    return fs.readdirSync("/lib").some((f) => f.startsWith("ld-musl-"))
-  } catch {
-    return false
-  }
-})()
-function variantRank(prefix, entry) {
+function variantRank(prefix, entry, preferMusl) {
   const entryMusl = entry.includes("-musl")
-  if (entryMusl !== musl) return 0
+  if (entryMusl !== preferMusl) return 0
   return entry === prefix || entry === prefix + "-musl" ? 2 : 1
 }
-function matchingVariants(prefix, entries) {
-  return entries.filter((e) => e.startsWith(prefix)).sort((a, b) => variantRank(prefix, b) - variantRank(prefix, a))
+function matchingVariants(prefix, entries, preferMusl) {
+  return entries
+    .filter((entry) => entry.startsWith(prefix))
+    .sort((a, b) => variantRank(prefix, b, preferMusl) - variantRank(prefix, a, preferMusl))
 }
 
-// 2. Search this install's node_modules for the matching platform package.
-// This must come before ~/.openscience or Homebrew fallbacks; otherwise an npm
-// install can accidentally launch an older globally-installed binary.
-let current = scriptDir
-while (true) {
-  const modules = path.join(current, "node_modules")
-  if (fs.existsSync(modules)) {
-    try {
-      const entries = fs.readdirSync(modules)
-      for (const entry of matchingVariants(base, entries)) {
-        const candidate = path.join(modules, entry, "bin", binary)
-        if (isBinary(candidate)) run(candidate)
-      }
-      // Check scoped packages (@synsci/openscience-darwin-arm64)
-      const scoped = path.join(modules, "@synsci")
-      if (fs.existsSync(scoped)) {
-        const scopedEntries = fs.readdirSync(scoped)
-        for (const entry of matchingVariants(scopedBase, scopedEntries)) {
-          const candidate = path.join(scoped, entry, "bin", binary)
+function main() {
+  const envPath = process.env.OPENSCIENCE_BIN_PATH
+  if (envPath && isBinary(envPath)) {
+    run(envPath)
+  }
+
+  const binary = os.platform() === "win32" ? "openscience.exe" : "openscience"
+  const scriptPath = fs.realpathSync(__filename)
+  const scriptDir = path.dirname(scriptPath)
+
+  const platformMap = { darwin: "darwin", linux: "linux", win32: "windows" }
+  const archMap = { x64: "x64", arm64: "arm64", arm: "arm" }
+  const platform = platformMap[os.platform()] || os.platform()
+  const arch = archMap[os.arch()] || os.arch()
+  const base = "openscience-" + platform + "-" + arch
+  const scopedBase = "openscience-" + platform + "-" + arch
+  const musl = detectMusl()
+
+  // Search this install's node_modules for the matching platform package.
+  // This must come before ~/.openscience or Homebrew fallbacks; otherwise an npm
+  // install can accidentally launch an older globally-installed binary.
+  let current = scriptDir
+  while (true) {
+    const modules = path.join(current, "node_modules")
+    if (fs.existsSync(modules)) {
+      try {
+        const entries = fs.readdirSync(modules)
+        for (const entry of matchingVariants(base, entries, musl)) {
+          const candidate = path.join(modules, entry, "bin", binary)
           if (isBinary(candidate)) run(candidate)
         }
-      }
-    } catch {}
+        // Check scoped packages (@synsci/openscience-darwin-arm64)
+        const scoped = path.join(modules, "@synsci")
+        if (fs.existsSync(scoped)) {
+          const scopedEntries = fs.readdirSync(scoped)
+          for (const entry of matchingVariants(scopedBase, scopedEntries, musl)) {
+            const candidate = path.join(scoped, entry, "bin", binary)
+            if (isBinary(candidate)) run(candidate)
+          }
+        }
+      } catch {}
+    }
+    const parent = path.dirname(current)
+    if (parent === current) break
+    current = parent
   }
-  const parent = path.dirname(current)
-  if (parent === current) break
-  current = parent
-}
 
-// 3. Check ~/.openscience/bin (curl installer fallback; dir renamed later)
-const homeBin = path.join(os.homedir(), ".openscience", "bin", binary)
-if (isBinary(homeBin)) {
-  run(homeBin)
-}
+  // Check ~/.openscience/bin (curl installer fallback; dir renamed later)
+  const homeBin = path.join(os.homedir(), ".openscience", "bin", binary)
+  if (isBinary(homeBin)) {
+    run(homeBin)
+  }
+
+  // Check /opt/homebrew/bin (macOS)
+  if (os.platform() === "darwin" && isBinary("/opt/homebrew/bin/openscience")) {
+    run("/opt/homebrew/bin/openscience")
+  }
+
+  // Check /usr/local/bin
+  if (isBinary("/usr/local/bin/openscience")) {
+    run("/usr/local/bin/openscience")
+  }
 
-// 4. Check /opt/homebrew/bin (macOS)
-if (os.platform() === "darwin" && isBinary("/opt/homebrew/bin/openscience")) {
-  run("/opt/homebrew/bin/openscience")
+  const expectedPackages = expectedPlatformPackages(platform, arch, musl)
+  console.error(`OpenScience binary not found for ${platform}-${arch}.`)
+  console.error(`Detected runtime: ${runtimeDescription(platform, arch, musl)}`)
+  console.error(`Expected npm package: ${expectedPackages[0]}`)
+  console.error("Check npm's platform selection with:")
+  console.error("  npm config get cpu")
+  console.error(`  npm ls -g @synsci/openscience ${expectedPackages[0]} --depth=0`)
+  console.error("Reinstall with: npm install -g @synsci/openscience")
+  console.error("Or set OPENSCIENCE_BIN_PATH to a native OpenScience binary.")
+  process.exit(1)
 }
 
-// 5. Check /usr/local/bin
-if (isBinary("/usr/local/bin/openscience")) {
-  run("/usr/local/bin/openscience")
+module.exports = {
+  detectMusl,
+  exitCodeForResult,
+  expectedPlatformPackages,
+  linuxArm64PageSizeProblem,
+  linuxKernelProblem,
+  matchingVariants,
+  parseKernelVersion,
+  variantRank,
 }
 
-console.error("openscience binary not found.")
-console.error("Install with: curl -fsSL https://openscience.sh/install | bash")
-console.error("Or set OPENSCIENCE_BIN_PATH environment variable.")
-process.exit(1)
+if (require.main === module) main()

package/package.json

@@ -7,22 +7,23 @@
     "preinstall": "node ./preinstall.mjs || exit 0",
     "postinstall": "bun ./postinstall.mjs || node ./postinstall.mjs"
   },
-  "version": "1.3.4",
+  "version": "1.3.5-test.3.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/synthetic-sciences/openscience.git"
   },
   "optionalDependencies": {
-    "@synsci/openscience-linux-x64-baseline": "1.3.4",
-    "@synsci/openscience-linux-arm64": "1.3.4",
-    "@synsci/openscience-linux-x64": "1.3.4",
-    "@synsci/openscience-windows-x64": "1.3.4",
-    "@synsci/openscience-darwin-arm64": "1.3.4",
-    "@synsci/openscience-darwin-x64": "1.3.4",
-    "@synsci/openscience-linux-x64-baseline-musl": "1.3.4",
-    "@synsci/openscience-linux-x64-musl": "1.3.4",
-    "@synsci/openscience-linux-arm64-musl": "1.3.4",
-    "@synsci/openscience-windows-x64-baseline": "1.3.4",
-    "@synsci/openscience-darwin-x64-baseline": "1.3.4"
+    "@synsci/atlas": "^0.13.2",
+    "@synsci/openscience-linux-x64-baseline-musl": "1.3.5-test.3.1",
+    "@synsci/openscience-windows-x64": "1.3.5-test.3.1",
+    "@synsci/openscience-linux-x64": "1.3.5-test.3.1",
+    "@synsci/openscience-darwin-arm64": "1.3.5-test.3.1",
+    "@synsci/openscience-windows-x64-baseline": "1.3.5-test.3.1",
+    "@synsci/openscience-darwin-x64-baseline": "1.3.5-test.3.1",
+    "@synsci/openscience-linux-x64-musl": "1.3.5-test.3.1",
+    "@synsci/openscience-linux-x64-baseline": "1.3.5-test.3.1",
+    "@synsci/openscience-darwin-x64": "1.3.5-test.3.1",
+    "@synsci/openscience-linux-arm64-musl": "1.3.5-test.3.1",
+    "@synsci/openscience-linux-arm64": "1.3.5-test.3.1"
   }
 }

package/postinstall.mjs

@@ -3,6 +3,7 @@
 import fs from "fs"
 import path from "path"
 import os from "os"
+import childProcess from "child_process"
 import { fileURLToPath } from "url"
 import { createRequire } from "module"
 
@@ -47,12 +48,56 @@ function detectPlatformAndArch() {
   return { platform, arch }
 }
 
+function detectMusl(platform) {
+  if (platform !== "linux") return false
+  try {
+    return fs.readdirSync("/lib").some((entry) => entry.startsWith("ld-musl-"))
+  } catch {
+    return false
+  }
+}
+
+function linuxKernelProblem(platform, release = os.release()) {
+  if (platform !== "linux") return undefined
+  const match = /^(\d+)\.(\d+)/.exec(release)
+  if (!match) return undefined
+  const major = Number(match[1])
+  const minor = Number(match[2])
+  if (major > 5 || (major === 5 && minor >= 1)) return undefined
+  return `Linux kernel ${release} is unsupported; OpenScience's bundled runtime requires kernel 5.1 or newer`
+}
+
+function pageSize(platform) {
+  if (platform !== "linux") return undefined
+  const result = childProcess.spawnSync("getconf", ["PAGESIZE"], { encoding: "utf8" })
+  return result.status === 0 ? result.stdout.trim() || undefined : undefined
+}
+
+function linuxArm64PageSizeProblem(platform, arch, detectedPageSize) {
+  if (platform !== "linux" || arch !== "arm64" || detectedPageSize === undefined) return undefined
+  const bytes = Number.parseInt(String(detectedPageSize), 10)
+  if (!Number.isFinite(bytes) || bytes === 4096) return undefined
+  return [
+    `Linux ARM64 page size ${bytes} is unsupported by OpenScience's Bun-compiled executable`,
+    "use a kernel or VM configured with 4 KB pages",
+    "upstream status: https://github.com/oven-sh/bun/issues/17627",
+  ].join("; ")
+}
+
+function platformPackageNames(platform, arch, musl = detectMusl(platform)) {
+  const base = `openscience-${platform}-${arch}`
+  const variants = musl ? [`${base}-musl`] : [base]
+  if (arch === "x64") variants.push(musl ? `${base}-baseline-musl` : `${base}-baseline`)
+  return variants.flatMap((name) => [`@synsci/${name}`, name])
+}
+
 function findBinary() {
   const { platform, arch } = detectPlatformAndArch()
   const binaryName = platform === "windows" ? "openscience.exe" : "openscience"
 
-  // Try scoped package first (@synsci/openscience-darwin-arm64), then unscoped (openscience-darwin-arm64)
-  const packageNames = [`@synsci/openscience-${platform}-${arch}`, `openscience-${platform}-${arch}`]
+  // Try the libc-compatible native package first, followed by an x64 baseline
+  // build for older CPUs. Never select a package for the wrong architecture.
+  const packageNames = platformPackageNames(platform, arch)
 
   for (const packageName of packageNames) {
     try {
@@ -70,7 +115,15 @@ function findBinary() {
     }
   }
 
-  throw new Error(`Could not find platform binary package for ${platform}-${arch}`)
+  throw new Error(
+    [
+      `Could not find a native platform binary for ${platform}-${arch}.`,
+      `Expected one of: ${packageNames.join(", ")}.`,
+      `Detected node ${process.version} on kernel ${os.release()}.`,
+      `Check npm selection with: npm config get cpu`,
+      `Then inspect the install with: npm ls -g @synsci/openscience ${packageNames[0]} --depth=0`,
+    ].join("\n"),
+  )
 }
 
 function prepareBinDirectory(binaryName) {
@@ -102,7 +155,7 @@ function symlinkBinary(sourcePath, binaryName) {
   }
 }
 
-async function main() {
+function main() {
   try {
     if (os.platform() === "win32") {
       // On Windows, the .exe is already included in the package and bin field points to it
@@ -111,6 +164,16 @@ async function main() {
       return
     }
 
+    const { platform, arch } = detectPlatformAndArch()
+    const kernelProblem = linuxKernelProblem(platform)
+    if (kernelProblem) {
+      throw new Error(`${kernelProblem}. CentOS 7's stock 3.10 kernel is not supported.`)
+    }
+    const pageSizeProblem = linuxArm64PageSizeProblem(platform, arch, pageSize(platform))
+    if (pageSizeProblem) {
+      throw new Error(pageSizeProblem)
+    }
+
     // On non-Windows platforms, just verify the binary package exists
     // Don't replace the wrapper script - it handles binary execution
     const { binaryPath } = findBinary()
@@ -122,9 +185,13 @@ async function main() {
   }
 }
 
-try {
-  main()
-} catch (error) {
-  console.error("Postinstall script error:", error.message)
-  process.exit(0)
+export {
+  detectMusl,
+  detectPlatformAndArch,
+  findBinary,
+  linuxArm64PageSizeProblem,
+  linuxKernelProblem,
+  platformPackageNames,
 }
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) main()