dataface 0.1.6.dev975__py3-none-any.whl → 0.1.6.dev1010__py3-none-any.whl

dataface/agent_api/describe.py

@@ -14,7 +14,6 @@ from dataface.core.compile.models.face.normalized import Layout
 from dataface.core.compile.models.query.normalized import (
     DbtModelQuery,
     HttpQuery,
-    MetricFlowQuery,
     Query,
     SqlQuery,
     ValuesQuery,
@@ -135,10 +134,6 @@ def _build_query_description(name: str, query: Query) -> QueryDescription:
             return QueryDescription(
                 name=name, type="http", summary=f"HTTP request: {query.url}"
             )
-        case MetricFlowQuery():
-            return QueryDescription(
-                name=name, type="metricflow", summary="MetricFlow query"
-            )
         case ValuesQuery():
             return QueryDescription(name=name, type="values", summary="Inline values")
         case _:

dataface/agent_api/docs/yaml-reference.md

@@ -40,7 +40,7 @@ Sources section for faces.
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
 | `default` | str | ✓ | Default source name used for all queries that don't specify a source. |
-| `<name>` | [PostgresSourceConfig](#postgressourceconfig) \| [SnowflakeSourceConfig](#snowflakesourceconfig) \| [BigQuerySourceConfig](#bigquerysourceconfig) \| [RedshiftSourceConfig](#redshiftsourceconfig) \| [MySQLSourceConfig](#mysqlsourceconfig) \| [DuckDBSourceConfig](#duckdbsourceconfig) \| [SQLiteSourceConfig](#sqlitesourceconfig) \| [CsvSourceConfig](#csvsourceconfig) \| [ParquetSourceConfig](#parquetsourceconfig) \| [JsonSourceConfig](#jsonsourceconfig) \| [HttpSourceConfig](#httpsourceconfig) \| [DbtProfileSourceConfig](#dbtprofilesourceconfig) \| [LookMLSourceConfig](#lookmlsourceconfig) | ✓ | Additional named entry. |
+| `<name>` | [PostgresSourceConfig](#postgressourceconfig) \| [SnowflakeSourceConfig](#snowflakesourceconfig) \| [BigQuerySourceConfig](#bigquerysourceconfig) \| [RedshiftSourceConfig](#redshiftsourceconfig) \| [MySQLSourceConfig](#mysqlsourceconfig) \| [DuckDBSourceConfig](#duckdbsourceconfig) \| [SQLiteSourceConfig](#sqlitesourceconfig) \| [CsvSourceConfig](#csvsourceconfig) \| [ParquetSourceConfig](#parquetsourceconfig) \| [JsonSourceConfig](#jsonsourceconfig) \| [HttpSourceConfig](#httpsourceconfig) \| [DbtProfileSourceConfig](#dbtprofilesourceconfig) | ✓ | Additional named entry. |
 
 <a id="variable"></a>
 ## Variable
@@ -114,6 +114,7 @@ Authored patch for bar and histogram charts.
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
 | `query` | str \| [Query](#query) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
+| `model` | str | ✓ | Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`. |
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
@@ -141,6 +142,7 @@ Authored patch for line charts.
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
 | `query` | str \| [Query](#query) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
+| `model` | str | ✓ | Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`. |
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
@@ -168,6 +170,7 @@ Authored patch for area charts.
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
 | `query` | str \| [Query](#query) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
+| `model` | str | ✓ | Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`. |
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
@@ -195,6 +198,7 @@ Authored patch for scatter charts.
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
 | `query` | str \| [Query](#query) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
+| `model` | str | ✓ | Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`. |
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
@@ -224,6 +228,7 @@ Authored patch for heatmap charts.
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
 | `query` | str \| [Query](#query) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
+| `model` | str | ✓ | Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`. |
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
@@ -252,6 +257,7 @@ Authored patch for pie and donut charts.
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
 | `query` | str \| [Query](#query) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
+| `model` | str | ✓ | Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`. |
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
@@ -273,6 +279,7 @@ Authored patch for KPI (key performance indicator) charts.
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
 | `query` | str \| [Query](#query) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
+| `model` | str | ✓ | Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`. |
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `label` | str | ✓ | KPI label rendered above the headline value. |
@@ -292,6 +299,7 @@ Authored patch for table charts.
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
 | `query` | str \| [Query](#query) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
+| `model` | str | ✓ | Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`. |
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
@@ -312,6 +320,7 @@ Authored patch for point_map and bubble_map charts.
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
 | `query` | str \| [Query](#query) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
+| `model` | str | ✓ | Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`. |
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
@@ -339,6 +348,7 @@ Authored patch for map and geoshape charts.
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
 | `query` | str \| [Query](#query) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
+| `model` | str | ✓ | Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`. |
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
@@ -365,6 +375,7 @@ Authored patch for layered multi-mark charts.
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
 | `query` | str \| [Query](#query) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
+| `model` | str | ✓ | Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`. |
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
@@ -399,6 +410,7 @@ Authored patch for spark_bar charts (compact horizontal bars).
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
 | `query` | str \| [Query](#query) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
+| `model` | str | ✓ | Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`. |
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
@@ -2613,6 +2625,8 @@ Postgres source configuration.
 | `dbname` | str |  | Database name (matches dbt 'dbname'). |
 | `user` | str |  | Database user name. |
 | `password` | str |  | Database password. |
+| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
+| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `port` | int | ✓ | Database port number. |
 | `schema` | str | ✓ | Default schema for queries. |
 | `sslmode` | enum: "disable", "allow", "prefer", "require", "verify-ca", "verify-full" | ✓ | libpq SSL mode forwarded to psycopg2. None lets libpq decide its default. |
@@ -2628,6 +2642,8 @@ Snowflake source configuration.
 | `user` | str |  | Snowflake user name. |
 | `database` | str |  | Snowflake database name. |
 | `warehouse` | str |  | Snowflake virtual warehouse name. |
+| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
+| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `password` | str | ✓ | Snowflake password. Omit when using OAuth or key-pair auth. |
 | `schema` | str | ✓ | Default schema for queries. |
 | `role` | str | ✓ | Snowflake role to assume for the session. |
@@ -2641,6 +2657,8 @@ BigQuery source configuration.
 | `type` | enum: "bigquery" |  | Source type identifier. |
 | `project` | str |  | GCP project ID. |
 | `dataset` | str |  | BigQuery dataset name (equivalent to schema). |
+| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
+| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `keyfile` | str | ✓ | Path to service account JSON key file. |
 | `keyfile_json` | dict[str, Any] | ✓ | Inline service account JSON dict. |
 | `location` | str | ✓ | Dataset location (e.g. US, EU). |
@@ -2657,6 +2675,8 @@ Redshift source configuration.
 | `dbname` | str |  | Redshift database name. |
 | `user` | str |  | Redshift user name. |
 | `password` | str |  | Redshift password. |
+| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
+| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `port` | int | ✓ | Redshift port number. |
 | `schema` | str | ✓ | Default schema for queries. |
 
@@ -2671,6 +2691,8 @@ MySQL source configuration.
 | `database` | str |  | MySQL database name. |
 | `user` | str |  | MySQL user name. |
 | `password` | str |  | MySQL password. |
+| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
+| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `port` | int | ✓ | MySQL port number. |
 | `schema` | str | ✓ | Default schema for queries. |
 
@@ -2681,6 +2703,8 @@ DuckDB source configuration.
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
 | `type` | enum: "duckdb" |  | Source type identifier. |
+| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
+| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `path` | str | ✓ | DuckDB file path or ':memory:' for an in-memory database. |
 | `schema` | str | ✓ | Default schema for unqualified table names (sets search_path). |
 
@@ -2688,10 +2712,12 @@ DuckDB source configuration.
 ## SQLiteSourceConfig
 SQLite source configuration.
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `type` | enum: "sqlite" | Source type identifier. |
-| `path` | str | Path to the SQLite database file. |
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `type` | enum: "sqlite" |  | Source type identifier. |
+| `path` | str |  | Path to the SQLite database file. |
+| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
+| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 
 <a id="csvsourceconfig"></a>
 ## CsvSourceConfig
@@ -2743,16 +2769,6 @@ Reference to a dbt profile.
 | `target` | str | ✓ | dbt target to use; defaults to the profile's default target. |
 | `profiles_dir` | str | ✓ | Directory containing profiles.yml, relative to the dataface project root. Use when profiles.yml is in a subdirectory (e.g. services/dbt). Resolution order: profiles_dir → $DBT_PROFILES_DIR → project root → ~/.dbt. |
 
-<a id="lookmlsourceconfig"></a>
-## LookMLSourceConfig
-Reference to a directory of LookML (.lkml) model files.
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `type` | enum: "lookml" | Source type identifier. |
-| `path` | str | Relative path to the directory of .lkml files, relative to the project root. |
-| `base_source` | str | Name of an existing Dataface warehouse source to execute compiled queries against. |
-
 <a id="variableref"></a>
 ## VariableRef
 Cross-file variable reference. Bare string is coerced automatically.
@@ -2776,3 +2792,13 @@ Cross-file chart reference. Bare string is coerced automatically.
 | Field | Type | Description |
 |-------|------|-------------|
 | `ref` | str | Reference path: '&lt;file&gt;.charts.&lt;name&gt;'. A bare string value is coerced automatically. |
+
+<a id="lookmlmodelconfig"></a>
+## LookMLModelConfig
+One LookML model: a named collection of explores under a warehouse source.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `lkml` | str | ✓ | Path to a specific .lkml model file, relative to the project root. |
+| `group_label` | str | ✓ | LookML group_label selecting this model's explores. Not yet enforced at compile time. |
+| `explores` | list[str] | ✓ | Explicit list of explore names in this model. |

dataface/cli/_error_format.py

@@ -17,7 +17,11 @@ from typing import Literal
 from rich.panel import Panel
 
 from dataface.cli._console import dft_console
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.errors import StructuredError
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.warnings.base import RenderWarning
 
 

dataface/cli/commands/_agent_server.py

@@ -21,6 +21,7 @@ from dataclasses import dataclass
 
 import uvicorn
 
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.serve.embedded import build_embedded_server
 
 # Seconds to wait for uvicorn to flip ``started``. A real bind failure surfaces

dataface/cli/commands/init.py

@@ -9,6 +9,8 @@ from pathlib import Path
 import typer
 
 from dataface.agent_api.init import init_project
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.project_roots import find_dft_root, find_repo_root
 
 

dataface/cli/commands/mcp_init.py

@@ -10,6 +10,8 @@ from pathlib import Path
 import typer
 
 from dataface.agent_api import mcp_install
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.project_roots import (
     DFT_ROOT_MARKERS,
     find_dft_root,

dataface/cli/commands/render.py

@@ -14,11 +14,23 @@ from dataface.agent_api._paths import (
 from dataface.agent_api.cache import cache_ctx
 from dataface.agent_api.dashboards import RenderedDashboard
 from dataface.cli._error_format import print_structured_errors
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.dashboard import RenderFormat
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.errors import StructuredError
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.render.warnings import registry as _warnings_registry
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.warnings import unreferenced_chart
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.warnings.base import RenderWarning
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.warnings.from_query_diagnostic import KNOWN_RENDER_CODES
 
 # Compile-time warning producers don't live on detector modules in the registry,

dataface/cli/commands/schema.py

@@ -33,6 +33,8 @@ from dataface.agent_api.schema import SchemaResponse, is_exact_target
 from dataface.agent_api.schema_search import SchemaSearchResult
 from dataface.cli._error_format import print_structured_errors
 from dataface.cli._parsing import parse_kv_pairs
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.errors import DF_UNKNOWN_INTERNAL, StructuredError
 
 

dataface/cli/commands/serve.py

@@ -8,7 +8,11 @@ import typer
 import uvicorn
 
 from dataface.cli._error_format import print_structured_errors
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.errors import DF_SERVE_STARTUP_FAILED
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.errors.base import DatafaceError
 
 
@@ -56,11 +60,22 @@ def serve_command(
     Returns:
         None (exits with code 0 on success, 1 on errors)
     """
+    # tach-ignore(cli->core debt: route via agent_api; burn-down task)
     from dataface.core.compile.config import list_built_in_themes, load_config
+
+    # tach-ignore(cli->core debt: route via agent_api; burn-down task)
     from dataface.core.errors import DF_SERVE_INVALID_DEFAULT_THEME
+
+    # tach-ignore(cli->core debt: route via agent_api; burn-down task)
     from dataface.core.project import Project
+
+    # tach-ignore(cli->core debt: route via agent_api; burn-down task)
     from dataface.core.project_roots import find_dft_root, infer_dialect_from_dbt
+
+    # tach-ignore(cli->core debt: route via agent_api; burn-down task)
     from dataface.core.serve.port import resolve_port
+
+    # tach-ignore(cli->core debt: route via agent_api; burn-down task)
     from dataface.core.serve.server import create_server
 
     # Resolve the project root: --project-dir if given, else discover from cwd.

dataface/cli/commands/skills_init.py

@@ -7,6 +7,8 @@ from pathlib import Path
 import typer
 
 from dataface.agent_api import skill_install
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.project_roots import find_dft_root, find_repo_root
 
 _VALID_TARGETS = skill_install.SKILL_INSTALL_TARGETS

dataface/cli/main.py

@@ -33,7 +33,11 @@ from dataface.cli.commands import (
 )
 from dataface.cli.commands.mcp_init import run_init as _mcp_run_init
 from dataface.cli.commands.skills_init import run_init_skills as _skills_run_init
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.dashboard import RenderFormat
+
+# tach-ignore(cli->core debt: route via agent_api; burn-down task)
 from dataface.core.project_roots import find_dft_root
 
 # Evaluated once at process startup — mid-session env changes won't take effect.
@@ -615,6 +619,7 @@ def mcp_serve(
       }
     """
     try:
+        # tach-ignore(cli->ai debt: migrate lazy `dft mcp serve` import to dataface.cli._extras; burn-down task)
         from dataface.ai.mcp import run_server
     except ImportError as e:
         typer.echo("MCP server requires additional dependencies.", err=True)

dataface/core/compile/__init__.py

@@ -90,11 +90,9 @@ from dataface.core.compile.models.query.normalized import (
     AnyQuery,
     DbtModelQuery,
     HttpQuery,
-    MetricFlowQuery,
     SqlQuery,
     is_dbt_model_query,
     is_http_query,
-    is_metricflow_query,
     is_sql_query,
 )
 from dataface.core.compile.models.source import (
@@ -105,7 +103,8 @@ from dataface.core.compile.models.source import (
     DuckDBSourceConfig,
     HttpSourceConfig,
     JsonSourceConfig,
-    LookMLSourceConfig,
+    LookMLModelConfig,
+    LookMLModelsMixin,
     MySQLSourceConfig,
     ParquetSourceConfig,
     PostgresSourceConfig,
@@ -173,7 +172,6 @@ __all__ = [
     "ChartDependencies",
     # Unified query types
     "SqlQuery",
-    "MetricFlowQuery",
     "HttpQuery",
     "DbtModelQuery",
     "VALID_QUERY_TYPES",
@@ -191,7 +189,8 @@ __all__ = [
     "JsonSourceConfig",
     "HttpSourceConfig",
     "DbtProfileSourceConfig",
-    "LookMLSourceConfig",
+    "LookMLModelConfig",
+    "LookMLModelsMixin",
     "VALID_SOURCE_TYPES",
     "parse_source_config",
     "is_database_source",
@@ -213,7 +212,6 @@ __all__ = [
     "is_face",
     "is_chart",
     "is_sql_query",
-    "is_metricflow_query",
     "is_http_query",
     "is_dbt_model_query",
     # Enums

dataface/core/compile/compiler.py

@@ -35,7 +35,7 @@ from dataclasses import dataclass, field
 from typing import TYPE_CHECKING, Any
 
 import yaml
-from pydantic import ValidationError as PydanticValidationError
+from pydantic import BaseModel, ValidationError as PydanticValidationError
 
 from dataface.core.compile.authoring_warnings import detect_authoring_warnings
 from dataface.core.compile.config import ProjectSourcesConfig
@@ -57,11 +57,16 @@ from dataface.core.compile.models.face.authored import (
     QueryOrRef,
 )
 from dataface.core.compile.models.face.normalized import Face
+from dataface.core.compile.models.query.authored import AuthoredQuery
 from dataface.core.compile.models.query.normalized import AnyQuery
 from dataface.core.compile.models.refs import ChartRef, QueryRef, VariableRef
 from dataface.core.compile.models.variable.authored import Variable
 from dataface.core.compile.normalize_charts import collect_lookml_channel_refs
-from dataface.core.compile.normalize_variables import VariableReferenceErrors
+from dataface.core.compile.normalize_queries import find_lookml_model_source
+from dataface.core.compile.normalize_variables import (
+    VariableReferenceErrors,
+    synthetic_query_name,
+)
 from dataface.core.compile.normalizer import normalize_face, normalize_query
 from dataface.core.compile.parser import (
     load_yaml_mapping,
@@ -200,23 +205,79 @@ def compile_authored_face(
     except CompilationError as e:
         return CompileResult(errors=[e.to_structured()])
 
+    # ════════════════════════════════════════════════════════════════════
+    # STEP 3b.5: Desugar chart-level `model: model.explore` sugar into a
+    # synthesized named lookml query, before Surface B channel collection
+    # (below) so the synthesized query is visible to that pass. Runs
+    # unconditionally (not gated on lookml_model_names) so an unknown/
+    # ambiguous `model:` name still raises a clear error.
+    # ════════════════════════════════════════════════════════════════════
+    try:
+        collectible_charts = dict(chart_registry)
+        _collect_inline_layout_charts(authored, collectible_charts)
+        if authored.queries is None:
+            authored.queries = {}
+        for _chart_key, _chart_def in collectible_charts.items():
+            # Use BaseModel (not _BaseChartFields) for dump so callout charts and
+            # other non-_BaseChartFields models are serialised to a dict first.
+            if isinstance(_chart_def, BaseModel):
+                _chart_dict = _chart_def.model_dump(exclude_none=True)
+            elif isinstance(_chart_def, dict):
+                _chart_dict = _chart_def
+            else:
+                continue
+            _model_value = _chart_dict.get("model")
+            if not _model_value:
+                continue
+            if _chart_dict.get("query") is not None:
+                raise CompilationError(
+                    f"chart '{_chart_key}' sets both `model:` and `query:` — "
+                    "`model:` is sugar for a query, so only one may be set."
+                )
+            _parts = _model_value.split(".")
+            if len(_parts) != 2 or not all(_parts):
+                raise CompilationError(
+                    f"chart '{_chart_key}' has `model: {_model_value!r}` — expected "
+                    "`model.explore` (a LookML model name and explore name "
+                    "joined by a dot)."
+                )
+            _model_name, _explore_name = _parts
+            if find_lookml_model_source(_model_name, sources_registry) is None:
+                raise CompilationError(
+                    f"chart '{_chart_key}' has `model: {_model_value}` naming "
+                    f"unknown model '{_model_name}' — no source declares it in its "
+                    "'models:' map."
+                )
+            _synth_name = synthetic_query_name("model_query", _chart_key)
+            authored.queries[_synth_name] = AuthoredQuery(
+                source=_model_name, explore=_explore_name
+            )
+            # Mutate in place: _BaseChartFields declares query + model; plain
+            # dicts use key assignment. Non-_BaseChartFields BaseModels (e.g.
+            # CalloutChart) have no `model:` field and are skipped above.
+            if isinstance(_chart_def, _BaseChartFields):
+                _chart_def.query = _synth_name
+                _chart_def.model = None
+            elif isinstance(_chart_def, dict):
+                _chart_def["query"] = _synth_name
+                _chart_def.pop("model", None)
+    except CompilationError as e:
+        return CompileResult(errors=[e.to_structured()])
+
     # ════════════════════════════════════════════════════════════════════
     # STEP 3c: Collect LookML dotted-ref chart channels into fields-less
     # lookml queries (Surface B), before query normalization lowers them.
     # ════════════════════════════════════════════════════════════════════
-    lookml_source_names = {
-        name
-        for name, cfg in sources_registry.items()
-        if isinstance(cfg, dict) and cfg.get("type") == "lookml"
-    }
-    if lookml_source_names:
+    lookml_model_names: set[str] = set()
+    for _cfg in sources_registry.values():
+        if isinstance(_cfg, dict) and isinstance(_cfg.get("models"), dict):
+            lookml_model_names.update(_cfg["models"].keys())
+    if lookml_model_names:
         try:
             raw_queries: dict[str, QueryOrRef] = {}
             _collect_raw_queries(authored, raw_queries)
-            collectible_charts = dict(chart_registry)
-            _collect_inline_layout_charts(authored, collectible_charts)
             collect_lookml_channel_refs(
-                collectible_charts, raw_queries, lookml_source_names
+                collectible_charts, raw_queries, lookml_model_names
             )
         except CompilationError as e:
             return CompileResult(errors=[e.to_structured()])
@@ -852,6 +913,7 @@ def _process_queries_for_registry(
                 query_def,
                 default_source=effective_default_source,
                 sources=sources,
+                base_dir=base_dir,
             )
 
 
@@ -1016,7 +1078,7 @@ def load_from_reference(
     item_def = section[item_name]
 
     if section_name == "queries":
-        return normalize_query(item_name, item_def)
+        return normalize_query(item_name, item_def, base_dir=base_dir)
     if section_name == "charts":
         return item_def
     # section_name == "variables"

dataface/core/compile/introspection.py

@@ -28,7 +28,7 @@ from dataface.core.compile.models.source import (
     DuckDBSourceConfig,
     HttpSourceConfig,
     JsonSourceConfig,
-    LookMLSourceConfig,
+    LookMLModelConfig,
     MySQLSourceConfig,
     ParquetSourceConfig,
     PostgresSourceConfig,
@@ -96,8 +96,9 @@ def _unwrap_annotated(annotation: Any) -> Any:
 def _is_authored_model(cls: Any) -> bool:
     """Return True if cls should be included in the IR.
 
-    Includes authored.* models, primitives, _PatchBase subclasses, and compiled
-    style models from style/theme/ (so inherit-chain metadata is introspectable).
+    Includes authored.* models, primitives, _PatchBase subclasses, compiled
+    style models from style/theme/, and LookMLModelConfig so
+    dict[str, LookMLModelConfig] fields emit additionalProperties refs in JSON Schema.
     """
     if not (isinstance(cls, type) and issubclass(cls, BaseModel)):
         return False
@@ -109,6 +110,7 @@ def _is_authored_model(cls: Any) -> bool:
         or module.endswith("primitives")
         or module.endswith("style.theme")
         or ".style.theme." in module
+        or issubclass(cls, LookMLModelConfig)
     )
 
 
@@ -501,7 +503,7 @@ def introspect() -> AuthorableSchema:
         JsonSourceConfig,
         HttpSourceConfig,
         DbtProfileSourceConfig,
-        LookMLSourceConfig,
+        LookMLModelConfig,
         # Compiled style root — walks style/theme/ types so inherit-chain metadata
         # (Inherit/InheritSlot markers) is visible in the schema IR.
         Style,

dataface/core/compile/models/chart/authored/_base.py

@@ -121,6 +121,15 @@ class _BaseChartFields(BaseModel):
             default=None, description="Click-through URL template for drill-down links."
         ),
     ]
+    # Semantic-layer chart sugar: normalizer desugars this into a synthesized
+    # named query and clears the field. Mutually exclusive with `query:`.
+    model: Annotated[
+        str | None,
+        Field(
+            default=None,
+            description="Semantic-layer entry point: 'model.explore' (LookML model name and explore joined by a dot). Mutually exclusive with `query:`.",
+        ),
+    ]
 
     @model_validator(mode="before")
     @classmethod

dataface/core/compile/models/chart/normalized/_flat.py

@@ -25,7 +25,6 @@ from dataface.core.compile.models.chart.authored import (
 from dataface.core.compile.models.primitives import FormatConfig
 from dataface.core.compile.models.query.normalized import (
     AnyQuery,
-    MetricFlowQuery,
     SchemaQuery,
     SqlQuery,
 )
@@ -84,7 +83,7 @@ class Chart(BaseModel):
     id: str = Field(description="Unique identifier within the dashboard.")
     query: AnyQuery | None = Field(
         default=None,
-        description="Resolved query object (SqlQuery, MetricFlowQuery, etc.). None for blank/placeholder charts.",
+        description="Resolved query object (SqlQuery, HttpQuery, etc.). None for blank/placeholder charts.",
     )
     query_name: str | None = Field(
         default=None,
@@ -378,7 +377,7 @@ class Chart(BaseModel):
             if isinstance(self.query, SqlQuery) and self.query.sql:
                 query_dict["sql"] = self.query.sql
             if (
-                isinstance(self.query, (SqlQuery, MetricFlowQuery, SchemaQuery))
+                isinstance(self.query, (SqlQuery, SchemaQuery))
                 and isinstance(self.query.source, str)
                 and self.query.source
             ):