mcp-adr-analysis-server 2.1.22 → 2.1.28

package/dist/src/index.d.ts.map

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

package/dist/src/index.js

@@ -3148,6 +3148,318 @@ export class McpAdrAnalysisServer {
                             required: ['promptName'],
                         },
                     },
+                    // ADR Aggregator Integration Tools (https://adraggregator.com)
+                    {
+                        name: 'sync_to_aggregator',
+                        description: 'Sync ADRs to ADR Aggregator platform (https://adraggregator.com) for centralized tracking, visualization, and team collaboration. Supports incremental and full sync modes with optional metadata.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                full_sync: {
+                                    type: 'boolean',
+                                    description: 'Replace all ADRs instead of incremental sync',
+                                    default: false,
+                                },
+                                include_metadata: {
+                                    type: 'boolean',
+                                    description: 'Include analysis metadata in sync',
+                                    default: true,
+                                },
+                                include_diagrams: {
+                                    type: 'boolean',
+                                    description: 'Include Mermaid diagrams (Pro+ tier)',
+                                    default: false,
+                                },
+                                include_timeline: {
+                                    type: 'boolean',
+                                    description: 'Include timeline/staleness data',
+                                    default: false,
+                                },
+                                include_security_scan: {
+                                    type: 'boolean',
+                                    description: 'Include security scan results',
+                                    default: false,
+                                },
+                                include_code_links: {
+                                    type: 'boolean',
+                                    description: 'Include AST-based code links (Pro+ tier)',
+                                    default: false,
+                                },
+                                adr_paths: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'Specific ADR paths to sync (syncs all if not provided)',
+                                },
+                                projectPath: {
+                                    type: 'string',
+                                    description: 'Project path (defaults to PROJECT_PATH)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'get_adr_context',
+                        description: 'Fetch ADR context from ADR Aggregator including summaries, diagrams, timeline data, and code links. Useful for getting a consolidated view of architectural decisions.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                include_diagrams: {
+                                    type: 'boolean',
+                                    description: 'Include Mermaid diagrams (Pro+ tier)',
+                                    default: false,
+                                },
+                                include_timeline: {
+                                    type: 'boolean',
+                                    description: 'Include timeline data',
+                                    default: true,
+                                },
+                                include_code_links: {
+                                    type: 'boolean',
+                                    description: 'Include code links (Pro+ tier)',
+                                    default: false,
+                                },
+                                include_research: {
+                                    type: 'boolean',
+                                    description: 'Include research context (Pro+ tier)',
+                                    default: false,
+                                },
+                                staleness_filter: {
+                                    type: 'string',
+                                    enum: ['all', 'fresh', 'stale', 'very_stale'],
+                                    description: 'Filter by staleness level',
+                                    default: 'all',
+                                },
+                                graph_depth: {
+                                    type: 'number',
+                                    description: 'Knowledge graph depth (Team tier)',
+                                    minimum: 1,
+                                    maximum: 5,
+                                },
+                                projectPath: {
+                                    type: 'string',
+                                    description: 'Project path (defaults to PROJECT_PATH)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'get_staleness_report',
+                        description: 'Get ADR staleness report from ADR Aggregator with review compliance metrics. Identifies stale ADRs that need attention and provides governance insights.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                threshold: {
+                                    type: 'number',
+                                    description: 'Days threshold for staleness',
+                                    default: 90,
+                                },
+                                projectPath: {
+                                    type: 'string',
+                                    description: 'Project path (defaults to PROJECT_PATH)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'get_adr_templates',
+                        description: 'Get domain-specific ADR templates and anti-patterns from ADR Aggregator. Includes best practices for web applications, microservices, APIs, and more. No authentication required.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                domain: {
+                                    type: 'string',
+                                    description: 'Domain filter (web_application, microservices, api, data_platform, etc.)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'get_adr_diagrams',
+                        description: 'Get Mermaid diagrams for ADRs from ADR Aggregator. Includes workflow, relationship, and impact diagrams. Requires Pro+ tier.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                adr_path: {
+                                    type: 'string',
+                                    description: 'Specific ADR path (returns all if not specified)',
+                                },
+                                projectPath: {
+                                    type: 'string',
+                                    description: 'Project path (defaults to PROJECT_PATH)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'validate_adr_compliance',
+                        description: 'Validate ADR compliance against implementation via ADR Aggregator. Checks that code actually implements documented decisions. Requires Pro+ tier.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                adr_paths: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'Specific ADR paths to validate',
+                                },
+                                validation_type: {
+                                    type: 'string',
+                                    enum: ['implementation', 'architecture', 'security', 'all'],
+                                    description: 'Type of validation to perform',
+                                    default: 'all',
+                                },
+                                projectPath: {
+                                    type: 'string',
+                                    description: 'Project path (defaults to PROJECT_PATH)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'get_knowledge_graph',
+                        description: 'Get cross-repository knowledge graph from ADR Aggregator with analytics and insights. Visualize ADR relationships across repositories. Requires Team tier.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                scope: {
+                                    type: 'string',
+                                    enum: ['repository', 'organization'],
+                                    description: 'Scope of the graph',
+                                    default: 'repository',
+                                },
+                                include_analytics: {
+                                    type: 'boolean',
+                                    description: 'Include graph analytics and insights',
+                                    default: true,
+                                },
+                                projectPath: {
+                                    type: 'string',
+                                    description: 'Project path (defaults to PROJECT_PATH)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'update_implementation_status',
+                        description: 'Update the implementation status of synced ADRs directly from the IDE. Supports statuses: not_started, in_progress, implemented, deprecated, blocked. Requires Pro+ tier.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                updates: {
+                                    type: 'array',
+                                    items: {
+                                        type: 'object',
+                                        properties: {
+                                            adr_path: {
+                                                type: 'string',
+                                                description: 'Path to the ADR file relative to project root',
+                                            },
+                                            implementation_status: {
+                                                type: 'string',
+                                                enum: [
+                                                    'not_started',
+                                                    'in_progress',
+                                                    'implemented',
+                                                    'deprecated',
+                                                    'blocked',
+                                                ],
+                                                description: 'New implementation status',
+                                            },
+                                            notes: {
+                                                type: 'string',
+                                                description: 'Optional notes about the status change',
+                                            },
+                                        },
+                                        required: ['adr_path', 'implementation_status'],
+                                    },
+                                    description: 'Array of ADR status updates to apply',
+                                },
+                                projectPath: {
+                                    type: 'string',
+                                    description: 'Project path (defaults to PROJECT_PATH)',
+                                },
+                            },
+                            required: ['updates'],
+                        },
+                    },
+                    {
+                        name: 'get_adr_priorities',
+                        description: 'Get ADR priorities for roadmap and backlog planning from ADR Aggregator. Returns prioritized ADRs with scores, dependencies, blockers, implementation status, and gap counts.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                include_ai: {
+                                    type: 'boolean',
+                                    description: 'Include AI-based priority recommendations',
+                                    default: false,
+                                },
+                                projectPath: {
+                                    type: 'string',
+                                    description: 'Project path (defaults to PROJECT_PATH)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'analyze_gaps',
+                        description: 'Scan local codebase and compare with ADRs to detect bi-directional gaps. Finds: (1) ADR-to-code gaps: file references in ADRs that do not exist, (2) Code-to-ADR gaps: technologies in package.json and architectural patterns without ADR coverage. Reports gaps to ADR Aggregator for tracking.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                projectPath: {
+                                    type: 'string',
+                                    description: 'Project path (defaults to PROJECT_PATH)',
+                                },
+                                reportToAggregator: {
+                                    type: 'boolean',
+                                    description: 'Whether to report gaps to ADR Aggregator',
+                                    default: true,
+                                },
+                                includeDismissed: {
+                                    type: 'boolean',
+                                    description: 'Include previously dismissed gaps in analysis',
+                                    default: false,
+                                },
+                                scanDirectories: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'Specific directories to scan (defaults to src, lib, app, packages)',
+                                },
+                                includePatterns: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'File patterns to include in scan (regex)',
+                                },
+                                excludePatterns: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'File patterns to exclude from scan (regex)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'get_gaps',
+                        description: 'Get current code gaps from ADR Aggregator. Returns gaps with their status (open, dismissed, resolved) for tracking and management.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                projectPath: {
+                                    type: 'string',
+                                    description: 'Project path (defaults to PROJECT_PATH)',
+                                },
+                                includeDismissed: {
+                                    type: 'boolean',
+                                    description: 'Include dismissed gaps',
+                                    default: false,
+                                },
+                                includeResolved: {
+                                    type: 'boolean',
+                                    description: 'Include resolved gaps',
+                                    default: false,
+                                },
+                            },
+                        },
+                    },
                 ],
             };
         });
@@ -3427,6 +3739,64 @@ export class McpAdrAnalysisServer {
                     case 'load_prompt':
                         response = await this.loadPrompt(safeArgs);
                         break;
+                    // ADR Aggregator Integration Tools
+                    case 'sync_to_aggregator': {
+                        const { syncToAggregator } = await import('./tools/adr-aggregator-tools.js');
+                        response = { ...(await syncToAggregator(safeArgs, context)) };
+                        break;
+                    }
+                    case 'get_adr_context': {
+                        const { getAdrContext } = await import('./tools/adr-aggregator-tools.js');
+                        response = { ...(await getAdrContext(safeArgs, context)) };
+                        break;
+                    }
+                    case 'get_staleness_report': {
+                        const { getStalenessReport } = await import('./tools/adr-aggregator-tools.js');
+                        response = { ...(await getStalenessReport(safeArgs, context)) };
+                        break;
+                    }
+                    case 'get_adr_templates': {
+                        const { getAdrTemplates } = await import('./tools/adr-aggregator-tools.js');
+                        response = { ...(await getAdrTemplates(safeArgs, context)) };
+                        break;
+                    }
+                    case 'get_adr_diagrams': {
+                        const { getAdrDiagrams } = await import('./tools/adr-aggregator-tools.js');
+                        response = { ...(await getAdrDiagrams(safeArgs, context)) };
+                        break;
+                    }
+                    case 'validate_adr_compliance': {
+                        const { validateAdrCompliance } = await import('./tools/adr-aggregator-tools.js');
+                        response = { ...(await validateAdrCompliance(safeArgs, context)) };
+                        break;
+                    }
+                    case 'get_knowledge_graph': {
+                        const { getKnowledgeGraph } = await import('./tools/adr-aggregator-tools.js');
+                        response = { ...(await getKnowledgeGraph(safeArgs, context)) };
+                        break;
+                    }
+                    case 'update_implementation_status': {
+                        const { updateAdrImplementationStatus } = await import('./tools/adr-aggregator-tools.js');
+                        response = {
+                            ...(await updateAdrImplementationStatus(safeArgs, context)),
+                        };
+                        break;
+                    }
+                    case 'get_adr_priorities': {
+                        const { getAdrPriorities } = await import('./tools/adr-aggregator-tools.js');
+                        response = { ...(await getAdrPriorities(safeArgs, context)) };
+                        break;
+                    }
+                    case 'analyze_gaps': {
+                        const { analyzeGaps } = await import('./tools/analyze-gaps-tool.js');
+                        response = { ...(await analyzeGaps(safeArgs, context)) };
+                        break;
+                    }
+                    case 'get_gaps': {
+                        const { getGaps } = await import('./tools/analyze-gaps-tool.js');
+                        response = { ...(await getGaps(safeArgs, context)) };
+                        break;
+                    }
                     default:
                         throw new McpAdrError(`Unknown tool: ${name}`, 'UNKNOWN_TOOL');
                 }