Skip to content

[IR-P0][WS1] RFC: Define SchemaIR, QueryIR, and CodecIR contracts #72

@0x054

Description

@0x054

Problem statement

Ferro needs canonical IR contracts before implementation to prevent parallel-truth drift.

Intended invariant

SchemaIR, QueryIR, and CodecIR are versioned and explicit before cutover work begins.

Scope boundaries

  • Contract definitions and versioning only
  • No runtime migration logic implementation

Deliverable checklist

  • Draft contract structures and versioning policy
  • Define compatibility and evolution rules
  • Include representative examples for each IR
  • Merge approved RFC document

Validation plan

Review and approve RFC with architecture sign-off.

Rollback/failure mode

If unresolved design conflicts remain, mark blocked and split into focused design issues.

Roadmap reference

Roadmap reference: docs/plans/2026-06-19-001-ir-first-roadmap.md (Phase 0)

Migration impact

none - Contract definition only; no shipped runtime/API behavior changes in this issue.

Documentation impact

update-existing - Roadmap and migration guide entries must remain synchronized with final RFC decisions.

Sync status

Synced with roadmap: 2026-06-19

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions