ai-prompt-guide-mcp 1.0.0

package/dist/tools/browse/content-analyzer.js

@@ -0,0 +1,150 @@
+/**
+ * Content analysis and similarity detection for document relationships
+ */
+import { pathToNamespace } from '../../shared/utilities.js';
+import { detectCycles } from './dependency-analyzer.js';
+import { classifyRelationship } from './relationship-classifier.js';
+/**
+ * Find related documents by content similarity
+ */
+export async function findRelatedByContent(manager, docPath, currentDoc, context) {
+    const relatedDocs = [];
+    try {
+        // Get content from all sections of the current document
+        let fullContent = '';
+        for (const heading of currentDoc.headings) {
+            try {
+                const sectionContent = await manager.getSectionContent(docPath, heading.slug);
+                if (sectionContent != null) {
+                    fullContent += `${sectionContent}\n`;
+                }
+            }
+            catch {
+                // Skip sections that can't be read
+            }
+        }
+        // Extract key concepts from current document title and content
+        const titleWords = extractKeywords(currentDoc.metadata.title);
+        const contentKeywords = extractKeywords(fullContent.slice(0, 1000)); // First 1000 chars
+        const allKeywords = [...titleWords, ...contentKeywords];
+        if (allKeywords.length === 0) {
+            return relatedDocs;
+        }
+        // Search for documents with similar content
+        const searchQuery = allKeywords.slice(0, 5).join(' '); // Use top 5 keywords
+        const searchResults = await manager.searchDocuments(searchQuery, {
+            searchIn: ['title', 'content'],
+            fuzzy: true,
+            groupByDocument: true
+        });
+        for (const result of searchResults) {
+            // Skip self and documents we've already processed
+            if (result.documentPath === docPath) {
+                continue;
+            }
+            // Skip if this would create a cycle
+            if (detectCycles(context, result.documentPath)) {
+                continue;
+            }
+            try {
+                const relatedDoc = await manager.getDocument(result.documentPath);
+                if (relatedDoc != null) {
+                    // Get content from other document's sections
+                    let otherContent = '';
+                    for (const heading of relatedDoc.headings.slice(0, 3)) { // Limit to first 3 sections for performance
+                        try {
+                            const sectionContent = await manager.getSectionContent(result.documentPath, heading.slug);
+                            if (sectionContent != null) {
+                                otherContent += `${sectionContent}\n`;
+                            }
+                        }
+                        catch {
+                            // Skip sections that can't be read
+                        }
+                    }
+                    // Calculate relevance based on shared concepts
+                    const otherKeywords = extractKeywords(`${relatedDoc.metadata.title} ${otherContent.slice(0, 1000)}`);
+                    const sharedConcepts = allKeywords.filter(keyword => otherKeywords.includes(keyword));
+                    const relevance = sharedConcepts.length / Math.max(allKeywords.length, otherKeywords.length);
+                    // Only include if relevance is above threshold
+                    if (relevance >= 0.6) {
+                        const relationship = classifyRelationship(docPath, result.documentPath, '', relatedDoc.metadata.title);
+                        const related = {
+                            path: result.documentPath,
+                            title: relatedDoc.metadata.title,
+                            namespace: pathToNamespace(result.documentPath),
+                            relationship,
+                            relevance: Math.round(relevance * 100) / 100,
+                            shared_concepts: sharedConcepts.slice(0, 5) // Top 5 shared concepts
+                        };
+                        relatedDocs.push(related);
+                    }
+                }
+            }
+            catch {
+                // Skip documents that can't be loaded
+            }
+        }
+        // Sort by relevance descending
+        relatedDocs.sort((a, b) => (b.relevance ?? 0) - (a.relevance ?? 0));
+        // Limit results to prevent overwhelming output
+        return relatedDocs.slice(0, 10);
+    }
+    catch {
+        // Return empty if analysis fails
+    }
+    return relatedDocs;
+}
+/**
+ * Extract keywords from text for content similarity analysis
+ */
+// ts-unused-exports:disable-next-line
+export function extractKeywords(text) {
+    if (text == null || text === '') {
+        return [];
+    }
+    // Remove markdown formatting and normalize
+    const cleanText = text
+        .replace(/[#*`_[\]()]/g, ' ')
+        .toLowerCase()
+        .replace(/[^\w\s]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+    // Split into words and filter
+    const words = cleanText.split(' ').filter(word => word.length > 2 &&
+        !isStopWord(word) &&
+        !word.match(/^\d+$/) // Skip pure numbers
+    );
+    // Remove duplicates and return
+    return [...new Set(words)];
+}
+/**
+ * Check if a word is a stop word (common words to ignore)
+ */
+// ts-unused-exports:disable-next-line
+export function isStopWord(word) {
+    const stopWords = new Set([
+        'the', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for', 'of', 'with', 'by',
+        'this', 'that', 'these', 'those', 'is', 'are', 'was', 'were', 'be', 'been',
+        'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could', 'should',
+        'can', 'may', 'might', 'must', 'shall', 'from', 'up', 'out', 'down', 'off',
+        'over', 'under', 'again', 'further', 'then', 'once', 'here', 'there', 'when',
+        'where', 'why', 'how', 'all', 'any', 'both', 'each', 'few', 'more', 'most',
+        'other', 'some', 'such', 'no', 'nor', 'not', 'only', 'own', 'same', 'so',
+        'than', 'too', 'very', 'just', 'now', 'get', 'set', 'put', 'use', 'new'
+    ]);
+    return stopWords.has(word);
+}
+/**
+ * Analyze section content for metadata
+ */
+export function analyzeSectionContent(content) {
+    const has_code_blocks = /```[\s\S]*?```|`[^`]+`/.test(content);
+    const has_links = /\[[^\]]*\]\([^)]+\)|\[[^\]]*\]\[[^\]]*\]/.test(content);
+    // Get first few lines as preview (up to 200 chars)
+    const lines = content.split('\n').filter(line => line.trim() !== '');
+    const preview = lines.slice(0, 3).join(' ').trim();
+    const content_preview = preview.length > 200 ? `${preview.slice(0, 200)}...` : preview;
+    return { has_code_blocks, has_links, content_preview };
+}
+//# sourceMappingURL=content-analyzer.js.map

package/dist/tools/browse/content-analyzer.js.map

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

package/dist/tools/browse/dependency-analyzer.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Dependency analysis and cycle detection for document linking
+ */
+import type { DocumentManager } from '../../document-manager.js';
+import type { CachedDocument } from '../../document-cache.js';
+export interface CycleDetectionContext {
+    visited: Set<string>;
+    currentPath: string[];
+    depth: number;
+    maxDepth: number;
+}
+export interface RelatedDocument {
+    path: string;
+    title: string;
+    namespace: string;
+    relationship: RelationshipType;
+    relevance?: number;
+    sections_linked?: string[];
+    sections_linking?: string[];
+    tasks_linked?: number;
+    completion_status?: string;
+    shared_concepts?: string[];
+}
+export type RelationshipType = 'implements_spec' | 'implementation_guide' | 'consumes_api' | 'depends_on' | 'references' | 'similar_content';
+export interface DependencyNode {
+    sequence: number;
+    path: string;
+    title: string;
+    status: 'completed' | 'in_progress' | 'pending';
+    blocks?: string[];
+    depends_on?: string[];
+}
+export interface RelatedDocuments {
+    forward_links: RelatedDocument[];
+    backward_links: RelatedDocument[];
+    related_by_content: RelatedDocument[];
+    dependency_chain: DependencyNode[];
+}
+/**
+ * Detect cycles in document traversal to prevent infinite loops
+ */
+export declare function detectCycles(context: CycleDetectionContext, targetPath: string): boolean;
+/**
+ * Find forward links - documents that this document references
+ */
+export declare function findForwardLinks(manager: DocumentManager, docPath: string, document: CachedDocument, context: CycleDetectionContext, classifyRelationship: (fromDocPath: string, toDocPath: string, linkText: string, toDocTitle: string) => RelationshipType): Promise<RelatedDocument[]>;
+/**
+ * Find backward links - documents that reference this document
+ */
+export declare function findBackwardLinks(manager: DocumentManager, docPath: string, context: CycleDetectionContext, classifyRelationship: (fromDocPath: string, toDocPath: string, linkText: string, toDocTitle: string) => RelationshipType): Promise<RelatedDocument[]>;
+/**
+ * Build dependency chain from related documents
+ */
+export declare function buildDependencyChain(relatedDocs: RelatedDocument[]): DependencyNode[];
+/**
+ * Determine completion status of a document based on available information
+ */
+export declare function determineCompletionStatus(doc: RelatedDocument): 'completed' | 'in_progress' | 'pending';
+/**
+ * Main function to analyze document links and relationships
+ */
+export declare function analyzeDocumentLinks(manager: DocumentManager, docPath: string, linkDepth: number, classifyRelationship: (fromDocPath: string, toDocPath: string, linkText: string, toDocTitle: string) => RelationshipType, findRelatedByContent: (manager: DocumentManager, docPath: string, currentDoc: CachedDocument, context: CycleDetectionContext) => Promise<RelatedDocument[]>): Promise<RelatedDocuments | null>;
+//# sourceMappingURL=dependency-analyzer.d.ts.map

package/dist/tools/browse/dependency-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-analyzer.d.ts","sourceRoot":"","sources":["../../../src/tools/browse/dependency-analyzer.ts"],"names":[],"mappings":"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"}

package/dist/tools/browse/dependency-analyzer.js

@@ -0,0 +1,261 @@
+/**
+ * Dependency analysis and cycle detection for document linking
+ */
+import { pathToNamespace } from '../../shared/utilities.js';
+/**
+ * Detect cycles in document traversal to prevent infinite loops
+ */
+export function detectCycles(context, targetPath) {
+    // Check if we've exceeded max depth
+    if (context.depth >= context.maxDepth) {
+        return true;
+    }
+    // Check if we've already visited this document
+    if (context.visited.has(targetPath)) {
+        return true;
+    }
+    // Check if this creates a cycle in current path
+    return context.currentPath.includes(targetPath);
+}
+/**
+ * Find forward links - documents that this document references
+ */
+// ts-unused-exports:disable-next-line
+export async function findForwardLinks(manager, docPath, document, context, classifyRelationship) {
+    const forwardLinks = [];
+    // Get content from all sections of the document
+    let fullContent = '';
+    for (const heading of document.headings) {
+        try {
+            const sectionContent = await manager.getSectionContent(docPath, heading.slug);
+            if (sectionContent != null) {
+                fullContent += `${sectionContent}\n`;
+            }
+        }
+        catch {
+            // Skip sections that can't be read
+        }
+    }
+    // Pattern to match markdown links: [text](path) or [text](path#section)
+    const linkPattern = /\[([^\]]*)\]\(([^)]+)\)/g;
+    let match;
+    while ((match = linkPattern.exec(fullContent)) !== null) {
+        const linkText = match[1] ?? '';
+        const linkPath = match[2] ?? '';
+        // Skip external links (http/https)
+        if (linkPath.startsWith('http://') || linkPath.startsWith('https://')) {
+            continue;
+        }
+        // Extract document path and section from link
+        const hashIndex = linkPath.indexOf('#');
+        const targetDocPath = hashIndex === -1 ? linkPath : linkPath.slice(0, hashIndex);
+        const targetSection = hashIndex === -1 ? undefined : linkPath.slice(hashIndex + 1);
+        // Normalize path - ensure it starts with /
+        const normalizedPath = targetDocPath.startsWith('/') ? targetDocPath : `/${targetDocPath}`;
+        // Skip if this would create a cycle
+        if (detectCycles(context, normalizedPath)) {
+            continue;
+        }
+        try {
+            const targetDoc = await manager.getDocument(normalizedPath);
+            if (targetDoc != null) {
+                const relationship = classifyRelationship(docPath, normalizedPath, linkText, targetDoc.metadata.title);
+                const relatedDoc = {
+                    path: normalizedPath,
+                    title: targetDoc.metadata.title,
+                    namespace: pathToNamespace(normalizedPath),
+                    relationship,
+                    ...(targetSection != null && { sections_linked: [targetSection] })
+                };
+                // Check if we already have this document in our list
+                const existing = forwardLinks.find(link => link.path === normalizedPath);
+                if (existing != null) {
+                    // Merge section information
+                    if (targetSection != null && existing.sections_linked != null) {
+                        if (!existing.sections_linked.includes(targetSection)) {
+                            existing.sections_linked.push(targetSection);
+                        }
+                    }
+                }
+                else {
+                    forwardLinks.push(relatedDoc);
+                }
+            }
+        }
+        catch {
+            // Skip documents that can't be loaded
+        }
+    }
+    return forwardLinks;
+}
+/**
+ * Find backward links - documents that reference this document
+ */
+// ts-unused-exports:disable-next-line
+export async function findBackwardLinks(manager, docPath, context, classifyRelationship) {
+    const backwardLinks = [];
+    try {
+        // Search for references to this document across all documents
+        const searchResults = await manager.searchDocuments(docPath, {
+            searchIn: ['content'],
+            fuzzy: false,
+            groupByDocument: true
+        });
+        for (const result of searchResults) {
+            // Skip self-references
+            if (result.documentPath === docPath) {
+                continue;
+            }
+            // Skip if this would create a cycle
+            if (detectCycles(context, result.documentPath)) {
+                continue;
+            }
+            try {
+                const referencingDoc = await manager.getDocument(result.documentPath);
+                if (referencingDoc != null) {
+                    const relationship = classifyRelationship(result.documentPath, docPath, '', referencingDoc.metadata.title);
+                    // Find which sections contain the links
+                    const sectionsLinking = [];
+                    for (const match of result.matches) {
+                        if (match.slug != null && match.slug !== '' && !sectionsLinking.includes(match.slug)) {
+                            sectionsLinking.push(match.slug);
+                        }
+                    }
+                    const relatedDoc = {
+                        path: result.documentPath,
+                        title: referencingDoc.metadata.title,
+                        namespace: pathToNamespace(result.documentPath),
+                        relationship,
+                        ...(sectionsLinking.length > 0 && { sections_linking: sectionsLinking })
+                    };
+                    backwardLinks.push(relatedDoc);
+                }
+            }
+            catch {
+                // Skip documents that can't be loaded
+            }
+        }
+    }
+    catch {
+        // Return empty if search fails
+    }
+    return backwardLinks;
+}
+/**
+ * Build dependency chain from related documents
+ */
+// ts-unused-exports:disable-next-line
+export function buildDependencyChain(relatedDocs) {
+    const dependencyChain = [];
+    const processed = new Set();
+    // Group documents by logical sequence
+    const specs = relatedDocs.filter(doc => doc.relationship === 'implements_spec' || doc.namespace.includes('spec'));
+    const guides = relatedDocs.filter(doc => doc.relationship === 'implementation_guide' || doc.namespace.includes('guide'));
+    const implementations = relatedDocs.filter(doc => doc.relationship === 'consumes_api' ||
+        doc.namespace.includes('backend') ||
+        doc.namespace.includes('frontend') ||
+        doc.namespace.includes('service') ||
+        doc.namespace.includes('component'));
+    let sequence = 1;
+    // Add specs first (foundational)
+    for (const spec of specs) {
+        if (!processed.has(spec.path)) {
+            dependencyChain.push({
+                sequence: sequence++,
+                path: spec.path,
+                title: spec.title,
+                status: determineCompletionStatus(spec),
+                blocks: guides.filter(g => !processed.has(g.path)).map(g => g.path)
+            });
+            processed.add(spec.path);
+        }
+    }
+    // Add guides next (implementation guidance)
+    for (const guide of guides) {
+        if (!processed.has(guide.path)) {
+            dependencyChain.push({
+                sequence: sequence++,
+                path: guide.path,
+                title: guide.title,
+                status: determineCompletionStatus(guide),
+                blocks: implementations.filter(i => !processed.has(i.path)).map(i => i.path),
+                depends_on: specs.map(s => s.path)
+            });
+            processed.add(guide.path);
+        }
+    }
+    // Add implementations last
+    for (const impl of implementations) {
+        if (!processed.has(impl.path)) {
+            dependencyChain.push({
+                sequence: sequence++,
+                path: impl.path,
+                title: impl.title,
+                status: determineCompletionStatus(impl),
+                depends_on: [...specs.map(s => s.path), ...guides.map(g => g.path)]
+            });
+            processed.add(impl.path);
+        }
+    }
+    return dependencyChain;
+}
+/**
+ * Determine completion status of a document based on available information
+ */
+// ts-unused-exports:disable-next-line
+export function determineCompletionStatus(doc) {
+    // Use completion status if available
+    if (doc.completion_status != null && doc.completion_status !== '') {
+        const percentage = parseInt(doc.completion_status.replace('%', ''), 10);
+        if (percentage >= 100)
+            return 'completed';
+        if (percentage > 0)
+            return 'in_progress';
+        return 'pending';
+    }
+    // Use task information if available
+    if (doc.tasks_linked != null && doc.tasks_linked > 0) {
+        return 'in_progress';
+    }
+    // Default to pending for unknown status
+    return 'pending';
+}
+/**
+ * Main function to analyze document links and relationships
+ */
+export async function analyzeDocumentLinks(manager, docPath, linkDepth, classifyRelationship, findRelatedByContent) {
+    try {
+        const document = await manager.getDocument(docPath);
+        if (document == null) {
+            return null;
+        }
+        // Initialize cycle detection context
+        const context = {
+            visited: new Set(),
+            currentPath: [docPath],
+            depth: 0,
+            maxDepth: Math.min(linkDepth, 3) // Hard limit of 3 levels
+        };
+        // Mark current document as visited
+        context.visited.add(docPath);
+        // Analyze different types of relationships
+        const [forwardLinks, backwardLinks, relatedByContent] = await Promise.all([
+            findForwardLinks(manager, docPath, document, { ...context, depth: context.depth + 1 }, classifyRelationship),
+            findBackwardLinks(manager, docPath, { ...context, depth: context.depth + 1 }, classifyRelationship),
+            findRelatedByContent(manager, docPath, document, { ...context, depth: context.depth + 1 })
+        ]);
+        // Combine all related documents for dependency analysis
+        const allRelated = [...forwardLinks, ...backwardLinks, ...relatedByContent];
+        const dependencyChain = buildDependencyChain(allRelated);
+        return {
+            forward_links: forwardLinks,
+            backward_links: backwardLinks,
+            related_by_content: relatedByContent,
+            dependency_chain: dependencyChain
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=dependency-analyzer.js.map

package/dist/tools/browse/dependency-analyzer.js.map

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

package/dist/tools/browse/folder-navigator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Folder navigation, breadcrumb generation, and file system operations
+ */
+import type { DocumentManager } from '../../document-manager.js';
+import type { DocumentInfo } from './search-engine.js';
+export interface FolderInfo {
+    name: string;
+    path: string;
+    namespace: string;
+    documentCount: number;
+    hasSubfolders: boolean;
+}
+/**
+ * Parse section path into document path and section slug
+ */
+export declare function parseSectionPath(fullPath: string): {
+    documentPath: string;
+    sectionSlug?: string;
+};
+/**
+ * Generate breadcrumb trail for a path (including section context)
+ */
+export declare function generateBreadcrumb(docPath: string): string[];
+/**
+ * Check if a directory exists
+ */
+export declare function directoryExists(dirPath: string): Promise<boolean>;
+/**
+ * Get folder structure at specified path
+ */
+export declare function getFolderStructure(manager: DocumentManager, basePath: string, targetPath: string, verbose?: boolean): Promise<{
+    folders: FolderInfo[];
+    documents: DocumentInfo[];
+}>;
+//# sourceMappingURL=folder-navigator.d.ts.map

package/dist/tools/browse/folder-navigator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-navigator.d.ts","sourceRoot":"","sources":["../../../src/tools/browse/folder-navigator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAiBjG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAiB5D;AAED;;GAEG;AAEH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,UAAQ,GACd,OAAO,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAC;IAAC,SAAS,EAAE,YAAY,EAAE,CAAA;CAAC,CAAC,CA0G7D"}