rlm-harness 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rishi Jain
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,47 @@
-# Temporary Holding Version
+# rlmh
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A model-agnostic harness for Recursive Language Models. The model never reads a long input directly. It writes Python against the input in a REPL, hands pieces of it to sub-calls, and submits an answer. Source, design and docs: [RishiJain905/rlm-harness](https://github.com/RishiJain905/rlm-harness).
+
+This package installs the compiled `rlmh` binary for your platform: macOS arm64 or x64, Windows x64, or Linux x64 (glibc).
+
+## Install
+
+```
+npm i -g rlm-harness
+```
+
+```
+bun add -g --trust rlm-harness
+```
+
+- **Bun needs `--trust`.** Bun skips install scripts unless told otherwise, and on Windows `rlmh` cannot start without its install step. If you already installed without it, run `bun pm -g trust rlm-harness`.
+- **Without Node or Bun**, use the one-line installers on the [releases page](https://github.com/RishiJain905/rlm-harness/releases/latest).
+
+## What the install does
+
+The install step links the binary from `@rlmh/<platform>-<arch>` into this package, so the `rlmh` command is the compiled binary itself. No Node or Bun process sits in between, so `rlmh` never loads a `.env` or a `bunfig.toml` from the folder you run it in.
+
+On first run, `rlmh` asks before it downloads Python 3.12, through the bundled uv, into `~/.rlm-harness/python/` (or `$RLMH_HOME`). Nothing else on the machine changes.
+
+## Uninstall
+
+```
+npm rm -g rlm-harness
+```
+
+or
+
+```
+bun rm -g rlm-harness
+```
+
+This leaves `~/.rlm-harness/` in place, holding Python, the engine, settings and run logs. To remove everything:
+
+1. Delete saved keys in `/providers` first. They live in the OS credential store, not in that folder.
+2. Delete the folder.
+
+## Notes
+
+- Install from a folder you trust. `npm` and `bun` read the current folder's `.npmrc` or `bunfig.toml`, which can point them at another registry.
+- On Windows, close `rlmh` before upgrading. A running `rlmh.exe` cannot be replaced.
+- The binaries are not code signed. macOS ones carry an ad hoc signature only.

package/bin/rlmh.exe

@@ -0,0 +1,33 @@
+# rlmh: a placeholder (D-130). rlmh's postinstall (install.js) replaces this file with the compiled
+# rlmh binary for this machine. It has no "#!" line on purpose: npm and Bun then link it to run
+# directly, so the binary that replaces it runs with no Node or Bun in between.
+# When the postinstall was skipped (bun add -g without --trust, or --ignore-scripts), a Unix shell
+# or execvp runs this file with /bin/sh, and it starts the binary from the platform package. Windows
+# cannot run it: there the postinstall is required.
+self=$0
+while [ -L "$self" ]; do
+  link=$(readlink "$self")
+  case $link in
+    /*) self=$link ;;
+    *) self=$(dirname "$self")/$link ;;
+  esac
+done
+pkg=$(cd "$(dirname "$self")/.." && pwd -P)
+case $(uname -s) in
+  Darwin) keys="darwin-arm64 darwin-x64" ;;
+  Linux) keys="linux-x64" ;;
+  *) keys="" ;;
+esac
+# npm nests the platform package inside rlm-harness; Bun and pnpm put it beside rlm-harness
+for dir in "$pkg/node_modules/@rlmh" "$pkg/../@rlmh"; do
+  for key in $keys; do
+    bin=$dir/$key/bin/rlmh
+    if [ -f "$bin" ]; then
+      echo 'rlmh: the install step did not run; "bun pm -g trust rlm-harness" makes this permanent.' >&2
+      [ -x "$bin" ] || chmod +x "$bin" 2>/dev/null
+      exec "$bin" "$@"
+    fi
+  done
+done
+echo "rlmh: no compiled rlmh for $(uname -sm) next to $pkg. Reinstall without --omit=optional: npm i -g rlm-harness" >&2
+exit 1

package/install.js

@@ -0,0 +1,83 @@
+// KV cache: none
+// rlmh's postinstall (D-130). Links this platform's compiled rlmh and uv from the optional dependency
+// @rlmh/<platform>-<arch> over the placeholder bin/rlmh.exe and into bin/, so the `rlmh` command npm
+// or Bun linked at install time is the compiled binary itself, with no Node or Bun in between. It runs
+// once, at install, with the package folder as its working folder; rlmh never runs it again.
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const PLATFORMS = ["win32-x64", "darwin-arm64", "darwin-x64", "linux-x64"];
+const UNSUPPORTED = "rlmh v0 ships macOS arm64 and x64, Windows x64 and Linux x64 (glibc).";
+
+/** True on a musl Linux such as Alpine: its loader sits in /lib. Works under Node and under Bun as node. */
+function isMusl() {
+  try {
+    return fs.readdirSync("/lib").some((f) => f.startsWith("ld-musl-"));
+  } catch {
+    return false;
+  }
+}
+
+/** "<platform>-<arch>", or throws the installers' unsupported-platform message. */
+function platformKey(platform, arch, musl) {
+  const key = `${platform}-${arch}`;
+  if (!PLATFORMS.includes(key) || (platform === "linux" && musl)) {
+    throw new Error(`${UNSUPPORTED} This machine is ${platform} ${arch}${platform === "linux" && musl ? " (musl)" : ""}.`);
+  }
+  return key;
+}
+
+/** The folder of @rlmh/<key>, or throws when npm or Bun did not install it. */
+function packageDir(key, resolve) {
+  const name = `@rlmh/${key}`;
+  try {
+    return path.dirname(resolve(`${name}/package.json`));
+  } catch {
+    throw new Error(`${name} is not installed. Reinstall without --omit=optional or --no-optional: npm i -g rlm-harness`);
+  }
+}
+
+/** Hard-links src to dest (a copy where a link fails), through a temp name so dest is never half-written. */
+function place(src, dest) {
+  if (!fs.existsSync(src)) throw new Error(`${src} is missing from its package`);
+  const tmp = `${dest}.${process.pid}.tmp`;
+  fs.rmSync(tmp, { force: true });
+  try {
+    fs.linkSync(src, tmp);
+  } catch {
+    fs.copyFileSync(src, tmp);
+  }
+  if (process.platform !== "win32") fs.chmodSync(tmp, 0o755);
+  fs.renameSync(tmp, dest);
+  fs.rmSync(tmp, { force: true }); // rename leaves tmp when dest was already a link to the same file (a re-run)
+}
+
+/** Puts rlmh and uv from the platform package into <root>/bin. */
+function install(opts) {
+  const key = platformKey(opts.platform, opts.arch, opts.musl);
+  const from = path.join(packageDir(key, opts.resolve), "bin");
+  const to = path.join(opts.root, "bin");
+  const exe = opts.platform === "win32" ? ".exe" : "";
+  place(path.join(from, `uv${exe}`), path.join(to, `uv${exe}`));
+  place(path.join(from, `rlmh${exe}`), path.join(to, "rlmh.exe")); // the bin target on every OS
+  return key;
+}
+
+module.exports = { PLATFORMS, UNSUPPORTED, platformKey, packageDir, place, install };
+
+if (require.main === module) {
+  try {
+    install({
+      platform: process.platform,
+      arch: process.arch,
+      musl: process.platform === "linux" && isMusl(),
+      resolve: require.resolve,
+      root: __dirname,
+    });
+  } catch (err) {
+    console.error(`rlmh: ${err.message}`);
+    process.exit(1);
+  }
+}

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "rlm-harness",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "RLM harness: a model-agnostic harness for Recursive Language Models. This package installs the compiled rlmh binary for your platform.",
+  "license": "MIT",
+  "homepage": "https://github.com/RishiJain905/rlm-harness",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RishiJain905/rlm-harness.git"
+  },
+  "bin": {
+    "rlmh": "bin/rlmh.exe"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "files": [
+    "bin/rlmh.exe",
+    "install.js",
+    "LICENSE",
+    "README.md"
+  ],
+  "optionalDependencies": {
+    "@rlmh/darwin-arm64": "0.2.0",
+    "@rlmh/darwin-x64": "0.2.0",
+    "@rlmh/linux-x64": "0.2.0",
+    "@rlmh/win32-x64": "0.2.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}