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.
Files changed (121) hide show
  1. package/CHANGELOG.md +83 -0
  2. package/README.md +5 -1
  3. package/dist/{chunk-JL6CXUMW.js → chunk-24BILSZW.js} +1 -1
  4. package/dist/{chunk-S67UJDGQ.js → chunk-2TF6RXWB.js} +5 -5
  5. package/dist/{chunk-ARD426WI.js → chunk-3F6BMY53.js} +1 -1
  6. package/dist/{chunk-5ZR3APIM.js → chunk-3FRLWYBG.js} +26 -26
  7. package/dist/{chunk-T7FTXGS3.js → chunk-3K2F6UDZ.js} +30 -30
  8. package/dist/{chunk-HK6JVFZC.js → chunk-3YY7IXIL.js} +2 -2
  9. package/dist/chunk-46TNM7XZ.js +88 -0
  10. package/dist/{chunk-4AVZ3TG7.js → chunk-4L36HG27.js} +8 -8
  11. package/dist/{chunk-PO45POGF.js → chunk-4LM3VAZH.js} +1 -1
  12. package/dist/{chunk-UN4TEBWN.js → chunk-4LOE5R5P.js} +9 -9
  13. package/dist/{chunk-KLQVC3XC.js → chunk-4YHYPW2G.js} +30 -7
  14. package/dist/{chunk-W5LGKNET.js → chunk-4ZYJHQMB.js} +6 -6
  15. package/dist/{chunk-W2V54OCL.js → chunk-6IR3ZYIB.js} +2 -2
  16. package/dist/{chunk-FJIVKLPH.js → chunk-72OKUXSD.js} +10 -10
  17. package/dist/{chunk-7RQXA5GG.js → chunk-75GAYVNO.js} +10 -9
  18. package/dist/{chunk-V3APN3DY.js → chunk-7E2563GA.js} +12 -12
  19. package/dist/{chunk-4WX4CTUE.js → chunk-7GLOLOSH.js} +25 -25
  20. package/dist/{chunk-BWYQUPOS.js → chunk-ABPKUVA4.js} +1 -1
  21. package/dist/{chunk-IPDG45G5.js → chunk-AKUUMGD5.js} +9 -9
  22. package/dist/{chunk-Q6D6VMI4.js → chunk-ASUXV767.js} +6 -6
  23. package/dist/{chunk-BM5GS6ZH.js → chunk-AWDSEDER.js} +2 -2
  24. package/dist/{chunk-MA77RSFN.js → chunk-BZARLRJW.js} +4 -4
  25. package/dist/{chunk-EVDGNG4F.js → chunk-CB4WHS4H.js} +3 -3
  26. package/dist/{chunk-FA5LDARD.js → chunk-CCV2EU7T.js} +7 -7
  27. package/dist/{chunk-U6OC3QEM.js → chunk-CE6VMBCB.js} +15 -15
  28. package/dist/{chunk-AMXIUN2R.js → chunk-CPSR3AVL.js} +2 -2
  29. package/dist/{chunk-SXGD4ANG.js → chunk-CTADOKYM.js} +7 -7
  30. package/dist/{chunk-63RIVFQI.js → chunk-DH5JPM3K.js} +1 -1
  31. package/dist/{chunk-MT6BVNFW.js → chunk-DPGEAHZT.js} +3 -3
  32. package/dist/{chunk-4PCQCU47.js → chunk-DQZFQSR5.js} +2 -2
  33. package/dist/{chunk-BHUWL2Y3.js → chunk-E7HJ56Y7.js} +5 -5
  34. package/dist/{chunk-DQXSPYRI.js → chunk-EAOK7MIZ.js} +2 -2
  35. package/dist/{chunk-2RLWJO5K.js → chunk-EKWX4WD3.js} +3 -3
  36. package/dist/{chunk-WIZWZR4C.js → chunk-F7K5IBZG.js} +30 -28
  37. package/dist/{chunk-VQH24FIP.js → chunk-FB5SCCPT.js} +9 -9
  38. package/dist/{chunk-GZE7WOI4.js → chunk-FZKFVUEC.js} +438 -140
  39. package/dist/{chunk-TIYGSODX.js → chunk-H7OR7DFZ.js} +15 -13
  40. package/dist/{chunk-CJYKEW2L.js → chunk-HO6LWE2E.js} +1 -1
  41. package/dist/{chunk-YSBHPOY6.js → chunk-HR3OJ3TH.js} +8 -8
  42. package/dist/{chunk-CFRQMBGP.js → chunk-HWDAVBFU.js} +14 -14
  43. package/dist/{chunk-2X4VLOCC.js → chunk-JJ2RRESP.js} +8 -5
  44. package/dist/{chunk-YBSONGSZ.js → chunk-JMEKXFOL.js} +24 -24
  45. package/dist/{chunk-MKVZQUEG.js → chunk-KDX35VXP.js} +69 -13
  46. package/dist/{chunk-75SY4F24.js → chunk-KKCK636N.js} +7 -7
  47. package/dist/{chunk-OLAWH5UQ.js → chunk-KPPJTH44.js} +2 -1
  48. package/dist/{chunk-5APMQ2IJ.js → chunk-KW5JQPO5.js} +1 -1
  49. package/dist/{chunk-SCIUNBPF.js → chunk-L3CMBQMH.js} +11 -11
  50. package/dist/{chunk-GAACZY6R.js → chunk-L5JYIU47.js} +7 -7
  51. package/dist/{chunk-2DDDCJDL.js → chunk-LBLBAFG3.js} +3 -3
  52. package/dist/{chunk-NNKXDXXS.js → chunk-LLS45EWB.js} +8 -0
  53. package/dist/{chunk-WQOIR3QY.js → chunk-LS3QJRUB.js} +7 -7
  54. package/dist/{chunk-XCUHKYCQ.js → chunk-LSC3VADM.js} +6 -6
  55. package/dist/{chunk-GMTFDAOK.js → chunk-LUBPZN36.js} +6 -6
  56. package/dist/{chunk-DMSLNKF7.js → chunk-LV4UMYVH.js} +19 -19
  57. package/dist/{chunk-XAIT2YGS.js → chunk-MB6PXBUA.js} +2 -2
  58. package/dist/{chunk-AE37FEGH.js → chunk-MNJIXFX4.js} +1 -1
  59. package/dist/{chunk-OJLTLYHB.js → chunk-MPKRJBPK.js} +30 -10
  60. package/dist/{chunk-QGSTQH4D.js → chunk-N5WSK2K7.js} +6 -6
  61. package/dist/{chunk-Z7IGUAXL.js → chunk-NA7SEXHE.js} +10 -6
  62. package/dist/{chunk-UHGF5UT5.js → chunk-O4BJFESU.js} +1 -1
  63. package/dist/{chunk-UCGQT677.js → chunk-OE5ZBP7F.js} +10 -10
  64. package/dist/{chunk-KSR7RGQY.js → chunk-OXOI55RU.js} +4 -4
  65. package/dist/{chunk-NDMCVUYK.js → chunk-PR6PO3ES.js} +2 -2
  66. package/dist/{chunk-NIU2IPC5.js → chunk-PUZ3E2J4.js} +3 -3
  67. package/dist/{chunk-2DMLM3ZO.js → chunk-QHSNL7B2.js} +8 -8
  68. package/dist/{chunk-ZYNI26MI.js → chunk-QOE342SU.js} +1 -1
  69. package/dist/{chunk-3WEPUD2V.js → chunk-R5MOQM2H.js} +98 -31
  70. package/dist/{chunk-PPIBVH4R.js → chunk-RC2Z6K47.js} +4 -4
  71. package/dist/{chunk-LEJOJDXL.js → chunk-RORGS5II.js} +4 -4
  72. package/dist/{chunk-K2YGBXOA.js → chunk-RQS4QQSD.js} +1 -1
  73. package/dist/{chunk-XQCSWV2G.js → chunk-RRV3FNNM.js} +10 -10
  74. package/dist/{chunk-GTAI2J6U.js → chunk-SHLDT3OI.js} +8 -8
  75. package/dist/{chunk-VPBIMOAQ.js → chunk-SNDXCFRS.js} +11 -9
  76. package/dist/{chunk-Q4FCYCRE.js → chunk-T7A2HK2B.js} +10 -10
  77. package/dist/{chunk-MN7MHUXQ.js → chunk-U5HPROLA.js} +1 -1
  78. package/dist/{chunk-ZUUI3ZSA.js → chunk-U6VN4NVL.js} +1 -1
  79. package/dist/{chunk-W5R5SABV.js → chunk-U7BD2QL7.js} +6 -6
  80. package/dist/{chunk-P4QNXS6I.js → chunk-UF7RTZSO.js} +8 -8
  81. package/dist/{chunk-A3YNG5KP.js → chunk-URCQWAQ4.js} +11 -11
  82. package/dist/{chunk-FFL3A2VP.js → chunk-VUZWQ7UG.js} +4 -4
  83. package/dist/{chunk-YRD4ISED.js → chunk-W4WP2ERB.js} +10 -10
  84. package/dist/{chunk-OOU2WZZE.js → chunk-WDBICWH3.js} +1 -1
  85. package/dist/{chunk-BI5LAQ3Y.js → chunk-WGRJOXED.js} +114 -148
  86. package/dist/{chunk-ZQ6NZZTB.js → chunk-WME2OQST.js} +33 -0
  87. package/dist/{chunk-DC4CFXM5.js → chunk-XT2HTCJ5.js} +1 -1
  88. package/dist/{chunk-SJJYRZB4.js → chunk-Y7F7IEE3.js} +55 -23
  89. package/dist/{chunk-2F47TQOA.js → chunk-YES5CACN.js} +29 -29
  90. package/dist/{chunk-H7HTEQUZ.js → chunk-YHC2O2WO.js} +7 -7
  91. package/dist/{chunk-Q3UZHW6N.js → chunk-YVHBNSME.js} +6 -10
  92. package/dist/{chunk-3MYEA7QD.js → chunk-ZE3KXHS7.js} +2 -2
  93. package/dist/{chunk-VG5JS5SW.js → chunk-ZGSJDWQU.js} +2 -2
  94. package/dist/{chunk-5CV5ITZF.js → chunk-ZJTT47IG.js} +1 -1
  95. package/dist/{chunk-Q4EMRFNA.js → chunk-ZMAUPOMG.js} +24 -24
  96. package/dist/index.js +1925 -944
  97. package/dist/mcp/analyze-cli.js +6 -6
  98. package/dist/mcp/cli.js +30 -30
  99. package/dist/mcp/server.js +707 -455
  100. package/dist/mcp/worker.js +48 -48
  101. package/dist/probes/installer.js +13 -13
  102. package/docs/agent-tools.md +11 -3
  103. package/docs/defect-shapes.md +15 -1
  104. package/docs/dependencies.md +1 -0
  105. package/docs/environment-variables.md +14 -0
  106. package/docs/features.md +11 -1
  107. package/docs/globalconfig.md +12 -1
  108. package/docs/invariants/git-guard-host.md +34 -0
  109. package/docs/invariants/lsp-trust-exec.md +6 -0
  110. package/docs/invariants/session-telemetry.md +42 -2
  111. package/docs/lsp-capability-matrix.md +89 -45
  112. package/docs/lsp-idle-eviction.md +3 -5
  113. package/docs/pi-lens-fixer.md +8 -1
  114. package/docs/pi-lens-merge-policy.md +7 -4
  115. package/docs/pi-lens-subagent.md +7 -4
  116. package/docs/schema/pi-lens-config-v1.json +23 -0
  117. package/docs/servercapabilities.md +1 -1
  118. package/docs/settings.md +5 -0
  119. package/docs/usage.md +5 -0
  120. package/package.json +1 -1
  121. package/dist/chunk-G2B7F6ZU.js +0 -88
@@ -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-BI5LAQ3Y.js";
6
- import "../chunk-2DDDCJDL.js";
7
- import "../chunk-AE37FEGH.js";
8
- import "../chunk-SJJYRZB4.js";
9
- import "../chunk-2X4VLOCC.js";
10
- import "../chunk-DQXSPYRI.js";
11
- import "../chunk-PO45POGF.js";
12
- import "../chunk-BHUWL2Y3.js";
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-AMXIUN2R.js";
15
- import "../chunk-3MYEA7QD.js";
16
- import "../chunk-K2YGBXOA.js";
17
- import "../chunk-EVDGNG4F.js";
18
- import "../chunk-QGSTQH4D.js";
19
- import "../chunk-V3APN3DY.js";
20
- import "../chunk-XAIT2YGS.js";
21
- import "../chunk-4PCQCU47.js";
22
- import "../chunk-HK6JVFZC.js";
23
- import "../chunk-OOU2WZZE.js";
24
- import "../chunk-TIYGSODX.js";
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-GZE7WOI4.js";
27
- import "../chunk-DC4CFXM5.js";
26
+ import "../chunk-FZKFVUEC.js";
27
+ import "../chunk-XT2HTCJ5.js";
28
28
  import "../chunk-XIMYZ3JA.js";
29
- import "../chunk-3WEPUD2V.js";
30
- import "../chunk-JL6CXUMW.js";
31
- import "../chunk-NDMCVUYK.js";
32
- import "../chunk-PPIBVH4R.js";
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-OJLTLYHB.js";
36
- import "../chunk-63RIVFQI.js";
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-GAACZY6R.js";
39
+ import "../chunk-L5JYIU47.js";
40
40
  import "../chunk-Z54ZSOBZ.js";
41
- import "../chunk-ZUUI3ZSA.js";
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-UHGF5UT5.js";
45
+ import "../chunk-O4BJFESU.js";
46
46
  import "../chunk-CKEQFGLT.js";
47
- import "../chunk-CJYKEW2L.js";
48
- import "../chunk-VPBIMOAQ.js";
49
- import "../chunk-ZYNI26MI.js";
50
- import "../chunk-BM5GS6ZH.js";
51
- import "../chunk-NNKXDXXS.js";
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-MKVZQUEG.js";
55
- import "../chunk-MT6BVNFW.js";
56
- import "../chunk-Z7IGUAXL.js";
57
- import "../chunk-ARD426WI.js";
58
- import "../chunk-5APMQ2IJ.js";
59
- import "../chunk-NIU2IPC5.js";
60
- import "../chunk-BWYQUPOS.js";
61
- import "../chunk-2RLWJO5K.js";
62
- import "../chunk-VG5JS5SW.js";
63
- import "../chunk-Q3UZHW6N.js";
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-OLAWH5UQ.js";
67
+ import "../chunk-KPPJTH44.js";
68
68
  import "../chunk-J6JP25XU.js";
69
69
  import {
70
70
  setProjectTrustState
71
- } from "../chunk-MN7MHUXQ.js";
72
- import "../chunk-ZQ6NZZTB.js";
71
+ } from "../chunk-U5HPROLA.js";
72
+ import "../chunk-WME2OQST.js";
73
73
  import {
74
74
  logExtension
75
75
  } from "../chunk-KXF5R4UN.js";
@@ -53,23 +53,23 @@ import {
53
53
  verifyNpmPackageEntry,
54
54
  verifyToolBinary,
55
55
  wasLastResolveTransient
56
- } from "../chunk-MKVZQUEG.js";
57
- import "../chunk-MT6BVNFW.js";
58
- import "../chunk-Z7IGUAXL.js";
59
- import "../chunk-ARD426WI.js";
60
- import "../chunk-5APMQ2IJ.js";
61
- import "../chunk-NIU2IPC5.js";
62
- import "../chunk-BWYQUPOS.js";
63
- import "../chunk-2RLWJO5K.js";
64
- import "../chunk-VG5JS5SW.js";
65
- import "../chunk-Q3UZHW6N.js";
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-OLAWH5UQ.js";
69
+ import "../chunk-KPPJTH44.js";
70
70
  import "../chunk-J6JP25XU.js";
71
- import "../chunk-MN7MHUXQ.js";
72
- import "../chunk-ZQ6NZZTB.js";
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";
@@ -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. `exported` stays a boolean field only — it is NOT
208
- also repeated inside `flags` (#512); `flags` carries only non-derivable
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`
@@ -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. No guard yet: not scanned.
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
@@ -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 **49 language server definitions** (including four cross-cutting *auxiliary* scanners that attach alongside the file's language server — Opengrep, ast-grep, zizmor, and typos — 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.
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.
@@ -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`). A concurrent secondary still shares the read guard
31
- and the turn-end worklist (the open half of #3613). State `turn_end` parks
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 `direct` `first-publish` cell whose axis the nightly probe does not
139
- re-observe is stamped once with the date of its first miss and degrades to
140
- `unknown` once five calendar days have elapsed since it (skipped nights do not
141
- stall it, and a re-observation clears the stamp). `empty-first` cells are never
142
- expired: they back the live `emptyFirstPublish` markers (php) and
143
- expiring one would erase the measurement behind a marker. That exception is
144
- bounded too (#4615): the refresh stamps the FIRST night it does not re-observe an
145
- `empty-first` cell, and the first-publish census reds once that stamp is five
146
- days old, so the cell+marker pair cannot outlive the instrument that produced it
147
- — a cell with no live measurement behind it is no longer indistinguishable from
148
- a healthy one. A `clean-behavior`/`tier` change is written only after two
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
- date-based `direct` expiry (#3401) and consecutive-night `idle-eviction`
376
- counts (#3989). Regenerated every run; never a measurement.
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":{"docker-official":{"nights":[{"day":"2026-10-23","rssMb":62,"coldMs":883},{"day":"2026-10-24","rssMb":62,"coldMs":957}]},"kotlin":{"nights":[{"day":"2026-10-25","rssMb":270,"coldMs":2522}]},"powershell":{"nights":[{"day":"2026-10-25","rssMb":167,"coldMs":2967}]},"rust":{"nights":[{"day":"2026-10-25","rssMb":596,"coldMs":2927}]},"svelte":{"nights":[{"day":"2026-10-25","rssMb":232,"coldMs":2674}]},"zizmor":{"nights":[{"day":"2026-10-23","rssMb":55,"coldMs":1661},{"day":"2026-10-24","rssMb":57,"coldMs":1683}]}}}
423
+ {"idle-eviction":{"powershell":{"nights":[{"day":"2026-10-27","rssMb":155,"coldMs":2553}]}}}
380
424
  ```