kenaz 0.3.11 → 0.3.13

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

@@ -122,3 +122,71 @@ test('ygg join activates the room in collaboration_projects; status explains how
   const { buildStatus, renderStatus } = require('./ygg.js');
   assert.match(renderStatus(buildStatus(cfg, { connected: false, nodes: [] }, null)), /not active in this project - run "ygg join <key>"/);
 });
+
+// TASK_2416: `ygg create` posts to the relay (config relay_url), then joins with the returned key.
+// One local stub plays both the Kenaz backend and the relay; nothing touches ~/.kenaz or ~/.claude.
+async function withStub(relayReply, fn) {
+  const http = require('http');
+  const seen = { relay: [], config: [] };
+  const cfg = { enabled: false, effective_project_key: 'tmp-room', node_name: 'n', publishable_key: '', collaboration_projects: [], relay_url: '' };
+  const srv = http.createServer((req, res) => {
+    let b = ''; req.on('data', (d) => { b += d; });
+    req.on('end', () => {
+      res.setHeader('content-type', 'application/json');
+      if (req.url === '/api/v1/teams') {
+        seen.relay.push({ method: req.method, body: b });
+        res.statusCode = relayReply.status; return res.end(JSON.stringify(relayReply.body));
+      }
+      if (req.url.startsWith('/api/nodes')) return res.end('[]');
+      if (req.url.startsWith('/api/yggdrasil/config')) {
+        if (req.method === 'POST') { seen.config.push(JSON.parse(b)); return res.end(JSON.stringify({ ok: true })); }
+        return res.end(JSON.stringify(cfg));
+      }
+      res.end(JSON.stringify({ success: true, created: false }));
+    });
+  });
+  await new Promise((r) => srv.listen(0, '127.0.0.1', r));
+  cfg.relay_url = 'ws://127.0.0.1:' + srv.address().port;
+  const prev = process.env.KENAZ_HTTP_PORT;
+  process.env.KENAZ_HTTP_PORT = String(srv.address().port);
+  try { return await fn(seen, cfg); } finally {
+    if (prev === undefined) delete process.env.KENAZ_HTTP_PORT; else process.env.KENAZ_HTTP_PORT = prev;
+    srv.close();
+  }
+}
+
+test('ygg create posts the name to the relay, joins with the new key, prints it once (TASK_2416)', async () => {
+  const KEY = 'ygk_' + '2'.repeat(32);
+  await withStub({ status: 201, body: { ok: true, team_id: 't1', team_name: 'Acme', key: KEY, max_nodes: 10 } }, async (seen) => {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ygg-create-'));
+    const { createTeam, renderStatus } = require('./ygg.js');
+    const s = await createTeam(dir, 'Acme', 'project');
+    assert.deepStrictEqual(JSON.parse(seen.relay[0].body), { name: 'Acme' });
+    assert.strictEqual(seen.config[0].publishable_key, KEY);
+    assert.strictEqual(seen.config[0].enabled, true);
+    assert.deepStrictEqual(seen.config[0].collaboration_projects, ['tmp-room']);
+    const out = renderStatus(s);
+    assert.match(out, new RegExp('share with teammates: kenaz ygg join ' + KEY));
+    assert.ok(!out.includes('Key:              ' + KEY), 'status line keeps the key masked');
+  });
+});
+
+test('ygg create explains 429, 503, missing relay_url and unreachable relay (TASK_2416)', async () => {
+  const { createTeam } = require('./ygg.js');
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ygg-create-err-'));
+  await withStub({ status: 429, body: { ok: false, error: 'Too many team creations (limit 3 per hour)' } }, async (seen) => {
+    await assert.rejects(createTeam(dir, '', 'project'), /rate limited by the relay: Too many team creations/);
+    assert.strictEqual(seen.config.length, 0, 'no join after a failed create');
+  });
+  await withStub({ status: 503, body: { ok: false, error: 'REGISTRY_SERVICE_KEY not configured' } }, async () => {
+    await assert.rejects(createTeam(dir, '', 'project'), /does not offer self-serve keys: REGISTRY_SERVICE_KEY/);
+  });
+  await withStub({ status: 201, body: {} }, async (seen, cfg) => {
+    cfg.relay_url = '';
+    await assert.rejects(createTeam(dir, '', 'project'), /no relay_url configured/);
+  });
+  await withStub({ status: 201, body: {} }, async (seen, cfg) => {
+    cfg.relay_url = 'ws://127.0.0.1:1'; // nothing listens
+    await assert.rejects(createTeam(dir, '', 'project'), /cannot reach the relay at http:\/\/127\.0\.0\.1:1/);
+  });
+});

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/core/plugins/kenaz/scripts/ygg.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 'use strict';
-// node ygg.js <join <key> [--project|--global] | status | leave> [--project-path <dir>] [--json]
+// node ygg.js <join <key> [--project|--global] | create [--name N] [--project|--global] | status | leave> [--project-path <dir>] [--json]
 // Yggdrasil setup without the Dashboard (TASK_2366). Thin client over the Rust backend's
 // /api/yggdrasil/config + /api/peer/status (same per-project/global key rules as the Dashboard,
 // TASK_2321/2349). k-cli `ygg` shells out to this file - the one implementation.
@@ -98,6 +98,10 @@ function renderStatus(s) {
     'Delivery:         ' + s.delivery_mode + (s.sessions.length ? '' : ' (no live sessions)'),
   ];
   for (const x of s.sessions) L.push('  - ' + x.agent + ' ' + String(x.session_id).slice(0, 8) + ': ' + x.delivery_mode);
+  if (s.created) {
+    L.push('', 'New team key (shown once, save it): ' + s.created.key + (s.created.team_name ? '  [' + s.created.team_name + ']' : ''));
+    L.push('share with teammates: kenaz ygg join ' + s.created.key);
+  }
   if (s.room_warning) L.push('WARNING:          ' + s.room_warning);
   if (s.delivery_note) L.push('Note:             ' + s.delivery_note);
   return L.join('\n');
@@ -143,6 +147,38 @@ async function join(dir, key, scope) {
   return status(dir);
 }
 
+// TASK_2416: self-serve room key. POST <relay>/api/v1/teams (anonymous, per-IP limited), then join
+// with the new key so this node is in the room immediately. The full key is returned once.
+async function createTeam(dir, name, scope) {
+  const cfg = await getConfig(dir);
+  if (cfg.error) throw new Error(cfg.error);
+  const base = relayHttpBase(cfg.relay_url);
+  if (!base) throw new Error('no relay_url configured - cannot reach the relay to create a key (run "npx kenaz@latest install" or set relay_url in .kenaz/yggdrasil.yaml)');
+  let res;
+  try {
+    res = await fetch(base + '/api/v1/teams', {
+      method: 'POST', headers: { 'content-type': 'application/json' },
+      body: JSON.stringify(name ? { name } : {}), signal: AbortSignal.timeout(15000),
+    });
+  } catch (e) {
+    throw new Error('cannot reach the relay at ' + base + ' (' + (e.cause && e.cause.code || e.message) + '); check your network and try again');
+  }
+  let data = null;
+  try { data = await res.json(); } catch (e) { /* non-JSON body */ }
+  if (!res.ok || !data || !data.key) {
+    const why = data && data.error ? data.error : 'HTTP ' + res.status;
+    if (res.status === 429) throw new Error('rate limited by the relay: ' + why);
+    if (res.status === 503) throw new Error('this relay does not offer self-serve keys: ' + why);
+    throw new Error('relay refused to create a key (HTTP ' + res.status + '): ' + why);
+  }
+  let s;
+  try { s = await join(dir, data.key, scope); } catch (e) {
+    // The key exists on the relay now; never lose it because the local join failed.
+    throw new Error('key created (' + data.key + ') but joining failed: ' + e.message + ' - retry with: kenaz ygg join ' + data.key);
+  }
+  return Object.assign(s, { created: { key: data.key, team_name: data.team_name || name || '' } });
+}
+
 async function leave(dir) {
   const cfg = await getConfig(dir);
   await postConfig(dir, postBody(cfg, { key_scope: 'clear_project', collaboration_projects: withCollab(cfg, false) }));
@@ -150,7 +186,7 @@ async function leave(dir) {
 }
 
 async function main(argv) {
-  const rest = []; let dir = process.env.CLAUDE_PROJECT_DIR || process.cwd(); let scope = 'project'; let json = false;
+  const rest = []; let dir = process.env.CLAUDE_PROJECT_DIR || process.cwd(); let scope = 'project'; let json = false; let name = '';
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === '--project-path' && argv[i + 1]) dir = argv[++i];
@@ -158,6 +194,8 @@ async function main(argv) {
     else if (a === '--global') scope = 'global';
     else if (a === '--project') scope = 'project';
     else if (a === '--json') json = true;
+    else if (a === '--name' && argv[i + 1]) name = argv[++i];
+    else if (a.startsWith('--name=')) name = a.slice(7);
     else rest.push(a);
   }
   dir = path.resolve(dir);
@@ -165,9 +203,10 @@ async function main(argv) {
   let s;
   try {
     if (sub === 'join') s = await join(dir, rest[1], scope);
+    else if (sub === 'create') s = await createTeam(dir, name, scope);
     else if (sub === 'leave') s = await leave(dir);
     else if (sub === 'status') s = await status(dir);
-    else throw new Error('unknown ygg subcommand: ' + sub + ' (join <key> | status | leave)');
+    else throw new Error('unknown ygg subcommand: ' + sub + ' (join <key> | create [--name N] | status | leave)');
   } catch (e) {
     console.error('ygg: ' + e.message + (/fetch failed|timeout|abort/i.test(e.message) ? ' (is the Kenaz backend running on ' + BASE() + '?)' : ''));
     process.exit(1);
@@ -175,5 +214,5 @@ async function main(argv) {
   console.log(json ? JSON.stringify(s, null, 2) : renderStatus(s));
 }
 
-module.exports = { nodeIsOnline, maskKey, buildStatus, renderStatus, join };
+module.exports = { nodeIsOnline, maskKey, buildStatus, renderStatus, join, createTeam };
 if (require.main === module) main(process.argv.slice(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 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) {
@@ -114,7 +115,7 @@ function retryBusy(fn, tries = 10) {
   }
 }
 
-function install(p, flags, out, deps = {}) {
+async function install(p, flags, out, deps = {}) {
   const dry = !!flags['dry-run'];
   const tag = dry ? '[dry-run] ' : '';
   const log = (m) => out(tag + m);
@@ -167,7 +168,10 @@ function install(p, flags, out, deps = {}) {
     if (flags['no-service']) a.push('--no-service');
     if (dry) a.push('--dry-run');
     const ver = hasClaude ? inst.claudeVersion() : null;
-    if (inst.main(a, out, () => ver) !== 0) rc = 1;
+    let plan = null;
+    if (inst.main(a, out, () => ver, { sh: deps.sh, platform: deps.platform, uid: deps.uid, onPlan: (x) => { plan = x; } }) !== 0) rc = 1;
+    // TASK_2418: the service was (re)started above; confirm the running server is the one just installed.
+    if (!dry && plan && srv && !flags['no-service']) await inst.verifyRuntime(plan, srv.version, out, deps.verify);
   }
   if (dry && hasClaude) out(`[dry-run] note: plugin paths above are the packaged core; after install they live under ${path.join(p.core, 'plugins')}`);
 
@@ -235,6 +239,10 @@ async function doctor(p, flags, out, deps = {}) {
   let ver = ''; try { ver = JSON.parse(r.body).version; } catch (_) { /* health body is optional */ }
   add('server reachable', r.ok ? 'ok' : 'FAIL', r.detail + (ver ? `, version ${ver}` : ''));
 
+  try { // TASK_2413: which mechanism restarts the server after a reboot (read-only; `deps.sh` / `deps.platform` for tests)
+    const sm = installer().detectServiceMode(p.home, p.core, deps.sh, deps.platform);
+    add('service mode', sm.mode === 'manual' ? 'skip' : 'ok', sm.mode + ' (' + sm.detail + ')');
+  } catch (e) { add('service mode', 'skip', 'unknown: ' + e.message); }
   const d = dash.detect(p.home, deps.dashboard);
   if (!d.installed) add('dashboard', 'skip', 'no Kenaz Dashboard on this machine');
   else {
@@ -277,20 +285,20 @@ 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);
   if (rea) {
     const r = rea.detectRea({ home: p.home, projectPath: process.cwd() });
     add('rea (optional)', r.installed ? 'ok' : 'skip', r.installed ? 'MCP registered in ' + [r.claude && 'claude', r.codex && 'codex'].filter(Boolean).join(', ')
-      : `not installed; \`${rea.SETUP_CMD}\` lets Ansuz analyse reference products` + (r.nodeOk ? '' : ` (needs Node >=22.19, found ${process.versions.node})`));
+      : `not installed; \`${r.setupCmd || rea.SETUP_CMD}\` lets Ansuz analyse reference products` + (r.nodeOk ? '' : ` (needs Node >=22.19, found ${process.versions.node})`));
   }
   for (const [l, s, d] of rows) out(`${s.padEnd(4)}  ${l.padEnd(20)} ${d}`);
   return rows.some((r) => r[1] === 'FAIL') ? 1 : 0;
 }
 
-// `kenaz ygg join|status|leave ...` and `kenaz init`: short forms of the same core scripts the
+// `kenaz ygg join|create|status|leave ...` and `kenaz init`: short forms of the same core scripts the
 // /kenaz (Claude) and $kenaz (Codex) commands run, from a normal terminal in the project folder.
 function passthrough(argv, deps) {
   const p = paths(os.homedir());
@@ -333,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);
   }
@@ -353,8 +367,11 @@ function run(argv, out = console.log, deps = {}) {
   const fn = { install, uninstall, status, doctor }[cmd];
   if (!fn) { out(USAGE); return 2; }
   if (!nodeOk()) { out(`Node.js >= ${MIN_NODE} is required (found ${process.versions.node}). Install it from https://nodejs.org and rerun.`); return 1; }
-  try { return fn(paths(path.resolve(flags.home || os.homedir())), flags, out, deps); }
-  catch (e) { out('kenaz ' + cmd + ': ERROR ' + e.message); return 1; }
+  const fail = (e) => { out('kenaz ' + cmd + ': ERROR ' + e.message); return 1; };
+  try {
+    const r = fn(paths(path.resolve(flags.home || os.homedir())), flags, out, deps);
+    return r && typeof r.then === 'function' ? r.catch(fail) : r;
+  } catch (e) { return fail(e); }
 }
 
 module.exports = { run, parseArgs, platformServer, paths, stopOwnServer, retryBusy };

package/lib/cli.test.js

@@ -107,3 +107,13 @@ test('retryBusy retries a locked copy and then succeeds; other errors are thrown
   assert.strictEqual(n, 3);
   assert.throws(() => retryBusy(() => { const e = new Error('nope'); e.code = 'ENOENT'; throw e; }, 5), /nope/);
 });
+
+// TASK_2413: doctor names the active service mode. Stubbed `sh` + forced platform: no real system command runs.
+test('doctor reports the service mode (cron on a Linux box without systemd, manual when nothing is installed)', async () => {
+  const home = fs.mkdtempSync(path.join(os.tmpdir(), 'kenaz-doc-'));
+  const dashboard = { candidateDirs: () => [], procs: () => [], portPids: () => [] };
+  const go = async (sh) => { const l = []; await run(['doctor', '--home', home, '--no-claude', '--no-codex'], (x) => l.push(x), { dashboard, sh, platform: 'linux' }); return l.find((x) => /service mode/.test(x)); };
+  const cron = await go((c) => (c === 'crontab' ? { status: 0, stdout: '@reboot x # kenaz-server (managed by kenaz install)\n' } : { status: 1, stdout: '' }));
+  assert.match(cron, /^ok\s+service mode\s+cron/);
+  assert.match(await go(() => ({ status: 1, stdout: '' })), /^skip\s+service mode\s+manual/);
+});

package/lib/dashboard.test.js

@@ -12,9 +12,9 @@ const tmpHome = () => fs.mkdtempSync(path.join(os.tmpdir(), 'kenaz-dash-'));
 const fake = (o = {}) => ({ candidateDirs: () => o.dirs || [], procs: () => o.procs || [], portPids: () => o.owners || [] });
 const DASH_PROC = { pid: 4242, name: 'kenaz-dashboard.exe', exe: 'C:/Users/u/AppData/Local/BLOCK ACTION/kenaz-dashboard.exe' };
 
-test('install with a running Dashboard owning the port: Chinese steps, rc 1, nothing written', () => {
+test('install with a running Dashboard owning the port: Chinese steps, rc 1, nothing written', async () => {
   const home = tmpHome(), lines = [];
-  const rc = run(['install', '--home', home, '--no-claude', '--no-codex'], (m) => lines.push(m), { dashboard: fake({ procs: [DASH_PROC], owners: [4242] }) });
+  const rc = await run(['install', '--home', home, '--no-claude', '--no-codex'], (m) => lines.push(m), { dashboard: fake({ procs: [DASH_PROC], owners: [4242] }) });
   assert.strictEqual(rc, 1);
   assert.ok(lines.join('\n').includes('npx kenaz install') && lines.join('\n').includes('開機時啟動'));
   assert.ok(!fs.existsSync(path.join(home, '.kenaz')), 'no files, no service');
@@ -43,7 +43,7 @@ test('a foreign process on the port is not treated as the Dashboard', () => {
 
 test('doctor flags a running Dashboard, its port and Dashboard plugin dirs', async () => {
   const home = tmpHome(), lines = [];
-  const rc = await run(['doctor', '--home', home, '--no-claude', '--no-codex'], (m) => lines.push(m), { dashboard: fake({ dirs: [os.tmpdir()], procs: [DASH_PROC], owners: [4242] }) });
+  const rc = await run(['doctor', '--home', home, '--no-claude', '--no-codex'], (m) => lines.push(m), { dashboard: fake({ dirs: [os.tmpdir()], procs: [DASH_PROC], owners: [4242] }), sh: () => ({ status: 1, stdout: '' }) });
   assert.strictEqual(rc, 1);
   assert.ok(lines.some((l) => /^FAIL\s+dashboard running/.test(l)) && lines.some((l) => /^FAIL\s+port \d+ owner/.test(l)));
   const d = dash.detect(home, fake({ dirs: [os.tmpdir()] }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenaz",
-  "version": "0.3.11",
+  "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.11",
-    "@kenazai/server-darwin-x64": "0.3.11",
-    "@kenazai/server-linux-arm64": "0.3.11",
-    "@kenazai/server-linux-x64": "0.3.11",
-    "@kenazai/server-win32-x64": "0.3.11"
+    "@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": {