A desktop scan queues a background deep analysis of the sequences whose
frames it changed when Settings > Analysis > After a scan is on; photos the
Archive screen's orphans fix indexed got only the light analysis, which then
dropped the deep status. ArchiveService.ReconcileAsync takes that setting
and queues the deep analysis too, at background priority. A follow-up is
left out when a queued job of its kind already covers the sequence, whatever
else that job targets, as the scan's follow-ups check.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
The Archive screen's orphans fix indexed photos copied in by hand but left
AnalyzedLight, ThumbsBuilt and ProxiesBuilt set and recorded the folder's
stamps, so no scan came back to it and the light analysis was never redone:
Auto values, warnings and preview-only tiers stayed those of the old frames.
It now clears the three flags in the sidecar and the row as a scan's
reconcile does, and queues the light analysis on the host's engine (on a
server, the thumbnails and proxies too).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
Writers that change part of a sequence (decode tiers, image-pass flags,
analyses, verify flushes and stamps, duplicate flags, title/tags/rating/
notes edits, mass rename) now ask ArchiveIndexer.InStepAsync before their
own sidecar write and record the folder's scan stamps afterwards only when
the index held the folder as it was: the stored stamps are still the
folder's and the row holds the sidecar's frames. What another process
changed in the sidecar alone (frames, a new title) stays visible to the
next incremental scan, which writes the whole row from the sidecar.
EditSequenceInfoAsync reads sidecar and row under the lease and writes the
row through SequenceRepository.EditAsync at the settings version it read,
applying the edit again on a conflict, then the sidecar from the stored
row; settings and frames committed meanwhile stay. MassRenamer writes only
folder and title (RelocateAsync, whose null title now keeps the current
one). Verify flushes and duplicate flags run under one lease.
A scan that finds frames another writer listed in the sidecar itself
clears AnalyzedLight, ThumbsBuilt and ProxiesBuilt only in its own row and
only on a server (ImagesAfterScan); the shared sidecar keeps the writer's
flags, so a desktop's poll no longer makes the server redo its passes.
An image pass overtaken by an upload keeps its flag while a pass of the
same kind is queued for the sequence. ThumbPack.IsFrom accepts a thumbnail
drawn before a verify hashed its photo, in the pass, in SameFrames and in
the server's thumbnail lookup, which answered 404 for every such frame.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
GET /api/v1/archive/settings refreshes the served archive from
archive.json first, so the admin form (which saves every field) starts
from a desktop's change made since the last poll instead of writing the
old templates back. ServerArchive.RefreshAsync replaces the served
archive only when the refresh registered a change, and only through a
compare-and-swap against the archive it read, so a poll racing an
admin's PUT no longer puts the pre-edit row back for ten minutes.
RefreshSettingsAsync now ignores an archive.json a newer Titano wrote,
as documented, instead of registering what this version reads of it.
AppServicesTests now points the folder at an archive the index does not
list first, and checks that the archive no longer chosen gets no scan.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
- The desktop's rescans run for the whole session and each one targets the archive at Settings › Archive's folder
(as the Import and Archive screens do), so an archive created on the first run, chosen in Settings, relinked or
imported with settings is rescanned from the next tick on, and Rescan every always reaches a live timer. The
folder of the start is reopened (relink, interrupted renames) as soon as its archive.json is there, so an
unplugged drive or a folder without an archive no longer stops polling for the session.
- ArchiveService.RefreshSettingsAsync reads archive.json and registers the archive again when its name, templates
or proxy size changed elsewhere (a server's admin panel, another PC); null when the file cannot be read, is newer
or belongs to another archive. Desktop rescans and the server's polling call it first, so imports, uploads and
the admin panel follow the shared settings without a restart.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
A sequence created through POST /api/v1/sequences keeps an empty folder until its
first frame. Scans no longer adopt loose photos at the archive root under its id,
and a rebuild, the orphans report and fix, verify and the scan follow-ups no longer
treat it as the root sequence, as missing or as a sequence to analyse. All of them
use ArchiveIngest.AwaitsFolder.
On the server (ArchiveServiceOptions.ImagesAfterScan), a scan that indexes sequences
without thumbnails or proxies queues background Thumbs and Proxies passes for them,
as an upload does. A scan that finds photos added or removed clears ThumbsBuilt and
ProxiesBuilt together with AnalyzedLight.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
- The archive's index row is written under the same lease as archive.json, so two edits cannot leave them in
opposite orders.
- A scanner holding the restore check's scratch copy no longer turns a passed check into a failure.
- Night frames and Star fields say "Enter a number" instead of "Enter a whole number".
- Folder and server sources start with Keep and no eject whatever Settings › Import says for cards.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
Index restore (ENG-06, UI-09):
- A staged restore now runs on the files before the index is opened, so it also
recovers an index that no longer opens; Settings > Advanced > Restore works
without an open index (the current one is shown as unreadable).
- The staged copy passes PRAGMA quick_check (before migration, in a scratch copy)
ahead of any backup: a damaged copy is set aside as .failed and never renews the
daily copies. The index it replaces is kept as a VACUUM INTO copy, or, when it
cannot be read, copied whole with its WAL as titano-replaced-<stamp>.db outside the
rotation. The staged file is renamed over the index, so it is never applied twice.
- Archive > Maintenance gains Restore database..., which opens Settings > Advanced.
Archive settings (UI-03, ENG-03):
- An archive.json with an empty or overlong name (drive roots) can be edited again:
the name read is made usable as at creation.
- Proxy and thumbnail sizes outside the presets (an admin's 3840) are listed and
shown with their number.
- Changing the archive folder retargets the rows: an archive there is registered
and rescanned; with none, the rows edit only the defaults of new archives. The
rows never fall back to another archive of the index.
- Reset all and Import settings no longer rewrite the shared archive.json; Archive >
Reset section asks first, naming the archive.
- PUT /api/v1/archive/settings: 409 archive_busy on a lease conflict, 409
archive_manifest for a damaged, newer or foreign archive.json (was 500).
Parallelism (UI-02):
- Auto is the job engine's default, half the logical cores (BRIEF 14.6), with each
job's own decode and analysis threads; a value the user sets is the number of
workers and caps those threads. The memory budget is shared: each job's frame
window gets budget / workers.
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
Once a folder has moved into the trash (or back), its index step runs to the
end with no cancellation and a failed step moves the folder back, so trash and
index never disagree. Running or paused archive-wide jobs (scan, rebuild,
import, maintenance, a verify of everything) block a delete of every sequence
of their archive; a verify of named sequences blocks those. A row whose folder
is gone is refused (FolderMissing) instead of losing its settings. Delete
revalidates the plan cheaply (index row, jobs, sidecar id from its head)
instead of measuring every folder again; the dry run reports progress. A
restored folder without a sidecar gets the record's title, tags, rating and
notes and drops a hero frame it no longer has. EditSequenceInfoAsync changes
one field from the current sidecar values.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
Restore left a folder without a sidecar out of the index until the next scan,
so Undo and the trash's Restore seemed to do nothing; such a folder is now
adopted under the sequence's own id, as a scan would adopt it, and comes back
at once with its settings and renders.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
SequenceTrash plans (files, bytes, trash folder, blocked reasons) and moves
each sequence folder whole into .titano/trash/<id> under its leases, next to a
record of its index row and renders, then drops the index rows; restore moves
it back (to a free folder when the old one is taken) and indexes it again from
its sidecar with the same ids. The server's DELETE /sequences/{id} now uses it
and refuses a sequence a job is working on (409 sequence_busy).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
ArchiveModule registers the archive engine as the server's ingest, its
proxy/thumbnail locator and its job handlers (through the new
IJobHandlerProvider); Program.cs passes it to ServerHost.Build. The
server opens its archive through ArchiveService so archive.json always
exists. The server's path-safety helper is renamed ArchivePathGuard to
stop clashing with the archive layout's ArchivePaths, and the server
migration is renumbered 0003. An end-to-end test uploads a photo, finds
it in the layout and fetches the thumbnail built by the queued job.
CI's PostgreSQL jobs now run the server tests too.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
ArchiveService facade over indexer (scan, adopt, rebuild), ArchiveIngest
(IArchiveIngest with per-sequence group commit, leases and a write-ahead
journal), verifier, maintenance (duplicates, orphans, cleanup), mass rename
with resumable journal, thumbnails/proxies and card import; job handlers for
scan, rebuild, verify, import, thumbs, proxies and maintenance with checkpoints.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC