mcp-adr-analysis-server 2.1.22 → 2.1.28

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 (40) hide show
  1. package/README.md +63 -1
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/src/index.d.ts.map +1 -1
  4. package/dist/src/index.js +370 -0
  5. package/dist/src/index.js.map +1 -1
  6. package/dist/src/tools/adr-aggregator-tools.d.ts +185 -0
  7. package/dist/src/tools/adr-aggregator-tools.d.ts.map +1 -0
  8. package/dist/src/tools/adr-aggregator-tools.js +872 -0
  9. package/dist/src/tools/adr-aggregator-tools.js.map +1 -0
  10. package/dist/src/tools/analyze-gaps-tool.d.ts +57 -0
  11. package/dist/src/tools/analyze-gaps-tool.d.ts.map +1 -0
  12. package/dist/src/tools/analyze-gaps-tool.js +727 -0
  13. package/dist/src/tools/analyze-gaps-tool.js.map +1 -0
  14. package/dist/src/tools/tool-catalog.d.ts +1 -1
  15. package/dist/src/tools/tool-catalog.d.ts.map +1 -1
  16. package/dist/src/tools/tool-catalog.js +382 -0
  17. package/dist/src/tools/tool-catalog.js.map +1 -1
  18. package/dist/src/tools/tool-dispatcher.d.ts.map +1 -1
  19. package/dist/src/tools/tool-dispatcher.js +4 -0
  20. package/dist/src/tools/tool-dispatcher.js.map +1 -1
  21. package/dist/src/types/adr-aggregator.d.ts +692 -0
  22. package/dist/src/types/adr-aggregator.d.ts.map +1 -0
  23. package/dist/src/types/adr-aggregator.js +8 -0
  24. package/dist/src/types/adr-aggregator.js.map +1 -0
  25. package/dist/src/types/index.d.ts +3 -2
  26. package/dist/src/types/index.d.ts.map +1 -1
  27. package/dist/src/types/memory-entities.d.ts +48 -48
  28. package/dist/src/utils/adr-aggregator-client.d.ts +177 -0
  29. package/dist/src/utils/adr-aggregator-client.d.ts.map +1 -0
  30. package/dist/src/utils/adr-aggregator-client.js +396 -0
  31. package/dist/src/utils/adr-aggregator-client.js.map +1 -0
  32. package/dist/src/utils/config.d.ts +3 -0
  33. package/dist/src/utils/config.d.ts.map +1 -1
  34. package/dist/src/utils/config.js +13 -0
  35. package/dist/src/utils/config.js.map +1 -1
  36. package/dist/src/utils/git-remote-detector.d.ts +67 -0
  37. package/dist/src/utils/git-remote-detector.d.ts.map +1 -0
  38. package/dist/src/utils/git-remote-detector.js +194 -0
  39. package/dist/src/utils/git-remote-detector.js.map +1 -0
  40. package/package.json +3 -3
@@ -0,0 +1,185 @@
1
+ /**
2
+ * ADR Aggregator Integration Tools
3
+ * MCP tools for bidirectional sync with https://adraggregator.com
4
+ *
5
+ * @see NEW_FEATURE.md for API documentation
6
+ */
7
+ import type { ToolContext } from '../types/tool-context.js';
8
+ import type { ImplementationStatus } from '../types/adr-aggregator.js';
9
+ /**
10
+ * Arguments for sync_to_aggregator tool
11
+ */
12
+ export interface SyncToAggregatorArgs {
13
+ /** Replace all ADRs instead of incremental sync */
14
+ full_sync?: boolean;
15
+ /** Include analysis metadata in sync */
16
+ include_metadata?: boolean;
17
+ /** Include Mermaid diagrams (Pro+ tier) */
18
+ include_diagrams?: boolean;
19
+ /** Include timeline/staleness data */
20
+ include_timeline?: boolean;
21
+ /** Include security scan results */
22
+ include_security_scan?: boolean;
23
+ /** Include AST-based code links (Pro+ tier) */
24
+ include_code_links?: boolean;
25
+ /** Specific ADR paths to sync (syncs all if not provided) */
26
+ adr_paths?: string[];
27
+ /** Project path (defaults to PROJECT_PATH) */
28
+ projectPath?: string;
29
+ }
30
+ /**
31
+ * Arguments for get_adr_context tool
32
+ */
33
+ export interface GetAdrContextArgs {
34
+ /** Include Mermaid diagrams (Pro+ tier) */
35
+ include_diagrams?: boolean;
36
+ /** Include timeline data */
37
+ include_timeline?: boolean;
38
+ /** Include code links (Pro+ tier) */
39
+ include_code_links?: boolean;
40
+ /** Include research context (Pro+ tier) */
41
+ include_research?: boolean;
42
+ /** Filter by staleness level */
43
+ staleness_filter?: 'all' | 'fresh' | 'stale' | 'very_stale';
44
+ /** Knowledge graph depth (Team tier) */
45
+ graph_depth?: number;
46
+ /** Project path (defaults to PROJECT_PATH) */
47
+ projectPath?: string;
48
+ }
49
+ /**
50
+ * Arguments for get_staleness_report tool
51
+ */
52
+ export interface GetStalenessReportArgs {
53
+ /** Days threshold for staleness */
54
+ threshold?: number;
55
+ /** Project path (defaults to PROJECT_PATH) */
56
+ projectPath?: string;
57
+ }
58
+ /**
59
+ * Arguments for get_adr_templates tool
60
+ */
61
+ export interface GetAdrTemplatesArgs {
62
+ /** Domain filter (web_application, microservices, api, etc.) */
63
+ domain?: string;
64
+ }
65
+ /**
66
+ * Arguments for get_adr_diagrams tool (Pro+ tier)
67
+ */
68
+ export interface GetAdrDiagramsArgs {
69
+ /** Specific ADR path (returns all if not specified) */
70
+ adr_path?: string;
71
+ /** Project path (defaults to PROJECT_PATH) */
72
+ projectPath?: string;
73
+ }
74
+ /**
75
+ * Arguments for validate_adr_compliance tool (Pro+ tier)
76
+ */
77
+ export interface ValidateAdrComplianceArgs {
78
+ /** Specific ADR paths to validate */
79
+ adr_paths?: string[];
80
+ /** Type of validation to perform */
81
+ validation_type?: 'implementation' | 'architecture' | 'security' | 'all';
82
+ /** Project path (defaults to PROJECT_PATH) */
83
+ projectPath?: string;
84
+ }
85
+ /**
86
+ * Arguments for get_knowledge_graph tool (Team tier)
87
+ */
88
+ export interface GetKnowledgeGraphArgs {
89
+ /** Scope of the graph */
90
+ scope?: 'repository' | 'organization';
91
+ /** Include graph analytics and insights */
92
+ include_analytics?: boolean;
93
+ /** Project path (defaults to PROJECT_PATH) */
94
+ projectPath?: string;
95
+ }
96
+ /**
97
+ * Standard tool result format
98
+ */
99
+ export interface ToolResult {
100
+ content: Array<{
101
+ type: 'text';
102
+ text: string;
103
+ }>;
104
+ isError?: boolean;
105
+ }
106
+ /**
107
+ * Sync ADRs to ADR Aggregator platform
108
+ *
109
+ * POST /functions/v1/mcp-sync-adr
110
+ */
111
+ export declare function syncToAggregator(args: SyncToAggregatorArgs, context?: ToolContext): Promise<ToolResult>;
112
+ /**
113
+ * Get ADR context from aggregator
114
+ *
115
+ * GET /functions/v1/mcp-get-context
116
+ */
117
+ export declare function getAdrContext(args: GetAdrContextArgs, context?: ToolContext): Promise<ToolResult>;
118
+ /**
119
+ * Get staleness report from aggregator
120
+ *
121
+ * GET /functions/v1/mcp-staleness-report
122
+ */
123
+ export declare function getStalenessReport(args: GetStalenessReportArgs, context?: ToolContext): Promise<ToolResult>;
124
+ /**
125
+ * Get ADR templates from aggregator
126
+ *
127
+ * GET /functions/v1/mcp-get-templates
128
+ */
129
+ export declare function getAdrTemplates(args: GetAdrTemplatesArgs, context?: ToolContext): Promise<ToolResult>;
130
+ /**
131
+ * Get Mermaid diagrams from aggregator (Pro+ tier)
132
+ *
133
+ * GET /functions/v1/mcp-get-diagrams
134
+ */
135
+ export declare function getAdrDiagrams(args: GetAdrDiagramsArgs, context?: ToolContext): Promise<ToolResult>;
136
+ /**
137
+ * Validate ADR compliance via aggregator (Pro+ tier)
138
+ *
139
+ * POST /functions/v1/mcp-validate-compliance
140
+ */
141
+ export declare function validateAdrCompliance(args: ValidateAdrComplianceArgs, context?: ToolContext): Promise<ToolResult>;
142
+ /**
143
+ * Get knowledge graph from aggregator (Team tier)
144
+ *
145
+ * GET /functions/v1/mcp-get-knowledge-graph
146
+ */
147
+ export declare function getKnowledgeGraph(args: GetKnowledgeGraphArgs, context?: ToolContext): Promise<ToolResult>;
148
+ /**
149
+ * Arguments for update_implementation_status tool (Pro+ tier)
150
+ */
151
+ export interface UpdateImplementationStatusArgs {
152
+ /** Array of status updates to apply */
153
+ updates: Array<{
154
+ /** Path to the ADR file relative to project root */
155
+ adr_path: string;
156
+ /** New implementation status */
157
+ implementation_status: ImplementationStatus;
158
+ /** Optional notes about the status change */
159
+ notes?: string;
160
+ }>;
161
+ /** Project path (defaults to PROJECT_PATH) */
162
+ projectPath?: string;
163
+ }
164
+ /**
165
+ * Update implementation status of synced ADRs (Pro+ tier)
166
+ *
167
+ * POST /functions/v1/mcp-update-implementation-status
168
+ */
169
+ export declare function updateAdrImplementationStatus(args: UpdateImplementationStatusArgs, context?: ToolContext): Promise<ToolResult>;
170
+ /**
171
+ * Arguments for get_adr_priorities tool
172
+ */
173
+ export interface GetAdrPrioritiesArgs {
174
+ /** Include AI-based priority recommendations */
175
+ include_ai?: boolean;
176
+ /** Project path (defaults to PROJECT_PATH) */
177
+ projectPath?: string;
178
+ }
179
+ /**
180
+ * Get ADR priorities for roadmap/backlog planning
181
+ *
182
+ * GET /functions/v1/mcp-get-priorities
183
+ */
184
+ export declare function getAdrPriorities(args: GetAdrPrioritiesArgs, context?: ToolContext): Promise<ToolResult>;
185
+ //# sourceMappingURL=adr-aggregator-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adr-aggregator-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/adr-aggregator-tools.ts"],"names":[],"mappings":"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"}