@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-lsp-extension/bemol-extension/locks.js

@@ -0,0 +1,148 @@
+// @ts-nocheck
+/**
+ * Workspace Lock — cross-session coordination for bemol runs.
+ *
+ * Uses PID-based lockfiles in `.bemol/locks/` to prevent multiple pi sessions
+ * from running bemol simultaneously in the same workspace.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, unlinkSync, openSync, closeSync, statSync, constants as fsConstants } from "node:fs";
+import { join } from "node:path";
+/**
+ * Check if a process is still alive.
+ */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const STALE_LOCK_THRESHOLD_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Try to acquire a named lock for this workspace.
+ * Uses O_CREAT|O_EXCL for atomic creation to avoid TOCTOU races.
+ * Returns true if acquired, false if another live session holds it.
+ */
+export function acquireLock(workspaceRoot, name, sessionId) {
+    const locksDir = join(workspaceRoot, ".bemol", "locks");
+    const lockFile = join(locksDir, `${name}.lock`);
+    // Check existing lock — clean up stale locks from dead processes or old age
+    const existing = readLock(workspaceRoot, name);
+    if (existing && existing.pid !== process.pid && isProcessAlive(existing.pid)) {
+        // Process is alive, but check if the lock is older than 5 minutes (stale)
+        try {
+            const stat = statSync(lockFile);
+            const ageMs = Date.now() - stat.mtimeMs;
+            if (ageMs > STALE_LOCK_THRESHOLD_MS) {
+                // Lock is stale — remove it even though the process is alive
+                try {
+                    unlinkSync(lockFile);
+                }
+                catch { /* ignore */ }
+            }
+            else {
+                return false; // another live session holds a fresh lock
+            }
+        }
+        catch {
+            return false; // can't stat, assume lock is valid
+        }
+    }
+    // If stale lock exists, remove it first
+    if (existing) {
+        try {
+            unlinkSync(lockFile);
+        }
+        catch { /* ignore */ }
+    }
+    // Acquire atomically using O_CREAT|O_EXCL (fails if file already exists)
+    try {
+        mkdirSync(locksDir, { recursive: true });
+        const info = { pid: process.pid, startTime: Date.now(), sessionId };
+        const content = JSON.stringify(info);
+        // O_WRONLY | O_CREAT | O_EXCL — atomic: fails with EEXIST if another process created it first
+        const fd = openSync(lockFile, fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL, 0o644);
+        try {
+            writeFileSync(fd, content);
+        }
+        finally {
+            closeSync(fd);
+        }
+        return true;
+    }
+    catch (err) {
+        if (err.code === "EEXIST") {
+            // Another process acquired the lock between our unlink and open — that's fine
+            return false;
+        }
+        return false;
+    }
+}
+/**
+ * Release a lock owned by this process.
+ */
+export function releaseLock(workspaceRoot, name) {
+    const lockFile = join(workspaceRoot, ".bemol", "locks", `${name}.lock`);
+    try {
+        const existing = readLock(workspaceRoot, name);
+        // Only delete if we own it
+        if (existing && existing.pid === process.pid) {
+            unlinkSync(lockFile);
+        }
+    }
+    catch {
+        // ignore
+    }
+}
+/**
+ * Read the current lock holder, or null if no lock / stale lock.
+ */
+export function readLock(workspaceRoot, name) {
+    const lockFile = join(workspaceRoot, ".bemol", "locks", `${name}.lock`);
+    try {
+        if (!existsSync(lockFile))
+            return null;
+        const content = readFileSync(lockFile, "utf-8");
+        const info = JSON.parse(content);
+        if (!info.pid || !info.startTime)
+            return null;
+        return info;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a lock is held by another live process (not us).
+ */
+export function isLockedByOther(workspaceRoot, name) {
+    const info = readLock(workspaceRoot, name);
+    if (!info)
+        return false;
+    if (info.pid === process.pid)
+        return false;
+    return isProcessAlive(info.pid);
+}
+/**
+ * Release all locks owned by this process in the workspace.
+ */
+export function releaseAllLocks(workspaceRoot) {
+    const locksDir = join(workspaceRoot, ".bemol", "locks");
+    try {
+        if (!existsSync(locksDir))
+            return;
+        const files = readdirSync(locksDir);
+        for (const file of files) {
+            if (!file.endsWith(".lock"))
+                continue;
+            const name = file.replace(/\.lock$/, "");
+            releaseLock(workspaceRoot, name);
+        }
+    }
+    catch {
+        // ignore
+    }
+}
+//# sourceMappingURL=locks.js.map

package/dist/builtin-extensions/pi-lsp-extension/bemol-extension/locks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks.js","sourceRoot":"","sources":["../../../../src/builtin-extensions/pi-lsp-extension/bemol-extension/locks.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * Workspace Lock — cross-session coordination for bemol runs.\n *\n * Uses PID-based lockfiles in `.bemol/locks/` to prevent multiple pi sessions\n * from running bemol simultaneously in the same workspace.\n */\n\nimport { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, unlinkSync, openSync, closeSync, statSync, constants as fsConstants } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface LockInfo {\n  pid: number;\n  startTime: number;\n  sessionId: string;\n}\n\n/**\n * Check if a process is still alive.\n */\nfunction isProcessAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nconst STALE_LOCK_THRESHOLD_MS = 5 * 60 * 1000; // 5 minutes\n\n/**\n * Try to acquire a named lock for this workspace.\n * Uses O_CREAT|O_EXCL for atomic creation to avoid TOCTOU races.\n * Returns true if acquired, false if another live session holds it.\n */\nexport function acquireLock(workspaceRoot: string, name: string, sessionId: string): boolean {\n  const locksDir = join(workspaceRoot, \".bemol\", \"locks\");\n  const lockFile = join(locksDir, `${name}.lock`);\n\n  // Check existing lock — clean up stale locks from dead processes or old age\n  const existing = readLock(workspaceRoot, name);\n  if (existing && existing.pid !== process.pid && isProcessAlive(existing.pid)) {\n    // Process is alive, but check if the lock is older than 5 minutes (stale)\n    try {\n      const stat = statSync(lockFile);\n      const ageMs = Date.now() - stat.mtimeMs;\n      if (ageMs > STALE_LOCK_THRESHOLD_MS) {\n        // Lock is stale — remove it even though the process is alive\n        try { unlinkSync(lockFile); } catch { /* ignore */ }\n      } else {\n        return false; // another live session holds a fresh lock\n      }\n    } catch {\n      return false; // can't stat, assume lock is valid\n    }\n  }\n\n  // If stale lock exists, remove it first\n  if (existing) {\n    try { unlinkSync(lockFile); } catch { /* ignore */ }\n  }\n\n  // Acquire atomically using O_CREAT|O_EXCL (fails if file already exists)\n  try {\n    mkdirSync(locksDir, { recursive: true });\n    const info: LockInfo = { pid: process.pid, startTime: Date.now(), sessionId };\n    const content = JSON.stringify(info);\n\n    // O_WRONLY | O_CREAT | O_EXCL — atomic: fails with EEXIST if another process created it first\n    const fd = openSync(lockFile, fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL, 0o644);\n    try {\n      writeFileSync(fd, content);\n    } finally {\n      closeSync(fd);\n    }\n    return true;\n  } catch (err: any) {\n    if (err.code === \"EEXIST\") {\n      // Another process acquired the lock between our unlink and open — that's fine\n      return false;\n    }\n    return false;\n  }\n}\n\n/**\n * Release a lock owned by this process.\n */\nexport function releaseLock(workspaceRoot: string, name: string): void {\n  const lockFile = join(workspaceRoot, \".bemol\", \"locks\", `${name}.lock`);\n  try {\n    const existing = readLock(workspaceRoot, name);\n    // Only delete if we own it\n    if (existing && existing.pid === process.pid) {\n      unlinkSync(lockFile);\n    }\n  } catch {\n    // ignore\n  }\n}\n\n/**\n * Read the current lock holder, or null if no lock / stale lock.\n */\nexport function readLock(workspaceRoot: string, name: string): LockInfo | null {\n  const lockFile = join(workspaceRoot, \".bemol\", \"locks\", `${name}.lock`);\n  try {\n    if (!existsSync(lockFile)) return null;\n    const content = readFileSync(lockFile, \"utf-8\");\n    const info = JSON.parse(content) as LockInfo;\n    if (!info.pid || !info.startTime) return null;\n    return info;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Check if a lock is held by another live process (not us).\n */\nexport function isLockedByOther(workspaceRoot: string, name: string): boolean {\n  const info = readLock(workspaceRoot, name);\n  if (!info) return false;\n  if (info.pid === process.pid) return false;\n  return isProcessAlive(info.pid);\n}\n\n/**\n * Release all locks owned by this process in the workspace.\n */\nexport function releaseAllLocks(workspaceRoot: string): void {\n  const locksDir = join(workspaceRoot, \".bemol\", \"locks\");\n  try {\n    if (!existsSync(locksDir)) return;\n    const files: string[] = readdirSync(locksDir);\n    for (const file of files) {\n      if (!file.endsWith(\".lock\")) continue;\n      const name = file.replace(/\\.lock$/, \"\");\n      releaseLock(workspaceRoot, name);\n    }\n  } catch {\n    // ignore\n  }\n}\n"]}

package/dist/builtin-extensions/pi-lsp-extension/src/file-sync.d.ts

@@ -0,0 +1,59 @@
+/**
+ * File Sync — keeps LSP servers informed of file changes.
+ *
+ * Hooks into pi tool results for read/write/edit and sends
+ * didOpen/didChange notifications to the appropriate LSP server.
+ *
+ * Maintains an LRU-bounded set of tracked documents. When the limit is
+ * reached, the least-recently-used document is closed via didClose to
+ * prevent unbounded memory growth in the LSP server during long sessions.
+ */
+import { LspManager } from "./lsp-manager.js";
+import type { TreeSitterManager } from "./tree-sitter/parser-manager.js";
+import type { WorkspaceIndex } from "./tree-sitter/workspace-index.js";
+/** Callback to check if a synthetic dot operation is in progress for a URI */
+export type SyntheticDotChecker = (uri: string) => boolean;
+export declare class FileSync {
+    private manager;
+    /** LRU map: most-recently-used documents are at the end (Map preserves insertion order) */
+    private tracked;
+    private treeSitter;
+    private workspaceIndex;
+    private isSyntheticDotActive;
+    private maxTracked;
+    constructor(manager: LspManager, maxTracked?: number);
+    /** Set the synthetic dot checker to coordinate with the completions tool */
+    setSyntheticDotChecker(checker: SyntheticDotChecker): void;
+    /** Set the tree-sitter manager for cache invalidation */
+    setTreeSitter(treeSitter: TreeSitterManager, workspaceIndex?: WorkspaceIndex): void;
+    /**
+     * Touch a URI in the LRU — moves it to the end (most-recently-used position).
+     * If the map exceeds maxTracked, evicts the oldest entry and sends didClose.
+     */
+    private touchAndEvict;
+    /**
+     * Handle a file being read — sends didOpen if not yet tracked.
+     * Called from tool_result handler for the `read` tool.
+     */
+    handleFileRead(filePath: string): Promise<void>;
+    /**
+     * Handle a file being written/edited — sends didOpen or didChange.
+     * Called from tool_result handler for `write` and `edit` tools.
+     */
+    handleFileWrite(filePath: string): Promise<void>;
+    /**
+     * Get the current tracked version for a URI, or null if not tracked.
+     * Used by tools that need to send temporary didChange notifications
+     * while keeping versions in sync.
+     */
+    getTrackedVersion(uri: string): number | null;
+    /**
+     * Update the tracked version for a URI after external didChange calls.
+     * This keeps FileSync in sync when other code (e.g., completions tool)
+     * sends didChange notifications directly to the LSP client.
+     */
+    setTrackedVersion(uri: string, version: number): void;
+    /** Get the number of tracked documents */
+    get trackedCount(): number;
+}
+//# sourceMappingURL=file-sync.d.ts.map

package/dist/builtin-extensions/pi-lsp-extension/src/file-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sync.d.ts","sourceRoot":"","sources":["../../../../src/builtin-extensions/pi-lsp-extension/src/file-sync.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;AAW3D,qBAAa,QAAQ;IAQP,OAAO,CAAC,OAAO;IAP3B,2FAA2F;IAC3F,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,oBAAoB,CAAoC;IAChE,OAAO,CAAC,UAAU,CAAS;IAE3B,YAAoB,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,EAE3D;IAED,4EAA4E;IAC5E,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAEzD;IAED,yDAAyD;IACzD,aAAa,CAAC,UAAU,EAAE,iBAAiB,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAGlF;IAED;;;OAGG;IACH,OAAO,CAAC,aAAa;IAuBrB;;;OAGG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BpD;IAED;;;OAGG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDrD;IAED;;;;OAIG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5C;IAED;;;;OAIG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKpD;IAED,0CAA0C;IAC1C,IAAI,YAAY,IAAI,MAAM,CAEzB;CACF","sourcesContent":["// @ts-nocheck\n/**\n * File Sync — keeps LSP servers informed of file changes.\n *\n * Hooks into pi tool results for read/write/edit and sends\n * didOpen/didChange notifications to the appropriate LSP server.\n *\n * Maintains an LRU-bounded set of tracked documents. When the limit is\n * reached, the least-recently-used document is closed via didClose to\n * prevent unbounded memory growth in the LSP server during long sessions.\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport { LspManager } from \"./lsp-manager.js\";\nimport type { TreeSitterManager } from \"./tree-sitter/parser-manager.js\";\nimport type { WorkspaceIndex } from \"./tree-sitter/workspace-index.js\";\n\n/** Callback to check if a synthetic dot operation is in progress for a URI */\nexport type SyntheticDotChecker = (uri: string) => boolean;\n\n/** Max open documents tracked simultaneously. Oldest are closed via didClose. */\nconst MAX_TRACKED_DOCUMENTS = 100;\n\ninterface TrackedDocument {\n  uri: string;\n  languageId: string;\n  version: number;\n}\n\nexport class FileSync {\n  /** LRU map: most-recently-used documents are at the end (Map preserves insertion order) */\n  private tracked: Map<string, TrackedDocument> = new Map();\n  private treeSitter: TreeSitterManager | null = null;\n  private workspaceIndex: WorkspaceIndex | null = null;\n  private isSyntheticDotActive: SyntheticDotChecker = () => false;\n  private maxTracked: number;\n\n  constructor(private manager: LspManager, maxTracked?: number) {\n    this.maxTracked = maxTracked ?? MAX_TRACKED_DOCUMENTS;\n  }\n\n  /** Set the synthetic dot checker to coordinate with the completions tool */\n  setSyntheticDotChecker(checker: SyntheticDotChecker): void {\n    this.isSyntheticDotActive = checker;\n  }\n\n  /** Set the tree-sitter manager for cache invalidation */\n  setTreeSitter(treeSitter: TreeSitterManager, workspaceIndex?: WorkspaceIndex): void {\n    this.treeSitter = treeSitter;\n    this.workspaceIndex = workspaceIndex ?? null;\n  }\n\n  /**\n   * Touch a URI in the LRU — moves it to the end (most-recently-used position).\n   * If the map exceeds maxTracked, evicts the oldest entry and sends didClose.\n   */\n  private touchAndEvict(uri: string): void {\n    const doc = this.tracked.get(uri);\n    if (doc) {\n      // Move to end by deleting and re-inserting\n      this.tracked.delete(uri);\n      this.tracked.set(uri, doc);\n    }\n\n    // Evict oldest if over capacity\n    while (this.tracked.size > this.maxTracked) {\n      const oldest = this.tracked.entries().next();\n      if (oldest.done) break;\n      const [evictUri, evictDoc] = oldest.value;\n      this.tracked.delete(evictUri);\n\n      // Send didClose to the appropriate LSP server\n      const client = this.manager.getRunningClient(evictDoc.languageId);\n      if (client) {\n        client.didClose(evictUri);\n      }\n    }\n  }\n\n  /**\n   * Handle a file being read — sends didOpen if not yet tracked.\n   * Called from tool_result handler for the `read` tool.\n   */\n  async handleFileRead(filePath: string): Promise<void> {\n    const absPath = this.manager.resolvePath(filePath);\n    const uri = this.manager.getFileUri(absPath);\n\n    // Already tracked? Just touch it for LRU freshness.\n    if (this.tracked.has(uri)) {\n      this.touchAndEvict(uri);\n      return;\n    }\n\n    const languageId = this.manager.getLanguageId(absPath);\n    if (!languageId) return;\n\n    // Only sync if we have a client already running for this language (don't start one just for a read)\n    const client = this.manager.getRunningClient(languageId);\n    if (!client) return;\n\n    try {\n      const content = await readFile(absPath, \"utf-8\");\n      const doc: TrackedDocument = { uri, languageId, version: 1 };\n      this.tracked.set(uri, doc);\n      client.didOpen(uri, languageId, doc.version, content);\n      this.touchAndEvict(uri);\n    } catch {\n      // File might not exist or be unreadable — ignore\n    }\n  }\n\n  /**\n   * Handle a file being written/edited — sends didOpen or didChange.\n   * Called from tool_result handler for `write` and `edit` tools.\n   */\n  async handleFileWrite(filePath: string): Promise<void> {\n    const absPath = this.manager.resolvePath(filePath);\n    const uri = this.manager.getFileUri(absPath);\n    const languageId = this.manager.getLanguageId(absPath);\n\n    // Invalidate tree-sitter cache and re-index\n    if (this.treeSitter) {\n      this.treeSitter.invalidate(absPath);\n      if (this.workspaceIndex) {\n        // Re-index in the background (don't block the write)\n        this.workspaceIndex.indexFile(absPath).catch(() => {});\n      }\n    }\n\n    if (!languageId) return;\n\n    // If a synthetic dot operation is in progress for this URI, defer the\n    // didChange to avoid version conflicts. The completions tool will revert\n    // the document to the correct content when it's done.\n    if (this.isSyntheticDotActive(uri)) {\n      // Schedule a retry after the synthetic dot window (200ms should be enough\n      // for the 100ms settle delay + completion request + revert)\n      setTimeout(() => {\n        // Re-check: if still active, skip — another retry would be needed\n        if (!this.isSyntheticDotActive(uri)) {\n          this.handleFileWrite(filePath).catch(() => {});\n        }\n      }, 200);\n      return;\n    }\n\n    // Get client (start server lazily if configured)\n    const client = await this.manager.getClientForFile(absPath).catch(() => null);\n    if (!client) return;\n\n    try {\n      const content = await readFile(absPath, \"utf-8\");\n      const existing = this.tracked.get(uri);\n\n      if (existing) {\n        // Already open — send didChange with incremented version\n        existing.version++;\n        client.didChange(uri, existing.version, content);\n      } else {\n        // First time — send didOpen\n        const doc: TrackedDocument = { uri, languageId, version: 1 };\n        this.tracked.set(uri, doc);\n        client.didOpen(uri, languageId, doc.version, content);\n      }\n      this.touchAndEvict(uri);\n    } catch {\n      // File might not exist or be unreadable — ignore\n    }\n  }\n\n  /**\n   * Get the current tracked version for a URI, or null if not tracked.\n   * Used by tools that need to send temporary didChange notifications\n   * while keeping versions in sync.\n   */\n  getTrackedVersion(uri: string): number | null {\n    const doc = this.tracked.get(uri);\n    return doc ? doc.version : null;\n  }\n\n  /**\n   * Update the tracked version for a URI after external didChange calls.\n   * This keeps FileSync in sync when other code (e.g., completions tool)\n   * sends didChange notifications directly to the LSP client.\n   */\n  setTrackedVersion(uri: string, version: number): void {\n    const doc = this.tracked.get(uri);\n    if (doc) {\n      doc.version = version;\n    }\n  }\n\n  /** Get the number of tracked documents */\n  get trackedCount(): number {\n    return this.tracked.size;\n  }\n}\n"]}

package/dist/builtin-extensions/pi-lsp-extension/src/file-sync.js

@@ -0,0 +1,172 @@
+// @ts-nocheck
+/**
+ * File Sync — keeps LSP servers informed of file changes.
+ *
+ * Hooks into pi tool results for read/write/edit and sends
+ * didOpen/didChange notifications to the appropriate LSP server.
+ *
+ * Maintains an LRU-bounded set of tracked documents. When the limit is
+ * reached, the least-recently-used document is closed via didClose to
+ * prevent unbounded memory growth in the LSP server during long sessions.
+ */
+import { readFile } from "node:fs/promises";
+/** Max open documents tracked simultaneously. Oldest are closed via didClose. */
+const MAX_TRACKED_DOCUMENTS = 100;
+export class FileSync {
+    manager;
+    /** LRU map: most-recently-used documents are at the end (Map preserves insertion order) */
+    tracked = new Map();
+    treeSitter = null;
+    workspaceIndex = null;
+    isSyntheticDotActive = () => false;
+    maxTracked;
+    constructor(manager, maxTracked) {
+        this.manager = manager;
+        this.maxTracked = maxTracked ?? MAX_TRACKED_DOCUMENTS;
+    }
+    /** Set the synthetic dot checker to coordinate with the completions tool */
+    setSyntheticDotChecker(checker) {
+        this.isSyntheticDotActive = checker;
+    }
+    /** Set the tree-sitter manager for cache invalidation */
+    setTreeSitter(treeSitter, workspaceIndex) {
+        this.treeSitter = treeSitter;
+        this.workspaceIndex = workspaceIndex ?? null;
+    }
+    /**
+     * Touch a URI in the LRU — moves it to the end (most-recently-used position).
+     * If the map exceeds maxTracked, evicts the oldest entry and sends didClose.
+     */
+    touchAndEvict(uri) {
+        const doc = this.tracked.get(uri);
+        if (doc) {
+            // Move to end by deleting and re-inserting
+            this.tracked.delete(uri);
+            this.tracked.set(uri, doc);
+        }
+        // Evict oldest if over capacity
+        while (this.tracked.size > this.maxTracked) {
+            const oldest = this.tracked.entries().next();
+            if (oldest.done)
+                break;
+            const [evictUri, evictDoc] = oldest.value;
+            this.tracked.delete(evictUri);
+            // Send didClose to the appropriate LSP server
+            const client = this.manager.getRunningClient(evictDoc.languageId);
+            if (client) {
+                client.didClose(evictUri);
+            }
+        }
+    }
+    /**
+     * Handle a file being read — sends didOpen if not yet tracked.
+     * Called from tool_result handler for the `read` tool.
+     */
+    async handleFileRead(filePath) {
+        const absPath = this.manager.resolvePath(filePath);
+        const uri = this.manager.getFileUri(absPath);
+        // Already tracked? Just touch it for LRU freshness.
+        if (this.tracked.has(uri)) {
+            this.touchAndEvict(uri);
+            return;
+        }
+        const languageId = this.manager.getLanguageId(absPath);
+        if (!languageId)
+            return;
+        // Only sync if we have a client already running for this language (don't start one just for a read)
+        const client = this.manager.getRunningClient(languageId);
+        if (!client)
+            return;
+        try {
+            const content = await readFile(absPath, "utf-8");
+            const doc = { uri, languageId, version: 1 };
+            this.tracked.set(uri, doc);
+            client.didOpen(uri, languageId, doc.version, content);
+            this.touchAndEvict(uri);
+        }
+        catch {
+            // File might not exist or be unreadable — ignore
+        }
+    }
+    /**
+     * Handle a file being written/edited — sends didOpen or didChange.
+     * Called from tool_result handler for `write` and `edit` tools.
+     */
+    async handleFileWrite(filePath) {
+        const absPath = this.manager.resolvePath(filePath);
+        const uri = this.manager.getFileUri(absPath);
+        const languageId = this.manager.getLanguageId(absPath);
+        // Invalidate tree-sitter cache and re-index
+        if (this.treeSitter) {
+            this.treeSitter.invalidate(absPath);
+            if (this.workspaceIndex) {
+                // Re-index in the background (don't block the write)
+                this.workspaceIndex.indexFile(absPath).catch(() => { });
+            }
+        }
+        if (!languageId)
+            return;
+        // If a synthetic dot operation is in progress for this URI, defer the
+        // didChange to avoid version conflicts. The completions tool will revert
+        // the document to the correct content when it's done.
+        if (this.isSyntheticDotActive(uri)) {
+            // Schedule a retry after the synthetic dot window (200ms should be enough
+            // for the 100ms settle delay + completion request + revert)
+            setTimeout(() => {
+                // Re-check: if still active, skip — another retry would be needed
+                if (!this.isSyntheticDotActive(uri)) {
+                    this.handleFileWrite(filePath).catch(() => { });
+                }
+            }, 200);
+            return;
+        }
+        // Get client (start server lazily if configured)
+        const client = await this.manager.getClientForFile(absPath).catch(() => null);
+        if (!client)
+            return;
+        try {
+            const content = await readFile(absPath, "utf-8");
+            const existing = this.tracked.get(uri);
+            if (existing) {
+                // Already open — send didChange with incremented version
+                existing.version++;
+                client.didChange(uri, existing.version, content);
+            }
+            else {
+                // First time — send didOpen
+                const doc = { uri, languageId, version: 1 };
+                this.tracked.set(uri, doc);
+                client.didOpen(uri, languageId, doc.version, content);
+            }
+            this.touchAndEvict(uri);
+        }
+        catch {
+            // File might not exist or be unreadable — ignore
+        }
+    }
+    /**
+     * Get the current tracked version for a URI, or null if not tracked.
+     * Used by tools that need to send temporary didChange notifications
+     * while keeping versions in sync.
+     */
+    getTrackedVersion(uri) {
+        const doc = this.tracked.get(uri);
+        return doc ? doc.version : null;
+    }
+    /**
+     * Update the tracked version for a URI after external didChange calls.
+     * This keeps FileSync in sync when other code (e.g., completions tool)
+     * sends didChange notifications directly to the LSP client.
+     */
+    setTrackedVersion(uri, version) {
+        const doc = this.tracked.get(uri);
+        if (doc) {
+            doc.version = version;
+        }
+    }
+    /** Get the number of tracked documents */
+    get trackedCount() {
+        return this.tracked.size;
+    }
+}
+//# sourceMappingURL=file-sync.js.map

package/dist/builtin-extensions/pi-lsp-extension/src/file-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sync.js","sourceRoot":"","sources":["../../../../src/builtin-extensions/pi-lsp-extension/src/file-sync.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * File Sync — keeps LSP servers informed of file changes.\n *\n * Hooks into pi tool results for read/write/edit and sends\n * didOpen/didChange notifications to the appropriate LSP server.\n *\n * Maintains an LRU-bounded set of tracked documents. When the limit is\n * reached, the least-recently-used document is closed via didClose to\n * prevent unbounded memory growth in the LSP server during long sessions.\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport { LspManager } from \"./lsp-manager.js\";\nimport type { TreeSitterManager } from \"./tree-sitter/parser-manager.js\";\nimport type { WorkspaceIndex } from \"./tree-sitter/workspace-index.js\";\n\n/** Callback to check if a synthetic dot operation is in progress for a URI */\nexport type SyntheticDotChecker = (uri: string) => boolean;\n\n/** Max open documents tracked simultaneously. Oldest are closed via didClose. */\nconst MAX_TRACKED_DOCUMENTS = 100;\n\ninterface TrackedDocument {\n  uri: string;\n  languageId: string;\n  version: number;\n}\n\nexport class FileSync {\n  /** LRU map: most-recently-used documents are at the end (Map preserves insertion order) */\n  private tracked: Map<string, TrackedDocument> = new Map();\n  private treeSitter: TreeSitterManager | null = null;\n  private workspaceIndex: WorkspaceIndex | null = null;\n  private isSyntheticDotActive: SyntheticDotChecker = () => false;\n  private maxTracked: number;\n\n  constructor(private manager: LspManager, maxTracked?: number) {\n    this.maxTracked = maxTracked ?? MAX_TRACKED_DOCUMENTS;\n  }\n\n  /** Set the synthetic dot checker to coordinate with the completions tool */\n  setSyntheticDotChecker(checker: SyntheticDotChecker): void {\n    this.isSyntheticDotActive = checker;\n  }\n\n  /** Set the tree-sitter manager for cache invalidation */\n  setTreeSitter(treeSitter: TreeSitterManager, workspaceIndex?: WorkspaceIndex): void {\n    this.treeSitter = treeSitter;\n    this.workspaceIndex = workspaceIndex ?? null;\n  }\n\n  /**\n   * Touch a URI in the LRU — moves it to the end (most-recently-used position).\n   * If the map exceeds maxTracked, evicts the oldest entry and sends didClose.\n   */\n  private touchAndEvict(uri: string): void {\n    const doc = this.tracked.get(uri);\n    if (doc) {\n      // Move to end by deleting and re-inserting\n      this.tracked.delete(uri);\n      this.tracked.set(uri, doc);\n    }\n\n    // Evict oldest if over capacity\n    while (this.tracked.size > this.maxTracked) {\n      const oldest = this.tracked.entries().next();\n      if (oldest.done) break;\n      const [evictUri, evictDoc] = oldest.value;\n      this.tracked.delete(evictUri);\n\n      // Send didClose to the appropriate LSP server\n      const client = this.manager.getRunningClient(evictDoc.languageId);\n      if (client) {\n        client.didClose(evictUri);\n      }\n    }\n  }\n\n  /**\n   * Handle a file being read — sends didOpen if not yet tracked.\n   * Called from tool_result handler for the `read` tool.\n   */\n  async handleFileRead(filePath: string): Promise<void> {\n    const absPath = this.manager.resolvePath(filePath);\n    const uri = this.manager.getFileUri(absPath);\n\n    // Already tracked? Just touch it for LRU freshness.\n    if (this.tracked.has(uri)) {\n      this.touchAndEvict(uri);\n      return;\n    }\n\n    const languageId = this.manager.getLanguageId(absPath);\n    if (!languageId) return;\n\n    // Only sync if we have a client already running for this language (don't start one just for a read)\n    const client = this.manager.getRunningClient(languageId);\n    if (!client) return;\n\n    try {\n      const content = await readFile(absPath, \"utf-8\");\n      const doc: TrackedDocument = { uri, languageId, version: 1 };\n      this.tracked.set(uri, doc);\n      client.didOpen(uri, languageId, doc.version, content);\n      this.touchAndEvict(uri);\n    } catch {\n      // File might not exist or be unreadable — ignore\n    }\n  }\n\n  /**\n   * Handle a file being written/edited — sends didOpen or didChange.\n   * Called from tool_result handler for `write` and `edit` tools.\n   */\n  async handleFileWrite(filePath: string): Promise<void> {\n    const absPath = this.manager.resolvePath(filePath);\n    const uri = this.manager.getFileUri(absPath);\n    const languageId = this.manager.getLanguageId(absPath);\n\n    // Invalidate tree-sitter cache and re-index\n    if (this.treeSitter) {\n      this.treeSitter.invalidate(absPath);\n      if (this.workspaceIndex) {\n        // Re-index in the background (don't block the write)\n        this.workspaceIndex.indexFile(absPath).catch(() => {});\n      }\n    }\n\n    if (!languageId) return;\n\n    // If a synthetic dot operation is in progress for this URI, defer the\n    // didChange to avoid version conflicts. The completions tool will revert\n    // the document to the correct content when it's done.\n    if (this.isSyntheticDotActive(uri)) {\n      // Schedule a retry after the synthetic dot window (200ms should be enough\n      // for the 100ms settle delay + completion request + revert)\n      setTimeout(() => {\n        // Re-check: if still active, skip — another retry would be needed\n        if (!this.isSyntheticDotActive(uri)) {\n          this.handleFileWrite(filePath).catch(() => {});\n        }\n      }, 200);\n      return;\n    }\n\n    // Get client (start server lazily if configured)\n    const client = await this.manager.getClientForFile(absPath).catch(() => null);\n    if (!client) return;\n\n    try {\n      const content = await readFile(absPath, \"utf-8\");\n      const existing = this.tracked.get(uri);\n\n      if (existing) {\n        // Already open — send didChange with incremented version\n        existing.version++;\n        client.didChange(uri, existing.version, content);\n      } else {\n        // First time — send didOpen\n        const doc: TrackedDocument = { uri, languageId, version: 1 };\n        this.tracked.set(uri, doc);\n        client.didOpen(uri, languageId, doc.version, content);\n      }\n      this.touchAndEvict(uri);\n    } catch {\n      // File might not exist or be unreadable — ignore\n    }\n  }\n\n  /**\n   * Get the current tracked version for a URI, or null if not tracked.\n   * Used by tools that need to send temporary didChange notifications\n   * while keeping versions in sync.\n   */\n  getTrackedVersion(uri: string): number | null {\n    const doc = this.tracked.get(uri);\n    return doc ? doc.version : null;\n  }\n\n  /**\n   * Update the tracked version for a URI after external didChange calls.\n   * This keeps FileSync in sync when other code (e.g., completions tool)\n   * sends didChange notifications directly to the LSP client.\n   */\n  setTrackedVersion(uri: string, version: number): void {\n    const doc = this.tracked.get(uri);\n    if (doc) {\n      doc.version = version;\n    }\n  }\n\n  /** Get the number of tracked documents */\n  get trackedCount(): number {\n    return this.tracked.size;\n  }\n}\n"]}

package/dist/builtin-extensions/pi-lsp-extension/src/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * pi-lsp-extension — Pi coding agent extension for LSP integration.
+ *
+ * Exposes Language Server Protocol capabilities as tools the LLM can call:
+ * - lsp_diagnostics: compilation errors and warnings
+ * - lsp_hover: type info and docs at a position
+ * - lsp_definition: go to definition
+ * - lsp_references: find all references
+ * - lsp_symbols: file/workspace symbol search
+ * - lsp_rename: preview rename refactoring
+ * - lsp_completions: code completion suggestions at a position
+ * - lsp_code_actions: quick fixes, refactorings, and source actions
+ *
+ * Position-based tools (hover, definition, references, rename, code_actions)
+ * accept an optional `query` parameter as an alternative to line/character,
+ * resolving a symbol name to its position automatically.
+ *
+ * Usage:
+ *   1. npm install in this directory
+ *   2. Add to pi via settings.json extensions, or: pi -e ./src/index.ts
+ *   3. LSP servers start lazily when you first use a tool on a file
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export default function lspExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/builtin-extensions/pi-lsp-extension/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/builtin-extensions/pi-lsp-extension/src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AA8EpE,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EAAE,EAAE,YAAY,QAyfpD","sourcesContent":["// @ts-nocheck\n/**\n * pi-lsp-extension — Pi coding agent extension for LSP integration.\n *\n * Exposes Language Server Protocol capabilities as tools the LLM can call:\n * - lsp_diagnostics: compilation errors and warnings\n * - lsp_hover: type info and docs at a position\n * - lsp_definition: go to definition\n * - lsp_references: find all references\n * - lsp_symbols: file/workspace symbol search\n * - lsp_rename: preview rename refactoring\n * - lsp_completions: code completion suggestions at a position\n * - lsp_code_actions: quick fixes, refactorings, and source actions\n *\n * Position-based tools (hover, definition, references, rename, code_actions)\n * accept an optional `query` parameter as an alternative to line/character,\n * resolving a symbol name to its position automatically.\n *\n * Usage:\n *   1. npm install in this directory\n *   2. Add to pi via settings.json extensions, or: pi -e ./src/index.ts\n *   3. LSP servers start lazily when you first use a tool on a file\n */\n\nimport type { ExtensionAPI } from \"@earendil-works/pi-coding-agent\";\nimport {\n  isReadToolResult,\n  isWriteToolResult,\n  isEditToolResult,\n} from \"@earendil-works/pi-coding-agent\";\nimport { DiagnosticSeverity, type Diagnostic } from \"vscode-languageserver-protocol\";\n\nimport { LspManager, type ServerConfig, type LspManagerCallbacks } from \"./lsp-manager.js\";\nimport { FileSync } from \"./file-sync.js\";\nimport { TreeSitterManager } from \"./tree-sitter/parser-manager.js\";\nimport { WorkspaceIndex } from \"./tree-sitter/workspace-index.js\";\nimport { type WorkspaceProvider, DefaultWorkspaceProvider } from \"./workspace-provider.js\";\nimport { createDiagnosticsTool } from \"./tools/diagnostics.js\";\nimport { createHoverTool } from \"./tools/hover.js\";\nimport { createDefinitionTool } from \"./tools/definition.js\";\nimport { createReferencesTool } from \"./tools/references.js\";\nimport { createSymbolsTool } from \"./tools/symbols.js\";\nimport { createRenameTool } from \"./tools/rename.js\";\nimport { createCodeOverviewTool } from \"./tools/code-overview.js\";\nimport { createCompletionsTool } from \"./tools/completions.js\";\nimport { createCodeSearchTool } from \"./tools/code-search.js\";\nimport { createCodeRewriteTool } from \"./tools/code-rewrite.js\";\nimport { createCodeActionsTool } from \"./tools/code-actions.js\";\nimport { syntheticDotLocks } from \"./tools/completions.js\";\nimport { relative } from \"node:path\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { DIAGNOSTIC_SETTLE_DELAY_MS } from \"./shared/timing.js\";\n\n/**\n * Project-level LSP config — loaded from `.pi-lsp.json` in the workspace root.\n *\n * Example:\n * ```json\n * {\n *   \"autoStart\": [\"java\", \"typescript\"],\n *   \"lombokJar\": \"env/Lombok-1.18.x/runtime/lib/lombok-1.18.42.jar\",\n *   \"servers\": {\n *     \"python\": { \"command\": \"pylsp\", \"args\": [] }\n *   }\n * }\n * ```\n */\ninterface ProjectLspConfig {\n  /** Languages to start eagerly on session_start (e.g. [\"java\", \"typescript\"]) */\n  autoStart?: string[];\n  /** Path to Lombok jar (absolute or relative to project root). \"auto\" to auto-detect. */\n  lombokJar?: string;\n  /** Custom server configs keyed by language ID */\n  servers?: Record<string, { command: string; args?: string[]; env?: Record<string, string>; initializationOptions?: Record<string, unknown>; settings?: Record<string, unknown> }>;\n  /**\n   * Auto-inject LSP error diagnostics into write/edit tool results.\n   * Set to false to disable, or provide an array of language IDs to enable selectively.\n   * Default: true (all languages).\n   *\n   * Examples:\n   *   true              — inject for all languages\n   *   false             — never inject\n   *   [\"typescript\"]    — only inject for TypeScript files\n   */\n  autoInjectDiagnostics?: boolean | string[];\n}\n\n/** Load .pi-lsp.json from a directory. Returns null if not found or invalid. */\nfunction loadProjectConfig(dir: string): ProjectLspConfig | null {\n  const configPath = join(dir, \".pi-lsp.json\");\n  try {\n    if (!existsSync(configPath)) return null;\n    const raw = readFileSync(configPath, \"utf-8\");\n    const parsed = JSON.parse(raw);\n    if (typeof parsed !== \"object\" || parsed === null) return null;\n    return parsed as ProjectLspConfig;\n  } catch {\n    return null;\n  }\n}\n\nexport default function lspExtension(pi: ExtensionAPI) {\n  // Prevent EPIPE errors from LSP server exits from crashing the host process.\n  // When an LSP server exits unexpectedly, in-flight writes to its stdin pipe\n  // can produce EPIPE errors that escape all connection-level error handlers.\n  const origListeners = process.listeners(\"uncaughtException\");\n  process.on(\"uncaughtException\", (err: any) => {\n    if (err?.code === \"EPIPE\") return; // swallow — LSP server exited, harmless\n    // Re-throw for other handlers\n    for (const listener of origListeners) (listener as any)(err);\n    if (origListeners.length === 0) {\n      console.error(\"[LSP] Uncaught exception:\", err);\n    }\n  });\n\n  let manager: LspManager | null = null;\n  let fileSync: FileSync | null = null;\n  let treeSitter: TreeSitterManager | null = null;\n  let workspaceIndex: WorkspaceIndex | null = null;\n  let pendingProvider: WorkspaceProvider | null = null;\n  // Store latest ctx for lifecycle callbacks (updated on each event)\n  let latestCtx: any = null;\n  // Project config — loaded on session_start, used by auto-injection guard\n  let projectConfig: ProjectLspConfig | null = null;\n\n  /**\n   * Run `fn` with the currently captured ctx, swallowing stale-ctx errors.\n   *\n   * Lifecycle callbacks from LspManager (server ready, workspace setup, etc.)\n   * and `pi.events` listeners can fire AFTER the session is replaced or reloaded,\n   * at which point the captured ctx has been invalidated and any property access\n   * throws via ExtensionRunner.assertActive(). We can't use optional chaining to\n   * dodge it because the `ui` / `theme` getters themselves run assertActive().\n   */\n  const withLatestCtx = (fn: (ctx: any) => void) => {\n    const ctx = latestCtx;\n    if (!ctx) return;\n    try {\n      fn(ctx);\n    } catch (err: any) {\n      if (typeof err?.message === \"string\" && err.message.includes(\"stale after session\")) {\n        // Session was replaced/reloaded — drop the stale ctx and move on.\n        latestCtx = null;\n        return;\n      }\n      throw err;\n    }\n  };\n\n  // Listen for external workspace providers (e.g. bemol extension).\n  // Also check if one was already registered before we loaded (load order varies).\n  // Store as pendingProvider so it's available when the manager is created later.\n  const applyProvider = (data: unknown) => {\n    const provider = data as WorkspaceProvider;\n    pendingProvider = provider;\n    if (manager) {\n      manager.setWorkspaceProvider(provider);\n    }\n    // Update status if we have a UI context\n    const statusText = provider.getStatusText();\n    if (!statusText) return;\n    withLatestCtx((ctx) => {\n      if (!ctx.ui?.theme) return;\n      ctx.ui.setStatus(\"lsp\", ctx.ui.theme.fg(\"accent\", `LSP: ${statusText}`));\n    });\n  };\n\n  pi.events.on(\"lsp:register-workspace-provider\", applyProvider);\n\n  // Check for provider registered before our listener existed\n  const existing = (pi.events as any)[\"lsp:workspace-provider\"];\n  if (existing) applyProvider(existing);\n\n  /** Build lifecycle callbacks that update UI status */\n  const setLspStatus = (color: string, text: string) => {\n    withLatestCtx((ctx) => {\n      if (!ctx.ui?.theme) return;\n      ctx.ui.setStatus(\"lsp\", ctx.ui.theme.fg(color, text));\n    });\n  };\n\n  const makeCallbacks = (): LspManagerCallbacks => ({\n    onWorkspaceSetupStart: () => {\n      setLspStatus(\"warning\", \"LSP: workspace setup...\");\n    },\n    onWorkspaceSetupEnd: (success: boolean, duration: number) => {\n      const secs = (duration / 1000).toFixed(1);\n      if (success) {\n        setLspStatus(\"accent\", `LSP: workspace ready (${secs}s)`);\n      } else {\n        setLspStatus(\"warning\", `LSP: workspace setup failed (${secs}s)`);\n      }\n    },\n    onServerStart: (languageId: string, command: string) => {\n      setLspStatus(\"warning\", `LSP: starting ${languageId} (${command})...`);\n    },\n    onServerReady: (languageId: string) => {\n      setLspStatus(\"accent\", `LSP: ${languageId} ready`);\n    },\n    onServerError: (languageId: string, _error: string) => {\n      setLspStatus(\"error\", `LSP: ${languageId} failed`);\n    },\n    onServerCrash: (languageId: string, restarting: boolean, attempt: number) => {\n      if (restarting) {\n        setLspStatus(\"warning\", `LSP: restarting ${languageId}... (attempt ${attempt}/3)`);\n      } else {\n        setLspStatus(\"error\", `LSP: ${languageId} crashed — auto-restart exhausted`);\n      }\n    },\n  });\n\n  // Create manager eagerly so tools can reference it, but servers start lazily\n  const getManager = (): LspManager => {\n    if (!manager) {\n      manager = new LspManager(process.cwd(), undefined, makeCallbacks(), undefined, pendingProvider ?? undefined);\n      fileSync = new FileSync(manager);\n      fileSync.setSyntheticDotChecker((uri) => syntheticDotLocks.has(uri));\n      treeSitter = new TreeSitterManager();\n      workspaceIndex = new WorkspaceIndex(process.cwd(), treeSitter);\n      fileSync.setTreeSitter(treeSitter, workspaceIndex);\n    }\n    return manager;\n  };\n\n  const getFileSync = (): FileSync => {\n    if (!fileSync) {\n      getManager(); // ensures fileSync is created\n    }\n    return fileSync!;\n  };\n\n  const getTreeSitter = (): TreeSitterManager => {\n    if (!treeSitter) {\n      getManager(); // ensures treeSitter is created\n    }\n    return treeSitter!;\n  };\n\n  const getWorkspaceIndex = (): WorkspaceIndex => {\n    if (!workspaceIndex) {\n      getManager(); // ensures workspaceIndex is created\n    }\n    return workspaceIndex!;\n  };\n\n  // Initialize manager (uses cwd at session start time)\n  pi.on(\"session_start\", async (_event, ctx) => {\n    latestCtx = ctx;\n\n    // If manager was already created eagerly (e.g. by a tool before session_start),\n    // shut it down so we can re-create with the correct ctx.cwd.\n    if (manager) {\n      await manager.shutdownAll().catch(() => {});\n      if (treeSitter) treeSitter.shutdown();\n    }\n\n    manager = new LspManager(ctx.cwd, undefined, makeCallbacks(), undefined, pendingProvider ?? undefined);\n    fileSync = new FileSync(manager);\n    fileSync.setSyntheticDotChecker((uri) => syntheticDotLocks.has(uri));\n    treeSitter = new TreeSitterManager();\n    workspaceIndex = new WorkspaceIndex(ctx.cwd, treeSitter);\n    fileSync.setTreeSitter(treeSitter, workspaceIndex);\n\n    // Initialize tree-sitter in the background (don't block session start)\n    treeSitter.init().catch((err) => {\n      console.error(`[pi-lsp-extension] tree-sitter WASM init failed: ${err?.message ?? err}`);\n    });\n\n    // Show workspace provider status\n    const wsProvider = manager.workspace;\n    const statusText = wsProvider.getStatusText();\n    if (statusText) {\n      ctx.ui.setStatus(\"lsp\", ctx.ui.theme.fg(\"accent\", `LSP: ${statusText}`));\n    } else {\n      ctx.ui.setStatus(\"lsp\", ctx.ui.theme.fg(\"dim\", \"LSP: idle\"));\n    }\n\n    // Load project config and apply settings\n    projectConfig = loadProjectConfig(ctx.cwd);\n    if (projectConfig) {\n      // Apply custom server configs\n      if (projectConfig.servers) {\n        for (const [lang, serverConf] of Object.entries(projectConfig.servers)) {\n          manager.setServerConfig(lang, {\n            command: serverConf.command,\n            args: serverConf.args ?? [],\n            env: serverConf.env,\n            initializationOptions: serverConf.initializationOptions,\n            settings: serverConf.settings,\n          });\n        }\n      }\n\n      // Set Lombok jar path (explicit path or \"auto\" for auto-detection)\n      if (projectConfig.lombokJar) {\n        if (projectConfig.lombokJar !== \"auto\") {\n          manager.setLombokJar(projectConfig.lombokJar);\n        }\n        // \"auto\" is the default behavior — findLombokJar() already auto-detects.\n        // Setting it explicitly just confirms the user wants Lombok support.\n      }\n\n      // Auto-start configured languages in the background\n      if (projectConfig.autoStart && projectConfig.autoStart.length > 0) {\n        const langs = projectConfig.autoStart;\n        const lombokNote = langs.includes(\"java\") && manager.getLombokJar()\n          ? ` (lombok: ${manager.getLombokJar()?.split(\"/\").pop()})` : \"\";\n        setLspStatus(\"warning\", `LSP: auto-starting ${langs.join(\", \")}${lombokNote}...`);\n        manager.startEagerly(langs);\n      }\n    }\n  });\n\n  // Register all LSP tools\n  // Tools call getManager() lazily so they work even if session_start hasn't fired\n  const managerProxy = new Proxy({} as LspManager, {\n    get(_target, prop) {\n      return (getManager() as any)[prop];\n    },\n  });\n\n  const treeSitterProxy = new Proxy({} as TreeSitterManager, {\n    get(_target, prop) {\n      return (getTreeSitter() as any)[prop];\n    },\n  });\n\n  const workspaceIndexProxy = new Proxy({} as WorkspaceIndex, {\n    get(_target, prop) {\n      return (getWorkspaceIndex() as any)[prop];\n    },\n  });\n\n  pi.registerTool(createDiagnosticsTool(managerProxy, treeSitterProxy));\n  pi.registerTool(createHoverTool(managerProxy, treeSitterProxy));\n  pi.registerTool(createDefinitionTool(managerProxy, treeSitterProxy, workspaceIndexProxy));\n  pi.registerTool(createReferencesTool(managerProxy, treeSitterProxy));\n  pi.registerTool(createSymbolsTool(managerProxy, treeSitterProxy, workspaceIndexProxy));\n  pi.registerTool(createRenameTool(managerProxy, treeSitterProxy));\n  pi.registerTool(createCodeActionsTool(managerProxy, treeSitterProxy));\n  pi.registerTool(createCompletionsTool(managerProxy, {\n    getTrackedVersion: (uri) => getFileSync().getTrackedVersion(uri),\n    setTrackedVersion: (uri, v) => getFileSync().setTrackedVersion(uri, v),\n    isSyntheticDotActive: (uri) => syntheticDotLocks.has(uri),\n  }, treeSitterProxy));\n  const getRootDir = () => manager?.resolvePath(\".\") ?? process.cwd();\n  pi.registerTool(createCodeOverviewTool(getRootDir, treeSitterProxy, workspaceIndexProxy));\n  pi.registerTool(createCodeSearchTool(getRootDir, treeSitterProxy));\n  pi.registerTool(createCodeRewriteTool(getRootDir, treeSitterProxy, {\n    onFileModified: (filePath: string) => {\n      getFileSync().handleFileWrite(filePath).catch(() => {});\n    },\n  }));\n  pi.registerTool(createCodeActionsTool(managerProxy, treeSitterProxy));\n\n  // File sync: track file reads/writes/edits\n  // After writes/edits, append file-scoped error diagnostics to the tool result\n  pi.on(\"tool_result\", async (event) => {\n    const sync = getFileSync();\n\n    try {\n      if (isReadToolResult(event) && !event.isError) {\n        const path = (event.input as any)?.path;\n        if (path) await sync.handleFileRead(path);\n      }\n\n      if (isWriteToolResult(event) && !event.isError) {\n        const path = (event.input as any)?.path;\n        if (path) await sync.handleFileWrite(path);\n      }\n\n      if (isEditToolResult(event) && !event.isError) {\n        const path = (event.input as any)?.path;\n        if (path) await sync.handleFileWrite(path);\n      }\n    } catch {\n      // File sync errors are non-fatal\n    }\n\n    // Auto-append diagnostics for the changed file (write/edit only)\n    if ((isWriteToolResult(event) || isEditToolResult(event)) && !event.isError && manager) {\n      const path = (event.input as any)?.path;\n      if (!path) return;\n\n      const languageId = manager.getLanguageId(path);\n      if (!languageId) return;\n\n      // Check autoInjectDiagnostics config\n      const inject = projectConfig?.autoInjectDiagnostics;\n      if (inject === false) return;\n      if (Array.isArray(inject) && !inject.includes(languageId)) return;\n\n      const client = manager.getRunningClient(languageId);\n      if (!client) return;\n\n      // Wait briefly for the LSP to publish updated diagnostics\n      await new Promise((r) => setTimeout(r, DIAGNOSTIC_SETTLE_DELAY_MS));\n\n      const uri = manager.getFileUri(path);\n      const diagnostics = client.getDiagnostics(uri);\n      const errors = diagnostics.filter((d) => d.severity === DiagnosticSeverity.Error);\n\n      if (errors.length === 0) return;\n\n      // Build a compact summary — just errors, max 10 lines\n      const relPath = relative(manager.resolvePath(\".\"), manager.resolvePath(path));\n      const lines = errors.slice(0, 10).map((d) => {\n        const line = d.range.start.line + 1;\n        const col = d.range.start.character + 1;\n        const source = d.source ? ` [${d.source}]` : \"\";\n        return `${relPath}:${line}:${col} error: ${d.message}${source}`;\n      });\n      if (errors.length > 10) {\n        lines.push(`... and ${errors.length - 10} more error(s)`);\n      }\n\n      const summary = `\\n\\n⚠ LSP: ${errors.length} error(s) in ${relPath}:\\n${lines.join(\"\\n\")}`;\n\n      return {\n        content: [\n          ...event.content,\n          { type: \"text\" as const, text: summary },\n        ],\n      };\n    }\n  });\n\n  // Update status after tool execution ends\n  pi.on(\"tool_execution_end\", async (_event, ctx) => {\n    latestCtx = ctx;\n    if (!manager) return;\n    const statuses = manager.getStatus();\n    const running = statuses.filter((s) => s.running);\n    if (running.length === 0) {\n      ctx.ui.setStatus(\"lsp\", ctx.ui.theme.fg(\"dim\", \"LSP: idle\"));\n    } else {\n      const totalDiags = running.reduce((n, s) => n + s.diagnosticsCount, 0);\n      const langs = running.map((s) => s.languageId).join(\", \");\n      let status = `LSP: ${langs}`;\n      if (totalDiags > 0) {\n        status += ` (${totalDiags} diagnostic${totalDiags !== 1 ? \"s\" : \"\"})`;\n      }\n      ctx.ui.setStatus(\"lsp\", ctx.ui.theme.fg(\"accent\", status));\n    }\n  });\n\n  // /lsp command — show server status\n  pi.registerCommand(\"lsp\", {\n    description: \"Show LSP server status\",\n    handler: async (_args, ctx) => {\n      if (!manager) {\n        ctx.ui.notify(\"LSP manager not initialized\", \"warning\");\n        return;\n      }\n\n      const statuses = manager.getStatus();\n      if (statuses.length === 0) {\n        ctx.ui.notify(\"No LSP servers configured\", \"info\");\n        return;\n      }\n\n      const lines = statuses.map((s) => {\n        const icon = s.running ? \"🟢\" : \"⚪\";\n        const diags =\n          s.diagnosticsCount > 0 ? ` (${s.diagnosticsCount} diagnostics)` : \"\";\n        const shared = s.shared ? \" [shared]\" : \"\";\n        return `${icon} ${s.languageId}: ${s.command}${diags}${shared}`;\n      });\n\n      ctx.ui.notify(lines.join(\"\\n\"), \"info\");\n    },\n  });\n\n  // /lsp-restart command — restart a specific language server\n  pi.registerCommand(\"lsp-restart\", {\n    description: \"Restart an LSP server: /lsp-restart <language> (e.g. java, typescript)\",\n    handler: async (args, ctx) => {\n      if (!manager) {\n        ctx.ui.notify(\"LSP manager not initialized\", \"warning\");\n        return;\n      }\n\n      const languageId = args?.trim().toLowerCase();\n      if (!languageId) {\n        // Show running servers and usage\n        const statuses = manager.getStatus().filter((s) => s.running);\n        if (statuses.length === 0) {\n          ctx.ui.notify(\"No LSP servers are running.\\n\\nUsage: /lsp-restart <language>\", \"info\");\n        } else {\n          const langs = statuses.map((s) => s.languageId).join(\", \");\n          ctx.ui.notify(\n            `Running servers: ${langs}\\n\\nUsage: /lsp-restart <language>\\nExample: /lsp-restart java`,\n            \"info\"\n          );\n        }\n        return;\n      }\n\n      ctx.ui.setStatus(\"lsp\", ctx.ui.theme.fg(\"warning\", `LSP: restarting ${languageId}...`));\n      ctx.ui.notify(`Restarting ${languageId} server (kills daemon if shared)...`, \"info\");\n\n      try {\n        await manager.restartServer(languageId);\n        const lombokJar = languageId === \"java\" ? manager.getLombokJar() : null;\n        const lombokNote = lombokJar ? `\\nLombok: ${lombokJar}` : \"\";\n        ctx.ui.notify(`${languageId} server restarted successfully.${lombokNote}`, \"info\");\n        ctx.ui.setStatus(\"lsp\", ctx.ui.theme.fg(\"accent\", `LSP: ${languageId} ready`));\n      } catch (err: any) {\n        ctx.ui.notify(`Failed to restart ${languageId}: ${err.message}`, \"error\");\n        ctx.ui.setStatus(\"lsp\", ctx.ui.theme.fg(\"error\", `LSP: ${languageId} restart failed`));\n      }\n    },\n  });\n\n  // /lsp-config command — add or override server configuration\n  pi.registerCommand(\"lsp-config\", {\n    description:\n      \"Configure an LSP server: /lsp-config <language> <command> [args...]\",\n    handler: async (args, ctx) => {\n      if (!args?.trim()) {\n        ctx.ui.notify(\n          \"Usage: /lsp-config <language> <command> [args...]\\nExample: /lsp-config python pylsp\",\n          \"info\"\n        );\n        return;\n      }\n\n      const parts = args.trim().split(/\\s+/);\n      if (parts.length < 2) {\n        ctx.ui.notify(\n          \"Usage: /lsp-config <language> <command> [args...]\",\n          \"warning\"\n        );\n        return;\n      }\n\n      const [languageId, command, ...serverArgs] = parts;\n      const config: ServerConfig = { command, args: serverArgs };\n\n      getManager().setServerConfig(languageId, config);\n      ctx.ui.notify(\n        `Configured LSP for ${languageId}: ${command} ${serverArgs.join(\" \")}`,\n        \"info\"\n      );\n    },\n  });\n\n  // /lsp-lombok command — set Lombok jar path for Java\n  pi.registerCommand(\"lsp-lombok\", {\n    description:\n      \"Set Lombok jar path for Java: /lsp-lombok <path-to-lombok.jar>\",\n    handler: async (args, ctx) => {\n      const mgr = getManager();\n\n      if (!args?.trim()) {\n        const current = mgr.getLombokJar();\n        if (current) {\n          ctx.ui.notify(`Lombok jar: ${current}`, \"info\");\n        } else {\n          ctx.ui.notify(\n            \"No Lombok jar configured or detected.\\n\\n\" +\n            \"Usage: /lsp-lombok <path-to-lombok.jar>\\n\" +\n            \"Or set LOMBOK_JAR environment variable.\\n\\n\" +\n            \"Download from: https://projectlombok.org/download\",\n            \"info\"\n          );\n        }\n        return;\n      }\n\n      const jarPath = args.trim();\n      const { existsSync } = await import(\"node:fs\");\n      const { resolve } = await import(\"node:path\");\n      const resolved = resolve(ctx.cwd, jarPath);\n\n      if (!existsSync(resolved)) {\n        ctx.ui.notify(`File not found: ${resolved}`, \"error\");\n        return;\n      }\n\n      if (!resolved.endsWith(\".jar\")) {\n        ctx.ui.notify(`Warning: ${resolved} doesn't end in .jar — setting anyway`, \"warning\");\n      }\n\n      mgr.setLombokJar(resolved);\n      ctx.ui.notify(`Lombok jar set: ${resolved}`, \"info\");\n    },\n  });\n\n  // Clean shutdown (includes workspace provider, all LSP servers, and tree-sitter)\n  pi.on(\"session_shutdown\", async () => {\n    // Drop the captured ctx immediately — once shutdown fires, any late\n    // LSP manager callback that reaches setLspStatus/applyProvider would\n    // otherwise hit an invalidated ctx and throw an uncaught exception.\n    latestCtx = null;\n    if (manager) {\n      await manager.shutdownAll();\n      manager = null;\n      fileSync = null;\n    }\n    if (treeSitter) {\n      treeSitter.shutdown();\n      treeSitter = null;\n    }\n    workspaceIndex = null;\n  });\n}\n"]}