sqlbuild 0.14.0__tar.gz → 0.15.0__tar.gz

sqlbuild-0.15.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.15.0"
+}

{sqlbuild-0.14.0 → sqlbuild-0.15.0}/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [0.15.0](https://github.com/chio-labs/sqlbuild/compare/v0.14.0...v0.15.0) (2026-05-17)
+
+
+### Features
+
+* add structured execution diagnostics ([4bb1374](https://github.com/chio-labs/sqlbuild/commit/4bb13749c79fdc7a9c3cba86252f93bc2c4262a1))
+* tighten contract runtime diagnostics ([e051d44](https://github.com/chio-labs/sqlbuild/commit/e051d44663baf60b702578bb866499f0e43ad674))
+* validate runtime model contracts ([b298ea1](https://github.com/chio-labs/sqlbuild/commit/b298ea1c858ac96f22280f894c95e53b5223e12d))
+* validate source contract metadata ([ab906f2](https://github.com/chio-labs/sqlbuild/commit/ab906f2255ee7d2970a59aa05157035abc0aa435))
+
+
+### Bug Fixes
+
+* replace raw diagnostics with structured errors ([7a10cc6](https://github.com/chio-labs/sqlbuild/commit/7a10cc6602cc159144e42b14aea92d681ac6167d))
+
+
+### Documentation
+
+* update generated sqlbuild skill ([0d1f18a](https://github.com/chio-labs/sqlbuild/commit/0d1f18ac2abd563aab9fa7257436947b6be1510c))
+
 ## [0.14.0](https://github.com/chio-labs/sqlbuild/compare/v0.13.0...v0.14.0) (2026-05-16)
 
 

{sqlbuild-0.14.0 → sqlbuild-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlbuild
-Version: 0.14.0
+Version: 0.15.0
 Summary: Typed, test-first SQL pipelines with local E2E testing
 License-File: LICENSE
 Requires-Python: >=3.12

{sqlbuild-0.14.0 → sqlbuild-0.15.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sqlbuild"
-version = "0.14.0"
+version = "0.15.0"
 description = "Typed, test-first SQL pipelines with local E2E testing"
 readme = "README.md"
 requires-python = ">=3.12"

{sqlbuild-0.14.0 → sqlbuild-0.15.0}/scripts/structure/structure_conventions/checker.py

@@ -31,6 +31,7 @@ from scripts.structure.structure_conventions.rules import (
     check_models_module,
     check_nested_runtime_package_direct_modules,
     check_nested_runtime_package_direct_subpackages,
+    check_no_raw_runtime_diagnostics,
     check_no_relative_imports,
     check_no_sibling_package_imports,
     check_private_definition_ordering,
@@ -76,6 +77,7 @@ def check_paths(paths: list[Path], repo_root: Path | None = None) -> list[Violat
         violations.extend(check_models_module(file_path, module))
         violations.extend(check_constants_module(file_path, module))
         violations.extend(check_model_declarations_outside_models(file_path, module))
+        violations.extend(check_no_raw_runtime_diagnostics(file_path, module))
         violations.extend(check_private_definition_ordering(file_path, module))
         violations.extend(check_type_declarations_outside_types(file_path, module))
         violations.extend(check_exception_declarations_outside_exceptions(file_path, module))

{sqlbuild-0.14.0 → sqlbuild-0.15.0}/scripts/structure/structure_conventions/constants.py

@@ -9,3 +9,14 @@ TYPE_CLASS_BASE_NAMES: frozenset[str] = frozenset(
     {"Enum", "IntEnum", "StrEnum", "Flag", "IntFlag", "NamedTuple", "Protocol", "TypedDict"}
 )
 MODEL_CLASS_BASE_NAMES: frozenset[str] = frozenset({"BaseModel"})
+RAW_BUILTIN_RAISE_NAMES: frozenset[str] = frozenset(
+    {
+        "AssertionError",
+        "Exception",
+        "KeyError",
+        "NotImplementedError",
+        "RuntimeError",
+        "TypeError",
+        "ValueError",
+    }
+)

{sqlbuild-0.14.0 → sqlbuild-0.15.0}/scripts/structure/structure_conventions/rules.py

@@ -10,6 +10,7 @@ from scripts.structure.structure_conventions.constants import (
     DEV_TOOLING_FILE_PREFIXES,
     DEV_TOOLING_SEGMENTS,
     MODEL_CLASS_BASE_NAMES,
+    RAW_BUILTIN_RAISE_NAMES,
     TYPE_CLASS_BASE_NAMES,
 )
 from scripts.structure.structure_conventions.models import Violation
@@ -456,6 +457,41 @@ def check_model_declarations_outside_models(file_path: Path, module: ast.Module)
     return violations
 
 
+def check_no_raw_runtime_diagnostics(file_path: Path, module: ast.Module) -> list[Violation]:
+    """Reject raw built-in raises and asserts in production runtime code."""
+
+    if not _is_runtime_source_file(file_path):
+        return []
+
+    violations: list[Violation] = []
+    for node in ast.walk(module):
+        if isinstance(node, ast.Raise) and _raise_uses_raw_builtin(node):
+            violations.append(
+                Violation(
+                    code="SC035",
+                    path=file_path,
+                    line=node.lineno,
+                    message=(
+                        "production code must raise a structured SQLBuild error instead of "
+                        "a raw built-in exception"
+                    ),
+                )
+            )
+        if isinstance(node, ast.Assert):
+            violations.append(
+                Violation(
+                    code="SC036",
+                    path=file_path,
+                    line=node.lineno,
+                    message=(
+                        "production code must not use assert for runtime invariants; "
+                        "raise a structured SQLBuild error"
+                    ),
+                )
+            )
+    return violations
+
+
 def check_private_definition_ordering(file_path: Path, module: ast.Module) -> list[Violation]:
     """Reject private dataclasses and constants that appear after function definitions."""
 
@@ -1226,6 +1262,20 @@ def _base_name(node: ast.expr) -> str | None:
     return None
 
 
+def _is_runtime_source_file(file_path: Path) -> bool:
+    parts: tuple[str, ...] = file_path.parts
+    return "src" in parts and "sqlbuild" in parts and file_path.suffix == ".py"
+
+
+def _raise_uses_raw_builtin(node: ast.Raise) -> bool:
+    if node.exc is None:
+        return False
+    raised_name: str | None = (
+        _base_name(node.exc.func) if isinstance(node.exc, ast.Call) else _base_name(node.exc)
+    )
+    return raised_name in RAW_BUILTIN_RAISE_NAMES
+
+
 def _decorator_name(node: ast.expr) -> str:
     if isinstance(node, ast.Name):
         return node.id