@outerlayer/cli 0.38.0-next.20261111172503 → 0.38.0-next.20261111182110
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/{agent-setup-HXEWWT6K.js → agent-setup-U4XTZO56.js} +2 -2
- package/dist/build-info.json +1 -1
- package/dist/{check-HC7E2BFS.js → check-XIJ2MOWV.js} +12 -12
- package/dist/{chunk-WV43CAGI.js → chunk-3SHX2D37.js} +1 -1
- package/dist/{chunk-QOP2CYYY.js → chunk-6GZL5RIV.js} +2 -2
- package/dist/{chunk-N3XAJZGV.js → chunk-6YOXYZC2.js} +2 -2
- package/dist/{chunk-2FJYZUZE.js → chunk-AMFCM4H7.js} +1 -1
- package/dist/{chunk-OKSYYMD2.js → chunk-BATSP67Z.js} +1 -1
- package/dist/{chunk-TJ7OVPR7.js → chunk-BECC4325.js} +1 -1
- package/dist/{chunk-HNQLZ7CK.js → chunk-CAQSGGPJ.js} +17 -3
- package/dist/{chunk-DKMSDIWM.js → chunk-CT4PKI24.js} +5 -5
- package/dist/{chunk-FUONFFTG.js → chunk-CZDYUKA6.js} +1 -1
- package/dist/{chunk-T6QX3S64.js → chunk-D5GR3U2O.js} +4 -4
- package/dist/{chunk-KN5VDMVL.js → chunk-DE3NQAR7.js} +1 -1
- package/dist/{chunk-EQZNHUEK.js → chunk-IHM7K6RS.js} +1 -1
- package/dist/{chunk-MG33BM7E.js → chunk-IN7QCBO5.js} +1 -1
- package/dist/{chunk-7XORCWWZ.js → chunk-ORLJK7UT.js} +2 -2
- package/dist/{chunk-VCNY5VAF.js → chunk-PBHAM73F.js} +1 -1
- package/dist/{chunk-UHOP4IMQ.js → chunk-QENFVQ7O.js} +1 -1
- package/dist/{chunk-KFB7KFEK.js → chunk-QH5NV7EQ.js} +2 -2
- package/dist/{chunk-YOFYW4EE.js → chunk-R3S2A7YF.js} +9 -9
- package/dist/{chunk-TUH2STQV.js → chunk-TH3K67SR.js} +1 -1
- package/dist/{chunk-M2WESKWY.js → chunk-TMROYEP4.js} +1 -1
- package/dist/{chunk-ONTXC6D3.js → chunk-UPUHL3KC.js} +1 -1
- package/dist/{chunk-O5ERYWXA.js → chunk-XAVR7JHO.js} +2 -2
- package/dist/{chunk-LMVHXHGQ.js → chunk-ZC2BXXKB.js} +4 -4
- package/dist/{cli-EOY2DOOD.js → cli-Y5CRBNQQ.js} +81 -81
- package/dist/{command-OD2UYKKQ.js → command-2RX7FULE.js} +9 -9
- package/dist/{connect-cmd-FIPFU4X4.js → connect-cmd-DSP6HJRP.js} +1 -1
- package/dist/{container-start-NISTFOL2.js → container-start-DFFZVSGX.js} +10 -10
- package/dist/{context-show-cmd-SOUPRIUD.js → context-show-cmd-BPZX3OUE.js} +2 -2
- package/dist/{demo-voice-cmd-JZOO3TL5.js → demo-voice-cmd-CMCPERTJ.js} +6 -6
- package/dist/{doctor-OU54YSDJ.js → doctor-ZVHGEA3C.js} +10 -10
- package/dist/{emit-artifact-cmd-ZU7JHEYN.js → emit-artifact-cmd-VJ3C36RU.js} +5 -5
- package/dist/{emit-criteria-cmd-4DSDN3CZ.js → emit-criteria-cmd-UOHOOSVV.js} +3 -3
- package/dist/{emit-demo-cmd-2CLCGPBS.js → emit-demo-cmd-KLYEKCB3.js} +6 -6
- package/dist/{emit-finding-cmd-GG2WT2ZN.js → emit-finding-cmd-FZWK3Y4Q.js} +3 -3
- package/dist/{emit-result-cmd-3MUFY5ES.js → emit-result-cmd-TODAXDFJ.js} +4 -4
- package/dist/{emit-step-cmd-KHXTWZFP.js → emit-step-cmd-QI52ZB57.js} +3 -3
- package/dist/{findings-cmd-OSJ2Y3IC.js → findings-cmd-O7I2GKRO.js} +3 -3
- package/dist/{fleet-readiness-JE3MTT3R.js → fleet-readiness-BY7PY5FF.js} +1 -1
- package/dist/{governing-source-FQKK5RCJ.js → governing-source-XRLJFSPE.js} +4 -4
- package/dist/{host-checks-PIVAISJF.js → host-checks-U5JKQQMM.js} +8 -8
- package/dist/index.js +1 -1
- package/dist/{init-4WHNRYJK.js → init-65RN5X55.js} +8 -8
- package/dist/{init-CSOKCOU2.js → init-CYTHJSTQ.js} +8 -8
- package/dist/{init-agent-N4SCUBDT.js → init-agent-R4ZOEFI3.js} +8 -8
- package/dist/{init-cmd-7HDKDTUS.js → init-cmd-L4EFMAQ4.js} +5 -5
- package/dist/{init-update-UFZX37SD.js → init-update-ACLVXFS7.js} +3 -3
- package/dist/{loop-DH7PXRWV.js → loop-4ATDJGQV.js} +12 -12
- package/dist/{machine-Y3VIABUB.js → machine-UIA7MN3U.js} +8 -8
- package/dist/{run-cmd-R4EB4TKJ.js → run-cmd-ZVNOKJB3.js} +3 -3
- package/dist/{runner-key-DIVDANJ3.js → runner-key-AOK7W733.js} +9 -9
- package/dist/{session-sender-NMZGHC65.js → session-sender-V3INPB34.js} +5 -5
- package/dist/{spec-cmd-Z26RVBY6.js → spec-cmd-LYGXRFVY.js} +4 -4
- package/dist/{status-CJSJY6XJ.js → status-SPPT7WU5.js} +8 -8
- package/dist/{sync-cmd-WE46ELML.js → sync-cmd-EDSOKOXS.js} +4 -4
- package/dist/{update-steps-QTCJF6DY.js → update-steps-XPEATLFQ.js} +9 -9
- package/dist/{watch-O5BOUDHZ.js → watch-GBDNXFAK.js} +4 -4
- package/dist/{work-claim-cmd-35CRWPQK.js → work-claim-cmd-SHKDYS7J.js} +4 -4
- package/dist/{work-cmd-4NMKJHC5.js → work-cmd-QR62TX6Q.js} +3 -3
- package/dist/{work-comment-cmd-4FLBLGH3.js → work-comment-cmd-DUDVMT6U.js} +4 -4
- package/dist/{work-demo-cmd-ZFZLPJHZ.js → work-demo-cmd-YJ654BQP.js} +3 -3
- package/dist/{work-logs-cmd-2CGBAPNO.js → work-logs-cmd-RUNYYALP.js} +3 -3
- package/dist/{work-needs-attention-cmd-SXZHDR4U.js → work-needs-attention-cmd-NRDFGJPP.js} +3 -3
- package/dist/{work-no-change-cmd-EFDSBICP.js → work-no-change-cmd-FDA7PYB7.js} +3 -3
- package/dist/{work-open-pr-cmd-272NR4QR.js → work-open-pr-cmd-LEWPNTW5.js} +4 -4
- package/dist/{work-pr-cmd-OJ7ZGDKB.js → work-pr-cmd-Y4O34WDA.js} +3 -3
- package/dist/{work-proofs-cmd-CZFDNMXW.js → work-proofs-cmd-QKIEJJRF.js} +4 -4
- package/dist/{work-proofs-record-BVFYTMES.js → work-proofs-record-2M4A5OIF.js} +9 -9
- package/dist/{work-stop-cmd-UHGV6AGA.js → work-stop-cmd-HH2SSJIO.js} +3 -3
- package/package.json +1 -1
- package/skill-pack/maintained/outerlayer-build/SKILL.md +26 -31
- package/skill-pack/maintained/outerlayer-build/references/agent-briefs.md +12 -77
- package/skill-pack/maintained/outerlayer-build/references/code-review-territories.md +89 -0
- package/skill-pack/maintained/outerlayer-build/references/release.md +9 -9
- package/skill-pack/maintained/outerlayer-cli/SKILL.md +3 -2
- package/skill-pack/maintained/outerlayer-evidence/SKILL.md +2 -6
- package/skill-pack/shipped.json +1 -0
- package/skill-pack/template/build/SKILL.md +1 -1
- package/skill-pack/maintained/outerlayer-build/references/review-briefs.md +0 -293
- package/skill-pack/maintained/outerlayer-build/references/review-loop.md +0 -164
|
@@ -1,164 +0,0 @@
|
|
|
1
|
-
# Review phase: the review loop
|
|
2
|
-
|
|
3
|
-
Run this after the implementer's branch is green and before anything is
|
|
4
|
-
pushed. The reviewer, refuter and mutation briefs are in
|
|
5
|
-
[review-briefs.md](review-briefs.md). The merger and fix briefs are in
|
|
6
|
-
[agent-briefs.md](agent-briefs.md). Spawn every brief verbatim.
|
|
7
|
-
|
|
8
|
-
## Tier
|
|
9
|
-
|
|
10
|
-
Before spawning anyone, record a tier verdict in the state file: the tier,
|
|
11
|
-
the reviewers, the round budget, the limit on agents in flight, and one or
|
|
12
|
-
two sentences on the diff's shape and risk. No verdict means stop and
|
|
13
|
-
escalate. Read the tier off the finished diff, never off the issue. Count the
|
|
14
|
-
diff's non-test production lines and note what it touches.
|
|
15
|
-
|
|
16
|
-
"Floor" means risky surfaces: authorization, tenancy or access control, data
|
|
17
|
-
access, schema or migrations, secrets and environment handling, and any
|
|
18
|
-
surface that runs with elevated privileges. A diff that touches one is `full`
|
|
19
|
-
whatever its size.
|
|
20
|
-
|
|
21
|
-
| Item and diff | Tier | Reviewers | Judge |
|
|
22
|
-
|---|---|---|---|
|
|
23
|
-
| No criteria recorded | small | one generalist | no judge runs |
|
|
24
|
-
| Under ~40 lines, off the floor | small | one generalist | when criteria exist |
|
|
25
|
-
| Up to ~800 lines, off the floor | medium | generalist + one focused reviewer | when criteria exist |
|
|
26
|
-
| Floor, or larger | full | generalist + up to three | when criteria exist |
|
|
27
|
-
|
|
28
|
-
An item with no criteria recorded is `small` whatever its diff, and no judge
|
|
29
|
-
runs, so the `acceptance-criteria` check gets no result. That happens only when the build could not draft a single criterion, since
|
|
30
|
-
an issue with no criteria gets a drafted list. A drafted list
|
|
31
|
-
(`criteria.source` is `drafted`) is tiered and judged like criteria the issue
|
|
32
|
-
wrote.
|
|
33
|
-
|
|
34
|
-
- **Small.** One generalist reads the full diff. No focused reviewer and no
|
|
35
|
-
mutation agent. The orchestrator runs the repository's mutation tool itself
|
|
36
|
-
when it has one, and a survivor on a new line is a proof-strength finding.
|
|
37
|
-
There is no merger: the orchestrator reads the one report and writes the
|
|
38
|
-
class table. One fix pass. The orchestrator reruns each confirmed class's
|
|
39
|
-
test and the gate itself. Round budget one. Only blocker and major
|
|
40
|
-
findings block. A minor is fixed when its repair stays inside files the
|
|
41
|
-
diff already touches, and otherwise goes in the final report, unverified.
|
|
42
|
-
- **Medium.** The generalist plus one focused reviewer: the one whose
|
|
43
|
-
territory holds the diff's largest surface. Use the contracts reviewer for a
|
|
44
|
-
changed shared interface, the test-strength reviewer for a change that is
|
|
45
|
-
mostly tests, the failure-path reviewer for new failure paths, and the
|
|
46
|
-
hygiene reviewer otherwise. No mutation agent. Round budget two, where round
|
|
47
|
-
two is the check below and never a second panel.
|
|
48
|
-
- **Full.** The generalist plus at most three focused reviewers. On a risky
|
|
49
|
-
surface, the security reviewer and the failure-path reviewer are always two
|
|
50
|
-
of them. One mutation checker, when the repository has a mutation tool.
|
|
51
|
-
Round budget two.
|
|
52
|
-
|
|
53
|
-
More reviewers than this find more claims, but the extra ones are refuted at
|
|
54
|
-
the same rate. What grows is the refuter wave and the fix pass behind them.
|
|
55
|
-
|
|
56
|
-
The limit on agents in flight is twelve unless the rationale argues
|
|
57
|
-
otherwise, and never above twenty. It counts every agent a stage spawns. A
|
|
58
|
-
stage with more work runs in successive waves, each finishing before the next
|
|
59
|
-
starts. A round that finds more blocking classes than the budget can verify
|
|
60
|
-
is not a scheduling problem. Stop and escalate: a person decides whether the
|
|
61
|
-
change is still worth fixing.
|
|
62
|
-
|
|
63
|
-
Models: use one model for every review role unless the team says otherwise.
|
|
64
|
-
A reviewer on a risky surface, or the refuter of a blocking class, never
|
|
65
|
-
moves to a weaker model than the rest.
|
|
66
|
-
|
|
67
|
-
The Reviewing model setting names that model. Default: the model the session runs on.
|
|
68
|
-
|
|
69
|
-
## Panel
|
|
70
|
-
|
|
71
|
-
Write `build-reports/round-1-bundle.md` first: the branch diff against its
|
|
72
|
-
base, the issue body, the criteria, the changed-file list, and the list of
|
|
73
|
-
test files at head. Every reviewer reads the bundle first and opens source
|
|
74
|
-
files only where it is not enough.
|
|
75
|
-
|
|
76
|
-
Spawn the tier's reviewers in parallel, blind to each other and cold. Each
|
|
77
|
-
gets the bundle path, the instructions-file pointer, the shared preamble and
|
|
78
|
-
one reviewer brief from [review-briefs.md](review-briefs.md). A short focus
|
|
79
|
-
addendum may add emphasis inside the reviewer's territory. It never removes
|
|
80
|
-
territory or edits the brief. The generalist's addendum names any territory
|
|
81
|
-
no other reviewer covers this round. Each reviewer writes its full report to
|
|
82
|
-
`build-reports/round-1-<role>.md` and returns the ten-line summary.
|
|
83
|
-
|
|
84
|
-
The run keeps one scratch worktree for every agent that needs an isolated
|
|
85
|
-
tree. Create it once under the system temp directory, install once, record its
|
|
86
|
-
path in the state file, hand it to one agent at a time, and delete it at the
|
|
87
|
-
end of this phase.
|
|
88
|
-
|
|
89
|
-
## Merge
|
|
90
|
-
|
|
91
|
-
One merger agent, on the Merger brief, reads the round's reports and returns
|
|
92
|
-
the class table only. A class is a claim about a pattern, so findings that
|
|
93
|
-
share a kind and a repair are one class.
|
|
94
|
-
|
|
95
|
-
A finding is a class only when it carries its reproduction: a failing test, a
|
|
96
|
-
command and its output, or the exact input and the code path that mishandles
|
|
97
|
-
it. A finding with reasoning alone is a note. Notes go at the end of the
|
|
98
|
-
merged file, and no refuter or fix agent sees them. The final report lists
|
|
99
|
-
them.
|
|
100
|
-
|
|
101
|
-
A finding whose repair lies outside the issue's goal, or outside the files the
|
|
102
|
-
diff touches and the code that calls them, is not a class. It is a candidate
|
|
103
|
-
issue. The exception is a behavior or security defect the diff itself
|
|
104
|
-
introduced.
|
|
105
|
-
|
|
106
|
-
More than twenty classes from one round means the merge over-split. The
|
|
107
|
-
merger gets one pass to consolidate.
|
|
108
|
-
|
|
109
|
-
## Verify
|
|
110
|
-
|
|
111
|
-
Group the classes by area: two classes share an area when a file appears in
|
|
112
|
-
both. Spawn one refuter per area, at most three, each holding every class in
|
|
113
|
-
its area. Each refuter reads the claims and the code, not the finders'
|
|
114
|
-
reasoning, and writes one verdict file per class, returning one line per
|
|
115
|
-
class: the id, refuted or confirmed, and the severity and kind it assigns.
|
|
116
|
-
|
|
117
|
-
A confirmed finding arrives as the refuter's failing test. Where a test is
|
|
118
|
-
impossible, such as a comment that lies, the brief says so in one line.
|
|
119
|
-
|
|
120
|
-
A confirmed hygiene class of minor severity or below gets no refuter. It is
|
|
121
|
-
fixed when its repair stays inside the diff's files, and otherwise recorded,
|
|
122
|
-
unverified. A nit gets no refuter and goes to an "Unverified, non-blocking"
|
|
123
|
-
section that is never dropped.
|
|
124
|
-
|
|
125
|
-
Under `full`, spawn the mutation checker in the same wave, in the scratch
|
|
126
|
-
worktree. Each surviving mutant is a confirmed class of kind proof strength
|
|
127
|
-
and goes to the fix stage without a refuter. The fix stage waits for both.
|
|
128
|
-
|
|
129
|
-
## Fix
|
|
130
|
-
|
|
131
|
-
The implementer runs again on the Fix brief. Its input is the list of refuter
|
|
132
|
-
verdict files and the mutation report, never pasted findings. It fixes
|
|
133
|
-
classes, not instances. With one group, or fewer than eight confirmed classes,
|
|
134
|
-
one fix agent works on the branch. Otherwise partition by area into at most
|
|
135
|
-
three groups. Each group's agent works in its own worktree on a branch from
|
|
136
|
-
the feature branch head, and the groups are merged into the feature branch in
|
|
137
|
-
turn. A conflict means the partition was wrong: re-run that group on the
|
|
138
|
-
merged head.
|
|
139
|
-
|
|
140
|
-
## Check
|
|
141
|
-
|
|
142
|
-
Round two is a check and never a panel. Rerun every confirmed class's test
|
|
143
|
-
yourself, in one command, then run the gate. Then spawn one generalist
|
|
144
|
-
over the fix hunks and the code they call. It reconciles each class against
|
|
145
|
-
its fix report, attacks the fix hunks and their blast radius, and hunts for a
|
|
146
|
-
fix for one class that undoes another. It writes `build-reports/round-2-check.md`.
|
|
147
|
-
|
|
148
|
-
A new class the check confirms gets one more fix pass, and the orchestrator
|
|
149
|
-
reruns its test and the gate as proof. A class still open after that ends the
|
|
150
|
-
budget: escalate. Repeated fix rounds add defects nearly as fast as they
|
|
151
|
-
remove them.
|
|
152
|
-
|
|
153
|
-
## Stop
|
|
154
|
-
|
|
155
|
-
A confirmed finding blocks when its severity is minor or above and its kind
|
|
156
|
-
is behavior, security, data integrity or proof strength. Under `small`, only
|
|
157
|
-
major or above blocks. Confirmed hygiene findings are fixed in the round and
|
|
158
|
-
never block. Done means zero confirmed blocking findings within the round
|
|
159
|
-
budget. Budget spent without convergence means escalate.
|
|
160
|
-
|
|
161
|
-
Finish by writing the review report as one HTML file: the tier and why, the
|
|
162
|
-
classes with their verdicts, what was fixed, and an "Unverified,
|
|
163
|
-
non-blocking" section for anything left unrefuted. Emit it with
|
|
164
|
-
`outerlayer emit artifact <report>.html`, with no `--for`.
|