- ArchiveImages.IsProxyOf compares capture times to the microsecond the index
keeps (sidecars and Exif keep 100 ns ticks), and for frames read through
proxies also applies the policy's size rule, so the proxy pass, uploads,
thumbnails, renders, analyses, tiers, manifests and downloads agree.
- Proxy headers are cached per file while length and write time are unchanged
(and the file has settled), so manifests cost a stat per proxy.
- FrameTiers.RecordAsync checks proxy presence when it writes the sidecar and
returns the sequence's frames as they are, so a deep analysis or render that
ran while proxies arrived no longer flags the frames preview-only again, and
the analysis advises from the current flags.
- Server manifests ignore ProxiesBuilt for frames the server cannot decode, so
frames added since the last proxy pass are asked for their proxies.
- GET /sequences/{id}/analysis/report answers 404 for a report that found
frames unreadable before their proxies arrived (DeepReports.ReadCurrentAsync).
- The deep checkpoint key marks only frames read from proxies, so checkpoints
written by earlier versions still resume.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
- Renders, analyses, the server's manifests and proxy downloads take a proxy only
when its Exif capture time is the frame's (ArchiveImages.IsProxyOf); one left at
the index by a frame renumbered since counts as missing and is asked for again
(V-24).
- A frame whose original the host reads through its proxy (HEIF on the server) is
preview-only only while it has none: the light analysis and the proxy pass keep
the flag, the preview-only count, the light finding and the advisor's output cap
in step with the proxies, and an arriving proxy queues a light analysis on the
server (V-1, V-25).
- The deep checkpoint's content key includes whether each frame is read from its
original or its proxy, and analysis.json lists the frames measured from proxies;
an unreadable verdict on a frame now read from its proxy makes the report stale
(V-26).
- Thumbnails drawn from proxies are compared with the archive's thumbnail size
instead of 320 px (V-27).
- A resumed thumbnail or proxy pass sets ThumbsBuilt/ProxiesBuilt only when the
frames an earlier run did still have theirs, and the proxy pass logs frames
waiting for a client's proxy apart from unreadable ones (V-28).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
- The server's diagnostics bundle lists the SQLite compile options next to the database line when the index is
SQLite (BRIEF §6.2), as the desktop bundle does; before, they reached only one early log line.
- A deep analysis resumed after an interrupted run decodes the frames that run found unreadable again to confirm
them; a frame read from its proxy is now skipped, so the proxy's tier is never recorded as the original's.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
- Preview sizes come from probes and unscaled decodes: a size-limited decode
picks the smallest preview that reaches its edge (CR3 PRVW 1620x1080), so
renders and deep passes record its tier without a size and the output cap
keeps the largest preview's.
- A read error is not an undecodable file: ImageDecoder.Decode throws the
IOException when a provider could not read the file and none produced
pixels. Deep passes never flag frames they could not read or that
vanished, and frames only an interrupted earlier run found undecodable
are decoded again before they are flagged.
- Renders resolve stand-ins only for frames the pipeline asks for; frames
the read-ahead meets on the way (skipped by speed-ups) are left alone.
- A GoPro GPR finds its JPEG in the index when an import or upload kept it
in a sequence of its own (same original stem and capture time), for
probes, deep analysis, renders, thumbnails, proxies and the editor;
GPRs whose JPEG is indexed later are probed again.
- Thumbnails judge an embedded preview by its own JPEG header.
- PostgreSQL writes tier fields 1000 frames per statement.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
Settings (UI-01, UI-02, UI-03, UI-09, RF-4):
- New Import, Analysis and Formats pages, in the order of Settings.html. Import holds
the defaults of new cards (session rules, subfolders, verification, duplicates,
after-import actions); Analysis the deep-analysis width cap, night and star-field
thresholds and deep analysis after import or scan; Formats the decode tier of every
format on this PC with a notice and Store install link per missing codec extension.
- Archive gains thumbnail size and rescan interval; its templates, proxy size and
thumbnail size are the open archive's own (archive.json) and new archives' defaults.
- Rendering quality, parallelism and background priority now drive the jobs: quality
maps to preparation size, read-ahead and default flow quality; parallelism sets the
engine's workers live and caps per-job threads; background priority raises the UI
thread while Titano is in front.
- Advanced gains Restore (daily backups, dry-run summary, destructive confirmation,
staged for the next start) and Reset all.
- The naming preview's sample title is a catalog string.
Engine (ENG-03, ENG-04, ENG-06):
- ArchiveService.GetSettingsAsync/UpdateSettingsAsync rewrite archive.json atomically
under a lease, then the index row; the server endpoint and the desktop use them, and
the desktop creates archives with Settings › Archive. ThumbnailPolicy in archive.json
sizes the thumbnails.
- DatabaseBackups: daily VACUUM INTO copies kept x3 on the desktop and on a server on
SQLite (DatabaseBackupService), staged restore checked and preceded by a fresh copy.
- Maintenance vacuums the SQLite index when 10 % or more is free (dry run reports it).
- JobEngine.SetWorkers; ProcessingOptions.Tune applies host tuning per job.
Archive setup toasts say why in a localized sentence (RF-1).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
The server decodes with managed decoders only, so HEIF originals had no
proxies, thumbnails from their small previews and no pixels for analysis or
managed renders, and nothing could send it proxies (ENG-05). Manifests now
carry the archive's proxy spec and, per frame, its flags and whether the
server wants its proxy. PUT /api/v1/frames/{id}/proxy (Edit or RenderNode)
stores a JPEG of at most 64 MiB that decodes and whose Exif capture time is
the frame's, then queues thumbnails and the proxy pass. An upload from the
desktop makes and sends the wanted proxies after the originals and counts
them as local changes; a render node sends those it can make from the
originals it fetched once the job is done. The server never makes such a
proxy from a preview, drops one left by a renumbered frame, takes thumbnails
from a proxy, and analyses and renders those frames from their proxies.
Render nodes fetched every frame of the manifest: frames missing, corrupt or
excluded on the server failed the download, and originals not hashed yet
failed the SHA-256 check (ENG-07). Nodes now skip those frames, fetch unhashed
originals into the job folder with a size check, judge decodability with their
own decoders, and use the proxy of a frame they cannot decode.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
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
A render reserves the output name it picks, so the same preset queued twice
no longer overwrites one output with the other; render rows take ids from
their job and entry, so a resumed job recognises only its own outputs and
never deletes another render's file. A light pass records its status under
the sequence lock and cannot clear a deep pass's. Renders and Auto value
changes made by the server engine publish sequenceChanged events.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
- JobEngine: ISelectiveJobHandler lets a host decline jobs of a kind it runs;
declined jobs stay queued for other claimers without holding up the rest.
JobContext.EnqueueFollowUpAsync queues follow-up work on the same engine.
- Server renders the jobs whose every output a managed encoder produces
(ManagedRenderJobHandler); MP4 jobs stay for render nodes. Program.cs
registers ProcessingModule next to ArchiveModule. Server renders ignore a
client's export folder.
- Light analysis is queued after imports and after scans that indexed new
sequences, so the advisor's Auto values exist without user action.
- Analysis jobs log a failing sequence and go on; the job then fails and a
retry analyses only the failed ones. The advised frame rate follows the
user's fit-to duration.
- ProcessingJobs.RenderEach splits a batch into one job per preset for
servers; render nodes say which batch presets they did not render, fetch
each content once and stop on a changed certificate.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC