@hmharness/cli 0.4.2 → 0.4.4

package/dist/tui.d.ts

@@ -46,6 +46,8 @@ export declare class TuiRuntime {
     private modeTag;
     /** rows for the `/model ` picker (configured providers first, set by driver) */
     private modelChoices;
+    /** rows for the `/resume ` session picker (id prefix + first user line) */
+    private sessionChoices;
     /** Wheel/click handling: NO mouse reporting by default - select/copy
      *  always works and terminals translate the wheel to arrow keys on the
      *  alternate screen. Reporting turns on ONLY while a palette is open
@@ -63,9 +65,16 @@ export declare class TuiRuntime {
         name: string;
         desc: string;
     }>): void;
+    setSessionChoices(list: Array<{
+        name: string;
+        desc: string;
+    }>): void;
     /** Focus the /model picker (used by the bare `/model` command so the
      *  printed list is never a dead end - the live palette opens on it). */
     openModelPicker(): void;
+    /** Focus the /resume session picker - same live palette as /model:
+     *  arrows/wheel navigate, Enter loads the highlighted session. */
+    openSessionPicker(): void;
     /** Run the highlighted palette row (shared by Enter and palette clicks);
      *  with no palette open it just submits the typed input. */
     private pickHighlighted;
@@ -89,8 +98,9 @@ export declare class TuiRuntime {
      *  while it shows, clicks choose its rows and the wheel drives its
      *  selection; drag-select resumes the moment it closes. */
     private syncMouseReporting;
-    /** The palette data source: `/model ` opens the model picker, otherwise
-     *  slash commands. Rows are {name, desc} so both share one renderer. */
+    /** The palette data source: `/model ` opens the model picker, `/resume `
+     *  the session picker, otherwise slash commands. Rows are {name, desc} so
+     *  all three share one renderer, keyboard and click machinery. */
     private panelItems;
     configure(model: string, cwdName: string, skillCount: number, locale: Locale, version?: string): void;
     destroy(): void;
@@ -114,4 +124,9 @@ export declare class TuiRuntime {
     private onKey;
     render(): void;
 }
+/** First user line of a session file WITHOUT a full parse: peek the first
+ *  64KB, scan lines for the first user event. With hundreds of sessions a
+ *  full loadTranscript per row would stall the picker for seconds; the user
+ *  event is always near the head, so the peek is O(64KB) per session. */
+export declare function firstUserLinePeek(file: string): Promise<string>;
 export declare function tui(yes: boolean, noWeb?: boolean): Promise<void>;

package/dist/tui.js

@@ -13,6 +13,7 @@
 import { stdin, stdout } from 'node:process';
 import { basename, join } from 'node:path';
 import { createRequire } from 'node:module';
+import { open as fopen } from 'node:fs/promises';
 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';
@@ -167,6 +168,8 @@ export class TuiRuntime {
     modeTag = '';
     /** rows for the `/model ` picker (configured providers first, set by driver) */
     modelChoices = [];
+    /** rows for the `/resume ` session picker (id prefix + first user line) */
+    sessionChoices = [];
     /** Wheel/click handling: NO mouse reporting by default - select/copy
      *  always works and terminals translate the wheel to arrow keys on the
      *  alternate screen. Reporting turns on ONLY while a palette is open
@@ -195,6 +198,10 @@ export class TuiRuntime {
         this.modelChoices = list;
         this.dirty = true;
     }
+    setSessionChoices(list) {
+        this.sessionChoices = list;
+        this.dirty = true;
+    }
     /** Focus the /model picker (used by the bare `/model` command so the
      *  printed list is never a dead end - the live palette opens on it). */
     openModelPicker() {
@@ -203,13 +210,26 @@ export class TuiRuntime {
         this.cmdIdx = 0;
         this.dirty = true;
     }
+    /** Focus the /resume session picker - same live palette as /model:
+     *  arrows/wheel navigate, Enter loads the highlighted session. */
+    openSessionPicker() {
+        this.input = '/resume ';
+        this.caret = this.input.length;
+        this.cmdIdx = 0;
+        this.dirty = true;
+    }
     /** Run the highlighted palette row (shared by Enter and palette clicks);
      *  with no palette open it just submits the typed input. */
     pickHighlighted() {
         const hits = this.panelItems(this.input);
         const pick = hits.length ? hits[Math.min(this.cmdIdx, hits.length - 1)].name : '';
         if (pick) {
-            this.input = this.input.startsWith('/model') ? `/model ${pick} ` : pick + ' ';
+            if (this.input.startsWith('/model'))
+                this.input = `/model ${pick} `;
+            else if (this.input.startsWith('/resume'))
+                this.input = `/resume ${pick}`;
+            else
+                this.input = pick + ' ';
             this.caret = this.input.length;
             this.cmdIdx = 0;
         }
@@ -271,8 +291,9 @@ export class TuiRuntime {
         this.mouseReported = want;
         stdout.write(want ? '\x1b[?1000h\x1b[?1006h' : '\x1b[?1000l\x1b[?1006l');
     }
-    /** The palette data source: `/model ` opens the model picker, otherwise
-     *  slash commands. Rows are {name, desc} so both share one renderer. */
+    /** The palette data source: `/model ` opens the model picker, `/resume `
+     *  the session picker, otherwise slash commands. Rows are {name, desc} so
+     *  all three share one renderer, keyboard and click machinery. */
     panelItems(input) {
         if (input === '/model' || input.startsWith('/model ')) {
             const q = input.slice(6).trim().toLowerCase();
@@ -283,6 +304,10 @@ export class TuiRuntime {
             const all = [...configured, ...rest];
             return q ? all.filter((i) => i.name.toLowerCase().startsWith(q)) : all;
         }
+        if (input === '/resume' || input.startsWith('/resume ')) {
+            const q = input.slice(7).trim().toLowerCase();
+            return q ? this.sessionChoices.filter((i) => i.name.toLowerCase().startsWith(q)) : this.sessionChoices;
+        }
         return matchCommands(input).map((c) => ({ name: c.name, desc: String(this.t[c.key]) }));
     }
     configure(model, cwdName, skillCount, locale, version) {
@@ -509,6 +534,12 @@ export class TuiRuntime {
                 this.openModelPicker();
                 return;
             }
+            // same two-stage rule for /resume: bare command + Enter opens the
+            // session picker (focus moves to the list), never loads row 0 blindly
+            if (this.input === '/resume') {
+                this.openSessionPicker();
+                return;
+            }
             // palette open: Enter runs the highlighted row (a command, or a
             // /model target), not the raw input; without a palette it submits
             this.pickHighlighted();
@@ -519,7 +550,9 @@ export class TuiRuntime {
             if (hits.length) {
                 this.input = this.input.startsWith('/model')
                     ? `/model ${hits[Math.min(this.cmdIdx, hits.length - 1)].name} `
-                    : hits[Math.min(this.cmdIdx, hits.length - 1)].name + ' ';
+                    : this.input.startsWith('/resume')
+                        ? `/resume ${hits[Math.min(this.cmdIdx, hits.length - 1)].name}`
+                        : hits[Math.min(this.cmdIdx, hits.length - 1)].name + ' ';
                 this.caret = this.input.length;
                 this.cmdIdx = 0;
                 this.dirty = true;
@@ -839,6 +872,34 @@ export class TuiRuntime {
     }
 }
 /* ---------------- driver ---------------- */
+/** First user line of a session file WITHOUT a full parse: peek the first
+ *  64KB, scan lines for the first user event. With hundreds of sessions a
+ *  full loadTranscript per row would stall the picker for seconds; the user
+ *  event is always near the head, so the peek is O(64KB) per session. */
+export async function firstUserLinePeek(file) {
+    try {
+        const fh = await fopen(file, 'r');
+        try {
+            const buf = Buffer.alloc(65_536);
+            const { bytesRead } = await fh.read(buf, 0, 65_536, 0);
+            for (const line of buf.toString('utf8', 0, bytesRead).split('\n')) {
+                if (!line.includes('"user"'))
+                    continue;
+                try {
+                    const ev = JSON.parse(line);
+                    if (ev.t === 'user' && typeof ev.text === 'string')
+                        return ev.text;
+                }
+                catch { /* partial line at the buffer edge - no preview */ }
+            }
+        }
+        finally {
+            await fh.close();
+        }
+    }
+    catch { /* unreadable file - no preview */ }
+    return '';
+}
 export async function tui(yes, noWeb = false) {
     let cfg = await loadConfig();
     let autoApprove = yes || cfg.approval === 'auto';
@@ -925,29 +986,33 @@ export async function tui(yes, noWeb = false) {
         if (line === '/resume' || line.startsWith('/resume ')) {
             const arg = line.slice(8).trim();
             const { latestSession, loadTranscript } = await import('@hmharness/kernel');
+            const { readdir } = await import('node:fs/promises');
+            // ALL sessions, newest first - no arbitrary "recent 8" cap (user
+            // challenge: "不应该是所有历史会话吗"). Previews use the 64KB peek,
+            // never a full parse, so hundreds of rows still open instantly; the
+            // palette scrolls and head-prefix filtering narrows fast.
+            let files = [];
+            try {
+                files = (await readdir(join(home, 'sessions'))).filter((f) => f.endsWith('.jsonl'));
+            }
+            catch { /* none */ }
+            files.sort();
+            const recent = files.reverse();
+            const rows = [];
+            for (const f of recent) {
+                const firstUser = await firstUserLinePeek(join(home, 'sessions', f));
+                rows.push({ name: f.slice(0, 18), desc: (firstUser || '(无预览)').replace(/\n/g, ' ').slice(0, 56) });
+            }
+            rt.setSessionChoices(rows);
             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) {
+                // bare /resume opens the LIVE picker - same arrows/wheel/Enter/click
+                // machinery as /model; a printed text list is a dead end (user-
+                // reported: "上下键无法选择")
+                if (rows.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');
+                rt.openSessionPicker();
                 return;
             }
             const file = await latestSession(home, arg);

package/package.json

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