make `resolvePath` work with symlinked folders

not an ideal solution...
note potental failure
update docs to say "engine"
update docs in adapter_base