ai-prompt-guide-mcp 1.0.0

package/dist/shared/link-validation.js

@@ -0,0 +1,340 @@
+/**
+ * Comprehensive link validation utilities for the Document Linking System
+ */
+import { parseLink, validateLink } from './link-utils.js';
+import { pathToNamespace } from './utilities.js';
+import { ReferenceExtractor } from './reference-extractor.js';
+import { DocumentNotFoundError } from './addressing-system.js';
+/**
+ * Validate a single link with detailed analysis
+ */
+export async function validateSingleLink(linkText, currentDocumentPath, manager) {
+    const result = {
+        link_text: linkText,
+        is_valid: false,
+        link_type: 'malformed'
+    };
+    try {
+        // Parse the link to understand its structure
+        const parsed = parseLink(linkText, currentDocumentPath);
+        result.link_type = parsed.type;
+        if (parsed.type === 'external') {
+            result.is_valid = true;
+            return result;
+        }
+        // Validate internal links
+        const validation = await validateLink(linkText, manager);
+        result.is_valid = validation.valid;
+        if (validation.valid) {
+            // Extract target information for valid links
+            if (parsed.type === 'cross-doc' && parsed.document != null && parsed.document !== '') {
+                result.target_document = parsed.document;
+                if (parsed.section != null && parsed.section !== '') {
+                    result.target_section = parsed.section;
+                }
+            }
+            else if (parsed.type === 'within-doc' && parsed.section != null && parsed.section !== '') {
+                result.target_document = currentDocumentPath;
+                result.target_section = parsed.section;
+            }
+        }
+        else {
+            result.validation_error = validation.error ?? 'Validation failed';
+            result.suggestions = await generateLinkSuggestions(linkText, validation, manager);
+        }
+    }
+    catch (error) {
+        result.validation_error = error instanceof Error ? error.message : String(error);
+        result.suggestions = ['Check link syntax: use @/path/doc.md or @#section format'];
+    }
+    return result;
+}
+/**
+ * Validate all links in a document and generate a comprehensive report
+ */
+export async function validateDocumentLinks(documentPath, manager) {
+    const document = await manager.getDocument(documentPath);
+    if (document == null) {
+        throw new DocumentNotFoundError(documentPath);
+    }
+    const report = {
+        document_path: documentPath,
+        document_title: document.metadata.title,
+        namespace: pathToNamespace(documentPath),
+        total_links: 0,
+        valid_links: 0,
+        broken_links: 0,
+        external_links: 0,
+        links: [],
+        sections_with_broken_links: [],
+        health_score: 0,
+        recommendations: []
+    };
+    // Extract all links from all sections using unified ReferenceExtractor
+    const allLinks = [];
+    const extractor = new ReferenceExtractor();
+    for (const heading of document.headings) {
+        try {
+            const sectionContent = await manager.getSectionContent(documentPath, heading.slug) ?? '';
+            const references = extractor.extractReferences(sectionContent);
+            for (const ref of references) {
+                allLinks.push({
+                    linkText: ref,
+                    sectionSlug: heading.slug
+                });
+            }
+        }
+        catch {
+            // Skip sections that can't be read
+        }
+    }
+    report.total_links = allLinks.length;
+    // Validate each link
+    const sectionsBrokenLinks = new Set();
+    for (const { linkText, sectionSlug } of allLinks) {
+        const linkResult = await validateSingleLink(linkText, documentPath, manager);
+        report.links.push(linkResult);
+        if (linkResult.link_type === 'external') {
+            report.external_links++;
+            report.valid_links++; // Assume external links are valid
+        }
+        else if (linkResult.is_valid) {
+            report.valid_links++;
+        }
+        else {
+            report.broken_links++;
+            sectionsBrokenLinks.add(sectionSlug);
+        }
+    }
+    report.sections_with_broken_links = Array.from(sectionsBrokenLinks);
+    // Calculate health score (percentage of valid links)
+    if (report.total_links > 0) {
+        report.health_score = Math.round((report.valid_links / report.total_links) * 100);
+    }
+    else {
+        report.health_score = 100; // No links means perfect health
+    }
+    // Generate recommendations
+    report.recommendations = generateDocumentRecommendations(report);
+    return report;
+}
+/**
+ * Validate links across multiple documents or entire system
+ */
+export async function validateSystemLinks(manager, pathFilter) {
+    // Get all documents to validate
+    let documentsToCheck;
+    try {
+        const { documents: allDocuments } = await manager.listDocuments();
+        documentsToCheck = pathFilter != null && pathFilter !== ''
+            ? allDocuments.filter(doc => doc.path.startsWith(pathFilter))
+            : allDocuments;
+    }
+    catch (error) {
+        const { AddressingError } = await import('./addressing-system.js');
+        throw new AddressingError(`Failed to get document list: ${error instanceof Error ? error.message : String(error)}`, 'DOCUMENT_LIST_FAILED');
+    }
+    const documentReports = [];
+    const commonIssues = new Map();
+    // Validate each document
+    for (const docInfo of documentsToCheck) {
+        try {
+            const report = await validateDocumentLinks(docInfo.path, manager);
+            documentReports.push(report);
+            // Collect common issues
+            for (const link of report.links) {
+                if (!link.is_valid && link.validation_error != null && link.validation_error !== '') {
+                    const issueType = categorizeValidationError(link.validation_error);
+                    if (!commonIssues.has(issueType)) {
+                        commonIssues.set(issueType, []);
+                    }
+                    commonIssues.get(issueType)?.push(link.link_text);
+                }
+            }
+        }
+        catch (error) {
+            // Skip documents that can't be validated
+            console.warn(`Failed to validate links in ${docInfo.path}:`, error);
+        }
+    }
+    // Calculate system-wide statistics
+    const totalLinks = documentReports.reduce((sum, report) => sum + report.total_links, 0);
+    const totalValidLinks = documentReports.reduce((sum, report) => sum + report.valid_links, 0);
+    const overallHealthScore = totalLinks > 0 ? Math.round((totalValidLinks / totalLinks) * 100) : 100;
+    // Find documents with issues
+    const documentsWithIssues = documentReports.filter(report => report.broken_links > 0);
+    // Find most broken documents
+    const mostBrokenDocuments = documentReports
+        .filter(report => report.broken_links > 0)
+        .sort((a, b) => b.broken_links - a.broken_links)
+        .slice(0, 5)
+        .map(report => ({
+        path: report.document_path,
+        title: report.document_title,
+        broken_count: report.broken_links
+    }));
+    // Process common issues
+    const commonIssuesArray = Array.from(commonIssues.entries())
+        .map(([issueType, examples]) => ({
+        issue_type: issueType,
+        count: examples.length,
+        examples: examples.slice(0, 3) // Show top 3 examples
+    }))
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 5); // Top 5 issue types
+    return {
+        total_documents: documentReports.length,
+        total_links: totalLinks,
+        overall_health_score: overallHealthScore,
+        documents_with_issues: documentsWithIssues.length,
+        most_broken_documents: mostBrokenDocuments,
+        common_issues: commonIssuesArray,
+        document_reports: documentReports
+    };
+}
+/**
+ * Find and fix common link issues automatically
+ */
+export async function autoFixLinks(documentPath, manager, dryRun = true) {
+    const suggestedFixes = [];
+    const document = await manager.getDocument(documentPath);
+    if (document == null) {
+        throw new DocumentNotFoundError(documentPath);
+    }
+    // Analyze each section for fixable issues using unified ReferenceExtractor
+    const extractor = new ReferenceExtractor();
+    for (const heading of document.headings) {
+        try {
+            const sectionContent = await manager.getSectionContent(documentPath, heading.slug) ?? '';
+            const references = extractor.extractReferences(sectionContent);
+            for (const ref of references) {
+                const validation = await validateSingleLink(ref, documentPath, manager);
+                if (!validation.is_valid && validation.suggestions) {
+                    for (const suggestion of validation.suggestions) {
+                        if (suggestion.startsWith('Try:')) {
+                            const suggestedFix = suggestion.replace('Try:', '').trim();
+                            suggestedFixes.push({
+                                original_link: ref,
+                                suggested_fix: suggestedFix,
+                                reason: validation.validation_error ?? 'Link validation failed',
+                                section: heading.slug
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Skip sections that can't be processed
+        }
+    }
+    // Apply fixes if not in dry run mode
+    const fixesApplied = 0;
+    if (!dryRun && suggestedFixes.length > 0) {
+        // TODO: Implement actual content replacement
+        // This would require careful content replacement logic
+        // For now, we'll just count potential fixes
+    }
+    return {
+        fixes_found: suggestedFixes.length,
+        fixes_applied: fixesApplied,
+        suggested_fixes: suggestedFixes
+    };
+}
+/**
+ * Generate suggestions for fixing a broken link
+ */
+async function generateLinkSuggestions(linkText, validation, manager) {
+    const suggestions = [];
+    if (validation.error?.includes('Document not found') === true) {
+        // Try to find similar document paths
+        try {
+            const { documents: allDocuments } = await manager.listDocuments();
+            const cleanedLinkText = linkText.replace('@', '').replace(/^\//, '');
+            const similarDocs = allDocuments.filter(doc => doc.path.toLowerCase().includes(cleanedLinkText.toLowerCase()) ||
+                cleanedLinkText.toLowerCase().includes(doc.path.toLowerCase()));
+            if (similarDocs.length > 0) {
+                const firstDoc = similarDocs[0];
+                if (firstDoc) {
+                    suggestions.push(`Try: @${firstDoc.path}`);
+                    if (similarDocs.length > 1) {
+                        suggestions.push(`Other options: ${similarDocs.slice(1, 3).map(d => `@${d.path}`).join(', ')}`);
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore search errors
+        }
+        suggestions.push('Check the document path and ensure the file exists');
+        suggestions.push('Use absolute paths starting with / (e.g., @/api/specs/doc.md)');
+    }
+    if (validation.error?.includes('Section not found') === true) {
+        suggestions.push('Check the section slug spelling and format');
+        suggestions.push('Section slugs use lowercase with hyphens (e.g., #user-authentication)');
+        if (validation.documentExists === true && linkText.includes('#')) {
+            const docPath = linkText.split('#')[0]?.replace('@', '') ?? '';
+            try {
+                const doc = await manager.getDocument(docPath);
+                if (doc?.headings && doc.headings.length > 0) {
+                    const availableSections = doc.headings.slice(0, 3).map(h => `#${h.slug}`);
+                    suggestions.push(`Available sections: ${availableSections.join(', ')}`);
+                }
+            }
+            catch {
+                // Ignore document loading errors
+            }
+        }
+    }
+    if (suggestions.length === 0) {
+        suggestions.push('Verify link syntax: @/path/doc.md for documents, @#section for within-document');
+    }
+    return suggestions;
+}
+/**
+ * Generate recommendations for improving document link health
+ */
+function generateDocumentRecommendations(report) {
+    const recommendations = [];
+    if (report.health_score < 50) {
+        recommendations.push('🚨 Critical: Many broken links detected. Review and fix immediately.');
+    }
+    else if (report.health_score < 80) {
+        recommendations.push('⚠️ Warning: Some broken links found. Consider fixing for better navigation.');
+    }
+    else if (report.health_score === 100 && report.total_links > 0) {
+        recommendations.push('✅ Excellent: All links are valid and working properly.');
+    }
+    if (report.total_links === 0) {
+        recommendations.push('💡 Consider adding links to related documents for better connectivity.');
+    }
+    else if (report.total_links < 3) {
+        recommendations.push('💡 Consider adding more links to improve document interconnectedness.');
+    }
+    if (report.sections_with_broken_links.length > 0) {
+        recommendations.push(`🔧 Focus on fixing links in: ${report.sections_with_broken_links.slice(0, 3).join(', ')}`);
+    }
+    if (report.external_links > report.total_links * 0.5) {
+        recommendations.push('💡 High external link ratio. Consider linking to more internal documentation.');
+    }
+    return recommendations;
+}
+/**
+ * Categorize validation errors for common issue analysis
+ */
+function categorizeValidationError(error) {
+    if (error.includes('Document not found')) {
+        return 'Missing Document';
+    }
+    if (error.includes('Section not found')) {
+        return 'Missing Section';
+    }
+    if (error.includes('Invalid syntax') || error.includes('malformed')) {
+        return 'Syntax Error';
+    }
+    if (error.includes('permission') || error.includes('access')) {
+        return 'Access Error';
+    }
+    return 'Other Error';
+}
+//# sourceMappingURL=link-validation.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Namespace pattern analysis functionality
+ */
+import type { DocumentManager } from '../document-manager.js';
+import type { NamespacePatterns } from '../tools/schemas/create-document-schemas.js';
+/**
+ * Analyze namespace patterns for common sections and links
+ */
+export declare function analyzeNamespacePatterns(manager: DocumentManager, namespace: string): Promise<NamespacePatterns>;
+//# sourceMappingURL=namespace-analysis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-analysis.d.ts","sourceRoot":"","sources":["../../src/shared/namespace-analysis.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAGrF;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAsD5B"}

package/dist/shared/namespace-analysis.js

@@ -0,0 +1,100 @@
+/**
+ * Namespace pattern analysis functionality
+ */
+import { pathToNamespace } from './path-utilities.js';
+/**
+ * Analyze namespace patterns for common sections and links
+ */
+export async function analyzeNamespacePatterns(manager, namespace) {
+    try {
+        // Get all documents in the namespace
+        const { documents: allDocuments } = await manager.listDocuments();
+        const namespaceDocuments = allDocuments.filter(docInfo => pathToNamespace(docInfo.path) === namespace);
+        const sectionCounts = new Map();
+        const linkCounts = new Map();
+        const taskCounts = new Map();
+        // Analyze each document
+        for (const docInfo of namespaceDocuments) {
+            const document = await manager.getDocument(docInfo.path);
+            if (document == null)
+                continue;
+            // Count sections
+            for (const heading of document.headings) {
+                const sectionName = `#${heading.slug}`;
+                sectionCounts.set(sectionName, (sectionCounts.get(sectionName) ?? 0) + 1);
+            }
+            // For content analysis, we need to read the actual content
+            const content = await manager.getSectionContent(docInfo.path, '') ?? '';
+            // Extract links and tasks from content
+            const links = extractLinks(content);
+            const tasks = extractTasks(content);
+            for (const link of links) {
+                linkCounts.set(link, (linkCounts.get(link) ?? 0) + 1);
+            }
+            for (const task of tasks) {
+                taskCounts.set(task, (taskCounts.get(task) ?? 0) + 1);
+            }
+        }
+        // Get most common patterns (appearing in >30% of documents)
+        const threshold = Math.max(1, Math.floor(namespaceDocuments.length * 0.3));
+        return {
+            common_sections: getTopPatterns(sectionCounts, threshold, 8),
+            frequent_links: getTopPatterns(linkCounts, threshold, 5),
+            typical_tasks: getTopPatterns(taskCounts, threshold, 6)
+        };
+    }
+    catch (error) {
+        console.warn('Error analyzing namespace patterns:', error);
+        return {
+            common_sections: [],
+            frequent_links: [],
+            typical_tasks: []
+        };
+    }
+}
+/**
+ * Extract links from markdown content
+ */
+function extractLinks(content) {
+    const linkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
+    const links = [];
+    let match;
+    match = linkRegex.exec(content);
+    while (match !== null) {
+        const url = match[2];
+        // eslint-disable-next-line @typescript-eslint/prefer-optional-chain
+        if (url != null && url.startsWith('/')) { // Internal links only
+            links.push(url);
+        }
+        match = linkRegex.exec(content);
+    }
+    return links;
+}
+/**
+ * Extract tasks from markdown content
+ */
+function extractTasks(content) {
+    const taskRegex = /- \[ \] (.+)/g;
+    const tasks = [];
+    let match;
+    match = taskRegex.exec(content);
+    while (match !== null) {
+        const task = match[1];
+        if (task != null) {
+            tasks.push(task);
+        }
+        match = taskRegex.exec(content);
+    }
+    return tasks;
+}
+/**
+ * Get top patterns from count map
+ */
+function getTopPatterns(countMap, threshold, limit) {
+    return Array.from(countMap.entries())
+        .filter(([, count]) => count >= threshold)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, limit)
+        .map(([pattern]) => pattern);
+}
+//# sourceMappingURL=namespace-analysis.js.map

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

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

package/dist/shared/namespace-constants.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Namespace constants for document and coordinator separation
+ *
+ * IMPORTANT: PATH_PREFIXES are for INTERNAL file operations only.
+ * User-facing paths should be RELATIVE to their base folders:
+ * - Regular docs: /api/auth.md (relative to docs/) → .ai-prompt-guide/docs/api/auth.md
+ * - Coordinator: /active.md (relative to coordinator/) → .ai-prompt-guide/coordinator/active.md
+ * - Archives: /archived/docs/... or /archived/coordinator/... (explicit prefix per requirements)
+ *
+ * This provides deterministic, clear path resolution with no implicit behavior.
+ */
+/**
+ * Physical folder names (used in .ai-prompt-guide directory structure)
+ *
+ * Use these constants instead of hardcoded strings to allow easy renaming.
+ */
+export declare const FOLDER_NAMES: {
+    /** Main docs folder: .ai-prompt-guide/docs */
+    readonly DOCS: "docs";
+    /** Coordinator tasks folder: .ai-prompt-guide/coordinator */
+    readonly COORDINATOR: "coordinator";
+    /** Archive root folder: .ai-prompt-guide/archived */
+    readonly ARCHIVED: "archived";
+};
+/**
+ * Logical path prefixes for INTERNAL file operations
+ *
+ * These are used for file I/O operations within the system.
+ * User-facing responses should use relative paths via toUserPath().
+ */
+export declare const PATH_PREFIXES: {
+    /** Docs namespace: /docs/ (internal) */
+    readonly DOCS: "/docs/";
+    /** Coordinator namespace: /coordinator/ (internal) */
+    readonly COORDINATOR: "/coordinator/";
+    /** Archive namespace: /archived/ (kept explicit per requirements) */
+    readonly ARCHIVED: "/archived/";
+};
+/**
+ * Full archive path prefixes (combining archived + subfolder)
+ */
+export declare const ARCHIVE_PREFIXES: {
+    /** Archived docs: /archived/docs/ */
+    readonly DOCS: "/archived/docs/";
+    /** Archived coordinator: /archived/coordinator/ */
+    readonly COORDINATOR: "/archived/coordinator/";
+};
+/**
+ * Check if a logical path is in the coordinator namespace
+ */
+export declare function isCoordinatorPath(logicalPath: string): boolean;
+/**
+ * Check if a logical path is in the docs namespace
+ * NOTE: With relative paths, docs are anything NOT in coordinator or archived/coordinator
+ */
+export declare function isDocsPath(logicalPath: string): boolean;
+/**
+ * Convert internal path to user-facing path
+ *
+ * Removes namespace prefixes for user responses:
+ * - /coordinator/active.md → /active.md
+ * - /docs/api/auth.md → /api/auth.md (future)
+ * - /archived/... → /archived/... (kept explicit per requirements)
+ *
+ * @param internalPath - Path with namespace prefix
+ * @returns User-facing relative path
+ */
+export declare function toUserPath(internalPath: string): string;
+//# sourceMappingURL=namespace-constants.d.ts.map

package/dist/shared/namespace-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-constants.d.ts","sourceRoot":"","sources":["../../src/shared/namespace-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY;IACvB,8CAA8C;;IAG9C,6DAA6D;;IAG7D,qDAAqD;;CAE7C,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,aAAa;IACxB,wCAAwC;;IAGxC,sDAAsD;;IAGtD,qEAAqE;;CAE7D,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,qCAAqC;;IAGrC,mDAAmD;;CAE3C,CAAC;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAWvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAkBvD"}

package/dist/shared/namespace-constants.js

@@ -0,0 +1,97 @@
+/**
+ * Namespace constants for document and coordinator separation
+ *
+ * IMPORTANT: PATH_PREFIXES are for INTERNAL file operations only.
+ * User-facing paths should be RELATIVE to their base folders:
+ * - Regular docs: /api/auth.md (relative to docs/) → .ai-prompt-guide/docs/api/auth.md
+ * - Coordinator: /active.md (relative to coordinator/) → .ai-prompt-guide/coordinator/active.md
+ * - Archives: /archived/docs/... or /archived/coordinator/... (explicit prefix per requirements)
+ *
+ * This provides deterministic, clear path resolution with no implicit behavior.
+ */
+/**
+ * Physical folder names (used in .ai-prompt-guide directory structure)
+ *
+ * Use these constants instead of hardcoded strings to allow easy renaming.
+ */
+export const FOLDER_NAMES = {
+    /** Main docs folder: .ai-prompt-guide/docs */
+    DOCS: 'docs',
+    /** Coordinator tasks folder: .ai-prompt-guide/coordinator */
+    COORDINATOR: 'coordinator',
+    /** Archive root folder: .ai-prompt-guide/archived */
+    ARCHIVED: 'archived'
+};
+/**
+ * Logical path prefixes for INTERNAL file operations
+ *
+ * These are used for file I/O operations within the system.
+ * User-facing responses should use relative paths via toUserPath().
+ */
+export const PATH_PREFIXES = {
+    /** Docs namespace: /docs/ (internal) */
+    DOCS: `/${FOLDER_NAMES.DOCS}/`,
+    /** Coordinator namespace: /coordinator/ (internal) */
+    COORDINATOR: `/${FOLDER_NAMES.COORDINATOR}/`,
+    /** Archive namespace: /archived/ (kept explicit per requirements) */
+    ARCHIVED: `/${FOLDER_NAMES.ARCHIVED}/`
+};
+/**
+ * Full archive path prefixes (combining archived + subfolder)
+ */
+export const ARCHIVE_PREFIXES = {
+    /** Archived docs: /archived/docs/ */
+    DOCS: `${PATH_PREFIXES.ARCHIVED}${FOLDER_NAMES.DOCS}/`,
+    /** Archived coordinator: /archived/coordinator/ */
+    COORDINATOR: `${PATH_PREFIXES.ARCHIVED}${FOLDER_NAMES.COORDINATOR}/`
+};
+/**
+ * Check if a logical path is in the coordinator namespace
+ */
+export function isCoordinatorPath(logicalPath) {
+    return logicalPath.startsWith(PATH_PREFIXES.COORDINATOR);
+}
+/**
+ * Check if a logical path is in the docs namespace
+ * NOTE: With relative paths, docs are anything NOT in coordinator or archived/coordinator
+ */
+export function isDocsPath(logicalPath) {
+    // Coordinator paths are NOT docs paths
+    if (logicalPath.startsWith(PATH_PREFIXES.COORDINATOR)) {
+        return false;
+    }
+    // Archived coordinator paths are NOT docs paths
+    if (logicalPath.startsWith(ARCHIVE_PREFIXES.COORDINATOR)) {
+        return false;
+    }
+    // Everything else is docs (including regular paths and archived/docs/)
+    return true;
+}
+/**
+ * Convert internal path to user-facing path
+ *
+ * Removes namespace prefixes for user responses:
+ * - /coordinator/active.md → /active.md
+ * - /docs/api/auth.md → /api/auth.md (future)
+ * - /archived/... → /archived/... (kept explicit per requirements)
+ *
+ * @param internalPath - Path with namespace prefix
+ * @returns User-facing relative path
+ */
+export function toUserPath(internalPath) {
+    // Archives keep explicit prefix
+    if (internalPath.startsWith(PATH_PREFIXES.ARCHIVED)) {
+        return internalPath;
+    }
+    // Strip coordinator prefix
+    if (internalPath.startsWith(PATH_PREFIXES.COORDINATOR)) {
+        return internalPath.replace(PATH_PREFIXES.COORDINATOR, '/');
+    }
+    // Strip docs prefix (future-proofing)
+    if (internalPath.startsWith(PATH_PREFIXES.DOCS)) {
+        return internalPath.replace(PATH_PREFIXES.DOCS, '/');
+    }
+    // Return as-is if no known prefix
+    return internalPath;
+}
+//# sourceMappingURL=namespace-constants.js.map

package/dist/shared/namespace-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-constants.js","sourceRoot":"","sources":["../../src/shared/namespace-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,8CAA8C;IAC9C,IAAI,EAAE,MAAM;IAEZ,6DAA6D;IAC7D,WAAW,EAAE,aAAa;IAE1B,qDAAqD;IACrD,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,wCAAwC;IACxC,IAAI,EAAE,IAAI,YAAY,CAAC,IAAI,GAAG;IAE9B,sDAAsD;IACtD,WAAW,EAAE,IAAI,YAAY,CAAC,WAAW,GAAG;IAE5C,qEAAqE;IACrE,QAAQ,EAAE,IAAI,YAAY,CAAC,QAAQ,GAAG;CAC9B,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,qCAAqC;IACrC,IAAI,EAAE,GAAG,aAAa,CAAC,QAAQ,GAAG,YAAY,CAAC,IAAI,GAAG;IAEtD,mDAAmD;IACnD,WAAW,EAAE,GAAG,aAAa,CAAC,QAAQ,GAAG,YAAY,CAAC,WAAW,GAAG;CAC5D,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,uCAAuC;IACvC,IAAI,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,gDAAgD;IAChD,IAAI,WAAW,CAAC,UAAU,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,uEAAuE;IACvE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,YAAoB;IAC7C,gCAAgC;IAChC,IAAI,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,2BAA2B;IAC3B,IAAI,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,OAAO,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;IAED,sCAAsC;IACtC,IAAI,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,OAAO,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,kCAAkC;IAClC,OAAO,YAAY,CAAC;AACtB,CAAC"}