devagent-physical-engine 2.1.1__tar.gz → 2.2.0__tar.gz

{devagent_physical_engine-2.1.1/src/devagent_physical_engine.egg-info → devagent_physical_engine-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devagent-physical-engine
-Version: 2.1.1
+Version: 2.2.0
 Summary: Verification-first robotics commissioning control plane with immutable engineering findings, deterministic pre-site readiness, evidence authority, exact-Twin lineage, selective simulation, regression, replay, and FAT reporting.
 Author: Tom Ha
 License: All Rights Reserved
@@ -125,7 +125,7 @@ That decision means the declared pre-site engineering scope has complete, curren
 Python 3.11+ is required.
 
 ```bash
-python -m pip install --upgrade devagent-physical-engine==2.1.1
+python -m pip install --upgrade devagent-physical-engine==2.2.0
 ```
 
 Verify the installed package:
@@ -500,10 +500,36 @@ export GEMINI_API_KEY="..."
 
 Provider-backed interpretation cannot grant physical truth, site qualification, functional-safety certification, or real-execution authority.
 
+### Commissioning Agent Orchestrator
+
+The default verification path now reconciles deterministic engineering review, change impact, regression, FAT, Evidence Bundle, and immutable pre-site readiness before agent reasoning.
+
+Run the bounded project-aware agent on an existing project:
+
+```bash
+devagent agent commission PROJECT_ID \
+  --provider openai \
+  --model YOUR_MODEL
+```
+
+Or point it at a customer project directory:
+
+```bash
+devagent agent commission ./ACME_CELL \
+  --provider openai \
+  --model YOUR_MODEL
+```
+
+The agent uses immutable multi-context snapshots, reviewer→critic bounded revisions, stale-context abort, full model/provider traces, deterministic recovery recommendations, and opt-in project-scoped advisory memory. It cannot grant PASS/FAIL, readiness, evidence qualification, or real execution authority.
+
+Learning is off by default. `--learn` creates only a memory candidate; explicit human promotion is required before that memory can be reused, and promoted memory remains advisory.
+
+See `docs/COMMISSIONING_AGENT_ORCHESTRATOR_V1.md`.
+
 ## Installed CLIs
 
 ```text
-devagent             one-command verification, interactive report testing, robot support/visualization
+devagent             one-command verification, commissioning agent, interactive report testing, robot support/visualization
 devagent-commercial  project, evidence, findings, FAT, regression, commissioning-readiness workflow
 devagent-physical    deterministic core + ROS/qualification tools
 devagent-physical-ai optional provider-backed engineering front end
@@ -513,7 +539,7 @@ devagent-physical-ai optional provider-backed engineering front end
 
 | Exit | Meaning |
 | ---: | --- |
-| `0` | bounded full verification is release-ready |
+| `0` | deterministic current project state is READY_FOR_PRE_SITE_COMMISSIONING |
 | `10` | customer input or operational contract failure |
 | `30` | more engineering information is required |
 | `31` | requested simulation is blocked/unqualified |
@@ -521,9 +547,9 @@ devagent-physical-ai optional provider-backed engineering front end
 
 # Project status
 
-**v2.1.1 — Production/Stable software workflow; accepted ABB/FANUC/KUKA simulation authority promotion**
+**v2.2.0 — Production/Stable software workflow; Commissioning Agent Orchestrator + deterministic pre-site readiness lifecycle**
 
-v2.1.1 promotes exact ABB IRB1200, FANUC CRX-10iA, and KUKA KR6 R900-2 kinematic/physics/visual simulation authority from the accepted v2.1 evidence. The promotion is bound to immutable report hashes and does not grant measured FAT, hardware-shadow, sim-real, site, safety, or real-execution authority.
+v2.2.0 adds the bounded project-aware Commissioning Agent Orchestrator while keeping engineering authority in the deterministic core. It reconciles engineering review, exact change impact, regression, FAT, Evidence Bundle, immutable multi-context snapshots, stale-context abort, bounded reviewer/critic revisions, full agent traces, deterministic recovery recommendations, and opt-in human-promoted advisory memory. The previously accepted ABB/FANUC/KUKA simulation authority remains unchanged and does not grant measured FAT, hardware-shadow, sim-real, site, safety, or real-execution authority.
 
 Production-oriented software capabilities include:
 
@@ -552,9 +578,12 @@ professional FAT report
 Evidence Bundle + replay
 immutable READY / NOT_READY pre-site commissioning decision
 provider-neutral optional AI front end
+bounded project-aware Commissioning Agent Orchestrator
+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.1.1 does not claim arbitrary customer cells are physically qualified, site-qualified, functionally safe, commissioned, or authorized for autonomous real execution.
+Production/Stable describes the bounded software workflow. The target-proven UR5e claim remains limited to the qualified packaged scope and acceptance environment. v2.2.0 does not claim arbitrary customer cells are physically qualified, site-qualified, functionally safe, commissioned, or authorized for autonomous real execution. 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:
 
@@ -569,6 +598,12 @@ unless separately proven by an appropriate qualified process.
 
 ## Documentation
 
+Commissioning Agent Orchestrator:
+https://github.com/tomha85/devagent-physical-engine/blob/main/docs/COMMISSIONING_AGENT_ORCHESTRATOR_V1.md
+
+v2.2.0 release notes:
+https://github.com/tomha85/devagent-physical-engine/blob/main/docs/RELEASE_NOTES_V2_2_0.md
+
 v2.1.1 release notes:
 https://github.com/tomha85/devagent-physical-engine/blob/main/docs/RELEASE_NOTES_V2_1_1.md
 

{devagent_physical_engine-2.1.1 → devagent_physical_engine-2.2.0}/README.md

@@ -83,7 +83,7 @@ That decision means the declared pre-site engineering scope has complete, curren
 Python 3.11+ is required.
 
 ```bash
-python -m pip install --upgrade devagent-physical-engine==2.1.1
+python -m pip install --upgrade devagent-physical-engine==2.2.0
 ```
 
 Verify the installed package:
@@ -458,10 +458,36 @@ export GEMINI_API_KEY="..."
 
 Provider-backed interpretation cannot grant physical truth, site qualification, functional-safety certification, or real-execution authority.
 
+### Commissioning Agent Orchestrator
+
+The default verification path now reconciles deterministic engineering review, change impact, regression, FAT, Evidence Bundle, and immutable pre-site readiness before agent reasoning.
+
+Run the bounded project-aware agent on an existing project:
+
+```bash
+devagent agent commission PROJECT_ID \
+  --provider openai \
+  --model YOUR_MODEL
+```
+
+Or point it at a customer project directory:
+
+```bash
+devagent agent commission ./ACME_CELL \
+  --provider openai \
+  --model YOUR_MODEL
+```
+
+The agent uses immutable multi-context snapshots, reviewer→critic bounded revisions, stale-context abort, full model/provider traces, deterministic recovery recommendations, and opt-in project-scoped advisory memory. It cannot grant PASS/FAIL, readiness, evidence qualification, or real execution authority.
+
+Learning is off by default. `--learn` creates only a memory candidate; explicit human promotion is required before that memory can be reused, and promoted memory remains advisory.
+
+See `docs/COMMISSIONING_AGENT_ORCHESTRATOR_V1.md`.
+
 ## Installed CLIs
 
 ```text
-devagent             one-command verification, interactive report testing, robot support/visualization
+devagent             one-command verification, commissioning agent, interactive report testing, robot support/visualization
 devagent-commercial  project, evidence, findings, FAT, regression, commissioning-readiness workflow
 devagent-physical    deterministic core + ROS/qualification tools
 devagent-physical-ai optional provider-backed engineering front end
@@ -471,7 +497,7 @@ devagent-physical-ai optional provider-backed engineering front end
 
 | Exit | Meaning |
 | ---: | --- |
-| `0` | bounded full verification is release-ready |
+| `0` | deterministic current project state is READY_FOR_PRE_SITE_COMMISSIONING |
 | `10` | customer input or operational contract failure |
 | `30` | more engineering information is required |
 | `31` | requested simulation is blocked/unqualified |
@@ -479,9 +505,9 @@ devagent-physical-ai optional provider-backed engineering front end
 
 # Project status
 
-**v2.1.1 — Production/Stable software workflow; accepted ABB/FANUC/KUKA simulation authority promotion**
+**v2.2.0 — Production/Stable software workflow; Commissioning Agent Orchestrator + deterministic pre-site readiness lifecycle**
 
-v2.1.1 promotes exact ABB IRB1200, FANUC CRX-10iA, and KUKA KR6 R900-2 kinematic/physics/visual simulation authority from the accepted v2.1 evidence. The promotion is bound to immutable report hashes and does not grant measured FAT, hardware-shadow, sim-real, site, safety, or real-execution authority.
+v2.2.0 adds the bounded project-aware Commissioning Agent Orchestrator while keeping engineering authority in the deterministic core. It reconciles engineering review, exact change impact, regression, FAT, Evidence Bundle, immutable multi-context snapshots, stale-context abort, bounded reviewer/critic revisions, full agent traces, deterministic recovery recommendations, and opt-in human-promoted advisory memory. The previously accepted ABB/FANUC/KUKA simulation authority remains unchanged and does not grant measured FAT, hardware-shadow, sim-real, site, safety, or real-execution authority.
 
 Production-oriented software capabilities include:
 
@@ -510,9 +536,12 @@ professional FAT report
 Evidence Bundle + replay
 immutable READY / NOT_READY pre-site commissioning decision
 provider-neutral optional AI front end
+bounded project-aware Commissioning Agent Orchestrator
+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.1.1 does not claim arbitrary customer cells are physically qualified, site-qualified, functionally safe, commissioned, or authorized for autonomous real execution.
+Production/Stable describes the bounded software workflow. The target-proven UR5e claim remains limited to the qualified packaged scope and acceptance environment. v2.2.0 does not claim arbitrary customer cells are physically qualified, site-qualified, functionally safe, commissioned, or authorized for autonomous real execution. 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:
 
@@ -527,6 +556,12 @@ unless separately proven by an appropriate qualified process.
 
 ## Documentation
 
+Commissioning Agent Orchestrator:
+https://github.com/tomha85/devagent-physical-engine/blob/main/docs/COMMISSIONING_AGENT_ORCHESTRATOR_V1.md
+
+v2.2.0 release notes:
+https://github.com/tomha85/devagent-physical-engine/blob/main/docs/RELEASE_NOTES_V2_2_0.md
+
 v2.1.1 release notes:
 https://github.com/tomha85/devagent-physical-engine/blob/main/docs/RELEASE_NOTES_V2_1_1.md
 

{devagent_physical_engine-2.1.1 → devagent_physical_engine-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devagent-physical-engine"
-version = "2.1.1"
+version = "2.2.0"
 description = "Verification-first robotics commissioning control plane with immutable engineering findings, deterministic pre-site readiness, evidence authority, exact-Twin lineage, selective simulation, regression, replay, and FAT reporting."
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"
@@ -48,7 +48,7 @@ Issues = "https://github.com/tomha85/devagent-physical-engine/issues"
 Sponsor = "https://github.com/sponsors/tomha85"
 
 [project.scripts]
-devagent = "devagent_physical_engine.user_cli_v191:main"
+devagent = "devagent_physical_engine.user_cli_v22: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_physical_engine-2.1.1 → devagent_physical_engine-2.2.0}/src/devagent_physical_engine/__init__.py

@@ -35,6 +35,21 @@ from .commissioning_readiness import (
     CommissioningReadinessStatus,
     PreSiteCommissioningReadinessEvaluator,
 )
+from .commissioning_agent import (
+    COMMISSIONING_AGENT_SCHEMA_VERSION,
+    CommissioningAgentOrchestrator,
+    CommissioningAgentResult,
+    CommissioningContextAssembler,
+    CommissioningContextSnapshot,
+    CommissioningLifecycleCoordinator,
+    CommissioningLifecycleResult,
+    CommissioningReviewAgent,
+    CommissioningReviewCriticAgent,
+    CommissioningReviewCoordinator,
+    CommissioningReviewProposal,
+    EngineeringMemoryStore,
+    EvidenceAwareRecoveryPolicy,
+)
 from .controller_runtime_hotfix_v181 import install_controller_runtime_hotfix_v181
 from .engineering_findings import (
     ENGINEERING_FINDINGS_SCHEMA_VERSION,
@@ -69,7 +84,7 @@ from .one_command import (
     OneCommandError,
 )
 from .one_command_runtime import install_one_command_runtime
-from .one_command_v16 import OneCommandVerifier, SimpleVerifyResult
+from .one_command_v22 import CommissioningVerifyResult, OneCommandVerifier, SimpleVerifyResult
 from .physical_motion import JointTrajectoryPoint, MotionExecutionMetrics, PhysicalMotionPlan
 from .production_authority import (
     PhysicalEvidenceRecorder,
@@ -191,6 +206,19 @@ __all__ = [
     "COMMISSIONING_READINESS_SCHEMA_VERSION",
     "CommissioningReadinessStatus",
     "PreSiteCommissioningReadinessEvaluator",
+    "COMMISSIONING_AGENT_SCHEMA_VERSION",
+    "CommissioningAgentOrchestrator",
+    "CommissioningAgentResult",
+    "CommissioningContextAssembler",
+    "CommissioningContextSnapshot",
+    "CommissioningLifecycleCoordinator",
+    "CommissioningLifecycleResult",
+    "CommissioningReviewAgent",
+    "CommissioningReviewCriticAgent",
+    "CommissioningReviewCoordinator",
+    "CommissioningReviewProposal",
+    "EngineeringMemoryStore",
+    "EvidenceAwareRecoveryPolicy",
     "CommissioningEvidenceGraphBuilder",
     "CommissioningEvidenceViewer",
     "VerificationScopeAuthority",
@@ -206,6 +234,7 @@ __all__ = [
     "OneCommandError",
     "OneCommandVerifier",
     "SimpleVerifyResult",
+    "CommissioningVerifyResult",
     "COMMERCIAL_INTELLIGENCE_SCHEMA_VERSION",
     "CommercialIntelligenceRecorder",
     "CriterionProposal",
@@ -249,4 +278,4 @@ install_industrial_motion_v170()
 install_controller_runtime_hotfix_v181()
 install_one_command_runtime()
 
-__version__ = "2.1.1"
+__version__ = "2.2.0"