Skip to content

datagram@3 and comline@2 are the defaults - #150

Merged
Kinflou merged 2 commits into
mainfrom
comline2/flip-defaults
Nov 7, 2026
Merged

Kinflou merged 2 commits into
mainfrom
comline2/flip-defaults

Conversation

@Kinflou

@Kinflou Kinflou commented Nov 7, 2026

Copy link
Copy Markdown
Member

Part of ComlineProject/runtime#15, the default flip: core#208, generation#122, comline-rust#109, comline-typescript#136, cli#137.

  • New defaults everywhere they're named: datagram@3 and comline@2, in the protocol, packages and call-system guides, both languages' framing pages, config.idp's reference, inspect, the language feature rows, versioning.md's "in play" and the extending-encodings page.

  • Notes removed: "datagram@3 is available, not the default", "comline@2 is available, not the default" (with its "generators don't embed the facts yet"), and call-system's "not yet the default".

  • New section, Handshakes > Defaults before comline@2:

    • old versions read as built: recorded encodings, else datagram@2/comline@1;
    • the wire change and breaking bump (minor in 0.x) a package taking the defaults gets on its first release after the flip;
    • stating wire = { framing = "datagram@2" } and handshake = "comline@1" keeps the old wire with no change.

    The framings page, the packages guide and versioning's Storage section link to it.

  • Default handshake per package: comline@2 where all the package's protocols are on datagram@3, else comline@1 for those naming none (handshakes page, config.idp reference, protocol guide).

  • Generate without a build: versioning's Number section and the CLI table explain that comline generate uses the last build's numbers when nothing changed, and otherwise works them out as the next build would. Those numbers are provisional until a release.

  • versioning.md's by_id rows already say what applies by framing; "in play" now names datagram@3 as the default, with datagram@2 for versions built before.

No pages moved. sync-official-encodings.py --check passes (the encodings package didn't change). sync-language-support.py --check was already out of date on main before this PR, so I only edited the connections rows by hand. They match generation#122's features.json and stay red until generation merges.

Names the new defaults wherever the old ones were named, drops the
"available, not the default" notes, explains the breaking bump a package
taking the defaults gets on its first release after the change and how to
keep the old wire, the per-package rule for the default handshake, and
that comline generate works out provisional numbers without a build
(runtime#15).
@Kinflou
Kinflou merged commit ab57a63 into main Nov 7, 2026
5 checks passed
@Kinflou
Kinflou deleted the comline2/flip-defaults branch November 7, 2026 22:40
@Kinflou Kinflou moved this from Todo to Done in Comline Development Roadmap Nov 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant