pbf/tasks/NavSea_Semantic_Overlay_Validation_System.md

NavSea Semantic Overlay Validation System

Purpose

Validate the NavSea semantic overlay without touching rendering logic, style configuration, or vector tile structure.

Inputs

The task reads the existing semantic overlay and audit tables in database pbf_analysis, including:

• canonical_layer_rules
• canonical_object_rules
• object_geometry_allowlist
• pbf_relayer_candidates
• pbf_render_compatibility
• pbf_detection_catalog
• style_layers
• features
• tile_density

Execution

Rebuild the semantic overlay metadata and then run validation:

.venv/bin/python navsea_relayer.py
.venv/bin/python navsea_semantic_validation.py

Validation Tables

The validation task creates or refreshes:

• classification_validation
• geometry_consistency
• style_render_equivalence
• detection_catalog_integrity
• spatial_anomalies
• semantic_validation_summary

Current Design Notes

• Rendering compatibility is verified at database level only.
• canonical_object_rules is the stable object-level rule source.
• object_geometry_allowlist is the geometry whitelist used to separate valid multi-geometry objects from true anomalies.
• spatial_anomalies is intentionally lightweight and currently focuses on tile-density and tile-index anomalies.

Success Criteria

• No render equivalence break
• No classification errors
• No geometry consistency errors
• No detection catalog integrity errors
• Spatial anomalies limited to acceptable warnings