@hmharness/cli 0.6.2 → 0.6.4

package/dist/main.js

@@ -658,6 +658,16 @@ flags:
         if (sub === 'status') {
             const up = await hmhWebUp(Number.isFinite(port) ? port : 7788);
             stdout.write(up ? t.webRunning(readWebPid() || 0, port) + '\n' : t.webNotRunning + '\n');
+            // stale-daemon warning: the daemon is a code snapshot from spawn time;
+            // after an upgrade it keeps serving old code until restarted
+            const { webDaemonStale } = await import("./web-daemon.js");
+            const v = webDaemonStale();
+            if (up && v.stale) {
+                stdout.write(YELLOW(`⚠ daemon is running v${v.daemon} but CLI is v${v.cli} — stale code (new features missing). Run: hmh web stop && hmh web start\n`));
+            }
+            else if (up && v.daemon) {
+                stdout.write(DIM(`daemon v${v.daemon}\n`));
+            }
             return;
         }
         if (sub === 'start') {

package/dist/web-daemon.d.ts

@@ -10,8 +10,18 @@ export declare function stopWebDaemon(): boolean;
  * Idempotent: if our web UI is already up (pid file alive, or the port
  * answers as hmh), keep it; otherwise spawn it and wait up to ~6s for
  * readiness. Returns true when the web UI is usable.
+ *
+ * Version check: a daemon spawned by an older CLI keeps serving old code
+ * (the user sees missing features for days). We compare the recorded daemon
+ * version with the current CLI and restart on mismatch.
  */
 export declare function ensureWebDaemon(port?: number, entry?: string): Promise<boolean>;
+/** Report whether the running daemon matches the current CLI version. */
+export declare function webDaemonStale(): {
+    stale: boolean;
+    daemon: string;
+    cli: string;
+};
 export declare function startWebDaemon(port?: number, entry?: string): {
     already: boolean;
     pid: number;

package/dist/web-daemon.js

@@ -3,9 +3,16 @@
  * Shared by `hmh web start|stop|status` and the TUI auto-link (hmh tui
  * brings the web UI up unless --no-web). One pid file + one log file under
  * HMH_HOME; the daemon runs detached with no window and survives terminals.
+ *
+ * VERSION-AWARE (this bit me twice): a daemon is a code snapshot frozen at
+ * spawn time. After `npm i -g @hmharness/cli@X` the running daemon still
+ * serves the OLD code — new features silently missing, and the user sees
+ * stale behavior forever. `ensureWebDaemon` now compares the daemon's
+ * recorded version against the running CLI and auto-restarts on mismatch.
  */
 import { spawn } from 'node:child_process';
 import { execSync } from 'node:child_process';
+import { createRequire } from 'node:module';
 import { openSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { homeDir } from '@hmharness/kernel';
@@ -90,7 +97,8 @@ export function stopWebDaemon() {
     }
     return killed;
 }
-/** Spawn the daemon (no window, detached). Returns the pid. */
+/** Spawn the daemon (no window, detached). Returns the pid. Records the
+ *  spawning CLI's version so a later upgrade can detect the stale snapshot. */
 function spawnWebDaemon(port, entry = process.argv[1]) {
     const home = homeDir();
     const log = openSync(join(home, 'web.log'), 'a');
@@ -102,21 +110,57 @@ function spawnWebDaemon(port, entry = process.argv[1]) {
     });
     child.unref();
     const pid = child.pid ?? 0;
-    if (pid > 0)
+    if (pid > 0) {
         writeFileSync(join(home, 'web.pid'), String(pid));
+        try {
+            const v = createRequire(import.meta.url)('../package.json').version;
+            writeFileSync(join(home, 'web.version'), v);
+        }
+        catch { /* best effort */ }
+    }
     return pid;
 }
+function daemonVersion() {
+    try {
+        return readFileSync(join(homeDir(), 'web.version'), 'utf8').trim();
+    }
+    catch {
+        return '';
+    }
+}
+function cliVersion() {
+    try {
+        return createRequire(import.meta.url)('../package.json').version;
+    }
+    catch {
+        return '';
+    }
+}
 /**
  * Idempotent: if our web UI is already up (pid file alive, or the port
  * answers as hmh), keep it; otherwise spawn it and wait up to ~6s for
  * readiness. Returns true when the web UI is usable.
+ *
+ * Version check: a daemon spawned by an older CLI keeps serving old code
+ * (the user sees missing features for days). We compare the recorded daemon
+ * version with the current CLI and restart on mismatch.
  */
 export async function ensureWebDaemon(port = DEFAULT_WEB_PORT, entry = process.argv[1]) {
     const pid = readWebPid();
-    if (pid && alive(pid))
-        return true;
-    if (await hmhWebUp(port))
-        return true;
+    const daemonV = daemonVersion();
+    const myV = cliVersion();
+    const stale = daemonV !== '' && myV !== '' && daemonV !== myV;
+    if (!stale) {
+        if (pid && alive(pid))
+            return true;
+        if (await hmhWebUp(port))
+            return true;
+    }
+    else {
+        // stale daemon: kill it (it may hold the pid OR just the port)
+        stopWebDaemon();
+        await new Promise((r) => setTimeout(r, 600));
+    }
     spawnWebDaemon(port, entry);
     for (let i = 0; i < 12; i++) {
         await new Promise((r) => setTimeout(r, 500));
@@ -125,6 +169,12 @@ export async function ensureWebDaemon(port = DEFAULT_WEB_PORT, entry = process.a
     }
     return false;
 }
+/** Report whether the running daemon matches the current CLI version. */
+export function webDaemonStale() {
+    const d = daemonVersion();
+    const c = cliVersion();
+    return { stale: d !== '' && c !== '' && d !== c, daemon: d, cli: c };
+}
 export function startWebDaemon(port = DEFAULT_WEB_PORT, entry = process.argv[1]) {
     const pid = readWebPid();
     if (pid && alive(pid))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmharness/cli",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "hmharness command line: one-shot tasks, an interactive REPL, a fullscreen TUI, the web frontend, and direct tool invocation.",
   "type": "module",
   "main": "dist/main.js",
@@ -43,11 +43,11 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@hmharness/kernel": "0.6.2",
-    "@hmharness/evolution": "0.6.2",
-    "@hmharness/domain-harmony": "0.6.2",
-    "@hmharness/domain-ops": "0.6.2",
-    "@hmharness/agent": "0.6.2",
-    "@hmharness/web": "0.6.2"
+    "@hmharness/kernel": "0.6.4",
+    "@hmharness/evolution": "0.6.4",
+    "@hmharness/domain-harmony": "0.6.4",
+    "@hmharness/domain-ops": "0.6.4",
+    "@hmharness/agent": "0.6.4",
+    "@hmharness/web": "0.6.4"
   }
 }