@engramresearch/srun 0.1.1 → 0.1.3

package/README.md

@@ -34,7 +34,7 @@ After publishing:
 npm install -g @engramresearch/srun
 ```
 
-Note: the npm package currently builds the Rust binary lazily on first run, so Rust/Cargo must be available on the target machine.
+The npm package includes prebuilt binaries for supported platforms. Rust/Cargo is only required when building from source.
 
 Or run during development:
 
@@ -139,8 +139,40 @@ srun dev --verbose --dry-run
 
 Shows detection and resolution phases before printing the command.
 
+## Release process
+
+Releases are published by GitHub Actions from version tags.
+
+1. Update the version in `package.json` and `Cargo.toml`.
+2. Run:
+
+```bash
+npm run release:check
+cargo fmt -- --check
+cargo check
+cargo test
+```
+
+3. Commit, push, and create a tag:
+
+```bash
+git tag v0.1.3
+git push origin main v0.1.3
+```
+
+The workflow builds platform binaries, packages them into the single root npm package, then publishes `@engramresearch/srun`.
+
+Required GitHub secret:
+
+```text
+NPM_TOKEN
+```
+
+Use an npm automation/granular token that can publish under `@engramresearch` and bypass 2FA for CI.
+
 ## Current limitations
 
+- Prebuilt npm binaries currently target Windows x64, Linux x64, and macOS arm64.
 - Monorepo scopes such as `srun dev web` are detected as a future extension but not fully implemented yet.
 - Interactive fallback for custom scripts is not implemented; `srun` reports candidates instead of guessing.
 - Colors and shell integration are intentionally omitted from the MVP.

package/npm/srun.js

@@ -4,23 +4,30 @@ const { existsSync } = require("node:fs");
 const { join, resolve } = require("node:path");
 
 const root = resolve(__dirname, "..");
-const binary = join(root, "target", "release", process.platform === "win32" ? "srun.exe" : "srun");
-
-if (!existsSync(binary)) {
-  const result = spawnSync("cargo", ["build", "--release"], {
-    cwd: root,
-    stdio: "inherit",
-    shell: process.platform === "win32",
-  });
-
-  if (result.error) {
-    console.error(`srun: failed to build Rust binary: ${result.error.message}`);
-    process.exit(1);
+const binaryName = process.platform === "win32" ? "srun.exe" : "srun";
+const platformKey = `${process.platform}-${process.arch}`;
+const packagedBinary = join(__dirname, "bin", platformKey, binaryName);
+const localDevBinary = join(root, "target", "release", binaryName);
+
+function resolveBinary() {
+  if (existsSync(packagedBinary)) {
+    return packagedBinary;
   }
 
-  if (result.status !== 0) {
-    process.exit(result.status ?? 1);
+  if (existsSync(localDevBinary)) {
+    return localDevBinary;
   }
+
+  return undefined;
+}
+
+const binary = resolveBinary();
+
+if (!binary) {
+  console.error(`srun: no bundled binary found for ${platformKey}.`);
+  console.error("srun: supported npm platforms are win32-x64, linux-x64, and darwin-arm64.");
+  console.error("srun: if you are developing locally, run `cargo build --release` first.");
+  process.exit(1);
 }
 
 const result = spawnSync(binary, process.argv.slice(2), {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@engramresearch/srun",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Universal Smart Project Runner",
   "license": "MIT",
   "bin": {
@@ -12,13 +12,12 @@
     "build": "cargo build",
     "test": "cargo test",
     "lint": "cargo clippy",
-    "format": "cargo fmt"
+    "format": "cargo fmt",
+    "release:check": "node npm/check-release.js"
   },
   "files": [
-    "Cargo.toml",
-    "Cargo.lock",
-    "src",
-    "npm",
+    "npm/srun.js",
+    "npm/bin",
     "README.md",
     "LICENSE"
   ],