kenaz 0.3.12 → 0.3.13

package/core/dev/scripts/correction-detect-eval.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+/**
+ * correction-detect-eval.js (TASK_2426) — replays real user prompts from Claude Code
+ * transcripts through the correction detector. Read-only.
+ *   node dev/scripts/correction-detect-eval.js [--transcripts <dir>] [--show 20]
+ * Default dir: ~/.claude/projects/<current project, path separators/colons -> "-">.
+ * Prints prompts scanned, fire rate (target <= 10%) and the first N fired prompts (80 chars).
+ */
+'use strict';
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { isCorrection } = require('../../.claude/hooks/correction-detect');
+
+function arg(name, dflt) {
+  const i = process.argv.indexOf('--' + name);
+  return i > 0 && process.argv[i + 1] ? process.argv[i + 1] : dflt;
+}
+
+function defaultDir() {
+  const slug = path.resolve(process.cwd()).replace(/[^A-Za-z0-9]/g, '-');
+  return path.join(os.homedir(), '.claude', 'projects', slug);
+}
+
+function listJsonl(dir) {
+  const out = [];
+  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+    const p = path.join(dir, e.name);
+    if (e.isDirectory()) out.push(...listJsonl(p));
+    else if (e.name.endsWith('.jsonl')) out.push(p);
+  }
+  return out;
+}
+
+function userText(rec) {
+  if (!rec || rec.type !== 'user' || rec.isMeta || rec.isSidechain) return '';
+  const c = rec.message && rec.message.content;
+  if (typeof c === 'string') return c;
+  if (Array.isArray(c) && !c.some((b) => b && b.type === 'tool_result')) {
+    return c.filter((b) => b && b.type === 'text').map((b) => b.text).join('\n');
+  }
+  return '';
+}
+
+function main() {
+  const dir = arg('transcripts', defaultDir());
+  const show = Number(arg('show', 20));
+  let scanned = 0;
+  const fired = [];
+  for (const file of listJsonl(dir)) {
+    let text;
+    try { text = fs.readFileSync(file, 'utf8'); } catch (_) { continue; }
+    for (const line of text.split('\n')) {
+      if (!line) continue;
+      let rec;
+      try { rec = JSON.parse(line); } catch (_) { continue; }
+      const t = userText(rec).trim();
+      if (!t) continue;
+      scanned++;
+      if (isCorrection(t)) fired.push(t);
+    }
+  }
+  const rate = scanned ? (100 * fired.length / scanned) : 0;
+  console.log('dir: ' + dir);
+  console.log('prompts scanned: ' + scanned);
+  console.log('fired: ' + fired.length + ' (' + rate.toFixed(1) + '%, target <= 10%)');
+  fired.slice(0, show).forEach((p, i) => console.log((i + 1) + '. ' + p.replace(/\s+/g, ' ').slice(0, 80)));
+}
+
+main();

package/core/plugins/kenaz/commands/Ansuz.md

@@ -8,7 +8,8 @@ ARGUMENTS 含 `[專案: X]` 或 `--project-path X` → PROJECT_PATH = X，下方
 ## Boot（一次 Bash，無其他儀式）
 1. Turn Context 若有 `[session] session_id=<id>`，記住 `<id>`。
 2. 執行 `node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .specialist/tools/ansuz-boot-fast.js`（有 `<id>` 加 `--conversation-id="<id>"`；有 PROJECT_PATH 加 `--project-path`）。
-3. 把 banner 轉述給用戶（Bash 輸出在 UI 會摺疊），並依 `📋 Open cards` 直接提出議程。
+3. banner 有 `📎 Project handoff` 時，**先用 Read 讀 → 標記的那份全文**（不用問用戶），以它為準接續上一個 session。
+4. 把 banner 轉述給用戶（Bash 輸出在 UI 會摺疊），依 handoff 的 R 段與 `📋 Open cards` 直接提出議程。
 
 ## 每件工作的做法
 - **自己做**：小而明確的修正（約 30 行內、單一檔案或少數檔案）→ 直接改，跑最近的測試，提交。
@@ -16,6 +17,7 @@ ARGUMENTS 含 `[專案: X]` 或 `--project-path X` → PROJECT_PATH = X，下方
   1. 用 `kenaz_task_create` 開卡（`projectPath` = 目前專案；寫清楚 requirements、acceptance criteria、scope paths）。查卡、改狀態用 `kenaz_task_list` / `kenaz_task_get` / `kenaz_task_update`。
   2. 產生派工內容：`node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .formation/tools/dispatch.js --skill=do --task=TASK_XXX --dispatch-mode=subagent`（有 PROJECT_PATH 加 `--project-path`）。把輸出 JSON 的 `promptText` 交給 subagent，`agentParams` 照用（模型不要自己換）。
   3. subagent 在 worktree 裡改完並 commit；你驗證後合併。
+     若輸出是 `executor` 區塊（模型為 `codex:<id>` / `deepseek:<model>`，無 agentParams）：用 Bash run_in_background 執行 `executor.command`，等完成通知，讀 `executor.resultFile`（ok、commits；`no commits` = 失敗），再照常驗證並合併 `executor.branchName`。
 - 開卡前先確認 scope 與驗收條件對準真正的問題，不要照著錯的假設派工。
 
 ## 驗證（合併前一定做，強度跟風險相稱）
@@ -24,6 +26,12 @@ ARGUMENTS 含 `[專案: X]` 或 `--project-path X` → PROJECT_PATH = X，下方
 - subagent 回報「未驗證」的項目，由你補驗或明講仍未驗證。
 - 合併：`git merge` 後跑相關測試（或 `node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .specialist/Ansuz/tools/verify-and-land.js`），用這個專案自己的測試指令。
 
+## 交接（handoff，ISBAR）
+用戶說交接／暫停／換 session、context 快滿、或結束時仍有未完成的工作 → 寫交接：
+1. `node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .specialist/tools/handoff-doc.js new --topic "<主題>" --session <id>`（有 PROJECT_PATH 加 `--project-path`），建立 `<專案>/.kenaz/handoffs/<日期時間>-<主題>.md`，I 段已自動填好。
+2. 用 Edit 填 S（現況）、B（背景：用戶決定原話、相關卡與 commit）、A（已驗證／未驗證／風險）、R（下一個 session 第一步、待用戶決定的事）。寫給「沒看過這段對話的人」，不寫空泛句。
+3. 一份交接一個檔，不覆寫舊的；下一個 session 的 boot 會自動列出並讀最新那份。
+
 ## 回報與提問
 - 一律用用戶的語言（中文訊息 → 中文回覆，含提問選項）。
 - 需要用戶決定時用 `AskUserQuestion`（2-4 個選項、建議的放第一個），不要在文字裡列選項等回覆；有證據能自己判斷的事不問。
@@ -38,5 +46,7 @@ Kenaz 的工具、hook、安裝、peer、派工擋住或拖慢工作時，**繞
 ## 參考產品（REA）與學習教訓
 - banner `[rea]` 行：用戶提到參考產品時，有 REA 就提議分析，沒有就提示一次 `npx rea-agents setup`（範圍見 RULES.md 的 REA）。
 - 用戶糾正/重複指示、推翻決定、或驗證抓到失敗時，自動寫教訓並在回報點名一行：`node "${CLAUDE_PLUGIN_ROOT}/hooks/core-resolve.js" .specialist/tools/lessons.js add --scope user|project --type pref|fact|pitfall|check --text "..."`（規則見 RULES.md 的 Lessons）。
+- banner 出現 `[lessons] N to graduate`：跑 `kenaz learn review`，提議把排第一的教訓改成代碼（測試、hook 檢查或專案 CLAUDE.md/AGENTS.md 規則，這是首選結果）；糾正若與既有教訓相符屬於重複（recurrence），不是新教訓（`add` 會自動累加）。
+- banner 出現 `[learn] N history items to review`：跑 `kenaz learn review`，每個歷史項目（返工、executor 失敗、blocked 卡、handoff 風險行）有現成的 `kenaz learn add ... --source harvest:<id>`，值得記的補上 why 後執行，其餘忽略；指標建議（各 rigor 一次過率、返工最多的檔案）只建議給用戶，不自行套用。詳見 RULES.md。
 
 需要更多規則時（授權自主、派工前、合併前、參考產品、寫教訓）讀 `${CLAUDE_PLUGIN_ROOT}/../../.specialist/Ansuz/RULES.md`。

package/core/plugins/kenaz/commands/kenaz.md

@@ -1,12 +1,14 @@
 ---
-description: Switch or show the Kenaz mode (off | assist | full | status | init), or set up Yggdrasil (ygg join|status|leave)
-argument-hint: off|assist|full|status|init|ygg
+description: Switch or show the Kenaz mode (off | assist | full | status | init), set up Yggdrasil (ygg join|status|leave), or show/set the subagent model (subagent [set <id>|unset] [--rigor r])
+argument-hint: off|assist|full|status|init|ygg|subagent
 allowed-tools: Bash(node:*)
 ---
-Run exactly this and report its output (one line for modes; the full block for `ygg`), nothing else:
+Run exactly this and report its output (one line for modes; the full block for `ygg` and `subagent`), nothing else:
 
 `node "${CLAUDE_PLUGIN_ROOT}/scripts/kenaz-mode.js" $ARGUMENTS`
 
 Modes: full = guidance + all hooks; assist = silent telemetry/bookkeeping hooks only (no context injection); off = every Kenaz hook exits immediately. init creates .kenaz/project.yaml so hooks act in a fresh project.
 
 `ygg join <key> [--project|--global]` stores the Yggdrasil connection key (default: this project's own slot) and activates collaboration here; `ygg status` shows room, node, relay, peers and mail (key masked); `ygg leave` removes this project's key. Needs kenaz-server running (installed by `npx kenaz install`).
+
+`subagent` shows the subagent (dispatch) model per rigor for this project; `subagent set <id> [--rigor low|medium|high]` changes it, `subagent unset [--rigor r]` reverts (writes .kenaz/dashboard-models.json). Ansuz itself runs on this session's model (/model).

package/core/plugins/kenaz/scripts/kenaz-mode.js

@@ -10,6 +10,12 @@ if (arg === 'ygg') {
   const r = require('child_process').spawnSync(process.execPath, [path.join(__dirname, 'ygg.js'), ...process.argv.slice(3)], { stdio: 'inherit' });
   process.exit(r.status === null ? 1 : r.status);
 }
+if (arg === 'subagent' || arg === 'model') {
+  // Subagent (dispatch) model: subagent [set <id>|unset] [--rigor r]; same as `kenaz subagent`, for this project
+  const tool = path.join(__dirname, '..', '..', '..', '.formation', 'tools', 'dispatch-model.js');
+  const r = require('child_process').spawnSync(process.execPath, [tool, ...process.argv.slice(3), '--project-path', projectDir()], { stdio: 'inherit' });
+  process.exit(r.status === null ? 1 : r.status);
+}
 const dir = projectDir();
 if (MODES.includes(arg)) {
   setMode(arg, dir);

package/core/plugins/kenaz/scripts/statusline.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+'use strict';
+// Claude Code status line: task counts of the Kenaz project around the session's cwd.
+//   ᚨ KenazAI · ▶ 1 進行中 · ☐ 12 待辦 · ⛔ 2 卡住 · ◎ 3 池      (zero counts left out)
+//   ᚨ KenazAI · 無待辦任務
+// Prints nothing outside a Kenaz project. Reads files only (no HTTP): Claude Code runs it on every refresh.
+// Registered in ~/.claude/settings.json `statusLine` by the installer only when the user has none.
+const fs = require('fs');
+const path = require('path');
+
+const STATES = [['active', '▶', '進行中'], ['backlog', '☐', '待辦'], ['blocked', '⛔', '卡住'], ['pool', '◎', '池']];
+
+function projectRoot(start) {
+  let d = path.resolve(start);
+  for (;;) {
+    if (fs.existsSync(path.join(d, '.kenaz', 'project.yaml'))) return d;
+    const up = path.dirname(d);
+    if (up === d) return null;
+    d = up;
+  }
+}
+
+function tasksDir(root) {
+  const k = path.join(root, '.kenaz', 'tasks');
+  return fs.existsSync(k) ? k : path.join(root, '.collaboration', 'tasks');
+}
+
+function count(dir) {
+  try { return fs.readdirSync(dir).filter((f) => /\.ya?ml$/.test(f)).length; } catch { return 0; }
+}
+
+function projectName(root) {
+  try {
+    const m = fs.readFileSync(path.join(root, '.kenaz', 'project.yaml'), 'utf8').match(/^name:\s*(.+)$/m);
+    if (m) { const n = m[1].trim().replace(/^(['"])(.*)\1$/, '$2'); if (n) return n; }
+  } catch { /* fall back to the folder name */ }
+  return path.basename(root);
+}
+
+function render(cwd) {
+  const root = projectRoot(cwd);
+  if (!root) return '';
+  const dir = tasksDir(root);
+  const parts = STATES.map(([s, icon, label]) => [count(path.join(dir, s)), icon, label]).filter(([n]) => n > 0)
+    .map(([n, icon, label]) => icon + ' ' + n + ' ' + label);
+  return 'ᚨ ' + projectName(root) + ' · ' + (parts.length ? parts.join(' · ') : '無待辦任務');
+}
+
+function cwdFromInput(raw) {
+  try { const j = JSON.parse(raw); return (j.workspace && j.workspace.current_dir) || j.cwd || null; } catch { return null; }
+}
+
+if (require.main === module) {
+  let raw = '';
+  const done = () => { try { process.stdout.write(render(cwdFromInput(raw) || process.cwd())); } catch { /* never break the status bar */ } };
+  if (process.stdin.isTTY) done();
+  else { process.stdin.setEncoding('utf8'); process.stdin.on('data', (c) => { raw += c; }); process.stdin.on('end', done); }
+}
+
+module.exports = { render, projectRoot, cwdFromInput };

package/core/plugins/kenaz/scripts/statusline.test.js

@@ -0,0 +1,41 @@
+// Status line task counts (statusline.js). Temp project dirs only.
+const test = require('node:test');
+const assert = require('node:assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { execFileSync } = require('child_process');
+const { render, cwdFromInput } = require('./statusline');
+
+function project(counts, name) {
+  const p = fs.mkdtempSync(path.join(os.tmpdir(), 'kenaz-sl-'));
+  fs.mkdirSync(path.join(p, '.kenaz'), { recursive: true });
+  fs.writeFileSync(path.join(p, '.kenaz', 'project.yaml'), name ? 'name: "' + name + '"\n' : 'id: x\n');
+  for (const [s, n] of Object.entries(counts)) {
+    fs.mkdirSync(path.join(p, '.kenaz', 'tasks', s), { recursive: true });
+    for (let i = 0; i < n; i++) fs.writeFileSync(path.join(p, '.kenaz', 'tasks', s, 'TASK_' + i + '.yaml'), 'id: TASK_' + i + '\n');
+  }
+  return p;
+}
+
+test('counts per state, zero states left out, from a subfolder of the project', () => {
+  const p = project({ active: 1, backlog: 12, blocked: 0, pool: 3, done: 40 }, 'Demo');
+  fs.mkdirSync(path.join(p, 'src', 'deep'), { recursive: true });
+  assert.strictEqual(render(path.join(p, 'src', 'deep')), 'ᚨ Demo · ▶ 1 進行中 · ☐ 12 待辦 · ◎ 3 池');
+});
+
+test('no open tasks, folder name when project.yaml has no name', () => {
+  const p = project({ done: 5 });
+  assert.strictEqual(render(p), 'ᚨ ' + path.basename(p) + ' · 無待辦任務');
+});
+
+test('control: outside a Kenaz project prints nothing', () => {
+  assert.strictEqual(render(fs.mkdtempSync(path.join(os.tmpdir(), 'kenaz-sl-none-'))), '');
+});
+
+test('reads the cwd from the Claude Code stdin JSON (real process)', () => {
+  const p = project({ blocked: 2 }, 'Piped');
+  assert.strictEqual(cwdFromInput(JSON.stringify({ workspace: { current_dir: p } })), p);
+  const out = execFileSync(process.execPath, [path.join(__dirname, 'statusline.js')], { input: JSON.stringify({ workspace: { current_dir: p }, cwd: os.tmpdir() }), encoding: 'utf8' });
+  assert.strictEqual(out, 'ᚨ Piped · ⛔ 2 卡住');
+});

package/lib/cli.js

@@ -14,7 +14,7 @@ const dash = require('./dashboard');
 const PKG_ROOT = path.resolve(__dirname, '..');
 const PKG = require('../package.json');
 const MIN_NODE = 18;
-const USAGE = 'usage: kenaz <install|uninstall|status|doctor|init|ygg join <key>|ygg create [--name N]|ygg status|ygg leave|alaya status|alaya register|model [set <id>|unset] [--rigor r]|stats [--days N] [--json]|learn <add|list|rm>> [--dry-run] [--home <dir>] [--no-service] [--no-claude] [--no-codex] [--keep-dashboard] [--server-bin <path>]';
+const USAGE = 'usage: kenaz <install|uninstall|status|doctor|init|ygg join <key>|ygg create [--name N]|ygg status|ygg leave|alaya status|alaya register|subagent [set <id>|unset] [--rigor r]|launch --provider deepseek [--model id]|stats [--days N] [--json]|learn <add|list|rm|review|merge|graduate>> [--dry-run] [--home <dir>] [--no-service] [--no-claude] [--no-codex] [--keep-dashboard] [--server-bin <path>]';
 
 function parseArgs(argv) {
   const o = { cmd: argv[0], flags: {} };
@@ -43,6 +43,7 @@ function coreModule(p, ...rel) {
 const reaDetect = (p) => coreModule(p, '.specialist', 'tools', 'rea-detect.js');
 const lessons = (p) => coreModule(p, '.specialist', 'tools', 'lessons.js');
 const dispatchModel = (p) => coreModule(p, '.formation', 'tools', 'dispatch-model.js');
+const providerLaunch = (p) => coreModule(p, '.formation', 'bifrost', 'provider-launch.js');
 const kenazStats = (p) => coreModule(p, '.formation', 'tools', 'kenaz-stats.js');
 
 function paths(home) {
@@ -284,7 +285,7 @@ async function doctor(p, flags, out, deps = {}) {
   if (dm) {
     const d = dm.describe(process.cwd());
     const uniq = [...new Set(d.rows.map((r) => r.model))];
-    add('dispatch model', 'ok', (uniq.length === 1 ? uniq[0] : d.rows.map((r) => `${r.rigor}=${r.model}`).join(' ')) + (d.file ? '' : ' (built-in default)') + '; change with `kenaz model set <id>`');
+    add('dispatch model', 'ok', (uniq.length === 1 ? uniq[0] : d.rows.map((r) => `${r.rigor}=${r.model}`).join(' ')) + (d.file ? '' : ' (built-in default)') + '; change with `kenaz subagent set <id>`');
   }
   // Optional and user-installed: never a failure.
   const rea = reaDetect(p);
@@ -340,18 +341,24 @@ async function alaya(argv, out = console.log) {
 
 function run(argv, out = console.log, deps = {}) {
   if (argv[0] === 'alaya') return alaya(argv, out);
-  if (argv[0] === 'model') {
+  if (argv[0] === 'subagent' || argv[0] === 'model') { // model: pre-0.3.13 name
     const dm = dispatchModel(paths(os.homedir()));
     if (!dm) { out('kenaz-core not installed: run `kenaz install`'); return 1; }
     return dm.main(argv.slice(1), out);
   }
+  if (argv[0] === 'launch') {
+    const pl = providerLaunch(paths(os.homedir()));
+    if (!pl) { out('kenaz-core not installed: run `kenaz install`'); return 1; }
+    return pl.main(argv.slice(1), out, deps);
+  }
   if (argv[0] === 'stats') {
     const ks = kenazStats(paths(os.homedir()));
     if (!ks) { out('kenaz-core not installed: run `kenaz install`'); return 1; }
     return ks.main(argv.slice(1), out);
   }
   if (argv[0] === 'learn') {
-    const lm = lessons(paths(os.homedir()));
+    const hi = argv.indexOf('--home');
+    const lm = lessons(paths(hi >= 0 && argv[hi + 1] ? path.resolve(argv[hi + 1]) : os.homedir()));
     if (!lm) { out('kenaz-core not installed: run `kenaz install`'); return 1; }
     return lm.main(argv.slice(1), out);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenaz",
-  "version": "0.3.12",
+  "version": "0.3.13",
   "description": "Install Kenaz (plugin, hooks, kenaz-server) for Claude Code and Codex: npx kenaz install",
   "bin": {
     "kenaz": "bin/kenaz.js"
@@ -20,11 +20,11 @@
     "test": "node --test lib/cli.test.js"
   },
   "optionalDependencies": {
-    "@kenazai/server-darwin-arm64": "0.3.12",
-    "@kenazai/server-darwin-x64": "0.3.12",
-    "@kenazai/server-linux-arm64": "0.3.12",
-    "@kenazai/server-linux-x64": "0.3.12",
-    "@kenazai/server-win32-x64": "0.3.12"
+    "@kenazai/server-darwin-arm64": "0.3.13",
+    "@kenazai/server-darwin-x64": "0.3.13",
+    "@kenazai/server-linux-arm64": "0.3.13",
+    "@kenazai/server-linux-x64": "0.3.13",
+    "@kenazai/server-win32-x64": "0.3.13"
   },
   "license": "UNLICENSED",
   "repository": {

package/vendor/install-kenaz-cli.js

@@ -86,6 +86,29 @@ function unregisterPlugin(file, dir, dry) {
   return 'removed';
 }
 
+// Status line with the project's task counts (plugins/kenaz/scripts/statusline.js). Set only when the user has no
+// statusLine; a user's own is never replaced. Ours is recognised by the script path, so a moved core is updated.
+const STATUSLINE_TAIL = 'plugins/kenaz/scripts/statusline.js';
+const isOurStatusline = (s) => !!(s && typeof s.command === 'string' && norm(s.command).includes(STATUSLINE_TAIL));
+/** @returns 'added'|'already'|'replaced'|'kept-user' */
+function registerStatusline(file, core, dry) {
+  const v = loadSettings(file);
+  const command = 'node "' + path.join(core, ...STATUSLINE_TAIL.split('/')) + '"';
+  if (v.statusLine && !isOurStatusline(v.statusLine)) return 'kept-user';
+  if (v.statusLine && norm(v.statusLine.command) === norm(command)) return 'already';
+  const r = v.statusLine ? 'replaced' : 'added';
+  if (!dry) { v.statusLine = { type: 'command', command }; saveSettings(file, v); }
+  return r;
+}
+/** @returns 'removed'|'absent' */
+function unregisterStatusline(file, dry) {
+  if (!fs.existsSync(file)) return 'absent';
+  const v = loadSettings(file);
+  if (!isOurStatusline(v.statusLine)) return 'absent';
+  if (!dry) { delete v.statusLine; saveSettings(file, v); }
+  return 'removed';
+}
+
 // TASK_2384: Dashboard-era user-level hooks (wrapped by .claude/hooks/_user-scope.js, direct .claude/hooks/*.js, or the
 // agent-flow curl/node posts) duplicate what plugins/kenaz/hooks/hooks.json now runs. Single owner = the plugin, so
 // once it is registered these are removed (first write backs up the pristine file to settings.json.bak-kenaz-peer).
@@ -389,6 +412,7 @@ function main(argv, out = console.log, getVersion = claudeVersion, deps = {}) {
           out(name + ': ' + (list.some((e) => norm(e) === norm(pluginDir)) ? 'registered' : 'not registered') + ' (' + pluginDir + ')');
         } else if (cmd === 'uninstall') {
           log(name + ': ' + unregisterPlugin(settings, pluginDir, dry) + ' (' + settings + ')');
+          if (name === 'kenaz') log('statusline: ' + unregisterStatusline(settings, dry));
         } else if (process.env.KENAZ_SKIP_CLAUDE_PROVISION === '1') {
           log(name + ': skipped (KENAZ_SKIP_CLAUDE_PROVISION=1)');
         } else if (!fs.existsSync(path.join(pluginDir, 'hooks', 'hooks.json'))) {
@@ -400,6 +424,8 @@ function main(argv, out = console.log, getVersion = claudeVersion, deps = {}) {
           else {
             log(name + ': ' + registerPlugin(settings, pluginDir, dry) + ' (' + settings + ')');
             if (name === 'kenaz') {
+              const sl = registerStatusline(settings, core, dry);
+              log('statusline: ' + (sl === 'kept-user' ? 'kept your own statusLine; to show Kenaz task counts, append the output of: node "' + path.join(core, ...STATUSLINE_TAIL.split('/')) + '"' : sl));
               const n = retireDashboardHooks(settings, dry);
               if (n) log('kenaz: retired ' + n + ' Dashboard-era user-level hook(s), now owned by the plugin (backup: ' + path.join(path.dirname(settings), BACKUP) + ')');
             }
@@ -427,4 +453,4 @@ function main(argv, out = console.log, getVersion = claudeVersion, deps = {}) {
 }
 
 if (require.main === module) process.exit(main(process.argv.slice(2)));
-module.exports = { main, verifyRuntime, healthOnce, serviceInstall, serviceRestart, restartHint, claudeVersion, loadSettings, entriesOf, norm, MIN_CLI, registerPlugin, unregisterPlugin, retireDashboardHooks, servicePlan, detectServiceMode, probeLinux, cronLine, CRON_MARK, winVbs, launchdPlist, systemdUnit, parseVersion, cmpVersion };
+module.exports = { main, verifyRuntime, healthOnce, serviceInstall, serviceRestart, restartHint, claudeVersion, loadSettings, entriesOf, norm, MIN_CLI, registerPlugin, unregisterPlugin, registerStatusline, unregisterStatusline, retireDashboardHooks, servicePlan, detectServiceMode, probeLinux, cronLine, CRON_MARK, winVbs, launchdPlist, systemdUnit, parseVersion, cmpVersion };