devagent-ignition 0.1.0__py3-none-any.whl

devagent_ignition-0.1.0.dist-info/METADATA

@@ -0,0 +1,204 @@
+Metadata-Version: 2.5
+Name: devagent-ignition
+Version: 0.1.0
+Summary: Offline industrial HMI engineering and Ignition Perspective candidate tools (production deployment not qualified)
+Project-URL: Repository, https://github.com/tomha85/devagent-ignition
+Project-URL: Documentation, https://github.com/tomha85/devagent-ignition#readme
+Author: DevAgent contributors
+Keywords: hmi,ignition,industrial-automation,perspective,scada
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: <3.14,>=3.13
+Description-Content-Type: text/markdown
+
+# DevAgent
+
+**AI-assisted industrial HMI engineering for Ignition Perspective**
+
+DevAgent turns customer plant information into reviewable 2D/3D HMI concepts, validated industrial engineering models, and reproducible **native Ignition Perspective candidates**.
+
+[Quick start](#quick-start) · [Architecture](#architecture) · [Creator workflow](#creator-workflow) · [Ignition handoff](#native-ignition-handoff) · [Verification](#verification)
+
+> **Current scope:** engineering and isolated-lab candidates. Authenticated Gateway import, native Perspective runtime FAT, real OPC UA/PLC mapping validation, and production release have **not** been qualified. Production is **HOLD**.
+
+## Capabilities
+
+| Area | What it provides |
+| --- | --- |
+| **AI-first Creator** | Connect your own supported cloud or local model (BYOM); review proposals before applying them. |
+| **Engineering validation** | Check equipment identities, signal roles, topology, provenance, and requirements using deterministic rules. |
+| **2D + 3D design** | Explore Original V8 2D Flow and Original R9 Four Spirals demos, or generate a customer-specific preview. |
+| **Equipment diagnostics** | Inspect declared motor, VFD, photoeye, fault, quality, and timestamp fields. Missing mappings remain explicit. |
+| **Ignition handoff** | Generate a guarded, read-only native Perspective project candidate from a genuine authorized reference export. |
+| **Simulation + FAT** | Run isolated synthetic OPC UA tests and generate traceable engineering evidence. |
+
+## Architecture
+
+```text
+   CUSTOMER INPUTS
+   Requirements | Equipment | Connections | PLC / tag exports
+                           |
+                           v
+                  BYOM AI AGENT
+                  Proposal + review
+                           |
+                           v
+              ENGINEERING VALIDATION
+         Equipment | Signals | Topology | Safety
+                           |
+            +--------------+---------------+
+            |              |               |
+            v              v               v
+       2D HMI         3D HMI         Native Ignition
+       preview        preview        project candidate
+            |              |               |
+            +--------------+---------------+
+                           |
+                           v
+               ISOLATED LAB + OFFLINE FAT
+                           |
+                    Gateway import
+                    and runtime tests
+                    [NOT YET QUALIFIED]
+                           |
+                           v
+              Real OPC UA source validation
+              Independent FAT / site approval
+                           |
+                           v
+                APPROVED PRODUCTION RELEASE
+                         [HOLD]
+```
+
+**Engineering rule:** AI proposes; deterministic checks validate; simulation and a real test Gateway supply separate evidence; an authorized engineer approves. A synthetic PASS cannot establish physical PLC correctness.
+
+## Quick start
+
+**Requirements:** Linux/Ubuntu, Git, and Python 3.13 (used by the CI workflow). Optional browser and OPC UA tests have additional dependencies.
+
+```bash
+git clone https://github.com/tomha85/devagent-ignition.git
+cd devagent-ignition
+
+sha256sum -c SHA256SUMS.txt
+python3 -m unittest discover -s tests -q
+python3 devagent_hmi.py preflight
+
+# Start the local HMI Creator on port 8895.
+./start.sh
+```
+
+Open **http://127.0.0.1:8895/** on the same computer.
+
+Choose another local port if 8895 is occupied:
+
+```bash
+DEVAGENT_SPATIAL_PORT=8962 ./start.sh
+```
+
+The local Creator does not automatically connect to an Ignition Gateway or modify PLCs. Use `python3 devagent_hmi.py --help` to explore CLI commands.
+
+## Creator workflow
+
+1. **Connect AI (optional).** Choose your own supported provider/model and test the connection. Review all generated drafts; AI responses are not verified engineering facts.
+2. **Describe the site.** Enter plant requirements and provide available equipment, tag, and connection files. See [sample customer inputs](sample_customer_inputs/).
+3. **Choose a starting point.** Select **2D Flow**, **3D Flow**, or **New Project**. The Original V8/R9 options are source-backed demos, not a representation of your plant.
+4. **Analyze and validate.** Resolve contract errors and review any inferred or missing equipment and signal relationships.
+5. **Generate a preview.** Navigate floors, select equipment, and inspect only available diagnostics.
+6. **Review evidence.** Keep synthetic testing separate from real PLC data and qualify the application in an isolated Gateway before production consideration.
+
+Validate a model without launching the UI:
+
+```bash
+python3 devagent_hmi.py validate --model examples/warehouse.json
+```
+
+Other included samples: [single floor](examples/single_floor.json), [warehouse](examples/warehouse.json), and [water treatment](examples/water.json).
+
+### BYOM and data handling
+
+DevAgent supports multiple cloud and local provider adapters, including compatible Ollama/vLLM endpoints. A successful model connection test establishes connectivity, **not engineering correctness**. Follow your organization's rules before sending plant documents, tag exports, or operational data to an external provider.
+
+See [AI provider setup](AGENT_V05.md) for connection details and security limitations.
+
+## Native Ignition handoff
+
+DevAgent includes a Native Ignition Perspective compiler for guarded, read-only offline project candidates. Automated authenticated Gateway deployment: Not implemented; real Gateway runtime FAT and production release remain HOLD.
+
+
+DevAgent can compile an **offline, read-only Perspective candidate**. It does not yet provide a qualified one-click customer deployment or automatically create real OPC UA connections and Gateway tag providers.
+
+The engineering handoff is:
+
+1. Obtain an authorized, genuine Ignition Perspective project export for the template envelope.
+2. Validate the customer model and prepare an engineer-reviewed, lab-scoped binding manifest.
+3. Compile and verify the native candidate against the reference ZIP and source hashes.
+4. Import only into an approved, backed-up **isolated test Gateway**.
+5. Verify actual Perspective rendering, floor/equipment interactions, tag quality, and OPC-to-HMI FAT.
+6. Validate real source identity and site behavior independently before requesting production approval.
+
+Create a pending binding manifest (tag paths are intentionally empty):
+
+```bash
+python3 devagent_hmi.py v07-binding-skeleton \
+  --model examples/warehouse.json \
+  --out /tmp/devagent-pending-lab-bindings.json
+```
+
+The manifest is not preapproved. An engineer must review its model identity, decisions, and any lab paths before compilation. Discover the exact compiler flags with:
+
+```bash
+python3 devagent_hmi.py v083-native-compile --help
+python3 devagent_hmi.py v083-native-verify --help
+```
+
+**Never infer** OPC UA NodeIds, motor/VFD associations, PE IN/OUT semantics, speeds, fault states, or operating quality from a demo.
+
+Read the [native operator/deployment notes](V083_NATIVE_RUNTIME_AND_DEPLOYMENT.md) and [native binding/FAT guide](V07_NATIVE_IGNITION_AND_FAT.md).
+
+## Verification
+
+```bash
+sha256sum -c SHA256SUMS.txt
+python3 -m compileall -q devagent_spatial devagent_hmi.py tests
+python3 -m unittest discover -s tests -q
+python3 devagent_hmi.py preflight
+```
+
+GitHub Actions: [.github/workflows/offline-ci.yml](.github/workflows/offline-ci.yml). Its CI jobs cover offline tests, static checks, a browser workflow, and isolated synthetic OPC UA tests. **CI PASS is not a live Gateway FAT or site-acceptance result.**
+
+### Current qualification boundaries
+
+| Gate | State |
+| --- | --- |
+| Creator 2D/3D reference previews | Implemented; local/browser validation |
+| Native Perspective candidate and offline vendor parsing | Offline PASS |
+| Isolated synthetic OPC UA protocol checks | Lab-only evidence |
+| Authenticated Gateway project import and native rendering | **HOLD** |
+| Gateway-connected OPC -> tag -> HMI FAT | **HOLD** |
+| Real customer PLC mappings and SAT | **HOLD** |
+| Production release | **HOLD** |
+
+Unavailable values must show **NOT MAPPED**, **UNKNOWN**, or a clear BAD/STALE quality indication, not fabricated operating states. START/STOP/RESET actions remain disabled in the unqualified native operator candidate.
+
+## Repository guide
+
+| Path | Purpose |
+| --- | --- |
+| `devagent_hmi.py`, `start.sh` | CLI and local Creator entry points |
+| `devagent_spatial/` | Models, validators, native compiler, simulator, FAT infrastructure |
+| `assets/` | Creator UI and HMI visualization |
+| `reference/` | Preserved Original V8 and R9 reference sources |
+| `examples/`, `templates/`, `sample_customer_inputs/` | Starter plant inputs |
+| `tests/`, `scripts/` | Regression and engineering verification |
+| `.github/workflows/` | Offline CI automation |
+
+For engineering detail, see the [qualification record](V083_QUALIFICATION.json), [native import milestone](V083_NATIVE_IMPORT_MILESTONE.md), and [production acceptance gates](PRODUCTION_ACCEPTANCE.md). Historical milestones remain in separate documentation; this README is the starting point.
+
+---
+
+**DevAgent's purpose:** faster, more repeatable industrial HMI engineering with explicit signal provenance, deterministic verification, and evidence-based commissioning.

devagent_ignition-0.1.0.dist-info/RECORD

@@ -0,0 +1,133 @@
+devagent_hmi.py,sha256=ufpKCVZl-4iTM1OoOYmg7c77QWBRkhUN7zVwcKtWtms,29945
+devagent_spatial/__init__.py,sha256=IMjkMO3twhQzluVTo8Z6rE7Eg-9U79_LGKMcsWLKBkY,22
+devagent_spatial/agent_harness.py,sha256=prGiqX4uwx4t5_TFdrlIL2bTqn-zVrBvBHW80iHdgRY,15379
+devagent_spatial/agent_runtime.py,sha256=pUwiu2Tl_2uNcgvESnPYUTiPP1Wty6D18XCYNJiV8qQ,18945
+devagent_spatial/contract_opc_fat.py,sha256=9X5Y9ZarU5W1qWkhWMykOGbeMuyfjQe97DY6NmEOPSs,10663
+devagent_spatial/contract_opc_source.py,sha256=7U7Kw_ZvESW2r1hxSreG4w4UnWEQ68JcxG_CQelN45s,12878
+devagent_spatial/control_intents.py,sha256=WidHq5Qq0KsLd9q-9pf8EMkRf4DW87oTTuKosX94_tk,1587
+devagent_spatial/customer_intake.py,sha256=l2LtiZWmhNoWd0r3uIQOL2NZrpEo1ucxba6JkHv25h8,13180
+devagent_spatial/engineering_expertise.py,sha256=kilx4k0HK_0hg25G5LQh3VfDoT4cTYwEbsd07GxmWII,5491
+devagent_spatial/generator.py,sha256=aSkEC3ALKSsfDstjQPni3UN4w_m__QLjS9krBqdBV1Q,12523
+devagent_spatial/ignition_native.py,sha256=qvn2cczJUMX9ygyZOAp6YZGw-bMbMcekizvGgmhHgIw,13307
+devagent_spatial/ignition_project.py,sha256=nUC_73AoruK-rgJCDTauKIs4OAyvDXYbmQxn0eTDdoM,7654
+devagent_spatial/live_lab_binding.py,sha256=rZTy03Q3_8lCO3j6qZ1Bi8JpaigENRrchI4OrKo_wcM,6806
+devagent_spatial/model.py,sha256=ew7hkP7kGEYSNAC1iMqYhqnirCpidgtmnDNFTLEflFY,17289
+devagent_spatial/native_reference.py,sha256=CPJaY2rCblEBrBpvvVLY1KwgvjnU7HV1iyT-OgcLxR8,3250
+devagent_spatial/opc_snapshot.py,sha256=jqcpHKhkLT5TP1S1P8lak2JcaaqEc8VKm9AECxvVATI,4237
+devagent_spatial/operations.py,sha256=69gwR5B1pB3Jqtm2k3sSiutX7sma5fg6UyP8kQ2s9IU,15342
+devagent_spatial/operations_capture.py,sha256=yucsozZEx3Ffr0naAhsiH_CpxJSAO6KJPMD7ZqbBlGI,2774
+devagent_spatial/operations_lab.py,sha256=UYdkpEC9xVL3CeyPQ4jpfn2g-ujbwxFdyj7NhDwsvYM,3884
+devagent_spatial/original_r9.py,sha256=B5RXFQxFpqaHHp4PBzrHcs3UjrRmnKNjUgK9yUWDgM4,7402
+devagent_spatial/original_v8.py,sha256=u08uDJoFm5uhdu659bMPoRzMojI5owZAtwwSW-101OI,3041
+devagent_spatial/preflight.py,sha256=P4VgRVwRwxlsMGwmrR1cwfB1Tr_JGCrSVsv__tMXhzE,8058
+devagent_spatial/preview_simulation.py,sha256=kkK5KMVKHe8ETIU3vMfCIBiSo4G1D2GsPrKl0CIr4w4,11018
+devagent_spatial/project_package.py,sha256=tjwjKpIYpsfcNQ-FEK8My5169htv-8RIkYrgpL6u8H0,6049
+devagent_spatial/qualification.py,sha256=dMv7F5wzMEhR2t5DaH1v9wddcjBeaW2rfV3hJrDsJT4,9945
+devagent_spatial/strict_json.py,sha256=Bbk-DxPy5ZJRvtBml1lEo6IfCEpkR-pWB8hiDA5Imu8,906
+devagent_spatial/studio.py,sha256=zPSQ0oOsE7jwOs1Q_Ozv6JFDAeZPTM0k1dt3LBSkb2w,60344
+devagent_spatial/studio_workflow.py,sha256=f1hBDLoP0g--ub51sK_a0rtEPrNh61EKn9eNJQFF4h4,14977
+devagent_spatial/test_reporting.py,sha256=6AWK8dvgnYd3ABRLQUUUQMD-5GAv_89li0l7NO_psws,5430
+devagent_spatial/v076_opc_fat.py,sha256=i_DW1rohPgYjwRFeX6Kaan6uDlEKSSGmNyf0R7ld-vY,9597
+devagent_spatial/v078_commands.py,sha256=rkju68wOHfKpO8pB1jRMF8ZrGe-LSS9q9B183VVLhj8,15866
+devagent_spatial/v078_native_commands.py,sha256=uisRR9GHEmbGFQ4imjX8QTKrSShg0vrkDMyKMfFCTbY,9112
+devagent_spatial/v07_fat.py,sha256=QmnotB8GmCuZrG8NbXoqAn47skRW9XUsH2-4-Hn3KuI,6474
+devagent_spatial/v07_native.py,sha256=5Kwdi-A7SfdqufL6HSYWlgSba_kZ4czaVp7-gLhsgec,18369
+devagent_spatial/v083_native.py,sha256=yd5EyeCbi-USHB1Pz1xZK1du6PX8FXLX9lmZrZqarlQ,19947
+devagent_spatial/_resources/README.md,sha256=bMNeqVWfAUcImAS9t3nImjxMgqPsZnIcvjAptWYNy7s,9374
+devagent_spatial/_resources/RELEASE_MANIFEST.json,sha256=rEgb-z-UJ2JtwkI3AxnU6I54ceXsIlGNPDvZkzPChvI,19880
+devagent_spatial/_resources/SHA256SUMS.txt,sha256=Eko3tQ2zURLZS5a2C1KBHQ1CRQIOC7s--NhpYGStldw,26712
+devagent_spatial/_resources/SOURCE_PROVENANCE.json,sha256=TJ5Uph5h8-s-BxY-Vd7VOcVO34ZHHyqFO3zTxsi3yYw,9989
+devagent_spatial/_resources/assets/agent.js,sha256=J0RC48LhRDjRcZ72NjqyL8TIpQ0X9KF7WcGgp8MQpKU,7236
+devagent_spatial/_resources/assets/creator.css,sha256=bXtaj-jEdQ105NwaHgwlkwOTaOjFMxPkkJxGlQ-DIpw,46148
+devagent_spatial/_resources/assets/creator_2d.mjs,sha256=6eCbUo6kr7CpDxf-Q-qdZV0TN3gMqOKlWDvjSSIbb5M,1529
+devagent_spatial/_resources/assets/creator_original_r9.mjs,sha256=MWjAB69iuLJMWTyGyI7kEG87vlIP30NXrueETt_tMEc,3456
+devagent_spatial/_resources/assets/creator_original_v8.mjs,sha256=M6yMW68dr2zJ2kQKeb8dj9XCNo7iyKMVh7tPx1ncFtE,7744
+devagent_spatial/_resources/assets/creator_r9_diagnostics.mjs,sha256=4yUWNJSAfam-Bo7ED_21LbmezfLCwntni4DfRGK92qY,2408
+devagent_spatial/_resources/assets/creator_scene.mjs,sha256=5cPlWyGXE88VkHfGQnsozUXbAB6onEmOxFkenx4BYKY,14056
+devagent_spatial/_resources/assets/creator_ui.mjs,sha256=le8gWK9e3sFN5o2YxILwF44TsbV1_hsFVVdkE99FPvk,4854
+devagent_spatial/_resources/assets/customer_documents.js,sha256=D414_Q02wOLJaaD-qFZ5AiRks-7JPLRMOOdVcRDt2mI,7439
+devagent_spatial/_resources/assets/equipment_controls.mjs,sha256=jjAARnKZg596dT-fClmgjJqJ67aLu8AWYYAglzpvexI,1743
+devagent_spatial/_resources/assets/facility2d.css,sha256=_j09yuMVF0FPaEhN-_x6_RCK4mZCrBb1OLHSL53H13s,7001
+devagent_spatial/_resources/assets/facility2d_app.mjs,sha256=q0DL7AcfIYLp4cx_vVRrlDYV1QiuIp3h3JkW3WOdFm4,5923
+devagent_spatial/_resources/assets/facility2d_core.mjs,sha256=YXjR_Uq3KSnI4h48Fijr0n10M1FtsV1G6JoIQsy8oao,8735
+devagent_spatial/_resources/assets/facility2d_simulation.mjs,sha256=UqRJ8pcZWpmx51DTD7jOVZTIWrazcn8uGtU1a6aq5Ro,8596
+devagent_spatial/_resources/assets/facility2d_viewer.html,sha256=JLeH0IQGTEqgiu7jH2lKm3Gj1taNph570KIRaoKoSko,5621
+devagent_spatial/_resources/assets/fallback_scene.js,sha256=6hHZ_ox3Aqc6vyKm1oHbML2i24DUgXMt-grIJOh6HOM,4018
+devagent_spatial/_resources/assets/flow_geometry.mjs,sha256=olCjJ3rsU0fq-7SYIiA45wY_jVb-Cw55dCZ3f5p32S0,11549
+devagent_spatial/_resources/assets/harness.js,sha256=Kb1rTodGDxNJHwwYMLZW2JQTZBHpAY4RG4xiMLlTAmQ,5536
+devagent_spatial/_resources/assets/live_design_review.js,sha256=nFyy9wGG5bRQy4wGNdQOgszdQ3MnmxkVaxbkX4KABRs,10097
+devagent_spatial/_resources/assets/operations_ui.js,sha256=cUv5vyJnlqmhVMD9im6uojqECw9jYSS0ugDi4zql4cE,20838
+devagent_spatial/_resources/assets/operator_viewer.html,sha256=zTaaLShLUBd-6UetrFSkewNeKIvL2lxHSG4s9nIOQsU,7958
+devagent_spatial/_resources/assets/project_package.js,sha256=ZRq6ZclViDWBJo56qeB7Jf46d6KlFAM4piSqMv6roh0,3408
+devagent_spatial/_resources/assets/r9_transport.mjs,sha256=jl2FBaw8hN-CL_kMnQQIPObezk5RRIqE5y363dpHusA,3783
+devagent_spatial/_resources/assets/runtime_feed.js,sha256=xrR5QaL_5y0pfTKYmbJS-JiQSg83wVkmie64HggVFHw,1754
+devagent_spatial/_resources/assets/studio.html,sha256=bw3MnyGEVbcIVS2qBTayr7LWi0CVoaaVbyFHwymm_y8,37810
+devagent_spatial/_resources/assets/style.css,sha256=yfh2JDhrvoSrfXH5NwjwD5Gmng2Wk3OM_uUZE-WDH98,23053
+devagent_spatial/_resources/assets/test_workspace.html,sha256=_Q0H3eyHLeJcTkhVc9WqWwx6LDE3qT5lxkBrY3-tetc,27608
+devagent_spatial/_resources/assets/three_scene.js,sha256=17hvfPbSLgjy_gDFk9udIN355GvblFeB2K_qevP_Jog,31125
+devagent_spatial/_resources/assets/unified_engineer.js,sha256=ryP4bvUeGN_JQ1Xnf-n7UlcNsURm0F1tre3t8XRY_iU,9273
+devagent_spatial/_resources/assets/v076_fat_ui.js,sha256=T9_-bp-yr3V0W46EE7fq9BbmGVLIyCvv3otYT7Z5n5A,2327
+devagent_spatial/_resources/assets/v078_command_ui.js,sha256=0An3mnntEniRHIGBi5en285yRktZm7APYRa4Hhsfm1w,2819
+devagent_spatial/_resources/assets/viewer.html,sha256=nZWUF1W3P8Fqqg74rwVQ7mTxXWDW83kusA2ChEpIp1s,9730
+devagent_spatial/_resources/assets/viewer.js,sha256=YA0jZJZZ_ZtDXmuCilsZG5XK5yF4Sy7tTXWUt4O1ZoE,8932
+devagent_spatial/_resources/design-system.json,sha256=VO53yjVYmwa9CTIEyeWyjqu2moshWO8b5YlzhtNnbD8,3735
+devagent_spatial/_resources/examples/CV101-command-contract-PENDING.json,sha256=Fs8za7dIf6a9yf9N6UOiETsyf6qZE7NlW_0AptPX_5M,1190
+devagent_spatial/_resources/examples/cv101_guided.json,sha256=sCK2t0jnH9rM4jxkPFNMfitKkXTXO5l25NLKMFp2d4g,6679
+devagent_spatial/_resources/examples/make_examples.py,sha256=CxLXsZW9DlvminCDxUbi1IqgB9AE2TyJ5ybALJWwOEY,5129
+devagent_spatial/_resources/examples/single_floor.json,sha256=3Og0IV9B_ZLi8hzurY-5Gi5NBgIdxL9ow4NMhss8BaM,10453
+devagent_spatial/_resources/examples/v0771_training_wizard.json,sha256=htr2YT9kaf7nOpebbMXG_R7_4UKxNRAdObGzdyC8bwY,8394
+devagent_spatial/_resources/examples/warehouse-3floor-standard-2d.json,sha256=wgHAQBizphPv118tDn43SDonFy3HTFjL1pWFbouq52M,16128
+devagent_spatial/_resources/examples/warehouse-operations-synthetic.json,sha256=RQX11EsFtEwliPJYo8TYm86QdYqZqc8jRxAR01ihH-w,34052
+devagent_spatial/_resources/examples/warehouse-v07-lab-bindings-PENDING.json,sha256=SNT5kFDtOpCYTV_SKlKXQJeN2PTJrVPltE-ilaUYpbk,10653
+devagent_spatial/_resources/examples/warehouse.json,sha256=4PKUleQu0-XTueKBnPxG8qlicF0eUulsbJ94Cdv_O1I,16115
+devagent_spatial/_resources/examples/water.json,sha256=0v8aaZN-h7-nefVduzw2IDrXiO7LgcJG-lqingfAZsE,6436
+devagent_spatial/_resources/reference/r9-golden/REFERENCE_SHA256.json,sha256=Np8KOngL4FtraNYTiYfwW3HB4_AnE-cjOje4goydibU,777
+devagent_spatial/_resources/reference/r9-golden/web/app.mjs,sha256=N0IJFGmNSmoia7libD8QJviglEtaiKpUou1SL-FDK7k,53852
+devagent_spatial/_resources/reference/r9-golden/web/index.html,sha256=ISzemao0hFGT5tOb6dPv2ahycLSl7mkSK_6xpOB4JYU,17727
+devagent_spatial/_resources/reference/r9-golden/web/lab_panel.mjs,sha256=qX1aw7jFC5HQXWlzOdWXXM064ww6uiKXECpbXpnPjW8,3701
+devagent_spatial/_resources/reference/r9-golden/web/model.mjs,sha256=Ke6QrgvqI3j4XQnN081HOSGjw0BnQxlGdO9XpAgQrnk,20936
+devagent_spatial/_resources/reference/r9-golden/web/state_adapter.mjs,sha256=RLsKuAer5g4KwgyhZpIQAWk3BJRB9815plMK_KtUx2w,4511
+devagent_spatial/_resources/reference/r9-golden/web/styles.css,sha256=DwEyJBzLYdYpCFNVv424fE5X_CO3S9xF_A8esQ7oYog,18156
+devagent_spatial/_resources/reference/r9-original/README_R9.md,sha256=mH_xQoYtqUB-2ALcgY2TJkHY1Rg3J_8Qob2b9zmRYXs,2276
+devagent_spatial/_resources/reference/r9-original/SHA256SUMS.txt,sha256=Ef4yoFVgYbQTZazNVS95yaPa0ZVVAwj49A1V5bdBWsA,5882
+devagent_spatial/_resources/reference/r9-original/SNAPSHOT_SHA256SUMS.txt,sha256=wXEnEqteNfkTsn-QbiPeyiy6upuHN9cFl1pkiktJWSw,1375
+devagent_spatial/_resources/reference/r9-original/flow_routes.json,sha256=lS_OY7EyMWzrd2XoxvMSlHRjHxb0m7FZ_8xoP9HXZy0,9730
+devagent_spatial/_resources/reference/r9-original/flow_sim.py,sha256=8SDkCIbr1Gv8VwfxWto7lEl6jxVzEr2Tou_-2SsZUNg,7281
+devagent_spatial/_resources/reference/r9-original/lab_control.py,sha256=GP4TQavGF_lNSjSbgUcdZhKs_dojLq-g_E1E_Q3X00s,3622
+devagent_spatial/_resources/reference/r9-original/web/app.mjs,sha256=N0IJFGmNSmoia7libD8QJviglEtaiKpUou1SL-FDK7k,53852
+devagent_spatial/_resources/reference/r9-original/web/index.html,sha256=ISzemao0hFGT5tOb6dPv2ahycLSl7mkSK_6xpOB4JYU,17727
+devagent_spatial/_resources/reference/r9-original/web/lab_panel.mjs,sha256=qX1aw7jFC5HQXWlzOdWXXM064ww6uiKXECpbXpnPjW8,3701
+devagent_spatial/_resources/reference/r9-original/web/model.mjs,sha256=Ke6QrgvqI3j4XQnN081HOSGjw0BnQxlGdO9XpAgQrnk,20936
+devagent_spatial/_resources/reference/r9-original/web/state_adapter.mjs,sha256=RLsKuAer5g4KwgyhZpIQAWk3BJRB9815plMK_KtUx2w,4511
+devagent_spatial/_resources/reference/r9-original/web/styles.css,sha256=DwEyJBzLYdYpCFNVv424fE5X_CO3S9xF_A8esQ7oYog,18156
+devagent_spatial/_resources/reference/r9-original/web/vendor/LICENSE-three.txt,sha256=v-EZ6k_UE_X3yj_NY62wxKBz7Tnaov59Pmt2niEnJgE,1081
+devagent_spatial/_resources/reference/r9-original/web/vendor/SHA256SUMS.txt,sha256=4KqZPHr7SpEERhWAEvfk6gd3Y0iZhtbEeCSAK8JCaHE,345
+devagent_spatial/_resources/reference/r9-original/web/vendor/three.core.js,sha256=6wd9JBf2HT5tkmTDF8q8TqNXae1rCrUzBnKSpVB4TCA,1403455
+devagent_spatial/_resources/reference/r9-original/web/vendor/three.module.js,sha256=yCEcaTRdLplJ3HqKyWk4BJeqBgClqKxqRZyM0C3Zy4o,603113
+devagent_spatial/_resources/reference/r9-original/web/vendor/addons/controls/OrbitControls.js,sha256=uXh5x0gXC6res_uEzqH_30Z04oPcBgQvNOKsuVp2BCw,38703
+devagent_spatial/_resources/reference/v8-original/README.md,sha256=3UAyNg4QwVl9g5puhPPFKM1LZOErZ_JxdEzVMsuMo3M,3454
+devagent_spatial/_resources/reference/v8-original/SHA256SUMS.txt,sha256=4zwJjVlMqtELjwMA-VXr09OVi9xDD5k0-sbtF4-lYlg,963
+devagent_spatial/_resources/reference/v8-original/model.py,sha256=fOU9vqF24_m581ZpX_6oVenW4z-7ffv3tlndSEsFpR0,7657
+devagent_spatial/_resources/reference/v8-original/run_demo.sh,sha256=Nzo08ek2IdbacdSqV9CSOkzMUnTbn1C_0LsDFw6-3Jo,105
+devagent_spatial/_resources/reference/v8-original/server.py,sha256=QTkqi5Zl6TuqZn6U5_3F2Cx8SF2GVREum3NpX0fQRoU,4052
+devagent_spatial/_resources/reference/v8-original/topology.json,sha256=ETfM5rg8WU_xvj6q7dwhCni29bf-Lb6vcVHyKJZO278,2968
+devagent_spatial/_resources/reference/v8-original/tests/browser_smoke.py,sha256=4cg0LXFCQzqVOw4U7g6bJId8trFvJt0lG0ABsiPpzJQ,2940
+devagent_spatial/_resources/reference/v8-original/tests/test_v8.py,sha256=dfE2efrLk5V39OIrzfKr-D90F39wOuwFalFgd47YqXY,9408
+devagent_spatial/_resources/reference/v8-original/web/app.js,sha256=uC_gCVnEPzn8ZYroyJ-wP8K2FknUq8MEcdN-vLsaFRw,16535
+devagent_spatial/_resources/reference/v8-original/web/index.html,sha256=hw8tPPWRPTXvb0bH6FPDpyg-ZYiHeNQOZM9q5koJn5I,7245
+devagent_spatial/_resources/reference/v8-original/web/simulator.html,sha256=qy2Yo6aUSRPh1c41q58W3BLWAH-aDKRyiz9j_MKtCWY,2283
+devagent_spatial/_resources/reference/v8-original/web/simulator.js,sha256=J1h1LXRrdors07ihwqmeyJhQc3lRNoPxiEfw2CUiKZ4,1391
+devagent_spatial/_resources/reference/v8-original/web/style.css,sha256=4UtzdjgQK9lUksuUhRvEDqZQL1dPw_LAyL5tulCG-qM,18427
+devagent_spatial/_resources/sample_customer_inputs/Plant_Equipment_Register.csv,sha256=ikv4xW4bOhVz03I5WTuKa2Aw--3DgaoSvCRs1TIQptQ,184
+devagent_spatial/_resources/sample_customer_inputs/Plant_Flow_Requirements.txt,sha256=1pyr1t52mSym4KuqLBbK_nC3XHGiWZg1vlnXVIMEq98,258
+devagent_spatial/_resources/sample_customer_inputs/Raw_PLC_Tag_Export.csv,sha256=8s8g72IYpnU9FUX-g4p6SIZbeQflL0TmBJu0JUhPTxw,159
+devagent_spatial/_resources/templates/warehouse_connections.csv,sha256=J8rzayQF6dxvdUC7N19M--CC3RjqGEFr-wmb2GCRDfk,173
+devagent_spatial/_resources/templates/warehouse_equipment.csv,sha256=BqZtUlnQZCTRbLr5rnhOHgp37GcZS2aqS7bQ34B3U8k,1056
+devagent_spatial/_resources/templates/warehouse_signals.csv,sha256=vJRV1Ttmo5BYj6oamXmTQydkNbvVlPlYHe5Ymvzxbfs,3915
+devagent_spatial/_resources/templates/water_connections.csv,sha256=iIfhjIabKr9j-W-9ZFSW5_8jpGIhfYQ7vZBNwO9EG8g,106
+devagent_spatial/_resources/templates/water_equipment.csv,sha256=16LyfrVDeEDGUNiZs9kf4_uu5_xiWAWYxWYxXVzRwwg,540
+devagent_spatial/_resources/templates/water_signals.csv,sha256=HYYqfWkUHQAwsKlmDytsB47gFaMvu1xwY0a0NkZ5YIY,1391
+devagent_ignition-0.1.0.dist-info/METADATA,sha256=S0Gv361ul4LmalorF2E2XpESdHcIhW98_aVUCUKAxGE,10141
+devagent_ignition-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+devagent_ignition-0.1.0.dist-info/entry_points.txt,sha256=37tZx1Q0GOPhnYPOFow9609d3tMqrNMZqqXKtPPszdU,47
+devagent_ignition-0.1.0.dist-info/RECORD,,

devagent_ignition-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

devagent_ignition-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+devagent = devagent_hmi:main

devagent_spatial/__init__.py

@@ -0,0 +1 @@
+__version__ = '0.1.0'

devagent_spatial/_resources/README.md

@@ -0,0 +1,187 @@
+# DevAgent
+
+**AI-assisted industrial HMI engineering for Ignition Perspective**
+
+DevAgent turns customer plant information into reviewable 2D/3D HMI concepts, validated industrial engineering models, and reproducible **native Ignition Perspective candidates**.
+
+[Quick start](#quick-start) · [Architecture](#architecture) · [Creator workflow](#creator-workflow) · [Ignition handoff](#native-ignition-handoff) · [Verification](#verification)
+
+> **Current scope:** engineering and isolated-lab candidates. Authenticated Gateway import, native Perspective runtime FAT, real OPC UA/PLC mapping validation, and production release have **not** been qualified. Production is **HOLD**.
+
+## Capabilities
+
+| Area | What it provides |
+| --- | --- |
+| **AI-first Creator** | Connect your own supported cloud or local model (BYOM); review proposals before applying them. |
+| **Engineering validation** | Check equipment identities, signal roles, topology, provenance, and requirements using deterministic rules. |
+| **2D + 3D design** | Explore Original V8 2D Flow and Original R9 Four Spirals demos, or generate a customer-specific preview. |
+| **Equipment diagnostics** | Inspect declared motor, VFD, photoeye, fault, quality, and timestamp fields. Missing mappings remain explicit. |
+| **Ignition handoff** | Generate a guarded, read-only native Perspective project candidate from a genuine authorized reference export. |
+| **Simulation + FAT** | Run isolated synthetic OPC UA tests and generate traceable engineering evidence. |
+
+## Architecture
+
+```text
+   CUSTOMER INPUTS
+   Requirements | Equipment | Connections | PLC / tag exports
+                           |
+                           v
+                  BYOM AI AGENT
+                  Proposal + review
+                           |
+                           v
+              ENGINEERING VALIDATION
+         Equipment | Signals | Topology | Safety
+                           |
+            +--------------+---------------+
+            |              |               |
+            v              v               v
+       2D HMI         3D HMI         Native Ignition
+       preview        preview        project candidate
+            |              |               |
+            +--------------+---------------+
+                           |
+                           v
+               ISOLATED LAB + OFFLINE FAT
+                           |
+                    Gateway import
+                    and runtime tests
+                    [NOT YET QUALIFIED]
+                           |
+                           v
+              Real OPC UA source validation
+              Independent FAT / site approval
+                           |
+                           v
+                APPROVED PRODUCTION RELEASE
+                         [HOLD]
+```
+
+**Engineering rule:** AI proposes; deterministic checks validate; simulation and a real test Gateway supply separate evidence; an authorized engineer approves. A synthetic PASS cannot establish physical PLC correctness.
+
+## Quick start
+
+**Requirements:** Linux/Ubuntu, Git, and Python 3.13 (used by the CI workflow). Optional browser and OPC UA tests have additional dependencies.
+
+```bash
+git clone https://github.com/tomha85/devagent-ignition.git
+cd devagent-ignition
+
+sha256sum -c SHA256SUMS.txt
+python3 -m unittest discover -s tests -q
+python3 devagent_hmi.py preflight
+
+# Start the local HMI Creator on port 8895.
+./start.sh
+```
+
+Open **http://127.0.0.1:8895/** on the same computer.
+
+Choose another local port if 8895 is occupied:
+
+```bash
+DEVAGENT_SPATIAL_PORT=8962 ./start.sh
+```
+
+The local Creator does not automatically connect to an Ignition Gateway or modify PLCs. Use `python3 devagent_hmi.py --help` to explore CLI commands.
+
+## Creator workflow
+
+1. **Connect AI (optional).** Choose your own supported provider/model and test the connection. Review all generated drafts; AI responses are not verified engineering facts.
+2. **Describe the site.** Enter plant requirements and provide available equipment, tag, and connection files. See [sample customer inputs](sample_customer_inputs/).
+3. **Choose a starting point.** Select **2D Flow**, **3D Flow**, or **New Project**. The Original V8/R9 options are source-backed demos, not a representation of your plant.
+4. **Analyze and validate.** Resolve contract errors and review any inferred or missing equipment and signal relationships.
+5. **Generate a preview.** Navigate floors, select equipment, and inspect only available diagnostics.
+6. **Review evidence.** Keep synthetic testing separate from real PLC data and qualify the application in an isolated Gateway before production consideration.
+
+Validate a model without launching the UI:
+
+```bash
+python3 devagent_hmi.py validate --model examples/warehouse.json
+```
+
+Other included samples: [single floor](examples/single_floor.json), [warehouse](examples/warehouse.json), and [water treatment](examples/water.json).
+
+### BYOM and data handling
+
+DevAgent supports multiple cloud and local provider adapters, including compatible Ollama/vLLM endpoints. A successful model connection test establishes connectivity, **not engineering correctness**. Follow your organization's rules before sending plant documents, tag exports, or operational data to an external provider.
+
+See [AI provider setup](AGENT_V05.md) for connection details and security limitations.
+
+## Native Ignition handoff
+
+DevAgent includes a Native Ignition Perspective compiler for guarded, read-only offline project candidates. Automated authenticated Gateway deployment: Not implemented; real Gateway runtime FAT and production release remain HOLD.
+
+
+DevAgent can compile an **offline, read-only Perspective candidate**. It does not yet provide a qualified one-click customer deployment or automatically create real OPC UA connections and Gateway tag providers.
+
+The engineering handoff is:
+
+1. Obtain an authorized, genuine Ignition Perspective project export for the template envelope.
+2. Validate the customer model and prepare an engineer-reviewed, lab-scoped binding manifest.
+3. Compile and verify the native candidate against the reference ZIP and source hashes.
+4. Import only into an approved, backed-up **isolated test Gateway**.
+5. Verify actual Perspective rendering, floor/equipment interactions, tag quality, and OPC-to-HMI FAT.
+6. Validate real source identity and site behavior independently before requesting production approval.
+
+Create a pending binding manifest (tag paths are intentionally empty):
+
+```bash
+python3 devagent_hmi.py v07-binding-skeleton \
+  --model examples/warehouse.json \
+  --out /tmp/devagent-pending-lab-bindings.json
+```
+
+The manifest is not preapproved. An engineer must review its model identity, decisions, and any lab paths before compilation. Discover the exact compiler flags with:
+
+```bash
+python3 devagent_hmi.py v083-native-compile --help
+python3 devagent_hmi.py v083-native-verify --help
+```
+
+**Never infer** OPC UA NodeIds, motor/VFD associations, PE IN/OUT semantics, speeds, fault states, or operating quality from a demo.
+
+Read the [native operator/deployment notes](V083_NATIVE_RUNTIME_AND_DEPLOYMENT.md) and [native binding/FAT guide](V07_NATIVE_IGNITION_AND_FAT.md).
+
+## Verification
+
+```bash
+sha256sum -c SHA256SUMS.txt
+python3 -m compileall -q devagent_spatial devagent_hmi.py tests
+python3 -m unittest discover -s tests -q
+python3 devagent_hmi.py preflight
+```
+
+GitHub Actions: [.github/workflows/offline-ci.yml](.github/workflows/offline-ci.yml). Its CI jobs cover offline tests, static checks, a browser workflow, and isolated synthetic OPC UA tests. **CI PASS is not a live Gateway FAT or site-acceptance result.**
+
+### Current qualification boundaries
+
+| Gate | State |
+| --- | --- |
+| Creator 2D/3D reference previews | Implemented; local/browser validation |
+| Native Perspective candidate and offline vendor parsing | Offline PASS |
+| Isolated synthetic OPC UA protocol checks | Lab-only evidence |
+| Authenticated Gateway project import and native rendering | **HOLD** |
+| Gateway-connected OPC -> tag -> HMI FAT | **HOLD** |
+| Real customer PLC mappings and SAT | **HOLD** |
+| Production release | **HOLD** |
+
+Unavailable values must show **NOT MAPPED**, **UNKNOWN**, or a clear BAD/STALE quality indication, not fabricated operating states. START/STOP/RESET actions remain disabled in the unqualified native operator candidate.
+
+## Repository guide
+
+| Path | Purpose |
+| --- | --- |
+| `devagent_hmi.py`, `start.sh` | CLI and local Creator entry points |
+| `devagent_spatial/` | Models, validators, native compiler, simulator, FAT infrastructure |
+| `assets/` | Creator UI and HMI visualization |
+| `reference/` | Preserved Original V8 and R9 reference sources |
+| `examples/`, `templates/`, `sample_customer_inputs/` | Starter plant inputs |
+| `tests/`, `scripts/` | Regression and engineering verification |
+| `.github/workflows/` | Offline CI automation |
+
+For engineering detail, see the [qualification record](V083_QUALIFICATION.json), [native import milestone](V083_NATIVE_IMPORT_MILESTONE.md), and [production acceptance gates](PRODUCTION_ACCEPTANCE.md). Historical milestones remain in separate documentation; this README is the starting point.
+
+---
+
+**DevAgent's purpose:** faster, more repeatable industrial HMI engineering with explicit signal provenance, deterministic verification, and evidence-based commissioning.