@nac3/forge-cli 0.2.0-alpha.9 → 1.0.0

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_default_design_system_override_shadcn.json

@@ -0,0 +1,45 @@
+{
+  "id": "default_design_system_override_shadcn",
+  "description": "User explicitly requests a non-Yujin DS. Validates Director invokes override (approval_required).",
+  "setup": {},
+  "turns": [
+    {
+      "kind": "user_says",
+      "text": "Para este proyecto usa shadcn/ui en lugar de Yujin DS."
+    }
+  ],
+  "invariants": [
+    {
+      "name": "no_invent_verbs",
+      "kind": "no_invent_verb",
+      "params": {}
+    },
+    {
+      "name": "invokes_override",
+      "kind": "verb_invoked",
+      "params": {
+        "verb_id": "yujin.design.override"
+      }
+    }
+  ],
+  "fake_responses": [
+    {
+      "text": "Voy a abrir el modal de override (R8). Confirma en el modal.",
+      "tool_calls": [
+        {
+          "name": "nac3_invoke",
+          "args": {
+            "verb_id": "yujin.design.override",
+            "args": {
+              "system_id": "shadcn",
+              "reason": "user explicit request"
+            }
+          }
+        }
+      ]
+    },
+    {
+      "text": "[NAC3 modal] APPROVED. Override persistido. A partir de ahora uso shadcn."
+    }
+  ]
+}

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

@@ -0,0 +1,44 @@
+{
+  "id": "default_design_system_use_card_template",
+  "description": "User asks for a component. Validates Coder fetches the Yujin template instead of inventing CSS.",
+  "setup": {},
+  "turns": [
+    {
+      "kind": "user_says",
+      "text": "Necesito una card para mostrar productos."
+    }
+  ],
+  "invariants": [
+    {
+      "name": "no_invent_verbs",
+      "kind": "no_invent_verb",
+      "params": {}
+    },
+    {
+      "name": "uses_yujin_template",
+      "kind": "verb_invoked",
+      "params": {
+        "verb_id": "yujin.design.get-template"
+      }
+    }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo el template Yujin de card.",
+      "tool_calls": [
+        {
+          "name": "nac3_invoke",
+          "args": {
+            "verb_id": "yujin.design.get-template",
+            "args": {
+              "slug": "card"
+            }
+          }
+        }
+      ]
+    },
+    {
+      "text": "Listo, aca esta el template de yj-card con tokens del Design System."
+    }
+  ]
+}

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_director_delegates_to_analyst.json

@@ -0,0 +1,26 @@
+{
+  "id": "director_delegates_to_analyst",
+  "description": "Director live execution -- Director receives a spec and decides to dispatch the Analyst sub-agent via yujin.agent.delegate, NOT a direct nac3 read/write. Validates that the iterative_step + brain understand inter-agent delegation as a first-class verb.",
+  "setup": {
+    "extra_system_prompt": "DIRECTOR ROLE active. You are the orchestrator. Delegate spec extraction to the Analyst sub-agent via yujin.agent.delegate {to_slug: 'analyst', payload, tokens_used}. Do NOT call reader/pizarron verbs directly -- those are Analyst's job.\n\nAvailable verbs:\n- yujin.agent.delegate [u s] args:{to_slug<required>, payload<required>, tokens_used?}"
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Extrae los requisitos del spec docA. Pasalo al equipo." }
+  ],
+  "invariants": [
+    { "name": "delegates_to_analyst", "kind": "verb_invoked", "params": { "verb_id": "yujin.agent.delegate" } },
+    { "name": "no_direct_reader", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.reader.read-section" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} }
+  ],
+  "fake_responses": [
+    {
+      "text": "Delego a Analyst.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.agent.delegate", "args": { "to_slug": "analyst", "payload": "extract spec docA requirements", "tokens_used": 25 } } }
+      ]
+    },
+    {
+      "text": "Analyst returned the plan. Listo."
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "director_no_self_delegation",
+  "description": "Director live execution -- delegations are LATERAL: dispatch to another role's slug (analyst / coder / tester / scaffolder), never to_slug='director'. The bridge ACL would reject a self-loop. Validates the brain answers without invoking yujin.agent.delegate at all when the user's request is something the director itself can handle.",
+  "setup": {
+    "extra_system_prompt": "DIRECTOR ROLE active. Delegations are LATERAL -- you call analyst / coder / tester / scaffolder. NEVER call to_slug='director' (self-loop -- the bridge ACL rejects it). When a task is reasoning-only (no spec extraction, no code generation, no fs writes), handle it yourself without delegating.\n\nVerbs:\n- yujin.agent.delegate [u s] args:{to_slug<required>, payload<required>}"
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Hazme un breakdown de los siguientes 3 pasos en texto, sin tools." }
+  ],
+  "invariants": [
+    { "name": "no_delegate_for_text_only", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.agent.delegate" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "answers_with_steps", "kind": "text_contains_any", "params": { "substrs": ["1", "primero", "step 1", "paso 1", "1)", "1.", "2.", "2)"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Breakdown directo, sin delegar: 1) Parsear spec. 2) Listar entidades. 3) Priorizar slices."
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "director_terminal_done_marker",
+  "description": "Director live execution -- when the orchestrator finishes a multi-step plan and there is nothing left, the assistant emits a clear terminal marker ('[DONE]' / 'listo' / 'terminado') so the iterative_step's done detector concludes the run. Validates the terminal-marker pathway.",
+  "setup": {
+    "extra_system_prompt": "DIRECTOR ROLE active. When all sub-agents have returned + the plan is closed, emit a clear terminal marker. Acceptable forms: '[DONE]', 'listo.', 'terminado.', 'todo listo.' -- in any locale you have already adopted. Do NOT keep delegating once the goal is met."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Confirma que el sprint X ya esta cerrado." }
+  ],
+  "invariants": [
+    { "name": "emits_terminal", "kind": "regex_match", "params": { "pattern": "(\\[DONE\\]|\\blisto\\b|\\bterminado\\b|todo listo)" } },
+    { "name": "no_extra_delegates", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.agent.delegate" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Sprint X cerrado. Todos los sub-agentes devolvieron OK. [DONE]"
+    }
+  ]
+}

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_default_design_system.json

@@ -0,0 +1,50 @@
+{
+  "id": "doctrine_discover_default_design_system",
+  "description": "Brain is asked about the default design system doctrine. Validates discovery or direct answer.",
+  "setup": {},
+  "turns": [
+    {
+      "kind": "user_says",
+      "text": "Cual es el design system por default de Forge?"
+    }
+  ],
+  "invariants": [
+    {
+      "name": "no_invent_verbs",
+      "kind": "no_invent_verb",
+      "params": {}
+    },
+    {
+      "name": "mentions_yujin_ds",
+      "kind": "text_contains_any",
+      "params": {
+        "substrs": [
+          "Yujin Design System",
+          "Yujin DS",
+          "yujin.design"
+        ]
+      }
+    }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina de design system.",
+      "tool_calls": [
+        {
+          "name": "nac3_invoke",
+          "args": {
+            "verb_id": "yujin.doctrine.discover",
+            "args": {
+              "slugs": [
+                "default-design-system"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    {
+      "text": "El default es Yujin Design System (30 componentes, 258 tokens DTCG, 170 sumi-e). Override via yujin.design.override (R8 modal)."
+    }
+  ]
+}

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_language_sovereignty.json

@@ -0,0 +1,53 @@
+{
+  "id": "doctrine_discover_language_sovereignty",
+  "description": "Brain is asked about language choice doctrine. Validates discovery via yujin.doctrine.discover OR direct in-prompt answer using the language-sovereignty rule.",
+  "setup": {},
+  "turns": [
+    {
+      "kind": "user_says",
+      "text": "Que dice la doctrina sobre eleccion de lenguaje de programacion?"
+    }
+  ],
+  "invariants": [
+    {
+      "name": "no_invent_verbs",
+      "kind": "no_invent_verb",
+      "params": {}
+    },
+    {
+      "name": "mentions_sovereignty",
+      "kind": "text_contains_any",
+      "params": {
+        "substrs": [
+          "user",
+          "usuario",
+          "pick",
+          "elige",
+          "language",
+          "sovereignty"
+        ]
+      }
+    }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo la doctrina de language sovereignty.",
+      "tool_calls": [
+        {
+          "name": "nac3_invoke",
+          "args": {
+            "verb_id": "yujin.doctrine.discover",
+            "args": {
+              "slugs": [
+                "language-sovereignty"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    {
+      "text": "Per docs/doctrine/language-sovereignty.md: el user picks the language; el Director suggests but never imposes. Si el lenguaje no es conducente para el componente, Director responde con la tabla."
+    }
+  ]
+}

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."
+    }
+  ]
+}