# TypeScript Contracts

This directory contains TypeScript interfaces for the current Synaptopus JSON artifacts:

- artifact manifest
- versioned artifact envelopes
- graph schema
- execution trace
- run report

The interfaces mirror the formats documented in [../docs/FORMATS.md](../docs/FORMATS.md).

The current scope is intentionally narrow:

- stable artifact contracts
- typed loaders and type guards
- XOR novelty demo metadata interfaces
- version-aware parsing boundaries

This is the first frontend-facing layer for a future browser workbench or trace viewer.