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.
- package/CHANGELOG.md +440 -0
- package/README.md +13 -3
- package/config/dependency-cruiser-eager-allowlist.json +1 -0
- package/dist/chunk-22Y2BM7H.js +23 -0
- package/dist/{chunk-ATKJFDQN.js → chunk-27VWVB23.js} +12 -14
- package/dist/{chunk-S2HEXIWI.js → chunk-2FYKETQJ.js} +10 -6
- package/dist/{chunk-SRYEJNES.js → chunk-2LDMXL2M.js} +2 -2
- package/dist/{chunk-ZHH37KZL.js → chunk-2SDHYHHO.js} +17 -17
- package/dist/chunk-2Y6OJRSI.js +38 -0
- package/dist/chunk-3SNDVPOR.js +507 -0
- package/dist/{chunk-5OFV52AM.js → chunk-3WCEHYOI.js} +1 -1
- package/dist/chunk-44X7VIKR.js +73 -0
- package/dist/{chunk-DEL2U6CM.js → chunk-4FHUGDKU.js} +16 -14
- package/dist/{chunk-CT4MN5IU.js → chunk-4ODSZ35Z.js} +353 -359
- package/dist/{chunk-ZIVJBOO3.js → chunk-4U7GDSZQ.js} +2 -2
- package/dist/chunk-54NIOJJZ.js +25 -0
- package/dist/{chunk-N5FLEO7W.js → chunk-5DKE4HGX.js} +37 -37
- package/dist/{chunk-P63GXC37.js → chunk-5LRUKYFA.js} +31 -4
- package/dist/{chunk-HRNHZA3N.js → chunk-63NMUNYP.js} +12 -16
- package/dist/{chunk-HWCCCQNX.js → chunk-6XSESGWD.js} +13 -6
- package/dist/{chunk-UMS2MFPZ.js → chunk-72J27ICO.js} +2 -3
- package/dist/{chunk-ED36RF6Y.js → chunk-7FLRUH6B.js} +1 -1
- package/dist/chunk-7IYC4ENJ.js +297 -0
- package/dist/chunk-7WWQAW5P.js +30 -0
- package/dist/{chunk-3DA2JDOL.js → chunk-7ZS7MC24.js} +551 -203
- package/dist/{chunk-WMYE35PX.js → chunk-AHWA4AKM.js} +7 -5
- package/dist/{chunk-JW3YWBVB.js → chunk-AI3GP74G.js} +17 -19
- package/dist/{chunk-AGSS7277.js → chunk-APFJKOP6.js} +6 -23
- package/dist/{chunk-ZVUL7QYY.js → chunk-ASRAO7KG.js} +29 -32
- package/dist/{chunk-BW5KFIQC.js → chunk-AWQWXSW4.js} +1 -0
- package/dist/{chunk-TLX72JTG.js → chunk-CG5V25HX.js} +1 -1
- package/dist/chunk-CKEQFGLT.js +32 -0
- package/dist/{chunk-Y6GZHWSJ.js → chunk-COOUUC5W.js} +6 -6
- package/dist/{chunk-XTBDCR27.js → chunk-CPZ5JJW6.js} +4 -4
- package/dist/{chunk-RKKOYPRA.js → chunk-DS2USX5G.js} +13 -15
- package/dist/chunk-EA2ZRG44.js +27 -0
- package/dist/{chunk-GSLNCYGG.js → chunk-EDMLIW6W.js} +13 -14
- package/dist/{chunk-2EECBNC5.js → chunk-EIKRZ32J.js} +75 -0
- package/dist/chunk-EKNWOL2I.js +27 -0
- package/dist/{chunk-R3T7CLQ2.js → chunk-ELZRSR5N.js} +41 -41
- package/dist/{chunk-GMX5OS7B.js → chunk-EN5AM7PX.js} +11 -12
- package/dist/{chunk-3RKP3FMS.js → chunk-EWXXLS26.js} +226 -24
- package/dist/chunk-EX4EXBW7.js +37 -0
- package/dist/{chunk-XHJBS436.js → chunk-EXVXBSGN.js} +25 -25
- package/dist/{chunk-MZGQNL3Y.js → chunk-F7BO6FWH.js} +12 -13
- package/dist/{chunk-V35JG4JB.js → chunk-FEDWAYDS.js} +152 -334
- package/dist/{chunk-J64T55EI.js → chunk-FWZRGGGY.js} +73 -9
- package/dist/{chunk-T57LYLZT.js → chunk-G224FADB.js} +1 -1
- package/dist/chunk-G5UCJFT7.js +26 -0
- package/dist/{chunk-LLJNQKQW.js → chunk-GLW3YDZZ.js} +20 -13
- package/dist/{chunk-GXFV6MYU.js → chunk-GTDSYEA2.js} +72 -39
- package/dist/{chunk-DUO2TU77.js → chunk-GYRZ72R4.js} +10 -4
- package/dist/chunk-HYVXA3BB.js +49 -0
- package/dist/{chunk-W66O5E25.js → chunk-IEBJF3PN.js} +13 -15
- package/dist/{chunk-GAQ7OQG6.js → chunk-IL7K66ZQ.js} +83 -94
- package/dist/{chunk-T7FEBKXN.js → chunk-JWOVP5BL.js} +7 -9
- package/dist/{chunk-UBOQLVT2.js → chunk-K2GUZ4DN.js} +4 -4
- package/dist/{chunk-5VSF4UUQ.js → chunk-K4SZB56V.js} +34 -39
- package/dist/{chunk-7D6L4MTX.js → chunk-KCBRHV5E.js} +3 -3
- package/dist/{chunk-GSM5UU7A.js → chunk-KFXCL4OV.js} +38 -28
- package/dist/{chunk-J6MPGQTS.js → chunk-KJJAVH3X.js} +81 -15
- package/dist/{chunk-BWD5EPKO.js → chunk-KPVLQHCZ.js} +4 -6
- package/dist/{chunk-MPNJLASA.js → chunk-KX56K73G.js} +10 -13
- package/dist/{chunk-AWSCPCN2.js → chunk-LMCTHJ2H.js} +19 -19
- package/dist/{chunk-IWDLU6K3.js → chunk-MEFLGBCS.js} +4 -6
- package/dist/{chunk-TOY6QKOH.js → chunk-MKPCELNI.js} +17 -17
- package/dist/{chunk-POMLXPMY.js → chunk-N3PLNNCW.js} +1 -1
- package/dist/chunk-N5FBM25N.js +22 -0
- package/dist/{chunk-CYRKQRPM.js → chunk-NFNVDDGB.js} +2 -4
- package/dist/{chunk-RMLC67LF.js → chunk-NLIVE7L6.js} +2 -30
- package/dist/{chunk-24AKHFGP.js → chunk-OMJ3OFBJ.js} +6 -6
- package/dist/{chunk-IQWN5JCP.js → chunk-OZNCKLOX.js} +13 -14
- package/dist/chunk-P5XUGPIX.js +31 -0
- package/dist/{chunk-2KXTHF3M.js → chunk-PJXNTPB2.js} +253 -33
- package/dist/chunk-PKOXJIVT.js +88 -0
- package/dist/{chunk-DGUKIYSI.js → chunk-PP2A5V2T.js} +8 -10
- package/dist/{chunk-KAPJINKN.js → chunk-Q42LJANT.js} +2 -2
- package/dist/{chunk-UZ2XCLYS.js → chunk-Q4BKKOVC.js} +8 -8
- package/dist/{chunk-TIQ2PKDW.js → chunk-QT66NEYN.js} +4 -4
- package/dist/{chunk-U44DJXQP.js → chunk-RCHO5W7M.js} +15 -18
- package/dist/{chunk-YH5MVY2U.js → chunk-RG3MXTRI.js} +7 -7
- package/dist/chunk-RG7OODGM.js +57 -0
- package/dist/{chunk-OHKJ7PQF.js → chunk-RU34BA4D.js} +43 -39
- package/dist/{chunk-JMYYOTQG.js → chunk-S26LC76R.js} +13 -1
- package/dist/{chunk-XBJVAEEO.js → chunk-S55TEC7I.js} +3 -2
- package/dist/{chunk-RVK72CZX.js → chunk-SJHC3BCZ.js} +1397 -481
- package/dist/{chunk-IYNJ6YPZ.js → chunk-SNEUMLM7.js} +4 -4
- package/dist/{chunk-S67KYG37.js → chunk-T4NGVFYI.js} +2 -2
- package/dist/{chunk-YCWYO6TQ.js → chunk-THEXI2QO.js} +48 -45
- package/dist/{chunk-AMERCH6V.js → chunk-TL2TCJYL.js} +15 -16
- package/dist/{chunk-KUA4OJ5Y.js → chunk-TPYYEDP5.js} +823 -350
- package/dist/{chunk-YNE3RP52.js → chunk-TVZRLTG6.js} +8 -1
- package/dist/{chunk-ROYSX2S5.js → chunk-UCVMSOXF.js} +2 -2
- package/dist/chunk-UL5SXQVX.js +32 -0
- package/dist/{chunk-7HXE67BN.js → chunk-UO66IMVP.js} +2 -2
- package/dist/{chunk-VOOAPROD.js → chunk-UVY4TOJH.js} +3 -3
- package/dist/{chunk-RKBXZN3A.js → chunk-VIDEKABZ.js} +2 -2
- package/dist/{chunk-2FN63LPV.js → chunk-VITFDI3O.js} +13 -14
- package/dist/{chunk-6DLWKFEX.js → chunk-VUAVE3QC.js} +41 -42
- package/dist/{chunk-FM4RDMKT.js → chunk-WUY4BZEP.js} +10 -12
- package/dist/{chunk-SD4I7ZO4.js → chunk-X3UTCXAA.js} +43 -53
- package/dist/chunk-XHDBJODR.js +45 -0
- package/dist/{chunk-5IUSNGOC.js → chunk-XHLK33VM.js} +28 -21
- package/dist/{chunk-3KAZU3VR.js → chunk-XI34NWDI.js} +2 -2
- package/dist/{chunk-QBFBRV2B.js → chunk-XWFIHYCH.js} +4 -2
- package/dist/{chunk-JUKMK5Y4.js → chunk-Y2TPADJR.js} +10 -11
- package/dist/{chunk-EBC36LNN.js → chunk-Y5KTA2OB.js} +17 -17
- package/dist/{chunk-HYGZEMX6.js → chunk-YKVDBNPO.js} +11 -5
- package/dist/{chunk-KN35K52N.js → chunk-YSDPVDFC.js} +3 -3
- package/dist/chunk-YWNO5Q4R.js +44 -0
- package/dist/{chunk-US7ECLD7.js → chunk-YWWG4AQA.js} +119 -28
- package/dist/{chunk-O4NWQT6I.js → chunk-YXDCRUKQ.js} +4 -4
- package/dist/{chunk-XYURS6EN.js → chunk-YXGRRORB.js} +15 -17
- package/dist/{chunk-IUE7SSKV.js → chunk-ZAPSUBLU.js} +13 -7
- package/dist/{chunk-EUXZEFTV.js → chunk-ZPJM7DID.js} +3 -3
- package/dist/{chunk-5HSRT26B.js → chunk-ZSUX7KEM.js} +16 -15
- package/dist/index.js +37155 -32210
- package/dist/mcp/analyze-cli.js +11 -12
- package/dist/mcp/cli.js +46 -45
- package/dist/mcp/server.js +1210 -574
- package/dist/mcp/worker.js +65 -65
- package/dist/probes/installer.js +21 -23
- package/docs/adr/0010-trace-validation-session-lifecycle.md +390 -0
- package/docs/adr/README.md +1 -0
- package/docs/ast-grep_rules_catalog.md +5 -3
- package/docs/configuration.md +9 -0
- package/docs/engineering-principles.md +12 -0
- package/docs/environment-variables.md +20 -0
- package/docs/features.md +16 -1
- package/docs/globalconfig.md +37 -8
- package/docs/lsp-capability-matrix.md +105 -12
- package/docs/lsp-idle-eviction.md +37 -18
- package/docs/pi-lens-fixer.md +22 -1
- package/docs/pi-lens-investigator.md +14 -0
- package/docs/pi-lens-merge-policy.md +23 -10
- package/docs/pi-lens-monitor.md +64 -8
- package/docs/pi-lens-retro.md +2 -2
- package/docs/pi-lens-reviewer.md +48 -1
- package/docs/pi-lens-subagent.md +8 -1
- package/docs/release-qa-baseline.md +19 -7
- package/docs/servercapabilities.md +47 -47
- package/docs/settings.md +9 -5
- package/docs/subagent-compat.md +1 -1
- package/docs/usage.md +1 -0
- package/package.json +6 -4
- package/rules/ast-grep-rules/rule-tests/no-return-value-in-generator-test.yml +17 -0
- package/rules/ast-grep-rules/rule-tests/no-sql-in-code-execute-js-test.yml +86 -0
- package/rules/ast-grep-rules/rule-tests/no-sql-in-code-execute-test.yml +86 -0
- package/rules/ast-grep-rules/rule-tests/unchecked-numeric-parse-python-test.yml +15 -0
- package/rules/ast-grep-rules/rules/no-return-value-in-generator.yml +9 -4
- package/rules/ast-grep-rules/rules/no-sql-in-code-execute-js.yml +119 -0
- package/rules/ast-grep-rules/rules/no-sql-in-code-execute.yml +119 -0
- package/rules/ast-grep-rules/rules/unchecked-numeric-parse-python.yml +13 -2
- package/rules/rule-catalog.json +25 -1
- package/scripts/analyze-pi-lens-logs.mjs +15 -5
- package/scripts/lib/is-main-module.mjs +27 -0
- package/scripts/lib/scratch-home-env.mjs +21 -0
- package/scripts/rpc-load-check.mjs +4 -6
- package/scripts/warm-loader-cache.mjs +2 -5
- package/dist/chunk-3PTHXJXR.js +0 -28
- package/dist/chunk-3QED2P4V.js +0 -31
- package/dist/chunk-5WRPDP2A.js +0 -47
- package/dist/chunk-ABBOA7UD.js +0 -157
- package/dist/chunk-CUHSHSB6.js +0 -273
- package/dist/chunk-GL5LUMZE.js +0 -51
- package/dist/chunk-HAD7QRQI.js +0 -30
- package/dist/chunk-JORED7EX.js +0 -44
- package/dist/chunk-KYUB6QDC.js +0 -72
- package/dist/chunk-LZSEQW6A.js +0 -57
- package/dist/chunk-M2IFVFWU.js +0 -79
- package/dist/chunk-M2UD3LPU.js +0 -88
- package/dist/chunk-MBKQHGA7.js +0 -39
- package/dist/chunk-R7YOCSNV.js +0 -23
- package/dist/chunk-SKAMFC7A.js +0 -28
- package/dist/chunk-SYE6T2EB.js +0 -28
- package/dist/chunk-TRETHTQO.js +0 -26
- package/dist/chunk-UA7ZXYDR.js +0 -184
- package/dist/chunk-XTFDJI3T.js +0 -24
- 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 `##
|
|
25
|
-
change outline is the changed symbol's caller/callee tree with
|
|
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
|
-
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
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 |
|
package/docs/pi-lens-monitor.md
CHANGED
|
@@ -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
|
-
|
|
44
|
-
|
|
45
|
-
|
|
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**:
|
|
55
|
-
|
|
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), `
|
|
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
|
-
-
|
|
157
|
-
|
|
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
|
|
package/docs/pi-lens-retro.md
CHANGED
|
@@ -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,
|
|
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
|
|
package/docs/pi-lens-reviewer.md
CHANGED
|
@@ -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
|
package/docs/pi-lens-subagent.md
CHANGED
|
@@ -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.
|
|
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.
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
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.
|
|
165
|
-
|
|
166
|
-
|
|
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-
|
|
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 | ✓ | · |
|
|
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,
|
|
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 |
|
|
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
|
|
103
|
-
advertised tool list never changes. The
|
|
104
|
-
|
|
105
|
-
|
|
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
|
package/docs/subagent-compat.md
CHANGED
|
@@ -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
|
|
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.
|
|
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.
|
|
130
|
-
"@ast-grep/napi": "^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.
|
|
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,
|