agents-relay 2.0.115 → 2.0.116

package/dist/reconciler-review.js

@@ -176,6 +176,17 @@ export class ReconcilerReviewBase extends ReconcilerRuntimeBase {
     async ensureFinalReview(job, headSha) {
         if (headSha && !(await this.projectedReviewHeadReady(job, headSha)))
             return;
+        // Restore the review gate only after an authoritative unblock of the original reviewer.
+        const priorReviewTask = job.tasks.find(task => task.id === job.review?.taskId);
+        if (job.review?.outcome === 'blocked' && job.review.headSha === headSha
+            && priorReviewTask?.agentName === 'reviewer' && priorReviewTask.unblock?.event === 'task.unblocked'
+            && ['QUEUED', 'RUNNING', 'FAILED'].includes(priorReviewTask.state)) {
+            const recovered = await dispatchReviewLifecycle('blocked', 'review.retry', { reviewUnblocked: true });
+            if (recovered.accepted && recovered.target === 'PENDING') {
+                job.review = { ...job.review, outcome: 'pending', updatedAt: new Date().toISOString() };
+                await this.store.saveJob(job);
+            }
+        }
         let reviewTaskId = null;
         const decision = await dispatchReviewLifecycle(job.review?.outcome, 'reconcile', this.reviewFacts(job, headSha), async (actionId) => {
             if (actionId !== 'review.create')

package/dist/workflow/contracts.js

@@ -30,6 +30,7 @@ export const WORKFLOW_EVENT_NAMES = [
     'review.approved',
     'review.changes_required',
     'review.blocked',
+    'review.retry',
     'task.blocked',
     'task.cancelled',
     'task.completed',
@@ -49,6 +50,7 @@ export const WORKFLOW_FACT_NAMES = [
     'autoMerge',
     'recoverableExecution',
     'retryAvailable',
+    'reviewUnblocked',
     'initialPlan',
     'scheduledRun',
     'hasUnblock',

package/dist/workflow/review-v2.js

@@ -17,9 +17,10 @@ export const reviewLifecycleV2 = new GraphRuntime(source, {
         currentReviewCancelled: boolGuard('currentReviewCancelled'),
         noApprovedCurrentReview: boolGuard('noApprovedCurrentReview'),
         autoMerge: boolGuard('autoMerge'),
+        reviewUnblocked: boolGuard('reviewUnblocked'),
     },
     actions: Object.fromEntries(['review.create', 'review.cancelStale', 'review.createFix', 'review.requestMerge'].map(id => [id, { id }])),
-    events: Object.fromEntries(['reconcile', 'review.started', 'review.approved', 'review.changes_required', 'review.blocked', 'head.changed'].map(id => [id, { id }])),
+    events: Object.fromEntries(['reconcile', 'review.started', 'review.approved', 'review.changes_required', 'review.blocked', 'review.retry', 'head.changed'].map(id => [id, { id }])),
 });
 export function reviewGraphState(outcome) {
     if (!outcome)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-relay",
-  "version": "2.0.115",
+  "version": "2.0.116",
   "description": "Durable async agent jobs coordinated through GitHub pull requests",
   "repository": {
     "type": "git",

package/skills/agents-relay/contracts/event-contract.md

@@ -32,3 +32,5 @@ See [task-recovery-flows.md](task-recovery-flows.md) for unified architecture, o
 Reviewer unavailable evidence is an execution failure (`task.failed`), not a blocked Task. Legacy Reviewer verdict `blocked` is normalized to failure and must dispatch Troubleshooter. Only Relay blocks a Troubleshooter during human escalation.
 
 A host-mediated interactive invocation is a separate Relay-controlled wait. It requires an already-bound `interactiveInvocation` with status `awaiting_decision`. It is not permission for a Worker or Reviewer to choose a blocked terminal outcome.
+
+A legacy Job-level `review: blocked` gate is reset to `pending` only after authoritative `task.unblocked` metadata exists on its bound Reviewer Task and the immutable review head still matches. The same Reviewer Task then resumes without creating a duplicate.

package/workflow/review-lifecycle.mmd

@@ -37,6 +37,7 @@ cancelStarted["action: review.cancelStale"]
 cancelApproved["action: review.cancelStale"]
 cancelChanges["action: review.cancelStale"]
 cancelBlocked["action: review.cancelStale"]
+reviewUnblocked["guard: reviewUnblocked"]
 fixPending["action: review.createFix"]
 fixStarted["action: review.createFix"]
 fixChanges["action: review.createFix"]
@@ -117,5 +118,8 @@ approved -->|on: head.changed| cancelApproved
 cancelApproved --> stale
 changes -->|on: head.changed| cancelChanges
 cancelChanges --> stale
+blocked -->|on: review.retry| reviewUnblocked
+reviewUnblocked -->|true| pending
+reviewUnblocked -->|false| blocked
 blocked -->|on: head.changed| cancelBlocked
 cancelBlocked --> stale