mcp-adr-analysis-server 2.1.20 → 2.1.27

package/dist/src/tools/tree-sitter-code-tools.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Tree-Sitter Code Analysis Tools
+ *
+ * Provides deterministic code structure analysis tools for MCP.
+ * These tools replace non-deterministic ripgrep-based search with
+ * AST-based structural analysis.
+ *
+ * Design Philosophy (per ADR-016):
+ * - Tools provide deterministic data
+ * - LLM handles reasoning and semantic matching
+ * - Same input always produces same output
+ *
+ * @see docs/adrs/adr-016-replace-ripgrep-with-tree-sitter.md
+ */
+import { CodeAnalysisResult, type ImportAnalysis, type FunctionAnalysis } from '../utils/tree-sitter-analyzer.js';
+/**
+ * File structure entry
+ */
+export interface FileEntry {
+    path: string;
+    relativePath: string;
+    type: 'file' | 'directory';
+    extension?: string;
+    language?: string;
+    size?: number;
+}
+/**
+ * Project structure result
+ */
+export interface ProjectStructureResult {
+    root: string;
+    totalFiles: number;
+    totalDirectories: number;
+    filesByLanguage: Record<string, number>;
+    entries: FileEntry[];
+}
+/**
+ * Import extraction result
+ */
+export interface ImportExtractionResult {
+    file: string;
+    language: string;
+    imports: ImportAnalysis[];
+    externalDependencies: string[];
+    internalDependencies: string[];
+}
+/**
+ * Function extraction result
+ */
+export interface FunctionExtractionResult {
+    file: string;
+    language: string;
+    functions: FunctionAnalysis[];
+    totalFunctions: number;
+    securitySensitiveFunctions: string[];
+}
+/**
+ * Class/Module definition
+ */
+export interface ClassDefinition {
+    name: string;
+    type: 'class' | 'interface' | 'type' | 'enum';
+    methods: string[];
+    properties: string[];
+    location: {
+        line: number;
+        column: number;
+    };
+    exported: boolean;
+}
+/**
+ * Class extraction result
+ */
+export interface ClassExtractionResult {
+    file: string;
+    language: string;
+    classes: ClassDefinition[];
+    interfaces: ClassDefinition[];
+    types: ClassDefinition[];
+}
+/**
+ * Dependency from package.json or requirements.txt
+ */
+export interface DependencyInfo {
+    name: string;
+    version: string;
+    type: 'production' | 'development' | 'peer' | 'optional';
+    source: string;
+}
+/**
+ * Project dependencies result
+ */
+export interface DependenciesResult {
+    projectPath: string;
+    dependencies: DependencyInfo[];
+    totalCount: number;
+    byType: Record<string, number>;
+}
+/**
+ * Export definition
+ */
+export interface ExportDefinition {
+    name: string;
+    type: 'function' | 'class' | 'const' | 'type' | 'interface' | 'default' | 'variable';
+    location: {
+        line: number;
+        column: number;
+    };
+    isDefault: boolean;
+}
+/**
+ * Export extraction result
+ */
+export interface ExportExtractionResult {
+    file: string;
+    language: string;
+    exports: ExportDefinition[];
+    hasDefaultExport: boolean;
+    namedExports: string[];
+}
+/**
+ * Get deterministic file structure of a project
+ *
+ * Returns a complete file tree without any search or filtering.
+ * The LLM can then decide which files are relevant.
+ */
+export declare function getFileStructure(projectPath: string, options?: {
+    maxDepth?: number;
+    includeHidden?: boolean;
+    excludePatterns?: string[];
+}): Promise<ProjectStructureResult>;
+/**
+ * Get AST-extracted imports from a file
+ *
+ * Returns deterministic list of all imports/requires in a file.
+ */
+export declare function getImports(filePath: string): Promise<ImportExtractionResult>;
+/**
+ * Get AST-extracted exports from a file
+ *
+ * Returns deterministic list of all exports in a file.
+ */
+export declare function getExports(filePath: string): Promise<ExportExtractionResult>;
+/**
+ * Get AST-extracted functions from a file
+ *
+ * Returns deterministic list of all functions with signatures.
+ */
+export declare function getFunctions(filePath: string): Promise<FunctionExtractionResult>;
+/**
+ * Get classes, interfaces, and types from a file
+ *
+ * Returns deterministic list of class/interface/type definitions.
+ */
+export declare function getClasses(filePath: string): Promise<ClassExtractionResult>;
+/**
+ * Get project dependencies from manifest files
+ *
+ * Parses package.json, requirements.txt, etc. for dependencies.
+ */
+export declare function getDependencies(projectPath: string): Promise<DependenciesResult>;
+/**
+ * Perform full tree-sitter analysis on a file
+ *
+ * Returns complete AST analysis result.
+ */
+export declare function analyzeFile(filePath: string): Promise<CodeAnalysisResult>;
+/**
+ * Analyze multiple files in a directory
+ *
+ * Returns analysis results for all code files.
+ */
+export declare function analyzeDirectory(dirPath: string, options?: {
+    extensions?: string[];
+    maxFiles?: number;
+    recursive?: boolean;
+}): Promise<{
+    files: Array<{
+        path: string;
+        analysis: CodeAnalysisResult;
+    }>;
+    errors: string[];
+}>;
+//# sourceMappingURL=tree-sitter-code-tools.d.ts.map

package/dist/src/tools/tree-sitter-code-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-sitter-code-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/tree-sitter-code-tools.ts"],"names":[],"mappings":"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"}