teqo-backup/.agents/shell/worktree.sh

# worktree — CLI determinístico de worktrees em torno da fila de claim, com
# troca de diretório por padrão (e `kill` que volta ao main).
#
# A lógica determinística (fila → branch → worktree) vive em scripts/worktree.mjs;
# esta função é só a camada de shell que APLICA o `cd <dir>` que o script imprime
# na última linha, porque um processo filho (node) não consegue mudar o cwd do
# shell que o chamou.
#
# No terminal (esta função), o script também imprime a diretiva `launch node
# scripts/agent-session.mjs start --purpose=<next|plan|new|fix> --dir=<dir>
# --model=<preset|map> [--skill-auto] [--issue=<N>] [--argument="<bag>"]` (OPS26+OPS33+OPS93+OPS95+OPS110+OPS122):
# a função executa o cd e então a linha (tokenizada por xargs — honra as aspas
# do argumento, nunca eval). Desde a OPS110 o launch não abre um TUI local dono
# da sessão: o `agent-session` sobe/reaproveita o `opencode serve` compartilhado,
# cria a sessão endereçável, dispara o driver destacado (que auto-submete
# `/work-issue --issue <N>` no `next`, `/plan-issue <bag>` no `plan` com bag,
# `/bug-fix <bag>` no `fix`; `new` e `plan` sem bag abrem só a sessão) e ANEXA
# o TUI (`opencode attach -s <id>`) —
# fechar o terminal NÃO encerra o run; reentre com `pnpm agent:session attach` e
# encerre com `pnpm agent:session stop`. Sem `--variant` na diretiva nem no attach
# (OPS95: o yargs do TUI rejeita o flag). OPS127: a sessão nasce na variante `max`
# — ela vai no body do `POST /session` e no argv do `opencode run` do
# driver/headless (o TUI anexado herda), nunca na linha do launch. Modelo por invocação: `--cheap`
# (cheapestinference/deepseek-v4-flash), `--pro` (deepseek/deepseek-v4-pro),
# `--zen` (opencode/space-bunny-free), `--go` (opencode-go/deepseek-v4.1-flash), `--alibaba`
# (alibaba-token-plan/deepseek-v4-flash), `--glm` (opencode-go/glm-5.3-flash),
# `--free` (openrouter/stealth/space-bunny-alpha) no mapa fixo `WORKTREE_MODEL_MAP`
# (OPS93 menu; valores OPS95; `--go`/`--zen` OPS112; `--zen`/`--free` OPS129); sem flag o preset `deepseek/deepseek-flash`
# permanece. Sem `exec` de propósito: ao sair do opencode, o terminal volta ao
# shell dentro do worktree. Presets são constantes em scripts/lib/worktree.mjs;
# o ciclo de vida das sessões vive em scripts/agent-session.mjs. O marcador
# TEQO_WORKTREE_TERMINAL=1 é o que separa esta superfície da do comando
# `/worktree` do opencode (que nunca lança TUI). `--stay` suprime cd e launch.
#
# OPS122: `--auto` (o opt-out do GATE da skill) transposta para a invocation do
# driver — `/work-issue --issue <N> --auto`, `/plan-issue --auto <bag>`,
# `/bug-fix --auto <bag>`. Vale em `next`/`fix` e em `plan` COM bag; flag
# desconhecida, `--auto` sem destino (`new`, `plan` sem bag), `--stay --auto`,
# `--headless --auto` ou `--auto` fora do terminal falham alto (nunca descarte
# silencioso). O modelo pedido passa a ser gravado na própria SESSÃO do servidor
# (o TUI anexado herda), inclusive driverless — não só no argv do driver.
#
# Instalação (uma linha no profile; requer bash ou zsh — usa BASH_SOURCE, arrays e here-strings):
#   source <repo>/.agents/shell/worktree.sh
#
# Uso (terminal interativo):
#   worktree next [--issue N] [--stay] [--cheap|--pro|--zen|--go|--alibaba|--glm|--free]
#                            CLAIMA a próxima Issue claimável e cria/reutiliza o
#                            worktree dela, cd para dentro por padrão; --issue N
#                            claima a Issue direcionada ou reabre a já claimada
# (sem re-claim); --stay não troca; --cheap/--pro/--zen/--go/--alibaba/--glm/--free
#                            escolhe o modelo por invocação (sem flag o preset permanece; at-most-one)
#   worktree plan [bag] [--stay] [--cheap|--pro|--zen|--go|--alibaba|--glm|--free]
#                            cria um worktree de planejamento do /plan-issue
#                            DIFERENTE a cada chamada (sessões paralelas): com bag,
#                            branch plans/plan-issue-<bag> (sufixo -2/-3 se o nome
#                            já existir), sem bag o próximo plans/plan-issue-<n>
#                            sequencial; cd para dentro dele por padrão; --stay não
#                            troca; flag de modelo como no `next`
#   worktree new [bag] [--stay] [--cheap|--pro|--zen|--go|--alibaba|--glm|--free]
#                            cria um worktree NEUTRO (sem função pré-definida)
#                            DIFERENTE a cada chamada: com bag, branch work/<bag>
#                            (sufixo -2/-3 se o nome já existir), sem bag o próximo
#                            work/<n> sequencial; cd para dentro dele por padrão;
#                            --stay não troca; flag de modelo como no `next`
#   worktree fix [bag] [--stay] [--cheap|--pro|--zen|--go|--alibaba|--glm|--free]
#                            cria um worktree de CORREÇÃO DE BUG (skill /bug-fix)
#                            DIFERENTE a cada chamada: com bag (a descrição do bug),
#                            branch fix/<bag> (sufixo -2/-3 se o nome já existir),
#                            sem bag o próximo fix/<n> sequencial; o launch envia
#                            `/bug-fix <bag>` (a descrição chega com a skill); não
#                            claima nem cria Issues — o registro é o post-mortem;
#                            cd para dentro dele por padrão; --stay não troca;
#                            flag de modelo como no `next`
#   worktree kill [--force]  destrói o worktree atual e cd para o main por padrão
#
# `--go` remapeado em OPS93 para o provider OpenCode Go, em OPS95 para `opencode-go/hy3`
# e em OPS112 para `opencode-go/deepseek-v4.1-flash` (antes no-op do OPS24). Claim determinístico: `next` claima antes de criar o worktree (mesma fila e
# lock de `pnpm agent:claim`); `plan`/`new`/`fix`/`kill` não tocam Issues.

worktree() {
  local src="${BASH_SOURCE[0]:-$0}"
  local root
  root="$(cd "$(dirname "$src")/../.." && pwd)"

  local stay=0
  local arg
  for arg in "$@"; do
    if [ "$arg" = "--stay" ]; then
      stay=1
    fi
  done

  local out
  out="$(TEQO_WORKTREE_TERMINAL=1 node "$root/scripts/worktree.mjs" "$@")" || return $?
  printf '%s\n' "$out"

  if [ "$stay" -eq 1 ]; then
    return 0
  fi

  local dir
  dir="$(printf '%s\n' "$out" | sed -n 's/^cd //p' | tail -n 1)"
  if [ -n "$dir" ] && [ -d "$dir" ]; then
    cd "$dir" || return $?
    printf '→ %s\n' "$PWD"
  else
    printf 'worktree: não consegui aplicar o `cd` da saída do script.\n' >&2
    return 1
  fi

  # Diretiva `launch` (só existe quando TEQO_WORKTREE_TERMINAL=1 e sem --stay): o
  # script a gera a partir de constantes + dir slugificado (sem espaços), e desde
  # o OPS33 os valores com espaço vêm CITADOS (`--argument="<bag>"`; OPS110 —
  # antes era o `--prompt "/work-issue --issue <N>"`) — o split por IFS=' ' não
  # honra aspas, então a tokenização usa xargs (processa aspas duplas como um
  # shell, NÃO é eval; o conteúdo é 100% gerado por constantes + número, sem
  # input livre). Falha do launch (ex.: node/opencode fora do PATH) só avisa: o
  # worktree já está pronto e utilizável.
  local launch
  launch="$(printf '%s\n' "$out" | sed -n 's/^launch //p' | tail -n 1)"
  if [ -n "$launch" ]; then
    local -a launch_args
    while IFS= read -r token; do
      launch_args+=("$token")
    done < <(printf '%s\n' "$launch" | xargs -n 1 printf '%s\n')
    "${launch_args[@]}" || printf 'worktree: launch do opencode falhou (código %s) — o worktree segue pronto em %s.\n' "$?" "$PWD" >&2
  fi
}