@vybestack/llxprt-code-tools 0.10.0-nightly.260613.1adad3b34

package/dist/src/utils/gitLineChanges.js

@@ -0,0 +1,171 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { spawn } from 'child_process';
+import { existsSync } from 'node:fs';
+import path from 'path';
+const DEFAULT_GIT_COMMAND_TIMEOUT_MS = 30_000;
+function runGit(args, cwd, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('git', args, {
+            cwd,
+            windowsHide: true,
+        });
+        const timeoutMs = options?.timeoutMs ?? DEFAULT_GIT_COMMAND_TIMEOUT_MS;
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let settled = false;
+        const settle = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            child.removeAllListeners();
+            child.stdout.removeAllListeners();
+            child.stderr.removeAllListeners();
+            fn();
+        };
+        const timer = setTimeout(() => {
+            try {
+                child.kill();
+            }
+            finally {
+                settle(() => reject(new Error(`git command timed out after ${timeoutMs}ms: git ${args.join(' ')}`)));
+            }
+        }, timeoutMs);
+        child.stdout.on('data', (chunk) => stdoutChunks.push(chunk));
+        child.stderr.on('data', (chunk) => stderrChunks.push(chunk));
+        child.on('error', (err) => settle(() => reject(new Error(`Failed to start git: ${err.message}`))));
+        child.on('close', (code) => {
+            const stdout = Buffer.concat(stdoutChunks).toString('utf8');
+            const stderr = Buffer.concat(stderrChunks).toString('utf8').trim();
+            if (code === 0) {
+                settle(() => resolve(stdout));
+                return;
+            }
+            settle(() => reject(new Error(stderr || `git exited with code ${code}`)));
+        });
+    });
+}
+function findGitRoot(startDir) {
+    let current = path.resolve(startDir);
+    while (true) {
+        if (existsSync(path.join(current, '.git')))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+async function fileExistsInHead(relToGitRoot, gitRoot) {
+    try {
+        await runGit(['cat-file', '-e', `HEAD:${relToGitRoot}`], gitRoot);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function parseUnifiedZeroDiff(diffText) {
+    const markersByLine = new Map();
+    const deletionAfterLines = new Set();
+    const lines = diffText.split(/\r?\n/);
+    const hunkHeaderRe = /^@@\s+-(\d+)(?:,(\d+))?\s+\+(\d+)(?:,(\d+))?\s+@@/;
+    for (const line of lines) {
+        const m = hunkHeaderRe.exec(line);
+        if (!m)
+            continue;
+        const oldCount = m[2] ? Number(m[2]) : 1;
+        const newStart = Number(m[3]);
+        const newCount = m[4] ? Number(m[4]) : 1;
+        if (oldCount === 0) {
+            for (let i = 0; i < newCount; i++) {
+                markersByLine.set(newStart + i, 'N');
+            }
+            continue;
+        }
+        if (newCount === 0 && oldCount > 0) {
+            const oldStart = Number(m[1]);
+            deletionAfterLines.add(Math.max(0, oldStart - 1));
+            continue;
+        }
+        if (oldCount > 0 && newCount > 0) {
+            for (let i = 0; i < newCount; i++) {
+                markersByLine.set(newStart + i, 'M');
+            }
+            if (oldCount > newCount) {
+                deletionAfterLines.add(newStart + newCount - 1);
+            }
+        }
+    }
+    return { markersByLine, deletionAfterLines };
+}
+function buildUntrackedFileResult(relToGitRoot, gitRoot) {
+    return runGit(['show', `:${relToGitRoot}`], gitRoot)
+        .catch(() => '')
+        .then((content) => {
+        if (content === '') {
+            return {
+                markersByLine: new Map(),
+                deletionAfterLines: new Set(),
+                warning: 'File is not present in HEAD (untracked), but failed to read its content from git index',
+            };
+        }
+        const normalizedContent = content.replace(/\r?\n$/, '');
+        const lineCount = normalizedContent === '' ? 0 : normalizedContent.split(/\r?\n/).length;
+        const markersByLine = new Map();
+        for (let i = 1; i <= lineCount; i++) {
+            markersByLine.set(i, 'N');
+        }
+        return {
+            markersByLine,
+            deletionAfterLines: new Set(),
+            warning: 'File is not present in HEAD (untracked); marked all lines as new',
+        };
+    });
+}
+export async function getGitLineChanges(absolutePath) {
+    try {
+        if (!path.isAbsolute(absolutePath)) {
+            return {
+                markersByLine: new Map(),
+                deletionAfterLines: new Set(),
+                warning: `Path is not absolute: ${absolutePath}`,
+            };
+        }
+        const fileDir = path.dirname(absolutePath);
+        const gitRoot = findGitRoot(fileDir);
+        if (!gitRoot) {
+            return {
+                markersByLine: new Map(),
+                deletionAfterLines: new Set(),
+                warning: 'Not a git repository',
+            };
+        }
+        const relToGitRoot = path.relative(gitRoot, absolutePath);
+        const diffText = await runGit(['diff', '--no-color', '--unified=0', 'HEAD', '--', relToGitRoot], gitRoot);
+        if (diffText.trim() === '') {
+            const existsInHead = await fileExistsInHead(relToGitRoot, gitRoot);
+            if (!existsInHead) {
+                return await buildUntrackedFileResult(relToGitRoot, gitRoot);
+            }
+        }
+        const parsed = parseUnifiedZeroDiff(diffText);
+        return {
+            markersByLine: parsed.markersByLine,
+            deletionAfterLines: parsed.deletionAfterLines,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            markersByLine: new Map(),
+            deletionAfterLines: new Set(),
+            warning: msg,
+        };
+    }
+}
+//# sourceMappingURL=gitLineChanges.js.map

package/dist/src/utils/gitLineChanges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitLineChanges.js","sourceRoot":"","sources":["../../../src/utils/gitLineChanges.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,MAAM,CAAC;AAUxB,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAE9C,SAAS,MAAM,CACb,IAAc,EACd,GAAW,EACX,OAAgC;IAEhC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE;YAC/B,GAAG;YACH,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,8BAA8B,CAAC;QACvE,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,EAAc,EAAE,EAAE;YAChC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,CAAC,kBAAkB,EAAE,CAAC;YAC3B,KAAK,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAClC,KAAK,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAClC,EAAE,EAAE,CAAC;QACP,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,CAAC;oBAAS,CAAC;gBACT,MAAM,CAAC,GAAG,EAAE,CACV,MAAM,CACJ,IAAI,KAAK,CACP,+BAA+B,SAAS,WAAW,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACpE,CACF,CACF,CAAC;YACJ,CAAC;QACH,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAE7D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CACxB,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CACvE,CAAC;QAEF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAEnE,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC9B,OAAO;YACT,CAAC;YAED,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,wBAAwB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,OAAO,CAAC;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,SAAS,CAAC;QACzC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,YAAoB,EACpB,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,YAAY,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAgB;IAI5C,MAAM,aAAa,GAAG,IAAI,GAAG,EAA6C,CAAC;IAC3E,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,mDAAmD,CAAC;IAEzE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,CAAC;YAAE,SAAS;QAEjB,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzC,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;gBAClC,aAAa,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;YACvC,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;gBAClC,aAAa,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;YACvC,CAAC;YACD,IAAI,QAAQ,GAAG,QAAQ,EAAE,CAAC;gBACxB,kBAAkB,CAAC,GAAG,CAAC,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,wBAAwB,CAC/B,YAAoB,EACpB,OAAe;IAEf,OAAO,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC,EAAE,OAAO,CAAC;SACjD,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;SACf,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAChB,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACnB,OAAO;gBACL,aAAa,EAAE,IAAI,GAAG,EAAE;gBACxB,kBAAkB,EAAE,IAAI,GAAG,EAAE;gBAC7B,OAAO,EACL,wFAAwF;aAC3F,CAAC;QACJ,CAAC;QAED,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,SAAS,GACb,iBAAiB,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QACzE,MAAM,aAAa,GAAG,IAAI,GAAG,EAG1B,CAAC;QACJ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO;YACL,aAAa;YACb,kBAAkB,EAAE,IAAI,GAAG,EAAE;YAC7B,OAAO,EACL,kEAAkE;SACrE,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,YAAoB;IAEpB,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACnC,OAAO;gBACL,aAAa,EAAE,IAAI,GAAG,EAAE;gBACxB,kBAAkB,EAAE,IAAI,GAAG,EAAE;gBAC7B,OAAO,EAAE,yBAAyB,YAAY,EAAE;aACjD,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,aAAa,EAAE,IAAI,GAAG,EAAE;gBACxB,kBAAkB,EAAE,IAAI,GAAG,EAAE;gBAC7B,OAAO,EAAE,sBAAsB;aAChC,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAC3B,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,EACjE,OAAO,CACR,CAAC;QAEF,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3B,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACnE,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO,MAAM,wBAAwB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAC9C,OAAO;YACL,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;SAC9C,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO;YACL,aAAa,EAAE,IAAI,GAAG,EAAE;YACxB,kBAAkB,EAAE,IAAI,GAAG,EAAE;YAC7B,OAAO,EAAE,GAAG;SACb,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/utils/gitUtils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function isGitRepository(directory: string): boolean;

package/dist/src/utils/gitUtils.js

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export function isGitRepository(directory) {
+    try {
+        let currentDir = path.resolve(directory);
+        let searching = true;
+        while (searching) {
+            const gitDir = path.join(currentDir, '.git');
+            if (fs.existsSync(gitDir)) {
+                return true;
+            }
+            const parentDir = path.dirname(currentDir);
+            if (parentDir === currentDir) {
+                searching = false;
+            }
+            if (searching) {
+                currentDir = parentDir;
+            }
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=gitUtils.js.map

package/dist/src/utils/gitUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitUtils.js","sourceRoot":"","sources":["../../../src/utils/gitUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,IAAI,CAAC;QACH,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEzC,IAAI,SAAS,GAAG,IAAI,CAAC;QACrB,OAAO,SAAS,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAC7C,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC3C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;gBAC7B,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;YAED,IAAI,SAAS,EAAE,CAAC;gBACd,UAAU,GAAG,SAAS,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/src/utils/lsp-diagnostics-helper.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ILspService, IToolHost } from '../interfaces/index.js';
+/**
+ * Collects LSP diagnostics for a file and formats them for LLM consumption.
+ *
+ * @plan PLAN-20250212-LSP.P31
+ * @requirement REQ-DIAG-010
+ *
+ * This helper:
+ * - Checks if LSP client is alive
+ * - Calls checkFile() with a timeout to prevent hangs
+ * - Filters diagnostics by configured severities
+ * - Limits diagnostics per maxDiagnosticsPerFile
+ * - Formats with <diagnostics> XML tags
+ * - Returns null if no diagnostics or LSP unavailable
+ *
+ * The caller should wrap this in try-catch to satisfy REQ-GRACE-050/055.
+ *
+ * @param config - The Config instance to get LSP client and settings
+ * @param absolutePath - The absolute path of the file to check
+ * @returns Formatted diagnostics block or null if none
+ */
+export declare function collectLspDiagnosticsBlock(lspService: ILspService, host: IToolHost, absolutePath: string): Promise<string | null>;

package/dist/src/utils/lsp-diagnostics-helper.js

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import path from 'path';
+/**
+ * Timeout for LSP diagnostics collection to prevent hanging on unresponsive LSP servers.
+ */
+const LSP_DIAGNOSTICS_TIMEOUT_MS = 5000;
+/**
+ * Collects LSP diagnostics for a file and formats them for LLM consumption.
+ *
+ * @plan PLAN-20250212-LSP.P31
+ * @requirement REQ-DIAG-010
+ *
+ * This helper:
+ * - Checks if LSP client is alive
+ * - Calls checkFile() with a timeout to prevent hangs
+ * - Filters diagnostics by configured severities
+ * - Limits diagnostics per maxDiagnosticsPerFile
+ * - Formats with <diagnostics> XML tags
+ * - Returns null if no diagnostics or LSP unavailable
+ *
+ * The caller should wrap this in try-catch to satisfy REQ-GRACE-050/055.
+ *
+ * @param config - The Config instance to get LSP client and settings
+ * @param absolutePath - The absolute path of the file to check
+ * @returns Formatted diagnostics block or null if none
+ */
+export async function collectLspDiagnosticsBlock(lspService, host, absolutePath) {
+    const diagnostics = await lspService.waitForDiagnostics(absolutePath, LSP_DIAGNOSTICS_TIMEOUT_MS);
+    const lspConfig = lspService.getLspConfig();
+    const includeSeverities = lspConfig?.includeSeverities ?? ['error'];
+    const filtered = diagnostics.filter((d) => includeSeverities.includes(d.severity));
+    if (filtered.length === 0) {
+        return null;
+    }
+    const maxPerFile = lspConfig?.maxDiagnosticsPerFile ?? 20;
+    const relPath = path.relative(host.getTargetDir(), absolutePath);
+    const limited = filtered
+        .sort((a, b) => {
+        const lineDiff = (a.line ?? 0) - (b.line ?? 0);
+        return lineDiff !== 0 ? lineDiff : (a.column ?? 0) - (b.column ?? 0);
+    })
+        .slice(0, maxPerFile);
+    // Build severity-reflective header based on actual severities present
+    const severitiesPresent = [...new Set(limited.map((d) => d.severity))];
+    const severityLabel = severitiesPresent.length === 1 ? `${severitiesPresent[0]}s` : 'diagnostics';
+    const diagLines = limited
+        .map((d) => {
+        const codeStr = d.code !== undefined ? ` (${d.code})` : '';
+        return `${d.severity.toUpperCase()} [${d.line ?? 1}:${d.column ?? 1}] ${d.message}${codeStr}`;
+    })
+        .join('\n');
+    const suffix = filtered.length > maxPerFile
+        ? `\n... and ${filtered.length - maxPerFile} more`
+        : '';
+    // Return without leading \n\n - caller uses join('\n\n') to separate parts
+    return `LSP ${severityLabel} detected in this file, please fix:\n<diagnostics file="${relPath}">\n${diagLines}${suffix}\n</diagnostics>`;
+}
+//# sourceMappingURL=lsp-diagnostics-helper.js.map

package/dist/src/utils/lsp-diagnostics-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-diagnostics-helper.js","sourceRoot":"","sources":["../../../src/utils/lsp-diagnostics-helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;GAEG;AACH,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAExC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAAuB,EACvB,IAAe,EACf,YAAoB;IAEpB,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,kBAAkB,CACrD,YAAY,EACZ,0BAA0B,CAC3B,CAAC;IAEF,MAAM,SAAS,GAAG,UAAU,CAAC,YAAY,EAAE,CAAC;IAE5C,MAAM,iBAAiB,GAAG,SAAS,EAAE,iBAAiB,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACxC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CACvC,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,SAAS,EAAE,qBAAqB,IAAI,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,YAAY,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,QAAQ;SACrB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QAC/C,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAExB,sEAAsE;IACtE,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,aAAa,GACjB,iBAAiB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC;IAE9E,MAAM,SAAS,GAAG,OAAO;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,OAAO,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;IAChG,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,MAAM,GACV,QAAQ,CAAC,MAAM,GAAG,UAAU;QAC1B,CAAC,CAAC,aAAa,QAAQ,CAAC,MAAM,GAAG,UAAU,OAAO;QAClD,CAAC,CAAC,EAAE,CAAC;IAET,2EAA2E;IAC3E,OAAO,OAAO,aAAa,2DAA2D,OAAO,OAAO,SAAS,GAAG,MAAM,kBAAkB,CAAC;AAC3I,CAAC"}

package/dist/src/utils/mediaUtils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P05
+ * @requirement:REQ-API-001, REQ-TEMPORARY-INTERFACES
+ */
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Package-local media classification utilities.
+ *
+ * Provides media block classification using a package-local MediaBlock
+ * type instead of importing from core. Self-contained with zero core imports.
+ */
+/** Package-local media block representation. */
+export interface MediaBlock {
+    /** Media block discriminator. */
+    type?: 'media';
+    /** MIME type of the media. */
+    mimeType: string;
+    /** Base64-encoded data or URL. */
+    data?: string;
+    /** Whether data is a URL or base64. */
+    encoding?: 'url' | 'base64';
+    /** Optional caption or alt text. */
+    caption?: string;
+    /** Original filename if applicable. */
+    filename?: string;
+}
+/** Category of media content. */
+export type MediaCategory = 'image' | 'pdf' | 'audio' | 'video' | 'unknown';
+/**
+ * Classifies a media block by its MIME type.
+ * @param media - The media block to classify.
+ * @returns The media category.
+ */
+export declare function classifyMediaBlock(media: MediaBlock): MediaCategory;

package/dist/src/utils/mediaUtils.js

@@ -0,0 +1,22 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P05
+ * @requirement:REQ-API-001, REQ-TEMPORARY-INTERFACES
+ */
+/**
+ * Classifies a media block by its MIME type.
+ * @param media - The media block to classify.
+ * @returns The media category.
+ */
+export function classifyMediaBlock(media) {
+    const mime = media.mimeType.toLowerCase();
+    if (mime.startsWith('image/'))
+        return 'image';
+    if (mime === 'application/pdf')
+        return 'pdf';
+    if (mime.startsWith('audio/'))
+        return 'audio';
+    if (mime.startsWith('video/'))
+        return 'video';
+    return 'unknown';
+}
+//# sourceMappingURL=mediaUtils.js.map

package/dist/src/utils/mediaUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaUtils.js","sourceRoot":"","sources":["../../../src/utils/mediaUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkCH;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,IAAI,KAAK,iBAAiB;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/utils/pathValidation.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function isPathWithinWorkspace(workspaceRoots: readonly string[], inputPath: string): boolean;
+export declare function validatePathWithinWorkspace(workspaceRoots: readonly string[], inputPath: string, pathTypeLabel?: string): string | null;

package/dist/src/utils/pathValidation.js

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+function normalizeWorkspacePath(candidatePath) {
+    const resolvedPath = path.resolve(candidatePath);
+    try {
+        return fs.realpathSync.native(resolvedPath);
+    }
+    catch {
+        const parentPath = path.dirname(resolvedPath);
+        if (parentPath === resolvedPath) {
+            return resolvedPath;
+        }
+        const normalizedParent = normalizeWorkspacePath(parentPath);
+        return path.join(normalizedParent, path.basename(resolvedPath));
+    }
+}
+export function isPathWithinWorkspace(workspaceRoots, inputPath) {
+    const resolvedInput = normalizeWorkspacePath(inputPath);
+    return workspaceRoots.some((root) => {
+        const resolvedRoot = normalizeWorkspacePath(root);
+        const relative = path.relative(resolvedRoot, resolvedInput);
+        return (relative === '' ||
+            (!relative.startsWith(`..${path.sep}`) &&
+                relative !== '..' &&
+                !path.isAbsolute(relative)));
+    });
+}
+export function validatePathWithinWorkspace(workspaceRoots, inputPath, pathTypeLabel = 'File path') {
+    if (isPathWithinWorkspace(workspaceRoots, inputPath)) {
+        return null;
+    }
+    return `${pathTypeLabel} must be within one of the workspace directories: ${workspaceRoots.join(', ')}`;
+}
+//# sourceMappingURL=pathValidation.js.map

package/dist/src/utils/pathValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathValidation.js","sourceRoot":"","sources":["../../../src/utils/pathValidation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,SAAS,sBAAsB,CAAC,aAAqB;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC9C,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;YAChC,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,cAAiC,EACjC,SAAiB;IAEjB,MAAM,aAAa,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACxD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QAClC,MAAM,YAAY,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QAC5D,OAAO,CACL,QAAQ,KAAK,EAAE;YACf,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;gBACpC,QAAQ,KAAK,IAAI;gBACjB,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAC9B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,cAAiC,EACjC,SAAiB,EACjB,gBAAwB,WAAW;IAEnC,IAAI,qBAAqB,CAAC,cAAc,EAAE,SAAS,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,aAAa,qDAAqD,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1G,CAAC"}

package/dist/src/utils/paths.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function shortenPath(filePath: string, maxLen?: number): string;
+export declare function makeRelative(targetPath: string, rootDirectory: string): string;

package/dist/src/utils/paths.js

@@ -0,0 +1,158 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import path from 'node:path';
+function simpleTruncate(filePath, maxLen) {
+    const keepLen = Math.floor((maxLen - 3) / 2);
+    if (keepLen <= 0) {
+        return filePath.substring(0, maxLen - 3) + '...';
+    }
+    const start = filePath.substring(0, keepLen);
+    const end = filePath.substring(filePath.length - keepLen);
+    return `${start}...${end}`;
+}
+function truncateComponent(component, targetLength, mode) {
+    if (component.length <= targetLength)
+        return component;
+    if (targetLength <= 0)
+        return '';
+    if (targetLength <= 3) {
+        if (mode === 'end')
+            return component.slice(-targetLength);
+        return component.slice(0, targetLength);
+    }
+    if (mode === 'start') {
+        return `${component.slice(0, targetLength - 3)}...`;
+    }
+    if (mode === 'end') {
+        return `...${component.slice(component.length - (targetLength - 3))}`;
+    }
+    const front = Math.ceil((targetLength - 3) / 2);
+    const back = targetLength - 3 - front;
+    return `${component.slice(0, front)}...${component.slice(component.length - back)}`;
+}
+function trailingFallback(root, separator, lastSegment, maxLen, filePath) {
+    const ellipsisTail = `...${separator}${lastSegment}`;
+    if (ellipsisTail.length <= maxLen)
+        return ellipsisTail;
+    if (root) {
+        const rootEllipsisTail = `${root}...${separator}${lastSegment}`;
+        if (rootEllipsisTail.length <= maxLen)
+            return rootEllipsisTail;
+    }
+    if (root && `${root}${lastSegment}`.length <= maxLen) {
+        return `${root}${lastSegment}`;
+    }
+    if (lastSegment.length <= maxLen)
+        return lastSegment;
+    return simpleTruncate(filePath, maxLen);
+}
+function computeEndPartSegments(segments, startComponent, separator, maxLen) {
+    const lastSegment = segments[segments.length - 1];
+    const endPartSegments = [lastSegment];
+    let endPartLength = lastSegment.length;
+    for (let i = segments.length - 2; i > 0; i--) {
+        const segment = segments[i];
+        const newLength = startComponent.length +
+            separator.length +
+            3 +
+            separator.length +
+            endPartLength +
+            separator.length +
+            segment.length;
+        if (newLength <= maxLen) {
+            endPartSegments.unshift(segment);
+            endPartLength += separator.length + segment.length;
+        }
+        else {
+            break;
+        }
+    }
+    return endPartSegments;
+}
+function computeBudgets(components, minLengths, availableForComponents) {
+    const budgets = components.map((component) => component.length);
+    let currentTotal = budgets.reduce((sum, len) => sum + len, 0);
+    while (currentTotal > availableForComponents) {
+        let bestIndex = -1;
+        let bestScore = -Infinity;
+        for (let i = 0; i < budgets.length; i++) {
+            if (budgets[i] <= minLengths[i])
+                continue;
+            const isLast = i === budgets.length - 1;
+            const score = (isLast ? 0 : 1_000_000) + budgets[i];
+            if (score > bestScore) {
+                bestScore = score;
+                bestIndex = i;
+            }
+        }
+        if (bestIndex === -1)
+            return null;
+        budgets[bestIndex]--;
+        currentTotal--;
+    }
+    return budgets;
+}
+export function shortenPath(filePath, maxLen = 35) {
+    if (filePath.length <= maxLen) {
+        return filePath;
+    }
+    const parsedPath = path.parse(filePath);
+    const root = parsedPath.root;
+    const separator = path.sep;
+    const relativePath = filePath.substring(root.length);
+    const segments = relativePath.split(separator).filter((s) => s !== '');
+    if (segments.length <= 1) {
+        return simpleTruncate(filePath, maxLen);
+    }
+    const firstDir = segments[0];
+    const lastSegment = segments[segments.length - 1];
+    const startComponent = root + firstDir;
+    const endPartSegments = computeEndPartSegments(segments, startComponent, separator, maxLen);
+    const components = [firstDir, ...endPartSegments];
+    const componentModes = components.map((_, index) => {
+        if (index === 0)
+            return 'start';
+        if (index === components.length - 1)
+            return 'end';
+        return 'center';
+    });
+    const separatorsCount = endPartSegments.length + 1;
+    const fixedLen = root.length + separatorsCount * separator.length + 3;
+    const availableForComponents = maxLen - fixedLen;
+    if (availableForComponents <= 0) {
+        return trailingFallback(root, separator, lastSegment, maxLen, filePath);
+    }
+    const minLengths = components.map((component, index) => {
+        if (index === 0)
+            return Math.min(component.length, 1);
+        if (index === components.length - 1)
+            return component.length;
+        return Math.min(component.length, 1);
+    });
+    const minTotal = minLengths.reduce((sum, len) => sum + len, 0);
+    if (availableForComponents < minTotal) {
+        return trailingFallback(root, separator, lastSegment, maxLen, filePath);
+    }
+    const budgets = computeBudgets(components, minLengths, availableForComponents);
+    if (budgets === null) {
+        return trailingFallback(root, separator, lastSegment, maxLen, filePath);
+    }
+    const truncatedComponents = components.map((component, index) => truncateComponent(component, budgets[index], componentModes[index]));
+    const truncatedFirst = truncatedComponents[0];
+    const truncatedEnd = truncatedComponents.slice(1).join(separator);
+    const result = `${root}${truncatedFirst}${separator}...${separator}${truncatedEnd}`;
+    if (result.length > maxLen) {
+        return trailingFallback(root, separator, lastSegment, maxLen, filePath);
+    }
+    return result;
+}
+export function makeRelative(targetPath, rootDirectory) {
+    const resolvedTargetPath = path.resolve(targetPath);
+    const resolvedRootDirectory = path.resolve(rootDirectory);
+    const relativePath = path.relative(resolvedRootDirectory, resolvedTargetPath);
+    return relativePath || '.';
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/utils/paths.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/resolveTextSearchTarget.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type ResolvedSearchTarget = {
+    readonly kind: 'all-workspaces';
+} | {
+    readonly kind: 'directory';
+    readonly searchDir: string;
+} | {
+    readonly kind: 'file';
+    readonly filePath: string;
+    readonly parentDir: string;
+    readonly basename: string;
+};
+export declare function resolveTextSearchTarget(targetDir: string, workspaceRoots: readonly string[], relativePath?: string): ResolvedSearchTarget;