BRIEF §8.2 tiers 2 and 3 had no writer: PreviewOnly and Undecodable were never set,
so the advisor could not cap the output at the preview size and one unreadable frame
failed a whole render.
- ImageDecoder.Probe names a file's tier without decoding it (JPEG, PNG and TIFF
without opening the file); the light analysis probes frames whose tier is unknown,
and the deep analysis, renders from originals and thumbnail/proxy passes record
what decoding actually found (FrameTiers). Sidecar frames gain "tier", "previewW"
and "previewH"; the index gains frames.preview_width/height and
sequences.preview_only_count (migration 0005, SQLite and PostgreSQL).
- SequenceContext takes the preview size from preview-only frames, so the advisor's
output cap applies; the light analysis reports format tiers (preview-only frames as
information, undecodable ones as a warning under the deep analysis' key, listed
once); a sequence that gains undecodable frames warns at once.
- Only a file in a format the host decodes natively is flagged undecodable; files
beyond the host's decoders keep their tier without the flag, so render nodes and
proxies can still supply them.
- A frame that stops decoding during a render is replaced by its nearest planned
neighbour and logged instead of failing the job; the render fails only when no
planned frame decodes.
- The Library card shows a preview-only chip with the count (local and server
sequences: SequenceDto.PreviewOnlyCount, FrameDto preview size).
- GoPro GPR decodes through the JPEG the camera writes beside it when that is larger
than the embedded preview (BRIEF §8.1).
- Thumbnails use a stored embedded preview only when it reaches 320 px; a smaller one
sends the frame through the host's decoders instead (BRIEF §8.5).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
The decode workstream added a second pack writer and proxy builder that
wrote TTPK files with a different layout to the same path as the
archive's ThumbPack. The archive implementation is the one wired into
ingest, maintenance and the thumbnail jobs; the unused duplicates are
removed. The LRU ThumbnailCache stays for the UI.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
diagnose prints per file the format, managed decode tier (and why it is
not native), delivered size, camera and capture time with its source,
then a per-format summary; --formats prints the tier table. fixtures
downloads tests/fixtures/manifest.json into tests/fixtures/external with
HTTP range resume and SHA-256 verification, skipping verified files and
recording the hash of first downloads whose manifest hash is null.
External fixture tests (skipped when absent) check native decoding,
size and agreement with the embedded preview.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
FrameWindow keeps frames from position-Behind to position+Ahead,
decodes ahead on background tasks within the memory budget, drops
frames that leave the window and spills in-window frames farthest from
the position to a delete-on-close temp file of float32 planes (renders
stay bit-identical under memory pressure). The budget check and load
start share one lock; leases pin frames; disposal waits for decodes,
releases every buffer and deletes the spill file even after
cancellation. Tests assert a hard three-frame bound for 40 and 400
frames and an identical spill-file size.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
ThumbnailPack appends self-describing CRC-checked JPEG entries (320 px,
q80) and index records; a two-slot header flips to each new index, so
crashes and truncation lose only the damaged tail, and compaction
rewrites live entries through AtomicFile. Reads are positional and run
concurrently with the writer. ThumbnailCache is a byte-budget LRU that
coalesces concurrent loads. ProxyBuilder decodes at the policy long
edge with orientation applied and writes JPEG q92 with the source Exif
(capture time kept, orientation reset).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
ManagedDecoderProvider decodes JPEG/PNG/TIFF natively, DNG and the
supported RAWs through RawDecoder, and falls back to the largest
suitable embedded JPEG (oriented like the main image) for other RAWs,
CR3, HEIF and unsupported bodies. Requests use JPEG DCT scaling, CFA
binning when MaxLongEdge allows, bilinear demosaic for thumbnails and
analysis, and ForcePreview. DecoderFactory builds the client (WIC then
managed) and server chains and the per-format tier table; Probe gives
the per-file tier without decoding.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC