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.
- package/dist/cli-help.js +10 -4
- package/dist/cli-prompt.js +2 -1
- package/dist/cli-revision.js +49 -0
- package/dist/cli-worker-task.js +15 -0
- package/dist/cli.js +11 -2
- package/dist/dashboard-html.js +2 -2
- package/dist/dependency-revision-execution.js +152 -0
- package/dist/dependency-validity.js +17 -0
- package/dist/final-review-role.js +17 -0
- package/dist/force-restate-validation.js +3 -2
- package/dist/host-invocation-store.js +18 -4
- package/dist/interactive-invocation.js +37 -5
- package/dist/job-pr-number-migration.js +2 -1
- package/dist/managed-worker-input.js +2 -1
- package/dist/planner-agent-roles.js +18 -0
- package/dist/planner-runtime.js +7 -1
- package/dist/planner-task-ids.js +1 -0
- package/dist/planner.js +11 -6
- package/dist/reconciler-review.js +78 -96
- package/dist/reconciler-runtime.js +14 -5
- package/dist/reconciler.js +21 -11
- package/dist/relay-store.js +2 -0
- package/dist/relayd-control.js +31 -0
- package/dist/review-evidence.js +44 -0
- package/dist/review-generation-fence.js +2 -1
- package/dist/review-revision-execution.js +86 -0
- package/dist/review-revision-merge.js +15 -0
- package/dist/review-revision-model.js +191 -0
- package/dist/review-revision-policy.js +49 -0
- package/dist/review-revision-settlement.js +54 -0
- package/dist/review-revision-stale.js +57 -0
- package/dist/reviewer-thread.js +41 -1
- package/dist/runtime-status.js +13 -4
- package/dist/single-job-task-control.js +1 -1
- package/dist/task-context.js +3 -2
- package/dist/worker-failure-recovery.js +2 -1
- package/dist/workflow/dependency-revision-v2.js +16 -0
- package/dist/workflow/entity-creation.js +2 -0
- package/dist/workflow/review-v2.js +6 -2
- package/dist/workflow/revision-v2.js +32 -0
- package/dist/workflow/task-reconcile.js +3 -0
- package/package.json +1 -1
- package/skills/agents-relay/agents/job-acceptance-reviewer.agent.md +41 -0
- package/skills/agents-relay/agents/planner.agent.md +6 -3
- package/skills/agents-relay/contracts/event-contract.md +55 -1
- package/skills/agents-relay/contracts/task-job-contract.md +6 -0
- package/workflow/dependency-revision.mmd +30 -0
- package/workflow/interactive-invocation.mmd +8 -2
- package/workflow/review-lifecycle.mmd +40 -9
- 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
|
-
|
|
45
|
-
|
|
46
|
-
|
|
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|
|
|
100
|
-
|
|
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|
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
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
|