kenaz 0.3.21 → 0.3.23

package/core/plugins/kenaz-peer/hooks/register.ts

@@ -20,6 +20,8 @@ let cwd = ''
 let beaten = false
 let busy = false
 let ansuz = false // sticky: once a session is Ansuz it never flips back
+let entrypoint = '' // CLAUDE_CODE_ENTRYPOINT; the env opt-in counts only for the interactive 'cli'
+let optinLive = false // TASK_2465: opt-in marker seen on the last check (expires, so not sticky)
 // Same markers as .claude/hooks/_ansuz-conversation.js (turn-context's gate).
 const MARKERS = [
   '<command-name>/Ansuz</command-name>',
@@ -65,8 +67,28 @@ async function project($: any): Promise<string> {
 }
 
 // Only USER-role text counts (strings or text blocks); tool results do not.
+// TASK_2465: opt-in marker written by .claude/hooks/peer-session-fill.js (kenaz_peer_send / ygg join|create) under
+// <KENAZ_PEER_OPTIN_DIR | ~/.kenaz/peer-optin>/<session id>.json, or KENAZ_PEER_OPTIN=1 (kenaz launch). 24 h expiry.
+const OPTIN_TTL_MS = 24 * 3600 * 1000
+async function optedIn($: any): Promise<boolean> {
+  try {
+    if (entrypoint === 'cli' && (await $.env.get('KENAZ_PEER_OPTIN')) === '1') return true
+    if (!/^[A-Za-z0-9_-]{1,128}$/.test(sessionId)) return false
+    let dir = (await $.env.get('KENAZ_PEER_OPTIN_DIR')) ?? ''
+    if (!dir) {
+      const home = (await $.env.get('USERPROFILE')) ?? (await $.env.get('HOME')) ?? ''
+      if (!home) return false
+      dir = `${home}/.kenaz/peer-optin`
+    }
+    const f = await $.fs.read(`${dir}/${sessionId}.json`)
+    const age = Date.now() - Number(JSON.parse(typeof f === 'string' ? f : f.text).ts)
+    return age >= 0 && age < OPTIN_TTL_MS
+  } catch { return false }
+}
+
 async function isAnsuz($: any): Promise<boolean> {
   if (ansuz) return true
+  if ((optinLive = await optedIn($))) return true
   try {
     const rows = await $.session.messages({ as: 'api' })
     for (const m of rows) {
@@ -163,10 +185,11 @@ export const register: Register = on => {
       ep = (await $.env.get('CLAUDE_CODE_ENTRYPOINT')) ?? ''
       optIn = (await $.env.get('KENAZ_IN_SDK')) ?? ''
     } catch { /* env unreadable: behave as an interactive session */ }
+    entrypoint = ep
     if (ep.startsWith('sdk-') && ep !== 'sdk-cli' && optIn !== '1') return next(e)
     sessionId = String(await $.session.id())
     cwd = String(await $.session.cwd())
-    $.clock.every(HEARTBEAT_MS, () => { if (ansuz) void beat($) })
+    $.clock.every(HEARTBEAT_MS, () => { if (ansuz || optinLive) void beat($) })
     $.clock.every(POLL_MS, () => { void cycle($) })
     return next(e)
   })

package/lib/cli.js

@@ -72,8 +72,8 @@ function platformServer() {
 
 function onPath(cmd) {
   const r = process.platform === 'win32' // one string with shell (.cmd shims); args + shell:true is deprecated (DEP0190)
-    ? spawnSync(cmd + ' --version', { encoding: 'utf8', shell: true, timeout: 15000 })
-    : spawnSync(cmd, ['--version'], { encoding: 'utf8', timeout: 15000 });
+    ? spawnSync(cmd + ' --version', { windowsHide: true, encoding: 'utf8', shell: true, timeout: 15000 })
+    : spawnSync(cmd, ['--version'], { windowsHide: true, encoding: 'utf8', timeout: 15000 });
   return r.status === 0;
 }
 
@@ -244,7 +244,7 @@ async function doctor(p, flags, out, deps = {}) {
 
   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 + ')');
+    add('service mode', sm.mode === 'manual' ? 'skip' : sm.warn ? 'warn' : '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');
@@ -262,7 +262,11 @@ async function doctor(p, flags, out, deps = {}) {
   else {
     const d = { disabled: `off: ${upd.reason}`, error: `last check failed: ${upd.last_error}`, staged: `${upd.staged_version} staged, applies when idle`,
       applied: `${upd.applied_version} swapped in (previous ${upd.previous_version}), restart pending`, 'rolled-back': 'rolled back to the previous version' }[upd.state] || `${upd.state}, latest ${upd.latest_version || 'unknown'}`;
-    add('self-update', upd.state === 'disabled' ? 'skip' : 'ok', `${d} [running ${upd.current_version}]`);
+    // A staged version not newer than the running one froze older servers' updater (checks stop while one is staged).
+    const num = (v) => String(v || '').split('.').map(Number);
+    const stale = upd.staged_version && num(upd.staged_version).reduce((c, x, i) => c || x - (num(upd.current_version)[i] || 0), 0) <= 0;
+    if (stale) add('self-update', 'warn', `${upd.staged_version} staged but running ${upd.current_version}: updater stuck; delete ${path.join(p.dir, 'update', 'status.json')} and restart kenaz-server`);
+    else add('self-update', upd.state === 'disabled' ? 'skip' : upd.state === 'error' ? 'warn' : 'ok', `${d} [running ${upd.current_version}]`);
   }
 
   const inst = installer();
@@ -313,7 +317,7 @@ function passthrough(argv, deps) {
   const script = argv[0] === 'ygg' ? 'ygg.js' : 'kenaz-mode.js';
   const args = argv[0] === 'ygg' ? argv.slice(1) : argv;
   const spawn = deps.spawnSync || require('child_process').spawnSync;
-  const r = spawn(process.execPath, [path.join(core, 'plugins', 'kenaz', 'scripts', script), ...args], { stdio: 'inherit', cwd: process.cwd() });
+  const r = spawn(process.execPath, [path.join(core, 'plugins', 'kenaz', 'scripts', script), ...args], { windowsHide: true, stdio: 'inherit', cwd: process.cwd() });
   return r.status === null ? 1 : r.status;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenaz",
-  "version": "0.3.21",
+  "version": "0.3.23",
   "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.21",
-    "@kenazai/server-darwin-x64": "0.3.21",
-    "@kenazai/server-linux-arm64": "0.3.21",
-    "@kenazai/server-linux-x64": "0.3.21",
-    "@kenazai/server-win32-x64": "0.3.21"
+    "@kenazai/server-darwin-arm64": "0.3.23",
+    "@kenazai/server-darwin-x64": "0.3.23",
+    "@kenazai/server-linux-arm64": "0.3.23",
+    "@kenazai/server-linux-x64": "0.3.23",
+    "@kenazai/server-win32-x64": "0.3.23"
   },
   "license": "UNLICENSED",
   "repository": {

package/vendor/install-kenaz-cli.js

@@ -22,6 +22,8 @@ const MIN_CLI = [2, 1, 287];
 const SEP = process.platform === 'win32' ? ';' : ':';
 const TASK_NAME = 'KenazServer';
 const LABEL = 'ai.kenaz.server';
+const BATTERY_PS = '$s = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -ExecutionTimeLimit ([TimeSpan]::Zero); Set-ScheduledTask -TaskName ' + TASK_NAME + ' -Settings $s';
+const linuxUser = () => { try { return os.userInfo().username; } catch (_) { return process.env.USER || ''; } };
 
 const norm = (e) => {
   const s = String(e).trim().replace(/\\/g, '/').replace(/\/+$/, '');
@@ -136,8 +138,8 @@ function retireDashboardHooks(file, dry) {
 
 function claudeVersion() {
   const r = process.platform === 'win32' // one string with shell (.cmd shim): args + shell:true is deprecated (DEP0190)
-    ? spawnSync('claude --version', { encoding: 'utf8', shell: true, timeout: 15000 })
-    : spawnSync('claude', ['--version'], { encoding: 'utf8', timeout: 15000 });
+    ? spawnSync('claude --version', { windowsHide: true, encoding: 'utf8', shell: true, timeout: 15000 })
+    : spawnSync('claude', ['--version'], { windowsHide: true, encoding: 'utf8', timeout: 15000 });
   return r.status === 0 ? parseVersion(r.stdout) : null;
 }
 
@@ -208,7 +210,7 @@ function servicePlan(home, bin, core, platform = process.platform, caps = { syst
   const p = path.join(home, '.config', 'systemd', 'user', 'kenaz-server.service');
   return { kind: 'systemd', files: [[p, systemdUnit(bin, core)]], unit: p };
 }
-const sh = (cmd, args, opts) => spawnSync(cmd, args, { encoding: 'utf8', ...(opts || {}) });
+const sh = (cmd, args, opts) => spawnSync(cmd, args, { windowsHide: true, encoding: 'utf8', ...(opts || {}) });
 
 // crontab -l: null = no crontab binary; '' = binary present, no crontab yet. All through the injected `run`.
 function readCron(run) {
@@ -303,8 +305,13 @@ function serviceInstall(plan, dry, log, run = sh, uid) {
     log('schtasks /Create /TN ' + TASK_NAME + ' /SC ONLOGON /TR ' + tr + ' /F  (fallback: ' + plan.fallbackFile + ')');
     if (dry) return;
     const r = sh('schtasks', ['/Create', '/TN', TASK_NAME, '/SC', 'ONLOGON', '/TR', tr, '/F']);
-    if (r.status === 0) sh('schtasks', ['/Run', '/TN', TASK_NAME]);
-    else { // ONLOGON tasks can need elevation: a Startup-folder launcher is the per-user equivalent
+    if (r.status === 0) {
+      // Task Scheduler defaults refuse to start on battery and stop the task when going on battery:
+      // a laptop unplugged at logon never got the server (TASK_2468). Re-running install fixes an old task.
+      const b = sh('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', BATTERY_PS]);
+      if (b.status !== 0) log('WARNING: could not set the task to run on battery (exit ' + b.status + '); on a laptop the server may not start unplugged. Run in PowerShell: ' + BATTERY_PS);
+      sh('schtasks', ['/Run', '/TN', TASK_NAME]);
+    } else { // ONLOGON tasks can need elevation: a Startup-folder launcher is the per-user equivalent
       fs.mkdirSync(path.dirname(plan.fallbackFile), { recursive: true });
       fs.copyFileSync(plan.files[0][0], plan.fallbackFile);
       sh('wscript.exe', [plan.files[0][0]]);
@@ -326,6 +333,10 @@ function serviceInstall(plan, dry, log, run = sh, uid) {
   } else {
     log('systemctl --user enable --now kenaz-server');
     if (!dry) { sh('systemctl', ['--user', 'daemon-reload']); sh('systemctl', ['--user', 'enable', '--now', 'kenaz-server']); }
+    // Without linger the user service starts only at login (headless boxes: never). Best effort.
+    const u = linuxUser();
+    log('loginctl enable-linger ' + u);
+    if (!dry && sh('loginctl', ['enable-linger', u]).status !== 0) log('WARNING: could not enable linger; the server starts at boot only after you log in. Run: loginctl enable-linger ' + u + ' (may need sudo)');
     serviceRestart(plan, dry, log, sh, uid);
   }
 }
@@ -365,7 +376,11 @@ function detectServiceMode(home, core, run = sh, platform = process.platform) {
     return fs.existsSync(p) ? { mode: 'launchd', detail: p } : { mode: 'manual', detail: 'no launchd agent; run `kenaz install`' };
   }
   const unit = servicePlan(home, '', core, 'linux').unit;
-  if (fs.existsSync(unit) && probeLinux(run).systemd) return { mode: 'systemd', detail: unit };
+  if (fs.existsSync(unit) && probeLinux(run).systemd) {
+    const u = linuxUser();
+    const off = /Linger=no/.test(run('loginctl', ['show-user', u, '-p', 'Linger']).stdout || '');
+    return off ? { mode: 'systemd', detail: unit + '; linger is off, the server starts only after login: run loginctl enable-linger ' + u, warn: true } : { mode: 'systemd', detail: unit };
+  }
   const c = readCron(run);
   if (c && c.includes(CRON_MARK)) return { mode: 'cron', detail: '@reboot crontab entry (no systemd user session)' };
   return { mode: 'manual', detail: 'no systemd unit or cron entry; run `kenaz install`' };