Technology

DRIFT is built on a Rust-powered semantic diff core, a consumer dependency graph, and a live drift monitor — all designed for sub-second analysis at any scale.

Architecture

Each layer is independently deployable and horizontally scalable. Together they form a real-time regression analysis pipeline.

Contract Ingestion

Rust + WASM

Parses OpenAPI 3.x, gRPC proto, GraphQL SDL, and AsyncAPI into a unified intermediate representation.

01

Semantic Diff Engine

Rust core

Computes type-aware, field-level diffs. Classifies every change as breaking, compatible, or cosmetic.

02

Consumer Graph

PostgreSQL + pgvector

Maps which downstream services depend on each field, so impact is always contextual.

03

Live Drift Monitor

Edge runtime

Continuously samples production traffic and compares observed shapes against the contract.

04
Shadow Replay Simulation

Watch real-time HTTP requests flowing through candidate OpenAPI contracts with instant breaking change detection.

Shadow Production Traffic Replay Simulator

Replaying production HTTP payloads against candidate OpenAPI contract v1.3.0

Total Replayed

1,423

Passed Compatible

1,420

Breaking Failures

3

Replay Latency

< 8ms avg

Click "Resume Stream" to begin replaying shadow traffic packets...
Sentinel Stages

Inspect AST dereferencing, traffic replay, and classification output across all execution steps.

SELECTED STAGE

1. OpenAPI Validation

Dereferences $ref objects and validates OpenAPI 3.0 & 3.1 specifications into AST trees.

  • Schema dereferencing
  • Swagger 2.0 & OpenAPI 3.1 support
  • AST tree normalization

2. Structural Diff Engine

Calculates microsecond deltas across endpoints, parameters, request bodies, and response schemas.

  • Parameter type mutation matrix
  • Enum constraint verification
  • Response status delta

3. Traffic Replay Engine

Replays sanitized shadow production traffic payloads against candidate endpoints without user latency.

  • eBPF kernel probe capture
  • In-memory PII scrubbing
  • Zero production impact

4. Classification Engine

Classifies changes into Non-Breaking (Safe), Deprecation (Risky), or Critical Breaking Regressions.

  • ML severity classification
  • Downstream consumer mapping
  • Zero false positive guarantee

5. Report Generator

Generates high-precision engineering reports in Console text, structured JSON, or rich HTML formats.

  • GitHub PR inline comments
  • Structured JSON export
  • Interactive HTML summaries

6. CI/CD Integration

Integrates directly into GitHub Actions, GitLab CI, and CircleCI to block breaking deployment merges.

  • GitHub Checks API
  • GitLab CI runner step
  • Automated Slack dispatch
Live Stage Inspector: 1. OpenAPI ValidationStage Output Schema
json
// AST Validation Output
{
  "valid": true,
  "specification": "3.1.0",
  "total_endpoints": 48,
  "dereferenced_schemas": 142
}
System Design

Inspect dereferencing specs, eBPF probes, and multi-format report generators.

Interactive System Architecture Map

Hover or select any node to inspect subsystem specifications

60 FPS Reactive Engine
Subsystem Inspector•WASM AST Diff Core

Evaluates structural schema changes, parameter omissions, and type mutation bounds.

CAPABILITY SPEC

Rust WASM Engine • Microsecond Delta Matrix

Configuration

One config file. Total control.

DRIFT reads a single TypeScript config to understand your contract, your consumers, and your team's tolerance for each change class. Ship it to CI in minutes.

Breaking → blockCompatible → warnCosmetic → ignore
drift.config.ts
// drift.config.ts
import { defineConfig } from '@drift/sdk';

export default defineConfig({
  contract: './openapi.yaml',
  consumers: ['./consumers/**/*.proto'],
  rules: {
    breaking: 'block',        // gate merges on breaking changes
    compatible: 'warn',       // comment on compatible changes
    cosmetic: 'ignore',       // silent on cosmetic changes
  },
  monitor: {
    production: true,
    sampleRate: 0.02,
  },
});
Specifications

Diff latency (10k endpoints)

< 800ms

Contract size limit

Unlimited

Supported specs

OpenAPI · gRPC · GraphQL · AsyncAPI

CI integrations

GitHub · GitLab · CircleCI · Jenkins

Deployment

Cloud · Self-hosted · Air-gapped

Compliance

SOC 2 II · GDPR · HIPAA-ready

Rust-powered core

The diff engine is pure Rust, compiled to WASM for the browser and native for CI.

Zero-trust by design

Self-hosted or cloud — your contract never leaves your network unless you choose.

Spec-agnostic

One mental model across OpenAPI, gRPC, GraphQL, and AsyncAPI.