Package com.xebialabs.xlrelease.agentrules

Class AgentRuleFlow

java.lang.Object

com.xebialabs.xlrelease.agentrules.AgentRuleFlow

public final class AgentRuleFlow
extends Object

The parsed "Then" half of an agent rule: author-defined outcome branches, each carrying an ordered action list. Persisted as one versioned JSON document in the rule's flow property, authored by the Agent Rules builder UI:

 {"v":1,"branches":[
   {"outcome":"transient","actions":[{"type":"retryTask","mode":"auto","params":{"comment":"{{summary}}"}}]},
   {"outcome":"otherwise","actions":[{"type":"comment","mode":"auto","params":{}}]}
 ]}
 

The author owns the outcome vocabulary: the dispatcher lists the branch names in the instruction so the agent classifies into them, and anything unrecognized lands on the OTHERWISE branch. A rule without a flow keeps the pre-flow behavior (the analysis lands as a comment), so existing rules are untouched.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	AgentRuleFlow.ActionSpec	One action row: type, autonomy (auto vs propose), and templated parameters.
static final class	AgentRuleFlow.Branch	One outcome branch: the author-chosen name and its ordered actions.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	OTHERWISE	Reserved branch name: the default when the agent's outcome matches no named branch.

Method Summary

Modifier and Type	Method	Description
AgentRuleFlow.Branch	branchFor(String outcome)	The branch for the agent's outcome, or the otherwise-branch, or null for neither.
List<String>	namedOutcomes()	The named outcomes the agent may answer with — the instruction contract; excludes OTHERWISE.
static AgentRuleFlow	parse(String json, String ruleTitle)	Parses the flow property.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

OTHERWISE

public static final String OTHERWISE

Reserved branch name: the default when the agent's outcome matches no named branch.

See Also:

• Constant Field Values

Method Details

parse

public static AgentRuleFlow parse(String json,
 String ruleTitle)

Parses the flow property. Returns null — meaning "no flow, default behavior" — for blank input, unparseable JSON, or a document without branches; a broken flow must degrade to the safe advise-only path, never to silence or to wrong actions.

namedOutcomes

public List<String> namedOutcomes()

The named outcomes the agent may answer with — the instruction contract; excludes OTHERWISE.

branchFor

public AgentRuleFlow.Branch branchFor(String outcome)

The branch for the agent's outcome, or the otherwise-branch, or null for neither.