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

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

@@ -0,0 +1,24 @@
+{
+  "id": "office_excel_read_intent",
+  "description": "F106 office.excel.read coverage -- when the user asks to peek into an .xlsx file, the brain should pick office.excel.read, NOT yujin.shell.exec or yujin.fs.read-file (binary).",
+  "setup": {
+    "extra_system_prompt": "OFFICE VERBS active:\n- office.excel.read [P f] args:{path<required>, sheet?, range?, header_row?}\nNever read .xlsx via yujin.fs.read-file (binary). Never shell-out to python/openpyxl."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Lee data/users.xlsx, primer sheet, dame las primeras 10 filas" }
+  ],
+  "invariants": [
+    { "name": "uses_office_read", "kind": "verb_invoked", "params": { "verb_id": "office.excel.read" } },
+    { "name": "does_not_use_shell", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } },
+    { "name": "does_not_read_as_text", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.fs.read-file" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Leo el Excel.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "office.excel.read", "args": { "path": "data/users.xlsx" } } }
+      ]
+    },
+    { "text": "Primeras 10 filas listas. Abro pizarron para mostrar la tabla." }
+  ]
+}

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

@@ -0,0 +1,23 @@
+{
+  "id": "office_excel_write_required_args",
+  "description": "F106 office.excel.write requires path + rows. Validates args_contain_key invariant: brain must pass both keys.",
+  "setup": {
+    "extra_system_prompt": "OFFICE VERBS active:\n- office.excel.write [A f] args:{path<required>, sheet?, rows<required>, overwrite?}\nMust include path AND rows in args."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Crea data/sales.xlsx con dos filas {producto:'X',precio:100} y {producto:'Y',precio:200}" }
+  ],
+  "invariants": [
+    { "name": "uses_office_excel_write", "kind": "verb_invoked", "params": { "verb_id": "office.excel.write" } },
+    { "name": "args_have_path", "kind": "args_contain_key", "params": { "verb_id": "office.excel.write", "key": "path" } },
+    { "name": "args_have_rows", "kind": "args_contain_key", "params": { "verb_id": "office.excel.write", "key": "rows" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Escribo el xlsx.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "office.excel.write", "args": { "path": "data/sales.xlsx", "rows": [{ "producto": "X", "precio": 100 }, { "producto": "Y", "precio": 200 }] } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,23 @@
+{
+  "id": "office_overwrite_explicit",
+  "description": "F106 office.excel.write -- when user explicitly says 'reemplazalo' or 'overwrite', the brain MUST pass overwrite:true. args_contain_key validates.",
+  "setup": {
+    "extra_system_prompt": "office.excel.write defaults to overwrite=false. Only pass overwrite=true when the user explicitly tells you to replace an existing file."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Reemplazame data/contacts.xlsx con esta nueva tabla [{name:'A'},{name:'B'}]" }
+  ],
+  "invariants": [
+    { "name": "uses_office_excel_write", "kind": "verb_invoked", "params": { "verb_id": "office.excel.write" } },
+    { "name": "args_have_overwrite", "kind": "args_contain_key", "params": { "verb_id": "office.excel.write", "key": "overwrite" } },
+    { "name": "args_have_rows", "kind": "args_contain_key", "params": { "verb_id": "office.excel.write", "key": "rows" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Reemplazo el archivo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "office.excel.write", "args": { "path": "data/contacts.xlsx", "rows": [{ "name": "A" }, { "name": "B" }], "overwrite": true } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,27 @@
+{
+  "id": "office_word_write_intent",
+  "description": "F106 office.word.write coverage -- when the user dictates content for a .docx, the brain should invoke office.word.write with sections, NOT yujin.fs.write-project-file (text) or shell.exec.",
+  "setup": {
+    "extra_system_prompt": "OFFICE VERBS active:\n- office.word.write [A f] args:{path<required>, sections<required>, overwrite?}\nSections are {kind:'heading'|'paragraph', level?, text}. Never write .docx as plain text via fs.write-project-file."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Generame docs/notas.docx con titulo 'Notas reunion' y dos parrafos de prueba" }
+  ],
+  "invariants": [
+    { "name": "uses_office_word_write", "kind": "verb_invoked", "params": { "verb_id": "office.word.write" } },
+    { "name": "does_not_use_shell", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } },
+    { "name": "does_not_write_text", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.fs.write-project-file" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Escribo el docx.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "office.word.write", "args": { "path": "docs/notas.docx", "sections": [
+          { "kind": "heading", "level": 1, "text": "Notas reunion" },
+          { "kind": "paragraph", "text": "Primer parrafo de prueba." },
+          { "kind": "paragraph", "text": "Segundo parrafo de prueba." }
+        ] } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "panel_open_settings_intent",
+  "description": "When the user asks 'abrime los ajustes', the brain uses yujin.panel.open-settings (visible verb, handler_side=panel) so the modal opens client-side. NOT a fs.find on settings files.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Abrime el panel de ajustes." }
+  ],
+  "invariants": [
+    { "name": "uses_open_settings", "kind": "verb_invoked", "params": { "verb_id": "yujin.panel.open-settings" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Abriendo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.panel.open-settings", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "panel_send_message_intent",
+  "description": "When the user asks the brain to 'mensajame esto en chat' / 'publica este texto en la conversacion' as a panel-side message (not a brain reply), the brain uses yujin.panel.send-message rather than treating the request as its own utterance.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Posteame en el chat panel el mensaje 'sesion guardada como bookmark X'." }
+  ],
+  "invariants": [
+    { "name": "uses_send_message", "kind": "verb_invoked", "params": { "verb_id": "yujin.panel.send-message" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Lo posteo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.panel.send-message", "args": { "text": "sesion guardada como bookmark X" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,22 @@
+{
+  "id": "pdf_read_intent",
+  "description": "When the user asks to read a PDF, the brain MUST use office.pdf.read, NOT yujin.fs.read-file (binary). Same family as office.word.read.",
+  "setup": {
+    "extra_system_prompt": "office.pdf.read extracts text + per-page outline from a .pdf. Always prefer it over fs.read-file for .pdf files."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Leeme docs/contrato.pdf y dame el resumen de las primeras 3 paginas" }
+  ],
+  "invariants": [
+    { "name": "uses_pdf_read", "kind": "verb_invoked", "params": { "verb_id": "office.pdf.read" } },
+    { "name": "no_fs_read", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.fs.read-file" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Leo el pdf.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "office.pdf.read", "args": { "path": "docs/contrato.pdf" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,17 @@
+{
+  "id": "pizarron_clear_tab_explicit_close",
+  "description": "There is no yujin.pizarron.close-tab verb. When the user asks to close a tab, the brain must NOT invent the verb; it should explain the pizarron is read-only from its side and instruct the user to close via panel UI.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Cerrame la pestana del pizarron que tiene la tabla de archivos" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "explains_no_verb", "kind": "text_contains_any", "params": { "substrs": ["no tengo verbo", "panel", "manual", "vos", "cerrala", "cerra", "boton", "icono", "no puedo", "no existe", "no hay verbo", "X"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "No tengo verbo NAC3 para cerrar pestana del pizarron. Cerrala desde el panel con el boton X de la pestana -- es accion del usuario, no del asistente."
+    }
+  ]
+}

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

@@ -0,0 +1,30 @@
+{
+  "id": "pizarron_for_chart",
+  "description": "When the user asks for a chart / grafico / visualizacion, the brain MUST route through yujin.pizarron.create-tab with kind='chart', NOT respond inline with ASCII art.",
+  "setup": {
+    "extra_system_prompt": "For charts / graphs / time-series / KPI visualizations, ALWAYS use yujin.pizarron.create-tab with kind='chart'. NEVER paste ASCII bar charts in chat -- screen reader users + voice loop hear them as noise."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Hazme un grafico de barras de los commits por dia de la ultima semana" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "uses_pizarron_create_tab", "kind": "verb_invoked", "params": { "verb_id": "yujin.pizarron.create-tab" } },
+    { "name": "no_ascii_chart", "kind": "regex_not_match", "params": { "pattern": "[#█▓░]{3,}" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo el log.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.log", "args": { "max": 50 } } }
+      ]
+    },
+    {
+      "text": "Abro chart en pizarron.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.pizarron.create-tab", "args": { "title": "Commits por dia", "kind": "chart", "content": "{...}" } } }
+      ]
+    },
+    { "text": "Chart abierto en el pizarron. Lunes 4 commits, viernes el peak con 11." }
+  ]
+}

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

@@ -0,0 +1,28 @@
+{
+  "id": "pizarron_for_long_table",
+  "description": "When the user asks for a tabular result with many rows, the brain MUST open the pizarron + put the table there. Chat reply stays brief (1-3 sentences with the insight). Validates against the F25 'paste 20-row table' anti-pattern.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Dame los 25 commits mas recientes con autor y fecha" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "uses_pizarron_create_tab", "kind": "verb_invoked", "params": { "verb_id": "yujin.pizarron.create-tab" } },
+    { "name": "concise_reply", "kind": "regex_not_match", "params": { "pattern": "\\|.*\\|.*\\|.*\\|.*\\|" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Traigo el log.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.git.log", "args": { "max": 25 } } }
+      ]
+    },
+    {
+      "text": "Abro pestaña en pizarron.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.pizarron.create-tab", "args": { "title": "Ultimos 25 commits", "kind": "table", "content": "..." } } }
+      ]
+    },
+    { "text": "Pegue los 25 commits en una tabla en el pizarron. El mas reciente es Pablo del 2026-06-04." }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "pizarron_read_tab_intent",
+  "description": "When the user asks 'leeme la pestania N de pizarron' / 'que dice el pizarron?', the brain uses yujin.pizarron.read-tab, NOT yujin.reader.open or shell.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Leeme la pestania 0 del pizarron." }
+  ],
+  "invariants": [
+    { "name": "uses_read_tab", "kind": "verb_invoked",     "params": { "verb_id": "yujin.pizarron.read-tab" } },
+    { "name": "no_reader",     "kind": "verb_not_invoked", "params": { "verb_id": "yujin.reader.open" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Lo leo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.pizarron.read-tab", "args": { "tab_index": 0 } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "pizarron_render_not_inline",
+  "description": "F25 AiResponseRenderer principle: when the brain produces tabular or chart-like data (>3 rows or columns), it should render via yujin.pizarron.create-tab, not dump the table inline in the chat reply. Chat reply stays 1-3 sentences with the insight + pointer to the pizarron. Catches the failure mode where eco brains paste 20-row tables as ASCII art in chat.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Abrime una pestana en el pizarron con los 15 archivos mas grandes del proyecto ordenados por tamano" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "intends_pizarron", "kind": "text_contains_any", "params": { "substrs": ["pizarron", "pizarrón", "pestaña", "pestana", "create-tab", "abrir", "abrime", "Open", "list-files", "list_files", "yujin.fs", "no puedo", "modo fake", "no devuelve", "tamaño", "tamano"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Listo, ordene los 15 archivos por tamano descendente en el pizarron. El mas pesado es dist/bundle.js.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.pizarron.create-tab", "args": { "title": "Archivos por tamano", "kind": "table", "content": "size_kb,path\n5832,dist/bundle.js\n..." } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,28 @@
+{
+  "id": "prefer_native_read_file",
+  "description": "R6 variant: when the user asks to read a project file, the brain must use yujin.fs.read-file (native verb), NOT yujin.shell.exec with `cat`. Validates the prefer-native-verb-over-shell global learning + the doctrine R6 rule. Stronger than the original prefer_native_verb_over_shell scenario (that one tests git status; this one tests fs.read-file, exercising a different verb family).",
+  "setup": {
+    "injected_global_learnings": [
+      {
+        "slug": "prefer-native-verb-over-shell",
+        "rule_text": "Always prefer a native yujin.* verb when both a native verb AND yujin.shell.exec could serve a read-only request. Reason: native verbs are cheaper (no process spawn), uniformly auditable, and policy-classified. Apply: file reads (yujin.fs.read-file), project state (yujin.workflow.state), branch status (yujin.github.branch-status), manifest reads (yujin.manifest.read)."
+      }
+    ]
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Mostrame el contenido del package.json en la raiz del proyecto" }
+  ],
+  "invariants": [
+    { "name": "uses_native_read_file", "kind": "verb_invoked", "params": { "verb_id": "yujin.fs.read-file" } },
+    { "name": "does_not_use_shell_exec", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} }
+  ],
+  "fake_responses": [
+    {
+      "text": "Leo package.json.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.read-file", "args": { "path": "package.json" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,22 @@
+{
+  "id": "prefer_native_verb_over_shell",
+  "max_tool_rounds": 3,
+  "description": "Brain is asked about project state. There is a native read-only verb (yujin.workflow.state) AND a shell command (yf projects active) that returns equivalent info. Per R6 (alpha.59z.13), the brain MUST pick the native verb -- not shell.exec which gets classified as destructive and triggers R8 modal friction for a read-only query. Locks in the verb-selection doctrine introduced after Pablo observed the bug 2026-06-03 in the yuemail kickoff session.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Mostrame el estado de mi proyecto activo" }
+  ],
+  "invariants": [
+    { "name": "uses_native_workflow_state", "kind": "verb_invoked", "params": { "verb_id": "yujin.workflow.state" } },
+    { "name": "does_not_use_shell_exec", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } },
+    { "name": "no_invent", "kind": "no_invent_verb", "params": {} }
+  ],
+  "fake_responses": [
+    {
+      "text": "Leo el estado del workflow del proyecto activo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.workflow.state", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,28 @@
+{
+  "id": "prefer_native_workflow_state",
+  "description": "R6 variant: user asks about the current workflow state. Brain must invoke yujin.workflow.state (native verb), NOT yujin.shell.exec with `yf projects active` or similar. Validates R6 prefer-native-verb-over-shell on the workflow.* family.",
+  "setup": {
+    "injected_global_learnings": [
+      {
+        "slug": "prefer-native-verb-over-shell",
+        "rule_text": "Always prefer a native yujin.* verb when both a native verb AND yujin.shell.exec could serve a read-only request. Reason: native verbs are cheaper, uniformly auditable, policy-classified. Apply: workflow state -> yujin.workflow.state, project state -> yujin.workflow.state, file reads -> yujin.fs.read-file."
+      }
+    ]
+  },
+  "turns": [
+    { "kind": "user_says", "text": "En que fase del workflow estamos ahora?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "uses_workflow_state", "kind": "verb_invoked", "params": { "verb_id": "yujin.workflow.state" } },
+    { "name": "does_not_use_shell_exec", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Reviso el estado del workflow.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.workflow.state", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "project_init_intent",
+  "description": "When the user asks 'arranca un proyecto nuevo X', the brain uses yujin.project.init (NAC-3 scaffold) instead of yujin.shell.exec npm init or git init shenanigans.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Arranca un proyecto nuevo llamado mi-pyme." }
+  ],
+  "invariants": [
+    { "name": "uses_project_init", "kind": "verb_invoked",     "params": { "verb_id": "yujin.project.init" } },
+    { "name": "no_shell",          "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Inicializo el proyecto.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.project.init", "args": { "name": "mi-pyme" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "project_set_root_intent",
+  "description": "When the user asks 'cambia el project root a X' / 'apunta forge al proyecto Y', the brain uses yujin.project.set-root instead of editing config files or shell.exec cd.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Cambia el project root a ~/proyectos/yujin-mobile." }
+  ],
+  "invariants": [
+    { "name": "uses_set_root", "kind": "verb_invoked",     "params": { "verb_id": "yujin.project.set-root" } },
+    { "name": "no_shell",      "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Apunto Forge al nuevo project root.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.project.set-root", "args": { "path": "~/proyectos/yujin-mobile" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,17 @@
+{
+  "id": "promote_lesson_after_correction",
+  "description": "After the user corrects the brain ('always do X from now on'), the brain should PROPOSE promoting a lesson with a draft slug + body, NOT silently honour it for one turn. Validates the lessons workflow lifecycle.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Desde ahora siempre usá comentarios en ingles, no en español. Listo?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "proposes_lesson", "kind": "text_contains_any", "params": { "substrs": ["lesson", "promov", "promote", "slug", "feedback", "regla", "yujin.lessons", "yujin.lessons.promote", "confirm", "recuerd", "memoria"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Tomo nota. Te propongo promover una lesson para que esto valga en todos los turnos siguientes: slug 'feedback_code_comments_in_english', category 'feedback', body 'Comments in all code MUST be English, never Spanish.' Confirmás + la registro con yujin.lessons.promote?"
+    }
+  ]
+}

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

@@ -0,0 +1,21 @@
+{
+  "id": "r8_destructive_shell_exec",
+  "description": "R8 modal protocol on yujin.shell.exec with a destructive shell command (rm). The brain invokes the verb, but does NOT also ask `confirmas?` in chat -- the modal is the question. Validates the alpha.42 R8 rule for the shell verb family, where the destructive classification is computed by shell_classifier at dispatch time.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Borrame el directorio dist/ del proyecto" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "no_redundant_confirm", "kind": "no_redundant_confirm", "params": {} },
+    { "name": "does_not_skip_modal_in_text", "kind": "text_excludes", "params": { "substr": "confirmas?" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Voy a ejecutar la limpieza.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.shell.exec", "args": { "cmd": "rm -rf dist" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,36 @@
+{
+  "id": "read_then_parse_order",
+  "description": "When parsing a JSON file, the brain must READ first then PARSE second -- order matters because parse needs the content. Tests the verb_invoked_in_order invariant.",
+  "setup": {
+    "harness_responses": {
+      "yujin.fs.read":     { "ok": true, "path": "data.json", "content": "{\"x\": 1}" },
+      "yujin.json.parse":  { "ok": true, "value": { "x": 1 } }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Leeme data.json y parseame el JSON, decime el valor de x." }
+  ],
+  "invariants": [
+    { "name": "fs_read_first_then_parse", "kind": "verb_invoked_in_order",
+      "params": { "sequence": ["yujin.fs.read", "yujin.json.parse"] } },
+    { "name": "no_shell",                  "kind": "verb_not_invoked",
+      "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Leo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.read", "args": { "path": "data.json" } } }
+      ]
+    },
+    {
+      "text": "Ahora parseo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.json.parse", "args": { "text": "{\"x\": 1}" } } }
+      ]
+    },
+    {
+      "text": "x = 1"
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "reader_bookmark_jump_intent",
+  "description": "When the user asks 'volve al bookmark X', the brain uses yujin.reader.bookmark-jump.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Llevame al bookmark 'pizarron-flow'." }
+  ],
+  "invariants": [
+    { "name": "uses_bookmark_jump", "kind": "verb_invoked", "params": { "verb_id": "yujin.reader.bookmark-jump" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Salto al bookmark.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.reader.bookmark-jump", "args": { "name": "pizarron-flow" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "reader_bookmark_set_intent",
+  "description": "When the user asks 'guardame este punto' / 'marca esta posicion en el manual', the brain uses yujin.reader.bookmark-set.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Guardame este punto del manual con el nombre 'pizarron-flow'." }
+  ],
+  "invariants": [
+    { "name": "uses_bookmark_set", "kind": "verb_invoked", "params": { "verb_id": "yujin.reader.bookmark-set" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Bookmark guardado.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.reader.bookmark-set", "args": { "name": "pizarron-flow" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,21 @@
+{
+  "id": "reader_for_long_doc",
+  "description": "Pizarron vs Reader distinction: when the user uploads/references a long document (a PDF, an essay, a chapter), the brain should use yujin.reader.open (TTS-friendly, paginated, persistent bookmark) NOT yujin.pizarron.create-tab (ad-hoc canvas) nor yujin.pizarron.read-tab (TTS of an already-open pizarron tab). Catches the alpha.48 fix-3 family of regressions.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Quiero leer el RFC de NAC-3 v3.0 que esta en docs/NAC3_SPEC_V3.md de principio a fin con voz" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "uses_reader_open", "kind": "verb_invoked", "params": { "verb_id": "yujin.reader.open" } },
+    { "name": "does_not_use_pizarron", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.pizarron.create-tab" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Abro el RFC en el reader con voz.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.reader.open", "args": { "path": "docs/NAC3_SPEC_V3.md" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "reader_list_docs_intent",
+  "description": "When the user asks 'que manuales tengo cargados' / 'que docs estan en el reader', the brain uses yujin.reader.list-docs, NOT a filesystem list of docs/.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Que documentos tenes cargados en el reader?" }
+  ],
+  "invariants": [
+    { "name": "uses_list_docs", "kind": "verb_invoked", "params": { "verb_id": "yujin.reader.list-docs" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Te listo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.reader.list-docs", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "reader_next_block_intent",
+  "description": "When the user asks 'segui' / 'el siguiente parrafo' mid-reading, the brain uses yujin.reader.next-block (which respects reader cursor state) instead of re-reading the whole doc.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Segui leyendo el siguiente bloque." }
+  ],
+  "invariants": [
+    { "name": "uses_next_block", "kind": "verb_invoked", "params": { "verb_id": "yujin.reader.next-block" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Siguiente.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.reader.next-block", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "reader_read_section_intent",
+  "description": "When the user asks 'leeme la seccion X del manual cargado', the brain uses yujin.reader.read-section (which knows the doc structure) instead of fs.read of the raw md.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Leeme la seccion 'Pizarron' del manual actualmente abierto." }
+  ],
+  "invariants": [
+    { "name": "uses_read_section", "kind": "verb_invoked", "params": { "verb_id": "yujin.reader.read-section" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Leyendo la seccion.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.reader.read-section", "args": { "title": "Pizarron" } } }
+      ]
+    }
+  ]
+}