feat(studio): integrate memcard persistence and headless controls
Test / Tests and coverage
Intrepid/Prometeu/Studio/pipeline/pr-master This commit looks good

Persist cartridge identity and slot configuration, add MemcardBoot and the MemcardBuffer SDK, and consume the runtime's negotiated memcard host controls with protected teardown.

Qualify save/reopen and version upgrades through distinct configured runtime processes. Include specs, examples, regression evidence and the consolidated discussion lesson.
This commit is contained in:
2026-10-30 11:01:02 +00:00
parent 3a3417eb44
commit 1d8b8c2101
110 changed files with 6502 additions and 85 deletions
@@ -44,6 +44,48 @@ class HeadlessProcessSessionTest {
assertEquals(outcome.capture().frameId(), wire.path("structuredContent").path("value").path("frameId").bigIntegerValue());
session.shutdown().toCompletableFuture().get(3, TimeUnit.SECONDS); assertFalse(session.alive());
}
@Test void memcardNegotiatesExplicitlyAndRefusedShutdownPreservesNativeStateAndRetry() throws Exception {
var session = start("memcard");
session.initializeAndBoot(root, root, true, Map.of("memcardChoice", "persistent", "memcard", Map.of("action", "open", "access", "read_write")));
var failure = assertThrows(ExecutionException.class, () -> session.shutdown().toCompletableFuture().get(3, TimeUnit.SECONDS));
var domain = (AutomationException) failure.getCause();
assertEquals(AutomationFailure.Code.MEMCARD_ERROR, domain.failure().code());
assertTrue(session.alive());
var state = new ObjectMapper().valueToTree(session.call(TaskTools.HeadlessAction.MEMCARD_STATE, Map.of()).values());
assertEquals("18446744073709551615", state.path("memcard").path("request").path("id").textValue());
var wire = p.studio.app.mcp.McpToolResult.failure(new ObjectMapper(), domain.failure()).wire();
assertEquals("unsaved_changes", wire.path("structuredContent").path("error").path("runtimeError").path("details").path("reason").asText());
session.stop(Map.of("discardUnsaved", true, "pendingWrites", "cancel")).toCompletableFuture().get(3, TimeUnit.SECONDS);
assertFalse(session.alive());
var requests = Files.readAllLines(root.resolve("requests.jsonl")).stream().map(line -> {
try { return new ObjectMapper().readTree(line); } catch (Exception e) { throw new RuntimeException(e); }
}).toList();
assertEquals(1, requests.getFirst().path("params").path("protocolVersion").path("minor").intValue());
assertEquals("open", requests.get(1).path("params").path("action").asText());
assertEquals(root.resolve(".studio/memcard.pmc").toString(), requests.get(1).path("params").path("path").asText());
assertFalse(requests.get(3).path("params").has("discardUnsaved"));
assertFalse(Files.exists(root.resolve(".studio/memcard.pmc")));
}
@Test void memcardRejectsOldProvidersAndBadNegotiationBeforeBootOrMount() throws Exception {
for (var mode : List.of("normal", "memcard-negotiation")) {
var session = start(mode);
assertEquals(AutomationFailure.Code.RUNTIME_INCOMPATIBLE, assertThrows(AutomationException.class,
() -> session.initializeAndBoot(root, root, true, Map.of("memcardChoice", "memory_fresh"))).failure().code());
if (Files.exists(root.resolve("requests.jsonl"))) {
var sent = Files.readString(root.resolve("requests.jsonl"));
assertFalse(sent.contains("\"command\":\"boot\"")); assertFalse(sent.contains("memcard_mount"));
}
session.abort("test complete");
}
}
@Test void residentMediaActionIsAnOutcomeAndMalformedNativeStateInvalidatesSession() throws Exception {
var session = start("memcard-action"); session.initializeAndBoot(root, root, true, Map.of("memcardChoice", "memory_fresh"));
assertEquals(AutomationOutcome.Kind.ACTION_REQUIRED, session.advance(3, ignored -> {}).kind());
assertTrue(session.alive());
var malformed = start("memcard-malformed"); malformed.initializeAndBoot(root, root, true, Map.of("memcardChoice", "memory_fresh"));
assertThrows(AutomationException.class, () -> malformed.call(TaskTools.HeadlessAction.MEMCARD_STATE, Map.of()));
assertFalse(malformed.alive());
}
@Test void rejectsBadHandshakeMalformedOversizedAndNonUtf8OutputAndCleansUp() throws Exception {
for (var mode : List.of("major", "capabilities", "limits", "malformed", "oversized", "utf8", "wrong-session", "no-hello")) {
var session = start(mode);