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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vouchington-tooling",
3
- "version": "3.0.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": {
@@ -4,57 +4,57 @@
4
4
  {
5
5
  "name": "blackboard",
6
6
  "plugin": "vouchington-workflow",
7
- "pluginVersion": "0.23.0",
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.0",
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.0",
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.0",
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.0",
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.0",
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.0",
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.0",
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.0",
57
+ "pluginVersion": "0.23.2",
58
58
  "path": "triage-sweep/SKILL.md",
59
59
  "prerequisites": [
60
60
  "triage-loop",
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: retrospective
3
- description: Summarize completed work from verified facts and the session journal.
3
+ description: Summarize completed work from verified facts and the session journal, including when handing a PR to a human.
4
4
  ---
5
5
 
6
6
  # Retrospective
@@ -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 the standing final
48
- reviewer. When the adapter does not turn it on, skip every `vouchington-reviewer` step below and
49
- never report `awaiting-final-review`. When it is on, the adapter also names the local clone of
50
- `vouchington/vouchington-reviewer`. The CLI is not published to npm, so the loop runs it from
51
- there as `pnpm --dir <checkout> exec vouchington-reviewer <command>`. Stop and ask when the gate
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 standing final
71
- reviewer approved: `vouchington-reviewer status --repo <owner>/<name> --pr <N>` exits 0 (see
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, `vouchington-reviewer status` still
176
- exits 0 for it, requeue it only
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 with
283
- `gh api --method POST repos/<owner>/<name>/issues/<N>/labels -f 'labels[]=final-review:requested'`
284
- (or message the `final-reviewer` session with `<owner>/<name>#<N>`); adding it again requests a
285
- re-review after new commits. The standing reviewer lives in `vouchington/vouchington-reviewer`.
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 (`vouchington-reviewer status` exits
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, `vouchington-reviewer status` exits 0 for that head (see
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