datalex-cli 0.1.1__py3-none-any.whl

datalex_cli-0.1.1.dist-info/METADATA

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: datalex-cli
+Version: 0.1.1
+Summary: Git-native data modeling for dbt users
+Author-email: DuckCode AI Labs <hello@duckcode.ai>
+License: MIT
+Project-URL: Homepage, https://duckcode.ai
+Project-URL: Repository, https://github.com/duckcode-ai/DataLex
+Project-URL: Issues, https://github.com/duckcode-ai/DataLex/issues
+Keywords: dbt,data-modeling,yaml,git-native,erd,data-warehouse
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: jsonschema>=4.0
+Provides-Extra: duckdb
+Requires-Dist: duckdb>=0.9; extra == "duckdb"
+Provides-Extra: postgres
+Requires-Dist: psycopg2-binary; extra == "postgres"
+Provides-Extra: mysql
+Requires-Dist: mysql-connector-python; extra == "mysql"
+Provides-Extra: snowflake
+Requires-Dist: snowflake-connector-python; extra == "snowflake"
+Provides-Extra: bigquery
+Requires-Dist: google-cloud-bigquery; extra == "bigquery"
+Provides-Extra: databricks
+Requires-Dist: databricks-sql-connector; extra == "databricks"
+Provides-Extra: sqlserver
+Requires-Dist: pyodbc; extra == "sqlserver"
+Provides-Extra: redshift
+Requires-Dist: redshift-connector; extra == "redshift"
+Provides-Extra: all
+Requires-Dist: duckdb>=0.9; extra == "all"
+Requires-Dist: psycopg2-binary; extra == "all"
+Requires-Dist: mysql-connector-python; extra == "all"
+Requires-Dist: snowflake-connector-python; extra == "all"
+Requires-Dist: google-cloud-bigquery; extra == "all"
+Requires-Dist: databricks-sql-connector; extra == "all"
+Requires-Dist: pyodbc; extra == "all"
+Requires-Dist: redshift-connector; extra == "all"
+Dynamic: license-file
+
+<div align="center">
+  <a href="https://duckcode.ai/" target="_blank" rel="noopener noreferrer">
+    <img src="Assets/DataLex.png" alt="DataLex by DuckCode AI Labs" width="220" />
+  </a>
+
+# DataLex
+
+**Git-native data modeling for dbt users.**
+
+Point us at your dbt project and warehouse — we produce versioned, reviewable YAML
+with contracts, lineage, ERDs, and clean round-trip back to dbt.
+
+<p align="center">
+  <a href="https://github.com/duckcode-ai/DataLex/blob/main/LICENSE">
+    <img src="https://img.shields.io/github/license/duckcode-ai/DataLex?style=for-the-badge&color=22c55e" alt="MIT License" />
+  </a>
+  <a href="https://discord.gg/Dnm6bUvk">
+    <img src="https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord Community" />
+  </a>
+  <a href="https://github.com/duckcode-ai/DataLex/stargazers">
+    <img src="https://img.shields.io/github/stars/duckcode-ai/DataLex?style=for-the-badge&color=f59e0b" alt="GitHub Stars" />
+  </a>
+</p>
+</div>
+
+<p align="center">
+  <img src="Assets/Overview.png" alt="DataLex Visual Studio — file tree, YAML editor, and React Flow ERD on the same entity" width="100%" />
+</p>
+
+## 60-second demo
+
+```bash
+git clone https://github.com/duckcode-ai/DataLex.git
+cd DataLex
+pip install -e '.[duckdb]'
+
+# 1. Build a local DuckDB warehouse (no external credentials)
+python examples/jaffle_shop_demo/setup.py
+
+# 2. Sync the dbt project into DataLex YAML
+./datalex datalex dbt sync examples/jaffle_shop_demo \
+    --out-root examples/jaffle_shop_demo/datalex-out
+
+# 3. Emit dbt-parseable YAML back, with contracts enforced
+./datalex datalex dbt emit examples/jaffle_shop_demo/datalex-out \
+    --out-dir examples/jaffle_shop_demo/dbt-out
+```
+
+Open `examples/jaffle_shop_demo/datalex-out/sources/jaffle_shop_raw.yaml` —
+every column has its warehouse type, descriptions from the manifest, and a
+`meta.datalex.dbt.unique_id` stamp so re-running the sync never clobbers
+anything you've hand-authored.
+
+## What it does
+
+DataLex treats your data models as code. On top of a stricter YAML
+substrate (the **DataLex** layout — one file per entity, `kind:`-dispatched,
+streaming-safe for 10K+ entities), it gives you:
+
+- **`datalex datalex dbt sync <project>`** — reads `target/manifest.json` + your
+  `profiles.yml`, introspects live column types, and merges them into
+  DataLex YAML. Idempotent: user-authored `description:`, `tags:`,
+  `sensitivity:`, and `tests:` survive re-sync.
+- **`datalex datalex dbt emit`** — writes `sources.yml` and `schema.yml` with
+  `contract.enforced: true` and `data_type:` on every column. `dbt parse`
+  succeeds out of the box.
+- **`datalex datalex emit ddl --dialect ...`** — Postgres, Snowflake, BigQuery,
+  Databricks, MySQL, SQL Server, Redshift. Same source, all dialects.
+- **`datalex datalex diff`** — semantic diff with explicit rename tracking
+  (`previous_name:`), breaking-change gate for CI.
+- **Cross-repo package imports** — pin `acme/warehouse-core@1.4.0` in
+  `imports:`, lockfile + content hash drift detection, Git-or-path
+  resolution, on-disk parse cache for large projects.
+- **Visual studio** — React Flow UI for editing entities, relationships,
+  and metadata; same YAML files as the CLI.
+
+## Supported warehouses
+
+| Warehouse | `dbt sync` introspection | Forward DDL | Reverse engineering |
+|---|:---:|:---:|:---:|
+| DuckDB | ✓ | — | — |
+| PostgreSQL | ✓ | ✓ | ✓ |
+| Snowflake | (fallback) | ✓ | ✓ |
+| BigQuery | (fallback) | ✓ | ✓ |
+| Databricks | (fallback) | ✓ | ✓ |
+| MySQL | (fallback) | ✓ | ✓ |
+| SQL Server / Azure SQL | (fallback) | ✓ | ✓ |
+| Redshift | (fallback) | ✓ | ✓ |
+
+"Fallback" = uses the existing full-schema connector (slower than the
+per-table path but already works today; a narrow introspection path ships
+per-dialect over time).
+
+## Install
+
+```bash
+git clone https://github.com/duckcode-ai/DataLex.git
+cd DataLex
+
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .              # puts `datalex` on PATH
+pip install -e '.[duckdb]'    # add warehouse drivers you need
+
+# optional — only needed for the Visual Studio
+npm --prefix packages/api-server install
+npm --prefix packages/web-app install
+```
+
+Available extras: `duckdb`, `postgres`, `mysql`, `snowflake`,
+`bigquery`, `databricks`, `sqlserver`, `redshift`, or `all`.
+
+Prereqs: Python 3.9+, Git. Node.js 18+ if you want the UI.
+
+## Project layout
+
+```text
+DataLex/
+  packages/
+    core_engine/           # Python: loader, dialects, dbt integration, packages
+      src/datalex_core/
+        _schemas/datalex/  # JSON Schema per `kind:` — bundled with the package
+    cli/                   # `datalex` entry point
+    api-server/            # Node.js API (UI backend)
+    web-app/               # React Flow studio
+  examples/
+    jaffle_shop_demo/      # zero-setup dbt-sync demo (DuckDB)
+  model-examples/          # sample projects and scenario walkthroughs
+  docs/                    # architecture, specs, runbooks
+  tests/                   # unittest suite (core engine + datalex)
+```
+
+## Visual Studio (optional)
+
+If you want the UI on top of your DataLex project, run the two dev servers:
+
+```bash
+# Terminal 1
+npm --prefix packages/api-server run dev
+# Terminal 2
+npm --prefix packages/web-app run dev
+```
+
+Then open `http://localhost:5173`. The UI reads and writes the same YAML
+files the CLI does — no database, no hosted service.
+
+## CI / GitOps
+
+DataLex is designed to live in your repo next to your dbt project.
+A typical CI step:
+
+```bash
+./datalex datalex validate datalex/
+./datalex datalex diff datalex-main/ datalex/ --exit-on-breaking
+./datalex datalex dbt emit datalex/ --out-dir dbt/
+dbt parse
+```
+
+## Documentation
+
+- **[Tutorial: dbt sync in 5 minutes](docs/tutorial-dbt-sync.md)** — the
+  full jaffle_shop walkthrough with explanations.
+- **[DataLex layout reference](docs/datalex-layout.md)** — what each
+  `kind:` file looks like and how the loader discovers them.
+- **[CLI cheat sheet](docs/cli.md)** — every `datalex datalex …` subcommand on
+  one page.
+- **[Architecture](docs/architecture.md)** — core engine modules and
+  end-to-end data flow.
+- Pre-DataLex specs have moved to [docs/archive/](docs/archive/).
+
+## Community
+
+- Discord: [![Join Discord](https://img.shields.io/badge/Discord-Join%20DuckCode%20AI-5865F2?logo=discord&logoColor=white)](https://discord.gg/Dnm6bUvk)
+- Issues: [![GitHub Issues](https://img.shields.io/badge/Issues-Report%20or%20Request-0ea5e9)](https://github.com/duckcode-ai/DataLex/issues)
+- Contributing: `CONTRIBUTING.md`
+- License: [![MIT](https://img.shields.io/badge/License-MIT-22c55e?style=flat-square)](LICENSE)

datalex_cli-0.1.1.dist-info/RECORD

@@ -0,0 +1,64 @@
+datalex_cli/__init__.py,sha256=CBbUACIZ9fDqHyawV0txWNY92wLUe_nYteMblNPYUes,21
+datalex_cli/datalex_cli.py,sha256=oK3cpDJ2TiIgjL0TH05WupQINW-MkiCMHCUI_o9iQmU,22879
+datalex_cli/main.py,sha256=PqJmt1Oj9a-i0CrMCMAWA62yfnYUwjyBjTeb0VjBKH0,113411
+datalex_cli-0.1.1.dist-info/licenses/LICENSE,sha256=j6Xcaimk1_Rpcri1CmvfAS7ENSKo5omtdLu3jpSYkAg,1068
+datalex_core/__init__.py,sha256=DRcxrqpL15IPBNJARIbK_ZhmyltxNN5lbChcuP0uHuc,2724
+datalex_core/canonical.py,sha256=ChcZR5AVnXursWgNwzGQ35OQ4dls6vQG5sQtz0pnhsg,7361
+datalex_core/completion.py,sha256=2TzguA6QKbDIOF8KCgD3icpQYeyiecHmSEY7p3Pr2_I,6346
+datalex_core/diffing.py,sha256=wPbahRu7BNDm9j9MjhNEzodeQfZq-drTPtT1qqq-XEw,13595
+datalex_core/docs_generator.py,sha256=bM69rUDVxJd6SnOiq1t2WutOHBWBQ88I7q6VH3AIlew,35261
+datalex_core/doctor.py,sha256=WGlTXiIgrf7QT2fCi8V0EImAf4dBiUntqWRm1pGFvho,6625
+datalex_core/generators.py,sha256=EJmPu3Iq4j5pkzmfda1vVF03IGFYaLm7kcbqAOfMobo,18227
+datalex_core/importers.py,sha256=-KqDhMALeYuxH6nw9QnZqNjtXbwuTY3VfuTMKrESZJE,45548
+datalex_core/issues.py,sha256=TB6O7vb3U93g8O8J46k53eYDERyykCdKO8UOm3uVvbY,513
+datalex_core/loader.py,sha256=EXYAyL5WXo0LrmRHSJc9BlMXxd11Kc-E2z17QEotiVI,511
+datalex_core/migrate.py,sha256=zWj9ULWi4G_e6yXzj9IzBfJ8AhXNO5VlPlVlNnkmEgY,11504
+datalex_core/modeling.py,sha256=KXpQpYG3RxFxz8hjkV4nif0EOIgD_riLGwLhWv1GKHo,30440
+datalex_core/packages.py,sha256=pBquIQ5wDMLCcQyhhuZPRQeP4-rJQY_uQ1f3jPpb-JA,15395
+datalex_core/policy.py,sha256=5JFLEGVr-oxyhrbf8lVXW7S9H7jfMchy92NgXb2yeDs,39353
+datalex_core/resolver.py,sha256=9JB5pcRSGyFSlb0aQ3wUCH3veGMNf3lsf1P_1KzZgFA,16700
+datalex_core/schema.py,sha256=5_PtKpy-RyRIx2FElhaUOj7kYsoW8WMgkbPh9R_vlhs,1617
+datalex_core/semantic.py,sha256=ieJkBWMzRzwLkTvPzwXGjChPlh34T8P4vUIGOS_Nilc,67109
+datalex_core/_schemas/datalex/common.schema.json,sha256=neC1dYqtFSW_ZzeZDQfzbTUDOVnIm5xLAvND-sRiaeU,4630
+datalex_core/_schemas/datalex/domain.schema.json,sha256=V4gAumfkJ1b8GFnPBuCMmcGeeE1TbhfSLmdLdCJ346s,796
+datalex_core/_schemas/datalex/entity.schema.json,sha256=zg2-iebC7C61mLQ1iXJhUyGUo9oT0KrQSko8RwH8Oco,5566
+datalex_core/_schemas/datalex/model.schema.json,sha256=aWMKplIamn9bScnrWhp_m1HER91xzGhOjLNwmmvxM_o,4692
+datalex_core/_schemas/datalex/policy.schema.json,sha256=Q_3GvKaagLoM0dfmz5GLcDI7Of0_6SjDQL-Vy-FajdE,2156
+datalex_core/_schemas/datalex/project.schema.json,sha256=p1k56c44rbcnW9A4Envj8-uRiI78LaZy_oejhct_P7E,2971
+datalex_core/_schemas/datalex/snippet.schema.json,sha256=49fdpbJrTqE8iKNhuX83YDzQCr46IGZBLMMFdRGc0Tg,943
+datalex_core/_schemas/datalex/source.schema.json,sha256=HNG5M6PON8IJ9k8dVbk4LOLLD0Iiwvmo4JP_Nd0nxUo,3467
+datalex_core/_schemas/datalex/term.schema.json,sha256=3Fl4jQm1qt0jlwziMlqpRb_8oQj_PQFR3Met8BenxNs,1036
+datalex_core/connectors/__init__.py,sha256=703nvPpu7qvGSIqEiawPVXU601fsYmd9mazVmgqMt3E,1232
+datalex_core/connectors/base.py,sha256=hMcVw4JhEeqWJqkXz2NcHMZ9jhkCDDS3FSX_fILSjys,13845
+datalex_core/connectors/bigquery.py,sha256=CNLQHphq2-KpuExQLlrx4zSQc9hF9XVZoqnVxKkKaiE,9051
+datalex_core/connectors/databricks.py,sha256=iXEG6zwt3X2d1RUKhUVCSng9rSylOyKdwcFDVZ97G90,10812
+datalex_core/connectors/mysql.py,sha256=qu61bsBxYm_MuhtJbUMRSUphD1_fHZNqrPheC8k1eVA,9683
+datalex_core/connectors/postgres.py,sha256=TM3Mz-SKHrMXs3OYeeQc-syDZhZU22TR4VLs3vobNQQ,11717
+datalex_core/connectors/redshift.py,sha256=SDGkWZK5SWIQ2_eqSvI4r7FUSg4S-uEcSPE8zJrBMGY,10896
+datalex_core/connectors/snowflake.py,sha256=fNCzGvq7zpqK5ERHuB1RUGnwlnRrAFLHpGu-9LAR71A,13289
+datalex_core/connectors/sqlserver.py,sha256=8lvX_KyvniLnnvF3-CKDQ7-1BvdS1WDLQP63cwa4eVw,15129
+datalex_core/datalex/__init__.py,sha256=8pdvFW6nJhY-Y3zrddEeau6bS0cMfbFG8ttxrvUY-uQ,897
+datalex_core/datalex/diff.py,sha256=xmP0lqYq1jrnwzJSndP4CKzadnEljWktFe0WgTc9aGI,7378
+datalex_core/datalex/errors.py,sha256=v7JkGfoPFIP9uBICJr0-stU5SdS3pZceu02FIv4nB0s,2681
+datalex_core/datalex/loader.py,sha256=CEFVjjnZePiFblgKI-9my4ywLXXuvs6oIX-cLA8e3D4,18740
+datalex_core/datalex/migrate_layout.py,sha256=kmcT_DGnLqCQV79C75EkmxvMJovCuj00DT6t-UK-F98,14079
+datalex_core/datalex/parse_cache.py,sha256=XeIqaN9FThPD4bKzowfCJyn1kX2Ek82Yi3HdGKiTYQ0,3667
+datalex_core/datalex/project.py,sha256=fR5H8kaZDKFjeUesAQv7f9Jubvn1id1O0ILYdNuwISc,9164
+datalex_core/datalex/types.py,sha256=uf9gryUUzPU91T1RUHNAFdtD1Q3dKI7jvn_InM0GHHk,7375
+datalex_core/dbt/__init__.py,sha256=jrmcaq3k7LtjPtPJcHqiB_qgZlji-gwbAIPXEuQ5uvs,592
+datalex_core/dbt/emit.py,sha256=iFtgWTCPTvHXb9Arie1-VSaHIGGmSUxtX7hvBAjMSac,11490
+datalex_core/dbt/manifest.py,sha256=x1PfYFya4DtiPws9xwo3pBBN4L7m3Bpf1mfwiSMBuZo,11363
+datalex_core/dbt/profiles.py,sha256=5CacRX8lohl3ay35g32glrwoWqW9Atk6KUSYL7KQ9j0,6097
+datalex_core/dbt/sync.py,sha256=AIqsi_pIQcPLXSfCmEqoIAwYaXjYBymQYfCeIv_jBys,9416
+datalex_core/dbt/warehouse.py,sha256=5j9SatDOBp-gKr2q2ltWzKugVQ_TLfzZ-5NXq2uPxWg,6350
+datalex_core/dialects/__init__.py,sha256=ierJOZ0q13Q8wBuB04IR0dUEjJL2iJPorKdZFMWv2AA,623
+datalex_core/dialects/_common.py,sha256=klZ3XPOCPJtjcRfXOEZCfYkvtxLJspeWBCHh-oEkqRk,1510
+datalex_core/dialects/base.py,sha256=r2AXVmulk3XZxZY9v0TzB7owIdukfHgD6IMDLylZ62E,1673
+datalex_core/dialects/postgres.py,sha256=Zj3PoAvMY7V9AQt-Ea6EuU-mcGMXxig2XyweeAZh7oE,5836
+datalex_core/dialects/registry.py,sha256=143fLrdgu7we_hRfbELJopEp_Pz5gF1xfgN7XPtk4a8,916
+datalex_core/dialects/snowflake.py,sha256=P0aQA_W0HnOcvbadPvAWMOlExIo0M283KkIZKmaj2tU,4300
+datalex_cli-0.1.1.dist-info/METADATA,sha256=2FFHrsXgQLDK_3BYgUXpHhy-emgYG8ulsi-r6OstH_A,8806
+datalex_cli-0.1.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+datalex_cli-0.1.1.dist-info/entry_points.txt,sha256=ZmyuOFbananx8g9s9EFJgjbos_QIivlOiJSBexkpB8E,50
+datalex_cli-0.1.1.dist-info/top_level.txt,sha256=_QSh6m7EKJoUOs-6rpwUgNXwrbv0l5gMq_fF2skrtZw,25
+datalex_cli-0.1.1.dist-info/RECORD,,

datalex_cli-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

datalex_cli-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+datalex = datalex_cli.main:main

datalex_cli-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 duckcode.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

datalex_cli-0.1.1.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+datalex_cli
+datalex_core

datalex_core/__init__.py

@@ -0,0 +1,94 @@
+from datalex_core.canonical import compile_model
+from datalex_core.diffing import project_diff, semantic_diff
+from datalex_core.docs_generator import (
+    generate_changelog,
+    generate_html_docs,
+    generate_markdown_docs,
+    write_changelog,
+    write_html_docs,
+    write_markdown_docs,
+)
+from datalex_core.completion import generate_bash_completion, generate_fish_completion, generate_zsh_completion
+from datalex_core.doctor import diagnostics_as_json, format_diagnostics, run_diagnostics
+from datalex_core.generators import dbt_scaffold_files, generate_sql_ddl, write_dbt_scaffold
+from datalex_core.migrate import generate_migration, write_migration
+from datalex_core.modeling import (
+    apply_standards_fixes,
+    merge_models_preserving_docs,
+    normalize_model,
+    standards_issues,
+    transform_model,
+)
+from datalex_core.importers import (
+    import_dbt_schema_yml,
+    import_dbml,
+    import_spark_schema,
+    import_sql_ddl,
+    sync_dbt_schema_yml,
+)
+from datalex_core.connectors.base import ConnectorConfig, ConnectorResult, get_connector, list_connectors
+from datalex_core.loader import load_yaml_model
+from datalex_core.policy import (
+    load_policy_pack,
+    load_policy_pack_with_inheritance,
+    merge_policy_packs,
+    policy_issues,
+)
+from datalex_core.resolver import resolve_model, resolve_project
+from datalex_core.schema import load_schema, schema_issues
+from datalex_core.semantic import (
+    completeness_as_dict,
+    completeness_report,
+    lint_issues,
+    EntityCompleteness,
+    ModelCompleteness,
+)
+
+__all__ = [
+    "compile_model",
+    "completeness_as_dict",
+    "completeness_report",
+    "ConnectorConfig",
+    "ConnectorResult",
+    "dbt_scaffold_files",
+    "diagnostics_as_json",
+    "EntityCompleteness",
+    "format_diagnostics",
+    "generate_bash_completion",
+    "generate_fish_completion",
+    "generate_migration",
+    "generate_changelog",
+    "generate_html_docs",
+    "generate_markdown_docs",
+    "generate_sql_ddl",
+    "generate_zsh_completion",
+    "import_dbml",
+    "import_dbt_schema_yml",
+    "import_spark_schema",
+    "import_sql_ddl",
+    "lint_issues",
+    "load_policy_pack",
+    "load_policy_pack_with_inheritance",
+    "merge_policy_packs",
+    "merge_models_preserving_docs",
+    "load_schema",
+    "load_yaml_model",
+    "ModelCompleteness",
+    "normalize_model",
+    "policy_issues",
+    "project_diff",
+    "resolve_model",
+    "resolve_project",
+    "apply_standards_fixes",
+    "schema_issues",
+    "semantic_diff",
+    "standards_issues",
+    "transform_model",
+    "run_diagnostics",
+    "write_changelog",
+    "write_dbt_scaffold",
+    "write_migration",
+    "write_html_docs",
+    "write_markdown_docs",
+    "sync_dbt_schema_yml",
+]

datalex_core/_schemas/datalex/common.schema.json

@@ -0,0 +1,127 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://duckcode.dev/schemas/datalex/common.schema.json",
+  "title": "DataLex common definitions",
+  "$defs": {
+    "snake_name": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*$"
+    },
+    "kebab_tag": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "meta": {
+      "type": "object",
+      "description": "User-owned metadata. DataLex generators MUST NOT write outside the meta.datalex.* subtree.",
+      "additionalProperties": true
+    },
+    "tags": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/kebab_tag" }
+    },
+    "owner": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string"
+    },
+    "previous_name": {
+      "description": "Explicit rename tracking. If present, diff treats (previous_name -> name) as a rename, not drop+add.",
+      "$ref": "#/$defs/snake_name"
+    },
+    "logical_type": {
+      "type": "string",
+      "description": "Logical type: primitive (string, integer, bigint, decimal(p,s), float, boolean, date, timestamp, timestamp_tz, interval, uuid, json, binary, text) or composite (array<T>, map<K,V>, struct<a:T,b:U>).",
+      "minLength": 1
+    },
+    "physical_override": {
+      "type": "object",
+      "description": "Per-dialect physical type override for a column.",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "type": { "type": "string" },
+          "raw_ddl": { "type": "string" }
+        }
+      }
+    },
+    "constraint": {
+      "type": "object",
+      "required": ["type"],
+      "additionalProperties": true,
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["check", "not_null", "unique", "primary_key", "foreign_key"]
+        },
+        "expression": { "type": "string" }
+      }
+    },
+    "reference": {
+      "type": "object",
+      "required": ["entity", "column"],
+      "additionalProperties": false,
+      "properties": {
+        "entity": { "$ref": "#/$defs/snake_name" },
+        "column": { "$ref": "#/$defs/snake_name" },
+        "on_delete": { "type": "string", "enum": ["restrict", "cascade", "set_null", "no_action"] },
+        "on_update": { "type": "string", "enum": ["restrict", "cascade", "set_null", "no_action"] },
+        "relationship": { "type": "string", "enum": ["many_to_one", "one_to_one", "many_to_many"] }
+      }
+    },
+    "column": {
+      "type": "object",
+      "required": ["name", "type"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "$ref": "#/$defs/snake_name" },
+        "previous_name": { "$ref": "#/$defs/previous_name" },
+        "type": { "$ref": "#/$defs/logical_type" },
+        "physical": { "$ref": "#/$defs/physical_override" },
+        "logical": {
+          "type": "string",
+          "description": "Back-reference to the logical column this physical column implements, e.g. 'order.id'."
+        },
+        "description": { "$ref": "#/$defs/description" },
+        "nullable": { "type": "boolean", "default": true },
+        "primary_key": { "type": "boolean", "default": false },
+        "unique": { "type": "boolean", "default": false },
+        "default": { "type": ["string", "number", "boolean", "null"] },
+        "references": { "$ref": "#/$defs/reference" },
+        "constraints": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/constraint" }
+        },
+        "sensitivity": {
+          "type": "string",
+          "description": "Sensitivity tag. Must be defined in .datalex/sensitivity.yaml (free-form; validator checks membership if the file exists)."
+        },
+        "terms": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^(term:)?[a-z][a-z0-9_]*$"
+          }
+        },
+        "tags": { "$ref": "#/$defs/tags" },
+        "use": {
+          "description": "Name of a snippet under .datalex/snippets/ to merge into this column (merge semantics: snippet fields fill in missing keys; column keys win on conflict).",
+          "$ref": "#/$defs/snake_name"
+        },
+        "examples": {
+          "type": "array",
+          "items": { "type": ["string", "number", "boolean", "null"] }
+        },
+        "deprecated": { "type": "boolean" },
+        "meta": { "$ref": "#/$defs/meta" }
+      }
+    },
+    "raw_ddl": {
+      "type": "string",
+      "description": "Original DDL preserved from reverse engineering when a feature couldn't be mapped cleanly. Forward engineering replays this verbatim."
+    }
+  }
+}

datalex_core/_schemas/datalex/domain.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://duckcode.dev/schemas/datalex/domain.schema.json",
+  "title": "DataLex domain (subject-area grouping)",
+  "type": "object",
+  "required": ["kind", "name"],
+  "additionalProperties": false,
+  "properties": {
+    "kind": { "const": "domain" },
+    "name": { "type": "string", "pattern": "^[a-z][a-z0-9_]*$" },
+    "description": { "type": "string" },
+    "owner": { "type": "string" },
+    "color": { "type": "string" },
+    "entities": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9_]*$" }
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" }
+    },
+    "meta": { "type": "object", "additionalProperties": true }
+  }
+}