Class ReleaseStatusInspector

java.lang.Object

network.ike.plugin.ws.ReleaseStatusInspector

public final class ReleaseStatusInspector
extends Object

Pure inference logic for WsReleaseStatusMojo — given a snapshot of git observations for one subproject, classifies the subproject's release state.

This class is git-only and side-effect free. The mojo is responsible for collecting an ReleaseStatusInspector.Observation from the live repository (via git subprocesses); this class encapsulates the rules that turn that observation into a ReleaseStatusInspector.Finding.

The split exists so that the classification rules can be exercised without building a real git repository on disk for every scenario — see WsReleaseStatusInspectorTest. End-to-end coverage that spans real git tag, git branch, and remote interaction lives in WsReleaseStatusIntegrationTest.

See issue #187.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	ReleaseStatusInspector.Finding	Classification result for a single subproject.
static final record	ReleaseStatusInspector.Observation	Raw git observations for a single subproject.
static enum	ReleaseStatusInspector.Status	High-level summary of a subproject's release state, derived from git artifacts alone.

Method Summary

Modifier and Type	Method	Description
static ReleaseStatusInspector.Finding	classify(ReleaseStatusInspector.Observation obs)	Apply the classification rules to a single observation.

Methods inherited from class Object

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

Method Details

classify

public static ReleaseStatusInspector.Finding classify(ReleaseStatusInspector.Observation obs)

Apply the classification rules to a single observation.

Rules, in order of precedence:

1. If the subproject is not checked out, return ReleaseStatusInspector.Status.ABSENT.
2. If a release/* branch is present locally and the corresponding v<version> tag is already on origin, return ReleaseStatusInspector.Status.DIVERGED — the release happened elsewhere; the local branch is debris.
3. If any release/* branch exists locally, or any local v* tag is missing from the remote (and the remote was reachable), return ReleaseStatusInspector.Status.IN_FLIGHT.
4. Otherwise return ReleaseStatusInspector.Status.CLEAN.

Parameters:

obs - the git observation snapshot for one subproject

Returns:

the classification result