Release v2.0.0 → v2.1.0: beehave rewrite + scoped generated tests

.github/workflows/ci.yml

@@ -34,6 +34,10 @@ jobs:
 
       - run: uv run ruff format --check .
 
+      - run: uv run mypy beehave
+
+      - run: uv run python -m mypy.stubtest beehave --allowlist .stubtest_allowlist
+
   test:
     name: Test
     runs-on: ubuntu-latest

.stubtest_allowlist

@@ -0,0 +1,13 @@
+# stubtest allowlist — documented false positives.
+# Each line is a regex matched against the error's object path.
+#
+# beehave.step.step — mypy 2.3.0's @contextmanager inference erases
+# positional-only parameter names to None; stubtest then synthesizes
+# __arg0/__arg1, which fail to match the runtime-preserved keyword/text.
+# The .pyi and .py are faithful (both declare positional-only keyword, text);
+# this is a tool quirk, not contract drift. Tracked in
+# .cache/beehave-v2/journal.md (build cycle 1 green). Backstopped by the 9
+# tests in tests/integration/step_cm_test.py (behavioral coverage) and
+# `mypy --strict beehave` (.pyi-internal consistency). Re-verify manually if
+# step's signature changes.
+beehave.step.step

beehave/__init__.py

@@ -1,3 +1,3 @@
-"""beehave — BDD living documentation in sync."""
+from beehave.step import step as step
 
-__version__ = "0.3.1"
+__version__ = "2.2.0"

beehave/__init__.pyi

@@ -0,0 +1,10 @@
+# Public package surface for beehave v2.
+#
+# - `step` is the executable `with`-block CM (re-exported; lives in
+#   `beehave.step`).
+# - `__version__` is the single source of truth (interview L1 Constraint 3;
+#   the `== "2.0.0"` assertion is deferred to deliver — only the
+#   declaration lives here).
+from beehave.step import step as step
+
+__version__: str