@trycore/spec-build-harness 0.14.1 → 0.14.2

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "trycore-spec-build-harness",
   "displayName": "Trycore — Spec & Build Harness",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "description": "Arnés de construcción de dos loops (slice por épica + release gate) para Claude Code, con gates de calidad, estado compartido y OpenSpec. Compañero de @trycore/spec-product-flow. Agnóstico al proyecto.",
   "author": {
     "name": "Trycore",

package/README.md

@@ -198,8 +198,10 @@ El core no menciona ningún dominio de cliente. Toda parametrización entra por
   día—. **(3)** `claim` y la propuesta mandan la **versión de grafo** conocida, estampada *al
   despachar* y no al encolar; un `409` por grafo rancio provoca refresco y un reintento en vez de
   un fallo. `legacy` sigue siendo el default y no cambia. Las mitades de servidor de (2) y (3)
-  (`trycore-ia-hub#113`/`#114`/`#115`) están pendientes: contra un hub sin ellas el cliente degrada
-  a «instancia sin soporte». Total: **14 agentes**, **19 hooks**, **13 comandos `/build:*`**,
+  ya existen en el hub, en el **carril del agente** (`/projects/{id}/agent/epic-proposals`), y la
+  **v0.14.2** alineó al cliente con ese contrato: hasta entonces pegaba contra la ruta de consola
+  y la propuesta moría con `405`/`422` (#70). Contra un hub que no lo exponga, el cliente degrada a
+  «instancia sin soporte». Total: **14 agentes**, **19 hooks**, **13 comandos `/build:*`**,
   **16 skills**.
 - ✅ **v0.13.0 — el grafo llega al hub con aristas** — las dependencias entre épicas viven como
   prosa en `epicas.md` (`**Depende de**: EP-001`) y su lectura estaba delegada al modelo, con un

package/VERSION

@@ -1 +1 @@
-0.14.1
+0.14.2

package/commands/build/epic.md

@@ -49,6 +49,9 @@ Reúne del repo y de `docs/` lo necesario y **propón** al usuario, vía **AskUs
 título, objetivo, capa (`foundational` | `business` | `technical`), alcance de archivos y
 dependencias con épicas existentes. Las historias van con AC en Given/When/Then.
 
+El grafo del hub solo distingue **dos** capas (`FOUNDATIONAL` y `BUSINESS`): una épica
+`technical` viaja como `business` y eso es correcto, no un error que debas corregir.
+
 No inventes la clasificación de capa ni las dependencias: derívalas del PRD / Story Map y
 confírmalas. Sin aprobación explícita del usuario, **no propongas nada**.
 
@@ -61,10 +64,21 @@ Escribe el borrador en un fichero temporal (nunca por argv):
   "layer": "business",
   "files_scope": ["src/…/**"],
   "depends_on": ["EP-012"],
-  "stories": [{"title": "…", "acceptance_criteria": "Dado … Cuando … Entonces …"}]
+  "stories": [
+    {
+      "title": "…",
+      "description": "Como … quiero … para …",
+      "acceptance_criteria": "Dado … Cuando … Entonces …. Dado … Cuando … Entonces …"
+    }
+  ]
 }
 ```
 
+Escribe los criterios **completos** en `acceptance_criteria`: `slice-ops.sh` los parte en un
+escenario por entrada y los manda como `acceptance[]`, que es lo que la consola del hub enseña
+en el detalle de la historia (issue #70). Varios escenarios en un mismo campo se separan con
+`. Dado …`; si prefieres darlos ya partidos, usa `"acceptance": ["Dado …", "Dado …"]` y manda.
+
 ## 2. Proponer
 
 ```bash

package/docs/runtime/protocolo-cliente-runtime.md

@@ -228,8 +228,8 @@ modo, valida en local lo que es barato validar y encola lo que no pudo entregar.
 | `slice-ops.sh propose-asset` | `POST …/context/agent-proposals` (§6) |
 | `slice-ops.sh status` | `GET /agent/context` (refresco) + ficheros locales; reporta además `outbox/rejected/` (conteo + tipo y razón del rechazo más reciente, issue #52) |
 | `slice-ops.sh escalate` | evento `slice_escalated {cause}` (gate y fase dentro del texto de la causa; exige slice activo en runtime) |
-| `slice-ops.sh propose-epic --file B` | `POST /projects/{id}/epic-proposals` (carril directo). Propone una épica **sin `EP-XXX`**: la identidad la asigna el hub al aprobar (hub#113). `0` enviada · `5` encolada · `6` rechazada · `3` legacy/dual. Un `epic_code` en el borrador se **ignora**, no se rechaza |
-| `slice-ops.sh epic-status [--id P]` | `GET /projects/{id}/epic-proposals/{P}`. Resuelve el ciclo: `QUEUED` → `PROPOSED` → `APPROVED` (con `epic_code`) / `REJECTED`. Informativo: `rc 0` siempre en runtime |
+| `slice-ops.sh propose-epic --file B` | `POST /projects/{id}/agent/epic-proposals` (carril directo). Propone una épica **sin `EP-XXX`**: la identidad la asigna el hub al aprobar. `0` enviada · `5` encolada · `6` rechazada · `3` legacy/dual. Un `epic_code` en el borrador se **ignora**, no se rechaza. El identificador llega en `id` de `EpicProposalOut` |
+| `slice-ops.sh epic-status [--id P]` | `GET /projects/{id}/agent/epic-proposals/{P}`. Resuelve el ciclo: `QUEUED` → `PROPOSED` → `APPROVED` (código en `assigned_code`) / `REJECTED` (motivo en `reject_reason`). Informativo: `rc 0` siempre en runtime |
 | `slice-ops.sh epic-writeback [--id P] [--file F]` | — (local). Escribe en `docs/03-backlog/epicas.md` las épicas ya `APPROVED`, con el código del hub. Mecánico e idempotente: el fichero es proyección del grafo. `--file F` permite otro fichero del backlog (partido en varios), pero **F queda acotado al subárbol `docs/03-backlog/` del proyecto** —`realpath` sobre ambos lados, así que ni symlinks ni `..` escapan— porque los contactos de escritura del arnés en `docs/` son cuatro y acotados (METODOLOGIA §9.2) y este comando promete tocar solo el backlog. Fuera de ahí, `2` con la ruta permitida en el mensaje y **cero escritura**, exista el fichero o no. `0` escribió · `7` nada pendiente · `4` sin fichero · `2` `--file` fuera del carve-out |
 | `release-ops.sh verdict <line> <gate> <estado>` | `POST /releases/{line}/verdicts`; **sin fallback offline** (rc 5 y reintento al reconectar: el agregado `release` no entra por `POST /events`, issue #44) |
 | `release-ops.sh close-hint <line>` | **ninguna**: el cierre es humano, con PDP |
@@ -244,14 +244,27 @@ modo, valida en local lo que es barato validar y encola lo que no pudo entregar.
   "layer": "foundational|business|technical",
   "files_scope": ["…"],
   "depends_on": ["EP-012"],
-  "stories": [{"title": "…", "acceptance_criteria": "…"}]
+  "stories": [{"title": "…", "description": "…", "acceptance_criteria": "Dado … Cuando … Entonces …"}]
 }
 ```
 
 `title` y `objective` son obligatorios; `layer` por defecto `business` (rc 2 si no es una de las
 tres). Un `epic_code`/`code`/`id` en el borrador **se ignora con aviso**, no se rechaza la
-propuesta — la identidad la asigna el hub al aprobar (hub#113). El normalizador estampa
-`origin: "harness-draft"` antes de encolar.
+propuesta — la identidad la asigna el hub al aprobar.
+
+**El borrador NO es el payload** (issue #70). El normalizador traduce al contrato del agente
+(`EpicProposalIn`) antes de encolar, y esa traducción es la única superficie que conoce los dos
+vocabularios:
+
+| Borrador (lo que escribe el agente) | Contrato del hub |
+|---|---|
+| `layer: "foundational"` | `layer: "FOUNDATIONAL"` |
+| `layer: "business"` \| `"technical"` | `layer: "BUSINESS"` — el hub no tiene capa técnica; `technical` se **mapea**, no se rechaza |
+| `stories[].acceptance_criteria` (prosa) | `stories[].acceptance[]` — un escenario Dado/Cuando/Entonces por entrada (se parte por líneas y por el `. Dado ` que une dos escenarios). Una `acceptance[]` ya explícita en el borrador manda |
+| `stories[].description` | `stories[].description` (tal cual) |
+
+El hub descarta los campos que no reconoce (`extra="ignore"`): mandar `acceptance_criteria`
+**no da error**, simplemente llega una historia sin un solo criterio a la consola.
 
 **Códigos de salida** (contrato con la prosa): `0` ok · `2` uso · `3` modo legacy (o claim en dual)
 · `4` sin slice activo · `5` offline (encolado si el tipo tiene camino por la cola; si no, reintento manual al reconectar) · `6` rechazado por el servidor (no reintentar) ·

package/hooks/build/lib/runtime-ops.sh

@@ -112,8 +112,11 @@ ops_path_proposals() { echo "/projects/$1/context/agent-proposals"; }
 # (`EP-XXX`) al aprobar y un humano aprueba: por eso hay una ruta de creación y otra de
 # consulta, y ninguna de publicación. Mismo patrón que las propuestas de asset
 # (`ops_path_proposals`), que es su precedente en este cliente.
-ops_path_epic_proposals() { echo "/projects/$1/epic-proposals"; }
-ops_path_epic_proposal() { echo "/projects/$1/epic-proposals/$2"; }
+# [#70] El carril del AGENTE lleva `/agent/`: `/projects/{id}/epic-proposals` (sin él) es la
+# vista de CONSOLA — GET con JWT de usuario — y responde `405 Allow: GET` a un POST con token
+# de proyecto. Las dos superficies no se comparten por diseño (hub CON-1).
+ops_path_epic_proposals() { echo "/projects/$1/agent/epic-proposals"; }
+ops_path_epic_proposal() { echo "/projects/$1/agent/epic-proposals/$2"; }
 
 ops_mode() { runtime_mode; }
 

package/hooks/build/slice-ops.sh

@@ -485,8 +485,29 @@ _epic_draft_normalize() {
   # el motivo del rc 2 (validación) o el aviso de `epic_code` ignorado; silenciarlo aquí
   # los perdería a los dos.
   python3 - "$f" <<'PY'
-import json,sys
-CAPAS={"foundational","business","technical"}
+import json,re,sys
+# [#70] El vocabulario del BORRADOR (lo que escribe el agente) y el del CONTRATO del hub
+# (`EpicProposalIn`) no son el mismo: el borrador habla en minúsculas y conoce `technical`;
+# el hub solo acepta el literal FOUNDATIONAL|BUSINESS. La traducción vive aquí, en el borde,
+# porque rechazar `technical` sería castigar al agente por una distinción que el grafo no
+# hace: para el hub una épica técnica es de negocio.
+CAPAS={"foundational":"FOUNDATIONAL","business":"BUSINESS","technical":"BUSINESS"}
+
+def escenarios(txt):
+    """Criterios en prosa -> `acceptance[]` del contrato: un escenario Dado/Cuando/Entonces
+    por entrada. Se parte por líneas y, dentro de cada una, por el `. Dado ` que separa dos
+    escenarios seguidos en un mismo párrafo."""
+    out=[]
+    for linea in str(txt).splitlines():
+        linea=linea.strip().lstrip("-*•").strip()
+        if not linea:
+            continue
+        for trozo in re.split(r"\.\s+(?=Dado\s)", linea):
+            trozo=trozo.strip()
+            if trozo:
+                out.append(trozo[:2000])
+    return out[:20]
+
 try:
     d=json.load(open(sys.argv[1]))
 except Exception:
@@ -499,29 +520,77 @@ if not title:
     print("⛔ el borrador no trae `title` (título de la épica)", file=sys.stderr); raise SystemExit(2)
 if not objective:
     print("⛔ el borrador no trae `objective` (objetivo de la épica)", file=sys.stderr); raise SystemExit(2)
-layer=d.get("layer") or "business"
+layer=str(d.get("layer") or "business").strip().lower()
 if layer not in CAPAS:
     print("⛔ `layer` debe ser uno de: %s" % ", ".join(sorted(CAPAS)), file=sys.stderr); raise SystemExit(2)
 ignorados=[k for k in ("epic_code","code","id") if d.get(k)]
 stories=[]
 for s in d.get("stories") or []:
     if isinstance(s,str):
-        stories.append({"title":s})
+        stories.append({"title":s[:300]})
     elif isinstance(s,dict) and (s.get("title") or "").strip():
-        st={"title":s["title"].strip()}
-        if s.get("acceptance_criteria"):
-            st["acceptance_criteria"]=str(s["acceptance_criteria"])[:2000]
+        st={"title":s["title"].strip()[:300]}
+        if s.get("description"):
+            st["description"]=str(s["description"])[:2000]
+        # La `acceptance` explícita del borrador manda; si no, se derivan de los criterios en
+        # prosa. `acceptance_criteria` NO viaja: el hub descarta el campo en el borde
+        # (`extra="ignore"`) y la consola enseñaba las historias sin un solo criterio.
+        acc=s.get("acceptance")
+        if isinstance(acc,list):
+            acc=[str(x).strip()[:2000] for x in acc if str(x).strip()][:20]
+        elif s.get("acceptance_criteria"):
+            acc=escenarios(s["acceptance_criteria"])
+        else:
+            acc=[]
+        if acc:
+            st["acceptance"]=acc
         stories.append(st)
-out={"title":title[:300],"objective":objective[:2000],"layer":layer,
+out={"title":title[:300],"objective":objective[:2000],"layer":CAPAS[layer],
      "files_scope":[str(x) for x in (d.get("files_scope") or []) if isinstance(x,(str,int))],
      "depends_on":[str(x) for x in (d.get("depends_on") or []) if isinstance(x,(str,int))],
-     "stories":stories,"origin":"harness-draft"}
+     "stories":stories}
 if ignorados:
     print("IGNORADOS %s" % ",".join(ignorados), file=sys.stderr)
 print(json.dumps(out,ensure_ascii=False))
 PY
 }
 
+# [#70] `EpicProposalOut` del contrato nombra `id` al identificador de la propuesta (el
+# borrador de hub#113 lo llamaba `proposal_id`). Sin esto la terminal decía «sin identificador
+# en la respuesta» y el ledger guardaba "" — `epic-status` se quedaba sin a quién preguntar.
+# Se acepta el nombre viejo como respaldo: un hub anterior al contrato sigue funcionando.
+_epic_proposal_id() {
+  command -v python3 >/dev/null 2>&1 || { echo ""; return; }
+  printf '%s' "$1" | python3 -c '
+import json,sys
+try:
+    d=json.load(sys.stdin)
+    r=(d.get("response") if isinstance(d.get("response"),dict) else d) or {}
+    print(r.get("id") or r.get("proposal_id") or "")
+except Exception:
+    print("")
+' 2>/dev/null
+}
+
+# _epic_from_response <respuesta> — la épica aprobada como objeto para el ledger. El contrato
+# la devuelve en la RAÍZ de `EpicProposalOut`; el borrador viejo la anidaba en `epic`.
+_epic_from_response() {
+  command -v python3 >/dev/null 2>&1 || { echo "{}"; return; }
+  printf '%s' "$1" | python3 -c '
+import json,sys
+try:
+    d=json.load(sys.stdin)
+except Exception:
+    print("{}"); raise SystemExit(0)
+if not isinstance(d,dict):
+    print("{}"); raise SystemExit(0)
+e=d.get("epic")
+if not isinstance(e,dict):
+    e={k:d[k] for k in ("title","objective","layer","stories","files_scope","depends_on") if k in d}
+print(json.dumps(e,ensure_ascii=False))
+' 2>/dev/null || echo "{}"
+}
+
 cmd_propose_epic() {
   local file="" mode pid norm errf rc cid pfile ack proposal_id reason
   while [ $# -gt 0 ]; do
@@ -590,7 +659,7 @@ cmd_propose_epic() {
   runtime_dispatch_outbox >/dev/null 2>&1
   ack="$(ops_epic_ack_read "$cid")"
   if [ -n "$ack" ]; then
-    proposal_id="$(printf '%s' "$ack" | python3 -c 'import json,sys; print((json.load(sys.stdin).get("response") or {}).get("proposal_id") or "")' 2>/dev/null)"
+    proposal_id="$(_epic_proposal_id "$ack")"
     ops_epic_ledger_upsert "{\"client_event_id\":\"$cid\",\"status\":\"PROPOSED\",\"proposal_id\":$(ops_json_str "$proposal_id")}"
     echo "propuesta enviada: ${proposal_id:-sin identificador en la respuesta}"
     echo "Queda en PROPOSED: NO es reclamable hasta que un humano la apruebe en la consola del hub."
@@ -662,7 +731,7 @@ cmd_epic_status() {
     if [ "$st" = "QUEUED" ] && [ -n "$cid" ]; then
       ack="$(ops_epic_ack_read "$cid")"
       if [ -n "$ack" ]; then
-        pidv="$(printf '%s' "$ack" | python3 -c 'import json,sys; print((json.load(sys.stdin).get("response") or {}).get("proposal_id") or "")' 2>/dev/null)"
+        pidv="$(_epic_proposal_id "$ack")"
         st=PROPOSED
         ops_epic_ledger_upsert "{\"client_event_id\":\"$cid\",\"status\":\"PROPOSED\",\"proposal_id\":$(ops_json_str "$pidv")}"
       else
@@ -686,13 +755,18 @@ cmd_epic_status() {
           case "$st" in
             APPROVED)
               local code epic
-              code="$(_claim_field "$resp" epic_code)"
-              epic="$(printf '%s' "$resp" | python3 -c 'import json,sys; print(json.dumps(json.load(sys.stdin).get("epic") or {},ensure_ascii=False))' 2>/dev/null)"
+              # [#70] El código lo asigna el hub en `assigned_code` (EP-OR-15); `epic_code` era
+              # el nombre del borrador y se conserva como respaldo.
+              code="$(_claim_field "$resp" assigned_code)"
+              [ -n "$code" ] || code="$(_claim_field "$resp" epic_code)"
+              epic="$(_epic_from_response "$resp")"
               [ -n "$epic" ] || epic="{}"
               ops_epic_ledger_upsert "{\"client_event_id\":\"$cid\",\"status\":\"APPROVED\",\"epic_code\":$(ops_json_str "$code"),\"epic\":$epic}"
               echo "$pidv  APPROVED     $code — escríbela con \`slice-ops.sh epic-writeback\`" ;;
             REJECTED)
-              local why; why="$(_claim_field "$resp" reason)"
+              # [#70] El motivo del rechazo humano viaja en `reject_reason` (EP-OR-15).
+              local why; why="$(_claim_field "$resp" reject_reason)"
+              [ -n "$why" ] || why="$(_claim_field "$resp" reason)"
               ops_epic_ledger_upsert "{\"client_event_id\":\"$cid\",\"status\":\"REJECTED\",\"reason\":$(ops_json_str "$why")}"
               echo "$pidv  REJECTED     ${why:-sin motivo registrado}" ;;
             *)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trycore/spec-build-harness",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "description": "Arnés agéntico de construcción de Trycore para Claude Code: pipeline de dos loops (slice por épica + release gate) con gates de calidad, estado compartido y OpenSpec. Compañero de @trycore/spec-product-flow. Agnóstico al proyecto.",
   "type": "module",
   "bin": {

package/scripts/tests/test-skill-ops.sh

@@ -31,9 +31,11 @@ source "$ROOT/hooks/build/lib/runtime-ops.sh" 2>/dev/null || { echo "FAIL no exi
 [ "$(ops_path_front_integration f-1 ak-1)" = "/fronts/f-1/members/ak-1/integration" ] && echo "OK ops_path_front_integration" || { echo "FAIL ops_path_front_integration"; fail=1; }
 
 # [#62] Tabla de rutas de la propuesta de épica: un solo sitio donde se escriben rutas.
-[ "$(ops_path_epic_proposals p-1)" = "/projects/p-1/epic-proposals" ] \
+# [#70] El carril del AGENTE lleva `/agent/`: `/projects/{id}/epic-proposals` es la vista de
+# consola (GET, JWT de usuario) y devuelve 405 a un POST — el drift que rompió el piloto.
+[ "$(ops_path_epic_proposals p-1)" = "/projects/p-1/agent/epic-proposals" ] \
   && echo "OK ops_path_epic_proposals" || { echo "FAIL ops_path_epic_proposals"; fail=1; }
-[ "$(ops_path_epic_proposal p-1 prop-7)" = "/projects/p-1/epic-proposals/prop-7" ] \
+[ "$(ops_path_epic_proposal p-1 prop-7)" = "/projects/p-1/agent/epic-proposals/prop-7" ] \
   && echo "OK ops_path_epic_proposal" || { echo "FAIL ops_path_epic_proposal"; fail=1; }
 
 # [#62] Ledger: upsert por client_event_id, sin duplicar, conservando lo no mencionado.
@@ -1618,9 +1620,13 @@ runtime_credentials_merge "{\"runtime_url\":\"http://127.0.0.1:$PORT_GA\"}"
 # ══════════════ slice-ops.sh: propose-epic / epic-status / epic-writeback [#62] ══════════════
 # Stub PROPIO (puerto, routes-ep.json y calls-ep.jsonl): routes-cl.json/STUB_CL ya no existen
 # en este punto del fichero y mutarlos rompería aserciones aguas arriba.
+# [#70] Las rutas y los cuerpos de este bloque son los del CONTRATO DEL AGENTE del hub
+# (`contrato-agente-openapi.json`, EP-OR-14/EP-OR-15), no los del borrador de hub#113:
+# carril `/agent/…`, `layer` en MAYÚSCULAS (FOUNDATIONAL|BUSINESS), historias con
+# `description`+`acceptance[]`, y respuesta `{id, status, assigned_code, reject_reason}`.
 PORT_EP="$(freeport)"
 cat > "$TMP/routes-ep.json" <<JSON
-{"POST /projects/p-1/epic-proposals": {"status": 201, "body": {"proposal_id": "prop-77", "status": "PROPOSED"}}}
+{"POST /projects/p-1/agent/epic-proposals": {"status": 201, "body": {"id": "prop-77", "project_id": "p-1", "title": "Notificaciones en tiempo real", "objective": "que el usuario vea los avisos sin recargar", "layer": "BUSINESS", "stories": [], "files_scope": [], "depends_on": [], "status": "PROPOSED", "assigned_code": null, "reject_reason": null}}}
 JSON
 : > "$TMP/calls-ep.jsonl"
 python3 "$ROOT/scripts/tests/lib/http-stub.py" "$PORT_EP" "$TMP/routes-ep.json" "$TMP/calls-ep.jsonl" &
@@ -1634,7 +1640,8 @@ cat > "$TMP/draft.json" <<'JSON'
 {"title":"Notificaciones en tiempo real","objective":"que el usuario vea los avisos sin recargar",
  "layer":"business","files_scope":["src/notifications/**"],"depends_on":["EP-012"],
  "epic_code":"EP-999",
- "stories":[{"title":"ver el aviso","acceptance_criteria":"Dado … Cuando … Entonces …"}]}
+ "stories":[{"title":"ver el aviso","description":"Como usuario quiero ver el aviso sin recargar",
+             "acceptance_criteria":"Dado un aviso nuevo Cuando llega Entonces se ve. Dado un aviso leído Cuando entro Entonces no se repite"}]}
 JSON
 
 # legacy y dual: rc 3 sin efectos (ni cola, ni red).
@@ -1659,22 +1666,59 @@ out="$(bash "$SO" propose-epic --file "$TMP/draft.json" 2>&1)"; rc=$?
   && echo "OK propose-epic envia y devuelve el identificador" \
   || { echo "FAIL propose-epic online (rc $rc): $out"; fail=1; }
 
-# El EP-XXX del borrador se IGNORA (la identidad la asigna el hub, hub#113) — ignorar, no rechazar.
+# [#70] El cuerpo enviado valida contra `EpicProposalIn` del contrato del agente: `layer` en
+# MAYÚSCULAS, historias con `description`+`acceptance[]` y NUNCA `acceptance_criteria` (el
+# hub lo descarta en el borde con extra="ignore": la consola mostraba las HU sin criterios).
 body="$(python3 - "$TMP/calls-ep.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=json.loads(d["body"])
-        print("SI" if "epic_code" not in b and b.get("title","").startswith("Notificaciones") else "NO")
+    if d["path"]=="/projects/p-1/agent/epic-proposals":
+        b=json.loads(d["body"]); errores=[]
+        if b.get("layer")!="BUSINESS": errores.append("layer=%r" % b.get("layer"))
+        if "epic_code" in b: errores.append("viajo el epic_code del borrador")
+        if not b.get("title","").startswith("Notificaciones"): errores.append("title=%r" % b.get("title"))
+        s=(b.get("stories") or [{}])[0]
+        if "acceptance_criteria" in s: errores.append("la historia lleva acceptance_criteria")
+        if set(s)-{"title","description","acceptance","code","acceptance_ref"}:
+            errores.append("campos fuera del contrato: %s" % sorted(set(s)-{"title","description","acceptance","code","acceptance_ref"}))
+        if s.get("description")!="Como usuario quiero ver el aviso sin recargar":
+            errores.append("description=%r" % s.get("description"))
+        acc=s.get("acceptance")
+        if not isinstance(acc,list) or len(acc)!=2: errores.append("acceptance=%r" % acc)
+        elif not acc[0].startswith("Dado un aviso nuevo") or not acc[1].startswith("Dado un aviso leído"):
+            errores.append("escenarios mal partidos: %r" % acc)
+        print("SI" if not errores else "NO: "+" | ".join(errores))
         break
 PY
 )"
-[ "$body" = SI ] && echo "OK propose-epic ignora el EP-XXX del borrador" \
-  || { echo "FAIL el EP-XXX viajo al hub ($body)"; fail=1; }
+[ "$body" = SI ] && echo "OK el cuerpo de propose-epic valida contra el contrato del agente" \
+  || { echo "FAIL cuerpo de propose-epic ($body)"; fail=1; }
 echo "$out" | grep -qi 'ignorado' && echo "OK propose-epic avisa de que ignoro el codigo" \
   || { echo "FAIL sin aviso del codigo ignorado"; fail=1; }
 
+# [#70] `technical` no existe en el enum del hub (FOUNDATIONAL|BUSINESS): el 422 que devolvía
+# se evita mapeándolo a BUSINESS en el borde, no rechazando el borrador del agente.
+cat > "$TMP/draft-tech.json" <<'JSON'
+{"title":"Observabilidad","objective":"ver qué pasa en produccion","layer":"technical",
+ "stories":[{"title":"ver las trazas"}]}
+JSON
+: > "$TMP/calls-ep.jsonl"
+bash "$SO" propose-epic --file "$TMP/draft-tech.json" >/dev/null 2>&1
+tech="$(python3 - "$TMP/calls-ep.jsonl" <<'PY'
+import json,sys
+for l in open(sys.argv[1]):
+    d=json.loads(l)
+    if d["path"]=="/projects/p-1/agent/epic-proposals":
+        b=json.loads(d["body"])
+        s=(b.get("stories") or [{}])[0]
+        print("SI" if b.get("layer")=="BUSINESS" and "acceptance" not in s else "NO: layer=%r story=%r" % (b.get("layer"), s))
+        break
+PY
+)"
+[ "$tech" = SI ] && echo "OK layer technical viaja como BUSINESS y una historia sin AC no inventa acceptance" \
+  || { echo "FAIL mapeo de layer technical ($tech)"; fail=1; }
+
 # El ledger recuerda la propuesta con su borrador.
 ops_epic_ledger_read | python3 -c "
 import json,sys
@@ -1710,14 +1754,18 @@ out="$(bash "$SO" propose-epic --file "$TMP/malo.json" 2>&1)"
   || { echo "FAIL validacion local del borrador: $out"; fail=1; }
 
 # --- [#62] epic-status ---
+# [#70] La respuesta es `EpicProposalOut` del contrato: el código aprobado viaja en
+# `assigned_code` y la épica en la RAÍZ (no anidada en `epic`).
 python3 - "$TMP/routes-ep.json" <<'PY'
 import json,sys
 p=sys.argv[1]; d=json.load(open(p))
-d["GET /projects/p-1/epic-proposals/prop-77"]={"status":200,"body":{
-  "proposal_id":"prop-77","status":"APPROVED","epic_code":"EP-045",
-  "epic":{"title":"Notificaciones en tiempo real","objective":"que el usuario vea los avisos sin recargar",
-          "layer":"business","depends_on":["EP-012"],
-          "stories":[{"code":"HU-310","title":"ver el aviso"}]}}}
+d["GET /projects/p-1/agent/epic-proposals/prop-77"]={"status":200,"body":{
+  "id":"prop-77","project_id":"p-1","status":"APPROVED","assigned_code":"EP-045",
+  "title":"Notificaciones en tiempo real","objective":"que el usuario vea los avisos sin recargar",
+  "layer":"BUSINESS","depends_on":["EP-012"],"files_scope":["src/notifications/**"],
+  "stories":[{"code":"HU-310","title":"ver el aviso","description":"Como usuario…",
+              "acceptance":["Dado un aviso nuevo Cuando llega Entonces se ve"],"acceptance_ref":None},],
+  "reject_reason":None}}
 json.dump(d,open(p,"w"))
 PY
 TRYCORE_RUNTIME_MODE=legacy bash "$SO" epic-status >/dev/null 2>&1
@@ -1733,20 +1781,38 @@ out="$(bash "$SO" epic-status 2>&1)"; rc=$?
   || { echo "FAIL epic-status (rc $rc): $out"; fail=1; }
 ops_epic_ledger_read | python3 -c "
 import json,sys
-p=json.load(sys.stdin)['proposals'][0]
-print('SI' if p['status']=='APPROVED' and p['epic_code']=='EP-045' and p['epic']['stories'][0]['code']=='HU-310' else 'NO')" \
+ps=json.load(sys.stdin)['proposals']
+p=[q for q in ps if q.get('proposal_id')=='prop-77'][0]
+print('SI' if p['status']=='APPROVED' and p['epic_code']=='EP-045' and p['epic']['stories'][0]['code']=='HU-310' and p['epic']['title'].startswith('Notificaciones') else 'NO')" \
   | grep -q SI && echo "OK epic-status guarda el codigo y el contenido aprobado" \
   || { echo "FAIL el ledger no recogio la aprobacion"; fail=1; }
 
+# [#70] El rechazo humano viaja en `reject_reason` (EP-OR-15): sin leerlo, la terminal decía
+# "sin motivo registrado" y el usuario no sabía qué corregir.
+python3 - "$TMP/routes-ep.json" <<'PY'
+import json,sys
+p=sys.argv[1]; d=json.load(open(p))
+d["GET /projects/p-1/agent/epic-proposals/prop-88"]={"status":200,"body":{
+  "id":"prop-88","project_id":"p-1","status":"REJECTED","assigned_code":None,
+  "title":"Otra","objective":"otra cosa","layer":"BUSINESS","depends_on":[],"files_scope":[],
+  "stories":[],"reject_reason":"se solapa con EP-012"}}
+json.dump(d,open(p,"w"))
+PY
+ops_epic_ledger_upsert '{"client_event_id":"cid-r","proposal_id":"prop-88","status":"PROPOSED"}'
+out="$(bash "$SO" epic-status --id prop-88 2>&1)"; rc=$?
+[ $rc -eq 0 ] && echo "$out" | grep -q 'se solapa con EP-012' \
+  && echo "OK epic-status muestra el motivo del rechazo humano" \
+  || { echo "FAIL motivo del rechazo (rc $rc): $out"; fail=1; }
+
 # Un hub sin soporte (404) se dice con esas palabras y NO rompe nada.
 python3 - "$TMP/routes-ep.json" <<'PY'
 import json,sys
 p=sys.argv[1]; d=json.load(open(p))
-d.pop("GET /projects/p-1/epic-proposals/prop-77",None)
+d.pop("GET /projects/p-1/agent/epic-proposals/prop-77",None)
 json.dump(d,open(p,"w"))
 PY
 ops_epic_ledger_upsert '{"client_event_id":"cid-x","proposal_id":"prop-77","status":"PROPOSED"}'
-out="$(bash "$SO" epic-status 2>&1)"; rc=$?
+out="$(bash "$SO" epic-status --id prop-77 2>&1)"; rc=$?
 [ $rc -eq 0 ] && echo "$out" | grep -qi 'sin soporte' \
   && echo "OK epic-status nombra la falta de soporte del hub" \
   || { echo "FAIL epic-status con 404 (rc $rc): $out"; fail=1; }