Initial Overwatch tree.

Defense simulation, AERIS-10 hardware, firmware, and parts list as one clean history.

Co-authored-by: Cursor <cursoragent@cursor.com>

.github/workflows/ci-tests.yml

@@ -0,0 +1,116 @@
+name: AERIS-10 CI
+
+on:
+  pull_request:
+    branches: [main, develop]
+  push:
+    branches: [main, develop]
+
+jobs:
+  # ===========================================================================
+  # Python: lint (ruff), syntax check (py_compile), unit tests (pytest)
+  # CI structure proposed by hcm444 — uses uv for dependency management
+  # ===========================================================================
+  python-tests:
+    name: Python Lint + Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Install dependencies
+        run: uv sync --group dev
+
+      - name: Ruff lint (whole repo)
+        run: uv run ruff check .
+
+      - name: Syntax check (py_compile)
+        run: |
+          uv run python - <<'PY'
+          import py_compile
+          from pathlib import Path
+
+          skip = {".git", "__pycache__", ".venv", "venv", "docs"}
+          for p in Path(".").rglob("*.py"):
+              if skip & set(p.parts):
+                  continue
+              py_compile.compile(str(p), doraise=True)
+          PY
+
+      - name: Unit tests
+        run: >
+          uv run pytest
+          firmware/9_3_GUI/test_GUI_V65_Tk.py
+          firmware/9_3_GUI/test_v7.py
+          -v --tb=short
+
+  # ===========================================================================
+  # MCU Firmware Unit Tests (20 tests)
+  # Bug regression (15) + Gap-3 safety tests (5)
+  # ===========================================================================
+  mcu-tests:
+    name: MCU Firmware Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install build tools
+        run: sudo apt-get update && sudo apt-get install -y build-essential
+
+      - name: Build and run MCU tests
+        run: make test
+        working-directory: firmware/9_1_Microcontroller/tests
+
+  # ===========================================================================
+  # FPGA RTL Regression (25 testbenches + lint)
+  # ===========================================================================
+  fpga-regression:
+    name: FPGA Regression
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Icarus Verilog
+        run: sudo apt-get update && sudo apt-get install -y iverilog
+
+      - name: Run full FPGA regression
+        run: bash run_regression.sh
+        working-directory: firmware/9_2_FPGA
+
+  # ===========================================================================
+  # Cross-Layer Contract Tests (Python ↔ Verilog ↔ C)
+  # Validates opcode maps, bit widths, packet layouts, and round-trip
+  # correctness across FPGA RTL, Python GUI, and STM32 firmware.
+  # ===========================================================================
+  cross-layer-tests:
+    name: Cross-Layer Contract Tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Install dependencies
+        run: uv sync --group dev
+
+      - name: Install Icarus Verilog
+        run: sudo apt-get update && sudo apt-get install -y iverilog
+
+      - name: Run cross-layer contract tests
+        run: >
+          uv run pytest
+          firmware/tests/cross_layer/test_cross_layer_contract.py
+          -v --tb=short