ai-prompt-guide-mcp 1.0.0

package/dist/tools/implementations/view-document.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Enhanced view_document tool implementation with namespace support and linked document context loading
+ */
+import type { SessionState } from '../../session/types.js';
+import type { DocumentManager } from '../../document-manager.js';
+/**
+ * Enhanced response format for view_document (supports multiple documents)
+ */
+interface ViewDocumentResponse {
+    documents: Array<{
+        path: string;
+        slug: string;
+        title: string;
+        namespace: string;
+        sections: Array<{
+            slug: string;
+            title: string;
+            depth: number;
+        }>;
+        documentLinks: {
+            total: number;
+            internal: number;
+            external: number;
+            broken: number;
+            sectionsWithoutLinks: string[];
+        };
+        tasks?: {
+            total: number;
+            completed: number;
+            pending: number;
+            sections_with_tasks: string[];
+        };
+        lastModified: string;
+        wordCount: number;
+        headingCount: number;
+    }>;
+    summary: {
+        total_documents: number;
+        total_sections: number;
+        total_words: number;
+        total_tasks?: number;
+    };
+    linked_context?: Array<{
+        source_link: string;
+        document_path: string;
+        section_slug?: string;
+        content: string;
+        namespace: string;
+        title: string;
+        relevance: 'primary' | 'secondary' | 'tertiary';
+    }>;
+}
+/**
+ * MCP tool for enhanced document viewing with comprehensive metadata and linked document context
+ *
+ * Provides detailed document inspection including content, structure analysis, statistics,
+ * and automatic loading of linked document context. Supports both single and multiple document viewing.
+ *
+ * @param args - Parameters object containing document path(s) and viewing options
+ * @param _state - MCP session state (unused in current implementation)
+ * @returns Enhanced document information with metadata, content, statistics, and linked context
+ *
+ * @example
+ * // Single document view
+ * const result = await viewDocument({
+ *   document: "/docs/api/authentication.md"
+ * });
+ *
+ * // Multiple documents with linked context loading
+ * const result = await viewDocument({
+ *   documents: ["/docs/api/auth.md", "/docs/api/users.md"],
+ *   include_linked_context: true
+ * });
+ *
+ * // Access comprehensive document information
+ * console.log(result.documents[0].title);
+ * console.log(result.documents[0].statistics.word_count);
+ * console.log(result.documents[0].headings.length);
+ *
+ * @throws {DocumentNotFoundError} When documents cannot be loaded
+ */
+export declare function viewDocument(args: Record<string, unknown>, _state: SessionState, manager: DocumentManager): Promise<ViewDocumentResponse>;
+export {};
+//# sourceMappingURL=view-document.d.ts.map

package/dist/tools/implementations/view-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-document.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/view-document.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAMjE;;GAEG;AACH,UAAU,oBAAoB;IAE5B,SAAS,EAAE,KAAK,CAAC;QAEf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,KAAK,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;SACf,CAAC,CAAC;QAGH,aAAa,EAAE;YACb,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,oBAAoB,EAAE,MAAM,EAAE,CAAC;SAChC,CAAC;QAGF,KAAK,CAAC,EAAE;YACN,KAAK,EAAE,MAAM,CAAC;YACd,SAAS,EAAE,MAAM,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,mBAAmB,EAAE,MAAM,EAAE,CAAC;SAC/B,CAAC;QACF,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IAGH,OAAO,EAAE;QACP,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAGF,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;KACjD,CAAC,CAAC;CACJ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,oBAAoB,CAAC,CA+E/B"}

package/dist/tools/implementations/view-document.js

@@ -0,0 +1,287 @@
+/**
+ * Enhanced view_document tool implementation with namespace support and linked document context loading
+ */
+import { loadLinkedDocumentContext } from '../../shared/utilities.js';
+import { DocumentNotFoundError } from '../../shared/addressing-system.js';
+import { getTaskHeadings } from '../../shared/task-utilities.js';
+/**
+ * MCP tool for enhanced document viewing with comprehensive metadata and linked document context
+ *
+ * Provides detailed document inspection including content, structure analysis, statistics,
+ * and automatic loading of linked document context. Supports both single and multiple document viewing.
+ *
+ * @param args - Parameters object containing document path(s) and viewing options
+ * @param _state - MCP session state (unused in current implementation)
+ * @returns Enhanced document information with metadata, content, statistics, and linked context
+ *
+ * @example
+ * // Single document view
+ * const result = await viewDocument({
+ *   document: "/docs/api/authentication.md"
+ * });
+ *
+ * // Multiple documents with linked context loading
+ * const result = await viewDocument({
+ *   documents: ["/docs/api/auth.md", "/docs/api/users.md"],
+ *   include_linked_context: true
+ * });
+ *
+ * // Access comprehensive document information
+ * console.log(result.documents[0].title);
+ * console.log(result.documents[0].statistics.word_count);
+ * console.log(result.documents[0].headings.length);
+ *
+ * @throws {DocumentNotFoundError} When documents cannot be loaded
+ */
+export async function viewDocument(args, _state, manager) {
+    // Import helper functions (validation now handled by ToolIntegration)
+    const { isValidLinkDepth } = await import('../schemas/view-document-schemas.js');
+    // Input validation and parsing using standardized utilities
+    const { ToolIntegration } = await import('../../shared/addressing-system.js');
+    const documents = ToolIntegration.validateArrayParameter(args['document'], 'document');
+    ToolIntegration.validateCountLimit(documents, 5, 'documents');
+    const includeLinked = args['include_linked'] ?? false;
+    let linkDepth = args['link_depth'] ?? 2;
+    // Validate link depth
+    if (!isValidLinkDepth(linkDepth)) {
+        linkDepth = 2;
+    }
+    // Process each document
+    const processedDocuments = [];
+    const allLinkedContext = [];
+    for (const documentPath of documents) {
+        // Use standardized document validation
+        const { addresses } = ToolIntegration.validateAndParse({
+            document: documentPath
+        });
+        // Get document
+        const document = await manager.getDocument(addresses.document.path);
+        if (document == null) {
+            throw new DocumentNotFoundError(addresses.document.path);
+        }
+        const processedDoc = await processDocument({
+            manager,
+            documentPath,
+            document
+        });
+        processedDocuments.push(processedDoc);
+        // Load linked context if requested (only for first document to avoid overwhelming response)
+        if (includeLinked && processedDocuments.length === 1) {
+            try {
+                const linkedContext = await loadLinkedDocumentContext(manager, documentPath, undefined, linkDepth);
+                allLinkedContext.push(...linkedContext);
+            }
+            catch (error) {
+                console.warn('Failed to load linked context:', error);
+            }
+        }
+    }
+    // Calculate summary statistics
+    const summary = {
+        total_documents: processedDocuments.length,
+        total_sections: processedDocuments.reduce((sum, doc) => sum + doc.sections.length, 0),
+        total_words: processedDocuments.reduce((sum, doc) => sum + doc.wordCount, 0),
+        total_tasks: processedDocuments.reduce((sum, doc) => sum + (doc.tasks?.total ?? 0), 0)
+    };
+    // Build final response
+    const response = {
+        documents: processedDocuments,
+        summary
+    };
+    // Add optional fields
+    if (allLinkedContext.length > 0) {
+        response.linked_context = allLinkedContext;
+    }
+    return response;
+}
+/**
+ * Extract document metadata including title, namespace, and file statistics
+ */
+async function extractDocumentMetadata(manager, documentPath, document) {
+    // Parse document address for standardized formatting
+    const { parseDocumentAddress, ToolIntegration } = await import('../../shared/addressing-system.js');
+    const documentAddress = parseDocumentAddress(documentPath);
+    const documentInfo = ToolIntegration.formatDocumentInfo(documentAddress, { title: document.metadata.title });
+    // Read file content and statistics using VirtualPathResolver
+    const { readFile, stat } = await import('node:fs/promises');
+    const absolutePath = manager.pathResolver.resolve(documentPath);
+    let fullContent = '';
+    let lastModified = '';
+    try {
+        fullContent = await readFile(absolutePath, 'utf-8');
+        const stats = await stat(absolutePath);
+        lastModified = stats.mtime.toISOString();
+    }
+    catch {
+        // Handle file read errors gracefully
+        lastModified = new Date().toISOString();
+    }
+    // Calculate statistics
+    const wordCount = fullContent.split(/\s+/).filter(word => word.length > 0).length;
+    const headingCount = document.headings.length;
+    return {
+        documentInfo,
+        lastModified,
+        wordCount,
+        headingCount,
+        fullContent
+    };
+}
+/**
+ * Analyze document sections and build simple section overview
+ * Returns only essential information: slug, title, and depth for ALL sections
+ */
+async function analyzeDocumentSections(params) {
+    const { document } = params;
+    // Build simple sections with only essential information - ALWAYS show ALL sections
+    const simpleSections = document.headings.map((heading) => {
+        return {
+            slug: heading.slug,
+            title: heading.title,
+            depth: heading.depth
+        };
+    });
+    return simpleSections;
+}
+/**
+ * Analyze document links including internal, external, and broken links
+ */
+async function analyzeDocumentLinks(params) {
+    const { manager, documentPath, document, fullContent } = params;
+    // Extract all links from full content using unified ReferenceExtractor
+    const { ReferenceExtractor } = await import('../../shared/reference-extractor.js');
+    const extractor = new ReferenceExtractor();
+    const allLinks = extractor.extractReferences(fullContent);
+    const externalLinks = fullContent.match(/\[([^\]]+)\]\(https?:\/\/[^)]+\)/g) ?? [];
+    let brokenLinks = 0;
+    const sectionsWithoutLinks = [];
+    // Check for broken links and sections without links
+    for (const heading of document.headings) {
+        const sectionContent = await manager.getSectionContent(documentPath, heading.slug) ?? '';
+        const sectionLinks = extractor.extractReferences(sectionContent);
+        if (sectionLinks.length === 0) {
+            sectionsWithoutLinks.push(heading.slug);
+        }
+        // Basic broken link detection (could be enhanced with actual validation)
+        for (const link of sectionLinks) {
+            const { parseLink } = await import('../../shared/link-utils.js');
+            const parsed = parseLink(link, documentPath);
+            if (parsed.type === 'cross-doc' && parsed.document != null && parsed.document !== '' && !parsed.document.includes('.md')) {
+                brokenLinks++;
+            }
+        }
+    }
+    return {
+        total: allLinks.length + externalLinks.length,
+        internal: allLinks.length,
+        external: externalLinks.length,
+        broken: brokenLinks,
+        sectionsWithoutLinks
+    };
+}
+/**
+ * Analyze document tasks including counts and status information
+ */
+async function analyzeDocumentTasks(manager, documentPath, document) {
+    // Find tasks section
+    const taskSection = document.headings.find((h) => h.slug === 'tasks' || h.title.toLowerCase() === 'tasks');
+    if (taskSection == null) {
+        return undefined;
+    }
+    // Use the same task identification logic as task.ts
+    const taskHeadings = await getTaskHeadings(document, taskSection);
+    let completedTasks = 0;
+    let pendingTasks = 0;
+    const sectionsWithTasks = [];
+    // Analyze each task heading for status
+    for (const taskHeading of taskHeadings) {
+        const content = await manager.getSectionContent(documentPath, taskHeading.slug) ?? '';
+        // Extract status using same logic as task.ts
+        const status = extractTaskStatus(content) ?? 'pending';
+        if (status === 'completed') {
+            completedTasks++;
+        }
+        else {
+            pendingTasks++;
+        }
+        sectionsWithTasks.push(taskHeading.slug);
+    }
+    const totalTasks = taskHeadings.length;
+    // Only return tasks object if there are actual tasks
+    if (totalTasks > 0) {
+        return {
+            total: totalTasks,
+            completed: completedTasks,
+            pending: pendingTasks,
+            sections_with_tasks: sectionsWithTasks
+        };
+    }
+    return undefined;
+}
+/**
+ * Format the final document response object
+ */
+async function formatDocumentResponse(params) {
+    const { documentPath, metadata, sections, documentLinks, tasks } = params;
+    // Parse document address to derive slug and namespace from path
+    const { parseDocumentAddress } = await import('../../shared/addressing-system.js');
+    const documentAddress = parseDocumentAddress(documentPath);
+    const documentData = {
+        path: documentPath,
+        slug: documentAddress.slug,
+        title: metadata.documentInfo.title,
+        namespace: documentAddress.namespace,
+        sections,
+        documentLinks,
+        lastModified: metadata.lastModified,
+        wordCount: metadata.wordCount,
+        headingCount: metadata.headingCount
+    };
+    if (tasks != null) {
+        documentData.tasks = tasks;
+    }
+    return documentData;
+}
+/**
+ * Process a single document and return its data
+ */
+async function processDocument(params) {
+    const { manager, documentPath, document } = params;
+    // Extract document metadata
+    const metadata = await extractDocumentMetadata(manager, documentPath, document);
+    // Analyze document sections - ALWAYS show ALL sections
+    const sections = await analyzeDocumentSections({
+        documentPath,
+        document
+    });
+    // Analyze document links
+    const documentLinks = await analyzeDocumentLinks({
+        manager,
+        documentPath,
+        document,
+        fullContent: metadata.fullContent
+    });
+    // Analyze document tasks
+    const tasks = await analyzeDocumentTasks(manager, documentPath, document);
+    // Format and return response
+    return await formatDocumentResponse({
+        documentPath,
+        metadata,
+        sections,
+        documentLinks,
+        tasks
+    });
+}
+// getTaskHeadingsForViewDocument function moved to shared/task-utilities.ts to eliminate duplication
+/**
+ * Extract task status from content (same logic as task.ts)
+ */
+function extractTaskStatus(content) {
+    // Support both "* Status: value" and "- Status: value" formats
+    const starMatch = content.match(/^\* Status:\s*(.+)$/m);
+    if (starMatch != null)
+        return starMatch[1]?.trim();
+    const dashMatch = content.match(/^- Status:\s*(.+)$/m);
+    return dashMatch?.[1]?.trim();
+}
+//# sourceMappingURL=view-document.js.map

package/dist/tools/implementations/view-document.js.map

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

package/dist/tools/implementations/view-section.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Implementation for view_section tool
+ * Provides clean section viewing without stats overhead
+ */
+import type { SessionState } from '../../session/types.js';
+import type { DocumentManager } from '../../document-manager.js';
+/**
+ * Enhanced response format for view_section with hierarchical support
+ */
+interface ViewSectionResponse {
+    mode: 'overview' | 'detail';
+    document: string;
+    sections: Array<{
+        slug: string;
+        title: string;
+        content?: string;
+        depth: number;
+        parent?: string;
+        word_count?: number;
+        links?: string[];
+    }>;
+}
+/**
+ * Execute view_section tool
+ */
+export declare function viewSection(args: Record<string, unknown>, _state: SessionState, manager: DocumentManager): Promise<ViewSectionResponse>;
+export {};
+//# sourceMappingURL=view-section.d.ts.map

package/dist/tools/implementations/view-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-section.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/view-section.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAYjE;;GAEG;AACH,UAAU,mBAAmB;IAC3B,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,mBAAmB,CAAC,CA6L9B"}

package/dist/tools/implementations/view-section.hierarchical.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * TDD-FIRST: Hierarchical view-section tool enhancement tests
+ *
+ * These tests MUST FAIL initially to follow TDD principles.
+ * They test hierarchical addressing enhancements for view-section.ts
+ */
+export {};
+//# sourceMappingURL=view-section.hierarchical.test.d.ts.map

package/dist/tools/implementations/view-section.hierarchical.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-section.hierarchical.test.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/view-section.hierarchical.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}