mcp-adr-analysis-server 2.0.5 → 2.0.6

package/dist/src/tools/deployment-guidance-tool.js

@@ -0,0 +1,289 @@
+/**
+ * MCP Tool for generating deployment guidance from ADRs
+ * Implements prompt-driven deployment guidance generation following project patterns
+ */
+import { McpAdrError } from '../types/index.js';
+/**
+ * Generate deployment guidance from ADRs using AI-driven analysis
+ */
+export async function generateDeploymentGuidance(args) {
+    const { adrDirectory = 'docs/adrs', environment = 'production', format = 'markdown', projectPath = process.cwd(), includeScripts = true, includeConfigs = true, includeValidation = true, technologyFilter, customRequirements, includeRollback = true, generateFiles = false } = args;
+    try {
+        // Use existing ADR discovery
+        const { discoverAdrsInDirectory } = await import('../utils/adr-discovery.js');
+        const discoveryResult = await discoverAdrsInDirectory(adrDirectory, true, projectPath);
+        if (discoveryResult.adrs.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `# No ADRs Found for Deployment Guidance
+
+## Searched Location
+- **ADR Directory**: ${adrDirectory}
+- **Project Path**: ${projectPath}
+
+## Recommendations
+1. Create ADRs with deployment-relevant decisions
+2. Include technology choices (Docker, databases, web servers)
+3. Specify infrastructure requirements
+4. Document configuration parameters
+
+## Example ADR for Deployment
+\`\`\`markdown
+# ADR-001: Use Docker for Containerization
+
+## Status
+Accepted
+
+## Context
+We need consistent deployment across environments.
+
+## Decision
+Use Docker containers with docker-compose for orchestration.
+
+## Consequences
+- Consistent environment across dev/staging/production
+- Requires container registry and orchestration setup
+- Port 3000 for application, 5432 for PostgreSQL
+\`\`\`
+`
+                    }]
+            };
+        }
+        // Create comprehensive deployment guidance prompt
+        const deploymentPrompt = `
+# Deployment Guidance Generation
+
+You are an expert DevOps engineer tasked with creating comprehensive deployment guidance from Architectural Decision Records (ADRs).
+
+## Project Context
+- **Project**: ${projectPath.split('/').pop() || 'Unknown'}
+- **Target Environment**: ${environment}
+- **ADR Directory**: ${adrDirectory}
+- **Total ADRs**: ${discoveryResult.adrs.length}
+
+## ADR Content
+${discoveryResult.adrs.map(adr => `
+### ${adr.title} (${adr.filename})
+**Status**: ${adr.status}
+**Content**:
+\`\`\`markdown
+${adr.content?.slice(0, 1000) || 'No content available'}${adr.content && adr.content.length > 1000 ? '...' : ''}
+\`\`\`
+`).join('\n')}
+
+## Deployment Analysis Instructions
+
+Analyze the ADRs above and extract deployment-relevant information to create comprehensive deployment guidance:
+
+### 1. **Technology Extraction**
+Identify technologies mentioned in ADRs that require deployment:
+- **Databases**: PostgreSQL, MySQL, MongoDB, Redis, etc.
+- **Web Servers**: Nginx, Apache, Node.js, Python, etc.
+- **Containers**: Docker, Kubernetes, container orchestration
+- **Infrastructure**: Cloud providers, servers, networking
+- **Security**: TLS, authentication, secrets management
+- **Monitoring**: Logging, metrics, health checks
+
+### 2. **Configuration Requirements**
+Extract specific configuration details:
+- **Ports**: Application ports, database ports, service ports
+- **Environment Variables**: Required env vars for ${environment}
+- **Resource Limits**: Memory, CPU, storage requirements
+- **Dependencies**: Service dependencies and startup order
+
+### 3. **Environment-Specific Considerations**
+For **${environment}** environment:
+${environment === 'production' ? `
+- **Security**: TLS certificates, secure connections, secrets management
+- **Performance**: Load balancing, caching, optimization
+- **Reliability**: Backup procedures, monitoring, alerting
+- **Scalability**: Auto-scaling, resource allocation
+` : environment === 'staging' ? `
+- **Testing**: Staging-specific configurations
+- **Data**: Test data setup, database seeding
+- **Integration**: External service connections
+` : `
+- **Development**: Hot-reload, debugging, local services
+- **Convenience**: Simplified setup, development tools
+`}
+
+### 4. **Deployment Steps Generation**
+Create step-by-step deployment instructions:
+1. **Prerequisites**: Required tools, access, dependencies
+2. **Infrastructure Setup**: Server/cloud setup, networking
+3. **Database Setup**: Database creation, schema, migrations
+4. **Application Deployment**: Build, deploy, configure
+5. **Service Configuration**: Web server, load balancer, SSL
+6. **Verification**: Health checks, smoke tests, monitoring
+
+${includeScripts ? `
+### 5. **Script Generation**
+Generate deployment scripts:
+- **Shell scripts** for automated deployment
+- **Docker commands** for containerized deployment
+- **Configuration files** (nginx.conf, docker-compose.yml, .env)
+` : ''}
+
+${includeValidation ? `
+### 6. **Validation & Health Checks**
+Create verification procedures:
+- **Health check endpoints** and commands
+- **Service connectivity tests**
+- **Performance validation**
+- **Security verification**
+` : ''}
+
+${includeRollback ? `
+### 7. **Rollback Procedures**
+Document rollback steps:
+- **Rollback commands** in reverse order
+- **Data migration rollback** if applicable
+- **Service restoration** procedures
+` : ''}
+
+## Output Format
+
+Generate deployment guidance in the following structure:
+
+\`\`\`markdown
+# Deployment Guide: [Project Name]
+
+**Environment**: ${environment}
+**Generated**: [Current Date]
+
+## 📋 Prerequisites
+- List all required tools, access, and dependencies
+
+## 🏗️ Infrastructure Setup
+- Cloud/server setup steps
+- Network configuration
+- Security setup
+
+## 🗄️ Database Setup
+- Database installation/configuration
+- Schema creation/migration
+- Connection setup
+
+## 🚀 Application Deployment
+1. **Build Steps**
+   \`\`\`bash
+   # Build commands
+   \`\`\`
+
+2. **Deploy Steps**
+   \`\`\`bash
+   # Deployment commands
+   \`\`\`
+
+3. **Configuration**
+   \`\`\`bash
+   # Configuration commands
+   \`\`\`
+
+## ⚙️ Configuration Files
+
+### .env (Environment Variables)
+\`\`\`
+KEY=value
+\`\`\`
+
+### docker-compose.yml (if applicable)
+\`\`\`yaml
+# Docker configuration
+\`\`\`
+
+## 🔍 Health Checks & Verification
+\`\`\`bash
+# Health check commands
+\`\`\`
+
+## 🔄 Rollback Procedure
+\`\`\`bash
+# Rollback commands (in reverse order)
+\`\`\`
+
+## 🛠️ Troubleshooting
+- Common issues and solutions
+
+## 📖 Reference ADRs
+- Links to relevant ADRs
+\`\`\`
+
+## Analysis Requirements
+
+- **Be specific**: Include actual commands, ports, and configurations
+- **Environment-aware**: Tailor guidance for ${environment}
+- **Security-focused**: Include security best practices
+- **Actionable**: Every step should be executable
+- **Complete**: Cover entire deployment lifecycle
+- **Evidence-based**: Base all recommendations on ADR content
+
+${technologyFilter && technologyFilter.length > 0 ? `
+## Technology Filter
+Focus only on these technologies: ${technologyFilter.join(', ')}
+` : ''}
+
+${customRequirements && customRequirements.length > 0 ? `
+## Custom Requirements
+Additionally address these requirements:
+${customRequirements.map(req => `- ${req}`).join('\n')}
+` : ''}
+
+Begin deployment guidance generation now.
+`;
+        // Return the prompt for AI execution
+        return {
+            content: [{
+                    type: 'text',
+                    text: `# Deployment Guidance Generation
+
+## Analysis Complete
+- **Found ${discoveryResult.adrs.length} ADRs** for deployment analysis
+- **Target Environment**: ${environment}
+- **Format**: ${format}
+- **Include Scripts**: ${includeScripts}
+- **Include Configs**: ${includeConfigs}
+- **Include Validation**: ${includeValidation}
+- **Include Rollback**: ${includeRollback}
+
+## AI Analysis Prompt
+
+${deploymentPrompt}
+
+## Instructions
+
+1. **Submit the prompt above** to an AI agent for comprehensive deployment guidance
+2. **Review the generated guidance** for completeness and accuracy
+3. **Customize configurations** for your specific environment
+4. **Test deployment steps** in staging before production
+5. **Save guidance** as DEPLOYMENT.md or similar documentation
+
+## Expected Output
+
+The AI will generate:
+- **Step-by-step deployment instructions**
+- **Environment-specific configurations**
+- **Shell scripts and configuration files**
+- **Health checks and validation procedures**
+- **Rollback procedures**
+- **Troubleshooting guidance**
+
+All based on the architectural decisions documented in your ADRs.
+
+${generateFiles ? `
+## File Generation Mode
+**Note**: File generation is enabled. The AI guidance will include instructions for creating actual deployment files in your project.
+` : ''}
+
+## ADR Sources
+${discoveryResult.adrs.map(adr => `- **${adr.title}** (${adr.filename})`).join('\n')}
+`
+                }]
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Deployment guidance generation failed: ${error instanceof Error ? error.message : String(error)}`, 'DEPLOYMENT_GUIDANCE_ERROR');
+    }
+}
+//# sourceMappingURL=deployment-guidance-tool.js.map

package/dist/src/tools/deployment-guidance-tool.js.map

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

package/dist/src/tools/todo-management-tool.d.ts

@@ -0,0 +1,166 @@
+/**
+ * MCP Tool for TODO.md management with incremental updates and task lifecycle
+ * Provides smart merging, status tracking, and preservation of custom tasks
+ */
+import { z } from 'zod';
+declare const ManageTodoSchema: z.ZodUnion<[z.ZodObject<{
+    operation: z.ZodLiteral<"update_status">;
+    todoPath: z.ZodDefault<z.ZodString>;
+    updates: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        status: z.ZodEnum<["pending", "in_progress", "completed", "blocked", "cancelled"]>;
+        notes: z.ZodOptional<z.ZodString>;
+        assignee: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "pending" | "completed" | "in_progress" | "blocked" | "cancelled";
+        taskId: string;
+        assignee?: string | undefined;
+        notes?: string | undefined;
+    }, {
+        status: "pending" | "completed" | "in_progress" | "blocked" | "cancelled";
+        taskId: string;
+        assignee?: string | undefined;
+        notes?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    todoPath: string;
+    operation: "update_status";
+    updates: {
+        status: "pending" | "completed" | "in_progress" | "blocked" | "cancelled";
+        taskId: string;
+        assignee?: string | undefined;
+        notes?: string | undefined;
+    }[];
+}, {
+    operation: "update_status";
+    updates: {
+        status: "pending" | "completed" | "in_progress" | "blocked" | "cancelled";
+        taskId: string;
+        assignee?: string | undefined;
+        notes?: string | undefined;
+    }[];
+    todoPath?: string | undefined;
+}>, z.ZodObject<{
+    operation: z.ZodLiteral<"add_tasks">;
+    todoPath: z.ZodDefault<z.ZodString>;
+    tasks: z.ZodArray<z.ZodObject<Omit<{
+        id: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<["pending", "in_progress", "completed", "blocked", "cancelled"]>;
+        priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "critical"]>>;
+        adrSource: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        notes: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        estimatedHours: z.ZodOptional<z.ZodNumber>;
+        assignee: z.ZodOptional<z.ZodString>;
+    }, "id" | "createdAt" | "updatedAt">, "strip", z.ZodTypeAny, {
+        status: "pending" | "completed" | "in_progress" | "blocked" | "cancelled";
+        title: string;
+        category?: string | undefined;
+        priority?: "medium" | "low" | "high" | "critical" | undefined;
+        assignee?: string | undefined;
+        dependencies?: string[] | undefined;
+        adrSource?: string | undefined;
+        notes?: string | undefined;
+        estimatedHours?: number | undefined;
+    }, {
+        status: "pending" | "completed" | "in_progress" | "blocked" | "cancelled";
+        title: string;
+        category?: string | undefined;
+        priority?: "medium" | "low" | "high" | "critical" | undefined;
+        assignee?: string | undefined;
+        dependencies?: string[] | undefined;
+        adrSource?: string | undefined;
+        notes?: string | undefined;
+        estimatedHours?: number | undefined;
+    }>, "many">;
+    section: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    tasks: {
+        status: "pending" | "completed" | "in_progress" | "blocked" | "cancelled";
+        title: string;
+        category?: string | undefined;
+        priority?: "medium" | "low" | "high" | "critical" | undefined;
+        assignee?: string | undefined;
+        dependencies?: string[] | undefined;
+        adrSource?: string | undefined;
+        notes?: string | undefined;
+        estimatedHours?: number | undefined;
+    }[];
+    todoPath: string;
+    operation: "add_tasks";
+    section?: string | undefined;
+}, {
+    tasks: {
+        status: "pending" | "completed" | "in_progress" | "blocked" | "cancelled";
+        title: string;
+        category?: string | undefined;
+        priority?: "medium" | "low" | "high" | "critical" | undefined;
+        assignee?: string | undefined;
+        dependencies?: string[] | undefined;
+        adrSource?: string | undefined;
+        notes?: string | undefined;
+        estimatedHours?: number | undefined;
+    }[];
+    operation: "add_tasks";
+    todoPath?: string | undefined;
+    section?: string | undefined;
+}>, z.ZodObject<{
+    operation: z.ZodLiteral<"merge_adr_updates">;
+    todoPath: z.ZodDefault<z.ZodString>;
+    adrDirectory: z.ZodDefault<z.ZodString>;
+    preserveCompleted: z.ZodDefault<z.ZodBoolean>;
+    preserveCustom: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    adrDirectory: string;
+    todoPath: string;
+    operation: "merge_adr_updates";
+    preserveCompleted: boolean;
+    preserveCustom: boolean;
+}, {
+    operation: "merge_adr_updates";
+    adrDirectory?: string | undefined;
+    todoPath?: string | undefined;
+    preserveCompleted?: boolean | undefined;
+    preserveCustom?: boolean | undefined;
+}>, z.ZodObject<{
+    operation: z.ZodLiteral<"sync_progress">;
+    todoPath: z.ZodDefault<z.ZodString>;
+    adrDirectory: z.ZodDefault<z.ZodString>;
+    updateAdrs: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    adrDirectory: string;
+    todoPath: string;
+    operation: "sync_progress";
+    updateAdrs: boolean;
+}, {
+    operation: "sync_progress";
+    adrDirectory?: string | undefined;
+    todoPath?: string | undefined;
+    updateAdrs?: boolean | undefined;
+}>, z.ZodObject<{
+    operation: z.ZodLiteral<"analyze_progress">;
+    todoPath: z.ZodDefault<z.ZodString>;
+    timeframe: z.ZodDefault<z.ZodEnum<["day", "week", "month", "all"]>>;
+    includeVelocity: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    todoPath: string;
+    operation: "analyze_progress";
+    timeframe: "day" | "week" | "month" | "all";
+    includeVelocity: boolean;
+}, {
+    operation: "analyze_progress";
+    todoPath?: string | undefined;
+    timeframe?: "day" | "week" | "month" | "all" | undefined;
+    includeVelocity?: boolean | undefined;
+}>]>;
+type ManageTodoArgs = z.infer<typeof ManageTodoSchema>;
+/**
+ * Main TODO management function
+ */
+export declare function manageTodo(args: ManageTodoArgs): Promise<any>;
+export {};
+//# sourceMappingURL=todo-management-tool.d.ts.map

package/dist/src/tools/todo-management-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-management-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/todo-management-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqFxB,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMpB,CAAC;AAEH,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAwQvD;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAoLnE"}