Skip to main content

Technical documentation

ContractForge

Contracts for portable ingestion.

A semantic core plus native adapters for Databricks, AWS and Snowflake. Contracts describe source, target, transforms, quality, governance and evidence.

3adapters
1core
12test bundles

Adapters

Current targets

Each adapter owns its runtime APIs, SQL dialect, deployment artifacts and evidence mapping.

Stable

Databricks

Delta, Unity Catalog, Asset Bundles, Lakeflow planning.

Stable

AWS

Glue Spark, Iceberg, S3 artifacts, Lake Formation, MSK.

Stable

Snowflake

SQL warehouse, staged artifacts, native tables, tasks.

Workflow

Execution path

The core has no Spark, boto3 or Snowflake client dependency. Platform code stays inside adapter packages.

01

Validate

Load split contracts and check the semantic model.

02

Plan

Return supported, warning, review-required or unsupported.

03

Render

Generate SQL, jobs, bundles, procedures and runtime files.

04

Record

Persist runs, quality, errors, lineage, state and cost.

Docs

Reference

Start with the quick start, then use the contract, adapter and connector references as the implementation guide.