Release-aware context for data agents.

Give Claude, Codex, and other agents compact metadata, reviewed metrics, approved joins, read-only SQL validation, and release gates without dumping the full warehouse schema into every conversation.

Run locally View benchmark

release gate

node dist/cli.js release-gate \
  --release staging-fresh \
  --benchmark examples/benchmark.json \
  --observations examples/benchmark-observations.json

{
  "ok": true,
  "tables": 136,
  "columns": 3974,
  "relationships": 236
}

Current Snapshot

The local demo is pointed at the latest verified example snapshot.

Release

staging-fresh

Promoted as the active context snapshot.

Tables

136

Indexed as compact searchable entities.

Columns

3,974

Available through targeted retrieval.

Relationships

236

Used for join-path discovery and planning.

Agent Query Pipeline

Agents use the context layer as a narrow contract instead of scanning information_schema repeatedly.

Snapshot

Build immutable metadata from Metabase or adapter imports.

Contract

Review entities, dimensions, measures, and approved join paths.

Plan

Return only relevant tables, columns, saved questions, and ambiguity warnings.

Compile

Generate SQL from semantic or contract queries using reviewed definitions.

Gate

Validate read-only SQL, schema references, release freshness, and benchmarks.

Commands

The demo commands are credential-free unless they execute live Metabase queries.

draft a contract from dbt

node dist/cli.js adapters inspect dbt \
  examples/dbt-manifest-mini.json

node dist/cli.js contract draft \
  --adapter dbt \
  --input examples/dbt-manifest-mini.json \
  --project demo

compare agent runs

node dist/cli.js benchmark compare \
  examples/benchmark.json \
  examples/benchmark-direct-observations.json \
  examples/benchmark-context-observations.json

# token reduction: 84.44%
# latency reduction: 70.56%
# call reduction: 66.67%

Benchmark Result

A model-neutral harness compares direct schema exploration against context-layer querying.

Tokens

84.44%

Reduction in the sample direct-vs-context run.

Latency

70.56%

Lower elapsed time across benchmark cases.

Tool Calls

66.67%

Fewer context discovery round trips.

Adapter Surface

External metadata sources normalize into the same contract shape used by snapshots.

Implemented

dbt

Imports manifest models, sources, descriptions, and columns.

tested fixture contract draft

Implemented

Cube

Imports cubes, dimensions, and measures from JSON schema exports.

needs real export fixture

Implemented

MetricFlow

Imports semantic models, dimensions, measures, and node relations.

needs real export fixture

Release Checks

Gate	What It Blocks	Status
Snapshot validation	Missing index, empty schema, invalid semantics, unexpected shrink	Passing
Contract validation	Missing entities, unsafe joins, broken physical references	Available
Benchmark validation	Wrong metric, wrong dimension, extra table, too many calls, slow runs	Passing