Fix numerous small issues with locking

[mhenrixon]

Extracts logic for each lock class into the class itself. Duplicate as much as possible to be able to better understand what is going wrong and fix + add test coverage for these issues.

There were a few issues fixed:

1. Cleanup wasn't always working in certain cases
2. Re-locking UntilAndWhileExecuting was broken because the original job hash was manipulated
3. The RUN_SUFFIX might have been appended more than once
4. In scenarios where the queue and primed tokens where "1" processing stopped
5. config.wait_for_lock? had incorrect logic and has now been fixed
6. Adds an UPGRADING.md document to be able to better approach such massive changes as here