Commit Graph
2 Commits
Author SHA1 Message Date
wesandClaude Opus 5 fc93fc3a45 Document snapshot mode and the Kobo portability constraints
The README still described the binary as a highlights extractor, which has not
been the primary mode since snapshot was added.

Records the two constraints that only real hardware surfaced, because both cost
real time and neither is discoverable from a host build: the Elipsa's 4.9 kernel
predates statx, so Zig's File.stat and getEndPos fail as a bare
error.Unexpected after the snapshot is already written; and usize is 32-bit on
armv7, so a u64 stat size will not coerce. Also pins Zig to 0.15.2 rather than
"or later", since the 0.16 in pacman breaks the build, and notes that the host
build fails on CachyOS for reasons unrelated to this code.

Points at c0smere_devops/kobo-sync for deployment and operations rather than
duplicating them here — this repo is just the binary; the ingest service,
schema, trigger, monitoring and recovery runbook live with the rest of the
infrastructure.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-01 20:39:54 -04:00
wes 39bbae4e73 intial commit 2025-12-01 12:36:35 -05:00