pi-lens 3.8.23 → 3.8.25

package/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to pi-lens will be documented in this file.
 
 ## [Unreleased]
 
+## [3.8.25] - 2026-04-13
+
+### Changed
+- **Go LSP PATH augmentation on Windows** — LSP subprocess PATH now includes common Go install directories (`C:\Program Files\Go\bin`, `C:\Go\bin`) to prevent `gopls` startup/runtime failures when `go` is not in inherited shell PATH.
+- **Similarity runner cold-start behavior** — similarity now skips fast when no cached project index exists and for tiny/trivial files, reducing write/edit pipeline tail latency and eliminating frequent 30s timeout noise in scratch-file workflows.
+
+### Fixed
+- **Non-git workspace commit lookup noise** — metrics snapshot commit detection now pre-checks repository context before invoking Git, preventing `fatal: not a git repository` terminal noise in non-repo folders.
+
+## [3.8.24] - 2026-04-12
+
+### Changed
+- **Lazy bootstrap client loading** — startup now defers heavy client initialization behind a shared bootstrap promise, reducing first-turn startup overhead while preserving tool behavior.
+- **LSP config discovery scope** — `.pi-lens/lsp.json` (and related config paths) are now resolved from the current directory up through parent directories, improving nested-workspace support.
+- **Ruby server fallback chain** — Ruby LSP startup now tries `ruby-lsp`, then `solargraph`, then `rubocop --lsp` for broader environment compatibility.
+
+### Fixed
+- **LSP config activation timing** — LSP server config initialization now runs reliably at `session_start` and before LSP-backed `tool_call` operations, so server enable/disable overrides apply in one-shot and interactive sessions.
+
 ## [3.8.23] - 2026-04-12
 
 ### Added

package/clients/bootstrap.ts

@@ -0,0 +1,106 @@
+import type { AgentBehaviorClient } from "./agent-behavior-client.js";
+import type { ArchitectClient } from "./architect-client.js";
+import type { BiomeClient } from "./biome-client.js";
+import type { ComplexityClient } from "./complexity-client.js";
+import type { DependencyChecker } from "./dependency-checker.js";
+import type { GoClient } from "./go-client.js";
+import type { JscpdClient } from "./jscpd-client.js";
+import type { KnipClient } from "./knip-client.js";
+import type { MetricsClient } from "./metrics-client.js";
+import type { RuffClient } from "./ruff-client.js";
+import type { RustClient } from "./rust-client.js";
+import type { TestRunnerClient } from "./test-runner-client.js";
+import type { TodoScanner } from "./todo-scanner.js";
+import type { TypeCoverageClient } from "./type-coverage-client.js";
+
+export interface BootstrapClients {
+	ruffClient: RuffClient;
+	biomeClient: BiomeClient;
+	knipClient: KnipClient;
+	todoScanner: TodoScanner;
+	jscpdClient: JscpdClient;
+	typeCoverageClient: TypeCoverageClient;
+	depChecker: DependencyChecker;
+	testRunnerClient: TestRunnerClient;
+	metricsClient: MetricsClient;
+	complexityClient: ComplexityClient;
+	architectClient: ArchitectClient;
+	goClient: GoClient;
+	rustClient: RustClient;
+	agentBehaviorClient: AgentBehaviorClient;
+}
+
+let bootstrapPromise: Promise<BootstrapClients> | null = null;
+
+function createArchitectFallback(): ArchitectClient {
+	return {
+		loadConfig: () => false,
+		isUserDefined: () => false,
+		hasConfig: () => false,
+		getRulesForFile: () => [],
+		checkFile: () => [],
+		checkFileSize: () => null,
+		getHints: () => [],
+	} as unknown as ArchitectClient;
+}
+
+export function loadBootstrapClients(): Promise<BootstrapClients> {
+	bootstrapPromise ??= (async () => {
+		const [
+			ruffMod,
+			biomeMod,
+			knipMod,
+			todoMod,
+			jscpdMod,
+			typeCoverageMod,
+			depCheckerMod,
+			testRunnerMod,
+			metricsMod,
+			complexityMod,
+			goMod,
+			rustMod,
+			agentBehaviorMod,
+		] = await Promise.all([
+			import("./ruff-client.js"),
+			import("./biome-client.js"),
+			import("./knip-client.js"),
+			import("./todo-scanner.js"),
+			import("./jscpd-client.js"),
+			import("./type-coverage-client.js"),
+			import("./dependency-checker.js"),
+			import("./test-runner-client.js"),
+			import("./metrics-client.js"),
+			import("./complexity-client.js"),
+			import("./go-client.js"),
+			import("./rust-client.js"),
+			import("./agent-behavior-client.js"),
+		]);
+
+		let architectClient: ArchitectClient;
+		try {
+			const architectMod = await import("./architect-client.js");
+			architectClient = new architectMod.ArchitectClient();
+		} catch {
+			architectClient = createArchitectFallback();
+		}
+
+		return {
+			ruffClient: new ruffMod.RuffClient(),
+			biomeClient: new biomeMod.BiomeClient(),
+			knipClient: new knipMod.KnipClient(),
+			todoScanner: new todoMod.TodoScanner(),
+			jscpdClient: new jscpdMod.JscpdClient(),
+			typeCoverageClient: new typeCoverageMod.TypeCoverageClient(),
+			depChecker: new depCheckerMod.DependencyChecker(),
+			testRunnerClient: new testRunnerMod.TestRunnerClient(),
+			metricsClient: new metricsMod.MetricsClient(),
+			complexityClient: new complexityMod.ComplexityClient(),
+			architectClient,
+			goClient: new goMod.GoClient(),
+			rustClient: new rustMod.RustClient(),
+			agentBehaviorClient: new agentBehaviorMod.AgentBehaviorClient(),
+		};
+	})();
+
+	return bootstrapPromise;
+}

package/clients/dispatch/runners/similarity.ts

@@ -9,8 +9,8 @@ import * as nodeFs from "node:fs";
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import * as ts from "typescript";
-import { EXCLUDED_DIRS } from "../../file-utils.js";
 import { NativeRustCoreClient } from "../../native-rust-client.js";
+import { collectSourceFiles } from "../../source-filter.js";
 import {
 	buildProjectIndex,
 	findSimilarFunctions,
@@ -40,6 +40,7 @@ const CONFIG = {
 	SIMILARITY_THRESHOLD: 0.96, // align with booboo: stricter to reduce boilerplate false positives
 	MIN_TRANSITIONS: 40, // stronger signal floor for structural comparisons
 	MIN_FUNCTION_LINES: 8, // Ignore tiny helpers/wrappers
+	MIN_FILE_CHARS: 140, // Skip tiny/trivial files early
 	MAX_TRANSITION_RATIO: 1.8, // Skip pairs with highly mismatched complexity/size
 	MAX_SUGGESTIONS: 3, // Max 3 suggestions per file
 	MAX_PER_TARGET_NAME: 1, // Avoid one-to-many spam for the same target utility
@@ -115,12 +116,26 @@ const similarityRunner: RunnerDefinition = {
 			return { status: "skipped", diagnostics: [], semantic: "none" };
 		}
 
+		const lineCount = content.split(/\r?\n/).length;
+		if (
+			content.trim().length < CONFIG.MIN_FILE_CHARS ||
+			lineCount < CONFIG.MIN_FUNCTION_LINES + 2 ||
+			!/(\bfunction\b|=>)/.test(content)
+		) {
+			return { status: "skipped", diagnostics: [], semantic: "none" };
+		}
+
 		// Find project root and load index
 		const projectRoot = await findProjectRoot(filePath);
 		if (!projectRoot) {
 			return { status: "skipped", diagnostics: [], semantic: "none" };
 		}
 
+		const cachedIndex = await loadCachedIndex(projectRoot);
+		if (!cachedIndex || cachedIndex.entries.size === 0) {
+			return { status: "skipped", diagnostics: [], semantic: "none" };
+		}
+
 		// ── Rust fast-path ─────────────────────────────────────────────────────
 		// Try Rust for file scanning + similarity detection. If the Rust binary
 		// is available, use it. On any failure, fall through to the pure-TS path.
@@ -139,10 +154,7 @@ const similarityRunner: RunnerDefinition = {
 		}
 		// ── TypeScript fallback ─────────────────────────────────────────────────
 
-		const index = await loadOrBuildIndex(projectRoot);
-		if (!index || index.entries.size === 0) {
-			return { status: "skipped", diagnostics: [], semantic: "none" };
-		}
+		const index = cachedIndex;
 
 		// Parse the file
 		const sourceFile = ts.createSourceFile(
@@ -512,30 +524,42 @@ async function loadOrBuildIndex(
 	}
 
 	// Build new index
-	const { glob } = await import("glob");
-	// Build ignore patterns from centralized EXCLUDED_DIRS
-	const ignorePatterns = [
-		...EXCLUDED_DIRS.map((d) => `**/${d}/**`),
-		"**/*.test.ts",
-		"**/*.spec.ts",
-		"**/*.poc.test.ts",
-	];
-	const files = await glob("**/*.ts", {
-		cwd: projectRoot,
-		ignore: ignorePatterns,
+	const absoluteFiles = collectSourceFiles(projectRoot, {
+		extensions: [".ts"],
+	}).filter((filePath) => {
+		const normalized = filePath.replace(/\\/g, "/");
+		return (
+			!normalized.endsWith(".test.ts") &&
+			!normalized.endsWith(".spec.ts") &&
+			!normalized.endsWith(".poc.test.ts")
+		);
 	});
 
-	if (files.length === 0) {
+	if (absoluteFiles.length === 0) {
 		return null;
 	}
 
-	const absoluteFiles = files.map((f) => path.join(projectRoot, f));
 	const index = await buildProjectIndex(projectRoot, absoluteFiles);
 
 	indexCache.set(projectRoot, index);
 	return index;
 }
 
+async function loadCachedIndex(projectRoot: string): Promise<ProjectIndex | null> {
+	const cached = indexCache.get(projectRoot);
+	if (cached) {
+		return cached;
+	}
+
+	const existing = await loadIndex(projectRoot);
+	if (!existing) {
+		return null;
+	}
+
+	indexCache.set(projectRoot, existing);
+	return existing;
+}
+
 // ============================================================================
 // Testing Helper
 // ============================================================================

package/clients/lsp/config.ts

@@ -55,17 +55,25 @@ const CONFIG_PATHS = [".pi-lens/lsp.json", ".pi-lens.json", "pi-lsp.json"];
  * Load LSP configuration from file
  */
 export async function loadLSPConfig(cwd: string): Promise<LSPConfig> {
-	for (const configPath of CONFIG_PATHS) {
-		const fullPath = path.join(cwd, configPath);
-		try {
-			const content = await fs.readFile(fullPath, "utf-8");
-			const config = JSON.parse(content) as LSPConfig;
-			console.error(`[lsp-config] Loaded config from ${configPath}`);
-			return config;
-		} catch {
-			// File doesn't exist or is invalid, try next
+	let dir = path.resolve(cwd);
+	while (true) {
+		for (const configPath of CONFIG_PATHS) {
+			const fullPath = path.join(dir, configPath);
+			try {
+				const content = await fs.readFile(fullPath, "utf-8");
+				const config = JSON.parse(content) as LSPConfig;
+				console.error(`[lsp-config] Loaded config from ${fullPath}`);
+				return config;
+			} catch {
+				// File doesn't exist or is invalid, try next
+			}
 		}
+
+		const parent = path.dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
 	}
+
 	return {};
 }
 

package/clients/lsp/launch.ts

@@ -35,6 +35,8 @@ function buildAugmentedPath(basePath?: string): string {
 		candidates.push(path.join(userProfile, ".cargo", "bin"));
 		candidates.push(path.join(userProfile, "go", "bin"));
 	}
+	candidates.push(path.join("C:\\", "Program Files", "Go", "bin"));
+	candidates.push(path.join("C:\\", "Go", "bin"));
 	candidates.push(path.join("C:\\", "Ruby34-x64", "bin"));
 	candidates.push(path.join("C:\\", "Ruby33-x64", "bin"));
 

package/clients/lsp/server.ts

@@ -740,7 +740,7 @@ export const RubyServer: LSPServerInfo = {
 	extensions: [".rb", ".rake", ".gemspec", ".ru"],
 	root: PriorityRoot([["Gemfile", ".ruby-version"], [".git"]]),
 	async spawn(root, options) {
-		// Try ruby-lsp first (prompts to install via gem if missing), fall back to solargraph
+		// Try ruby-lsp first, then solargraph, then rubocop --lsp
 		const proc = await spawnWithInteractiveInstall(
 			"ruby",
 			"ruby-lsp",
@@ -763,6 +763,14 @@ export const RubyServer: LSPServerInfo = {
 					}
 				}
 
+				for (const command of ["rubocop", ...rubyBinCandidates("rubocop")]) {
+					try {
+						return await launchLSP(command, ["--lsp"], { cwd: root });
+					} catch {
+						// try next rubocop candidate
+					}
+				}
+
 				throw new Error("ENOENT: command not found");
 			},
 		);

package/clients/metrics-history.ts

@@ -45,10 +45,30 @@ const MAX_HISTORY_PER_FILE = 20;
 
 // --- Git Helpers ---
 
+/**
+ * Check whether cwd is inside a Git worktree.
+ */
+function isInsideGitRepo(startDir: string): boolean {
+	let dir = path.resolve(startDir);
+	while (true) {
+		if (fs.existsSync(path.join(dir, ".git"))) {
+			return true;
+		}
+		const parent = path.dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return false;
+}
+
 /**
  * Get current git commit hash (short)
  */
 function getCurrentCommit(): string {
+	if (!isInsideGitRepo(process.cwd())) {
+		return "unknown";
+	}
+
 	try {
 		return execSync("git rev-parse --short HEAD", {
 			encoding: "utf-8",

package/clients/runtime-session.ts

@@ -10,13 +10,13 @@ import { getKnipIgnorePatterns } from "./file-utils.js";
 import type { GoClient } from "./go-client.js";
 import type { JscpdClient } from "./jscpd-client.js";
 import type { KnipClient } from "./knip-client.js";
+import { canRunStartupHeavyScans } from "./language-policy.js";
 import {
 	detectProjectLanguageProfile,
 	getDefaultStartupTools,
 	hasLanguage,
 	isLanguageConfigured,
 } from "./language-profile.js";
-import { canRunStartupHeavyScans } from "./language-policy.js";
 import type { MetricsClient } from "./metrics-client.js";
 import {
 	buildProjectIndex,
@@ -64,7 +64,10 @@ interface SessionStartDeps {
 
 type StartupMode = "full" | "minimal" | "quick";
 
-function isCommandAvailable(command: string, args: string[] = ["--version"]): boolean {
+function isCommandAvailable(
+	command: string,
+	args: string[] = ["--version"],
+): boolean {
 	const result = safeSpawn(command, args, { timeout: 5000 });
 	return !result.error && result.status === 0;
 }
@@ -97,7 +100,9 @@ function getLanguageInstallHints(
 	};
 
 	if (hasStrongSignal("go") && !isCommandAvailable("gopls")) {
-		hints.push("Go detected: install gopls (`go install golang.org/x/tools/gopls@latest`).");
+		hints.push(
+			"Go detected: install gopls (`go install golang.org/x/tools/gopls@latest`).",
+		);
 	}
 	if (hasStrongSignal("rust") && !isCommandAvailable("rust-analyzer")) {
 		hints.push(
@@ -174,6 +179,25 @@ export async function handleSessionStart(
 		delete process.env.PI_LENS_DISABLE_LSP_INSTALL;
 	}
 
+	const hasWorkspaceCwd = typeof ctxCwd === "string" && ctxCwd.length > 0;
+	const cwd = ctxCwd ?? process.cwd();
+	if (quickMode) {
+		runtime.projectRoot = cwd;
+		const quickTools: string[] = [];
+		if (getFlag("lens-lsp") && !getFlag("no-lsp")) {
+			quickTools.push("LSP Service");
+		}
+		log(`Active tools: ${quickTools.join(", ")}`);
+		dbg(
+			`session_start tools: ${quickTools.join(", ") || "deferred (quick mode)"}`,
+		);
+		dbg(
+			"session_start: quick mode active - skipping slow tool probes, language profiling, preinstall, scans, and error debt baseline",
+		);
+		dbg(`session_start total: ${Date.now() - sessionStartMs}ms`);
+		return;
+	}
+
 	const tools: string[] = [];
 	if (getFlag("lens-lsp") && !getFlag("no-lsp")) {
 		tools.push("LSP Service");
@@ -200,17 +224,6 @@ export async function handleSessionStart(
 		}
 	}
 
-	const hasWorkspaceCwd = typeof ctxCwd === "string" && ctxCwd.length > 0;
-	const cwd = ctxCwd ?? process.cwd();
-	if (quickMode) {
-		runtime.projectRoot = cwd;
-		dbg(
-			"session_start: quick mode active - skipping language profiling, preinstall, scans, and error debt baseline",
-		);
-		dbg(`session_start total: ${Date.now() - sessionStartMs}ms`);
-		return;
-	}
-
 	const startupScan = resolveStartupScanContext(cwd);
 	const scanRoot = startupScan.projectRoot ?? cwd;
 	const useScanRootForSignals =
@@ -236,18 +249,20 @@ export async function handleSessionStart(
 	}
 
 	const lensLspEnabled = !!getFlag("lens-lsp") && !getFlag("no-lsp");
-	const startupDefaults = getDefaultStartupTools(languageProfile).filter((tool) => {
-		if (
-			(tool === "typescript-language-server" || tool === "pyright") &&
-			!lensLspEnabled
-		) {
-			return false;
-		}
-		if (tool === "ruff" && getFlag("no-autofix-ruff")) {
-			return false;
-		}
-		return true;
-	});
+	const startupDefaults = getDefaultStartupTools(languageProfile).filter(
+		(tool) => {
+			if (
+				(tool === "typescript-language-server" || tool === "pyright") &&
+				!lensLspEnabled
+			) {
+				return false;
+			}
+			if (tool === "ruff" && getFlag("no-autofix-ruff")) {
+				return false;
+			}
+			return true;
+		},
+	);
 
 	if (!allowBootstrapTasks) {
 		dbg("session_start: skipping tool preinstall (startup mode)");
@@ -369,7 +384,9 @@ export async function handleSessionStart(
 		runtime.markStartupScanInFlight(name, sessionGeneration);
 		void task()
 			.then(() => {
-				dbg(`session_start task ${name}: success (${Date.now() - startedAt}ms)`);
+				dbg(
+					`session_start task ${name}: success (${Date.now() - startedAt}ms)`,
+				);
 			})
 			.catch((err) => {
 				dbg(`session_start: ${name} background scan failed: ${err}`);
@@ -391,7 +408,9 @@ export async function handleSessionStart(
 		dbg(
 			`session_start: skipping heavy scans (${startupScan.reason ?? "unknown"})`,
 		);
-		dbg(`session_start: skipping TODO scan (${startupScan.reason ?? "unknown"})`);
+		dbg(
+			`session_start: skipping TODO scan (${startupScan.reason ?? "unknown"})`,
+		);
 	} else {
 		const canRunJsTsHeavyScans = canRunStartupHeavyScans(
 			languageProfile,
@@ -401,9 +420,7 @@ export async function handleSessionStart(
 		if (canRunJsTsHeavyScans) {
 			scanNames.push("knip", "jscpd", "ast-grep exports", "project index");
 		}
-		dbg(
-			`session_start: launching background scans (${scanNames.join(", ")})`,
-		);
+		dbg(`session_start: launching background scans (${scanNames.join(", ")})`);
 
 		runStartupTask("todo", async () => {
 			if (!runtime.isCurrentSession(sessionGeneration)) return;
@@ -458,10 +475,9 @@ export async function handleSessionStart(
 			runStartupTask("jscpd", async () => {
 				if (await jscpdClient.ensureAvailable()) {
 					if (!runtime.isCurrentSession(sessionGeneration)) return;
-					const cached = cacheManager.readCache<ReturnType<JscpdClient["scan"]>>(
-						"jscpd",
-						analysisRoot,
-					);
+					const cached = cacheManager.readCache<
+						ReturnType<JscpdClient["scan"]>
+					>("jscpd", analysisRoot);
 					if (cached) {
 						if (!runtime.isCurrentSession(sessionGeneration)) return;
 						dbg("session_start jscpd: cache hit");
@@ -527,7 +543,9 @@ export async function handleSessionStart(
 						);
 					} else {
 						if (!runtime.isCurrentSession(sessionGeneration)) return;
-						dbg(`session_start: skipped project index (${tsFiles.length} files)`);
+						dbg(
+							`session_start: skipped project index (${tsFiles.length} files)`,
+						);
 					}
 				}
 			});

package/commands/booboo.ts

@@ -369,33 +369,13 @@ export async function handleBooboo(
 	// Runner 3: Semantic similarity
 	await tracker.run("semantic similarity (Amain)", async () => {
 		try {
-			const { glob } = await import("glob");
-			const sourceFiles = await glob("**/*.ts", {
-				cwd: targetPath,
-				ignore: [
-					"**/node_modules/**",
-					"**/*.test.ts",
-					"**/*.test.tsx",
-					"**/*.spec.ts",
-					"**/*.spec.tsx",
-					"**/*.poc.test.ts",
-					"**/*.poc.test.tsx",
-					"**/test-utils.ts",
-					"**/test-*.ts",
-					"**/__tests__/**",
-					"**/tests/**",
-					"**/dist/**",
-				],
-			});
+			const absoluteFiles = collectSourceFiles(targetPath, {
+				extensions: [".ts"],
+			}).filter(shouldIncludeFile);
 
-			if (sourceFiles.length === 0) {
+			if (absoluteFiles.length === 0) {
 				return { findings: 0, status: "done" };
 			}
-
-			// Filter out test files using centralized exclusion
-			const absoluteFiles = sourceFiles
-				.map((f) => path.join(targetPath, f))
-				.filter(shouldIncludeFile);
 			const index = await buildProjectIndex(targetPath, absoluteFiles);
 			const topPairs = findTopSimilarPairs(index, 10);
 

package/index.ts

@@ -4,31 +4,22 @@ import * as path from "node:path";
 import { fileURLToPath } from "node:url";
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { isToolCallEventType } from "@mariozechner/pi-coding-agent";
-import { AgentBehaviorClient } from "./clients/agent-behavior-client.js";
-import { ArchitectClient } from "./clients/architect-client.js";
 import { AstGrepClient } from "./clients/ast-grep-client.js";
-import { BiomeClient } from "./clients/biome-client.js";
 import { CacheManager } from "./clients/cache-manager.js";
-import { ComplexityClient } from "./clients/complexity-client.js";
-import { DependencyChecker } from "./clients/dependency-checker.js";
+import { loadBootstrapClients } from "./clients/bootstrap.js";
 import { getDiagnosticTracker } from "./clients/diagnostic-tracker.js";
 import {
 	getDispatchSlopScoreLine,
 	getLatencyReports,
 	resetDispatchBaselines,
 } from "./clients/dispatch/integration.js";
-import { extractFunctions } from "./clients/dispatch/runners/similarity.js";
 import { resetFormatService } from "./clients/format-service.js";
 import { evaluateGitGuard, isGitCommitOrPushAttempt } from "./clients/git-guard.js";
-import { GoClient } from "./clients/go-client.js";
 import { ensureTool } from "./clients/installer/index.js";
-import { JscpdClient } from "./clients/jscpd-client.js";
-import { KnipClient } from "./clients/knip-client.js";
+import { initLSPConfig } from "./clients/lsp/config.js";
 import { getLSPService, resetLSPService } from "./clients/lsp/index.js";
-import { MetricsClient } from "./clients/metrics-client.js";
 import { captureSnapshot } from "./clients/metrics-history.js";
 import { findSimilarFunctions } from "./clients/project-index.js";
-import { RuffClient } from "./clients/ruff-client.js";
 import { RuntimeCoordinator } from "./clients/runtime-coordinator.js";
 import {
 	consumeSessionStartGuidance,
@@ -38,11 +29,6 @@ import { handleSessionStart } from "./clients/runtime-session.js";
 import { handleToolResult } from "./clients/runtime-tool-result.js";
 import { handleTurnEnd } from "./clients/runtime-turn.js";
 import { formatRulesForPrompt } from "./clients/rules-scanner.js";
-import { RustClient } from "./clients/rust-client.js";
-import { TestRunnerClient } from "./clients/test-runner-client.js";
-import { TodoScanner } from "./clients/todo-scanner.js";
-import { TypeCoverageClient } from "./clients/type-coverage-client.js";
-import { TypeScriptClient } from "./clients/typescript-client.js";
 import { handleBooboo } from "./commands/booboo.js";
 import { createAstGrepReplaceTool } from "./tools/ast-grep-replace.js";
 import { createAstGrepSearchTool } from "./tools/ast-grep-search.js";
@@ -72,11 +58,19 @@ function dbg(msg: string) {
 
 let _verbose = false;
 const runtime = new RuntimeCoordinator();
+const _lspConfigInitializedCwds = new Set<string>();
 
 function log(msg: string) {
 	if (_verbose) console.error(`[pi-lens] ${msg}`);
 }
 
+async function ensureLSPConfigInitialized(cwd: string): Promise<void> {
+	const normalizedCwd = path.resolve(cwd);
+	if (_lspConfigInitializedCwds.has(normalizedCwd)) return;
+	await initLSPConfig(normalizedCwd);
+	_lspConfigInitializedCwds.add(normalizedCwd);
+}
+
 function updateRuntimeIdentityFromEvent(event: unknown): void {
 	const raw = event as {
 		provider?: string;
@@ -136,24 +130,10 @@ function cleanStaleTsBuildInfo(cwd: string): string[] {
 // --- Extension ---
 
 export default function (pi: ExtensionAPI) {
-	const tsClient = new TypeScriptClient();
 	const astGrepClient = new AstGrepClient();
-	const ruffClient = new RuffClient();
-	const biomeClient = new BiomeClient();
-	const knipClient = new KnipClient();
-	const todoScanner = new TodoScanner();
-	const jscpdClient = new JscpdClient();
-	const typeCoverageClient = new TypeCoverageClient();
-	const depChecker = new DependencyChecker();
-	const testRunnerClient = new TestRunnerClient();
-	const metricsClient = new MetricsClient();
-	const complexityClient = new ComplexityClient();
-	const architectClient = new ArchitectClient();
-	const goClient = new GoClient();
-	const rustClient = new RustClient();
-	const agentBehaviorClient = new AgentBehaviorClient();
 	const cacheManager = new CacheManager();
 
+
 	// --- Flags ---
 
 	pi.registerFlag("lens-verbose", {
@@ -299,8 +279,9 @@ export default function (pi: ExtensionAPI) {
 	pi.registerCommand("lens-booboo", {
 		description:
 			"Full codebase review: design smells, complexity, AI slop detection, TODOs, dead code, duplicates, type coverage. Results saved to .pi-lens/reviews/. Usage: /lens-booboo [path]",
-		handler: (args, ctx) =>
-			handleBooboo(
+		handler: async (args, ctx) => {
+			const { complexityClient, todoScanner, knipClient, jscpdClient, typeCoverageClient, depChecker, architectClient } = await loadBootstrapClients();
+			return handleBooboo(
 				args,
 				ctx,
 				{
@@ -310,11 +291,12 @@ export default function (pi: ExtensionAPI) {
 					knip: knipClient,
 					jscpd: jscpdClient,
 					typeCoverage: typeCoverageClient,
-					depChecker: depChecker,
+					depChecker,
 					architect: architectClient,
 				},
 				pi,
-			),
+			);
+		},
 	});
 
 	// DISABLED: lens-booboo-fix command - disabled per user request
@@ -482,7 +464,26 @@ pi.on("session_start", async (event, ctx) => {
 		_verbose = !!pi.getFlag("lens-verbose");
 		dbg("session_start fired");
 		updateRuntimeIdentityFromEvent(event);
+		try {
+			await ensureLSPConfigInitialized(ctx.cwd ?? process.cwd());
+		} catch (cfgErr) {
+			dbg(`lsp config init failed: ${cfgErr}`);
+		}
 
+		const {
+			metricsClient,
+			todoScanner,
+			biomeClient,
+			ruffClient,
+			knipClient,
+			jscpdClient,
+			typeCoverageClient,
+			depChecker,
+			architectClient,
+			testRunnerClient,
+			goClient,
+			rustClient,
+		} = await loadBootstrapClients();
 		await handleSessionStart({
 			ctxCwd: ctx.cwd,
 			getFlag: (name: string) => pi.getFlag(name),
@@ -504,7 +505,8 @@ pi.on("session_start", async (event, ctx) => {
 			testRunnerClient,
 			goClient,
 			rustClient,
-			ensureTool,
+			ensureTool: async (name: string) =>
+				(await import("./clients/installer/index.js")).ensureTool(name),
 			cleanStaleTsBuildInfo,
 			resetDispatchBaselines,
 			resetLSPService,
@@ -546,6 +548,17 @@ pi.on("tool_call", async (event, ctx) => {
 			: path.resolve(ctx.cwd ?? runtime.projectRoot, rawFilePath)
 		: undefined;
 
+	if (pi.getFlag("lens-lsp") && !pi.getFlag("no-lsp")) {
+		try {
+			const configCwd = filePath
+				? path.dirname(filePath)
+				: (ctx.cwd ?? runtime.projectRoot ?? process.cwd());
+			await ensureLSPConfigInitialized(configCwd);
+		} catch (cfgErr) {
+			dbg(`lsp config init failed during tool_call: ${cfgErr}`);
+		}
+	}
+
 	if (!filePath) return;
 
 	dbg(
@@ -571,6 +584,7 @@ pi.on("tool_call", async (event, ctx) => {
 		}
 	}
 
+	const { complexityClient } = await loadBootstrapClients();
 	// Record complexity baseline for historical tracking (booboo/tdi).
 	// Not shown inline — just captured for delta analysis.
 	if (
@@ -580,6 +594,9 @@ pi.on("tool_call", async (event, ctx) => {
 		const baseline = complexityClient.analyzeFile(filePath);
 		if (baseline) {
 			runtime.complexityBaselines.set(filePath, baseline);
+			const { captureSnapshot } = await import(
+				"./clients/metrics-history.js"
+			);
 			captureSnapshot(filePath, {
 				maintainabilityIndex: baseline.maintainabilityIndex,
 				cognitiveComplexity: baseline.cognitiveComplexity,
@@ -645,6 +662,8 @@ pi.on("tool_call", async (event, ctx) => {
 						ts.ScriptTarget.Latest,
 						true,
 					);
+					const { extractFunctions } = await import("./clients/dispatch/runners/similarity.js");
+					const { findSimilarFunctions } = await import("./clients/project-index.js");
 					const newFunctions = extractFunctions(sourceFile, newContent);
 					const simWarnings: string[] = [];
 					let simHintsTruncated = false;
@@ -711,6 +730,13 @@ pi.on("tool_call", async (event, ctx) => {
 // biome-ignore lint/suspicious/noExplicitAny: pi.on overload mismatch for tool_result event type
 (pi as any).on("tool_result", async (event: any) => {
 	updateRuntimeIdentityFromEvent(event);
+	const {
+		biomeClient,
+		ruffClient,
+		testRunnerClient,
+		metricsClient,
+		agentBehaviorClient,
+	} = await loadBootstrapClients();
 	return handleToolResult({
 		event: event as any,
 		getFlag: (name: string) => pi.getFlag(name),
@@ -747,6 +773,7 @@ pi.on("turn_start", () => {
 
 pi.on("turn_end", async (_event, ctx) => {
 	try {
+		const { jscpdClient, knipClient, depChecker } = await loadBootstrapClients();
 		await handleTurnEnd({
 			ctxCwd: ctx.cwd,
 			getFlag: (name: string) => pi.getFlag(name),

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-lens",
-	"version": "3.8.23",
+	"version": "3.8.25",
 	"type": "module",
 	"description": "Real-time code feedback for pi — LSP, linters, formatters, type-checking, structural analysis & booboo",
 	"repository": {
@@ -75,6 +75,7 @@
 	"dependencies": {
 		"@sinclair/typebox": "^0.34.0",
 		"cross-spawn": "^7.0.6",
+		"minimatch": "^10.2.5",
 		"typescript": "^5.0.0",
 		"vscode-jsonrpc": "^8.2.1"
 	},