sqlbuild 0.137.0__tar.gz → 0.138.0__tar.gz

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/Cargo.lock

@@ -617,7 +617,7 @@ checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
 
 [[package]]
 name = "sqlbuild-analysis"
-version = "0.137.0"
+version = "0.138.0"
 dependencies = [
  "polyglot-sql",
  "polyglot-sql-function-catalogs",
@@ -632,11 +632,11 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-core"
-version = "0.137.0"
+version = "0.138.0"
 
 [[package]]
 name = "sqlbuild-python"
-version = "0.137.0"
+version = "0.138.0"
 dependencies = [
  "fensu-policy",
  "mimalloc",
@@ -650,7 +650,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-rules"
-version = "0.137.0"
+version = "0.138.0"
 dependencies = [
  "fensu-policy",
  "globset",
@@ -671,7 +671,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-sqltext"
-version = "0.137.0"
+version = "0.138.0"
 dependencies = [
  "rayon",
  "serde",

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/Cargo.toml

@@ -17,7 +17,7 @@ python-boundary = "sqlbuild-python"
 polyglot-floor = "sqlbuild-analysis"
 
 [workspace.package]
-version = "0.137.0"
+version = "0.138.0"
 edition = "2024"
 license = "Apache-2.0"
 publish = false

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlbuild
-Version: 0.137.0
+Version: 0.138.0
 Requires-Dist: duckdb>=1.3.2
 Requires-Dist: filelock>=3.20.3
 Requires-Dist: orjson>=3.10.0

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/crates/sqlbuild-rules/src/engine/_helpers/cache.rs

@@ -16,21 +16,24 @@ pub(crate) struct RuleCacheEntry {
 }
 
 pub(crate) struct Cache {
-    root: PathBuf,
+    native_rules_path: PathBuf,
 }
 
 impl Cache {
-    pub(crate) fn open(project_dir: &Path) -> Result<Self, String> {
-        Ok(Self {
-            root: project_dir.join("target/rules-cache"),
-        })
+    pub(crate) fn open(project_dir: &Path, rules_cache_path: &str) -> Result<Self, String> {
+        let native_rules_path = if rules_cache_path.is_empty() {
+            project_dir.join("target/rules-cache/bulk/native.json")
+        } else {
+            PathBuf::from(rules_cache_path)
+        };
+        Ok(Self { native_rules_path })
     }
 
     pub(crate) fn native_rules_bucket(
         &self,
         ruleset_identity: &str,
     ) -> Result<RuleCacheBucket, String> {
-        read_bucket(&self.root.join("bulk/native.json"), ruleset_identity)
+        read_bucket(&self.native_rules_path, ruleset_identity)
     }
 
     pub(crate) fn put_native_rules_bucket(
@@ -38,11 +41,7 @@ impl Cache {
         ruleset_identity: &str,
         bucket: &RuleCacheBucket,
     ) -> Result<(), String> {
-        write_bucket(
-            &self.root.join("bulk/native.json"),
-            ruleset_identity,
-            bucket,
-        )
+        write_bucket(&self.native_rules_path, ruleset_identity, bucket)
     }
 }
 

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/crates/sqlbuild-rules/src/engine/_helpers/evaluation.rs

@@ -320,7 +320,7 @@ pub(crate) fn evaluate_request(request: EvaluateRequest) -> Result<String, Strin
         .transpose()?
         .unwrap_or_default();
     let cache = cache_enabled
-        .then(|| Cache::open(Path::new(&request.project_dir)))
+        .then(|| Cache::open(Path::new(&request.project_dir), &request.rules_cache_path))
         .transpose()?;
     let built_in_started = Instant::now();
     let mut raw_faults = request.initial_findings.clone();

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/crates/sqlbuild-rules/src/engine/tests/test_incremental_rules.rs

@@ -330,6 +330,47 @@ fn given_removed_model_file_when_cache_is_rewritten_then_only_its_entry_is_dropp
     Ok(())
 }
 
+#[test]
+fn given_configured_cache_path_when_evaluating_then_only_that_file_is_used() -> Result<(), String> {
+    let test_cases = [test_types::ConfiguredCachePathTestCase {
+        description: "an engine-owned cache file replaces the default bulk cache",
+        cache_file: "target/rules-cache-native-v1/bulk/native.json",
+        expected_default_cache_exists: false,
+        expected_warm_hits: 3,
+    }];
+    for test_case in &test_cases {
+        let project_dir = TempDir::new().map_err(|error| error.to_string())?;
+        let mut rest = split_request(
+            &project_dir,
+            &json!({"select": ["SQBR"], "cache": {"enabled": true}}),
+        );
+        let cache_path = project_dir.path().join(test_case.cache_file);
+        rest["rules_cache_path"] = json!(cache_path);
+        let models = orders_models();
+
+        let cold = evaluate_split(&rest, &models)?;
+        let warm = evaluate_split(&rest, &models)?;
+
+        assert!(cache_path.is_file(), "{}", test_case.description);
+        assert_eq!(
+            project_dir
+                .path()
+                .join("target/rules-cache/bulk/native.json")
+                .exists(),
+            test_case.expected_default_cache_exists,
+            "{}",
+            test_case.description
+        );
+        assert_eq!(
+            warm["cache_hits"], test_case.expected_warm_hits,
+            "{}",
+            test_case.description
+        );
+        assert_eq!(warm["faults"], cold["faults"], "{}", test_case.description);
+    }
+    Ok(())
+}
+
 #[test]
 fn given_corrupt_model_cache_when_evaluating_then_every_model_reevaluates() -> Result<(), String> {
     let test_cases = [test_types::ModelCacheReuseTestCase {

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/crates/sqlbuild-rules/src/engine/tests/test_types.rs

@@ -242,6 +242,13 @@ pub(crate) struct ModelCacheReuseTestCase {
     pub(crate) expected_misses: u64,
 }
 
+pub(crate) struct ConfiguredCachePathTestCase {
+    pub(crate) description: &'static str,
+    pub(crate) cache_file: &'static str,
+    pub(crate) expected_default_cache_exists: bool,
+    pub(crate) expected_warm_hits: u64,
+}
+
 pub(crate) struct CachePruningTestCase {
     pub(crate) description: &'static str,
     pub(crate) expected_paths: &'static [&'static str],

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/crates/sqlbuild-rules/src/models.rs

@@ -729,6 +729,7 @@ pub struct EvaluateRequest {
     pub initial_findings: Vec<Fault>,
     pub defer_suppressions: bool,
     pub custom_rules: Vec<CustomRule>,
+    pub rules_cache_path: String,
 }
 
 #[derive(Clone, Debug, Deserialize, Serialize)]
@@ -765,6 +766,7 @@ impl Default for EvaluateRequest {
             initial_findings: vec![],
             defer_suppressions: false,
             custom_rules: vec![],
+            rules_cache_path: String::new(),
         }
     }
 }

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/pyproject.toml

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

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/src/sqlbuild/cli/commands/_helpers/compile/output.py

@@ -38,6 +38,7 @@ from sqlbuild.compiler.compile.types import (
 )
 from sqlbuild.compiler.discovery.constants import SQL_HOOK_OUTPUT_FIELDS
 from sqlbuild.compiler.discovery.main.serialize_hook_entries import serialize_hook_entries
+from sqlbuild.compiler.frontier.main.resolve_compiler_engine import resolve_compiler_engine
 from sqlbuild.compiler.lineage.models import ProjectColumnLineage
 from sqlbuild.compiler.pipeline.models import ProjectGraph
 from sqlbuild.compiler.python_nodes.main.hook_identities import build_hook_identities
@@ -208,6 +209,7 @@ def format_compile_json(
             sql_validation_enabled=sql_validation_enabled,
         ),
         "compile_timings": timings_ms,
+        "compiler_engine": resolve_compiler_engine().value,
         "lineage_mode": lineage_mode.value,
         "resources": _resources(graph=graph, lineage=lineage),
         "artifacts": _artifacts(written=written, manifest=manifest),

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/src/sqlbuild/cli/commands/_helpers/debug/checks.py

@@ -41,6 +41,7 @@ from sqlbuild.compiler.discovery.constants import (
 )
 from sqlbuild.compiler.discovery.main.discover import discover_project_inputs
 from sqlbuild.compiler.discovery.models import DiscoveredProjectInputs, DiscoveredProvider
+from sqlbuild.compiler.frontier.main.resolve_compiler_engine import resolve_compiler_engine
 from sqlbuild.spec.contracts.main.resolve_effective_adapter_name import (
     resolve_effective_adapter_name,
 )
@@ -272,6 +273,7 @@ def _build_runtime_lines() -> list[DebugLine]:
         sqlbuild_version = "unknown"
     return [
         DebugLine(label="sqlbuild version", message=sqlbuild_version),
+        DebugLine(label="compiler engine", message=resolve_compiler_engine().value),
         DebugLine(label="python version", message=platform.python_version()),
         DebugLine(label="python path", message=sys.executable),
         DebugLine(label="os info", message=platform.platform()),

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/src/sqlbuild/cli/commands/_helpers/entry/parser.py

@@ -29,6 +29,7 @@ from sqlbuild.cli.commands.constants import (
 )
 from sqlbuild.cli.commands.types import CliCommand, CompileLineageMode
 from sqlbuild.compiler.contract_adoption.types import ContractAction
+from sqlbuild.compiler.frontier.constants import COMPILER_ENGINE_OPTION, COMPILER_ENGINE_VALUES
 from sqlbuild.compiler.lineage.types import ColumnLineageMode
 from sqlbuild.compiler.scopes.types import DeclarationKind
 
@@ -98,6 +99,13 @@ def _add_global_args(*, parser: argparse.ArgumentParser, suppress_defaults: bool
         default=argparse.SUPPRESS if suppress_defaults else False,
         help="enable verbose output and mirror internal diagnostics to stderr",
     )
+    parser.add_argument(
+        COMPILER_ENGINE_OPTION,
+        dest="compiler_engine",
+        choices=COMPILER_ENGINE_VALUES,
+        default=argparse.SUPPRESS if suppress_defaults else None,
+        help=argparse.SUPPRESS,
+    )
 
 
 def _add_global_args_to_subcommands(

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/src/sqlbuild/cli/commands/_helpers/entry/parsing.py

@@ -25,6 +25,8 @@ from sqlbuild.cli.entry.models import (
     SelectorFileSummary,
     SelectorInputs,
 )
+from sqlbuild.compiler.frontier.exceptions import CompilerEngineError
+from sqlbuild.compiler.frontier.main.resolve_compiler_engine import resolve_compiler_engine
 from sqlbuild.compiler.scopes.types import DeclarationKind
 from sqlbuild.integrations.dbt.types import DbtInteropCommand
 
@@ -115,6 +117,11 @@ def parse_cli_invocation(
             if unknown_args:
                 parser.error(f"unrecognized arguments: {' '.join(unknown_args)}")
         args.verbose = args.verbose or args.debug
+        if args.compiler_engine is None:
+            try:
+                _ = resolve_compiler_engine()
+            except CompilerEngineError as error:
+                parser.error(str(error))
         if (
             args.debug
             and args.command == CliCommand.DBT

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/src/sqlbuild/cli/commands/_helpers/lineage/cache.py

@@ -16,11 +16,14 @@ from typing import Any
 from sqlbuild.cli.commands.constants import TARGET_DIRECTORY_NAME
 from sqlbuild.cli.commands.models import LineageNode, RelationLineageIndex
 from sqlbuild.compiler.compile.models import CompiledObjectKey, CompiledProject
+from sqlbuild.compiler.frontier.constants import CACHE_DIRECTORY_NAME
+from sqlbuild.compiler.frontier.main.engine_cache_name import engine_cache_name
 from sqlbuild.compiler.pipeline.models import ProjectGraph
 
 _CACHE_SCHEMA_VERSION: int = 1
 _CACHE_ALGORITHM_VERSION: str = "relation-lineage-graph-v4"
-_CACHE_RELATIVE_PATH: Path = Path("cache/lineage/v1/structural-graph.sqlite3")
+_LINEAGE_CACHE_DIRECTORY_NAME: str = "lineage"
+_CACHE_FILE_RELATIVE_PATH: Path = Path("v1/structural-graph.sqlite3")
 _CACHE_MAX_BYTES: int = 50_000_000
 _CACHE_MAX_ROWS: int = 1_000_000
 _SQLITE_TIMEOUT_SECONDS: float = 5.0
@@ -176,7 +179,13 @@ def _is_excluded(*, path: Path, project_dir: Path) -> bool:
 
 
 def _cache_path(*, project_dir: Path) -> Path:
-    return project_dir / TARGET_DIRECTORY_NAME / _CACHE_RELATIVE_PATH
+    return (
+        project_dir
+        / TARGET_DIRECTORY_NAME
+        / CACHE_DIRECTORY_NAME
+        / engine_cache_name(_LINEAGE_CACHE_DIRECTORY_NAME)
+        / _CACHE_FILE_RELATIVE_PATH
+    )
 
 
 def _relation_index(*, graph: ProjectGraph) -> RelationLineageIndex:

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/src/sqlbuild/cli/commands/classes/cli_namespace.py

@@ -48,6 +48,7 @@ _DEFAULT_VALUES: dict[str, object] = {
     "start_cursor_int": None,
     "end_cursor_int": None,
     "no_color": False,
+    "compiler_engine": None,
     "fail_fast": False,
     "full_refresh": False,
     "as_target": None,
@@ -217,6 +218,7 @@ class CliNamespace:
     start_cursor_int: str | None
     end_cursor_int: str | None
     no_color: bool
+    compiler_engine: str | None
     fail_fast: bool
     full_refresh: bool
     as_target: str | None

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/src/sqlbuild/cli/commands/main/entrypoint/entry.py

@@ -14,6 +14,8 @@ from sqlbuild.cli.entry.models import (
     CliEntrypointHandlers,
     ParsedCliInvocation,
 )
+from sqlbuild.compiler.frontier.main.compiler_engine_override import compiler_engine_override
+from sqlbuild.compiler.frontier.types import CompilerEngine
 from sqlbuild.diagnostics.main.diagnostics_context import diagnostics_context
 from sqlbuild.presentation.main.supports_color import supports_color
 from sqlbuild.runtime.observability.main.invocation_external_context_scope import (
@@ -61,13 +63,16 @@ def _main_with_dependencies(
                 dispatch_with_compute_logs,
             )
 
-            return dispatch_with_compute_logs(
-                args=args,
-                identity=identity,
-                operation=lambda: dispatch_and_handle_errors(
+            with compiler_engine_override(
+                None if args.compiler_engine is None else CompilerEngine(args.compiler_engine)
+            ):
+                return dispatch_with_compute_logs(
                     args=args,
-                    invocation=invocation,
-                    handlers=handlers,
-                    use_color=use_color,
-                ),
-            )
+                    identity=identity,
+                    operation=lambda: dispatch_and_handle_errors(
+                        args=args,
+                        invocation=invocation,
+                        handlers=handlers,
+                        use_color=use_color,
+                    ),
+                )

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/src/sqlbuild/cli/compile_reuse/_helpers/attempt.py

@@ -45,7 +45,7 @@ from sqlbuild.cli.compile_reuse.constants import (
     PROJECT_CONFIG_FILENAMES,
     REUSE_DISABLE_ENV_VAR,
     REUSE_DISABLE_VALUE,
-    REUSE_ENTRY_DIRECTORY_PARTS,
+    REUSE_ENTRY_DIRECTORY_NAME,
     REUSE_ENTRY_SUFFIX,
     REUSE_HIT_MESSAGE,
     TOTAL_TIMING,
@@ -62,6 +62,7 @@ from sqlbuild.compiler.compile.constants import (
     COMPILE_CACHE_DISABLE_ENV_VAR,
     COMPILE_CACHE_DISABLE_VALUE,
 )
+from sqlbuild.compiler.frontier.main.compiler_cache_directory import compiler_cache_directory
 from sqlbuild.presentation.main.supports_color import supports_color
 
 
@@ -81,7 +82,8 @@ def attempt_reuse(*, request: CompileReuseRequest) -> CompileReuseAttempt:
     attempt: CompileReuseAttempt = replace(
         bypass,
         outcome=CompileReuseOutcome.MISS,
-        entry_path=Path(project_dir, *REUSE_ENTRY_DIRECTORY_PARTS)
+        entry_path=compiler_cache_directory(Path(project_dir))
+        / REUSE_ENTRY_DIRECTORY_NAME
         / f"{entry_slot_name(selected_target=request.selected_target)}{REUSE_ENTRY_SUFFIX}",
         runtime=runtime_identity(),
         search_path=search_path_stamps(project_dir=project_dir),

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/src/sqlbuild/cli/compile_reuse/_helpers/runtime_identity.py

@@ -17,8 +17,10 @@ from sqlbuild.cli.compile_reuse.constants import (
     PROJECT_ROOT_PATH_MTIME_NS,
     REUSE_FORMAT_VERSION,
     TRACKED_ENVIRONMENT_PREFIXES,
+    UNTRACKED_ENVIRONMENT_NAMES,
 )
 from sqlbuild.cli.compile_reuse.models import CompileReuseRequest, SettingsEnvironmentInputs
+from sqlbuild.compiler.frontier.main.resolve_compiler_engine import resolve_compiler_engine
 
 
 def runtime_identity() -> dict[str, str]:
@@ -96,10 +98,12 @@ def module_stamps_unchanged(*, stamps: tuple[tuple[str, int, int], ...]) -> bool
 
 
 def tracked_environment_names(*, template_names: tuple[str, ...]) -> tuple[str, ...]:
-    """Return SQLBuild-prefixed variables plus the variables templates read."""
+    """Return tracked SQLBuild variables (not engine or capture settings) plus template reads."""
 
     prefixed: set[str] = {
-        name for name in os.environ if name.startswith(TRACKED_ENVIRONMENT_PREFIXES)
+        name
+        for name in os.environ
+        if name.startswith(TRACKED_ENVIRONMENT_PREFIXES) and name not in UNTRACKED_ENVIRONMENT_NAMES
     }
     return tuple(sorted(prefixed.union(template_names)))
 
@@ -155,6 +159,7 @@ def invocation_digest(*, request: CompileReuseRequest, project_dir: str, use_col
         "exclude": list(request.exclude),
         "cli_vars": request.cli_vars,
         "sys_path": list(sys.path),
+        "compiler_engine": resolve_compiler_engine().value,
     }
     encoded: bytes = json.dumps(
         payload, sort_keys=True, separators=(",", ":"), default=repr

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/src/sqlbuild/cli/compile_reuse/constants.py

@@ -7,9 +7,19 @@ from typing import Literal
 from sqlbuild.cli.compile_reuse.classes.compile_artifact_write_registry import (
     CompileArtifactWriteRegistry,
 )
+from sqlbuild.compiler.frontier.constants import (
+    COMPILER_ENGINE_ENV_VAR,
+    STAGE_CAPTURE_DIR_ENV_VAR,
+)
 
 REUSE_FORMAT_VERSION: int = 1
-REUSE_ENTRY_DIRECTORY_PARTS: tuple[str, ...] = ("target", "cache", "compiler", "project-reuse-v1")
+REUSE_ENTRY_DIRECTORY_NAME: str = "project-reuse-v1"
+REUSE_ENTRY_DIRECTORY_PARTS: tuple[str, ...] = (
+    "target",
+    "cache",
+    "compiler",
+    REUSE_ENTRY_DIRECTORY_NAME,
+)
 REUSE_ENTRY_MAGIC: bytes = b"SQBREUSE1\n"
 REUSE_ENTRY_SUFFIX: str = ".entry"
 REUSE_STDOUT_SUFFIX: str = ".stdout"
@@ -25,6 +35,9 @@ REUSE_DISABLE_ENV_VAR: str = "SQLBUILD_DISABLE_COMPILE_REUSE"
 REUSE_DISABLE_VALUE: str = "1"
 REUSE_LOGGER_NAME: str = "sqlbuild.compile.reuse"
 TRACKED_ENVIRONMENT_PREFIXES: tuple[str, ...] = ("SQLBUILD_", "SQB_")
+UNTRACKED_ENVIRONMENT_NAMES: frozenset[str] = frozenset(
+    {COMPILER_ENGINE_ENV_VAR, STAGE_CAPTURE_DIR_ENV_VAR}
+)
 MISSING_ENVIRONMENT_VALUE: str = "\0missing"
 MISSING_FILE_DIGEST: str = "\0missing"
 PROJECT_CONFIG_FILENAMES: tuple[str, ...] = ("sqlbuild_project.toml", "sqlbuild_project.yml")

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/src/sqlbuild/compiler/discovery/main/discover.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from functools import partial
 from pathlib import Path
 
 from sqlbuild.compiler.discovery._helpers.filesystem.aggregation import (
@@ -26,6 +27,8 @@ from sqlbuild.compiler.discovery.constants import (
 from sqlbuild.compiler.discovery.models import DiscoveredProjectInputs, DiscoveryCacheRequest
 from sqlbuild.compiler.discovery.types import DeclarationFilesReuse
 from sqlbuild.compiler.fact_cache.classes.fact_cache_store import FactCacheStore
+from sqlbuild.compiler.frontier.main._compile_frontier import compile_frontier
+from sqlbuild.compiler.frontier.types import CompilerStage
 from sqlbuild.runtime.observability.classes.operation_lifecycle import OperationLifecycle
 from sqlbuild.spec.contracts.models import LocalConfig, ProjectConfig
 
@@ -41,12 +44,16 @@ def discover_project_inputs(
     """Load all raw project inputs from disk before semantic resolution."""
 
     with OperationLifecycle(operation_kind="project", operation_name="project_discovery"):
-        return _discover_project_inputs(
-            project_dir=project_dir,
-            sql_analysis_enabled_override=sql_analysis_enabled_override,
-            extract_output_column_locations=extract_output_column_locations,
-            cache_request=cache_request,
-            declaration_reuse=declaration_reuse,
+        return compile_frontier(
+            until=CompilerStage.DISCOVERED_PROJECT_INPUTS,
+            python_stage=partial(
+                _discover_project_inputs,
+                project_dir=project_dir,
+                sql_analysis_enabled_override=sql_analysis_enabled_override,
+                extract_output_column_locations=extract_output_column_locations,
+                cache_request=cache_request,
+                declaration_reuse=declaration_reuse,
+            ),
         )
 
 

{sqlbuild-0.137.0 → sqlbuild-0.138.0}/src/sqlbuild/compiler/fact_cache/main/_compile_cache_root.py

@@ -9,6 +9,7 @@ from sqlbuild.compiler.compile.constants import (
     COMPILE_CACHE_DISABLE_ENV_VAR,
     COMPILE_CACHE_DISABLE_VALUE,
 )
+from sqlbuild.compiler.frontier.main.compiler_cache_directory import compiler_cache_directory
 from sqlbuild.spec.contracts.models import TargetConfig
 
 
@@ -24,4 +25,4 @@ def compile_cache_root(
         or os.environ.get(COMPILE_CACHE_DISABLE_ENV_VAR) == COMPILE_CACHE_DISABLE_VALUE
     ):
         return None
-    return project_dir / "target" / "cache" / "compiler"
+    return compiler_cache_directory(project_dir)

sqlbuild-0.138.0/src/sqlbuild/compiler/frontier/__init__.py

@@ -0,0 +1 @@
+"""Compiler engine selection and the native frontier seam."""

sqlbuild-0.138.0/src/sqlbuild/compiler/frontier/_helpers/engine.py

@@ -0,0 +1,26 @@
+"""Engine parsing and environment lookup shared by the frontier entry points."""
+
+import os
+
+from sqlbuild.compiler.frontier.constants import (
+    COMPILER_ENGINE_ENV_VAR,
+    COMPILER_ENGINE_VALUES,
+    DEFAULT_COMPILER_ENGINE,
+)
+from sqlbuild.compiler.frontier.exceptions import CompilerEngineError
+from sqlbuild.compiler.frontier.types import CompilerEngine
+
+
+def active_compiler_engine() -> CompilerEngine:
+    """Return the engine selected by SQLBUILD_COMPILER_ENGINE, defaulting to Python."""
+
+    raw_value: str | None = os.environ.get(COMPILER_ENGINE_ENV_VAR)
+    if not raw_value:
+        return DEFAULT_COMPILER_ENGINE
+    try:
+        return CompilerEngine(raw_value)
+    except ValueError as error:
+        raise CompilerEngineError(
+            f"{COMPILER_ENGINE_ENV_VAR} must be one of {', '.join(COMPILER_ENGINE_VALUES)} "
+            f"(got {raw_value!r})"
+        ) from error

sqlbuild-0.138.0/src/sqlbuild/compiler/frontier/_helpers/native_frontier.py

@@ -0,0 +1,12 @@
+"""The native side of the compiler frontier."""
+
+from collections.abc import Callable
+
+from sqlbuild.compiler.frontier.types import CompilerStage
+
+
+def native_frontier[T](*, until: CompilerStage, python_stage: Callable[[], T]) -> T:
+    """Produce the frontier object for `until` natively; no stage is native yet."""
+
+    _ = until
+    return python_stage()

sqlbuild-0.138.0/src/sqlbuild/compiler/frontier/_helpers/stage_capture.py

@@ -0,0 +1,37 @@
+"""Dump frontier objects as canonical JSON so two engines can be compared stage by stage."""
+
+import json
+import os
+from pathlib import Path
+
+from sqlbuild.compiler.frontier.classes.stage_capture_encoder import StageCaptureEncoder
+from sqlbuild.compiler.frontier.classes.stage_capture_sequence import StageCaptureSequence
+from sqlbuild.compiler.frontier.constants import STAGE_CAPTURE_DIR_ENV_VAR, STAGE_CAPTURE_SUFFIX
+from sqlbuild.compiler.frontier.types import CompilerStage
+
+
+def write_stage_capture(*, stage: CompilerStage, value: object) -> None:
+    """Write one frontier object when SQLBUILD_COMPILER_STAGE_CAPTURE_DIR names a directory."""
+
+    directory: str | None = os.environ.get(STAGE_CAPTURE_DIR_ENV_VAR)
+    if not directory:
+        return
+    path: Path = Path(directory) / (
+        f"{StageCaptureSequence.next_value():03d}-{stage.value}{STAGE_CAPTURE_SUFFIX}"
+    )
+    path.parent.mkdir(parents=True, exist_ok=True)
+    _ = path.write_text(render_stage_capture(value), encoding="utf-8")
+
+
+def render_stage_capture(value: object) -> str:
+    """Render a value as indented JSON that keeps insertion order and sorts only sets."""
+
+    return (
+        json.dumps(
+            StageCaptureEncoder().encode(value),
+            indent=1,
+            ensure_ascii=False,
+            allow_nan=False,
+        )
+        + "\n"
+    )

sqlbuild-0.138.0/src/sqlbuild/compiler/frontier/classes/__init__.py

@@ -0,0 +1 @@
+"""Compiler frontier runtime classes."""