@noobdemon/noob-cli 1.13.0 → 1.13.2

package/src/diff.js

@@ -8,6 +8,42 @@
 // File lớn hơn (write_file overwrite 1k+ dòng) → caller truncate trước khi gọi.
 import chalk from 'chalk';
 
+// Bề rộng khả dụng cho NỘI DUNG diff (trừ tiền tố '  │ ' = 4 cột + '+ '/'- ' = 2).
+// Cap tối thiểu 20 để không wrap loạn ở terminal hẹp; mặc định 80 khi không phải TTY.
+function contentWidth() {
+  const cols = process.stdout.columns || 80;
+  return Math.max(20, cols - 6);
+}
+
+// Soft-wrap 1 đoạn text THUẦN (không màu) thành mảng dòng có vis-width ≤ width.
+// Ưu tiên word boundary; không có space hợp lý → hard-slice. Diff text đã bị
+// slice(0,200) ở caller nên không cần ANSI-aware ở đây.
+function wrapPlain(text, width) {
+  if (text.length <= width) return [text];
+  const lines = [];
+  let remaining = text;
+  while (remaining.length > width) {
+    let cut = width;
+    const lastSpace = remaining.slice(0, width).lastIndexOf(' ');
+    if (lastSpace > width * 0.3) cut = lastSpace;
+    lines.push(remaining.slice(0, cut).trimEnd());
+    remaining = remaining.slice(cut).trimStart();
+  }
+  if (remaining) lines.push(remaining);
+  return lines.length ? lines : [''];
+}
+
+// Emit 1 dòng diff đã wrap: dòng đầu có dấu (+/-/space), dòng wrap kế thụt 2 cột
+// cho thẳng cột nội dung. Mỗi dòng con tự bọc tiền tố '│' + tô màu riêng (chalk
+// reset cuối từng đoạn) → wrap KHÔNG mất màu / mất khung.
+function emitDiffLine(out, text, color, sign) {
+  const segs = wrapPlain(text, contentWidth());
+  for (let i = 0; i < segs.length; i++) {
+    const prefix = i === 0 ? sign : '  ';
+    out.push(chalk.dim('  │ ') + color(prefix + segs[i]));
+  }
+}
+
 // LCS table giữa 2 mảng lines. Trả về matrix (M+1) x (N+1).
 function lcsTable(a, b) {
   const m = a.length;
@@ -129,11 +165,9 @@ export function renderUnifiedDiff(
         continue;
       }
       const text = String(op.text).slice(0, 200);
-      let line;
-      if (op.type === 'add') line = chalk.green('+ ') + chalk.green(text);
-      else if (op.type === 'del') line = chalk.red('- ') + chalk.red(text);
-      else line = chalk.dim('  ') + chalk.dim(text);
-      out.push(chalk.dim('  │ ') + line);
+      if (op.type === 'add') emitDiffLine(out, text, chalk.green, '+ ');
+      else if (op.type === 'del') emitDiffLine(out, text, chalk.red, '- ');
+      else emitDiffLine(out, text, chalk.dim, '  ');
       printed++;
     }
   }
@@ -153,7 +187,7 @@ export function renderNewFilePreview(content, { label = '', maxLines = 20 } = {}
   const out = [];
   out.push(chalk.dim('  ┌─ ' + label + ' ') + chalk.green(`(file MỚI · ${lines.length} dòng)`));
   for (const l of head) {
-    out.push(chalk.dim('  │ ') + chalk.green('+ ') + chalk.green(l.slice(0, 200)));
+    emitDiffLine(out, l.slice(0, 200), chalk.green, '+ ');
   }
   if (more > 0) out.push(chalk.dim('  │ ') + chalk.dim(`… +${more} dòng nữa`));
   out.push(chalk.dim('  └─'));

package/src/i18n.js

@@ -26,7 +26,6 @@ export const t = {
   // auth
   notLoggedIn:
     'Bạn chưa đăng nhập. Chạy:  noob login <api-key>\nChưa có key? Liên hệ admin để lấy key (Pro / Pro+ / Trial).',
-  loginOk: (plan) => `Đăng nhập thành công. Gói: ${plan}.`,
   loginSaved: (p) => `Đã lưu API key vào ${p}`,
   loggedOut: 'Đã đăng xuất, xoá API key khỏi máy.',
   needKeyArg: 'Thiếu key. Dùng:  noob login <api-key>',
@@ -173,11 +172,6 @@ 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.',
@@ -199,12 +193,8 @@ export const t = {
     'cần mô tả yêu cầu. Ví dụ: /frontend-design landing page cho app nghe nhạc lo-fi',
   workflowRunning: 'đang chạy dynamic workflow đa sub-agent…',
   workflowNoSkill: 'không tìm thấy skills/dynamic-workflows/SKILL.md — skill chưa được cài.',
-  workflowNeedArg: 'cần mô tả task. Ví dụ: /workflow audit toàn bộ src/ tìm lỗ hổng SQL injection',
-  workflowAgentAutoOn: 'agent mode tự bật cho /workflow (cần spawn_agent)',
   workflowAgentAskHint:
     '🎼 /workflow cần spawn sub-agent (spawn_agent) — agent mode hiện đang TẮT.',
-  workflowAgentAskPrompt:
-    '  bật agent mode và chạy workflow? [y] có, bật & chạy / [n] huỷ (gõ /agent rồi chạy lại nếu muốn) › ',
   workflowAgentEnabled: 'đã bật agent mode cho workflow này.',
   bgWorkflowDone: (label) => `workflow nền ${label} đã xong`,
   bgWorkflowFailed: (label, err) => `workflow nền ${label} lỗi: ${err}`,
@@ -212,8 +202,6 @@ export const t = {
   workflowAgentDenied:
     'đã huỷ /workflow — agent mode vẫn TẮT. Gõ /agent rồi chạy lại lệnh nếu muốn.',
   // saved workflows (CRUD)
-  workflowListEmpty: (dir) =>
-    `Chưa có workflow đã lưu. Tạo bằng /workflow save <name> <yêu cầu>. Thư mục: ${dir}`,
   workflowListHeader: (dir) => `Workflow đã lưu (${dir}):`,
   workflowSaveNeedArgs: 'Cách dùng: /workflow save <name> <yêu cầu workflow>',
   workflowSaveEmptyPrompt:
@@ -228,7 +216,6 @@ export const t = {
   workflowSaveDescOk: (n, d) => `Đã thêm mô tả cho '${n}': ${d}`,
   workflowRunNeedName: 'Cách dùng: /workflow run <name> [thêm ngữ cảnh]',
   workflowRunError: (n, e) => `Không nạp được workflow '${n}': ${e}`,
-  workflowRunOk: (n) => `Chạy workflow đã lưu '${n}'…`,
   workflowRunPreviewBuiltin: (n, title) => `Built-in workflow '${n}' (${title})`,
   workflowRunPreviewSaved: (n) => `Workflow đã lưu '${n}'`,
   workflowLoadNeedName: 'Cách dùng: /workflow load <name>',
@@ -267,7 +254,6 @@ export const t = {
   updateBgDone: 'Đang cập nhật nền. Mở lại noob để dùng bản mới.',
   updateChecking: 'Đang kiểm tra cập nhật…',
   updateLatest: (cur) => `Đã ở bản mới nhất (${cur}).`,
-  updating: 'Đang cập nhật…',
   updateOk: '✓ Cập nhật xong. Mở lại noob để dùng bản mới.',
   updateFail: '✗ Cập nhật thất bại. Thử thủ công: npm i -g @noobdemon/noob-cli@latest',
 };

package/src/repl/commands/goal.js

@@ -0,0 +1,37 @@
+// Slash command /goal — HARD GOAL của phiên (completion requirement).
+// Tách khỏi repl.js để giảm phình god module. Dependency (state, tui, persist,
+// helper màu c) inject qua tham số — không truy cập closure startRepl.
+//
+// Set xong sẽ inject vào MỌI prompt tới khi /goal clear. Cú pháp:
+//   /goal            → xem goal hiện tại
+//   /goal <mục tiêu> → đặt goal
+//   /goal clear|off|xoá|xoa → xoá goal
+
+/**
+ * @param {object} args
+ * @param {string} args.arg     - text sau "/goal "
+ * @param {object} args.state   - session state (đọc/ghi state.goal)
+ * @param {object} args.tui     - TUI (tui.setGoal)
+ * @param {Function} args.persist - lưu phiên xuống đĩa
+ * @param {object} args.c       - helper màu (c.accent/c.dim)
+ */
+export function runGoalCommand({ arg, state, tui, persist, c }) {
+  const v = String(arg || '').trim();
+  if (!v) {
+    if (state.goal) console.log(c.accent('  🎯 goal: ') + state.goal);
+    else console.log(c.dim('  chưa đặt goal. Cú pháp: /goal <mục tiêu> · /goal clear để xoá'));
+    return;
+  }
+  const lower = v.toLowerCase();
+  if (lower === 'clear' || lower === 'off' || lower === 'xoá' || lower === 'xoa') {
+    state.goal = null;
+    tui.setGoal('');
+    console.log(c.dim('  đã xoá goal'));
+    persist();
+    return;
+  }
+  state.goal = v;
+  tui.setGoal(v);
+  console.log(c.accent('  🎯 đã đặt goal: ') + v);
+  persist();
+}

package/src/repl/commands/kg.js

@@ -0,0 +1,147 @@
+// Slash command /kg — knowledge graph CRUD (port từ mcp-knowledge-graph).
+// Tách khỏi repl.js để giảm độ phình của god module. Mọi dependency (hàm kg*,
+// helper màu c) được inject qua tham số — không truy cập closure startRepl,
+// nên test được độc lập.
+//
+// Sub-cmd: list/ls, path, add, obs, link, unlink, unobs, get, search, rm.
+
+/**
+ * @param {object} args
+ * @param {string} args.arg   - phần text sau "/kg " (vd "add Foo type obs")
+ * @param {object} args.c     - bảng helper màu (c.ok/c.err/c.dim)
+ * @param {object} args.kg    - các hàm knowledge graph + error class
+ */
+export async function runKgCommand({ arg, c, kg }) {
+  const {
+    kgLoad,
+    kgCreateEntities,
+    kgCreateRelations,
+    kgAddObservations,
+    kgDeleteEntities,
+    kgDeleteObservations,
+    kgDeleteRelations,
+    kgSearchNodes,
+    kgOpenNodes,
+    kgFormat,
+    kgFilePath,
+    KGEntityNotFound,
+    KGMarkerError,
+  } = kg;
+
+  const argText = String(arg || '').trim();
+  const m = argText.match(/^(\S+)(?:\s+([\s\S]*))?$/);
+  const sub = m ? m[1].toLowerCase() : '';
+  const rest = m && m[2] ? m[2].trim() : '';
+  try {
+    if (!sub || sub === 'list' || sub === 'ls') {
+      const g = await kgLoad();
+      if (!g.entities.length && !g.relations.length) {
+        console.log(c.dim(`  KG rỗng (${kgFilePath()})`));
+      } else {
+        console.log(kgFormat(g));
+      }
+    } else if (sub === 'path') {
+      console.log(c.dim('  ') + kgFilePath());
+    } else if (sub === 'add') {
+      const m2 = rest.match(/^(\S+)\s+(\S+)(?:\s+([\s\S]+))?$/);
+      if (!m2) {
+        console.log(c.err('  Cú pháp: /kg add <Name> <type> [<obs1>; <obs2>; ...]'));
+      } else {
+        const [, name, etype, obsRaw] = m2;
+        const observations = obsRaw
+          ? obsRaw
+              .split(';')
+              .map((s) => s.trim())
+              .filter(Boolean)
+          : [];
+        const created = await kgCreateEntities([{ name, entityType: etype, observations }]);
+        if (!created.length)
+          console.log(c.dim(`  Entity '${name}' đã tồn tại — không tạo lại`));
+        else
+          console.log(c.ok('  ✓ ') + `đã thêm ${name} [${etype}] (${observations.length} obs)`);
+      }
+    } else if (sub === 'obs') {
+      const m2 = rest.match(/^(\S+)\s+([\s\S]+)$/);
+      if (!m2) {
+        console.log(c.err('  Cú pháp: /kg obs <Name> <observation text>'));
+      } else {
+        const [, name, obs] = m2;
+        const out = await kgAddObservations([{ entityName: name, contents: [obs] }]);
+        const added = out[0]?.addedObservations || [];
+        if (!added.length)
+          console.log(c.dim(`  Observation đã có cho '${name}' — không thêm lại`));
+        else console.log(c.ok('  ✓ ') + `đã thêm obs cho ${name}: ${added[0]}`);
+      }
+    } else if (sub === 'link') {
+      const parts = rest.split(/\s+/).filter(Boolean);
+      if (parts.length < 3) {
+        console.log(c.err('  Cú pháp: /kg link <From> <verb> <To>'));
+      } else {
+        const [from, verb, ...toParts] = parts;
+        const to = toParts.join(' ');
+        const created = await kgCreateRelations([{ from, to, relationType: verb }]);
+        if (!created.length) console.log(c.dim('  Relation đã tồn tại — không tạo lại'));
+        else console.log(c.ok('  ✓ ') + `${from} --${verb}--> ${to}`);
+      }
+    } else if (sub === 'unlink') {
+      const parts = rest.split(/\s+/).filter(Boolean);
+      if (parts.length < 3) {
+        console.log(c.err('  Cú pháp: /kg unlink <From> <verb> <To>'));
+      } else {
+        const [from, verb, ...toParts] = parts;
+        const to = toParts.join(' ');
+        const out = await kgDeleteRelations([{ from, to, relationType: verb }]);
+        if (!out.deleted) console.log(c.dim('  Không có relation nào khớp'));
+        else console.log(c.ok('  ✓ ') + `xóa relation ${from} --${verb}--> ${to}`);
+      }
+    } else if (sub === 'unobs') {
+      const m2 = rest.match(/^(\S+)\s+([\s\S]+)$/);
+      if (!m2) {
+        console.log(c.err('  Cú pháp: /kg unobs <Name> <observation text>'));
+      } else {
+        const [, name, obs] = m2;
+        await kgDeleteObservations([{ entityName: name, observations: [obs] }]);
+        console.log(c.ok('  ✓ ') + `xóa obs '${obs}' khỏi ${name} (silent nếu không có)`);
+      }
+    } else if (sub === 'get') {
+      if (!rest) {
+        console.log(c.err('  Cú pháp: /kg get <Name1> [<Name2> ...]'));
+      } else {
+        const names = rest.split(/\s+/).filter(Boolean);
+        const g = await kgOpenNodes(names);
+        if (!g.entities.length)
+          console.log(c.dim(`  Không tìm thấy entity: ${names.join(', ')}`));
+        else console.log(kgFormat(g));
+      }
+    } else if (sub === 'search') {
+      if (!rest) {
+        console.log(c.err('  Cú pháp: /kg search <query>'));
+      } else {
+        const g = await kgSearchNodes(rest);
+        if (!g.entities.length) console.log(c.dim(`  Không có kết quả cho "${rest}"`));
+        else console.log(kgFormat(g));
+      }
+    } else if (sub === 'rm' || sub === 'remove' || sub === 'delete') {
+      if (!rest) {
+        console.log(c.err('  Cú pháp: /kg rm <Name1> [<Name2> ...]'));
+      } else {
+        const names = rest.split(/\s+/).filter(Boolean);
+        const out = await kgDeleteEntities(names);
+        console.log(c.ok('  ✓ ') + `đã xóa ${out.deleted} entity (cascade relation)`);
+      }
+    } else {
+      console.log(
+        c.err('  Sub-command không nhận diện. ') +
+          c.dim('Dùng: list | path | add | obs | link | unlink | unobs | get | search | rm')
+      );
+    }
+  } catch (e) {
+    if (e instanceof KGEntityNotFound) {
+      console.log(c.err('  ✗ ') + e.message + c.dim('  (gõ /kg add trước khi /kg obs)'));
+    } else if (e instanceof KGMarkerError) {
+      console.log(c.err('  ✗ ') + e.message);
+    } else {
+      console.log(c.err('  ✗ ') + (e?.message || String(e)));
+    }
+  }
+}

package/src/repl.js

@@ -72,6 +72,8 @@ import {
 import { getBuiltinWorkflow, loadBuiltinPrompt } from './workflows-builtin.js';
 import { SLASH, completeInput, mentionedFiles } from './repl/complete.js';
 import { parseTodosFromHistory } from './repl/todos.js';
+import { runKgCommand } from './repl/commands/kg.js';
+import { runGoalCommand } from './repl/commands/goal.js';
 import {
   ULTRA_DONE,
   MAX_QUESTS,
@@ -1566,12 +1568,18 @@ NGUYÊN TẮC:
       }
 
       const files = mentionedFiles(text);
-      const image =
-        opts.images?.[0] ||
-        imageDataUrl(files.find((f) => IMAGE_MIME[path.extname(f).toLowerCase()]));
+      // Multi-image: gom mọi ảnh paste (opts.images) + ảnh @file được nhắc tới.
+      // Giữ thứ tự: ảnh paste trước, rồi ảnh @file. Dedupe theo data URL.
+      const pasted = Array.isArray(opts.images) ? opts.images.filter(Boolean) : [];
+      const mentionedImages = files
+        .filter((f) => IMAGE_MIME[path.extname(f).toLowerCase()])
+        .map((f) => imageDataUrl(f))
+        .filter(Boolean);
+      const images = [...new Set([...pasted, ...mentionedImages])];
+      const image = images[0] || null;
       const content = files.length
         ? text +
-          `\n\n[File người dùng nhắc tới bằng @: ${files.join(', ')} — đọc bằng read_file nếu cần.${image ? ' Ảnh đầu tiên đã được đính kèm cho model vision.' : ''}]`
+          `\n\n[File người dùng nhắc tới bằng @: ${files.join(', ')} — đọc bằng read_file nếu cần.${images.length ? ` ${images.length} ảnh đã được đính kèm cho model vision.` : ''}]`
         : text;
       state.history.push({ role: 'user', content });
       // Update terminal title với session name (trích từ message đầu).
@@ -1616,6 +1624,7 @@ NGUYÊN TẮC:
         history: state.history,
         model: state.model.id,
         image,
+        images,
         signal: abort.signal,
         tokenMeter,
         goal: state.goal,
@@ -1926,152 +1935,32 @@ NGUYÊN TẮC:
         break;
       }
       case 'kg': {
-        // Knowledge graph CRUD — port từ mcp-knowledge-graph, lưu .noob/kg.jsonl.
-        // Sub-cmd: list, path, add, obs, link, unlink, unobs, get, search, rm.
-        const argText = String(arg || '').trim();
-        const m = argText.match(/^(\S+)(?:\s+([\s\S]*))?$/);
-        const sub = m ? m[1].toLowerCase() : '';
-        const rest = m && m[2] ? m[2].trim() : '';
-        try {
-          if (!sub || sub === 'list' || sub === 'ls') {
-            const g = await kgLoad();
-            if (!g.entities.length && !g.relations.length) {
-              console.log(c.dim(`  KG rỗng (${kgFilePath()})`));
-            } else {
-              console.log(kgFormat(g));
-            }
-          } else if (sub === 'path') {
-            console.log(c.dim('  ') + kgFilePath());
-          } else if (sub === 'add') {
-            const m2 = rest.match(/^(\S+)\s+(\S+)(?:\s+([\s\S]+))?$/);
-            if (!m2) {
-              console.log(c.err('  Cú pháp: /kg add <Name> <type> [<obs1>; <obs2>; ...]'));
-            } else {
-              const [, name, etype, obsRaw] = m2;
-              const observations = obsRaw
-                ? obsRaw
-                    .split(';')
-                    .map((s) => s.trim())
-                    .filter(Boolean)
-                : [];
-              const created = await kgCreateEntities([{ name, entityType: etype, observations }]);
-              if (!created.length)
-                console.log(c.dim(`  Entity '${name}' đã tồn tại — không tạo lại`));
-              else
-                console.log(
-                  c.ok('  ✓ ') + `đã thêm ${name} [${etype}] (${observations.length} obs)`
-                );
-            }
-          } else if (sub === 'obs') {
-            const m2 = rest.match(/^(\S+)\s+([\s\S]+)$/);
-            if (!m2) {
-              console.log(c.err('  Cú pháp: /kg obs <Name> <observation text>'));
-            } else {
-              const [, name, obs] = m2;
-              const out = await kgAddObservations([{ entityName: name, contents: [obs] }]);
-              const added = out[0]?.addedObservations || [];
-              if (!added.length)
-                console.log(c.dim(`  Observation đã có cho '${name}' — không thêm lại`));
-              else console.log(c.ok('  ✓ ') + `đã thêm obs cho ${name}: ${added[0]}`);
-            }
-          } else if (sub === 'link') {
-            const parts = rest.split(/\s+/).filter(Boolean);
-            if (parts.length < 3) {
-              console.log(c.err('  Cú pháp: /kg link <From> <verb> <To>'));
-            } else {
-              const [from, verb, ...toParts] = parts;
-              const to = toParts.join(' ');
-              const created = await kgCreateRelations([{ from, to, relationType: verb }]);
-              if (!created.length) console.log(c.dim('  Relation đã tồn tại — không tạo lại'));
-              else console.log(c.ok('  ✓ ') + `${from} --${verb}--> ${to}`);
-            }
-          } else if (sub === 'unlink') {
-            const parts = rest.split(/\s+/).filter(Boolean);
-            if (parts.length < 3) {
-              console.log(c.err('  Cú pháp: /kg unlink <From> <verb> <To>'));
-            } else {
-              const [from, verb, ...toParts] = parts;
-              const to = toParts.join(' ');
-              const out = await kgDeleteRelations([{ from, to, relationType: verb }]);
-              if (!out.deleted) console.log(c.dim('  Không có relation nào khớp'));
-              else console.log(c.ok('  ✓ ') + `xóa relation ${from} --${verb}--> ${to}`);
-            }
-          } else if (sub === 'unobs') {
-            const m2 = rest.match(/^(\S+)\s+([\s\S]+)$/);
-            if (!m2) {
-              console.log(c.err('  Cú pháp: /kg unobs <Name> <observation text>'));
-            } else {
-              const [, name, obs] = m2;
-              await kgDeleteObservations([{ entityName: name, observations: [obs] }]);
-              console.log(c.ok('  ✓ ') + `xóa obs '${obs}' khỏi ${name} (silent nếu không có)`);
-            }
-          } else if (sub === 'get') {
-            if (!rest) {
-              console.log(c.err('  Cú pháp: /kg get <Name1> [<Name2> ...]'));
-            } else {
-              const names = rest.split(/\s+/).filter(Boolean);
-              const g = await kgOpenNodes(names);
-              if (!g.entities.length)
-                console.log(c.dim(`  Không tìm thấy entity: ${names.join(', ')}`));
-              else console.log(kgFormat(g));
-            }
-          } else if (sub === 'search') {
-            if (!rest) {
-              console.log(c.err('  Cú pháp: /kg search <query>'));
-            } else {
-              const g = await kgSearchNodes(rest);
-              if (!g.entities.length) console.log(c.dim(`  Không có kết quả cho "${rest}"`));
-              else console.log(kgFormat(g));
-            }
-          } else if (sub === 'rm' || sub === 'remove' || sub === 'delete') {
-            if (!rest) {
-              console.log(c.err('  Cú pháp: /kg rm <Name1> [<Name2> ...]'));
-            } else {
-              const names = rest.split(/\s+/).filter(Boolean);
-              const out = await kgDeleteEntities(names);
-              console.log(c.ok('  ✓ ') + `đã xóa ${out.deleted} entity (cascade relation)`);
-            }
-          } else {
-            console.log(
-              c.err('  Sub-command không nhận diện. ') +
-                c.dim('Dùng: list | path | add | obs | link | unlink | unobs | get | search | rm')
-            );
-          }
-        } catch (e) {
-          if (e instanceof KGEntityNotFound) {
-            console.log(c.err('  ✗ ') + e.message + c.dim('  (gõ /kg add trước khi /kg obs)'));
-          } else if (e instanceof KGMarkerError) {
-            console.log(c.err('  ✗ ') + e.message);
-          } else {
-            console.log(c.err('  ✗ ') + (e?.message || String(e)));
-          }
-        }
+        // Knowledge graph CRUD — logic tách sang src/repl/commands/kg.js.
+        // Inject các hàm kg* đã import + helper màu c (không truy cập closure).
+        await runKgCommand({
+          arg,
+          c,
+          kg: {
+            kgLoad,
+            kgCreateEntities,
+            kgCreateRelations,
+            kgAddObservations,
+            kgDeleteEntities,
+            kgDeleteObservations,
+            kgDeleteRelations,
+            kgSearchNodes,
+            kgOpenNodes,
+            kgFormat,
+            kgFilePath,
+            KGEntityNotFound,
+            KGMarkerError,
+          },
+        });
         break;
       }
       case 'goal': {
-        // HARD GOAL = completion requirement (xem tweet_dump.txt mục "Combine
-        // with /goal and /loop"). Set xong sẽ inject vào MỌI prompt tới khi clear.
-        const v = arg.trim();
-        if (!v) {
-          if (state.goal) console.log(c.accent('  🎯 goal: ') + state.goal);
-          else
-            console.log(c.dim('  chưa đặt goal. Cú pháp: /goal <mục tiêu> · /goal clear để xoá'));
-        } else if (
-          v.toLowerCase() === 'clear' ||
-          v.toLowerCase() === 'off' ||
-          v.toLowerCase() === 'xoá' ||
-          v.toLowerCase() === 'xoa'
-        ) {
-          state.goal = null;
-          tui.setGoal('');
-          console.log(c.dim('  đã xoá goal'));
-          persist();
-        } else {
-          state.goal = v;
-          tui.setGoal(v);
-          console.log(c.accent('  🎯 đã đặt goal: ') + v);
-          persist();
-        }
+        // HARD GOAL — logic tách sang src/repl/commands/goal.js. Inject deps.
+        runGoalCommand({ arg, state, tui, persist, c });
         break;
       }
       case 'tokens': {

package/src/tools.js

@@ -348,7 +348,17 @@ export const TOOLS = {
     // raw:true hoặc không phải HTML → trả nguyên văn (đã clip). Ngược lại strip HTML.
     const isHtml = /html/i.test(ct) || /^\s*<(!doctype|html)/i.test(body);
     const text = raw || !isHtml ? body : htmlToText(body);
-    return clip(head + text.trim());
+    const trimmed = text.trim();
+    // SPA hint: HTML lớn nhưng strip ra gần rỗng → nhiều khả năng client-render (JS).
+    // htmlToText là regex, không chạy JS → trả signal rõ thay vì để model tưởng trang trống.
+    if (!raw && isHtml && trimmed.length < 200 && body.length > 2000) {
+      return clip(
+        head +
+          `[web_fetch: trang trả ${body.length} byte HTML nhưng chỉ strip được ${trimmed.length} ký tự text — nhiều khả năng render bằng JS (SPA). Thử lại với raw:true để xem HTML thô, hoặc tìm API/endpoint dữ liệu của trang.]\n\n` +
+          trimmed
+      );
+    }
+    return clip(head + trimmed);
   },
 
   async write_file({ path: p, content }, { signal } = {}) {
@@ -408,7 +418,7 @@ export const TOOLS = {
     // Không thấy → lỗi GIÀU THÔNG TIN: cho model thấy đúng byte trong file để sửa.
     throw new Error(
       `old_string not found in ${rel(file)}. Copy the target text EXACTLY (indentation/whitespace included, NO line-number prefix).` +
-        nearbyContext(data, old_string)
+        nearbyContext(data, old_string, rel(file))
     );
   },
 
@@ -730,7 +740,8 @@ function matchByLines(data, oldStr) {
 
 // Khi không khớp: in vùng file gần dòng giống nhất, dạng JSON-escaped để model
 // thấy rõ tab/space → sửa old_string cho khớp ngay lần sau.
-function nearbyContext(data, oldStr) {
+function nearbyContext(data, oldStr, p) {
+  const oldLineCount = oldStr.replace(/\r\n/g, '\n').split('\n').length;
   const want = (
     oldStr
       .replace(/\r\n/g, '\n')
@@ -756,14 +767,19 @@ function nearbyContext(data, oldStr) {
     }
   }
   if (hit < 0 || best < 6)
-    return ` (no similar line found; the file has ${lines.length} lines — re-read it.)`;
+    return ` (no similar line found; the file has ${lines.length} lines — re-read it.)${readFileRetryHint(p, 1, Math.min(lines.length, 80))}`;
   const a = Math.max(0, hit - 2);
-  const b = Math.min(lines.length, hit + 3);
+  const b = Math.min(lines.length, hit + Math.max(8, oldLineCount + 5));
   const snippet = lines
     .slice(a, b)
     .map((l, k) => `  ${a + k + 1}: ${JSON.stringify(l)}`)
     .join('\n');
-  return `\nActual file lines near the closest match (JSON-escaped — match these bytes EXACTLY):\n${snippet}`;
+  return `\nActual file lines near the closest match (JSON-escaped — match these bytes EXACTLY):\n${snippet}${readFileRetryHint(p, a + 1, b - a)}`;
+}
+
+function readFileRetryHint(pathHint, offset, limit) {
+  const pathPart = `"path":${JSON.stringify(pathHint || '<same path>')},`;
+  return `\nNEXT REQUIRED TOOL: read_file {${pathPart}"offset":${offset},"limit":${limit}}. Then retry edit_file using text copied from that fresh read_file result.`;
 }
 
 function globToRegExp(glob) {