easyeda-mcp-pro 0.4.0 → 0.5.3

package/README.md

@@ -365,29 +365,36 @@ Copy `.env.example` to `.env` and edit. All variables have safe defaults — onl
 
 ### Essential
 
-| Variable       | Default       | Description                                                                  |
-| -------------- | ------------- | ---------------------------------------------------------------------------- |
-| `NODE_ENV`     | `development` | Set to `production` in production                                            |
-| `LOG_LEVEL`    | `info`        | Pino log level: `trace`, `debug`, `info`, `warn`, `error`, `fatal`, `silent` |
-| `TOOL_PROFILE` | `core`        | Tool set: `core`, `pro`, `full`, `dev`, `experimental`                       |
-| `TRANSPORT`    | `stdio`       | Server transport: `stdio` (default) or `http`                                |
+| Variable               | Default       | Description                                                                  |
+| ---------------------- | ------------- | ---------------------------------------------------------------------------- |
+| `NODE_ENV`             | `development` | Set to `production` in production                                            |
+| `LOG_LEVEL`            | `info`        | Pino log level: `trace`, `debug`, `info`, `warn`, `error`, `fatal`, `silent` |
+| `TOOL_PROFILE`         | `core`        | Tool set: `core`, `pro`, `full`, `dev`, `experimental`                       |
+| `MCP_PROTOCOL_VERSION` | `2025-11-25`  | MCP protocol version string                                                  |
+| `TRANSPORT`            | `stdio`       | Server transport: `stdio` (default) or `http`                                |
 
 ### Bridge (EasyEDA Pro connection)
 
-| Variable              | Default             | Description                      |
-| --------------------- | ------------------- | -------------------------------- |
-| `BRIDGE_HOST`         | `127.0.0.1`         | Bridge WebSocket host            |
-| `BRIDGE_PORT`         | `18601`             | Primary bridge port              |
-| `BRIDGE_PORT_SCAN`    | `18601,49620-49629` | Port scan spec (comma/range)     |
-| `BRIDGE_TIMEOUT_MS`   | `15000`             | Bridge call timeout (ms)         |
-| `BRIDGE_HEARTBEAT_MS` | `10000`             | Heartbeat interval (ms)          |
-| `BRIDGE_TOKEN`        | `''`                | Session token for extension auth |
+| Variable                        | Default       | Description                               |
+| ------------------------------- | ------------- | ----------------------------------------- |
+| `BRIDGE_HOST`                   | `127.0.0.1`   | Bridge WebSocket host                     |
+| `BRIDGE_PORT`                   | `49620`       | Primary bridge port                       |
+| `BRIDGE_PORT_SCAN`              | `49620-49629` | Port scan spec (comma/range)              |
+| `BRIDGE_TIMEOUT_MS`             | `15000`       | Bridge call timeout (ms)                  |
+| `BRIDGE_HEARTBEAT_MS`           | `10000`       | Heartbeat interval (ms)                   |
+| `BRIDGE_RECONNECT_MAX_ATTEMPTS` | `0`           | Max reconnect attempts (`0` = infinite)   |
+| `BRIDGE_WAIT_FOR_EDA_MS`        | `30000`       | Wait for EasyEDA Pro on startup (ms)      |
+| `BRIDGE_MAX_PAYLOAD_SIZE`       | `1048576`     | Max bridge payload (bytes, default 1 MiB) |
+| `BRIDGE_TOKEN`                  | `''`          | Session token for extension auth          |
 
 ### Storage
 
-| Variable   | Default            | Description                                 |
-| ---------- | ------------------ | ------------------------------------------- |
-| `DATA_DIR` | `.easyeda-mcp-pro` | Data directory (cache, database, artifacts) |
+| Variable       | Default                                   | Description                                 |
+| -------------- | ----------------------------------------- | ------------------------------------------- |
+| `DATA_DIR`     | `.easyeda-mcp-pro`                        | Data directory (cache, database, artifacts) |
+| `SQLITE_PATH`  | `.easyeda-mcp-pro/easyeda-mcp-pro.sqlite` | SQLite database path                        |
+| `ARTIFACT_DIR` | `.easyeda-mcp-pro/artifacts`              | Artifact export directory                   |
+| `CACHE_DIR`    | `.easyeda-mcp-pro/cache`                  | Cache directory                             |
 
 ### Supplier integration
 
@@ -402,10 +409,14 @@ Enable suppliers by setting their credentials. All suppliers are disabled by def
 
 Configure an AI provider for LLM-assisted design review:
 
-| Variable      | Default | Description                                     |
-| ------------- | ------- | ----------------------------------------------- |
-| `AI_PROVIDER` | `none`  | `anthropic`, `openai`, `openrouter`, or `local` |
-| `AI_MODEL`    | `''`    | Model name                                      |
+| Variable                    | Default | Description                                     |
+| --------------------------- | ------- | ----------------------------------------------- |
+| `AI_PROVIDER`               | `none`  | `anthropic`, `openai`, `openrouter`, or `local` |
+| `AI_MODEL`                  | `''`    | Model name (e.g., `claude-sonnet-4-20250514`)   |
+| `AI_API_KEY`                | `''`    | AI provider API key                             |
+| `AI_MAX_TOKENS`             | `8000`  | Max tokens per AI response                      |
+| `AI_TIMEOUT_MS`             | `60000` | AI request timeout in ms                        |
+| `AI_ALLOW_DESIGN_MUTATIONS` | `false` | Allow AI to modify schematic/board designs      |
 
 ### HTTP transport
 
@@ -415,6 +426,7 @@ When using `TRANSPORT=http`:
 | --------------------- | ----------- | ----------------------------------------- |
 | `HTTP_HOST`           | `127.0.0.1` | Bind address (use `0.0.0.0` with caution) |
 | `HTTP_PORT`           | `3000`      | Port                                      |
+| `HTTP_AUTH_DISABLED`  | `false`     | Disable HTTP transport authentication     |
 | `HTTP_RATE_LIMIT_MAX` | `100`       | Max requests per minute per IP            |
 | `CORS_ORIGIN`         | `''`        | Allowed CORS origin                       |
 
@@ -577,20 +589,34 @@ Installation: Open EasyEDA Pro → **Settings** → **Extensions** → **Extensi
 
 ## Development
 
+### Prerequisites
+
+- **Node.js** >=24 <27
+- **pnpm** >=11
+- **Go Task** (optional, for Taskfile commands)
+
+### Quick Start
+
 ```bash
 # Setup
 pnpm install
 cp .env.example .env
 
-# Code quality
+# All quality gates (lint + format + typecheck + test + build)
+task verify
+
+# Or use pnpm directly:
 pnpm format:check          # Prettier
 pnpm typecheck             # TypeScript
 pnpm lint                  # ESLint
 
 # Test
-pnpm test                  # Vitest (120 tests across 18 files)
+pnpm test                  # Vitest (120+ tests across 18+ files)
 pnpm test:coverage         # With coverage report
 
+# Golden E2E fixture smoke tests are included in `pnpm test`
+# See docs/golden-fixtures.md for fixture architecture
+
 # Build & run
 pnpm build                 # tsc -> dist/
 pnpm build:extension       # Bundle EasyEDA Pro extension
@@ -602,6 +628,22 @@ pnpm start                 # Run compiled build
 pnpm inspector
 ```
 
+### Available Taskfile Commands
+
+This project includes a `Taskfile.yml` with the following commands:
+
+| Command          | Description                     |
+| ---------------- | ------------------------------- |
+| `task install`   | Install dependencies            |
+| `task lint`      | Run ESLint                      |
+| `task format`    | Check formatting with Prettier  |
+| `task typecheck` | Run TypeScript type checking    |
+| `task test`      | Run tests                       |
+| `task build`     | Build the project               |
+| `task verify`    | Run all quality gates (CI gate) |
+
+Install [Go Task](https://taskfile.dev/installation/) to use these commands.
+
 ### Project structure
 
 ```
@@ -631,8 +673,10 @@ easyeda-bridge-extension/    # EasyEDA Pro bridge extension workspace package
 
 ## Security
 
+See [Security Architecture & Threat Model](docs/security-architecture.md) for the complete security reference, including deployment modes, authentication, tool safety controls, secrets management, safe defaults, supplier API security, threat scenarios, and deployment checklists.
+
 - **Production safety**: Validates config at startup — rejects non-loopback HTTP without OAuth, blocks dangerous features in production
-- **OAuth/JWKS**: Optional Bearer token validation via JWKS endpoint for HTTP transport
+- **OAuth/JWKS**: Bearer token validation via JWKS endpoint for HTTP transport (see [OAuth section](docs/security-architecture.md#21-oauth-20--openid-connect-http-transport))
 - **Rate limiting**: Per-IP sliding window rate limiter on HTTP transport (default 100 req/min)
 - **Path traversal protection**: All file export paths validated against `ARTIFACT_DIR`
 - **Secret redaction**: API keys, tokens, passwords are redacted from logs and diagnostic output

package/dist/bom-quality/adapter.d.ts

@@ -0,0 +1,90 @@
+/**
+ * BOM quality — supplier adapter layer.
+ *
+ * Provides a common {@link SupplierAdapter} interface over each vendor
+ * client so quality checks can query any configured supplier uniformly.
+ *
+ * Each adapter:
+ *  - normalises part data into {@link SupplierQueryResult}
+ *  - records a query timestamp for provenance
+ *  - wraps transient errors with an exponential-backoff retry
+ *
+ * @module
+ */
+import { type LcscClient } from '../vendors/lcsc/client.js';
+import { type MouserClient } from '../vendors/mouser/client.js';
+import { type DigiKeyClient } from '../vendors/digikey/client.js';
+import type { SupplierKind, SupplierQueryResult } from './types.js';
+export interface SupplierAdapter {
+    /** Short supplier key (e.g. 'lcsc', 'mouser'). */
+    readonly kind: SupplierKind;
+    /** Human-readable supplier name. */
+    readonly displayName: string;
+    /** Whether this supplier is configured and available. */
+    isAvailable(): boolean;
+    /**
+     * Query a part by LCSC code or manufacturer part number.
+     * Returns `null` when the part is not found (not an error).
+     */
+    queryPart(identifier: {
+        lcsc?: string;
+        mpn?: string;
+    }): Promise<SupplierQueryResult | null>;
+}
+export declare class LcscAdapter implements SupplierAdapter {
+    readonly kind: SupplierKind;
+    readonly displayName = "LCSC";
+    private client;
+    private logger;
+    constructor(client: LcscClient | null);
+    isAvailable(): boolean;
+    private buildFoundResult;
+    queryPart(identifier: {
+        lcsc?: string;
+        mpn?: string;
+    }): Promise<SupplierQueryResult | null>;
+}
+export declare class MouserAdapter implements SupplierAdapter {
+    readonly kind: SupplierKind;
+    readonly displayName = "Mouser";
+    private client;
+    private logger;
+    constructor(client: MouserClient | null);
+    isAvailable(): boolean;
+    private buildFoundResult;
+    queryPart(identifier: {
+        lcsc?: string;
+        mpn?: string;
+    }): Promise<SupplierQueryResult | null>;
+}
+export declare class DigiKeyAdapter implements SupplierAdapter {
+    readonly kind: SupplierKind;
+    readonly displayName = "DigiKey";
+    private client;
+    private logger;
+    constructor(client: DigiKeyClient | null);
+    isAvailable(): boolean;
+    private buildFoundResult;
+    queryPart(identifier: {
+        lcsc?: string;
+        mpn?: string;
+    }): Promise<SupplierQueryResult | null>;
+}
+export interface AdapterMap {
+    lcsc: LcscAdapter;
+    mouser: MouserAdapter;
+    digikey: DigiKeyAdapter;
+}
+/**
+ * Build the adapter map from a ToolContext vendors object.
+ * Each adapter wraps the corresponding vendor client (or null if disabled).
+ */
+export declare function createAdapters(vendors: {
+    lcsc: LcscClient | null;
+    mouser: MouserClient | null;
+    digikey: DigiKeyClient | null;
+}): AdapterMap;
+/**
+ * Return the subset of adapters that are currently configured / available.
+ */
+export declare function availableAdapters(adapters: AdapterMap): SupplierAdapter[];

package/dist/bom-quality/adapter.js

@@ -0,0 +1,295 @@
+/**
+ * BOM quality — supplier adapter layer.
+ *
+ * Provides a common {@link SupplierAdapter} interface over each vendor
+ * client so quality checks can query any configured supplier uniformly.
+ *
+ * Each adapter:
+ *  - normalises part data into {@link SupplierQueryResult}
+ *  - records a query timestamp for provenance
+ *  - wraps transient errors with an exponential-backoff retry
+ *
+ * @module
+ */
+import { EasyEdaMcpError } from '../schemas/common.js';
+import { getLogger } from '../utils/logger.js';
+// ── Retry helper ───────────────────────────────────────────────────────────
+const RETRY_BASE_MS = 200;
+const RETRY_MAX_MS = 2_000;
+const RETRY_ATTEMPTS = 2;
+async function withRetry(label, fn, logger, attempts = RETRY_ATTEMPTS) {
+    let lastError;
+    for (let i = 0; i <= attempts; i++) {
+        try {
+            return await fn(i);
+        }
+        catch (err) {
+            lastError = err;
+            // Only retry on retryable errors (rate limits, 5xx)
+            const retryable = err instanceof EasyEdaMcpError ? err.retryable === true : true; // unknown errors are not retried
+            if (!retryable || i === attempts) {
+                throw err;
+            }
+            const delay = Math.min(RETRY_BASE_MS * 2 ** i, RETRY_MAX_MS);
+            logger.debug({ delay, attempt: i + 1, label }, 'retrying supplier query');
+            await new Promise((r) => setTimeout(r, delay));
+        }
+    }
+    throw lastError;
+}
+function toLifecycle(raw) {
+    if (typeof raw === 'boolean')
+        return raw ? 'discontinued' : 'active';
+    if (typeof raw === 'string') {
+        const lc = raw.toLowerCase();
+        if (lc === 'active' || lc === 'production')
+            return 'active';
+        if (lc.includes('discon') || lc.includes('obsolete') || lc === 'eol')
+            return 'discontinued';
+    }
+    return 'unknown';
+}
+// ── LCSC adapter ───────────────────────────────────────────────────────────
+export class LcscAdapter {
+    kind = 'lcsc';
+    displayName = 'LCSC';
+    client;
+    logger;
+    constructor(client) {
+        this.client = client;
+        this.logger = getLogger();
+    }
+    isAvailable() {
+        return this.client !== null;
+    }
+    buildFoundResult(detail, now) {
+        const unitPrice = detail.priceBreaks?.[0]?.unitPrice ??
+            (typeof detail.price === 'number'
+                ? detail.price
+                : typeof detail.price === 'string'
+                    ? parseFloat(detail.price)
+                    : undefined);
+        return {
+            supplier: 'lcsc',
+            found: true,
+            lcsc: detail.lcsc,
+            mpn: detail.manufacturer || undefined,
+            manufacturer: detail.manufacturer || undefined,
+            description: detail.description || undefined,
+            lifecycle: detail.discontinued ? 'discontinued' : 'active',
+            stock: detail.stockCount ?? detail.stock ?? 0,
+            unitPrice,
+            currency: 'USD',
+            leadTimeDays: detail.leadTime,
+            queriedAt: now,
+            confidence: 'high',
+        };
+    }
+    async queryPart(identifier) {
+        const client = this.client;
+        if (!client)
+            return null;
+        if (!identifier.lcsc && !identifier.mpn)
+            return null;
+        const lcscCode = identifier.lcsc;
+        if (!lcscCode)
+            return null; // LCSC requires an LCSC code
+        const now = new Date().toISOString();
+        try {
+            const detail = await withRetry(`lcsc.getPartDetail(${lcscCode})`, () => client.getPartDetail(lcscCode), this.logger);
+            if (!detail) {
+                return {
+                    supplier: 'lcsc',
+                    found: false,
+                    lifecycle: 'unknown',
+                    stock: 0,
+                    queriedAt: now,
+                    confidence: 'medium',
+                };
+            }
+            return this.buildFoundResult(detail, now);
+        }
+        catch (err) {
+            this.logger.warn({ err, lcscCode }, 'lcsc adapter query failed');
+            // Return an "unavailable" result rather than throwing
+            return {
+                supplier: 'lcsc',
+                found: false,
+                lifecycle: 'unknown',
+                stock: 0,
+                queriedAt: now,
+                confidence: 'low',
+            };
+        }
+    }
+}
+// ── Mouser adapter ─────────────────────────────────────────────────────────
+export class MouserAdapter {
+    kind = 'mouser';
+    displayName = 'Mouser';
+    client;
+    logger;
+    constructor(client) {
+        this.client = client;
+        this.logger = getLogger();
+    }
+    isAvailable() {
+        return this.client !== null;
+    }
+    buildFoundResult(part, now) {
+        return {
+            supplier: 'mouser',
+            found: true,
+            mpn: part.manufacturer || undefined,
+            manufacturer: part.manufacturer || undefined,
+            description: part.description || undefined,
+            lifecycle: 'active',
+            stock: part.availability ?? 0,
+            unitPrice: part.priceBreaks?.[0]?.price,
+            currency: 'USD',
+            leadTimeDays: part.leadTime ? parseInt(part.leadTime, 10) || undefined : undefined,
+            queriedAt: now,
+            confidence: 'high',
+        };
+    }
+    async queryPart(identifier) {
+        const client = this.client;
+        if (!client)
+            return null;
+        const mpn = identifier.mpn;
+        if (!mpn)
+            return null; // Mouser requires an MPN
+        const now = new Date().toISOString();
+        try {
+            const results = await withRetry(`mouser.searchByPartNumber(${mpn})`, () => client.searchByPartNumber(mpn), this.logger);
+            if (!results || results.length === 0) {
+                return {
+                    supplier: 'mouser',
+                    found: false,
+                    lifecycle: 'unknown',
+                    stock: 0,
+                    queriedAt: now,
+                    confidence: 'medium',
+                };
+            }
+            const part = results[0];
+            if (!part) {
+                return {
+                    supplier: 'mouser',
+                    found: false,
+                    lifecycle: 'unknown',
+                    stock: 0,
+                    queriedAt: now,
+                    confidence: 'medium',
+                };
+            }
+            return this.buildFoundResult(part, now);
+        }
+        catch (err) {
+            this.logger.warn({ err, mpn }, 'mouser adapter query failed');
+            return {
+                supplier: 'mouser',
+                found: false,
+                lifecycle: 'unknown',
+                stock: 0,
+                queriedAt: now,
+                confidence: 'low',
+            };
+        }
+    }
+}
+// ── DigiKey adapter ────────────────────────────────────────────────────────
+export class DigiKeyAdapter {
+    kind = 'digikey';
+    displayName = 'DigiKey';
+    client;
+    logger;
+    constructor(client) {
+        this.client = client;
+        this.logger = getLogger();
+    }
+    isAvailable() {
+        return this.client !== null;
+    }
+    buildFoundResult(part, mpn, now) {
+        return {
+            supplier: 'digikey',
+            found: true,
+            mpn: part.manufacturerPartNumber || undefined,
+            manufacturer: part.manufacturer || undefined,
+            description: part.description || undefined,
+            lifecycle: toLifecycle(part.rohsStatus), // RoHS active is a loose proxy
+            stock: part.quantityAvailable ?? 0,
+            unitPrice: part.unitPrice || undefined,
+            currency: 'USD',
+            queriedAt: now,
+            confidence: part.manufacturerPartNumber?.toLowerCase() === mpn.toLowerCase() ? 'high' : 'medium',
+        };
+    }
+    async queryPart(identifier) {
+        const client = this.client;
+        if (!client)
+            return null;
+        const mpn = identifier.mpn;
+        if (!mpn)
+            return null; // DigiKey requires MPN or keyword
+        const now = new Date().toISOString();
+        try {
+            // Use keyword search as a proxy — DigiKey doesn't expose a
+            // direct MPN-lookup endpoint in the current client.
+            const results = await withRetry(`digikey.searchByKeyword(${mpn})`, () => client.searchByKeyword(mpn), this.logger);
+            if (!results || results.length === 0) {
+                return {
+                    supplier: 'digikey',
+                    found: false,
+                    lifecycle: 'unknown',
+                    stock: 0,
+                    queriedAt: now,
+                    confidence: 'medium',
+                };
+            }
+            // Take the first result — keyword search returns best match first
+            const part = results[0];
+            if (!part) {
+                return {
+                    supplier: 'digikey',
+                    found: false,
+                    lifecycle: 'unknown',
+                    stock: 0,
+                    queriedAt: now,
+                    confidence: 'medium',
+                };
+            }
+            return this.buildFoundResult(part, mpn, now);
+        }
+        catch (err) {
+            this.logger.warn({ err, mpn }, 'digikey adapter query failed');
+            return {
+                supplier: 'digikey',
+                found: false,
+                lifecycle: 'unknown',
+                stock: 0,
+                queriedAt: now,
+                confidence: 'low',
+            };
+        }
+    }
+}
+/**
+ * Build the adapter map from a ToolContext vendors object.
+ * Each adapter wraps the corresponding vendor client (or null if disabled).
+ */
+export function createAdapters(vendors) {
+    return {
+        lcsc: new LcscAdapter(vendors.lcsc),
+        mouser: new MouserAdapter(vendors.mouser),
+        digikey: new DigiKeyAdapter(vendors.digikey),
+    };
+}
+/**
+ * Return the subset of adapters that are currently configured / available.
+ */
+export function availableAdapters(adapters) {
+    return Object.values(adapters).filter((a) => a.isAvailable());
+}
+//# sourceMappingURL=adapter.js.map

package/dist/bom-quality/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/bom-quality/adapter.ts"],"names":[],"mappings":"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"}

package/dist/bom-quality/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * BOM quality — public API barrel.
+ *
+ * @module
+ */
+export type { SupplierKind, PartLifecycle, BomEntry, SupplierQueryResult, BomQualityIssueType, BomQualityIssue, BomQualityReport, BomQualityConfig, } from './types.js';
+export { DEFAULT_BOM_QUALITY_CONFIG } from './types.js';
+export type { SupplierAdapter, AdapterMap } from './adapter.js';
+export { LcscAdapter, MouserAdapter, DigiKeyAdapter, createAdapters, availableAdapters, } from './adapter.js';
+export { generateBomQualityReport } from './quality.js';

package/dist/bom-quality/index.js

@@ -0,0 +1,9 @@
+/**
+ * BOM quality — public API barrel.
+ *
+ * @module
+ */
+export { DEFAULT_BOM_QUALITY_CONFIG } from './types.js';
+export { LcscAdapter, MouserAdapter, DigiKeyAdapter, createAdapters, availableAdapters, } from './adapter.js';
+export { generateBomQualityReport } from './quality.js';
+//# sourceMappingURL=index.js.map

package/dist/bom-quality/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bom-quality/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC"}

package/dist/bom-quality/quality.d.ts

@@ -0,0 +1,28 @@
+/**
+ * BOM quality — report generation.
+ *
+ * Analyses BOM entries against supplier data to surface issues:
+ *  1. **Unavailable** — part not found or discontinued at any supplier.
+ *  2. **Single-source** — part found at exactly one supplier.
+ *  3. **Missing MPN** — no manufacturer part number.
+ *  4. **Missing footprint** — no package / footprint.
+ *  5. **Low stock** — stock below threshold at every supplier.
+ *
+ * @module
+ */
+import type { BomEntry, BomQualityReport, BomQualityConfig } from './types.js';
+import type { AdapterMap } from './adapter.js';
+/**
+ * Generate a BOM quality report for the given entries.
+ *
+ * For each entry the function:
+ *  1. Queries every available supplier that can handle the entry.
+ *  2. Collects supplier results (with error resilience).
+ *  3. Runs the five quality checks.
+ *  4. Returns a structured report with a summary.
+ *
+ * Supplier failures are caught gracefully — the report always succeeds
+ * (non-null), with `hasSupplierErrors` set to `true` and any affected
+ * entries marked via their issues.
+ */
+export declare function generateBomQualityReport(bomId: string, entries: BomEntry[], adapters: AdapterMap, config?: BomQualityConfig): Promise<BomQualityReport>;