pi-lens 4.4.4 → 4.4.5

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 (179) hide show
  1. package/CHANGELOG.md +440 -0
  2. package/README.md +13 -3
  3. package/config/dependency-cruiser-eager-allowlist.json +1 -0
  4. package/dist/chunk-22Y2BM7H.js +23 -0
  5. package/dist/{chunk-ATKJFDQN.js → chunk-27VWVB23.js} +12 -14
  6. package/dist/{chunk-S2HEXIWI.js → chunk-2FYKETQJ.js} +10 -6
  7. package/dist/{chunk-SRYEJNES.js → chunk-2LDMXL2M.js} +2 -2
  8. package/dist/{chunk-ZHH37KZL.js → chunk-2SDHYHHO.js} +17 -17
  9. package/dist/chunk-2Y6OJRSI.js +38 -0
  10. package/dist/chunk-3SNDVPOR.js +507 -0
  11. package/dist/{chunk-5OFV52AM.js → chunk-3WCEHYOI.js} +1 -1
  12. package/dist/chunk-44X7VIKR.js +73 -0
  13. package/dist/{chunk-DEL2U6CM.js → chunk-4FHUGDKU.js} +16 -14
  14. package/dist/{chunk-CT4MN5IU.js → chunk-4ODSZ35Z.js} +353 -359
  15. package/dist/{chunk-ZIVJBOO3.js → chunk-4U7GDSZQ.js} +2 -2
  16. package/dist/chunk-54NIOJJZ.js +25 -0
  17. package/dist/{chunk-N5FLEO7W.js → chunk-5DKE4HGX.js} +37 -37
  18. package/dist/{chunk-P63GXC37.js → chunk-5LRUKYFA.js} +31 -4
  19. package/dist/{chunk-HRNHZA3N.js → chunk-63NMUNYP.js} +12 -16
  20. package/dist/{chunk-HWCCCQNX.js → chunk-6XSESGWD.js} +13 -6
  21. package/dist/{chunk-UMS2MFPZ.js → chunk-72J27ICO.js} +2 -3
  22. package/dist/{chunk-ED36RF6Y.js → chunk-7FLRUH6B.js} +1 -1
  23. package/dist/chunk-7IYC4ENJ.js +297 -0
  24. package/dist/chunk-7WWQAW5P.js +30 -0
  25. package/dist/{chunk-3DA2JDOL.js → chunk-7ZS7MC24.js} +551 -203
  26. package/dist/{chunk-WMYE35PX.js → chunk-AHWA4AKM.js} +7 -5
  27. package/dist/{chunk-JW3YWBVB.js → chunk-AI3GP74G.js} +17 -19
  28. package/dist/{chunk-AGSS7277.js → chunk-APFJKOP6.js} +6 -23
  29. package/dist/{chunk-ZVUL7QYY.js → chunk-ASRAO7KG.js} +29 -32
  30. package/dist/{chunk-BW5KFIQC.js → chunk-AWQWXSW4.js} +1 -0
  31. package/dist/{chunk-TLX72JTG.js → chunk-CG5V25HX.js} +1 -1
  32. package/dist/chunk-CKEQFGLT.js +32 -0
  33. package/dist/{chunk-Y6GZHWSJ.js → chunk-COOUUC5W.js} +6 -6
  34. package/dist/{chunk-XTBDCR27.js → chunk-CPZ5JJW6.js} +4 -4
  35. package/dist/{chunk-RKKOYPRA.js → chunk-DS2USX5G.js} +13 -15
  36. package/dist/chunk-EA2ZRG44.js +27 -0
  37. package/dist/{chunk-GSLNCYGG.js → chunk-EDMLIW6W.js} +13 -14
  38. package/dist/{chunk-2EECBNC5.js → chunk-EIKRZ32J.js} +75 -0
  39. package/dist/chunk-EKNWOL2I.js +27 -0
  40. package/dist/{chunk-R3T7CLQ2.js → chunk-ELZRSR5N.js} +41 -41
  41. package/dist/{chunk-GMX5OS7B.js → chunk-EN5AM7PX.js} +11 -12
  42. package/dist/{chunk-3RKP3FMS.js → chunk-EWXXLS26.js} +226 -24
  43. package/dist/chunk-EX4EXBW7.js +37 -0
  44. package/dist/{chunk-XHJBS436.js → chunk-EXVXBSGN.js} +25 -25
  45. package/dist/{chunk-MZGQNL3Y.js → chunk-F7BO6FWH.js} +12 -13
  46. package/dist/{chunk-V35JG4JB.js → chunk-FEDWAYDS.js} +152 -334
  47. package/dist/{chunk-J64T55EI.js → chunk-FWZRGGGY.js} +73 -9
  48. package/dist/{chunk-T57LYLZT.js → chunk-G224FADB.js} +1 -1
  49. package/dist/chunk-G5UCJFT7.js +26 -0
  50. package/dist/{chunk-LLJNQKQW.js → chunk-GLW3YDZZ.js} +20 -13
  51. package/dist/{chunk-GXFV6MYU.js → chunk-GTDSYEA2.js} +72 -39
  52. package/dist/{chunk-DUO2TU77.js → chunk-GYRZ72R4.js} +10 -4
  53. package/dist/chunk-HYVXA3BB.js +49 -0
  54. package/dist/{chunk-W66O5E25.js → chunk-IEBJF3PN.js} +13 -15
  55. package/dist/{chunk-GAQ7OQG6.js → chunk-IL7K66ZQ.js} +83 -94
  56. package/dist/{chunk-T7FEBKXN.js → chunk-JWOVP5BL.js} +7 -9
  57. package/dist/{chunk-UBOQLVT2.js → chunk-K2GUZ4DN.js} +4 -4
  58. package/dist/{chunk-5VSF4UUQ.js → chunk-K4SZB56V.js} +34 -39
  59. package/dist/{chunk-7D6L4MTX.js → chunk-KCBRHV5E.js} +3 -3
  60. package/dist/{chunk-GSM5UU7A.js → chunk-KFXCL4OV.js} +38 -28
  61. package/dist/{chunk-J6MPGQTS.js → chunk-KJJAVH3X.js} +81 -15
  62. package/dist/{chunk-BWD5EPKO.js → chunk-KPVLQHCZ.js} +4 -6
  63. package/dist/{chunk-MPNJLASA.js → chunk-KX56K73G.js} +10 -13
  64. package/dist/{chunk-AWSCPCN2.js → chunk-LMCTHJ2H.js} +19 -19
  65. package/dist/{chunk-IWDLU6K3.js → chunk-MEFLGBCS.js} +4 -6
  66. package/dist/{chunk-TOY6QKOH.js → chunk-MKPCELNI.js} +17 -17
  67. package/dist/{chunk-POMLXPMY.js → chunk-N3PLNNCW.js} +1 -1
  68. package/dist/chunk-N5FBM25N.js +22 -0
  69. package/dist/{chunk-CYRKQRPM.js → chunk-NFNVDDGB.js} +2 -4
  70. package/dist/{chunk-RMLC67LF.js → chunk-NLIVE7L6.js} +2 -30
  71. package/dist/{chunk-24AKHFGP.js → chunk-OMJ3OFBJ.js} +6 -6
  72. package/dist/{chunk-IQWN5JCP.js → chunk-OZNCKLOX.js} +13 -14
  73. package/dist/chunk-P5XUGPIX.js +31 -0
  74. package/dist/{chunk-2KXTHF3M.js → chunk-PJXNTPB2.js} +253 -33
  75. package/dist/chunk-PKOXJIVT.js +88 -0
  76. package/dist/{chunk-DGUKIYSI.js → chunk-PP2A5V2T.js} +8 -10
  77. package/dist/{chunk-KAPJINKN.js → chunk-Q42LJANT.js} +2 -2
  78. package/dist/{chunk-UZ2XCLYS.js → chunk-Q4BKKOVC.js} +8 -8
  79. package/dist/{chunk-TIQ2PKDW.js → chunk-QT66NEYN.js} +4 -4
  80. package/dist/{chunk-U44DJXQP.js → chunk-RCHO5W7M.js} +15 -18
  81. package/dist/{chunk-YH5MVY2U.js → chunk-RG3MXTRI.js} +7 -7
  82. package/dist/chunk-RG7OODGM.js +57 -0
  83. package/dist/{chunk-OHKJ7PQF.js → chunk-RU34BA4D.js} +43 -39
  84. package/dist/{chunk-JMYYOTQG.js → chunk-S26LC76R.js} +13 -1
  85. package/dist/{chunk-XBJVAEEO.js → chunk-S55TEC7I.js} +3 -2
  86. package/dist/{chunk-RVK72CZX.js → chunk-SJHC3BCZ.js} +1397 -481
  87. package/dist/{chunk-IYNJ6YPZ.js → chunk-SNEUMLM7.js} +4 -4
  88. package/dist/{chunk-S67KYG37.js → chunk-T4NGVFYI.js} +2 -2
  89. package/dist/{chunk-YCWYO6TQ.js → chunk-THEXI2QO.js} +48 -45
  90. package/dist/{chunk-AMERCH6V.js → chunk-TL2TCJYL.js} +15 -16
  91. package/dist/{chunk-KUA4OJ5Y.js → chunk-TPYYEDP5.js} +823 -350
  92. package/dist/{chunk-YNE3RP52.js → chunk-TVZRLTG6.js} +8 -1
  93. package/dist/{chunk-ROYSX2S5.js → chunk-UCVMSOXF.js} +2 -2
  94. package/dist/chunk-UL5SXQVX.js +32 -0
  95. package/dist/{chunk-7HXE67BN.js → chunk-UO66IMVP.js} +2 -2
  96. package/dist/{chunk-VOOAPROD.js → chunk-UVY4TOJH.js} +3 -3
  97. package/dist/{chunk-RKBXZN3A.js → chunk-VIDEKABZ.js} +2 -2
  98. package/dist/{chunk-2FN63LPV.js → chunk-VITFDI3O.js} +13 -14
  99. package/dist/{chunk-6DLWKFEX.js → chunk-VUAVE3QC.js} +41 -42
  100. package/dist/{chunk-FM4RDMKT.js → chunk-WUY4BZEP.js} +10 -12
  101. package/dist/{chunk-SD4I7ZO4.js → chunk-X3UTCXAA.js} +43 -53
  102. package/dist/chunk-XHDBJODR.js +45 -0
  103. package/dist/{chunk-5IUSNGOC.js → chunk-XHLK33VM.js} +28 -21
  104. package/dist/{chunk-3KAZU3VR.js → chunk-XI34NWDI.js} +2 -2
  105. package/dist/{chunk-QBFBRV2B.js → chunk-XWFIHYCH.js} +4 -2
  106. package/dist/{chunk-JUKMK5Y4.js → chunk-Y2TPADJR.js} +10 -11
  107. package/dist/{chunk-EBC36LNN.js → chunk-Y5KTA2OB.js} +17 -17
  108. package/dist/{chunk-HYGZEMX6.js → chunk-YKVDBNPO.js} +11 -5
  109. package/dist/{chunk-KN35K52N.js → chunk-YSDPVDFC.js} +3 -3
  110. package/dist/chunk-YWNO5Q4R.js +44 -0
  111. package/dist/{chunk-US7ECLD7.js → chunk-YWWG4AQA.js} +119 -28
  112. package/dist/{chunk-O4NWQT6I.js → chunk-YXDCRUKQ.js} +4 -4
  113. package/dist/{chunk-XYURS6EN.js → chunk-YXGRRORB.js} +15 -17
  114. package/dist/{chunk-IUE7SSKV.js → chunk-ZAPSUBLU.js} +13 -7
  115. package/dist/{chunk-EUXZEFTV.js → chunk-ZPJM7DID.js} +3 -3
  116. package/dist/{chunk-5HSRT26B.js → chunk-ZSUX7KEM.js} +16 -15
  117. package/dist/index.js +37155 -32210
  118. package/dist/mcp/analyze-cli.js +11 -12
  119. package/dist/mcp/cli.js +46 -45
  120. package/dist/mcp/server.js +1210 -574
  121. package/dist/mcp/worker.js +65 -65
  122. package/dist/probes/installer.js +21 -23
  123. package/docs/adr/0010-trace-validation-session-lifecycle.md +390 -0
  124. package/docs/adr/README.md +1 -0
  125. package/docs/ast-grep_rules_catalog.md +5 -3
  126. package/docs/configuration.md +9 -0
  127. package/docs/engineering-principles.md +12 -0
  128. package/docs/environment-variables.md +20 -0
  129. package/docs/features.md +16 -1
  130. package/docs/globalconfig.md +37 -8
  131. package/docs/lsp-capability-matrix.md +105 -12
  132. package/docs/lsp-idle-eviction.md +37 -18
  133. package/docs/pi-lens-fixer.md +22 -1
  134. package/docs/pi-lens-investigator.md +14 -0
  135. package/docs/pi-lens-merge-policy.md +23 -10
  136. package/docs/pi-lens-monitor.md +64 -8
  137. package/docs/pi-lens-retro.md +2 -2
  138. package/docs/pi-lens-reviewer.md +48 -1
  139. package/docs/pi-lens-subagent.md +8 -1
  140. package/docs/release-qa-baseline.md +19 -7
  141. package/docs/servercapabilities.md +47 -47
  142. package/docs/settings.md +9 -5
  143. package/docs/subagent-compat.md +1 -1
  144. package/docs/usage.md +1 -0
  145. package/package.json +6 -4
  146. package/rules/ast-grep-rules/rule-tests/no-return-value-in-generator-test.yml +17 -0
  147. package/rules/ast-grep-rules/rule-tests/no-sql-in-code-execute-js-test.yml +86 -0
  148. package/rules/ast-grep-rules/rule-tests/no-sql-in-code-execute-test.yml +86 -0
  149. package/rules/ast-grep-rules/rule-tests/unchecked-numeric-parse-python-test.yml +15 -0
  150. package/rules/ast-grep-rules/rules/no-return-value-in-generator.yml +9 -4
  151. package/rules/ast-grep-rules/rules/no-sql-in-code-execute-js.yml +119 -0
  152. package/rules/ast-grep-rules/rules/no-sql-in-code-execute.yml +119 -0
  153. package/rules/ast-grep-rules/rules/unchecked-numeric-parse-python.yml +13 -2
  154. package/rules/rule-catalog.json +25 -1
  155. package/scripts/analyze-pi-lens-logs.mjs +15 -5
  156. package/scripts/lib/is-main-module.mjs +27 -0
  157. package/scripts/lib/scratch-home-env.mjs +21 -0
  158. package/scripts/rpc-load-check.mjs +4 -6
  159. package/scripts/warm-loader-cache.mjs +2 -5
  160. package/dist/chunk-3PTHXJXR.js +0 -28
  161. package/dist/chunk-3QED2P4V.js +0 -31
  162. package/dist/chunk-5WRPDP2A.js +0 -47
  163. package/dist/chunk-ABBOA7UD.js +0 -157
  164. package/dist/chunk-CUHSHSB6.js +0 -273
  165. package/dist/chunk-GL5LUMZE.js +0 -51
  166. package/dist/chunk-HAD7QRQI.js +0 -30
  167. package/dist/chunk-JORED7EX.js +0 -44
  168. package/dist/chunk-KYUB6QDC.js +0 -72
  169. package/dist/chunk-LZSEQW6A.js +0 -57
  170. package/dist/chunk-M2IFVFWU.js +0 -79
  171. package/dist/chunk-M2UD3LPU.js +0 -88
  172. package/dist/chunk-MBKQHGA7.js +0 -39
  173. package/dist/chunk-R7YOCSNV.js +0 -23
  174. package/dist/chunk-SKAMFC7A.js +0 -28
  175. package/dist/chunk-SYE6T2EB.js +0 -28
  176. package/dist/chunk-TRETHTQO.js +0 -26
  177. package/dist/chunk-UA7ZXYDR.js +0 -184
  178. package/dist/chunk-XTFDJI3T.js +0 -24
  179. package/dist/chunk-Z3CCVDUB.js +0 -76
@@ -21,9 +21,9 @@ reachable.
21
21
 
22
22
  Every PR body starts with `## Why`, `## Notes for the reviewer`, and
23
23
  `## Change outline`, followed by the existing `## Summary`, `## Tests`,
24
- `## Blast radius`, `## Class sweep`, and `## Observability` sections. The
25
- change outline is the changed symbol's caller/callee tree with `+`/`-` on
26
- moved lines; include only structural views that changed.
24
+ `## Blast radius`, `## Class sweep`, `## Observability`, and `## Fold check`
25
+ sections. The change outline is the changed symbol's caller/callee tree with
26
+ `+`/`-` on moved lines; include only structural views that changed.
27
27
 
28
28
  ## The loop, per PR
29
29
 
@@ -186,12 +186,12 @@ bound helper because the brief deferred the fold without a reason.
186
186
 
187
187
  ## External reports (orchestrator)
188
188
 
189
- The contract lives in AGENTS.md, "Issue triage (standing rule)" — assess the
189
+ This section is the contract; AGENTS.md "Issue triage & labels" holds the labels only. Assess the
190
190
  report against the code before accepting or dispatching, ask the one or two
191
191
  facts that would change the design, **do not dispatch work that depends on an
192
192
  unanswered load-bearing question**, mirror the answer on the issue and point
193
193
  the worker there rather than at a paraphrase, and cite the reporter's reasoning
194
- as authority. Read it there; this section only points at it.
194
+ as authority. The steps above are the whole contract.
195
195
 
196
196
  The train-specific consequence: an external lane's first dispatch is often
197
197
  worth delaying by one exchange. On 2026-09-12 a fixer was dispatched on #3000
@@ -236,6 +236,9 @@ re-verification; small code folds carry a red-first test and return to the same
236
236
  reviewer. File only different-seam, blocked, decision-dependent, untouched
237
237
  pre-existing, or risk-class-changing items, as one consolidated issue per PR.
238
238
 
239
+ Folds also decide the issue list itself, one step earlier than a review
240
+ finding: `AGENTS.md`, "Orchestration and delegated work" states that check.
241
+
239
242
  A brief carries the lane's facts and the task, and points at the role
240
243
  contract for everything else. Lane facts are the worktree, branch, base,
241
244
  TMPDIR, test-worker cap, Git grant, and deliverable path. It never restates
@@ -309,7 +312,7 @@ operator's private notes, so a different orchestrator can run the same train.
309
312
  | a change that touches identifier uses of a glossary-retired synonym | run `tests/config/glossary-synonym-sweep.test.ts` on the head AND on the merge with `origin/master`, then re-pin in the PR from the sweep's own `UNPINNED`/`STALE` output — #3279, #3283, #3284, #3288 |
310
313
  | a new `vi.mock` in a test file | run `tests/config/vi-mock-export-sweep.test.ts`; whole-module mocks of a production module must spread `importOriginal` — PR #3268's CI red, fixed by trailing commit `621d61c5c` |
311
314
  | a changelog fragment | front matter `section: <Section>` plus `audience: user` or `audience: internal` and exactly one top-level entry; new user entries open with a bold lead of at most 100 characters (refs excluded), never `CHANGELOG.md`, validated by `node scripts/check-changelog-fragments.mjs` — PR #3268 r1 shipped `category:` and a paragraph |
312
- | a PR body | the header gate: exactly one-sentence `## Why`, `## Notes for the reviewer`, `## Change outline`, plus Summary / Tests with `### Test assessment` / Blast radius / Class sweep / Observability; run `node scripts/check-pr-body.mjs --lint-local` before pushing — three PRs this week needed orchestrator body edits |
315
+ | a PR body | the header gate: exactly one-sentence `## Why`, `## Notes for the reviewer`, `## Change outline`, plus Summary / Tests with `### Test assessment` / Blast radius / Class sweep / Fold check / Observability; run `node scripts/check-pr-body.mjs --lint-local` before pushing — three PRs this week needed orchestrator body edits |
313
316
  | a whole-tree docs restructure of `AGENTS.md` | every governance test that reads `AGENTS.md`, with markers on their own lines — PR #3265 r1 |
314
317
  | a raw poll in a test | the flake-shape ratchet; the fix is the governed wait, never a header admission — #2781 r1 |
315
318
  | a new, renamed or deleted rule file under `rules/` | `npm run docs:rule-catalogs` and commit the generated catalog; `tests/scripts/rule-catalogs.test.ts` is a strict consumer of every rule file, not of rule ids — #3214 r1 |
@@ -460,8 +463,8 @@ operator's private notes, so a different orchestrator can run the same train.
460
463
  (so `Ast-grep self-scan` or `Audit production dependencies` reads as what
461
464
  it is, not as a test failure), its `FAIL` and assertion lines and the
462
465
  `Tests` summary with the ANSI codes stripped, the gating and advisory
463
- counts on separate lines (advisory reds never gate, and are read before
464
- merging), and the remedy hint: `gh run rerun <run>` for a cancelled or
466
+ counts on separate lines (an advisory red gates only when master is green
467
+ on that lane, and every red is read before merging), and the remedy hint: `gh run rerun <run>` for a cancelled or
465
468
  superseded run, the `gh api -X POST .../approve` command for fork
466
469
  approval, `gh pr update-branch <pr>` when the failed merge's base is no
467
470
  longer master's head (a rerun replays the old merge commit, #3660). A job
@@ -508,7 +511,7 @@ operator's private notes, so a different orchestrator can run the same train.
508
511
  Apart from `--approve-fork`, `--rerun-cancelled` and `--sync-main`, which you
509
512
  pass by name, it never approves, reruns or updates a branch: it prints the
510
513
  command.
511
- - **Read the advisory rows before merging, even though they never gate
514
+ - **Read the advisory rows before merging, even where they do not gate
512
515
  (2026-09-12).** The exit-code rule above is right and stays: never text-match
513
516
  the verdict table for `failure`, because advisory rows print `failure` on a
514
517
  green PR. But "does not gate" is not "carries no information", and filtering
@@ -677,6 +680,10 @@ Each row cost a lane at least once; the prose above carries the record.
677
680
  | Dispatching a fixer on an issue's text without checking it against the code | Grep the claimed gap on master before the brief. A stale premise turns the lane into a no-op or a witness-only PR |
678
681
  | Writing off a worker's reds as "sandbox" without a same-env base run | Accept a sandbox attribution only with the same test names red on origin/master under the same env vars. Hundreds of guard reds can hide one real red |
679
682
  | Folding a reviewer's remedy after running only the file the reviewer named | Run every test that references the changed symbol (`rg -l <symbol> tests`) before pushing a fold |
683
+ | Refreshing a census or matrix cell from a probe artifact | shape 76: the row must come from the subject's own emitter, never from an order-sensitive drain (#4615) |
684
+ | Reading a cancelled shard as a failure, or assuming a rerun clears it | shape 77: check the shard's own step conclusions and its measured runtime against the cap (#4672) |
685
+ | Admitting a third-party cache directory at the shared tmp root by name | shape 78: pin the loader's cache off and keep a planted sibling red (#4673) |
686
+ | Writing bytes ahead of the newest message (a returned `context` list, a tool-set change) without measuring the provider prefix | shape 79: write at the tail only, count a tool-set change as one full rewrite on a collapsing model, and compare the head and pi-ai's collapsed head across two real-session requests |
680
687
  | Pushing with `-q` or a grep filter, then landing on whatever the PR head is | Read the push result unfiltered, check `git merge-base --is-ancestor <intended> origin/<branch>`, and land with `EXPECT_HEAD=<intended or its merge>` |
681
688
  | Gating a background step on `until ! pgrep -f '<pattern>'` | That command line matches itself and never exits. Chain the steps in one command, or wait on a PID |
682
689
  | Editing an orchestrator script while a chain or monitor runs it | Stop the chain first, or write a new file and `mv` it into place |
@@ -795,7 +802,7 @@ Each row cost a lane at least once; the prose above carries the record.
795
802
  | Matching a flake on text that CI never prints | The unmatched CI output was noticed during review; the matcher test should have used a captured CI transcript. The flake matcher now keys on the classifier's actual output. |
796
803
  | Letting keyword-title lint contradict the repository convention | The title gate review found the contradiction; the title-convention test should have pinned the accepted form. The lint rule now follows the repository's title convention. |
797
804
  | Relaying a shard failure to a fixer without mirroring it on the PR | The fixer noticed the missing scope record; the scope-mirror hook should have rejected the handoff. The handoff path now records the scope on the PR before dispatch. |
798
- | Treating a repeatedly red advisory lane as harmless | The maintainer's retrospective found the 21% flake after a misleading PR draw; the advisory policy and newest-master comparison should have held the PR. `land.sh` now holds a PR-red/master-green advisory unless `ADVISORY_OK=1`. |
805
+ | Treating a repeatedly red advisory lane as harmless | The maintainer's retrospective found the 21% flake after a misleading PR draw. The advisory policy and newest-master comparison should have held the PR. `merge-on-green.sh` now holds any advisory check red on the PR and green on master. `ADVISORY_OK='<lane>: <reason>'` must name the judgment; it refuses a bare `1`. #4540 (2026-10-17) and #4848 (2026-10-25) landed past such a red. |
799
806
  | Forgetting to arm the landing chain after a trailing fix | A later PR-GREEN event exposed that the fix was waiting unarmed; the trailing-fix command should have verified arming. Rule: after a trailing fix, arm `land.sh` in the same step (not yet mechanised). |
800
807
  | Accepting an identity trade-off without a complete timing-cell table | Cloud verification found primary-item loss after the trade-off was accepted from prose; the fixer's state table and review should have enumerated every timing cell. The brief now requires the complete state table before accepting the trade-off. |
801
808
  | Letting a scoped test exceed Vitest's default timeout | A repeated cloud review caught the timeout; the local targeted run should have exercised the test under its default timeout. Rule: a scoped review runs new tests under the default Vitest timeout before passing them (not yet mechanised). |
@@ -837,3 +844,9 @@ Each row cost a lane at least once; the prose above carries the record.
837
844
  | Pushing to a PR branch while a fix round is queued against its old head | Merging master into #4594 staled the queued round's lease; the worker pushed a diverged copy to its handle branch (plegma #723). The orchestrator's push-verify refuses while a round still publishes to that branch. |
838
845
  | Resuming a reviewer without naming the deliverable | The resumed verifies of #4575 and #4593 inherited report names that did not match the brief, so the hand-back missed the report. Every resumed round names its `deliverables` explicitly. |
839
846
  | Calling an issue "blocked on a release" without reproducing it on master | #4554 waited on a release; 58 runs on master did not reproduce it, and it closed crediting #4563. Reproduce on master before naming a blocker. |
847
+ | Bolding a residual bullet (`- **p3 (LOW, live 0):**`) under `## Accepted residuals` | The tracker parser read only a bare `p3`, so #4832's three residuals were recorded as "none" (2026-10-25). `known-gap-add.sh` now reads the bold form, pinned by its test case (g) |
848
+ | Planning a tracker layout before measuring the platform's limits | An 11-issue pinned split was proposed and dispatched; GitHub pins 3 issues per repository, and the assumed 65k body cap was already exceeded by #4626 at 91k (2026-10-25). Measure the limit first, then plan |
849
+ | Pasting the `claude-lane.sh` header into a brief | The header began `Worktree (created, ...):`, the brief guard wants `Worktree:`, and two dispatches were refused (2026-10-25). The header now starts with `Worktree:`, pinned by `test-claude-lane-header.sh` |
850
+ | Linting a PR body in the main checkout | The main checkout sits on another branch, so citations resolved against the wrong tree; three edits needed a hand-built head tree (2026-10-25). `pr-body.sh edit` without `--tree` now builds a temp tree at the PR head |
851
+ | Guessing issue labels (`area:ci`, `area:formal`, `chore`) | Three filings were refused, and the refusal listed only priority labels (2026-10-25). `file-issue.sh` now lists the known type, area and priority labels |
852
+ | Reaping a lane whose issue is closed while its ledger row is live | Two maintainer-ordered lanes on closed issues (#4714, #4691) were flagged for TaskStop (2026-10-25). `agent-reap.sh` now skips a closed issue with a live ledger row |
@@ -34,25 +34,62 @@ memory growth:
34
34
  row in latency.log records the release and its trigger).
35
35
  - samplerDurationMs measures the sampler's own record-assembly wall time,
36
36
  excluding the surrounding turn.
37
+ - idle is false on the periodic sample. It is true on the one sample written
38
+ at a session's first turn start after its own turn end, when that gap is
39
+ longer than the TS idle-evict window (`getLspIdleEvictMs()`, 20 minutes by
40
+ default). That record also carries idleMs, the measured gap. The heap
41
+ reading is process-wide; the gap belongs to the session whose turn started.
37
42
 
38
43
  All fields are in the existing record and are O(1) reads or latest-value
39
44
  snapshots; no additional telemetry sink is created.
40
45
 
41
46
  ## Inputs
42
47
 
43
- - `~/.pi-lens/latency.log` and `~/.pi-lens/extension.log` (JSON lines; every
44
- row carries `pid` and `ts`). The session is the `pid` the brief names, or the
45
- newest pid with rows in the last hour when the brief says "live".
48
+ Read the monitored process's log directory, resolved by `getGlobalPiLensLogDir()`
49
+ in `clients/probe-home-state.ts`: a non-empty `PI_LENS_HOME` wins, otherwise
50
+ any applicable probe-home redirect, otherwise `~/.pi-lens`. Do not infer this
51
+ from the monitor's own environment. The brief names the root. When it does
52
+ not, a `PI_LENS_HOME` in the monitored pid's environment (`/proc/<pid>/environ`
53
+ on Linux, `ps eww -p <pid>` on macOS) settles it; otherwise a probe-home
54
+ redirect may have chosen the root from that process's working directory, so
55
+ ask the orchestrator for the root instead of reading `~/.pi-lens`. Pass that directory as `--root` to
56
+ `scripts/analyze-pi-lens-logs.mjs`, whose default is `~/.pi-lens`.
57
+
58
+ - `latency.log` and `extension.log` (JSON lines; every row carries `pid`
59
+ and `ts`). The session is the `pid` the brief names, or the newest pid with
60
+ rows in the last hour when the brief says "live".
61
+ - `cascade.log` (JSON lines with `ts`, `phase`, and `filePath`,
62
+ but no `pid` or `type`). Use the selected time window and `filePath` to
63
+ narrow by project. Label counts as project/time-window evidence, not
64
+ pid-attributed evidence; flag shared-project and non-path rows as
65
+ attribution-ambiguous.
46
66
  - The previous readout for the same project when one exists (an issue comment
47
67
  the brief links, or a file under the scratch directory). Every number is
48
68
  reported as a delta against it when available.
49
69
 
70
+ Read active files, retained numbered siblings (for example, `cascade.log.1`),
71
+ and date-only archives (for example, `cascade.log.2026-03-01`), plus timestamped
72
+ archives that overlap the selected window. The analyzer includes numbered and
73
+ date-only siblings by default; use `--archived` for timestamped archive names
74
+ containing `T` (for example, `cascade.2026-03-01T12-00-00Z.log`, the form session-start cleanup writes). Filter rows by
75
+ the selected window in every file. A missing active file does not make its
76
+ retained siblings empty; flag incomplete retention when the files do not cover
77
+ the requested window.
78
+
50
79
  ## The readout (fixed shape, one comment or file, never stdout to the session)
51
80
 
52
81
  1. **Session line**: pid, project root, first/last row timestamps, row count,
53
82
  pi-lens version if a session-start row carries it.
54
- 2. **Phase table**: for every `type:"phase"` value, `n | p50 | p95 | max |
55
- total_ms`, sorted by total, top 15. Durations in ms, from `durationMs`.
83
+ 2. **Phase table**: group `latency.log` rows with `type:"phase"` and
84
+ `cascade.log` rows from all selected files by `source | phase`, using the
85
+ log family as `source` across active and archived siblings. Report
86
+ `n | timed_n | p50 | p95 | max | total_ms`, sorted by total, top 15.
87
+ Count every row in `n`; compute
88
+ timing columns only from numeric `durationMs`, in ms, with `timed_n`
89
+ showing that sample count. Show `-` when no durations exist. List count-only
90
+ phases separately so the timing top 15 cannot hide `cascade_carry_rendered`;
91
+ include its `metadata.carriedRunsRendered` and `metadata.labeledAdvisories`
92
+ totals.
56
93
  3. **Bounds reached at p50** (shape 41): every phase whose p50 is within 10%
57
94
  of a declared budget or timeout in its metadata (`budgetMs`, `timeoutMs`,
58
95
  `elapsedMs` ≈ budget). Name the constant when it is known
@@ -113,7 +150,12 @@ snapshots; no additional telemetry sink is created.
113
150
  displaced is another; a subagent beside a live primary writes none)
114
151
  transitions,
115
152
  `session_end_fence_rollup` (one per primary shutdown: `sources[]` with
116
- `guarded` and `dropped`, plus totals), `lsp_created_import_scan_rollup`
153
+ `guarded` and `dropped`, plus totals), `session_handoff_turn_state` (#4751:
154
+ one per primary that takes the turn-state worklist at its turn_start;
155
+ `arm` `predecessor` (from an in-process predecessor: `from`, its files kept
156
+ as `filesKept`), `evicted` (from a predecessor past the stale bound: `from`,
157
+ its files dropped as `filesDropped`) or `empty`, and `to`),
158
+ `lsp_created_import_scan_rollup`
117
159
  (one per primary shutdown when the created-module producer ran: `calls`,
118
160
  `importers`, `targets`, `capped`, `oversized`, `totalMs`, `maxMs`). Read `read_guard_branch_retained` with
119
161
  `payloadReads`: `kept 0, dropped 0` is a missing payload when `payloadReads`
@@ -153,8 +195,22 @@ snapshots; no additional telemetry sink is created.
153
195
  - File nothing yourself unless the brief grants `gh`; then one comment on the
154
196
  issue the brief names, never a new issue: the orchestrator decides what
155
197
  becomes a lane.
156
- - A worker that finds the logs empty or the pid absent reports exactly that
157
- with the `ls -la` of the two files and stops.
198
+ - The analyzer reads discovered sources independently and does not apply a
199
+ pid-evidence stop rule. It reports per-family file and row counts
200
+ (`filesScanned`, `rowsSeen`, `parseErrors`) but cannot classify each input
201
+ as absent, empty, unreadable, or out-of-window.
202
+ Missing files and unreadable directories can yield no discovered input;
203
+ empty files and out-of-window rows contribute no rows. A discovered file
204
+ read error fails the command instead of producing an empty report. Do not
205
+ infer absent or empty inputs from zero counts alone.
206
+ - Apply the evidence policy in the monitor's own readout: if the pid is absent
207
+ from the selected latency/extension rows, report that and stop only
208
+ pid-attributed analysis. Continue the project/time-window cascade readout,
209
+ including carry counters, without claiming pid ownership. Inspect the inputs
210
+ separately and report absent, empty, unreadable, or out-of-window states as
211
+ observed, with a bounded `ls -la` inventory of the resolved active files and
212
+ retained archives. After reporting those limits, stop the whole readout only
213
+ when neither kind of evidence is available.
158
214
 
159
215
  ## Deliverable
160
216
 
@@ -25,8 +25,8 @@ which is where mistake rows land.
25
25
  ## Inputs (primary sources, never memory)
26
26
 
27
27
  The lane ledger, the session transcripts, PR bodies and review verdicts, CI
28
- job logs on the exact head, `~/.pi-lens/latency.log` when runtime behaviour
29
- is involved. Every finding cites the source it came from.
28
+ job logs on the exact head, `latency.log` under the resolved log root (`docs/pi-lens-monitor.md`
29
+ "Inputs") when runtime behaviour is involved. Every finding cites the source it came from.
30
30
 
31
31
  ## Procedure
32
32
 
@@ -124,6 +124,13 @@ real seam. Check that every gate the diff adds is exercised through that path.
124
124
  *follow-up issue* (p2 or higher only, with its seam group), or *stay
125
125
  specific* (with the reason). A missing verdict is a finding (#3622; the
126
126
  optional ast-grep assist is #3684).
127
+ - **A new test's layer.** A registration question (flags, tools, commands,
128
+ declarations) belongs on tier 1 (`tests/support/pi-runner.ts`), a
129
+ session-flow case on tier 2 (`tests/support/pi-session.ts`), and a
130
+ JSON-lines sink on `readNdjsonRows` (`tests/support/ndjson-rows.ts`), with
131
+ `skipped === 0` asserted when the claim needs the complete output. A fake of
132
+ an in-process store or registry is a finding; other doubles only where
133
+ `AGENTS.md` admits them, which holds the detail.
127
134
  - Review the pre-push self-scan with `npm run astgrep:self-scan`; `pr-preflight`
128
135
  runs the same gate after its build.
129
136
  - Require the exact-pin rule in `docs/pi-lens-subagent.md` on the MERGE of
@@ -140,6 +147,18 @@ real seam. Check that every gate the diff adds is exercised through that path.
140
147
  observability, changelog, commit, and PR-body requirements.
141
148
  - Re-run the PR's `## Class sweep` search yourself and widen it when the
142
149
  named shape is broader than the touched seam (#4273, #4268).
150
+ - Read the `## Fold check` against the open issues and pull requests the PR's
151
+ mechanism has: the lint checks the form (candidate, decision, reason), not
152
+ that every candidate was found, so decide whether the section's search was
153
+ wide enough and whether each `not folded` reason holds (#4711). Open each
154
+ candidate's diff (`gh pr diff <n>`) or the files its issue names: a
155
+ `not folded` line is a finding when the candidate edits the same hunk or
156
+ symbol, or owns a rule this PR re-derives, and a member your own search finds
157
+ that the `## Class sweep` missed is a finding too. The gates check form only
158
+ and the author writes these lines, so this read is the only judgment they
159
+ get. Recurrence: #4713 wrote "shares no clients/ file" beside #4712, and the
160
+ review then re-derived a `clients/analysis-root.ts` rule #4712 edits, while
161
+ the class sweep missed a single-scan-root member.
143
162
  - On a bug-closing PR, check the `## Detection` lesson: the layer named under
144
163
  `Should have been caught by:` must be one that would actually have caught
145
164
  the bug, and `Gap:` must be a real issue, test, or reason (#4288). Judge
@@ -300,7 +319,10 @@ the reproduction command or probe output, expected and observed behaviour, the
300
319
  root cause, cost, and a concrete remedy, and whether it is an
301
320
  issue-acceptance or a repository-standard finding. Severity requires a
302
321
  reproduced failure; a high-severity hypothesis without a failure scenario is
303
- at most medium.
322
+ at most medium. A remedy that adds mechanism for an unreproduced race or edge
323
+ case is filed as a hypothesis with its trigger path and cost, for the
324
+ maintainer to decide, not prescribed to the fixer (principles §1, speculative
325
+ robustness).
304
326
 
305
327
  Start with one verdict: `merge-ready`, `needs changes`, `redesign`, or
306
328
  `conflicted`. Then give spec-compliance and standards-compliance findings under
@@ -327,6 +349,31 @@ merge-order interactions with other open PRs, plus:
327
349
  (`:34`, `:81`). Recurrence: #4566 and #4575 (2026-10-17), where the threads
328
350
  outlived the rounds that should have read them.
329
351
 
352
+ Beside the prose report, write `FINDINGS_<pr>.json` at the worktree root, and
353
+ never commit it. The orchestrator's validator reads it before routing the
354
+ round. Shape:
355
+
356
+ ```json
357
+ {"pr": 4710, "head": "<40-hex sha reviewed>", "verdict": "merge-ready|needs changes|redesign|conflicted", "oneWayDoors": ["..."], "findings": [{"id": "F1", "severity": "<one of the five severity words>", "file": "path", "line": 1, "claim": "one sentence", "probe": "command or probe name whose output proves it", "remedy": "the prescribed change, or null", "addsMechanism": true, "class": "fold|accepted residual|file"}]}
358
+ ```
359
+
360
+ Write one entry per finding, with the same ids as the prose. `remedy: null`
361
+ means the fixer must design the change. `addsMechanism` is true when the
362
+ remedy adds a guard, branch, state, record, or lifecycle step, rather than a
363
+ fix to an existing line. The prose report stays the record a human reads;
364
+ the JSON is what routing reads, so the two must agree. This exists because
365
+ the orchestrator re-typed each finding into a fix brief by hand, and routed
366
+ rounds by judgment instead of by the review's own data.
367
+
368
+ State the change's rollback cost as a required summary line. Name every
369
+ one-way door it ships: something users or other code can come to depend on,
370
+ which a revert does not undo. Examples are a config key or flag users set, a
371
+ durable record shape already written to disk, a public tool, MCP or CLI
372
+ surface, or a migration. Each one-way door needs its proof in the PR: an
373
+ old-record parse fixture, a deprecation path, or a stated reason it is safe.
374
+ `none` is a valid answer, and state it. The JSON's `oneWayDoors` lists the
375
+ same items.
376
+
330
377
  Use short, active, plain prose.
331
378
 
332
379
  ## Documentation and prose standard
@@ -201,7 +201,14 @@ Each pre-push head has a durable result record at
201
201
  `$(git rev-parse --git-common-dir)/pi-lens-prepush/<sha>.json`. It contains the
202
202
  head/base, timestamp, selected test files and their `changed`, `mirror`,
203
203
  `import`, `history`, or `governance` reason, plus passed/failed/skipped
204
- counts, the Vitest exit code, and wall time. Re-pushes overwrite that head's record; writes prune records
204
+ counts, the Vitest exit code, and wall time. `base` is the ref the selection
205
+ diffed. A `tests-complete` record carries `treeBound` only when the tests ran
206
+ in a clean checkout of exactly that head (HEAD equal to it, no tracked
207
+ edits before or after the run); other heads keep their previous record
208
+ (`tests-not-started` after a pass, the run's own outcome after a failure). A re-push of a head
209
+ whose `treeBound` record passed the same selection skips the build and tests,
210
+ keeps the record and appends one `pre-push-skip` row to `pre-push.log` (#4724);
211
+ any other re-push overwrites it. Writes prune records
205
212
  older than fourteen days. The provisional record is written before build and
206
213
  self-scan work with outcome `tests-not-started`; preparation failures update it
207
214
  to `build-failed` or `self-scan-failed`. The write uses a same-directory
@@ -79,6 +79,7 @@ PR's packed tarball (#2700, the check #2587 was missing). `attw`
79
79
  | install-selftest | the runtime dependency graph and the `pi.skills` manifest resolve AS INSTALLED | npm-install | `node <installed>/scripts/install-selftest.mjs --allow-soft` | process exits 0 and no `[FAIL]` line | selftest stdout | `scripts/install-selftest.mjs` verbatim — install-smoke's `smoke` job | #1605 lane 5 (real-host install), narrower: this row asserts the packaged artifact resolves, not that a host classifier parses |
80
80
  | skills-registered | a real pi registers the four pi-lens skills from the installed package | pi-rpc | `pi install <installed pkg>` then `pi --mode rpc` plus `{"type":"get_commands"}` | at least 4 commands with `source` `skill`; every `sourceInfo.path` inside the installed package AND no `sourceInfo.source` is `extension:index` (pi's `pi.skills` manifest is the only registrar; the extension's `resources_discover` handler used to re-add the whole directory and undo settings package filters, #1416) | get_commands response JSON | new probe on the #2589 mechanism — the recurrence is #2587; #1416 widened it to the manifest-registrar direction | — |
81
81
  | commands-registered | the extension loads and registers its `lens-*` slash commands | pi-rpc | same RPC session as above | at least 1 command with `source` `extension` named `lens-*`, and zero `extension_error` events | same get_commands response plus the event stream | `scripts/rpc-load-check.mjs` assertion — install-smoke's `pi-load` job, which runs it against the PUBLISHED package only | #1605 lane 1 (real-host): the same real-host principle, applied to extension registration rather than stderr classification |
82
+ | lsp-warm-resolved | the extension's session-start LSP warm resolves in the installed candidate | pi-rpc | same RPC session as above | pinned `PI_LENS_HOME/extension.log`, observed for 10 s after `get_commands` (a `warm failed` record ends it early), has an `LSP warm resolved` record and no `warm failed` record of any warm; only records stamped at or after the session start count; the witness proves the LSP module loads, not that a language server spawned; a candidate older than the success record (4.4.3 and earlier) has no positive witness and FAILs | extension log NDJSON | new — the existing pi-rpc rows did not read the session-start warm log; recurrence #4314 | `scripts/rpc-load-check.mjs` (install-smoke `pi-load`) reds on any `warn` record of a published package; this row is the release gate's positive witness |
82
83
  | mcp-tools-registered | the MCP mirror advertises the `pilens_*` tool surface | mcp-stdio | `node <installed>/dist/mcp/server.js` then `initialize` plus `tools/list` | every advertised tool name starts `pilens_`, and the set contains analyze, diagnostics, turn_end, lsp_navigation, health | tools/list response JSON | new — no smoke drives the MCP mirror from an install | — |
83
84
  | mcp-diagnostics-full | `lens_diagnostics` full mode answers on a fixture repo | mcp-stdio | `tools/call` `pilens_diagnostics` with `mode` `full` and `refreshRunners` `cheap`, POLLED | text carries a `Summary (N files diagnosed this session)` line with N at least 1 | tool result text | new — `tests/clients` covers the handler, nothing covers it through a packaged install | — |
84
85
  | mcp-turn-end | the turn-end pipeline runs over the turn's files and returns an advisory | mcp-stdio | `tools/call` `pilens_turn_end` with the fixture file | text carries `Turn-end over N file(s).` with N at least 1 | tool result text | new — `scripts/smoke-availability-lifecycle.mjs` covers lifecycle availability, not the packaged turn-end path | #1605 lane 2 (availability-lifecycle): overlaps the turn-end half; #1605 asserts latch recovery, this row asserts the packaged turn-end path answers at all |
@@ -154,16 +155,26 @@ newest-in-range lane reads it, bounded above so `"*"` can never mean
154
155
  matrix has passed on. A newer host enters the window in ONE change: run this
155
156
  matrix on it, add it to that test's verified list, and move the workflow's
156
157
  ceiling together. P1 is one verified host per minor line from 0.86 onward;
157
- 0.81–0.83 are in-window without a dedicated host, while 0.80, 0.84, and
158
- 0.85 are represented by the existing host list and ratchet. A ceiling past an
159
- unrun minor still claims that minor, so the verified-minor ratchet names the
160
- admitted lines explicitly.
158
+ 0.86–1.4 are in-window, and every minor line below 0.86 falls outside the
159
+ window entirely, so none needs a dedicated host. A ceiling past an unrun
160
+ minor still claims that minor, so the verified-minor ratchet names the admitted
161
+ lines explicitly.
162
+
163
+ The floor is 0.86.1 (#4688, maintainer decision 2026-10-20). 0.80–0.85 are
164
+ out of the window: since #4644 pi-lens injects context only from a `context`
165
+ event that carries a system head, and those hosts keep the prompt in
166
+ `agent.state.systemPrompt` and never emit `context_with_system`, so they
167
+ receive no findings and no guidance. Raising the floor was chosen over reviving
168
+ the old hosts; a real 0.80.10 session delivered the staged guidance at
169
+ `91c939e10` and nothing at `e7a0a8aba` (`markerReachedProvider: false` on all
170
+ 3 requests).
161
171
 
162
172
  ### Verified hosts
163
173
 
164
- The certified policy is `>=0.80.10 <1.4.0`. Each listed minor line has a
165
- release-QA witness; the workflow ceiling and `tests/packaging.test.ts` list are
166
- updated together.
174
+ The certified policy is `>=0.86.1 <1.5.0`, and this table is the whole verified
175
+ set: `tests/packaging.test.ts` fails when it and `PI_HOST_SUPPORTED_RANGE`
176
+ disagree. Each listed minor line has a release-QA witness; the workflow ceiling
177
+ and `tests/packaging.test.ts` list are updated together.
167
178
 
168
179
  | host | date | pi-lens commit | result |
169
180
  | --- | --- | --- | --- |
@@ -174,6 +185,7 @@ updated together.
174
185
  | 1.1.0 | 2026-10-08 | 2fda17a53d62267cd9035fa04380bbf0e2de4318 | 15 pass / 1 skipped (git-install-loads) |
175
186
  | 1.2.0 | 2026-10-16 | 9400454891d5a1beb0a4d2d9452dece276e22e71 | 15 pass / 1 skipped (git-install-loads) |
176
187
  | 1.3.0 | 2026-10-16 | 9400454891d5a1beb0a4d2d9452dece276e22e71 | 15 pass / 1 skipped (git-install-loads) |
188
+ | 1.4.0 | 2026-10-22 | 75a1a3c893ed0ac44a3081dd3d475c1e72349099 | 15 pass / 1 skipped (git-install-loads) |
177
189
 
178
190
  Re-run any row with `node scripts/release-qa.mjs --pi <host>` at the listed commit.
179
191
 
@@ -6,55 +6,55 @@ server's `initialize` handshake. Generated by `node scripts/server-capabilities.
6
6
  absent on the generating host are listed under *Unavailable* — run in a
7
7
  provisioned environment (the nightly) to capture those rows.
8
8
 
9
- _Last generated: 2026-10-18 on linux; 41 servers captured, 9 unavailable._
9
+ _Last generated: 2026-10-25 on linux; 41 servers captured, 9 unavailable._
10
10
 
11
11
  ## Diagnostic mode + navigation/edit operations
12
12
 
13
- Legend: ✓ advertised, · not. **mode** = document diagnostics (`pull` = `textDocument/diagnostic`, else push-only); **ws-pull** = advertises `workspace/diagnostic` (one project-wide pull — the #387 Item 2 fast path); **save** = `textDocumentSync.save` (#3407): `save` gets `textDocument/didSave`, `save+text` gets it with the document text (`includeText`), · declares none, ? not captured. **def**=definition, **tDef**=typeDefinition, **decl**=declaration, **ref**=references, **hov**=hover, **sig**=signatureHelp, **dSym**=documentSymbol, **wSym**=workspaceSymbol, **cAct**=codeAction, **rnm**=rename, **impl**=implementation, **cHir**=callHierarchy; **cmds** = executeCommand allowlist size.
13
+ Legend: ✓ advertised, · not. **mode** = document diagnostics (`pull` = `textDocument/diagnostic`, else push-only); **ws-pull** = advertises `workspace/diagnostic` (one project-wide pull — the #387 Item 2 fast path); **save** = `textDocumentSync.save` (#3407): `save` gets `textDocument/didSave`, `save+text` gets it with the document text (`includeText`), · declares none, ? not captured. **def**=definition, **tDef**=typeDefinition, **decl**=declaration, **ref**=references, **hov**=hover, **sig**=signatureHelp, **dSym**=documentSymbol, **wSym**=workspaceSymbol, **cAct**=codeAction, **rnm**=rename, **impl**=implementation, **cHir**=callHierarchy, **dCre**=didCreateFiles; **cmds** = executeCommand allowlist size.
14
14
 
15
- | server | mode | ws-pull | save | def | tDef | decl | ref | hov | sig | dSym | wSym | cAct | rnm | impl | cHir | cmds |
16
- |---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
17
- | ast-grep | push-only | · | · | · | · | · | · | ✓ | · | · | · | ✓ | · | · | · | 1 |
18
- | bash | push-only | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | · | · | 0 |
19
- | clojure | push-only | · | save+text | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 64 |
20
- | cmake | push-only | · | save | · | · | · | · | ✓ | · | · | · | · | · | · | · | 0 |
21
- | cpp | push-only | · | save | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 3 |
22
- | csharp | pull | ✓ | save+text | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 0 |
23
- | css | pull | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | · | ✓ | ✓ | · | · | 0 |
24
- | cue | push-only | · | save | ✓ | · | · | ✓ | ✓ | · | ✓ | · | ✓ | ✓ | · | · | 1 |
25
- | dart | push-only | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 18 |
26
- | deno | pull | · | save | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 2 |
27
- | docker | push-only | · | · | ✓ | · | · | · | ✓ | ✓ | ✓ | · | · | ✓ | · | · | 0 |
28
- | docker-official | push-only | · | · | ✓ | · | · | · | ✓ | · | ✓ | · | ✓ | ✓ | · | · | 1 |
29
- | emmylua | pull | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | · | · | · | 4 |
30
- | expert | push-only | · | save | ✓ | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | · | · | · | 2 |
31
- | fish | push-only | · | save+text | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | 23 |
32
- | fsharp | push-only | · | save+text | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 0 |
33
- | gleam | push-only | · | save | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | · | ✓ | ✓ | · | · | 0 |
34
- | go | push-only | · | save | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 50 |
35
- | html | pull | · | · | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | · | · | ✓ | · | · | 0 |
36
- | json | pull | · | · | · | · | · | · | ✓ | · | ✓ | · | ✓ | · | · | · | 0 |
37
- | kotlin | push-only | · | · | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | 1 |
38
- | lua | push-only | · | save | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | 6 |
39
- | marksman | push-only | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | · | · | 0 |
40
- | opengrep | push-only | · | save | · | · | · | · | ✓ | · | · | · | ✓ | · | · | · | 2 |
41
- | php | push-only | · | · | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | · | · | 0 |
42
- | powershell | push-only | · | save+text | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | 0 |
43
- | prisma | push-only | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | · | ✓ | ✓ | · | · | 0 |
44
- | python | push-only | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | ✓ | 0 |
45
- | python-jedi | push-only | · | save | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | 0 |
46
- | ruby | pull | · | · | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | 0 |
47
- | rust | pull | · | save | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 0 |
48
- | svelte | pull | · | save | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 0 |
49
- | terraform | push-only | · | save | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | · | 7 |
50
- | tinymist | push-only | · | save | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | 29 |
51
- | toml | push-only | · | · | · | · | · | · | ✓ | · | ✓ | · | · | ✓ | · | · | 0 |
52
- | typescript | push-only | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | 8 |
53
- | typos | push-only | · | · | · | · | · | · | · | · | · | · | ✓ | · | · | · | 1 |
54
- | vue | push-only | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | · | ✓ | ✓ | · | · | 0 |
55
- | yaml | push-only | · | · | ✓ | · | · | · | ✓ | · | ✓ | · | ✓ | ✓ | · | · | 1 |
56
- | zig | push-only | · | save | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | 0 |
57
- | zizmor | push-only | · | · | · | · | · | · | · | · | · | · | · | · | · | · | 0 |
15
+ | server | mode | ws-pull | save | def | tDef | decl | ref | hov | sig | dSym | wSym | cAct | rnm | impl | cHir | dCre | cmds |
16
+ |---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
17
+ | ast-grep | push-only | · | · | · | · | · | · | ✓ | · | · | · | ✓ | · | · | · | · | 1 |
18
+ | bash | push-only | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | · | · | · | 0 |
19
+ | clojure | push-only | · | save+text | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | 64 |
20
+ | cmake | push-only | · | save | · | · | · | · | ✓ | · | · | · | · | · | · | · | · | 0 |
21
+ | cpp | push-only | · | save | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | 3 |
22
+ | csharp | pull | ✓ | save+text | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | 0 |
23
+ | css | pull | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | · | ✓ | ✓ | · | · | · | 0 |
24
+ | cue | push-only | · | save | ✓ | · | · | ✓ | ✓ | · | ✓ | · | ✓ | ✓ | · | · | · | 1 |
25
+ | dart | push-only | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | 18 |
26
+ | deno | pull | · | save | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | 2 |
27
+ | docker | push-only | · | · | ✓ | · | · | · | ✓ | ✓ | ✓ | · | · | ✓ | · | · | · | 0 |
28
+ | docker-official | push-only | · | · | ✓ | · | · | · | ✓ | · | ✓ | · | ✓ | ✓ | · | · | · | 1 |
29
+ | emmylua | pull | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | · | · | · | · | 4 |
30
+ | expert | push-only | · | save | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | ✓ | ✓ | · | 2 |
31
+ | fish | push-only | · | save+text | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | 23 |
32
+ | fsharp | push-only | · | save+text | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | 0 |
33
+ | gleam | push-only | · | save | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | · | ✓ | ✓ | · | · | · | 0 |
34
+ | go | push-only | · | save | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 50 |
35
+ | html | pull | · | · | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | · | · | ✓ | · | · | · | 0 |
36
+ | json | pull | · | · | · | · | · | · | ✓ | · | ✓ | · | ✓ | · | · | · | · | 0 |
37
+ | kotlin | push-only | · | · | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | · | 1 |
38
+ | lua | push-only | · | save | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | 6 |
39
+ | marksman | push-only | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | · | · | ✓ | 0 |
40
+ | opengrep | push-only | · | save | · | · | · | · | ✓ | · | · | · | ✓ | · | · | · | ✓ | 2 |
41
+ | php | push-only | · | · | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | · | · | · | 0 |
42
+ | powershell | push-only | · | save+text | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | · | 0 |
43
+ | prisma | push-only | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | · | ✓ | ✓ | · | · | · | 0 |
44
+ | python | push-only | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | ✓ | · | 0 |
45
+ | python-jedi | push-only | · | save | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | · | 0 |
46
+ | ruby | pull | · | · | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | · | 0 |
47
+ | rust | pull | · | save | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | 0 |
48
+ | svelte | pull | · | save | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | 0 |
49
+ | terraform | push-only | · | save | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | · | · | 7 |
50
+ | tinymist | push-only | · | save | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | · | 29 |
51
+ | toml | push-only | · | · | · | · | · | · | ✓ | · | ✓ | · | · | ✓ | · | · | · | 0 |
52
+ | typescript | push-only | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | 8 |
53
+ | typos | push-only | · | · | · | · | · | · | · | · | · | · | ✓ | · | · | · | · | 1 |
54
+ | vue | push-only | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | · | ✓ | ✓ | · | · | · | 0 |
55
+ | yaml | push-only | · | · | ✓ | · | · | · | ✓ | · | ✓ | · | ✓ | ✓ | · | · | · | 1 |
56
+ | zig | push-only | · | save | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | · | 0 |
57
+ | zizmor | push-only | · | · | · | · | · | · | · | · | · | · | · | · | · | · | · | 0 |
58
58
 
59
59
  ## Raw advertised capability keys
60
60
 
@@ -74,7 +74,7 @@ surface, including providers pi-lens does not yet consume.
74
74
  - **docker**: codeActionProvider, completionProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentLinkProvider, documentOnTypeFormattingProvider, documentRangeFormattingProvider, documentSymbolProvider, foldingRangeProvider, hoverProvider, renameProvider, signatureHelpProvider, textDocumentSync
75
75
  - **docker-official**: codeActionProvider, completionProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentLinkProvider, documentSymbolProvider, executeCommandProvider, hoverProvider, inlayHintProvider, inlineCompletionProvider, renameProvider, semanticTokensProvider, textDocumentSync
76
76
  - **emmylua**: codeActionProvider, definitionProvider, diagnosticProvider, documentSymbolProvider, executeCommandProvider, hoverProvider, referencesProvider, textDocumentSync, workspaceSymbolProvider
77
- - **expert**: codeActionProvider, codeLensProvider, completionProvider, definitionProvider, documentFormattingProvider, documentSymbolProvider, executeCommandProvider, experimental, hoverProvider, referencesProvider, textDocumentSync, workspace, workspaceSymbolProvider
77
+ - **expert**: callHierarchyProvider, codeActionProvider, codeLensProvider, completionProvider, declarationProvider, definitionProvider, documentFormattingProvider, documentSymbolProvider, executeCommandProvider, experimental, foldingRangeProvider, hoverProvider, implementationProvider, referencesProvider, selectionRangeProvider, signatureHelpProvider, textDocumentSync, workspace, workspaceSymbolProvider
78
78
  - **fish**: codeActionProvider, completionProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentOnTypeFormattingProvider, documentRangeFormattingProvider, documentSymbolProvider, executeCommandProvider, foldingRangeProvider, hoverProvider, implementationProvider, inlayHintProvider, referencesProvider, renameProvider, selectionRangeProvider, semanticTokensProvider, signatureHelpProvider, textDocumentSync, workspace, workspaceSymbolProvider
79
79
  - **fsharp**: callHierarchyProvider, codeActionProvider, codeLensProvider, completionProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentRangeFormattingProvider, documentSymbolProvider, foldingRangeProvider, hoverProvider, implementationProvider, inlayHintProvider, referencesProvider, renameProvider, selectionRangeProvider, semanticTokensProvider, signatureHelpProvider, textDocumentSync, typeDefinitionProvider, workspaceSymbolProvider
80
80
  - **gleam**: codeActionProvider, completionProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentSymbolProvider, foldingRangeProvider, hoverProvider, referencesProvider, renameProvider, signatureHelpProvider, textDocumentSync, typeDefinitionProvider, workspace
@@ -100,7 +100,7 @@ surface, including providers pi-lens does not yet consume.
100
100
  - **typos**: codeActionProvider, executeCommandProvider, positionEncoding, textDocumentSync, workspace
101
101
  - **vue**: codeActionProvider, colorProvider, completionProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentLinkProvider, documentOnTypeFormattingProvider, documentRangeFormattingProvider, documentSymbolProvider, experimental, foldingRangeProvider, hoverProvider, inlayHintProvider, linkedEditingRangeProvider, referencesProvider, renameProvider, selectionRangeProvider, semanticTokensProvider, textDocumentSync, workspace
102
102
  - **yaml**: codeActionProvider, codeLensProvider, completionProvider, definitionProvider, documentFormattingProvider, documentLinkProvider, documentOnTypeFormattingProvider, documentRangeFormattingProvider, documentSymbolProvider, executeCommandProvider, foldingRangeProvider, hoverProvider, renameProvider, selectionRangeProvider, textDocumentSync, workspace
103
- - **zig**: codeActionProvider, colorProvider, completionProvider, declarationProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentRangeFormattingProvider, documentSymbolProvider, foldingRangeProvider, hoverProvider, implementationProvider, inlayHintProvider, positionEncoding, referencesProvider, renameProvider, selectionRangeProvider, semanticTokensProvider, signatureHelpProvider, textDocumentSync, typeDefinitionProvider, workspace, workspaceSymbolProvider
103
+ - **zig**: codeActionProvider, colorProvider, completionProvider, declarationProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentRangeFormattingProvider, documentSymbolProvider, foldingRangeProvider, hoverProvider, inlayHintProvider, positionEncoding, referencesProvider, renameProvider, selectionRangeProvider, semanticTokensProvider, signatureHelpProvider, textDocumentSync, typeDefinitionProvider, workspace, workspaceSymbolProvider
104
104
  - **zizmor**: textDocumentSync
105
105
 
106
106
  ## Advertised executeCommand allowlists
package/docs/settings.md CHANGED
@@ -79,6 +79,7 @@ column is the effective behavior when nothing is set.
79
79
  | `--no-opengrep` | `opengrep.enabled` | global | Opengrep scanner **on** |
80
80
  | `--no-read-guard` | `readGuard.enabled` | global | read-before-edit monitor **on** |
81
81
  | `--no-lens-context` | `contextInjection.enabled` | global | context injection **on** |
82
+ | `--lens-retain-injections` | `contextInjection.retain` | global | **off** |
82
83
  | `--lens-turn-summary` | `turnSummary.enabled` | global | **off** |
83
84
  | `--lens-actionable-warnings` | `actionableWarnings.enabled` | global | **off** |
84
85
  | `--lens-actionable-warning-actions` | `actionableWarnings.includeLspCodeActions` | global | **off** |
@@ -88,7 +89,7 @@ column is the effective behavior when nothing is set.
88
89
  | `--lens-compact-lsp-status` | `ui.compactLspStatus` | global | **off** (footer lists the active server names) |
89
90
  | `--lens-hide-lsp-status` | `ui.hideLspStatus` | global | **off** (footer publishes the `pi-lens-lsp` status; outranks `ui.compactLspStatus` when both are set) |
90
91
  | `--lens-compact-widget` | `ui.compactWidget` | global | **off** (widget stacks file rows, suppressed count and blocker details below its summary header; **on** renders only that header — languages + totals, plus the `LSP↑` chip while servers are spawning) |
91
- | `--no-lazy-tools` | `tools.lazy` | global | lazy tools **on** (five situational tools start inactive) |
92
+ | `--no-lazy-tools` | `tools.lazy` | global | `true`: the five situational tools start inactive on every model (`"auto"` only on a model that keeps mid-conversation system messages, `false` never) |
92
93
  | `--no-tool=<name>` | `tools.<name>.enabled` | project | every lens tool **on** |
93
94
  | `--lens-turn-end-madge` | `turnEnd.madge.enabled` | global | **off** (madge runs at session start, not per turn) |
94
95
  | `--no-knip` | `knip.enabled` | project | knip analyzer **on** |
@@ -99,10 +100,13 @@ column is the effective behavior when nothing is set.
99
100
  | `--no-dead-code` | `deadCode.enabled` | project | dead-code analyzer **on** |
100
101
  | `--no-complexity` | `complexity.enabled` | project | complexity analyzer **on** |
101
102
 
102
- `--no-lazy-tools` keeps every pi-lens tool active for the whole session, so the
103
- advertised tool list never changes. The `pi_lens_activate_tools` loader stays
104
- registered and keeps its usual description; under this flag the tools it names
105
- are already active, so calling it is a no-op.
103
+ `--no-lazy-tools` (or `tools.lazy: false`) keeps every pi-lens tool active for
104
+ the whole session, so the advertised tool list never changes. The opt-in
105
+ `"auto"` decides per model, at session start and on a model switch only; see
106
+ [globalconfig.md](globalconfig.md#startup-controls) for the rule, why `true`
107
+ stays the default, and the precedence over `tools.<name>.enabled`. The `pi_lens_activate_tools` loader
108
+ stays registered and keeps its usual description; when the tools it names are
109
+ already active, calling it is a no-op.
106
110
 
107
111
  The `tools.<name>.enabled` population covers every model-facing pi and MCP
108
112
  tool. The loader `pi_lens_activate_tools` and MCP lifecycle tools
@@ -111,7 +111,7 @@ mechanism `.github/workflows/install-smoke.yml` already uses) and drives
111
111
  needed, matching `scripts/rpc-load-check.mjs`'s no-model-required design.
112
112
 
113
113
  **Every invocation sets `PI_LENS_STARTUP_MODE=full`.** pi-lens's
114
- cold-start-quick optimization (see AGENTS.md "Session-start critical path")
114
+ cold-start-quick optimization (see HISTORY.md "Session-start critical path")
115
115
  forces the *first* `session_start` of any process onto the fast "quick"
116
116
  path regardless of `--print` — that path returns before the subagent-light
117
117
  -mode check (and the heavyweight-scan skip it gates) ever runs. This was
package/docs/usage.md CHANGED
@@ -110,6 +110,7 @@ pi --lens-guard # Block git commit/push when unresolved blockers exist
110
110
  pi --lens-checkout-guard # Decline git commands that rewrite the working tree while another live pi-lens session shares this dirty checkout (experimental)
111
111
  pi --no-opengrep # Disable the Opengrep security scanner (default-on auxiliary LSP)
112
112
  pi --no-read-guard # Disable the read-before-edit behavior monitor
113
+ pi --lens-retain-injections # Re-send injected findings unchanged in later requests, for exact-prefix (local) prompt caches
113
114
  pi --lens-turn-summary # Persist a per-turn summary of diagnostics, autofixes, and autoformats
114
115
  pi --lens-compact-tool-line # Render tool results as one compact, theme-aware line (closes #1327)
115
116
  pi --lens-compact-lsp-status # Collapse the footer LSP status to one state glyph instead of the server names (refs #3099)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-lens",
3
- "version": "4.4.4",
3
+ "version": "4.4.5",
4
4
  "type": "module",
5
5
  "description": "Real-time code feedback for pi — LSP, linters, formatters, type-checking, structural analysis & booboo",
6
6
  "repository": {
@@ -114,7 +114,9 @@
114
114
  "scripts/analyze-pi-lens-logs.mjs",
115
115
  "scripts/install-selftest.mjs",
116
116
  "scripts/lib/host-provided-deps.mjs",
117
+ "scripts/lib/is-main-module.mjs",
117
118
  "scripts/lib/latency-log-phases.mjs",
119
+ "scripts/lib/scratch-home-env.mjs",
118
120
  "scripts/lib/skills-predicate.mjs",
119
121
  "scripts/lib/web-tree-sitter-dir.mjs",
120
122
  "scripts/lib/warm-loader-cache.mjs",
@@ -126,8 +128,8 @@
126
128
  "banner.png"
127
129
  ],
128
130
  "dependencies": {
129
- "@ast-grep/cli": "0.50.0",
130
- "@ast-grep/napi": "^0.50.0",
131
+ "@ast-grep/cli": "0.51.0",
132
+ "@ast-grep/napi": "^0.51.0",
131
133
  "js-yaml": "^5.2.2",
132
134
  "minimatch": "^10.2.6",
133
135
  "pidusage": "^4.0.1",
@@ -162,7 +164,7 @@
162
164
  ]
163
165
  },
164
166
  "allowScripts": {
165
- "@ast-grep/cli@0.50.0": true,
167
+ "@ast-grep/cli@0.51.0": true,
166
168
  "@google/genai@2.21.0": true,
167
169
  "esbuild@0.28.2": true,
168
170
  "fsevents@2.3.3": false,