@junghanacs/entwurf 0.23.0 → 0.23.1

package/scripts/mutants/pi-launch.json

@@ -0,0 +1,113 @@
+{
+	"schemaVersion": 1,
+	"lane": "pi-launch",
+	"mutants": [
+		{
+			"claim": "PILAUNCH-FLAG-SSOT",
+			"title": "the launcher spells the control flag itself, so a typo in run.sh silently produces a pi that is not a citizen and reports nothing",
+			"subject": "run.sh",
+			"find": ["    exec \"$entwurf_pi_bin\" --entwurf-control \"$@\""],
+			"replace": ["    exec \"$entwurf_pi_bin\" --entwurf-controll \"$@\""],
+			"gate": ["bash", "run.sh", "check-pi-launch"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:PILAUNCH-FLAG-SSOT]",
+			"signatureSource": "scripts/check-pi-launch.ts"
+		},
+		{
+			"claim": "PILAUNCH-VERB-DROPPED",
+			"title": "without the shift the dispatcher verb stays in the forwarded argv and `pi` arrives at the vendor as a prompt argument",
+			"subject": "run.sh",
+			"find": ["    shift || true\n    if [ -n \"${ENTWURF_PI_LAUNCH_ACTIVE:-}\" ]; then"],
+			"replace": ["    if [ -n \"${ENTWURF_PI_LAUNCH_ACTIVE:-}\" ]; then"],
+			"gate": ["bash", "run.sh", "check-pi-launch"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:PILAUNCH-VERB-DROPPED]",
+			"signatureSource": "scripts/check-pi-launch.ts"
+		},
+		{
+			"claim": "PILAUNCH-FLAG-FIRST",
+			"title": "injecting the flag AFTER the operator argv puts it behind a positional prompt, where pi reads it as data instead of standing up a control socket",
+			"subject": "run.sh",
+			"find": ["    exec \"$entwurf_pi_bin\" --entwurf-control \"$@\""],
+			"replace": ["    exec \"$entwurf_pi_bin\" \"$@\" --entwurf-control"],
+			"gate": ["bash", "run.sh", "check-pi-launch"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:PILAUNCH-FLAG-FIRST]",
+			"signatureSource": "scripts/check-pi-launch.ts"
+		},
+		{
+			"claim": "PILAUNCH-NOTHING-ELSE-INJECTED",
+			"title": "a launcher that also injects operator taste stops being a spelling and starts deciding the session (Rule 9)",
+			"subject": "run.sh",
+			"find": ["    exec \"$entwurf_pi_bin\" --entwurf-control \"$@\""],
+			"replace": ["    exec \"$entwurf_pi_bin\" --entwurf-control --emacs-agent-socket \"$@\""],
+			"gate": ["bash", "run.sh", "check-pi-launch"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:PILAUNCH-NOTHING-ELSE-INJECTED]",
+			"signatureSource": "scripts/check-pi-launch.ts"
+		},
+		{
+			"claim": "PILAUNCH-ARGV-BYTES",
+			"title": "an unquoted forward word-splits the operator argv and drops empty elements, so a quoted prompt silently becomes several arguments",
+			"subject": "run.sh",
+			"find": ["    exec \"$entwurf_pi_bin\" --entwurf-control \"$@\""],
+			"replace": ["    exec \"$entwurf_pi_bin\" --entwurf-control $@"],
+			"gate": ["bash", "run.sh", "check-pi-launch"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:PILAUNCH-ARGV-BYTES]",
+			"signatureSource": "scripts/check-pi-launch.ts"
+		},
+		{
+			"claim": "PILAUNCH-EXEC-KEEPS-PID",
+			"title": "forking instead of exec leaves run.sh as a parent that supervises nothing and owns neither the terminal nor the exit",
+			"subject": "run.sh",
+			"find": ["    exec \"$entwurf_pi_bin\" --entwurf-control \"$@\""],
+			"replace": ["    \"$entwurf_pi_bin\" --entwurf-control \"$@\""],
+			"gate": ["bash", "run.sh", "check-pi-launch"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:PILAUNCH-EXEC-KEEPS-PID]",
+			"signatureSource": "scripts/check-pi-launch.ts"
+		},
+		{
+			"claim": "PILAUNCH-VENDOR-ABSENT",
+			"title": "an absent vendor that exits 0 is the false success this repo refuses: nothing launched and the caller was told it worked",
+			"subject": "run.sh",
+			"find": [
+				"      echo \"         'entwurf pi' launches the pi coding agent; it does not install one.\" >&2\n      exit 1"
+			],
+			"replace": [
+				"      echo \"         'entwurf pi' launches the pi coding agent; it does not install one.\" >&2\n      exit 0"
+			],
+			"gate": ["bash", "run.sh", "check-pi-launch"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:PILAUNCH-VENDOR-ABSENT]",
+			"signatureSource": "scripts/check-pi-launch.ts"
+		},
+		{
+			"claim": "PILAUNCH-SENTINEL-EXPORTED",
+			"title": "a sentinel that is set but not exported is invisible to the re-entered child, so the recursion fence never fires and the terminal hangs",
+			"subject": "run.sh",
+			"find": ["    export ENTWURF_PI_LAUNCH_ACTIVE=1"],
+			"replace": ["    ENTWURF_PI_LAUNCH_ACTIVE=1"],
+			"gate": ["bash", "run.sh", "check-pi-launch"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:PILAUNCH-SENTINEL-EXPORTED]",
+			"signatureSource": "scripts/check-pi-launch.ts"
+		},
+		{
+			"claim": "PILAUNCH-RECURSION-FENCE",
+			"title": "with the fence removed a PATH `pi` that shells back here spins forever, and the symptom is a hung terminal rather than an error",
+			"subject": "run.sh",
+			"find": [
+				"    if [ -n \"${ENTWURF_PI_LAUNCH_ACTIVE:-}\" ]; then\n      echo \"entwurf: recursive managed launch detected (ENTWURF_PI_LAUNCH_ACTIVE is already set).\" >&2"
+			],
+			"replace": [
+				"    if false; then\n      echo \"entwurf: recursive managed launch detected (ENTWURF_PI_LAUNCH_ACTIVE is already set).\" >&2"
+			],
+			"gate": ["bash", "run.sh", "check-pi-launch"],
+			"timeoutSeconds": 300,
+			"signature": "[QK:PILAUNCH-RECURSION-FENCE]",
+			"signatureSource": "scripts/check-pi-launch.ts"
+		}
+	]
+}

package/scripts/mutants/resume-args.json

@@ -11,7 +11,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-resume-args"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:RESUMEARGS-NO-HEADLESS]",
-			"signatureSource": "scripts/check-entwurf-resume-args.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-resume-args.test.ts"
 		},
 		{
 			"claim": "RESUMEARGS-CONTROL-FIRST",
@@ -24,7 +24,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-resume-args"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:RESUMEARGS-CONTROL-FIRST]",
-			"signatureSource": "scripts/check-entwurf-resume-args.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-resume-args.test.ts"
 		},
 		{
 			"claim": "RESUMEARGS-EXT-ONCE-BEFORE-SESSION",
@@ -37,7 +37,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-resume-args"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:RESUMEARGS-EXT-ONCE-BEFORE-SESSION]",
-			"signatureSource": "scripts/check-entwurf-resume-args.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-resume-args.test.ts"
 		},
 		{
 			"claim": "RESUMEARGS-SESSION-IS-FILE",
@@ -48,7 +48,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-resume-args"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:RESUMEARGS-SESSION-IS-FILE]",
-			"signatureSource": "scripts/check-entwurf-resume-args.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-resume-args.test.ts"
 		},
 		{
 			"claim": "RESUMEARGS-PROVIDER-OPTIONAL",
@@ -59,7 +59,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-resume-args"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:RESUMEARGS-PROVIDER-OPTIONAL]",
-			"signatureSource": "scripts/check-entwurf-resume-args.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-resume-args.test.ts"
 		},
 		{
 			"claim": "RESUMEARGS-NO-PROMPT-TAIL",
@@ -70,7 +70,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-resume-args"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:RESUMEARGS-NO-PROMPT-TAIL]",
-			"signatureSource": "scripts/check-entwurf-resume-args.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-resume-args.test.ts"
 		}
 	]
 }

package/scripts/mutants/v2-surface.json

@@ -25,7 +25,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-send"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2SEND-INBAND-REJECT-REASON]",
-			"signatureSource": "scripts/check-entwurf-v2-send.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-send.test.ts"
 		},
 		{
 			"claim": "V2PROD-INBAND-ERROR-WIRED",
@@ -206,7 +206,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-native-push"],
 			"timeoutSeconds": 120,
 			"signature": "[QK:NATIVE-PUSH-RETRY-BYTE-IDENTITY]",
-			"signatureSource": "scripts/check-entwurf-v2-native-push.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-native-push.test.ts"
 		}
 	]
 }

package/scripts/mutants/v2-visible-resume.json

@@ -11,7 +11,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-LIVE-REFUSED]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-INDETERMINATE-NO-START",
@@ -22,7 +22,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-INDETERMINATE-NO-START]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-CONFLICT-NO-START",
@@ -33,7 +33,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-CONFLICT-NO-START]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-LOCKED-NO-RESOLVE",
@@ -44,7 +44,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-LOCKED-NO-RESOLVE]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-NO-TRANSCRIPT-FAILS-LOUD",
@@ -67,7 +67,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-NO-TRANSCRIPT-FAILS-LOUD]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-OBSERVE-IS-BOUNDED-WAIT",
@@ -78,7 +78,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-OBSERVE-IS-BOUNDED-WAIT]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-UNOBSERVED-IS-REAL",
@@ -89,7 +89,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-UNOBSERVED-IS-REAL]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-RELEASE-FAILURE-LOUD",
@@ -100,7 +100,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-RELEASE-FAILURE-LOUD]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-ARGV-FROM-RECORD",
@@ -111,7 +111,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-ARGV-FROM-RECORD]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-RECEIPTS-SEPARATE",
@@ -124,7 +124,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-RECEIPTS-SEPARATE]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-RENDER-SEPARATES",
@@ -137,7 +137,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-RENDER-SEPARATES]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-IDENTITY-BEFORE-WINDOW",
@@ -148,7 +148,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-IDENTITY-BEFORE-WINDOW]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-TIMEOUT-RELEASES",
@@ -161,7 +161,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-TIMEOUT-RELEASES]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-LOCK-BEFORE-LIVENESS",
@@ -172,7 +172,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-LOCK-BEFORE-LIVENESS]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-NOT-PI-REFUSED",
@@ -183,7 +183,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-NOT-PI-REFUSED]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-NOT-PI-BY-FIELD",
@@ -198,7 +198,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-NOT-PI-BY-FIELD]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		},
 		{
 			"claim": "V2RESUME-SHARED-ID-GRAMMAR",
@@ -209,7 +209,7 @@
 			"gate": ["bash", "run.sh", "check-entwurf-v2-visible-resume"],
 			"timeoutSeconds": 60,
 			"signature": "[QK:V2RESUME-SHARED-ID-GRAMMAR]",
-			"signatureSource": "scripts/check-entwurf-v2-visible-resume.ts"
+			"signatureSource": "pi-extensions/lib/entwurf-v2-visible-resume.test.ts"
 		}
 	]
 }

package/scripts/smoke-acp-raw-turn-live.ts

@@ -3,7 +3,7 @@
 //   LIVE=1 ./run.sh smoke-acp-raw-turn-live
 //
 // What this proves (and ONLY this): the pinned Claude ACP adapter
-// (@agentclientprotocol/claude-agent-acp@0.76.0) spawns, speaks the ACP wire
+// (@agentclientprotocol/claude-agent-acp@0.79.0) spawns, speaks the ACP wire
 // protocol over stdio NDJSON, and returns one real model turn. It is the
 // bytes-flow proof that the S2a dep surface is not just installable but
 // actually drivable — before any provider/overlay/streamSimple code (S2b+).

package/scripts/smoke-entwurf-v2-matrix-live.ts

@@ -1,7 +1,7 @@
 /**
  * smoke-entwurf-v2-matrix-live — the 5d-5 D4-b LIVE sentinel for the release-gate matrix.
  *
- * The deterministic sibling (check-entwurf-v2-matrix) drives the REAL decider over fakes with
+ * The deterministic sibling (pi-extensions/lib/entwurf-v2-decider.matrix.test.ts) drives the REAL decider over fakes with
  * ZERO IO — it fixes every (target kind → transport → lock) cell as a table. This LIVE sentinel
  * drives the REAL production `runEntwurfV2` deps against REAL OS objects on the substrate's
  * happy path, to catch what fakes cannot: a real `pi --entwurf-control` control socket + RPC,