/**
 * Resolves workspace root from various sources:
 * - Multi-root workspaces
 * - VS Code workspace files (.code-workspace)
 * - Cursor workspace configuration
 * - Current working directory (fallback)
 */
export declare class WorkspaceResolver {
    /**
     * Resolves workspace root from command line argument or environment.
     * Supports:
     * - Single workspace root (directory path)
     * - Multi-root workspace (.code-workspace file)
     * - Current working directory (fallback)
     */
    static resolveWorkspaceRoot(workspaceArg?: string): string;
    /**
     * Resolves workspace root from VS Code workspace file.
     * Returns the first folder path from the workspace file.
     */
    private static resolveFromWorkspaceFile;
    /**
     * Finds workspace file (.code-workspace) in directory or parent directories.
     */
    private static findWorkspaceFile;
    /**
     * Finds docs directory in workspace root or parent directories.
     */
    static findDocsDirectory(workspaceRoot: string, maxDepth?: number): string | null;
    /**
     * Finds plugin directories relative to workspace root.
     */
    static findPluginPaths(workspaceRoot: string): {
        databasePlugin?: string;
        documentationPlugin?: string;
    };
    /**
     * Normalizes a path for plugin ID computation (lowercase on Windows).
     * Used for deterministic plugin ID generation.
     *
     * @param filePath Path to normalize
     * @returns Normalized path (POSIX-style, lowercase on Windows)
     */
    static normalizeForPluginId(filePath: string): string;
    /**
     * Normalizes a file path (case-preserving).
     * Used for file path storage and entity ID computation.
     *
     * @param filePath Path to normalize
     * @returns Normalized path (POSIX-style, case-preserved)
     */
    static normalizeFilePath(filePath: string): string;
    /**
     * Computes canonical plugin ID from workspace root.
     * Uses SHA256 hash of normalized workspace root path.
     *
     * @param workspaceRoot Workspace root path
     * @returns Plugin ID (16 hex characters)
     */
    static computePluginId(workspaceRoot: string): string;
    /**
     * Computes canonical workspace ID from workspace root.
     * Uses SHA256 hash of normalized workspace root path.
     *
     * @param workspaceRoot Workspace root path
     * @returns Workspace ID (16 hex characters)
     */
    static computeWorkspaceId(workspaceRoot: string): string;
    /**
     * Computes entity ID hash for a given entity.
     * Used for cross-system stable entity references.
     *
     * @param entityType Type of entity (e.g., 'module', 'symbol', 'adr')
     * @param entityPath Path or identifier of the entity
     * @returns Entity ID hash (16 hex characters)
     */
    static computeEntityId(entityType: string, entityPath: string): string;
    /**
     * Maps entity ID from one workspace to another.
     * Used for snapshot portability across different workspace roots.
     *
     * @param entityId Original entity ID
     * @param sourceWorkspaceRoot Source workspace root
     * @param targetWorkspaceRoot Target workspace root
     * @returns Mapped entity ID (if mapping is possible)
     */
    static mapEntityId(entityId: string, sourceWorkspaceRoot: string, targetWorkspaceRoot: string): string | null;
}
//# sourceMappingURL=workspace-resolver.d.ts.map