@noobdemon/noob-cli 1.12.10 → 1.12.11

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 Tất cả thay đổi đáng kể của `@noobdemon/noob-cli` được ghi vào file này.
 
+## [1.12.11] - 2026-06-13
+
+### Added
+- **Tool `workflow` — orchestration chạy NỀN (background), parity với Claude Code** (`src/workflow-bg.js` mới + `src/tools.js` + `src/repl/agent-dispatch.js` + `src/repl.js`): model gọi `workflow {prompt, name?}` → kick off headless `runAgent` chạy nền với own `AbortController` + own `TokenMeter`, trả về NGAY (không block turn). Khác `spawn_agents` (block lượt tới khi mọi sub-agent xong): `workflow` detach hẳn — user tiếp tục làm việc khác, kết quả consolidated tự chèn vào lượt sau qua `pending` queue. Registry session-scope (`createBgRegistry`), cap 3 run nền song song (vượt → tool trả ERROR), không lồng (bg dispatcher KHÔNG có bgRegistry → workflow nền không tự spawn workflow nền). Main loop drain completion giữa các lượt → notify + auto-inject. Exit CLI (Ctrl+C×2 hoặc /quit) → `sweepOnExit` mark mọi run active = interrupted (journal resume-able qua `/workflow resume <id>`). Lệnh mới: `/workflow active` (list run đang chạy), `/workflow stop <id>|all` (huỷ, resume được). Smoke `scripts/smoke-workflow-bg.mjs` 6/6 pass (start-returns-immediately, cap-3, drain-yields-result, stopBg-interrupted, sweepOnExit, empty-prompt-reject).
+
 ## [1.12.10] - 2026-06-13
 
 ### Fixed

package/package.json

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

package/src/i18n.js

@@ -205,6 +205,9 @@ export const 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}`,
+  bgWorkflowSweep: (n) => `${n} workflow nền bị ngắt — resume bằng /workflow resume <id>`,
   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)

package/src/repl/agent-dispatch.js

@@ -33,6 +33,9 @@ import { t } from '../i18n.js';
  */
 export function createAgentDispatcher(deps) {
   const { state, abort, tokenMeter, stopSpin, startSpin, execTool, tui, c } = deps;
+  // bgRegistry: tuỳ chọn — chỉ wire ở dispatcher của TURN (repl.js), KHÔNG ở bg
+  // dispatcher (tránh đệ quy: workflow nền spawn workflow nền). Thiếu → tool báo lỗi.
+  const bgRegistry = deps.bgRegistry || null;
   // Test injection points: production luôn dùng default; smoke test pass mock.
   const runSubAgent = deps.runSubAgent || defaultRunSubAgent;
   const findModel = deps.findModel || defaultFindModel;
@@ -95,6 +98,44 @@ export function createAgentDispatcher(deps) {
       };
     }
 
+    // workflow: kick off orchestration NỀN, trả về NGAY. Cần agentMode (workflow
+    // spawn sub-agent) + bgRegistry (chỉ wire ở turn dispatcher, KHÔNG ở bg → chống
+    // workflow nền tự spawn workflow nền).
+    if (name === 'workflow') {
+      if (!bgRegistry)
+        return {
+          allow: true,
+          result: 'ERROR: workflow nền không khả dụng ở ngữ cảnh này (vd đang trong 1 workflow nền khác — không lồng).',
+        };
+      if (!state.agentMode)
+        return {
+          allow: true,
+          result: 'ERROR: agent mode đang TẮT — gõ /agent on trước khi chạy workflow nền.',
+        };
+      const prompt = input?.prompt || '';
+      const wfName = input?.name || null;
+      const r = bgRegistry.startBgWorkflow({ prompt, name: wfName });
+      if (!r.ok) {
+        if (r.error === 'cap')
+          return {
+            allow: true,
+            result: `ERROR: đã đạt ${bgRegistry.MAX_BG} workflow nền song song — chờ một run xong hoặc /workflow stop <id>.`,
+          };
+        if (r.error === 'empty_prompt')
+          return { allow: true, result: 'ERROR: workflow cần field "prompt" (yêu cầu cho workflow).' };
+        return { allow: true, result: 'ERROR khởi tạo workflow nền: ' + r.error };
+      }
+      stopSpin();
+      console.log(
+        chalk.hex('#8b5cf6')(`  🎼 workflow nền bắt đầu — run ${r.id}`)
+      );
+      startSpin(t.thinking);
+      return {
+        allow: true,
+        result: `workflow đã chạy NỀN (run ${r.id}). Trả về ngay — KHÔNG chờ. Kết quả consolidated sẽ tự chèn vào lượt sau khi xong. Huỷ: /workflow stop ${r.id}. Tiếp tục việc khác hoặc kết thúc reply.`,
+      };
+    }
+
     // spawn_agent / spawn_agents chỉ được phép khi agentMode bật; depth giới hạn
     // bởi MAX_SUBAGENT_DEPTH để tránh đệ quy nổ.
     if (name === 'spawn_agent' || name === 'spawn_agents') {

package/src/repl/workflow-commands.js

@@ -56,6 +56,8 @@ export function workflowHelp({ c, t }) {
   console.log('    /workflow runs                list run journal đã chạy (resume-able)');
   console.log('    /workflow log <id>            xem chi tiết 1 run (sub-agent task + kết quả)');
   console.log('    /workflow resume <id>         chạy lại run, skip task đã done → tiết kiệm token');
+  console.log('    /workflow active              workflow nền đang chạy');
+  console.log('    /workflow stop <id> | all     huỷ workflow nền (resume được)');
   console.log('    /workflow delete|rm <name>    xoá workflow đã lưu');
   console.log('');
   console.log(c.accent('  Nhanh nhất để thử:'));

package/src/repl.js

@@ -82,6 +82,7 @@ import {
   shortCwd, shortPath, relTime, firstLine, truncate, fmtTime, fmtK, preview,
 } from './repl/utils.js';
 import { createAgentDispatcher } from './repl/agent-dispatch.js';
+import { createBgRegistry } from './workflow-bg.js';
 export async function startRepl(opts = {}) {
   const state = createState(opts, config);
   const tokenMeter = new TokenMeter();
@@ -252,6 +253,10 @@ export async function startRepl(opts = {}) {
       // lần 2 trong cửa sổ 1.5s → thoát
       if (sigintTimer) clearTimeout(sigintTimer);
       exiting = true;
+      // Bg workflow đang chạy → abort + mark interrupted (journal resume-able).
+      const swept = bgRegistry.sweepOnExit();
+      if (swept > 0)
+        console.log(c.dim('  ' + (t.bgWorkflowSweep ? t.bgWorkflowSweep(swept) : `${swept} workflow nền bị ngắt — resume bằng /workflow resume <id>`)));
       persist();
       console.log(c.dim('\n  ' + t.bye));
       tui.close(); // khôi phục terminal (raw mode/paste/stdout) trước khi thoát
@@ -453,6 +458,8 @@ Thực thi: đọc/tạo file cần thiết bằng tool, viết code production-
       if (sub === 'runs') return workflowRuns();
       if (sub === 'log') return workflowLog(rest);
       if (sub === 'resume') return workflowResume(rest);
+      if (sub === 'stop') return workflowStop(rest);
+      if (sub === 'active') return workflowActive();
     }
     // Default: ad-hoc workflow (giữ behavior cũ — model design workflow từ request).
     await workflowExecute(trimmed);
@@ -594,6 +601,42 @@ Thực thi THEO ĐÚNG THỨ TỰ (BẮT BUỘC):
     return _workflowList({ c, t });
   }
 
+  // Huỷ workflow nền theo id (hoặc `all`). Journal mark interrupted → resume được.
+  function workflowStop(arg) {
+    const id = (arg || '').trim();
+    if (!id) {
+      const active = bgRegistry.activeRuns();
+      if (!active.length) return console.log(c.dim('  không có workflow nền nào đang chạy.'));
+      console.log(c.err('  cần id: /workflow stop <id> | all'));
+      for (const r of active) console.log('    ' + c.accent(r.id) + (r.name ? c.dim(' · ' + r.name) : ''));
+      return;
+    }
+    if (id === 'all') {
+      const n = bgRegistry.sweepOnExit();
+      return console.log(
+        c.tool('  🎼 ' + (n ? `đã huỷ ${n} workflow nền — resume bằng /workflow resume <id>` : 'không có workflow nền nào đang chạy.'))
+      );
+    }
+    const ok = bgRegistry.stopBg(id);
+    console.log(
+      ok
+        ? c.tool('  🎼 đã huỷ workflow nền ' + c.accent(id) + c.dim(' — resume bằng /workflow resume ' + id))
+        : c.err('  không tìm thấy workflow nền đang chạy với id: ' + id)
+    );
+  }
+
+  // List workflow nền đang chạy.
+  function workflowActive() {
+    const active = bgRegistry.activeRuns();
+    if (!active.length) return console.log(c.dim('  không có workflow nền nào đang chạy.'));
+    console.log(c.tool(`  🎼 workflow nền đang chạy (${active.length}/${bgRegistry.MAX_BG}):`));
+    const now = Date.now();
+    for (const r of active) {
+      const secs = Math.round((now - r.startedAt) / 1000);
+      console.log('    ' + c.accent(r.id) + (r.name ? c.dim(' · ' + r.name) : '') + c.dim(` · ${secs}s`));
+    }
+  }
+
   function workflowLoad(name) {
     return _workflowLoad(name, { c, t });
   }
@@ -1292,6 +1335,21 @@ NGUYÊN TẮC:
 
   // Main loop — runs until /exit, double Ctrl+C, or EOF. Never exits after a task.
   while (true) {
+    // Drain bg workflow đã xong → notify + auto-inject kết quả vào pending (gửi
+    // như lượt mới, model tổng hợp cho user). Làm TRƯỚC khi đọc input để kết quả
+    // nền không kẹt sau lượt user đang gõ.
+    const fin = bgRegistry.drainCompletions();
+    for (const f of fin) {
+      const label = f.name ? `${f.name} (${f.id})` : f.id;
+      if (f.status === 'done') {
+        console.log(c.tool('  🎼 ' + (t.bgWorkflowDone ? t.bgWorkflowDone(label) : `workflow nền ${label} đã xong`)));
+        pending.push(
+          `[Kết quả workflow nền "${label}"]\n${f.result}\n\nTổng hợp kết quả trên cho user (ngắn gọn, nêu điểm chính). Đây là output từ workflow chạy nền — KHÔNG chạy lại.`
+        );
+      } else {
+        console.log(c.err('  🎼 ' + (t.bgWorkflowFailed ? t.bgWorkflowFailed(label, f.error) : `workflow nền ${label} lỗi: ${f.error}`)));
+      }
+    }
     let input;
     if (pending.length) {
       // Có tin xếp hàng → tự gửi câu kế tiếp (không chờ gõ).
@@ -1419,7 +1477,7 @@ NGUYÊN TẮC:
       // src/repl/agent-dispatch.js (v1.12.x). Factory được gọi MỖI turn vì abort
       // được rebind trong handle() — không cache.
       const dispatchTool = createAgentDispatcher({
-        state, abort, tokenMeter, stopSpin, startSpin, execTool, tui, c,
+        state, abort, tokenMeter, stopSpin, startSpin, execTool, tui, c, bgRegistry,
       });
 
       const answer = await runAgent({
@@ -1596,6 +1654,18 @@ NGUYÊN TẮC:
     return await execToolCore(name, input, { retried: false });
   }
 
+  // Background workflow registry — session-scope, sống ngoài turn. Tool `workflow`
+  // (qua turn dispatcher) gọi startBgWorkflow → headless runAgent nền. Drain ở main
+  // loop giữa lượt → notify + auto-inject. bgRegistry KHÔNG wire vào bg dispatcher
+  // (chống lồng workflow nền). state + execTool + spawnAgentToolsDoc đã sẵn ở scope.
+  const bgRegistry = createBgRegistry({
+    createAgentDispatcher,
+    state,
+    execTool,
+    spawnAgentToolsDoc,
+    cwd: process.cwd(),
+  });
+
   // Phần thân tool (tách riêng để retry khi user vừa approve thêm extra root).
   // Flow OutOfScopeError: tool ném → repl hỏi user "add folder X? [y/n/a]" → nếu
   // y/a: addRoot + persist (đã làm trong addRoot) + state.extraRoots sync + chạy
@@ -1998,11 +2068,15 @@ NGUYÊN TẮC:
         break;
       case 'exit':
       case 'quit':
-      case 'q':
+      case 'q': {
+        const swept = bgRegistry.sweepOnExit();
+        if (swept > 0)
+          console.log(c.dim('  ' + (t.bgWorkflowSweep ? t.bgWorkflowSweep(swept) : `${swept} workflow nền bị ngắt — resume bằng /workflow resume <id>`)));
         persist();
         exiting = true;
         console.log(c.dim('  ' + t.bye));
         return true;
+      }
       default:
         console.log(c.err('  ' + t.unknownCmd(cmd)) + c.dim('  ' + t.tryHelp));
     }

package/src/subagent.js

@@ -87,6 +87,9 @@ Khi nhiệm vụ phức tạp / chia được thành nhiều phần độc lập
   Chạy 1 sub-agent độc lập, trả về kết quả dạng string (text cuối của sub-agent).
 - spawn_agents {"agents": [{"task": str, "context"?: str, "model"?: str}, ...]}
   Chạy NHIỀU sub-agent SONG SONG (Promise.all). Trả về mảng kết quả ghép theo thứ tự, mỗi phần có header "── sub-agent #N ──".
+- workflow {"prompt": str, "name"?: str}
+  Chạy orchestration NỀN (background) — trả về NGAY, KHÔNG chờ. Dùng khi job dài, nhiều sub-agent, user muốn làm việc khác trong lúc chờ. Kết quả consolidated tự chèn vào lượt sau khi xong. Cap 3 workflow nền song song. Huỷ: /workflow stop <id>.
+  KHÁC spawn_agents: spawn_agents BLOCK lượt hiện tại tới khi mọi sub-agent xong (dùng khi cần kết quả NGAY trong lượt này để tổng hợp). workflow detach hẳn (dùng cho job dài user không muốn ngồi chờ). KHÔNG lồng — workflow nền không tự gọi workflow nền.
 
 ## Rules
 1. TASK PHẢI CỤ THỂ: nêu rõ goal + output mong đợi (vd "đọc src/api.js, liệt kê tất cả endpoint + method, trả về dạng bảng markdown"). Đừng giao task mơ hồ kiểu "phân tích code".

package/src/tools.js

@@ -213,7 +213,7 @@ export const DESTRUCTIVE = new Set(['write_file', 'edit_file', 'run_command']);
 
 /**
  * Tên các tool model có thể gọi.
- * @typedef {'read_file'|'web_fetch'|'write_file'|'edit_file'|'list_dir'|'glob'|'grep'|'run_command'|'bg_output'|'kill_bg'} ToolName
+ * @typedef {'read_file'|'web_fetch'|'write_file'|'edit_file'|'list_dir'|'glob'|'grep'|'run_command'|'bg_output'|'kill_bg'|'workflow'} ToolName
  */
 
 /**
@@ -234,6 +234,8 @@ export const DESTRUCTIVE = new Set(['write_file', 'edit_file', 'run_command']);
  * @property {number} [id] bg_output/kill_bg
  * @property {string} [url] web_fetch: URL http/https cần tải
  * @property {boolean} [raw] web_fetch: true = trả HTML thô, không strip
+ * @property {string} [prompt] workflow: yêu cầu workflow chạy nền
+ * @property {string} [name] workflow: tên tuỳ chọn cho run
  */
 
 /**
@@ -774,6 +776,8 @@ export function describe(name, input) {
       return `↳ sub-agent: ${String(input.task || '').slice(0, 80)}`;
     case 'spawn_agents':
       return `↳ ${(input.tasks || []).length} sub-agent song song`;
+    case 'workflow':
+      return `🎼 workflow nền: ${String(input.prompt || '').slice(0, 60)}`;
     case 'write_todos': {
       const items = Array.isArray(input?.todos) ? input.todos : [];
       const done = items.filter((it) => it && it.done).length;

package/src/workflow-bg.js

@@ -0,0 +1,172 @@
+// Background workflow registry — chạy orchestration NỀN, không block turn.
+//
+// Khác /workflow blocking (repl.js:521-569): tool `workflow` model gọi → kick
+// off headless runAgent với own AbortController + own TokenMeter, trả về NGAY
+// {run_id}. Turn không chờ. Kết quả consolidated được drain ở main loop giữa
+// các lượt → push vào `pending` → auto-inject lượt sau.
+//
+// Lifecycle: session-scope (sống ngoài turn spawn nó). Cap MAX_BG=3 song song.
+// Exit CLI → sweepOnExit() mark mọi run active = interrupted (journal resume-able).
+//
+// KHÔNG closure coupling — plain map + functions, deps inject để test (noob.md rule).
+
+import { runAgent } from './agent.js';
+import { TokenMeter } from './tokens.js';
+import { createRun, closeRun } from './workflow-runs.js';
+
+export const MAX_BG = 3;
+
+// Tạo registry. Deps inject (production wire ở repl.js; test pass mock).
+//   deps.createAgentDispatcher — factory dựng dispatchTool cho 1 bg run
+//   deps.state                 — state object (agentMode, model…)
+//   deps.execTool              — async (name, input) → {allow, result}
+//   deps.spawnAgentToolsDoc    — (depth) => string doc sub-agent tool
+//   deps.cwd                   — process.cwd() cho journal path
+//   deps.runAgent / deps.createRun / deps.closeRun — test override
+export function createBgRegistry(deps = {}) {
+  const {
+    createAgentDispatcher,
+    state,
+    execTool,
+    spawnAgentToolsDoc,
+    cwd = process.cwd(),
+  } = deps;
+  const _runAgent = deps.runAgent || runAgent;
+  const _createRun = deps.createRun || createRun;
+  const _closeRun = deps.closeRun || closeRun;
+
+  // runId → { id, name, controller, meter, status, startedAt, result, error }
+  const runs = new Map();
+  // Hàng đợi run đã settle, chờ main loop drain.
+  const completions = [];
+
+  const activeCount = () =>
+    [...runs.values()].filter((r) => r.status === 'running').length;
+
+  // Kick off 1 bg workflow. Trả về { ok, id } hoặc { ok:false, error }.
+  function startBgWorkflow({ prompt, name = null } = {}) {
+    if (!prompt || typeof prompt !== 'string' || !prompt.trim()) {
+      return { ok: false, error: 'empty_prompt' };
+    }
+    if (activeCount() >= MAX_BG) {
+      return { ok: false, error: 'cap' };
+    }
+    let run;
+    try {
+      run = _createRun({ name: name || 'bg', workflowPrompt: prompt, cwd });
+    } catch (e) {
+      return { ok: false, error: 'journal:' + (e?.message || e) };
+    }
+
+    const controller = new AbortController();
+    const meter = new TokenMeter();
+    const entry = {
+      id: run.id,
+      name,
+      controller,
+      meter,
+      status: 'running',
+      startedAt: Date.now(),
+      result: null,
+      error: null,
+    };
+    runs.set(run.id, entry);
+
+    // workflowRun riêng cho bg dispatcher: journal cache dùng run.data này, KHÔNG
+    // đụng state.workflowRun của turn (turn có thể đang chạy /workflow blocking).
+    const bgWorkflowRun = { id: run.id, data: run.data, path: run.path };
+
+    // Headless dispatcher: own controller + meter, stub spinner/tui (bg không có UI).
+    const noop = () => {};
+    const dispatchTool = createAgentDispatcher({
+      state: { ...state, workflowRun: bgWorkflowRun },
+      abort: controller,
+      tokenMeter: meter,
+      stopSpin: noop,
+      startSpin: noop,
+      execTool,
+      tui: null,
+      c: null,
+    });
+
+    // Chạy headless. runAgent options TUI-bound (onStatus/onDelta/onSteer) bỏ —
+    // đều optional, ?.-guard trong agent.js.
+    const history = [{ role: 'user', content: prompt }];
+    const promise = _runAgent({
+      history,
+      model: state.model.id,
+      signal: controller.signal,
+      tokenMeter: meter,
+      goal: prompt,
+      extraToolsDoc: spawnAgentToolsDoc ? spawnAgentToolsDoc(0) : '',
+      onTool: (n, inp) => dispatchTool(n, inp, 0),
+    })
+      .then((answer) => {
+        entry.status = 'done';
+        entry.result = typeof answer === 'string' ? answer : String(answer ?? '');
+        try { _closeRun(run.data, 'done', cwd); } catch {}
+        completions.push({ id: run.id, name, status: 'done', result: entry.result });
+      })
+      .catch((err) => {
+        const isAbort = err?.message === 'aborted' || err?.name === 'AbortError';
+        entry.status = isAbort ? 'interrupted' : 'failed';
+        entry.error = err?.message || String(err);
+        try { _closeRun(run.data, entry.status, cwd); } catch {}
+        // Abort do stopBg/sweepOnExit → KHÔNG enqueue completion (user chủ động huỷ).
+        if (!isAbort) {
+          completions.push({ id: run.id, name, status: entry.status, error: entry.error });
+        }
+      });
+    entry.promise = promise;
+
+    return { ok: true, id: run.id };
+  }
+
+  // Lấy + xoá các run đã settle. Main loop gọi giữa lượt → notify + auto-inject.
+  function drainCompletions() {
+    if (!completions.length) return [];
+    const out = completions.splice(0);
+    for (const c of out) runs.delete(c.id);
+    return out;
+  }
+
+  // Huỷ 1 bg run. controller.abort() → runAgent throw 'aborted' → catch mark
+  // interrupted + closeRun. Trả về true nếu có run để huỷ.
+  function stopBg(id) {
+    const entry = runs.get(id);
+    if (!entry || entry.status !== 'running') return false;
+    entry.controller.abort();
+    return true;
+  }
+
+  // Exit CLI: abort + mark interrupted mọi run active. Journal đầy đủ để resume.
+  // Đồng bộ (không await) — exit path không chờ promise settle.
+  function sweepOnExit() {
+    let n = 0;
+    for (const entry of runs.values()) {
+      if (entry.status === 'running') {
+        entry.controller.abort();
+        entry.status = 'interrupted';
+        n++;
+      }
+    }
+    return n;
+  }
+
+  // List run đang chạy — cho /workflow active + cảnh báo exit.
+  function activeRuns() {
+    return [...runs.values()]
+      .filter((r) => r.status === 'running')
+      .map((r) => ({ id: r.id, name: r.name, startedAt: r.startedAt }));
+  }
+
+  return {
+    startBgWorkflow,
+    drainCompletions,
+    stopBg,
+    sweepOnExit,
+    activeRuns,
+    activeCount,
+    MAX_BG,
+  };
+}