tetration 0.1.8

Chunked tensor .tet format, tet CLI, and optional C ABI (tetration-ffi)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# `query/decode` — chunk payload decode

Low-level bridge from **mmap'd file bytes** to decoded tile payloads and scatter into logical layouts.

## Files

| File              | Role                                                                          |
| ----------------- | ----------------------------------------------------------------------------- |
| `chunk_decode.rs` | Decode one chunk (raw/zstd via `catalog` codecs); `planned_chunk_mmap_slices` |
| `indexing.rs`     | Map global logical indices ↔ chunk-local offsets                              |
| `dense_visit.rs`  | Visit elements in row-major logical order                                     |

## Role in the pipeline

```text
ReadPlan.planned_chunks
    → slice mmap [payload_offset, payload_offset + stored_len)
    → decode_tile_payload → row-major tile bytes
    → scatter into materialized buffer OR fold partial OR GPU upload
```

Does **not** interpret query operations — only bytes → logical tensor pieces.

## Related

- Codec rules: `catalog::ChunkPayloadCodecV1`
- Dense assembly: `materialize/`
- Streaming without full buffer: `fold/linear_scan`, `gpu/streaming_fold`