mcp-adr-analysis-server 2.1.20 → 2.1.22

package/dist/src/resources/adrs-discovered-resource.js

@@ -0,0 +1,174 @@
+/**
+ * ADRs Discovered Resource - ADR discovery and summary
+ * URI Pattern: adr://adrs/discovered
+ */
+import * as path from 'path';
+import { McpAdrError } from '../types/index.js';
+import { resourceCache, generateETag } from './resource-cache.js';
+import { resourceRouter } from './resource-router.js';
+/**
+ * Generate ADRs discovered resource with discovery results and summary.
+ *
+ * Discovers and catalogs all Architectural Decision Records (ADRs) in a project:
+ * - Scans configured ADR directory for decision records
+ * - Extracts metadata (title, status, date, category)
+ * - Generates summary statistics by status and category
+ * - Provides recommendations for ADR management
+ *
+ * **URI Pattern:** `adr://adrs/discovered`
+ *
+ * **Query Parameters:**
+ * - `projectPath`: Override project root path (default: process.cwd())
+ * - `adrDirectory`: Override ADR directory (default: docs/adrs)
+ * - `includeContent`: Include full ADR content (default: false)
+ * - `includeTimeline`: Include timeline analysis (default: false)
+ *
+ * @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: ADR discovery results with summaries
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: Unique identifier "adrs-discovered" or "adrs-discovered:{projectPath}"
+ *   - ttl: Cache duration (120 seconds / 2 minutes)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When:
+ *   - RESOURCE_NOT_FOUND: ADR directory not found or inaccessible
+ *   - RESOURCE_GENERATION_ERROR: ADR discovery or parsing fails
+ *
+ * @example
+ * ```typescript
+ * // Discover ADRs in default location
+ * const discovered = await generateAdrsDiscoveredResource(
+ *   {},
+ *   new URLSearchParams()
+ * );
+ *
+ * console.log(`Found ${discovered.data.totalAdrs} ADRs`);
+ * console.log(`Accepted: ${discovered.data.summary.byStatus.accepted}`);
+ * console.log(`Proposed: ${discovered.data.summary.byStatus.proposed}`);
+ *
+ * // Discover ADRs in custom location
+ * const custom = await generateAdrsDiscoveredResource(
+ *   {},
+ *   new URLSearchParams('projectPath=/custom/path&adrDirectory=decisions')
+ * );
+ *
+ * // Expected output structure:
+ * {
+ *   data: {
+ *     directory: "/project/docs/adrs",
+ *     totalAdrs: 25,
+ *     adrs: [
+ *       {
+ *         filename: "001-use-postgresql.md",
+ *         title: "Use PostgreSQL for primary database",
+ *         status: "accepted",
+ *         date: "2025-01-15",
+ *         path: "/project/docs/adrs/001-use-postgresql.md",
+ *         number: "001",
+ *         category: "database",
+ *         tags: ["postgresql", "database"]
+ *       },
+ *       ...
+ *     ],
+ *     summary: {
+ *       byStatus: {
+ *         accepted: 20,
+ *         proposed: 3,
+ *         deprecated: 2
+ *       },
+ *       byCategory: {
+ *         database: 5,
+ *         api: 8,
+ *         infrastructure: 7,
+ *         security: 5
+ *       }
+ *     },
+ *     recommendations: [
+ *       "Consider reviewing deprecated ADRs",
+ *       "3 proposed ADRs need decisions"
+ *     ],
+ *     timestamp: "2025-12-16T04:30:00.000Z"
+ *   },
+ *   contentType: "application/json",
+ *   cacheKey: "adrs-discovered",
+ *   ttl: 120
+ * }
+ * ```
+ *
+ * @since v2.2.0
+ * @see {@link discoverAdrsInDirectory} for ADR discovery logic
+ */
+export async function generateAdrsDiscoveredResource(_params, searchParams) {
+    const projectPath = searchParams.get('projectPath') || process.cwd();
+    const adrDirectoryParam = searchParams.get('adrDirectory') || process.env['ADR_DIRECTORY'] || 'docs/adrs';
+    const includeContent = searchParams.get('includeContent') === 'true';
+    const includeTimeline = searchParams.get('includeTimeline') === 'true';
+    const cacheKey = projectPath === process.cwd() ? 'adrs-discovered' : `adrs-discovered:${projectPath}`;
+    // Check cache
+    const cached = await resourceCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    try {
+        // Dynamically import ADR discovery to avoid circular dependencies
+        const { discoverAdrsInDirectory } = await import('../utils/adr-discovery.js');
+        // Resolve ADR directory
+        const adrDirectory = path.resolve(projectPath, adrDirectoryParam);
+        // Discover ADRs
+        const discoveryResult = await discoverAdrsInDirectory(adrDirectory, projectPath, {
+            includeContent,
+            includeTimeline,
+        });
+        // Format ADR list (exclude content for lighter response)
+        const adrs = discoveryResult.adrs.map(adr => {
+            const formatted = {
+                filename: adr.filename,
+                title: adr.title,
+                status: adr.status,
+                path: adr.path,
+            };
+            if (adr.date !== undefined)
+                formatted.date = adr.date;
+            if (adr.metadata?.number !== undefined)
+                formatted.number = adr.metadata.number;
+            if (adr.metadata?.category !== undefined)
+                formatted.category = adr.metadata.category;
+            if (adr.metadata?.tags !== undefined)
+                formatted.tags = adr.metadata.tags;
+            return formatted;
+        });
+        const discoveredData = {
+            directory: discoveryResult.directory,
+            totalAdrs: discoveryResult.totalAdrs,
+            adrs,
+            summary: discoveryResult.summary,
+            recommendations: discoveryResult.recommendations,
+            timestamp: new Date().toISOString(),
+        };
+        const result = {
+            data: discoveredData,
+            contentType: 'application/json',
+            lastModified: new Date().toISOString(),
+            cacheKey,
+            ttl: 120, // 2 minutes cache (ADRs change occasionally)
+            etag: generateETag(discoveredData),
+        };
+        // Cache result
+        resourceCache.set(cacheKey, result, result.ttl);
+        return result;
+    }
+    catch (error) {
+        // Check if it's a directory not found error
+        if (error instanceof Error && error.message.includes('not found')) {
+            throw new McpAdrError(`ADR directory not found: ${adrDirectoryParam}`, 'RESOURCE_NOT_FOUND');
+        }
+        throw new McpAdrError(`Failed to discover ADRs: ${error instanceof Error ? error.message : String(error)}`, 'RESOURCE_GENERATION_ERROR');
+    }
+}
+// Register route
+resourceRouter.register('/adrs/discovered', generateAdrsDiscoveredResource, 'Discovered ADRs with summary');
+//# sourceMappingURL=adrs-discovered-resource.js.map

package/dist/src/resources/adrs-discovered-resource.js.map

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

package/dist/src/resources/adrs-review-resource.d.ts

@@ -0,0 +1,82 @@
+/**
+ * ADRs Review Resource - Review specific ADR against code implementation
+ * URI Pattern: adr://adrs/{id}/review
+ */
+import { URLSearchParams } from 'url';
+import { ResourceGenerationResult } from './index.js';
+export interface AdrReviewData {
+    adrId: string;
+    title: string;
+    status: string;
+    complianceScore: number;
+    codeCompliance: {
+        implemented: boolean;
+        partiallyImplemented: boolean;
+        notImplemented: boolean;
+        evidence: string[];
+        gaps: string[];
+    };
+    recommendations: {
+        updateAdr: boolean;
+        updateCode: boolean;
+        createPlan: boolean;
+        actions: string[];
+    };
+    analysis: string;
+    timestamp: string;
+    projectPath: string;
+    analysisDepth: string;
+}
+/**
+ * Generate ADR review resource showing compliance analysis against code.
+ *
+ * Returns a comprehensive review of a specific ADR including:
+ * - Compliance score against actual implementation
+ * - Evidence of implementation found in code
+ * - Gaps between ADR decisions and code
+ * - Recommendations for updates
+ *
+ * **URI Pattern:** `adr://adrs/{id}/review`
+ *
+ * **Query Parameters:**
+ * - `projectPath`: Override project root path (default: process.cwd())
+ * - `analysisDepth`: 'basic' | 'detailed' | 'comprehensive' (default: 'detailed')
+ * - `includeTreeSitter`: Use tree-sitter for analysis (default: true)
+ *
+ * @param params - URL path parameters containing:
+ *   - id: ADR identifier (e.g., "001", "database-architecture")
+ * @param searchParams - URL query parameters for customization
+ *
+ * @returns Promise resolving to resource generation result containing:
+ *   - data: Complete ADR review data with compliance analysis
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: Unique identifier "adr-review:{id}"
+ *   - ttl: Cache duration (180 seconds / 3 minutes)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When review generation fails
+ *
+ * @example
+ * ```typescript
+ * // Get review for ADR 001
+ * const review = await generateAdrsReviewResource(
+ *   { id: '001' },
+ *   new URLSearchParams()
+ * );
+ *
+ * console.log(`Compliance score: ${review.data.complianceScore}/10`);
+ * console.log(`Gaps: ${review.data.codeCompliance.gaps.join(', ')}`);
+ *
+ * // Comprehensive review with custom project path
+ * const detailed = await generateAdrsReviewResource(
+ *   { id: 'database-architecture' },
+ *   new URLSearchParams('analysisDepth=comprehensive&projectPath=/my/project')
+ * );
+ * ```
+ *
+ * @since v2.2.0
+ * @see {@link reviewExistingAdrs} for the underlying review logic
+ */
+export declare function generateAdrsReviewResource(params: Record<string, string>, searchParams: URLSearchParams): Promise<ResourceGenerationResult>;
+//# sourceMappingURL=adrs-review-resource.d.ts.map

package/dist/src/resources/adrs-review-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adrs-review-resource.d.ts","sourceRoot":"","sources":["../../../src/resources/adrs-review-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,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE;QACd,WAAW,EAAE,OAAO,CAAC;QACrB,oBAAoB,EAAE,OAAO,CAAC;QAC9B,cAAc,EAAE,OAAO,CAAC;QACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,eAAe,EAAE;QACf,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,EAAE,eAAe,GAC5B,OAAO,CAAC,wBAAwB,CAAC,CA8FnC"}

package/dist/src/resources/adrs-review-resource.js

@@ -0,0 +1,160 @@
+/**
+ * ADRs Review Resource - Review specific ADR against code implementation
+ * URI Pattern: adr://adrs/{id}/review
+ */
+import { McpAdrError } from '../types/index.js';
+import { resourceCache, generateETag } from './resource-cache.js';
+import { resourceRouter } from './resource-router.js';
+/**
+ * Generate ADR review resource showing compliance analysis against code.
+ *
+ * Returns a comprehensive review of a specific ADR including:
+ * - Compliance score against actual implementation
+ * - Evidence of implementation found in code
+ * - Gaps between ADR decisions and code
+ * - Recommendations for updates
+ *
+ * **URI Pattern:** `adr://adrs/{id}/review`
+ *
+ * **Query Parameters:**
+ * - `projectPath`: Override project root path (default: process.cwd())
+ * - `analysisDepth`: 'basic' | 'detailed' | 'comprehensive' (default: 'detailed')
+ * - `includeTreeSitter`: Use tree-sitter for analysis (default: true)
+ *
+ * @param params - URL path parameters containing:
+ *   - id: ADR identifier (e.g., "001", "database-architecture")
+ * @param searchParams - URL query parameters for customization
+ *
+ * @returns Promise resolving to resource generation result containing:
+ *   - data: Complete ADR review data with compliance analysis
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: Unique identifier "adr-review:{id}"
+ *   - ttl: Cache duration (180 seconds / 3 minutes)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When review generation fails
+ *
+ * @example
+ * ```typescript
+ * // Get review for ADR 001
+ * const review = await generateAdrsReviewResource(
+ *   { id: '001' },
+ *   new URLSearchParams()
+ * );
+ *
+ * console.log(`Compliance score: ${review.data.complianceScore}/10`);
+ * console.log(`Gaps: ${review.data.codeCompliance.gaps.join(', ')}`);
+ *
+ * // Comprehensive review with custom project path
+ * const detailed = await generateAdrsReviewResource(
+ *   { id: 'database-architecture' },
+ *   new URLSearchParams('analysisDepth=comprehensive&projectPath=/my/project')
+ * );
+ * ```
+ *
+ * @since v2.2.0
+ * @see {@link reviewExistingAdrs} for the underlying review logic
+ */
+export async function generateAdrsReviewResource(params, searchParams) {
+    const id = params['id'];
+    if (!id) {
+        throw new McpAdrError('Missing required parameter: id', 'INVALID_PARAMS');
+    }
+    const projectPath = searchParams.get('projectPath') || process.cwd();
+    const analysisDepth = (searchParams.get('analysisDepth') || 'detailed');
+    const includeTreeSitter = searchParams.get('includeTreeSitter') !== 'false';
+    const cacheKey = `adr-review:${id}:${analysisDepth}`;
+    // Check cache
+    const cached = await resourceCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    try {
+        // Import the review tool dynamically to avoid circular dependencies
+        const { reviewExistingAdrs } = await import('../tools/review-existing-adrs-tool.js');
+        // Perform the review for the specific ADR
+        const reviewResult = await reviewExistingAdrs({
+            projectPath,
+            specificAdr: id,
+            analysisDepth,
+            includeTreeSitter,
+            generateUpdatePlan: true,
+        });
+        // Parse the review result to extract structured data
+        const reviewText = reviewResult.content?.[0]?.text || '';
+        // Extract compliance score from the review
+        const scoreMatch = reviewText.match(/Compliance Score[:\s]*(\d+(?:\.\d+)?)/i);
+        const complianceScore = scoreMatch ? parseFloat(scoreMatch[1]) : 5;
+        // Extract title
+        const titleMatch = reviewText.match(/###\s*([^\n]+)/);
+        const title = titleMatch ? titleMatch[1].trim() : `ADR ${id}`;
+        // Extract status
+        const statusMatch = reviewText.match(/Status[:\s]*(\w+)/i);
+        const status = statusMatch ? statusMatch[1] : 'unknown';
+        // Build structured review data
+        const reviewData = {
+            adrId: id,
+            title,
+            status,
+            complianceScore,
+            codeCompliance: {
+                implemented: complianceScore >= 8,
+                partiallyImplemented: complianceScore >= 5 && complianceScore < 8,
+                notImplemented: complianceScore < 5,
+                evidence: extractListItems(reviewText, 'Evidence Found'),
+                gaps: extractListItems(reviewText, 'Gaps Identified'),
+            },
+            recommendations: {
+                updateAdr: complianceScore < 7,
+                updateCode: complianceScore < 5,
+                createPlan: complianceScore < 5,
+                actions: extractListItems(reviewText, 'Recommendations'),
+            },
+            analysis: reviewText,
+            timestamp: new Date().toISOString(),
+            projectPath,
+            analysisDepth,
+        };
+        const result = {
+            data: reviewData,
+            contentType: 'application/json',
+            lastModified: new Date().toISOString(),
+            cacheKey,
+            ttl: 180, // 3 minutes cache (reviews are somewhat expensive)
+            etag: generateETag(reviewData),
+        };
+        // Cache result
+        resourceCache.set(cacheKey, result, result.ttl);
+        return result;
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to generate ADR review: ${error instanceof Error ? error.message : String(error)}`, 'RESOURCE_GENERATION_ERROR');
+    }
+}
+/**
+ * Extract list items from a section in the review text
+ */
+function extractListItems(text, sectionName) {
+    const items = [];
+    // Find the section
+    const sectionRegex = new RegExp(`(?:#{1,4}\\s*)?${sectionName}[^\\n]*\\n([\\s\\S]*?)(?=#{1,4}|$)`, 'i');
+    const sectionMatch = text.match(sectionRegex);
+    if (sectionMatch && sectionMatch[1]) {
+        const sectionContent = sectionMatch[1];
+        // Extract list items (lines starting with - or *)
+        const listMatches = sectionContent.match(/^[\s]*[-*]\s*(.+)$/gm);
+        if (listMatches) {
+            listMatches.forEach(match => {
+                const item = match.replace(/^[\s]*[-*]\s*/, '').trim();
+                if (item && !item.startsWith('No ')) {
+                    items.push(item);
+                }
+            });
+        }
+    }
+    return items;
+}
+// Register route
+resourceRouter.register('/adrs/{id}/review', generateAdrsReviewResource, 'Review specific ADR against code implementation');
+//# sourceMappingURL=adrs-review-resource.js.map

package/dist/src/resources/adrs-review-resource.js.map

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

package/dist/src/resources/architectural-context-resource.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Architectural Context Resource - Current architectural state and decisions
+ * URI Pattern: adr://architecture/context
+ */
+import { URLSearchParams } from 'url';
+import { ResourceGenerationResult } from './index.js';
+import type { KnowledgeGraphManager } from '../utils/knowledge-graph-manager.js';
+export interface ArchitecturalContextData {
+    summary: {
+        totalAdrs: number;
+        activeDecisions: number;
+        deprecatedDecisions: number;
+        proposedDecisions: number;
+        technologiesUsed: string[];
+        architecturalPatterns: string[];
+    };
+    decisions: Array<{
+        id: string;
+        title: string;
+        status: string;
+        category: string;
+        impact: 'high' | 'medium' | 'low';
+        dependencies: string[];
+    }>;
+    technologyStack: {
+        frontend: string[];
+        backend: string[];
+        database: string[];
+        infrastructure: string[];
+        devops: string[];
+    };
+    patterns: Array<{
+        name: string;
+        description: string;
+        usedIn: string[];
+        relatedAdrs: string[];
+    }>;
+    recommendations: string[];
+    timestamp: string;
+    projectPath: string;
+}
+/**
+ * Generate architectural context resource showing current state and decisions.
+ *
+ * Returns a comprehensive view of the project's architectural state:
+ * - Summary of all ADRs by status
+ * - Technology stack analysis
+ * - Architectural patterns in use
+ * - Recommendations for improvements
+ *
+ * **URI Pattern:** `adr://architecture/context`
+ *
+ * **Query Parameters:**
+ * - `projectPath`: Override project root path (default: process.cwd())
+ * - `includeDeprecated`: Include deprecated decisions (default: true)
+ * - `includeProposed`: Include proposed decisions (default: true)
+ * - `maxDecisions`: Maximum decisions to return (default: 50)
+ *
+ * @param params - URL path parameters (none for this resource)
+ * @param searchParams - URL query parameters for customization
+ * @param kgManager - Optional knowledge graph manager instance
+ *
+ * @returns Promise resolving to resource generation result containing:
+ *   - data: Complete architectural context data
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: Unique identifier "architectural-context"
+ *   - ttl: Cache duration (300 seconds / 5 minutes)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When context generation fails
+ *
+ * @example
+ * ```typescript
+ * // Get full architectural context
+ * const context = await generateArchitecturalContextResource(
+ *   {},
+ *   new URLSearchParams()
+ * );
+ *
+ * console.log(`Total ADRs: ${context.data.summary.totalAdrs}`);
+ * console.log(`Technologies: ${context.data.summary.technologiesUsed.join(', ')}`);
+ *
+ * // Exclude deprecated decisions
+ * const active = await generateArchitecturalContextResource(
+ *   {},
+ *   new URLSearchParams('includeDeprecated=false')
+ * );
+ * ```
+ *
+ * @since v2.2.0
+ * @see {@link KnowledgeGraphManager} for knowledge graph queries
+ */
+export declare function generateArchitecturalContextResource(_params: Record<string, string>, searchParams: URLSearchParams, kgManager?: KnowledgeGraphManager): Promise<ResourceGenerationResult>;
+//# sourceMappingURL=architectural-context-resource.d.ts.map

package/dist/src/resources/architectural-context-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architectural-context-resource.d.ts","sourceRoot":"","sources":["../../../src/resources/architectural-context-resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAGtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEjF,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,qBAAqB,EAAE,MAAM,EAAE,CAAC;KACjC,CAAC;IACF,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QAClC,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC,CAAC;IACH,eAAe,EAAE;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAsB,oCAAoC,CACxD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,YAAY,EAAE,eAAe,EAC7B,SAAS,CAAC,EAAE,qBAAqB,GAChC,OAAO,CAAC,wBAAwB,CAAC,CAmJnC"}