pi-lens 1.3.8 → 1.3.10

package/clients/complexity-client.ts

@@ -212,7 +212,7 @@ export class ComplexityClient {
         maintainabilityIndex: Math.round(maintainabilityIndex * 10) / 10,
         linesOfCode: codeLines,
         commentLines,
-        codeEntropy: Math.round(codeEntropy * 1000) / 1000,
+        codeEntropy: Math.round(codeEntropy * 100) / 100,
       };
     } catch (err: any) {
       this.log(`Analysis error for ${filePath}: ${err.message}`);
@@ -247,11 +247,9 @@ export class ComplexityClient {
       parts.push(`  Max nesting: ${metrics.maxNestingDepth} levels (consider extracting)`);
     }
 
-    // Code entropy (0-1, lower = more predictable)
-    if (metrics.codeEntropy > 0.8) {
-      parts.push(`  Entropy: ${metrics.codeEntropy} (high — code may be unpredictable/AI-generated)`);
-    } else if (metrics.codeEntropy < 0.3) {
-      parts.push(`  Entropy: ${metrics.codeEntropy} (low — repetitive patterns detected)`);
+    // 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)`);
     }
 
     // Function length
@@ -267,6 +265,35 @@ export class ComplexityClient {
     return parts.length > 0 ? `[Complexity] ${metrics.filePath}\n${parts.join("\n")}` : "";
   }
 
+  /**
+   * Check thresholds and return actionable warnings
+   */
+  checkThresholds(metrics: FileComplexity): string[] {
+    const warnings: string[] = [];
+
+    if (metrics.maintainabilityIndex < 60) {
+      warnings.push(`Maintainability dropped to ${metrics.maintainabilityIndex} — extract logic into helper functions`);
+    }
+
+    if (metrics.cyclomaticComplexity > 10) {
+      warnings.push(`High complexity (${metrics.cyclomaticComplexity}) — use early returns or switch expressions`);
+    }
+
+    if (metrics.cognitiveComplexity > 15) {
+      warnings.push(`Cognitive complexity (${metrics.cognitiveComplexity}) — simplify logic flow`);
+    }
+
+    if (metrics.maxNestingDepth > 4) {
+      warnings.push(`Deep nesting (${metrics.maxNestingDepth} levels) — extract nested logic into separate functions`);
+    }
+
+    if (metrics.codeEntropy > 3.5) {
+      warnings.push(`High entropy (${metrics.codeEntropy.toFixed(1)} bits) — follow project conventions`);
+    }
+
+    return warnings;
+  }
+
   /**
    * Format delta for session summary
    */
@@ -504,9 +531,9 @@ export class ComplexityClient {
   }
 
   /**
-   * Calculate Shannon entropy of code tokens
-   * Measures predictability/uniformity of code
-   * 0 = completely uniform, 1 = maximum entropy
+   * Calculate Shannon entropy of code tokens (in bits)
+   * Uses log2 for entropy measured in bits
+   * Threshold: >3.5 bits indicates risky AI-induced complexity
    */
   private calculateCodeEntropy(sourceText: string): number {
     // Tokenize by splitting on whitespace and common delimiters
@@ -526,7 +553,7 @@ export class ComplexityClient {
       freq.set(token, (freq.get(token) || 0) + 1);
     }
 
-    // Calculate Shannon entropy: H = -sum(p * log2(p))
+    // Calculate Shannon entropy in bits: H = -sum(p * log2(p))
     let entropy = 0;
     for (const count of freq.values()) {
       const p = count / tokens.length;
@@ -535,11 +562,7 @@ export class ComplexityClient {
       }
     }
 
-    // Normalize to 0-1 range
-    const maxEntropy = Math.log2(freq.size);
-    if (maxEntropy === 0) return 0;
-
-    return Math.min(1, entropy / maxEntropy);
+    return entropy; // Return in bits, not normalized
   }
 
   private isKeyword(text: string): boolean {

package/index.ts

@@ -829,6 +829,21 @@ export default function (pi: ExtensionAPI) {
 			}
 		}
 
+		// Complexity threshold warnings (actionable)
+		if (complexityClient.isSupportedFile(filePath)) {
+			const metrics = complexityClient.analyzeFile(filePath);
+			if (metrics) {
+				const warnings = complexityClient.checkThresholds(metrics);
+				if (warnings.length > 0) {
+					let warningReport = `[Complexity Warnings]\n`;
+					for (const w of warnings) {
+						warningReport += `  ⚠ ${w}\n`;
+					}
+					lspOutput += `\n\n${warningReport}`;
+				}
+			}
+		}
+
 		// Test runner — run tests for the edited file
 		if (!pi.getFlag("no-tests")) {
 			const cwd = process.cwd();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-lens",
-	"version": "1.3.8",
+	"version": "1.3.10",
 	"description": "Real-time code feedback for pi — TypeScript LSP, Biome, ast-grep, Ruff, TODO scanner, dead code, duplicate detection, type coverage",
 	"repository": {
 		"type": "git",