pi-lens 3.0.0 → 3.0.1

package/README.md

@@ -1,18 +1,20 @@
 # pi-lens
 
-Real-time code feedback for [pi](https://github.com/mariozechner/pi-coding-agent) — LSP, linters, formatters, type-checking, structural analysis (ast-grep), TODO scanner, dead code detection, duplicate detection, type coverage, complexity metrics, and AI slop detection.
+**pi extension for real-time code quality.** 31 LSP servers, tree-sitter structural analysis, AST pattern matching, auto-install for TypeScript/Python tooling, duplicate detection, complexity metrics, and inline blockers with comprehensive `/lens-booboo` reports.
 
 ## What pi-lens Does
 
 **For every file you edit:**
 1. **Auto-formats** — Detects and runs formatters (Biome, Prettier, Ruff, gofmt, rustfmt, etc.)
-2. **Type-checks** TypeScript, Python, Go, Rust (and 27 more languages with `--lens-lsp`)
-3. **Scans for secrets** — blocks on hardcoded API keys, tokens, passwords
+2. **Type-checks** — TypeScript, Python, Go, Rust (31 languages with `--lens-lsp`)
+3. **Scans for secrets** — Blocks on hardcoded API keys, tokens, passwords
 4. **Runs linters** — Biome (TS/JS), Ruff (Python), plus structural analysis
-5. **Detects code smells** — empty catch blocks, debuggers, nested ternaries, etc.
-6. **Only shows NEW issues** — delta-mode tracks baselines and filters pre-existing problems (reduces noise)
+5. **Tree-sitter analysis** — Deep structural patterns (empty catch, eval, deep nesting, mixed async styles)
+6. **Auto-installs** — TypeScript, Python, Biome, Ruff tools install automatically on first use
+7. **Only shows NEW issues** — Delta-mode tracks baselines and filters pre-existing problems
 
-**Blocking issues** (type errors, secrets) appear inline and stop the agent until fixed. **Warnings** are tracked but hidden inline — run `/lens-booboo` to see them all.
+**🔴 Blockers** (type errors, secrets, empty catches) appear inline and stop the agent until fixed.  
+**🟡 Warnings** (complexity, code smells) go to `/lens-booboo` — run it to see them all.
 
 ## Quick Start
 

package/clients/complexity-client.js

@@ -234,9 +234,11 @@ export class ComplexityClient {
         if (metrics.maxNestingDepth > 4) {
             parts.push(`  Max nesting: ${metrics.maxNestingDepth} levels (consider extracting)`);
         }
-        // Code entropy (in bits, >3.5 = risky AI-induced complexity)
-        if (metrics.codeEntropy > 3.5) {
-            parts.push(`  Entropy: ${metrics.codeEntropy.toFixed(1)} bits (>3.5 — risky AI-induced complexity)`);
+        // Code entropy (in bits, >5.5 = risky AI-induced complexity)
+        // Threshold increased from 3.5 to 5.5 to reduce false positives in tooling codebases
+        // where diverse method/variable names are naturally expected
+        if (metrics.codeEntropy > 5.5) {
+            parts.push(`  Entropy: ${metrics.codeEntropy.toFixed(1)} bits (>5.5 — risky AI-induced complexity)`);
         }
         // Function length
         if (metrics.maxFunctionLength > 50) {
@@ -336,8 +338,8 @@ export class ComplexityClient {
         if (metrics.maxNestingDepth > 6) {
             warnings.push(`Deep nesting (${metrics.maxNestingDepth} levels) — extract nested logic into separate functions`);
         }
-        // Entropy > 5.0 is high (was > 3.5, too sensitive)
-        if (metrics.codeEntropy > 5.0) {
+        // Entropy > 5.5 is high (was > 3.5 → 5.0, still too sensitive for tooling codebases)
+        if (metrics.codeEntropy > 5.5) {
             warnings.push(`High entropy (${metrics.codeEntropy.toFixed(1)} bits) — follow project conventions`);
         }
         // Comments ratio (>60% = excessive, was > 40%)
@@ -576,7 +578,8 @@ export class ComplexityClient {
     /**
      * Calculate Shannon entropy of code tokens (in bits)
      * Uses log2 for entropy measured in bits
-     * Threshold: >3.5 bits indicates risky AI-induced complexity
+     * Threshold: >5.5 bits indicates risky AI-induced complexity
+     * (Increased from 3.5 to reduce false positives in tooling codebases)
      */
     calculateCodeEntropy(sourceText) {
         // Tokenize by splitting on whitespace and common delimiters

package/clients/complexity-client.ts

@@ -331,10 +331,12 @@ export class ComplexityClient {
 			);
 		}
 
-		// Code entropy (in bits, >3.5 = risky AI-induced complexity)
-		if (metrics.codeEntropy > 3.5) {
+		// Code entropy (in bits, >5.5 = risky AI-induced complexity)
+		// Threshold increased from 3.5 to 5.5 to reduce false positives in tooling codebases
+		// where diverse method/variable names are naturally expected
+		if (metrics.codeEntropy > 5.5) {
 			parts.push(
-				`  Entropy: ${metrics.codeEntropy.toFixed(1)} bits (>3.5 — risky AI-induced complexity)`,
+				`  Entropy: ${metrics.codeEntropy.toFixed(1)} bits (>5.5 — risky AI-induced complexity)`,
 			);
 		}
 
@@ -480,8 +482,8 @@ export class ComplexityClient {
 			);
 		}
 
-		// Entropy > 5.0 is high (was > 3.5, too sensitive)
-		if (metrics.codeEntropy > 5.0) {
+		// Entropy > 5.5 is high (was > 3.5 → 5.0, still too sensitive for tooling codebases)
+		if (metrics.codeEntropy > 5.5) {
 			warnings.push(
 				`High entropy (${metrics.codeEntropy.toFixed(1)} bits) — follow project conventions`,
 			);
@@ -807,7 +809,8 @@ export class ComplexityClient {
 	/**
 	 * Calculate Shannon entropy of code tokens (in bits)
 	 * Uses log2 for entropy measured in bits
-	 * Threshold: >3.5 bits indicates risky AI-induced complexity
+	 * Threshold: >5.5 bits indicates risky AI-induced complexity
+	 * (Increased from 3.5 to reduce false positives in tooling codebases)
 	 */
 	private calculateCodeEntropy(sourceText: string): number {
 		// Tokenize by splitting on whitespace and common delimiters

package/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "pi-lens",
-	"version": "3.0.0",
+	"version": "3.0.1",
 	"type": "module",
-	"description": "Real-time code feedback for pi — LSP, linters, formatters, type-checking, structural analysis (ast-grep), TODO scanner, dead code detection, duplicate detection, type coverage, complexity metrics, and AI slop detection",
+	"description": "pi extension for real-time code quality — 31 LSP servers, tree-sitter structural analysis, AST pattern matching, auto-install for TypeScript/Python tooling, duplicate detection, complexity metrics, and inline blockers with comprehensive /lens-booboo reports",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/apmantza/pi-lens.git"