mcp-adr-analysis-server 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +608 -0
- package/dist/src/index.d.ts +10 -0
- package/dist/src/index.d.ts.map +1 -0
- package/dist/src/index.js +1722 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/prompts/adr-suggestion-prompts.d.ts +24 -0
- package/dist/src/prompts/adr-suggestion-prompts.d.ts.map +1 -0
- package/dist/src/prompts/adr-suggestion-prompts.js +383 -0
- package/dist/src/prompts/adr-suggestion-prompts.js.map +1 -0
- package/dist/src/prompts/analysis-prompts.d.ts +24 -0
- package/dist/src/prompts/analysis-prompts.d.ts.map +1 -0
- package/dist/src/prompts/analysis-prompts.js +489 -0
- package/dist/src/prompts/analysis-prompts.js.map +1 -0
- package/dist/src/prompts/deployment-analysis-prompts.d.ts +54 -0
- package/dist/src/prompts/deployment-analysis-prompts.d.ts.map +1 -0
- package/dist/src/prompts/deployment-analysis-prompts.js +712 -0
- package/dist/src/prompts/deployment-analysis-prompts.js.map +1 -0
- package/dist/src/prompts/environment-analysis-prompts.d.ts +34 -0
- package/dist/src/prompts/environment-analysis-prompts.d.ts.map +1 -0
- package/dist/src/prompts/environment-analysis-prompts.js +724 -0
- package/dist/src/prompts/environment-analysis-prompts.js.map +1 -0
- package/dist/src/prompts/index.d.ts +43 -0
- package/dist/src/prompts/index.d.ts.map +1 -0
- package/dist/src/prompts/index.js +384 -0
- package/dist/src/prompts/index.js.map +1 -0
- package/dist/src/prompts/research-integration-prompts.d.ts +43 -0
- package/dist/src/prompts/research-integration-prompts.d.ts.map +1 -0
- package/dist/src/prompts/research-integration-prompts.js +398 -0
- package/dist/src/prompts/research-integration-prompts.js.map +1 -0
- package/dist/src/prompts/research-question-prompts.d.ts +75 -0
- package/dist/src/prompts/research-question-prompts.d.ts.map +1 -0
- package/dist/src/prompts/research-question-prompts.js +695 -0
- package/dist/src/prompts/research-question-prompts.js.map +1 -0
- package/dist/src/prompts/rule-generation-prompts.d.ts +63 -0
- package/dist/src/prompts/rule-generation-prompts.d.ts.map +1 -0
- package/dist/src/prompts/rule-generation-prompts.js +630 -0
- package/dist/src/prompts/rule-generation-prompts.js.map +1 -0
- package/dist/src/prompts/security-prompts.d.ts +23 -0
- package/dist/src/prompts/security-prompts.d.ts.map +1 -0
- package/dist/src/prompts/security-prompts.js +287 -0
- package/dist/src/prompts/security-prompts.js.map +1 -0
- package/dist/src/resources/index.d.ts +24 -0
- package/dist/src/resources/index.d.ts.map +1 -0
- package/dist/src/resources/index.js +458 -0
- package/dist/src/resources/index.js.map +1 -0
- package/dist/src/tools/adr-suggestion-tool.d.ts +40 -0
- package/dist/src/tools/adr-suggestion-tool.d.ts.map +1 -0
- package/dist/src/tools/adr-suggestion-tool.js +338 -0
- package/dist/src/tools/adr-suggestion-tool.js.map +1 -0
- package/dist/src/tools/content-masking-tool.d.ts +52 -0
- package/dist/src/tools/content-masking-tool.d.ts.map +1 -0
- package/dist/src/tools/content-masking-tool.js +206 -0
- package/dist/src/tools/content-masking-tool.js.map +1 -0
- package/dist/src/tools/deployment-analysis-tool.d.ts +39 -0
- package/dist/src/tools/deployment-analysis-tool.d.ts.map +1 -0
- package/dist/src/tools/deployment-analysis-tool.js +310 -0
- package/dist/src/tools/deployment-analysis-tool.js.map +1 -0
- package/dist/src/tools/environment-analysis-tool.d.ts +16 -0
- package/dist/src/tools/environment-analysis-tool.d.ts.map +1 -0
- package/dist/src/tools/environment-analysis-tool.js +298 -0
- package/dist/src/tools/environment-analysis-tool.js.map +1 -0
- package/dist/src/tools/research-integration-tool.d.ts +44 -0
- package/dist/src/tools/research-integration-tool.d.ts.map +1 -0
- package/dist/src/tools/research-integration-tool.js +429 -0
- package/dist/src/tools/research-integration-tool.js.map +1 -0
- package/dist/src/tools/research-question-tool.d.ts +55 -0
- package/dist/src/tools/research-question-tool.d.ts.map +1 -0
- package/dist/src/tools/research-question-tool.js +333 -0
- package/dist/src/tools/research-question-tool.js.map +1 -0
- package/dist/src/tools/rule-generation-tool.d.ts +49 -0
- package/dist/src/tools/rule-generation-tool.d.ts.map +1 -0
- package/dist/src/tools/rule-generation-tool.js +432 -0
- package/dist/src/tools/rule-generation-tool.js.map +1 -0
- package/dist/src/types/index.d.ts +531 -0
- package/dist/src/types/index.d.ts.map +1 -0
- package/dist/src/types/index.js +129 -0
- package/dist/src/types/index.js.map +1 -0
- package/dist/src/utils/adr-suggestions.d.ts +104 -0
- package/dist/src/utils/adr-suggestions.d.ts.map +1 -0
- package/dist/src/utils/adr-suggestions.js +228 -0
- package/dist/src/utils/adr-suggestions.js.map +1 -0
- package/dist/src/utils/cache.d.ts +51 -0
- package/dist/src/utils/cache.d.ts.map +1 -0
- package/dist/src/utils/cache.js +243 -0
- package/dist/src/utils/cache.js.map +1 -0
- package/dist/src/utils/config.d.ts +65 -0
- package/dist/src/utils/config.d.ts.map +1 -0
- package/dist/src/utils/config.js +118 -0
- package/dist/src/utils/config.js.map +1 -0
- package/dist/src/utils/content-masking.d.ts +79 -0
- package/dist/src/utils/content-masking.d.ts.map +1 -0
- package/dist/src/utils/content-masking.js +203 -0
- package/dist/src/utils/content-masking.js.map +1 -0
- package/dist/src/utils/deployment-analysis.d.ts +67 -0
- package/dist/src/utils/deployment-analysis.d.ts.map +1 -0
- package/dist/src/utils/deployment-analysis.js +263 -0
- package/dist/src/utils/deployment-analysis.js.map +1 -0
- package/dist/src/utils/environment-analysis.d.ts +76 -0
- package/dist/src/utils/environment-analysis.d.ts.map +1 -0
- package/dist/src/utils/environment-analysis.js +329 -0
- package/dist/src/utils/environment-analysis.js.map +1 -0
- package/dist/src/utils/file-system.d.ts +63 -0
- package/dist/src/utils/file-system.d.ts.map +1 -0
- package/dist/src/utils/file-system.js +189 -0
- package/dist/src/utils/file-system.js.map +1 -0
- package/dist/src/utils/output-masking.d.ts +45 -0
- package/dist/src/utils/output-masking.d.ts.map +1 -0
- package/dist/src/utils/output-masking.js +200 -0
- package/dist/src/utils/output-masking.js.map +1 -0
- package/dist/src/utils/research-documentation.d.ts +58 -0
- package/dist/src/utils/research-documentation.d.ts.map +1 -0
- package/dist/src/utils/research-documentation.js +438 -0
- package/dist/src/utils/research-documentation.js.map +1 -0
- package/dist/src/utils/research-integration.d.ts +89 -0
- package/dist/src/utils/research-integration.d.ts.map +1 -0
- package/dist/src/utils/research-integration.js +432 -0
- package/dist/src/utils/research-integration.js.map +1 -0
- package/dist/src/utils/research-questions.d.ts +97 -0
- package/dist/src/utils/research-questions.d.ts.map +1 -0
- package/dist/src/utils/research-questions.js +319 -0
- package/dist/src/utils/research-questions.js.map +1 -0
- package/dist/src/utils/rule-format.d.ts +76 -0
- package/dist/src/utils/rule-format.d.ts.map +1 -0
- package/dist/src/utils/rule-format.js +257 -0
- package/dist/src/utils/rule-format.js.map +1 -0
- package/dist/src/utils/rule-generation.d.ts +86 -0
- package/dist/src/utils/rule-generation.d.ts.map +1 -0
- package/dist/src/utils/rule-generation.js +330 -0
- package/dist/src/utils/rule-generation.js.map +1 -0
- package/package.json +71 -0
|
@@ -0,0 +1,310 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MCP Tool for deployment completion analysis
|
|
3
|
+
* Implements prompt-driven deployment progress tracking and completion verification
|
|
4
|
+
*/
|
|
5
|
+
import { McpAdrError } from '../types/index.js';
|
|
6
|
+
/**
|
|
7
|
+
* Analyze deployment progress and verify completion
|
|
8
|
+
*/
|
|
9
|
+
export async function analyzeDeploymentProgress(args) {
|
|
10
|
+
const { analysisType = 'comprehensive', adrDirectory = 'docs/adrs', todoPath, cicdLogs, pipelineConfig, deploymentTasks, outcomeRules, actualOutcomes, cicdStatus, environmentStatus, } = args;
|
|
11
|
+
try {
|
|
12
|
+
const { identifyDeploymentTasks, analyzeCiCdStatus, calculateDeploymentProgress, verifyDeploymentCompletion, } = await import('../utils/deployment-analysis.js');
|
|
13
|
+
switch (analysisType) {
|
|
14
|
+
case 'tasks': {
|
|
15
|
+
const result = await identifyDeploymentTasks(adrDirectory, todoPath);
|
|
16
|
+
return {
|
|
17
|
+
content: [
|
|
18
|
+
{
|
|
19
|
+
type: 'text',
|
|
20
|
+
text: `# Deployment Task Identification
|
|
21
|
+
|
|
22
|
+
${result.instructions}
|
|
23
|
+
|
|
24
|
+
## AI Task Identification Prompt
|
|
25
|
+
|
|
26
|
+
${result.identificationPrompt}
|
|
27
|
+
|
|
28
|
+
## Next Steps
|
|
29
|
+
|
|
30
|
+
1. **Submit the prompt** to an AI agent for comprehensive task identification
|
|
31
|
+
2. **Parse the JSON response** to get deployment tasks and phases
|
|
32
|
+
3. **Review task dependencies** and deployment sequencing
|
|
33
|
+
4. **Use tasks** for deployment progress tracking and management
|
|
34
|
+
|
|
35
|
+
## Expected Output
|
|
36
|
+
|
|
37
|
+
The AI will provide:
|
|
38
|
+
- **Deployment Task Analysis**: Overall analysis metadata and confidence scores
|
|
39
|
+
- **Identified Tasks**: Detailed deployment tasks with verification criteria
|
|
40
|
+
- **Deployment Phases**: Organized phases with sequencing and dependencies
|
|
41
|
+
- **Deployment Dependencies**: Task dependencies and constraints
|
|
42
|
+
- **Risk Assessment**: Deployment risks and mitigation strategies
|
|
43
|
+
- **Recommendations**: Process and tooling improvement recommendations
|
|
44
|
+
|
|
45
|
+
## Deployment Task Management
|
|
46
|
+
|
|
47
|
+
Use the identified tasks to:
|
|
48
|
+
- **Track Progress**: Monitor deployment progress across all categories
|
|
49
|
+
- **Manage Dependencies**: Ensure proper task sequencing and coordination
|
|
50
|
+
- **Assess Risks**: Identify and mitigate deployment risks
|
|
51
|
+
- **Verify Completion**: Use verification criteria for completion validation
|
|
52
|
+
- **Optimize Process**: Improve deployment efficiency and reliability
|
|
53
|
+
`,
|
|
54
|
+
},
|
|
55
|
+
],
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
case 'cicd': {
|
|
59
|
+
if (!cicdLogs) {
|
|
60
|
+
throw new McpAdrError('CI/CD logs are required for pipeline analysis', 'INVALID_INPUT');
|
|
61
|
+
}
|
|
62
|
+
const result = await analyzeCiCdStatus(cicdLogs, pipelineConfig, deploymentTasks);
|
|
63
|
+
return {
|
|
64
|
+
content: [
|
|
65
|
+
{
|
|
66
|
+
type: 'text',
|
|
67
|
+
text: `# CI/CD Pipeline Analysis
|
|
68
|
+
|
|
69
|
+
${result.instructions}
|
|
70
|
+
|
|
71
|
+
## AI Pipeline Analysis Prompt
|
|
72
|
+
|
|
73
|
+
${result.analysisPrompt}
|
|
74
|
+
|
|
75
|
+
## Next Steps
|
|
76
|
+
|
|
77
|
+
1. **Submit the prompt** to an AI agent for comprehensive pipeline analysis
|
|
78
|
+
2. **Parse the JSON response** to get pipeline status and issues
|
|
79
|
+
3. **Review performance metrics** and optimization opportunities
|
|
80
|
+
4. **Use findings** for deployment progress calculation and issue resolution
|
|
81
|
+
|
|
82
|
+
## Expected Output
|
|
83
|
+
|
|
84
|
+
The AI will provide:
|
|
85
|
+
- **CI/CD Analysis**: Overall pipeline status and progress assessment
|
|
86
|
+
- **Pipeline Stages**: Detailed stage-by-stage analysis with timings
|
|
87
|
+
- **Test Results**: Comprehensive test result analysis and coverage
|
|
88
|
+
- **Quality Gates**: Quality gate status and compliance assessment
|
|
89
|
+
- **Deployment Status**: Environment deployment status and health
|
|
90
|
+
- **Issues**: Identified issues with severity and suggested fixes
|
|
91
|
+
- **Performance Metrics**: Pipeline performance and resource utilization
|
|
92
|
+
- **Recommendations**: Optimization and improvement recommendations
|
|
93
|
+
|
|
94
|
+
## Pipeline Optimization
|
|
95
|
+
|
|
96
|
+
Use the analysis results to:
|
|
97
|
+
- **Resolve Issues**: Address identified pipeline problems and failures
|
|
98
|
+
- **Improve Performance**: Optimize build times and resource usage
|
|
99
|
+
- **Enhance Quality**: Strengthen quality gates and testing coverage
|
|
100
|
+
- **Increase Reliability**: Improve pipeline stability and success rates
|
|
101
|
+
- **Automate Processes**: Identify automation opportunities
|
|
102
|
+
`,
|
|
103
|
+
},
|
|
104
|
+
],
|
|
105
|
+
};
|
|
106
|
+
}
|
|
107
|
+
case 'progress': {
|
|
108
|
+
if (!deploymentTasks) {
|
|
109
|
+
throw new McpAdrError('Deployment tasks are required for progress calculation', 'INVALID_INPUT');
|
|
110
|
+
}
|
|
111
|
+
const result = await calculateDeploymentProgress(deploymentTasks, cicdStatus, environmentStatus);
|
|
112
|
+
return {
|
|
113
|
+
content: [
|
|
114
|
+
{
|
|
115
|
+
type: 'text',
|
|
116
|
+
text: `# Deployment Progress Calculation
|
|
117
|
+
|
|
118
|
+
${result.instructions}
|
|
119
|
+
|
|
120
|
+
## AI Progress Calculation Prompt
|
|
121
|
+
|
|
122
|
+
${result.progressPrompt}
|
|
123
|
+
|
|
124
|
+
## Next Steps
|
|
125
|
+
|
|
126
|
+
1. **Submit the prompt** to an AI agent for comprehensive progress calculation
|
|
127
|
+
2. **Parse the JSON response** to get detailed progress analysis
|
|
128
|
+
3. **Review critical path** and bottlenecks
|
|
129
|
+
4. **Use progress data** for stakeholder reporting and decision making
|
|
130
|
+
|
|
131
|
+
## Expected Output
|
|
132
|
+
|
|
133
|
+
The AI will provide:
|
|
134
|
+
- **Deployment Progress**: Overall progress and completion estimates
|
|
135
|
+
- **Category Progress**: Progress breakdown by deployment category
|
|
136
|
+
- **Task Progress**: Individual task progress and contributions
|
|
137
|
+
- **Critical Path**: Critical path analysis and bottleneck identification
|
|
138
|
+
- **Milestones**: Milestone progress and status tracking
|
|
139
|
+
- **Quality Metrics**: Quality and compliance metric assessment
|
|
140
|
+
- **Risk Assessment**: Risk analysis and mitigation strategies
|
|
141
|
+
- **Recommendations**: Progress acceleration recommendations
|
|
142
|
+
- **Next Actions**: Immediate actions required for progress
|
|
143
|
+
|
|
144
|
+
## Progress Management
|
|
145
|
+
|
|
146
|
+
Use the progress calculation to:
|
|
147
|
+
- **Track Completion**: Monitor overall deployment completion status
|
|
148
|
+
- **Identify Bottlenecks**: Find and address critical path bottlenecks
|
|
149
|
+
- **Manage Risks**: Proactively address deployment risks
|
|
150
|
+
- **Report Status**: Provide accurate progress reports to stakeholders
|
|
151
|
+
- **Accelerate Delivery**: Implement recommendations for faster delivery
|
|
152
|
+
`,
|
|
153
|
+
},
|
|
154
|
+
],
|
|
155
|
+
};
|
|
156
|
+
}
|
|
157
|
+
case 'completion': {
|
|
158
|
+
if (!deploymentTasks || !outcomeRules) {
|
|
159
|
+
throw new McpAdrError('Deployment tasks and outcome rules are required for completion verification', 'INVALID_INPUT');
|
|
160
|
+
}
|
|
161
|
+
const result = await verifyDeploymentCompletion(deploymentTasks, outcomeRules, actualOutcomes);
|
|
162
|
+
return {
|
|
163
|
+
content: [
|
|
164
|
+
{
|
|
165
|
+
type: 'text',
|
|
166
|
+
text: `# Deployment Completion Verification
|
|
167
|
+
|
|
168
|
+
${result.instructions}
|
|
169
|
+
|
|
170
|
+
## AI Completion Verification Prompt
|
|
171
|
+
|
|
172
|
+
${result.verificationPrompt}
|
|
173
|
+
|
|
174
|
+
## Next Steps
|
|
175
|
+
|
|
176
|
+
1. **Submit the prompt** to an AI agent for comprehensive completion verification
|
|
177
|
+
2. **Parse the JSON response** to get verification results and compliance status
|
|
178
|
+
3. **Review completion gaps** and quality assessments
|
|
179
|
+
4. **Use verification results** for sign-off decisions and go-live recommendations
|
|
180
|
+
|
|
181
|
+
## Expected Output
|
|
182
|
+
|
|
183
|
+
The AI will provide:
|
|
184
|
+
- **Completion Verification**: Overall completion status and confidence
|
|
185
|
+
- **Task Verification**: Individual task verification results
|
|
186
|
+
- **Rule Compliance**: Outcome rule compliance assessment
|
|
187
|
+
- **Quality Assessment**: Quality and compliance metric evaluation
|
|
188
|
+
- **Success Metrics**: Success metric evaluation and variance analysis
|
|
189
|
+
- **Completion Gaps**: Identified gaps and remediation strategies
|
|
190
|
+
- **Recommendations**: Completion and quality improvement recommendations
|
|
191
|
+
- **Sign-Off Status**: Sign-off readiness and go-live recommendation
|
|
192
|
+
|
|
193
|
+
## Completion Management
|
|
194
|
+
|
|
195
|
+
Use the verification results to:
|
|
196
|
+
- **Validate Completion**: Ensure all deployment tasks are properly completed
|
|
197
|
+
- **Assess Quality**: Verify quality standards and acceptance criteria
|
|
198
|
+
- **Manage Sign-Off**: Make informed sign-off and go-live decisions
|
|
199
|
+
- **Address Gaps**: Remediate identified completion gaps
|
|
200
|
+
- **Ensure Compliance**: Verify compliance with outcome rules and standards
|
|
201
|
+
`,
|
|
202
|
+
},
|
|
203
|
+
],
|
|
204
|
+
};
|
|
205
|
+
}
|
|
206
|
+
case 'comprehensive': {
|
|
207
|
+
const taskResult = await identifyDeploymentTasks(adrDirectory, todoPath);
|
|
208
|
+
return {
|
|
209
|
+
content: [
|
|
210
|
+
{
|
|
211
|
+
type: 'text',
|
|
212
|
+
text: `# Comprehensive Deployment Analysis
|
|
213
|
+
|
|
214
|
+
This comprehensive analysis will provide end-to-end deployment progress tracking and completion verification.
|
|
215
|
+
|
|
216
|
+
## Deployment Analysis Workflow
|
|
217
|
+
|
|
218
|
+
### 1. **Task Identification** (First Step)
|
|
219
|
+
Identify deployment tasks from ADRs and todo content.
|
|
220
|
+
|
|
221
|
+
${taskResult.instructions}
|
|
222
|
+
|
|
223
|
+
#### Task Identification Prompt
|
|
224
|
+
${taskResult.identificationPrompt}
|
|
225
|
+
|
|
226
|
+
### 2. **CI/CD Analysis** (Second Step)
|
|
227
|
+
Analyze CI/CD pipeline status and performance:
|
|
228
|
+
\`\`\`json
|
|
229
|
+
{
|
|
230
|
+
"tool": "analyze_deployment_progress",
|
|
231
|
+
"args": {
|
|
232
|
+
"analysisType": "cicd",
|
|
233
|
+
"cicdLogs": "[CI/CD log content]",
|
|
234
|
+
"pipelineConfig": "[pipeline configuration]",
|
|
235
|
+
"deploymentTasks": [results from step 1]
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
\`\`\`
|
|
239
|
+
|
|
240
|
+
### 3. **Progress Calculation** (Third Step)
|
|
241
|
+
Calculate comprehensive deployment progress:
|
|
242
|
+
\`\`\`json
|
|
243
|
+
{
|
|
244
|
+
"tool": "analyze_deployment_progress",
|
|
245
|
+
"args": {
|
|
246
|
+
"analysisType": "progress",
|
|
247
|
+
"deploymentTasks": [results from step 1],
|
|
248
|
+
"cicdStatus": [results from step 2],
|
|
249
|
+
"environmentStatus": "[environment status data]"
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
\`\`\`
|
|
253
|
+
|
|
254
|
+
### 4. **Completion Verification** (Fourth Step)
|
|
255
|
+
Verify deployment completion with outcome rules:
|
|
256
|
+
\`\`\`json
|
|
257
|
+
{
|
|
258
|
+
"tool": "analyze_deployment_progress",
|
|
259
|
+
"args": {
|
|
260
|
+
"analysisType": "completion",
|
|
261
|
+
"deploymentTasks": [results from step 1],
|
|
262
|
+
"outcomeRules": [defined outcome rules],
|
|
263
|
+
"actualOutcomes": [actual deployment outcomes]
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
\`\`\`
|
|
267
|
+
|
|
268
|
+
## Expected Outcomes
|
|
269
|
+
|
|
270
|
+
This comprehensive analysis will provide:
|
|
271
|
+
- **Complete Task Inventory**: All deployment tasks identified and categorized
|
|
272
|
+
- **Pipeline Health Assessment**: CI/CD pipeline status and performance analysis
|
|
273
|
+
- **Accurate Progress Tracking**: Real-time deployment progress calculation
|
|
274
|
+
- **Completion Verification**: Rigorous completion verification with outcome rules
|
|
275
|
+
- **Risk Management**: Comprehensive risk assessment and mitigation
|
|
276
|
+
- **Quality Assurance**: Quality metrics and compliance verification
|
|
277
|
+
- **Stakeholder Reporting**: Executive dashboards and progress reports
|
|
278
|
+
|
|
279
|
+
## Deployment Excellence
|
|
280
|
+
|
|
281
|
+
This analysis ensures:
|
|
282
|
+
- **Visibility**: Complete visibility into deployment status and progress
|
|
283
|
+
- **Quality**: High-quality deployments meeting all criteria
|
|
284
|
+
- **Reliability**: Reliable deployment processes with risk mitigation
|
|
285
|
+
- **Compliance**: Compliance with outcome rules and standards
|
|
286
|
+
- **Efficiency**: Optimized deployment processes and timelines
|
|
287
|
+
- **Accountability**: Clear accountability and sign-off processes
|
|
288
|
+
|
|
289
|
+
## Integration with AI Agents
|
|
290
|
+
|
|
291
|
+
The deployment analysis integrates with AI agents for:
|
|
292
|
+
- **Automated Monitoring**: Continuous monitoring of deployment progress
|
|
293
|
+
- **Intelligent Alerting**: Smart alerts for issues and bottlenecks
|
|
294
|
+
- **Predictive Analysis**: Predictive insights for deployment success
|
|
295
|
+
- **Automated Remediation**: Automated issue resolution and optimization
|
|
296
|
+
- **Continuous Improvement**: Learning from deployment patterns and outcomes
|
|
297
|
+
`,
|
|
298
|
+
},
|
|
299
|
+
],
|
|
300
|
+
};
|
|
301
|
+
}
|
|
302
|
+
default:
|
|
303
|
+
throw new McpAdrError(`Unknown analysis type: ${analysisType}`, 'INVALID_INPUT');
|
|
304
|
+
}
|
|
305
|
+
}
|
|
306
|
+
catch (error) {
|
|
307
|
+
throw new McpAdrError(`Failed to analyze deployment progress: ${error instanceof Error ? error.message : String(error)}`, 'DEPLOYMENT_ANALYSIS_ERROR');
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
//# sourceMappingURL=deployment-analysis-tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"deployment-analysis-tool.js","sourceRoot":"","sources":["../../../src/tools/deployment-analysis-tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MCP Tool for environment context analysis
|
|
3
|
+
* Implements prompt-driven environment analysis and compliance assessment
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
* Analyze environment context and provide optimization recommendations
|
|
7
|
+
*/
|
|
8
|
+
export declare function analyzeEnvironment(args: {
|
|
9
|
+
projectPath?: string;
|
|
10
|
+
adrDirectory?: string;
|
|
11
|
+
analysisType?: 'specs' | 'containerization' | 'requirements' | 'compliance' | 'comprehensive';
|
|
12
|
+
currentEnvironment?: any;
|
|
13
|
+
requirements?: any;
|
|
14
|
+
industryStandards?: string[];
|
|
15
|
+
}): Promise<any>;
|
|
16
|
+
//# sourceMappingURL=environment-analysis-tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"environment-analysis-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/environment-analysis-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,GAAG,kBAAkB,GAAG,cAAc,GAAG,YAAY,GAAG,eAAe,CAAC;IAC9F,kBAAkB,CAAC,EAAE,GAAG,CAAC;IACzB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,GAAG,OAAO,CAAC,GAAG,CAAC,CAkUf"}
|
|
@@ -0,0 +1,298 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MCP Tool for environment context analysis
|
|
3
|
+
* Implements prompt-driven environment analysis and compliance assessment
|
|
4
|
+
*/
|
|
5
|
+
import { McpAdrError } from '../types/index.js';
|
|
6
|
+
/**
|
|
7
|
+
* Analyze environment context and provide optimization recommendations
|
|
8
|
+
*/
|
|
9
|
+
export async function analyzeEnvironment(args) {
|
|
10
|
+
const { projectPath = process.cwd(), adrDirectory = 'docs/adrs', analysisType = 'comprehensive', currentEnvironment, requirements, industryStandards, } = args;
|
|
11
|
+
try {
|
|
12
|
+
const { analyzeEnvironmentSpecs, detectContainerization, determineEnvironmentRequirements, assessEnvironmentCompliance, } = await import('../utils/environment-analysis.js');
|
|
13
|
+
switch (analysisType) {
|
|
14
|
+
case 'specs': {
|
|
15
|
+
const result = await analyzeEnvironmentSpecs(projectPath);
|
|
16
|
+
return {
|
|
17
|
+
content: [
|
|
18
|
+
{
|
|
19
|
+
type: 'text',
|
|
20
|
+
text: `# Environment Specification Analysis
|
|
21
|
+
|
|
22
|
+
${result.instructions}
|
|
23
|
+
|
|
24
|
+
## AI Analysis Prompt
|
|
25
|
+
|
|
26
|
+
${result.analysisPrompt}
|
|
27
|
+
|
|
28
|
+
## Next Steps
|
|
29
|
+
|
|
30
|
+
1. **Submit the prompt** to an AI agent for comprehensive environment analysis
|
|
31
|
+
2. **Parse the JSON response** to get environment specifications and infrastructure details
|
|
32
|
+
3. **Review infrastructure requirements** and quality attributes
|
|
33
|
+
4. **Use findings** for environment optimization and planning
|
|
34
|
+
|
|
35
|
+
## Expected Output
|
|
36
|
+
|
|
37
|
+
The AI will provide:
|
|
38
|
+
- **Environment Analysis**: Overall environment type, complexity, and maturity assessment
|
|
39
|
+
- **Infrastructure Details**: Compute, networking, storage, and security components
|
|
40
|
+
- **Containerization**: Container technology detection and configuration analysis
|
|
41
|
+
- **Cloud Services**: Cloud platform and managed service identification
|
|
42
|
+
- **Configuration**: Environment variable and secret management analysis
|
|
43
|
+
- **Quality Attributes**: Availability, scalability, performance, and security assessment
|
|
44
|
+
- **Recommendations**: Prioritized improvement suggestions with implementation guidance
|
|
45
|
+
- **Gaps**: Missing or inadequate infrastructure components
|
|
46
|
+
|
|
47
|
+
## Environment Optimization
|
|
48
|
+
|
|
49
|
+
Use the analysis results to:
|
|
50
|
+
- **Optimize Resource Allocation**: Right-size compute and storage resources
|
|
51
|
+
- **Improve Security Posture**: Implement security best practices and compliance
|
|
52
|
+
- **Enhance Scalability**: Design for growth and load handling
|
|
53
|
+
- **Reduce Costs**: Optimize cloud service usage and resource efficiency
|
|
54
|
+
- **Increase Reliability**: Implement redundancy and disaster recovery
|
|
55
|
+
`,
|
|
56
|
+
},
|
|
57
|
+
],
|
|
58
|
+
};
|
|
59
|
+
}
|
|
60
|
+
case 'containerization': {
|
|
61
|
+
const result = await detectContainerization(projectPath);
|
|
62
|
+
return {
|
|
63
|
+
content: [
|
|
64
|
+
{
|
|
65
|
+
type: 'text',
|
|
66
|
+
text: `# Containerization Technology Detection
|
|
67
|
+
|
|
68
|
+
${result.instructions}
|
|
69
|
+
|
|
70
|
+
## AI Detection Prompt
|
|
71
|
+
|
|
72
|
+
${result.detectionPrompt}
|
|
73
|
+
|
|
74
|
+
## Next Steps
|
|
75
|
+
|
|
76
|
+
1. **Submit the prompt** to an AI agent for containerization analysis
|
|
77
|
+
2. **Parse the JSON response** to get containerization assessment
|
|
78
|
+
3. **Review security findings** and best practice compliance
|
|
79
|
+
4. **Implement recommendations** for container optimization
|
|
80
|
+
|
|
81
|
+
## Expected Output
|
|
82
|
+
|
|
83
|
+
The AI will provide:
|
|
84
|
+
- **Containerization Status**: Detection of container technologies and maturity level
|
|
85
|
+
- **Dockerfile Analysis**: Security, optimization, and best practice evaluation
|
|
86
|
+
- **Compose Configuration**: Service orchestration and networking analysis
|
|
87
|
+
- **Kubernetes Resources**: Manifest analysis and resource management evaluation
|
|
88
|
+
- **Build Configuration**: Multi-stage builds and optimization assessment
|
|
89
|
+
- **Resource Management**: CPU, memory limits and scaling policies
|
|
90
|
+
- **Best Practices**: Security, performance, and operational best practices
|
|
91
|
+
- **Security Findings**: Vulnerability assessment and remediation guidance
|
|
92
|
+
- **Recommendations**: Prioritized improvements for container optimization
|
|
93
|
+
|
|
94
|
+
## Container Optimization
|
|
95
|
+
|
|
96
|
+
Use the detection results to:
|
|
97
|
+
- **Improve Security**: Implement container security best practices
|
|
98
|
+
- **Optimize Performance**: Right-size resources and optimize builds
|
|
99
|
+
- **Enhance Reliability**: Add health checks and proper resource limits
|
|
100
|
+
- **Reduce Image Size**: Use minimal base images and multi-stage builds
|
|
101
|
+
- **Automate Scanning**: Implement security scanning in CI/CD pipelines
|
|
102
|
+
`,
|
|
103
|
+
},
|
|
104
|
+
],
|
|
105
|
+
};
|
|
106
|
+
}
|
|
107
|
+
case 'requirements': {
|
|
108
|
+
const result = await determineEnvironmentRequirements(adrDirectory);
|
|
109
|
+
return {
|
|
110
|
+
content: [
|
|
111
|
+
{
|
|
112
|
+
type: 'text',
|
|
113
|
+
text: `# Environment Requirements from ADRs
|
|
114
|
+
|
|
115
|
+
${result.instructions}
|
|
116
|
+
|
|
117
|
+
## AI Requirements Prompt
|
|
118
|
+
|
|
119
|
+
${result.requirementsPrompt}
|
|
120
|
+
|
|
121
|
+
## Next Steps
|
|
122
|
+
|
|
123
|
+
1. **Submit the prompt** to an AI agent for requirements extraction
|
|
124
|
+
2. **Parse the JSON response** to get environment requirements
|
|
125
|
+
3. **Review requirement completeness** and identify gaps
|
|
126
|
+
4. **Use requirements** for environment design and compliance assessment
|
|
127
|
+
|
|
128
|
+
## Expected Output
|
|
129
|
+
|
|
130
|
+
The AI will provide:
|
|
131
|
+
- **Infrastructure Requirements**: Compute, networking, storage, and availability needs
|
|
132
|
+
- **Platform Requirements**: Containerization, cloud services, and database needs
|
|
133
|
+
- **Security Requirements**: Compliance, access control, and data protection needs
|
|
134
|
+
- **Performance Requirements**: Response time, throughput, and scalability needs
|
|
135
|
+
- **Operational Requirements**: Monitoring, deployment, and maintenance needs
|
|
136
|
+
- **Requirement Traceability**: Links back to specific ADRs
|
|
137
|
+
- **Gaps**: Missing or unclear requirements
|
|
138
|
+
- **Recommendations**: Suggested requirement clarifications and additions
|
|
139
|
+
|
|
140
|
+
## Requirements Management
|
|
141
|
+
|
|
142
|
+
Use the extracted requirements to:
|
|
143
|
+
- **Design Environment**: Create infrastructure that meets all requirements
|
|
144
|
+
- **Assess Compliance**: Compare current environment against requirements
|
|
145
|
+
- **Plan Improvements**: Prioritize environment enhancements
|
|
146
|
+
- **Validate Decisions**: Ensure ADR requirements are properly implemented
|
|
147
|
+
- **Track Changes**: Monitor requirement evolution over time
|
|
148
|
+
`,
|
|
149
|
+
},
|
|
150
|
+
],
|
|
151
|
+
};
|
|
152
|
+
}
|
|
153
|
+
case 'compliance': {
|
|
154
|
+
if (!currentEnvironment || !requirements) {
|
|
155
|
+
throw new McpAdrError('Current environment and requirements are required for compliance assessment', 'INVALID_INPUT');
|
|
156
|
+
}
|
|
157
|
+
const result = await assessEnvironmentCompliance(currentEnvironment, requirements, industryStandards);
|
|
158
|
+
return {
|
|
159
|
+
content: [
|
|
160
|
+
{
|
|
161
|
+
type: 'text',
|
|
162
|
+
text: `# Environment Compliance Assessment
|
|
163
|
+
|
|
164
|
+
${result.instructions}
|
|
165
|
+
|
|
166
|
+
## AI Compliance Prompt
|
|
167
|
+
|
|
168
|
+
${result.compliancePrompt}
|
|
169
|
+
|
|
170
|
+
## Next Steps
|
|
171
|
+
|
|
172
|
+
1. **Submit the prompt** to an AI agent for compliance assessment
|
|
173
|
+
2. **Parse the JSON response** to get detailed compliance evaluation
|
|
174
|
+
3. **Review violations** and prioritize remediation efforts
|
|
175
|
+
4. **Implement improvement plan** based on recommendations
|
|
176
|
+
|
|
177
|
+
## Expected Output
|
|
178
|
+
|
|
179
|
+
The AI will provide:
|
|
180
|
+
- **Compliance Assessment**: Overall compliance score and status
|
|
181
|
+
- **Category Scores**: Infrastructure, security, performance, operational compliance
|
|
182
|
+
- **Compliance Details**: Requirement-by-requirement assessment
|
|
183
|
+
- **Violations**: Specific compliance violations with remediation guidance
|
|
184
|
+
- **Strengths**: Areas where compliance exceeds requirements
|
|
185
|
+
- **Recommendations**: Prioritized improvement recommendations
|
|
186
|
+
- **Improvement Plan**: Phased implementation roadmap with timelines
|
|
187
|
+
- **Risk Assessment**: Risk analysis and mitigation strategies
|
|
188
|
+
- **Compliance Metrics**: Quantitative measurements and targets
|
|
189
|
+
|
|
190
|
+
## Compliance Management
|
|
191
|
+
|
|
192
|
+
Use the assessment results to:
|
|
193
|
+
- **Prioritize Fixes**: Address critical violations first
|
|
194
|
+
- **Plan Improvements**: Implement systematic compliance improvements
|
|
195
|
+
- **Track Progress**: Monitor compliance score improvements over time
|
|
196
|
+
- **Manage Risk**: Mitigate identified compliance risks
|
|
197
|
+
- **Demonstrate Compliance**: Provide evidence for audits and certifications
|
|
198
|
+
`,
|
|
199
|
+
},
|
|
200
|
+
],
|
|
201
|
+
};
|
|
202
|
+
}
|
|
203
|
+
case 'comprehensive': {
|
|
204
|
+
const specsResult = await analyzeEnvironmentSpecs(projectPath);
|
|
205
|
+
const containerResult = await detectContainerization(projectPath);
|
|
206
|
+
const requirementsResult = await determineEnvironmentRequirements(adrDirectory);
|
|
207
|
+
return {
|
|
208
|
+
content: [
|
|
209
|
+
{
|
|
210
|
+
type: 'text',
|
|
211
|
+
text: `# Comprehensive Environment Analysis
|
|
212
|
+
|
|
213
|
+
This comprehensive analysis will examine all aspects of your environment context and provide optimization recommendations.
|
|
214
|
+
|
|
215
|
+
## Environment Specification Analysis
|
|
216
|
+
|
|
217
|
+
${specsResult.instructions}
|
|
218
|
+
|
|
219
|
+
### Environment Analysis Prompt
|
|
220
|
+
|
|
221
|
+
${specsResult.analysisPrompt}
|
|
222
|
+
|
|
223
|
+
## Containerization Detection
|
|
224
|
+
|
|
225
|
+
${containerResult.instructions}
|
|
226
|
+
|
|
227
|
+
### Containerization Detection Prompt
|
|
228
|
+
|
|
229
|
+
${containerResult.detectionPrompt}
|
|
230
|
+
|
|
231
|
+
## Environment Requirements from ADRs
|
|
232
|
+
|
|
233
|
+
${requirementsResult.instructions}
|
|
234
|
+
|
|
235
|
+
### Requirements Analysis Prompt
|
|
236
|
+
|
|
237
|
+
${requirementsResult.requirementsPrompt}
|
|
238
|
+
|
|
239
|
+
## Comprehensive Workflow
|
|
240
|
+
|
|
241
|
+
### 1. **Environment Specification Analysis** (First Step)
|
|
242
|
+
Submit the environment analysis prompt to understand current infrastructure
|
|
243
|
+
|
|
244
|
+
### 2. **Containerization Detection** (Second Step)
|
|
245
|
+
Submit the containerization detection prompt to analyze container technologies
|
|
246
|
+
|
|
247
|
+
### 3. **Requirements Extraction** (Third Step)
|
|
248
|
+
Submit the requirements analysis prompt to extract ADR-based requirements
|
|
249
|
+
|
|
250
|
+
### 4. **Compliance Assessment** (Fourth Step)
|
|
251
|
+
Use the compliance assessment tool with results from previous steps:
|
|
252
|
+
\`\`\`json
|
|
253
|
+
{
|
|
254
|
+
"tool": "analyze_environment",
|
|
255
|
+
"args": {
|
|
256
|
+
"analysisType": "compliance",
|
|
257
|
+
"currentEnvironment": [results from steps 1-2],
|
|
258
|
+
"requirements": [results from step 3],
|
|
259
|
+
"industryStandards": ["GDPR", "SOC2", "ISO27001"]
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
\`\`\`
|
|
263
|
+
|
|
264
|
+
### 5. **Optimization Implementation**
|
|
265
|
+
Apply recommendations from all analyses for comprehensive environment optimization
|
|
266
|
+
|
|
267
|
+
## Expected Outcomes
|
|
268
|
+
|
|
269
|
+
This comprehensive analysis will provide:
|
|
270
|
+
- **Complete Environment Understanding**: Full picture of current infrastructure
|
|
271
|
+
- **Technology Assessment**: Evaluation of containerization and cloud technologies
|
|
272
|
+
- **Requirements Clarity**: Clear understanding of ADR-based requirements
|
|
273
|
+
- **Compliance Status**: Assessment against requirements and standards
|
|
274
|
+
- **Optimization Roadmap**: Prioritized improvements with implementation guidance
|
|
275
|
+
- **Risk Mitigation**: Identification and mitigation of environment risks
|
|
276
|
+
|
|
277
|
+
## Quality Assurance
|
|
278
|
+
|
|
279
|
+
All analyses follow these principles:
|
|
280
|
+
- **Evidence-based**: Conclusions based on actual configuration files
|
|
281
|
+
- **Best Practice Alignment**: Comparison against industry standards
|
|
282
|
+
- **Security Focus**: Emphasis on security and compliance
|
|
283
|
+
- **Practical Recommendations**: Actionable improvement suggestions
|
|
284
|
+
- **Risk Assessment**: Identification of potential risks and mitigation strategies
|
|
285
|
+
`,
|
|
286
|
+
},
|
|
287
|
+
],
|
|
288
|
+
};
|
|
289
|
+
}
|
|
290
|
+
default:
|
|
291
|
+
throw new McpAdrError(`Unknown analysis type: ${analysisType}`, 'INVALID_INPUT');
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
catch (error) {
|
|
295
|
+
throw new McpAdrError(`Failed to analyze environment: ${error instanceof Error ? error.message : String(error)}`, 'ENVIRONMENT_ANALYSIS_ERROR');
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
//# sourceMappingURL=environment-analysis-tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"environment-analysis-tool.js","sourceRoot":"","sources":["../../../src/tools/environment-analysis-tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MCP Tool for research integration and findings incorporation
|
|
3
|
+
* Implements prompt-driven research analysis and ADR impact evaluation
|
|
4
|
+
*/
|
|
5
|
+
/**
|
|
6
|
+
* Incorporate research findings into architectural decisions
|
|
7
|
+
*/
|
|
8
|
+
export declare function incorporateResearch(args: {
|
|
9
|
+
researchPath?: string;
|
|
10
|
+
adrDirectory?: string;
|
|
11
|
+
analysisType?: 'monitor' | 'extract_topics' | 'evaluate_impact' | 'generate_updates' | 'comprehensive';
|
|
12
|
+
existingTopics?: string[];
|
|
13
|
+
researchTopics?: Array<{
|
|
14
|
+
id: string;
|
|
15
|
+
title: string;
|
|
16
|
+
category: string;
|
|
17
|
+
keyFindings: string[];
|
|
18
|
+
relevanceScore: number;
|
|
19
|
+
}>;
|
|
20
|
+
adrId?: string;
|
|
21
|
+
updateType?: 'content' | 'status' | 'consequences' | 'alternatives' | 'deprecation';
|
|
22
|
+
researchFindings?: Array<{
|
|
23
|
+
finding: string;
|
|
24
|
+
evidence: string[];
|
|
25
|
+
impact: string;
|
|
26
|
+
}>;
|
|
27
|
+
}): Promise<any>;
|
|
28
|
+
/**
|
|
29
|
+
* Create research template file
|
|
30
|
+
*/
|
|
31
|
+
export declare function createResearchTemplate(args: {
|
|
32
|
+
title: string;
|
|
33
|
+
category?: string;
|
|
34
|
+
researchPath?: string;
|
|
35
|
+
}): Promise<any>;
|
|
36
|
+
/**
|
|
37
|
+
* Request action confirmation for research-based changes
|
|
38
|
+
*/
|
|
39
|
+
export declare function requestActionConfirmation(args: {
|
|
40
|
+
action: string;
|
|
41
|
+
details: string;
|
|
42
|
+
impact?: 'low' | 'medium' | 'high' | 'critical';
|
|
43
|
+
}): Promise<any>;
|
|
44
|
+
//# sourceMappingURL=research-integration-tool.d.ts.map
|