/**
 * Document Path Resolver Service
 *
 * Determines correct file paths for documents based on
 * type and category, following knowledge-base conventions.
 */
import { type DocumentCategory, type DocumentType } from '../types/document.types.js';
export declare class DocumentPathResolverService {
    private readonly knowledgeBasePath;
    private readonly logger;
    constructor(customPath?: string);
    /**
     * Resolve the knowledge-base path from config or default
     */
    private resolveKnowledgeBasePath;
    /**
     * Get the full path for a document
     */
    resolvePath(type: DocumentType, category: DocumentCategory): string;
    /**
     * Get the directory path for a category
     */
    getCategoryPath(category: DocumentCategory): string;
    /**
     * Generate UPPERCASE filename for document type
     */
    generateFilename(type: DocumentType): string;
    /**
     * Check if a document already exists
     */
    exists(type: DocumentType, category: DocumentCategory): boolean;
    /**
     * Get existing document content if it exists
     */
    getExisting(type: DocumentType, category: DocumentCategory): null | string;
    /**
     * Get the knowledge-base root path
     */
    getKnowledgeBasePath(): string;
    /**
     * Validate that category is valid for document type
     */
    validateCategory(type: DocumentType, category: DocumentCategory): boolean;
    /**
     * Get default category for document type
     */
    getDefaultCategory(type: DocumentType): DocumentCategory;
    /**
     * Ensure the target directory exists
     */
    ensureDirectoryExists(category: DocumentCategory): string;
    /**
     * Get relative path from knowledge-base root
     */
    getRelativePath(type: DocumentType, category: DocumentCategory): string;
    /**
     * Parse a full path to extract type and category
     */
    parseDocumentPath(fullPath: string): null | {
        category: DocumentCategory;
        type: DocumentType;
    };
    /**
     * Get backup path for existing document
     */
    getBackupPath(type: DocumentType, category: DocumentCategory): string;
}
//# sourceMappingURL=document-path-resolver.service.d.ts.map