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
@@ -21,7 +21,8 @@ public record HostAdmissionContext(
"fs",
"log",
"asset",
"bank"));
"bank",
"memcard"));
public HostAdmissionContext {
knownCapabilities = knownCapabilities == null || knownCapabilities.isEmpty()
@@ -250,7 +250,8 @@ public class IRBackend implements IRBackendReader {
declaration.fileId(),
remapLifecycleCallable(declaration.fileInitFragment(), moduleRemap, callableRemap),
remapLifecycleCallable(declaration.projectInit(), moduleRemap, callableRemap),
remapLifecycleCallable(declaration.frameRoot(), moduleRemap, callableRemap));
remapLifecycleCallable(declaration.frameRoot(), moduleRemap, callableRemap),
declaration.bootstrapCalls());
}
private IRLifecycleCallableReference remapLifecycleCallable(
@@ -349,6 +350,7 @@ public class IRBackend implements IRBackendReader {
final var modules = new ArrayList<IRLifecycleModuleDeclaration>();
IRLifecycleCallableReference projectInit = null;
IRLifecycleCallableReference frameRoot = null;
final var bootstrapCalls = new java.util.LinkedHashSet<IRBackendExecutableFunction.HostCallMetadata>();
for (final var moduleId : lifecycleModuleOrder) {
final var fragments = new ArrayList<IRLifecycleCallableReference>();
var hasLifecycleContribution = false;
@@ -357,6 +359,7 @@ public class IRBackend implements IRBackendReader {
continue;
}
hasLifecycleContribution = true;
bootstrapCalls.addAll(lifecycleFile.bootstrapCalls().asList());
if (lifecycleFile.fileInitFragment() != null) {
fragments.add(lifecycleFile.fileInitFragment());
}
@@ -371,7 +374,8 @@ public class IRBackend implements IRBackendReader {
modules.add(new IRLifecycleModuleDeclaration(moduleId, ReadOnlyList.wrap(fragments)));
}
}
return new IRLifecycleDeclaration(ReadOnlyList.wrap(modules), projectInit, frameRoot);
return new IRLifecycleDeclaration(ReadOnlyList.wrap(modules), projectInit, frameRoot,
ReadOnlyList.wrap(new ArrayList<>(bootstrapCalls)));
}
private boolean sameModuleId(final ModuleId left, final ModuleId right) {
@@ -5,8 +5,14 @@ import p.studio.utilities.structures.ReadOnlyList;
public record IRLifecycleDeclaration(
ReadOnlyList<IRLifecycleModuleDeclaration> modules,
IRLifecycleCallableReference projectInit,
IRLifecycleCallableReference frameRoot) {
IRLifecycleCallableReference frameRoot,
ReadOnlyList<IRBackendExecutableFunction.HostCallMetadata> bootstrapCalls) {
public IRLifecycleDeclaration(ReadOnlyList<IRLifecycleModuleDeclaration> modules,
IRLifecycleCallableReference projectInit, IRLifecycleCallableReference frameRoot) {
this(modules, projectInit, frameRoot, ReadOnlyList.empty());
}
public IRLifecycleDeclaration {
modules = modules == null ? ReadOnlyList.empty() : modules;
bootstrapCalls = bootstrapCalls == null ? ReadOnlyList.empty() : bootstrapCalls;
}
}
@@ -10,13 +10,21 @@ public record IRLifecycleFileDeclaration(
FileId fileId,
IRLifecycleCallableReference fileInitFragment,
IRLifecycleCallableReference projectInit,
IRLifecycleCallableReference frameRoot) {
IRLifecycleCallableReference frameRoot,
p.studio.utilities.structures.ReadOnlyList<IRBackendExecutableFunction.HostCallMetadata> bootstrapCalls) {
public IRLifecycleFileDeclaration(ModuleId moduleId, FileId fileId,
IRLifecycleCallableReference fileInitFragment, IRLifecycleCallableReference projectInit,
IRLifecycleCallableReference frameRoot) {
this(moduleId, fileId, fileInitFragment, projectInit, frameRoot,
p.studio.utilities.structures.ReadOnlyList.empty());
}
public IRLifecycleFileDeclaration {
moduleId = Objects.requireNonNull(moduleId, "moduleId");
fileId = Objects.requireNonNull(fileId, "fileId");
bootstrapCalls = bootstrapCalls == null ? p.studio.utilities.structures.ReadOnlyList.empty() : bootstrapCalls;
}
public boolean isEmpty() {
return fileInitFragment == null && projectInit == null && frameRoot == null;
return fileInitFragment == null && projectInit == null && frameRoot == null && bootstrapCalls.isEmpty();
}
}