Module arrow_module 

Native arrow module for reading Arrow IPC files.

Exports: arrow.read_table, arrow.read_tables, arrow.metadata

All operations require FsRead permission.

W17-out-of-bundle-A-followups (2026-05-12): arrow.read_tables currently surfaces structured-stop. Per the C+ precedent in phase-2d-playbook.md §3, Array<DataTable> is genuinely homogeneous in HeapKind::DataTable — the natural Q25.A specialized variant is a TypedArrayData::DataTable(Arc<TypedBuffer<Arc<DataTable>>>) arm, which is out of scope for this sub-cluster (the prompt explicitly forbids new HeapKind variants and an added TypedArrayData variant would require ~40 exhaustive-match updates). The surface message names the natural follow-up sub-cluster so production callers see the structured error rather than a panic.

Phase 2d Array cluster migration (historical context, 2026-05-07): ported to the typed marshal layer. arrow.read_tables returned Array<DataTable> via ConcreteReturn::ArrayHeapValue — each element was an Arc<HeapValue::DataTable>. Post-Q25.A, build_specialized_from_heap_arcs does not have a DataTable arm, so the marshal projection surfaces a structured error.

Tests deferred — ValueWord-based test fixtures can’t compile and aren’t reconstructed until the shape-vm cascade provides a typed test harness, mirroring the file_ops migration in commit d716482.

Functions

create_arrow_module

Create the arrow module with Arrow IPC file reading functions.