feat(openlabel): add structural LinkML schema for ASAM v1 JSON format

- Add openlabel-v2-schema.yaml: 12 classes, 4 enums, 227 TagTypeEnum values
- Generate JSON Schema artifact (openlabel-v2.schema.json) via gen-json-schema
- Add sync_tag_type_enum.py script to keep vocabulary in sync with ontology
- Add convert_openlabel_v1_to_v2.py script for v1-to-v2 format conversion
- Add 19 pytest tests covering schema generation, validation, sync, and converter
- Wire pre-commit hook for automatic TagTypeEnum synchronization
- Extend Makefile generate target to produce JSON Schema when schema model exists
- Document unified modeling strategy in SCHEMA_MODELING.md

Signed-off-by: Carlo van Driesten <carlo.van-driesten@bmw.de>

Author: jdsika

.pre-commit-config.yaml

@@ -16,6 +16,14 @@ repos:
         types: [python]
         pass_filenames: true
 
+      - id: sync-tag-type-enum
+        name: Sync TagTypeEnum to structural schema
+        entry: python scripts/sync_tag_type_enum.py
+        language: system
+        pass_filenames: false
+        files: ^linkml/openlabel-v2/openlabel-v2\.yaml$
+        stages: [pre-commit]
+
       - id: generate-linkml
         name: Generate LinkML Artifacts
         entry: make generate
@@ -51,23 +59,23 @@ repos:
         entry: python -m src.tools.utils.registry_updater
         language: system
         pass_filenames: false
-        files: ^artifacts/.*\.(owl\.ttl|shacl\.ttl|context\.jsonld)$
+        files: ^artifacts/.*\.(owl\.ttl|shacl\.ttl|context\.jsonld|schema\.json)$
         stages: [pre-commit]
 
       - id: update-properties
         name: Update Properties Documentation
         entry: python -m src.tools.utils.properties_updater
         language: system
         pass_filenames: false
-        files: ^artifacts/.*\.(owl\.ttl|shacl\.ttl|context\.jsonld)$
+        files: ^artifacts/.*\.(owl\.ttl|shacl\.ttl|context\.jsonld|schema\.json)$
         stages: [pre-commit]
 
       - id: update-readme
         name: Update README Catalog Table
         entry: python -m src.tools.utils.readme_updater
         language: system
         pass_filenames: false
-        files: ^artifacts/.*\.(owl\.ttl|shacl\.ttl|context\.jsonld)$
+        files: ^artifacts/.*\.(owl\.ttl|shacl\.ttl|context\.jsonld|schema\.json)$
         stages: [pre-commit]
 
   - repo: https://github.com/pre-commit/pre-commit-hooks

Makefile

@@ -61,6 +61,7 @@ endef
 GEN_OWL := $(VENV_BIN)/gen-owl
 GEN_SHACL := $(VENV_BIN)/gen-shacl
 GEN_JSONLD_CONTEXT := $(VENV_BIN)/gen-jsonld-context
+GEN_JSON_SCHEMA := $(VENV_BIN)/gen-json-schema
 
 # LinkML domains — add new domains here
 LINKML_DOMAINS := openlabel-v2
@@ -211,6 +212,10 @@ _generate_default:
 		"$(GEN_OWL)" --deterministic --normalize-prefixes --xsd-anyuri-as-iri --no-metadata --default-language en --ontology-uri-suffix "" linkml/$$domain/$$domain.yaml 2>/dev/null | tr -d '\r' | sed -e '$${' -e '/^$$/d' -e '}' > artifacts/$$domain/$$domain.owl.ttl; \
 		"$(GEN_SHACL)" --deterministic --normalize-prefixes --no-metadata --default-language en --message-template "{name} ({class}): {description} {comments}" linkml/$$domain/$$domain.yaml 2>/dev/null | tr -d '\r' | sed -e '$${' -e '/^$$/d' -e '}' > artifacts/$$domain/$$domain.shacl.ttl; \
 		"$(GEN_JSONLD_CONTEXT)" --deterministic --normalize-prefixes --no-metadata --exclude-external-imports --xsd-anyuri-as-iri linkml/$$domain/$$domain.yaml 2>/dev/null | tr -d '\r' | sed -e '$${' -e '/^$$/d' -e '}' > artifacts/$$domain/$$domain.context.jsonld; \
+		if [ -f linkml/$$domain/$$domain-schema.yaml ]; then \
+			echo "    Generating JSON Schema for $$domain..."; \
+			"$(GEN_JSON_SCHEMA)" linkml/$$domain/$$domain-schema.yaml 2>/dev/null | tr -d '\r' > artifacts/$$domain/$$domain.schema.json; \
+		fi; \
 	done
 	@echo "[OK] Artifacts generated"
 
@@ -408,7 +413,7 @@ _help_general:
 	@echo "  make format         - Format code with ruff"
 	@echo ""
 	@echo "LinkML:"
-	@echo "  make generate                     - Generate OWL/SHACL/context from all OMB LinkML schemas"
+	@echo "  make generate                     - Generate OWL/SHACL/context/JSON Schema from all OMB LinkML schemas"
 	@echo "  make generate DOMAIN=openlabel-v2 - Generate for a specific OMB domain"
 	@echo "  make generate gx                  - Build and sync Gaia-X artifacts from service-characteristics"
 	@echo "  make generate help                - Show generate subcommands"
@@ -434,7 +439,7 @@ _help_install:
 
 _help_generate:
 	@echo "Generate subcommands:"
-	@echo "  make generate                     - Generate OWL/SHACL/context from all OMB LinkML schemas"
+	@echo "  make generate                     - Generate OWL/SHACL/context/JSON Schema from all OMB LinkML schemas"
 	@echo "  make generate DOMAIN=openlabel-v2 - Generate for a specific OMB domain"
 	@echo "  make generate gx                  - Build and sync Gaia-X artifacts from service-characteristics"
 	@echo "  make generate gx GX_REF=25.12     - Check out a specific Gaia-X ref before generating"