@hmharness/cli 0.4.0 → 0.4.2

package/dist/tui.d.ts

@@ -39,6 +39,9 @@ export declare class TuiRuntime {
     private cwdName;
     private skillCount;
     private t;
+    /** installed hmharness version, shown in the header (v0.4.0 style);
+     *  defaults to the running build so even a bare runtime identifies itself */
+    private version;
     /** persistent header tag, e.g. the active approval mode (🔥 YOLO) */
     private modeTag;
     /** rows for the `/model ` picker (configured providers first, set by driver) */
@@ -89,11 +92,15 @@ export declare class TuiRuntime {
     /** The palette data source: `/model ` opens the model picker, otherwise
      *  slash commands. Rows are {name, desc} so both share one renderer. */
     private panelItems;
-    configure(model: string, cwdName: string, skillCount: number, locale: Locale): void;
+    configure(model: string, cwdName: string, skillCount: number, locale: Locale, version?: string): void;
     destroy(): void;
     waitExit(): Promise<void>;
     private quit;
     addText(text: string, style?: 'dim' | 'plain' | 'err'): void;
+    /** The user's own input, chat-style: separated by a blank line above and
+     *  below, right-aligned to the terminal width so it reads as "the human
+     *  side" against left-aligned model output. */
+    addUser(text: string): void;
     startStream(kind: 'think' | 'say'): (chunk: string) => void;
     /** Collapse a streamed thinking block to its final folded summary line. */
     foldThinking(): void;

package/dist/tui.js

@@ -11,11 +11,22 @@
  * Not a TTY? Prints a pointer to the plain REPL instead.
  */
 import { stdin, stdout } from 'node:process';
-import { basename } from 'node:path';
+import { basename, join } from 'node:path';
+import { createRequire } from 'node:module';
 import { loadConfig, homeDir, resolveProvider, listProviders, setChatRoute, setLocale, PROVIDER_PRESETS, addProviders, detectLocalProviders } from '@hmharness/kernel';
 import { listDrafts, listSkills, runBench, runEvolution } from '@hmharness/evolution';
 import { buildRegistry, runAgentTask, strings } from '@hmharness/agent';
 import { ensureWebDaemon, DEFAULT_WEB_PORT } from "./web-daemon.js";
+/** installed version, shown in the TUI header (v0.4.0) so users always
+ *  know which build they are talking to - resolves in both src/ and dist/ */
+const HMH_VERSION = (() => {
+    try {
+        return createRequire(import.meta.url)('../package.json').version;
+    }
+    catch {
+        return '';
+    }
+})();
 const RESET = '\x1b[0m';
 const DIM = (s) => `\x1b[2m${s}${RESET}`;
 const BOLD = (s) => `\x1b[1m${s}${RESET}`;
@@ -91,6 +102,7 @@ export const COMMANDS = [
     { name: '/bench', key: 'cmdBench' },
     { name: '/evolve', key: 'cmdEvolve' },
     { name: '/mcp', key: 'cmdMcp' },
+    { name: '/resume', key: 'cmdResume' },
     { name: '/status', key: 'cmdStatus' },
     { name: '/clear', key: 'cmdClear' },
     { name: '/web', key: 'cmdWeb' },
@@ -148,6 +160,9 @@ export class TuiRuntime {
     cwdName = '';
     skillCount = 0;
     t = strings();
+    /** installed hmharness version, shown in the header (v0.4.0 style);
+     *  defaults to the running build so even a bare runtime identifies itself */
+    version = HMH_VERSION;
     /** persistent header tag, e.g. the active approval mode (🔥 YOLO) */
     modeTag = '';
     /** rows for the `/model ` picker (configured providers first, set by driver) */
@@ -270,11 +285,12 @@ export class TuiRuntime {
         }
         return matchCommands(input).map((c) => ({ name: c.name, desc: String(this.t[c.key]) }));
     }
-    configure(model, cwdName, skillCount, locale) {
+    configure(model, cwdName, skillCount, locale, version) {
         this.model = model;
         this.cwdName = cwdName;
         this.skillCount = skillCount;
         this.t = strings(locale);
+        this.version = version ?? HMH_VERSION;
         this.dirty = true;
     }
     destroy() {
@@ -303,6 +319,21 @@ export class TuiRuntime {
         this.scrollFromBottom = 0;
         this.dirty = true;
     }
+    /** The user's own input, chat-style: separated by a blank line above and
+     *  below, right-aligned to the terminal width so it reads as "the human
+     *  side" against left-aligned model output. */
+    addUser(text) {
+        const width = Math.max(20, (stdout.columns || 100) - 2);
+        const lines = [''];
+        for (const l of wrapTo(text.replace(/\n+/g, ' '), width)) {
+            const pad = Math.max(1, width - strWidth(l));
+            lines.push(' '.repeat(pad) + BOLD(l));
+        }
+        lines.push('');
+        this.entries.push({ lines });
+        this.scrollFromBottom = 0;
+        this.dirty = true;
+    }
     startStream(kind) {
         const width = Math.max(20, (stdout.columns || 100) - 2);
         const lines = [];
@@ -626,7 +657,7 @@ export class TuiRuntime {
         // old right slot kept showing a stale "idle" - an orphan status.
         // Moving a thing means deleting it from where it was).
         // The ONLY live run indicator is the status line above the input box.
-        const headLeft = ` ${BOLD('⚙ hmh')} ${DIM('·')} ${CYAN(this.model)} ${DIM('·')} ${this.cwdName} ${DIM('·')} ${this.skillCount} ${this.t.tuiSkills}` + (this.modeTag ? ` ${this.modeTag}` : '');
+        const headLeft = ` ${BOLD('⚙ hmh')}${this.version ? ` ${DIM('v' + this.version)}` : ''} ${DIM('·')} ${CYAN(this.model)} ${DIM('·')} ${this.cwdName} ${DIM('·')} ${this.skillCount} ${this.t.tuiSkills}` + (this.modeTag ? ` ${this.modeTag}` : '');
         frame.push(truncateTo(headLeft, W));
         frame.push(DIM('─'.repeat(W)));
         const allLines = [];
@@ -824,7 +855,7 @@ export async function tui(yes, noWeb = false) {
     const rt = new TuiRuntime();
     const skills = await listSkills(home);
     const chatModel = resolveProvider(cfg, 'chat').model;
-    rt.configure(chatModel, basename(process.cwd()), skills.length, (cfg.locale ?? 'zh'));
+    rt.configure(chatModel, basename(process.cwd()), skills.length, (cfg.locale ?? 'zh'), HMH_VERSION);
     rt.setModelChoices(listProviders(cfg).map((v) => ({ name: v.name, desc: `${v.model}${v.purposes.length ? ' (' + v.purposes.join('/') + ')' : ''}` })));
     if (autoApprove)
         rt.setModeTag('🔥');
@@ -891,6 +922,47 @@ export async function tui(yes, noWeb = false) {
             rt.addText(up ? t.tuiWebLinked(DEFAULT_WEB_PORT) : t.tuiWebHint, 'dim');
             return;
         }
+        if (line === '/resume' || line.startsWith('/resume ')) {
+            const arg = line.slice(8).trim();
+            const { latestSession, loadTranscript } = await import('@hmharness/kernel');
+            if (!arg) {
+                // list the 8 newest sessions: id prefix (enough to disambiguate) + first user line
+                const { readdir } = await import('node:fs/promises');
+                let files = [];
+                try {
+                    files = (await readdir(join(home, 'sessions'))).filter((f) => f.endsWith('.jsonl'));
+                }
+                catch { /* none */ }
+                files.sort();
+                const recent = files.slice(-8).reverse();
+                if (recent.length === 0) {
+                    rt.addText(t.cmdResumeNone, 'dim');
+                    return;
+                }
+                for (const f of recent) {
+                    try {
+                        const tr = await loadTranscript(join(home, 'sessions', f));
+                        const firstUser = tr?.messages.find((m) => m.role === 'user')?.content ?? '';
+                        rt.addText(`${CYAN(f.slice(0, 18))}  ${(firstUser || '(no user line)').replace(/\n/g, ' ').slice(0, 60)}`, 'dim');
+                    }
+                    catch { /* skip unreadable */ }
+                }
+                rt.addText(t.cmdResumeHint, 'dim');
+                return;
+            }
+            const file = await latestSession(home, arg);
+            const tr = file ? await loadTranscript(file) : null;
+            if (!tr || tr.messages.length === 0) {
+                rt.addText(t.cmdResumeNotFound(arg), 'err');
+                return;
+            }
+            history = tr.messages;
+            const firstUser = tr.messages.find((m) => m.role === 'user')?.content ?? '';
+            rt.clearScreen();
+            rt.addUser(firstUser.replace(/\n/g, ' ').slice(0, 120));
+            rt.addText(t.cmdResumeLoaded(tr.messages.length), 'dim');
+            return;
+        }
         if (line === '/yolo' || line === '/yolo on' || line === '/yolo off') {
             const turnOn = line === '/yolo' ? !autoApprove : line === '/yolo on';
             autoApprove = turnOn;
@@ -902,7 +974,7 @@ export async function tui(yes, noWeb = false) {
             const target = nextLocale(cfg.locale ?? 'zh', line.slice(5));
             cfg = await setLocale(target);
             t = strings(target);
-            rt.configure(chatModel, basename(process.cwd()), skills.length, target);
+            rt.configure(chatModel, basename(process.cwd()), skills.length, target, HMH_VERSION);
             rt.addText(GREEN('✓') + ' ' + t.langSwitched(target));
             return;
         }
@@ -1039,7 +1111,7 @@ export async function tui(yes, noWeb = false) {
             }
             return;
         }
-        rt.addText(`❯ ${line}`);
+        rt.addUser(line);
         rt.setBusy(true, t.running);
         let appender = null;
         let kind = null;
@@ -1068,11 +1140,17 @@ export async function tui(yes, noWeb = false) {
                             rt.foldThinking();
                         appender = null;
                         kind = null;
-                        rt.addText(`${YELLOW('●')} ${CYAN(name)} ${DIM(JSON.stringify(args).slice(0, 100))}`);
+                        // fold the args to their essence: for run_command the command
+                        // string itself, otherwise a short JSON tail
+                        const brief = name === 'run_command' && typeof args.command === 'string'
+                            ? args.command
+                            : JSON.stringify(args);
+                        rt.addText(`${YELLOW('●')} ${CYAN(name)} ${DIM(brief.replace(/\s+/g, ' ').slice(0, 90))}`);
                     },
                     onToolResult: (name, output, isError) => {
                         const dot = isError ? RED('✗') : GREEN('•');
-                        rt.addText(`  ${dot} ${DIM('⎿ ' + output.split('\n').slice(0, 2).join(' ').slice(0, 110))}`);
+                        const first = output.split('\n').find((l) => l.trim()) ?? '';
+                        rt.addText(`  ${dot} ${DIM('⎿ ' + first.trim().slice(0, 100))}`);
                     },
                 },
             });

package/dist/web-daemon.d.ts

@@ -1,6 +1,9 @@
 export declare const DEFAULT_WEB_PORT = 7788;
 export declare function readWebPid(): number;
-/** cheap probe: does OUR server answer on the port (not just any listener)? */
+/** cheap probe: does OUR server answer on the port (not just any listener)?
+ *  Accepts ANY hmh /api/state shape - a daemon from an older build still
+ *  serves the UI, and rejecting it made the TUI auto-link spawn a fresh
+ *  daemon that died on EADDRINUSE every startup (the "lost setting" bug). */
 export declare function hmhWebUp(port: number): Promise<boolean>;
 export declare function stopWebDaemon(): boolean;
 /**

package/dist/web-daemon.js

@@ -5,6 +5,7 @@
  * HMH_HOME; the daemon runs detached with no window and survives terminals.
  */
 import { spawn } from 'node:child_process';
+import { execSync } from 'node:child_process';
 import { openSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { homeDir } from '@hmharness/kernel';
@@ -27,41 +28,67 @@ function alive(pid) {
         return false;
     }
 }
-/** cheap probe: does OUR server answer on the port (not just any listener)? */
+/** cheap probe: does OUR server answer on the port (not just any listener)?
+ *  Accepts ANY hmh /api/state shape - a daemon from an older build still
+ *  serves the UI, and rejecting it made the TUI auto-link spawn a fresh
+ *  daemon that died on EADDRINUSE every startup (the "lost setting" bug). */
 export async function hmhWebUp(port) {
     try {
         const r = await fetch(`http://127.0.0.1:${port}/api/state`, { signal: AbortSignal.timeout(1500) });
         if (!r.ok)
             return false;
-        const d = (await r.json());
-        return typeof d.model === 'string';
+        const d = await r.json();
+        return !!d && typeof d === 'object';
     }
     catch {
         return false;
     }
 }
-export function stopWebDaemon() {
-    const pid = readWebPid();
-    if (!pid || !alive(pid)) {
-        try {
-            unlinkSync(join(homeDir(), 'web.pid'));
+/** Windows-first: find the PID LISTENING on 127.0.0.1:<port> via netstat.
+ *  Used to reclaim a port held by an orphaned/old daemon whose pid file is
+ *  stale - `hmh web stop` must be able to evict it, or restarts never heal. */
+function portOwnerPid(port) {
+    if (process.platform !== 'win32')
+        return 0;
+    try {
+        const out = execSync(`netstat -ano -p tcp`, { encoding: 'utf8', timeout: 5000 });
+        for (const line of out.split('\n')) {
+            const m = line.trim().match(new RegExp(`^(TCP)\\s+\\S*?:${port}\\s+\\S+\\s+LISTENING\\s+(\\d+)$`));
+            if (m)
+                return Number(m[2]);
         }
-        catch { /* absent */ }
-        return false;
     }
-    if (process.platform === 'win32')
-        spawn('taskkill', ['/PID', String(pid), '/T', '/F'], { windowsHide: true });
-    else {
-        try {
-            process.kill(pid);
+    catch { /* netstat unavailable - give up quietly */ }
+    return 0;
+}
+export function stopWebDaemon() {
+    const pid = readWebPid();
+    let killed = false;
+    if (pid && alive(pid)) {
+        if (process.platform === 'win32')
+            spawn('taskkill', ['/PID', String(pid), '/T', '/F'], { windowsHide: true });
+        else {
+            try {
+                process.kill(pid);
+            }
+            catch { /* gone */ }
         }
-        catch { /* gone */ }
+        killed = true;
     }
     try {
         unlinkSync(join(homeDir(), 'web.pid'));
     }
     catch { /* absent */ }
-    return true;
+    // stale pid file but the port is still held (orphaned/old daemon): evict
+    const owner = portOwnerPid(DEFAULT_WEB_PORT);
+    if (owner && owner !== pid) {
+        try {
+            spawn('taskkill', ['/PID', String(owner), '/T', '/F'], { windowsHide: true });
+            killed = true;
+        }
+        catch { /* best effort */ }
+    }
+    return killed;
 }
 /** Spawn the daemon (no window, detached). Returns the pid. */
 function spawnWebDaemon(port, entry = process.argv[1]) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmharness/cli",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "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.4.0",
-    "@hmharness/evolution": "0.4.0",
-    "@hmharness/domain-harmony": "0.4.0",
-    "@hmharness/domain-ops": "0.4.0",
-    "@hmharness/agent": "0.4.0",
-    "@hmharness/web": "0.4.0"
+    "@hmharness/kernel": "0.4.2",
+    "@hmharness/evolution": "0.4.2",
+    "@hmharness/domain-harmony": "0.4.2",
+    "@hmharness/domain-ops": "0.4.2",
+    "@hmharness/agent": "0.4.2",
+    "@hmharness/web": "0.4.2"
   }
 }