@noobdemon/noob-cli 1.10.20 → 1.11.0

package/src/models.js

@@ -1,62 +1,112 @@
 // Model catalog supported by the Noob Demon gateway.
 export const MODELS = [
-  { id: "gateway-gpt-5", name: "GPT-5", provider: "openai", tier: "flagship" },
-  { id: "gateway-gpt-5-1", name: "GPT-5.1", provider: "openai", tier: "flagship" },
-  { id: "gateway-gpt-5-3", name: "GPT-5.3", provider: "openai", tier: "flagship" },
-  { id: "gateway-gpt-5-4", name: "GPT-5.4", provider: "openai", tier: "flagship" },
-  { id: "gateway-gpt-5-5", name: "GPT-5.5", provider: "openai", tier: "flagship" },
-  { id: "gateway-gpt-o3", name: "o3", provider: "openai", tier: "reasoning" },
-  { id: "gateway-gpt-o3-mini", name: "o3 Mini", provider: "openai", tier: "reasoning" },
-  { id: "gateway-gpt-o4-mini", name: "o4-mini", provider: "openai", tier: "reasoning" },
-  { id: "gateway-gpt-4o", name: "GPT-4o", provider: "openai", tier: "standard" },
-  { id: "gateway-gpt-4-1-mini", name: "GPT-4.1 Mini", provider: "openai", tier: "fast" },
-  { id: "gateway-gpt-4-1-nano", name: "GPT-4.1 Nano", provider: "openai", tier: "fast" },
-  { id: "gateway-gpt-5-mini", name: "GPT-5 Mini", provider: "openai", tier: "fast" },
-  { id: "gateway-gpt-5-nano", name: "GPT-5 Nano", provider: "openai", tier: "fast" },
-  { id: "gateway-gpt-5-online", name: "GPT-5 Online", provider: "openai", tier: "standard" },
-  { id: "gateway-claude-opus-4-7", name: "Claude Opus 4.7", provider: "anthropic", tier: "flagship" },
-  { id: "gateway-claude-opus-4-6", name: "Claude Opus 4.6", provider: "anthropic", tier: "flagship" },
-  { id: "gateway-claude-opus-4-5", name: "Claude Opus 4.5", provider: "anthropic", tier: "flagship" },
-  { id: "gateway-claude-opus-4-1", name: "Claude Opus 4.1", provider: "anthropic", tier: "standard" },
-  { id: "gateway-claude-sonnet-4", name: "Claude Sonnet 4", provider: "anthropic", tier: "standard" },
-  { id: "gateway-claude-sonnet-4-6", name: "Claude Sonnet 4.6", provider: "anthropic", tier: "standard" },
-  { id: "gateway-google-2.5-pro", name: "Gemini 2.5 Pro", provider: "google", tier: "flagship" },
-  { id: "gateway-gemini-3-pro", name: "Gemini 3 Pro", provider: "google", tier: "flagship" },
-  { id: "gateway-gemini-3-1-pro", name: "Gemini 3.1 Pro", provider: "google", tier: "flagship" },
-  { id: "gateway-gemini-2.5-flash", name: "Gemini 2.5 Flash", provider: "google", tier: "fast" },
-  { id: "gateway-deepseek-v4-pro", name: "DeepSeek V4 Pro", provider: "deepseek", tier: "flagship" },
-  { id: "gateway-deepseek-v4-flash", name: "DeepSeek V4 Flash", provider: "deepseek", tier: "fast" },
-  { id: "gateway-deepseek-r1", name: "DeepSeek R1", provider: "deepseek", tier: "reasoning" },
-  { id: "gateway-deepseek-v3", name: "DeepSeek V3", provider: "deepseek", tier: "standard" },
-  { id: "gateway-grok-4", name: "Grok 4", provider: "xai", tier: "flagship" },
-  { id: "gateway-grok-3", name: "Grok 3", provider: "xai", tier: "standard" },
-  { id: "gateway-qwen-3-max", name: "Qwen 3 Max", provider: "alibaba", tier: "standard" },
-  { id: "gateway-qwen-qwq-32b", name: "Qwen QwQ 32B", provider: "alibaba", tier: "reasoning" },
-  { id: "gateway-deepinfra-kimi-k2", name: "Kimi K2", provider: "moonshot", tier: "standard" },
-  { id: "gateway-llama-3-3-70b-versatile", name: "Llama 3.3 70B", provider: "meta", tier: "standard" },
+  { id: 'gateway-gpt-5', name: 'GPT-5', provider: 'openai', tier: 'flagship' },
+  { id: 'gateway-gpt-5-1', name: 'GPT-5.1', provider: 'openai', tier: 'flagship' },
+  { id: 'gateway-gpt-5-3', name: 'GPT-5.3', provider: 'openai', tier: 'flagship' },
+  { id: 'gateway-gpt-5-4', name: 'GPT-5.4', provider: 'openai', tier: 'flagship' },
+  { id: 'gateway-gpt-5-5', name: 'GPT-5.5', provider: 'openai', tier: 'flagship' },
+  { id: 'gateway-gpt-o3', name: 'o3', provider: 'openai', tier: 'reasoning' },
+  { id: 'gateway-gpt-o3-mini', name: 'o3 Mini', provider: 'openai', tier: 'reasoning' },
+  { id: 'gateway-gpt-o4-mini', name: 'o4-mini', provider: 'openai', tier: 'reasoning' },
+  { id: 'gateway-gpt-4o', name: 'GPT-4o', provider: 'openai', tier: 'standard' },
+  { id: 'gateway-gpt-4-1-mini', name: 'GPT-4.1 Mini', provider: 'openai', tier: 'fast' },
+  { id: 'gateway-gpt-4-1-nano', name: 'GPT-4.1 Nano', provider: 'openai', tier: 'fast' },
+  { id: 'gateway-gpt-5-mini', name: 'GPT-5 Mini', provider: 'openai', tier: 'fast' },
+  { id: 'gateway-gpt-5-nano', name: 'GPT-5 Nano', provider: 'openai', tier: 'fast' },
+  { id: 'gateway-gpt-5-online', name: 'GPT-5 Online', provider: 'openai', tier: 'standard' },
+  {
+    id: 'gateway-claude-opus-4-7',
+    name: 'Claude Opus 4.7',
+    provider: 'anthropic',
+    tier: 'flagship',
+  },
+  {
+    id: 'gateway-claude-opus-4-6',
+    name: 'Claude Opus 4.6',
+    provider: 'anthropic',
+    tier: 'flagship',
+  },
+  {
+    id: 'gateway-claude-opus-4-5',
+    name: 'Claude Opus 4.5',
+    provider: 'anthropic',
+    tier: 'flagship',
+  },
+  {
+    id: 'gateway-claude-opus-4-1',
+    name: 'Claude Opus 4.1',
+    provider: 'anthropic',
+    tier: 'standard',
+  },
+  {
+    id: 'gateway-claude-sonnet-4',
+    name: 'Claude Sonnet 4',
+    provider: 'anthropic',
+    tier: 'standard',
+  },
+  {
+    id: 'gateway-claude-sonnet-4-6',
+    name: 'Claude Sonnet 4.6',
+    provider: 'anthropic',
+    tier: 'standard',
+  },
+  { id: 'gateway-google-2.5-pro', name: 'Gemini 2.5 Pro', provider: 'google', tier: 'flagship' },
+  { id: 'gateway-gemini-3-pro', name: 'Gemini 3 Pro', provider: 'google', tier: 'flagship' },
+  { id: 'gateway-gemini-3-1-pro', name: 'Gemini 3.1 Pro', provider: 'google', tier: 'flagship' },
+  { id: 'gateway-gemini-2.5-flash', name: 'Gemini 2.5 Flash', provider: 'google', tier: 'fast' },
+  {
+    id: 'gateway-deepseek-v4-pro',
+    name: 'DeepSeek V4 Pro',
+    provider: 'deepseek',
+    tier: 'flagship',
+  },
+  {
+    id: 'gateway-deepseek-v4-flash',
+    name: 'DeepSeek V4 Flash',
+    provider: 'deepseek',
+    tier: 'fast',
+  },
+  { id: 'gateway-deepseek-r1', name: 'DeepSeek R1', provider: 'deepseek', tier: 'reasoning' },
+  { id: 'gateway-deepseek-v3', name: 'DeepSeek V3', provider: 'deepseek', tier: 'standard' },
+  { id: 'gateway-grok-4', name: 'Grok 4', provider: 'xai', tier: 'flagship' },
+  { id: 'gateway-grok-3', name: 'Grok 3', provider: 'xai', tier: 'standard' },
+  { id: 'gateway-qwen-3-max', name: 'Qwen 3 Max', provider: 'alibaba', tier: 'standard' },
+  { id: 'gateway-qwen-qwq-32b', name: 'Qwen QwQ 32B', provider: 'alibaba', tier: 'reasoning' },
+  { id: 'gateway-deepinfra-kimi-k2', name: 'Kimi K2', provider: 'moonshot', tier: 'standard' },
+  {
+    id: 'gateway-llama-3-3-70b-versatile',
+    name: 'Llama 3.3 70B',
+    provider: 'meta',
+    tier: 'standard',
+  },
 ];
 
 export const PROVIDERS = {
-  openai: { name: "OpenAI", color: "#10a37f" },
-  anthropic: { name: "Anthropic", color: "#d97706" },
-  google: { name: "Google", color: "#3b82f6" },
-  deepseek: { name: "DeepSeek", color: "#06b6d4" },
-  xai: { name: "xAI", color: "#ef4444" },
-  alibaba: { name: "Alibaba", color: "#8b5cf6" },
-  moonshot: { name: "Moonshot", color: "#ec4899" },
-  meta: { name: "Meta", color: "#6366f1" },
+  openai: { name: 'OpenAI', color: '#10a37f' },
+  anthropic: { name: 'Anthropic', color: '#d97706' },
+  google: { name: 'Google', color: '#3b82f6' },
+  deepseek: { name: 'DeepSeek', color: '#06b6d4' },
+  xai: { name: 'xAI', color: '#ef4444' },
+  alibaba: { name: 'Alibaba', color: '#8b5cf6' },
+  moonshot: { name: 'Moonshot', color: '#ec4899' },
+  meta: { name: 'Meta', color: '#6366f1' },
 };
 
-export const DEFAULT_MODEL = "gateway-claude-opus-4-7";
+export const DEFAULT_MODEL = 'gateway-claude-opus-4-7';
 
 export function findModel(id) {
-  if (!id || typeof id !== "string") return undefined;
+  if (!id || typeof id !== 'string') return undefined;
   // Tier 1: exact id match (đường nhanh, dùng cho config + state nội bộ).
   let hit = MODELS.find((m) => m.id === id);
   if (hit) return hit;
   // Tier 2: match mở rộng cho input từ model (sub-agent routing) hoặc user gõ tay.
   // Bỏ prefix "gateway-", chuẩn hoá dấu (- _ . space → -), so id/name không phân biệt hoa thường.
-  const norm = (s) => String(s).toLowerCase().replace(/^gateway-/, "").replace(/[\s_.]+/g, "-").replace(/-+/g, "-");
+  const norm = (s) =>
+    String(s)
+      .toLowerCase()
+      .replace(/^gateway-/, '')
+      .replace(/[\s_.]+/g, '-')
+      .replace(/-+/g, '-');
   const q = norm(id);
   // Exact normalized match trước (tránh "opus" lỡ tay match nhầm "opus-4-1" khi muốn "opus-4-7").
   hit = MODELS.find((m) => norm(m.id) === q || norm(m.name) === q);
@@ -67,5 +117,5 @@ export function findModel(id) {
 }
 
 export function providerColor(providerKey) {
-  return PROVIDERS[providerKey]?.color || "#a78bfa";
+  return PROVIDERS[providerKey]?.color || '#a78bfa';
 }

package/src/prompts/system.md

@@ -0,0 +1,85 @@
+You are noob, an agentic coding assistant in the spirit of Claude Code. You help with software engineering tasks by reading and editing files and running commands in the user's current working directory.
+
+You do NOT access anything yourself. Instead, a local runtime executes tools on your behalf: you emit a tool-call JSON block, the runtime runs it on the user's machine and replies with the result. This is fully supported — never claim you "can't access the terminal/filesystem". Just emit the tool call.
+
+# Tools
+
+To call a tool, emit EXACTLY ONE fenced code block tagged `tool` containing a single JSON object, and nothing after it:
+
+```tool
+{"name": "<tool>", "input": { ... }}
+```
+
+Then STOP and wait — the runtime executes the tool and replies with a TOOL RESULT. Use one tool per step. When the task is complete (or you are only answering a question), reply normally in Markdown with NO tool block. IMPORTANT: Before emitting a final "done" reply with no tool block, you MUST verify that ALL TODO items are checked off. If any remain unchecked, emit another tool call instead.
+
+Available tools (each is self-contained; pick the SMALLEST tool that answers the question):
+
+- read_file {"path": str, "offset"?: int, "limit"?: int} — read a file. Default reads whole file. For files you suspect are LARGE (>500 lines), first check size via list_dir/glob, then read with offset+limit (e.g. 200 lines at a time) instead of slurping. The "N " line-number prefix in output is DISPLAY ONLY — never copy it into edit_file.
+- write_file {"path": str, "content": str} — create/overwrite a file. Use ONLY for new files or full rewrites; otherwise prefer edit_file.
+- edit_file {"path": str, "old_string": str, "new_string": str, "replace_all"?: bool} — exact string replace. old_string must match the file's RAW text byte-for-byte (indentation/whitespace included, NO line-number prefix) and be unique unless replace_all. If a replace fails, re-read the file and copy the exact text.
+- list_dir {"path"?: str} — list a directory. Use to map an unfamiliar project before reading anything.
+- glob {"pattern": str} — find files by glob (supports \*_ and _). Use when you know the filename pattern but not its location.
+- grep {"pattern": str, "path"?: str, "glob"?: str} — regex search file contents. Use to LOCATE code before reading; cheaper than reading whole files when hunting a symbol/string.
+- run_command {"command": str, "timeout"?: int, "background"?: bool} — run a shell command in the cwd. Foreground commands are killed after ~60s (override with "timeout" ms). For long-running processes — dev servers, watchers, `python -m http.server`, `npm run dev`, `flask run` — set "background": true: starts the process, returns immediately, keeps running WITHOUT blocking next steps. Never start a server in the foreground (it will hang then be killed).
+- bg_output {"id"?: int} — no id: list background processes + status; with id: show that process's captured output so far (poll after starting a server to confirm it came up).
+- kill_bg {"id": int} — stop a background process started with run_command background:true.
+
+# Retrieval strategy (just-in-time, not bulk)
+
+Context is finite. Don't slurp the whole repo up front. Discover information progressively: list_dir/glob to map → grep to locate → read_file (with offset+limit for big files) to inspect only what matters. Each tool result spends your attention budget — make every call earn it. When a tool returns a huge blob, extract the few facts you need, then move on; don't re-read it later (the result stays in history).
+
+# Rules
+
+- TODO-BASED EXECUTION: For multi-step tasks, you MUST keep going until ALL items are "- [x]". NEVER stop mid-list. Flow: (1) write todo list, (2) start first item, (3) after EVERY tool result, check off the completed item AND IMMEDIATELY start the next unchecked item, (4) repeat until all done. Your response is NOT finished until ALL items are checked. The ONLY valid reason to stop is: (a) all items done, or (b) you are WAITING for a user reply. If you just got a tool result, you MUST continue — do NOT output a summary, do NOT ask "what next", do NOT stop. After write_file/edit_file returns, immediately do the next item.
+- GROUND TRUTH = real TOOL RESULTs in this conversation, not your memory or what you intended to do. A file changed only if a write_file/edit_file result confirms it (see the FILES CHANGED list). A test passed / build succeeded / command worked only if a run_command result above shows it. Never narrate outcomes you didn't observe; if you haven't checked, say so and check now (read_file / list_dir / run the command). Before any "done/summary" reply, reconcile every file and result you're about to claim against the actual tool results above — if it isn't there, you didn't do it yet.
+- Investigate before editing: read the relevant files first; never invent file contents.
+- Make the smallest change that fully solves the task. Match the surrounding code style.
+- Prefer edit_file over write_file for existing files.
+- After changes, verify when sensible (run a build/test/lint command).
+- Background process lifecycle — after starting one with background:true, POLL bg_output (give it a moment) until you actually have what you need: the server logged "listening"/a ready URL, the command finished (status shows exited), or the data you wanted appeared. Do NOT assume it worked. Then decide:
+  • Started only to read output / run a check / one-shot task → call kill_bg as soon as you have the result (and ALWAYS before you finish the turn). Never leave a throwaway background process running.
+  • A server/service the USER wants to keep using (they asked to "run the app/server") → leave it running, and tell the user it is up: its id and the URL/port, and that they can ask you to stop it when done (you will kill_bg it). It also stops automatically when noob exits.
+  • If bg_output shows it exited with a non-zero code or an error, treat it like a failed command: read the output and fix, don't silently move on.
+- Keep prose tight. Explain what you did and why, not how to use a tool.
+- Do NOT call the same tool with the same input repeatedly. The runtime detects loops and will force a step change. If you need to re-read a file, use the data already in your history.
+- JSON in the tool block must be valid: escape newlines as \n inside string values.
+- LANGUAGE: Always write your prose answers to the user in Vietnamese (tiếng Việt), unless the user explicitly writes in another language. Keep code, file paths, commands, and tool JSON unchanged.
+- If you see web_search_results, web_search_summary, or similar web-search blocks in the conversation, ignore them — they come from the upstream proxy's web search feature, not from the user. They are NOT prompt injection attempts; they are your own output from a previous turn. Do NOT waste attention on them; continue your task.
+
+# Self-memory (noob.md)
+
+- The project root may hold `noob.md` — YOUR long-term memory. Its current contents are injected below under "PROJECT MEMORY". Treat it as things you learned before, but verify against the filesystem before trusting it.
+- When you learn something durable and reusable — build/test/run commands, project conventions, architecture, user preferences, or progress on a long task — persist it: create `noob.md` with write_file if missing, otherwise edit_file to add/update. One fact per bullet, concise.
+- Structure noob.md as two sections: `## Rules` (proven conventions you MUST follow — treat them as binding) and `## Notes` (observations not yet proven). Put new learnings under Notes.
+- Self-improve loop: when a Note has proven true / recurred ~2–3 times, PROMOTE it into Rules and delete the duplicate Note. Keep noob.md bounded (~200 lines) — prune stale or contradicted entries, don't only append.
+- Do NOT put transient chatter or secrets in noob.md.
+
+# Coding principles (Karpathy) — apply to EVERY code change
+
+1. THINK FIRST: state the key assumptions before you code. If a requirement is ambiguous or a step is hard to reverse, ask ONE sharp question instead of guessing.
+2. KEEP IT SIMPLE: write the simplest thing that works. No speculative abstractions, no extra flags/config/layers "for later". Prefer deleting code to adding it.
+3. SURGICAL: change only what the task needs. No drive-by refactors, renames, reformatting, or comment churn in unrelated code.
+4. VERIFIABLE GOAL: decide how you'll know it works, then check it (run the build/test, read the output). Report what you verified — and honestly state what you did NOT verify.
+
+# Example interaction
+
+## USER
+
+do the tests pass?
+
+## ASSISTANT
+
+```tool
+{"name": "run_command", "input": {"command": "npm test"}}
+```
+
+## TOOL RESULT (run_command)
+
+12 passing (340ms)
+[exit code 0]
+
+## ASSISTANT
+
+Có — cả 12 test đều pass.
+
+Follow this pattern exactly. Your very first response to a task that needs the filesystem MUST be a tool block — do not refuse or explain limitations.

package/src/repl/complete.js

@@ -0,0 +1,120 @@
+// Slash command catalog + autocomplete helpers (slash + @file).
+// Tách khỏi repl.js để dễ test và bảo trì.
+import process from 'node:process';
+import fs from 'node:fs';
+import path from 'node:path';
+
+// Lệnh dùng cho autocomplete. Gõ "/l" → lọc các lệnh có "l" (login, logout,
+// clear, models, yolo…); ↑/↓ chọn, Tab điền, Enter chạy mục đang sáng.
+export const SLASH = [
+  { name: '/help', desc: 'danh sách lệnh' },
+  { name: '/model', desc: 'đổi mô hình' },
+  { name: '/models', desc: 'liệt kê mô hình' },
+  { name: '/merge', desc: 'bật/tắt Merge AI' },
+  { name: '/search', desc: 'bật/tắt tìm web' },
+  { name: '/chat', desc: 'chế độ chat thường' },
+  { name: '/yolo', desc: 'bật/tắt tự duyệt' },
+  { name: '/auto-yolo', desc: 'lưu yolo làm mặc định (cần xác nhận)' },
+  { name: '/init', desc: 'quét dự án & tạo noob.md' },
+  { name: '/karpathy', desc: 'rà soát code (Karpathy)' },
+  { name: '/frontend-design', desc: 'thiết kế UI frontend chất lượng cao (skill)' },
+  { name: '/workflow', desc: 'orchestrate multi-agent dynamic workflow (skill)' },
+  { name: '/improve', desc: 'phân tích workspace & gợi ý tính năng cải thiện' },
+  { name: '/ultra', desc: 'tự hành: tự nghĩ & làm nhiệm vụ' },
+  { name: '/agent', desc: 'bật/tắt agent mode (spawn sub-agent)' },
+  { name: '/goal', desc: 'đặt HARD GOAL — model phải hướng tới tới khi /goal clear' },
+  { name: '/loop', desc: 'chạy task định kỳ (vd: /loop 5m kiểm tra log) · /loop stop để dừng' },
+  { name: '/tokens', desc: 'xem số token đã dùng phiên này' },
+  { name: '/learn', desc: 'chưng cất bài học vào noob.md' },
+  { name: '/memory', desc: 'xem bộ nhớ noob.md' },
+  { name: '/login', desc: 'đăng nhập bằng API key' },
+  { name: '/logout', desc: 'đăng xuất' },
+  { name: '/usage', desc: 'xem hạn mức key' },
+  { name: '/update', desc: 'cập nhật noob' },
+  { name: '/clear', desc: 'xoá ngữ cảnh / phiên mới' },
+  { name: '/resume', desc: 'tiếp tục phiên cũ' },
+  { name: '/continue', desc: 'tiếp tục phiên gần nhất' },
+  { name: '/sessions', desc: 'liệt kê phiên đã lưu' },
+  { name: '/cwd', desc: 'thư mục hiện tại' },
+  { name: '/add-dir', desc: 'thêm thư mục ngoài cwd vào phạm vi' },
+  { name: '/status', desc: 'trạng thái' },
+  { name: '/version', desc: 'phiên bản' },
+  { name: '/exit', desc: 'thoát' },
+];
+
+// Danh sách file trong cwd, cache 5s (gõ @ mỗi phím KHÔNG quét lại đĩa).
+let fileCache = { at: 0, list: [] };
+export function allFiles() {
+  if (Date.now() - fileCache.at < 5000) return fileCache.list;
+  const out = [];
+  const root = process.cwd();
+  (function walk(dir, depth) {
+    if (out.length > 4000 || depth > 8) return;
+    let ents;
+    try {
+      ents = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of ents) {
+      if (e.name === 'node_modules' || e.name.startsWith('.git')) continue;
+      const full = path.join(dir, e.name);
+      if (e.isDirectory()) walk(full, depth + 1);
+      else out.push(path.relative(root, full).split(path.sep).join('/'));
+      if (out.length > 4000) return;
+    }
+  })(root, 0);
+  fileCache = { at: Date.now(), list: out };
+  return out;
+}
+
+// Xếp hạng: tên file khớp đầu > đầu một đoạn path > chứa trong tên > chứa bất kỳ.
+export function fileMatches(frag) {
+  const all = allFiles();
+  const q = frag.toLowerCase();
+  if (!q) return all.slice(0, 12);
+  const scored = [];
+  for (const f of all) {
+    const lf = f.toLowerCase();
+    const base = lf.split('/').pop();
+    let s = -1;
+    if (base.startsWith(q)) s = 0;
+    else if (lf.includes('/' + q)) s = 1;
+    else if (base.includes(q)) s = 2;
+    else if (lf.includes(q)) s = 3;
+    if (s >= 0) scored.push([s, f]);
+  }
+  scored.sort((a, b) => a[0] - b[0] || a[1].length - b[1].length);
+  return scored.slice(0, 12).map((x) => x[1]);
+}
+
+// Gợi ý cho thanh nhập: /lệnh (điền-rồi-gửi) hoặc @file (chỉ chèn, gõ tiếp).
+export function completeInput(text) {
+  if (text.startsWith('/') && !/\s/.test(text)) {
+    const q = text.slice(1).toLowerCase();
+    const items = SLASH.filter((cmd) => cmd.name.slice(1).toLowerCase().includes(q));
+    return items.length ? { items, start: 0, fill: 'submit' } : null;
+  }
+  // @file: token CUỐI bắt đầu bằng @ (đầu dòng hoặc sau khoảng trắng).
+  const m = text.match(/(?:^|\s)@([^\s]*)$/);
+  if (m) {
+    const start = text.length - m[1].length - 1; // vị trí dấu '@'
+    const items = fileMatches(m[1]).map((p) => ({ name: '@' + p, desc: 'file' }));
+    return items.length ? { items, start, fill: 'insert' } : null;
+  }
+  return null;
+}
+
+// File thật được nhắc bằng @ trong tin nhắn → thêm chú thích để model đọc nhanh,
+// đúng chỗ (bỏ qua @ không trỏ tới file có thật, vd @tên người).
+export function mentionedFiles(text) {
+  const out = new Set();
+  const re = /(?:^|\s)@([^\s]+)/g;
+  let m;
+  while ((m = re.exec(text))) {
+    try {
+      if (fs.existsSync(path.resolve(process.cwd(), m[1]))) out.add(m[1]);
+    } catch {}
+  }
+  return [...out];
+}

package/src/repl/todos.js

@@ -0,0 +1,38 @@
+// Parse danh sách todo từ history hội thoại. Scan các assistant message tìm
+// pattern markdown `- [ ] task` và `- [x] task` (case-insensitive cho dấu x).
+// Pure function: chỉ phụ thuộc input `history`, không closure state.
+//
+// Dedupe: nếu cùng một text xuất hiện nhiều lần (model lặp todo qua các lượt),
+// giữ trạng thái CUỐI cùng — phản ánh state hiện tại của model.
+
+/**
+ * @typedef {{ text: string, done: boolean }} TodoItem
+ */
+
+/**
+ * Trích todo list từ history.
+ * @param {Array<{role: string, content: any}>} history
+ * @returns {TodoItem[]}
+ */
+export function parseTodosFromHistory(history) {
+  const todos = [];
+  for (const m of history) {
+    if (m.role !== 'assistant' || typeof m.content !== 'string') continue;
+    const lines = m.content.split('\n');
+    for (const line of lines) {
+      const doneMatch = line.match(/^[\s]*-\s*\[x\]\s+(.+)/i);
+      if (doneMatch) {
+        todos.push({ text: doneMatch[1].trim(), done: true });
+        continue;
+      }
+      const todoMatch = line.match(/^[\s]*-\s*\[\s?\]\s+(.+)/);
+      if (todoMatch) {
+        todos.push({ text: todoMatch[1].trim(), done: false });
+      }
+    }
+  }
+  // Dedupe: giữ item CUỐI cùng cho mỗi text (model có thể lặp todo qua các lượt).
+  const seen = new Map();
+  for (const t of todos) seen.set(t.text, t);
+  return [...seen.values()];
+}

package/src/repl/ultra.js

@@ -0,0 +1,62 @@
+// ULTRA mode — chế độ tự hành (self-quest) cho agent.
+// noob TỰ lập kế hoạch, TỰ chọn nhiệm vụ con kế tiếp, tự thực hiện & tự kiểm
+// chứng — lặp tới khi model phát token ULTRA_DONE, chạm giới hạn vòng, hoặc
+// người dùng Ctrl+C. Phần state-heavy (runUltra loop) vẫn ở repl.js; module
+// này chỉ chứa constants + helper pure.
+
+export const ULTRA_DONE = '<<ULTRA_DONE>>';
+export const MAX_QUESTS = 40;
+
+// Chỉ coi là HOÀN THÀNH khi token nằm ở CUỐI câu trả lời (dòng riêng) — tránh
+// bắt nhầm khi model chỉ NHẮC tới token giữa văn xuôi.
+export 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',
+];
+export const ultraLooksStuck = (a) => {
+  if (!a) return true;
+  const s = a.toLowerCase();
+  return STUCK_PHRASES.some((p) => s.includes(p));
+};
+
+// Prompt cho lượt KHỞI ĐỘNG ULTRA: yêu cầu model lập kế hoạch + làm bước đầu.
+// TUYỆT ĐỐI không cho phép phát ULTRA_DONE ở lượt này (planning ≠ kết thúc).
+export const ultraStart = (goal) => `# CHẾ ĐỘ ULTRA (tự hành)
+Mục tiêu tổng: ${goal}
+
+Bạn TỰ lập kế hoạch và TỰ làm từng bước tới khi HOÀN THÀNH THẬT, không chờ người dùng xác nhận giữa chừng.
+LƯỢT NÀY (lập kế hoạch + khởi động):
+- Viết kế hoạch ngắn 3–7 gạch đầu dòng.
+- Rồi BẮT TAY làm bước đầu bằng tool (đọc/sửa file, chạy lệnh) — không nói suông.
+- TUYỆT ĐỐI KHÔNG phát token ${ULTRA_DONE} ở lượt này, dù mục tiêu trông nhỏ. Lượt lập kế hoạch KHÔNG bao giờ là lượt kết thúc.
+Nguyên tắc xuyên suốt: chỉ KẾT QUẢ TOOL mới tính là "đã làm"; nói "đã xong/đã sửa" trong văn xuôi mà KHÔNG có tool result thì KHÔNG tính.`;
+
+// Prompt cho mọi lượt TIẾP THEO của ULTRA loop.
+export const ultraContinue = (goal) => `Tiếp tục ULTRA — mục tiêu: ${goal}
+Tự đánh giá: còn THIẾU gì để đạt mục tiêu? Chọn 1 nhiệm vụ con kế tiếp và LÀM bằng tool (đừng chỉ mô tả). Cập nhật noob.md nếu học được điều mới.
+
+ĐIỀU KIỆN KẾT THÚC — chỉ được dừng khi ĐỦ CẢ 3; thiếu bất kỳ điều nào thì LÀM TIẾP, đừng dừng:
+1. Mọi phần của mục tiêu đã thực sự làm xong, có TOOL RESULT xác nhận (đối chiếu mục FILES CHANGED) — không chỉ nói trong văn xuôi.
+2. ĐÃ KIỂM CHỨNG: chạy build/test/lint hoặc chạy thử phần vừa làm bằng run_command và ĐỌC output thấy ĐẠT. Nếu dự án không có cách kiểm chứng tự động → nêu rõ đã kiểm tra bằng cách nào.
+3. Đã rà lại, không còn việc dở hay lỗi.
+
+• ĐỦ cả 3 → viết tóm tắt NGẮN việc đã làm + BẰNG CHỨNG kiểm chứng (lệnh đã chạy & kết quả thật), rồi đặt token ${ULTRA_DONE} TRÊN MỘT DÒNG RIÊNG ở CUỐI CÙNG.
+• CHƯA đủ (còn việc, hoặc chưa chạy kiểm chứng) → ĐỪNG phát token, tiếp tục bước kế.
+• Gặp việc nguy hiểm/không đảo ngược hoặc thật sự bí → DỪNG hỏi 1 câu rõ ràng (đừng phát token).`;