mcp-adr-analysis-server 2.0.21 → 2.1.0

package/dist/src/utils/file-system.d.ts

@@ -1,78 +1,226 @@
 /**
  * File system utilities for MCP ADR Analysis Server
- * Generates prompts for AI-driven file discovery, reading, and analysis operations
- * Enhanced with Chain-of-Thought prompting to reduce LLM confusion
+ * Uses fast-glob for efficient file discovery with .gitignore support
+ * Enhanced with Smart Code Linking capabilities
+ */
+/**
+ * Information about a file in the project
  */
 export interface FileInfo {
+    /** Full path to the file */
     path: string;
+    /** Filename with extension */
     name: string;
+    /** File extension */
     extension: string;
+    /** File size in bytes */
     size: number;
+    /** Directory containing the file */
     directory: string;
+    /** File content (optional) */
     content?: string;
 }
+/**
+ * Complete project structure information
+ */
 export interface ProjectStructure {
+    /** Root path of the project */
     rootPath: string;
+    /** Array of files in the project */
     files: FileInfo[];
+    /** Array of directory paths */
     directories: string[];
+    /** Total number of files */
     totalFiles: number;
+    /** Total number of directories */
     totalDirectories: number;
 }
-export interface ProjectAnalysisPrompt {
-    prompt: string;
-    instructions: string;
-    context: {
-        projectPath: string;
-        absoluteProjectPath: string;
-        filePatterns: string[];
-    };
-}
 /**
- * Generate prompt for AI-driven project structure analysis
+ * Project analysis result with technologies and patterns
  */
-export declare function analyzeProjectStructure(projectPath: string): Promise<ProjectAnalysisPrompt>;
+export interface ProjectAnalysis {
+    /** Root path of the project */
+    rootPath: string;
+    /** Array of files analyzed */
+    files: FileInfo[];
+    /** Detected technologies */
+    technologies: string[];
+    /** Detected architectural patterns */
+    patterns: string[];
+    /** Summary of the analysis */
+    summary: string;
+    /** Total files analyzed */
+    totalFiles: number;
+    /** Total directories scanned */
+    totalDirectories: number;
+}
 /**
- * Generate prompt for AI-driven file content reading
+ * Result of finding related code for an ADR
  */
-export declare function readFileContent(filePath: string): Promise<{
-    prompt: string;
-    instructions: string;
-    context: any;
-}>;
+export interface RelatedCodeResult {
+    /** Path to the ADR */
+    adrPath: string;
+    /** Related source code files */
+    relatedFiles: FileInfo[];
+    /** Keywords extracted from ADR */
+    keywords: string[];
+    /** Search patterns used */
+    searchPatterns: string[];
+    /** Confidence score */
+    confidence: number;
+}
 /**
- * Generate prompt for AI-driven file discovery
+ * Find files using fast-glob with .gitignore support
+ *
+ * @param projectPath - Path to the project to search
+ * @param patterns - Glob patterns to match files
+ * @param options - Options for file discovery
+ * @returns Promise resolving to file discovery results
  */
 export declare function findFiles(projectPath: string, patterns: string[], options?: {
     includeContent?: boolean;
+    limit?: number;
 }): Promise<{
-    prompt: string;
-    instructions: string;
-    context: any;
+    files: FileInfo[];
+    totalFiles: number;
+    searchPatterns: string[];
+    searchPath: string;
 }>;
 /**
- * Generate prompt for AI-driven file existence check
+ * Analyze project structure to detect technologies and patterns
+ * Uses direct file analysis instead of AI prompts
+ *
+ * @param projectPath - Path to the project to analyze
+ * @returns Promise resolving to project analysis results
+ */
+export declare function analyzeProjectStructure(projectPath: string): Promise<ProjectAnalysis>;
+/**
+ * Read file content safely
+ *
+ * @param filePath - Path to the file to read
+ * @returns Promise resolving to file content and metadata
+ */
+export declare function readFileContent(filePath: string): Promise<{
+    success: boolean;
+    filePath: string;
+    content?: string;
+    error?: string;
+    metadata?: {
+        size: number;
+        encoding: string;
+        lastModified: string;
+    };
+}>;
+/**
+ * Check if a file exists
+ *
+ * @param filePath - Path to check
+ * @returns Promise resolving to existence check result
  */
 export declare function fileExists(filePath: string): Promise<{
-    prompt: string;
-    instructions: string;
-    context: any;
+    success: boolean;
+    filePath: string;
+    exists: boolean;
+    metadata?: {
+        type: 'file' | 'directory' | 'symlink' | null;
+        accessible: boolean;
+        lastChecked: string;
+    };
 }>;
 /**
- * Generate prompt for AI-driven directory creation
+ * Ensure a directory exists, creating it if necessary
+ *
+ * @param dirPath - Path to the directory
+ * @returns Promise resolving when directory is ensured
  */
 export declare function ensureDirectory(dirPath: string): Promise<{
-    prompt: string;
-    instructions: string;
-    context: any;
+    success: boolean;
+    dirPath: string;
+    created: boolean;
+    error?: string;
 }>;
 /**
- * Generate prompt for AI-driven file writing with directory creation
+ * Write content to a file, creating directories as needed
+ *
+ * @param filePath - Path to the file
+ * @param content - Content to write
+ * @returns Promise resolving when file is written
  */
 export declare function writeFile(filePath: string, content: string): Promise<{
+    success: boolean;
+    filePath: string;
+    written: boolean;
+    error?: string;
+    metadata?: {
+        size: number;
+        directoryCreated: boolean;
+    };
+}>;
+/**
+ * Find related code files for an ADR using Smart Code Linking
+ * Uses AI for keyword extraction and ripgrep for efficient searching
+ *
+ * @param adrPath - Path to the ADR file
+ * @param adrContent - Content of the ADR
+ * @param projectPath - Root path of the project
+ * @param options - Additional options for search customization
+ * @returns Promise resolving to related code files
+ */
+export declare function findRelatedCode(adrPath: string, adrContent: string, projectPath: string, options?: {
+    useAI?: boolean;
+    useRipgrep?: boolean;
+    maxFiles?: number;
+    includeContent?: boolean;
+}): Promise<RelatedCodeResult>;
+/**
+ * BACKWARD COMPATIBILITY SECTION
+ * These functions and types provide compatibility with the old prompt-based API
+ * They can be removed once all tools are updated to use the new direct API
+ */
+/**
+ * AI prompt for project analysis (backward compatibility)
+ */
+export interface ProjectAnalysisPrompt {
+    /** Generated prompt for AI analysis */
     prompt: string;
+    /** Instructions for the AI agent */
     instructions: string;
-    context: any;
-}>;
+    /** Context information for the analysis */
+    context: {
+        /** Original project path */
+        projectPath: string;
+        /** Absolute project path */
+        absoluteProjectPath: string;
+        /** File patterns to analyze */
+        filePatterns: string[];
+    };
+}
+/**
+ * Generate backward-compatible prompt response for project analysis
+ * This wraps the new analyzeProjectStructure to provide the old interface
+ * @deprecated Use analyzeProjectStructure directly
+ */
+export declare function analyzeProjectStructureCompat(projectPath: string): Promise<ProjectAnalysisPrompt>;
+/**
+ * Backward-compatible file exists wrapper
+ * @deprecated Use fileExists directly
+ */
+export declare function fileExistsCompat(filePath: string): Promise<any>;
+/**
+ * Backward-compatible ensure directory wrapper
+ * @deprecated Use ensureDirectory directly
+ */
+export declare function ensureDirectoryCompat(dirPath: string): Promise<any>;
+/**
+ * Backward-compatible write file wrapper
+ * @deprecated Use writeFile directly
+ */
+export declare function writeFileCompat(filePath: string, content: string): Promise<any>;
+/**
+ * Backward-compatible read file wrapper
+ * @deprecated Use readFileContent directly
+ */
+export declare function readFileContentCompat(filePath: string): Promise<any>;
 /**
  * Get file extension patterns for different file types
  */

package/dist/src/utils/file-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../../src/utils/file-system.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA4IjG;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CA0HvH;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CAyEjE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CAsJlH;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CAuKtH;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CAqMlI;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;CAmChB,CAAC"}
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../../src/utils/file-system.ts"],"names":[],"mappings":"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"}