mcp-adr-analysis-server 2.1.20 → 2.1.27

package/dist/src/resources/server-context-resource.js

@@ -0,0 +1,104 @@
+/**
+ * Server Context Resource - Current server state and capabilities
+ * URI Pattern: adr://server/context
+ */
+import { McpAdrError } from '../types/index.js';
+import { resourceCache, generateETag } from './resource-cache.js';
+import { resourceRouter } from './resource-router.js';
+/**
+ * Generate server context resource showing current state, memory, and capabilities.
+ *
+ * Returns a comprehensive markdown-formatted context that includes:
+ * - Server configuration and status
+ * - Validated deployment patterns
+ * - MCP resources catalog
+ * - Memory and knowledge graph status
+ * - Recent deployment activity
+ * - Usage recommendations
+ *
+ * **URI Pattern:** `adr://server/context`
+ *
+ * **Query Parameters:**
+ * - `includeDetailed`: Include detailed information (default: true)
+ * - `maxRecentItems`: Maximum number of recent items to show (default: 5)
+ * - `projectPath`: Override project root path (default: process.cwd())
+ *
+ * @param params - URL path parameters (none for this resource)
+ * @param searchParams - URL query parameters for customization
+ *
+ * @returns Promise resolving to resource generation result containing:
+ *   - data: Server context data with markdown content
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: Unique identifier "server-context"
+ *   - ttl: Cache duration (60 seconds / 1 minute)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When context generation fails
+ *
+ * @example
+ * ```typescript
+ * // Get server context with defaults
+ * const context = await generateServerContextResource(
+ *   {},
+ *   new URLSearchParams()
+ * );
+ *
+ * console.log(context.data.context); // Markdown-formatted context
+ *
+ * // Get abbreviated context
+ * const brief = await generateServerContextResource(
+ *   {},
+ *   new URLSearchParams('includeDetailed=false&maxRecentItems=3')
+ * );
+ * ```
+ *
+ * @since v2.2.0
+ * @see {@link ServerContextGenerator} for context generation logic
+ */
+export async function generateServerContextResource(_params, searchParams, kgManager, memoryManager, conversationManager) {
+    const cacheKey = 'server-context';
+    // Check cache
+    const cached = await resourceCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    try {
+        const includeDetailed = searchParams.get('includeDetailed') !== 'false';
+        const maxRecentItems = parseInt(searchParams.get('maxRecentItems') || '5', 10);
+        const projectPath = searchParams.get('projectPath') || process.cwd();
+        // If managers are not provided, we'll generate basic context
+        // In practice, these should be injected from the MCP server
+        if (!kgManager || !memoryManager || !conversationManager) {
+            throw new McpAdrError('Server context requires initialized managers. Access this resource through the MCP server.', 'RESOURCE_GENERATION_ERROR');
+        }
+        // Generate context using ServerContextGenerator
+        const { ServerContextGenerator: Generator } = await import('../utils/server-context-generator.js');
+        const generator = new Generator();
+        const contextContent = await generator.generateContext(kgManager, memoryManager, conversationManager, { includeDetailed, maxRecentItems });
+        const contextData = {
+            context: contextContent,
+            timestamp: new Date().toISOString(),
+            projectPath,
+            includeDetailed,
+            maxRecentItems,
+        };
+        const result = {
+            data: contextData,
+            contentType: 'application/json',
+            lastModified: new Date().toISOString(),
+            cacheKey,
+            ttl: 60, // 1 minute cache (context changes frequently)
+            etag: generateETag(contextData),
+        };
+        // Cache result
+        resourceCache.set(cacheKey, result, result.ttl);
+        return result;
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to generate server context: ${error instanceof Error ? error.message : String(error)}`, 'RESOURCE_GENERATION_ERROR');
+    }
+}
+// Register route
+resourceRouter.register('/server/context', generateServerContextResource, 'Current server state and capabilities');
+//# sourceMappingURL=server-context-resource.js.map

package/dist/src/resources/server-context-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-context-resource.js","sourceRoot":"","sources":["../../../src/resources/server-context-resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAatD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAA+B,EAC/B,YAA6B,EAC7B,SAAiC,EACjC,aAAmC,EACnC,mBAA+C;IAE/C,MAAM,QAAQ,GAAG,gBAAgB,CAAC;IAElC,cAAc;IACd,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,CAA2B,QAAQ,CAAC,CAAC;IAC3E,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,YAAY,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,OAAO,CAAC;QACxE,MAAM,cAAc,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/E,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAErE,6DAA6D;QAC7D,4DAA4D;QAC5D,IAAI,CAAC,SAAS,IAAI,CAAC,aAAa,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzD,MAAM,IAAI,WAAW,CACnB,4FAA4F,EAC5F,2BAA2B,CAC5B,CAAC;QACJ,CAAC;QAED,gDAAgD;QAChD,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CACxD,sCAAsC,CACvC,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;QAClC,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,eAAe,CACpD,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,EAAE,eAAe,EAAE,cAAc,EAAE,CACpC,CAAC;QAEF,MAAM,WAAW,GAAsB;YACrC,OAAO,EAAE,cAAc;YACvB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,WAAW;YACX,eAAe;YACf,cAAc;SACf,CAAC;QAEF,MAAM,MAAM,GAA6B;YACvC,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,kBAAkB;YAC/B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,QAAQ;YACR,GAAG,EAAE,EAAE,EAAE,8CAA8C;YACvD,IAAI,EAAE,YAAY,CAAC,WAAW,CAAC;SAChC,CAAC;QAEF,eAAe;QACf,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CACnB,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC9F,2BAA2B,CAC5B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,iBAAiB;AACjB,cAAc,CAAC,QAAQ,CACrB,iBAAiB,EACjB,6BAA6B,EAC7B,uCAAuC,CACxC,CAAC"}

package/dist/src/resources/tool-catalog-resource.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Tool Catalog Resource - Comprehensive tool metadata registry
+ * URI Pattern: adr://tools/catalog
+ */
+import { URLSearchParams } from 'url';
+import { ResourceGenerationResult } from './index.js';
+export interface ToolCatalogData {
+    summary: {
+        totalTools: number;
+        byCategory: Record<string, number>;
+        cemcpEnabled: number;
+        highTokenCost: number;
+    };
+    tools: Array<{
+        name: string;
+        description: string;
+        category: string;
+        complexity: string;
+        tokenCost: {
+            min: number;
+            max: number;
+        };
+        hasCEMCPDirective: boolean;
+        requiresAI: boolean;
+        relatedTools: string[];
+        keywords: string[];
+    }>;
+    timestamp: string;
+}
+/**
+ * Generate tool catalog resource with comprehensive tool metadata.
+ *
+ * Returns a complete catalog of all available MCP tools with:
+ * - Tool metadata (name, description, category, complexity)
+ * - Token cost estimates and CE-MCP availability
+ * - Related tools and keyword tags
+ * - Summary statistics by category
+ *
+ * **URI Pattern:** `adr://tools/catalog`
+ *
+ * **Query Parameters:**
+ * - `category`: Filter by tool category (optional)
+ * - `includeSchema`: Include full input schemas (default: false)
+ * - `lightweight`: Return minimal metadata only (default: false)
+ *
+ * @param params - URL path parameters (none for this resource)
+ * @param searchParams - URL query parameters for filtering
+ *
+ * @returns Promise resolving to resource generation result containing:
+ *   - data: Complete tool catalog with metadata
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: Unique identifier "tool-catalog" or "tool-catalog:{category}"
+ *   - ttl: Cache duration (300 seconds / 5 minutes)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When catalog generation fails
+ *
+ * @example
+ * ```typescript
+ * // Get full tool catalog
+ * const catalog = await generateToolCatalogResource(
+ *   {},
+ *   new URLSearchParams()
+ * );
+ *
+ * console.log(`Total tools: ${catalog.data.summary.totalTools}`);
+ * console.log(`CE-MCP enabled: ${catalog.data.summary.cemcpEnabled}`);
+ *
+ * // Filter by category
+ * const adrTools = await generateToolCatalogResource(
+ *   {},
+ *   new URLSearchParams('category=adr')
+ * );
+ *
+ * // Get lightweight catalog (minimal metadata)
+ * const lightweight = await generateToolCatalogResource(
+ *   {},
+ *   new URLSearchParams('lightweight=true')
+ * );
+ *
+ * // Expected output structure:
+ * {
+ *   data: {
+ *     summary: {
+ *       totalTools: 60,
+ *       byCategory: {
+ *         analysis: 10,
+ *         adr: 15,
+ *         deployment: 8,
+ *         ...
+ *       },
+ *       cemcpEnabled: 25,
+ *       highTokenCost: 12
+ *     },
+ *     tools: [
+ *       {
+ *         name: "analyze_project_ecosystem",
+ *         description: "Comprehensive project analysis...",
+ *         category: "analysis",
+ *         complexity: "complex",
+ *         tokenCost: { min: 5000, max: 15000 },
+ *         hasCEMCPDirective: true,
+ *         requiresAI: true,
+ *         relatedTools: ["get_architectural_context"],
+ *         keywords: ["analysis", "ecosystem", "project"]
+ *       },
+ *       ...
+ *     ],
+ *     timestamp: "2025-12-16T04:30:00.000Z"
+ *   },
+ *   contentType: "application/json",
+ *   cacheKey: "tool-catalog",
+ *   ttl: 300
+ * }
+ * ```
+ *
+ * @since v2.2.0
+ * @see {@link TOOL_CATALOG} for the underlying tool registry
+ */
+export declare function generateToolCatalogResource(_params: Record<string, string>, searchParams: URLSearchParams): Promise<ResourceGenerationResult>;
+//# sourceMappingURL=tool-catalog-resource.d.ts.map

package/dist/src/resources/tool-catalog-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-catalog-resource.d.ts","sourceRoot":"","sources":["../../../src/resources/tool-catalog-resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAGtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGtD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QACxC,iBAAiB,EAAE,OAAO,CAAC;QAC3B,UAAU,EAAE,OAAO,CAAC;QACpB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,YAAY,EAAE,eAAe,GAC5B,OAAO,CAAC,wBAAwB,CAAC,CAgFnC"}

package/dist/src/resources/tool-catalog-resource.js

@@ -0,0 +1,167 @@
+/**
+ * Tool Catalog Resource - Comprehensive tool metadata registry
+ * URI Pattern: adr://tools/catalog
+ */
+import { McpAdrError } from '../types/index.js';
+import { resourceCache, generateETag } from './resource-cache.js';
+import { resourceRouter } from './resource-router.js';
+/**
+ * Generate tool catalog resource with comprehensive tool metadata.
+ *
+ * Returns a complete catalog of all available MCP tools with:
+ * - Tool metadata (name, description, category, complexity)
+ * - Token cost estimates and CE-MCP availability
+ * - Related tools and keyword tags
+ * - Summary statistics by category
+ *
+ * **URI Pattern:** `adr://tools/catalog`
+ *
+ * **Query Parameters:**
+ * - `category`: Filter by tool category (optional)
+ * - `includeSchema`: Include full input schemas (default: false)
+ * - `lightweight`: Return minimal metadata only (default: false)
+ *
+ * @param params - URL path parameters (none for this resource)
+ * @param searchParams - URL query parameters for filtering
+ *
+ * @returns Promise resolving to resource generation result containing:
+ *   - data: Complete tool catalog with metadata
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: Unique identifier "tool-catalog" or "tool-catalog:{category}"
+ *   - ttl: Cache duration (300 seconds / 5 minutes)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When catalog generation fails
+ *
+ * @example
+ * ```typescript
+ * // Get full tool catalog
+ * const catalog = await generateToolCatalogResource(
+ *   {},
+ *   new URLSearchParams()
+ * );
+ *
+ * console.log(`Total tools: ${catalog.data.summary.totalTools}`);
+ * console.log(`CE-MCP enabled: ${catalog.data.summary.cemcpEnabled}`);
+ *
+ * // Filter by category
+ * const adrTools = await generateToolCatalogResource(
+ *   {},
+ *   new URLSearchParams('category=adr')
+ * );
+ *
+ * // Get lightweight catalog (minimal metadata)
+ * const lightweight = await generateToolCatalogResource(
+ *   {},
+ *   new URLSearchParams('lightweight=true')
+ * );
+ *
+ * // Expected output structure:
+ * {
+ *   data: {
+ *     summary: {
+ *       totalTools: 60,
+ *       byCategory: {
+ *         analysis: 10,
+ *         adr: 15,
+ *         deployment: 8,
+ *         ...
+ *       },
+ *       cemcpEnabled: 25,
+ *       highTokenCost: 12
+ *     },
+ *     tools: [
+ *       {
+ *         name: "analyze_project_ecosystem",
+ *         description: "Comprehensive project analysis...",
+ *         category: "analysis",
+ *         complexity: "complex",
+ *         tokenCost: { min: 5000, max: 15000 },
+ *         hasCEMCPDirective: true,
+ *         requiresAI: true,
+ *         relatedTools: ["get_architectural_context"],
+ *         keywords: ["analysis", "ecosystem", "project"]
+ *       },
+ *       ...
+ *     ],
+ *     timestamp: "2025-12-16T04:30:00.000Z"
+ *   },
+ *   contentType: "application/json",
+ *   cacheKey: "tool-catalog",
+ *   ttl: 300
+ * }
+ * ```
+ *
+ * @since v2.2.0
+ * @see {@link TOOL_CATALOG} for the underlying tool registry
+ */
+export async function generateToolCatalogResource(_params, searchParams) {
+    const category = searchParams.get('category');
+    const includeSchema = searchParams.get('includeSchema') === 'true';
+    const lightweight = searchParams.get('lightweight') === 'true';
+    const cacheKey = category ? `tool-catalog:${category}` : 'tool-catalog';
+    // Check cache
+    const cached = await resourceCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    try {
+        // Dynamically import the tool catalog to avoid circular dependencies
+        const { getCatalogSummary, searchTools } = await import('../tools/tool-catalog.js');
+        // Get summary statistics
+        const summary = getCatalogSummary();
+        // Get tools (filtered by category if specified)
+        const searchResult = category
+            ? searchTools({ category: category, includeSchema, limit: 1000 })
+            : searchTools({ includeSchema, limit: 1000 });
+        // Format tools based on lightweight flag
+        const tools = searchResult.tools.map(tool => {
+            if (lightweight) {
+                return {
+                    name: tool.name,
+                    description: tool.shortDescription,
+                    category: tool.category,
+                    hasCEMCPDirective: tool.hasCEMCPDirective,
+                };
+            }
+            const formatted = {
+                name: tool.name,
+                description: tool.fullDescription,
+                category: tool.category,
+                complexity: tool.complexity,
+                tokenCost: tool.tokenCost,
+                hasCEMCPDirective: tool.hasCEMCPDirective,
+                requiresAI: tool.requiresAI,
+                relatedTools: tool.relatedTools,
+                keywords: tool.keywords,
+            };
+            if (includeSchema) {
+                formatted.inputSchema = tool.inputSchema;
+            }
+            return formatted;
+        });
+        const catalogData = {
+            summary,
+            tools,
+            timestamp: new Date().toISOString(),
+        };
+        const result = {
+            data: catalogData,
+            contentType: 'application/json',
+            lastModified: new Date().toISOString(),
+            cacheKey,
+            ttl: 300, // 5 minutes cache (catalog is relatively static)
+            etag: generateETag(catalogData),
+        };
+        // Cache result
+        resourceCache.set(cacheKey, result, result.ttl);
+        return result;
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to generate tool catalog: ${error instanceof Error ? error.message : String(error)}`, 'RESOURCE_GENERATION_ERROR');
+    }
+}
+// Register route
+resourceRouter.register('/tools/catalog', generateToolCatalogResource, 'Comprehensive tool metadata registry');
+//# sourceMappingURL=tool-catalog-resource.js.map

package/dist/src/resources/tool-catalog-resource.js.map

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

package/dist/src/tools/adr-aggregator-tools.d.ts

@@ -0,0 +1,185 @@
+/**
+ * ADR Aggregator Integration Tools
+ * MCP tools for bidirectional sync with https://adraggregator.com
+ *
+ * @see NEW_FEATURE.md for API documentation
+ */
+import type { ToolContext } from '../types/tool-context.js';
+import type { ImplementationStatus } from '../types/adr-aggregator.js';
+/**
+ * Arguments for sync_to_aggregator tool
+ */
+export interface SyncToAggregatorArgs {
+    /** Replace all ADRs instead of incremental sync */
+    full_sync?: boolean;
+    /** Include analysis metadata in sync */
+    include_metadata?: boolean;
+    /** Include Mermaid diagrams (Pro+ tier) */
+    include_diagrams?: boolean;
+    /** Include timeline/staleness data */
+    include_timeline?: boolean;
+    /** Include security scan results */
+    include_security_scan?: boolean;
+    /** Include AST-based code links (Pro+ tier) */
+    include_code_links?: boolean;
+    /** Specific ADR paths to sync (syncs all if not provided) */
+    adr_paths?: string[];
+    /** Project path (defaults to PROJECT_PATH) */
+    projectPath?: string;
+}
+/**
+ * Arguments for get_adr_context tool
+ */
+export interface GetAdrContextArgs {
+    /** Include Mermaid diagrams (Pro+ tier) */
+    include_diagrams?: boolean;
+    /** Include timeline data */
+    include_timeline?: boolean;
+    /** Include code links (Pro+ tier) */
+    include_code_links?: boolean;
+    /** Include research context (Pro+ tier) */
+    include_research?: boolean;
+    /** Filter by staleness level */
+    staleness_filter?: 'all' | 'fresh' | 'stale' | 'very_stale';
+    /** Knowledge graph depth (Team tier) */
+    graph_depth?: number;
+    /** Project path (defaults to PROJECT_PATH) */
+    projectPath?: string;
+}
+/**
+ * Arguments for get_staleness_report tool
+ */
+export interface GetStalenessReportArgs {
+    /** Days threshold for staleness */
+    threshold?: number;
+    /** Project path (defaults to PROJECT_PATH) */
+    projectPath?: string;
+}
+/**
+ * Arguments for get_adr_templates tool
+ */
+export interface GetAdrTemplatesArgs {
+    /** Domain filter (web_application, microservices, api, etc.) */
+    domain?: string;
+}
+/**
+ * Arguments for get_adr_diagrams tool (Pro+ tier)
+ */
+export interface GetAdrDiagramsArgs {
+    /** Specific ADR path (returns all if not specified) */
+    adr_path?: string;
+    /** Project path (defaults to PROJECT_PATH) */
+    projectPath?: string;
+}
+/**
+ * Arguments for validate_adr_compliance tool (Pro+ tier)
+ */
+export interface ValidateAdrComplianceArgs {
+    /** Specific ADR paths to validate */
+    adr_paths?: string[];
+    /** Type of validation to perform */
+    validation_type?: 'implementation' | 'architecture' | 'security' | 'all';
+    /** Project path (defaults to PROJECT_PATH) */
+    projectPath?: string;
+}
+/**
+ * Arguments for get_knowledge_graph tool (Team tier)
+ */
+export interface GetKnowledgeGraphArgs {
+    /** Scope of the graph */
+    scope?: 'repository' | 'organization';
+    /** Include graph analytics and insights */
+    include_analytics?: boolean;
+    /** Project path (defaults to PROJECT_PATH) */
+    projectPath?: string;
+}
+/**
+ * Standard tool result format
+ */
+export interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Sync ADRs to ADR Aggregator platform
+ *
+ * POST /functions/v1/mcp-sync-adr
+ */
+export declare function syncToAggregator(args: SyncToAggregatorArgs, context?: ToolContext): Promise<ToolResult>;
+/**
+ * Get ADR context from aggregator
+ *
+ * GET /functions/v1/mcp-get-context
+ */
+export declare function getAdrContext(args: GetAdrContextArgs, context?: ToolContext): Promise<ToolResult>;
+/**
+ * Get staleness report from aggregator
+ *
+ * GET /functions/v1/mcp-staleness-report
+ */
+export declare function getStalenessReport(args: GetStalenessReportArgs, context?: ToolContext): Promise<ToolResult>;
+/**
+ * Get ADR templates from aggregator
+ *
+ * GET /functions/v1/mcp-get-templates
+ */
+export declare function getAdrTemplates(args: GetAdrTemplatesArgs, context?: ToolContext): Promise<ToolResult>;
+/**
+ * Get Mermaid diagrams from aggregator (Pro+ tier)
+ *
+ * GET /functions/v1/mcp-get-diagrams
+ */
+export declare function getAdrDiagrams(args: GetAdrDiagramsArgs, context?: ToolContext): Promise<ToolResult>;
+/**
+ * Validate ADR compliance via aggregator (Pro+ tier)
+ *
+ * POST /functions/v1/mcp-validate-compliance
+ */
+export declare function validateAdrCompliance(args: ValidateAdrComplianceArgs, context?: ToolContext): Promise<ToolResult>;
+/**
+ * Get knowledge graph from aggregator (Team tier)
+ *
+ * GET /functions/v1/mcp-get-knowledge-graph
+ */
+export declare function getKnowledgeGraph(args: GetKnowledgeGraphArgs, context?: ToolContext): Promise<ToolResult>;
+/**
+ * Arguments for update_implementation_status tool (Pro+ tier)
+ */
+export interface UpdateImplementationStatusArgs {
+    /** Array of status updates to apply */
+    updates: Array<{
+        /** Path to the ADR file relative to project root */
+        adr_path: string;
+        /** New implementation status */
+        implementation_status: ImplementationStatus;
+        /** Optional notes about the status change */
+        notes?: string;
+    }>;
+    /** Project path (defaults to PROJECT_PATH) */
+    projectPath?: string;
+}
+/**
+ * Update implementation status of synced ADRs (Pro+ tier)
+ *
+ * POST /functions/v1/mcp-update-implementation-status
+ */
+export declare function updateAdrImplementationStatus(args: UpdateImplementationStatusArgs, context?: ToolContext): Promise<ToolResult>;
+/**
+ * Arguments for get_adr_priorities tool
+ */
+export interface GetAdrPrioritiesArgs {
+    /** Include AI-based priority recommendations */
+    include_ai?: boolean;
+    /** Project path (defaults to PROJECT_PATH) */
+    projectPath?: string;
+}
+/**
+ * Get ADR priorities for roadmap/backlog planning
+ *
+ * GET /functions/v1/mcp-get-priorities
+ */
+export declare function getAdrPriorities(args: GetAdrPrioritiesArgs, context?: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=adr-aggregator-tools.d.ts.map

package/dist/src/tools/adr-aggregator-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-aggregator-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/adr-aggregator-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAO5D,OAAO,KAAK,EAUV,oBAAoB,EAErB,MAAM,4BAA4B,CAAC;AAQpC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oCAAoC;IACpC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4BAA4B;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,CAAC;IAC5D,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,oCAAoC;IACpC,eAAe,CAAC,EAAE,gBAAgB,GAAG,cAAc,GAAG,UAAU,GAAG,KAAK,CAAC;IACzE,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yBAAyB;IACzB,KAAK,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;IACtC,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA6HD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAkHrB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAgErB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CA0ErB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CA2ErB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAuFrB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,EAC/B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAuErB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAuFrB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,uCAAuC;IACvC,OAAO,EAAE,KAAK,CAAC;QACb,oDAAoD;QACpD,QAAQ,EAAE,MAAM,CAAC;QACjB,gCAAgC;QAChC,qBAAqB,EAAE,oBAAoB,CAAC;QAC5C,6CAA6C;QAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,8BAA8B,EACpC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CA0GrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAkIrB"}