ai-prompt-guide-mcp 1.0.0

package/dist/tools/implementations/view-section.hierarchical.test.js

@@ -0,0 +1,318 @@
+/**
+ * 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
+ */
+import { describe, test, expect, beforeEach, vi } from 'vitest';
+import { viewSection } from './view-section.js';
+import { getDocumentManager } from '../../shared/utilities.js';
+// Mock dependencies
+vi.mock('../../shared/utilities.js', () => ({
+    getDocumentManager: vi.fn(),
+    splitSlugPath: vi.fn((slug) => slug.split('/')),
+    getParentSlug: vi.fn((slug) => {
+        const parts = slug.split('/');
+        return parts.length > 1 ? parts.slice(0, -1).join('/') : null;
+    })
+}));
+// Mock view-section schemas
+vi.mock('../schemas/view-section-schemas.js', () => ({
+    parseSections: vi.fn((sections) => Array.isArray(sections) ? sections : [sections]),
+    validateSectionCount: vi.fn(() => true)
+}));
+const mockGetDocumentManager = getDocumentManager;
+// Mock DocumentManager with hierarchical sections
+const createMockDocumentManager = () => ({
+    getDocument: vi.fn(() => Promise.resolve({
+        metadata: {
+            path: '/api/auth-guide.md',
+            title: 'Authentication Guide',
+            lastModified: new Date(),
+            contentHash: 'mock-hash',
+            wordCount: 800,
+            linkCount: 15,
+            codeBlockCount: 8,
+            lastAccessed: new Date()
+        },
+        headings: [
+            { slug: 'overview', title: 'Overview', depth: 2 },
+            { slug: 'api', title: 'API', depth: 2 },
+            { slug: 'api/authentication', title: 'Authentication', depth: 3 },
+            { slug: 'api/authentication/jwt-tokens', title: 'JWT Tokens', depth: 4 },
+            { slug: 'api/authentication/oauth', title: 'OAuth', depth: 4 },
+            { slug: 'api/endpoints', title: 'Endpoints', depth: 3 },
+            { slug: 'frontend', title: 'Frontend', depth: 2 },
+            { slug: 'frontend/components', title: 'Components', depth: 3 },
+            { slug: 'frontend/components/login-form', title: 'Login Form', depth: 4 }
+        ],
+        toc: [],
+        slugIndex: new Map(),
+        sections: new Map([
+            ['api/authentication/jwt-tokens', '### JWT Tokens\n\nDetailed JWT implementation with @/api/tokens.md links'],
+            ['api/authentication/oauth', '### OAuth\n\nOAuth flow documentation with @#providers section'],
+            ['frontend/components/login-form', '### Login Form\n\nReact component for authentication @/frontend/components.md#forms']
+        ])
+    })),
+    getSectionContent: vi.fn((path, slug) => {
+        const content = new Map([
+            ['api/authentication/jwt-tokens', '### JWT Tokens\n\nDetailed JWT implementation with @/api/tokens.md links'],
+            ['api/authentication/oauth', '### OAuth\n\nOAuth flow documentation with @#providers section'],
+            ['frontend/components/login-form', '### Login Form\n\nReact component for authentication @/frontend/components.md#forms']
+        ]);
+        return Promise.resolve(content.get(slug) ?? null);
+    })
+});
+const mockSessionState = {
+    sessionId: 'test-session'
+};
+describe('View-Section Tool - Hierarchical Enhancements (TDD-FIRST)', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockGetDocumentManager.mockResolvedValue(createMockDocumentManager());
+    });
+    describe('hierarchical section viewing', () => {
+        test('should view section using hierarchical path with context', async () => {
+            const args = {
+                document: '/api/auth-guide.md',
+                section: 'api/authentication/jwt-tokens'
+            };
+            const result = await viewSection(args, mockSessionState);
+            // HIERARCHICAL ENHANCEMENT: Should include hierarchical context
+            expect(result).toMatchObject({
+                document: '/api/auth-guide.md',
+                sections: [{
+                        slug: 'api/authentication/jwt-tokens',
+                        title: 'JWT Tokens',
+                        content: '### JWT Tokens\n\nDetailed JWT implementation with @/api/tokens.md links',
+                        depth: 4,
+                        full_path: 'api/authentication/jwt-tokens',
+                        parent: 'api/authentication',
+                        word_count: expect.any(Number),
+                        links: ['@/api/tokens.md'],
+                        hierarchical_context: {
+                            full_path: 'api/authentication/jwt-tokens',
+                            parent_path: 'api/authentication',
+                            section_name: 'jwt-tokens',
+                            depth: 3 // Path depth (3 levels)
+                        }
+                    }],
+                summary: {
+                    total_sections: 1,
+                    total_words: expect.any(Number),
+                    has_content: true
+                }
+            });
+        });
+        test('should view multiple hierarchical sections with context', async () => {
+            const args = {
+                document: '/api/auth-guide.md',
+                section: ['api/authentication/jwt-tokens', 'frontend/components/login-form']
+            };
+            const result = await viewSection(args, mockSessionState);
+            // HIERARCHICAL ENHANCEMENT: Multiple sections with hierarchical context
+            expect(result).toMatchObject({
+                document: '/api/auth-guide.md',
+                sections: [
+                    expect.objectContaining({
+                        slug: 'api/authentication/jwt-tokens',
+                        full_path: 'api/authentication/jwt-tokens',
+                        parent: 'api/authentication',
+                        hierarchical_context: {
+                            full_path: 'api/authentication/jwt-tokens',
+                            parent_path: 'api/authentication',
+                            section_name: 'jwt-tokens',
+                            depth: 3
+                        }
+                    }),
+                    expect.objectContaining({
+                        slug: 'frontend/components/login-form',
+                        full_path: 'frontend/components/login-form',
+                        parent: 'frontend/components',
+                        hierarchical_context: {
+                            full_path: 'frontend/components/login-form',
+                            parent_path: 'frontend/components',
+                            section_name: 'login-form',
+                            depth: 3
+                        }
+                    })
+                ],
+                summary: {
+                    total_sections: 2,
+                    total_words: expect.any(Number),
+                    has_content: true
+                }
+            });
+        });
+        test('should show flat sections without hierarchical context', async () => {
+            const args = {
+                document: '/api/auth-guide.md',
+                section: 'overview'
+            };
+            const result = await viewSection(args, mockSessionState);
+            // HIERARCHICAL ENHANCEMENT: Flat sections should not have hierarchical context
+            expect(result).toMatchObject({
+                sections: [{
+                        slug: 'overview',
+                        full_path: 'overview',
+                        hierarchical_context: null // No hierarchical context for flat sections
+                    }]
+            });
+        });
+        test('should handle deep hierarchical paths (5+ levels)', async () => {
+            // Mock a very deep hierarchical section
+            const mockManager = createMockDocumentManager();
+            mockManager.getDocument = vi.fn(() => Promise.resolve({
+                metadata: {
+                    path: '/api/auth-guide.md',
+                    title: 'Authentication Guide',
+                    lastModified: new Date(),
+                    contentHash: 'mock-hash',
+                    wordCount: 800,
+                    linkCount: 15,
+                    codeBlockCount: 8,
+                    lastAccessed: new Date()
+                },
+                headings: [
+                    { slug: 'api/authentication/oauth/providers/google/scopes', title: 'Google Scopes', depth: 6 }
+                ],
+                toc: [],
+                slugIndex: new Map(),
+                sections: new Map([
+                    ['api/authentication/oauth/providers/google/scopes', '### Google Scopes\n\nDetailed OAuth scope configuration']
+                ])
+            }));
+            mockManager.getSectionContent = vi.fn(() => Promise.resolve('### Google Scopes\n\nDetailed OAuth scope configuration'));
+            mockGetDocumentManager.mockResolvedValue(mockManager);
+            const args = {
+                document: '/api/auth-guide.md',
+                section: 'api/authentication/oauth/providers/google/scopes'
+            };
+            const result = await viewSection(args, mockSessionState);
+            // HIERARCHICAL ENHANCEMENT: Deep hierarchical context
+            expect(result).toMatchObject({
+                sections: [{
+                        slug: 'api/authentication/oauth/providers/google/scopes',
+                        full_path: 'api/authentication/oauth/providers/google/scopes',
+                        parent: 'api/authentication/oauth/providers/google',
+                        hierarchical_context: {
+                            full_path: 'api/authentication/oauth/providers/google/scopes',
+                            parent_path: 'api/authentication/oauth/providers/google',
+                            section_name: 'scopes',
+                            depth: 6 // 6 levels deep
+                        }
+                    }]
+            });
+        });
+    });
+    describe('hierarchical link analysis', () => {
+        test('should extract and analyze links in hierarchical sections', async () => {
+            const args = {
+                document: '/api/auth-guide.md',
+                section: 'api/authentication/jwt-tokens'
+            };
+            const result = await viewSection(args, mockSessionState);
+            // HIERARCHICAL ENHANCEMENT: Link analysis should work with hierarchical context
+            expect(result.sections[0]).toMatchObject({
+                links: ['@/api/tokens.md'] // Should extract @ links from content
+            });
+        });
+        test('should handle mixed link types in hierarchical sections', async () => {
+            const args = {
+                document: '/api/auth-guide.md',
+                section: ['api/authentication/oauth', 'frontend/components/login-form']
+            };
+            const result = await viewSection(args, mockSessionState);
+            // HIERARCHICAL ENHANCEMENT: Different link types should be extracted
+            expect(result.sections[0]).toMatchObject({
+                slug: 'api/authentication/oauth',
+                links: ['@#providers'] // Section link
+            });
+            expect(result.sections[1]).toMatchObject({
+                slug: 'frontend/components/login-form',
+                links: ['@/frontend/components.md#forms'] // Document + section link
+            });
+        });
+    });
+    describe('hierarchical summary statistics', () => {
+        test('should provide enhanced summary for hierarchical sections', async () => {
+            const args = {
+                document: '/api/auth-guide.md',
+                section: ['api/authentication/jwt-tokens', 'api/authentication/oauth', 'frontend/components/login-form']
+            };
+            const result = await viewSection(args, mockSessionState);
+            // HIERARCHICAL ENHANCEMENT: Summary should include hierarchical statistics
+            expect(result.summary).toMatchObject({
+                total_sections: 3,
+                total_words: expect.any(Number),
+                has_content: true,
+                hierarchical_stats: {
+                    max_depth: 3, // Deepest path depth
+                    namespaces: ['api/authentication', 'frontend/components'], // Unique namespaces
+                    flat_sections: 0, // Count of non-hierarchical sections
+                    hierarchical_sections: 3 // Count of hierarchical sections
+                }
+            });
+        });
+        test('should handle mixed flat and hierarchical sections in summary', async () => {
+            // Mock to include a flat section
+            const mockManager = createMockDocumentManager();
+            mockManager.getDocument = vi.fn(() => Promise.resolve({
+                metadata: {
+                    path: '/api/auth-guide.md',
+                    title: 'Authentication Guide',
+                    lastModified: new Date(),
+                    contentHash: 'mock-hash',
+                    wordCount: 800,
+                    linkCount: 15,
+                    codeBlockCount: 8,
+                    lastAccessed: new Date()
+                },
+                headings: [
+                    { slug: 'overview', title: 'Overview', depth: 2 },
+                    { slug: 'api/authentication/jwt-tokens', title: 'JWT Tokens', depth: 4 }
+                ],
+                toc: [],
+                slugIndex: new Map(),
+                sections: new Map([
+                    ['overview', '## Overview\n\nDocument overview'],
+                    ['api/authentication/jwt-tokens', '### JWT Tokens\n\nDetailed JWT implementation']
+                ])
+            }));
+            mockManager.getSectionContent = vi.fn((path, slug) => {
+                const content = new Map([
+                    ['overview', '## Overview\n\nDocument overview'],
+                    ['api/authentication/jwt-tokens', '### JWT Tokens\n\nDetailed JWT implementation']
+                ]);
+                return Promise.resolve(content.get(slug) ?? null);
+            });
+            mockGetDocumentManager.mockResolvedValue(mockManager);
+            const args = {
+                document: '/api/auth-guide.md',
+                section: ['overview', 'api/authentication/jwt-tokens']
+            };
+            const result = await viewSection(args, mockSessionState);
+            // HIERARCHICAL ENHANCEMENT: Mixed summary statistics
+            expect(result.summary).toMatchObject({
+                total_sections: 2,
+                hierarchical_stats: {
+                    max_depth: 3, // From 'api/authentication/jwt-tokens'
+                    namespaces: ['api/authentication'], // Only hierarchical namespace
+                    flat_sections: 1, // 'overview'
+                    hierarchical_sections: 1 // 'api/authentication/jwt-tokens'
+                }
+            });
+        });
+    });
+    describe('hierarchical error handling', () => {
+        test('should provide hierarchical context in error messages', async () => {
+            const args = {
+                document: '/api/auth-guide.md',
+                section: 'api/nonexistent/hierarchical/path'
+            };
+            await expect(viewSection(args, mockSessionState)).rejects.toThrow();
+            // Error should include hierarchical context about where the path failed
+        });
+    });
+});
+//# sourceMappingURL=view-section.hierarchical.test.js.map

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

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

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

@@ -0,0 +1,167 @@
+/**
+ * Implementation for view_section tool
+ * Provides clean section viewing without stats overhead
+ */
+import { ToolIntegration, DocumentNotFoundError, SectionNotFoundError, AddressingError, parseSectionAddress } from '../../shared/addressing-system.js';
+import { getParentSlug } from '../../shared/utilities.js';
+import { ReferenceExtractor } from '../../shared/reference-extractor.js';
+/**
+ * Execute view_section tool
+ */
+export async function viewSection(args, _state, manager) {
+    // Mode Detection: Parse document parameter to detect mode
+    const documentParam = ToolIntegration.validateStringParameter(args['document'], 'document');
+    let mode;
+    let docPath;
+    let sectionSlugs;
+    if (documentParam.includes('#')) {
+        // Detail mode: Parse document + slug(s)
+        const parts = documentParam.split('#');
+        docPath = parts[0] ?? documentParam;
+        const slugsPart = parts[1];
+        mode = 'detail';
+        if (slugsPart == null || slugsPart === '') {
+            throw new AddressingError('Section slug(s) cannot be empty after #', 'EMPTY_SECTION_SLUG');
+        }
+        // Support comma-separated slugs: #section1,section2,section3
+        sectionSlugs = slugsPart.split(',').map(s => s.trim()).filter(s => s !== '');
+        if (sectionSlugs.length === 0) {
+            throw new AddressingError('At least one section slug required in detail mode', 'NO_SECTION_SLUGS');
+        }
+        // Validate count using standardized utility
+        ToolIntegration.validateCountLimit(sectionSlugs, 10, 'sections');
+    }
+    else {
+        // Overview mode: Document only
+        docPath = documentParam;
+        sectionSlugs = undefined;
+        mode = 'overview';
+    }
+    // Use addressing system for document validation
+    const { addresses } = ToolIntegration.validateAndParse({
+        document: docPath
+    });
+    // Get document
+    const document = await manager.getDocument(addresses.document.path);
+    if (document == null) {
+        throw new DocumentNotFoundError(addresses.document.path);
+    }
+    // Handle Overview Mode: Return all sections with minimal data (no content)
+    if (mode === 'overview') {
+        // Get all sections from document headings
+        const overviewSections = document.headings.map(heading => ({
+            slug: heading.slug,
+            title: heading.title,
+            depth: heading.depth
+        }));
+        return {
+            mode: 'overview',
+            document: addresses.document.path,
+            sections: overviewSections
+        };
+    }
+    // Detail Mode: Process specified sections with full content
+    // At this point we're in detail mode, so sectionSlugs must be defined
+    if (sectionSlugs == null) {
+        throw new AddressingError('Internal error: sectionSlugs undefined in detail mode', 'INTERNAL_ERROR');
+    }
+    const sections = sectionSlugs;
+    // Parse and validate all sections using addressing system
+    // Use Promise.allSettled for non-critical view operations to handle partial failures gracefully
+    const sectionAddressResults = await Promise.allSettled(sections.map(sectionSlug => {
+        try {
+            return parseSectionAddress(sectionSlug, addresses.document.path);
+        }
+        catch (error) {
+            if (error instanceof AddressingError) {
+                throw error;
+            }
+            throw new AddressingError(`Invalid section reference: ${sectionSlug}`, 'INVALID_SECTION', { sectionSlug });
+        }
+    }));
+    // Separate successful addresses from failures for graceful handling
+    const sectionAddresses = [];
+    const failedSections = [];
+    sectionAddressResults.forEach((result, index) => {
+        if (result.status === 'fulfilled') {
+            sectionAddresses.push(result.value);
+        }
+        else {
+            const sectionSlug = sections[index];
+            if (sectionSlug != null) {
+                failedSections.push(sectionSlug);
+            }
+        }
+    });
+    // If all sections failed, throw the first error to maintain backward compatibility
+    if (sectionAddresses.length === 0 && failedSections.length > 0) {
+        const firstResult = sectionAddressResults[0];
+        if (firstResult?.status === 'rejected') {
+            throw firstResult.reason;
+        }
+    }
+    // Validate all sections exist in document
+    for (const sectionAddr of sectionAddresses) {
+        const sectionExists = document.headings.some(h => h.slug === sectionAddr.slug);
+        if (!sectionExists) {
+            throw new SectionNotFoundError(sectionAddr.slug, addresses.document.path);
+        }
+    }
+    // Process each section using Promise.allSettled for graceful partial failure handling
+    const sectionProcessingResults = await Promise.allSettled(sectionAddresses.map(async (sectionAddr) => {
+        const heading = document.headings.find(h => h.slug === sectionAddr.slug);
+        if (heading == null) {
+            throw new SectionNotFoundError(sectionAddr.slug, addresses.document.path);
+        }
+        // Get section content using the normalized slug
+        const content = await manager.getSectionContent(addresses.document.path, sectionAddr.slug) ?? '';
+        // Analyze section for links using unified ReferenceExtractor
+        const links = [];
+        const extractor = new ReferenceExtractor();
+        const references = extractor.extractReferences(content);
+        links.push(...references);
+        // Calculate word count
+        const wordCount = content.split(/\s+/).filter(word => word.length > 0).length;
+        // Build hierarchical information using standardized ToolIntegration methods
+        const parent = getParentSlug(heading.slug);
+        const sectionData = {
+            slug: heading.slug,
+            title: heading.title,
+            content,
+            depth: heading.depth,
+            word_count: wordCount,
+            links
+        };
+        if (parent != null && parent !== '') {
+            sectionData.parent = parent;
+        }
+        return sectionData;
+    }));
+    // Separate successful sections from failures
+    const processedSections = [];
+    const processingErrors = [];
+    sectionProcessingResults.forEach((result, index) => {
+        if (result.status === 'fulfilled') {
+            processedSections.push(result.value);
+        }
+        else {
+            processingErrors.push({
+                sectionSlug: sectionAddresses[index]?.slug ?? failedSections[0] ?? 'unknown',
+                error: result.reason
+            });
+        }
+    });
+    // If all sections failed to process, throw the first error for backward compatibility
+    if (processedSections.length === 0 && processingErrors.length > 0) {
+        const firstError = processingErrors[0];
+        if (firstError != null) {
+            throw firstError.error;
+        }
+    }
+    return {
+        mode: 'detail',
+        document: addresses.document.path,
+        sections: processedSections
+    };
+}
+//# sourceMappingURL=view-section.js.map

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

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

package/dist/tools/implementations/view-subagent-task.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Implementation for view_subagent_task tool
+ * Provides clean task viewing for subagent tasks in /docs/ namespace
+ * For coordinator tasks, use view_coordinator_task instead
+ */
+import type { SessionState } from '../../session/types.js';
+import type { DocumentManager } from '../../document-manager.js';
+import type { HierarchicalContent } from '../../shared/reference-loader.js';
+/**
+ * Clean response format for view_subagent_task
+ */
+interface ViewSubagentTaskResponse {
+    mode: 'overview' | 'detail';
+    document: string;
+    tasks: Array<{
+        slug: string;
+        title: string;
+        content?: string;
+        depth: number;
+        full_path: string;
+        parent?: string;
+        status: string;
+        linked_document?: string;
+        referenced_documents?: HierarchicalContent[];
+        word_count?: number;
+        workflow_name?: string;
+        main_workflow_name?: string;
+        has_workflow: boolean;
+    }>;
+    summary: {
+        total_tasks: number;
+        by_status: Record<string, number>;
+        with_links: number;
+        with_references: number;
+        tasks_with_workflows: number;
+        tasks_with_main_workflow: number;
+    };
+}
+/**
+ * Execute view_subagent_task tool
+ * Works with subagent tasks in /docs/ namespace only
+ * For coordinator tasks, use view_coordinator_task instead
+ */
+export declare function viewSubagentTask(args: Record<string, unknown>, _state: SessionState, manager: DocumentManager): Promise<ViewSubagentTaskResponse>;
+export {};
+//# sourceMappingURL=view-subagent-task.d.ts.map

package/dist/tools/implementations/view-subagent-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-subagent-task.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/view-subagent-task.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAejE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAG5E;;GAEG;AACH,UAAU,wBAAwB;IAChC,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;QAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC,CAAC;IACH,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,wBAAwB,EAAE,MAAM,CAAC;KAClC,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,wBAAwB,CAAC,CAoVnC"}