artifactcache: improve _fetch_directory()

* Add documentation
* Rename tree to dir_digest to make it clear this is a Digest object,
  and not a Tree object.