deterministic-scenario-engine 2.1.0__tar.gz → 2.1.1__tar.gz

{deterministic_scenario_engine-2.1.0/src/deterministic_scenario_engine.egg-info → deterministic_scenario_engine-2.1.1}/PKG-INFO

@@ -1,8 +1,13 @@
 Metadata-Version: 2.4
 Name: deterministic-scenario-engine
-Version: 2.1.0
+Version: 2.1.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
+Project-URL: Documentation, https://github.com/imshahinul/deterministic-scenario-engine/tree/main/docs
+Project-URL: Source, https://github.com/imshahinul/deterministic-scenario-engine
+Project-URL: Issues, https://github.com/imshahinul/deterministic-scenario-engine/issues
+Project-URL: Release Notes, https://github.com/imshahinul/deterministic-scenario-engine/releases
 Keywords: deterministic,scenario,testing,fixtures,replay
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
@@ -35,11 +40,10 @@ Dynamic: license-file
 
 Deterministic Scenario Engine (DSE) creates reproducible, state-consistent
 business histories and deterministic scenario suites with ground truth for
-testing. The published distribution is `deterministic-scenario-engine` 2.0.0.
-Phase 3 evidence-interchange capabilities are implemented on `main` and the
-current source release candidate reports distribution version 2.1.0, while 2.1.0
-is not published. Its deterministic compatibility version remains
-`ENGINE_VERSION == "1.0.0"`, and its DSL version remains integer 1.
+testing. The source-tree distribution version is 2.1.1. Distribution release
+identity and deterministic compatibility identity are separate:
+`ENGINE_VERSION` remains 1.0.0 and DSL version remains 1. For authoritative
+public-release availability and history, see PyPI and GitHub Releases.
 
 ## Why it exists
 
@@ -74,11 +78,11 @@ make expected behavior explicit.
   explicit adapters, closed lossless migrations, and fixture-directory export
 
 Core execution does not require a database, network service, plugin, or property
-testing framework. See [security assumptions and non-goals](docs/security-and-non-goals.md).
+testing framework. See [security assumptions and non-goals](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/security-and-non-goals.md).
 Neither Phase 2 nor Phase 3 adds hidden discovery, network, randomness,
 wall-clock, or ambient environment semantics. The historical Phase 2 contract
-is frozen in the [Phase 2 public contract](docs/phase2-public-contract.md); the
-additive evidence surface is frozen in the [Phase 3 public contract](docs/phase3-public-contract.md).
+is frozen in the [Phase 2 public contract](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/phase2-public-contract.md); the
+additive evidence surface is frozen in the [Phase 3 public contract](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/phase3-public-contract.md).
 
 ## Installation
 
@@ -98,13 +102,13 @@ Install only the named optional integrations you need:
 /tmp/scenario-engine-docs-venv/bin/python -m pip install '.[schemathesis]'
 ```
 
-The published distribution is `deterministic-scenario-engine` 2.0.0. Install the package
-with `pip install deterministic-scenario-engine`, or select an optional integration
-with a command such as `pip install 'deterministic-scenario-engine[pytest]'`.
+Install the package with `pip install deterministic-scenario-engine`, or select
+an optional integration with a command such as
+`pip install 'deterministic-scenario-engine[pytest]'`.
 
 ## Minimal quickstart
 
-The public [cart scenario](examples/cart.yaml) is an executable DSL 1 document.
+The public [cart scenario](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/examples/cart.yaml) is an executable DSL 1 document.
 Run it from the repository root:
 
 ```python
@@ -139,32 +143,31 @@ normalized result contains the same data under its `state` field.
 Generation derives from semantic `ExecutionAddress` values, not consumption of
 a mutable global random stream. Exact replay requires the same canonical
 scenario, explicit inputs, algorithms/plugins, and recorded execution context.
-Unsupported cross-version replay fails explicitly. See the [determinism model](docs/determinism.md),
-[reproducibility guide](docs/reproducibility.md), and normative
-[compatibility contract](docs/compatibility.md).
+Unsupported cross-version replay fails explicitly. See the [determinism model](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/determinism.md),
+[reproducibility guide](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/reproducibility.md), and normative
+[compatibility contract](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/compatibility.md).
 
 ## Documentation
 
-- [Quickstart](docs/quickstart.md)
-- [DSL 1 reference](docs/dsl-reference.md)
-- [Determinism model](docs/determinism.md)
-- [Reproducibility and replay](docs/reproducibility.md)
-- [Testing, faults, and oracle](docs/testing-oracle.md)
-- [Plugins](docs/plugins.md)
-- [SQLAlchemy adapter](docs/sqlalchemy.md)
-- [Hypothesis integration](docs/hypothesis.md)
-- [Schemathesis integration](docs/schemathesis.md)
-- [Public Python API](docs/api.md)
-- [Security assumptions and non-goals](docs/security-and-non-goals.md)
-- [Compatibility contract](docs/compatibility.md)
-- [Phase 2 public contract, CLI, and hard bounds](docs/phase2-public-contract.md)
-- [Phase 3 public contract and evidence interchange](docs/phase3-public-contract.md)
+- [Quickstart](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/quickstart.md)
+- [DSL 1 reference](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/dsl-reference.md)
+- [Determinism model](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/determinism.md)
+- [Reproducibility and replay](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/reproducibility.md)
+- [Testing, faults, and oracle](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/testing-oracle.md)
+- [Plugins](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/plugins.md)
+- [SQLAlchemy adapter](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/sqlalchemy.md)
+- [Hypothesis integration](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/hypothesis.md)
+- [Schemathesis integration](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/schemathesis.md)
+- [Public Python API](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/api.md)
+- [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)
+- [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. Version 2.0.0 has been published to PyPI and as a GitHub
-Release. This source tree reports the unpublished 2.1.0 release candidate;
-generated core manifests retain `ENGINE_VERSION` 1.0.0 and DSL 1. No 2.1.0 tag,
-GitHub Release, or package-index publication exists. The project is licensed
-under Apache-2.0.
+separate contracts. This source tree reports distribution version 2.1.1;
+generated core manifests retain `ENGINE_VERSION` 1.0.0 and DSL 1. PyPI and
+GitHub Releases are the authoritative sources for public-release availability
+and history. The project is licensed under Apache-2.0.

{deterministic_scenario_engine-2.1.0 → deterministic_scenario_engine-2.1.1}/README.md

@@ -4,11 +4,10 @@
 
 Deterministic Scenario Engine (DSE) creates reproducible, state-consistent
 business histories and deterministic scenario suites with ground truth for
-testing. The published distribution is `deterministic-scenario-engine` 2.0.0.
-Phase 3 evidence-interchange capabilities are implemented on `main` and the
-current source release candidate reports distribution version 2.1.0, while 2.1.0
-is not published. Its deterministic compatibility version remains
-`ENGINE_VERSION == "1.0.0"`, and its DSL version remains integer 1.
+testing. The source-tree distribution version is 2.1.1. Distribution release
+identity and deterministic compatibility identity are separate:
+`ENGINE_VERSION` remains 1.0.0 and DSL version remains 1. For authoritative
+public-release availability and history, see PyPI and GitHub Releases.
 
 ## Why it exists
 
@@ -43,11 +42,11 @@ make expected behavior explicit.
   explicit adapters, closed lossless migrations, and fixture-directory export
 
 Core execution does not require a database, network service, plugin, or property
-testing framework. See [security assumptions and non-goals](docs/security-and-non-goals.md).
+testing framework. See [security assumptions and non-goals](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/security-and-non-goals.md).
 Neither Phase 2 nor Phase 3 adds hidden discovery, network, randomness,
 wall-clock, or ambient environment semantics. The historical Phase 2 contract
-is frozen in the [Phase 2 public contract](docs/phase2-public-contract.md); the
-additive evidence surface is frozen in the [Phase 3 public contract](docs/phase3-public-contract.md).
+is frozen in the [Phase 2 public contract](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/phase2-public-contract.md); the
+additive evidence surface is frozen in the [Phase 3 public contract](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/phase3-public-contract.md).
 
 ## Installation
 
@@ -67,13 +66,13 @@ Install only the named optional integrations you need:
 /tmp/scenario-engine-docs-venv/bin/python -m pip install '.[schemathesis]'
 ```
 
-The published distribution is `deterministic-scenario-engine` 2.0.0. Install the package
-with `pip install deterministic-scenario-engine`, or select an optional integration
-with a command such as `pip install 'deterministic-scenario-engine[pytest]'`.
+Install the package with `pip install deterministic-scenario-engine`, or select
+an optional integration with a command such as
+`pip install 'deterministic-scenario-engine[pytest]'`.
 
 ## Minimal quickstart
 
-The public [cart scenario](examples/cart.yaml) is an executable DSL 1 document.
+The public [cart scenario](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/examples/cart.yaml) is an executable DSL 1 document.
 Run it from the repository root:
 
 ```python
@@ -108,32 +107,31 @@ normalized result contains the same data under its `state` field.
 Generation derives from semantic `ExecutionAddress` values, not consumption of
 a mutable global random stream. Exact replay requires the same canonical
 scenario, explicit inputs, algorithms/plugins, and recorded execution context.
-Unsupported cross-version replay fails explicitly. See the [determinism model](docs/determinism.md),
-[reproducibility guide](docs/reproducibility.md), and normative
-[compatibility contract](docs/compatibility.md).
+Unsupported cross-version replay fails explicitly. See the [determinism model](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/determinism.md),
+[reproducibility guide](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/reproducibility.md), and normative
+[compatibility contract](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/compatibility.md).
 
 ## Documentation
 
-- [Quickstart](docs/quickstart.md)
-- [DSL 1 reference](docs/dsl-reference.md)
-- [Determinism model](docs/determinism.md)
-- [Reproducibility and replay](docs/reproducibility.md)
-- [Testing, faults, and oracle](docs/testing-oracle.md)
-- [Plugins](docs/plugins.md)
-- [SQLAlchemy adapter](docs/sqlalchemy.md)
-- [Hypothesis integration](docs/hypothesis.md)
-- [Schemathesis integration](docs/schemathesis.md)
-- [Public Python API](docs/api.md)
-- [Security assumptions and non-goals](docs/security-and-non-goals.md)
-- [Compatibility contract](docs/compatibility.md)
-- [Phase 2 public contract, CLI, and hard bounds](docs/phase2-public-contract.md)
-- [Phase 3 public contract and evidence interchange](docs/phase3-public-contract.md)
+- [Quickstart](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/quickstart.md)
+- [DSL 1 reference](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/dsl-reference.md)
+- [Determinism model](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/determinism.md)
+- [Reproducibility and replay](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/reproducibility.md)
+- [Testing, faults, and oracle](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/testing-oracle.md)
+- [Plugins](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/plugins.md)
+- [SQLAlchemy adapter](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/sqlalchemy.md)
+- [Hypothesis integration](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/hypothesis.md)
+- [Schemathesis integration](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/schemathesis.md)
+- [Public Python API](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/api.md)
+- [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)
+- [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. Version 2.0.0 has been published to PyPI and as a GitHub
-Release. This source tree reports the unpublished 2.1.0 release candidate;
-generated core manifests retain `ENGINE_VERSION` 1.0.0 and DSL 1. No 2.1.0 tag,
-GitHub Release, or package-index publication exists. The project is licensed
-under Apache-2.0.
+separate contracts. This source tree reports distribution version 2.1.1;
+generated core manifests retain `ENGINE_VERSION` 1.0.0 and DSL 1. PyPI and
+GitHub Releases are the authoritative sources for public-release availability
+and history. The project is licensed under Apache-2.0.

deterministic_scenario_engine-2.1.1/docs/product-evidence-gate.md

@@ -0,0 +1,65 @@
+# Product evidence gate
+
+A successfully shipped phase does not automatically authorize design or
+implementation of the next feature phase.
+
+## Demand evidence requirement
+
+Before Phase 4 product scope can be frozen, every proposed substantial
+capability must trace to credible evidence of an actual problem. Acceptable
+evidence includes:
+
+- an external user report or request;
+- a public issue or discussion describing real friction;
+- observed integration failure or friction;
+- a repeated support question;
+- a real downstream implementation needing the capability;
+- credible usage or adoption evidence combined with a specific observed
+  problem.
+
+The following is insufficient by itself: ability to build something,
+architectural fit or elegance, previous deferral, download counts, GitHub stars,
+benchmark opportunities, or feature parity with another tool.
+
+## Maintenance exceptions
+
+Product-demand evidence is not required before addressing a confirmed bug,
+security vulnerability, compatibility regression, release-integrity defect,
+dependency or platform breakage, data-loss or correctness issue, or maintenance
+needed to preserve an existing public contract. Such work instead requires
+evidence of the defect or risk.
+
+## Phase 4 evidence packet
+
+No Phase 4 architecture freeze or implementation prompt is authorized until an
+evidence packet exists. For every candidate substantial feature, it must record:
+
+- problem statement;
+- evidence source and date;
+- affected user or workflow;
+- observed current workaround or failure;
+- why DSE itself should solve the problem;
+- why external tooling is insufficient;
+- minimum useful outcome;
+- evidence strength.
+
+Classify each candidate as `SUPPORTED_BY_EVIDENCE`, `WEAK_EVIDENCE`, or
+`NO_EVIDENCE`. Only supported items may enter MUST or SHOULD scope. Weak items
+remain observational; unsupported items go to the parking lot or are deferred.
+This policy does not itself create a Phase 4 feature list.
+
+## Adoption observation
+
+Downloads, stars, forks, clones, and traffic may be recorded as context but do
+not prove a feature need. Preferred evidence combines a specific observed
+problem, credible user/workflow context, and repeatability or consequence.
+Quantitative adoption data is supporting evidence, not the product requirement.
+
+Until qualifying external problem evidence and the required packet exist:
+
+```text
+PHASE4_AUTHORIZED=NO
+PHASE4_ARCHITECTURE_STARTED=NO
+PHASE4_IMPLEMENTATION_STARTED=NO
+NEXT_ACTIVITY=ADOPTION_AND_PROBLEM_OBSERVATION
+```

deterministic_scenario_engine-2.1.1/docs/release-process.md

@@ -0,0 +1,63 @@
+# Release process
+
+The package README is the PyPI long description. It must describe durable
+product and version semantics, not transient publication state. Statements such
+as "unpublished", "no current-version tag", "no GitHub Release", or "no
+package-index publication" belong only in checkpoint evidence, release audits,
+or temporary release-candidate reports.
+
+## Pre-RC
+
+Before building artifacts:
+
+- run the README release-state-neutrality test;
+- require `PRE_RC_PYPI_LINK_PORTABILITY=PASS` by rejecting repository-relative
+  file links in the package README and checking internal anchors separately;
+- confirm the configured package long-description material passes the same
+  neutrality test.
+
+## RC
+
+Release-candidate evidence may record that publication, a tag, or a release is
+absent. Package long-description material may not encode those transient facts.
+
+## Pre-upload
+
+Immediately before `twine upload`, rerun the source README neutrality test and
+inspect the accepted wheel and sdist metadata to confirm their packaged
+README/long description is release-state neutral. Require
+`PREUPLOAD_PYPI_LINK_PORTABILITY=PASS` for both artifact descriptions, run
+`twine check` and record `TWINE_RENDER_CHECK=PASS`, and resolve every important
+absolute documentation target to record `PYPI_LINK_TARGET_CHECK=PASS`.
+
+## Publication
+
+Publish the exact accepted artifacts. Do not rebuild between acceptance and
+publication.
+
+## Post-publication completion gate
+
+Using fresh public observations rather than pre-upload text, verify:
+
+- the PyPI version exists and its hashes exactly match the accepted artifacts;
+- a production installation passes;
+- the release tag targets the exact accepted commit;
+- the GitHub Release exists and its asset hashes exactly match;
+- the canonical README remains consistent with durable version semantics;
+- package documentation still satisfies the release-state policy;
+- fresh inspection of the rendered PyPI project page proves that documentation,
+  examples, security, compatibility, license, and repository links resolve to
+  their intended destinations, recording `POSTPUBLICATION_PYPI_LINK_SMOKE=PASS`.
+
+`twine check` alone is not sufficient for link portability. The post-publication
+gate must inspect the live PyPI description and its rendered link targets.
+
+Only after every post-publication check passes may checkpoint evidence record
+`PHASE_COMPLETE=YES`. A post-publication check must never rely solely on text
+prepared before upload.
+
+Published wheel and sdist metadata is immutable. If stale long-description text
+has already shipped, record it as a known published-artifact limitation; do not
+rewrite, rebuild, republish, or yank an otherwise accepted release merely to
+alter that text. The durable correction applies to canonical `main` and future
+artifacts.

{deterministic_scenario_engine-2.1.0 → deterministic_scenario_engine-2.1.1}/pyproject.toml

@@ -25,6 +25,13 @@ classifiers = [
 ]
 dependencies = ["PyYAML==6.0.3"]
 
+[project.urls]
+Homepage = "https://github.com/imshahinul/deterministic-scenario-engine"
+Documentation = "https://github.com/imshahinul/deterministic-scenario-engine/tree/main/docs"
+Source = "https://github.com/imshahinul/deterministic-scenario-engine"
+Issues = "https://github.com/imshahinul/deterministic-scenario-engine/issues"
+"Release Notes" = "https://github.com/imshahinul/deterministic-scenario-engine/releases"
+
 [project.scripts]
 scenario = "scenario_engine.cli:main"
 

{deterministic_scenario_engine-2.1.0 → deterministic_scenario_engine-2.1.1/src/deterministic_scenario_engine.egg-info}/PKG-INFO

@@ -1,8 +1,13 @@
 Metadata-Version: 2.4
 Name: deterministic-scenario-engine
-Version: 2.1.0
+Version: 2.1.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
+Project-URL: Documentation, https://github.com/imshahinul/deterministic-scenario-engine/tree/main/docs
+Project-URL: Source, https://github.com/imshahinul/deterministic-scenario-engine
+Project-URL: Issues, https://github.com/imshahinul/deterministic-scenario-engine/issues
+Project-URL: Release Notes, https://github.com/imshahinul/deterministic-scenario-engine/releases
 Keywords: deterministic,scenario,testing,fixtures,replay
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
@@ -35,11 +40,10 @@ Dynamic: license-file
 
 Deterministic Scenario Engine (DSE) creates reproducible, state-consistent
 business histories and deterministic scenario suites with ground truth for
-testing. The published distribution is `deterministic-scenario-engine` 2.0.0.
-Phase 3 evidence-interchange capabilities are implemented on `main` and the
-current source release candidate reports distribution version 2.1.0, while 2.1.0
-is not published. Its deterministic compatibility version remains
-`ENGINE_VERSION == "1.0.0"`, and its DSL version remains integer 1.
+testing. The source-tree distribution version is 2.1.1. Distribution release
+identity and deterministic compatibility identity are separate:
+`ENGINE_VERSION` remains 1.0.0 and DSL version remains 1. For authoritative
+public-release availability and history, see PyPI and GitHub Releases.
 
 ## Why it exists
 
@@ -74,11 +78,11 @@ make expected behavior explicit.
   explicit adapters, closed lossless migrations, and fixture-directory export
 
 Core execution does not require a database, network service, plugin, or property
-testing framework. See [security assumptions and non-goals](docs/security-and-non-goals.md).
+testing framework. See [security assumptions and non-goals](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/security-and-non-goals.md).
 Neither Phase 2 nor Phase 3 adds hidden discovery, network, randomness,
 wall-clock, or ambient environment semantics. The historical Phase 2 contract
-is frozen in the [Phase 2 public contract](docs/phase2-public-contract.md); the
-additive evidence surface is frozen in the [Phase 3 public contract](docs/phase3-public-contract.md).
+is frozen in the [Phase 2 public contract](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/phase2-public-contract.md); the
+additive evidence surface is frozen in the [Phase 3 public contract](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/phase3-public-contract.md).
 
 ## Installation
 
@@ -98,13 +102,13 @@ Install only the named optional integrations you need:
 /tmp/scenario-engine-docs-venv/bin/python -m pip install '.[schemathesis]'
 ```
 
-The published distribution is `deterministic-scenario-engine` 2.0.0. Install the package
-with `pip install deterministic-scenario-engine`, or select an optional integration
-with a command such as `pip install 'deterministic-scenario-engine[pytest]'`.
+Install the package with `pip install deterministic-scenario-engine`, or select
+an optional integration with a command such as
+`pip install 'deterministic-scenario-engine[pytest]'`.
 
 ## Minimal quickstart
 
-The public [cart scenario](examples/cart.yaml) is an executable DSL 1 document.
+The public [cart scenario](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/examples/cart.yaml) is an executable DSL 1 document.
 Run it from the repository root:
 
 ```python
@@ -139,32 +143,31 @@ normalized result contains the same data under its `state` field.
 Generation derives from semantic `ExecutionAddress` values, not consumption of
 a mutable global random stream. Exact replay requires the same canonical
 scenario, explicit inputs, algorithms/plugins, and recorded execution context.
-Unsupported cross-version replay fails explicitly. See the [determinism model](docs/determinism.md),
-[reproducibility guide](docs/reproducibility.md), and normative
-[compatibility contract](docs/compatibility.md).
+Unsupported cross-version replay fails explicitly. See the [determinism model](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/determinism.md),
+[reproducibility guide](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/reproducibility.md), and normative
+[compatibility contract](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/compatibility.md).
 
 ## Documentation
 
-- [Quickstart](docs/quickstart.md)
-- [DSL 1 reference](docs/dsl-reference.md)
-- [Determinism model](docs/determinism.md)
-- [Reproducibility and replay](docs/reproducibility.md)
-- [Testing, faults, and oracle](docs/testing-oracle.md)
-- [Plugins](docs/plugins.md)
-- [SQLAlchemy adapter](docs/sqlalchemy.md)
-- [Hypothesis integration](docs/hypothesis.md)
-- [Schemathesis integration](docs/schemathesis.md)
-- [Public Python API](docs/api.md)
-- [Security assumptions and non-goals](docs/security-and-non-goals.md)
-- [Compatibility contract](docs/compatibility.md)
-- [Phase 2 public contract, CLI, and hard bounds](docs/phase2-public-contract.md)
-- [Phase 3 public contract and evidence interchange](docs/phase3-public-contract.md)
+- [Quickstart](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/quickstart.md)
+- [DSL 1 reference](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/dsl-reference.md)
+- [Determinism model](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/determinism.md)
+- [Reproducibility and replay](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/reproducibility.md)
+- [Testing, faults, and oracle](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/testing-oracle.md)
+- [Plugins](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/plugins.md)
+- [SQLAlchemy adapter](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/sqlalchemy.md)
+- [Hypothesis integration](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/hypothesis.md)
+- [Schemathesis integration](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/schemathesis.md)
+- [Public Python API](https://github.com/imshahinul/deterministic-scenario-engine/blob/main/docs/api.md)
+- [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)
+- [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. Version 2.0.0 has been published to PyPI and as a GitHub
-Release. This source tree reports the unpublished 2.1.0 release candidate;
-generated core manifests retain `ENGINE_VERSION` 1.0.0 and DSL 1. No 2.1.0 tag,
-GitHub Release, or package-index publication exists. The project is licensed
-under Apache-2.0.
+separate contracts. This source tree reports distribution version 2.1.1;
+generated core manifests retain `ENGINE_VERSION` 1.0.0 and DSL 1. PyPI and
+GitHub Releases are the authoritative sources for public-release availability
+and history. The project is licensed under Apache-2.0.

{deterministic_scenario_engine-2.1.0 → deterministic_scenario_engine-2.1.1}/src/deterministic_scenario_engine.egg-info/SOURCES.txt

@@ -12,7 +12,9 @@ docs/phase2-public-contract.md
 docs/phase3-architecture.md
 docs/phase3-public-contract.md
 docs/plugins.md
+docs/product-evidence-gate.md
 docs/quickstart.md
+docs/release-process.md
 docs/reproducibility.md
 docs/schemathesis.md
 docs/security-and-non-goals.md
@@ -182,4 +184,5 @@ tests/test_phase_3_4_evidence_adapter_contract.py
 tests/test_phase_3_5_compatibility_migration_planner.py
 tests/test_phase_3_6_lossless_migrations_fixture_export.py
 tests/test_phase_3_7_cli_interchange_surface.py
-tests/test_phase_3_8_ecommerce_evidence_workflow.py
+tests/test_phase_3_8_ecommerce_evidence_workflow.py
+tests/test_readme_pypi_portability.py

{deterministic_scenario_engine-2.1.0 → deterministic_scenario_engine-2.1.1}/src/scenario_engine/_version.py

@@ -1,4 +1,4 @@
 """Authoritative distribution and deterministic compatibility versions."""
 
-VERSION = "2.1.0"
+VERSION = "2.1.1"
 ENGINE_VERSION = "1.0.0"

{deterministic_scenario_engine-2.1.0 → deterministic_scenario_engine-2.1.1}/tests/test_phase_1_0e_packaging_release_candidate.py

@@ -5,6 +5,7 @@ from hashlib import sha256
 from importlib.metadata import EntryPoint
 import json
 from pathlib import Path
+import re
 import sys
 import tomllib
 import unittest
@@ -53,13 +54,20 @@ class Phase10EPackagingReleaseCandidateTests(unittest.TestCase):
             "scenario_engine._version.VERSION",
         )
         # Phase 2 changes package identity, not the frozen deterministic contract.
-        self.assertEqual(VERSION, "2.1.0")
+        self.assertEqual(VERSION, "2.1.1")
         self.assertEqual(ENGINE_VERSION, "1.0.0")
 
     def test_license_readme_and_build_backend_metadata(self):
         self.assertEqual(self.project["license"], "Apache-2.0")
         self.assertEqual(self.project["license-files"], ["LICENSE"])
         self.assertEqual(self.project["readme"], "README.md")
+        self.assertEqual(self.project["urls"], {
+            "Homepage": "https://github.com/imshahinul/deterministic-scenario-engine",
+            "Documentation": "https://github.com/imshahinul/deterministic-scenario-engine/tree/main/docs",
+            "Source": "https://github.com/imshahinul/deterministic-scenario-engine",
+            "Issues": "https://github.com/imshahinul/deterministic-scenario-engine/issues",
+            "Release Notes": "https://github.com/imshahinul/deterministic-scenario-engine/releases",
+        })
         self.assertIn("Apache License\n", (ROOT / "LICENSE").read_text(encoding="utf-8"))
         self.assertEqual(self.config["build-system"]["build-backend"], "setuptools.build_meta")
         self.assertEqual(self.config["build-system"]["requires"], ["setuptools>=77"])
@@ -120,29 +128,26 @@ class Phase10EPackagingReleaseCandidateTests(unittest.TestCase):
             historical_payload["manifest"].pop("engine_version")
             self.assertEqual(current_payload, historical_payload)
 
-    def test_docs_are_publication_ready_without_temporal_or_host_claims(self):
+    def test_package_readme_is_release_state_neutral(self):
         readme = (ROOT / "README.md").read_text(encoding="utf-8")
         quickstart = (ROOT / "docs" / "quickstart.md").read_text(encoding="utf-8")
         combined = f"{readme}\n{quickstart}".lower()
         self.assertIn("pip install deterministic-scenario-engine", combined)
-        # HISTORICAL_CHECKPOINT_FACT: this test predates publication of 2.0.0.
-        # CURRENT_DOCUMENTATION_CONTRACT: stable release facts may be stated, but
-        # stale future-publication claims and transient local-RC guidance may not.
-        for stale_claim in (
-            "future publication",
-            "not currently available from pypi",
-            "has not been published",
-            "unpublished 2.0.0",
-            "no pypi or github release has occurred yet",
-        ):
-            with self.subTest(stale_claim=stale_claim):
-                self.assertNotIn(stale_claim, combined)
-        self.assertNotIn("github.com/", combined)
         self.assertNotIn("/users/", combined)
         self.assertNotIn("phase3_2_validation_venv", combined)
-        self.assertIn("2.0.0 has been published", combined)
-        self.assertIn("2.1.0", combined)
-        self.assertIn("not published", combined)
+
+        current_version = re.escape(VERSION.lower())
+        forbidden_patterns = (
+            rf"(?:unpublished|not\s+published)[^\n]{{0,80}}{current_version}",
+            rf"{current_version}[^\n]{{0,80}}(?:unpublished|not\s+published)",
+            rf"no\s+{current_version}\s+tag(?:\s+exists)?",
+            r"no\s+github\s+release(?:\s+exists)?",
+            r"no\s+(?:package-index|pypi)\s+publication(?:\s+exists)?",
+            r"publication\s+has\s+not\s+occurred",
+        )
+        for pattern in forbidden_patterns:
+            with self.subTest(pattern=pattern):
+                self.assertIsNone(re.search(pattern, readme.lower()))
 
     def test_top_level_api_is_unchanged_by_version_authority_module(self):
         self.assertNotIn("VERSION", scenario_engine.__all__)

{deterministic_scenario_engine-2.1.0 → deterministic_scenario_engine-2.1.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 == "2.1.0"
+    assert VERSION == "2.1.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 == "2.1.0"
+    assert distribution_version == VERSION == "2.1.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-2.1.0 → deterministic_scenario_engine-2.1.1}/tests/test_phase_2_12_public_contract_docs_freeze.py

@@ -62,7 +62,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 == "2.1.0"
+    assert VERSION == "2.1.1"
     assert (COMPOSITION_CONTRACT_VERSION, MATRIX_PLAN_CONTRACT_VERSION) == (
         "composition.modules/1", "matrix.plan/1")
     assert (READ_SCHEMA_VERSION, SUITE_SCHEMA_VERSION) == (