devagent-physical-engine 1.3.0__tar.gz → 1.3.1__tar.gz

{devagent_physical_engine-1.3.0/src/devagent_physical_engine.egg-info → devagent_physical_engine-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devagent-physical-engine
-Version: 1.3.0
+Version: 1.3.1
 Summary: Production-grade verification-first robotics evidence runtime with one-command customer intake, deterministic Twin lineage, measured physical verification, replay inspection, regression, and FAT evidence.
 Author: Tom Ha
 License: All Rights Reserved
@@ -82,7 +82,7 @@ Python 3.11+ is required.
 Install:
 
 ```bash
-python -m pip install --upgrade devagent-physical-engine==1.3.0
+python -m pip install --upgrade devagent-physical-engine==1.3.1
 ```
 
 Verify the installed version:
@@ -94,7 +94,7 @@ python -c "import devagent_physical_engine as d; print(d.__version__)"
 Expected:
 
 ```text
-1.3.0
+1.3.1
 ```
 
 Run DevAgent on the customer project folder:
@@ -107,18 +107,20 @@ That is the normal starting point.
 
 You do **not** need to manually initialize a DevAgent project, choose artifact IDs, convert an XLSX sheet to CSV, or understand the internal evidence database before using Simple Mode.
 
-If you also want physical simulation when an exact qualified execution path exists:
+Request physical simulation when an exact qualified execution path exists:
 
 ```bash
 devagent verify ./customer-project --simulate
 ```
 
-If you want DevAgent to open the generated Evidence Viewer:
+Open the generated Evidence Viewer after verification:
 
 ```bash
 devagent verify ./customer-project --simulate --open
 ```
 
+`--open` requests the report in a **new browser tab** after the terminal verification summary is complete. DevAgent requests that the browser not raise itself over the terminal, then the CLI returns so the same terminal can be used for replay and inspection commands. Desktop/browser policy may still choose to focus the new tab.
+
 For machine-readable output:
 
 ```bash
@@ -143,6 +145,59 @@ Results:           <customer-project>/devagent-results/
 
 ---
 
+# What the user sees in the terminal
+
+Human Simple Mode keeps the terminal as the primary run surface. Example:
+
+```text
+[DevAgent +   0.00s] START         RUNNING    source=ACME_CNC_CELL_TEST
+[DevAgent +   0.00s] INTAKE        RUNNING    scanning and classifying customer engineering files
+[DevAgent +   0.42s] REQUIREMENTS  READY      customer requirements normalized
+[DevAgent +   0.61s] TWIN          NORMALIZED customer Twin draft normalized
+[DevAgent +   0.85s] PROJECT       READY      project_id=acme-cell
+[DevAgent +   0.91s] PLAN          READY      artifact=...
+[DevAgent +   1.02s] SIMULATION    BLOCKED    imported_customer_twin_execution_adapter_not_yet_qualified
+[DevAgent +   1.11s] CAMPAIGN      COMPLETE   artifact=...
+[DevAgent +   1.18s] FAT           COMPLETE   artifact=...
+[DevAgent +   1.24s] EVIDENCE      COMPLETE   bundle=...
+[DevAgent +   1.25s] COMPLETE      DONE       state=verification_incomplete release_ready=False real_execution_allowed=False
+[DevAgent +   1.25s] REPORT        OPENING    new tab requested; terminal will remain available: .../EVIDENCE.html
+[DevAgent +   1.26s] REPORT        DISPATCHED browser request completed; terminal is available
+```
+
+If verification runs longer than five seconds, DevAgent emits a heartbeat such as:
+
+```text
+[DevAgent +   5.00s] ENGINE        RUNNING    verification is still active
+```
+
+The same human progress trace is persisted to:
+
+```text
+<customer-project>/devagent-results/RUN.log
+```
+
+After an Evidence Bundle exists, DevAgent prints a copy/paste replay command. Example:
+
+```bash
+devagent-commercial --db ~/.devagent/projects.db replay \
+  acme-cell \
+  EVIDENCE_BUNDLE_ARTIFACT \
+  --output ./devagent-results/REPLAY.json
+```
+
+If simulation was blocked and no measured runtime case exists, replay is expected to fail closed. If qualified simulation runtime evidence exists, replay reconstructs and verifies that exact persisted case without commanding a robot.
+
+To suppress human progress while keeping the final human summary:
+
+```bash
+devagent verify ./customer-project --no-progress
+```
+
+`--json` remains machine-clean and suppresses human progress automatically.
+
+---
+
 # How to use the engine
 
 ## 1. Give DevAgent the engineering folder you already have
@@ -205,7 +260,7 @@ DETERMINISTIC TWIN VALIDATION
 VERIFICATION PLAN / CAMPAIGN / FAT
       |
       v
-EVIDENCE VIEWER
+EVIDENCE VIEWER + RUN LOG + REPLAY HANDOFF
 ```
 
 Unknown facts remain unknown. DevAgent does not fill engineering gaps with guesses.
@@ -259,6 +314,7 @@ Typical first-run output:
 ```text
 ACME_CNC_CELL_TEST/
 └── devagent-results/
+    ├── RUN.log
     ├── SUMMARY.json
     ├── INTAKE.json
     ├── QUESTIONS.md
@@ -381,6 +437,7 @@ When enough explicit evidence exists to build the Twin and deterministic campaig
 ```text
 ACME_CNC_CELL_TEST/
 └── devagent-results/
+    ├── RUN.log
     ├── SUMMARY.json
     ├── INTAKE.json
     ├── QUESTIONS.md
@@ -388,7 +445,8 @@ ACME_CNC_CELL_TEST/
     │   ├── requirements.csv
     │   └── devagent-twin.yaml
     ├── FAT_REPORT.html
-    └── EVIDENCE.html
+    ├── EVIDENCE.html
+    └── REPLAY.json          # when replay succeeds with --output
 ```
 
 `normalized/devagent-twin.yaml` is generated evidence mapping. It is not an independent source of truth and does not bypass Twin validation.
@@ -454,7 +512,7 @@ That is intentional. A blocked simulation is more trustworthy than a visually im
 
 ---
 
-## 5. Open the Evidence Viewer
+## 5. Open the Evidence Viewer and continue in the terminal
 
 When evidence lineage can be rendered:
 
@@ -468,6 +526,22 @@ or:
 devagent verify ./ACME_CNC_CELL_TEST --simulate --open
 ```
 
+The sequence is intentionally:
+
+```text
+terminal verification completes
+        ↓
+final summary printed
+        ↓
+replay command printed
+        ↓
+Evidence Viewer requested in a new browser tab
+        ↓
+CLI returns
+        ↓
+same terminal is available for replay / artifact inspection / next command
+```
+
 The viewer is read-only and is intended to answer:
 
 - Which requirement was evaluated?
@@ -487,6 +561,22 @@ The trust principle is simple:
 
 # Understanding the results
 
+## `RUN.log`
+
+Persistent copy of the human terminal progress trace. It is presentation/debug evidence and does not replace immutable engineering artifacts.
+
+Inspect it later:
+
+```bash
+cat ./customer-project/devagent-results/RUN.log
+```
+
+or follow it while another process is running:
+
+```bash
+tail -f ./customer-project/devagent-results/RUN.log
+```
+
 ## `SUMMARY.json`
 
 This is the primary machine-readable result of Simple Mode.
@@ -527,11 +617,11 @@ Each discovered file is associated with a bounded role and authority decision.
 Examples:
 
 ```text
-requirements.xlsx      -> requirements
-layout.yaml            -> engineering_data
-ur5e.urdf              -> robot_model
-safety_requirements.pdf -> manual engineering document
-expected/...           -> test_oracle, used_for_authority=false
+requirements.xlsx       -> requirements
+layout.yaml              -> engineering_data
+ur5e.urdf                -> robot_model
+safety_requirements.pdf  -> manual engineering document
+expected/...             -> test_oracle, used_for_authority=false
 ```
 
 ## `QUESTIONS.md`
@@ -554,6 +644,10 @@ A missing metric or unsupported requirement is not silently changed to PASS. It
 
 Read-only evidence view of requirement/Twin/artifact lineage.
 
+## `REPLAY.json`
+
+Written only when replay reconstruction succeeds and `--output` was supplied. It is a canonical replay manifest, not a new robot or simulator execution.
+
 ---
 
 # Requirements and verdicts
@@ -829,6 +923,18 @@ devagent-commercial evidence-viewer warehouse-cnc-04 \
 
 ## 11. Replay persisted lineage
 
+Read-only inspection first:
+
+```bash
+devagent-commercial replay \
+  warehouse-cnc-04 \
+  EVIDENCE_BUNDLE \
+  --qualification-root ~/.devagent/physical-qualification \
+  --output replay-manifest.json
+```
+
+Optionally record immutable `replay_verification` evidence after a successful reconstruction:
+
 ```bash
 devagent-commercial replay \
   warehouse-cnc-04 \
@@ -1089,11 +1195,11 @@ It is **not** a replacement for:
 
 # Project status
 
-**v1.3.0 — Production/Stable software workflow**
+**v1.3.1 — Production/Stable software workflow**
 
 The bounded software/evidence workflow is production-oriented and continuously tested across Python 3.11, 3.12, and 3.13.
 
-The v1.3 release candidate includes:
+The v1.3.1 patch release includes:
 
 ```text
 one-command customer intake
@@ -1102,8 +1208,11 @@ immutable project/Twin lineage
 deterministic verification campaigns
 measured evidence binding
 FAT generation
+professional Evidence Viewer report palette
+terminal stage-by-stage progress + RUN.log
+new-tab report handoff without intentionally raising over terminal
+copy/paste replay command after Evidence Bundle generation
 Evidence Bundle
-Evidence Viewer
 replay reconstruction
 change impact
 regression

{devagent_physical_engine-1.3.0 → devagent_physical_engine-1.3.1}/README.md

@@ -41,7 +41,7 @@ Python 3.11+ is required.
 Install:
 
 ```bash
-python -m pip install --upgrade devagent-physical-engine==1.3.0
+python -m pip install --upgrade devagent-physical-engine==1.3.1
 ```
 
 Verify the installed version:
@@ -53,7 +53,7 @@ python -c "import devagent_physical_engine as d; print(d.__version__)"
 Expected:
 
 ```text
-1.3.0
+1.3.1
 ```
 
 Run DevAgent on the customer project folder:
@@ -66,18 +66,20 @@ That is the normal starting point.
 
 You do **not** need to manually initialize a DevAgent project, choose artifact IDs, convert an XLSX sheet to CSV, or understand the internal evidence database before using Simple Mode.
 
-If you also want physical simulation when an exact qualified execution path exists:
+Request physical simulation when an exact qualified execution path exists:
 
 ```bash
 devagent verify ./customer-project --simulate
 ```
 
-If you want DevAgent to open the generated Evidence Viewer:
+Open the generated Evidence Viewer after verification:
 
 ```bash
 devagent verify ./customer-project --simulate --open
 ```
 
+`--open` requests the report in a **new browser tab** after the terminal verification summary is complete. DevAgent requests that the browser not raise itself over the terminal, then the CLI returns so the same terminal can be used for replay and inspection commands. Desktop/browser policy may still choose to focus the new tab.
+
 For machine-readable output:
 
 ```bash
@@ -102,6 +104,59 @@ Results:           <customer-project>/devagent-results/
 
 ---
 
+# What the user sees in the terminal
+
+Human Simple Mode keeps the terminal as the primary run surface. Example:
+
+```text
+[DevAgent +   0.00s] START         RUNNING    source=ACME_CNC_CELL_TEST
+[DevAgent +   0.00s] INTAKE        RUNNING    scanning and classifying customer engineering files
+[DevAgent +   0.42s] REQUIREMENTS  READY      customer requirements normalized
+[DevAgent +   0.61s] TWIN          NORMALIZED customer Twin draft normalized
+[DevAgent +   0.85s] PROJECT       READY      project_id=acme-cell
+[DevAgent +   0.91s] PLAN          READY      artifact=...
+[DevAgent +   1.02s] SIMULATION    BLOCKED    imported_customer_twin_execution_adapter_not_yet_qualified
+[DevAgent +   1.11s] CAMPAIGN      COMPLETE   artifact=...
+[DevAgent +   1.18s] FAT           COMPLETE   artifact=...
+[DevAgent +   1.24s] EVIDENCE      COMPLETE   bundle=...
+[DevAgent +   1.25s] COMPLETE      DONE       state=verification_incomplete release_ready=False real_execution_allowed=False
+[DevAgent +   1.25s] REPORT        OPENING    new tab requested; terminal will remain available: .../EVIDENCE.html
+[DevAgent +   1.26s] REPORT        DISPATCHED browser request completed; terminal is available
+```
+
+If verification runs longer than five seconds, DevAgent emits a heartbeat such as:
+
+```text
+[DevAgent +   5.00s] ENGINE        RUNNING    verification is still active
+```
+
+The same human progress trace is persisted to:
+
+```text
+<customer-project>/devagent-results/RUN.log
+```
+
+After an Evidence Bundle exists, DevAgent prints a copy/paste replay command. Example:
+
+```bash
+devagent-commercial --db ~/.devagent/projects.db replay \
+  acme-cell \
+  EVIDENCE_BUNDLE_ARTIFACT \
+  --output ./devagent-results/REPLAY.json
+```
+
+If simulation was blocked and no measured runtime case exists, replay is expected to fail closed. If qualified simulation runtime evidence exists, replay reconstructs and verifies that exact persisted case without commanding a robot.
+
+To suppress human progress while keeping the final human summary:
+
+```bash
+devagent verify ./customer-project --no-progress
+```
+
+`--json` remains machine-clean and suppresses human progress automatically.
+
+---
+
 # How to use the engine
 
 ## 1. Give DevAgent the engineering folder you already have
@@ -164,7 +219,7 @@ DETERMINISTIC TWIN VALIDATION
 VERIFICATION PLAN / CAMPAIGN / FAT
       |
       v
-EVIDENCE VIEWER
+EVIDENCE VIEWER + RUN LOG + REPLAY HANDOFF
 ```
 
 Unknown facts remain unknown. DevAgent does not fill engineering gaps with guesses.
@@ -218,6 +273,7 @@ Typical first-run output:
 ```text
 ACME_CNC_CELL_TEST/
 └── devagent-results/
+    ├── RUN.log
     ├── SUMMARY.json
     ├── INTAKE.json
     ├── QUESTIONS.md
@@ -340,6 +396,7 @@ When enough explicit evidence exists to build the Twin and deterministic campaig
 ```text
 ACME_CNC_CELL_TEST/
 └── devagent-results/
+    ├── RUN.log
     ├── SUMMARY.json
     ├── INTAKE.json
     ├── QUESTIONS.md
@@ -347,7 +404,8 @@ ACME_CNC_CELL_TEST/
     │   ├── requirements.csv
     │   └── devagent-twin.yaml
     ├── FAT_REPORT.html
-    └── EVIDENCE.html
+    ├── EVIDENCE.html
+    └── REPLAY.json          # when replay succeeds with --output
 ```
 
 `normalized/devagent-twin.yaml` is generated evidence mapping. It is not an independent source of truth and does not bypass Twin validation.
@@ -413,7 +471,7 @@ That is intentional. A blocked simulation is more trustworthy than a visually im
 
 ---
 
-## 5. Open the Evidence Viewer
+## 5. Open the Evidence Viewer and continue in the terminal
 
 When evidence lineage can be rendered:
 
@@ -427,6 +485,22 @@ or:
 devagent verify ./ACME_CNC_CELL_TEST --simulate --open
 ```
 
+The sequence is intentionally:
+
+```text
+terminal verification completes
+        ↓
+final summary printed
+        ↓
+replay command printed
+        ↓
+Evidence Viewer requested in a new browser tab
+        ↓
+CLI returns
+        ↓
+same terminal is available for replay / artifact inspection / next command
+```
+
 The viewer is read-only and is intended to answer:
 
 - Which requirement was evaluated?
@@ -446,6 +520,22 @@ The trust principle is simple:
 
 # Understanding the results
 
+## `RUN.log`
+
+Persistent copy of the human terminal progress trace. It is presentation/debug evidence and does not replace immutable engineering artifacts.
+
+Inspect it later:
+
+```bash
+cat ./customer-project/devagent-results/RUN.log
+```
+
+or follow it while another process is running:
+
+```bash
+tail -f ./customer-project/devagent-results/RUN.log
+```
+
 ## `SUMMARY.json`
 
 This is the primary machine-readable result of Simple Mode.
@@ -486,11 +576,11 @@ Each discovered file is associated with a bounded role and authority decision.
 Examples:
 
 ```text
-requirements.xlsx      -> requirements
-layout.yaml            -> engineering_data
-ur5e.urdf              -> robot_model
-safety_requirements.pdf -> manual engineering document
-expected/...           -> test_oracle, used_for_authority=false
+requirements.xlsx       -> requirements
+layout.yaml              -> engineering_data
+ur5e.urdf                -> robot_model
+safety_requirements.pdf  -> manual engineering document
+expected/...             -> test_oracle, used_for_authority=false
 ```
 
 ## `QUESTIONS.md`
@@ -513,6 +603,10 @@ A missing metric or unsupported requirement is not silently changed to PASS. It
 
 Read-only evidence view of requirement/Twin/artifact lineage.
 
+## `REPLAY.json`
+
+Written only when replay reconstruction succeeds and `--output` was supplied. It is a canonical replay manifest, not a new robot or simulator execution.
+
 ---
 
 # Requirements and verdicts
@@ -788,6 +882,18 @@ devagent-commercial evidence-viewer warehouse-cnc-04 \
 
 ## 11. Replay persisted lineage
 
+Read-only inspection first:
+
+```bash
+devagent-commercial replay \
+  warehouse-cnc-04 \
+  EVIDENCE_BUNDLE \
+  --qualification-root ~/.devagent/physical-qualification \
+  --output replay-manifest.json
+```
+
+Optionally record immutable `replay_verification` evidence after a successful reconstruction:
+
 ```bash
 devagent-commercial replay \
   warehouse-cnc-04 \
@@ -1048,11 +1154,11 @@ It is **not** a replacement for:
 
 # Project status
 
-**v1.3.0 — Production/Stable software workflow**
+**v1.3.1 — Production/Stable software workflow**
 
 The bounded software/evidence workflow is production-oriented and continuously tested across Python 3.11, 3.12, and 3.13.
 
-The v1.3 release candidate includes:
+The v1.3.1 patch release includes:
 
 ```text
 one-command customer intake
@@ -1061,8 +1167,11 @@ immutable project/Twin lineage
 deterministic verification campaigns
 measured evidence binding
 FAT generation
+professional Evidence Viewer report palette
+terminal stage-by-stage progress + RUN.log
+new-tab report handoff without intentionally raising over terminal
+copy/paste replay command after Evidence Bundle generation
 Evidence Bundle
-Evidence Viewer
 replay reconstruction
 change impact
 regression

{devagent_physical_engine-1.3.0 → devagent_physical_engine-1.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devagent-physical-engine"
-version = "1.3.0"
+version = "1.3.1"
 description = "Production-grade verification-first robotics evidence runtime with one-command customer intake, deterministic Twin lineage, measured physical verification, replay inspection, regression, and FAT evidence."
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"

{devagent_physical_engine-1.3.0 → devagent_physical_engine-1.3.1}/src/devagent_physical_engine/__init__.py

@@ -129,4 +129,4 @@ __all__ = [
     "SimpleVerifyResult",
 ]
 
-__version__ = "1.3.0"
+__version__ = "1.3.1"

{devagent_physical_engine-1.3.0 → devagent_physical_engine-1.3.1}/src/devagent_physical_engine/evidence_trust.py

@@ -801,14 +801,14 @@ class EvidenceViewer:
 <html><head><meta charset='utf-8'><meta name='viewport' content='width=device-width,initial-scale=1'>
 <title>DevAgent Evidence Viewer - {escape(str(project['name']))}</title>
 <style>
-:root{{font-family:Inter,ui-sans-serif,system-ui,sans-serif;color:#151515;background:#f6f7f9}}
-body{{margin:0}}main{{max-width:1280px;margin:auto;padding:24px}}header{{background:#111827;color:white;padding:22px;border-radius:14px}}
-h1,h2{{margin-top:0}}.muted{{color:#6b7280}}.grid{{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:12px;margin:16px 0}}
-.card{{background:white;border:1px solid #e5e7eb;border-radius:12px;padding:16px}}table{{width:100%;border-collapse:collapse;background:white}}
-th,td{{border-bottom:1px solid #e5e7eb;padding:10px;vertical-align:top;text-align:left}}th{{background:#f3f4f6;position:sticky;top:0}}
+:root{{font-family:Inter,ui-sans-serif,system-ui,sans-serif;color:#1f2937;background:#f4f7fb}}
+body{{margin:0}}main{{max-width:1280px;margin:auto;padding:24px}}header{{background:#1f4e78;color:#fff;padding:22px;border:1px solid #17365d;border-radius:14px;box-shadow:0 8px 24px rgba(31,78,120,.16)}}
+header h1{{color:#fff}}header small{{color:#eaf2f8}}h1,h2{{margin-top:0}}h2{{color:#17365d}}.muted{{color:#66788a}}.grid{{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:12px;margin:16px 0}}
+.card{{background:#fff;border:1px solid #d9e2ec;border-radius:12px;padding:16px}}table{{width:100%;border-collapse:collapse;background:#fff;border:1px solid #d9e2ec}}
+th,td{{border-bottom:1px solid #d9e2ec;padding:10px;vertical-align:top;text-align:left}}th{{background:#eaf1f8;color:#17365d;position:sticky;top:0}}
 code.hash{{word-break:break-all;font-size:11px}}.badge{{display:inline-block;padding:3px 8px;border-radius:999px;font-weight:700;font-size:12px}}
 .badge.pass{{background:#dcfce7;color:#166534}}.badge.fail{{background:#fee2e2;color:#991b1b}}.badge.warn{{background:#fef3c7;color:#92400e}}.badge.neutral{{background:#e5e7eb;color:#374151}}
-a{{color:#1d4ed8}}details{{margin-top:6px}}.boundary{{border-left:4px solid #f59e0b}}
+a{{color:#245b91}}details{{margin-top:6px}}.boundary{{border-left:4px solid #d97706}}
 </style></head><body><main>
 <header><h1>DevAgent Evidence Viewer</h1><div>{escape(str(project['name']))}</div>
 <small>Project {escape(str(project['project_id']))} · Site {escape(str(project['site_id']))} · Workcell {escape(str(project['workcell_id']))}</small></header>