add rough documentation to biggest roles

Most important attributes and methods are document for
Packager::Utils::Role::Packages and Packager::Utils::Role::Upstream.
Minor quirks are fixed while testing basic functionality.
Refactor guessing the package type to bring back

PkgSrc
switch from MetaCPAN::API to MetaCPAN::Client

also introduce caching capability as initial implemented in ExtUtils::BundleMaker