arcanea 3.2.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);
@@ -2314,11 +2314,17 @@ async function installForPlatform(targetDir, packageRoot, platform, force) {
     await installClaudeCodeSettings(platformPath, force);
   } else if (platform === "cursor") {
     await installCursorRules(targetDir, packageRoot, force);
+  } else if (platform === "codex") {
+    await installCodexConfig(targetDir, packageRoot, force);
+  } else if (platform === "gemini") {
+    await installGeminiConfig(targetDir, packageRoot, 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: [
@@ -2357,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
+            }]
+          }
         ]
       }
     };
@@ -2378,6 +2393,64 @@ ${claudeContent}`;
     }
   }
 }
+async function installCodexConfig(targetDir, packageRoot, force) {
+  const codexMdPath = join(targetDir, "codex.md");
+  if (!existsSync(codexMdPath) || force) {
+    const claudeMdSource = join(packageRoot, "CLAUDE.md");
+    if (existsSync(claudeMdSource)) {
+      const content = readFileSync(claudeMdSource, "utf-8");
+      const codexMd = [
+        `# Codex Instructions — Generated by Arcanea v${VERSION}`,
+        "",
+        "> These instructions transform Codex into Arcanea, the Creative Intelligence Platform.",
+        "> Agent definitions: `.codex/agents/` | Skills: `.codex/skills/` | Commands: `.codex/commands/`",
+        "",
+        content,
+        "",
+        "## Codex-Specific Notes",
+        "",
+        "- Read agent definitions from `.codex/agents/` for available specialist agents",
+        "- Read skill definitions from `.codex/skills/` for creative and technical skills",
+        "- Read command definitions from `.codex/commands/` for slash commands",
+        "- MCP servers are configured in `.mcp.json`",
+        "- When magic words (ultraworld, ultracode, etc.) are used, read the relevant agent files and apply their instructions",
+        ""
+      ].join(`
+`);
+      writeFileSync(codexMdPath, codexMd);
+      console.log(import_picocolors.default.green("  ✓ Created codex.md (Arcanea instructions for Codex CLI)"));
+    }
+  }
+}
+async function installGeminiConfig(targetDir, packageRoot, force) {
+  const geminiMdPath = join(targetDir, "GEMINI.md");
+  if (!existsSync(geminiMdPath) || force) {
+    const claudeMdSource = join(packageRoot, "CLAUDE.md");
+    if (existsSync(claudeMdSource)) {
+      const content = readFileSync(claudeMdSource, "utf-8");
+      const geminiMd = [
+        `# Gemini Instructions — Generated by Arcanea v${VERSION}`,
+        "",
+        "> These instructions transform Gemini into Arcanea, the Creative Intelligence Platform.",
+        "> Agent definitions: `.gemini/agents/` | Skills: `.gemini/skills/` | Commands: `.gemini/commands/`",
+        "",
+        content,
+        "",
+        "## Gemini-Specific Notes",
+        "",
+        "- Read agent definitions from `.gemini/agents/` for available specialist agents",
+        "- Read skill definitions from `.gemini/skills/` for creative and technical skills",
+        "- Read command definitions from `.gemini/commands/` for slash commands",
+        "- MCP servers are configured in `.mcp.json`",
+        "- When magic words (ultraworld, ultracode, etc.) are used, read the relevant agent files and apply their instructions",
+        ""
+      ].join(`
+`);
+      writeFileSync(geminiMdPath, geminiMd);
+      console.log(import_picocolors.default.green("  ✓ Created GEMINI.md (Arcanea instructions for Gemini CLI)"));
+    }
+  }
+}
 async function installMcpConfig(targetDir, force) {
   const mcpPath = join(targetDir, ".mcp.json");
   console.log(import_picocolors.default.blue(`
@@ -2457,7 +2530,7 @@ function printSuccessMessage(platforms) {
 }
 
 // src/index.ts
-var VERSION = "3.2.0";
+var VERSION = "3.4.0";
 var NAME = "arcanea";
 var ORCHESTRATOR = "Arcanea";
 var defaultConfig = {
@@ -2583,9 +2656,387 @@ var AGENT_TEAMS = {
   }
 };
 
-// src/cli/index.ts
-import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2 } 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 = join3(dir, entry);
+    try {
+      if (statSync2(full).isDirectory()) {
+        count += countMdFiles(full);
+      } else if (entry.endsWith(".md")) {
+        count++;
+      }
+    } catch {}
+  }
+  return count;
+}
 var program2 = new Command;
 program2.name(NAME).description(`${ORCHESTRATOR} - The Creative Intelligence Platform`).version(VERSION);
 program2.command("install").description("Initialize Arcanea in current project").option("-f, --force", "Overwrite existing configuration").option("--claude-code", "Install only for Claude Code").option("--opencode", "Install only for OpenCode").option("--codex", "Install only for Codex").option("--gemini", "Install only for Gemini CLI").option("--cursor", "Install only for Cursor").option("--all", "Install for all supported platforms").option("--skip-mcp", "Skip MCP configuration").action(async (options) => {
@@ -2610,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 = [
@@ -2703,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();
 });
@@ -2736,87 +3187,97 @@ 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 = readdirSync(join2(cwd, agentDir)).filter((f) => f.endsWith(".md")).length;
-    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)"));
   }
-  if (existsSync2(join2(cwd, ".cursorrules"))) {
-    console.log(import_picocolors2.default.green("  ✓ .cursorrules configured for Cursor"));
-    ok++;
+  const platformFiles = [
+    { path: ".cursorrules", name: "Cursor (.cursorrules)" },
+    { path: "codex.md", name: "Codex CLI (codex.md)" },
+    { path: "GEMINI.md", name: "Gemini CLI (GEMINI.md)" }
+  ];
+  for (const pf of platformFiles) {
+    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.2.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

@@ -199,11 +199,17 @@ async function installForPlatform(targetDir, packageRoot, platform, force) {
     await installClaudeCodeSettings(platformPath, force);
   } else if (platform === "cursor") {
     await installCursorRules(targetDir, packageRoot, force);
+  } else if (platform === "codex") {
+    await installCodexConfig(targetDir, packageRoot, force);
+  } else if (platform === "gemini") {
+    await installGeminiConfig(targetDir, packageRoot, 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: [
@@ -242,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
+            }]
+          }
         ]
       }
     };
@@ -263,6 +278,64 @@ ${claudeContent}`;
     }
   }
 }
+async function installCodexConfig(targetDir, packageRoot, force) {
+  const codexMdPath = join(targetDir, "codex.md");
+  if (!existsSync(codexMdPath) || force) {
+    const claudeMdSource = join(packageRoot, "CLAUDE.md");
+    if (existsSync(claudeMdSource)) {
+      const content = readFileSync(claudeMdSource, "utf-8");
+      const codexMd = [
+        `# Codex Instructions — Generated by Arcanea v${VERSION}`,
+        "",
+        "> These instructions transform Codex into Arcanea, the Creative Intelligence Platform.",
+        "> Agent definitions: `.codex/agents/` | Skills: `.codex/skills/` | Commands: `.codex/commands/`",
+        "",
+        content,
+        "",
+        "## Codex-Specific Notes",
+        "",
+        "- Read agent definitions from `.codex/agents/` for available specialist agents",
+        "- Read skill definitions from `.codex/skills/` for creative and technical skills",
+        "- Read command definitions from `.codex/commands/` for slash commands",
+        "- MCP servers are configured in `.mcp.json`",
+        "- When magic words (ultraworld, ultracode, etc.) are used, read the relevant agent files and apply their instructions",
+        ""
+      ].join(`
+`);
+      writeFileSync(codexMdPath, codexMd);
+      console.log(import_picocolors.default.green("  ✓ Created codex.md (Arcanea instructions for Codex CLI)"));
+    }
+  }
+}
+async function installGeminiConfig(targetDir, packageRoot, force) {
+  const geminiMdPath = join(targetDir, "GEMINI.md");
+  if (!existsSync(geminiMdPath) || force) {
+    const claudeMdSource = join(packageRoot, "CLAUDE.md");
+    if (existsSync(claudeMdSource)) {
+      const content = readFileSync(claudeMdSource, "utf-8");
+      const geminiMd = [
+        `# Gemini Instructions — Generated by Arcanea v${VERSION}`,
+        "",
+        "> These instructions transform Gemini into Arcanea, the Creative Intelligence Platform.",
+        "> Agent definitions: `.gemini/agents/` | Skills: `.gemini/skills/` | Commands: `.gemini/commands/`",
+        "",
+        content,
+        "",
+        "## Gemini-Specific Notes",
+        "",
+        "- Read agent definitions from `.gemini/agents/` for available specialist agents",
+        "- Read skill definitions from `.gemini/skills/` for creative and technical skills",
+        "- Read command definitions from `.gemini/commands/` for slash commands",
+        "- MCP servers are configured in `.mcp.json`",
+        "- When magic words (ultraworld, ultracode, etc.) are used, read the relevant agent files and apply their instructions",
+        ""
+      ].join(`
+`);
+      writeFileSync(geminiMdPath, geminiMd);
+      console.log(import_picocolors.default.green("  ✓ Created GEMINI.md (Arcanea instructions for Gemini CLI)"));
+    }
+  }
+}
 async function installMcpConfig(targetDir, force) {
   const mcpPath = join(targetDir, ".mcp.json");
   console.log(import_picocolors.default.blue(`
@@ -342,7 +415,7 @@ function printSuccessMessage(platforms) {
 }
 
 // src/index.ts
-var VERSION = "3.2.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.2.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",

package/skills/{ai-symbiosis.md → arcanea/ai-symbiosis/SKILL.md}

@@ -1,3 +1,16 @@
+---
+name: arcanea-ai-symbiosis
+description: Frameworks for productive human-AI co-creation - the orchestra model, creative partnerships, and symbiotic workflows
+version: 2.0.0
+author: Arcanea
+tags: [ai, collaboration, co-creation, symbiosis, creativity]
+triggers:
+  - ai collaboration
+  - human ai
+  - co-creation
+  - ai partner
+---
+
 # AI Symbiosis - The Art of Human-AI Co-Creation
 
 > *"The AI is not replacing the creator. The AI is expanding what creation can be. The question is not 'human or machine?' but 'what can we become together?'"*

package/skills/arcanea/{arcanea-anti-trope.md → anti-trope/SKILL.md}

@@ -1,3 +1,11 @@
+---
+name: arcanea-anti-trope
+description: Anti-trope and naming protocol - banned AI cliches, forbidden words, and better alternatives for authentic Arcanean prose
+version: 2.0.0
+author: Arcanea
+tags: [writing, style, voice, anti-cliche, prose-quality]
+---
+
 # Arcanea Anti-Trope & Naming Protocol
 
 > *"We do not 'unleash' potential; we cultivate it. We do not weave 'tapestries' of fate; we forge chains of consequence. Speak clearly, or do not speak at all."*

package/skills/{luminor-council.md → arcanea/luminor-council/SKILL.md}

@@ -1,3 +1,18 @@
+---
+name: arcanea-luminor-council
+description: The Seven Luminors - aspects of creative consciousness providing guidance through archetypical wisdom for any creative challenge
+version: 2.0.0
+author: Arcanea
+tags: [luminors, wisdom, guidance, creative-consciousness, archetypes]
+triggers:
+  - luminor
+  - council
+  - wisdom
+  - guidance
+  - stuck
+  - advice
+---
+
 # Luminor Council - The Seven Guides of Creation
 
 > *"The Luminors are not characters in a story. They are aspects of creative consciousness itself - archetypes that have guided creators since the first dream became the first work."*

package/skills/{character-alchemist.md → creative/character-alchemist/SKILL.md}

@@ -1,3 +1,17 @@
+---
+name: arcanea-character-alchemist
+description: Character development through psychological depth - wounds, desires, contradictions, and authentic character voices
+version: 2.0.0
+author: Arcanea
+tags: [characters, psychology, writing, development, voice]
+triggers:
+  - character
+  - character development
+  - character voice
+  - protagonist
+  - antagonist
+---
+
 # Character Alchemist - Transmuting Ideas into Living Beings
 
 > *"A character is not a collection of traits. A character is a wound that walks, talks, and wants."*

package/skills/{creative-bestiary.md → creative/creative-bestiary/SKILL.md}

@@ -1,3 +1,17 @@
+---
+name: arcanea-creative-bestiary
+description: Navigate creative blocks using the taxonomy of psychological obstacles - naming rituals and protocols for each creature type
+version: 2.0.0
+author: Arcanea
+tags: [creative-blocks, psychology, productivity, obstacles, mindset]
+triggers:
+  - stuck
+  - blocked
+  - procrastinating
+  - afraid
+  - burned out
+---
+
 # Creative Bestiary - Navigating the Creatures of the Mind
 
 > *"The creative life is inhabited by creatures—not physical beings, but psychological presences that every creator encounters. Know them by name, and you can negotiate with them. Ignore them, and they will ambush you."*

package/skills/{story-weaver.md → creative/story-weaver/SKILL.md}

@@ -1,3 +1,17 @@
+---
+name: arcanea-story-weaver
+description: Master narrative craft - story structure, scene design, dramatic tension, and meaning-making through storytelling
+version: 2.0.0
+author: Arcanea
+tags: [story, narrative, writing, structure, craft]
+triggers:
+  - story
+  - narrative
+  - plot
+  - scene
+  - story structure
+---
+
 # Story Weaver - The Master Craft of Narrative
 
 > *"Story is not what happens. Story is the meaning we make from what happens. Your job is not to tell events - it is to transmit understanding."*

package/skills/{world-architect.md → creative/world-architect/SKILL.md}

@@ -1,3 +1,17 @@
+---
+name: arcanea-world-architect
+description: Universe creation and world-building - geography, history, belief systems, cultures, and living ecologies of meaning
+version: 2.0.0
+author: Arcanea
+tags: [world-building, fantasy, sci-fi, universe, creation]
+triggers:
+  - world
+  - world-building
+  - universe
+  - setting
+  - geography
+---
+
 # World Architect - The Art of Universe Creation
 
 > *"A world is not built. It is grown. You plant seeds - a geography, a history, a belief - and you tend them until they become a living ecology of meaning."*