datalex-cli 1.8.2__tar.gz → 1.10.0__tar.gz

{datalex_cli-1.8.2 → datalex_cli-1.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datalex-cli
-Version: 1.8.2
+Version: 1.10.0
 Summary: Git-native data modeling for dbt users
 Author-email: DuckCode AI Labs <hello@duckcode.ai>
 License: MIT
@@ -25,6 +25,17 @@ Requires-Dist: PyYAML>=6.0
 Requires-Dist: jsonschema>=4.0
 Provides-Extra: serve
 Requires-Dist: nodejs-wheel<23,>=20; extra == "serve"
+Provides-Extra: draft
+Requires-Dist: anthropic>=0.40.0; extra == "draft"
+Provides-Extra: draft-openai
+Requires-Dist: openai>=1.30.0; extra == "draft-openai"
+Provides-Extra: draft-gemini
+Requires-Dist: google-generativeai>=0.8.0; extra == "draft-gemini"
+Provides-Extra: draft-ollama
+Provides-Extra: draft-all
+Requires-Dist: anthropic>=0.40.0; extra == "draft-all"
+Requires-Dist: openai>=1.30.0; extra == "draft-all"
+Requires-Dist: google-generativeai>=0.8.0; extra == "draft-all"
 Provides-Extra: duckdb
 Requires-Dist: duckdb>=0.9; extra == "duckdb"
 Provides-Extra: postgres
@@ -43,6 +54,9 @@ Provides-Extra: redshift
 Requires-Dist: redshift-connector; extra == "redshift"
 Provides-Extra: all
 Requires-Dist: nodejs-wheel<23,>=20; extra == "all"
+Requires-Dist: anthropic>=0.40.0; extra == "all"
+Requires-Dist: openai>=1.30.0; extra == "all"
+Requires-Dist: google-generativeai>=0.8.0; extra == "all"
 Requires-Dist: duckdb>=0.9; extra == "all"
 Requires-Dist: psycopg2-binary; extra == "all"
 Requires-Dist: mysql-connector-python; extra == "all"
@@ -126,7 +140,7 @@ In the UI, use `/workspace` as the dbt repository path. Full Docker
 notes (env vars, troubleshooting) live in
 [Install → Docker Fallback](#docker-fallback-optional).
 
-### When the app opens — the Onboarding Journey (1.4.1)
+### When the app opens — the Onboarding Journey
 
 A **480px right-rail panel** slides in on first launch and walks you
 through six concrete actions. Each step has a primary button that opens
@@ -145,6 +159,20 @@ Progress is saved — close the panel anytime and resume where you left off.
 Replay anytime via **Settings → Replay onboarding**. The deeper 13-step
 spotlight tour is still there under **Settings → Deep feature tour**.
 
+### What's new in 1.8
+
+Three release threads landed across `1.8.0` → `1.8.2`. Each is on by
+default; no config flags or migrations needed.
+
+| Phase | Feature | Where to find it |
+|---|---|---|
+| 3 (1.8.0) | **Capability Map** top-tab — boxes-in-boxes hierarchy of `Domain → Subject area → Concept` for the active model | `Capabilities` tab in the workspace, peer of Diagram / Docs / Table |
+| 4a (1.8.1) | **EventStorming entity types** — five new types (`event`, `command`, `actor`, `policy`, `aggregate`) with the canonical Brandolini sticky-note palette on the canvas | Build panel type picker on conceptual diagrams |
+| 4b (1.8.2) | **EventStorming flow narrative** in DocsView — numbered story grouped Actors → Commands → Aggregates → Events → Policies, sticky-note swatches matching the canvas | DocsView, between the ER diagram and per-entity tables (auto-hides for plain ER models) |
+| 5a (1.8.2) | **Markdown export** from DocsView — portable `.md` with mermaid blocks embedded; renders inline on GitHub, GitLab, Confluence-with-mermaid, Notion, and inside any LLM context window | `Export Markdown` button next to `Export OSI` in DocsView's header |
+
+Walked through end-to-end in the [jaffle-shop tutorial](https://github.com/duckcode-ai/jaffle-shop-DataLex). Full release notes in [CHANGELOG.md](CHANGELOG.md).
+
 **Point it at your dbt repo:**
 
 ```bash

{datalex_cli-1.8.2 → datalex_cli-1.10.0}/README.md

@@ -71,7 +71,7 @@ In the UI, use `/workspace` as the dbt repository path. Full Docker
 notes (env vars, troubleshooting) live in
 [Install → Docker Fallback](#docker-fallback-optional).
 
-### When the app opens — the Onboarding Journey (1.4.1)
+### When the app opens — the Onboarding Journey
 
 A **480px right-rail panel** slides in on first launch and walks you
 through six concrete actions. Each step has a primary button that opens
@@ -90,6 +90,20 @@ Progress is saved — close the panel anytime and resume where you left off.
 Replay anytime via **Settings → Replay onboarding**. The deeper 13-step
 spotlight tour is still there under **Settings → Deep feature tour**.
 
+### What's new in 1.8
+
+Three release threads landed across `1.8.0` → `1.8.2`. Each is on by
+default; no config flags or migrations needed.
+
+| Phase | Feature | Where to find it |
+|---|---|---|
+| 3 (1.8.0) | **Capability Map** top-tab — boxes-in-boxes hierarchy of `Domain → Subject area → Concept` for the active model | `Capabilities` tab in the workspace, peer of Diagram / Docs / Table |
+| 4a (1.8.1) | **EventStorming entity types** — five new types (`event`, `command`, `actor`, `policy`, `aggregate`) with the canonical Brandolini sticky-note palette on the canvas | Build panel type picker on conceptual diagrams |
+| 4b (1.8.2) | **EventStorming flow narrative** in DocsView — numbered story grouped Actors → Commands → Aggregates → Events → Policies, sticky-note swatches matching the canvas | DocsView, between the ER diagram and per-entity tables (auto-hides for plain ER models) |
+| 5a (1.8.2) | **Markdown export** from DocsView — portable `.md` with mermaid blocks embedded; renders inline on GitHub, GitLab, Confluence-with-mermaid, Notion, and inside any LLM context window | `Export Markdown` button next to `Export OSI` in DocsView's header |
+
+Walked through end-to-end in the [jaffle-shop tutorial](https://github.com/duckcode-ai/jaffle-shop-DataLex). Full release notes in [CHANGELOG.md](CHANGELOG.md).
+
 **Point it at your dbt repo:**
 
 ```bash

{datalex_cli-1.8.2 → datalex_cli-1.10.0}/datalex_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datalex-cli
-Version: 1.8.2
+Version: 1.10.0
 Summary: Git-native data modeling for dbt users
 Author-email: DuckCode AI Labs <hello@duckcode.ai>
 License: MIT
@@ -25,6 +25,17 @@ Requires-Dist: PyYAML>=6.0
 Requires-Dist: jsonschema>=4.0
 Provides-Extra: serve
 Requires-Dist: nodejs-wheel<23,>=20; extra == "serve"
+Provides-Extra: draft
+Requires-Dist: anthropic>=0.40.0; extra == "draft"
+Provides-Extra: draft-openai
+Requires-Dist: openai>=1.30.0; extra == "draft-openai"
+Provides-Extra: draft-gemini
+Requires-Dist: google-generativeai>=0.8.0; extra == "draft-gemini"
+Provides-Extra: draft-ollama
+Provides-Extra: draft-all
+Requires-Dist: anthropic>=0.40.0; extra == "draft-all"
+Requires-Dist: openai>=1.30.0; extra == "draft-all"
+Requires-Dist: google-generativeai>=0.8.0; extra == "draft-all"
 Provides-Extra: duckdb
 Requires-Dist: duckdb>=0.9; extra == "duckdb"
 Provides-Extra: postgres
@@ -43,6 +54,9 @@ Provides-Extra: redshift
 Requires-Dist: redshift-connector; extra == "redshift"
 Provides-Extra: all
 Requires-Dist: nodejs-wheel<23,>=20; extra == "all"
+Requires-Dist: anthropic>=0.40.0; extra == "all"
+Requires-Dist: openai>=1.30.0; extra == "all"
+Requires-Dist: google-generativeai>=0.8.0; extra == "all"
 Requires-Dist: duckdb>=0.9; extra == "all"
 Requires-Dist: psycopg2-binary; extra == "all"
 Requires-Dist: mysql-connector-python; extra == "all"
@@ -126,7 +140,7 @@ In the UI, use `/workspace` as the dbt repository path. Full Docker
 notes (env vars, troubleshooting) live in
 [Install → Docker Fallback](#docker-fallback-optional).
 
-### When the app opens — the Onboarding Journey (1.4.1)
+### When the app opens — the Onboarding Journey
 
 A **480px right-rail panel** slides in on first launch and walks you
 through six concrete actions. Each step has a primary button that opens
@@ -145,6 +159,20 @@ Progress is saved — close the panel anytime and resume where you left off.
 Replay anytime via **Settings → Replay onboarding**. The deeper 13-step
 spotlight tour is still there under **Settings → Deep feature tour**.
 
+### What's new in 1.8
+
+Three release threads landed across `1.8.0` → `1.8.2`. Each is on by
+default; no config flags or migrations needed.
+
+| Phase | Feature | Where to find it |
+|---|---|---|
+| 3 (1.8.0) | **Capability Map** top-tab — boxes-in-boxes hierarchy of `Domain → Subject area → Concept` for the active model | `Capabilities` tab in the workspace, peer of Diagram / Docs / Table |
+| 4a (1.8.1) | **EventStorming entity types** — five new types (`event`, `command`, `actor`, `policy`, `aggregate`) with the canonical Brandolini sticky-note palette on the canvas | Build panel type picker on conceptual diagrams |
+| 4b (1.8.2) | **EventStorming flow narrative** in DocsView — numbered story grouped Actors → Commands → Aggregates → Events → Policies, sticky-note swatches matching the canvas | DocsView, between the ER diagram and per-entity tables (auto-hides for plain ER models) |
+| 5a (1.8.2) | **Markdown export** from DocsView — portable `.md` with mermaid blocks embedded; renders inline on GitHub, GitLab, Confluence-with-mermaid, Notion, and inside any LLM context window | `Export Markdown` button next to `Export OSI` in DocsView's header |
+
+Walked through end-to-end in the [jaffle-shop tutorial](https://github.com/duckcode-ai/jaffle-shop-DataLex). Full release notes in [CHANGELOG.md](CHANGELOG.md).
+
 **Point it at your dbt repo:**
 
 ```bash

{datalex_cli-1.8.2 → datalex_cli-1.10.0}/datalex_cli.egg-info/SOURCES.txt

@@ -1228,6 +1228,21 @@ packages/core_engine/src/datalex_core/dialects/base.py
 packages/core_engine/src/datalex_core/dialects/postgres.py
 packages/core_engine/src/datalex_core/dialects/registry.py
 packages/core_engine/src/datalex_core/dialects/snowflake.py
+packages/core_engine/src/datalex_core/draft/__init__.py
+packages/core_engine/src/datalex_core/draft/manifest_loader.py
+packages/core_engine/src/datalex_core/draft/prompt.py
+packages/core_engine/src/datalex_core/draft/runner.py
+packages/core_engine/src/datalex_core/draft/few_shot/__init__.py
+packages/core_engine/src/datalex_core/draft/few_shot/01_simple_starter/input.json
+packages/core_engine/src/datalex_core/draft/few_shot/01_simple_starter/output.yaml
+packages/core_engine/src/datalex_core/draft/few_shot/02_with_relationships/input.json
+packages/core_engine/src/datalex_core/draft/few_shot/02_with_relationships/output.yaml
+packages/core_engine/src/datalex_core/draft/providers/__init__.py
+packages/core_engine/src/datalex_core/draft/providers/anthropic_provider.py
+packages/core_engine/src/datalex_core/draft/providers/base.py
+packages/core_engine/src/datalex_core/draft/providers/gemini_provider.py
+packages/core_engine/src/datalex_core/draft/providers/ollama_provider.py
+packages/core_engine/src/datalex_core/draft/providers/openai_provider.py
 packages/core_engine/src/datalex_core/exporters/__init__.py
 packages/core_engine/src/datalex_core/exporters/_shared.py
 packages/core_engine/src/datalex_core/exporters/atlan.py
@@ -1243,6 +1258,8 @@ packages/readiness_engine/src/datalex_readiness/walker.py
 tests/test_cli_dx.py
 tests/test_connectors.py
 tests/test_docs_generation.py
+tests/test_draft_manifest_loader.py
+tests/test_draft_providers.py
 tests/test_importers_v2.py
 tests/test_inference.py
 tests/test_integrations.py

{datalex_cli-1.8.2 → datalex_cli-1.10.0}/datalex_cli.egg-info/requires.txt

@@ -3,6 +3,9 @@ jsonschema>=4.0
 
 [all]
 nodejs-wheel<23,>=20
+anthropic>=0.40.0
+openai>=1.30.0
+google-generativeai>=0.8.0
 duckdb>=0.9
 psycopg2-binary
 mysql-connector-python
@@ -18,6 +21,22 @@ google-cloud-bigquery
 [databricks]
 databricks-sql-connector
 
+[draft]
+anthropic>=0.40.0
+
+[draft-all]
+anthropic>=0.40.0
+openai>=1.30.0
+google-generativeai>=0.8.0
+
+[draft-gemini]
+google-generativeai>=0.8.0
+
+[draft-ollama]
+
+[draft-openai]
+openai>=1.30.0
+
 [duckdb]
 duckdb>=0.9
 

{datalex_cli-1.8.2 → datalex_cli-1.10.0}/packages/cli/src/datalex_cli/main.py

@@ -1509,6 +1509,116 @@ def cmd_import_dbt(args: argparse.Namespace) -> int:
     return 1 if has_errors(issues) else 0
 
 
+def cmd_draft(args: argparse.Namespace) -> int:
+    """AI-assisted DataLex starter from a dbt project.
+
+    Pipeline:
+      1. Load and condense the dbt manifest at <dbt>/target/manifest.json.
+      2. Call Anthropic with a system prompt + 2-shot pack (cache-controlled).
+      3. Extract a fenced YAML block from the response.
+      4. Schema-validate against the bundled DataLex model schema.
+      5. Print to stdout, or print a unified diff against --out and only
+         write when --force is passed.
+    """
+    import difflib
+    import subprocess
+
+    from datalex_core import (
+        DraftError,
+        condense_manifest,
+        draft_starter,
+        load_manifest,
+    )
+
+    dbt_path = Path(args.dbt)
+    if not dbt_path.exists():
+        sys.stderr.write(f"--dbt path does not exist: {dbt_path}\n")
+        return 2
+    try:
+        manifest = load_manifest(dbt_path)
+    except (FileNotFoundError, subprocess.CalledProcessError) as exc:
+        sys.stderr.write(f"failed to load dbt manifest: {exc}\n")
+        return 2
+    condensed = condense_manifest(manifest, include_glob=args.include)
+    if not condensed["models"]:
+        msg = "[draft] no dbt models found in manifest"
+        if args.include:
+            msg += f" matching --include {args.include!r}"
+        sys.stderr.write(msg + ". Nothing to draft.\n")
+        return 2
+
+    owner = args.owner or _detect_owner_email()
+    schema_path = Path(args.schema) if args.schema else Path(_default_schema_path())
+    try:
+        yaml_text, summary = draft_starter(
+            condensed=condensed,
+            domain=args.domain,
+            owner=owner,
+            provider=args.provider,
+            model=args.model or None,
+            max_tokens=args.max_tokens,
+            schema_path=schema_path,
+        )
+    except DraftError as exc:
+        sys.stderr.write(f"[draft] {exc}\n")
+        return 3
+
+    sys.stderr.write(
+        f"[draft] provider={summary.get('provider', '?')} model={summary.get('model', '?')}\n"
+    )
+    sys.stderr.write(
+        f"[draft] tokens: input={summary.get('input_tokens', '?')} "
+        f"output={summary.get('output_tokens', '?')} "
+        f"cache_read={summary.get('cache_read_tokens', 0)} "
+        f"cache_write={summary.get('cache_write_tokens', 0)}\n"
+    )
+    sys.stderr.write(
+        f"[draft] entities={summary['entities']} fields={summary['fields']} "
+        f"relationships={summary['relationships']} rules={summary['rules']}\n"
+    )
+
+    out = Path(args.out) if args.out else None
+    if out is None:
+        sys.stdout.write(yaml_text)
+        return 0
+    if out.exists():
+        existing = out.read_text()
+        diff = "".join(
+            difflib.unified_diff(
+                existing.splitlines(keepends=True),
+                yaml_text.splitlines(keepends=True),
+                fromfile=str(out),
+                tofile=f"{out} (proposed)",
+            )
+        )
+        sys.stdout.write(diff or "[draft] no changes\n")
+        if not args.force:
+            sys.stderr.write(f"[draft] {out} exists; pass --force to overwrite.\n")
+            return 0
+    out.parent.mkdir(parents=True, exist_ok=True)
+    out.write_text(yaml_text)
+    sys.stderr.write(f"[draft] wrote {out}\n")
+    return 0
+
+
+def _detect_owner_email() -> str:
+    import subprocess
+
+    try:
+        result = subprocess.run(
+            ["git", "config", "--get", "user.email"],
+            capture_output=True,
+            text=True,
+            check=False,
+        )
+        email = result.stdout.strip()
+        if email:
+            return email
+    except FileNotFoundError:
+        pass
+    return "data@example.com"
+
+
 def cmd_serve(args: argparse.Namespace) -> int:
     """Start the bundled DataLex server.
 
@@ -3498,6 +3608,68 @@ def build_parser() -> argparse.ArgumentParser:
     import_dbt_parser.add_argument("--schema", default=_default_schema_path(), help="Path to model schema JSON")
     import_dbt_parser.set_defaults(func=cmd_import_dbt)
 
+    draft_parser = sub.add_parser(
+        "draft",
+        help="AI-assisted DataLex starter from a dbt project",
+        description=(
+            "Turn a dbt project's target/manifest.json into a draft DataLex "
+            "*.model.yaml the user reviews, edits, and commits. Reviewable AI "
+            "output -- never silent rewrites of project files."
+        ),
+    )
+    draft_parser.add_argument(
+        "--dbt",
+        required=True,
+        help="dbt project root (must contain target/manifest.json or dbt_project.yml)",
+    )
+    draft_parser.add_argument(
+        "--domain",
+        required=True,
+        help="DataLex domain to assign (e.g. commerce, finance)",
+    )
+    draft_parser.add_argument(
+        "--out",
+        help="Write proposed YAML to this path (default: stdout)",
+    )
+    draft_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Allow --out to overwrite an existing file",
+    )
+    draft_parser.add_argument(
+        "--provider",
+        choices=["anthropic", "openai", "gemini", "ollama"],
+        default=None,
+        help=(
+            "LLM provider. Auto-detects from env when omitted: "
+            "ANTHROPIC_API_KEY > OPENAI_API_KEY > GOOGLE_API_KEY > Ollama fallback."
+        ),
+    )
+    draft_parser.add_argument(
+        "--model",
+        default="",
+        help=(
+            "Model id. Defaults are per-provider: "
+            "claude-opus-4-7 (anthropic), gpt-4.1 (openai), "
+            "gemini-2.5-pro (gemini), llama3.1:8b (ollama)."
+        ),
+    )
+    draft_parser.add_argument("--max-tokens", type=int, default=8000)
+    draft_parser.add_argument(
+        "--owner",
+        help="Email for model.owners (default: git user.email or data@example.com)",
+    )
+    draft_parser.add_argument(
+        "--include",
+        help="dbt model name glob to include (e.g. dim_*)",
+    )
+    draft_parser.add_argument(
+        "--schema",
+        default=None,
+        help="Path to DataLex model JSON schema (default: bundled)",
+    )
+    draft_parser.set_defaults(func=cmd_draft)
+
     # dbt round-trip subcommand group
     dbt_parser = sub.add_parser("dbt", help="dbt round-trip: sync DataLex metadata into dbt schema.yml files")
     dbt_sub = dbt_parser.add_subparsers(dest="dbt_command", required=True)

{datalex_cli-1.8.2 → datalex_cli-1.10.0}/packages/core_engine/src/datalex_core/__init__.py

@@ -44,12 +44,22 @@ from datalex_core.semantic import (
     EntityCompleteness,
     ModelCompleteness,
 )
+from datalex_core.draft import (
+    DraftError,
+    condense_manifest,
+    draft_starter,
+    load_manifest,
+)
 
 __all__ = [
     "compile_model",
     "completeness_as_dict",
     "completeness_report",
+    "condense_manifest",
     "ConnectorConfig",
+    "draft_starter",
+    "DraftError",
+    "load_manifest",
     "ConnectorResult",
     "dbt_scaffold_files",
     "diagnostics_as_json",

datalex_cli-1.10.0/packages/core_engine/src/datalex_core/draft/__init__.py

@@ -0,0 +1,29 @@
+"""AI-assisted DataLex starter drafting from a dbt project.
+
+Public entry point for `datalex draft`. The CLI command in
+`datalex_cli.main.cmd_draft` is a thin wrapper around `draft_starter()`.
+"""
+
+from datalex_core.draft.manifest_loader import condense_manifest, load_manifest
+from datalex_core.draft.providers import (
+    AUTO_DETECT_ORDER,
+    PROVIDERS,
+    Provider,
+    ProviderError,
+    detect_provider,
+    get_provider,
+)
+from datalex_core.draft.runner import DraftError, draft_starter
+
+__all__ = [
+    "AUTO_DETECT_ORDER",
+    "DraftError",
+    "PROVIDERS",
+    "Provider",
+    "ProviderError",
+    "condense_manifest",
+    "detect_provider",
+    "draft_starter",
+    "get_provider",
+    "load_manifest",
+]

datalex_cli-1.10.0/packages/core_engine/src/datalex_core/draft/few_shot/01_simple_starter/input.json

@@ -0,0 +1,42 @@
+{
+  "project": "tiny_shop",
+  "dialect": "duckdb",
+  "models": [
+    {
+      "name": "dim_customers",
+      "description": "Customer dimension table, one row per customer.",
+      "schema": "marts",
+      "materialization": "table",
+      "tags": ["mart"],
+      "meta": {},
+      "columns": [
+        {
+          "name": "customer_id",
+          "type": "integer",
+          "description": "Primary key for the customer.",
+          "constraints": ["not_null", "unique"]
+        },
+        {
+          "name": "customer_name",
+          "type": "varchar",
+          "description": "Customer display name.",
+          "constraints": []
+        },
+        {
+          "name": "customer_email",
+          "type": "varchar",
+          "description": "Primary email used for receipts and login.",
+          "constraints": ["not_null"]
+        },
+        {
+          "name": "first_ordered_at",
+          "type": "timestamp",
+          "description": "Timestamp of the customer's first order.",
+          "constraints": []
+        }
+      ],
+      "refs": []
+    }
+  ],
+  "sources": []
+}

datalex_cli-1.10.0/packages/core_engine/src/datalex_core/draft/few_shot/01_simple_starter/output.yaml

@@ -0,0 +1,35 @@
+```yaml
+model:
+  name: commerce
+  version: 1.0.0
+  domain: commerce
+  owners:
+    - data@example.com
+  state: draft
+
+entities:
+  - name: Customer
+    type: table
+    description: Customer dimension table, one row per customer.
+    tags: [GOLD, MART, PII]
+    fields:
+      - name: customer_id
+        type: integer
+        primary_key: true
+        nullable: false
+        description: Primary key for the customer.
+      - name: customer_name
+        type: string
+        description: Customer display name.
+      - name: customer_email
+        type: string
+        nullable: false
+        description: Primary email used for receipts and login.
+      - name: first_ordered_at
+        type: timestamp
+        description: Timestamp of the customer's first order.
+
+governance:
+  classification:
+    Customer.customer_email: PII
+```

datalex_cli-1.10.0/packages/core_engine/src/datalex_core/draft/few_shot/02_with_relationships/input.json

@@ -0,0 +1,100 @@
+{
+  "project": "midsize_shop",
+  "dialect": "duckdb",
+  "models": [
+    {
+      "name": "dim_customers",
+      "description": "Customer dimension, one row per customer.",
+      "schema": "marts",
+      "materialization": "table",
+      "tags": ["mart"],
+      "meta": {},
+      "columns": [
+        {
+          "name": "customer_id",
+          "type": "integer",
+          "description": "Primary key for the customer.",
+          "constraints": ["not_null", "unique"]
+        },
+        {
+          "name": "customer_email",
+          "type": "varchar",
+          "description": "Primary email used for receipts.",
+          "constraints": ["not_null"]
+        }
+      ],
+      "refs": []
+    },
+    {
+      "name": "fct_orders",
+      "description": "Order fact table, one row per completed order.",
+      "schema": "marts",
+      "materialization": "table",
+      "tags": ["mart"],
+      "meta": {},
+      "columns": [
+        {
+          "name": "order_id",
+          "type": "integer",
+          "description": "Primary key for the order.",
+          "constraints": ["not_null", "unique"]
+        },
+        {
+          "name": "customer_id",
+          "type": "integer",
+          "description": "Foreign key to the customer who placed the order.",
+          "constraints": ["not_null"]
+        },
+        {
+          "name": "ordered_at",
+          "type": "timestamp",
+          "description": "UTC timestamp the order was placed.",
+          "constraints": ["not_null"]
+        },
+        {
+          "name": "order_total",
+          "type": "decimal(12,2)",
+          "description": "Order total in USD, inclusive of tax and discounts.",
+          "constraints": []
+        }
+      ],
+      "refs": ["dim_customers"]
+    },
+    {
+      "name": "order_items",
+      "description": "Line items, one row per item per order.",
+      "schema": "marts",
+      "materialization": "table",
+      "tags": ["mart"],
+      "meta": {},
+      "columns": [
+        {
+          "name": "order_item_id",
+          "type": "integer",
+          "description": "Primary key for the order line item.",
+          "constraints": ["not_null", "unique"]
+        },
+        {
+          "name": "order_id",
+          "type": "integer",
+          "description": "Foreign key to the parent order.",
+          "constraints": ["not_null"]
+        },
+        {
+          "name": "product_id",
+          "type": "integer",
+          "description": "Foreign key to the product.",
+          "constraints": ["not_null"]
+        },
+        {
+          "name": "quantity",
+          "type": "integer",
+          "description": "Number of units ordered.",
+          "constraints": ["not_null"]
+        }
+      ],
+      "refs": ["fct_orders"]
+    }
+  ],
+  "sources": []
+}