@exla/rudder 0.0.0-stage → 3.4.0

package/dist/version-check.js

@@ -0,0 +1,269 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const CACHE_TTL_MS = 6 * 60 * 60 * 1000; // 6 hours
+const AUTO_UPDATE_TIMEOUT_MS = 1000;
+const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+export const PACKAGE_NAME = "@exla/rudder";
+// Rudder was published as @viraatdas/rudder until the move to the exla-ai org
+// (3.4.0). Releases still publish that name too, so an old install updates to a
+// build that knows the new one and then moves itself across.
+export const LEGACY_PACKAGE_NAME = "@viraatdas/rudder";
+function cachePath() {
+    const base = process.env.XDG_CACHE_HOME?.trim() || path.join(os.homedir(), ".cache");
+    return path.join(base, "rudder", "update-check.json");
+}
+export function compareSemver(a, b) {
+    const split = (v) => v
+        .split("-")[0]
+        .split(".")
+        .map((part) => Number.parseInt(part, 10) || 0);
+    const aa = split(a);
+    const bb = split(b);
+    for (let i = 0; i < 3; i++) {
+        const x = aa[i] ?? 0;
+        const y = bb[i] ?? 0;
+        if (x !== y)
+            return x < y ? -1 : 1;
+    }
+    return 0;
+}
+async function readPackageInfo() {
+    // Try package.json relative to compiled dist/, then to source src/.
+    const candidates = [
+        path.join(moduleDir, "..", "package.json"),
+        path.join(moduleDir, "..", "..", "package.json"),
+    ];
+    for (const candidate of candidates) {
+        try {
+            const raw = await fsp.readFile(candidate, "utf8");
+            const parsed = JSON.parse(raw);
+            if ((parsed?.name === PACKAGE_NAME || parsed?.name === LEGACY_PACKAGE_NAME) && typeof parsed.version === "string") {
+                return { root: path.dirname(candidate), version: parsed.version, name: parsed.name };
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return null;
+}
+async function readPackageVersion() {
+    return (await readPackageInfo())?.version ?? null;
+}
+async function readCache() {
+    try {
+        const raw = await fsp.readFile(cachePath(), "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.latest === "string" && typeof parsed.checkedAt === "number") {
+            return { latest: parsed.latest, checkedAt: parsed.checkedAt };
+        }
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+async function writeCache(latest) {
+    const file = cachePath();
+    try {
+        await fsp.mkdir(path.dirname(file), { recursive: true });
+        await fsp.writeFile(file, JSON.stringify({ latest, checkedAt: Date.now() }));
+    }
+    catch {
+        // ignore
+    }
+}
+async function fetchLatest(timeoutMs = 1500) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+            signal: controller.signal,
+            headers: { accept: "application/json" },
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return typeof data?.version === "string" ? data.version : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Returns the latest published version if our local version is older, otherwise null.
+ * Cached for 6h on disk so startup doesn't hit the network every launch. Never throws.
+ * Disabled when RUDDER_DISABLE_UPDATE_CHECK is set.
+ */
+export async function getUpdateAvailable() {
+    if (process.env.RUDDER_DISABLE_UPDATE_CHECK)
+        return null;
+    const current = await readPackageVersion();
+    if (!current)
+        return null;
+    const cached = await readCache();
+    let latest = null;
+    if (cached && Date.now() - cached.checkedAt < CACHE_TTL_MS) {
+        latest = cached.latest;
+    }
+    else {
+        latest = await fetchLatest();
+        if (latest) {
+            await writeCache(latest);
+        }
+        else if (cached) {
+            latest = cached.latest;
+        }
+    }
+    if (!latest)
+        return null;
+    return compareSemver(current, latest) < 0 ? { current, latest } : null;
+}
+export function shouldAutoUpdateFromPackageRoot(packageRoot) {
+    const root = path.resolve(packageRoot);
+    if (process.env.RUDDER_DISABLE_UPDATE_CHECK || process.env.RUDDER_DISABLE_AUTO_UPDATE || process.env.RUDDER_SKIP_AUTO_UPDATE) {
+        return false;
+    }
+    if (process.env.CI) {
+        return false;
+    }
+    // Do not mutate a source checkout while developing Rudder locally.
+    if (fs.existsSync(path.join(root, ".git")) || fs.existsSync(path.join(root, "src", "main.ts"))) {
+        return false;
+    }
+    // `npx @exla/rudder@...` is already an ephemeral install; turning that into
+    // a global install is surprising and can fail under temp-directory permissions.
+    const normalized = root.split(path.sep).join("/");
+    if (normalized.includes("/_npx/") || normalized.includes("/.npm/_npx/")) {
+        return false;
+    }
+    return true;
+}
+export async function autoUpdateAndRerunIfNeeded(argv) {
+    const info = await readPackageInfo();
+    if (!info || !shouldAutoUpdateFromPackageRoot(info.root)) {
+        return false;
+    }
+    const latest = await fetchLatest(AUTO_UPDATE_TIMEOUT_MS);
+    if (latest && info.name === LEGACY_PACKAGE_NAME) {
+        return await moveToRenamedPackage(info.version, latest, argv);
+    }
+    if (!latest || compareSemver(info.version, latest) >= 0) {
+        if (latest) {
+            await writeCache(latest);
+        }
+        return false;
+    }
+    console.error(`rudder: updating ${info.version} -> ${latest}...`);
+    const installed = await installLatest(latest);
+    if (!installed.ok) {
+        // A version can be readable in the registry's packument seconds before every
+        // replica can resolve it for install. The updater sees the new number, npm
+        // says ETARGET, and the user gets a five-line npm error block for what is a
+        // publish that has not finished propagating. Name it and move on; nothing is
+        // cached on failure, so the next launch retries.
+        if (isUnpublishedYet(installed.output)) {
+            console.error(`rudder: ${latest} is not resolvable from the registry yet; staying on ${info.version}`);
+        }
+        else {
+            console.error(`rudder: auto-update failed; continuing with ${info.version}`);
+            const detail = installed.output.trim();
+            if (detail) {
+                console.error(detail);
+            }
+        }
+        return false;
+    }
+    await writeCache(latest);
+    console.error(`rudder: updated to ${latest}; restarting command...`);
+    process.exitCode = await rerunCurrentCommand(argv);
+    return true;
+}
+// Both packages install the same `rudder` bin, so the old one has to go first
+// or npm refuses with EEXIST. When the new one will not install, the old
+// version goes back so nobody is left without a `rudder`.
+async function moveToRenamedPackage(current, latest, argv) {
+    console.error(`rudder: the package moved to ${PACKAGE_NAME}; switching this install over (${current} -> ${latest})...`);
+    await spawnCaptured("npm", ["uninstall", "-g", LEGACY_PACKAGE_NAME], { RUDDER_SKIP_AUTO_UPDATE: "1" });
+    const installed = await installLatest(latest);
+    if (!installed.ok) {
+        await spawnCaptured("npm", ["install", "-g", `${LEGACY_PACKAGE_NAME}@${current}`], { RUDDER_SKIP_AUTO_UPDATE: "1" });
+        console.error(`rudder: could not install ${PACKAGE_NAME}; staying on ${LEGACY_PACKAGE_NAME}@${current}`);
+        const detail = installed.output.trim();
+        if (detail) {
+            console.error(detail);
+        }
+        return false;
+    }
+    await writeCache(latest);
+    console.error(`rudder: now on ${PACKAGE_NAME}@${latest}; restarting command...`);
+    process.exitCode = await spawnExitCode("rudder", argv, { RUDDER_SKIP_AUTO_UPDATE: "1" });
+    return true;
+}
+async function installLatest(version) {
+    const result = await spawnCaptured("npm", ["install", "-g", `${PACKAGE_NAME}@${version}`], {
+        RUDDER_SKIP_AUTO_UPDATE: "1",
+    });
+    return { ok: result.code === 0, output: result.output };
+}
+/** npm's shape for "that version exists in the index but I cannot resolve it". */
+export function isUnpublishedYet(npmOutput) {
+    return /\bETARGET\b/.test(npmOutput) || /\bnotarget\b/.test(npmOutput);
+}
+async function rerunCurrentCommand(argv) {
+    const entry = process.argv[1];
+    if (entry) {
+        const code = await spawnExitCode(process.execPath, [entry, ...argv], {
+            RUDDER_SKIP_AUTO_UPDATE: "1",
+        });
+        if (code !== 127) {
+            return code;
+        }
+    }
+    return await spawnExitCode("rudder", argv, { RUDDER_SKIP_AUTO_UPDATE: "1" });
+}
+/**
+ * Inherited stdio. The re-run path hands the terminal to the real dashboard,
+ * so this MUST NOT be swapped for the capturing variant: a captured TUI has no
+ * terminal to draw on.
+ */
+async function spawnExitCode(command, args, envPatch) {
+    return await new Promise((resolve) => {
+        const child = spawn(command, args, {
+            stdio: "inherit",
+            env: { ...process.env, ...envPatch },
+        });
+        child.on("error", () => resolve(127));
+        child.on("close", (code) => resolve(code ?? 1));
+    });
+}
+/**
+ * Run a command with its output CAPTURED rather than inherited, so the caller
+ * decides what the user sees. The updater runs before the TUI paints, and an
+ * inherited npm error block is indistinguishable from rudder itself failing.
+ */
+async function spawnCaptured(command, args, envPatch) {
+    return await new Promise((resolve) => {
+        let output = "";
+        const child = spawn(command, args, {
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env, ...envPatch },
+        });
+        child.stdout?.on("data", (chunk) => {
+            output += String(chunk);
+        });
+        child.stderr?.on("data", (chunk) => {
+            output += String(chunk);
+        });
+        child.on("error", () => resolve({ code: 127, output }));
+        child.on("close", (code) => resolve({ code: code ?? 1, output }));
+    });
+}
+//# sourceMappingURL=version-check.js.map

package/dist/version-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../src/version-check.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,70 @@
 {
   "name": "@exla/rudder",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "3.4.0",
+  "description": "A TUI for managing coding agents: run Claude Code, Codex and opencode side by side, each in its own isolated jj workspace.",
+  "keywords": [
+    "tui",
+    "coding-agents",
+    "claude-code",
+    "codex",
+    "opencode",
+    "ai-agents",
+    "jujutsu",
+    "terminal",
+    "cli"
+  ],
+  "license": "Elastic-2.0",
+  "homepage": "https://rudder.exla.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/exla-ai/rudder.git"
+  },
+  "type": "module",
+  "bin": {
+    "rudder": "dist/index.js"
+  },
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.json && npm run build-board && npm run build-native && npm run copy-native && npm run chmod-cli",
+    "build-board": "esbuild src/board/ui/index.tsx --bundle --minify --format=esm --jsx=automatic --jsx-import-source=preact --outfile=dist/board/board.js && esbuild src/board/ui/board.css --bundle --minify --outfile=dist/board/board.css",
+    "build-native": "cargo build --release --manifest-path native/Cargo.toml",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "tsc -p tsconfig.json && npm run chmod-cli && node --test tests/*.test.mjs",
+    "test:tui": "node --test tests/tui/*.test.mjs",
+    "test:worker-scroll": "cargo test --manifest-path native/Cargo.toml top_origin_scroll_region_history_scrolls_like_terminal_scrollback && cargo test --manifest-path native/Cargo.toml worker_wheel && cargo test --manifest-path native/Cargo.toml wheel_scroll && cargo test --manifest-path native/Cargo.toml worker_page && cargo test --manifest-path native/Cargo.toml codex_alternate_screen_page_key",
+    "copy-native": "node scripts/copy-native.mjs",
+    "chmod-cli": "node -e \"require('fs').chmodSync('dist/index.js',0o755)\"",
+    "prepack": "npm run build",
+    "postinstall": "node scripts/postinstall.mjs",
+    "start": "node dist/index.js",
+    "test:tui:report": "rm -rf .tui-report tui-report.html && node --test --test-reporter=spec --test-reporter-destination=stdout --test-reporter=tui-integration-tests/reporter --test-reporter-destination=tui-report.html tests/tui/*.test.mjs",
+    "mutate:tui": "node tests/tui/mutate.mjs"
+  },
+  "files": [
+    "dist/",
+    "assets/",
+    "scripts/copy-native.mjs",
+    "scripts/postinstall.mjs",
+    "README.md",
+    "package.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "@types/ws": "^8.5.13",
+    "esbuild": "^0.24.0",
+    "preact": "^10.25.0",
+    "preact-render-to-string": "^6.7.0",
+    "tui-integration-tests": "^0.6.1",
+    "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "@xterm/headless": "^6.0.0",
+    "ws": "^8.18.0"
+  }
+}

package/scripts/copy-native.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+
+const nativeBinaryBase = "rudder-native";
+const nativeBinaryName = process.platform === "win32" ? `${nativeBinaryBase}.exe` : nativeBinaryBase;
+const platformKey = `${process.platform}-${process.arch}`;
+const distNativeDir = path.join("dist", "native");
+
+function copyExecutable(src, dest) {
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.copyFileSync(src, dest);
+  if (process.platform !== "win32") {
+    fs.chmodSync(dest, 0o755);
+  }
+}
+
+function copyCurrentBuild() {
+  const sources = [
+    path.join("target", "release", nativeBinaryName),
+    path.join("native", "target", "release", nativeBinaryName),
+  ];
+  const src = sources.find((candidate) => fs.existsSync(candidate));
+  if (!src) {
+    return false;
+  }
+  copyExecutable(src, path.join(distNativeDir, platformKey, nativeBinaryName));
+  return true;
+}
+
+function copyPrebuiltArtifacts() {
+  const root = process.env.RUDDER_NATIVE_PREBUILTS;
+  if (!root || !fs.existsSync(root)) {
+    return 0;
+  }
+  let copied = 0;
+  for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
+    if (!entry.isDirectory()) {
+      continue;
+    }
+    const key = entry.name.replace(/^rudder-native-/, "");
+    const dir = path.join(root, entry.name);
+    const candidates = [
+      path.join(dir, "rudder-native"),
+      path.join(dir, "rudder-native.exe"),
+      path.join(dir, key, "rudder-native"),
+      path.join(dir, key, "rudder-native.exe"),
+      path.join(dir, "native-dist", key, "rudder-native"),
+      path.join(dir, "native-dist", key, "rudder-native.exe"),
+    ];
+    const src = candidates.find((candidate) => fs.existsSync(candidate)) ?? findNestedNativeBinary(dir);
+    if (!src) {
+      continue;
+    }
+    const name = src.endsWith(".exe") ? "rudder-native.exe" : "rudder-native";
+    copyExecutable(src, path.join(distNativeDir, key, name));
+    copied += 1;
+  }
+  return copied;
+}
+
+function findNestedNativeBinary(dir) {
+  const pending = [{ dir, depth: 0 }];
+  while (pending.length > 0) {
+    const current = pending.pop();
+    if (!current || current.depth > 4) {
+      continue;
+    }
+    for (const entry of fs.readdirSync(current.dir, { withFileTypes: true })) {
+      const full = path.join(current.dir, entry.name);
+      if (entry.isFile() && (entry.name === "rudder-native" || entry.name === "rudder-native.exe")) {
+        return full;
+      }
+      if (entry.isDirectory()) {
+        pending.push({ dir: full, depth: current.depth + 1 });
+      }
+    }
+  }
+  return undefined;
+}
+
+function removeLegacyFlatBinary() {
+  fs.rmSync(path.join(distNativeDir, "rudder-native"), { force: true });
+  fs.rmSync(path.join(distNativeDir, "rudder-native.exe"), { force: true });
+}
+
+copyCurrentBuild();
+copyPrebuiltArtifacts();
+removeLegacyFlatBinary();

package/scripts/postinstall.mjs

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+// Sets jj (Jujutsu), Rudder's workspace engine, up at install time so
+// `npm install -g @exla/rudder` is the only step. When jj is not on PATH it
+// fetches jj's own prebuilt release (checksum-pinned in dist/jj-binary.js) into
+// ~/.rudder/bin; Rudder puts that on PATH itself. The first `rudder` run does
+// the same thing, so anything skipped here (no network, --ignore-scripts, npx)
+// costs a few seconds later, never a failed install. Always exits 0.
+
+const TAG = "[rudder postinstall]";
+
+async function main() {
+  if (process.env.RUDDER_SKIP_POSTINSTALL) return;
+  // `sudo npm install -g` runs this as root, often with the user's HOME: a
+  // root-owned ~/.rudder would lock the user's own runs out of it. The first
+  // `rudder` run sets jj up as the user instead.
+  if (process.getuid?.() === 0) return;
+  let jj;
+  try {
+    jj = await import("../dist/jj-binary.js");
+  } catch {
+    return; // a source checkout before its first build
+  }
+  const source = await jj.ensureJjAvailable({ onInstall: (message) => console.log(`${TAG} ${message}`) });
+  if (!source) {
+    console.warn(`${TAG} jj was not set up now (${jj.managedJjInstallError()}); rudder will retry on its first run.`);
+  }
+}
+
+try {
+  await main();
+} catch (err) {
+  console.warn(`${TAG} jj setup skipped: ${err && err.message ? err.message : err}`);
+}
+process.exit(0);