@nac3/forge-cli 0.2.0-alpha.5 → 0.2.0-alpha.59z.119

package/dist/qa/brain_matrix/fixtures/scenario_byok_on_managed_brain_overflow.json

@@ -0,0 +1,28 @@
+{
+  "id": "byok_on_managed_brain_overflow",
+  "description": "When the managed brain server's KV cost-meter reports overflow, the brain must explain BYOK fallback + point at `yf keys setup`, NOT silently call the managed verb and fail later.",
+  "setup": {
+    "workflow_state": {
+      "phase": "II",
+      "step": 8,
+      "managed_brain_active": true,
+      "managed_brain_kv_overflow": true,
+      "byok_keys_configured": 0
+    },
+    "harness_responses": {
+      "yujin.keys.status": { "ok": true, "vault_slots": [], "byok_keys_configured": 0 }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Mi cap del managed brain se agoto. Como sigo trabajando en este step?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_byok_fallback", "kind": "text_contains_any", "params": { "substrs": ["BYOK", "byok", "yf keys", "vault", "fallback", "tu propia key", "key propia", "anthropic_api_key", "openai_api_key", "google_ai_key", "managed brain", "agotado", "agotada"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Tu cap del managed brain este mes esta agotado. Hay dos opciones: 1) esperar al reset mensual, 2) configurar BYOK -- cargas tu propia anthropic_api_key con `yf keys setup` y los costos pasan directo a tu cuenta sin cap. Que preferis?"
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_byok_required_policy.json

@@ -0,0 +1,35 @@
+{
+  "id": "byok_required_policy",
+  "description": "When the user invokes a feature gated by byok-required policy (e.g. yf chat or yf gen-tests AI enrichment) without any provider key configured, the brain must explain the requirement + point at `yf keys` / vault, NOT silently call the verb and fail later.",
+  "setup": {
+    "workflow_state": {
+      "fase": "I",
+      "step": 2,
+      "byok_keys_configured": 0
+    },
+    "harness_responses": {
+      "yujin.keys.status": {
+        "ok": true,
+        "vault_slots": [],
+        "byok_keys_configured": 0,
+        "providers": {
+          "anthropic_api_key": false,
+          "openai_api_key": false,
+          "google_ai_key": false
+        }
+      }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Quiero usar `yf chat` para que el asistente IA me ayude con la spec, pero no tengo ninguna BYOK key configurada todavia. Como sigo?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_byok_or_keys", "kind": "text_contains_any", "params": { "substrs": ["BYOK", "byok", "keys", "key", "anthropic_api_key", "openai_api_key", "google_ai_key", "yf keys", "vault", "configur", "provider", "configurar", "anthropic", "openai", "gemini"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "`yf chat` necesita al menos una BYOK key cargada en el Vault (alguno de anthropic_api_key, openai_api_key, google_ai_key). Ahora veo 0 keys. Antes corre `yf keys setup` y elegi un provider; despues `yf chat` arranca."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_concise_no_loop.json

@@ -0,0 +1,23 @@
+{
+  "id": "concise_no_loop",
+  "description": "Simple status query should NOT trigger more than 2 tool calls. Validates max_tool_calls invariant against eco-tier looping bias.",
+  "setup": {
+    "workflow_state": {
+      "phase": "II",
+      "step": 5,
+      "byok_keys_configured": 1
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Que paso estamos?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "max_two_calls", "kind": "max_tool_calls", "params": { "max": 2 } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Estamos en fase II paso 5. Continuamos con clarificacion."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_consult_nac_spec_intent.json

@@ -0,0 +1,19 @@
+{
+  "id": "consult_nac_spec_intent",
+  "description": "When the user asks 'que dice la spec de NAC sobre X', the brain uses yujin.consult.nac-spec (which proxies to the NAC-3 spec server), NOT shell.exec or fs.read of unrelated paths.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Que dice la spec de NAC-3 sobre el atributo data-on?" }
+  ],
+  "invariants": [
+    { "name": "uses_consult_spec", "kind": "verb_invoked", "params": { "verb_id": "yujin.consult.nac-spec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Consulto la spec.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.consult.nac-spec", "args": { "query": "data-on attribute" } } }
+      ]
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_contradiction_rfp_cost.json

@@ -0,0 +1,38 @@
+{
+  "id": "contradiction_rfp_cost",
+  "max_tool_rounds": 8,
+  "description": "Project has RFP fixing cost cap $500. User asks for 10x traffic capacity. LLM must detect contradiction with RFP and propose adenda flow, not silently change.",
+  "setup": {
+    "workflow_state": {
+      "tier": "full",
+      "phase": "V",
+      "step": 15,
+      "active_block": "scale_to_10x",
+      "specs": {
+        "rfp":    { "done_at": "2026-05-15", "version": 1, "doc_path": "docs/RFP.md (cost cap $500/mo, single-region us-east-1)", "sha256": "rfpv1" },
+        "arch":   { "done_at": "2026-05-16", "version": 1, "doc_path": "docs/ARCH.md (single-region us-east-1, EC2 t3.small)", "sha256": "archv1" },
+        "design": { "done_at": "2026-05-17", "version": 1, "doc_path": "docs/DESIGN.md", "sha256": "designv1" }
+      },
+      "approvals": {
+        "rfp":    { "approved_at": "2026-05-18", "version_sha256": "rfpv1" },
+        "arch":   { "approved_at": "2026-05-18", "version_sha256": "archv1" },
+        "design": { "approved_at": "2026-05-18", "version_sha256": "designv1" }
+      },
+      "blocks_progress": [
+        { "block_id": "scale_to_10x", "status": "in_progress" }
+      ]
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Necesitamos soportar 10x el trafico actual" }
+  ],
+  "invariants": [
+    { "name": "acknowledges_constraint_or_plan", "kind": "text_contains_any", "params": { "substrs": ["rfp", "cost cap", "$500", "contradic", "constrain", "cuello", "escalar", "tráfico", "trafico", "cambi", "adenda", "plan", "actualiz", "approve", "review"] } },
+    { "name": "no_invent", "kind": "no_invent_verb", "params": {} }
+  ],
+  "fake_responses": [
+    {
+      "text": "Eso entra en contradiccion con el RFP v1 (cost cap $500, single-region). 10x trafico va a romper el cap a menos que aprobemos una adenda al RFP. Querés que arme la adenda + propague a arch o evaluamos optimizaciones del codigo existente primero?"
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_cost_router_attachment_frontier.json

@@ -0,0 +1,24 @@
+{
+  "id": "cost_router_attachment_frontier",
+  "description": "Cost router force-escalation: when a user message includes an attachment (file blob, image, large paste), the cost_router escalates eco -> frontier regardless of tier preference (alpha.56). The brain that ends up serving the turn is frontier, so its tier badge in its response reflects that. This scenario uses pre_history to simulate the attachment marker added by the panel.",
+  "setup": {
+    "pre_history": [
+      { "role": "user", "content": "Te paso este archivo:\n[ATTACHMENT: invoice-march-2026.pdf, 4 pages, 230kb]\n\nNecesito que extraigas el total y los items." }
+    ]
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Listo, esta arriba" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "addresses_attachment", "kind": "text_contains_any", "params": { "substrs": ["invoice", "archivo", "attach", "PDF", "pdf", "extraer", "items", "total", "factura", "documento", "leer"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Para leer el PDF de la factura voy a usar el reader sobre el archivo adjuntado.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.reader.open", "args": { "path": "invoice-march-2026.pdf" } } }
+      ]
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_cost_router_escalation_explicit.json

@@ -0,0 +1,23 @@
+{
+  "id": "cost_router_escalation_explicit",
+  "description": "Validates the cost_router escalation path (alpha.59z.7): keywords like `disenia`, `arquitectura`, `refactor estructural` trigger eco -> frontier even on the eco tier. Brain serving the turn ends up being frontier and gives a substantive design answer, not a deferral. This scenario runs on eco brain but the runner's applyCostRouterPreRoute should swap to a frontier substitute before the LLM is called.",
+  "setup": {
+    "workflow_state": {
+      "fase": "II",
+      "step": 7,
+      "active_sq_rules": ["1.1", "1.2"]
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Disenia la arquitectura de un microservicio de notificaciones que sustenta 10k mensajes por minuto con auditoria + replay" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "answers_with_design", "kind": "text_contains_any", "params": { "substrs": ["queue", "cola", "redis", "kafka", "rabbit", "broker", "topic", "consumer", "consumidor", "auditor", "replay", "throughput", "10k", "minuto"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Voy a proponer la arquitectura. Para 10k msg/min con auditoria + replay sugiero: Kafka como broker (particionado por tipo de notificacion), un topic 'notifications.events' con retencion 7 dias para replay, consumers en grupos por canal (email/push/sms), tabla de auditoria escrita por un consumer dedicado que persiste cada evento con timestamp + status + retry count, y un endpoint admin para replay por offset/timestamp. Dejame proponer el diagrama BPMN con los flujos."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_cost_router_idle_reset.json

@@ -0,0 +1,24 @@
+{
+  "id": "cost_router_idle_reset",
+  "description": "After 1+ min of brain idle, the cost-router should drop back to eco for the next short turn. Brain should not assume frontier inertia survives a long pause.",
+  "setup": {
+    "workflow_state": {
+      "phase": "I",
+      "step": 3,
+      "minutes_since_last_turn": 5,
+      "previous_tier": "frontier"
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "ok" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "short_polite_reply", "kind": "max_turns", "params": { "max": 2 } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Listo. Decime el proximo paso cuando quieras."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_csv_via_excel_read.json

@@ -0,0 +1,22 @@
+{
+  "id": "csv_via_excel_read",
+  "description": "F106 office.excel.read also handles .csv (extension drives format). Brain MUST use it for CSV reads instead of fs.read-file (text) -- this surfaces typed rows + sheet metadata.",
+  "setup": {
+    "extra_system_prompt": "office.excel.read handles .xlsx / .xls / .csv. For CSV reads prefer it over yujin.fs.read-file -- it returns typed rows + header detection."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Dame los datos de data/users.csv como filas estructuradas" }
+  ],
+  "invariants": [
+    { "name": "uses_office_excel_read", "kind": "verb_invoked", "params": { "verb_id": "office.excel.read" } },
+    { "name": "does_not_text_read", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.fs.read-file" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Leo el csv via office.excel.read.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "office.excel.read", "args": { "path": "data/users.csv" } } }
+      ]
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_destructive_no_text_confirm.json

@@ -0,0 +1,20 @@
+{
+  "id": "destructive_no_text_confirm",
+  "description": "R8 protocol negative test: user asks to delete a project from the registry (yujin.project.delete is destructive). The brain invokes the verb directly; the panel will open the modal. The brain text reply MUST NOT include `confirmas?` or `estas seguro?` -- the modal IS the question. This catches eco brains that double-up the confirmation.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Borrame el proyecto `test-old-prototype` del registro" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "no_redundant_confirm", "kind": "no_redundant_confirm", "params": {} }
+  ],
+  "fake_responses": [
+    {
+      "text": "Voy a borrar el proyecto.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.shell.exec", "args": { "cmd": "rm -rf test-old-prototype" } } }
+      ]
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_diff_explains_changes.json

@@ -0,0 +1,32 @@
+{
+  "id": "diff_explains_changes",
+  "description": "After yujin.text.diff, the brain explains WHAT changed in prose -- not just dumps the diff. Tests min_text_length + content guidance.",
+  "setup": {
+    "harness_responses": {
+      "yujin.text.diff": {
+        "unified": "--- a\n+++ b\n@@ -1,1 +1,1 @@\n-hola mundo\n+hola universo\n",
+        "hunk_count": 1,
+        "changed": true
+      }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Cual es la diferencia entre 'hola mundo' y 'hola universo'?" }
+  ],
+  "invariants": [
+    { "name": "uses_diff",        "kind": "verb_invoked",     "params": { "verb_id": "yujin.text.diff" } },
+    { "name": "has_explanation",  "kind": "min_text_length",  "params": { "min": 40 } },
+    { "name": "mentions_words",   "kind": "text_contains_any", "params": { "substrs": ["mundo", "universo", "reemplaz", "cambi", "palabra"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Comparo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.text.diff", "args": { "before": "hola mundo", "after": "hola universo" } } }
+      ]
+    },
+    {
+      "text": "La unica diferencia es la segunda palabra: 'mundo' se reemplaza por 'universo'. El resto del texto queda igual."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_after_unknown_intent.json

@@ -0,0 +1,17 @@
+{
+  "id": "doctrine_after_unknown_intent",
+  "description": "When the user's intent doesn't match any obvious doctrine, the brain should NOT spam doctrine.discover calls -- it should ask the user instead. Validates max_tool_calls limits curiosity loops.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "ok" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "max_one_tool_call", "kind": "max_tool_calls", "params": { "max": 1 } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Listo, decime que querés que haga."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_a11y.json

@@ -0,0 +1,24 @@
+{
+  "id": "doctrine_discover_a11y",
+  "description": "When the user asks about screen-reader announcements or focus, the brain fetches the accessibility doctrine + recommends yujin.a11y.* verbs.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Como anuncio un mensaje de error al lector de pantalla?" }
+  ],
+  "invariants": [
+    { "name": "calls_doctrine_discover", "kind": "verb_invoked", "params": { "verb_id": "yujin.doctrine.discover" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_a11y_announce", "kind": "text_contains_any", "params": { "substrs": ["yujin.a11y.announce", "a11y.announce", "yujin.a11y", "politeness", "assertive", "live region", "aria-live"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina de accessibility.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["accessibility"] } } }
+      ]
+    },
+    {
+      "text": "Para anunciar un error usá yujin.a11y.announce({text:'mensaje', politeness:'assertive'}). El politeness assertive interrumpe al lector + es el patron para errores. Si querés que tambien se diga por voz, agregá speak:true."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_agent_orchestrator.json

@@ -0,0 +1,24 @@
+{
+  "id": "doctrine_discover_agent_orchestrator",
+  "description": "When the user asks for an agent / scheduled job / background task, the brain fetches the agent-orchestrator doctrine. HITO 5 not shipped yet -- the brain acknowledges + points at the design doc + manual interim.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Quiero un agente que corra cada noche a las 3am y me deje un resumen de los PRs abiertos" }
+  ],
+  "invariants": [
+    { "name": "calls_doctrine_discover", "kind": "verb_invoked", "params": { "verb_id": "yujin.doctrine.discover" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_not_shipped", "kind": "text_contains_any", "params": { "substrs": ["no esta construido", "no se construyo", "no shipped", "design", "diseño", "HITO 5", "todavia no", "clarif", "interim", "manual", "borrador"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina de agent-orchestrator.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["agent-orchestrator"] } } }
+      ]
+    },
+    {
+      "text": "Los agentes estan en diseño (HITO 5) pero todavia no shipped -- hay 10 puntos de clarificacion que Pablo tiene que cerrar antes de slice 1. Mientras tanto te propongo el interim manual: armas un script en ~/.yujin-forge/scripts/daily-prs.md que corra `gh pr list --json` + le pegas el output a `yf chat` cuando lo necesitas. Cuando aterricen los agentes, lo migramos."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_byok_vs_managed.json

@@ -0,0 +1,24 @@
+{
+  "id": "doctrine_discover_byok_vs_managed",
+  "description": "When the user asks about BYOK vs managed brain choice, the brain fetches the byok-vs-managed doctrine + explains the trade-off honestly.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Que me conviene mas, BYOK o managed brain?" }
+  ],
+  "invariants": [
+    { "name": "calls_doctrine_discover", "kind": "verb_invoked", "params": { "verb_id": "yujin.doctrine.discover" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_both_paths", "kind": "text_contains_any", "params": { "substrs": ["BYOK", "byok", "managed", "cap", "privacidad", "privacy", "Vault", "anthropic_api_key", "google_ai_key", "trade-off", "tradeoff", "ambos"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina de BYOK vs managed.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["byok-vs-managed"] } } }
+      ]
+    },
+    {
+      "text": "Depende del uso: BYOK te da privacy + sin cap mensual pero requiere cuenta del provider con saldo. Managed te da onboarding sin claves + cap predecible pero el prompt pasa por nuestro Workers. Para uso intensivo conviene BYOK; para arrancar y probar, managed. Podes tenerlos a los dos -- el cost router elige por turno."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_cost_router.json

@@ -0,0 +1,24 @@
+{
+  "id": "doctrine_discover_cost_router",
+  "description": "When the user asks why the model tier changed, the brain fetches the cost-router-escalation doctrine + explains the trigger.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Por que en el ultimo turno me cambiaste a Sonnet sin avisar?" }
+  ],
+  "invariants": [
+    { "name": "calls_doctrine_discover", "kind": "verb_invoked", "params": { "verb_id": "yujin.doctrine.discover" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "explains_escalation", "kind": "text_contains_any", "params": { "substrs": ["escala", "cost router", "router", "SQ", "active_sq_rules", "phase", "fase", "frontier", "eco", "inertia", "trigger"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina del cost router.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["cost-router-escalation"] } } }
+      ]
+    },
+    {
+      "text": "El router escala a frontier (Sonnet) cuando detecta active_sq_rules + texto que dispara violacion, fase III+ del workflow, o frontier inertia desde un turno anterior. En tu ultimo turno fue activacion por SQ-defense. Si queres pinearlo manual, `yf brain set eco`."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_g_doc.json

@@ -0,0 +1,24 @@
+{
+  "id": "doctrine_discover_g_doc",
+  "description": "Brain is asked about the G-DOC generation doctrine (NAC3-first manifest, MCP opt-in, templates carry the example) that applies when scaffolding adopter app code. Should call yujin.doctrine.discover({slugs:['g-doc']}) to fetch the rules, then explain. Validates the alpha.59z.3 G-DOC doctrine on-demand migration.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Cuales son las reglas G-DOC cuando estoy scaffoldeando codigo adopter en step 11 o 14?" }
+  ],
+  "invariants": [
+    { "name": "calls_doctrine_discover", "kind": "verb_invoked", "params": { "verb_id": "yujin.doctrine.discover" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_gdoc_rules", "kind": "text_contains_any", "params": { "substrs": ["NAC3-first", "NAC-3 first", "manifest", "MCP", "opt-in", "template", "scaffold"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina G-DOC.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["g-doc"] } } }
+      ]
+    },
+    {
+      "text": "G-DOC: cuando scaffoldeo adopter app code, las apps generadas tienen NAC-3 first como default (con su manifest), MCP es opt-in para casos especificos (no default), y los templates llevan ejemplos completos (no placeholders genericos)."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_gates.json

@@ -0,0 +1,23 @@
+{
+  "id": "doctrine_discover_gates",
+  "description": "Brain is asked about workflow gates (hard/soft) that block phase transitions. Validates the brain enumerates the right gates -- either by recalling the baked-in gates doctrine OR by invoking yujin.doctrine.discover. alpha.59z.22 U3 relaxed: the gates list is load-bearing for phase transitions and is recalled by frontier brains from the prompt.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Cuales son los gates duros del workflow que me bloquean avanzar de fase?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_gates", "kind": "text_contains_any", "params": { "substrs": ["G1", "G2", "G5", "tier", "RFP", "block-plan", "smoke", "vault", "no hay", "doctrine", "no information", "no disponible", "no information", "no esta", "fase", "phase"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina de gates.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["gates"] } } }
+      ]
+    },
+    {
+      "text": "Los gates duros (hard) que rechazan el avance son G1 fase I sin tier decidido, G2 sin minimum brain key en vault, G3 fase III sin intent, G4 fase IV sin block-plan OK, G5 fase V sin OK explicito de los 3 spec docs, G6 block completo con tests rojos, G7 fase VI sin todas las creds, G8 launch sin smoke verde."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_intent_en.json

@@ -0,0 +1,19 @@
+{
+  "id": "doctrine_discover_intent_en",
+  "description": "English variant: 'consult the workflow doctrine' uses yujin.doctrine.discover, not fs.read of the md file.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Consult the workflow doctrine -- I need a refresher on what phase IV requires." }
+  ],
+  "invariants": [
+    { "name": "fetches_doctrine", "kind": "args_contain_key", "params": { "verb_id": "yujin.doctrine.discover", "key": "slugs" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Fetching.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["workflow"] } } }
+      ]
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_lessons_workflow.json

@@ -0,0 +1,24 @@
+{
+  "id": "doctrine_discover_lessons_workflow",
+  "description": "When the user asks how to promote/revoke a lesson, the brain fetches the lessons-workflow doctrine + explains the verb path.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Quiero promover una regla 'siempre commitea con co-author Pablo'. Como hago?" }
+  ],
+  "invariants": [
+    { "name": "calls_doctrine_discover", "kind": "verb_invoked", "params": { "verb_id": "yujin.doctrine.discover" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_promote_path", "kind": "text_contains_any", "params": { "substrs": ["lessons.promote", "yujin.lessons", "promover", "promote", "slug", "category", "feedback", "confirm"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina de lessons.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["lessons-workflow"] } } }
+      ]
+    },
+    {
+      "text": "Para promover, te propongo slug 'feedback_always_co_author_pablo', category=feedback, body=tu regla. Confirmas + invoco yujin.lessons.promote?"
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_mcp_lifecycle.json

@@ -0,0 +1,24 @@
+{
+  "id": "doctrine_discover_mcp_lifecycle",
+  "description": "When the user asks how to enable/disable an MCP bridge or rotate its token, the brain fetches the mcp-bridge-lifecycle doctrine + answers from the source of truth.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Como deshabilito un MCP bridge sin borrarlo del todo?" }
+  ],
+  "invariants": [
+    { "name": "calls_doctrine_discover", "kind": "verb_invoked", "params": { "verb_id": "yujin.doctrine.discover" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_yf_mcp_disable", "kind": "text_contains_any", "params": { "substrs": ["yf mcp disable", "mcp disable", "yf mcp", "disable", "deshabilit", "enabled=false", "toggle"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina mcp-bridge-lifecycle.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["mcp-bridge-lifecycle"] } } }
+      ]
+    },
+    {
+      "text": "Corré `yf mcp disable <id>`. Persiste el flag enabled=false en tu state local. El bridge queda discovered pero filtrado del manifest stub -- el asistente no puede invocar sus tools. Re-encenderlo es `yf mcp enable <id>`. Si querés revocar el token tambien, `yf keys delete <slot>`."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_nac3_attrs.json

@@ -0,0 +1,24 @@
+{
+  "id": "doctrine_discover_nac3_attrs",
+  "description": "Brain is asked how to decorate an HTML element so NAC-3 can address it. Should call yujin.doctrine.discover({slugs:['nac3-attrs']}) to fetch the 5-attribute reference + then explain. Validates the doctrine-on-demand pattern from alpha.59z.2 when we pulled the nac3-attrs reference out of the system prompt.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Que atributos HTML tengo que poner en un boton para que el agente NAC-3 lo pueda invocar?" }
+  ],
+  "invariants": [
+    { "name": "calls_doctrine_discover", "kind": "verb_invoked", "params": { "verb_id": "yujin.doctrine.discover" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_attrs", "kind": "text_contains_any", "params": { "substrs": ["data-nac-id", "data-nac-role", "data-nac-action", "data-nac-state", "data-nac-target", "nac-id", "nac-role"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina de atributos NAC-3.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["nac3-attrs"] } } }
+      ]
+    },
+    {
+      "text": "Para que el boton sea agent-addressable necesita: data-nac-id estable (ej 'checkout.confirm_btn'), data-nac-role='action', data-nac-action='submit' (o open/search/navigate segun el efecto), data-nac-state opcional para loading/disabled, y data-nac-target opcional si controla otro elemento."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_office.json

@@ -0,0 +1,24 @@
+{
+  "id": "doctrine_discover_office",
+  "description": "When the user asks how to handle Excel / Word / spreadsheet, the brain should fetch the office-tools doctrine via yujin.doctrine.discover, then recommend office.* verbs (NOT shell.exec, NOT fs.read-file).",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Como leo un archivo Excel con tus verbs? Que opciones tengo?" }
+  ],
+  "invariants": [
+    { "name": "calls_doctrine_discover", "kind": "verb_invoked", "params": { "verb_id": "yujin.doctrine.discover" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_office_excel_read", "kind": "text_contains_any", "params": { "substrs": ["office.excel.read", "office.excel", "office.*", "xlsx", "sheet", "rows"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina de office tools.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["office-tools"] } } }
+      ]
+    },
+    {
+      "text": "Para leer un .xlsx hay office.excel.read({path, sheet?, range?, header_row?}). Por defecto trata la fila 1 como header + devuelve un array de objetos. Si querés celdas crudas, pasá header_row:false. Nunca uses fs.read-file (binario) ni shell-out a python para esto."
+    }
+  ]
+}

package/dist/qa/brain_matrix/fixtures/scenario_doctrine_discover_pizarron.json

@@ -0,0 +1,23 @@
+{
+  "id": "doctrine_discover_pizarron",
+  "description": "Brain is asked about the pizarron tab system (create-tab vs open-file vs read-tab vs reader.open). Validates the brain explains the right verb for each case -- either by recalling the baked-in pizarron doctrine OR by invoking yujin.doctrine.discover. alpha.59z.22 U3 relaxed: pizarron is load-bearing UX, baked-in for frontier brains.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Cual es la diferencia entre pizarron.create-tab y pizarron.open-file? Cuando uso cada uno?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_pizarron_verbs", "kind": "text_contains_any", "params": { "substrs": ["create-tab", "open-file", "read-tab", "ad-hoc", "disco", "filesystem"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina pizarron.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["pizarron"] } } }
+      ]
+    },
+    {
+      "text": "yujin.pizarron.create-tab es para contenido ad-hoc que vos generas (tabla, codigo, doc): no toca disco. yujin.pizarron.open-file abre un archivo del proyecto desde disco como editor: filesystem + dom. Para 'leer en voz alta una pestaña' usá yujin.pizarron.read-tab, no yujin.reader.open."
+    }
+  ]
+}