Skip to content

Promote to production: Optical File Transfer tool - #93

Merged
slaveofcode merged 3 commits into
mainfrom
develop
Aug 1, 2026
Merged

Promote to production: Optical File Transfer tool#93
slaveofcode merged 3 commits into
mainfrom
develop

Conversation

@slaveofcode

Copy link
Copy Markdown
Owner

Ships the QR-beam optical file transfer (no-network, fountain-coded).

🤖 Generated with Claude Code

Kresna and others added 3 commits August 1, 2026 19:58
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
New Network tool (/tools/optical-transfer), inspired by Decimen Optical Transfer
(MIT). Transfer a file between two devices using only a screen + camera — no
network, no server, fully client-side.

- LT fountain codec (fountain.lib): each QR frame is the XOR of a pseudo-random
  subset of file blocks, subset derived deterministically from the frame seq
  (shared mulberry32 PRNG + robust-soliton degree distribution). The receiver
  peels frames in any order until all blocks solve — tolerant of dropped/blurred
  frames, no ACKs or retransmission. Fully unit-tested (round-trips across sizes,
  out-of-order, lossy, duplicate frames).
- Self-describing frame wire format (frame.lib): magic/version/session/k/size/
  hash/seq + payload; packFile/unpackFile carry the filename through the codec;
  fnv1a integrity. Tested.
- qr.lib: fast synchronous QR render (qrcode byte-mode matrix) + jsqr decode.
- Island: role picker; Sender loops an animated QR at ~8fps; Receiver uses the
  camera, decodes frames, shows progress, verifies the checksum, downloads.
- Registered optical-transfer (Network, ScanLine, beta).

Spec: docs/superpowers/specs/2026-08-01-optical-transfer-design.md
564 tests · lint clean · build green. Codec fully tested; QR/camera pipeline is
build + manual two-device smoke.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
feat(optical-transfer): beam files device-to-device via QR (no network)
@slaveofcode
slaveofcode merged commit 77ffeb8 into main Aug 1, 2026
2 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant