Simulation

A manager for a single simulation case.

We view a simulation as a case or workflow of simulated tasks. This class is responsible for keeping track of all the tasks for the corresponding simulation, informing the Coordinator of new tasks to be added and informing the simulation processes when a task is completed.

=Basic Interaction Flow= The interaction flow with the Coordinator is expected as follows:

1. The simulation logic starts executing via run.
2. Tasks are added via task.
3. When the simulation logic finishes producing tasks, it should call ready.
4. Eventually, one of the tasks completes and complete is called. The simulation logic resumes execution.
5. The simulation may now produce further tasks in reaction to the completed one(s). It can either handle and acknowledge each completed task individually using ack or use ready in one go as above.
6. When the simulation logic completes, it can use succeed (instead of ack or ready) to notify the Coordinator of its result.

=Additional Functions= The simulation may also:

1. React to things happening to other simulations. It can send a request to wait using simWait. The Coordinator will then wait for the Simulation to send new tasks or to complete, as if a task just completed. This needs to happen while the Coordinator is still waiting for the other simulation(s) we are reacting to.
2. Abort previously added tasks using abort.
3. Report completion due to failure using fail.
4. Optionally maintain a Lookahead structure of future tasks, returning it through getLookahead.