feat: add overture-schema-cli package

Introduce a command-line interface for working with Overture schema
models. The CLI provides tools for schema introspection, validation,
and JSON Schema generation.

Commands:

  list-types [--theme THEME] [--detailed]
    List registered Overture types, optionally filtered by theme.
    With --detailed, shows model descriptions from docstrings.

  json-schema [--theme THEME] [--type TYPE]
    Generate JSON Schema for specified themes/types or all models.

  validate [--theme THEME] [--type TYPE] [--show-field FIELD] FILE
    Validate GeoJSON features against Overture schemas. Supports:
    - Single features and FeatureCollections
    - Heterogeneous collections (mixed types)
    - JSONL input from stdin (use '-' as FILE)
    - Automatic type detection via discriminator fields
    - Rich error display with data context windows

Type Resolution:

When --type is not specified, the validator builds a discriminated
union from registered models and uses Pydantic's tagged union support
to identify the most likely type. For heterogeneous collections, each
feature is validated against its detected type independently.

Error Display:

Validation errors show surrounding data context to help locate issues.
The --show-field option pins specific fields (e.g., id) in the display
header for easier identification in large datasets.

Pipeline Support:

The validate command accepts JSONL on stdin for integration with tools
like jq and gpq:

    gpq convert file.geoparquet --to geojson | \
    jq -c '.features[]' | \
    overture-schema validate --type building -

Module Structure:

- commands.py: Click command definitions
- type_analysis.py: Union type construction and discriminator handling
- error_formatting.py: Validation error processing and display
- data_display.py: Context window and field extraction
- output.py: Rich console output helpers

Author: mojodna

Makefile

@@ -3,7 +3,7 @@
 default: test-all
 
 uv-sync:
-	@uv sync --all-packages
+	@uv sync --all-packages 2> /dev/null
 
 check: test doctest
 	@uv run ruff check -q packages/

packages/overture-schema-annex/pyproject.toml

@@ -1,8 +1,5 @@
 [project]
-dependencies = [
-    "overture-schema-core",
-    "pydantic>=2.0",
-]
+dependencies = ["overture-schema-core", "pydantic>=2.0"]
 description = "Add your description here"
 dynamic = ["version"]
 license = "MIT"
@@ -24,7 +21,7 @@ path = "src/overture/schema/__about__.py"
 packages = ["src/overture"]
 
 [project.entry-points."overture.models"]
-"sources.sources" = "overture.schema.annex.models:Sources"
+"annex:sources" = "overture.schema.annex:Sources"
 
 [tool.pytest.ini_options]
 pythonpath = ["src"]

packages/overture-schema-annex/src/overture/schema/annex/__main__.py

@@ -0,0 +1,19 @@
+# overture-schema-cli
+
+Command-line interface for validating and working with Overture Maps schema.
+
+This package provides the `overture-schema` command for validating GeoJSON and YAML files against Overture Maps schemas.
+
+## Installation
+
+```bash
+pip install overture-schema-cli
+```
+
+## Usage
+
+```bash
+overture-schema validate <file>
+```
+
+See the main [overture-schema](https://github.com/OvertureMaps/schema) documentation for more details.

packages/overture-schema-cli/README.md

@@ -0,0 +1,38 @@
+[project]
+dependencies = [
+    "overture-schema-core",
+    "pydantic>=2.0",
+    "pyyaml>=6.0.2",
+    "click>=8.0",
+    "rich>=13.0",
+    "yamlcore>=0.0.4",
+]
+description = "Command-line interface for Overture Maps schema validation and JSON Schema generation"
+dynamic = ["version"]
+license = "MIT"
+name = "overture-schema-cli"
+readme = "README.md"
+requires-python = ">=3.10"
+
+[tool.uv.sources]
+overture-schema-core = { workspace = true }
+
+[build-system]
+build-backend = "hatchling.build"
+requires = ["hatchling"]
+
+[dependency-groups]
+dev = [
+    "pytest>=7.0",
+    "ruff",
+    "mypy",
+]
+
+[tool.hatch.version]
+path = "src/overture/schema/cli/__about__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/overture"]
+
+[project.scripts]
+overture-schema = "overture.schema.cli:cli"

packages/overture-schema-cli/pyproject.toml

@@ -0,0 +1 @@
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)

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

@@ -0,0 +1 @@
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)

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

@@ -0,0 +1 @@
+__version__ = "0.1.0"

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

@@ -0,0 +1,31 @@
+"""CLI subpackage for overture-schema."""
+
+from .commands import (
+    cli,
+    create_union_type_from_models,
+    handle_generic_error,
+    handle_validation_error,
+    load_input,
+    perform_validation,
+    resolve_types,
+)
+from .types import (
+    ErrorLocation,
+    ModelDict,
+    UnionType,
+    ValidationErrorDict,
+)
+
+__all__ = [
+    "cli",
+    "create_union_type_from_models",
+    "handle_generic_error",
+    "handle_validation_error",
+    "load_input",
+    "perform_validation",
+    "resolve_types",
+    "ErrorLocation",
+    "ModelDict",
+    "UnionType",
+    "ValidationErrorDict",
+]

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

@@ -0,0 +1,6 @@
+"""Support for python -m overture.schema.cli."""
+
+from .commands import cli
+
+if __name__ == "__main__":
+    cli()