Fragment 3 · Wave 3

Wave 3 · The return, declared

The slot's doer was born with no place for a Cell's return, and a description is never edited. So the act sows a figure that will gather the return — now, before the Cell has done anything.

In this wave

1. 136A new wave beginsSETTLING · enter-settle

   a wave is settlingengine: at the endmembrane: at the end

   1. #0a listener
   2. #1a doer
   3. #2listener: the charter
   4. #3doer: the author
   5. #4listener: charter seen
   6. #5listener: blueprint seen
   7. #6doer: the planner
   8. #7listener: assess · charter
   9. #8listener: assess · result
   10. #9doer: the evaluator
   11. #10the charter wanted
   12. #11the blueprint
   13. #12readiness
   14. #13readiness
   15. #14a request: a charter
   16. #15the charter proposed
   17. #16the charter defined
   18. #17readiness
   19. #18readiness
   20. #19a request: a Cell
   21. #20the seed
   22. #21the Cell is open
   23. #22inner listener
   24. #23inner doer
   25. #24the Cell's context
   26. ·end of the logenginemembrane

   What	before		after
   a wave is settling	no	→	yes

   The act comes back to the door with three more records — the way the Cell's answer will return — so a new wave starts.

   Where it happens markSettling()Vol. 02 §4.6 · Vol. 02 §4.7

   Marks the start and the end of a wave. The runtime settles one wave at a time.

   Specification

   Vol. 02 §4.6 · Vol. 02 §4.7

   Code

   markSettling() in core/registers/mark-settling.ts, line 16: the runtime notes whether a wave is settling

   Journal

   SETTLING · enter-settle · by runtime

   Picture

   a wave is settling: no → yes

   1. 1// SETTLING latch (Vol. 02 §4.6): one settling wave at a time — a second
   2. 2// concurrent settle is a caller error, not a queue. Ephemeral stratum: the
   3. 3// latch never survives into a snapshot; extraction asserts it clear.
   4. 4// Entering a wave also rewinds the discharge slot sequence: slot ids are
   5. 5// wave-local (the table is drained between waves and ids never reach the
   6. 6// log), which keeps the journal byte-identical across a snapshot/restore —
   7. 7// unlike INTENT.CTR, which the spec pins as never-reset (Vol. 02 §4.7).
   8. 8
   9. 9import type { RegisterFile } from "./register-file";
   10. 10import { recordTransition } from "./record-transition";
   11. 11
   12. 12export function markSettling(file: RegisterFile, settling: boolean): void {
   13. 13 if (settling && file.ephemeral.settling) {
   14. 14 throw new Error("A wave is already settling; the runtime handles one wave at a time.");
   15. 15 }
   16. 16 file.ephemeral.settling = settling;↑ the runtime notes whether a wave is settling
   17. 17 if (settling) file.ephemeral.nextDischargeId = 0;
   18. 18 recordTransition(file, "runtime", "SETTLING", settling ? "enter-settle" : "leave-settle");↑ the change is written into the journal
   19. 19}

   AGPL-3.0-onlyThe Lab's demonstration environment, as this fragment ran it (build 043cc8b). The code may change, and may differ from the code of a working machine.

   Nest VM core, incubated in the CoAgnes garden · build 043cc8b (2026-09-21) · this file last changed in f36e70d (2026-08-18)

2. written by a person#25 · the return listener→
3. written by a person#26 · the return doer→
4. written by a person#27 · the return is declared→
5. 151The wave endsSETTLING · leave-settle

   quietengine: at the endmembrane: at the end

   1. #0a listener
   2. #1a doer
   3. #2listener: the charter
   4. #3doer: the author
   5. #4listener: charter seen
   6. #5listener: blueprint seen
   7. #6doer: the planner
   8. #7listener: assess · charter
   9. #8listener: assess · result
   10. #9doer: the evaluator
   11. #10the charter wanted
   12. #11the blueprint
   13. #12readiness
   14. #13readiness
   15. #14a request: a charter
   16. #15the charter proposed
   17. #16the charter defined
   18. #17readiness
   19. #18readiness
   20. #19a request: a Cell
   21. #20the seed
   22. #21the Cell is open
   23. #22inner listener
   24. #23inner doer
   25. #24the Cell's context
   26. #25return listener
   27. #26return doer
   28. #27the return address
   29. ·end of the logenginemembrane

   What	before		after
   a wave is settling	yes	→	no

   The wave ends with the return prepared and nothing yet to return. The person's next act happens inside the Cell.

   Where it happens markSettling()Vol. 02 §4.6 · Vol. 02 §4.7

   Marks the start and the end of a wave. The runtime settles one wave at a time.

   Specification

   Vol. 02 §4.6 · Vol. 02 §4.7

   Code

   markSettling() in core/registers/mark-settling.ts, line 16: the runtime notes whether a wave is settling

   Journal

   SETTLING · leave-settle · by runtime

   Picture

   a wave is settling: yes → no

   1. 1// SETTLING latch (Vol. 02 §4.6): one settling wave at a time — a second
   2. 2// concurrent settle is a caller error, not a queue. Ephemeral stratum: the
   3. 3// latch never survives into a snapshot; extraction asserts it clear.
   4. 4// Entering a wave also rewinds the discharge slot sequence: slot ids are
   5. 5// wave-local (the table is drained between waves and ids never reach the
   6. 6// log), which keeps the journal byte-identical across a snapshot/restore —
   7. 7// unlike INTENT.CTR, which the spec pins as never-reset (Vol. 02 §4.7).
   8. 8
   9. 9import type { RegisterFile } from "./register-file";
   10. 10import { recordTransition } from "./record-transition";
   11. 11
   12. 12export function markSettling(file: RegisterFile, settling: boolean): void {
   13. 13 if (settling && file.ephemeral.settling) {
   14. 14 throw new Error("A wave is already settling; the runtime handles one wave at a time.");
   15. 15 }
   16. 16 file.ephemeral.settling = settling;↑ the runtime notes whether a wave is settling
   17. 17 if (settling) file.ephemeral.nextDischargeId = 0;
   18. 18 recordTransition(file, "runtime", "SETTLING", settling ? "enter-settle" : "leave-settle");↑ the change is written into the journal
   19. 19}

   AGPL-3.0-onlyThe Lab's demonstration environment, as this fragment ran it (build 043cc8b). The code may change, and may differ from the code of a working machine.

   Nest VM core, incubated in the CoAgnes garden · build 043cc8b (2026-09-21) · this file last changed in f36e70d (2026-08-18)

At the end of the wave A return listener holding the address and waiting for the Cell's answer; a doer ready to carry it back.