agents-relay 2.0.231 → 2.0.233

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/dist/blocker-recovery.js +325 -0
  2. package/dist/blockers.js +7 -1
  3. package/dist/cli-blocker.js +35 -2
  4. package/dist/cli-help.js +6 -0
  5. package/dist/dashboard-data.js +17 -12
  6. package/dist/dashboard-html.js +1 -1
  7. package/dist/dashboard-workflow-inspection.js +1 -1
  8. package/dist/managed-worker-input.js +6 -0
  9. package/dist/planner.js +12 -3
  10. package/dist/pool.js +19 -2
  11. package/dist/reconciler-review.js +9 -6
  12. package/dist/relayd-control.js +87 -1
  13. package/dist/review-replan.js +39 -0
  14. package/dist/task-transitions.js +2 -2
  15. package/dist/workflow/blocker-recovery.js +32 -0
  16. package/dist/workflow/blocker-resolution-v2.js +1 -1
  17. package/dist/workflow/planner-orchestration-v2.js +7 -3
  18. package/dist/workflow/planner-trigger-v2.js +3 -2
  19. package/dist/workflow/review-v2.js +2 -2
  20. package/package.json +1 -1
  21. package/skills/agents-relay/SKILL.md +5 -1
  22. package/skills/agents-relay/agents/job-acceptance-reviewer.agent.md +2 -4
  23. package/skills/agents-relay/agents/planner.agent.md +7 -0
  24. package/skills/agents-relay/agents/troubleshooter.agent.md +2 -1
  25. package/skills/agents-relay/contracts/blocker-job-recovery.md +23 -0
  26. package/skills/agents-relay/contracts/orchestrator-workflows.md +6 -0
  27. package/skills/agents-relay/contracts/task-recovery-flows.md +2 -1
  28. package/workflow/blocker-recovery.mmd +51 -0
  29. package/workflow/blocker-resolution.mmd +5 -5
  30. package/workflow/planner-orchestration.mmd +6 -6
  31. package/workflow/planner-trigger.mmd +8 -1
  32. package/workflow/review-lifecycle.mmd +31 -17
@@ -7,14 +7,17 @@ flowchart LR
7
7
  idle["state: idle"]
8
8
  checkUnblock["state: check_unblock"]
9
9
  checkInitial["state: check_initial"]
10
+ checkReview["state: check_review"]
10
11
  manual["state: manual"]
11
12
  unblock["state: unblock"]
12
13
  initial["state: initial"]
13
14
  continuation["state: continuation"]
15
+ review["state: review"]
14
16
 
15
17
  manualGuard["guard: manualPlan"]
16
18
  unblockGuard["guard: hasUnblock"]
17
19
  initialGuard["guard: initialPlan"]
20
+ reviewGuard["guard: reviewRequired"]
18
21
 
19
22
  idle -->|on: plan.requested| manualGuard
20
23
  manualGuard -->|true| manual
@@ -26,4 +29,8 @@ unblockGuard -->|false| checkInitial
26
29
 
27
30
  checkInitial -->|on: plan.requested| initialGuard
28
31
  initialGuard -->|true| initial
29
- initialGuard -->|false| continuation
32
+ initialGuard -->|false| checkReview
33
+
34
+ checkReview -->|on: plan.requested| reviewGuard
35
+ reviewGuard -->|true| review
36
+ reviewGuard -->|false| continuation
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: Review Lifecycle
3
- description: Manages review creation, immutable verdicts, changes-required, and re-review. The implementationComplete guard ignores only durably resolved cancel_supersede cancellations and failed Tasks with a valid superseded classification targeting succeeded work.
3
+ description: Manages review creation, immutable verdicts, changes-required, and re-review. Review is eligible after all non-review Tasks are terminal, regardless of outcome. Approval still requires verified implementation outcomes before merge.
4
4
  ---
5
5
  flowchart LR
6
6
  %% relay: initial none
@@ -15,16 +15,16 @@ stale["state: STALE"]
15
15
 
16
16
  reviewEnabledNone["guard: reviewEnabled"]
17
17
  jobActiveNone["guard: jobActive"]
18
- implementationCompleteNone["guard: implementationComplete"]
18
+ workTerminalNone["guard: reviewWorkSettled"]
19
19
  headAvailableNone["guard: headAvailable"]
20
- completionGateNone["guard: completionGateSatisfied"]
20
+ reviewPlanReadyNone["guard: reviewPlanReady"]
21
21
  noActiveReviewNone["guard: noActiveReviewTask"]
22
22
  noApprovedReviewNone["guard: noApprovedCurrentReview"]
23
23
  reviewEnabledStale["guard: reviewEnabled"]
24
24
  jobActiveStale["guard: jobActive"]
25
- implementationCompleteStale["guard: implementationComplete"]
25
+ workTerminalStale["guard: reviewWorkSettled"]
26
26
  headAvailableStale["guard: headAvailable"]
27
- completionGateStale["guard: completionGateSatisfied"]
27
+ reviewPlanReadyStale["guard: reviewPlanReady"]
28
28
  noActiveReviewStale["guard: noActiveReviewTask"]
29
29
  noApprovedReviewStale["guard: noApprovedCurrentReview"]
30
30
  pendingRetry["guard: noActiveReviewTask"]
@@ -56,14 +56,14 @@ mergeStarted["action: review.requestMerge"]
56
56
  none -->|on: reconcile| reviewEnabledNone
57
57
  reviewEnabledNone -->|true| jobActiveNone
58
58
  reviewEnabledNone -->|false| none
59
- jobActiveNone -->|true| implementationCompleteNone
59
+ jobActiveNone -->|true| workTerminalNone
60
60
  jobActiveNone -->|false| none
61
- implementationCompleteNone -->|true| headAvailableNone
62
- implementationCompleteNone -->|false| none
63
- headAvailableNone -->|true| completionGateNone
61
+ workTerminalNone -->|true| headAvailableNone
62
+ workTerminalNone -->|false| none
63
+ headAvailableNone -->|true| reviewPlanReadyNone
64
64
  headAvailableNone -->|false| none
65
- completionGateNone -->|true| noActiveReviewNone
66
- completionGateNone -->|false| none
65
+ reviewPlanReadyNone -->|true| noActiveReviewNone
66
+ reviewPlanReadyNone -->|false| none
67
67
  noActiveReviewNone -->|true| noApprovedReviewNone
68
68
  noActiveReviewNone -->|false| none
69
69
  noApprovedReviewNone -->|true| createNone
@@ -73,14 +73,14 @@ createNone --> pending
73
73
  stale -->|on: reconcile| reviewEnabledStale
74
74
  reviewEnabledStale -->|true| jobActiveStale
75
75
  reviewEnabledStale -->|false| stale
76
- jobActiveStale -->|true| implementationCompleteStale
76
+ jobActiveStale -->|true| workTerminalStale
77
77
  jobActiveStale -->|false| stale
78
- implementationCompleteStale -->|true| headAvailableStale
79
- implementationCompleteStale -->|false| stale
80
- headAvailableStale -->|true| completionGateStale
78
+ workTerminalStale -->|true| headAvailableStale
79
+ workTerminalStale -->|false| stale
80
+ headAvailableStale -->|true| reviewPlanReadyStale
81
81
  headAvailableStale -->|false| stale
82
- completionGateStale -->|true| noActiveReviewStale
83
- completionGateStale -->|false| stale
82
+ reviewPlanReadyStale -->|true| noActiveReviewStale
83
+ reviewPlanReadyStale -->|false| stale
84
84
  noActiveReviewStale -->|true| noApprovedReviewStale
85
85
  noActiveReviewStale -->|false| stale
86
86
  noApprovedReviewStale -->|true| createStale
@@ -151,6 +151,20 @@ limitOwnerResolution --> changes
151
151
  prepareRereview --> stale
152
152
  changes -->|on: head.changed| cancelChanges
153
153
  cancelChanges --> stale
154
+ %% Only a Review-finding-driven Plan with settled revision Tasks opens re-review.
155
+ reviewChangesReady["guard: reviewPlanReady"]
156
+ reviewChangesSettled["guard: reviewWorkSettled"]
157
+ reviewChangesInactive["guard: noActiveReviewTask"]
158
+ createChanges["action: review.create"]
159
+ changes -->|on: reconcile| reviewChangesReady
160
+ reviewChangesReady -->|true| reviewChangesSettled
161
+ reviewChangesReady -->|false| changes
162
+ reviewChangesSettled -->|true| reviewChangesInactive
163
+ reviewChangesSettled -->|false| changes
164
+ reviewChangesInactive -->|true| createChanges
165
+ reviewChangesInactive -->|false| changes
166
+ createChanges --> pending
167
+
154
168
  blocked -->|on: review.retry| reviewUnblocked
155
169
  reviewUnblocked -->|true| pending
156
170
  reviewUnblocked -->|false| blocked