@hybridlabor-api/aos 4.4.2-beta.9 → 4.5.1

package/README.md

@@ -10,17 +10,17 @@
 [![GitHub stars](https://img.shields.io/github/stars/hybridlabor-api/aos?style=flat&color=gold)](https://github.com/hybridlabor-api/aos/stargazers)
 [![last commit](https://img.shields.io/github/last-commit/hybridlabor-api/aos.svg)](https://github.com/hybridlabor-api/aos/commits/main)
 
-[![skills](https://img.shields.io/badge/skills-183%20curated-brightgreen.svg)](docs/skills_table.md)
+[![skills](https://img.shields.io/badge/skills-184%20curated-brightgreen.svg)](docs/skills_table.md)
 [![MCPs](https://img.shields.io/badge/local%20MCPs-19-brightgreen.svg)](mcps/)
 [![harnesses](https://img.shields.io/badge/harnesses-9%20supported-blueviolet.svg)](#-installation)
 [![runtime](https://img.shields.io/badge/node-20+-blue.svg)](https://github.com/hybridlabor-api/aos)
 [![SkillSpector](https://img.shields.io/badge/NVIDIA%20SkillSpector-CLEAN-76B900?logo=nvidia&logoColor=white)](https://github.com/NVIDIA/SkillSpector)
 
-> **Supercharging AI coding agents with 183 hyper-curated skills, 21 local MCP wrappers, and a runnable multi-agent dispatcher graph.**
+> **Supercharging AI coding agents with 184 hyper-curated skills, 19 local MCP wrappers, and a runnable multi-agent dispatcher graph.**
 
-Welcome to **BDB Agent OS — AOS**: 183 curated skills, 19 local MCP wrappers, an optional Hardware & PCB design module, and a dispatcher graph that turns all of it into a real multi-agent build pipeline, not just a prompt library. Point it at a goal and it plans, builds, reviews, and ships through seven coordinated agent nodes — with a mechanically enforced gate before anything actually goes live.
+Welcome to **BDB Agent OS — AOS**: 184 curated skills, 19 local MCP wrappers, an optional Hardware & PCB design module, and a dispatcher graph that turns all of it into a real multi-agent build pipeline, not just a prompt library. Point it at a goal and it plans, builds, reviews, and ships through seven coordinated agent nodes — with a mechanically enforced gate before anything actually goes live.
 
-**Current release:** `v4.4.2` (beta channel) — see the NPM badge above for the exact published version.
+**Current release:** `v4.5.0` — see the NPM badge above for the exact published version.
 
 It is harness-neutral by design, not "optimized for one tool with others as an afterthought": the dispatcher graph runs on Claude Code's Dynamic Workflows, the same skills and MCP configuration install natively into **Google Antigravity, ChatGPT Codex / Codex CLI, Claude Desktop, Cursor, Aider, Roo Code, Cline, and Windsurf**, and the lightweight `/startcycle-graph-user` variant falls back to Claude Code's own subagents on any machine that has none of the above installed.
 
@@ -98,16 +98,16 @@ separately if you want the same routing available outside a `/startcycle` run.
 ## Overview
 
 This repo ships three things: a curated skill library for coding agents, an
-installer that wires them (plus 21 local MCP wrappers) into whichever harness
+installer that wires them (plus 19 local MCP wrappers) into whichever harness
 you use, and a dispatcher graph that orchestrates them as a multi-agent
 build pipeline. See [AOS: The Dispatcher Graph](#-aos-the-dispatcher-graph)
 below for how the pipeline itself works.
 
 ---
 
-## 🌟 183 Optimized Skills
+## 🌟 184 Optimized Skills
 
-We started with a massive pool of over 1,400 raw AI skills. After rigorous testing, filtering, and refinement, we've distilled them down to a hyper-curated set of **183 Optimized Skills** (featuring a native OpenWiki documentation engine, the **memB local semantic memory brain**, and **Universal Agent Harness synchronization**).
+We started with a massive pool of over 1,400 raw AI skills. After rigorous testing, filtering, and refinement, we've distilled them down to a hyper-curated set of **184 Optimized Skills** (featuring a native OpenWiki documentation engine, the **memB local semantic memory brain**, and **Universal Agent Harness synchronization**).
 
 These skills are precision-engineered to ensure agents waste no time on redundant tasks and instead operate with maximum agency, strict architectural constraints, and robust context awareness.
 
@@ -138,7 +138,7 @@ While heavily optimized for the creative tech industry, these skills are deeply
 
 ## 🗂️ The Complete Skill Library
 
-147 skills across 15 domains, collapsed by default so this section does not require endless scrolling to get past. Click any category to expand it.
+184 skills across 15 domains, collapsed by default so this section does not require endless scrolling to get past. Click any category to expand it.
 
 <details>
 <summary><strong>🎨 Frontend & UI/UX Design</strong> — 20 skills</summary>
@@ -482,11 +482,11 @@ BDBrainstorm combines multi-agent brainstorming, the `/grill-me` slash command,
 
 ---
 
-## 🔌 21 Local MCP Wrappers
+## 🔌 19 Local MCP Wrappers
 
 ![BDB Architecture Sketch](assets/bdb_architecture_sketch.jpg)
 
-Rather than relying on skeletal python mocks or broken remote APIs, this repository bundles **21 local MCP wrappers** (in the `mcps/` directory). These are built/warmed automatically and allow your AI assistant to read, write, and execute commands within the industry's leading creative software.
+Rather than relying on skeletal python mocks or broken remote APIs, this repository bundles **19 local MCP wrappers** (in the `mcps/` directory). These are built/warmed automatically and allow your AI assistant to read, write, and execute commands within the industry's leading creative software.
 
 <details>
 <summary><strong>🎨 Adobe Creative Cloud (Illustrator, Photoshop, After Effects, Premiere Pro)</strong></summary>

package/README.pt.md

@@ -20,12 +20,12 @@
 [![NPM Version](https://img.shields.io/npm/v/@hybridlabor-api/aos.svg)](https://www.npmjs.com/package/@hybridlabor-api/aos)
 [![runtime](https://img.shields.io/badge/node-20+-blue.svg)](https://github.com/hybridlabor-api/aos)
 [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-[![skills](https://img.shields.io/badge/skills-183%20curadas-brightgreen.svg)](https://github.com/hybridlabor-api/aos)
+[![skills](https://img.shields.io/badge/skills-184%20curadas-brightgreen.svg)](https://github.com/hybridlabor-api/aos)
 [![SkillSpector](https://img.shields.io/badge/NVIDIA%20SkillSpector-CLEAN-76B900?logo=nvidia&logoColor=white)](https://github.com/NVIDIA/SkillSpector)
 
-> **Potencializando agentes de código de IA com 183 skills hipercuradas, 19 wrappers MCP locais e um grafo dispatcher de multi-agentes executável.**
+> **Potencializando agentes de código de IA com 184 skills hipercuradas, 19 wrappers MCP locais e um grafo dispatcher de multi-agentes executável.**
 
-Bem-vindo ao **BDB Agent OS — AOS**: 183 skills curadas, 19 wrappers MCP locais e um grafo dispatcher que os transforma em um verdadeiro pipeline de build multi-agente, não apenas uma biblioteca de prompts. Aponte para um objetivo e ele planeja, constrói, revisa e implementa através de sete nós de agentes coordenados — com um portão imposto mecanicamente antes que qualquer coisa vá ao ar.
+Bem-vindo ao **BDB Agent OS — AOS**: 184 skills curadas, 19 wrappers MCP locais e um grafo dispatcher que os transforma em um verdadeiro pipeline de build multi-agente, não apenas uma biblioteca de prompts. Aponte para um objetivo e ele planeja, constrói, revisa e implementa através de sete nós de agentes coordenados — com um portão imposto mecanicamente antes que qualquer coisa vá ao ar.
 
 É neutro em relação ao harness por design, não "otimizado para uma ferramenta com outras como reflexão tardia": o grafo dispatcher é executado no Dynamic Workflows do Claude Code, as mesmas skills e configuração MCP são instaladas nativamente no **Google Antigravity, ChatGPT Codex / Codex CLI, Claude Desktop, Cursor, Aider, Roo Code, Cline e Windsurf**, e a variante leve `/startcycle-graph-user` recorre aos próprios subagentes do Claude Code em qualquer máquina que não tenha nenhum dos acima instalados.
 
@@ -81,14 +81,14 @@ Nenhum destes vem dentro deste pacote — são plugins do Claude Code independen
 ## Visão Geral
 
 Este repositório entrega três coisas: uma biblioteca curada de skills para agentes de código, um
-instalador que conecta eles (mais 21 wrappers MCP locais) em qualquer harness
+instalador que conecta eles (mais 19 wrappers MCP locais) em qualquer harness
 que você use, e um grafo dispatcher que os orquestra como um pipeline de
 build multi-agente. Veja [AOS: O Grafo Dispatcher](#-aos-o-grafo-dispatcher)
 abaixo para entender como o próprio pipeline funciona.
 
-## 🌟 183 Skills Otimizadas
+## 🌟 184 Skills Otimizadas
 
-Começamos com um conjunto massivo de mais de 1.400 skills de IA brutas. Após rigorosos testes, filtragem e refinamento, destilamo-las em um conjunto hipercurado de **183 Skills Otimizadas** (apresentando um motor nativo de documentação OpenWiki, o **cérebro de memória semântica local memB** e agora a **sincronização Universal Agent Harness na v4.0.0**).
+Começamos com um conjunto massivo de mais de 1.400 skills de IA brutas. Após rigorosos testes, filtragem e refinamento, destilamo-las em um conjunto hipercurado de **184 Skills Otimizadas** (apresentando um motor nativo de documentação OpenWiki, o **cérebro de memória semântica local memB** e agora a **sincronização Universal Agent Harness na v4.0.0**).
 
 Essas skills são projetadas com precisão para garantir que os agentes não percam tempo com tarefas redundantes e, em vez disso, operem com máxima autonomia, restrições arquitetônicas rígidas e robusta consciência de contexto.
 
@@ -97,7 +97,7 @@ Em vez de deixar os agentes vagando por instruções genéricas, o nível superi
 - **`godmode-engineering`**: Impõe Domain-Driven Design, verificações rígidas de TypeScript, Clean Architecture e depuração sistemática.
 - **`godmode-ui-ux`**: O padrão de ouro do frontend. Impõe princípios "Anti-Slop" da BDB, acessibilidade e dinâmicas de movimento fluidas.
 - **`godmode-shipping`**: O guardião final para lançamentos em produção. Impõe Spec-Driven Development, verificações pré-lançamento e rollbacks seguros.
-- **`godmode-eventtech`**: O livro de regras supremo para o BDB Creator Engine, governando 3D, Mídia e 21 wrappers MCP de tecnologia criativa.
+- **`godmode-eventtech`**: O livro de regras supremo para o BDB Creator Engine, governando 3D, Mídia e 19 wrappers MCP de tecnologia criativa.
 - **`godmode-3d-creation`**: Controla o pipeline 3D agêntico (TripoSR, TRELLIS) para modelos generativos e estruturas CAD.
 - **`godmode-media-creation`**: Orquestra a produção automatizada de vídeo, narrativa e loops de geração do ComfyUI.
 
@@ -121,7 +121,7 @@ Abaixo está a visão geral completa de todas as skills curadas de agentes inclu
 |------------|-------------|
 | `godmode-3d-creation` | Skill mestre de orquestração para todas as tarefas de geração, modelagem e reconstrução 3D. Atua como o cérebro 3D para a BDB Creator Extension. |
 | `godmode-engineering` | BDB Engineering Godmode. Impõe Domain-Driven Design rigoroso, estrito TypeScript, Clean Architecture e triagem sistemática de depuração em 5 etapas. |
-| `godmode-eventtech` | BDB EventTech Godmode. O livro de regras supremo para o BDB Creator Engine, governando Godmode-3D, Godmode-Media e os 21 wrappers MCP de tecnologia criativa. |
+| `godmode-eventtech` | BDB EventTech Godmode. O livro de regras supremo para o BDB Creator Engine, governando Godmode-3D, Godmode-Media e os 19 wrappers MCP de tecnologia criativa. |
 | `godmode-media-creation` | Skill mestre de orquestração para todas as tarefas de criação de mídia (Vídeo, Áudio, Imagem, Motion Design). Atua como o cérebro para a BDB Creator Extension. |
 | `godmode-shipping` | BDB Shipping Godmode. O guardião final para lançamentos em produção. Impõe Spec-Driven Development, rigorosas verificações pré-lançamento, feature flags e estratégias de rollback. |
 | `godmode-ui-ux` | BDB UI/UX Godmode. O padrão de ouro absoluto para design frontend. Impõe princípios Anti-Slop, acessibilidade corporativa, dinâmicas de movimento fluidas e geração de design orientada a dados em todos os harnesses de agentes. |
@@ -425,11 +425,11 @@ O BDBrainstorm combina brainstorming multi-agente, o comando slash `/grill-me`,
 
 ---
 
-## 🔌 21 Integrações Locais de MCPP
+## 🔌 19 Integrações Locais de MCPs
 
 ![BDB Architecture Sketch](assets/bdb_architecture_sketch.jpg)
 
-Em vez de depender de mocks rudimentares em python ou APIs remotas com falhas, este repositório empacota **21 wrappers MCP locais** (no diretório `mcps/`). Eles são construídos/preparados automaticamente e permitem que seu assistente de IA leia, escreva e execute comandos nos principais softwares criativos do mercado.
+Em vez de depender de mocks rudimentares em python ou APIs remotas com falhas, este repositório empacota **19 wrappers MCP locais** (no diretório `mcps/`). Eles são construídos/preparados automaticamente e permitem que seu assistente de IA leia, escreva e execute comandos nos principais softwares criativos do mercado.
 
 <details>
 <summary><strong>🎨 Adobe Creative Cloud (Illustrator, Photoshop, After Effects, Premiere Pro)</strong></summary>

package/bin/aos-dashboard.mjs

@@ -603,6 +603,12 @@ server.listen(PORT, '127.0.0.1', () => {
   const url = `http://127.0.0.1:${PORT}`;
   console.log(`AOS Dashboard v${AOS_VERSION || '?'}: ${url}   (Strg-C beendet)`);
   if (!OPEN) return;
-  const opener = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
-  execFile(opener, [url], () => { /* no browser is not an error */ });
+  if (process.platform === 'win32') {
+    spawn('cmd.exe', ['/c', 'start', '', url], { detached: true, stdio: 'ignore' })
+      .on('error', () => { /* no browser or spawn error is not fatal */ })
+      .unref();
+  } else {
+    const opener = process.platform === 'darwin' ? 'open' : 'xdg-open';
+    execFile(opener, [url], () => { /* no browser is not an error */ });
+  }
 });

package/installer.js

@@ -1996,6 +1996,91 @@ async function installSynapse() {
     }
 }
 
+async function installOpenWikiVisualizer() {
+    if (DRY_RUN) {
+        log.step('[dry-run] would register the OpenWiki Visualizer background daemon (Port 4321)');
+        return;
+    }
+    if (!hasExecutable('openwiki')) {
+        log.warn('Skipping OpenWiki Visualizer setup: the openwiki CLI was not found on PATH. Install it with: npm install -g openwiki@latest');
+        return;
+    }
+    // launchd starts agents with a minimal PATH that never includes npm's global
+    // bin dir, so resolve the absolute binary path now instead of relying on PATH at boot.
+    let openwikiBin = 'openwiki';
+    try {
+        const lookup = process.platform === 'win32' ? 'where openwiki' : 'command -v openwiki';
+        openwikiBin = execSync(lookup, { encoding: 'utf8' }).split(/\r?\n/)[0].trim() || 'openwiki';
+    } catch (e) { logDebug(e, 'openwiki path lookup'); }
+
+    if (process.platform === 'darwin') {
+        const plistPath = path.join(homeDir, 'Library', 'LaunchAgents', 'com.bdb.openwiki-visualize.plist');
+        const plistContent = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.bdb.openwiki-visualize</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>${openwikiBin}</string>
+        <string>visualize</string>
+        <string>--port</string>
+        <string>4321</string>
+        <string>--no-open</string>
+    </array>
+    <key>WorkingDirectory</key>
+    <string>${homeDir}</string>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>${path.join(homeDir, '.openwiki', 'visualize.stdout.log')}</string>
+    <key>StandardErrorPath</key>
+    <string>${path.join(homeDir, '.openwiki', 'visualize.stderr.log')}</string>
+</dict>
+</plist>`;
+        try {
+            fs.mkdirSync(path.join(homeDir, '.openwiki'), { recursive: true });
+            fs.writeFileSync(plistPath, plistContent);
+            execSync(`launchctl unload "${plistPath}" 2>/dev/null || true`, { stdio: 'ignore' });
+            execSync(`launchctl load -w "${plistPath}" 2>/dev/null || true`, { stdio: 'ignore' });
+            const isListening = await verifyDaemonListening(4321, 'OpenWiki Visualizer');
+            if (isListening) {
+                log.success('OpenWiki Visualizer LaunchAgent active (Port 4321)');
+            } else {
+                log.warn('OpenWiki Visualizer daemon did not respond on Port 4321 within timeout. You may need to start it manually or check for port conflicts.');
+            }
+        } catch (e) { logDebug(e, 'openwiki visualizer plist setup'); }
+    } else if (process.platform === 'win32') {
+        const startupDir = path.join(process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming'), 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup');
+        fs.mkdirSync(startupDir, { recursive: true });
+        const visualizerLogDir = path.join(homeDir, '.openwiki');
+        fs.mkdirSync(visualizerLogDir, { recursive: true });
+        const stdoutLog = path.join(visualizerLogDir, 'visualize.stdout.log');
+        const stderrLog = path.join(visualizerLogDir, 'visualize.stderr.log');
+        const batPath = path.join(visualizerLogDir, 'run-openwiki-visualize.bat');
+        const runCmd = `"${openwikiBin}" visualize --port 4321 --no-open`;
+        const batContent = `@echo off\r\ncd /d "${homeDir}"\r\n${runCmd} >> "${stdoutLog}" 2>> "${stderrLog}"\r\n`;
+        const vbsPath = path.join(startupDir, 'com.bdb.openwiki-visualize.vbs');
+        const vbsContent = `Set WshShell = CreateObject("WScript.Shell")\r\nWshShell.CurrentDirectory = "${homeDir}"\r\nWshShell.Run """${batPath}""", 0, False\r\n`;
+        try {
+            fs.writeFileSync(batPath, batContent, 'utf-8');
+            fs.writeFileSync(vbsPath, vbsContent, 'utf-8');
+            spawn('wscript.exe', [vbsPath], { detached: true, stdio: 'ignore' }).unref();
+            // Same reasoning as the Synapse Windows path: wscript -> WshShell.Run is
+            // multiple layers of indirection, so allow the generous 12s budget here too.
+            const isListening = await verifyDaemonListening(4321, 'OpenWiki Visualizer', 12000);
+            if (isListening) {
+                log.success('OpenWiki Visualizer Windows Background Service registered & started (Port 4321)');
+            } else {
+                log.warn(`OpenWiki Visualizer Windows daemon did not respond on Port 4321 within timeout. Check ${stderrLog} for the actual error before assuming it's just slow to start.`);
+            }
+        } catch (e) { logDebug(e, 'windows openwiki visualizer daemon setup'); }
+    }
+}
+
 async function installCreatorExtension() {
     const creatorDir = path.join(moduleBasePath(), 'bdb-dev-creator-extension');
     if (!downloadOrUpdateModule('@hybridlabor-api/bdb-dev-creator-extension', creatorDir, 'BDB Creator Extension')) {
@@ -3090,11 +3175,44 @@ function injectHarnessRules() {
 // most (a fresh install got it; every machine that already had AOS did not).
 function installGlobalHooks() {
     const hooksSrc = path.join(srcDir, '.claude', 'hooks');
+    const workflowsSrc = path.join(srcDir, '.claude', 'workflows');
+
+    // 1. Claude Code
     if (fs.existsSync(hooksSrc)) {
         copyDirRecursiveSync(hooksSrc, path.join(homeDir, '.claude', 'hooks'));
         log.step(`Installed hooks to ${path.join(homeDir, '.claude', 'hooks')}`);
     }
+    if (fs.existsSync(workflowsSrc)) {
+        copyDirRecursiveSync(workflowsSrc, path.join(homeDir, '.claude', 'workflows'));
+    }
     mergeBdbSettingsHooks(path.join(homeDir, '.claude', 'settings.json'));
+
+    // 2. Google Antigravity
+    const agyHooksDir = path.join(geminiDir, 'config', 'hooks');
+    const agyWorkflowsDir = path.join(geminiDir, 'config', 'workflows');
+    if (fs.existsSync(hooksSrc)) {
+        copyDirRecursiveSync(hooksSrc, agyHooksDir);
+        log.step(`Installed hooks to ${agyHooksDir}`);
+    }
+    if (fs.existsSync(workflowsSrc)) {
+        copyDirRecursiveSync(workflowsSrc, agyWorkflowsDir);
+    }
+    mergeAntigravityHooks(path.join(geminiDir, 'config', 'hooks.json'));
+    if (fs.existsSync(path.join(geminiDir, 'antigravity-cli'))) {
+        mergeAntigravityHooks(path.join(geminiDir, 'antigravity-cli', 'hooks.json'));
+    }
+
+    // 3. OpenAI Codex CLI
+    const codexHooksDir = path.join(homeDir, '.codex', 'hooks');
+    const codexWorkflowsDir = path.join(homeDir, '.codex', 'workflows');
+    if (fs.existsSync(hooksSrc)) {
+        copyDirRecursiveSync(hooksSrc, codexHooksDir);
+        log.step(`Installed hooks to ${codexHooksDir}`);
+    }
+    if (fs.existsSync(workflowsSrc)) {
+        copyDirRecursiveSync(workflowsSrc, codexWorkflowsDir);
+    }
+    mergeCodexTomlHooks(path.join(homeDir, '.codex', 'config.toml'));
 }
 
 // Merge the BDB hooks -- the two gates plus the memB ambient-memory hook --
@@ -3173,12 +3291,161 @@ function mergeBdbSettingsHooks(settingsPath, { projectLocal = false } = {}) {
     }
 
     try {
+        fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
         fs.writeFileSync(settingsPath, JSON.stringify(buildMerged(existing), null, 2) + '\n');
     } catch (e) {
         log.warn(`Could not write ${settingsPath}: ${e.message}`);
     }
 }
 
+// Merge the BDB hooks into Google Antigravity's hooks.json (.agents/hooks.json or
+// ~/.gemini/config/hooks.json), preserving user-defined foreign hooks.
+function mergeAntigravityHooks(hooksPath, { projectLocal = false } = {}) {
+    const bdbHookScripts = ['go-gate.mjs', 'graph-gate.mjs', 'memb-inject.mjs', 'startcycle-dispatch.mjs'];
+    const isBdbEntry = (entry) => {
+        const cmds = (entry && Array.isArray(entry.hooks) ? entry.hooks : [entry])
+            .map((h) => (h && typeof h.command === 'string' ? h.command : (typeof h === 'string' ? h : '')))
+            .join(' ');
+        return bdbHookScripts.some((name) => cmds.includes(name));
+    };
+
+    const baseDir = path.dirname(hooksPath);
+    const hooksDir = projectLocal ? path.join(currentDir, '.agents', 'hooks') : path.join(baseDir, 'hooks');
+    const workflowsDir = projectLocal ? path.join(currentDir, '.agents', 'workflows') : path.join(baseDir, 'workflows');
+    const globalHooksDir = projectLocal ? path.join(homeDir, '.gemini', 'config', 'hooks') : hooksDir;
+
+    const bdbHooks = {
+        PreToolUse: [
+            {
+                matcher: "run_command|Bash",
+                hooks: [{ type: "command", command: `node "${path.join(hooksDir, 'go-gate.mjs')}"`, timeout: 10000 }]
+            }
+        ],
+        Stop: [
+            {
+                hooks: [{ type: "command", command: `node "${path.join(hooksDir, 'graph-gate.mjs')}"`, timeout: 10000 }]
+            }
+        ],
+        PreInvocation: [
+            {
+                hooks: [
+                    { type: "command", command: `node "${path.join(globalHooksDir, 'memb-inject.mjs')}"`, timeout: 8000 },
+                    { type: "command", command: `node "${path.join(workflowsDir, 'startcycle-dispatch.mjs')}"`, timeout: 30000 }
+                ]
+            }
+        ]
+    };
+
+    const buildMerged = (existing) => {
+        const merged = existing && typeof existing === 'object' ? existing : {};
+        merged.hooks = merged.hooks && typeof merged.hooks === 'object' ? merged.hooks : {};
+        for (const [event, entries] of Object.entries(bdbHooks)) {
+            const foreignEntries = (Array.isArray(merged.hooks[event]) ? merged.hooks[event] : [])
+                .filter((e) => !isBdbEntry(e));
+            merged.hooks[event] = [...foreignEntries, ...entries];
+        }
+        return merged;
+    };
+
+    let existing = null;
+    if (fs.existsSync(hooksPath)) {
+        existing = readJsonFile(hooksPath);
+        if (!existing) {
+            const backupCopy = `${hooksPath}.corrupt_${timestamp}.bak`;
+            const sideCarPath = `${hooksPath}.bdb-new.json`;
+            let backupWritten = true;
+            try {
+                fs.copyFileSync(hooksPath, backupCopy);
+            } catch (copyError) {
+                backupWritten = false;
+                log.warn(`Could not create the hooks backup: ${copyError.message}`);
+            }
+            try {
+                fs.writeFileSync(sideCarPath, JSON.stringify(buildMerged(null), null, 2) + '\n');
+            } catch (writeError) {
+                log.warn(`Could not write ${path.basename(sideCarPath)}: ${writeError.message}`);
+            }
+            log.warn(`${path.basename(hooksPath)} is not valid JSON - hook merge skipped, nothing overwritten.`);
+            if (backupWritten) log.warn(`Backup copy: ${backupCopy}`);
+            log.warn(`BDB-wired hooks: ${sideCarPath}`);
+            return;
+        }
+    }
+
+    try {
+        fs.mkdirSync(path.dirname(hooksPath), { recursive: true });
+        fs.writeFileSync(hooksPath, JSON.stringify(buildMerged(existing), null, 2) + '\n');
+    } catch (e) {
+        log.warn(`Could not write ${hooksPath}: ${e.message}`);
+    }
+}
+
+// Merge the BDB hooks into ChatGPT Codex CLI's config.toml (~/.codex/config.toml or
+// .codex/config.toml), ensuring [features] hooks = true and preserving existing
+// non-BDB settings, comments, and MCP servers.
+function mergeCodexTomlHooks(configTomlPath, { projectLocal = false } = {}) {
+    const baseDir = path.dirname(configTomlPath);
+    const hooksDir = projectLocal ? path.join(currentDir, '.codex', 'hooks') : path.join(baseDir, 'hooks');
+    const workflowsDir = projectLocal ? path.join(currentDir, '.codex', 'workflows') : path.join(baseDir, 'workflows');
+    const globalHooksDir = projectLocal ? path.join(homeDir, '.codex', 'hooks') : hooksDir;
+
+    const tomlSnippet = [
+        '# AOS:HOOKS:START',
+        '[[hooks.PreToolUse]]',
+        'matcher = "^(Bash|run_command)$"',
+        '[[hooks.PreToolUse.hooks]]',
+        'type = "command"',
+        `command = ${JSON.stringify(`node "${path.join(hooksDir, 'go-gate.mjs')}"`)}`,
+        'timeout = 30',
+        '',
+        '[[hooks.Stop]]',
+        '[[hooks.Stop.hooks]]',
+        'type = "command"',
+        `command = ${JSON.stringify(`node "${path.join(hooksDir, 'graph-gate.mjs')}"`)}`,
+        'timeout = 30',
+        '',
+        '[[hooks.UserPromptSubmit]]',
+        '[[hooks.UserPromptSubmit.hooks]]',
+        'type = "command"',
+        `command = ${JSON.stringify(`node "${path.join(globalHooksDir, 'memb-inject.mjs')}"`)}`,
+        'timeout = 30',
+        '',
+        '[[hooks.UserPromptSubmit]]',
+        '[[hooks.UserPromptSubmit.hooks]]',
+        'type = "command"',
+        `command = ${JSON.stringify(`node "${path.join(workflowsDir, 'startcycle-dispatch.mjs')}"`)}`,
+        'timeout = 30',
+        '# AOS:HOOKS:END'
+    ].join('\n');
+
+    let content = fs.existsSync(configTomlPath) ? fs.readFileSync(configTomlPath, 'utf8') : '';
+
+    // Ensure [features] hooks = true
+    const hasHooksFeature = /(?:hooks|codex_hooks)\s*=\s*true/m.test(content);
+    if (!hasHooksFeature) {
+        if (/^\[features\]/m.test(content)) {
+            content = content.replace(/^\[features\]/m, '[features]\nhooks = true');
+        } else {
+            content = `[features]\nhooks = true\n\n${content.trimStart()}`;
+        }
+    }
+
+    // Replace existing AOS:HOOKS block or append
+    const hookBlockRegex = /# AOS:HOOKS:START[\s\S]*?# AOS:HOOKS:END/;
+    if (hookBlockRegex.test(content)) {
+        content = content.replace(hookBlockRegex, tomlSnippet);
+    } else {
+        content = `${content.trimEnd()}\n\n${tomlSnippet}\n`;
+    }
+
+    try {
+        fs.mkdirSync(path.dirname(configTomlPath), { recursive: true });
+        fs.writeFileSync(configTomlPath, content, { mode: 0o600 });
+    } catch (e) {
+        log.warn(`Could not write ${configTomlPath}: ${e.message}`);
+    }
+}
+
 // Tier 9 (Local Project Harness): drop the dispatcher contract into the
 // CURRENT PROJECT only -- no writes to $HOME, no global skill/MCP sync, and
 // this runs as an early return BEFORE any global install step. A bare
@@ -3191,22 +3458,29 @@ function mergeBdbSettingsHooks(settingsPath, { projectLocal = false } = {}) {
 // non-interactively via `--project-harness` (combine with -y for CI).
 function installProjectHarness() {
     const projectClaudeDir = path.join(currentDir, '.claude');
-    installStep(`create ${projectClaudeDir}`, () => {
+    const projectAgentsDir = path.join(currentDir, '.agents');
+    const projectCodexDir = path.join(currentDir, '.codex');
+
+    installStep(`create harness directories`, () => {
         fs.mkdirSync(projectClaudeDir, { recursive: true });
+        fs.mkdirSync(projectAgentsDir, { recursive: true });
+        fs.mkdirSync(projectCodexDir, { recursive: true });
     }, 'The harness copies below will most likely fail as well.');
 
     installStep('copy .agents/ contract into project', () => {
         const agentsSrc = path.join(srcDir, '.agents');
         if (!fs.existsSync(agentsSrc)) throw new Error(`missing payload: ${agentsSrc}`);
-        copyDirRecursiveSync(agentsSrc, path.join(currentDir, '.agents'));
-        log.step(`Copied .agents/ contract to ${path.join(currentDir, '.agents')}`);
+        copyDirRecursiveSync(agentsSrc, projectAgentsDir);
+        log.step(`Copied .agents/ contract to ${projectAgentsDir}`);
     }, 'graph.md / state.schema.json may be missing in the project.');
 
     installStep('copy dispatcher workflows into project', () => {
         const workflowsSrc = path.join(srcDir, '.claude', 'workflows');
         if (fs.existsSync(workflowsSrc)) {
             copyDirRecursiveSync(workflowsSrc, path.join(projectClaudeDir, 'workflows'));
-            log.step(`Copied dispatcher workflows to ${path.join(projectClaudeDir, 'workflows')}`);
+            copyDirRecursiveSync(workflowsSrc, path.join(projectAgentsDir, 'workflows'));
+            copyDirRecursiveSync(workflowsSrc, path.join(projectCodexDir, 'workflows'));
+            log.step(`Copied dispatcher workflows to project harnesses`);
         }
     }, '/startcycle dispatch degrades to graph.md as a manual guide.');
 
@@ -3214,7 +3488,9 @@ function installProjectHarness() {
         const hooksSrc = path.join(srcDir, '.claude', 'hooks');
         if (fs.existsSync(hooksSrc)) {
             copyDirRecursiveSync(hooksSrc, path.join(projectClaudeDir, 'hooks'));
-            log.step(`Copied hooks to ${path.join(projectClaudeDir, 'hooks')}`);
+            copyDirRecursiveSync(hooksSrc, path.join(projectAgentsDir, 'hooks'));
+            copyDirRecursiveSync(hooksSrc, path.join(projectCodexDir, 'hooks'));
+            log.step(`Copied hooks to project harnesses`);
         }
     }, 'go-gate / graph-gate enforcement stays inactive in this project.');
 
@@ -3226,9 +3502,11 @@ function installProjectHarness() {
         }
     }, 'The dispatcher runs, but its agent-file pointers resolve to nothing.');
 
-    installStep('wire project .claude/settings.json to local hooks', () => {
+    installStep('wire project harnesses to local hooks', () => {
         mergeBdbSettingsHooks(path.join(projectClaudeDir, 'settings.json'), { projectLocal: true });
-        log.step(`Wired project hooks in ${path.join(projectClaudeDir, 'settings.json')}`);
+        mergeAntigravityHooks(path.join(projectAgentsDir, 'hooks.json'), { projectLocal: true });
+        mergeCodexTomlHooks(path.join(projectCodexDir, 'config.toml'), { projectLocal: true });
+        log.step(`Wired project hooks in Claude, Antigravity, and Codex configurations`);
     }, 'The gate hooks exist but are not auto-wired for this project.');
 
     log.success(`Project harness installed to ${currentDir}`);
@@ -3348,6 +3626,7 @@ function generateAndOpenLaunchpad() {
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>BDB Agent OS – Launchpad</title>
+  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA1MTIgNTEyIj48ZGVmcz48bGluZWFyR3JhZGllbnQgaWQ9ImEiIHgxPSIwJSIgeTE9IjAlIiB4Mj0iMTAwJSIgeTI9IjEwMCUiPjxzdG9wIG9mZnNldD0iMCUiIHN0b3AtY29sb3I9IiNGRkZGRkYiLz48c3RvcCBvZmZzZXQ9IjEwMCUiIHN0b3AtY29sb3I9IiNFN0U3RUEiLz48L2xpbmVhckdyYWRpZW50PjwvZGVmcz48Y2lyY2xlIGN4PSIyNTYiIGN5PSIyNTYiIHI9IjI0NiIgZmlsbD0iIzBhMGEwYSIgc3Ryb2tlPSIjOWIzMGM0IiBzdHJva2Utd2lkdGg9IjEyIi8+PGcgdHJhbnNmb3JtPSJ0cmFuc2xhdGUoNzAsNjgpIj48cGF0aCBmaWxsPSJ1cmwoI2EpIiBkPSJNMTgxLjYzLjA1YzEwMS4zOS0yLjQ3LDE4NC41Niw4MC4wOSwxOTAuMTQsMTc5LjkzLDUuNTMsOTkuMDMtNjYuMTYsMTg1LjQyLTE2NS4xMSwxOTUuNDYtODcuMzksOC44Ni0xNzEuMS00NS41Ni0xOTcuNjctMTI4Ljk2Qy0yOC43NCwxMjguMDMsNTYuNzgsMy4xLDE4MS42My4wNWgwWk0xNzcuNSwyMS4zQzY5LjA5LDI1LjMxLTcuMTYsMTI5LjYyLDIxLjc2LDIzNC41MmMxOC43Miw2Ny44OCw4MS41NiwxMTYuNywxNTEuNTMsMTIxLjMyLDEwNi4yMSw3LjAzLDE5NS42LTgxLjYzLDE3OS42OC0xODkuMDYtMTIuNTQtODQuNjUtODkuODEtMTQ4LjY2LTE3NS40Ny0xNDUuNDloMFoiLz48ZyBmaWxsPSIjRkZGRkZGIj48cGF0aCBkPSJNMTQ3LjY5LDEyMC4wNWMxMi4wNC4zNiwyNC42NC0uNzIsMzYuNjItLjA3LDI0LjI5LDEuMzIsNDEuMzcsMjAuMTMsNDIuOTEsNDMuOTktLjY5LDE2LjM1LjU3LDMzLjQyLS4yOCw0OS42OS0xLjMxLDI1LjQyLTE4LjU1LDQzLjc1LTQ0LjAyLDQ1LjY0LTkuNTkuNzItMjAuMTQuNjktMjkuNzguODQtNC45Ny4wOC05LjkuNjgtMTAuMzctNS42NnMuNDMtOS40MS4zNC0xNC4wM2MxMi42NS0xMS44NCwxNC43NS0zMS4xNyw0Ljc1LTQ1LjQxLS42My0uOS0yLjI2LTIuMzQtMi42Mi0zLjE3cy0uNDYtMTIuNTgtLjI2LTE0LjM3LDEuMS0zLjUyLDEuNDYtNS4xNmMxLjIxLTUuNDIsMS4wNi0xMS4yNi0uMzktMTYuNjItLjQxLTEuNTQtMS40OC0zLjU2LTEuNjMtNC45OS0uNDctNC4yOC0uMTQtOS42Ny0uMjYtMTQuMDgtLjExLTMuNTYtLjg0LTguNDMtLjU3LTExLjg2czEuMzItNC4zNSw0LjA4LTQuNzVoMFoiLz48cGF0aCBkPSJNMjMyLjY2LDEzMi40NmM5LjUzLjM2LDE5Ljc0LS43MiwyOS4xOS0uMDgsMjIuNjQsMS41MiwzMy45MiwyOC41OCwyMS45Myw0Ny4wNS0xLjQ5LDIuMy00LjMyLDQuNDctMy44NSw3LjQyLjQ3LDIuOTUsNS42NCw2LjIxLDcuNDIsOC4zLDExLjg4LDEzLjk2LDguNDEsMzUuNjktNi45MSw0NS40OS03Ljg1LDUuMDItMTQuNjksNC40My0yMy41Niw0Ljg2LTcuNjcuMzctMTYuMjQsMS4wNS0yMy45MS42NloiLz48cGF0aCBkPSJNOTAuNTksMTMzLjAzYzguODQtLjQ0LDI1LjI0LTEuMDgsMzMuMjMsMS45MiwxOC4wNyw2Ljc3LDIzLjk5LDI5Ljk2LDEzLjU2LDQ1LjctMS42LDIuNDEtNC41Miw0LjQ0LTMuMjgsNy43NS42OSwxLjg1LDUuNDEsNS40Miw3LjAzLDcuMzEsMTEuODYsMTMuODIsOC43NywzNS4yMy02LjI1LDQ1LjMzLTE1LjAyLDEwLjEtMjMuMzEsNS4yNy0zNC40NCw1LjU2WiIvPjwvZz48L2c+PC9zdmc+">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;600;700&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet">
@@ -3388,11 +3667,7 @@ function generateAndOpenLaunchpad() {
       margin-bottom: 6px;
     }
     .logo-mark { width: 36px; height: 36px; flex-shrink: 0; }
-    .logo-badge {
-      background: linear-gradient(135deg, #ffffff 0%, #c77dea 60%, #9b30c4 100%);
-      -webkit-background-clip: text;
-      -webkit-text-fill-color: transparent;
-    }
+    .logo-badge { color: #ffffff; }
     .tagline { color: var(--text-muted); font-size: 14px; font-weight: 400; }
     .grid { display: flex; flex-direction: column; gap: 12px; }
     .card {
@@ -3600,6 +3875,30 @@ function generateAndOpenLaunchpad() {
           <span class="status-dot" id="dot-remote" title="Checking..."></span>
         </div>
       </a>
+      <a class="card" href="http://127.0.0.1:4321" target="_blank">
+        <div class="card-content">
+          <div class="card-icon"><svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
+            <defs><linearGradient id="grad-openwiki" x1="50%" y1="0%" x2="50%" y2="100%"><stop offset="0%" stop-color="#FFFFFF"/><stop offset="100%" stop-color="#51116F"/></linearGradient></defs>
+            <rect x="26" y="16" width="48" height="68" rx="4" fill="url(#grad-openwiki)" opacity="0.9"/>
+            <line x1="36" y1="32" x2="64" y2="32" stroke="#0a0a0a" stroke-width="2.5" opacity="0.5"/>
+            <line x1="36" y1="42" x2="64" y2="42" stroke="#0a0a0a" stroke-width="2.5" opacity="0.5"/>
+            <line x1="36" y1="52" x2="52" y2="52" stroke="#0a0a0a" stroke-width="2.5" opacity="0.5"/>
+            <circle cx="70" cy="68" r="14" fill="#0a0a0a" stroke="#FFFFFF" stroke-width="2"/>
+            <circle cx="65" cy="64" r="2.5" fill="#FFFFFF"/><circle cx="74" cy="63" r="2.5" fill="#FFFFFF"/><circle cx="70" cy="72" r="2.5" fill="#FFFFFF"/>
+            <line x1="65" y1="64" x2="74" y2="63" stroke="#FFFFFF" stroke-width="1.2" opacity="0.7"/>
+            <line x1="65" y1="64" x2="70" y2="72" stroke="#FFFFFF" stroke-width="1.2" opacity="0.7"/>
+            <line x1="74" y1="63" x2="70" y2="72" stroke="#FFFFFF" stroke-width="1.2" opacity="0.7"/>
+          </svg></div>
+          <div class="card-info">
+            <h2>OpenWiki</h2>
+            <p>Grounded Documentation & Evidence Graph</p>
+          </div>
+        </div>
+        <div class="card-meta">
+          <span class="port-pill">:4321</span>
+          <span class="status-dot" id="dot-openwiki" title="Checking..."></span>
+        </div>
+      </a>
     </div>
     <div class="footer">
       <span>Autostart Daemons • 127.0.0.1</span>
@@ -3618,6 +3917,7 @@ function generateAndOpenLaunchpad() {
       checkHealth('http://127.0.0.1:7781', 'dot-synapse');
       checkHealth('http://127.0.0.1:3101', 'dot-ao');
       checkHealth('http://127.0.0.1:9080', 'dot-remote');
+      checkHealth('http://127.0.0.1:4321', 'dot-openwiki');
     }
     checkAllHealth();
     setInterval(checkAllHealth, 5000);
@@ -3845,6 +4145,7 @@ async function runQuickUpdate(installState) {
         const creds = await promptCredentials(paths.targetMcpDir);
         if (creds !== BACK) {
             await installOpenWikiDaemon(creds.gemini, paths.targetSkillDir, { provider: creds.openwikiProvider, model: creds.openwikiModel, baseUrl: creds.openwikiBaseUrl });
+            await installOpenWikiVisualizer();
         }
     }
 
@@ -4257,6 +4558,7 @@ async function main() {
     }
 
     await installOpenWikiDaemon(creds.gemini, primaryTarget.targetSkillDir, { provider: creds.openwikiProvider, model: creds.openwikiModel, baseUrl: creds.openwikiBaseUrl });
+    await installOpenWikiVisualizer();
     await installTokenSaver(primaryTarget.platformValue);
 
     const installedModulesForPrompt = (installState && installState.installedModules) || [];
@@ -4297,6 +4599,9 @@ module.exports = {
     detectPlatforms,
     markPlatformsExplicit,
     mergeBdbSettingsHooks,
+    mergeAntigravityHooks,
+    mergeCodexTomlHooks,
+    mergeCodexHooks: mergeCodexTomlHooks,
     installGlobalHooks,
     installProjectHarness,
     mirrorMcpServersTo,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hybridlabor-api/aos",
-  "version": "4.4.2-beta.9",
+  "version": "4.5.1",
   "description": "AOS — A Curated AI AGENT OS. Optimized agent skills and add-ons like memB, OpenWiki, Heimdall Token Saver, and Godmode architectures.",
   "main": "installer.js",
   "engines": {