pi-lens 4.4.6 → 4.4.8
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/CHANGELOG.md +232 -0
- package/README.md +17 -3
- package/config/markdownlint/run-no-fix.mjs +36 -0
- package/dist/{chunk-ZQ6NZZTB.js → chunk-2453RRJ2.js} +44 -6
- package/dist/{chunk-GZE7WOI4.js → chunk-2BKUFQKR.js} +696 -330
- package/dist/chunk-2TS4GLOJ.js +31 -0
- package/dist/{chunk-2DMLM3ZO.js → chunk-2ZE3AUJQ.js} +12 -14
- package/dist/{chunk-OJLTLYHB.js → chunk-35WKJWO5.js} +51 -33
- package/dist/chunk-3JAHQBSY.js +27 -0
- package/dist/{chunk-PO45POGF.js → chunk-3O5EII3W.js} +2 -2
- package/dist/chunk-447YZL4S.js +25 -0
- package/dist/{chunk-TIYGSODX.js → chunk-4B2YFN4U.js} +28 -22
- package/dist/{chunk-OSTKYB55.js → chunk-4BKU7PV3.js} +1 -1
- package/dist/{chunk-XQCSWV2G.js → chunk-4LL2VRNY.js} +27 -28
- package/dist/{chunk-MA77RSFN.js → chunk-4NBWFYWW.js} +9 -9
- package/dist/{chunk-75SY4F24.js → chunk-4QG55RRC.js} +12 -12
- package/dist/{chunk-K2YGBXOA.js → chunk-4W52ZKZX.js} +2 -2
- package/dist/{chunk-Z2XAOKHK.js → chunk-565VRUP4.js} +2 -2
- package/dist/{chunk-CFRQMBGP.js → chunk-57X2CDRX.js} +23 -23
- package/dist/{chunk-XAIT2YGS.js → chunk-5F3XF3SX.js} +7 -15
- package/dist/{chunk-UHGF5UT5.js → chunk-5RNB4HVK.js} +1 -1
- package/dist/{chunk-Q4EMRFNA.js → chunk-5T5A6YAJ.js} +35 -34
- package/dist/{chunk-W5LGKNET.js → chunk-6FIRFP6A.js} +12 -12
- package/dist/{chunk-KLQVC3XC.js → chunk-6GMGEKQN.js} +36 -9
- package/dist/{chunk-UN4TEBWN.js → chunk-6LJOJ6EO.js} +20 -15
- package/dist/{chunk-HK6JVFZC.js → chunk-6YUNI7B5.js} +3 -3
- package/dist/{chunk-PKES3ISE.js → chunk-7ANZ7XDD.js} +2 -2
- package/dist/{chunk-VQH24FIP.js → chunk-7CGIDRIK.js} +16 -15
- package/dist/{chunk-SCIUNBPF.js → chunk-7MAD5ZAY.js} +16 -17
- package/dist/{chunk-OOU2WZZE.js → chunk-7TNILKGY.js} +1 -1
- package/dist/{chunk-LEJOJDXL.js → chunk-A5GRLYPZ.js} +9 -9
- package/dist/{chunk-AE37FEGH.js → chunk-AGGUWKRK.js} +1 -1
- package/dist/{chunk-BWYQUPOS.js → chunk-BBET6HD6.js} +1 -1
- package/dist/{chunk-GAACZY6R.js → chunk-BHWW6FAX.js} +14 -13
- package/dist/{chunk-A3YNG5KP.js → chunk-BOPDQ7AZ.js} +23 -21
- package/dist/{chunk-MKVZQUEG.js → chunk-BQG2QFVO.js} +215 -134
- package/dist/{chunk-EVDGNG4F.js → chunk-BUZIQDFS.js} +3 -3
- package/dist/{chunk-2PHMIAKO.js → chunk-CM73PPGD.js} +4 -4
- package/dist/{chunk-63RIVFQI.js → chunk-CUDD35TW.js} +10 -9
- package/dist/{chunk-BM5GS6ZH.js → chunk-CZL44WFN.js} +2 -2
- package/dist/{chunk-QGSTQH4D.js → chunk-DIWK3LBC.js} +12 -15
- package/dist/{chunk-JL6CXUMW.js → chunk-DYRZGUMA.js} +2 -2
- package/dist/{chunk-NDMCVUYK.js → chunk-FHEV6T4L.js} +22 -18
- package/dist/{chunk-4PCQCU47.js → chunk-FRLAUP2B.js} +4 -4
- package/dist/{chunk-RZOXUSPC.js → chunk-G5GV2Q7K.js} +2 -2
- package/dist/{chunk-2RLWJO5K.js → chunk-G6JKM4O7.js} +7 -7
- package/dist/chunk-GGYOZWHW.js +27 -0
- package/dist/{chunk-DC4CFXM5.js → chunk-GIRBSBGL.js} +6 -5
- package/dist/{chunk-PQJFG24Z.js → chunk-GMROJJRN.js} +1292 -946
- package/dist/{chunk-ZUUI3ZSA.js → chunk-HHR7WGCI.js} +3 -3
- package/dist/{chunk-TIQJPRDD.js → chunk-HKIL6DCL.js} +3 -2
- package/dist/{chunk-VPBIMOAQ.js → chunk-HUAM7QG3.js} +15 -13
- package/dist/{chunk-ZYNI26MI.js → chunk-HXFUTMX2.js} +2 -2
- package/dist/{chunk-W5R5SABV.js → chunk-I22THIHI.js} +12 -12
- package/dist/chunk-IE5D3RA5.js +58 -0
- package/dist/{chunk-MT6BVNFW.js → chunk-IYVYZQRL.js} +10 -16
- package/dist/{chunk-ARD426WI.js → chunk-JBP7KESM.js} +1 -1
- package/dist/{chunk-MN7MHUXQ.js → chunk-JE6HKLC7.js} +2 -2
- package/dist/{chunk-3MYEA7QD.js → chunk-JPRDTY5S.js} +85 -3
- package/dist/{chunk-CJYKEW2L.js → chunk-JYLOYTZD.js} +17 -1
- package/dist/{chunk-5APMQ2IJ.js → chunk-JZRP4DGP.js} +2 -2
- package/dist/{chunk-AMXIUN2R.js → chunk-KZ4ALBCH.js} +2 -2
- package/dist/{chunk-W2V54OCL.js → chunk-L3CLUGDY.js} +3 -3
- package/dist/{chunk-DMSLNKF7.js → chunk-L4NEVZ4T.js} +28 -27
- package/dist/chunk-LPYTPNOJ.js +22 -0
- package/dist/{chunk-BI5LAQ3Y.js → chunk-LSFXZLPW.js} +2071 -1725
- package/dist/{chunk-2DDDCJDL.js → chunk-MC6VB2E5.js} +4 -4
- package/dist/{chunk-U2SDMG7C.js → chunk-NM2NWH55.js} +5 -5
- package/dist/{chunk-Q4FCYCRE.js → chunk-NSPVR3FN.js} +19 -18
- package/dist/{chunk-VG5JS5SW.js → chunk-O2ARHQKF.js} +2 -2
- package/dist/{chunk-KSR7RGQY.js → chunk-O4N5BQ3T.js} +10 -10
- package/dist/{chunk-5ZR3APIM.js → chunk-OC7VWJBZ.js} +39 -40
- package/dist/chunk-OFNMHPBT.js +89 -0
- package/dist/{chunk-YSBHPOY6.js → chunk-OWTG6UMO.js} +21 -21
- package/dist/{chunk-7RQXA5GG.js → chunk-OY7WZI7Q.js} +13 -12
- package/dist/{chunk-5CV5ITZF.js → chunk-OZWXLJMX.js} +2 -2
- package/dist/{chunk-F6X3YJWD.js → chunk-PIQQM32Y.js} +2 -2
- package/dist/chunk-PKLB2XJL.js +8 -0
- package/dist/{chunk-DQXSPYRI.js → chunk-PKSUMEPT.js} +17 -4
- package/dist/{chunk-YISME6ON.js → chunk-PPKECBPP.js} +1 -1
- package/dist/{chunk-4AVZ3TG7.js → chunk-R2QQC33W.js} +14 -14
- package/dist/{chunk-GMTFDAOK.js → chunk-R4QWJQ2H.js} +11 -11
- package/dist/{chunk-V63BC55Q.js → chunk-RGGH6M34.js} +1 -1
- package/dist/{chunk-SJJYRZB4.js → chunk-RZG472YW.js} +116 -26
- package/dist/{chunk-NIU2IPC5.js → chunk-SDFKOLSF.js} +6 -6
- package/dist/{chunk-H7HTEQUZ.js → chunk-SFLHSL5R.js} +9 -9
- package/dist/{chunk-FA5LDARD.js → chunk-SP4TFY5F.js} +14 -13
- package/dist/{chunk-J6JP25XU.js → chunk-SQC7K3SP.js} +4 -3
- package/dist/{chunk-T7FTXGS3.js → chunk-T2S3FNNJ.js} +44 -42
- package/dist/{chunk-S67UJDGQ.js → chunk-TV6RXRYH.js} +10 -10
- package/dist/{chunk-GNSIWBAT.js → chunk-U3AS2FR6.js} +3 -3
- package/dist/{chunk-WIZWZR4C.js → chunk-UHHLR2VY.js} +43 -41
- package/dist/chunk-UYXV5NIS.js +20 -0
- package/dist/{chunk-VSFLRN5Y.js → chunk-VLQ7UKZH.js} +1 -1
- package/dist/{chunk-FFL3A2VP.js → chunk-VN3L2JWZ.js} +46 -72
- package/dist/{chunk-Z7IGUAXL.js → chunk-VOP4PJKA.js} +12 -8
- package/dist/{chunk-F5Z6URKM.js → chunk-VOXTCULR.js} +2 -2
- package/dist/{chunk-NNKXDXXS.js → chunk-VPLBLWFO.js} +14 -8
- package/dist/chunk-W3BGKBBK.js +27 -0
- package/dist/{chunk-ZKXQKGWZ.js → chunk-WC6WRNQT.js} +4 -3
- package/dist/{chunk-Q3UZHW6N.js → chunk-WMDUT4KH.js} +1150 -1138
- package/dist/{chunk-KXF5R4UN.js → chunk-WQV6BI4Q.js} +1 -1
- package/dist/chunk-WXUDRAG6.js +24 -0
- package/dist/{chunk-OLAWH5UQ.js → chunk-X35S7HSB.js} +29 -10
- package/dist/{chunk-YBSONGSZ.js → chunk-X66YJ2SS.js} +40 -34
- package/dist/{chunk-U6OC3QEM.js → chunk-XOMGO63G.js} +22 -21
- package/dist/{chunk-WQOIR3QY.js → chunk-XWIME22V.js} +13 -13
- package/dist/{chunk-3WEPUD2V.js → chunk-XYLC35E4.js} +202 -103
- package/dist/{chunk-UCGQT677.js → chunk-YHGYAEFH.js} +18 -18
- package/dist/{chunk-V3APN3DY.js → chunk-ZFORSIED.js} +13 -13
- package/dist/{chunk-BHUWL2Y3.js → chunk-ZKLTNLAW.js} +64 -73
- package/dist/chunk-ZONZ6YY3.js +74 -0
- package/dist/chunk-ZSM35JF4.js +30 -0
- package/dist/{chunk-PPIBVH4R.js → chunk-ZZDIOAAJ.js} +15 -6
- package/dist/index.js +8817 -6239
- package/dist/mcp/analyze-cli.js +10 -10
- package/dist/mcp/cli.js +44 -42
- package/dist/mcp/server.js +2236 -861
- package/dist/mcp/worker.js +62 -61
- package/dist/probes/installer.js +20 -19
- package/docs/adr/0003-git-guard-latch-writer.md +11 -6
- package/docs/agent-tools.md +29 -11
- package/docs/alignment-families.md +29 -0
- package/docs/ast-grep_rules_catalog.md +6 -4
- package/docs/ci-bot-pr-checks.md +126 -0
- package/docs/configuration.md +99 -3
- package/docs/defect-shapes.md +68 -11
- package/docs/dependencies.md +1 -0
- package/docs/engineering-principles.md +27 -2
- package/docs/environment-variables.md +14 -0
- package/docs/features.md +13 -3
- package/docs/globalconfig.md +12 -1
- package/docs/invariants/git-guard-host.md +38 -0
- package/docs/invariants/language-config.md +15 -4
- package/docs/invariants/lsp-trust-exec.md +22 -2
- package/docs/invariants/paths-os.md +4 -2
- package/docs/invariants/session-telemetry.md +42 -2
- package/docs/lsp-capability-matrix.md +208 -84
- package/docs/lsp-idle-eviction.md +3 -5
- package/docs/merge-queue-rollout.md +1 -1
- package/docs/pi-lens-fixer.md +31 -17
- package/docs/pi-lens-merge-policy.md +27 -15
- package/docs/pi-lens-monitor.md +9 -0
- package/docs/pi-lens-orchestration.md +4 -1
- package/docs/pi-lens-reviewer.md +5 -5
- package/docs/pi-lens-subagent.md +13 -7
- package/docs/public-api-stability.md +18 -2
- package/docs/schema/pi-lens-config-v1.json +33 -0
- package/docs/servercapabilities.md +1 -1
- package/docs/settings.md +15 -6
- package/docs/usage.md +5 -0
- package/docs/word-index.md +17 -5
- package/package.json +5 -3
- package/rules/ast-grep-rules/rule-tests/no-accumulating-spread-js-test.yml +37 -0
- package/rules/ast-grep-rules/rule-tests/ts-redundant-filter-map-test.yml +12 -1
- package/rules/ast-grep-rules/rule-tests-disabled/filter-then-map-js-test.yml +12 -0
- package/rules/ast-grep-rules/rule-tests-disabled/filter-then-map-test.yml +25 -0
- package/rules/ast-grep-rules/rules/no-accumulating-spread-js.yml +49 -1
- package/rules/ast-grep-rules/rules/ts-redundant-filter-map.yml +9 -1
- package/rules/ast-grep-rules/rules-disabled/filter-then-map-js.yml +17 -0
- package/rules/ast-grep-rules/rules-disabled/filter-then-map.yml +36 -0
- package/rules/ast-grep-rules/self-scan-baseline.json +1 -1
- package/dist/chunk-2F47TQOA.js +0 -73
- package/dist/chunk-2X4VLOCC.js +0 -55
- package/dist/chunk-4WX4CTUE.js +0 -57
- package/dist/chunk-FJIVKLPH.js +0 -31
- package/dist/chunk-G2B7F6ZU.js +0 -88
- package/dist/chunk-GTAI2J6U.js +0 -27
- package/dist/chunk-IPDG45G5.js +0 -26
- package/dist/chunk-P4QNXS6I.js +0 -27
- package/dist/chunk-Q6D6VMI4.js +0 -22
- package/dist/chunk-SXGD4ANG.js +0 -25
- package/dist/chunk-XCUHKYCQ.js +0 -23
- package/dist/chunk-YRD4ISED.js +0 -30
|
@@ -45,6 +45,29 @@ anything). The native TS7 launch variant (`typescript7`/`typescript7-clean`,
|
|
|
45
45
|
#524/#526) is deliberately excluded from comparison against classic's marker —
|
|
46
46
|
they share a server id but not a verified clean-signal behavior.
|
|
47
47
|
|
|
48
|
+
The `typescript` row has three launch variants, chosen in
|
|
49
|
+
`TypeScriptServer.spawn` (`clients/lsp/server.ts`). The project's own
|
|
50
|
+
TypeScript 7+ decides first: with `@effect/tsgo` installed beside it (the same
|
|
51
|
+
`node_modules` level, with a readable manifest version and an existing
|
|
52
|
+
`.bin/effect-tsgo` path) the launch is `effect-tsgo tsc --lsp --stdio`
|
|
53
|
+
(`launchVariant: "effect-tsgo"`, #4914); otherwise the native `tsc --lsp --stdio`
|
|
54
|
+
(`"native-ts7"`); with TypeScript 6 or older, or none, the classic
|
|
55
|
+
`typescript-language-server` (`"classic"`). Installing `@effect/tsgo` is the
|
|
56
|
+
only opt-in. pi-lens never installs it, adds no setting for it, and runs the
|
|
57
|
+
binary only when pi trusts the project, like the project's compiler. A
|
|
58
|
+
malformed `@effect/tsgo` install keeps the native launch and never takes an
|
|
59
|
+
ancestor's. So does an install the finder admits but the launcher cannot start
|
|
60
|
+
(no exec bit, a directory at the bin path): the failure records one
|
|
61
|
+
`lsp-registry-decision` row per root per generation and the native launch
|
|
62
|
+
follows. A process that starts and then fails `initialize` is not covered.
|
|
63
|
+
`effect-tsgo` wraps the same typescript-go server, so it uses the
|
|
64
|
+
native variant's wait strategy and cascade tier (`isTsgoLaunchVariant`,
|
|
65
|
+
`clients/lsp/server-traits.ts`) and is excluded from classic's marker the same
|
|
66
|
+
way; its own clean-signal behavior is not measured separately. The nightly
|
|
67
|
+
`effect-tsgo` smoke row (`scripts/smoke-tools.mjs`, pinned
|
|
68
|
+
`@effect/tsgo@0.62.0` on `typescript@7.0.2`) requires the `effect-tsgo` variant
|
|
69
|
+
and a published type error.
|
|
70
|
+
|
|
48
71
|
What IS gated is the pair of COMMITTED sources:
|
|
49
72
|
`tests/config/lsp-clean-behavior-census.test.ts` (#3347) compares the
|
|
50
73
|
`clean-behavior` column below against the `silentOnClean` markers in both
|
|
@@ -106,7 +129,7 @@ belonged to another live client of the same server id became `typescript`'s
|
|
|
106
129
|
| **2 — push, publishes-versioned** | `publishDiagnostics([])` **with version** on every scan, incl. clean→clean | YES, currency-proven via version | ast-grep |
|
|
107
130
|
| **2\* — push, publishes-unversioned** | re-publishes on a clean scan but **version-less** — the wait still early-returns (the client accepts a version-less publish as fresh: it can't be proven stale), but currency is only *temporally correlated*, not proven. Since #3484 the client fences a server measured to answer a `documentSymbol` fence before it publishes (`diagnosticsFence: "reply-first"`: yaml, intelephense): a pre-edit publish is dropped until the fence's reply. Every other 2\* server (docker publishes before answering; prisma, taplo, zls, dart, gleam, clojure unmarked) keeps this behaviour | YES at runtime, with a staleness-risk caveat (not a latency cost) | opengrep |
|
|
108
131
|
| **3 — push, silent on clean** | server publishes nothing when nothing changed | **NO** — budget-wait floor (safe; a timeout is *not* a false clean). **This tier is #458's learned-deadline target set.** | typescript-language-server |
|
|
109
|
-
| **
|
|
132
|
+
| **Unconfirmed — custom, no evidence** | custom `lsp.servers.*` entry has no pull provider and has not published in this session | **NO** — diagnostics are unconfirmed (reported `inconclusive`, never `unsupported`); skip the wait until the server publishes | Dexter, groovy-language-server |
|
|
110
133
|
|
|
111
134
|
Detection is **cached** at `initialize` (`detectWorkspaceDiagnosticsSupport` →
|
|
112
135
|
`state.workspaceDiagnosticsSupport.mode`, upgraded on `client/registerCapability`),
|
|
@@ -116,8 +139,22 @@ Custom servers without a pull provider begin with one bounded first-contact
|
|
|
116
139
|
probe. The probe uses the smaller of the server's push-wait budget and the live
|
|
117
140
|
hook deadline. If the hook cuts it off first, the result remains unconfirmed and
|
|
118
141
|
the next touch probes again. Only silence through the full push budget latches
|
|
119
|
-
that server id
|
|
120
|
-
|
|
142
|
+
that server id for the service session: the latch skips the wait and the file
|
|
143
|
+
reads **unconfirmed** (`inconclusive` in a batch outcome, "not the same as 0
|
|
144
|
+
diagnostics" in a single-file result), never `unsupported` and never clean. Any
|
|
145
|
+
publish, however late and whatever file it is for, clears the latch (#5128), and
|
|
146
|
+
the server returns to the ordinary push-wait policy. A server that publishes
|
|
147
|
+
only for files with errors (groovy-language-server sends nothing for a file that
|
|
148
|
+
compiles) therefore reads unconfirmed on clean files, and its findings arrive as
|
|
149
|
+
soon as it publishes them. A publish that lands while the first-contact wait is
|
|
150
|
+
still in flight prevents the latch.
|
|
151
|
+
|
|
152
|
+
The first-contact budget on the per-edit path is the strategy's
|
|
153
|
+
`aggregateWaitMs` (1500 ms). It is a cost, not a verdict: the latch is
|
|
154
|
+
recoverable, so a server slower than the budget pays 1.5 s once and reads
|
|
155
|
+
unconfirmed until its first publish, instead of being lost for the session.
|
|
156
|
+
Raising it would charge up to the larger budget on the first edit of every
|
|
157
|
+
custom server that never publishes for a clean file.
|
|
121
158
|
|
|
122
159
|
## Matrix (dev box + CI nightly; mode last refreshed 2026-06-17 from run 27713958681, clean-behavior probed in run 35914033696 — #460)
|
|
123
160
|
|
|
@@ -135,17 +172,23 @@ Merges never blank a prior good value, so a CI non-result leaves the dev
|
|
|
135
172
|
classification standing.
|
|
136
173
|
|
|
137
174
|
Two bounded guards keep that preservation from hiding a dead instrument
|
|
138
|
-
(#3401). A
|
|
139
|
-
re-observe
|
|
140
|
-
`
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
175
|
+
(#3401, #4512). A measured `first-publish` or `clean-behavior` cell the nightly
|
|
176
|
+
probe does not re-observe keeps its last known value and is marked in the
|
|
177
|
+
`stale` column with the date of the first miss (`since YYYY-MM-DD`). The refresh
|
|
178
|
+
never rewrites it to `unknown`: before #4512 a `direct` cell degraded to
|
|
179
|
+
`unknown` after five days, which erased five measured values in the #4338
|
|
180
|
+
refresh with nothing raised. The streak of consecutive nightly misses is kept
|
|
181
|
+
per lang and per axis in the refresh state below, so a `clean-behavior` miss one
|
|
182
|
+
night and a `first-publish` miss the next are two first misses; a cell whose
|
|
183
|
+
axis has missed two consecutive nights is
|
|
184
|
+
raised on one tracking issue (`nightly: LSP capability probe missed (stale
|
|
185
|
+
matrix cells)`), and an observation clears both the mark and the streak.
|
|
186
|
+
`empty-first` cells back the live `emptyFirstPublish` markers and are stamped
|
|
187
|
+
the same way (#4615): the refresh stamps the FIRST night it does not re-observe
|
|
188
|
+
one, and the first-publish census reds once that stamp is five days old, so the
|
|
189
|
+
cell+marker pair cannot outlive the instrument that produced it — a cell with
|
|
190
|
+
no live measurement behind it is no longer indistinguishable from a healthy
|
|
191
|
+
one. A `clean-behavior`/`tier` change is written only after two
|
|
149
192
|
consecutive nightly runs observe the same new value, so one flapping nightly
|
|
150
193
|
(ast-grep went 2 → 2* → 3 → 2* across four runs) cannot rewrite a cell; a night
|
|
151
194
|
that measured nothing for the lang resets the hold. A subset probe (`probe-clean-signal.mjs <langs>`) leaves the
|
|
@@ -160,6 +203,20 @@ master's doc otherwise (branch absent, squash-merged, or master edited the doc
|
|
|
160
203
|
since). Closing the bot PR unmerged does not reset the bookkeeping: the branch
|
|
161
204
|
is kept and keeps seeding, so only deleting `bot/lsp-docs-refresh` resets it.
|
|
162
205
|
|
|
206
|
+
The `version` and `install` columns (#4512) record what the nightly ran: the
|
|
207
|
+
first version token of the server's own version command (the `checkArgs` its
|
|
208
|
+
installer entry registers, `--version` by default, read within that entry's
|
|
209
|
+
verification timeout) and the installer route that resolved it (`global-path`, `npm-global`, `pip-user`, `pi-lens-auto`,
|
|
210
|
+
`github-release`, `maven-jar`, `archive-dist`). `characterize-lsp.mjs` writes
|
|
211
|
+
them from the installer's resolution for the one tool a fixture names; a fixture
|
|
212
|
+
that names none or several, a server the installer cannot find, or a launcher
|
|
213
|
+
that answers every argument by starting a JVM (`tree-manifest`) records nothing,
|
|
214
|
+
and the cell keeps its last known value or `—`. They record the installer's
|
|
215
|
+
resolution, not the path the LSP launch finally spawned, so a PATH binary that
|
|
216
|
+
shadows a managed one reads as `global-path`. A change in `version` or `install`
|
|
217
|
+
is not a capability flip: the refresh PR's landing check ignores those columns
|
|
218
|
+
and `stale`.
|
|
219
|
+
|
|
163
220
|
`vue`'s `clean-behavior` was hand-reset to `unknown` (#3390): its
|
|
164
221
|
`publishes-unversioned` cell came from 58/45 publishes that the shared
|
|
165
222
|
`extension.log` window had attributed to vue but that belonged to `tinymist`.
|
|
@@ -169,37 +226,37 @@ to be cleared by hand. It stays `unknown` until a run observes
|
|
|
169
226
|
`@vue/language-server` publish; `tests/config/lsp-clean-behavior-census.test.ts`
|
|
170
227
|
carries the named admission until then.
|
|
171
228
|
|
|
172
|
-
| lang | server | mode | clean-behavior | first-publish | tier | src |
|
|
173
|
-
|
|
174
|
-
| json | vscode-json-language-server | pull | — | n/a (pull) | 1 | dev+ci |
|
|
175
|
-
| css | vscode-css-language-server | pull | — | n/a (pull) | 1 | dev+ci |
|
|
176
|
-
| html | vscode-html-language-server | pull | — | n/a (pull) | 1 | dev+ci |
|
|
177
|
-
| rust | rust-analyzer | pull | — | n/a (pull) | 1 | dev+ci |
|
|
178
|
-
| svelte | svelte-language-server | pull | — | n/a (pull) | 1 | dev+ci |
|
|
179
|
-
| deno | deno (alt of typescript) | pull | — | n/a (pull) | 1 | dev+ci |
|
|
180
|
-
| ruby | ruby-lsp | pull | — | n/a (pull) | 1 | ci |
|
|
181
|
-
| csharp | csharp-ls | pull | — | n/a (pull) | 1 | ci |
|
|
182
|
-
| typescript | typescript-language-server | push-only | silent | direct | 3 | dev+ci |
|
|
183
|
-
| markdown | marksman | push-only | silent | direct | 3 | ci |
|
|
184
|
-
| lua | lua-language-server | push-only | silent | direct | 3 | dev+ci |
|
|
185
|
-
| python | pyright | push-only | publishes-versioned | direct | 2 | dev+ci |
|
|
186
|
-
| jedi | jedi-language-server (alt of python) | push-only | publishes-versioned | direct | 2 | ci |
|
|
187
|
-
| yaml | yaml-language-server | push-only | publishes-unversioned | direct | 2* | dev+ci |
|
|
188
|
-
| shell | bash-language-server | push-only | publishes-versioned | direct | 2 | dev+ci |
|
|
189
|
-
| dockerfile | docker-langserver | push-only | publishes-unversioned | direct | 2* | dev+ci |
|
|
190
|
-
| dockerfile-official | docker-language-server (official) | push-only | publishes-versioned | direct | 2 | dev+ci |
|
|
191
|
-
| toml | taplo | push-only | publishes-unversioned | direct | 2* | dev+ci |
|
|
192
|
-
| terraform | terraform-ls | push-only | publishes-unversioned | direct | 2* | dev+ci |
|
|
193
|
-
| prisma | @prisma/language-server | push-only | publishes-unversioned | direct | 2* | dev+ci |
|
|
194
|
-
| php | intelephense | push-only | publishes-unversioned | empty-first | 2* | dev+ci |
|
|
195
|
-
| zig | zls | push-only | publishes-unversioned | direct | 2* | dev+ci |
|
|
196
|
-
| vue | @vue/language-server | push-only | unknown | unknown | 2/3? | dev+ci |
|
|
197
|
-
| dart | dart language-server | push-only | publishes-unversioned | direct | 2* | ci |
|
|
198
|
-
| gleam | gleam lsp | push-only | publishes-unversioned | direct | 2* | ci |
|
|
199
|
-
| clojure | clojure-lsp | push-only | publishes-unversioned | direct | 2* | ci |
|
|
200
|
-
| opengrep | opengrep (aux) | push-only | publishes-unversioned | direct | 2* | dev+ci |
|
|
201
|
-
| ast-grep | ast-grep (aux) | push-only | publishes-versioned | direct | 2 | dev+ci |
|
|
202
|
-
| cue | CUE Language Server (cue lsp serve) | push-only | publishes-versioned | direct | 2 | dev+ci |
|
|
229
|
+
| lang | server | mode | clean-behavior | first-publish | tier | src | version | install | stale |
|
|
230
|
+
|---|---|---|---|---|---|---|---|---|---|
|
|
231
|
+
| json | vscode-json-language-server | pull | — | n/a (pull) | 1 | dev+ci | — | — | — |
|
|
232
|
+
| css | vscode-css-language-server | pull | — | n/a (pull) | 1 | dev+ci | — | — | — |
|
|
233
|
+
| html | vscode-html-language-server | pull | — | n/a (pull) | 1 | dev+ci | — | — | — |
|
|
234
|
+
| rust | rust-analyzer | pull | — | n/a (pull) | 1 | dev+ci | — | — | — |
|
|
235
|
+
| svelte | svelte-language-server | pull | — | n/a (pull) | 1 | dev+ci | — | — | — |
|
|
236
|
+
| deno | deno (alt of typescript) | pull | — | n/a (pull) | 1 | dev+ci | — | — | — |
|
|
237
|
+
| ruby | ruby-lsp | pull | — | n/a (pull) | 1 | ci | — | — | — |
|
|
238
|
+
| csharp | csharp-ls | pull | — | n/a (pull) | 1 | ci | — | — | — |
|
|
239
|
+
| typescript | typescript-language-server | push-only | silent | direct | 3 | dev+ci | — | — | — |
|
|
240
|
+
| markdown | marksman | push-only | silent | direct | 3 | ci | — | — | — |
|
|
241
|
+
| lua | lua-language-server | push-only | silent | direct | 3 | dev+ci | — | — | — |
|
|
242
|
+
| python | pyright | push-only | publishes-versioned | direct | 2 | dev+ci | — | — | — |
|
|
243
|
+
| jedi | jedi-language-server (alt of python) | push-only | publishes-versioned | direct | 2 | ci | — | — | — |
|
|
244
|
+
| yaml | yaml-language-server | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
245
|
+
| shell | bash-language-server | push-only | publishes-versioned | direct | 2 | dev+ci | — | — | — |
|
|
246
|
+
| dockerfile | docker-langserver | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
247
|
+
| dockerfile-official | docker-language-server (official) | push-only | publishes-versioned | direct | 2 | dev+ci | — | — | — |
|
|
248
|
+
| toml | taplo | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
249
|
+
| terraform | terraform-ls | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
250
|
+
| prisma | @prisma/language-server | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
251
|
+
| php | intelephense | push-only | publishes-unversioned | empty-first | 2* | dev+ci | — | — | — |
|
|
252
|
+
| zig | zls | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
253
|
+
| vue | @vue/language-server | push-only | unknown | unknown | 2/3? | dev+ci | — | — | — |
|
|
254
|
+
| dart | dart language-server | push-only | publishes-unversioned | direct | 2* | ci | — | — | — |
|
|
255
|
+
| gleam | gleam lsp | push-only | publishes-unversioned | direct | 2* | ci | — | — | — |
|
|
256
|
+
| clojure | clojure-lsp | push-only | publishes-unversioned | direct | 2* | ci | — | — | — |
|
|
257
|
+
| opengrep | opengrep (aux) | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
258
|
+
| ast-grep | ast-grep (aux) | push-only | publishes-versioned | direct | 2 | dev+ci | — | — | — |
|
|
259
|
+
| cue | CUE Language Server (cue lsp serve) | push-only | publishes-versioned | direct | 2 | dev+ci | — | — | — |
|
|
203
260
|
|
|
204
261
|
**Unknown — fixture exists, mode not yet captured.** The toolchain-gated family
|
|
205
262
|
(no auto-install today; tracked in #241) — `go` (gopls), `java` (jdtls),
|
|
@@ -285,55 +342,121 @@ and were characterized `push-only` in the run above).
|
|
|
285
342
|
|
|
286
343
|
Population: every server that declares `textDocumentSync.save` in
|
|
287
344
|
`docs/servercapabilities.md` (15 `save`, 5 `save+text`), plus zizmor, which
|
|
288
|
-
registers `textDocument/didSave` dynamically
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
345
|
+
registers `textDocument/didSave` dynamically and therefore never receives one
|
|
346
|
+
from pi-lens (its `didSave` registration is dynamic and pi-lens maps only the
|
|
347
|
+
static `initialize` reply). The `server` column is the registry id in
|
|
348
|
+
`clients/lsp/server.ts`, so a row can be matched against the capability
|
|
349
|
+
inventory mechanically.
|
|
350
|
+
|
|
351
|
+
`publishes after save only` states whether only a save makes the server answer:
|
|
352
|
+
|
|
353
|
+
| value | meaning |
|
|
354
|
+
|---|---|
|
|
355
|
+
| `no` | the seeded finding arrived without a save |
|
|
356
|
+
| `no (pull)` | pull mode: the `textDocument/diagnostic` request answered without a save, so no publish is involved |
|
|
357
|
+
| `yes` | the same bytes produced the finding only after a save |
|
|
358
|
+
| `yes (saved write)` | only a diagnostic-neutral edit plus a save produced it |
|
|
359
|
+
| `inconclusive` | no arm produced the finding, or the answer landed in the untriggered window between two arms and so belongs to no arm |
|
|
360
|
+
| `cannot measure` | no runner can install the server; the reason follows |
|
|
361
|
+
| `unknown` | no run has measured this row yet |
|
|
362
|
+
|
|
363
|
+
Regenerate it with
|
|
364
|
+
|
|
365
|
+
```text
|
|
366
|
+
node scripts/probe-save-verdict.mjs [lang ...] [--install] [--wait-ms <ms>] [--doc <path>]
|
|
367
|
+
```
|
|
368
|
+
|
|
369
|
+
The nightly `tool-smoke.yml` step "LSP save verdict (#3405)" runs it with
|
|
370
|
+
`--install` on the tool-smoke fixtures, so the measurement columns self-populate
|
|
371
|
+
through the same docs-refresh PR as `mode` and `clean-behavior` (#390). The probe
|
|
372
|
+
drives the real client and reports four arms of equal length: the seeded bytes
|
|
373
|
+
with `saved: false` (didOpen/didChange only), an untriggered window of the same
|
|
374
|
+
length, the SAME bytes with `saved: true` (so a publish has the save as its only
|
|
375
|
+
new input), and, only when nothing else answered, a diagnostic-neutral edit
|
|
376
|
+
plus a save. `scripts/lib/save-verdict.mjs` owns the classification, the wording
|
|
377
|
+
and the merge guard; a run rewrites the three measurement columns of the rows it
|
|
378
|
+
reached and copies every other row verbatim, so a runner that could not install a
|
|
379
|
+
server never blanks a measured cell.
|
|
380
|
+
|
|
381
|
+
A night that could not tell never erases an answer (#5060). A row that holds a
|
|
382
|
+
settled answer (`no`, `no (pull)`, `yes`, `yes (saved write)`) keeps it, with its
|
|
383
|
+
evidence, when the run measures `inconclusive` or `cannot measure`; only a
|
|
384
|
+
settled answer replaces a settled one, and a `yes` to `no` change stays a visible
|
|
385
|
+
flip. This table has no column for a night a row was not answered, so the held
|
|
386
|
+
night goes to the run log (`save-verdict: held back <server>`), to one
|
|
387
|
+
`::warning::` annotation per held server under GitHub Actions, and to the
|
|
388
|
+
`--summary` JSON (`heldBack`). No counter or issue tracks consecutive held
|
|
389
|
+
nights.
|
|
390
|
+
|
|
391
|
+
A pull-mode server answers a `textDocument/diagnostic` request rather than
|
|
392
|
+
publishing, so no arm of its run has the save as its only new input: it reads
|
|
393
|
+
`no (pull)` when the request answered without a save and `inconclusive`
|
|
394
|
+
otherwise, never `yes`.
|
|
395
|
+
|
|
396
|
+
The cells carry what a run OBSERVED, never when or where: each arm's elapsed time
|
|
397
|
+
and the `src` token that says CI or a dev box go to the run log, so a
|
|
398
|
+
re-measurement that changes only those is not a capability flip and the refresh PR
|
|
399
|
+
stays armed for auto-merge (#4512).
|
|
400
|
+
|
|
401
|
+
A row whose evidence names this command is a measurement by it. A row that names
|
|
402
|
+
a prior probe, a workflow run or a source commit instead is provenance from
|
|
403
|
+
before the command existed (or from a server no local run could reach), and the
|
|
404
|
+
dispatched nightly replaces it on the first night that reaches the server.
|
|
295
405
|
|
|
296
406
|
| server | save as declared | publishes after save only | verdict | evidence |
|
|
297
407
|
|---|---|---|---|---|
|
|
298
|
-
| expert | `save` | no |
|
|
299
|
-
| cpp
|
|
300
|
-
| lua | `save` | no | Measured:
|
|
301
|
-
| python-jedi | `save` | no | Measured:
|
|
302
|
-
| opengrep
|
|
303
|
-
| gleam | `save` | no |
|
|
304
|
-
| go
|
|
305
|
-
| zig
|
|
306
|
-
| rust
|
|
307
|
-
| terraform | `save` | no |
|
|
408
|
+
| expert | `save` | no | Prior measurement: answers with no `didSave` once the seed is under `lib/`. Gated. | #4768 arms A, B, C; nightly run 39852672584 (answered on call 6, 10955 ms); `tests/fixtures/nightly-floors/expert-readiness.json` |
|
|
409
|
+
| cpp | `save` | no | Measured: answers without a save (1 publish event on didOpen); a later save alone: silent (6000 ms). Gated. | `node scripts/probe-save-verdict.mjs` (fixture cpp) |
|
|
410
|
+
| lua | `save` | no | Measured: answers without a save (2 publish events on didOpen); a later save alone: silent (6000 ms). Gated. | `node scripts/probe-save-verdict.mjs` (fixture lua) |
|
|
411
|
+
| python-jedi | `save` | no | Measured: answers without a save (1 publish event on didOpen); a later save alone: silent (6000 ms). Gated. | `node scripts/probe-save-verdict.mjs` (fixture jedi) |
|
|
412
|
+
| opengrep | `save` | no | Measured: answers without a save (1 publish event on didOpen); a later save alone: silent (6000 ms). Auxiliary, not gated. | `node scripts/probe-save-verdict.mjs` (fixture opengrep) |
|
|
413
|
+
| gleam | `save` | no | Measured: answers without a save (1 publish event on didOpen); a later save alone: silent (6000 ms). Gated. | `node scripts/probe-save-verdict.mjs` (fixture gleam) |
|
|
414
|
+
| go | `save` | no | Source: `DidSave` calls `didModifyFiles`, the path a change takes. Gated. | golang/tools `02c9e4cb4c2f`, `gopls/internal/server/text_synchronization.go` |
|
|
415
|
+
| zig | `save` | no | Measured: answers without a save (1 publish event on didOpen); a later save alone: silent (6000 ms). Gated. | `node scripts/probe-save-verdict.mjs` (fixture zig) |
|
|
416
|
+
| rust | `save` | inconclusive | Measured: inconclusive — pull mode: every arm is a textDocument/diagnostic request, so no arm has the save as its only new input (arms: no-save silent (6000 ms), save alone silent (6000 ms), saved write silent (6000 ms)). Exempt from the clean gate. | `node scripts/probe-save-verdict.mjs` (fixture rust) |
|
|
417
|
+
| terraform | `save` | no | Measured: answers without a save (1 publish event on didOpen); a later save alone: silent (6000 ms). Gated. | `node scripts/probe-save-verdict.mjs` (fixture terraform) |
|
|
308
418
|
| fsharp | `save+text` | no | Source: a save holds the source and refreshes code lenses; diagnostics come from open and change checks. Exempt: 0 findings in every run. | ionide/FsAutoComplete `8f011f1395a4`, `src/FsAutoComplete/LspServers/AdaptiveFSharpLspServer.fs` (`TextDocumentDidSave`); nightly run 39845687189 |
|
|
309
|
-
| zizmor
|
|
310
|
-
| clojure | `save+text` |
|
|
311
|
-
| fish | `save+text` | unknown | Unverified: not measured. Gated
|
|
312
|
-
| tinymist | `save` |
|
|
313
|
-
| cue | `save` |
|
|
314
|
-
| csharp | `save+text` | unknown | Unverified: not measured. Pull mode, so diagnostics are requested and a save is unlikely to be the only trigger. Gated. |
|
|
315
|
-
| deno | `save` |
|
|
316
|
-
| svelte | `save` |
|
|
419
|
+
| zizmor | · (registered dynamically) | no | Source: `didSave` is registered dynamically and pi-lens does not map that registration, so no save is sent. Auxiliary, not gated. | zizmor `crates/zizmor/src/lsp.rs` (`initialized`); `clients/lsp/wait-policy/strategies.ts:400-410` (#3548) |
|
|
420
|
+
| clojure | `save+text` | no | Measured: answers without a save (1 publish event on didOpen); a later save alone: silent (6000 ms). Gated. | `node scripts/probe-save-verdict.mjs` (fixture clojure) |
|
|
421
|
+
| fish | `save+text` | unknown | Unverified: not measured. Gated. | none |
|
|
422
|
+
| tinymist | `save` | no | Measured: answers without a save (1 publish event on didOpen); a later save alone: 1 publish event. Gated. | `node scripts/probe-save-verdict.mjs` (fixture typst) |
|
|
423
|
+
| cue | `save` | no | Measured: answers without a save (1 publish event on didOpen); a later save alone: silent (6000 ms). Gated. | `node scripts/probe-save-verdict.mjs` (fixture cue) |
|
|
424
|
+
| csharp | `save+text` | unknown | Unverified: not measured. Pull mode, so diagnostics are requested and a save is unlikely to be the only trigger. Gated. | none |
|
|
425
|
+
| deno | `save` | no (pull) | Measured: pull mode — no save needed; a later save+request answered: 1 diagnostic. Gated. | `node scripts/probe-save-verdict.mjs` (fixture deno) |
|
|
426
|
+
| svelte | `save` | no (pull) | Measured: pull mode — no save needed; a later save+request answered: 2 diagnostics. Gated. | `node scripts/probe-save-verdict.mjs` (fixture svelte) |
|
|
317
427
|
| powershell | `save+text` | unknown | Unverified: not measured. Exempt: intermittent. | none |
|
|
318
|
-
| cmake | `save` |
|
|
428
|
+
| cmake | `save` | inconclusive | Measured: inconclusive — no arm published, so this fixture does not distinguish a save-triggered server from one that never diagnoses it (arms: no-save silent (6000 ms), save alone silent (6000 ms), saved write silent (6000 ms)). Exempt from the clean gate. | `node scripts/probe-save-verdict.mjs` (fixture cmake) |
|
|
319
429
|
|
|
320
430
|
Notes.
|
|
321
431
|
|
|
322
|
-
1. Probe.
|
|
323
|
-
(the
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
2.
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
432
|
+
1. Probe. `node scripts/probe-save-verdict.mjs` is the command that produces this
|
|
433
|
+
table (see the paragraph above). It reuses the tool-smoke fixtures and the
|
|
434
|
+
nightly that already installs those servers, so it is one measurement path, not
|
|
435
|
+
a second driver. The only other command #4768 named is
|
|
436
|
+
`node scripts/smoke-tools.mjs --lsp-gate`; that step drives the clean gate and
|
|
437
|
+
writes no save verdict.
|
|
438
|
+
2. clangd reconciled. #4527 recorded "base 1 of 5, head 5 of 5" and #4768 recorded
|
|
439
|
+
clangd publishing on `didOpen` alone; both hold, and they counted different
|
|
440
|
+
things. The 5 checks are the rows of the `lsp-did-save/analyze` verify scenario,
|
|
441
|
+
four of which require a `textDocument/didSave` on the wire, so its one passing
|
|
442
|
+
check on base is `control: clangd answered for a.c`: clangd published the
|
|
443
|
+
finding with `0 didSave(s)` captured. The sender was missing, not the
|
|
444
|
+
publish. The probe reproduces both arms with one seed and one window (6000 ms
|
|
445
|
+
each, one client): the no-save arm published on `didOpen`, and the save arm,
|
|
446
|
+
with the identical bytes and the save on the wire, published nothing, because
|
|
447
|
+
clangd does not republish identical bytes, the same property #4527 measured
|
|
448
|
+
when its own re-push left the cold query inconclusive. So #4768's verdict
|
|
449
|
+
stands, #4527's 1-of-5 → 5-of-5 is a sender measurement, and no clangd arm
|
|
450
|
+
reads `yes`.
|
|
332
451
|
3. Citations corrected against master. #4768 cites `clients/lsp/client.ts:4410`
|
|
333
452
|
for `sendDidSave`; it is at `clients/lsp/client.ts:4909`, with the save-capability
|
|
334
453
|
gate at line 4917. The opengrep rescan claim is at
|
|
335
454
|
`clients/lsp/wait-policy/strategies.ts:100`; line 345 is the
|
|
336
455
|
`emptyUntilRulesRefreshed` hold.
|
|
456
|
+
4. Clean-gate policy in a measured row is the fixture's own declaration, not
|
|
457
|
+
hand prose: `Gated.` is `lspGate: true`, `Auxiliary, not gated.` an auxiliary
|
|
458
|
+
scanner, and `Exempt from the clean gate.` a fixture whose `lspGateExempt`
|
|
459
|
+
reason lives in `scripts/smoke-tools.mjs`.
|
|
337
460
|
|
|
338
461
|
## Completing the matrix
|
|
339
462
|
The fixtures (`tests/fixtures/tool-smoke/<lang>/`) are durable and cover every
|
|
@@ -372,9 +495,10 @@ observations are never compared (a slow/absent server is not evidence either way
|
|
|
372
495
|
## Capability matrix refresh state (nightly-generated)
|
|
373
496
|
|
|
374
497
|
Bookkeeping for the two-run `first-publish`/`clean-behavior` hysteresis, the
|
|
375
|
-
|
|
376
|
-
|
|
498
|
+
first-miss stamps (#3401, #4615), the consecutive-night `missed-probe`
|
|
499
|
+
streaks behind the `stale` column (#4512) and consecutive-night
|
|
500
|
+
`idle-eviction` counts (#3989). Regenerated every run; never a measurement.
|
|
377
501
|
|
|
378
502
|
```json
|
|
379
|
-
{"idle-eviction":{"
|
|
503
|
+
{"idle-eviction":{"powershell":{"nights":[{"day":"2026-10-27","rssMb":155,"coldMs":2553}]}}}
|
|
380
504
|
```
|
|
@@ -15,7 +15,7 @@ respawned server reports every finding it reported before eviction; the
|
|
|
15
15
|
content-bound coverage check the auxiliary freeze depends on. A server that
|
|
16
16
|
cannot demonstrate it is never proposed for eviction on perf grounds alone.
|
|
17
17
|
|
|
18
|
-
_Last generated: 2026-10-
|
|
18
|
+
_Last generated: 2026-10-27 on linux; 49 registry servers: 33 eligible, 0 vetoed, 2 inconclusive, 14 unavailable (0 not reached: budget)._
|
|
19
19
|
|
|
20
20
|
## Per-server rows
|
|
21
21
|
|
|
@@ -46,7 +46,7 @@ step log only, because it flaps.
|
|
|
46
46
|
| dart | primary | unmeasured | unavailable | tool-unavailable | n/a | n/a |
|
|
47
47
|
| deno | primary | transparent | eligible | · | ok | preserved |
|
|
48
48
|
| docker | primary | transparent | eligible | · | ok | preserved |
|
|
49
|
-
| docker-official | primary |
|
|
49
|
+
| docker-official | primary | transparent | eligible | · | ok | preserved |
|
|
50
50
|
| elixir | primary | unmeasured | unavailable | tool-unavailable | n/a | n/a |
|
|
51
51
|
| expert | primary | unmeasured | eligible | · | ok | preserved |
|
|
52
52
|
| fish | primary | transparent | eligible | · | ok | preserved |
|
|
@@ -83,7 +83,7 @@ step log only, because it flaps.
|
|
|
83
83
|
| vue | primary | unmeasured | inconclusive | no-baseline | n/a | unproven |
|
|
84
84
|
| yaml | primary | transparent | eligible | · | ok | preserved |
|
|
85
85
|
| zig | primary | unmeasured | eligible | · | ok | preserved |
|
|
86
|
-
| zizmor | auxiliary |
|
|
86
|
+
| zizmor | auxiliary | transparent | eligible | · | ok | preserved |
|
|
87
87
|
|
|
88
88
|
## Declared versus measured
|
|
89
89
|
|
|
@@ -93,7 +93,6 @@ nothing.
|
|
|
93
93
|
|
|
94
94
|
- **ast-grep** [proposal] declared unmeasured but eviction and respawn preserved its findings
|
|
95
95
|
- **cue** [proposal] declared unmeasured but eviction and respawn preserved its findings
|
|
96
|
-
- **docker-official** [proposal] declared unmeasured but eviction and respawn preserved its findings
|
|
97
96
|
- **expert** [proposal] declared unmeasured but eviction and respawn preserved its findings
|
|
98
97
|
- **gleam** [proposal] declared unmeasured but eviction and respawn preserved its findings
|
|
99
98
|
- **kotlin** [proposal] declared unmeasured but eviction and respawn preserved its findings
|
|
@@ -106,7 +105,6 @@ nothing.
|
|
|
106
105
|
- **toml** [proposal] declared unmeasured but eviction and respawn preserved its findings
|
|
107
106
|
- **typos** [proposal] declared unmeasured but eviction and respawn preserved its findings
|
|
108
107
|
- **zig** [proposal] declared unmeasured but eviction and respawn preserved its findings
|
|
109
|
-
- **zizmor** [proposal] declared unmeasured but eviction and respawn preserved its findings
|
|
110
108
|
|
|
111
109
|
## Reasons
|
|
112
110
|
|
|
@@ -16,7 +16,7 @@ neither is needed. Sharded Unit tests (#3753) keep one queue run short.
|
|
|
16
16
|
Together they produce every required check: `Lint & type-check`,
|
|
17
17
|
`Unit tests`, `Install test (ubuntu-latest)`, `Install test (windows-latest)`,
|
|
18
18
|
`Install test (macos-latest)`, `knip`, `oxfmt format check`, `TLA+ models`.
|
|
19
|
-
- PR-only jobs (PR title, PR body, changelog fast-fail,
|
|
19
|
+
- PR-only jobs (PR title, PR body, changelog fast-fail, changed tests shuffled) are
|
|
20
20
|
guarded by `github.event_name == 'pull_request'` and are skipped on
|
|
21
21
|
`merge_group`; none of them is required.
|
|
22
22
|
- `tests/config/merge-queue-workflows.test.ts` pins the trigger, the required
|
package/docs/pi-lens-fixer.md
CHANGED
|
@@ -41,8 +41,9 @@ registry; other doubles only as `AGENTS.md` admits them.
|
|
|
41
41
|
compose, and flag merge order in the PR body. Branch `fix/<N>-<slug>` from
|
|
42
42
|
`origin/master` unless the brief names a branch. Preserve contributor
|
|
43
43
|
authorship on a contributor's branch.
|
|
44
|
-
- Write the failure list in the PR body before the first edit
|
|
45
|
-
inputs, states, orderings, and platforms; a space with two
|
|
44
|
+
- Write the failure list under `### Tests` in the PR body before the first edit
|
|
45
|
+
(principles §2): inputs, states, orderings, and platforms; a space with two
|
|
46
|
+
axes is a table.
|
|
46
47
|
The tests cover that list, not only the happy path. For a change to N of M
|
|
47
48
|
members, the list also names M, the excluded default, and the planned
|
|
48
49
|
generalization verdict: *widen in this PR*, *follow-up issue* with its seam
|
|
@@ -85,7 +86,7 @@ registry; other doubles only as `AGENTS.md` admits them.
|
|
|
85
86
|
tests stay green; put any behaviour change in a separate commit (#3817).
|
|
86
87
|
- Delete vacuous tests in the files you touch (a case that reds on no
|
|
87
88
|
mutation, asserts a constant, or duplicates a sibling), with the sweep
|
|
88
|
-
transcript quoted in
|
|
89
|
+
transcript quoted in `### Tests`. A redundant test that still guards
|
|
89
90
|
goes only with the named survivor that covers it.
|
|
90
91
|
- Apply folded review follow-ups per `docs/pi-lens-subagent.md`
|
|
91
92
|
"Follow-ups", and list every gap left open in one **Accepted residuals** section of
|
|
@@ -232,7 +233,8 @@ registry; other doubles only as `AGENTS.md` admits them.
|
|
|
232
233
|
(#2654).
|
|
233
234
|
- Spot-check one prior round's mutation on the new head (#2583).
|
|
234
235
|
- Re-read the changelog fragment for any claim the round retracts (#3155), then
|
|
235
|
-
|
|
236
|
+
update the PR body in place so it describes the current head. Do not append a
|
|
237
|
+
round section; commits and review threads hold the history.
|
|
236
238
|
- Lint the PR body (`--lint-local`) before the first push of a round, not only
|
|
237
239
|
at hand-back: `PR body (advisory)` re-reads the same body on every push, so
|
|
238
240
|
an unfixed finding reds each one.
|
|
@@ -247,25 +249,37 @@ rigor (#2599).
|
|
|
247
249
|
|
|
248
250
|
## Handoff
|
|
249
251
|
|
|
250
|
-
- The PR body
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
`##
|
|
252
|
+
- The PR body follows `.github/PULL_REQUEST_TEMPLATE.md`, which a reader must
|
|
253
|
+
be able to scan (#5003): `## Summary` (at most three sentences, with the
|
|
254
|
+
closing keyword, which GitHub ignores in a title), `## Notes for the reviewer`
|
|
255
|
+
(at most five bullets, no tables or fences), `## Change outline`, and
|
|
256
|
+
`## Proof and checks` with `### Tests`, `### Class sweep` (ending in one
|
|
257
|
+
`Alignment:` line that names the families of `docs/alignment-families.md` the
|
|
258
|
+
change touches, or `none: <reason>` of 12+ characters),
|
|
259
|
+
`### Observability` (a record literal from the runtime diff, `none: <reason>`,
|
|
255
260
|
or exactly `No new failure path; no record added.`, which a new decision
|
|
256
|
-
branch on a session, lifecycle or delivery seam refuses, #3875),
|
|
257
|
-
|
|
258
|
-
`#N
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
261
|
+
branch on a session, lifecycle or delivery seam refuses, #3875), and
|
|
262
|
+
`### Fold check` (one line per candidate, `#N folded`, `#N not folded` or
|
|
263
|
+
`#N sequenced`, then its reason, or `none: <reason>`; the body lint owns the
|
|
264
|
+
form and the local script owns the candidate list, #4711). Add `### Blast
|
|
265
|
+
radius` only when the change reaches outside the touched module or hits a hot
|
|
266
|
+
path. The lint caps visible text at 5000 characters and each code fence at 20
|
|
267
|
+
lines: quote failing lines, not whole runs, and give each mutation one table
|
|
268
|
+
row, not a paragraph. A brief that names only some headings does not shorten
|
|
269
|
+
this list.
|
|
263
270
|
- Run `node scripts/check-pr-body.mjs --lint-local PR_BODY.md` and
|
|
264
271
|
`node scripts/check-changelog-fragments.mjs` before the hand-back; both
|
|
265
272
|
must pass, and the hand-back quotes them. The body lint reads the closed
|
|
266
273
|
issue's labels through `gh api`; a `::warning::` that the Detection check
|
|
267
274
|
was skipped means gh failed, so the section was not required, not that it
|
|
268
|
-
passed (#4288). A
|
|
275
|
+
passed (#4288). A body that only references an issue (`Refs #N`, or any
|
|
276
|
+
close keyword the closing read does not own), or whose title names one
|
|
277
|
+
(`(refs #N)`), owes the same section when that issue is labelled `bug` or
|
|
278
|
+
`nightly-drift`; so does a body that closes a `nightly-drift` issue. A
|
|
279
|
+
reference written as `owner/repo#N` or a URL is refused unless the body
|
|
280
|
+
already closes a bug, which owes the section whatever else it cites. CI refuses a label
|
|
281
|
+
it cannot read; the local preflight, with no working gh, warns and skips it
|
|
282
|
+
as for a closed issue (#4968). A non-bug PR either deletes the `### Detection` section or
|
|
269
283
|
fills the three lines, and a `Shape:` or `Enforcer:` line it does write is
|
|
270
284
|
validated too; free text in between reds the local preflight. A bug-closing
|
|
271
285
|
PR that answers a layer, the `Gap: none:` reason, the `Shape: new:` name or
|