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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.de.md CHANGED
@@ -20,10 +20,10 @@
20
20
  [![NPM Version](https://img.shields.io/npm/v/@hybridlabor-api/aos.svg)](https://www.npmjs.com/package/@hybridlabor-api/aos)
21
21
  [![runtime](https://img.shields.io/badge/node-20+-blue.svg)](https://github.com/hybridlabor-api/aos)
22
22
  [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
23
- [![skills](https://img.shields.io/badge/skills-183%20kuratiert-brightgreen.svg)](https://github.com/hybridlabor-api/aos)
23
+ [![skills](https://img.shields.io/badge/skills-184%20kuratiert-brightgreen.svg)](https://github.com/hybridlabor-api/aos)
24
24
  [![SkillSpector](https://img.shields.io/badge/NVIDIA%20SkillSpector-CLEAN-76B900?logo=nvidia&logoColor=white)](https://github.com/NVIDIA/SkillSpector)
25
25
 
26
- > **Supercharging von KI-Coding-Agenten mit 183 hochkuratierten Skills, 19 lokalen MCP Wrappern und tiefgreifenden Integrationen für die Creative-Technology-Branche.**
26
+ > **Supercharging von KI-Coding-Agenten mit 184 hochkuratierten Skills, 19 lokalen MCP Wrappern und tiefgreifenden Integrationen für die Creative-Technology-Branche.**
27
27
 
28
28
  Willkommen im **BDB DEV Skills & MCP Configuration** Repository. Dieses Projekt dient als Rückgrat unseres Entwicklungs-Ecosystems für Creative & Full-Stack Development. Es erweitert KI-Agenten um hochspezialisierte Fähigkeiten, die speziell auf die Event- und Medientechnologie-Branche sowie auf allgemeine Software-Entwicklung zugeschnitten sind.
29
29
 
@@ -80,11 +80,11 @@ Keines dieser Plugins ist in diesem Paket enthalten — es handelt sich um unabh
80
80
 
81
81
  ## Übersicht
82
82
 
83
- Dieses Repo liefert drei Dinge: eine kuratierte Skill-Bibliothek für Coding-Agenten, einen Installer, der diese (plus 21 lokale MCP Wrapper) in das von Ihnen genutzte Harness einbindet, und einen Dispatcher-Graphen, der sie als Multi-Agenten Build-Pipeline orchestriert. Siehe [AOS: Der Dispatcher-Graph](#-aos-der-dispatcher-graph) weiter unten für Details zur Funktionsweise der Pipeline selbst.
83
+ Dieses Repo liefert drei Dinge: eine kuratierte Skill-Bibliothek für Coding-Agenten, einen Installer, der diese (plus 19 lokale MCP Wrapper) in das von Ihnen genutzte Harness einbindet, und einen Dispatcher-Graphen, der sie als Multi-Agenten Build-Pipeline orchestriert. Siehe [AOS: Der Dispatcher-Graph](#-aos-der-dispatcher-graph) weiter unten für Details zur Funktionsweise der Pipeline selbst.
84
84
 
85
- ## 🌟 183 Optimierte Skills
85
+ ## 🌟 184 Optimierte Skills
86
86
 
87
- Wir haben mit einem gewaltigen Pool von über 1.400 rohen KI-Skills begonnen. Nach intensiven Tests, Filterungen und Verfeinerungen haben wir sie zu einem hochkuratierten Set von **183 Optimierten Skills** destilliert (mit nativer OpenWiki-Dokumentationsengine, dem **lokalen semantischen Gedächtnis memB** und jetzt der **Universal Agent Harness Synchronisation in v4.0.0**).
87
+ Wir haben mit einem gewaltigen Pool von über 1.400 rohen KI-Skills begonnen. Nach intensiven Tests, Filterungen und Verfeinerungen haben wir sie zu einem hochkuratierten Set von **184 Optimierten Skills** destilliert (mit nativer OpenWiki-Dokumentationsengine, dem **lokalen semantischen Gedächtnis memB** und jetzt der **Universal Agent Harness Synchronisation in v4.0.0**).
88
88
 
89
89
  Diese Skills sind präzise optimiert, damit Agenten keine Zeit mit redundanten Aufgaben verschwenden, sondern mit maximaler Autonomie, strengen Architekturvorgaben und robustem Kontextbewusstsein agieren.
90
90
 
@@ -93,8 +93,8 @@ Anstatt Agenten durch generische Anweisungen irren zu lassen, setzt die oberste
93
93
  - **`godmode-engineering`**: Erzwingt Domain-Driven Design, strenge TypeScript-Prüfungen, Clean Architecture und systematisches Debugging.
94
94
  - **`godmode-ui-ux`**: Der Frontend-Goldstandard. Erzwingt BDB "Anti-Slop"-Prinzipien, Barrierefreiheit (Accessibility) und fluide Bewegungsdynamiken.
95
95
  - **`godmode-shipping`**: Der finale Wächter für Production Releases. Erzwingt Spec-Driven Development, Pre-Launch-Prüfungen und sichere Rollbacks.
96
- - **`godmode-eventtech`**: Das oberste Regelwerk für die BDB Creator Engine, das 3D, Medien und 21 Creative-Tech MCP Wrappern steuert.
97
- - **`godmode-eventtech`**: Das oberste Regelwerk für die BDB Creator Engine, das 3D, Medien und 21 Creative-Tech MCP Wrappern steuert.
96
+ - **`godmode-eventtech`**: Das oberste Regelwerk für die BDB Creator Engine, das 3D, Medien und 19 Creative-Tech MCP Wrappern steuert.
97
+ - **`godmode-eventtech`**: Das oberste Regelwerk für die BDB Creator Engine, das 3D, Medien und 19 Creative-Tech MCP Wrappern steuert.
98
98
  - **`godmode-3d-creation`**: Steuert die Agentic-3D-Pipeline (TripoSR, TRELLIS) für generative Modelle und CAD-Strukturen.
99
99
  - **`godmode-media-creation`**: Orchestriert automatisierte Videoproduktion, Storytelling und ComfyUI-Generierungsschleifen.
100
100
 
@@ -118,7 +118,7 @@ Nachfolgend finden Sie die vollständige Übersicht aller in diesem Paket enthal
118
118
  |------------|-------------|
119
119
  | `godmode-3d-creation` | Orchestrierungs-Master-Skill für alle 3D-Generierungs-, Modellierungs- und Rekonstruktionsaufgaben. Agiert als 3D-Gehirn für die BDB Creator Extension. |
120
120
  | `godmode-engineering` | BDB Engineering Godmode. Erzwingt strenges Domain-Driven Design, TypeScript-Striktheit, Clean Architecture und systematisches 5-Stufen-Debugging. |
121
- | `godmode-eventtech` | BDB EventTech Godmode. Das oberste Regelwerk für die BDB Creator Engine, das Godmode-3D, Godmode-Media und die 21 Creative-Tech MCP Wrappern steuert. |
121
+ | `godmode-eventtech` | BDB EventTech Godmode. Das oberste Regelwerk für die BDB Creator Engine, das Godmode-3D, Godmode-Media und die 19 Creative-Tech MCP Wrappern steuert. |
122
122
  | `godmode-media-creation` | Orchestrierungs-Master-Skill für alle Medienerstellungsaufgaben (Video, Audio, Bild, Motion Design). Agiert als Gehirn für die BDB Creator Extension. |
123
123
  | `godmode-shipping` | BDB Shipping Godmode. Der finale Wächter für Production Releases. Erzwingt Spec-Driven Development, strenge Pre-Launch-Prüfungen, Feature Flags und Rollback-Strategien. |
124
124
  | `godmode-ui-ux` | BDB UI/UX Godmode. Der absolute Goldstandard für Frontend-Design. Erzwingt Anti-Slop-Prinzipien, Enterprise-Barrierefreiheit, fluide Bewegungsdynamiken und datengestützte Design-Generierung über alle Agent-Harnesses hinweg. |
@@ -433,11 +433,11 @@ BDBrainstorm kombiniert Multi-Agenten-Brainstorming, den Slash-Befehl `/grill-me
433
433
 
434
434
  ---
435
435
 
436
- ## 🔌 21 Lokale MCP Wrapper
436
+ ## 🔌 19 Lokale MCP Wrapper
437
437
 
438
438
  ![BDB Architecture Sketch](assets/bdb_architecture_sketch.jpg)
439
439
 
440
- Anstatt sich auf rudimentäre Python-Mocks oder fehlerhafte Remote-APIs zu verlassen, bündelt dieses Repository **21 eigene, lokale MCP-Wrapper** (im Ordner `mcps/`). Diese werden automatisch erstellt/aufgewärmt und ermöglichen Ihrem KI-Assistenten das Lesen, Schreiben und Ausführen von Befehlen in der führenden Kreativsoftware der Branche.
440
+ Anstatt sich auf rudimentäre Python-Mocks oder fehlerhafte Remote-APIs zu verlassen, bündelt dieses Repository **19 eigene, lokale MCP-Wrapper** (im Ordner `mcps/`). Diese werden automatisch erstellt/aufgewärmt und ermöglichen Ihrem KI-Assistenten das Lesen, Schreiben und Ausführen von Befehlen in der führenden Kreativsoftware der Branche.
441
441
 
442
442
  <details>
443
443
  <summary><strong>🎨 Adobe Creative Cloud (Illustrator, Photoshop, After Effects, Premiere Pro)</strong></summary>
package/README.md CHANGED
@@ -10,17 +10,17 @@
10
10
  [![GitHub stars](https://img.shields.io/github/stars/hybridlabor-api/aos?style=flat&color=gold)](https://github.com/hybridlabor-api/aos/stargazers)
11
11
  [![last commit](https://img.shields.io/github/last-commit/hybridlabor-api/aos.svg)](https://github.com/hybridlabor-api/aos/commits/main)
12
12
 
13
- [![skills](https://img.shields.io/badge/skills-183%20curated-brightgreen.svg)](docs/skills_table.md)
13
+ [![skills](https://img.shields.io/badge/skills-184%20curated-brightgreen.svg)](docs/skills_table.md)
14
14
  [![MCPs](https://img.shields.io/badge/local%20MCPs-19-brightgreen.svg)](mcps/)
15
15
  [![harnesses](https://img.shields.io/badge/harnesses-9%20supported-blueviolet.svg)](#-installation)
16
16
  [![runtime](https://img.shields.io/badge/node-20+-blue.svg)](https://github.com/hybridlabor-api/aos)
17
17
  [![SkillSpector](https://img.shields.io/badge/NVIDIA%20SkillSpector-CLEAN-76B900?logo=nvidia&logoColor=white)](https://github.com/NVIDIA/SkillSpector)
18
18
 
19
- > **Supercharging AI coding agents with 183 hyper-curated skills, 21 local MCP wrappers, and a runnable multi-agent dispatcher graph.**
19
+ > **Supercharging AI coding agents with 184 hyper-curated skills, 19 local MCP wrappers, and a runnable multi-agent dispatcher graph.**
20
20
 
21
- 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.
21
+ 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.
22
22
 
23
- **Current release:** `v4.4.2` (beta channel) — see the NPM badge above for the exact published version.
23
+ **Current release:** `v4.5.0` — see the NPM badge above for the exact published version.
24
24
 
25
25
  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.
26
26
 
@@ -98,16 +98,16 @@ separately if you want the same routing available outside a `/startcycle` run.
98
98
  ## Overview
99
99
 
100
100
  This repo ships three things: a curated skill library for coding agents, an
101
- installer that wires them (plus 21 local MCP wrappers) into whichever harness
101
+ installer that wires them (plus 19 local MCP wrappers) into whichever harness
102
102
  you use, and a dispatcher graph that orchestrates them as a multi-agent
103
103
  build pipeline. See [AOS: The Dispatcher Graph](#-aos-the-dispatcher-graph)
104
104
  below for how the pipeline itself works.
105
105
 
106
106
  ---
107
107
 
108
- ## 🌟 183 Optimized Skills
108
+ ## 🌟 184 Optimized Skills
109
109
 
110
- 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**).
110
+ 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**).
111
111
 
112
112
  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.
113
113
 
@@ -138,7 +138,7 @@ While heavily optimized for the creative tech industry, these skills are deeply
138
138
 
139
139
  ## 🗂️ The Complete Skill Library
140
140
 
141
- 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.
141
+ 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.
142
142
 
143
143
  <details>
144
144
  <summary><strong>🎨 Frontend & UI/UX Design</strong> — 20 skills</summary>
@@ -482,11 +482,11 @@ BDBrainstorm combines multi-agent brainstorming, the `/grill-me` slash command,
482
482
 
483
483
  ---
484
484
 
485
- ## 🔌 21 Local MCP Wrappers
485
+ ## 🔌 19 Local MCP Wrappers
486
486
 
487
487
  ![BDB Architecture Sketch](assets/bdb_architecture_sketch.jpg)
488
488
 
489
- 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.
489
+ 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.
490
490
 
491
491
  <details>
492
492
  <summary><strong>🎨 Adobe Creative Cloud (Illustrator, Photoshop, After Effects, Premiere Pro)</strong></summary>
package/README.pt.md CHANGED
@@ -20,12 +20,12 @@
20
20
  [![NPM Version](https://img.shields.io/npm/v/@hybridlabor-api/aos.svg)](https://www.npmjs.com/package/@hybridlabor-api/aos)
21
21
  [![runtime](https://img.shields.io/badge/node-20+-blue.svg)](https://github.com/hybridlabor-api/aos)
22
22
  [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
23
- [![skills](https://img.shields.io/badge/skills-183%20curadas-brightgreen.svg)](https://github.com/hybridlabor-api/aos)
23
+ [![skills](https://img.shields.io/badge/skills-184%20curadas-brightgreen.svg)](https://github.com/hybridlabor-api/aos)
24
24
  [![SkillSpector](https://img.shields.io/badge/NVIDIA%20SkillSpector-CLEAN-76B900?logo=nvidia&logoColor=white)](https://github.com/NVIDIA/SkillSpector)
25
25
 
26
- > **Potencializando agentes de código de IA com 183 skills hipercuradas, 19 wrappers MCP locais e um grafo dispatcher de multi-agentes executável.**
26
+ > **Potencializando agentes de código de IA com 184 skills hipercuradas, 19 wrappers MCP locais e um grafo dispatcher de multi-agentes executável.**
27
27
 
28
- 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.
28
+ 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.
29
29
 
30
30
  É 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.
31
31
 
@@ -81,14 +81,14 @@ Nenhum destes vem dentro deste pacote — são plugins do Claude Code independen
81
81
  ## Visão Geral
82
82
 
83
83
  Este repositório entrega três coisas: uma biblioteca curada de skills para agentes de código, um
84
- instalador que conecta eles (mais 21 wrappers MCP locais) em qualquer harness
84
+ instalador que conecta eles (mais 19 wrappers MCP locais) em qualquer harness
85
85
  que você use, e um grafo dispatcher que os orquestra como um pipeline de
86
86
  build multi-agente. Veja [AOS: O Grafo Dispatcher](#-aos-o-grafo-dispatcher)
87
87
  abaixo para entender como o próprio pipeline funciona.
88
88
 
89
- ## 🌟 183 Skills Otimizadas
89
+ ## 🌟 184 Skills Otimizadas
90
90
 
91
- 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**).
91
+ 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**).
92
92
 
93
93
  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.
94
94
 
@@ -97,7 +97,7 @@ Em vez de deixar os agentes vagando por instruções genéricas, o nível superi
97
97
  - **`godmode-engineering`**: Impõe Domain-Driven Design, verificações rígidas de TypeScript, Clean Architecture e depuração sistemática.
98
98
  - **`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.
99
99
  - **`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.
100
- - **`godmode-eventtech`**: O livro de regras supremo para o BDB Creator Engine, governando 3D, Mídia e 21 wrappers MCP de tecnologia criativa.
100
+ - **`godmode-eventtech`**: O livro de regras supremo para o BDB Creator Engine, governando 3D, Mídia e 19 wrappers MCP de tecnologia criativa.
101
101
  - **`godmode-3d-creation`**: Controla o pipeline 3D agêntico (TripoSR, TRELLIS) para modelos generativos e estruturas CAD.
102
102
  - **`godmode-media-creation`**: Orquestra a produção automatizada de vídeo, narrativa e loops de geração do ComfyUI.
103
103
 
@@ -121,7 +121,7 @@ Abaixo está a visão geral completa de todas as skills curadas de agentes inclu
121
121
  |------------|-------------|
122
122
  | `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. |
123
123
  | `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. |
124
- | `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. |
124
+ | `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. |
125
125
  | `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. |
126
126
  | `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. |
127
127
  | `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`,
425
425
 
426
426
  ---
427
427
 
428
- ## 🔌 21 Integrações Locais de MCPP
428
+ ## 🔌 19 Integrações Locais de MCPs
429
429
 
430
430
  ![BDB Architecture Sketch](assets/bdb_architecture_sketch.jpg)
431
431
 
432
- 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.
432
+ 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.
433
433
 
434
434
  <details>
435
435
  <summary><strong>🎨 Adobe Creative Cloud (Illustrator, Photoshop, After Effects, Premiere Pro)</strong></summary>
package/installer.js CHANGED
@@ -1996,6 +1996,91 @@ async function installSynapse() {
1996
1996
  }
1997
1997
  }
1998
1998
 
1999
+ async function installOpenWikiVisualizer() {
2000
+ if (DRY_RUN) {
2001
+ log.step('[dry-run] would register the OpenWiki Visualizer background daemon (Port 4321)');
2002
+ return;
2003
+ }
2004
+ if (!hasExecutable('openwiki')) {
2005
+ log.warn('Skipping OpenWiki Visualizer setup: the openwiki CLI was not found on PATH. Install it with: npm install -g openwiki@latest');
2006
+ return;
2007
+ }
2008
+ // launchd starts agents with a minimal PATH that never includes npm's global
2009
+ // bin dir, so resolve the absolute binary path now instead of relying on PATH at boot.
2010
+ let openwikiBin = 'openwiki';
2011
+ try {
2012
+ const lookup = process.platform === 'win32' ? 'where openwiki' : 'command -v openwiki';
2013
+ openwikiBin = execSync(lookup, { encoding: 'utf8' }).split(/\r?\n/)[0].trim() || 'openwiki';
2014
+ } catch (e) { logDebug(e, 'openwiki path lookup'); }
2015
+
2016
+ if (process.platform === 'darwin') {
2017
+ const plistPath = path.join(homeDir, 'Library', 'LaunchAgents', 'com.bdb.openwiki-visualize.plist');
2018
+ const plistContent = `<?xml version="1.0" encoding="UTF-8"?>
2019
+ <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
2020
+ <plist version="1.0">
2021
+ <dict>
2022
+ <key>Label</key>
2023
+ <string>com.bdb.openwiki-visualize</string>
2024
+ <key>ProgramArguments</key>
2025
+ <array>
2026
+ <string>${openwikiBin}</string>
2027
+ <string>visualize</string>
2028
+ <string>--port</string>
2029
+ <string>4321</string>
2030
+ <string>--no-open</string>
2031
+ </array>
2032
+ <key>WorkingDirectory</key>
2033
+ <string>${homeDir}</string>
2034
+ <key>RunAtLoad</key>
2035
+ <true/>
2036
+ <key>KeepAlive</key>
2037
+ <true/>
2038
+ <key>StandardOutPath</key>
2039
+ <string>${path.join(homeDir, '.openwiki', 'visualize.stdout.log')}</string>
2040
+ <key>StandardErrorPath</key>
2041
+ <string>${path.join(homeDir, '.openwiki', 'visualize.stderr.log')}</string>
2042
+ </dict>
2043
+ </plist>`;
2044
+ try {
2045
+ fs.mkdirSync(path.join(homeDir, '.openwiki'), { recursive: true });
2046
+ fs.writeFileSync(plistPath, plistContent);
2047
+ execSync(`launchctl unload "${plistPath}" 2>/dev/null || true`, { stdio: 'ignore' });
2048
+ execSync(`launchctl load -w "${plistPath}" 2>/dev/null || true`, { stdio: 'ignore' });
2049
+ const isListening = await verifyDaemonListening(4321, 'OpenWiki Visualizer');
2050
+ if (isListening) {
2051
+ log.success('OpenWiki Visualizer LaunchAgent active (Port 4321)');
2052
+ } else {
2053
+ 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.');
2054
+ }
2055
+ } catch (e) { logDebug(e, 'openwiki visualizer plist setup'); }
2056
+ } else if (process.platform === 'win32') {
2057
+ const startupDir = path.join(process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming'), 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup');
2058
+ fs.mkdirSync(startupDir, { recursive: true });
2059
+ const visualizerLogDir = path.join(homeDir, '.openwiki');
2060
+ fs.mkdirSync(visualizerLogDir, { recursive: true });
2061
+ const stdoutLog = path.join(visualizerLogDir, 'visualize.stdout.log');
2062
+ const stderrLog = path.join(visualizerLogDir, 'visualize.stderr.log');
2063
+ const batPath = path.join(visualizerLogDir, 'run-openwiki-visualize.bat');
2064
+ const runCmd = `"${openwikiBin}" visualize --port 4321 --no-open`;
2065
+ const batContent = `@echo off\r\ncd /d "${homeDir}"\r\n${runCmd} >> "${stdoutLog}" 2>> "${stderrLog}"\r\n`;
2066
+ const vbsPath = path.join(startupDir, 'com.bdb.openwiki-visualize.vbs');
2067
+ const vbsContent = `Set WshShell = CreateObject("WScript.Shell")\r\nWshShell.CurrentDirectory = "${homeDir}"\r\nWshShell.Run """${batPath}""", 0, False\r\n`;
2068
+ try {
2069
+ fs.writeFileSync(batPath, batContent, 'utf-8');
2070
+ fs.writeFileSync(vbsPath, vbsContent, 'utf-8');
2071
+ spawn('wscript.exe', [vbsPath], { detached: true, stdio: 'ignore' }).unref();
2072
+ // Same reasoning as the Synapse Windows path: wscript -> WshShell.Run is
2073
+ // multiple layers of indirection, so allow the generous 12s budget here too.
2074
+ const isListening = await verifyDaemonListening(4321, 'OpenWiki Visualizer', 12000);
2075
+ if (isListening) {
2076
+ log.success('OpenWiki Visualizer Windows Background Service registered & started (Port 4321)');
2077
+ } else {
2078
+ 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.`);
2079
+ }
2080
+ } catch (e) { logDebug(e, 'windows openwiki visualizer daemon setup'); }
2081
+ }
2082
+ }
2083
+
1999
2084
  async function installCreatorExtension() {
2000
2085
  const creatorDir = path.join(moduleBasePath(), 'bdb-dev-creator-extension');
2001
2086
  if (!downloadOrUpdateModule('@hybridlabor-api/bdb-dev-creator-extension', creatorDir, 'BDB Creator Extension')) {
@@ -3348,6 +3433,7 @@ function generateAndOpenLaunchpad() {
3348
3433
  <meta charset="UTF-8">
3349
3434
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
3350
3435
  <title>BDB Agent OS – Launchpad</title>
3436
+ <link rel="icon" type="image/svg+xml" href="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA1MTIgNTEyIj48ZGVmcz48bGluZWFyR3JhZGllbnQgaWQ9ImEiIHgxPSIwJSIgeTE9IjAlIiB4Mj0iMTAwJSIgeTI9IjEwMCUiPjxzdG9wIG9mZnNldD0iMCUiIHN0b3AtY29sb3I9IiNGRkZGRkYiLz48c3RvcCBvZmZzZXQ9IjEwMCUiIHN0b3AtY29sb3I9IiNFN0U3RUEiLz48L2xpbmVhckdyYWRpZW50PjwvZGVmcz48Y2lyY2xlIGN4PSIyNTYiIGN5PSIyNTYiIHI9IjI0NiIgZmlsbD0iIzBhMGEwYSIgc3Ryb2tlPSIjOWIzMGM0IiBzdHJva2Utd2lkdGg9IjEyIi8+PGcgdHJhbnNmb3JtPSJ0cmFuc2xhdGUoNzAsNjgpIj48cGF0aCBmaWxsPSJ1cmwoI2EpIiBkPSJNMTgxLjYzLjA1YzEwMS4zOS0yLjQ3LDE4NC41Niw4MC4wOSwxOTAuMTQsMTc5LjkzLDUuNTMsOTkuMDMtNjYuMTYsMTg1LjQyLTE2NS4xMSwxOTUuNDYtODcuMzksOC44Ni0xNzEuMS00NS41Ni0xOTcuNjctMTI4Ljk2Qy0yOC43NCwxMjguMDMsNTYuNzgsMy4xLDE4MS42My4wNWgwWk0xNzcuNSwyMS4zQzY5LjA5LDI1LjMxLTcuMTYsMTI5LjYyLDIxLjc2LDIzNC41MmMxOC43Miw2Ny44OCw4MS41NiwxMTYuNywxNTEuNTMsMTIxLjMyLDEwNi4yMSw3LjAzLDE5NS42LTgxLjYzLDE3OS42OC0xODkuMDYtMTIuNTQtODQuNjUtODkuODEtMTQ4LjY2LTE3NS40Ny0xNDUuNDloMFoiLz48ZyBmaWxsPSIjRkZGRkZGIj48cGF0aCBkPSJNMTQ3LjY5LDEyMC4wNWMxMi4wNC4zNiwyNC42NC0uNzIsMzYuNjItLjA3LDI0LjI5LDEuMzIsNDEuMzcsMjAuMTMsNDIuOTEsNDMuOTktLjY5LDE2LjM1LjU3LDMzLjQyLS4yOCw0OS42OS0xLjMxLDI1LjQyLTE4LjU1LDQzLjc1LTQ0LjAyLDQ1LjY0LTkuNTkuNzItMjAuMTQuNjktMjkuNzguODQtNC45Ny4wOC05LjkuNjgtMTAuMzctNS42NnMuNDMtOS40MS4zNC0xNC4wM2MxMi42NS0xMS44NCwxNC43NS0zMS4xNyw0Ljc1LTQ1LjQxLS42My0uOS0yLjI2LTIuMzQtMi42Mi0zLjE3cy0uNDYtMTIuNTgtLjI2LTE0LjM3LDEuMS0zLjUyLDEuNDYtNS4xNmMxLjIxLTUuNDIsMS4wNi0xMS4yNi0uMzktMTYuNjItLjQxLTEuNTQtMS40OC0zLjU2LTEuNjMtNC45OS0uNDctNC4yOC0uMTQtOS42Ny0uMjYtMTQuMDgtLjExLTMuNTYtLjg0LTguNDMtLjU3LTExLjg2czEuMzItNC4zNSw0LjA4LTQuNzVoMFoiLz48cGF0aCBkPSJNMjMyLjY2LDEzMi40NmM5LjUzLjM2LDE5Ljc0LS43MiwyOS4xOS0uMDgsMjIuNjQsMS41MiwzMy45MiwyOC41OCwyMS45Myw0Ny4wNS0xLjQ5LDIuMy00LjMyLDQuNDctMy44NSw3LjQyLjQ3LDIuOTUsNS42NCw2LjIxLDcuNDIsOC4zLDExLjg4LDEzLjk2LDguNDEsMzUuNjktNi45MSw0NS40OS03Ljg1LDUuMDItMTQuNjksNC40My0yMy41Niw0Ljg2LTcuNjcuMzctMTYuMjQsMS4wNS0yMy45MS42NloiLz48cGF0aCBkPSJNOTAuNTksMTMzLjAzYzguODQtLjQ0LDI1LjI0LTEuMDgsMzMuMjMsMS45MiwxOC4wNyw2Ljc3LDIzLjk5LDI5Ljk2LDEzLjU2LDQ1LjctMS42LDIuNDEtNC41Miw0LjQ0LTMuMjgsNy43NS42OSwxLjg1LDUuNDEsNS40Miw3LjAzLDcuMzEsMTEuODYsMTMuODIsOC43NywzNS4yMy02LjI1LDQ1LjMzLTE1LjAyLDEwLjEtMjMuMzEsNS4yNy0zNC40NCw1LjU2WiIvPjwvZz48L2c+PC9zdmc+">
3351
3437
  <link rel="preconnect" href="https://fonts.googleapis.com">
3352
3438
  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
3353
3439
  <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 +3474,7 @@ function generateAndOpenLaunchpad() {
3388
3474
  margin-bottom: 6px;
3389
3475
  }
3390
3476
  .logo-mark { width: 36px; height: 36px; flex-shrink: 0; }
3391
- .logo-badge {
3392
- background: linear-gradient(135deg, #ffffff 0%, #c77dea 60%, #9b30c4 100%);
3393
- -webkit-background-clip: text;
3394
- -webkit-text-fill-color: transparent;
3395
- }
3477
+ .logo-badge { color: #ffffff; }
3396
3478
  .tagline { color: var(--text-muted); font-size: 14px; font-weight: 400; }
3397
3479
  .grid { display: flex; flex-direction: column; gap: 12px; }
3398
3480
  .card {
@@ -3600,6 +3682,30 @@ function generateAndOpenLaunchpad() {
3600
3682
  <span class="status-dot" id="dot-remote" title="Checking..."></span>
3601
3683
  </div>
3602
3684
  </a>
3685
+ <a class="card" href="http://127.0.0.1:4321" target="_blank">
3686
+ <div class="card-content">
3687
+ <div class="card-icon"><svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
3688
+ <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>
3689
+ <rect x="26" y="16" width="48" height="68" rx="4" fill="url(#grad-openwiki)" opacity="0.9"/>
3690
+ <line x1="36" y1="32" x2="64" y2="32" stroke="#0a0a0a" stroke-width="2.5" opacity="0.5"/>
3691
+ <line x1="36" y1="42" x2="64" y2="42" stroke="#0a0a0a" stroke-width="2.5" opacity="0.5"/>
3692
+ <line x1="36" y1="52" x2="52" y2="52" stroke="#0a0a0a" stroke-width="2.5" opacity="0.5"/>
3693
+ <circle cx="70" cy="68" r="14" fill="#0a0a0a" stroke="#FFFFFF" stroke-width="2"/>
3694
+ <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"/>
3695
+ <line x1="65" y1="64" x2="74" y2="63" stroke="#FFFFFF" stroke-width="1.2" opacity="0.7"/>
3696
+ <line x1="65" y1="64" x2="70" y2="72" stroke="#FFFFFF" stroke-width="1.2" opacity="0.7"/>
3697
+ <line x1="74" y1="63" x2="70" y2="72" stroke="#FFFFFF" stroke-width="1.2" opacity="0.7"/>
3698
+ </svg></div>
3699
+ <div class="card-info">
3700
+ <h2>OpenWiki</h2>
3701
+ <p>Grounded Documentation & Evidence Graph</p>
3702
+ </div>
3703
+ </div>
3704
+ <div class="card-meta">
3705
+ <span class="port-pill">:4321</span>
3706
+ <span class="status-dot" id="dot-openwiki" title="Checking..."></span>
3707
+ </div>
3708
+ </a>
3603
3709
  </div>
3604
3710
  <div class="footer">
3605
3711
  <span>Autostart Daemons • 127.0.0.1</span>
@@ -3618,6 +3724,7 @@ function generateAndOpenLaunchpad() {
3618
3724
  checkHealth('http://127.0.0.1:7781', 'dot-synapse');
3619
3725
  checkHealth('http://127.0.0.1:3101', 'dot-ao');
3620
3726
  checkHealth('http://127.0.0.1:9080', 'dot-remote');
3727
+ checkHealth('http://127.0.0.1:4321', 'dot-openwiki');
3621
3728
  }
3622
3729
  checkAllHealth();
3623
3730
  setInterval(checkAllHealth, 5000);
@@ -3845,6 +3952,7 @@ async function runQuickUpdate(installState) {
3845
3952
  const creds = await promptCredentials(paths.targetMcpDir);
3846
3953
  if (creds !== BACK) {
3847
3954
  await installOpenWikiDaemon(creds.gemini, paths.targetSkillDir, { provider: creds.openwikiProvider, model: creds.openwikiModel, baseUrl: creds.openwikiBaseUrl });
3955
+ await installOpenWikiVisualizer();
3848
3956
  }
3849
3957
  }
3850
3958
 
@@ -4257,6 +4365,7 @@ async function main() {
4257
4365
  }
4258
4366
 
4259
4367
  await installOpenWikiDaemon(creds.gemini, primaryTarget.targetSkillDir, { provider: creds.openwikiProvider, model: creds.openwikiModel, baseUrl: creds.openwikiBaseUrl });
4368
+ await installOpenWikiVisualizer();
4260
4369
  await installTokenSaver(primaryTarget.platformValue);
4261
4370
 
4262
4371
  const installedModulesForPrompt = (installState && installState.installedModules) || [];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hybridlabor-api/aos",
3
- "version": "4.4.2-beta.9",
3
+ "version": "4.5.0",
4
4
  "description": "AOS — A Curated AI AGENT OS. Optimized agent skills and add-ons like memB, OpenWiki, Heimdall Token Saver, and Godmode architectures.",
5
5
  "main": "installer.js",
6
6
  "engines": {
@@ -94,6 +94,13 @@ fi
94
94
 
95
95
  # 3. Resolve provider and API key
96
96
  OPENWIKI_PROVIDER="${OPENWIKI_PROVIDER:-google}"
97
+ # set -u is active; a provider that needs no model override/base URL (the
98
+ # common case) never gets these exported, and the bare $OPENWIKI_MODEL /
99
+ # $OPENWIKI_BASE_URL reads inside write_launcher()'s subshell used to abort
100
+ # that subshell on "unbound variable" -- silently truncating the launcher
101
+ # before it reached the API key export or the final exec line.
102
+ OPENWIKI_MODEL="${OPENWIKI_MODEL:-}"
103
+ OPENWIKI_BASE_URL="${OPENWIKI_BASE_URL:-}"
97
104
 
98
105
  # Map provider to its API key environment variable name
99
106
  case "$OPENWIKI_PROVIDER" in