@trycore/spec-build-harness 0.12.0 → 0.14.0

package/scripts/tests/test-runtime-client.sh

@@ -295,4 +295,504 @@ print('slice_id' in json.load(open(files[0])))
 kill "$STUB_PID4" 2>/dev/null; wait "$STUB_PID4" 2>/dev/null
 unset CLAUDE_PROJECT_DIR
 
+# ── [#62] Carril directo de la outbox ────────────────────────────────────────────────
+PORT_D="$(python3 -c "import socket;s=socket.socket();s.bind(('',0));print(s.getsockname()[1]);s.close()")"
+cat > "$TMP/routes-d.json" <<JSON
+{"POST /projects/p-1/epic-proposals": {"status": 201, "body": {"proposal_id": "prop-77", "status": "PROPOSED"}},
+ "POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+: > "$TMP/calls-d.jsonl"
+python3 "$ROOT/scripts/tests/lib/http-stub.py" "$PORT_D" "$TMP/routes-d.json" "$TMP/calls-d.jsonl" &
+STUB_D=$!
+trap 'kill $STUB_D 2>/dev/null; rm -rf "$TMP"' EXIT
+sleep 0.3
+
+export CLAUDE_PROJECT_DIR="$TMP/projD"
+mkdir -p "$CLAUDE_PROJECT_DIR/.claude/state"
+BUILD_CONFIG_FILE="$TMP/projD-cfg.json"
+echo '{"runtime":{"mode":"dual"}}' > "$BUILD_CONFIG_FILE"
+export BUILD_CONFIG_FILE
+
+runtime_credentials_merge "{\"runtime_url\":\"http://127.0.0.1:$PORT_D\",\"project_token\":\"tok-d\",\"agent_key\":\"ak-1\",\"project_id\":\"p-1\"}"
+rm -rf "$CLAUDE_PROJECT_DIR/.claude/state/outbox"
+
+echo '{"title":"Notificaciones","objective":"avisar al usuario"}' > "$TMP/prop.json"
+CID="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json")"
+[ -n "$CID" ] && echo "OK runtime_enqueue_direct devuelve el client_event_id" \
+  || { echo "FAIL runtime_enqueue_direct sin id"; fail=1; }
+f="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name '*.json' | head -1)"
+python3 -c "
+import json
+d=json.load(open('$f'))
+ok = d['channel']=='direct' and d['method']=='POST' and d['path']=='/projects/p-1/epic-proposals' \
+     and d['type']=='epic_proposed' and d['payload']['title']=='Notificaciones'
+print('SI' if ok else 'NO')" | grep -q SI \
+  && echo "OK el fichero del carril directo lleva canal, metodo, ruta y payload" \
+  || { echo "FAIL formato del carril directo"; fail=1; }
+
+# El lote de /events NO debe llevarse el fichero directo por delante.
+# [Corrección mecánica: el stub relee routes-d.json en cada request (no solo al arrancar),
+# así que se le inyecta el client_event_id del evento de lote recién encolado en la lista
+# de aceptados — igual que hace el bloque de backoff más arriba (STUB_PID3) — para que el
+# lote quede confirmado y la comprobación de "n=0" verifique lo que dice verificar: que
+# AMBOS carriles quedan drenados, no que el carril directo sobrevive solo porque el lote
+# nunca se confirma.
+runtime_enqueue_event progress_noted '{"note":"hola"}' "sl-1"
+evt_cid="$(python3 -c "
+import json,glob
+for p in glob.glob('$CLAUDE_PROJECT_DIR/.claude/state/outbox/*.json'):
+    d=json.load(open(p))
+    if d.get('type')=='progress_noted':
+        print(d['client_event_id']); break
+")"
+cat > "$TMP/routes-d.json" <<JSON
+{"POST /projects/p-1/epic-proposals": {"status": 201, "body": {"proposal_id": "prop-77", "status": "PROPOSED"}},
+ "POST /events": {"status": 200, "body": {"accepted": ["$evt_cid"], "duplicates": [], "rejected": []}}}
+JSON
+runtime_dispatch_outbox >/dev/null 2>&1
+sent="$(python3 - "$TMP/calls-d.jsonl" <<'PY'
+import json,sys
+paths=[json.loads(l)["path"] for l in open(sys.argv[1]) if l.strip()]
+print("SI" if "/projects/p-1/epic-proposals" in paths and "/events" in paths else "NO")
+PY
+)"
+[ "$sent" = SI ] && echo "OK el despacho atiende los dos carriles en el mismo ciclo" \
+  || { echo "FAIL un carril se comio al otro ($sent)"; fail=1; }
+body="$(python3 - "$TMP/calls-d.jsonl" <<'PY'
+import json,sys
+for l in open(sys.argv[1]):
+    d=json.loads(l)
+    if d["path"]=="/projects/p-1/epic-proposals":
+        print("SI" if json.loads(d["body"]).get("title")=="Notificaciones" else "NO")
+        break
+PY
+)"
+[ "$body" = SI ] && echo "OK el carril directo manda el payload tal cual" \
+  || { echo "FAIL payload del carril directo ($body)"; fail=1; }
+[ -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/acks/$CID.json" ] && echo "OK el ack del carril directo queda en acks/" \
+  || { echo "FAIL sin ack en acks/"; fail=1; }
+pid="$(python3 -c "
+import json
+print(json.load(open('$CLAUDE_PROJECT_DIR/.claude/state/outbox/acks/$CID.json'))['response'].get('proposal_id'))" 2>/dev/null)"
+[ "$pid" = "prop-77" ] && echo "OK el ack conserva la respuesta del hub" \
+  || { echo "FAIL el ack perdio la respuesta ($pid)"; fail=1; }
+n="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name '*.json' | wc -l | tr -d ' ')"
+[ "$n" = 0 ] && echo "OK el carril directo borra el fichero entregado" \
+  || { echo "FAIL fichero directo sin borrar ($n)"; fail=1; }
+
+# 404 = instancia del hub sin soporte: se aparta con una razón que lo NOMBRA, no se reintenta.
+cat > "$TMP/routes-d.json" <<JSON
+{"POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+CID2="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json")"
+runtime_dispatch_outbox >/dev/null 2>&1
+# [Ruling R8] la variante glob del brief expande a varios argumentos dentro de `-f` (bash
+# inválido); solo la variante `find` es correcta.
+found="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox/rejected" -name "*$CID2.json" 2>/dev/null | head -1)"
+[ -n "$found" ] && echo "OK un 404 aparta la peticion directa" || { echo "FAIL 404 sin apartar"; fail=1; }
+python3 -c "
+import json
+print(json.load(open('$found')).get('rejected_reason',''))" 2>/dev/null | grep -qi 'sin soporte' \
+  && echo "OK la razon del 404 nombra la falta de soporte del hub" \
+  || { echo "FAIL razon del 404 poco accionable"; fail=1; }
+
+# Combo [Important 1, revisión ronda 1]: el carril directo falla TRANSITORIO (5xx) en el
+# MISMO ciclo en que el lote de /events se despacha con éxito. El rc de la función no puede
+# ocultar que algo del carril directo quedó pendiente solo porque el lote fue bien — es lo
+# que consumen `scripts/tests/test-skill-ops.sh` (`|| rc=$?`).
+runtime_enqueue_event progress_noted '{"note":"combo"}' "sl-3"
+evt_cid2="$(python3 -c "
+import json,glob
+for p in glob.glob('$CLAUDE_PROJECT_DIR/.claude/state/outbox/*.json'):
+    d=json.load(open(p))
+    if d.get('type')=='progress_noted':
+        print(d['client_event_id']); break
+")"
+CID5="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json")"
+cat > "$TMP/routes-d.json" <<JSON
+{"POST /projects/p-1/epic-proposals": {"status": 500, "body": {"error": "boom"}},
+ "POST /events": {"status": 200, "body": {"accepted": ["$evt_cid2"], "duplicates": [], "rejected": []}}}
+JSON
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+runtime_dispatch_outbox >/dev/null 2>&1
+rc=$?
+[ "$rc" -ne 0 ] && echo "OK rc distinto de 0 si el directo falla transitorio aunque el lote se despache bien" \
+  || { echo "FAIL rc 0 pese a directo pendiente ($rc)"; fail=1; }
+found="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID5.json" | head -1)"
+[ -n "$found" ] && echo "OK la peticion directa transitoria sigue en cola pese al exito del lote" \
+  || { echo "FAIL la peticion directa transitoria se perdio"; fail=1; }
+gone="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$evt_cid2.json" | head -1)"
+[ -z "$gone" ] && echo "OK el lote se entrego pese a que el carril directo fallo en el mismo ciclo" \
+  || { echo "FAIL el lote no se entrego"; fail=1; }
+
+# Offline: la petición directa SOBREVIVE en la cola (no se aparta, no se pierde).
+kill "$STUB_D" 2>/dev/null; wait "$STUB_D" 2>/dev/null
+CID3="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json")"
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+runtime_dispatch_outbox >/dev/null 2>&1
+found="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID3.json" | head -1)"
+[ -n "$found" ] && echo "OK offline la peticion directa sigue encolada" \
+  || { echo "FAIL la peticion directa se perdio offline"; fail=1; }
+
+# La propuesta es protegida: la cota jamás la evicta.
+case " $RUNTIME_OUTBOX_PROTECTED " in
+  *" epic_proposed "*) echo "OK epic_proposed es un tipo protegido de la cota" ;;
+  *) echo "FAIL epic_proposed evictable"; fail=1 ;;
+esac
+
+# [#63] La versión de grafo se estampa AL DESPACHAR: una propuesta encolada ayer no puede
+# salir con la versión de ayer. El stub anterior está muerto (test offline lo mató); se
+# levanta uno nuevo en el mismo puerto, reutilizando $CLAUDE_PROJECT_DIR=$TMP/projD (Ruling R2).
+python3 "$ROOT/scripts/tests/lib/http-stub.py" "$PORT_D" "$TMP/routes-d.json" "$TMP/calls-d.jsonl" &
+STUB_D=$!
+sleep 0.3
+cat > "$TMP/routes-d.json" <<'JSON'
+{"POST /projects/p-1/epic-proposals": {"status": 201, "body": {"proposal_id": "prop-88"}},
+ "POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+# El test offline anterior dejó "$CID3" pendiente en la cola sin despachar (el stub estaba
+# muerto): se drena aquí para que no se cuele delante de "$CID4" y contamine el "primer
+# match" de /projects/p-1/epic-proposals que verifican las aserciones de abajo.
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+runtime_dispatch_outbox >/dev/null 2>&1
+: > "$TMP/calls-d.jsonl"
+runtime_projection_write '{"fetched_at":"2099-01-01T00:00:00Z","context":{"graph_version":42}}'
+CID4="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json" 1)"
+# La versión cambia ENTRE el encolado y el despacho: gana la del despacho.
+runtime_projection_write '{"fetched_at":"2099-01-01T00:00:00Z","context":{"graph_version":47}}'
+: > "$TMP/calls-d.jsonl"
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+runtime_dispatch_outbox >/dev/null 2>&1
+sent="$(python3 - "$TMP/calls-d.jsonl" <<'PY'
+import json,sys
+for l in open(sys.argv[1]):
+    d=json.loads(l)
+    if d["path"]=="/projects/p-1/epic-proposals":
+        print(json.loads(d["body"]).get("graph_version"))
+        break
+PY
+)"
+[ "$sent" = 47 ] && echo "OK la version se estampa al despachar, no al encolar" \
+  || { echo "FAIL version estampada al encolar ($sent)"; fail=1; }
+
+# Sin el 5º argumento, el cuerpo NO lleva versión (retrocompatible).
+CID5="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json")"
+: > "$TMP/calls-d.jsonl"
+runtime_dispatch_outbox >/dev/null 2>&1
+has="$(python3 - "$TMP/calls-d.jsonl" <<'PY'
+import json,sys
+for l in open(sys.argv[1]):
+    d=json.loads(l)
+    if d["path"]=="/projects/p-1/epic-proposals":
+        print("SI" if "graph_version" in json.loads(d["body"]) else "NO")
+        break
+PY
+)"
+[ "$has" = NO ] && echo "OK sin estampado pedido, el cuerpo no cambia" || { echo "FAIL estampado no pedido"; fail=1; }
+
+# 409 stale_graph en el carril directo: se anota el desfase y la petición SIGUE en la cola
+# (la refresca el heartbeat, #61), no se pierde ni se aparta a la primera.
+cat > "$TMP/routes-d.json" <<'JSON'
+{"POST /projects/p-1/epic-proposals": {"status": 409, "body": {"reason": "stale_graph", "graph_version": 60}},
+ "POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+runtime_graph_clear_stale
+CID6="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json" 1)"
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+runtime_dispatch_outbox >/dev/null 2>&1
+found="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID6.json" | head -1)"
+[ -n "$found" ] && echo "OK un 409 stale_graph conserva la peticion en la cola" \
+  || { echo "FAIL la peticion se perdio con el 409"; fail=1; }
+runtime_graph_status_read | python3 -c "
+import json,sys; print(json.load(sys.stdin).get('server'))" | grep -qx 60 \
+  && echo "OK el 409 del carril directo anota el desfase" || { echo "FAIL desfase sin anotar"; fail=1; }
+
+# Tres 409 seguidos: se aparta con un mensaje que nombra el desfase (no bucle infinito).
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"; runtime_dispatch_outbox >/dev/null 2>&1
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"; runtime_dispatch_outbox >/dev/null 2>&1
+found="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID6.json" | head -1)"
+[ -z "$found" ] && echo "OK tras 3 rechazos la peticion deja de reintentarse" \
+  || { echo "FAIL reintento infinito del 409"; fail=1; }
+rej="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox/rejected" -name "*$CID6.json" | head -1)"
+python3 -c "
+import json
+print(json.load(open('$rej')).get('rejected_reason',''))" 2>/dev/null | grep -q '60' \
+  && echo "OK la razon del apartado nombra la version del hub" \
+  || { echo "FAIL razon del apartado sin desfase"; fail=1; }
+
+# ── Ronda de arreglo 1: Important 1/3/4 y Minor 6 ─────────────────────────────────────
+
+# [Important 1] Una versión de grafo NO ENTERA (hub#115 aún no existe; nada coacciona el
+# tipo en agent-context.sh) no debe vaciar el payload y disfrazar el fallo de "rechazo del
+# hub": la propuesta original tiene que seguir viajando intacta.
+runtime_projection_write '{"fetched_at":"2099-01-01T00:00:00Z","context":{"graph_version":"42.5"}}'
+cat > "$TMP/routes-d.json" <<'JSON'
+{"POST /projects/p-1/epic-proposals": {"status": 201, "body": {"proposal_id": "prop-100"}},
+ "POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+CID9="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json" 1)"
+: > "$TMP/calls-d.jsonl"
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+runtime_dispatch_outbox >/dev/null 2>&1
+body_ok="$(python3 - "$TMP/calls-d.jsonl" <<'PY'
+import json,sys
+for l in open(sys.argv[1]):
+    d=json.loads(l)
+    if d["path"]=="/projects/p-1/epic-proposals":
+        b=d["body"]
+        print("SI" if b and json.loads(b).get("title")=="Notificaciones" else "NO")
+        break
+PY
+)"
+[ "$body_ok" = SI ] && echo "OK una version de grafo no entera no vacia el payload" \
+  || { echo "FAIL el payload se vacio con una version de grafo invalida"; fail=1; }
+runtime_projection_write '{"fetched_at":"2099-01-01T00:00:00Z","context":{"graph_version":42}}'
+
+# [Important 3] Un 2xx del carril directo limpia el marcador de desfase: la petición llegó,
+# así que ya no vamos rancios.
+runtime_graph_note_stale 42 99
+cat > "$TMP/routes-d.json" <<'JSON'
+{"POST /projects/p-1/epic-proposals": {"status": 201, "body": {"proposal_id": "prop-101"}},
+ "POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+CID10="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json" 1)"
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+runtime_dispatch_outbox >/dev/null 2>&1
+[ "$(runtime_graph_status_read)" = "{}" ] && echo "OK un 2xx del carril directo limpia el marcador de desfase" \
+  || { echo "FAIL el marcador de desfase sobrevive a un 2xx"; fail=1; }
+
+# [Important 4] Un 409 que NO trae reason=stale_graph no se confunde con un grafo rancio: es
+# un rechazo de contrato normal, apartado de inmediato, sin inventar un desfase.
+cat > "$TMP/routes-d.json" <<'JSON'
+{"POST /projects/p-1/epic-proposals": {"status": 409, "body": {"reason": "duplicate_proposal"}},
+ "POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+CID12="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json" 1)"
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+runtime_dispatch_outbox >/dev/null 2>&1
+rej12="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox/rejected" -name "*$CID12.json" | head -1)"
+[ -n "$rej12" ] && echo "OK un 409 sin reason=stale_graph se rechaza de inmediato (rechazo de contrato)" \
+  || { echo "FAIL un 409 no-stale_graph se trato como grafo rancio"; fail=1; }
+python3 -c "
+import json
+print(json.load(open('$rej12')).get('rejected_reason',''))" 2>/dev/null | grep -qi 'grafo' \
+  && { echo "FAIL la razon del rechazo inventa un desfase de grafo que no existe"; fail=1; } \
+  || echo "OK la razon del rechazo no inventa un desfase de grafo"
+
+# [Minor 6] "3 rechazos CONSECUTIVOS" es literal: un transitorio intercalado reinicia la racha.
+cat > "$TMP/routes-d.json" <<'JSON'
+{"POST /projects/p-1/epic-proposals": {"status": 409, "body": {"reason": "stale_graph", "graph_version": 70}},
+ "POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+CID11="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json" 1)"
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"; runtime_dispatch_outbox >/dev/null 2>&1
+f11="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID11.json" | head -1)"
+n1="$(python3 -c "import json; print(json.load(open('$f11')).get('graph_409'))" 2>/dev/null)"
+[ "$n1" = 1 ] && echo "OK el primer 409 stale_graph cuenta 1" || { echo "FAIL primer conteo ($n1)"; fail=1; }
+
+cat > "$TMP/routes-d.json" <<'JSON'
+{"POST /projects/p-1/epic-proposals": {"status": 500, "body": {}},
+ "POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"; runtime_dispatch_outbox >/dev/null 2>&1
+n2="$(python3 -c "import json; print(json.load(open('$f11')).get('graph_409'))" 2>/dev/null)"
+[ "$n2" = 0 ] && echo "OK un transitorio intercalado reinicia la racha de rechazos por grafo" \
+  || { echo "FAIL la racha no se reinicio ($n2)"; fail=1; }
+
+cat > "$TMP/routes-d.json" <<'JSON'
+{"POST /projects/p-1/epic-proposals": {"status": 409, "body": {"reason": "stale_graph", "graph_version": 70}},
+ "POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"; runtime_dispatch_outbox >/dev/null 2>&1
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"; runtime_dispatch_outbox >/dev/null 2>&1
+found11="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID11.json" | head -1)"
+[ -n "$found11" ] && echo "OK tras el reinicio hacen falta 3 rechazos NUEVOS, no 2" \
+  || { echo "FAIL se aparto con solo 2 rechazos tras el reinicio"; fail=1; }
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"; runtime_dispatch_outbox >/dev/null 2>&1
+found11="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID11.json" | head -1)"
+[ -z "$found11" ] && echo "OK el 3er rechazo consecutivo (tras el reinicio) aparta la peticion" \
+  || { echo "FAIL no se aparto tras 3 consecutivos reales"; fail=1; }
+
+# ── Ronda final de la rama: A1 (idempotencia + mutex), A2 (racha por versión), B1, C4 ──
+
+# [A1a] El carril directo viaja con `client_event_id` en el CUERPO: es la clave de
+# idempotencia con la que el hub deduplica. Sin ella, dos despachos de la misma propuesta
+# (daemon + proceso de la skill) crean DOS propuestas y, al aprobarlas, dos EP-XXX.
+cat > "$TMP/routes-d.json" <<'JSON'
+{"POST /projects/p-1/epic-proposals": {"status": 201, "body": {"proposal_id": "prop-200"}},
+ "POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+CID13="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json")"
+: > "$TMP/calls-d.jsonl"
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+runtime_dispatch_outbox >/dev/null 2>&1
+sent_cid="$(python3 - "$TMP/calls-d.jsonl" <<'PY'
+import json,sys
+for l in open(sys.argv[1]):
+    d=json.loads(l)
+    if d["path"]=="/projects/p-1/epic-proposals":
+        print(json.loads(d["body"]).get("client_event_id") or "")
+        break
+PY
+)"
+[ "$sent_cid" = "$CID13" ] && echo "OK el carril directo manda client_event_id como clave de idempotencia" \
+  || { echo "FAIL el cuerpo del carril directo viaja sin client_event_id ($sent_cid vs $CID13)"; fail=1; }
+sent_title="$(python3 - "$TMP/calls-d.jsonl" <<'PY'
+import json,sys
+for l in open(sys.argv[1]):
+    d=json.loads(l)
+    if d["path"]=="/projects/p-1/epic-proposals":
+        print(json.loads(d["body"]).get("title") or "")
+        break
+PY
+)"
+[ "$sent_title" = "Notificaciones" ] && echo "OK la clave de idempotencia no pisa el payload original" \
+  || { echo "FAIL el payload se perdio al estampar la clave ($sent_title)"; fail=1; }
+
+# [A1b] Mutex del despacho: con el lock tomado por otro proceso, la cola NO se toca, no se
+# abre socket y el rc dice que quedó trabajo (nunca 0 = "drenada" sin haberlo comprobado).
+LOCK="$(runtime_dispatch_lock_path)"
+rmdir "$LOCK" 2>/dev/null
+CID14="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json")"
+: > "$TMP/calls-d.jsonl"
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+mkdir -p "$LOCK"
+runtime_dispatch_outbox >/dev/null 2>&1
+rc=$?
+[ "$rc" -eq 1 ] && echo "OK con el mutex tomado el despacho no reporta la cola como drenada" \
+  || { echo "FAIL rc del despacho con el mutex tomado ($rc)"; fail=1; }
+[ ! -s "$TMP/calls-d.jsonl" ] && echo "OK con el mutex tomado no se abre ningun socket" \
+  || { echo "FAIL el despacho ignoro el mutex y llamo al hub"; fail=1; }
+found="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID14.json" | head -1)"
+[ -n "$found" ] && echo "OK con el mutex tomado la cola queda intacta" \
+  || { echo "FAIL la cola se toco con el mutex tomado"; fail=1; }
+rmdir "$LOCK" 2>/dev/null
+runtime_dispatch_outbox >/dev/null 2>&1
+found="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID14.json" | head -1)"
+[ -z "$found" ] && echo "OK liberado el mutex, el despacho drena la cola" \
+  || { echo "FAIL la cola no drena tras liberar el mutex"; fail=1; }
+
+# Un lock HUÉRFANO (proceso muerto entre el mkdir y el rmdir) se libera por edad: si no, la
+# cola de ese repo no volvería a despacharse nunca.
+CID15="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json")"
+mkdir -p "$LOCK"
+touch -t 200001010000 "$LOCK"
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+runtime_dispatch_outbox >/dev/null 2>&1
+found="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID15.json" | head -1)"
+[ -z "$found" ] && echo "OK un mutex huerfano se libera por edad y la cola vuelve a drenar" \
+  || { echo "FAIL el mutex huerfano bloquea la cola para siempre"; fail=1; }
+[ ! -d "$LOCK" ] && echo "OK el despacho suelta el mutex al terminar" \
+  || { echo "FAIL el mutex queda tomado tras el despacho"; fail=1; }
+
+# [A2] La racha de 3 rechazos por grafo rancio cuenta rechazos contra la MISMA versión local.
+# Si entre rechazo y rechazo hubo un refresco de verdad (cambió la versión estampada), la
+# propuesta NO puede agotar sus tres vidas: es el caso real con `context_refresh_s: 0` o con
+# tres turnos en menos de 45 s.
+cat > "$TMP/routes-d.json" <<'JSON'
+{"POST /projects/p-1/epic-proposals": {"status": 409, "body": {"reason": "stale_graph", "graph_version": 90}},
+ "POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+runtime_projection_write '{"fetched_at":"2099-01-01T00:00:00Z","context":{"graph_version":80}}'
+CID16="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json" 1)"
+for v in 81 82 83; do
+  # Cada ciclo despacha con una versión local NUEVA: es lo que haría el refresco del
+  # heartbeat entre turno y turno.
+  runtime_projection_write "{\"fetched_at\":\"2099-01-01T00:00:00Z\",\"context\":{\"graph_version\":$v}}"
+  rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+  runtime_dispatch_outbox >/dev/null 2>&1
+done
+f16="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID16.json" | head -1)"
+[ -n "$f16" ] && echo "OK con la version local cambiando, la propuesta no agota la racha de 409" \
+  || { echo "FAIL se aparto la propuesta pese a que cada 409 fue contra otra version"; fail=1; }
+n16="$(python3 -c "import json; print(json.load(open('$f16')).get('graph_409'))" 2>/dev/null)"
+[ "$n16" = 1 ] && echo "OK la racha se reinicia en cada version local nueva" \
+  || { echo "FAIL la racha no se reinicio con la version nueva ($n16)"; fail=1; }
+v16="$(python3 -c "import json; print(json.load(open('$f16')).get('graph_409_at_version'))" 2>/dev/null)"
+[ "$v16" = 83 ] && echo "OK el marcador recuerda con que version local se rechazo" \
+  || { echo "FAIL el marcador de version de la racha ($v16)"; fail=1; }
+# La misma versión tres veces SÍ agota la racha (el corte sigue existiendo).
+for _ in 1 2 3; do
+  rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+  runtime_dispatch_outbox >/dev/null 2>&1
+done
+f16="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID16.json" | head -1)"
+[ -z "$f16" ] && echo "OK tres 409 contra la MISMA version local siguen apartando la propuesta" \
+  || { echo "FAIL el corte de la racha desaparecio"; fail=1; }
+
+# [B2] Un fichero SIN estampar que recibe un 409 no puede heredar la versión del fichero
+# ANTERIOR del mismo lote: el marcador se graba con `local: null`, no con una versión inventada
+# (ni con el 0, que tampoco es una versión real). El fixture necesita DOS ficheros directos en
+# el MISMO despacho —uno estampado y otro no, en ese orden— porque `gv` es `local` a la función
+# y con un solo fichero nace vacío igualmente: la fuga solo existe ENTRE iteraciones del bucle.
+runtime_graph_clear_stale
+runtime_projection_write '{"fetched_at":"2099-01-01T00:00:00Z","context":{"graph_version":77}}'
+CID17A="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json" 1)"
+CID17="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json")"
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+runtime_dispatch_outbox >/dev/null 2>&1
+# El orden FIFO (prefijo de timestamp) garantiza que el estampado se procesa primero; el
+# marcador refleja el ÚLTIMO 409, o sea el del fichero sin estampar.
+sent_gv="$(python3 - "$TMP/calls-d.jsonl" <<'PY'
+import json,sys
+last=None
+for l in open(sys.argv[1]):
+    d=json.loads(l)
+    if d["path"]=="/projects/p-1/epic-proposals":
+        last=json.loads(d["body"]).get("graph_version")
+print("" if last is None else last)
+PY
+)"
+[ -z "$sent_gv" ] && echo "OK el fichero sin estampar viaja sin graph_version" \
+  || { echo "FAIL el fichero sin estampar heredo una graph_version ($sent_gv)"; fail=1; }
+lv="$(runtime_graph_status_read | python3 -c 'import json,sys; print(json.load(sys.stdin).get("local"))' 2>/dev/null)"
+[ "$lv" = None ] && echo "OK sin version estampada, el desfase se anota como ausente (no 0 ni heredada)" \
+  || { echo "FAIL el desfase invento una version local ($lv)"; fail=1; }
+v17="$(python3 -c "import json;print(json.load(open('$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID17.json" | head -1)')).get('graph_409_at_version'))" 2>/dev/null)"
+[ "$v17" = None ] && echo "OK la racha del fichero sin estampar no hereda la version del anterior" \
+  || { echo "FAIL la racha heredo la version del fichero anterior ($v17)"; fail=1; }
+find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 \( -name "*$CID17.json" -o -name "*$CID17A.json" \) -delete 2>/dev/null
+
+# [B1] Un fichero ILEGIBLE de la cola se aparta con su razón en vez de quedarse atascado para
+# siempre: como `batch` se saltaba en silencio al armar el lote y la cota nunca lo evictaba.
+cat > "$TMP/routes-d.json" <<'JSON'
+{"POST /events": {"status": 200, "body": {"accepted": [], "duplicates": [], "rejected": []}}}
+JSON
+BADF="$CLAUDE_PROJECT_DIR/.claude/state/outbox/20990101000000000000-corrupto.json"
+printf 'esto no es json' > "$BADF"
+rm -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json"
+err_bad="$(runtime_dispatch_outbox 2>&1 >/dev/null)"
+[ ! -f "$BADF" ] && echo "OK un fichero ilegible sale de la cola" \
+  || { echo "FAIL el fichero ilegible sigue atascado en la cola"; fail=1; }
+[ -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/rejected/$(basename "$BADF")" ] \
+  && echo "OK el fichero ilegible se aparta a rejected/" \
+  || { echo "FAIL el fichero ilegible no llego a rejected/"; fail=1; }
+echo "$err_bad" | grep -qi 'ilegible' && echo "OK el apartado del fichero ilegible nombra la causa" \
+  || { echo "FAIL el apartado del ilegible no dice por que ($err_bad)"; fail=1; }
+
+# [C4] Si la partición de la cola falla (E2BIG con una cola enorme, python caído), el despacho
+# NO puede devolver 0 con la cola llena ni borrar el backoff agendado: eso es un fallo
+# reportado como drenaje limpio.
+CID18="$(runtime_enqueue_direct epic_proposed POST /projects/p-1/epic-proposals "$TMP/prop.json")"
+python3 -c "import json;json.dump({'next_attempt_epoch':0,'attempt':2}, open('$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json','w'))"
+_runtime_partition_outbox() { return 1; }
+err_part="$(runtime_dispatch_outbox 2>&1 >/dev/null)"
+rc=$?
+[ "$rc" -ne 0 ] && echo "OK una particion fallida no se reporta como cola drenada" \
+  || { echo "FAIL rc 0 con la particion fallida"; fail=1; }
+echo "$err_part" | grep -qi 'clasificar' && echo "OK la particion fallida se dice en stderr" \
+  || { echo "FAIL la particion fallida es muda ($err_part)"; fail=1; }
+[ -f "$CLAUDE_PROJECT_DIR/.claude/state/outbox/.dispatch-state.json" ] \
+  && echo "OK la particion fallida conserva el backoff agendado" \
+  || { echo "FAIL el backoff se borro con la particion fallida"; fail=1; }
+found="$(find "$CLAUDE_PROJECT_DIR/.claude/state/outbox" -maxdepth 1 -name "*$CID18.json" | head -1)"
+[ -n "$found" ] && echo "OK la particion fallida conserva la cola" \
+  || { echo "FAIL la cola se perdio con la particion fallida"; fail=1; }
+unset -f _runtime_partition_outbox
+source "$ROOT/hooks/build/lib/runtime-client.sh"
+
+kill "$STUB_D" 2>/dev/null; wait "$STUB_D" 2>/dev/null
+
+unset CLAUDE_PROJECT_DIR BUILD_CONFIG_FILE
+
 exit $fail