pi-lens 4.4.6 → 4.4.7
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 +83 -0
- package/README.md +5 -1
- package/dist/{chunk-JL6CXUMW.js → chunk-24BILSZW.js} +1 -1
- package/dist/{chunk-S67UJDGQ.js → chunk-2TF6RXWB.js} +5 -5
- package/dist/{chunk-ARD426WI.js → chunk-3F6BMY53.js} +1 -1
- package/dist/{chunk-5ZR3APIM.js → chunk-3FRLWYBG.js} +26 -26
- package/dist/{chunk-T7FTXGS3.js → chunk-3K2F6UDZ.js} +30 -30
- package/dist/{chunk-HK6JVFZC.js → chunk-3YY7IXIL.js} +2 -2
- package/dist/chunk-46TNM7XZ.js +88 -0
- package/dist/{chunk-4AVZ3TG7.js → chunk-4L36HG27.js} +8 -8
- package/dist/{chunk-PO45POGF.js → chunk-4LM3VAZH.js} +1 -1
- package/dist/{chunk-UN4TEBWN.js → chunk-4LOE5R5P.js} +9 -9
- package/dist/{chunk-KLQVC3XC.js → chunk-4YHYPW2G.js} +30 -7
- package/dist/{chunk-W5LGKNET.js → chunk-4ZYJHQMB.js} +6 -6
- package/dist/{chunk-W2V54OCL.js → chunk-6IR3ZYIB.js} +2 -2
- package/dist/{chunk-FJIVKLPH.js → chunk-72OKUXSD.js} +10 -10
- package/dist/{chunk-7RQXA5GG.js → chunk-75GAYVNO.js} +10 -9
- package/dist/{chunk-V3APN3DY.js → chunk-7E2563GA.js} +12 -12
- package/dist/{chunk-4WX4CTUE.js → chunk-7GLOLOSH.js} +25 -25
- package/dist/{chunk-BWYQUPOS.js → chunk-ABPKUVA4.js} +1 -1
- package/dist/{chunk-IPDG45G5.js → chunk-AKUUMGD5.js} +9 -9
- package/dist/{chunk-Q6D6VMI4.js → chunk-ASUXV767.js} +6 -6
- package/dist/{chunk-BM5GS6ZH.js → chunk-AWDSEDER.js} +2 -2
- package/dist/{chunk-MA77RSFN.js → chunk-BZARLRJW.js} +4 -4
- package/dist/{chunk-EVDGNG4F.js → chunk-CB4WHS4H.js} +3 -3
- package/dist/{chunk-FA5LDARD.js → chunk-CCV2EU7T.js} +7 -7
- package/dist/{chunk-U6OC3QEM.js → chunk-CE6VMBCB.js} +15 -15
- package/dist/{chunk-AMXIUN2R.js → chunk-CPSR3AVL.js} +2 -2
- package/dist/{chunk-SXGD4ANG.js → chunk-CTADOKYM.js} +7 -7
- package/dist/{chunk-63RIVFQI.js → chunk-DH5JPM3K.js} +1 -1
- package/dist/{chunk-MT6BVNFW.js → chunk-DPGEAHZT.js} +3 -3
- package/dist/{chunk-4PCQCU47.js → chunk-DQZFQSR5.js} +2 -2
- package/dist/{chunk-BHUWL2Y3.js → chunk-E7HJ56Y7.js} +5 -5
- package/dist/{chunk-DQXSPYRI.js → chunk-EAOK7MIZ.js} +2 -2
- package/dist/{chunk-2RLWJO5K.js → chunk-EKWX4WD3.js} +3 -3
- package/dist/{chunk-WIZWZR4C.js → chunk-F7K5IBZG.js} +30 -28
- package/dist/{chunk-VQH24FIP.js → chunk-FB5SCCPT.js} +9 -9
- package/dist/{chunk-GZE7WOI4.js → chunk-FZKFVUEC.js} +438 -140
- package/dist/{chunk-TIYGSODX.js → chunk-H7OR7DFZ.js} +15 -13
- package/dist/{chunk-CJYKEW2L.js → chunk-HO6LWE2E.js} +1 -1
- package/dist/{chunk-YSBHPOY6.js → chunk-HR3OJ3TH.js} +8 -8
- package/dist/{chunk-CFRQMBGP.js → chunk-HWDAVBFU.js} +14 -14
- package/dist/{chunk-2X4VLOCC.js → chunk-JJ2RRESP.js} +8 -5
- package/dist/{chunk-YBSONGSZ.js → chunk-JMEKXFOL.js} +24 -24
- package/dist/{chunk-MKVZQUEG.js → chunk-KDX35VXP.js} +69 -13
- package/dist/{chunk-75SY4F24.js → chunk-KKCK636N.js} +7 -7
- package/dist/{chunk-OLAWH5UQ.js → chunk-KPPJTH44.js} +2 -1
- package/dist/{chunk-5APMQ2IJ.js → chunk-KW5JQPO5.js} +1 -1
- package/dist/{chunk-SCIUNBPF.js → chunk-L3CMBQMH.js} +11 -11
- package/dist/{chunk-GAACZY6R.js → chunk-L5JYIU47.js} +7 -7
- package/dist/{chunk-2DDDCJDL.js → chunk-LBLBAFG3.js} +3 -3
- package/dist/{chunk-NNKXDXXS.js → chunk-LLS45EWB.js} +8 -0
- package/dist/{chunk-WQOIR3QY.js → chunk-LS3QJRUB.js} +7 -7
- package/dist/{chunk-XCUHKYCQ.js → chunk-LSC3VADM.js} +6 -6
- package/dist/{chunk-GMTFDAOK.js → chunk-LUBPZN36.js} +6 -6
- package/dist/{chunk-DMSLNKF7.js → chunk-LV4UMYVH.js} +19 -19
- package/dist/{chunk-XAIT2YGS.js → chunk-MB6PXBUA.js} +2 -2
- package/dist/{chunk-AE37FEGH.js → chunk-MNJIXFX4.js} +1 -1
- package/dist/{chunk-OJLTLYHB.js → chunk-MPKRJBPK.js} +30 -10
- package/dist/{chunk-QGSTQH4D.js → chunk-N5WSK2K7.js} +6 -6
- package/dist/{chunk-Z7IGUAXL.js → chunk-NA7SEXHE.js} +10 -6
- package/dist/{chunk-UHGF5UT5.js → chunk-O4BJFESU.js} +1 -1
- package/dist/{chunk-UCGQT677.js → chunk-OE5ZBP7F.js} +10 -10
- package/dist/{chunk-KSR7RGQY.js → chunk-OXOI55RU.js} +4 -4
- package/dist/{chunk-NDMCVUYK.js → chunk-PR6PO3ES.js} +2 -2
- package/dist/{chunk-NIU2IPC5.js → chunk-PUZ3E2J4.js} +3 -3
- package/dist/{chunk-2DMLM3ZO.js → chunk-QHSNL7B2.js} +8 -8
- package/dist/{chunk-ZYNI26MI.js → chunk-QOE342SU.js} +1 -1
- package/dist/{chunk-3WEPUD2V.js → chunk-R5MOQM2H.js} +98 -31
- package/dist/{chunk-PPIBVH4R.js → chunk-RC2Z6K47.js} +4 -4
- package/dist/{chunk-LEJOJDXL.js → chunk-RORGS5II.js} +4 -4
- package/dist/{chunk-K2YGBXOA.js → chunk-RQS4QQSD.js} +1 -1
- package/dist/{chunk-XQCSWV2G.js → chunk-RRV3FNNM.js} +10 -10
- package/dist/{chunk-GTAI2J6U.js → chunk-SHLDT3OI.js} +8 -8
- package/dist/{chunk-VPBIMOAQ.js → chunk-SNDXCFRS.js} +11 -9
- package/dist/{chunk-Q4FCYCRE.js → chunk-T7A2HK2B.js} +10 -10
- package/dist/{chunk-MN7MHUXQ.js → chunk-U5HPROLA.js} +1 -1
- package/dist/{chunk-ZUUI3ZSA.js → chunk-U6VN4NVL.js} +1 -1
- package/dist/{chunk-W5R5SABV.js → chunk-U7BD2QL7.js} +6 -6
- package/dist/{chunk-P4QNXS6I.js → chunk-UF7RTZSO.js} +8 -8
- package/dist/{chunk-A3YNG5KP.js → chunk-URCQWAQ4.js} +11 -11
- package/dist/{chunk-FFL3A2VP.js → chunk-VUZWQ7UG.js} +4 -4
- package/dist/{chunk-YRD4ISED.js → chunk-W4WP2ERB.js} +10 -10
- package/dist/{chunk-OOU2WZZE.js → chunk-WDBICWH3.js} +1 -1
- package/dist/{chunk-BI5LAQ3Y.js → chunk-WGRJOXED.js} +114 -148
- package/dist/{chunk-ZQ6NZZTB.js → chunk-WME2OQST.js} +33 -0
- package/dist/{chunk-DC4CFXM5.js → chunk-XT2HTCJ5.js} +1 -1
- package/dist/{chunk-SJJYRZB4.js → chunk-Y7F7IEE3.js} +55 -23
- package/dist/{chunk-2F47TQOA.js → chunk-YES5CACN.js} +29 -29
- package/dist/{chunk-H7HTEQUZ.js → chunk-YHC2O2WO.js} +7 -7
- package/dist/{chunk-Q3UZHW6N.js → chunk-YVHBNSME.js} +6 -10
- package/dist/{chunk-3MYEA7QD.js → chunk-ZE3KXHS7.js} +2 -2
- package/dist/{chunk-VG5JS5SW.js → chunk-ZGSJDWQU.js} +2 -2
- package/dist/{chunk-5CV5ITZF.js → chunk-ZJTT47IG.js} +1 -1
- package/dist/{chunk-Q4EMRFNA.js → chunk-ZMAUPOMG.js} +24 -24
- package/dist/index.js +1925 -944
- package/dist/mcp/analyze-cli.js +6 -6
- package/dist/mcp/cli.js +30 -30
- package/dist/mcp/server.js +707 -455
- package/dist/mcp/worker.js +48 -48
- package/dist/probes/installer.js +13 -13
- package/docs/agent-tools.md +11 -3
- package/docs/defect-shapes.md +15 -1
- package/docs/dependencies.md +1 -0
- package/docs/environment-variables.md +14 -0
- package/docs/features.md +11 -1
- package/docs/globalconfig.md +12 -1
- package/docs/invariants/git-guard-host.md +34 -0
- package/docs/invariants/lsp-trust-exec.md +6 -0
- package/docs/invariants/session-telemetry.md +42 -2
- package/docs/lsp-capability-matrix.md +89 -45
- package/docs/lsp-idle-eviction.md +3 -5
- package/docs/pi-lens-fixer.md +8 -1
- package/docs/pi-lens-merge-policy.md +7 -4
- package/docs/pi-lens-subagent.md +7 -4
- package/docs/schema/pi-lens-config-v1.json +23 -0
- package/docs/servercapabilities.md +1 -1
- package/docs/settings.md +5 -0
- package/docs/usage.md +5 -0
- package/package.json +1 -1
- package/dist/chunk-G2B7F6ZU.js +0 -88
package/dist/mcp/worker.js
CHANGED
|
@@ -2,74 +2,74 @@
|
|
|
2
2
|
import { createRequire as __pilensCreateRequire } from "node:module"; const require = __pilensCreateRequire(import.meta.url);
|
|
3
3
|
import {
|
|
4
4
|
analyzeFile
|
|
5
|
-
} from "../chunk-
|
|
6
|
-
import "../chunk-
|
|
7
|
-
import "../chunk-
|
|
8
|
-
import "../chunk-
|
|
9
|
-
import "../chunk-
|
|
10
|
-
import "../chunk-
|
|
11
|
-
import "../chunk-
|
|
12
|
-
import "../chunk-
|
|
5
|
+
} from "../chunk-WGRJOXED.js";
|
|
6
|
+
import "../chunk-LBLBAFG3.js";
|
|
7
|
+
import "../chunk-MNJIXFX4.js";
|
|
8
|
+
import "../chunk-Y7F7IEE3.js";
|
|
9
|
+
import "../chunk-JJ2RRESP.js";
|
|
10
|
+
import "../chunk-EAOK7MIZ.js";
|
|
11
|
+
import "../chunk-4LM3VAZH.js";
|
|
12
|
+
import "../chunk-E7HJ56Y7.js";
|
|
13
13
|
import "../chunk-V63BC55Q.js";
|
|
14
|
-
import "../chunk-
|
|
15
|
-
import "../chunk-
|
|
16
|
-
import "../chunk-
|
|
17
|
-
import "../chunk-
|
|
18
|
-
import "../chunk-
|
|
19
|
-
import "../chunk-
|
|
20
|
-
import "../chunk-
|
|
21
|
-
import "../chunk-
|
|
22
|
-
import "../chunk-
|
|
23
|
-
import "../chunk-
|
|
24
|
-
import "../chunk-
|
|
14
|
+
import "../chunk-CPSR3AVL.js";
|
|
15
|
+
import "../chunk-ZE3KXHS7.js";
|
|
16
|
+
import "../chunk-RQS4QQSD.js";
|
|
17
|
+
import "../chunk-CB4WHS4H.js";
|
|
18
|
+
import "../chunk-N5WSK2K7.js";
|
|
19
|
+
import "../chunk-7E2563GA.js";
|
|
20
|
+
import "../chunk-MB6PXBUA.js";
|
|
21
|
+
import "../chunk-DQZFQSR5.js";
|
|
22
|
+
import "../chunk-3YY7IXIL.js";
|
|
23
|
+
import "../chunk-WDBICWH3.js";
|
|
24
|
+
import "../chunk-H7OR7DFZ.js";
|
|
25
25
|
import "../chunk-3MED75HT.js";
|
|
26
|
-
import "../chunk-
|
|
27
|
-
import "../chunk-
|
|
26
|
+
import "../chunk-FZKFVUEC.js";
|
|
27
|
+
import "../chunk-XT2HTCJ5.js";
|
|
28
28
|
import "../chunk-XIMYZ3JA.js";
|
|
29
|
-
import "../chunk-
|
|
30
|
-
import "../chunk-
|
|
31
|
-
import "../chunk-
|
|
32
|
-
import "../chunk-
|
|
29
|
+
import "../chunk-R5MOQM2H.js";
|
|
30
|
+
import "../chunk-24BILSZW.js";
|
|
31
|
+
import "../chunk-PR6PO3ES.js";
|
|
32
|
+
import "../chunk-RC2Z6K47.js";
|
|
33
33
|
import "../chunk-F5Z6URKM.js";
|
|
34
34
|
import "../chunk-5W3R6LFT.js";
|
|
35
|
-
import "../chunk-
|
|
36
|
-
import "../chunk-
|
|
35
|
+
import "../chunk-MPKRJBPK.js";
|
|
36
|
+
import "../chunk-DH5JPM3K.js";
|
|
37
37
|
import "../chunk-PKES3ISE.js";
|
|
38
38
|
import "../chunk-ZKXQKGWZ.js";
|
|
39
|
-
import "../chunk-
|
|
39
|
+
import "../chunk-L5JYIU47.js";
|
|
40
40
|
import "../chunk-Z54ZSOBZ.js";
|
|
41
|
-
import "../chunk-
|
|
41
|
+
import "../chunk-U6VN4NVL.js";
|
|
42
42
|
import "../chunk-TIQJPRDD.js";
|
|
43
43
|
import "../chunk-YISME6ON.js";
|
|
44
44
|
import "../chunk-6HWVI6MI.js";
|
|
45
|
-
import "../chunk-
|
|
45
|
+
import "../chunk-O4BJFESU.js";
|
|
46
46
|
import "../chunk-CKEQFGLT.js";
|
|
47
|
-
import "../chunk-
|
|
48
|
-
import "../chunk-
|
|
49
|
-
import "../chunk-
|
|
50
|
-
import "../chunk-
|
|
51
|
-
import "../chunk-
|
|
47
|
+
import "../chunk-HO6LWE2E.js";
|
|
48
|
+
import "../chunk-SNDXCFRS.js";
|
|
49
|
+
import "../chunk-QOE342SU.js";
|
|
50
|
+
import "../chunk-AWDSEDER.js";
|
|
51
|
+
import "../chunk-LLS45EWB.js";
|
|
52
52
|
import "../chunk-2BEMIWEW.js";
|
|
53
53
|
import "../chunk-IJYGIDF4.js";
|
|
54
|
-
import "../chunk-
|
|
55
|
-
import "../chunk-
|
|
56
|
-
import "../chunk-
|
|
57
|
-
import "../chunk-
|
|
58
|
-
import "../chunk-
|
|
59
|
-
import "../chunk-
|
|
60
|
-
import "../chunk-
|
|
61
|
-
import "../chunk-
|
|
62
|
-
import "../chunk-
|
|
63
|
-
import "../chunk-
|
|
54
|
+
import "../chunk-KDX35VXP.js";
|
|
55
|
+
import "../chunk-DPGEAHZT.js";
|
|
56
|
+
import "../chunk-NA7SEXHE.js";
|
|
57
|
+
import "../chunk-3F6BMY53.js";
|
|
58
|
+
import "../chunk-KW5JQPO5.js";
|
|
59
|
+
import "../chunk-PUZ3E2J4.js";
|
|
60
|
+
import "../chunk-ABPKUVA4.js";
|
|
61
|
+
import "../chunk-EKWX4WD3.js";
|
|
62
|
+
import "../chunk-ZGSJDWQU.js";
|
|
63
|
+
import "../chunk-YVHBNSME.js";
|
|
64
64
|
import "../chunk-AWQWXSW4.js";
|
|
65
65
|
import "../chunk-QYF5S6P6.js";
|
|
66
66
|
import "../chunk-RZOXUSPC.js";
|
|
67
|
-
import "../chunk-
|
|
67
|
+
import "../chunk-KPPJTH44.js";
|
|
68
68
|
import "../chunk-J6JP25XU.js";
|
|
69
69
|
import {
|
|
70
70
|
setProjectTrustState
|
|
71
|
-
} from "../chunk-
|
|
72
|
-
import "../chunk-
|
|
71
|
+
} from "../chunk-U5HPROLA.js";
|
|
72
|
+
import "../chunk-WME2OQST.js";
|
|
73
73
|
import {
|
|
74
74
|
logExtension
|
|
75
75
|
} from "../chunk-KXF5R4UN.js";
|
package/dist/probes/installer.js
CHANGED
|
@@ -53,23 +53,23 @@ import {
|
|
|
53
53
|
verifyNpmPackageEntry,
|
|
54
54
|
verifyToolBinary,
|
|
55
55
|
wasLastResolveTransient
|
|
56
|
-
} from "../chunk-
|
|
57
|
-
import "../chunk-
|
|
58
|
-
import "../chunk-
|
|
59
|
-
import "../chunk-
|
|
60
|
-
import "../chunk-
|
|
61
|
-
import "../chunk-
|
|
62
|
-
import "../chunk-
|
|
63
|
-
import "../chunk-
|
|
64
|
-
import "../chunk-
|
|
65
|
-
import "../chunk-
|
|
56
|
+
} from "../chunk-KDX35VXP.js";
|
|
57
|
+
import "../chunk-DPGEAHZT.js";
|
|
58
|
+
import "../chunk-NA7SEXHE.js";
|
|
59
|
+
import "../chunk-3F6BMY53.js";
|
|
60
|
+
import "../chunk-KW5JQPO5.js";
|
|
61
|
+
import "../chunk-PUZ3E2J4.js";
|
|
62
|
+
import "../chunk-ABPKUVA4.js";
|
|
63
|
+
import "../chunk-EKWX4WD3.js";
|
|
64
|
+
import "../chunk-ZGSJDWQU.js";
|
|
65
|
+
import "../chunk-YVHBNSME.js";
|
|
66
66
|
import "../chunk-AWQWXSW4.js";
|
|
67
67
|
import "../chunk-QYF5S6P6.js";
|
|
68
68
|
import "../chunk-RZOXUSPC.js";
|
|
69
|
-
import "../chunk-
|
|
69
|
+
import "../chunk-KPPJTH44.js";
|
|
70
70
|
import "../chunk-J6JP25XU.js";
|
|
71
|
-
import "../chunk-
|
|
72
|
-
import "../chunk-
|
|
71
|
+
import "../chunk-U5HPROLA.js";
|
|
72
|
+
import "../chunk-WME2OQST.js";
|
|
73
73
|
import "../chunk-KXF5R4UN.js";
|
|
74
74
|
import "../chunk-S26LC76R.js";
|
|
75
75
|
import "../chunk-Z2XAOKHK.js";
|
package/docs/agent-tools.md
CHANGED
|
@@ -204,8 +204,14 @@ and `[]` mean no arguments.
|
|
|
204
204
|
tree-sitter's conventional `comment` node — JS/TS is the primary target;
|
|
205
205
|
languages sharing that node shape (confirmed: Python, and any grammar whose
|
|
206
206
|
comment nodes are plain preceding siblings) get it for free with no
|
|
207
|
-
per-grammar query work.
|
|
208
|
-
|
|
207
|
+
per-grammar query work. A Python def or class also reads its docstring (a
|
|
208
|
+
plain, `r` or `u` string that is the first statement of the body); when
|
|
209
|
+
both a `#` comment above the def and a docstring exist, a docstring with text
|
|
210
|
+
wins; an empty docstring falls back to the comment.
|
|
211
|
+
When a file has syntax errors, tree-sitter recovers and drops the
|
|
212
|
+
declarations it cannot parse, so the report carries a `warnings` entry saying
|
|
213
|
+
the symbol list may be incomplete. `exported` stays a boolean field only — it
|
|
214
|
+
is NOT also repeated inside `flags` (#512); `flags` carries only non-derivable
|
|
209
215
|
signals (`async`, `high fanout`, `high complexity`, `boundary wrapper`).
|
|
210
216
|
Each entry carries a `decorators[]` array — the declaration's
|
|
211
217
|
decorators/attributes/annotations (`@app.get("/x")`, `#[tokio::main]`,
|
|
@@ -230,7 +236,9 @@ and `[]` mean no arguments.
|
|
|
230
236
|
for cross-file transitive dependents (read-only over the cached graph).
|
|
231
237
|
- **`read_symbol`** — One symbol's verbatim source body, by name or by a
|
|
232
238
|
`module_report` callback handle. Returned body is recorded as genuine
|
|
233
|
-
read-guard coverage for that symbol/callback's line range.
|
|
239
|
+
read-guard coverage for that symbol/callback's line range. In a file with
|
|
240
|
+
syntax errors a miss carries the same incomplete-symbol-list warning, so a
|
|
241
|
+
miss is not proof the symbol is absent.
|
|
234
242
|
- **`read_enclosing`** — Maps a `path` + `line` (from `ast_grep_search`,
|
|
235
243
|
diagnostics, or LSP locations) to the verbatim body of the smallest enclosing
|
|
236
244
|
symbol or callback. Tree-sitter only — no LSP or graph build. Optional `kinds`
|
package/docs/defect-shapes.md
CHANGED
|
@@ -707,7 +707,21 @@ file-scoped worklist and receives no project-wide scanner output.
|
|
|
707
707
|
session's value for the whole process answers for whichever session wrote
|
|
708
708
|
last, so a second live session overwrites what another one read. Key the
|
|
709
709
|
state by session identity, or decide from live membership. Instances:
|
|
710
|
-
#4554 (fixed by #4563, still open) and #4564.
|
|
710
|
+
#4554 (fixed by #4563, still open) and #4564. Screen: whose data is the
|
|
711
|
+
store, not what its key is? Seam: a session's state lives on a scope cell
|
|
712
|
+
(`scopeCell`, `clients/session-scope.ts`, #3609); a caller that holds only
|
|
713
|
+
a session id reaches the cell through `sessionCell`, which names live
|
|
714
|
+
scopes only. Enforcer: the `ownerKey` column of
|
|
715
|
+
`tests/support/session-state-registry.ts`, audited by
|
|
716
|
+
`tests/clients/session-state-conformance.test.ts` ("owner key (#4965)"):
|
|
717
|
+
every entry names `session`, `repository`, `project` or `process-wide:
|
|
718
|
+
<reason>`, and a `session` owner states `sessionSeamException`, why a scope
|
|
719
|
+
cell cannot hold it yet. A moved store has no process container and no
|
|
720
|
+
entry; `scanScopeCellKeys` pins every cell by file and key
|
|
721
|
+
(`SESSION_CELL_KEYS`). Partial: it reads the registered stores only, so an
|
|
722
|
+
unregistered module-level field is still not scanned.
|
|
723
|
+
|
|
724
|
+
87. **Factory-time read of a host value set later:** pi applies an extension flag's command-line value after every factory has run, so a flag read while the factory runs answers the registered default. Screen: does any flag read run while the factory runs, and does the host test apply the value after the factory, as pi does? Read it in a handler, a command or a tool, or once in `session_start`. Enforcer: `tests/config/factory-flag-read-sweep.test.ts` (partial: a reader handed to a callee that invokes it synchronously is not seen). Instances and dates: `HISTORY.md`.
|
|
711
725
|
|
|
712
726
|
**Expired successor hand-off:** an expired successor marker may authorize
|
|
713
727
|
its named interrupted successor only for the fixed retention window in
|
package/docs/dependencies.md
CHANGED
|
@@ -50,6 +50,7 @@ Auto-install behavior depends on gate type:
|
|
|
50
50
|
| `gitleaks` | Committed-secret session scan | Auto-install | Opt-in (config / hook / dep) |
|
|
51
51
|
| `govulncheck` | Go reachable-CVE session scan | `go install` | Auto (`go.mod` present) |
|
|
52
52
|
| `trivy` | Dependency-CVE session scan | Auto-install | Explicit opt-in (`trivy.enabled`) |
|
|
53
|
+
| `fallow-lsp` | JS/TS unused-code, duplication and cycle advisories | Auto-install | Explicit opt-in (`fallow.enabled`, pinned GitHub release) |
|
|
53
54
|
| `psscriptanalyzer` | PowerShell linting | Manual | — |
|
|
54
55
|
|
|
55
56
|
Lean LSP is launched as `lake serve` from the detected Lake project root, so elan selects the toolchain from that project's `lean-toolchain` file and Lake supplies its project environment. pi-lens does not install or manage Lean/elan; install Lean and Lake separately and ensure `lake` is on `PATH`.
|
|
@@ -208,6 +208,20 @@ Unset or `0` preserves the prior local-LSP behavior exactly. Any transport,
|
|
|
208
208
|
schema, freshness, deadline, or incumbent-liveness failure permanently falls
|
|
209
209
|
back to a local LSP fleet for that session.
|
|
210
210
|
|
|
211
|
+
## Variables pi-lens sets for its child processes
|
|
212
|
+
|
|
213
|
+
### `GIT_OPTIONAL_LOCKS`
|
|
214
|
+
|
|
215
|
+
pi-lens starts the child processes it runs through its spawn seam (its
|
|
216
|
+
background `git status` reads included) with `GIT_OPTIONAL_LOCKS=0`, so a read
|
|
217
|
+
does not refresh the index and cannot leave `.git/index.lock` behind after a
|
|
218
|
+
timeout or a host exit. The value you export in your shell does not change this
|
|
219
|
+
for those children, and your own git commands are unaffected. A caller that
|
|
220
|
+
passes its own environment to a child keeps its value. Language servers are
|
|
221
|
+
launched separately and inherit your environment unchanged. On a checkout whose
|
|
222
|
+
index is stat-dirty, each status read re-hashes the dirty files until one of
|
|
223
|
+
your own git commands refreshes the index.
|
|
224
|
+
|
|
211
225
|
## Language-specific
|
|
212
226
|
|
|
213
227
|
### Ambient Python environments (`VIRTUAL_ENV`, `CONDA_PREFIX`, `UV_PROJECT_ENVIRONMENT`)
|
package/docs/features.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
### LSP Support
|
|
4
4
|
|
|
5
|
-
pi-lens includes **
|
|
5
|
+
pi-lens includes **50 language server definitions** (including four cross-cutting *auxiliary* scanners that attach alongside the file's language server — Opengrep, ast-grep, zizmor, and typos — and one opt-in, JS/TS-only auxiliary, fallow, off unless `fallow.enabled` is set; see below). LSP is **enabled by default**; use `--no-lsp` to disable it for a session. Servers are auto-discovered from PATH, project `node_modules`, and managed installs. When a server with a managed installer is not installed, pi-lens offers an interactive install prompt; toolchain-bundled servers, such as Lean's `lake`, are PATH-only, and pi-lens never installs or manages them.
|
|
6
6
|
|
|
7
7
|
**LSP Idle Management:** LSP servers shut down after 240 seconds of inactivity (no files modified) to free resources. The timer resets when you resume editing, preventing cold-start penalties during active development.
|
|
8
8
|
|
|
@@ -22,6 +22,16 @@ pi-lens includes **49 language server definitions** (including four cross-cuttin
|
|
|
22
22
|
LSP servers for: TypeScript, Deno, Python (pyright/basedpyright + jedi), Go, Rust, Ruby (ruby-lsp + solargraph), PHP, PowerShell, C# (omnisharp), F#, Java (JDT LS, with Lombok javaagent support when a Lombok jar is available), Kotlin, Lean, Swift, Dart, Lua, C/C++, Zig, Haskell, Elixir, Gleam, Typst (tinymist), Markdown (marksman), OCaml, Clojure, CUE (syntax and parse diagnostics; evaluation errors via the cue-vet auxiliary runner), Terraform, Nix, Bash, Shuck (zsh-aware shell language server), Fish, CMake, Docker, YAML, JSON, HTML, TOML, Prisma, Vue, Svelte, CSS.
|
|
23
23
|
|
|
24
24
|
|
|
25
|
+
### TypeScript and JavaScript server
|
|
26
|
+
|
|
27
|
+
pi-lens picks the launch for JS/TS files in this order. The first two steps use only the project's own `node_modules`:
|
|
28
|
+
|
|
29
|
+
1. **Effect language service** — when the nearest `node_modules/typescript` is version 7 or newer and the same `node_modules` holds `@effect/tsgo`, pi-lens runs the project's `effect-tsgo tsc --lsp --stdio`. Installing the package is the opt-in; there is no pi-lens setting. A malformed `@effect/tsgo` (no readable version, no `bin`) or a failure to start the process falls back to the next step; a server that starts and then fails to initialize does not fall back, and pi-lens never installs `@effect/tsgo`.
|
|
30
|
+
2. **Native TypeScript 7** — the project's `node_modules/.bin/tsc --lsp --stdio`.
|
|
31
|
+
3. **Classic** — `typescript-language-server` with a `tsserver.js`, when the nearest TypeScript is version 6 or older or no step above applies. This step can also use a server and TypeScript found on `PATH` or installed by pi-lens.
|
|
32
|
+
|
|
33
|
+
The nearest installed `typescript` decides: an ancestor's TypeScript 7 never replaces a nearer, older or malformed install. The project's own compiler and launcher run only when pi has marked the project trusted (see [Configuring pi-lens](configuration.md)); otherwise the launch falls through to the next step.
|
|
34
|
+
|
|
25
35
|
### Python: interpreter and syntax level
|
|
26
36
|
|
|
27
37
|
Python carries two separate declarations, and pi-lens reads both from the project rather than from whichever interpreter happens to run a checker.
|
package/docs/globalconfig.md
CHANGED
|
@@ -18,6 +18,10 @@ Each runtime toggle is settable from the CLI *and* from `config.json`. The two a
|
|
|
18
18
|
| `--no-tests` | `tests.enabled` | `true` |
|
|
19
19
|
| `--no-delta` | `delta.enabled` | `true` |
|
|
20
20
|
| `--no-opengrep` | `opengrep.enabled` | `true` |
|
|
21
|
+
| `--no-ast-grep` | `astGrep.enabled` | `true` |
|
|
22
|
+
| `--no-zizmor` | `zizmor.enabled` | `true` |
|
|
23
|
+
| `--no-typos` | `typos.enabled` | `true` |
|
|
24
|
+
| `--lens-spotbugs` | `spotbugs.enabled` | `false` |
|
|
21
25
|
| `--no-read-guard` | `readGuard.enabled` | `true` |
|
|
22
26
|
| `--no-autoformat` | `format.enabled` | `true` |
|
|
23
27
|
| `--no-autofix` | `autofix.enabled` | `true` |
|
|
@@ -37,6 +41,7 @@ Each runtime toggle is settable from the CLI *and* from `config.json`. The two a
|
|
|
37
41
|
| `--lens-compact-widget` | `ui.compactWidget` | `false` |
|
|
38
42
|
| `--no-lazy-tools` | `tools.lazy` | `true` |
|
|
39
43
|
| `--lens-turn-end-madge` | `turnEnd.madge.enabled` | `false` |
|
|
44
|
+
| `--lens-fallow` | `fallow.enabled` | `false` |
|
|
40
45
|
| `--no-knip` | `knip.enabled` | `true` |
|
|
41
46
|
| `--no-jscpd` | `jscpd.enabled` | `true` |
|
|
42
47
|
| `--no-madge` | `madge.enabled` | `true` |
|
|
@@ -147,6 +152,8 @@ Hide the diagnostics widget by default, run formatting immediately after write/e
|
|
|
147
152
|
|
|
148
153
|
`turnEnd.madge.enabled` (default `false`) runs the per-turn-end madge circular-dependency check on import-changed files. It is off by default because that pass only writes debug output — user-facing madge diagnostics come from the session-start scan cache and the `lens_diagnostics` extractor — and its subprocess spawns dominated the turn-end latency tail (#766). Enable it with `--lens-turn-end-madge` or `turnEnd.madge.enabled: true` if you want the per-edit circular-dependency note.
|
|
149
154
|
|
|
155
|
+
`fallow.enabled` (default `false`, or `--lens-fallow`) runs [fallow](https://github.com/fallow-rs/fallow)'s `fallow-lsp` beside the TypeScript server on JS/TS files (`.ts .tsx .js .jsx .mjs .cjs .mts .cts`; no other file ever attaches it). It reports unused files, exports and dependencies, duplication and cycles as advisory warnings and never blocks. It overlaps knip, jscpd and madge, which keep running either way. Only the exact value `true` turns it on: an absent, misspelled or non-boolean value leaves it off, and pi-lens installs and launches nothing. On first use pi-lens downloads the pinned fallow release into `~/.pi-lens/tools/fallow-lsp` (a `fallow-lsp` already on `PATH` wins); the install is refused on a checksum mismatch. The per-edit diagnostics path runs it; the aggregate all-server checks (`lens_diagnostics source=lsp`, workspace sweeps) do not start it.
|
|
156
|
+
|
|
150
157
|
`ignore` is an array of gitignore-style glob patterns excluded from pi-lens scans across **every** project — the global counterpart to the per-project `.pi-lens.json` `ignore` below. Precedence is lowest: a project `.gitignore` or `.pi-lens.json` (including a `!negation`) overrides it, so you can globally hide e.g. `scratch/**` and still re-include it in one repo.
|
|
151
158
|
|
|
152
159
|
Turn subsystems off globally instead of retyping flags every session:
|
|
@@ -156,12 +163,16 @@ Turn subsystems off globally instead of retyping flags every session:
|
|
|
156
163
|
"lsp": { "enabled": false },
|
|
157
164
|
"tests": { "enabled": false },
|
|
158
165
|
"opengrep": { "enabled": false },
|
|
166
|
+
"astGrep": { "enabled": false },
|
|
167
|
+
"zizmor": { "enabled": false },
|
|
168
|
+
"typos": { "enabled": false },
|
|
169
|
+
"spotbugs": { "enabled": true },
|
|
159
170
|
"readGuard": { "enabled": false },
|
|
160
171
|
"guard": { "enabled": true }
|
|
161
172
|
}
|
|
162
173
|
```
|
|
163
174
|
|
|
164
|
-
`lens.enabled: false` starts every session with pi-lens off (the `--no-lens` equivalent); `/lens-toggle` still re-enables it for one session. `lsp.enabled: false` falls back to language-specific checkers such as pyright. `tests.enabled: false` skips the on-write test runner. `delta.enabled: false` reports every diagnostic rather than only ones introduced this turn. `opengrep.enabled: false` detaches the Opengrep security scanner. `readGuard.enabled: false` turns off the read-before-edit monitor. `guard.enabled: true` opts into the experimental commit/push blocker.
|
|
175
|
+
`lens.enabled: false` starts every session with pi-lens off (the `--no-lens` equivalent); `/lens-toggle` still re-enables it for one session. `lsp.enabled: false` falls back to language-specific checkers such as pyright. `tests.enabled: false` skips the on-write test runner. `delta.enabled: false` reports every diagnostic rather than only ones introduced this turn. `opengrep.enabled: false` detaches the Opengrep security scanner. `astGrep.enabled: false` detaches the ast-grep auxiliary server. `zizmor.enabled: false` and `typos.enabled: false` detach the zizmor and typos auxiliary servers. `spotbugs.enabled: true` opts into SpotBugs on Java and Kotlin files (it also needs a Java build descriptor and a compiled `.class` directory). `readGuard.enabled: false` turns off the read-before-edit monitor. `guard.enabled: true` opts into the experimental commit/push blocker.
|
|
165
176
|
|
|
166
177
|
The `tools.<name>.enabled` setting controls each model-facing tool. Valid names
|
|
167
178
|
include `ast_grep_search`, `ast_grep_replace`, `ast_grep_outline`,
|
|
@@ -39,6 +39,40 @@
|
|
|
39
39
|
`record_retired` row (#4725). A dispatch that never answered
|
|
40
40
|
(`pipeline_crash`, `pipeline_error`) is latched per file, apart from the
|
|
41
41
|
record's latch, and only that file's own returning dispatch clears it.
|
|
42
|
+
- Inline blockers have owners (#4921). A blocker belongs to the turn session
|
|
43
|
+
whose write recorded it; a record with no `session` is the coordinator's.
|
|
44
|
+
The commit gate reads every record, whoever owns it, because the tree is
|
|
45
|
+
shared. A turn end reads only its own session's records: it delivers,
|
|
46
|
+
sweeps, re-judges and consumes those, and files its guard section under its
|
|
47
|
+
own id. Only a write by the coordinator's session latches
|
|
48
|
+
`session_mismatch`; a concurrent session's write leaves another
|
|
49
|
+
session's record and the latch alone.
|
|
50
|
+
- The commit gate is keyed by the repository being committed (#4941), not by
|
|
51
|
+
session. A commit/push is judged by the unresolved blockers whose files lie
|
|
52
|
+
in the git checkout it targets (`resolveGitCheckout`, the seam the review
|
|
53
|
+
graph and the analysis root use) or in a checkout nested inside it, whoever
|
|
54
|
+
wrote them; a linked worktree of the committed repository is a checkout of
|
|
55
|
+
its own, never the parent's. This covers every reader the gate has: the
|
|
56
|
+
inline-blocker latch memo, the stale-suppression scan, the dispatches that
|
|
57
|
+
never answered, and the record-failure latch, which holds one reason per
|
|
58
|
+
project (a failure or a write about repository B never replaces or clears
|
|
59
|
+
repository A's). A sub-agent committing in repository B is not refused for a
|
|
60
|
+
blocker in repository A; one committing where the blocker is still is. The
|
|
61
|
+
target comes from `resolveCommitScope` and fails closed: only plain `git`
|
|
62
|
+
segments (spelled `git` or a system path such as `/usr/bin/git`; global
|
|
63
|
+
option `-C <existing, unexpanded directory>` only) beside a short list of
|
|
64
|
+
neutral commands (`echo`, `tail`, ...) are placed in a tree, and only in a
|
|
65
|
+
process whose environment sets none of `GIT_DIR`, `GIT_WORK_TREE`,
|
|
66
|
+
`GIT_COMMON_DIR`. The gate never resolves PATH, so a bare `git` is trusted
|
|
67
|
+
whatever executable the shell finds under that name. `cd`, an assignment,
|
|
68
|
+
`--git-dir`, `--work-tree`, `-c`, a wrapper or any other path named `git`, a
|
|
69
|
+
`~` operand, a substitution that runs git, any other command in the chain,
|
|
70
|
+
or a directory outside a checkout leaves the command unscoped, and an unscoped command, a verdict that names no
|
|
71
|
+
file, and a caller that passes no command are judged by every blocker. The
|
|
72
|
+
persisted `turn-end-findings` record stays the committing session's
|
|
73
|
+
project's (`cwd`): for `git -C <other repo> commit` it is not read for the
|
|
74
|
+
targeted repository, so that record's blocker can be missed (a gap that
|
|
75
|
+
predates #4941).
|
|
42
76
|
- The shared-checkout guard refuses unsafe worktree mutation when another live
|
|
43
77
|
session and uncommitted work are both proven. It never auto-stashes.
|
|
44
78
|
- `mcp/server.ts` talks to pi-lens through `clients/lens-engine.ts`. A mirrored
|
|
@@ -5,6 +5,12 @@
|
|
|
5
5
|
- `safeSpawnAsync` is the subprocess seam. It carries ambient abort behavior,
|
|
6
6
|
process-tree cleanup, output caps, typed failure kinds, and bounded timeouts.
|
|
7
7
|
Installs pass `ignoreAmbientSignal: true` and remain trust-gated.
|
|
8
|
+
The seam defaults `GIT_OPTIONAL_LOCKS=0`, so unless a caller `env` override
|
|
9
|
+
sets it, no child takes git's optional index lock that a timeout or host exit
|
|
10
|
+
could orphan (#4930). The cost of the default: git does not write back its
|
|
11
|
+
refreshed stat cache, so
|
|
12
|
+
on a stat-dirty checkout each status read re-hashes the dirty set until the
|
|
13
|
+
user's own git command refreshes the index.
|
|
8
14
|
It is also the lookup chokepoint. Under pi trust other than
|
|
9
15
|
`trusted`, every child's search path loses the session repository's own
|
|
10
16
|
directories, and a bare command that still resolves into them is refused
|
|
@@ -27,8 +27,25 @@
|
|
|
27
27
|
write-order turn and change window only for its own session, and per-turn
|
|
28
28
|
warnings are partitioned by the session that recorded them. Every
|
|
29
29
|
producer and reader passes that id (`tool_result`, a partial apply's
|
|
30
|
-
pipeline, `turn_end`).
|
|
31
|
-
|
|
30
|
+
pipeline, `turn_end`). The read guard is the turn's session's too (#4942,
|
|
31
|
+
the half of #3613 this paragraph used to leave open):
|
|
32
|
+
`RuntimeCoordinator.readGuardFor(sessionId)` answers with the coordinator's
|
|
33
|
+
own guard for a turn with no session id of its own, and with a guard of its
|
|
34
|
+
own, built on first use and dropped at its shutdown or at the coordinator's
|
|
35
|
+
own reset, for a concurrent secondary. It keys that guard by the opaque owner
|
|
36
|
+
the inline blockers use
|
|
37
|
+
(#4921, `recordSession`), so an edit is judged by the reads and writes of
|
|
38
|
+
the session that edits. The coordinator's own guard is the primary's only
|
|
39
|
+
while the ctx's stable session id equals the pinned telemetry id
|
|
40
|
+
(`setSessionLifecycle`); a start that cannot read its id would leave the
|
|
41
|
+
primary's turns on a foreign guard, where a primary `/tree` no longer
|
|
42
|
+
filters their reads (a hypothesis, reproduced only as a composite probe,
|
|
43
|
+
#4955 review F3).
|
|
44
|
+
A read or write reported through the mutation or
|
|
45
|
+
read bridge is credited to the coordinator's guard, even when the
|
|
46
|
+
mutation entry names a session (`BridgeMutationEntry.sessionId` routes
|
|
47
|
+
only the turn state and the change log, #4955 review F11). A concurrent
|
|
48
|
+
secondary still shares the turn-end worklist. State `turn_end` parks
|
|
32
49
|
in a scope cell for a later turn lives on the activation's own scope
|
|
33
50
|
(`TurnEndDeps.sessionScope`, passed by `index.ts`), never on
|
|
34
51
|
`runtime.sessionScope`, which is the primary's during a secondary's turn
|
|
@@ -37,6 +54,29 @@
|
|
|
37
54
|
the coordinator's for the coordinator and module stores a secondary
|
|
38
55
|
shares, the activation's for its own scope cell. One store never answers
|
|
39
56
|
to two scopes, and a secondary's end fences only its cell.
|
|
57
|
+
- The project's one turn-end delivery slot (`turn-end-findings`'s
|
|
58
|
+
`content`) is addressed (#4943): the composer stamps `deliverTo` with its
|
|
59
|
+
turn's session, a commit-gate rewrite of the content leaves it out so the
|
|
60
|
+
record's owner (`sessionId`) is the addressee, and the `context` hook
|
|
61
|
+
consumes only a record addressed to its own session (the composer's id
|
|
62
|
+
expression); any other request leaves it untouched and writes one
|
|
63
|
+
`turn-end-delivery-addressed-elsewhere` ledger record per addressee. A
|
|
64
|
+
record with neither field goes to whoever asks. The sibling
|
|
65
|
+
`test-runner-findings` slot is read with the same id
|
|
66
|
+
(`deliveryEligible.sessionId`): a concurrent secondary never pins the
|
|
67
|
+
coordinator id. The MCP host stages to one address shared by every server
|
|
68
|
+
process (`MCP_DELIVERY_ADDRESS`) and reads as that address, with its
|
|
69
|
+
coordinator id, reassigned at each session start, for a record whose rewrite
|
|
70
|
+
left only the owner: a restarted server still delivers what the last one
|
|
71
|
+
staged, and neither its Stop pass nor its acknowledge takes a pi session's
|
|
72
|
+
message. The exception is a record a commit-gate rewrite replaced: it holds
|
|
73
|
+
only the owner id, so a server whose id was reassigned since (a restart, or
|
|
74
|
+
a later `pilens_session_start`) skips it and leaves it in place (accepted
|
|
75
|
+
residual, #4973).
|
|
76
|
+
A staged message another writer replaces before its owner asks is not
|
|
77
|
+
kept; the owner's next turn end composes its unresolved blockers again,
|
|
78
|
+
since the dedupe's last writer was the other session, but a one-shot
|
|
79
|
+
advisory is not composed again.
|
|
40
80
|
- Every session-scope hand-off decision leaves one `latency.log` row per
|
|
41
81
|
lifecycle event, never one per occurrence in a loop (#3873):
|
|
42
82
|
`session_handoff_slot`, `session_handoff_adopt`, `session_store_action`
|
|
@@ -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
|
|
@@ -135,17 +158,23 @@ Merges never blank a prior good value, so a CI non-result leaves the dev
|
|
|
135
158
|
classification standing.
|
|
136
159
|
|
|
137
160
|
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
|
-
|
|
161
|
+
(#3401, #4512). A measured `first-publish` or `clean-behavior` cell the nightly
|
|
162
|
+
probe does not re-observe keeps its last known value and is marked in the
|
|
163
|
+
`stale` column with the date of the first miss (`since YYYY-MM-DD`). The refresh
|
|
164
|
+
never rewrites it to `unknown`: before #4512 a `direct` cell degraded to
|
|
165
|
+
`unknown` after five days, which erased five measured values in the #4338
|
|
166
|
+
refresh with nothing raised. The streak of consecutive nightly misses is kept
|
|
167
|
+
per lang and per axis in the refresh state below, so a `clean-behavior` miss one
|
|
168
|
+
night and a `first-publish` miss the next are two first misses; a cell whose
|
|
169
|
+
axis has missed two consecutive nights is
|
|
170
|
+
raised on one tracking issue (`nightly: LSP capability probe missed (stale
|
|
171
|
+
matrix cells)`), and an observation clears both the mark and the streak.
|
|
172
|
+
`empty-first` cells back the live `emptyFirstPublish` markers and are stamped
|
|
173
|
+
the same way (#4615): the refresh stamps the FIRST night it does not re-observe
|
|
174
|
+
one, and the first-publish census reds once that stamp is five days old, so the
|
|
175
|
+
cell+marker pair cannot outlive the instrument that produced it — a cell with
|
|
176
|
+
no live measurement behind it is no longer indistinguishable from a healthy
|
|
177
|
+
one. A `clean-behavior`/`tier` change is written only after two
|
|
149
178
|
consecutive nightly runs observe the same new value, so one flapping nightly
|
|
150
179
|
(ast-grep went 2 → 2* → 3 → 2* across four runs) cannot rewrite a cell; a night
|
|
151
180
|
that measured nothing for the lang resets the hold. A subset probe (`probe-clean-signal.mjs <langs>`) leaves the
|
|
@@ -160,6 +189,20 @@ master's doc otherwise (branch absent, squash-merged, or master edited the doc
|
|
|
160
189
|
since). Closing the bot PR unmerged does not reset the bookkeeping: the branch
|
|
161
190
|
is kept and keeps seeding, so only deleting `bot/lsp-docs-refresh` resets it.
|
|
162
191
|
|
|
192
|
+
The `version` and `install` columns (#4512) record what the nightly ran: the
|
|
193
|
+
first version token of the server's own version command (the `checkArgs` its
|
|
194
|
+
installer entry registers, `--version` by default, read within that entry's
|
|
195
|
+
verification timeout) and the installer route that resolved it (`global-path`, `npm-global`, `pip-user`, `pi-lens-auto`,
|
|
196
|
+
`github-release`, `maven-jar`, `archive-dist`). `characterize-lsp.mjs` writes
|
|
197
|
+
them from the installer's resolution for the one tool a fixture names; a fixture
|
|
198
|
+
that names none or several, a server the installer cannot find, or a launcher
|
|
199
|
+
that answers every argument by starting a JVM (`tree-manifest`) records nothing,
|
|
200
|
+
and the cell keeps its last known value or `—`. They record the installer's
|
|
201
|
+
resolution, not the path the LSP launch finally spawned, so a PATH binary that
|
|
202
|
+
shadows a managed one reads as `global-path`. A change in `version` or `install`
|
|
203
|
+
is not a capability flip: the refresh PR's landing check ignores those columns
|
|
204
|
+
and `stale`.
|
|
205
|
+
|
|
163
206
|
`vue`'s `clean-behavior` was hand-reset to `unknown` (#3390): its
|
|
164
207
|
`publishes-unversioned` cell came from 58/45 publishes that the shared
|
|
165
208
|
`extension.log` window had attributed to vue but that belonged to `tinymist`.
|
|
@@ -169,37 +212,37 @@ to be cleared by hand. It stays `unknown` until a run observes
|
|
|
169
212
|
`@vue/language-server` publish; `tests/config/lsp-clean-behavior-census.test.ts`
|
|
170
213
|
carries the named admission until then.
|
|
171
214
|
|
|
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 |
|
|
215
|
+
| lang | server | mode | clean-behavior | first-publish | tier | src | version | install | stale |
|
|
216
|
+
|---|---|---|---|---|---|---|---|---|---|
|
|
217
|
+
| json | vscode-json-language-server | pull | — | n/a (pull) | 1 | dev+ci | — | — | — |
|
|
218
|
+
| css | vscode-css-language-server | pull | — | n/a (pull) | 1 | dev+ci | — | — | — |
|
|
219
|
+
| html | vscode-html-language-server | pull | — | n/a (pull) | 1 | dev+ci | — | — | — |
|
|
220
|
+
| rust | rust-analyzer | pull | — | n/a (pull) | 1 | dev+ci | — | — | — |
|
|
221
|
+
| svelte | svelte-language-server | pull | — | n/a (pull) | 1 | dev+ci | — | — | — |
|
|
222
|
+
| deno | deno (alt of typescript) | pull | — | n/a (pull) | 1 | dev+ci | — | — | — |
|
|
223
|
+
| ruby | ruby-lsp | pull | — | n/a (pull) | 1 | ci | — | — | — |
|
|
224
|
+
| csharp | csharp-ls | pull | — | n/a (pull) | 1 | ci | — | — | — |
|
|
225
|
+
| typescript | typescript-language-server | push-only | silent | direct | 3 | dev+ci | — | — | — |
|
|
226
|
+
| markdown | marksman | push-only | silent | direct | 3 | ci | — | — | — |
|
|
227
|
+
| lua | lua-language-server | push-only | silent | direct | 3 | dev+ci | — | — | — |
|
|
228
|
+
| python | pyright | push-only | publishes-versioned | direct | 2 | dev+ci | — | — | — |
|
|
229
|
+
| jedi | jedi-language-server (alt of python) | push-only | publishes-versioned | direct | 2 | ci | — | — | — |
|
|
230
|
+
| yaml | yaml-language-server | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
231
|
+
| shell | bash-language-server | push-only | publishes-versioned | direct | 2 | dev+ci | — | — | — |
|
|
232
|
+
| dockerfile | docker-langserver | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
233
|
+
| dockerfile-official | docker-language-server (official) | push-only | publishes-versioned | direct | 2 | dev+ci | — | — | — |
|
|
234
|
+
| toml | taplo | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
235
|
+
| terraform | terraform-ls | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
236
|
+
| prisma | @prisma/language-server | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
237
|
+
| php | intelephense | push-only | publishes-unversioned | empty-first | 2* | dev+ci | — | — | — |
|
|
238
|
+
| zig | zls | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
239
|
+
| vue | @vue/language-server | push-only | unknown | unknown | 2/3? | dev+ci | — | — | — |
|
|
240
|
+
| dart | dart language-server | push-only | publishes-unversioned | direct | 2* | ci | — | — | — |
|
|
241
|
+
| gleam | gleam lsp | push-only | publishes-unversioned | direct | 2* | ci | — | — | — |
|
|
242
|
+
| clojure | clojure-lsp | push-only | publishes-unversioned | direct | 2* | ci | — | — | — |
|
|
243
|
+
| opengrep | opengrep (aux) | push-only | publishes-unversioned | direct | 2* | dev+ci | — | — | — |
|
|
244
|
+
| ast-grep | ast-grep (aux) | push-only | publishes-versioned | direct | 2 | dev+ci | — | — | — |
|
|
245
|
+
| cue | CUE Language Server (cue lsp serve) | push-only | publishes-versioned | direct | 2 | dev+ci | — | — | — |
|
|
203
246
|
|
|
204
247
|
**Unknown — fixture exists, mode not yet captured.** The toolchain-gated family
|
|
205
248
|
(no auto-install today; tracked in #241) — `go` (gopls), `java` (jdtls),
|
|
@@ -372,9 +415,10 @@ observations are never compared (a slow/absent server is not evidence either way
|
|
|
372
415
|
## Capability matrix refresh state (nightly-generated)
|
|
373
416
|
|
|
374
417
|
Bookkeeping for the two-run `first-publish`/`clean-behavior` hysteresis, the
|
|
375
|
-
|
|
376
|
-
|
|
418
|
+
first-miss stamps (#3401, #4615), the consecutive-night `missed-probe`
|
|
419
|
+
streaks behind the `stale` column (#4512) and consecutive-night
|
|
420
|
+
`idle-eviction` counts (#3989). Regenerated every run; never a measurement.
|
|
377
421
|
|
|
378
422
|
```json
|
|
379
|
-
{"idle-eviction":{"
|
|
423
|
+
{"idle-eviction":{"powershell":{"nights":[{"day":"2026-10-27","rssMb":155,"coldMs":2553}]}}}
|
|
380
424
|
```
|