mcp-adr-analysis-server 2.3.0 → 2.5.0

package/dist/src/index.d.ts

@@ -217,6 +217,7 @@ export declare class McpAdrAnalysisServer {
     private generateDeploymentGuidance;
     private smartGitPush;
     private deploymentReadiness;
+    private releaseTracking;
     private troubleshootGuidedWorkflow;
     private smartScore;
     private mcpPlanning;

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

@@ -2140,6 +2140,109 @@ export class McpAdrAnalysisServer {
                             required: ['operation'],
                         },
                     },
+                    {
+                        name: 'release_tracking',
+                        description: 'Track releases mapped to ADR decisions. Generates changelogs, manages milestones, compares releases, and assesses release readiness. Supports greenfield and brownfield projects. Writes CHANGELOG.md, creates GitHub Releases and Milestones.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                operation: {
+                                    type: 'string',
+                                    enum: [
+                                        'detect_releases',
+                                        'track_release',
+                                        'generate_changelog',
+                                        'compare_releases',
+                                        'release_summary',
+                                        'next_release_preview',
+                                        'create_milestone',
+                                        'sync_milestones',
+                                    ],
+                                    description: 'Operation to perform',
+                                },
+                                projectPath: {
+                                    type: 'string',
+                                    description: 'Project root path (defaults to current working directory)',
+                                },
+                                version: {
+                                    type: 'string',
+                                    description: 'Release version to track (e.g., v2.3.0)',
+                                },
+                                compareFrom: {
+                                    type: 'string',
+                                    description: 'Starting version for comparison',
+                                },
+                                compareTo: {
+                                    type: 'string',
+                                    description: 'Ending version for comparison',
+                                },
+                                format: {
+                                    type: 'string',
+                                    enum: ['markdown', 'keep-a-changelog', 'conventional'],
+                                    default: 'keep-a-changelog',
+                                    description: 'Changelog output format',
+                                },
+                                includeAdrLinks: {
+                                    type: 'boolean',
+                                    default: true,
+                                    description: 'Include ADR references in changelog',
+                                },
+                                includeCommitHashes: {
+                                    type: 'boolean',
+                                    default: false,
+                                    description: 'Include commit hashes in output',
+                                },
+                                groupByAdr: {
+                                    type: 'boolean',
+                                    default: false,
+                                    description: 'Group changelog entries by ADR',
+                                },
+                                writeToFile: {
+                                    type: 'boolean',
+                                    default: false,
+                                    description: 'Write CHANGELOG.md to repo',
+                                },
+                                includeReadiness: {
+                                    type: 'boolean',
+                                    default: true,
+                                    description: 'Include release readiness score',
+                                },
+                                includeTimeline: {
+                                    type: 'boolean',
+                                    default: true,
+                                    description: 'Include mermaid timeline diagram',
+                                },
+                                milestoneTitle: {
+                                    type: 'string',
+                                    description: 'GitHub milestone title (for create_milestone)',
+                                },
+                                milestoneDescription: {
+                                    type: 'string',
+                                    description: 'GitHub milestone description',
+                                },
+                                milestoneDueDate: {
+                                    type: 'string',
+                                    description: 'Milestone due date (YYYY-MM-DD)',
+                                },
+                                createGithubRelease: {
+                                    type: 'boolean',
+                                    default: false,
+                                    description: 'Create a GitHub Release (requires gh CLI)',
+                                },
+                                syncGithubMilestones: {
+                                    type: 'boolean',
+                                    default: false,
+                                    description: 'Sync milestones to GitHub (requires gh CLI)',
+                                },
+                                updateTodo: {
+                                    type: 'boolean',
+                                    default: false,
+                                    description: 'Update TODO.md with milestone status',
+                                },
+                            },
+                            required: ['operation'],
+                        },
+                    },
                     {
                         name: 'troubleshoot_guided_workflow',
                         description: 'Structured failure analysis and test plan generation with memory integration for troubleshooting session tracking and intelligent ADR/research suggestion capabilities - provide JSON failure info to get specific test commands',
@@ -3681,6 +3784,9 @@ export class McpAdrAnalysisServer {
                     case 'deployment_readiness':
                         response = await this.deploymentReadiness(safeArgs);
                         break;
+                    case 'release_tracking':
+                        response = await this.releaseTracking(safeArgs);
+                        break;
                     case 'troubleshoot_guided_workflow':
                         response = await this.troubleshootGuidedWorkflow(safeArgs);
                         break;
@@ -3962,6 +4068,12 @@ export class McpAdrAnalysisServer {
                         description: 'Historical deployment data with trends, failure analysis, and patterns. Supports query parameters: ?period=7d|30d|90d|1y|all, ?environment=production|staging|development|all, ?includeFailures=true|false, ?includeMetrics=true|false, ?format=summary|detailed',
                         mimeType: 'application/json',
                     },
+                    {
+                        uri: 'adr://release_history',
+                        name: 'Release History',
+                        description: 'Release tracking state with releases mapped to ADRs, milestones, and project metadata. Shows release timeline, ADR-to-release mappings with confidence scores, and unmapped ADRs.',
+                        mimeType: 'application/json',
+                    },
                     {
                         uri: 'adr://code_quality',
                         name: 'Code Quality',
@@ -7562,6 +7674,25 @@ Please provide:
                         },
                     };
                 }
+                case 'release_history': {
+                    const { generateReleaseHistoryResource } = await import('./resources/release-history-resource.js');
+                    const releaseProjectPath = process.env['PROJECT_PATH'] || process.cwd();
+                    const result = await generateReleaseHistoryResource(releaseProjectPath, url.searchParams);
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: result.contentType,
+                                text: JSON.stringify(result.data, null, 2),
+                            },
+                        ],
+                        _meta: {
+                            lastModified: result.lastModified,
+                            etag: result.etag,
+                            cacheKey: result.cacheKey,
+                        },
+                    };
+                }
                 case 'code_quality': {
                     const { generateCodeQualityResource } = await import('./resources/code-quality-resource.js');
                     const result = await generateCodeQualityResource(undefined, url.searchParams);
@@ -7806,6 +7937,15 @@ Please provide:
             throw new McpAdrError(`Deployment readiness check failed: ${error instanceof Error ? error.message : String(error)}`, 'DEPLOYMENT_READINESS_ERROR');
         }
     }
+    async releaseTracking(args) {
+        try {
+            const { releaseTracking } = await import('./tools/release-tracking-tool.js');
+            return await releaseTracking(args);
+        }
+        catch (error) {
+            throw new McpAdrError(`Release tracking failed: ${error instanceof Error ? error.message : String(error)}`, 'RELEASE_TRACKING_ERROR');
+        }
+    }
     async troubleshootGuidedWorkflow(args) {
         try {
             const { troubleshootGuidedWorkflow } = await import('./tools/troubleshoot-guided-workflow-tool.js');