s-app-scoder-agent 0.9.9 → 0.9.10

package/dist/agent/guardrails.js

@@ -167,6 +167,23 @@ const continueNudgeRule = { name: "continue-nudge",
             return null;
         if (claimsCompletion(ctx.text))
             return null; // completion-claim rule phụ trách
+        // P0-8: text-only + không sửa file + không có plan mở ⇒ đây là LƯỢT CHAT.
+        // Finish ngay với chính text làm summary — trước đây rule này inject nudge
+        // ⇒ thêm 1 LLM call ~14,5k token mỗi câu chào (đo: call 2 in=14.569, chỉ
+        // thêm đúng dòng nudge 81 token). Bài học aec95ef giữ nguyên: nhánh CÓ
+        // sửa file vẫn nudge/ép build bên dưới; plan còn mở (model nghỉ giữa
+        // task, quên gọi tool) cũng vẫn nudge.
+        if (!ctx.filesModified && ctx.planOpen !== true) {
+            return {
+                action: {
+                    kind: "finish",
+                    success: true,
+                    summary: ctx.text || "(agent replied without acting)",
+                    chatOnly: true,
+                },
+                reason: "chat turn: tool-less step, no files modified, no open plan — one LLM call per message",
+            };
+        }
         // No file changed yet → never demand a build for what may be a pure Q&A or
         // an explanation-only answer. Give the model the explicit conversational
         // exit instead; text-only-streak still ends the run if it keeps stalling.

package/dist/agent/prompt-context.js

@@ -19,7 +19,12 @@ export function buildRunMessages(input) {
     const { config, primaryDef, skills, buildCmd, task, pendingContext } = input;
     const skillsBlock = buildSkillsBlock(skills);
     const agentsGuideBlock = buildAgentGuideBlock(config.workdir, task);
-    const repoMapBlock = config.repoMap === false ? "" : `\n\n${buildRepoMap(config.workdir)}`;
+    // P0-10: REPO MAP rời khỏi system prompt. Map mô tả TRẠNG THÁI repo — mỗi
+    // byte đổi (file mới, tên symbol đổi) làm lệch prefix system+tools ở token
+    // ~954 ⇒ mọi cửa sổ mới mất 96% KV-cache (đo: cached 14.484 → 0, TTFT
+    // 0,2 s → 30–47 s). Đặt làm message sát task: prefix system+tools+junk byte
+    // stable giữa các cửa sổ, map (cold) chỉ còn là đuôi ~2k token.
+    const repoMapBlock = config.repoMap === false ? "" : buildRepoMap(config.workdir);
     const baseOverride = primaryDef?.prompt?.trim() ? primaryDef.prompt : undefined;
     return [
         {
@@ -31,12 +36,20 @@ export function buildRunMessages(input) {
                 skillsBlock,
                 mcpBlock: buildMcpBlock(config),
                 agentsGuideBlock,
-                repoMapBlock,
+                repoMapBlock: "",
                 base: baseOverride,
                 promptVersion: config.promptVersion,
             }) + buildAgentsBlock(discoverAgents(config.workdir), config.allowSubagents !== false),
         },
         ...pendingContext.map((content) => ({ role: "user", content })),
+        ...(repoMapBlock
+            ? [{
+                    role: "user",
+                    content: "[Context — repository map as of session start; paths + exported symbols only. " +
+                        "If a file looks missing or stale, confirm with list_files/glob/repo_map rather than assume.]\n\n" +
+                        repoMapBlock,
+                }]
+            : []),
         { role: "user", content: task },
     ];
 }

package/dist/agent/run-loop.js

@@ -246,6 +246,9 @@ export async function runAgentLoop(runtime, startSteps, buildCmd, initialBuild =
             buildCallPresent: !!buildCall,
             filesModified: runtime.filesModified,
             chatDone,
+            // P0-8: plan chưa xong ⇒ bước text-only chỉ là nghỉ giữa task (nudge);
+            // plan trống/đủ ⇒ rule coi đó là lượt chat và finish (1 call).
+            planOpen: runtime.plan.some((t) => t.status !== "completed"),
             outputTokensThisStep: usage?.completion_tokens,
             totalTokensIn: runtime.usageTotals.inputTokens, // G6 budget rule
             totalTokensOut: runtime.usageTotals.outputTokens,

package/dist/context/repo-map.js

@@ -104,19 +104,21 @@ export function extractSymbols(path, content) {
     return [...out].slice(0, MAX_SYMBOLS_PER_FILE);
 }
 // ── Rendering ────────────────────────────────────────────────────────────────
-function kb(size) {
-    return size >= 1024 * 1024 ? `${(size / 1024 / 1024).toFixed(1)}MB` : `${Math.max(1, Math.round(size / 1024))}KB`;
-}
-/** Render the map without touching the cache (used for sub-tree maps). */
+/** Render the map without touching the cache (used for sub-tree maps).
+ * P0-10: deliberately NO per-file sizes and NO file-count header — those bytes
+ * change on every edit/add and used to invalidate the KV-cache prefix of every
+ * fresh window (measured: 1 char in REPO MAP ⇒ cached=0, TTFT 30–47 s). Symbol
+ * names still change only when a file's exported API changes, so the map is
+ * byte-stable across normal coding. */
 export function renderRepoMap(workdir, budgetChars = DEFAULT_BUDGET_CHARS, sub = ".") {
     const files = walkRepo(workdir, sub);
     const lines = [
-        `REPO MAP — ${files.length} files (auto-generated; orient from this, don't read everything)`,
+        "REPO MAP — auto-generated; orient from this, don't read everything",
     ];
     let budget = budgetChars;
     let truncated = 0;
     for (const f of files) {
-        let line = `  ${f.rel} (${kb(f.size)})`;
+        let line = `  ${f.rel}`;
         if (SYMBOL_FILE.test(f.rel) && f.size <= MAX_FILE_BYTES) {
             try {
                 const syms = extractSymbols(f.rel, readFileSync(f.abs, "utf8"));

package/dist/tui/app.js

@@ -19,6 +19,7 @@ import { setQuiet } from "../io/terminal.js";
 import { discoverSkills } from "../context/skills.js";
 import { discoverAgents } from "../context/agents.js";
 import { initialState } from "./state.js";
+import { transcriptWindow, estimateTotalRows } from "./selectors.js";
 import { SLASH_COMMANDS, formatSlashHelp } from "../commands/definitions.js";
 import { ChatItemView } from "./chat-views.js"; // T2
 import { BuildRail, StatusBar, SIDEBAR_MIN_COLS, SIDEBAR_WIDTH } from "./chrome.js"; // T2
@@ -95,13 +96,25 @@ export function TuiApp({ config, initialTask }) {
         agentRef.current?.dispose();
         agentRef.current = null;
     }, []);
-    // ── Scrollable chat viewport (Ink 8 alt-screen) ──
-    // The viewport clips overflow; the inner content wrapper keeps its natural
-    // height so it can be measured and offset upward for scrolling.
-    const { viewportRef, contentRef, viewport, content, viewportRowsRef } = useScrollMetrics(setScrollOffset);
-    const maxScroll = Math.max(0, content.height - viewport.clientHeight);
-    // scrollOffset counts rows UP from the bottom; 0 = follow the newest item.
-    const scrollTop = Math.max(0, maxScroll - scrollOffset);
+    // ── Scrollable chat viewport (Ink 8 alt-screen) — P1-8 virtualized ──
+    // Chi phí layout/wrap mỗi frame tỷ lệ với số item MOUNT, không phải số
+    // item transcript ⇒ chỉ mount cửa sổ quanh viewport (transcriptWindow).
+    // Scroll offset khi đọc lại dùng rows ước lượng; khi BÁM ĐÁY dùng chiều
+    // cao THẬT của cửa sổ đã mount (đo rẻ vì cửa sổ ~viewport+overscan) —
+    // estimate sai lệch bao nhiêu thì dòng cuối vẫn luôn thấy.
+    const { viewportRef, viewport, contentRef, content, viewportRowsRef } = useScrollMetrics(setScrollOffset);
+    const viewportRows = viewport.clientHeight || 24;
+    const win = useMemo(() => {
+        const total = estimateTotalRows(state.items);
+        const max = Math.max(0, total - viewportRows);
+        const top = Math.max(0, max - scrollOffset);
+        return { ...transcriptWindow(state.items, top, viewportRows), maxScroll: max };
+    }, [state.items, scrollOffset, viewportRows]);
+    const maxScroll = win.maxScroll;
+    // Follow-bottom (scrollOffset = 0): offset chính xác theo số đo thật.
+    const contentOffset = scrollOffset === 0 && content.hasMeasured
+        ? Math.max(0, content.height - viewport.clientHeight)
+        : win.offset;
     const skills = useMemo(() => discoverSkills(cfg.workdir), [cfg.workdir]);
     const skillNames = useMemo(() => skills.map((s) => s.name), [skills]);
     // T-02: completion sources (agents + files) computed once per mount.
@@ -164,19 +177,20 @@ export function TuiApp({ config, initialTask }) {
             setScrollOffset(0);
         prevStatusRef.current = state.status;
     }, [state.status]);
-    // The viewport renders items at full height so scroll math (content.height) is
-    // always correct. Ink clips with overflow="hidden"; contentOffsetY shifts the
-    // content column upward to reveal items above the current bottom.
+    // P1-8: viewport mount CỬA SỔ item quanh scrollTop (transcriptWindow), không
+    // mount cả transcript — chi phí layout/wrap mỗi frame hết tỷ lệ với tổng text.
+    // Ink clip bằng overflow="hidden"; contentOffsetY = số dòng phải ẩn ở đầu
+    // cửa sổ (scrollTop - startRow[item_start]).
     const { rows, columns } = useWindowSize();
     const showSidebar = (columns ?? 100) >= SIDEBAR_MIN_COLS;
     return (
     // flexShrink={0}: pinned chrome must never be squeezed when the chat
     // content overflows — Ink defaults every box to flexShrink:1, which
     // shrank the input bar to zero rows once the log outgrew the terminal.
-    _jsxs(Box, { flexDirection: "column", height: rows || 24, flexShrink: 0, children: [_jsx(BuildRail, { state: state, config: cfg }), _jsxs(Box, { flexDirection: "row", flexGrow: 1, flexShrink: 1, minHeight: 0, children: [_jsx(Box, { ref: viewportRef, flexDirection: "column", flexGrow: 1, flexShrink: 1, minHeight: 0, overflow: "hidden", contentOffsetY: scrollTop, children: _jsxs(Box, { ref: contentRef, flexDirection: "column", paddingX: 1, flexShrink: 0, children: [state.items.length === 0 ? (
+    _jsxs(Box, { flexDirection: "column", height: rows || 24, flexShrink: 0, children: [_jsx(BuildRail, { state: state, config: cfg }), _jsxs(Box, { flexDirection: "row", flexGrow: 1, flexShrink: 1, minHeight: 0, children: [_jsx(Box, { ref: viewportRef, flexDirection: "column", flexGrow: 1, flexShrink: 1, minHeight: 0, overflow: "hidden", contentOffsetY: contentOffset, children: _jsxs(Box, { ref: contentRef, flexDirection: "column", paddingX: 1, flexShrink: 0, children: [state.items.length === 0 ? (
                                 // Welcome: căn giữa cả 2 chiều — height = chiều cao đo được của
                                 // viewport (flexGrow không giãn được vì content box flexShrink=0).
-                                _jsxs(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", height: viewport.clientHeight || undefined, children: [(columns ?? 100) - (showSidebar ? SIDEBAR_WIDTH + 2 : 4) >= 54 ? (_jsx(Box, { flexDirection: "column", alignItems: "center", children: (isAsciiMode() ? BANNER_ASCII : BANNER).map((line, i) => (_jsx(Text, { bold: true, color: theme.brand, children: line }, i))) })) : (_jsx(Text, { bold: true, color: theme.brand, children: "\u2691 SCoder" })), _jsx(Text, { dimColor: true, children: `autonomous coding agent · v${getVersion()}` }), _jsx(Text, {}), _jsx(Text, { dimColor: true, children: "type a task to start \u2014 the agent plans, edits, and builds" }), _jsx(Text, {}), _jsxs(Text, { children: [_jsx(Text, { bold: true, color: theme.accent, children: "\u23CE" }), _jsx(Text, { dimColor: true, children: " send   " }), _jsx(Text, { bold: true, color: theme.accent, children: "ctrl+s" }), _jsx(Text, { dimColor: true, children: " sessions   " }), _jsx(Text, { bold: true, color: theme.accent, children: "tab" }), _jsx(Text, { dimColor: true, children: " complete   " }), _jsx(Text, { bold: true, color: theme.accent, children: "/help" }), _jsx(Text, { dimColor: true, children: " commands" })] })] })) : (state.items.map((item, i) => _jsx(ChatItemView, { item: item, width: (columns ?? 100) - (showSidebar ? SIDEBAR_WIDTH + 2 : 4) }, i))), lastSummary && (_jsx(Box, { marginTop: 1, children: state.status === "success" ? (_jsxs(Text, { color: theme.success, bold: true, children: ["\u2714 ", lastSummary] })) : state.status === "aborted" ? (_jsxs(Text, { color: theme.warn, bold: true, children: ["\u23F9 ", lastSummary] })) : (_jsxs(Text, { color: theme.error, bold: true, children: ["\u2718 ", lastSummary] })) }))] }) }), showSidebar && _jsx(Sidebar, { state: state, config: cfg, rows: viewport.clientHeight || undefined })] }), sessionPickerOpen && (_jsx(SessionPicker, { workdir: cfg.workdir, onSelect: handleSessionSelect, onClose: () => setSessionPickerOpen(false) })), paletteOpen && (_jsxs(Box, { flexDirection: "column", borderStyle: boxBorderStyle(), borderColor: theme.accent, paddingX: 1, paddingY: 1, children: [_jsx(Text, { color: theme.accent, bold: true, children: "Command palette (Ctrl+P to close)" }), SLASH_COMMANDS.slice(0, 40).map((c) => (_jsxs(Text, { children: [c.cmd.padEnd(12), " ", c.desc] }, c.cmd)))] })), helpOpen && (_jsxs(Box, { flexDirection: "column", borderStyle: boxBorderStyle(), borderColor: theme.dim, paddingX: 1, paddingY: 1, children: [_jsx(Text, { color: theme.brand, bold: true, children: "Help (?)" }), _jsx(Text, { children: formatSlashHelp("scoder tui") })] })), permPrompt && _jsx(PermissionModal, { prompt: permPrompt }), _jsx(Box, { paddingX: 1, paddingTop: 0, paddingBottom: 0, flexShrink: 0, alignSelf: "stretch", children: _jsx(Input, { valueRef: inputRef, value: input, onChange: writeInput, onSubmit: (v) => void submit(v), historyRef: historyRef, skillNames: skillNames, agentRef: agentRef, config: cfg, atSources: atSources, modalRef: permPromptRef }) }), _jsx(StatusBar, { state: state, scroll: scrollOffset > 0 ? `↑ ${Math.min(scrollOffset, maxScroll)}/${maxScroll}` : null })] }));
+                                _jsxs(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", height: viewport.clientHeight || undefined, children: [(columns ?? 100) - (showSidebar ? SIDEBAR_WIDTH + 2 : 4) >= 54 ? (_jsx(Box, { flexDirection: "column", alignItems: "center", children: (isAsciiMode() ? BANNER_ASCII : BANNER).map((line, i) => (_jsx(Text, { bold: true, color: theme.brand, children: line }, i))) })) : (_jsx(Text, { bold: true, color: theme.brand, children: "\u2691 SCoder" })), _jsx(Text, { dimColor: true, children: `autonomous coding agent · v${getVersion()}` }), _jsx(Text, {}), _jsx(Text, { dimColor: true, children: "type a task to start \u2014 the agent plans, edits, and builds" }), _jsx(Text, {}), _jsxs(Text, { children: [_jsx(Text, { bold: true, color: theme.accent, children: "\u23CE" }), _jsx(Text, { dimColor: true, children: " send   " }), _jsx(Text, { bold: true, color: theme.accent, children: "ctrl+s" }), _jsx(Text, { dimColor: true, children: " sessions   " }), _jsx(Text, { bold: true, color: theme.accent, children: "tab" }), _jsx(Text, { dimColor: true, children: " complete   " }), _jsx(Text, { bold: true, color: theme.accent, children: "/help" }), _jsx(Text, { dimColor: true, children: " commands" })] })] })) : (state.items.slice(win.start, win.end).map((item, i) => (_jsx(ChatItemView, { item: item, width: (columns ?? 100) - (showSidebar ? SIDEBAR_WIDTH + 2 : 4) }, win.start + i)))), lastSummary && (_jsx(Box, { marginTop: 1, children: state.status === "success" ? (_jsxs(Text, { color: theme.success, bold: true, children: ["\u2714 ", lastSummary] })) : state.status === "aborted" ? (_jsxs(Text, { color: theme.warn, bold: true, children: ["\u23F9 ", lastSummary] })) : (_jsxs(Text, { color: theme.error, bold: true, children: ["\u2718 ", lastSummary] })) }))] }) }), showSidebar && _jsx(Sidebar, { state: state, config: cfg, rows: viewport.clientHeight || undefined })] }), sessionPickerOpen && (_jsx(SessionPicker, { workdir: cfg.workdir, onSelect: handleSessionSelect, onClose: () => setSessionPickerOpen(false) })), paletteOpen && (_jsxs(Box, { flexDirection: "column", borderStyle: boxBorderStyle(), borderColor: theme.accent, paddingX: 1, paddingY: 1, children: [_jsx(Text, { color: theme.accent, bold: true, children: "Command palette (Ctrl+P to close)" }), SLASH_COMMANDS.slice(0, 40).map((c) => (_jsxs(Text, { children: [c.cmd.padEnd(12), " ", c.desc] }, c.cmd)))] })), helpOpen && (_jsxs(Box, { flexDirection: "column", borderStyle: boxBorderStyle(), borderColor: theme.dim, paddingX: 1, paddingY: 1, children: [_jsx(Text, { color: theme.brand, bold: true, children: "Help (?)" }), _jsx(Text, { children: formatSlashHelp("scoder tui") })] })), permPrompt && _jsx(PermissionModal, { prompt: permPrompt }), _jsx(Box, { paddingX: 1, paddingTop: 0, paddingBottom: 0, flexShrink: 0, alignSelf: "stretch", children: _jsx(Input, { valueRef: inputRef, value: input, onChange: writeInput, onSubmit: (v) => void submit(v), historyRef: historyRef, skillNames: skillNames, agentRef: agentRef, config: cfg, atSources: atSources, modalRef: permPromptRef }) }), _jsx(StatusBar, { state: state, scroll: scrollOffset > 0 ? `↑ ${Math.min(scrollOffset, maxScroll)}/${maxScroll}` : null })] }));
 }
 /** Mount the TUI (called from the `scoder tui` subcommand). */
 export async function runTui(config, initialTask) {

package/dist/tui/hooks/use-scroll.js

@@ -1,4 +1,7 @@
-/** Scroll viewport metrics + mouse wheel (SGR 1006) wiring for the TUI. */
+/** Scroll viewport metrics + mouse wheel (SGR 1006) wiring for the TUI.
+ * P1-8: contentRef giờ đo CỬA SỔ item đã mount (không phải cả transcript) —
+ * chi phí đo O(window) nên vẫn rẻ; số đo thật dùng cho follow-bottom chính
+ * xác, ước lượng (transcriptWindow) chỉ dùng khi scroll lên trên. */
 import { useCallback, useEffect, useRef } from "react";
 import { useBoxMetrics, useStdin } from "ink";
 import { parseWheel, MOUSE_ENABLE, MOUSE_DISABLE } from "../mouse.js";
@@ -34,5 +37,5 @@ export function useScrollMetrics(setScrollOffset) {
             process.stdout.write(MOUSE_DISABLE);
         };
     }, [stdin, setRawMode, isRawModeSupported, wheelScroll]);
-    return { viewportRef, contentRef, viewport, content, viewportRowsRef };
+    return { viewportRef, viewport, contentRef, content, viewportRowsRef };
 }

package/dist/tui/selectors.js

@@ -70,11 +70,13 @@ export function estimateMarkdownRows(text, width = EST_WIDTH) {
 export function estimateItemRows(item) {
     switch (item.kind) {
         case "user":
-            return 2 + Math.ceil(item.text.length / 80);
+            // Render: marginTop 1 + border-left box paddingX 1, wrap theo chat width
+            // (~60–96 cột). 60 là giả định hẹp an toàn (over-estimate nhẹ).
+            return 2 + wrapEstimate(item.text ?? "", 60);
         case "assistant":
             // +1 marginTop; streaming raw text dùng wrap đơn giản (chưa qua markdown).
             return item.streaming
-                ? wrapEstimate(item.text ?? "", EST_WIDTH)
+                ? (item.text ? 1 : 0) + wrapEstimate(item.text ?? "", 76)
                 : 1 + estimateMarkdownRows(item.text ?? "", EST_WIDTH);
         case "thinking":
             // Render: collapse to last 4 lines.
@@ -82,7 +84,7 @@ export function estimateItemRows(item) {
         case "tool":
             return 1 + 2; // title + preview 2 lines
         case "compaction":
-            return 1;
+            return 2; // marginTop + divider
         case "diff":
             return 3 + Math.min(24, (item.text?.split("\n").length ?? 0)); // header + ≤24 lines + border
         case "todo":
@@ -90,15 +92,19 @@ export function estimateItemRows(item) {
             // chiếm 0 dòng thực tế trong transcript.
             return 0;
         case "build":
-            return 1;
+            return 3; // marginTop + label + command
         case "notice":
-            return 1 + Math.ceil(item.text.length / 2000);
+            // Render raw text (cap 2000 chars) với wrap thật theo width — /help là
+            // notice 40 dòng; estimate cũ (1 + len/2000) under-estimate khiến
+            // follow-bottom clip dòng kế tiếp ( regression caught by tui.test E2E).
+            return 1 + wrapEstimate(item.text.length > 2000 ? item.text.slice(0, 2000) + "…" : item.text, 76);
     }
 }
 /**
  * T4: chọn window item để render: lấy từ cuối lên tới khi tổng rows ước
  * lượng ≥ viewportRows + margin (render dư phía trên để scroll mượt), nhưng
- * giữ toàn bộ khi tổng nhỏ. Trả về slice của items (không mutate).
+ * giữ toàn bộ khi tổng nhỏ. Trả về slice của items (không rẻ — dùng
+ * transcriptWindow cho scroll đúng offset, hàm này chỉ còn cho callers cũ).
  */
 export function visibleWindow(items, viewportRows, margin = 50) {
     const budget = viewportRows + margin;
@@ -110,6 +116,55 @@ export function visibleWindow(items, viewportRows, margin = 50) {
     }
     return start === 0 ? items : items.slice(start);
 }
+// P1-8: cache số dòng ước lượng theo IDENTITY của item. state.ts patch item
+// kiểu immutable (object mới khi nội dung đổi) ⇒ item finalized không bao giờ
+// tính lại; chỉ item đang stream (mỗi flush đổi reference) mới estimate lại.
+const itemRowsCache = new WeakMap();
+function itemRowsCached(item) {
+    const hit = itemRowsCache.get(item);
+    if (hit !== undefined)
+        return hit;
+    const v = estimateItemRows(item);
+    itemRowsCache.set(item, v);
+    return v;
+}
+/** Tổng chiều cao ước lượng của cả transcript — O(n) phép cộng số nhỏ. */
+export function estimateTotalRows(items) {
+    let acc = 0;
+    for (const it of items)
+        acc += itemRowsCached(it);
+    return acc;
+}
+/**
+ * P1-8 — virtualization cho transcript viewport. Mount duy các item phủ
+ * [scrollTop - overscan, scrollTop + viewportRows + overscan] thay vì cả
+ * transcript: chi phí React diff + Yoga layout + wrap mỗi frame hết tỷ lệ
+ * với tổng số text (đo: 42–53 ms/frame ở 300–400 item → ~7 ms khi window).
+ * Scroll dùng ước lượng rows (estimateItemRows, cache theo identity item),
+ * nên khi estimate lệch thực tế thì offset chỉ sai vài dòng — cùng trade-off
+ * mọi TUI virtualized dùng.
+ */
+export function transcriptWindow(items, scrollTop, viewportRows, overscan = 24) {
+    const n = items.length;
+    // Cumulative start rows một lượt O(n) nhưng chỉ là phép cộng số nhỏ.
+    const startRow = new Array(n + 1);
+    startRow[0] = 0;
+    for (let i = 0; i < n; i++)
+        startRow[i + 1] = startRow[i] + itemRowsCached(items[i]);
+    const totalRows = startRow[n];
+    const top = Math.max(0, Math.min(scrollTop, totalRows));
+    const target = Math.max(0, top - overscan);
+    let start = 0;
+    while (start + 1 < n && startRow[start + 1] <= target)
+        start++;
+    const bottomTarget = top + viewportRows + overscan;
+    let end = start;
+    while (end < n && startRow[end] < bottomTarget)
+        end++;
+    if (end === start && start < n)
+        end = start + 1; // item khổng lồ vẫn phải hiện
+    return { start, end, offset: top - startRow[start], totalRows };
+}
 /**
  * Plan mới nhất cho sidebar — todo items được append mỗi lần update nhưng
  * sidebar chỉ cần snapshot hiện tại (last-wins), null khi chưa có plan.

package/dist/tui/state.js

@@ -79,7 +79,7 @@ function applyGuardrail(state, ev) {
 }
 // Pure selectors live in ./selectors.js (Phase 5.4) — re-exported so existing
 // import sites (app.tsx, hooks, tests) keep working unchanged.
-export { estimateItemRows, visibleWindow, latestPlan, toolPhase } from "./selectors.js";
+export { estimateItemRows, visibleWindow, transcriptWindow, estimateTotalRows, latestPlan, toolPhase } from "./selectors.js";
 /**
  * Fold one AgentEvent into the state (mutates `state`, returns it for
  * reducer-style chaining). Unknown events are ignored.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "s-app-scoder-agent",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "description": "Autonomous coding agent CLI — writes, edits, and builds code autonomously until the project compiles without errors.",
   "type": "module",
   "main": "dist/index.js",