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

Roadmap: implement every README-declared missing runtime surface #134

Closed

Description

@chrisbbreuer

Goal

Implement every runtime and platform surface currently called out in the README's What Is Not Implemented section, with checked-in compatibility inventories and reproducible evidence, so that the section can be removed without qualification.

This is an umbrella issue. Each independently reviewable implementation slice should have its own linked child issue before substantial work begins.

Scope

1. JavaScriptCore compatibility surfaces

  • Check in a versioned inventory of the public JavaScriptCore C API and implement every symbol in the declared target.
  • Check in version-pinned inventories for the private framework/internal surfaces we intentionally target, then implement every inventoried entry.
  • Implement and test the Objective-C bridge, including object/value conversion, exceptions, lifetimes, blocks/callables, and cross-runtime identity.
  • Implement inspector/debugger APIs and protocol behavior, including attach/detach, breakpoints, stepping, evaluation, stack/scope inspection, pause/resume, and exception events.
  • Define version-pinned Bun and Home private-JSC ABI compatibility profiles and implement every symbol and behavior in those profiles.
  • Reject unsupported ABI versions explicitly; no silent no-ops or accidental partial compatibility.

Complete here means complete for the exact checked-in target inventories. Private ABIs are moving targets, so each supported revision must be named and auditable rather than described as universal compatibility.

2. WebAssembly

  • Parser, binary decoder, validator, and deterministic malformed-module diagnostics.
  • Module compilation/instantiation and JS-facing Module, Instance, Memory, Table, Global, and Function behavior.
  • Imports, exports, start functions, traps, growth, bounds checks, numeric conversions, and JS/Wasm exception boundaries.
  • Declare and implement the chosen post-MVP feature set (reference types, bulk memory, multi-value, SIMD, threads, exceptions, GC, etc.) in versioned feature profiles.
  • Run the applicable upstream WebAssembly specification tests with an explicit zero-hidden-skip inventory for the supported profiles.

3. PR-249 reference corpus and shell hooks

  • Inventory every WebAssembly/JIT shell hook used by the PR-249 reference corpus.
  • Promote each relevant reference-only hook into maintained runtime functionality with tests and documentation.
  • Remove or explicitly disposition every corpus exclusion; no untracked skip lists.

4. Production generational GC

5. Optimizing JIT

Removal gate

The README section may be removed only when all of the following are true:

  • Every checklist item above is complete or decomposed into completed linked child issues.
  • A checked-in compatibility matrix names exact OS, architecture, JSC, Bun/Home ABI, WebAssembly feature, GC, and JIT targets.
  • Normal, thread-heavy, no-GIL, leak, sanitizer/TSan, differential, inspector, bridge, API/ABI, WebAssembly, and JIT suites pass for the declared matrix.
  • Relevant upstream/reference corpora publish machine-readable pass/fail/skip inventories, with no unexplained exclusions.
  • Benchmarks and README claims are regenerated from committed artifacts and clearly distinguish correctness coverage from performance coverage.
  • Unsupported hosts or revisions fail clearly at build or runtime rather than exposing partial behavior.

Related work

Child issue map

Public and private embedding

WebAssembly and reference corpus

GC and JIT

Completion evidence

Latest evidence

WebAssembly MVP #141 and its exact wg-1.0 corpus chain #260/#261 remain complete. The versioned post-MVP foundation #262, Core 2 numeric operations #269, and complete structural baseline #263/#270-#278 are now complete. The committed Core 2 inventory at 12ce485e pins official wg-2.0 and WABT 1.0.39 exactly: 27,437/27,437 applicable commands pass across all 90 files, 581 text-format commands are explicitly not applicable, and failures/runner errors are zero. Bounded CI landed in a593fdea; README and detailed evidence were refreshed in 66a953a6. The most recent batched full engine checkpoint remains 1,002/1,002 at af689c4a, and the general JavaScript comparison remains the validated 1,540-sample July 17 matrix because these WebAssembly paths do not execute in its workloads. Fixed-width SIMD #264/#279-#283 is now complete: the exact pinned 56-file score is 25,466/25,466 applicable commands with zero failures/runner errors, and the separate July 18 SIMD matrix preserves 224 scalar/JSC samples with every median above 50 ms. Terminal inventory, CI, architecture/fallback declarations, raw artifacts, README, and reproduction landed through be438ae0. Multi-memory #305 is complete with 829/829 pinned commands and documented robustness/sanitizer gates. Remaining WebAssembly roadmap work is #265-#268. PR-249 foundation #311 pins and checksums all 339 vendored files. #428 is complete at e6d15b1e/fa71b012: the verifier classifies all 259 executables as 243 promoted, 10 optimizing-JIT blocked by #429, and 6 executable terminal dispositions; all five helpers remain classified, and inventory/hook/disposition/evidence drift fails closed. Private property iteration #368 is complete at 4be4789d with its evidence label refreshed at 01cfa77b: Home is now 352/471 private symbols implemented (119 pending), Bun is 344/461 (117 pending), the shared Home consumer links 339/339 symbols, and a dedicated Bun compile-link-runtime fixture passes in Debug and ReleaseSafe.

ArrayBuffer ownership #369 is complete at 07a3e398: Home is 356/471 private symbols implemented (115 pending), Bun is 348/461 (113 pending), both inventories have zero unclassified entries, the Home consumer links 343/343, and the focused engine plus dedicated Bun fixtures pass in Debug and ReleaseSafe.

Value-key property work #370 is complete at 01b3aef3: Home is 359/471 private symbols implemented (112 pending), Bun is 351/461 (110 pending), both inventories have zero unclassified entries, the Home consumer links 346/346, and focused engine plus Bun-profiled fixtures pass in Debug and ReleaseSafe.

Private C-API extensions #371 are complete at 930f177b: Home is 361/471 private symbols implemented (110 pending), Bun is 353/461 (108 pending), both inventories have zero unclassified entries, the Home consumer links 348/348, and focused engine plus dedicated Bun fixtures pass in Debug and ReleaseSafe.

Exact JSC Math.pow operation #372 is complete at 3e96dde2: the private C export and JavaScript builtin share one edge-correct implementation; Home is 362/471 (109 pending), Bun is 354/461 (107 pending), Home links 349/349, and focused plus compiled-consumer evidence passes in Debug and ReleaseSafe.

Current private-ABI evidence

At 172fea6, Home is 375/471 implemented (96 pending), Bun is 367/461 (94 pending), the Home consumer links 362/362, and the focused Bun DOMFormData fixture links 10/10. Debug and ReleaseSafe pass, including 25/25 relocation tests.

Latest private-ABI checkpoint

At 9c51dee, Home is 376/471 implemented (95 pending), Bun is 368/461 (93 pending), and the Home fixture links 363/363. Debug and ReleaseSafe pass for the shared Home and exact Bun evidence.

Checkpoint at 6427d1c: #392 is complete. Home is 409/471 private implemented (62 pending); Bun is 401/461 (60 pending). Exact multi-VM, detach/reentrancy, Debug, and ReleaseSafe evidence passes with zero leaks; benchmark scores are unchanged because this is compatibility work.

Checkpoint at 4275f7c: #404 is complete with exact fixing-main CI evidence. #405 implements all six pinned ReadableStream consumers and is awaiting only its exact main CI gate. Home is 439/471 private symbols implemented (32 pending); Bun is 430/461 (31 pending). Focused engine and external Home/Bun consumers pass in Debug, ReleaseSafe, and TSan; README benchmark scores are unchanged because this is compatibility work.

July 28, 2026 PR-249 terminal checkpoint

f6f8ef1b completes #143, #429, and #430. The pinned 339-file reference tree now records 259 executables as 253 promoted, 0 blocked, and 6 verifier-enforced terminal dispositions, plus five helpers outside the denominator. ReleaseSafe passes 246/246 serialized-required and 253/253 no-GIL-required promoted cases with zero failures or skips; all six terminal dispositions match in both modes. The release matrix reached 9/12 green at that checkpoint.

July 29, 2026 optimizer release checkpoint

9e51e1ff completes #146, #433, and #434. The sole declared optimizer backend is macOS AArch64; 24 seeded serialized/no-GIL differentials require real publication and exact guard deoptimization, normal and TSan focused gates pass 176/176, the full unit suite passes 1,452/1,452, and unsupported macOS/Linux x86-64 builds remain explicit fallback. The machine-readable optimizer inventory and dated raw JavaScriptCore artifact move the release matrix to 10/12 green. Remaining roadmap blockers are #446 automatic shared compaction evidence and #447 moving nursery.

Activity

  1. chrisbbreuer commented on Jul 16, 2026

    @chrisbbreuer
    MemberAuthor

    README tracking link landed on main in 8bf959db. This issue is now the removal gate for the documented unsupported-surface list.

  2. chrisbbreuer commented on Jul 16, 2026

    @chrisbbreuer
    MemberAuthor

    Roadmap decomposition is now linked in the issue body as #135–#147. The first implementation slice, #136, landed on main in 82b8e50a and 7bf1712f: public TypedArray/ArrayBuffer construction and inspection, true no-copy backing stores, and exactly-once failure/finalization lifetime handling. Full unit evidence: 783/783, zero skips/failures/leaks. #136 stays open for its #135 header and C compile-link gate.

  3. chrisbbreuer commented on Jul 17, 2026

    @chrisbbreuer
    MemberAuthor

    Inspector/debugger scope #139 is complete. Worker target child #156 closed through 1060784 with protocol parity, simultaneous independent targets, precise-GC root evidence, and deterministic teardown. The README no longer lists worker inspector parity as missing.

    The umbrella now accurately remains open for #138, #140–#147: Objective-C/private ABI profiles, WebAssembly/reference hooks, moving/multi-age/parallel-minor GC, optimizing JIT, and the final compatibility/removal gate.

  4. chrisbbreuer commented on Jul 17, 2026

    @chrisbbreuer
    MemberAuthor

    Objective-C bridge parent #138 and children #157–#161 are complete through f29ca38: pinned 108/108 SDK inventory, semantic managed clearing, typed blocks and JSExport, same-VM cross-context identity, 18-row system-JSC parity (360c1ad3ccf51d6b), 200-cycle ASan/UBSan lifetime stress, deterministic allocation/registration rollback, and Apple leaks at 0 bytes. README/API commands and the What Is Not Implemented boundary are updated. The umbrella remains open for private/Bun/Home ABIs, WebAssembly/reference hooks, moving/multi-age GC, parallel mid-script minor collection, and optimizing JIT.

  5. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    Closed private-ABI child #253 on main through 657cbba8; parent checklists and latest evidence are updated.

  6. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    #255 is complete on main through 779f7eff (runtime 481f8ddc), with the roadmap body updated to 262/431 Home, 256/421 Bun, and 261/261 compiled fixture coverage. #254 is now explicitly linked as the remaining async-stack implementation slice. Current benchmark evidence is unchanged because these private embedding exports are outside its measured workloads.

  7. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    #254 is complete on main through 0ccdad67 (runtime 0c5e5441). Roadmap evidence is now Home 263/431, Bun 257/421, compiled fixture 262/262, and zero unclassified declarations; the current benchmark remains unchanged because this diagnostic ABI is not measured.

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

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

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

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

  12. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    WebAssembly profile foundation #262 is complete on main through af10c01c. The checked-in registry pins 12 proposal revisions across 4 profiles; dependency closure and registry/runtime/gate drift are CI-enforced; disabled and enabled-but-unimplemented features reject deterministically. Focused WebAssembly evidence is 126/126 passing. Continuing with the Core 2.0 baseline in #263.

  13. chrisbbreuer commented on Jul 18, 2026

    @chrisbbreuer
    MemberAuthor

    Completed Core 2.0 numeric slice #269 on main through 56273afc: all 5 sign-extension and 8 nontrapping conversion instructions decode, validate, instantiate, and execute behind explicit realm feature switches. Default-realm rejection and public JavaScript API execution are covered. Focused WebAssembly evidence is now 133/133 passing; the July 17 benchmark matrix remains current because these paths are outside its workloads. Continuing with structural Core 2.0 issue #263.

  14. 126 remaining items

  15. chrisbbreuer commented on Jul 22, 2026

    @chrisbbreuer
    MemberAuthor

    July 22 roadmap update:

  16. chrisbbreuer commented on Jul 22, 2026

    @chrisbbreuer
    MemberAuthor

    #450 is complete on main through 96d54ac2, 59063a77, and d372d0ae: reducible optimizer loops now execute exact allocating calls, construction, and literal effects. Focused normal and TSan gates pass 4/4. #449 remains open for direct append/growth/reallocation specialization, measured tier arbitration against the existing VM packed-push/sum kernels, exact-parent profiling, and broad #133 gates. The accepted README benchmark matrix is unchanged because those published workloads still select the VM kernels.

  17. chrisbbreuer commented on Jul 22, 2026

    @chrisbbreuer
    MemberAuthor

    Optimizing-JIT checkpoint: #451 closed in a2010acc/90de5f08. AArch64 now directly executes guarded spare-capacity exact-end assignment, literal append, and one-argument intrinsic push, with callback fallback for every allocating/observable/shared case. Focused normal and TSan packed/allocating batches pass, the release matrix remains 6/12 green with private ABI pending=0, and README benchmark scores remain the accepted July 22 matrix because the published arrays workload still selects the older VM packed kernels. #133/#449 remain open for reallocation, wider push forms, measured arbitration/profile, and broad evidence.

  18. chrisbbreuer commented on Jul 22, 2026

    @chrisbbreuer
    MemberAuthor

    Packed-array optimizer checkpoint update: #452 and parent #449 are complete through f4916c3/c4436ade. Zero/variadic direct push and precisely rooted reallocating push preserve failure-atomic OOM, canonical observable fallbacks, exact steps, moving-GC roots, and shared semantics. Focused normal/TSan plus normal/TSan shared contention pass. The exact-parent profile keeps the published arrays workload on existing VM packed kernels, so README benchmark scores remain unchanged. #453 tracks one targeted residual-dispatch witness and the single combined full-unit/no-GIL/TSan gate needed to finish #133; #146 and this release umbrella remain open.

  19. chrisbbreuer commented on Jul 22, 2026

    @chrisbbreuer
    MemberAuthor

    #133 and its #448–#453 child chain are complete through 8ec5529. Exact-parent attribution moves all measured reallocations out of general optimizer dispatch, the published arrays workload retains its faster VM-kernel priority, README benchmark scores remain unchanged, and the combined 1,409-unit/no-GIL/TSan/publication/release checkpoint passes. #146 remains open for #433, #434, and #429; this umbrella remains open for its independent GC/reference/final removal gates.

  20. chrisbbreuer commented on Jul 22, 2026

    @chrisbbreuer
    MemberAuthor

    #456/#457 roadmap checkpoint: 01306740 adds mutation-driven Class-A invalidation for published native property assumptions, cooperative-GC-aware conductor acquisition, and the missing outer execution lease for VM functions entered from the tree walker. 427ba867 updates the concise README and checked-in concurrency evidence. Focused normal and TSan Class-A gates pass 4/4.

    The two exact PR-249 GC-wait/Class-A cases remain blocked rather than receiving a vacuous promotion: they require inherited-property specialization and dependency watchpoints, now explicitly tracked by #457. Accepted benchmark scores are unchanged because the published workloads and selected tiers did not change.

  21. chrisbbreuer commented on Jul 29, 2026

    @chrisbbreuer
    MemberAuthor

    Roadmap checkpoint from f6f8ef1b: the PR-249 reference surface is terminal. #143, #429, and #430 are complete; the exact pin records 253 promoted, 0 blocked, 6 terminal dispositions, and five helpers. Complete ReleaseSafe serialized/no-GIL evidence is machine-readable and CI-verified. The release matrix is 9/12 green, leaving #446, #447, and #434/#146 as the implementation/evidence blockers before #147/#246.

  22. chrisbbreuer commented on Jul 29, 2026

    @chrisbbreuer
    MemberAuthor

    Roadmap checkpoint 9e51e1ff: #146/#434 are complete, all optimizer checklist items are reconciled, and the generated matrix is 10/12 green. Only #446 and #447 remain as implementation/evidence blockers before #147/#246 can finish.

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

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions