refactor: rename package + generalize framework + use consensus scope

- Rename the package to ``lean-ethereum-testing``
- Rename `uv` workspace package to ``packages/testing``
- Refactor the package into a generalized framework component and
  ``consensus_testing`` module that focuses on testing the consensus
  protocol. This opens up the possibility of adding execution-specific
  testing in the future.
- Use `tests/consensus/{fork}` as consensus tests that generate vectors.
- Uses a ``--layer`` flag for ``fill`` that defaults to ``consensus`` scope
  we don't even have to think about this separation for now.

Author: fselmo

CLAUDE.md

@@ -50,7 +50,7 @@ uv run tox                        # Everything (checks + tests + docs)
 2. **Spec tests** (`tests/spec_tests/`) - Generate JSON test vectors via fillers
 
 **Test Filling Framework:**
-- Pytest plugin in `packages/tests/src/lean_spec_tests/pytest_plugins/filler.py`
+- Pytest plugin in `packages/testing/src/consensus_testing/pytest_plugins/filler.py`
 - Write spec tests using `state_transition_test` or `fork_choice_test` fixtures
 - These fixtures are type aliases that create test vectors when called
 - Run `uv run fill --fork=devnet --clean` to generate fixtures in `fixtures/`

packages/tests/README.md packages/testing/README.mdpackages/tests/README.md renamed to packages/testing/README.md

@@ -1,6 +1,6 @@
-# Lean Spec Tests
+# Lean Ethereum Specification Testing Framework
 
-Consensus test authoring framework for Lean Ethereum specifications.
+Testing framework for generating and running Lean Ethereum specification tests.
 
 This package provides tools for generating consensus test fixtures, including:
 - Pytest plugins for fixture generation
@@ -21,7 +21,7 @@ uv sync --all-extras
 Generate test fixtures using the `fill` command:
 
 ```bash
-uv run fill --fork=devnet --clean
+uv run fill --clean --fork=devnet
 ```
 
 See the main project documentation for more details.

packages/tests/pyproject.toml packages/testing/pyproject.tomlpackages/tests/pyproject.toml renamed to packages/testing/pyproject.toml

@@ -3,9 +3,9 @@ requires = ["setuptools>=77.0.3", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "lean-spec-tests"
+name = "lean-ethereum-testing"
 version = "0.0.1"
-description = "Lean Ethereum consensus test authoring framework"
+description = "Lean Ethereum client test generation and runner framework"
 readme = "README.md"
 authors = [
     { name = "Ethereum Foundation", email = "thomas.coratger@ethereum.org" },
@@ -38,7 +38,7 @@ Source = "https://github.com/leanEthereum/lean-spec"
 Issues = "https://github.com/leanEthereum/lean-spec/issues"
 
 [project.scripts]
-fill = "lean_spec_tests.cli.fill:fill"
+fill = "framework.cli.fill:fill"
 
 [tool.setuptools.packages.find]
 where = ["src"]

…es/tests/src/lean_spec_tests/__init__.py …esting/src/consensus_testing/__init__.pypackages/tests/src/lean_spec_tests/__init__.py renamed to packages/testing/src/consensus_testing/__init__.py packages/tests/src/lean_spec_tests/__init__.py renamed to packages/testing/src/consensus_testing/__init__.py

@@ -2,7 +2,8 @@
 
 from typing import Type
 
-from .base_types import CamelModel
+from framework.base_types import CamelModel
+
 from .builders import BlockBuilder
 from .test_fixtures import (
     BaseConsensusFixture,

…es/tests/src/lean_spec_tests/builders.py …esting/src/consensus_testing/builders.pypackages/tests/src/lean_spec_tests/builders.py renamed to packages/testing/src/consensus_testing/builders.py packages/tests/src/lean_spec_tests/builders.py renamed to packages/testing/src/consensus_testing/builders.py

@@ -2,7 +2,8 @@
 
 from typing import Type
 
-from .base import BaseFork, BaseForkMeta
+from framework.forks import BaseFork, BaseForkMeta
+
 from .forks import Devnet
 from .helpers import (
     ALL_FORKS,

…ts/src/lean_spec_tests/forks/__init__.py …/src/consensus_testing/forks/__init__.pypackages/tests/src/lean_spec_tests/forks/__init__.py renamed to packages/testing/src/consensus_testing/forks/__init__.py packages/tests/src/lean_spec_tests/forks/__init__.py renamed to packages/testing/src/consensus_testing/forks/__init__.py

@@ -1,6 +1,6 @@
 """Devnet fork definition."""
 
-from .base import BaseFork
+from framework.forks import BaseFork
 
 
 class Devnet(BaseFork):

…tests/src/lean_spec_tests/forks/forks.py …ing/src/consensus_testing/forks/forks.pypackages/tests/src/lean_spec_tests/forks/forks.py renamed to packages/testing/src/consensus_testing/forks/forks.py packages/tests/src/lean_spec_tests/forks/forks.py renamed to packages/testing/src/consensus_testing/forks/forks.py

@@ -0,0 +1,55 @@
+"""Consensus layer fork discovery and helpers."""
+
+from typing import FrozenSet, Set, Type
+
+from framework.forks import BaseFork
+from framework.forks.helpers import (
+    get_all_forks,
+    get_forks_with_no_parents,
+    get_from_until_fork_set,
+)
+from framework.forks.helpers import (
+    get_fork_by_name as _get_fork_by_name,
+)
+from framework.forks.helpers import (
+    get_forks as _get_forks,
+)
+
+from . import forks
+
+# Discover all consensus forks at module import time
+ALL_FORKS: FrozenSet[Type[BaseFork]] = get_all_forks(forks)
+"""All available consensus forks, excluding ignored forks."""
+
+
+def get_forks() -> Set[Type[BaseFork]]:
+    """
+    Return the set of all available consensus forks.
+
+    Returns:
+        Set of all non-ignored consensus fork classes.
+    """
+    return _get_forks(ALL_FORKS)
+
+
+def get_fork_by_name(fork_name: str) -> Type[BaseFork] | None:
+    """
+    Get a consensus fork class by its name.
+
+    Args:
+        fork_name: Name of the fork (case-insensitive).
+
+    Returns:
+        The fork class, or None if not found.
+    """
+    return _get_fork_by_name(ALL_FORKS, fork_name)
+
+
+# Re-export the generic helpers for convenience
+__all__ = [
+    "ALL_FORKS",
+    "get_forks",
+    "get_fork_by_name",
+    "get_forks_with_no_parents",
+    "get_from_until_fork_set",
+]