@hybridlabor-api/aos 4.4.2-beta.4 → 4.4.2-beta.6

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.
Files changed (8) hide show
  1. package/README.de.md +18 -12
  2. package/README.md +79 -13
  3. package/README.pt.md +17 -12
  4. package/docs/backups/hub-overview-20260915.html +200 -0
  5. package/docs/backups/hub-overview-rewrite-plan.md +98 -0
  6. package/docs/backups/readme-update-plan.md +393 -0
  7. package/installer.js +43 -6
  8. package/package.json +1 -1
package/README.de.md CHANGED
@@ -52,9 +52,11 @@ Der Installer verfügt jetzt über eine vollautomatische Universal Sync Engine.
52
52
  - **Tier 9 - Local Project Harness:** Anstatt global in `$HOME` zu installieren, können Entwickler den `.agents` Contract und die Hooks nun direkt in isolierte Projektordner injizieren.
53
53
 
54
54
  ### 🧩 Ecosystem-Integrationen (v4.0.0)
55
- Dieses Paket dient als Brücke zu zwei gewaltigen vorgelagerten Funktionen (verfügbar als direkte Installationsziele über den Installer):
56
- - **BDB OS Agent Workspace:** Die Orchestrierungsschicht für parallele KI-Agenten. Starten Sie mehrere isolierte Agenten-Sitzungen über Git-Worktrees mit Live-Terminalsteuerung, automatischen CI/CD-Feedbackschleifen und PR-Review-Routing.
55
+ Dieses Paket dient als Brücke zu vier gewaltigen vorgelagerten Funktionen (verfügbar als direkte Installationsziele über den Installer):
56
+ - **BDB AO — Agent Orchestrator:** Die Orchestrierungsschicht für parallele KI-Agenten. Starten Sie mehrere isolierte Agenten-Sitzungen über Git-Worktrees mit Live-Terminalsteuerung, automatischen CI/CD-Feedbackschleifen und PR-Review-Routing. Ships mit einem vorkompilierten Binary (macOS, Apple Silicon); andere Plattformen bauen aus Quellcode. Setzt die jetzt archivierte `bdb-os-agent-workspace` Vorversion außer Kraft — installieren Sie die alte nicht.
57
57
  - **BDB Creator Extension:** Die leistungsstarke Agentic Media Pipeline. Verleiht Agenten lokale ComfyUI MCP-Fähigkeiten (FLUX, SDXL), Image-to-3D-Generierung (TripoSR, TRELLIS) und automatisierte Videoproduktion über OpenMontage und Remotion.
58
+ - **BDB Synapse:** 3D-Codebase-Visualisierung & Agent-Session-Replay. Renderiert Ihr Repository als interaktive Code-Stadt und spielt Agent-Sessions als Lichtspur auf, die anzeigt, welche Dateien gelesen, bearbeitet und wo Friktion auftrat.
59
+ - **BDB Hardware & PCB:** Optionales Electrical-/PCB-Design-Modul. Zwei lokale MCP-Server (KiCad, OpenSCAD) mit 55 Tools, plus 5 Skills für Schaltplan-Capture, Layout/Routing und DFM-Freigabe. Installieren Sie eigenständig oder über den optionalen Modul-Picker des Installers; gekoppelt mit der Core-Persona `godmode-hardware-pcb`.
58
60
 
59
61
 
60
62
  ### 🔗 Empfohlene Companion-Plugins (Claude Code)
@@ -86,8 +88,8 @@ Wir haben mit einem gewaltigen Pool von über 1.400 rohen KI-Skills begonnen. Na
86
88
 
87
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.
88
90
 
89
- ### 🛡️ Die 6 Godmodes (Apex Layer)
90
- Anstatt Agenten durch generische Anweisungen irren zu lassen, setzt die oberste Ebene dieses Repositories sechs **Hochkuratierte Godmodes** durch. Diese fungieren als ultimative Wächter für Ihre Codebasis:
91
+ ### 🛡️ Die 7 Godmodes (Apex Layer)
92
+ Anstatt Agenten durch generische Anweisungen irren zu lassen, setzt die oberste Ebene dieses Repositories sieben **Hochkuratierte Godmodes** durch. Diese fungieren als ultimative Wächter für Ihre Codebasis:
91
93
  - **`godmode-engineering`**: Erzwingt Domain-Driven Design, strenge TypeScript-Prüfungen, Clean Architecture und systematisches Debugging.
92
94
  - **`godmode-ui-ux`**: Der Frontend-Goldstandard. Erzwingt BDB "Anti-Slop"-Prinzipien, Barrierefreiheit (Accessibility) und fluide Bewegungsdynamiken.
93
95
  - **`godmode-shipping`**: Der finale Wächter für Production Releases. Erzwingt Spec-Driven Development, Pre-Launch-Prüfungen und sichere Rollbacks.
@@ -580,14 +582,17 @@ tail -f ~/.openwiki/daemon.log
580
582
 
581
583
  ---
582
584
 
583
- ## 🖥️ BDB OS Agent Workspace: Parallele Multi-Agenten-Orchestrierung
585
+ ## 🖥️ BDB AO — Agent Orchestrator: Parallele Multi-Agenten-Orchestrierung
584
586
 
585
- [![Repo](https://img.shields.io/badge/repo-bdb--os--agent--workspace-blue.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
586
- [![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
587
- [![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
587
+ [![Repo](https://img.shields.io/badge/repo-bdb--agent--orchestrator-blue.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
588
+ [![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
589
+ [![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
588
590
  [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
589
591
 
590
- **BDB OS Agent Workspace** ist der Desktop Meta-Harness und die Orchestrierungsschicht, entwickelt für parallele KI-Agenten. Es ermöglicht Entwicklern, mehrere isolierte Agenten-Sitzungen gleichzeitig über unabhängige Git-Worktrees hinweg zu starten, zu verwalten und zu koordinieren, inklusive Echtzeit-Terminal-Feedback-Schleifen und automatisiertem PR-Review-Routing.
592
+ **BDB AO** (`@hybridlabor-api/bdb-agent-orchestrator`, CLI: `ao`) ist der Desktop Meta-Harness und die Orchestrierungsschicht, entwickelt für parallele KI-Agenten. Es ermöglicht Entwicklern, mehrere isolierte Agenten-Sitzungen gleichzeitig über unabhängige Git-Worktrees hinweg zu starten, zu verwalten und zu koordinieren, inklusive Echtzeit-Terminal-Feedback-Schleifen und automatisiertem PR-Review-Routing.
593
+
594
+ > [!NOTE]
595
+ > AO ersetzt den früheren **BDB OS Agent Workspace** (`bdb-os-agent-workspace`). Dieses Repository ist archiviert, und sein letztes Release stammt von vor der Archivierung — es enthält einen bekannten Defekt in seiner CI/CD-Feedback-Schleife. Der AOS-Installer bietet ausschließlich AO an; das alte Repository nicht klonen.
591
596
 
592
597
  ```mermaid
593
598
  flowchart TD
@@ -620,8 +625,9 @@ flowchart TD
620
625
  </details>
621
626
 
622
627
  <details>
623
- <summary><strong>🔌 Unterstützte Harnesses & Direkter Repository-Link</strong></summary>
628
+ <summary><strong>🔌 Plattform-Support, Unterstützte Harnesses & Direkter Repository-Link</strong></summary>
624
629
 
630
+ - **Plattform-Support:** Liefert heute ein vorgebautes Binary — macOS, Apple Silicon (arm64). Windows- und Linux-Quellen liegen im Paket, sind aber nicht vorgebaut; auf diesen Plattformen aus dem Quellcode bauen (`go build`).
625
631
  - **Unterstützte Agenten-Harnesses:**
626
632
  - **Google Antigravity / AGY CLI**
627
633
  - **Claude Desktop & Claude Code**
@@ -629,10 +635,10 @@ flowchart TD
629
635
  - **Roo Code & Cline**
630
636
  - **ChatGPT Codex / Codex CLI**
631
637
  - **Aider & VS Code**
632
- - **Direktes Repository:** Greifen Sie auf den Workspace-Orchestrator unter [github.com/hybridlabor-api/bdb-os-agent-workspace](https://github.com/hybridlabor-api/bdb-os-agent-workspace) zu.
638
+ - **Direktes Repository:** Greifen Sie auf den Orchestrator unter [github.com/hybridlabor-api/bdb-agent-orchestrator](https://github.com/hybridlabor-api/bdb-agent-orchestrator) zu.
633
639
 
634
640
  ```bash
635
- git clone https://github.com/hybridlabor-api/bdb-os-agent-workspace.git
641
+ git clone https://github.com/hybridlabor-api/bdb-agent-orchestrator.git
636
642
  ```
637
643
  </details>
638
644
 
package/README.md CHANGED
@@ -18,7 +18,9 @@
18
18
 
19
19
  > **Supercharging AI coding agents with 169 hyper-curated skills, 21 local MCP wrappers, and a runnable multi-agent dispatcher graph.**
20
20
 
21
- Welcome to **BDB Agent OS — AOS v4.0.0**: 169 curated skills, 21 local MCP wrappers, and a dispatcher graph that turns them 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**: 169 curated skills, 21 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
+
23
+ **Current release:** `v4.4.2` (beta channel) — see the NPM badge above for the exact published version.
22
24
 
23
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.
24
26
 
@@ -60,10 +62,11 @@ The installer features a fully automated Universal Sync engine. It scans your sy
60
62
  - **Local Project Harness:** Instead of installing globally into `$HOME`, drop the `.agents` contract, the gate hooks and the dispatcher workflow directly into a single project — `npx @hybridlabor-api/aos --project-harness`.
61
63
 
62
64
  ### 🧩 Ecosystem Integrations
63
- This package acts as the bridge to three major upstream capabilities:
64
- - **BDB OS Agent Workspace:** The Orchestration Layer for parallel AI agents. Start multiple isolated agent sessions via Git-Worktrees with live terminal control, automatic CI/CD feedback loops, and PR review routing.
65
+ This package acts as the bridge to four major upstream capabilities:
66
+ - **BDB AO — Agent Orchestrator:** The orchestration layer for parallel AI agents. Start multiple isolated agent sessions via Git worktrees with live terminal control, automatic CI/CD feedback loops, and PR review routing. Ships one prebuilt binary today (macOS, Apple Silicon); other platforms build from source. Supersedes the now-archived `bdb-os-agent-workspace` repository — do not install that one.
65
67
  - **BDB Creator Extension:** The heavy-lifting Agentic Media Pipeline. Gives agents local ComfyUI MCP capabilities (FLUX, SDXL), Image-to-3D generation (TripoSR, TRELLIS), and automated video production through OpenMontage and Remotion.
66
68
  - **BDB Synapse:** 3D Codebase Visualization & Agent Session Replay. Renders your repository as an interactive code city and replays agent sessions as light trails, showing which files were read, edited, and where friction occurred.
69
+ - **BDB Hardware & PCB:** Optional electrical/PCB design module. Two local MCP servers (KiCad, OpenSCAD) exposing 55 tools, plus 5 skills covering schematic capture, layout/routing, and DFM sign-off. Install standalone or via this installer's optional-module picker; paired with the core `godmode-hardware-pcb` persona.
67
70
 
68
71
  ### 🔗 Recommended Companion Plugins (Claude Code)
69
72
  Neither of these ships inside this package — they are independent, community-maintained
@@ -110,9 +113,9 @@ These skills are precision-engineered to ensure agents waste no time on redundan
110
113
 
111
114
  ---
112
115
 
113
- ### 🛡️ The 6 Godmodes (Apex Layer)
116
+ ### 🛡️ The 7 Godmodes (Apex Layer)
114
117
 
115
- Instead of letting agents wander through generic instructions, the top-tier of this repository enforces six **Hyper-Curated Godmodes**. Three of them are not just skills — they are the literal build/ship nodes the [dispatcher graph](#-aos-the-dispatcher-graph) invokes (`UI_UX`, `Engineering`, `Shipping`); the other three cover 3D, media and event-tech work the same way.
118
+ Instead of letting agents wander through generic instructions, the top-tier of this repository enforces seven **Hyper-Curated Godmodes**. Three of them are not just skills — they are the literal build/ship nodes the [dispatcher graph](#-aos-the-dispatcher-graph) invokes (`UI_UX`, `Engineering`, `Shipping`); the other four cover 3D, media, event-tech, and hardware/PCB work the same way.
116
119
 
117
120
  | Godmode | Purpose |
118
121
  |---------|---------|
@@ -122,6 +125,7 @@ Instead of letting agents wander through generic instructions, the top-tier of t
122
125
  | **`godmode-eventtech`** | Architectural authority for real-time performance, signal flow, protocol routing, and hardware constraints in live show and event technology environments. |
123
126
  | **`godmode-3d-creation`** | MCP-First master orchestration for 3D generation, mesh reconstruction, and parametric CAD engineering. Interfaces with local 3D engines and MCP tools. |
124
127
  | **`godmode-media-creation`** | MCP-First master orchestration for all media creation pipelines (Video, Timeline Assembly, Beat Sync, Motion Design). Directly interfaces with local media engines and MCP tools. |
128
+ | **`godmode-hardware-pcb`** | Architectural authority for electrical schematics, PCB layout, and OpenSCAD enclosure co-design. Enforces IPC-standard trace/impedance math and a headless KiCad ERC/DRC/DFM gate before anything ships to fabrication. Ships in core; the KiCad/OpenSCAD skills and MCP servers it drives live in the optional [**BDB Hardware & PCB**](#-bdb-hardware--pcb-electrical--enclosure-design-module) module. |
125
129
 
126
130
  ### 💻 Beyond Events: Full-Stack Software & Web Agents
127
131
  While heavily optimized for the creative tech industry, these skills are deeply rooted in core software engineering:
@@ -627,14 +631,17 @@ tail -f ~/.openwiki/daemon.log
627
631
 
628
632
  ---
629
633
 
630
- ## 🖥️ BDB OS Agent Workspace: Parallel Multi-Agent Orchestration
634
+ ## 🖥️ BDB AO — Agent Orchestrator: Parallel Multi-Agent Orchestration
631
635
 
632
- [![Repo](https://img.shields.io/badge/repo-bdb--os--agent--workspace-blue.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
633
- [![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
634
- [![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
636
+ [![Repo](https://img.shields.io/badge/repo-bdb--agent--orchestrator-blue.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
637
+ [![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
638
+ [![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
635
639
  [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
636
640
 
637
- **BDB OS Agent Workspace** is the Desktop Meta-Harness and Orchestration Layer designed for parallel AI agents. It enables developers to spawn, manage, and coordinate multiple isolated agent sessions concurrently across independent Git Worktrees with real-time terminal feedback loops and automated PR review routing.
641
+ **BDB AO** (`@hybridlabor-api/bdb-agent-orchestrator`, CLI: `ao`) is the Desktop Meta-Harness and Orchestration Layer designed for parallel AI agents. It enables developers to spawn, manage, and coordinate multiple isolated agent sessions concurrently across independent Git Worktrees with real-time terminal feedback loops and automated PR review routing.
642
+
643
+ > [!NOTE]
644
+ > AO replaces the earlier **BDB OS Agent Workspace** (`bdb-os-agent-workspace`). That repository is archived and its final release predates the archiving — it ships with a known defect in its CI/CD feedback loop. The AOS installer only ever offers AO; do not clone the old repo.
638
645
 
639
646
  ```mermaid
640
647
  flowchart TD
@@ -667,8 +674,9 @@ flowchart TD
667
674
  </details>
668
675
 
669
676
  <details>
670
- <summary><strong>🔌 Supported Harnesses & Direct Repository Link</strong></summary>
677
+ <summary><strong>🔌 Platform Support, Supported Harnesses & Direct Repository Link</strong></summary>
671
678
 
679
+ - **Platform Support:** Ships one prebuilt binary today — macOS, Apple Silicon (arm64). Windows and Linux sources are in the package but not prebuilt; build from source (`go build`) on those platforms.
672
680
  - **Supported Agent Harnesses:**
673
681
  - **Google Antigravity / AGY CLI**
674
682
  - **Claude Desktop & Claude Code**
@@ -676,10 +684,10 @@ flowchart TD
676
684
  - **Roo Code & Cline**
677
685
  - **ChatGPT Codex / Codex CLI**
678
686
  - **Aider & VS Code**
679
- - **Direct Repository:** Access the workspace orchestrator at [github.com/hybridlabor-api/bdb-os-agent-workspace](https://github.com/hybridlabor-api/bdb-os-agent-workspace).
687
+ - **Direct Repository:** Access the orchestrator at [github.com/hybridlabor-api/bdb-agent-orchestrator](https://github.com/hybridlabor-api/bdb-agent-orchestrator).
680
688
 
681
689
  ```bash
682
- git clone https://github.com/hybridlabor-api/bdb-os-agent-workspace.git
690
+ git clone https://github.com/hybridlabor-api/bdb-agent-orchestrator.git
683
691
  ```
684
692
  </details>
685
693
 
@@ -804,6 +812,64 @@ npx @hybridlabor-api/bdb-os-remote installer
804
812
 
805
813
  ---
806
814
 
815
+ ## ⚡ BDB Hardware & PCB: Electrical & Enclosure Design Module
816
+
817
+ [![Repo](https://img.shields.io/badge/repo-bdb--hardware--pcb-blue.svg)](https://github.com/hybridlabor-api/bdb-hardware-pcb)
818
+ [![tools](https://img.shields.io/badge/MCP%20tools-55-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-hardware-pcb)
819
+ [![KiCad](https://img.shields.io/badge/KiCad-9%20%26%2010-orange.svg)](https://www.kicad.org/)
820
+ [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
821
+
822
+ **BDB Hardware & PCB** (`@hybridlabor-api/bdb-hardware-pcb`) brings electrical
823
+ schematic capture, PCB layout/routing, DFM sign-off, and parametric 3D
824
+ enclosure design into the agent loop — governed by the core
825
+ [`godmode-hardware-pcb`](#-the-7-godmodes-apex-layer) persona, which owns the
826
+ IPC-standard trace/impedance math and the headless KiCad ERC/DRC/DFM gate no
827
+ board is allowed to skip on its way to fabrication.
828
+
829
+ ```mermaid
830
+ flowchart LR
831
+ A[Agent] -->|MCP| B[kicad-mcp-server]
832
+ A -->|MCP| C[openscad-mcp-server]
833
+ B --> D[Schematic Capture & ERC]
834
+ B --> E[PCB Layout & Routing]
835
+ B --> F[DRC / DFM / Gerber Sign-Off]
836
+ C --> G[Parametric Enclosure — OpenSCAD/BOSL2]
837
+ D & E & F & G --> H[Fabrication-Ready Output]
838
+ ```
839
+
840
+ ### Two MCP Servers, 55 Tools
841
+ - **`kicad-mcp-server`** — 47 tools over stdio JSON-RPC for schematic capture, ERC, PCB layout, routing, DRC, and Gerber/BOM/CPL export. Targets **KiCad 9 & 10** via `kicad-cli`.
842
+ - **`openscad-mcp-server`** — 8 tools for parametric 3D enclosure and mechanical co-design (OpenSCAD + BOSL2).
843
+
844
+ ### 5 Skills (`category: engineering-hardware`)
845
+
846
+ | Skill | Description |
847
+ |-------|-------------|
848
+ | `schematic-datasheet-analysis` | Electrical rule auditing, datasheet grounding, pinout validation, power tree tracing, and negative-evidence analysis for KiCad schematics. |
849
+ | `pcb-constraint-definition` | Translates high-level hardware requirements into formal engineering constraints, layer stackup, netclasses, and custom DRC rules for KiCad. |
850
+ | `pcb-layout-routing-automation` | Floorplanning, placement rules, high-speed differential pair routing, return-path continuity, thermal via arrays, and keepout enforcement. |
851
+ | `pcb-validation-dfm-signoff` | Automated DRC/ERC verification, SI/PI screening, fab-house DFM/DFA compliance, and production release sign-off. |
852
+ | `code-first-hardware-design` | Programmatic schematic capture and circuit synthesis (SKiDL, text netlists, S-expressions) plus parametric 3D enclosure co-design. |
853
+
854
+ ### Install
855
+
856
+ Same optional-module mechanism as `bdb-synapse` and
857
+ `bdb-dev-creator-extension` — the main AOS installer downloads and runs it for
858
+ you, or install it standalone on macOS, Linux, or Windows:
859
+
860
+ ```bash
861
+ npx @hybridlabor-api/bdb-hardware-pcb
862
+ ```
863
+
864
+ Supported harnesses: **Claude Code**, **OpenAI Codex**, and **Google
865
+ Antigravity (Gemini)**. Verify a local install with:
866
+
867
+ ```bash
868
+ ./scripts/test_mcp_connection.sh --all
869
+ ```
870
+
871
+ ---
872
+
807
873
  ## 🧠 memB: Custom Semantic Brain
808
874
 
809
875
  BDB OS introduces a fully integrated local, offline-first semantic memory brain based on **memB**. It provides zero-compute context for SLMs and an AI-first flat-file vault architecture.
package/README.pt.md CHANGED
@@ -50,10 +50,11 @@ O instalador agora possui um motor Universal Sync totalmente automatizado. Ele v
50
50
  - **Local Project Harness:** Em vez de instalar globalmente em `$HOME`, os desenvolvedores podem injetar o contrato `.agents`, os hooks de portão e o workflow do dispatcher diretamente em um único projeto — `npx @hybridlabor-api/aos --project-harness`.
51
51
 
52
52
  ### 🧩 Integrações do Ecossistema
53
- Este pacote atua como a ponte para três grandes capacidades upstream:
54
- - **BDB OS Agent Workspace:** A camada de orquestração para agentes de IA paralelos. Inicie múltiplas sessões de agentes isoladas via Git-Worktrees com controle de terminal ao vivo, loops de feedback CI/CD automáticos e roteamento de revisão de PR.
53
+ Este pacote atua como a ponte para quatro grandes capacidades upstream:
54
+ - **BDB AO — Agent Orchestrator:** A camada de orquestração para agentes de IA paralelos. Inicie múltiplas sessões de agentes isoladas via Git-Worktrees com controle de terminal ao vivo, loops de feedback CI/CD automáticos e roteamento de revisão de PR. Envia um binário pré-compilado hoje (macOS, Apple Silicon); outras plataformas compilam a partir do código-fonte. Substitui o agora arquivado repositório `bdb-os-agent-workspace` — não instale o antigo.
55
55
  - **BDB Creator Extension:** O pipeline de mídia agêntica de alta capacidade. Fornece aos agentes capacidades MCP locais do ComfyUI (FLUX, SDXL), geração Image-to-3D (TripoSR, TRELLIS) e produção de vídeo automatizada através do OpenMontage e Remotion.
56
56
  - **BDB Synapse:** Visualização de Codebase 3D & Replay de Sessões de Agentes. Renderiza seu repositório como uma cidade de código interativa e repete as sessões de agentes como rastros de luz, mostrando quais arquivos foram lidos, editados e onde ocorreu atrito.
57
+ - **BDB Hardware & PCB:** Módulo de design elétrico/PCB opcional. Dois servidores MCP locais (KiCad, OpenSCAD) expondo 55 ferramentas, mais 5 skills cobrindo captura de esquemas, layout/roteamento e aprovação DFM. Instale de forma isolada ou através do seletor de módulo opcional do instalador; acoplado com a persona central `godmode-hardware-pcb`.
57
58
 
58
59
  ### 🔗 Plugins Complementares Recomendados (Claude Code)
59
60
  Nenhum destes vem dentro deste pacote — são plugins do Claude Code independentes e mantidos pela comunidade que combinam naturalmente com o padrão de delegação `agy` que o [`/startcycle-graph-user`](#-aos-o-grafo-dispatcher) já usa. Instale-os separadamente se quiser o mesmo roteamento disponível fora de uma execução `/startcycle`.
@@ -91,8 +92,8 @@ Começamos com um conjunto massivo de mais de 1.400 skills de IA brutas. Após r
91
92
 
92
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.
93
94
 
94
- ### 🛡️ Os 6 Godmodes (Camada Apex)
95
- Em vez de deixar os agentes vagando por instruções genéricas, o nível superior deste repositório impõe seis **Godmodes Hipercurados**. Eles atuam como os guardiões definitivos para sua base de código:
95
+ ### 🛡️ Os 7 Godmodes (Camada Apex)
96
+ Em vez de deixar os agentes vagando por instruções genéricas, o nível superior deste repositório impõe sete **Godmodes Hipercurados**. Eles atuam como os guardiões definitivos para sua base de código:
96
97
  - **`godmode-engineering`**: Impõe Domain-Driven Design, verificações rígidas de TypeScript, Clean Architecture e depuração sistemática.
97
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.
98
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.
@@ -586,14 +587,17 @@ npx @hybridlabor-api/bdb-os-remote installer
586
587
 
587
588
  ---
588
589
 
589
- ## 🖥️ BDB OS Agent Workspace: Orquestração Multi-Agente Paralela
590
+ ## 🖥️ BDB AO — Agent Orchestrator: Orquestração Multi-Agente Paralela
590
591
 
591
- [![Repo](https://img.shields.io/badge/repo-bdb--os--agent--workspace-blue.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
592
- [![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
593
- [![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
592
+ [![Repo](https://img.shields.io/badge/repo-bdb--agent--orchestrator-blue.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
593
+ [![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
594
+ [![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
594
595
  [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
595
596
 
596
- **BDB OS Agent Workspace** é o Meta-Harness de Desktop e a camada de orquestração projetada para agentes de IA paralelos. Ele permite que desenvolvedores criem, gerenciem e coordenem múltiplas sessões de agentes isoladas simultaneamente em Git Worktrees independentes, com loops de feedback de terminal em tempo real e roteamento automatizado de revisão de PR.
597
+ **BDB AO** (`@hybridlabor-api/bdb-agent-orchestrator`, CLI: `ao`) é o Meta-Harness de Desktop e a camada de orquestração projetada para agentes de IA paralelos. Ele permite que desenvolvedores criem, gerenciem e coordenem múltiplas sessões de agentes isoladas simultaneamente em Git Worktrees independentes, com loops de feedback de terminal em tempo real e roteamento automatizado de revisão de PR.
598
+
599
+ > [!NOTE]
600
+ > O AO substitui o antigo **BDB OS Agent Workspace** (`bdb-os-agent-workspace`). Esse repositório está arquivado e seu último release é anterior ao arquivamento — ele contém um defeito conhecido em seu loop de feedback de CI/CD. O instalador do AOS só oferece o AO; não clone o repositório antigo.
597
601
 
598
602
  ```mermaid
599
603
  flowchart TD
@@ -626,8 +630,9 @@ flowchart TD
626
630
  </details>
627
631
 
628
632
  <details>
629
- <summary><strong>🔌 Harnesses Suportados & Link Direto do Repositório</strong></summary>
633
+ <summary><strong>🔌 Suporte de Plataforma, Harnesses Suportados & Link Direto do Repositório</strong></summary>
630
634
 
635
+ - **Suporte de Plataforma:** Disponibiliza hoje um binário pré-compilado — macOS, Apple Silicon (arm64). As fontes para Windows e Linux estão no pacote, mas não são pré-compiladas; compile a partir do código-fonte (`go build`) nessas plataformas.
631
636
  - **Harnesses de Agentes Suportados:**
632
637
  - **Google Antigravity / AGY CLI**
633
638
  - **Claude Desktop & Claude Code**
@@ -635,10 +640,10 @@ flowchart TD
635
640
  - **Roo Code & Cline**
636
641
  - **ChatGPT Codex / Codex CLI**
637
642
  - **Aider & VS Code**
638
- - **Repositório Direto:** Acesse o orquestrador de workspace em [github.com/hybridlabor-api/bdb-os-agent-workspace](https://github.com/hybridlabor-api/bdb-os-agent-workspace).
643
+ - **Repositório Direto:** Acesse o orquestrador em [github.com/hybridlabor-api/bdb-agent-orchestrator](https://github.com/hybridlabor-api/bdb-agent-orchestrator).
639
644
 
640
645
  ```bash
641
- git clone https://github.com/hybridlabor-api/bdb-os-agent-workspace.git
646
+ git clone https://github.com/hybridlabor-api/bdb-agent-orchestrator.git
642
647
  ```
643
648
  </details>
644
649
 
package/docs/backups/hub-overview-20260915.html ADDED
@@ -0,0 +1,200 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>BDB Fleet Hub • Identity Portal Selection</title>
7
+ <link rel="icon" type="image/svg+xml" href="/brand/bdb-favicon-white.svg">
8
+ <link rel="alternate icon" href="/favicon.svg">
9
+ <link rel="preconnect" href="https://fonts.googleapis.com">
10
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
11
+ <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;600;700&family=Plus+Jakarta+Sans:wght@400;500;600;700;800&display=swap" rel="stylesheet">
12
+ <style>
13
+ * { margin: 0; padding: 0; box-sizing: border-box; }
14
+ body {
15
+ background-color: #07080c;
16
+ color: #f1f5f9;
17
+ font-family: 'Plus Jakarta Sans', -apple-system, BlinkMacSystemFont, sans-serif;
18
+ min-height: 100vh;
19
+ display: flex;
20
+ flex-direction: column;
21
+ align-items: center;
22
+ justify-content: center;
23
+ padding: 24px;
24
+ position: relative;
25
+ overflow-x: hidden;
26
+ }
27
+ body::before {
28
+ content: "";
29
+ position: absolute;
30
+ top: -20%;
31
+ left: 50%;
32
+ transform: translateX(-50%);
33
+ width: 600px;
34
+ height: 400px;
35
+ background: radial-gradient(circle, rgba(155, 48, 196, 0.12) 0%, rgba(14, 165, 233, 0.05) 50%, transparent 70%);
36
+ filter: blur(80px);
37
+ pointer-events: none;
38
+ }
39
+ .container {
40
+ width: 100%;
41
+ max-width: 480px;
42
+ background: rgba(17, 19, 26, 0.85);
43
+ border: 1px solid rgba(255, 255, 255, 0.1);
44
+ border-radius: 24px;
45
+ padding: 40px 36px;
46
+ box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.7);
47
+ backdrop-filter: blur(16px);
48
+ position: relative;
49
+ z-index: 1;
50
+ }
51
+ .badge {
52
+ display: inline-flex;
53
+ align-items: center;
54
+ gap: 6px;
55
+ padding: 4px 12px;
56
+ border-radius: 9999px;
57
+ background: rgba(255, 255, 255, 0.05);
58
+ border: 1px solid rgba(255, 255, 255, 0.1);
59
+ font-size: 11px;
60
+ font-family: 'JetBrains Mono', monospace;
61
+ color: #38bdf8;
62
+ margin-bottom: 20px;
63
+ }
64
+ .pulse {
65
+ width: 6px;
66
+ height: 6px;
67
+ border-radius: 50%;
68
+ background: #38bdf8;
69
+ box-shadow: 0 0 8px #38bdf8;
70
+ }
71
+ h1 {
72
+ font-size: 24px;
73
+ font-weight: 800;
74
+ letter-spacing: -0.02em;
75
+ margin-bottom: 8px;
76
+ color: #ffffff;
77
+ }
78
+ p.desc {
79
+ font-size: 13px;
80
+ color: #94a3b8;
81
+ line-height: 1.5;
82
+ margin-bottom: 32px;
83
+ }
84
+ .choice-group {
85
+ display: flex;
86
+ flex-direction: column;
87
+ gap: 14px;
88
+ }
89
+ .choice-btn {
90
+ display: flex;
91
+ align-items: center;
92
+ justify-content: space-between;
93
+ padding: 16px 20px;
94
+ border-radius: 16px;
95
+ text-decoration: none;
96
+ transition: all 0.2s cubic-bezier(0.16, 1, 0.3, 1);
97
+ cursor: pointer;
98
+ position: relative;
99
+ }
100
+ .choice-aws {
101
+ background: rgba(155, 48, 196, 0.12);
102
+ border: 1px solid rgba(155, 48, 196, 0.35);
103
+ }
104
+ .choice-aws:hover {
105
+ background: rgba(155, 48, 196, 0.22);
106
+ border-color: rgba(155, 48, 196, 0.6);
107
+ transform: translateY(-2px);
108
+ box-shadow: 0 10px 25px -5px rgba(155, 48, 196, 0.3);
109
+ }
110
+ .choice-gcp {
111
+ background: rgba(14, 165, 233, 0.08);
112
+ border: 1px solid rgba(14, 165, 233, 0.3);
113
+ }
114
+ .choice-gcp:hover {
115
+ background: rgba(14, 165, 233, 0.18);
116
+ border-color: rgba(14, 165, 233, 0.55);
117
+ transform: translateY(-2px);
118
+ box-shadow: 0 10px 25px -5px rgba(14, 165, 233, 0.25);
119
+ }
120
+ .choice-info {
121
+ text-align: left;
122
+ }
123
+ .choice-title {
124
+ font-size: 14px;
125
+ font-weight: 700;
126
+ color: #ffffff;
127
+ margin-bottom: 3px;
128
+ }
129
+ .choice-sub {
130
+ font-size: 11px;
131
+ font-family: 'JetBrains Mono', monospace;
132
+ color: #94a3b8;
133
+ }
134
+ .arrow {
135
+ font-size: 18px;
136
+ color: #ffffff;
137
+ opacity: 0.6;
138
+ transition: transform 0.2s ease, opacity 0.2s ease;
139
+ }
140
+ .choice-btn:hover .arrow {
141
+ transform: translateX(3px);
142
+ opacity: 1;
143
+ }
144
+ .footer {
145
+ margin-top: 32px;
146
+ padding-top: 20px;
147
+ border-top: 1px solid rgba(255, 255, 255, 0.06);
148
+ font-size: 11px;
149
+ color: #64748b;
150
+ display: flex;
151
+ align-items: center;
152
+ justify-content: space-between;
153
+ }
154
+ .footer a {
155
+ color: #94a3b8;
156
+ text-decoration: none;
157
+ transition: color 0.15s ease;
158
+ }
159
+ .footer a:hover {
160
+ color: #38bdf8;
161
+ }
162
+ </style>
163
+ </head>
164
+ <body>
165
+ <div class="container">
166
+ <div class="badge">
167
+ <span class="pulse"></span>
168
+ <span>BDB Zero-Trust Perimeter</span>
169
+ </div>
170
+
171
+ <h1>Select Identity Realm</h1>
172
+ <p class="desc">
173
+ The Fleet Operations Hub is protected by central single-sign-on. Choose your assigned identity provider to continue:
174
+ </p>
175
+
176
+ <div class="choice-group">
177
+ <a href="https://auth.awsbdb.rcentry.pro/?rd=https://hub.awsbdb.rcentry.pro/" class="choice-btn choice-aws">
178
+ <div class="choice-info">
179
+ <div class="choice-title">BDB Dev Intern (AWS)</div>
180
+ <div class="choice-sub">auth.awsbdb.rcentry.pro</div>
181
+ </div>
182
+ <div class="arrow">&rarr;</div>
183
+ </a>
184
+
185
+ <a href="https://auth.rcentry.pro/?rd=https://hub.awsbdb.rcentry.pro/" class="choice-btn choice-gcp">
186
+ <div class="choice-info">
187
+ <div class="choice-title">rcentry.cloud (GCP / Netcup)</div>
188
+ <div class="choice-sub">auth.rcentry.pro</div>
189
+ </div>
190
+ <div class="arrow">&rarr;</div>
191
+ </a>
192
+ </div>
193
+
194
+ <div class="footer">
195
+ <span>Step-CA SSH & TLS Enabled</span>
196
+ <a href="https://status.awsbdb.rcentry.pro" target="_blank">Status NOC &rarr;</a>
197
+ </div>
198
+ </div>
199
+ </body>
200
+ </html>
package/docs/backups/hub-overview-rewrite-plan.md ADDED
@@ -0,0 +1,98 @@
1
+ # Fleet Hub Overview/Login Page — Copy & Brand-Color Fix Plan
2
+
3
+ Target file: `/Users/timrennings/dev/bdb-fleet-hub/public/login.html` (live at
4
+ `https://hub.awsbdb.rcentry.pro/overview/`). This is a Zero-Trust SSO
5
+ identity-provider selector, not a marketing page — copy stays crisp and
6
+ technical, aimed at engineers/operators who already know what they're
7
+ choosing between. No functional element changes: both provider names, both
8
+ real hostnames, and the footer status link are preserved exactly.
9
+
10
+ A raw backup already exists at
11
+ `docs/backups/hub-overview-20260915.html` (confirmed byte-identical to the
12
+ live file's content as read for this plan) — do not modify or delete it.
13
+
14
+ ---
15
+
16
+ ## 1. Finished English copy, per element
17
+
18
+ | Element | Current | Finished copy | Change |
19
+ |---|---|---|---|
20
+ | Badge text (`.badge span`, line 168) | `BDB Zero-Trust Perimeter` | `BDB Zero-Trust Perimeter` | **No change.** Already precise, correct security terminology (a Zero-Trust "perimeter" is the standard term for the enforced trust boundary) — rewriting it would trade accuracy for novelty. |
21
+ | H1 (line 171) | `Select Identity Realm` | `Choose Your Identity Provider` | "Realm" is Keycloak-internal jargon that doesn't match the SSO vocabulary the page itself uses one line down ("identity provider"). Standardizing on "identity provider" removes the inconsistency and matches how operators actually talk about this choice. |
22
+ | Description (`p.desc`, lines 172–174) | `The Fleet Operations Hub is protected by central single-sign-on. Choose your assigned identity provider to continue:` | `This portal is protected by centralized single sign-on. Select the identity provider assigned to your account to continue.` | Tightens the sentence, fixes "central single-sign-on" → "centralized single sign-on" (the correct term), and removes the verb collision with the new H1 (both previously said "Choose"). |
23
+ | Button 1 title (line 179) | `BDB Dev Intern (AWS)` | `BDB Dev Intern (AWS)` | **No change.** This is an operator-facing environment identifier, not marketing copy — altering its wording risks an operator not recognizing the option they're looking for. |
24
+ | Button 1 subtitle (line 180) | `auth.awsbdb.rcentry.pro` | `auth.awsbdb.rcentry.pro` | **No change** — real hostname, must stay exact. |
25
+ | Button 2 title (line 187) | `rcentry.cloud (GCP / Netcup)` | `rcentry.cloud (GCP / Netcup)` | **No change**, same reasoning as Button 1. |
26
+ | Button 2 subtitle (line 188) | `auth.rcentry.pro` | `auth.rcentry.pro` | **No change** — real hostname. |
27
+ | Footer left (line 195) | `Step-CA SSH & TLS Enabled` | `Step-CA — SSH & TLS Active` | Same meaning (Step-CA issues/enforces both cert classes), reads as a status line rather than a checkbox label — consistent with the footer's role as a live-status strip. |
28
+ | Footer right link (line 196) | `Status NOC →` | `Status NOC →` | **No change** — internal system name (Network Operations Center dashboard), and the `href` is untouched. |
29
+
30
+ ### Exact HTML edits (copy only)
31
+
32
+ ```html
33
+ <!-- line 171 -->
34
+ <h1>Choose Your Identity Provider</h1>
35
+
36
+ <!-- lines 172-174 -->
37
+ <p class="desc">
38
+ This portal is protected by centralized single sign-on. Select the identity provider assigned to your account to continue.
39
+ </p>
40
+
41
+ <!-- line 195 -->
42
+ <span>Step-CA — SSH &amp; TLS Active</span>
43
+ ```
44
+
45
+ Note the footer line already used a literal `&` (`Step-CA SSH & TLS Enabled`)
46
+ without HTML-escaping it — the existing file is not consistent about this
47
+ elsewhere either, so `&amp;` above is optional polish, not a required fix;
48
+ apply it only if the execution agent is doing a full pass, otherwise a literal
49
+ `&` is fine and matches current file convention.
50
+
51
+ Everything else in the file (structure, both `<a href>` targets, the favicon
52
+ links, fonts, script-free static markup) stays untouched.
53
+
54
+ ---
55
+
56
+ ## 2. Brand-violation fix: cyan/sky-blue → BDB Accent Lila
57
+
58
+ **Violation:** the page uses `#38bdf8` (sky-blue/cyan) and
59
+ `rgba(14, 165, 233, …)` (its rgb equivalent, `#0ea5e9`) in five CSS rules.
60
+ BDB brand standard is **Dominant Black (`#0a0a0a`) & White (`#FFFFFF`) with
61
+ Accent Lila (`#9b30c4`)** — no mint/cyan, anywhere. `#9b30c4` is already the
62
+ correct accent in this same file (the `.choice-aws` button already uses it
63
+ correctly) — these substitutions bring the rest of the page in line with it.
64
+
65
+ This is a color-token substitution only, not a CSS rewrite. Every occurrence
66
+ below is a plain string find → replace inside the existing `<style>` block.
67
+
68
+ | # | Find (exact string) | Replace with | Location / rule |
69
+ |---|---|---|---|
70
+ | 1 | `#38bdf8` | `#9b30c4` | `.badge { color: #38bdf8; }` (line 61) |
71
+ | 2 | `#38bdf8` | `#9b30c4` | `.pulse { background: #38bdf8; }` (line 68) |
72
+ | 3 | `#38bdf8` | `#9b30c4` | `.pulse { box-shadow: 0 0 8px #38bdf8; }` (line 69) |
73
+ | 4 | `#38bdf8` | `#9b30c4` | `.footer a:hover { color: #38bdf8; }` (line 160) |
74
+ | 5 | `rgba(14, 165, 233, 0.05)` | `rgba(155, 48, 196, 0.05)` | `body::before` background gradient, middle stop (line 35) |
75
+ | 6 | `rgba(14, 165, 233, 0.08)` | `rgba(155, 48, 196, 0.08)` | `.choice-gcp { background: … }` (line 111) |
76
+ | 7 | `rgba(14, 165, 233, 0.3)` | `rgba(155, 48, 196, 0.3)` | `.choice-gcp { border: 1px solid … }` (line 112) |
77
+ | 8 | `rgba(14, 165, 233, 0.18)` | `rgba(155, 48, 196, 0.18)` | `.choice-gcp:hover { background: … }` (line 115) |
78
+ | 9 | `rgba(14, 165, 233, 0.55)` | `rgba(155, 48, 196, 0.55)` | `.choice-gcp:hover { border-color: … }` (line 116) |
79
+ | 10 | `rgba(14, 165, 233, 0.25)` | `rgba(155, 48, 196, 0.25)` | `.choice-gcp:hover { box-shadow: 0 10px 25px -5px … }` (line 118) |
80
+
81
+ Rows 1–4 are the same find/replace pair applied at all 4 occurrences of that
82
+ exact hex string; rows 5–10 are six distinct rgba alpha values, each
83
+ occurring exactly once, so each is its own literal find/replace.
84
+
85
+ **Advisory (flagging only, not a rewrite):** `.choice-aws` already uses
86
+ `rgba(155, 48, 196, …)` at alphas 0.12 / 0.35 / 0.22 / 0.6 / 0.3. After this
87
+ fix, `.choice-gcp` converges on the *same hue* at *slightly different*
88
+ alphas (0.08 / 0.3 / 0.18 / 0.55 / 0.25) — both provider buttons will read as
89
+ near-identical purple, distinguished only by their label text, since BDB's
90
+ standard defines a single accent color and this task's scope is the color
91
+ substitution, not a redesign. If distinct visual identity between the two
92
+ provider buttons matters, that needs a separate design decision (e.g. one
93
+ button outlined/neutral, the other accented) — out of scope here by
94
+ instruction ("do not attempt a full CSS rewrite").
95
+
96
+ No other cyan/sky-blue values exist in the file — confirmed by reading all
97
+ 200 lines; `#38bdf8` and the six `rgba(14, 165, 233, …)` instances above are
98
+ the complete set.
package/docs/backups/readme-update-plan.md ADDED
@@ -0,0 +1,393 @@
1
+ # README.md Update Plan
2
+
3
+ Prepared by the planning agent. Targeted section replacements against the
4
+ current 928-line `README.md` — not a ground-up rewrite. Every fact below was
5
+ verified against the repo, `installer.js`, `package.json`, and the standalone
6
+ `bdb-hardware-pcb` module repo (`~/dev/bdb-dev/bdb-hardware-pcb`) before being
7
+ written — nothing here is invented.
8
+
9
+ An execution agent should apply each numbered change to `README.md` by
10
+ locating the exact **Find** block and replacing it with the **Replace** block.
11
+ Apply in order; line numbers cited are from the README as read on 2026-09-15
12
+ and will drift after change 1, so match on text, not line number.
13
+
14
+ ---
15
+
16
+ ## What changed and why
17
+
18
+ 1. **Version signal.** The README had zero version mentions (confirmed via
19
+ grep) while carrying a hardcoded `AOS v4.0.0` in the intro sentence —
20
+ stale against the shipped `4.4.2-beta.5` (`package.json`). Fixed by
21
+ removing the hardcoded version from the *current-state* sentence (that
22
+ number was never meant to be "current," it was the AOS-rename milestone)
23
+ and adding one explicit, low-churn status line instead of hardcoding a
24
+ beta patch number that will be stale again within hours.
25
+ 2. **Hardware & PCB module — new.** Added as a 7th Godmode table row, a new
26
+ Ecosystem Integrations bullet, and a full new section mirroring the
27
+ existing Creator Extension / Synapse sections. Facts pulled directly from
28
+ `~/dev/bdb-dev/bdb-hardware-pcb/{README.md,package.json,skills/*/SKILL.md}`:
29
+ package `@hybridlabor-api/bdb-hardware-pcb`, 5 skills (all `category:
30
+ engineering-hardware`), 2 MCP servers (`kicad-mcp-server`,
31
+ `openscad-mcp-server`) exposing **55 tools** (47 KiCad + 8 OpenSCAD),
32
+ supports KiCad 9 & 10, works on macOS/Linux/Windows, installs via the AOS
33
+ optional-module picker (`installer.js`, module id `hardware`) or standalone
34
+ via `npx @hybridlabor-api/bdb-hardware-pcb`. The `godmode-hardware-pcb`
35
+ persona ships in **AOS core** (`skills/basic/godmode-hardware-pcb/`) —
36
+ verified it is *not* duplicated in the module repo — while the 5 execution
37
+ skills and both MCP servers live only in the optional module. This
38
+ core/optional split is the same pattern AOS already uses for
39
+ `godmode-3d-creation`/`godmode-media-creation` (core) vs. Creator Extension
40
+ (optional heavy compute), so the new copy follows that precedent rather
41
+ than inventing a new one.
42
+ 3. **Factual bug found and fixed: the "BDB OS Agent Workspace" section
43
+ points at an archived, broken repo.** `installer.js` (line ~3269) states
44
+ in its own comment that the predecessor package
45
+ `@hybridlabor-api/bdb-os-agent-workspace` "must never come back... hands
46
+ out the build with the CDC loop defect," and the live installer only ever
47
+ offers its successor, `@hybridlabor-api/bdb-agent-orchestrator` (CLI: `ao`,
48
+ module id `ao`, macOS Apple-Silicon prebuilt binary only today — see
49
+ `aoSupportedHere()`). The README's "🖥️ BDB OS Agent Workspace" section
50
+ (and its Ecosystem Integrations bullet) still names and links the archived
51
+ repo. This is not a style nit — it is currently telling readers to `git
52
+ clone` a repo BDB's own installer refuses to touch. Rewrote the section as
53
+ "BDB AO — Agent Orchestrator" with the correct package, repo, CLI name,
54
+ and platform caveat, and added an explicit note about the archived
55
+ predecessor so nobody re-discovers it and wonders why it's not offered.
56
+ 4. **Not touched, flagged instead:** the `skills-169-curated` and
57
+ `MCPs-21` badges. A raw `find` against `skills/**/SKILL.md` in this repo
58
+ returns 183 matches and the MCP list in `installer.js` is built by a
59
+ runtime directory scan with platform/allowlist filtering I can't fully
60
+ replicate by inspection — I won't overwrite a public badge number with a
61
+ guess. Recommend a dedicated recount pass (`npm run validate` plus the
62
+ installer's own MCP discovery) as separate follow-up work. Not part of
63
+ this deliverable's scope (hardware-pcb + stale-content pass), and neither
64
+ count is affected by the hardware-pcb module, which ships its own 2 MCP
65
+ servers and 5 skills entirely outside this repo's counted totals.
66
+
67
+ ---
68
+
69
+ ## Glossary — proper nouns / product names (do NOT translate)
70
+
71
+ Keep these identical, byte-for-byte, in German and Portuguese output:
72
+
73
+ - `AOS`, **BDB Agent OS**
74
+ - `@hybridlabor-api/aos` (npm package)
75
+ - `godmode-engineering`, `godmode-ui-ux`, `godmode-shipping`,
76
+ `godmode-eventtech`, `godmode-3d-creation`, `godmode-media-creation`,
77
+ `godmode-hardware-pcb` (all 7 Godmode skill names)
78
+ - `BDB Hardware & PCB`, `@hybridlabor-api/bdb-hardware-pcb`
79
+ - `KiCad`, `OpenSCAD`, `BOSL2`, `SKiDL` (third-party tool names)
80
+ - `kicad-mcp-server`, `openscad-mcp-server`
81
+ - `BDB AO`, `AO — Agent Orchestrator`, `@hybridlabor-api/bdb-agent-orchestrator`
82
+ (CLI command `ao`)
83
+ - `bdb-os-agent-workspace` (archived — keep the name verbatim where it
84
+ appears as a warning, do not rename or soften it in translation)
85
+ - `BDB Synapse`, `@hybridlabor-api/bdb-synapse`
86
+ - `BDB Creator Extension`, `@hybridlabor-api/bdb-dev-creator-extension`
87
+ - `BDB OS Remote Gateway`, `@hybridlabor-api/bdb-os-remote`
88
+ - `memB`, `memb-mcp`, `@hybridlabor-api/memb`
89
+ - `OpenWiki`
90
+ - `Heimdall Token Saver`
91
+ - `BDBrainstorm`
92
+ - `/startcycle`, `/startcycle-graph`, `/startcycle-graph-user` (slash command
93
+ / pipeline names — keep the leading slash and hyphenation exactly)
94
+ - `Dynamic Workflows` (Claude Code feature name)
95
+ - `NVIDIA SkillSpector`
96
+ - `TripoSR`, `TRELLIS`, `FLUX`, `SDXL`, `Wan2.1`, `OpenMontage`, `Remotion`,
97
+ `Palmier Pro`, `ComfyUI` (media-pipeline engine names)
98
+ - `Tailscale`
99
+ - Standards/acronyms used as-is in all three languages: `IPC-2152`,
100
+ `IPC-2141`, `ERC`, `DRC`, `DFM`, `DFA`, `SI/PI`
101
+
102
+ ---
103
+
104
+ ## Section-by-section replacements
105
+
106
+ ### 1. Intro version line
107
+
108
+ **Find** (current lines ~21):
109
+ ```
110
+ Welcome to **BDB Agent OS — AOS v4.0.0**: 169 curated skills, 21 local MCP wrappers, and a dispatcher graph that turns them 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.
111
+ ```
112
+
113
+ **Replace with:**
114
+ ```
115
+ Welcome to **BDB Agent OS — AOS**: 169 curated skills, 21 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.
116
+
117
+ **Current release:** `v4.4.2` (beta channel) — see the NPM badge above for the exact published version.
118
+ ```
119
+
120
+ *(This removes the stale hardcoded "v4.0.0" from the current-state sentence — that number describes a past rename milestone, not what's running today — and replaces it with a version line that stays roughly accurate across patch bumps instead of a `-beta.N` suffix that goes stale within hours.)*
121
+
122
+ ---
123
+
124
+ ### 2. Godmodes table — add the 7th Godmode
125
+
126
+ **Find:**
127
+ ```
128
+ ### 🛡️ The 6 Godmodes (Apex Layer)
129
+
130
+ Instead of letting agents wander through generic instructions, the top-tier of this repository enforces six **Hyper-Curated Godmodes**. Three of them are not just skills — they are the literal build/ship nodes the [dispatcher graph](#-aos-the-dispatcher-graph) invokes (`UI_UX`, `Engineering`, `Shipping`); the other three cover 3D, media and event-tech work the same way.
131
+
132
+ | Godmode | Purpose |
133
+ |---------|---------|
134
+ | **`godmode-engineering`** | Forces Domain-Driven Design, strict TypeScript checks, Clean Architecture, and systematic 5-step debugging triage. Dispatcher's `Engineering` node. |
135
+ | **`godmode-ui-ux`** | The frontend Gold-Standard. Enforces Brand Discovery, Anti-Slop principles, DTCG design tokens, fluid motion physics, and enterprise accessibility. Dispatcher's `UI_UX` node. |
136
+ | **`godmode-shipping`** | The final gatekeeper for production releases. Enforces Spec-Driven Development, pre-launch checks, feature flags, and safe rollbacks. Dispatcher's `Shipping` node. |
137
+ | **`godmode-eventtech`** | Architectural authority for real-time performance, signal flow, protocol routing, and hardware constraints in live show and event technology environments. |
138
+ | **`godmode-3d-creation`** | MCP-First master orchestration for 3D generation, mesh reconstruction, and parametric CAD engineering. Interfaces with local 3D engines and MCP tools. |
139
+ | **`godmode-media-creation`** | MCP-First master orchestration for all media creation pipelines (Video, Timeline Assembly, Beat Sync, Motion Design). Directly interfaces with local media engines and MCP tools. |
140
+ ```
141
+
142
+ **Replace with:**
143
+ ```
144
+ ### 🛡️ The 7 Godmodes (Apex Layer)
145
+
146
+ Instead of letting agents wander through generic instructions, the top-tier of this repository enforces seven **Hyper-Curated Godmodes**. Three of them are not just skills — they are the literal build/ship nodes the [dispatcher graph](#-aos-the-dispatcher-graph) invokes (`UI_UX`, `Engineering`, `Shipping`); the other four cover 3D, media, event-tech, and hardware/PCB work the same way.
147
+
148
+ | Godmode | Purpose |
149
+ |---------|---------|
150
+ | **`godmode-engineering`** | Forces Domain-Driven Design, strict TypeScript checks, Clean Architecture, and systematic 5-step debugging triage. Dispatcher's `Engineering` node. |
151
+ | **`godmode-ui-ux`** | The frontend Gold-Standard. Enforces Brand Discovery, Anti-Slop principles, DTCG design tokens, fluid motion physics, and enterprise accessibility. Dispatcher's `UI_UX` node. |
152
+ | **`godmode-shipping`** | The final gatekeeper for production releases. Enforces Spec-Driven Development, pre-launch checks, feature flags, and safe rollbacks. Dispatcher's `Shipping` node. |
153
+ | **`godmode-eventtech`** | Architectural authority for real-time performance, signal flow, protocol routing, and hardware constraints in live show and event technology environments. |
154
+ | **`godmode-3d-creation`** | MCP-First master orchestration for 3D generation, mesh reconstruction, and parametric CAD engineering. Interfaces with local 3D engines and MCP tools. |
155
+ | **`godmode-media-creation`** | MCP-First master orchestration for all media creation pipelines (Video, Timeline Assembly, Beat Sync, Motion Design). Directly interfaces with local media engines and MCP tools. |
156
+ | **`godmode-hardware-pcb`** | Architectural authority for electrical schematics, PCB layout, and OpenSCAD enclosure co-design. Enforces IPC-standard trace/impedance math and a headless KiCad ERC/DRC/DFM gate before anything ships to fabrication. Ships in core; the KiCad/OpenSCAD skills and MCP servers it drives live in the optional [**BDB Hardware & PCB**](#-bdb-hardware--pcb-electrical--enclosure-design-module) module. |
157
+ ```
158
+
159
+ ---
160
+
161
+ ### 3. Ecosystem Integrations bullets
162
+
163
+ **Find:**
164
+ ```
165
+ ### 🧩 Ecosystem Integrations
166
+ This package acts as the bridge to three major upstream capabilities:
167
+ - **BDB OS Agent Workspace:** The Orchestration Layer for parallel AI agents. Start multiple isolated agent sessions via Git-Worktrees with live terminal control, automatic CI/CD feedback loops, and PR review routing.
168
+ - **BDB Creator Extension:** The heavy-lifting Agentic Media Pipeline. Gives agents local ComfyUI MCP capabilities (FLUX, SDXL), Image-to-3D generation (TripoSR, TRELLIS), and automated video production through OpenMontage and Remotion.
169
+ - **BDB Synapse:** 3D Codebase Visualization & Agent Session Replay. Renders your repository as an interactive code city and replays agent sessions as light trails, showing which files were read, edited, and where friction occurred.
170
+ ```
171
+
172
+ **Replace with:**
173
+ ```
174
+ ### 🧩 Ecosystem Integrations
175
+ This package acts as the bridge to four major upstream capabilities:
176
+ - **BDB AO — Agent Orchestrator:** The orchestration layer for parallel AI agents. Start multiple isolated agent sessions via Git worktrees with live terminal control, automatic CI/CD feedback loops, and PR review routing. Ships one prebuilt binary today (macOS, Apple Silicon); other platforms build from source. Supersedes the now-archived `bdb-os-agent-workspace` repository — do not install that one.
177
+ - **BDB Creator Extension:** The heavy-lifting Agentic Media Pipeline. Gives agents local ComfyUI MCP capabilities (FLUX, SDXL), Image-to-3D generation (TripoSR, TRELLIS), and automated video production through OpenMontage and Remotion.
178
+ - **BDB Synapse:** 3D Codebase Visualization & Agent Session Replay. Renders your repository as an interactive code city and replays agent sessions as light trails, showing which files were read, edited, and where friction occurred.
179
+ - **BDB Hardware & PCB:** Optional electrical/PCB design module. Two local MCP servers (KiCad, OpenSCAD) exposing 55 tools, plus 5 skills covering schematic capture, layout/routing, and DFM sign-off. Install standalone or via this installer's optional-module picker; paired with the core `godmode-hardware-pcb` persona.
180
+ ```
181
+
182
+ ---
183
+
184
+ ### 4. Fix the archived-repo section (AO)
185
+
186
+ **Find** — the entire section from the `## 🖥️ BDB OS Agent Workspace` heading
187
+ through its closing ` ``` ` clone block, i.e.:
188
+ ```
189
+ ## 🖥️ BDB OS Agent Workspace: Parallel Multi-Agent Orchestration
190
+
191
+ [![Repo](https://img.shields.io/badge/repo-bdb--os--agent--workspace-blue.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
192
+ [![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
193
+ [![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-os-agent-workspace)
194
+ [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
195
+
196
+ **BDB OS Agent Workspace** is the Desktop Meta-Harness and Orchestration Layer designed for parallel AI agents. It enables developers to spawn, manage, and coordinate multiple isolated agent sessions concurrently across independent Git Worktrees with real-time terminal feedback loops and automated PR review routing.
197
+
198
+ ```mermaid
199
+ flowchart TD
200
+ A[Desktop IDE Meta-Harness] --> B[Git Worktree Orchestrator]
201
+ B --> C[Agent Session 1: Feature Build]
202
+ B --> D[Agent Session 2: Refactoring]
203
+ B --> E[Agent Session N: Test & Verification]
204
+ C --> F[Live Terminal Control & Process Monitor]
205
+ D --> F
206
+ E --> F
207
+ F --> G[Automatic CI/CD Feedback Loops]
208
+ G --> H[PR Review & Merge Routing]
209
+ H --> I[Central Git Repository]
210
+ ```
211
+
212
+ <details>
213
+ <summary><strong>⚙️ Architecture & Worktree Orchestration</strong></summary>
214
+
215
+ - **Git Worktree Isolation:** Instantiates dedicated, clean working trees for each subagent session, preventing file state corruption or lock file collisions during concurrent edits.
216
+ - **Desktop Meta-Harness:** Coordinates multi-workspace setups, environment variables, and local server ports across concurrent developer environments.
217
+ - **Parallel Agent Execution:** Spawns autonomous agents working simultaneously on separate modules, features, or bug fixes without interfering with the primary workspace branch.
218
+ </details>
219
+
220
+ <details>
221
+ <summary><strong>🔬 Technical Specifications & Automated Routing</strong></summary>
222
+
223
+ - **Live Terminal Control:** Captures stdout/stderr streams from subagents with active process monitoring, session lifecycle control, and real-time status reporting.
224
+ - **Automatic CI/CD Feedback Loops:** Monitors test outputs and build tasks, routing error traces directly back into the executing subagent's context for instant repair.
225
+ - **PR Review Routing:** Packages completed features, runs automated security and code health checks, and routes generated Pull Requests for user review or automated merging.
226
+ </details>
227
+
228
+ <details>
229
+ <summary><strong>🔌 Supported Harnesses & Direct Repository Link</strong></summary>
230
+
231
+ - **Supported Agent Harnesses:**
232
+ - **Google Antigravity / AGY CLI**
233
+ - **Claude Desktop & Claude Code**
234
+ - **Cursor & Windsurf**
235
+ - **Roo Code & Cline**
236
+ - **ChatGPT Codex / Codex CLI**
237
+ - **Aider & VS Code**
238
+ - **Direct Repository:** Access the workspace orchestrator at [github.com/hybridlabor-api/bdb-os-agent-workspace](https://github.com/hybridlabor-api/bdb-os-agent-workspace).
239
+
240
+ ```bash
241
+ git clone https://github.com/hybridlabor-api/bdb-os-agent-workspace.git
242
+ ```
243
+ </details>
244
+ ```
245
+
246
+ **Replace with:**
247
+ ```
248
+ ## 🖥️ BDB AO — Agent Orchestrator: Parallel Multi-Agent Orchestration
249
+
250
+ [![Repo](https://img.shields.io/badge/repo-bdb--agent--orchestrator-blue.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
251
+ [![harness](https://img.shields.io/badge/orchestration-Git%20Worktrees-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
252
+ [![terminal](https://img.shields.io/badge/terminal-Live%20Control-purple.svg)](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
253
+ [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
254
+
255
+ **BDB AO** (`@hybridlabor-api/bdb-agent-orchestrator`, CLI: `ao`) is the Desktop Meta-Harness and Orchestration Layer designed for parallel AI agents. It enables developers to spawn, manage, and coordinate multiple isolated agent sessions concurrently across independent Git Worktrees with real-time terminal feedback loops and automated PR review routing.
256
+
257
+ > [!NOTE]
258
+ > AO replaces the earlier **BDB OS Agent Workspace** (`bdb-os-agent-workspace`). That repository is archived and its final release predates the archiving — it ships with a known defect in its CI/CD feedback loop. The AOS installer only ever offers AO; do not clone the old repo.
259
+
260
+ ```mermaid
261
+ flowchart TD
262
+ A[Desktop IDE Meta-Harness] --> B[Git Worktree Orchestrator]
263
+ B --> C[Agent Session 1: Feature Build]
264
+ B --> D[Agent Session 2: Refactoring]
265
+ B --> E[Agent Session N: Test & Verification]
266
+ C --> F[Live Terminal Control & Process Monitor]
267
+ D --> F
268
+ E --> F
269
+ F --> G[Automatic CI/CD Feedback Loops]
270
+ G --> H[PR Review & Merge Routing]
271
+ H --> I[Central Git Repository]
272
+ ```
273
+
274
+ <details>
275
+ <summary><strong>⚙️ Architecture & Worktree Orchestration</strong></summary>
276
+
277
+ - **Git Worktree Isolation:** Instantiates dedicated, clean working trees for each subagent session, preventing file state corruption or lock file collisions during concurrent edits.
278
+ - **Desktop Meta-Harness:** Coordinates multi-workspace setups, environment variables, and local server ports across concurrent developer environments.
279
+ - **Parallel Agent Execution:** Spawns autonomous agents working simultaneously on separate modules, features, or bug fixes without interfering with the primary workspace branch.
280
+ </details>
281
+
282
+ <details>
283
+ <summary><strong>🔬 Technical Specifications & Automated Routing</strong></summary>
284
+
285
+ - **Live Terminal Control:** Captures stdout/stderr streams from subagents with active process monitoring, session lifecycle control, and real-time status reporting.
286
+ - **Automatic CI/CD Feedback Loops:** Monitors test outputs and build tasks, routing error traces directly back into the executing subagent's context for instant repair.
287
+ - **PR Review Routing:** Packages completed features, runs automated security and code health checks, and routes generated Pull Requests for user review or automated merging.
288
+ </details>
289
+
290
+ <details>
291
+ <summary><strong>🔌 Platform Support, Supported Harnesses & Direct Repository Link</strong></summary>
292
+
293
+ - **Platform Support:** Ships one prebuilt binary today — macOS, Apple Silicon (arm64). Windows and Linux sources are in the package but not prebuilt; build from source (`go build`) on those platforms.
294
+ - **Supported Agent Harnesses:**
295
+ - **Google Antigravity / AGY CLI**
296
+ - **Claude Desktop & Claude Code**
297
+ - **Cursor & Windsurf**
298
+ - **Roo Code & Cline**
299
+ - **ChatGPT Codex / Codex CLI**
300
+ - **Aider & VS Code**
301
+ - **Direct Repository:** Access the orchestrator at [github.com/hybridlabor-api/bdb-agent-orchestrator](https://github.com/hybridlabor-api/bdb-agent-orchestrator).
302
+
303
+ ```bash
304
+ git clone https://github.com/hybridlabor-api/bdb-agent-orchestrator.git
305
+ ```
306
+ </details>
307
+ ```
308
+
309
+ ---
310
+
311
+ ### 5. New section — BDB Hardware & PCB module
312
+
313
+ Insert this as a new top-level section immediately **after** the closing
314
+ `</details>` of the existing "🎨 BDB Creator Extension" section and its
315
+ trailing `---`, i.e. right before the `## 🧠 memB: Custom Semantic Brain`
316
+ heading. Anchor text used above (`#-bdb-hardware--pcb-electrical--enclosure-design-module`)
317
+ matches this heading's auto-generated GitHub anchor.
318
+
319
+ **Insert:**
320
+ ```
321
+ ## ⚡ BDB Hardware & PCB: Electrical & Enclosure Design Module
322
+
323
+ [![Repo](https://img.shields.io/badge/repo-bdb--hardware--pcb-blue.svg)](https://github.com/hybridlabor-api/bdb-hardware-pcb)
324
+ [![tools](https://img.shields.io/badge/MCP%20tools-55-brightgreen.svg)](https://github.com/hybridlabor-api/bdb-hardware-pcb)
325
+ [![KiCad](https://img.shields.io/badge/KiCad-9%20%26%2010-orange.svg)](https://www.kicad.org/)
326
+ [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
327
+
328
+ **BDB Hardware & PCB** (`@hybridlabor-api/bdb-hardware-pcb`) brings electrical
329
+ schematic capture, PCB layout/routing, DFM sign-off, and parametric 3D
330
+ enclosure design into the agent loop — governed by the core
331
+ [`godmode-hardware-pcb`](#-the-7-godmodes-apex-layer) persona, which owns the
332
+ IPC-standard trace/impedance math and the headless KiCad ERC/DRC/DFM gate no
333
+ board is allowed to skip on its way to fabrication.
334
+
335
+ ```mermaid
336
+ flowchart LR
337
+ A[Agent] -->|MCP| B[kicad-mcp-server]
338
+ A -->|MCP| C[openscad-mcp-server]
339
+ B --> D[Schematic Capture & ERC]
340
+ B --> E[PCB Layout & Routing]
341
+ B --> F[DRC / DFM / Gerber Sign-Off]
342
+ C --> G[Parametric Enclosure — OpenSCAD/BOSL2]
343
+ D & E & F & G --> H[Fabrication-Ready Output]
344
+ ```
345
+
346
+ ### Two MCP Servers, 55 Tools
347
+ - **`kicad-mcp-server`** — 47 tools over stdio JSON-RPC for schematic capture, ERC, PCB layout, routing, DRC, and Gerber/BOM/CPL export. Targets **KiCad 9 & 10** via `kicad-cli`.
348
+ - **`openscad-mcp-server`** — 8 tools for parametric 3D enclosure and mechanical co-design (OpenSCAD + BOSL2).
349
+
350
+ ### 5 Skills (`category: engineering-hardware`)
351
+
352
+ | Skill | Description |
353
+ |-------|-------------|
354
+ | `schematic-datasheet-analysis` | Electrical rule auditing, datasheet grounding, pinout validation, power tree tracing, and negative-evidence analysis for KiCad schematics. |
355
+ | `pcb-constraint-definition` | Translates high-level hardware requirements into formal engineering constraints, layer stackup, netclasses, and custom DRC rules for KiCad. |
356
+ | `pcb-layout-routing-automation` | Floorplanning, placement rules, high-speed differential pair routing, return-path continuity, thermal via arrays, and keepout enforcement. |
357
+ | `pcb-validation-dfm-signoff` | Automated DRC/ERC verification, SI/PI screening, fab-house DFM/DFA compliance, and production release sign-off. |
358
+ | `code-first-hardware-design` | Programmatic schematic capture and circuit synthesis (SKiDL, text netlists, S-expressions) plus parametric 3D enclosure co-design. |
359
+
360
+ ### Install
361
+
362
+ Same optional-module mechanism as `bdb-synapse` and
363
+ `bdb-dev-creator-extension` — the main AOS installer downloads and runs it for
364
+ you, or install it standalone on macOS, Linux, or Windows:
365
+
366
+ ```bash
367
+ npx @hybridlabor-api/bdb-hardware-pcb
368
+ ```
369
+
370
+ Supported harnesses: **Claude Code**, **OpenAI Codex**, and **Google
371
+ Antigravity (Gemini)**. Verify a local install with:
372
+
373
+ ```bash
374
+ ./scripts/test_mcp_connection.sh --all
375
+ ```
376
+
377
+ ---
378
+ ```
379
+
380
+ ---
381
+
382
+ ## Notes for the execution agent
383
+
384
+ - Every code fence above is intentionally shown with backtick fences nested
385
+ inside this plan's own fences — when copying a block into `README.md`,
386
+ copy only the inner content (the mermaid/bash blocks), not this plan
387
+ document's own wrapping.
388
+ - Do not touch `README.de.md` or `README.pt.md` — a separate translation pass
389
+ handles those from this English source using the glossary above.
390
+ - The `#-bdb-hardware--pcb-electrical--enclosure-design-module` anchor
391
+ reference added to the Godmodes table row and the AO note assumes GitHub's
392
+ standard heading-to-anchor slugification (lowercase, spaces → hyphens,
393
+ `&` and `:` stripped) — verify it resolves once the new section is in place.
package/installer.js CHANGED
@@ -811,7 +811,10 @@ function detectPlatforms() {
811
811
  },
812
812
  {
813
813
  key: 'codex', name: 'ChatGPT Codex CLI', path: path.join(homeDir, '.codex'),
814
- evidence: () => hasExecutable('codex'),
814
+ // Codex ships two ways: the standalone CLI binary, and embedded in
815
+ // the ChatGPT desktop app. A machine can have either without the
816
+ // other (e.g. ChatGPT desktop only, codex never put on PATH).
817
+ evidence: () => hasExecutable('codex') || anyExists(appBundle('ChatGPT')),
815
818
  },
816
819
  {
817
820
  key: 'claudecode', name: 'Claude Code CLI', path: path.join(homeDir, '.claude'),
@@ -1171,13 +1174,20 @@ function syncSkillsToGlobalHarnesses(excludeSkills = []) {
1171
1174
  // the very directories detectPlatforms() then read back as proof the
1172
1175
  // harness existed. ~/.agents is ours and always written.
1173
1176
  const detectedKeys = new Set(detectPlatforms().map((d) => d.key));
1177
+ // No `|| fs.existsSync(d.dir)` fallback here on purpose: that fallback
1178
+ // used to mean a directory AOS itself planted in a past run (before a
1179
+ // harness was ever really detected) kept being "detected" forever,
1180
+ // regardless of what detectPlatforms() found this run -- the exact
1181
+ // circularity the block comment above warns about, just one layer down.
1182
+ // A harness that stops being detected now simply stops receiving skill
1183
+ // updates instead of perpetuating a false positive.
1174
1184
  const extraSkillDestinations = [
1175
1185
  { dir: path.join(homeDir, '.agents', 'skills'), key: null },
1176
1186
  { dir: path.join(homeDir, '.claude', 'skills'), key: 'claudecode' },
1177
1187
  { dir: path.join(homeDir, '.codex', 'skills'), key: 'codex' },
1178
1188
  { dir: path.join(homeDir, '.cursor', 'skills'), key: 'cursor' },
1179
1189
  { dir: path.join(homeDir, '.roo', 'skills'), key: 'vscode' },
1180
- ].filter((d) => d.key === null || detectedKeys.has(d.key) || fs.existsSync(d.dir));
1190
+ ].filter((d) => d.key === null || detectedKeys.has(d.key));
1181
1191
 
1182
1192
  for (const { dir: dest } of extraSkillDestinations) {
1183
1193
  try {
@@ -1245,15 +1255,42 @@ function maskApiKey(key) {
1245
1255
  return key.substring(0, 4) + '...' + key.substring(key.length - 4);
1246
1256
  }
1247
1257
 
1248
- async function promptCredentials(referenceMcpDir) {
1249
- if (isAutoYes) return { gemini: "", github: "", openwikiProvider: "google", openwikiModel: "", openwikiBaseUrl: "", keyEnvName: 'GEMINI_API_KEY' };
1258
+ // Provider -> its own API key env var name. Used both to find a previously
1259
+ // configured non-Google provider's key (loadExistingEnv only special-cased
1260
+ // Gemini/GitHub, so a Groq/Grok/NVIDIA/OpenAI/OpenRouter setup was invisible
1261
+ // to "keep existing" and silently looked unconfigured) and to build the
1262
+ // isAutoYes default without re-deriving the same mapping twice.
1263
+ const PROVIDER_KEY_ENV_NAMES = {
1264
+ google: 'GEMINI_API_KEY', groq: 'GROQ_API_KEY', grok: 'XAI_API_KEY',
1265
+ nvidia: 'NVIDIA_API_KEY', openrouter: 'OPENROUTER_API_KEY',
1266
+ openai: 'OPENAI_API_KEY', ollama: null, custom: 'OPENWIKI_API_KEY',
1267
+ };
1250
1268
 
1269
+ async function promptCredentials(referenceMcpDir) {
1251
1270
  const existingEnv = loadExistingEnv(referenceMcpDir);
1252
- const existingGemini = existingEnv['GEMINI_API_KEY'] || existingEnv['GOOGLE_API_KEY'] || existingEnv['OPENWIKI_API_KEY'] || '';
1253
1271
  const existingGithub = existingEnv['GITHUB_PERSONAL_ACCESS_TOKEN'] || existingEnv['GITHUB_TOKEN'] || '';
1254
1272
  const existingProvider = existingEnv['OPENWIKI_PROVIDER'] || 'google';
1255
1273
  const existingModel = existingEnv['OPENWIKI_MODEL'] || '';
1256
1274
  const existingBaseUrl = existingEnv['OPENWIKI_BASE_URL'] || '';
1275
+ const existingKeyEnvName = PROVIDER_KEY_ENV_NAMES[existingProvider] || 'OPENWIKI_API_KEY';
1276
+ // Gemini/Google/OpenWiki-generic keys are also accepted as a fallback so
1277
+ // an old config written before OPENWIKI_PROVIDER existed still resolves.
1278
+ const existingGemini = existingEnv[existingKeyEnvName] || existingEnv['GEMINI_API_KEY'] || existingEnv['GOOGLE_API_KEY'] || existingEnv['OPENWIKI_API_KEY'] || '';
1279
+
1280
+ if (isAutoYes) {
1281
+ // A non-interactive run (npx -y, or an --auto submodule install) must
1282
+ // never silently discard a provider already configured on this
1283
+ // machine -- this used to hard-reset to an empty Google/Gemini
1284
+ // default on every unattended re-run, wiping a previously-chosen
1285
+ // NVIDIA/Nemotron (or any other) provider and key each time.
1286
+ if (existingGemini || existingProvider === 'ollama') {
1287
+ return { gemini: existingGemini, github: existingGithub, openwikiProvider: existingProvider, openwikiModel: existingModel, openwikiBaseUrl: existingBaseUrl, keyEnvName: existingKeyEnvName };
1288
+ }
1289
+ // Nothing configured yet on this machine: default to NVIDIA NIM /
1290
+ // Nemotron. Google was only ever a placeholder default, never the
1291
+ // intended house default.
1292
+ return { gemini: "", github: existingGithub, openwikiProvider: "nvidia", openwikiModel: "nvidia/llama-3.1-nemotron-70b-instruct", openwikiBaseUrl: "https://integrate.api.nvidia.com/v1", keyEnvName: 'NVIDIA_API_KEY' };
1293
+ }
1257
1294
 
1258
1295
  const hasKeys = Boolean(existingGemini || existingGithub);
1259
1296
 
@@ -1280,7 +1317,7 @@ async function promptCredentials(referenceMcpDir) {
1280
1317
  openwikiProvider: existingProvider,
1281
1318
  openwikiModel: existingModel,
1282
1319
  openwikiBaseUrl: existingBaseUrl,
1283
- keyEnvName: existingProvider === 'google' ? 'GEMINI_API_KEY' : 'OPENWIKI_API_KEY'
1320
+ keyEnvName: existingKeyEnvName
1284
1321
  };
1285
1322
  }
1286
1323
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hybridlabor-api/aos",
3
- "version": "4.4.2-beta.4",
3
+ "version": "4.4.2-beta.6",
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
  "bin": {