chore: fleet remediation (KiCad 10, DRC gate, Makefile, gitignore, library re-points)

.github/workflows/docs-pipeline.yml

@@ -1,6 +1,19 @@
+# Copy to .github/workflows/docs-pipeline.yml in a board repo.
+#
+# The `pull_request` trigger is the important part. The fleet previously ran ERC
+# and DRC only on `push: main` -- so hardware checks ran *after* a change had
+# already merged. They could report that main was broken; they could never stop
+# it from breaking. A gate that only fires post-merge is a notification, not a gate.
+
 name: Docs Pipeline
 
 on:
+  pull_request:
+    paths:
+      - "hardware/**"
+      - "docs/**"
+      - "scripts/**"
+      - ".github/workflows/**"
   push:
     branches: [main]
     paths:
@@ -11,18 +24,27 @@ on:
   workflow_dispatch:
 
 jobs:
+  # Fails if the board is not aligned with BREADS: KiCad 10 file format, a real
+  # (error-severity) schematic-parity gate, every library reference resolving,
+  # and un-swapped Makefile targets. Green here means the board is done.
+  validate-board:
+    uses: feastorg/bread-infra/.github/workflows/validate-board.yml@v1.2.0
+
   kibot:
-    uses: feastorg/bread-infra/.github/workflows/kibot-ci.yml@main
+    uses: feastorg/bread-infra/.github/workflows/kibot-ci.yml@v1.2.0
 
+  # Publishing only makes sense for the canonical branch.
   gen-kibot-index:
-    uses: feastorg/bread-infra/.github/workflows/publish-kibot.yml@main
+    if: github.event_name != 'pull_request'
+    uses: feastorg/bread-infra/.github/workflows/publish-kibot.yml@v1.2.0
     needs: [kibot]
     with:
       kibot_run_id: ${{ needs.kibot.outputs.kibot_run_id }}
 
   deploy-pages:
-    uses: feastorg/bread-infra/.github/workflows/deploy-pages.yml@main
-    needs: [gen-kibot-index]
+    if: github.event_name != 'pull_request'
+    uses: feastorg/bread-infra/.github/workflows/deploy-pages.yml@v1.2.0
+    needs: [gen-kibot-index, kibot]
     with:
       kibot_run_id: ${{ needs.kibot.outputs.kibot_run_id }}
       commit_sha: ${{ needs.gen-kibot-index.outputs.kibot_index_sha }}

.gitignore

@@ -13,9 +13,25 @@
 fp-info-cache
 sym-lib-table
 fp-lib-table
+# KiCad 10 adds design blocks; like the other lib tables it holds absolute
+# paths, so it is machine-local and generated, never committed.
+design-block-lib-table
+
+# KiCad's project lock file, written while a project is open (~<prj>.kicad_pro.lck)
+*.lck
 
 # Ignore other temporary files
 *.tmp
 *.log
 *.bak
 *.swp
+
+# KiCad 10 local history: a nested git repo (git_repository_init on
+# <project>/.history). The .gitignore KiCad writes inside it governs
+# KiCad's history repo, not this one. Committing it adds a broken gitlink.
+.history/
+
+# KiCad rewrites .kicad_prl on every project open (open sheet, zoom, selection
+# filter). Per-developer local state, not design intent -- tracking it dirties
+# the working tree every time anyone opens the board.
+*.kicad_prl