arcanea 3.3.0 → 3.4.0

package/dist/cli/index.js

@@ -2199,7 +2199,7 @@ var {
 } = import__.default;
 
 // src/cli/index.ts
-var import_picocolors2 = __toESM(require_picocolors(), 1);
+var import_picocolors3 = __toESM(require_picocolors(), 1);
 
 // src/install.ts
 var import_picocolors = __toESM(require_picocolors(), 1);
@@ -2323,6 +2323,8 @@ async function installForPlatform(targetDir, packageRoot, platform, force) {
 async function installClaudeCodeSettings(platformPath, force) {
   const settingsPath = join(platformPath, "settings.json");
   if (!existsSync(settingsPath) || force) {
+    const eventsDir = join(process.env.HOME || process.env.USERPROFILE || "~", ".arcanea").replace(/\\/g, "/");
+    const logScript = `mkdir -p "${eventsDir}" && echo '{"type":"agent-spawn","agent":"'$(echo "$TOOL_INPUT" 2>/dev/null | node -e "try{const d=JSON.parse(require('fs').readFileSync(0,'utf8'));process.stdout.write((d.subagent_type||'unknown')+'","description":"'+(d.description||'').replace(/"/g,'')+'","team":"'+(d.subagent_type||''))}catch{process.stdout.write('unknown","description":"","team":"')}" 2>/dev/null)","timestamp":'$(date +%s000)'}' >> "${eventsDir}/swarm-events.jsonl"`;
     const settings = {
       hooks: {
         UserPromptSubmit: [
@@ -2361,6 +2363,15 @@ async function installClaudeCodeSettings(platformPath, force) {
               command: "echo '[ARCANEA_MODE=ultrawork] Maximum parallel execution. Spawn all relevant agents simultaneously using Task tool with run_in_background=true.'"
             }]
           }
+        ],
+        PreToolUse: [
+          {
+            matcher: "Task",
+            hooks: [{
+              type: "command",
+              command: logScript
+            }]
+          }
         ]
       }
     };
@@ -2519,7 +2530,7 @@ function printSuccessMessage(platforms) {
 }
 
 // src/index.ts
-var VERSION = "3.3.0";
+var VERSION = "3.4.0";
 var NAME = "arcanea";
 var ORCHESTRATOR = "Arcanea";
 var defaultConfig = {
@@ -2645,15 +2656,379 @@ var AGENT_TEAMS = {
   }
 };
 
-// src/cli/index.ts
-import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2, statSync } from "fs";
+// src/viz/index.ts
+var import_picocolors2 = __toESM(require_picocolors(), 1);
+import { createServer } from "http";
+import { existsSync as existsSync2, readFileSync as readFileSync2, appendFileSync, mkdirSync as mkdirSync2, statSync } from "fs";
 import { join as join2 } from "path";
+import { execFile } from "child_process";
+var ARCANEA_DIR = join2(process.env.HOME || process.env.USERPROFILE || "~", ".arcanea");
+var EVENTS_FILE = join2(ARCANEA_DIR, "swarm-events.jsonl");
+function logEvent(event) {
+  mkdirSync2(ARCANEA_DIR, { recursive: true });
+  appendFileSync(EVENTS_FILE, JSON.stringify(event) + `
+`);
+}
+function readEvents() {
+  if (!existsSync2(EVENTS_FILE))
+    return [];
+  const content = readFileSync2(EVENTS_FILE, "utf-8").trim();
+  if (!content)
+    return [];
+  return content.split(`
+`).map((line) => {
+    try {
+      return JSON.parse(line);
+    } catch {
+      return null;
+    }
+  }).filter(Boolean);
+}
+var clients = new Set;
+function broadcast(event) {
+  const data = `data: ${JSON.stringify(event)}
+
+`;
+  for (const client of clients) {
+    try {
+      client.write(data);
+    } catch {
+      clients.delete(client);
+    }
+  }
+}
+function handleSSE(req, res) {
+  res.writeHead(200, {
+    "Content-Type": "text/event-stream",
+    "Cache-Control": "no-cache",
+    Connection: "keep-alive",
+    "Access-Control-Allow-Origin": "*"
+  });
+  clients.add(res);
+  req.on("close", () => clients.delete(res));
+  const events = readEvents();
+  res.write(`data: ${JSON.stringify({ type: "initial", events })}
+
+`);
+}
+function handleAPI(_req, res) {
+  const events = readEvents();
+  res.writeHead(200, { "Content-Type": "application/json" });
+  res.end(JSON.stringify({ events }));
+}
+function openBrowser(url) {
+  if (process.platform === "darwin") {
+    execFile("open", [url], () => {});
+  } else if (process.platform === "win32") {
+    execFile("cmd", ["/c", "start", url], () => {});
+  } else {
+    execFile("xdg-open", [url], () => {});
+  }
+}
+function getDashboardHTML() {
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Arcanea Swarm Viz</title>
+<style>
+*{margin:0;padding:0;box-sizing:border-box}
+:root{--bg:#0a0a1a;--surface:#111128;--border:#1e1e3a;--teal:#7fffd4;--gold:#ffd700;--blue:#78a6ff;
+--red:#ff4757;--text:#e0e0e0;--dim:#666;--green:#2ed573;--purple:#a855f7}
+body{background:var(--bg);color:var(--text);font-family:'Segoe UI',system-ui,sans-serif;min-height:100vh}
+.header{background:linear-gradient(135deg,#0d0d2b,#1a1a3e);border-bottom:1px solid var(--border);padding:16px 24px;display:flex;align-items:center;gap:16px}
+.header h1{font-size:20px;color:var(--teal);font-weight:600}
+.header .version{color:var(--dim);font-size:12px}
+.header .status{margin-left:auto;display:flex;align-items:center;gap:8px}
+.dot{width:8px;height:8px;border-radius:50%;background:var(--green);animation:pulse 2s infinite}
+@keyframes pulse{0%,100%{opacity:1}50%{opacity:0.4}}
+.stats{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:12px;padding:16px 24px}
+.stat{background:var(--surface);border:1px solid var(--border);border-radius:8px;padding:16px;text-align:center}
+.stat .label{font-size:11px;color:var(--dim);text-transform:uppercase;letter-spacing:1px;margin-bottom:4px}
+.stat .value{font-size:28px;font-weight:700;color:var(--teal)}
+.stat .value.gold{color:var(--gold)}
+.stat .value.blue{color:var(--blue)}
+.main{display:grid;grid-template-columns:1fr 300px;gap:16px;padding:0 24px 24px;height:calc(100vh - 200px)}
+.events{background:var(--surface);border:1px solid var(--border);border-radius:8px;overflow:hidden;display:flex;flex-direction:column}
+.events .title{padding:12px 16px;border-bottom:1px solid var(--border);font-size:13px;font-weight:600;display:flex;align-items:center;gap:8px}
+.events .title .count{color:var(--dim);font-weight:400}
+.event-list{flex:1;overflow-y:auto;padding:8px}
+.event{padding:8px 12px;border-radius:6px;margin-bottom:4px;font-size:13px;display:flex;align-items:flex-start;gap:8px;animation:fadeIn 0.3s ease}
+@keyframes fadeIn{from{opacity:0;transform:translateY(-4px)}to{opacity:1;transform:translateY(0)}}
+.event .time{color:var(--dim);font-size:11px;min-width:60px;font-family:monospace}
+.event .badge{padding:2px 6px;border-radius:4px;font-size:10px;font-weight:600;text-transform:uppercase}
+.badge-spawn{background:#7fffd420;color:var(--teal)}
+.badge-complete{background:#2ed57320;color:var(--green)}
+.badge-error{background:#ff475720;color:var(--red)}
+.badge-magic{background:#ffd70020;color:var(--gold)}
+.event .desc{flex:1;word-break:break-word}
+.event .agent-name{color:var(--blue);font-weight:500}
+.event .dur{color:var(--dim);font-size:11px;font-family:monospace}
+.sidebar{display:flex;flex-direction:column;gap:12px}
+.panel{background:var(--surface);border:1px solid var(--border);border-radius:8px;padding:12px 16px}
+.panel .title{font-size:13px;font-weight:600;margin-bottom:12px}
+.bar-row{display:flex;align-items:center;gap:8px;margin-bottom:8px;font-size:12px}
+.bar-label{min-width:80px;color:var(--dim)}
+.bar-track{flex:1;height:8px;background:var(--bg);border-radius:4px;overflow:hidden}
+.bar-fill{height:100%;border-radius:4px;transition:width 0.5s ease}
+.fill-creative{background:var(--teal)}.fill-coding{background:var(--blue)}.fill-writing{background:var(--green)}
+.fill-research{background:var(--gold)}.fill-production{background:var(--purple)}.fill-development{background:var(--blue)}
+.fill-teacher{background:#ff6b81}.fill-visionary{background:var(--gold)}.fill-default{background:var(--teal)}
+.bar-value{min-width:30px;text-align:right;font-family:monospace;color:var(--dim)}
+.timing{font-family:monospace;font-size:13px}
+.timing .row{display:flex;justify-content:space-between;padding:4px 0;border-bottom:1px solid var(--border)}
+.timing .row:last-child{border:none}
+.timing .label{color:var(--dim)}
+.timing .val{color:var(--teal)}
+.empty{text-align:center;padding:60px 20px;color:var(--dim)}
+.empty h3{color:var(--teal);margin-bottom:12px;font-size:16px}
+.empty p{font-size:13px;max-width:400px;margin:0 auto;line-height:1.6}
+.empty code{background:var(--bg);padding:2px 6px;border-radius:4px;font-size:12px;color:var(--gold)}
+</style>
+</head>
+<body>
+<div class="header">
+  <h1>Arcanea Swarm Viz</h1>
+  <span class="version">v${VERSION}</span>
+  <div class="status">
+    <span class="dot" id="statusDot"></span>
+    <span id="statusText" style="font-size:12px;color:var(--dim)">Connecting...</span>
+  </div>
+</div>
+<div class="stats">
+  <div class="stat"><div class="label">Total Spawns</div><div class="value" id="statTotal">0</div></div>
+  <div class="stat"><div class="label">Active Now</div><div class="value gold" id="statActive">0</div></div>
+  <div class="stat"><div class="label">Success Rate</div><div class="value blue" id="statSuccess">-</div></div>
+  <div class="stat"><div class="label">Avg Duration</div><div class="value" id="statAvg">-</div></div>
+</div>
+<div class="main">
+  <div class="events">
+    <div class="title">Live Event Feed <span class="count" id="eventCount">(0 events)</span></div>
+    <div class="event-list" id="eventList"></div>
+  </div>
+  <div class="sidebar">
+    <div class="panel"><div class="title">Team Utilization</div><div id="teamBars"></div></div>
+    <div class="panel">
+      <div class="title">Timing (ms)</div>
+      <div class="timing">
+        <div class="row"><span class="label">Avg</span><span class="val" id="timAvg">-</span></div>
+        <div class="row"><span class="label">P50</span><span class="val" id="timP50">-</span></div>
+        <div class="row"><span class="label">P95</span><span class="val" id="timP95">-</span></div>
+      </div>
+    </div>
+    <div class="panel"><div class="title">Top Agents</div><div id="agentList" style="font-size:12px"></div></div>
+  </div>
+</div>
+<script>
+// Uses safe DOM methods (createElement, textContent) — no innerHTML with untrusted data
+let allEvents = [];
+const fillClasses = {creative:'fill-creative',coding:'fill-coding',writing:'fill-writing',research:'fill-research',production:'fill-production',development:'fill-development',teacher:'fill-teacher',visionary:'fill-visionary'};
+
+function fmtTime(ts) {
+  return new Date(ts).toLocaleTimeString('en-US',{hour12:false,hour:'2-digit',minute:'2-digit',second:'2-digit'});
+}
+function fmtDur(ms) {
+  if (!ms) return '';
+  return ms < 1000 ? ms+'ms' : (ms/1000).toFixed(1)+'s';
+}
+
+function mkEl(tag, cls, text) {
+  const el = document.createElement(tag);
+  if (cls) el.className = cls;
+  if (text) el.textContent = text;
+  return el;
+}
+
+function showEmpty() {
+  const list = document.getElementById('eventList');
+  list.textContent = '';
+  const d = mkEl('div','empty');
+  const h = mkEl('h3',null,'Waiting for agent activity...');
+  const p = mkEl('p',null,'Events appear here as agents spawn and complete. Use ultraworld or ultracode in Claude Code.');
+  d.appendChild(h); d.appendChild(p);
+  list.appendChild(d);
+}
+
+function addEvent(event) {
+  const list = document.getElementById('eventList');
+  const empty = list.querySelector('.empty');
+  if (empty) empty.remove();
+
+  const el = mkEl('div','event');
+  el.appendChild(mkEl('span','time',fmtTime(event.timestamp)));
+
+  const badgeCls = event.type==='agent-spawn'?'badge badge-spawn':
+                   event.type==='agent-complete'?'badge badge-complete':
+                   event.type==='agent-error'?'badge badge-error':'badge badge-magic';
+  const badgeTxt = event.type==='agent-spawn'?'SPAWN':
+                   event.type==='agent-complete'?'DONE':
+                   event.type==='agent-error'?'ERR':'MAGIC';
+  el.appendChild(mkEl('span',badgeCls,badgeTxt));
+  if (event.agent) el.appendChild(mkEl('span','agent-name',event.agent));
+  if (event.description) el.appendChild(mkEl('span','desc',event.description));
+  if (event.durationMs) el.appendChild(mkEl('span','dur',fmtDur(event.durationMs)));
+
+  list.appendChild(el);
+  list.scrollTop = list.scrollHeight;
+}
+
+function updateStats() {
+  const spawns = allEvents.filter(e=>e.type==='agent-spawn');
+  const completes = allEvents.filter(e=>e.type==='agent-complete');
+  const errors = allEvents.filter(e=>e.type==='agent-error');
+  const durs = completes.filter(e=>e.durationMs).map(e=>e.durationMs).sort((a,b)=>a-b);
+
+  document.getElementById('statTotal').textContent = spawns.length;
+  document.getElementById('statActive').textContent = Math.max(0,spawns.length-completes.length-errors.length);
+  document.getElementById('statSuccess').textContent = spawns.length>0?((completes.length/spawns.length)*100).toFixed(0)+'%':'-';
+  document.getElementById('statAvg').textContent = durs.length>0?fmtDur(Math.round(durs.reduce((a,b)=>a+b,0)/durs.length)):'-';
+  document.getElementById('timAvg').textContent = durs.length>0?Math.round(durs.reduce((a,b)=>a+b,0)/durs.length):'-';
+  document.getElementById('timP50').textContent = durs.length>0?durs[Math.floor(durs.length*0.5)]:'-';
+  document.getElementById('timP95').textContent = durs.length>0?durs[Math.floor(durs.length*0.95)]:'-';
+  document.getElementById('eventCount').textContent = '('+allEvents.length+' events)';
+
+  // Team bars — built with safe DOM methods
+  const teams = {};
+  const total = (spawns.length+completes.length)||1;
+  for (const e of [...spawns,...completes]) if(e.team) teams[e.team]=(teams[e.team]||0)+1;
+  const barsEl = document.getElementById('teamBars');
+  barsEl.textContent = '';
+  for (const [team,count] of Object.entries(teams).sort((a,b)=>b[1]-a[1])) {
+    const pct = ((count/total)*100).toFixed(0);
+    const row = mkEl('div','bar-row');
+    row.appendChild(mkEl('span','bar-label',team));
+    const track = mkEl('div','bar-track');
+    const fill = mkEl('div','bar-fill '+(fillClasses[team]||'fill-default'));
+    fill.style.width = pct+'%';
+    track.appendChild(fill);
+    row.appendChild(track);
+    row.appendChild(mkEl('span','bar-value',String(count)));
+    barsEl.appendChild(row);
+  }
+
+  // Agent list
+  const agents = {};
+  for (const e of [...spawns,...completes]) if(e.agent) agents[e.agent]=(agents[e.agent]||0)+1;
+  const agentEl = document.getElementById('agentList');
+  agentEl.textContent = '';
+  for (const [agent,count] of Object.entries(agents).sort((a,b)=>b[1]-a[1]).slice(0,8)) {
+    const row = mkEl('div','bar-row');
+    row.appendChild(mkEl('span','bar-label',agent));
+    const val = mkEl('span','bar-value',String(count));
+    val.style.color = 'var(--teal)';
+    row.appendChild(val);
+    agentEl.appendChild(row);
+  }
+}
+
+function connect() {
+  const es = new EventSource('/stream');
+  es.onmessage = function(e) {
+    const data = JSON.parse(e.data);
+    if (data.type==='initial') {
+      allEvents = data.events||[];
+      document.getElementById('eventList').textContent = '';
+      if (allEvents.length===0) showEmpty();
+      else for (const ev of allEvents.slice(-100)) addEvent(ev);
+      updateStats();
+    } else {
+      allEvents.push(data);
+      addEvent(data);
+      updateStats();
+    }
+  };
+  es.onopen = function() {
+    document.getElementById('statusDot').style.background='var(--green)';
+    document.getElementById('statusText').textContent='Connected';
+  };
+  es.onerror = function() {
+    document.getElementById('statusDot').style.background='var(--red)';
+    document.getElementById('statusText').textContent='Reconnecting...';
+    es.close();
+    setTimeout(connect,3000);
+  };
+}
+connect();
+</script>
+</body>
+</html>`;
+}
+function startVizServer(port = 3737) {
+  mkdirSync2(ARCANEA_DIR, { recursive: true });
+  let lastSize = 0;
+  try {
+    lastSize = existsSync2(EVENTS_FILE) ? statSync(EVENTS_FILE).size : 0;
+  } catch {}
+  const server = createServer((req, res) => {
+    if (req.url === "/stream") {
+      handleSSE(req, res);
+    } else if (req.url === "/api/events") {
+      handleAPI(req, res);
+    } else if (req.url === "/api/test-event" && req.method === "POST") {
+      let body = "";
+      req.on("data", (chunk) => {
+        body += chunk.toString();
+      });
+      req.on("end", () => {
+        try {
+          const event = JSON.parse(body);
+          event.timestamp = event.timestamp || Date.now();
+          logEvent(event);
+          res.writeHead(200, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ ok: true }));
+        } catch {
+          res.writeHead(400);
+          res.end("Invalid JSON");
+        }
+      });
+    } else {
+      res.writeHead(200, { "Content-Type": "text/html" });
+      res.end(getDashboardHTML());
+    }
+  });
+  const pollInterval = setInterval(() => {
+    try {
+      if (!existsSync2(EVENTS_FILE))
+        return;
+      const currentSize = statSync(EVENTS_FILE).size;
+      if (currentSize > lastSize) {
+        const content = readFileSync2(EVENTS_FILE, "utf-8");
+        const newContent = content.slice(lastSize);
+        lastSize = currentSize;
+        for (const line of newContent.trim().split(`
+`)) {
+          if (!line)
+            continue;
+          try {
+            broadcast(JSON.parse(line));
+          } catch {}
+        }
+      }
+    } catch {}
+  }, 500);
+  server.on("close", () => clearInterval(pollInterval));
+  server.listen(port, () => {
+    console.log(import_picocolors2.default.cyan(`
+Arcanea Swarm Viz v${VERSION}`));
+    console.log(import_picocolors2.default.green(`Dashboard: http://localhost:${port}`));
+    console.log(import_picocolors2.default.dim(`Events log: ${EVENTS_FILE}`));
+    console.log(import_picocolors2.default.dim(`SSE stream: http://localhost:${port}/stream`));
+    console.log(import_picocolors2.default.dim(`Press Ctrl+C to stop
+`));
+    openBrowser(`http://localhost:${port}`);
+  });
+}
+
+// src/cli/index.ts
+import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
+import { join as join3 } from "path";
 function countMdFiles(dir) {
   let count = 0;
   for (const entry of readdirSync(dir)) {
-    const full = join2(dir, entry);
+    const full = join3(dir, entry);
     try {
-      if (statSync(full).isDirectory()) {
+      if (statSync2(full).isDirectory()) {
         count += countMdFiles(full);
       } else if (entry.endsWith(".md")) {
         count++;
@@ -2686,90 +3061,90 @@ program2.command("install").description("Initialize Arcanea in current project")
   });
 });
 program2.command("detect").description("Detect available AI coding platforms").action(() => {
-  console.log(import_picocolors2.default.cyan(`
+  console.log(import_picocolors3.default.cyan(`
 ${ORCHESTRATOR} Platform Detection
 `));
   const platforms = detectPlatforms();
   if (platforms.length === 0) {
-    console.log(import_picocolors2.default.yellow("No platforms detected. Will install for Claude Code and OpenCode by default."));
+    console.log(import_picocolors3.default.yellow("No platforms detected. Will install for Claude Code and OpenCode by default."));
   } else {
-    console.log(import_picocolors2.default.bold("Detected platforms:"));
+    console.log(import_picocolors3.default.bold("Detected platforms:"));
     for (const platform of platforms) {
-      console.log(import_picocolors2.default.green(`  ✓ ${platform}`));
+      console.log(import_picocolors3.default.green(`  ✓ ${platform}`));
     }
   }
   console.log();
 });
 program2.command("agents").description("List available agent teams").option("-t, --team <team>", "Show specific team details").action((options) => {
-  console.log(import_picocolors2.default.cyan(`
+  console.log(import_picocolors3.default.cyan(`
 ${ORCHESTRATOR}'s Agent Teams
 `));
   if (options.team) {
     const team = AGENT_TEAMS[options.team];
     if (team) {
-      console.log(import_picocolors2.default.bold(team.name));
-      console.log(import_picocolors2.default.dim(team.description));
+      console.log(import_picocolors3.default.bold(team.name));
+      console.log(import_picocolors3.default.dim(team.description));
       console.log();
       console.log("  Agents:", team.agents.join(", "));
     } else {
-      console.log(import_picocolors2.default.red(`Unknown team: ${options.team}`));
+      console.log(import_picocolors3.default.red(`Unknown team: ${options.team}`));
       console.log("Available teams:", Object.keys(AGENT_TEAMS).join(", "));
     }
     return;
   }
   for (const [key, team] of Object.entries(AGENT_TEAMS)) {
     const colors = {
-      creative: import_picocolors2.default.blue,
-      writing: import_picocolors2.default.green,
-      production: import_picocolors2.default.magenta,
-      research: import_picocolors2.default.yellow,
-      development: import_picocolors2.default.cyan,
-      teacher: import_picocolors2.default.dim,
-      visionary: import_picocolors2.default.dim
+      creative: import_picocolors3.default.blue,
+      writing: import_picocolors3.default.green,
+      production: import_picocolors3.default.magenta,
+      research: import_picocolors3.default.yellow,
+      development: import_picocolors3.default.cyan,
+      teacher: import_picocolors3.default.dim,
+      visionary: import_picocolors3.default.dim
     };
-    const colorFn = colors[key] || import_picocolors2.default.white;
-    console.log(colorFn(import_picocolors2.default.bold(team.name + ":")));
+    const colorFn = colors[key] || import_picocolors3.default.white;
+    console.log(colorFn(import_picocolors3.default.bold(team.name + ":")));
     console.log(`  ${team.agents.join(", ")}`);
     console.log();
   }
 });
 program2.command("luminors").description("Show the Seven Luminors").action(() => {
-  console.log(import_picocolors2.default.cyan(`
+  console.log(import_picocolors3.default.cyan(`
 The Seven Luminors
 `));
-  console.log(import_picocolors2.default.dim(`Aspects of creative consciousness itself
+  console.log(import_picocolors3.default.dim(`Aspects of creative consciousness itself
 `));
   for (const [_, luminor] of Object.entries(LUMINORS)) {
-    console.log(import_picocolors2.default.bold(import_picocolors2.default.yellow(`${luminor.name}`)) + ` - ${luminor.domain}`);
-    console.log(import_picocolors2.default.dim(`  When: ${luminor.when}`));
+    console.log(import_picocolors3.default.bold(import_picocolors3.default.yellow(`${luminor.name}`)) + ` - ${luminor.domain}`);
+    console.log(import_picocolors3.default.dim(`  When: ${luminor.when}`));
     console.log();
   }
-  console.log(import_picocolors2.default.dim("Channel a Luminor: /luminor [name] [challenge]"));
+  console.log(import_picocolors3.default.dim("Channel a Luminor: /luminor [name] [challenge]"));
   console.log();
 });
 program2.command("magic").description("Show magic words and their effects").action(() => {
-  console.log(import_picocolors2.default.cyan(`
+  console.log(import_picocolors3.default.cyan(`
 Magic Words
 `));
-  console.log(import_picocolors2.default.bold("Creative Magic:"));
-  console.log(import_picocolors2.default.bold(import_picocolors2.default.cyan("  ultraworld")) + " (or ulw)  — Fire ALL world-building agents in parallel");
-  console.log(import_picocolors2.default.bold(import_picocolors2.default.green("  ultrawrite")) + " (or ulwr) — Fire ALL writing/editing agents in parallel");
-  console.log(import_picocolors2.default.bold(import_picocolors2.default.magenta("  ultrabook")) + "  (or ulb)  — Complete book pipeline end-to-end");
+  console.log(import_picocolors3.default.bold("Creative Magic:"));
+  console.log(import_picocolors3.default.bold(import_picocolors3.default.cyan("  ultraworld")) + " (or ulw)  — Fire ALL world-building agents in parallel");
+  console.log(import_picocolors3.default.bold(import_picocolors3.default.green("  ultrawrite")) + " (or ulwr) — Fire ALL writing/editing agents in parallel");
+  console.log(import_picocolors3.default.bold(import_picocolors3.default.magenta("  ultrabook")) + "  (or ulb)  — Complete book pipeline end-to-end");
   console.log();
-  console.log(import_picocolors2.default.bold("Technical Magic:"));
-  console.log(import_picocolors2.default.bold(import_picocolors2.default.yellow("  ultracode")) + " (or ulc)  — Fire ALL coding agents (architect + coder + reviewer)");
-  console.log(import_picocolors2.default.bold(import_picocolors2.default.cyan("  ultrawork")) + " (or ulwk) — Maximum parallel execution for ANY task");
+  console.log(import_picocolors3.default.bold("Technical Magic:"));
+  console.log(import_picocolors3.default.bold(import_picocolors3.default.yellow("  ultracode")) + " (or ulc)  — Fire ALL coding agents (architect + coder + reviewer)");
+  console.log(import_picocolors3.default.bold(import_picocolors3.default.cyan("  ultrawork")) + " (or ulwk) — Maximum parallel execution for ANY task");
   console.log();
-  console.log(import_picocolors2.default.bold("Prefix Triggers:"));
-  console.log(import_picocolors2.default.dim("  arcanea: [task]") + "  — Invoke Arcanea's highest intelligence mode");
-  console.log(import_picocolors2.default.dim("  luminor: [task]") + "  — Apply Luminor wisdom to the task");
+  console.log(import_picocolors3.default.bold("Prefix Triggers:"));
+  console.log(import_picocolors3.default.dim("  arcanea: [task]") + "  — Invoke Arcanea's highest intelligence mode");
+  console.log(import_picocolors3.default.dim("  luminor: [task]") + "  — Apply Luminor wisdom to the task");
   console.log();
-  console.log(import_picocolors2.default.dim("Include any magic word in your prompt to activate!"));
+  console.log(import_picocolors3.default.dim("Include any magic word in your prompt to activate!"));
   console.log();
 });
 program2.command("status").description("Check Arcanea installation status").action(() => {
   const cwd = process.cwd();
-  console.log(import_picocolors2.default.cyan(`
+  console.log(import_picocolors3.default.cyan(`
 ${ORCHESTRATOR} Status
 `));
   const platformChecks = [
@@ -2779,32 +3154,32 @@ ${ORCHESTRATOR} Status
     { path: ".codex", name: "Codex" },
     { path: ".gemini", name: "Gemini CLI" }
   ];
-  console.log(import_picocolors2.default.bold("Platform installations:"));
+  console.log(import_picocolors3.default.bold("Platform installations:"));
   for (const check of platformChecks) {
-    const agentsPath = join2(cwd, check.path, "agents");
-    const exists = existsSync2(agentsPath);
-    const status = exists ? import_picocolors2.default.green("✓") : import_picocolors2.default.dim("○");
+    const agentsPath = join3(cwd, check.path, "agents");
+    const exists = existsSync3(agentsPath);
+    const status = exists ? import_picocolors3.default.green("✓") : import_picocolors3.default.dim("○");
     console.log(`  ${status} ${check.name}`);
   }
   console.log();
-  console.log(import_picocolors2.default.bold("Configuration:"));
+  console.log(import_picocolors3.default.bold("Configuration:"));
   const configChecks = [
     { path: "arcanea.json", name: "Arcanea config" },
     { path: ".mcp.json", name: "MCP config" }
   ];
   let allGood = true;
   for (const check of configChecks) {
-    const exists = existsSync2(join2(cwd, check.path));
-    const status = exists ? import_picocolors2.default.green("✓") : import_picocolors2.default.red("✗");
+    const exists = existsSync3(join3(cwd, check.path));
+    const status = exists ? import_picocolors3.default.green("✓") : import_picocolors3.default.red("✗");
     console.log(`  ${status} ${check.name}`);
     if (!exists)
       allGood = false;
   }
   console.log();
   if (allGood) {
-    console.log(import_picocolors2.default.green("Arcanea is ready!"));
+    console.log(import_picocolors3.default.green("Arcanea is ready!"));
   } else {
-    console.log(import_picocolors2.default.yellow("Run 'arcanea install' to complete setup."));
+    console.log(import_picocolors3.default.yellow("Run 'arcanea install' to complete setup."));
   }
   console.log();
 });
@@ -2812,74 +3187,74 @@ program2.command("doctor").description("Diagnose Arcanea installation health").a
   const cwd = process.cwd();
   let issues = 0;
   let ok = 0;
-  console.log(import_picocolors2.default.cyan(`
+  console.log(import_picocolors3.default.cyan(`
 ${ORCHESTRATOR} Doctor (v${VERSION})
 `));
-  console.log(import_picocolors2.default.bold(`Checking installation health...
+  console.log(import_picocolors3.default.bold(`Checking installation health...
 `));
   const claudePaths = [
-    join2(cwd, ".claude", "CLAUDE.md"),
-    join2(cwd, ".opencode", "CLAUDE.md"),
-    join2(cwd, "CLAUDE.md")
+    join3(cwd, ".claude", "CLAUDE.md"),
+    join3(cwd, ".opencode", "CLAUDE.md"),
+    join3(cwd, "CLAUDE.md")
   ];
-  const hasClaudeMd = claudePaths.some((p) => existsSync2(p));
+  const hasClaudeMd = claudePaths.some((p) => existsSync3(p));
   if (hasClaudeMd) {
-    console.log(import_picocolors2.default.green("  ✓ CLAUDE.md found (Arcanea identity active)"));
+    console.log(import_picocolors3.default.green("  ✓ CLAUDE.md found (Arcanea identity active)"));
     ok++;
   } else {
-    console.log(import_picocolors2.default.red("  ✗ No CLAUDE.md found — run 'arcanea install' to fix"));
+    console.log(import_picocolors3.default.red("  ✗ No CLAUDE.md found — run 'arcanea install' to fix"));
     issues++;
   }
   const agentPaths = [".claude/agents", ".opencode/agents"];
   const hasAgents = agentPaths.some((p) => {
-    const full = join2(cwd, p);
-    return existsSync2(full) && readdirSync(full).length > 0;
+    const full = join3(cwd, p);
+    return existsSync3(full) && readdirSync(full).length > 0;
   });
   if (hasAgents) {
-    const agentDir = agentPaths.find((p) => existsSync2(join2(cwd, p)));
-    const count = countMdFiles(join2(cwd, agentDir));
-    console.log(import_picocolors2.default.green(`  ✓ ${count} agent definitions installed`));
+    const agentDir = agentPaths.find((p) => existsSync3(join3(cwd, p)));
+    const count = countMdFiles(join3(cwd, agentDir));
+    console.log(import_picocolors3.default.green(`  ✓ ${count} agent definitions installed`));
     ok++;
   } else {
-    console.log(import_picocolors2.default.red("  ✗ No agents installed — run 'arcanea install --force'"));
+    console.log(import_picocolors3.default.red("  ✗ No agents installed — run 'arcanea install --force'"));
     issues++;
   }
   const skillPaths = [".claude/skills", ".opencode/skills"];
   const hasSkills = skillPaths.some((p) => {
-    const full = join2(cwd, p);
-    return existsSync2(full) && readdirSync(full).length > 0;
+    const full = join3(cwd, p);
+    return existsSync3(full) && readdirSync(full).length > 0;
   });
   if (hasSkills) {
-    console.log(import_picocolors2.default.green("  ✓ Skills installed"));
+    console.log(import_picocolors3.default.green("  ✓ Skills installed"));
     ok++;
   } else {
-    console.log(import_picocolors2.default.red("  ✗ No skills installed — run 'arcanea install --force'"));
+    console.log(import_picocolors3.default.red("  ✗ No skills installed — run 'arcanea install --force'"));
     issues++;
   }
-  const mcpPath = join2(cwd, ".mcp.json");
-  if (existsSync2(mcpPath)) {
+  const mcpPath = join3(cwd, ".mcp.json");
+  if (existsSync3(mcpPath)) {
     try {
-      const mcp = JSON.parse(readFileSync2(mcpPath, "utf-8"));
+      const mcp = JSON.parse(readFileSync3(mcpPath, "utf-8"));
       const servers = Object.keys(mcp.mcpServers || {});
       const hasArcanea = servers.includes("arcanea");
-      console.log(import_picocolors2.default.green(`  ✓ MCP config: ${servers.length} servers configured`));
+      console.log(import_picocolors3.default.green(`  ✓ MCP config: ${servers.length} servers configured`));
       if (!hasArcanea) {
-        console.log(import_picocolors2.default.yellow("    ⚠ Arcanea MCP server not configured — run 'arcanea install --force'"));
+        console.log(import_picocolors3.default.yellow("    ⚠ Arcanea MCP server not configured — run 'arcanea install --force'"));
       }
       ok++;
     } catch {
-      console.log(import_picocolors2.default.red("  ✗ .mcp.json is invalid JSON"));
+      console.log(import_picocolors3.default.red("  ✗ .mcp.json is invalid JSON"));
       issues++;
     }
   } else {
-    console.log(import_picocolors2.default.red("  ✗ No .mcp.json — run 'arcanea install'"));
+    console.log(import_picocolors3.default.red("  ✗ No .mcp.json — run 'arcanea install'"));
     issues++;
   }
-  if (existsSync2(join2(cwd, "arcanea.json"))) {
-    console.log(import_picocolors2.default.green("  ✓ arcanea.json config exists"));
+  if (existsSync3(join3(cwd, "arcanea.json"))) {
+    console.log(import_picocolors3.default.green("  ✓ arcanea.json config exists"));
     ok++;
   } else {
-    console.log(import_picocolors2.default.yellow("  ○ No arcanea.json (optional)"));
+    console.log(import_picocolors3.default.yellow("  ○ No arcanea.json (optional)"));
   }
   const platformFiles = [
     { path: ".cursorrules", name: "Cursor (.cursorrules)" },
@@ -2887,19 +3262,22 @@ ${ORCHESTRATOR} Doctor (v${VERSION})
     { path: "GEMINI.md", name: "Gemini CLI (GEMINI.md)" }
   ];
   for (const pf of platformFiles) {
-    if (existsSync2(join2(cwd, pf.path))) {
-      console.log(import_picocolors2.default.green(`  ✓ ${pf.name} configured`));
+    if (existsSync3(join3(cwd, pf.path))) {
+      console.log(import_picocolors3.default.green(`  ✓ ${pf.name} configured`));
       ok++;
     }
   }
   console.log();
   if (issues === 0) {
-    console.log(import_picocolors2.default.green(import_picocolors2.default.bold(`Health: ${ok} checks passed, 0 issues`)));
-    console.log(import_picocolors2.default.green("Arcanea is fully operational!"));
+    console.log(import_picocolors3.default.green(import_picocolors3.default.bold(`Health: ${ok} checks passed, 0 issues`)));
+    console.log(import_picocolors3.default.green("Arcanea is fully operational!"));
   } else {
-    console.log(import_picocolors2.default.yellow(import_picocolors2.default.bold(`Health: ${ok} passed, ${issues} issues found`)));
-    console.log(import_picocolors2.default.dim("Run 'arcanea install --force' to fix issues."));
+    console.log(import_picocolors3.default.yellow(import_picocolors3.default.bold(`Health: ${ok} passed, ${issues} issues found`)));
+    console.log(import_picocolors3.default.dim("Run 'arcanea install --force' to fix issues."));
   }
   console.log();
 });
+program2.command("viz").description("Launch real-time swarm visualization dashboard").option("-p, --port <port>", "Server port", "3737").option("--no-open", "Don't auto-open browser").action((options) => {
+  startVizServer(parseInt(options.port, 10));
+});
 program2.parse();

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "3.3.0";
+export declare const VERSION = "3.4.0";
 export declare const NAME = "arcanea";
 export declare const ORCHESTRATOR = "Arcanea";
 export type Platform = "claude-code" | "opencode" | "codex" | "gemini" | "cursor" | "unknown";

package/dist/index.js

@@ -208,6 +208,8 @@ async function installForPlatform(targetDir, packageRoot, platform, force) {
 async function installClaudeCodeSettings(platformPath, force) {
   const settingsPath = join(platformPath, "settings.json");
   if (!existsSync(settingsPath) || force) {
+    const eventsDir = join(process.env.HOME || process.env.USERPROFILE || "~", ".arcanea").replace(/\\/g, "/");
+    const logScript = `mkdir -p "${eventsDir}" && echo '{"type":"agent-spawn","agent":"'$(echo "$TOOL_INPUT" 2>/dev/null | node -e "try{const d=JSON.parse(require('fs').readFileSync(0,'utf8'));process.stdout.write((d.subagent_type||'unknown')+'","description":"'+(d.description||'').replace(/"/g,'')+'","team":"'+(d.subagent_type||''))}catch{process.stdout.write('unknown","description":"","team":"')}" 2>/dev/null)","timestamp":'$(date +%s000)'}' >> "${eventsDir}/swarm-events.jsonl"`;
     const settings = {
       hooks: {
         UserPromptSubmit: [
@@ -246,6 +248,15 @@ async function installClaudeCodeSettings(platformPath, force) {
               command: "echo '[ARCANEA_MODE=ultrawork] Maximum parallel execution. Spawn all relevant agents simultaneously using Task tool with run_in_background=true.'"
             }]
           }
+        ],
+        PreToolUse: [
+          {
+            matcher: "Task",
+            hooks: [{
+              type: "command",
+              command: logScript
+            }]
+          }
         ]
       }
     };
@@ -404,7 +415,7 @@ function printSuccessMessage(platforms) {
 }
 
 // src/index.ts
-var VERSION = "3.3.0";
+var VERSION = "3.4.0";
 var NAME = "arcanea";
 var ORCHESTRATOR = "Arcanea";
 var defaultConfig = {

package/dist/viz/index.d.ts

@@ -0,0 +1,13 @@
+export interface SwarmEvent {
+    type: "agent-spawn" | "agent-complete" | "agent-error" | "magic-word" | "session-start";
+    agent?: string;
+    team?: string;
+    description?: string;
+    status?: "running" | "complete" | "error";
+    durationMs?: number;
+    timestamp: number;
+    meta?: Record<string, unknown>;
+}
+export declare function logEvent(event: SwarmEvent): void;
+export declare function startVizServer(port?: number): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/viz/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/viz/index.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,aAAa,GAAG,gBAAgB,GAAG,aAAa,GAAG,YAAY,GAAG,eAAe,CAAC;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAGhD;AA2RD,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAAa,GAAG,IAAI,CA2DxD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcanea",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "Arcanea - The Creative Intelligence Platform. Skills, agents, and tools for AI-human co-creation.",
   "type": "module",
   "main": "dist/index.js",