ai-prompt-guide-mcp 1.0.0

package/dist/shared/__tests__/addressing-system.lru.test.js

@@ -0,0 +1,159 @@
+/**
+ * Tests for LRU cache implementation in addressing system
+ * These tests verify that the cache correctly maintains access order and evicts least recently used items
+ */
+import { describe, test, expect, beforeEach } from 'vitest';
+import { parseDocumentAddress, parseSectionAddress } from '../addressing-system.js';
+describe('AddressCache LRU Implementation', () => {
+    beforeEach(() => {
+        // Clear the internal cache before each test by importing fresh module
+        // Note: This is a somewhat indirect test since AddressCache is internal
+    });
+    test('should maintain access order for document cache', async () => {
+        // Create multiple document addresses to test LRU behavior
+        const docs = Array.from({ length: 5 }, (_, i) => `/test/doc${i}.md`);
+        // Parse all documents to populate cache
+        docs.forEach(doc => parseDocumentAddress(doc));
+        // Access first document multiple times to verify it stays "fresh"
+        const firstDoc = docs[0];
+        if (firstDoc != null) {
+            parseDocumentAddress(firstDoc);
+            parseDocumentAddress(firstDoc);
+        }
+        // Access middle document to verify LRU touching
+        const middleDoc = docs[2];
+        if (middleDoc != null) {
+            parseDocumentAddress(middleDoc);
+        }
+        // All documents should be accessible without issues
+        for (const doc of docs) {
+            const addr = parseDocumentAddress(doc);
+            expect(addr.path).toBe(doc);
+        }
+    });
+    test('should maintain access order for section cache', async () => {
+        const contextDoc = '/test/context.md';
+        const sections = ['section1', 'section2', 'section3', 'section4', 'section5'];
+        // Parse all sections to populate cache
+        await Promise.all(sections.map(section => parseSectionAddress(section, contextDoc)));
+        // Access first section multiple times
+        const firstSection = sections[0];
+        if (firstSection != null) {
+            parseSectionAddress(firstSection, contextDoc);
+            parseSectionAddress(firstSection, contextDoc);
+        }
+        // Access middle section
+        const middleSection = sections[2];
+        if (middleSection != null) {
+            parseSectionAddress(middleSection, contextDoc);
+        }
+        // All sections should be accessible
+        for (const section of sections) {
+            const addr = parseSectionAddress(section, contextDoc);
+            expect(addr.slug).toBe(section);
+        }
+    });
+    test('should handle cache eviction properly when size limit reached', async () => {
+        // This test verifies that the cache doesn't grow beyond limits
+        // and that the eviction mechanism works
+        // Create enough documents to potentially trigger eviction
+        // Note: The actual maxSize is 1000, so we need to be strategic about testing
+        const testDocs = Array.from({ length: 10 }, (_, i) => `/cache-test/doc${i}.md`);
+        // Parse all documents
+        testDocs.forEach(doc => parseDocumentAddress(doc));
+        // Verify all are accessible
+        for (const doc of testDocs) {
+            const addr = parseDocumentAddress(doc);
+            expect(addr.path).toBe(doc);
+            expect(addr.cacheKey).toBe(doc);
+        }
+        // Access some documents to change their LRU order
+        const doc0 = testDocs[0];
+        const doc5 = testDocs[5];
+        const doc9 = testDocs[9];
+        if (doc0 != null)
+            parseDocumentAddress(doc0);
+        if (doc5 != null)
+            parseDocumentAddress(doc5);
+        if (doc9 != null)
+            parseDocumentAddress(doc9);
+        // All should still be accessible since we're well under the limit
+        for (const doc of testDocs) {
+            const addr = parseDocumentAddress(doc);
+            expect(addr).toBeDefined();
+        }
+    });
+    test('should not evict when updating existing entries', () => {
+        const doc = '/test/existing.md';
+        // Parse document initially
+        const addr1 = parseDocumentAddress(doc);
+        // Parse same document again - should not trigger eviction logic
+        const addr2 = parseDocumentAddress(doc);
+        // Should return the same cached result
+        expect(addr1.path).toBe(addr2.path);
+        expect(addr1.cacheKey).toBe(addr2.cacheKey);
+    });
+    test('should handle hierarchical section caching correctly', async () => {
+        const contextDoc = '/test/hierarchical.md';
+        const hierarchicalSections = [
+            'api/authentication',
+            'api/authentication/jwt',
+            'api/endpoints/users',
+            'specs/components',
+            'specs/components/forms'
+        ];
+        // Parse all hierarchical sections
+        for (const section of hierarchicalSections) {
+            parseSectionAddress(section, contextDoc);
+        }
+        // Access some sections to test LRU behavior
+        const firstHierSection = hierarchicalSections[0];
+        const thirdHierSection = hierarchicalSections[2];
+        if (firstHierSection != null)
+            parseSectionAddress(firstHierSection, contextDoc);
+        if (thirdHierSection != null)
+            parseSectionAddress(thirdHierSection, contextDoc);
+        // Verify all are still accessible and properly formatted
+        for (const section of hierarchicalSections) {
+            const addr = parseSectionAddress(section, contextDoc);
+            expect(addr.slug).toBe(section);
+            expect(addr.fullPath).toBe(`${contextDoc}#${section}`);
+        }
+    });
+    test('should handle mixed flat and hierarchical section caching', async () => {
+        const contextDoc = '/test/mixed.md';
+        const mixedSections = [
+            'overview', // flat
+            'api/authentication', // hierarchical
+            'getting-started', // flat
+            'api/endpoints/users', // hierarchical
+            'troubleshooting' // flat
+        ];
+        // Parse all sections
+        for (const section of mixedSections) {
+            parseSectionAddress(section, contextDoc);
+        }
+        // Access in different order to test LRU
+        const troubleshootingSection = mixedSections[4]; // troubleshooting
+        const authSection = mixedSections[1]; // api/authentication
+        const overviewSection = mixedSections[0]; // overview
+        if (troubleshootingSection != null)
+            parseSectionAddress(troubleshootingSection, contextDoc);
+        if (authSection != null)
+            parseSectionAddress(authSection, contextDoc);
+        if (overviewSection != null)
+            parseSectionAddress(overviewSection, contextDoc);
+        // Verify all are accessible with correct formatting
+        for (const section of mixedSections) {
+            const addr = parseSectionAddress(section, contextDoc);
+            expect(addr.slug).toBe(section);
+            if (section.includes('/')) {
+                expect(addr.fullPath).toBe(`${contextDoc}#${section}`);
+            }
+            else {
+                expect(addr.fullPath).toBe(`${contextDoc}#${section}`);
+            }
+        }
+    });
+});
+//# sourceMappingURL=addressing-system.lru.test.js.map

package/dist/shared/__tests__/addressing-system.lru.test.js.map

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

package/dist/shared/__tests__/addressing-system.relative-paths.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tests for relative path handling in addressing system
+ *
+ * This test suite verifies that the addressing system correctly handles
+ * the new relative path structure where user-facing paths are relative
+ * to their base folders (docs/ or coordinator/).
+ *
+ * Path Structure:
+ * - Old: /docs/api/auth.md (with base folder prefix)
+ * - New: /api/auth.md (relative to docs/)
+ * - Physical: .ai-prompt-guide/docs/api/auth.md (unchanged)
+ */
+export {};
+//# sourceMappingURL=addressing-system.relative-paths.test.d.ts.map

package/dist/shared/__tests__/addressing-system.relative-paths.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressing-system.relative-paths.test.d.ts","sourceRoot":"","sources":["../../../src/shared/__tests__/addressing-system.relative-paths.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/shared/__tests__/addressing-system.relative-paths.test.js

@@ -0,0 +1,249 @@
+/**
+ * Tests for relative path handling in addressing system
+ *
+ * This test suite verifies that the addressing system correctly handles
+ * the new relative path structure where user-facing paths are relative
+ * to their base folders (docs/ or coordinator/).
+ *
+ * Path Structure:
+ * - Old: /docs/api/auth.md (with base folder prefix)
+ * - New: /api/auth.md (relative to docs/)
+ * - Physical: .ai-prompt-guide/docs/api/auth.md (unchanged)
+ */
+import { describe, test, expect, beforeEach } from 'vitest';
+import { parseDocumentAddress, parseSectionAddress, parseTaskAddress, ToolIntegration, InvalidAddressError, getGlobalAddressCache } from '../addressing-system.js';
+describe('AddressingSystem - Relative Path Handling', () => {
+    beforeEach(() => {
+        // Clear batch cache before each test
+        const cache = getGlobalAddressCache();
+        cache.clearBatch();
+    });
+    describe('Document path parsing - relative paths', () => {
+        test('should parse relative document path without /docs/ prefix', () => {
+            const address = parseDocumentAddress('/api/auth.md');
+            expect(address.path).toBe('/api/auth.md');
+            expect(address.slug).toBe('auth');
+            expect(address.namespace).toBe('api');
+            expect(address.normalizedPath).toBe('/api/auth.md');
+        });
+        test('should parse relative coordinator path without /coordinator/ prefix', () => {
+            const address = parseDocumentAddress('/active.md');
+            expect(address.path).toBe('/active.md');
+            expect(address.slug).toBe('active');
+            expect(address.namespace).toBe('root');
+            expect(address.normalizedPath).toBe('/active.md');
+        });
+        test('should parse root-level document path', () => {
+            const address = parseDocumentAddress('/readme.md');
+            expect(address.path).toBe('/readme.md');
+            expect(address.slug).toBe('readme');
+            expect(address.namespace).toBe('root');
+        });
+        test('should parse nested namespace path', () => {
+            const address = parseDocumentAddress('/api/specs/auth.md');
+            expect(address.path).toBe('/api/specs/auth.md');
+            expect(address.slug).toBe('auth');
+            expect(address.namespace).toBe('api/specs');
+        });
+        test('should reject old-style paths with /docs/ prefix', () => {
+            // The system should now treat /docs/ as a namespace, not a special prefix
+            const address = parseDocumentAddress('/docs/api/auth.md');
+            // Should parse successfully but treat 'docs/api' as the namespace
+            expect(address.path).toBe('/docs/api/auth.md');
+            expect(address.namespace).toBe('docs/api'); // NOT 'api'
+        });
+        test('should reject old-style paths with /coordinator/ prefix', () => {
+            // Similar to above - /coordinator/ becomes part of namespace
+            const address = parseDocumentAddress('/coordinator/active.md');
+            expect(address.path).toBe('/coordinator/active.md');
+            expect(address.namespace).toBe('coordinator'); // NOT 'root'
+        });
+        test('should handle archive paths with explicit prefix', () => {
+            // Archive paths keep explicit /archived/ prefix per requirements
+            const address = parseDocumentAddress('/archived/docs/api/auth.md');
+            expect(address.path).toBe('/archived/docs/api/auth.md');
+            expect(address.namespace).toBe('archived/docs/api');
+        });
+    });
+    describe('Section path parsing - relative paths', () => {
+        test('should parse section with relative document path', () => {
+            const section = parseSectionAddress('tokens', '/api/auth.md');
+            expect(section.slug).toBe('tokens');
+            expect(section.document.path).toBe('/api/auth.md');
+            expect(section.fullPath).toBe('/api/auth.md#tokens');
+        });
+        test('should parse section with # prefix and relative document', () => {
+            const section = parseSectionAddress('#tokens', '/api/auth.md');
+            expect(section.slug).toBe('tokens');
+            expect(section.document.path).toBe('/api/auth.md');
+            expect(section.fullPath).toBe('/api/auth.md#tokens');
+        });
+        test('should parse full section path with relative document', () => {
+            const section = parseSectionAddress('/api/auth.md#tokens');
+            expect(section.slug).toBe('tokens');
+            expect(section.document.path).toBe('/api/auth.md');
+            expect(section.fullPath).toBe('/api/auth.md#tokens');
+        });
+        test('should parse hierarchical section with relative path', () => {
+            const section = parseSectionAddress('authentication/jwt-tokens', '/api/auth.md');
+            expect(section.slug).toBe('authentication/jwt-tokens');
+            expect(section.document.path).toBe('/api/auth.md');
+            expect(section.fullPath).toBe('/api/auth.md#authentication/jwt-tokens');
+        });
+        test('should parse coordinator section with relative path', () => {
+            const section = parseSectionAddress('phase-1', '/active.md');
+            expect(section.slug).toBe('phase-1');
+            expect(section.document.path).toBe('/active.md');
+            expect(section.fullPath).toBe('/active.md#phase-1');
+        });
+    });
+    describe('Task path parsing - relative paths', () => {
+        test('should parse task with relative document path', () => {
+            const task = parseTaskAddress('implement-auth', '/project/tasks.md');
+            expect(task.slug).toBe('implement-auth');
+            expect(task.document.path).toBe('/project/tasks.md');
+            expect(task.fullPath).toBe('/project/tasks.md#implement-auth');
+            expect(task.isTask).toBe(true);
+        });
+        test('should parse coordinator task with relative path', () => {
+            const task = parseTaskAddress('initialize-project', '/active.md');
+            expect(task.slug).toBe('initialize-project');
+            expect(task.document.path).toBe('/active.md');
+            expect(task.fullPath).toBe('/active.md#initialize-project');
+            expect(task.isTask).toBe(true);
+        });
+        test('should parse task with # prefix', () => {
+            const task = parseTaskAddress('#setup-database', '/project/tasks.md');
+            expect(task.slug).toBe('setup-database');
+            expect(task.document.path).toBe('/project/tasks.md');
+        });
+    });
+    describe('ToolIntegration with relative paths', () => {
+        test('should validate and parse relative document path', () => {
+            const { addresses } = ToolIntegration.validateAndParse({
+                document: '/api/auth.md'
+            });
+            expect(addresses.document.path).toBe('/api/auth.md');
+            expect(addresses.document.namespace).toBe('api');
+        });
+        test('should validate and parse relative path with section', () => {
+            const { addresses } = ToolIntegration.validateAndParse({
+                document: '/api/auth.md',
+                section: 'tokens'
+            });
+            expect(addresses.document.path).toBe('/api/auth.md');
+            expect(addresses.section?.slug).toBe('tokens');
+            expect(addresses.section?.fullPath).toBe('/api/auth.md#tokens');
+        });
+        test('should validate coordinator path correctly', () => {
+            const { addresses } = ToolIntegration.validateAndParse({
+                document: '/active.md',
+                section: 'phase-1'
+            });
+            expect(addresses.document.path).toBe('/active.md');
+            expect(addresses.document.namespace).toBe('root');
+            expect(addresses.section?.fullPath).toBe('/active.md#phase-1');
+        });
+        test('should format document info with relative path', () => {
+            const { addresses } = ToolIntegration.validateAndParse({
+                document: '/api/auth.md'
+            });
+            const info = ToolIntegration.formatDocumentInfo(addresses.document, {
+                title: 'Authentication Guide'
+            });
+            expect(info.title).toBe('Authentication Guide');
+        });
+        test('should format section path with relative document', () => {
+            const { addresses } = ToolIntegration.validateAndParse({
+                document: '/api/auth.md',
+                section: 'tokens'
+            });
+            expect(addresses.section).toBeDefined();
+            if (addresses.section != null) {
+                const path = ToolIntegration.formatSectionPath(addresses.section);
+                expect(path).toBe('/api/auth.md#tokens');
+            }
+        });
+        test('should format hierarchical section path correctly', () => {
+            const { addresses } = ToolIntegration.validateAndParse({
+                document: '/api/auth.md',
+                section: 'authentication/jwt-tokens'
+            });
+            expect(addresses.section).toBeDefined();
+            if (addresses.section != null) {
+                const path = ToolIntegration.formatSectionPath(addresses.section);
+                expect(path).toBe('/api/auth.md#authentication/jwt-tokens (hierarchical)');
+            }
+        });
+    });
+    describe('Backward compatibility checks', () => {
+        test('should handle paths without leading slash by adding it', () => {
+            // Current behavior: adds leading slash if missing
+            const address = parseDocumentAddress('api/auth.md');
+            expect(address.path).toBe('/api/auth.md');
+            expect(address.namespace).toBe('api');
+        });
+        test('should still require .md extension', () => {
+            expect(() => parseDocumentAddress('/api/auth')).toThrow(InvalidAddressError);
+            expect(() => parseDocumentAddress('/api/auth.txt')).toThrow(InvalidAddressError);
+        });
+        test('should reject empty paths', () => {
+            expect(() => parseDocumentAddress('')).toThrow(InvalidAddressError);
+            expect(() => parseDocumentAddress('   ')).toThrow(InvalidAddressError);
+        });
+        test('should cache relative paths correctly', () => {
+            const cache = getGlobalAddressCache();
+            const addr1 = parseDocumentAddress('/api/auth.md');
+            const stats1 = cache.getBatchStats();
+            expect(stats1.size).toBe(1);
+            const addr2 = parseDocumentAddress('/api/auth.md');
+            expect(addr1.path).toBe(addr2.path);
+            const stats2 = cache.getBatchStats();
+            expect(stats2.size).toBe(1); // Still 1, cached
+        });
+    });
+    describe('Edge cases with relative paths', () => {
+        test('should handle deeply nested namespaces', () => {
+            const address = parseDocumentAddress('/api/v2/specs/auth/oauth.md');
+            expect(address.path).toBe('/api/v2/specs/auth/oauth.md');
+            expect(address.slug).toBe('oauth');
+            expect(address.namespace).toBe('api/v2/specs/auth');
+        });
+        test('should handle single-level document', () => {
+            const address = parseDocumentAddress('/guide.md');
+            expect(address.path).toBe('/guide.md');
+            expect(address.slug).toBe('guide');
+            expect(address.namespace).toBe('root');
+        });
+        test('should normalize consecutive slashes', () => {
+            // Current implementation may not handle this - test to verify
+            const address = parseDocumentAddress('/api//auth.md');
+            // Should either normalize or accept as-is
+            expect(address.path).toMatch(/\/api\/?\/auth\.md/);
+        });
+        test('should handle special characters in namespace', () => {
+            const address = parseDocumentAddress('/api-v2/auth_guide.md');
+            expect(address.path).toBe('/api-v2/auth_guide.md');
+            expect(address.slug).toBe('auth_guide');
+            expect(address.namespace).toBe('api-v2');
+        });
+    });
+    describe('Archive path handling', () => {
+        test('should preserve /archived/ prefix in paths', () => {
+            const address = parseDocumentAddress('/archived/docs/api/auth.md');
+            expect(address.path).toBe('/archived/docs/api/auth.md');
+            expect(address.namespace).toBe('archived/docs/api');
+        });
+        test('should handle archived coordinator paths', () => {
+            const address = parseDocumentAddress('/archived/coordinator/active.md');
+            expect(address.path).toBe('/archived/coordinator/active.md');
+            expect(address.namespace).toBe('archived/coordinator');
+        });
+        test('should parse sections in archived documents', () => {
+            const section = parseSectionAddress('tokens', '/archived/docs/api/auth.md');
+            expect(section.document.path).toBe('/archived/docs/api/auth.md');
+            expect(section.fullPath).toBe('/archived/docs/api/auth.md#tokens');
+        });
+    });
+});
+//# sourceMappingURL=addressing-system.relative-paths.test.js.map

package/dist/shared/__tests__/addressing-system.relative-paths.test.js.map

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

package/dist/shared/__tests__/document-analysis-enhanced.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Enhanced document analysis integration tests
+ *
+ * Tests the complete document analysis system with Stage 1-4 enhancements
+ * including structured broken references, enhanced keyword extraction,
+ * and fingerprint-based optimization.
+ */
+export {};
+//# sourceMappingURL=document-analysis-enhanced.test.d.ts.map

package/dist/shared/__tests__/document-analysis-enhanced.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-analysis-enhanced.test.d.ts","sourceRoot":"","sources":["../../../src/shared/__tests__/document-analysis-enhanced.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}