devagent-ignition 0.1.0__py3-none-any.whl

devagent_spatial/_resources/assets/viewer.html

@@ -0,0 +1,45 @@
+<!doctype html>
+<html lang="en">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="dark"><title>DevAgent Spatial Operations — Concept Preview</title><link rel="stylesheet" href="./style.css"></head>
+<body>
+<div id="root">
+<header class="top"><div><div class="eyebrow">DEVAGENT / SPATIAL OPERATIONS / CUSTOMER CONCEPT</div><h1 id="project-name">Industrial Facility</h1></div><div class="top-right"><strong>DESIGN SYSTEM V1</strong><span id="source-indicator" class="tag warn">PREVIEW / NO LIVE OPC UA</span><button type="button" id="alerts-toggle" class="alert-bell is-unknown" aria-haspopup="dialog" aria-controls="alerts-dialog" aria-label="Notifications — source not verified" title="Notifications — source not verified"><svg class="bell-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M18 8a6 6 0 0 0-12 0c0 7-3 8.5-3 9.5h18c0-1-3-2.5-3-9.5ZM10 21h4"/></svg><span id="alert-count" class="bell-badge is-unknown" aria-hidden="true">?</span></button><button type="button" id="engineering-toggle" class="engineering-link" aria-haspopup="dialog" aria-controls="engineering-dialog">ENGINEERING REVIEW</button></div></header>
+<main>
+<section class="metrics" aria-label="Overview metrics"><div class="metric"><small>ASSETS MODELED</small><strong id="m-assets">—</strong><span>customer equipment definition</span></div><div class="metric"><small>PROPOSED OPC UA SIGNALS</small><strong id="m-signals">—</strong><span>not live verified</span></div><div class="metric"><small>VERIFIED TAG MAPPINGS</small><strong>0</strong><span>live validation pending</span></div><div class="metric"><small>SAFETY / CONTROL AUTHORITY</small><strong>READ ONLY</strong><span>PLC writes disabled</span></div><div class="metric"><small>HMI STATUS</small><strong>PREVIEW</strong><span>not Ignition qualified</span></div></section>
+<section class="ops-board" aria-label="Industrial operations KPIs">
+<div class="ops-heading"><div><div class="eyebrow">OPERATIONAL INTELLIGENCE / SOURCE-QUALIFIED</div><b>System performance & alarms</b></div><div id="ops-mode" class="ops-mode">NO LIVE SOURCE · KPI UNAVAILABLE</div></div>
+<div class="ops-metrics">
+<div class="ops-metric"><small>EQUIPMENT RUNNING</small><strong id="kpi-running">N/A</strong><span id="kpi-running-note">Awaiting verified data</span></div>
+<div class="ops-metric"><small>ACTIVE FAULTS</small><strong id="kpi-faults">N/A</strong><span id="kpi-faults-note">Unknown ≠ no faults</span></div>
+<div class="ops-metric"><small>PHOTOEYES BLOCKED</small><strong id="kpi-blocked">N/A</strong><span id="kpi-blocked-note">No live source</span></div>
+<div class="ops-metric"><small>NO_READ EVENTS</small><strong id="kpi-noread">N/A</strong><span id="kpi-noread-note">Source not verified</span></div>
+<div class="ops-metric"><small>TOTAL SCANS</small><strong id="kpi-scans">N/A</strong><span id="kpi-scans-note">Source not configured</span></div>
+<div class="ops-metric"><small>PARCELS IN TRANSIT</small><strong id="kpi-transit">N/A</strong><span id="kpi-transit-note">Source not configured</span></div>
+<div class="ops-metric"><small>DELIVERED PARCELS</small><strong id="kpi-delivered">N/A</strong><span id="kpi-delivered-note">Source not configured</span></div>
+<div class="ops-metric"><small>LAST SCAN RESULT</small><strong id="kpi-scanresult">N/A</strong><span id="kpi-scanresult-note">Source not connected</span></div>
+<div class="ops-metric"><small>LAST BARCODE</small><strong id="kpi-barcode">N/A</strong><span id="kpi-barcode-note">Source not configured</span></div>
+<div class="ops-metric"><small>SIGNAL QUALITY</small><strong id="kpi-quality">N/A</strong><span id="kpi-quality-note">0 verified mappings</span></div>
+</div>
+</section>
+<section class="command" aria-label="Design overview"><div><b>Facility command center</b><span id="system-subtitle">Customer-configured facility</span></div><div class="command-buttons"><button class="muted-btn cmd-start" disabled title="No verified PLC write permission" aria-disabled="true">START</button><button class="muted-btn cmd-stop" disabled title="No verified PLC write permission" aria-disabled="true">STOP</button><button class="muted-btn cmd-reset" disabled title="No verified PLC write permission" aria-disabled="true">RESET</button><span class="tag warn" aria-label="No physical control authority">LOCKED · COMMANDS DISABLED</span></div></section>
+<div class="workspace">
+<section class="viewer-panel"><div class="panel-head"><div><div class="eyebrow">01 / SPATIAL FACILITY MAP</div><h2 id="viewer-title">Spatial material flow</h2><p id="viewer-description">Conceptual, interactive preview. Customer geometry must be reviewed.</p></div><span class="tag">NO PHYSICAL EQUIPMENT CONTROL</span></div>
+<div class="viewer-toolbar"><div class="seg"><button id="view-fit" class="active">3D OVERVIEW</button><button id="view-top">TOP</button><button id="view-side">SIDE</button><button id="view-reset">RESET CAMERA</button></div><div class="seg"><label for="floor">FLOOR</label><select id="floor"><option value="all">ALL LEVELS</option></select></div></div>
+<div id="view-stage" class="stage" tabindex="0" aria-label="Interactive industrial scene"><div id="scene-layer"></div><div class="stage-caption"><div class="eyebrow">OPERATIONAL DIGITAL TWIN / CONCEPT MODEL</div><strong id="scene-label">Spatial layout</strong><small>Orbit • drag · zoom • wheel · select • click</small></div><div id="layer-index" class="layer-index" aria-label="Facility floor navigation"><div class="eyebrow">3D LAYER INDEX</div><div id="layer-buttons"></div></div><div id="scene-engine" class="engine-tag" role="status">Loading renderer…</div><div class="stage-help">CONCEPTUAL GEOMETRY · SOLID TRANSITIONS = CONCEPTUAL ROUTES · DASHED LINES = LOGICAL FLOW ONLY · NOT AS-BUILT · NO LIVE PLC CONNECTION</div></div>
+</section>
+<aside class="inspector"><div class="panel-head inspector-head"><div><div class="eyebrow">02 / EQUIPMENT INSPECTOR</div><h2>Asset intelligence</h2><p>Select a machine in the spatial viewer</p></div></div><div class="inspector-body"><div class="eyebrow" id="selected-type">SELECTED EQUIPMENT</div><h2 id="selected-id">—</h2><p id="selected-name">Click an asset to inspect its proposed mappings.</p><div id="asset-meta" class="detail-grid"></div><div class="small-title">AVAILABLE SIGNALS · NOT VERIFIED</div><div id="selected-signals" class="signals-mini"></div><div class="note">Preview only · Signal values and machine states are not connected to a verified source.</div></div></aside>
+</div>
+<dialog class="alerts-dialog" id="alerts-dialog" aria-labelledby="alerts-title">
+<div class="alerts-title"><div><div class="eyebrow">DEVAGENT / OPERATOR AWARENESS</div><h2 id="alerts-title">Alarm & Notification Center</h2><p id="alerts-source">NO LIVE SOURCE — current equipment alarm states unknown</p></div><button type="button" id="alerts-close">CLOSE ×</button></div>
+<div class="alerts-summary"><b id="alerts-active">N/A active alarms</b><span id="alerts-evidence">No lab receipt loaded</span></div>
+<div id="alerts-items" class="alerts-items" aria-live="polite"><p class="empty-alerts">No alarm history available. This does not mean the equipment is healthy.</p></div>
+<p class="alerts-disclaimer">LAB REPLAY alerts are demonstration events only. This preview does not acknowledge alarms. It cannot reset a PLC fault or acknowledge an Ignition alarm.</p>
+</dialog>
+<dialog class="engineering-dialog" id="engineering-dialog" aria-labelledby="engineering-title"><div class="engineering-bar"><div><div class="eyebrow">DEVAGENT / ENGINEERING WORKSPACE</div><h2 id="engineering-title">Engineering mapping review</h2><p>Proposed mappings only. Read-only; live source verification and FAT are still pending.</p></div><button type="button" id="engineering-close" class="engineering-close">CLOSE ×</button></div><section class="contracts"><div class="contract-heading"><div><div class="eyebrow">03 / ENGINEERING CONTRACTS</div><h2>Proposed signal and mapping inventory</h2></div><span class="tag warn">ALL LIVE MAPPINGS: NOT VERIFIED</span></div><div class="table-scroll"><table><thead><tr><th>ASSET</th><th>ROLE</th><th>TYPE / UNIT</th><th>OPC UA SOURCE</th><th>QUALIFICATION</th></tr></thead><tbody id="signal-table"></tbody></table></div></section><section class="ops-review" hidden aria-hidden="true"><div class="eyebrow">04 / ISOLATED LAB FAT REPLAY · NO LIVE BINDINGS</div><h2>KPI and alarm logic review</h2><p>Import an independently generated operations receipt for this project's exact tag manifest. The browser only replays evidence; it never reads PLC tags or writes commands. Use <code>ops-demo</code> for synthetic demonstration, or <code>ops-evaluate</code> for approved lab observations.</p><div class="lab-tools"><label class="file-label" for="ops-upload">IMPORT READ-ONLY LAB RECEIPT</label><input id="ops-upload" type="file" accept="application/json,.json"><button id="ops-previous" disabled>◀ PREVIOUS</button><button id="ops-next" disabled>NEXT FRAME ▶</button></div><div id="ops-import-status" role="status">No receipt loaded. All operational KPI values remain N/A.</div><div class="ops-contract-summary" id="ops-contract-summary">Contract is static; Studio/FAT execution pending.</div></section></dialog>
+<footer>DEVAGENT SPATIAL OPERATIONS • PREVIEW IS CONCEPTUAL • THIS IS NOT AN IGNITION EXPORT OR AN AS-BUILT ENGINEERING DRAWING</footer>
+</main>
+</div>
+<script type="application/json" id="project-data">__EMBEDDED_PROJECT__</script>
+<script type="application/json" id="operations-policy">__EMBEDDED_OPERATIONS_POLICY__</script>
+<script type="module" src="./viewer.js"></script>
+</body></html>

devagent_spatial/_resources/assets/viewer.js

@@ -0,0 +1,112 @@
+import { startThree } from './three_scene.js';
+import { startFallback } from './fallback_scene.js';
+import { installOperations } from './operations_ui.js';
+import { startLabFeed } from './runtime_feed.js';
+import { showDeviceControls } from './equipment_controls.mjs';
+const model=JSON.parse(document.getElementById('project-data').textContent);
+const controlPlan=JSON.parse(document.getElementById('control-plan').textContent);
+const $=id=>document.getElementById(id);
+const app={model,selected:null,floor:'all',scene:null};
+document.body.classList.add('layout-'+model.layout);
+document.body.dataset.palette=model.palette||'r9_cyan';
+function setText(id,text){const node=$(id);if(node)node.textContent=String(text);}
+setText('project-name',model.name);setText('m-assets',model.equipment.length);setText('m-signals',model.signals.length);
+setText('system-subtitle',`${model.industry} • ${model.equipment.length} configured assets • ${model.layout.replaceAll('_',' ')}`);
+setText('viewer-title',model.layout==='process_flow'?'Spatial process flow':model.layout==='machine_detail'?'Equipment-focused spatial view':'Spatial material flow');
+setText('viewer-description',`${model.industry} · Interactive equipment overview`);
+const floorCount=new Set(model.equipment.map(e=>e.floor)).size;
+setText('scene-label',`${floorCount} ${floorCount===1?'FLOOR':'FLOORS'} • ${model.equipment.length} ASSETS`);
+for(const f of [...new Set(model.equipment.map(e=>e.floor))].sort((a,b)=>a-b)){const opt=document.createElement('option');opt.value=String(f);opt.textContent=`FLOOR ${String(f).padStart(2,'0')}`;$('floor').append(opt);}
+if(floorCount===1){$('floor').value=String(model.equipment[0].floor);$('floor').disabled=true;}
+// R9-style floor index; always generated from the customer's actual floors.
+const layerIndex=$('layer-index'),layerButtons=$('layer-buttons');
+if(floorCount===1){layerIndex.hidden=true;}else{
+ for(const f of [...new Set(model.equipment.map(e=>e.floor))].sort((a,b)=>b-a)){
+  const count=model.equipment.filter(e=>e.floor===f).length;
+  const b=document.createElement('button');b.type='button';b.className='layer-option';
+  const tag=document.createElement('strong');tag.textContent=String(f).padStart(2,'0');
+  const desc=document.createElement('small');desc.textContent=`FLOOR ${f} · ${count} ASSETS`;
+  b.append(tag,desc);b.addEventListener('click',()=>{
+   $('floor').value=String(f);$('floor').dispatchEvent(new Event('change'));
+  });layerButtons.append(b);
+ }
+}
+
+function pair(label,value){const div=document.createElement('div');div.className='detail-row';const a=document.createElement('label');a.textContent=label;const b=document.createElement('strong');b.textContent=String(value);div.append(a,b);return div;}
+const jump=$('equipment-jump');
+if(jump){for(const floor of [...new Set(model.equipment.map(e=>e.floor))].sort((a,b)=>a-b)){
+ const group=document.createElement('optgroup');group.label=`FLOOR ${String(floor).padStart(2,'0')}`;
+ for(const e of model.equipment.filter(e=>e.floor===floor)){
+  const opt=document.createElement('option');opt.value=e.id;opt.textContent=`${e.id} · ${e.kind}`;group.append(opt);
+ }jump.append(group);
+}jump.addEventListener('change',()=>{if(jump.value)selectAsset(jump.value);});}
+function selectAsset(id){const e=model.equipment.find(x=>x.id===id);if(!e)return;app.selected=id;if(jump)jump.value=id;setText('selected-id',e.id);setText('selected-name',e.name);setText('selected-type',e.kind.toUpperCase());$('asset-meta').replaceChildren(pair('ZONE',e.zone||'—'),pair('FLOOR',e.floor),pair('STATUS','UNKNOWN'),pair('DATA QUALITY','UNKNOWN'));
+const sig=model.signals.filter(s=>s.asset_id===id);if($('selected-parameters')){
+ const rows=[];
+ const add=(name,value)=>rows.push(pair(name,value));
+ if(['conveyor','sorter','spiral'].includes(e.kind)){
+  add('RUN FEEDBACK','SOURCE UNAVAILABLE');add('MOTOR FAULT','SOURCE UNAVAILABLE');
+  add('PE IN','NOT MAPPED');add('PE OUT','NOT MAPPED');
+  add('BELT SPEED (m/s)','NOT MAPPED');
+ }else if(e.kind==='photoeye'){
+  add('PE STATE','SOURCE UNAVAILABLE');add('PE COUNT','SOURCE UNAVAILABLE');
+ }else if(e.kind==='vfd'){
+  add('FREQUENCY (Hz)','SOURCE UNAVAILABLE');add('BELT SPEED','NOT MAPPED');
+ }else if(e.kind==='scanner'){
+  add('LAST SCAN','SOURCE UNAVAILABLE');add('NO_READ COUNT','SOURCE UNAVAILABLE');
+ }
+ const knownLabels=new Set(rows.map(r=>r.firstElementChild.textContent));
+ for(const s of sig){const label=s.role.replaceAll('_',' ').toUpperCase()+(s.unit?' ('+s.unit+')':'');
+  if(!knownLabels.has(label)){add(label,'UNKNOWN · SOURCE NOT VERIFIED');knownLabels.add(label);}}
+ $('selected-parameters').replaceChildren(...rows);
+}
+if(app.scene?.select)app.scene.select(id);
+showDeviceControls(controlPlan,e,$('device-controls'));}
+app.selectAsset=selectAsset;
+const tbody=$('signal-table');if(tbody)for(const s of model.signals){const tr=document.createElement('tr');for(const v of [s.asset_id,s.role,`${s.datatype}${s.unit?' / '+s.unit:''}`,`${s.source.namespace_uri} · ${s.source.node_id}`,'NOT VERIFIED']){const td=document.createElement('td');td.textContent=v;if(v==='NOT VERIFIED')td.className='warning-text';tr.append(td);}tbody.append(tr);}
+if(tbody&&!model.signals.length){const tr=document.createElement('tr');const td=document.createElement('td');td.colSpan=5;td.textContent='No signals provided. Add an OPC UA mapping contract to enable mapping review.';tr.append(td);tbody.append(tr);}
+function attachControls(){for(const [name,fn] of Object.entries({ 'view-fit':()=>app.scene?.overview?.()||app.scene?.view('iso'),'view-top':()=>app.scene?.view('top'),'view-side':()=>app.scene?.view('side'),'view-reset':()=>app.scene?.overview?.()||app.scene?.view('iso')}))$(name).addEventListener('click',()=>{fn();document.querySelectorAll('.viewer-toolbar button').forEach(x=>x.classList.remove('active'));$(name).classList.add('active');});$('floor').addEventListener('change',e=>{app.floor=e.target.value;app.scene?.floor(app.floor);});}
+attachControls();
+// Engineering diagnostics belong only to the separate Studio Test Workspace.
+try{app.scene=await startThree(model,$('scene-layer'),selectAsset);setText('scene-engine','3D VIEW');}
+catch(err){console.warn('Three.js local engine unavailable. Schematic fallback:',err);app.scene=startFallback(model,$('scene-layer'),selectAsset);setText('scene-engine','3D NOT AVAILABLE · SCHEMATIC VIEW');}
+if(model.equipment[0])selectAsset(model.equipment[0].id);
+const operations=installOperations({model,selectAsset,scene:()=>app.scene,policy:JSON.parse($('operations-policy').textContent)});
+const projectId=location.pathname.match(/^\/projects\/([a-z0-9-]+)\/viewer\/index\.html$/)?.[1];
+// Existing buttons remain locked for every non-synthetic source.
+function connectSyntheticOperator(pid){
+ const names=['start','stop','reset','ack'];const buttons=Object.fromEntries(names.map(x=>[x,$('op-cmd-'+x)]));
+ const badge=$('operator-authority');let busy=false;
+ const lock=()=>{for(const b of Object.values(buttons)){b.disabled=true;b.setAttribute('aria-disabled','true');}
+  badge.textContent='🔒 CONTROL LOCKED';badge.classList.remove('sim-linked');};
+ const sync=result=>{
+  if(busy)return;
+  const sim=result?.status==='PASS_SYNTHETIC_PREVIEW_ONLY'&&result?.source==='IN_MEMORY_SYNTHETIC_NOT_OPC';
+  if(!sim){lock();return;}
+  const fault=!!result.fault_asset,paused=!!result.paused;
+  const enabled={start:paused&&!fault,stop:!paused,reset:paused,ack:fault&&!result.acknowledged};
+  for(const n of names){buttons[n].disabled=!enabled[n];buttons[n].setAttribute('aria-disabled',String(!enabled[n]));}
+  badge.textContent='SIMULATOR LINKED · NO PLC';badge.classList.add('sim-linked');
+ };
+ for(const n of names)buttons[n].addEventListener('click',async()=>{
+  if(buttons[n].disabled||busy)return;
+  if(n==='reset'&&!confirm('Reset SYNTHETIC simulation? This clears demo fault and resets parcel position, not a PLC.'))return;
+  busy=true;for(const b of Object.values(buttons))b.disabled=true;
+  try{
+   const response=await fetch('/api/preview-sim/'+encodeURIComponent(pid)+'/operator/'+n,{method:'POST',
+    headers:{'Content-Type':'application/json','X-DevAgent-Operator':'synthetic-session-v1'},
+    body:JSON.stringify({confirm:'SYNTHETIC_OPERATOR_ONLY'})});
+   const data=await response.json();if(!response.ok)throw Error(data.reason||'OPERATOR_SIMULATION_HOLD');
+   badge.textContent='SIM '+n.toUpperCase()+' ACCEPTED · NOT PLC';
+  }catch(e){badge.textContent='SIM HOLD · '+String(e.message||e).slice(0,65);}
+  finally{busy=false;setTimeout(()=>{if(!busy)startOperatorStatus();},250);}
+ });
+ async function startOperatorStatus(){
+  try{const r=await fetch('/api/live-lab/'+encodeURIComponent(pid)+'/readings',{cache:'no-store'});
+   const d=await r.json();sync(d);}catch(_){lock();}
+ }
+ lock();return sync;
+}
+if(projectId){const operatorSync=connectSyntheticOperator(projectId);
+ startLabFeed({operations,projectId,onReading:operatorSync});}
+

devagent_spatial/_resources/design-system.json

@@ -0,0 +1,130 @@
+{
+  "id": "devagent_spatial_v1",
+  "status": "LOCKED_R9_INSPIRED_LAYOUT_PALETTE_ONLY_V043",
+  "inspiration": "User-approved R9 R5 warehouse command-center screenshot, not a byte-copy of its Ignition project",
+  "palette": {
+    "background": "#07131f",
+    "panels": "#0e2638",
+    "deep_panel": "#0b1e2f",
+    "border": "#294b61",
+    "accent": "#58c1dc",
+    "text": "#ecf5ff",
+    "muted": "#82a6b9",
+    "warning": "#e6bd70"
+  },
+  "principles": [
+    "Spatial 3D-first",
+    "Right-side equipment inspector",
+    "Legible KPI cards",
+    "Obvious simulated/unverified markers",
+    "Responsive no clipped typography",
+    "No deceptive live values",
+    "Controls default disabled"
+  ],
+  "layout_archetypes": [
+    "spatial_overview",
+    "process_flow",
+    "machine_detail",
+    "multi_zone"
+  ],
+  "sizing": {
+    "viewport_min_height_px": 510,
+    "inspector_desktop_width_px": 274,
+    "minimum_action_height_px": 42
+  },
+  "golden_reference_status": "R9_R5_VISUAL_REFERENCE_ONLY_NATIVE_IGNITION_RESOURCE_NOT_ATTACHED",
+  "design_standard": "DevAgent Spatial Operations V1 / R9 reference principles",
+  "palette_rules": {
+    "default": "r9_cyan",
+    "allowed": [
+      "r9_cyan",
+      "steel_blue",
+      "teal",
+      "warm_amber"
+    ],
+    "allowed_changes": [
+      "brand background",
+      "decorative panel tones",
+      "decorative accent",
+      "decorative outlines",
+      "conceptual scene lighting tint"
+    ],
+    "immutable": [
+      "font family",
+      "type hierarchy",
+      "KPI grid",
+      "responsive panel hierarchy",
+      "3D-dominant viewport",
+      "right-side inspector on desktop",
+      "equipment selection behavior",
+      "engineering review separation",
+      "equipment topology",
+      "OPC identity",
+      "FAT state",
+      "disabled controls",
+      "semantic running/fault/unknown/warning interpretation"
+    ],
+    "safety_semantics": {
+      "running": "label and verified feedback required",
+      "fault": "label and verified alarm required",
+      "unknown": "unknown quality explicitly indicated",
+      "preview": "no live machine-state claim",
+      "control_authority": "read_only_without_approval"
+    },
+    "color_contrast": "fixed dark backgrounds; light text; palette choices pre-reviewed for readability; browser accessibility verification pending"
+  },
+  "palettes": {
+    "r9_cyan": {
+      "name": "R9 Navy / Cyan",
+      "background": "#07131f",
+      "panel": "#0e2638",
+      "deep": "#0b1e2f",
+      "border": "#294b61",
+      "accent": "#58c1dc",
+      "muted": "#82a6b9",
+      "scene_bg": "#071827",
+      "control_active": "#18536c",
+      "stage_inner": "#12384c",
+      "stage_outer": "#081a2a"
+    },
+    "steel_blue": {
+      "name": "Graphite / Blue",
+      "background": "#0a121e",
+      "panel": "#152638",
+      "deep": "#0d1b2b",
+      "border": "#365573",
+      "accent": "#85c6ff",
+      "muted": "#9fb7cb",
+      "scene_bg": "#0a1727",
+      "control_active": "#224d7a",
+      "stage_inner": "#193750",
+      "stage_outer": "#081522"
+    },
+    "teal": {
+      "name": "Deep Teal / Mint",
+      "background": "#07191d",
+      "panel": "#102c31",
+      "deep": "#092328",
+      "border": "#35656a",
+      "accent": "#75dfce",
+      "muted": "#9abcc0",
+      "scene_bg": "#071c23",
+      "control_active": "#1a6467",
+      "stage_inner": "#164448",
+      "stage_outer": "#061a22"
+    },
+    "warm_amber": {
+      "name": "Graphite / Amber",
+      "background": "#17150f",
+      "panel": "#2b261b",
+      "deep": "#201d17",
+      "border": "#675c45",
+      "accent": "#f5c77b",
+      "muted": "#b8aa90",
+      "scene_bg": "#191c21",
+      "control_active": "#75602d",
+      "stage_inner": "#333a3e",
+      "stage_outer": "#151b23"
+    }
+  }
+}

devagent_spatial/_resources/examples/CV101-command-contract-PENDING.json

@@ -0,0 +1,30 @@
+{
+  "schema": "devagent.device_command_contract.v078",
+  "model_sha256": "816c63dd2a7f59229474e5124bfb58a5b538d400b98231f55aa4b2346d947a0e",
+  "scope": "ISOLATED_FAKE_OPCUA_ONLY",
+  "asset_id": "CV101",
+  "kind": "conveyor",
+  "actions": [
+    "START",
+    "STOP",
+    "RESET"
+  ],
+  "tag_paths": {
+    "request": "[DevAgentLabCommands]VirtualPLC/CV101/CommandRequest",
+    "ack_id": "[DevAgentLabCommands]VirtualPLC/CV101/AckId",
+    "result": "[DevAgentLabCommands]VirtualPLC/CV101/CommandResult",
+    "state": "[DevAgentLabCommands]VirtualPLC/CV101/State",
+    "run_feedback": "[DevAgentLabCommands]VirtualPLC/CV101/RunFeedback",
+    "fault": "[DevAgentLabCommands]VirtualPLC/CV101/Fault",
+    "permissive": "[DevAgentLabCommands]VirtualPLC/CV101/Permissive"
+  },
+  "simulated_namespace_uri": "urn:devagent:isolated:virtual-plc:v078:816c63dd2a7f5922",
+  "engineer": "",
+  "approval": "PENDING_LAB_REVIEW",
+  "timeout_ms": 2500,
+  "role": "Authenticated/Roles/DevAgentLabOperator",
+  "command_identity": "LAB_SYNTHETIC_NOT_CUSTOMER_TAG",
+  "production_mapping": null,
+  "production_authority": "NONE",
+  "note": "Explicit lab-only contract. No customer NodeIds or field authorization."
+}

devagent_spatial/_resources/examples/cv101_guided.json

@@ -0,0 +1,272 @@
+{
+  "schema_version": 1,
+  "name": "Warehouse Line A - CV101 FAT Demo",
+  "industry": "Warehouse Automation",
+  "theme": "devagent_spatial_v1",
+  "palette": "r9_cyan",
+  "layout": "spatial_overview",
+  "description": "Training scenario for one receiving line: CV101 -> CV102 -> CV103, with PE101, PE102, VFD101 and SCN101. All OPC UA NodeIds below are DEMO PLACEHOLDERS, NOT VERIFIED PLC SOURCES. This build is for conceptual HMI and synthetic FAT only.",
+  "equipment": [
+    {
+      "id": "CV101",
+      "name": "Receiving Conveyor",
+      "kind": "conveyor",
+      "floor": 1,
+      "zone": "INFEED",
+      "position": {
+        "x": 0.0,
+        "y": 0.0,
+        "z": 0.0
+      }
+    },
+    {
+      "id": "CV102",
+      "name": "Transfer Conveyor",
+      "kind": "conveyor",
+      "floor": 1,
+      "zone": "TRANSFER",
+      "position": {
+        "x": 6.0,
+        "y": 0.0,
+        "z": 0.0
+      }
+    },
+    {
+      "id": "CV103",
+      "name": "Outfeed Conveyor",
+      "kind": "conveyor",
+      "floor": 1,
+      "zone": "OUTFEED",
+      "position": {
+        "x": 12.0,
+        "y": 0.0,
+        "z": 0.0
+      }
+    },
+    {
+      "id": "PE101",
+      "name": "Receiving Photoeye",
+      "kind": "photoeye",
+      "floor": 1,
+      "zone": "INFEED",
+      "position": {
+        "x": 1.0,
+        "y": 0.0,
+        "z": 1.3
+      }
+    },
+    {
+      "id": "PE102",
+      "name": "Outfeed Photoeye",
+      "kind": "photoeye",
+      "floor": 1,
+      "zone": "OUTFEED",
+      "position": {
+        "x": 13.0,
+        "y": 0.0,
+        "z": 1.3
+      }
+    },
+    {
+      "id": "VFD101",
+      "name": "CV101 Drive",
+      "kind": "vfd",
+      "floor": 1,
+      "zone": "INFEED",
+      "position": {
+        "x": 0.0,
+        "y": 0.0,
+        "z": 2.5
+      }
+    },
+    {
+      "id": "SCN101",
+      "name": "Barcode Scanner",
+      "kind": "scanner",
+      "floor": 1,
+      "zone": "TRANSFER",
+      "position": {
+        "x": 7.0,
+        "y": 0.0,
+        "z": 2.0
+      }
+    }
+  ],
+  "connections": [
+    {
+      "from": "CV101",
+      "to": "CV102"
+    },
+    {
+      "from": "CV102",
+      "to": "CV103"
+    }
+  ],
+  "signals": [
+    {
+      "id": "S_CV101_RUN",
+      "asset_id": "CV101",
+      "role": "run_feedback",
+      "datatype": "Boolean",
+      "unit": "",
+      "polarity": "active_high",
+      "source": {
+        "namespace_uri": "urn:devagent:training:synthetic-warehouse:opcua",
+        "node_id": "Demo/CV101/RunFeedback"
+      },
+      "write_authorized": false
+    },
+    {
+      "id": "S_CV101_FAULT",
+      "asset_id": "CV101",
+      "role": "fault",
+      "datatype": "Boolean",
+      "unit": "",
+      "polarity": "active_high",
+      "source": {
+        "namespace_uri": "urn:devagent:training:synthetic-warehouse:opcua",
+        "node_id": "Demo/CV101/Fault"
+      },
+      "write_authorized": false
+    },
+    {
+      "id": "S_CV102_RUN",
+      "asset_id": "CV102",
+      "role": "run_feedback",
+      "datatype": "Boolean",
+      "unit": "",
+      "polarity": "active_high",
+      "source": {
+        "namespace_uri": "urn:devagent:training:synthetic-warehouse:opcua",
+        "node_id": "Demo/CV102/RunFeedback"
+      },
+      "write_authorized": false
+    },
+    {
+      "id": "S_CV102_FAULT",
+      "asset_id": "CV102",
+      "role": "fault",
+      "datatype": "Boolean",
+      "unit": "",
+      "polarity": "active_high",
+      "source": {
+        "namespace_uri": "urn:devagent:training:synthetic-warehouse:opcua",
+        "node_id": "Demo/CV102/Fault"
+      },
+      "write_authorized": false
+    },
+    {
+      "id": "S_CV103_RUN",
+      "asset_id": "CV103",
+      "role": "run_feedback",
+      "datatype": "Boolean",
+      "unit": "",
+      "polarity": "active_high",
+      "source": {
+        "namespace_uri": "urn:devagent:training:synthetic-warehouse:opcua",
+        "node_id": "Demo/CV103/RunFeedback"
+      },
+      "write_authorized": false
+    },
+    {
+      "id": "S_PE101_BLOCKED",
+      "asset_id": "PE101",
+      "role": "photoeye_blocked",
+      "datatype": "Boolean",
+      "unit": "",
+      "polarity": "active_high",
+      "source": {
+        "namespace_uri": "urn:devagent:training:synthetic-warehouse:opcua",
+        "node_id": "Demo/PE101/Blocked"
+      },
+      "write_authorized": false
+    },
+    {
+      "id": "S_PE102_BLOCKED",
+      "asset_id": "PE102",
+      "role": "photoeye_blocked",
+      "datatype": "Boolean",
+      "unit": "",
+      "polarity": "active_high",
+      "source": {
+        "namespace_uri": "urn:devagent:training:synthetic-warehouse:opcua",
+        "node_id": "Demo/PE102/Blocked"
+      },
+      "write_authorized": false
+    },
+    {
+      "id": "S_VFD101_FREQ",
+      "asset_id": "VFD101",
+      "role": "vfd_frequency",
+      "datatype": "Double",
+      "unit": "Hz",
+      "polarity": "",
+      "source": {
+        "namespace_uri": "urn:devagent:training:synthetic-warehouse:opcua",
+        "node_id": "Demo/VFD101/Frequency"
+      },
+      "write_authorized": false
+    },
+    {
+      "id": "S_VFD101_FAULT",
+      "asset_id": "VFD101",
+      "role": "fault",
+      "datatype": "Boolean",
+      "unit": "",
+      "polarity": "active_high",
+      "source": {
+        "namespace_uri": "urn:devagent:training:synthetic-warehouse:opcua",
+        "node_id": "Demo/VFD101/Fault"
+      },
+      "write_authorized": false
+    },
+    {
+      "id": "S_SCN101_RESULT",
+      "asset_id": "SCN101",
+      "role": "scanner_result",
+      "datatype": "String",
+      "unit": "",
+      "polarity": "",
+      "source": {
+        "namespace_uri": "urn:devagent:training:synthetic-warehouse:opcua",
+        "node_id": "Demo/SCN101/Result"
+      },
+      "write_authorized": false
+    },
+    {
+      "id": "S_SCN101_NOREAD",
+      "asset_id": "SCN101",
+      "role": "no_read_count",
+      "datatype": "Int32",
+      "unit": "count",
+      "polarity": "",
+      "source": {
+        "namespace_uri": "urn:devagent:training:synthetic-warehouse:opcua",
+        "node_id": "Demo/SCN101/NoReadCount"
+      },
+      "write_authorized": false
+    }
+  ],
+  "requirements": [
+    {
+      "id": "R001",
+      "text": "Operator must be able to click CV101 and see run feedback and fault status."
+    },
+    {
+      "id": "R002",
+      "text": "Operator must be able to inspect photoeye PE101 Blocked/Clear status."
+    },
+    {
+      "id": "R003",
+      "text": "Operator must be able to inspect VFD101 actual frequency in Hz if mapped."
+    },
+    {
+      "id": "R004",
+      "text": "Unverified mappings and bad data quality must not be displayed as confirmed PLC values."
+    },
+    {
+      "id": "R005",
+      "text": "Synthetic parcel test must not issue any PLC or OPC UA write commands."
+    }
+  ]
+}