shibosoftwaredev/f1c100s-linux-nema17-stepper-controller

scripts/validate-bom.mjs

import fs from "node:fs"
import crypto from "node:crypto"
import assert from "node:assert/strict"

export function parseCatalogValue(value, unit) {
  if (typeof value !== "string") return null
  const match = value.replaceAll("μ", "u").replaceAll("µ", "u").replaceAll("Ω", "Ω")
    .match(new RegExp(`^([0-9]+(?:\\.[0-9]+)?)\\s*([pnumkKM]?)${unit}$`))
  if (!match) return null
  return Number(match[1]) * ({p:1e-12,n:1e-9,u:1e-6,m:1e-3,k:1e3,K:1e3,M:1e6,"":1}[match[2]])
}

export function validateCatalogPart(source, catalog) {
  const errors = []
  const attributes = catalog.attributes ?? {}
  for (const [field, key, unit] of [["resistance","Resistance","Ω"],["capacitance","Capacitance","F"],["inductance","Inductance","H"]]) {
    if (source[field] === undefined) continue
    const actual = parseCatalogValue(attributes[key], unit)
    if (actual === null || Math.abs(actual-source[field]) > Math.max(1e-15, Math.abs(source[field])*1e-8))
      errors.push(`${key}: design ${source[field]}, catalog ${attributes[key] ?? "unverified"}`)
  }
  if (source.max_voltage_rating !== undefined && source.ftype === "simple_capacitor") {
    const actual = parseCatalogValue(attributes["Voltage Rating"], "V")
    if (actual === null || actual < source.max_voltage_rating)
      errors.push(`Voltage Rating: design ${source.max_voltage_rating}, catalog ${attributes["Voltage Rating"] ?? "unverified"}`)
  }
  if (source.manufacturer_part_number && source.manufacturer_part_number !== catalog.manufacturerPartNumber)
    errors.push(`MPN: design ${source.manufacturer_part_number}, catalog ${catalog.manufacturerPartNumber}`)
  return errors
}

if (import.meta.main) {
  const bytes = fs.readFileSync("dist/index/circuit.json")
  const circuit = JSON.parse(bytes), stock = JSON.parse(fs.readFileSync("reports/jlcpcb-stock-audit.json", "utf8"))
  const sha256 = crypto.createHash("sha256").update(bytes).digest("hex")
  assert.equal(stock.circuitSha256, sha256, "stock report must match actual circuit")
  const components = new Map(circuit.filter(e => e.type === "source_component").map(e => [e.name,e]))
  const findings = []
  let checked = 0
  for (const part of stock.parts) for (const name of part.designators) {
    const source = components.get(name)
    assert.ok(source, `catalog designator ${name} exists`)
    assert.equal(source.supplier_part_numbers?.jlcpcb?.[0], part.code)
    checked++
    const errors = validateCatalogPart(source, part)
    if (errors.length) findings.push({name,code:part.code,errors})
  }
  const rx = ["C_ETH_RXN_AC","C_ETH_RXP_AC"]
  for (const name of rx) {
    const part = stock.parts.find(p => p.designators.includes(name))
    if (part?.package !== "0402") findings.push({name,errors:["RX capacitor requires verified 0402 catalog package"]})
  }
  assert.equal(checked, stock.populatedComponentCount)
  const report = {checkedAt:new Date().toISOString(),circuitSha256:sha256,populatedChecked:checked,
    findings,scope:"All populated catalog codes/declared MPNs; R/C/L nominal values; declared capacitor voltage ratings; RX capacitor package. Other package/pin/polarity verification remains in verify.mjs and mechanical inspection."}
  fs.writeFileSync("reports/bom-validation.json",JSON.stringify(report,null,2)+"\n")
  console.log(JSON.stringify(report,null,2))
  if (findings.length) process.exitCode=1
}