Best Use & Engineering Application Guide

Engineering Category: Lossless Wire & Structural Compression

Best Use in Production: Run-length packing of AST or directory depth tokens into single-word frames for compact structural context serialization.

When to Select This Capsule: Holds the #1 Equivalence Crown across 2 functionally identical implementations (fastest verified hardware _rdtsc). Sub-10-cycle hardware kernel (1895849/200000 cyc/op); safe for ultra-hot per-sample or per-packet inner loops.

Snap-Circuit Wiring Role: 1-to-1 Unary Transform Stage `(u64)->u64` — snaps directly into linear pipelines or fan-out DAG branches.

Hardware _rdtsc: 1895849/200000 cycles/op
Latency: 514333/200000 ns/op
Throughput: 200000000/514333 ops/us
Compiled ELF64 .text: 209 B (52 x86_64 insns)
C64 64KB RAM Budget: 821/65536 (821 B source)
Ternary Vote: + (score 1) | Salience: 3235/36
Pure-Rust Capsule Source Code (821 B)
pub const fn st_golf_marqant_token_pack_swar_u64(node_word: u64) -> u64 {
    let upper6 = ((node_word & 0x0F0F_0F0F_0F0F_0F0F) << 4)
        | ((node_word >> 3) & 0x0C0C_0C0C_0C0C_0C0C);
    let d = node_word & 0x1F1F_1F1F_1F1F_1F1F;
    let diff = d ^ ((d << 8) | 0xFF);
    let m7f = 0x7F7F_7F7F_7F7F_7F7F;
    let e = (!((((diff & m7f) + m7f) | diff) | m7f)) >> 7;
    let e2 = e & (e << 8);
    let e3 = e2 & (e << 16);
    let e4 = e3 & (e << 24);
    let e5 = e4 & (e << 32);
    let e6 = e5 & (e << 40);
    let e7 = e6 & (e << 48);
    let runs = (0x0101_0101_0101_0101u64
        .wrapping_add(e)
        .wrapping_add(e2)
        .wrapping_add(e3)
        .wrapping_add(e4)
        .wrapping_add(e5)
        .wrapping_add(e6)
        .wrapping_add(e7 << 1))
        & 0x0303_0303_0303_0303;
    upper6 | runs
}
rustc -C opt-level=3 x86_64 Disassembly (209 B .text / 52 insns)
st_golf_marqant_token_pack_swar_u64:
    mov    rax, rdi
    shl    rax, 4
    movabs    rdx, -1085102592571150096
    and    rdx, rax
    mov    rax, rdi
    shr    rax, 3
    movabs    rcx, 868082074056920076
    and    rcx, rax
    or    rcx, rdx
    movabs    rax, 2242545357980376832
    lea    rdx, [rax + 31]
    and    rdx, rdi
    shl    rdi, 8
    and    rdi, rax
    or    rdi, 127
    xor    rdi, rdx
    movabs    r8, -9187201950435737472
    sub    r8, rdi
    shr    r8, 7
    movabs    rax, 72340172838076672
    mov    rsi, r8
    and    rsi, rax
    mov    rdx, rsi
    shl    rdx, 8
    and    rdx, r8
    mov    rdi, rsi
    shl    rdi, 16
    and    rdi, rdx
    mov    r8, rsi
    shl    r8, 24
    and    r8, rdi
    mov    r9, rsi
    shl    r9, 32
    and    r9, r8
    mov    r10, rsi
    shl    r10, 40
    and    r10, r9
    add    rdx, rsi
    add    rdx, rdi
    add    rdx, r8
    add    rdx, r9
    add    rdx, r10
    shl    rsi, 49
    add    r10, r10
    and    r10, rsi
    add    r10, rdx
    lea    rdx, [rax + r10]
    inc    rdx
    movabs    rax, 217020518514230019
    and    rax, rdx
    or    rax, rcx
    ret

Head-to-Head Functional Equivalence Class Peers (2 Implementation(s) Matching 64 Test Vectors)

Global RankCapsule & DomainHardware _rdtscLatencyThroughputELF .textTernary VoteAuthor Aye
#75st_golf_marqant_token_pack_swar_u64 (THIS CAPSULE)
domain: smart-tree | id: 2dd83c858706d9578b0681f75a2df2bb
1895849/200000 cyc/op514333/200000 ns/op200000000/514333 ops/us209 B .text (52 insns)+ (1)aye::Hue+Gemini(0+1)::x86_64 @ 432Hz
#1691smart_tree_marqant_token_pack
domain: smart-tree | id: c46b63760991a5e2ae0d998566749757
9813731/400000 cyc/op79303/10000 ns/op10000000/79303 ops/us442 B .text (134 insns)0 (0)aye-core-8b @ 432Hz