feat(studio): integrate memcard persistence and headless controls
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:
@@ -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);
|
||||
|
||||
Reference in New Issue
Block a user