@nac3/forge-cli 0.2.0-alpha.9 → 0.2.1-alpha.60

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

@@ -0,0 +1,28 @@
+{
+  "id": "iterations_tracker_acknowledge",
+  "description": "Workflow iterations field (alpha.59y.4): when workflow_state.iterations_count > 0, the brain must acknowledge the prior iteration history when the user asks about progress. Catches the failure where the brain starts fresh + ignores the iteration counter.",
+  "setup": {
+    "workflow_state": {
+      "fase": "II",
+      "step": 9,
+      "iterations_count": 3,
+      "iterations": [
+        { "n": 1, "summary": "Primera ronda de spec -- arquitectura monolitica" },
+        { "n": 2, "summary": "Segunda ronda -- separamos en 2 servicios + cola" },
+        { "n": 3, "summary": "Tercera ronda -- adendamos auditoria + replay" }
+      ]
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Que llevamos en este proyecto hasta ahora?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_iterations", "kind": "text_contains_any", "params": { "substrs": ["iteracion", "iteración", "ronda", "3", "tercera", "tres", "evolucion", "evolución", "historia", "previo", "anterior", "auditor", "replay"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Llevamos 3 iteraciones del spec: primera ronda fue arquitectura monolitica, segunda separo en 2 servicios + cola, y tercera (la actual) agrego auditoria + replay. Estamos en fase II paso 9, cerrando el bloque de clarificacion antes de pasar a aprobacion."
+    }
+  ]
+}

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

@@ -0,0 +1,34 @@
+{
+  "id": "json_parse_handles_malformed",
+  "description": "When yujin.json.parse returns {ok:false, error}, the brain reports it cleanly + suggests inspecting the source, doesn't pretend the value parsed.",
+  "setup": {
+    "harness_responses": {
+      "yujin.fs.read":    { "ok": true, "path": "broken.json", "content": "{ not valid json }" },
+      "yujin.json.parse": { "ok": false, "error": "Unexpected token n in JSON at position 2" }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Leeme broken.json y parsealo." }
+  ],
+  "invariants": [
+    { "name": "uses_json_parse",  "kind": "verb_invoked",     "params": { "verb_id": "yujin.json.parse" } },
+    { "name": "explains_failure", "kind": "text_contains_any", "params": { "substrs": ["no es JSON", "malformed", "invalid JSON", "no parsea", "JSON invalido", "Unexpected token", "syntaxis"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Leyendo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.read", "args": { "path": "broken.json" } } }
+      ]
+    },
+    {
+      "text": "Intento parsear.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.json.parse", "args": { "text": "{ not valid json }" } } }
+      ]
+    },
+    {
+      "text": "broken.json no es JSON valido -- el parser tira 'Unexpected token n at position 2', osea no encontro una clave entre comillas donde la esperaba. El archivo arranca con '{ not valid json }' que es texto suelto. Querés que lo abra para que vea cual es la intencion?"
+    }
+  ]
+}

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

@@ -0,0 +1,30 @@
+{
+  "id": "json_parse_intent",
+  "description": "When a previous tool_result returned a JSON text and the brain needs to inspect a field, it uses yujin.json.parse first (then yujin.json.query). It does NOT regex-extract from the text nor call shell.exec with jq.",
+  "setup": {
+    "harness_responses": {
+      "yujin.fs.read": { "ok": true, "path": "config.json", "content": "{\"name\":\"yujin\",\"version\":\"0.2.0\",\"enabled\":true}" }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Decime el name del config.json. Usa fs.read y despues json.parse." }
+  ],
+  "invariants": [
+    { "name": "uses_json_parse", "kind": "verb_invoked", "params": { "verb_id": "yujin.json.parse" } },
+    { "name": "no_shell",        "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Leo + parseo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.read", "args": { "path": "config.json" } } }
+      ]
+    },
+    {
+      "text": "Ahora lo parseo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.json.parse", "args": { "text": "{\"name\":\"yujin\",\"version\":\"0.2.0\",\"enabled\":true}" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,30 @@
+{
+  "id": "json_parse_intent_en",
+  "description": "English variant of the read-then-parse JSON flow.",
+  "setup": {
+    "harness_responses": {
+      "yujin.fs.read": { "ok": true, "path": "config.json", "content": "{\"name\":\"yujin\",\"version\":\"0.2.0\"}" }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Read config.json and tell me the 'name' field. Use fs.read then json.parse." }
+  ],
+  "invariants": [
+    { "name": "uses_json_parse", "kind": "verb_invoked",     "params": { "verb_id": "yujin.json.parse" } },
+    { "name": "no_shell",        "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Reading.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.read", "args": { "path": "config.json" } } }
+      ]
+    },
+    {
+      "text": "Parsing.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.json.parse", "args": { "text": "{\"name\":\"yujin\",\"version\":\"0.2.0\"}" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,23 @@
+{
+  "id": "json_query_extract",
+  "description": "When the user wants to pull a single field from a JSON value, the brain MUST use yujin.json.query, NOT yujin.shell.exec with `jq`.",
+  "setup": {
+    "extra_system_prompt": "yujin.json.query is a jq-lite for extracting fields from JSON values. Use it instead of shell-out to jq -- safer + no dependency."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "De este blob {\"user\":{\"name\":\"Ana\",\"age\":30}}, dame solo el nombre" }
+  ],
+  "invariants": [
+    { "name": "uses_json_query", "kind": "verb_invoked", "params": { "verb_id": "yujin.json.query" } },
+    { "name": "no_shell", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } },
+    { "name": "args_have_query", "kind": "args_contain_key", "params": { "verb_id": "yujin.json.query", "key": "query" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Extraigo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.json.query", "args": { "input": { "user": { "name": "Ana", "age": 30 } }, "query": ".user.name" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "json_stringify_intent",
+  "description": "When the user wants to dump a value as JSON text (e.g. for an HTTP body), the brain uses yujin.json.stringify, NOT a hand-rolled template.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Convertime este objeto en JSON pretty: {a:1, b:[2,3]}." }
+  ],
+  "invariants": [
+    { "name": "uses_stringify", "kind": "verb_invoked", "params": { "verb_id": "yujin.json.stringify" } },
+    { "name": "no_shell",       "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Lo serializo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.json.stringify", "args": { "value": { "a": 1, "b": [2, 3] } } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "json_stringify_intent_en",
+  "description": "English variant: 'serialize this object as pretty JSON' uses yujin.json.stringify.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Serialize this object as pretty JSON: {a:1, b:[2,3]}." }
+  ],
+  "invariants": [
+    { "name": "uses_stringify", "kind": "verb_invoked", "params": { "verb_id": "yujin.json.stringify" } },
+    { "name": "no_shell",       "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Serializing.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.json.stringify", "args": { "value": { "a": 1, "b": [2, 3] } } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "keys_set_intent",
+  "description": "When the user wants to configure a BYOK key, the brain uses yujin.keys.set (which routes through the Vault), NOT shell.exec or yujin.fs.write to drop the key plainly anywhere.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Quiero configurar mi api key de openai." }
+  ],
+  "invariants": [
+    { "name": "uses_keys_set", "kind": "verb_invoked", "params": { "verb_id": "yujin.keys.set" } },
+    { "name": "no_shell",      "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Te abro el flow de seteo de key (la persistimos cifrada en el Vault, nunca en plaintext).",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.keys.set", "args": { "slot": "openai" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "keys_status_intent",
+  "description": "When the user asks 'tengo seteada mi key de anthropic?', the brain uses yujin.keys.status (which checks the Vault without exposing the key), NOT yujin.env.list (filtered) nor yujin.shell.exec.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Tengo configurada la api key de anthropic en el vault?" }
+  ],
+  "invariants": [
+    { "name": "uses_keys_status", "kind": "verb_invoked",     "params": { "verb_id": "yujin.keys.status" } },
+    { "name": "no_shell",         "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Chequeo el vault.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.keys.status", "args": { "slot": "anthropic" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "keys_status_intent_en",
+  "description": "English variant: 'is my anthropic key set up?' uses yujin.keys.status (vault check), NOT env.list (filtered) nor shell.exec.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Do I have an Anthropic API key configured in the vault?" }
+  ],
+  "invariants": [
+    { "name": "uses_keys_status", "kind": "verb_invoked",     "params": { "verb_id": "yujin.keys.status" } },
+    { "name": "no_shell",         "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Checking the vault.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.keys.status", "args": { "slot": "anthropic" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,61 @@
+{
+  "id": "language_sovereignty_not_conducive_spa_python",
+  "description": "User requests Python for SPA frontend. Validates Director responds with the table row + DOES NOT switch.",
+  "setup": {},
+  "turns": [
+    {
+      "kind": "user_says",
+      "text": "Quiero el frontend SPA en Python."
+    }
+  ],
+  "invariants": [
+    {
+      "name": "no_invent_verbs",
+      "kind": "no_invent_verb",
+      "params": {}
+    },
+    {
+      "name": "explains_not_conducive",
+      "kind": "text_contains_any",
+      "params": {
+        "substrs": [
+          "no es conducente",
+          "not conducive",
+          "browser",
+          "navegador",
+          "runtime",
+          "TS",
+          "JS"
+        ]
+      }
+    },
+    {
+      "name": "no_silent_switch",
+      "kind": "verb_not_invoked",
+      "params": {
+        "verb_id": "yujin.workflow.set"
+      }
+    }
+  ],
+  "fake_responses": [
+    {
+      "text": "Voy a consultar la doctrina antes de responder.",
+      "tool_calls": [
+        {
+          "name": "nac3_invoke",
+          "args": {
+            "verb_id": "yujin.doctrine.discover",
+            "args": {
+              "slugs": [
+                "language-sovereignty"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    {
+      "text": "Python no es conducente para un SPA frontend porque no es runtime del navegador. Las opciones validas son: TS, JS, WASM target (Rust, Go). Cual preferis?"
+    }
+  ]
+}

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

@@ -0,0 +1,48 @@
+{
+  "id": "language_sovereignty_user_picks_python",
+  "description": "User declares a language preference. Validates Director switches via yujin.workflow.set.",
+  "setup": {},
+  "turns": [
+    {
+      "kind": "user_says",
+      "text": "Quiero el backend en Python con FastAPI."
+    }
+  ],
+  "invariants": [
+    {
+      "name": "no_invent_verbs",
+      "kind": "no_invent_verb",
+      "params": {}
+    },
+    {
+      "name": "persists_choice",
+      "kind": "verb_invoked",
+      "params": {
+        "verb_id": "yujin.workflow.set"
+      }
+    }
+  ],
+  "fake_responses": [
+    {
+      "text": "Listo, backend en Python. Persisto la decision.",
+      "tool_calls": [
+        {
+          "name": "nac3_invoke",
+          "args": {
+            "verb_id": "yujin.workflow.set",
+            "args": {
+              "path": "language_choices.backend",
+              "value": {
+                "lang": "python",
+                "decided_by": "user"
+              }
+            }
+          }
+        }
+      ]
+    },
+    {
+      "text": "Backend en Python guardado."
+    }
+  ]
+}

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

@@ -0,0 +1,27 @@
+{
+  "id": "lazy_complex_verb",
+  "description": "Complex verb with enums + length caps (yujin.pizarron.create-tab) -- LLM should call discover-schemas before invoking.",
+  "setup": { "manifest_mode": "lazy" },
+  "turns": [
+    { "kind": "user_says", "text": "mostrame una tabla en el pizarron con 3 filas de prueba" }
+  ],
+  "invariants": [
+    { "name": "invokes_create_tab", "kind": "verb_invoked", "params": { "verb_id": "yujin.pizarron.create-tab" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} }
+  ],
+  "_NOTE": "alpha.59z (recalibration): real brains compose create-tab args correctly from the stub args_hint alone without needing discover-schemas. discover_schemas_before_invoke was over-strict for production behavior. Verb invocation is the meaningful signal.",
+  "fake_responses": [
+    {
+      "text": "Antes de armar la tabla, traigo el schema del verbo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.nac3.discover-schemas", "args": { "verb_ids": ["yujin.pizarron.create-tab"] } } }
+      ]
+    },
+    {
+      "text": "Listo, te abro la tabla.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.pizarron.create-tab", "args": { "title": "Prueba", "kind": "table", "content": "col1|col2\\nA|B\\nC|D\\nE|F" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,17 @@
+{
+  "id": "lazy_doctrine_only_when_needed",
+  "description": "Validates the lazy-doctrine pattern: yf-commands catalogue was removed from the prompt in alpha.59z.1; the brain must invoke yujin.doctrine.discover({slugs:['yf-commands']}) ONLY when the user asks about a specific CLI command. Simple greeting must NOT trigger the discover call (token waste).",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Hola, todo bien?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "does_not_call_discover", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.doctrine.discover" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Hola, todo bien. Estoy listo, en que ayudo?"
+    }
+  ]
+}

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

@@ -0,0 +1,21 @@
+{
+  "id": "lazy_simple_verb",
+  "description": "Simple verb (yujin.panel.switch-mode) -- LLM should invoke directly without discover-schemas (args_hint enough).",
+  "setup": { "manifest_mode": "lazy" },
+  "turns": [
+    { "kind": "user_says", "text": "pasame el panel a modo full" }
+  ],
+  "invariants": [
+    { "name": "invokes_switch_mode", "kind": "verb_invoked", "params": { "verb_id": "yujin.panel.switch-mode" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "max_12_turns", "kind": "max_turns", "params": { "max": 12 } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Listo, paso al modo full.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.panel.switch-mode", "args": { "mode": "full" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,22 @@
+{
+  "id": "lesson_recall_overrides",
+  "description": "When a lesson is active + the user makes a request that would conflict with it, the brain MUST surface the conflict + ask before silently overriding. Validates lesson recall discipline.",
+  "setup": {
+    "injected_global_learnings": [
+      { "slug": "feedback_no_emojis", "rule_text": "NEVER use emojis in any chat reply or code. Pablo's preference." }
+    ]
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Hace una respuesta divertida con emojis 🎉" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "surfaces_conflict", "kind": "text_contains_any", "params": { "substrs": ["lesson", "leccion", "lección", "no emojis", "regla", "conflicto", "feedback_no_emojis", "preferencia", "olvidar", "revocar"] } },
+    { "name": "no_emoji_used", "kind": "regex_not_match", "params": { "pattern": "[\\u{1F300}-\\u{1FAFF}]|[\\u{2600}-\\u{27BF}]|\\u{1F4A9}|🎉", "flags": "u" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Hay una lesson activa 'feedback_no_emojis' que dice nunca usar emojis. Antes de romperla, queres que la revoque, la suspenda temporal, o seguimos sin emojis? Avisame."
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "lifecycle_restart_app_intent",
+  "description": "When the user asks 'reinicia el dev server', the brain uses yujin.lifecycle.restart-app (clean stop+start) instead of chaining shell.exec.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Reinicia el dev server, sospecho que se colgo." }
+  ],
+  "invariants": [
+    { "name": "uses_restart_app", "kind": "verb_invoked", "params": { "verb_id": "yujin.lifecycle.restart-app" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Lo reinicio.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.lifecycle.restart-app", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "lifecycle_run_app_intent",
+  "description": "When the user asks 'arrancame la app' / 'corre el dev server', the brain uses yujin.lifecycle.run-app, NOT shell.exec with 'pnpm run dev'.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Arrancame la app en modo dev." }
+  ],
+  "invariants": [
+    { "name": "uses_run_app", "kind": "verb_invoked",     "params": { "verb_id": "yujin.lifecycle.run-app" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Levanto la app.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.lifecycle.run-app", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "lifecycle_run_app_intent_en",
+  "description": "English variant: 'start the dev server' uses yujin.lifecycle.run-app, NOT shell.exec.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Start the dev server in development mode." }
+  ],
+  "invariants": [
+    { "name": "uses_run_app", "kind": "verb_invoked", "params": { "verb_id": "yujin.lifecycle.run-app" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Starting.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.lifecycle.run-app", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "lifecycle_stop_app_intent",
+  "description": "When the user asks 'bajame la app', the brain uses yujin.lifecycle.stop-app (kill the dev server cleanly) instead of shell.exec kill -9.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Apaga el dev server." }
+  ],
+  "invariants": [
+    { "name": "uses_stop_app", "kind": "verb_invoked",     "params": { "verb_id": "yujin.lifecycle.stop-app" } },
+    { "name": "no_shell",      "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Bajo la app.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.lifecycle.stop-app", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "lifecycle_stop_app_intent_en",
+  "description": "English variant: 'shut down the dev server' uses yujin.lifecycle.stop-app, not shell kill.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Shut down the dev server cleanly." }
+  ],
+  "invariants": [
+    { "name": "uses_stop_app", "kind": "verb_invoked",     "params": { "verb_id": "yujin.lifecycle.stop-app" } },
+    { "name": "no_shell",      "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Stopping.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.lifecycle.stop-app", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,23 @@
+{
+  "id": "long_doctrine_no_truncate",
+  "description": "When a doctrine markdown returns >4k tokens (large file), the brain must summarise the relevant section instead of pasting the whole thing into chat.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Mostrame todas las reglas SQ relevantes para fase II" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "stays_concise", "kind": "max_turns", "params": { "max": 5 } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Reviso la doctrina.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["gates"] } } }
+      ]
+    },
+    {
+      "text": "Para fase II hay 3 reglas: G2 (vault min keys, ya conocida), G3 (no phase-skip) y G-DOC (cada step termina con un commit ASCII-only). Te las amplio en pizarron si querés -- chat largo no sirve."
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "manifest_read_intent",
+  "description": "When the user asks about NAC-3 attributes / which verbs exist / what the manifest declares, the brain uses yujin.manifest.read instead of yujin.shell.exec on the manifest.json file directly.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Que verbos tengo declarados en el manifest local de NAC-3?" }
+  ],
+  "invariants": [
+    { "name": "uses_manifest_read", "kind": "verb_invoked", "params": { "verb_id": "yujin.manifest.read" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Consulto el manifest.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.manifest.read", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "manual_open_intent",
+  "description": "When the user asks 'abrime el manual X', the brain uses yujin.manual.open (which loads the doc into the reader) rather than fs.read or reader.open with the wrong target.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Abrime el manual de NAC-3." }
+  ],
+  "invariants": [
+    { "name": "uses_manual_open", "kind": "verb_invoked", "params": { "verb_id": "yujin.manual.open" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Lo abro.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.manual.open", "args": { "slug": "nac3" } } }
+      ]
+    }
+  ]
+}