cxstatusline 0.9.0 → 0.10.0

package/README.md

@@ -31,7 +31,7 @@
 - [🚀 Install](#-install)
 - [🎛️ Configure](#️-configure)
 - [🧩 Widgets Catalog](#widgets)
-- [🔄 Update & Revert](#update)
+- [🔄 Update, Upgrade & Revert](#update)
 - [🔍 How it Works](#-how-it-works)
 - [🏷️ Supported Versions](#supported-versions)
 - [🩺 Troubleshooting](#-troubleshooting)
@@ -81,7 +81,7 @@ cxstatusline doctor
 
 `cxstatusline install` downloads the verified prebuilt binary matching your Codex version, verifies checksums against `manifest.json`, and activates it.
 - **Interactive selection**: Running `cxstatusline install` opens a keyboard-driven version picker. Use ↑/↓ and Enter to select, or Escape/Ctrl+C to cancel. Prebuilt availability is shown per version; source-only choices require confirmation (unless you already passed `--compile`).
-- **Update choices**: `cxstatusline update` uses the same keyboard controls to choose the latest supported prebuilt, a supported source build, or cancellation. It does not update upstream Codex first.
+- **Upgrade choices**: `cxstatusline upgrade` uses the same keyboard controls to choose the latest supported prebuilt, a supported source build, or cancellation. It does not update upstream Codex first.
 - **Live progress**: Ink renders download progress in terminals while completed stages remain in the transcript. Source builds report their phases; redirected output retains plain milestone logs.
 - **Target a specific version**: `cxstatusline install --codex-version <version>` (e.g. `cxstatusline install --codex-version 0.154.0`).
 - **Non-interactive / CI**: Pass `-y` or `--yes` to accept the default without prompting.
@@ -147,19 +147,35 @@ Type IDs match ccstatusline's, so a ccstatusline preset imports without translat
 👉 The full catalog, and how Custom Command handles timeouts, colours and background caching, are in
 the **[Usage guide](docs/usage.md)**.
 
-## Update
+## Update & Upgrade
+
+cxstatusline follows the Homebrew paradigm for managing updates:
+- **`cxstatusline update`**: Updates the **cxstatusline CLI tool itself** to the latest release (via npm, bun, or git).
+- **`cxstatusline upgrade`**: Upgrades the **patched Codex binary pair** to the latest supported release.
+
+### Updating cxstatusline (The Tool)
 
 ```sh
-cxstatusline update
+cxstatusline update          # Updates cxstatusline to the latest version
+cxstatusline update --check  # Checks for available tool updates without installing
 ```
 
-`cxstatusline update` downloads and verifies the latest published prebuilt supported by your cxstatusline package, then activates the complete patched Codex pair. It does not run Codex's self-updater or modify your original Codex installation. Open a new Codex session afterward.
+`cxstatusline update` automatically detects your install method (`npm`, `bun`, or `git checkout`) and updates the CLI tool.
+
+### Upgrading Patched Codex
 
-The same Codex version is checked for rebuilt patch assets; a newer installed version is never downgraded. If discovery or verification fails, the active pair stays in place. Update the cxstatusline npm package to pick up support for newer Codex versions.
+```sh
+cxstatusline upgrade
+```
+
+`cxstatusline upgrade` downloads and verifies the latest published prebuilt supported by your cxstatusline package, then activates the complete patched Codex pair. It does not run Codex's self-updater or modify your original Codex installation. Open a new Codex session afterward.
+
+The same Codex version is checked for rebuilt patch assets; a newer installed version is never downgraded. If discovery or verification fails, the active pair stays in place. When running `upgrade`, if a newer version of `cxstatusline` is available, it will display a friendly reminder to run `cxstatusline update` first.
 
 Options:
-- `cxstatusline update --compile`: builds the latest locally supported Codex patch from source instead.
+- `cxstatusline upgrade --compile`: builds the latest locally supported Codex patch from source instead.
 - `--force`, `-y`, and `--yes` remain accepted for compatibility; updates already run without a prompt and always verify the pair.
+- Note: Running `cxstatusline update --compile` or `--force` will automatically forward to `cxstatusline upgrade` with a notice.
 
 Session-start updates also leave a newer patched pair in place when the original Codex installation is older, including under the `every` policy.
 
@@ -246,3 +262,12 @@ cxstatusline is [MIT licensed](LICENSE). See [SECURITY.md](SECURITY.md) for secu
 - 🌐 **Web Playground:** [cxstatusline.adrijshikhar.dev](https://cxstatusline.adrijshikhar.dev)
 - 💬 **Discussions & Ideas:** [github.com/adrijshikhar/cxstatusline/discussions](https://github.com/adrijshikhar/cxstatusline/discussions)
 - 📦 **npm Package:** [npmjs.com/package/cxstatusline](https://www.npmjs.com/package/cxstatusline)
+
+### Prebuilt build machine
+
+All Codex prebuilt jobs run on the owner's M5 Pro (`192.168.1.65`, Actions labels
+`self-hosted`, `macOS`, `ARM64`, `m5-pro`). macOS builds natively; Linux builds in
+Docker on that same M5. Keep the laptop and runner active until the workflow finishes.
+An offline M5 leaves jobs queued; there is no hosted fallback. Platform builds run
+sequentially, preserving 3 native Rust compiler jobs and 8 inside Docker. Dispatch from a ref containing this policy;
+older release tags may still contain the removed hosted-runner option.

package/dist/cxstatusline.js

@@ -59007,8 +59007,8 @@ function runRefreshCommand(cacheKey2, deps) {
   return 0;
 }
 // src/version-info.ts
-var VERSION = "0.9.0";
-var SOURCE_COMMIT = /^[0-9a-f]{40}$/.test("6a7b82efae2605ec4e4346c7d482b7d5b7734347") ? "6a7b82efae2605ec4e4346c7d482b7d5b7734347" : null;
+var VERSION = "0.10.0";
+var SOURCE_COMMIT = /^[0-9a-f]{40}$/.test("2a36f98f9f4d2b98638cc4ba9380253e1407c9bf") ? "2a36f98f9f4d2b98638cc4ba9380253e1407c9bf" : null;
 var SOURCE_DIRTY = false;
 
 // src/context.ts
@@ -64202,7 +64202,7 @@ function wrapperScript(patchedBin, cxBin) {
     WRAPPER_MARKER,
     "# Managed by cxstatusline. `cxstatusline revert` restores stock Codex.",
     `if [ "$1" = "update" ]; then`,
-    `  exec ${sq(cxBin)} update`,
+    `  exec ${sq(cxBin)} upgrade`,
     "fi",
     `CXSTATUSLINE_COMMAND=${sq(`${sq(cxBin)} render`)}`,
     "export CXSTATUSLINE_COMMAND",
@@ -64217,7 +64217,7 @@ function generationWrapperScript(currentGeneration, cxBin) {
     WRAPPER_MARKER_V2,
     "# Managed by cxstatusline. `cxstatusline revert` restores stock Codex.",
     `if [ "$1" = "update" ]; then`,
-    `  exec ${sq(cxBin)} update`,
+    `  exec ${sq(cxBin)} upgrade`,
     "fi",
     `CXSTATUSLINE_COMMAND=${sq(`${sq(cxBin)} render`)}`,
     "export CXSTATUSLINE_COMMAND",
@@ -68465,6 +68465,154 @@ function readMemoryUsage(deps, nowMs) {
   }
 }
 
+// src/commands/update-tool.ts
+import { spawnSync as spawnSync5 } from "node:child_process";
+import { existsSync as existsSync17, realpathSync as realpathSync4 } from "node:fs";
+import { dirname as dirname11, join as join23 } from "node:path";
+async function defaultFetchLatestVersion() {
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), 5000);
+  try {
+    const res = await fetch("https://registry.npmjs.org/cxstatusline/latest", {
+      headers: { Accept: "application/json" },
+      signal: controller.signal
+    });
+    if (!res.ok)
+      return null;
+    const data = await res.json();
+    return typeof data.version === "string" ? data.version : null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function detectInstallType(binaryPath = process.argv[1]) {
+  if (!binaryPath)
+    return { type: "npm" };
+  try {
+    let resolved = binaryPath;
+    try {
+      resolved = realpathSync4(binaryPath);
+    } catch {}
+    let dir = dirname11(resolved);
+    for (let i = 0;i < 5; i++) {
+      if (existsSync17(join23(dir, ".git")) && existsSync17(join23(dir, "package.json"))) {
+        return { type: "git", repoDir: dir };
+      }
+      const parent = dirname11(dir);
+      if (parent === dir)
+        break;
+      dir = parent;
+    }
+    if (binaryPath.includes(".bun") || resolved.includes(".bun")) {
+      return { type: "bun" };
+    }
+    if (binaryPath.includes("pnpm") || resolved.includes("pnpm")) {
+      return { type: "pnpm" };
+    }
+  } catch {}
+  return { type: "npm" };
+}
+function defaultExecCommand(cmd, args) {
+  const res = spawnSync5(cmd, args, { encoding: "utf8" });
+  return {
+    status: res.status ?? (res.error ? 1 : 0),
+    stdout: res.stdout || "",
+    stderr: res.stderr || (res.error ? res.error.message : "")
+  };
+}
+async function runUpdateTool(flags, io2, deps = {}) {
+  const checkOnly = flags.includes("--check");
+  const currentVersionStr = deps.currentVersion ?? VERSION;
+  const currentSemver = parseSemver(currentVersionStr);
+  if (!currentSemver) {
+    io2.stderr(`Invalid current version: ${currentVersionStr}
+`);
+    return 1;
+  }
+  io2.stdout(`Checking for cxstatusline updates...
+`);
+  const fetcher = deps.fetchLatestVersion ?? defaultFetchLatestVersion;
+  const latest = await fetcher();
+  if (!latest) {
+    io2.stderr(`Failed to check for updates: could not reach npm registry.
+`);
+    return 1;
+  }
+  const latestSemver = parseSemver(latest);
+  if (!latestSemver) {
+    io2.stderr(`Invalid version received from registry: ${latest}
+`);
+    return 1;
+  }
+  if (compareSemver(latestSemver, currentSemver) <= 0) {
+    io2.stdout(`cxstatusline is already up to date (${currentVersionStr}).
+`);
+    return 0;
+  }
+  if (checkOnly) {
+    io2.stdout(`Update available: ${currentVersionStr} -> ${latest}
+`);
+    io2.stdout("Run `cxstatusline update` to upgrade the tool.\n");
+    return 0;
+  }
+  const detector = deps.detectInstallType ?? (() => detectInstallType());
+  const installInfo = detector();
+  const exec2 = deps.execCommand ?? defaultExecCommand;
+  if (installInfo.type === "git" && installInfo.repoDir) {
+    io2.stdout(`Updating cxstatusline from git repository at ${installInfo.repoDir}...
+`);
+    const pull2 = exec2("git", ["-C", installInfo.repoDir, "pull", "origin", "main"]);
+    if (pull2.status !== 0) {
+      io2.stderr(`Failed to update cxstatusline via git pull:
+${pull2.stderr || pull2.stdout}
+`);
+      return 1;
+    }
+    const install2 = exec2("bun", ["--cwd", installInfo.repoDir, "install", "--frozen-lockfile"]);
+    if (install2.status !== 0) {
+      io2.stderr(`Failed to run bun install in repo:
+${install2.stderr || install2.stdout}
+`);
+      return 1;
+    }
+    const build = exec2("bun", ["--cwd", installInfo.repoDir, "run", "build"]);
+    if (build.status !== 0) {
+      io2.stderr(`Failed to build cxstatusline in repo:
+${build.stderr || build.stdout}
+`);
+      return 1;
+    }
+    io2.stdout(`Successfully updated cxstatusline from git checkout.
+`);
+    return 0;
+  }
+  let command = "npm";
+  let args = ["install", "-g", "cxstatusline@latest"];
+  if (installInfo.type === "bun") {
+    command = "bun";
+    args = ["add", "-g", "cxstatusline@latest"];
+  } else if (installInfo.type === "pnpm") {
+    command = "pnpm";
+    args = ["add", "-g", "cxstatusline@latest"];
+  }
+  io2.stdout(`Updating cxstatusline via ${command} (${command} ${args.join(" ")})...
+`);
+  const result2 = exec2(command, args);
+  if (result2.status !== 0) {
+    io2.stderr(`Failed to update cxstatusline:
+${result2.stderr || result2.stdout}
+`);
+    io2.stderr(`You can try updating manually with: ${command} ${args.join(" ")}
+`);
+    return 1;
+  }
+  io2.stdout(`Successfully updated cxstatusline to ${latest}.
+`);
+  return 0;
+}
+
 // src/main.ts
 var USAGE = `usage: cxstatusline [command]
 
@@ -68474,7 +68622,8 @@ var USAGE = `usage: cxstatusline [command]
                               install the published Codex pair (--compile builds it from source)
   patch [--force]             build and install the patched Codex from source
   patch --simulate-drift <v>  record <v> as the installed version so the next session sees drift
-  update [--compile|--force]  install the latest supported patched Codex pair
+  update [--check]            update cxstatusline tool to the latest version
+  upgrade [--compile|--force] upgrade the patched Codex pair to the latest supported version
   hook [install|uninstall]    manage the SessionStart entry; bare 'hook' is what Codex runs
   doctor                      report toolchain, drift, hook and wrapper state
   policy [get|set <policy>]   view or update policy (every, stable-minors, manual)
@@ -68617,12 +68766,44 @@ async function installCommand(argv, io2, deps) {
   return runInstall(ctx, { compile: compile3, codexVersion }, deps.transport);
 }
 async function updateCommand(argv, io2, deps) {
+  const flags = argv.slice(1);
+  const codexFlags = new Set(["--compile", "--force", "-y", "--yes"]);
+  if (flags.some((f2) => codexFlags.has(f2) || f2.startsWith("--codex-version"))) {
+    io2.stdout(`Notice: 'cxstatusline upgrade' is now used to upgrade the patched Codex pair.
+Forwarding to 'upgrade'...
+
+`);
+    return upgradeCommand(argv, io2, deps);
+  }
+  const allowed = new Set(["--check", "-h", "--help"]);
+  if (flags.some((f2) => !allowed.has(f2))) {
+    io2.stderr(USAGE);
+    return 2;
+  }
+  const updater = deps.updateTool ?? runUpdateTool;
+  return updater(flags, io2, { fetchLatestVersion: deps.fetchLatestToolVersion });
+}
+async function upgradeCommand(argv, io2, deps) {
   const flags = argv.slice(1);
   const allowed = new Set(["--compile", "--force", "-y", "--yes"]);
   if (flags.some((f2) => !allowed.has(f2))) {
     io2.stderr(USAGE);
     return 2;
   }
+  try {
+    const latest = await (deps.fetchLatestToolVersion ?? defaultFetchLatestVersion)();
+    if (latest) {
+      const parsedLatest = parseSemver(latest);
+      const parsedCurrent = parseSemver(VERSION);
+      if (parsedLatest && parsedCurrent && compareSemver(parsedLatest, parsedCurrent) === 1) {
+        io2.stdout(`
+\uD83D\uDCA1 Note: A newer version of cxstatusline is available (${VERSION} → ${latest}).
+   Run 'cxstatusline update' to update the tool for the newest Codex patches.
+
+`);
+      }
+    }
+  } catch {}
   return runUpdate(contextFor(io2, deps), {
     compile: flags.includes("--compile"),
     force: flags.includes("--force") || flags.includes("-y") || flags.includes("--yes"),
@@ -68693,6 +68874,8 @@ async function main(argv, io2, deps = {}) {
     return patchCommand(argv, io2, deps);
   if (cmd === "update")
     return updateCommand(argv, io2, deps);
+  if (cmd === "upgrade")
+    return upgradeCommand(argv, io2, deps);
   if (cmd === "install")
     return installCommand(argv, io2, deps);
   if (cmd === "hook" && (argv[1] === "install" || argv[1] === "uninstall")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cxstatusline",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Customizable statusline for OpenAI Codex CLI",
   "license": "MIT",
   "repository": {