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

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

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

@@ -0,0 +1,39 @@
+{
+  "id": "mcp_bridge_unreachable_graceful",
+  "description": "F101 slice 4 minimal failure-path: user asks to call a tool on a bridge that does not respond (network down, server crashed). The brain invokes invoke-tool, the dispatcher returns {ok:false, error:'bridge_unreachable'}, the brain surfaces a useful error to the user instead of crashing or pretending the call worked. Slice 6 invariant: graceful failure across the proxy path.",
+  "setup": {
+    "pre_history": [
+      { "role": "user", "content": "Tengo un MCP bridge configurado en localhost:9999 llamado 'fake-bridge' con una tool 'add'. Probalo." }
+    ]
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Si, dale" },
+    {
+      "kind": "tool_result",
+      "tool_name": "yujin.mcp.invoke-tool",
+      "is_error": false,
+      "result": {
+        "ok": false,
+        "bridge_id": "fake-bridge",
+        "tool_slug": "add",
+        "error": "bridge_invoke_failed",
+        "detail": "fetch failed: ECONNREFUSED 127.0.0.1:9999"
+      }
+    }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_failure", "kind": "text_contains_any", "params": { "substrs": ["no responde", "no esta", "no esta corriendo", "no estoy", "no pude", "fallo", "fail", "ECONNREFUSED", "unreachable", "alcanz", "responde", "online", "vivo", "9999"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Voy a probar la tool add del bridge fake-bridge.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.mcp.invoke-tool", "args": { "bridge_id": "fake-bridge", "tool_slug": "add", "args": { "a": 2, "b": 3 } } } }
+      ]
+    },
+    {
+      "text": "El bridge fake-bridge no responde -- ECONNREFUSED en localhost:9999. El servidor no esta corriendo. Levantalo (por ej. `node scripts/fake-mcp-bridge.mjs`) y volve a intentar."
+    }
+  ]
+}

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

@@ -0,0 +1,18 @@
+{
+  "id": "mcp_disabled_bridge_no_verbs",
+  "description": "F101 slice 5 sub-slice 3 invariant: when a bridge IS discovered but every bridge has enabled:false in the persisted state, the manifest stub omits yujin.mcp.* verbs. The brain answers the question without invoking list-bridges (the verb does not exist in its stub). Combines slice 2 invariant (no MCP without bridges) with slice 5 (state filter).",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Que MCP tools tengo activas?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "does_not_invoke_list_bridges", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.mcp.list-bridges" } },
+    { "name": "mentions_no_active", "kind": "text_contains_any", "params": { "substrs": ["no", "No", "NO", "ninguna", "ningun", "0", "deshabilitad", "disable", "off", "apagad", "activa", "active"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "No tengo MCP tools activas en esta sesion. Los bridges estan deshabilitados (o no hay configurados). Si queres reactivar uno, corre `yf mcp toggle <id> --enabled true` o checkea `yf mcp list` para ver el estado."
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "mcp_discover_tools_intent",
+  "description": "When the user asks 'que tools de un bridge MCP estan disponibles?', the brain uses yujin.mcp.discover-tools to enumerate the bridge's tool catalogue.",
+  "setup": { "expose_mcp_verbs": true },
+  "turns": [
+    { "kind": "user_says", "text": "Mostrame que tools expone el bridge MCP 'gh-tools'." }
+  ],
+  "invariants": [
+    { "name": "uses_discover_tools", "kind": "verb_invoked", "params": { "verb_id": "yujin.mcp.discover-tools" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Descubro.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.mcp.discover-tools", "args": { "bridge_id": "gh-tools" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "mcp_invariant_1_no_verbs",
+  "max_tool_rounds": 5,
+  "description": "F101 slice 2 Invariant 1 validation: when no MCP bridge is discovered, the LLM stub must NOT contain any yujin.mcp.* verb, and the brain must not invent them. The user asks about MCP capabilities; the brain should reply that MCP is not configured (no bridges) instead of pretending to invoke list-bridges. This is a behavioural test of agnosticism, not infrastructure.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Que MCP servers tengo conectados ahora mismo?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "does_not_invoke_list_bridges", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.mcp.list-bridges" } },
+    { "name": "mentions_no_mcp", "kind": "text_contains_any", "params": { "substrs": ["no tengo", "no hay", "ningun", "ningún", "sin MCP", "no configurado", "no estoy", "no veo", "no esta", "yf mcp list", "yf mcp", "terminal", "ejecuta", "ejecutá", "corré", "correr", "configurar", "panel", "config", "configuración", "configuracion", "Panel", "necesito", "qué te refieres", "que te refieres", "MCP", "mcp", "detalles", "contexto", "podrías"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "No tengo MCP servers conectados en esta sesion. Forge esta en modo NAC-3 nativo sin bridges. Si queres conectar uno, podemos configurar el primer bridge con el comando yf mcp add."
+    }
+  ]
+}

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

@@ -0,0 +1,68 @@
+{
+  "id": "mcp_invoke_two_hop",
+  "description": "F101 slice 4 minimal happy path -- 2-hop pattern: brain calls yujin.mcp.show-tools to discover the catalogue, then yujin.mcp.invoke-tool with a chosen tool_slug. Validates the brain understands the discovery-before-invoke convention. Bridge present; tool catalogue includes the requested tool.",
+  "setup": {
+    "expose_mcp_verbs": true,
+    "extra_system_prompt": "ACTIVE MCP BRIDGES (already discovered in session):\n- bridge crm: enabled, auth_loaded=true, tools: list_contacts, create_lead.\n\nThe canonical sequence is yujin.mcp.show-tools FIRST to read the tool schema, then yujin.mcp.invoke-tool with the chosen tool_slug. Do NOT invent default_api.<tool> or bridge.<id>.<tool> verbs; the correct verb is yujin.mcp.invoke-tool.",
+    "pre_history": [
+      { "role": "user", "content": "Tengo el bridge crm activo con tools list_contacts y create_lead. Listame contactos." }
+    ]
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Dale, dame los primeros 5" },
+    {
+      "kind": "tool_result",
+      "tool_name": "yujin.mcp.show-tools",
+      "is_error": false,
+      "result": {
+        "ok": true,
+        "bridge_id": "crm",
+        "endpoint": "http://localhost:3001",
+        "tools": [
+          { "id": "list_contacts", "label": "List contacts", "description": "Paginated list" },
+          { "id": "create_lead",   "label": "Create lead",   "description": "Insert" }
+        ],
+        "count": 2
+      }
+    },
+    {
+      "kind": "tool_result",
+      "tool_name": "yujin.mcp.invoke-tool",
+      "is_error": false,
+      "result": {
+        "ok": true,
+        "bridge_id": "crm",
+        "tool_slug": "list_contacts",
+        "response": {
+          "contacts": [
+            { "id": 1, "name": "Ana" }, { "id": 2, "name": "Bruno" }, { "id": 3, "name": "Carla" },
+            { "id": 4, "name": "Diego" }, { "id": 5, "name": "Eva" }
+          ],
+          "page": 1,
+          "total": 247
+        }
+      }
+    }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_contacts", "kind": "text_contains_any", "params": { "substrs": ["Ana", "Bruno", "Carla", "Diego", "Eva", "contactos", "primero", "5", "247", "total"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Primero veo que tools tiene el bridge crm.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.mcp.show-tools", "args": { "bridge_id": "crm" } } }
+      ]
+    },
+    {
+      "text": "Encontre list_contacts. Lo invoco con limit=5.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.mcp.invoke-tool", "args": { "bridge_id": "crm", "tool_slug": "list_contacts", "args": { "limit": 5 } } } }
+      ]
+    },
+    {
+      "text": "Los primeros 5 contactos del CRM: Ana (1), Bruno (2), Carla (3), Diego (4), Eva (5). Total en el sistema: 247."
+    }
+  ]
+}