@hybridlabor-api/bdb-hardware-pcb 0.1.0

package/docs/review_documentation.md

@@ -0,0 +1,121 @@
+# AOS Electrical & PCB Design Integration — Project Review Dossier
+
+> **Subsystem**: `AOS-ELETRICAL&PCB`  
+> **Status**: **100% COMPLETE & VERIFIED** (Gate: PASS, Forensic Audit: CLEAN)  
+> **Target Harnesses**: Google Antigravity, Anthropic Claude Code, OpenAI Codex  
+> **Working Directory**: `/Users/timrennings/dev/AOS-ELETRICAL&PCB`  
+
+---
+
+## 1. Project Maturity & Current State
+
+The integration of Electrical Engineering, PCB Design, and 3D Parametric Enclosure capabilities into the **BDB Agent OS (AOS)** ecosystem is **fully implemented, tested, and ready for review**.
+
+```mermaid
+flowchart TD
+    subgraph Upstream Research
+        M0[M0: Deep Survey & Research] -->|Evaluated 7 Tools| ADR[M1: ADR-001 Architecture Strategy]
+    end
+
+    subgraph Implementation
+        ADR --> SKILLS[M2: 5 AI-Era Hardware Skills]
+        ADR --> MCPS[M3: Multi-Harness MCP Setup]
+    end
+
+    subgraph Verification
+        SKILLS --> REVIEW[Reviewer 1 & 2: Content & Parity]
+        MCPS --> TESTS[M4: Automated stdio Live Tests]
+        TESTS --> CHALLENGE[Challenger 1 & 2: AST & Failure Modes]
+        CHALLENGE --> AUDIT[Auditor 1: Forensic Anti-Cheat]
+        REVIEW --> AUDIT
+    end
+
+    AUDIT -->|Unanimous APPROVE / CLEAN| GATE[M5: GATE STATUS - PASS]
+```
+
+### Milestone Delivery Matrix
+
+| Milestone | Deliverable | Status | Independent Verdict |
+|---|---|---|---|
+| **M0: Survey & Research** | 3 parallel explorer reports on KiCad 9/10, OpenSCAD, and EE skill architectures | **DONE** | Validated by Orchestrator |
+| **M1: Architecture ADR** | [`docs/adr/ADR-001-KICAD-OPENSCAD-MCP-STRATEGY.md`](file:///Users/timrennings/dev/AOS-ELETRICAL&PCB/docs/adr/ADR-001-KICAD-OPENSCAD-MCP-STRATEGY.md) (334 lines, 29 KB) | **DONE** | `APPROVE` (Reviewer 1) |
+| **M2: AOS EE Skills** | 5 comprehensive skills (153–260 lines each, strictly non-slop, mirrored across 4 systems) | **DONE** | `APPROVE` (Reviewer 1 & Challenger 2) |
+| **M3: MCP Servers** | KiCad (47 tools) & OpenSCAD (8 tools) configs + 55 lazy schemas generated | **DONE** | `APPROVE` (Reviewer 2 & Auditor 1) |
+| **M4: Automated Tests** | [`scripts/test_mcp_connection.py`](file:///Users/timrennings/dev/AOS-ELETRICAL&PCB/scripts/test_mcp_connection.py) & [`.sh`](file:///Users/timrennings/dev/AOS-ELETRICAL&PCB/scripts/test_mcp_connection.sh) (55 tools tested) | **DONE** | `APPROVE` (Exit code 0, 0 failures) |
+| **M5: Gate & Audit** | Forensic anti-cheat audit and stress testing (`GATE_STATUS.md`) | **DONE** | `PASS / CLEAN` (Auditor 1) |
+
+---
+
+## 2. Key Architecture Decisions (ADR-001)
+
+1. **Avoid In-Process SWIG Bindings (`pcbnew`)**: Legacy SWIG bindings suffer from C++ destructor/garbage collection race conditions causing segmentation faults. We adopted out-of-process stdio JSON-RPC and CLI subprocessing.
+2. **Context Window Protection**: Rather than monolithic 230+ tool servers that consume >20k tokens per turn, we deployed focused, atomic toolsets (47 KiCad tools, 8 OpenSCAD tools) with lazy-schema loading in Antigravity.
+3. **Bridge Electrical & Mechanical CAD**: OpenSCAD was integrated directly into the workflow to enable algorithmic, parametric enclosure generation based on PCB board outlines and standoff positions.
+4. **Multi-Harness Native Mirroring**: Zero-config operation across Antigravity, Claude Code, and Codex.
+
+---
+
+## 3. The 5 AI-Era Hardware Engineering Skills
+
+All 5 skills strictly exceed the anti-slop standard (>150 lines) with actionable formulas, DRC rules, and verified code examples:
+
+1. **[`code-first-hardware-design`](file:///Users/timrennings/dev/AOS-ELETRICAL&PCB/skills/code-first-hardware-design/SKILL.md)** (260 lines)
+   - Programmatic schematic capture via Python SKiDL
+   - Parametric 3D mechanical enclosure generation in OpenSCAD
+   - Version-controlled text netlists
+2. **[`pcb-constraint-definition`](file:///Users/timrennings/dev/AOS-ELETRICAL&PCB/skills/pcb-constraint-definition/SKILL.md)** (236 lines)
+   - Microstrip/stripline differential impedance calculations (USB 90Ω, PCIe 85Ω, Ethernet 100Ω)
+   - High-voltage creepage and clearance (IEC 60950 / IEC 62368-1)
+   - Thermal dissipation and current-carrying capacity (IPC-2152)
+3. **[`schematic-datasheet-analysis`](file:///Users/timrennings/dev/AOS-ELETRICAL&PCB/skills/schematic-datasheet-analysis/SKILL.md)** (202 lines)
+   - Automated PDF datasheet parameter extraction using PyMuPDF and LLM parsing
+   - Pin multiplexing conflict matrix and power-domain sanity checks
+   - Decoupling capacitor placement hierarchies (0.1µF + 10µF bulk)
+4. **[`pcb-layout-routing-automation`](file:///Users/timrennings/dev/AOS-ELETRICAL&PCB/skills/pcb-layout-routing-automation/SKILL.md)** (153 lines)
+   - Layer stackup planning (4-layer: SIG-GND-PWR-SIG, 6-layer: SIG-GND-SIG-PWR-GND-SIG)
+   - Return-current path integrity (avoiding plane split crossings)
+   - Headless auto-routing via Freerouting CLI bridge
+5. **[`pcb-validation-dfm-signoff`](file:///Users/timrennings/dev/AOS-ELETRICAL&PCB/skills/pcb-validation-dfm-signoff/SKILL.md)** (194 lines)
+   - Unforgiving Electrical Rules Check (ERC) and Design Rules Check (DRC) sign-off
+   - Signal Integrity (SI) and Power Integrity (PI) impedance checks
+   - Design for Manufacturing (DFM) verification for standard fabrication houses (JLCPCB, PCBWay)
+
+---
+
+## 4. MCP Servers & Tool Inventory (55 Tools)
+
+### `kicad` (47 Tools)
+- **Schematic & Connectivity**: `create_kicad_project`, `list_schematic_components`, `get_symbol_details`, `search_symbols`, `list_schematic_nets`, `get_schematic_info`, `add_component_from_library`, `add_wire`, `add_label`, `add_global_label`, `add_hierarchical_label`, `search_components_by_type`.
+- **Netlist & Pin Analysis**: `generate_netlist`, `get_netlist_nets`, `get_netlist_components`, `trace_netlist_connection`, `extract_gpio_config`, `extract_i2c_devices`, `extract_spi_devices`, `extract_power_domains`, `validate_pin_configuration`, `extract_pinmux_config`, `detect_pin_conflicts`, `analyze_pin_functions`, `trace_hierarchical_connection`, `analyze_hierarchical_nets`, `generate_device_tree`.
+- **PCB Layout & Parts**: `setup_pcb_layout`, `list_pcb_footprints`, `get_pcb_statistics`, `analyze_pcb_nets`, `find_tracks_by_net`, `search_parts_registry`, `get_registry_part`, `download_registry_part`.
+- **Integrity Checks (SI/PI)**: `analyze_pcb_signal_integrity`, `analyze_pcb_power_integrity`.
+- **ERC/DRC & Outputs**: `run_erc`, `run_drc`, `get_erc_violations`, `get_drc_violations`, `export_erc_report`, `export_drc_report`, `export_gerber`, `render_pcb`, `export_pcb_3d`, `export_schematic_svg`.
+
+### `openscad` (8 Tools)
+- `create_3d_model`, `create_model_from_scad`, `modify_3d_model`, `export_model`, `get_model`, `get_model_source`, `get_capabilities`, `get_model_preview`.
+
+---
+
+## 5. Reviewer Verification Guide
+
+Any reviewing agent or human evaluator can verify the subsystem by executing:
+
+```bash
+cd /Users/timrennings/dev/AOS-ELETRICAL&PCB
+
+# 1. Execute live multi-harness stdio test suite:
+./scripts/test_mcp_connection.sh --all
+
+# 2. Verify skill line counts (threshold >= 50 lines):
+wc -l skills/*/SKILL.md docs/adr/ADR-001-KICAD-OPENSCAD-MCP-STRATEGY.md
+
+# 3. Verify zero drift across global skill mirrors:
+for s in pcb-constraint-definition code-first-hardware-design schematic-datasheet-analysis pcb-layout-routing-automation pcb-validation-dfm-signoff; do
+  diff -q skills/$s/SKILL.md ~/.agents/skills/$s/SKILL.md
+  diff -q skills/$s/SKILL.md ~/.claude/skills/$s/SKILL.md
+  diff -q skills/$s/SKILL.md ~/.gemini/config/skills/$s/SKILL.md
+  diff -q skills/$s/SKILL.md ~/.codex/skills/$s/SKILL.md
+done
+```
+
+All commands exit with code `0` and 0 errors.

package/installer.js

@@ -0,0 +1,358 @@
+#!/usr/bin/env node
+'use strict';
+// ==============================================================================
+// BDB Hardware & PCB — cross-platform installer
+// ==============================================================================
+// Runs standalone (`npx @hybridlabor-api/bdb-hardware-pcb`) or as an optional
+// module invoked by the main AOS installer (`node installer.js --auto`, cwd
+// set to this package's own directory — same convention as bdb-synapse /
+// bdb-dev-creator-extension). Every path is computed from __dirname / os.homedir()
+// at runtime: nothing here may hardcode a machine-specific path.
+//
+// What it does, every run, non-interactively:
+//   1. Sets up the kicad-mcp-server and openscad-mcp-server Python venvs
+//      (uv sync if uv is on PATH, else python3/python -m venv + pip install -e .)
+//   2. Detects which harnesses are present on this machine (Claude, Codex,
+//      Antigravity/Gemini, and BDB's own ~/.agents) and, for each present one:
+//      - copies the 5 skill directories into its skills folder
+//      - merges (never clobbers) the two MCP server entries into its real
+//        live MCP config file
+// Every step prints one honest PASS/SKIP/WARN line. A missing prerequisite
+// (git, python, permission denied) warns and the rest of the install
+// continues; only an unexpected exception is fatal.
+// ==============================================================================
+
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+const { spawnSync } = require('child_process');
+
+const AUTO = process.argv.includes('--auto');
+const INSTALL_DIR = __dirname;
+const HOME = os.homedir();
+const IS_WIN = process.platform === 'win32';
+
+const log = {
+    step: (msg) => console.log(`  -> ${msg}`),
+    ok: (msg) => console.log(`  [OK] ${msg}`),
+    skip: (msg) => console.log(`  [SKIP] ${msg}`),
+    warn: (msg) => console.warn(`  [WARN] ${msg}`),
+    err: (msg) => console.error(`  [ERROR] ${msg}`),
+    section: (msg) => console.log(`\n${msg}`),
+};
+
+function commandExists(cmd, versionArgs = ['--version']) {
+    try {
+        const res = spawnSync(cmd, versionArgs, { stdio: 'ignore' });
+        return res.error === undefined || res.error === null;
+    } catch {
+        return false;
+    }
+}
+
+function copyDirRecursive(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    fs.cpSync(src, dest, { recursive: true, force: true });
+}
+
+// --- 1. Python venv setup -----------------------------------------------
+
+const MCP_SERVERS = [
+    { name: 'kicad', dir: path.join(INSTALL_DIR, 'mcp_servers', 'kicad-mcp-server') },
+    { name: 'openscad', dir: path.join(INSTALL_DIR, 'mcp_servers', 'openscad-mcp-server') },
+];
+
+function findPython() {
+    // ponytail: first python that answers --version; not a full version-gate,
+    // upgrade to a strict >=3.10 check if a server's setup starts failing on it.
+    for (const cmd of IS_WIN ? ['python', 'py', 'python3'] : ['python3', 'python']) {
+        if (commandExists(cmd)) return cmd;
+    }
+    return null;
+}
+
+function setupServerEnv(server, uvBin, pythonBin) {
+    const venvDir = path.join(server.dir, '.venv');
+    if (uvBin) {
+        const res = spawnSync(uvBin, ['sync'], { cwd: server.dir, stdio: 'inherit' });
+        if (res.status === 0) {
+            log.ok(`${server.name}-mcp-server: dependencies synced via uv`);
+            return true;
+        }
+        log.warn(`${server.name}-mcp-server: 'uv sync' failed (exit ${res.status}); falling back to venv+pip`);
+    }
+    if (!pythonBin) {
+        log.warn(`${server.name}-mcp-server: no python3/python found on PATH — skipping venv setup. Install Python 3.10+ and re-run.`);
+        return false;
+    }
+    if (!fs.existsSync(venvDir)) {
+        const mk = spawnSync(pythonBin, ['-m', 'venv', '.venv'], { cwd: server.dir, stdio: 'inherit' });
+        if (mk.status !== 0) {
+            log.warn(`${server.name}-mcp-server: 'python -m venv' failed (exit ${mk.status})`);
+            return false;
+        }
+    }
+    const pipBin = path.join(venvDir, IS_WIN ? 'Scripts' : 'bin', IS_WIN ? 'pip.exe' : 'pip');
+    const install = spawnSync(pipBin, ['install', '-e', '.'], { cwd: server.dir, stdio: 'inherit' });
+    if (install.status !== 0) {
+        log.warn(`${server.name}-mcp-server: 'pip install -e .' failed (exit ${install.status})`);
+        return false;
+    }
+    log.ok(`${server.name}-mcp-server: dependencies installed via venv+pip`);
+    return true;
+}
+
+function setupPythonEnvironments() {
+    log.section('Python MCP server environments');
+    const uvBin = commandExists('uv') ? 'uv' : null;
+    const pythonBin = findPython();
+    log.step(uvBin ? 'uv detected — using uv sync' : pythonBin ? `uv not found — using ${pythonBin} -m venv` : 'neither uv nor python3/python found');
+    for (const server of MCP_SERVERS) {
+        try {
+            setupServerEnv(server, uvBin, pythonBin);
+        } catch (e) {
+            log.warn(`${server.name}-mcp-server: setup threw ${e.message}`);
+        }
+    }
+}
+
+// --- 2. Windows run-script wrappers (only if no shell can run the .sh) ----
+
+function ensureWindowsRunner(server, scriptBase, moduleInvocation) {
+    // Prefer bash (Git for Windows ships one) so the existing, already-tested
+    // .sh runner stays the single source of truth. Only generate a native
+    // .cmd wrapper — and only for this one server — when bash is absent.
+    if (commandExists('bash', ['--version'])) return { command: 'bash', prefixArgs: [path.join(INSTALL_DIR, 'scripts', `${scriptBase}.sh`)] };
+
+    const cmdPath = path.join(INSTALL_DIR, 'scripts', `${scriptBase}.cmd`);
+    const venvPy = path.join(server.dir, '.venv', 'Scripts', 'python.exe');
+    const body = [
+        '@echo off',
+        `set PYTHONPATH=${path.join(server.dir, 'src')};%PYTHONPATH%`,
+        `if exist "${venvPy}" (`,
+        `  "${venvPy}" ${moduleInvocation} %*`,
+        ') else (',
+        `  python -m ${moduleInvocation.replace(/^-m /, '')} %*`,
+        ')',
+        '',
+    ].join('\r\n');
+    try {
+        fs.writeFileSync(cmdPath, body, 'utf-8');
+        log.ok(`generated Windows wrapper: ${cmdPath} (bash not found on PATH)`);
+        return { command: cmdPath, prefixArgs: [] };
+    } catch (e) {
+        log.warn(`could not write Windows wrapper ${cmdPath}: ${e.message}`);
+        return null;
+    }
+}
+
+function resolveServerCommand(name) {
+    if (name === 'kicad') {
+        const server = MCP_SERVERS[0];
+        if (!IS_WIN) return { command: path.join(INSTALL_DIR, 'scripts', 'run_kicad_mcp.sh'), args: [] };
+        const r = ensureWindowsRunner(server, 'run_kicad_mcp', '-m kicad_mcp_server');
+        return r ? { command: r.command, args: r.prefixArgs } : { command: path.join(INSTALL_DIR, 'scripts', 'run_kicad_mcp.sh'), args: [] };
+    }
+    const server = MCP_SERVERS[1];
+    if (!IS_WIN) return { command: path.join(INSTALL_DIR, 'scripts', 'run_openscad_mcp.sh'), args: ['--transport', 'stdio'] };
+    const r = ensureWindowsRunner(server, 'run_openscad_mcp', '-m openscad_mcp.server --transport stdio');
+    return r ? { command: r.command, args: r.prefixArgs } : { command: path.join(INSTALL_DIR, 'scripts', 'run_openscad_mcp.sh'), args: ['--transport', 'stdio'] };
+}
+
+function mcpServerEntries() {
+    const kicad = resolveServerCommand('kicad');
+    const openscad = resolveServerCommand('openscad');
+    return {
+        kicad: {
+            command: kicad.command,
+            args: kicad.args,
+            env: { KICAD_CLI_PATH: process.env.KICAD_CLI_PATH || '/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli' },
+        },
+        openscad: {
+            command: openscad.command,
+            args: openscad.args,
+            env: { OPENSCAD_EXECUTABLE: path.join(INSTALL_DIR, 'scripts', IS_WIN ? 'openscad_wrapper.cmd' : 'openscad_wrapper.sh') },
+        },
+    };
+}
+
+// --- 3. Harness detection, skill copy, MCP config merge -------------------
+
+const SKILLS = [
+    'code-first-hardware-design',
+    'pcb-constraint-definition',
+    'pcb-layout-routing-automation',
+    'pcb-validation-dfm-signoff',
+    'schematic-datasheet-analysis',
+];
+
+function mergeJsonMcpConfig(configPath, servers) {
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
+    let data = {};
+    if (fs.existsSync(configPath)) {
+        try {
+            data = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        } catch (e) {
+            const backup = `${configPath}.bak-${Date.now()}`;
+            fs.copyFileSync(configPath, backup);
+            log.warn(`${configPath} had invalid JSON — backed up to ${backup} and starting fresh`);
+            data = {};
+        }
+    }
+    if (typeof data !== 'object' || data === null) data = {};
+    if (typeof data.mcpServers !== 'object' || data.mcpServers === null) data.mcpServers = {};
+    Object.assign(data.mcpServers, servers);
+    fs.writeFileSync(configPath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+    return true;
+}
+
+// Removes a `[section]` header line and every line after it up to (not
+// including) the next line that starts a new header, or EOF. Line-based, not
+// a real TOML parser -- deliberately, so this never depends on an extra
+// dependency to merge two known-shape blocks we generated ourselves.
+// ponytail: good enough for our own sections; a third party hand-editing
+// inside our block could confuse it, upgrade to a real TOML lib (e.g.
+// @iarna/toml) if that ever happens in practice.
+function removeTomlSection(text, sectionName) {
+    const header = `[${sectionName}]`;
+    const lines = text.split('\n');
+    const out = [];
+    let skipping = false;
+    for (const line of lines) {
+        if (line.trim() === header) {
+            skipping = true;
+            continue;
+        }
+        if (skipping && /^\[/.test(line.trim())) {
+            skipping = false;
+        }
+        if (!skipping) out.push(line);
+    }
+    return out.join('\n');
+}
+
+function mergeTomlMcpConfig(configPath, servers) {
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
+    let existing = fs.existsSync(configPath) ? fs.readFileSync(configPath, 'utf-8') : '';
+    let text = existing;
+    for (const name of Object.keys(servers)) {
+        text = removeTomlSection(text, `mcp_servers.${name}.env`);
+        text = removeTomlSection(text, `mcp_servers.${name}`);
+    }
+    text = text.replace(/\n{3,}/g, '\n\n').replace(/\s+$/, '\n');
+
+    const blocks = [];
+    for (const [name, cfg] of Object.entries(servers)) {
+        const argsToml = JSON.stringify(cfg.args || []);
+        const envLines = Object.entries(cfg.env || {}).map(([k, v]) => `${k} = ${JSON.stringify(v)}`).join('\n');
+        blocks.push(
+            `\n[mcp_servers.${name}]\ncommand = ${JSON.stringify(cfg.command)}\nargs = ${argsToml}\nenabled = true\n` +
+            (envLines ? `\n[mcp_servers.${name}.env]\n${envLines}\n` : '')
+        );
+    }
+    const newText = text + blocks.join('');
+    if (newText === existing) {
+        log.skip(`${configPath}: kicad/openscad already registered with current paths — no change needed`);
+        return false;
+    }
+    fs.writeFileSync(configPath, newText, 'utf-8');
+    return true;
+}
+
+function harnesses() {
+    const geminiDir = path.join(HOME, '.gemini');
+    return [
+        {
+            name: 'Claude Code',
+            homeMarker: path.join(HOME, '.claude'),
+            skillsDir: path.join(HOME, '.claude', 'skills'),
+            mcpConfigPath: path.join(HOME, '.claude.json'),
+            mcpFormat: 'json',
+        },
+        {
+            name: 'OpenAI Codex',
+            homeMarker: path.join(HOME, '.codex'),
+            skillsDir: path.join(HOME, '.codex', 'skills'),
+            mcpConfigPath: path.join(HOME, '.codex', 'config.toml'),
+            mcpFormat: 'toml',
+        },
+        {
+            name: 'Antigravity (Gemini)',
+            homeMarker: geminiDir,
+            skillsDir: path.join(geminiDir, 'config', 'skills'),
+            mcpConfigPath: path.join(geminiDir, 'config', 'mcp_config.json'),
+            mcpFormat: 'json',
+        },
+        {
+            name: 'BDB universal (.agents)',
+            homeMarker: path.join(HOME, '.agents'),
+            skillsDir: path.join(HOME, '.agents', 'skills'),
+            mcpConfigPath: null, // no separate universal MCP store; skills only
+            mcpFormat: null,
+        },
+    ];
+}
+
+function installIntoHarness(h, servers) {
+    if (!fs.existsSync(h.homeMarker)) {
+        log.skip(`${h.name}: ${h.homeMarker} not found — harness not detected, skipping`);
+        return;
+    }
+
+    let copied = 0;
+    for (const skill of SKILLS) {
+        const src = path.join(INSTALL_DIR, 'skills', skill);
+        const dest = path.join(h.skillsDir, skill);
+        try {
+            copyDirRecursive(src, dest);
+            copied++;
+        } catch (e) {
+            log.warn(`${h.name}: failed to copy skill '${skill}': ${e.message}`);
+        }
+    }
+    if (copied) log.ok(`${h.name}: ${copied}/${SKILLS.length} skills copied to ${h.skillsDir}`);
+
+    if (!h.mcpConfigPath) return;
+    try {
+        const changed = h.mcpFormat === 'toml'
+            ? mergeTomlMcpConfig(h.mcpConfigPath, servers)
+            : mergeJsonMcpConfig(h.mcpConfigPath, servers);
+        if (changed) log.ok(`${h.name}: kicad + openscad MCP servers registered in ${h.mcpConfigPath}`);
+    } catch (e) {
+        log.warn(`${h.name}: failed to update MCP config ${h.mcpConfigPath}: ${e.message}`);
+    }
+}
+
+// --- main ------------------------------------------------------------------
+
+function main() {
+    console.log('================================================================================');
+    console.log(`BDB Hardware & PCB installer${AUTO ? ' (--auto)' : ''} — ${INSTALL_DIR}`);
+    console.log('================================================================================');
+
+    setupPythonEnvironments();
+
+    log.section('Harness detection & skill/MCP registration');
+    const servers = mcpServerEntries();
+    let anyHarness = false;
+    for (const h of harnesses()) {
+        if (fs.existsSync(h.homeMarker)) anyHarness = true;
+        installIntoHarness(h, servers);
+    }
+    if (!anyHarness) {
+        log.warn('No known harness (~/.claude, ~/.codex, ~/.gemini, ~/.agents) was found on this machine.');
+        log.warn('Python MCP servers are still set up above; install a harness and re-run to register skills/MCP.');
+    }
+
+    console.log('\n================================================================================');
+    console.log('BDB Hardware & PCB install finished.');
+    console.log('================================================================================');
+    process.exit(0);
+}
+
+try {
+    main();
+} catch (e) {
+    log.err(`Fatal: ${e.stack || e.message}`);
+    process.exit(1);
+}

package/mcp_servers/kicad-mcp-server/.env.example

@@ -0,0 +1,22 @@
+# KiCad MCP Server Configuration
+
+# Comma-separated paths to KiCad project directories
+# KICAD_PROJECT_PATHS=/path/to/projects1,/path/to/projects2
+
+# Default detail level for schematic summaries
+# Options: brief, standard, detailed
+DEFAULT_SUMMARY_DETAIL_LEVEL=standard
+
+# Include nets in summaries by default
+INCLUDE_NETS_IN_SUMMARY=true
+
+# Include power analysis in summaries by default
+INCLUDE_POWER_IN_SUMMARY=true
+
+# Default test framework for code generation
+# Options: pytest, unittest, arduino, zephyr, st_hal, esp_idf
+DEFAULT_TEST_FRAMEWORK=pytest
+
+# Default test type
+# Options: connectivity, functional, docs, production
+DEFAULT_TEST_TYPE=connectivity

package/mcp_servers/kicad-mcp-server/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install ruff
+      - run: ruff check src/ tests/
+
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.10", "3.13"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install package with test extras
+        run: python -m pip install -e ".[test]"
+      - name: Run tests
+        run: python -m pytest tests/ -q
+        # Parser/hierarchy tests need no KiCad install; the kicad-cli
+        # integration test self-skips when KiCad is absent.