Class FoundationBaker

java.lang.Object

network.ike.plugin.scaffold.FoundationBaker

public final class FoundationBaker
extends Object

Release-time refresh of the scaffold manifest's foundation: block (IKE-Network/ike-issues#414).

The foundation: block in ike-build-standards/src/main/scaffold/scaffold-manifest.yaml is the tested-together compatibility snapshot a consumer picks up with a given ike-tooling scaffold. ike-tooling.version is filtered from ${project.version} and so is always correct; ike-parent, ike-docs, and ike-platform were hand-maintained literals. This class resolves their latest released (GA) versions from the configured remote repositories and rewrites the block, so the scaffold zip always ships a current snapshot without a manual edit.

This is the discovery half of foundation currency — the scaffold foundation: block can only propagate a snapshot, it cannot find out a newer upstream version exists. Moving discovery to release-time bake here is what lets the scaffold mechanism own foundation currency end to end (the precondition for retiring the versions-upgrade subsystem, ike-issues#415).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	FoundationBaker.Coordinate	A foundation artifact whose pin is baked at release time.
static final record	FoundationBaker.Finding	The assessment of one foundation pin.
static enum	FoundationBaker.Status	Classification of a foundation pin against its latest GA.

Field Summary

Fields

Modifier and Type	Field	Description
static final FoundationBaker.Coordinate	IKE_DOCS	ike-docs — the ike-docs.version property pin.
static final FoundationBaker.Coordinate	IKE_PARENT	ike-parent — carried in the foundation.parent block.
static final FoundationBaker.Coordinate	IKE_PLATFORM	ike-platform — the ike-platform.version pin.
static final FoundationBaker.Coordinate	IKE_TOOLING	ike-tooling — tracks the ike-tooling.version property pin (the version line ike-build-standards, ike-maven-plugin and the rest of the ike-tooling reactor share).

Method Summary

Modifier and Type	Method	Description
static List<FoundationBaker.Finding>	assess(ScaffoldManifest.Foundation foundation, CandidateVersionResolver resolver)	Assess every baked foundation pin against the latest GA versions the resolver can see.
static ScaffoldManifest.Foundation	latestFoundation(ScaffoldManifest.Foundation baked, CandidateVersionResolver resolver)	Resolve the latest released versions for every foundation pin and return a ScaffoldManifest.Foundation carrying them — the input snapshot with each version advanced to the latest GA the resolver can see.
static String	rewrite(String manifestYaml, List<FoundationBaker.Finding> findings)	Rewrite the foundation: block of a scaffold-manifest YAML document, applying every FoundationBaker.Status.AHEAD finding.

Methods inherited from class Object

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

Field Details

IKE_PARENT

public static final FoundationBaker.Coordinate IKE_PARENT

ike-parent — carried in the foundation.parent block. ike-tooling.version is deliberately absent: it is filtered from ${project.version} and never baked.

IKE_DOCS

public static final FoundationBaker.Coordinate IKE_DOCS

ike-docs — the ike-docs.version property pin.

IKE_PLATFORM

public static final FoundationBaker.Coordinate IKE_PLATFORM

ike-platform — the ike-platform.version pin.

ike-parent, ike-bom, ike-workspace-maven-plugin and the network.ike.platform:ike-platform reactor root all share one unified version, so this pin and IKE_PARENT always resolve to the same release. assess(ScaffoldManifest.Foundation, CandidateVersionResolver) queries ike-parent once and answers both — the groupId / artifactId here document what the pin tracks but are not resolved independently.

IKE_TOOLING

public static final FoundationBaker.Coordinate IKE_TOOLING

ike-tooling — tracks the ike-tooling.version property pin (the version line ike-build-standards, ike-maven-plugin and the rest of the ike-tooling reactor share). Resolved only for the consumer-side latestFoundation(ScaffoldManifest.Foundation, CandidateVersionResolver) path; the release-time assess(ScaffoldManifest.Foundation, CandidateVersionResolver) never touches it — there it is ${project.version}, correct by construction.

Method Details

assess

public static List<FoundationBaker.Finding> assess(ScaffoldManifest.Foundation foundation,
 CandidateVersionResolver resolver)

Assess every baked foundation pin against the latest GA versions the resolver can see.

Two coordinates are resolved, not three: ike-parent and ike-docs. The ike-platform.version pin shares the unified ike-platform reactor version with ike-parent, so its FoundationBaker.Finding is derived from the same resolution rather than queried separately.

Parameters:

foundation - the manifest's current foundation: block

resolver - resolves released versions for a coordinate

Returns:

one FoundationBaker.Finding per pin, in ike-parent, ike-docs, ike-platform order

latestFoundation

public static ScaffoldManifest.Foundation latestFoundation(ScaffoldManifest.Foundation baked,
 CandidateVersionResolver resolver)

Resolve the latest released versions for every foundation pin and return a ScaffoldManifest.Foundation carrying them — the input snapshot with each version advanced to the latest GA the resolver can see.

The consumer-side counterpart to assess(ScaffoldManifest.Foundation, CandidateVersionResolver): it lets ike:scaffold-publish's opt-in resolve-latest mode apply current foundation pins instead of the (possibly stale, parent-pinned) snapshot baked into the scaffold zip — the escape hatch for the bootstrap loop where a consumer's scaffold tooling is itself gated by the ike-parent it needs to bump.

A pin is only advanced, never lowered: when the resolved GA is not newer than the baked value, or cannot be resolved, the baked value is kept. A value containing ${...} is left verbatim.

Parameters:

baked - the foundation snapshot from the scaffold zip

resolver - resolves released versions for a coordinate

Returns:

a foundation with each pin at the latest released version

rewrite

public static String rewrite(String manifestYaml,
 List<FoundationBaker.Finding> findings)

Rewrite the foundation: block of a scaffold-manifest YAML document, applying every FoundationBaker.Status.AHEAD finding. Only the version values change — comments, indentation, key order, and the rest of the document are byte-preserved.

Parameters:

manifestYaml - the full scaffold-manifest.yaml content

findings - the assessment from assess(ScaffoldManifest.Foundation, CandidateVersionResolver)

Returns:

the rewritten content; identical to the input when no finding is FoundationBaker.Status.AHEAD