ai-prompt-guide-mcp 1.0.0

package/dist/shared/document-analysis/related-docs.js

@@ -0,0 +1,459 @@
+/**
+ * Related document discovery using two-stage fingerprint-based filtering
+ *
+ * Provides efficient discovery of related documents using fingerprint-based
+ * initial filtering followed by full content analysis for high-signal candidates.
+ */
+import { pathToNamespace } from '../path-utilities.js';
+import { getGlobalLogger } from '../../utils/logger.js';
+import { extractWeightedKeywords, calculateWeightedRelevanceWithBreakdown, generateFactorBasedExplanation, DEFAULT_SCORING_FEATURES } from './keyword-utils.js';
+import { DocumentAnalysisError } from './types.js';
+const logger = getGlobalLogger();
+// Performance optimization constants for two-stage filtering
+const FINGERPRINT_THRESHOLD = 0.3;
+const MAX_CANDIDATES_FOR_CONTENT_ANALYSIS = 10;
+/**
+ * Find related documents using two-stage fingerprint-based filtering
+ *
+ * Uses efficient fingerprint-based initial filtering followed by full content
+ * analysis only for high-signal candidates. This significantly improves performance
+ * for large document sets while maintaining result quality.
+ *
+ * @param manager - Document manager for accessing documents
+ * @param _namespace - Target namespace (kept for compatibility, not used)
+ * @param title - Document title for keyword extraction
+ * @param overview - Document overview for keyword extraction
+ * @param excludePath - Optional document path to exclude from results (e.g., the document being created)
+ *
+ * @returns Promise resolving to array of related document suggestions
+ *
+ * @throws {DocumentAnalysisError} When document listing fails or critical operations fail
+ */
+export async function findRelatedDocuments(manager, _namespace, title, overview, excludePath) {
+    // Input validation
+    if (manager == null) {
+        throw new DocumentAnalysisError('Document manager is required', 'findRelatedDocuments', [], ['Ensure document manager is properly initialized']);
+    }
+    if (title == null || title.trim() === '') {
+        throw new DocumentAnalysisError('Valid title is required', 'findRelatedDocuments', [], ['Provide a non-empty title string']);
+    }
+    // Extract keywords from title and overview using enhanced extraction
+    let keywords = [];
+    let keywordResult;
+    try {
+        keywordResult = extractWeightedKeywords(title, overview ?? '');
+        keywords = [...keywordResult.keywords];
+        if (keywords.length === 0) {
+            logger.warn('No keywords extracted from title and overview');
+            keywords = title.toLowerCase().split(/\s+/).filter(word => word.length > 2);
+        }
+        else {
+            logger.debug('Enhanced keyword extraction successful', {
+                keywordCount: keywords.length,
+                hasExplicitKeywords: keywordResult.hasExplicitKeywords,
+                totalWeight: Math.round(keywordResult.totalWeight * 100) / 100
+            });
+        }
+    }
+    catch (error) {
+        logger.warn('Enhanced keyword extraction failed, using fallback', { error });
+        keywords = title.toLowerCase().split(/\s+/).filter(word => word.length > 2);
+        keywordResult = {
+            weightedKeywords: keywords.map(k => ({ keyword: k, weight: 1.0, sources: ['fallback'] })),
+            keywords,
+            hasExplicitKeywords: false,
+            totalWeight: keywords.length
+        };
+    }
+    try {
+        // Stage 1: Fast fingerprint-based filtering (if available)
+        let candidates = [];
+        let usedFingerprintFiltering = false;
+        try {
+            // Check if fingerprint listing is available
+            if (typeof manager.listDocumentFingerprints === 'function') {
+                logger.debug('Starting Stage 1: fingerprint-based filtering', {
+                    keywords,
+                    threshold: FINGERPRINT_THRESHOLD
+                });
+                const fingerprints = await manager.listDocumentFingerprints();
+                logger.debug(`Retrieved ${fingerprints.length} document fingerprints`);
+                if (fingerprints.length > 0) {
+                    // Get all documents to match with fingerprints
+                    const { documents: allDocuments } = await manager.listDocuments();
+                    const pathToFingerprint = new Map();
+                    // Create mapping of paths to fingerprints by matching metadata
+                    for (const docInfo of allDocuments) {
+                        try {
+                            const document = await manager.getDocument(docInfo.path);
+                            if (document != null) {
+                                const fingerprint = fingerprints.find(fp => fp.namespace === document.metadata.namespace &&
+                                    fp.contentHash === document.metadata.contentHash &&
+                                    fp.lastModified.getTime() === document.metadata.lastModified.getTime());
+                                if (fingerprint != null) {
+                                    pathToFingerprint.set(docInfo.path, fingerprint);
+                                }
+                            }
+                        }
+                        catch {
+                            // Skip documents that fail to load
+                            continue;
+                        }
+                    }
+                    logger.debug(`Successfully mapped ${pathToFingerprint.size} documents to fingerprints`);
+                    // Calculate fingerprint-based relevance scores
+                    for (const [docPath, fingerprint] of pathToFingerprint.entries()) {
+                        // Skip the document being created (prevent self-reference)
+                        if (excludePath != null && docPath === excludePath) {
+                            continue;
+                        }
+                        const score = calculateFingerprintRelevance(keywords, fingerprint.keywords);
+                        candidates.push({
+                            fingerprint,
+                            path: docPath,
+                            score
+                        });
+                    }
+                    // Filter candidates above threshold
+                    candidates = candidates
+                        .filter(candidate => candidate.score > FINGERPRINT_THRESHOLD)
+                        .sort((a, b) => b.score - a.score)
+                        .slice(0, MAX_CANDIDATES_FOR_CONTENT_ANALYSIS);
+                    logger.debug(`Fingerprint analysis: ${pathToFingerprint.size} documents, ${candidates.length} candidates above threshold ${FINGERPRINT_THRESHOLD}`);
+                    usedFingerprintFiltering = true;
+                }
+            }
+        }
+        catch (error) {
+            logger.warn('Fingerprint-based filtering failed, falling back to full analysis', { error });
+        }
+        // Fallback: If fingerprint filtering not available or failed, use original approach
+        if (!usedFingerprintFiltering) {
+            logger.debug('Using fallback: original algorithm (no fingerprint filtering)');
+            const { documents: allDocuments } = await manager.listDocuments();
+            if (allDocuments.length === 0) {
+                logger.debug('No documents available, returning empty results');
+                return [];
+            }
+            // Use original algorithm: process all documents with content analysis
+            for (const docInfo of allDocuments) {
+                try {
+                    // Skip the document being created (prevent self-reference)
+                    if (excludePath != null && docInfo.path === excludePath) {
+                        continue;
+                    }
+                    const document = await manager.getDocument(docInfo.path);
+                    if (document == null) {
+                        continue;
+                    }
+                    // Read document content for keyword matching (like original)
+                    let content = '';
+                    try {
+                        content = await manager.getDocumentContent(docInfo.path) ?? '';
+                    }
+                    catch (error) {
+                        logger.warn(`Failed to read content for document ${docInfo.path}`, { error });
+                        // Fallback to metadata when content is unavailable
+                        content = document.metadata.title;
+                    }
+                    // Calculate relevance based on keyword overlap (like original)
+                    const relevance = calculateContentRelevance(keywords, document.metadata.title, content);
+                    if (relevance > 0.2) { // Same threshold as original
+                        candidates.push({
+                            fingerprint: {
+                                keywords: [],
+                                lastModified: document.metadata.lastModified,
+                                contentHash: document.metadata.contentHash,
+                                namespace: document.metadata.namespace
+                            },
+                            path: docInfo.path,
+                            score: relevance // Use content relevance directly
+                        });
+                    }
+                }
+                catch {
+                    // Skip failed documents silently
+                    continue;
+                }
+            }
+            logger.debug(`Fallback analysis: ${allDocuments.length} documents processed, ${candidates.length} candidates above threshold 0.2`);
+        }
+        if (candidates.length === 0) {
+            logger.debug('No candidates found, returning empty results');
+            return [];
+        }
+        // Stage 2: Process candidates based on filtering method
+        if (usedFingerprintFiltering) {
+            // For fingerprint filtering: do full content analysis
+            logger.debug('Starting Stage 2: content analysis for fingerprint candidates', {
+                candidateCount: candidates.length
+            });
+            const fullAnalysis = await Promise.all(candidates.map(async (candidate) => {
+                try {
+                    // Load full content for detailed analysis
+                    let content = '';
+                    let contentSource = 'content';
+                    try {
+                        content = await manager.getDocumentContent(candidate.path) ?? '';
+                    }
+                    catch (error) {
+                        logger.warn(`Failed to read content for document ${candidate.path}`, { error });
+                        // Fallback to metadata when content is unavailable
+                        const document = await manager.getDocument(candidate.path);
+                        content = document?.metadata.title ?? '';
+                        contentSource = 'metadata';
+                    }
+                    // Calculate detailed content relevance using enhanced weighting
+                    const document = await manager.getDocument(candidate.path);
+                    if (document == null) {
+                        return null;
+                    }
+                    // Use enhanced multi-factor relevance calculation if we have weighted keywords
+                    let contentScore;
+                    let relevanceResult = null;
+                    if (keywordResult.weightedKeywords.length > 0) {
+                        // Extract source namespace from the document being created (use _namespace or 'root')
+                        const sourceNamespace = _namespace ?? 'root';
+                        const sourceContent = overview ?? '';
+                        // Extract target namespace
+                        const targetNamespace = document.metadata.namespace ?? pathToNamespace(candidate.path);
+                        // Use enhanced calculation with factor breakdown for explanation generation
+                        relevanceResult = calculateWeightedRelevanceWithBreakdown(keywordResult.weightedKeywords, title, // sourceTitle
+                        sourceNamespace, // sourceNamespace
+                        sourceContent, // sourceContent
+                        document.metadata.title, // targetTitle
+                        content, // targetContent
+                        targetNamespace, // targetNamespace
+                        document.metadata.lastModified, // targetLastModified
+                        candidate.path, // targetPath
+                        candidate.fingerprint, // targetFingerprint
+                        DEFAULT_SCORING_FEATURES // features
+                        );
+                        contentScore = relevanceResult.relevance;
+                    }
+                    else {
+                        // Fallback to original calculation
+                        contentScore = calculateContentRelevance(keywords, document.metadata.title, content);
+                    }
+                    // Combine fingerprint and content scores with weighted approach
+                    const combinedScore = (candidate.score * 0.3) + (contentScore * 0.7);
+                    logger.debug(`Content analysis for ${candidate.path}`, {
+                        fingerprintScore: Math.round(candidate.score * 100) / 100,
+                        contentScore: Math.round(contentScore * 100) / 100,
+                        combinedScore: Math.round(combinedScore * 100) / 100,
+                        contentSource,
+                        contentLength: content.length,
+                        hasFactorBreakdown: relevanceResult != null
+                    });
+                    const docNamespace = pathToNamespace(candidate.path);
+                    // Generate factor-based explanation using enhanced system
+                    let reason;
+                    if (relevanceResult != null && relevanceResult.primaryFactors.length > 0) {
+                        // Use factor-based explanation generation
+                        reason = generateFactorBasedExplanation(relevanceResult.primaryFactors, docNamespace, keywordResult.hasExplicitKeywords);
+                    }
+                    else if (contentSource === 'metadata') {
+                        // Fallback for metadata-only analysis
+                        reason = `Related documentation in ${docNamespace} (based on title and keywords)`;
+                    }
+                    else {
+                        // Generic fallback
+                        reason = `Related documentation in ${docNamespace}`;
+                    }
+                    return {
+                        path: candidate.path,
+                        title: document.metadata.title,
+                        namespace: docNamespace,
+                        reason,
+                        relevance: Math.round(combinedScore * 100) / 100
+                    };
+                }
+                catch (error) {
+                    logger.warn(`Content analysis failed for candidate ${candidate.path}`, { error });
+                    return null;
+                }
+            }));
+            // Filter out failed analyses and apply minimum relevance threshold
+            const validResults = fullAnalysis
+                .filter((result) => result != null && result.relevance > 0.2)
+                .sort((a, b) => b.relevance - a.relevance)
+                .slice(0, 5);
+            logger.debug(`Content analysis: ${candidates.length} candidates processed`);
+            logger.debug(`Discovery complete: ${validResults.length} related documents found using fingerprint filtering`);
+            return validResults;
+        }
+        else {
+            // For fallback: candidates already have final scores, just format them
+            logger.debug('Stage 2: formatting fallback results', {
+                candidateCount: candidates.length
+            });
+            const fallbackResults = await Promise.all(candidates.map(async (candidate) => {
+                try {
+                    const document = await manager.getDocument(candidate.path);
+                    if (document == null) {
+                        return null;
+                    }
+                    const docNamespace = pathToNamespace(candidate.path);
+                    // For fallback results, generate basic but informative reason
+                    const reason = `Related documentation in ${docNamespace}`;
+                    return {
+                        path: candidate.path,
+                        title: document.metadata.title,
+                        namespace: docNamespace,
+                        reason,
+                        relevance: Math.round(candidate.score * 100) / 100
+                    };
+                }
+                catch (error) {
+                    logger.warn(`Fallback result formatting failed for ${candidate.path}`, { error });
+                    return null;
+                }
+            }));
+            const validResults = fallbackResults
+                .filter((result) => result != null)
+                .sort((a, b) => b.relevance - a.relevance)
+                .slice(0, 5);
+            logger.debug(`Discovery complete: ${validResults.length} related documents found using fallback filtering`);
+            return validResults;
+        }
+    }
+    catch (error) {
+        throw new DocumentAnalysisError(`Failed to find related documents: ${error}`, 'findRelatedDocuments', [], [
+            'Check document manager connectivity',
+            'Verify fingerprint cache functionality',
+            'Ensure document root directory exists',
+            'Try with simpler keywords'
+        ]);
+    }
+}
+/**
+ * Calculate content relevance based on keyword overlap
+ *
+ * Computes a relevance score by analyzing keyword overlap between
+ * the source keywords and the target document's title and content.
+ *
+ * @param keywords - Array of keywords to match against
+ * @param title - Target document title
+ * @param content - Target document content
+ *
+ * @returns Relevance score between 0 and 1
+ *
+ * @throws {DocumentAnalysisError} When input validation fails
+ *
+ * @example
+ * ```typescript
+ * const relevance = calculateContentRelevance(
+ *   ['api', 'authentication', 'jwt'],
+ *   'User Auth API',
+ *   'This document describes JWT-based user authentication...'
+ * );
+ * console.log(`Relevance: ${relevance}`); // 0.67
+ * ```
+ */
+function calculateContentRelevance(keywords, title, content) {
+    // Input validation
+    if (!Array.isArray(keywords)) {
+        throw new DocumentAnalysisError('Keywords must be an array', 'calculateContentRelevance', undefined, ['Ensure keywords parameter is an array of strings']);
+    }
+    // Handle edge cases gracefully
+    if (keywords.length === 0) {
+        console.warn('Empty keywords array provided to relevance calculation');
+        return 0;
+    }
+    const safeTitle = title ?? '';
+    const safeContent = content ?? '';
+    try {
+        const targetText = `${safeTitle} ${safeContent}`.toLowerCase();
+        // Filter and validate keywords
+        const validKeywords = keywords.filter(keyword => {
+            if (typeof keyword !== 'string') {
+                console.warn('Non-string keyword filtered out:', keyword);
+                return false;
+            }
+            return keyword.trim().length > 0;
+        });
+        if (validKeywords.length === 0) {
+            console.warn('No valid keywords found after filtering');
+            return 0;
+        }
+        const matches = validKeywords.filter(keyword => {
+            try {
+                return targetText.includes(keyword.toLowerCase());
+            }
+            catch (error) {
+                console.warn(`Keyword matching failed for "${keyword}":`, error);
+                return false;
+            }
+        });
+        const relevance = matches.length / validKeywords.length;
+        // Ensure result is within expected bounds
+        if (relevance < 0 || relevance > 1) {
+            console.warn(`Relevance calculation produced out-of-bounds result: ${relevance}`);
+            return Math.max(0, Math.min(1, relevance));
+        }
+        return relevance;
+    }
+    catch (error) {
+        throw new DocumentAnalysisError(`Content relevance calculation failed: ${error}`, 'calculateContentRelevance', 0, [
+            'Check keyword array format',
+            'Verify title and content are strings',
+            'Try with simpler input data'
+        ]);
+    }
+}
+/**
+ * Calculate fingerprint-based relevance score for fast document filtering
+ *
+ * Performs lightweight keyword overlap analysis using document fingerprints
+ * without requiring full content parsing. Used in Stage 1 filtering.
+ *
+ * @param sourceKeywords - Keywords extracted from the source document
+ * @param fingerprintKeywords - Keywords from the document fingerprint
+ *
+ * @returns Relevance score between 0 and 1 based on keyword overlap
+ *
+ * @example
+ * ```typescript
+ * const score = calculateFingerprintRelevance(
+ *   ['api', 'authentication', 'jwt'],
+ *   ['api', 'auth', 'security', 'tokens']
+ * );
+ * console.log(`Fingerprint relevance: ${score}`); // 0.33 (1/3 match)
+ * ```
+ */
+function calculateFingerprintRelevance(sourceKeywords, fingerprintKeywords) {
+    // Input validation with graceful handling
+    if (!Array.isArray(sourceKeywords) || !Array.isArray(fingerprintKeywords)) {
+        logger.warn('Invalid input to calculateFingerprintRelevance', {
+            sourceKeywords: typeof sourceKeywords,
+            fingerprintKeywords: typeof fingerprintKeywords
+        });
+        return 0;
+    }
+    if (sourceKeywords.length === 0 || fingerprintKeywords.length === 0) {
+        return 0;
+    }
+    try {
+        // Normalize keywords for case-insensitive matching
+        const normalizedSource = sourceKeywords
+            .filter(keyword => typeof keyword === 'string' && keyword.trim().length > 0)
+            .map(keyword => keyword.toLowerCase().trim());
+        const normalizedFingerprint = new Set(fingerprintKeywords
+            .filter(keyword => typeof keyword === 'string' && keyword.trim().length > 0)
+            .map(keyword => keyword.toLowerCase().trim()));
+        if (normalizedSource.length === 0 || normalizedFingerprint.size === 0) {
+            return 0;
+        }
+        // Count matches using Set for O(1) lookup
+        const matches = normalizedSource.filter(keyword => normalizedFingerprint.has(keyword));
+        // Calculate overlap ratio
+        const relevance = matches.length / normalizedSource.length;
+        // Ensure result is within bounds
+        return Math.max(0, Math.min(1, relevance));
+    }
+    catch (error) {
+        logger.warn('Fingerprint relevance calculation failed', { error });
+        return 0;
+    }
+}
+//# sourceMappingURL=related-docs.js.map

package/dist/shared/document-analysis/related-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-docs.js","sourceRoot":"","sources":["../../../src/shared/document-analysis/related-docs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,uBAAuB,EACvB,uCAAuC,EACvC,8BAA8B,EAG9B,wBAAwB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;AAEjC,6DAA6D;AAC7D,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,mCAAmC,GAAG,EAAE,CAAC;AAW/C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAwB,EACxB,UAAkB,EAClB,KAAa,EACb,QAAgB,EAChB,WAAoB;IAEpB,mBAAmB;IACnB,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,qBAAqB,CAC7B,8BAA8B,EAC9B,sBAAsB,EACtB,EAAE,EACF,CAAC,iDAAiD,CAAC,CACpD,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,qBAAqB,CAC7B,yBAAyB,EACzB,sBAAsB,EACtB,EAAE,EACF,CAAC,kCAAkC,CAAC,CACrC,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,IAAI,QAAQ,GAAa,EAAE,CAAC;IAC5B,IAAI,aAAsC,CAAC;IAC3C,IAAI,CAAC;QACH,aAAa,GAAG,uBAAuB,CAAC,KAAK,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC/D,QAAQ,GAAG,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAEvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YAC7D,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC9E,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE;gBACrD,YAAY,EAAE,QAAQ,CAAC,MAAM;gBAC7B,mBAAmB,EAAE,aAAa,CAAC,mBAAmB;gBACtD,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,GAAG;aAC/D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,oDAAoD,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7E,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5E,aAAa,GAAG;YACd,gBAAgB,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACzF,QAAQ;YACR,mBAAmB,EAAE,KAAK;YAC1B,WAAW,EAAE,QAAQ,CAAC,MAAM;SAC7B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,2DAA2D;QAC3D,IAAI,UAAU,GAA2B,EAAE,CAAC;QAC5C,IAAI,wBAAwB,GAAG,KAAK,CAAC;QAErC,IAAI,CAAC;YACH,4CAA4C;YAC5C,IAAI,OAAO,OAAO,CAAC,wBAAwB,KAAK,UAAU,EAAE,CAAC;gBAC3D,MAAM,CAAC,KAAK,CAAC,+CAA+C,EAAE;oBAC5D,QAAQ;oBACR,SAAS,EAAE,qBAAqB;iBACjC,CAAC,CAAC;gBAEH,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,wBAAwB,EAAE,CAAC;gBAC9D,MAAM,CAAC,KAAK,CAAC,aAAa,YAAY,CAAC,MAAM,wBAAwB,CAAC,CAAC;gBAEvE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5B,+CAA+C;oBAC/C,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;oBAClE,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA4B,CAAC;oBAE9D,+DAA+D;oBAC/D,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;wBACnC,IAAI,CAAC;4BACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;4BACzD,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;gCACrB,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CACzC,EAAE,CAAC,SAAS,KAAK,QAAQ,CAAC,QAAQ,CAAC,SAAS;oCAC5C,EAAE,CAAC,WAAW,KAAK,QAAQ,CAAC,QAAQ,CAAC,WAAW;oCAChD,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,CACvE,CAAC;gCACF,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;oCACxB,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gCACnD,CAAC;4BACH,CAAC;wBACH,CAAC;wBAAC,MAAM,CAAC;4BACP,mCAAmC;4BACnC,SAAS;wBACX,CAAC;oBACH,CAAC;oBAED,MAAM,CAAC,KAAK,CAAC,uBAAuB,iBAAiB,CAAC,IAAI,4BAA4B,CAAC,CAAC;oBAExF,+CAA+C;oBAC/C,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,iBAAiB,CAAC,OAAO,EAAE,EAAE,CAAC;wBACjE,2DAA2D;wBAC3D,IAAI,WAAW,IAAI,IAAI,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;4BACnD,SAAS;wBACX,CAAC;wBAED,MAAM,KAAK,GAAG,6BAA6B,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;wBAC5E,UAAU,CAAC,IAAI,CAAC;4BACd,WAAW;4BACX,IAAI,EAAE,OAAO;4BACb,KAAK;yBACN,CAAC,CAAC;oBACL,CAAC;oBAED,oCAAoC;oBACpC,UAAU,GAAG,UAAU;yBACpB,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,GAAG,qBAAqB,CAAC;yBAC5D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;yBACjC,KAAK,CAAC,CAAC,EAAE,mCAAmC,CAAC,CAAC;oBAEjD,MAAM,CAAC,KAAK,CAAC,yBAAyB,iBAAiB,CAAC,IAAI,eAAe,UAAU,CAAC,MAAM,+BAA+B,qBAAqB,EAAE,CAAC,CAAC;oBACpJ,wBAAwB,GAAG,IAAI,CAAC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,mEAAmE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,oFAAoF;QACpF,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAC9B,MAAM,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;YAC9E,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;YAElE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;gBAChE,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,sEAAsE;YACtE,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACH,2DAA2D;oBAC3D,IAAI,WAAW,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;wBACxD,SAAS;oBACX,CAAC;oBAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBACzD,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;wBACrB,SAAS;oBACX,CAAC;oBAED,6DAA6D;oBAC7D,IAAI,OAAO,GAAG,EAAE,CAAC;oBACjB,IAAI,CAAC;wBACH,OAAO,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACjE,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,CAAC,IAAI,CAAC,uCAAuC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;wBAC9E,mDAAmD;wBACnD,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACpC,CAAC;oBAED,+DAA+D;oBAC/D,MAAM,SAAS,GAAG,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBAExF,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC,CAAC,6BAA6B;wBAClD,UAAU,CAAC,IAAI,CAAC;4BACd,WAAW,EAAE;gCACX,QAAQ,EAAE,EAAE;gCACZ,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY;gCAC5C,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW;gCAC1C,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS;6BACvC;4BACD,IAAI,EAAE,OAAO,CAAC,IAAI;4BAClB,KAAK,EAAE,SAAS,CAAC,iCAAiC;yBACnD,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,iCAAiC;oBACjC,SAAS;gBACX,CAAC;YACH,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,sBAAsB,YAAY,CAAC,MAAM,yBAAyB,UAAU,CAAC,MAAM,iCAAiC,CAAC,CAAC;QACrI,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAC7D,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,wDAAwD;QACxD,IAAI,wBAAwB,EAAE,CAAC;YAC7B,sDAAsD;YACtD,MAAM,CAAC,KAAK,CAAC,+DAA+D,EAAE;gBAC5E,cAAc,EAAE,UAAU,CAAC,MAAM;aAClC,CAAC,CAAC;YAEH,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;gBACjC,IAAI,CAAC;oBACH,0CAA0C;oBAC1C,IAAI,OAAO,GAAG,EAAE,CAAC;oBACjB,IAAI,aAAa,GAAG,SAAS,CAAC;oBAE9B,IAAI,CAAC;wBACH,OAAO,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACnE,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,CAAC,IAAI,CAAC,uCAAuC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;wBAChF,mDAAmD;wBACnD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;wBAC3D,OAAO,GAAG,QAAQ,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;wBACzC,aAAa,GAAG,UAAU,CAAC;oBAC7B,CAAC;oBAED,gEAAgE;oBAChE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBAC3D,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;wBACrB,OAAO,IAAI,CAAC;oBACd,CAAC;oBAED,+EAA+E;oBAC/E,IAAI,YAAoB,CAAC;oBACzB,IAAI,eAAe,GAAsC,IAAI,CAAC;oBAE9D,IAAI,aAAa,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC9C,sFAAsF;wBACtF,MAAM,eAAe,GAAG,UAAU,IAAI,MAAM,CAAC;wBAC7C,MAAM,aAAa,GAAG,QAAQ,IAAI,EAAE,CAAC;wBAErC,2BAA2B;wBAC3B,MAAM,eAAe,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,IAAI,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;wBAEvF,4EAA4E;wBAC5E,eAAe,GAAG,uCAAuC,CACvD,aAAa,CAAC,gBAAgB,EAC9B,KAAK,EAA4B,cAAc;wBAC/C,eAAe,EAAkB,kBAAkB;wBACnD,aAAa,EAAoB,gBAAgB;wBACjD,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAU,cAAc;wBAC/C,OAAO,EAA0B,gBAAgB;wBACjD,eAAe,EAAkB,kBAAkB;wBACnD,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAG,qBAAqB;wBACtD,SAAS,CAAC,IAAI,EAAmB,aAAa;wBAC9C,SAAS,CAAC,WAAW,EAAY,oBAAoB;wBACrD,wBAAwB,CAAS,WAAW;yBAC7C,CAAC;wBACF,YAAY,GAAG,eAAe,CAAC,SAAS,CAAC;oBAC3C,CAAC;yBAAM,CAAC;wBACN,mCAAmC;wBACnC,YAAY,GAAG,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBACvF,CAAC;oBAED,gEAAgE;oBAChE,MAAM,aAAa,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC;oBAErE,MAAM,CAAC,KAAK,CAAC,wBAAwB,SAAS,CAAC,IAAI,EAAE,EAAE;wBACrD,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG;wBACzD,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,GAAG;wBAClD,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,GAAG,GAAG;wBACpD,aAAa;wBACb,aAAa,EAAE,OAAO,CAAC,MAAM;wBAC7B,kBAAkB,EAAE,eAAe,IAAI,IAAI;qBAC5C,CAAC,CAAC;oBAEH,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBAErD,0DAA0D;oBAC1D,IAAI,MAAc,CAAC;oBACnB,IAAI,eAAe,IAAI,IAAI,IAAI,eAAe,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzE,0CAA0C;wBAC1C,MAAM,GAAG,8BAA8B,CACrC,eAAe,CAAC,cAAc,EAC9B,YAAY,EACZ,aAAa,CAAC,mBAAmB,CAClC,CAAC;oBACJ,CAAC;yBAAM,IAAI,aAAa,KAAK,UAAU,EAAE,CAAC;wBACxC,sCAAsC;wBACtC,MAAM,GAAG,4BAA4B,YAAY,gCAAgC,CAAC;oBACpF,CAAC;yBAAM,CAAC;wBACN,mBAAmB;wBACnB,MAAM,GAAG,4BAA4B,YAAY,EAAE,CAAC;oBACtD,CAAC;oBAED,OAAO;wBACL,IAAI,EAAE,SAAS,CAAC,IAAI;wBACpB,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK;wBAC9B,SAAS,EAAE,YAAY;wBACvB,MAAM;wBACN,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,GAAG,GAAG;qBACjD,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CAAC,yCAAyC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;oBAClF,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CACH,CAAC;YAEF,mEAAmE;YACnE,MAAM,YAAY,GAAG,YAAY;iBAC9B,MAAM,CAAC,CAAC,MAAM,EAAuC,EAAE,CAAC,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC;iBACjG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;iBACzC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAEf,MAAM,CAAC,KAAK,CAAC,qBAAqB,UAAU,CAAC,MAAM,uBAAuB,CAAC,CAAC;YAC5E,MAAM,CAAC,KAAK,CAAC,uBAAuB,YAAY,CAAC,MAAM,sDAAsD,CAAC,CAAC;YAE/G,OAAO,YAAY,CAAC;QAEtB,CAAC;aAAM,CAAC;YACN,uEAAuE;YACvE,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE;gBACnD,cAAc,EAAE,UAAU,CAAC,MAAM;aAClC,CAAC,CAAC;YAEH,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,GAAG,CACvC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;gBACjC,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBAC3D,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;wBACrB,OAAO,IAAI,CAAC;oBACd,CAAC;oBAED,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBAErD,8DAA8D;oBAC9D,MAAM,MAAM,GAAG,4BAA4B,YAAY,EAAE,CAAC;oBAE1D,OAAO;wBACL,IAAI,EAAE,SAAS,CAAC,IAAI;wBACpB,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK;wBAC9B,SAAS,EAAE,YAAY;wBACvB,MAAM;wBACN,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG;qBACnD,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CAAC,yCAAyC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;oBAClF,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,YAAY,GAAG,eAAe;iBACjC,MAAM,CAAC,CAAC,MAAM,EAAuC,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC;iBACvE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;iBACzC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAEf,MAAM,CAAC,KAAK,CAAC,uBAAuB,YAAY,CAAC,MAAM,mDAAmD,CAAC,CAAC;YAE5G,OAAO,YAAY,CAAC;QACtB,CAAC;IAEH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,qBAAqB,CAC7B,qCAAqC,KAAK,EAAE,EAC5C,sBAAsB,EACtB,EAAE,EACF;YACE,qCAAqC;YACrC,wCAAwC;YACxC,uCAAuC;YACvC,2BAA2B;SAC5B,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAS,yBAAyB,CAAC,QAAkB,EAAE,KAAa,EAAE,OAAe;IACnF,mBAAmB;IACnB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,qBAAqB,CAC7B,2BAA2B,EAC3B,2BAA2B,EAC3B,SAAS,EACT,CAAC,kDAAkD,CAAC,CACrD,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QACvE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAG,OAAO,IAAI,EAAE,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,GAAG,SAAS,IAAI,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC;QAE/D,+BAA+B;QAC/B,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;YAC9C,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,OAAO,CAAC,CAAC;gBAC1D,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;YACxD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;YAC7C,IAAI,CAAC;gBACH,OAAO,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,gCAAgC,OAAO,IAAI,EAAE,KAAK,CAAC,CAAC;gBACjE,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;QAExD,0CAA0C;QAC1C,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,wDAAwD,SAAS,EAAE,CAAC,CAAC;YAClF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,SAAS,CAAC;IAEnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,qBAAqB,CAC7B,yCAAyC,KAAK,EAAE,EAChD,2BAA2B,EAC3B,CAAC,EACD;YACE,4BAA4B;YAC5B,sCAAsC;YACtC,6BAA6B;SAC9B,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAS,6BAA6B,CAAC,cAAwB,EAAE,mBAA6B;IAC5F,0CAA0C;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC1E,MAAM,CAAC,IAAI,CAAC,gDAAgD,EAAE;YAC5D,cAAc,EAAE,OAAO,cAAc;YACrC,mBAAmB,EAAE,OAAO,mBAAmB;SAChD,CAAC,CAAC;QACH,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,mDAAmD;QACnD,MAAM,gBAAgB,GAAG,cAAc;aACpC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;aAC3E,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,qBAAqB,GAAG,IAAI,GAAG,CACnC,mBAAmB;aAChB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;aAC3E,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAChD,CAAC;QAEF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,IAAI,qBAAqB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACtE,OAAO,CAAC,CAAC;QACX,CAAC;QAED,0CAA0C;QAC1C,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QAEvF,0BAA0B;QAC1B,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAE3D,iCAAiC;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAE7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/shared/document-analysis/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Shared types and error classes for document analysis system
+ */
+import { AddressingError } from '../addressing-system.js';
+/**
+ * Structured information about a broken reference
+ *
+ * Provides detailed classification and context for reference validation failures,
+ * enabling targeted fixes and better user guidance.
+ *
+ * @example Using BrokenReference data
+ * ```typescript
+ * const brokenRefs = await detectBrokenReferences(manager, namespace, title, overview);
+ * for (const ref of brokenRefs) {
+ *   if (ref.type === 'missing_document') {
+ *     console.log(`Document not found: ${ref.documentPath}`);
+ *   } else if (ref.type === 'missing_section') {
+ *     console.log(`Section '${ref.sectionSlug}' not found in ${ref.documentPath}`);
+ *   }
+ * }
+ * ```
+ */
+export interface BrokenReference {
+    /** Original @reference text as it appeared in content */
+    readonly reference: string;
+    /** Classification of the failure type */
+    readonly type: 'missing_document' | 'missing_section' | 'malformed';
+    /** Parsed document path (if parseable) */
+    readonly documentPath?: string;
+    /** Parsed section slug (if applicable) */
+    readonly sectionSlug?: string | undefined;
+    /** Human-readable reason for the failure */
+    readonly reason: string;
+}
+/**
+ * Error thrown when document analysis operations fail
+ *
+ * This error provides structured information about analysis failures,
+ * including the operation that failed and any partial results that
+ * were successfully obtained.
+ *
+ * @example Handling analysis errors
+ * ```typescript
+ * try {
+ *   const suggestions = await analyzeDocumentSuggestions(manager, namespace, title, overview);
+ * } catch (error) {
+ *   if (error instanceof DocumentAnalysisError) {
+ *     console.error('Analysis failed:', error.message);
+ *     console.log('Partial results:', error.partialResults);
+ *     console.log('Recovery suggestions:', error.recoverySuggestions);
+ *   }
+ * }
+ * ```
+ */
+export declare class DocumentAnalysisError extends AddressingError {
+    operation: string;
+    partialResults?: unknown | undefined;
+    recoverySuggestions?: string[] | undefined;
+    constructor(message: string, operation: string, partialResults?: unknown | undefined, recoverySuggestions?: string[] | undefined);
+}
+/**
+ * Structured result type for analysis operations that may partially fail
+ *
+ * @template T - The type of the successful result
+ */
+export interface AnalysisResult<T> {
+    /** Whether the operation completed successfully */
+    success: boolean;
+    /** The result data if successful, or partial results if failed */
+    data: T;
+    /** Error information if the operation failed */
+    error?: {
+        message: string;
+        operation: string;
+        code: string;
+    };
+    /** Suggestions for recovering from the error */
+    recoverySuggestions?: string[];
+}
+/**
+ * Input validation error details
+ */
+export interface ValidationError {
+    parameter: string;
+    value: unknown;
+    expected: string;
+    received: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/document-analysis/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/document-analysis/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,WAAW,CAAC;IACpE,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;IAG/C,SAAS,EAAE,MAAM;IACjB,cAAc,CAAC,EAAE,OAAO;IACxB,mBAAmB,CAAC,EAAE,MAAM,EAAE;gBAHrC,OAAO,EAAE,MAAM,EACR,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,OAAO,YAAA,EACxB,mBAAmB,CAAC,EAAE,MAAM,EAAE,YAAA;CASxC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,IAAI,EAAE,CAAC,CAAC;IACR,gDAAgD;IAChD,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,gDAAgD;IAChD,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/shared/document-analysis/types.js

@@ -0,0 +1,41 @@
+/**
+ * Shared types and error classes for document analysis system
+ */
+import { AddressingError } from '../addressing-system.js';
+/**
+ * Error thrown when document analysis operations fail
+ *
+ * This error provides structured information about analysis failures,
+ * including the operation that failed and any partial results that
+ * were successfully obtained.
+ *
+ * @example Handling analysis errors
+ * ```typescript
+ * try {
+ *   const suggestions = await analyzeDocumentSuggestions(manager, namespace, title, overview);
+ * } catch (error) {
+ *   if (error instanceof DocumentAnalysisError) {
+ *     console.error('Analysis failed:', error.message);
+ *     console.log('Partial results:', error.partialResults);
+ *     console.log('Recovery suggestions:', error.recoverySuggestions);
+ *   }
+ * }
+ * ```
+ */
+export class DocumentAnalysisError extends AddressingError {
+    operation;
+    partialResults;
+    recoverySuggestions;
+    constructor(message, operation, partialResults, recoverySuggestions) {
+        super(message, 'DOCUMENT_ANALYSIS_ERROR', {
+            operation,
+            partialResults,
+            recoverySuggestions
+        });
+        this.operation = operation;
+        this.partialResults = partialResults;
+        this.recoverySuggestions = recoverySuggestions;
+        this.name = 'DocumentAnalysisError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/shared/document-analysis/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/document-analysis/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAiC1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IAG/C;IACA;IACA;IAJT,YACE,OAAe,EACR,SAAiB,EACjB,cAAwB,EACxB,mBAA8B;QAErC,KAAK,CAAC,OAAO,EAAE,yBAAyB,EAAE;YACxC,SAAS;YACT,cAAc;YACd,mBAAmB;SACpB,CAAC,CAAC;QARI,cAAS,GAAT,SAAS,CAAQ;QACjB,mBAAc,GAAd,cAAc,CAAU;QACxB,wBAAmB,GAAnB,mBAAmB,CAAW;QAOrC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/shared/document-analysis.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Document analysis and smart suggestions functionality
+ *
+ * @deprecated This file is maintained for backward compatibility only.
+ * Import from 'shared/document-analysis/index.js' instead.
+ *
+ * The document analysis functionality has been refactored into focused modules:
+ * - index.ts: Main orchestrator and exports
+ * - related-docs.ts: Related document discovery
+ * - reference-validation.ts: Broken reference detection
+ * - keyword-utils.ts: Enhanced keyword extraction and relevance scoring
+ * - types.ts: Shared interfaces and error classes
+ */
+export { analyzeDocumentSuggestions, DocumentAnalysisError, type BrokenReference, type AnalysisResult } from './document-analysis/index.js';
+//# sourceMappingURL=document-analysis.d.ts.map

package/dist/shared/document-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-analysis.d.ts","sourceRoot":"","sources":["../../src/shared/document-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC"}

package/dist/shared/document-analysis.js

@@ -0,0 +1,16 @@
+/**
+ * Document analysis and smart suggestions functionality
+ *
+ * @deprecated This file is maintained for backward compatibility only.
+ * Import from 'shared/document-analysis/index.js' instead.
+ *
+ * The document analysis functionality has been refactored into focused modules:
+ * - index.ts: Main orchestrator and exports
+ * - related-docs.ts: Related document discovery
+ * - reference-validation.ts: Broken reference detection
+ * - keyword-utils.ts: Enhanced keyword extraction and relevance scoring
+ * - types.ts: Shared interfaces and error classes
+ */
+// Re-export everything from the modular structure for backward compatibility
+export { analyzeDocumentSuggestions, DocumentAnalysisError } from './document-analysis/index.js';
+//# sourceMappingURL=document-analysis.js.map