Skip to content

Require epoch-bound guest readiness acknowledgment - #117

Draft
jiashuoz wants to merge 1 commit into
feat/guest-reconnect-transportfrom
feat/guest-reconnect-readiness
Draft

jiashuoz wants to merge 1 commit into
feat/guest-reconnect-transportfrom
feat/guest-reconnect-readiness

Conversation

@jiashuoz

@jiashuoz jiashuoz commented Oct 1, 2026 •

Copy link
Copy Markdown
Member

The reconnecting guest currently returns its stream immediately after applying configuration, leaving the host without a readiness boundary before ordinary relay traffic can interleave. Add strict guest_reconnect_ready / guest_reconnect_ready_ack frames tied to the accepted epoch. The guest stays offline until a matching acknowledgment arrives within five seconds (also bounded by delivery TTL and caller cancellation).

Lost, malformed, wrong-epoch or late acknowledgments fail closed. The consumed epoch/token require a fresh signed attempt. The executable TCP probe drops an acknowledgment and reconnects with a fresh epoch while retaining the same PTY shell process. Existing fresh boot remains unchanged.

Depends on #116; base is feat/guest-reconnect-transport. This is still a disabled protocol prerequisite: no shipping listener enablement, fresh host configuration resolver, guarded relay takeover or deployment. The design document records required host ownership checks and acknowledgment/publication ordering.

Validation: full Linux CI passed (run 36816477521): make verify including Docker tests, non-root jail ownership, CLI/client race tests, and fleet syntax. Sessiond, relay and shared protocol race suites also pass locally. The built guest executable TCP/PTY probe passed after the local suite. Local make verify passes with Docker explicitly unavailable; the initial Docker attempt encountered the existing credential-helper/registry problem, and an existing latency cleanup timing failure passed in isolation. Independent and adversarial reviews passed with no required findings. Additional adversarial race-enabled probes passed the actual five-second blocked-write/read deadlines and pipelined-byte continuity.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant