Package io.jenkins.plugins.changeinvestigator.slack.lifecycle

Class EpisodeEngine

java.lang.Object

io.jenkins.plugins.changeinvestigator.slack.lifecycle.EpisodeEngine

public final class EpisodeEngine
extends Object

Deterministic transitions. Callers must save each transition before any network operation.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	EpisodeEngine.Delivery
static final class	EpisodeEngine.Episode
static final class	EpisodeEngine.State

Method Summary

Modifier and Type	Method	Description
static EpisodeEngine.Delivery	claim(EpisodeEngine.Episode episode, long now)	Persist the returned lease before posting.
static String	digest(String value)
static String	failure(EpisodeEngine.State state, int build, String signature, String material, ComparableCheck.Check check, String channel, String payload, long now)	Returns INITIAL, MATERIAL, or NONE.
static String	failure(EpisodeEngine.State state, int build, String signature, String material, ComparableCheck.Check check, String channel, String payload, long now, int lastGood, int firstBad)
static boolean	restarted(EpisodeEngine.State state)	Call only when no worker owns this job; a retained lease then has an uncertain outcome.
static void	retry(EpisodeEngine.Delivery delivery, long when)
static void	sent(EpisodeEngine.Episode episode, EpisodeEngine.Delivery delivery, String timestamp)
static String	signature(FailureSignal signal)	Build numbers and diagnostic line offsets deliberately do not participate.
static boolean	startsEpisode(EpisodeEngine.State state, int build, String signature, int lastGood, int firstBad)	A verified later regression window supersedes an unverified old episode without claiming recovery.
static boolean	success(EpisodeEngine.State state, int build, ComparableCheck.Proof proof, String payload, long now)	A successful build alone cannot close an episode.
static void	uncertain(EpisodeEngine.Delivery delivery)

Methods inherited from class java.lang.Object

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

Method Details

signature

public static String signature(FailureSignal signal)

Build numbers and diagnostic line offsets deliberately do not participate.

digest

public static String digest(String value)

failure

public static String failure(EpisodeEngine.State state,
 int build,
 String signature,
 String material,
 ComparableCheck.Check check,
 String channel,
 String payload,
 long now)

Returns INITIAL, MATERIAL, or NONE. Payload must already be bounded, safe Block Kit.

startsEpisode

public static boolean startsEpisode(EpisodeEngine.State state,
 int build,
 String signature,
 int lastGood,
 int firstBad)

A verified later regression window supersedes an unverified old episode without claiming recovery.

failure

public static String failure(EpisodeEngine.State state,
 int build,
 String signature,
 String material,
 ComparableCheck.Check check,
 String channel,
 String payload,
 long now,
 int lastGood,
 int firstBad)

success

public static boolean success(EpisodeEngine.State state,
 int build,
 ComparableCheck.Proof proof,
 String payload,
 long now)

A successful build alone cannot close an episode.

claim

public static EpisodeEngine.Delivery claim(EpisodeEngine.Episode episode,
 long now)

Persist the returned lease before posting. A missing root never creates a replacement root.

sent

public static void sent(EpisodeEngine.Episode episode,
 EpisodeEngine.Delivery delivery,
 String timestamp)

retry

public static void retry(EpisodeEngine.Delivery delivery,
 long when)

uncertain

public static void uncertain(EpisodeEngine.Delivery delivery)

restarted

public static boolean restarted(EpisodeEngine.State state)

Call only when no worker owns this job; a retained lease then has an uncertain outcome.