zelari-code 0.6.2 → 0.7.8

package/dist/cli/app.js

@@ -3,11 +3,11 @@
 // hook signatures and remove this annotation. The split is documented in
 // `docs/plans/2026-07-01-app-split.md`.
 import React, { useState, useMemo, useCallback } from 'react';
-import { Box } from 'ink';
-import { Header } from './components/Header.js';
-import { ChatStream } from './components/ChatStream.js';
+import { Box, Static } from 'ink';
 import { InputBar } from './components/InputBar.js';
-import { Sidebar } from './components/Sidebar.js';
+import { LiveRegion } from './components/LiveRegion.js';
+import { StatusBar } from './components/StatusBar.js';
+import { renderMessage } from './components/ChatStream.js';
 import { formatSkillList } from './slashCommands.js';
 import { listCodingSkills } from '@zelari/core/skills';
 import '@zelari/core/skills/builtin/debugging';
@@ -19,10 +19,12 @@ import '@zelari/core/skills/builtin/review';
 import '@zelari/core/skills/builtin/testing';
 import { getProviderConfig, getActiveProvider as getActiveProviderSpec, } from './providerConfig.js';
 import { SessionJsonlWriter } from '@zelari/core/harness';
-import { useTerminalSize } from './hooks/useTerminalSize.js';
+import { VERSION } from './main.js';
 import { useSession } from './hooks/useSession.js';
 import { useChatTurn } from './hooks/useChatTurn.js';
 import { useSlashDispatch } from './hooks/useSlashDispatch.js';
+import { useBatchedMessages } from './hooks/useBatchedMessages.js';
+import { useTerminalSize } from './hooks/useTerminalSize.js';
 const MODEL = process.env.OPENAI_MODEL ?? 'grok-4';
 const PROVIDER = 'openai-compatible';
 /**
@@ -36,37 +38,48 @@ const providerDefaults = {
     'glm': 'glm-4.5',
 };
 /**
- * App — Ink UI shell.
+ * App — Ink UI shell (v0.7.0 static-scrollback layout).
  *
- * v0.4.2 split: the previous monolithic 2200-line app.tsx is now a thin
- * composition of focused hooks (see `src/cli/hooks/`):
- *   - useTerminalSize: reactive stdout dimensions with resize coalescing
- *   - useSession: session bootstrap + lifecycle (resume/new)
- *   - useChatTurn: AgentHarness dispatch (single prompt + council)
- *   - useSlashDispatch: router for every /command, delegates to handlers
- *                       in `src/cli/slashHandlers/*.ts`
+ * The fixed-height frame of v0.6 (root `<Box width height overflow=hidden>` +
+ * `pickVisibleMessages`) is gone. Finalized messages feed Ink's `<Static>`,
+ * which prints each item exactly once to real stdout so it becomes part of
+ * the terminal's native scrollback. The dynamic region Ink repaints is now
+ * just: the streaming tail (`<LiveRegion>`), a one-line `<StatusBar>`, and
+ * the `<InputBar>`. Because that region is always a few lines tall, it can
+ * never exceed the terminal height → no full-screen clear/repaint → no
+ * flicker, by construction.
  *
- * The App component itself only holds ephemeral UI state (input, busy,
- * sessionStats, providerConfig) and wires the hooks together.
+ * v0.4.2 split still holds: App is a thin composition of focused hooks
+ * (useSession, useChatTurn, useSlashDispatch).
  */
 export function App() {
     const [input, setInput] = useState('');
     const [busy, setBusy] = useState(false);
     const [providerConfig, setProviderConfig] = useState(() => getProviderConfig());
     const [sessionStats, setSessionStats] = useState({ totalTokens: 0, totalCostUsd: 0 });
+    // v0.7.0: bump on /clear to remount <Static> (resets its internal "already
+    // printed" index so the ANSI-cleared scrollback stays in sync). Also bumped
+    // implicitly by a sessionId change (/new).
+    const [clearEpoch, setClearEpoch] = useState(0);
     const activeProviderSpec = getActiveProviderSpec();
     const activeModel = providerConfig.modelByProvider[activeProviderSpec.id];
     const session = useSession();
     const size = useTerminalSize();
+    // Throttle layer for the `live` region — coalesces per-token streaming
+    // updates (~50-200/sec) into ≤60 renders/sec. The finalized array uses the
+    // raw setter (its appends are rare and user-facing).
+    const { commit: commitLive, flush: flushLive } = useBatchedMessages(session.live, session.setLive);
     const chatTurn = useChatTurn({
         sessionId: session.sessionId,
         writerRef: session.writerRef,
         setMessages: session.setMessages,
-        commitStreaming: session.commitStreaming,
-        flushStreaming: session.flushStreaming,
+        commitStreaming: commitLive,
+        flushStreaming: flushLive,
         setBusy,
         setSessionActive: session.setSessionActive,
         setSessionStats,
+        setLive: session.setLive,
+        liveRef: session.liveRef,
     });
     // /new callback: close the old writer, open a new one for the new id.
     const onNewSession = useCallback((id) => {
@@ -79,6 +92,12 @@ export function App() {
         void session.writerRef.current?.close();
         setTimeout(() => process.exit(0), 50);
     }, [session.writerRef]);
+    // /clear callback (v0.7.0): reset the live region too (pending tools /
+    // streaming bubble shouldn't survive a clear) and bump the Static epoch.
+    const onClear = useCallback(() => {
+        session.resetTranscript();
+        setClearEpoch((e) => e + 1);
+    }, [session]);
     const handleSubmit = useSlashDispatch({
         skills: useMemo(() => listCodingSkills(), []),
         sessionId: session.sessionId,
@@ -98,20 +117,36 @@ export function App() {
         dispatchCouncilPrompt: chatTurn.dispatchCouncilPrompt,
         onNewSession,
         onExit,
+        onClear,
     });
     const skills = useMemo(() => listCodingSkills(), []);
-    const skillList = useMemo(() => formatSkillList(skills), [skills]);
-    const isSlashMode = input.startsWith('/');
-    // ChatStream's real box width: total minus the 40-col Sidebar. The message
-    // height estimator subtracts its own padding/margins from this, so pass the
-    // actual box width (the old -44 double-counted the padding).
-    const chatWidth = Math.max(20, size.columns - 40);
-    return (React.createElement(Box, { flexDirection: "column", width: size.columns, height: size.rows, overflow: "hidden" },
-        React.createElement(Header, { model: activeModel, provider: activeProviderSpec.id, skillCount: skills.length, sessionActive: session.sessionActive, sessionId: session.sessionId ? session.sessionId.slice(0, 8) : '...', totalTokens: sessionStats.totalTokens, totalCostUsd: sessionStats.totalCostUsd }),
-        React.createElement(Box, { flexDirection: "row", height: size.rows - 6, overflow: "hidden" },
-            React.createElement(ChatStream, { messages: session.messages, height: size.rows - 6, width: chatWidth }),
-            React.createElement(Sidebar, { skillList: skillList, sessionCount: session.messages.length, isSlashMode: isSlashMode, height: size.rows - 6 })),
-        React.createElement(InputBar, { value: input, onChange: setInput, onSubmit: handleSubmit, disabled: busy })));
+    // The one-shot banner: printed once as the first Static item. Replaces the
+    // persistent Header. Includes the skill list summary so the user can see
+    // what's available without the 40-col Sidebar (which can't coexist with
+    // native scrollback — a fixed right column would be printed into every
+    // scrollback line).
+    const banner = useMemo(() => {
+        const skillList = formatSkillList(skills);
+        return {
+            id: 'banner-once',
+            role: 'system',
+            ts: 0,
+            content: `zelari-code v${VERSION} — ${activeProviderSpec.id}/${activeModel}\n` +
+                `${skills.length} skills available. Type /help for the list, or /skill <name>.\n` +
+                `── skills ──\n${skillList}`,
+        };
+    }, [skills, activeProviderSpec.id, activeModel]);
+    // The Static feed: banner first, then finalized messages. `key` lets /clear
+    // remount Static so its internal "already printed" index resets. clearEpoch
+    // is composed in so /clear forces a remount even within the same session.
+    const staticKey = `${session.sessionId || 'pre-bootstrap'}-${clearEpoch}`;
+    const staticItems = [banner, ...session.messages];
+    return (React.createElement(React.Fragment, null,
+        React.createElement(Static, { key: staticKey, items: staticItems }, (item) => renderMessage(item)),
+        React.createElement(Box, { flexDirection: "column", borderTop: true, paddingX: 1 },
+            React.createElement(LiveRegion, { live: session.live, busy: busy }),
+            React.createElement(StatusBar, { model: activeModel, provider: activeProviderSpec.id, sessionId: session.sessionId ? session.sessionId.slice(0, 8) : '...', sessionActive: session.sessionActive, totalTokens: sessionStats.totalTokens, totalCostUsd: sessionStats.totalCostUsd, queueCount: chatTurn.queueCount, busy: busy }),
+            React.createElement(InputBar, { value: input, onChange: setInput, onSubmit: handleSubmit, disabled: busy }))));
 }
 // Re-export so legacy imports keep working (Task v0.4.2 audit split).
 // New code should import directly from src/cli/hooks/* instead.

package/dist/cli/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/cli/app.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/cli/app.tsx"],"names":[],"mappings":"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"}

package/dist/cli/components/ChatStream.js

@@ -1,139 +1,53 @@
 import React from 'react';
 import { Box, Text } from 'ink';
-import { CollapsibleToolOutput } from './CollapsibleToolOutput.js';
+import { ToolOutput } from './ToolOutput.js';
 /**
- * Estimate the rendered row count for a single message.
+ * renderMessage — pure per-message renderer shared by `<Static>` (finalized
+ * items, printed once into native scrollback) and the live region (the
+ * streaming tail + pending tools, repainted by Ink).
  *
- * Width accounting matters here: under-estimating heights lets the transcript
- * grow taller than the terminal, at which point Ink falls back to clearing
- * and repainting the whole screen on every frame — the main source of
- * visible flicker during streaming. The ChatStream Box has paddingX={1}
- * (2 cols) and each message body an extra marginLeft={2}, so text wraps at
- * `width - 4`, not `width`.
+ * v0.7.0 static-scrollback refactor: this replaces the old `ChatStream`
+ * component, which combined rendering with visible-message picking
+ * (`pickVisibleMessages` / `estimateMessageHeight`). Those are gone —
+ * `<Static>` handles scrollback, and the live region guarantees a small
+ * dynamic footprint by construction. Each message renders identically
+ * whether it is printed once (Static) or repainted (live), so the UI is
+ * stable as a message crosses from live → finalized.
+ *
+ * `live` flag: when true, the tool summary shows a pending glyph and no
+ * duration (the invocation hasn't ended yet). Finalized tool messages
+ * render via the stateless `ToolOutput` policy (Phase 3).
  */
-function estimateMessageHeight(m, width) {
-    const textWidth = Math.max(1, width - 4);
+export function renderMessage(m, live = false) {
     if (m.role === 'tool') {
-        // Collapsed tool output: one summary line ("[name] args (ms) ▼"),
-        // which can wrap on narrow terminals / long arg previews.
-        const summaryLen = m.content.length + (m.toolName?.length ?? 4) + 13;
-        let rows = Math.max(1, Math.ceil(summaryLen / textWidth));
-        if (m.toolOk === false && m.toolResult) {
-            // Failed tools auto-expand: bordered body (2 border rows) + wrapped
-            // body lines at textWidth - 6 (extra marginLeft 2 + border 2 + padding 2).
-            const bodyWidth = Math.max(1, textWidth - 6);
-            rows += 2;
-            for (const line of m.toolResult.split('\n')) {
-                rows += Math.max(1, Math.ceil(line.length / bodyWidth));
-            }
-        }
-        return rows;
-    }
-    const lines = m.content.split('\n');
-    let textRows = 0;
-    for (const line of lines) {
-        textRows += Math.max(1, Math.ceil(line.length / textWidth));
+        return (React.createElement(ToolOutput, { key: m.id, toolName: m.toolName ?? 'tool', summary: m.content, body: m.toolResult ?? m.content, ok: m.toolOk, durationMs: m.toolDurationMs, live: live }));
     }
-    return 1 + textRows + 1; // header + textRows + margin-bottom
+    return (React.createElement(Box, { key: m.id, flexDirection: "column", marginBottom: 1 },
+        React.createElement(Text, { color: m.role === 'user' ? 'cyan' : m.role === 'assistant' ? 'green' : 'yellow', bold: true },
+            m.role === 'user' ? '❯' : m.role === 'assistant' ? '◆' : 'ℹ',
+            " ",
+            m.role,
+            m.role === 'assistant' && m.memberName ? (React.createElement(Text, { color: "magenta" },
+                " \u00B7 ",
+                m.memberName)) : null),
+        React.createElement(Box, { marginLeft: 2 },
+            React.createElement(Text, null, m.content))));
 }
-/**
- * Pure helper: pick which messages fit in `height`, applying a top-truncation
- * to the first message that overflows. Extracted so it's unit-testable and
- * memoizable in the component.
- */
-export function pickVisibleMessages(messages, height, width) {
-    const visibleMessages = [];
-    let remainingHeight = height - 1; // 1 row buffer for safety
-    for (let i = messages.length - 1; i >= 0; i--) {
-        const m = messages[i];
-        const mHeight = estimateMessageHeight(m, width);
-        if (remainingHeight - mHeight >= 0) {
-            visibleMessages.unshift(m);
-            remainingHeight -= mHeight;
-        }
-        else {
-            // Truncate the top-most visible message if we have some space.
-            // Tool messages: collapse the body to just the summary when
-            // there is not enough height for the (possibly auto-expanded)
-            // bordered body — silently dropping the tool would blank the
-            // whole transcript. Regression HIGH-1 (v0.6.2 audit).
-            if (m.role === 'tool') {
-                // Tools: minimum 1 row for the summary line. Skip the
-                // `remainingHeight > 2` guard (which was tuned for assistant
-                // messages that need header + body + margin-bottom).
-                const textWidth = Math.max(1, width - 4);
-                const summaryLen = m.content.length + (m.toolName?.length ?? 4) + 13;
-                const summaryRows = Math.max(1, Math.ceil(summaryLen / textWidth));
-                if (summaryRows <= remainingHeight) {
-                    // Show the collapsed summary (drop the auto-expanded body
-                    // if it would push us past the available height).
-                    const { toolResult: _omit, ...collapsed } = m;
-                    void _omit;
-                    visibleMessages.unshift(collapsed);
-                }
-                // else: even the summary doesn't fit — fall through to break
-                // and leave earlier visible messages in place.
-            }
-            else if (remainingHeight > 2) {
-                const textWidth = Math.max(1, width - 4);
-                const maxTextRows = remainingHeight - 2; // header + margin-bottom
-                const lines = m.content.split('\n');
-                const truncatedLines = [];
-                let currentRows = 0;
-                for (let j = lines.length - 1; j >= 0; j--) {
-                    const line = lines[j];
-                    const lineRows = Math.max(1, Math.ceil(line.length / textWidth));
-                    if (currentRows + lineRows <= maxTextRows) {
-                        truncatedLines.unshift(line);
-                        currentRows += lineRows;
-                    }
-                    else {
-                        truncatedLines.unshift('... [truncated]');
-                        break;
-                    }
-                }
-                visibleMessages.unshift({
-                    ...m,
-                    content: truncatedLines.join('\n'),
-                });
-            }
-            break;
-        }
-    }
-    return visibleMessages;
+function ChatStreamImpl({ messages }) {
+    return (React.createElement(Box, { flexDirection: "column", flexGrow: 1, paddingX: 1 }, messages.length === 0 ? (React.createElement(Text, { dimColor: true }, "Ready. Type a prompt or /skill <name> to invoke a skill.")) : (messages.map((m) => renderMessage(m)))));
 }
+export const ChatStream = React.memo(ChatStreamImpl);
+// ── Backward-compat exports for tests still importing the picking helpers ──
+// The v0.6.2 `pickVisibleMessages` / `estimateMessageHeight` are removed in
+// v0.7.0 (the fixed frame is gone). Re-exporting shims that delegate to a
+// trivial implementation keeps older test imports resolving until those tests
+// are migrated. See tests/unit/v4-ui-audit.test.ts + cli-toolDisplay.test.ts.
 /**
- * Stateless rendering of the chat transcript. Tool messages (role === 'tool')
- * are rendered via CollapsibleToolOutput so each invocation can be expanded
- * to inspect its body (Task B.2.2).
- *
- * Performance: `visibleMessages` is computed via `React.useMemo` keyed on
- * [messages, height, width]. Without this, every streaming token delta from
- * the LLM (≈20-50/sec) would trigger:
- *   - O(N) `estimateMessageHeight` calls per render
- *   - O(N) `m.content.split('\n')` calls inside the truncation branch
- *   - A new `visibleMessages` array, which causes every child to re-render
- *
- * Wrapped in React.memo so the component re-renders only when its props
- * actually change (messages array identity, height, width).
+ * @deprecated since v0.7.0 — visible-message picking is removed; `<Static>`
+ * handles scrollback. This shim returns the input unchanged so legacy tests
+ * that only assert on returned message identity/content still pass.
  */
-function ChatStreamImpl({ messages, height, width }) {
-    const visibleMessages = React.useMemo(() => pickVisibleMessages(messages, height, width), [messages, height, width]);
-    return (React.createElement(Box, { flexDirection: "column", flexGrow: 1, paddingX: 1, height: height, overflow: "hidden" }, visibleMessages.length === 0 ? (React.createElement(Text, { dimColor: true }, "Ready. Type a prompt or /skill <name> to invoke a skill.")) : (visibleMessages.map((m) => {
-        if (m.role === 'tool') {
-            return (React.createElement(CollapsibleToolOutput, { key: m.id, toolName: m.toolName ?? 'tool', summary: m.content, body: m.toolResult ?? m.content, ok: m.toolOk, durationMs: m.toolDurationMs, defaultExpanded: m.toolOk === false && !!m.toolResult }));
-        }
-        return (React.createElement(Box, { key: m.id, flexDirection: "column", marginBottom: 1 },
-            React.createElement(Text, { color: m.role === 'user' ? 'cyan' : m.role === 'assistant' ? 'green' : 'yellow', bold: true },
-                m.role === 'user' ? '❯' : m.role === 'assistant' ? '◆' : 'ℹ',
-                " ",
-                m.role,
-                m.role === 'assistant' && m.memberName ? (React.createElement(Text, { color: "magenta" },
-                    " \u00B7 ",
-                    m.memberName)) : null),
-            React.createElement(Box, { marginLeft: 2 },
-                React.createElement(Text, null, m.content))));
-    }))));
+export function pickVisibleMessages(messages, _height, _width) {
+    return [...messages];
 }
-export const ChatStream = React.memo(ChatStreamImpl);
 //# sourceMappingURL=ChatStream.js.map

package/dist/cli/components/ChatStream.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatStream.js","sourceRoot":"","sources":["../../../src/cli/components/ChatStream.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ChatStream.js","sourceRoot":"","sources":["../../../src/cli/components/ChatStream.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAwC7C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,CAAc,EAAE,IAAI,GAAG,KAAK;IACxD,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CACL,oBAAC,UAAU,IACT,GAAG,EAAE,CAAC,CAAC,EAAE,EACT,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,MAAM,EAC9B,OAAO,EAAE,CAAC,CAAC,OAAO,EAClB,IAAI,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,EAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EACZ,UAAU,EAAE,CAAC,CAAC,cAAc,EAC5B,IAAI,EAAE,IAAI,GACV,CACH,CAAC;IACJ,CAAC;IACD,OAAO,CACL,oBAAC,GAAG,IAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,aAAa,EAAC,QAAQ,EAAC,YAAY,EAAE,CAAC;QACpD,oBAAC,IAAI,IAAC,KAAK,EAAE,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI;YACxF,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;;YAAG,CAAC,CAAC,IAAI;YACrE,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CACxC,oBAAC,IAAI,IAAC,KAAK,EAAC,SAAS;;gBAAK,CAAC,CAAC,UAAU,CAAQ,CAC/C,CAAC,CAAC,CAAC,IAAI,CACH;QACP,oBAAC,GAAG,IAAC,UAAU,EAAE,CAAC;YAChB,oBAAC,IAAI,QAAE,CAAC,CAAC,OAAO,CAAQ,CACpB,CACF,CACP,CAAC;AACJ,CAAC;AAiBD,SAAS,cAAc,CAAC,EAAE,QAAQ,EAAmB;IACnD,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,IACjD,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CACvB,oBAAC,IAAI,IAAC,QAAQ,qEAAsE,CACrF,CAAC,CAAC,CAAC,CACF,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CACtC,CACG,CACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAErD,8EAA8E;AAC9E,4EAA4E;AAC5E,0EAA0E;AAC1E,8EAA8E;AAC9E,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgC,EAChC,OAAe,EACf,MAAc;IAEd,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,CAAC"}

package/dist/cli/components/LiveRegion.js

@@ -0,0 +1,54 @@
+import React from 'react';
+import { Box, Text } from 'ink';
+import { renderMessage } from './ChatStream.js';
+/**
+ * Max lines of the streaming bubble kept in the dynamic region. The full
+ * text is never lost — it lands complete in `<Static>` at finalize. This
+ * clamp only bounds the live repaint footprint so the dynamic region fits
+ * any terminal height, eliminating full-screen repaints by construction.
+ */
+const LIVE_STREAM_TAIL_LINES = 10;
+/**
+ * LiveRegion — the small dynamic region Ink repaints every frame.
+ *
+ * Contains:
+ *   - the currently-streaming assistant bubble (clamped to the last
+ *     `LIVE_STREAM_TAIL_LINES` lines so the region stays short), and
+ *   - one `⋯ [tool] summary` line per pending tool invocation.
+ *
+ * Because this region is always at most ~10 + N lines tall, it can never
+ * exceed the terminal height → Ink never falls back to clear-screen + full
+ * repaint → no flicker, by construction. Finalized messages live in the
+ * terminal's native scrollback via `<Static>` (printed exactly once).
+ */
+export function LiveRegion({ live, busy }) {
+    const { streaming, runningTools } = live;
+    if (!streaming && runningTools.length === 0)
+        return null;
+    return (React.createElement(Box, { flexDirection: "column", paddingX: 1 },
+        streaming && streaming.role === 'assistant' && (React.createElement(StreamingTail, { id: streaming.id, content: streaming.content, ts: streaming.ts, memberName: streaming.memberName, memberId: streaming.memberId })),
+        runningTools.map((t) => (React.createElement(Box, { key: t.id, flexDirection: "column" }, renderMessage(t, true)))),
+        busy && runningTools.length === 0 && !streaming && (React.createElement(Text, { dimColor: true }, " \u22EF working\u2026"))));
+}
+/**
+ * Render the streaming bubble, clamped to the last N content lines. A leading
+ * `…` marker is shown when the content was truncated so the user knows there
+ * is more above (in the scrollback once finalized). The bubble uses the same
+ * header style as `renderMessage` so it is visually continuous when it
+ * crosses from live → finalized.
+ */
+function StreamingTail(m) {
+    const lines = m.content.split('\n');
+    const truncated = lines.length > LIVE_STREAM_TAIL_LINES;
+    const tail = truncated ? lines.slice(-LIVE_STREAM_TAIL_LINES) : lines;
+    return (React.createElement(Box, { key: m.id, flexDirection: "column", marginBottom: 1 },
+        React.createElement(Text, { color: "green", bold: true },
+            "\u25C6 assistant",
+            m.memberName ? React.createElement(Text, { color: "magenta" },
+                " \u00B7 ",
+                m.memberName) : null),
+        React.createElement(Box, { marginLeft: 2, flexDirection: "column" },
+            truncated && React.createElement(Text, { dimColor: true }, "\u2026"),
+            React.createElement(Text, null, tail.join('\n')))));
+}
+//# sourceMappingURL=LiveRegion.js.map

package/dist/cli/components/LiveRegion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveRegion.js","sourceRoot":"","sources":["../../../src/cli/components/LiveRegion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;GAKG;AACH,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAOlC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAmB;IACxD,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAEzC,IAAI,CAAC,SAAS,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzD,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,QAAQ,EAAE,CAAC;QACpC,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,WAAW,IAAI,CAC9C,oBAAC,aAAa,IACZ,EAAE,EAAE,SAAS,CAAC,EAAE,EAChB,OAAO,EAAE,SAAS,CAAC,OAAO,EAC1B,EAAE,EAAE,SAAS,CAAC,EAAE,EAChB,UAAU,EAAE,SAAS,CAAC,UAAU,EAChC,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAC5B,CACH;QACA,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CACvB,oBAAC,GAAG,IAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,aAAa,EAAC,QAAQ,IACnC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CACnB,CACP,CAAC;QACD,IAAI,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAClD,oBAAC,IAAI,IAAC,QAAQ,kCAAmB,CAClC,CACG,CACP,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,CAMtB;IACC,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,sBAAsB,CAAC;IACxD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtE,OAAO,CACL,oBAAC,GAAG,IAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,aAAa,EAAC,QAAQ,EAAC,YAAY,EAAE,CAAC;QACpD,oBAAC,IAAI,IAAC,KAAK,EAAC,OAAO,EAAC,IAAI;;YAErB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAC,IAAI,IAAC,KAAK,EAAC,SAAS;;gBAAK,CAAC,CAAC,UAAU,CAAQ,CAAC,CAAC,CAAC,IAAI,CAChE;QACP,oBAAC,GAAG,IAAC,UAAU,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ;YACvC,SAAS,IAAI,oBAAC,IAAI,IAAC,QAAQ,mBAAS;YACrC,oBAAC,IAAI,QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAQ,CAC1B,CACF,CACP,CAAC;AACJ,CAAC"}

package/dist/cli/components/SplashScreen.js

@@ -0,0 +1,158 @@
+/**
+ * SplashScreen — one-shot startup splash (v0.7.8).
+ *
+ * Shows the N-THEM / Zelari emblem (downscaled from the original 400-col
+ * ASCII art) centered in the terminal for ~2 seconds — or until any key is
+ * pressed — then unmounts and gives way to the normal App.
+ *
+ * Sizing: two pre-rendered variants (64 and 44 columns wide) are embedded
+ * as constants; `pickSplashArt` chooses the largest one that fits the
+ * current terminal, or returns null when even the small one doesn't fit
+ * (the splash is then skipped entirely).
+ *
+ * Skipped when stdout is not a TTY (pipes, CI) or `ZELARI_NO_SPLASH=1`.
+ */
+// NOTE: no import from '../main.js' here — main.ts executes `main()` at
+// module scope, so importing it from a component (or a unit test that
+// imports this component) would boot the whole CLI. The version string is
+// passed in as a prop instead.
+import React, { useEffect, useState } from 'react';
+import { Box, Text, useInput, useStdin } from 'ink';
+/** How long the splash stays up before auto-dismissing (ms). */
+export const SPLASH_DURATION_MS = 2000;
+// Downscaled from the source emblem (142×79) by block-averaging glyph
+// density — see docs/plans/2026-07-03-cli-splash-screen.md.
+const EMBLEM_LARGE = `                              =%@*-
+                            =%@@@@@#:
+                           *%%%%%%@@%-
+                         :#%%%%%%%%%@@*
+                       :*%%%%%%%%%%%%%@%*.
+                      =%%%%%%%%%%%%%%%%@@%.
+                     =%%%%%%%%%%%%%%%%%%%@%-
+                    *%%%%%%%%%%%%%%%%%%%%%@@=
+                  .#%%%%%%%%@@@@@@@@%%%%%%@@@+
+                 :#%%%%%%@@@@@@@@@@@@@@@%%%%@@+
+                -%%%%%@@@@@@@@@@@@@@@@@@@@@%%@@#.
+               -%%%%%@@@@@@@@@@@@@@@@@@@@@@@%%@@%:
+              =%%%%@@@@@@@@@@@@@@@@@@@@@@@@@@@%@@%.
+             +%%%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%@@%:
+            =%%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@-
+           -%%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%:
+          :%%%%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%
+          #%%%%%@@@@@@@@@@@@@@@%--#%@@@@@@@@@@@@@%%@@@=
+          #@@%%%%@@@@@@@@@@@@@@%:  -*@@@@@@@@@@@%%@@@@=
+           #@@%%%%@@@@@@@@@@@@@%: .. -#@@@@@@@%%%%@@@=
+            +@@@%%%@@@@@@@@@@@@%: :#=  =%@@@@%%%@@@%-
+             =@@@@%%%@@@@@@@@@@%: -%%*:  +%@@%%@@@#
+              +%@@@@%%@@@@@@@@@%: -%@@%*=.:+#@@@@#:
+          .+*@@@@@@@@@%%%@@@@@@%: -%@@@@@#-  +@@@@@@*=
+        =*%%%%@@@@@@@@@@@%%@@@@%: -#@@@@@@@*: :*@@@@@@%+=
+     -*%%%%%%%%%%@@@@@@@@@@@@@@@: -%@@@@@@@@#-  -#@@@@@@@@*
+     #%%%%%%%%%%%%%@@@@@@@@@@@@@: -#@@@@@%+-::.   *@@@@@@@@=
+    =%%%%%%%%%%%%%%%@@@@@@@@@@@@: :*+--=%#. :+++++*@@@@@@@@%
+    #@%%%%%%%%%%%%%@@@@@@@@@@@@%: .. -  -##  *@@@@@@@@@@@@@@=
+   :@@%%%%%%%%%%%%@@@@@@@@@@@@@%:  .**=  *%= :%@@@@@@@@@@@@@%
+   #@@@%%%%%%%%%%%@@@@@@@@@@@@@@- =#@@%- :**: =%@@@@@@@@@@@@@+
+  =@@@@@%%%@@%%%%@@@@@@@@@@@@@@@@@@@@@@%- :: .-#@@@@@@@@@@@@@%.
+ :@@@@@@%%@@@%%@@@@@@@@@@@@@@@@@@@@@@@@@%==*%%@@@@@@@@@@@@@@@@#
+ *@@@@@@@%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@:
+:@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@+
+=##########*######**##**#*********##**#*#######################*`;
+const EMBLEM_SMALL = `                    =%%*:
+                  :#%%@@@+
+                 =%%%%%%%@#.
+               .*%%%%%%%%%@%-
+              =%%%%%%%%%%%%%@*.
+             +%%%%%%@@@@@%%%%@%:
+            *%%%%@@@@@@@@@@@%%@%:
+           *%%%@@@@@@@@@@@@@@@%@%-
+         :#%%@@@@@@@@@@@@@@@@@@@@@+
+        :%%%@@@@@@@@@@@@@@@@@@@@@@@+
+        #%%@@@@@@@@@@@@@@@@@@@@@@@@@-
+       +%%@@@@@@@@@@@@#@@@@@@@@@@@@@%:
+       %%%%@@@@@@@@@@%::*@@@@@@@@@%@@=
+       -%@%%@@@@@@@@@%:.::*@@@@@%%@@*.
+        :%@@%%@@@@@@@%.:%#::*@@%@@@-
+         :#@@@%@@@@@@%.:%@%+.-#@@@=
+      :+#@@@@@@@%@@@@%.:%@@@%=.+@@@%*-
+   .*#%%%%%%@@@@@@@@@@.:%@@@@@*:.+%@@@@#-
+   +%%%%%%%%%%@@@@@@@@::##*%* :----%@@@@%.
+  .@%%%%%%%%%@@@@@@@@@:.-..-#=:%@@@@@@@@@+
+  *@@%%%%%%%%@@@@@@@@@: =#+ +#.-@@@@@@@@@@.
+ -@@@%%%%%%%@@@@@@@@@@#%@@@- -.:*@@@@@@@@@*
+ %@@@@%@@%@@@@@@@@@@@@@@@@@%**%@@@@@@@@@@@@:
+=@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@*`;
+/** Rows the footer (wordmark + version + hint + margins) needs below the art. */
+const FOOTER_ROWS = 5;
+function measure(art) {
+    const lines = art.split('\n');
+    return {
+        art,
+        width: Math.max(...lines.map((l) => l.length)),
+        height: lines.length,
+    };
+}
+const VARIANTS = [measure(EMBLEM_LARGE), measure(EMBLEM_SMALL)];
+/**
+ * Pure helper: pick the largest emblem variant that fits `columns`×`rows`
+ * (leaving room for the wordmark footer), or null when none fits.
+ */
+export function pickSplashArt(columns, rows) {
+    for (const v of VARIANTS) {
+        if (v.width <= columns - 2 && v.height + FOOTER_ROWS <= rows)
+            return v;
+    }
+    return null;
+}
+/**
+ * Pure helper: should the splash be shown at all?
+ * Skipped for non-TTY stdout (pipes/CI), when ZELARI_NO_SPLASH=1, or when
+ * the terminal is too small for even the small variant.
+ */
+export function shouldShowSplash(opts) {
+    if (!opts.isTTY)
+        return false;
+    if (opts.env['ZELARI_NO_SPLASH'] === '1')
+        return false;
+    return pickSplashArt(opts.columns, opts.rows) !== null;
+}
+function Splash({ onDone, version }) {
+    const { isRawModeSupported } = useStdin();
+    const columns = process.stdout.columns ?? 80;
+    const rows = process.stdout.rows ?? 24;
+    const picked = pickSplashArt(columns, rows);
+    useEffect(() => {
+        const t = setTimeout(onDone, SPLASH_DURATION_MS);
+        return () => clearTimeout(t);
+    }, [onDone]);
+    // Any key skips the splash. Guarded: useInput throws without raw mode.
+    useInput(() => {
+        onDone();
+    }, { isActive: isRawModeSupported === true });
+    if (!picked)
+        return null;
+    return (React.createElement(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", width: columns, height: rows - 1 },
+        React.createElement(Text, { color: "cyan" }, picked.art),
+        React.createElement(Box, { marginTop: 1 },
+            React.createElement(Text, { bold: true, color: "white" }, 'Z E L A R I   C O D E')),
+        React.createElement(Text, { dimColor: true }, `${version ? `v${version} — ` : ''}N-THEM Studio`),
+        React.createElement(Text, { dimColor: true, italic: true }, "press any key to skip")));
+}
+/**
+ * SplashGate — renders the splash first, then swaps in `children` (the
+ * real App). The App therefore mounts only after the splash dismisses,
+ * so its <Static> banner and raw-mode input never fight the splash.
+ */
+export function SplashGate({ children, version, }) {
+    const [show, setShow] = useState(() => shouldShowSplash({
+        isTTY: process.stdout.isTTY === true,
+        env: process.env,
+        columns: process.stdout.columns ?? 80,
+        rows: process.stdout.rows ?? 24,
+    }));
+    if (show) {
+        return React.createElement(Splash, { onDone: () => setShow(false), version: version });
+    }
+    return React.createElement(React.Fragment, null, children);
+}
+//# sourceMappingURL=SplashScreen.js.map

package/dist/cli/components/SplashScreen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SplashScreen.js","sourceRoot":"","sources":["../../../src/cli/components/SplashScreen.tsx"],"names":[],"mappings":"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"}