diff --git a/.agents/shell/worktree.sh b/.agents/shell/worktree.sh index 169d16d4..6c07e5d3 100644 --- a/.agents/shell/worktree.sh +++ b/.agents/shell/worktree.sh @@ -7,16 +7,17 @@ # shell que o chamou. # # No terminal (esta função), o script também imprime a diretiva `launch -# opencode
-` sempre uppercase-led). `new` é o irmão **neutro** (sem função pré-definida — explorar ideia, conversar, planejar sem registrar): mesma semântica de "um DIFERENTE por invocação", branch `work/` (sufixo `-2`/`-3` em colisão) ou `work/` sequencial, prefixo `work/…` que não colide com `next` nem `plan`. O fluxo desta skill (fila → próxima Issue → implementação) é só `next`.
-**Default-go:** `next`, `plan` e `new` imprimem `cd ` na última linha **por padrão**; `--stay` suprime; modelos por invocação via `--cheap/--pro/--zen/--go/--alibaba` (mapa fixo `WORKTREE_MODEL_MAP`, at-most-one; sem flag o preset permanece); `--go` remapeado em OPS93 para `opencode-go/mimo-v2.5` (antes no-op do OPS24). No terminal interativo, use a função `worktree()` de **`.agents/shell/worktree.sh`** (uma linha de `source` no profile) para o `cd` ser aplicado de verdade no shell que te chamou — node não consegue mudar o cwd do shell pai. `kill` também imprime `cd ` no fim (a sessão nunca fica num diretório destruído).
+**Default-go:** `next`, `plan` e `new` imprimem `cd ` na última linha **por padrão**; `--stay` suprime; modelos por invocação via `--cheap/--pro/--zen/--go/--alibaba` (mapa fixo `WORKTREE_MODEL_MAP`, at-most-one; sem flag o preset permanece); `--go` remapeado em OPS93 para o provider OpenCode Go e em OPS95 para `opencode-go/hy3` (antes no-op do OPS24). No terminal interativo, use a função `worktree()` de **`.agents/shell/worktree.sh`** (uma linha de `source` no profile) para o `cd` ser aplicado de verdade no shell que te chamou — node não consegue mudar o cwd do shell pai. `kill` também imprime `cd ` no fim (a sessão nunca fica num diretório destruído).
-**Launch do opencode (OPS26 + OPS33 + OPS31 + OPS93):** só a função shell marca `TEQO_WORKTREE_TERMINAL=1`; com o marcador, `next`/`plan`/`new` imprimem também a diretiva `launch opencode --model --variant max --auto [--prompt "/work-issue --issue "]` **antes** do `cd`, e a função a executa depois do cd — `next` abre o TUI com `/work-issue --issue ` já enviado (a Issue claimada vai no prompt; a skill lê o resto do GitHub) em `--variant max` (sempre, falha alto se a variante não existir); `plan` abre com `/plan-issue` já enviado (OPS31: o TUI já cai no fluxo de planejamento); `new` abre sem `--prompt` ("apenas conversar"). Modelo por invocação via `--cheap` (cheapestinference/deepseek-v4-flash), `--pro` (opencode-go/qwen3.7-max), `--zen` (opencode-go/ox-alpha-free), `--go` (opencode-go/mimo-v2.5), `--alibaba` (alibaba-token-plan/qwen3.7-max); sem flag o preset `deepseek/deepseek-v4-flash` permanece; variantes low/high/max do model override na config global do opencode (`~/.config/opencode/opencode.jsonc`), selecionáveis no TUI e sticky por model. Sem `exec`: sair do opencode volta ao shell no worktree. Presets e mapa são constantes em `scripts/lib/worktree.mjs`. **O comando `/worktree` do opencode (e qualquer automação sem o marcador) nunca lança o TUI.**
+**Launch do opencode (OPS26 + OPS33 + OPS31 + OPS93 + OPS95):** só a função shell marca `TEQO_WORKTREE_TERMINAL=1`; com o marcador, `next`/`plan`/`new` imprimem também a diretiva `launch opencode --model --auto [--prompt "/work-issue --issue "]` **antes** do `cd`, e a função a executa depois do cd — `next` abre o TUI com `/work-issue --issue ` já enviado (a Issue claimada vai no prompt; a skill lê o resto do GitHub); `plan` abre com `/plan-issue` já enviado (OPS31: o TUI já cai no fluxo de planejamento); `new` abre sem `--prompt` ("apenas conversar"). Sem `--variant` na diretiva (OPS95: o yargs do TUI rejeita o flag desconhecido e só imprime o helper — variantes ficam na config global do opencode, selecionáveis via Ctrl+T; `opencode run --variant max` segue sendo a via CLI para runs headless). Modelo por invocação via `--cheap` (cheapestinference/deepseek-v4-flash), `--pro` (deepseek/deepseek-v4-pro), `--zen` (opencode-go/ox-alpha-free), `--go` (opencode-go/hy3), `--alibaba` (alibaba-token-plan/deepseek-v4-flash) — valores corrigidos no OPS95; sem flag o preset `deepseek/deepseek-v4-flash` permanece. Sem `exec`: sair do opencode volta ao shell no worktree. Presets e mapa são constantes em `scripts/lib/worktree.mjs`. **O comando `/worktree` do opencode (e qualquer automação sem o marcador) nunca lança o TUI.**
## Fluxo quando invocado como skill (agentes que não têm opencode)
diff --git a/.opencode/commands/worktree.md b/.opencode/commands/worktree.md
index 1d18284c..0338c148 100644
--- a/.opencode/commands/worktree.md
+++ b/.opencode/commands/worktree.md
@@ -4,11 +4,11 @@ description: Claima a próxima Issue (next [--issue N] [--stay] [--cheap|--pro|-
Rode o script determinístico abaixo (não improvise a lógica) e reporte o resultado de forma concisa.
-- `next [--issue N] [--stay] [--cheap|--pro|--zen|--go|--alibaba]`: **claima** a próxima Issue claimável da fila (mesma fila/ordem e lock otimista de `pnpm agent:claim`) e cria (ou reutiliza) o worktree dela. Claim falhou → reporte o motivo — não há worktree. `--issue N` claima a Issue direcionada (`ready`) ou **reabre** uma já claimada (`in-progress`, sem re-claim). A saída avisa "já claimada — NÃO rodar `pnpm agent:claim`". Por padrão o script imprime `cd ` na última linha — aplique-o na sessão de shell atual (`cd `) e reporte o novo diretório. `--stay` suprime o `cd` (não troque de diretório) mas o claim ainda acontece. `--cheap/--pro/--zen/--go/--alibaba` escolhe o modelo por invocação no mapa fixo `WORKTREE_MODEL_MAP` (cheap=cheapestinference/deepseek-v4-flash, pro=opencode-go/qwen3.7-max, zen=opencode-go/ox-alpha-free, go=opencode-go/mimo-v2.5, alibaba=alibaba-token-plan/qwen3.7-max) com `--variant max` sempre; at-most-one (múltiplas → erro).
+- `next [--issue N] [--stay] [--cheap|--pro|--zen|--go|--alibaba]`: **claima** a próxima Issue claimável da fila (mesma fila/ordem e lock otimista de `pnpm agent:claim`) e cria (ou reutiliza) o worktree dela. Claim falhou → reporte o motivo — não há worktree. `--issue N` claima a Issue direcionada (`ready`) ou **reabre** uma já claimada (`in-progress`, sem re-claim). A saída avisa "já claimada — NÃO rodar `pnpm agent:claim`". Por padrão o script imprime `cd ` na última linha — aplique-o na sessão de shell atual (`cd `) e reporte o novo diretório. `--stay` suprime o `cd` (não troque de diretório) mas o claim ainda acontece. `--cheap/--pro/--zen/--go/--alibaba` escolhe o modelo por invocação no mapa fixo `WORKTREE_MODEL_MAP` (cheap=cheapestinference/deepseek-v4-flash, pro=deepseek/deepseek-v4-pro, zen=opencode-go/ox-alpha-free, go=opencode-go/hy3, alibaba=alibaba-token-plan/deepseek-v4-flash); at-most-one (múltiplas → erro).
- `plan [bag] [--stay] [--cheap|--pro|--zen|--go|--alibaba]`: cria um worktree de planejamento **diferente a cada invocação** (branch `plans/plan-issue-`, ou `plans/plan-issue-` sequencial sem bag; sufixo `-2`/`-3` em colisão) para rodar `/plan-issue` sem ocupar o main; nunca conflita com `next`. Não claima nada. Mesmo contrato de `cd` do `next`: aplique a última linha `cd ` por padrão; `--stay` suprime; flag de modelo como no `next`.
- `new [bag] [--stay] [--cheap|--pro|--zen|--go|--alibaba]`: cria um worktree **neutro** (sem função pré-definida — explorar ideia, conversar, planejar sem registrar nada) **diferente a cada invocação** (branch `work/`, ou `work/` sequencial sem bag; sufixo `-2`/`-3` em colisão); o prefixo minúsculo `work/…` nunca conflita com `next` nem `plan`. Não claima nada. Mesmo contrato de `cd` do `plan`: aplique a última linha `cd ` por padrão; `--stay` suprime; flag de modelo como no `next`.
- `kill [--force]`: destrói o worktree em que você está e remove seus bancos. O script imprime `cd ` na última linha — aplique-o (`cd `) para a sessão sair do diretório destruído.
-> **Este comando roda SEM o marcador `TEQO_WORKTREE_TERMINAL`, então nunca recebe a diretiva `launch`** — só o `cd`. O launch do opencode (OPS26/OPS33+OPS93, com `--variant max`) acontece apenas na função `worktree()` de `.agents/shell/worktree.sh` (terminal interativo); nunca abra um TUI aninhado a partir daqui.
+> **Este comando roda SEM o marcador `TEQO_WORKTREE_TERMINAL`, então nunca recebe a diretiva `launch`** — só o `cd`. O launch do opencode (OPS26/OPS33+OPS93+OPS95, sem `--variant` — o TUI rejeita o flag) acontece apenas na função `worktree()` de `.agents/shell/worktree.sh` (terminal interativo); nunca abra um TUI aninhado a partir daqui.
!`node scripts/worktree.mjs $ARGUMENTS`
diff --git a/docs/changelog/2026-08-24-ops95.md b/docs/changelog/2026-08-24-ops95.md
new file mode 100644
index 00000000..76cb25ea
--- /dev/null
+++ b/docs/changelog/2026-08-24-ops95.md
@@ -0,0 +1 @@
+**OPS95 — Corrigir mapa de modelos e launch do worktree CLI, follow-up OPS93 (2026-08-24):** `opencodeLaunchDirective` deixa de emitir `--variant max` — o yargs do TUI do opencode rejeita o flag desconhecido e saía no helper em vez de abrir (quebra incondicional do OPS93 em next/plan/new); `WORKTREE_VARIANT` eliminada e o conceito "effort max na diretiva" sai junto (variantes ficam na config global da máquina via Ctrl+T; `opencode run --variant max` segue a via headless). Mapa `WORKTREE_MODEL_MAP` corrigido no GATE para os IDs pedidos: pro=deepseek/deepseek-v4-pro, go=opencode-go/hy3, alibaba=alibaba-token-plan/deepseek-v4-flash (cheap/zen mantidos); chaves, preset e guardrail at-most-one intactos. As 7 superfícies que citam o mapa/diretiva sincronizadas na mesma entrega (`scripts/lib/worktree.mjs`, `scripts/worktree.mjs` docblock/help incl. resquício "`--go` é no-op" do kill, `.agents/shell/worktree.sh`, `.opencode/commands/worktree.md`, skills `worktree-next-issue` e `local-database`) + pins de `tests/unit/worktree.unit.spec.ts`.
diff --git a/docs/plans/worktree-flags-modelo-correcao-impl.md b/docs/plans/worktree-flags-modelo-correcao-impl.md
new file mode 100644
index 00000000..812577ce
--- /dev/null
+++ b/docs/plans/worktree-flags-modelo-correcao-impl.md
@@ -0,0 +1,108 @@
+# Impl: Corrigir mapa de modelos e launch do worktree CLI (follow-up OPS93)
+
+Status: rascunho
+Atualizado em: 2026-08-24
+Issue: #876
+Intenção: docs/plans/worktree-flags-modelo-correcao.md
+Appetite restante: ~0,5 dia (herdado)
+
+## Leitura da intenção
+
+- **Outcome:** `pnpm worktree next/plan/new` volta a abrir o TUI sozinho (`--variant` sai da diretiva — o yargs do TUI rejeita o flag desconhecido) e as 5 flags apontam para o mapa de modelos corrigido; as superfícies que citam o mapa/diretiva saem sincronizadas na mesma entrega; sem flag, preset `deepseek/deepseek-v4-flash` intacto.
+- **O que NÃO negociar:** cardápio fechado de 5 flags (`--cheap|--pro|--zen|--go|--alibaba`, mesmas chaves); preset sem flag; sem persistência de preferência; sem tocar `/work-issue`/`plan-issue`; sem editar config global de variantes da máquina via repo; fora do terminal interativo (`TEQO_WORKTREE_TERMINAL≠1`) as flags continuam irrelevantes.
+- **O que reavaliar:** hipótese de direção confirmada linha a linha pelo explorador (ver abaixo). O mapa-alvo não estava registrado por escrito em nenhum artefato acessível (#876/#859, planos OPS93) — foi fornecido e travado pelo humano no GATE desta entrega; tabela na decisão 2 abaixo.
+
+## Estado atual verificado (explorador)
+
+- `scripts/lib/worktree.mjs`: mapa L43-49 (`cheap=cheapestinference/deepseek-v4-flash`, `pro=opencode-go/qwen3.7-max`, `zen=opencode-go/ox-alpha-free`, `go=opencode-go/mimo-v2.5`, `alibaba=alibaba-token-plan/qwen3.7-max`); `WORKTREE_VARIANT='max'` L54-55; docblocks L40-41 e L171-177 citam `--variant max`; erro de conflito lista flags L66; diretiva monta `[dir,'--model',selectedModel,'--variant',WORKTREE_VARIANT,'--auto']` em **L198**; preset L34-35 (`deepseek/deepseek-v4-flash`, override `OPENCODE_WORKTREE_MODEL`).
+- `scripts/worktree.mjs`: importa `WORKTREE_VARIANT` (bloco L147-156); consumo via `resolveLaunchModel` L169-176 → `printLaunchDirective` L178-189; docblock/help citam mapa+variant em L22-29, L33-34, L39, L73, L88, L809, L811, L821, L824, L830, L842, L850; **resquício**: help L101 ainda diz "`--go` é no-op" (OPS24 — stale desde o remapeamento do OPS93).
+- `.agents/shell/worktree.sh`: L10, L15-19 (mapa + `--variant max`), L50 (`--go` mimo-v2.5).
+- `.opencode/commands/worktree.md`: L7 (mapa + "`--variant max` sempre"), L12 (diretiva com variant).
+- `.agents/skills/worktree-next-issue/SKILL.md`: L32, L34. `.agents/skills/local-database/SKILL.md`: L29.
+- `tests/unit/worktree.unit.spec.ts`: pins L160-218 (~10 expects com `'--variant ${WORKTREE_VARIANT}'` embutido), L195-204 (`expect(WORKTREE_VARIANT).toBe('max')`), L234-241 (`toEqual` do mapa), L251-256 (flags), L267-282 (diretiva por flag).
+- Consumidores do mapa: único `resolveWorktreeModel` (lib L62-71) ← `scripts/worktree.mjs:172`. Nada exporta `WORKTREE_VARIANT` para env/shell. `tests/unit/opencodeCommands.unit.spec.ts` não é afetado (anti-goal — não mexer).
+- Blast radius: `scripts/worktree.mjs` está em `HIGH_RISK_EXACT` (`scripts/lib/test-affected-core.mjs:36`; pin espelho `tests/unit/testAffected.unit.spec.ts:28`) → diff nele = unit/int full + e2e curado no PR. `scripts/lib/worktree.mjs` NÃO é high-risk.
+- Catálogo local (explorador): `opencode-go` tem `ox-alpha-free` ✓ `qwen3.7-max` ✓ `mimo-v2.5` ✓; `alibaba-token-plan` tem `qwen3.7-max` ✓; `cheapestinference` serve modelos pela config da máquina (`deepseek-v4-flash`, `mimo-v2.5`); **não existe** provider `opencode-zen` (gate da intenção confirmou `--zen` → `opencode-go/ox-alpha-free` — igual ao atual).
+
+## Abordagem recomendada
+
+```mermaid
+flowchart LR
+ PINS["tests/unit/worktree.unit.spec.ts\npins novos (sem variant, mapa GATE)"] --> LIB["scripts/lib/worktree.mjs\nmapa values + remove WORKTREE_VARIANT\ndiretiva L198 sem --variant"] LIB --> CLI["scripts/worktree.mjs\nimport/help/docblock"]
+ CLI --> SURF[".agents/shell/worktree.sh\n.opencode/commands/worktree.md\n2 skills"]
+ SURF --> GATES["pnpm test:unit -t worktree\npnpm gate:fast\nsmoke terminal"]
+```
+
+**Opções consideradas:** A | B | C
+**Recomendação:** A — remoção incondicional de `--variant`/`WORKTREE_VARIANT` + troca dos **values** do mapa existente; assinaturas (`resolveWorktreeModel`, `opencodeLaunchDirective({dir,purpose,terminal,issueNumber,model})`), chaves de flags e preset intactos; 7 superfícies de texto sincronizadas num único lote. Cabe no appetite (~2 arquivos de lógica + 5 de doc/skill + 1 spec), não cria módulo novo (depth check: o dono do concern já existe), e a diretiva volta ao formato que o TUI aceita.
+
+**Rejeitadas:**
+
+- **B — emitir `--variant` condicionalmente** (só quando o modelo expuser variante): reintroduz o conceito que caiu com a premissa falsa do OPS93; exigiria catálogo de variants no repo (anti-goal: config global é assunto da máquina, OPS78/OPS89) e complexidade sem pedido. O "effort max" morre junto com a premissão — variantes seguem selecionáveis via Ctrl+T no TUI e `--variant max` segue vivo só no `opencode run` headless.
+- **C — reescrever a resolução de modelo** (nova função/módulo para o mapa): twinning do `resolveWorktreeModel`/`WORKTREE_MODEL_MAP` existentes; rejeitada — editar o dono do concern, não criar paralelo.
+
+### Decisões de engenharia (com rejeitadas)
+
+1. **Remoção incondicional do `--variant` na diretiva do TUI**
+ - Opções: A) remover sempre | B) condicional ao modelo | C) mover variante para config do repo.
+ - Recomendação: A — a quebra é incondicional (o TUI nunca aceita `--variant`); B/C reabrem o laboratório de variantes cortado pela intenção (rabbit hole nomeado).
+ - Forma: args volta a `[dir,'--model',selectedModel,'--auto']` (+ `--prompt` quando houver); constante `WORKTREE_VARIANT` eliminada (export + import em `scripts/worktree.mjs` + todos os pins).
+
+2. **Mapa-alvo (confirmado pelo humano no GATE de 2026-08-24; IDs validados contra o catálogo local)**
+
+ | Flag | Valor atual (OPS93 entregue) | Alvo (GATE) |
+ | ----------- | ------------------------------------- | ------------------------------------------------ |
+ | `--cheap` | `cheapestinference/deepseek-v4-flash` | `cheapestinference/deepseek-v4-flash` _(mantém)_ |
+ | `--pro` | `opencode-go/qwen3.7-max` | `deepseek/deepseek-v4-pro` |
+ | `--zen` | `opencode-go/ox-alpha-free` | `opencode-go/ox-alpha-free` _(mantém)_ |
+ | `--go` | `opencode-go/mimo-v2.5` | `opencode-go/hy3` |
+ | `--alibaba` | `alibaba-token-plan/qwen3.7-max` | `alibaba-token-plan/deepseek-v4-flash` |
+ - Fecha a conta da intenção: três modelos corrigidos (`--pro`, `--go`, `--alibaba`) e um provider questionado (`--pro`: sai de `opencode-go`, vai ao provider `deepseek`); `--cheap`/`--zen` permanecem.
+ - Restrição estrutural: só **values** mudam; chaves, `WORKTREE_MODEL_FLAGS` derivado e preset ficam intactos.
+ - Validação de catálogo (feita): `deepseek/deepseek-v4-pro` ✓, `opencode-go/hy3` ✓, `alibaba-token-plan/deepseek-v4-flash` ✓, `cheapestinference/deepseek-v4-flash` ✓ (config da máquina), `opencode-go/ox-alpha-free` ✓.
+
+3. **Sincronização das 7 superfícies + resquício do help**
+ - As 7 da intenção: docblocks/mapa em `scripts/lib/worktree.mjs`, docblock/help em `scripts/worktree.mjs`, `.agents/shell/worktree.sh`, `.opencode/commands/worktree.md`, `.agents/skills/worktree-next-issue/SKILL.md`, `.agents/skills/local-database/SKILL.md`, pins de teste.
+ - Inclui também o help L101 de `scripts/worktree.mjs` ("`--go` é no-op" — stale do OPS24 dentro do bloco de ajuda do `kill`): sai na mesma entrega porque é o mesmo contrato de mapa/divergência documental que a intenção manda encerrar (precedente OPS24: contrato documentado em todas as superfícies na mesma entrega). Textos citando `--variant max`/effort viram descrição do mapa sem variant; menção a variantes passa a apontar Ctrl+T/config global (fora do repo).
+ - `.opencode/agent/designer-campanha-solla.md:64` e `design-vision.md:15` citam `opencode-go/mimo-v2.5` como fallback de visão — **fora do escopo** (não são parte do mapa/diretiva; nada quebra).
+
+### Componentes / mudanças
+
+- **`scripts/lib/worktree.mjs`**: values do `WORKTREE_MODEL_MAP` (tabela GATE); delete `WORKTREE_VARIANT` (L54-55); `opencodeLaunchDirective` L198 sem `--variant`; docblocks L40-41/L171-177 descrevendo o mapa novo e sem variant.
+- **`scripts/worktree.mjs`**: remover import/usos de `WORKTREE_VARIANT`; docblock (L22-39, L73, L88) e help (L809-850, incl. L101 do `kill`) atualizados.
+- **`.agents/shell/worktree.sh`**, **`.opencode/commands/worktree.md`**, **2 skills**: textos espelhos do mesmo contrato.
+- **`tests/unit/worktree.unit.spec.ts`**: remover pins de `WORKTREE_VARIANT`/`'--variant'`; nova pinagem da diretiva (`--model X --auto [--prompt …]`) e do mapa GATE; suite de flags/exclusividade intacta em estrutura.
+- **Migration:** sem migration — tooling pura. **Access/Consent:** N/A. **UI:** Impeccable A — sem superfície de produto.
+
+## Fases verificáveis
+
+1. **Pins primeiro (TDD)** — atualizar `tests/unit/worktree.unit.spec.ts` para o contrato-alvo (diretiva sem `--variant`, mapa GATE confirmado); rodar e ver vermelho. Quota ~25%.
+2. **Lib** — `scripts/lib/worktree.mjs`: mapa + remoção do variant + docblocks; unit verde. Quota ~25%.
+3. **CLI + superfícies** — `scripts/worktree.mjs` (import/help/docblock/incl. L101) + shell + command + 2 skills, num único lote de sincronização. Quota ~30%.
+4. **Gates + entrega** — `pnpm test:unit -t worktree`; `pnpm gate:fast`; smoke `TEQO_WORKTREE_TERMINAL=1 node scripts/worktree.mjs next --stay` (diretiva impressa sem `--variant`, modelo do flag escolhido; múltiplas flags continua falhando alto); changelog NOVA entrada `docs/changelog/-ops95.md`; `pnpm push` → PR `Closes #876` (HIGH_RISK_EXACT dispara unit/int full + e2e curado no CI). Quota ~20%.
+
+## Rabbit holes / Não escopo (engenharia)
+
+- Reabrir o mapa além da tabela GATE (trocar `--cheap`/`--zen`, aceitar `provider/model` livre, cardápio novo).
+- Reintroduzir effort/variante por outra via (env por worktree, `opencode.json` do repo, config global via commit) — variantes vivem na máquina (Ctrl+T; `opencode run --variant max` para headless).
+- Mudar preset, chaves de flags, prompts ou pins de `tests/unit/opencodeCommands.unit.spec.ts`.
+- Editar planos/changelog históricos (OPS93 imutável; entrada nova em `docs/changelog/`).
+- Estender o cardápio ou aceitar `provider/model` livre.
+- `.opencode/agent/designer-campanha-solla.md` e `design-vision.md` citam `opencode-go/mimo-v2.5` como fallback de visão (fora do mapa/diretiva; nada quebra). **Deferido com gatilho:** atualizar na próxima troca de mapa de modelos ou edição desses docs (mesma classe de drift texto↔código desta entrega).
+
+## Riscos e mitigação
+
+- **HIGH_RISK_EXACT (`scripts/worktree.mjs`)** → PR roda unit/int full + e2e curado; mitigação: tocar só import/docblock/help, sem `provision`/claim/PORT/env.
+- **Divergência de contrato nas 7 superfícies de texto (+ resquício do help do kill)** → mitigação: lote único (Fase 3) + grep final por `--variant`/`WORKTREE_VARIANT`/valores antigos do mapa zerando fora de histórico imutável.
+- **Suíte herdar `OPENCODE_WORKTREE_MODEL`** (`presetInEffect()` lê env) → mitigação: manter padrão existente do spec; rodar unit no ambiente limpo do gate.
+- **ID do mapa GATE sumir do catálogo da máquina no futuro** → mitigação: IDs validados hoje; smoke imprime a diretiva e o uso real falha alto/visível — se um provider mudar, vira correção futura, não commit de catálogo.
+
+## Aceite de engenharia
+
+- [ ] Aceite de produto coberto: TUI abre sozinho nas invocações com/sem flag; 5 flags → mapa corrigido; sem flag → preset; fora do terminal inalterado; 7 superfícies sincronizadas.
+- [ ] Invariantes: sem collection/migration/PII/Consent; identificadores em inglês; sem ciclo; editado o dono do concern (sem twin).
+- [ ] Testes: unit pins do mapa + diretiva (TDD); `pnpm gate:fast` verde; smoke de terminal registrado no PR.
+
+---
+
+Self-score decision-quality: 5/5 — decisões caras com rejeitadas (remoção incondicional; values-only; sync única); cabe no appetite; rabbit holes nomeados (inventar mapa é bloqueado pelo GATE); reusa `WORKTREE_MODEL_MAP`/`resolveWorktreeModel`/`opencodeLaunchDirective` sem twinning; outcome da intenção preservado.
diff --git a/scripts/lib/worktree.mjs b/scripts/lib/worktree.mjs
index 393ed1a9..b48c5924 100644
--- a/scripts/lib/worktree.mjs
+++ b/scripts/lib/worktree.mjs
@@ -29,31 +29,33 @@ export const WORKTREE_TERMINAL_ENV = 'TEQO_WORKTREE_TERMINAL'
* em 24/08/2026) e porque unificar o default reduz a sobrescrita confusa de
* seleção de modelo do TUI (opencode issues #8349/#13456). OPS93: com
* `--cheap/--pro/--zen/--go/--alibaba` o mapa `WORKTREE_MODEL_MAP` escolhe o
- * modelo por invocação; sem flag o preset permanece.
+ * modelo por invocação; sem flag o preset permanece. OPS95: sem `--variant`
+ * na diretiva (o TUI rejeita o flag) — variantes ficam na config global da
+ * máquina, via Ctrl+T.
*/
export const OPENCODE_PRESET_MODEL =
process.env.OPENCODE_WORKTREE_MODEL || 'deepseek/deepseek-v4-flash'
/**
- * Per-invocation model map — fixed menu of 5 named flags (OPS93). The
+ * Per-invocation model map — fixed menu of 5 named flags (OPS93; values
+ * corrected in OPS95 after the OPS93 delivery shipped wrong IDs). The
* directive picks `WORKTREE_MODEL_MAP[flag]` when a single flag is present,
- * otherwise falls back to `OPENCODE_PRESET_MODEL`. Always launched with
- * `--variant max` (fail-high if the target model doesn't expose the variant).
+ * otherwise falls back to `OPENCODE_PRESET_MODEL`. No `--variant` is emitted
+ * (the TUI yargs rejects the flag — OPS95): variants live on the machine's
+ * global config, selectable via Ctrl+T (`opencode run --variant max` remains
+ * the headless path).
*/
export const WORKTREE_MODEL_MAP = {
cheap: 'cheapestinference/deepseek-v4-flash',
- pro: 'opencode-go/qwen3.7-max',
+ pro: 'deepseek/deepseek-v4-pro',
zen: 'opencode-go/ox-alpha-free',
- go: 'opencode-go/mimo-v2.5',
- alibaba: 'alibaba-token-plan/qwen3.7-max',
+ go: 'opencode-go/hy3',
+ alibaba: 'alibaba-token-plan/deepseek-v4-flash',
}
/** Set of flag names that select a model (keys of WORKTREE_MODEL_MAP). */
export const WORKTREE_MODEL_FLAGS = new Set(Object.keys(WORKTREE_MODEL_MAP))
-/** Variant always used for worktree launches — effort max (OPS78 guardrail). */
-export const WORKTREE_VARIANT = 'max'
-
/**
* Resolve the model for a parsed `flags` bag (from `parseArgs`). At most one
* model flag may be present — multiple → throw (fail-high, never guess).
@@ -172,8 +174,9 @@ const namespaceBranchName = ({ prefix, bag = '', taken = new Set(), fallback })
* Launch directive for the opencode TUI, printed by `worktree next`/`plan`
* right before the `cd ` line when called from the interactive terminal
* (`WORKTREE_TERMINAL=1`): `launch opencode --model
- * --variant max --auto [--prompt ""]` (OPS93: `--variant max` sempre;
- * modelo vem do mapa `WORKTREE_MODEL_MAP` quando a flag `--cheap/--pro/--zen/
+ * --auto [--prompt ""]` (OPS95: no `--variant` — the TUI yargs
+ * rejects the unknown flag and the helper prints instead of opening; modelo
+ * vem do mapa `WORKTREE_MODEL_MAP` quando a flag `--cheap/--pro/--zen/
* --go/--alibaba` está presente, senão do preset). The shell function
* (`.agents/shell/worktree.sh`) applies the `cd` first, then tokenizes and
* executes this line (xargs — quote-aware, never eval) — the dir is always
@@ -195,7 +198,7 @@ export const opencodeLaunchDirective = ({
if (!terminal) return null
const prompt = OPENCODE_SKILL_COMMAND_BY_PURPOSE[purpose]
const selectedModel = model ?? OPENCODE_PRESET_MODEL
- const args = [dir, '--model', selectedModel, '--variant', WORKTREE_VARIANT, '--auto']
+ const args = [dir, '--model', selectedModel, '--auto']
if (prompt) {
// The issue suffix belongs to `next` alone — `plan`/`new` never carry a
// claimed issue (fail-safe: a stray issueNumber must not break /plan-issue).
diff --git a/scripts/worktree.mjs b/scripts/worktree.mjs
index b9ee8691..9d65509a 100644
--- a/scripts/worktree.mjs
+++ b/scripts/worktree.mjs
@@ -22,22 +22,25 @@
* acontece); `--cheap/--pro/--zen/--go/--alibaba`
* escolhe o modelo por invocação no mapa fixo
* `WORKTREE_MODEL_MAP` (cheap=cheapestinference/
- * deepseek-v4-flash, pro=opencode-go/qwen3.7-max,
+ * deepseek-v4-flash, pro=deepseek/deepseek-v4-pro,
* zen=opencode-go/ox-alpha-free, go=opencode-go/
- * mimo-v2.5, alibaba=alibaba-token-plan/qwen3.7-max)
- * com `--variant max` sempre (OPS93; sem flag o
- * preset `deepseek/deepseek-v4-flash` permanece).
+ * hy3, alibaba=alibaba-token-plan/deepseek-v4-flash;
+ * OPS95) — sem flag o preset
+ * `deepseek/deepseek-v4-flash` permanece.
* Chamado do terminal interativo (com
* `TEQO_WORKTREE_TERMINAL=1`, que só a função shell
* seta), imprime também a diretiva `launch
- * opencode --model --variant max
+ * opencode --model
* --auto --prompt "/work-issue --issue "` ANTES
* do `cd` — a função shell executa o cd e então a
* linha, e o TUI do opencode abre no worktree com
* `/work-issue --issue ` já enviado (OPS26 +
* OPS33: o launch entrega a Issue claimada ao
- * agente; a skill lê o resto do GitHub) em effort
- * max. Presets e mapa em scripts/lib/worktree.mjs.
+ * agente; a skill lê o resto do GitHub). OPS95:
+ * sem `--variant` na diretiva — o yargs do TUI
+ * rejeita o flag e só imprime o helper; variantes
+ * ficam na config global da máquina (Ctrl+T).
+ * Presets e mapa em scripts/lib/worktree.mjs.
* Sem o marcador (comando `/worktree` do opencode),
* a diretiva não é impressa — nunca abre TUI aninhado.
* Também PROVISIONA o ambiente isolado do worktree:
@@ -70,8 +73,8 @@
* terminal, mesma diretiva `launch` — com
* `--prompt /plan-issue` já enviado (OPS31: o TUI
* abre no fluxo de planejamento, sem digitação) e
- * `--model