mcp-adr-analysis-server 2.7.24 → 2.7.26

package/dist/src/tools/llm-web-search-tool.js

@@ -1,165 +0,0 @@
-/**
- * LLM-Managed Web Search Tool
- *
- * Uses Firecrawl for cross-platform web search with LLM-driven query optimization
- */
-import { McpAdrError } from '../types/index.js';
-import { ResearchOrchestrator } from '../utils/research-orchestrator.js';
-/**
- * LLM-managed web search using Firecrawl for cross-platform support
- *
- * @description Executes intelligent web search using Firecrawl with LLM-driven
- * query optimization and content relevance scoring. Supports RHEL, Ubuntu, and macOS.
- *
- * @param {Object} args - Web search configuration parameters
- * @param {string} args.query - The search query to execute
- * @param {number} [args.maxResults] - Maximum results to return (default: 5)
- * @param {boolean} [args.includeContent] - Include full content (default: true)
- * @param {string} [args.llmInstructions] - LLM instructions for search optimization
- * @param {string} [args.projectPath] - Path to project root (defaults to cwd)
- * @param {string} [args.adrDirectory] - ADR directory relative to project (defaults to 'docs/adrs')
- *
- * @returns {Promise<any>} Web search results with LLM analysis
- *
- * @throws {McpAdrError} When query is empty or search fails
- *
- * @example
- * ```typescript
- * // Basic web search
- * const result = await llmWebSearch({
- *   query: 'Red Hat OpenShift best practices'
- * });
- *
- * console.log(result.results); // Array of search results
- * console.log(result.llmAnalysis); // LLM analysis of results
- * ```
- *
- * @example
- * ```typescript
- * // Advanced search with LLM instructions
- * const result = await llmWebSearch({
- *   query: 'Kubernetes security hardening',
- *   maxResults: 10,
- *   llmInstructions: 'Focus on enterprise security practices and compliance requirements'
- * });
- * ```
- *
- * @since 2.1.0
- * @category Web Search
- * @category LLM
- * @mcp-tool
- */
-export async function llmWebSearch(args, context) {
-    const { query, maxResults = 5, includeContent = true, llmInstructions, projectPath, adrDirectory, } = args;
-    if (!query || query.trim().length === 0) {
-        throw new McpAdrError('Query parameter is required and cannot be empty', 'INVALID_QUERY');
-    }
-    try {
-        context?.info(`🌐 Initializing web search for: ${query}`);
-        context?.report_progress(0, 100);
-        // Initialize research orchestrator with Firecrawl
-        const orchestrator = new ResearchOrchestrator(projectPath, adrDirectory);
-        // Enhance query with LLM instructions if provided
-        context?.info('🤖 Optimizing search query with LLM guidance...');
-        context?.report_progress(25, 100);
-        let enhancedQuery = query;
-        if (llmInstructions) {
-            enhancedQuery = `${query}\n\nLLM Instructions: ${llmInstructions}`;
-        }
-        // Perform web search using research orchestrator
-        context?.info('🔍 Executing web search with Firecrawl...');
-        context?.report_progress(50, 100);
-        const researchResult = await orchestrator.answerResearchQuestion(enhancedQuery);
-        // Extract web search results
-        const webSearchSource = researchResult.sources.find(source => source.type === 'web_search');
-        const webResults = webSearchSource?.data?.results || [];
-        // Limit results
-        const limitedResults = webResults.slice(0, maxResults);
-        // Generate LLM analysis of results
-        context?.info('📊 Analyzing search results with LLM...');
-        context?.report_progress(75, 100);
-        const llmAnalysis = await generateLLMAnalysis(query, limitedResults, llmInstructions);
-        context?.info('✅ Web search complete!');
-        context?.report_progress(100, 100);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `# LLM-Managed Web Search Results
-
-## Query
-${query}
-
-${llmInstructions ? `## LLM Instructions\n${llmInstructions}\n` : ''}
-
-## Search Results (${limitedResults.length} found)
-
-${limitedResults
-                        .map((result, index) => `
-### ${index + 1}. ${result.title}
-- **URL**: ${result.url}
-- **Relevance**: ${(result.relevance * 100).toFixed(1)}%
-- **Content**: ${includeContent ? result.content?.substring(0, 500) + '...' : 'Content available'}
-
----
-`)
-                        .join('\n')}
-
-## LLM Analysis
-${llmAnalysis}
-
-## Search Metadata
-- **Provider**: Firecrawl
-- **Total Results**: ${webResults.length}
-- **Returned Results**: ${limitedResults.length}
-- **Confidence**: ${(researchResult.confidence * 100).toFixed(1)}%
-- **Timestamp**: ${new Date().toISOString()}
-`,
-                },
-            ],
-        };
-    }
-    catch (error) {
-        throw new McpAdrError(`Web search failed: ${error instanceof Error ? error.message : String(error)}`, 'WEB_SEARCH_ERROR');
-    }
-}
-/**
- * Generate LLM analysis of search results
- */
-async function generateLLMAnalysis(_query, _results, _instructions) {
-    // TODO: Implement LLM analysis when AI executor is available
-    // const { loadAIConfig, getAIExecutor } = await import('../config/ai-config.js');
-    // const aiConfig = loadAIConfig();
-    // const executor = getAIExecutor();
-    // const prompt = `
-    // Analyze these web search results for the query: "${query}"
-    //
-    // ${instructions ? `Additional Instructions: ${instructions}` : ''}
-    //
-    // Search Results:
-    // ${results.map((result, index) => `
-    // ${index + 1}. ${result.title}
-    // URL: ${result.url}
-    // Relevance: ${(result.relevance * 100).toFixed(1)}%
-    // Content Preview: ${result.content?.substring(0, 300)}...
-    // `).join('\n')}
-    //
-    // Provide analysis covering:
-    // 1. Overall quality and relevance of results
-    // 2. Key insights and findings
-    // 3. Gaps or missing information
-    // 4. Recommendations for further research
-    // 5. Summary of most valuable sources
-    //
-    // Keep analysis concise but comprehensive.
-    // `;
-    // const result = await executor.executeStructuredPrompt(prompt, {
-    //   type: 'object',
-    //   properties: {
-    //     analysis: { type: 'string' }
-    //   }
-    // });
-    // return result.data.analysis || 'Analysis unavailable';
-    return 'LLM analysis is not yet available. Results are available but require manual review.';
-}
-//# sourceMappingURL=llm-web-search-tool.js.map

package/dist/src/tools/llm-web-search-tool.js.map

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

package/dist/src/utils/dag-executor.d.ts

@@ -1,106 +0,0 @@
-/**
- * DAG Executor for Bootstrap Validation Loop
- *
- * Executes tasks in a Directed Acyclic Graph (DAG) with:
- * - Dependency resolution via topological sort
- * - Parallel execution within layers
- * - Fine-grained error handling and retry logic
- * - Task-level validation and timeout support
- */
-import { SystemCardManager } from './system-card-manager.js';
-/**
- * A single executable task node in the DAG
- */
-export interface TaskNode {
-    id: string;
-    name: string;
-    description: string;
-    command?: string;
-    commandArgs?: string[];
-    expectedExitCode?: number;
-    timeout?: number;
-    dependsOn: string[];
-    canFailSafely?: boolean;
-    platforms?: string[];
-    retryCount?: number;
-    retryDelay?: number;
-    validationCheck?: (output: string) => boolean;
-    category: 'infrastructure' | 'application';
-    severity: 'critical' | 'error' | 'warning' | 'info';
-}
-/**
- * Result of executing a single task
- */
-export interface TaskResult {
-    taskId: string;
-    success: boolean;
-    exitCode?: number;
-    stdout: string;
-    stderr: string;
-    duration: number;
-    error?: Error;
-    skipped?: boolean;
-    skipReason?: string;
-}
-/**
- * Result of executing the entire DAG
- */
-export interface DAGExecutionResult {
-    success: boolean;
-    executedTasks: string[];
-    failedTasks: string[];
-    skippedTasks: string[];
-    duration: number;
-    taskResults: Map<string, TaskResult>;
-}
-/**
- * DAG Executor with dependency resolution and parallel execution
- */
-export declare class DAGExecutor {
-    private logger;
-    private maxParallelism;
-    private systemCardManager;
-    private resourceExtractor;
-    constructor(maxParallelism?: number, systemCardManager?: SystemCardManager);
-    /**
-     * Execute DAG with topological sort and parallel execution
-     */
-    execute(tasks: TaskNode[]): Promise<DAGExecutionResult>;
-    /**
-     * Execute all tasks in a layer in parallel (with concurrency limit)
-     */
-    private executeLayer;
-    /**
-     * Execute tasks with concurrency limit
-     */
-    private executeWithConcurrencyLimit;
-    /**
-     * Execute a single task with retry logic
-     */
-    private executeTask;
-    /**
-     * Execute shell command with timeout
-     */
-    private executeCommand;
-    /**
-     * Validate DAG structure (no cycles, valid dependencies)
-     */
-    private validateDAG;
-    /**
-     * Detect cycles in DAG using DFS
-     */
-    private detectCycles;
-    /**
-     * Build dependency graph from tasks
-     */
-    private buildDependencyGraph;
-    /**
-     * Topological sort to determine execution order (Kahn's algorithm)
-     */
-    private topologicalSort;
-    /**
-     * Get all tasks that depend on the given task (recursively)
-     */
-    private getDependentTasks;
-}
-//# sourceMappingURL=dag-executor.d.ts.map

package/dist/src/utils/dag-executor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dag-executor.d.ts","sourceRoot":"","sources":["../../../src/utils/dag-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAK7D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IAGpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IAGxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAGrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAG9C,QAAQ,EAAE,gBAAgB,GAAG,aAAa,CAAC;IAC3C,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,iBAAiB,CAAgC;IACzD,OAAO,CAAC,iBAAiB,CAAoB;gBAEjC,cAAc,GAAE,MAAU,EAAE,iBAAiB,CAAC,EAAE,iBAAiB;IAO7E;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsI7D;;OAEG;YACW,YAAY;IAwE1B;;OAEG;YACW,2BAA2B;IAwBzC;;OAEG;YACW,WAAW;IAuHzB;;OAEG;YACW,cAAc;IAsB5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAqBnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmCpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkDvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAwB1B"}