mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-11-17 23:13:22 +09:00
Two things land together: the plan and contract draft P6 needs before it starts, and the
working notes that until now existed on exactly one machine.
1. P6's plan and contract draft (neither started; not one line of code)
docs/Disaggregated/P6-SPAWN-PLAN.md the package plan
docs/Disaggregated/P6-CONTRACT-DRAFT.md the contract draft (moves to
MG_Remote/CONTRACT-P6.md when c6 lands)
The three findings that mattered, all written into the documents:
a. P6 is SMALLER than its roadmap cell suggests. The transport primitives are already in
the tree and already tested: SocketDoorbell including hangup detection and the two
lost-wakeup fences (Doorbell.cpp:211-360, four cases in FdPassingTest), SCM_RIGHTS fd
passing, ShmSegment::Adopt, and the SurfaceOp / WindowKind schema already defined in
protocol.fbs. inproc uses a real second shm mapping rather than an alias, and
SessionRings.h:22-28 says that was done so today is not the first time it runs. P6 is
assembly plus a control plane plus a process, not "write a socket transport".
b. The evidence for "P6 is only a transport swap" has EXPIRED. It was bought by P5c, whose
audit found 59 direct memory accesses in a tree that already looked clean. P5e changed
the tree again. So the first package, a6, is a read-only audit that writes no code, and
every contract row that depends on it is marked PENDING a6 rather than decided in
advance.
c. P6 does not get a game running on the phone. ANativeWindow* is meaningless in the child,
and protocol.fbs:186-196's own comment says Android transfers the window out of band -
that band is P12. P6 lands pbuffer / surfaceless / offscreen, which is what HeadlessGL,
the split-equivalent lane and trace replay need, and which is exactly what P6's own exit
gate measures. A real window reaching the server is a named refusal. This gets its own
section because "P6 is done" would otherwise read as "the game runs now".
The contract adds rule G: a role may not name a process-local handle. It extends P5c's
rule E (a role may not name the other role's memory) from memory to identity - EGLDisplay /
EGLSurface / EGLContext / ANativeWindow* / fd number / pid / mapped address either cross as
a token this contract defines or they do not cross, and a descriptor crosses only through
SCM_RIGHTS, where the kernel renumbers it.
What P5e left for P6 gets its own section. The latch semantics are already designed
(ARCHITECTURE.md:504) and are copied unchanged. What is new is that after run-ahead the
client no longer waits while the peer process can DIE: the client holds records that were
published and will never be applied, and Android's freezer suspends the child without
closing anything. So slow and dead must be distinguishable WITHOUT a timeout threshold.
That is P6's only new design; everything else is carriage. It shares a predicate with E1's
outstanding re-specification (ID-122), and the two should be designed together.
Two gates carried over from P5e's lessons: G2 requires integration-spawn's test-name set to
match integration-split's name for name, because a differing set means the lane is quietly
running less; and the arm-proof gate requires every entry to record the child pid and
transport=spawn in its OWN private log - ID-124 established that this kind of false green
really happens, and a spawn lane that actually ran monolith would pass every other gate.
S2's shape must be settled before it is written, and the document says why: E1 is the
cautionary case.
2. The working notes move into the repository (docs/Disaggregated/notes/, 415 .md files)
ROADMAP / CURRENT_STAGE_PROGRESS / MEASUREMENTS cite ruling numbers, audit line numbers and
the provenance of gate figures from ~/w7/notes/, a directory that exists on one machine and
is under no version control. A record cited hundreds of times that lives only locally is not
a record, so it moves in whole, with its directory structure intact.
Only .md moves. Scripts, run logs, census and gate result JSON, patches, APKs and nm dumps
stay where they are: they are evidence DATA rather than documents - large, regenerated per
run, and mostly carrying absolute paths and device serials that mean something only on the
machine that produced them. The mapping and this split are written in
docs/Disaggregated/notes/README.md.
Two exceptions are recorded there too: P6's BRIEF has been promoted to a first-class
document and keeps no copy under notes/, so the two cannot drift apart; and recovered/ holds
material salvaged from failed workflow runs, which may duplicate the like-named phase
directories and is kept because a few of those were the only complete version at the time.
CI's citation lint takes docs/Disaggregated/*.md only (non-recursive), and notes/ is
deliberately outside it: those notes' file:line citations were written against their own
code heads, and resolving them against today's HEAD would fail wholesale - which is not an
error, it is their correct state as a historical record. To check one, use the revision it
declares (--rev).
3. Inconsistencies fixed in passing
- README.md's status line still said P5e was in progress while the stage table already said
closed.
- CURRENT_STAGE_PROGRESS's next-step item 1 still listed the exit gate as pending, though
(a) and (b) were run in the previous commit; rewritten to closed plus the one item that
actually remains (E1).
- ROADMAP's P6 row still had the pre-phase plan in three of its cells; it now carries the
package order, the scope boundary and the two new gates.
Checked with check_doc_citations.py: 125 citations across docs/Disaggregated/*.md, 0 problems.
176 lines
12 KiB
Markdown
176 lines
12 KiB
Markdown
# P5b joint Codex evidence — 2026-09-16
|
||
|
||
<!-- BEGIN CODEX CENSUS -->
|
||
## Inproc census — merged head, lane default 32 MiB / traces explicit 256 MiB
|
||
|
||
Head: `348d22a4b9c15cc571af840dedc4b4edc8c53dbb`. Evidence directory: `/home/swung/w7/p5b-final-census-348d22a4`.
|
||
|
||
Frozen libMobileGL SHA256: `50fecb248368a4de02d7f51d4229c4ebac555b3bea18d3a22398c1247d2a28c4`. `identity.json` records the head, all frozen executables/scripts, hashes and explicit profiles.
|
||
|
||
The single complete integration census is the final gate’s inproc debt arm. No second full
|
||
inproc ctest run was used for these numbers. Each case has its own fresh log; static fixture
|
||
intersections are not execution evidence. Missing fixtures/results, zero cases and timeouts
|
||
are not passes.
|
||
|
||
### Integration lane — stage 32 MiB
|
||
|
||
Final **1267** exact manifest entries: **62 aborted / 191 failed / 811 passed / 203 skipped**.
|
||
|
||
Baseline c0b is 432 passed / 185 skipped / 505 aborted / 27 failed (1149 entries).
|
||
Exact-name join: 1149 retained, 118 added, 0 removed. Previously passing entries now failed/aborted: 0.
|
||
|
||
| c0b status | Final status | Matched entries |
|
||
|---|---|---:|
|
||
| aborted | aborted | 58 |
|
||
| aborted | failed | 164 |
|
||
| aborted | passed | 265 |
|
||
| aborted | skipped | 18 |
|
||
| failed | failed | 26 |
|
||
| failed | passed | 1 |
|
||
| passed | passed | 432 |
|
||
| skipped | skipped | 185 |
|
||
|
||
All exact names, including additions/removals, are in `lane-transitions.md` and
|
||
`lane-transitions.json` beside `identity.json`. Final first-blocker distribution:
|
||
|
||
| Outcome / first blocker | Entries |
|
||
|---|---:|
|
||
| passed | 811 |
|
||
| skipped | 203 |
|
||
| failed | 191 |
|
||
| UnmigratedEmulation, "texture-remint-pull" | 46 |
|
||
| UnmigratedVerb, "CopyImageSubData+RENDERBUFFER" | 5 |
|
||
| UnmigratedVerb, "ClearNamedFramebufferfv+UNBOUND" | 3 |
|
||
| UnmigratedVerb, "DeleteTransformFeedback" | 2 |
|
||
| UnmigratedVerb, "MultiDrawElementsBaseVertex+CLIENT_INDICES" | 2 |
|
||
| UnimplementedWritebackWait | 1 |
|
||
| UnmigratedVerb, "ClearNamedFramebufferfi+UNBOUND" | 1 |
|
||
| UnmigratedVerb, "ClearNamedFramebufferiv+UNBOUND" | 1 |
|
||
| UnmigratedVerb, "ClearNamedFramebufferuiv+UNBOUND" | 1 |
|
||
|
||
### Complete trace census — stage 256 MiB
|
||
|
||
**79** backend entries: **6 aborted / 1 failed / 72 passed**. This inventory includes OpenRA and honors each fixture’s declared ci_backends.
|
||
|
||
Production staging remains 32 MiB. The 256 MiB profile is authorized for real workloads
|
||
with a 128 MiB upload; a profile-assisted success is not evidence that default-capacity debt
|
||
was fixed. Standalone d1’s stage32 baseline had 28 passes / 49 failures over 77 Minecraft
|
||
entries, including SEG_STAGE failures on GLES iterationt and iterationt-nodsa. r1’s retirement
|
||
wait fix and a larger capacity address different conditions and are not merged in attribution.
|
||
|
||
| Fixture | Backend | Final outcome / first blocker | SSIM |
|
||
|---|---|---|---|
|
||
| OpenRA | DirectGLES | passed | 1.0 |
|
||
| OpenRA | DirectVulkan | passed | 1.0 |
|
||
| improved-transparency-minecraft-26.3 | DirectGLES | passed | 1.0 |
|
||
| improved-transparency-minecraft-26.3 | DirectVulkan | passed | 0.999914064 |
|
||
| minecraft-1.17-main-menu-854 | DirectGLES | passed | 0.9999616 |
|
||
| minecraft-1.17-main-menu-854 | DirectVulkan | passed | 0.99996113 |
|
||
| minecraft-1.21.1-neoforge-create-indirect-in-world | DirectGLES | UnmigratedEmulation, "texture-remint-pull" | — |
|
||
| minecraft-1.21.1-neoforge-create-indirect-in-world | DirectVulkan | failed | — |
|
||
| minecraft-1.21.1-neoforge-create-instancing-in-world | DirectGLES | passed | 0.999957572 |
|
||
| minecraft-1.21.1-neoforge-create-instancing-in-world | DirectVulkan | passed | 0.99995247 |
|
||
| minecraft-1.21.11-main-menu | DirectGLES | passed | 0.993474922 |
|
||
| minecraft-1.21.11-main-menu | DirectVulkan | passed | 0.99347492 |
|
||
| minecraft-1.21.4-fabric-common-mods-in-world | DirectGLES | passed | 0.999947917 |
|
||
| minecraft-1.21.4-fabric-common-mods-in-world | DirectVulkan | passed | 0.999947917 |
|
||
| minecraft-1.21.4-fabric-common-mods-inventory | DirectGLES | passed | 0.999996158 |
|
||
| minecraft-1.21.4-fabric-common-mods-inventory | DirectVulkan | passed | 0.999996158 |
|
||
| minecraft-1.21.4-fabric-iris-bliss-in-world | DirectGLES | passed | 0.998057535 |
|
||
| minecraft-1.21.4-fabric-iris-bliss-in-world | DirectVulkan | passed | 0.997986272 |
|
||
| minecraft-1.21.4-fabric-iris-bsl-esc-menu-854 | DirectGLES | InitialBytesNotCarried, "resource_respecify" | — |
|
||
| minecraft-1.21.4-fabric-iris-bsl-esc-menu-854 | DirectVulkan | passed | 0.998402027 |
|
||
| minecraft-1.21.4-fabric-iris-bsl-in-world | DirectGLES | passed | 0.997496023 |
|
||
| minecraft-1.21.4-fabric-iris-bsl-in-world | DirectVulkan | passed | 0.997324199 |
|
||
| minecraft-1.21.4-fabric-iris-chocapic-v6-lite-in-world | DirectGLES | passed | 0.999992296 |
|
||
| minecraft-1.21.4-fabric-iris-chocapic-v6-lite-in-world | DirectVulkan | passed | 0.99575325 |
|
||
| minecraft-1.21.4-fabric-iris-complementary-reimagined-in-world | DirectGLES | passed | 0.999503181 |
|
||
| minecraft-1.21.4-fabric-iris-complementary-reimagined-in-world | DirectVulkan | passed | 0.99929651 |
|
||
| minecraft-1.21.4-fabric-iris-complementary-unbound-in-world | DirectGLES | passed | 0.999478525 |
|
||
| minecraft-1.21.4-fabric-iris-complementary-unbound-in-world | DirectVulkan | passed | 0.999244084 |
|
||
| minecraft-1.21.4-fabric-iris-derivative-main-d24.4.14-in-world | DirectGLES | UnmigratedEmulation, "texture-remint-pull" | — |
|
||
| minecraft-1.21.4-fabric-iris-derivative-main-d24.4.14-in-world | DirectVulkan | passed | 0.996658574 |
|
||
| minecraft-1.21.4-fabric-iris-iterationrp-in-world | DirectVulkan | passed | 0.995833421 |
|
||
| minecraft-1.21.4-fabric-iris-iterationt-in-world | DirectGLES | passed | 0.997752215 |
|
||
| minecraft-1.21.4-fabric-iris-iterationt-in-world | DirectVulkan | passed | 0.999198504 |
|
||
| minecraft-1.21.4-fabric-iris-iterationt-nodsa-in-world | DirectGLES | passed | 0.995919679 |
|
||
| minecraft-1.21.4-fabric-iris-iterationt-nodsa-in-world | DirectVulkan | passed | 0.99864077 |
|
||
| minecraft-1.21.4-fabric-iris-makeup-ultrafast-in-world | DirectGLES | passed | 0.99542552 |
|
||
| minecraft-1.21.4-fabric-iris-makeup-ultrafast-in-world | DirectVulkan | passed | 0.996629722 |
|
||
| minecraft-1.21.4-fabric-iris-mellow-in-world | DirectGLES | passed | 0.999822891 |
|
||
| minecraft-1.21.4-fabric-iris-mellow-in-world | DirectVulkan | passed | 0.999312266 |
|
||
| minecraft-1.21.4-fabric-iris-nostalgia-in-world | DirectGLES | passed | 0.999988313 |
|
||
| minecraft-1.21.4-fabric-iris-nostalgia-in-world | DirectVulkan | passed | 0.999983572 |
|
||
| minecraft-1.21.4-fabric-iris-photon-v1.1-in-world | DirectGLES | passed | 0.999135212 |
|
||
| minecraft-1.21.4-fabric-iris-photon-v1.1-in-world | DirectVulkan | passed | 0.998781357 |
|
||
| minecraft-1.21.4-fabric-iris-photon-v1.3b-in-world | DirectGLES | UnmigratedEmulation, "texture-remint-pull" | — |
|
||
| minecraft-1.21.4-fabric-iris-photon-v1.3b-in-world | DirectVulkan | passed | 0.998529629 |
|
||
| minecraft-1.21.4-fabric-iris-sundial-lite-in-world | DirectGLES | passed | 0.996300657 |
|
||
| minecraft-1.21.4-fabric-iris-sundial-lite-in-world | DirectVulkan | passed | 0.996284254 |
|
||
| minecraft-1.21.4-fabric-iris-super-duper-vanilla-in-world | DirectGLES | passed | 0.999643966 |
|
||
| minecraft-1.21.4-fabric-iris-super-duper-vanilla-in-world | DirectVulkan | passed | 0.999439052 |
|
||
| minecraft-1.21.4-fabric-journeymap-in-world-normal-world | DirectGLES | passed | 0.99997899 |
|
||
| minecraft-1.21.4-fabric-journeymap-in-world-normal-world | DirectVulkan | passed | 0.99997899 |
|
||
| minecraft-1.21.4-fabric-journeymap-in-world | DirectGLES | passed | 0.999984122 |
|
||
| minecraft-1.21.4-fabric-journeymap-in-world | DirectVulkan | passed | 0.999984122 |
|
||
| minecraft-1.21.4-fabric-modernui-inventory-normal-world | DirectGLES | passed | 0.999997315 |
|
||
| minecraft-1.21.4-fabric-modernui-inventory-normal-world | DirectVulkan | passed | 0.999997292 |
|
||
| minecraft-1.21.4-fabric-modernui-inventory | DirectGLES | passed | 0.999996645 |
|
||
| minecraft-1.21.4-fabric-modernui-inventory | DirectVulkan | passed | 0.999996645 |
|
||
| minecraft-1.21.4-fabric-rei-inventory-normal-world | DirectGLES | passed | 0.99998801 |
|
||
| minecraft-1.21.4-fabric-rei-inventory-normal-world | DirectVulkan | passed | 0.99998801 |
|
||
| minecraft-1.21.4-fabric-rei-inventory | DirectGLES | passed | 0.999989912 |
|
||
| minecraft-1.21.4-fabric-rei-inventory | DirectVulkan | passed | 0.999989912 |
|
||
| minecraft-1.21.4-fabric-sodium-in-world | DirectGLES | passed | 0.999985623 |
|
||
| minecraft-1.21.4-fabric-sodium-in-world | DirectVulkan | passed | 0.999986092 |
|
||
| minecraft-1.21.4-fabric-xaero-minimap-in-world-normal-world | DirectGLES | passed | 0.999991832 |
|
||
| minecraft-1.21.4-fabric-xaero-minimap-in-world-normal-world | DirectVulkan | passed | 0.999991832 |
|
||
| minecraft-1.21.4-fabric-xaero-minimap-in-world | DirectGLES | passed | 0.999999456 |
|
||
| minecraft-1.21.4-fabric-xaero-minimap-in-world | DirectVulkan | passed | 0.999999456 |
|
||
| minecraft-1.21.4-fabric-xaero-world-map-in-world-normal-world | DirectGLES | passed | 0.999995376 |
|
||
| minecraft-1.21.4-fabric-xaero-world-map-in-world-normal-world | DirectVulkan | passed | 0.999995376 |
|
||
| minecraft-1.21.4-fabric-xaero-world-map-in-world | DirectGLES | passed | 0.999999823 |
|
||
| minecraft-1.21.4-fabric-xaero-world-map-in-world | DirectVulkan | passed | 0.999999823 |
|
||
| minecraft-1.21.4-in-world | DirectGLES | passed | 0.999976222 |
|
||
| minecraft-1.21.4-in-world | DirectVulkan | passed | 0.999976105 |
|
||
| minecraft-1.21.4-main-menu | DirectGLES | passed | 0.997008676 |
|
||
| minecraft-1.21.4-main-menu | DirectVulkan | passed | 0.99700863 |
|
||
| minecraft-1.21.4-rd12-odinlite-in-world | DirectGLES | InitialBytesNotCarried, "resource_respecify" | — |
|
||
| minecraft-1.21.4-rd12-odinlite-in-world | DirectVulkan | BarrierTimeout, "Present" | — |
|
||
| minecraft-1.21.4-startup | DirectGLES | passed | 0.999999662 |
|
||
| minecraft-1.21.4-startup | DirectVulkan | passed | 0.999999662 |
|
||
|
||
`trace-transitions.json` maps all names to standalone d1’s first blocker and carries both
|
||
profile sizes. Every result links its actual private log and result.json in the isolated
|
||
trace output directory. A new first blocker counts as progress, never as rendered success.
|
||
|
||
<!-- END CODEX CENSUS -->
|
||
|
||
<!-- BEGIN CODEX HOST DOCS -->
|
||
## Host gate and documentation — pending final replay/device evidence
|
||
|
||
The one host gate is pinned to `348d22a4b9c15cc571af840dedc4b4edc8c53dbb`.
|
||
Authoritative directory: `/home/swung/w7/p5b-final-host-348d22a4/`;
|
||
`head.txt`, `libraries.sha256`, `status.tsv`, complete per-lane JUnit,
|
||
`summary-counts.json` and `summary-counts.md` distinguish selection from actual passes/skips.
|
||
The completed split lane is 107 selected = 105 passed + 2 skipped, zero failures.
|
||
The host replay runner is still in flight; no complete verdict is asserted here.
|
||
|
||
A runner execution anomaly is retained separately: appending an archive command while Bash
|
||
was reading the live runner produced one `-test-dir: command not found` line (original session
|
||
87762; outer shell lacked set-e). It is not classified as a required-test failure. The verify
|
||
and audit lanes have complete independent JUnit and recorded step rc=0; E2 then ran normally.
|
||
The E1/E3 private logs were already copied successfully to `negative-private-logs` manually.
|
||
Final required-step inventory, JUnit counts and replay counts must show no omitted step;
|
||
a final shell exit alone is not the proof. No repeated full gate is requested.
|
||
|
||
Three tree documents are prepared in independent `/home/swung/w7/p5b-docs-final-codex`, branch
|
||
`p5b/docs-final-codex`, based on `348d22a4`. They separate package evidence (§32), the one host
|
||
gate and combined census (§33), the one phase review plus targeted repairs (§34), and the final
|
||
Redmi exit/four-arm measurements (§35). Default stage remains 32 MiB; real-workload trace and
|
||
all four device arms explicitly use a 256 MiB profile. No final device/source identity or
|
||
successful P5b exit is filled in before the integrator sends DEVICE_DONE and sourcehead.
|
||
|
||
Documentation commit: pending final host/census/targeted-closure/device evidence.
|
||
<!-- END CODEX HOST DOCS -->
|