feature-00c-abort

/feature-00c-abort

Voce vai abortar manualmente uma execucao feature-00c em andamento conforme contrato em docs/specs/_archived/feature-00c/contracts/cli-invocation.md

• spec §FR-025 (SIGTERM + grace period).

Argumentos recebidos

$ARGUMENTS

Comportamento esperado

1. Parse de argumentos

short_name        = primeiro argumento posicional (OBRIGATORIO)
--motivo TEXTO    = default = "aborto manual"
--purge-backups   = flag opcional; apaga backups/ apos abort
--projeto PATH    = default = cwd

2. Localizar state dir

_proj=$(realpath "$PROJETO")
AGENTE_00C_STATE_DIR="$_proj/.claude/feature-00c-state/$SHORT"
export AGENTE_00C_STATE_DIR

# Backend-agnostico (state-db-runtime-parity, v6.3): sob backend SQLite o
# estado e state.db, nao state.json — exigir state.json aqui tornaria
# impossivel abortar uma execucao iniciada apos `cstk state enable-sqlite`.
if [ ! -d "$AGENTE_00C_STATE_DIR" ] \
   || { [ ! -f "$AGENTE_00C_STATE_DIR/state.json" ] \
        && [ ! -f "$AGENTE_00C_STATE_DIR/state.db" ]; }; then
  stderr "feature-00c-state inexistente para '$SHORT' em $_proj — nada para abortar"
  exit 1
fi

3. Idempotencia — status terminal ja?

_status=$(state-rw.sh get --state-dir "$AGENTE_00C_STATE_DIR" --field '.execution.status')

case "$_status" in
  abortada|concluida)
    echo "execucao ja em status terminal ($_status); nenhuma acao."
    exit 0
    ;;
esac

4. SIGTERM + grace period (FR-025 atualizado)

# Detectar se ha PID detentor do lock
_lock_dir="$AGENTE_00C_STATE_DIR/.lock"
_pid=""
if [ -d "$_lock_dir" ] && [ -f "$_lock_dir/pid" ]; then
  _pid=$(cat "$_lock_dir/pid" 2>/dev/null)
fi

if [ -n "$_pid" ] && kill -0 "$_pid" 2>/dev/null; then
  # Processo da onda vivo — enviar SIGTERM e aguardar grace
  kill -TERM "$_pid" 2>/dev/null || true

  # Grace period: aguardar ate 60s pela liberacao
  _grace=60
  _waited=0
  while [ "$_waited" -lt "$_grace" ]; do
    if ! kill -0 "$_pid" 2>/dev/null; then
      break  # processo encerrou graciosamente
    fi
    sleep 2
    _waited=$((_waited + 2))
  done

  # Se ainda vivo apos grace, force-acquire (fallback)
  if kill -0 "$_pid" 2>/dev/null; then
    stderr "aviso: onda corrente nao respondeu SIGTERM em ${_grace}s; force-acquire do lock"
  fi
fi

# Force-acquire do lock (mesmo se PID encerrou graciosamente, normalize estado).
# `--force-abandoned` (nao `--force`) porque derrubar onda VIVA e exatamente o
# que o abort faz: o `--force` simples recusa quando ha onda aberta no estado
# (issue #182 — o dono do lock e um shell efemero, "pid morto" nao prova onda
# encerrada). O override fica auditado como
# `DIAG|warning|lock-force-abandoned-override`. Pre-condicao contratual ja
# cumprida acima: SIGTERM + grace period.
state-lock.sh acquire --state-dir "$AGENTE_00C_STATE_DIR" --force-abandoned