feat(studio): deliver asset authoring and automation workflows
Test / Tests and coverage occurred while executing withChecks step.
Intrepid/Prometeu/Studio/pipeline/pr-master There was a failure building this commit

Add shared human/task asset batches with reviewed atomic publication, explicit
reference rebinds, ownership inspection and qualified glyph/scene budgets.
Expose the same authoring and capacity results through Assets and MCP.

Deliver isolated guest test targets, retained visual evidence and immutable
runtime lifecycle/control observations. Preserve provider qualification and
installed authoring examples alongside the completed discussion lessons.

Close AGD-106 coordination and the delivered discussion workflows through
housekeeping, updating lesson references and preserving qualification limits.
Sound remains outside the asset delivery wave.

Validation: 579 module tests and 31 additional desktop, process and installed
checks passed; native glyph/scene 16/17 boundaries qualified. Discussion
validation passed after housekeeping.
This commit is contained in:
2026-11-11 01:21:25 +00:00
parent b351f2e582
commit 1471b427f1
325 changed files with 61179 additions and 323 deletions
@@ -0,0 +1,75 @@
package p.studio.app.runtime;
import com.fasterxml.jackson.databind.*;
import com.fasterxml.jackson.databind.node.*;
import org.junit.jupiter.api.*;
import org.junit.jupiter.api.io.TempDir;
import org.springframework.boot.WebApplicationType;
import org.springframework.boot.builder.SpringApplicationBuilder;
import p.studio.api.automation.*;
import p.studio.api.project.*;
import p.studio.api.session.*;
import p.studio.app.StudioApplicationConfiguration;
import p.studio.core.project.ProjectLocalStudioSetupStore;
import java.nio.file.*;
import java.security.MessageDigest;
import java.util.*;
import java.util.concurrent.TimeUnit;
import static org.junit.jupiter.api.Assertions.*;
/** Required pilot on a disposable copy of the actual game, using only its existing public APIs. */
class GuestTestPilotTest {
@TempDir Path root;
static Map<String,String> sources(Path root)throws Exception {
var hashes=new TreeMap<String,String>();try(var paths=Files.walk(root.resolve("src"))) {
for(var p:paths.filter(Files::isRegularFile).toList())hashes.put(root.relativize(p).toString(),HexFormat.of().formatHex(MessageDigest.getInstance("SHA-256").digest(Files.readAllBytes(p))));
}return hashes;
}
@Test void publicShopCommitAndSeparateProcessReadbackPreserveOriginalSourcesAndPersonalMedia()throws Exception {
String selected=System.getProperty("studio.test.guestPilotProject","");assertFalse(selected.isBlank(),"Supply -PstudioGuestPilotProject=<actual Zelda project>");
Path original=Path.of(selected).toRealPath();var before=sources(original);root=root.toRealPath();
for(String folder:List.of("src","assets"))try(var paths=Files.walk(original.resolve(folder))) {
for(var source:paths.toList()){Path dest=root.resolve(original.relativize(source));if(Files.isDirectory(source))Files.createDirectories(dest);else Files.copy(source,dest);}
}
var mapper=new ObjectMapper();var manifest=(ObjectNode)mapper.readTree(original.resolve("prometeu.json").toFile());
assertNotNull(manifest.get("memcard_slots"));var targets=manifest.putObject("testTargets").put("schemaVersion",1).putArray("targets");
for(var name:List.of("writer","reader")) {
Path entry=root.resolve("tests/"+name+"/main.pbs");Files.createDirectories(entry.getParent());
try(var stream=getClass().getResourceAsStream("/guest-tests/zelda-public/"+name+".pbs")){assertNotNull(stream);Files.copy(stream,entry);}
var t=targets.addObject().put("id",name).put("entrypoint","tests/"+name+"/main.pbs").put("logTag",41003);
t.putArray("sourceRoots").add("src").add("tests/"+name);t.putArray("supportRoots");t.putArray("exclusions").add("src/main.pbs");
var cases=t.putArray("cases");if(name.equals("writer")){cases.add("purchase").add("commit");}else cases.add("readback");
}
mapper.writeValue(root.resolve("prometeu.json").toFile(),manifest);
Path personal=root.resolve(".studio/memcard.pmc");Files.createDirectories(personal.getParent());Files.writeString(personal,"Unrelated personal image");byte[] personalBytes=Files.readAllBytes(personal);
try(var app=new SpringApplicationBuilder(StudioApplicationConfiguration.class).web(WebApplicationType.NONE).headless(true).run()) {
var project=app.getBean(ProjectCatalog.class).openProject(root);app.getBean(ProjectLocalStudioSetupStore.class).save(project,new ProjectLocalStudioSetup(System.getProperty("studio.test.runtimeInstall"),null));
try(var session=app.getBean(ProjectSessionFactory.class).open(project)) {
var service=app.getBean(GuestTestTools.class);
service.start(root,null,"writer",new GuestTestTools.Request("writer",1500,1,120_000,GuestTestTools.Media.disposable_create,null,false));
var writer=await(service,"writer");
Path output=Path.of("build/guest-tests-qualification/zelda-public");Files.createDirectories(output);
mapper.writeValue(output.resolve("writer.json").toFile(),writer.result());
assertEquals(GuestTests.CaseState.passed,writer.result().verdict(),String.valueOf(writer.result()));assertFalse(writer.runtimeRetained());
Path image=root.resolve(".studio/test-runs").resolve(writer.runId()).resolve("memcard.pmc");assertTrue(Files.isRegularFile(image));
String afterWriter=HexFormat.of().formatHex(MessageDigest.getInstance("SHA-256").digest(Files.readAllBytes(image)));
Files.copy(image,output.resolve("writer-memcard.pmc"),StandardCopyOption.REPLACE_EXISTING);
service.start(root,null,"reader",new GuestTestTools.Request("reader",30,1,120_000,GuestTestTools.Media.disposable_reopen,writer.runId(),false));
var reader=await(service,"reader");mapper.writeValue(output.resolve("reader.json").toFile(),reader.result());
Path cartridge=root.resolve(".studio/test-builds/reader").resolve(reader.result().buildId());
try(var files=Files.walk(cartridge)){for(var file:files.toList()){Path dest=output.resolve("reader-cartridge").resolve(cartridge.relativize(file));if(Files.isDirectory(file))Files.createDirectories(dest);else Files.copy(file,dest,StandardCopyOption.REPLACE_EXISTING);}}
mapper.writeValue(output.resolve("source-and-media-proof.json").toFile(),Map.of("originalProject",original.toString(),"originalSourcesBefore",before,"originalSourcesAfter",sources(original),"copySourcesAfter",sources(root),"writerImageSha256",afterWriter,"readerImageSha256",HexFormat.of().formatHex(MessageDigest.getInstance("SHA-256").digest(Files.readAllBytes(image))),"scope","Existing public Inventory.restore_slots, CaveSupplyShop.purchase and SaveStore boot/begin/poll/load. No original generator/private helper/source/barrel edit."));
assertEquals(GuestTests.CaseState.passed,reader.result().verdict(),String.valueOf(reader.result()));
assertNotEquals(writer.result().sessionId(),reader.result().sessionId());assertNotEquals(writer.result().buildId(),reader.result().buildId());assertFalse(reader.runtimeRetained());
assertArrayEquals(personalBytes,Files.readAllBytes(personal));assertEquals(before,sources(root));assertEquals(before,sources(original));
mapper.writeValue(output.resolve("writer.json").toFile(),writer.result());mapper.writeValue(output.resolve("reader.json").toFile(),reader.result());
mapper.writeValue(output.resolve("source-and-media-proof.json").toFile(),Map.of("originalProject",original.toString(),"originalSourcesBefore",before,"originalSourcesAfter",sources(original),"copySourcesAfter",sources(root),"writerImageSha256",afterWriter,"readerImageSha256",HexFormat.of().formatHex(MessageDigest.getInstance("SHA-256").digest(Files.readAllBytes(image))),"scope","Existing public Inventory.restore_slots, CaveSupplyShop.purchase and SaveStore boot/begin/poll/load. No original generator/private helper/source/barrel edit."));
}
}
}
GuestTestTools.View await(GuestTestTools service,String id)throws Exception {
long end=System.nanoTime()+TimeUnit.SECONDS.toNanos(130);
while(System.nanoTime()<end){var view=service.get(root,null,new OperationLookup(null,id));if(view.workerTerminated())return view;Thread.sleep(10);}
throw new AssertionError("Pilot test worker did not terminate");
}
}