Class ScaffoldReverter

java.lang.Object

network.ike.plugin.scaffold.ScaffoldReverter

public final class ScaffoldReverter
extends Object

Undo a previous scaffold publish.

Revert semantics by tier:

• ScaffoldTier.TOOL_OWNED: delete the file if it still matches the applied hash, else warn and skip (unexpected divergence).
• ScaffoldTier.TRACKED: delete the file if it still matches appliedSha, else skip (user-edited).
• ScaffoldTier.TRACKED_BLOCK: not yet implemented — the reverter reports a skip with a message. A proper impl would remove just the managed block and leave the rest of the file.
• ScaffoldTier.MODEL_MANAGED: not yet implemented — proper impl would remove exactly the managed elements.

This class is deliberately conservative: anything the user might have touched is left alone and reported, not destroyed.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	ScaffoldReverter.Outcome	Per-entry result of a revert.
static final record	ScaffoldReverter.RevertResult	Aggregate revert result.

Constructor Summary

Constructors

Constructor	Description
ScaffoldReverter()	Construct with Clock.systemUTC().
ScaffoldReverter(Clock clock)	Construct with an explicit clock.

Method Summary

Modifier and Type	Method	Description
ScaffoldReverter.RevertResult	revert(ScaffoldLockfile currentLockfile, ScaffoldManifest manifest, ScaffoldScope scope, PathResolver pathResolver)	Revert every entry in currentLockfile that lives in the given scope.

Methods inherited from class Object

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

Constructor Details

ScaffoldReverter

public ScaffoldReverter()

Construct with Clock.systemUTC().

ScaffoldReverter

public ScaffoldReverter(Clock clock)

Construct with an explicit clock. Tests supply a fixed clock so the generated-at timestamp recorded in the updated lockfile after revert is deterministic.

Parameters:

clock - clock for revert timestamps

Method Details

revert

public ScaffoldReverter.RevertResult revert(ScaffoldLockfile currentLockfile,
 ScaffoldManifest manifest,
 ScaffoldScope scope,
 PathResolver pathResolver)

Revert every entry in currentLockfile that lives in the given scope.

Parameters:

currentLockfile - the current lockfile

manifest - the manifest (used to look up each entry's scope and tier)

scope - the scope to revert

pathResolver - path resolver

Returns:

a ScaffoldReverter.RevertResult with the new lockfile (with reverted entries removed) and a per-entry report