diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 870064b3..899c3000 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -1,4 +1,460 @@ +# Changelog +All notable changes. Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow SemVer; +commits follow Conventional Commits (release notes are generated from them by `Titano.Tools changelog`). + +## [Unreleased] + +### Added + +#### Foundation +- Solution and build rules: warnings as errors, nullable, .NET 10 SDK pin, zero-package guard (build target and + `Titano.Tools package-guard`). +- `Titano.Testing`: in-house test framework and runner (theories, categories, timeouts, environment and Windows + gates, serial classes, parallel runs, JUnit XML, GitHub annotations). +- Localization runtime (`Loc`, CLDR plural rules with few/many forms, runtime culture switch, RTL), `en` + `it` + catalogs, machine translations with per-language glossaries, `i18n check/export/missing/import`. +- Brand mark geometry, SDF rasteriser, PNG encoder, ICO writer and `make-icon` (icons generated at build time). + +#### Engine (Titano.Core) +- Metadata: signature sniffing, TIFF/Exif/GPS/XMP/MakerNotes, JPEG segments, ISO-BMFF (HEIF, CR3), RAF, PNG, + WebP and RIFF parsers with fuzz-tested partial results; `MetadataBuilder` fallback chains; `ExifWriter`. +- Codecs: JPEG (baseline, progressive, lossless; libjpeg-exact integer IDCT), PNG, TIFF, linear DNG writer, GIF and + APNG encoders, ICO; native RAW development for DNG (opcodes, AHD demosaic, DNG colour), CR2, NEF, ARW, PEF, RAF. +- Imaging: planar linear-light buffers, decoder providers and decode tiers, separable resampler, frame window with + read-ahead, memory budget and float32 spill, `thumbs.pack`, thumbnail cache, proxy builder. +- Analysis and advisor: frame statistics, colour temperature, deflicker (global and regional), holy-grail step + redistribution, white-balance smoothing, light analysis with findings, streaming deep analysis with checkpoints; + `Advisor` recommendations with localised reasons, apply/optimise, sequence presets. +- Motion: FFT and phase correlation, pyramidal Lucas–Kanade flow, motion blur, nine-patch stabiliser, virtual + camera, frame interpolation, stacking and star trails. +- Render and export: render plan (constant, adaptive, interpolated, remapped timing), preparation pass, geometry, + pipeline, self-test suite (`Titano.Tools selftest`); preset resolution, encoder selection with hardware preference + and fallbacks, output naming. +- Video: streaming MP4 muxer (H.264/HEVC/AV1) with inspector, AVI-MJPEG with OpenDML indexes, NV12/P010 + conversion, level tables, managed encoder provider (MJPEG-AVI, image sequences, GIF, APNG). +- Archive format: layout and naming templates, sidecars, leases, index snapshot, scanner, verify, adopt, orphans, + rename plans; card import planning, sessions, hash-verified copy and verified erase; TPK1 installer payload. +- Diagnostics: `SecretScrubber` and `DiagnosticsArchive` for diagnostics bundles that never carry passwords, + tokens, keys or photos. + +#### Data (Titano.Data) +- SQLite binding (winsqlite3 / libsqlite3) and in-house PostgreSQL wire protocol v3 client (pool, prepared + statements, COPY, LISTEN, cancellation). +- Migrations, repositories and the `TitanoDatabase` facade; one persistent job engine with checkpoints, + pause/resume, priorities and crash recovery for client and server. +- Archive engine: create/adopt/open, incremental and full scans, rebuild from sidecars, ingest of uploads and card + imports, verify, thumbnails and proxies, maintenance, mass rename, job handlers. +- Analysis and render engine: light/deep analysis and render job handlers, render node client. + +#### Programs +- Titano desktop: shell with rail, job bar and toasts; Welcome, Library (virtualised grid and list, filters, sort, + hover scrubbing), Jobs, Server (trust-on-first-use sign-in, DPAPI token), Settings (general, archive, rendering + with encoder inventory and self-test, storage, server, updates, advanced) and About; `--capture` screenshots. +- Update check against the public releases repository and **Download**: the setup (the portable zip for a portable + copy) is fetched into `%TEMP%\Titano\updates`, verified against the release's `SHA256SUMS` and shown in Explorer; + an interrupted download resumes, *Cancel* stops it, and a transfer that stalls for 60 s fails. +- Diagnostics bundle (Settings › Advanced, About): environment, codec and encoder inventory, scrubbed settings, + recent failed jobs and logs. +- Titano Server: configuration from `server.json` and `TITANO_*`, TLS (auto, PEM, proxy), API v1 (auth, users, + sequences, frames, uploads, sync, jobs, render nodes, events over WebSocket, archive), admin panel (dashboard, + users, archive, jobs, settings, logs, about), audit log, LAN discovery, Windows service. +- Server diagnostics: `GET /api/v1/server/diagnostics` (ManageArchive, audited) and a *Diagnostics* button in admin › + Logs. +- Admin panel: light and dark themes following the browser with a toggle, plural-aware counts, audit filter by + several actions, password change, typed confirmations, right-to-left layout; an administrator cannot reset their + own password from Users (409). `DELETE /api/v1/sequences/{id}` moves the sequence to the archive's trash and + answers 409 or 503 with a reason when it cannot. +- Titano Uploader: tray program with resumable persisted queue, session grouping, watch folders, bandwidth limit, + verified-only source deletion. +- Titano Setup: one-screen installer, per-user or all-users, components, shortcuts, file types, upgrade in place, + silent mode, uninstaller that keeps user data unless asked. + +#### Desktop workflows +- Library: timeline with year bands (keyboard), saved views, quick actions reachable by keyboard, mass actions bar, + *Delete…* into the archive's trash (dry run, typed confirmation, progress, Undo), Rendered / Not rendered / Synced + and Origin filters, and cards for server-only sequences whose Render and Analyse run on the server. +- Archive manager: tree by capture year, health with duplicate groups and *Mark copies*, statistics charts with + values for screen readers, maintenance, *Trash…* with restore, mass rename and move behind a dry run; failures as + one-sentence toasts with Retry, dialog errors inline, Cancel as the default button. +- Import: devices and card pool, camera profiles, plan with sessions (merge, split, titles), hash-verified copy into + the archive, a folder or the server, verified delete, format behind a typed confirmation, eject, auto-import. +- Sequence editor: Frames, Exposure, Camera, Motion and Export tabs with the advisor's Auto values and reasons, + Optimise, preview tools, section charts, curve editor (keyboard included), undo/redo and saving shortly after + each change; *Set hero* updates the Library thumbnail; batch export with size and time estimates. +- Server sequences open in the editor with proxies: saved, analysed and rendered on the server, with cancel and + retry of server jobs, a read-only mode for accounts without Edit, and an explicit prompt when the same setting + changed on the server; Export *Sync* sends local renders to the server; *Save both* copies can be restored from + the Export tab. +- Client sync (Server screen): sync table with filters, conflicts settled with *Keep mine*, *Take server* or *Save + both*, uploads and downloads as resumable jobs that check the free space first, proxies kept offline, uploads paused + on metered connections; this PC as a render node while signed in. + +#### Localization and accessibility +- 38 cultures: `en`, `it` and 36 machine translations with per-language glossaries and an independent review. +- Right-to-left: windows mirror from startup and on every language switch (`TitanoWindow`), directional icons + mirror with them, photos, charts, numbers, paths and templates stay left-to-right islands, category charts lay + out from the reading side. +- Accessibility: automation peers for sliders, filmstrip, curve editor, preview, charts, split buttons and the job + bar; live regions for status lines; toasts announced (failures as errors); `Field.Error` for inputs without + validation; charts take the keyboard (arrows, Home/End, Enter) where an item can be activated; two-word names for + icon-only toggles. + +#### Distribution and CI +- Docker image (multi-arch, PUID/PGID, health check), compose file with PostgreSQL 17, Unraid template. +- CI: Windows + Linux build and tests, PostgreSQL 16/17, Docker smoke test, screenshots branch, i18n, XAML lint, + format and package guards. +- Release workflow: tests, self-contained publish, optional Authenticode signing, installers, portable and server + zips, `SHA256SUMS`, release notes from Conventional Commits, multi-arch GHCR image, and the public releases + repository (README, EULA draft, SECURITY policy, issue forms, Unraid template, compose file, screenshots, `i18n/`). +- Performance gates (`perf.yml`, weekly): 500,000-photo library and 100,000-frame rebuild from sidecars (every + column compared), each on SQLite and PostgreSQL 17. +- `Titano.Tools.Tests`: the fixtures command's warning annotations and exit codes. + +#### Verification against the brief (2026-10-12) +- Settings › Import, Analysis and Formats pages (defaults of new cards, deep-analysis width, thresholds and auto-run, + decode tier per format with Store links for missing codec extensions); Archive thumbnail size and rescan interval; + Advanced › Restore (daily backups, dry-run comparison, staged for the next start) and Reset all; Archive › + Maintenance › Restore database… opens it. +- Daily `VACUUM INTO` backups of the SQLite index (newest three kept) on the desktop and on a SQLite server; + maintenance vacuums the index when a tenth of it is free and its dry run reports the reclaimable size. +- An archive's templates, proxy size and thumbnail size live in its archive.json. Settings › Archive and PUT + /api/v1/archive/settings rewrite it atomically under a lease, and new desktop archives start from Settings › + Archive. +- CI: pixel diff of the `--capture` screenshots against `tests/visual/baselines` (`Titano.Tools screenshots diff` and + `accept`; 8/255 per channel, at most 0.05 % of a screen; a screen without a baseline fails once any is committed); + captures are reproducible (fixed sample clock, English formats, no animation). +- CI: installer test on a clean `windows-latest` runner (silent install, run, upgrade in place, Uploader-only install, + uninstall, exit codes). +- CI: the PostgreSQL 16/17 jobs run the MD5, cleartext, trust and TLS (require, verify-full) tests; a server without + TLS fails them. +- Windows tests: Media Foundation output opened by MediaPlayer (H.264, and HEVC Main10 where hardware allows) and its + first frame decoded by a source reader. +- Proxies of originals the server cannot decode (HEIF, AVIF, WebP): manifests and render-node claims carry the + archive's proxy policy and, per frame, its flags and whether the server wants its proxy; `PUT + /api/v1/frames/{id}/proxy` takes them from clients that edit and from render nodes; desktop uploads and render nodes + make and send them; renders, analyses and thumbnails of those frames use them. +- Server: the archive is scanned incrementally at start and every ten minutes, so photos already in an adopted folder + and sequences added by another writer are indexed without a manual rescan. +- Shell: the taskbar button mirrors the job bar and turns red while a failure waits on the Jobs screen. Toasts also + appear as Windows notifications while the window is minimised or in the background; a click brings the window back + and opens what the notification names. Ctrl+1…6 and Ctrl+, open the sections the rail tooltips list, and the + editor's 1:1 view moves to Ctrl+Shift+1. +- Jobs: a toast when a long operation ends or fails, whichever screen started it, and one toast for a whole batch ("12 + jobs finished"). Rail badges count running jobs and unseen failures, sync conflicts, Library sequences with + warnings, and Archive health lines that need attention. +- Settings › General: *Start with Windows* (minimised, for the copy that set it; the uninstaller removes it) and + *Windows notifications*. +- Server events: `cardEvent` (BRIEF §14.3) tells every connected client about a card import another client streams + into the server (started, progress, finished). Clients report it through `POST /api/v1/uploads/cards`. +- Decode tiers (BRIEF §8.2): frames that decode only through an embedded preview are marked preview-only, with a + Library chip showing the count, an Info finding and the output capped at the preview size. Frames nothing decodes + are flagged undecodable, listed as a sequence warning and left out of renders. A frame that stops decoding during a + render is shown as its neighbour instead of failing the job. +- MakerNotes: exposure mode (Canon, Olympus, Fujifilm, Panasonic, Sony), RAW size (Canon sRAW/mRAW, Nikon RAW M/S) and + the Panasonic time-lapse hint. Sequences shot by the camera's own intervalometer get adaptive timing across their + pauses. +- The SQLite compile options appear in the log and in the diagnostics bundle. +- `.titano` project files. *Save project file* on the Export tab writes the sequence's reference and settings. Opening + one (a double-click, or `Titano.exe `) opens the sequence with those settings as one undoable step, with + one-sentence toasts when the file cannot be read or its sequence is not in the library. One Titano runs per data + folder, and a later launch hands its file to the running one or, while that one is closing, waits for it and starts + with the file. +- Server: `PATCH /api/v1/sequences/{id}` takes `expectedFramesVersion` and answers 409 `frames_conflict` when the + sequence's frames changed since the settings' frame positions were written. `GET /api/v1/sequences/{id}/manifest` + returns frames, frames version and settings of one frames version. + +### Fixed +- Server: downloading the current log while it was being written aborted the response (Content-Length mismatch); it + now serves the bytes listed at request time. +- Mass rename and move: a dry run asked for right after typing was replaced by the pending debounced one, so *Apply* + stayed disabled; the explicit dry run now cancels it. +- Radio groups leaked between windows not shown yet (the Setup's capture overflowed the stack); screenshots of + right-to-left windows were mirrored twice. +- Switching the language left texts kept by view models in the old language until their next change: the job bar, + the Jobs rows, the editor's chart legends and summaries, Auto chips and info line, the Archive figures and the + Import session table now follow at once. +- Right-to-left: in meta lines a number after a Latin field ("Canon EOS R5 · 2 h") joined the Latin run and split + its own field; fields are now separated with right-to-left marks (left-to-right ones in the preview's frame data). + Charts no longer switch to Arabic-Indic digits after Arabic words. Desktop file sizes use the language's units; + table cells holding a size, speed or time left read in the language's direction and fit their column. +- CI: a full artifact storage failed jobs whose checks had passed; uploads no longer fail a job, artifacts expire in + days, and screenshots reach their branch through the cache. +- Release workflow: signing and the public-repository publish never ran (step conditions cannot read the step's own + secrets); the publish job lacked the .NET SDK for `make-icon`; re-publishing an existing tag failed; the portable + zip lacked `portable.txt`. +- CI fixtures step reported missing RAW samples as a silent pass; it now emits a warning per missing sample. +- Release workflow: the server image and its `:latest` tag were pushed before the Windows tests passed, and + publishing an older tag again moved `:latest` back; the image now follows the tests and `:latest` the newest + stable release. Stable release notes started at the last release candidate instead of the previous stable tag. +- Settings › Rendering quality, parallelism and background priority had no effect on jobs. Parallelism Auto is now the + engine's half of the logical cores, and concurrent jobs share the memory budget. +- A restore staged in Settings › Advanced now runs before the index opens, so it recovers an index that no longer + opens. A copy failing quick_check is set aside before any backup is made, and a restored copy is never applied + twice. +- Settings › Archive could not save archives with an empty name (made at a drive root), showed sizes outside the + presets as 1920 or 320, and kept editing the previous archive after the archive folder changed. Reset all and Import + settings rewrote the shared archive.json. +- Server archive settings were lost on restart and ignored by proxy jobs. A damaged archive.json returned 500, and a + busy one reported a busy sequence. +- The naming preview's sample title follows the interface language. +- Server (Windows): the data folder, the temporary admin password and the TLS key were readable by every local user, + and any user could plant `server.json`. The data folder is now private to SYSTEM, Administrators and the server's + account. The server refuses to start when anything in it belongs to another account or is a link, reads + `server.json` only after checking its owner, and creates secrets anew with a private ACL. +- Server (Windows): a new archive folder under `C:` let every local user change it, including the folders where the + service stages uploads. It now lets only administrators and the server change it (other users may read it), and the + log reports an existing archive that others can change. +- Server (Windows): `--install-service` registered a LocalSystem service from any folder. It now refuses outside a + Program Files folder that only administrators can change. +- Server: in TLS mode proxy, any client could set `X-Forwarded-For` to escape the sign-in rate limit and forge its + audit address. Now only the proxies in `TITANO_TRUSTED_PROXIES` (default: loopback) may. The admin panel shows *Not + via proxy*, and a refused sign-in names the setting. +- Docker: a fresh, root-owned archive folder made the container crash-loop. An empty or root-owned archive root is now + given to PUID:PGID. Any other archive, or `.titano` folder, that this user cannot write stops the container with a + one-line error. `TITANO_DATA_PATH` is honoured, and Kestrel no longer warns about overridden addresses at every + start. +- Docker and Unraid: remapped host ports broke the admin panel's HTTPS redirect; `TITANO_PUBLIC_HTTPS_PORT` and + `TITANO_PUBLIC_HTTP_PORT` fix it, and the LAN beacon uses them too. The Unraid template's default database host + could not resolve on the bridge network. `--help` now lists every variable, the TZ description is accurate, and the + README explains host networking for LAN discovery (with PostgreSQL on loopback). +- Tests: four tests switched the UI language outside a serial class and could break English assertions running beside + them; such a switch now fails the test that made it, after English is restored. The frame window's + unobserved-exception check runs alone and counts only its own exceptions. +- Test runner: a skip or failed assertion in a test class's constructor was reported as "Exception has been thrown by + the target of an invocation"; it now keeps its own outcome and message. +- CI: a crashed screenshot capture passed once it had written one picture; the MediaPlayer playback check could end + the whole Windows test program on an exception. +- Render nodes: frames missing, corrupt or excluded on the server, and originals it had not hashed yet, failed the + whole job; they are now skipped or fetched with a size check, and damaged frames the server's own render skips are + skipped too. +- Sync: a download whose partial file already held the whole original failed on every retry; an edit saved on this PC + while an automatic comparison ran could be replaced by the server's version unseen. +- Sync: proxies the server asked for were neither counted nor sent for adopted (unverified) folders, and the count did + not follow proxies sent from elsewhere. +- Mass rename and move: sequences inside a moved folder kept their old paths in the index; they now move with it + (listed in the dry run, locked while it moves), and a target inside a sequence folder is refused. +- Archive maintenance: compacting a thumbnail pack could drop thumbnails a thumbnail pass was writing. +- Server: proxies of HEIF frames made from embedded previews by earlier versions are asked for again on the next proxy + pass; a proxy sent for a frame the server decodes itself, or a preview-sized one, is refused. +- Exiting while signed in to a server no longer waits for the UI thread that the exit blocks. Closing the window stops + the editor's player and runners before the index and the engine close. Cancelling or closing the sign-in dialog no + longer leaves a half-signed-in session or crashes on a late answer. +- The usage counts consent, which promised a daily count that nothing sends, is offered only in builds with + `TitanoAdsEnabled=true` (BRIEF §21). +- Error toasts say why an action failed in the app's language instead of showing .NET or OS text: a job posted to the + server from the Library (including a server whose certificate changed since sign-in, which used to fail silently), + the card check and delete after an import, and a failed editor save. The editor's own reasons (frames changed on the + server, settings changed elsewhere at the same time, sequence gone, project unreadable or from a newer Titano, + account without edit rights) are no longer reported as 'The server does not answer'. +- Texts that count now agree with the number: advisor findings and reasons, the rendering cores and the upload-all + tooltip have singular and plural forms ('1 frame is black'), a single exposure change has its own finding, and + tallies and job log lines read as labels ('Copied: 40 · failed: 1', 'Missing: 2 · damaged: 1'). `i18n check` fails + on a text that puts a count before a counted noun without plural forms, or that tallies counts with participles. +- Archive: picking another archive while the screen was reading no longer leaves the previous archive's tree, figures + or search results actionable. Until the picked archive is read, Scan, Verify, Rebuild and the set actions wait and + say so, and the rebuild dialog shows the picked archive's own state and count. +- Import: a job that ended before the screen recorded it (a destination gone offline) no longer leaves the screen + copying forever, and a replaced import result is released. +- Library: the timeline's month readouts follow a language switch. +- Server: a sequence created with `POST /api/v1/sequences` (the Uploader's "New sequence") could not take uploads. It + now gets its folder with its first photo, named by the folder template like an upload-created sequence. +- Server: "already on the server" was also answered for copies flagged missing or corrupt or whose file was gone, and + the Uploader then deleted its source. Only an intact copy answers now. An upload of the same content repairs the + damaged frame in place, and the damaged file is kept beside it as `.damaged-