Saltar para o conteúdo principal

Visão Geral

O comando burn agrega as horas de tarefas em todo o projeto e as agrupa por uma dimensão escolhida. Ele responde perguntas como “quantas horas estão em progresso?”, “o que falta por release?” e “quem tem capacidade?” — tudo pelo terminal.

Relatório Burn

Uso Básico

# Summary + breakdown by release (default dimension)
apollo burn -p "Delfin One"

# Group by specialty
apollo burn -p "Delfin One" --by specialty

# Group by assignee (shows capacity)
apollo burn -p "Delfin One" --by assignee

# Group by priority
apollo burn -p "Delfin One" --by priority
Opções:
FlagDescrição
-p, --project <name>Nome ou ID do projeto (obrigatório)
--by <dimension>Agrupar por: release (padrão), specialty, assignee, priority
--release <name>Limitar a uma única release
-s, --status <status>Filtrar status (separados por vírgula, ou all)

Limitado a uma Release

Análise detalhada de uma única release para ver como as horas se distribuem:
# Show specialty breakdown within a release
apollo burn -p "Delfin One" --release "P3.1" --by specialty

# Show who's working on what in a release
apollo burn -p "Delfin One" --release "P3 — Credit Memo System" --by assignee
┌─ Burn: Delfin One ────────────────────────────────────────┐
│ 382 tasks · 3995h total                                    │
│ Done: 300 (2626h) · WIP: 14 (556h) · Todo: 68 (813h)     │
└────────────────────────────────────────────────────────────┘

By Release                       Done    WIP    Todo   Total  Progress
Platform V1.0.0 - Phase 1 (De…  1689h   -      -      1689h  ██████████ 100%
Platform V1.0.0 - Phase 2 (Ja…  872h    -      -      872h   ██████████ 100%
P3 — Multi-Tenant / White-Lab…  -       250h   170h   420h   ░░░░░░░░░░ 0%
P3 — Credit Memo System         -       140h   50h    190h   ░░░░░░░░░░ 0%
P3 — AI Data Accuracy & Pipel…  57h     56h    16h    129h   ████░░░░░░ 44%
...

Filtros Avancados de Tarefas

O comando task list agora suporta filtros adicionais para fatiar dados por release, especialidade e mais:
# Tasks in a specific release
apollo task list -p "Delfin One" --release "P3.1"

# Tasks by specialty
apollo task list -p "Delfin One" --specialty "frontend"

# Tasks by type
apollo task list -p "Delfin One" --task-type "feature"

# Unassigned tasks only
apollo task list -p "Delfin One" --unassigned

# Tasks due before a date
apollo task list -p "Delfin One" --due-before 2026-03-01

# Combine filters
apollo task list -p "Delfin One" --release "P3.1" --unassigned --specialty "back-end"
Novas opções de filtro:
FlagDescrição
--release <name>Filtrar por nome da release (correspondência fuzzy)
--specialty <name>Filtrar por especialidade (ex: frontend, back-end, ai)
--task-type <name>Filtrar por tipo de tarefa (ex: feature, bug, chore)
--unassignedMostrar apenas tarefas sem responsável
--due-before <date>Mostrar tarefas com vencimento até uma data (YYYY-MM-DD)
A tabela de listagem de tarefas agora inclui as colunas Hours e Release alem das colunas existentes.

Saída JSON

Ambos os comandos suportam --json para saída estruturada, tornando-os combináveis com jq e outras ferramentas.

JSON do Burn

apollo burn -p "Delfin One" --json
{
  "summary": {
    "tasks": 382,
    "total_hours": 3995,
    "done_hours": 2626,
    "wip_hours": 556,
    "todo_hours": 813,
    "blocked_hours": 0,
    "done_tasks": 300,
    "wip_tasks": 14,
    "todo_tasks": 68,
    "blocked_tasks": 0
  },
  "dimension": "release",
  "groups": [
    {
      "name": "Platform V1.0.0 - Phase 1 (December)",
      "task_count": 186,
      "total_hours": 1689,
      "done_hours": 1689,
      "wip_hours": 0,
      "todo_hours": 0,
      "blocked_hours": 0,
      "progress_pct": 100
    }
  ]
}

Exemplos com Piping

# Find releases with the most remaining work
apollo burn -p "Delfin One" --json | jq '.groups | sort_by(-.todo_hours) | .[0:5] | .[] | "\(.name): \(.todo_hours)h todo"'

# Get total WIP hours by assignee
apollo burn -p "Delfin One" --by assignee --json | jq '.groups[] | select(.wip_hours > 0) | "\(.name): \(.wip_hours)h"'

# Count unassigned tasks per specialty
apollo task list -p "Delfin One" --unassigned --json | jq 'group_by(.specialty) | map({specialty: .[0].specialty, count: length})'