kenaz 0.3.3 → 0.3.5

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

@@ -55,7 +55,10 @@ function platformServer() {
 }
 
 function onPath(cmd) {
-  return spawnSync(cmd, ['--version'], { encoding: 'utf8', shell: process.platform === 'win32', timeout: 15000 }).status === 0;
+  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 });
+  return r.status === 0;
 }
 
 /** setup-codex.js from the installed core (dry-run and doctor-before-install: from the package). */
@@ -197,9 +200,9 @@ function status(p, flags, out) {
   return 0;
 }
 
-function probe(port) {
+function probe(port, urlPath = '/api/health') {
   return new Promise((resolve) => {
-    const req = http.get({ host: '127.0.0.1', port, path: '/api/health', timeout: 2500 }, (res) => {
+    const req = http.get({ host: '127.0.0.1', port, path: urlPath, timeout: 2500 }, (res) => {
       let body = ''; res.on('data', (d) => { body += d; }); res.on('end', () => resolve({ ok: res.statusCode < 500, detail: `HTTP ${res.statusCode} on :${port}`, body }));
     });
     req.on('timeout', () => { req.destroy(); resolve({ ok: false, detail: `no answer on 127.0.0.1:${port}` }); });
@@ -229,7 +232,11 @@ async function doctor(p, flags, out, deps = {}) {
     const o = d.portOwner;
     add(`port ${d.port} owner`, o && d.ownerIsDashboard ? 'FAIL' : 'ok', o ? `PID ${o.pid} ${o.exe || o.name}${d.ownerIsDashboard ? ' (Dashboard)' : ''}` : 'nobody listening');
   }
-  const upd = readJson(path.join(p.dir, 'update', 'status.json')); // TASK_2378, written by kenaz-server
+  // Ask the running server first: its answer carries its own version. The status file can still
+  // describe the previous binary right after an upgrade (field report: "[running 0.3.1]" on 0.3.3).
+  let upd = null;
+  if (r.ok) { const u = await probe(process.env.KENAZ_HTTP_PORT || '18080', '/api/update/status'); try { upd = JSON.parse(u.body); } catch (_) { /* older server */ } }
+  if (!upd || !upd.state) upd = readJson(path.join(p.dir, 'update', 'status.json')); // TASK_2378, written by kenaz-server
   if (!upd) add('self-update', 'skip', 'no status yet (kenaz-server has not run the updater)');
   else {
     const d = { disabled: `off: ${upd.reason}`, error: `last check failed: ${upd.last_error}`, staged: `${upd.staged_version} staged, applies when idle`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenaz",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Install Kenaz (plugin, hooks, kenaz-server) for Claude Code and Codex: npx kenaz install",
   "bin": {
     "kenaz": "bin/kenaz.js"
@@ -20,11 +20,15 @@
     "test": "node --test lib/cli.test.js"
   },
   "optionalDependencies": {
-    "@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"
+    "@kenazai/server-darwin-arm64": "0.3.5",
+    "@kenazai/server-darwin-x64": "0.3.5",
+    "@kenazai/server-linux-arm64": "0.3.5",
+    "@kenazai/server-linux-x64": "0.3.5",
+    "@kenazai/server-win32-x64": "0.3.5"
   },
-  "license": "UNLICENSED"
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xyz9516/KenazAI.git"
+  }
 }

package/vendor/install-kenaz-cli.js

@@ -111,7 +111,9 @@ function retireDashboardHooks(file, dry) {
 }
 
 function claudeVersion() {
-  const r = spawnSync('claude', ['--version'], { encoding: 'utf8', shell: process.platform === 'win32', timeout: 15000 });
+  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 });
   return r.status === 0 ? parseVersion(r.stdout) : null;
 }
 
@@ -125,14 +127,21 @@ function winVbs(bin, core) { // hidden window, env for task tools; server binds
   return 'Set sh = WScript.CreateObject("WScript.Shell")\r\nsh.Environment("Process")("KENAZ_SOURCE_DIR") = "' + core + '"\r\n' +
     'sh.Run """' + bin + '""", 0, False\r\n';
 }
-function launchdPlist(bin, core, log) {
+// launchd and systemd start the server with a bare PATH (/usr/bin:/bin...), so `node` from Homebrew,
+// nvm or /usr/local was not found and every MCP tool that runs a node script failed with
+// "No such file or directory" (field report, macOS 0.3.1). Put the node running this install first.
+function servicePath(nodeExe = process.execPath) {
+  return [path.dirname(nodeExe), '/opt/homebrew/bin', '/usr/local/bin', '/usr/bin', '/bin', '/usr/sbin', '/sbin']
+    .filter((d, i, a) => a.indexOf(d) === i).join(':');
+}
+function launchdPlist(bin, core, log, nodeExe) {
   return '<?xml version="1.0" encoding="UTF-8"?>\n<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n<plist version="1.0"><dict>\n' +
     '  <key>Label</key><string>' + LABEL + '</string>\n  <key>ProgramArguments</key><array><string>' + bin + '</string></array>\n' +
-    '  <key>EnvironmentVariables</key><dict><key>KENAZ_SOURCE_DIR</key><string>' + core + '</string></dict>\n' +
+    '  <key>EnvironmentVariables</key><dict><key>KENAZ_SOURCE_DIR</key><string>' + core + '</string><key>PATH</key><string>' + servicePath(nodeExe) + '</string></dict>\n' +
     '  <key>RunAtLoad</key><true/>\n  <key>KeepAlive</key><true/>\n  <key>StandardOutPath</key><string>' + log + '</string>\n  <key>StandardErrorPath</key><string>' + log + '</string>\n</dict></plist>\n';
 }
-function systemdUnit(bin, core) {
-  return '[Unit]\nDescription=Kenaz server (headless backend)\nAfter=network.target\n\n[Service]\nExecStart=' + bin + '\nEnvironment=KENAZ_SOURCE_DIR=' + core + '\nRestart=on-failure\n\n[Install]\nWantedBy=default.target\n';
+function systemdUnit(bin, core, nodeExe) {
+  return '[Unit]\nDescription=Kenaz server (headless backend)\nAfter=network.target\n\n[Service]\nExecStart=' + bin + '\nEnvironment=KENAZ_SOURCE_DIR=' + core + '\nEnvironment=PATH=' + servicePath(nodeExe) + '\nRestart=on-failure\n\n[Install]\nWantedBy=default.target\n';
 }
 
 function servicePlan(home, bin, core, platform = process.platform) {
@@ -163,7 +172,9 @@ function serviceInstall(plan, dry, log) {
       fs.mkdirSync(path.dirname(plan.fallbackFile), { recursive: true });
       fs.copyFileSync(plan.files[0][0], plan.fallbackFile);
       sh('wscript.exe', [plan.files[0][0]]);
-      log('schtasks refused (' + (r.stderr || '').trim() + '); installed Startup-folder launcher instead');
+      // schtasks' stderr is in the console's OEM code page (garbled when echoed); the usual cause is
+      // missing admin rights for /SC ONLOGON. The Startup-folder launcher starts at logon the same way.
+      log('schtasks needs administrator rights here (exit ' + r.status + '); installed the Startup-folder launcher instead (also starts at logon)');
     }
   } else if (plan.kind === 'launchd') {
     log('launchctl load -w ' + plan.unit); if (!dry) sh('launchctl', ['load', '-w', plan.unit]);
@@ -259,7 +270,7 @@ function main(argv, out = console.log, getVersion = claudeVersion) { // getVersi
     else if (!bin) { out('service: skipped, kenaz-server binary not found (pass --server-bin)'); rc = 1; }
     else serviceInstall(plan, dry, log);
   }
-  if (cmd === 'install' && rc === 0) out('Next: cd <your project>; claude; /kenaz init; /Ansuz');
+  if (cmd === 'install' && rc === 0) out('Next: cd <your project>; claude; /kenaz:kenaz init; /kenaz:Ansuz   (Codex: run /hooks once to trust the kenaz hooks, then $kenaz status)');
   if (cmd === 'uninstall') out('Project .kenaz/ data was left untouched.');
   return rc;
 }

package/core/.formation/tools/broadcast.js

@@ -1,103 +0,0 @@
-'use strict';
-/**
- * Broadcast Layer
- *
- * Supabase/Yggdrasil broadcast helpers extracted from headless.js.
- * Lazy-loaded singletons — no hard dependency on supabase-client at require time.
- *
- * Exports: getSupabaseClient, getTaskSync, getCommitSync, syncCommit,
- *          broadcastStatus, broadcastStatusSync
- */
-
-const path = require('path');
-const { ROOT } = require('./utils');
-
-// ─────────────────────────────────────────
-// Yggdrasil: kenaz_status 廣播 + commit-sync（lazy loaded, graceful degradation）
-// ─────────────────────────────────────────
-let _supabaseClient = null;
-let _taskSync = null;
-let _commitSync = null;
-
-function getSupabaseClient(projectPath) {
-  if (_supabaseClient === undefined) return null;
-  if (!_supabaseClient) try { _supabaseClient = require('./supabase-client'); } catch { _supabaseClient = undefined; return null; }
-  return _supabaseClient.getClient(projectPath);
-}
-
-function getTaskSync() {
-  if (_taskSync === undefined) return null;
-  if (!_taskSync) try { _taskSync = require('./task-sync'); } catch { _taskSync = undefined; return null; }
-  return _taskSync;
-}
-
-function getCommitSync() {
-  if (_commitSync === undefined) return null;
-  if (!_commitSync) try { _commitSync = require('./commit-sync'); } catch { _commitSync = undefined; return null; }
-  return _commitSync;
-}
-
-/**
- * 同步 commit 到 kenaz_commits。
- * 回傳 Promise（await 時確保完成，或 fire-and-forget）。
- */
-function syncCommit(taskId, projectPath) {
-  try {
-    const cs = getCommitSync();
-    if (!cs) return Promise.resolve();
-    return cs.syncLatestCommit({ taskId, projectPath }).catch(() => {});
-  } catch { return Promise.resolve(); }
-}
-
-/**
- * 廣播 kenaz_status — 讓 Agent Monitor 和其他機器看到 dispatch agent。
- * 回傳 Promise — caller 可 await 確保完成。
- */
-function broadcastStatus(projectPath, updates) {
-  try {
-    const sb = getSupabaseClient(projectPath);
-    if (!sb) return Promise.resolve();
-    const { client, config } = sb;
-    const ts = getTaskSync();
-    const project = ts?.resolveProjectName?.(projectPath || ROOT) || path.basename(ROOT);
-    return client.from('kenaz_status').upsert({
-      node_name: config.node_name,
-      project,
-      ...updates,
-    }, { onConflict: 'node_name,project' }).then(() => {}).catch(() => {});
-  } catch { return Promise.resolve(); }
-}
-
-/**
- * 同步版 broadcastStatus — 用於 process exit 前確保送達。
- * 使用 synchronous HTTP（spawnSync + curl）避免 async 在退出時丟失。
- */
-function broadcastStatusSync(projectPath, updates) {
-  try {
-    const sb = getSupabaseClient(projectPath);
-    if (!sb) return;
-    const { config } = sb;
-    const ts = getTaskSync();
-    const project = ts?.resolveProjectName?.(projectPath || ROOT) || path.basename(ROOT);
-    const payload = { node_name: config.node_name, project, ...updates };
-    const url = `${config.supabase_url}/rest/v1/kenaz_status`;
-    const { spawnSync } = require('child_process');
-    spawnSync('curl', [
-      '-s', '-X', 'POST', url,
-      '-H', `apikey: ${config.supabase_anon_key}`,
-      '-H', `Authorization: Bearer ${config.supabase_anon_key}`,
-      '-H', 'Content-Type: application/json',
-      '-H', 'Prefer: resolution=merge-duplicates',
-      '-d', JSON.stringify(payload),
-    ], { timeout: 5000, stdio: 'ignore', windowsHide: true });
-  } catch { /* best-effort */ }
-}
-
-module.exports = {
-  getSupabaseClient,
-  getTaskSync,
-  getCommitSync,
-  syncCommit,
-  broadcastStatus,
-  broadcastStatusSync,
-};

package/core/.formation/tools/dispatch-dryrun.test.js

@@ -1,54 +0,0 @@
-// TASK_2274: formation-mode `--dry-run` must have NO side effects: no git init
-// of the target, no resource lock files, no claim adoption. Drives the real CLI
-// entry (dispatch.js -> dispatch()) against a temp project root.
-const test = require('node:test');
-const assert = require('node:assert/strict');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-const DISPATCH = path.join(__dirname, 'dispatch.js');
-
-function mkProject() {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 't2274_'));
-  fs.mkdirSync(path.join(root, '.kenaz', 'tasks', 'backlog'), { recursive: true });
-  fs.mkdirSync(path.join(root, '.kenaz', 'tasks', 'active'), { recursive: true });
-  fs.writeFileSync(path.join(root, '.kenaz', 'tasks', 'backlog', 'TASK_9001_dryrun.yaml'), [
-    'id: TASK_9001', 'title: dry run probe', 'description: probe', 'status: backlog',
-    'priority: P2', 'scope_paths:', '  - src/x.js', 'resources:', '  - dryrun_res', ''].join('\n'));
-  return root;
-}
-function run(root, extra, envOver) {
-  const env = { ...process.env, ...(envOver || {}) }; delete env.CLAUDE_PROJECT_DIR;
-  return spawnSync(process.execPath, [DISPATCH, '--formation=unit', '--skill=do', '--task=TASK_9001',
-    '--project-path', root, ...extra], { encoding: 'utf8', env, windowsHide: true, timeout: 90000 });
-}
-const lockFile = (root) => path.join(root, '.kenaz', 'locks', 'resource_dryrun_res.lock');
-
-test('formation-mode --dry-run: no git init, no resource lock, reports intent', () => {
-  const root = mkProject();
-  try {
-    const r = run(root, ['--dry-run']);
-    const out = (r.stdout || '') + (r.stderr || '');
-    assert.equal(r.status, 0, out.slice(-500));
-    assert.ok(!fs.existsSync(path.join(root, '.git')), 'dry-run must not git init');
-    assert.ok(!fs.existsSync(lockFile(root)), 'dry-run must not acquire resource lock');
-    assert.match(out, /\[dry-run\] resource locks NOT acquired: dryrun_res/);
-    assert.match(out, /\[dry-run\] would git init/);
-  } finally { fs.rmSync(root, { recursive: true, force: true }); }
-});
-
-test('control: non-dry-run formation dispatch DOES git init and acquire the lock', () => {
-  const root = mkProject();
-  try {
-    // PATH = node + git dirs only and a fake HOME, so the real agent launch cannot
-    // find a claude binary (it fails after the lock/git steps we are asserting).
-    const gitDirs = spawnSync(process.platform === 'win32' ? 'where' : 'which', ['git'], { encoding: 'utf8' })
-      .stdout.split(/\r?\n/).filter(Boolean).map((p) => path.dirname(p));
-    const PATH = [path.dirname(process.execPath), ...gitDirs].join(path.delimiter);
-    run(root, [], { PATH, Path: PATH, USERPROFILE: root, HOME: root });
-    assert.ok(fs.existsSync(path.join(root, '.git')), 'control: git init expected');
-    assert.ok(fs.existsSync(lockFile(root)), 'control: lock expected');
-  } finally { fs.rmSync(root, { recursive: true, force: true }); }
-});

package/core/.formation/tools/dispatch-notifier.js

@@ -1,84 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { ROOT } = require('./utils');
-
-function getDispatchNotificationFile(corePath = ROOT) {
-  return path.join(corePath, '.formation', '.dispatch-notifications.json');
-}
-
-function readDispatchNotifications(corePath = ROOT) {
-  const file = getDispatchNotificationFile(corePath);
-  try {
-    if (fs.existsSync(file)) {
-      const parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
-      return Array.isArray(parsed) ? parsed : [];
-    }
-  } catch {}
-  return [];
-}
-
-function writeDispatchNotifications(list, corePath = ROOT) {
-  const file = getDispatchNotificationFile(corePath);
-  try {
-    fs.writeFileSync(file, JSON.stringify(list, null, 2));
-  } catch {}
-}
-
-function enqueueDispatchNotification(event, corePath = ROOT) {
-  if (!event || !event.originSessionId || !event.taskId || !event.status) return null;
-
-  const list = readDispatchNotifications(corePath);
-  const notification = {
-    id: event.id || `dispatch-${event.taskId}-${Date.now()}`,
-    originSessionId: event.originSessionId,
-    taskId: event.taskId,
-    status: event.status,
-    summary: event.summary || '',
-    formation: event.formation || 'unit',
-    skill: event.skill || 'do',
-    dispatchSessionId: event.dispatchSessionId || null,
-    projectPath: event.projectPath || null,
-    logPath: event.logPath || null,
-    metadata: event.metadata || {},
-    createdAt: event.createdAt || new Date().toISOString(),
-  };
-  list.push(notification);
-  writeDispatchNotifications(list, corePath);
-  return notification;
-}
-
-function takeDispatchNotifications(originSessionId, corePath = ROOT) {
-  if (!originSessionId) return [];
-  const list = readDispatchNotifications(corePath);
-  if (list.length === 0) return [];
-
-  const matches = [];
-  const remaining = [];
-  for (const item of list) {
-    if (item && item.originSessionId === originSessionId) {
-      matches.push(item);
-    } else {
-      remaining.push(item);
-    }
-  }
-
-  if (matches.length > 0) {
-    if (remaining.length === 0) {
-      try { fs.unlinkSync(getDispatchNotificationFile(corePath)); } catch {}
-    } else {
-      writeDispatchNotifications(remaining, corePath);
-    }
-  }
-
-  return matches;
-}
-
-module.exports = {
-  getDispatchNotificationFile,
-  readDispatchNotifications,
-  writeDispatchNotifications,
-  enqueueDispatchNotification,
-  takeDispatchNotifications,
-};