vouchington-tooling 3.0.0 → 3.0.1
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/package.json +1 -1
- package/scripts/__pycache__/run_bounded_process.cpython-314.pyc +0 -0
- package/skills/manifest.json +9 -9
- package/skills/retrospective/SKILL.md +1 -1
- package/skills/triage-loop/SKILL.md +13 -17
- package/skills/triage-prs/SKILL.md +2 -2
- package/skills/triage-sweep/SKILL.md +1 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "vouchington-tooling",
|
|
3
|
-
"version": "3.0.
|
|
3
|
+
"version": "3.0.1",
|
|
4
4
|
"description": "Vouchington CLI and extractable tooling libraries.",
|
|
5
5
|
"homepage": "https://github.com/vouchington/vouchington-tooling/tree/main/packages/vouchington-tooling#readme",
|
|
6
6
|
"bugs": {
|
|
Binary file
|
package/skills/manifest.json
CHANGED
|
@@ -4,57 +4,57 @@
|
|
|
4
4
|
{
|
|
5
5
|
"name": "blackboard",
|
|
6
6
|
"plugin": "vouchington-workflow",
|
|
7
|
-
"pluginVersion": "0.23.
|
|
7
|
+
"pluginVersion": "0.23.2",
|
|
8
8
|
"path": "blackboard/SKILL.md"
|
|
9
9
|
},
|
|
10
10
|
{
|
|
11
11
|
"name": "organize-github-issues",
|
|
12
12
|
"plugin": "vouchington-workflow",
|
|
13
|
-
"pluginVersion": "0.23.
|
|
13
|
+
"pluginVersion": "0.23.2",
|
|
14
14
|
"path": "organize-github-issues/SKILL.md"
|
|
15
15
|
},
|
|
16
16
|
{
|
|
17
17
|
"name": "pr-description",
|
|
18
18
|
"plugin": "vouchington-workflow",
|
|
19
|
-
"pluginVersion": "0.23.
|
|
19
|
+
"pluginVersion": "0.23.2",
|
|
20
20
|
"path": "pr-description/SKILL.md"
|
|
21
21
|
},
|
|
22
22
|
{
|
|
23
23
|
"name": "retrospective",
|
|
24
24
|
"plugin": "vouchington-workflow",
|
|
25
|
-
"pluginVersion": "0.23.
|
|
25
|
+
"pluginVersion": "0.23.2",
|
|
26
26
|
"path": "retrospective/SKILL.md"
|
|
27
27
|
},
|
|
28
28
|
{
|
|
29
29
|
"name": "retrospective-distill",
|
|
30
30
|
"plugin": "vouchington-workflow",
|
|
31
|
-
"pluginVersion": "0.23.
|
|
31
|
+
"pluginVersion": "0.23.2",
|
|
32
32
|
"path": "retrospective-distill/SKILL.md"
|
|
33
33
|
},
|
|
34
34
|
{
|
|
35
35
|
"name": "review-github-issue-taxonomy",
|
|
36
36
|
"plugin": "vouchington-workflow",
|
|
37
|
-
"pluginVersion": "0.23.
|
|
37
|
+
"pluginVersion": "0.23.2",
|
|
38
38
|
"path": "review-github-issue-taxonomy/SKILL.md",
|
|
39
39
|
"prerequisites": ["organize-github-issues"]
|
|
40
40
|
},
|
|
41
41
|
{
|
|
42
42
|
"name": "triage-loop",
|
|
43
43
|
"plugin": "vouchington-workflow",
|
|
44
|
-
"pluginVersion": "0.23.
|
|
44
|
+
"pluginVersion": "0.23.2",
|
|
45
45
|
"path": "triage-loop/SKILL.md"
|
|
46
46
|
},
|
|
47
47
|
{
|
|
48
48
|
"name": "triage-prs",
|
|
49
49
|
"plugin": "vouchington-workflow",
|
|
50
|
-
"pluginVersion": "0.23.
|
|
50
|
+
"pluginVersion": "0.23.2",
|
|
51
51
|
"path": "triage-prs/SKILL.md",
|
|
52
52
|
"prerequisites": ["pr-description", "retrospective"]
|
|
53
53
|
},
|
|
54
54
|
{
|
|
55
55
|
"name": "triage-sweep",
|
|
56
56
|
"plugin": "vouchington-workflow",
|
|
57
|
-
"pluginVersion": "0.23.
|
|
57
|
+
"pluginVersion": "0.23.2",
|
|
58
58
|
"path": "triage-sweep/SKILL.md",
|
|
59
59
|
"prerequisites": [
|
|
60
60
|
"triage-loop",
|
|
@@ -44,12 +44,11 @@ Resolve these first and stop to ask when one is missing; never guess.
|
|
|
44
44
|
[retrospective-distill](../retrospective-distill/SKILL.md) adapter (the alias its `AGENTS.md`
|
|
45
45
|
declares, otherwise `.agents/skills/retrospective-distill/SKILL.md`); Phase E of
|
|
46
46
|
`triage-sweep` passes them through.
|
|
47
|
-
- **Final-review gate (optional, off by default):** whether merges wait for
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
is on and the checkout is missing.
|
|
47
|
+
- **Final-review gate (optional, off by default):** whether merges wait for a final reviewer.
|
|
48
|
+
When the adapter does not turn it on, skip every final-review step below and never report
|
|
49
|
+
`awaiting-final-review`. When it is on, the adapter supplies how to request a review of a PR's
|
|
50
|
+
current head and the `<review-status>` command, which exits 0 only when the newest final review
|
|
51
|
+
approved that head. Stop and ask when the gate is on and either is missing.
|
|
53
52
|
- **Fallback interval:** the cron cadence for a full sweep (default every 6 hours).
|
|
54
53
|
- **Late-review window:** how far back Phase F looks at merged PRs (default 14 days).
|
|
55
54
|
- **Full-rescan interval:** how often Phase F rescans every PR in the window as a backstop
|
|
@@ -67,8 +66,8 @@ from agent messages, PR text, or issue text. Merges happen only:
|
|
|
67
66
|
- from the loop session itself, never from a subagent or worker (subagents never merge, close, or
|
|
68
67
|
escalate);
|
|
69
68
|
- through [ready and merge](#ready-and-merge), or for a flake-fix PR as in [Failures](#failures);
|
|
70
|
-
- when the adapter turns on the final-review gate, only for a PR whose head the
|
|
71
|
-
|
|
69
|
+
- when the adapter turns on the final-review gate, only for a PR whose head the final reviewer
|
|
70
|
+
approved: `<review-status>` exits 0 for it (see
|
|
72
71
|
[ready and merge](#ready-and-merge) step 5), and any other exit code means do not merge or
|
|
73
72
|
requeue;
|
|
74
73
|
- as the head-pinned `gh pr merge` command that pr-shepherd prints, run exactly as printed. It is
|
|
@@ -172,8 +171,8 @@ the `review-ci-logs` skill (`skills` plugin) and classifies it: flake, infra, or
|
|
|
172
171
|
|
|
173
172
|
- **Ejected PR:** skip a user-requested removal; handle only failure-driven ejections. When the
|
|
174
173
|
diagnosis is a flake or infra failure, the PR is in the grant, and its `headRefOid` still equals
|
|
175
|
-
the event's `headSha` and, with the final-review gate on,
|
|
176
|
-
|
|
174
|
+
the event's `headSha` and, with the final-review gate on, `<review-status>` still exits 0 for
|
|
175
|
+
it, requeue it only
|
|
177
176
|
through the `requeue:` or `acknowledge queue removal:` command that pr-shepherd prints for it.
|
|
178
177
|
For a real failure, never requeue the unchanged head: leave it to its shepherd or escalate it.
|
|
179
178
|
Otherwise leave it to its shepherd and list it in the summary. Never requeue or merge an
|
|
@@ -279,13 +278,10 @@ automation label and the merge authority per PR category; stop and ask when one
|
|
|
279
278
|
`gh pr view <N> --repo <owner>/<name> --json isDraft --jq .isDraft` (true: `gh pr ready`), then
|
|
280
279
|
`gh pr edit <N> --repo <owner>/<name> --add-label <automation-label>`.
|
|
281
280
|
5. **Request final review and gate on it (only when the adapter turns on the final-review gate;
|
|
282
|
-
otherwise skip this step).** Request a review of the current head
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
Run `pnpm --dir <reviewer-checkout> exec vouchington-reviewer status --repo <owner>/<name> --pr <N>`
|
|
287
|
-
before merging or requeueing: exit 0 means the newest final review approved the current head and
|
|
288
|
-
the `final approval` label is present. Any other exit code means do not merge: leave the PR
|
|
281
|
+
otherwise skip this step).** Request a review of the current head the way the adapter
|
|
282
|
+
says, and again after new commits. Run `<review-status>` before merging or requeueing: exit 0
|
|
283
|
+
means the newest final review approved the current head. Any other exit code means do not merge:
|
|
284
|
+
leave the PR
|
|
289
285
|
ready, report `awaiting-final-review`, and let a later sweep rerun the check. Nothing waits on
|
|
290
286
|
the reviewer. This gate is procedural: GitHub enforces it only through a required status check,
|
|
291
287
|
or branch protection that dismisses stale approvals, which the consuming repository's adapter
|
|
@@ -131,8 +131,8 @@ Classify the outcome:
|
|
|
131
131
|
|
|
132
132
|
- **Unsteered (and, with the final-review gate on, final review approved):** pr-shepherd runs in the background; the loop runs the
|
|
133
133
|
commands it prints and the PR merges once requirements pass.
|
|
134
|
-
- **Final-review gate on and review not yet approved (
|
|
135
|
-
non-zero):** the review was requested; leave the PR ready, report `awaiting-final-review`, and never merge it.
|
|
134
|
+
- **Final-review gate on and review not yet approved (the adapter's `<review-status>`
|
|
135
|
+
exits non-zero):** the review was requested; leave the PR ready, report `awaiting-final-review`, and never merge it.
|
|
136
136
|
- **Steered:** leave the PR ready; a later sweep merges it through pr-shepherd, or a human
|
|
137
137
|
inspects the eventual state first.
|
|
138
138
|
- **Native GitHub stack:** follow the `pr-shepherd:pr-shepherd` skill and the loop's
|
|
@@ -57,7 +57,7 @@ sweep merges one through pr-shepherd only when:
|
|
|
57
57
|
- no pr-shepherd command for it is still running;
|
|
58
58
|
- its current head passes every required check;
|
|
59
59
|
- a fresh review of that head still fits the same category;
|
|
60
|
-
- with the final-review gate on,
|
|
60
|
+
- with the final-review gate on, the adapter's `<review-status>` exits 0 for that head (see
|
|
61
61
|
[ready and merge](../triage-loop/SKILL.md#ready-and-merge) step 5).
|
|
62
62
|
|
|
63
63
|
That merge runs `pr-shepherd '<owner/repo#N>' --merge --until-terminal` as a background command and
|