@noobdemon/noob-cli 1.7.8 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noobdemon/noob-cli",
-  "version": "1.7.8",
+  "version": "1.8.0",
   "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,45 +262,88 @@ 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 buildPrompt(history, extraToolsDoc, goal) {
-  const msgs = compact(history, MAX_PROMPT_CHARS);
-  // Thứ tự CÓ CHỦ ĐÍCH: SYSTEM → memoryBlock (Rules dự án, vị trí mạnh thứ 2,
-  // tránh lost-in-the-middle) → goalBlock (hard completion requirement, attention
-  // cao — chống agentic laziness + goal drift) → extraToolsDoc → runtimeContext
-  // → filesLedger → CONVERSATION. noob.md (đặc biệt phần `## Rules`) phải nằm
-  // sát SYSTEM để model coi là luật.
+// 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 (goal && goal.trim()) {
-    parts.push("", goalBlock(goal));
+  if (recentSessions && recentSessions.length) {
+    parts.push("", recentSessionsBlock(recentSessions));
   }
+  if (goal && goal.trim()) parts.push("", goalBlock(goal));
   if (extraToolsDoc) parts.push("", extraToolsDoc);
-  parts.push("", runtimeContext(), "", filesLedger(history), "", "=".repeat(60), "# CONVERSATION", "");
+  parts.push("", runtimeContext());
+  return parts.join("\n");
+}
+
+function buildUserMessage(history) {
+  const msgs = compact(history, MAX_PROMPT_CHARS);
+  const parts = [filesLedger(history), "", "=".repeat(60), "# CONVERSATION", ""];
   for (const m of msgs) {
     if (m.role === "user") parts.push(`## USER\n${m.content}`);
     else if (m.role === "assistant") parts.push(`## ASSISTANT\n${m.content}`);
     else if (m.role === "tool") parts.push(`## TOOL RESULT (${m.name})\n${m.content}`);
     parts.push("");
   }
-  parts.push("=".repeat(60));
-  // Recency bias: câu chốt cuối prompt nằm ở vị trí attention mạnh nhất. Nhắc
-  // model đối chiếu FILES CHANGED trước khi claim đã sửa file — chống ảo giác
-  // "đã tạo file" khi chưa gọi write_file/edit_file.
-  parts.push("Continue. Emit a tool block to act, or reply in Markdown if done. Before claiming any file was created/edited, verify it appears in the FILES CHANGED list above — if not, emit the tool call now.");
+  parts.push("=".repeat(60), "Continue. Emit a tool block to act, or reply in Markdown if done. Before claiming any file was created/edited, verify it appears in the FILES CHANGED list above — if not, emit the tool call now.");
   return parts.join("\n");
 }
 
@@ -360,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.
@@ -376,8 +419,9 @@ 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 prompt = buildPrompt(history, extraToolsDoc, goal);
-    tokenMeter?.addInput(countTokens(prompt));
+    const system = buildSystem(history, extraToolsDoc, goal, recentSessions);
+    const message = buildUserMessage(history);
+    tokenMeter?.addInput(countTokens(message));
     onStatus?.("thinking");
     onDelta?.({ type: "step-start" });
     // Stream + auto-retry: bao lớp resilience cho lỗi stream cut / empty / network.
@@ -385,7 +429,7 @@ export async function runAgent({ history, model, signal, onTool, onStatus, onDel
     // trường hợp api.js trả về với finishReason bất thường (tool_unclosed/empty) hoặc
     // throw ApiError retryable (network drop, 5xx, timeout).
     const { text, finishReason } = await streamWithRetry({
-      model, message: prompt, signal, tokenMeter, onDelta, onStatus,
+      model, message, system, signal, tokenMeter, onDelta, onStatus,
     });
     tokenMeter?.endOutput();
     onDelta?.({ type: "step-end" });
@@ -426,7 +470,7 @@ export async function runAgent({ history, model, signal, onTool, onStatus, onDel
  *   backoff (1s, 2s, 4s, 8s, max 30s), tối đa 8 lần thử trước khi bỏ cuộc.
  * - Throw lại nếu signal abort hoặc lỗi không retryable.
  */
-async function streamWithRetry({ model, message, signal, tokenMeter, onDelta, onStatus }) {
+async function streamWithRetry({ model, message, system, signal, tokenMeter, onDelta, onStatus }) {
   const MAX_RETRIES = 8;
   let lastErr = null;
   for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
@@ -435,6 +479,7 @@ async function streamWithRetry({ model, message, signal, tokenMeter, onDelta, on
         mode: "chat",
         model,
         message,
+        system,
         signal,
         onDelta: (d) => {
           tokenMeter?.pushOutputDelta(d);

package/src/api.js

@@ -3,6 +3,33 @@
 // upstream. The CLI only ever sees the gateway URL + the user's key.
 import { config } from "./config.js";
 
+// ── memoryToken: per-session random token for upstream conversation state.
+// Browser sends something like "uuid_uuid" (two v4 UUIDs joined by _).
+// Upstream requires both `remember: true` and a valid `memoryToken`.
+// ────────────────────────────────────────────────────────────────────────────
+let _sessionMemoryToken = null;
+
+function makeUUID() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = (Math.random() * 16) | 0;
+    const v = c === "x" ? r : (r & 0x3) | 0x8;
+    return v.toString(16);
+  });
+}
+
+function makeMemoryToken() {
+  return `${makeUUID()}_${makeUUID()}`;
+}
+
+function getMemoryToken() {
+  if (!_sessionMemoryToken) _sessionMemoryToken = makeMemoryToken();
+  return _sessionMemoryToken;
+}
+
+export function resetMemoryToken() {
+  _sessionMemoryToken = null;
+}
+
 // Opt-in TLS escape hatch for machines behind a TLS-intercepting / broken-
 // revocation proxy. Off by default. Prefer fixing the trust store.
 // LƯU Ý: gọi từ bin/noob.js SAU khi parse argv — vì ESM import được hoist nên
@@ -89,7 +116,7 @@ function hasUnclosedToolBlock(text) {
  *
  * @returns {Promise<{text:string, reasoning:string}>}
  */
-export async function stream({ mode = "chat", message, model, signal, onDelta, onReasoning, onStatus, idleMs = 120000, maxContinues = Infinity }) {
+export async function stream({ mode = "chat", message, model, system, conversation, effort, signal, onDelta, onReasoning, onStatus, idleMs = 25000, maxContinues = Infinity }) {
   const endpoint = mode === "search" ? "/api/search" : mode === "merge" ? "/api/merge" : "/api/chat";
 
   let fullText = "";
@@ -99,7 +126,7 @@ export async function stream({ mode = "chat", message, model, signal, onDelta, o
   let emptyStreak = 0; // số lần liên tiếp stream rỗng (chống loop vô tận khi upstream chết hẳn)
 
   for (let attempt = 0; ; attempt++) {
-    const r = await streamOnce({ endpoint, mode, message: prompt, model, signal, idleMs, onStatus, onDelta, onReasoning });
+    const r = await streamOnce({ endpoint, mode, message: prompt, model, system, conversation, effort, signal, idleMs, onStatus, onDelta, onReasoning });
     fullText = mode === "chat" ? fullText + r.text : r.text; // chat: ghép các đoạn nối tiếp; mode khác: thay thế
     if (r.reasoning) reasoning = r.reasoning;
 
@@ -148,8 +175,18 @@ function continuationPrompt(message, partial) {
  * One network attempt of the stream. Returns this attempt's accumulated text +
  * a `truncated` flag telling the caller whether the reply was cut short.
  */
-async function streamOnce({ endpoint, mode, message, model, signal, idleMs, onStatus, onDelta, onReasoning }) {
-  const body = mode === "search" ? { query: message } : mode === "merge" ? { message } : { message, model };
+async function streamOnce({ endpoint, mode, message, model, system, conversation, effort, signal, idleMs, onStatus, onDelta, onReasoning }) {
+  // chat body: gửi system + conversation riêng để gateway forward đúng tới upstream.
+  // Worker gateway (handleChat) + upstream đều nhận shape này.
+  let body;
+  if (mode === "search") body = { query: message };
+  else if (mode === "merge") body = { message };
+  else {
+    body = { message, model, remember: true, memoryToken: getMemoryToken() };
+    if (system) body.customInstructions = system;
+    if (Array.isArray(conversation) && conversation.length) body.conversation = conversation;
+    if (effort) body.effort = effort;
+  }
 
   // Idle-timeout: nếu KHÔNG nhận được byte nào trong idleMs (kết nối treo), tự
   // huỷ và báo lỗi rõ ràng — thay vì spinner quay vô tận. Vẫn tôn trọng signal
@@ -158,14 +195,65 @@ async function streamOnce({ endpoint, mode, message, model, signal, idleMs, onSt
   let timedOut = false;
   const onUserAbort = () => ctrl.abort();
   signal?.addEventListener("abort", onUserAbort, { once: true });
-  let idle;
-  const arm = () => {
-    clearTimeout(idle);
-    idle = setTimeout(() => {
+  // Hai loại timer tách rời (xem comment dài bên dưới):
+  //  - WIRE: kết nối TCP còn thở không? Reset mỗi khi reader.read() trả bytes
+  //    (kể cả comment SSE `: keepalive` từ worker). Ngưỡng cao (idleMs*2) — chỉ
+  //    để bắt trường hợp socket chết cứng không còn cả heartbeat.
+  //  - CONTENT: upstream có thực sự đang nghĩ/nói không? Reset chỉ khi parser
+  //    thấy delta/status/reasoning/done/truncated thật. WARN/PROBE/idleMs gắn
+  //    vào timer này. Đây là fix cho bug: worker phát `: keepalive\n\n` mỗi 15s
+  //    bất kể upstream Vercel còn sống hay đã treo → nếu reset idle theo wire,
+  //    status đếm thời gian sẽ chạy mãi không bao giờ trigger probe/abort.
+  let wireIdle = null;
+  let contentIdle = null;
+  let warnTimer = null;
+  let probeTimer = null;
+  let probeInFlight = false;
+  const WARN_MS = Math.min(8000, idleMs / 3);
+  const PROBE_MS = Math.min(12000, (idleMs * 2) / 3);
+  const WIRE_MS = idleMs * 2; // socket dead-cứng (mất cả heartbeat) — ngưỡng rộng
+  const clearContentTimers = () => {
+    clearTimeout(warnTimer); warnTimer = null;
+    clearTimeout(probeTimer); probeTimer = null;
+    clearTimeout(contentIdle); contentIdle = null;
+  };
+  const armContent = () => {
+    clearContentTimers();
+    warnTimer = setTimeout(() => {
+      if (onStatus) onStatus("Đang chờ proxy phản hồi…");
+    }, WARN_MS);
+    probeTimer = setTimeout(async () => {
+      if (probeInFlight || ctrl.signal.aborted) return;
+      probeInFlight = true;
+      try {
+        const probeCtl = new AbortController();
+        const probeT = setTimeout(() => probeCtl.abort(), 3000);
+        const r = await fetch(config.gatewayUrl + "/api/usage", { headers: authHeaders(), signal: probeCtl.signal });
+        clearTimeout(probeT);
+        if (!r.ok && r.status >= 500) throw new Error("proxy 5xx");
+      } catch {
+        if (!ctrl.signal.aborted) {
+          timedOut = true;
+          if (onStatus) onStatus("Proxy không phản hồi — đang gọi lại model…");
+          ctrl.abort();
+        }
+      } finally {
+        probeInFlight = false;
+      }
+    }, PROBE_MS);
+    contentIdle = setTimeout(() => {
       timedOut = true;
       ctrl.abort();
     }, idleMs);
   };
+  const armWire = () => {
+    clearTimeout(wireIdle);
+    wireIdle = setTimeout(() => {
+      // Mất cả heartbeat → socket chết cứng. Abort, lớp trên sẽ retry.
+      timedOut = true;
+      ctrl.abort();
+    }, WIRE_MS);
+  };
 
   let text = "";
   let reasoning = "";
@@ -184,6 +272,12 @@ async function streamOnce({ endpoint, mode, message, model, signal, idleMs, onSt
     } catch {
       return;
     }
+    // Có ít nhất 1 field nội dung thực → upstream đang nghĩ/nói. Reset content
+    // idle/warn/probe. JSON rỗng `{}` (ping) hoặc comment `: keepalive` của
+    // worker KHÔNG khớp điều kiện này → không che mất idle detection.
+    if (p.status || p.delta || p.reasoning || p.done || p.truncated || p.error) {
+      armContent();
+    }
     if (p.status && onStatus) onStatus(p.status);
     if (p.delta) {
       text += p.delta;
@@ -200,7 +294,8 @@ async function streamOnce({ endpoint, mode, message, model, signal, idleMs, onSt
   };
 
   try {
-    arm();
+    armWire();
+    armContent();
     const resp = await fetch(config.gatewayUrl + endpoint, {
       method: "POST",
       headers: authHeaders(),
@@ -214,7 +309,7 @@ async function streamOnce({ endpoint, mode, message, model, signal, idleMs, onSt
     let buf = "";
     while (true) {
       const { done, value } = await reader.read();
-      arm(); // có hoạt động → gia hạn idle
+      armWire(); // bất kỳ byte nào tới → socket còn thở, gia hạn wire idle
       if (done) break;
       buf += decoder.decode(value, { stream: true });
       let nl;
@@ -239,7 +334,8 @@ async function streamOnce({ endpoint, mode, message, model, signal, idleMs, onSt
     if (mode === "chat" && text) return { text, reasoning, truncated: true };
     throw err;
   } finally {
-    clearTimeout(idle);
+    clearTimeout(wireIdle);
+    clearContentTimers();
     signal?.removeEventListener("abort", onUserAbort);
   }
 }

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

@@ -6,12 +6,12 @@ import { createTui } from "./tui.js";
 import { runAgent, maybeSummarize } from "./agent.js";
 import { runSubAgent, spawnAgentToolsDoc, MAX_SUBAGENT_DEPTH } from "./subagent.js";
 import { TokenMeter } from "./tokens.js";
-import { stream, usage, ApiError } from "./api.js";
+import { stream, usage, ApiError, resetMemoryToken } from "./api.js";
 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";
@@ -360,7 +360,11 @@ export async function startRepl(opts = {}) {
     );
     console.log(c.dim("\n  " + t.sessionResumeHint) + "\n");
   }
-  const startFresh = () => (session = sessions.newSession({ cwd: process.cwd(), model: state.model.id }));
+  const startFresh = () => {
+    session = sessions.newSession({ cwd: process.cwd(), model: state.model.id });
+    // Reset per-session upstream memory token so the next chat starts fresh.
+    resetMemoryToken();
+  };
 
   // /frontend-design <yêu cầu> — vận dụng skill frontend-design (skills/frontend-design/SKILL.md)
   // để model tạo UI frontend chất lượng cao, tránh "AI slop" aesthetic.
@@ -535,6 +539,20 @@ Cuối cùng: tóm tắt + danh sách sửa theo thứ tự ưu tiên. Thẳng t
   // bắt nhầm khi model chỉ NHẮC tới token giữa văn xuôi. Không bao giờ chấp nhận
   // ở lượt lập kế hoạch (xem vòng lặp bên dưới).
   const ultraIsDone = (a) => a.trimEnd().endsWith(ULTRA_DONE);
+  // Detect "stuck": model bối rối, không nhận task, chỉ hỏi lại user hoặc spam
+  // list_dir/ls vô nghĩa. Xảy ra khi goal trống nghĩa / bị paste system prompt /
+  // model mất ngữ cảnh. 2 vòng stuck liên tiếp → auto-exit để không loop vô hạn.
+  const STUCK_PHRASES = [
+    "chưa giao task", "chưa nêu tác vụ", "chưa có yêu cầu", "chưa có task",
+    "không nhận task", "không thể nhận vai", "bạn muốn mình làm gì",
+    "chưa rõ yêu cầu", "cần mục tiêu rõ", "vui lòng cho biết",
+    "please provide", "what would you like", "no task", "clarify",
+  ];
+  const ultraLooksStuck = (a) => {
+    if (!a) return true;
+    const s = a.toLowerCase();
+    return STUCK_PHRASES.some((p) => s.includes(p));
+  };
   const ultraStart = (goal) => `# CHẾ ĐỘ ULTRA (tự hành)
 Mục tiêu tổng: ${goal}
 
@@ -568,10 +586,23 @@ Tự đánh giá: còn THIẾU gì để đạt mục tiêu? Chọn 1 nhiệm v
       let answer = await handle(ultraStart(goal));
       persist();
       let i = 0;
+      let stuckStreak = 0; // đếm vòng liên tiếp model bối rối / không nhận task
+      const STUCK_MAX = 2;
       // Lượt đầu = lập kế hoạch → KHÔNG xét hoàn thành. Mỗi vòng sau là một lượt
       // "tiếp tục" có cổng kiểm chứng; chỉ dừng khi token nằm ở CUỐI câu trả lời.
+      // Cũng dừng sớm nếu model 2 vòng liên tiếp tỏ ra mất ngữ cảnh (goal trống
+      // nghĩa, paste system prompt, model hỏi lại user) → tránh spam list_dir.
       while (state.ultra && i < MAX_QUESTS) {
         if (!answer) break; // lượt bị ngắt/ lỗi → dừng tự hành, đừng quay vô ích
+        if (ultraLooksStuck(answer)) {
+          stuckStreak++;
+          if (stuckStreak >= STUCK_MAX) {
+            console.log(c.err("  ⚠ ULTRA stuck: model không nhận task " + stuckStreak + " vòng liên tiếp. Thoát. Gõ /ultra <mục tiêu rõ> để thử lại."));
+            break;
+          }
+        } else {
+          stuckStreak = 0;
+        }
         i++;
         console.log(c.accent("  ↻ " + t.ultraQuest(i)));
         answer = await handle(ultraContinue(goal));
@@ -841,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"));
 
@@ -1045,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: () => {
@@ -1313,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
@@ -1320,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,105 @@ 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;
   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;
+      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;
+
+    return lines.map((l, i) => (i === 0 ? promptLabel : indent) + l).join("\n");
   }
   function topRow() {
     if (liveOut) {
@@ -166,17 +284,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 +303,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,21 +328,29 @@ 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.
+  const placeCursor = (totalRows) => {
+    const upBy = totalRows - 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
-    w(`${ESC}[?25l` + eraseSeq() + rs.join("\n") + placeCursor() + `${ESC}[?25h`);
+    const rs = rows(); // rows() → renderBar() cập nhật cursorScreenRow/Col
+    w(`${ESC}[?25l` + eraseSeq() + rs.join("\n") + placeCursor(rs.length) + `${ESC}[?25h`);
     prevRows = rs.length;
     drawn = true;
   }
@@ -234,7 +360,7 @@ export function createTui({ onLine, onInterrupt, onEOF, onShiftTab, completer }
     let s = `${ESC}[?25l` + eraseSeq();
     s += block;
     if (!block.endsWith("\n")) s += "\n";
-    s += rs.join("\n") + placeCursor() + `${ESC}[?25h`;
+    s += rs.join("\n") + placeCursor(rs.length) + `${ESC}[?25h`;
     w(s);
     prevRows = rs.length;
     drawn = true;