@noobdemon/noob-cli 1.7.10 → 1.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noobdemon/noob-cli",
-  "version": "1.7.10",
+  "version": "1.8.1",
   "publishConfig": {
     "access": "public"
   },

package/src/agent.js

@@ -1,6 +1,6 @@
 import os from "node:os";
 import { stream } from "./api.js";
-import { loadMemory } from "./memory.js";
+import { loadMemory, memoryStats } from "./memory.js";
 import { listRoots } from "./tools.js";
 import { t } from "./i18n.js";
 import { countTokens } from "./tokens.js";
@@ -262,23 +262,72 @@ export function filesLedger(history) {
 // lại mỗi lượt. Không có file → nhắc model tự tạo khi rút ra điều đáng nhớ.
 // Framing MẠNH: phần `## Rules` là binding (luật dự án), `## Notes` mới là
 // tham khảo. Đặt ngay sau SYSTEM trong buildPrompt() để không bị lost-in-the-middle.
+// Footer "📊 noob.md hiện tại: …" cho model thấy memory "tươi" hay "stale" — nếu
+// đã cũ, model có thể tự quyết định /learn hoặc xác minh lại với filesystem.
 function memoryBlock() {
   const mem = loadMemory();
+  const stats = memoryStats();
+  const statLine = stats
+    ? `\n\n📊 noob.md hiện tại: ${stats.lines} dòng (${stats.rules} rules, ${stats.notes} notes) · cập nhật ${relTime(stats.mtime)}. Nếu cũ/quá ít, cân nhắc /learn để chưng cất bài học mới.`
+    : "";
   if (!mem)
-    return "# PROJECT RULES & MEMORY (noob.md)\n(Chưa có noob.md trong thư mục này. Khi rút ra điều đáng nhớ lâu dài — lệnh build/test/run, quy ước, kiến trúc, sở thích người dùng, tiến độ — hãy TẠO noob.md bằng write_file và ghi vào đó.)";
+    return "# PROJECT RULES & MEMORY (noob.md)\n(Chưa có noob.md trong thư mục này. Khi rút ra điều đáng nhớ lâu dài — lệnh build/test/run, quy ước, kiến trúc, sở thích người dùng, tiến độ — hãy TẠO noob.md bằng write_file và ghi vào đó.)" + statLine;
   return (
     "# PROJECT RULES & MEMORY (noob.md) — BINDING\n" +
     "Phần `## Rules` dưới đây là LUẬT DỰ ÁN bạn PHẢI tuân theo trong mọi hành động ở lượt này — coi như mở rộng của SYSTEM, không phải gợi ý. Phần `## Notes` là quan sát tham khảo, có thể xác minh lại với filesystem nếu nghi ngờ.\n\n" +
     mem +
-    "\n\nTrước khi emit hành động, đối chiếu với `## Rules` ở trên. Học thêm điều đáng nhớ → cập nhật noob.md bằng edit_file/write_file (Notes mới, promote lên Rules khi đã chứng minh)."
+    "\n\nTrước khi emit hành động, đối chiếu với `## Rules` ở trên. Học thêm điều đáng nhớ → cập nhật noob.md bằng edit_file/write_file (Notes mới, promote lên Rules khi đã chứng minh)." +
+    statLine
   );
 }
 
+// Recent sessions block: danh sách phiên gần đây CÙNG workspace. Model thấy
+// breadcrumbs để (a) trả lời "phiên trước làm gì" mà KHÔNG cần /resume, (b) gợi
+// ý /resume nếu user muốn tiếp tục. Bỏ qua phiên hiện tại (repl.js lọc).
+// recentSessions: [{ id, title, turns, updatedAt }] — đã sort mới → cũ.
+export function recentSessionsBlock(recentSessions) {
+  if (!recentSessions || !recentSessions.length) return "";
+  const lines = [
+    "# RECENT SESSIONS IN THIS WORKSPACE (newest first)",
+    "Đây là các phiên TRƯỚC của cùng dự án. User có thể `/resume <id>` để tiếp tục 1 phiên cụ thể (xem lịch sử đầy đủ). Nếu user nói chung chung ('tiếp tục hôm qua', 'làm lại cái kia') mà KHÔNG chỉ rõ — hỏi lại hoặc dùng breadcrumbs dưới để đoán (xem title + số lượt + thời gian).",
+    "",
+  ];
+  for (const s of recentSessions) {
+    const ago = relTime(s.updatedAt);
+    const title = s.title || "(chưa đặt tiêu đề)";
+    lines.push(`- \`${s.id}\` — "${title}" · ${s.turns} lượt · ${ago}`);
+  }
+  return lines.join("\n");
+}
+
+// "X ago" ngắn gọn, tiếng Việt. Dùng cho noob.md mtime + recent sessions.
+export function relTime(ts) {
+  if (!ts) return "—";
+  const ms = Date.now() - ts;
+  if (ms < 5000) return "vừa xong"; // < 5s hoặc tương lai → "vừa xong" (tránh "0s trước" xấu)
+  const s = Math.floor(ms / 1000);
+  if (s < 60) return `${s}s trước`;
+  const m = Math.floor(s / 60);
+  if (m < 60) return `${m} phút trước`;
+  const h = Math.floor(m / 60);
+  if (h < 24) return `${h} giờ trước`;
+  const d = Math.floor(h / 24);
+  if (d < 30) return `${d} ngày trước`;
+  const mo = Math.floor(d / 30);
+  if (mo < 12) return `${mo} tháng trước`;
+  return `${Math.floor(d / 365)} năm trước`;
+}
+
 // The proxy is stateless, so we serialize the whole transcript into one prompt.
 // extraToolsDoc: chuỗi mô tả thêm tool (vd spawn_agent khi agent mode bật) được
 // chèn ngay sau SYSTEM để model biết và dùng được.
-function buildSystem(history, extraToolsDoc, goal) {
+// recentSessions: breadcrumbs các phiên trước cùng workspace (repl.js cung cấp)
+// → chèn ngay sau memoryBlock() để model "thấy" lịch sử dù chưa /resume.
+function buildSystem(history, extraToolsDoc, goal, recentSessions) {
   const parts = [SYSTEM, "", memoryBlock()];
+  if (recentSessions && recentSessions.length) {
+    parts.push("", recentSessionsBlock(recentSessions));
+  }
   if (goal && goal.trim()) parts.push("", goalBlock(goal));
   if (extraToolsDoc) parts.push("", extraToolsDoc);
   parts.push("", runtimeContext());
@@ -354,7 +403,7 @@ function extractJsonObject(s, from) {
  * @param {(msg:string)=>void} opts.onStatus      thinking/streaming status
  * @returns {Promise<string>} the final assistant answer (no tool block)
  */
-export async function runAgent({ history, model, signal, onTool, onStatus, onDelta, onSteer, tokenMeter, extraToolsDoc, goal }) {
+export async function runAgent({ history, model, signal, onTool, onStatus, onDelta, onSteer, tokenMeter, extraToolsDoc, goal, recentSessions }) {
   // [GỠ BUDGET 2026-06-06] Không còn token budget enforcement. Agent/loop/sub-agent
   // chạy không giới hạn token. Dừng theo: GOAL đạt, <<LOOP_DONE>>, <<ULTRA_DONE>>,
   // model tự kết thúc reply không có tool block, hoặc user Ctrl+C.
@@ -370,7 +419,7 @@ export async function runAgent({ history, model, signal, onTool, onStatus, onDel
     // Bộ nhớ dài hạn: thử tóm tắt nếu history đã phình. Im lặng nếu không cần.
     try { await maybeSummarize(history, { model, signal }); } catch {}
 
-    const system = buildSystem(history, extraToolsDoc, goal);
+    const system = buildSystem(history, extraToolsDoc, goal, recentSessions);
     const message = buildUserMessage(history);
     tokenMeter?.addInput(countTokens(message));
     onStatus?.("thinking");

package/src/i18n.js

@@ -130,6 +130,9 @@ export const t = {
   loopAutoStop: (n) => `Loop tự dừng sau tick #${n} — model phát <<LOOP_DONE>> (task hoàn tất).`,
   loopAlreadyRunning: "Đã có loop đang chạy. /loop stop trước khi đặt loop mới.",
   learning: "đang chưng cất bài học vào noob.md…",
+  learnSuggest: (n) => `💡 Phiên này có ${n} lượt. Gõ /learn trước để chưng cất bài học vào noob.md (sau khi /new thì history sẽ mất).`,
+  memoryStatus: (lines, rules, notes, ago) => `📝 noob.md: ${lines} dòng (${rules} rules, ${notes} notes) · cập nhật ${ago}`,
+  memoryMissing: "📝 noob.md: chưa có — gõ /init để tạo từ dự án.",
   compactRunning: "đang tóm tắt phiên để gọn ngữ cảnh…",
   compactEmpty: "Phiên còn trống — không có gì để tóm tắt.",
   compactSkipped: "Phiên còn ngắn hoặc tóm tắt thất bại — bỏ qua.",

package/src/memory.js

@@ -19,3 +19,32 @@ export function loadMemory() {
     return null;
   }
 }
+
+// Thống kê nhanh về noob.md: dùng cho (a) footer trong system prompt để model
+// biết memory "tươi" hay "stale" và (b) banner khi mở noob để user thấy model
+// có memory gì. Trả về null nếu chưa có file.
+export function memoryStats() {
+  let txt;
+  try {
+    txt = fs.readFileSync(memoryPath(), "utf8");
+  } catch {
+    return null;
+  }
+  if (!txt.trim()) return null;
+  const lines = txt.split("\n");
+  let rules = 0;
+  let notes = 0;
+  let inSection = "";
+  for (const l of lines) {
+    if (/^##\s+Rules\b/i.test(l)) { inSection = "rules"; continue; }
+    if (/^##\s+Notes\b/i.test(l)) { inSection = "notes"; continue; }
+    if (/^##\s/.test(l)) { inSection = ""; continue; } // mục khác → reset
+    if (/^\s*[-*]\s+/.test(l)) {
+      if (inSection === "rules") rules++;
+      else if (inSection === "notes") notes++;
+    }
+  }
+  let mtime = 0;
+  try { mtime = fs.statSync(memoryPath()).mtimeMs; } catch {}
+  return { lines: lines.length, rules, notes, mtime, path: memoryPath() };
+}

package/src/repl.js

@@ -11,7 +11,7 @@ import { runTool, describe, DESTRUCTIVE, addRoot, listRoots } from "./tools.js";
 import { MODELS, PROVIDERS, findModel, providerColor, DEFAULT_MODEL } from "./models.js";
 import { c, banner, modelBadge, renderMarkdown, box } from "./ui.js";
 import { config } from "./config.js";
-import { loadMemory, memoryPath } from "./memory.js";
+import { loadMemory, memoryPath, memoryStats } from "./memory.js";
 import { t } from "./i18n.js";
 import { checkLatest, runUpdate, CURRENT } from "./update.js";
 import * as sessions from "./sessions.js";
@@ -872,6 +872,17 @@ NGUYÊN TẮC:
   tui.start();
   banner();
   printStatus(state);
+  // noob.md status line — cho user thấy model có memory gì (số dòng, rules/notes,
+  // bao lâu cập nhật). Nếu chưa có → gợi ý /init. Giúp user tin tưởng model có
+  // "trí nhớ" thay vì cảm giác mù context khi bắt đầu phiên mới.
+  {
+    const stats = memoryStats();
+    if (stats) {
+      console.log(c.dim(`  📝 noob.md: ${stats.lines} dòng (${stats.rules} rules, ${stats.notes} notes) · cập nhật ${relTime(stats.mtime)}`));
+    } else {
+      console.log(c.dim(`  📝 noob.md: chưa có — gõ /init để tạo từ dự án.`));
+    }
+  }
   if (!config.apiKey) console.log("\n" + c.tool("  " + t.notLoggedIn) + "\n");
   else console.log(c.dim("  " + t.ready + "\n"));
 
@@ -1076,6 +1087,10 @@ NGUYÊN TẮC:
         signal: abort.signal,
         tokenMeter,
         goal: state.goal,
+        // Breadcrumbs: 5 phiên gần nhất CÙNG workspace, trừ phiên hiện tại.
+        // Model thấy "đã làm gì" trước đó dù chưa /resume — sửa cảm giác
+        // "model không nhớ session" khi user mở phiên mới trong cùng dự án.
+        recentSessions: sessions.list(5, process.cwd()).filter((s) => s.id !== session?.id),
         extraToolsDoc: state.agentMode ? spawnAgentToolsDoc(0) : "",
         onStatus: () => tick(t.thinking),
         onSteer: () => {
@@ -1344,6 +1359,15 @@ NGUYÊN TẮC:
         break;
       case "clear":
       case "new":
+        // Nếu phiên hiện tại có nhiều lượt (≥ 5 user turns) → nhắc /learn TRƯỚC
+        // khi xoá, vì sau khi clear thì history mất và /learn sẽ chạy trên
+        // history rỗng. In hint để user tự quyết định; không block (UX).
+        {
+          const userTurns = state.history.filter((m) => m.role === "user").length;
+          if (userTurns >= 5) {
+            console.log(c.dim(`  💡 Phiên này có ${userTurns} lượt. Gõ /learn trước để chưng cất bài học vào noob.md (sau khi /new thì history sẽ mất).`));
+          }
+        }
         persist(); // giữ lại phiên cũ trên đĩa
         state.history = [];
         state._longSessionWarned = false; // reset cờ cảnh báo phiên dài
@@ -1351,6 +1375,13 @@ NGUYÊN TẮC:
         if (!tui.tty) console.clear();
         banner();
         printStatus(state);
+        // noob.md status cũng hiện ở banner phiên mới (gọi lại sau clear)
+        {
+          const stats = memoryStats();
+          if (stats) {
+            console.log(c.dim(`  📝 noob.md: ${stats.lines} dòng (${stats.rules} rules, ${stats.notes} notes) · cập nhật ${relTime(stats.mtime)}`));
+          }
+        }
         console.log(c.dim("  " + t.ctxCleared + "\n"));
         break;
       case "resume":

package/src/tui.js

@@ -12,6 +12,58 @@ import { c } from "./ui.js";
 const ESC = "\x1b";
 const ANSI_RE = /\x1b\[[0-9;?]*[ -/]*[@-~]/g;
 const visLen = (s) => s.replace(ANSI_RE, "").length;
+// Trả index trong `text` mà tại đó vị trí VISUAL đạt `targetVis`. Bỏ qua toàn
+// bộ ANSI escape sequence khi đếm. Dùng cho soft-wrap khi text có màu.
+function findVisPos(text, targetVis) {
+  let vis = 0;
+  let i = 0;
+  while (i < text.length && vis < targetVis) {
+    if (text[i] === "\x1b") {
+      const m = text.slice(i).match(/^\x1b\[[0-9;?]*[ -/]*[@-~]/);
+      if (m) { i += m[0].length; continue; }
+    }
+    vis++;
+    i++;
+  }
+  return i;
+}
+// Soft-wrap `text` thành tối đa `maxLines` dòng, sao cho mỗi dòng có độ rộng
+// VISUAL ≤ `width`. Ưu tiên cắt tại khoảng trắng gần cuối (word boundary); nếu
+// không có space hợp lý → hard-slice theo visual position. Nếu text gốc có
+// ANSI escape thì MỌI dòng output (kể cả dòng cuối "vừa khít") đều kết thúc
+// bằng `\x1b[0m` reset — chống "chảy máu" màu khi status bar có dim/accent.
+// Nếu vẫn còn dư → dòng cuối thêm "…".
+function wrapText(text, width, maxLines) {
+  if (!text) return [""];
+  const hasAnsi = /\x1b/.test(text);
+  const RESET = "\x1b[0m";
+  const close = (line) => (hasAnsi ? line + RESET : line);
+  if (visLen(text) <= width) return [close(text)];
+  const lines = [];
+  let remaining = text;
+  while (remaining && lines.length < maxLines) {
+    if (visLen(remaining) <= width) {
+      lines.push(close(remaining));
+      remaining = "";
+      break;
+    }
+    // Cắt tại vị trí visual = width. Sau đó thử lùi về space gần nhất (trong
+    // khoảng 30–100% width) để tránh cắt giữa từ.
+    let cutPos = findVisPos(remaining, width);
+    const slice = remaining.slice(0, cutPos);
+    const lastSpace = slice.lastIndexOf(" ");
+    if (lastSpace > width * 0.3) cutPos = lastSpace;
+    lines.push(close(remaining.slice(0, cutPos).trimEnd()));
+    remaining = remaining.slice(cutPos).trimStart();
+  }
+  if (remaining && lines.length) {
+    const last = lines.length - 1;
+    const lastLine = lines[last];
+    const body = lastLine.endsWith(RESET) ? lastLine.slice(0, -RESET.length) : lastLine;
+    lines[last] = (body.length ? body.slice(0, -1) : "") + "…" + (hasAnsi ? RESET : "");
+  }
+  return lines;
+}
 const FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 
 export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer } = {}) {
@@ -126,39 +178,111 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
     menu = [];
   }
 
-  // ----- ô nhập → chuỗi đầy đủ + bản tô màu (paste = chip) -----
+  // ----- ô nhập → chuỗi đầy đủ + bản tô màu (paste = chip có preview) -----
+  // Chip paste: hiện `[pasted N lines: "dòng đầu tiên…"]` để user xem được
+  // nội dung trước khi Enter. N dòng thì lấy dòng 1; nếu dòng 1 dài >24 ký tự
+  // thì cắt + "…". Tổng chiều dài chip ~38 ký tự — đủ gọn để 1–2 chip vẫn
+  // wrap được trong thanh input tiêu chuẩn.
+  const PASTE_PREVIEW_MAX = 24;
+  const pastePreview = (content) => {
+    const firstLine = (content.split("\n")[0] || "").trim();
+    if (!firstLine) return "";
+    return firstLine.length > PASTE_PREVIEW_MAX
+      ? firstLine.slice(0, PASTE_PREVIEW_MAX - 1) + "…"
+      : firstLine;
+  };
   const cellStr = (x) => (x.paste !== undefined ? x.paste : x.c);
-  const cellPlain = (x) => (x.paste !== undefined ? `[pasted ${x.lines} lines]` : x.c);
+  const cellPlain = (x) => {
+    if (x.paste === undefined) return x.c;
+    const preview = pastePreview(x.paste);
+    return preview ? `[pasted ${x.lines} lines: "${preview}"]` : `[pasted ${x.lines} lines]`;
+  };
   const fullText = () => cells.map(cellStr).join("");
   const coloredInput = () =>
-    cells.map((x) => (x.paste !== undefined ? c.dim(`[pasted ${x.lines} lines]`) : x.c)).join("");
+    cells.map((x) => {
+      if (x.paste === undefined) return x.c;
+      const preview = pastePreview(x.paste);
+      const label = preview ? `[pasted ${x.lines} lines: "${preview}"]` : `[pasted ${x.lines} lines]`;
+      return c.dim(label);
+    }).join("");
 
-  // Dựng thanh nhập + tính cột con trỏ trên màn (`cursorScreenCol`). Vừa khung →
-  // tô màu đầy đủ. Tràn khung → cuộn ngang theo plain sao cho con trỏ luôn trong
-  // tầm nhìn, chèn "…" ở đầu/cuối bị cắt.
+  // Dựng thanh nhập + tính vị trí con trỏ trên màn (`cursorScreenCol` +
+  // `cursorScreenRow`). Vừa khung → tô màu đầy đủ, 1 dòng. Tràn khung → soft-
+  // wrap dọc (≤ MAX_BAR_LINES), indent các dòng nối tiếp dưới prompt để con trỏ
+  // vẫn map đúng (col = promptW + colInLine). Dòng cuối nếu vẫn bị truncate →
+  // thêm "…".
   let cursorScreenCol = 0;
+  let cursorScreenRow = 0;
+  let barRows = 1; // số dòng bar hiện tại; cập nhật bởi renderBar. placeCursor
+                   // dùng để tính upBy — KHÔNG dùng totalRows (gồm cả top/menu
+                   // rows phía trên) vì sẽ kéo cursor lên quá cao, lần commit
+                   // kế tiếp ESC[J xóa luôn spinner+bar+dòng response trên cùng.
   function renderBar() {
     const promptW = visLen(promptLabel);
     const budget = Math.max(4, cols() - promptW - 1);
+    const indent = " ".repeat(promptW);
     const plains = cells.map(cellPlain);
-    let curCol = 0;
-    for (let k = 0; k < cur; k++) curCol += plains[k].length;
+    const plain = plains.join("");
     let total = 0;
     for (const p of plains) total += p.length;
+    let curCharPos = 0;
+    for (let k = 0; k < cur; k++) curCharPos += plains[k].length;
+
+    // Vừa khung → 1 dòng như cũ, con trỏ map thẳng.
     if (total <= budget) {
-      cursorScreenCol = promptW + curCol;
+      barRows = 1;
+      cursorScreenRow = 0;
+      cursorScreenCol = promptW + curCharPos;
       return promptLabel + coloredInput();
     }
-    const plain = plains.join("");
-    let start = curCol > budget - 1 ? curCol - (budget - 1) : 0;
-    if (start > total - budget) start = total - budget;
-    if (start < 0) start = 0;
-    const end = Math.min(total, start + budget);
-    const arr = [...plain.slice(start, end)];
-    if (start > 0) arr[0] = "…";
-    if (end < total) arr[arr.length - 1] = "…";
-    cursorScreenCol = Math.min(promptW + budget, Math.max(promptW, promptW + (curCol - start)));
-    return promptLabel + arr.join("");
+
+    // Tràn khung → soft-wrap dọc tối đa MAX_BAR_LINES, ưu tiên cắt tại space.
+    // Dòng 0 có promptLabel; các dòng sau thụt vào `indent` để con trỏ thẳng
+    // cột với text sau prompt. Paste chip đếm như 1 "từ" dài `[pasted N lines]`
+    // → nếu không vừa, đẩy nguyên chip sang dòng mới (vẫn đọc được).
+    const MAX_BAR_LINES = 5;
+    const lines = [];
+    let pos = 0;
+    while (pos < total && lines.length < MAX_BAR_LINES) {
+      const remaining = total - pos;
+      if (remaining <= budget) {
+        lines.push(plain.slice(pos));
+        break;
+      }
+      // Tìm space gần nhất trong slice [pos, pos+budget]; nếu > 30% budget → cắt
+      // tại đó. Không có space hợp lý → hard-slice theo budget.
+      const slice = plain.slice(pos, pos + budget);
+      const lastSpace = slice.lastIndexOf(" ");
+      let cutLen = budget;
+      if (lastSpace > budget * 0.3) cutLen = lastSpace;
+      lines.push(slice.slice(0, cutLen).trimEnd());
+      pos += cutLen;
+      while (pos < total && plain[pos] === " ") pos++; // bỏ space đầu dòng sau
+    }
+    // Nếu vẫn còn dư → đánh dấu dòng cuối bị truncate.
+    if (pos < total && lines.length) {
+      const last = lines.length - 1;
+      const lastLine = lines[last];
+      lines[last] = (lastLine.length >= budget ? lastLine.slice(0, -1) : lastLine) + "…";
+    }
+
+    // Map curCharPos → (line, colInLine).
+    let curLine = 0;
+    let acc = 0;
+    for (let i = 0; i < lines.length; i++) {
+      const lineLen = lines[i].length;
+      if (curCharPos <= acc + lineLen || i === lines.length - 1) {
+        curLine = i;
+        break;
+      }
+      acc += lineLen;
+    }
+    const colInLine = Math.min(curCharPos - acc, lines[curLine].length);
+    cursorScreenRow = curLine;
+    cursorScreenCol = promptW + colInLine;
+    barRows = lines.length;
+
+    return lines.map((l, i) => (i === 0 ? promptLabel : indent) + l).join("\n");
   }
   function topRow() {
     if (liveOut) {
@@ -166,17 +290,17 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
       // CHỈ KHI liveOut đủ ngắn để cả dòng (liveOut + meta) chắc chắn fit trong
       // 1 dòng terminal. Nếu liveOut quá dài → ưu tiên prose, bỏ meta lượt này
       // (tránh terminal wrap làm dòng tạm kẹt lại trong prose vĩnh viễn — xem
-      // Note "token meter chèn vào prose" trong noob.md).
+      // Note "token meter chèn vào prose" trong noob.md). Trường hợp wrap nhiều
+      // dòng: chỉ dòng đầu ghép meta (nếu vừa), các dòng sau prose thuần.
       if (busy && busyMeta) {
         const meta = c.dim(" · " + busyMeta);
         const metaLen = visLen(meta);
-        const liveLen = visLen(liveOut);
-        if (liveLen + metaLen <= cols()) {
-          return liveOut + meta;
+        if (visLen(liveOut) + metaLen <= cols()) {
+          return [liveOut + meta];
         }
-        // liveOut đã dài: hiện prose nguyên trạng, bỏ meta để tránh wrap.
+        // liveOut đã dài: meta sẽ bị bỏ (xem note ở trên).
       }
-      return liveOut.length > cols() ? liveOut.slice(0, cols()) : liveOut;
+      return wrapText(liveOut, cols(), 2);
     }
     const spin = FRAMES[frame % FRAMES.length];
     // Khi busy, LUÔN hiện elapsed+tokens (busyMeta) cạnh statusText/busyLabel để
@@ -185,12 +309,12 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
       const meta = busy && busyMeta ? c.dim(" · " + busyMeta) : "";
       const tail = busy ? c.dim(" · Ctrl+C để dừng") : "";
       const line = c.dim(spin + " ") + statusText + meta + tail;
-      return line.length > cols() ? line.slice(0, cols()) : line;
+      return wrapText(line, cols(), 2);
     }
     if (busy) {
       const meta = busyMeta ? " · " + busyMeta : "";
       const line = c.dim(spin + " " + (busyLabel || "đang chạy") + meta + " · Ctrl+C để dừng");
-      return line.length > cols() ? line.slice(0, cols()) : line;
+      return wrapText(line, cols(), 2);
     }
     return null;
   }
@@ -210,20 +334,30 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
   function rows() {
     const r = [];
     const top = topRow();
-    if (top !== null) r.push(top);
+    if (top !== null) r.push(...top);
     for (const mr of menuRows()) r.push(mr);
-    r.push(renderBar());
+    const bar = renderBar();
+    if (bar) r.push(...bar.split("\n"));
     return r;
   }
   function eraseSeq() {
     if (!drawn) return "\r";
     return "\r" + (prevRows > 1 ? `${ESC}[${prevRows - 1}A` : "") + `${ESC}[J`;
   }
-  // Sau khi vẽ xong các hàng, con trỏ đang ở CUỐI thanh (hàng cuối). Đưa nó về
-  // đúng cột con trỏ logic: \r về cột 0 rồi dịch phải `cursorScreenCol`.
-  const placeCursor = () => "\r" + (cursorScreenCol > 0 ? `${ESC}[${cursorScreenCol}C` : "");
+  // Sau khi vẽ xong các hàng, con trỏ đang ở CUỐI thanh (hàng cuối, cột cuối).
+  // Đưa về đúng (row, col) của con trỏ logic: \r về cột 0 → đi lên `upBy` hàng
+  // (nếu thanh wrap nhiều dòng) → dịch phải `cursorScreenCol` cột.
+  // upBy dùng `barRows` (số dòng BAR, set bởi renderBar) — KHÔNG dùng totalRows
+  // (gồm cả top/menu rows phía trên bar) vì sẽ kéo cursor lên quá cao.
+  const placeCursor = () => {
+    const upBy = barRows - 1 - cursorScreenRow;
+    let s = "\r";
+    if (upBy > 0) s += `${ESC}[${upBy}A`;
+    if (cursorScreenCol > 0) s += `${ESC}[${cursorScreenCol}C`;
+    return s;
+  };
   function draw() {
-    const rs = rows(); // rows() → renderBar() cập nhật cursorScreenCol
+    const rs = rows(); // rows() → renderBar() cập nhật cursorScreenRow/Col + barRows
     w(`${ESC}[?25l` + eraseSeq() + rs.join("\n") + placeCursor() + `${ESC}[?25h`);
     prevRows = rs.length;
     drawn = true;