@goliapkg/smix-cli 2.1.0

package/bin/launch.mjs

@@ -0,0 +1,71 @@
+// Shared launcher for the two executables this package installs.
+//
+// Both are ordinary native binaries: the npm package is a delivery
+// mechanism, not a wrapper. So this hands over argv untouched, inherits
+// all three streams, and exits with whatever the binary exited with.
+//
+// Inheriting stdio is not a detail — `smix-mcp` speaks MCP over stdin and
+// stdout, and anything that buffers, re-encodes, or writes a line of its
+// own into those streams corrupts the protocol.
+import { spawnSync } from 'node:child_process'
+import { createRequire } from 'node:module'
+import { dirname } from 'node:path'
+import process from 'node:process'
+
+import { binaryPath, resolvePackage } from '../dist/resolve.js'
+
+/** glibc vs musl, or null when the runtime will not say. */
+function detectLibc() {
+  // Node reports the libc family in process.report on Linux. On other
+  // platforms the question does not arise, and a wrong guess here would
+  // refuse an install that was fine.
+  if (process.platform !== 'linux') return null
+  try {
+    const report = process.report?.getReport()
+    const header = typeof report === 'object' && report !== null ? report.header : undefined
+    const glibc = header?.glibcVersionRuntime
+    return typeof glibc === 'string' && glibc !== '' ? 'glibc' : 'musl'
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Run `exe` with this process's arguments and exit with its status.
+ *
+ * @param {'smix' | 'smix-mcp'} exe
+ */
+export function launch(exe) {
+  const pkg = resolvePackage(process.platform, process.arch, detectLibc())
+
+  let binary
+  try {
+    // Resolve the package's manifest rather than the binary itself:
+    // resolution of an extensionless file is not something a package
+    // without an `exports` map is obliged to support, and the manifest
+    // always resolves.
+    const require = createRequire(import.meta.url)
+    binary = binaryPath(dirname(require.resolve(`${pkg}/package.json`)), exe)
+  } catch {
+    // An optional dependency that did not install is the ordinary way this
+    // fails, and `--no-optional` or an offline install is how it happens.
+    process.stderr.write(
+      `smix: ${pkg} is not installed, so there is no ${exe} binary for this machine.\n` +
+        `Reinstall without --no-optional, or build from source: cargo install smix-cli --locked\n`,
+    )
+    process.exit(127)
+  }
+
+  const result = spawnSync(binary, process.argv.slice(2), { stdio: 'inherit' })
+  if (result.error !== undefined) {
+    process.stderr.write(`smix: could not run ${binary}: ${result.error.message}\n`)
+    process.exit(126)
+  }
+  // A binary killed by a signal has no exit code. Reporting 0 there would
+  // tell a script the run succeeded.
+  if (result.status === null) {
+    process.stderr.write(`smix: ${exe} was killed by ${result.signal}\n`)
+    process.exit(128)
+  }
+  process.exit(result.status)
+}

package/bin/smix-mcp.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { launch } from "./launch.mjs"
+
+launch("smix-mcp")

package/bin/smix.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { launch } from "./launch.mjs"
+
+launch("smix")

package/dist/resolve.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Which prebuilt package carries the binaries for the machine running this.
+ *
+ * smix is a Rust workspace, and `cargo install smix-cli` compiles 27 crates
+ * and needs a Rust toolchain — a wall in front of someone whose app is
+ * Swift or Kotlin and whose machine has never had rustup on it. This
+ * package exists so the binaries arrive prebuilt instead.
+ */
+/** A target CI builds binaries for, and the npm package they ship in. */
+export interface Target {
+    /** Rust target triple, as passed to `cargo build --target`. */
+    readonly triple: string;
+    /** `process.platform` this triple serves. */
+    readonly platform: string;
+    /** `process.arch` this triple serves. */
+    readonly arch: string;
+    /** npm package suffix — the part after `@goliapkg/smix-cli-`. */
+    readonly suffix: string;
+}
+/**
+ * The build matrix, in one place.
+ *
+ * `.github/workflows/ci.yml`'s `cli-prebuild` job builds exactly these
+ * triples, and a test asserts this table against that list. Two copies of a
+ * platform list drift, and the drift shows up as a package that resolves to
+ * a subpackage nobody published.
+ */
+export declare const TARGETS: readonly Target[];
+/**
+ * The platform package for `platform`/`arch`, or throw saying why not.
+ *
+ * Never guesses. A binary for the wrong architecture installs cleanly and
+ * then fails at exec with a loader error that names neither smix nor the
+ * mismatch, which is a worse place to find out than here.
+ */
+export declare function resolvePackage(platform: string, arch: string, libc: string | null): string;
+/** Specifier for one executable inside a platform package. */
+export declare function binaryPath(pkg: string, exe: 'smix' | 'smix-mcp'): string;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yEAAyE;AACzE,MAAM,WAAW,MAAM;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,MAAM,EAmBpC,CAAA;AAKD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,MAAM,CAeR;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAExE"}

package/dist/resolve.js

@@ -0,0 +1,62 @@
+/**
+ * Which prebuilt package carries the binaries for the machine running this.
+ *
+ * smix is a Rust workspace, and `cargo install smix-cli` compiles 27 crates
+ * and needs a Rust toolchain — a wall in front of someone whose app is
+ * Swift or Kotlin and whose machine has never had rustup on it. This
+ * package exists so the binaries arrive prebuilt instead.
+ */
+/**
+ * The build matrix, in one place.
+ *
+ * `.github/workflows/ci.yml`'s `cli-prebuild` job builds exactly these
+ * triples, and a test asserts this table against that list. Two copies of a
+ * platform list drift, and the drift shows up as a package that resolves to
+ * a subpackage nobody published.
+ */
+export const TARGETS = [
+    {
+        triple: 'aarch64-apple-darwin',
+        platform: 'darwin',
+        arch: 'arm64',
+        suffix: 'darwin-arm64',
+    },
+    {
+        triple: 'x86_64-apple-darwin',
+        platform: 'darwin',
+        arch: 'x64',
+        suffix: 'darwin-x64',
+    },
+    {
+        triple: 'x86_64-unknown-linux-gnu',
+        platform: 'linux',
+        arch: 'x64',
+        suffix: 'linux-x64-gnu',
+    },
+];
+/** What to tell someone whose machine we have no binary for. */
+const FALLBACK = 'build from source instead: cargo install smix-cli --locked';
+/**
+ * The platform package for `platform`/`arch`, or throw saying why not.
+ *
+ * Never guesses. A binary for the wrong architecture installs cleanly and
+ * then fails at exec with a loader error that names neither smix nor the
+ * mismatch, which is a worse place to find out than here.
+ */
+export function resolvePackage(platform, arch, libc) {
+    if (platform === 'linux' && libc !== null && libc !== 'glibc') {
+        throw new Error(`smix has no prebuilt binary for linux/${arch} with ${libc} — the published ` +
+            `Linux build links against glibc and will not load. ${FALLBACK}`);
+    }
+    const hit = TARGETS.find((t) => t.platform === platform && t.arch === arch);
+    if (hit === undefined) {
+        throw new Error(`smix has no prebuilt binary for ${platform}/${arch}. Built targets: ` +
+            `${TARGETS.map((t) => `${t.platform}/${t.arch}`).join(', ')}. ${FALLBACK}`);
+    }
+    return `@goliapkg/smix-cli-${hit.suffix}`;
+}
+/** Specifier for one executable inside a platform package. */
+export function binaryPath(pkg, exe) {
+    return `${pkg}/${exe}`;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAsB;IACxC;QACE,MAAM,EAAE,sBAAsB;QAC9B,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,cAAc;KACvB;IACD;QACE,MAAM,EAAE,qBAAqB;QAC7B,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,YAAY;KACrB;IACD;QACE,MAAM,EAAE,0BAA0B;QAClC,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,eAAe;KACxB;CACF,CAAA;AAED,gEAAgE;AAChE,MAAM,QAAQ,GAAG,4DAA4D,CAAA;AAE7E;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,IAAY,EACZ,IAAmB;IAEnB,IAAI,QAAQ,KAAK,OAAO,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,yCAAyC,IAAI,SAAS,IAAI,mBAAmB;YAC3E,sDAAsD,QAAQ,EAAE,CACnE,CAAA;IACH,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;IAC3E,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,mCAAmC,QAAQ,IAAI,IAAI,mBAAmB;YACpE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAC7E,CAAA;IACH,CAAC;IACD,OAAO,sBAAsB,GAAG,CAAC,MAAM,EAAE,CAAA;AAC3C,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,GAAwB;IAC9D,OAAO,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;AACxB,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@goliapkg/smix-cli",
+  "version": "2.1.0",
+  "description": "The smix CLI and MCP server as prebuilt binaries — no Rust toolchain required.",
+  "type": "module",
+  "license": "Apache-2.0 OR MIT",
+  "homepage": "https://github.com/goliajp/smix",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/goliajp/smix.git"
+  },
+  "bin": {
+    "smix": "bin/smix.mjs",
+    "smix-mcp": "bin/smix-mcp.mjs"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "optionalDependencies": {
+    "@goliapkg/smix-cli-darwin-arm64": "2.1.0",
+    "@goliapkg/smix-cli-darwin-x64": "2.1.0",
+    "@goliapkg/smix-cli-linux-x64-gnu": "2.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "vitest": "^3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  }
+}