@noobdemon/noob-cli 1.10.20 → 1.11.0

package/src/repl/workflow-commands.js

@@ -0,0 +1,238 @@
+// Workflow read-only commands — chỉ in console, không đụng state/ask/tui.
+// Tách ra khỏi repl.js để giảm kích thước file chính + dễ test riêng.
+// workflowSave + maybeAskWorkflowDescription vẫn ở repl.js vì cần ask()/tui.
+
+import { listWorkflows, loadWorkflow, deleteWorkflow, workflowsDir } from '../workflows.js';
+import { getBuiltinWorkflow, listBuiltinWorkflows } from '../workflows-builtin.js';
+
+// ── workflowBuiltins ───────────────────────────────────────────────────────
+// compact=true → 1 dòng/workflow (dùng trong /workflow help). default → kèm description.
+export function workflowBuiltins({ c, t, compact = false } = {}) {
+  const items = listBuiltinWorkflows();
+  if (!compact) {
+    console.log(
+      c.tool(
+        '  ' + (t.workflowBuiltinsTitle || `🎼 Workflow built-in (${items.length} mẫu ship sẵn):`)
+      )
+    );
+  } else {
+    console.log(c.accent('  Built-in workflow:'));
+  }
+  for (const w of items) {
+    console.log('    ' + c.accent('/workflow run ' + w.name) + c.dim('  · ' + w.pattern));
+    if (!compact) console.log('       ' + c.dim(w.description));
+  }
+  if (!compact) {
+    console.log('');
+    console.log(
+      c.dim('  Chạy: /workflow run <name> [input]. VD: /workflow run verify-claims README.md')
+    );
+  }
+}
+
+// ── workflowHelp ───────────────────────────────────────────────────────────
+// Menu chính khi user gõ /workflow (rỗng) hoặc /workflow help.
+export function workflowHelp({ c, t }) {
+  console.log(
+    c.tool('  ' + (t.workflowHelpTitle || '🎼 /workflow — orchestrate multi-agent workflow'))
+  );
+  console.log(
+    c.dim(
+      '  ' +
+        (t.workflowHelpSub ||
+          'Workflow chia task lớn thành sub-agent chạy song song/độc lập → chống 3 failure mode của single-context: agentic laziness, self-preferential bias, goal drift.')
+    )
+  );
+  console.log('');
+  console.log(c.accent('  Cú pháp:'));
+  console.log('    /workflow <yêu cầu>          chạy ad-hoc (model tự design workflow)');
+  console.log('    /workflow help | ?            menu này');
+  console.log('    /workflow patterns            6 pattern workflow (theo article Thariq)');
+  console.log('    /workflow builtins            3 workflow built-in có sẵn');
+  console.log('    /workflow list                workflow đã lưu');
+  console.log('    /workflow save <name> <req>   lưu prompt template → ~/.noob/workflows/');
+  console.log('    /workflow load <name>         xem nội dung (saved hoặc built-in)');
+  console.log('    /workflow run <name> [extra]  chạy (built-in HOẶC saved, có thể thêm ngữ cảnh)');
+  console.log('    /workflow delete|rm <name>    xoá workflow đã lưu');
+  console.log('');
+  console.log(c.accent('  Nhanh nhất để thử:'));
+  console.log('    ' + c.dim('/workflow builtins                       ') + 'xem có sẵn cái nào');
+  console.log(
+    '    ' + c.dim('/workflow run deep-research "async-await trong Python"') + '  chạy ngay'
+  );
+  console.log(
+    '    ' + c.dim('/workflow run verify-claims README.md    ') + 'verify claim trong tài liệu'
+  );
+  console.log('');
+  console.log(
+    c.dim(
+      '  💡 Repeatable workflow (triage, research, verify) — pair với /loop <interval> + /goal <text>'
+    )
+  );
+  console.log('');
+  workflowBuiltins({ c, t, compact: true });
+}
+
+// ── workflowPatterns ───────────────────────────────────────────────────────
+// 6 pattern theo article Thariq. Mỗi pattern 1 dòng — user scan nhanh.
+export function workflowPatterns({ c, t }) {
+  const PATTERNS = [
+    [
+      'Classify-and-act',
+      'classifier phân loại task → route tới sub-agent chuyên dụng. HOẶC classifier ở cuối để check output. Khi: input không đồng nhất, mỗi loại cần chiến lược khác.',
+    ],
+    [
+      'Fan-out-and-synthesize',
+      'task lớn chia N nhánh độc lập song song → gom kết quả. SYNTHESIZE STEP LÀ BARRIER (article L93): đợi tất cả fan-out xong mới merge. Khi: partition rõ theo file/module/khía cạnh.',
+    ],
+    [
+      'Adversarial verification',
+      '1 agent LÀM, 1 agent KHÁC verify output chống rubric/criteria. Khi: claim cần verify, code rủi ro, quyết định khó đảo.',
+    ],
+    [
+      'Generate-and-filter',
+      'sinh nhiều phương án song song → 1 agent lọc theo rubric/verify → dedupe → trả về top. Khi: bài toán mở, cần đa dạng giải pháp đã verify.',
+    ],
+    [
+      'Tournament',
+      "N agents CÙNG LÀM 1 task với approach khác nhau → judge pairwise cho tới khi có winner. Pairwise comparison reliable hơn absolute scoring. Khi: cần ranking/rubric, hoặc bài toán 'taste' (naming, design).",
+    ],
+    [
+      'Loop-until-done',
+      'sub-agent làm 1 vòng, parent check stop condition (no new findings / no more errors), chưa đạt → spawn lại. Khi: lượng work không biết trước, có metric đo được.',
+    ],
+  ];
+  console.log(
+    c.tool(
+      '  ' +
+        (t.workflowPatternsTitle ||
+          '🎼 6 pattern workflow (theo article Thariq — A harness for every task)')
+    )
+  );
+  PATTERNS.forEach(([name, desc], i) => {
+    console.log('    ' + c.accent(`${i + 1}. ${name}`));
+    console.log('       ' + c.dim(desc));
+  });
+  console.log('');
+  console.log(
+    c.dim(
+      '  Tổ hợp: 1 workflow có thể compose nhiều pattern (vd triage = classify-and-act + loop-until-done + quarantine).'
+    )
+  );
+  console.log(
+    c.dim(
+      '  Lưu ý (article L165-167): workflow KHÔNG cần cho mọi task — tốn nhiều token. Việc < vài file → tự làm.'
+    )
+  );
+}
+
+// ── workflowList ───────────────────────────────────────────────────────────
+export function workflowList({ c, t }) {
+  const saved = listWorkflows();
+  const builtins = listBuiltinWorkflows();
+  // Luôn show cả 2 nhóm — built-in quan trọng vì user quên chúng có sẵn.
+  console.log(
+    c.tool(
+      '  ' +
+        (t.workflowListHeader
+          ? t.workflowListHeader(workflowsDir())
+          : `Workflow đã lưu (${workflowsDir()}):`)
+    )
+  );
+  if (saved.length) {
+    for (const it of saved) {
+      const desc = it.description ? c.dim(' — ' + it.description) : '';
+      const date = it.updated ? c.dim(' [' + it.updated.slice(0, 10) + ']') : '';
+      console.log('    ' + c.accent(it.name) + desc + date);
+    }
+  } else {
+    console.log(c.dim('    (chưa có — /workflow save <name> <yêu cầu> để tạo)'));
+  }
+  console.log('');
+  console.log(c.accent('  Built-in workflow (chạy ngay, không cần save):'));
+  for (const w of builtins) {
+    console.log('    ' + c.accent('/workflow run ' + w.name) + c.dim('  · ' + w.title));
+  }
+  console.log('');
+  console.log(
+    c.dim('  Dùng: /workflow <yêu cầu>  hoặc  /workflow run <name> [input]  hoặc  /workflow help')
+  );
+}
+
+// ── workflowLoad ───────────────────────────────────────────────────────────
+export function workflowLoad(name, { c, t }) {
+  if (!name) {
+    return console.log(
+      c.err('  ' + (t.workflowLoadNeedName || 'Cách dùng: /workflow load <name>'))
+    );
+  }
+  // Check built-in trước — user có thể quên chúng có sẵn.
+  const builtin = getBuiltinWorkflow(name);
+  if (builtin) {
+    console.log(c.tool('  ' + `🎼 Built-in workflow '${builtin.name}' — ${builtin.title}`));
+    console.log(c.dim('    pattern: ' + builtin.pattern));
+    console.log(c.dim('    ' + builtin.description));
+    console.log('');
+    console.log(
+      c.dim('  ── prompt template (chạy bằng /workflow run ' + builtin.name + ' <input>) ──')
+    );
+    console.log(builtin.buildPrompt('<input>'));
+    return;
+  }
+  const r = loadWorkflow(name);
+  if (!r.ok) {
+    return console.log(
+      c.err(
+        '  ' +
+          (t.workflowLoadError
+            ? t.workflowLoadError(name, r.error)
+            : `Không nạp được workflow '${name}': ${r.error}`)
+      )
+    );
+  }
+  console.log(
+    c.tool(
+      '  ' +
+        (t.workflowLoadOk ? t.workflowLoadOk(r.name, r.path) : `Workflow '${r.name}' (${r.path}):`)
+    )
+  );
+  if (r.meta.description) console.log(c.dim('    ' + r.meta.description));
+  if (r.meta.updated) console.log(c.dim('    updated: ' + r.meta.updated));
+  console.log('');
+  console.log(r.prompt);
+}
+
+// ── workflowDelete ─────────────────────────────────────────────────────────
+export function workflowDelete(name, { c, t }) {
+  if (!name) {
+    return console.log(
+      c.err('  ' + (t.workflowDeleteNeedName || 'Cách dùng: /workflow delete <name>'))
+    );
+  }
+  // Chỉ xoá saved — built-in không xoá được.
+  const builtin = getBuiltinWorkflow(name);
+  if (builtin) {
+    return console.log(
+      c.err(
+        '  ' +
+          (t.workflowDeleteBuiltIn
+            ? t.workflowDeleteBuiltIn(name)
+            : `'${name}' là built-in workflow, không xoá được.`)
+      )
+    );
+  }
+  const r = deleteWorkflow(name);
+  if (!r.ok) {
+    return console.log(
+      c.err(
+        '  ' +
+          (t.workflowDeleteError
+            ? t.workflowDeleteError(name, r.error)
+            : `Không xoá được workflow '${name}': ${r.error}`)
+      )
+    );
+  }
+  console.log(
+    c.tool('  ' + (t.workflowDeleteOk ? t.workflowDeleteOk(name) : `Đã xoá workflow '${name}'.`))
+  );
+}