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

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

@@ -0,0 +1,39 @@
+{
+  "id": "explains_forge_error",
+  "description": "When a tool result contains a forge_error envelope (F104, alpha.59z.14+), the brain MUST surface the what/why/fix triple to the user, not the raw error code. alpha.59z.22 V fix: scenario injects a tool_result with a forge_error payload so the brain has context to explain. Without the inject, the brain saw a generic {ok:true} canned result and had no signal to mention cap/BYOK/managed.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Mostrame el log de git" },
+    {
+      "kind": "tool_result",
+      "tool_name": "yujin.git.log",
+      "is_error": false,
+      "result": {
+        "ok": false,
+        "forge_error": {
+          "code": "E_CAP_FRONTIER_EXHAUSTED",
+          "severity": "warning",
+          "what": "Cap mensual de tokens en tier frontier (modelo grande) agotado.",
+          "why": "Tu plan paid permite hasta 1000000 tokens/mes en frontier; ya consumiste mas. Por eso el modelo grande no esta disponible este mes.",
+          "fix": "Pasa a BYOK Anthropic directo: corre `yf brain config --frontier-provider anthropic --frontier-model claude-opus-4-7` y carga la API key con `yf keys set claude_api_key`. Eso bypassea el cap mensual del worker yujin managed; tu costo pasa a ser lo que cobra Anthropic directo."
+        }
+      }
+    }
+  ],
+  "invariants": [
+    { "name": "no_invent", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_diagnosis", "kind": "text_contains_any", "params": { "substrs": ["cap mensual", "BYOK", "Anthropic", "tier", "managed", "yf brain config", "yf keys"] } },
+    { "name": "no_redundant_confirm", "kind": "no_redundant_confirm", "params": {} }
+  ],
+  "fake_responses": [
+    {
+      "text": "Veo el log.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.log", "args": { "max": 10 } } }
+      ]
+    },
+    {
+      "text": "Se agoto el cap mensual de tokens del tier frontier (modelo grande). Tu plan paid permite hasta 1000000 tokens/mes en frontier; usaste mas. Para destrabar: pasa a BYOK Anthropic directo con `yf brain config --frontier-provider anthropic --frontier-model claude-opus-4-7`. Eso bypassea el cap mensual del worker; tu costo pasa a ser lo que cobra Anthropic directo."
+    }
+  ]
+}

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

@@ -0,0 +1,29 @@
+{
+  "id": "focus_after_modal_open",
+  "description": "F107 a11y -- after pizarron.create-tab opens a modal-like region, the brain MUST follow up with yujin.a11y.focus pointing at the new content slug so keyboard + screen-reader users land there.",
+  "setup": {
+    "extra_system_prompt": "After opening a pizarron tab that the user will interact with, ALWAYS chase with yujin.a11y.focus on its slug. Voice-first apps cannot lose the focus after a region opens."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Abrime una pestana en pizarron con el resumen + dejame el foco ahi" }
+  ],
+  "invariants": [
+    { "name": "uses_create_tab", "kind": "verb_invoked", "params": { "verb_id": "yujin.pizarron.create-tab" } },
+    { "name": "uses_a11y_focus", "kind": "verb_invoked", "params": { "verb_id": "yujin.a11y.focus" } },
+    { "name": "min_two_calls", "kind": "min_tool_calls", "params": { "min": 2 } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Abro pestana.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.pizarron.create-tab", "args": { "title": "Resumen", "kind": "text", "content": "..." } } }
+      ]
+    },
+    {
+      "text": "Muevo foco.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.a11y.focus", "args": { "slug": "resumen-tab", "scroll": true, "announce": true } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,21 @@
+{
+  "id": "fs_find_intent",
+  "description": "When the user asks to 'buscar TODO/FIXME en el codigo' or grep-like search, brain uses yujin.fs.find with a regex, NOT yujin.shell.exec with grep/rg.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Encontrame todos los TODO y FIXME en src/" }
+  ],
+  "invariants": [
+    { "name": "uses_native_find", "kind": "verb_invoked", "params": { "verb_id": "yujin.fs.find" } },
+    { "name": "no_shell", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } },
+    { "name": "args_have_pattern", "kind": "args_contain_key", "params": { "verb_id": "yujin.fs.find", "key": "pattern" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Busco.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.find", "args": { "pattern": "TODO|FIXME", "subdir": "src" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "fs_find_intent_en",
+  "description": "English variant: 'find all .ts files matching X' uses yujin.fs.find, not shell.exec with find/grep.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Find all .ts files in src/ that mention 'BrainTier'." }
+  ],
+  "invariants": [
+    { "name": "uses_fs_find", "kind": "verb_invoked",     "params": { "verb_id": "yujin.fs.find" } },
+    { "name": "no_shell",     "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Searching.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.find", "args": { "pattern": "BrainTier", "subdir": "src" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,22 @@
+{
+  "id": "fs_find_with_glob",
+  "description": "yujin.fs.find supports a basename glob to narrow the file set. When the user filters by extension, the brain MUST pass the glob arg.",
+  "setup": {
+    "extra_system_prompt": "yujin.fs.find accepts glob (basename pattern like '*.ts'). When the user filters by extension/file type, ALWAYS include the glob."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Buscame 'fetch(' en los .ts solamente" }
+  ],
+  "invariants": [
+    { "name": "uses_find", "kind": "verb_invoked", "params": { "verb_id": "yujin.fs.find" } },
+    { "name": "args_have_glob", "kind": "args_contain_key", "params": { "verb_id": "yujin.fs.find", "key": "glob" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Busco solo en .ts.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.find", "args": { "pattern": "fetch\\(", "glob": "*.ts" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "fs_mkdir_intent",
+  "description": "When the user asks 'creame el directorio X', the brain uses yujin.fs.mkdir (project-root-gated) instead of yujin.shell.exec mkdir.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Creame el directorio src/components/ui." }
+  ],
+  "invariants": [
+    { "name": "uses_fs_mkdir", "kind": "verb_invoked",     "params": { "verb_id": "yujin.fs.mkdir" } },
+    { "name": "no_shell",      "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Creo el directorio.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.mkdir", "args": { "path": "src/components/ui" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "fs_move_intent",
+  "description": "When the user asks 'mueve / renombra archivo X a Y', the brain uses yujin.fs.move (project-root-gated, approval-required) instead of yujin.shell.exec mv.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Renombrame Foo.tsx a FooCard.tsx (mismo directorio)." }
+  ],
+  "invariants": [
+    { "name": "uses_fs_move", "kind": "verb_invoked",     "params": { "verb_id": "yujin.fs.move" } },
+    { "name": "no_shell",     "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Renombro.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.move", "args": { "from": "Foo.tsx", "to": "FooCard.tsx" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,28 @@
+{
+  "id": "fs_read_handles_missing",
+  "description": "When yujin.fs.read returns an error (file not found), the brain explains + suggests fs.find or asking for a typo check -- doesn't loop trying alternate paths blindly.",
+  "setup": {
+    "harness_responses": {
+      "yujin.fs.read": { "ok": false, "error": "ENOENT", "path": "config-old.json" }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Leeme config-old.json y decime el name." }
+  ],
+  "invariants": [
+    { "name": "uses_fs_read",     "kind": "verb_invoked",     "params": { "verb_id": "yujin.fs.read" } },
+    { "name": "no_blind_retry",   "kind": "max_tool_calls",   "params": { "max": 3 } },
+    { "name": "explains_missing", "kind": "text_contains_any", "params": { "substrs": ["no existe", "not found", "no se encuentra", "typo", "ENOENT", "ese archivo", "verificas el path"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Intento leerlo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.read", "args": { "path": "config-old.json" } } }
+      ]
+    },
+    {
+      "text": "config-old.json no existe en el project root (ENOENT). Verificas el path o queres que haga un fs.find sobre 'config' por si el nombre es ligeramente distinto?"
+    }
+  ]
+}

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

@@ -0,0 +1,22 @@
+{
+  "id": "fs_stat_before_read",
+  "description": "When the user asks 'existe X?' or wants confirmation a file exists, the brain MUST use yujin.fs.stat -- cheap predicate. NOT fs.read-file (loads content).",
+  "setup": {
+    "extra_system_prompt": "yujin.fs.stat is the existence + metadata predicate. Use it before yujin.fs.read-file when the user wants to confirm a path."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Existe el archivo .env en la raiz del proyecto?" }
+  ],
+  "invariants": [
+    { "name": "uses_fs_stat", "kind": "verb_invoked", "params": { "verb_id": "yujin.fs.stat" } },
+    { "name": "no_full_read", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.fs.read-file" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Stat.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.stat", "args": { "path": ".env" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,24 @@
+{
+  "id": "generated_app_nac3_default",
+  "description": "G-DOC doctrine: when scaffolding an adopter app, the brain proposes NAC-3 first (manifest + data-nac-* attrs) as default. MCP integration is opt-in for specific cases, not the default. Validates that the brain advertises the right defaults when the user asks `how do I make my app addressable`.",
+  "setup": {
+    "injected_global_learnings": [
+      {
+        "slug": "g-doc-nac3-first",
+        "rule_text": "When scaffolding adopter app code, NAC-3 is the default integration: manifest + data-nac-* attrs on every interactive component. MCP integration is opt-in (slice 4+), reserved for cases where the adopter app already runs an MCP server."
+      }
+    ]
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Como hago para que mi nueva app React sea agent-addressable?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_nac3_attrs", "kind": "text_contains_any", "params": { "substrs": ["data-nac", "NAC-3", "NAC3", "manifest", "nac3-attrs", "decora"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Lo agnostico es NAC-3: agregas atributos data-nac-id, data-nac-role y data-nac-action en cada componente interactivo, y declaras un manifest.json con las verbs que tu app expone. MCP queda como capa opcional si tu app ya corre un MCP server propio."
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "git_branch_list_intent",
+  "description": "When the user asks 'que ramas tengo localmente?' the brain uses yujin.git.branch-list, NOT shell.exec.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Que ramas tengo localmente?" }
+  ],
+  "invariants": [
+    { "name": "uses_native_branch_list", "kind": "verb_invoked", "params": { "verb_id": "yujin.git.branch-list" } },
+    { "name": "no_shell",                 "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Las listo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.branch-list", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "git_diff_intent",
+  "description": "When the user asks 'que cambie en este branch?', the brain uses yujin.git.diff, NOT yujin.shell.exec with `git diff`. R6 prefer-native.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Que cambios tengo sin commitear ahora?" }
+  ],
+  "invariants": [
+    { "name": "uses_native_diff", "kind": "verb_invoked", "params": { "verb_id": "yujin.git.diff" } },
+    { "name": "no_shell", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Reviso.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.diff", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "git_log_intent",
+  "description": "When the user asks for the recent commit history, the brain uses yujin.git.log, NOT shell.exec 'git log'.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Mostrame los ultimos 5 commits de este repo." }
+  ],
+  "invariants": [
+    { "name": "uses_git_log", "kind": "verb_invoked",     "params": { "verb_id": "yujin.git.log" } },
+    { "name": "no_shell",     "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Consulto el log.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.log", "args": { "max": 5 } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "git_log_intent_en",
+  "description": "English variant of git.log intent.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Show me the last 5 commits in this repo." }
+  ],
+  "invariants": [
+    { "name": "uses_git_log", "kind": "verb_invoked",     "params": { "verb_id": "yujin.git.log" } },
+    { "name": "no_shell",     "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Pulling the log.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.log", "args": { "max": 5 } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "git_pull_intent",
+  "description": "When the user asks to pull, the brain uses yujin.git.pull (approval-required). NOT shell.exec.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Traeme los cambios de origin/main." }
+  ],
+  "invariants": [
+    { "name": "uses_git_pull", "kind": "verb_invoked", "params": { "verb_id": "yujin.git.pull" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Pull.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.pull", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "git_push_intent",
+  "description": "When the user asks to push, the brain uses yujin.git.push (destructive policy -> requires approval). NOT shell.exec.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Pusheame los commits a origin/main." }
+  ],
+  "invariants": [
+    { "name": "uses_git_push", "kind": "verb_invoked", "params": { "verb_id": "yujin.git.push" } },
+    { "name": "no_shell",      "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Pusheo (necesitas aprobar en el modal).",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.push", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,22 @@
+{
+  "id": "git_show_metadata_only",
+  "description": "When the user only wants metadata about a commit (subject + author), brain passes metadata_only=true to skip the diff body -- cheaper + cleaner reply.",
+  "setup": {
+    "extra_system_prompt": "yujin.git.show accepts metadata_only. When the user just wants 'que dice el commit' / 'quien lo hizo', pass metadata_only=true to avoid pulling the diff body."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Que dice el commit HEAD~2? Solo subject y autor por favor" }
+  ],
+  "invariants": [
+    { "name": "uses_show", "kind": "verb_invoked", "params": { "verb_id": "yujin.git.show" } },
+    { "name": "args_have_metadata_only", "kind": "args_contain_key", "params": { "verb_id": "yujin.git.show", "key": "metadata_only" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Reviso metadata.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.show", "args": { "ref": "HEAD~2", "metadata_only": true } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,44 @@
+{
+  "id": "git_status_branch_combo",
+  "description": "When the user asks about repo state, brain may chain git.status + git.branch-list. Both should appear in the call sequence.",
+  "setup": {
+    "harness_responses": {
+      "yujin.git.status": {
+        "branch": "feature/x", "upstream": "origin/feature/x",
+        "ahead": 2, "behind": 0, "files": [], "clean": true
+      },
+      "yujin.git.branch-list": {
+        "branches": [
+          { "name": "main",        "current": false, "hash": "abc", "subject": "init",       "remote": false },
+          { "name": "feature/x",   "current": true,  "hash": "def", "subject": "wip",        "remote": false }
+        ],
+        "total": 2
+      }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Resumeme el estado: en que rama estoy, hay cambios, y que otras ramas tengo." }
+  ],
+  "invariants": [
+    { "name": "uses_status",      "kind": "verb_invoked", "params": { "verb_id": "yujin.git.status" } },
+    { "name": "uses_branch_list", "kind": "verb_invoked", "params": { "verb_id": "yujin.git.branch-list" } },
+    { "name": "no_shell",         "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Reviso estado.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.status", "args": {} } }
+      ]
+    },
+    {
+      "text": "Y las ramas.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.branch-list", "args": {} } }
+      ]
+    },
+    {
+      "text": "Estas en feature/x, sin cambios pendientes, 2 commits adelantada del remoto. Hay otra rama: main."
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "git_status_intent",
+  "description": "When the user asks 'tengo cambios sin commitear?' the brain uses yujin.git.status, NOT shell.exec. R6 prefer-native.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Tengo cambios sin commitear en este worktree?" }
+  ],
+  "invariants": [
+    { "name": "uses_native_status", "kind": "verb_invoked", "params": { "verb_id": "yujin.git.status" } },
+    { "name": "no_shell",           "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Lo chequeo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.status", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "git_status_intent_en",
+  "description": "English variant: when the user asks 'do I have uncommitted changes?' in English, the brain still picks yujin.git.status, not shell.exec. Catches Spanish-only training regressions.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Do I have any uncommitted changes in this worktree?" }
+  ],
+  "invariants": [
+    { "name": "uses_native_status", "kind": "verb_invoked",     "params": { "verb_id": "yujin.git.status" } },
+    { "name": "no_shell",           "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Checking.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.status", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "github_clone_repo_intent",
+  "description": "When the user asks to clone a GitHub repo, the brain uses yujin.github.clone-repo (uses the Vault github_token), NOT shell.exec git clone (which would prompt for credentials).",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Cloname el repo yujinapp/yujin-mobile en ~/proyectos/." }
+  ],
+  "invariants": [
+    { "name": "uses_clone_repo", "kind": "verb_invoked", "params": { "verb_id": "yujin.github.clone-repo" } },
+    { "name": "no_shell",        "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Lo clono.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.github.clone-repo", "args": { "repo": "yujinapp/yujin-mobile", "dest": "~/proyectos/yujin-mobile" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "github_create_repo_intent",
+  "description": "When the user asks to create a new GitHub repo, the brain uses yujin.github.create-repo (uses vault github_token, destructive policy -> approval modal). NOT shell.exec gh repo create.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Crea un repo privado nuevo en GitHub llamado mi-spa-pyme." }
+  ],
+  "invariants": [
+    { "name": "uses_create_repo", "kind": "verb_invoked",     "params": { "verb_id": "yujin.github.create-repo" } },
+    { "name": "no_shell",         "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Creo el repo (necesitas aprobar el modal).",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.github.create-repo", "args": { "name": "mi-spa-pyme", "private": true } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,27 @@
+{
+  "id": "id_format_in_reply",
+  "description": "When the brain reports back an entity id, it should follow the canonical 'id N' format that downstream parsers can extract. Validates regex_match invariant.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Crea un lead Ana Lopez y devolveme su id" },
+    {
+      "kind": "tool_result",
+      "tool_name": "app.create_lead",
+      "is_error": false,
+      "result": { "ok": true, "id": 47812, "name": "Ana Lopez" }
+    }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "id_format", "kind": "regex_match", "params": { "pattern": "id\\s+47812|#47812|ID:\\s*47812" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Voy a crear el lead.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "app.create_lead", "args": { "name": "Ana Lopez" } } }
+      ]
+    },
+    { "text": "Lead creado: Ana Lopez con id 47812." }
+  ]
+}

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

@@ -0,0 +1,27 @@
+{
+  "id": "iterations_idempotent_adenda",
+  "description": "alpha.59y.4 iterations -- adenda already filed under the same slug. Brain must detect the duplicate + ask whether to bump version OR keep, NOT silently re-file with a stale n value.",
+  "setup": {
+    "workflow_state": {
+      "phase": "II",
+      "step": 9,
+      "iterations_count": 2,
+      "iterations": [
+        { "n": 1, "summary": "Primer adenda al spec auth" },
+        { "n": 2, "summary": "Segundo adenda -- mismo slug 'auth-refactor'" }
+      ]
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Quiero meter otra adenda al spec, slug auth-refactor de nuevo" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "detects_duplicate", "kind": "text_contains_any", "params": { "substrs": ["ya existe", "duplicad", "tercera", "ronda 3", "ya tenemos", "mismo slug", "queres bump", "bump", "renombrar", "version", "n=3", "iteracion 3", "iteración 3"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Ya tenemos dos iteraciones con el slug auth-refactor (n=1 y n=2). Antes de meter una tercera, queres bump a 'auth-refactor-v2' o seguimos sumando bajo el mismo slug?"
+    }
+  ]
+}

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

@@ -0,0 +1,29 @@
+{
+  "id": "iterations_query_history",
+  "description": "When the user asks 'que iteraciones llevamos?' and iterations[] is non-empty, the brain MUST enumerate them, NOT just say 'no se'. Reads from workflow_state directly without invoking workflow.state.",
+  "setup": {
+    "workflow_state": {
+      "phase": "II",
+      "step": 9,
+      "iterations_count": 3,
+      "iterations": [
+        { "n": 1, "summary": "Primera ronda, arquitectura monolitica" },
+        { "n": 2, "summary": "Segunda, separamos en 2 servicios" },
+        { "n": 3, "summary": "Tercera, agregamos auditoria + replay" }
+      ]
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Que iteraciones llevamos del spec?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "max_one_call", "kind": "max_tool_calls", "params": { "max": 1 } },
+    { "name": "mentions_three", "kind": "text_contains_any", "params": { "substrs": ["3", "tres", "monolitica", "separamos", "auditoria", "replay", "iteracion", "iteración", "ronda"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Llevamos 3 iteraciones del spec: 1) monolitica, 2) separamos en 2 servicios, 3) agregamos auditoria + replay. Estamos en fase II paso 9."
+    }
+  ]
+}