interfacectl

Command-line control for interface contracts.

interfacectl validates, enforces, and inspects interface contracts as executable truth.

brew install interfacectl

Supports macOS, Linux, CI environments.

What this tool is

  • Reads interface contracts
  • Validates implementations
  • Detects drift
  • Exits with explicit status codes

Example Usage

interfacectl validate interface.json

Validates an interface against its contract.

interfacectl diff previous.json current.json

Shows structural and language drift.

interfacectl enforce interface.json --strict

Fails on any contract violation.

Exit States

0Valid

Interface conforms to contract.

1Warning

Minor deviation detected.

2Drift detected

Interface has diverged from definition.

3Invalid

Contract violation. Change blocked.

When to Use This

In CI pipelines to validate interface changes before merge.

During design system changes to ensure token adherence.

Before AI-generated interfaces ship to production.

interfacectl is the executable surface of the Surfaces system.
It does not interpret intent.
It evaluates truth.

If it passes interfacectl, it passes the contract.