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.
- package/README.md +63 -1
- package/dist/.tsbuildinfo +1 -1
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +370 -0
- package/dist/src/index.js.map +1 -1
- package/dist/src/tools/adr-aggregator-tools.d.ts +185 -0
- package/dist/src/tools/adr-aggregator-tools.d.ts.map +1 -0
- package/dist/src/tools/adr-aggregator-tools.js +872 -0
- package/dist/src/tools/adr-aggregator-tools.js.map +1 -0
- package/dist/src/tools/analyze-gaps-tool.d.ts +57 -0
- package/dist/src/tools/analyze-gaps-tool.d.ts.map +1 -0
- package/dist/src/tools/analyze-gaps-tool.js +727 -0
- package/dist/src/tools/analyze-gaps-tool.js.map +1 -0
- package/dist/src/tools/tool-catalog.d.ts +1 -1
- package/dist/src/tools/tool-catalog.d.ts.map +1 -1
- package/dist/src/tools/tool-catalog.js +382 -0
- package/dist/src/tools/tool-catalog.js.map +1 -1
- package/dist/src/tools/tool-dispatcher.d.ts.map +1 -1
- package/dist/src/tools/tool-dispatcher.js +4 -0
- package/dist/src/tools/tool-dispatcher.js.map +1 -1
- package/dist/src/types/adr-aggregator.d.ts +692 -0
- package/dist/src/types/adr-aggregator.d.ts.map +1 -0
- package/dist/src/types/adr-aggregator.js +8 -0
- package/dist/src/types/adr-aggregator.js.map +1 -0
- package/dist/src/types/index.d.ts +3 -2
- package/dist/src/types/index.d.ts.map +1 -1
- package/dist/src/types/memory-entities.d.ts +48 -48
- package/dist/src/utils/adr-aggregator-client.d.ts +177 -0
- package/dist/src/utils/adr-aggregator-client.d.ts.map +1 -0
- package/dist/src/utils/adr-aggregator-client.js +396 -0
- package/dist/src/utils/adr-aggregator-client.js.map +1 -0
- package/dist/src/utils/config.d.ts +3 -0
- package/dist/src/utils/config.d.ts.map +1 -1
- package/dist/src/utils/config.js +13 -0
- package/dist/src/utils/config.js.map +1 -1
- package/dist/src/utils/git-remote-detector.d.ts +67 -0
- package/dist/src/utils/git-remote-detector.d.ts.map +1 -0
- package/dist/src/utils/git-remote-detector.js +194 -0
- package/dist/src/utils/git-remote-detector.js.map +1 -0
- 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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"}
|