镜像站点 · 本页由第三方 GitHub 只读镜像提供,非 GitHub 官方站点,不接受任何登录或凭据输入。前往 github.com
Skip to content

ABI: implement the pinned Bun private-JSC profile #164

Closed

Description

@chrisbbreuer

Parent: #140

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

Activity

  1. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    #253 complete: Bun core 254/421 with 167 pending; shared compiled consumer 259/259; zero unclassified.

  2. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    #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.

  3. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    #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.

  4. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  5. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  6. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  7. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  8. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  9. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    Claiming the next slice: JSC__JSObject__create (Bun-only pending, JSObject.zig:11 / bindings.cpp:2477) → child issue #306. Empty-object construction with realm Object.prototype + synchronous consumer initializer callback (Bun's struct-marshalling path). Home inventory count unaffected; shared fixture goes 290 → 291.

  10. chrisbbreuer commented on Jul 19, 2026

    @chrisbbreuer
    MemberAuthor

    #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.

  11. chrisbbreuer commented on Jul 19, 2026

    @chrisbbreuer
    MemberAuthor

    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.
  12. chrisbbreuer commented on Jul 19, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  13. chrisbbreuer commented on Jul 19, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  14. chrisbbreuer commented on Jul 19, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  15. chrisbbreuer commented on Jul 19, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  16. 22 remaining items

  17. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    #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.

  18. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  19. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    #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.

  20. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    #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

  21. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    #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.

  22. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    #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.

  23. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  24. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  25. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  26. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    Next Bun pending cluster is tracked in #405: six readable-stream conversion exports and their required stream state machine.

  27. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    #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.

  28. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    #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.

  29. chrisbbreuer commented on Jul 20, 2026

    @chrisbbreuer
    MemberAuthor

    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.

  30. chrisbbreuer commented on Jul 21, 2026

    @chrisbbreuer
    MemberAuthor

    The declared exact profile is complete with zero pending/unclassified entries, and exact main e3fdc52385204c75fe6ae5c64d48dae6e5ede418 passed all 43 jobs in run 29806223245.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions