tigrcorn-contract 0.3.16.dev5__tar.gz → 0.3.16.dev12__tar.gz

{tigrcorn_contract-0.3.16.dev5 → tigrcorn_contract-0.3.16.dev12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrcorn-contract
-Version: 0.3.16.dev5
+Version: 0.3.16.dev12
 Summary: tigr-asgi-contract adapters and runtime-boundary classification for Tigrcorn ASGI3, WebSocket, and WebTransport surfaces.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License: Apache License
@@ -175,40 +175,52 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Requires-Python: >=3.11
+Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: tigrcorn-core==0.3.16.dev5
-Requires-Dist: tigrcorn-asgi==0.3.16.dev5
+Requires-Dist: tigrcorn-core==0.3.16.dev12
+Requires-Dist: tigrcorn-asgi==0.3.16.dev12
 Requires-Dist: tigr-asgi-contract>=0.3.2
 Dynamic: license-file
 
 <div align="center">
 <h1>tigrcorn-contract</h1>
+<img
+  src="https://raw.githubusercontent.com/Tigrbl/tigrcorn/master/assets/tigrcorn_logo.png"
+  alt="Tigrcorn tiger-unicorn logo"
+  width="140"
+/>
 
 <p><strong>tigr-asgi-contract adapters and runtime-boundary classification for Tigrcorn ASGI3, WebSocket, and WebTransport surfaces.</strong></p>
 
 <a href="https://pypi.org/project/tigrcorn-contract/"><img alt="PyPI version for tigrcorn-contract" src="https://img.shields.io/pypi/v/tigrcorn-contract?label=PyPI"></a>
 <a href="https://pypi.org/project/tigrcorn-contract/"><img alt="tigrcorn-contract package on PyPI" src="https://img.shields.io/badge/package-PyPI-blue"></a>
+<a href="https://pepy.tech/project/tigrcorn-contract"><img alt="Downloads for tigrcorn-contract" src="https://static.pepy.tech/badge/tigrcorn-contract"></a>
+<a href="https://github.com/tigrbl/tigrcorn/blob/master/pkgs/tigrcorn-contract/README.md"><img alt="Hits for tigrcorn-contract README" src="https://hits.sh/github.com/tigrbl/tigrcorn/blob/master/pkgs/tigrcorn-contract/README.md.svg?label=hits"></a>
 <a href="LICENSE"><img alt="Apache 2.0 license" src="https://img.shields.io/badge/license-Apache%202.0-525252"></a>
-<a href="pyproject.toml"><img alt="Python 3.11 supported" src="https://img.shields.io/badge/python-3.11-3776ab"></a>
-<a href="pyproject.toml"><img alt="Python 3.12 supported" src="https://img.shields.io/badge/python-3.12-3776ab"></a>
-<a href="pyproject.toml"><img alt="Python 3.13 supported" src="https://img.shields.io/badge/python-3.13-3776ab"></a>
-<a href="src/tigrcorn_contract/py.typed"><img alt="typed package" src="https://img.shields.io/badge/typed-py.typed-2f7ed8"></a>
+<a href="pyproject.toml"><img alt="Python 3.10 | 3.11 | 3.12 | 3.13 | 3.14 supported" 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"></a>
 <a href="https://pypi.org/project/tigrcorn-contract/"><img alt="contract role package" src="https://img.shields.io/badge/role-contract-0a7f5a"></a>
 </div>
 
+<p align="center"><a href="https://github.com/Tigrbl/tigrcorn/blob/master/.ssot/registry.json"><img alt="SSOT governed" src="https://img.shields.io/badge/SSOT-governed-2f6f4e.svg"></a> <a href="https://discord.gg/jzvrbEtTtt"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&amp;logoColor=white"></a></p>
+
 ## Install
 
-~~~bash
+```bash
+uv add tigrcorn-contract
+```
+
+```bash
 pip install tigrcorn-contract
-~~~
+```
 
 Use the aggregate [tigrcorn](https://pypi.org/project/tigrcorn/) distribution when you want the full ASGI3 Python web server stack. Install <code>tigrcorn-contract</code> directly when you want only this package boundary and its declared dependencies.
 
@@ -216,22 +228,67 @@ Use the aggregate [tigrcorn](https://pypi.org/project/tigrcorn/) distribution wh
 
 <code>tigrcorn-contract</code> owns native contract app markers, contract scope validation, contract event validation, and boundary classification. Its import package is <code>tigrcorn_contract</code>, and its declared package dependencies are: tigrcorn-core, tigrcorn-asgi, tigr-asgi-contract.
 
-This package page is written for developers searching for Tigrcorn ASGI3 server components, Python web server packages, HTTP/3 and QUIC support, WebSocket and WebTransport runtime surfaces, typed package boundaries, and Apache 2.0 licensed infrastructure.
+This package page is written for developers searching for Tigrcorn ASGI3 server components, Python web server packages, HTTP/3 and QUIC support, WebSocket and WebTransport-adjacent surfaces, and Apache 2.0 licensed infrastructure.
+
+## Why Use This?
+
+Use <code>tigrcorn-contract</code> when you want the contract layer as a direct install target instead of the full server bundle. It lets application, operator, or certification workflows depend on this boundary explicitly while keeping the broader Tigrcorn runtime assembled from smaller repo-owned package surfaces.
+
+## FAQ
+
+### What does this package export?
+
+The package exports through the <code>tigrcorn_contract</code> namespace and keeps the root <code>tigrcorn</code> package as the compatibility umbrella.
+
+### Which boundary does this package own?
+
+It is the package boundary for native contract app markers, contract scope validation, contract event validation, and boundary classification in the Tigrcorn package graph.
+
+### What does the contract layer validate?
+
+It validates contract scopes, event ordering, endpoint metadata, runtime classification, and WebSocket or WebTransport boundary semantics against the tigr-asgi-contract surface.
+
+## Features
+
+- Owns native contract app markers, contract scope validation, contract event validation, and boundary classification inside the Tigrcorn split-package architecture.
+- Publishes the <code>tigrcorn_contract</code> import surface for named public helpers and entrypoints.
+- Declared runtime dependencies: tigrcorn-core, tigrcorn-asgi, tigr-asgi-contract.
+- Optional dependency surface: none.
+- Supports Python 3.10, 3.11, 3.12, 3.13, and 3.14.
 
 ## Use It When
 
-Use <code>tigrcorn-contract</code> when you need the governed contract bridge between Tigrcorn runtime surfaces and tigr-asgi-contract semantics. It is part of Tigrcorn's split-package architecture, so it can be installed independently while remaining linked to the rest of the Tigrcorn package family on PyPI.
+Use <code>tigrcorn-contract</code> when you need contract-level behavior without pulling the entire server stack into the import surface. It is part of Tigrcorn's split-package architecture, so it can be installed independently while remaining linked to the rest of the Tigrcorn package family on PyPI.
 
 ## Import Surface
 
-~~~python
-import tigrcorn_contract
+```python
+from tigrcorn_contract import contract_scope, validate_scope
 
-print(tigrcorn_contract.__name__)
-~~~
+scope = contract_scope("http", path="/")
+print(validate_scope(scope))
+```
+
+Namespace discovery starts with `import tigrcorn_contract`.
 
 The package exposes its supported public surface through the <code>tigrcorn_contract</code> namespace. The root [tigrcorn](https://pypi.org/project/tigrcorn/) package keeps compatibility shims for users who install the full server distribution.
 
+## Related Packages
+
+- [tigrcorn-core](https://pypi.org/project/tigrcorn-core/)
+- [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/)
+- [tigrcorn](https://pypi.org/project/tigrcorn/)
+
 ## Package Graph
 
-[tigrcorn](https://pypi.org/project/tigrcorn/) | [tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+
+## Best Practices
+
+- Use this package when you need contract validation or classification rather than embedding that logic in protocol handlers.
+- Keep new WebSocket, WebTransport, and endpoint-metadata semantics grounded in the contract surface here.
+- Update runtime-boundary classification together with any new contract-facing feature rows.
+
+## License
+
+Apache-2.0

tigrcorn_contract-0.3.16.dev12/README.md

@@ -0,0 +1,101 @@
+<div align="center">
+<h1>tigrcorn-contract</h1>
+<img
+  src="https://raw.githubusercontent.com/Tigrbl/tigrcorn/master/assets/tigrcorn_logo.png"
+  alt="Tigrcorn tiger-unicorn logo"
+  width="140"
+/>
+
+<p><strong>tigr-asgi-contract adapters and runtime-boundary classification for Tigrcorn ASGI3, WebSocket, and WebTransport surfaces.</strong></p>
+
+<a href="https://pypi.org/project/tigrcorn-contract/"><img alt="PyPI version for tigrcorn-contract" src="https://img.shields.io/pypi/v/tigrcorn-contract?label=PyPI"></a>
+<a href="https://pypi.org/project/tigrcorn-contract/"><img alt="tigrcorn-contract package on PyPI" src="https://img.shields.io/badge/package-PyPI-blue"></a>
+<a href="https://pepy.tech/project/tigrcorn-contract"><img alt="Downloads for tigrcorn-contract" src="https://static.pepy.tech/badge/tigrcorn-contract"></a>
+<a href="https://github.com/tigrbl/tigrcorn/blob/master/pkgs/tigrcorn-contract/README.md"><img alt="Hits for tigrcorn-contract README" src="https://hits.sh/github.com/tigrbl/tigrcorn/blob/master/pkgs/tigrcorn-contract/README.md.svg?label=hits"></a>
+<a href="LICENSE"><img alt="Apache 2.0 license" src="https://img.shields.io/badge/license-Apache%202.0-525252"></a>
+<a href="pyproject.toml"><img alt="Python 3.10 | 3.11 | 3.12 | 3.13 | 3.14 supported" 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"></a>
+<a href="https://pypi.org/project/tigrcorn-contract/"><img alt="contract role package" src="https://img.shields.io/badge/role-contract-0a7f5a"></a>
+</div>
+
+<p align="center"><a href="https://github.com/Tigrbl/tigrcorn/blob/master/.ssot/registry.json"><img alt="SSOT governed" src="https://img.shields.io/badge/SSOT-governed-2f6f4e.svg"></a> <a href="https://discord.gg/jzvrbEtTtt"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&amp;logoColor=white"></a></p>
+
+## Install
+
+```bash
+uv add tigrcorn-contract
+```
+
+```bash
+pip install tigrcorn-contract
+```
+
+Use the aggregate [tigrcorn](https://pypi.org/project/tigrcorn/) distribution when you want the full ASGI3 Python web server stack. Install <code>tigrcorn-contract</code> directly when you want only this package boundary and its declared dependencies.
+
+## What It Owns
+
+<code>tigrcorn-contract</code> owns native contract app markers, contract scope validation, contract event validation, and boundary classification. Its import package is <code>tigrcorn_contract</code>, and its declared package dependencies are: tigrcorn-core, tigrcorn-asgi, tigr-asgi-contract.
+
+This package page is written for developers searching for Tigrcorn ASGI3 server components, Python web server packages, HTTP/3 and QUIC support, WebSocket and WebTransport-adjacent surfaces, and Apache 2.0 licensed infrastructure.
+
+## Why Use This?
+
+Use <code>tigrcorn-contract</code> when you want the contract layer as a direct install target instead of the full server bundle. It lets application, operator, or certification workflows depend on this boundary explicitly while keeping the broader Tigrcorn runtime assembled from smaller repo-owned package surfaces.
+
+## FAQ
+
+### What does this package export?
+
+The package exports through the <code>tigrcorn_contract</code> namespace and keeps the root <code>tigrcorn</code> package as the compatibility umbrella.
+
+### Which boundary does this package own?
+
+It is the package boundary for native contract app markers, contract scope validation, contract event validation, and boundary classification in the Tigrcorn package graph.
+
+### What does the contract layer validate?
+
+It validates contract scopes, event ordering, endpoint metadata, runtime classification, and WebSocket or WebTransport boundary semantics against the tigr-asgi-contract surface.
+
+## Features
+
+- Owns native contract app markers, contract scope validation, contract event validation, and boundary classification inside the Tigrcorn split-package architecture.
+- Publishes the <code>tigrcorn_contract</code> import surface for named public helpers and entrypoints.
+- Declared runtime dependencies: tigrcorn-core, tigrcorn-asgi, tigr-asgi-contract.
+- Optional dependency surface: none.
+- Supports Python 3.10, 3.11, 3.12, 3.13, and 3.14.
+
+## Use It When
+
+Use <code>tigrcorn-contract</code> when you need contract-level behavior without pulling the entire server stack into the import surface. It is part of Tigrcorn's split-package architecture, so it can be installed independently while remaining linked to the rest of the Tigrcorn package family on PyPI.
+
+## Import Surface
+
+```python
+from tigrcorn_contract import contract_scope, validate_scope
+
+scope = contract_scope("http", path="/")
+print(validate_scope(scope))
+```
+
+Namespace discovery starts with `import tigrcorn_contract`.
+
+The package exposes its supported public surface through the <code>tigrcorn_contract</code> namespace. The root [tigrcorn](https://pypi.org/project/tigrcorn/) package keeps compatibility shims for users who install the full server distribution.
+
+## Related Packages
+
+- [tigrcorn-core](https://pypi.org/project/tigrcorn-core/)
+- [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/)
+- [tigrcorn](https://pypi.org/project/tigrcorn/)
+
+## Package Graph
+
+[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+
+## Best Practices
+
+- Use this package when you need contract validation or classification rather than embedding that logic in protocol handlers.
+- Keep new WebSocket, WebTransport, and endpoint-metadata semantics grounded in the contract surface here.
+- Update runtime-boundary classification together with any new contract-facing feature rows.
+
+## License
+
+Apache-2.0

{tigrcorn_contract-0.3.16.dev5 → tigrcorn_contract-0.3.16.dev12}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tigrcorn-contract"
-version = "0.3.16.dev5"
+version = "0.3.16.dev12"
 description = "tigr-asgi-contract adapters and runtime-boundary classification for Tigrcorn ASGI3, WebSocket, and WebTransport surfaces."
 readme = "README.md"
-requires-python = ">=3.11"
+requires-python = ">=3.10,<3.15"
 license = {file = "LICENSE"}
 authors = [{name = "Jacob Stewart", email = "jacob@swarmauri.com"}]
 keywords = ["tigrcorn", "tigr-asgi-contract", "asgi-contract", "runtime-contract", "webtransport", "asgi3"]
@@ -19,16 +19,18 @@ classifiers = [
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Topic :: Internet :: WWW/HTTP",
   "Topic :: Software Development :: Libraries :: Python Modules",
   "Typing :: Typed",
 ]
 dependencies = [
-  "tigrcorn-core==0.3.16.dev5",
-  "tigrcorn-asgi==0.3.16.dev5",
+  "tigrcorn-core==0.3.16.dev12",
+  "tigrcorn-asgi==0.3.16.dev12",
   "tigr-asgi-contract>=0.3.2",
 ]
 

{tigrcorn_contract-0.3.16.dev5 → tigrcorn_contract-0.3.16.dev12}/src/tigrcorn_contract/__init__.py

@@ -3,8 +3,13 @@ from __future__ import annotations
 from .classification import (
     BindingClassification,
     FamilyCapability,
+    ProductSurfaceStatus,
     classify_binding,
     family_capability,
+    product_surface_excluded,
+    product_surface_status,
+    require_product_boundary_exclusion,
+    require_product_runtime_available,
     runtime_interface_available,
     validate_binding_legality,
 )
@@ -26,6 +31,8 @@ from .compat import (
 from .events import (
     CompletionLevel,
     CompletionStatus,
+    GenericDatagramRuntime,
+    GenericStreamRuntime,
     datagram_receive,
     datagram_send,
     emit_complete,
@@ -43,7 +50,9 @@ from .events import (
     map_contract_event,
     stream_receive,
     stream_send,
+    validate_datagram_event,
     validate_event_order,
+    validate_stream_event,
     websocket_accept,
     websocket_close,
     websocket_connect,
@@ -73,7 +82,19 @@ from .metadata import (
     stream_identity,
     transport_identity,
     unit_identity,
+    validate_connection_identity,
     validate_endpoint_metadata,
+    validate_security_metadata,
+    validate_stream_identity,
+)
+from .projection import (
+    EventProjection,
+    ScopeProjection,
+    project_event_classification,
+    project_receive_event,
+    project_scope_classification,
+    project_send_event,
+    validate_projected_event,
 )
 from .scopes import SUPPORTED_SCOPE_TYPES, contract_scope, validate_scope
 
@@ -84,10 +105,15 @@ __all__ = [
     "ConnectionIdentity",
     "EndpointMetadata",
     "FamilyCapability",
+    "GenericDatagramRuntime",
+    "GenericStreamRuntime",
+    "ProductSurfaceStatus",
     "CompatibilityParityRow",
     "HTTPFeatureContractMap",
     "SUPPORTED_SCOPE_TYPES",
     "SecurityMetadata",
+    "EventProjection",
+    "ScopeProjection",
     "StreamIdentity",
     "UnitIdentity",
     "alt_svc_contract_map",
@@ -120,7 +146,15 @@ __all__ = [
     "map_contract_event",
     "observability_contract_metadata",
     "proxy_normalization_contract_map",
+    "product_surface_status",
+    "product_surface_excluded",
+    "project_event_classification",
+    "project_receive_event",
+    "project_scope_classification",
+    "project_send_event",
     "require_lossless_metadata",
+    "require_product_boundary_exclusion",
+    "require_product_runtime_available",
     "runtime_interface_available",
     "security_metadata",
     "static_delivery_contract_map",
@@ -131,9 +165,15 @@ __all__ = [
     "trailers_contract_map",
     "unit_identity",
     "validate_binding_legality",
+    "validate_connection_identity",
+    "validate_datagram_event",
     "validate_endpoint_metadata",
     "validate_event_order",
+    "validate_projected_event",
+    "validate_security_metadata",
     "validate_scope",
+    "validate_stream_event",
+    "validate_stream_identity",
     "websocket_accept",
     "websocket_close",
     "websocket_connect",

tigrcorn_contract-0.3.16.dev12/src/tigrcorn_contract/classification.py

@@ -0,0 +1,209 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Literal
+
+from tigrcorn_core.errors import ConfigError
+
+BindingKind = Literal["http", "http.stream", "websocket", "lifespan", "webtransport", "stream", "datagram", "rest", "jsonrpc", "sse"]
+ProductSurfaceKind = Literal[
+    "auto",
+    "tigr-asgi-contract",
+    "asgi3",
+    "asgi2",
+    "wsgi",
+    "rsgi",
+    "rest",
+    "jsonrpc",
+]
+
+_SERVER_OWNED_RUNTIMES = {"http", "http.stream", "websocket", "lifespan", "webtransport", "stream", "datagram"}
+_CLASSIFICATION_ONLY = {"rest", "jsonrpc", "sse"}
+_SUPPORTED_APP_INTERFACES = {"auto", "tigr-asgi-contract", "asgi3"}
+_UNSUPPORTED_COMPAT_INTERFACES = {"asgi2", "wsgi", "rsgi"}
+_RUNTIME_EXCLUDED_CLASSIFICATIONS = {"rest", "jsonrpc"}
+
+
+@dataclass(frozen=True, slots=True)
+class BindingClassification:
+    kind: BindingKind
+    runtime_owned: bool
+    classification_only: bool
+    dispatch_runtime: str
+    scope_type: str
+    family: str
+    exchange: str
+    framing: str | None = None
+    allowed_framings: tuple[str, ...] = ()
+
+
+@dataclass(frozen=True, slots=True)
+class FamilyCapability:
+    family: str
+    bindings: tuple[str, ...]
+    subevents: tuple[str, ...]
+    exchanges: tuple[str, ...]
+
+
+@dataclass(frozen=True, slots=True)
+class ProductSurfaceStatus:
+    kind: ProductSurfaceKind
+    runtime_available: bool
+    classification_only: bool
+    compatibility_exclusion: bool
+    reason: str
+
+
+_FAMILY_CAPABILITIES = {
+    "request": FamilyCapability(
+        family="request",
+        bindings=("http", "http.stream", "rest", "jsonrpc"),
+        subevents=("request.open", "request.body_in", "request.chunk_in", "request.close", "request.disconnect"),
+        exchanges=("unary", "server_stream"),
+    ),
+    "session": FamilyCapability(
+        family="session",
+        bindings=("websocket", "webtransport", "lifespan"),
+        subevents=("session.open", "session.accept", "session.ready", "session.heartbeat", "session.close", "session.disconnect"),
+        exchanges=("duplex",),
+    ),
+    "message": FamilyCapability(
+        family="message",
+        bindings=("websocket",),
+        subevents=("message.in", "message.decode", "message.handle", "message.out", "message.ack", "message.nack"),
+        exchanges=("duplex",),
+    ),
+    "stream": FamilyCapability(
+        family="stream",
+        bindings=("http.stream", "webtransport", "stream", "sse"),
+        subevents=("stream.open", "stream.chunk_in", "stream.chunk_out", "stream.flush", "stream.finalize", "stream.abort", "stream.close"),
+        exchanges=("server_stream", "duplex"),
+    ),
+    "datagram": FamilyCapability(
+        family="datagram",
+        bindings=("webtransport", "datagram"),
+        subevents=("datagram.in", "datagram.handle", "datagram.out", "datagram.ack", "datagram.close"),
+        exchanges=("duplex",),
+    ),
+}
+
+_BINDING_SHAPES: dict[str, tuple[str, str, str, str | None, tuple[str, ...]]] = {
+    "http": ("http", "request", "unary", None, ()),
+    "http.stream": ("http", "stream", "server_stream", None, ()),
+    "websocket": ("websocket", "message", "duplex", None, ()),
+    "lifespan": ("lifespan", "session", "duplex", None, ()),
+    "webtransport": ("webtransport", "session", "duplex", None, ()),
+    "stream": ("tigrcorn.stream", "stream", "duplex", None, ()),
+    "datagram": ("tigrcorn.datagram", "datagram", "duplex", None, ()),
+    "rest": ("http", "request", "unary", "json", ("json",)),
+    "jsonrpc": ("http", "request", "unary", "jsonrpc", ("jsonrpc",)),
+    "sse": ("http", "stream", "server_stream", "sse", ("sse",)),
+}
+
+
+def classify_binding(kind: str) -> BindingClassification:
+    normalized = kind.strip().lower().replace("_", "-")
+    if normalized == "json-rpc":
+        normalized = "jsonrpc"
+    if normalized not in _SERVER_OWNED_RUNTIMES | _CLASSIFICATION_ONLY:
+        raise ConfigError(f"unsupported binding classification: {kind!r}")
+    scope_type, family, exchange, framing, allowed_framings = _BINDING_SHAPES[normalized]
+    return BindingClassification(
+        kind=normalized,  # type: ignore[arg-type]
+        runtime_owned=normalized in _SERVER_OWNED_RUNTIMES,
+        classification_only=normalized in _CLASSIFICATION_ONLY,
+        dispatch_runtime="application" if normalized in _CLASSIFICATION_ONLY else "tigrcorn",
+        scope_type=scope_type,
+        family=family,
+        exchange=exchange,
+        framing=framing,
+        allowed_framings=allowed_framings,
+    )
+
+
+def runtime_interface_available(interface: str) -> bool:
+    return product_surface_status(interface).runtime_available
+
+
+def _normalize_product_surface(value: str) -> ProductSurfaceKind:
+    try:
+        normalized = value.strip().lower().replace("_", "-")
+    except AttributeError as exc:
+        raise ConfigError(f"unsupported product surface: {value!r}") from exc
+    if normalized == "json-rpc":
+        normalized = "jsonrpc"
+    if normalized not in _SUPPORTED_APP_INTERFACES | _UNSUPPORTED_COMPAT_INTERFACES | _RUNTIME_EXCLUDED_CLASSIFICATIONS:
+        raise ConfigError(f"unsupported product surface: {value!r}")
+    return normalized  # type: ignore[return-value]
+
+
+def product_surface_status(surface: str) -> ProductSurfaceStatus:
+    normalized = _normalize_product_surface(surface)
+    if normalized in _SUPPORTED_APP_INTERFACES:
+        return ProductSurfaceStatus(
+            kind=normalized,
+            runtime_available=True,
+            classification_only=False,
+            compatibility_exclusion=False,
+            reason="supported app interface",
+        )
+    if normalized in _RUNTIME_EXCLUDED_CLASSIFICATIONS:
+        return ProductSurfaceStatus(
+            kind=normalized,
+            runtime_available=False,
+            classification_only=True,
+            compatibility_exclusion=False,
+            reason="classification-only binding; runtime belongs to the application layer",
+        )
+    return ProductSurfaceStatus(
+        kind=normalized,
+        runtime_available=False,
+        classification_only=False,
+        compatibility_exclusion=True,
+        reason="unsupported compatibility interface",
+    )
+
+
+def require_product_runtime_available(surface: str) -> ProductSurfaceStatus:
+    status = product_surface_status(surface)
+    if not status.runtime_available:
+        raise ConfigError(f"unsupported runtime product surface: {surface!r} ({status.reason})")
+    return status
+
+
+def product_surface_excluded(surface: str) -> bool:
+    return not product_surface_status(surface).runtime_available
+
+
+def require_product_boundary_exclusion(surface: str) -> ProductSurfaceStatus:
+    status = product_surface_status(surface)
+    if status.runtime_available:
+        raise ConfigError(f"product surface is supported, not excluded: {surface!r}")
+    return status
+
+
+def family_capability(family: str) -> FamilyCapability:
+    normalized = family.strip().lower()
+    try:
+        return _FAMILY_CAPABILITIES[normalized]
+    except KeyError as exc:
+        raise ConfigError(f"unsupported contract family: {family!r}") from exc
+
+
+def validate_binding_legality(*, binding: str, family: str, subevent: str | None = None, exchange: str | None = None) -> None:
+    normalized_binding = binding.strip().lower().replace("_", "-")
+    if normalized_binding == "json-rpc":
+        normalized_binding = "jsonrpc"
+    classification = classify_binding(normalized_binding)
+    normalized_family = family.strip().lower()
+    if classification.classification_only and normalized_family != classification.family:
+        raise ConfigError(f"binding {binding!r} is illegal for family {family!r}")
+    capability = family_capability(family)
+    if normalized_binding not in capability.bindings:
+        raise ConfigError(f"binding {binding!r} is illegal for family {family!r}")
+    if subevent is not None and subevent not in capability.subevents and not subevent.endswith(".emit_complete"):
+        raise ConfigError(f"subevent {subevent!r} is illegal for family {family!r}")
+    if classification.classification_only and exchange is not None and exchange != classification.exchange:
+        raise ConfigError(f"exchange {exchange!r} is illegal for binding {binding!r}")
+    if exchange is not None and exchange not in capability.exchanges:
+        raise ConfigError(f"exchange {exchange!r} is illegal for family {family!r}")