reconciliar

O problema: o backlog foi montado num SHA passado. Desde então o HEAD avançou — findings podem ter sido resolvidas incidentalmente, executores podem ter crashado, critérios já cumpridos podem nunca ter sido marcados. Sem reconciliar, você re-executa trabalho morto ou confia em status podre.

Este comando aplica a skill reconcile-execution-backlog: para cada item, compara planned_at_sha vs HEAD, decide a ação por status e refresca o stamp.

Cria/Atualiza:

• .planning/RECONCILE-REPORT.md — tabela por item (status novo, drift, ação) + contadores agregados

Após: o user tem um backlog limpo — só o que realmente sobra para executar, com SHAs frescos e findings rejeitadas removidas.

Exemplos:

/reconciliar                                         # reconcilia todo o backlog no HEAD atual
/reconciliar --output .planning/reconcile-2026.md    # output custom

Pré-requisitos:

• Repositório git com HEAD válido (git rev-parse HEAD)
• Backlog em .planning/ com itens carregando status conhecido (DONE, TODO, IN PROGRESS, BLOCKED) e, idealmente, planned_at_sha
• Findings/critérios verificáveis por spot-check barato (grep/glob/test pontual)

Quando este comando é o caminho:

• O HEAD avançou muito desde que o backlog foi planejado (merge de main, hotfixes, trabalho paralelo)
• Você suspeita que findings já foram resolvidas "de graça" e não quer re-executá-las
• Um executor crashou no meio e deixou itens IN PROGRESS órfãos
• Antes de retomar execução autônoma — quer entrar com backlog confiável, não podre

1. Parsear argumentos e capturar HEAD

OUTPUT_PATH=$(echo "$ARGUMENTS" | grep -oE -- '--output [^ ]+' | awk '{print $2}')
[ -z "$OUTPUT_PATH" ] && OUTPUT_PATH=".planning/RECONCILE-REPORT.md"

HEAD_SHA=$(git rev-parse HEAD 2>/dev/null)
if [ -z "$HEAD_SHA" ]; then
  echo "ERROR: HEAD inválido — não é um repositório git ou sem commits."
  exit 1
fi

if [ ! -d ".planning" ]; then
  echo "ERROR: .planning/ não encontrado — nada para reconciliar."
  exit 1
fi

mkdir -p "$(dirname "$OUTPUT_PATH")"
echo "HEAD atual: $HEAD_SHA"