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
@@ -6,6 +6,7 @@ public enum I18n {
WORKSPACE_DEV("workspace.dev"),
DEV_MCP_WAITING("dev.mcpWaiting"), DEV_MCP_CONNECTED("dev.mcpConnected"), DEV_MCP_RECONNECTING("dev.mcpReconnecting"),
DEV_GRANT("dev.grant"), DEV_RECLAIM("dev.reclaim"), DEV_COPY_CONFIG("dev.copyConfig"),
DEV_DISCARD_GAME_DATA("dev.discardGameData"), DEV_DISCARD_GAME_DATA_CONFIRM("dev.discardGameDataConfirm"),
DEV_MCP_UNAVAILABLE("dev.mcpUnavailable"), DEV_EXTERNAL_WARNING("dev.externalWarning"),
DEV_MCP_INSTRUCTIONS("dev.mcpInstructions"), DEV_CONFIG_COPIED("dev.configCopied"), DEV_CONFIG_FAILED("dev.configFailed"),
DEV_MANUAL("dev.manual"), DEV_WAITING("dev.waiting"), DEV_WORKING("dev.working"), DEV_RETURNING("dev.returning"),
@@ -26,6 +26,7 @@ public final class DevWorkspace extends Workspace {
private final ImageView canvas = new ImageView();
private final Button grant = new Button(), reclaim = new Button();
private final Button configuration = new Button();
private final Button discardGameData = new Button();
private final Label availability = new Label(), copyStatus = new Label();
private final AgentConnectionGuide connectionGuide;
private final java.nio.file.Path projectRoot;
@@ -52,6 +53,14 @@ public final class DevWorkspace extends Workspace {
reclaim.textProperty().bind(i18n.bind(I18n.DEV_RECLAIM));
grant.setOnAction(e -> grant(false));
reclaim.setOnAction(e -> automation.reclaim());
discardGameData.setId("dev-discard-game-data");
discardGameData.textProperty().bind(i18n.bind(I18n.DEV_DISCARD_GAME_DATA));
discardGameData.setOnAction(e -> {
Alert dialog = new Alert(Alert.AlertType.CONFIRMATION, i18n.text(I18n.DEV_DISCARD_GAME_DATA_CONFIRM), ButtonType.OK, ButtonType.CANCEL);
if (root.getScene() != null) dialog.initOwner(root.getScene().getWindow());
if (dialog.showAndWait().orElse(ButtonType.CANCEL) == ButtonType.OK)
automation.reclaimDiscardingUnsavedGameData();
});
configuration.setId("dev-mcp-config");
configuration.textProperty().bind(i18n.bind(I18n.DEV_COPY_CONFIG));
configuration.setOnAction(e -> prepareConfiguration());
@@ -66,7 +75,7 @@ public final class DevWorkspace extends Workspace {
diagnostics.setEditable(false); diagnostics.setPrefRowCount(3);
history.setEditable(false); history.setPrefRowCount(5);
root.getChildren().addAll(new Label(project.name() + " — " + project.rootPath()),
state, new HBox(10, grant, reclaim, configuration), availability, copyStatus, instructions, warning,
state, new HBox(10, grant, reclaim, configuration), discardGameData, availability, copyStatus, instructions, warning,
operation, imageStatus, imagePane, identity,
pane(I18n.DEV_DIAGNOSTICS, diagnostics), pane(I18n.DEV_HISTORY, history));
apply(automation.snapshot());
@@ -124,6 +133,8 @@ public final class DevWorkspace extends Workspace {
case RETURNING_CONTROL -> I18n.DEV_RETURNING;
}));
grant.setDisable(!view.grantEnabled()); reclaim.setDisable(!view.reclaimEnabled());
boolean blockedReturn = snapshot.state() == ControlState.RETURNING_CONTROL && !snapshot.diagnostics().isEmpty();
discardGameData.setVisible(blockedReturn); discardGameData.setManaged(blockedReturn);
identity.setText(view.identity()); operation.setText(view.operation());
diagnostics.setText(view.diagnostics()); history.setText(view.calls());
imageStatus.setText(i18n.text(view.capture() == null ? I18n.DEV_NO_FRAME : view.stale() ? I18n.DEV_STALE_FRAME : I18n.DEV_CURRENT_FRAME));
@@ -380,3 +380,6 @@ dev.currentFrame=Canonical runtime capture
dev.mcpWaiting=Assistant connection: waiting for access or connection
dev.mcpConnected=Assistant connected
dev.mcpReconnecting=Assistant reconnecting
dev.discardGameData=Discard unsaved game data and return control
dev.discardGameDataConfirm=Cancel pending writes and discard any game data that remains unsaved? A write already published may persist.
@@ -51,3 +51,6 @@ dev.currentFrame=Captura canônica do runtime
dev.mcpWaiting=Conexão do assistente: aguardando acesso ou conexão
dev.mcpConnected=Assistente conectado
dev.mcpReconnecting=Assistente reconectando
dev.discardGameData=Descartar dados não gravados do jogo e retomar controle
dev.discardGameDataConfirm=Cancelar gravações pendentes e descartar os dados do jogo que ainda não foram gravados? Uma gravação já publicada pode persistir.