@miadi/tide-contract

Schema-first contract for the Tide operator cockpit boundary.

This package is the shared covenant between:

• the IronSilk tide runtime,
• the @miadi/tide TypeScript client,
• the /api/tide/* Next.js routes,
• and the cockpit UI at /tide.

Current shape

• schema/tide-api.schema.json is the planned source of truth.
• src/index.ts carries hand-written TypeScript types for this scaffold.
• Runtime identity constants are exported from src/index.ts and mirrored in the schema x-tide metadata: tide, MIADI_HOME, ~/.miadi/navigator, and miadi.tide.daemon.v2.
• Future work should generate the TypeScript types from the schema and validate IronSilk runtime payloads with Python jsonschema.

Drift posture

The intended CI shape is:

1. Generate TypeScript types from schema/tide-api.schema.json.
2. Compare generated output against committed types.
3. Validate runtime fixture JSON from IronSilk.
4. Fail when the contract, client, routes, and runtime drift.

Ref: jgwill/Miadi#378