Commit Graph
4 Commits
Author SHA1 Message Date
Brennan Benson e116d79326 docs(ssh): keep boundary references stable 2026-08-16 18:46:44 -07:00
Brennan Benson 742508e3d8 docs(ssh): require host evidence for liveness verdicts 2026-08-16 18:42:21 -07:00
Brennan Benson fd993c8a54 docs(ssh): cite the live restoreRequired site after it moved
The throw now lives in reattachSshPtySessionForSpawn; ssh-pty-provider.ts no
longer contains it. Caught by the worker fixing it, against a newer main than
the audit ran on.
2026-08-16 16:07:02 -07:00
Brennan Benson d758e3b214 docs(ssh): state the SSH execution boundary and pin the liveness vocabulary
Nothing under docs/ described how work splits between the client and an SSH
host, so agents and humans inferred it from error strings and got it wrong:
loss of contact was repeatedly reported as process death, which orphaned live
remote agents and cold-started duplicates over the same worktree.

Pins the vocabulary to the incumbent live/unverifiable/exited verdict from
unstopped-pty-verification so no synonym is introduced, records the one real
discriminator (all of a host's terminals drop together on link loss; one alone
means process exit), and lists the outstanding gaps with citations.

Tracked via the docs allow-list and linked from AGENTS.md, per the convention
in .gitignore.
2026-08-16 15:42:08 -07:00