[FEATURE] Extensible tag classification model discovery through Entry Points

README.pydantic.md

@@ -151,31 +151,61 @@ Registration is done in the `[project.entry-points."overture.models"]` section:
 
 ```toml
 [project.entry-points."overture.models"]
-"buildings.building" = "overture.schema.buildings.building.models:Building"
-"buildings.building_part" = "overture.schema.buildings.building_part.models:BuildingPart"
+building = "overture.schema.buildings:Building"
+building_part = "overture.schema.buildings:BuildingPart"
 ```
 
 The discovery system provides programmatic access to registered models:
 
 ```python
-from overture.schema.core.discovery import discover_models, get_registered_model
+from overture.schema.system.discovery import discover_models, get_registered_model
 
-# Discover all registered models
+# Discover all registered models, keyed by ModelKey
 all_models = discover_models()
-# Returns:
-# {
-#   ("buildings", "building"): BuildingModel,
-#   ("places", "place"): PlaceModel,
-# ...
-# }
 
-# Get a specific model by theme and type
-building_model = get_registered_model("buildings", "building")
+# Get a specific model by name
+building_model = get_registered_model("building")
 if building_model:
-    # Use the model class
     building = building_model.model_validate(building_data)
 ```
 
+### Tagging
+
+Each `ModelKey` returned by `discover_models()` carries a `frozenset[str]` of tags
+that classify the model orthogonally to its entry-point name -- whether the model
+is a `Feature` subclass, which Overture theme it belongs to, which package shipped
+it, and so on. Downstream tools (the CLI, codegen, third-party consumers) use tags
+to filter the working set without importing every model:
+
+```python
+from overture.schema.system.discovery import (
+    TagSelector,
+    discover_models,
+    filter_models,
+)
+
+models = discover_models()
+# {
+#   ModelKey(name="building", entry_point="overture.schema.buildings:Building",
+#            tags=frozenset({"feature", "overture", "overture:theme=buildings"})): BuildingModel,
+#   ModelKey(name="place",    entry_point="overture.schema.places:Place",
+#            tags=frozenset({"feature", "overture", "overture:theme=places"})):    PlaceModel,
+#   ...
+# }
+
+buildings = filter_models(
+    models,
+    TagSelector(include_any=("overture:theme=buildings",)),
+)
+```
+
+Tags are produced by *tag providers* registered on the `overture.tag_providers`
+entry-point group. The `system` and `core` packages ship the built-in providers
+(`feature`, `overture`, `overture:theme=*`); third parties can register their own
+to attach custom tags during discovery. See the [`overture-schema-system`
+README](packages/overture-schema-system/README.md#tagging) for tag format,
+reserved namespaces, and provider authoring.
+
 ## Development
 
 This project uses [uv](https://docs.astral.sh/uv/) for dependency management:

packages/overture-schema-addresses-theme/pyproject.toml

@@ -39,7 +39,7 @@ pythonpath = ["src"]
 testpaths = ["tests"]
 
 [project.entry-points."overture.models"]
-"overture:addresses:address" = "overture.schema.addresses:Address"
+address = "overture.schema.addresses:Address"
 
 [project.entry-points.pytest11]
 overture_baselines = "overture.schema.system.testing.plugin"

packages/overture-schema-annex/pyproject.toml

@@ -30,7 +30,7 @@ path = "src/overture/schema/__about__.py"
 packages = ["src/overture"]
 
 [project.entry-points."overture.models"]
-"annex:sources" = "overture.schema.annex:Sources"
+sources = "overture.schema.annex:Sources"
 
 [project.entry-points.pytest11]
 overture_baselines = "overture.schema.system.testing.plugin"

packages/overture-schema-base-theme/pyproject.toml

@@ -35,12 +35,12 @@ path = "src/overture/schema/base/__about__.py"
 packages = ["src/overture"]
 
 [project.entry-points."overture.models"]
-"overture:base:bathymetry" = "overture.schema.base:Bathymetry"
-"overture:base:infrastructure" = "overture.schema.base:Infrastructure"
-"overture:base:land" = "overture.schema.base:Land"
-"overture:base:land_cover" = "overture.schema.base:LandCover"
-"overture:base:land_use" = "overture.schema.base:LandUse"
-"overture:base:water" = "overture.schema.base:Water"
+bathymetry = "overture.schema.base:Bathymetry"
+infrastructure = "overture.schema.base:Infrastructure"
+land = "overture.schema.base:Land"
+land_cover = "overture.schema.base:LandCover"
+land_use = "overture.schema.base:LandUse"
+water = "overture.schema.base:Water"
 
 [project.entry-points.pytest11]
 overture_baselines = "overture.schema.system.testing.plugin"

packages/overture-schema-buildings-theme/pyproject.toml

@@ -35,8 +35,8 @@ path = "src/overture/schema/buildings/__about__.py"
 packages = ["src/overture"]
 
 [project.entry-points."overture.models"]
-"overture:buildings:building" = "overture.schema.buildings:Building"
-"overture:buildings:building_part" = "overture.schema.buildings:BuildingPart"
+building = "overture.schema.buildings:Building"
+building_part = "overture.schema.buildings:BuildingPart"
 
 [project.entry-points.pytest11]
 overture_baselines = "overture.schema.system.testing.plugin"

packages/overture-schema-cli/pyproject.toml

@@ -7,7 +7,7 @@ dependencies = [
     "overture-schema-system",
     "pydantic>=2.12.0",
     "pyyaml>=6.0.2",
-    "click>=8.0",
+    "click>=8.1",
     "rich>=13.0",
     "yamlcore>=0.0.4",
 ]

packages/overture-schema-cli/src/overture/schema/cli/__init__.py

@@ -11,7 +11,6 @@
 )
 from .types import (
     ErrorLocation,
-    ModelDict,
     UnionType,
     ValidationErrorDict,
 )
@@ -25,7 +24,6 @@
     "perform_validation",
     "resolve_types",
     "ErrorLocation",
-    "ModelDict",
     "UnionType",
     "ValidationErrorDict",
 ]