Add comments about how to register in ct

Expectation

input: workflowId, runId(optional)
output: status + currentRunId

How to implement

Use workflow/get API, and set needsResults to false: https://github.com/indeedeng/iwf-idl/blob/f63c1a67a111fd946ec477545a3c30e552a75965/iwf.yaml#L469 so that it won't return the workflow result

How to test

Use the basic integ test to test the API working

Remove state options from it for client as it should be loaded from workflow state rather than from request, otherwise it will be confusing.
Remove minimum from method and let start api specify timeout
Also remove one overload to make it clear

Use map[string]Object as initial search attribute

unregistered client can use raw workflow state option instead

WorkflowOptions will be only for client and not for unregistered client

It’s created by mistake

by default it's the simple name but in some advanced use case, ppl want to set the value differently (e.g. DSL workflow)

carry over policy /type
persistence loading policy/type
SearchAttributeType

This will be easier for multiple values

Use https://immutables.github.io/

implement https://github.com/cadence-oss/iwf-java/blob/main/core/src/main/java/iwf/core/spring/controller/ApiController.java#L23

AC & steps (separate PRs):

1. Copy the SDK code from prototype
2. Copy a demo workflow as user code in test folder, and let it run with the SDK (with the spring controller)
3. Provide a workflowRegistry with register APIs to register workflow type(use workflow class short name)
4. On invoking workflowState.Start, find the workflow from workflowRegistry, and invoke the start API from user code, collect the command requests and return back to caller

For error that is caused by input, throw IllegalArgumentException.

For error that is caused by user workflow, throw WorkflowDefinitionException.java

For error that caused by SDK or Service, throw InternalServiceException.java

it’s 30 s . Also need the same for go sdk

User should still workaround by using unregistered client

check the input is assignable to start state input

When client is initiated without registry, then use as UntypedClient

Especially server has set timeout for the APIs

so that the stateId doesn't have to be specified in StateDecision.nextState(..)

We should mark the old ones as deprecated

Eg only sdk knows if it’s keyword or text

remove library path

rename FAILING_WORKFLOW to FORCE_FAILING_WORKFLOW

E.g. in WorkflowService we should check if the workflow state is valid

This will probably make it even easier for https://github.com/indeedeng/iwf-java-samples/blob/b444ff64f993a131fa7a55a5ff15476d1a4a13d4/src/main/java/io/iworkflow/controller/IwfWorkerApiController.java#L61

this will also help the maven library name(artifactId)

1. Check if signal name have conflicts
2. Check if sending a valid signal

Currently it's using
default start to close timeout from iwf-server:

10 s

default backoff retry from Temporal server:

		// The default RetryPolicy provided by the server specifies:
		// - InitialInterval of 1 second
		// - BackoffCoefficient of 2.0
		// - MaximumInterval of 100 x InitialInterval
		// - MaximumAttempts of 0 (unlimited)

Or getWorkflowResultNonBlocking
Or tryGettingWorkflowResult

when starting a workflow with starting state, or in StateDeicion.singleNextState and StateDeicion.multipleNextStates, we should check if the state are valid and registered for the workflow type