The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
fix: ensure agents respond to comments on in_review tasks
Devin Foley258c7ccd21c0
diff --git a/server/src/routes/issues.ts b/server/src/routes/issues.tsindex d07de42a08..c47f572fce 100644--- a/server/src/routes/issues.ts+++ b/server/src/routes/issues.ts@@ -1591,6 +1591,7 @@ export function issueRoutes(db: Db, storage: StorageService) {issueId: currentIssue.id,taskId: currentIssue.id,commentId: comment.id,+ wakeCommentId: comment.id,source: "issue.comment.reopen",wakeReason: "issue_reopened_via_comment",reopenedFrom: reopenFromStatus,@@ -1614,6 +1615,7 @@ export function issueRoutes(db: Db, storage: StorageService) {issueId: currentIssue.id,taskId: currentIssue.id,commentId: comment.id,+ wakeCommentId: comment.id,source: "issue.comment",wakeReason: "issue_commented",...(interruptedRunId ? { interruptedRunId } : {}),diff --git a/skills/paperclip/SKILL.md b/skills/paperclip/SKILL.mdindex 1d319ad356..e70fe2ef92 100644--- a/skills/paperclip/SKILL.md+++ b/skills/paperclip/SKILL.md@@ -35,12 +35,13 @@ Follow these steps every time you wake up:- add a markdown comment explaining why it remains open and what happens next.Always include links to the approval and issue in that comment.-**Step 3 — Get assignments.** Prefer `GET /api/agents/me/inbox-lite` for the normal heartbeat inbox. It returns the compact assignment list you need for prioritization. Fall back to `GET /api/companies/{companyId}/issues?assigneeAgentId={your-agent-id}&status=todo,in_progress,blocked` only when you need the full issue objects.+**Step 3 — Get assignments.** Prefer `GET /api/agents/me/inbox-lite` for the normal heartbeat inbox. It returns the compact assignment list you need for prioritization. Fall back to `GET /api/companies/{companyId}/issues?assigneeAgentId={your-agent-id}&status=todo,in_progress,in_review,blocked` only when you need the full issue objects.-**Step 4 — Pick work (with mention exception).** Work on `in_progress` first, then `todo`. Skip `blocked` unless you can unblock it.+**Step 4 — Pick work (with mention exception).** Work on `in_progress` first, then `in_review` (if you were woken by a comment on it — check `PAPERCLIP_WAKE_COMMENT_ID`), then `todo`. Skip `blocked` unless you can unblock it.**Blocked-task dedup:** Before working on a `blocked` task, fetch its comment thread. If your most recent comment was a blocked-status update AND no new comments from other agents or users have been posted since, skip the task entirely — do not checkout, do not post another comment. Exit the heartbeat (or move to the next task) instead. Only re-engage with a blocked task when new context exists (a new comment, status change, or event-based wake like `PAPERCLIP_WAKE_COMMENT_ID`).If `PAPERCLIP_TASK_ID` is set and that task is assigned to you, prioritize it first for this heartbeat.-If this run was triggered by a comment mention (`PAPERCLIP_WAKE_COMMENT_ID` set; typically `PAPERCLIP_WAKE_REASON=issue_comment_mentioned`), you MUST read that comment thread first, even if the task is not currently assigned to you.+If this run was triggered by a comment on a task you own (`PAPERCLIP_WAKE_COMMENT_ID` set; `PAPERCLIP_WAKE_REASON=issue_commented`), you MUST read that comment, then checkout and address the feedback. This includes `in_review` tasks — if someone comments with feedback, re-checkout the task to address it.+If this run was triggered by a comment mention (`PAPERCLIP_WAKE_COMMENT_ID` set; `PAPERCLIP_WAKE_REASON=issue_comment_mentioned`), you MUST read that comment thread first, even if the task is not currently assigned to you.If that mentioned comment explicitly asks you to take the task, you may self-assign by checking out `PAPERCLIP_TASK_ID` as yourself, then proceed normally.If the comment asks for input/review but not ownership, respond in comments if useful, then continue with assigned work.If the comment does not direct you to take ownership, do not self-assign.@@ -51,7 +52,7 @@ If nothing is assigned and there is no valid mention-based ownership handoff, ex```POST /api/issues/{issueId}/checkoutHeaders: Authorization: Bearer $PAPERCLIP_API_KEY, X-Paperclip-Run-Id: $PAPERCLIP_RUN_ID-{ "agentId": "{your-agent-id}", "expectedStatuses": ["todo", "backlog", "blocked"] }+{ "agentId": "{your-agent-id}", "expectedStatuses": ["todo", "backlog", "blocked", "in_review"] }```If already checked out by you, returns normally. If owned by another agent: `409 Conflict` — stop, pick a different task. **Never retry a 409.**