ai-prompt-guide-mcp 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-analysis.js","sourceRoot":"","sources":["../../src/shared/document-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,6EAA6E;AAC7E,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EAGtB,MAAM,8BAA8B,CAAC"}

package/dist/shared/document-manager-factory.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Document manager factory with dependency injection support
+ *
+ * This factory provides clean dependency injection while maintaining
+ * backward compatibility with the old singleton pattern.
+ */
+import type { DocumentManager } from '../document-manager.js';
+/**
+ * Create a new DocumentManager instance with proper dependency injection
+ *
+ * @param docsRoot - Optional custom docs root path (for testing)
+ * @returns A new DocumentManager instance
+ *
+ * @example
+ * // Production usage
+ * const manager = createDocumentManager();
+ *
+ * @example
+ * // Testing with custom path
+ * const manager = createDocumentManager('/tmp/test-docs');
+ */
+export declare function createDocumentManager(docsRoot?: string): DocumentManager;
+/**
+ * Get or create the default DocumentManager instance (singleton pattern)
+ *
+ * @deprecated Use createDocumentManager() and dependency injection instead
+ * This function maintains backward compatibility but should not be used in new code.
+ *
+ * @returns The singleton DocumentManager instance
+ */
+export declare function getDocumentManager(): Promise<DocumentManager>;
+//# sourceMappingURL=document-manager-factory.d.ts.map

package/dist/shared/document-manager-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-manager-factory.d.ts","sourceRoot":"","sources":["../../src/shared/document-manager-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAU9D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAmCxE;AAQD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAGnE"}

package/dist/shared/document-manager-factory.js

@@ -0,0 +1,75 @@
+/**
+ * Document manager factory with dependency injection support
+ *
+ * This factory provides clean dependency injection while maintaining
+ * backward compatibility with the old singleton pattern.
+ */
+import { DocumentManager as Manager } from '../document-manager.js';
+import { loadConfig, getDocsPath, getArchivedPath, getCoordinatorPath } from '../config.js';
+import { createDocumentCache } from '../document-cache.js';
+import { FingerprintIndex } from '../fingerprint-index.js';
+import { getGlobalLogger } from '../utils/logger.js';
+const logger = getGlobalLogger();
+/**
+ * Create a new DocumentManager instance with proper dependency injection
+ *
+ * @param docsRoot - Optional custom docs root path (for testing)
+ * @returns A new DocumentManager instance
+ *
+ * @example
+ * // Production usage
+ * const manager = createDocumentManager();
+ *
+ * @example
+ * // Testing with custom path
+ * const manager = createDocumentManager('/tmp/test-docs');
+ */
+export function createDocumentManager(docsRoot) {
+    const config = loadConfig();
+    const root = docsRoot ?? getDocsPath(config.docsBasePath);
+    const archivedPath = getArchivedPath(config.archivedBasePath);
+    const coordinatorPath = getCoordinatorPath(config.coordinatorBasePath);
+    // Create cache instance with dependency injection using factory function
+    const cache = createDocumentCache(root, {
+        maxCacheSize: 100,
+        enableWatching: true,
+        watchIgnorePatterns: ['**/node_modules/**', '**/.git/**', '**/dist/**'],
+        evictionPolicy: 'lru'
+    }, coordinatorPath);
+    // Create and initialize fingerprint index for fast search filtering
+    const fingerprintIndex = new FingerprintIndex(root);
+    // Start async initialization (non-blocking)
+    void fingerprintIndex.initialize().catch((error) => {
+        logger.warn('Failed to initialize fingerprint index', { error });
+    });
+    // Integrate with cache's file watcher for auto-invalidation
+    // The cache creates its watcher asynchronously, so we need to access it
+    // after a short delay or via an event
+    setTimeout(() => {
+        // Access the watcher if it exists
+        const watcher = cache.watcher;
+        if (watcher != null) {
+            fingerprintIndex.watchFiles(watcher);
+            logger.debug('FingerprintIndex integrated with cache file watcher');
+        }
+    }, 100);
+    return new Manager(root, cache, fingerprintIndex, archivedPath, coordinatorPath);
+}
+/**
+ * Lazy singleton for backward compatibility
+ * @deprecated Use createDocumentManager() with dependency injection instead
+ */
+let _defaultManager = null;
+/**
+ * Get or create the default DocumentManager instance (singleton pattern)
+ *
+ * @deprecated Use createDocumentManager() and dependency injection instead
+ * This function maintains backward compatibility but should not be used in new code.
+ *
+ * @returns The singleton DocumentManager instance
+ */
+export async function getDocumentManager() {
+    _defaultManager ??= createDocumentManager();
+    return _defaultManager;
+}
+//# sourceMappingURL=document-manager-factory.js.map

package/dist/shared/document-manager-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-manager-factory.js","sourceRoot":"","sources":["../../src/shared/document-manager-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;AAEjC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAiB;IACrD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,QAAQ,IAAI,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC9D,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAEvE,yEAAyE;IACzE,MAAM,KAAK,GAAkB,mBAAmB,CAAC,IAAI,EAAE;QACrD,YAAY,EAAE,GAAG;QACjB,cAAc,EAAE,IAAI;QACpB,mBAAmB,EAAE,CAAC,oBAAoB,EAAE,YAAY,EAAE,YAAY,CAAC;QACvE,cAAc,EAAE,KAAK;KACtB,EAAE,eAAe,CAAC,CAAC;IAEpB,oEAAoE;IACpE,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEpD,4CAA4C;IAC5C,KAAK,gBAAgB,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC1D,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,4DAA4D;IAC5D,wEAAwE;IACxE,sCAAsC;IACtC,UAAU,CAAC,GAAG,EAAE;QACd,kCAAkC;QAClC,MAAM,OAAO,GAAI,KAA0C,CAAC,OAAO,CAAC;QACpE,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,gBAAgB,CAAC,UAAU,CAAC,OAA4D,CAAC,CAAC;YAC1F,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,EAAE,GAAG,CAAC,CAAC;IAER,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;AACnF,CAAC;AAED;;;GAGG;AACH,IAAI,eAAe,GAA2B,IAAI,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,eAAe,KAAK,qBAAqB,EAAE,CAAC;IAC5C,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/shared/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shared utilities module exports
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/shared/index.js

@@ -0,0 +1,7 @@
+/**
+ * Shared utilities module exports
+ */
+export {};
+// Note: All shared imports are done directly from utilities.js
+// No re-exports needed as they are not used via this index
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;GAEG;;AAEH,+DAA+D;AAC/D,2DAA2D"}

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

@@ -0,0 +1,84 @@
+/**
+ * Link analysis service for content analysis and link suggestions
+ *
+ * Provides comprehensive link analysis functionality including:
+ * - Link extraction and validation
+ * - Content-based link suggestions
+ * - Pattern detection and syntax help
+ *
+ * Note: Exports are used via dynamic import for performance optimization.
+ * Dead code detection may flag as unused but they are legitimately used
+ * in src/tools/implementations/section.ts via:
+ * const { createLinkAnalysisService } = await import('../../shared/link-analysis.js');
+ */
+import type { DocumentManager } from '../document-manager.js';
+/**
+ * Standard link syntax examples for consistent documentation
+ * Shared across link analysis and section operations
+ */
+export declare const LINK_SYNTAX_EXAMPLES: readonly ["@/api/specs/user-api.md - Link to entire document", "@/api/guides/setup.md#configuration - Link to specific section", "@#implementation - Link to section in current document"];
+/**
+ * Result of link analysis operation
+ */
+export interface LinkAnalysisResult {
+    links_found: Array<{
+        link_text: string;
+        is_valid: boolean;
+        target_document?: string;
+        target_section?: string;
+        validation_error?: string;
+    }>;
+    link_suggestions: Array<{
+        suggested_link: string;
+        target_document: string;
+        rationale: string;
+        placement_hint: string;
+    }>;
+    syntax_help: {
+        detected_patterns: string[];
+        correct_examples: string[];
+        common_mistakes: string[];
+    };
+}
+/**
+ * Main link analysis service
+ */
+declare class LinkAnalysisService {
+    private readonly manager;
+    constructor(manager: DocumentManager);
+    /**
+     * Perform comprehensive link analysis on content
+     */
+    analyzeLinks(content: string, documentPath: string): Promise<LinkAnalysisResult>;
+    /**
+     * Extract links from content and validate them using unified ReferenceExtractor
+     */
+    private extractAndValidateLinks;
+    /**
+     * Analyze content patterns and detect common mistakes
+     */
+    private analyzePatterns;
+    /**
+     * Generate content-based link suggestions
+     */
+    private generateLinkSuggestions;
+    /**
+     * Generate placement hint based on content context
+     */
+    private generatePlacementHint;
+    /**
+     * Extract meaningful keywords from content for link suggestions
+     */
+    private extractContentKeywords;
+    /**
+     * Check if word is a stop word
+     */
+    private isStopWord;
+}
+/**
+ * Convenience function to create link analysis service
+ * Note: Used via dynamic import in section.ts for performance optimization
+ */
+export declare function createLinkAnalysisService(manager: DocumentManager): LinkAnalysisService;
+export {};
+//# sourceMappingURL=link-analysis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"link-analysis.d.ts","sourceRoot":"","sources":["../../src/shared/link-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,4LAIvB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,KAAK,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC,CAAC;IACH,gBAAgB,EAAE,KAAK,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,WAAW,EAAE;QACX,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;CACH;AAaD;;GAEG;AACH,cAAM,mBAAmB;IACX,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,eAAe;IAErD;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC;IAiB9B;;OAEG;YACW,uBAAuB;IAiDrC;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;YACW,uBAAuB;IAoDrC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;OAEG;IACH,OAAO,CAAC,UAAU;CAWnB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,mBAAmB,CAEvF"}

package/dist/shared/link-analysis.js

@@ -0,0 +1,213 @@
+/**
+ * Link analysis service for content analysis and link suggestions
+ *
+ * Provides comprehensive link analysis functionality including:
+ * - Link extraction and validation
+ * - Content-based link suggestions
+ * - Pattern detection and syntax help
+ *
+ * Note: Exports are used via dynamic import for performance optimization.
+ * Dead code detection may flag as unused but they are legitimately used
+ * in src/tools/implementations/section.ts via:
+ * const { createLinkAnalysisService } = await import('../../shared/link-analysis.js');
+ */
+import { parseDocumentAddress } from './addressing-system.js';
+/**
+ * Standard link syntax examples for consistent documentation
+ * Shared across link analysis and section operations
+ */
+export const LINK_SYNTAX_EXAMPLES = [
+    '@/api/specs/user-api.md - Link to entire document',
+    '@/api/guides/setup.md#configuration - Link to specific section',
+    '@#implementation - Link to section in current document'
+];
+/**
+ * Main link analysis service
+ */
+class LinkAnalysisService {
+    manager;
+    constructor(manager) {
+        this.manager = manager;
+    }
+    /**
+     * Perform comprehensive link analysis on content
+     */
+    async analyzeLinks(content, documentPath) {
+        // Extract and validate links
+        const linksFound = await this.extractAndValidateLinks(content, documentPath);
+        // Analyze patterns and detect mistakes
+        const syntaxHelp = this.analyzePatterns(content, linksFound);
+        // Generate content-based suggestions
+        const linkSuggestions = await this.generateLinkSuggestions(content, documentPath);
+        return {
+            links_found: linksFound,
+            link_suggestions: linkSuggestions,
+            syntax_help: syntaxHelp
+        };
+    }
+    /**
+     * Extract links from content and validate them using unified ReferenceExtractor
+     */
+    async extractAndValidateLinks(content, documentPath) {
+        const { resolveLinkWithContext } = await import('./link-utils.js');
+        const { ReferenceExtractor } = await import('./reference-extractor.js');
+        const extractor = new ReferenceExtractor();
+        const linksFound = [];
+        // Extract references using unified system
+        const refs = extractor.extractReferences(content);
+        const normalized = extractor.normalizeReferences(refs, documentPath);
+        // Validate each found link using existing validation logic
+        for (const normalizedRef of normalized) {
+            try {
+                const resolved = await resolveLinkWithContext(normalizedRef.originalRef, documentPath, this.manager);
+                const linkInfo = {
+                    link_text: normalizedRef.originalRef,
+                    is_valid: resolved.validation.valid
+                };
+                if (resolved.validation.valid && resolved.resolvedPath) {
+                    const hashIndex = resolved.resolvedPath.indexOf('#');
+                    if (hashIndex === -1) {
+                        linkInfo.target_document = resolved.resolvedPath;
+                    }
+                    else {
+                        linkInfo.target_document = resolved.resolvedPath.slice(0, hashIndex);
+                        linkInfo.target_section = resolved.resolvedPath.slice(hashIndex + 1);
+                    }
+                }
+                else {
+                    linkInfo.validation_error = resolved.validation.error ?? 'Unknown validation error';
+                }
+                linksFound.push(linkInfo);
+            }
+            catch (error) {
+                linksFound.push({
+                    link_text: normalizedRef.originalRef,
+                    is_valid: false,
+                    validation_error: error instanceof Error ? error.message : String(error)
+                });
+            }
+        }
+        return linksFound;
+    }
+    /**
+     * Analyze content patterns and detect common mistakes
+     */
+    analyzePatterns(content, linksFound) {
+        const detectedPatterns = [];
+        const commonMistakes = [];
+        // Check for @ symbols without valid links
+        if (content.includes('@') && linksFound.length === 0) {
+            detectedPatterns.push('@ symbol found but no valid link pattern detected');
+            commonMistakes.push('Use @/path/doc.md or @#section format for links');
+        }
+        // Check for standard markdown links to .md files
+        if (content.match(/\[.*\]\(\/.*\.md.*\)/)) {
+            detectedPatterns.push('Standard markdown links to .md files detected');
+            commonMistakes.push('Consider using @ syntax instead: @/path/doc.md');
+        }
+        return {
+            detected_patterns: detectedPatterns,
+            correct_examples: [...LINK_SYNTAX_EXAMPLES],
+            common_mistakes: commonMistakes
+        };
+    }
+    /**
+     * Generate content-based link suggestions
+     */
+    async generateLinkSuggestions(content, documentPath) {
+        const linkSuggestions = [];
+        // Extract keywords from content
+        const keywords = this.extractContentKeywords(content);
+        if (keywords.length > 0) {
+            try {
+                // Search for related documents based on content
+                const searchResults = await this.manager.searchDocuments(keywords.slice(0, 3).join(' '), {
+                    searchIn: ['title', 'content'],
+                    fuzzy: true,
+                    groupByDocument: true
+                });
+                // Filter out current document and suggest top matches
+                const relevantResults = searchResults
+                    .filter(result => result.documentPath !== documentPath)
+                    .slice(0, 3);
+                for (const result of relevantResults) {
+                    const document = await this.manager.getDocument(result.documentPath);
+                    if (document) {
+                        try {
+                            const docAddress = parseDocumentAddress(result.documentPath);
+                            const targetNamespace = docAddress.namespace;
+                            // Determine placement hint based on content and namespace
+                            const placementHint = this.generatePlacementHint(content);
+                            linkSuggestions.push({
+                                suggested_link: `@${result.documentPath}`,
+                                target_document: result.documentTitle,
+                                rationale: `Related ${targetNamespace} document with shared concepts: ${keywords.slice(0, 2).join(', ')}`,
+                                placement_hint: placementHint
+                            });
+                        }
+                        catch {
+                            // Skip suggestions if address parsing fails
+                        }
+                    }
+                }
+            }
+            catch {
+                // Silently continue if search fails
+            }
+        }
+        return linkSuggestions;
+    }
+    /**
+     * Generate placement hint based on content context
+     */
+    generatePlacementHint(content) {
+        if (content.includes('overview') || content.includes('introduction')) {
+            return 'Consider adding to overview section for context';
+        }
+        else if (content.includes('implementation') || content.includes('example')) {
+            return 'Reference in implementation details';
+        }
+        else if (content.includes('see also') || content.includes('related')) {
+            return 'Perfect for "See Also" or "Related" sections';
+        }
+        return 'Add to relevant paragraph or list';
+    }
+    /**
+     * Extract meaningful keywords from content for link suggestions
+     */
+    extractContentKeywords(content) {
+        // Simple keyword extraction - remove markdown, get meaningful words
+        const cleanContent = content
+            .replace(/[#*`_[\]()]/g, ' ')
+            .toLowerCase()
+            .replace(/[^\w\s]/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+        const words = cleanContent.split(' ').filter(word => word.length > 3 &&
+            !this.isStopWord(word) &&
+            !word.match(/^\d+$/));
+        // Return unique words, limited to top 10
+        return [...new Set(words)].slice(0, 10);
+    }
+    /**
+     * Check if word is a stop word
+     */
+    isStopWord(word) {
+        const stopWords = new Set([
+            'this', 'that', 'these', 'those', 'with', 'from', 'they', 'them', 'their',
+            'have', 'been', 'were', 'will', 'would', 'could', 'should', 'might',
+            'here', 'there', 'when', 'where', 'what', 'which', 'very', 'more',
+            'most', 'some', 'such', 'only', 'just', 'like', 'into', 'over',
+            'also', 'well', 'even', 'make', 'made', 'take', 'used', 'using'
+        ]);
+        return stopWords.has(word);
+    }
+}
+/**
+ * Convenience function to create link analysis service
+ * Note: Used via dynamic import in section.ts for performance optimization
+ */
+export function createLinkAnalysisService(manager) {
+    return new LinkAnalysisService(manager);
+}
+//# sourceMappingURL=link-analysis.js.map

package/dist/shared/link-analysis.js.map

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

package/dist/shared/link-context.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Link context loading functionality
+ */
+import type { DocumentManager } from '../document-manager.js';
+/**
+ * Load linked document context for enhanced view_document responses
+ *
+ * @param manager - DocumentManager instance
+ * @param documentPath - Path to the source document
+ * @param sectionSlug - Optional section slug to limit scope
+ * @param linkDepth - Maximum depth for recursive context loading (1-3)
+ * @returns Array of linked context objects
+ */
+export declare function loadLinkedDocumentContext(manager: DocumentManager, documentPath: string, sectionSlug?: string, linkDepth?: number): Promise<Array<{
+    source_link: string;
+    document_path: string;
+    section_slug?: string;
+    content: string;
+    namespace: string;
+    title: string;
+    relevance: 'primary' | 'secondary' | 'tertiary';
+}>>;
+//# sourceMappingURL=link-context.d.ts.map

package/dist/shared/link-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-context.d.ts","sourceRoot":"","sources":["../../src/shared/link-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,GAAE,MAAU,GACpB,OAAO,CAAC,KAAK,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;CACjD,CAAC,CAAC,CAgOF"}

package/dist/shared/link-context.js

@@ -0,0 +1,172 @@
+/**
+ * Link context loading functionality
+ */
+/**
+ * Load linked document context for enhanced view_document responses
+ *
+ * @param manager - DocumentManager instance
+ * @param documentPath - Path to the source document
+ * @param sectionSlug - Optional section slug to limit scope
+ * @param linkDepth - Maximum depth for recursive context loading (1-3)
+ * @returns Array of linked context objects
+ */
+export async function loadLinkedDocumentContext(manager, documentPath, sectionSlug, linkDepth = 2) {
+    // Input validation
+    if (linkDepth < 1 || linkDepth > 3) {
+        linkDepth = 2;
+    }
+    const linkedContext = [];
+    // Track visited links to prevent cycles
+    const visited = new Set();
+    // Queue for breadth-first context loading
+    const queue = [];
+    // Get the source document
+    const sourceDocument = await manager.getDocument(documentPath);
+    if (!sourceDocument) {
+        return linkedContext;
+    }
+    // Determine content to scan for links
+    let contentToScan = '';
+    if (sectionSlug != null && sectionSlug !== '') {
+        // Scan only the specified section
+        const sectionContent = await manager.getSectionContent(documentPath, sectionSlug);
+        contentToScan = sectionContent ?? '';
+    }
+    else {
+        // Scan entire document using DocumentManager's cache which knows the correct root path
+        const fullContent = await manager.cache.readDocumentContent(documentPath);
+        if (fullContent == null) {
+            return linkedContext;
+        }
+        contentToScan = fullContent;
+    }
+    // Extract all @ links from content using unified ReferenceExtractor
+    const { ReferenceExtractor } = await import('./reference-extractor.js');
+    const extractor = new ReferenceExtractor();
+    const refs = extractor.extractReferences(contentToScan);
+    // Process each unique link
+    const uniqueLinks = [...new Set(refs)];
+    for (const linkText of uniqueLinks) {
+        const { parseLink: parseLinkFn } = await import('./link-utils.js');
+        const parsedLink = parseLinkFn(linkText, documentPath);
+        if (parsedLink.type === 'external') {
+            continue;
+        }
+        // Resolve the link
+        const { resolveLinkWithContext } = await import('./link-utils.js');
+        const resolved = await resolveLinkWithContext(linkText, documentPath, manager);
+        if (resolved.validation.valid !== true || resolved.resolvedPath == null) {
+            continue;
+        }
+        // Extract document path and section from resolved path
+        const hashIndex = resolved.resolvedPath.indexOf('#');
+        const docPath = hashIndex === -1 ? resolved.resolvedPath : resolved.resolvedPath.slice(0, hashIndex);
+        const sectionSlug = hashIndex === -1 ? undefined : resolved.resolvedPath.slice(hashIndex + 1);
+        // Add to processing queue (will check visited set during queue processing)
+        const queueItem = {
+            docPath,
+            depth: 1,
+            relevance: 'primary'
+        };
+        if (sectionSlug != null && sectionSlug !== '') {
+            queueItem.sectionSlug = sectionSlug;
+        }
+        queue.push(queueItem);
+    }
+    // Process queue with depth limiting
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (!current || current.depth > linkDepth) {
+            continue;
+        }
+        const currentId = `${current.docPath}#${current.sectionSlug ?? ''}`;
+        if (visited.has(currentId)) {
+            continue;
+        }
+        visited.add(currentId);
+        // Load the linked document
+        const linkedDoc = await manager.getDocument(current.docPath);
+        if (!linkedDoc) {
+            continue;
+        }
+        // Get content and metadata
+        let content = '';
+        let title = linkedDoc.metadata.title;
+        if (current.sectionSlug != null && current.sectionSlug !== '') {
+            // Load specific section
+            const sectionContent = await manager.getSectionContent(current.docPath, current.sectionSlug);
+            content = sectionContent ?? '';
+            // Find section title
+            const section = linkedDoc.headings.find(h => h.slug === current.sectionSlug);
+            if (section != null) {
+                title = section.title;
+            }
+        }
+        else {
+            // Load entire document using DocumentManager's cache which knows the correct root path
+            const fullContent = await manager.cache.readDocumentContent(current.docPath);
+            if (fullContent == null) {
+                continue;
+            }
+            content = fullContent;
+        }
+        // Extract namespace using central addressing system
+        const { pathToNamespace } = await import('./path-utilities.js');
+        const namespace = pathToNamespace(current.docPath);
+        // Create source link reference
+        const sourceLink = current.sectionSlug != null && current.sectionSlug !== ''
+            ? `@${current.docPath}#${current.sectionSlug}`
+            : `@${current.docPath}`;
+        // Add to context
+        const contextItem = {
+            source_link: sourceLink,
+            document_path: current.docPath,
+            content,
+            namespace,
+            title,
+            relevance: current.relevance
+        };
+        if (current.sectionSlug != null && current.sectionSlug !== '') {
+            contextItem.section_slug = current.sectionSlug;
+        }
+        linkedContext.push(contextItem);
+        // If we haven't reached max depth, scan this content for more links
+        if (current.depth < linkDepth) {
+            const nestedRefs = extractor.extractReferences(content);
+            const uniqueNestedLinks = [...new Set(nestedRefs)];
+            for (const nestedLinkText of uniqueNestedLinks) {
+                const { parseLink: parseLinkNestedFn } = await import('./link-utils.js');
+                const nestedParsed = parseLinkNestedFn(nestedLinkText, current.docPath);
+                if (nestedParsed.type === 'external') {
+                    continue;
+                }
+                const { resolveLinkWithContext: resolveLinkNestedFn } = await import('./link-utils.js');
+                const nestedResolved = await resolveLinkNestedFn(nestedLinkText, current.docPath, manager);
+                if (nestedResolved.validation.valid !== true || nestedResolved.resolvedPath == null) {
+                    continue;
+                }
+                // Extract document path and section from resolved path
+                const nestedHashIndex = nestedResolved.resolvedPath.indexOf('#');
+                const nestedDocPath = nestedHashIndex === -1 ? nestedResolved.resolvedPath : nestedResolved.resolvedPath.slice(0, nestedHashIndex);
+                const nestedSectionSlug = nestedHashIndex === -1 ? undefined : nestedResolved.resolvedPath.slice(nestedHashIndex + 1);
+                const nestedId = `${nestedDocPath}#${nestedSectionSlug ?? ''}`;
+                if (visited.has(nestedId)) {
+                    continue;
+                }
+                // Add to queue with incremented depth and reduced relevance
+                const nextRelevance = current.relevance === 'primary' ? 'secondary' : 'tertiary';
+                const nestedQueueItem = {
+                    docPath: nestedDocPath,
+                    depth: current.depth + 1,
+                    relevance: nextRelevance
+                };
+                if (nestedSectionSlug != null && nestedSectionSlug !== '') {
+                    nestedQueueItem.sectionSlug = nestedSectionSlug;
+                }
+                queue.push(nestedQueueItem);
+            }
+        }
+    }
+    return linkedContext;
+}
+//# sourceMappingURL=link-context.js.map