Skip to content
ver .md sin procesar

Sigue el progreso de un objetivo

Informa cómo va un objetivo de Dailybot: objetivos con su progreso y proyectos, el indicador is_partial y el trabajo abierto detrás de un objetivo.

Beta

Plan está en beta. Todo lo que está bajo /plan en la aplicación web, los comandos del CLI y de la agent skill para proyectos, objetivos, tableros y tareas, y la API pública /v1/plan/ puede cambiar antes de la disponibilidad general. ¿Quieres probarlo con tu equipo? Escribe a [email protected].

Un objetivo dice para qué es el trabajo; las tareas de sus proyectos dicen cómo va. Esta receta arma un informe de estado de objetivos: todos los objetivos activos hoy con su progreso y, después, el trabajo abierto detrás de uno de ellos.

1. Objetivos activos hoy, con su progreso

curl -sS "https://api.dailybot.com/v1/plan/goals/?active_on=$(date +%F)&include=progress,projects" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" \
  | jq '.results[] | {name, status, done: .progress.completed, total: .progress.total, percent: .progress.percent_complete, partial: .progress.is_partial}'
  • active_on conserva los objetivos cuyo periodo incluye esa fecha.
  • include=progress,projects agrega el resumen de progreso y los proyectos vinculados. No vienen por defecto porque cada uno es un agregado; un token desconocido devuelve 400 invalid_filter_value.
  • status es el estado declarado del objetivo (on_track, at_risk, …); progress se mide a partir de las tareas. Muestra ambos.

Desde el CLI:

dailybot plan goal list --include progress --include projects

2. Un objetivo en detalle

El endpoint de detalle siempre incluye progress, projects y project_count:

curl -sS "https://api.dailybot.com/v1/plan/goals/$GOAL/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"
{
  "uuid": "00000000-0000-4000-8000-000000000006",
  "name": "Q4 Roadmap",
  "status": "on_track",
  "period_start": "2026-10-01",
  "period_end": "2026-12-31",
  "progress": { "total": 40, "completed": 18, "open": 22, "blocked": 3, "overdue": 2, "percent_complete": 45, "is_partial": true },
  "project_count": 2,
  "projects": [ { "uuid": "00000000-0000-4000-8000-000000000001", "name": "Platform", "health": "on_track" } ]
}

Desde el CLI:

dailybot plan goal get "$GOAL"

3. Respeta is_partial

El progreso cuenta solo las tareas que puedes ver. Cuando parte del trabajo del objetivo está en tableros que no puedes ver, is_partial es true. Indícalo en cada lugar donde muestres el número, por ejemplo: “45 % del trabajo visible para ti”. Nunca lo presentes como el progreso de la organización.

4. El trabajo abierto detrás del objetivo

El filtro goal de la lista de tareas incluye las tareas con ese objetivo propio o heredado de su proyecto, la misma regla que usa el resumen de progreso, así que la lista y los números coinciden:

curl -sS "https://api.dailybot.com/v1/plan/tasks/?goal=$GOAL&state=open&sort=due_date" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" | jq '.results[] | {key, title, due_date, state: .state.name}'

Agrega &blocked=true para ver lo que está atascado, o &due_before=$(date +%F) para ver lo que está atrasado.

Referencia