@junghanacs/entwurf 0.41.1 → 0.41.2

package/scripts/mutants/remote-pair-roundtrip.json

@@ -6,9 +6,9 @@
 			"claim": "REMOTE-ROUNDTRIP-A-TO-B",
 			"title": "the bridge never reads the opt-in, so a declared remote target falls through to the local decider as bad-target",
 			"subject": "mcp/entwurf-bridge/src/index.ts",
-			"find": ["\t\t\t\t\troute: readRemotePairOptIn(remotePairOptInPath()),"],
-			"replace": ["\t\t\t\t\troute: null,"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"find": ["\t\t\t\t\toptIn: readRemotePairOptIn(remotePairOptInPath()),"],
+			"replace": ["\t\t\t\t\toptIn: null,"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUNDTRIP-A-TO-B]",
 			"signatureSource": "pi-extensions/lib/remote-pair-roundtrip.test.ts",
@@ -25,7 +25,7 @@
 			"replace": [
 				"\t\t\t\t\ttransport: { run: async () => ({ exitCode: 1, signal: null, timedOut: false, stdout: \"\", stderr: \"\" }) },"
 			],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUNDTRIP-REVERSE-DISPATCH]",
 			"signatureSource": "pi-extensions/lib/remote-pair-roundtrip.test.ts",
@@ -40,7 +40,7 @@
 			"subject": "mcp/entwurf-bridge/src/index.ts",
 			"find": ["\t\t\t\t\trunLocal: (params, opts) => runAndRenderEntwurfV2FromSurface(params, opts),"],
 			"replace": ["\t\t\t\t\trunLocal: async () => ({ isError: false, text: \"local skipped\" }),"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUNDTRIP-OPT-IN-ABSENT-OFF]",
 			"signatureSource": "pi-extensions/lib/remote-pair-roundtrip.test.ts",
@@ -55,7 +55,7 @@
 			"subject": "pi-extensions/lib/remote-pair-send.ts",
 			"find": ["refused by the other host's pair: ${o.reason} (${o.detail})"],
 			"replace": ["failed"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUNDTRIP-OTHER-HOST-REFUSES]",
 			"signatureSource": "pi-extensions/lib/remote-pair-roundtrip.test.ts",
@@ -70,7 +70,7 @@
 			"subject": "mcp/entwurf-bridge/src/index.ts",
 			"find": ["\t\t\t\t\t\tcontrolSocketDirs: [CONTROL_SOCKET_DIR, ENTWURF_DIR],"],
 			"replace": ["\t\t\t\t\t\tcontrolSocketDirs: [ENTWURF_DIR],"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUNDTRIP-LOCAL-TRACE-BOTH-SOCKET-DIRS]",
 			"signatureSource": "pi-extensions/lib/remote-pair-roundtrip.test.ts",
@@ -78,6 +78,66 @@
 				"argv": ["bash", "scripts/build-bridge.sh"],
 				"output": "mcp/entwurf-bridge/dist"
 			}
+		},
+		{
+			"claim": "REMOTE-ROUNDTRIP-MULTI-INDEPENDENT",
+			"title": "the receiving entry reads only the first route of its file, so a second citizen paired with this host is refused as an undeclared sender",
+			"subject": "scripts/remote-pair-receive.ts",
+			"find": ["\tdecls = optIn.routes.map("],
+			"replace": ["\tdecls = optIn.routes.slice(0, 1).map("],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUNDTRIP-MULTI-INDEPENDENT]",
+			"signatureSource": "pi-extensions/lib/remote-pair-roundtrip.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
+		},
+		{
+			"claim": "REMOTE-ROUNDTRIP-MULTI-REVERSE",
+			"title": "the receiving side recognizes only the first route's remote as a sender, so a claim from a second host lands on the wrong route or is refused",
+			"subject": "pi-extensions/lib/remote-pair-receive.ts",
+			"find": ["\tconst fromRoutes = decls.filter((d) => d.remoteGardenId === claim.from);"],
+			"replace": ["\tconst fromRoutes = decls.filter((d) => d.remoteGardenId === decls[0].remoteGardenId);"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUNDTRIP-MULTI-REVERSE]",
+			"signatureSource": "pi-extensions/lib/remote-pair-roundtrip.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
+		},
+		{
+			"claim": "REMOTE-ROUNDTRIP-MULTI-UNDECLARED-SENDER-ZERO-SSH",
+			"title": "a sender with no route to a declared remote borrows another sender's route, so ssh runs and the other host is asked to accept a pair nobody declared",
+			"subject": "pi-extensions/lib/remote-pair-send.ts",
+			"find": ["? declared.find((r) => r.localGardenId === sender.sessionId) :"],
+			"replace": ["? (declared.find((r) => r.localGardenId === sender.sessionId) ?? declared[0]) :"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUNDTRIP-MULTI-UNDECLARED-SENDER-ZERO-SSH]",
+			"signatureSource": "pi-extensions/lib/remote-pair-roundtrip.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
+		},
+		{
+			"claim": "REMOTE-ROUNDTRIP-MULTI-CROSS-CLAIM-REFUSED",
+			"title": "the target is matched against every route rather than the sender's own, so a peer that declares an extra pair on its side widens this host's",
+			"subject": "pi-extensions/lib/remote-pair-receive.ts",
+			"find": ["\tconst decl = fromRoutes.find((d) => d.localGardenId === claim.target);"],
+			"replace": ["\tconst decl = decls.find((d) => d.localGardenId === claim.target);"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUNDTRIP-MULTI-CROSS-CLAIM-REFUSED]",
+			"signatureSource": "pi-extensions/lib/remote-pair-roundtrip.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
 		}
 	]
 }

package/scripts/mutants/remote-pair-send.json

@@ -6,9 +6,9 @@
 			"claim": "REMOTE-ROUTE-UNDECLARED-LOCAL-UNCHANGED",
 			"title": "a declared route captures every target, so a gid the declaration never named is sent to the other host instead of the local decider",
 			"subject": "pi-extensions/lib/remote-pair-send.ts",
-			"find": ["\tif (route === null || params.target !== route.remoteGardenId) {"],
-			"replace": ["\tif (route === null) {"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"find": ["\tconst declared = (opts.optIn?.routes ?? []).filter((r) => r.remoteGardenId === params.target);"],
+			"replace": ["\tconst declared = opts.optIn?.routes ?? [];"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUTE-UNDECLARED-LOCAL-UNCHANGED]",
 			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
@@ -21,9 +21,9 @@
 			"claim": "REMOTE-ROUTE-LOCAL-CONFLICT-FAILS-CLOSED",
 			"title": "a declared remote gid that this host also answers to is sent away anyway, so two hosts' citizens share one address and the sender silently picks the remote",
 			"subject": "pi-extensions/lib/remote-pair-send.ts",
-			"find": ["\tif (await opts.localTrace(route.remoteGardenId)) {"],
+			"find": ["\tif (await opts.localTrace(params.target)) {"],
 			"replace": ["\tif (Boolean(0)) {"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUTE-LOCAL-CONFLICT-FAILS-CLOSED]",
 			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
@@ -36,9 +36,9 @@
 			"claim": "REMOTE-ROUTE-SENDER-MUST-BE-DECLARED",
 			"title": "any present envelope may use the route, so an anonymous caller or another citizen on this host speaks to the other host as the declared sender",
 			"subject": "pi-extensions/lib/remote-pair-send.ts",
-			"find": ["\tif (!sender || sender.origin === \"external-mcp\" || sender.sessionId !== route.localGardenId) {"],
-			"replace": ["\tif (!sender || Boolean(0)) {"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"find": ["\t\tsender && sender.origin !== \"external-mcp\""],
+			"replace": ["\t\tsender"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUTE-SENDER-MUST-BE-DECLARED]",
 			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
@@ -53,7 +53,7 @@
 			"subject": "pi-extensions/lib/remote-pair-send.ts",
 			"find": ["\t\t\"BatchMode=yes\","],
 			"replace": ["\t\t\"BatchMode=no\","],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUTE-EXACT-ARGV-ONCE]",
 			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
@@ -70,7 +70,7 @@
 			"replace": [
 				"\tawait opts.transport.run(remoteReceiveArgv(route), JSON.stringify(claim), 1);\n\tconst result = await opts.transport.run("
 			],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUTE-NO-RETRY]",
 			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
@@ -87,7 +87,7 @@
 				"\tif (r.exitCode === 0 && keys === \"isError,kind,text\" && o.kind === \"dispatched\" && o.isError === false) {"
 			],
 			"replace": ["\tif (keys === \"isError,kind,text\" && o.kind === \"dispatched\" && o.isError === false) {"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-RECEIPT-EXIT-AND-KIND-AGREE]",
 			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
@@ -102,7 +102,7 @@
 			"subject": "pi-extensions/lib/remote-pair-send.ts",
 			"find": ["const REMOTE_PATH = /^\\/[A-Za-z0-9._/-]+$/;"],
 			"replace": ["const REMOTE_PATH = /^\\/.+$/;"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUTE-DECL-NO-QUOTING-NEEDED]",
 			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
@@ -117,7 +117,7 @@
 			"subject": "pi-extensions/lib/remote-pair-send.ts",
 			"find": ["\t\t\tif (inspection.kind !== \"absent\") return true;"],
 			"replace": ["\t\t\tif (false) return true;"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUTE-LOCAL-TRACE-ANY-STATE]",
 			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
@@ -132,7 +132,7 @@
 			"subject": "pi-extensions/lib/remote-pair-send.ts",
 			"find": ["read/answer unknown until a reply arrives; paths below are on the other host)"],
 			"replace": ["read/answer unknown until a reply arrives)"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-ROUTE-RECEIPT-PATHS-OTHER-HOST]",
 			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
@@ -147,7 +147,7 @@
 			"subject": "pi-extensions/lib/remote-pair-send.ts",
 			"find": ["\t\tif ((err as NodeJS.ErrnoException).code === \"ENOENT\") return null;"],
 			"replace": ["\t\tif (false) return null;"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-PAIR-OPT-IN-ABSENT-IS-OFF]",
 			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
@@ -162,7 +162,7 @@
 			"subject": "pi-extensions/lib/remote-pair-send.ts",
 			"find": ["\tif (!st.isFile()) {\n\t\tthrow new RemoteRouteDeclarationError(`remote pair opt-in"],
 			"replace": ["\tif (false) {\n\t\tthrow new RemoteRouteDeclarationError(`remote pair opt-in"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-PAIR-OPT-IN-BROKEN-REFUSED]",
 			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
@@ -181,7 +181,7 @@
 			"replace": [
 				"\t\t\t\ttext: `entwurf_v2 remote ${via} → the other host did not deliver (paths below are on the other host)\\n${o.text}`,"
 			],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-REPORTED-ERROR-NO-DELIVERY-INFERENCE]",
 			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
@@ -189,6 +189,145 @@
 				"argv": ["bash", "scripts/build-bridge.sh"],
 				"output": "mcp/entwurf-bridge/dist"
 			}
+		},
+		{
+			"claim": "REMOTE-ROUTES-V2-EXACT-SHAPE",
+			"title": "an empty routes array is read as a declaration with no route, so a file meant to switch the pair off silently keeps the bridge reading an opt-in instead of being refused",
+			"subject": "pi-extensions/lib/remote-pair-send.ts",
+			"find": ["\tif (!Array.isArray(obj.routes) || obj.routes.length === 0) {"],
+			"replace": ["\tif (!Array.isArray(obj.routes)) {"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUTES-V2-EXACT-SHAPE]",
+			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
+		},
+		{
+			"claim": "REMOTE-ROUTES-LEGACY-NAMED-REFUSAL",
+			"title": "the versionless single-pair file is quietly read as one route, so a host keeps a pre-#149 declaration through the hard cut with no named transition",
+			"subject": "pi-extensions/lib/remote-pair-send.ts",
+			"find": ["\tif (!Object.hasOwn(obj, \"version\")) {"],
+			"replace": [
+				"\tif (!Object.hasOwn(obj, \"version\")) return { routes: [parseRoute(obj, what)] };\n\tif (Boolean(0)) {"
+			],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUTES-LEGACY-NAMED-REFUSAL]",
+			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
+		},
+		{
+			"claim": "REMOTE-ROUTES-LEGAL-REPEATS-ACCEPTED",
+			"title": "one alias may carry only one route, so a host with two citizens on the same other host cannot declare both pairs",
+			"subject": "pi-extensions/lib/remote-pair-send.ts",
+			"find": ["\t\tif (file !== undefined && file !== r.remotePairFile) {"],
+			"replace": ["\t\tif (file !== undefined) {"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUTES-LEGAL-REPEATS-ACCEPTED]",
+			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
+		},
+		{
+			"claim": "REMOTE-ROUTES-DUPLICATE-PAIR-REFUSED",
+			"title": "the same exact pair may be declared twice, so the file carries two entries for one route and the reader keeps whichever it meets first",
+			"subject": "pi-extensions/lib/remote-pair-send.ts",
+			"find": ["\t\tif (pairs.has(pair)) {"],
+			"replace": ["\t\tif (Boolean(0)) {"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUTES-DUPLICATE-PAIR-REFUSED]",
+			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
+		},
+		{
+			"claim": "REMOTE-ROUTES-LOCAL-REMOTE-OVERLAP-REFUSED",
+			"title": "a gid may be local in one route and remote in another, so one citizen is claimed to live on this host and on another at once",
+			"subject": "pi-extensions/lib/remote-pair-send.ts",
+			"find": ["\t\tif (locals.has(r.remoteGardenId)) {"],
+			"replace": ["\t\tif (Boolean(0)) {"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUTES-LOCAL-REMOTE-OVERLAP-REFUSED]",
+			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
+		},
+		{
+			"claim": "REMOTE-ROUTES-REMOTE-HOST-CONFLICT-REFUSED",
+			"title": "one remote gid may be reached through two aliases, so which host a message to it goes to depends on which sender sends it",
+			"subject": "pi-extensions/lib/remote-pair-send.ts",
+			"find": ["\t\tif (host && (host.ssh !== r.ssh || host.remotePairFile !== r.remotePairFile)) {"],
+			"replace": ["\t\tif (host && host.remotePairFile !== r.remotePairFile) {"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUTES-REMOTE-HOST-CONFLICT-REFUSED]",
+			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
+		},
+		{
+			"claim": "REMOTE-ROUTES-ALIAS-FILE-CONFLICT-REFUSED",
+			"title": "one alias may name two remote files, though the host behind it accepts only its one canonical file, so one of those routes can never be received",
+			"subject": "pi-extensions/lib/remote-pair-send.ts",
+			"find": ["\t\tif (file !== undefined && file !== r.remotePairFile) {"],
+			"replace": ["\t\tif (Boolean(0)) {"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUTES-ALIAS-FILE-CONFLICT-REFUSED]",
+			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
+		},
+		{
+			"claim": "REMOTE-ROUTE-SELECT-EXACT-PAIR",
+			"title": "the route is chosen by target alone, so a citizen paired with another remote speaks over a route declared for a different sender",
+			"subject": "pi-extensions/lib/remote-pair-send.ts",
+			"find": ["? declared.find((r) => r.localGardenId === sender.sessionId) :"],
+			"replace": ["? declared.find(() => true) :"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUTE-SELECT-EXACT-PAIR]",
+			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
+		},
+		{
+			"claim": "REMOTE-ROUTE-NO-LOCAL-FALLBACK",
+			"title": "a declared remote target with no route for this sender falls through to the local path, so a gid the operator said lives elsewhere is resolved on this host",
+			"subject": "pi-extensions/lib/remote-pair-send.ts",
+			"find": ["\tif (!sender || !route) {"],
+			"replace": [
+				"\tif (!sender || !route) return opts.runLocal(params, { senderProvider: opts.senderProvider });\n\tif (!sender || !route) {"
+			],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
+			"timeoutSeconds": 600,
+			"signature": "[QK:REMOTE-ROUTE-NO-LOCAL-FALLBACK]",
+			"signatureSource": "pi-extensions/lib/remote-pair-send.test.ts",
+			"build": {
+				"argv": ["bash", "scripts/build-bridge.sh"],
+				"output": "mcp/entwurf-bridge/dist"
+			}
 		}
 	]
 }

package/scripts/mutants/remote-pair-transport.json

@@ -8,7 +8,7 @@
 			"subject": "pi-extensions/lib/remote-pair-transport.ts",
 			"find": ["{ shell: false, stdio: [\"pipe\", \"pipe\", \"pipe\"] }"],
 			"replace": ["{ shell: true, stdio: [\"pipe\", \"pipe\", \"pipe\"] }"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-TRANSPORT-NO-SHELL-SEPARATE-STREAMS]",
 			"signatureSource": "pi-extensions/lib/remote-pair-transport.test.ts",
@@ -23,7 +23,7 @@
 			"subject": "pi-extensions/lib/remote-pair-transport.ts",
 			"find": ["\t\t\t\t\tchild.kill(\"SIGKILL\");"],
 			"replace": ["\t\t\t\t\tvoid 0;"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-TRANSPORT-TIMEOUT-REAPS-OWN-CHILD]",
 			"signatureSource": "pi-extensions/lib/remote-pair-transport.test.ts",
@@ -38,7 +38,7 @@
 			"subject": "pi-extensions/lib/remote-pair-transport.ts",
 			"find": ["\t\t\t\t\texitCode: spawnError ? null : code,"],
 			"replace": ["\t\t\t\t\texitCode: spawnError ? 0 : code,"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-TRANSPORT-SPAWN-FAILURE-INDETERMINATE]",
 			"signatureSource": "pi-extensions/lib/remote-pair-transport.test.ts",
@@ -53,7 +53,7 @@
 			"subject": "pi-extensions/lib/remote-pair-transport.ts",
 			"find": ["\t\t\t\t\tfinalTimer = setTimeout(() => {"],
 			"replace": ["\t\t\t\t\tfinalTimer = setTimeout(() => {\n\t\t\t\t\t\treturn;"],
-			"gate": ["bash", "run.sh", "check-tests-beside-behavior"],
+			"gate": ["bash", "run.sh", "check-remote-pair-beside"],
 			"timeoutSeconds": 600,
 			"signature": "[QK:REMOTE-TRANSPORT-HELD-PIPES-STILL-SETTLE]",
 			"signatureSource": "pi-extensions/lib/remote-pair-transport.test.ts",

package/scripts/mutants/source-install.json

@@ -27,6 +27,72 @@
 			"timeoutSeconds": 300,
 			"signature": "[QK:SOURCE-OPERATOR-FAILS-LOUD]",
 			"signatureSource": "scripts/smoke-agy-install-state.sh"
+		},
+		{
+			"claim": "SOURCE-SAME-TARGET-PASSES",
+			"title": "the exclusivity check compares the unresolved entry path again, so a duplicate PATH entry or a second link to this very checkout reads as another root and blocks a correct developer install",
+			"subject": "scripts/dev-bin.sh",
+			"find": ["        if os.path.lexists(path) and os.path.realpath(path) != target:"],
+			"replace": ["        if os.path.lexists(path) and os.path.abspath(path) != target:"],
+			"gate": ["bash", "run.sh", "smoke-agy-install-state"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:SOURCE-SAME-TARGET-PASSES]",
+			"signatureSource": "scripts/smoke-agy-install-state.sh"
+		},
+		{
+			"claim": "SOURCE-LATER-ROOT-FAILS",
+			"title": "the exclusivity check reads only the head of PATH again, so an old global shim later in PATH stays selectable by a shell with another PATH order while setup reports a developer install",
+			"subject": "scripts/dev-bin.sh",
+			"find": ["for d in os.environ.get(\"PATH\", \"\").split(\":\"):"],
+			"replace": ["for d in os.environ.get(\"PATH\", \"\").split(\":\")[:1]:"],
+			"gate": ["bash", "run.sh", "smoke-agy-install-state"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:SOURCE-LATER-ROOT-FAILS]",
+			"signatureSource": "scripts/smoke-agy-install-state.sh"
+		},
+		{
+			"claim": "SOURCE-GLOBAL-BIN-OTHER-ROOT",
+			"title": "the package manager's reported global bin dir is queried but never searched, so another root there passes whenever that dir is absent from this PATH",
+			"subject": "scripts/dev-bin.sh",
+			"find": ["        add(to_bin(value), label)\n"],
+			"replace": ["        pass\n"],
+			"gate": ["bash", "run.sh", "smoke-agy-install-state"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:SOURCE-GLOBAL-BIN-OTHER-ROOT]",
+			"signatureSource": "scripts/smoke-agy-install-state.sh"
+		},
+		{
+			"claim": "SOURCE-GLOBAL-QUERY-REFUSED",
+			"title": "a package manager that fails or hangs is read as not installed again, so an uninspectable global bin dir yields a clean developer-install verdict",
+			"subject": "scripts/dev-bin.sh",
+			"find": ["        errors.append(value)\n"],
+			"replace": ["        skipped.append(value)\n"],
+			"gate": ["bash", "run.sh", "smoke-agy-install-state"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:SOURCE-GLOBAL-QUERY-REFUSED]",
+			"signatureSource": "scripts/smoke-agy-install-state.sh"
+		},
+		{
+			"claim": "SOURCE-EXCLUSIVE-WIRED",
+			"title": "source setup's bins step drops the exclusivity verdict again and returns its pre-repair success, so another selectable root is reported as a developer install",
+			"subject": "run.sh",
+			"find": ["  [ \"$rc\" -eq 0 ] && return \"$ex_rc\"\n"],
+			"replace": ["  [ \"$rc\" -eq 0 ] && return 0\n"],
+			"gate": ["bash", "run.sh", "smoke-agy-install-state"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:SOURCE-EXCLUSIVE-WIRED]",
+			"signatureSource": "scripts/smoke-agy-install-state.sh"
+		},
+		{
+			"claim": "SOURCE-MANIFEST-UNREADABLE-REFUSED",
+			"title": "an unreadable or wrong-shaped package manifest is read as zero bin names again, so the exclusivity check finds no other root by checking nothing and source setup reports a developer install",
+			"subject": "scripts/dev-bin.sh",
+			"find": ["    sys.exit(6)  # an unreadable manifest is never \"0 names, no other root\"\n"],
+			"replace": ["    bins = {}  # regressed: an unreadable manifest read as zero names\n"],
+			"gate": ["bash", "run.sh", "smoke-agy-install-state"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:SOURCE-MANIFEST-UNREADABLE-REFUSED]",
+			"signatureSource": "scripts/smoke-agy-install-state.sh"
 		}
 	]
 }

package/scripts/remote-pair-receive.ts

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 /**
- * remote-pair-receive — `entwurf remote-pair-receive --pair <absolute file>` (#107 rail 1).
+ * remote-pair-receive — `entwurf remote-pair-receive --pair <absolute file>` (#107 rail 1, #149).
  *
- * The receiving host's entry for one declared remote pair. The sending host runs it over one
+ * The receiving host's entry for its declared remote pairs. The sending host runs it over one
  * SSH call and writes one JSON claim to stdin. This entry reads the operator-named pair
- * declaration once, applies the pair scope check, and hands a matching claim to the existing
- * v2 dispatch. The scope and trust model are in pi-extensions/lib/remote-pair-receive.ts.
+ * declaration once, selects the one route whose two ends are the claim's, and hands a matching
+ * claim to the existing v2 dispatch. The scope and trust model are in pi-extensions/lib/remote-pair-receive.ts.
  *
  * Scope: `--pair` must name THIS host's own opt-in file (`remotePairOptInPath()`), absolute and
- * normalized-equal; any other path — even a valid declaration — is exit 2. That one file is the pair
- * this host accepts and, because it names the sender's host as its route, the declared route back.
+ * normalized-equal; any other path — even a valid declaration — is exit 2. That one file holds the
+ * pairs this host accepts and, because each route names the sender's host, the declared route back.
  * The sender's declaration carries the path only so the argv shape is explicit; it selects nothing.
  *
  * EXIT CONTRACT (stdout carries a JSON receipt line only where named):
@@ -47,7 +47,7 @@ if (args.length !== 2 || args[0] !== "--pair") {
 }
 const pairFile = args[1];
 
-let decl: RemotePairDeclaration;
+let decls: RemotePairDeclaration[];
 let claim: ReturnType<typeof parseRemoteClaim>;
 try {
 	// The scope is THIS host's own opt-in, never a file the sender picks: `--pair` must name it
@@ -56,17 +56,17 @@ try {
 	if (!path.isAbsolute(pairFile) || path.normalize(pairFile) !== own) {
 		throw new Error(`--pair must be this host's opt-in file ${own} (got ${pairFile})`);
 	}
-	const route = readRemotePairOptIn(own);
-	if (route === null) throw new Error(`this host has no remote pair opt-in (${own} is absent)`);
-	decl = { remoteGardenId: route.remoteGardenId, ssh: route.ssh, localGardenId: route.localGardenId };
+	const optIn = readRemotePairOptIn(own);
+	if (optIn === null) throw new Error(`this host has no remote pair opt-in (${own} is absent)`);
+	decls = optIn.routes.map((r) => ({ remoteGardenId: r.remoteGardenId, ssh: r.ssh, localGardenId: r.localGardenId }));
 	claim = parseRemoteClaim(readFileSync(0, "utf8"));
 } catch (err) {
 	emit({ kind: "invalid", detail: err instanceof Error ? err.message : String(err) }, 2);
 }
 
-const receipt = await receiveRemoteClaim(claim, decl, {
+const receipt = await receiveRemoteClaim(claim, decls, {
 	dispatch: (params, sender) => runAndRenderEntwurfV2FromSurface(params, { senderProvider: () => sender }),
-	// The scope file IS this host's own opt-in, and it names the sender's host as its route: a
+	// The scope file IS this host's own opt-in, and the matched route names the sender's host: a
 	// matching claim always has a declared route back. Declared, not probed.
 	replyRoute: "declared",
 });