Add information about workspace updates
Based on the the different combination of actual states and desired states, added a document showing an example of when each transition would happen, what the database state be at that point and what information we send back to agentk.
Instead of having a mental model of what each state transition would do and when and what information will rails send to agentk, this document will server as an authoritative source.
It would also help in easily figuring out if we are breaking anything in the future by changing any logic by modelling the changed behaviour for each case.