very-happy-cli 0.2.100 → 0.2.102

package/dist/{types-DTVA1Hp-.cjs → types-7-mfp-j5.cjs}

@@ -51,7 +51,7 @@ var z__namespace = /*#__PURE__*/_interopNamespaceDefault(z);
 var pty__namespace = /*#__PURE__*/_interopNamespaceDefault(pty);
 
 var name = "very-happy-cli";
-var version = "0.2.100";
+var version = "0.2.102";
 var description = "Remote multi-agent workspace CLI with deep Claude integration, native terminal streaming, and self-hosting.";
 var author = "Kirill Dubovitskiy";
 var contributors = [
@@ -164,12 +164,12 @@ var dependencies = {
 	zod: "^4.0.0"
 };
 var optionalDependencies = {
-	"very-happy-tools-arm64-darwin": "0.2.100",
-	"very-happy-tools-x64-darwin": "0.2.100",
-	"very-happy-tools-arm64-linux": "0.2.100",
-	"very-happy-tools-x64-linux": "0.2.100",
-	"very-happy-tools-arm64-win32": "0.2.100",
-	"very-happy-tools-x64-win32": "0.2.100"
+	"very-happy-tools-arm64-darwin": "0.2.102",
+	"very-happy-tools-x64-darwin": "0.2.102",
+	"very-happy-tools-arm64-linux": "0.2.102",
+	"very-happy-tools-x64-linux": "0.2.102",
+	"very-happy-tools-arm64-win32": "0.2.102",
+	"very-happy-tools-x64-win32": "0.2.102"
 };
 var devDependencies = {
 	"@slopus/happy-wire": "workspace:*",
@@ -1585,7 +1585,7 @@ class RpcHandlerManager {
   }
 }
 
-const __dirname$1 = path$1.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('types-DTVA1Hp-.cjs', document.baseURI).href))));
+const __dirname$1 = path$1.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('types-7-mfp-j5.cjs', document.baseURI).href))));
 function projectPath() {
   const path = path$1.resolve(__dirname$1, "..");
   return path;
@@ -4809,6 +4809,10 @@ function registerTodoHandlers(manager) {
   });
 }
 
+function sanitizeGeometry(cols, rows) {
+  const ok = (v) => typeof v === "number" && Number.isInteger(v) && v >= 2 && v <= 1e4;
+  return ok(cols) && ok(rows) ? { cols, rows } : void 0;
+}
 function sanitizeTagList(value) {
   if (!Array.isArray(value)) return void 0;
   const out = [];
@@ -4828,7 +4832,7 @@ function sanitizeLiveSnapshot(raw, now, ttlMs = LIVE_SNAPSHOT_TTL_MS, max = LIVE
   const rows = [];
   for (const [id, value] of Object.entries(raw)) {
     if (!id || !value || typeof value !== "object") continue;
-    const { title, cwd, seenAt, tags, manual, attachTmux } = value;
+    const { title, cwd, seenAt, tags, manual, attachTmux, cols: rawCols, rows: rawRows } = value;
     if (typeof seenAt !== "number" || !Number.isFinite(seenAt)) continue;
     if (now - seenAt >= ttlMs) continue;
     const tagList = sanitizeTagList(tags);
@@ -4838,6 +4842,7 @@ function sanitizeLiveSnapshot(raw, now, ttlMs = LIVE_SNAPSHOT_TTL_MS, max = LIVE
       ...tagList !== void 0 ? { tags: tagList } : {},
       ...manual === true ? { manual: true } : {},
       ...typeof attachTmux === "string" && attachTmux ? { attachTmux } : {},
+      ...sanitizeGeometry(rawCols, rawRows) ?? {},
       seenAt
     }]);
   }
@@ -4860,6 +4865,7 @@ function liveSnapshotChanged(prev, next) {
     if (!!before.manual !== !!info.manual) return true;
     if ((before.attachTmux ?? "") !== (info.attachTmux ?? "")) return true;
     if ((before.tags ?? []).join("\0") !== (info.tags ?? []).join("\0")) return true;
+    if (before.cols !== info.cols || before.rows !== info.rows) return true;
   }
   return false;
 }
@@ -4949,6 +4955,9 @@ function attachStartupCommand(sessionId, socket) {
 }
 
 const TERMINAL_ID_RE$1 = /^[a-zA-Z0-9_-]{1,64}$/;
+function recordGeometry(record) {
+  return record.cols !== void 0 && record.rows !== void 0 ? { cols: record.cols, rows: record.rows } : {};
+}
 function planTerminalRestore(record, facts) {
   if (facts.tmuxAlive) return { kind: "already-live" };
   if (record.attachTmux) {
@@ -4964,7 +4973,8 @@ function planTerminalRestore(record, facts) {
       manual: true,
       tags: record.tags,
       command: attachStartupCommand(matches[0].id, facts.attachSocket),
-      attachTmux: record.attachTmux
+      attachTmux: record.attachTmux,
+      ...recordGeometry(record)
     };
   }
   if (!record.cwd || !facts.cwdExists(record.cwd)) return { kind: "error", reason: "missing-cwd" };
@@ -4976,7 +4986,8 @@ function planTerminalRestore(record, facts) {
     title: record.title,
     manual: record.manual === true,
     tags: record.tags,
-    ...resumable ? { command: `claude --resume ${record.claudeSessionId}` } : {}
+    ...resumable ? { command: `claude --resume ${record.claudeSessionId}` } : {},
+    ...recordGeometry(record)
   };
 }
 
@@ -9537,6 +9548,7 @@ const CAPTURE_FULL_BUDGET_BYTES = 1024 * 1024;
 const ALT_ENTER = Buffer.from("\x1B[?1049h", "ascii");
 const CURSOR_HOME = Buffer.from("\x1B[H", "ascii");
 const CRLF = Buffer.from("\r\n", "ascii");
+const SGR_RESET = Buffer.from("\x1B[0m", "ascii");
 function normalizeCaptureLines(blob) {
   if (blob.length === 0) return blob;
   const lines = [];
@@ -9573,32 +9585,38 @@ function assembleRestore(responses, paneState, budget = CAPTURE_FULL_BUDGET_BYTE
   const screen = () => {
     const raw = get("visible");
     const lines = splitLines(raw);
+    let realCount = lines.length;
     if (rows !== void 0 && rows > 0) {
       while (lines.length > rows) lines.shift();
+      realCount = lines.length;
       while (lines.length < rows) lines.push(EMPTY);
     }
-    const body = joinCrlf(lines);
+    const realBody = joinCrlf(lines.slice(0, realCount));
+    const padCount = lines.length - realCount;
+    const padBody = padCount > 0 ? Buffer.concat([realCount > 0 ? CRLF : EMPTY, SGR_RESET, joinCrlf(new Array(padCount).fill(EMPTY))]) : EMPTY;
     const cursor = paneState ? Buffer.from(`\x1B[${paneState.cursorY + 1};${paneState.cursorX + 1}H`, "ascii") : Buffer.alloc(0);
-    return Buffer.concat([body, tail, cursor]);
+    return Buffer.concat([realBody, padBody, SGR_RESET, tail, cursor]);
   };
+  const wrapFull = (b) => Buffer.concat([SGR_RESET, b, SGR_RESET]);
+  const wrapSmall = (b) => Buffer.concat([b, SGR_RESET]);
   if (!alternateOn) {
     const history2 = trimTrailingBlankRows(normalizeCaptureLines(get("history")));
     const smallHistory = trimTrailingBlankRows(normalizeCaptureLines(get("smallHistory")));
     const withHistory = (h) => Buffer.concat(
-      h.length > 0 ? [truncateToBudget(h, budget), CRLF, screen()] : [screen()]
+      h.length > 0 ? [truncateToBudget(h, budget), SGR_RESET, CRLF, screen()] : [screen()]
     );
-    return { full: withHistory(history2), small: withHistory(smallHistory), alternateOn };
+    return { full: wrapFull(withHistory(history2)), small: wrapSmall(withHistory(smallHistory)), alternateOn };
   }
   const history = trimTrailingBlankRows(normalizeCaptureLines(get("history")));
   const saved = trimTrailingBlankRows(normalizeCaptureLines(get("altSaved")));
   const scrollback = truncateToBudget(
-    Buffer.concat(history.length > 0 && saved.length > 0 ? [history, CRLF, saved] : [history, saved]),
+    Buffer.concat(history.length > 0 && saved.length > 0 ? [history, SGR_RESET, CRLF, saved] : [history, saved]),
     budget
   );
-  const altScreen = Buffer.concat([ALT_ENTER, CURSOR_HOME, screen()]);
+  const altScreen = Buffer.concat([ALT_ENTER, CURSOR_HOME, SGR_RESET, screen()]);
   return {
-    full: Buffer.concat([scrollback, scrollback.length > 0 ? CRLF : Buffer.alloc(0), altScreen]),
-    small: altScreen,
+    full: wrapFull(Buffer.concat([scrollback, scrollback.length > 0 ? CRLF : Buffer.alloc(0), altScreen])),
+    small: wrapSmall(altScreen),
     alternateOn
   };
 }
@@ -10096,6 +10114,7 @@ function selectAutoRestore(candidates, opts) {
       terminalId: c.id,
       ...c.tags !== void 0 ? { tags: c.tags } : {},
       ...c.manual ? { manual: true } : {},
+      ...c.cols !== void 0 && c.rows !== void 0 ? { cols: c.cols, rows: c.rows } : {},
       cwd: c.cwd,
       title: c.title,
       claudeSessionId: c.claudeSessionId,
@@ -10283,7 +10302,10 @@ function startupInjectionArgs(tmuxSession, command) {
   ];
 }
 function seenInfoOf(t) {
-  return { title: t.title, cwd: t.cwd, tags: t.tags, manual: t.manual, attachTmux: t.attachTmux };
+  return { title: t.title, cwd: t.cwd, tags: t.tags, manual: t.manual, attachTmux: t.attachTmux, ...seenGeometry(t.paneCols, t.paneRows) };
+}
+function seenGeometry(cols, rows) {
+  return cols !== void 0 && rows !== void 0 ? { cols, rows } : {};
 }
 function terminalListSignature(items) {
   const canon = [...items].sort((a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0).map((t) => [
@@ -10328,6 +10350,12 @@ const LIST_SESSIONS_FORMAT = [
   // B-273: the user tmux session this terminal was opened to attach (name),
   // carried into close records so a restore can re-attach.
   "#{@vh_attach}",
+  // B-287: the pane's REAL geometry, persisted with the live snapshot so a
+  // cold restore (daemon boot auto-restore, archive ↻) recreates the session
+  // at the size it last had — claude's one-shot welcome banner then never
+  // gets reflowed by the first web open (the "half-drawn logo").
+  "#{pane_width}",
+  "#{pane_height}",
   // B-121: the control-mode client has no `pty.process`, so the agent-state
   // fast path lost its live `#{pane_current_command}` equivalent. Carry it in
   // the ONE list-sessions call the tracker already makes — the value goes
@@ -10342,9 +10370,10 @@ const LIST_SESSIONS_FORMAT = [
 function parseSessionListLine(line) {
   if (!line) return void 0;
   const parts = line.split(LIST_FIELD_SEP);
-  if (parts.length < 10) return void 0;
-  const [name, created, activity, cwd, vhTitle, manual, vhTags, vhAttach, paneCommand] = parts;
+  if (parts.length < 12) return void 0;
+  const [name, created, activity, cwd, vhTitle, manual, vhTags, vhAttach, paneW, paneH, paneCommand] = parts;
   if (!name) return void 0;
+  const geom = parsePositiveInt(paneW) !== void 0 && parsePositiveInt(paneH) !== void 0 ? { paneCols: parsePositiveInt(paneW), paneRows: parsePositiveInt(paneH) } : {};
   return {
     name,
     created: created ? Number(created) * 1e3 : void 0,
@@ -10357,11 +10386,17 @@ function parseSessionListLine(line) {
     // Verbatim (no trim): tmux allows edge spaces in a session name and the
     // restore lookup / attach echo compare it exactly.
     attachTmux: isSafeTmuxSessionName(vhAttach) ? vhAttach : void 0,
-    // pane_title is last, so anything after field 9 is title content that
+    ...geom,
+    // pane_title is last, so anything after field 11 is title content that
     // contained the separator — rejoin it rather than dropping it.
-    paneTitle: parts.slice(9).join(LIST_FIELD_SEP) || void 0
+    paneTitle: parts.slice(11).join(LIST_FIELD_SEP) || void 0
   };
 }
+function parsePositiveInt(raw) {
+  if (raw === void 0 || !/^[0-9]{1,5}$/.test(raw.trim())) return void 0;
+  const n = Number(raw.trim());
+  return n > 0 ? n : void 0;
+}
 const TERMINAL_TAG_MAX_COUNT = 64;
 const TERMINAL_TAG_MAX_LENGTH = 24;
 const TERMINAL_TAGS_MAX_BYTES = 4096;
@@ -10504,6 +10539,11 @@ const VH_SESSION_OPTION_OVERRIDES = [
   ["window", "window-size", "latest"],
   ["window", "pane-border-status", "off"]
 ];
+const COLD_CREATE_DEFAULT_GEOMETRY = { cols: 120, rows: 30 };
+function coldCreateGeometry(plan) {
+  const ok = (v) => typeof v === "number" && Number.isInteger(v) && v >= 2 && v <= 1e4;
+  return ok(plan.cols) && ok(plan.rows) ? { cols: plan.cols, rows: plan.rows } : { ...COLD_CREATE_DEFAULT_GEOMETRY };
+}
 function tmuxNewSessionArgs(session, cols, rows, cwd, envFlags, shell) {
   const args = ["new-session", "-d", ...envFlags, "-s", session, "-x", String(cols), "-y", String(rows), "-c", cwd, shell];
   for (const [scope, option, value] of VH_SESSION_OPTION_OVERRIDES) {
@@ -10525,13 +10565,17 @@ function ptyEnv() {
     env.PATH = `${local}:${env.PATH || ""}`;
   }
   env.TERM = "xterm-256color";
-  const isUtf8 = (v) => !!v && /utf-?8/i.test(v);
-  if (!isUtf8(env.LC_ALL) && !isUtf8(env.LANG) && !isUtf8(env.LC_CTYPE)) {
-    env.LANG = "en_US.UTF-8";
-    env.LC_CTYPE = "en_US.UTF-8";
-  }
+  Object.assign(env, utf8LocaleEnv(env, process.platform));
   return env;
 }
+function utf8LocaleEnv(cur, platform) {
+  const isUtf8 = (v) => !!v && /utf-?8/i.test(v);
+  if (isUtf8(cur.LC_ALL) || isUtf8(cur.LANG) || isUtf8(cur.LC_CTYPE)) return {};
+  const locale = platform === "darwin" ? "en_US.UTF-8" : "C.UTF-8";
+  const patch = { LANG: locale, LC_CTYPE: locale };
+  if (cur.LC_ALL) patch.LC_ALL = locale;
+  return patch;
+}
 class TerminalSession {
   id;
   tmuxSession;
@@ -11050,6 +11094,7 @@ class WebTerminalManager {
         tags: info.tags,
         manual: info.manual,
         ...info.attachTmux ? { attachTmux: info.attachTmux } : {},
+        ...seenGeometry(info.cols, info.rows),
         // Live binding first (authoritative while it exists), persisted
         // metadata as the fallback once the mirror has been torn down.
         mirrorSessionId: this.mirrorResolver?.(id) ?? mirror?.sessionId,
@@ -11103,6 +11148,7 @@ class WebTerminalManager {
         tags: info.tags,
         manual: info.manual,
         ...info.attachTmux ? { attachTmux: info.attachTmux } : {},
+        ...seenGeometry(info.cols, info.rows),
         mirrorSessionId: mirror?.sessionId,
         claudeSessionId: mirror?.claudeSessionId,
         reason: "daemon-gap",
@@ -11115,6 +11161,7 @@ class WebTerminalManager {
         cwd: info.cwd,
         tags: info.tags,
         manual: info.manual,
+        ...seenGeometry(info.cols, info.rows),
         seenAt: info.seenAt,
         claudeSessionId: mirror?.claudeSessionId
       });
@@ -11256,9 +11303,10 @@ class WebTerminalManager {
       "-e",
       `VH_HAPPY_HOME_DIR=${configuration.happyHomeDir}`
     ] : [];
+    const { cols, rows } = coldCreateGeometry(plan);
     const created = node_child_process.spawnSync(
       "tmux",
-      tmuxArgs(tmuxNewSessionArgs(name, 120, 30, plan.cwd, envFlags, defaultShell())),
+      tmuxArgs(tmuxNewSessionArgs(name, cols, rows, plan.cwd, envFlags, defaultShell())),
       { stdio: "ignore", timeout: TMUX_CREATE_TIMEOUT_MS, env }
     );
     const live = created.status === 0 && node_child_process.spawnSync(
@@ -11311,7 +11359,7 @@ class WebTerminalManager {
    *  would care about changed (see liveSnapshotChanged). */
   persistLiveSnapshot(live, now) {
     const candidate = /* @__PURE__ */ new Map();
-    for (const [id, info] of live) candidate.set(id, { title: info.title, cwd: info.cwd, tags: info.tags, manual: info.manual, ...info.attachTmux ? { attachTmux: info.attachTmux } : {}, seenAt: now });
+    for (const [id, info] of live) candidate.set(id, { title: info.title, cwd: info.cwd, tags: info.tags, manual: info.manual, ...info.attachTmux ? { attachTmux: info.attachTmux } : {}, ...seenGeometry(info.cols, info.rows), seenAt: now });
     if (!liveSnapshotChanged(this.lastPersistedSnapshot, candidate)) return;
     this.lastPersistedSnapshot = candidate;
     saveLiveSnapshot(candidate);
@@ -11422,7 +11470,11 @@ class WebTerminalManager {
           seq: existing.seq,
           mode: "replay",
           chunks,
-          ...lines ? { streamMode: "lines" } : {},
+          // B-287: a replay carries no restore, so without this the
+          // adopting client had no authoritative width and fell back
+          // to its own guess — the door through which a stale device
+          // width leaked in. Announced = what we last told clients.
+          ...lines ? { streamMode: "lines", paneCols: existing.announcedCols ?? existing.cols, paneRows: existing.announcedRows ?? existing.rows } : {},
           ...echo2
         };
       }
@@ -11504,6 +11556,13 @@ class WebTerminalManager {
         // the web xterm also sees the OSC, which is inert there.
         ["set-option", "-t", `=${tmuxSession}:`, "set-titles", "on"],
         ["set-option", "-t", `=${tmuxSession}:`, "set-titles-string", "#{pane_title}"],
+        // B-287: re-assert on EVERY open, not just at create. A session
+        // made before the create-time override (pre-0.2.96) or under a
+        // user `window-size manual`/`smallest` silently refuses
+        // `refresh-client -C`, so the pane freezes at whatever width the
+        // first viewer set and no later device can widen it. `-w -q` so
+        // an older tmux without the option does not fail the open.
+        ["set-option", "-w", "-q", "-t", `=${tmuxSession}:`, "window-size", "latest"],
         ["set-option", "-g", "set-clipboard", "on"],
         ["set-option", "-ga", "terminal-features", ",xterm-256color:clipboard"]
       ];
@@ -11899,13 +11958,12 @@ class WebTerminalManager {
     this.applyResize(session, cols, rows);
   }
   /** Resize the transport AND the authoritative headless screen together, so a
-   *  later snapshot matches the real geometry. Multiple tabs subscribed to one
-   *  terminal all drive the same tmux window — we simply take the LAST resize
-   *  (tmux is single-size anyway); there's no per-subscriber geometry to
-   *  reconcile. For a control client the declaration IS `refresh-client -C`:
-   *  a client that never sends it doesn't participate in the window size at
-   *  all (which is the door the spec leaves open for "phone mirrors without
-   *  squeezing the desktop" — not implemented in this batch). */
+   *  later snapshot matches the real geometry. One tmux window = one size:
+   *  we take the LAST resize we are handed (B-287: the web only sends one on a
+   *  human-activity edge, so "last resize" == "most recently used viewer" ==
+   *  tmux's own `window-size latest` semantics). The control-client
+   *  declaration IS `refresh-client -C`, preceded by a `window-size latest`
+   *  re-assert so a manual/smallest session cannot swallow it. */
   applyResize(session, cols, rows) {
     const c = Math.max(2, Math.floor(cols));
     const r = Math.max(2, Math.floor(rows));
@@ -11916,7 +11974,10 @@ class WebTerminalManager {
         logger.debug(`[WEB TERMINAL] resize ${session.id} failed: ${e}`);
       }
     } else if (c !== session.cols || r !== session.rows) {
-      session.transport.client.sendFireAndForget([`refresh-client -C ${c}x${r}`]);
+      session.transport.client.sendFireAndForget([
+        `set-option -w -q -t =${session.tmuxSession}: window-size latest`,
+        `refresh-client -C ${c}x${r}`
+      ]);
     }
     session.resizeHeadless(c, r);
   }
@@ -11959,7 +12020,10 @@ class WebTerminalManager {
    *  session (so a local `tmux attach` won't find it either). Used when the
    *  user deletes the terminal from the sidebar. */
   killSession(terminalId, opts) {
-    const info = this.lastSeenInfo.get(terminalId) ?? this.listSessions().find((t) => t.id === terminalId);
+    const info = this.lastSeenInfo.get(terminalId) ?? (() => {
+      const t = this.listSessions().find((x) => x.id === terminalId);
+      return t ? seenInfoOf(t) : void 0;
+    })();
     const target = `=vh-${terminalId}:`;
     const killed = node_child_process.spawnSync("tmux", tmuxArgs(["kill-session", "-t", target]), { stdio: "ignore", env: ptyEnv() });
     const verified = node_child_process.spawnSync("tmux", tmuxArgs(["has-session", "-t", target]), { stdio: "ignore", env: ptyEnv() });
@@ -11985,6 +12049,7 @@ class WebTerminalManager {
         tags: info.tags,
         manual: info.manual,
         ...info.attachTmux ? { attachTmux: info.attachTmux } : {},
+        ...seenGeometry(info.cols, info.rows),
         mirrorSessionId: this.mirrorResolver?.(terminalId) ?? mirror?.sessionId,
         claudeSessionId: mirror?.claudeSessionId,
         reason: "closed",
@@ -12074,7 +12139,8 @@ class WebTerminalManager {
           // the mirror reconciler's stricter "claude is really here" gate.
           claudeConfident: probe.claudeConfident,
           manual: s.manual,
-          ...s.attachTmux ? { attachTmux: s.attachTmux } : {}
+          ...s.attachTmux ? { attachTmux: s.attachTmux } : {},
+          ...s.paneCols !== void 0 && s.paneRows !== void 0 ? { paneCols: s.paneCols, paneRows: s.paneRows } : {}
         });
       }
       return out;