alex/flybrain
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: session framework, the contract and session slices
Some checks are pending
ci / node 22 (test + typecheck) (push) Waiting to run
Details
ci / rust stable (cargo test --workspace --release) (push) Waiting to run
Details
ci / infra/tests/lint.sh (push) Waiting to run
Details
ci / playwright apps/stage (allowed to fail) (push) Waiting to run
Details

Browse source
This commit is contained in:
acamilo 2026-09-22 13:48:09 +00:00
parent f48cab5258
commit ab18d75db9
1 changed files with 14 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
docs/stream-mvp-plan.md
View file

@ -659,3 +659,17 @@ then purge; then the stale-doc pass.
RSS 11-17 MB. Two spec contradictions were resolved in bus-v1 rather than in the code (the RSS 11-17 MB. Two spec contradictions were resolved in bus-v1 rather than in the code (the
per-client byte budget now names bounded queues only, with latest slots capped separately; per-client byte budget now names bounded queues only, with latest slots capped separately;
the illustrative client sketch drops its budget argument for a caller-side deadline). the illustrative client sketch drops its budget argument for a caller-side deadline).
- 2026-09-22 (session framework, wave 1 complete): the CONTRACT and SESSION slices merged. There
is now one executable contract for the new architecture: a types crate and a matching
TypeScript package that read the same fixtures, RFC 8785 canonical JSON, a contract digest
generated from the schema set rather than from source formatting, the four identities typed so
they cannot be mistaken for one another, and two new specifications with test vectors for seed
derivation and the checkpoint envelope. On top of it a synthetic lockstep session runs over the
bus: fake agents, a counter world, identity executors and a deterministic task, stepping
prepare, advance, evaluate, commit in that order, with the rational clock proving 16, 17 and 17
ticks and a zero remainder, request deduplication that refuses a changed body and replays a
cached one, and the guide's failure injections as tests that compare an injected run against a
clean one on behaviour, mutation count and world counter. Reviews caught two defects worth
naming: a merge that stopped short of the TypeScript half, whose absence silently took its own
test gate with it, and an unchecked addition that would have wrapped in release. Both fixed
before merge.