AI Flow

@@ -14,7 +14,7 @@ members = [ ]  [workspace.package]-version = "0.1.28"+version = "0.1.29" edition = "2021" license = "MIT" repository = "https://wiki.adom.inc/adom/adom-aiflow"

@@ -175,3 +175,5 @@ A pour's area or presence is not proof of current capacity or acceptable tempera Placement checks compare individual native DRC findings with the baseline, not just their counts. Conservative courtyard bounding boxes guide packing but do not override native courtyard checks. Project `.kicad_pro` and `.kicad_dru` constraints follow board snapshots. When present, they require a native `kicad-cli` (optionally set `ADOM_AIFLOW_KICAD_CLI`); the single-file headless service must not silently discard them. Manufacturing-rule warnings, including hole spacing, remain blocking.  Latest maintenance: [0.1.28 lifecycle and native IPC readiness](docs/release-0.1.28.md).++[0.1.29: reliable component tours and explicit zone ownership](docs/release-0.1.29.md).

⋯ 1 unchanged line ⋯

@@ -1941,8 +1941,27 @@ fn main() {                     let zones = aiflow_pours::resolve_outline(&b, read_json(&zp)["zones"].as_array().unwrap_or(&Vec::new()));                     r.stage_start("land-pours", Some("binary"), None);                     let before = br.zone_state(&rb, true);-                    let inherited = inherited_zone_ids(&r);-                    let results = br.land_zones(&rb, &zones, *pause_ms, &inherited);+                    let mut owned: Vec<String> = r.data["ownedZoneIds"].as_array().into_iter().flatten().filter_map(|v|v.as_str().map(str::to_string)).collect();+                    // Legacy successful operation replies are evidence of creation, not an inference.+                    if let Some(groups)=r.outcomes().get("land-pours").and_then(|o|o["groups"].as_array()) {+                        for g in groups.iter().filter(|g|g["ok"]==true) {+                            for id in g["itemIds"].as_array().into_iter().flatten().filter_map(Value::as_str) {+                                if !owned.iter().any(|x|x==id) { owned.push(id.to_string()); }+                            }+                        }+                    }+                    let results = br.land_zones(&rb, &zones, *pause_ms, &owned);+                    for (_,reply) in &results {+                        if Bridge::ok(reply) {+                            for id in reply["removedIds"].as_array().into_iter().flatten().filter_map(Value::as_str) { owned.retain(|x|x!=id); }+                        }+                        if Bridge::ok(reply) || reply["mutated"]==true {+                            for id in reply["itemIds"].as_array().into_iter().flatten().filter_map(Value::as_str) {+                                if !owned.iter().any(|x|x==id) { owned.push(id.to_string()); }+                            }+                        }+                    }+                    r.data["ownedZoneIds"]=json!(owned);                     if let Some((_, rep)) = results.iter().find(|(n, _)| n == "removed-stale") {                         eprintln!("{}", rep["message"].as_str().unwrap_or(""));                     }

@@ -23,3 +23,5 @@ The review JSON is explicit human/AI review evidence, not an automatic visual-qu Use the same selection manifest accepted by `tools/library-tour.py build`: target `eda`, `mpnMarking` on/off, and each component's `selectedModel` with variant, STEP and GLB paths and hashes. Paths are relative to the containing manifest or absolute. All model hashes are checked. Registration and composition both recheck the board, clip, selection, and native evidence. A pending render review or an old screenshot must not be marked passed. Review the visible native bodies, pin-one indicators, orientation, selected marking/light variants and the tour contact sheet/playback before attesting. If anything changes, redo the affected review and use `--replaces <old clip>` to retain the history without repeating the old overview.  The full tour does not enter the final cut automatically. No static wiki/title cards are added. This does not validate electrical function, footprint dimensions or redistribution rights; those reviews and provenance remain on the reusable global component pages.++Tours use the complete pinned canonical viewer release, served locally with the tour. On a viewer load error, rebuild with `tools/library-tour.py build --manifest <selection.json> --out <tour-dir>` and inspect the explicit error before recording. Native variants and tour selection must agree, including pin-one markers and the chosen LED/MPN state.

@@ -0,0 +1,9 @@+# AI Flow 0.1.29++Component tours use the complete pinned canonical Adom 3D Viewer 0.7.1, including its hashed module chunks, served with the tour. The build fetches that release if it is absent. A failed viewer import is caught and shown instead of leaving the app at Loading. Hydrogen receives a restart recipe for the tour server.++The final ESC library integration was exercised with all 40 marked component selections: selected STEP hashes match actual native board bindings; native render and component-tour contact sheets were reviewed; the short overview registered with hashed review evidence and composed into a four-second clip. The detailed tour stays separate.++Zone ownership is now explicit. Only item IDs returned by successful flow operations may be replaced. Zones introduced by a person or another tool are preserved, even when absent from the original board. A conflicting unowned name refuses with an explanation. Name plus area is no longer treated as equivalent geometry: the conservative fallback replaces explicitly owned zones using the full requested plan, rather than silently skipping a reshaped or reconfigured zone. It is not atomic native reconciliation; removal and creation remain separate native undo operations and a failure must be inspected. Full native reconciliation remains on KiCad Bridge issue 101.++Tests cover foreign-zone preservation, unowned name conflicts, moved equal-area polygons and invalid readback.

@@ -1,7 +1,7 @@ {   "slug": "adom-aiflow",   "type": "app",-  "version": "0.1.28",+  "version": "0.1.29",   "title": "AI Flow",   "description": "Adom's AI Flow: a tool to help the AI follow all of the steps it takes to build a board. One Rust binary with a crate per step (placement helpers, a grid router with Kelvin taps, pours with keepouts, KiCad's DRC gate, live landing through the KiCad Bridge, copper measurement, current and thermal analysis) and a finish line that refuses an unfinished board. Every command answers with hints for the AI; every turn, its thinking time and every rework loop go into run.jsonl, so Claude, Codex and any other engine are compared on the same flow. KiCad today; Altium, Fusion and Adom's own web apps next.",   "summary": "Adom's AI Flow: a tool to help the AI follow all of the steps it takes to build a board. The AI thinks its way from placement through routing, pours, current and thermal analysis to a delivered video; the binary does the fast, deterministic parts of every step, hands back hints, and keeps a ledger of every turn, every return to an earlier step, and the clock from the prompt to done.",

@@ -1,7 +1,7 @@ {   "slug": "adom-aiflow",   "type": "app",-  "version": "0.1.28",+  "version": "0.1.29",   "title": "AI Flow",   "description": "Adom's AI Flow: a tool to help the AI follow all of the steps it takes to build a board. One Rust binary with a crate per step (placement helpers, a grid router with Kelvin taps, pours with keepouts, KiCad's DRC gate, live landing through the KiCad Bridge, copper measurement, current and thermal analysis) and a finish line that refuses an unfinished board. Every command answers with hints for the AI; every turn, its thinking time and every rework loop go into run.jsonl, so Claude, Codex and any other engine are compared on the same flow. KiCad today; Altium, Fusion and Adom's own web apps next.",   "summary": "Adom's AI Flow: a tool to help the AI follow all of the steps it takes to build a board. The AI thinks its way from placement through routing, pours, current and thermal analysis to a delivered video; the binary does the fast, deterministic parts of every step, hands back hints, and keeps a ledger of every turn, every return to an earlier step, and the clock from the prompt to done.",@@ -86,4 +86,4 @@     "name": "John Lauer",     "email": "[email protected]"   }-}\ No newline at end of file+}

@@ -162,3 +162,7 @@ Component library footage: keep the full `library-tour` separate. A reviewed fiv ## Native editor readiness  `capture open` must confirm native IPC for the exact board, not only a visible window. KiCad may give its single IPC server to the first editor. On `board_mismatch`, read `capture-open-ipc.json` or `place-land-log.json`, save and gracefully close only your task-owned conflicting editors, and reopen the intended board first. Never close another user's work or restart a shared bridge. Permanent identity refusals are not retryable. Reject a static failed take and record the reason before re-taking it.++Tours use the complete pinned canonical viewer release, served locally with the tour. On a viewer load error, rebuild with `tools/library-tour.py build --manifest <selection.json> --out <tour-dir>` and inspect the explicit error before recording. Native variants and tour selection must agree, including pin-one markers and the chosen LED/MPN state.++Zone ownership comes only from successful native creation item IDs recorded by this run. Never infer ownership because a zone was absent from intake, has a familiar name, or has the same area. Preserve unowned zones and resolve name conflicts explicitly. Current fallback replaces owned zones using separate remove/create operations; inspect a partial failure before resuming.

@@ -0,0 +1,10 @@+#!/bin/bash+# Fetch the complete pinned canonical viewer, including its hashed module chunks.+set -euo pipefail+root="$(cd "$(dirname "$0")/.." && pwd)"+version=0.7.1+tmp="$(mktemp -d)"+trap 'rm -rf "$tmp"' EXIT+(cd "$tmp" && adom-wiki release download adom/adom-3d-viewer "$version")+mkdir -p "$root/vendor/3d-viewer"+tar -xzf "$tmp/adom-3d-viewer-babylon9-$version.tar.gz" -C "$root/vendor/3d-viewer"

@@ -1,11 +1,13 @@ <!doctype html><meta charset="utf-8"><title>Component library tour</title>-<link rel="stylesheet" href="https://wiki.adom.inc/static/vendor/adom-3d-viewer-babylon9/style.css">+<link rel="stylesheet" href="vendor/3d-viewer/style.css"> <style>body{margin:0;background:#151b23;color:#e9eff8;font:15px system-ui}header{padding:14px 20px;display:flex;gap:15px;align-items:center}button,select,a{background:#263647;color:#dcefff;border:1px solid #4e647d;border-radius:5px;padding:8px;text-decoration:none}#stage{width:100%;aspect-ratio:16/9;position:relative;max-height:85vh}#status{color:#b6c5d7}#error{color:#ffb09a;padding:10px}#viewer{position:absolute;inset:0}canvas{outline:none}small{padding:0 20px;display:block;color:#b6c5d7}</style> <header><b>Component library</b><button id="overview">All components</button><button id="detail">Record full tour</button><button id="short">Record 5s overview</button><select id="pick"></select><a id="wiki" target="_blank">Component wiki</a><span id="status">Loading…</span></header><small id="policy"></small><div id="stage"><div id="viewer"></div></div><div id="error"></div> <script type="module">-import 'https://wiki.adom.inc/static/vendor/adom-3d-viewer-babylon9/adom-3d-viewer-babylon9.esm.js?v=20260915a';-const B=window.BABYLON,V=window.Adom3DViewerBabylon9;const state=window.libraryTour={ready:false,recording:false,error:null,mode:'overview',completed:[]};const status=document.querySelector('#status');+const state=window.libraryTour={ready:false,recording:false,error:null,mode:'overview',completed:[]};const status=document.querySelector('#status'); try{+ await import('./vendor/3d-viewer/adom-3d-viewer-babylon9.esm.js');+ const B=window.BABYLON,V=window.Adom3DViewerBabylon9;+ if(!B||!V)throw Error('Canonical viewer did not expose its expected API');  const data=await(await fetch('tour.json')).json();state.manifest=data;document.querySelector('#policy').textContent=`${data.components.length} reusable components · MPN marking ${data.mpnMarking} · Preview sizes normalized for inspection; original CAD is unchanged. Detailed tour is separate; the final video uses the 5s overview.`;  const viewer=V.init(document.querySelector('#viewer'),{zUp:true,showGround:false,showViewCube:false});window.tourViewer=viewer;await viewer.loadModel(data.components[0].glb);const scene=viewer.getScene(),engine=viewer.getEngine(),camera=viewer.getCamera();viewer.clearScene();camera.lowerRadiusLimit=.1;camera.upperRadiusLimit=200;camera.minZ=.01;camera.maxZ=500;const groups=[];  for(let i=0;i<data.components.length;i++){

@@ -6,6 +6,10 @@ def digest(path):return hashlib.sha256(path.read_bytes()).hexdigest() if a.action=='build':  if not a.manifest:p.error('--manifest is required for build')  src=json.loads(a.manifest.read_text());assert src.get('eda') in ['kicad','altium','fusion'],'explicit target EDA required';assert src.get('mpnMarking') in ['on','off'],'resolve the marking preference before building the selected library'+ vendor=pathlib.Path(__file__).resolve().parent.parent/'vendor/3d-viewer'+ if not (vendor/'adom-3d-viewer-babylon9.esm.js').exists():+  subprocess.run(['bash',str(pathlib.Path(__file__).with_name('fetch-library-viewer.sh'))],check=True)+ shutil.copytree(vendor,a.out/'vendor/3d-viewer',dirs_exist_ok=True)  rows=src.get('components',[]);assert rows,'empty component library';seen=set();a.out.mkdir(parents=True,exist_ok=True);(a.out/'models').mkdir(exist_ok=True);result=[]  for r in rows:   assert r['mpn'] not in seen,'duplicate component identity';seen.add(r['mpn']);selected=r['selectedModel'];expected='mpn' if src['mpnMarking']=='on' else 'plain';assert selected['variant']==expected,f"{r['mpn']}: tour/board variant mismatch; no silent plain fallback"@@ -26,7 +30,7 @@ elif a.action=='serve':   def log_message(self,*args):pass  print(f'Library tour serving on http://localhost:{a.port}/',flush=True);http.server.ThreadingHTTPServer(('127.0.0.1',a.port),Handler).serve_forever() elif a.action=='record':- control=pathlib.Path.home()/'.adom/hydrogen-control-url';assert control.exists(),'Hydrogen control unavailable; open the tour in Pup and use the recording controls, then verify';base=control.read_text().strip();url=f'http://localhost:{a.port}/';subprocess.run(['adom-cli','hydrogen','webview','open-or-refresh','--name','Component library tour','--url',url],check=True)+ control=pathlib.Path.home()/'.adom/hydrogen-control-url';assert control.exists(),'Hydrogen control unavailable; open the tour in Pup and use the recording controls, then verify';base=control.read_text().strip();url=f'http://localhost:{a.port}/';subprocess.run(['adom-cli','hydrogen','webview','open-or-refresh','--name','Component library tour','--url',url,'--ai-thread',a.ai_thread or 'AI Flow component library','--reason','Review and record the selected native component library','--restart',__import__('shlex').join([sys.executable,__file__,'serve','--out',str(a.out),'--port',str(a.port),'--ai-thread',a.ai_thread or 'AI Flow component library']), '--restart-cwd',str(a.out)],check=True)  def evaluate(js,waitForFrame=False):   q={'target':url,'js':js};r=json.load(urllib.request.urlopen(urllib.request.Request(base+'/eval-in',data=json.dumps(q).encode(),headers={'Content-Type':'application/json'}),timeout=20));   if not r.get('ok') and waitForFrame and 'frame/context not found' in str(r.get('error')):return {'ready':False}