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

package/dist/src/tools/ast-edit/context-optimizer.js

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Context optimizer for snippet deduplication and context size management.
+ */
+import { ASTConfig } from './ast-config.js';
+/**
+ * Handles optimization of code context including snippet management and prompt clipping.
+ */
+export class ContextOptimizer {
+    /**
+     * Clip prompt to fit max length limit (corresponds to AST clip_prompt)
+     */
+    static clipPrompt(prompt, maxLength) {
+        if (prompt.length <= maxLength) {
+            return prompt;
+        }
+        // Clip from start, preserve newest content (AST strategy)
+        let start = prompt.length - maxLength;
+        while (!this.isCharBoundary(prompt, start)) {
+            start += 1;
+        }
+        return prompt.substring(start);
+    }
+    /**
+     * Check UTF-16 character boundary
+     */
+    static isCharBoundary(str, index) {
+        if (index <= 0)
+            return true;
+        if (index >= str.length)
+            return true;
+        // Check for low surrogate (0xDC00–0xDFFF)
+        const code = str.charCodeAt(index);
+        if (code >= 0xdc00 && code <= 0xdfff) {
+            // If previous character is high surrogate (0xD800–0xDBFF), this is not a boundary
+            const prevCode = str.charCodeAt(index - 1);
+            if (prevCode >= 0xd800 && prevCode <= 0xdbff) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Manage snippets by priority and budget (corresponds to AST snippet collection)
+     */
+    static optimizeSnippets(snippets, maxChars = ASTConfig.MAX_SNIPPET_CHARS) {
+        // 1. Sort by priority and relevance
+        const sortedSnippets = [...snippets].sort((a, b) => {
+            // Higher priority first
+            if (a.priority !== b.priority) {
+                return a.priority - b.priority;
+            }
+            // Same priority, sort by relevance
+            return b.relevance - a.relevance;
+        });
+        // 2. Select snippets within budget
+        const optimizedSnippets = [];
+        let usedChars = 0;
+        for (const snippet of sortedSnippets) {
+            const truncatedSnippet = this.truncateSnippet(snippet);
+            if (usedChars + truncatedSnippet.charLength > maxChars) {
+                break; // Budget exhausted
+            }
+            optimizedSnippets.push(truncatedSnippet);
+            usedChars += truncatedSnippet.charLength;
+        }
+        return optimizedSnippets;
+    }
+    /**
+     * Truncate overly long snippets
+     */
+    static truncateSnippet(snippet) {
+        if (snippet.text.length <= ASTConfig.SNIPPET_TRUNCATE_LENGTH) {
+            return snippet;
+        }
+        return {
+            ...snippet,
+            text: snippet.text.substring(0, ASTConfig.SNIPPET_TRUNCATE_LENGTH) + '...',
+            charLength: ASTConfig.SNIPPET_TRUNCATE_LENGTH + 3,
+        };
+    }
+}
+//# sourceMappingURL=context-optimizer.js.map

package/dist/src/tools/ast-edit/context-optimizer.js.map

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

package/dist/src/tools/ast-edit/cross-file-analyzer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cross-file relationship analyzer for symbol indexing and reference tracking.
+ */
+import type { Lang } from '@ast-grep/napi';
+import type { SymbolReference } from './types.js';
+/**
+ * Discovers workspace files for symbol indexing using fast-glob.
+ * @param workspaceRoot - The root directory to search
+ * @returns Array of absolute file paths
+ */
+export declare function getWorkspaceFiles(workspaceRoot: string): Promise<string[]>;
+/**
+ * Analyzes cross-file relationships for symbol tracking and import graph building.
+ */
+export declare class CrossFileRelationshipAnalyzer {
+    private symbolIndex;
+    /**
+     * @deprecated Symbol indexing is disabled by default due to performance issues.
+     * [CCR] Reason: Prefer on-demand queryViaFindInFiles to avoid OOM in large workspaces.
+     */
+    buildSymbolIndex(files: string[]): Promise<void>;
+    /**
+     * Find related symbols using ast-grep's findInFiles with strict concurrency and quantity limits.
+     * [CCR] Relation: Core logic for 'Lazy' context gathering.
+     * Reason: Replaces eager indexing with atomic, timed-out queries to maintain CLI speed.
+     */
+    findRelatedSymbols(symbolName: string, workspacePath: string, lang?: Lang | string): Promise<SymbolReference[]>;
+    private executeSymbolSearch;
+    private searchWithLang;
+    private searchAllLanguages;
+    private groupFilesByLanguage;
+    private searchLanguageGroups;
+    findRelatedFiles(filePath: string): Promise<string[]>;
+    private resolveImportPath;
+    private fileExists;
+    private fileExistsSync;
+}

package/dist/src/tools/ast-edit/cross-file-analyzer.js

@@ -0,0 +1,294 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cross-file relationship analyzer for symbol indexing and reference tracking.
+ */
+import { promises as fsPromises, accessSync } from 'fs';
+import * as path from 'path';
+import { findInFiles } from '@ast-grep/napi';
+import FastGlob from 'fast-glob';
+import { debugLogger } from '../../utils/debugLogger.js';
+import { LANGUAGE_MAP } from '../../utils/ast-grep-utils.js';
+import { ASTConfig } from './ast-config.js';
+import { ASTQueryExtractor } from './ast-query-extractor.js';
+import { detectLanguage, extractImports } from './language-analysis.js';
+const logger = debugLogger;
+function withTimeout(promise, ms) {
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new Error(`Timeout after ${ms}ms`));
+        }, ms);
+    });
+    return Promise.race([promise, timeoutPromise]).finally(() => {
+        clearTimeout(timeoutId);
+    });
+}
+/**
+ * Discovers workspace files for symbol indexing using fast-glob.
+ * @param workspaceRoot - The root directory to search
+ * @returns Array of absolute file paths
+ */
+export async function getWorkspaceFiles(workspaceRoot) {
+    // Cross-platform workspace file collection using fast-glob
+    try {
+        const patterns = ['**/*.ts', '**/*.js', '**/*.py'];
+        const files = await FastGlob(patterns, {
+            cwd: workspaceRoot,
+            absolute: true,
+            onlyFiles: true,
+            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**'],
+        });
+        return files.filter((file) => file.length > 0);
+    }
+    catch (error) {
+        logger.error(`Error discovering workspace files`, error);
+        return [];
+    }
+}
+/**
+ * Analyzes cross-file relationships for symbol tracking and import graph building.
+ */
+export class CrossFileRelationshipAnalyzer {
+    symbolIndex = new Map();
+    /**
+     * @deprecated Symbol indexing is disabled by default due to performance issues.
+     * [CCR] Reason: Prefer on-demand queryViaFindInFiles to avoid OOM in large workspaces.
+     */
+    async buildSymbolIndex(files) {
+        if (!ASTConfig.ENABLE_SYMBOL_INDEXING) {
+            return;
+        }
+        this.symbolIndex.clear();
+        for (const filePath of files) {
+            try {
+                const content = await fsPromises.readFile(filePath, 'utf-8');
+                const extractor = new ASTQueryExtractor();
+                const declarations = await extractor.extractDeclarations(filePath, content);
+                const imports = extractImports(content, detectLanguage(filePath));
+                // Build symbol index
+                for (const decl of declarations) {
+                    // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+                    if (!this.symbolIndex.has(decl.name)) {
+                        this.symbolIndex.set(decl.name, []);
+                    }
+                    this.symbolIndex.get(decl.name).push({
+                        type: 'definition',
+                        filePath,
+                        line: decl.line,
+                        column: decl.column,
+                    });
+                }
+                // Build import relationships
+                for (const imp of imports) {
+                    // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+                    for (const item of imp.items) {
+                        if (!this.symbolIndex.has(item)) {
+                            this.symbolIndex.set(item, []);
+                        }
+                        this.symbolIndex.get(item).push({
+                            type: 'import',
+                            filePath,
+                            line: imp.line,
+                            column: 0, // Default column for imports
+                            sourceModule: imp.module,
+                        });
+                    }
+                }
+            }
+            catch {
+                // File read failed - skip this import
+            }
+        }
+    }
+    /**
+     * Find related symbols using ast-grep's findInFiles with strict concurrency and quantity limits.
+     * [CCR] Relation: Core logic for 'Lazy' context gathering.
+     * Reason: Replaces eager indexing with atomic, timed-out queries to maintain CLI speed.
+     */
+    async findRelatedSymbols(symbolName, workspacePath, lang) {
+        const references = [];
+        try {
+            let workspaceTooLarge = false;
+            const queryPromise = this.executeSymbolSearch(symbolName, workspacePath, lang, references, () => {
+                workspaceTooLarge = true;
+            });
+            await withTimeout(queryPromise, ASTConfig.FIND_RELATED_TIMEOUT_MS);
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Workspace-size guard is set inside async search callbacks before this await resumes.
+            if (workspaceTooLarge)
+                return [];
+            if (references.length > 0)
+                return references;
+        }
+        catch (error) {
+            logger.warn(`findRelatedSymbols failed or timed out for symbol '${symbolName}' in workspace '${workspacePath}' (lang: ${lang ?? 'mixed'})`, error);
+        }
+        // Fallback to in-memory symbol index only if explicitly enabled
+        if (ASTConfig.ENABLE_SYMBOL_INDEXING) {
+            return this.symbolIndex.get(symbolName) ?? [];
+        }
+        return [];
+    }
+    async executeSymbolSearch(symbolName, workspacePath, lang, references, markWorkspaceTooLarge) {
+        if (lang) {
+            await this.searchWithLang(lang, workspacePath, symbolName, references);
+        }
+        else {
+            await this.searchAllLanguages(workspacePath, symbolName, references, markWorkspaceTooLarge);
+        }
+    }
+    async searchWithLang(lang, workspacePath, symbolName, references) {
+        await new Promise((resolve) => {
+            findInFiles(lang, {
+                paths: [workspacePath],
+                matcher: { rule: { pattern: symbolName } },
+            }, (err, matches) => {
+                if (err !== null || matches.length === 0) {
+                    resolve();
+                    return;
+                }
+                matches.slice(0, ASTConfig.MAX_RESULTS_PER_SYMBOL).forEach((m) => {
+                    const range = m.range();
+                    references.push({
+                        type: 'reference',
+                        filePath: m.getRoot().filename(),
+                        line: range.start.line + 1,
+                        column: range.start.column,
+                    });
+                });
+                resolve();
+            }).catch(() => resolve());
+        });
+    }
+    async searchAllLanguages(workspacePath, symbolName, references, markWorkspaceTooLarge) {
+        const filesByLanguage = new Map();
+        const files = await FastGlob(Object.keys(LANGUAGE_MAP).map((ext) => `**/*.${ext}`), {
+            cwd: workspacePath,
+            absolute: true,
+            onlyFiles: true,
+            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**'],
+        });
+        // [CCR] Relation: Workspace size guard.
+        // Reason: Prevent OOM in very large monorepos by aborting if file count exceeds limit.
+        if (files.length > ASTConfig.MAX_WORKSPACE_FILES) {
+            logger.warn(`Workspace has ${files.length} files, exceeding limit of ${ASTConfig.MAX_WORKSPACE_FILES}. Skipping cross-file symbol search for ${symbolName}.`);
+            markWorkspaceTooLarge();
+            return;
+        }
+        this.groupFilesByLanguage(files, filesByLanguage);
+        await this.searchLanguageGroups(filesByLanguage, symbolName, references);
+        if (references.length > ASTConfig.MAX_RESULTS_PER_SYMBOL) {
+            references.length = ASTConfig.MAX_RESULTS_PER_SYMBOL;
+        }
+    }
+    groupFilesByLanguage(files, filesByLanguage) {
+        for (const file of files) {
+            const extension = path.extname(file).substring(1);
+            const fileLang = LANGUAGE_MAP[extension];
+            // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+            if (fileLang) {
+                if (!filesByLanguage.has(fileLang)) {
+                    filesByLanguage.set(fileLang, new Set());
+                }
+                filesByLanguage.get(fileLang).add(file);
+            }
+        }
+    }
+    async searchLanguageGroups(filesByLanguage, symbolName, references) {
+        const promises = [];
+        for (const [searchLang, searchFiles] of filesByLanguage) {
+            const promise = new Promise((resolve) => {
+                findInFiles(searchLang, {
+                    paths: Array.from(searchFiles),
+                    matcher: { rule: { pattern: symbolName } },
+                }, (err, matches) => {
+                    // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+                    if (err !== null || matches.length === 0) {
+                        resolve();
+                        return;
+                    }
+                    matches.slice(0, ASTConfig.MAX_RESULTS_PER_SYMBOL).forEach((m) => {
+                        const range = m.range();
+                        references.push({
+                            type: 'reference',
+                            filePath: m.getRoot().filename(),
+                            line: range.start.line + 1,
+                            column: range.start.column,
+                        });
+                    });
+                    resolve();
+                }).catch(() => resolve());
+            });
+            promises.push(promise);
+        }
+        await Promise.all(promises);
+    }
+    async findRelatedFiles(filePath) {
+        try {
+            const content = await fsPromises.readFile(filePath, 'utf-8');
+            const imports = extractImports(content, detectLanguage(filePath));
+            const relatedFiles = new Set();
+            for (const imp of imports) {
+                // Resolve relative path
+                const resolvedPath = this.resolveImportPath(imp.module, filePath);
+                if (resolvedPath && (await this.fileExists(resolvedPath))) {
+                    relatedFiles.add(resolvedPath);
+                }
+            }
+            return Array.from(relatedFiles);
+        }
+        catch {
+            return [];
+        }
+    }
+    resolveImportPath(importModule, currentFilePath) {
+        try {
+            const dir = path.dirname(currentFilePath);
+            const resolved = path.resolve(dir, importModule);
+            // If the import already has an extension that exists, use it directly
+            if (path.extname(resolved) && this.fileExistsSync(resolved)) {
+                return resolved;
+            }
+            // Try common extensions
+            const extensions = ['.ts', '.js', '.tsx', '.jsx'];
+            for (const ext of extensions) {
+                const withExt = resolved + ext;
+                if (this.fileExistsSync(withExt)) {
+                    return withExt;
+                }
+            }
+            // Try index files
+            for (const ext of extensions) {
+                const indexPath = path.join(resolved, `index${ext}`);
+                if (this.fileExistsSync(indexPath)) {
+                    return indexPath;
+                }
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async fileExists(filePath) {
+        try {
+            await fsPromises.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    fileExistsSync(filePath) {
+        try {
+            accessSync(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=cross-file-analyzer.js.map

package/dist/src/tools/ast-edit/cross-file-analyzer.js.map

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

package/dist/src/tools/ast-edit/edit-calculator.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Edit calculation logic for ast-edit tool.
+ * Contains calculateEdit, validation, and helper functions.
+ */
+import type { IToolHost } from '../../interfaces/index.js';
+import type { ASTEditToolParams } from './types.js';
+import { ToolErrorType } from '../../types/tool-error.js';
+/**
+ * Result of edit calculation, including validation and freshness checks.
+ */
+export interface CalculatedEdit {
+    currentContent: string | null;
+    newContent: string;
+    occurrences: number;
+    error?: {
+        display: string;
+        raw: string;
+        type: ToolErrorType;
+    };
+    isNewFile: boolean;
+    astValidation?: {
+        valid: boolean;
+        errors: string[];
+    };
+    fileFreshness?: number | null;
+}
+/**
+ * Calculates the edit to be applied, including validation and freshness checks.
+ *
+ * @param params - Edit parameters
+ * @param host - Tool host interface
+ * @param _abortSignal - Abort signal (currently unused)
+ * @returns Calculated edit result with validation info
+ */
+export declare function calculateEdit(params: ASTEditToolParams, host: IToolHost, _abortSignal: AbortSignal): Promise<CalculatedEdit>;
+/**
+ * Counts occurrences that will be replaced (0 or 1).
+ * Returns 0/1 not true count, aligned with String.replace() single-replacement semantics.
+ *
+ * @param content - File content
+ * @param searchString - String to search for
+ * @returns 0 if not found, 1 if found
+ */
+export declare function countOccurrences(content: string, searchString: string): number;
+/**
+ * Validates AST syntax for the given file path and content.
+ * Inspects the tree-sitter parse tree for ERROR nodes and zero-width
+ * phantom nodes (MISSING tokens inserted by error recovery) rather than
+ * relying on thrown exceptions (tree-sitter is error-recovering and
+ * never throws on syntax errors).
+ *
+ * @param filePath - File path (used to detect language)
+ * @param content - File content to validate
+ * @returns Validation result
+ */
+export declare function validateASTSyntax(filePath: string, content: string): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Gets the last modified timestamp of a file.
+ * Returns null if file doesn't exist.
+ *
+ * @param filePath - Path to the file
+ * @returns Timestamp in milliseconds or null
+ */
+export declare function getFileLastModified(filePath: string): Promise<number | null>;