Saltar al contenido principal

Descripción General

El comando burn agrega las horas de tareas a lo largo de tu proyecto y las agrupa por una dimensión elegida. Responde preguntas como “¿cuántas horas están en progreso?”, “¿qué queda por release?” y “¿quién tiene capacidad?” — todo desde el terminal.

Informe 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
Opciones:
FlagDescripción
-p, --project <name>Nombre o ID del proyecto (obligatorio)
--by <dimension>Agrupar por: release (por defecto), specialty, assignee, priority
--release <name>Limitar a una sola release
-s, --status <status>Filtrar estados (separados por coma, o all)

Limitado a una Release

Analiza en detalle una sola release para ver cómo se distribuyen las horas:
# 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 Avanzados de Tareas

El comando task list ahora soporta filtros adicionales para segmentar datos por release, especialidad y más:
# 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"
Nuevas opciones de filtro:
FlagDescripción
--release <name>Filtrar por nombre de release (coincidencia fuzzy)
--specialty <name>Filtrar por especialidad (ej: frontend, back-end, ai)
--task-type <name>Filtrar por tipo de tarea (ej: feature, bug, chore)
--unassignedMostrar solo tareas sin responsable
--due-before <date>Mostrar tareas con fecha límite en o antes de una fecha (YYYY-MM-DD)
La tabla de listado de tareas ahora incluye las columnas Hours y Release además de las columnas existentes.

Salida JSON

Ambos comandos soportan --json para salida estructurada, haciéndolos combinables con jq y otras herramientas.

JSON del 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
    }
  ]
}

Ejemplos con 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})'