aws-samples / aws-samples/sample-autonomous-cloud-coding-agents

feat(orchestration): stranded-task operator notify and manual resume

Open
#488 0 comments 0 reactions 0 assignees View on GitHub
enhancement orchestration
Dominant language
TypeScript
Stars
143
Forks
46
Avg merge
3d 9h
Merged PRs (30d)
20

Description

**Context:** ROADMAP.md → Stuck-task reconciliation (operator notify/resume)

---

## Component

API or orchestration

## Describe the feature

Extend shipped stranded-task reconciler: **operator notification** before forced failure and **manual resume** option for recoverable stuck states.

## Use case

Reconciler today fails stuck tasks automatically—correct for hygiene but harsh when root cause was transient platform outage. Operators want warn-then-act and resume.

## Proposed solution

1. Grace period: emit `stranded_warning` event + notify before `failTask`.
2. `POST /tasks/{id}/resume` for operator-forced continuation from last checkpoint (when safe).
3. Blueprint config: `stranded_grace_minutes`, `notify_channel`.
4. Audit all operator resume actions.
5. Tests for warning → fail and warning → resume paths.

## Other information

- Base reconciler shipped; this is **operator UX** on top.
- Design context: `docs/design/ORCHESTRATOR.md`.

- [ ] This might be a breaking change

Contributor guide

Open the contributing guide

Research direction

Start with the “Stuck-task reconciliation” section in ROADMAP.md and read docs/design/ORCHESTRATOR.md for the existing stranded-task reconciler. Trace the current failTask path and the task API entry points before defining the warning, resume, configuration, and audit flows. Done means the warning→fail and warning→resume paths have tests and the proposed operator behavior is covered.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
api, backend
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.