Port the quak CLI to the new library API #52
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: sneak/quak#52
Reference in New Issue
Block a user
Cache/API implementation (#36), phase 5.
Depends on the backup-rewrite unit (and the read surface).
Goal
Port the
quakCLI (bin/quak.ts) to the new library API. Commands, flags,output, and exit codes stay as they are, plus the new directory options.
Scope
collections→lib.albums.list().files --collection→lib.albums.byID()then
album.photos.list().get/get-thumb→lib.photos.byID()thenphoto.original()/photo.thumbnail(), copied to--out(default as today). Removes today'sscan of every album per call;
--collectionaccepted and ignored.backup <dir>→Library.open({ client, downloadDirectory: dir }),lib.backup({ onProgress }); typed events formatted into today's log lines;--jsonand exit 1 on failures unchanged.backup-metadata <dir>and the*-missing-thumbnailshelpers → enumerate vialib.albums/album.photos; the ML fetch, EXIF extraction, and thumbnailupload stay where they are;
--exifreadsphoto.original(). Address#17 (helper assumes JPEG) while here.
login,whoami,logoutunchanged.--cache-dir(and honourcacheDirectory/downloadDirectorydefaults from the design).
Definition of done
codes;
--cache-dirworks; CLI tests updated/added.make checkgreen. Overlaps #17.Grounding
bin/quak.ts, CLI tests undertest/cli/.Dispatch notes: TDD; no scripted edits; no interactive questions; plain language.
Squash subject ends
(closes #<this issue>). End every message withModel: opus-4-8.Model: opus-4-8
Opened #74 (branch
issue-52-cli-port-redo, basenext).Every command now runs through
Library.open:collections/filesreadlib.albums,get/get-thumbresolvelib.photos.byID()and copy the cached original/thumbnail to--out(so--collectionis accepted but ignored).backup-metadataand the thumbnail helpers enumerate through the library and read originals viaphoto.original(); ML fetch, EXIF, and thumbnail upload are unchanged. Added the global--cache-dir; point commands open with the background precache off so a one-shot command never starts downloading the whole account.Also addresses #17:
fix-missing-thumbnailsnow reports a non-JPEG image or a video as skipped (unsupported), distinct from failed, and only a genuine failure exits non-zero.Two judgement calls for the reviewer: reads are cache-first (design #36), so a just-added file can lag one refresh; and the
files/collectionsJSON keeps its old keys while sourcing from the projected records, socreationTimeis now milliseconds andcollectionIDis the requested album id.make checkandmake buildare green.Model: opus-4-8