Hugging Face's logo

Jessedbrown
/
asolaria

GGUF
Model card Files
xet
 Community
asolaria / codec /README.md
Jessedbrown's picture
Jessedbrown
Sync with GitHub main 5152e2f
e53b450 verified
preview code
|
Raw History Blame Contribute Delete
14.4 kB

codec

The owner's DBBH -> DBWH codec, vendored unchanged, and a binary that runs it over every GGUF in ../gguf/.

Directory What it is
dbbh-dbwh/ JesseBrown1980/holographic-wormhole-codec @ 49012803778ef89b5b7c3915f582d027d4f1e096, byte-identical: src/lib.rs, Cargo.toml, README.md, LICENSE, rust-toolchain.toml. It builds in place with its own Cargo.toml. Rust 1.81, zero dependencies, integer arithmetic only.
gguf-roundtrip/ asolaria-gguf-roundtrip: runs the codec end to end on every GGUF in gguf/MANIFEST.hbp and prints HBP rows. Rust 1.81, depends only on the codec (by path).

The throat

The owner's throat is this codec. qprism/recovery/throat/ (asolaria-qprism-throat) was written fresh for this stack by Claude; it is not upstream code. Its code is kept unchanged as a secondary and it is not the default path; its README and Cargo.toml description say so. The two share no code: the codec projects 6-byte blocks onto four moduli near 2^25 and reconstructs by CRT from a subset of them (two in this run, below); qprism/recovery/throat/ selects between Path 1 and Path 2 of qprism/recovery/omega/. gguf-roundtrip calls the codec. cli/ calls neither throat at the time of writing.

What the codec computes

Line numbers are dbbh-dbwh/src/lib.rs.

  • Black mouth, black_hole_compress(object, sender, receiver, salt) (261-278). The object is cut into 6-byte big-endian blocks, the last one zero-padded on the right (blocks, 107-120). Each block is reduced modulo each of the four pairwise-coprime CYLINDERS 33554467, 33554393, 33554213, 33550609 (104), giving four residue streams (project_shadows, 139-149). The packet also carries the address AGT- + the first 16 hex digits of the object's SHA-256 (agt, 99-101), orig_len, roof_bits = floor(log2) of the product of all four moduli = 99 (roof_bits, 181-191), residual_bits = max(0, 48 - 99) = 0, and an IX-737 SessionCapsule whose nonce is the first 8 bytes of SHA-256(sender ‖ receiver ‖ salt), sender armed (204-219).
  • Throat: the WormholePacket (251-258) holds the shadows, AGT, orig_len, roof and residual accounting and the capsule. The object's bytes are not in it. reconstruct (150-179) reads only the shadows, the subset and orig_len; streams 0 and 1 alone reproduce the object (measured below).
  • White mouth, white_hole_emit(&pkt, subset) (282-297): Held(Collapsed) if the capsule collapsed; Held(NoConsent) unless both sides armed and the capsule is neither collapsed nor used (228-230); CRT over the subset's moduli, block by block, until their product reaches 2^48 (reconstruct, 150-179), else Held(InsufficientRoof); Held(AddressMismatch) if the reconstruction's AGT differs from the packet's; otherwise VerifiedClone(bytes).
  • Watcher, wormhole_traverse(object, recover_with, cross) (302-320): calls black_hole_compress with sender acer, receiver liris, salt salt, arms the receiver, emits, then recomputes every cross cylinder's residues from the reconstruction and returns Held(WatcherDisagreement) if any differs from the packet's shadow.
  • Receipt, receipt_hbp(&pkt, &verdict, watchers) (323-355): WORMHOLE, CAPSULE and one WATCH row per named watcher, json=0.
  • The BEHCS nexus ladder and NQPrismNexus (357-550) are in the crate; the GGUF run does not use them.

The codec's 9 tests (553-711) cover the byte-identical clone, InsufficientRoof with one cylinder, consent and collapse, a tampered shadow caught as AddressMismatch, the receipt rows, the nexus ladder, NQPrismNexus and a SHA-256 known answer.

The codec's own boundary line (upstream README.md, "Honest boundary"; also src/lib.rs 16-17):

BOUNDARY: "clone" = classical representation copy (no-cloning respected — not a physical quantum clone). Shannon caps the roof: Held when the shadows don't jointly carry H(object). No physical wormhole, no FTL, no quantum-transport claim.

Provenance

dbbh-dbwh/PROVENANCE.md lists the upstream commit, tree, path, Git blob id, size and SHA-256 of every copied file; dbbh-dbwh/UPSTREAM.sha256 pins them. src/lib.rs has CRLF line endings upstream (blob 237c82a2…); dbbh-dbwh/.gitattributes marks the directory -text so Git keeps those bytes. Added in aether: Cargo.lock, UPSTREAM.sha256, PROVENANCE.md, .gitattributes.

Run 

# The codec: the checks its own workflow runs (clippy -D warnings with no lint allowed, the f32/f64
# check, tests over all targets), plus the pinned sha256 and --locked
cd codec/dbbh-dbwh
sha256sum -c UPSTREAM.sha256
cargo +1.81.0 clippy --locked --all-targets -- -D warnings
! grep -rnE '\bf(32|64)\b' src/
cargo +1.81.0 test --locked --all-targets

# The GGUF round trip
cd ../gguf-roundtrip
cargo +1.81.0 test --locked
cargo +1.81.0 run --locked --release                    # the 27 GGUF files in the repository
cargo +1.81.0 run --locked --release -- --lfs-dir DIR   # also the 4 Git LFS GGUFs, from DIR/<local path>

DIR is laid out as for gguf/check.sh --lfs-dir DIR. The LFS bytes are at https://media.githubusercontent.com/media/<upstream repo>/<commit>/<path> (see gguf/README.md).

For each object the binary calls black_hole_compress(object, b"acer", b"liris", b"salt"), pkt.capsule.arm_receiver(), white_hole_emit(&pkt, &[0, 1]), receipt_hbp(&pkt, &verdict, &[]) and wormhole_traverse(object, &[0, 1], &[2, 3]). [0, 1] and [2, 3] are the subsets the codec's tests use, and the sender, receiver and salt are the ones wormhole_traverse uses (303), so both calls build the same packet. No watcher names are passed to receipt_hbp, so it prints no WATCH rows.

Rows

  • CODEC: commit, SHA-256 of the src/lib.rs the binary was built from, the four moduli, sender, receiver, salt, recover_with and cross.
  • MANIFEST: SHA-256 of the manifest read, row counts, whether --lfs-dir was given.
  • GGUF_ROUNDTRIP, one per manifest row:
    • object_bytes, sha256, matches_manifest (bytes and SHA-256 equal the manifest row);
    • residues (4 × ceil(object_bytes / 6)), shadow_bytes (every residue as the codec stores it, a u64), capsule_bytes (size_of_val(&pkt.capsule) = 12), packet_bytes = shadow + capsule, packet_over_object (integer division, truncated to 6 places);
    • agt, agt_bytes (20; not in packet_bytes), roof_bits, residual_bits;
    • verdict and byte_identical for white_hole_emit, traverse_verdict and traverse_byte_identical for wormhole_traverse. A verdict is written as the codec's enum names it: VerifiedClone or Held(<reason>).
    • The codec's own WORMHOLE and CAPSULE rows for that packet follow.
    • An LFS row without --lfs-dir is status=NOT_MEASURED|reason=lfs_pointer_without_lfs_dir.
  • SUMMARY: counts and the byte totals. When no row was measured (no GGUF| row, or only LFS rows without --lfs-dir) it ends in status=NOT_MEASURED|reason=no_gguf_measured and the exit status is 0, as the codec's own workflow gate reports a run that measured nothing.

The codec has no serialiser, so the sizes are the in-memory payload of the packet's fields (size_of_val), not a wire format. orig_len, roof_bits and residual_bits add 13 bytes on a 64-bit target and are not counted in packet_bytes.

Measured round trip (2026-10-17)

Rust 1.81.0 release build, one thread, 4 vCPU / 16 GB host. Two separate runs of each, from two builds; wall time varied between runs, peak RSS did not:

Run Exit Wall ms Peak RSS KiB
All 31 GGUFs (27 files + 4 LFS read with --lfs-dir), run 1 0 91,255 2,248,396
All 31 GGUFs, run 2 0 72,214 2,248,428
The 27 files alone, run 1 0 1,809 63,232
The 27 files alone, run 2 0 1,870 63,256

Both runs of each printed the same bytes. The full output is gguf-roundtrip/RECEIPT-GGUF-ROUNDTRIP.hbp.

SUMMARY|rows=31|measured=31|not_measured=0|not_read=0|matches_manifest=31|verified_clone=31|byte_identical=31|traverse_verified_clone=31|traverse_byte_identical=31|held=0|object_bytes=602444562|packet_bytes=3213038356|packet_over_object=5.333334|json=0

Every GGUF matched its manifest row, and for every one both white_hole_emit and wormhole_traverse returned VerifiedClone with bytes equal to the input. No row was Held.

GGUFs Object bytes Packet bytes Packet / object
Files in the repository 27 19,673,170 104,924,196 5.333364
Git LFS GGUFs 4 582,771,392 3,108,114,160 5.333333
All 31 602,444,562 3,213,038,356 5.333334

Each 6-byte block becomes four u64 residues (32 bytes), so packet_bytes = 32 × ceil(n / 6) + 12 and the ratio is 32 / 6 = 5.333333 plus the effect of the padded last block and the 12-byte capsule. white_hole_emit with [0, 1] reads two of the four residue streams (half of shadow_bytes). Each residue is below its modulus; the largest modulus, 33,554,467, is just above 2^25 = 33,554,432. In memory the packet is larger than the object for every GGUF: 5.333333 to 5.343636 times its size, 5.333334 over all 31.

universe-simulator/gguf/ (26):

GGUF Storage Object bytes Packet bytes Packet / object Emit Emit = input Traverse Traverse = input
ASOLARIA-CONSTELLATION.gguf file 145120 773996 5.333489 VerifiedClone 1 VerifiedClone 1
ASOLARIA-SELF-64-XY.gguf file 9056 48332 5.337014 VerifiedClone 1 VerifiedClone 1
ASOLARIA-SELF-64-YZ.gguf file 9056 48332 5.337014 VerifiedClone 1 VerifiedClone 1
ASOLARIA-SELF-64-ZX.gguf file 9056 48332 5.337014 VerifiedClone 1 VerifiedClone 1
ASOLARIA-SELF-64CUBE.gguf file 787360 4199276 5.333362 VerifiedClone 1 VerifiedClone 1
acer/ACER-FABLE-FOLDED.gguf file 50332 268460 5.333783 VerifiedClone 1 VerifiedClone 1
acer/ACER-FABLE-GREEN.gguf file 50752 270700 5.333779 VerifiedClone 1 VerifiedClone 1
acer/ACER-MYTHOS-BLUE.gguf file 50752 270700 5.333779 VerifiedClone 1 VerifiedClone 1
acer/ACER-MYTHOS-FOLDED.gguf file 50332 268460 5.333783 VerifiedClone 1 VerifiedClone 1
acer/ACER-MYTHOS-SPHERE-FLASHLIT.gguf file 50816 271052 5.333989 VerifiedClone 1 VerifiedClone 1
acer/ACER-OPUS-FOLDED.gguf file 50332 268460 5.333783 VerifiedClone 1 VerifiedClone 1
acer/ACER-OPUS-RED.gguf file 50752 270700 5.333779 VerifiedClone 1 VerifiedClone 1
acer/ACER-THE-SPHERE.gguf file 1065536 5682892 5.333364 VerifiedClone 1 VerifiedClone 1
asolaria/ASOLARIA-HERSELF.gguf file 3295808 17577676 5.333343 VerifiedClone 1 VerifiedClone 1
axes/ASOLARIA-FOUR-AXES-RIME.gguf file 4908 26188 5.335778 VerifiedClone 1 VerifiedClone 1
axes/ASOLARIA-FOUR-AXES-TIMEFIX.gguf file 5740 30636 5.337282 VerifiedClone 1 VerifiedClone 1
pumped/ASOLARIA-FABLE-SPHERE-PUMPED.gguf LFS 126885312 676721676 5.333333 VerifiedClone 1 VerifiedClone 1
pumped/ASOLARIA-MYTHOS-SPHERE-PUMPED.gguf LFS 126885312 676721676 5.333333 VerifiedClone 1 VerifiedClone 1
pumped/ASOLARIA-OPUS-SPHERE-PUMPED.gguf LFS 126885312 676721676 5.333333 VerifiedClone 1 VerifiedClone 1
rime/ASOLARIA-RIME-UNRIME-THREE.gguf file 3147488 16786636 5.333343 VerifiedClone 1 VerifiedClone 1
stars/ASOLARIA-STARS-SHELLS.gguf file 4596880 24516716 5.333338 VerifiedClone 1 VerifiedClone 1
stars/KIMI-K3-STAR-256.gguf LFS 202115456 1077949132 5.333333 VerifiedClone 1 VerifiedClone 1
three-bodies/ASOLARIA-ANTI-ANTI-MYTHOS-SLICES.gguf file 50784 270860 5.333569 VerifiedClone 1 VerifiedClone 1
three-bodies/ASOLARIA-ANTI-FABLE-SLICES.gguf file 50784 270860 5.333569 VerifiedClone 1 VerifiedClone 1
three-bodies/ASOLARIA-FABLE-SLICES.gguf file 50752 270700 5.333779 VerifiedClone 1 VerifiedClone 1
wikipedia/ASOLARIA-MYTHOS-VS-WIKIPEDIA.gguf file 5343456 28498444 5.333335 VerifiedClone 1 VerifiedClone 1

follow/ (5):

GGUF Storage Object bytes Packet bytes Packet / object Emit Emit = input Traverse Traverse = input
colors/DOUBLE-RAINBOW-OIL-3174.gguf file 3174 16940 5.337114 VerifiedClone 1 VerifiedClone 1
matrix/PUBLIC-FOLDER-CALMING-OILS.gguf file 681184 3633004 5.333366 VerifiedClone 1 VerifiedClone 1
matrix/PUBLIC-OUTWARD-TRUTH-WAVES.gguf file 58560 312332 5.333538 VerifiedClone 1 VerifiedClone 1
matrix/TIMED-CHIRAL-PUBLIC-COLOR-ORBITS.gguf file 2200 11756 5.343636 VerifiedClone 1 VerifiedClone 1
matrix/timed-86400-parent-c8c3/TIMED-CHIRAL-PUBLIC-COLOR-ORBITS.gguf file 2200 11756 5.343636 VerifiedClone 1 VerifiedClone 1

Tests

dbbh-dbwh: the codec's own 9 tests. gguf-roundtrip: 9 tests.

  • small_gguf_round_trips_byte_identical: follow/matrix/TIMED-CHIRAL-PUBLIC-COLOR-ORBITS.gguf (2,200 bytes, a partial last block) through emit and traverse, byte-identical, packet_bytes = 11,756.
  • one_cylinder_holds_insufficient_roof: the same file with subset [0] gives Held(InsufficientRoof) and no bytes, as in the codec's own insufficient_roof_holds.
  • manifest_has_27_files_and_4_lfs_pointers, ratio_is_integer_truncated.
  • tests/cli.rs: the binary on a two-row manifest (one file row and one LFS row, the same 2,200-byte GGUF; file row measured; LFS row NOT_MEASURED without --lfs-dir and measured with it), a SHA-256 that differs from the manifest (exit 1), a missing file (NOT_READ, exit 1), a manifest with no GGUF| row and one with only an LFS row and no --lfs-dir (SUMMARY ends in status=NOT_MEASURED, exit 0) and an unknown argument (exit 2).