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

package/dist/src/tools/ast-edit/edit-calculator.js

@@ -0,0 +1,249 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Edit calculation logic for ast-edit tool.
+ * Contains calculateEdit, validation, and helper functions.
+ */
+/* eslint-disable complexity, sonarjs/cognitive-complexity -- Phase 5: legacy core boundary retained while larger decomposition continues. */
+import { promises as fsPromises } from 'fs';
+import * as path from 'path';
+import { parse } from '@ast-grep/napi';
+import { ToolErrorType } from '../../types/tool-error.js';
+import { isNodeError } from '../../utils/errors.js';
+import { LANGUAGE_MAP } from '../../utils/ast-grep-utils.js';
+import { applyReplacement } from './edit-helpers.js';
+/**
+ * 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 async function calculateEdit(params, host, _abortSignal) {
+    // Normalize all string parameters to LF for consistent matching
+    const normalizedOldString = params.old_string.replace(/\r\n/g, '\n');
+    const normalizedNewString = params.new_string.replace(/\r\n/g, '\n');
+    const { currentContent, fileExists } = await readFileState(params, host);
+    // Freshness Check (moved before old_string validation to ensure it runs first)
+    const currentMtime = await getFileLastModified(params.file_path);
+    const freshnessError = checkFreshness(params, currentMtime, fileExists, currentContent);
+    if (freshnessError) {
+        return freshnessError;
+    }
+    const { occurrences, error, isNewFile } = validateEditParams(params, currentContent, fileExists, normalizedOldString, normalizedNewString);
+    const newContent = !error
+        ? applyReplacement(currentContent, normalizedOldString, normalizedNewString, isNewFile)
+        : (currentContent ?? '');
+    const noChangeError = checkNoChange(error, fileExists, currentContent, newContent, params.file_path);
+    let astValidation;
+    if (!noChangeError) {
+        astValidation = validateASTSyntax(params.file_path, newContent);
+    }
+    return {
+        currentContent,
+        newContent,
+        occurrences,
+        error: noChangeError,
+        isNewFile,
+        astValidation,
+        fileFreshness: currentMtime,
+    };
+}
+async function readFileState(params, host) {
+    let currentContent = null;
+    let fileExists = false;
+    try {
+        const fileSystemService = host.getFileSystemService?.();
+        currentContent = fileSystemService?.readTextFile
+            ? await fileSystemService.readTextFile(params.file_path)
+            : await fsPromises.readFile(params.file_path, 'utf-8');
+        currentContent = currentContent.replace(/\r\n/g, '\n');
+        fileExists = true;
+    }
+    catch (err) {
+        if (!isNodeError(err) || err.code !== 'ENOENT') {
+            throw err;
+        }
+        fileExists = false;
+    }
+    return { currentContent, fileExists };
+}
+function checkFreshness(params, currentMtime, fileExists, currentContent) {
+    if (
+    // eslint-disable-next-line sonarjs/expression-complexity -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+    params.last_modified != null &&
+        ((fileExists && currentMtime == null) ||
+            (currentMtime != null && currentMtime > params.last_modified))) {
+        return {
+            currentContent,
+            newContent: currentContent ?? '',
+            occurrences: 0,
+            error: {
+                display: `File has been modified since it was last read. Please read the file again to get the latest content.`,
+                raw: JSON.stringify({
+                    message: `File ${params.file_path} mismatch. Expected mtime <= ${params.last_modified}, but found ${currentMtime}.`,
+                    current_mtime: currentMtime,
+                    your_mtime: params.last_modified,
+                }),
+                type: ToolErrorType.FILE_MODIFIED_CONFLICT,
+            },
+            isNewFile: false,
+            astValidation: undefined,
+            fileFreshness: currentMtime,
+        };
+    }
+    return undefined;
+}
+function validateEditParams(params, currentContent, fileExists, normalizedOldString, normalizedNewString) {
+    let occurrences = 0;
+    let error = undefined;
+    let isNewFile = false;
+    if (params.old_string === '' && !fileExists) {
+        isNewFile = true;
+    }
+    else if (!fileExists) {
+        error = {
+            display: `File not found. Cannot apply edit. Use an empty old_string to create a new file.`,
+            raw: `File not found: ${params.file_path}`,
+            type: ToolErrorType.FILE_NOT_FOUND,
+        };
+    }
+    else if (currentContent !== null) {
+        occurrences = countOccurrences(currentContent, normalizedOldString);
+        if (occurrences === 0) {
+            error = {
+                display: `Failed to edit, could not find string to replace.`,
+                raw: `Failed to edit, 0 occurrences found for old_string in ${params.file_path}. No edits made.`,
+                type: ToolErrorType.EDIT_NO_OCCURRENCE_FOUND,
+            };
+        }
+        else if (normalizedOldString === normalizedNewString) {
+            error = {
+                display: `No changes to apply. The old_string and new_string are identical.`,
+                raw: `No changes to apply. The old_string and new_string are identical in file: ${params.file_path}`,
+                type: ToolErrorType.EDIT_NO_CHANGE,
+            };
+        }
+    }
+    return { occurrences, error, isNewFile };
+}
+function checkNoChange(error, fileExists, currentContent, newContent, filePath) {
+    if (!error && fileExists && currentContent === newContent) {
+        return {
+            display: 'No changes to apply. The new content is identical to the current content.',
+            raw: `No changes to apply. The new content is identical to the current content in file: ${filePath}`,
+            type: ToolErrorType.EDIT_NO_CHANGE,
+        };
+    }
+    return error;
+}
+/**
+ * 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 function countOccurrences(content, searchString) {
+    if (!searchString)
+        return 0;
+    // Since applyReplacement uses String.replace (single replacement),
+    // count occurrences that will actually be replaced (0 or 1)
+    return content.includes(searchString) ? 1 : 0;
+}
+/**
+ * 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 function validateASTSyntax(filePath, content) {
+    const extension = path.extname(filePath).substring(1).toLowerCase();
+    const lang = LANGUAGE_MAP[extension];
+    if (!lang) {
+        return { valid: true, errors: [] };
+    }
+    try {
+        const tree = parse(lang, content);
+        const root = tree.root();
+        // Check for explicit ERROR nodes (garbled/unparseable tokens)
+        const errorNode = root.find({ rule: { kind: 'ERROR' } });
+        if (errorNode) {
+            const pos = errorNode.range().start;
+            return {
+                valid: false,
+                errors: [
+                    `Syntax error at line ${pos.line + 1}, column ${pos.column + 1}`,
+                ],
+            };
+        }
+        // Check for zero-width phantom nodes (MISSING tokens from error recovery).
+        // Tree-sitter inserts these when expected delimiters are absent (e.g., missing }).
+        // ast-grep doesn't expose isMissing() or kind:'MISSING', but zero-width leaf
+        // nodes in non-empty content reliably indicate recovered syntax errors.
+        if (content.length > 0) {
+            const missingNode = findZeroWidthNode(root);
+            if (missingNode) {
+                return {
+                    valid: false,
+                    errors: [
+                        `Syntax error at line ${missingNode.line + 1}, column ${missingNode.column + 1}`,
+                    ],
+                };
+            }
+        }
+        return { valid: true, errors: [] };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            errors: [error instanceof Error ? error.message : String(error)],
+        };
+    }
+}
+/**
+ * Walks the parse tree to find zero-width leaf nodes, which indicate
+ * MISSING tokens inserted by tree-sitter's error recovery (e.g., a phantom
+ * closing brace). Skips the root node to avoid false positives on empty content.
+ */
+function findZeroWidthNode(node) {
+    for (const child of node.children()) {
+        const range = child.range();
+        if (range.start.index === range.end.index && child.isLeaf()) {
+            return { line: range.start.line, column: range.start.column };
+        }
+        const found = findZeroWidthNode(child);
+        if (found)
+            return found;
+    }
+    return null;
+}
+/**
+ * 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 async function getFileLastModified(filePath) {
+    try {
+        const stats = await fsPromises.stat(filePath);
+        return stats.mtime.getTime();
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=edit-calculator.js.map

package/dist/src/tools/ast-edit/edit-calculator.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Edit helper functions for ast-edit tool.
+ */
+/**
+ * Applies a replacement to file content.
+ * This is the core replacement logic used by ASTEditTool.
+ *
+ * NOTE: This differs from edit.ts applyReplacement - they are intentionally separate.
+ * edit.ts supports multiple occurrences and fuzzy matching; ast-edit.ts uses simple single-replace.
+ * These are different domain behaviors and must NOT be unified.
+ *
+ * @param currentContent - The current file content (null if file doesn't exist)
+ * @param oldString - The string to replace
+ * @param newString - The replacement string
+ * @param isNewFile - Whether this is a new file creation
+ * @returns The modified content
+ */
+export declare function applyReplacement(currentContent: string | null, oldString: string, newString: string, isNewFile: boolean): string;

package/dist/src/tools/ast-edit/edit-helpers.js

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Edit helper functions for ast-edit tool.
+ */
+/**
+ * Applies a replacement to file content.
+ * This is the core replacement logic used by ASTEditTool.
+ *
+ * NOTE: This differs from edit.ts applyReplacement - they are intentionally separate.
+ * edit.ts supports multiple occurrences and fuzzy matching; ast-edit.ts uses simple single-replace.
+ * These are different domain behaviors and must NOT be unified.
+ *
+ * @param currentContent - The current file content (null if file doesn't exist)
+ * @param oldString - The string to replace
+ * @param newString - The replacement string
+ * @param isNewFile - Whether this is a new file creation
+ * @returns The modified content
+ */
+export function applyReplacement(currentContent, oldString, newString, isNewFile) {
+    if (isNewFile) {
+        return newString;
+    }
+    if (currentContent === null) {
+        return oldString === '' ? newString : '';
+    }
+    if (oldString === '') {
+        return currentContent;
+    }
+    // For single replacement, use callback form to treat newString literally
+    // (avoids $&, $$, $1 etc. being interpreted as special replacement patterns)
+    return currentContent.replace(oldString, () => newString);
+}
+//# sourceMappingURL=edit-helpers.js.map

package/dist/src/tools/ast-edit/edit-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-helpers.js","sourceRoot":"","sources":["../../../../src/tools/ast-edit/edit-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC9B,cAA6B,EAC7B,SAAiB,EACjB,SAAiB,EACjB,SAAkB;IAElB,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3C,CAAC;IACD,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;QACrB,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,yEAAyE;IACzE,6EAA6E;IAC7E,OAAO,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC5D,CAAC"}

package/dist/src/tools/ast-edit/language-analysis.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Import } from './types.js';
+/**
+ * Detects the programming language from a file path based on its extension.
+ * @param filePath - The file path to analyze
+ * @returns The detected language (e.g., 'typescript', 'python') or 'unknown'
+ */
+export declare function detectLanguage(filePath: string): string;
+/**
+ * Extracts import statements from source code.
+ * @param content - The source code content
+ * @param language - The programming language (typescript, javascript, python, etc.)
+ * @returns Array of import declarations with module paths and imported items
+ */
+export declare function extractImports(content: string, language: string): Import[];

package/dist/src/tools/ast-edit/language-analysis.js

@@ -0,0 +1,123 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as path from 'path';
+import { ASTConfig } from './ast-config.js';
+import { KEYWORDS, REGEX } from './constants.js';
+/**
+ * Detects the programming language from a file path based on its extension.
+ * @param filePath - The file path to analyze
+ * @returns The detected language (e.g., 'typescript', 'python') or 'unknown'
+ */
+export function detectLanguage(filePath) {
+    const extension = path.extname(filePath).substring(1);
+    return (ASTConfig.SUPPORTED_LANGUAGES[extension] || 'unknown');
+}
+/**
+ * Extracts import statements from source code.
+ * @param content - The source code content
+ * @param language - The programming language (typescript, javascript, python, etc.)
+ * @returns Array of import declarations with module paths and imported items
+ */
+export function extractImports(content, language) {
+    const imports = [];
+    const lines = content.split('\n');
+    lines.forEach((line, index) => {
+        const trimmed = line.trim();
+        if ((language === 'typescript' || language === 'javascript') &&
+            trimmed.startsWith(KEYWORDS.IMPORT)) {
+            imports.push({
+                module: extractImportModule(trimmed),
+                items: extractImportItems(trimmed),
+                line: index + 1,
+            });
+        }
+        else if (language === 'python' &&
+            (trimmed.startsWith(KEYWORDS.IMPORT) || trimmed.startsWith(KEYWORDS.FROM))) {
+            imports.push({
+                module: extractPythonImportModule(trimmed),
+                items: extractPythonImportItems(trimmed),
+                line: index + 1,
+            });
+        }
+    });
+    return imports;
+}
+/**
+ * Extracts the module path from an import statement.
+ * @param line - The import statement line
+ * @returns The module path or 'unknown' if not found
+ */
+function extractImportModule(line) {
+    const match = line.match(REGEX.IMPORT_MODULE);
+    return match ? match[1] : 'unknown';
+}
+/**
+ * Extracts the list of imported items from an import statement.
+ * @param line - The import statement line
+ * @returns Array of imported item names
+ */
+function extractImportItems(line) {
+    // Extract the contents of the first { ... } block using index scanning to
+    // avoid polynomial backtracking on braces-heavy input.
+    const open = line.indexOf('{');
+    if (open !== -1) {
+        const close = line.indexOf('}', open + 1);
+        if (close > open + 1) {
+            return line
+                .slice(open + 1, close)
+                .split(',')
+                .map((item) => item.trim());
+        }
+    }
+    return [];
+}
+/**
+ * Extracts the module path from a Python import statement.
+ * Handles: `import os`, `from pathlib import Path`, `from os.path import join`
+ */
+function extractPythonImportModule(line) {
+    // eslint-disable-next-line sonarjs/regular-expr -- Static regex reviewed for lint hardening; behavior preserved.
+    const fromMatch = line.match(/^from\s+([\w.]+)\s+import/);
+    if (fromMatch) {
+        return fromMatch[1];
+    }
+    // eslint-disable-next-line sonarjs/regular-expr -- Static regex reviewed for lint hardening; behavior preserved.
+    const importMatch = line.match(/^import\s+([\w.]+)/);
+    if (importMatch) {
+        return importMatch[1];
+    }
+    return 'unknown';
+}
+/**
+ * Strips a trailing ` as <alias>` from a single import item using linear token
+ * scanning (avoids regex backtracking on whitespace-heavy input).
+ * Example: `join as j` -> `join`.
+ */
+function stripImportAlias(item) {
+    const tokens = item.split(/\s+/);
+    if (tokens.length >= 3 &&
+        tokens[tokens.length - 2] === 'as' &&
+        /^\w+$/.test(tokens[tokens.length - 1])) {
+        return tokens.slice(0, tokens.length - 2).join(' ');
+    }
+    return item;
+}
+/**
+ * Extracts imported items from a Python import statement.
+ * Handles: `from typing import List, Dict`, `from os.path import join, exists`
+ */
+function extractPythonImportItems(line) {
+    // eslint-disable-next-line sonarjs/regular-expr -- Static regex reviewed for lint hardening; behavior preserved.
+    const fromImportMatch = line.match(/^from\s+[\w.]+\s+import\s+(.+)/);
+    if (fromImportMatch) {
+        return fromImportMatch[1]
+            .split(',')
+            .map((item) => stripImportAlias(item.trim()))
+            .filter((item) => item);
+    }
+    return [];
+}
+//# sourceMappingURL=language-analysis.js.map

package/dist/src/tools/ast-edit/language-analysis.js.map

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

package/dist/src/tools/ast-edit/local-context-analyzer.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Local context analysis functions for AST parsing and code snippet collection.
+ */
+import type { ASTNode, CodeSnippet, Declaration, FunctionInfo, ClassInfo, VariableInfo, ASTContext } from './types.js';
+/**
+ * Parse AST from content using basic line-by-line analysis.
+ * @param content - Source code content
+ * @param language - Programming language
+ * @returns Array of AST nodes
+ */
+export declare function parseAST(content: string, language: string): Promise<ASTNode[]>;
+/**
+ * Extract AST nodes from content by analyzing significant lines.
+ * @param content - Source code content
+ * @param language - Programming language
+ * @returns Array of AST nodes
+ */
+export declare function extractASTNodes(content: string, language: string): ASTNode[];
+/**
+ * Collect code snippets from content, filtering out comments and short lines.
+ * @param content - Source code content
+ * @returns Array of code snippets sorted by relevance
+ */
+export declare function collectSnippets(content: string): CodeSnippet[];
+/**
+ * Build language-specific context by extracting functions, classes, and variables.
+ * @param content - Source code content
+ * @param language - Programming language
+ * @returns Language context with extracted elements
+ */
+export declare function buildLanguageContext(content: string, language: string): ASTContext['languageContext'];
+/**
+ * Check if a line is significant (non-comment, non-empty).
+ * @param line - Source code line
+ * @param _language - Programming language (unused but kept for signature compatibility)
+ * @returns True if the line is significant
+ */
+export declare function isSignificantLine(line: string, _language: string): boolean;
+/**
+ * Infer the AST node type from a line of code.
+ * @param line - Source code line
+ * @param _language - Programming language (unused but kept for signature compatibility)
+ * @returns Node type (function, class, control, return, statement)
+ */
+export declare function inferNodeType(line: string, _language: string): string;
+/**
+ * Calculate the relevance score of a code line.
+ * @param line - Source code line
+ * @returns Relevance score
+ */
+export declare function calculateRelevance(line: string): number;
+/**
+ * Extract function declarations from content using regex.
+ * @param content - Source code content
+ * @param _language - Programming language
+ * @returns Array of function information
+ */
+export declare function extractFunctions(content: string, _language: string): FunctionInfo[];
+/**
+ * Extract class declarations from content using regex.
+ * @param content - Source code content
+ * @param _language - Programming language
+ * @returns Array of class information
+ */
+export declare function extractClasses(content: string, _language: string): ClassInfo[];
+/**
+ * Extract variable declarations from content using regex.
+ * @param content - Source code content
+ * @param _language - Programming language
+ * @returns Array of variable information
+ */
+export declare function extractVariables(content: string, _language: string): VariableInfo[];
+/**
+ * Optimize context collection by gathering declaration and local snippets.
+ * @param declarations - Array of declarations
+ * @param content - Source code content
+ * @param _workspaceRoot - Workspace root path (unused but kept for signature compatibility)
+ * @returns Optimized array of code snippets
+ */
+export declare function optimizeContextCollection(declarations: Declaration[], content: string, _workspaceRoot: string): CodeSnippet[];