kernelcad-shopcheck

name: kernelcad-shopcheck description: Preflight a sheet-metal flat pattern or planar body against a job-shop's public ordering rules — material catalog, minimum hole / slot / web, bend radius, flange minimums, sheet-stock limits. Vendor identifier and material SKU are required parameters. Use when about to export DXF / STEP for a manufacturing service and you need a conservative, evidence-backed go / no-go before upload.

kernelCAD — shop preflight (DFM check)

Run a flat-pattern or planar body through the configured vendor's published ordering rules. Get a structured findings report with repair hints the agent can paste straight back into authoring tools.

// Preflight a bracket against the configured shop's rules.
await mcp.verify({
  check: 'dfm-preflight',
  file: 'bracket.kcad.ts',
  vendor: 'sendcutsend',
  material: 'aluminum-6061-t6',
  thicknessIn: 0.125,
});
// → { ok: false, findings: [{ code: 'dfm.hole.below-minimum', measured: { ref: '@kc[bracket/face/top/hole/0]' }, repairHint: { action: 'enlarge', params: {...} } }] }

Quick start

• Required inputs: vendor (string SKU), material (string SKU), and thicknessIn or thicknessMm.
• Optional inputs: service (laser / cnc-router / waterjet / bending — inferred when omitted), featureId, dxf (DXF path), refreshCatalog.
• The tool fails closed (dfm.input.*-required) when any of vendor / material / thickness is missing.

API

verify(input: {
  check: 'dfm-preflight';
  file?: string;
  code?: string;
  dxf?: string;
  featureId?: string;
  vendor: string;
  material: string;
  thicknessIn?: number;
  thicknessMm?: number;
  service?: 'laser' | 'cnc-router' | 'waterjet' | 'bending';
  refreshCatalog?: boolean;
}): Promise<{
  ok: boolean;
  findings: Array<{
    code: DiagnosticCode;
    severity: 'info' | 'warn' | 'error';
    hint: string;
    ruleId: string;
    ruleSource: string;
    measured?: { kind, value, unit, location?: [x,y], ref?: '@kc[...]' };
    threshold?: { value, unit };
    repairHint?: { action: 'enlarge' | 'remove' | 'relocate' | 'change-material' | 'change-thickness', params };
  }>;
  diagnostics: CompilerDiagnostic[];
}>;

Vendor support

Vendor identifier is a runtime parameter that selects a data directory under catalogs/vendors/<vendor>/. Slice E ships with one configured vendor. Add a new vendor by dropping catalog.json + specs.json + rules.json into a new catalogs/vendors/<new-vendor>/ directory and refreshing the manifest. No code change required — the engine is data-driven.

Rule sources

Each rule cites its source page or JSON field via ruleSource. The catalog refresh script (npm run shopcheck:refresh) re-pulls the public pages every 24 hours, pins the raw HTML by sha256 under catalogs/vendors/<vendor>/sources-snapshot/, and updates the manifest for drift detection.

Diagnostic codes (24 preflight + 4 print-prep gates)

The dfm.rule.threshold-unknown code collapses to a single warn-level row even when multiple rules return null thresholds for the same material; this avoids redundant noise.

Print-prep gate codes (dfmSpec)

Four further dfm.* codes come from the print-readiness gates a model declares with dfmSpec({...}) — they are emitted by evaluate / build, not by the verify({ check: 'dfm-preflight' }) sheet-metal operations above:

Verification gates

Related skills

• kernelcad-sheet-metal — sheet-metal authoring; verify({ check: 'dfm-preflight' }) reads its flatten_pattern and inspect({ of: 'bend-table' }) outputs.
• kernelcad-mcp — flatten_pattern and inspect({ of: 'bend-table' }) are the upstream tools; verify({ check: 'dfm-preflight' }) is the validation gate.
• kernelcad-features — hole, cutout, shell feed the geometry verify({ check: 'dfm-preflight' }) measures.