docs: decisions, changelog and status of the verification against the brief

Every workstream's decisions (dated 2026-10-12) and changelog entries, the merge choices (no decode tier from a
proxy, Reset all and the sign-in entry, card-only post-actions, restore summaries as labels), the new playback and
installer checks in the phase rows, and how to try the new Settings pages, project files and notifications.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
This commit is contained in:
Claude committed 2026-10-12 11:54:08 +00:00
1 parent 180bfc623a
commit c7c05b8e84
3 files changed
+267 -2

No files matched your search

+164
View File
@@ -111,6 +111,56 @@ commits follow Conventional Commits (release notes are generated from them by `T
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 <file>`) 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.
### 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.
@@ -134,3 +184,117 @@ commits follow Conventional Commits (release notes are generated from them by `T
- 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 `<name>.damaged-<time>`. The Uploader deletes a
source only after a verified upload.
- Archive: excluded frames, the hero frame and virtual-camera keyframes stayed at their positions when earlier photos
were inserted (late uploads, sync downloads, scans of added photos), so renders dropped the wrong frames. They now
move with their frames, also when a scan finds the photos while a project is being saved.
- Server: render outputs could be uploaded by upload-only accounts. Offering and completing a render upload now needs
the Edit permission.
- Server: an upload resumed after the chunk size setting was lowered had its chunks refused (413). Chunks keep the
size their upload started with.
- Server: the `render_exists` error had no message. `i18n check` now requires a message for every server error code.
- Server: re-uploading a photo to repair its damaged copy counted against the uploader's quota again, and could be
refused for quota. Repairs are free now. A copy in another sequence no longer stands in for the damaged one of the
target sequence, neither at upload start nor after a crash.
- Server: one account's card import reports could push job and sequence events out of every client's event queue. They
are now limited to one progress report a second and 120 events a minute per account. A card import into the server
no longer waits up to 20 s for an unreachable server when it ends.
- GoPro GPR frames decode through the camera's JPEG even after an import or upload kept the JPEGs in a sequence of
their own.
- A file locked by another program or a network hiccup during analysis or a render no longer flags the frame
undecodable, and neither does a file deleted after indexing. A resumed deep analysis checks such frames again.
- A small render (720p, GIF) no longer lowers the output cap of preview-only sequences to the small preview it
decoded.
- Thumbnails of RAWs whose embedded preview is smaller than 320 px are developed from the RAW.
- Frames both analyses could not decode are listed once, with the right count, including missing and corrupt ones.
- Render logs no longer name frames a speed-up skipped as shown by a neighbour.
- A failure while probing the SQLite compile options can no longer stop the index from opening.
- The PostgreSQL server writes decode tiers in batches instead of one statement per frame. The 0003 migration headers
name the right mirror file.
- Upgrading or uninstalling while the Titano Server service ran failed, and uninstalling left the LocalSystem service
registered. Services of the installed programs are now stopped once the programs have closed, started again after
the upgrade (or when it fails) and deleted on uninstall. Only services, sign-in entries and shortcuts that start a
program setup installed are changed, so installing into a shared folder never touches other programs'.
- The Server component installs only for all users in a folder inside Program Files, where standard users cannot
replace the program its service starts.
- Uninstalling left the Uploader's and the client's sign-in entries behind. 'Remove my data' deleted the whole data
folder, also another installed Titano product's index or upload queue, and now removes only the data of programs no
other installed product uses. Uninstalling one product deleted the other's Uploader shortcuts; they now move to the
copy that stays.
- The `.titano` file type name is written in setup's language.
- Titled notes with no listed changes now say 'Maintenance release.'.
+88
View File
@@ -243,3 +243,91 @@ One line per decision: date · decision · alternative · reason.
| 2026-10-11 | `LocalizedViewModel.OnLanguageChanged` is the hook for texts kept in objects: the editor makes its tabs' charts, Auto chips, markers and info line again; Jobs refreshes rows, chips and the job bar; Archive reads again; Import rebuilds its session table and device list | Re-create every section after a language switch, or ask for a restart | BRIEF §16 switches language without restart; a running job's bar line and an open editor's legend otherwise stayed in the old language until their next change. |
| 2026-10-11 | Desktop sizes use the `Common.Size.*` formats, like the Setup and the Uploader | Hard-coded B, KB, MB, GB, TB, PB | Several languages write the units in their own script or words (КБ, bayt, كيلوبايت); every UI string is a resource. |
| 2026-10-11 | CI artifact uploads continue on error with short retention (test results 7 days, Windows programs 3); screenshots reach the screenshots job through the Actions cache | Keep failing jobs on a full artifact storage, or push the screenshots from the build job | A full storage quota failed jobs whose checks had passed; the cache has its own limit, and the build job keeps its read-only token. |
| 2026-10-12 | A restore staged in Settings › Advanced runs on the files before the index opens. The staged copy must pass `PRAGMA quick_check` (before migration), then open and migrate in a scratch copy. The index it replaces is kept as a `VACUUM INTO` copy among the daily ones, 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, which consumes it. | Swap the open index after a fresh backup; move a broken index into the rotation; delete the staged file after the swap | A restore exists for an index that no longer opens. A broken copy in the rotation would push a good daily copy out. A separate delete that fails would apply the same copy again at the next start. |
| 2026-10-12 | Settings › Rendering › Parallelism Auto is the job engine's default, half the logical cores (BRIEF §14.6), with each job's own decode and analysis thread counts. A value the user sets is the number of workers and also caps those threads. The memory budget is this PC's total: each job's frame window gets budget ÷ workers. | Auto = cores minus four (mockup tooltip) driving the workers and capping every job | Cores minus four left a 4-core laptop with one worker, so one render blocked scans, thumbnails and sync. The brief fixes the default (behaviour: brief wins). Dividing the budget keeps concurrent renders within it. |
| 2026-10-12 | Reset all and Import settings change only this PC's settings. The open archive's archive.json changes only through its own Archive rows, and Archive › Reset section first asks, naming the archive. | Push this PC's values into the open archive after a reset or an import | archive.json is shared with the server and other PCs: resetting one PC must not replace an admin's naming or proxy policy for everyone. |
| 2026-10-12 | Settings › Archive edits only the archive registered at this PC's archive folder. When the folder changes, an archive already there is registered (as at start) and gets an incremental scan. With none there, the rows edit the defaults of new archives. | Fall back to the first archive of the index | Edits otherwise landed in another archive's archive.json. |
| 2026-10-12 | Proxy and thumbnail sizes outside the Settings presets (the admin panel's 3840, any valid size in archive.json) join the list with their number. | Show the nearest preset | The row must show the archive's real policy. |
| 2026-10-12 | When an archive's settings are edited, a blank or overlong name in its archive.json becomes the folder's name (the root for a drive root) or is shortened to 100 characters, as at creation. A name the edit sets is still checked as given. | Refuse every edit until the archive is renamed | Desktop archives created at a drive root before names were checked carry an empty name, which failed every Settings › Archive edit. |
| 2026-10-12 | PUT /api/v1/archive/settings answers 409 archive_busy while another process holds the settings lease, and 409 archive_manifest for a damaged, newer-format or foreign archive.json. | 409 sequence_busy and an unmapped 500 | The admin reads what is wrong; the old message spoke of a sequence. |
| 2026-10-12 | Archive › Maintenance › Restore database… opens Settings › Advanced, where the restore lives. | A second restore flow on the Archive screen | BRIEF §12.5 lists restore under Maintenance and §6.2 under Settings › Advanced: one flow reached from both places. |
| 2026-10-12 | Background priority raises the interface thread to AboveNormal while Titano is the active app, instead of lowering the jobs. | Lower the job threads' priority | Jobs run on shared pool threads whose priority cannot be set per job. |
| 2026-10-12 | The quality profile maps to the render preparation long edge (Best 1024, Balanced 512, Fast 256), the read-ahead (8 for Best, else 4) and the optical-flow quality of projects that set none. | Change the spill policy per profile | Best 'doubles sampling' and Fast is for previews, as the tooltips say; spilling stays governed by the memory budget. |
| 2026-10-12 | Index backups: a `VACUUM INTO` copy at start when the newest is a day old, then checked hourly, the newest three kept, on the desktop and on a server using SQLite. PostgreSQL servers use PostgreSQL's own tools. | A fixed nightly time | A desktop is rarely running at night, so a fixed time would rarely fire; the brief's 'nightly ×3' is met as 'daily ×3'. |
| 2026-10-12 | Maintenance vacuums the SQLite index only when at least 10 % of it is free pages; the dry run reports the reclaimable size. | Vacuum on every run | Rewriting a large index for a few pages holds every writer for nothing. |
| 2026-10-12 | Settings › Formats Install opens the Microsoft Store page of the missing extension (ms-windows-store:), falling back to its web page. | Download or bundle codecs | No external processes except OS dialogs (BRIEF §8.6); the Store is the OS route for HEIF/HEVC/RAW extensions. |
| 2026-10-12 | Settings › Archive rows show and edit the open archive's archive.json and also seed the archives this PC creates later. The rescan interval is a PC setting. | Keep separate 'defaults for new archives' rows | One set of rows matches Settings.html; the archive is the source of truth (BRIEF §7). |
| 2026-10-12 | TLS mode proxy honours `X-Forwarded-For/Proto/Host` only from `TITANO_TRUSTED_PROXIES` (new variable, also in `server.json`: IP addresses or CIDR networks), by default loopback only. The admin panel shows a *Not via proxy* chip (Dashboard, Settings) when a page did not come through a trusted proxy over HTTPS, and a cookie sign-in refused for that reason answers `proxy_untrusted`, naming the variable. | Trust every peer (as before), or default to loopback plus the RFC 1918 and ULA networks | BRIEF §14.2 keys the 5/min sign-in limit and the audit address on the client IP. Home-network clients reach the HTTP port directly from private addresses (Docker's port publishing keeps them), so trusting private networks let exactly them choose their own address. A proxy in another container is listed by its address or subnet. |
| 2026-10-12 | `TITANO_PUBLIC_HTTP_PORT` and `TITANO_PUBLIC_HTTPS_PORT` (optional, 1–65535) name the host ports a container's ports are published on. The admin panel's HTTP→HTTPS redirect and the LAN beacon use them, otherwise the bound ports. LAN discovery from a container needs host networking (documented, with PostgreSQL then published on loopback). | Drop the redirect, or always advertise the bound ports | The Unraid template lets users remap ports (8443 is often taken), and the redirect and beacon otherwise named the container's internal port. |
| 2026-10-12 | Windows data folder: a protected DACL (SYSTEM, Administrators, the server's account; nothing inherited), re-applied at start. The folder and everything in it must be owned by those accounts and contain no symbolic link or junction, checked before the ACL is touched; otherwise the server refuses to start and names the entry. `server.json` is read only after its owner is checked on the open handle. Secrets (`initial-admin-password.txt`, `tls/server.pfx`) are deleted and created anew with an explicit private DACL; elsewhere they get mode 0600. On Windows this replaces the 'owner-only file' wording of the 2026-10-02 sign-in row. | Reset foreign owners to Administrators, or keep %ProgramData%'s inherited ACL | A folder or file another user created keeps its owner's WRITE_DAC whatever the DACL says, and its contents (`server.json`, `titano.db`, `server.pfx`) are theirs, so resetting the owner would launder them. A link would carry the ACL rewrite and the server's writes elsewhere. |
| 2026-10-12 | `--install-service` registers the LocalSystem service only from a program folder (and, under `dotnet`, a host folder) inside `%ProgramFiles%` or `%ProgramFiles(x86)%`, where no ACL entry gives change rights to an account other than SYSTEM, Administrators, TrustedInstaller or the registering administrator. Otherwise it exits 1 with a localized reason. | Register from anywhere, or only warn | A SYSTEM service runs whatever sits at its image path. A per-user install or a zip unpacked elsewhere would hand SYSTEM to any program of that user (CWE-732). |
| 2026-10-12 | Windows archive: a folder the server creates (default `C:\TitanoArchive`) gets a protected DACL: SYSTEM, Administrators and the server's account change it, Users read it. A `.titano` folder the server creates is private. An existing archive that other accounts can change (owner or ACL) is left as it is and logged as a warning at every start. | Inherit `C:\`'s ACL (Authenticated Users: modify), or rewrite existing archives' ACLs | Whoever can write where the SYSTEM service stages and moves uploads can put a junction in place of a folder and redirect those writes (CWE-59). An existing archive's ACL is its owner's choice: adopted archives often belong to a desktop user. |
| 2026-10-12 | Container entrypoint: an archive root that PUID:PGID cannot write is given to them (that folder only, `chown` without `-R`) when it is empty or owned by root, as Docker creates a missing bind source. Any other unwritable root, and any existing `.titano` folder or subfolder they cannot write, stops the container with a one-line error and is never chowned. The data folder is `${TITANO_DATA_PATH:-/data}`. This amends the 2026-10-02 row '/archive only checked for write access'. | Recursive chown, or a warning followed by a crash loop | A fresh install never became healthy. The archive may hold terabytes, so its contents are never chowned. |
| 2026-10-12 | Screenshot diff (`Titano.Tools screenshots diff`): a pixel differs when one RGBA channel moves by more than 8 of 255; a screen fails when more than 0.05 % of its pixels differ, when its size changed, when it cannot be read, or when its baseline has no screenshot; differing pixels are drawn magenta over the faded baseline in `<screen>-diff.png` | Exact pixel equality; a perceptual metric (SSIM) | Anti-aliased edges move a few levels between runs; 0.05 % (about 650 pixels of 1440×900) absorbs the measured latency and last-sync time while a moved control, a new colour or a missing picture exceed it; a per-pixel rule is easy to explain and to check by eye in the diff image. |
| 2026-10-12 | A screenshot without a baseline fails as soon as `tests/visual/baselines` holds any PNG; before the first baselines the step passes with a warning and a bold job-summary line saying it compared nothing | Always only warn; always fail; a `--require-baselines` switch in ci.yml | Warn-only left every screen, and any screen added later, ungated for good; failing before any baseline exists would keep CI red until a Windows run produced them; a rule that arms itself needs no switch to remember. |
| 2026-10-12 | Baselines are accepted only from CI's `ci-screenshots` branch (`screenshots accept`), never from a local capture; the first set is accepted from the first green `windows-latest` run whose code captures at `SampleData.Now`, after the review-fix branches merge, so this change commits none | Commit the current `ci-screenshots` pictures now; capture locally | Fonts, scaling and time zone differ per machine and Linux cannot run the WPF capture; the current `ci-screenshots` commit (of 261ab46) predates the fixed clock, so its times and dates ("12:18 AM", sequences dated from the capture day) would fail every such screen, and parallel branches still change screens. |
| 2026-10-12 | `--capture` runs on a fixed clock (`SampleData.Now`, 2026-10-02 10:18 UTC; `AppClock.Today` frozen for screens laid out around today), English formats and `Motion` off (indeterminate bars stand still) | Mask the changing regions per screen in the diff | The same code then draws the same pixels on any day, so the diff needs no masks; only a measured latency and the last sync time remain, a few dozen pixels. |
| 2026-10-12 | Media Foundation playback (BRIEF §20.2) is checked by separate tests: MediaPlayer opens the software H.264 output (and the hardware HEVC Main10 output where an encoder and an HEVC decoder exist), skipped with the reason where Windows Media Player is missing or WPF reports it unusable; a Media Foundation source reader decodes the first frame to the encoded picture on every Windows with Media Foundation | One test that logs and passes without Windows Media Player; playback only in the manual release test | Windows Server runners may lack wmp.dll; a skip shows that the MediaPlayer layer did not run, and the source reader still proves the file decodes. |
| 2026-10-12 | CI `installer` job on a clean `windows-latest`: packs 1.0.0 and 1.0.1 installers from the published programs and checks silent install, run, the Add/Remove Programs entry, shortcuts and the .titano file type, upgrade in place (a file only in 1.0.0 must go, user data kept), the Uploader-only installer, uninstall and the documented exit codes (`.github/scripts/installer-test.ps1`) | Leave it to the manual release test | BRIEF §18 behaviour can only be proven by running the real installers; a clean runner is the closest thing to a user's PC. |
| 2026-10-12 | The CI PostgreSQL 16/17 service containers are prepared by `.github/scripts/postgres-ci-setup.sh` (MD5, cleartext and trust roles with pg_hba lines ahead of SCRAM, TLS with a self-signed certificate for localhost and 127.0.0.1); `TITANO_TEST_PG_TLS=1` turns a server refusing TLS into a failure | A custom image; leave those tests skipping | BRIEF §6.3 requires every authentication method and TLS mode against the service containers; the official image starts with SCRAM only and TLS off, and the skips looked green. |
| 2026-10-12 | Tests that change or observe process-wide state (the UI language, unobserved task exceptions) live in `[Serial]` classes; the App and Core test programs switch back to English and then fail a non-serial test that left English (`TestContext.Current`, an AsyncLocal) | Pass the culture into the code under test; only document the rule | The code under test reads `Loc` like the app does; the guard catches the next such test at the switch, without leaving the classes beside it in the other language. |
| 2026-10-12 | A host takes a frame's pixels from its proxy whenever its decoders cannot read the original (`ArchiveImages.NeedsProxy`: no decoder, or only a HEIF's embedded previews). Renders and analyses pick the proxy themselves, and thumbnails of such frames are rebuilt from it. | A "use proxies" choice left to the user | BRIEF §2.3, §8.1 and §8.5: the server keeps HEIF originals and relies on proxies made by a Windows client or render node. |
| 2026-10-12 | The server asks for proxies (`ManifestFrame.WantsProxy`, made as `SequenceManifest.Proxies` / `ClaimedJob.Proxies` say) of every format its managed decoders cannot read: HEIF, AVIF, and also WebP, which §8.1 lists as metadata only on the server. It takes them with `PUT /api/v1/frames/{id}/proxy` (Edit or RenderNode right): a JPEG of at most 64 MiB that decodes, with the frame's Exif capture time and the policy's size. A refusal of one proxy answers 422 (`invalid_proxy`, `proxy_mismatch`, `proxy_too_small`, `proxy_not_wanted`, the last one also for frames the server decodes itself or that are missing or damaged); 409 `proxies_disabled` concerns all proxies. | Proxies for HEIF only; a Proxies job a node claims; 409 for proxy_not_wanted | One rule for every host. A WebP proxy costs a client nothing and gives the server pixels it otherwise lacks. Clients stop a pass on 409 and go on after a 422. |
| 2026-10-12 | Desktop uploads make and send the wanted proxies after the originals and count them with the originals the server lacks. A render node sends the ones it can make from the originals it fetched after its job. Wanted frames are matched to this PC's originals by SHA-256, or, for an original not hashed yet, by size in the count; the upload then uses the hash it computes. | Match by file name; hash adopted folders during the comparison | The server renames uploads with its own template, and the comparison must stay cheap (adopted frames stay unhashed until Verify, 2026-10-02). |
| 2026-10-12 | Client migration 0006 adds `sync_links.diff_remote_updated_at`. While the copy may make proxies for the server (some were counted, or it holds originals the server cannot decode and this PC can), the link keeps the server's update time of the last comparison and is compared again when that time moves. | Store the ProxiesBuilt bit; a wanted-proxies counter in `SequenceDto`; in-memory only | Proxy arrivals and policy changes leave the frame counters alone, but they always change the update time through the follow-up passes. The bit misses partial arrivals and policy switches, a per-sequence counter costs the server a frame scan in every listing, and memory is lost on restart. Numbered 0006 so it does not clash with WS-C1's 0005 (renumber if another branch takes 0006). |
| 2026-10-12 | The proxy pass drops a HEIF proxy whose long edge is under 90 % of the policy's for the frame (the frame's own size when smaller, or at full size), and the server refuses one sent that small (422 `proxy_too_small`). Frames of unknown size are not judged. | Exact size; keep the proxies earlier versions made | Earlier versions made thumbnail-sized proxies here from previews. The slack spares decoders that crop a few pixels, and a small original of unknown size would otherwise be refused forever. Older archives get the check on their next proxy pass (new frames, an arriving proxy, or a Proxies job queued by an administrator). |
| 2026-10-12 | Render nodes skip frames flagged missing, corrupt or excluded, fetch originals the server has not hashed into the job folder with a two-attempt size check, and keep the server's Undecodable flag except for a format the server cannot decode and the node can. | Fail the job; queue a Verify first; trust only the node's decoders | The node renders the same frames as the server's own render (§11, §14.7). |
| 2026-10-12 | The server queues an incremental archive scan at start and every 10 minutes at background priority, except while a scan or rebuild of that archive is queued, running or paused. | Rescans only when an administrator asks | BRIEF §7: polling by mtime and size, the desktop's rhythm. |
| 2026-10-12 | Mass rename carries the sequences nested in a folder that moves (`RenameStep.Carried`, listed in the dry run). Selected inner sequences move out first, and a target inside a sequence folder or another target is refused (`NestedRenameException`). A moving step holds the sequence leases, then the thumbnail leases, of itself and of the sequences it carries, by id, until their sidecars and index rows follow; they are journaled together. | Refuse to rename folders that hold sequences; lock only the moving sequence | The index must follow the files (§7), one sequence is never nested in another, and no ingest, editor save or thumbnail pass writes in a folder while it moves. |
| 2026-10-12 | Sync applies the server's payload to a local sequence in one step under the sequence lease, and only while the local settings version is still the one compared. If an edit was saved in the meantime, nothing is written and the change is settled as a conflict, never overwritten. | Apply after the fact; last writer wins | BRIEF §14.5: neither side's edit is lost unseen. |
| 2026-10-12 | Monetization is a build switch: `TitanoAdsEnabled` (Directory.Build.props, default false) is stamped into the assembly metadata and read by `ProductFeatures.AdsEnabled`; without it the usage counts consent is not shown at first run or in Settings, and the Settings search does not find it | Remove the consent until Phase 9, or a conditional-compilation constant | BRIEF §21 ships monetization disabled until the human sets `TitanoAdsEnabled=true`; assembly metadata needs no `#if`, and the setting stays ready for when it is enabled. |
| 2026-10-12 | Job endings that raise a toast: finished renders, deep analyses, verifies, rebuilds, maintenance, uploads, moves and adoptions, and every failure except upkeep (scan, thumbnails, proxies, light analysis). Background-priority jobs, cancelled jobs, finished imports (the Import screen says them) and finished downloads (Library card, Server row) stay silent | Toast every job ending | The scan every 10 minutes and the work queued behind an import would bury the endings the user asked for (BRIEF §12.1 "toasts … for job completion"). |
| 2026-10-12 | Finished jobs of one kind wait until no non-background job of that kind is queued or running; then one toast says how many ("12 jobs finished", action Jobs). Paused jobs do not hold the batch. Failures are said at the end of the update that brought them, several in one toast | One toast per job; also wait for paused jobs | Server › Upload all queues one upload per sequence, which made 100 toasts and 100 Windows notifications; uploads paused on a metered network would hold the batch's toast indefinitely. |
| 2026-10-12 | A click on a Windows notification restores the window. It runs the toast's action only when the toast opts in (`Toast.RunsFromNotification`: card detected → Import, interrupted import → Resume, job finished → Open, navigation to Import or Jobs) and it is the only notification shown since the tray icon appeared | Run every toast's action; track which balloon was clicked | People click a notification to bring the window back, so a Cancel, Undo or Retry there would act before they read why; NIN_BALLOONUSERCLICK does not say which of several notifications was clicked. |
| 2026-10-12 | Toasts also become Windows notifications while no Titano window is active, not only while the window is minimised or hidden; Settings › General › Notifications turns them off | Only when minimised, as BRIEF §12.1 words it | A window behind another program is as unseen as a minimised one; card prompts (§12.4) and job endings would expire unseen after 8 s. |
| 2026-10-12 | Settings › General › Startup writes the HKCU Run value `Titano` = `"<exe>" --minimized`. The window starts minimised, and its first restore brings back the saved maximised state. The value counts as on only when it starts this executable; it is rewritten only when an update renamed the program in this copy's folder, and only the copy it starts removes it. Portable copies hide the row and write nothing to the registry | Scheduled task; one value per copy; rewrite the value at every start | The Run key is what Task Manager's Startup tab shows and turns off (as for the Uploader). One value cannot serve two copies, and a copy that merely starts must not take it over. Portable mode keeps everything under `.\data` (BRIEF §6.2). |
| 2026-10-12 | The uninstaller removes the client's and the Uploader's HKCU Run values when their command starts a program in the folder it removes (`StartupCommand` in Titano.Core is shared by the programs and Setup) | Leave them; remove them whatever they start | Windows would otherwise keep a sign-in entry that points at a deleted exe; another copy's entry is not this uninstaller's to remove. |
| 2026-10-12 | The editor's 1:1 view moves from Ctrl+1 to Ctrl+Shift+1 (tooltip key `Tooltips.Editor.Preview.OneToOne`). Ctrl+1…6 (number row and keypad) and Ctrl+, open the rail's sections and do nothing behind the first-run dialog | Change the rail's shortcuts instead | The rail tooltips already listed Ctrl+1…6 (BRIEF §12.1 "standard shortcuts, listed in tooltips"); section shortcuts must work everywhere, the 1:1 view only inside the editor. |
| 2026-10-12 | Rail badges: Jobs counts running or paused jobs plus failures not yet seen on the Jobs screen (which also turn the idle taskbar button red). Server counts sync conflicts. Library counts the sequences of this PC flagged with warnings (the Warnings filter), recounted after analyses. Archive counts the index health lines that need attention, set when the Archive screen reads its figures | Badge running jobs only; read the archive figures at start for the Archive badge | BRIEF §12.1 asks for "badge counts (warnings, running jobs)", and DESIGN §4 defines the badge as the count of things needing attention. The Archive figures are a heavy read that the screen already does when it opens. |
| 2026-10-12 | The taskbar button uses WPF's `Window.TaskbarItemInfo`, bound to the shell: the job bar's progress, an indeterminate bar while the total is unknown, and red while a failure waits unseen | `Titano.Core.Windows/Shell/TaskbarProgress` | WPF already wraps ITaskbarList3 for its windows, and a binding needs no window-handle plumbing. |
| 2026-10-12 | Toasts and failure lines in WS-F say why an action failed with a catalog sentence chosen by cause: `ErrorText.ForServer` for requests to the signed-in server (the server's own localized message, else untrusted certificate, else not answering, else 'Something went wrong.'), `ImportFailures.Check/Erase` for card checks and deletes, `ArchiveFailures.Cause` for local saves. `ex.Message` stays in the log only. | Show `ex.Message` as the toast's second line | BRIEF §0.2 rules 5–6: framework and OS messages are technical English under a translated title. |
| 2026-10-12 | The editor's own save and open failures are a typed `EditorException` (an `IOException`; `ProxiesOutdatedException` derives from it) whose message is already the catalog sentence, and the save toast shows it before any mapping by exception type. A project from a newer Titano reads as `Editor.Error.Project`. | Map every save failure by type (`ErrorText.ForServer` / `ArchiveFailures.Cause`) | Frames changed on the server, a 409 after the last retry, a gone sequence or a read-only account are I/O or invalid-operation failures by type, so mapping by type said 'The server does not answer' or 'Something went wrong' instead of what happened. |
| 2026-10-12 | Keys whose count travels as data (analysis findings, advisor reasons) are plural stems whose count is their first argument, resolved by `Loc.Text`; a fractional or non-numeric count takes `other`. A text with two or more counts is written as labels ('Frames: 300, warnings: 2', 'Copied: 40 · failed: 2'). | A count index stored with each finding, or plural forms for every count of a multi-count text | One rule keeps stored deep reports and project reasons valid. Labels agree with no number in any language, and a cross product of plural forms is unworkable for translators. |
| 2026-10-12 | `i18n check` fails on an English text that puts a number before a counted noun without plural forms (CountedNoun), and on a tally of two or more counts followed by participles or adjectives (CountedTally). A single '{0} failed' or '{0} missing' is not flagged. | Flag every placeholder followed by a participle | Before a single participle the placeholder is as often a name ('Import of {0} failed', a job kind in '{0} queued') or a size ('{0} missing') as a count, so CI would fail on correct texts. |
| 2026-10-12 | Where the English reads correctly with a bare count and a mockup fixes that English (Uploader progress line), or where the key belongs to another area that needs no rewording in English (admin dashboard upload total), only the Italian takes the label form. | Reword the English as labels too and drop the other translations | Mockup wins for looks; the defect is only in languages whose participles agree with the number. |
| 2026-10-12 | The Archive screen keeps 'which archive was read' (`_readId`) apart from availability. Until the picked archive is read, Rebuild and the online-only commands wait, and their tooltips say 'Wait until the archive is read.'. The previous archive's figures for the rebuild dialog, its health fixes and its search results are cleared, and a running search is cancelled. | Force the picked archive Offline until it is probed | Offline is a claim about the volume: the rebuild dialog told the user that a healthy archive was offline, with the previous archive's count, and kept Rebuild disabled for the life of the dialog. |
| 2026-10-12 | A replaced import result is disposed by the `Result` setter, and a just-queued import job is read back once after its id is recorded. | Dispose only in Finish; rely on job events | New import and a source change replace the result too, and a job that ends before its id is recorded (destination offline) sends its events before the screen listens. |
| 2026-10-12 | Offering and completing a render upload (`POST /sequences/{id}/renders`, `/renders/{uploadId}/complete`) needs the Edit permission | Upload or Edit, as for frame uploads | A render output counts against no quota and changes what the sequence shows to everyone. Clients already offer Send exports only with Upload plus Edit, so no flow breaks. |
| 2026-10-12 | A client that imports a card into the server reports it through `POST /api/v1/uploads/cards` (Upload permission). The server republishes each report as `cardEvent`, naming the account and client. A server without the endpoint (404) gets no further reports | Server-side detection from upload session keys | The server sees single uploads, not the card, the plan's size or when the import ends. §14.3 names the event but not its source. |
| 2026-10-12 | Project frame positions (exclusions, hero, camera keyframes) stay positions in `project.json`. When the index takes a sidecar in which frames were only inserted, they move with their frames, inside the index transaction and under the sequence lease, without a new settings version. `project.json` follows unless it was written since. Any other frame change leaves them as they are | Store exclusions and the hero by frame id; bump `settings_version` on a move | Keeps the project format and old projects. Each copy (server, synced PC) moves its own positions when it receives the same frames, whereas a version bump would make sync push a move the other copy then makes again. The lease makes a local editor's save read the moved positions and merge onto them, and remote editors already go read-only when frames change. |
| 2026-10-12 | A damaged or wrong-size original replaced by a verified re-upload is kept beside it as `<name>.damaged-<UTC time>` and is never deleted by Titano | Delete it after the repair, or move it to the trash | BRIEF §0.2 rule 8 forbids automatic deletion. Scans ignore the name, and the user decides. |
| 2026-10-12 | The Uploader deletes a source only after its own verified upload, not when the server answers that it already holds the content, so such watch-folder files stay | Also delete on "already on the server" | That answer comes without the server re-reading the bytes. BRIEF §15 deletes after a verified upload only. |
| 2026-10-12 | An upload whose target sequence (the requested one, or the one its session key names) already holds its content is free: a repair adds no used bytes, and the quota checks at start and completion skip it | Charge every committed upload | The archive does not grow. `used_bytes` is never recomputed, so charged repairs drifted it upward and could refuse the repair itself. |
| 2026-10-12 | The upload shortcut and the recovery of a crashed commit accept only an intact copy (no missing or corrupt flag, file present with its size), the target sequence's own copy first. A target that holds the content only in damaged copies always gets the bytes | Any copy in the archive | A client may delete its file on "already exists", and another sequence's copy cannot repair the target's frame. |
| 2026-10-12 | Card events: one account's progress is published at most once a second (sooner reports get 204 and are dropped), and at most 120 card events per account per rolling minute (429 `rate_limited` beyond). A client gives its last reports 2 s after an import ends, then cancels them | No server limit; wait for every report (10 s each) | Event queues hold 512 events and drop the oldest, so one upload-only account could push job and sequence events out of every client's queue. An import that was cancelled or lost its server must end at once. |
| 2026-10-12 | A sequence created through `POST /api/v1/sequences` gets its folder with its first frame, named by the archive's folder template from that frame and the title, like a sequence created by an upload. A sequence that ever held frames is never moved, even one at the archive root whose sidecar is missing | Create a folder when the sequence is created | The folder template needs the capture date and camera, which only the first photo gives. Moving a root-adopted sequence would drop its photos from the index. |
| 2026-10-12 | Decode tiers are recorded per frame (sidecar `tier`, `previewW`/`previewH` and the `PreviewOnly`/`Undecodable` flags; index `frames.preview_width`/`preview_height`, `sequences.preview_only_count`). The light analysis probes headers once per frame of unknown tier; deep analysis, renders and thumbnail/proxy passes correct the tier with what decoding finds | Decode every frame at indexing; keep tiers in memory | The preview cap, the Library chip and render exclusions (BRIEF §8.2) need the tier on every host and after restarts; a header probe is cheap. |
| 2026-10-12 | Only a file in a format this host decodes natively (JPEG always) is flagged `Undecodable` when nothing decodes it; other formats keep the unavailable tier without the flag | Flag every frame without pixels | A HEIF or unsupported RAW on the server is beyond its decoders, not damaged: a render node, a client or a proxy can still provide its pixels. |
| 2026-10-12 | A planned frame that stops decoding during a render shows its nearest planned neighbour (earlier first), is logged (`Export.Log.StandIns`) and flagged for later renders; the render fails only when no planned frame decodes. Only frames the pipeline asks for get a stand-in | Fail the render (previous behaviour) | BRIEF §8.2 tier 3 excludes such frames from renders; one file damaged after indexing must not lose a long render, and frames a speed-up skips are never shown. |
| 2026-10-12 | A read error never makes a frame undecodable: `ImageDecoder.Decode` throws the `IOException` when a provider could not read the file and none produced pixels; deep passes leave frames they could not read (or that vanished) unflagged, and a frame only an interrupted earlier run found undecodable is decoded again before it is flagged | Read one byte to check readability before flagging; trust the checkpoint | A sharing violation (antivirus, backup) or a network hiccup would otherwise drop good files from every render; the decoder already knows which providers failed to read. |
| 2026-10-12 | Preview sizes come from probes and unscaled decodes only; a size-limited decode records the tier without a size | Take the size of every decode's preview; keep only the largest seen | A size-limited decode picks the smallest preview that reaches its edge (CR3 PRVW 1620×1080 instead of the 6000×4000 track), so the output cap followed the last render's size. |
| 2026-10-12 | A GoPro GPR's JPEG is looked up in the index when it is not beside the GPR (the archive's JPEG frame with the GPR's original stem and capture time ±1 s) and passed to the decoder as `DecodeRequest.Companion`; GPRs whose JPEG is indexed later are probed again. Render nodes receive only the GPR originals and decode them through their embedded preview | Record the JPEG's path on the GPR frame at ingest; copy or move the JPEG into the GPR sequence | BRIEF §8.1 makes the JPEG the server's pixel source; the per-format split (2026-10-02) keeps the JPEG sequence, and an index lookup survives renames and moves without changing ingest, uploads or node manifests. |
| 2026-10-12 | Thumbnails judge a stored embedded preview by its own JPEG header (≥ 320 px), not by the sidecar's preview size | Trust the sidecar's size | The sidecar's size can be a GPR companion's, larger than the preview embedded in the file (BRIEF §8.5). |
| 2026-10-12 | The MakerNote intervalometer hint is read from Panasonic `TimerRecording` only and kept as `FrameFlags.Intervalometer`; when most frames carry it, gaps are deliberate pauses and the advisor picks adaptive timing | Parse Fujifilm and Olympus drive-mode tags; a nullable sidecar field and index column | Nikon keeps the state in its encrypted ShotInfo, and Canon, Sony, Fujifilm and Olympus document no interval-shooting tag (their drive modes list single, continuous and bracketing); a flag bit travels through sidecar, index, sync and protocol without a migration. Frames indexed earlier gain it only when they are adopted again. |
| 2026-10-12 | The RAW size (Canon sRAW/mRAW, Nikon RAW M/S) is read into `FrameMetadata` but not stored per frame | A sidecar and index field | Nothing in the brief consumes it beyond parsing; the decode tier already reflects sRAW (the CR2 developer refuses it, so such frames fall to the preview tier with that reason). |
| 2026-10-12 | The MakerNote exposure mode (Canon, Olympus, Fujifilm, Panasonic, Sony) fills `ExposureProgram` only when Exif has none | Prefer the vendor value | Exif is the standard field most cameras write; the vendor value covers bodies that leave it out. |
| 2026-10-12 | `PRAGMA compile_options` is probed once per process, logged and written to the diagnostics bundle; any failure gives an empty list | Fail opening the index; probe on every open | BRIEF §6.2 makes it informational: Titano uses no optional SQLite feature (FTS, JSON). |
| 2026-10-12 | Frames both analyses find undecodable are one finding over the union of both lists, at the higher severity | Keep the light finding and drop the deep one | The deep pass also lists missing and corrupt frames and those beyond this host's decoders, which are never flagged; dropping its finding hid them and miscounted. |
| 2026-10-12 | A `.titano` project file is versioned UTF-8 JSON (`titano-project`, formatVersion 1) that names the archive (id, name, path) and the sequence (id, folder, title, frame count) and carries the project.json settings. Opening it finds the sequence by id, otherwise by the same folder in the same archive, and applies the settings as one undo step. | A self-contained bundle (zip with frames or proxies), or a bare copy of project.json | Frames live in the archive and the index already knows them. A small reference plus settings is what BRIEF §18's file association needs, survives an index rebuild (folder fallback) and never duplicates photos. |
| 2026-10-12 | One Titano per data folder: a named mutex keyed by the data folder's hash. A later launch hands its arguments over a current-user named pipe. The running one listens from the moment it holds the mutex and queues messages until its window exists. It stops listening when its window closes but keeps the mutex until its services have stopped. A launch that gets no answer waits up to 30 s for it to exit and starts in its place. An elevated instance's mutex counts as 'running'. | Several instances on one data folder, one instance per user, or exiting when the hand-over fails | Two processes would share one SQLite index and job engine. Portable copies have their own data folder. Without the queue and the wait, a file double-clicked during start-up or just after closing was silently dropped. |
| 2026-10-12 | The Server component installs only for all users in a folder inside Program Files or Program Files (x86), not Program Files itself. Upgrading an installation elsewhere (per-user, or all-users in another folder) cannot add it, and a Server it carried is dropped with its service. | A protected DACL set by setup on a custom folder, or only a warning | A LocalSystem service must not start a program a standard user can replace (CWE-732). Program Files' inherited permissions already guarantee that, while rewriting ACLs on arbitrary drives (FAT, network shares, folders with other files) is unreliable. |
| 2026-10-12 | Setup changes only services, sign-in entries and shortcuts that start a program its install log or payload lists, with full paths compared ignoring case. The services are stopped, started, pruned or deleted through the Service Control Manager. An unelevated setup runs `/SERVICES=… /NAMES=… /DIR=…` in an elevated copy that reads each named service again and refuses one that no longer starts such a program. | Everything under the install folder; sc.exe; trusting the caller's list | The folder may be shared (D:\Apps, /DIR="C:\Program Files"). No external processes may run. An elevated step must not act on what an unelevated caller merely names. |
| 2026-10-12 | Setup asks programs to close before touching any service. On install it stops the running services, then installs, then prunes services whose program is gone and starts exactly the ones it stopped, whatever their start type. On uninstall it deletes the services only once the programs have closed, just before the files go. Any failure after a stop starts those services again. | Stop or delete services first; start every automatic service after an upgrade | A program refusing to close left the Server stopped, or its service already deleted, and a failed upgrade left it down until reboot. An administrator's deliberately stopped service, or a running demand-start one, keeps its state. |
| 2026-10-12 | User data ownership in %LOCALAPPDATA%\Titano: entries starting with `uploader` (also inside `logs`) are the Uploader's, everything else the desktop app's. 'Remove my data' offers only the data of the uninstalled product's components that no other registered Titano product (same Publisher) has. A product whose folder or log cannot be read now counts as using all of it. | Delete the whole folder; hide the option whenever another product is registered | The products share the folder. An offline drive or damaged log must not make a still-installed product's index or upload queue look orphaned. A stale entry only hides the option, which is the safe direction. |
| 2026-10-12 | A shortcut that starts an existing program elsewhere is not created or retargeted, but it is logged. When the product it starts is uninstalled (or an upgrade drops it), the shortcut is pointed at the same program of another installation of the same scope whose log lists it, and only deleted when there is none. | Each product overwrites and deletes the shared 'Titano Uploader' shortcuts; distinct names per product | Both products ship the Uploader under the same shortcut name. The program that stays installed keeps its Start menu and desktop shortcuts, and neither uninstall touches the other's. |
| 2026-10-12 | Sign-in entry cleanup: SetupRegistry.DeleteStartupEntries removes the client's ('Titano') and the Uploader's ('Titano Uploader') Run values, named by Core/IO/StartupCommand (shared with fix/shell-notify), only when they start a program the install log lists. This happens on uninstall and on an upgrade that drops that program. When merging with fix/shell-notify, keep this branch's DeleteStartupEntries and its call. | Every Run value under the folder (first version); the folder-scoped variant of fix/shell-notify | One implementation after the merge. Nothing outside Titano's own value names and installed programs is touched, so a portable copy in a subfolder keeps its entry. |
| 2026-10-12 | 'Maintenance release.' is written whenever no section or breaking entry was written, also under a title. | Test the output length | release.yml always passes a title, so the old check never fired (BRIEF §19.3). |
| 2026-10-12 | A frame read from its proxy (an original this host cannot decode) records no decode tier: thumbnails drawn from the proxy, and renders or analyses that read it, leave the original's tier and flags as they are. | Record the proxy's tier | The tier describes the original on this host (BRIEF §8.2); a proxy that decodes says nothing about it, and its Undecodable flag must stay so renders keep reading the proxy. |
| 2026-10-12 | *Reset all* also turns *Start with Windows* off; importing a settings file leaves it alone. | Keep the sign-in entry on reset | The entry belongs to this copy and lives in the registry, not in the settings file; its default is off, and a settings file from another PC says nothing about this copy. |
| 2026-10-12 | An import from a folder or the server starts with *Keep* and no eject, whatever Settings › Import says for cards. | Apply the card defaults to every source | Delete, format and eject concern cards only (BRIEF §13); a folder or server source keeps its photos. |
| 2026-10-12 | The restore dialog's summaries read as labels ("Backup: sequences 12, photos 3,400"). | Plural keys | One line counts two things; plural forms select on one number only. |
+15 -2
View File
@@ -10,11 +10,18 @@ Phase plan: docs/BRIEF.md §22. Windows behaviour is verified on CI (`windows-la
| 3 Library and Archive manager | Done: Library (virtualised grid and list, timeline with year bands, filters, saved views, quick actions, mass bar, *Delete…* into the archive's trash with a dry run, typed confirmation and Undo, cards for server-only sequences), Archive manager (tree, health, statistics charts, maintenance with *Trash…* and restore, verify, duplicates, orphans, adopt, mass rename and move with dry runs), Jobs, Settings, Welcome, Server and About. Gate measured on 500,000 photos: Library open 259 ms on SQLite and 181 ms on PostgreSQL on a new connection pool (warm OS cache; budget 1 s); every filter, search, sort and next page ≤ 6.4 ms (budget 200 ms). |
| 4 Card import | Done: device detection, card pool and camera profiles, plan with sessions (merge and split), hash-verified copy, post-actions (verified delete, format behind a typed confirmation, eject), auto-import, Archive, Folder and Server destinations. Gate: import from a simulated card folder end to end in tests; delete and format refuse any photo the import did not verify; screenshots on `ci-screenshots`. |
| 5 Analysis advisor | Done: light and deep analysis, reports and section charts, recommendations with localised reasons, sequence presets, Auto/manual controls and Optimise in the editor. Gate: golden recommendations for synthetic sequences; every reason key exists in `en` and `it` (`i18n check`); deep analysis streams with checkpoints and resumes after a restart. |
| 6 Engine, encoding, editor | Done: render pipeline, MP4/AVI/GIF/APNG/image sequences, Media Foundation H.264/HEVC/AV1 with managed fallbacks; the sequence editor (Frames, Exposure, Camera, Motion and Export tabs, preview tools, section charts, curve editor, undo/redo, batch export) for local and server sequences. Gate: self-test suite green; the in-house inspector validates the containers the tests write; the encoder in use is logged. Playback in Windows Media Player is part of the release test. |
| 6 Engine, encoding, editor | Done: render pipeline, MP4/AVI/GIF/APNG/image sequences, Media Foundation H.264/HEVC/AV1 with managed fallbacks; the sequence editor (Frames, Exposure, Camera, Motion and Export tabs, preview tools, section charts, curve editor, undo/redo, batch export) for local and server sequences. Gate: self-test suite green; the in-house inspector validates the containers the tests write; the encoder in use is logged. Playback: MediaPlayer opens the Media Foundation output and a source reader decodes its first frame (Windows tests); every `--capture` screen is pixel-diffed against `tests/visual/baselines` (`screenshots diff`). |
| 7 Server, sync, uploader | Done: server (API, auth, uploads, jobs, render nodes, events, admin panel with light and dark themes, Windows service), Uploader, client sync (sync table, conflicts with *Save both*, proxies kept offline, metered pause), server sequences edited with proxies and rendered where the originals are, this PC as a render node. Gate covered in-process: a sequence uploaded from one PC downloads identically on another, interrupted uploads and downloads resume, server events update a PC, renders run on a node and on the server's managed fallback, jobs resume after a restart, sign-ins and administrative actions are audited. The run with two real PCs and the Uploader against the Docker server is part of the release test. |
| 8 Release readiness | Release pipeline end to end (installers, portable and server zips, SHA256SUMS, release notes, optional signing, multi-arch GHCR image, public releases repository content), update check with verified download, scrubbed diagnostics bundles (desktop and server), performance gates, 38 cultures (`en`, `it` and 36 machine translations with glossaries and independent reviews), RTL pass (`ar`, `he`: mirrored windows, left-to-right islands for media, charts, numbers and paths; any right-to-left culture added later follows), accessibility pass (names, live regions, keyboard paths for charts and the curve editor). Pending: a tagged pre-release published from CI, install/upgrade/uninstall test on Windows, Unraid template validation on a real server. |
| 8 Release readiness | Release pipeline end to end (installers, portable and server zips, SHA256SUMS, release notes, optional signing, multi-arch GHCR image, public releases repository content), update check with verified download, scrubbed diagnostics bundles (desktop and server), performance gates, 38 cultures (`en`, `it` and 36 machine translations with glossaries and independent reviews), RTL pass (`ar`, `he`: mirrored windows, left-to-right islands for media, charts, numbers and paths; any right-to-left culture added later follows), accessibility pass (names, live regions, keyboard paths for charts and the curve editor). CI installs the packed installers silently on a clean `windows-latest` runner, runs the installed programs, upgrades in place and uninstalls (files, Add/Remove Programs, shortcuts, file type, user data kept, exit codes). Pending: a tagged pre-release published from CI, the interactive install on a real PC, Unraid template validation on a real server. |
| 9 Monetization | Not started: requires explicit approval (§22). |
## Verification (2026-10-12)
A full audit against the brief, `CLAUDE.md`, the UI kit, the tests and the Docker and client setups confirmed 71
defects with independent verifiers; all are fixed (rows dated 2026-10-12 in DECISIONS and CHANGELOG). The Docker
image was built and run with PostgreSQL 17, a fresh archive folder and remapped ports; the client installers are
installed, run, upgraded and removed on `windows-latest` by the `installer` CI job.
## How to try it
```
@@ -36,6 +43,12 @@ src/Titano.App/bin/Release/net10.0-windows/Titano.exe --capture out/screenshots
- Sync: sign in on Server (trust the certificate once); the sync table lists every sequence of both sides. Open a
server-only sequence from the Library to edit it with proxies; *Render* runs on the server or a render node.
- Language: Settings › General › *Language* switches at once; Arabic and Hebrew mirror every window.
- Settings: Import, Analysis and Formats pages; Archive rows edit the open archive's `archive.json`; Advanced ›
*Restore* picks a daily backup, compares it with the index and restores it at the next start.
- Project files: Export › *Save project file* writes a `.titano` file; opening it (double-click or `Titano.exe <file>`)
opens the sequence with those settings in the running Titano.
- Notifications: minimise Titano and insert a card or finish a job: a Windows notification appears; Ctrl+1…6 and
Ctrl+, switch sections.
## Next steps (Phase 8 gate)