Submatter/plans/Plan-automation-foundation/Epic-apps-orchestrator/Task-orchestrator-auto-nudge.md
Randall Stillwell 35def387ae docs(plans): add Autensa benchmark tasks to automation foundation roadmap
Map reliability, operator UX, and spend-control follow-ons onto epics 1–9
so worker, webhooks, and fleet work have bead-scale task briefs.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-03 10:48:36 -05:00

2.1 KiB

kind slug title plan_slug epic_slug status priority tenant_id owner cursor_todo_id updated_at
task orchestrator-auto-nudge Orchestrator agent health — auto-nudge and zombie recovery automation-foundation apps-orchestrator draft P2 global unassigned null 2026-08-03

Task summary

Extend stall detection beyond marking convoys blocked: detect zombie agent runs, optionally re-dispatch or nudge, and emit health events for mission control / fleet feed.

Description

Benchmark: Autensa agent health monitoring with auto-nudge and convoy health panel. Echodo already has ORCHESTRATOR_STALL_MINUTES and detectStalledConvoys — this task adds recovery actions and observability.

Health states

State Trigger Default action
Stalled No heartbeat on open agent_run for N minutes Mark convoy blocked; surface in gate inbox sidebar
Zombie Run open but worker process gone Re-enqueue job with resume_from_checkpoint when Epic 7 checkpoint task ships
Nudge Soft stall (configurable) Log convoy_events health event; optional Redis ping to worker

Config (env)

  • ORCHESTRATOR_NUDGE_MINUTES (optional, < stall threshold)
  • ORCHESTRATOR_AUTO_REDISPATCH (default false — opt-in for unattended dogfood)

Events

Append convoy_events with event_type: health and metadata { reason, action, agent_run_id } for activity feed (Epic 9).

Dependencies

Subtasks

  • Extend detectStalledConvoys with nudge vs hard-stall tiers
  • Optional re-dispatch path on zombie detection
  • convoy_events health event writer
  • Document in docs/orchestrator.md

Estimation

M

Acceptance criteria

  • Stalled run moves convoy to blocked and writes health event
  • With ORCHESTRATOR_AUTO_REDISPATCH=1, zombie run triggers new job enqueue
  • No unbounded re-dispatch loops (max retries per brief configurable)
  • Epic: ./Epic-apps-orchestrator.md