mcp-adr-analysis-server 2.1.0 → 2.1.11

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.
Files changed (94) hide show
  1. package/dist/.tsbuildinfo +1 -1
  2. package/dist/src/index.d.ts +9 -0
  3. package/dist/src/index.d.ts.map +1 -1
  4. package/dist/src/index.js +129 -0
  5. package/dist/src/index.js.map +1 -1
  6. package/dist/src/templates/domain-knowledge-templates.d.ts.map +1 -1
  7. package/dist/src/templates/domain-knowledge-templates.js +49 -49
  8. package/dist/src/templates/domain-knowledge-templates.js.map +1 -1
  9. package/dist/src/tools/adr-suggestion-tool.d.ts +2 -2
  10. package/dist/src/tools/adr-suggestion-tool.d.ts.map +1 -1
  11. package/dist/src/tools/adr-suggestion-tool.js +125 -11
  12. package/dist/src/tools/adr-suggestion-tool.js.map +1 -1
  13. package/dist/src/tools/adr-validation-tool.d.ts +46 -0
  14. package/dist/src/tools/adr-validation-tool.d.ts.map +1 -0
  15. package/dist/src/tools/adr-validation-tool.js +320 -0
  16. package/dist/src/tools/adr-validation-tool.js.map +1 -0
  17. package/dist/src/tools/deployment-analysis-tool.d.ts.map +1 -1
  18. package/dist/src/tools/deployment-analysis-tool.js +35 -1
  19. package/dist/src/tools/deployment-analysis-tool.js.map +1 -1
  20. package/dist/src/tools/deployment-guidance-tool.d.ts.map +1 -1
  21. package/dist/src/tools/deployment-guidance-tool.js +78 -24
  22. package/dist/src/tools/deployment-guidance-tool.js.map +1 -1
  23. package/dist/src/tools/deployment-readiness-tool.d.ts.map +1 -1
  24. package/dist/src/tools/deployment-readiness-tool.js +151 -4
  25. package/dist/src/tools/deployment-readiness-tool.js.map +1 -1
  26. package/dist/src/tools/environment-analysis-tool.d.ts.map +1 -1
  27. package/dist/src/tools/environment-analysis-tool.js +36 -1
  28. package/dist/src/tools/environment-analysis-tool.js.map +1 -1
  29. package/dist/src/tools/interactive-adr-planning-tool.d.ts.map +1 -1
  30. package/dist/src/tools/interactive-adr-planning-tool.js +82 -9
  31. package/dist/src/tools/interactive-adr-planning-tool.js.map +1 -1
  32. package/dist/src/tools/perform-research-tool.d.ts +17 -0
  33. package/dist/src/tools/perform-research-tool.d.ts.map +1 -0
  34. package/dist/src/tools/perform-research-tool.js +180 -0
  35. package/dist/src/tools/perform-research-tool.js.map +1 -0
  36. package/dist/src/tools/research-question-tool.d.ts.map +1 -1
  37. package/dist/src/tools/research-question-tool.js +11 -9
  38. package/dist/src/tools/research-question-tool.js.map +1 -1
  39. package/dist/src/tools/review-existing-adrs-tool.d.ts.map +1 -1
  40. package/dist/src/tools/review-existing-adrs-tool.js +38 -2
  41. package/dist/src/tools/review-existing-adrs-tool.js.map +1 -1
  42. package/dist/src/tools/troubleshoot-guided-workflow-tool.d.ts.map +1 -1
  43. package/dist/src/tools/troubleshoot-guided-workflow-tool.js +89 -0
  44. package/dist/src/tools/troubleshoot-guided-workflow-tool.js.map +1 -1
  45. package/dist/src/types/conversation-context.d.ts.map +1 -1
  46. package/dist/src/types/conversation-context.js +12 -12
  47. package/dist/src/types/conversation-context.js.map +1 -1
  48. package/dist/src/utils/ai-executor.d.ts.map +1 -1
  49. package/dist/src/utils/ai-executor.js +3 -3
  50. package/dist/src/utils/ai-executor.js.map +1 -1
  51. package/dist/src/utils/apply-cot-enhancement.d.ts.map +1 -1
  52. package/dist/src/utils/apply-cot-enhancement.js +15 -15
  53. package/dist/src/utils/apply-cot-enhancement.js.map +1 -1
  54. package/dist/src/utils/automatic-prompt-engineering.d.ts.map +1 -1
  55. package/dist/src/utils/automatic-prompt-engineering.js +68 -58
  56. package/dist/src/utils/automatic-prompt-engineering.js.map +1 -1
  57. package/dist/src/utils/deployment-analysis.d.ts.map +1 -1
  58. package/dist/src/utils/deployment-analysis.js +13 -8
  59. package/dist/src/utils/deployment-analysis.js.map +1 -1
  60. package/dist/src/utils/environment-analysis.d.ts.map +1 -1
  61. package/dist/src/utils/environment-analysis.js +59 -43
  62. package/dist/src/utils/environment-analysis.js.map +1 -1
  63. package/dist/src/utils/environment-capability-registry.d.ts +101 -0
  64. package/dist/src/utils/environment-capability-registry.d.ts.map +1 -0
  65. package/dist/src/utils/environment-capability-registry.js +489 -0
  66. package/dist/src/utils/environment-capability-registry.js.map +1 -0
  67. package/dist/src/utils/index.d.ts +3 -3
  68. package/dist/src/utils/index.d.ts.map +1 -1
  69. package/dist/src/utils/index.js +3 -3
  70. package/dist/src/utils/index.js.map +1 -1
  71. package/dist/src/utils/knowledge-generation.d.ts.map +1 -1
  72. package/dist/src/utils/knowledge-generation.js +61 -35
  73. package/dist/src/utils/knowledge-generation.js.map +1 -1
  74. package/dist/src/utils/knowledge-graph-manager.d.ts +4 -0
  75. package/dist/src/utils/knowledge-graph-manager.d.ts.map +1 -1
  76. package/dist/src/utils/knowledge-graph-manager.js +8 -0
  77. package/dist/src/utils/knowledge-graph-manager.js.map +1 -1
  78. package/dist/src/utils/llm-artifact-detector.d.ts.map +1 -1
  79. package/dist/src/utils/llm-artifact-detector.js +28 -24
  80. package/dist/src/utils/llm-artifact-detector.js.map +1 -1
  81. package/dist/src/utils/prompt-composition.d.ts.map +1 -1
  82. package/dist/src/utils/prompt-composition.js +1 -4
  83. package/dist/src/utils/prompt-composition.js.map +1 -1
  84. package/dist/src/utils/reflexion.d.ts.map +1 -1
  85. package/dist/src/utils/reflexion.js +51 -42
  86. package/dist/src/utils/reflexion.js.map +1 -1
  87. package/dist/src/utils/research-orchestrator.d.ts +77 -0
  88. package/dist/src/utils/research-orchestrator.d.ts.map +1 -0
  89. package/dist/src/utils/research-orchestrator.js +450 -0
  90. package/dist/src/utils/research-orchestrator.js.map +1 -0
  91. package/dist/src/utils/tree-sitter-analyzer.d.ts.map +1 -1
  92. package/dist/src/utils/tree-sitter-analyzer.js +83 -11
  93. package/dist/src/utils/tree-sitter-analyzer.js.map +1 -1
  94. package/package.json +2 -2
package/dist/src/index.js CHANGED
@@ -792,6 +792,69 @@ export class McpAdrAnalysisServer {
792
792
  },
793
793
  },
794
794
  },
795
+ {
796
+ name: 'validate_adr',
797
+ description: 'Validate an existing ADR against actual infrastructure reality using research-driven analysis',
798
+ inputSchema: {
799
+ type: 'object',
800
+ properties: {
801
+ adrPath: {
802
+ type: 'string',
803
+ description: 'Path to the ADR file to validate (relative or absolute)',
804
+ },
805
+ projectPath: {
806
+ type: 'string',
807
+ description: 'Path to the project directory',
808
+ default: '.',
809
+ },
810
+ adrDirectory: {
811
+ type: 'string',
812
+ description: 'Directory containing ADR files',
813
+ default: 'docs/adrs',
814
+ },
815
+ includeEnvironmentCheck: {
816
+ type: 'boolean',
817
+ description: 'Include live environment verification in validation',
818
+ default: true,
819
+ },
820
+ confidenceThreshold: {
821
+ type: 'number',
822
+ description: 'Minimum research confidence threshold (0-1)',
823
+ default: 0.6,
824
+ },
825
+ },
826
+ required: ['adrPath'],
827
+ },
828
+ },
829
+ {
830
+ name: 'validate_all_adrs',
831
+ description: 'Validate all ADRs in a directory against actual infrastructure reality',
832
+ inputSchema: {
833
+ type: 'object',
834
+ properties: {
835
+ projectPath: {
836
+ type: 'string',
837
+ description: 'Path to the project directory',
838
+ default: '.',
839
+ },
840
+ adrDirectory: {
841
+ type: 'string',
842
+ description: 'Directory containing ADR files',
843
+ default: 'docs/adrs',
844
+ },
845
+ includeEnvironmentCheck: {
846
+ type: 'boolean',
847
+ description: 'Include live environment verification in validation',
848
+ default: true,
849
+ },
850
+ minConfidence: {
851
+ type: 'number',
852
+ description: 'Minimum research confidence for validation (0-1)',
853
+ default: 0.6,
854
+ },
855
+ },
856
+ },
857
+ },
795
858
  {
796
859
  name: 'incorporate_research',
797
860
  description: 'Incorporate research findings into architectural decisions',
@@ -1203,6 +1266,42 @@ export class McpAdrAnalysisServer {
1203
1266
  },
1204
1267
  },
1205
1268
  },
1269
+ {
1270
+ name: 'perform_research',
1271
+ description: 'Perform research using cascading sources: project files → knowledge graph → environment resources → web search (fallback)',
1272
+ inputSchema: {
1273
+ type: 'object',
1274
+ properties: {
1275
+ question: {
1276
+ type: 'string',
1277
+ description: 'The research question to answer',
1278
+ },
1279
+ projectPath: {
1280
+ type: 'string',
1281
+ description: 'Path to project directory',
1282
+ default: '.',
1283
+ },
1284
+ adrDirectory: {
1285
+ type: 'string',
1286
+ description: 'Directory containing ADR files',
1287
+ default: 'docs/adrs',
1288
+ },
1289
+ confidenceThreshold: {
1290
+ type: 'number',
1291
+ description: 'Minimum confidence threshold (0-1) before suggesting web search',
1292
+ default: 0.6,
1293
+ minimum: 0,
1294
+ maximum: 1,
1295
+ },
1296
+ performWebSearch: {
1297
+ type: 'boolean',
1298
+ description: 'Enable web search recommendations when confidence is low',
1299
+ default: true,
1300
+ },
1301
+ },
1302
+ required: ['question'],
1303
+ },
1304
+ },
1206
1305
  {
1207
1306
  name: 'analyze_deployment_progress',
1208
1307
  description: 'Analyze deployment progress and verify completion with outcome rules',
@@ -2761,6 +2860,12 @@ export class McpAdrAnalysisServer {
2761
2860
  case 'review_existing_adrs':
2762
2861
  response = await this.reviewExistingAdrs(safeArgs);
2763
2862
  break;
2863
+ case 'validate_adr':
2864
+ response = await this.validateAdr(safeArgs);
2865
+ break;
2866
+ case 'validate_all_adrs':
2867
+ response = await this.validateAllAdrs(safeArgs);
2868
+ break;
2764
2869
  case 'incorporate_research':
2765
2870
  response = await this.incorporateResearch(safeArgs);
2766
2871
  break;
@@ -2785,6 +2890,9 @@ export class McpAdrAnalysisServer {
2785
2890
  case 'generate_research_questions':
2786
2891
  response = await this.generateResearchQuestions(safeArgs);
2787
2892
  break;
2893
+ case 'perform_research':
2894
+ response = await this.performResearch(safeArgs);
2895
+ break;
2788
2896
  case 'analyze_deployment_progress':
2789
2897
  response = await this.analyzeDeploymentProgress(safeArgs);
2790
2898
  break;
@@ -5552,6 +5660,17 @@ Please provide:
5552
5660
  const { reviewExistingAdrs } = await import('./tools/review-existing-adrs-tool.js');
5553
5661
  return await reviewExistingAdrs(args);
5554
5662
  }
5663
+ /**
5664
+ * ADR validation tool implementations
5665
+ */
5666
+ async validateAdr(args) {
5667
+ const { validateAdr } = await import('./tools/adr-validation-tool.js');
5668
+ return await validateAdr(args);
5669
+ }
5670
+ async validateAllAdrs(args) {
5671
+ const { validateAllAdrs } = await import('./tools/adr-validation-tool.js');
5672
+ return await validateAllAdrs(args);
5673
+ }
5555
5674
  /**
5556
5675
  * Research integration tool implementations
5557
5676
  */
@@ -5596,6 +5715,16 @@ Please provide:
5596
5715
  const { generateResearchQuestions } = await import('./tools/research-question-tool.js');
5597
5716
  return await generateResearchQuestions(args);
5598
5717
  }
5718
+ /**
5719
+ * Perform research tool implementation
5720
+ */
5721
+ async performResearch(args) {
5722
+ if (!('question' in args) || typeof args['question'] !== 'string') {
5723
+ throw new McpAdrError('Missing required parameter: question', 'INVALID_ARGUMENTS');
5724
+ }
5725
+ const { performResearch } = await import('./tools/perform-research-tool.js');
5726
+ return await performResearch(args);
5727
+ }
5599
5728
  /**
5600
5729
  * Deployment analysis tool implementation
5601
5730
  */