You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
ABI: implement the pinned Bun private-JSC profile #164
The private compatibility target is Bun 4982b91e3702094330f3be3883354c52b8c01323. Its generated inventory pins every declaration, provider, layout, calling convention, and semantic contract; mismatched revisions and drift fail explicitly.
Acceptance
Pin the exact Bun revision and private binding source set.
Inventory every required private symbol, layout, calling convention, and semantic assumption.
Implement the complete declared profile behind the private shim boundary.
Reject unknown or mismatched profile revisions.
Add generated verification and independently compiled consumer fixtures.
Reach zero missing and zero unclassified entries.
Terminal evidence
Bun profile: 437/437 implemented, zero pending/unclassified.
Independently compiled exact-consumer fixtures pass in Debug, ReleaseSafe, and TSan.
#255 adds both Bun-core contiguous-vector exports and focused runtime evidence. Progress is now 256/421 implemented, 165 pending, with the shared fixture at 261/261 and zero unclassified declarations. #254 is linked as open work.
#254 adds the Bun-core async stack export and runtime metadata. Bun core is now 257/421 implemented with 164 pending; the shared fixture is 262/262 and the Bun audit remains zero-unclassified.
Opened #256 for the next bounded private-ABI slice: validated MAP_PRIVATE shared-memfd import into exact ArrayBuffer/Uint8Array values with no-copy slice semantics and exactly-once full-region unmapping. Opaque native JSC::ArrayBuffer handles remain deliberately separate until their producer/lifetime contract is specified.
Completed #256 on main through ae61fd67 (runtime e0164ae9). Evidence: focused ownership/GC matrix green; compiled consumer 263/263; Home 264/431 with 167 pending; Bun 258/421 with 163 pending; both audits zero-unclassified; Bun-selected tags green. README/docs are current, while the 1,540-sample benchmark remains unchanged because this embedding-only path is outside the workload.
Opened #257 for the three opaque native ArrayBuffer exports plus their real bindgen producer. The pinned converter transfers RefPtr<JSC::ArrayBuffer>::leakRef() as an adopted +1, so completion requires an independent backing-store handle that can outlive its JS wrapper/VM—not a raw cell pointer or realm-retaining test adapter.
Opened #258 for the next executable private-ABI cluster: exact GetterSetter/CustomGetterSetter cells, their four null predicates, generated type checks, and non-indexed property traversal that returns descriptor cells without invoking ordinary getters.
Body sync: the Progress section had stalled at #259 (268/421). Updated to current — 277/421 implemented, 144 pending, shared fixture 287/287 — and added the three landed Bun-inventory children to the tracked list: #295 (SystemError bridges), #301 (owning-VM query), #302 (VM API-lock + execution-time-limit exports, six Bun-inventory symbols flipped with the same commits 7f6cbf17 / e1b0755f). Zero unclassified entries retained.
#306 closed — JSC__JSObject__create (Bun-only, JSObject.zig:11 / bindings.cpp:2477) is implemented and on main: fresh realm-prototype empty object + exactly one synchronous consumer initializer with pass-through ctx, canonical cell handle (identical to the returned value's exposed cell address), and same global handle; capacity documented as a performance-only hint; null-global returns empty without invoking the callback. Evidence: d7cb8529 + 61f953e5; fixture 291/291; Bun audit 281/140, Home audit unchanged at 288/143, c-api 117/117 (+297 private exports); full-suite worktree A/B on pinned 21d251ec → zero new failures. Tracker bodies synced.
Pending-symbol triage note (mirrors the #163 note; no code change):
Bun__runDeferredWork — rejected: the task is a consumer-C++-owned heap object zig-js can never construct or receive; FinalizationRegistry cleanup is already delivered engine-side via the context-owned cleanup queue.
web_worker.zig cluster (6) — deferred with the WebCore Worker/EventTarget feature area, not as one-off shims.
Bun private ABI progress: #323 landed in a40ec46, bringing the pinned core inventory to 310 implemented / 111 pending at that commit. The exact owned serialization layout, round trip, flags, exception paths, OOM, GC stability, and idempotent release are covered. Full CI: https://github.com/zig-utils/zig-js/actions/runs/29698929044.
Next Bun private-ABI child: #324 tracks the three external ZigString ownership/finalization exports deferred by #199, pinned to Bun 4982b91e with exact GC/teardown callback and compiled-consumer gates.
74b0fe3f implements the three external ZigString entries shared with Home. The regenerated pinned Bun core inventory is now 314 implemented private / 107 pending; bun-private-abi-audit passes. Acceptance matrix: https://github.com/zig-utils/zig-js/actions/runs/29702181895.
#393 core advances the pinned Bun private profile to 402/461 implemented (59 pending) in 18527d73; Debug/ReleaseSafe consumer evidence passes. #394 remains linked for the falsy-constructor inspector fallback.
Profile update: #393 and #394 are complete through 522e19c. The Bun private ABI remains 402/461 implemented with 59 explicitly pending; received-value diagnostics now have compiled consumer, source-contract, Debug, and ReleaseSafe evidence.
#396 implements eight shared Bun core imports and refreshes the exact inventory from 402 to 410 implemented private symbols, leaving 51/461 pending. Pinned Bun revision/source/protocol hashes validate, and the Bun profile library compiles/links/runs the external consumer in Debug and ReleaseSafe. CI evidence is pending in run 29766523096.
#400 moves Bun__onSignalForJS to implemented. Bun is now 416/461 implemented, 45 pending; exact 4982b91e source audit plus Debug/ReleaseSafe external consumer evidence pass.
#396, #398, and #400 are closed on green bounded CI. The Bun profile is 416/461 (45 pending); #401 is correctly Home-only and does not inflate Bun coverage.
Published Bun profile checkpoint 737bd957: 418/461 private symbols implemented, 43 pending. #401 is Home-only; #402 contributes the two shared exact module-registry shims.
New tracked child #404 owns the remaining CPU sampling-profiler ABI cluster: per-VM lifecycle, safe cooperative stack sampling, Chrome/Markdown serialization, Home/Bun output ownership, OOM, and sanitizer evidence. This keeps the three profiler symbols out of the broad pending bucket without treating link-only stubs as progress.
The three CPU profiler exports are implemented by #404 on main through 9ab79698. Bun inventory is now 424/461 (37 pending); Debug, ReleaseSafe, and TSan cross-profile fixtures are green locally.
#404 is complete. Per-VM CPU sampling profiles landed through 9ab796987fe04331761e620b2e928b9534330a4f; the exact fixing-main private-abi-boundary job passed its Debug, ReleaseSafe, and TSan evidence. The pinned counts remain Home 433/471 and Bun 424/461 at that checkpoint; #405 is the next active private-ABI slice.
#405 is implemented on main through 4275f7c2: all six pinned ReadableStream consumers now share realm-local stream/reader/controller machinery, exact Home/Bun contracts, and compiled Debug/ReleaseSafe/TSan fixtures. Inventories are now Home 439/471 (32 pending) and Bun 430/461 (31 pending). #405 remains open only for its exact fixing-main CI gate.
Created #406 for the next coherent boundary: real WebAssembly.compileStreaming/instantiateStreaming plus the pinned JSC__Wasm__StreamingCompiler__addBytes opaque feed. It explicitly preserves the frozen WG1 baseline while validating modern coverage through the existing WG3 and upstream-main profiles.
The declared exact profile is complete with zero pending/unclassified entries, and exact main e3fdc52385204c75fe6ae5c64d48dae6e5ede418 passed all 43 jobs in run 29806223245.
Activity
chrisbbreuer commentedon Jul 18, 2026
#253 complete: Bun core 254/421 with 167 pending; shared compiled consumer 259/259; zero unclassified.
chrisbbreuer commentedon Jul 18, 2026
#255 adds both Bun-core contiguous-vector exports and focused runtime evidence. Progress is now 256/421 implemented, 165 pending, with the shared fixture at 261/261 and zero unclassified declarations. #254 is linked as open work.
chrisbbreuer commentedon Jul 18, 2026
#254 adds the Bun-core async stack export and runtime metadata. Bun core is now 257/421 implemented with 164 pending; the shared fixture is 262/262 and the Bun audit remains zero-unclassified.
chrisbbreuer commentedon Jul 18, 2026
Opened #256 for the next bounded private-ABI slice: validated
MAP_PRIVATEshared-memfd import into exactArrayBuffer/Uint8Arrayvalues with no-copy slice semantics and exactly-once full-region unmapping. Opaque nativeJSC::ArrayBufferhandles remain deliberately separate until their producer/lifetime contract is specified.chrisbbreuer commentedon Jul 18, 2026
Completed #256 on main through
ae61fd67(runtimee0164ae9). Evidence: focused ownership/GC matrix green; compiled consumer 263/263; Home 264/431 with 167 pending; Bun 258/421 with 163 pending; both audits zero-unclassified; Bun-selected tags green. README/docs are current, while the 1,540-sample benchmark remains unchanged because this embedding-only path is outside the workload.chrisbbreuer commentedon Jul 18, 2026
Opened #257 for the three opaque native ArrayBuffer exports plus their real bindgen producer. The pinned converter transfers
RefPtr<JSC::ArrayBuffer>::leakRef()as an adopted +1, so completion requires an independent backing-store handle that can outlive its JS wrapper/VM—not a raw cell pointer or realm-retaining test adapter.chrisbbreuer commentedon Jul 18, 2026
Opened #258 for the next executable private-ABI cluster: exact GetterSetter/CustomGetterSetter cells, their four null predicates, generated type checks, and non-indexed property traversal that returns descriptor cells without invoking ordinary getters.
chrisbbreuer commentedon Jul 18, 2026
Body sync: the Progress section had stalled at #259 (268/421). Updated to current — 277/421 implemented, 144 pending, shared fixture 287/287 — and added the three landed Bun-inventory children to the tracked list: #295 (SystemError bridges), #301 (owning-VM query), #302 (VM API-lock + execution-time-limit exports, six Bun-inventory symbols flipped with the same commits
7f6cbf17/e1b0755f). Zero unclassified entries retained.chrisbbreuer commentedon Jul 18, 2026
Claiming the next slice:
JSC__JSObject__create(Bun-only pending,JSObject.zig:11/bindings.cpp:2477) → child issue #306. Empty-object construction with realmObject.prototype+ synchronous consumer initializer callback (Bun's struct-marshalling path). Home inventory count unaffected; shared fixture goes 290 → 291.chrisbbreuer commentedon Jul 19, 2026
#306 closed —
JSC__JSObject__create(Bun-only,JSObject.zig:11/bindings.cpp:2477) is implemented and onmain: fresh realm-prototype empty object + exactly one synchronous consumer initializer with pass-through ctx, canonical cell handle (identical to the returned value's exposed cell address), and same global handle; capacity documented as a performance-only hint; null-global returns empty without invoking the callback. Evidence:d7cb8529+61f953e5; fixture 291/291; Bun audit 281/140, Home audit unchanged at 288/143, c-api 117/117 (+297 private exports); full-suite worktree A/B on pinned21d251ec→ zero new failures. Tracker bodies synced.chrisbbreuer commentedon Jul 19, 2026
Pending-symbol triage note (mirrors the #163 note; no code change):
Bun__runDeferredWork— rejected: the task is a consumer-C++-owned heap object zig-js can never construct or receive; FinalizationRegistry cleanup is already delivered engine-side via the context-owned cleanup queue.web_worker.zigcluster (6) — deferred with the WebCore Worker/EventTarget feature area, not as one-off shims.chrisbbreuer commentedon Jul 19, 2026
Bun private ABI progress: #323 landed in a40ec46, bringing the pinned core inventory to 310 implemented / 111 pending at that commit. The exact owned serialization layout, round trip, flags, exception paths, OOM, GC stability, and idempotent release are covered. Full CI: https://github.com/zig-utils/zig-js/actions/runs/29698929044.
chrisbbreuer commentedon Jul 19, 2026
Next Bun private-ABI child: #324 tracks the three external ZigString ownership/finalization exports deferred by #199, pinned to Bun 4982b91e with exact GC/teardown callback and compiled-consumer gates.
chrisbbreuer commentedon Jul 19, 2026
Bun private ABI progress: #322 landed in f095db7; pinned core inventory is now 311 implemented / 110 pending. Exact custom-inspect call shape, styling, exceptions, cross-VM rejection, and GC roots are covered. Full CI: https://github.com/zig-utils/zig-js/actions/runs/29700271582.
chrisbbreuer commentedon Jul 19, 2026
74b0fe3fimplements the three external ZigString entries shared with Home. The regenerated pinned Bun core inventory is now 314 implemented private / 107 pending;bun-private-abi-auditpasses. Acceptance matrix: https://github.com/zig-utils/zig-js/actions/runs/29702181895.22 remaining items
chrisbbreuer commentedon Jul 20, 2026
#393 core advances the pinned Bun private profile to 402/461 implemented (59 pending) in
18527d73; Debug/ReleaseSafe consumer evidence passes. #394 remains linked for the falsy-constructor inspector fallback.chrisbbreuer commentedon Jul 20, 2026
Profile update: #393 and #394 are complete through 522e19c. The Bun private ABI remains 402/461 implemented with 59 explicitly pending; received-value diagnostics now have compiled consumer, source-contract, Debug, and ReleaseSafe evidence.
chrisbbreuer commentedon Jul 20, 2026
#396 implements eight shared Bun core imports and refreshes the exact inventory from 402 to 410 implemented private symbols, leaving 51/461 pending. Pinned Bun revision/source/protocol hashes validate, and the Bun profile library compiles/links/runs the external consumer in Debug and ReleaseSafe. CI evidence is pending in run 29766523096.
chrisbbreuer commentedon Jul 20, 2026
#398 moves five shared HTTPServer inspector imports to implemented. Bun is now 415/461 implemented, 46 pending; the pinned 4982b91e audit and external consumer pass Debug and ReleaseSafe. Fixing main CI: https://github.com/zig-utils/zig-js/actions/runs/29769670857
chrisbbreuer commentedon Jul 20, 2026
#400 moves
Bun__onSignalForJSto implemented. Bun is now 416/461 implemented, 45 pending; exact 4982b91e source audit plus Debug/ReleaseSafe external consumer evidence pass.chrisbbreuer commentedon Jul 20, 2026
#396, #398, and #400 are closed on green bounded CI. The Bun profile is 416/461 (45 pending); #401 is correctly Home-only and does not inflate Bun coverage.
chrisbbreuer commentedon Jul 20, 2026
Published Bun profile checkpoint
737bd957: 418/461 private symbols implemented, 43 pending. #401 is Home-only; #402 contributes the two shared exact module-registry shims.chrisbbreuer commentedon Jul 20, 2026
New tracked child #404 owns the remaining CPU sampling-profiler ABI cluster: per-VM lifecycle, safe cooperative stack sampling, Chrome/Markdown serialization, Home/Bun output ownership, OOM, and sanitizer evidence. This keeps the three profiler symbols out of the broad pending bucket without treating link-only stubs as progress.
chrisbbreuer commentedon Jul 20, 2026
The three CPU profiler exports are implemented by #404 on main through
9ab79698. Bun inventory is now 424/461 (37 pending); Debug, ReleaseSafe, and TSan cross-profile fixtures are green locally.chrisbbreuer commentedon Jul 20, 2026
Next Bun pending cluster is tracked in #405: six readable-stream conversion exports and their required stream state machine.
chrisbbreuer commentedon Jul 20, 2026
#404 is complete. Per-VM CPU sampling profiles landed through
9ab796987fe04331761e620b2e928b9534330a4f; the exact fixing-mainprivate-abi-boundaryjob passed its Debug, ReleaseSafe, and TSan evidence. The pinned counts remain Home 433/471 and Bun 424/461 at that checkpoint; #405 is the next active private-ABI slice.chrisbbreuer commentedon Jul 20, 2026
#405 is implemented on
mainthrough4275f7c2: all six pinned ReadableStream consumers now share realm-local stream/reader/controller machinery, exact Home/Bun contracts, and compiled Debug/ReleaseSafe/TSan fixtures. Inventories are now Home 439/471 (32 pending) and Bun 430/461 (31 pending). #405 remains open only for its exact fixing-main CI gate.chrisbbreuer commentedon Jul 20, 2026
Created #406 for the next coherent boundary: real
WebAssembly.compileStreaming/instantiateStreamingplus the pinnedJSC__Wasm__StreamingCompiler__addBytesopaque feed. It explicitly preserves the frozen WG1 baseline while validating modern coverage through the existing WG3 and upstream-main profiles.chrisbbreuer commentedon Jul 21, 2026
The declared exact profile is complete with zero pending/unclassified entries, and exact main
e3fdc52385204c75fe6ae5c64d48dae6e5ede418passed all 43 jobs in run 29806223245.