easyeda-mcp-pro 1.8.0 → 1.9.0

package/README.md

@@ -1,69 +1,27 @@
 <div align="center">
 
-# easyeda-mcp-pro
+# EasyEDA MCP Pro
 
-<p>
-  Production-grade MCP server for EasyEDA Pro: safe PCB design inspection, BOM sourcing, manufacturing export, and AI-assisted hardware review.
-</p>
-
-<p>
-  <a href="https://www.npmjs.com/package/easyeda-mcp-pro">
-    <img src="https://img.shields.io/npm/v/easyeda-mcp-pro.svg?logo=npm" alt="npm version" />
-  </a>
-  <a href="https://www.npmjs.com/package/easyeda-mcp-pro">
-    <img src="https://img.shields.io/npm/dt/easyeda-mcp-pro?logo=npm&label=total%20downloads" alt="npm total downloads" />
-  </a>
-  <a href="https://www.npmjs.com/package/easyeda-mcp-pro">
-    <img src="https://img.shields.io/node/v/easyeda-mcp-pro" alt="supported Node.js version" />
-  </a>
-  <a href="LICENSE">
-    <img src="https://img.shields.io/npm/l/easyeda-mcp-pro.svg" alt="license" />
-  </a>
-  <a href="https://pnpm.io/">
-    <img src="https://img.shields.io/badge/pnpm-11.28.8-blue.svg" alt="pnpm" />
-  </a>
-</p>
+**Inspect, review, and safely automate EasyEDA Pro designs from MCP-compatible AI assistants.**
 
-<p>
-  <a href="https://github.com/oaslananka/easyeda-mcp-pro/actions/workflows/ci.yml">
-    <img src="https://github.com/oaslananka/easyeda-mcp-pro/actions/workflows/ci.yml/badge.svg" alt="CI status" />
-  </a>
-  <a href="https://github.com/oaslananka/easyeda-mcp-pro/actions/workflows/deploy-docs.yml">
-    <img src="https://github.com/oaslananka/easyeda-mcp-pro/actions/workflows/deploy-docs.yml/badge.svg" alt="Docs status" />
-  </a>
-  <a href="https://github.com/oaslananka/easyeda-mcp-pro/security/policy">
-    <img src="https://img.shields.io/badge/security-policy-blue" alt="Security policy" />
-  </a>
-  <a href="https://scorecard.dev/viewer/?uri=github.com/oaslananka/easyeda-mcp-pro">
-    <img src="https://api.scorecard.dev/projects/github.com/oaslananka/easyeda-mcp-pro/badge" alt="OpenSSF Scorecard" />
-  </a>
-</p>
-
-[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/oaslananka/easyeda-mcp-pro)
+[Documentation](https://oaslananka.github.io/easyeda-mcp-pro/) · [Getting Started](https://oaslananka.github.io/easyeda-mcp-pro/guide/getting-started.html) · [Tool Reference](https://oaslananka.github.io/easyeda-mcp-pro/reference/tools.html) · [Compatibility](https://oaslananka.github.io/easyeda-mcp-pro/reference/easyeda-compatibility.html) · [Roadmap](docs/ROADMAP.md)
 
 <p>
-  <a href="docs/ROADMAP.md">Roadmap</a> ·
-  <a href="docs/OPENSSF_BEST_PRACTICES.md">OpenSSF evidence</a> ·
-  <a href="docs/SECURITY_ASSURANCE_CASE.md">Security assurance case</a>
+  <a href="https://www.npmjs.com/package/easyeda-mcp-pro"><img src="https://img.shields.io/npm/v/easyeda-mcp-pro.svg?logo=npm" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/easyeda-mcp-pro"><img src="https://img.shields.io/node/v/easyeda-mcp-pro" alt="supported Node.js version" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/npm/l/easyeda-mcp-pro.svg" alt="MIT license" /></a>
 </p>
 
 <p>
-  <strong>Compliance docs:</strong>
-  <a href="THIRD_PARTY_NOTICES.md">Third-Party Notices</a>
-  ·
-  <a href="docs/vendor-terms.md">Vendor Terms and Unsupported Workflows</a>
-  ·
-  <a href="docs/REMOTE_MCP_MODES.md">Remote MCP Modes</a>
+  <a href="https://github.com/oaslananka/easyeda-mcp-pro/actions/workflows/ci.yml"><img src="https://github.com/oaslananka/easyeda-mcp-pro/actions/workflows/ci.yml/badge.svg" alt="CI status" /></a>
+  <a href="https://github.com/oaslananka/easyeda-mcp-pro/actions/workflows/deploy-docs.yml"><img src="https://github.com/oaslananka/easyeda-mcp-pro/actions/workflows/deploy-docs.yml/badge.svg" alt="Docs status" /></a>
+  <a href="https://github.com/oaslananka/easyeda-mcp-pro/security/policy"><img src="https://img.shields.io/badge/security-policy-blue" alt="Security policy" /></a>
+  <a href="https://scorecard.dev/viewer/?uri=github.com/oaslananka/easyeda-mcp-pro"><img src="https://api.scorecard.dev/projects/github.com/oaslananka/easyeda-mcp-pro/badge" alt="OpenSSF Scorecard" /></a>
 </p>
 
 <p>
-  <a href="https://www.buymeacoffee.com/oaslananka">
-    <img src="https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee&emoji=%E2%98%95&slug=oaslananka&button_colour=FFDD00&font_colour=000000&font_family=Inter&outline_colour=000000&coffee_colour=ffffff" height="28" alt="Buy me a coffee" />
-  </a>
-  &nbsp;&nbsp;
-  <a href="https://github.com/oaslananka/easyeda-mcp-pro">
-    <img src="https://img.shields.io/github/stars/oaslananka/easyeda-mcp-pro?style=for-the-badge&logo=github&label=Star%20on%20GitHub&color=FFA500&labelColor=181717" alt="Star on GitHub" />
-  </a>
+  <a href="https://deepwiki.com/oaslananka/easyeda-mcp-pro"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki" /></a>
+  <a href="https://gitgem.org/github/oaslananka/easyeda-mcp-pro"><img src="https://gitgem.org/api/badge/github/oaslananka/easyeda-mcp-pro.svg" alt="GitGem" /></a>
 </p>
 
 </div>
@@ -76,6 +34,10 @@ easyeda-mcp-pro keeps historical OpenSSF Best Practices evidence in [`docs/OPENS
 
 **Licensing note:** current repository source is MIT-licensed. Commercial use is permitted under MIT; historical releases retain the license notices shipped with them.
 
+**More project references:** [OpenSSF evidence](docs/OPENSSF_BEST_PRACTICES.md) · [Security assurance](docs/SECURITY_ASSURANCE_CASE.md) · [Third-party notices](THIRD_PARTY_NOTICES.md) · [Vendor terms](docs/vendor-terms.md) · [Remote MCP modes](docs/REMOTE_MCP_MODES.md)
+
+**Support development:** [Buy me a coffee](https://www.buymeacoffee.com/oaslananka) · [Star on GitHub](https://github.com/oaslananka/easyeda-mcp-pro)
+
 ---
 
 ## Quick Start
@@ -109,7 +71,7 @@ For advanced configurations, manual instructions, and specific clients, see [Ins
 
 ## Overview
 
-easyeda-mcp-pro is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that bridges AI assistants with hardware design workflows in EasyEDA Pro. It exposes up to 120 profile-gated MCP tools for schematic inspection and editing, controlled EasyEDA Pro API calls, Personal Device metadata, BOM management, design rule checks, PCB board analysis, fabrication exports, diagnostics, and supplier integration.
+easyeda-mcp-pro is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that bridges AI assistants with hardware design workflows in EasyEDA Pro. It exposes 126 profile-gated MCP tools for schematic inspection and editing, controlled EasyEDA Pro API calls, Personal Device metadata, BOM management, design rule checks, PCB board analysis, fabrication exports, diagnostics, and supplier integration.
 
 The server connects to EasyEDA Pro via a WebSocket bridge extension, enabling real-time access to open project data. It integrates with JLCPCB, LCSC, Mouser, and DigiKey for BOM sourcing and pricing.
 
@@ -594,11 +556,11 @@ The server registers profile-gated tools according to the active `TOOL_PROFILE`.
 
 | Profile        | Registered tools |
 | -------------- | ---------------: |
-| `core`         |               74 |
-| `pro`          |              101 |
-| `full`         |              117 |
-| `dev`          |              122 |
-| `experimental` |              123 |
+| `core`         |               77 |
+| `pro`          |              104 |
+| `full`         |              120 |
+| `dev`          |              125 |
+| `experimental` |              126 |
 
 <!-- capability-counts:end -->
 
@@ -668,6 +630,7 @@ The schematic write APIs use EasyEDA Pro extension APIs that EasyEDA currently m
 | `easyeda_drc_run`            | Design rule check for PCB           |
 | `easyeda_erc_run`            | Electrical rule check for schematic |
 | `easyeda_rule_check_summary` | Combined DRC + ERC summary          |
+| `easyeda_engineering_review` | Read-only PCB evidence and coverage |
 
 ### L1 — Board (core)
 
@@ -702,7 +665,7 @@ The schematic write APIs use EasyEDA Pro extension APIs that EasyEDA currently m
 │  (via Plugin)    │     Protocol      │  └───────────────┘  │
 └─────────────────┘                    │  ┌───────────────┐  │
                                        │  │  ToolRegistry  │  │
-                                       │  │ (up to 120 tools) │ │
+                                       │  │ (up to 126 tools) │ │
                                        │  └───────────────┘  │
                                        │  ┌───────────────┐  │
                                        │  │    Storage     │──┼──► SQLite
@@ -749,19 +712,20 @@ repository should catalog this plugin, but the manifest and workflow instruction
 here so they stay synchronized with the actual MCP server, bridge extension, tool
 profiles, and EasyEDA runtime behavior.
 
-| File                                                                                   | Purpose                                                                                                     |
-| -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| [`.claude-plugin/plugin.json`](.claude-plugin/plugin.json)                             | Claude Code-valid plugin manifest for compatible agent runtimes and marketplace catalogs.                   |
-| [`.mcp.json`](.mcp.json)                                                               | Project-local Claude Code MCP server configuration.                                                         |
-| [`.codex/config.example.toml`](.codex/config.example.toml)                             | Codex CLI MCP configuration example.                                                                        |
-| [`.vscode/mcp.example.json`](.vscode/mcp.example.json)                                 | VS Code / GitHub Copilot workspace MCP configuration example.                                               |
-| [`opencode.example.jsonc`](opencode.example.jsonc)                                     | OpenCode project MCP configuration example.                                                                 |
-| [`.opencode/skills/`](.opencode/skills)                                                | OpenCode-native mirrored skill definitions.                                                                 |
-| [`docs/agent-runtime-config.md`](docs/agent-runtime-config.md)                         | Agent runtime setup and validation matrix.                                                                  |
-| [`skills/easyeda-workflow/SKILL.md`](skills/easyeda-workflow/SKILL.md)                 | End-to-end EasyEDA setup, inspection, controlled write, export, and reporting workflow.                     |
-| [`skills/component-search/SKILL.md`](skills/component-search/SKILL.md)                 | Component search, BOM review, sourcing, pricing, availability, and part-risk workflow.                      |
-| [`skills/design-validation/SKILL.md`](skills/design-validation/SKILL.md)               | DRC/ERC, semantic ERC, PCB constraints, production QA, export, and release-validation workflow.             |
-| [`skills/easyeda-component-review/SKILL.md`](skills/easyeda-component-review/SKILL.md) | Datasheet, actual footprint and bound 3D model review, with structured evidence saved in a Personal Device. |
+| File                                                                                                                     | Purpose                                                                                                      |
+| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
+| [`.claude-plugin/plugin.json`](.claude-plugin/plugin.json)                                                               | Claude Code-valid plugin manifest for compatible agent runtimes and marketplace catalogs.                    |
+| [`.mcp.json`](.mcp.json)                                                                                                 | Project-local Claude Code MCP server configuration.                                                          |
+| [`.codex/config.example.toml`](.codex/config.example.toml)                                                               | Codex CLI MCP configuration example.                                                                         |
+| [`.vscode/mcp.example.json`](.vscode/mcp.example.json)                                                                   | VS Code / GitHub Copilot workspace MCP configuration example.                                                |
+| [`opencode.example.jsonc`](opencode.example.jsonc)                                                                       | OpenCode project MCP configuration example.                                                                  |
+| [`.opencode/skills/`](.opencode/skills)                                                                                  | OpenCode-native mirrored skill definitions.                                                                  |
+| [`docs/agent-runtime-config.md`](docs/agent-runtime-config.md)                                                           | Agent runtime setup and validation matrix.                                                                   |
+| [`skills/easyeda-workflow/SKILL.md`](skills/easyeda-workflow/SKILL.md)                                                   | End-to-end EasyEDA setup, inspection, controlled write, export, and reporting workflow.                      |
+| [`skills/component-search/SKILL.md`](skills/component-search/SKILL.md)                                                   | Component search, BOM review, sourcing, pricing, availability, and part-risk workflow.                       |
+| [`skills/design-validation/SKILL.md`](skills/design-validation/SKILL.md)                                                 | DRC/ERC, semantic ERC, PCB constraints, production QA, export, and release-validation workflow.              |
+| [`skills/design-validation/references/engineering-review.md`](skills/design-validation/references/engineering-review.md) | Canonical on-demand phase router for source-aware schematic, layout, DRC, DFM/DFT and human evidence review. |
+| [`skills/easyeda-component-review/SKILL.md`](skills/easyeda-component-review/SKILL.md)                                   | Datasheet, actual footprint and bound 3D model review, with structured evidence saved in a Personal Device.  |
 
 ### Agent setup
 

package/dist/circuit/circuit-ir.d.ts

@@ -104,9 +104,9 @@ export declare const PowerDomainSchema: z.ZodObject<{
     maxCurrentAmps: z.ZodOptional<z.ZodNumber>;
     isolation: z.ZodDefault<z.ZodEnum<{
         none: "none";
-        galvanic: "galvanic";
         functional: "functional";
         reinforced: "reinforced";
+        galvanic: "galvanic";
     }>>;
     designIntentRef: z.ZodDefault<z.ZodArray<z.ZodObject<{
         requirementId: z.ZodString;
@@ -133,8 +133,8 @@ export declare const SignalClassSchema: z.ZodObject<{
         rf: "rf";
         digital: "digital";
         clock: "clock";
-        can: "can";
         "high-speed": "high-speed";
+        can: "can";
         differential: "differential";
         sensitive: "sensitive";
     }>;
@@ -174,10 +174,10 @@ export declare const PhysicalConstraintSchema: z.ZodObject<{
         mechanical: "mechanical";
         thermal: "thermal";
         keepout: "keepout";
+        testability: "testability";
         height: "height";
         creepage: "creepage";
         accessibility: "accessibility";
-        testability: "testability";
     }>;
     severity: z.ZodDefault<z.ZodEnum<typeof ConstraintSeverity>>;
     targetType: z.ZodEnum<{
@@ -447,9 +447,9 @@ export declare const CircuitIRSchema: z.ZodObject<{
         maxCurrentAmps: z.ZodOptional<z.ZodNumber>;
         isolation: z.ZodDefault<z.ZodEnum<{
             none: "none";
-            galvanic: "galvanic";
             functional: "functional";
             reinforced: "reinforced";
+            galvanic: "galvanic";
         }>>;
         designIntentRef: z.ZodDefault<z.ZodArray<z.ZodObject<{
             requirementId: z.ZodString;
@@ -475,8 +475,8 @@ export declare const CircuitIRSchema: z.ZodObject<{
             rf: "rf";
             digital: "digital";
             clock: "clock";
-            can: "can";
             "high-speed": "high-speed";
+            can: "can";
             differential: "differential";
             sensitive: "sensitive";
         }>;
@@ -515,10 +515,10 @@ export declare const CircuitIRSchema: z.ZodObject<{
             mechanical: "mechanical";
             thermal: "thermal";
             keepout: "keepout";
+            testability: "testability";
             height: "height";
             creepage: "creepage";
             accessibility: "accessibility";
-            testability: "testability";
         }>;
         severity: z.ZodDefault<z.ZodEnum<typeof ConstraintSeverity>>;
         targetType: z.ZodEnum<{

package/dist/config/profiles.js

@@ -2,36 +2,36 @@ export const PROFILE_DEFINITIONS = {
     core: {
         name: 'core',
         label: 'Core',
-        description: 'High-confidence tools: diagnostics, EasyEDA API inventory, schematic, BOM, DRC/ERC, board layers/stackup, Gerber export',
-        approxToolCount: '74',
+        description: 'High-confidence tools: diagnostics, EasyEDA API inventory, schematic, BOM, DRC/ERC, board layers/stackup, drilled-pad inspection, active DRC rules, Gerber export',
+        approxToolCount: '77',
         isDefault: true,
     },
     pro: {
         name: 'pro',
         label: 'Pro',
         description: 'Adds pick-and-place, PDF, netlist export, compound transactional workflow tools, autorouting, route-context export, and offline SPICE verification for manufacturing workflows',
-        approxToolCount: '101',
+        approxToolCount: '104',
         isDefault: false,
     },
     full: {
         name: 'full',
         label: 'Full',
         description: 'Adds controlled documented EasyEDA API method calls and CircuitIR-driven floorplanning for full runtime control without raw JavaScript execution',
-        approxToolCount: '117',
+        approxToolCount: '120',
         isDefault: false,
     },
     dev: {
         name: 'dev',
         label: 'Dev',
         description: 'Adds diagnostics probes for bridge methods and live component runtime shape inspection',
-        approxToolCount: '122',
+        approxToolCount: '125',
         isDefault: false,
     },
     experimental: {
         name: 'experimental',
         label: 'Experimental',
         description: 'MCP Apps, Tasks, AI action plans',
-        approxToolCount: '123',
+        approxToolCount: '126',
         isDefault: false,
     },
 };

package/dist/config/profiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/config/profiles.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,mBAAmB,GAA2C;IACzE,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,WAAW,EACT,yHAAyH;QAC3H,eAAe,EAAE,IAAI;QACrB,SAAS,EAAE,IAAI;KAChB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,KAAK;QACZ,WAAW,EACT,gLAAgL;QAClL,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,KAAK;KACjB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,WAAW,EACT,kJAAkJ;QACpJ,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,KAAK;KACjB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,KAAK;QACZ,WAAW,EACT,wFAAwF;QAC1F,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,KAAK;KACjB;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,kCAAkC;QAC/C,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,KAAK;KACjB;CACF,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,MAAM,KAAK,GAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/config/profiles.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,mBAAmB,GAA2C;IACzE,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,WAAW,EACT,mKAAmK;QACrK,eAAe,EAAE,IAAI;QACrB,SAAS,EAAE,IAAI;KAChB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,KAAK;QACZ,WAAW,EACT,gLAAgL;QAClL,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,KAAK;KACjB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,WAAW,EACT,kJAAkJ;QACpJ,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,KAAK;KACjB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,KAAK;QACZ,WAAW,EACT,wFAAwF;QAC1F,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,KAAK;KACjB;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,kCAAkC;QAC/C,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,KAAK;KACjB;CACF,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,MAAM,KAAK,GAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC"}

package/dist/config/version.d.ts

@@ -1 +1 @@
-export declare const SERVER_VERSION = "1.8.0";
+export declare const SERVER_VERSION = "1.9.0";

package/dist/config/version.js

@@ -1,2 +1,2 @@
-export const SERVER_VERSION = '1.8.0'; // x-release-please-version
+export const SERVER_VERSION = '1.9.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/dist/design-rules/index.d.ts

@@ -9,3 +9,5 @@ export { lookupDecouplingGuidance, listDecouplingCategories, recommendBulkCapaci
 export type { DecouplingCategory, PerPinDecouplingGuidance, BulkCapacitanceRecommendation, } from './decoupling.js';
 export { listDfmChecklist, getDfmChecklistItem } from './dfm-checklist.js';
 export type { DfmCategory, DfmChecklistItem } from './dfm-checklist.js';
+export { reviewTraceCurrent } from './trace-current-review.js';
+export type { TraceCurrentReviewInput, TraceCurrentReview, TraceCurrentFinding, } from './trace-current-review.js';

package/dist/design-rules/index.js

@@ -4,4 +4,5 @@ export { lookupClearance } from './clearance.js';
 export { lookupProtocolRouting, listProtocolRoutingKeys } from './protocol-routing.js';
 export { lookupDecouplingGuidance, listDecouplingCategories, recommendBulkCapacitance, } from './decoupling.js';
 export { listDfmChecklist, getDfmChecklistItem } from './dfm-checklist.js';
+export { reviewTraceCurrent } from './trace-current-review.js';
 //# sourceMappingURL=index.js.map

package/dist/design-rules/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/design-rules/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGvF,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/design-rules/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGvF,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/design-rules/isolation-emc-review.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Explicitly source-scoped insulation/EMC review. An observed shortfall from a
+ * caller-declared requirement is a warning, not independent IEC/IPC proof.
+ * No protected standard tables or default spacing thresholds are embedded.
+ */
+export type InsulationPurpose = 'functional' | 'basic' | 'supplementary' | 'reinforced' | 'unspecified';
+export type Environment = 'controlled-indoor' | 'industrial' | 'outdoor' | 'condensing' | 'unspecified';
+export interface StandardReference {
+    identifier: string;
+    edition: string;
+    clause: string;
+    source: string;
+}
+export interface SpacingRequirement {
+    minimumMm: number;
+    reference: StandardReference;
+}
+export interface GeometryObservation {
+    distanceMm: number;
+    evidenceRef: string;
+    evidenceKind: 'measured_air_gap' | 'measured_surface_path' | 'estimated';
+}
+export interface IsolationEmcInput {
+    purpose?: InsulationPurpose;
+    workingVoltageV?: number;
+    transientVoltageV?: number;
+    environment?: Environment;
+    pollutionDegree?: 1 | 2 | 3 | 4;
+    overvoltageCategory?: 'I' | 'II' | 'III' | 'IV';
+    materialGroup?: 'I' | 'II' | 'IIIa' | 'IIIb';
+    altitudeM?: number;
+    safetyStandard?: StandardReference;
+    clearanceRequirement?: SpacingRequirement;
+    creepageRequirement?: SpacingRequirement;
+    airClearance?: GeometryObservation;
+    surfaceCreepage?: GeometryObservation;
+    boardSlotEvidence?: string;
+    coatingEvidence?: string;
+    esdEntry?: {
+        connectorRef: string;
+        protectorRef?: string;
+        entryNet?: string;
+        returnPathEvidence?: string;
+        testStandard?: StandardReference;
+    };
+    emcReturn?: {
+        fastLoopRef?: string;
+        returnPlaneEvidence?: string;
+        sensitiveCircuitRef?: string;
+    };
+}
+export interface IsolationEmcFinding {
+    id: 'AIR_CLEARANCE' | 'SURFACE_CREEPAGE' | 'INSULATION_CONTEXT' | 'ESD_ENTRY' | 'EMC_RETURN';
+    status: 'WARNING' | 'UNKNOWN';
+    message: string;
+    reported_mm?: number;
+    declared_min_mm?: number;
+    reference?: StandardReference;
+    evidence_refs: string[];
+    missing: string[];
+}
+export interface IsolationEmcReview {
+    status: 'WARNING' | 'UNKNOWN';
+    evidence: 'caller_supplied_unverified';
+    safety_certification: false;
+    qualified_review_required: boolean;
+    context_missing: string[];
+    findings: IsolationEmcFinding[];
+    limitations: string[];
+    source_references: StandardReference[];
+    engineering_sign_off: false;
+}
+export declare function reviewIsolationEmc(input: IsolationEmcInput): IsolationEmcReview;

package/dist/design-rules/isolation-emc-review.js

@@ -0,0 +1,170 @@
+/**
+ * Explicitly source-scoped insulation/EMC review. An observed shortfall from a
+ * caller-declared requirement is a warning, not independent IEC/IPC proof.
+ * No protected standard tables or default spacing thresholds are embedded.
+ */
+function spacingEvidenceState(id, requirement, observation) {
+    const validMinimum = requirement !== undefined &&
+        Number.isFinite(requirement.minimumMm) &&
+        requirement.minimumMm >= 0;
+    const validDistance = observation !== undefined &&
+        Number.isFinite(observation.distanceMm) &&
+        observation.distanceMm >= 0;
+    const missing = [
+        ...(requirement === undefined ? ['source-declared minimum distance'] : []),
+        ...(requirement !== undefined && !validMinimum
+            ? ['finite nonnegative source-declared minimum']
+            : []),
+        ...(observation === undefined ? ['geometry measurement'] : []),
+        ...(observation !== undefined && !validDistance
+            ? ['finite nonnegative geometry measurement']
+            : []),
+    ];
+    const expectedKind = id === 'AIR_CLEARANCE' ? 'measured_air_gap' : 'measured_surface_path';
+    if (observation !== undefined && observation.evidenceKind !== expectedKind) {
+        missing.push(id === 'AIR_CLEARANCE'
+            ? 'measured through-air clearance between actual conductors'
+            : 'measured along-surface creepage path accounting for geometry and slots');
+    }
+    return { validMinimum, validDistance, missing };
+}
+function reviewSpacing(id, requirement, observation) {
+    const { validMinimum, validDistance, missing } = spacingEvidenceState(id, requirement, observation);
+    const base = {
+        id,
+        status: 'UNKNOWN',
+        message: 'Only explicit, source-declared dimensions are compared; independent safety compliance is not verified.',
+        evidence_refs: observation ? [observation.evidenceRef] : [],
+        missing,
+        ...(requirement
+            ? {
+                ...(validMinimum ? { declared_min_mm: requirement.minimumMm } : {}),
+                reference: requirement.reference,
+            }
+            : {}),
+        ...(validDistance && observation ? { reported_mm: observation.distanceMm } : {}),
+    };
+    if (missing.length > 0 || !requirement || !observation)
+        return base;
+    const violated = observation.distanceMm < requirement.minimumMm;
+    return {
+        ...base,
+        status: violated ? 'WARNING' : 'UNKNOWN',
+        message: violated
+            ? 'Caller-reported geometry is below its caller-declared, edition-linked minimum; verify the source and board physically.'
+            : 'Caller-reported geometry meets its declared minimum, but the source applicability and measurement are unverified.',
+    };
+}
+function validContextVoltage(value) {
+    return value !== undefined && Number.isFinite(value) && value >= 0;
+}
+function validPollutionDegree(value) {
+    return value !== undefined && Number.isInteger(value) && value >= 1 && value <= 4;
+}
+function missingContext(input) {
+    const missing = [];
+    if (input.purpose === undefined || input.purpose === 'unspecified') {
+        missing.push('insulation purpose (functional/basic/supplementary/reinforced)');
+    }
+    if (!validContextVoltage(input.workingVoltageV))
+        missing.push('working voltage');
+    if (!validContextVoltage(input.transientVoltageV))
+        missing.push('transient/impulse voltage');
+    if (input.environment === undefined || input.environment === 'unspecified') {
+        missing.push('environment and condensation exposure');
+    }
+    if (!validPollutionDegree(input.pollutionDegree))
+        missing.push('pollution degree');
+    if (input.overvoltageCategory === undefined)
+        missing.push('overvoltage category');
+    if (input.materialGroup === undefined)
+        missing.push('insulating material group / CTI');
+    if (!Number.isFinite(input.altitudeM))
+        missing.push('installation altitude');
+    if (input.safetyStandard === undefined)
+        missing.push('applicable safety standard, edition and clause');
+    return missing;
+}
+function reviewEsd(input) {
+    const missing = [
+        ...(input.protectorRef ? [] : ['declared ESD protection component']),
+        ...(input.entryNet ? [] : ['connector entry net']),
+        ...(input.returnPathEvidence
+            ? []
+            : ['verified short ESD return path and actual copper geometry']),
+    ];
+    return {
+        id: 'ESD_ENTRY',
+        status: 'UNKNOWN',
+        message: 'Connector/TVS designators are not proof of placement, discharge routing or IEC 61000-4-2 immunity performance.',
+        ...(input.testStandard ? { reference: input.testStandard } : {}),
+        evidence_refs: input.returnPathEvidence ? [input.returnPathEvidence] : [],
+        missing,
+    };
+}
+function reviewEmc(input) {
+    return {
+        id: 'EMC_RETURN',
+        status: 'UNKNOWN',
+        message: 'Names of loops, planes and sensitive parts do not establish measured EMI or continuous high-frequency return paths.',
+        evidence_refs: input.returnPlaneEvidence ? [input.returnPlaneEvidence] : [],
+        missing: [
+            ...(input.fastLoopRef ? [] : ['fast-current loop identity']),
+            ...(input.returnPlaneEvidence ? [] : ['verified reference-plane/return-current geometry']),
+            ...(input.sensitiveCircuitRef ? [] : ['sensitive circuit identity']),
+        ],
+    };
+}
+function uniqueReferences(input) {
+    const sources = [
+        input.safetyStandard,
+        input.clearanceRequirement?.reference,
+        input.creepageRequirement?.reference,
+        input.esdEntry?.testStandard,
+    ].filter((source) => source !== undefined);
+    return sources.filter((source, i) => sources.findIndex((other) => other.identifier === source.identifier &&
+        other.edition === source.edition &&
+        other.clause === source.clause &&
+        other.source === source.source) === i);
+}
+export function reviewIsolationEmc(input) {
+    const context_missing = missingContext(input);
+    const findings = [
+        reviewSpacing('AIR_CLEARANCE', input.clearanceRequirement, input.airClearance),
+        reviewSpacing('SURFACE_CREEPAGE', input.creepageRequirement, input.surfaceCreepage),
+        {
+            id: 'INSULATION_CONTEXT',
+            status: 'UNKNOWN',
+            message: 'Voltage, material, environment and standard applicability must be checked by a qualified design reviewer; no insulation classification is certified.',
+            evidence_refs: [
+                ...(input.boardSlotEvidence ? [input.boardSlotEvidence] : []),
+                ...(input.coatingEvidence ? [input.coatingEvidence] : []),
+            ],
+            missing: context_missing,
+        },
+    ];
+    if (input.esdEntry)
+        findings.push(reviewEsd(input.esdEntry));
+    if (input.emcReturn)
+        findings.push(reviewEmc(input.emcReturn));
+    const qualified = ['basic', 'supplementary', 'reinforced'].includes(input.purpose ?? '');
+    return {
+        status: findings.some((finding) => finding.status === 'WARNING') ? 'WARNING' : 'UNKNOWN',
+        evidence: 'caller_supplied_unverified',
+        safety_certification: false,
+        qualified_review_required: qualified || context_missing.length > 0,
+        context_missing,
+        findings,
+        limitations: [
+            'IEC/IPC numeric tables are not embedded; requirement, edition, applicability and geometry are independently caller-declared, not checked against licensed standards.',
+            'Air clearance is the shortest through-air route; creepage is the shortest distance along the insulation surface. A direct PCB XY gap is not automatically a creepage path.',
+            'Slots, cutouts, conformal coating, encapsulation and barriers change geometry and applicability but cannot be inferred or certified from provided names or descriptions.',
+            'Environmental conditions, pollution degree, overvoltage, material group/CTI, altitude, insulation class and equipment safety context require qualified human verification.',
+            'ESD advice does not establish IEC 61000-4-2 test results; EMC/EMI compliance requires appropriate measurement or laboratory evidence.',
+            'No PCB primitives were read and no DRC, field solver, safety inspection, EMC measurement or physical acceptance was performed.',
+        ],
+        source_references: uniqueReferences(input),
+        engineering_sign_off: false,
+    };
+}
+//# sourceMappingURL=isolation-emc-review.js.map

package/dist/design-rules/isolation-emc-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolation-emc-review.js","sourceRoot":"","sources":["../../src/design-rules/isolation-emc-review.ts"],"names":[],"mappings":"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"}

package/dist/design-rules/trace-current-review.d.ts

@@ -0,0 +1,41 @@
+import { type ConductorLayer } from './trace-width.js';
+/**
+ * An auditable reference estimate, not a verification of an EasyEDA route.
+ * All geometry and material inputs are caller supplied; no native readings
+ * or vendor thermal validation are implied.
+ */
+export interface TraceCurrentReviewInput {
+    currentA?: number;
+    temperatureRiseC?: number;
+    layer?: ConductorLayer;
+    copperWeightOz?: number;
+    traceWidthMm?: number;
+    neckDownWidthMm?: number;
+    manufacturerMinWidthMm?: number;
+    environment?: 'still-air' | 'forced-air' | 'vacuum' | 'unspecified';
+}
+export interface TraceCurrentFinding {
+    id: 'THERMAL_ESTIMATE' | 'FABRICATION_WIDTH' | 'ROUTE_GEOMETRY' | 'VIA_BOTTLENECK';
+    status: 'WARNING' | 'UNKNOWN';
+    message: string;
+}
+export interface TraceCurrentReview {
+    status: 'WARNING' | 'UNKNOWN';
+    method: 'IPC2221_EMPIRICAL_REFERENCE';
+    evidence: 'caller_supplied_unverified';
+    source: string;
+    inputs: TraceCurrentReviewInput;
+    inputUnits: {
+        currentA: 'A';
+        temperatureRiseC: '°C';
+        copperWeightOz: 'oz/ft²';
+        traceWidthMm: 'mm';
+        neckDownWidthMm: 'mm';
+        manufacturerMinWidthMm: 'mm';
+    };
+    estimatedMinimumWidthMm?: number;
+    suppliedNarrowestWidthMm?: number;
+    findings: TraceCurrentFinding[];
+    limitations: string[];
+}
+export declare function reviewTraceCurrent(input: TraceCurrentReviewInput): TraceCurrentReview;