refactor(sl): split overlay columns from column_overrides and enforce TS/Python wire contract

Overlay sources now have two distinct collections: `columns:` for computed
columns (requiring `expr` + `type`) and `column_overrides:` for metadata
patches to inherited manifest columns. Composing or loading an overlay that
mixes the two — or references an unknown column — fails with a typed error.

Introduce `ResolvedSemanticLayerSource` / `resolvedSourceSchema` /
`toResolvedWire` as the strict shape sent to the Python engine, and add a
schema contract test that diffs Zod against the Pydantic JSON schema dumped
by `python -m semantic_layer dump-schema`. `SourceDefinition` is now
`extra="forbid"` on the Python side.

`loadAllSources` surfaces per-file load errors instead of swallowing them,
so validation/query paths can report manifest shard parse failures.
This commit is contained in:
Andrey Avtomonov 2026-05-15 00:36:52 +02:00
parent 3e12a9fef4
commit f561bfa850
42 changed files with 847 additions and 193 deletions

View file

@ -148,11 +148,21 @@ class TestLoaderEdgeCases:
with open(Path(tmpdir) / "test.yaml", "w") as f:
yaml.dump(data, f)
loader = SourceLoader(tmpdir)
try:
sources = loader.load_all()
assert "test" in sources
except Exception:
pass
with pytest.raises(Exception, match="unknown_field"):
loader.load_all()
def test_source_requires_table_or_sql(self):
with tempfile.TemporaryDirectory() as tmpdir:
data = {
"name": "test",
"grain": ["id"],
"columns": [{"name": "id", "type": "number"}],
}
with open(Path(tmpdir) / "test.yaml", "w") as f:
yaml.dump(data, f)
loader = SourceLoader(tmpdir)
with pytest.raises(Exception, match="table.*sql"):
loader.load_file(Path(tmpdir) / "test.yaml")
def test_subdirectory_sources(self):
with tempfile.TemporaryDirectory() as tmpdir: