implement real headless process gateway and supervision

This commit is contained in:
2026-09-29 11:02:21 +01:00
parent 9592c9b274
commit bc76f08bbd
13 changed files with 771 additions and 5 deletions
@@ -0,0 +1,79 @@
package p.studio.app.runtime;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.junit.jupiter.api.*;
import org.junit.jupiter.api.io.TempDir;
import p.studio.api.automation.*;
import p.studio.api.project.*;
import p.studio.app.compiler.CompilerBuildGatewayAdapter;
import p.studio.app.operation.ExecutorOperationExecutor;
import p.studio.core.project.*;
import p.studio.core.shipper.StudioShipperService;
import java.nio.file.*;
import java.util.*;
import java.util.concurrent.*;
import static org.junit.jupiter.api.Assertions.*;
/** Explicit packaged-process gate, not satisfied by protocol fixtures. */
class HeadlessInstalledRuntimeTest {
@TempDir Path root;
@Test void configuredDistributionBootsSavedBuildAndReturnsDeterministicCanonicalPixels() throws Exception {
String install = System.getProperty("studio.test.runtimeInstall");
assertNotNull(install, "Supply -PstudioRuntimeInstall=<extracted runtime installation>");
assertTrue(Files.isRegularFile(Path.of(install, "prometeu-headless")));
var mapper = new ObjectMapper();
for (var doc : p.studio.compiler.FrontendRegistryService.require("pbs").documentation().orElseThrow().references(1, p.studio.AppMode.Game))
if (doc.id().startsWith("pbs:example:game:1:")) {
Path file = root.resolve(doc.id().substring("pbs:example:game:1:".length()));
Files.createDirectories(file.getParent()); Files.writeString(file, doc.text());
}
var setup = new ProjectLocalStudioSetupStore(mapper);
var project = new ProjectCatalogService(root, mapper, setup).openProject(root);
setup.save(project, new ProjectLocalStudioSetup(install, null));
try (var workers = Executors.newSingleThreadExecutor(); var packer = p.packer.Packer.bootstrap(mapper, ignored -> {})) {
var build = new StudioShipperService(new CompilerBuildGatewayAdapter(), packer.workspaceService(), mapper, new ExecutorOperationExecutor(workers))
.prepare(project, ignored -> {}).completion().toCompletableFuture().get(15, TimeUnit.SECONDS);
assertTrue(build.success(), build.diagnostics().toString());
var gateway = new HeadlessProcessGateway(mapper, setup::load);
var session = (HeadlessProcessSession) gateway.boot(project, "real-build", build);
try {
assertEquals(600, session.maxFramesPerAdvance());
assertEquals(AutomationFailure.Code.NO_FRAME_AVAILABLE, assertThrows(AutomationException.class,
() -> session.call(TaskTools.HeadlessAction.CAPTURE, Map.of())).failure().code());
var observed = new ArrayList<TrackedOperation.Progress>();
var outcome = session.advance(3, observed::add);
assertEquals(AutomationOutcome.Kind.SUCCEEDED, outcome.kind()); assertEquals(3, outcome.completedFrames());
assertNotNull(outcome.capture()); assertEquals("real-build", outcome.capture().buildId());
assertEquals(session.sessionId(), outcome.capture().sessionId());
var image = javax.imageio.ImageIO.read(new java.io.ByteArrayInputStream(outcome.capture().png()));
assertEquals(outcome.capture().width(), image.getWidth()); assertEquals(outcome.capture().height(), image.getHeight());
assertEquals(3L, observed.getLast().completedFrames());
var state = session.call(TaskTools.HeadlessAction.STATE, Map.of());
assertEquals("0.1.0", state.values().get("runtimeVersion"));
assertNull(session.call(TaskTools.HeadlessAction.FAULT, Map.of()).values().get("fault"));
session.call(TaskTools.HeadlessAction.SET_INPUT, Map.of("a", true));
session.call(TaskTools.HeadlessAction.CLEAR_INPUT, Map.of());
session.call(TaskTools.HeadlessAction.RESET, Map.of());
assertEquals(AutomationFailure.Code.NO_FRAME_AVAILABLE, assertThrows(AutomationException.class,
() -> session.call(TaskTools.HeadlessAction.CAPTURE, Map.of())).failure().code());
session.call(TaskTools.HeadlessAction.BOOT, Map.of());
var repeated = session.advance(3, ignored -> {});
assertArrayEquals(outcome.capture().png(), repeated.capture().png());
assertEquals(0, session.advance(0, ignored -> {}).completedFrames());
assertEquals(AutomationFailure.Code.LIMIT_EXCEEDED, assertThrows(AutomationException.class,
() -> session.advance(601, ignored -> {})).failure().code());
} finally { session.shutdown().toCompletableFuture().get(7, TimeUnit.SECONDS); }
assertFalse(session.alive());
var cancellable = (HeadlessProcessSession) new HeadlessProcessGateway(mapper, setup::load,
new HeadlessLimits(20000, 65536, 33554432, 5000, 60000, 5000)).boot(project, "cancel-build", build);
try {
assertEquals(20000, cancellable.maxFramesPerAdvance());
var cancelled = cancellable.advance(20000, progress -> { if (progress.completedFrames() == 1) cancellable.cancel(); });
assertEquals(AutomationOutcome.Kind.CANCELLED, cancelled.kind());
assertTrue(cancelled.completedFrames() >= 1 && cancelled.completedFrames() < 20000);
assertNotNull(cancelled.capture());
} finally { cancellable.shutdown().toCompletableFuture().get(7, TimeUnit.SECONDS); }
assertFalse(cancellable.alive());
}
}
}