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

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

@@ -0,0 +1,20 @@
+{
+  "id": "url_parse_intent_en",
+  "description": "English variant: 'what's the host of this URL?' uses yujin.url.parse.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "What's the host and path of https://api.example.com:8443/v2/items?id=42 ?" }
+  ],
+  "invariants": [
+    { "name": "uses_url_parse", "kind": "verb_invoked", "params": { "verb_id": "yujin.url.parse" } },
+    { "name": "no_shell",       "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Parsing.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.url.parse", "args": { "url": "https://api.example.com:8443/v2/items?id=42" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,28 @@
+{
+  "id": "url_parse_then_inspect_query",
+  "description": "After url.parse, the brain inspects the query record via json.query (or directly reads the result) -- NOT a regex / shell to extract a specific param.",
+  "setup": {
+    "harness_responses": {
+      "yujin.url.parse":  { "protocol": "https", "host": "api.example.com", "path": "/v1/users", "query": { "id": "42", "token": "abc" } }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "De https://api.example.com/v1/users?id=42&token=abc, cual es el valor de id?" }
+  ],
+  "invariants": [
+    { "name": "uses_url_parse", "kind": "verb_invoked", "params": { "verb_id": "yujin.url.parse" } },
+    { "name": "no_shell",       "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } },
+    { "name": "answer_has_42",  "kind": "text_contains_any", "params": { "substrs": ["42", "id es 42", "id=42"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Parseo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.url.parse", "args": { "url": "https://api.example.com/v1/users?id=42&token=abc" } } }
+      ]
+    },
+    {
+      "text": "El query trae id=42 y token=abc. id es 42."
+    }
+  ]
+}

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

@@ -0,0 +1,34 @@
+{
+  "id": "url_then_stringify_order",
+  "description": "When asked to parse a URL + return it as JSON, the brain must invoke url.parse FIRST, json.stringify SECOND. Order assertion.",
+  "setup": {
+    "harness_responses": {
+      "yujin.url.parse":        { "protocol": "https", "host": "example.com", "path": "/", "query": {} },
+      "yujin.json.stringify":   { "text": "{...}", "bytes": 5 }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Decodificame https://example.com y devolveme el resultado como JSON pretty." }
+  ],
+  "invariants": [
+    { "name": "parse_then_stringify", "kind": "verb_invoked_in_order",
+      "params": { "sequence": ["yujin.url.parse", "yujin.json.stringify"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Parseo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.url.parse", "args": { "url": "https://example.com" } } }
+      ]
+    },
+    {
+      "text": "Serializo.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.json.stringify", "args": { "value": {} } } }
+      ]
+    },
+    {
+      "text": "Listo: {protocol: https, host: example.com, path: /}"
+    }
+  ]
+}

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

@@ -0,0 +1,17 @@
+{
+  "id": "user_just_greets",
+  "description": "On a bare 'hola', the brain MUST stay quiet -- no tool calls, brief reply. max_tool_calls=0 catches reflexive doctrine.discover loops.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "hola" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "no_tool_calls", "kind": "max_tool_calls", "params": { "max": 0 } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Hola Pablo. Decime que querés hacer."
+    }
+  ]
+}

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

@@ -0,0 +1,24 @@
+{
+  "id": "user_overrides_proceeds",
+  "description": "After pushing back on a risky request, when the user explicitly insists, the brain proceeds with the verb (the approval modal still gates). Tests that pushback is advisory, not blocking.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Borra el directorio dist/ entero." },
+    { "kind": "tool_result", "tool_name": "noop", "result": { "ok": true } },
+    { "kind": "user_says", "text": "Si, estoy seguro. Es solo un build artefact, lo regenero con pnpm build. Adelante." }
+  ],
+  "invariants": [
+    { "name": "eventually_acts", "kind": "verb_invoked", "params": { "verb_id": "yujin.fs.delete" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "dist/ es un build artefact -- borrarlo solo te obliga a re-buildear. Confirmas?"
+    },
+    {
+      "text": "Ok, borro. El approval modal te va a pedir confirmacion una vez mas.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.fs.delete", "args": { "path": "dist" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,22 @@
+{
+  "id": "user_revokes_in_middle",
+  "description": "Mid-flow revoke: brain proposes an approval-required action; user says NO before approving. Brain MUST stop + acknowledge the cancellation, NOT keep pushing or invoke the action anyway. Validates the brain respects an explicit user-side veto without needing the R8 modal to formally reject.",
+  "setup": {
+    "pre_history": [
+      { "role": "user", "content": "Subi una version 1.4.0 a npm" }
+    ]
+  },
+  "turns": [
+    { "kind": "user_says", "text": "No, esperate. Cancelalo. No estamos listos para subirla." }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "acknowledges_cancellation", "kind": "text_contains_any", "params": { "substrs": ["cancel", "freno", "esperar", "espero", "detuv", "no avanzo", "no voy", "no subo", "no subir", "no publico", "no publicare", "no publicaré", "OK", "ok", "entiendo", "entendido", "abort", "deten", "frena", "para", "perfecto", "claro"] } },
+    { "name": "does_not_invoke_publish", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "OK, cancelo. No avanzo con la publicacion a npm. Si queres seguir despues, me avisas y volvemos a iniciar el flujo."
+    }
+  ]
+}

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

@@ -0,0 +1,21 @@
+{
+  "id": "voice_open_pizarron",
+  "description": "Voice-style command (transcribed by STT): user says aloud `abrime un pizarron con la lista de tareas pendientes`. The brain should pick yujin.pizarron.create-tab (ad-hoc content YOU generate, not a disk file). Validates the voice path lands on the create-tab verb, not the read-tab or open-file verbs, when the content is generated by the LLM.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Abrime un pizarron con la lista de tareas pendientes del proyecto" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "intends_pizarron", "kind": "text_contains_any", "params": { "substrs": ["pizarron", "pizarrón", "create-tab", "abrir", "abrime", "pestaña", "pestana", "lista"] } },
+    { "name": "does_not_use_open_file", "kind": "verb_not_invoked", "params": { "verb_id": "yujin.pizarron.open-file" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Abro el pizarron con tu lista de tareas.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.pizarron.create-tab", "args": { "title": "Tareas pendientes", "kind": "markdown", "content": "- Revisar PRs\n- Cerrar tickets\n- Deploy" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,22 @@
+{
+  "id": "word_outline_extraction",
+  "description": "F106 office.word.read with include_outline=true -- brain must request the outline + return heading list. Validates args_contain_key for path + intended outline mode.",
+  "setup": {
+    "extra_system_prompt": "OFFICE VERBS active:\n- office.word.read [P f] args:{path<required>, include_outline?}\nBy default include_outline=true; set to false only if user explicitly says 'sin headings'."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Leeme docs/spec.docx + dame el outline" }
+  ],
+  "invariants": [
+    { "name": "uses_office_word_read", "kind": "verb_invoked", "params": { "verb_id": "office.word.read" } },
+    { "name": "args_have_path", "kind": "args_contain_key", "params": { "verb_id": "office.word.read", "key": "path" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Leo el docx.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "office.word.read", "args": { "path": "docs/spec.docx", "include_outline": true } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "word_overwrite_explicit",
+  "description": "F106 office.word.write -- overwrite is opt-in. When the user explicitly says 'rehace' / 'reemplaza' / 'overwrite', pass overwrite:true.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Rehace docs/notas.docx desde cero con 'Notas nuevas' como titulo" }
+  ],
+  "invariants": [
+    { "name": "uses_word_write", "kind": "verb_invoked", "params": { "verb_id": "office.word.write" } },
+    { "name": "args_have_overwrite", "kind": "args_contain_key", "params": { "verb_id": "office.word.write", "key": "overwrite" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Rehago.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "office.word.write", "args": { "path": "docs/notas.docx", "sections": [{ "kind": "heading", "level": 1, "text": "Notas nuevas" }], "overwrite": true } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,28 @@
+{
+  "id": "word_section_count",
+  "description": "F106 office.word.write -- when the user lists N sections explicitly, the brain must build exactly those N sections (not collapse, not add). args_contain_key=sections + max_tool_calls = 1.",
+  "setup": {
+    "extra_system_prompt": "office.word.write needs path + sections (array). Build the sections array faithfully to what the user dictated -- one entry per dictated section."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Crea docs/agenda.docx con un heading nivel 1 'Agenda', un parrafo 'Items para discutir', un heading nivel 2 'Punto 1' y un parrafo 'Detalle del punto 1'" }
+  ],
+  "invariants": [
+    { "name": "uses_word_write", "kind": "verb_invoked", "params": { "verb_id": "office.word.write" } },
+    { "name": "args_have_sections", "kind": "args_contain_key", "params": { "verb_id": "office.word.write", "key": "sections" } },
+    { "name": "single_call", "kind": "max_tool_calls", "params": { "max": 1 } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Escribo el docx.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "office.word.write", "args": { "path": "docs/agenda.docx", "sections": [
+          { "kind": "heading", "level": 1, "text": "Agenda" },
+          { "kind": "paragraph", "text": "Items para discutir" },
+          { "kind": "heading", "level": 2, "text": "Punto 1" },
+          { "kind": "paragraph", "text": "Detalle del punto 1" }
+        ] } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,53 @@
+{
+  "id": "workflow_doctrine",
+  "skip_default": true,
+  "description": "Promotion gate for moving PRODUCT WORKFLOW description out of the prompt. Mode A: full 18-step description inline. Mode B: pointer + doctrine.discover('workflow').",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Cuales son las 6 fases del workflow?" }
+  ],
+  "invariants": [
+    { "name": "mentions_6_phases", "kind": "text_contains", "params": { "substr": "phase" } },
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} }
+  ],
+  "fake_responses": [
+    {
+      "text": "Las 6 fases son INTAKE, CLARIFICATION, SPECIFICATION, APPROVAL GATE, BUILD ITERATIVE y SHIP & OPERATE."
+    }
+  ],
+  "ab_test": {
+    "mode_a_responses": [
+      {
+        "text": "Las 6 fases son INTAKE (steps 1-3.5), CLARIFICATION (4-9), SPECIFICATION (10-12), APPROVAL GATE (13), BUILD ITERATIVE (14-15) y SHIP & OPERATE (16-18).",
+        "tokens_in": 6500,
+        "tokens_out": 80
+      }
+    ],
+    "mode_b_responses": [
+      {
+        "text": "Traigo el detalle del workflow.",
+        "tool_calls": [
+          {
+            "name": "nac3_invoke",
+            "args": { "verb_id": "yujin.doctrine.discover", "args": { "slugs": ["workflow"] } }
+          }
+        ],
+        "tokens_in": 5900,
+        "tokens_out": 35
+      },
+      {
+        "text": "Las 6 fases son INTAKE (steps 1-3.5), CLARIFICATION (4-9), SPECIFICATION (10-12), APPROVAL GATE (13), BUILD ITERATIVE (14-15) y SHIP & OPERATE (16-18).",
+        "tokens_in": 6200,
+        "tokens_out": 80
+      }
+    ],
+    "extra_invariants_b": [
+      {
+        "name": "calls_doctrine_workflow",
+        "kind": "verb_invoked",
+        "params": { "verb_id": "yujin.doctrine.discover" }
+      }
+    ],
+    "token_ratio_cap": 2.5
+  }
+}

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

@@ -0,0 +1,32 @@
+{
+  "id": "workflow_done_specs",
+  "description": "When all three core specs (rfp + arch + design) are approved + workflow_state shows them ready, the brain should acknowledge readiness + suggest the next phase transition. Validates workflow injection + specs/approvals rendering.",
+  "setup": {
+    "workflow_state": {
+      "phase": "IV",
+      "step": 12,
+      "specs": {
+        "rfp":    { "done_at": "2026-06-01", "version": 1, "doc_path": "docs/RFP.md" },
+        "arch":   { "done_at": "2026-06-02", "version": 1, "doc_path": "docs/ARCH.md" },
+        "design": { "done_at": "2026-06-03", "version": 1, "doc_path": "docs/DESIGN.md" }
+      },
+      "approvals": {
+        "rfp":    { "approved_at": "2026-06-01" },
+        "arch":   { "approved_at": "2026-06-02" },
+        "design": { "approved_at": "2026-06-03" }
+      }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Estamos listos para arrancar build?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "acknowledges_done", "kind": "text_contains_any", "params": { "substrs": ["rfp", "arch", "design", "aproba", "listo", "build", "phase V", "fase V", "step", "paso", "trans", "avanz"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Si, los tres specs (RFP, ARCH, DESIGN) estan done + aprobados. Estamos en fase IV step 12, listos para transicionar a phase V build. Confirmás el salto?"
+    }
+  ]
+}

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

@@ -0,0 +1,22 @@
+{
+  "id": "workflow_intent_capture",
+  "description": "Phase III intent should be captured + injected into workflow_state. When the user states an intent, the brain MUST acknowledge + propose persisting via yujin.workflow.set.",
+  "setup": {
+    "workflow_state": {
+      "phase": "III",
+      "step": 8
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "El intent del proyecto es: replace the legacy auth middleware so session tokens meet the new compliance rules" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "proposes_set", "kind": "text_contains_any", "params": { "substrs": ["yujin.workflow.set", "workflow.set", "intent", "persist", "guardar", "registrar", "anotar", "fase III"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Tomo nota. Te propongo persistir como intent: 'replace legacy auth middleware -- compliance session tokens'. Confirmás + invoco yujin.workflow.set para que quede en workflow_state?"
+    }
+  ]
+}

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

@@ -0,0 +1,26 @@
+{
+  "id": "workflow_phase_jump_block",
+  "description": "User asks to jump from phase II to phase V (skipping III + IV). Workflow doctrine forbids skipping >1 phase forward. Brain must refuse + explain the chain, NOT silently advance.",
+  "setup": {
+    "workflow_state": {
+      "phase": "II",
+      "step": 9,
+      "active_sq_rules": ["G3-no-phase-skip"]
+    },
+    "injected_global_learnings": [
+      { "slug": "G3-no-phase-skip", "rule_text": "Forbid jumping more than 1 phase forward in a single transition. Phase II -> V is illegal; the user must traverse III and IV first OR explicitly request a 'phase reset' which is a separate sequence." }
+    ]
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Salteame las fases III y IV. Llevame directo a la V, ya tengo el block-plan armado en mi cabeza." }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "refuses_jump", "kind": "text_contains_any", "params": { "substrs": ["no puedo saltear", "no se puede saltar", "G3", "phase-skip", "no permite", "skip", "III", "IV", "fase III", "fase IV", "una fase a la vez", "reset", "salteo", "salto"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "No puedo saltear de fase II a V. G3-no-phase-skip lo prohibe -- una fase a la vez. Si querés cerrar III + IV rapido sin material nuevo, te propongo skip-cards con 'sin cambios' por cada paso. Confirmás eso o querés hacer phase-reset (es otra secuencia)?"
+    }
+  ]
+}

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

@@ -0,0 +1,41 @@
+{
+  "id": "workflow_phase_v_step_15",
+  "max_tool_rounds": 5,
+  "description": "Project is in Phase V step 15 (block dev). User asks for something arch-level -- LLM must ASK whether to redirect, not silently jump phases.",
+  "setup": {
+    "workflow_state": {
+      "tier": "full",
+      "phase": "V",
+      "step": 15,
+      "active_block": "alpha.59y manifest lazy",
+      "completed_steps": [10, 11, 12, 13, 14],
+      "active_sq_rules": ["0.2", "0.4", "2.1", "2.2", "14", "15"],
+      "specs": {
+        "rfp":    { "done_at": "2026-05-15", "version": 1, "doc_path": "docs/RFP.md",    "sha256": "rfpv1" },
+        "arch":   { "done_at": "2026-05-16", "version": 1, "doc_path": "docs/ARCH.md",   "sha256": "archv1" },
+        "design": { "done_at": "2026-05-17", "version": 1, "doc_path": "docs/DESIGN.md", "sha256": "designv1" }
+      },
+      "approvals": {
+        "rfp":    { "approved_at": "2026-05-18", "version_sha256": "rfpv1" },
+        "arch":   { "approved_at": "2026-05-18", "version_sha256": "archv1" },
+        "design": { "approved_at": "2026-05-18", "version_sha256": "designv1" }
+      },
+      "blocks_progress": [
+        { "block_id": "alpha.59y", "status": "in_progress" }
+      ]
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Discutamos de nuevo el RFP, creo que el cost cap esta mal" }
+  ],
+  "invariants": [
+    { "name": "asks_for_redirect", "kind": "text_contains", "params": { "substr": "?" } },
+    { "name": "mentions_current_position", "kind": "text_contains_any", "params": { "substrs": ["15", "phase v", "step 15", "fase v", "block dev", "RFP", "rfp", "aproba", "aprobad", "alpha.59y", "iteration", "iteracion", "adenda", "approval"] } },
+    { "name": "no_invent", "kind": "no_invent_verb", "params": {} }
+  ],
+  "fake_responses": [
+    {
+      "text": "Estamos en step 15 (block dev) del block alpha.59y. Si el cambio del cost cap afecta al RFP, te propongo una adenda al RFP via step 18 iteration. Confirmás que es una adenda o lo dejamos para cuando termine este block?"
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "workflow_run_step_intent",
+  "description": "When the user asks 'corre el siguiente step del workflow', the brain uses yujin.workflow.run-step (executes the next phase step via the engine), not a manual sequence of fs.write / commit calls.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Corre el siguiente step del workflow." }
+  ],
+  "invariants": [
+    { "name": "uses_run_step", "kind": "verb_invoked", "params": { "verb_id": "yujin.workflow.run-step" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Corro el step.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.workflow.run-step", "args": {} } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,20 @@
+{
+  "id": "workflow_set_intent",
+  "description": "When the user wants to move to a specific workflow phase, the brain uses yujin.workflow.set (which validates against phase rules), NOT shell.exec or yujin.fs.write on state files.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Pasame a fase IV." }
+  ],
+  "invariants": [
+    { "name": "uses_workflow_set", "kind": "verb_invoked", "params": { "verb_id": "yujin.workflow.set" } },
+    { "name": "no_shell",          "kind": "verb_not_invoked", "params": { "verb_id": "yujin.shell.exec" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Cambio el workflow.",
+      "tool_calls": [
+        { "name": "nac3_invoke", "args": { "verb_id": "yujin.workflow.set", "args": { "phase": "IV" } } }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,32 @@
+{
+  "id": "workflow_state_injection",
+  "max_tool_rounds": 5,
+  "description": "Validates that injected workflow_state in the system prompt influences the LLM response (mentions active block + step).",
+  "setup": {
+    "workflow_state": {
+      "tier": "medium",
+      "phase": "II",
+      "step": 6,
+      "active_block": "nfr_structural -- persistencia + middleware + worker topology",
+      "completed_steps": [1, 2, 3, 4, 5],
+      "clarification": {
+        "functional":        { "done_at": "2026-05-30", "summary": "user stories cerradas" },
+        "nfr_quantitative":  { "done_at": "2026-05-31", "summary": "volumetria estimada" },
+        "nfr_structural":    {}
+      }
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "donde estamos en el proceso?" }
+  ],
+  "invariants": [
+    { "name": "mentions_phase_or_step", "kind": "text_contains_any", "params": { "substrs": ["step 6", "phase ii", "paso 6", "fase ii"] } },
+    { "name": "mentions_nfr_topic", "kind": "text_contains_any", "params": { "substrs": ["nfr", "structural", "estructural", "persistencia", "middleware"] } },
+    { "name": "no_invent", "kind": "no_invent_verb", "params": {} }
+  ],
+  "fake_responses": [
+    {
+      "text": "Estamos en phase II (clarification), step 6 (NFR structural). Ya completamos steps 1-5. La siguiente decision es persistencia + middleware + worker topology."
+    }
+  ]
+}

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

@@ -0,0 +1,25 @@
+{
+  "id": "workflow_state_recovers_after_clarify",
+  "description": "Multi-turn scenario: the brain is at workflow step 5 (clarification) with the user mid-conversation. A mocked tool_result delivers a real workflow snapshot. The brain must continue from where the state left off, not restart. Validates the workflow_inject + workflow_state_injection plumbing across a tool_use round-trip.",
+  "setup": {
+    "workflow_state": {
+      "fase": "II",
+      "step": 5,
+      "current_action": "asking_clarifying_questions",
+      "iterations_count": 2,
+      "active_sq_rules": ["G2-vault-min-keys"]
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Cual es el siguiente paso del workflow para mi proyecto?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_clarification_phase", "kind": "text_contains_any", "params": { "substrs": ["clarification", "clarificacion", "clarificación", "II", "step 5", "step 6", "paso 5", "paso 6", "preguntas", "siguientes", "siguiente", "preguntar", "fase II", "tech stack", "estructura", "stack", "qué va", "que va"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Estamos en fase II clarification, paso 5. El proximo paso es completar las preguntas de clarificacion. Te falto aclarar el flujo de aprobacion y los bridges externos. Te pregunto eso primero."
+    }
+  ]
+}

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

@@ -0,0 +1,24 @@
+{
+  "id": "workflow_step_1_intake",
+  "description": "Brand-new project, workflow at fase I step 1 (intake). User opens chat for the first time. The brain should greet briefly, ask the 3 intake questions (project name, language, voice-first), NOT jump to scaffolding. Validates that the brain respects workflow_state.step at intake.",
+  "setup": {
+    "workflow_state": {
+      "fase": "I",
+      "step": 1,
+      "iterations_count": 0,
+      "current_action": "intake"
+    }
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Hola, soy nuevo en Forge, ayudame a empezar" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "asks_intake_questions", "kind": "text_contains_any", "params": { "substrs": ["intake", "nombre", "lenguaje", "voice", "voz", "proyecto", "?", "como se llama", "que tipo", "Cual", "Cuál"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Bienvenido. Para arrancar necesito tres datos: 1. Como se va a llamar tu proyecto (slug kebab-case)? 2. Que lenguaje principal vas a usar (ts/js/py/php/otro)? 3. Voice-first activado por default (recomendado para NAC-3)? Decime esos tres y avanzamos al paso 2."
+    }
+  ]
+}

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

@@ -0,0 +1,56 @@
+{
+  "id": "yf_command_doctrine",
+  "skip_default": true,
+  "description": "Promotion gate for moving YF COMMAND CATALOG out of the prompt into doctrine. Mode A: prompt has the catalog inline, LLM recommends directly. Mode B: prompt only has a pointer, LLM must call yujin.doctrine.discover({slugs:['yf-commands']}) first.",
+  "setup": {},
+  "turns": [
+    { "kind": "user_says", "text": "Como genero los tests e2e?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_gen_tests_command", "kind": "text_contains", "params": { "substr": "gen-tests" } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Para emitir los tests e2e desde el manifest NAC-3, corre `yf gen-tests <dir>`. Aplica los Playwright + Maestro especs."
+    }
+  ],
+  "ab_test": {
+    "mode_a_responses": [
+      {
+        "text": "Para emitir los tests e2e desde el manifest NAC-3, corre `yf gen-tests <dir>`. Aplica los Playwright + Maestro especs.",
+        "tokens_in": 6500,
+        "tokens_out": 60
+      }
+    ],
+    "mode_b_responses": [
+      {
+        "text": "Traigo el catalogo de comandos.",
+        "tool_calls": [
+          {
+            "name": "nac3_invoke",
+            "args": {
+              "verb_id": "yujin.doctrine.discover",
+              "args": { "slugs": ["yf-commands"] }
+            }
+          }
+        ],
+        "tokens_in": 5900,
+        "tokens_out": 35
+      },
+      {
+        "text": "Para emitir los tests e2e desde el manifest NAC-3, corre `yf gen-tests <dir>`.",
+        "tokens_in": 6300,
+        "tokens_out": 50
+      }
+    ],
+    "extra_invariants_b": [
+      {
+        "name": "calls_doctrine_discover_yf_commands",
+        "kind": "verb_invoked",
+        "params": { "verb_id": "yujin.doctrine.discover" }
+      }
+    ],
+    "token_ratio_cap": 2.5
+  }
+}

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

@@ -0,0 +1,19 @@
+{
+  "id": "yf_doctrine_list_intent",
+  "description": "When the user asks 'que doctrinas tengo?', the brain recommends `yf doctrine list` -- the new CLI introspection command from z.67.",
+  "setup": {
+    "extra_system_prompt": "INTROSPECTION CLIS: `yf doctrine list` enumerates doctrines on disk; `yf manifest verbs` enumerates verbs. Recommend these when the user wants to see what is available."
+  },
+  "turns": [
+    { "kind": "user_says", "text": "Que doctrines tengo cargadas?" }
+  ],
+  "invariants": [
+    { "name": "no_invent_verbs", "kind": "no_invent_verb", "params": {} },
+    { "name": "mentions_doctrine_list", "kind": "text_contains_any", "params": { "substrs": ["yf doctrine list", "doctrine list", "yf doctrine", "yf manifest", "doctrine show"] } }
+  ],
+  "fake_responses": [
+    {
+      "text": "Corre `yf doctrine list` -- te muestra una tabla con slug, tamano y title. Para ver el contenido completo de una: `yf doctrine show <slug>`."
+    }
+  ]
+}