teqo-backup/docs/changelog/2026-09-16-ops119.md
Francisco Solla 16f41a9188 feat(OPS119): worktree plan abre driverless sem bag e auto-envia /plan-issue <bag> (Closes #1066)
`worktree plan` sem argumento cria a sessão persistente sem driver (contrato do
`new`); com bag auto-submete uma única `/plan-issue <bag>` e usa o mesmo texto
como rótulo do branch, espelhando o `fix`.

- purposeInvocation (lib/agent-session): ramo plan reusa a sanitização do fix e
  devolve null quando o bag fica vazio (driverless por desenho).
- opencodeLaunchDirective emite --argument para fix||plan; cmdPlan repassa
  argument: bag; cmdStart isenta plan do aviso "sem comando".
- next/new/fix, --stay e o comando /worktree intactos.
- Specs repinados; textos vivos e changelog atualizados. Débito de risk map das
  libs + pin do wiring registrado em #1071.
2026-09-16 01:00:03 -03:00

1.6 KiB

OPS119 — worktree plan abre sem auto-enviar o /plan-issue (mensagem opcional na linha) (2026-09-16): worktree plan sem argumento agora cria a sessão persistente sem driver (mesmo contrato observável do new) — o humano digita o /plan-issue com o contexto que quiser; worktree plan "<mensagem>" segue auto-submetendo uma única /plan-issue <mensagem> e usa a mesma mensagem como bag do branch (plans/plan-issue-<slug>), espelhando o fix <bag>. A regra vive no dono do ciclo (purposeInvocation em scripts/lib/agent-session.mjs): o ramo plan reusa a sanitização do fix (["\\] + trim) e devolve null quando o bag fica vazio (divergência deliberada do fix, cujo bag vazio ainda submete o comando bare). opencodeLaunchDirective (scripts/lib/worktree.mjs) passa a emitir --argument para fix || plan, cmdPlan (scripts/worktree.mjs) repassa argument: bag e o aviso "sem comando/issue válida" do cmdStart isenta plan (driverless por desenho). next/new/fix, --stay e o comando /worktree intactos; supersede o auto-envio incondicional do OPS31 (#593). Sem migration, sem schema, sem UI. Testes: agentSession.unit.spec.ts e worktree.unit.spec.ts repinados (plan sem bag → null; plan com bag → --argument sanitizado; new segue ignorando o argumento); pnpm gate:fast verde e walkthrough manual do launch registrado no PR. Documentação viva atualizada em scripts/worktree.mjs, .agents/shell/worktree.sh, .opencode/commands/worktree.md, .agents/skills/worktree-next-issue/SKILL.md, AGENTS.md e docs/AGENT-OPS.md.