deterministic-scenario-engine 3.0.0__tar.gz → 3.0.1__tar.gz

{deterministic_scenario_engine-3.0.0/src/deterministic_scenario_engine.egg-info → deterministic_scenario_engine-3.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deterministic-scenario-engine
-Version: 3.0.0
+Version: 3.0.1
 Summary: Reproducible, state-consistent business scenarios with deterministic ground truth
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/imshahinul/deterministic-scenario-engine
@@ -41,11 +41,13 @@ Dynamic: license-file
 
 Deterministic Scenario Engine (DSE) creates reproducible, state-consistent
 business histories and deterministic scenario suites with ground truth for
-testing. This source tree is the prepublication distribution 3.0.0 candidate.
+testing. Distribution 3.0.0 was published on October 9, 2026, on
+[PyPI](https://pypi.org/project/deterministic-scenario-engine/3.0.0/) and as a
+[GitHub Release](https://github.com/imshahinul/deterministic-scenario-engine/releases/tag/3.0.0).
 Distribution and execution compatibility identities are separate: public
 `ENGINE_VERSION` is 2.0.0, while the preserved DSL 1 path records Engine 1.0.0.
-This statement does not assert package-index publication; PyPI and GitHub
-Releases remain authoritative for public-release availability and history.
+PyPI and GitHub Releases remain authoritative for public-release availability
+and history.
 
 ## Why it exists
 
@@ -84,9 +86,9 @@ make expected behavior explicit.
 - canonical evidence bundles, ordered JSON/JSONL export, compatibility reports,
   explicit adapters, closed lossless migrations, and fixture-directory export
 
-The 3.0.0 candidate adds Engine 2.0.0 and DSL 2 while preserving Engine 1/DSL 1
+The 3.0.0 release adds Engine 2.0.0 and DSL 2 while preserving Engine 1/DSL 1
 behavior and immutable evidence. See the
-[3.0.0 candidate notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.0.md).
+[3.0.0 release notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.0.md).
 
 Core execution does not require a database, network service, plugin, or property
 testing framework. See [security assumptions and non-goals](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/security-and-non-goals.md).
@@ -106,6 +108,18 @@ python3 -m pip install deterministic-scenario-engine
 scenario --help
 ```
 
+Verify that the same active Python interpreter sees the expected distribution
+and observe the module location it actually imports:
+
+```console
+python3 -c 'from importlib.metadata import version; from pathlib import Path; import scenario_engine; print("DSE distribution:", version("deterministic-scenario-engine")); print("Imported module:", Path(scenario_engine.__file__).resolve())'
+```
+
+For this release the distribution is `3.0.1`; a source-development editable
+install resolves the module under its `src/scenario_engine` directory. The DSE
+distribution version is distinct from Engine 1 (`1.0.0`) and Engine 2 (`2.0.0`)
+compatibility versions.
+
 Install only the named optional integrations you need:
 
 ```console
@@ -165,15 +179,16 @@ self-contained offline HTML file from supported result/evidence.
 - [Security assumptions and non-goals](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/security-and-non-goals.md)
 - [Compatibility contract](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/compatibility.md)
 - [2.2.0 release notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-2.2.0.md)
-- [3.0.0 candidate notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.0.md)
+- [3.0.0 release notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.0.md)
+- [3.0.1 release notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.1.md)
 - [Phase 2 public contract, CLI, and hard bounds](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/phase2-public-contract.md)
 - [Phase 3 public contract and evidence interchange](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/phase3-public-contract.md)
 
 ## Status
 
 Distribution release identity and deterministic engine compatibility are
-separate contracts. This prepublication source tree reports distribution
-version 3.0.0 and public Engine 2.0.0. Engine 1 manifests remain exactly 1.0.0
+separate contracts. This source tree reports published distribution version
+3.0.1 and public Engine 2.0.0. Engine 1 manifests remain exactly 1.0.0
 with integer DSL 1; Engine 2 manifests use 2.0.0 with integer DSL 2. Supported
 Python versions are 3.11–3.14. Suite Run/2 is reader/schema support only; Engine
 2 suite orchestration, cross-major promotion, remote URI input, and implicit

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/README.md

@@ -4,11 +4,13 @@
 
 Deterministic Scenario Engine (DSE) creates reproducible, state-consistent
 business histories and deterministic scenario suites with ground truth for
-testing. This source tree is the prepublication distribution 3.0.0 candidate.
+testing. Distribution 3.0.0 was published on October 9, 2026, on
+[PyPI](https://pypi.org/project/deterministic-scenario-engine/3.0.0/) and as a
+[GitHub Release](https://github.com/imshahinul/deterministic-scenario-engine/releases/tag/3.0.0).
 Distribution and execution compatibility identities are separate: public
 `ENGINE_VERSION` is 2.0.0, while the preserved DSL 1 path records Engine 1.0.0.
-This statement does not assert package-index publication; PyPI and GitHub
-Releases remain authoritative for public-release availability and history.
+PyPI and GitHub Releases remain authoritative for public-release availability
+and history.
 
 ## Why it exists
 
@@ -47,9 +49,9 @@ make expected behavior explicit.
 - canonical evidence bundles, ordered JSON/JSONL export, compatibility reports,
   explicit adapters, closed lossless migrations, and fixture-directory export
 
-The 3.0.0 candidate adds Engine 2.0.0 and DSL 2 while preserving Engine 1/DSL 1
+The 3.0.0 release adds Engine 2.0.0 and DSL 2 while preserving Engine 1/DSL 1
 behavior and immutable evidence. See the
-[3.0.0 candidate notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.0.md).
+[3.0.0 release notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.0.md).
 
 Core execution does not require a database, network service, plugin, or property
 testing framework. See [security assumptions and non-goals](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/security-and-non-goals.md).
@@ -69,6 +71,18 @@ python3 -m pip install deterministic-scenario-engine
 scenario --help
 ```
 
+Verify that the same active Python interpreter sees the expected distribution
+and observe the module location it actually imports:
+
+```console
+python3 -c 'from importlib.metadata import version; from pathlib import Path; import scenario_engine; print("DSE distribution:", version("deterministic-scenario-engine")); print("Imported module:", Path(scenario_engine.__file__).resolve())'
+```
+
+For this release the distribution is `3.0.1`; a source-development editable
+install resolves the module under its `src/scenario_engine` directory. The DSE
+distribution version is distinct from Engine 1 (`1.0.0`) and Engine 2 (`2.0.0`)
+compatibility versions.
+
 Install only the named optional integrations you need:
 
 ```console
@@ -128,15 +142,16 @@ self-contained offline HTML file from supported result/evidence.
 - [Security assumptions and non-goals](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/security-and-non-goals.md)
 - [Compatibility contract](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/compatibility.md)
 - [2.2.0 release notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-2.2.0.md)
-- [3.0.0 candidate notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.0.md)
+- [3.0.0 release notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.0.md)
+- [3.0.1 release notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.1.md)
 - [Phase 2 public contract, CLI, and hard bounds](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/phase2-public-contract.md)
 - [Phase 3 public contract and evidence interchange](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/phase3-public-contract.md)
 
 ## Status
 
 Distribution release identity and deterministic engine compatibility are
-separate contracts. This prepublication source tree reports distribution
-version 3.0.0 and public Engine 2.0.0. Engine 1 manifests remain exactly 1.0.0
+separate contracts. This source tree reports published distribution version
+3.0.1 and public Engine 2.0.0. Engine 1 manifests remain exactly 1.0.0
 with integer DSL 1; Engine 2 manifests use 2.0.0 with integer DSL 2. Supported
 Python versions are 3.11–3.14. Suite Run/2 is reader/schema support only; Engine
 2 suite orchestration, cross-major promotion, remote URI input, and implicit

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/docs/api.md

@@ -13,8 +13,9 @@ exports.
 - `scenario_engine._version.ENGINE1_VERSION` — explicit historical Engine 1
   execution coordinate, `1.0.0`; not added to the frozen package-root exports.
 
-- `ENGINE_VERSION` — engine compatibility version recorded in manifests; for
-  current manifests it remains 1.0.0 independently of distribution version.
+- `ENGINE_VERSION` — engine compatibility version recorded in manifests:
+  Engine 1 Manifest/1 records 1.0.0, while Engine 2 Manifest/2 records 2.0.0;
+  both are independent of the distribution version.
 - `MISSING` — singleton semantic missing value, distinct from null.
 - `LogicalID(value: str)` — deterministic logical identifier value; users
   normally receive it from `$id` generation.

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/docs/dsl2-reference.md

@@ -1,6 +1,7 @@
 # DSL 2 logical-actor reference
 
-**Status: PREPUBLICATION — DSE distribution 3.0.0 candidate.**
+**Status: RELEASED — DSE distribution 3.0.0, published October 9, 2026.** See
+the [GitHub Release](https://github.com/imshahinul/deterministic-scenario-engine/releases/tag/3.0.0).
 
 DSL 2 is selected only by integer `dsl_version: 2` and executes with Engine
 2.0.0. It preserves DSL 1 expression, deterministic value, resource, plugin,

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/docs/quickstart.md

@@ -1,7 +1,6 @@
 # Canonical installed-package workflows
 
-**3.0.0 candidate documentation — PREPUBLICATION.** These commands apply to a
-qualified candidate installation and do not assert that 3.0.0 is on PyPI.
+**3.0.1 release documentation.** These commands apply to distribution 3.0.1.
 
 This is the canonical DSE user workflow document. Every ordinary command below
 uses the installed package and portable files created here; no source checkout,
@@ -16,6 +15,7 @@ example, a symlinked temporary-directory prefix) at filesystem trust boundaries.
 
 ```console
 python3 -m pip install deterministic-scenario-engine
+python3 -c 'from importlib.metadata import version; from pathlib import Path; import scenario_engine; print("DSE distribution:", version("deterministic-scenario-engine")); print("Imported module:", Path(scenario_engine.__file__).resolve())'
 export DSE_DEMO="$(cd "${TMPDIR:-/tmp}" && pwd -P)/dse-demo"
 rm -rf "$DSE_DEMO"
 mkdir -p "$DSE_DEMO"
@@ -37,6 +37,11 @@ sed 's/{$literal: 1}/{$literal: 2}/' "$DSE_DEMO/scenario.yaml" > "$DSE_DEMO/scen
 scenario --help
 ```
 
+The identity check uses the same active Python interpreter as installation. It
+should report DSE distribution `3.0.1`; the resolved module path shows the code
+Python actually imports. This distribution version is distinct from Engine 1
+(`1.0.0`) and Engine 2 (`2.0.0`) compatibility versions.
+
 Installing a checkout with `python3 -m pip install .` is
 **source-development-only**. Installed-package workflows are primary.
 

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/docs/release-notes-3.0.0.md

@@ -1,7 +1,11 @@
-# Deterministic Scenario Engine 3.0.0 candidate
+# Deterministic Scenario Engine 3.0.0
 
-**Status: PREPUBLICATION.** This document describes qualified candidate scope;
-it does not assert PyPI publication, a 3.0.0 tag, or a GitHub Release.
+**Status: RELEASED October 9, 2026.** Distribution 3.0.0 is published on
+[PyPI](https://pypi.org/project/deterministic-scenario-engine/3.0.0/) and as a
+[GitHub Release](https://github.com/imshahinul/deterministic-scenario-engine/releases/tag/3.0.0).
+
+This copy on `main` records the post-release publication state. The original
+published 3.0.0 tag retains the historical prepublication release-notes bytes.
 
 ## Added
 
@@ -38,8 +42,8 @@ promotion is supported.
 
 ## Publication verification
 
-Publication, if separately authorized, must use the exact retained reproducible
-wheel and sdist. Verify index hashes against qualification evidence, install the
-published artifacts outside the source tree on every supported Python, rerun
-DSL 1 and DSL 2 run/replay and hostile-input smokes, and inspect rendered
-metadata and links before recording release completion.
+The published release uses the exact retained reproducible wheel and sdist.
+Their production PyPI and GitHub Release SHA256 digests match the qualification
+evidence. Release verification installed the published artifacts outside the
+source tree on every supported Python, reran DSL 1 and DSL 2 run/replay and
+hostile-input smokes, and inspected rendered metadata and links.

deterministic_scenario_engine-3.0.1/docs/release-notes-3.0.1.md

@@ -0,0 +1,38 @@
+# Deterministic Scenario Engine 3.0.1
+
+DSE 3.0.1 is a compatibility-preserving patch release. The distribution version
+advances from 3.0.0 to 3.0.1; Engine 1/Manifest 1 remains 1.0.0 and Engine
+2/Manifest 2 remains 2.0.0. DSL, schema, canonical serialization, CLI grammar,
+and public Python API contracts are unchanged.
+
+## Changes since 3.0.0
+
+- Clarifies Engine 2 replay help, including the required Schedule/1 input.
+- Makes missing-schedule human diagnostics actionable while preserving the
+  machine-readable error contract.
+- Includes safe, allowlisted failing-field identifiers in relevant diagnostics
+  without exposing arbitrary input values.
+- Improves installed-distribution identity onboarding so users can verify both
+  package metadata and the module path imported by the active interpreter.
+- Clarifies the distinction between distribution, engine, and manifest versions.
+- Extends regression and release-maintenance coverage, including permanent
+  verification of authentic historical release tags.
+
+The earlier TRACK-A4 repair aligned a maintainer's local editable environment;
+it is not a shipped runtime feature of this release.
+
+## Compatibility and upgrade guidance
+
+Python 3.11, 3.12, 3.13, and 3.14 remain declared as supported. The runtime
+dependency remains `PyYAML==6.0.3`. Upgrade the distribution through the same
+Python interpreter used to run DSE, then verify `importlib.metadata.version` and
+`scenario_engine.__file__` as shown in the quickstart. Existing Engine 1 and
+Engine 2 evidence retains its established compatibility and fail-closed replay
+checks.
+
+## Known limits
+
+Engine 2 suite orchestration, cross-major promotion, remote URI input, implicit
+schedule-seed derivation, distributed execution, and evidence federation remain
+unsupported. This patch does not introduce new engine algorithms, performance
+claims, scientific benchmarks, or security certification.

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1/src/deterministic_scenario_engine.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deterministic-scenario-engine
-Version: 3.0.0
+Version: 3.0.1
 Summary: Reproducible, state-consistent business scenarios with deterministic ground truth
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/imshahinul/deterministic-scenario-engine
@@ -41,11 +41,13 @@ Dynamic: license-file
 
 Deterministic Scenario Engine (DSE) creates reproducible, state-consistent
 business histories and deterministic scenario suites with ground truth for
-testing. This source tree is the prepublication distribution 3.0.0 candidate.
+testing. Distribution 3.0.0 was published on October 9, 2026, on
+[PyPI](https://pypi.org/project/deterministic-scenario-engine/3.0.0/) and as a
+[GitHub Release](https://github.com/imshahinul/deterministic-scenario-engine/releases/tag/3.0.0).
 Distribution and execution compatibility identities are separate: public
 `ENGINE_VERSION` is 2.0.0, while the preserved DSL 1 path records Engine 1.0.0.
-This statement does not assert package-index publication; PyPI and GitHub
-Releases remain authoritative for public-release availability and history.
+PyPI and GitHub Releases remain authoritative for public-release availability
+and history.
 
 ## Why it exists
 
@@ -84,9 +86,9 @@ make expected behavior explicit.
 - canonical evidence bundles, ordered JSON/JSONL export, compatibility reports,
   explicit adapters, closed lossless migrations, and fixture-directory export
 
-The 3.0.0 candidate adds Engine 2.0.0 and DSL 2 while preserving Engine 1/DSL 1
+The 3.0.0 release adds Engine 2.0.0 and DSL 2 while preserving Engine 1/DSL 1
 behavior and immutable evidence. See the
-[3.0.0 candidate notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.0.md).
+[3.0.0 release notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.0.md).
 
 Core execution does not require a database, network service, plugin, or property
 testing framework. See [security assumptions and non-goals](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/security-and-non-goals.md).
@@ -106,6 +108,18 @@ python3 -m pip install deterministic-scenario-engine
 scenario --help
 ```
 
+Verify that the same active Python interpreter sees the expected distribution
+and observe the module location it actually imports:
+
+```console
+python3 -c 'from importlib.metadata import version; from pathlib import Path; import scenario_engine; print("DSE distribution:", version("deterministic-scenario-engine")); print("Imported module:", Path(scenario_engine.__file__).resolve())'
+```
+
+For this release the distribution is `3.0.1`; a source-development editable
+install resolves the module under its `src/scenario_engine` directory. The DSE
+distribution version is distinct from Engine 1 (`1.0.0`) and Engine 2 (`2.0.0`)
+compatibility versions.
+
 Install only the named optional integrations you need:
 
 ```console
@@ -165,15 +179,16 @@ self-contained offline HTML file from supported result/evidence.
 - [Security assumptions and non-goals](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/security-and-non-goals.md)
 - [Compatibility contract](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/compatibility.md)
 - [2.2.0 release notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-2.2.0.md)
-- [3.0.0 candidate notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.0.md)
+- [3.0.0 release notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.0.md)
+- [3.0.1 release notes](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/release-notes-3.0.1.md)
 - [Phase 2 public contract, CLI, and hard bounds](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/phase2-public-contract.md)
 - [Phase 3 public contract and evidence interchange](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/phase3-public-contract.md)
 
 ## Status
 
 Distribution release identity and deterministic engine compatibility are
-separate contracts. This prepublication source tree reports distribution
-version 3.0.0 and public Engine 2.0.0. Engine 1 manifests remain exactly 1.0.0
+separate contracts. This source tree reports published distribution version
+3.0.1 and public Engine 2.0.0. Engine 1 manifests remain exactly 1.0.0
 with integer DSL 1; Engine 2 manifests use 2.0.0 with integer DSL 2. Supported
 Python versions are 3.11–3.14. Suite Run/2 is reader/schema support only; Engine
 2 suite orchestration, cross-major promotion, remote URI input, and implicit

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/src/deterministic_scenario_engine.egg-info/SOURCES.txt

@@ -20,6 +20,7 @@ docs/product-evidence-gate.md
 docs/quickstart.md
 docs/release-notes-2.2.0.md
 docs/release-notes-3.0.0.md
+docs/release-notes-3.0.1.md
 docs/release-process.md
 docs/reproducibility.md
 docs/schemathesis.md

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/src/scenario_engine/_version.py

@@ -1,5 +1,5 @@
 """Authoritative distribution and deterministic compatibility versions."""
 
-VERSION = "3.0.0"
+VERSION = "3.0.1"
 ENGINE_VERSION = "2.0.0"
 ENGINE1_VERSION = "1.0.0"

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/src/scenario_engine/cli/main.py

@@ -220,7 +220,11 @@ def _parser() -> argparse.ArgumentParser:
             "Missing required replay data fails closed with exit 5."
         ),
     )
-    replay.add_argument("source", help="local suite.run/1 replay artifact path or - for stdin")
+    replay.add_argument(
+        "source",
+        help=("local suite.run/1 or scenario.result/2 artifact path (or - for stdin); "
+              "scenario.result/2 replay requires scenario.schedule/1 via --schedule"),
+    )
     replay.add_argument("--scenario", required=True, help="explicit local scenario YAML path")
     replay.add_argument(
         "--inputs",
@@ -1290,6 +1294,29 @@ def _render_replay_human(diagnostic: HumanDiagnostic) -> None:
     _diagnostic("; ".join(fields))
 
 
+_SAFE_ENGINE2_EVIDENCE_FIELDS = frozenset({
+    "actors", "artifacts", "classification", "contract", "dsl_version", "engine_version",
+    "evidence", "execution", "execution.dsl_version", "execution.engine_version",
+    "execution.generator_versions", "execution.id_algorithm_version", "execution.locale",
+    "execution.reference_clock_start", "execution.rng_algorithm_version", "execution.root_seed",
+    "failure", "final_logical_clock", "final_state", "generator_versions", "history",
+    "input_resource_hashes", "json", "manifest", "manifest_hash", "members", "outcome",
+    "outcome.schedule", "records", "records.outcome", "records.ready_actors",
+    "records.selected_actor", "reference_clock_start", "result", "result_hash", "root_seed",
+    "run_index", "scenario_hash", "scenario_id", "schedule", "schedule_hash",
+    "schedule_reference", "schedule_reference.contract", "schedule_reference.scenario_hash",
+    "schedule_reference.schedule_hash", "schedule_seed", "scheduler_contract", "semantic value",
+    "suite", "suite_hash", "terminal", "terminal.classification", "terminal.failure",
+})
+
+
+def _render_engine2_evidence_human(diagnostic: HumanDiagnostic, field: str) -> None:
+    """Render one source-defined field identifier without reflecting supplied values."""
+    sys.stderr.write(render_human_diagnostic(diagnostic))
+    if field in _SAFE_ENGINE2_EVIDENCE_FIELDS:
+        sys.stderr.write(f"field:\n{field}\n")
+
+
 def _path_reason(error: Exception) -> PathReason | None:
     """Classify existing path-security failures without replacing their checks."""
     if isinstance(error, _CLIError):
@@ -1435,6 +1462,8 @@ def main(argv: Sequence[str] | None = None) -> int:
             )
             if json_mode:
                 _emit_machine(diagnostic, error.code)
+            elif error.diagnostic_code == "SCHEDULE_EVIDENCE_REQUIRED":
+                sys.stderr.write(render_human_diagnostic(diagnostic))
             else:
                 _diagnostic(str(error))
         return int(error.code)
@@ -1489,7 +1518,7 @@ def main(argv: Sequence[str] | None = None) -> int:
             if json_mode:
                 _emit_machine(diagnostic, code)
             else:
-                sys.stderr.write(render_human_diagnostic(diagnostic))
+                _render_engine2_evidence_human(diagnostic, error.field)
             return int(code)
         if code is CLIExitCode.INTERNAL:
             message = "unexpected internal error"

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_1_0e_packaging_release_candidate.py

@@ -54,7 +54,7 @@ class Phase10EPackagingReleaseCandidateTests(unittest.TestCase):
             "scenario_engine._version.VERSION",
         )
         # Phase 2 changes package identity, not the frozen deterministic contract.
-        self.assertEqual(VERSION, "3.0.0")
+        self.assertEqual(VERSION, "3.0.1")
         self.assertEqual(ENGINE_VERSION, "2.0.0")
 
     def test_license_readme_and_build_backend_metadata(self):

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_2_10_workflow_demonstrators.py

@@ -148,7 +148,7 @@ def test_fresh_tree_wheel_supports_workflow_public_commands(tmp_path: Path) -> N
         check=True,
     )
     wheels = list(wheelhouse.glob(f"deterministic_scenario_engine-{VERSION}-*.whl"))
-    assert VERSION == "3.0.0"
+    assert VERSION == "3.0.1"
     assert len(wheels) == 1
     wheel = wheels[0]
     installed = tmp_path / "installed"
@@ -175,7 +175,7 @@ def test_fresh_tree_wheel_supports_workflow_public_commands(tmp_path: Path) -> N
         text=True,
     )
     distribution_version, import_path = identity.stdout.splitlines()
-    assert distribution_version == VERSION == "3.0.0"
+    assert distribution_version == VERSION == "3.0.1"
     assert Path(import_path).is_relative_to(installed)
     validate = subprocess.run(
         [sys.executable, "-m", "scenario_engine.cli", "--json", "validate", "examples/cart.yaml"],

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_2_12_public_contract_docs_freeze.py

@@ -63,7 +63,7 @@ def test_versions_errors_commands_and_entry_points_are_frozen() -> None:
     from scenario_engine.oracle_assertions import ORACLE_ASSERTION_SCHEMA_VERSION
     from scenario_engine.suite import READ_SCHEMA_VERSION, SUITE_SCHEMA_VERSION
 
-    assert VERSION == "3.0.0"
+    assert VERSION == "3.0.1"
     assert (COMPOSITION_CONTRACT_VERSION, MATRIX_PLAN_CONTRACT_VERSION) == (
         "composition.modules/1", "matrix.plan/1")
     assert (READ_SCHEMA_VERSION, SUITE_SCHEMA_VERSION) == (

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_2_13_packaging_fresh_install_rc.py

@@ -59,7 +59,7 @@ def _cases():
 def test_version_roles_are_explicit_and_dsl_remains_one() -> None:
     config = tomllib.loads((ROOT / "pyproject.toml").read_text(encoding="utf-8"))
     assert config["tool"]["setuptools"]["dynamic"]["version"]["attr"] == "scenario_engine._version.VERSION"
-    assert VERSION == "3.0.0"
+    assert VERSION == "3.0.1"
     assert ENGINE_VERSION == scenario_engine.ENGINE_VERSION == "2.0.0"
     assert ENGINE1_VERSION == "1.0.0"
     _, result = _result("cart.yaml", "s")

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_2_1_v1_read_contract.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 from hashlib import sha256
 import importlib
+import inspect
 import json
 from pathlib import Path
 import unittest
@@ -100,12 +101,27 @@ class V1ReadTests(unittest.TestCase):
 
     def test_suite_import_has_no_runtime_side_effects(self):
         import scenario_engine.suite as suite
-        with patch("builtins.open", side_effect=AssertionError("file attempted")):
+
+        real_open = open
+
+        def reject_module_file_io(*args, **kwargs):
+            frame = inspect.currentframe().f_back
+            while frame is not None and frame.f_globals.get("__name__") == "unittest.mock":
+                frame = frame.f_back
+            if (
+                frame is not None
+                and frame.f_globals.get("__name__") == "_pytest.assertion.rewrite"
+                and frame.f_code.co_name == "_read_pyc"
+            ):
+                return real_open(*args, **kwargs)
+            raise AssertionError("file attempted")
+
+        with patch("builtins.open", side_effect=reject_module_file_io):
             self.assertIs(importlib.reload(suite), suite)
 
     def test_v1_api_version_and_three_result_goldens_remain_unchanged(self):
         expected = scenario_engine.__all__
-        self.assertEqual(VERSION, "3.0.0")
+        self.assertEqual(VERSION, "3.0.1")
         self.assertEqual(scenario_engine.__all__, expected)
         cart_source = (ROOT / "examples" / "phase0_1b_cart.yaml").read_text()
         cart = run_scenario(compile_document(parse_yaml(cart_source)), "s")

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_2_2_composition.py

@@ -376,7 +376,7 @@ def test_suite_manifest_identity_order_child_reference_and_v1_preservation(tmp_p
 
 def test_top_level_api_and_v1_parser_are_unchanged(tmp_path: Path) -> None:
     assert "load_composed_suite" not in scenario_engine.__all__
-    assert VERSION == "3.0.0"
+    assert VERSION == "3.0.1"
     root_without_composition = _root("    alpha: alpha.yaml").replace(
         "composition:\n  modules:\n    alpha: alpha.yaml\n", "",
     )

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_2_3_matrix.py

@@ -235,7 +235,7 @@ steps:
 
 def test_top_level_api_and_package_version_are_unchanged() -> None:
     assert "MatrixPlan" not in scenario_engine.__all__
-    assert VERSION == "3.0.0"
+    assert VERSION == "3.0.1"
 
 
 def test_static_matrix_package_has_no_nondeterministic_or_unsafe_imports() -> None:

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_2_4_batch.py

@@ -277,7 +277,7 @@ def test_public_boundary_version_preservation_and_static_safety() -> None:
     from scenario_engine._version import VERSION
 
     assert "BatchPlan" not in scenario_engine.__all__
-    assert VERSION == "3.0.0"
+    assert VERSION == "3.0.1"
     forbidden = {"random", "secrets", "socket", "subprocess", "importlib", "os", "time", "urllib"}
     root = Path(__file__).parents[1] / "src/scenario_engine/batch"
     for path in root.glob("*.py"):

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_2_5_inspect_explain.py

@@ -151,4 +151,4 @@ def test_bounds_are_exact_and_fail_deterministically(monkeypatch) -> None:
 
 def test_root_api_and_package_version_remain_frozen() -> None:
     assert "inspect_result" not in scenario_engine.__all__
-    assert VERSION == "3.0.0"
+    assert VERSION == "3.0.1"

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_2_7_cli_product_surface.py

@@ -250,4 +250,4 @@ def test_cli_static_purity_version_and_console_script_contract() -> None:
         assert imported.isdisjoint(forbidden)
     pyproject = (ROOT / "pyproject.toml").read_text(encoding="utf-8")
     assert 'scenario = "scenario_engine.cli:main"' in pyproject
-    assert 'VERSION = "3.0.0"' in (ROOT / "src/scenario_engine/_version.py").read_text(encoding="utf-8")
+    assert 'VERSION = "3.0.1"' in (ROOT / "src/scenario_engine/_version.py").read_text(encoding="utf-8")

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_3_11_public_contract_docs_freeze.py

@@ -166,7 +166,7 @@ def test_versions_publication_security_reference_and_links_are_frozen(tmp_path:
     from scenario_engine.reference_packs import ecommerce_domain_pack, export_ecommerce_evidence
 
     result = run_scenario(compile_document(parse_yaml((ROOT / "examples/cart.yaml").read_text())), "phase3.11")
-    assert VERSION == "3.0.0" and ENGINE_VERSION == "2.0.0"
+    assert VERSION == "3.0.1" and ENGINE_VERSION == "2.0.0"
     assert result.manifest.engine_version == "1.0.0" and result.manifest.dsl_version == 1
     contract = CONTRACT.read_text()
     assert "current source distribution version=2.1.0" in contract

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_3_1_evidence_bundle_contract.py

@@ -253,7 +253,7 @@ def test_phase2_root_api_and_version_roles_remain_frozen() -> None:
     from scenario_engine.suite import RUN_SCHEMA_VERSION, SUITE_SCHEMA_VERSION
 
     assert tuple(scenario_engine.__all__) == FROZEN_ROOT_EXPORTS
-    assert VERSION == "3.0.0"
+    assert VERSION == "3.0.1"
     assert ENGINE_VERSION == "2.0.0"
     assert RUN_SCHEMA_VERSION == "suite.run/1"
     assert SUITE_SCHEMA_VERSION == "suite.manifest/1"

{deterministic_scenario_engine-3.0.0 → deterministic_scenario_engine-3.0.1}/tests/test_phase_4_10_canonical_workflow_help.py

@@ -65,6 +65,17 @@ def test_top_level_and_phase4_command_help_are_coherent() -> None:
         assert all(phrase in result.stdout for phrase in phrases)
 
 
+def test_replay_help_identifies_engine1_and_engine2_evidence() -> None:
+    result = invoke("replay", "--help")
+    assert result.returncode == 0
+    help_text = " ".join(result.stdout.decode("utf-8").split())
+    for phrase in (
+        "suite.run/1", "scenario.result/2", "- for stdin", "--scenario", "--inputs",
+        "--schedule", "scenario.result/2 replay requires scenario.schedule/1 via --schedule",
+    ):
+        assert phrase in help_text
+
+
 def test_public_docs_have_no_checkpoint_or_checkout_dependency() -> None:
     docs = (ROOT / "README.md").read_text() + QUICKSTART.read_text()
     forbidden = (