fix: register sync_schematic_to_board + snapshot_project as MCP tools; auto-save board after SWIG mutations; boardPath reload in place_component; add_schematic_connection warns about connect_passthrough; via.GetWidth(F_Cu) for KiCAD 9.0

src/tools/project.ts

@@ -76,4 +76,23 @@ export function registerProjectTools(server: McpServer, callKicadScript: Functio
       };
     }
   );
+
+  // Snapshot project tool — saves a named checkpoint as PDF/image
+  server.tool(
+    "snapshot_project",
+    "Save a named checkpoint snapshot of the current project state (renders board to PDF and records step label). Call after completing each major step — e.g. after Step 1 (schematic_ok) and Step 2 (layout_ok). Required by the demo workflow before waiting for user confirmation.",
+    {
+      step: z.string().describe("Step number or identifier, e.g. '1' or '2'"),
+      label: z.string().describe("Short label for this checkpoint, e.g. 'schematic_ok' or 'layout_ok'"),
+    },
+    async (args: { step: string; label: string }) => {
+      const result = await callKicadScript("snapshot_project", args);
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify(result, null, 2)
+        }]
+      };
+    }
+  );
 }

src/tools/schematic.ts

@@ -227,7 +227,7 @@ Note: operates on .kicad_sch files only. To modify a PCB footprint use edit_comp
   // Add pin-to-pin connection
   server.tool(
     "add_schematic_connection",
-    "Connect two component pins with a wire",
+    "Connect two component pins with a wire. Use this for individual connections between components with different pin roles (e.g. U1.SDA → J3.2). WARNING: Do NOT use this in a loop to wire N passthrough pins — use connect_passthrough instead (single call, cleaner layout, far fewer tokens).",
     {
       schematicPath: z.string().describe("Path to the schematic file"),
       sourceRef: z.string().describe("Source component reference (e.g., R1)"),
@@ -527,4 +527,20 @@ Note: operates on .kicad_sch files only. To modify a PCB footprint use edit_comp
       }
     },
   );
+
+  // Sync schematic to PCB board (equivalent to KiCAD F8 / "Update PCB from Schematic")
+  server.tool(
+    "sync_schematic_to_board",
+    "Import the schematic netlist into the PCB board — equivalent to pressing F8 in KiCAD (Tools → Update PCB from Schematic). MUST be called after the schematic is complete and before placing or routing components on the PCB. Without this step, the board has no footprints and no net assignments — place_component and route_pad_to_pad will produce an empty, unroutable board.",
+    {
+      schematicPath: z.string().describe("Absolute path to the .kicad_sch schematic file"),
+      boardPath: z.string().describe("Absolute path to the .kicad_pcb board file"),
+    },
+    async (args: { schematicPath: string; boardPath: string }) => {
+      const result = await callKicadScript("sync_schematic_to_board", args);
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+      };
+    },
+  );
 }