conco/OpenMaidEngine
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity

Split movie host contract

Browse Source
This commit is contained in:
gamer147
2026-08-03 10:19:51 -04:00
parent cb21a34bee
commit d5b9604ce0
4 changed files with 49 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/PROJECT-STRUCTURE.md
View File

@@ -165,7 +165,9 @@ implementations. `engine/Age.Engine/Hosting/IDiagnosticHost.cs` owns recoverable
reporting contracts, while `engine/Age.Engine/Hosting/ILifecycleHost.cs` owns script-context entry/exit, sleep and
timed-deadline waiting, frame yield, and scene reset. `engine/Age.Engine/Hosting/IAudioHost.cs` owns BGM, voice,
SFX, fade, volume, and route-control contracts, including the compatibility overload/default chains used by
simple hosts. `IHost` inherits all three focused contracts; their required and default behavior is unchanged.
simple hosts. `engine/Age.Engine/Hosting/IMovieHost.cs` owns ordinary, positioned, mask-transition, activity-query,
and modal movie playback contracts. `IHost` inherits all four focused contracts; their required and default
behavior is unchanged, and movie/graphics transport records remain in their existing locations for now.
`engine/Age.Engine/Model/GfxState.cs` retains cross-domain retained-graphics coordination.
`engine/Age.Engine/Model/GfxState.Contracts.cs` owns its public render, transition, diagnostic, persistence,

14
docs/remake-architecture-and-roadmap.md
View File

@@ -770,6 +770,12 @@ do not mix mechanical moves with semantic changes.
compatibility overloads/default chains, and existing host classes remain behaviorally unchanged. Runtime
validation remains green.
The third bounded contract slice introduced `IMovieHost` for ordinary, positioned, mask-transition, activity
queries for movie surfaces, and modal playback. `IHost` inherits the focused contract; all five default
members and existing host classes remain behaviorally unchanged. `GfxState` and
`MovieMaskTransitionRequest` remain in their prior locations pending a separate dependency-cleanup slice.
Runtime validation remains green.
4. **Make the build graph express source ownership.** Stop linking production `.cs` files from `godot/` and
`tools/movie-corpus-gate/` into `Age.Engine.Tests`. Extract the platform-neutral frontend/movie/diagnostic
code into a small production project referenced by Godot, tests, and the corpus gate. Retain both existing
@@ -1129,9 +1135,9 @@ layer's rendering diverges from ADV; save layout.
## 8. Immediate next step
Continue step 3 of the **codebase consolidation** maintenance slice: clarify runtime contracts without changing
behavior or the aggregate host accepted by the VM. With diagnostic, lifecycle, and audio contracts established
beneath `IHost`, introduce the movie host contract next while leaving movie request/graphics transport records in
their current locations for a separate dependency-cleanup slice; preserve every required/default member and all
existing host implementations.
behavior or the aggregate host accepted by the VM. With diagnostic, lifecycle, audio, and movie contracts
established beneath `IHost`, move the neutral `MovieMaskTransitionRequest` contract from `Hosting` to `Model` next
to remove `GfxState`'s reverse dependency on the host namespace, preserving the record's public shape and every
consumer before separating larger host domains.
Concrete playthrough blockers may still preempt this bounded maintenance work; the consolidation effort does
not replace Phase B gameplay validation or the open cross-platform gates.