agents-relay 2.0.209 → 2.0.211

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 (50) hide show
  1. package/dist/cli-help.js +10 -4
  2. package/dist/cli-prompt.js +2 -1
  3. package/dist/cli-revision.js +49 -0
  4. package/dist/cli-worker-task.js +15 -0
  5. package/dist/cli.js +11 -2
  6. package/dist/dashboard-html.js +2 -2
  7. package/dist/dependency-revision-execution.js +152 -0
  8. package/dist/dependency-validity.js +17 -0
  9. package/dist/final-review-role.js +17 -0
  10. package/dist/force-restate-validation.js +3 -2
  11. package/dist/host-invocation-store.js +18 -4
  12. package/dist/interactive-invocation.js +37 -5
  13. package/dist/job-pr-number-migration.js +2 -1
  14. package/dist/managed-worker-input.js +2 -1
  15. package/dist/planner-agent-roles.js +18 -0
  16. package/dist/planner-runtime.js +7 -1
  17. package/dist/planner-task-ids.js +1 -0
  18. package/dist/planner.js +11 -6
  19. package/dist/reconciler-review.js +78 -96
  20. package/dist/reconciler-runtime.js +14 -5
  21. package/dist/reconciler.js +21 -11
  22. package/dist/relay-store.js +2 -0
  23. package/dist/relayd-control.js +31 -0
  24. package/dist/review-evidence.js +44 -0
  25. package/dist/review-generation-fence.js +2 -1
  26. package/dist/review-revision-execution.js +86 -0
  27. package/dist/review-revision-merge.js +15 -0
  28. package/dist/review-revision-model.js +191 -0
  29. package/dist/review-revision-policy.js +49 -0
  30. package/dist/review-revision-settlement.js +54 -0
  31. package/dist/review-revision-stale.js +57 -0
  32. package/dist/reviewer-thread.js +41 -1
  33. package/dist/runtime-status.js +13 -4
  34. package/dist/single-job-task-control.js +1 -1
  35. package/dist/task-context.js +3 -2
  36. package/dist/worker-failure-recovery.js +2 -1
  37. package/dist/workflow/dependency-revision-v2.js +16 -0
  38. package/dist/workflow/entity-creation.js +2 -0
  39. package/dist/workflow/review-v2.js +6 -2
  40. package/dist/workflow/revision-v2.js +32 -0
  41. package/dist/workflow/task-reconcile.js +3 -0
  42. package/package.json +1 -1
  43. package/skills/agents-relay/agents/job-acceptance-reviewer.agent.md +41 -0
  44. package/skills/agents-relay/agents/planner.agent.md +6 -3
  45. package/skills/agents-relay/contracts/event-contract.md +55 -1
  46. package/skills/agents-relay/contracts/task-job-contract.md +6 -0
  47. package/workflow/dependency-revision.mmd +30 -0
  48. package/workflow/interactive-invocation.mmd +8 -2
  49. package/workflow/review-lifecycle.mmd +40 -9
  50. package/workflow/revision-lifecycle.mmd +68 -0
@@ -41,9 +41,15 @@ cancelApproved["action: review.cancelStale"]
41
41
  cancelChanges["action: review.cancelStale"]
42
42
  cancelBlocked["action: review.cancelStale"]
43
43
  reviewUnblocked["guard: reviewUnblocked"]
44
- fixPending["action: review.createFix"]
45
- fixStarted["action: review.createFix"]
46
- fixChanges["action: review.createFix"]
44
+ targetedPending["guard: targetedRevisionRequestsReady"]
45
+ targetedStarted["guard: targetedRevisionRequestsReady"]
46
+ targetedChanges["guard: targetedRevisionRequestsReady"]
47
+ recordTargetedPending["action: review.awaitTargetedRevisions"]
48
+ recordTargetedStarted["action: review.awaitTargetedRevisions"]
49
+ recordTargetedChanges["action: review.awaitTargetedRevisions"]
50
+ ownerPending["action: review.requireOwnerResolution"]
51
+ ownerStarted["action: review.requireOwnerResolution"]
52
+ ownerChanges["action: review.requireOwnerResolution"]
47
53
  mergePending["action: review.requestMerge"]
48
54
  mergeStarted["action: review.requestMerge"]
49
55
 
@@ -96,8 +102,11 @@ pending -->|on: review.approved| autoMergePending
96
102
  autoMergePending -->|true| mergePending
97
103
  mergePending --> approved
98
104
  autoMergePending -->|false| approved
99
- pending -->|on: review.changes_required| fixPending
100
- fixPending --> changes
105
+ pending -->|on: review.changes_required| targetedPending
106
+ targetedPending -->|true| recordTargetedPending
107
+ targetedPending -->|false| ownerPending
108
+ recordTargetedPending --> changes
109
+ ownerPending --> changes
101
110
 
102
111
  %% A failed Reviewer execution may recover with a new Execution ID while
103
112
  %% the Review lifecycle remains STARTED. This is a legal re-start event;
@@ -107,10 +116,16 @@ started -->|on: review.approved| autoMergeStarted
107
116
  autoMergeStarted -->|true| mergeStarted
108
117
  mergeStarted --> approved
109
118
  autoMergeStarted -->|false| approved
110
- started -->|on: review.changes_required| fixStarted
111
- fixStarted --> changes
112
- changes -->|on: review.changes_required| fixChanges
113
- fixChanges --> changes
119
+ started -->|on: review.changes_required| targetedStarted
120
+ targetedStarted -->|true| recordTargetedStarted
121
+ targetedStarted -->|false| ownerStarted
122
+ recordTargetedStarted --> changes
123
+ ownerStarted --> changes
124
+ changes -->|on: review.changes_required| targetedChanges
125
+ targetedChanges -->|true| recordTargetedChanges
126
+ targetedChanges -->|false| ownerChanges
127
+ recordTargetedChanges --> changes
128
+ ownerChanges --> changes
114
129
 
115
130
  pending -->|on: head.changed| cancelPending
116
131
  cancelPending --> stale
@@ -118,6 +133,22 @@ started -->|on: head.changed| cancelStarted
118
133
  cancelStarted --> stale
119
134
  approved -->|on: head.changed| cancelApproved
120
135
  cancelApproved --> stale
136
+ changes -->|on: revision.settled| targetedVerified
137
+ %% Only the Review Graph selects re-review; settlement is proven by correlated
138
+ %% child terminal evidence and explicit revision request provenance.
139
+ targetedVerified["guard: targetedRevisionsVerified"]
140
+ reviewRoundAllowed["guard: reviewRoundWithinLimit"]
141
+ reviewNoProgressAllowed["guard: reviewNoProgressWithinLimit"]
142
+ prepareRereview["action: review.prepareRereview"]
143
+ limitOwnerResolution["action: review.requireOwnerResolution"]
144
+ targetedVerified -->|true| reviewRoundAllowed
145
+ reviewRoundAllowed -->|true| reviewNoProgressAllowed
146
+ reviewNoProgressAllowed -->|true| prepareRereview
147
+ reviewNoProgressAllowed -->|false| limitOwnerResolution
148
+ %% Exhausted re-review rounds require explicit owner/Planner recovery.
149
+ reviewRoundAllowed -->|false| limitOwnerResolution
150
+ limitOwnerResolution --> changes
151
+ prepareRereview --> stale
121
152
  changes -->|on: head.changed| cancelChanges
122
153
  cancelChanges --> stale
123
154
  blocked -->|on: review.retry| reviewUnblocked
@@ -0,0 +1,68 @@
1
+ ---
2
+ title: Revision Lifecycle
3
+ description: Authorizes immutable-head targeted feedback and child revision lifecycle; Task graph continues to own worker execution.
4
+ ---
5
+ flowchart LR
6
+ %% relay: initial none
7
+ none["state: NONE"]
8
+ requested["state: REQUESTED"]
9
+ queued["state: QUEUED"]
10
+ running["state: RUNNING"]
11
+ verified["state: VERIFIED"]
12
+ failed["state: FAILED"]
13
+ stale["state: STALE"]
14
+ reviewerAuthorized["guard: reviewerAuthorized"]
15
+ sameHead["guard: reviewHeadCurrent"]
16
+ ownerEligible["guard: originalTaskSucceeded"]
17
+ recordRequest["action: revision.recordRequest"]
18
+ recordQueue["action: revision.queueTask"]
19
+ recordVerified["action: revision.recordVerified"]
20
+ recordFailed["action: revision.recordFailed"]
21
+ retryQueued["guard: taskRetryQueued"]
22
+ retryQueue["action: revision.queueTask"]
23
+ markStaleRequested["action: revision.markStale"]
24
+ markStaleQueued["action: revision.markStale"]
25
+ markStaleRunning["action: revision.markStale"]
26
+ markStaleFailed["action: revision.markStale"]
27
+ verdictReady["guard: changesRequiredRecorded"]
28
+ none -->|on: revision.submit| reviewerAuthorized
29
+ reviewerAuthorized -->|true| sameHead
30
+ reviewerAuthorized -->|false| none
31
+ sameHead -->|true| ownerEligible
32
+ sameHead -->|false| none
33
+ ownerEligible -->|true| recordRequest
34
+ ownerEligible -->|false| none
35
+ recordRequest --> requested
36
+ %% Duplicate submissions are idempotent only when the durable request payload
37
+ %% matches. The reducer rejects a conflicting payload for the same request ID.
38
+ requested -->|on: revision.submit| requested
39
+ requested -->|on: revision.queue| verdictReady
40
+ verdictReady -->|true| recordQueue
41
+ verdictReady -->|false| requested
42
+ recordQueue --> queued
43
+ queued -->|on: revision.started| running
44
+ running -->|on: revision.verified| recordVerified
45
+ recordVerified --> verified
46
+ running -->|on: revision.failed| recordFailed
47
+ recordFailed --> failed
48
+ %% A failed/uncertain revision can resume only after Relay has authoritatively
49
+ %% requeued the SAME child through its recovery Graph.
50
+ failed -->|on: revision.retry| retryQueued
51
+ running -->|on: revision.retry| retryQueued
52
+ retryQueued -->|true| retryQueue
53
+ retryQueue --> queued
54
+ requested -->|on: review.head_changed| markStaleRequested
55
+ markStaleRequested --> stale
56
+ queued -->|on: review.head_changed| markStaleQueued
57
+ markStaleQueued --> stale
58
+ running -->|on: review.head_changed| markStaleRunning
59
+ markStaleRunning --> stale
60
+ failed -->|on: review.head_changed| markStaleFailed
61
+ markStaleFailed --> stale
62
+
63
+ %% A restarted reviewer execution is a new immutable review generation even
64
+ %% when the reviewed SHA is unchanged; old pending feedback cannot hold the gate.
65
+ requested -->|on: review.execution_changed| markStaleRequested
66
+ queued -->|on: review.execution_changed| markStaleQueued
67
+ running -->|on: review.execution_changed| markStaleRunning
68
+ failed -->|on: review.execution_changed| markStaleFailed