devagent-physical-engine 2.3.0__tar.gz → 2.4.0__tar.gz

{devagent_physical_engine-2.3.0/src/devagent_physical_engine.egg-info → devagent_physical_engine-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devagent-physical-engine
-Version: 2.3.0
+Version: 2.4.0
 Summary: Verification-first multi-vendor commissioning control plane with flexible guided customer-file intake, deterministic source/evidence authority, exact-Twin lineage, regression, FAT reporting, and pre-site readiness.
 Author: Tom Ha
 License: All Rights Reserved
@@ -81,7 +81,7 @@ DevAgent turns customer engineering inputs into a bounded, evidence-driven pre-s
 
 <p align="center"><sub><b>Real engine screenshots — not product renders.</b> ROS 2 Jazzy · Gazebo Harmonic · MoveIt 2 · Pilz · UR5e exact-Twin verification.</sub></p>
 
-## v2.3 commissioning verification flow
+## v2.4 commissioning verification flow
 
 ```text
 Customer engineering files
@@ -120,12 +120,38 @@ NOT_READY_FOR_PRE_SITE_COMMISSIONING
 
 That decision means the declared pre-site engineering scope has complete, current evidence according to DevAgent's installed authority contracts. It does **not** mean the real site is commissioned.
 
+## v2.4 highlights
+
+v2.4 adds customer-facing readiness explanations and a workstation-qualified ABB IRB1200 imported-Twin simulation path while keeping engineering authority fail-closed.
+
+Key additions:
+
+- `devagent> explain detail` for root blockers, per-test evidence authority, and exact next actions;
+- persisted customer-facing readiness explanation and composite FAT report;
+- imported ABB IRB1200 exact-Twin candidate execution and non-promoting qualification CLI;
+- executable `ABB_IRB1200_LOAD_MOTION_REFERENCE_V1` reference project;
+- corrected spatial center-pose showcase geometry;
+- slow-Gazebo trajectory watchdog hardening;
+- deterministic Gazebo camera, lighting, and readable scene materials;
+- verified ABB visual-mesh resolution through ROS 2 colcon symlink-install workspaces;
+- explicit native-SDF preflight plus fixed `world -> base_link` anchor for floor-mounted ABB simulation.
+
+The ABB imported-Twin path remains bounded:
+
+```text
+measurement_promoted = false
+site_qualification = false
+real_execution_allowed = false
+```
+
+A successful simulation smoke proves the bounded simulator/runtime path for that exact candidate; it does not grant customer FAT, site, functional-safety, or real-robot execution authority.
+
 ## Quick start
 
 Python 3.11+ is required.
 
 ```bash
-python -m pip install --upgrade devagent-physical-engine==2.3.0
+python -m pip install --upgrade devagent-physical-engine==2.4.0
 ```
 
 Verify the installed package:
@@ -137,7 +163,7 @@ python -c "import devagent_physical_engine as d; print(d.__version__)"
 Expected:
 
 ```text
-2.3.0
+2.4.0
 ```
 
 Run the normal customer workflow:
@@ -648,9 +674,9 @@ devagent-physical-ai optional provider-backed engineering front end
 
 # Project status
 
-**v2.3.0 — Production/Stable software workflow; Flexible Guided Multi-Vendor Intake + deterministic commissioning authority**
+**v2.4.0 — Production/Stable software workflow; detailed readiness explanation + bounded imported ABB simulation qualification**
 
-v2.3.0 makes the customer entry workflow flexible without weakening verification authority. Customers can provide the engineering files they already have instead of conforming to one mandatory DevAgent project schema. DevAgent inventories and hashes the raw sources, recognizes supported vendor/file roles, detects exact duplicates and source ambiguity, validates current intake provenance, and exposes which verification capabilities are available before the existing deterministic commissioning workflow continues.
+v2.4.0 retains the flexible v2.3 customer entry workflow and adds detailed customer-facing readiness explanations plus an exact imported ABB IRB1200 simulation / qualification candidate path. The ABB reference workflow now includes canonical center-pose scene validation, exact MoveIt planning, FollowJointTrajectory execution, controller-feedback lineage, deterministic Gazebo visualization, verified local mesh resolution, native-SDF preflight, and a fixed world-to-base anchor appropriate for the floor-mounted reference robot. The ABB path remains non-promoting: successful simulator qualification does not create customer FAT, site, functional-safety, or real-execution authority.
 
 Missing files are allowed. Missing evidence reduces verification scope or remains `NOT_TESTED`; it never becomes a synthetic `FAIL` or an invented PASS. Multiple distinct same-vendor source sets require confirmation instead of being selected from filenames such as `final`, `latest`, or `backup`. Source changes during verification invalidate the current intake snapshot and block readiness until the project is rerun from a stable source state.
 
@@ -693,7 +719,7 @@ immutable multi-context agent snapshots + stale-context abort
 opt-in human-promoted advisory engineering memory
 ```
 
-Production/Stable describes the bounded software workflow. The target-proven UR5e claim remains limited to the qualified packaged scope and acceptance environment. v2.3.0 does not claim arbitrary customer cells are physically qualified, site-qualified, functionally safe, commissioned, or authorized for autonomous real execution. Flexible intake changes how customer artifacts enter the workflow; it does not weaken evidence authority. The AI agent remains advisory and cannot grant PASS/FAIL/NOT_TESTED, evidence qualification, pre-site readiness, or real-execution authority.
+Production/Stable describes the bounded software workflow. The target-proven UR5e claim remains limited to its qualified packaged scope and acceptance environment. The v2.4.0 imported ABB path is separately bounded to the exact simulator/reference qualification scope and remains non-promoting. v2.4.0 does not claim arbitrary customer cells are physically qualified, site-qualified, functionally safe, commissioned, or authorized for autonomous real execution. Flexible intake changes how customer artifacts enter the workflow; it does not weaken evidence authority. The AI agent remains advisory and cannot grant PASS/FAIL/NOT_TESTED, evidence qualification, pre-site readiness, or real-execution authority.
 
 Current hard authority boundaries remain:
 
@@ -714,6 +740,12 @@ https://github.com/tomha85/devagent-physical-engine/blob/main/docs/FLEXIBLE_GUID
 Commissioning Agent Orchestrator:
 https://github.com/tomha85/devagent-physical-engine/blob/main/docs/COMMISSIONING_AGENT_ORCHESTRATOR_V1.md
 
+v2.4.0 release notes:
+https://github.com/tomha85/devagent-physical-engine/blob/main/docs/RELEASE_NOTES_V2_4_0.md
+
+v2.3.1 release notes:
+https://github.com/tomha85/devagent-physical-engine/blob/main/docs/RELEASE_NOTES_V2_3_1.md
+
 v2.3.0 release notes:
 https://github.com/tomha85/devagent-physical-engine/blob/main/docs/RELEASE_NOTES_V2_3_0.md
 

{devagent_physical_engine-2.3.0 → devagent_physical_engine-2.4.0}/README.md

@@ -39,7 +39,7 @@ DevAgent turns customer engineering inputs into a bounded, evidence-driven pre-s
 
 <p align="center"><sub><b>Real engine screenshots — not product renders.</b> ROS 2 Jazzy · Gazebo Harmonic · MoveIt 2 · Pilz · UR5e exact-Twin verification.</sub></p>
 
-## v2.3 commissioning verification flow
+## v2.4 commissioning verification flow
 
 ```text
 Customer engineering files
@@ -78,12 +78,38 @@ NOT_READY_FOR_PRE_SITE_COMMISSIONING
 
 That decision means the declared pre-site engineering scope has complete, current evidence according to DevAgent's installed authority contracts. It does **not** mean the real site is commissioned.
 
+## v2.4 highlights
+
+v2.4 adds customer-facing readiness explanations and a workstation-qualified ABB IRB1200 imported-Twin simulation path while keeping engineering authority fail-closed.
+
+Key additions:
+
+- `devagent> explain detail` for root blockers, per-test evidence authority, and exact next actions;
+- persisted customer-facing readiness explanation and composite FAT report;
+- imported ABB IRB1200 exact-Twin candidate execution and non-promoting qualification CLI;
+- executable `ABB_IRB1200_LOAD_MOTION_REFERENCE_V1` reference project;
+- corrected spatial center-pose showcase geometry;
+- slow-Gazebo trajectory watchdog hardening;
+- deterministic Gazebo camera, lighting, and readable scene materials;
+- verified ABB visual-mesh resolution through ROS 2 colcon symlink-install workspaces;
+- explicit native-SDF preflight plus fixed `world -> base_link` anchor for floor-mounted ABB simulation.
+
+The ABB imported-Twin path remains bounded:
+
+```text
+measurement_promoted = false
+site_qualification = false
+real_execution_allowed = false
+```
+
+A successful simulation smoke proves the bounded simulator/runtime path for that exact candidate; it does not grant customer FAT, site, functional-safety, or real-robot execution authority.
+
 ## Quick start
 
 Python 3.11+ is required.
 
 ```bash
-python -m pip install --upgrade devagent-physical-engine==2.3.0
+python -m pip install --upgrade devagent-physical-engine==2.4.0
 ```
 
 Verify the installed package:
@@ -95,7 +121,7 @@ python -c "import devagent_physical_engine as d; print(d.__version__)"
 Expected:
 
 ```text
-2.3.0
+2.4.0
 ```
 
 Run the normal customer workflow:
@@ -606,9 +632,9 @@ devagent-physical-ai optional provider-backed engineering front end
 
 # Project status
 
-**v2.3.0 — Production/Stable software workflow; Flexible Guided Multi-Vendor Intake + deterministic commissioning authority**
+**v2.4.0 — Production/Stable software workflow; detailed readiness explanation + bounded imported ABB simulation qualification**
 
-v2.3.0 makes the customer entry workflow flexible without weakening verification authority. Customers can provide the engineering files they already have instead of conforming to one mandatory DevAgent project schema. DevAgent inventories and hashes the raw sources, recognizes supported vendor/file roles, detects exact duplicates and source ambiguity, validates current intake provenance, and exposes which verification capabilities are available before the existing deterministic commissioning workflow continues.
+v2.4.0 retains the flexible v2.3 customer entry workflow and adds detailed customer-facing readiness explanations plus an exact imported ABB IRB1200 simulation / qualification candidate path. The ABB reference workflow now includes canonical center-pose scene validation, exact MoveIt planning, FollowJointTrajectory execution, controller-feedback lineage, deterministic Gazebo visualization, verified local mesh resolution, native-SDF preflight, and a fixed world-to-base anchor appropriate for the floor-mounted reference robot. The ABB path remains non-promoting: successful simulator qualification does not create customer FAT, site, functional-safety, or real-execution authority.
 
 Missing files are allowed. Missing evidence reduces verification scope or remains `NOT_TESTED`; it never becomes a synthetic `FAIL` or an invented PASS. Multiple distinct same-vendor source sets require confirmation instead of being selected from filenames such as `final`, `latest`, or `backup`. Source changes during verification invalidate the current intake snapshot and block readiness until the project is rerun from a stable source state.
 
@@ -651,7 +677,7 @@ immutable multi-context agent snapshots + stale-context abort
 opt-in human-promoted advisory engineering memory
 ```
 
-Production/Stable describes the bounded software workflow. The target-proven UR5e claim remains limited to the qualified packaged scope and acceptance environment. v2.3.0 does not claim arbitrary customer cells are physically qualified, site-qualified, functionally safe, commissioned, or authorized for autonomous real execution. Flexible intake changes how customer artifacts enter the workflow; it does not weaken evidence authority. The AI agent remains advisory and cannot grant PASS/FAIL/NOT_TESTED, evidence qualification, pre-site readiness, or real-execution authority.
+Production/Stable describes the bounded software workflow. The target-proven UR5e claim remains limited to its qualified packaged scope and acceptance environment. The v2.4.0 imported ABB path is separately bounded to the exact simulator/reference qualification scope and remains non-promoting. v2.4.0 does not claim arbitrary customer cells are physically qualified, site-qualified, functionally safe, commissioned, or authorized for autonomous real execution. Flexible intake changes how customer artifacts enter the workflow; it does not weaken evidence authority. The AI agent remains advisory and cannot grant PASS/FAIL/NOT_TESTED, evidence qualification, pre-site readiness, or real-execution authority.
 
 Current hard authority boundaries remain:
 
@@ -672,6 +698,12 @@ https://github.com/tomha85/devagent-physical-engine/blob/main/docs/FLEXIBLE_GUID
 Commissioning Agent Orchestrator:
 https://github.com/tomha85/devagent-physical-engine/blob/main/docs/COMMISSIONING_AGENT_ORCHESTRATOR_V1.md
 
+v2.4.0 release notes:
+https://github.com/tomha85/devagent-physical-engine/blob/main/docs/RELEASE_NOTES_V2_4_0.md
+
+v2.3.1 release notes:
+https://github.com/tomha85/devagent-physical-engine/blob/main/docs/RELEASE_NOTES_V2_3_1.md
+
 v2.3.0 release notes:
 https://github.com/tomha85/devagent-physical-engine/blob/main/docs/RELEASE_NOTES_V2_3_0.md
 

{devagent_physical_engine-2.3.0 → devagent_physical_engine-2.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devagent-physical-engine"
-version = "2.3.0"
+version = "2.4.0"
 description = "Verification-first multi-vendor commissioning control plane with flexible guided customer-file intake, deterministic source/evidence authority, exact-Twin lineage, regression, FAT reporting, and pre-site readiness."
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"
@@ -52,6 +52,7 @@ devagent = "devagent_physical_engine.user_cli_v23:main"
 devagent-physical = "devagent_physical_engine.cli:main"
 devagent-physical-ai = "devagent_physical_engine.ai_cli:main"
 devagent-commercial = "devagent_physical_engine.commercial_cli:main"
+devagent-imported-abb-qualify = "devagent_physical_engine.imported_twin_qualification_cli_v24:main"
 
 [tool.setuptools.packages.find]
 where = ["src"]
@@ -94,6 +95,11 @@ omit = [
   "src/devagent_physical_engine/ros2/kuka_kr6_r900_2.py",
   "src/devagent_physical_engine/ros2/industrial_arm_task_runtime.py",
   "src/devagent_physical_engine/ros2/industrial_arm_task_adapters.py",
+  # Imported-Twin candidate execution and its qualification CLI orchestrate a real
+  # ROS/Gazebo/MoveIt target stack. Pure contracts/gates are still exercised by
+  # hosted tests; executable target behavior is qualified on the workstation.
+  "src/devagent_physical_engine/imported_twin_execution_v24.py",
+  "src/devagent_physical_engine/imported_twin_qualification_cli_v24.py",
 ]
 
 [tool.coverage.report]

{devagent_physical_engine-2.3.0 → devagent_physical_engine-2.4.0}/src/devagent_physical_engine/__init__.py

@@ -298,4 +298,4 @@ install_industrial_motion_v170()
 install_controller_runtime_hotfix_v181()
 install_one_command_runtime()
 
-__version__ = "2.3.0"
+__version__ = "2.4.0"