13 KiB
Impl: Default de launch do worktree passa a usar o DeepSeek V4 Flash 0731 (mais barato) + limpeza de duplicatas do Cheapest Inference
Status: aprovado Atualizado em: 2026-08-23 Issue: #817 Intenção: docs/plans/expor-variantes-deepseek-v4-flash-0731.md Appetite restante: ~0,5–1 dia (config-only; sem migration, sem code além da constante e do bloco de config)
Leitura da intenção
- Outcome: (1) a variante
maxdo DeepSeek V4 Flash 0731 fica selecionável no TUI; (2) o preset de launch do worktree emite--model vercel/deepseek/deepseek-v4-flash-0731(input $0.076/M vs $0.13/M do-flash); (3) o TUI mostra um único DeepSeek e um único MiMo no Cheapest Inference (sem duplicatas). Verificável poropencode debug config(override com variantes no model key 0731), pela linha de launch emitida + literais/pin dos testes unit, e abrindo o seletor de modelo no TUI. - O que NÃO negociar: anti-goals da intenção — NÃO mudar o cardápio de execução de Issues (
work-issue.md/plan-issue.mdnem o pin deopencodeCommands.unit.spec.ts); NÃO tocar no~/.config/opencode/opencode.jsoncglobal do humano (o providercheapestinceptionglobal, sem hífen, é a fonte dele e carrega os models); NÃO editar docs históricos (docs/plans,docs/CHANGELOG-AGENTS.md,docs/changelog/*). Não tocar nos usos diretos do providerdeepseek/deepseek-v4-flashfora do launch do worktree (src/utilities/ai/campaignDemandTitle.ts,src/app/(campaign)/campanha/api/ai-chat/route.ts— uso direto legítimo, fora de escopo). - O que reavaliar: a hipótese de "Direção no codebase" da intenção estava errada em um ponto verificado ao vivo: o bloco
cheapest-inference(com hífen) doopencode.jsondo repo ocupa as linhas 11–70 (fecha em},na 70), e não 11–33 como o plano dizia — e hoje ele já define variantes low/high/max nos models. O bloco inteiro (11–70) é o que sai. Reavaliado também: o default dentro do bloco repo édeepseek-v4-flash(sem namespace) e overcel.modelsatual vive nas linhas 71–87; o sibling 0731 entra ao lado dodeepseek/deepseek-v4-flashexistente (73–85). O restante da direção da intenção confirmou-se exato após leitura dos arquivos.
Abordagem recomendada
flowchart LR
P["pnpm worktree next/plan/new"] --> L["scripts/lib/worktree.mjs:28\nOPENCODE_PRESET_MODEL = vercel/deepseek/deepseek-v4-flash-0731"]
L --> D["opencodeLaunchDirective --model vercel/deepseek/deepseek-v4-flash-0731"]
D --> T["TUI opencode"]
C["opencode.json\nprovider.vercel.models + sibling 0731\n(low/high/max) · provider.cheapest-inference REMOVIDO (11-70)"] --> T
G["~/.config/opencode/opencode.jsonc\ncheapestinception (global, single source das variantes)"] --> T
T -->|"max sticky (model.json)"| V["Vercel AI Gateway\ndeepseek-v4-flash-0731 · $0.076/M input"]
Opções consideradas (Parte 1 — variantes do 0731): A | B | C
Recomendação: A — expor as três variantes low/high/max no override provider.vercel.models["deepseek/deepseek-v4-flash-0731"], espelhando exatamente o bloco do sibling deepseek/deepseek-v4-flash (OPS78). O model key existe no catálogo cache (input $0.076/M) mas com reasoning_options vazio — sem o override as variantes não ficam selecionáveis no TUI. Espelhar o bloco mantém o mecanismo uniforme entre os dois keys Vercel, sem custo extra e sem inventar formato.
Rejeitadas:
- B — expor só
max: assimétrico com o sibling-flashque já expõe low/high/max; o custo de listar as três no mesmo bloco é zero, e só-maxquebra a uniformidade do mecanismo de variantes que a OPS78 estabeleceu. - C — não fazer override (confiar no catálogo): o
reasoning_optionsdo 0731 no cache é vazio — as variantes simplesmente não aparecem no TUI; falha o outcome 1.
Opções consideradas (Parte 3 — remoção do duplicado): A | B | C
Recomendação: A — remover o bloco cheapest-inference inteiro (linhas 11–70) do opencode.json do repo. O global ~/.config/opencode/opencode.jsonc já define cheapestinception (sem hífen) com os mesmos deepseek-v4-flash + mimo-v2.5 e com variantes — é o owner da preocupação e fica como fonte única; o bloco repo é um twin com variantes redundantes. Depois da remoção, provider do repo fica só com vercel.
Rejeitadas:
- B — remover o global e manter o do repo: anti-goal explícito da intenção; o global do humano é intocado (carrega a config de auth do provider).
- C — manter ambos, sincronizando variantes: viola engineering-standards ("edit the owner, don't twin") e mantém os dois DeepSeek + dois MiMo no TUI — falha o outcome 3.
Decisão única (Parte 2 — swap do preset), textos inclusos: A) trocar a constante OPENCODE_PRESET_MODEL E todos os pontos que duplicam o literal (lista verificada abaixo) na mesma mudança | B) trocar só a constante e deixar os textos. Recomendação: A — o literal duplicado em scripts/worktree.mjs, .agents/shell/worktree.sh e .agents/skills/worktree-next-issue/SKILL.md descreve o modelo de launch; ficarem desatualizados mentem pro dev e para a documentação do skill. Rejeitada: B porque deixa o repo inconsistentemente apontando para o modelo caro em 4 lugares.
Componentes / mudanças
opencode.json(:11-70): remover inteiro o blocoprovider.cheapest-inference(com hífen):deepseek-v4-flash+mimo-v2.5.opencode.json(:71-87, dentro deprovider.vercel.models): adicionar como sibling apósdeepseek/deepseek-v4-flash(73–85):
(mesmo formato exato do fix de variantes da OPS78; o provider"deepseek/deepseek-v4-flash-0731": { "variants": { "low": { "reasoningEffort": "low" }, "high": { "reasoningEffort": "high" }, "max": { "reasoningEffort": "max" } } }vercelé built-in/models.dev — sem npm/options adicionais.)OPENCODE_PRESET_MODEL(scripts/lib/worktree.mjs:28): valor →'vercel/deepseek/deepseek-v4-flash-0731'; atualizar o comentário:22-27(mencionar que o preset é o 0731, variante mais barata no gateway, variantes low/high/max no override). É a fonte única da string (OPS26), emitida emopencodeLaunchDirective— nenhum outro código lê o literal.tests/unit/worktree.unit.spec.ts(:151,159,165,171,177,180,185,196): atualizar os 8 literais da linha de launch paravercel/deepseek/deepseek-v4-flash-0731;:185pina a própria constante (expect(OPENCODE_PRESET_MODEL).toBe(...)) — trocar o literal esperado. NÃO mexer emtests/unit/opencodeCommands.unit.spec.ts(pina o frontmatter dos comandos de execução — anti-goal).- Textos (string atualizada, sentido OPS26 preservado):
scripts/worktree.mjs:27(docblock) e:779(helpconsole.log).agents/shell/worktree.sh:10(comentário header).agents/skills/worktree-next-issue/SKILL.md:34(prosa do skill sobre a diretiva de launch)
- Migration: sem migration — configuração/tooling apenas; nenhum schema de Payload muda.
- Access / Consent: N/A — não há collection nem dado de cidadão envolvido; não afeta login de campanha nem LGPD.
- UI: N/A — TUI do opencode é consumidor, não produto deste plano.
Dados → forma (se aplicável)
N/A — tooling. Não há dado de negócio sendo modelado: são uma constante de config + remoção/acréscimo de bloco no opencode.json. (Perguntas de data-presentation não se aplicam.)
Fases verificáveis
- Config (
opencode.json) — removerprovider.cheapest-inference(11–70); adicionar o sibling 0731 com variantes emprovider.vercel.models. Verificar:node -epara garantir JSON válido eopencode debug configmostrando SO o providervercel(repo) + override de variantes no model key 0731. Quota: meia fase. - Preset + literais + testes —
scripts/lib/worktree.mjs:22-28(constante + comentário);tests/unit/worktree.unit.spec.ts(8 literais::151,159,165,171,177,180,185,196); textosscripts/worktree.mjs:27,:779,.agents/shell/worktree.sh:10,.agents/skills/worktree-next-issue/SKILL.md:34. Quota: meia fase. - Gates —
pnpm test:unit(foco emworktree.unit.spec.ts);pnpm gate:fast(guards → lint → format → typecheck → knip → cycles → test:unit) verde; validação manual:opencode run --model vercel/deepseek/deepseek-v4-flash-0731 --variant maxresponde; launch real de teste (pnpm worktree nextem branch descartável) emite--model vercel/deepseek/deepseek-v4-flash-0731; push viapnpm push→ CI PR (checks).
Rabbit holes / Não escopo (engenharia)
- NÃO mudar
.opencode/commands/work-issue.md/plan-issue.md(frontmattermodel:) nem o pintests/unit/opencodeCommands.unit.spec.ts— cardápio de execução de Issues intacto (anti-goal). - NÃO tocar no
~/.config/opencode/opencode.jsoncdo humano — o providercheapestinceptionglobal é fonte de auth e models; a remoção é só no repo. - NÃO editar
docs/CHANGELOG-AGENTS.md,docs/changelog/*nem planos históricos — congelados (a entrada de changelog desta entrega é criada depois, no fluxo padrãodocs/changelog/<data>-<id>.md+pnpm changelog:build). - NÃO renomear o provider global nem "unify" os dois
cheapestinception/cheapest-inferencefora da remoção do bloco repo — o gap de nome é de produto e já está resolvido pela remoção. - NÃO forçar a variante via
model.agent/default (mesma rejeição da OPS78): variante fica selecionável e sticky no TUI, não imposta. - NÃO inventar flag
--variantna linha de launch nem sufixo:maxno--model(TUI não suporta; formato estritamenteprovider/model). - Não escopo: outros model keys de outros providers, inventário de catálogo, usos diretos de
deepseek/deepseek-v4-flashno app (campaignDemandTitle.ts,ai-chat/route.ts).
Riscos e mitigação
opencode.jsoninválido após a edição (hard-fail config do opencode) → mitigação: paridade tipo JSON checada comnode -e "JSON.parse(...)"antes de commit, eopencode debug configrodado na Fase 1; se o loader validar o bloco de models, a dúvida morre ali antes da Fase 3.- Sticky variant preso ao model key antigo (
~/.local/state/opencode/model.json) → trocar o preset para o 0731: a variante persistida por model key não migra sozinha; na primeira sessão o dev cicla a variante uma vez (keybind variant_cycle) e ela fica sticky no novo key. Não é ação do plano (comportamento upstream), só documentar no PR. - Duplicate literais fora da lista verificada → mitigação: o swap de Fase 2 cobre o conjunto verificado (8 testes + 4 textos + constante); testes unit pínam a linha de launch e
:185pina a constante — deriva volta na CI. Rodarrg "vercel/deepseek/deepseek-v4-flash-0731"pós-mudança para conferir o agreeing, erg "deepseek-v4-flash"para confirmar que só ficaram os usos diretos intencionais (frontmatter dos comandos + app). - Remover
cheapest-inferencee o global não cobrir algo (ex.: npm do provider) → caminho do explorer verificado: o global já definecheapestinceptioncom os mesmosdeepseek-v4-flash+mimo-v2.5com variantes. Mitigação: confirmar noopencode debug configque os models globais continuam listados depois da remoção; reverter a remoção é umgit checkoutde um bloco isolado.
Aceite de engenharia
- Aceite de produto da intenção coberto: variante
max(e low/high) do 0731 selecionável no TUI via override; preset emite--model vercel/deepseek/deepseek-v4-flash-0731; TUI mostra um único DeepSeek e um único MiMo no Cheapest Inference após remoção do bloco repo; verificável poropencode debug config, linha de launch + testes unit atualizados. - Anti-goals preservados:
work-issue.md/plan-issue.mdeopencodeCommands.unit.spec.tsintactos;~/.config/opencode/opencode.jsoncintacto; docs históricos intactos; usos diretosdeepseek-v4-flashdo app intactos; config-only (sem migration, sem code além da constante). - Invariantes AGENTS/engineering-standards: constante single-source mantida (OPS26), provider duplicado removido (owner global fica como fonte única — sem twin), testes de domínio atualizados onde o literal muda.
pnpm test:unitverde (specworktree.unit.spec.ts) epnpm gate:fastverde;opencode debug configvalidado antes de marcar aprovado/executar.
Self-score decision-quality
- Decisões caras têm rejeitadas? Sim — Parte 1 (A/B/C com C falhando o outcome) e Parte 3 (A/B/C, com B sendo anti-goal), Parte 2 decidida em A vs B com rejeitada registrada.
- Abordagem cabe no appetite da intenção? Sim — config-only, duas edições em
opencode.json+ swap mecânico de literais; ~0,5–1 dia mantido. - Rabbit holes nomeados? Sim — cardápio de execução, global do humano, docs históricos, renome/unificação de providers, variante forçada, flag inexistente.
- Depth check: reusa shells/helpers existentes? Sim — nenhum helper novo; espelha o override da OPS78 e reusa a constante single-source OPS26 + os pins de teste existentes.
- Intenção (aceite de produto) permanece satisfeita? Sim — a engenharia não reescreveu o outcome; a única divergência da intenção (extensão real do bloco 11–70 vs 11–33) não muda o resultado, só o escopo exato da remoção.
Score: 5/5