Nasty.

You should have simply used a hash. Drop all the toxic $$XX stuff out. Use simple keys instead of complex variable names with symbolic refs on top.

$cache{'storage directory'}; for example.

Using hashes would prune your tree of subroutines, prevent them from having action at a distance, make it clear what variables are changing, and greatly improve your code readability.