Skip to content

IR and config formats stable, or versioned with readers for older ones #146

Closed as not planned

Description

@Kinflou
  • From 1.0 a newer comline must read what an older one wrote: the CAS/IR CBOR and config.idp.
  • Either freeze them or keep a reader for every older version, with tests.

Activity

  1. added this to the 1.0 milestone on Oct 31, 2026
  2. added
    P1Next
    versioningVersions and compatibility
    designNeeds a design decision
    1.0-blockerMust be done before the 1.0 announcement (docs conduct/readiness.md)
    on Oct 31, 2026
  3. Kinflou commented on Nov 9, 2026

    @Kinflou
    MemberAuthor

    Input from the shared-vocabulary proposal (ComlineProject/docs#162, #220):

    • The vocabulary's spec version and the IR format version stay independent.
    • Each frozen version records the spec version it was frozen against.
    • The spec is append-only for anything frozen, so an old IR's names always read correctly under a newer spec.
    • Granular @unverified (Granular @unverified: name guarantees, per-guarantee reasons, narrower scopes #222) changes the frozen shape (scopes and chains), so it would be IR format 4.
  4. Kinflou commented on Nov 15, 2026

    @Kinflou
    MemberAuthor

    The accepted IR migrations design (core#268, docs/proposals/ir-migrations) answers this for IR: it says it feeds #146, and 'the framework is the readers' (beyond-the-store.md, 'After 1.0'): from 1.0 every format change is a step with fixtures kept for ever, and #268 step 3 carries that. #268 owns the work; the config.idp half of the question is noted there as a comment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    1.0-blockerMust be done before the 1.0 announcement (docs conduct/readiness.md)P1NextcompilerParser, IR, CASdesignNeeds a design decisionversioningVersions and compatibility

    Type

    No type

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions