kenaz 0.3.2 → 0.3.3

package/core/plugins/kenaz/skills/ui-ux-pro-max/scripts/search.py

@@ -1,106 +1,106 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
-Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
-       python search.py "<query>" --design-system [-p "Project Name"]
-       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
-
-Domains: style, prompt, color, chart, landing, product, ux, typography
-Stacks: html-tailwind, react, nextjs
-
-Persistence (Master + Overrides pattern):
-  --persist    Save design system to design-system/MASTER.md
-  --page       Also create a page-specific override file in design-system/pages/
-"""
-
-import argparse
-from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
-from design_system import generate_design_system, persist_design_system
-
-
-def format_output(result):
-    """Format results for Claude consumption (token-optimized)"""
-    if "error" in result:
-        return f"Error: {result['error']}"
-
-    output = []
-    if result.get("stack"):
-        output.append(f"## UI Pro Max Stack Guidelines")
-        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
-    else:
-        output.append(f"## UI Pro Max Search Results")
-        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
-    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
-
-    for i, row in enumerate(result['results'], 1):
-        output.append(f"### Result {i}")
-        for key, value in row.items():
-            value_str = str(value)
-            if len(value_str) > 300:
-                value_str = value_str[:300] + "..."
-            output.append(f"- **{key}:** {value_str}")
-        output.append("")
-
-    return "\n".join(output)
-
-
-if __name__ == "__main__":
-    parser = argparse.ArgumentParser(description="UI Pro Max Search")
-    parser.add_argument("query", help="Search query")
-    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
-    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
-    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
-    parser.add_argument("--json", action="store_true", help="Output as JSON")
-    # Design system generation
-    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
-    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
-    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
-    # Persistence (Master + Overrides pattern)
-    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
-    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
-    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
-
-    args = parser.parse_args()
-
-    # Design system takes priority
-    if args.design_system:
-        result = generate_design_system(
-            args.query, 
-            args.project_name, 
-            args.format,
-            persist=args.persist,
-            page=args.page,
-            output_dir=args.output_dir
-        )
-        print(result)
-        
-        # Print persistence confirmation
-        if args.persist:
-            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
-            print("\n" + "=" * 60)
-            print(f"✅ Design system persisted to design-system/{project_slug}/")
-            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
-            if args.page:
-                page_filename = args.page.lower().replace(' ', '-')
-                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
-            print("")
-            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
-            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
-            print("=" * 60)
-    # Stack search
-    elif args.stack:
-        result = search_stack(args.query, args.stack, args.max_results)
-        if args.json:
-            import json
-            print(json.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_output(result))
-    # Domain search
-    else:
-        result = search(args.query, args.domain, args.max_results)
-        if args.json:
-            import json
-            print(json.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_output(result))
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography
+Stacks: html-tailwind, react, nextjs
+
+Persistence (Master + Overrides pattern):
+  --persist    Save design system to design-system/MASTER.md
+  --page       Also create a page-specific override file in design-system/pages/
+"""
+
+import argparse
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system, persist_design_system
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+    # Persistence (Master + Overrides pattern)
+    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
+    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
+    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(
+            args.query, 
+            args.project_name, 
+            args.format,
+            persist=args.persist,
+            page=args.page,
+            output_dir=args.output_dir
+        )
+        print(result)
+        
+        # Print persistence confirmation
+        if args.persist:
+            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
+            print("\n" + "=" * 60)
+            print(f"✅ Design system persisted to design-system/{project_slug}/")
+            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
+            if args.page:
+                page_filename = args.page.lower().replace(' ', '-')
+                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
+            print("")
+            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
+            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
+            print("=" * 60)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))

package/lib/cli.js

@@ -76,6 +76,29 @@ function prepareCodexHome(p, flags) {
 
 function nodeOk() { return Number(process.versions.node.split('.')[0]) >= MIN_NODE; }
 
+const samePath = (a, b) => {
+  const n = (x) => path.resolve(String(x || '')).replace(/\\/g, '/');
+  return process.platform === 'win32' ? n(a).toLowerCase() === n(b).toLowerCase() : n(a) === n(b);
+};
+
+/** Stop the kenaz-server running from exactly binPath (never by name). Returns the PIDs stopped. */
+function stopOwnServer(binPath, adapter) {
+  if (!binPath || !adapter || typeof adapter.procs !== 'function') return [];
+  const pids = adapter.procs().filter((pr) => pr.exe && samePath(pr.exe, binPath)).map((pr) => pr.pid);
+  for (const pid of pids) { try { (adapter.kill || process.kill)(pid); } catch (_) { /* already gone */ } }
+  return pids;
+}
+
+/** Windows keeps an exe locked for a moment after its process exits: retry the copy briefly. */
+function retryBusy(fn, tries = 10) {
+  for (let i = 1; ; i++) {
+    try { return fn(); } catch (e) {
+      if (i >= tries || !['EBUSY', 'EPERM', 'EPIPE', 'EACCES', 'ETXTBSY'].includes(e.code)) throw e;
+      Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 500);
+    }
+  }
+}
+
 function install(p, flags, out, deps = {}) {
   const dry = !!flags['dry-run'];
   const tag = dry ? '[dry-run] ' : '';
@@ -96,11 +119,22 @@ function install(p, flags, out, deps = {}) {
     else { out(`server: no @kenazai/server-${process.platform}-${process.arch} package installed (npm install it, or pass --server-bin)`); rc = 1; }
   }
   if (!dry) {
+    if (srv) {
+      // Reinstall/upgrade: the kenaz-server this install manages may be running from p.bin. Windows
+      // locks a running exe (field report: "EPIPE ... being used by another process" on
+      // `npx kenaz@latest install`) and Linux refuses to overwrite one (ETXTBSY). Stop exactly that
+      // binary (exe path match, by PID); the service step below starts the new one.
+      const stopped = stopOwnServer(binPath, deps.dashboard || dash.realAdapter(p.home));
+      if (stopped.length) log(`server: stopped the running kenaz-server (PID ${stopped.join(', ')}) to replace it`);
+    }
     fs.rmSync(p.core, { recursive: true, force: true });
     fs.cpSync(srcCore, p.core, { recursive: true });
     if (srv) {
       fs.mkdirSync(p.bin, { recursive: true });
-      fs.cpSync(srv.dir, p.bin, { recursive: true });
+      // Unix: unlink first. A running binary can be unlinked (its process keeps the old inode) but not
+      // overwritten (ETXTBSY), so this works even when the running server was not found above.
+      if (process.platform !== 'win32') fs.rmSync(binPath, { force: true });
+      retryBusy(() => fs.cpSync(srv.dir, p.bin, { recursive: true }));
       fs.chmodSync(binPath, 0o755);
     }
     fs.writeFileSync(p.meta, JSON.stringify({ version: PKG.version, server: srv ? srv.version : null, serverBin: binPath, installedAt: new Date().toISOString() }, null, 2));
@@ -248,4 +282,4 @@ function run(argv, out = console.log, deps = {}) {
   catch (e) { out('kenaz ' + cmd + ': ERROR ' + e.message); return 1; }
 }
 
-module.exports = { run, parseArgs, platformServer, paths };
+module.exports = { run, parseArgs, platformServer, paths, stopOwnServer, retryBusy };

package/lib/cli.test.js

@@ -57,3 +57,27 @@ test('kenaz ygg / init pass through to the core scripts with the remaining args'
   assert.match(calls[1][0].split(path.sep).join('/'), /plugins\/kenaz\/scripts\/kenaz-mode\.js$/);
   assert.deepStrictEqual(calls[1].slice(1), ['init']);
 });
+
+test('reinstall stops only the kenaz-server running from the managed path (exact exe match, by PID)', () => {
+  const { stopOwnServer } = require('./cli');
+  const killed = [];
+  const bin = path.join(os.tmpdir(), 'kh', '.kenaz', 'bin', process.platform === 'win32' ? 'kenaz-server.exe' : 'kenaz-server');
+  const adapter = {
+    procs: () => [
+      { pid: 11, exe: bin },
+      { pid: 12, exe: path.join(os.tmpdir(), 'other', 'kenaz-server.exe') }, // same name, different path: untouched
+      { pid: 13, exe: '' },
+    ],
+    kill: (pid) => killed.push(pid),
+  };
+  assert.deepStrictEqual(stopOwnServer(bin, adapter), [11]);
+  assert.deepStrictEqual(killed, [11]);
+});
+
+test('retryBusy retries a locked copy and then succeeds; other errors are thrown at once', () => {
+  const { retryBusy } = require('./cli');
+  let n = 0;
+  assert.strictEqual(retryBusy(() => { if (++n < 3) { const e = new Error('busy'); e.code = 'EBUSY'; throw e; } return 'ok'; }, 5), 'ok');
+  assert.strictEqual(n, 3);
+  assert.throws(() => retryBusy(() => { const e = new Error('nope'); e.code = 'ENOENT'; throw e; }, 5), /nope/);
+});

package/lib/dashboard.js

@@ -29,6 +29,16 @@ function realAdapter(home) {
         if (r.status !== 0) return [];
         try { const v = JSON.parse(r.stdout); return (Array.isArray(v) ? v : [v]).map((x) => ({ pid: x.ProcessId, name: x.Name || '', exe: x.ExecutablePath || '' })); } catch (_) { return []; }
       }
+      if (process.platform === 'linux') {
+        // /proc is always there; `ps` is not (node:22-slim has no procps, so a reinstall could not
+        // find the running kenaz-server and failed with ETXTBSY).
+        const out = [];
+        for (const d of fs.readdirSync('/proc')) {
+          if (!/^\d+$/.test(d)) continue;
+          try { const exe = fs.readlinkSync('/proc/' + d + '/exe'); out.push({ pid: Number(d), name: path.basename(exe), exe }); } catch (_) { /* gone or not ours */ }
+        }
+        return out;
+      }
       const r = sh('ps', ['-eo', 'pid=,args=']);
       return String(r.stdout || '').split('\n').map((l) => /^\s*(\d+)\s+(.+)$/.exec(l)).filter(Boolean)
         .map((m) => ({ pid: Number(m[1]), name: path.basename(m[2].split(' ')[0]), exe: m[2].split(' ')[0] }));

package/package.json

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

package/core/.specialist/tools/__tests__/task-1863-boot-lease-reuse.test.js

@@ -1,99 +0,0 @@
-// TASK_1863 — boot ghost-lease fix: re-running ansuz-boot-fast.js within the SAME
-// conversation must reuse the existing stream lease (via stream-lease register's
-// findLeaseByConversationId reuse path), not mint a new boot-<ts>-<pid> ghost.
-// Isolated sandbox via CLAUDE_PROJECT_DIR (stream-lease resolveBase honors it);
-// never touches the real repo's leases.
-//
-// Arms:
-//   1  (AC#2): 3 consecutive boots, same conversation id -> readAllLeases must hold
-//      exactly ONE lease for that conversation; boots 2/3 must not print a
-//      [Multi-Ansuz] banner (no self-ghost).
-//   2  (control): a boot under a DIFFERENT conversation id still creates its own
-//      new lease (reuse is conversation-scoped, not a global singleton).
-//
-// Usage: node .specialist/tools/__tests__/task-1863-boot-lease-reuse.test.js
-// Exit 0=all pass, non-zero=at least one failure.
-
-const { spawnSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-function resolveRoot() {
-  var d = path.resolve(__dirname);
-  for (var i = 0; i < 10; i++) {
-    if (fs.existsSync(path.join(d, '.kenaz')) && fs.existsSync(path.join(d, '.specialist'))) return d;
-    var parent = path.dirname(d); if (parent === d) break; d = parent;
-  }
-  if (process.env.CLAUDE_PROJECT_DIR) return process.env.CLAUDE_PROJECT_DIR;
-  throw new Error('Cannot resolve repo root from ' + __dirname);
-}
-const WT = resolveRoot();
-const SB = path.join(os.tmpdir(), 't1863_boot_' + process.pid);
-const BOOT = path.join(WT, '.specialist/tools/ansuz-boot-fast.js');
-const STREAM_LEASE = path.join(WT, '.specialist/tools/stream-lease.js');
-const CONV1 = 'conv-t1863-boot';
-const CONV2 = 'conv-t1863-other';
-
-for (const d of [
-  '.kenaz/tasks/backlog', '.kenaz/tasks/active', '.kenaz/tasks/done',
-  '.kenaz/tasks/blocked', '.kenaz/tasks/cancel',
-  '.kenaz/specialist/sessions/leases',
-]) fs.mkdirSync(path.join(SB, d), { recursive: true });
-
-const env = { ...process.env, CLAUDE_PROJECT_DIR: SB };
-
-const boot = (convId) => spawnSync(process.execPath, [
-  BOOT,
-  '--project-path=' + SB,
-  '--conversation-id=' + convId,
-  '--mcp-base-url=http://127.0.0.1:1', // dead port: preamble arm fails instantly, offline-safe
-], { encoding: 'utf8', env, windowsHide: true, cwd: SB, timeout: 30000 });
-
-// Count via the exported readAllLeases (card: do NOT re-implement lease scanning).
-// Child process so resolveBase picks up CLAUDE_PROJECT_DIR=SB at module load.
-const readLeases = () => {
-  const r = spawnSync(process.execPath, ['-e',
-    'const sl=require(' + JSON.stringify(STREAM_LEASE) + ');process.stdout.write(JSON.stringify(sl.readAllLeases()));',
-  ], { encoding: 'utf8', env, windowsHide: true });
-  return JSON.parse(r.stdout || '[]');
-};
-
-let pass = 0, fail = 0;
-const check = (name, cond, detail) => {
-  console.log((cond ? 'PASS' : 'FAIL') + ' | ' + name + (cond ? '' : ' | ' + detail));
-  cond ? pass++ : fail++;
-};
-
-// ── Arm 1: 3 boots, same conversation ──
-const outs = [];
-for (let i = 0; i < 3; i++) {
-  const r = boot(CONV1);
-  outs.push((r.stdout || '') + (r.stderr || ''));
-  check('boot#' + (i + 1) + ' runs (banner printed)', (r.stdout || '').includes('Ansuz'),
-    'status=' + r.status + ' | ' + ((r.stdout || '') + (r.stderr || '')).slice(0, 300));
-}
-const all = readLeases();
-const mine = all.filter((l) => l.conversation_id === CONV1);
-check('AC#2: exactly ONE lease for the conversation after 3 boots', mine.length === 1,
-  'count=' + mine.length + ' sids=' + all.map((l) => l.session_id).join(','));
-check('boots 2+3 show no [Multi-Ansuz] self-ghost',
-  !outs[1].includes('[Multi-Ansuz]') && !outs[2].includes('[Multi-Ansuz]'),
-  'boot2/3 banner: ' + (outs[1] + outs[2]).split(String.fromCharCode(10)).filter((l) => l.includes('Multi-Ansuz') || l.includes('[live]') || l.includes('[stale]')).join(' / '));
-
-// ── Arm 2 (control): different conversation still gets its OWN new lease ──
-const r2 = boot(CONV2);
-const all2 = readLeases();
-const mine2 = all2.filter((l) => l.conversation_id === CONV2);
-const mine1 = all2.filter((l) => l.conversation_id === CONV1);
-check('control: new conversation creates a NEW lease (reuse is conversation-scoped)',
-  mine2.length === 1 && mine1.length === 1 && all2.length === 2,
-  'conv2=' + mine2.length + ' conv1=' + mine1.length + ' total=' + all2.length);
-check('control: second conversation SEES the first as a live peer (banner intact)',
-  ((r2.stdout || '')).includes('[Multi-Ansuz]'),
-  'no peer banner: ' + (r2.stdout || '').slice(0, 400));
-
-fs.rmSync(SB, { recursive: true, force: true });
-console.log('---');
-console.log('RESULT: ' + pass + ' pass, ' + fail + ' fail');
-process.exit(fail ? 1 : 0);

package/core/.specialist/tools/__tests__/task-1977-banner-cap.test.js

@@ -1,129 +0,0 @@
-// TASK_1977 R3/R4(d) — ansuz-boot-fast.js handoff banner fan-out cap.
-//
-// MEASURED 2026-09-20: a run of 19 accumulated handoff slots printed 33.8 KB
-// into the fast-boot banner, most repeating the same pending_decisions text.
-// Fix: sort newest-first, print at most 3 full slots (deduped by topic
-// prefix), fold the rest into one summary line. Archiving must still touch
-// EVERY slot regardless of what gets rendered.
-//
-// Arms:
-//   1. 5 distinct-topic fixture slots -> 3 printed in full + 1 summary line
-//      naming the other 2 topics; all 5 archived.
-//   2. dedup case: several slots share a topic prefix -> duplicates fold
-//      into the summary instead of eating a "printed" slot.
-//
-// Usage: node .specialist/tools/__tests__/task-1977-banner-cap.test.js
-// Exit 0=all pass, non-zero=at least one failure.
-
-const { spawnSync } = require('child_process');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-function resolveRoot() {
-  let d = path.resolve(__dirname);
-  for (let i = 0; i < 10; i++) {
-    if (fs.existsSync(path.join(d, '.kenaz')) && fs.existsSync(path.join(d, '.specialist'))) return d;
-    const parent = path.dirname(d);
-    if (parent === d) break;
-    d = parent;
-  }
-  if (process.env.CLAUDE_PROJECT_DIR) return process.env.CLAUDE_PROJECT_DIR;
-  throw new Error('Cannot resolve repo root from ' + __dirname);
-}
-const WT = resolveRoot();
-const BOOT = path.join(WT, '.specialist/tools/ansuz-boot-fast.js');
-
-let pass = 0, fail = 0;
-function check(name, cond, detail) {
-  console.log((cond ? 'PASS' : 'FAIL') + ' | ' + name + (cond ? '' : ' | ' + detail));
-  cond ? pass++ : fail++;
-}
-
-function makeSandbox(prefix) {
-  const sb = path.join(os.tmpdir(), prefix + '_' + process.pid + '_' + Date.now());
-  for (const d of [
-    '.kenaz/tasks/backlog', '.kenaz/tasks/active', '.kenaz/tasks/done',
-    '.kenaz/tasks/blocked', '.kenaz/tasks/cancel',
-    '.kenaz/specialist/sessions/leases',
-    '.kenaz/specialist/handoffs',
-  ]) fs.mkdirSync(path.join(sb, d), { recursive: true });
-  return sb;
-}
-
-function writeSlot(sb, name, topic, generatedAt) {
-  const p = path.join(sb, '.kenaz/specialist/handoffs', name);
-  fs.writeFileSync(p, JSON.stringify({
-    generated_at: generatedAt,
-    isbar: {
-      situation: { current_topic: topic, pending_decisions: 'pending for ' + topic },
-      recommendation: { first_action: 'continue ' + topic },
-      assessment: { unfinished: 'unfinished ' + topic },
-    },
-  }));
-}
-
-function boot(sb) {
-  return spawnSync(process.execPath, [
-    BOOT,
-    '--project-path=' + sb,
-    '--conversation-id=t1977-banner-' + path.basename(sb),
-    '--mcp-base-url=http://127.0.0.1:1', // dead port: preamble arm fails instantly, offline-safe
-  ], { encoding: 'utf8', env: { ...process.env, CLAUDE_PROJECT_DIR: sb }, windowsHide: true, cwd: sb, timeout: 30000 });
-}
-
-// ── Arm 1: 5 distinct-topic slots, oldest to newest ──
-const sb1 = makeSandbox('t1977_banner_distinct');
-writeSlot(sb1, 'slot-1.json', 'Topic ONE',   '2026-09-15T00:00:00.000Z');
-writeSlot(sb1, 'slot-2.json', 'Topic TWO',   '2026-09-16T00:00:00.000Z');
-writeSlot(sb1, 'slot-3.json', 'Topic THREE', '2026-09-17T00:00:00.000Z');
-writeSlot(sb1, 'slot-4.json', 'Topic FOUR',  '2026-09-18T00:00:00.000Z');
-writeSlot(sb1, 'slot-5.json', 'Topic FIVE',  '2026-09-19T00:00:00.000Z'); // newest
-const r1 = boot(sb1);
-const out1 = (r1.stdout || '') + (r1.stderr || '');
-check('arm1: boot runs (banner printed)', out1.includes('Ansuz'), 'status=' + r1.status + ' | ' + out1.slice(0, 300));
-// TASK_2280: the banner prints String(slot_file).slice(0, 8) (TASK_1988 diet),
-// so "slot-5.json" shows as "[slot-5.j]" -- match the 8-char prefix, not the filename.
-const fullBlocks1 =(out1.match(/📜 Handoff \[slot-\d\.j\]:/g) || []).length;
-check('arm1: exactly 3 full slots printed', fullBlocks1 === 3, 'count=' + fullBlocks1 + '\n' + out1);
-check('arm1: newest 3 topics printed in full (FIVE, FOUR, THREE)',
-  out1.includes('Topic FIVE') && out1.includes('Topic FOUR') && out1.includes('Topic THREE'),
-  out1);
-check('arm1: one summary line for the remaining 2, naming their topics',
-  /2 more handoff slots archived \(topics: Topic TWO; Topic ONE\)/.test(out1),
-  out1);
-const archiveDir1 = path.join(sb1, '.kenaz/specialist/handoff_archive');
-const archived1 = fs.existsSync(archiveDir1) ? fs.readdirSync(archiveDir1) : [];
-check('arm1: ALL 5 slots archived regardless of banner selection', archived1.length === 5, 'archived=' + JSON.stringify(archived1));
-const remaining1 = fs.readdirSync(path.join(sb1, '.kenaz/specialist/handoffs'));
-check('arm1: handoffs dir drained after archiving', remaining1.length === 0, 'remaining=' + JSON.stringify(remaining1));
-
-// ── Arm 2: dedup -- 4 slots share a topic prefix, 1 is distinct ──
-const sb2 = makeSandbox('t1977_banner_dedup');
-const REPEATED_TOPIC = 'Repeated handoff topic used verbatim across several stale Codex sessions that keeps recurring';
-writeSlot(sb2, 'dup-1.json', REPEATED_TOPIC, '2026-09-16T00:00:00.000Z');
-writeSlot(sb2, 'dup-2.json', REPEATED_TOPIC, '2026-09-17T00:00:00.000Z');
-writeSlot(sb2, 'dup-3.json', REPEATED_TOPIC, '2026-09-18T00:00:00.000Z'); // newest of the dupes
-writeSlot(sb2, 'unique.json', 'A distinct one-off topic', '2026-09-15T00:00:00.000Z'); // oldest overall
-const r2 = boot(sb2);
-const out2 = (r2.stdout || '') + (r2.stderr || '');
-check('arm2: boot runs (banner printed)', out2.includes('Ansuz'), 'status=' + r2.status + ' | ' + out2.slice(0, 300));
-const fullBlocks2 = (out2.match(/📜 Handoff \[(dup-\d\.js|unique\.j)\]:/g) || []).length;
-check('arm2: only 2 full slots printed (one per distinct topic prefix, dupes folded)', fullBlocks2 === 2, 'count=' + fullBlocks2 + '\n' + out2);
-check('arm2: newest dupe (dup-3) is the one printed in full, not dup-1/dup-2',
-  out2.includes('📜 Handoff [dup-3.js]:') && !out2.includes('📜 Handoff [dup-1.js]:') && !out2.includes('📜 Handoff [dup-2.js]:'),
-  out2);
-check('arm2: the distinct topic is also printed in full', out2.includes('📜 Handoff [unique.j]:'), out2);
-check('arm2: summary line folds the 2 duplicate slots', /2 more handoff slots archived/.test(out2), out2);
-const archiveDir2 = path.join(sb2, '.kenaz/specialist/handoff_archive');
-const archived2 = fs.existsSync(archiveDir2) ? fs.readdirSync(archiveDir2) : [];
-check('arm2: ALL 4 slots archived regardless of dedup folding', archived2.length === 4, 'archived=' + JSON.stringify(archived2));
-
-// ── cleanup ──
-for (const sb of [sb1, sb2]) {
-  try { fs.rmSync(sb, { recursive: true, force: true }); } catch { /* best-effort */ }
-}
-
-console.log('---');
-console.log('RESULT: ' + pass + ' pass, ' + fail + ' fail');
-process.exit(fail > 0 ? 1 : 0);