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

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: devagent-physical-engine
-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.
+Version: 2.3.1
+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
 Project-URL: Homepage, https://github.com/tomha85/devagent-physical-engine
@@ -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.1 commissioning verification flow
+## v2.3 commissioning verification flow
 
 ```text
 Customer engineering files
@@ -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.2.0
+python -m pip install --upgrade devagent-physical-engine==2.3.1
 ```
 
 Verify the installed package:
@@ -137,7 +137,7 @@ python -c "import devagent_physical_engine as d; print(d.__version__)"
 Expected:
 
 ```text
-2.1.1
+2.3.1
 ```
 
 Run the normal customer workflow:
@@ -171,6 +171,107 @@ Evidence database: ~/.devagent/projects.db
 Results:           <customer-project>/devagent-results/
 ```
 
+## Flexible guided project intake
+
+**You do not need to prepare a special DevAgent project format.** Put the engineering files you already have into one customer project folder and run:
+
+```bash
+devagent verify ./customer-project
+```
+
+That is the normal workflow. `devagent verify` performs guided intake automatically before verification.
+
+If you only want to inspect what DevAgent can use, without running the full verification workflow:
+
+```bash
+devagent intake ./customer-project
+```
+
+### What files should I provide?
+
+Provide whatever is available. More current engineering sources can increase verification coverage, but there is no global mandatory checklist.
+
+Typical inputs may include:
+
+```text
+customer-project/
+├── requirements.xlsx            # optional
+├── PLC/                         # optional Siemens/Rockwell/Schneider exports
+├── Robot/                       # optional ABB/FANUC/KUKA exports
+├── cell.step                    # optional CAD / geometry
+├── FAT_results.xlsx             # optional existing test evidence
+├── calibration/                 # optional TCP / frame / calibration data
+├── drawings.pdf                 # optional engineering documentation
+└── anything_else_the_customer_has/
+```
+
+A project with only requirements can still be reviewed and normalized. A project without PLC, robot, CAD, or existing FAT evidence is still accepted; DevAgent simply limits the verification scope to what the supplied sources can prove.
+
+### Missing files do not become failures
+
+DevAgent keeps these meanings separate:
+
+```text
+authoritative evidence disproves a criterion  -> FAIL
+required evidence is unavailable             -> NOT_TESTED / reduced scope
+evidence belongs to an old project revision  -> STALE
+multiple possible current source revisions   -> NEEDS_CONFIRMATION
+unsupported file                              -> inventoried, not authority
+optional file missing                         -> no intake failure
+```
+
+DevAgent does not invent substitute evidence to make a project pass.
+
+### How source authority is handled
+
+Every raw customer file is hashed and inventoried. DevAgent recognizes common Siemens, Rockwell, Schneider, ABB, FANUC, and KUKA exports together with requirements, CAD/model files, structured engineering data, PDFs, and existing FAT/test evidence.
+
+When one source is unambiguous, DevAgent can use it automatically. Multi-file PLC or robot projects are kept as a bounded source set.
+
+If multiple distinct source sets from the same vendor could represent different revisions, DevAgent **does not guess** using names such as `final`, `latest`, `backup`, or filesystem modification time. The affected source role becomes `NEEDS_CONFIRMATION`; unrelated verification scope can still continue.
+
+For an ambiguous project, an optional `devagent-intake.yaml` can explicitly select the current sources:
+
+```yaml
+authoritative_sources:
+  requirements: requirements_rev_c.xlsx
+
+  plc_project:
+    - PLC/current_controller.L5X
+    - PLC/current_tags.L5X
+
+  robot_project:
+    - Robot/MainModule.mod
+    - Robot/ToolModule.mod
+```
+
+This file is optional. Normal unambiguous projects do not need it.
+
+### What DevAgent creates
+
+The customer source files remain read-only. DevAgent writes its own outputs under `devagent-results/`:
+
+```text
+devagent-results/
+├── SOURCE_MANIFEST.json
+├── INTAKE_READINESS.json
+├── INTAKE_GUIDE.md
+├── SUMMARY.json
+├── PRE_SITE_READINESS.json
+├── FAT_REPORT.html              # when current FAT lineage exists
+└── EVIDENCE.html
+```
+
+`SOURCE_MANIFEST.json` records hashes and source provenance. `INTAKE_READINESS.json` shows which source roles are usable or need confirmation. `INTAKE_GUIDE.md` explains optional files that could strengthen coverage.
+
+If customer files change while verification is running, the run is marked as a stale source snapshot and cannot be promoted as current readiness. Add or replace files when needed, then rerun the same command:
+
+```bash
+devagent verify ./customer-project
+```
+
+See `docs/FLEXIBLE_GUIDED_INTAKE_V23.md` for the full intake authority contract.
+
 ## Commercial commissioning workflow
 
 The normal end-to-end customer path is `devagent verify`. It performs requirement normalization, deterministic mapping, requirement-driven case planning/mapping, verification orchestration, evidence recording, regression, and reporting within the qualified scope.
@@ -529,7 +630,7 @@ See `docs/COMMISSIONING_AGENT_ORCHESTRATOR_V1.md`.
 ## Installed CLIs
 
 ```text
-devagent             one-command verification, commissioning agent, interactive report testing, robot support/visualization
+devagent             guided project intake, 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
@@ -547,14 +648,23 @@ devagent-physical-ai optional provider-backed engineering front end
 
 # Project status
 
-**v2.2.0 — Production/Stable software workflow; Commissioning Agent Orchestrator + deterministic pre-site readiness lifecycle**
+**v2.3.1 — Production/Stable software workflow; Flexible Guided Multi-Vendor Intake + selective-simulation fail-closed hardening**
+
+v2.3.1 retains the v2.3 flexible customer entry workflow and hardens selective physical simulation so unsupported robot profiles fail closed as bounded `BLOCKED` results instead of surfacing runtime exceptions. v2.3.0 made 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.
+
+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.
 
-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.
+The v2.2 Commissioning Agent Orchestrator remains advisory-only above the deterministic core. Existing ABB/FANUC/KUKA bounded simulation authority remains unchanged and does not grant measured FAT, hardware-shadow, sim-real, site, safety, commissioning-completed, or real-execution authority.
 
 Production-oriented software capabilities include:
 
 ```text
-one-command customer intake
+flexible guided multi-vendor customer intake
+read-only source inventory + SHA256 provenance
+optional source files; partial verification allowed
+deterministic source ambiguity / duplicate handling
+stable inventory + authority fingerprints
+source-mutation detection during verification
 XLSX/CSV/YAML/JSON requirement normalization
 immutable project/Twin lineage
 engineering review + first-class risk findings
@@ -583,7 +693,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.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.
+Production/Stable describes the bounded software workflow. The target-proven UR5e claim remains limited to the qualified packaged scope and acceptance environment. v2.3.1 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:
 
@@ -598,9 +708,18 @@ unless separately proven by an appropriate qualified process.
 
 ## Documentation
 
+Flexible Guided Intake:
+https://github.com/tomha85/devagent-physical-engine/blob/main/docs/FLEXIBLE_GUIDED_INTAKE_V23.md
+
 Commissioning Agent Orchestrator:
 https://github.com/tomha85/devagent-physical-engine/blob/main/docs/COMMISSIONING_AGENT_ORCHESTRATOR_V1.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
+
 v2.2.0 release notes:
 https://github.com/tomha85/devagent-physical-engine/blob/main/docs/RELEASE_NOTES_V2_2_0.md
 

{devagent_physical_engine-2.2.0 → devagent_physical_engine-2.3.1}/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.1 commissioning verification flow
+## v2.3 commissioning verification flow
 
 ```text
 Customer engineering files
@@ -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.2.0
+python -m pip install --upgrade devagent-physical-engine==2.3.1
 ```
 
 Verify the installed package:
@@ -95,7 +95,7 @@ python -c "import devagent_physical_engine as d; print(d.__version__)"
 Expected:
 
 ```text
-2.1.1
+2.3.1
 ```
 
 Run the normal customer workflow:
@@ -129,6 +129,107 @@ Evidence database: ~/.devagent/projects.db
 Results:           <customer-project>/devagent-results/
 ```
 
+## Flexible guided project intake
+
+**You do not need to prepare a special DevAgent project format.** Put the engineering files you already have into one customer project folder and run:
+
+```bash
+devagent verify ./customer-project
+```
+
+That is the normal workflow. `devagent verify` performs guided intake automatically before verification.
+
+If you only want to inspect what DevAgent can use, without running the full verification workflow:
+
+```bash
+devagent intake ./customer-project
+```
+
+### What files should I provide?
+
+Provide whatever is available. More current engineering sources can increase verification coverage, but there is no global mandatory checklist.
+
+Typical inputs may include:
+
+```text
+customer-project/
+├── requirements.xlsx            # optional
+├── PLC/                         # optional Siemens/Rockwell/Schneider exports
+├── Robot/                       # optional ABB/FANUC/KUKA exports
+├── cell.step                    # optional CAD / geometry
+├── FAT_results.xlsx             # optional existing test evidence
+├── calibration/                 # optional TCP / frame / calibration data
+├── drawings.pdf                 # optional engineering documentation
+└── anything_else_the_customer_has/
+```
+
+A project with only requirements can still be reviewed and normalized. A project without PLC, robot, CAD, or existing FAT evidence is still accepted; DevAgent simply limits the verification scope to what the supplied sources can prove.
+
+### Missing files do not become failures
+
+DevAgent keeps these meanings separate:
+
+```text
+authoritative evidence disproves a criterion  -> FAIL
+required evidence is unavailable             -> NOT_TESTED / reduced scope
+evidence belongs to an old project revision  -> STALE
+multiple possible current source revisions   -> NEEDS_CONFIRMATION
+unsupported file                              -> inventoried, not authority
+optional file missing                         -> no intake failure
+```
+
+DevAgent does not invent substitute evidence to make a project pass.
+
+### How source authority is handled
+
+Every raw customer file is hashed and inventoried. DevAgent recognizes common Siemens, Rockwell, Schneider, ABB, FANUC, and KUKA exports together with requirements, CAD/model files, structured engineering data, PDFs, and existing FAT/test evidence.
+
+When one source is unambiguous, DevAgent can use it automatically. Multi-file PLC or robot projects are kept as a bounded source set.
+
+If multiple distinct source sets from the same vendor could represent different revisions, DevAgent **does not guess** using names such as `final`, `latest`, `backup`, or filesystem modification time. The affected source role becomes `NEEDS_CONFIRMATION`; unrelated verification scope can still continue.
+
+For an ambiguous project, an optional `devagent-intake.yaml` can explicitly select the current sources:
+
+```yaml
+authoritative_sources:
+  requirements: requirements_rev_c.xlsx
+
+  plc_project:
+    - PLC/current_controller.L5X
+    - PLC/current_tags.L5X
+
+  robot_project:
+    - Robot/MainModule.mod
+    - Robot/ToolModule.mod
+```
+
+This file is optional. Normal unambiguous projects do not need it.
+
+### What DevAgent creates
+
+The customer source files remain read-only. DevAgent writes its own outputs under `devagent-results/`:
+
+```text
+devagent-results/
+├── SOURCE_MANIFEST.json
+├── INTAKE_READINESS.json
+├── INTAKE_GUIDE.md
+├── SUMMARY.json
+├── PRE_SITE_READINESS.json
+├── FAT_REPORT.html              # when current FAT lineage exists
+└── EVIDENCE.html
+```
+
+`SOURCE_MANIFEST.json` records hashes and source provenance. `INTAKE_READINESS.json` shows which source roles are usable or need confirmation. `INTAKE_GUIDE.md` explains optional files that could strengthen coverage.
+
+If customer files change while verification is running, the run is marked as a stale source snapshot and cannot be promoted as current readiness. Add or replace files when needed, then rerun the same command:
+
+```bash
+devagent verify ./customer-project
+```
+
+See `docs/FLEXIBLE_GUIDED_INTAKE_V23.md` for the full intake authority contract.
+
 ## Commercial commissioning workflow
 
 The normal end-to-end customer path is `devagent verify`. It performs requirement normalization, deterministic mapping, requirement-driven case planning/mapping, verification orchestration, evidence recording, regression, and reporting within the qualified scope.
@@ -487,7 +588,7 @@ See `docs/COMMISSIONING_AGENT_ORCHESTRATOR_V1.md`.
 ## Installed CLIs
 
 ```text
-devagent             one-command verification, commissioning agent, interactive report testing, robot support/visualization
+devagent             guided project intake, 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
@@ -505,14 +606,23 @@ devagent-physical-ai optional provider-backed engineering front end
 
 # Project status
 
-**v2.2.0 — Production/Stable software workflow; Commissioning Agent Orchestrator + deterministic pre-site readiness lifecycle**
+**v2.3.1 — Production/Stable software workflow; Flexible Guided Multi-Vendor Intake + selective-simulation fail-closed hardening**
+
+v2.3.1 retains the v2.3 flexible customer entry workflow and hardens selective physical simulation so unsupported robot profiles fail closed as bounded `BLOCKED` results instead of surfacing runtime exceptions. v2.3.0 made 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.
+
+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.
 
-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.
+The v2.2 Commissioning Agent Orchestrator remains advisory-only above the deterministic core. Existing ABB/FANUC/KUKA bounded simulation authority remains unchanged and does not grant measured FAT, hardware-shadow, sim-real, site, safety, commissioning-completed, or real-execution authority.
 
 Production-oriented software capabilities include:
 
 ```text
-one-command customer intake
+flexible guided multi-vendor customer intake
+read-only source inventory + SHA256 provenance
+optional source files; partial verification allowed
+deterministic source ambiguity / duplicate handling
+stable inventory + authority fingerprints
+source-mutation detection during verification
 XLSX/CSV/YAML/JSON requirement normalization
 immutable project/Twin lineage
 engineering review + first-class risk findings
@@ -541,7 +651,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.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.
+Production/Stable describes the bounded software workflow. The target-proven UR5e claim remains limited to the qualified packaged scope and acceptance environment. v2.3.1 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:
 
@@ -556,9 +666,18 @@ unless separately proven by an appropriate qualified process.
 
 ## Documentation
 
+Flexible Guided Intake:
+https://github.com/tomha85/devagent-physical-engine/blob/main/docs/FLEXIBLE_GUIDED_INTAKE_V23.md
+
 Commissioning Agent Orchestrator:
 https://github.com/tomha85/devagent-physical-engine/blob/main/docs/COMMISSIONING_AGENT_ORCHESTRATOR_V1.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
+
 v2.2.0 release notes:
 https://github.com/tomha85/devagent-physical-engine/blob/main/docs/RELEASE_NOTES_V2_2_0.md
 

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

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devagent-physical-engine"
-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."
+version = "2.3.1"
+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"
 dependencies = ["PyYAML>=6.0,<7"]
@@ -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_v22:main"
+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_physical_engine-2.2.0 → devagent_physical_engine-2.3.1}/src/devagent_physical_engine/__init__.py

@@ -84,7 +84,18 @@ from .one_command import (
     OneCommandError,
 )
 from .one_command_runtime import install_one_command_runtime
-from .one_command_v22 import CommissioningVerifyResult, OneCommandVerifier, SimpleVerifyResult
+from .guided_intake_v23 import (
+    GUIDED_INTAKE_SCHEMA_VERSION,
+    AuthorityGroup,
+    Capability as IntakeCapability,
+    GuidedIntakeError,
+    IntakeAnalysis,
+    SourceRecord,
+    analyze_source,
+    write_intake_reports,
+)
+from .one_command_v22 import CommissioningVerifyResult, SimpleVerifyResult
+from .one_command_v23 import FlexibleVerifyResult, OneCommandVerifier
 from .physical_motion import JointTrajectoryPoint, MotionExecutionMetrics, PhysicalMotionPlan
 from .production_authority import (
     PhysicalEvidenceRecorder,
@@ -235,6 +246,15 @@ __all__ = [
     "OneCommandVerifier",
     "SimpleVerifyResult",
     "CommissioningVerifyResult",
+    "FlexibleVerifyResult",
+    "GUIDED_INTAKE_SCHEMA_VERSION",
+    "GuidedIntakeError",
+    "IntakeAnalysis",
+    "SourceRecord",
+    "AuthorityGroup",
+    "IntakeCapability",
+    "analyze_source",
+    "write_intake_reports",
     "COMMERCIAL_INTELLIGENCE_SCHEMA_VERSION",
     "CommercialIntelligenceRecorder",
     "CriterionProposal",
@@ -278,4 +298,4 @@ install_industrial_motion_v170()
 install_controller_runtime_hotfix_v181()
 install_one_command_runtime()
 
-__version__ = "2.2.0"
+__version__ = "2.3.1"

{devagent_physical_engine-2.2.0 → devagent_physical_engine-2.3.1}/src/devagent_physical_engine/commissioning_readiness.py

@@ -36,6 +36,8 @@ _STATE_HEAD_TYPES = (
     "commercial_regression",
     "fat_report",
     "evidence_bundle",
+    "project_source_manifest",
+    "guided_intake_readiness",
 )
 
 
@@ -227,6 +229,56 @@ class PreSiteCommissioningReadinessEvaluator:
         blockers: list[str] = []
         warnings: list[str] = []
 
+        intake_readiness = _latest(
+            self.repository,
+            project_id,
+            "guided_intake_readiness",
+        )
+        source_manifest = None
+        if intake_readiness is not None:
+            source_manifest = _get_optional(
+                self.repository,
+                project_id,
+                intake_readiness.payload.get("source_manifest_artifact_id"),
+                "project_source_manifest",
+            )
+            if source_manifest is None:
+                self._append(blockers, "intake_source_manifest_missing")
+            else:
+                if (
+                    source_manifest.artifact_hash
+                    != intake_readiness.payload.get("source_manifest_artifact_hash")
+                ):
+                    self._append(blockers, "intake_source_manifest_hash_mismatch")
+                if (
+                    source_manifest.payload.get("inventory_fingerprint")
+                    != intake_readiness.payload.get("inventory_fingerprint")
+                ):
+                    self._append(blockers, "intake_inventory_fingerprint_mismatch")
+                if (
+                    source_manifest.payload.get("authority_fingerprint")
+                    != intake_readiness.payload.get("authority_fingerprint")
+                ):
+                    self._append(blockers, "intake_authority_fingerprint_mismatch")
+            if latest_revision is not None and (
+                intake_readiness.twin_revision_id != latest_revision.revision_id
+                or source_manifest is None
+                or source_manifest.twin_revision_id != latest_revision.revision_id
+            ):
+                self._append(blockers, "intake_readiness_stale_for_current_twin")
+            if intake_readiness.payload.get("source_changed_during_verification") is True:
+                self._append(blockers, "intake_source_changed_during_verification")
+            if intake_readiness.payload.get("authority_ready") is not True:
+                self._append(blockers, "intake_source_authority_unresolved")
+            unresolved_roles = intake_readiness.payload.get("unresolved_roles", [])
+            if isinstance(unresolved_roles, list):
+                for role in unresolved_roles:
+                    self._append(blockers, f"intake_source_needs_confirmation:{role}")
+            configuration_issues = intake_readiness.payload.get("configuration_issues", [])
+            if isinstance(configuration_issues, list):
+                for issue in configuration_issues:
+                    self._append(blockers, f"intake_configuration_issue:{issue}")
+
         if latest_revision is None:
             self._append(blockers, "latest_twin_revision_missing")
         elif latest_revision.build_state not in _READY_TWIN_STATES:
@@ -565,7 +617,15 @@ class PreSiteCommissioningReadinessEvaluator:
                     if isinstance(references, list)
                     else set()
                 )
-                for expected in [requirement_set, plan, measurement, regression, fat_report]:
+                for expected in [
+                    source_manifest,
+                    intake_readiness,
+                    requirement_set,
+                    plan,
+                    measurement,
+                    regression,
+                    fat_report,
+                ]:
                     if expected is not None and expected.artifact_id not in ref_ids:
                         self._append(
                             blockers,
@@ -593,6 +653,8 @@ class PreSiteCommissioningReadinessEvaluator:
             "regression": _artifact_ref(regression),
             "fat_report": _artifact_ref(fat_report),
             "evidence_bundle": _artifact_ref(evidence_bundle),
+            "project_source_manifest": _artifact_ref(source_manifest),
+            "guided_intake_readiness": _artifact_ref(intake_readiness),
         }
         state_snapshot = _scope_state_snapshot(self.repository, project_id)
         payload = {

{devagent_physical_engine-2.2.0 → devagent_physical_engine-2.3.1}/src/devagent_physical_engine/evidence_trust.py

@@ -296,7 +296,33 @@ class EvidenceBundleBuilder:
             "site_measurement": "SITE_MEASURED",
         }.get(source_kind, "MODEL_ONLY")
 
+        intake_readiness = _latest_matching(
+            self.repository,
+            project_id,
+            "guided_intake_readiness",
+            lambda item: item.twin_revision_id == revision.revision_id,
+        )
+        source_manifest = None
+        if intake_readiness is not None:
+            source_manifest_id = str(
+                intake_readiness.payload.get("source_manifest_artifact_id") or ""
+            ).strip()
+            if source_manifest_id:
+                candidate_manifest = _require_artifact(
+                    self.repository,
+                    project_id,
+                    source_manifest_id,
+                    "project_source_manifest",
+                )
+                if (
+                    candidate_manifest.twin_revision_id == revision.revision_id
+                    and candidate_manifest.artifact_hash
+                    == intake_readiness.payload.get("source_manifest_artifact_hash")
+                ):
+                    source_manifest = candidate_manifest
         ordered = [
+            source_manifest,
+            intake_readiness,
             campaign,
             requirement_set,
             verification_plan,

devagent_physical_engine-2.3.1/src/devagent_physical_engine/guided_intake_cli.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+
+from .guided_intake_v23 import GuidedIntakeError, analyze_source, write_intake_reports
+
+
+def _parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="devagent intake",
+        description="Inspect customer engineering files without requiring a fixed project format.",
+    )
+    parser.add_argument("source", help="Customer project folder")
+    parser.add_argument("--output", default=None, help="Results directory; defaults to <source>/devagent-results")
+    parser.add_argument("--json", action="store_true", dest="json_only")
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = _parser().parse_args(argv)
+    root = Path(args.source).expanduser().resolve()
+    output = Path(args.output).expanduser().resolve() if args.output else root / "devagent-results"
+    try:
+        analysis = analyze_source(root, exclude_paths=(output,))
+        manifest, readiness, guide = write_intake_reports(analysis, output)
+    except (GuidedIntakeError, OSError) as exc:
+        print(json.dumps({"intake_status": "ERROR", "failure_code": str(exc)}, indent=2))
+        return 10
+
+    payload = {
+        **analysis.readiness(),
+        "source_manifest": str(manifest),
+        "intake_readiness": str(readiness),
+        "intake_guide": str(guide),
+        "inventory_fingerprint": analysis.inventory_fingerprint,
+        "authority_fingerprint": analysis.authority_fingerprint,
+    }
+    if args.json_only:
+        print(json.dumps(payload, indent=2, sort_keys=True))
+        return 0
+
+    print("DevAgent Guided Intake")
+    print("=" * 28)
+    print(f"Status:               {analysis.intake_status}")
+    print(f"Authority resolved:   {analysis.authority_ready}")
+    print(f"Recognized files:     {analysis.recognized_files}")
+    print(f"Unknown files:        {analysis.unknown_files}")
+    print(f"Duplicate groups:     {len(analysis.duplicate_groups)}")
+    print(f"Source manifest:      {manifest}")
+    print(f"Intake guide:         {guide}")
+    print("\nVerification capabilities:")
+    for item in analysis.capabilities:
+        print(f"  {item.capability:<20} {item.state:<20} {item.reason}")
+    if analysis.unresolved_roles:
+        print("\nOptional confirmation:")
+        for role in analysis.unresolved_roles:
+            print(f"  - Select the authoritative {role.replace('_', ' ')} source.")
+    print("\nMissing files do not fail intake. Add more files later if stronger verification coverage is desired.")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())