xitto-kernel 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,61 @@
+# Changelog
+
+## 0.3.0
+
+把底座的「能力」與「體驗」補到接近 Claude Code，並擴充領域 pack 與評測。
+
+### 新增
+
+- **完整 Ink TUI**（`--tui`）：持久底部狀態列（model/cwd/git/權限/sandbox/plan/ctx）、`Static` 捲動轉錄、即時串流重繪、Esc 中斷、markdown/程式碼語法高亮、Select 式權限詢問；非真實終端自動退回 readline CLI
+- **新領域 pack**：`deep-research`（多源檢索→深讀→綜整）、`devops`
+- **agent loop 內建化**：把 xitto-code 的 agent loop 移植進 `runTurn`（自帶、用 pi-ai streamFn）
+- **真實 sandbox 接入守衛鏈第 5 格**：macOS Seatbelt（sandbox-exec）OS 層隔離
+- **server app PoC**：把 kernel 包成 HTTP 服務（`/v1/run`、`/v1/stream` SSE、bearer 驗證、per-session workdir）
+- **評測框架**：scorers（answerMatch/stateCheck/toolCalled/allOf）+ SWE-bench mini 與真實 SWE-bench Verified adapter；各 pack eval 套件
+- 套件匯出補上 `./packs/general`、`./packs/deep-research`、`./packs/devops`
+
+### 驗證
+
+- 真實 SWE-bench Verified：coding pack（MiniMax）可重現解出 flask-5014、requests-1142 等
+- 測試 116/116 通過（含 Ink TUI 煙霧測試）
+
+## 0.2.0
+
+第一個功能完整版 —— 從 0.1.0（基礎 kernel + CLI + 腳手架）補齊近乎 xitto-code 等價的能力，
+並加入通用自主 agent。
+
+### 新增
+
+- **記憶 + session resume**：`memory_save`/`memory_list` 工具自動注入；`--resume [id]`、`/sessions`、`/resume`、`/memory`
+- **互動權限確認**：mutating/危險工具執行前彈確認（y/a/n）；`always` 記住；`--yes`/`/auto` 自動核准（危險仍把關）
+- **計劃模式 + 撤銷**：`/plan`（只規劃、擋 mutating）、`/undo`（還原上次 write/edit）
+- **git 能力**（coding pack）：`git_status` / `git_diff` / `git_log` / `git_commit`
+- **子 agent**：`spawn_agent` 派唯讀子 agent 做聚焦調查
+- **hooks**：PreToolUse / PostToolUse（`.xitto-kernel/<pack>/settings.json`）
+- **skills**：漸進揭露（`.xitto-kernel/<pack>/skills/*.md` + `skill` 工具）
+- **MCP**：連 MCP server（stdio），工具以 `mcp__<server>__<tool>` 注入
+- **回合內上下文壓縮**：逼近視窗時摘要較舊對話、保留最近
+- **輕量串流 markdown 渲染** + edit/write 彩色 diff（CLI）
+- **通用自主 agent**：`general` pack（檔案/shell/`web_fetch`/`web_search`）+ **goal loop**
+  （`runGoal` / `--goal "..."` / `/goal`：給目標、反覆做到完成、LLM 自我驗收）
+- **code agent 工具升級（達 Claude Code 等級）**：
+  - `grep`（正則搜內容、`path:line`、glob 過濾）、`glob`（`**` 遞迴找檔）
+  - `read` 附行號 + `offset`/`limit`；`edit` 唯一性檢查 + `replaceAll`（避免改錯位置）
+  - `bash` timeout 參數；`bash_bg` / `bash_output` / `bash_kill`（後台 dev server/watch）
+  - `web_fetch`（coding pack 也能查線上文件）
+  - **TodoWrite**（`todo_write`）：多步任務規劃/追蹤，CLI 即時清單渲染（☐/◐/☑）
+
+### 變更
+
+- `new-agent` 產出的專案預設依賴 `^<version>`（正式版本），`--local` 用 `file:` 開發
+- pack.verify / pack.contextFiles slot 接通 runtime
+
+### 修正
+
+- test script 改 `node --test`（Node 20 不支援 `--test` glob）
+- goal loop 驗收健壯性：寬鬆 JSON 解析 + 連續失敗停止
+
+## 0.1.0
+
+首發：kernel（pack 系統 / 工具 metadata / 守衛鏈 / agent loop / 真實 sandbox(Seatbelt)）、
+互動 CLI、腳手架（`new-agent` 產出獨立專案）、三個範例 pack（coding / data-query / notes）。

package/README.md

@@ -1,5 +1,6 @@
 # xitto-kernel
 
+[![npm](https://img.shields.io/npm/v/xitto-kernel.svg)](https://www.npmjs.com/package/xitto-kernel)
 [![CI](https://github.com/ishoplus/xitto-kernel/actions/workflows/ci.yml/badge.svg)](https://github.com/ishoplus/xitto-kernel/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 [![Node](https://img.shields.io/badge/node-%3E%3D20-339933?logo=node.js&logoColor=white)](https://nodejs.org)
@@ -27,13 +28,11 @@ xitto-code 經掃描後，約 **8 成已是領域無關的 kernel**；真正跟
 - `~/.xitto-code/providers.json` —— LLM provider 設定（與 xitto-code 共用，內含 API key）。
   沒有的話，複製一份填入 key 即可（格式見 xitto-code 的 `providers.example.json`）。
 
-**一次性設定**（讓 `xitto-kernel` 成為全域命令）
+**安裝**（已發佈 npm）
 ```bash
-cd xitto-kernel
-npm install
-npm link            # 之後任何目錄都能用 xitto-kernel 命令
+npm install -g xitto-kernel    # 全域命令 xitto-kernel
 ```
-> 不想 link 也行：直接 `node /路徑/xitto-kernel/bin/xitto-kernel.js …` 或在 repo 內 `npm start`。
+> 開發本倉庫：`cd xitto-kernel && npm install && npm link`。
 
 **跑內建 pack（互動 CLI）**
 ```bash
@@ -43,7 +42,29 @@ xitto-kernel --pack data-query
 xitto-kernel --sandbox        # 啟動就開 Seatbelt 沙箱
 ```
 
-**CLI 內操作**：直接打需求（模型會自己呼叫工具）；指令 `/help` `/sandbox [on|off]` `/tools` `/clear` `/exit`；`Ctrl+C` 中斷該輪、閒置時再按一次離開。
+**CLI 內操作**：直接打需求（模型會自己呼叫工具）；指令 `/help` `/goal <目標>` `/sandbox` `/plan` `/undo` `/tools` `/memory` `/sessions` `/resume` `/exit`；`Ctrl+C` 中斷該輪、閒置時再按一次離開。
+
+**通用自主 agent（給目標、自己做到完成）**
+```bash
+xitto-kernel --pack general --yes --goal "抓取 example.com 摘要成繁中寫進 summary.txt"
+```
+`general` pack（檔案/shell/web_fetch）+ kernel 的 **goal loop**（反覆 runTurn + LLM 自我驗收，直到達成/無進展/上限）。互動模式用 `/goal <目標>`。
+
+## 當成服務跑（不只 CLI）
+
+kernel 是 UI 無關的，CLI 只是其中一個 app。`src/app/server.js` 是把它包成 **HTTP 服務**的 PoC
+（零依賴 `node:http`）—— 證明「個人工具 → 可服務化底座」：
+
+```bash
+XITTO_SERVER_TOKEN=secret npm run serve     # http://localhost:8787
+curl -s localhost:8787/health
+curl -s -XPOST localhost:8787/v1/run -H "Authorization: Bearer secret" \
+  -H content-type:application/json -d '{"pack":"general","sessionId":"s1","input":"..."}'
+```
+
+特性：bearer token 認證、**per-session 隔離工作目錄 + 歷史**（多輪記得上文）、沙箱（Seatbelt）、
+結構化 JSON 日誌（審計/觀測）、6 個 pack 可選、JSON 或 SSE（`/v1/stream`）串流。
+「個人 vs 生產」是 **app 層**的事 —— 同一個 kernel，CLI 與 server 是兩個 app。
 
 ## 做你自己的領域 agent（不固化）
 
@@ -93,9 +114,12 @@ xitto-kernel/
 │   │   ├── templates/            ✅ 獨立專案樣板（package.json/index.js/pack.js…）
 │   │   └── providers.js          ✅ providers.json 載入（provider 設定屬 app，非 kernel）
 │   └── packs/
-│       ├── coding/               ✅ 參考 pack（read/ls/write/edit/bash 真實工具）
+│       ├── coding/               ✅ 參考 pack（read/ls/write/edit/bash/git）
 │       ├── data-query/           ✅ 第二領域（證明正交）
-│       └── notes/                ✅ 第三領域（知識庫；示範「怎麼做新領域 agent」）
+│       ├── notes/                ✅ 第三領域（知識庫）
+│       ├── general/              ✅ 通用自主 agent（檔案/shell/web/http + goal loop）
+│       ├── deep-research/        ✅ 深度研究（多來源搜尋→查證→有引用結論）
+│       └── devops/               ✅ 維運/SRE（shell + bash_bg + 設定 + 日誌 + 健康檢查）
 ├── bin/xitto-kernel.js           ✅ CLI 進入點（run / new-agent）
 ├── test/                         ✅ 41 測試全綠（runTurn + Seatbelt 隔離 + 腳手架 + …）
 └── examples/
@@ -127,10 +151,28 @@ xitto-kernel/
 **git 能力**（coding pack）、**spawn_agent 子 agent**、**PreToolUse/PostToolUse hooks**、
 **skills 漸進揭露**、**MCP 工具接入**、互動 CLI、腳手架（`new-agent` 產出獨立專案）。75 測試全綠。
 
-**仍為接縫（後續）**：發佈到 npm（讓 `file:` 依賴變正式版本；版本已備 0.1.0）。Ink 全功能 TUI 可作為另一個 app（目前 CLI 已有輕量串流 markdown + 彩色 diff）。
+**已發佈 npm**：`npm install -g xitto-kernel`；`new-agent` 產出的專案預設依賴 `^0.1.0`（`--local` 用 file: 開發）。
+**可選後續**：Ink 全功能 TUI 可作為另一個 app（目前 CLI 已有輕量串流 markdown + 彩色 diff）。
 
 **設計取向**：沿用 Node ESM + pi-ai provider 抽象；不重寫 xitto-code（kernel 是抽象，xitto-code 仍可獨立存在）。
 
+## 評估（能力可量化）
+
+每個 pack 配一個 EvalSuite（`eval/`，共用 `eval/framework.js`，不進 npm 包）。
+範式：**新領域 agent = 新 pack（會什麼）+ 新 EvalSuite（怎麼打分）**。
+
+| Suite | 對標 | 評分方式 | 跑法 | 參考結果* |
+|------|------|------|------|------|
+| coding | SWE-bench Verified | 隱藏測試 fail→pass（Docker）| `eval/swebench-generate.js` + 官方 harness | 3/8 resolved（真實子集）|
+| coding（迷你）| SWE-bench 風格 | 隱藏測試（免 Docker）| `npm run eval` | 4/4 |
+| general | GAIA 風格 | 答案比對 / 狀態檢查 | `node eval/general-run.js` | 4/4 |
+| data-query | Spider/BIRD 風格 | 真實 SQLite + 答案比對 | `node eval/data-query-run.js` | 4/4 |
+| deep-research | GAIA/研究 | 事實正確 + 真的查證（allOf）| `node eval/deep-research-run.js` | 3/3 |
+| devops | Terminal-Bench 風格 | 狀態檢查（系統/檔案達標）| `node eval/devops-run.js` | 4/4 |
+| 工具呼叫 | BFCL 風格 | 軌跡檢查（呼叫對工具/參數）| `node eval/tool-calling-run.js` | 6/6 |
+
+\* 用 MiniMax-M2.7 跑的參考數字（小樣本）；換模型/擴樣本見 `eval/README.md`。scorer 型：`answerMatch` / `stateCheck` / `toolCalled`。
+
 ## 貢獻
 
 見 [CONTRIBUTING.md](CONTRIBUTING.md)。核心原則：kernel 必須領域無關（安全行為靠工具 metadata，不寫死領域名單）；新領域 = 新增一個 pack，kernel 零改動。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xitto-kernel",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "領域無關的 agent 底座（kernel + 可插拔 DomainPack），從 xitto-code 抽象而來",
   "keywords": [
@@ -34,11 +34,14 @@
     "bin",
     "docs",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "test": "node --test",
     "demo": "node examples/demo.js",
+    "eval": "node eval/run.js",
+    "serve": "node src/app/server.js",
     "start": "node bin/xitto-kernel.js"
   },
   "exports": {
@@ -46,10 +49,21 @@
     "./app": "./src/app/index.js",
     "./packs/coding": "./src/packs/coding/index.js",
     "./packs/data-query": "./src/packs/data-query/index.js",
-    "./packs/notes": "./src/packs/notes/index.js"
+    "./packs/notes": "./src/packs/notes/index.js",
+    "./packs/general": "./src/packs/general/index.js",
+    "./packs/deep-research": "./src/packs/deep-research/index.js",
+    "./packs/devops": "./src/packs/devops/index.js"
   },
   "dependencies": {
     "@mariozechner/pi-ai": "^0.70.6",
-    "@modelcontextprotocol/sdk": "^1.29.0"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "cli-highlight": "^2.1.11",
+    "ink": "^5.2.1",
+    "marked": "^12.0.2",
+    "marked-terminal": "^7.3.0",
+    "react": "^18.3.1"
+  },
+  "devDependencies": {
+    "ink-testing-library": "^4.0.0"
   }
 }

package/src/app/cli.js

@@ -41,6 +41,26 @@ export function runCli({ pack, model, getApiKey, sandbox = false, resume = null,
   let history = [];
   let currentAgent = null;
   let streaming = false;
+  const turnUsage = { input: 0, output: 0 }; // 本輪 token 累計（顯示頁腳）
+
+  // 等待 LLM 時的 spinner（首個可見輸出出現即停）
+  const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+  let spinTimer = null;
+  const startSpin = () => {
+    if (!process.stdout.isTTY) return; // 非互動（管線）不顯示 spinner，避免 \r 雜訊
+    let i = 0; const t0 = Date.now();
+    spinTimer = setInterval(() => { process.stdout.write(`\r\x1b[2m${FRAMES[i++ % FRAMES.length]} 思考中… ${Math.round((Date.now() - t0) / 1000)}s\x1b[0m\x1b[K`); }, 100);
+  };
+  const stopSpin = () => { if (spinTimer) { clearInterval(spinTimer); spinTimer = null; process.stdout.write('\r\x1b[K'); } };
+
+  // 目前模式標記（提示列前綴，讓使用者隨時看到狀態）
+  const modeTag = () => {
+    const t = [];
+    if (planMode) t.push('plan');
+    if (sandboxOn) t.push('🔒');
+    if (autoApprove) t.push('⚡');
+    return t.length ? c.gray('[' + t.join(' ') + '] ') : '';
+  };
 
   // 互動權限確認：守衛鏈第 5 格對 mutating/危險工具呼叫此函數。autoApprove → 一律放行。
   // 回 'yes'（允許一次）/ 'always'（此工具全部）/ 'no'（拒絕）。
@@ -88,14 +108,24 @@ export function runCli({ pack, model, getApiKey, sandbox = false, resume = null,
   };
 
   const onEvent = (ev) => {
+    if (ev.type === 'message_end' && ev.message?.usage) { turnUsage.input += ev.message.usage.input || 0; turnUsage.output += ev.message.usage.output || 0; }
     switch (ev.type) {
       case 'message_update': {
         const a = ev.assistantMessageEvent;
-        if (a?.type === 'text_delta' && a.delta) { md.push(a.delta); streaming = true; }
+        if (a?.type === 'text_delta' && a.delta) { stopSpin(); md.push(a.delta); streaming = true; }
         break;
       }
       case 'tool_execution_start':
+        stopSpin();
         endStream();
+        if (ev.toolName === 'todo_write' && Array.isArray(ev.args?.todos)) {
+          out(c.cyan('☑ 待辦更新\n'));
+          for (const t of ev.args.todos) {
+            const mark = t.status === 'completed' ? c.green('☑') : t.status === 'in_progress' ? c.yellow('◐') : c.gray('☐');
+            out(`  ${mark} ${t.status === 'completed' ? c.gray(t.content) : t.content}\n`);
+          }
+          break;
+        }
         out(c.yellow('⚙ ' + ev.toolName) + c.gray('(' + summarize(ev.args) + ')\n'));
         diffPreview(ev.toolName, ev.args);
         break;
@@ -130,6 +160,7 @@ export function runCli({ pack, model, getApiKey, sandbox = false, resume = null,
           '  /sandbox [on|off] 切換沙箱（macOS=Seatbelt 真隔離）',
           '  /auto [on|off]    自動核准 mutating 工具（危險命令仍把關）',
           '  /plan [on|off]    計劃模式（只規劃、擋下實際改動）',
+          '  /goal <目標>      目標驅動自主循環（反覆做到完成）',
           '  /undo            撤銷上一次檔案改動（write/edit）',
           '  /tools           列出此 pack 的工具',
           '  /memory          顯示跨 session 記憶',
@@ -193,7 +224,14 @@ export function runCli({ pack, model, getApiKey, sandbox = false, resume = null,
     }
   };
 
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: c.blue('› ') });
+  // 斜線指令 tab 補全
+  const SLASH = ['/help', '/goal ', '/sandbox', '/auto', '/plan', '/undo', '/tools', '/memory', '/sessions', '/resume', '/clear', '/exit'];
+  const completer = (line) => {
+    if (!line.startsWith('/')) return [[], line];
+    const hits = SLASH.filter((s) => s.startsWith(line));
+    return [hits.length ? hits : SLASH, line];
+  };
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: c.blue('› '), completer, historySize: 200 });
   let closed = false;
   const cleanup = () => { try { rl.close(); } catch { /* 略 */ } try { onExit?.(); } catch { /* 略 */ } };
   const finish = () => { cleanup(); process.exit(0); };
@@ -201,13 +239,13 @@ export function runCli({ pack, model, getApiKey, sandbox = false, resume = null,
 
   // Ctrl+C：執行中→中斷該輪；閒置→離開
   process.on('SIGINT', () => {
-    if (currentAgent) { currentAgent.abort(); out(c.yellow('\n⏹ 已中斷本輪\n')); }
+    if (currentAgent) { stopSpin(); currentAgent.abort(); out(c.yellow('\n⏹ 已中斷本輪\n')); }
     else { out(c.gray('\n再見。\n')); cleanup(); process.exit(0); }
   });
 
   // 橫幅
   out('\n' + c.cyan('✻ ') + c.bold('xitto-kernel') + c.gray(`  ·  ${pack.name} pack  ·  ${model.id}`) + '\n');
-  out(c.gray(`  沙箱 ${sandboxOn ? '開' : '關'}${seatbeltAvailable() ? '（Seatbelt 可用）' : ''}  ·  /help 看指令  ·  Ctrl+C 中斷/離開`) + '\n');
+  out(c.gray(`  沙箱 ${sandboxOn ? '開' : '關'}${seatbeltAvailable() ? '（Seatbelt 可用）' : ''}  ·  /help · Tab 補全 · ↑↓ 歷史 · Ctrl+C 中斷/離開`) + '\n');
   if (resumedNote) out(c.gray('  ' + resumedNote) + '\n');
   out('\n');
 
@@ -215,21 +253,49 @@ export function runCli({ pack, model, getApiKey, sandbox = false, resume = null,
     if (closed) return finish();
     let q;
     try { q = rl.question.bind(rl); } catch { return finish(); }
-    q(c.blue('› '), async (raw) => {
+    q(modeTag() + c.blue('› '), async (raw) => {
       const input = (raw || '').trim();
       if (!input) return loop();
+      // /goal <目標>：目標驅動自主循環（在此 await，避免與下一個提示交錯）
+      if (input.startsWith('/goal ') || input === '/goal') {
+        const goal = input.slice(5).trim();
+        if (!goal) { out(c.gray('用法 /goal <目標>\n')); return loop(); }
+        try {
+          out(c.cyan('🎯 目標：') + goal + '\n');
+          turnUsage.input = 0; turnUsage.output = 0;
+          const t0 = Date.now();
+          const r = await kernel.runGoal(goal, {
+            history,
+            onRound: ({ round, maxRounds }) => { stopSpin(); out(c.yellow(`\n🔁 第 ${round}/${maxRounds} 輪 `)); startSpin(); },
+            onCheck: ({ done, remaining }) => { stopSpin(); out(done ? c.green('  ✓ 驗收：已達成\n') : c.gray(`  ↻ ${remaining}\n`)); },
+            onEvent, onAgent: (a) => { currentAgent = a; },
+          });
+          stopSpin(); endStream(); history = r.history; persist();
+          out(c.gray(`↳ ${((Date.now() - t0) / 1000).toFixed(1)}s · ${turnUsage.input + turnUsage.output} tokens · ${r.rounds} 輪`) + '\n');
+          const why = r.stalled ? '無進展' : r.aborted ? '中斷' : r.verifyBroken ? '驗收持續失敗' : '到上限';
+          out('\n' + (r.done ? c.green(`✅ 目標達成（${r.rounds} 輪）`) : c.yellow(`⚠ 未達成（${why}，${r.rounds} 輪）`)) + '\n');
+        } catch (err) { endStream(); out(c.red('錯誤：' + err.message) + '\n'); }
+        finally { currentAgent = null; }
+        out('\n'); return loop();
+      }
       if (handleSlash(input)) return loop();
       try {
         const text = planMode
           ? `[計劃模式：只制定計劃，列出你打算做的步驟與會改動的檔案，不要實際寫檔或執行命令]\n\n${input}`
           : input;
+        turnUsage.input = 0; turnUsage.output = 0;
+        const t0 = Date.now();
+        startSpin();
         const r = await kernel.runTurn(text, {
           history, onEvent, onAgent: (a) => { currentAgent = a; },
         });
+        stopSpin();
         endStream();
         history = r.messages;
         persist();                 // 每輪結束自動存檔（可 /resume 續接）
+        out(c.gray(`↳ ${((Date.now() - t0) / 1000).toFixed(1)}s · ${turnUsage.input + turnUsage.output} tokens`) + '\n');
       } catch (err) {
+        stopSpin();
         endStream();
         out(c.red('錯誤：' + err.message) + '\n');
       } finally {

package/src/app/index.js

@@ -1,5 +1,6 @@
 // app 子路徑公開 API（xitto-kernel/app）：外部 agent 專案 import 這些來啟動，不需改 kernel。
 export { runCli } from './cli.js';
+export { createServerApp, startServer } from './server.js';
 export { loadModel, loadProvidersConfig, buildModel } from './providers.js';
 export { newAgent } from './scaffold.js';
 export { main } from './main.js';

package/src/app/main.js

@@ -3,29 +3,38 @@
 import { join } from 'node:path';
 import { loadModel } from './providers.js';
 import { runCli } from './cli.js';
+import { runTui } from './tui-run.js';
 import { newAgent } from './scaffold.js';
+import { createKernel } from '../kernel/index.js';
 import { loadMcpTools } from '../kernel/mcp.js';
 import { createCodingPack } from '../packs/coding/index.js';
 import { createDataQueryPack } from '../packs/data-query/index.js';
 import { createNotesPack } from '../packs/notes/index.js';
+import { createGeneralPack } from '../packs/general/index.js';
+import { createDeepResearchPack } from '../packs/deep-research/index.js';
+import { createDevopsPack } from '../packs/devops/index.js';
 
 const e = (n) => (s) => `\x1b[${n}m${s}\x1b[0m`;
-const green = e(32); const gray = e(90); const red = e(31);
+const green = e(32); const gray = e(90); const red = e(31); const cyan = e(36); const yellow = e(33);
 
 const PACKS = {
   coding: createCodingPack,
   'data-query': createDataQueryPack,
   notes: createNotesPack,
+  general: createGeneralPack,
+  'deep-research': createDeepResearchPack,
+  devops: createDevopsPack,
 };
 
 export async function main(argv = process.argv.slice(2)) {
   // 子指令：new-agent <name> —— 產出獨立 agent 專案（不碰 kernel）
   if (argv[0] === 'new-agent') {
-    const name = argv[1];
+    const name = argv.find((a, i) => i >= 1 && !a.startsWith('--'));
+    const local = argv.includes('--local');
     try {
-      const { target, files } = newAgent(name);
+      const { target, files, dep } = newAgent(name, { local });
       console.log(green(`✓ 已建立獨立 agent 專案：${target}`));
-      console.log(gray(`  ${files.join('  ')}`));
+      console.log(gray(`  ${files.join('  ')}  ·  依賴 xitto-kernel@${dep}`));
       console.log('\n下一步：');
       console.log(gray(`  cd ${name} && npm install && npm start`));
       console.log(gray('  （改 pack.js 換成你的領域；npm update xitto-kernel 升級底座，不固化）'));
@@ -47,6 +56,34 @@ export async function main(argv = process.argv.slice(2)) {
   const cwd = process.cwd();
   const mcp = await loadMcpTools(join(cwd, '.xitto-kernel', opts.pack, 'mcp.json'), (m) => console.log(gray(`  [MCP] ${m}`)));
 
+  // --goal "..."：headless 自主循環（給目標、自己做到完成）後退出，不進互動 CLI
+  if (opts.goal) {
+    const kernel = createKernel(make({ cwd }), {
+      model, getApiKey, extraTools: mcp.tools,
+      sandbox: { enabled: opts.sandbox }, getSandbox: () => opts.sandbox,
+      confirm: opts.yes ? (async () => 'yes') : undefined, // headless：--yes 才自動核准 mutating
+    });
+    console.log(cyan('🎯 目標：') + opts.goal + gray(`  ·  ${opts.pack} pack · ${model.id}`));
+    const res = await kernel.runGoal(opts.goal, {
+      onRound: ({ round, maxRounds }) => console.log(yellow(`\n🔁 第 ${round}/${maxRounds} 輪`)),
+      onCheck: ({ done, remaining }) => console.log(done ? green('  ✓ 驗收：已達成') : gray(`  ↻ 驗收：${remaining}`)),
+      onEvent: (ev) => {
+        if (ev.type === 'tool_execution_start') console.log(yellow(`  ⚙ ${ev.toolName}`) + gray('(' + JSON.stringify(ev.args).slice(0, 80) + ')'));
+        if (ev.type === 'tool_execution_end') console.log(ev.isError ? red('    ⎿ ✗') : gray('    ⎿ ✓'));
+      },
+    });
+    const why = res.stalled ? '無進展停止' : res.aborted ? '中斷' : res.verifyBroken ? '驗收持續失敗' : '到上限';
+    console.log('\n' + (res.done ? green(`✅ 目標達成（${res.rounds} 輪）`) : yellow(`⚠ 未達成（${why}，${res.rounds} 輪）`)));
+    try { await mcp.close(); } catch { /* 略 */ }
+    process.exit(res.done ? 0 : 1);
+  }
+
+  if (opts.tui && process.stdin.isTTY) {
+    runTui({ pack: make({ cwd }), model, getApiKey, sandbox: opts.sandbox, resume: opts.resume });
+    return;
+  }
+  if (opts.tui) console.error(gray('（--tui 需要真實終端，退回一般 CLI）'));
+
   runCli({
     pack: make({ cwd }), model, getApiKey,
     sandbox: opts.sandbox, resume: opts.resume, auto: opts.yes,
@@ -55,7 +92,7 @@ export async function main(argv = process.argv.slice(2)) {
 }
 
 function parse(argv) {
-  const o = { pack: 'coding', model: undefined, sandbox: false, help: false, resume: null, yes: false };
+  const o = { pack: 'coding', model: undefined, sandbox: false, help: false, resume: null, yes: false, goal: null };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === '--help' || a === '-h') o.help = true;
@@ -63,6 +100,8 @@ function parse(argv) {
     else if (a === '--model') o.model = argv[++i];
     else if (a === '--sandbox') o.sandbox = true;
     else if (a === '--yes' || a === '-y') o.yes = true;
+    else if (a === '--tui') o.tui = true;
+    else if (a === '--goal') o.goal = argv[++i];
     else if (a === '--resume') { const nxt = argv[i + 1]; if (nxt && !nxt.startsWith('--')) { o.resume = nxt; i++; } else o.resume = true; }
   }
   return o;
@@ -74,11 +113,16 @@ function printHelp() {
     '',
     '用法:',
     '  xitto-kernel [--pack <name>] [--model <id>] [--sandbox] [--resume [id]] [--yes]   互動跑內建 pack',
+    '  xitto-kernel --pack general --goal "..." [--yes]         目標驅動自主循環（headless）',
     '  xitto-kernel new-agent <name>                            產出依賴 kernel 的獨立 agent 專案',
     '',
-    '  --pack <name>   選擇內建 DomainPack（coding | data-query | notes；預設 coding）',
+    '  --pack <name>   選擇內建 DomainPack（coding | data-query | notes | general | deep-research | devops；預設 coding）',
+    '  --goal "..."    給目標，agent 自主反覆做到完成（建議搭配 --pack general）',
     '  --model <id>    指定 model（預設用 providers.json 的 defaultModel）',
     '  --sandbox       啟動即開啟沙箱（macOS=Seatbelt 真隔離）',
+    '  --tui           完整 Ink TUI（持久狀態列、串流轉錄、Esc 中斷；需真實終端）',
+    '  --resume [id]   接續上次 session（不給 id 接最近一次）',
+    '  --yes, -y       自動核准 mutating 工具（headless / 自主循環常用）',
     '  --help          顯示說明',
     '',
     '需要 ~/.xitto-code/providers.json（與 xitto-code 共用）。',

package/src/app/md-render.js

@@ -0,0 +1,95 @@
+// Markdown → 終端 ANSI 渲染（對標 Claude Code 的回覆排版）
+// 用 marked 解析、marked-terminal 轉 ANSI（標題、粗體、列表、表格、程式碼區塊語法高亮）。
+// Claude Code 的做法：每來一個 token 就把「目前累積的整段 markdown」重新解析重繪，
+// 半截的 **粗體 / 未閉合的 ``` 會在下一幀補齊後自動修正。本檔提供純函式 md()，
+// 重繪由 Ink 的 re-render 負責（見 tui.js）。
+import { Marked } from 'marked';
+import { markedTerminal } from 'marked-terminal';
+import { highlight as hl } from 'cli-highlight';
+
+// 終端寬度（隨視窗；最小 40 避免表格擠壞）
+function termWidth() {
+  const w = process.stdout?.columns || 80;
+  return Math.max(40, Math.min(w, 120));
+}
+
+// ANSI 樣式小工具（marked-terminal 的樣式選項接受 (str)=>str 函式）
+const a = (open, close) => (s) => `\x1b[${open}m${s}\x1b[${close}m`;
+const bold = a(1, 22);
+const cyan = a(36, 39);
+const yellow = a(33, 39);
+const gray = a(90, 39);
+
+// 程式碼區塊本體：語法高亮 + 左側豎線邊框（+ 可選語言標籤）。不含前後空行，方便外部逐塊拼接。
+// withHeader=false 用於「同一個 code block 的延續塊」（串流逐行提交時避免重複 ┌─ lang 標頭）。
+export function codeChunk(text, lang, withHeader = true) {
+  let body;
+  try { body = hl(text, { language: lang || 'plaintext', ignoreIllegals: true }); }
+  catch { body = text; }
+  const bar = gray('│') + ' ';
+  const label = (withHeader && lang) ? gray(`┌─ ${lang}`) + '\n' : '';
+  return label + body.replace(/\n$/, '').split('\n').map((l) => bar + l).join('\n');
+}
+
+// 程式碼區塊（marked renderer 用）：前後補空行與內文隔開
+function codeBlock(text, lang) {
+  return '\n' + codeChunk(text, lang, true) + '\n';
+}
+
+// 依寬度快取 Marked 實例：終端 resize 後寬度改變 → 換一個實例，markdown 自動以新寬度重排。
+// 上限保護：resize 反覆拖動會堆積不同寬度的實例，超過上限即淘汰最舊的(LRU 近似)。
+const cache = new Map();
+const MAX_CACHE = 32;
+function renderer(width) {
+  let m = cache.get(width);
+  if (!m) {
+    m = new Marked();
+    m.use(
+      markedTerminal({
+        width,
+        reflowText: true,
+        tab: 2,
+        showSectionPrefix: false,          // 不顯示標題的 # 記號（對標 Claude Code）
+        firstHeading: (s) => bold(cyan(s)), // 一級標題：粗體青
+        heading: (s) => bold(s),            // 其餘標題：粗體
+        strong: (s) => bold(s),
+        codespan: (s) => yellow(s),
+        blockquote: (s) => gray(s),
+        listitem: (s) => s,
+      }),
+    );
+    // 覆寫 code 渲染：加左側邊框（marked-terminal 內建無邊框）
+    m.use({
+      renderer: {
+        code(token, infostring) {
+          const text = typeof token === 'object' ? token.text : token;
+          const lang = (typeof token === 'object' ? token.lang : infostring) || '';
+          return codeBlock(text, lang);
+        },
+      },
+    });
+    if (cache.size >= MAX_CACHE) cache.delete(cache.keys().next().value); // 淘汰最舊
+    cache.set(width, m);
+  }
+  return m;
+}
+
+// 用 marked 的 block lexer 把 markdown 切成頂層區塊 token（含 .raw，串接即原文）。
+// 串流增量提交用：提交「除最後一塊外」的完整區塊，最後一塊（可能還沒打完）留在動態區。
+const lexMarked = new Marked();
+export function lexBlocks(text) {
+  try { return lexMarked.lexer(text); }
+  catch { return [{ type: 'paragraph', raw: text }]; }
+}
+
+// 把 markdown 字串渲染成帶 ANSI 的終端字串。容錯：解析失敗就回原文。
+export function md(text) {
+  if (!text) return '';
+  try {
+    const out = renderer(termWidth()).parse(text);
+    // 無序列表符號 * → •（marked-terminal 的 BULLET_POINT 寫死為 '* '）
+    return (typeof out === 'string' ? out : String(out)).replace(/\n+$/, '').replace(/^(\s*)\* /gm, '$1• ');
+  } catch {
+    return text;
+  }
+}

package/src/app/scaffold.js

@@ -17,24 +17,32 @@ const FILES = [
   ['gitignore.tmpl', '.gitignore'],
 ];
 
+const kernelVersion = () => {
+  try { return JSON.parse(readFileSync(join(KERNEL_ROOT, 'package.json'), 'utf8')).version || '0.1.0'; }
+  catch { return '0.1.0'; }
+};
+
 /**
  * 產生一個獨立 agent 專案。
  * @param {string} name                    agent 名（字母/數字/連字號）
- * @param {{ dir?: string, kernelPath?: string }} [opts]
- *        dir：產出根目錄（預設 cwd）；kernelPath：寫進 package.json 的 file: 依賴路徑（預設此 kernel）
- * @returns {{ target: string, files: string[] }}
+ * @param {{ dir?: string, local?: boolean, kernelPath?: string }} [opts]
+ *        dir：產出根目錄（預設 cwd）；local：用 file: 依賴本機 kernel（開發用，預設用 npm 正式版本）
+ * @returns {{ target: string, files: string[], dep: string }}
  */
-export function newAgent(name, { dir = process.cwd(), kernelPath = KERNEL_ROOT } = {}) {
+export function newAgent(name, { dir = process.cwd(), local = false, kernelPath = KERNEL_ROOT } = {}) {
   if (!name || !/^[a-z0-9][a-z0-9-]*$/i.test(name)) {
     throw new Error(`agent 名稱不合法：「${name}」（只能用字母/數字/連字號，且不以連字號開頭）`);
   }
   const target = join(dir, name);
   if (existsSync(target)) throw new Error(`目錄已存在：${target}`);
 
+  // 依賴：預設用 npm 正式版本（^x.y.z）；--local 用 file: 指向本機 kernel（開發測試用）
+  const dep = local ? `file:${kernelPath}` : `^${kernelVersion()}`;
+
   mkdirSync(target, { recursive: true });
-  const subst = (s) => s.replaceAll('__NAME__', name).replaceAll('__KERNEL_PATH__', kernelPath);
+  const subst = (s) => s.replaceAll('__NAME__', name).replaceAll('__KERNEL_DEP__', dep);
   for (const [tmpl, outName] of FILES) {
     writeFileSync(join(target, outName), subst(readFileSync(join(TEMPLATES, tmpl), 'utf8')));
   }
-  return { target, files: FILES.map(([, o]) => o) };
+  return { target, files: FILES.map(([, o]) => o), dep };
 }