Small

// POST /verify-design → DesignEvidence (truncated)
{
  "verdict": "pass",
  "summary": "Simulation OK — 3/3 checks passed",
  "assertions": [
    {
      "label": "LED current ≈ 10 mA",
      "probe": "i(R1)", "metric": "final", "op": "approx",
      "target": 0.01, "actual": 0.0091, "pass": true,
      "detail": "final(i(R1)) = 0.0091 ✓ approx 0.01"
    }
    // …every criterion, with the measured value and its signed distance to target
  ],
  "measurements": [ { "node": "@r1[i]", "min": 0.0091, "max": 0.0091, "final": 0.0091 } /* … */ ],
  "robustness": {
    "worstCase": { "componentsCornered": ["R1"], "evaluated": 2, "passed": 2, "passAllCorners": true }
  }
}

flowchart LR
    U["Circuit JSON<br/>+ acceptance criteria"] --> API["API<br/>(NestJS)"]
    P["Design prompt"] -.-> LLM["AI design loop<br/>(parts-grounded)"]
    LLM -.->|"proposes circuit"| API
    API -->|"enqueue"| Q[("BullMQ<br/>queue")]
    Q --> W["Simulation worker"]
    W --> NG["ngspice<br/>sandboxed subprocess"]
    NG --> W
    W --> DB[("Postgres / S3")]
    API -->|"poll"| DB
    API --> EV["Evidence pack:<br/>verdict · measurements · robustness"]
    EV -.->|"measured failures feed back"| LLM

apps/
  api/          NestJS REST API — auth, orgs, projects, simulation, AI generation, parts, usage
  worker-sim/   Simulation worker — sandboxed ngspice, Monte-Carlo / corner / sweep batch runners
  pcb-worker/   PCB worker — layout, DRC, Gerber/BOM/PnP, 3D model jobs
  pcb-viewer/   Dev tool — 3D board preview
packages/
  eda-core/     The EDA brain — circuit model, netlist generation, SPICE sanitization, ERC,
                result parsing, assertions, Monte-Carlo/corner/sweep engines  (MIT)
  llm-core/     AI design loop — parts-grounded tool use, simulate-in-the-loop self-repair
  pcb-core/     PCB contracts — fab profiles, DRC oracle, Gerber/BOM/PnP writers
crates/
  pcb-placement-rs/  Rust placement engine (cf-pcb-place) — out-of-process, ~100× on dense boards

cp .env.example .env                        # REQUIRED — .env is gitignored; the API refuses to boot
                                            # without two distinct 32+ char JWT secrets
pnpm install                                # never `npm install`
docker compose up -d postgres redis minio create-bucket   # create-bucket is NOT optional: nothing else
                                            # creates the S3 bucket, and /health/ready 503s without it
pnpm db:migrate:dev                         # apply schema (needs DATABASE_URL visible to apps/api —
                                            # see LOCAL_SETUP.md if it fails with Prisma P1012)
pnpm db:seed                                # demo data (optional)
pnpm dev                                    # start all apps in watch mode

# Windows (Administrator PowerShell)
choco install ngspice -y
# Linux:  sudo apt-get install ngspice     |     macOS:  brew install ngspice