s-app-scoder-agent 0.9.8 → 0.9.10

package/dist/tools/read-file.js

@@ -1,7 +1,7 @@
 import { readFileSync, statSync, realpathSync } from "node:fs";
 import { relative } from "node:path";
 import { detectImageBytes } from "../media/image.js";
-import { clamp, MAX_FILE_SIZE_BYTES, safePath, toPosInt, toResult } from "./path-safety.js";
+import { clamp, MAX_FILE_SIZE_BYTES, MAX_OUTPUT_CHARS, MAX_TOOL_OUTPUT_CHARS, safePath, toPosInt, toResult } from "./path-safety.js";
 import { isProtectedEnvFile } from "./path-safety.js";
 export function toolReadFile(workdir, args) {
     return toResult(() => {
@@ -56,9 +56,29 @@ export function toolReadFile(workdir, args) {
         const offset = Math.min(toPosInt(args.offset, 1), total);
         const limit = Math.min(toPosInt(args.limit, total - offset + 1), 2000);
         const slice = lines.slice(offset - 1, offset - 1 + limit);
-        const numbered = slice.map((l, i) => `${offset + i}: ${l}`).join("\n");
-        const end = offset + slice.length - 1;
+        const numberedAll = slice.map((l, i) => `${offset + i}: ${l}`);
+        // P0-2 (RC-3): cắt theo DÒNG ngay tại ngân sách history (limits.toolOutputChars)
+        // và nói rõ phần còn lại nằm ở dòng nào + lấy tiếp bằng tham số nào. Trunc mù
+        // kiểu "... more chars" từng khiến agent đọc lại cả file bằng "cách khác".
+        const budget = Math.max(200, Math.min(MAX_TOOL_OUTPUT_CHARS, MAX_OUTPUT_CHARS));
+        const kept = [];
+        let used = 0;
+        for (const line of numberedAll) {
+            if (used + line.length + 1 > budget && kept.length > 0)
+                break;
+            kept.push(line);
+            used += line.length + 1;
+        }
+        const dropped = numberedAll.length - kept.length;
+        const end = offset + kept.length - 1;
         const header = offset > 1 || end < total ? `[lines ${offset}-${end} of ${total} — ${args.path}]\n` : "";
-        return { ok: true, output: clamp(header + numbered) };
+        const footer = dropped > 0
+            ? `\n... [${dropped} more line(s): ${end + 1}-${offset + slice.length - 1} of ${total}. ` +
+                `Read the next chunk with read_file({"path":"${args.path}","offset":${end + 1}}) — ` +
+                `do NOT re-read from the start.]`
+            : "";
+        // clamp cho dòng kếch xù (một dòng 40k ký tự vẫn phải nằm trong ngân sách).
+        const numbered = clamp(kept.join("\n"), budget);
+        return { ok: true, output: header + numbered + footer };
     });
 }

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/hooks/use-submit.js

@@ -83,9 +83,9 @@ export function useSubmit(deps) {
         setScrollOffset(0);
         // isFirst must be computed BEFORE pushing the user item below.
         const isFirst = stateRef.current.items.every((i) => i.kind !== "user");
-        // runTurn() doesn't emit run_start, so the TUI shows the user's message
-        // itself; applyEvent's run_start dedupe keeps turn 1 from doubling.
-        // runTurn cũng không reset plan — reset ở đây (user message mới).
+        // run_start (cả run() lẫn runTurn() đều phát) dedupe với dòng user mà TUI
+        // vừa push ở dòng trên, nên câu hỏi thứ 2+ không hiển thị hai lần.
+        // runTurn cũng reset plan — cùng semantics với run_start.
         update((s) => ({ ...s, plan: null, items: [...s.items, { kind: "user", text: task }], status: "running", summary: null }));
         const agent = createAgent();
         try {

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.
@@ -118,9 +118,10 @@ export function applyEvent(state, ev) {
             state.llmCallStartedAt = null;
             state.lastLlmTokPerSec = null;
             // The TUI pushes the user's message itself when submitting; avoid a
-            // duplicate when run_start carries the same task.
+            // duplicate when run_start carries the same task. `quiet` (resume) =
+            // transcript đã hiển thị rồi, không append nữa.
             const last = lastItem(state);
-            if (!(last && last.kind === "user" && last.text === ev.task)) {
+            if (!ev.quiet && !(last && last.kind === "user" && last.text === ev.task)) {
                 appendItem(state, { kind: "user", text: ev.task });
             }
             // Plan của task trước không được lọt sang task mới.

package/dist/workspace/build.js

@@ -31,9 +31,12 @@ export function detectBuildCommand(workdir) {
  * Run the build command. This is the agent's stop condition:
  * exit code 0 == task complete.
  * `onOutput` (optional) receives stdout/stderr chunks live while the build runs.
+ * `timeoutSecs` (P1-2) tới từ `limits.buildTimeoutSecs` — trước đây hardcode
+ * 600s, không điều chỉnh được khi verify trên máy chậm.
  */
-export async function runBuild(workdir, command, onOutput) {
-    const res = await toolRunCommand(workdir, { command, timeout_secs: 600 }, undefined, onOutput);
+export async function runBuild(workdir, command, onOutput, timeoutSecs) {
+    const timeout = Number.isFinite(timeoutSecs ?? NaN) && (timeoutSecs ?? 0) > 0 ? Math.floor(timeoutSecs) : 600;
+    const res = await toolRunCommand(workdir, { command, timeout_secs: timeout }, undefined, onOutput);
     return {
         success: res.ok,
         command,

package/dist/workspace/file-index.js

@@ -9,9 +9,14 @@ import { join, relative } from "node:path";
 import fuzzysort from "fuzzysort";
 const SKIP = new Set(["node_modules", ".git", "dist", "build", ".next", "__pycache__", ".venv"]);
 let cache = null;
-/** File index for `workdir` (cached, TTL 5s; invalidateFileIndex on tool writes). */
-export function fileIndex(workdir) {
-    if (cache && Date.now() - cache.built < 5_000)
+/**
+ * File index for `workdir` (cached, TTL 5s; invalidateFileIndex on tool writes).
+ * `force` (P1-2) bỏ qua cache — dùng cho fingerprint, nơi một file mới được tạo
+ * bởi `run_command`/trình sửa ngoài PHẢI đổi hash, nếu không kết quả verify cũ
+ * sẽ được tái sử dụng sai.
+ */
+export function fileIndex(workdir, force = false) {
+    if (!force && cache && Date.now() - cache.built < 5_000)
         return cache.files;
     const files = [];
     // Fast path: ripgrep --files (gitignore-aware). Bare-name globs match at any

package/dist/workspace/fingerprint.js

@@ -0,0 +1,44 @@
+/**
+ * P1-2 (RC-5): fingerprint trạng thái workspace — dùng để KHÔNG chạy lại
+ * build/test/typecheck/lint khi không có gì thay đổi.
+ *
+ * Chi phí: 1 lần `stat` mỗi file (danh sách file lấy từ file-index —
+ * gitignore-aware, TTL 5s, đã invalidate mỗi lần tool write/edit). Không đọc
+ * nội dung file: size + mtime đổi khi agent sửa code; độ chính xác đủ cho một
+ * CACHE (kết quả cũ chỉ được tái sử dụng khi lần trước PASS), và có tắt bằng
+ * rc `"verifyCache": false`.
+ */
+import { createHash } from "node:crypto";
+import { statSync } from "node:fs";
+import { join } from "node:path";
+import { fileIndex } from "./file-index.js";
+/** Số file tối đa đưa vào fingerprint (file-index cap thực tế ~vài nghìn). */
+const MAX_FINGERPRINT_FILES = 5_000;
+/**
+ * Fingerprint ổn định cho một trạng thái workspace. Trả về chuỗi dài ~40 ký
+ * tự; khác 1 byte khi 1 file thêm/bỏ/đổi size hoặc mtime.
+ *
+ * `fileIndex(workdir, force)` — BỎ QUA cache TTL 5s (và cache one-slot theo
+ * workdir khác): file mới tạo bởi `run_command`/trình sửa ngoài PHẢI đổi hash,
+ * nếu không kết quả verify cũ sẽ được tái sử dụng sai. Chi phí một lần
+ * `rg --files` + stat — nhỏ hơn rất nhiều so với một lệnh build chạy thừa.
+ */
+export function workspaceFingerprint(workdir, cap = MAX_FINGERPRINT_FILES) {
+    const files = fileIndex(workdir, true);
+    const hash = createHash("sha1");
+    const truncated = files.length > cap;
+    const list = truncated ? files.slice(0, cap) : files;
+    hash.update(`files=${files.length}${truncated ? " (capped)" : ""}\n`);
+    for (const rel of list) {
+        let st;
+        try {
+            st = statSync(join(workdir, rel));
+        }
+        catch {
+            hash.update(`${rel}:gone\n`);
+            continue;
+        }
+        hash.update(`${rel}:${st.size}:${Math.round(st.mtimeMs)}\n`);
+    }
+    return hash.digest("hex");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "s-app-scoder-agent",
-  "version": "0.9.8",
+  "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",