Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

docs: shorten performance highlights and record Home P2P retries (#279)

Dee2cd5f93a96fa
diff --git a/README.md b/README.md
index f42747b7f..5ac231601 100644
--- a/README.md
+++ b/README.md
@@ -47,76 +47,16 @@ Code, keys and keystrokes are sealed on your machine. The relay forwards bytes i
A native app, not Electron. Close it and your agents keep working.
-We measure the workflows developers repeat, including their slow tails. Release
-build on an M2 Max; 120 observations per action, with 16 retained terminals and
-four visible:
-
-| Developer action | Idle median | Idle p95 | p95 during output |
-|---|---:|---:|---:|
-| Type → terminal echo | 11.2 ms | 18.5 ms | 74.2 ms |
-| ⌘N input-ready new harness | 10.6 ms | 15.0 ms | 14.4 ms |
-| ⌘O open anything | 12.3 ms | 16.1 ms | 16.9 ms |
-| Filter the session picker | 10.0 ms | 13.6 ms | 14.9 ms |
-| Select a session → first input echo | 26.1 ms | 31.1 ms | 35.9 ms |
-| ⌘T new tab | 13.2 ms | 18.1 ms | 18.0 ms |
-| Next tab → first input echo | 27.2 ms | 34.2 ms | 42.6 ms |
-| Focus pane → first input echo | 23.9 ms | 30.6 ms | 37.3 ms |
-| Zoom a pane | 55.3 ms | 100.9 ms | 326.0 ms |
-| Type Find query → results | 10.1 ms | 13.1 ms | 14.0 ms |
-| Scroll one viewport | 40.9 ms | 83.2 ms | 139.6 ms |
-
-Framework input to completed Flutter raster, with verified focus and results.
-Output is an eight-row ANSI redraw at 20 Hz. These use synthetic sessions;
-physical keyboard, network and display-presentation time are excluded.
-Output-heavy typing, zoom and scrolling remain the main latency targets.
-
-Real terminal round trips are measured separately, through disposable PTYs on
-actual machines. The local installed-daemon baseline is **1.1 ms median / 7.2 ms
-p95**, or 11.1 ms p95 during output (600 echoes per workload).
-
-For remote machines, we compare all three routes on the **same target** and verify
-the nominated ICE pair and both binary wire directions. Three attempts per route;
-200 echoes per workload per successful trial:
-
-| Target / route | Idle median | Idle p95 | p95 during output | Trials completed |
-|---|---:|---:|---:|---:|
-| Office iMac · Direct P2P | 14.6 ms | 135.0 ms | 37.7 ms | 1/3 |
-| Office iMac · Cloudflare TURN | 109.8 ms | 163.8 ms | 175.9 ms | 3/3 |
-| Office iMac · Harness relay | 401.4 ms | 504.7 ms | 512.0 ms | 3/3 |
-| Home iMac · Direct P2P | Unavailable | — | — | 0/3 |
-| Home iMac · Cloudflare TURN | 108.5 ms | 167.8 ms | 180.2 ms | 3/3 |
-| Home iMac · Harness relay | 384.7 ms | 503.3 ms | 501.1 ms | 3/3 |
-
-Direct P2P was fast when it connected, but its availability varied in this run.
-All five failed direct-only attempts reached their PTYs through the fallback
-relay; they are retained as unavailable P2P trials. All 5,200 measured echoes and
-390 measured control requests completed, and all 18 test terminals were deleted.
-
-Remote trials use an isolated production transport client. These round trips
-exclude UI rendering; adding independent p95 values would not produce an
-end-to-end p95. Setup and warm reattachment are measured separately.
-[Route methodology, failures, tails and raw observations](docs/performance/2026-09-23-transport-routes.md).
-
-Desktop app resource use with 1,000 seeded lines per retained terminal:
-
-| Retained terminals | App foreground / hidden CPU | App foreground / hidden footprint |
-|---|---:|---:|
-| 1 | 0.08% / 0.08% | 213 / 217 MiB |
-| 16 | 0.09% / 0.10% | 304 / 306 MiB |
-| 48 | 0.10% / 0.08% | 559 / 559 MiB |
-
-Thirty-second process snapshots; 100% CPU means one core. Memory is median
-physical footprint of the **desktop app alone**, including its terminal renderer
-and scrollback. The 213 MiB one-terminal result contains no Claude Code, Codex,
-shell, tmux, or Harness daemon process memory. Those need separate process
-measurements; their usage was not measured in this fixture. Hidden fixtures still
-recorded 12–14 interrupt wakeups/s; these measurements do not establish zero background
-work in a connected app.
-
-With 16 full 10,000-line buffers and ongoing output, the fixture used about
-957 / 960 MiB and 1.28% / 1.79% of one core in foreground / hidden samples.
-
-[Full results, workload definitions, limits and raw observations](docs/performance/2026-09-23-core-experiences.md).
+Idle measurements on an M2 Max:
+
+- **⌘N, ⌘O, ⌘T UI:** 11–13 ms median, 15–18 ms p95.
+- **Local terminal echo:** 1.1 ms median, 7.2 ms p95, excluding UI rendering.
+- **Desktop resources:** ~0.1% of one CPU core and 304 MiB, including terminal rendering and scrollback; agent CLIs and the daemon are excluded.
+
+Desktop results use a Release fixture with 16 terminals and 1,000 scrollback lines each.
+See the [workflow and resource benchmarks](docs/performance/2026-09-23-core-experiences.md)
+and [remote P2P, TURN and relay results](docs/performance/2026-09-23-transport-routes.md)
+for workloads, slow tails, connection failures and raw data.
### Built the way developers work
diff --git a/docs/performance/2026-09-23-home-p2p-rerun-data/cleanup-audit.json b/docs/performance/2026-09-23-home-p2p-rerun-data/cleanup-audit.json
new file mode 100644
index 000000000..64798094d
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-rerun-data/cleanup-audit.json
@@ -0,0 +1,10 @@
+{
+ "checkedAt": "2026-09-23T22:44:11.356Z",
+ "method": "Read-only agents_list via installed daemon; count exact disposable probe name pattern. No sessions were deleted by this audit.",
+ "results": [
+ {
+ "label": "home",
+ "remainingDisposableProbes": 0
+ }
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-rerun-data/environment.json b/docs/performance/2026-09-23-home-p2p-rerun-data/environment.json
new file mode 100644
index 000000000..8ce30d61e
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-rerun-data/environment.json
@@ -0,0 +1,12 @@
+{
+ "collectedAt": "2026-09-23T22:40:36.001262+00:00",
+ "cpu": "Apple M2 Max",
+ "memoryBytes": 68719476736,
+ "physicalCores": 12,
+ "logicalCores": 12,
+ "macOS": "26.6.2",
+ "node": "v22.23.1",
+ "arch": "arm64",
+ "werift": "0.24.4",
+ "note": "Existing workstation and remote sessions remain running. Network conditions and remote host load are not controlled."
+}
diff --git a/docs/performance/2026-09-23-home-p2p-rerun-data/home-p2p-1.json b/docs/performance/2026-09-23-home-p2p-rerun-data/home-p2p-1.json
new file mode 100644
index 000000000..0824efb1c
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-rerun-data/home-p2p-1.json
@@ -0,0 +1,101 @@
+{
+ "schema": 4,
+ "success": false,
+ "startedAt": "2026-09-23T22:40:36.531Z",
+ "label": "home",
+ "sourceRevision": "d98b3531748a8a927b7b39711822fc5c472bf8ee",
+ "boundary": "client binary input send to matching PTY probe response received; excludes UI rendering and OS keyboard input",
+ "client": {
+ "platform": "darwin",
+ "arch": "arm64",
+ "node": "v22.23.1",
+ "transportImplementation": "isolated production RemoteRelayPool from source; loopback client and relay share one Node process",
+ "installedDaemonVersionNotOnMeasuredPath": "0.2.99"
+ },
+ "samplesPerWorkload": 200,
+ "warmupsPerWorkload": 10,
+ "controlSamples": 30,
+ "controlObservations": [],
+ "observations": [],
+ "stagesMs": {
+ "select": 1444.9163330000001,
+ "readyForRequests": 1858.225375,
+ "createTerminal": 659.0735,
+ "attach": 2913.2801670000003,
+ "startProbe": 543.8582500000002,
+ "waitForRequestedRoute": 35061.291625
+ },
+ "cleanup": {
+ "created": true,
+ "deleted": true
+ },
+ "linkModes": [
+ {
+ "atMs": 6312.364125,
+ "mode": "relay"
+ }
+ ],
+ "requestedRoute": "p2p",
+ "routeVerification": "nominated ICE pair, stream membership, and both binary wire directions for each echo",
+ "targetProtocolVersion": 3,
+ "target": "Darwin:x86_64",
+ "routeAtStart": {
+ "route": "relay",
+ "ready": false,
+ "migrating": false,
+ "pair": null,
+ "sent": {
+ "p2p": 0,
+ "relay": 2
+ },
+ "received": {
+ "p2p": 0,
+ "relay": 9
+ }
+ },
+ "negotiation": "no data channel",
+ "turnHosts": [],
+ "error": "Requested p2p unavailable; actual route relay",
+ "failureDiagnostics": {
+ "outputBytes": 6541,
+ "keyframes": 1,
+ "mode": "relay",
+ "inputSeq": 0
+ },
+ "finishedAt": "2026-09-23T22:41:18.577Z",
+ "summaries": [
+ {
+ "load": "idle",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ },
+ {
+ "load": "redraw_20hz",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ }
+ ],
+ "controlSummaries": [
+ {
+ "route": "machine",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ }
+ ],
+ "summariesByTerminalMode": [],
+ "publicationRedactions": [
+ "failureDiagnostics.outputTail"
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-rerun-data/home-p2p-2.json b/docs/performance/2026-09-23-home-p2p-rerun-data/home-p2p-2.json
new file mode 100644
index 000000000..3a9088e42
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-rerun-data/home-p2p-2.json
@@ -0,0 +1,101 @@
+{
+ "schema": 4,
+ "success": false,
+ "startedAt": "2026-09-23T22:41:18.734Z",
+ "label": "home",
+ "sourceRevision": "d98b3531748a8a927b7b39711822fc5c472bf8ee",
+ "boundary": "client binary input send to matching PTY probe response received; excludes UI rendering and OS keyboard input",
+ "client": {
+ "platform": "darwin",
+ "arch": "arm64",
+ "node": "v22.23.1",
+ "transportImplementation": "isolated production RemoteRelayPool from source; loopback client and relay share one Node process",
+ "installedDaemonVersionNotOnMeasuredPath": "0.2.99"
+ },
+ "samplesPerWorkload": 200,
+ "warmupsPerWorkload": 10,
+ "controlSamples": 30,
+ "controlObservations": [],
+ "observations": [],
+ "stagesMs": {
+ "select": 1249.7510829999999,
+ "readyForRequests": 1636.802666,
+ "createTerminal": 410.49537499999997,
+ "attach": 2900.2878330000003,
+ "startProbe": 526.8844159999999,
+ "waitForRequestedRoute": 35052.218
+ },
+ "cleanup": {
+ "created": true,
+ "deleted": true
+ },
+ "linkModes": [
+ {
+ "atMs": 5244.108792,
+ "mode": "relay"
+ }
+ ],
+ "requestedRoute": "p2p",
+ "routeVerification": "nominated ICE pair, stream membership, and both binary wire directions for each echo",
+ "targetProtocolVersion": 3,
+ "target": "Darwin:x86_64",
+ "routeAtStart": {
+ "route": "relay",
+ "ready": false,
+ "migrating": false,
+ "pair": null,
+ "sent": {
+ "p2p": 0,
+ "relay": 2
+ },
+ "received": {
+ "p2p": 0,
+ "relay": 10
+ }
+ },
+ "negotiation": "no data channel",
+ "turnHosts": [],
+ "error": "Requested p2p unavailable; actual route relay",
+ "failureDiagnostics": {
+ "outputBytes": 6539,
+ "keyframes": 1,
+ "mode": "relay",
+ "inputSeq": 0
+ },
+ "finishedAt": "2026-09-23T22:41:59.951Z",
+ "summaries": [
+ {
+ "load": "idle",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ },
+ {
+ "load": "redraw_20hz",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ }
+ ],
+ "controlSummaries": [
+ {
+ "route": "machine",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ }
+ ],
+ "summariesByTerminalMode": [],
+ "publicationRedactions": [
+ "failureDiagnostics.outputTail"
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-rerun-data/home-p2p-3.json b/docs/performance/2026-09-23-home-p2p-rerun-data/home-p2p-3.json
new file mode 100644
index 000000000..b510d41f7
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-rerun-data/home-p2p-3.json
@@ -0,0 +1,101 @@
+{
+ "schema": 4,
+ "success": false,
+ "startedAt": "2026-09-23T22:42:00.120Z",
+ "label": "home",
+ "sourceRevision": "d98b3531748a8a927b7b39711822fc5c472bf8ee",
+ "boundary": "client binary input send to matching PTY probe response received; excludes UI rendering and OS keyboard input",
+ "client": {
+ "platform": "darwin",
+ "arch": "arm64",
+ "node": "v22.23.1",
+ "transportImplementation": "isolated production RemoteRelayPool from source; loopback client and relay share one Node process",
+ "installedDaemonVersionNotOnMeasuredPath": "0.2.99"
+ },
+ "samplesPerWorkload": 200,
+ "warmupsPerWorkload": 10,
+ "controlSamples": 30,
+ "controlObservations": [],
+ "observations": [],
+ "stagesMs": {
+ "select": 1223.85825,
+ "readyForRequests": 1641.062375,
+ "createTerminal": 592.21225,
+ "attach": 2885.497834,
+ "startProbe": 504.12754099999984,
+ "waitForRequestedRoute": 35032.852374999995
+ },
+ "cleanup": {
+ "created": true,
+ "deleted": true
+ },
+ "linkModes": [
+ {
+ "atMs": 5413.581375,
+ "mode": "relay"
+ }
+ ],
+ "requestedRoute": "p2p",
+ "routeVerification": "nominated ICE pair, stream membership, and both binary wire directions for each echo",
+ "targetProtocolVersion": 3,
+ "target": "Darwin:x86_64",
+ "routeAtStart": {
+ "route": "relay",
+ "ready": false,
+ "migrating": false,
+ "pair": null,
+ "sent": {
+ "p2p": 0,
+ "relay": 2
+ },
+ "received": {
+ "p2p": 0,
+ "relay": 9
+ }
+ },
+ "negotiation": "no data channel",
+ "turnHosts": [],
+ "error": "Requested p2p unavailable; actual route relay",
+ "failureDiagnostics": {
+ "outputBytes": 6567,
+ "keyframes": 1,
+ "mode": "relay",
+ "inputSeq": 0
+ },
+ "finishedAt": "2026-09-23T22:42:41.454Z",
+ "summaries": [
+ {
+ "load": "idle",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ },
+ {
+ "load": "redraw_20hz",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ }
+ ],
+ "controlSummaries": [
+ {
+ "route": "machine",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ }
+ ],
+ "summariesByTerminalMode": [],
+ "publicationRedactions": [
+ "failureDiagnostics.outputTail"
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-rerun-data/manifest.json b/docs/performance/2026-09-23-home-p2p-rerun-data/manifest.json
new file mode 100644
index 000000000..305253ac7
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-rerun-data/manifest.json
@@ -0,0 +1,53 @@
+{
+ "schema": 1,
+ "complete": true,
+ "missingTrials": [],
+ "note": "Console logs remain private. Only listed fields were removed; timings and route evidence are unchanged.",
+ "artifacts": [
+ {
+ "file": "plan.json",
+ "sha256": "fb68d73b454b20d5ed17086a9311441ab0a87fcd06468c22a873b904686f53d9",
+ "redactions": []
+ },
+ {
+ "file": "home-p2p-1.json",
+ "sha256": "175abdc9bbe81257cfa364389442079d540602f6e7cabf9624409237940c713a",
+ "sourceSha256": "e3befef9bbba9d18168704ca61093bdc5541ae03368a418c01eaec158ebef3c3",
+ "redactions": [
+ "failureDiagnostics.outputTail"
+ ]
+ },
+ {
+ "file": "home-p2p-2.json",
+ "sha256": "aa00b5ca11e344c153f83558d15fa6579b2af485f309aa8b28db4168a25d5958",
+ "sourceSha256": "c9ef049bc1cf2817edb25680fda8eda5d54d65ec8545878226abea3d32934cfc",
+ "redactions": [
+ "failureDiagnostics.outputTail"
+ ]
+ },
+ {
+ "file": "home-p2p-3.json",
+ "sha256": "fedf8f09b9dbe219f39e7de241f72b48840677598146dd283c36a65a93e48e0b",
+ "sourceSha256": "f16722d6a5e2497476ff1f2715e29a6b9fe6a8368d27da02176b358aab9c88c6",
+ "redactions": [
+ "failureDiagnostics.outputTail"
+ ]
+ },
+ {
+ "file": "environment.json",
+ "sha256": "0aff311c3f311d2cf5cb57ec22f8fcb49a0d3927461b2ad3c33686ab007fda60",
+ "redactions": []
+ },
+ {
+ "file": "cleanup-audit.json",
+ "sha256": "cd9c119c6e767f9878df6bc293ea41bf40debc423a13bf1cfa060c1efa09549b",
+ "redactions": []
+ },
+ {
+ "file": "negotiation.json",
+ "sha256": "9a3432fff40a9049553aa401f55b2fd238b8b0152d545dab9f7af741ad32e5d9",
+ "redactions": [],
+ "note": "Selected facts only; source log checksums are recorded in the artifact."
+ }
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-rerun-data/negotiation.json b/docs/performance/2026-09-23-home-p2p-rerun-data/negotiation.json
new file mode 100644
index 000000000..fa06372a8
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-rerun-data/negotiation.json
@@ -0,0 +1,56 @@
+{
+ "note": "Selected negotiation facts extracted from private logs. Machine identifiers and all other log content are omitted. Timeouts are connection setup observations, not terminal echo latencies.",
+ "trials": [
+ {
+ "trial": "home-p2p-1.json",
+ "reason": "negotiation_timeout",
+ "negotiationElapsedMs": 25000,
+ "answerReceived": true,
+ "localCandidateTypes": [
+ "host",
+ "srflx"
+ ],
+ "remoteCandidateTypes": [
+ "host",
+ "srflx"
+ ],
+ "iceState": "connecting",
+ "fallbackRoute": "relay",
+ "privateSourceLogSha256": "8bf00c22a1cf3f2935a8ddb0ea37be7e958ec404c9fb282099f302cde62c93d3"
+ },
+ {
+ "trial": "home-p2p-2.json",
+ "reason": "negotiation_timeout",
+ "negotiationElapsedMs": 25000,
+ "answerReceived": true,
+ "localCandidateTypes": [
+ "host",
+ "srflx"
+ ],
+ "remoteCandidateTypes": [
+ "host",
+ "srflx"
+ ],
+ "iceState": "connecting",
+ "fallbackRoute": "relay",
+ "privateSourceLogSha256": "de7f89ebecae5f4756f7f1901e656edf0cc1553199293c0a5ae1c43b2875baf0"
+ },
+ {
+ "trial": "home-p2p-3.json",
+ "reason": "negotiation_timeout",
+ "negotiationElapsedMs": 25001,
+ "answerReceived": true,
+ "localCandidateTypes": [
+ "host",
+ "srflx"
+ ],
+ "remoteCandidateTypes": [
+ "host",
+ "srflx"
+ ],
+ "iceState": "connecting",
+ "fallbackRoute": "relay",
+ "privateSourceLogSha256": "523c2c08ee0948c97ac097676a7fd33e3a6b7de697ab937d94a2a8834ad16789"
+ }
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-rerun-data/plan.json b/docs/performance/2026-09-23-home-p2p-rerun-data/plan.json
new file mode 100644
index 000000000..1dacb107e
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-rerun-data/plan.json
@@ -0,0 +1,28 @@
+{
+ "schema": 1,
+ "sourceRevision": "d98b3531748a8a927b7b39711822fc5c472bf8ee",
+ "samplesPerWorkload": 200,
+ "controlSamples": 30,
+ "createdAt": "2026-09-23T22:39:59.442861+00:00",
+ "purpose": "Three planned Home iMac direct-only follow-up trials; retain original 0/3 result separately.",
+ "trials": [
+ {
+ "label": "home",
+ "route": "p2p",
+ "repetition": 1,
+ "file": "home-p2p-1.json"
+ },
+ {
+ "label": "home",
+ "route": "p2p",
+ "repetition": 2,
+ "file": "home-p2p-2.json"
+ },
+ {
+ "label": "home",
+ "route": "p2p",
+ "repetition": 3,
+ "file": "home-p2p-3.json"
+ }
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-rerun.md b/docs/performance/2026-09-23-home-p2p-rerun.md
new file mode 100644
index 000000000..bf790dae6
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-rerun.md
@@ -0,0 +1,97 @@
+# Home iMac direct P2P: follow-up measurements
+
+**Direct P2P did not establish in any of six follow-up trials.** Combined with the
+[original comparison](2026-09-23-transport-routes.md), this is **0/9 attempts** on
+the Home iMac across three series. There are no verified Home P2P echoes from
+which to calculate a median or tail latency.
+
+Two series of three trials ran serially on September 23, 2026, from **22:40:36 to
+22:42:41 UTC** and **22:56:28 to 22:58:33 UTC**. Each created a disposable
+terminal, started the Python probe,
+and reached it through the Harness WebSocket relay while attempting direct
+negotiation. Every terminal was deleted afterward.
+
+| Series / trial | Direct negotiation timeout | Wait after probe readiness | Route at end of wait | Terminal deleted |
+|---|---:|---:|---|---|
+| First retry / 1 | 25,000 ms | 35,061 ms | Harness relay | Yes |
+| First retry / 2 | 25,000 ms | 35,052 ms | Harness relay | Yes |
+| First retry / 3 | 25,001 ms | 35,033 ms | Harness relay | Yes |
+| Second retry / 1 | 25,001 ms | 35,076 ms | Harness relay | Yes |
+| Second retry / 2 | 25,002 ms | 35,092 ms | Harness relay | Yes |
+| Second retry / 3 | 25,001 ms | 35,035 ms | Harness relay | Yes |
+
+These are setup timings. Negotiation starts before probe readiness, so the
+two timing columns have different start points. Neither is a terminal echo
+latency or an application outage duration.
+
+## What the observations establish
+
+All six negotiations received an answer and reported host and server-reflexive
+candidate types on both sides, then timed out while reporting `ice=connecting`.
+At the end of the probe's 35-second route wait, each trial recorded no nominated
+candidate pair, no ready data channel, and zero binary sends or deliveries over
+P2P. Probe startup traffic used the relay in both directions. The
+[first](2026-09-23-home-p2p-rerun-data/negotiation.json) and
+[second](2026-09-23-home-p2p-retry2-data/negotiation.json) negotiation records preserve
+those facts from the private logs without machine identifiers or candidate addresses.
+
+The results establish that a direct path was unavailable under these test
+conditions. They do not isolate a firewall, NAT, network interface, or
+implementation as the cause. Terminal creation and probe startup succeeded;
+the failure was specific to establishing the requested direct route.
+
+The planned workload was 200 measured echoes at idle and 200 during a 20 Hz
+redraw, plus 30 control requests per successful trial. The route check stopped
+all six trials before those measurement phases, leaving **zero measured echoes
+and zero measured control requests** in these follow-ups. Relay startup responses are
+not included as P2P observations. The earlier 5,200 echoes and 390 control
+measurements remain the latency data in the linked transport report.
+
+## Method and environment
+
+The [first plan](2026-09-23-home-p2p-rerun-data/plan.json) and
+[second plan](2026-09-23-home-p2p-retry2-data/plan.json) each fixed three attempts
+before their first connection. No attempt was discarded or replaced. The source
+revisions were `d98b3531748a8a927b7b39711822fc5c472bf8ee` and
+`853239bb737599d71a659889e8315a9e3beb6d31`, respectively. Product and benchmark
+source were unchanged between the two reruns; the route-proof checks passed
+before the first. The same isolated production transport method as
+the original comparison removed TURN credentials for each direct-only offer
+and required a nominated pair with no relay candidate before measuring echoes.
+
+The client was an Apple M2 Max with 64 GiB RAM, macOS 26.6.2, Node 22.23.1, and
+werift 0.24.4. The remote probe reported Darwin/x86_64 and terminal protocol 3.
+The installed local daemon reported 0.2.99 and was outside the measured
+transport path. The environment records for the
+[first](2026-09-23-home-p2p-rerun-data/environment.json) and
+[second](2026-09-23-home-p2p-retry2-data/environment.json) reruns note that other
+applications and sessions remained running; network conditions
+and remote load were not controlled. These attempts do not establish a general
+P2P success rate across users or networks.
+
+All six deletion replies confirmed cleanup. Separate read-only inventory audits
+at [22:44 UTC](2026-09-23-home-p2p-rerun-data/cleanup-audit.json) and
+[22:59 UTC](2026-09-23-home-p2p-retry2-data/cleanup-audit.json) found zero disposable
+probes remaining on Home.
+
+## Artifacts and reproduction
+
+The [first manifest](2026-09-23-home-p2p-rerun-data/manifest.json) and
+[second manifest](2026-09-23-home-p2p-retry2-data/manifest.json) record SHA-256 hashes
+and explicit redactions. Only shell-output diagnostic tails were removed from
+the six trial results; their timing, route evidence, errors, and cleanup
+records are preserved. Console logs remain private, with selected negotiation
+facts published separately.
+
+Use the [real terminal probe](../../cli/scripts/benchmark-terminal-latency.md)
+with `--route p2p`, a linked Home machine ID, 200 samples and 30 control samples.
+Keep each of three serial attempts in a fresh file and retain failed attempts.
+Validate the published series with:
+
+```sh
+python3 cli/scripts/summarize-route-benchmarks.py \
+ docs/performance/2026-09-23-home-p2p-rerun-data
+
+python3 cli/scripts/summarize-route-benchmarks.py \
+ docs/performance/2026-09-23-home-p2p-retry2-data
+```
diff --git a/docs/performance/2026-09-23-home-p2p-retry2-data/cleanup-audit.json b/docs/performance/2026-09-23-home-p2p-retry2-data/cleanup-audit.json
new file mode 100644
index 000000000..1f329dfd9
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-retry2-data/cleanup-audit.json
@@ -0,0 +1,10 @@
+{
+ "checkedAt": "2026-09-23T22:59:26.048Z",
+ "method": "Read-only agents_list via installed daemon; count exact disposable probe name pattern. No sessions were deleted by this audit.",
+ "results": [
+ {
+ "label": "home",
+ "remainingDisposableProbes": 0
+ }
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-retry2-data/environment.json b/docs/performance/2026-09-23-home-p2p-retry2-data/environment.json
new file mode 100644
index 000000000..de28cacec
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-retry2-data/environment.json
@@ -0,0 +1,12 @@
+{
+ "collectedAt": "2026-09-23T22:56:27.765254+00:00",
+ "cpu": "Apple M2 Max",
+ "memoryBytes": 68719476736,
+ "physicalCores": 12,
+ "logicalCores": 12,
+ "macOS": "26.6.2",
+ "node": "v22.23.1",
+ "arch": "arm64",
+ "werift": "0.24.4",
+ "note": "Existing workstation and remote sessions remain running. Network conditions and remote host load are not controlled."
+}
diff --git a/docs/performance/2026-09-23-home-p2p-retry2-data/home-p2p-1.json b/docs/performance/2026-09-23-home-p2p-retry2-data/home-p2p-1.json
new file mode 100644
index 000000000..b454fb45d
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-retry2-data/home-p2p-1.json
@@ -0,0 +1,101 @@
+{
+ "schema": 4,
+ "success": false,
+ "startedAt": "2026-09-23T22:56:28.011Z",
+ "label": "home",
+ "sourceRevision": "853239bb737599d71a659889e8315a9e3beb6d31",
+ "boundary": "client binary input send to matching PTY probe response received; excludes UI rendering and OS keyboard input",
+ "client": {
+ "platform": "darwin",
+ "arch": "arm64",
+ "node": "v22.23.1",
+ "transportImplementation": "isolated production RemoteRelayPool from source; loopback client and relay share one Node process",
+ "installedDaemonVersionNotOnMeasuredPath": "0.2.99"
+ },
+ "samplesPerWorkload": 200,
+ "warmupsPerWorkload": 10,
+ "controlSamples": 30,
+ "controlObservations": [],
+ "observations": [],
+ "stagesMs": {
+ "select": 1351.952916,
+ "readyForRequests": 1731.399375,
+ "createTerminal": 621.623458,
+ "attach": 3005.55225,
+ "startProbe": 666.8720000000003,
+ "waitForRequestedRoute": 35076.086625
+ },
+ "cleanup": {
+ "created": true,
+ "deleted": true
+ },
+ "linkModes": [
+ {
+ "atMs": 5777.718542,
+ "mode": "relay"
+ }
+ ],
+ "requestedRoute": "p2p",
+ "routeVerification": "nominated ICE pair, stream membership, and both binary wire directions for each echo",
+ "targetProtocolVersion": 3,
+ "target": "Darwin:x86_64",
+ "routeAtStart": {
+ "route": "relay",
+ "ready": false,
+ "migrating": false,
+ "pair": null,
+ "sent": {
+ "p2p": 0,
+ "relay": 2
+ },
+ "received": {
+ "p2p": 0,
+ "relay": 9
+ }
+ },
+ "negotiation": "no data channel",
+ "turnHosts": [],
+ "error": "Requested p2p unavailable; actual route relay",
+ "failureDiagnostics": {
+ "outputBytes": 6541,
+ "keyframes": 1,
+ "mode": "relay",
+ "inputSeq": 0
+ },
+ "finishedAt": "2026-09-23T22:57:09.892Z",
+ "summaries": [
+ {
+ "load": "idle",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ },
+ {
+ "load": "redraw_20hz",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ }
+ ],
+ "controlSummaries": [
+ {
+ "route": "machine",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ }
+ ],
+ "summariesByTerminalMode": [],
+ "publicationRedactions": [
+ "failureDiagnostics.outputTail"
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-retry2-data/home-p2p-2.json b/docs/performance/2026-09-23-home-p2p-retry2-data/home-p2p-2.json
new file mode 100644
index 000000000..bbf09c46d
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-retry2-data/home-p2p-2.json
@@ -0,0 +1,101 @@
+{
+ "schema": 4,
+ "success": false,
+ "startedAt": "2026-09-23T22:57:10.063Z",
+ "label": "home",
+ "sourceRevision": "853239bb737599d71a659889e8315a9e3beb6d31",
+ "boundary": "client binary input send to matching PTY probe response received; excludes UI rendering and OS keyboard input",
+ "client": {
+ "platform": "darwin",
+ "arch": "arm64",
+ "node": "v22.23.1",
+ "transportImplementation": "isolated production RemoteRelayPool from source; loopback client and relay share one Node process",
+ "installedDaemonVersionNotOnMeasuredPath": "0.2.99"
+ },
+ "samplesPerWorkload": 200,
+ "warmupsPerWorkload": 10,
+ "controlSamples": 30,
+ "controlObservations": [],
+ "observations": [],
+ "stagesMs": {
+ "select": 1323.742042,
+ "readyForRequests": 1883.0370830000002,
+ "createTerminal": 435.0052499999997,
+ "attach": 2896.946584,
+ "startProbe": 503.2863749999997,
+ "waitForRequestedRoute": 35091.561
+ },
+ "cleanup": {
+ "created": true,
+ "deleted": true
+ },
+ "linkModes": [
+ {
+ "atMs": 5498.089792,
+ "mode": "relay"
+ }
+ ],
+ "requestedRoute": "p2p",
+ "routeVerification": "nominated ICE pair, stream membership, and both binary wire directions for each echo",
+ "targetProtocolVersion": 3,
+ "target": "Darwin:x86_64",
+ "routeAtStart": {
+ "route": "relay",
+ "ready": false,
+ "migrating": false,
+ "pair": null,
+ "sent": {
+ "p2p": 0,
+ "relay": 2
+ },
+ "received": {
+ "p2p": 0,
+ "relay": 11
+ }
+ },
+ "negotiation": "no data channel",
+ "turnHosts": [],
+ "error": "Requested p2p unavailable; actual route relay",
+ "failureDiagnostics": {
+ "outputBytes": 6567,
+ "keyframes": 1,
+ "mode": "relay",
+ "inputSeq": 0
+ },
+ "finishedAt": "2026-09-23T22:57:51.592Z",
+ "summaries": [
+ {
+ "load": "idle",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ },
+ {
+ "load": "redraw_20hz",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ }
+ ],
+ "controlSummaries": [
+ {
+ "route": "machine",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ }
+ ],
+ "summariesByTerminalMode": [],
+ "publicationRedactions": [
+ "failureDiagnostics.outputTail"
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-retry2-data/home-p2p-3.json b/docs/performance/2026-09-23-home-p2p-retry2-data/home-p2p-3.json
new file mode 100644
index 000000000..594cd88a1
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-retry2-data/home-p2p-3.json
@@ -0,0 +1,101 @@
+{
+ "schema": 4,
+ "success": false,
+ "startedAt": "2026-09-23T22:57:51.791Z",
+ "label": "home",
+ "sourceRevision": "853239bb737599d71a659889e8315a9e3beb6d31",
+ "boundary": "client binary input send to matching PTY probe response received; excludes UI rendering and OS keyboard input",
+ "client": {
+ "platform": "darwin",
+ "arch": "arm64",
+ "node": "v22.23.1",
+ "transportImplementation": "isolated production RemoteRelayPool from source; loopback client and relay share one Node process",
+ "installedDaemonVersionNotOnMeasuredPath": "0.2.99"
+ },
+ "samplesPerWorkload": 200,
+ "warmupsPerWorkload": 10,
+ "controlSamples": 30,
+ "controlObservations": [],
+ "observations": [],
+ "stagesMs": {
+ "select": 1610.012583,
+ "readyForRequests": 1992.787792,
+ "createTerminal": 537.6662080000001,
+ "attach": 2893.4434159999996,
+ "startProbe": 522.2952079999995,
+ "waitForRequestedRoute": 35034.796500000004
+ },
+ "cleanup": {
+ "created": true,
+ "deleted": true
+ },
+ "linkModes": [
+ {
+ "atMs": 5702.239625,
+ "mode": "relay"
+ }
+ ],
+ "requestedRoute": "p2p",
+ "routeVerification": "nominated ICE pair, stream membership, and both binary wire directions for each echo",
+ "targetProtocolVersion": 3,
+ "target": "Darwin:x86_64",
+ "routeAtStart": {
+ "route": "relay",
+ "ready": false,
+ "migrating": false,
+ "pair": null,
+ "sent": {
+ "p2p": 0,
+ "relay": 2
+ },
+ "received": {
+ "p2p": 0,
+ "relay": 10
+ }
+ },
+ "negotiation": "no data channel",
+ "turnHosts": [],
+ "error": "Requested p2p unavailable; actual route relay",
+ "failureDiagnostics": {
+ "outputBytes": 6567,
+ "keyframes": 1,
+ "mode": "relay",
+ "inputSeq": 0
+ },
+ "finishedAt": "2026-09-23T22:58:33.510Z",
+ "summaries": [
+ {
+ "load": "idle",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ },
+ {
+ "load": "redraw_20hz",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ }
+ ],
+ "controlSummaries": [
+ {
+ "route": "machine",
+ "samples": 0,
+ "failures": 0,
+ "p50Ms": null,
+ "p95Ms": null,
+ "p99Ms": null,
+ "maxMs": null
+ }
+ ],
+ "summariesByTerminalMode": [],
+ "publicationRedactions": [
+ "failureDiagnostics.outputTail"
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-retry2-data/manifest.json b/docs/performance/2026-09-23-home-p2p-retry2-data/manifest.json
new file mode 100644
index 000000000..5e0e7aac1
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-retry2-data/manifest.json
@@ -0,0 +1,53 @@
+{
+ "schema": 1,
+ "complete": true,
+ "missingTrials": [],
+ "note": "Console logs remain private. Only listed fields were removed; timings and route evidence are unchanged.",
+ "artifacts": [
+ {
+ "file": "plan.json",
+ "sha256": "ef0798e4b9f7c12ffb1c4023b8d4aadaebbb4d74e96dbcea3f9c70ad25c2f140",
+ "redactions": []
+ },
+ {
+ "file": "home-p2p-1.json",
+ "sha256": "7ab451a48b8ffc38576bbad344d55ea50a369b7926330cb5d9fee4d7279f8cbd",
+ "sourceSha256": "eb95c05cf02a0a88d821d6b5d04c2b1c893c4876b96453953950987a75dc9893",
+ "redactions": [
+ "failureDiagnostics.outputTail"
+ ]
+ },
+ {
+ "file": "home-p2p-2.json",
+ "sha256": "9b83746457f87b2f8462982549d0a206bbcd8337430cd1c958b84bf6215370b3",
+ "sourceSha256": "fbb1cfb952363d969cf19b0dbc0b8dcb5900e38c1d54a7bd256964835f463841",
+ "redactions": [
+ "failureDiagnostics.outputTail"
+ ]
+ },
+ {
+ "file": "home-p2p-3.json",
+ "sha256": "3e4651fb901617e66a48ac168580b3c6ba1f7201e16594b4c378243ea412021e",
+ "sourceSha256": "4e6c72281c13acffb528e9ab3f0c0bc44ef2ddd5aba64359960fb2db15da8861",
+ "redactions": [
+ "failureDiagnostics.outputTail"
+ ]
+ },
+ {
+ "file": "environment.json",
+ "sha256": "7c9f7a672c687fe4034398874eab30f997ebb0156822dac6b525b08203320867",
+ "redactions": []
+ },
+ {
+ "file": "cleanup-audit.json",
+ "sha256": "66cfd22f10c1143d742499dc6485f518dffcb4933a7d5e30c0b039b3643c2412",
+ "redactions": []
+ },
+ {
+ "file": "negotiation.json",
+ "sha256": "2f050728d36be7e7d10e0834718ae2a18822841f0689666255db079f2eeb6250",
+ "redactions": [],
+ "note": "Selected facts only; source log checksums are recorded in the artifact."
+ }
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-retry2-data/negotiation.json b/docs/performance/2026-09-23-home-p2p-retry2-data/negotiation.json
new file mode 100644
index 000000000..aa9e19beb
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-retry2-data/negotiation.json
@@ -0,0 +1,56 @@
+{
+ "note": "Selected negotiation facts extracted from private logs. Machine identifiers and all other log content are omitted. Timeouts are connection setup observations, not terminal echo latencies.",
+ "trials": [
+ {
+ "trial": "home-p2p-1.json",
+ "reason": "negotiation_timeout",
+ "negotiationElapsedMs": 25001,
+ "answerReceived": true,
+ "localCandidateTypes": [
+ "host",
+ "srflx"
+ ],
+ "remoteCandidateTypes": [
+ "host",
+ "srflx"
+ ],
+ "iceState": "connecting",
+ "fallbackRoute": "relay",
+ "privateSourceLogSha256": "1515dadecb77245f43210f1c1918f79ccaa1866d1bff8e41e936aff4af0fe831"
+ },
+ {
+ "trial": "home-p2p-2.json",
+ "reason": "negotiation_timeout",
+ "negotiationElapsedMs": 25002,
+ "answerReceived": true,
+ "localCandidateTypes": [
+ "host",
+ "srflx"
+ ],
+ "remoteCandidateTypes": [
+ "host",
+ "srflx"
+ ],
+ "iceState": "connecting",
+ "fallbackRoute": "relay",
+ "privateSourceLogSha256": "5151fd350ed5d0d30195f3bee5c84eb51a142d138366cb7bc33dd5bd57155230"
+ },
+ {
+ "trial": "home-p2p-3.json",
+ "reason": "negotiation_timeout",
+ "negotiationElapsedMs": 25001,
+ "answerReceived": true,
+ "localCandidateTypes": [
+ "host",
+ "srflx"
+ ],
+ "remoteCandidateTypes": [
+ "host",
+ "srflx"
+ ],
+ "iceState": "connecting",
+ "fallbackRoute": "relay",
+ "privateSourceLogSha256": "cf58760a73467bf8a2da1ea780962a6c7aef7b45c7dfee874cd920f5c2216c66"
+ }
+ ]
+}
diff --git a/docs/performance/2026-09-23-home-p2p-retry2-data/plan.json b/docs/performance/2026-09-23-home-p2p-retry2-data/plan.json
new file mode 100644
index 000000000..7558648fb
--- /dev/null
+++ b/docs/performance/2026-09-23-home-p2p-retry2-data/plan.json
@@ -0,0 +1,28 @@
+{
+ "schema": 1,
+ "sourceRevision": "853239bb737599d71a659889e8315a9e3beb6d31",
+ "samplesPerWorkload": 200,
+ "controlSamples": 30,
+ "createdAt": "2026-09-23T22:56:27.764090+00:00",
+ "purpose": "Second requested Home direct-P2P follow-up: three fixed attempts, retaining all earlier failures separately.",
+ "trials": [
+ {
+ "label": "home",
+ "route": "p2p",
+ "repetition": 1,
+ "file": "home-p2p-1.json"
+ },
+ {
+ "label": "home",
+ "route": "p2p",
+ "repetition": 2,
+ "file": "home-p2p-2.json"
+ },
+ {
+ "label": "home",
+ "route": "p2p",
+ "repetition": 3,
+ "file": "home-p2p-3.json"
+ }
+ ]
+}
diff --git a/docs/performance/2026-09-23-transport-routes.md b/docs/performance/2026-09-23-transport-routes.md
index 5d8e445c8..9c95f632a 100644
--- a/docs/performance/2026-09-23-transport-routes.md
+++ b/docs/performance/2026-09-23-transport-routes.md
@@ -1,5 +1,10 @@
# Remote terminal latency by verified transport
+**Follow-up:** [Six additional Home iMac P2P trials](2026-09-23-home-p2p-rerun.md)
+at 22:40–22:42 and 22:56–22:58 UTC on September 23 also could not establish a
+direct path. Home P2P availability is now 0/9 across the three series. The original comparison below
+retains its original attempts and observations.
+
Verified Office terminal echo medians were **14.6 ms over direct P2P**, **109.8 ms
through Cloudflare TURN**, and **401.4 ms through the Harness WebSocket relay**.
Direct-only negotiation succeeded in one of three Office trials and none of three