Skip to content

iOS: cut idle memory and startup cost in the Metal renderer and the VM - #5598

Merged
shai-almog merged 7 commits into
masterfrom
ios-memory-perf
Aug 25, 2026
Merged

iOS: cut idle memory and startup cost in the Metal renderer and the VM#5598
shai-almog merged 7 commits into
masterfrom
ios-memory-perf

Conversation

@shai-almog

Copy link
Copy Markdown
Collaborator

What this is

Six independent memory/startup fixes in the iOS Metal renderer and the VM, plus
the diagnostics that found them. Four are default-on, one is opt-in, and the
tooling is compiled out unless you define it.

Every number below is a paired A/B inside a single binary, toggled by an env
var. That matters more than it sounds: the same binary's physical footprint
varies by tens of megabytes between launches depending on machine state, so
"measure, change code, measure again" cannot resolve a 5MB effect and will
happily report noise as a win. Two of the fixes below were previously dismissed
on exactly that kind of measurement.

Default-on

Stencil attachments become Memoryless on tile-based GPUs. Every pass that
binds the stencil is already loadAction=Clear / storeAction=DontCare, which
is precisely the Memoryless contract. The code chose Private and reasoned the
cost was "tiny (1 byte/pixel)" — it is 5.6MB per allocation at 2048x1536.
~3.8MB, 3/3 paired reps, Metal validation clean. Intel Macs and the
Intel-Mac CI simulators keep Private via a runtime family probe.

The glyph atlas starts at 256x256 rather than 1024x1024. The atlas cache
keys on postScriptName|SIZE, so every distinct text size reserved a megabyte
of R8 before rasterising a single glyph — and a Material-style text theme has
fifteen of them across two or three families. tryGrowAtlas already doubles on
demand and correctly drops slots so the next reference re-rasterises, so
starting small is self-correcting. 6.19MB -> 0.47MB, and no atlas in the
test app ever needed to grow.

cn1SetupMetal no longer sizes the framebuffer before layout. It read
self.bounds, and an unlaid-out view reports the whole display: every launch
allocated a 3456x2234 / 30MB screen texture, cleared it, blitted it into the
real 2048x1536 one and threw it away. layoutSubviews always follows and sizes
it correctly, and createRenderPassDescriptor already treats a nil
screenTexture as "no frame this pass". ~14MB, and it removes a +-20MB
launch-to-launch swing that was making every other measurement in this area
untrustworthy.

Eager accessibility projection is gated on assistive technology running.
The port sets isAccessibilityTreeSupported() = true and never overrode
isAccessibilityTreeUpdateRequired(), which defaults to returning it — so the
portable semantic tree was rebuilt on every invalidation: every layout,
every scroll, every text setter, on every device, whether or not VoiceOver was
listening. The base class documents the opposite for pull-based ports, and UIKit
pulls. Measured at 4.0MB of live allocation on an idle app with no assistive
technology running at all, ~6MB of footprint, plus the CPU to build it.
Turning VoiceOver on mid-session is picked up on the next invalidation.

This last one affects every Codename One iOS application, not only the one it
was found on.

Opt-in: CN1_DIRECT_DRAWABLE=1

A direct-to-drawable path with no retained screen texture — the frame's pass
targets the drawable itself and present is a bare presentDrawable with no
blit. ~8-11MB and ~11ms off first frame (13 paired reps, t = 2.74, lower in
11/13).

The layer vends a different buffer each frame, so partial repaint is incorrect
there — a region left unpainted shows a frame from two or three presents ago.
IOSImplementation.paintDirty therefore enqueues the whole Form whenever
anything is dirty, reusing two behaviours that already exist rather than
rewriting paintDirty: a component queued with a null dirty region already
paints under a full-screen clip, and repaint(Animation) already drops a child
whose ancestor is queued, so it collapses the queue instead of growing it.
isDirectToDrawable() asks the renderer rather than deciding independently, so
the two halves cannot disagree about which buffer is being drawn into.

It also sets maximumDrawableCount to 2 in that mode only, where the third
slot really is taken (21.8MB vs a 21.8/27.2MB swing). The cap is inert in the
retained path — that was measured twice, and the comment now says so.

Diagnostics (compiled out unless defined)

CN1_ALLOC_CENSUS — allocation volume by class, counted at all three
allocation entry points, so unlike a walk of allObjectsInHeap it does not
silently miss the BiBOP and nursery objects, which is exactly where small
high-churn objects live. Plus cn1HeapAccounting, which separates Java-object
storage from native allocation — vmmap cannot, because BiBOP arenas and every
Metal/CoreGraphics buffer share the same malloc zones.

CN1_TEXTURE_CENSUS — GPU memory by creation site, logging each large texture's
true dimensions. Dimensions matter: a per-site cumulative total divided by its
allocation count invents a texture that does not exist, and that fabricated
figure sent me down a wrong path until the real sizes were printed.

CN1_VERIFY_PRESENT — reads back a patch of the drawable actually being
presented
. This is the only thing that can prove a renderer change did not
blank the screen: with a nil drawable the render pass is nil, every op no-ops
against a null encoder, and Metal validation stays clean while FIRSTFRAME
still prints. An offscreen repaint-based screenshot cannot catch it either,
because it repaints the scene graph instead of reading the framebuffer.

Verification

  • hellocodenameone builds as a Mac native target with zero errors, both
    with default settings and with all three diagnostics defined (the latter is
    necessary — a default build compiles straight past the guarded code).
  • Metal API validation clean in both render paths.
  • Retained and direct paths produce the identical presented-frame hash.

🤖 Generated with Claude Code

Six independent fixes, each measured with a paired A/B inside one binary
(separate builds cannot resolve these: the same binary's footprint varies by
tens of megabytes between launches depending on machine state, which is how
several of these went unnoticed).

Default-on:

* Stencil attachments become Memoryless on tile-based GPUs. Every pass that
  binds the stencil is already loadAction=Clear / storeAction=DontCare, which
  is exactly the Memoryless contract; the code chose Private and reasoned the
  cost was "tiny (1 byte/pixel)". It is 5.6MB per allocation at 2048x1536.
  Worth ~3.8MB, 3/3 paired reps, Metal validation clean. Intel Macs and the
  Intel-Mac CI simulators still get Private via a runtime family probe.

* The glyph atlas starts at 256x256 instead of 1024x1024. The atlas cache keys
  on postScriptName|SIZE, so every distinct text size reserved a megabyte of R8
  before rasterising a single glyph, and a Material-style text theme has fifteen
  of them. tryGrowAtlas already doubles on demand and re-rasterises correctly,
  so starting small is self-correcting. 6.19MB -> 0.47MB, and no atlas in the
  test app ever needed to grow.

* cn1SetupMetal no longer sizes the framebuffer from self.bounds before layout.
  An unlaid-out view reports the whole DISPLAY, so every launch allocated a
  3456x2234 / 30MB screen texture, cleared it, blitted it into the real
  2048x1536 one and threw it away. layoutSubviews always follows and sizes it
  correctly. Worth ~14MB, and it removes a +-20MB launch-to-launch swing that
  made every other memory measurement in this area unreliable.

* Eager accessibility projection is gated on assistive technology actually
  running. The port sets isAccessibilityTreeSupported() = true and never
  overrode isAccessibilityTreeUpdateRequired(), which defaults to returning it,
  so the portable semantic tree was rebuilt on EVERY invalidation -- every
  layout, every scroll, every text setter -- on every device, whether or not
  VoiceOver was listening. The base class documents the opposite for pull-based
  ports, and UIKit pulls. 4.0MB of live allocation on an idle app with no
  assistive technology, ~6MB of footprint, plus the CPU to build it.

Opt-in (CN1_DIRECT_DRAWABLE=1):

* A direct-to-drawable render path with no retained screen texture: the frame's
  pass targets the drawable itself and present is a bare presentDrawable with no
  blit. Because the layer vends a different buffer each frame, partial repaint
  is incorrect there, so IOSImplementation.paintDirty enqueues the whole Form
  whenever anything is dirty -- reusing two existing behaviours rather than
  rewriting paintDirty. Worth ~8-11MB and ~11ms off first frame. Also sets
  maximumDrawableCount to 2 in that mode only, where the third slot really is
  taken (the cap is inert in the retained path).

Diagnostics, compiled out unless defined:

* CN1_ALLOC_CENSUS -- allocation volume by class, counted at all three
  allocation entry points so it does not silently miss the BiBOP and nursery
  objects a walk of allObjectsInHeap cannot see, plus cn1HeapAccounting, which
  separates Java-object storage from native allocation (vmmap cannot: BiBOP
  arenas and every Metal/CG buffer share the same malloc zones).

* CN1_TEXTURE_CENSUS -- GPU memory by creation site with each large texture's
  true dimensions, and CN1_VERIFY_PRESENT, which reads back a patch of the
  drawable actually being presented. That last one matters: a renderer change
  can leave the screen blank while Metal validation stays clean and an
  offscreen repaint-based screenshot still looks perfect.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1451368cd6

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread Ports/iOSPort/nativeSources/METALView.m Outdated
Comment thread Ports/iOSPort/src/com/codename1/impl/ios/IOSImplementation.java
Comment thread Ports/iOSPort/nativeSources/IOSNative.m Outdated
Comment thread Ports/iOSPort/nativeSources/METALView.m
… probe

General ParparVM memory/startup work that has been sitting unmerged, plus the
fixes for the first review pass.

* Lazy string constant pool. Every string constant in the binary was
  materialised into a java.lang.String before main ran -- on a large transpiled
  application, 38,238 of them. They are now created on first reference.

* The force-visited table allocates its entries from arena blocks and prunes on
  sweep, instead of growing without bound and doing per-entry allocation on the
  hot path.

* CN1_STARTUP_PHASES, a compiled-out probe that times the phases before the
  first frame, and the heap histogram alongside the allocation census.

Review fixes:

* cn1StencilStorageMode probes respondsToSelector: before sending
  supportsFamily:. That selector is iOS 13, ios.deployment_target is a build
  hint, and IPhoneBuilder will emit targets well below it -- where the message
  would have terminated the app during view initialisation.

* updateFrameBufferSize: returns early in direct mode instead of building a
  render pass with a nil colour attachment and no explicit dimensions. That is
  invalid Metal; it survived only because the encoder came back nil and every
  message to it was a no-op. The polygon-clip stencil both paths need is
  factored into buildStencilTextureForWidth:height:layer:.

* The assistive-technology check adds AssistiveTouch, and the VoiceOver /
  SwitchControl / AssistiveTouch status notifications now force a projection.
  Without that the native tree -- which is push-only, populated solely by
  accessibilityTreeChanged -> updateAccessibilityTree -- stayed empty when a
  technology started after a static screen was already up.

  UIKit publishes running flags for exactly those three and nothing else, so no
  flag can describe Voice Control or Full Keyboard Access. Rather than leave
  those users without a tree, any status notification latches eager projection
  on for the rest of the process: one process's worth of projection is the right
  side to err on for an accessibility feature.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@github-actions

github-actions Bot commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

✅ Continuous Quality Report

Test & Coverage

Static Analysis

  • SpotBugs [Report archive]
    • ByteCodeTranslator: 0 findings (no issues)
    • android: 0 findings (no issues)
    • codenameone-maven-plugin: 0 findings (no issues)
    • core-unittests: 0 findings (no issues)
    • ios: 0 findings (no issues)
  • PMD: 0 findings (no issues) [Report archive]
  • Checkstyle: 0 findings (no issues) [Report archive]

Generated automatically by the PR CI workflow.

@github-actions

Copy link
Copy Markdown
Contributor

Cloudflare Preview

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 79971b3cce

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread Ports/iOSPort/nativeSources/IOSNative.m Outdated
Comment thread Ports/iOSPort/nativeSources/METALView.m
@shai-almog

shai-almog commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator Author

Compared 149 screenshots: 149 matched.
Native Windows port (x64 / Intel-AMD): full hellocodenameone screenshot suite rendered offscreen with Direct2D/DirectWrite, plus the real benchmarks (base64 native/CN1/SIMD, image createMask/applyMask/modifyAlpha/PNG/JPEG, SSE2 SIMD kernels). Compared against the in-repo baseline in scripts/windows/screenshots.

Benchmark Results

Detailed Performance Metrics

Metric Duration
SIMD kernel backend SSE2 (x64) / NEON (arm64) native kernels
SIMD int-add (64K x300) java 64ms / native 5ms = 12.8x speedup
SIMD float-mul (64K x300) java 75ms / native 5ms = 15.0x speedup
SIMD kernel correctness PASS (native result == scalar reference)
Base64 native bridge unavailable (CN1 + SIMD + image benchmarks only)
Base64 payload size 8192 bytes
Base64 benchmark iterations 6000
Base64 SIMD byte path gated to scalar (CPU autovectorizes scalar; explicit SIMD not beneficial here)
Base64 CN1 encode 197.000 ms
Base64 CN1 decode 136.000 ms
Base64 SIMD encode 102.000 ms
Base64 encode ratio (SIMD/CN1) 0.518x (48.2% faster)
Base64 SIMD decode 104.000 ms
Base64 decode ratio (SIMD/CN1) 0.765x (23.5% faster)
Image encode benchmark iterations 100
Image createMask (SIMD off) 29.000 ms
Image createMask (SIMD on) 68.000 ms
Image createMask ratio (SIMD on/off) 2.345x (134.5% slower)
Image applyMask (SIMD off) 77.000 ms
Image applyMask (SIMD on) 48.000 ms
Image applyMask ratio (SIMD on/off) 0.623x (37.7% faster)
Image modifyAlpha (SIMD off) 49.000 ms
Image modifyAlpha (SIMD on) 35.000 ms
Image modifyAlpha ratio (SIMD on/off) 0.714x (28.6% faster)
Image modifyAlpha removeColor (SIMD off) 50.000 ms
Image modifyAlpha removeColor (SIMD on) 37.000 ms
Image modifyAlpha removeColor ratio (SIMD on/off) 0.740x (26.0% faster)

@github-actions

github-actions Bot commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

✅ ByteCodeTranslator Quality Report

Test & Coverage

  • Tests: 528 total, 0 failed, 54 skipped

Benchmark Results

  • Execution Time: 13961 ms

  • Hotspots (Top 20 sampled methods):

    • 22.26% com.codename1.tools.translator.Parser.addToConstantPool (303 samples)
    • 6.39% java.util.ArrayList.indexOf (87 samples)
    • 4.19% com.codename1.tools.translator.ByteCodeClass.fillVirtualMethodTable (57 samples)
    • 3.38% com.codename1.tools.translator.Parser.cn1EnsureSubclassIndex (46 samples)
    • 3.16% com.codename1.tools.translator.ByteCodeClass.hasDeclaredMethod (43 samples)
    • 2.28% com.codename1.tools.translator.Parser.classIndex (31 samples)
    • 2.20% com.codename1.tools.translator.BytecodeMethod.optimize (30 samples)
    • 2.13% org.objectweb.asm.tree.analysis.Analyzer.analyze (29 samples)
    • 2.06% java.lang.Object.hashCode (28 samples)
    • 1.91% java.lang.System.identityHashCode (26 samples)
    • 1.91% java.lang.StringBuilder.append (26 samples)
    • 1.62% com.codename1.tools.translator.bytecodes.Invoke.resolveDirectTarget (22 samples)
    • 1.54% com.codename1.tools.translator.BytecodeMethod.equals (21 samples)
    • 1.25% java.lang.String.equals (17 samples)
    • 1.25% java.util.HashMap.hash (17 samples)
    • 1.18% java.io.UnixFileSystem.getBooleanAttributes0 (16 samples)
    • 1.10% org.objectweb.asm.tree.analysis.Analyzer.findSubroutine (15 samples)
    • 1.03% sun.nio.fs.UnixNativeDispatcher.open0 (14 samples)
    • 0.96% com.codename1.tools.translator.BytecodeMethod.addInstruction (13 samples)
    • 0.96% com.codename1.tools.translator.Parser.generateClassAndMethodIndexHeader (13 samples)
  • ⚠️ Coverage report not generated.

Static Analysis

  • ✅ SpotBugs: no findings (report was not generated by the build).
  • ⚠️ PMD report not generated.
  • ⚠️ Checkstyle report not generated.

Generated automatically by the PR CI workflow.

@shai-almog

shai-almog commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator Author

Compared 149 screenshots: 149 matched.
Native Windows port, REAL shipping pipeline: the hellocodenameone screenshot suite rendered by a binary CROSS-COMPILED on Linux (clang-cl + xwin, WebView2 linked) and RUN on a Windows x64 runner. Compared against the in-repo baseline in scripts/windows/screenshots.

Benchmark Results

Detailed Performance Metrics

Metric Duration
SIMD kernel backend SSE2 (x64) / NEON (arm64) native kernels
SIMD int-add (64K x300) java 66ms / native 4ms = 16.5x speedup
SIMD float-mul (64K x300) java 73ms / native 5ms = 14.6x speedup
SIMD kernel correctness PASS (native result == scalar reference)
Base64 native bridge unavailable (CN1 + SIMD + image benchmarks only)
Base64 payload size 8192 bytes
Base64 benchmark iterations 6000
Base64 SIMD byte path gated to scalar (CPU autovectorizes scalar; explicit SIMD not beneficial here)
Base64 CN1 encode 196.000 ms
Base64 CN1 decode 147.000 ms
Base64 SIMD encode 100.000 ms
Base64 encode ratio (SIMD/CN1) 0.510x (49.0% faster)
Base64 SIMD decode 100.000 ms
Base64 decode ratio (SIMD/CN1) 0.680x (32.0% faster)
Image encode benchmark iterations 100
Image createMask (SIMD off) 52.000 ms
Image createMask (SIMD on) 17.000 ms
Image createMask ratio (SIMD on/off) 0.327x (67.3% faster)
Image applyMask (SIMD off) 43.000 ms
Image applyMask (SIMD on) 27.000 ms
Image applyMask ratio (SIMD on/off) 0.628x (37.2% faster)
Image modifyAlpha (SIMD off) 28.000 ms
Image modifyAlpha (SIMD on) 20.000 ms
Image modifyAlpha ratio (SIMD on/off) 0.714x (28.6% faster)
Image modifyAlpha removeColor (SIMD off) 31.000 ms
Image modifyAlpha removeColor (SIMD on) 21.000 ms
Image modifyAlpha removeColor ratio (SIMD on/off) 0.677x (32.3% faster)

@shai-almog

shai-almog commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator Author

Compared 149 screenshots: 149 matched.
Native Linux port (x64), GTK3/Cairo/Pango, ParparVM bytecode-to-C (no JVM): the hellocodenameone screenshot suite rendered by a native ELF built + run on the GitHub x64 runner. Baseline: scripts/linux/screenshots.

@shai-almog

shai-almog commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator Author

Compared 149 screenshots: 149 matched.
Native Linux port (arm64), GTK3/Cairo/Pango, ParparVM bytecode-to-C (no JVM): the hellocodenameone screenshot suite rendered by a native ELF built + run on the GitHub arm64 runner. Baseline: scripts/linux/screenshots-arm.

@shai-almog

shai-almog commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator Author

Compared 149 screenshots: 149 matched.
Native Windows port (arm64 / Apple Silicon - Arm): full hellocodenameone screenshot suite rendered offscreen with Direct2D/DirectWrite, plus the real benchmarks (base64 native/CN1/SIMD, image createMask/applyMask/modifyAlpha/PNG/JPEG, NEON SIMD kernels). Compared against the in-repo baseline in scripts/windows/screenshots.

Benchmark Results

Detailed Performance Metrics

Metric Duration
SIMD kernel backend SSE2 (x64) / NEON (arm64) native kernels
SIMD int-add (64K x300) java 56ms / native 3ms = 18.6x speedup
SIMD float-mul (64K x300) java 57ms / native 4ms = 14.2x speedup
SIMD kernel correctness PASS (native result == scalar reference)
Base64 native bridge unavailable (CN1 + SIMD + image benchmarks only)
Base64 payload size 8192 bytes
Base64 benchmark iterations 6000
Base64 SIMD byte path gated to scalar (CPU autovectorizes scalar; explicit SIMD not beneficial here)
Base64 CN1 encode 245.000 ms
Base64 CN1 decode 128.000 ms
Base64 SIMD encode 65.000 ms
Base64 encode ratio (SIMD/CN1) 0.265x (73.5% faster)
Base64 SIMD decode 63.000 ms
Base64 decode ratio (SIMD/CN1) 0.492x (50.8% faster)
Image encode benchmark iterations 100
Image createMask (SIMD off) 14.000 ms
Image createMask (SIMD on) 51.000 ms
Image createMask ratio (SIMD on/off) 3.643x (264.3% slower)
Image applyMask (SIMD off) 24.000 ms
Image applyMask (SIMD on) 19.000 ms
Image applyMask ratio (SIMD on/off) 0.792x (20.8% faster)
Image modifyAlpha (SIMD off) 18.000 ms
Image modifyAlpha (SIMD on) 11.000 ms
Image modifyAlpha ratio (SIMD on/off) 0.611x (38.9% faster)
Image modifyAlpha removeColor (SIMD off) 22.000 ms
Image modifyAlpha removeColor (SIMD on) 13.000 ms
Image modifyAlpha removeColor ratio (SIMD on/off) 0.591x (40.9% faster)

@shai-almog

shai-almog commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator Author

Compared 181 screenshots: 181 matched.
✅ JavaScript-port screenshot tests passed.

…gy flags

The previous round gated eager projection on UIAccessibilityIsVoiceOverRunning /
IsSwitchControlRunning / IsAssistiveTouchRunning and latched on their status
notifications. Those are the only running flags UIKit publishes, so nothing in
that set can see Voice Control or Full Keyboard Access -- and when one of them is
already enabled at launch no notification fires either, so the latch never
engaged and those users got no tree at all.

METALView now overrides accessibilityElements. UIKit asks a container for its
elements only when something is actually consuming the semantic tree, so the
query itself is the signal that a client exists, and it depends on no
per-technology flag. The first query may see a tree that has not been projected
yet; noting the client schedules that projection and the resulting
layout-changed notification brings the client back for the real one.

Not covered: CodenameOne_GLViewController re-roots self.view to a plain UIView
when a peer component is added mid-transition, and the elements are then set on
that view instead. There the gate falls back to the flags and notifications --
the behaviour without this hook, not something worse. Noted at the override.

Also documents why cn1_copyMetalScreenTextureImage returns NULL in
direct-to-drawable mode: there is no retained screen texture to read, so
Display.screenshot() falls through to drawViewHierarchyInRect:. That is correct
on device but samples the presented drawable, so it can lag a frame and, on
headless Catalyst with no display link, can be stale indefinitely. Reading the
live drawable is not the fix -- retaining it past present starves nextDrawable,
and after present the buffer is recycled. A deterministic capture wants a
one-shot render into a scratch target, worth doing when the mode stops being
opt-in. The default path is unaffected.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3d98105c56

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread Ports/iOSPort/nativeSources/IOSNative.m Outdated
Comment thread Ports/iOSPort/nativeSources/CN1MetalGlyphAtlas.m
…ility APIs

Two fixes from review.

The shelf packer only ever tested growth against HEIGHT. That was safe while the
atlas started at 1024x1024 and glyphs were capped at CN1_METAL_ATLAS_GLYPH_MAX
(256): a fresh shelf always had room across, so the missing width test could
never fire. Starting the atlas at 256 makes it reachable with ordinary glyphs --
a 256-wide glyph placed at x=1 in a 256-wide texture runs past the edge, and the
region handed to replaceRegion: is out of bounds. Growth is now driven by a loop
that tests both dimensions and terminates either by fitting or by hitting the
growth ceiling, where the glyph is dropped exactly as an oversized one already
was.

UIAccessibilityAssistiveTouchStatusDidChangeNotification and
UIAccessibilityIsAssistiveTouchRunning() are iOS 10, and ios.deployment_target
lets IPhoneBuilder emit older targets. On those the weakly-linked constant is nil
-- and a nil inside an @[] literal raises, so the observer registration would
have taken the app down on the first accessibility invalidation -- while the
running check would call through a null symbol. The notification list is now
built up skipping absent constants, and the running check tests the function
pointer before calling it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0669758bc4

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread Ports/iOSPort/nativeSources/METALView.m Outdated
…r restart

blurScreenRegionX, glassScreenRegionX and lensScreenRegionX each end the frame's
encoder and reopen one on the SAME drawable via setFramebuffer. Direct mode set
loadAction=Clear unconditionally, so every one of those effects wiped everything
painted before it and presented only the effect and whatever followed.

The restart site already carried the comment "loadAction Load preserves
screenTexture" -- true of the retained path, and exactly the assumption direct
mode broke.

Only the first pass of a frame clears now: directFrameCleared is reset when a
fresh drawable is vended (its contents are two or three presents old, so there
is nothing to preserve) and set once the clear has happened, after which
mid-frame restarts load.

Why the earlier verification missed it: direct mode was checked by comparing the
presented-frame hash against the retained path, which matched exactly -- on a
screen with no glass or blur component in view.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c2ddeaa43c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread vm/ByteCodeTranslator/src/cn1_globals.h Outdated
Comment thread Ports/iOSPort/src/com/codename1/impl/ios/IOSImplementation.java
Comment thread Ports/iOSPort/src/com/codename1/impl/ios/IOSImplementation.java Outdated
Comment thread vm/ByteCodeTranslator/src/nativeMethods.m
…fixes

All four are in code this PR introduces.

* The lazy constant pool was a data race. The writer stored under
  constantPoolMutex while every fast-path reader loaded plain, and those readers
  never take the mutex -- so it serialised writers and established nothing with
  them. A reader could observe the published pointer while the String's fields
  were still invisible, which on arm64 is not theoretical. Entries are now
  released by the writer and acquired by readers, the GC's mark scan included:
  the collector marks through that pointer and must see a constructed object
  behind it.

* EAGLView gets the same accessibilityElements override METALView has.
  CodenameOne_GLViewController installs EAGLView whenever CN1_USE_METAL is
  absent, so on the GL backend the query latch was never installed and every
  portable-tree invalidation was discarded. Both call sites are gated on
  !TARGET_OS_WATCH, matching the note function, or the watch build fails to
  link.

* paintDirty paints the full form directly instead of enqueueing it. repaint(f)
  appends and the superclass drains in order, so the full-frame paint landed on
  top of overlay animations already queued -- Container.TransitionAnimation
  queues its Transition through Display.repaint(t), and painting the form over
  it makes a component transition vanish or snap to its end state. The
  background has to go down first and the queue drain on top of it.

* Class.getSuperclass() returns null for an interface. A class file records
  java/lang/Object as an interface's super_class and Parser.visit copies it into
  baseClass, so the isInterface flag is the only thing that separates them --
  the function's own comment already claimed this behaviour while the code
  returned Object.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 30d4c327e8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread Ports/iOSPort/src/com/codename1/impl/ios/IOSImplementation.java
…le clear

Follow-up to the previous commit, which fixed the transition ordering by
painting the Form directly instead of enqueueing it -- and left
super.paintDirty() still deriving its flush rectangle from the queued components
alone.

That rectangle is not advisory. CodenameOne_GLViewController hands it to
ClipRect.setDrawRect and the Metal path clamps every screen op to it. So with a
single partially dirty Component queued, direct mode cleared the ENTIRE drawable,
repainted the whole Form, and then clipped that paint to the component's rect --
presenting a mostly black frame.

Two changes each correct alone: clearing the whole drawable is right for a buffer
that is two or three presents old, and a partial flush rect is right when only
dirty regions are repainted. Direct mode makes them mutually exclusive -- clearing
everything obliges you to flush everything -- and flushGraphics is where the two
meet, so it widens to the full screen there.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@shai-almog

shai-almog commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator Author

Compared 217 screenshots: 217 matched.
✅ Native Apple Watch (watchOS, Core Graphics) screenshot tests passed.

@shai-almog

shai-almog commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator Author

Compared 144 screenshots: 144 matched.
✅ Native Apple TV (tvOS, Metal) screenshot tests passed.

@shai-almog

shai-almog commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator Author

Compared 143 screenshots: 143 matched.
✅ Native iOS screenshot tests passed.

Benchmark Results

  • VM Translation Time: 0 seconds
  • Compilation Time: 1626 seconds

Build and Run Timing

Metric Duration
Simulator Boot 96000 ms
Simulator Boot (Run) 1000 ms
App Install 18000 ms
App Launch 1000 ms
Test Execution 626000 ms

Detailed Performance Metrics

Metric Duration
SIMD kernel backend SSE2 (x64) / NEON (arm64) native kernels
SIMD int-add (64K x300) java 166ms / native 3ms = 55.3x speedup
SIMD float-mul (64K x300) java 183ms / native 4ms = 45.7x speedup
SIMD kernel correctness PASS (native result == scalar reference)
Base64 payload size 8192 bytes
Base64 benchmark iterations 6000
Base64 SIMD byte path active (NEON-accelerated)
Base64 CN1 encode 805.000 ms
Base64 CN1 decode 283.000 ms
Base64 native encode 1849.000 ms
Base64 encode ratio (CN1/native) 0.435x (56.5% faster)
Base64 native decode 1778.000 ms
Base64 decode ratio (CN1/native) 0.159x (84.1% faster)
Base64 SIMD encode 313.000 ms
Base64 encode ratio (SIMD/CN1) 0.389x (61.1% faster)
Base64 SIMD decode 196.000 ms
Base64 decode ratio (SIMD/CN1) 0.693x (30.7% faster)
Base64 encode ratio (SIMD/native) 0.169x (83.1% faster)
Base64 decode ratio (SIMD/native) 0.110x (89.0% faster)
Image encode benchmark iterations 100
Image createMask (SIMD off) 149.000 ms
Image createMask (SIMD on) 30.000 ms
Image createMask ratio (SIMD on/off) 0.201x (79.9% faster)
Image applyMask (SIMD off) 492.000 ms
Image applyMask (SIMD on) 350.000 ms
Image applyMask ratio (SIMD on/off) 0.711x (28.9% faster)
Image modifyAlpha (SIMD off) 202.000 ms
Image modifyAlpha (SIMD on) 199.000 ms
Image modifyAlpha ratio (SIMD on/off) 0.985x (1.5% faster)
Image modifyAlpha removeColor (SIMD off) 354.000 ms
Image modifyAlpha removeColor (SIMD on) 210.000 ms
Image modifyAlpha removeColor ratio (SIMD on/off) 0.593x (40.7% faster)

@shai-almog

shai-almog commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator Author

Compared 149 screenshots: 149 matched.
✅ Native iOS Metal screenshot tests passed.

Benchmark Results

  • VM Translation Time: 0 seconds
  • Compilation Time: 2083 seconds

Build and Run Timing

Metric Duration
Simulator Boot 106000 ms
Simulator Boot (Run) 1000 ms
App Install 17000 ms
App Launch 11000 ms
Test Execution 416000 ms

Detailed Performance Metrics

Metric Duration
SIMD kernel backend SSE2 (x64) / NEON (arm64) native kernels
SIMD int-add (64K x300) java 61ms / native 3ms = 20.3x speedup
SIMD float-mul (64K x300) java 57ms / native 3ms = 19.0x speedup
SIMD kernel correctness PASS (native result == scalar reference)
Base64 payload size 8192 bytes
Base64 benchmark iterations 6000
Base64 SIMD byte path active (NEON-accelerated)
Base64 CN1 encode 261.000 ms
Base64 CN1 decode 102.000 ms
Base64 native encode 846.000 ms
Base64 encode ratio (CN1/native) 0.309x (69.1% faster)
Base64 native decode 476.000 ms
Base64 decode ratio (CN1/native) 0.214x (78.6% faster)
Base64 SIMD encode 129.000 ms
Base64 encode ratio (SIMD/CN1) 0.494x (50.6% faster)
Base64 SIMD decode 75.000 ms
Base64 decode ratio (SIMD/CN1) 0.735x (26.5% faster)
Base64 encode ratio (SIMD/native) 0.152x (84.8% faster)
Base64 decode ratio (SIMD/native) 0.158x (84.2% faster)
Image encode benchmark iterations 100
Image createMask (SIMD off) 41.000 ms
Image createMask (SIMD on) 252.000 ms
Image createMask ratio (SIMD on/off) 6.146x (514.6% slower)
Image applyMask (SIMD off) 75.000 ms
Image applyMask (SIMD on) 247.000 ms
Image applyMask ratio (SIMD on/off) 3.293x (229.3% slower)
Image modifyAlpha (SIMD off) 245.000 ms
Image modifyAlpha (SIMD on) 213.000 ms
Image modifyAlpha ratio (SIMD on/off) 0.869x (13.1% faster)
Image modifyAlpha removeColor (SIMD off) 236.000 ms
Image modifyAlpha removeColor (SIMD on) 340.000 ms
Image modifyAlpha removeColor ratio (SIMD on/off) 1.441x (44.1% slower)

@shai-almog

shai-almog commented Aug 25, 2026

Copy link
Copy Markdown
Collaborator Author

Compared 148 screenshots: 148 matched.
✅ Native Mac screenshot tests passed.

Benchmark Results

  • VM Translation Time: 0 seconds
  • Compilation Time: 278 seconds

Detailed Performance Metrics

Metric Duration
SIMD kernel backend SSE2 (x64) / NEON (arm64) native kernels
SIMD int-add (64K x300) java 54ms / native 3ms = 18.0x speedup
SIMD float-mul (64K x300) java 55ms / native 2ms = 27.5x speedup
SIMD kernel correctness PASS (native result == scalar reference)
Base64 payload size 8192 bytes
Base64 benchmark iterations 6000
Base64 SIMD byte path active (NEON-accelerated)
Base64 CN1 encode 160.000 ms
Base64 CN1 decode 93.000 ms
Base64 native encode 481.000 ms
Base64 encode ratio (CN1/native) 0.333x (66.7% faster)
Base64 native decode 202.000 ms
Base64 decode ratio (CN1/native) 0.460x (54.0% faster)
Base64 SIMD encode 49.000 ms
Base64 encode ratio (SIMD/CN1) 0.306x (69.4% faster)
Base64 SIMD decode 45.000 ms
Base64 decode ratio (SIMD/CN1) 0.484x (51.6% faster)
Base64 encode ratio (SIMD/native) 0.102x (89.8% faster)
Base64 decode ratio (SIMD/native) 0.223x (77.7% faster)
Image encode benchmark iterations 100
Image createMask (SIMD off) 6.000 ms
Image createMask (SIMD on) 2.000 ms
Image createMask ratio (SIMD on/off) 0.333x (66.7% faster)
Image applyMask (SIMD off) 42.000 ms
Image applyMask (SIMD on) 33.000 ms
Image applyMask ratio (SIMD on/off) 0.786x (21.4% faster)
Image modifyAlpha (SIMD off) 34.000 ms
Image modifyAlpha (SIMD on) 29.000 ms
Image modifyAlpha ratio (SIMD on/off) 0.853x (14.7% faster)
Image modifyAlpha removeColor (SIMD off) 35.000 ms
Image modifyAlpha removeColor (SIMD on) 31.000 ms
Image modifyAlpha removeColor ratio (SIMD on/off) 0.886x (11.4% faster)

@shai-almog
shai-almog merged commit d665120 into master Aug 25, 2026
54 of 56 checks passed
@shai-almog
shai-almog deleted the ios-memory-perf branch August 25, 2026 01:27
shai-almog added a commit that referenced this pull request Aug 25, 2026
…scenario

Three findings, two from review and one the review's tighter test surfaced.

The SATB filter read __codenameOneGcMark with a plain load while the marker reaches
the same field through __atomic_*. That is a mixed atomic/non-atomic access to one
object -- undefined in C, and the same bug class #5598 fixed in the constant pool.
The concrete hazard is not tearing but the compiler caching a -1 across several
inlined barriers in one loop, which would keep suppressing entries after the object
had aged into a genuine snapshot object. Now __ATOMIC_RELAXED, and the comment says
why relaxed and not acquire: nothing is published through this read, both stale
answers are safe, and what relaxed buys is that the load happens at all. An acquire
fence on every object store buys nothing over that and is not free on arm64. The two
CN1_GC_CONFORM census reads of the same field move with it.

The fault-injected runs' measurements were accepted without checking exit status or
the completion marker, so a build that crashed after emitting enough probe rows would
have satisfied the assertions and turned a memory-safety regression into a green
gate. Both now go through assertHealthy first.

The ceiling scenario used a 1400MB budget, which needs the mutator to actually outrun
the collector by 1.3GB -- and how far it outruns depends on how many cores it has to
itself, so a two-core runner might never get there and the fourth scenario would go
quietly inert. It now uses 768MB, which admission converges on by construction rather
than by winning a race. The threshold between the two regimes becomes ABSOLUTE, twice
CN1_PACING_HEADROOM_MARGIN, because the margin does not scale with the budget: a
proportional threshold silently stops separating them as the budget shrinks, which is
exactly what happened at 400MB (reserve 100MB, margin still 63MB, half the reserve
below it).

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
shai-almog added a commit that referenced this pull request Aug 25, 2026
… (issue #5537) (#5599)

* Stop the SATB barrier logging fresh references (issue #5537)

Four merged fixes (#5540, #5563, #5573, #5585) each named a mechanism and the
reporter's build still climbed 500MB to 5GB in five minutes on the iOS Simulator
with a live set of a few hundred objects, GC pauses lengthening until they were
continuous. The reason none of them settled it is structural: every GC workload
in vm/tests measures a PEAK under load, and a heap that grows forever at a modest
rate passes "peak < 2GB over 50 rounds" without difficulty. Nothing measured
whether the VM ever gives the memory back.

The instrument comes first, and it is what found this.

-DCN1_GC_CONFORM adds a probe that PARTITIONS the footprint -- resident pages,
legacy blocks, the legacy table, the allocator's side tables -- and prints the
residual the four do not account for, plus a per-phase breakdown of the mark. It
deliberately is not CN1_GC_VERIFY: that flag forces cn1BibopReleaseOffset() to 0,
which compiles out the page-release path, the major sweep and every madvise call,
so the paths a footprint investigation is about cannot be measured in a verifier
build. It changes no allocator behaviour, and the emitters are gated at RUNTIME on
CN1_GC_PROBE so probe-on and probe-off are the same binary.

On the reported shape -- a deep game-tree search on four workers, tiny short-lived
reference-carrying objects, a constant live set -- it named the cost immediately:
of a 327ms mark, 282ms was SATB termination, draining 2,718,448 logged references
in one cycle. Of those, 2,718,413 were references to FRESH objects.

A mark == -1 object was allocated after the cycle's snapshot was taken, so it is
not in the snapshot the barrier exists to preserve, and both sweeps keep it anyway
-- the grace rule promotes a fresh slot to the current epoch instead of freeing it.
Its own outgoing references to non-fresh objects are still logged by the same
barrier as they are stored, so nothing reachable only through a fresh object is
lost, which is the hazard the insertion half was added for.

Without that filter the log is a feedback loop rather than a cost: its size is
mutation rate times cycle duration, draining it is part of the cycle, so a longer
cycle logs more and logging more lengthens the cycle. Both reported symptoms fall
out of the one loop -- the footprint climbs because the collector never catches up,
and the pauses climb because the log it has to drain keeps growing.

Measured, three repetitions each, interleaved in one session:

  footprint drift   before 306,684 / 241,493 / 224,237 KB/min
                    after     -31,430 /  36,866 /  18,993 KB/min (noise around zero)
  page count        before 3,947 -> 5,995 over 40s and still climbing
                    after  flat at 11,687 for 40s
  mark time         before 38ms -> 180ms;  after 9-68ms, no trend
  under a simulated 1.4GB per-process ceiling: 3.5x the search throughput
                    (237.8M nodes vs 67.6M), peak 1271MB, no kill

Throughput, interleaved A/B, checksums bit-identical: geomean 0.944 -- 5.6% faster
overall, objectAllocation 1.73x (56.3ms -> 32.5ms). The barrier was that expensive.
-DCN1_SATB_LOG_FRESH restores the old behaviour for A/B.

GcSteadyStateIntegrationTest is the gate. It asserts the SATB log stays sized by
the live set rather than by the allocation rate, and that the page heap stops
growing in the second half of the run; then it rebuilds with -DCN1_SATB_LOG_FRESH
and requires both to fail, so it cannot go inert.

Two pre-existing defects found on the way and fixed here:

* -DCN1_DISABLE_CONSERVATIVE_GC_ROOTS, the revert path cn1_globals.h documents,
  did not compile at all: the grace passes use CN1_GC_TRUSTED_BEGIN/END/SUSPEND/
  RESUME unconditionally and those are only defined with conservative roots on.
  No-op definitions restore it, which is what makes it usable as an A/B arm.

* [GC-INSTR] allocs= is not an allocation count -- CN1_FAST_NEW's inlined bump
  path never reaches that counter, so on a small-object workload it understates
  allocation by orders of magnitude. Renamed to outOfLineAllocs= with a note.

Verified: 520 vm/tests non-benchmark tests green; all six GC benchmark tests green;
run-gc-verify.sh green including both fault self-tests; run-gauntlet.sh green with
every checksum matching; grace audit reports doomedChildren=0 with and without the
filter; and the probe compiles across nine ablation flag combinations.

Not addressed, and pre-existing: under a per-process ceiling the process still
rides to ceiling-minus-64MB, which #5585 flagged as open. That is now a bounded
plateau rather than unbounded growth, but the margin is thin on a device where the
renderer shares the same budget.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Defend a headroom reserve under a per-process ceiling (issue #5537)

The previous commit stopped the heap growing without bound. This one stops the
process parking itself on the kill line, which #5585 flagged as open and which is
what turns a native spike into a jetsam kill.

Budget headroom is not a footprint bound. Admission against os_proc_available_memory
answers only "is there budget left", so it keeps saying yes until the budget is gone.
Measured on the issue-5537 game-tree shape under a simulated 1.4GB ceiling, seven
times: 1,271MB resident and 63MB of headroom left, every time, against a live set of
a few hundred objects. That repeatability is the tell -- it is not an accident of the
workload, it is the policy converging on ceiling minus CN1_PACING_HEADROOM_MARGIN by
construction. The ceiling is not special either: give the same workload an 8GB budget
and it rides to 7.5GB. There is no footprint TARGET anywhere in the design.

63MB is the whole margin, and the renderer spends out of the same budget -- #5598
measured one screen texture at 30MB.

So the collector now also bounds how far the mutator may run ahead of it, but only
once headroom drops inside a reserve of a quarter of the budget
(CN1_PACING_RESERVE_SHIFT). Inside the reserve the mutator is clamped to the static
cap, the collector gets ahead, and the footprint falls back out. Gating on HEADROOM
rather than on footprint is what makes this affordable: it is a control loop that
engages only inside the reserve, not a tax on every allocation, and volumeParks in
the [PACING] report is 0 for a run that never enters it.

Both allocation paths are charged against ONE figure. Bounding them separately is a
defect this code has had before -- each running a full cap ahead of a cap derived
from the same budget -- and the reserve is derived from the BUDGET, never from the
device's free RAM, which is the defect #5563 fixed. cn1BibopPacingCap is deliberately
not reused for that reason.

Measured, builds interleaved within one session (-DCN1_PACING_NO_RESERVE is the same
binary with the bound compiled out), simulated 1.4GB ceiling, four workers:

                     peak footprint   smallest headroom seen
  no reserve         1271MB, x7       63MB, x7
  reserve limit>>2   1027-1036MB      298-304MB

4.8x the margin. Throughput across seven interleaved pairs came out at 0.90 to 0.99
of the unbounded build, median 0.94; the spread is session drift, not the bound, and
the sign never changed. A single repetition each of the tighter reserves put >> 3 at
1183MB/150MB and >> 4 at 1207MB/127MB, both slower -- a smaller reserve engages later
and thrashes closer to the edge -- so a quarter is the knee rather than a compromise.

Roughly 6% for that margin is a different trade from the volume brakes #5573 and
#5585 measured at 2-4x and rejected. It cannot touch a platform with no per-process
budget, because the whole branch is unreachable there: vm/benchmarks measures geomean
0.9398 against master, i.e. still 6% FASTER from the previous commit's SATB fix, with
no benchmark regressing and every checksum identical.

cn1PacingPastGrowthFloor's rate-limited footprint probe is factored out as
cn1PacingFootprintNow so both bounds read through it. Behaviour-preserving: each of
its three early returns previously answered FALSE, and the fast path above already
established that the cached value is under the floor.

GcSteadyStateIntegrationTest gains a third scenario asserting the process defends its
reserve under a simulated ceiling, and a fourth that rebuilds with
-DCN1_PACING_NO_RESERVE and requires the third to fail -- otherwise a gate that never
engages would report green forever.

Verified: 520 vm/tests non-benchmark tests green; all seven GC benchmark tests green
(ProcessBudgetPacingIntegrationTest included, which exercises the same budgeted path);
run-gc-verify.sh green with both fault self-tests; run-gauntlet.sh green with every
checksum matching; nine ablation flag combinations compile.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Give the benchmark driver its GPL header, and scope two helpers to their use

check-copyright-headers rejects a new source file without the complete Codename
One GPLv2 + Classpath Exception header, and vm/benchmarks/src is in scope.

cn1PacingUncollectedBytes and cn1PacingReserveBytes are used only from the reserve
bound, so they are guarded on the same condition it is -- otherwise compiling the
bound out with -DCN1_PACING_NO_RESERVE leaves them as unused statics.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Count benchmark nodes per worker, not through a shared racy counter

The driver incremented one static long from four workers with an unsynchronised
read-modify-write, and the sampler read it concurrently. That is not merely
imprecise: the rate at which increments are lost depends on CONTENTION, and
contention is exactly what differs between the builds this benchmark compares --
a build whose threads park more loses fewer increments and so reports a throughput
advantage it has not got. The per-round `nodes = localNodes` writeback also
overwrote the shared total instead of combining the workers' counts.

Each worker now counts into its own slot, and NODES= is summed after join(), which
gives it a happens-before edge to every worker's last write. The SAMPLE series sums
the same slots while they are still being written, so it is renamed nodes~= and
documented as a progress indicator rather than a measurement.

The CI fixture (GcSteadyStateApp) never had a node counter -- its assertions come
from the [GCPROBE] series -- so nothing the gate asserts is affected.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Keep every probe row a single-cycle row, publish node counts live

Two review findings on #5599, both real.

cn1GcProbeCycle returned early on a skipped cycle without clearing the phase
accumulators, so with CN1_GC_PROBE>1 snapMs/graceMs/satbMs and friends carried a
whole interval while markMs and sweepMs described only the cycle that just ran --
two time bases in one row, which would attribute an interval's worth of a phase to
a single cycle's pause. The resets move into cn1GcProbeResetPhases and run on every
cycle, printed or not. The cumulative counters (matured, consWords, staleSkips) are
deliberately left alone: those are running totals the reader diffs.

The benchmark driver published each worker's node count only after the run stopped,
so every SAMPLE line reported zero. It now republishes once per round; a worker that
stalls stops publishing and its slot going flat is the signal.

Neither affected any measurement reported so far -- every run used CN1_GC_PROBE=1,
where the skip path is unreachable, and the throughput figures come from NODES=,
which is summed after join().

Also corrects the reserve's throughput figures, which came from the racy counter the
previous commit replaced. Re-measured with the exact one, four interleaved pairs:
0.97-1.05 of the unbounded build, median 0.99, two of four faster with the bound on.
The previous "median 0.94" overstated the cost. Peak footprint and headroom are
unchanged (1271MB/63MB against 1015-1027MB/306-308MB) -- those come from the probe
and Runtime, not the counter. The claim that a smaller reserve is "slower" is
withdrawn; >>3 and >>4 buy less on peak and headroom, which is the argument that
survives.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Load the mark word atomically in the barrier, and harden the ceiling scenario

Three findings, two from review and one the review's tighter test surfaced.

The SATB filter read __codenameOneGcMark with a plain load while the marker reaches
the same field through __atomic_*. That is a mixed atomic/non-atomic access to one
object -- undefined in C, and the same bug class #5598 fixed in the constant pool.
The concrete hazard is not tearing but the compiler caching a -1 across several
inlined barriers in one loop, which would keep suppressing entries after the object
had aged into a genuine snapshot object. Now __ATOMIC_RELAXED, and the comment says
why relaxed and not acquire: nothing is published through this read, both stale
answers are safe, and what relaxed buys is that the load happens at all. An acquire
fence on every object store buys nothing over that and is not free on arm64. The two
CN1_GC_CONFORM census reads of the same field move with it.

The fault-injected runs' measurements were accepted without checking exit status or
the completion marker, so a build that crashed after emitting enough probe rows would
have satisfied the assertions and turned a memory-safety regression into a green
gate. Both now go through assertHealthy first.

The ceiling scenario used a 1400MB budget, which needs the mutator to actually outrun
the collector by 1.3GB -- and how far it outruns depends on how many cores it has to
itself, so a two-core runner might never get there and the fourth scenario would go
quietly inert. It now uses 768MB, which admission converges on by construction rather
than by winning a race. The threshold between the two regimes becomes ABSOLUTE, twice
CN1_PACING_HEADROOM_MARGIN, because the margin does not scale with the budget: a
proportional threshold silently stops separating them as the budget shrinks, which is
exactly what happened at 400MB (reserve 100MB, margin still 63MB, half the reserve
below it).

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Do not size an adopted BiBOP slot as if it were a malloc block

The probe sized every non-null allObjectsInHeap entry with malloc_size /
malloc_usable_size. A MATURED object is in that table but its storage is a slot
inside a posix_memalign'd BiBOP arena, so the pointer is interior: glibc's
malloc_usable_size reads the chunk header immediately below it and returns a garbage
figure, and CI runs this gate on Linux. Its bytes are also already counted in
residentPgBytes, so anything it did return double-counted into the residual that is
this probe's whole point.

Only an object the table INDEXES (__heapPosition >= 0) owns an individual block.
The rest are counted as legAdopted instead -- the same population as
matured - maturedDied but measured from the table rather than from the counters, so
the two disagreeing is itself a finding.

Not a small corner: on the game-tree workload legAdopted is 32,907 of a legUsed of
33,164, so 99% of the table was being sized this way. It was harmless on macOS only
because malloc_size answers 0 for an interior pointer, which is also why legBlockKb
read flat through the original investigation and correctly never carried the drift.

Verified after the change: run-gc-verify.sh green with both fault self-tests, and
vm/benchmarks geomean 0.9422 against master (0.9398 before the previous commit's
atomic load, i.e. that load costs nothing), no benchmark regressing, checksums
identical.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Close the wait timer at the wait, read the cycle counter atomically

Three findings from review; two fixed, one measured and answered in the code.

waitMs was opened before the safepoint wait and closed only after the allocation
migration and both stack scans, so it double-counted work already attributed to
migrateMs and stackMs -- a phase breakdown that overlaps reads a long root scan as
mutator wait time, which is the opposite of what it exists to say. It now opens and
closes around the wait alone, inside the lightweightThread branch, so a native thread
(which is never waited for) contributes 0 instead of everything up to markStatics.

The 1Hz emitter read currentGcMarkValue with a plain load while the collector
increments that ordinary int -- a data race, in the one emitter documented as
"atomics only" and built to keep reporting exactly when the collector is stalled.
Now an atomic relaxed load, as is the mutator-side comparison in the SATB census.

Not taken: requiring the -DCN1_SATB_LOG_FRESH build to also blow the second-half
page-growth bound. Measured across two runs of that build, its second-half growth is
0.446 and then 0.033 -- a runaway's page pool sometimes saturates before the midpoint
and the ratio then reads flat while the heap is enormous. That assertion would fail
about half the time, and a coin-flip gate is worse than the inertness it guards
against. The reasoning, the numbers and what does have teeth (the SATB metric, five
orders of magnitude, every time) are recorded on the constant. Both series are now
printed on every run so the ratio stays auditable rather than merely asserted.

Verified after these changes: phases sum to markMs with no overlap (16.0 of 16.3);
520 vm/tests non-benchmark tests green; all seven GC benchmark tests green.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Read the collector's atomic epoch mirror, and claim a matured page with one edge

Two follow-ups from review, both correct.

The previous commit made the 1Hz emitter's read of currentGcMarkValue atomic while
codenameOneGCMark still increments it with a plain ++. That is half a fix: an atomic
read of a plainly-written object is still a mixed access and still undefined. Both
sides now go through bibopGcEpoch, the collector's own _Atomic mirror of the same
value, published at cycle start -- which is what the reviewer offered as the
alternative and what should have been used first. The mutator-side comparison in the
SATB census moves with it. Where there is no page heap there is no mirror, so the
emitter reports cyc=-1 rather than a figure read through a data race.

cn1MaturedPages tested gcHasAdopted and then let the existing plain store set it. The
CAS above guarantees one thread matures a given OBJECT, but two markers can mature two
different objects on the SAME page, so both could observe FALSE and both count it --
and the plain store is itself a data race the moment gcMarkResolveThreadCount stops
returning 1. Now one __atomic_exchange_n: exactly one thread sees the FALSE->TRUE
edge, and it does the counting. That the ratio is read chiefly in the
CN1_GC_MARK_THREADS>1 arm is the point -- it would have been wrong exactly where it
is used.

Verified in that arm: maturedPages=2121 of pgTotal=11214, a plausible ratio rather
than an inflated one. run-gc-verify.sh green with both fault self-tests; the steady
state, heap integrity and process budget gates green; seven ablation combinations
compile.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Make every collector-side write to the mark word atomic

The barrier's read was made atomic two commits ago while gcMarkObject still stamped
the same field with a plain store, so the pair was still a mixed access. The field
already had an atomic convention here -- gcMarkObject's own read is __ATOMIC_ACQUIRE,
the BiBOP publish is __ATOMIC_RELEASE -- and the plain writes were the inconsistency,
not the new read.

Every write that can run concurrently with a mutator is now a relaxed atomic store:
gcMarkObject's stamp, both sweeps' grace promotion, both free-mark stores, the
nursery promotion and the CN1_GC_VERIFY poison. Relaxed compiles to the same
instruction on every target we build; what it buys is that the write is a write the
reader is allowed to observe.

Header INITIALISATION deliberately stays plain, in codenameOneGcMalloc and in
cn1FusedInstallPrimArray. Those are not concurrent with anything: the barrier only
ever reads the mark of an object the mutator holds a reference to, so one already
published, and the publishing store orders the initialisation against any reader.
That distinction is not free-floating -- making those two atomic as well cost 1.2
points of benchmark geomean (0.9550 against 0.9432, with arraySequential, quicksort
and valueEscape all moving and returning), because they sit on the allocation fast
path. The reasoning is recorded at the site so the next person does not reintroduce
it for symmetry.

Verified: vm/benchmarks geomean 0.9432 against master, six rounds interleaved, no
benchmark regressing and checksums identical; run-gc-verify.sh green with both fault
self-tests; all seven GC gates green; five ablation combinations compile including
-DCN1_NURSERY.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Emit the generated mark chain's root store atomically too

The previous commit converted every hand-written collector-side write of the mark
word and missed the one that matters most, because it is not in the C sources at all:
ByteCodeClass emits the root of every generated mark chain, and that store was still
plain. It runs on the GC thread for every object marked while the SATB barrier
atomically loads the same field from mutators, so the pair stayed a mixed
atomic/non-atomic access -- the exact defect the previous commit was for, in the one
place a grep of cn1_globals.m could not see.

Costs nothing, as the hand-written conversions did not: vm/benchmarks geomean 0.9387
against master over six interleaved rounds (0.9432 before this change, so inside the
noise), no benchmark regressing, checksums identical.

A codegen change touches every translated class rather than one runtime path, so it
is verified against the shapes rather than the sites: run-gc-verify.sh green with both
fault self-tests, and run-gauntlet.sh green with every checksum matching.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Publish the sampler's counters, and keep the page partition valid under a race

Two findings, one taken as offered and one taken but answered differently.

The benchmark driver's per-worker slots were published with a plain long[] write
against a concurrent reader: no visibility guarantee, and Java 8 permits a 64-bit
element to be observed torn, so the live series could sit stale or jump nonsensically
exactly when a stalled worker is what it is meant to show. Publication and sumNodes()
now share SUM_LOCK. Once per round is about once a second per worker, so it costs
nothing, and NODES= after join() remains the authoritative figure regardless.

The probe's page walk is a different case. It reads plain page counters while mutators
run, which is a race, but it is the same deliberate sample cn1HeapAccounting takes
beside it -- "a diagnostic wants the shape, not the last digit" -- and both offered
remedies cost more than the unsoundness. Stopping the page owners would perturb
collector/mutator timing, which is the quantity this probe reports, and would cost
CN1_GC_CONFORM the behaviour-neutrality that is the only reason it is a separate flag
from CN1_GC_VERIFY. Making the page fields _Atomic would put atomic accesses on the
inlined bump path in cn1_globals.h, the hottest code in the VM, to improve a
diagnostic.

What is worth fixing is the harm actually named: an internally inconsistent partition.
Only an owned page can move under the walk -- at most one per size class per thread out
of many thousands -- so freeCount is clamped into [0, bumpIndex] and a stale pair can
no longer make live and dead slots sum past the page. Verified: 517295 + 25326 KB
against a 776448 KB reservation. The reasoning is recorded at the walk so the next
reader does not have to rediscover which of the three options was chosen and why.

Verified: run-gc-verify.sh green with both fault self-tests; steady-state, heap
integrity and process budget gates green; the sampler now tracks progress live
(nodes~=28,697,812 mid-run against a final NODES=34,360,526); and the 520-test
non-benchmark suite is green on the regenerated code from the previous commit.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Survive a stall: publish inside the traversal, bound the run

Both findings are the same blind spot from two directions -- a stalled collector is
one of the things this gate exists to CATCH, and neither the progress series nor the
runner survived one.

Publishing between rounds was not enough. One depth-14 traversal is millions of
nodes, so if the collector stalls badly enough that no round completes inside the
window, nothing is ever published and the series reads zero -- silent in exactly the
case it is for. It now also publishes every 1<<20 nodes: a power of two so the test is
an AND, coarse enough (about a fifth of a second of work) that the lock traffic is
negligible against the sampler's 4Hz. Verified live: 0 -> 4,194,304 at 1s ->
33,554,432 at 9.8s, against a final NODES=35,255,230.

The runner read the child's output to EOF on the test thread and only then called
waitFor(), so a hung workload would block until the CI job's global timeout -- the
guard would stop reporting a regression and start eating the build. It now drains on a
background thread and waits with a bound, killing the child on expiry and failing with
whatever it printed, which is the only diagnostic a stalled run leaves. That is not a
new invention: GcOverflowSpiralIntegrationTest and ProcessBudgetPacingIntegrationTest
both already do exactly this, and the naive pattern came from copying
GcHeapIntegrityIntegrationTest, which is the one that does not.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Do not filter fresh SATB entries where there is no insertion barrier

The filter's soundness argument ends "its non-fresh children are still logged by this
same barrier as they are stored". That step has a precondition I did not state and
did not check: the INSERTION half has to exist.

Under CN1_NURSERY it does not. CN1_WRITE_BARRIER is the nursery remembered-set update
there and enqueues nothing at all (cn1_globals.h:1020-1039), so a fresh container that
takes an older child after the grace pass has that child recorded nowhere -- and
dropping the deletion entry for the container then lets the sweep reclaim a child the
grace-surviving container still references. That is a use-after-free, in the class of
defect #5425 and #5442 were about.

The filter is an optimisation and not a correctness requirement, so a build without
the insertion half simply does not get it: the condition is now
!defined(CN1_SATB_LOG_FRESH) && !defined(CN1_NURSERY). Adding SATB insertion to the
nursery barrier was the other option offered and is the riskier one -- it changes
barrier behaviour in a configuration nothing exercises, and would have to be justified
by measurements no one can take.

Latent rather than live: CN1_NURSERY is not defined anywhere in-tree, so no shipping
or CI build takes that path. It is a documented, reachable flag, and the comment now
records the dependency so the next person to enable it is not relying on an argument
that quietly stopped holding.

Verified: five ablation combinations compile including -DCN1_NURSERY;
run-gc-verify.sh green with both fault self-tests; steady-state and heap-integrity
gates green.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Let CN1_WL_LEGACY=0 actually ablate the legacy population

Setting the documented knob to 0 built a zero-length legacyLiveSet and then indexed
[-1] on the last line, so the driver threw AFTER the entire timed run had been paid
for -- losing RESULT and GC_STEADY_STATE_DONE, which is everything the run was for.
Running without the retained legacy population is a legitimate ablation, so it now
works rather than crashing: the fold is skipped when there is nothing to fold.

Two neighbouring values that would produce a wasted or silently empty run are clamped
at the same time. A negative CN1_WL_LEGACY reached new Object[n][]; a CN1_WL_THREADS
below one started no workers at all and reported that only by printing zero nodes,
which is the exact failure mode -- a measurement that looks like a result -- this
whole change has been about. WLCONFIG prints the clamped values, so the log says what
actually ran.

Verified: CN1_WL_LEGACY=0, CN1_WL_LEGACY=-5 with CN1_WL_THREADS=0, and the defaults
all reach RESULT and GC_STEADY_STATE_DONE.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Check the answer, not just the telemetry, in every scenario

Three of the four runs checked exit status and the completion marker but never that
the workload still computed the right thing. That gap matters most exactly where it
was left: the ceiling scenarios exercise the budgeted pacing path -- the code this
change touches most -- under an environment the clean run never sees, so a worker
could die early or compute a wrong sum while the process still exited cleanly and
emitted plenty of [PACING] telemetry for the policy assertions to pass.

None of the variants changes what the program computes: the faults injected are a
barrier filter and a pacing bound, and the workload is deterministic by construction
(fixed rounds, fixed seeds, an order-independent checksum). So RESULT must equal the
host JVM's in all of them, and assertHealthy now requires it -- which also picks up
the -DCN1_SATB_LOG_FRESH run, which had the same gap.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Normalise every workload knob, not just the one that was reported

CN1_WL_MOVES=0 left the move chain null and the next-seed derivation dereferenced it,
so the leaf-only ablation died with an NPE on the first node. That is the second knob
found this way, so this fixes the class rather than the instance: all eight are
normalised in one place before the timed run, and WLCONFIG prints the normalised
values so the log says what actually ran rather than what was asked for.

Auditing the rest turned up one more that was worse than the reported one. A negative
CN1_WL_DEPTH never matches the d == 0 base case, so it recursed until the stack gave
out. CN1_WL_SECONDS and CN1_WL_BRANCH below their floors produced runs that measured
nothing and said so only by reporting zero -- the failure mode this entire change is
about.

Zero stays meaningful where it means something, and both cases are real ablations: no
retained legacy population, and no reference-carrying Move per node. The second is
worth having, because only a non-leaf object reaches the grace pass's worklist or
maturation, so leaf-only allocation is a genuinely different workload for the parts of
the collector under test.

Verified: CN1_WL_MOVES=0, CN1_WL_MOVES=-3, CN1_WL_DEPTH=-1, CN1_WL_BRANCH=0,
CN1_WL_SECONDS=0 and CN1_WL_LEGACY=0 all reach RESULT and GC_STEADY_STATE_DONE, and
the default configuration is unchanged.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Flag the probe row when the collection cycle threw

gcMarkSweep wraps mark and sweep in a catch-all so a throwing finalizer cannot wedge
the collector. On that path control jumps past the timing assignments, so the probe
emitted a row carrying the PREVIOUS cycle's markMs and sweepMs beside the partial
current cycle's phase counters -- two cycles in one row, and it concealed the
exceptional cycle, which is the one a reader most wants to see.

This is the same defect as the CN1_GC_PROBE>1 skip path fixed earlier, on a different
route out. The timings are now cleared BEFORE the protected region, so a throw cannot
inherit them, and the row carries threw=1 rather than being suppressed: hiding it
would defeat the reason this probe has a wall-clock emitter at all. The three carriers
are file scope, so the setjmp/longjmp indeterminate-local rule does not apply to them.

Verified: five ablation combinations compile; run-gc-verify.sh green with both fault
self-tests; steady-state and heap-integrity gates green; probe rows carry threw=0 on
a healthy run.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Re-evaluate the reserve throughout the wait, and stop the driver perturbing itself

Two review findings, and a third defect the first one's verification exposed.

The wait loop's copy of the volume bound was guarded on the thread having already
been refused, so it could only transition refused->allowed. A thread that parked on
BUDGET while outside the reserve then held a stale "allowed" for its whole wait and
could be admitted on headroom alone after other mutators had pushed the uncollected
total past the cap and the process into the reserve. There is now ONE definition,
cn1PacingVolumeOk, called from both sites and recomputed every iteration -- the two
copies drifted precisely because they were two.

The gate parsed only the per-cycle [GCPROBE] rows, so a collector that completes its
early cycles and then never finishes another was invisible to it: the rows stop, the
generated main returns as soon as the workers do, and the process exits cleanly with
the marker while the heap is still growing. [GCPROBE-T] was added for exactly that
state and then not asserted on. The outcome check now covers the wall-clock series
too, with its own anti-vacuous row count.

And the driver had started perturbing its own experiment. The periodic publication
added two commits ago took SUM_LOCK inside the search, and monitorEnter is a GC
SAFEPOINT in this VM -- so the workers were being stopped far more often than the
workload otherwise permits and the runaway stopped reproducing: peak footprint fell
from 1271MB to 126MB with the reserve compiled out, in BOTH builds, which is what
gave it away. Publication is now a volatile long per worker: not a safepoint, not a
lock, and JLS 17.7 makes volatile long access atomic, so it also answers the
visibility and tearing that the plain long[] had.

With the runaway restored, the reserve's throughput cost is re-measured across four
interleaved pairs at 0.875-1.035, median 0.90 -- about a tenth, not the ~1% the
previous figure claimed. Peak and headroom are unchanged (1271/63 against
1022-1064/272-304). This is the third throughput figure this comment has carried and
the first two were both apparatus rather than signal, so the comment now says which
were which.

Verified: four ablation combinations compile; run-gc-verify.sh green with both fault
self-tests; the steady-state gate green with all five checks.

Reported by chatgpt-codex-connector on #5599.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Attach evidence to the ceiling assertions

The first vm-tests run that ever completed on this branch failed scenario 3 -- "the
smallest headroom seen was 62MB" under a 768MB budget -- and reported nothing else.
Every other assertion in this gate appends the run's output; this one, the only one
that has actually failed, did not. The probe rows that would explain it were captured
and then discarded.

Both ceiling assertions now carry the [PACING] counters, the last [GCPROBE] footprint
partition and the wall-clock summary. That partition is the whole point of the probe:
it says whether a footprint the reserve did not defend is even in the Java heap.

No behaviour change, and the gate still passes locally on macOS -- which is itself the
open question, since the failure is on the Linux runner and the two measure different
quantities (phys_footprint against RSS).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Assert the reserve's mechanism, report its outcome

The first vm-tests run that completed on this branch failed scenario 3 on the Linux
runner: 62MB of headroom under a 768MB budget. With the evidence attached, the
diagnosis is not what I guessed.

I expected allocator retention -- glibc arenas holding freed legacy blocks, which RSS
counts and phys_footprint would not. Wrong: residKb was 7MB of a 518MB footprint, so
the footprint was the Java heap almost exactly. That is the residual bucket earning
its place; it killed the hypothesis in one line.

What the runner actually shows is a collector that cannot keep up, with the bound
working: volumeParks=879, so it engaged and parked repeatedly, while mark ran 407-545ms
per cycle -- 235ms of conservative stack scan, 122-252ms waiting for mutators to reach
a safepoint -- against ~170MB of allocation per cycle. With the grace rule holding a
cycle's allocation two more cycles, the smallest working set that machine can hold is
already above the reserve line at that budget. satbMs was 0 throughout, so the earlier
fix is holding and the stack scan is simply the next cost.

So an absolute headroom assertion was testing the runner rather than the collector.
Scenario 3 now asserts the contract, which is true on any machine: either the process
never entered its reserve, or the bound engaged when it did. The headroom achieved is
printed either way, so the outcome stays visible without being asserted. A regression
that stops the bound engaging fails here; a machine that is merely slow does not.

Scenario 4 gains a second half for the same reason -- with the reserve compiled out
the process must land on the bare admission margin, or the ceiling is not pressuring
the workload and scenario 3's "never entered" branch would pass for the wrong reason
-- plus volumeParks == 0, since the bound is not in that build at all.

Locally: headroom 161MB inside a 192MB reserve with volumeParks=350, against 63MB and
volumeParks=0 with the reserve compiled out.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant