postmortem

Cria/Atualiza:

• .planning/postmortems/<id>.md — postmortem blameless completo

Após: o user tem postmortem revisável + action items concretos. Phase 40 INT-FW-V2-01 chained do /forense automaticamente após Core Analysis Loop fechar.

Modo A: --from-investigation <id> (preferido — continuação de v1.9)

Lê .planning/investigations/<id>.md produzido pelo incident-investigator (v1.9 — Core Analysis Loop). Extrai automaticamente: trigger, root cause, hipóteses validadas, action items. Campos faltantes (impact quantificado, severity, autores) são perguntados via AskUserQuestion.

Modo B: --incident "<descrição>" (standalone)

Para postmortem sem investigation prévia (incident menor, near-miss, lições retrospectivas). Agent gera template e usa AskUserQuestion para 9 perguntas guiadas — uma por seção canônica.

Flags adicionais:

• --severity <SEV1|SEV2|SEV3> — severity do incident (default: AskUserQuestion)
• --output <path> — caminho do postmortem (default: .planning/postmortems/<id>.md — id auto-gerado)

Exemplos:

/postmortem --from-investigation incident-2026-05-06-1432-checkout-burn   # Modo A
/postmortem --incident "checkout SLO burn às 14:32 — RCA N+1 query orders" --severity SEV2  # Modo B
/postmortem --incident "near-miss: deploy bloqueou 2min antes do PR-1234"                    # near-miss

Pré-requisito (Modo A): arquivo .planning/investigations/<id>.md existe (criado por /investigar-producao ou /forense).

1. Parsear argumentos (2 modos)

INV_ID=$(echo "$ARGUMENTS" | grep -oE -- '--from-investigation [^ ]+' | awk '{print $2}')
INCIDENT=$(echo "$ARGUMENTS" | grep -oE -- '--incident "[^"]+"' | sed 's/--incident //; s/^"//; s/"$//')
SEVERITY=$(echo "$ARGUMENTS" | grep -oE -- '--severity [^ ]+' | awk '{print $2}')
OUTPUT_PATH=$(echo "$ARGUMENTS" | grep -oE -- '--output [^ ]+' | awk '{print $2}')

# PT-BR: validar mutuamente exclusivos
if [ -n "$INV_ID" ] && [ -n "$INCIDENT" ]; then
  echo "✗ Erro: --from-investigation e --incident são mutuamente exclusivos. Escolha um."
  exit 1
fi

# PT-BR: se nenhum dos 2 → AskUserQuestion (Modo C — interativo)
if [ -z "$INV_ID" ] && [ -z "$INCIDENT" ]; then
  # Listar investigations recentes para sugestão
  RECENT_INVS=$(ls -t .planning/investigations/*.md 2>/dev/null | head -5 | while read f; do basename "$f" .md; done | tr '\n' ',')
  # AskUserQuestion: "Modo? Continuar de investigation existente OU postmortem standalone?"
  # Opções: Continuar de <ID> (uma por investigation recente) | Standalone (texto livre)
  echo "ℹ Sem flag explícita. Use --from-investigation <id> ou --incident \"<descrição>\"."
  [ -n "$RECENT_INVS" ] && echo "  Investigations recentes: $RECENT_INVS"
  exit 1
fi