Skip to content

Commit 6c41638

Browse files
authored
docs: define session ref-frame lifetime (#1247)
* docs: define session ref-frame lifetime * docs: address ref-frame ADR review * docs: resolve ref-frame contract blockers
1 parent 59a75d2 commit 6c41638

3 files changed

Lines changed: 473 additions & 0 deletions

File tree

docs/adr/0012-interactive-replay.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -463,6 +463,12 @@ every `screen` ref with `refsGeneration` before returning it, including on the e
463463
client callers receive the unpinned refs and generation already present in the daemon error. No caller
464464
gets a text-only divergence that loses its repair data.
465465

466+
> **Proposed ADR 0014 amendment:** if ADR 0014 is accepted and implemented, replay divergence
467+
> `screen.refs` becomes a partial ref publication. MCP keeps auto-pinning those refs; CLI text renders
468+
> `@eN~s<refsGeneration>`; JSON and Node.js callers pair each plain ref with the response-level
469+
> generation before mutation. Until that migration lands, the current unpinned contract above remains
470+
> accepted. The implementation must update this note and its contract tests in the same change.
471+
466472
`--from N` is a `replay`-only flag. `test` must reject it as `INVALID_ARGS`; test shares replay execution
467473
but must remain a full, deterministic suite run. `N` is a 1-based index into the fully expanded
468474
executable plan and must be in range. It is never a YAML line number, fractional source-step number, or a

0 commit comments

Comments
 (0)