axstack 0.20.12 → 0.20.13
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/README.md +2 -2
- package/docs/workflows.md +3 -3
- package/package.json +1 -1
- package/skills/axstack/references/automations.md +13 -7
- package/skills/axstack/references/lifecycle.md +3 -2
- package/skills/axstack/references/review-manager-prompt.md +3 -2
- package/skills/axstack/references/watch-manager-prompt.md +3 -3
- package/skills/axstack-watch/references/watch-runtime.md +2 -2
package/README.md
CHANGED
|
@@ -112,8 +112,8 @@ eligible peer-review requests, and the other monitors your open PRs and handles
|
|
|
112
112
|
authorized repair events.
|
|
113
113
|
|
|
114
114
|
The lanes use staggered 15-minute schedules. Each pass uses a fresh finite
|
|
115
|
-
session in an isolated workspace and admits
|
|
116
|
-
|
|
115
|
+
session in an isolated workspace and admits eligible actionable PR events within
|
|
116
|
+
measured host capacity. Waiting PRs remain tracked without consuming
|
|
117
117
|
execution slots, so a large open-PR backlog does not require an idle agent per PR.
|
|
118
118
|
Completed passes save continuity and retire their own verified resources.
|
|
119
119
|
Held jobs preserve evidence, use private worktree-local temporary paths, and
|
package/docs/workflows.md
CHANGED
|
@@ -192,9 +192,9 @@ read-only observer for standalone watches and never sends.
|
|
|
192
192
|
The accepted contract has exactly two logical native manager lanes: review at
|
|
193
193
|
minutes `0,15,30,45` and watch at `7,22,37,52`. Each scheduled pass uses a
|
|
194
194
|
fresh finite session in a new isolated workspace, scans complete
|
|
195
|
-
discovery pages, and admits
|
|
196
|
-
|
|
197
|
-
settle. Each job uses one repository-parented worktree; managers never check out
|
|
195
|
+
discovery pages, and admits eligible actionable PR events within measured host
|
|
196
|
+
capacity across both lanes. Waiting PRs stay covered and consume no slot after
|
|
197
|
+
owned descendants settle. Each job uses one repository-parented worktree; managers never check out
|
|
198
198
|
PR branches in their own workspaces.
|
|
199
199
|
|
|
200
200
|
Every pass reconciles saved, GitHub, and native Orca state across all same-lane
|
package/package.json
CHANGED
|
@@ -150,11 +150,15 @@ all scanned; those ten occupy zero slots.
|
|
|
150
150
|
|
|
151
151
|
## Admission and fairness
|
|
152
152
|
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
153
|
+
The review manager and watch manager admit all eligible actionable PR events
|
|
154
|
+
that measured host capacity can support across ticks. Before each admission,
|
|
155
|
+
inspect available memory, CPU load, and active worker trees across both lanes;
|
|
156
|
+
account for the whole proposed worker tree, dependencies, spending limits, and
|
|
157
|
+
exclusive ownership. Report unavailable metrics as unknown; use the remaining
|
|
158
|
+
host evidence rather than treating a missing metric alone as a blocker. Defer
|
|
159
|
+
an event when observed pressure or uncertain headroom cannot support its whole
|
|
160
|
+
tree, record the reason, and remeasure on the next pass. Do not use a fixed
|
|
161
|
+
PR-job count or reserve capacity for either lane.
|
|
158
162
|
|
|
159
163
|
A slot covers one bounded PR event and remains occupied while its author,
|
|
160
164
|
reviewers, or other owned descendants are active or unsettled. Leaf workers do
|
|
@@ -163,8 +167,10 @@ frees the slot even while the PR stays open.
|
|
|
163
167
|
|
|
164
168
|
Inspect all eligible PRs before admission. Preserve unserved work in the
|
|
165
169
|
compact run record and select the oldest actionable unserved event first, with
|
|
166
|
-
ascending repository and PR-number tie breaks.
|
|
167
|
-
|
|
170
|
+
ascending repository and PR-number tie breaks. Continue admitting eligible
|
|
171
|
+
events while measured capacity supports their whole worker trees. Reconsider
|
|
172
|
+
deferred events as trees settle or host capacity changes; repeatedly changing
|
|
173
|
+
PRs cannot starve older unserved work.
|
|
168
174
|
|
|
169
175
|
## Per-PR jobs
|
|
170
176
|
|
|
@@ -113,8 +113,9 @@ differs from merged; human merges.
|
|
|
113
113
|
## Watch health
|
|
114
114
|
|
|
115
115
|
Native review and watch lanes use fresh finite sessions in isolated per-pass
|
|
116
|
-
workspaces on staggered 15-minute schedules. Each admits
|
|
117
|
-
waiting PRs remain covered without
|
|
116
|
+
workspaces on staggered 15-minute schedules. Each admits eligible actionable PR
|
|
117
|
+
events within measured host capacity; waiting PRs remain covered without
|
|
118
|
+
reserving slots. Bounded PR jobs own their
|
|
118
119
|
events, use per-PR worktrees, and settle after descendants settle. Build no
|
|
119
120
|
custom scheduler, state engine, or legacy fallback. Details live in
|
|
120
121
|
[Watch runtime](../../axstack-watch/references/watch-runtime.md).
|
|
@@ -4,8 +4,9 @@ You are a fresh finite review-manager session in its isolated per-pass Orca work
|
|
|
4
4
|
through the installed `axstack-review` skill; that skill loads its packaged
|
|
5
5
|
`../axstack/references/automations.md` contract by relative reference. Discover
|
|
6
6
|
every eligible peer-review event and invoke the skill through Orca for each
|
|
7
|
-
admitted bounded PR job. Keep complete coverage
|
|
8
|
-
|
|
7
|
+
admitted bounded PR job. Keep complete coverage and admit actionable events
|
|
8
|
+
within measured host capacity, preserve exact ownership and receipts, settle
|
|
9
|
+
completed trees,
|
|
9
10
|
and stay quiet when nothing changed. Reconcile before admission, save durable
|
|
10
11
|
continuity outside this workspace, then retire only this pass workspace as the
|
|
11
12
|
final action under the contract's ownership guards. Reconcile the whole lane,
|
|
@@ -4,9 +4,9 @@ You are a fresh finite watch-manager session in its isolated per-pass Orca works
|
|
|
4
4
|
through the installed `axstack-watch` skill; that skill loads its packaged
|
|
5
5
|
`../axstack/references/automations.md` contract by relative reference. Discover
|
|
6
6
|
every eligible own-PR event and invoke the skill through Orca for each admitted
|
|
7
|
-
bounded PR job. Keep complete coverage
|
|
8
|
-
|
|
9
|
-
completed trees, and stay quiet when nothing changed. Reconcile before
|
|
7
|
+
bounded PR job. Keep complete coverage and admit actionable events within
|
|
8
|
+
measured host capacity, preserve exact ownership, candidates, holds, and receipts,
|
|
9
|
+
settle completed trees, and stay quiet when nothing changed. Reconcile before
|
|
10
10
|
admission, save durable continuity outside this workspace, then retire only this
|
|
11
11
|
pass workspace as the final action under the contract's ownership guards.
|
|
12
12
|
Reconcile the whole lane, not just this workspace. Never check out a PR branch here.
|
|
@@ -18,8 +18,8 @@ The separate native watch manager lane follows the
|
|
|
18
18
|
uses a new isolated workspace and fresh finite session at minutes `7,22,37,52`.
|
|
19
19
|
Continuity survives outside disposable workspaces; admission reconciles the
|
|
20
20
|
whole lane across workspaces. It scans every eligible own PR and
|
|
21
|
-
admits
|
|
22
|
-
without reserving slots. Each job uses its own repository-parented worktree and
|
|
21
|
+
admits bounded actionable-event jobs within measured host capacity. Waiting PRs
|
|
22
|
+
stay covered without reserving slots. Each job uses its own repository-parented worktree and
|
|
23
23
|
settles with all descendants; no model, per-PR timer, or polling loop waits for
|
|
24
24
|
CI, review, a user decision, or merge.
|
|
25
25
|
|