contractforge-core 0.1.0__tar.gz → 0.2.0__tar.gz

{contractforge_core-0.1.0 → contractforge_core-0.2.0}/.gitignore

@@ -8,6 +8,7 @@ __pycache__/
 .tmp/
 dist/
 build/
+test-runs/
 *.egg
 .coverage
 .coverage.*
@@ -16,3 +17,13 @@ htmlcov/
 .env
 .env.*
 !.env.example
+api-key-*.txt
+
+# Local agent/tooling state; never publish these.
+.claude/
+.codex/
+.agents/
+.vscode/
+AGENTS.md
+RTK.md
+tools/rtk.ps1

contractforge_core-0.2.0/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to `contractforge-core` are documented in this file.
+
+The format follows Keep a Changelog, and this package follows semantic
+versioning as described in `docs/specs/api-stability.md`.
+
+## [0.2.0] - 2026-06-19
+
+### Added
+
+- Promoted the public package set for the current ContractForge maturity
+  baseline across core, Databricks, AWS, Snowflake, Fabric, GCP and AI.
+- Added project and connection semantics used by the cross-platform test
+  projects, including reusable source defaults and environment-specific
+  bindings.
+- Added stable writer aliases for contract authoring: `append`, `overwrite`,
+  `upsert`, `hash_diff_upsert`, `historical` and
+  `snapshot_reconcile_soft_delete`.
+
+### Changed
+
+- Updated packaging and release metadata for the independent PyPI
+  distributions.
+- Kept adapter-specific behavior outside the core package while aligning the
+  core validation boundary with the current adapter surfaces.
+
+## [0.1.0] - 2026-06-08
+
+### Added
+
+- Initial public preview release of the platform-neutral ContractForge core.
+- Semantic contract models, project parsing, capability matching, planning,
+  source connector catalog, evidence models and the `contractforge` CLI.

{contractforge_core-0.1.0 → contractforge_core-0.2.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: contractforge-core
-Version: 0.1.0
+Version: 0.2.0
 Summary: Platform-neutral semantic core for contract-first data ingestion.
-Project-URL: Homepage, https://github.com/marquesantero/contractforge-core
-Project-URL: Documentation, https://marquesantero.github.io/contractforge-core/
-Project-URL: Repository, https://github.com/marquesantero/contractforge-core
-Project-URL: Issues, https://github.com/marquesantero/contractforge-core/issues
-Project-URL: Changelog, https://github.com/marquesantero/contractforge-core/blob/main/CHANGELOG.md
+Project-URL: Homepage, https://github.com/marquesantero/contractforge
+Project-URL: Documentation, https://marquesantero.github.io/contractforge/
+Project-URL: Repository, https://github.com/marquesantero/contractforge
+Project-URL: Issues, https://github.com/marquesantero/contractforge/issues
+Project-URL: Changelog, https://github.com/marquesantero/contractforge/blob/main/CHANGELOG.md
 Author: ContractForge contributors
 License: MIT
 License-File: LICENSE
@@ -38,19 +38,18 @@ Description-Content-Type: text/markdown
 **Define ingestion intent once. Run it natively anywhere.**
 
 <p align="center">
-  <a href="https://github.com/marquesantero/contractforge-core/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/marquesantero/contractforge-core/actions/workflows/ci.yml/badge.svg"></a>
-  <a href="https://github.com/marquesantero/contractforge-core"><img alt="Product" src="https://img.shields.io/badge/product-ContractForge-0B5FFF"></a>
-  <a href="https://marquesantero.github.io/contractforge-core/"><img alt="Documentation" src="https://img.shields.io/badge/docs-online-2EA44F"></a>
-  <a href="https://github.com/marquesantero/contractforge-core/tree/main/src/contractforge_core"><img alt="Core" src="https://img.shields.io/badge/core-contractforge--core-1F6FEB"></a>
-  <a href="https://github.com/marquesantero/contractforge-core/tree/main/adapters/databricks"><img alt="Databricks adapter" src="https://img.shields.io/badge/adapter-databricks-FF7A00"></a>
-  <a href="https://github.com/marquesantero/contractforge-core/tree/main/adapters/aws"><img alt="AWS adapter" src="https://img.shields.io/badge/adapter-aws-232F3E"></a>
-  <a href="https://github.com/marquesantero/contractforge-core/tree/main/ai"><img alt="ContractForge AI" src="https://img.shields.io/badge/ai-contractforge--ai-7B3FE4"></a>
+  <a href="https://github.com/marquesantero/contractforge/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/marquesantero/contractforge/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://github.com/marquesantero/contractforge/actions/workflows/release.yml"><img alt="Release" src="https://github.com/marquesantero/contractforge/actions/workflows/release.yml/badge.svg"></a>
+  <a href="https://github.com/marquesantero/contractforge"><img alt="Product" src="https://img.shields.io/badge/product-ContractForge-0B5FFF"></a>
+  <a href="https://marquesantero.github.io/contractforge/"><img alt="Documentation" src="https://img.shields.io/badge/docs-online-2EA44F"></a>
+  <a href="https://github.com/marquesantero/contractforge/tree/main/src/contractforge_core"><img alt="Core" src="https://img.shields.io/badge/core-contractforge--core-1F6FEB"></a>
+  <a href="https://github.com/marquesantero/contractforge/tree/main/ai"><img alt="ContractForge AI" src="https://img.shields.io/badge/ai-contractforge--ai-7B3FE4"></a>
   <img alt="Python" src="https://img.shields.io/badge/python-%3E%3D3.10-blue">
-  <a href="LICENSE"><img alt="License" src="https://img.shields.io/github/license/marquesantero/contractforge-core"></a>
+  <a href="LICENSE"><img alt="License" src="https://img.shields.io/github/license/marquesantero/contractforge"></a>
 </p>
 
 <p align="center">
-  <a href="https://marquesantero.github.io/contractforge-core/">Documentation</a>
+  <a href="https://marquesantero.github.io/contractforge/">Documentation</a>
   ·
   <a href="docs/quickstart.md">Quick Start</a>
   ·
@@ -61,14 +60,19 @@ Description-Content-Type: text/markdown
   <a href="docs/roadmap.md">Roadmap</a>
 </p>
 
+**Covered platforms:** Databricks, AWS Glue/Iceberg, Snowflake, Microsoft Fabric
+Lakehouse and Google Cloud BigQuery. The adapters are separate packages, but
+they execute the same contract vocabulary through native platform behavior.
+
 ContractForge is a multi-runtime, contract-first ingestion platform. It turns
 governed ingestion intent into native platform execution and evidence while
-keeping the contract vocabulary stable across Databricks, AWS and future
-adapters.
+keeping the contract vocabulary stable across Databricks, AWS, Snowflake,
+Fabric and GCP.
 
-The product remains **ContractForge**. `contractforge-core`,
-`contractforge-databricks`, `contractforge-aws` and `contractforge-ai` are
-functional package boundaries, not separate products.
+`contractforge-core`, `contractforge-databricks`, `contractforge-aws`,
+`contractforge-fabric`, `contractforge-snowflake`, `contractforge-gcp` and
+`contractforge-ai` are functional package boundaries that keep platform
+dependencies isolated while preserving the same contract language.
 
 It is built for data consultants, platform teams and engineering groups that
 need repeatable governed ingestion across different client runtimes without
@@ -84,15 +88,11 @@ rewriting the framework for every platform.
 | --- | --- |
 | Contract-first ingestion | Source, target, write mode, schema policy, transforms, quality, access, operations and evidence live in reviewed YAML contracts. |
 | Honest portability | The planner returns `SUPPORTED`, `SUPPORTED_WITH_WARNINGS`, `REVIEW_REQUIRED` or `UNSUPPORTED`; it does not silently downgrade semantics. |
-| Native adapters | Databricks and AWS translate the same intent into native runtime behavior instead of forcing a lowest-common-denominator engine. |
+| Native adapters | Databricks, AWS, Snowflake, Fabric and GCP translate the same intent into native runtime behavior instead of forcing a lowest-common-denominator engine. |
 | Evidence as product surface | Runs, errors, quality, quarantine, schema changes, lineage, governance actions and cost signals are tracked consistently. |
 | Reusable connections | Shared `connection.yaml` files centralize connector defaults; ingestion contracts override only dataset-specific fields. |
 | AI-assisted project design | ContractForge AI turns prompts and schemas into reviewable projects, then validates them through Core and adapter planners. |
 
-ContractForge is not a scheduler, a dbt replacement, a closed ingestion runtime
-or a universal Spark wrapper. It is the semantic contract and adapter layer for
-repeatable governed ingestion.
-
 ## How It Works
 
 ```text
@@ -120,7 +120,7 @@ target:
   schema: bronze
   table: orders
 
-mode: scd0_append
+mode: append
 schema_policy: additive_only
 quality_rules:
   not_null: [order_id]
@@ -143,32 +143,26 @@ cannot preserve the same semantics safely.
 | --- | --- | --- |
 | Core semantic model | Active | Contract models, semantic normalization, capability matching, abstract planning and evidence models are implemented. |
 | Databricks adapter | Reference implementation | Delta, Unity Catalog, Auto Loader, Lakeflow planning, Asset Bundles, control tables, quality, governance, lineage, cost and dashboards are implemented inside the adapter boundary. |
-| AWS adapter | Alpha with real E2E validation | Glue Spark/Iceberg planning, source support, quality/evidence, Lake Formation review/apply helpers, annotations, operations, S3 artifact publication, one-command Glue deployment and Glue job helper APIs are implemented. |
+| AWS adapter | Stable supported surface | Glue Spark/Iceberg planning, source support, quality/evidence, Lake Formation review/apply helpers, annotations, operations, S3 artifact publication, one-command Glue deployment, orchestration, cost reconciliation and Glue job helper APIs are validated for the documented `aws_glue_iceberg` surface. |
 | ContractForge AI | Active | Deterministic review, project generation, diagnostics, provider routing and optional model-backed enrichment over the same core contract semantics. |
-| Snowflake adapter | Alpha with real Snowflake validation | SQL warehouse runtime, hosted Snowpark procedure library runner, table/staged-file/SQL sources, write modes, quality, schema policy, governance, evidence, lineage and cost reconciliation are implemented and live-smoked. |
-| Fabric adapter | Planned | Future adapters must depend on the core and declare platform capabilities explicitly. |
+| Snowflake adapter | Stable supported surface | SQL warehouse runtime, hosted Snowpark procedure library runner, table/SQL/bounded REST/staged-file sources, write modes, quality, schema policy, governance, evidence, lineage and cost reconciliation are validated for the documented `snowflake_sql_warehouse` surface. |
+| Fabric adapter | Stable supported surface | Notebook-first Lakehouse execution, broad source expansion, core write modes, evidence, governance review/apply helpers and deployment promotion are validated for the documented `fabric_lakehouse` surface. |
+| GCP adapter | Stable supported surface | BigQuery table/view/SQL sources, GCS load jobs, registered BigLake Iceberg reads, append/overwrite/explicit-column upsert, SQL quality, evidence, row policies, direct masking, policy tags and descriptions are validated for the documented `gcp_bigquery` surface. |
 
 See [roadmap](docs/roadmap.md) for adapter maturity and release criteria.
 
-## Compared With Alternatives
-
-| Alternative | Difference |
-| --- | --- |
-| dbt | dbt models data after it lands. ContractForge defines how governed data arrives, is written, validated and evidenced. |
-| Airbyte/Fivetran | They provide managed ingestion runtimes. ContractForge provides the contract and lets adapters execute natively in your platform. |
-| Data contract tools | Validation is one slice. ContractForge covers source, write semantics, schema policy, quality, governance, evidence and native execution artifacts. |
-| Platform-specific frameworks | ContractForge keeps platform implementations in adapters so the same semantics can be evaluated for other runtimes. |
-
 ## Install
 
 From GitHub:
 
 ```bash
-pip install "git+https://github.com/marquesantero/contractforge-core.git"
-pip install "git+https://github.com/marquesantero/contractforge-core.git#subdirectory=adapters/databricks"
-pip install "git+https://github.com/marquesantero/contractforge-core.git#subdirectory=adapters/aws"
-pip install "git+https://github.com/marquesantero/contractforge-core.git#subdirectory=adapters/snowflake"
-pip install "git+https://github.com/marquesantero/contractforge-core.git#subdirectory=ai"
+pip install "git+https://github.com/marquesantero/contractforge.git"
+pip install "git+https://github.com/marquesantero/contractforge.git#subdirectory=adapters/databricks"
+pip install "git+https://github.com/marquesantero/contractforge.git#subdirectory=adapters/aws"
+pip install "git+https://github.com/marquesantero/contractforge.git#subdirectory=adapters/fabric"
+pip install "git+https://github.com/marquesantero/contractforge.git#subdirectory=adapters/snowflake"
+pip install "git+https://github.com/marquesantero/contractforge.git#subdirectory=adapters/gcp"
+pip install "git+https://github.com/marquesantero/contractforge.git#subdirectory=ai"
 ```
 
 Local development:
@@ -185,15 +179,51 @@ uv build --wheel
 cd adapters/databricks && uv build --wheel
 cd ../aws && uv build --wheel
 cd ../snowflake && uv build --wheel
+cd ../fabric && uv build --wheel
+cd ../gcp && uv build --wheel
 cd ../../ai && uv build --wheel
 ```
 
 Release package names:
 
 ```bash
-pip install contractforge-core contractforge-databricks contractforge-aws contractforge-snowflake contractforge-ai
+pip install contractforge-core contractforge-databricks contractforge-aws contractforge-snowflake contractforge-fabric contractforge-gcp contractforge-ai
 ```
 
+## Packages And Releases
+
+ContractForge is published as independent PyPI packages from one repository.
+The package boundary is intentional: the core stays platform-neutral, while
+adapters carry native runtime dependencies and behavior.
+
+| Package | Current version | PyPI | Source |
+| --- | --- | --- | --- |
+| `contractforge-core` | `0.2.0` | [PyPI](https://pypi.org/project/contractforge-core/) | [core](src/contractforge_core) |
+| `contractforge-databricks` | `0.2.0` | [PyPI](https://pypi.org/project/contractforge-databricks/) | [adapter](adapters/databricks) |
+| `contractforge-aws` | `0.2.0` | [PyPI](https://pypi.org/project/contractforge-aws/) | [adapter](adapters/aws) |
+| `contractforge-snowflake` | `0.2.0` | [PyPI](https://pypi.org/project/contractforge-snowflake/) | [adapter](adapters/snowflake) |
+| `contractforge-fabric` | `0.2.0` | [PyPI](https://pypi.org/project/contractforge-fabric/) | [adapter](adapters/fabric) |
+| `contractforge-gcp` | `0.2.0` | [PyPI](https://pypi.org/project/contractforge-gcp/) | [adapter](adapters/gcp) |
+| `contractforge-ai` | `0.3.0` | [PyPI](https://pypi.org/project/contractforge-ai/) | [AI companion](ai) |
+
+Releases are built by [`.github/workflows/release.yml`](.github/workflows/release.yml).
+The workflow can be started manually with `workflow_dispatch` for one package,
+or by pushing package-specific tags:
+
+```text
+v<version>-core
+v<version>-databricks
+v<version>-aws
+v<version>-snowflake
+v<version>-fabric
+v<version>-gcp
+v<version>-ai
+```
+
+PyPI does not allow overwriting an existing version. Before publishing from this
+repository, bump the target package version and publish a new tag or manual
+release workflow run.
+
 ## Project Shape
 
 A complete ContractForge project keeps runtime concerns separate from contract
@@ -252,9 +282,10 @@ values override global connection defaults.
 | Adapter | Package | Status | Native responsibilities |
 | --- | --- | --- | --- |
 | Databricks | `contractforge-databricks` | Reference implementation | Delta, Unity Catalog, Auto Loader, Lakeflow planning, Jobs, Asset Bundles, control tables, governance, lineage, cost and dashboards. |
-| AWS | `contractforge-aws` | Alpha with real E2E validation | Glue Spark, Iceberg, Glue Catalog, Lake Formation review/apply helpers, S3 artifacts, Glue jobs, Athena/Iceberg evidence and cost records. |
-| Fabric | `contractforge-fabric` | Planned | OneLake, Lakehouse tables, Data Pipelines, Dataflow Gen2 and Purview/Fabric metadata. |
-| Snowflake | `contractforge-snowflake` | Alpha with real Snowflake validation | SQL warehouse runtime, hosted Snowpark procedure library runner with staged ZIP imports, table/staged-file/SQL sources, append/overwrite/upsert/hash-diff writes, quality, schema policy, governance, evidence/control tables, lineage, cost reconciliation and project deployment. Task graph live smoke still needs task grants. See [Snowflake adapter guide](docs/adapters/snowflake.md). |
+| AWS | `contractforge-aws` | Stable supported surface | Glue Spark, Iceberg, Glue Catalog, Lake Formation review/apply helpers, S3 artifacts, Glue jobs, Athena/Iceberg evidence and cost records for the documented `aws_glue_iceberg` surface. |
+| Fabric | `contractforge-fabric` | Stable supported surface | Notebook-first Lakehouse execution, Lakehouse Delta writes, source expansion, shortcut reads, Kafka catch-up, core write modes, control evidence, workspace roles, sensitivity labels and OneLake data access role apply helpers for the documented `fabric_lakehouse` surface. |
+| Snowflake | `contractforge-snowflake` | Stable supported surface | SQL warehouse runtime, hosted Snowpark procedure library runner with staged ZIP imports, table/SQL/bounded REST/staged-file sources, append/overwrite/upsert/hash-diff writes, quality, schema policy, governance, evidence/control tables, lineage, cost reconciliation and project deployment for the documented `snowflake_sql_warehouse` surface. Task graph live execution still needs task grants. See [Snowflake adapter guide](docs/adapters/snowflake.md). |
+| GCP | `contractforge-gcp` | Stable supported surface | BigQuery table/view/SQL sources, GCS load jobs, BigLake Iceberg table reads, core writes, SQL quality, evidence tables, row access policies, masking, policy tags and descriptions for the documented `gcp_bigquery` surface. |
 
 Use the same project model for adapter deployment:
 
@@ -271,7 +302,7 @@ planning and produce clear HTML approval reports.
 
 ```bash
 contractforge-ai guided-project \
-  --intent "Create a Supabase medallion project for AWS and Databricks daily at 6 Sao Paulo time." \
+  --intent "Create a Supabase medallion project for Databricks, AWS, Snowflake, Fabric and GCP daily at 6 Sao Paulo time." \
   --schema schemas/products.json \
   --target contractforge-yaml \
   --allow-review-required \
@@ -280,6 +311,9 @@ contractforge-ai guided-project \
 contractforge-ai validate-project-structure generated/supabase \
   --adapter databricks \
   --adapter aws \
+  --adapter snowflake \
+  --adapter fabric \
+  --adapter gcp \
   --format html > generated/supabase/project_validation.html
 ```
 
@@ -298,7 +332,7 @@ contract = validate_contract(
     {
         "source": {"type": "incremental_files", "path": "s3://landing/orders", "format": "json"},
         "target": {"catalog": "main", "schema": "bronze", "table": "orders"},
-        "mode": "scd0_append",
+        "mode": "append",
         "schema_policy": "additive_only",
         "quality_rules": {"not_null": ["order_id"]},
     }
@@ -324,9 +358,12 @@ print(result.status)
 | Semantic core | `contractforge-core` | Contract models, validation, semantic normalization, capability matching, abstract plans, portability diagnostics and neutral evidence models. |
 | Databricks adapter | `contractforge-databricks` | Databricks capabilities, rendering, runtime execution, governance, evidence filling and deployment helpers. |
 | AWS adapter | `contractforge-aws` | AWS capabilities, Glue/Iceberg planning, runtime helpers, S3 publication, deployment helpers and evidence filling. |
+| Fabric adapter | `contractforge-fabric` | Fabric Lakehouse capabilities, Notebook rendering/execution, source expansion, governance apply helpers and deployment promotion. |
+| Snowflake adapter | `contractforge-snowflake` | Snowflake SQL warehouse capabilities, hosted procedure runtime, task graph execution, governance, lineage, cost and evidence filling. |
+| GCP adapter | `contractforge-gcp` | BigQuery capabilities, GCS load-job rendering, smoke execution, evidence DDL, governance smokes and BigLake Iceberg table support. |
 | AI companion | `contractforge-ai` | Deterministic review, project generation, diagnostics, provider routing, report generation and optional model-backed enrichment. |
 
-Publication stays split: each package builds its own wheel and future adapters
+Publication stays split: each package builds its own wheel and all adapters
 depend explicitly on `contractforge-core`.
 
 The core wheel owns only `contractforge_core`; adapter wheels such as `contractforge-databricks` own their adapter package and depend explicitly on the core.
@@ -337,7 +374,7 @@ See [publication packaging](docs/specs/publication-packaging.md).
 
 | Topic | Link |
 | --- | --- |
-| Online site | [marquesantero.github.io/contractforge-core](https://marquesantero.github.io/contractforge-core/) |
+| Online site | [marquesantero.github.io/contractforge](https://marquesantero.github.io/contractforge/) |
 | Documentation index | [docs/README.md](docs/README.md) |
 | Quick start | [docs/quickstart.md](docs/quickstart.md) |
 | Architecture | [docs/architecture.md](docs/architecture.md) |
@@ -347,16 +384,30 @@ See [publication packaging](docs/specs/publication-packaging.md).
 | Adapters | [docs/adapters.md](docs/adapters.md) |
 | Databricks adapter | [docs/databricks.md](docs/databricks.md) |
 | AWS adapter | [docs/adapters/aws.md](docs/adapters/aws.md) |
+| Snowflake adapter | [docs/adapters/snowflake.md](docs/adapters/snowflake.md) |
 | Test contracts across adapters | [docs/adapters/test-contracts-across-adapters.md](docs/adapters/test-contracts-across-adapters.md) |
 | Connectors | [docs/connectors.md](docs/connectors.md) |
 | Operations and evidence | [docs/operations.md](docs/operations.md) |
 | ContractForge AI | [ai/README.md](ai/README.md) |
 | Security | [docs/security.md](docs/security.md) |
 | Adapter authoring | [docs/specs/adapter-authoring.md](docs/specs/adapter-authoring.md) |
+| Contributing | [CONTRIBUTING.md](CONTRIBUTING.md) |
+| Support | [SUPPORT.md](SUPPORT.md) |
+| Security policy | [SECURITY.md](SECURITY.md) |
 
 Architecture contracts live under [docs/specs](docs/specs/), and decisions live
 under [docs/adrs](docs/adrs/).
 
+## Contributing
+
+Contributions are welcome when they preserve the core/adapter boundary and keep
+contract behavior explicit. Start with [CONTRIBUTING.md](CONTRIBUTING.md), use
+the issue templates for bugs, features or adapter gaps, and follow
+[SECURITY.md](SECURITY.md) for private vulnerability reports. Changes flow
+through pull requests to the protected `main` branch with required CI and
+maintainer or CODEOWNER review when the change affects public behavior, release
+flow, security, package boundaries or adapter maturity.
+
 ## Non-Goals
 
 ContractForge is not:

{contractforge_core-0.1.0 → contractforge_core-0.2.0}/README.md

@@ -7,19 +7,18 @@
 **Define ingestion intent once. Run it natively anywhere.**
 
 <p align="center">
-  <a href="https://github.com/marquesantero/contractforge-core/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/marquesantero/contractforge-core/actions/workflows/ci.yml/badge.svg"></a>
-  <a href="https://github.com/marquesantero/contractforge-core"><img alt="Product" src="https://img.shields.io/badge/product-ContractForge-0B5FFF"></a>
-  <a href="https://marquesantero.github.io/contractforge-core/"><img alt="Documentation" src="https://img.shields.io/badge/docs-online-2EA44F"></a>
-  <a href="https://github.com/marquesantero/contractforge-core/tree/main/src/contractforge_core"><img alt="Core" src="https://img.shields.io/badge/core-contractforge--core-1F6FEB"></a>
-  <a href="https://github.com/marquesantero/contractforge-core/tree/main/adapters/databricks"><img alt="Databricks adapter" src="https://img.shields.io/badge/adapter-databricks-FF7A00"></a>
-  <a href="https://github.com/marquesantero/contractforge-core/tree/main/adapters/aws"><img alt="AWS adapter" src="https://img.shields.io/badge/adapter-aws-232F3E"></a>
-  <a href="https://github.com/marquesantero/contractforge-core/tree/main/ai"><img alt="ContractForge AI" src="https://img.shields.io/badge/ai-contractforge--ai-7B3FE4"></a>
+  <a href="https://github.com/marquesantero/contractforge/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/marquesantero/contractforge/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://github.com/marquesantero/contractforge/actions/workflows/release.yml"><img alt="Release" src="https://github.com/marquesantero/contractforge/actions/workflows/release.yml/badge.svg"></a>
+  <a href="https://github.com/marquesantero/contractforge"><img alt="Product" src="https://img.shields.io/badge/product-ContractForge-0B5FFF"></a>
+  <a href="https://marquesantero.github.io/contractforge/"><img alt="Documentation" src="https://img.shields.io/badge/docs-online-2EA44F"></a>
+  <a href="https://github.com/marquesantero/contractforge/tree/main/src/contractforge_core"><img alt="Core" src="https://img.shields.io/badge/core-contractforge--core-1F6FEB"></a>
+  <a href="https://github.com/marquesantero/contractforge/tree/main/ai"><img alt="ContractForge AI" src="https://img.shields.io/badge/ai-contractforge--ai-7B3FE4"></a>
   <img alt="Python" src="https://img.shields.io/badge/python-%3E%3D3.10-blue">
-  <a href="LICENSE"><img alt="License" src="https://img.shields.io/github/license/marquesantero/contractforge-core"></a>
+  <a href="LICENSE"><img alt="License" src="https://img.shields.io/github/license/marquesantero/contractforge"></a>
 </p>
 
 <p align="center">
-  <a href="https://marquesantero.github.io/contractforge-core/">Documentation</a>
+  <a href="https://marquesantero.github.io/contractforge/">Documentation</a>
   ·
   <a href="docs/quickstart.md">Quick Start</a>
   ·
@@ -30,14 +29,19 @@
   <a href="docs/roadmap.md">Roadmap</a>
 </p>
 
+**Covered platforms:** Databricks, AWS Glue/Iceberg, Snowflake, Microsoft Fabric
+Lakehouse and Google Cloud BigQuery. The adapters are separate packages, but
+they execute the same contract vocabulary through native platform behavior.
+
 ContractForge is a multi-runtime, contract-first ingestion platform. It turns
 governed ingestion intent into native platform execution and evidence while
-keeping the contract vocabulary stable across Databricks, AWS and future
-adapters.
+keeping the contract vocabulary stable across Databricks, AWS, Snowflake,
+Fabric and GCP.
 
-The product remains **ContractForge**. `contractforge-core`,
-`contractforge-databricks`, `contractforge-aws` and `contractforge-ai` are
-functional package boundaries, not separate products.
+`contractforge-core`, `contractforge-databricks`, `contractforge-aws`,
+`contractforge-fabric`, `contractforge-snowflake`, `contractforge-gcp` and
+`contractforge-ai` are functional package boundaries that keep platform
+dependencies isolated while preserving the same contract language.
 
 It is built for data consultants, platform teams and engineering groups that
 need repeatable governed ingestion across different client runtimes without
@@ -53,15 +57,11 @@ rewriting the framework for every platform.
 | --- | --- |
 | Contract-first ingestion | Source, target, write mode, schema policy, transforms, quality, access, operations and evidence live in reviewed YAML contracts. |
 | Honest portability | The planner returns `SUPPORTED`, `SUPPORTED_WITH_WARNINGS`, `REVIEW_REQUIRED` or `UNSUPPORTED`; it does not silently downgrade semantics. |
-| Native adapters | Databricks and AWS translate the same intent into native runtime behavior instead of forcing a lowest-common-denominator engine. |
+| Native adapters | Databricks, AWS, Snowflake, Fabric and GCP translate the same intent into native runtime behavior instead of forcing a lowest-common-denominator engine. |
 | Evidence as product surface | Runs, errors, quality, quarantine, schema changes, lineage, governance actions and cost signals are tracked consistently. |
 | Reusable connections | Shared `connection.yaml` files centralize connector defaults; ingestion contracts override only dataset-specific fields. |
 | AI-assisted project design | ContractForge AI turns prompts and schemas into reviewable projects, then validates them through Core and adapter planners. |
 
-ContractForge is not a scheduler, a dbt replacement, a closed ingestion runtime
-or a universal Spark wrapper. It is the semantic contract and adapter layer for
-repeatable governed ingestion.
-
 ## How It Works
 
 ```text
@@ -89,7 +89,7 @@ target:
   schema: bronze
   table: orders
 
-mode: scd0_append
+mode: append
 schema_policy: additive_only
 quality_rules:
   not_null: [order_id]
@@ -112,32 +112,26 @@ cannot preserve the same semantics safely.
 | --- | --- | --- |
 | Core semantic model | Active | Contract models, semantic normalization, capability matching, abstract planning and evidence models are implemented. |
 | Databricks adapter | Reference implementation | Delta, Unity Catalog, Auto Loader, Lakeflow planning, Asset Bundles, control tables, quality, governance, lineage, cost and dashboards are implemented inside the adapter boundary. |
-| AWS adapter | Alpha with real E2E validation | Glue Spark/Iceberg planning, source support, quality/evidence, Lake Formation review/apply helpers, annotations, operations, S3 artifact publication, one-command Glue deployment and Glue job helper APIs are implemented. |
+| AWS adapter | Stable supported surface | Glue Spark/Iceberg planning, source support, quality/evidence, Lake Formation review/apply helpers, annotations, operations, S3 artifact publication, one-command Glue deployment, orchestration, cost reconciliation and Glue job helper APIs are validated for the documented `aws_glue_iceberg` surface. |
 | ContractForge AI | Active | Deterministic review, project generation, diagnostics, provider routing and optional model-backed enrichment over the same core contract semantics. |
-| Snowflake adapter | Alpha with real Snowflake validation | SQL warehouse runtime, hosted Snowpark procedure library runner, table/staged-file/SQL sources, write modes, quality, schema policy, governance, evidence, lineage and cost reconciliation are implemented and live-smoked. |
-| Fabric adapter | Planned | Future adapters must depend on the core and declare platform capabilities explicitly. |
+| Snowflake adapter | Stable supported surface | SQL warehouse runtime, hosted Snowpark procedure library runner, table/SQL/bounded REST/staged-file sources, write modes, quality, schema policy, governance, evidence, lineage and cost reconciliation are validated for the documented `snowflake_sql_warehouse` surface. |
+| Fabric adapter | Stable supported surface | Notebook-first Lakehouse execution, broad source expansion, core write modes, evidence, governance review/apply helpers and deployment promotion are validated for the documented `fabric_lakehouse` surface. |
+| GCP adapter | Stable supported surface | BigQuery table/view/SQL sources, GCS load jobs, registered BigLake Iceberg reads, append/overwrite/explicit-column upsert, SQL quality, evidence, row policies, direct masking, policy tags and descriptions are validated for the documented `gcp_bigquery` surface. |
 
 See [roadmap](docs/roadmap.md) for adapter maturity and release criteria.
 
-## Compared With Alternatives
-
-| Alternative | Difference |
-| --- | --- |
-| dbt | dbt models data after it lands. ContractForge defines how governed data arrives, is written, validated and evidenced. |
-| Airbyte/Fivetran | They provide managed ingestion runtimes. ContractForge provides the contract and lets adapters execute natively in your platform. |
-| Data contract tools | Validation is one slice. ContractForge covers source, write semantics, schema policy, quality, governance, evidence and native execution artifacts. |
-| Platform-specific frameworks | ContractForge keeps platform implementations in adapters so the same semantics can be evaluated for other runtimes. |
-
 ## Install
 
 From GitHub:
 
 ```bash
-pip install "git+https://github.com/marquesantero/contractforge-core.git"
-pip install "git+https://github.com/marquesantero/contractforge-core.git#subdirectory=adapters/databricks"
-pip install "git+https://github.com/marquesantero/contractforge-core.git#subdirectory=adapters/aws"
-pip install "git+https://github.com/marquesantero/contractforge-core.git#subdirectory=adapters/snowflake"
-pip install "git+https://github.com/marquesantero/contractforge-core.git#subdirectory=ai"
+pip install "git+https://github.com/marquesantero/contractforge.git"
+pip install "git+https://github.com/marquesantero/contractforge.git#subdirectory=adapters/databricks"
+pip install "git+https://github.com/marquesantero/contractforge.git#subdirectory=adapters/aws"
+pip install "git+https://github.com/marquesantero/contractforge.git#subdirectory=adapters/fabric"
+pip install "git+https://github.com/marquesantero/contractforge.git#subdirectory=adapters/snowflake"
+pip install "git+https://github.com/marquesantero/contractforge.git#subdirectory=adapters/gcp"
+pip install "git+https://github.com/marquesantero/contractforge.git#subdirectory=ai"
 ```
 
 Local development:
@@ -154,15 +148,51 @@ uv build --wheel
 cd adapters/databricks && uv build --wheel
 cd ../aws && uv build --wheel
 cd ../snowflake && uv build --wheel
+cd ../fabric && uv build --wheel
+cd ../gcp && uv build --wheel
 cd ../../ai && uv build --wheel
 ```
 
 Release package names:
 
 ```bash
-pip install contractforge-core contractforge-databricks contractforge-aws contractforge-snowflake contractforge-ai
+pip install contractforge-core contractforge-databricks contractforge-aws contractforge-snowflake contractforge-fabric contractforge-gcp contractforge-ai
 ```
 
+## Packages And Releases
+
+ContractForge is published as independent PyPI packages from one repository.
+The package boundary is intentional: the core stays platform-neutral, while
+adapters carry native runtime dependencies and behavior.
+
+| Package | Current version | PyPI | Source |
+| --- | --- | --- | --- |
+| `contractforge-core` | `0.2.0` | [PyPI](https://pypi.org/project/contractforge-core/) | [core](src/contractforge_core) |
+| `contractforge-databricks` | `0.2.0` | [PyPI](https://pypi.org/project/contractforge-databricks/) | [adapter](adapters/databricks) |
+| `contractforge-aws` | `0.2.0` | [PyPI](https://pypi.org/project/contractforge-aws/) | [adapter](adapters/aws) |
+| `contractforge-snowflake` | `0.2.0` | [PyPI](https://pypi.org/project/contractforge-snowflake/) | [adapter](adapters/snowflake) |
+| `contractforge-fabric` | `0.2.0` | [PyPI](https://pypi.org/project/contractforge-fabric/) | [adapter](adapters/fabric) |
+| `contractforge-gcp` | `0.2.0` | [PyPI](https://pypi.org/project/contractforge-gcp/) | [adapter](adapters/gcp) |
+| `contractforge-ai` | `0.3.0` | [PyPI](https://pypi.org/project/contractforge-ai/) | [AI companion](ai) |
+
+Releases are built by [`.github/workflows/release.yml`](.github/workflows/release.yml).
+The workflow can be started manually with `workflow_dispatch` for one package,
+or by pushing package-specific tags:
+
+```text
+v<version>-core
+v<version>-databricks
+v<version>-aws
+v<version>-snowflake
+v<version>-fabric
+v<version>-gcp
+v<version>-ai
+```
+
+PyPI does not allow overwriting an existing version. Before publishing from this
+repository, bump the target package version and publish a new tag or manual
+release workflow run.
+
 ## Project Shape
 
 A complete ContractForge project keeps runtime concerns separate from contract
@@ -221,9 +251,10 @@ values override global connection defaults.
 | Adapter | Package | Status | Native responsibilities |
 | --- | --- | --- | --- |
 | Databricks | `contractforge-databricks` | Reference implementation | Delta, Unity Catalog, Auto Loader, Lakeflow planning, Jobs, Asset Bundles, control tables, governance, lineage, cost and dashboards. |
-| AWS | `contractforge-aws` | Alpha with real E2E validation | Glue Spark, Iceberg, Glue Catalog, Lake Formation review/apply helpers, S3 artifacts, Glue jobs, Athena/Iceberg evidence and cost records. |
-| Fabric | `contractforge-fabric` | Planned | OneLake, Lakehouse tables, Data Pipelines, Dataflow Gen2 and Purview/Fabric metadata. |
-| Snowflake | `contractforge-snowflake` | Alpha with real Snowflake validation | SQL warehouse runtime, hosted Snowpark procedure library runner with staged ZIP imports, table/staged-file/SQL sources, append/overwrite/upsert/hash-diff writes, quality, schema policy, governance, evidence/control tables, lineage, cost reconciliation and project deployment. Task graph live smoke still needs task grants. See [Snowflake adapter guide](docs/adapters/snowflake.md). |
+| AWS | `contractforge-aws` | Stable supported surface | Glue Spark, Iceberg, Glue Catalog, Lake Formation review/apply helpers, S3 artifacts, Glue jobs, Athena/Iceberg evidence and cost records for the documented `aws_glue_iceberg` surface. |
+| Fabric | `contractforge-fabric` | Stable supported surface | Notebook-first Lakehouse execution, Lakehouse Delta writes, source expansion, shortcut reads, Kafka catch-up, core write modes, control evidence, workspace roles, sensitivity labels and OneLake data access role apply helpers for the documented `fabric_lakehouse` surface. |
+| Snowflake | `contractforge-snowflake` | Stable supported surface | SQL warehouse runtime, hosted Snowpark procedure library runner with staged ZIP imports, table/SQL/bounded REST/staged-file sources, append/overwrite/upsert/hash-diff writes, quality, schema policy, governance, evidence/control tables, lineage, cost reconciliation and project deployment for the documented `snowflake_sql_warehouse` surface. Task graph live execution still needs task grants. See [Snowflake adapter guide](docs/adapters/snowflake.md). |
+| GCP | `contractforge-gcp` | Stable supported surface | BigQuery table/view/SQL sources, GCS load jobs, BigLake Iceberg table reads, core writes, SQL quality, evidence tables, row access policies, masking, policy tags and descriptions for the documented `gcp_bigquery` surface. |
 
 Use the same project model for adapter deployment:
 
@@ -240,7 +271,7 @@ planning and produce clear HTML approval reports.
 
 ```bash
 contractforge-ai guided-project \
-  --intent "Create a Supabase medallion project for AWS and Databricks daily at 6 Sao Paulo time." \
+  --intent "Create a Supabase medallion project for Databricks, AWS, Snowflake, Fabric and GCP daily at 6 Sao Paulo time." \
   --schema schemas/products.json \
   --target contractforge-yaml \
   --allow-review-required \
@@ -249,6 +280,9 @@ contractforge-ai guided-project \
 contractforge-ai validate-project-structure generated/supabase \
   --adapter databricks \
   --adapter aws \
+  --adapter snowflake \
+  --adapter fabric \
+  --adapter gcp \
   --format html > generated/supabase/project_validation.html
 ```
 
@@ -267,7 +301,7 @@ contract = validate_contract(
     {
         "source": {"type": "incremental_files", "path": "s3://landing/orders", "format": "json"},
         "target": {"catalog": "main", "schema": "bronze", "table": "orders"},
-        "mode": "scd0_append",
+        "mode": "append",
         "schema_policy": "additive_only",
         "quality_rules": {"not_null": ["order_id"]},
     }
@@ -293,9 +327,12 @@ print(result.status)
 | Semantic core | `contractforge-core` | Contract models, validation, semantic normalization, capability matching, abstract plans, portability diagnostics and neutral evidence models. |
 | Databricks adapter | `contractforge-databricks` | Databricks capabilities, rendering, runtime execution, governance, evidence filling and deployment helpers. |
 | AWS adapter | `contractforge-aws` | AWS capabilities, Glue/Iceberg planning, runtime helpers, S3 publication, deployment helpers and evidence filling. |
+| Fabric adapter | `contractforge-fabric` | Fabric Lakehouse capabilities, Notebook rendering/execution, source expansion, governance apply helpers and deployment promotion. |
+| Snowflake adapter | `contractforge-snowflake` | Snowflake SQL warehouse capabilities, hosted procedure runtime, task graph execution, governance, lineage, cost and evidence filling. |
+| GCP adapter | `contractforge-gcp` | BigQuery capabilities, GCS load-job rendering, smoke execution, evidence DDL, governance smokes and BigLake Iceberg table support. |
 | AI companion | `contractforge-ai` | Deterministic review, project generation, diagnostics, provider routing, report generation and optional model-backed enrichment. |
 
-Publication stays split: each package builds its own wheel and future adapters
+Publication stays split: each package builds its own wheel and all adapters
 depend explicitly on `contractforge-core`.
 
 The core wheel owns only `contractforge_core`; adapter wheels such as `contractforge-databricks` own their adapter package and depend explicitly on the core.
@@ -306,7 +343,7 @@ See [publication packaging](docs/specs/publication-packaging.md).
 
 | Topic | Link |
 | --- | --- |
-| Online site | [marquesantero.github.io/contractforge-core](https://marquesantero.github.io/contractforge-core/) |
+| Online site | [marquesantero.github.io/contractforge](https://marquesantero.github.io/contractforge/) |
 | Documentation index | [docs/README.md](docs/README.md) |
 | Quick start | [docs/quickstart.md](docs/quickstart.md) |
 | Architecture | [docs/architecture.md](docs/architecture.md) |
@@ -316,16 +353,30 @@ See [publication packaging](docs/specs/publication-packaging.md).
 | Adapters | [docs/adapters.md](docs/adapters.md) |
 | Databricks adapter | [docs/databricks.md](docs/databricks.md) |
 | AWS adapter | [docs/adapters/aws.md](docs/adapters/aws.md) |
+| Snowflake adapter | [docs/adapters/snowflake.md](docs/adapters/snowflake.md) |
 | Test contracts across adapters | [docs/adapters/test-contracts-across-adapters.md](docs/adapters/test-contracts-across-adapters.md) |
 | Connectors | [docs/connectors.md](docs/connectors.md) |
 | Operations and evidence | [docs/operations.md](docs/operations.md) |
 | ContractForge AI | [ai/README.md](ai/README.md) |
 | Security | [docs/security.md](docs/security.md) |
 | Adapter authoring | [docs/specs/adapter-authoring.md](docs/specs/adapter-authoring.md) |
+| Contributing | [CONTRIBUTING.md](CONTRIBUTING.md) |
+| Support | [SUPPORT.md](SUPPORT.md) |
+| Security policy | [SECURITY.md](SECURITY.md) |
 
 Architecture contracts live under [docs/specs](docs/specs/), and decisions live
 under [docs/adrs](docs/adrs/).
 
+## Contributing
+
+Contributions are welcome when they preserve the core/adapter boundary and keep
+contract behavior explicit. Start with [CONTRIBUTING.md](CONTRIBUTING.md), use
+the issue templates for bugs, features or adapter gaps, and follow
+[SECURITY.md](SECURITY.md) for private vulnerability reports. Changes flow
+through pull requests to the protected `main` branch with required CI and
+maintainer or CODEOWNER review when the change affects public behavior, release
+flow, security, package boundaries or adapter maturity.
+
 ## Non-Goals
 
 ContractForge is not: