custo-fase

Inferência de janela temporal:

• started_at ← mtime do arquivo SPEC.md em .planning/phases/<phase_id>-*/.
• ended_at ← completed_at de .planning/STATE.md (se a fase foi concluída) OU null se ainda ativa.
• Cross-ref com git log --since/--until para apertar bordas.

correlation_confidence:

• high: SPEC.md mtime + completed_at + commits no intervalo (3/3 sinais).
• medium: 2/3 sinais.
• low: apenas mtime do dir OU detecção de rebase recente (reflog) que invalidaria bordas.
• unknown: fase não encontrada em .planning/phases/.

Lê: .planning/phases/<id>-*/SPEC.md, .planning/STATE.md, git log, JSONLs do Claude Code.

Cria/Atualiza: nada por default. Com --persist, grava em .planning/costs/<ts>-cost-phase.json.

Após: o user vê custo da fase + correlation_confidence + correlation_signals para auditar a confiança no número.

Disambiguation: sobre USD/tokens reais da fase, não sobre métricas de progresso da fase. Para progresso → ver STATE.md direto. Para custo financeiro → este comando. Ver skill cost-tracking.

• <phase_id> — obrigatório. ID da fase (ex: 172). Sem o ID, o comando emite erro e sugere /listar-fases.
• --refresh-pricing — opt-in models.dev fallback.
• --persist — salva snapshot.

Cross-reference: SSOT do algoritmo de correlação é src/core/cost/aggregate-phase.js + skill cost-tracking. Confidence levels documentados no SPEC 172.

1. Parsear argumentos

PHASE_ID=$(echo "$ARGUMENTS" | awk '{for(i=1;i<=NF;i++) if($i !~ /^--/) {print $i; exit}}')
REFRESH=$(echo "$ARGUMENTS" | grep -oE -- '--refresh-pricing' | head -1)
PERSIST=$(echo "$ARGUMENTS" | grep -oE -- '--persist' | head -1)

if [ -z "$PHASE_ID" ]; then
  echo "Uso: /custo-fase <phase_id> [--refresh-pricing] [--persist]"
  echo "Exemplo: /custo-fase 172"
  exit 1
fi