docs: playground simulation — Phase 1 spec - #4
Merged
Conversation
A design record for the "simulate machines" runtime demo, now concrete because `@comline/runtime` ships the wire (`duplex()`, `Client.connect` / `Server.serveHandshaked`, `Reply`, both framings). Route B: drive the frozen IR through the real runtime — no codegen or transpile on the path — so `comline-core` only gains one read-only WASM function, `describe_project`. Covers the data model, the runtime wiring, six canned behaviours, the full-width simulate view, five milestones (1a–1e) and the open questions (chiefly `ir_hash` parity with the generator). Two shape calls settled: full-width view (not the right pane), and the runtime is vendored into the app. Linked from the runtime-demo section of playground-and-tutorial.md, the design index, and the nav.
This was referenced Sep 2, 2026
Merged
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
1 participant
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.
A design record for the "simulate machines" runtime demo, moved off a scratch artifact and into
design/.It's now concrete:
@comline/runtimealready ships the wire (duplex(),Client.connect/Server.serveHandshaked,Reply, both framings), so route B — drive the frozen IR through the real runtime, no codegen or transpile on the path — meanscomline-coreonly gains one read-only WASM function,describe_project.Covers: vocabulary, architecture + module layout, the
describe_projectshape and mapping rules,TappedTransport+ generic client/dispatch, six canned behaviours, the full-width simulate view (with an ASCII wireframe), three interaction flows, five milestones (1a–1e) each with an acceptance check, and the open questions — chieflyir_hashparity betweenschema_ir_hashand the generator's emittedIR_HASH.Two shape calls settled with @Kinflou: full-width view (not the existing right pane), and the runtime vendored into the app (matching how the WASM crate pins
comline-coreby rev).Linked from the runtime-demo section of
playground-and-tutorial.md, the design index, and the nav.mkdocs build --strictpasses.