tigrbl_spec 0.4.2.dev3__tar.gz → 0.4.3__tar.gz

tigrbl_spec-0.4.3/NOTICE

@@ -0,0 +1,7 @@
+Tigrbl
+Copyright 2026 Swarmauri
+
+This product includes software developed by Swarmauri.
+
+Tigrbl is licensed under the Apache License, Version 2.0.
+See the LICENSE file distributed with this work for the full license text.

{tigrbl_spec-0.4.2.dev3 → tigrbl_spec-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl_spec
-Version: 0.4.2.dev3
+Version: 0.4.3
 Summary: Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration.
 License: Apache License
                                     Version 2.0, January 2004
@@ -204,6 +204,7 @@ License: Apache License
             See the License for the specific language governing permissions and
             limitations under the License.
 License-File: LICENSE
+License-File: NOTICE
 Keywords: tigrbl,asgi,api,json-rpc,rest,sqlalchemy,pydantic,spec,specification,protocols,compatibility,openapi,openrpc,schema-first
 Author: Jacob Stewart
 Author-email: jacob@swarmauri.com
@@ -224,6 +225,8 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: jsonschema (>=4.0)
+Requires-Dist: typing-extensions (>=4.0)
 Project-URL: Discord, https://discord.gg/K4YTAPapjR
 Project-URL: Homepage, https://github.com/tigrbl/tigrbl
 Project-URL: Issues, https://github.com/tigrbl/tigrbl/issues
@@ -237,12 +240,45 @@ Description-Content-Type: text/markdown
 <p><strong>Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration.</strong></p>
 <a href="https://pypi.org/project/tigrbl_spec/"><img src="https://img.shields.io/pypi/v/tigrbl_spec?label=PyPI" alt="PyPI version for tigrbl_spec"/></a>
 <a href="https://pypi.org/project/tigrbl_spec/"><img src="https://static.pepy.tech/badge/tigrbl_spec" alt="Downloads for tigrbl_spec"/></a>
+<a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl_spec"/></a>
 <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_spec/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_spec/README.md.svg?label=hits" alt="Repository hits for tigrbl_spec README"/></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
-<a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl_spec"/></a>
+<a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl_spec"/></a>
 <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl_spec"/></a>
 </div>
 
+## What is tigrbl_spec?
+
+Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration.
+
+## Why use tigrbl_spec?
+
+Use it when you need this foundational Tigrbl layer directly as a small, focused dependency.
+
+## When should I install tigrbl_spec?
+
+Install it for extension packages, package-local tests, or internals that need this boundary without the whole facade.
+
+## Who is tigrbl_spec for?
+
+Framework maintainers, extension authors, and advanced users composing Tigrbl from split packages.
+
+## Where does tigrbl_spec fit?
+
+`tigrbl_spec` lives at `pkgs/core/tigrbl_spec` and serves a focused layer in the split Tigrbl framework.
+
+## How does tigrbl_spec work?
+
+It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.
+
+## Certification Status
+
+- Package status: governed package in the `tigrbl/tigrbl` workspace.
+- Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
+- Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
+- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
+- Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
+
 ## Install
 
 ```bash
@@ -253,50 +289,104 @@ uv add tigrbl_spec
 pip install tigrbl_spec
 ```
 
+## Surface Coverage
+
+| Surface | Value |
+|---|---|
+| PyPI package | [`tigrbl_spec`](https://pypi.org/project/tigrbl_spec/) |
+| Repository path | [`pkgs/core/tigrbl_spec`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_spec) |
+| Python import root | `tigrbl_spec` |
+| Console scripts | none declared |
+| Entry points | none declared |
+| Optional extras | none declared |
+| Legal files | `LICENSE`, `NOTICE` |
+| Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
+
 ## What It Owns
 
-`tigrbl_spec` owns the spec boundary inside the split Python workspace.
+`tigrbl_spec` owns the `foundational framework package` boundary. It should be installed when you need this package's focused responsibility without assuming every other Tigrbl workspace package is present.
+
+Implementation orientation:
+- Module layout is intentionally small or namespace-oriented.
 
-## Use It When
+## Public API and Import Surface
 
-Use `tigrbl_spec` when you want this subsystem directly as a package boundary instead of consuming it only through the top-level `tigrbl` facade.
+- Import roots: `tigrbl_spec`.
+- Public symbols: `__version__`.
+- Workspace dependencies: none declared.
+- External runtime dependencies: none declared.
 
-## Public Surface
+## Usage Examples
 
-- `tigrbl_spec` exposes `__version__`.
+### Verify the installed package
 
-## Internal Layout
+```bash
+python -m pip show tigrbl_spec
+python - <<'PY'
+from importlib.metadata import version
+print(version("tigrbl_spec"))
+PY
+```
 
-- Workspace path: `pkgs/core/tigrbl_spec`.
-- Package class: `core framework package`.
-- Python requirement: `>=3.10,<3.15`.
+### Import the package boundary
 
-## Dependency Surface
+```python
+import importlib
 
-- Workspace package dependencies: none declared.
-- External runtime dependencies: none declared.
-- Optional extras: none declared.
+module = importlib.import_module("tigrbl_spec")
+print(module.__name__)
+```
+
+### Import a public symbol
+
+```python
+from tigrbl_spec import __version__
+
+print(__version__)
+```
+
+### Use with the facade when building applications
+
+```bash
+uv add tigrbl tigrbl_spec
+python - <<'PY'
+import tigrbl
+print(tigrbl.__name__)
+PY
+```
+
+## How To Choose This Package
+
+Choose `tigrbl_spec` when the quick-answer table matches your use case. Choose [`tigrbl`](https://pypi.org/project/tigrbl/) instead when you want the full public facade. Choose a lower-level package such as [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), or [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) when you are building framework extensions or testing a specific internal boundary.
 
 ## Related Packages
 
 - [`tigrbl`](https://pypi.org/project/tigrbl/)
+- [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
+- [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
+- [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
+
+## Documentation Links
+
+- [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
+- [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
+- [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
+- [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
+- [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
+- [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
+- [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
 
-## Canonical Repository Docs
+## Support
 
-- `docs/README.md`
-- `docs/conformance/CURRENT_TARGET.md`
-- `docs/conformance/CURRENT_STATE.md`
-- `docs/conformance/NEXT_STEPS.md`
-- `docs/governance/DOC_POINTERS.md`
-- `docs/developer/PACKAGE_CATALOG.md`
-- `docs/developer/PACKAGE_LAYOUT.md`
+- Community: [Discord](https://discord.gg/K4YTAPapjR).
+- Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
+- Repository: [pkgs/core/tigrbl_spec](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_spec).
 
 ## Package-local Boundary
 
-This file is a package-local distribution entry point.
-Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
+This README is the package-local distribution entry point for `tigrbl_spec`. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.
 
 ## License
 
-Licensed under the Apache License, Version 2.0. See `LICENSE` and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
+Licensed under the Apache License, Version 2.0. See `LICENSE`, `NOTICE`, and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
 

tigrbl_spec-0.4.3/README.md

@@ -0,0 +1,155 @@
+<div align="center">
+<h1>tigrbl_spec</h1>
+<img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
+<p><strong>Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration.</strong></p>
+<a href="https://pypi.org/project/tigrbl_spec/"><img src="https://img.shields.io/pypi/v/tigrbl_spec?label=PyPI" alt="PyPI version for tigrbl_spec"/></a>
+<a href="https://pypi.org/project/tigrbl_spec/"><img src="https://static.pepy.tech/badge/tigrbl_spec" alt="Downloads for tigrbl_spec"/></a>
+<a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl_spec"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_spec/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_spec/README.md.svg?label=hits" alt="Repository hits for tigrbl_spec README"/></a>
+<a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
+<a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl_spec"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl_spec"/></a>
+</div>
+
+## What is tigrbl_spec?
+
+Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration.
+
+## Why use tigrbl_spec?
+
+Use it when you need this foundational Tigrbl layer directly as a small, focused dependency.
+
+## When should I install tigrbl_spec?
+
+Install it for extension packages, package-local tests, or internals that need this boundary without the whole facade.
+
+## Who is tigrbl_spec for?
+
+Framework maintainers, extension authors, and advanced users composing Tigrbl from split packages.
+
+## Where does tigrbl_spec fit?
+
+`tigrbl_spec` lives at `pkgs/core/tigrbl_spec` and serves a focused layer in the split Tigrbl framework.
+
+## How does tigrbl_spec work?
+
+It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.
+
+## Certification Status
+
+- Package status: governed package in the `tigrbl/tigrbl` workspace.
+- Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
+- Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
+- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
+- Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
+
+## Install
+
+```bash
+uv add tigrbl_spec
+```
+
+```bash
+pip install tigrbl_spec
+```
+
+## Surface Coverage
+
+| Surface | Value |
+|---|---|
+| PyPI package | [`tigrbl_spec`](https://pypi.org/project/tigrbl_spec/) |
+| Repository path | [`pkgs/core/tigrbl_spec`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_spec) |
+| Python import root | `tigrbl_spec` |
+| Console scripts | none declared |
+| Entry points | none declared |
+| Optional extras | none declared |
+| Legal files | `LICENSE`, `NOTICE` |
+| Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
+
+## What It Owns
+
+`tigrbl_spec` owns the `foundational framework package` boundary. It should be installed when you need this package's focused responsibility without assuming every other Tigrbl workspace package is present.
+
+Implementation orientation:
+- Module layout is intentionally small or namespace-oriented.
+
+## Public API and Import Surface
+
+- Import roots: `tigrbl_spec`.
+- Public symbols: `__version__`.
+- Workspace dependencies: none declared.
+- External runtime dependencies: none declared.
+
+## Usage Examples
+
+### Verify the installed package
+
+```bash
+python -m pip show tigrbl_spec
+python - <<'PY'
+from importlib.metadata import version
+print(version("tigrbl_spec"))
+PY
+```
+
+### Import the package boundary
+
+```python
+import importlib
+
+module = importlib.import_module("tigrbl_spec")
+print(module.__name__)
+```
+
+### Import a public symbol
+
+```python
+from tigrbl_spec import __version__
+
+print(__version__)
+```
+
+### Use with the facade when building applications
+
+```bash
+uv add tigrbl tigrbl_spec
+python - <<'PY'
+import tigrbl
+print(tigrbl.__name__)
+PY
+```
+
+## How To Choose This Package
+
+Choose `tigrbl_spec` when the quick-answer table matches your use case. Choose [`tigrbl`](https://pypi.org/project/tigrbl/) instead when you want the full public facade. Choose a lower-level package such as [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), or [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) when you are building framework extensions or testing a specific internal boundary.
+
+## Related Packages
+
+- [`tigrbl`](https://pypi.org/project/tigrbl/)
+- [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
+- [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
+- [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
+
+## Documentation Links
+
+- [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
+- [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
+- [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
+- [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
+- [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
+- [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
+- [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
+
+## Support
+
+- Community: [Discord](https://discord.gg/K4YTAPapjR).
+- Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
+- Repository: [pkgs/core/tigrbl_spec](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_spec).
+
+## Package-local Boundary
+
+This README is the package-local distribution entry point for `tigrbl_spec`. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.
+
+## License
+
+Licensed under the Apache License, Version 2.0. See `LICENSE`, `NOTICE`, and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).

{tigrbl_spec-0.4.2.dev3 → tigrbl_spec-0.4.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl_spec"
-version = "0.4.2.dev3"
+version = "0.4.3"
 description = "Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -41,7 +41,10 @@ classifiers = [
 requires-python = ">=3.10,<3.15"
 authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
 
-dependencies = []
+dependencies = [
+    "jsonschema>=4.0",
+    "typing-extensions>=4.0",
+]
 
 
 [project.urls]
@@ -55,6 +58,16 @@ Issues = "https://github.com/tigrbl/tigrbl/issues"
 requires = ["poetry-core>=1.0.0"]
 build-backend = "poetry.core.masonry.api"
 
+[tool.poetry]
+packages = [
+    { include = "tigrbl_spec" },
+]
+include = [
+    "tigrbl_spec/schemas/**/*.json",
+    "tigrbl_spec/migrations/**/*.py",
+    "tigrbl_spec/models/**/*.py",
+]
+
 [dependency-groups]
 dev = [
     "pytest>=8.0",

tigrbl_spec-0.4.3/tigrbl_spec/__init__.py

@@ -0,0 +1,44 @@
+"""Tigrbl specification schema catalog and bindings."""
+
+from .schema import (
+    CURRENT_SCHEMA_VERSION,
+    SCHEMA_VERSION,
+    SpecSchemaError,
+    SpecValidationError,
+    UnknownSpecKindError,
+    UnsupportedSchemaVersionError,
+    identity_fields,
+    load_bundle,
+    load_manifest,
+    load_payload,
+    load_schema,
+    schema_path,
+    schema_versions,
+    spec_kinds,
+    spec_type,
+    validate_payload,
+    with_identity,
+)
+
+__all__ = [
+    "__version__",
+    "CURRENT_SCHEMA_VERSION",
+    "SCHEMA_VERSION",
+    "SpecSchemaError",
+    "SpecValidationError",
+    "UnknownSpecKindError",
+    "UnsupportedSchemaVersionError",
+    "identity_fields",
+    "load_bundle",
+    "load_manifest",
+    "load_payload",
+    "load_schema",
+    "schema_path",
+    "schema_versions",
+    "spec_kinds",
+    "spec_type",
+    "validate_payload",
+    "with_identity",
+]
+
+__version__ = "0.4.0.dev1"

tigrbl_spec-0.4.3/tigrbl_spec/codegen.py

@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+from importlib import import_module
+
+from tigrbl_spec.schema import CURRENT_SCHEMA_VERSION, spec_kinds
+
+
+class CodegenFreshnessError(AssertionError):
+    """Raised when checked-in generated models do not match packaged schemas."""
+
+
+def generated_module_name(version: str = CURRENT_SCHEMA_VERSION) -> str:
+    normalized = version.replace(".", "_")
+    return f"tigrbl_spec.models.v{normalized}"
+
+
+def check_generated_model_freshness(version: str = CURRENT_SCHEMA_VERSION) -> None:
+    module = import_module(generated_module_name(version))
+    expected = set(spec_kinds(version))
+    actual = {name for name in getattr(module, "__all__", ()) if name != "SpecDataclass"}
+    missing = sorted(expected - actual)
+    extra = sorted(actual - expected)
+    if missing or extra:
+        raise CodegenFreshnessError(
+            f"Generated tigrbl_spec dataclasses are stale for {version}: "
+            f"missing={missing}, extra={extra}"
+        )

tigrbl_spec-0.4.3/tigrbl_spec/migrations/__init__.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+import copy
+from typing import Any
+
+from tigrbl_spec.schema import CURRENT_SCHEMA_VERSION, UnsupportedSchemaVersionError, schema_versions
+
+SUPPORTED_SCHEMA_VERSIONS = schema_versions()
+
+
+class SchemaMigrationError(ValueError):
+    """Raised when no valid schema catalog migration path exists."""
+
+
+def migration_path(
+    from_version: str,
+    to_version: str = CURRENT_SCHEMA_VERSION,
+) -> tuple[str, ...]:
+    if from_version not in SUPPORTED_SCHEMA_VERSIONS:
+        raise UnsupportedSchemaVersionError(f"Unsupported source schema version {from_version!r}")
+    if to_version not in SUPPORTED_SCHEMA_VERSIONS:
+        raise UnsupportedSchemaVersionError(f"Unsupported target schema version {to_version!r}")
+    if from_version == to_version:
+        return (from_version,)
+    versions = list(SUPPORTED_SCHEMA_VERSIONS)
+    start = versions.index(from_version)
+    end = versions.index(to_version)
+    if end < start:
+        raise SchemaMigrationError(
+            f"Downgrade migrations are not supported: {from_version!r} -> {to_version!r}"
+        )
+    path = tuple(versions[start : end + 1])
+    if len(path) < 2:
+        raise SchemaMigrationError(f"No migration path from {from_version!r} to {to_version!r}")
+    return path
+
+
+def migrate_payload(
+    spec_kind: str,
+    payload: dict[str, Any],
+    from_version: str,
+    to_version: str = CURRENT_SCHEMA_VERSION,
+) -> dict[str, Any]:
+    path = migration_path(from_version, to_version)
+    migrated = copy.deepcopy(payload)
+    if len(path) == 1:
+        return migrated
+    raise SchemaMigrationError(
+        f"No adjacent migration implementation registered for {spec_kind!r}: "
+        f"{from_version!r} -> {to_version!r}"
+    )

tigrbl_spec-0.4.3/tigrbl_spec/models/__init__.py

@@ -0,0 +1,3 @@
+from __future__ import annotations
+
+from tigrbl_spec.models.v0_3_20 import *  # noqa: F403

tigrbl_spec-0.4.3/tigrbl_spec/models/v0_3_20/__init__.py

@@ -0,0 +1,45 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any, ClassVar
+from typing_extensions import Self
+
+from tigrbl_spec.schema import CURRENT_SCHEMA_VERSION, identity_fields, spec_kinds, validate_payload
+
+
+@dataclass(slots=True)
+class SpecDataclass:
+    spec_kind: str
+    spec_schema_version: str
+    spec_type: str
+    data: dict[str, Any] = field(default_factory=dict)
+
+    KIND: ClassVar[str]
+
+    @classmethod
+    def from_dict(cls, payload: dict[str, Any]) -> Self:
+        validated = validate_payload(cls.KIND, payload, CURRENT_SCHEMA_VERSION)
+        identity = identity_fields(cls.KIND, CURRENT_SCHEMA_VERSION)
+        data = {key: value for key, value in validated.items() if key not in identity}
+        return cls(data=data, **identity)
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "spec_kind": self.spec_kind,
+            "spec_schema_version": self.spec_schema_version,
+            "spec_type": self.spec_type,
+            **self.data,
+        }
+
+
+def _model_class(kind: str) -> type[SpecDataclass]:
+    return dataclass(slots=True)(
+        type(kind, (SpecDataclass,), {"KIND": kind, "__annotations__": {"KIND": ClassVar[str]}})
+    )
+
+
+for _kind in spec_kinds(CURRENT_SCHEMA_VERSION):
+    globals()[_kind] = _model_class(_kind)
+
+
+__all__ = ["SpecDataclass", *spec_kinds(CURRENT_SCHEMA_VERSION)]