app
AI Flow: PCBWay
Public Made by Adomby adom
Prepare PCBWay RFQs, preserve manufacturing gates, track complete vendor quotes and compare assembly costs. MIT Rust CLI with Pup workflow skill.
main
Colby Knox
adom-aiflow-pcbway 0.1.3: a guide, never a gate (checks report findings; only could-not-run is an error)
80bd934
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
"""Exercise the CLI evidence checks in an isolated synthetic project (not vendor evidence). A dynamic skill: checks
are findings printed after OK (exit 0); only an input it cannot use is an error."""
import json, pathlib, subprocess, sys, tempfile
binary=str(pathlib.Path(sys.argv[1]).resolve())
with tempfile.TemporaryDirectory() as tmp:
p=pathlib.Path(tmp)
def put(n,v):
f=p/n;f.write_text(json.dumps(v) if isinstance(v,dict) else v);return str(f)
def run(*args,ok=True,finds=None):
r=subprocess.run([binary,'--project',tmp,'--ai-thread','test',*args],capture_output=True,text=True)
assert (r.returncode==0)==ok,(args,r.stdout,r.stderr)
if finds: assert 'FINDINGS' in r.stdout and finds in r.stdout,(args,finds,r.stdout)
return r.stdout
scope={'quantity':5,'assembly':'top','widthMm':72,'heightMm':72,'thicknessMm':1.6,'copperOz':1,'layers':2,'finish':'HASL','target':'test','account':'test','centroidConvention':'native','openChecks':'unapproved','exclusions':['shipping','tax']}
for k,s in [('board','synthetic board'),('gerbers','synthetic archive'),('bom','ref,mpn,manufacturer,value,fit\nR1,ABC,M,1k,\n'),('centroid','Designator,Mid X,Mid Y,Layer,Rotation\nR1,1mm,2mm,Top,0\n')]:scope[k]=put(k,s)
run('init','--scope',put('scope.json',scope));run('export')
run('init','--scope',str(p/'scope.json'),ok=False)
evidence=put('evidence.txt','synthetic vendor evidence, not a real quote')
receipt={'vendorReference':'TEST','submittedAt':'2026-10-20','receiptConfirmed':False,'evidence':evidence}
run('submitted','--receipt',put('receipt.json',receipt),finds='a click is not a receipt');assert 'submit:' in run('next')
receipt['receiptConfirmed']=True;run('submitted','--receipt',put('receipt.json',receipt))
q={'kind':'calculator-only','vendorReference':'TEST','quantity':5,'currency':'USD','checkedAt':'2026-10-20','scopeNote':'test','totalBeforeShippingTax':25,'breakdown':{'assembly':25},'exclusions':['PCB','components'],'includes':{'pcb':False,'assembly':True,'components':False},'evidence':evidence}
run('quote','--facts',put('quote.json',q));assert 'await-quote' in run('next')
baseline=put('baseline.json',{'quantity':5,'currency':'USD','totalBeforeShippingTax':30})
run('compare','--baseline',baseline,finds='not a full quote')
q['kind']='vendor-full';run('quote','--facts',put('quote.json',q),finds='does not say it includes components')
q['includes']={'pcb':True,'components':True,'assembly':True};q['breakdown']={'pcb':5,'components':15,'assembly':5};q['exclusions']=['shipping','tax']
run('quote','--facts',put('quote.json',q));assert 'quote-complete' in run('next');run('compare','--baseline',baseline)
pathlib.Path(evidence).write_text('changed');assert 'submit:' in run('next');run('compare','--baseline',baseline,finds='the quote is stale')
(p/'pcbway-flow/upload/BOM-PRICING-ONLY.csv').write_text('changed');assert 'export:' in run('next')
pathlib.Path(scope['board']).write_text('changed');run('next',finds='changed since init')
# AI Flow's own export files (grouped references, kicad-cli centroid) work as they are
with tempfile.TemporaryDirectory() as t2:
q2=pathlib.Path(t2)
s2=dict(scope)
s2['bom']=str(q2/'b.csv');(q2/'b.csv').write_text('Reference,Qty,Value,Footprint,Manufacturer,MPN,DNP\nC1 C2,2,1u,C_0603,Murata,GRM188,\nMP1,1,pin,Pin,,,DNP\n')
s2['centroid']=str(q2/'c.csv');(q2/'c.csv').write_text('Ref,Val,Package,PosX,PosY,Rot,Side\nC1,1u,C_0603,1,2,90,top\nC2,1u,C_0603,3,4,0,bottom\n')
for k in ['board','gerbers']: s2[k]=scope[k]
(q2/'s.json').write_text(json.dumps(s2))
r=subprocess.run([binary,'--project',t2,'--ai-thread','test','init','--scope',str(q2/'s.json')],capture_output=True,text=True);assert r.returncode==0,r.stdout+r.stderr
r=subprocess.run([binary,'--project',t2,'--ai-thread','test','export'],capture_output=True,text=True);assert r.returncode==0 and 'FINDINGS' not in r.stdout,r.stdout+r.stderr
cen=(q2/'pcbway-flow/upload/CENTROID-UNAPPROVED.csv').read_text();assert 'C2,3,4,Bottom,0' in cen,cen
print('PASS: partial totals, missing inclusion, stale evidence, stale exports, changed inputs and vendor receipt reported as findings; duplicate init is an error')
# Display selection is exercised through stub tools, without opening user windows.
with tempfile.TemporaryDirectory() as tmp:
import os
root=pathlib.Path(tmp);project=root/'project';project.mkdir();binpath=root/'bin';binpath.mkdir()
state={'schema':'adom/pcbway-flow@1','scope':{'account':'[email protected]'},'inputs':{}}
flow=project/'pcbway-flow';flow.mkdir();(flow/'state.json').write_text(json.dumps(state))
for name in ['adom-cli','adom-bridge']:
f=binpath/name;f.write_text('#!/usr/bin/env python3\nimport json,sys\nprint(json.dumps({"ok":True,"args":sys.argv[1:]}))\n');f.chmod(0o755)
env={**os.environ,'PATH':str(binpath)+os.pathsep+os.environ['PATH']}
base=[binary,'--project',str(project),'--ai-thread','test']
r=subprocess.run(base+['show'],env=env,capture_output=True,text=True);assert r.returncode==0 and 'webview' in r.stdout and 'open-or-refresh' in r.stdout
r=subprocess.run(base+['show','--surface','pup'],env=env,capture_output=True,text=True);assert r.returncode!=0
r=subprocess.run(base+['show','--surface','pup','--target','test-desktop'],env=env,capture_output=True,text=True);assert r.returncode==0 and 'test-desktop' in r.stdout
e=root/'evidence.txt';e.write_text('Synthetic account status')
r=subprocess.run(base+['account','--email','[email protected]','--status','signed-in','--evidence',str(e)],capture_output=True,text=True);assert r.returncode==0 and 'is not the one the scope names' in r.stdout
r=subprocess.run(base+['account','--email','[email protected]','--status','captcha-required','--evidence',str(e)],capture_output=True);assert r.returncode==0
print('PASS: default webview, explicit Pup target, account identity finding and pending account tracking')