pi-lens 4.4.0 → 4.4.2

package/docs/schema/pi-lens-config-v1.json

@@ -0,0 +1,565 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/apmantza/pi-lens/master/docs/schema/pi-lens-config-v1.json",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "lens": {
+      "x-stability": "stable"
+    },
+    "lsp": {
+      "type": "object",
+      "additionalProperties": true,
+      "x-stability": "stable",
+      "properties": {
+        "enabled": {
+          "x-stability": "stable"
+        },
+        "servers": {
+          "type": "object",
+          "x-stability": "experimental",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": true,
+            "x-stability": "experimental",
+            "properties": {
+              "covers": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "x-stability": "experimental"
+                },
+                "x-merge-strategy": "replace",
+                "x-stability": "experimental"
+              },
+              "name": {
+                "type": "string",
+                "x-stability": "experimental"
+              },
+              "enabled": {
+                "type": "boolean",
+                "x-stability": "experimental"
+              },
+              "role": {
+                "type": "string",
+                "enum": [
+                  "language",
+                  "auxiliary"
+                ],
+                "x-stability": "experimental"
+              },
+              "command": {
+                "x-stability": "experimental"
+              },
+              "args": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "x-stability": "experimental"
+                },
+                "x-stability": "experimental"
+              },
+              "extensions": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "x-stability": "experimental"
+                },
+                "x-stability": "experimental"
+              },
+              "rootMarkers": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "x-stability": "experimental"
+                },
+                "x-stability": "experimental"
+              },
+              "env": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string",
+                  "x-stability": "experimental"
+                },
+                "x-stability": "experimental"
+              },
+              "initializationOptions": {
+                "type": "object",
+                "additionalProperties": true,
+                "x-stability": "experimental"
+              }
+            }
+          }
+        },
+        "serverOverrides": {
+          "type": "object",
+          "x-stability": "experimental",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": true,
+            "x-stability": "experimental",
+            "properties": {
+              "command": { "x-stability": "experimental" },
+              "env": {
+                "type": "object",
+                "additionalProperties": { "type": "string", "x-stability": "experimental" },
+                "x-stability": "experimental"
+              },
+              "initializationOptions": {
+                "type": "object",
+                "additionalProperties": true,
+                "x-stability": "experimental"
+              }
+            }
+          }
+        },
+        "disabledServers": {
+          "type": "array",
+          "x-stability": "experimental",
+          "x-deny": "array-union"
+        },
+        "warmFiles": {
+          "type": "array",
+          "x-stability": "experimental"
+        }
+      }
+    },
+    "format": {
+      "x-stability": "stable"
+    },
+    "autofix": {
+      "x-stability": "stable"
+    },
+    "tests": {
+      "x-stability": "stable"
+    },
+    "delta": {
+      "x-stability": "stable"
+    },
+    "guard": {
+      "x-stability": "stable"
+    },
+    "opengrep": {
+      "x-stability": "stable"
+    },
+    "readGuard": {
+      "x-stability": "stable"
+    },
+    "contextInjection": {
+      "x-stability": "stable"
+    },
+    "turnSummary": {
+      "x-stability": "stable"
+    },
+    "actionableWarnings": {
+      "x-stability": "stable"
+    },
+    "ui": {
+      "x-stability": "stable"
+    },
+    "tools": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "ast_grep_search": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "ast_grep_replace": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "ast_grep_outline": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "lsp_navigation": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "lens_diagnostics": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "lens_diagnostic_mark": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "symbol_search": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "module_report": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "project_report": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "read_symbol": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "read_enclosing": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "effective_config": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "pi_lens_activate_tools": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "analyze": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "health": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "latency": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "project_scan": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "rebuild": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "session_start": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "turn_end": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        },
+        "session_end": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        }
+      },
+      "x-stability": "stable"
+    },
+    "turnEnd": {
+      "x-stability": "stable"
+    },
+    "knip": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "x-stability": "experimental"
+        }
+      },
+      "x-stability": "stable"
+    },
+    "jscpd": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "x-stability": "experimental"
+        }
+      },
+      "x-stability": "stable"
+    },
+    "madge": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "x-stability": "experimental"
+        }
+      },
+      "x-stability": "stable"
+    },
+    "gitleaks": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "x-stability": "experimental"
+        }
+      },
+      "x-stability": "stable"
+    },
+    "govulncheck": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "x-stability": "experimental"
+        }
+      },
+      "x-stability": "stable"
+    },
+    "deadCode": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "x-stability": "experimental"
+        }
+      },
+      "x-stability": "stable"
+    },
+    "complexity": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "x-stability": "experimental"
+        }
+      },
+      "x-stability": "stable"
+    },
+    "ignore": {
+      "x-stability": "stable"
+    },
+    "dispatch": {
+      "x-stability": "stable"
+    },
+    "widget": {
+      "x-stability": "stable"
+    },
+    "startup": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": [
+            "quick",
+            "full",
+            "minimal"
+          ],
+          "x-stability": "experimental"
+        },
+        "scans": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "x-stability": "experimental"
+            }
+          },
+          "x-stability": "experimental"
+        }
+      },
+      "x-stability": "stable"
+    },
+    "$schema": {
+      "type": "string",
+      "description": "Identity anchor naming the schema version this config was written against.",
+      "x-stability": "stable"
+    },
+    "rules": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "threshold": { "type": "number", "x-stability": "experimental" },
+          "disable": { "x-stability": "experimental" },
+          "select": { "x-stability": "experimental" },
+          "ignorePaths": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1, "x-stability": "experimental" },
+            "x-merge-strategy": "append",
+            "x-deny": "array-union",
+            "x-stability": "experimental"
+          }
+        },
+        "x-stability": "experimental"
+      },
+      "x-stability": "experimental"
+    },
+    "maxProjectFiles": {
+      "x-stability": "stable"
+    },
+    "reviewGraph": {
+      "x-stability": "stable"
+    },
+    "trivy": {
+      "x-stability": "stable"
+    },
+    "helm": {
+      "x-stability": "stable"
+    },
+    "servers": {
+      "x-stability": "experimental"
+    },
+    "serverOverrides": {
+      "x-stability": "experimental"
+    },
+    "disabledServers": {
+      "x-stability": "experimental"
+    },
+    "warmFiles": {
+      "x-stability": "experimental"
+    }
+  }
+}

package/docs/servercapabilities.md

@@ -6,7 +6,7 @@ server's `initialize` handshake. Generated by `node scripts/server-capabilities.
 absent on the generating host are listed under *Unavailable* — run in a
 provisioned environment (the nightly) to capture those rows.
 
-_Last generated: 2026-10-07 on linux; 40 servers captured, 8 unavailable._
+_Last generated: 2026-10-10 on linux; 29 servers captured, 19 unavailable._
 
 ## Diagnostic mode + navigation/edit operations
 
@@ -25,6 +25,7 @@ Legend: ✓ advertised, · not. **mode** = document diagnostics (`pull` = `textD
 | dart | push-only | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 18 |
 | deno | pull | · | save | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | 2 |
 | docker | push-only | · | · | ✓ | · | · | · | ✓ | ✓ | ✓ | · | · | ✓ | · | · | 0 |
+| docker-official | push-only | · | · | ✓ | · | · | · | ✓ | · | ✓ | · | ✓ | ✓ | · | · | 1 |
 | emmylua | pull | · | · | ✓ | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | · | · | · | 4 |
 | expert | push-only | · | save | ✓ | · | · | ✓ | ✓ | · | ✓ | ✓ | ✓ | · | · | · | 2 |
 | fish | push-only | · | save+text | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · | 23 |
@@ -57,9 +58,6 @@ Legend: ✓ advertised, · not. **mode** = document diagnostics (`pull` = `textD
 
 ## Raw advertised capability keys
 
-Top-level keys of each server's `ServerCapabilities` — the full advertised
-surface, including providers pi-lens does not yet consume.
-
 - **ast-grep**: codeActionProvider, executeCommandProvider, hoverProvider, textDocumentSync
 - **bash**: codeActionProvider, completionProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentSymbolProvider, hoverProvider, referencesProvider, renameProvider, textDocumentSync, workspaceSymbolProvider
 - **clojure**: callHierarchyProvider, codeActionProvider, codeLensProvider, completionProvider, declarationProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentRangeFormattingProvider, documentSymbolProvider, executeCommandProvider, experimental, foldingRangeProvider, hoverProvider, implementationProvider, linkedEditingRangeProvider, referencesProvider, renameProvider, selectionRangeProvider, semanticTokensProvider, signatureHelpProvider, textDocumentSync, workspace, workspaceSymbolProvider
@@ -71,6 +69,7 @@ surface, including providers pi-lens does not yet consume.
 - **dart**: callHierarchyProvider, codeActionProvider, codeLensProvider, colorProvider, completionProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentLinkProvider, documentOnTypeFormattingProvider, documentRangeFormattingProvider, documentSymbolProvider, executeCommandProvider, experimental, foldingRangeProvider, hoverProvider, implementationProvider, inlayHintProvider, inlineValueProvider, referencesProvider, renameProvider, selectionRangeProvider, semanticTokensProvider, signatureHelpProvider, textDocumentSync, typeDefinitionProvider, typeHierarchyProvider, workspace, workspaceSymbolProvider
 - **deno**: callHierarchyProvider, codeActionProvider, codeLensProvider, completionProvider, definitionProvider, diagnosticProvider, documentFormattingProvider, documentHighlightProvider, documentSymbolProvider, executeCommandProvider, experimental, foldingRangeProvider, hoverProvider, implementationProvider, inlayHintProvider, notebookDocumentSync, referencesProvider, renameProvider, selectionRangeProvider, semanticTokensProvider, signatureHelpProvider, textDocumentSync, typeDefinitionProvider, workspace, workspaceSymbolProvider
 - **docker**: codeActionProvider, completionProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentLinkProvider, documentOnTypeFormattingProvider, documentRangeFormattingProvider, documentSymbolProvider, foldingRangeProvider, hoverProvider, renameProvider, signatureHelpProvider, textDocumentSync
+- **docker-official**: codeActionProvider, completionProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentLinkProvider, documentSymbolProvider, executeCommandProvider, hoverProvider, inlayHintProvider, inlineCompletionProvider, renameProvider, semanticTokensProvider, textDocumentSync
 - **emmylua**: codeActionProvider, definitionProvider, diagnosticProvider, documentSymbolProvider, executeCommandProvider, hoverProvider, referencesProvider, textDocumentSync, workspaceSymbolProvider
 - **expert**: codeActionProvider, codeLensProvider, completionProvider, definitionProvider, documentFormattingProvider, documentSymbolProvider, executeCommandProvider, experimental, hoverProvider, referencesProvider, textDocumentSync, workspace, workspaceSymbolProvider
 - **fish**: codeActionProvider, completionProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentOnTypeFormattingProvider, documentRangeFormattingProvider, documentSymbolProvider, executeCommandProvider, foldingRangeProvider, hoverProvider, implementationProvider, inlayHintProvider, referencesProvider, renameProvider, selectionRangeProvider, semanticTokensProvider, signatureHelpProvider, textDocumentSync, workspace, workspaceSymbolProvider
@@ -100,6 +99,9 @@ surface, including providers pi-lens does not yet consume.
 - **yaml**: codeActionProvider, codeLensProvider, completionProvider, definitionProvider, documentFormattingProvider, documentLinkProvider, documentOnTypeFormattingProvider, documentRangeFormattingProvider, documentSymbolProvider, executeCommandProvider, foldingRangeProvider, hoverProvider, renameProvider, selectionRangeProvider, textDocumentSync, workspace
 - **zig**: codeActionProvider, colorProvider, completionProvider, declarationProvider, definitionProvider, documentFormattingProvider, documentHighlightProvider, documentRangeFormattingProvider, documentSymbolProvider, foldingRangeProvider, hoverProvider, implementationProvider, inlayHintProvider, positionEncoding, referencesProvider, renameProvider, selectionRangeProvider, semanticTokensProvider, signatureHelpProvider, textDocumentSync, typeDefinitionProvider, workspace, workspaceSymbolProvider
 - **zizmor**: textDocumentSync
+Top-level keys of each server's `ServerCapabilities` — the full advertised
+surface, including providers pi-lens does not yet consume.
+
 
 ## Advertised executeCommand allowlists
 
@@ -109,6 +111,7 @@ surface, including providers pi-lens does not yet consume.
 - **cue** (1): cuelsp.externalvalidate
 - **dart** (18): dart.edit.codeAction.apply, dart.edit.fixAll, dart.edit.fixAllInWorkspace, dart.edit.fixAllInWorkspace.preview, dart.edit.organizeImports, dart.edit.sendWorkspaceEdit, dart.edit.sortMembers, dart.logAction, dart.refactor.add_constructor_name, dart.refactor.convert_all_formal_parameters_to_named, dart.refactor.convert_selected_formal_parameters_to_named, dart.refactor.move_selected_formal_parameters_left, dart.refactor.move_top_level_to_file, dart.refactor.remove_constructor_name, dart.refactor.remove_import_prefix, dart.refactor_add.import_prefix, refactor.perform, refactor.validate
 - **deno** (2): deno.cache, deno.reloadImportRegistries
+- **docker-official** (1): dockerLspServer.telemetry.callback
 - **emmylua** (4): fake.applyEdit, fake.applyEditDeferred, fake.doThing, fake.releaseDeferredApplyEdit
 - **expert** (2): Reindex, connectionDetails
 - **fish** (23): fish-lsp.checkHealth, fish-lsp.createTheme, fish-lsp.execute, fish-lsp.executeBuffer, fish-lsp.executeLine, fish-lsp.executeRange, fish-lsp.fixAll, fish-lsp.generateEnvVariables, fish-lsp.selectQuickFixPosition, fish-lsp.showEnvVariables, fish-lsp.showInfo, fish-lsp.showReferences, fish-lsp.showStatusDocs, fish-lsp.showWorkspaceMessage, fish-lsp.toggleSingleWorkspaceSupport, fish-lsp.updateWorkspace, quickfix.delete, quickfix.disable, quickfix.fix, quickfix.fixAll, refactor.extract, refactor.rewrite, source.rename
@@ -127,11 +130,22 @@ surface, including providers pi-lens does not yet consume.
 Toolchain/binary not installed here, so capabilities weren't captured
 (many are the toolchain-gated family tracked in #241):
 
+- @prisma/language-server
+- @vue/language-server
+- bash-language-server
 - elixir-ls
+- fake custom lua server
+- fish-lsp
 - haskell-language-server
+- intelephense
 - jdtls
 - jdtls + lombok javaagent
 - nixd
 - ocamllsp
+- pyright
 - shuck
 - sourcekit-lsp
+- svelte-language-server
+- vscode-css-language-server
+- vscode-html-language-server
+- yaml-language-server

package/docs/settings.md

@@ -145,8 +145,9 @@ field docs.
 | `actionableWarnings.autoFix.maxFixes` | global | `5` | Cap on quickfixes applied per turn (`0` = report only) |
 | `rules.high-complexity.threshold` | project | `15` | Cyclomatic-complexity threshold |
 | `rules.high-fan-out.threshold` | project | `20` | Distinct-function-call threshold |
-| `rules.<id>.disable` | project | absent | Disable diagnostics for a rule (output-only filter, project-wide; same normalization as `pi-lens-ignore`) |
+| `rules.<id>.disable` | global + project | absent | Disable diagnostics for a rule (output-only filter, project-wide; same normalization as `pi-lens-ignore`) |
 | `rules.<id>.select` | project | absent | Allowlist of rule ids (output-only filter, project-wide across every key; disable wins over select) |
+| `rules.<id>.ignorePaths` | global + project | `[]` | Experimental rule-scoped globs relative to the project root; matching files skip that rule's scan and output. Entries are monotonic across tiers. |
 | `maxProjectFiles` | project | `2000` | Base scale knob; derives five subsystem size budgets |
 | `reviewGraph.maxFiles` | project | derived (clamped `100`–`20000`) | Explicit review-graph file budget |
 | `trivy.enabled` / `trivy.minSeverity` | project | off | Opt-in Trivy vulnerability scanning |

package/docs/word-index.md

@@ -121,6 +121,12 @@ rebuild:
   via `PI_LENS_WORD_INDEX_PERSIST_DEBOUNCE_MS`), reusing the same
   `createDebounceScheduler` primitive the review graph's persist path uses
   (`scheduleWordIndexPersist`, `clients/word-index.ts`).
+- The serialized form (`serializeWordIndex`'s memo) doubles as the incremental
+  cache: it is kept while a run edits, so each persist re-flattens only the
+  edited files' tokens, and released once per run at `agent_settled` for the
+  session that settled (`releaseWordIndexMemoAtSettle`), plus a stalled-run
+  backstop (`PI_LENS_WORD_INDEX_MEMO_BACKSTOP_MS`, default 10 minutes). The
+  first persist after a release is a full re-serialize.
 
 ## Surfaces
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-lens",
-	"version": "4.4.0",
+	"version": "4.4.2",
 	"type": "module",
 	"description": "Real-time code feedback for pi — LSP, linters, formatters, type-checking, structural analysis & booboo",
 	"repository": {