devagent-ignition 0.1.0__py3-none-any.whl

devagent_spatial/_resources/assets/three_scene.js

@@ -0,0 +1,442 @@
+/** DevAgent Spatial Operations — R9-inspired light-and-material rendering, concept only.
+ * SPATIAL_LIT_R042: no fake operational state, no live OPC UA, no control writes.
+ * Supports local THREE r180 only. Equipment footprint/topology are customer supplied.
+ */
+import {planVisualAssembly,planSensorMounts,commonFacilityBounds,sorterBranchPoints} from './flow_geometry.mjs';
+import {buildR9Transport} from './r9_transport.mjs';
+export async function startThree(model,host,onSelect){
+ const T=await import('./vendor/three.module.js');
+ if(T.REVISION!=='180')throw new Error('UNVERIFIED_THREE_REVISION');
+ const palettes={
+  r9_cyan:{bg:'#071827',accent:0x58c1dc,edge:0x4b9aab,fill:0x5cbadf},
+  steel_blue:{bg:'#0a1727',accent:0x85c6ff,edge:0x6289be,fill:0x7aaadd},
+  teal:{bg:'#071c23',accent:0x75dfce,edge:0x4da99f,fill:0x69cbb8},
+  warm_amber:{bg:'#191c21',accent:0xf5c77b,edge:0xb69455,fill:0xb8a07a},
+ };
+ const palette=palettes[model.palette]||palettes.r9_cyan;
+ const scene=new T.Scene();scene.background=null;scene.fog=new T.FogExp2(new T.Color(palette.bg),.0068);
+ const camera=new T.PerspectiveCamera(40,1,.1,1400);
+ let az=.88,el=.54,dist=36,target=new T.Vector3(0,1,0);
+ const renderer=new T.WebGLRenderer({antialias:true,alpha:true,powerPreference:'high-performance'});
+ renderer.setClearColor(0x000000,0); // R9 transparency lets stage atmosphere show through
+ renderer.setPixelRatio(Math.min(window.devicePixelRatio||1,1.75));
+ renderer.outputColorSpace=T.SRGBColorSpace;
+ renderer.toneMapping=T.ACESFilmicToneMapping;renderer.toneMappingExposure=1.28;
+ renderer.shadowMap.enabled=true;renderer.shadowMap.type=T.PCFSoftShadowMap;
+ host.append(renderer.domElement);renderer.domElement.style.cursor='grab';
+ scene.add(new T.HemisphereLight(0xc6eaff,0x182733,2.12));
+ scene.add(new T.AmbientLight(0x3a718d,.26));
+ const key=new T.DirectionalLight(0xd9f5ff,2.80);key.position.set(-20,32,23);key.castShadow=true;
+ key.shadow.mapSize.set(2048,2048);key.shadow.bias=-0.00012;key.shadow.normalBias=.016;
+ key.shadow.camera.near=.5;key.shadow.camera.far=260;key.shadow.camera.left=-85;key.shadow.camera.right=85;
+ key.shadow.camera.top=85;key.shadow.camera.bottom=-85;key.shadow.radius=3;
+ scene.add(key);scene.add(key.target);
+ const fill=new T.DirectionalLight(palette.fill,1.30);fill.position.set(18,14,-18);scene.add(fill);
+ const rim=new T.DirectionalLight(0x3cc0c0,1.05);rim.position.set(-10,10,-22);scene.add(rim);
+ const warm=new T.PointLight(0xf1d294,28,65);warm.position.set(7,18,-7);scene.add(warm); // R9 key light; decorative only
+ // Conceptual industrial materials, not operating-status colors.
+ const col={conveyor:0x467e94,spiral:0x4c92a5,sorter:0x4a91a3,motor:0x6a879d,vfd:0x53748e,photoeye:0x43b7ad,scanner:0xbdaa6f,tank:0x668c9e,pump:0x6e91ab,valve:0xcaa86a,robot:0x82acb7,junction:0x467e94,room:0x365e78,other:0x628ca0};
+ const mats={
+  frame:new T.MeshStandardMaterial({color:0x627e8d,metalness:.63,roughness:.41}),
+  trim:new T.MeshStandardMaterial({color:0xa5c1ca,metalness:.68,roughness:.32}),
+  deck:new T.MeshStandardMaterial({color:0x253f50,metalness:.42,roughness:.59}),
+  belt:new T.MeshStandardMaterial({color:0x223c4b,metalness:.16,roughness:.76}),
+  roller:new T.MeshStandardMaterial({color:0x759eb0,metalness:.67,roughness:.31}),
+  dark:new T.MeshStandardMaterial({color:0x1a3547,metalness:.38,roughness:.66}),
+  cyan:new T.MeshStandardMaterial({color:palette.accent,metalness:.35,roughness:.45,emissive:0x0d3241,emissiveIntensity:.32}),
+  highlight:new T.MeshStandardMaterial({color:0xd6b66e,metalness:.54,roughness:.42}),
+ };
+ const mat=(c,metal=.48,rough=.48,opacity=1)=>new T.MeshStandardMaterial({color:c,metalness:metal,roughness:rough,transparent:opacity<1,opacity,side:T.DoubleSide});
+ const assets=new Map(),pickables=[],floors=new Map();
+ const boxGeometry=new T.BoxGeometry(1,1,1);
+ function box(g,x,y,z,dx,dy,dz,m){const o=new T.Mesh(boxGeometry,m);o.position.set(x,y,z);o.scale.set(Math.max(.03,dx),Math.max(.03,dy),Math.max(.03,dz));o.castShadow=true;o.receiveShadow=true;g.add(o);return o;}
+ function cylinder(g,x,y,z,rad,height,m,segments=20){const o=new T.Mesh(new T.CylinderGeometry(rad,rad,height,segments),m);o.position.set(x,y,z);o.castShadow=true;o.receiveShadow=true;g.add(o);return o;}
+ function rail(g,sx,y,z){box(g,0,y,z,sx,.12,.10,mats.trim);box(g,0,y+.12,z,sx,.065,.08,mats.frame);}
+ function label(text){const cv=document.createElement('canvas');cv.width=384;cv.height=90;const ctx=cv.getContext('2d');ctx.fillStyle='rgba(7,24,37,.94)';ctx.fillRect(2,4,380,82);ctx.strokeStyle='#7494a4';ctx.lineWidth=2;ctx.strokeRect(2,4,380,82);ctx.fillStyle='#e1f7ff';ctx.font='bold 37px system-ui';ctx.textAlign='center';ctx.textBaseline='middle';ctx.fillText(text.slice(0,20),192,46);const tex=new T.CanvasTexture(cv);tex.colorSpace=T.SRGBColorSpace;const sprite=new T.Sprite(new T.SpriteMaterial({map:tex,transparent:true,depthWrite:false}));sprite.scale.set(3.0,.72,1);return sprite;}
+ function line(a,b,color=palette.edge){const geom=new T.BufferGeometry().setFromPoints([a,b]);const obj=new T.Line(geom,new T.LineDashedMaterial({color,dashSize:.26,gapSize:.16,opacity:.74,transparent:true}));obj.computeLineDistances();return obj;}
+ const floorNs=[...new Set(model.equipment.map(e=>e.floor))].sort((a,b)=>a-b);
+ const facility=commonFacilityBounds(model);
+ const assembly=planVisualAssembly(model);
+ const plannedRoutes=assembly.routes;
+ const sensorMounts=planSensorMounts(model,assembly);
+ const allBox=new T.Box3();
+ for(const e of model.equipment){const {x,y,z}=e.position;const d=e.dimensions||{x:2,y:1,z:1};const half=new T.Vector3(Math.max(.4,d.x/2),Math.max(.5,d.y/2)+.8,Math.max(.4,d.z/2));const p=new T.Vector3(x,y+d.y*.5,z);allBox.expandByPoint(p.clone().sub(half));allBox.expandByPoint(p.clone().add(half));}
+ // Subtle contact occlusion under conceptual equipment anchors. These are visual
+ // grounding cues only: no collision, load-bearing or as-built claim.
+ const shadowCanvas=document.createElement('canvas');shadowCanvas.width=128;shadowCanvas.height=128;
+ const sx=shadowCanvas.getContext('2d'),gradient=sx.createRadialGradient(64,64,4,64,64,62);
+ gradient.addColorStop(0,'rgba(0,7,15,.74)');gradient.addColorStop(.48,'rgba(0,10,18,.38)');gradient.addColorStop(1,'rgba(0,10,18,0)');
+ sx.fillStyle=gradient;sx.fillRect(0,0,128,128);
+ const contactTexture=new T.CanvasTexture(shadowCanvas);
+ const contactMat=new T.MeshBasicMaterial({map:contactTexture,transparent:true,opacity:.54,depthWrite:false,side:T.DoubleSide,polygonOffset:true,polygonOffsetFactor:-2});
+ const extent=allBox.getSize(new T.Vector3());const shadowExtent=Math.min(125,Math.max(22,extent.x,extent.z)*.85+9);
+ key.shadow.camera.left=-shadowExtent;key.shadow.camera.right=shadowExtent;key.shadow.camera.top=shadowExtent;key.shadow.camera.bottom=-shadowExtent;
+ key.position.copy(allBox.getCenter(new T.Vector3())).add(new T.Vector3(-22,35,23));key.target.position.copy(allBox.getCenter(new T.Vector3()));key.shadow.camera.updateProjectionMatrix();
+ for(const f of floorNs){
+  const g=new T.Group();g.userData.floor=f;floors.set(f,g);scene.add(g);
+  const arr=model.equipment.filter(e=>e.floor===f);
+  // One common facility footprint for all levels: separate operating floors,
+  // NOT three unrelated panels floating at different X/Z positions.
+  // Architectural envelope is shared, but each working deck is fitted to its
+  // actual equipment and spiral landing footprint, like R9's individual levels.
+  const minX=Math.min(...arr.map(e=>e.position.x-e.dimensions.x/2))-3.0;
+  const maxX=Math.max(...arr.map(e=>e.position.x+e.dimensions.x/2))+3.0;
+  const minZ=Math.min(...arr.map(e=>e.position.z-e.dimensions.z/2))-3.0;
+  const maxZ=Math.max(...arr.map(e=>e.position.z+e.dimensions.z/2))+3.0;
+  const w=maxX-minX,d=maxZ-minZ,centerX=(minX+maxX)/2,centerZ=(minZ+maxZ)/2;
+  const floorY=Math.min(...arr.map(e=>e.position.y))-.57;
+  const surf=new T.Mesh(new T.BoxGeometry(w,.16,d),
+   mat(f===floorNs[0]?0x19435b:0x2a6577,.46,.68,floorNs.length>1?.38:1));
+  surf.material.depthWrite=false;
+  surf.position.set(centerX,floorY-.08,centerZ);surf.receiveShadow=true;g.add(surf);
+  const outline=[new T.Vector3(minX,floorY+.02,minZ),new T.Vector3(maxX,floorY+.02,minZ),new T.Vector3(maxX,floorY+.02,maxZ),new T.Vector3(minX,floorY+.02,maxZ),new T.Vector3(minX,floorY+.02,minZ)];
+  const border=new T.Line(new T.BufferGeometry().setFromPoints(outline),new T.LineBasicMaterial({color:palette.edge,opacity:.42,transparent:true,depthWrite:false}));g.add(border);
+  const gridPts=[],step=Math.max(1.4,Math.min(2.2,Math.max(w,d)/24));
+  for(let x=minX;x<=maxX;x+=step)gridPts.push(new T.Vector3(x,floorY+.025,minZ),new T.Vector3(x,floorY+.025,maxZ));
+  for(let z=minZ;z<=maxZ;z+=step)gridPts.push(new T.Vector3(minX,floorY+.025,z),new T.Vector3(maxX,floorY+.025,z));
+  g.add(new T.LineSegments(new T.BufferGeometry().setFromPoints(gridPts),
+    new T.LineBasicMaterial({color:0x3e8493,opacity:.28,transparent:true,depthWrite:false})));
+  for(const e of arr){
+   const size=Math.max(1.4,e.dimensions.x*1.6),depth=Math.max(1.3,e.dimensions.z*2.1);
+   const patch=new T.Mesh(new T.PlaneGeometry(size,depth),contactMat);
+   patch.rotation.x=-Math.PI/2;patch.position.set(e.position.x,floorY+.043,e.position.z);
+   patch.renderOrder=1;g.add(patch);
+  }
+  g.userData.deckBounds={minX,maxX,minZ,maxZ,floorY};
+
+  // Subtle static architectural fill lights. They do not indicate machine RUN/FAULT state.
+  {const light=new T.PointLight(palette.accent,.36,Math.max(w,d)*1.35,2);light.position.set(centerX,floorY+8,centerZ);g.add(light);}
+ }
+ // One unified (but recessive) building envelope; no glowing wireframe cage.
+ if(facility && floorNs.length>1){
+  const ys=floorNs.map(f=>Math.min(...model.equipment.filter(e=>e.floor===f).map(e=>e.position.y))-.57);
+  const minY=Math.min(...ys),topY=Math.max(...ys)+3.0;
+  const steel=mat(0x476b79,.76,.51,.20);
+  for(const x of [facility.minX,facility.maxX])for(const z of [facility.minZ,facility.maxZ]){
+   box(scene,x,(minY+topY)/2,z,.12,topY-minY,.12,steel);
+  }
+ }
+ function conveyor(g,sx,sy,sz,base,station,sorter=false){
+  // Flow-normalize orientation from the customer graph; reverse-running upper
+  // conveyors must NOT all face the +X direction.
+  const bed=new T.Group();bed.rotation.y=-Math.atan2(station.direction.z,station.direction.x);g.add(bed);
+  const frameY=1.1,length=station.length,width=Math.max(.55,sz*.79);
+  const curve=new T.LineCurve3(new T.Vector3(-length/2,frameY,0),new T.Vector3(length/2,frameY,0));
+  buildR9Transport(T,bed,curve,{width,materials:{frame:mats.frame,belt:mats.belt,rail:mats.trim,roller:mats.roller},conceptual:true});
+  // Structural bents, drive housing, longitudinal girders and wear panels.
+  for(const x of [-length*.37,length*.37])for(const z of [-sz*.38,sz*.38]){
+   box(bed,x,frameY*.50,z,.085,frameY,.085,mats.frame);
+   box(bed,x,.08,z,.26,.14,.24,mats.dark);
+  }
+  for(const z of [-sz*.5,sz*.5])box(bed,0,frameY-.30,z,length,.12,.10,mats.frame);
+  box(bed,-length*.27,frameY-.40,sz*.36,.55,.42,.33,mats.dark); // concept-only drive casing
+  if(sorter){
+   box(bed,0,frameY-.25,0,length*.48,.15,sz*.85,mats.trim);
+   for(const br of station.branches){
+    const pts=sorterBranchPoints(station,br.to);
+    if(!pts)continue;
+    const route=new T.CatmullRomCurve3(pts.map(p=>new T.Vector3(p.x-g.position.x,p.y-g.position.y,p.z-g.position.z)),false,'centripetal',.34);
+    if(route.getLength()>.15){
+     buildR9Transport(T,g,route,{width:Math.min(.76,width*.79),
+      materials:{frame:mats.frame,belt:mats.belt,rail:mats.trim,roller:mats.roller},conceptual:true,rollers:true});
+    }
+   }
+  }
+ }
+ for(const e of model.equipment){
+  const g=new T.Group();g.userData.asset=e.id;
+  const visualMount=sensorMounts[e.id];
+  g.position.set(visualMount?.position.x??e.position.x,e.position.y,visualMount?.position.z??e.position.z);
+  if(visualMount)g.rotation.y=-Math.atan2(visualMount.direction.z,visualMount.direction.x);
+  const {x:sx,y:sy,z:sz}=e.dimensions,kind=e.kind,base=col[kind]||col.other;
+  const station=assembly.stations[e.id];
+  if(kind==='conveyor'||kind==='sorter'||kind==='junction')conveyor(g,sx,sy,sz,base,station,kind==='sorter');
+  else if(kind==='spiral'){
+   const helixPts=station.helix.map(p=>new T.Vector3(p.x-e.position.x,p.y-e.position.y,p.z-e.position.z));
+   const height=station.exitY-station.baseY;
+   // R9 centerline ribbon shares EXACT ports with incoming/outgoing conveyor routes.
+   cylinder(g,0,1.1+height/2,0,.14,Math.max(.3,Math.abs(height)),mats.frame);
+   for(let a=0;a<4;a++){const t=a*Math.PI/2;box(g,Math.sin(t)*station.radius*.78,1.1+height/2,Math.cos(t)*station.radius*.78,.10,Math.max(.3,Math.abs(height)),.10,mats.frame);}
+   const helix=new T.CatmullRomCurve3(helixPts,false,'centripetal',.34);
+   buildR9Transport(T,g,helix,{width:.84,materials:{frame:mats.frame,belt:mats.belt,rail:mats.trim,roller:mats.roller},conceptual:true,rollers:false});
+   for(const pt of [helixPts[0],helixPts.at(-1)]){
+    const landing=box(g,pt.x,pt.y-.17,pt.z,.93,.14,.88,mats.frame);
+    landing.rotation.y=Math.atan2(pt.z,pt.x);
+   }
+  } else if(kind==='photoeye'){
+   // Two-post optical gate, read-only and not asserted as-installed.
+   for(const side of [-1,1])box(g,0,.61,side*.63,.085,1.22,.09,mats.frame);
+   box(g,0,1.24,0,.09,.09,1.28,mats.trim);
+   box(g,0,1.14,-.54,.28,.20,.22,mat(base));
+   box(g,0,1.14,.54,.28,.20,.22,mats.dark);
+   box(g,0,1.14,-.42,.10,.08,.08,mats.cyan);
+  } else if(kind==='scanner'){
+   // Overhead scan tunnel: crossbeam, reader head and guarded stanchions.
+   for(const side of [-1,1])box(g,0,.8,side*.72,.12,1.6,.12,mats.frame);
+   box(g,0,1.62,0,.16,.18,1.63,mats.trim);
+   box(g,0,1.62,0,.42,.23,.49,mat(base));
+   box(g,0,1.48,.13,.22,.06,.27,mats.dark);
+  } else if(kind==='vfd'||kind==='motor'){
+   box(g,0,Math.max(.4,sy*.5),0,sx,Math.max(.7,sy),sz,mat(base,.55,.52));
+   box(g,0,sy*.61,sz*.53,sx*.77,sy*.44,.075,mats.dark);
+   box(g,-sx*.23,sy*.64,sz*.585,sx*.25,.11,.018,mats.cyan);
+  } else if(kind==='tank'){
+   cylinder(g,0,sy/2,0,Math.min(sx,sz)/2,sy,mat(base,.6,.43));
+   cylinder(g,0,sy,0,Math.min(sx,sz)/2+.08,.11,mats.trim);
+   for(const x of [-sx*.25,sx*.25])box(g,x,.2,0,.12,.4,.12,mats.frame);
+  } else if(kind==='pump'){
+   box(g,0,.12,0,sx,.23,sz,mats.dark);cylinder(g,0,.65,0,Math.min(.54,sx*.4),1,mat(base));
+   const motor=cylinder(g,sx*.24,.68,0,.32,.45,mats.frame);motor.rotation.z=Math.PI/2;
+  } else if(kind==='valve'){
+   cylinder(g,0,sy*.46,0,.3,.48,mat(base));cylinder(g,0,sy,0,.4,.07,mats.highlight);
+  } else if(kind==='robot'){
+   cylinder(g,0,.23,0,.65,.46,mats.dark);box(g,0,1,0,.42,1.5,.4,mat(base));const arm=box(g,.5,1.65,0,1.25,.29,.3,mats.frame);arm.rotation.z=.18;
+  } else {
+   box(g,0,Math.max(.25,sy*.5),0,sx,sy,sz,mat(base));
+   box(g,0,Math.max(.4,sy),0,sx*.86,.085,sz*.82,mats.trim);
+  }
+  const name=label(e.id);name.position.set(0,Math.max(.8,sy)+.95,0);g.add(name);
+  // Accessible click targets: industrial belts are too thin for reliable picking.
+  // Invisible proxy is local to the asset group, never rendered, never collidable.
+  const isTransport=['conveyor','sorter','junction'].includes(kind);
+  const hitHeight=kind==='spiral'?Math.max(2,Math.abs(station.exitY-station.baseY)+1):1.7;
+  const hitLength=isTransport?Math.max(1.8,station.length):kind==='spiral'?Math.max(1.5,station.radius*2.2):Math.max(.85,sx*1.45);
+  const hitWidth=kind==='spiral'?Math.max(1.5,station.radius*2.2):Math.max(1.1,sz*1.5);
+  const proxy=new T.Mesh(new T.BoxGeometry(hitLength,hitHeight,hitWidth),new T.MeshBasicMaterial({transparent:true,opacity:0,depthWrite:false,colorWrite:false}));
+  proxy.position.y=kind==='spiral'?1.1+(station.exitY-station.baseY)*.5:1.1;
+  if(isTransport)proxy.rotation.y=-Math.atan2(station.direction.z,station.direction.x);
+  proxy.userData.asset=e.id;proxy.userData.clickProxy=true;g.add(proxy);
+  g.traverse(o=>{if(o.isMesh||o.isSprite){o.userData.asset=e.id;pickables.push(o);}});
+  floors.get(e.floor).add(g);assets.set(e.id,g);
+ }
+ // Physically legible conceptual conveyor transition surfaces along the supplied
+ // material-flow graph, never an invented edge or certified OEM connection.
+ function conceptualRoute(route){
+  const pts=route.points.map(p=>new T.Vector3(p.x,p.y,p.z));
+  if(pts.length<2)return;
+  // Same R9 centerline ribbon algorithm as the equipment bodies and spirals.
+  // A proposed path only: does not certify interface tangency or roller mechanics.
+  const curve=new T.CatmullRomCurve3(pts,false,'centripetal',.34);
+  if(curve.getLength()<.12)return;
+  const routeGroup=new T.Group();
+  routeGroup.userData.conceptualConnector=true;
+  routeGroup.userData.routeFloor=route.kind==='conceptual_spiral_transfer'?route.to_floor:route.from_floor;
+  routeGroup.userData.geometry_status='CONCEPTUAL_CONNECTION_NEEDS_APPROVAL';
+  const rendered=buildR9Transport(T,routeGroup,curve,{width:.86,
+    materials:{frame:mats.frame,belt:mats.belt,rail:mats.trim,roller:mats.roller},conceptual:true});
+  rendered.userData.from=route.from;rendered.userData.to=route.to;
+  // Clicking a connecting belt opens its declared upstream equipment.
+  routeGroup.traverse(o=>{if(o.isMesh){o.userData.asset=route.from;o.userData.conceptualRoute=true;pickables.push(o);}});
+  scene.add(routeGroup);
+ }
+ for(const c of plannedRoutes){
+  if(c.kind==='conceptual_conveyor_transition'||c.kind==='conceptual_spiral_transfer'){
+   conceptualRoute(c);
+  }else{
+   // Unroutable or non-material links stay explicitly dashed logical connections.
+   const pts=c.points.map(p=>new T.Vector3(p.x,p.y,p.z));
+   const conn=line(pts[0],pts[pts.length-1]);conn.userData.floor=c.from_floor;scene.add(conn);
+  }
+ }
+ // Synthetic parcel visualization only. Uses EXACT declared edges, no inferred
+ // routes, no OPC data and no assertion of actual package tracking.
+ const simulatedParcels=new Map();
+ const parcelMaterial=new T.MeshStandardMaterial({color:0xffd579,roughness:.68,metalness:.08,emissive:0x62420b,emissiveIntensity:.24});
+ const parcelGeometry=new T.BoxGeometry(.48,.34,.38);
+ function demoPath(path){
+  // Render synthetic parcels on the SAME R9 generated centerlines as belts,
+  // sorter branches, spiral helixes and declared transition geometry.
+  // This is strictly a conceptual animation, not PLC positioning or speed.
+  if(!Array.isArray(path)||!path.length||path.length>model.equipment.length)return null;
+  const known=new Map(model.equipment.map(x=>[x.id,x]));
+  const track=new T.CurvePath();let last=null;
+  const V=p=>new T.Vector3(p.x,p.y+.24,p.z);
+  function addCurve(curve){
+   const start=curve.getPoint(0),end=curve.getPoint(1);
+   if(!Number.isFinite(start.x+start.y+start.z+end.x+end.y+end.z)||start.distanceTo(end)<.001)return false;
+   if(last&&last.distanceTo(start)>.015)return false;
+   track.add(curve);last=end;return true;
+  }
+  function line(a,b){const u=V(a),v=V(b);return u.distanceTo(v)<.001?true:addCurve(new T.LineCurve3(u,v));}
+  function curved(points){
+   const ps=points.map(V);
+   if(ps.length<2)return false;
+   return addCurve(new T.CatmullRomCurve3(ps,false,'centripetal',.34));
+  }
+  for(let i=0;i<path.length;i++){
+   const id=path[i],e=known.get(id),st=assembly.stations[id];if(!e||!st)return null;
+   if(st.helix){if(!curved(st.helix))return null;}
+   else{
+    if(!line(st.entry,st.center))return null;
+    const next=path[i+1],out=st.outlets?.[next]?.point||st.exit;
+    if(next&&st.kind==='sorter'&&out!==st.exit){
+     // EXACT same four control points as R9 sorter diverter ribbon.
+     const controls=sorterBranchPoints(st,next);
+     if(!controls||!curved(controls))return null;
+    }else if(!line(st.center,out))return null;
+   }
+   if(i<path.length-1){
+    const r=plannedRoutes.find(x=>x.from===id&&x.to===path[i+1]);
+    if(!r||!['conceptual_conveyor_transition','conceptual_spiral_transfer'].includes(r.kind))return null;
+    if(!curved(r.points))return null;
+   }
+  }
+  return track.curves.length?track:null;
+ }
+ let lastParcelRoute='',lastParcelCurve=null;
+ function parcels(rows){
+  if(!Array.isArray(rows))rows=[];
+  const liveIds=new Set();
+  for(const p of rows.slice(0,4)){
+   if(!p||typeof p.id!=='string'||!/^[A-Z0-9-]{1,24}$/.test(p.id)||typeof p.progress!=='number'||p.progress<0||p.progress>1)continue;
+   const routeKey=Array.isArray(p.path)?p.path.join('>'):'';
+   if(routeKey!==lastParcelRoute){lastParcelCurve=demoPath(p.path);lastParcelRoute=routeKey;}
+   if(!lastParcelCurve)continue;
+   let obj=simulatedParcels.get(p.id);
+   if(!obj){obj=new T.Mesh(parcelGeometry,parcelMaterial);obj.castShadow=true;scene.add(obj);simulatedParcels.set(p.id,obj);}
+   // Smoothly interpolate sampled synthetic progress between HTTP polls.
+   // This is rendering interpolation, NOT a measured position claim.
+   const oldProgress=obj.userData.demoProgress;
+   obj.userData.demoFrom=typeof oldProgress==='number'&&p.progress>=oldProgress?oldProgress:p.progress;
+   obj.userData.demoTarget=p.progress;
+   obj.userData.demoAt=performance.now();
+   obj.userData.demoCurve=lastParcelCurve;
+   obj.userData.syntheticParcel=true;
+   liveIds.add(p.id);
+  }
+  for(const [id,obj] of simulatedParcels)if(!liveIds.has(id)){scene.remove(obj);simulatedParcels.delete(id);}
+ }
+ // Selection is an inspector affordance, never RUN/FAULT state.
+ const selectRing=new T.Mesh(new T.RingGeometry(.66,.72,48),new T.MeshBasicMaterial({color:palette.accent,side:T.DoubleSide,transparent:true,opacity:.85,depthWrite:false}));
+ selectRing.rotation.x=-Math.PI/2;selectRing.visible=false;scene.add(selectRing);
+ // Simulated FAT replay markers. Separate from asset materials and never represent live PLC state.
+ const replayRings=new Map();let visibleFloor='all';
+ // Live LAB status overlays (read-only). Never recolor the immutable machine
+ // geometry or imply PLC control authority. Only signal-qualified states appear.
+ const stateRings=new Map();
+ function operatingStates(signals){
+  for(const old of stateRings.values()){scene.remove(old);old.geometry.dispose();old.material.dispose();}
+  stateRings.clear();
+  if(!Array.isArray(signals))return;
+  const byAsset=new Map();
+  for(const sig of signals){
+   if(!sig?.valid)continue;
+   if(!['run_feedback','fault','photoeye_blocked'].includes(sig.role))continue;
+   let row=byAsset.get(sig.asset_id);if(!row){row={};byAsset.set(sig.asset_id,row);}
+   // No inference if multiple signals disagree; ambiguous status is UNKNOWN.
+   if(sig.role in row && row[sig.role]!==sig.value)row.invalid=true;
+   row[sig.role]=sig.value;
+  }
+  for(const [assetId,row] of byAsset){
+   if(row.invalid)continue;
+   const e=model.equipment.find(x=>x.id===assetId);if(!e||!assets.has(assetId))continue;
+   const severity=row.fault===true?'fault':row.photoeye_blocked===true?'blocked':row.run_feedback===true?'running':null;
+   if(!severity)continue; // Unknown or stopped: no visual state claim.
+   const color=severity==='fault'?0xff6582:severity==='blocked'?0xe8b55e:0x36ce9b;
+   const ring=new T.Mesh(new T.RingGeometry(.60,.71,40),new T.MeshBasicMaterial({color,side:T.DoubleSide,transparent:true,opacity:.93,depthWrite:false}));
+   ring.rotation.x=-Math.PI/2;ring.position.set(e.position.x,e.position.y-.17,e.position.z);
+   ring.scale.setScalar(Math.max(1,Math.min(2.6,e.dimensions.x*.50)));
+   ring.visible=visibleFloor==='all'||String(e.floor)===visibleFloor;
+   ring.userData.labOnlyMarker=true;scene.add(ring);stateRings.set(assetId,ring);
+  }
+ }
+
+ function alarms(entries){
+  for(const old of replayRings.values()){scene.remove(old);old.geometry.dispose();old.material.dispose();}
+  replayRings.clear();
+  if(!Array.isArray(entries))return;
+  for(const item of entries){
+   const e=model.equipment.find(x=>x.id===item.asset_id);
+   if(!e||!assets.has(e.id))continue;
+   const isFault=item.severity==='CRITICAL';
+   const ring=new T.Mesh(new T.RingGeometry(.84,1.02,48),
+       new T.MeshBasicMaterial({color:isFault?0xff6582:0xe8b55e,side:T.DoubleSide,transparent:true,opacity:.95,depthWrite:false}));
+   ring.rotation.x=-Math.PI/2;
+   ring.position.set(e.position.x,e.position.y-.30,e.position.z);
+   ring.scale.setScalar(Math.max(1,Math.min(2.8,e.dimensions.x*.57)));
+   ring.visible=visibleFloor==='all'||String(e.floor)===visibleFloor;
+   ring.userData.isReplayMarker=true;
+   scene.add(ring);replayRings.set(e.id,ring);
+  }
+ }
+ const ray=new T.Raycaster();const cursor=new T.Vector2();let selectedId=null;
+ function selected(id){selectedId=id;const g=assets.get(id);selectRing.visible=!!g;if(g){const e=model.equipment.find(x=>x.id===id);selectRing.position.set(g.position.x,e.position.y-.42,g.position.z);selectRing.scale.setScalar(Math.max(1,Math.min(2.5,e.dimensions.x*.48)));}}
+ // Frame each customer facility, independent of floor count or asset quantity.
+ const bb=new T.Box3();
+ for(const e of model.equipment){
+  const p=new T.Vector3(e.position.x,e.position.y+e.dimensions.y*.5,e.position.z);
+  const half=new T.Vector3(Math.max(e.dimensions.x,1)*.5,Math.max(e.dimensions.y,1)*.5+1.5,Math.max(e.dimensions.z,1)*.5);
+  bb.expandByPoint(p.clone().sub(half));bb.expandByPoint(p.clone().add(half));
+ }
+ if(facility){
+  bb.expandByPoint(new T.Vector3(facility.minX,-1.6,facility.minZ));
+  bb.expandByPoint(new T.Vector3(facility.maxX,Math.max(...model.equipment.map(e=>e.position.y))+4.7,facility.maxZ));
+ }
+ let activeBox=bb;
+ if(!bb.isEmpty())target.copy(bb.getCenter(new T.Vector3()));
+ function fitCamera(){
+  if(activeBox.isEmpty())return;
+  const w=Math.max(320,host.clientWidth||1100),h=Math.max(280,host.clientHeight||640);
+  const aspect=w/h,halfAngle=T.MathUtils.degToRad(camera.fov*.5),m=.85;
+  const n=new T.Vector3(Math.cos(el)*Math.sin(az),Math.sin(el),Math.cos(el)*Math.cos(az));
+  const right=new T.Vector3(Math.cos(az),0,-Math.sin(az));
+  const up=new T.Vector3().crossVectors(n,right).normalize();
+  let xr=0,yr=0,front=0;
+  for(const x of [activeBox.min.x,activeBox.max.x])for(const y of [activeBox.min.y,activeBox.max.y])for(const z of [activeBox.min.z,activeBox.max.z]){
+   const d=new T.Vector3(x-target.x,y-target.y,z-target.z);
+   xr=Math.max(xr,Math.abs(d.dot(right)));yr=Math.max(yr,Math.abs(d.dot(up)));front=Math.max(front,d.dot(n));
+  }
+  dist=Math.min(450,Math.max(7,front+Math.max(xr/(Math.tan(halfAngle)*aspect*m),yr/(Math.tan(halfAngle)*m))+1.1));
+ }
+ function updateCamera(){camera.position.set(target.x+dist*Math.cos(el)*Math.sin(az),target.y+dist*Math.sin(el),target.z+dist*Math.cos(el)*Math.cos(az));camera.lookAt(target);}
+ function view(mode){if(mode==='top'){el=1.52;az=0;}else if(mode==='side'){el=.18;az=Math.PI/2;}else{az=.88;el=.54;}fitCamera();updateCamera();}
+ function focus(id){
+  const e=model.equipment.find(x=>x.id===id);if(!e)return false;
+  if(visibleFloor!=='all'&&String(e.floor)!==visibleFloor)floor(String(e.floor));
+  const size=new T.Vector3(Math.max(3.5,e.dimensions.x*2.0),Math.max(3.5,e.dimensions.y*2.0),Math.max(3.5,e.dimensions.z*2.0));
+  const center=new T.Vector3(e.position.x,e.position.y+e.dimensions.y*.5,e.position.z);
+  activeBox=new T.Box3().setFromCenterAndSize(center,size);target.copy(center);
+  fitCamera();dist=Math.max(6.5,Math.min(dist,Math.max(8,Math.max(size.x,size.y,size.z)*2.2)));updateCamera();
+  selected(id);return true;
+ }
+ function overview(){floor(visibleFloor);view('iso');}
+ function floor(which){visibleFloor=which;for(const [id,marker] of replayRings){const e=model.equipment.find(x=>x.id===id);marker.visible=which==='all'||String(e.floor)===which;}for(const [id,marker] of stateRings){const e=model.equipment.find(x=>x.id===id);marker.visible=which==='all'||String(e.floor)===which;}for(const [f,g] of floors)g.visible=which==='all'||String(f)===which;for(const obj of scene.children){const rf=obj.userData.routeFloor??(obj.isLine?obj.userData.floor:undefined);if(rf!==undefined)obj.visible=which==='all'||String(rf)===which;}
+  // Focus the camera on the selected level instead of leaving it tiny in full-building view.
+  activeBox=which==='all'?bb:new T.Box3();
+  if(which!=='all')for(const e of model.equipment.filter(e=>String(e.floor)===which)){
+    const p=new T.Vector3(e.position.x,e.position.y+e.dimensions.y*.5,e.position.z);
+    const h=new T.Vector3(e.dimensions.x*.5,e.dimensions.y*.5+1.5,e.dimensions.z*.5);
+    activeBox.expandByPoint(p.clone().sub(h));activeBox.expandByPoint(p.clone().add(h));
+  }
+  if(!activeBox.isEmpty())target.copy(activeBox.getCenter(new T.Vector3()));
+  fitCamera();updateCamera();
+ }
+ let dragging=false,moved=false,px=0,py=0,startX=0,startY=0;
+ renderer.domElement.style.touchAction='none';
+ renderer.domElement.addEventListener('pointerdown',ev=>{if(ev.button!==0)return;dragging=true;moved=false;startX=px=ev.clientX;startY=py=ev.clientY;renderer.domElement.setPointerCapture(ev.pointerId);});
+ renderer.domElement.addEventListener('pointermove',ev=>{if(!dragging)return;const dx=ev.clientX-px,dy=ev.clientY-py;px=ev.clientX;py=ev.clientY;if(Math.hypot(ev.clientX-startX,ev.clientY-startY)>6)moved=true;if(!moved)return;az-=dx*.006;el=Math.max(.08,Math.min(1.5,el+dy*.006));updateCamera();});
+ renderer.domElement.addEventListener('pointercancel',()=>{dragging=false;});
+ renderer.domElement.addEventListener('pointerup',ev=>{if(!dragging)return;dragging=false;if(moved)return;
+  const box=renderer.domElement.getBoundingClientRect();cursor.x=((ev.clientX-box.left)/box.width)*2-1;cursor.y=-((ev.clientY-box.top)/box.height)*2+1;ray.setFromCamera(cursor,camera);
+  const isVisible=o=>{while(o&&o!==scene){if(!o.visible)return false;o=o.parent;}return true;};
+  const chosen=ray.intersectObjects(pickables,false).find(h=>isVisible(h.object)&&h.object.userData.asset);
+  if(chosen)onSelect(chosen.object.userData.asset);
+ });renderer.domElement.addEventListener('wheel',ev=>{ev.preventDefault();dist=Math.min(260,Math.max(6,dist*(ev.deltaY>0?1.11:.90)));updateCamera();},{passive:false});
+ function resize(){const r=host.getBoundingClientRect();renderer.setSize(Math.max(320,r.width),Math.max(280,r.height),false);camera.aspect=Math.max(320,r.width)/Math.max(280,r.height);camera.updateProjectionMatrix();fitCamera();updateCamera();}const obs=new ResizeObserver(resize);obs.observe(host);resize();let active=true;
+ function frame(){if(!active)return;
+   const now=performance.now();
+   for(const obj of simulatedParcels.values()){
+    const curve=obj.userData.demoCurve;if(!curve)continue;
+    const weight=Math.min(1,Math.max(0,(now-obj.userData.demoAt)/1050));
+    const progress=obj.userData.demoFrom+(obj.userData.demoTarget-obj.userData.demoFrom)*weight;
+    const at=curve.getPointAt(progress),tangent=curve.getTangentAt(progress);
+    obj.position.copy(at);obj.rotation.y=-Math.atan2(tangent.z,tangent.x);
+    obj.userData.demoProgress=progress;
+    if(visibleFloor==='all')obj.visible=true;
+    else obj.visible=model.equipment.some(e=>String(e.floor)===visibleFloor&&Math.abs(e.position.y-at.y)<3.5);
+   }
+   renderer.render(scene,camera);requestAnimationFrame(frame);
+  }requestAnimationFrame(frame);
+ window.addEventListener('pagehide',()=>{active=false;obs.disconnect();renderer.dispose();},{once:true});
+ return {select:selected,floor,view,focus,overview,alarms,operatingStates,parcels,mount:id=>sensorMounts[id]||null};
+}

devagent_spatial/_resources/assets/unified_engineer.js

@@ -0,0 +1,101 @@
+/* V0.7.5 single, server-gated AI -> engineering harness -> customer review -> concept. */
+(()=>{'use strict';
+const el=id=>document.getElementById(id);
+const ids=['name','industry','layout','palette','description','equipment_csv','connections_csv','signals_csv','requirements'];
+const snapshot=()=>Object.fromEntries(ids.map(id=>[id,el(id).value]));
+const fingerprint=()=>JSON.stringify(snapshot());
+let reviewed=null, token=null, expected=null, busy=false;
+let workspaceGeneration=0;
+const out=el('engineer-results'),approve=el('engineer-approval'),confirm=el('engineer-confirm');
+const show=(msg,hold=false)=>{out.classList.remove('hidden');out.classList.toggle('hold',hold);out.textContent=msg;};
+const label=txt=>{el('engineer-stage-badge').textContent=txt;el('engineer-validation-state').textContent=txt;};
+function invalidate(){token=null;reviewed=null;expected=null;approve.classList.add('hidden');confirm.checked=false;el('engineer-build').disabled=true;
+ el('engineer-equipment-state').textContent=String(Math.max(0,el('equipment_csv').value.split(/\r?\n/).filter((r,i)=>i>0&&r.trim()).length))+' supplied';
+ el('engineer-model-state').textContent=window.DevAgentAIFlow?.isConnected()?(el('ai-provider').value+' / '+el('ai-model').value):'Not connected';
+ if(!busy)label('REVIEW REQUIRED');}
+for(const id of ids){el(id).addEventListener('input',invalidate);el(id).addEventListener('change',invalidate);}
+document.addEventListener('devagent:changed',()=>{if(!token)invalidate();});
+document.addEventListener('devagent:ai-connection',invalidate);
+document.addEventListener('devagent:project-reset',()=>{
+ workspaceGeneration++;
+ const stale=token;invalidate();busy=false;el('engineer-run').disabled=false;
+ out.classList.add('hidden');out.classList.remove('hold');
+ if(stale)fetch('/api/engineer/revoke',{method:'POST',keepalive:true,
+  headers:{'Content-Type':'application/json','X-DevAgent-Request':'engineer-pipeline-v1'},
+  body:JSON.stringify({review_token:stale,confirm:'REVOKE_LOCAL_REVIEW_ONLY'})}).catch(()=>{});
+});
+confirm.addEventListener('change',()=>{el('engineer-build').disabled=!confirm.checked||!token||fingerprint()!==expected;});
+const request=async(url,body)=>{const ctl=new AbortController(),timer=setTimeout(()=>ctl.abort(),140000);
+ try{const r=await fetch(url,{method:'POST',headers:{'Content-Type':'application/json','X-DevAgent-Request':'engineer-pipeline-v1'},body:JSON.stringify(body),signal:ctl.signal});
+ return {ok:r.ok,data:await r.json()};}finally{clearTimeout(timer);}};
+el('engineer-run').addEventListener('click',async()=>{
+ if(busy||!window.DevAgentAIFlow?.requireConnection())return;
+ const generation=workspaceGeneration;
+ busy=true;el('engineer-run').disabled=true;invalidate();
+ label('AI + ENGINE CHECKS RUNNING');show('Model proposal requested. The independent engineering harness validates all returned alternatives and prepares the unexecuted FAT inventory.\nNo stage is PASS until server evidence arrives.');
+ const original=snapshot();const conn={provider:el('ai-provider').value,model:el('ai-model').value.trim(),endpoint:el('ai-endpoint').value.trim(),api_key:el('ai-key').value};
+ try{const r=await request('/api/engineer/prepare',{wizard:original,connection:conn,request:el('ai-request').value.trim(),max_attempts:2});
+ if(generation!==workspaceGeneration)return;
+ if(!r.ok){
+   const failures=(Array.isArray(r.data?.attempts)?r.data.attempts:[]).slice(0,3);
+   const detail=failures.map(t=>'Attempt '+Number(t.attempt)+': '+(t.failure_code||t.reason||t.result||'UNKNOWN')).join('\n');
+   const codes=failures.map(t=>t.failure_code||'');
+   const advice=codes.some(c=>['AI_PROPOSAL_NOT_STRICT_JSON','AI_PROPOSAL_SCHEMA_INVALID','AI_PROPOSAL_FIELDS_INVALID','AI_PROVIDER_RESPONSE_TOO_LARGE'].includes(c))
+     ? 'AI did not return compact strict JSON. Customer CSV is retained by the Engineering Engine and should not be repeated in model output.'
+     : codes.some(c=>c.startsWith('MODEL_CANNOT_')||c==='CUSTOMER_SOURCE_OR_VALIDATION_GATE')
+     ? 'Proposal attempted to change source data or requirements. Keep equipment, topology, mappings and customer choices unchanged.'
+     : codes.some(c=>c.startsWith('AI_PROVIDER_'))
+     ? 'Check provider/model response and usage limits. Test Connection alone does not validate an engineering proposal.'
+     : 'Inspect the attempt codes; do not erase customer inputs or invent mappings to force PASS.';
+   label('HOLD');show('AI Engineering HOLD: '+(r.data?.reason||'UNKNOWN')+'\n\n'+(detail?'Rejected attempts:\n'+detail+'\n\n':'')+advice+'\nNo HMI generated. Source inputs preserved. Production HOLD.',true);return;}
+
+ const result=r.data;const proposed=result.winner?.fields;
+ if(!proposed){label('HOLD');show('No validated proposal available.',true);return;}
+ // Server receipt verifies this exact candidate at the separate build endpoint.
+ // Previewing the proposed customer-visible changes is part of the approval process.
+ const changes=[];for(const k of ids){if(typeof proposed[k]==='string'&&proposed[k]!==original[k])changes.push('• '+k+': proposed update ('+proposed[k].length+' characters)');}
+ if(fingerprint()!==JSON.stringify(original)){label('HOLD');show('Inputs changed during AI review. Run again.',true);return;}
+ reviewed=proposed;token=result.review_token;
+ // apply candidate fields with existing UI bindings; this is not a production mapping authorization.
+ for(const k of ids){if(typeof proposed[k]==='string'){
+ el(k).value=proposed[k];el(k).dispatchEvent(new Event('input',{bubbles:true}));}}
+ // input dispatch revokes local token, then restore only after all updates to the reviewed proposal.
+ token=result.review_token;reviewed=proposed;expected=fingerprint();
+ const trials=(result.attempts||[]).map(t=>'Attempt '+t.attempt+': '+t.result).join('\n');
+ const problems=(result.engineering?.findings||[]).slice(0,9).map(f=>'• '+f.category+(f.asset_id?' ['+f.asset_id+']':'')).join('\n');
+ label('STATIC-ELIGIBLE · REVIEW');
+ show('AI proposals and deterministic checks complete.\n'+trials+'\n\nCustomer proposal changes:\n'+(changes.join('\n')||'• No editable field changes')+'\n\nSource gaps / recommended checks:\n'+(problems||'None listed; physical validation still required')+'\n\nIgnition and real PLC: NOT VERIFIED · Production: HOLD');
+ el('engineer-review-summary').textContent='Customer review required. Generated preview is conceptual only. All unverified OPC mappings, real equipment associations and safety logic remain HOLD. Receipt expires in 10 minutes.';
+ approve.classList.remove('hidden');confirm.checked=false;el('engineer-build').disabled=true;
+ }catch(e){if(generation===workspaceGeneration){label('HOLD');show('AI pipeline unavailable or timed out. No project was generated.',true);}}
+ finally{if(generation===workspaceGeneration){busy=false;el('engineer-run').disabled=false;}}});
+el('engineer-build').addEventListener('click',async()=>{
+ if(busy||!token||!confirm.checked||fingerprint()!==expected||!window.DevAgentAIFlow?.isConnected()){
+  label('HOLD');show('Review expired or inputs/model changed. Run AI Engineer again.',true);return;}
+ busy=true;el('engineer-build').disabled=true;el('engineer-run').disabled=true;
+ const generation=workspaceGeneration;
+ try{label('GENERATING VERIFIED CONCEPT');show('Revalidating reviewed AI candidate on the server and generating isolated preview…');
+ const rsp=await request('/api/engineer/build',{wizard:snapshot(),review_token:token,confirm:'CUSTOMER_APPROVED_ISOLATED_CONCEPT_ONLY'});
+ if(generation!==workspaceGeneration)return;
+ token=null;
+ if(!rsp.ok){label('HOLD');show('Build HOLD: '+(rsp.data.reason||'UNKNOWN')+'\nNo production claims.',true);return;}
+ const r=rsp.data;
+ // A successfully generated project must be visible to the customer.
+ // The success panel lives in Step 04, which may be hidden after loading
+ // a demo on Step 01. Navigate using the existing four-step handler.
+ const reviewStep=document.querySelectorAll('.step')[3];
+ if(reviewStep)reviewStep.click();
+ el('success').classList.remove('hidden');el('preview-link').href=r.url;
+ el('studio-test-link').href='/projects/'+r.project_id+'/test/index.html';
+ el('result').className='status pass';el('result').textContent=r.status+' · '+r.fat_cases+' FAT inventory cases · production HOLD';
+ label('PREVIEW GENERATED · FAT PENDING');show('AI + Engineering Server Receipt: PASS (offline only)\nProject: '+r.project_id+'\nFAT inventory: '+r.fat_cases+' unexecuted test plans\nIgnition Gateway FAT: NOT VERIFIED\nProduction release: HOLD');
+ document.dispatchEvent(new CustomEvent('devagent:project-built',{detail:{project_id:r.project_id}}));
+ el('success').scrollIntoView({behavior:'smooth',block:'center'});
+ }catch(e){if(generation===workspaceGeneration){label('HOLD');show('Build request failed; no proof of a valid HMI. Review Gateway logs.',true);}}
+ finally{if(generation===workspaceGeneration){busy=false;el('engineer-run').disabled=false;approve.classList.add('hidden');}}});
+// Initialize the panel with the actual current form values. The connection
+// script and HTML model data may have been populated before this deferred JS ran.
+invalidate();
+label(el('equipment_csv').value.trim() ? 'READY FOR AI REVIEW' : 'WAITING FOR INPUTS');
+window.DevAgentUnifiedReady=true;
+})();

devagent_spatial/_resources/assets/v076_fat_ui.js

@@ -0,0 +1,40 @@
+/* V0.7.6 isolated *fake OPC UA* test AFTER AI-reviewed Generate. Never a PLC or Ignition action. */
+(()=>{'use strict';
+let pid=null, busy=false;
+const button=document.getElementById('v076-opc-run'),state=document.getElementById('v076-opc-status');
+if(!button||!state)return;
+document.addEventListener('devagent:project-built',event=>{
+ const value=event.detail?.project_id;
+ if(!/^[a-z0-9-]{1,100}$/.test(value||''))return;
+ pid=value;button.classList.remove('hidden');state.classList.add('hidden');
+});
+document.addEventListener('devagent:project-reset',()=>{
+ pid=null;busy=false;button.disabled=false;button.classList.add('hidden');state.classList.add('hidden');state.replaceChildren();
+});
+button.addEventListener('click',async()=>{
+ if(!pid||busy)return;
+ const confirmation=window.confirm('Run fake OPC UA on 127.0.0.1 only? This is synthetic protocol testing, NOT Ignition/PLC FAT.');
+ if(!confirmation)return;
+ busy=true;button.disabled=true;state.classList.remove('hidden');
+ state.textContent='Starting ephemeral loopback fake OPC UA and independent TCP readback…';
+ try{
+  const controller=new AbortController(),timeout=setTimeout(()=>controller.abort(),55000);
+  let response;
+  try{response=await fetch('/api/v076-opc/'+encodeURIComponent(pid)+'/run',{
+   method:'POST',headers:{'Content-Type':'application/json','X-DevAgent-Request':'isolated-opc-fat-v076'},
+   body:JSON.stringify({confirm:'ISOLATED_FAKE_OPC_LOOPBACK_ONLY'}),signal:controller.signal});}
+  finally{clearTimeout(timeout);}
+  const result=await response.json();
+  if(response.ok&&result.status==='PASS_LAB_OPC_PROTOCOL_ONLY'){
+   state.textContent='Synthetic OPC UA protocol: '+result.cases_passed+'/'+result.cases_planned+
+     ' readbacks PASS. Ignition HMI FAT: NOT VERIFIED. Production: HOLD. ';
+   if(result.report_url){const link=document.createElement('a');link.href=result.report_url;
+    link.target='_blank';link.rel='noopener';link.textContent='Open lab evidence ↗';state.append(link);}
+  }else{
+   state.textContent='HOLD '+(result.reason||result.status||'UNKNOWN')+
+     '. For a real fake OPC test install optional asyncua in the app Python environment. No pass was recorded.';
+  }
+ }catch(e){state.textContent='HOLD: fake OPC UA protocol test unavailable. No FAT PASS.';}
+ finally{busy=false;button.disabled=false;}
+});
+})();

devagent_spatial/_resources/assets/v078_command_ui.js

@@ -0,0 +1,44 @@
+/* V078 device command functional FAT: ONLY ephemeral loopback virtual PLC. */
+(()=>{'use strict';
+let pid=null,busy=false;
+const button=document.getElementById('v078-command-run');
+const state=document.getElementById('v078-command-status');
+if(!button||!state)return;
+document.addEventListener('devagent:project-built',event=>{
+ const value=event.detail?.project_id;
+ if(!/^[a-z0-9-]{1,100}$/.test(value||''))return;
+ pid=value;button.classList.remove('hidden');state.classList.add('hidden');
+});
+document.addEventListener('devagent:project-reset',()=>{
+ pid=null;busy=false;button.disabled=false;button.classList.add('hidden');state.classList.add('hidden');state.replaceChildren();
+});
+button.addEventListener('click',async()=>{
+ if(!pid||busy)return;
+ const asset=window.prompt('LAB ONLY: Equipment ID to test (e.g., CV101). START/STOP/RESET will target a temporary Virtual PLC on 127.0.0.1, never production.','CV101');
+ if(!asset)return;
+ if(!/^[A-Za-z][A-Za-z0-9_]{1,59}$/.test(asset)){
+  state.classList.remove('hidden');state.textContent='HOLD: invalid equipment ID.';return;
+ }
+ const reviewer=window.prompt('Lab reviewer name (recorded for test only; not proof of engineering authorization):','');
+ if(!reviewer||reviewer.trim().length<3)return;
+ if(!window.confirm('Confirm isolated Virtual PLC only? No Ignition Gateway or real PLC will be contacted.'))return;
+ busy=true;button.disabled=true;state.classList.remove('hidden');
+ state.textContent='Running START / STOP / RESET, fault and permissive tests over isolated OPC UA TCP…';
+ try{
+  const controller=new AbortController(),timer=setTimeout(()=>controller.abort(),50000);
+  let response;
+  try{response=await fetch('/api/v078-command/'+encodeURIComponent(pid)+'/run',{
+   method:'POST',headers:{'Content-Type':'application/json','X-DevAgent-Request':'isolated-device-command-v078'},
+   body:JSON.stringify({asset_id:asset,reviewer:reviewer.trim(),confirm:'ISOLATED_VIRTUAL_PLC_LOOPBACK_ONLY'}),
+   signal:controller.signal});}finally{clearTimeout(timer);}
+  const result=await response.json();
+  if(response.ok&&result.status==='PASS_ISOLATED_VIRTUAL_PLC_COMMAND_FAT_ONLY'){
+    state.textContent='Virtual PLC: '+result.cases_checked+' functional checks PASS. Ignition: NOT VERIFIED. Production: HOLD. ';
+    if(result.report_url){const link=document.createElement('a');link.href=result.report_url;
+     link.target='_blank';link.rel='noopener';link.textContent='Open command FAT evidence ↗';state.append(link);}
+  }else{state.textContent='HOLD: '+(result.reason||result.status||'COMMAND_TEST_FAILED')+
+   '. Install asyncua in the Creator Python environment if missing. No production claims.';}
+ }catch(e){state.textContent='HOLD: Virtual PLC OPC UA FAT did not complete. No PASS recorded.';}
+ finally{busy=false;button.disabled=false;}
+});
+})();