sqlbuild 0.12.0__tar.gz → 0.13.0__tar.gz

{sqlbuild-0.12.0 → sqlbuild-0.13.0}/.gitignore

@@ -57,3 +57,5 @@ sqlbuild_local.yml
 **/sqlbuild_local.yml
 sqlbuild_local.toml
 **/sqlbuild_local.toml
+
+.tmp*

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

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

{sqlbuild-0.12.0 → sqlbuild-0.13.0}/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [0.13.0](https://github.com/chio-labs/sqlbuild/compare/v0.12.0...v0.13.0) (2026-05-16)
+
+
+### Features
+
+* add Dagster asset loader ([6cf6e29](https://github.com/chio-labs/sqlbuild/commit/6cf6e29cb5c4887f2fa7e82bee60bd34768fc0e6))
+* add Dagster CLI resource ([c718d55](https://github.com/chio-labs/sqlbuild/commit/c718d55a706e2e205722e548ec3ee5a9346d4019))
+* add Dagster playground template ([718e77d](https://github.com/chio-labs/sqlbuild/commit/718e77d2cbc14d6760b7af5dac50d1249ef234db))
+* add Dagster project preparation ([df92013](https://github.com/chio-labs/sqlbuild/commit/df9201367a8359fd838c12f142941d4e7a3c11b2))
+* add Dagster scenario checks helper ([75473bd](https://github.com/chio-labs/sqlbuild/commit/75473bd36455132be1df12d25a737aa112c9e10a))
+* add static DAG JSON output ([1c8f497](https://github.com/chio-labs/sqlbuild/commit/1c8f49752bd72719ab3b5ff4e9c02b28fbcc1d1b))
+* bridge Dagster asset selections ([2e60398](https://github.com/chio-labs/sqlbuild/commit/2e603981c9ffc2aeab241645080fbbe41d68c3d3))
+* emit Dagster events from execution JSON ([4e5e1b6](https://github.com/chio-labs/sqlbuild/commit/4e5e1b62898a32a9a3d060f5b6f3aca38587ad8b))
+* select Dagster scenarios from assets ([6f584c8](https://github.com/chio-labs/sqlbuild/commit/6f584c83702689d90931006ba1bae19a5b2b1407))
+* stream SQLBuild output in Dagster ([b603449](https://github.com/chio-labs/sqlbuild/commit/b60344921fb88fb780239dc55aaf0d160b30a5f7))
+* tag SQLBuild Dagster asset kinds ([342bb61](https://github.com/chio-labs/sqlbuild/commit/342bb613dc022dd92f242a6035b1d2918ffd4926))
+
+
+### Bug Fixes
+
+* group Dagster assets by SQLBuild project ([00c324f](https://github.com/chio-labs/sqlbuild/commit/00c324fa7feced8ae78c4fca98e89a2bfff8eccc))
+* improve Dagster demo and logging ([e120222](https://github.com/chio-labs/sqlbuild/commit/e12022213990de3c4fdf45708a0dfda8d8ddf157))
+
 ## [0.12.0](https://github.com/chio-labs/sqlbuild/compare/v0.11.0...v0.12.0) (2026-05-15)
 
 

{sqlbuild-0.12.0 → sqlbuild-0.13.0}/Makefile

@@ -22,6 +22,10 @@ test-dbt:
 	uv run pytest tests/integration/src/sqlbuild/integrations/dbt tests/e2e/src/sqlbuild/cli/commands/main/dbt -m "dbt and not real_warehouse" -vv
 
 
+waffle-shop:
+	cd tests/e2e/fixtures/waffle_shop && $${SHELL:-/bin/sh}
+
+
 test-real:
 	uv run pytest tests -m real_warehouse -vv
 

{sqlbuild-0.12.0 → sqlbuild-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlbuild
-Version: 0.12.0
+Version: 0.13.0
 Summary: Typed, test-first SQL pipelines with local E2E testing
 License-File: LICENSE
 Requires-Python: >=3.12
@@ -9,6 +9,9 @@ Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: rich>=15.0.0
 Provides-Extra: bigquery
 Requires-Dist: google-cloud-bigquery>=3.37.0; extra == 'bigquery'
+Provides-Extra: dagster
+Requires-Dist: dagster-webserver>=1.13.0; extra == 'dagster'
+Requires-Dist: dagster>=1.13.0; extra == 'dagster'
 Provides-Extra: databricks
 Requires-Dist: databricks-sql-connector[pyarrow]>=4.1.2; extra == 'databricks'
 Provides-Extra: performance

{sqlbuild-0.12.0 → sqlbuild-0.13.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sqlbuild"
-version = "0.12.0"
+version = "0.13.0"
 description = "Typed, test-first SQL pipelines with local E2E testing"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -30,6 +30,10 @@ bigquery = [
 databricks = [
   "databricks-sql-connector[pyarrow]>=4.1.2",
 ]
+dagster = [
+  "dagster>=1.13.0",
+  "dagster-webserver>=1.13.0",
+]
 
 [project.scripts]
 sqb = "sqlbuild.cli.commands.main.entry:main"

{sqlbuild-0.12.0 → sqlbuild-0.13.0}/scripts/structure/structure_conventions/rules.py

@@ -143,6 +143,8 @@ def check_nested_runtime_package_direct_modules(
     relative_parts = file_path.resolve().relative_to(repo_root.resolve()).parts
     if len(relative_parts) < 5 or relative_parts[:2] != ("src", "sqlbuild"):
         return []
+    if _is_dagster_integration_public_module(relative_parts):
+        return []
     if file_path.name == "main.py" and (
         relative_parts[:3] == ("src", "sqlbuild", "integrations")
         or "shared" in relative_parts[2:-1]
@@ -333,6 +335,8 @@ def check_init_module(file_path: Path, module: ast.Module) -> list[Violation]:
 
     if file_path.name != "__init__.py":
         return []
+    if _is_dagster_integration_public_init(file_path):
+        return []
 
     if is_docstring_only_module(module):
         return []
@@ -1046,6 +1050,8 @@ def check_entry_module_shape(file_path: Path, module: ast.Module) -> list[Violat
 
     if not _is_entry_module(file_path):
         return []
+    if _is_dagster_integration_public_entry(file_path):
+        return []
 
     public_function_nodes = [
         node
@@ -1264,6 +1270,35 @@ def _is_direct_child_of_main_package(relative_parts: tuple[str, ...]) -> bool:
     )
 
 
+def _is_dagster_integration_public_module(relative_parts: tuple[str, ...]) -> bool:
+    return (
+        relative_parts[:4] == ("src", "sqlbuild", "integrations", "dagster")
+        and len(relative_parts) == 5
+        and relative_parts[-1] in {"assets.py", "translator.py", "project.py", "resource.py"}
+    )
+
+
+def _is_dagster_integration_public_init(file_path: Path) -> bool:
+    parts: tuple[str, ...] = file_path.parts
+    return len(parts) >= 5 and parts[-5:] == (
+        "src",
+        "sqlbuild",
+        "integrations",
+        "dagster",
+        "__init__.py",
+    )
+
+
+def _is_dagster_integration_public_entry(file_path: Path) -> bool:
+    parts: tuple[str, ...] = file_path.parts
+    return len(parts) >= 5 and parts[-5:-1] == (
+        "src",
+        "sqlbuild",
+        "integrations",
+        "dagster",
+    )
+
+
 def _subpackage_parts(repo_root: Path, file_path: Path) -> tuple[str, ...]:
     relative_parts = file_path.resolve().relative_to(repo_root.resolve()).with_suffix("").parts
 

{sqlbuild-0.12.0 → sqlbuild-0.13.0}/src/sqlbuild/cli/commands/main/audit.py

@@ -11,6 +11,10 @@ from sqlbuild.adapter.base.base_adapter import BaseAdapter
 from sqlbuild.cli.commands.main.shared.helpers.adapters import resolve_adapter
 from sqlbuild.cli.commands.main.shared.helpers.connection import resolve_project_connection_config
 from sqlbuild.cli.commands.main.shared.helpers.connection_progress import ConnectionProgressReporter
+from sqlbuild.cli.commands.main.shared.helpers.execution_json import (
+    format_audit_execution_json,
+    write_execution_json_output,
+)
 from sqlbuild.cli.commands.main.shared.helpers.external_refs import (
     resolve_external_sql_reference_resolver,
 )
@@ -37,6 +41,8 @@ def run_audit(
     select: tuple[str, ...] = (),
     exclude: tuple[str, ...] = (),
     cli_vars: dict[str, object] | None = None,
+    json_output: bool = False,
+    json_output_path: Path | None = None,
 ) -> int:
     """Execute the audit command."""
 
@@ -57,7 +63,7 @@ def run_audit(
         cli_vars=cli_vars,
     )
     use_color: bool = not no_color and supports_color()
-    progress_stream: TextIO = sys.stdout
+    progress_stream: TextIO = sys.stderr if json_output else sys.stdout
     execution_header: str = format_build_header(command="sqb audit", target=None, concurrency=1)
     execution_label: str = blue_bold("Execution") if use_color else "Execution"
     header_detail: str = dim(execution_header) if use_color else execution_header
@@ -110,8 +116,8 @@ def run_audit(
         stream=progress_stream,
         use_color=use_color,
     )
-    sys.stdout.write(f"\n{styled_header}\n\n")
-    sys.stdout.flush()
+    progress_stream.write(f"\n{styled_header}\n\n")
+    progress_stream.flush()
     execution_connection_progress: ConnectionProgressReporter = ConnectionProgressReporter(
         adapter_name=resolve_effective_adapter_name(
             project_config=discovered_inputs.project_config,
@@ -139,10 +145,15 @@ def run_audit(
     pass_count: int = sum(1 for r in results if r.outcome == AuditOutcome.PASS)
     warn_count: int = sum(1 for r in results if r.outcome == AuditOutcome.WARN)
     fail_count: int = sum(1 for r in results if r.outcome == AuditOutcome.ERROR)
-    sys.stdout.write(
+    progress_stream.write(
         f"\nPASS={pass_count}  WARN={warn_count}  FAIL={fail_count}  TOTAL={len(results)}\n"
     )
-    sys.stdout.flush()
+    progress_stream.flush()
+    write_execution_json_output(
+        payload=format_audit_execution_json(results=results),
+        json_output=json_output,
+        json_output_path=json_output_path,
+    )
 
     return 0 if fail_count == 0 else 1
 

{sqlbuild-0.12.0 → sqlbuild-0.13.0}/src/sqlbuild/cli/commands/main/build.py

@@ -13,6 +13,10 @@ from sqlbuild.cli.commands.main.shared.helpers.connection import resolve_project
 from sqlbuild.cli.commands.main.shared.helpers.connection_progress import (
     ConnectionProgressReporter,
 )
+from sqlbuild.cli.commands.main.shared.helpers.execution_json import (
+    format_build_execution_json,
+    write_execution_json_output,
+)
 from sqlbuild.cli.commands.main.shared.helpers.external_refs import (
     resolve_external_sql_reference_resolver,
 )
@@ -50,6 +54,8 @@ def run_build(
     verbose: bool = False,
     debug: bool = False,
     cli_vars: dict[str, object] | None = None,
+    json_output: bool = False,
+    json_output_path: Path | None = None,
 ) -> int:
     """Execute the build command."""
 
@@ -71,7 +77,7 @@ def run_build(
         cli_vars=cli_vars,
     )
     use_color: bool = not no_color and supports_color()
-    progress_stream: TextIO = sys.stderr if debug else sys.stdout
+    progress_stream: TextIO = sys.stderr if debug or json_output else sys.stdout
     connection_progress: ConnectionProgressReporter = ConnectionProgressReporter(
         adapter_name=adapter_name,
         stream=progress_stream,
@@ -111,7 +117,7 @@ def run_build(
     )
 
     plan_output: PlanOutput = pipeline_result.plan_output
-    plan_stream: TextIO = sys.stderr if debug else sys.stdout
+    plan_stream: TextIO = sys.stderr if debug or json_output else sys.stdout
 
     plan_text: str = format_plan(plan_output, full_refresh=full_refresh, use_color=use_color)
     plan_stream.write("\n" + plan_text + "\n\n")
@@ -125,7 +131,7 @@ def run_build(
     )
 
     callbacks: BuildProgressCallbacks = BuildProgressCallbacks(
-        plan=plan_output, use_color=use_color, verbose=verbose, debug=debug
+        plan=plan_output, use_color=use_color, verbose=verbose, debug=debug or json_output
     )
     effective_concurrency: int = (
         concurrency if concurrency is not None else pipeline_result.project.settings.concurrency
@@ -165,5 +171,10 @@ def run_build(
     footer: str = format_build_footer(result=result, elapsed=callbacks.elapsed, use_color=use_color)
     progress_stream.write("\n" + footer + "\n")
     progress_stream.flush()
+    write_execution_json_output(
+        payload=format_build_execution_json(result=result, plan=plan_output),
+        json_output=json_output,
+        json_output_path=json_output_path,
+    )
 
     return 0 if result.status == BuildStatus.SUCCESS else 1

{sqlbuild-0.12.0 → sqlbuild-0.13.0}/src/sqlbuild/cli/commands/main/compile.py

@@ -9,6 +9,7 @@ from sqlbuild.adapter.base.base_adapter import BaseAdapter
 from sqlbuild.cli.commands.main.helpers.compile.constants import (
     RICH_LINEAGE_STATUS_MODEL_THRESHOLD,
 )
+from sqlbuild.cli.commands.main.helpers.compile.dag import resolve_compile_dag_path
 from sqlbuild.cli.commands.main.helpers.compile.models import WrittenTarget
 from sqlbuild.cli.commands.main.helpers.compile.output import (
     format_compile_json,
@@ -22,6 +23,7 @@ from sqlbuild.compiler.compile.main.load_macros import load_macros
 from sqlbuild.compiler.compile.models.core import LoadedMacro
 from sqlbuild.compiler.contracts.main.validate import validate_model_contracts
 from sqlbuild.compiler.contracts.models import ContractValidationResult
+from sqlbuild.compiler.dag.main.build import build_dag_json
 from sqlbuild.compiler.diagnostics.models import CompilerDiagnostic
 from sqlbuild.compiler.discovery.main.discover import discover_project_inputs
 from sqlbuild.compiler.discovery.models import DiscoveredProjectInputs
@@ -41,6 +43,7 @@ def run_compile(
     defer_to: str | None = None,
     json_output: bool = False,
     manifest: bool = False,
+    dag_path: str | None = None,
     no_color: bool = False,
     lineage_mode: CompileLineageMode = CompileLineageMode.FAST,
     cli_vars: dict[str, object] | None = None,
@@ -101,6 +104,19 @@ def run_compile(
             upstream_deps=graph.upstream_deps,
             downstream_deps=graph.downstream_deps,
         )
+    if dag_path is not None:
+        resolved_dag_path: Path = resolve_compile_dag_path(
+            project_dir=effective_project_dir,
+            dag_path=dag_path,
+        )
+        resolved_dag_path.parent.mkdir(parents=True, exist_ok=True)
+        resolved_dag_path.write_text(
+            build_dag_json(
+                graph=graph,
+                project_name=discovered_inputs.project_config.name,
+            ),
+            encoding="utf-8",
+        )
 
     write_start: float = time.monotonic()
     written: WrittenTarget = write_static_compile_target(

sqlbuild-0.13.0/src/sqlbuild/cli/commands/main/dag.py

@@ -0,0 +1,60 @@
+"""CLI dag command entry point."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from sqlbuild.adapter.base.base_adapter import BaseAdapter
+from sqlbuild.cli.commands.main.shared.helpers.adapters import resolve_adapter
+from sqlbuild.cli.commands.main.shared.helpers.external_refs import (
+    resolve_external_sql_reference_resolver,
+)
+from sqlbuild.compiler.dag.main.build import build_dag_json
+from sqlbuild.compiler.discovery.main.discover import discover_project_inputs
+from sqlbuild.compiler.discovery.models import DiscoveredProjectInputs
+from sqlbuild.compiler.pipeline.main.graph import build_project_graph
+from sqlbuild.compiler.pipeline.models import ProjectGraph
+from sqlbuild.spec.models.project import resolve_effective_adapter_name
+
+
+def run_dag(
+    project_dir: Path | None,
+    no_sql_validation: bool = False,
+    json_output: bool = False,
+    cli_vars: dict[str, object] | None = None,
+) -> int:
+    """Execute the dag command."""
+
+    effective_project_dir: Path = project_dir if project_dir is not None else Path.cwd()
+    discovered_inputs: DiscoveredProjectInputs = discover_project_inputs(
+        project_dir=effective_project_dir
+    )
+    adapter: BaseAdapter = resolve_adapter(
+        resolve_effective_adapter_name(
+            project_config=discovered_inputs.project_config,
+            local_config=discovered_inputs.local_config,
+        ),
+        project_dir=effective_project_dir,
+    )
+    graph: ProjectGraph = build_project_graph(
+        discovered_inputs=discovered_inputs,
+        adapter=adapter,
+        no_sql_validation=no_sql_validation,
+        cli_vars=cli_vars,
+        external_sql_reference_resolver=resolve_external_sql_reference_resolver(
+            project_dir=effective_project_dir,
+            discovered_inputs=discovered_inputs,
+        ),
+    )
+    dag_json: str = build_dag_json(graph=graph, project_name=discovered_inputs.project_config.name)
+    if json_output:
+        print(dag_json)
+    else:
+        payload: dict[str, object] = json.loads(dag_json)
+        print(
+            "DAG ready "
+            f"({len(payload['nodes'])} nodes, {len(payload['edges'])} edges, "
+            f"{len(payload['checks'])} checks)"
+        )
+    return 0

{sqlbuild-0.12.0 → sqlbuild-0.13.0}/src/sqlbuild/cli/commands/main/entry.py

@@ -19,14 +19,17 @@ from sqlbuild.cli.commands.main.helpers.entry.errors import (
 )
 from sqlbuild.cli.commands.main.helpers.entry.models import CliEntrypointHandlers, CliNamespace
 from sqlbuild.cli.commands.main.helpers.lineage.constants import COLUMN_LINEAGE_MODE_VALUES
+from sqlbuild.cli.commands.main.helpers.playground.constants import PLAYGROUND_TEMPLATE_VALUES
 from sqlbuild.cli.commands.main.shared.exceptions import CliUserError
 from sqlbuild.cli.commands.main.shared.helpers.parsers import (
     add_cursor_override_args,
     add_dbt_config_args,
     add_execution_args,
+    add_execution_json_output_arg,
     add_scenario_snapshot_safety_args,
     add_select_args,
     add_vars_args,
+    read_selector_files,
 )
 from sqlbuild.cli.commands.main.shared.types import CliCommand
 from sqlbuild.compiler.discovery.exceptions import DiscoveryError
@@ -60,6 +63,7 @@ def _build_parser(*, use_color: bool = False) -> argparse.ArgumentParser:
     compile_parser.add_argument("--defer-to", default=None)
     compile_parser.add_argument("--json", action="store_true", default=False)
     compile_parser.add_argument("--manifest", action="store_true", default=False)
+    compile_parser.add_argument("--dag", nargs="?", const="", default=None)
     compile_parser.add_argument(
         "--lineage-mode",
         dest="compile_lineage_mode",
@@ -70,6 +74,12 @@ def _build_parser(*, use_color: bool = False) -> argparse.ArgumentParser:
     add_vars_args(compile_parser)
     add_dbt_config_args(compile_parser)
 
+    dag_parser: argparse.ArgumentParser = subparsers.add_parser(CliCommand.DAG)
+    dag_parser.add_argument("--no-sql-validation", action="store_true", default=False)
+    dag_parser.add_argument("--json", action="store_true", default=False)
+    add_vars_args(dag_parser)
+    add_dbt_config_args(dag_parser)
+
     plan_parser: argparse.ArgumentParser = subparsers.add_parser(CliCommand.PLAN)
     plan_parser.add_argument("--no-sql-validation", action="store_true", default=False)
     plan_parser.add_argument("--defer-to", default=None)
@@ -84,6 +94,8 @@ def _build_parser(*, use_color: bool = False) -> argparse.ArgumentParser:
     build_parser: argparse.ArgumentParser = subparsers.add_parser(CliCommand.BUILD)
     build_parser.add_argument("--no-sql-validation", action="store_true", default=False)
     build_parser.add_argument("--defer-to", default=None)
+    build_parser.add_argument("--json", action="store_true", default=False)
+    add_execution_json_output_arg(build_parser)
     add_cursor_override_args(build_parser)
     add_execution_args(build_parser)
     add_select_args(build_parser)
@@ -93,6 +105,8 @@ def _build_parser(*, use_color: bool = False) -> argparse.ArgumentParser:
     run_parser: argparse.ArgumentParser = subparsers.add_parser(CliCommand.RUN)
     run_parser.add_argument("--no-sql-validation", action="store_true", default=False)
     run_parser.add_argument("--defer-to", default=None)
+    run_parser.add_argument("--json", action="store_true", default=False)
+    add_execution_json_output_arg(run_parser)
     add_cursor_override_args(run_parser)
     add_execution_args(run_parser)
     add_select_args(run_parser)
@@ -101,6 +115,8 @@ def _build_parser(*, use_color: bool = False) -> argparse.ArgumentParser:
 
     test_parser: argparse.ArgumentParser = subparsers.add_parser(CliCommand.TEST)
     test_parser.add_argument("--no-sql-validation", action="store_true", default=False)
+    test_parser.add_argument("--json", action="store_true", default=False)
+    add_execution_json_output_arg(test_parser)
     add_select_args(test_parser)
     add_vars_args(test_parser)
     add_dbt_config_args(test_parser)
@@ -108,11 +124,15 @@ def _build_parser(*, use_color: bool = False) -> argparse.ArgumentParser:
     audit_parser: argparse.ArgumentParser = subparsers.add_parser(CliCommand.AUDIT)
     audit_parser.add_argument("--no-sql-validation", action="store_true", default=False)
     audit_parser.add_argument("--defer-to", default=None)
+    audit_parser.add_argument("--json", action="store_true", default=False)
+    add_execution_json_output_arg(audit_parser)
     add_select_args(audit_parser)
     add_vars_args(audit_parser)
     add_dbt_config_args(audit_parser)
 
     seed_parser: argparse.ArgumentParser = subparsers.add_parser(CliCommand.SEED)
+    seed_parser.add_argument("--json", action="store_true", default=False)
+    add_execution_json_output_arg(seed_parser)
     add_select_args(seed_parser)
     add_vars_args(seed_parser)
 
@@ -188,6 +208,12 @@ def _build_parser(*, use_color: bool = False) -> argparse.ArgumentParser:
         default="sqlbuild-playground",
         metavar="path",
     )
+    playground_parser.add_argument(
+        "--template",
+        dest="playground_template",
+        choices=PLAYGROUND_TEMPLATE_VALUES,
+        default="waffle_shop",
+    )
     scenario_parser: argparse.ArgumentParser = subparsers.add_parser(CliCommand.SCENARIO)
     scenario_subparsers: argparse._SubParsersAction[argparse.ArgumentParser]
     scenario_subparsers = scenario_parser.add_subparsers(dest="scenario_command")
@@ -196,6 +222,8 @@ def _build_parser(*, use_color: bool = False) -> argparse.ArgumentParser:
     scenario_test_parser.add_argument("--retain", dest="scenario_retain", action="store_true")
     scenario_test_parser.add_argument("--local", dest="scenario_local", action="store_true")
     scenario_test_parser.add_argument("--strict", dest="scenario_strict", action="store_true")
+    scenario_test_parser.add_argument("--json", action="store_true", default=False)
+    add_execution_json_output_arg(scenario_test_parser)
     scenario_snapshot_group: argparse._MutuallyExclusiveGroup = (
         scenario_test_parser.add_mutually_exclusive_group()
     )
@@ -239,6 +267,7 @@ def main(argv: Sequence[str] | None = None) -> int:
     from sqlbuild.cli.commands.main.build import run_build
     from sqlbuild.cli.commands.main.clone import run_clone
     from sqlbuild.cli.commands.main.compile import run_compile
+    from sqlbuild.cli.commands.main.dag import run_dag
     from sqlbuild.cli.commands.main.dbt import run_dbt_command
     from sqlbuild.cli.commands.main.debug import run_debug
     from sqlbuild.cli.commands.main.diff import run_diff
@@ -256,6 +285,7 @@ def main(argv: Sequence[str] | None = None) -> int:
 
     handlers: CliEntrypointHandlers = CliEntrypointHandlers(
         run_compile=run_compile,
+        run_dag=run_dag,
         run_plan=run_plan,
         run_dbt_plan=lambda project_dir, args, no_color: run_dbt_command(
             command=DbtInteropCommand.PLAN,
@@ -346,6 +376,7 @@ def _main_with_dependencies(
             logging.getLogger("sqlbuild.cli").debug(
                 "command=%s project_dir=%s", args.command, effective_project_dir
             )
+        select: tuple[str, ...] = (*tuple(args.select), *read_selector_files(args.select_file))
         if args.command == CliCommand.COMPILE:
             return handlers.run_compile(
                 project_dir,
@@ -353,10 +384,18 @@ def _main_with_dependencies(
                 args.defer_to,
                 args.json,
                 args.manifest,
+                args.dag,
                 args.no_color,
                 CompileLineageMode(args.compile_lineage_mode),
                 args.vars,
             )
+        if args.command == CliCommand.DAG:
+            return handlers.run_dag(
+                project_dir,
+                args.no_sql_validation,
+                args.json,
+                args.vars,
+            )
         if args.command == CliCommand.PLAN:
             cursor_overrides: CursorOverrides = CursorOverrides(
                 start_ts=args.start_cursor_ts,
@@ -372,7 +411,7 @@ def _main_with_dependencies(
                 args.json,
                 args.full_refresh,
                 args.no_color,
-                tuple(args.select),
+                select,
                 tuple(args.exclude),
                 args.verbose,
                 args.vars,
@@ -405,11 +444,13 @@ def _main_with_dependencies(
                 args.fail_fast,
                 args.full_refresh,
                 args.concurrency,
-                tuple(args.select),
+                select,
                 tuple(args.exclude),
                 args.verbose,
                 args.debug,
                 args.vars,
+                args.json,
+                args.json_output,
             )
         if args.command == CliCommand.RUN:
             cursor_overrides = CursorOverrides(
@@ -427,20 +468,24 @@ def _main_with_dependencies(
                 args.fail_fast,
                 args.full_refresh,
                 args.concurrency,
-                tuple(args.select),
+                select,
                 tuple(args.exclude),
                 args.verbose,
                 args.debug,
                 args.vars,
+                args.json,
+                args.json_output,
             )
         if args.command == CliCommand.TEST:
             return handlers.run_test(
                 project_dir,
                 args.no_sql_validation,
                 args.no_color,
-                tuple(args.select),
+                select,
                 tuple(args.exclude),
                 args.vars,
+                args.json,
+                args.json_output,
             )
         if args.command == CliCommand.AUDIT:
             return handlers.run_audit(
@@ -448,17 +493,21 @@ def _main_with_dependencies(
                 args.no_sql_validation,
                 args.defer_to,
                 args.no_color,
-                tuple(args.select),
+                select,
                 tuple(args.exclude),
                 args.vars,
+                args.json,
+                args.json_output,
             )
         if args.command == CliCommand.SEED:
             return handlers.run_seed(
                 project_dir,
                 args.no_color,
-                tuple(args.select),
+                select,
                 tuple(args.exclude),
                 args.vars,
+                args.json,
+                args.json_output,
             )
         if args.command == CliCommand.LINEAGE:
             return handlers.run_lineage(
@@ -468,7 +517,7 @@ def _main_with_dependencies(
                 args.lineage_format,
                 args.lineage_direction,
                 args.lineage_depth,
-                tuple(args.select),
+                select,
                 tuple(args.exclude),
                 ColumnLineageMode(args.lineage_mode),
                 args.vars,
@@ -483,7 +532,7 @@ def _main_with_dependencies(
                 args.from_environment,
                 args.to_environment,
                 args.hard_copy,
-                tuple(args.select),
+                select,
                 tuple(args.exclude),
                 args.vars,
             )
@@ -502,7 +551,7 @@ def _main_with_dependencies(
                 args.bounded,
                 args.max_column_examples,
                 args.max_row_only_examples,
-                tuple(args.select),
+                select,
                 tuple(args.exclude),
                 args.verbose,
                 args.vars,
@@ -530,7 +579,9 @@ def _main_with_dependencies(
                 args.retention_days,
             )
         if args.command == CliCommand.PLAYGROUND:
-            return handlers.run_playground(project_dir, args.playground_path)
+            return handlers.run_playground(
+                project_dir, args.playground_path, args.playground_template
+            )
         if args.command == CliCommand.SKILLS:
             if args.skills_command == "update":
                 return handlers.run_skills_update(
@@ -577,6 +628,8 @@ def _main_with_dependencies(
                     args.scenario_max_snapshot_total_rows,
                     args.scenario_max_snapshot_bytes,
                     args.scenario_max_snapshot_total_bytes,
+                    args.json,
+                    args.json_output,
                 )
             if args.scenario_command == "capture":
                 return handlers.run_scenario_capture(

sqlbuild-0.13.0/src/sqlbuild/cli/commands/main/helpers/compile/dag.py

@@ -0,0 +1,16 @@
+"""Compile command DAG artifact helpers."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+
+def resolve_compile_dag_path(*, project_dir: Path, dag_path: str) -> Path:
+    """Resolve the optional compile DAG artifact path."""
+
+    if dag_path == "":
+        return project_dir / "target" / "sqlbuild_dag.json"
+    path: Path = Path(dag_path)
+    if path.is_absolute():
+        return path
+    return project_dir / path