Repository navigation
Proposals: dependency protocols, comline.packet@1, IPC framings, doc links - #174
Merged
Merged
Conversation
…links - dependency-protocols/: which numbers address a dependency's protocol on a connection. Decided 2026-11-14: step 0 (unreached protocols aren't addressed), Part 1 (profile facts, `one_way`, `limits`, capabilities), A (`comline@3` with `datagram@4`) and C (a connection per package) accepted, B rejected (core#276, core#277, generation#143). - packet-dispatch/comline.packet@1.md: the official packet framing, its layout decided (P1-P9, core#123). packet-dispatch.md moves to packet-dispatch/index.md. - ipc.md: framings over IPC. The transport ties handles to a frame, every child channel starts with a handshake, a shared-memory ring marks frames with handles, and D-Bus is the first platform framing. - auto-documentation/links-overview-highlighting.md (draft): links to dependencies' and built-ins' docs, the overview with the configuration, and highlighting everywhere (generation#144). auto-documentation.md moves to auto-documentation/index.md. Inbound links and the nav follow the two moves.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Proposal pages from 2026-11-14, with the decisions recorded in them. Closes #173.
Dependency protocols (new section)
proposals/dependency-protocols/answers which numbers address a dependency's protocol on a connection, and which version the handshake checks it against.one_wayfact) andlimits; capabilities are derived from them (core#276).comline@3with a newdatagram@4framing. A dependency's protocol joins byuse, and dual-accept (accept_previous) is opt-in in the shared runtime core (core#277).Packet dispatch
packet-dispatch.mdmoves topacket-dispatch/index.md. A new page,comline.packet@1, is the official packet framing, with its layout decided as P1–P9 (core#123).IPC
New Framings section: what IPC asks of a framing, and Comline's own framings over IPC.
Automatic documentation
auto-documentation.mdmoves toauto-documentation/index.md. A new draft page covers links to dependencies' docs and the reference for built-ins, the overview with the configuration, and highlighting everywhere code appears (generation#144). It amends the "comline.tomlonly" config decision, and that amendment still needs approval.Notes
zensical build --strictpasses locally, and the unrendered-template check is clean.reference/package/…, the per-version datagram pages) isn't in this PR. Four links that would point into it link to the current pages instead, and the types reference is named but not linked.