Files
Chronos/docs/DECISIONS.md
T
Claude c0bbbae7e2 docs: full steps for a console-run data folder; align the proxy and sign-in rows
The releases README told the operator to make Administrators the owner of a
data folder created by an unelevated console run. The server checks the owner
of every entry inside, and the TLS key and password file keep a protected DACL
that grants the console user, so it now gives takeown /A /R and icacls /reset
/T, and says that deleting the folder also deletes the SQLite database.

DECISIONS: the trusted-proxies row no longer endorses a Docker subnet, and the
sign-in entry cleanup row says an upgrade that renames a program moves its
entry rather than removing it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
2026-10-12 16:06:04 +00:00

334 lines
121 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Decisions
One line per decision: date · decision · alternative · reason.
| Date | Decision | Alternative | Reason |
|---|---|---|---|
| 2026-10-02 | The prototype dump `docs/reference/titano-prototype.md` was not supplied; algorithms are implemented from the brief's descriptions and the cited literature, with the §20.4 thresholds as acceptance tests. | Wait for the dump | Not available in the repository or uploads; the brief fully specifies behaviour and gates. |
| 2026-10-02 | Custom WPF theme dictionaries (`Titano.Ui/Themes`) implementing DESIGN.md tokens instead of `Application.ThemeMode` Fluent. | Fluent theme + overrides | DESIGN.md fixes exact colours/sizes; Fluent is still flagged experimental (WPF0001) and would need restyling of most controls anyway (§2.1 permits in-house dictionaries). |
| 2026-10-02 | Added shared WPF library `src/Titano.Ui` (theme, icons, controls, `Loc` markup extension) used by App, Uploader and Setup. | Duplicate resources per app | One visual system for three programs. |
| 2026-10-02 | Added `tests/Titano.Core.Windows.Tests` for WIC / Media Foundation / DXGI tests. | Put them in App.Tests | Keeps engine interop tests independent of the WPF app. |
| 2026-10-02 | Localization areas extended with `Common`, `Jobs`, `Uploader`, `Setup`. | Fold into `Shell` | Smaller, owned files; same key scheme. |
| 2026-10-02 | Resources live in `i18n/<culture>/<Area>[.<culture>].resx`, embedded into `Titano.Core` (satellite assemblies), base name `Titano.Core.i18n.<Area>`. Keys marked `<comment>invariant</comment>` need no translation. | Raw XML loader | Uses `ResourceManager` as the brief requires; satellites bundle into single-file publishes. |
| 2026-10-02 | Program icons (ICO) are generated at build time into `artifacts/icons` by `Titano.Tools make-icon`, invoked from `Directory.Build.targets`. | Commit generated ICO files | Brief forbids committing generated binaries and raster sources. |
| 2026-10-02 | In-house CRC-32 (`Titano.Core.Hashing.Crc32`). | System.IO.Hashing | That assembly is a NuGet package, not part of the shared framework. |
| 2026-10-02 | Windows projects target `net10.0-windows` (platform version 7.0) without a Windows SDK projection TFM; Windows 10 APIs are reached by P/Invoke/COM. | `net10.0-windows10.0.19041.0` | Avoids the CsWinRT projection; toasts use the in-window toast host plus tray balloon. |
| 2026-10-02 | Test projects use an explicit `TestMain` entry point. | Top-level statements | Avoids the `Program` type clash with the server's top-level program. |
| 2026-10-02 | SQLite P/Invoke binding lives in `Titano.Data` with a library resolver (winsqlite3 on Windows, system libsqlite3 elsewhere for tests/dev); the Linux server still refuses SQLite at configuration time. | Binding in Core.Windows only | Lets repository tests run on Linux CI against both dialects. |
| 2026-10-02 | Client preferences needed before the database opens (language, theme, window placement) are stored in `settings.json` next to the database. | Settings table only | Language and theme must apply before the first window appears. |
| 2026-10-02 | Server Windows-service hosting will use an in-house advapi32 P/Invoke host. | Microsoft.Extensions.Hosting.WindowsServices | That assembly is a NuGet package, not part of the shared framework. |
| 2026-10-02 | Admin panel files are embedded resources served by an in-house middleware with ETags and SPA fallback. | ManifestEmbeddedFileProvider | Its manifest generator ships in a NuGet package. |
| 2026-10-02 | Container health check runs `Titano.Server --healthcheck` (in-process HTTP probe). | curl/wget in the image | Keeps the runtime image free of extra tools. |
| 2026-10-02 | Container drops privileges with `setpriv` to PUID:PGID; `/data` is chowned, `/archive` only checked for write access. | Recursive chown of the archive | The archive may hold terabytes on NAS shares. |
| 2026-10-02 | Release workflow publishes to `RELEASES_REPO` (default `<owner>/titano-releases`) when the `RELEASES_TOKEN` secret exists, otherwise to this repository. | Fail without the token | First releases work before the public repository is set up. |
| 2026-10-02 | Release notes are generated by `Titano.Tools changelog` from `git log` piped on stdin. | Tool spawning git | Keeps the tool free of external process calls. |
| 2026-10-02 | CI `dotnet format` gate checks whitespace formatting. | Full style/analyzer verification | Analyzer rules already fail the build (warnings as errors); style preferences stay suggestions. |
| 2026-10-02 | Test runner exits 0 for a project with no tests and 2 when a filter matches nothing. | Always 2 | Empty projects during bootstrap are not failures; mistyped filters are. |
| 2026-10-02 | COM via `[ComImport]` + explicit `ReleaseComObject`; flat APIs via `LibraryImport`. | `[GeneratedComInterface]` | Deterministic release keeps files unlocked; the apps are not trimmed. |
| 2026-10-02 | WIC decodes to 64bppRGBA and linearises with the exact sRGB LUT (128bpp float only for float sources). | Always 128bppPRGBAFloat | WIC's integer→float gamma is not the exact sRGB curve and premultiplication darkens edges. |
| 2026-10-02 | Exif orientation is applied in managed code while de-interleaving. | `IWICBitmapFlipRotator` | Microsoft documents quadratic behaviour of the flip-rotator over scanline decoders. |
| 2026-10-02 | Volume watcher uses a hidden top-level tool window plus 3 s polling. | Message-only window | Message-only windows do not receive broadcast WM_DEVICECHANGE. |
| 2026-10-02 | Camera RAW is "native" via WIC only when the Raw Image Extension package is installed. | Decoder CLSID alone | The in-box RAW codec shares the CLSID but only reads embedded previews. |
| 2026-10-02 | HEVC/AV1 decoder presence is detected with `MFTEnumEx`. | Store package names | Also covers OEM and hardware decoders. |
| 2026-10-02 | Math code lives in `src/Titano.Core/Math` with namespace `Titano.Core.Mathematics`. | `Titano.Core.Math` | That namespace would shadow `System.Math` in every `Titano.Core.*` file. |
| 2026-10-02 | CCT = McCamy refined to the nearest Planckian point (Krystek, CIE 1960 uv), valid for \|Duv\| ≤ 0.02. | Plain McCamy | McCamy alone misses the 100 K gate above ~9000 K. |
| 2026-10-02 | Deflicker keeps (1 − strength)·ρ·S of a frame's deviation (ρ own Tukey weight, S window surviving fraction). | Blend by S only | S alone barely isolates outliers. |
| 2026-10-02 | LOWESS uses the k nearest valid samples with bandwidth = farthest distance + one spacing. | Fixed half-width | Constant sample count at sequence edges. |
| 2026-10-02 | Clock jump = backward step > 3× median interval or a ±1 h offset from cadence (DST); counts as one interval. | Any whole-hour step | Scheduled multi-hour pauses look the same. |
| 2026-10-02 | Time zone for solar labels: recorded offset → camera−GPS clock (15 min) → longitude/15 with a "time zone estimated" finding. | No day phases | Usable labels, honestly flagged. |
| 2026-10-02 | Holy-grail step is "received" when the detrended median jump ≥ 50 % of the metadata step (same sign); metadata amplitude is redistributed with smoothstep ramps lengthened until ≤ 0.3 EV/frame. | Measured amplitude | Flicker makes the measured jump noisy. |
| 2026-10-02 | Flicker fundamental = first autocorrelation peak within 80 % of the strongest; window ∈ [15, 151], odd. | Strongest peak | Avoids harmonics at fractional periods. |
| 2026-10-02 | Optical flow: dense pyramidal Lucas–Kanade with box filters, neighbour-flow correction, σ = 1 px pre-blur; grid step 4/2/1 px for Draft/Balanced/Best. | Farnebäck | Separable, SIMD-friendly, stable and as accurate on smooth motion. |
| 2026-10-02 | Phase correlation: Gaussian-shaped peak + log-parabola sub-pixel fit, both patches in one complex FFT. | Foroosh sinc fit | Exact for Gaussian peaks, half the FFT work. |
| 2026-10-02 | Stabiliser: noise-corrected texture gate, exhaustive pairwise similarity hypotheses (≤ 36) + weighted LS, path smoothed by Gaussian-weighted local linear regression (σ = 12). | RANSAC / plain Gaussian | Deterministic with nine patches; keeps intentional pans. |
| 2026-10-02 | Interpolation chooses velocities by forward–backward consistency with per-sample flow-agreement weights (τ = 3 px). | Super SloMo combination | Better at motion boundaries (36.8 vs 33 dB). |
| 2026-10-02 | Virtual-camera zoom is interpolated geometrically; trail length L ↦ decay 0.01^(1/L). | Linear zoom / half-life | Even perceived speed; the trail is gone at its stated length. |
| 2026-10-02 | Motion estimation, sharpness and noise use sRGB-encoded luminance. | Linear light | Shadows keep texture weight; less exposure dependence. |
| 2026-10-02 | Archive presets use 0.30 bpp (≈60 Mb/s at 4K24 HEVC 10-bit); share presets use the brief's per-codec defaults (0.10/0.07/0.05). | 0.07 bpp everywhere | An archive must survive later re-encoding; star fields are the hardest content. |
| 2026-10-02 | All metadata fallback chains (time, ISO, serial, lens, rating, size) live in `MetadataBuilder.Build`; parsers only collect candidates. | Fallbacks inside each parser | One place for priority rules; parsers are order-independent. |
| 2026-10-02 | `MetadataReader.Read(path)` throws when the file cannot be opened; malformed content becomes warnings (with a parser-fault safety net the fuzz tests require to stay unused). | Swallow everything | An unopenable file is not malformed input. |
| 2026-10-02 | HEIF `irot`/`imir` override Exif orientation (imir axis 0 = top↔bottom). | Exif first | HEIF decoders apply the transforms themselves; both would rotate twice. |
| 2026-10-02 | Main image size comes from the container's own size field (SOF, IHDR, ispe, VP8X, RAF crop record, RW2 borders, CR3 CMP1) before raster IFDs. | Always the largest raster IFD | That is what each container defines and what decoders output. |
| 2026-10-02 | Only MPF large-thumbnail entries count as previews; XMP date-only values are never used as capture times. | Every secondary image / midnight | Gain maps are not previews; midnight would be invented. |
| 2026-10-02 | Media Foundation interop uses `[GeneratedComInterface]` with explicit release; threads entering MF call `Win32Com.EnsureInitialized()` (MTA unless already STA). | `[ComImport]` like WIC | Hardware encoders stall when sample references wait for GC; source-generated COM does not initialise apartments, so it is done explicitly. |
| 2026-10-02 | MP4: 16-byte `free`+`mdat` placeholder rewritten to a 64-bit header past 4 GiB; negative composition offsets shifted to ctts v0 plus an edit list; parameter sets moved into avcC/hvcC; fast start on by default. | Always 64-bit mdat / ctts v1 | Small files stay maximally compatible; wider player support. |
| 2026-10-02 | GIF: Wu-criterion median cut, frame differencing against the source last drawn, identical frames merged by holding one back. | Plain median cut / diff against dithered output | Max palette error 37 → small; 945 KB → 52 KB at equal PSNR; exact delays. |
| 2026-10-02 | AVI always carries OpenDML indexes plus idx1 (1 GiB RIFF segments). | idx1 only | Files beyond 2 GB stay playable. |
| 2026-10-02 | MF encoder capabilities: software H.264 ≤ 4096×2304, hardware assumed 4096² (H.264) / 8192² (HEVC/AV1); an unsupported size fails at media-type negotiation and the next encoder is tried. | Querying limits | MF has no reliable capability query. |
| 2026-10-02 | Full-size JPEG IDCT is a port of libjpeg's accurate integer IDCT (bit-identical to djpeg); reduced-size (1/2–1/8) decoding uses float IDCTs with triangle chroma upsampling. | SIMD float IDCT everywhere | Float produced rare ±3 differences after YCbCr; reduced sizes gain 6.7 dB with triangle upsampling. |
| 2026-10-02 | Codecs throw only `InvalidDataException` for bad structure or unsupported features; damaged scan data yields a partial image plus warnings. | NotSupportedException for features | One exception type for callers and fuzzing. |
| 2026-10-02 | Linear DNG export: raw image in IFD0, lossless-JPEG tiles, ColorMatrix1 + ForwardMatrix1 for Rec.709 D65; source camera Make/Model kept when Exif is supplied. | Preview IFD + SubIFD raw | Simplest valid DNG; LibRaw renders test patches back exactly. |
| 2026-10-02 | Resampler keeps negative/overshoot values in linear light. | Clamp to 0–1 | Ringing stays within each kernel's exact bound; clamping happens at encode. |
| 2026-10-02 | Codec fixtures (each < 12 KB) are generated by `tests/fixtures/codecs/make-fixtures.sh` with libjpeg-turbo/libtiff dev tools and committed. | Fetch at test time | Reference outputs must be stable; the tools are not build or runtime dependencies. |
| 2026-10-02 | Installer payload "TPK1": deduplicated, deflate-ratio-bounded entries after the setup stub; footer aligned to 8 bytes and found before an Authenticode table so signing works before and after packing. | Spec fields only | Every offset is bounds-checked; signtool can append without breaking the payload. |
| 2026-10-02 | Setup runs `asInvoker` and relaunches itself elevated (`runas`) only for all-users installs; the unelevated parent starts Titano afterwards. | requireAdministrator | Titano never runs elevated. |
| 2026-10-02 | Uninstaller self-removal via a %TEMP% copy started with `/CLEANUP`; running programs are only asked to close (never killed; silent mode exits 5). | MoveFileEx alone / kill | Per-user installs have no admin rights; user data safety. |
| 2026-10-02 | Setup has its own `Program.Main` (silent and cleanup modes run without WPF) and is published with single-file compression (70 MB stub). | App.xaml-generated Main | Reliable exit codes; smaller installers. |
| 2026-10-02 | SQLite: one in-process async write lock with `BEGIN IMMEDIATE`, shared-cache in-memory mode for tests, fixed-width ISO-8601 UTC text with microseconds and lower-case UUID text. | busy_timeout alone / epochs | Writers queue instead of failing; text order equals time order on both dialects. |
| 2026-10-02 | PostgreSQL: parameters typed by OID, results in text decoded by OID, named prepared statements (128 LRU), session settings pinned in the startup packet, cancel = CancelRequest then socket abort after 5 s, transient retry once for idempotent reads only. | Untyped params / tracking ParameterStatus | Predictable decoding, no "could not determine data type", a dead server never hangs a caller, writes never repeat. |
| 2026-10-02 | Migrations: all pending ones in one transaction under `pg_advisory_xact_lock`. | One transaction per migration | Atomic and safe when several servers start together. |
| 2026-10-02 | Case-insensitive search/sort via lower-cased `search_text`/`title_key` columns (and `COLLATE "C"` on PG). | ILIKE / NOCASE | Identical results on both dialects. |
| 2026-10-02 | Job claim: `UPDATE … WHERE id = (SELECT … FOR UPDATE SKIP LOCKED) RETURNING` on PG; immediate transaction on SQLite. | Advisory locks | Exclusive under concurrency, as specified. |
| 2026-10-02 | One `JobEngine` in Titano.Data runs every long operation for both the client and the server: handlers per `JobKind`, progress persisted at most every 5 s, a failed persist (job no longer running) stops the handler, a shutdown leaves jobs running so the next start requeues them from their checkpoint. | Per-feature background loops | One queue, one cancel/pause/resume path and one crash-recovery rule everywhere. |
| 2026-10-02 | Job throughput is a moving average over windows of at least 2 s. | Average since start | ETA follows speed changes (cache warm-up, network) without jitter. |
| 2026-10-02 | Visual controls (card grid, filmstrip, charts, preview, curve editor) keep their layout and math in WPF-free classes; colours are theme brush keys re-resolved on theme switch; filmstrip, preview and time-axis charts never mirror in RTL (category charts lay out from the reading side since 2026-10-06, inside an element that stays left to right). | Math inside controls / brush properties | Testable on Linux; view models hold no brushes; time axes and images must not flip. |
| 2026-10-02 | `VirtualizingWrapPanel` does its own keyboard navigation and recycling; the focused container is kept alive. | ListBox navigation | Direct targets, wrapping across rows; focus survives scrolling. |
| 2026-10-02 | Library card slot 236 × 208 with a 16:9 thumbnail. | Mockup's 150 px thumbnail | DESIGN §4 specifies 16:9. |
| 2026-10-02 | Uploader sessions: key = 8 hex chars of the source folder's SHA-256 + first-frame time; leading test shots (first group < 8 frames) join the next session; watch-folder files always use automatic sessions. | Group by time only | Simultaneous cameras stay apart; unattended files never land in a sequence chosen for a manual drop. |
| 2026-10-02 | Uploader: a watch file counts as processed only after the server confirms it; offline, rejected-token and changed-certificate failures do not use up the three retries; a changed certificate signs the user out. | Mark at enqueue / count every failure | Clearing the queue loses nothing; an outage does not exhaust a large batch; never upload to an unverified server. |
| 2026-10-02 | Delete-after-upload also requires size and write time unchanged since hashing. | Server confirmation alone | BRIEF rule 8. |
| 2026-10-02 | Uploader settings are an in-window panel; single instance via a per-session mutex and a current-user named pipe; native tray menu (`TrackPopupMenuEx`). | Dialog / WM_COPYDATA / WPF ContextMenu | §12.1 allows modals only for login and destructive confirmations; works while hidden in the tray; dismisses reliably. |
| 2026-10-02 | Network watch folders are polled (default 5 min); local folders every 60 s plus `FileSystemWatcher` hints. | Watcher everywhere | SMB change notifications are unreliable. |
| 2026-10-02 | The Dockerfile uses BuildKit's built-in frontend (no `# syntax=docker/dockerfile:1`). | Pinned external frontend | Every feature used is built in; the build no longer depends on Docker Hub (a 502 there failed CI). Base images come from mcr.microsoft.com. |
| 2026-10-02 | SQLite sessions run every blocking call on the thread pool (`ThreadPoolHop`) and cancel through a per-connection flag polled by `sqlite3_progress_handler` (every 1000 VM instructions) in addition to `sqlite3_interrupt`. | Callers offload themselves / interrupt only | A repository awaited on the UI thread never freezes it; an interrupt that lands before `sqlite3_step` starts was silently lost and the query ran to the end. |
| 2026-10-02 | Deep analysis persists per-frame shifts from the nine-patch `Stabilizer` and smooths the path itself; per-frame data is stored as columns (~80–110 bytes/frame) with a JSON-lines checkpoint that drops a torn last line. | `Stabilizer.Solve` / row objects | `Solve` cannot resume from a checkpoint; the report stays small for 100k-frame sequences. |
| 2026-10-02 | Sky/land mask from a pre-pass over 15 sampled frames before the main pass. | Segment after the pass | Cloud coverage and per-region luminance need the mask during the pass. |
| 2026-10-02 | Scene distance: chi-square on histograms smoothed by ⅛ EV and levelled to the same mean; flow statistics use brightness-levelled images and forward–backward-consistent vectors only; noise is median-based (Immerkær). | Raw chi-square / raw flow / mean noise | Flicker and exposure steps no longer read as scene changes or motion; stars no longer inflate noise. |
| 2026-10-02 | Shake and motion thresholds are judged in output pixels (stabilise above 0.3 px RMS). | Source pixels | That is what the viewer sees. |
| 2026-10-02 | Automatic output stops at 4K UHD; no automatic stacking advice. | 8K / temporal-median denoise | 8K stays a manual choice; a median erases moving stars and stillness cannot be verified reliably. |
| 2026-10-02 | Apply records a missing-data reason only where no advice exists; Optimise returns modules to Auto and only adds to the user's hero, exclusions, offset or output cap; a preset's own choices are stored as manual values, content-derived values stay Auto. | Overwrite | Manual values stay in force; re-analysis does not undo a chosen preset. |
| 2026-10-02 | Advisor namespace is `Titano.Core.Advice` (class `Advisor`). | `Titano.Core.Advisor` | A class named like its namespace needed an alias in every `Titano.Core.*` caller. |
| 2026-10-02 | CI also force-pushes each same-repository PR run's screenshots as one commit to the `ci-screenshots` branch (separate job, only it has `contents: write`). | Artifact only | Artifacts need an authenticated download; a branch can be fetched with plain git for visual review. The branch never merges and holds a single commit. |
| 2026-10-02 | Export fps is the encoded grid; `Timing.FrameRate` is the playback rate (source frames per video second, default = export fps). Durations are quantised to output periods on rounded 90 kHz boundaries; whole frames are sampled at the period centre. | One fps / free durations | Presets keep their meaning, Interpolated can synthesise slow motion, AVI and image sequences stay exact. |
| 2026-10-02 | Adaptive timing is proportional up to 3× the median interval; longer gaps show for 3 + log2(r/3) frames (max 5); pauses ≥ 20× median and ≥ 120 s become a 0.2 s cut. Interpolated fills gaps of up to 3 missing/excluded frames. | Fixed clamps | Bursts stay faithful and long gaps cannot stall the video. |
| 2026-10-02 | A non-monotonic time-remap curve is repaired (sorted, clamped, made non-decreasing) with a warning; virtual-camera keyframes are keyed to source frame positions. | Reject the curve / output frame index | The remap is always monotone; keyframes stay on the content when timing or fps change. |
| 2026-10-02 | Per frame: exposure → one warp (stabilisation⁻¹ ∘ camera ∘ crop) to output size → flow, synthesis and blur in output space → stacking → knee. Stabilisation zooms by 1/max(crop scale, 0.75), warning below 0.75. Modules run only when Auto resolves true. | Flow in source space / no zoom | A single resample; flow sees stabilised content; borders stay hidden. |
| 2026-10-02 | Blur fraction = BlurFraction(target × speed, real) / steps, speed clamped to 4, no blur across cuts. | Fixed fraction | The look survives speed changes. |
| 2026-10-02 | Encoding overlaps processing by one frame; image sequences encode up to one frame per core into a hidden `.tmp` folder renamed at the end, named `<name>/<name>_000001.ext`. | Strictly sequential / `frame_%05d` | 1080p PNG 1.0 → 2.5 fps; crash-safe and editor-friendly. |
| 2026-10-02 | JPEG/MJPEG use 4:4:4 at quality ≥ 90, else 4:2:0; HEVC/AV1 → H.264 fallback rescales the bit rate by bits-per-pixel; size capped to the highest level, then the encoder maximum; managed bit depth moves to the shallowest supported depth ≥ the request; linear DNG tiles are sized to the frame (≤ 256 px). | — | Predictable quality and sizes; small DNGs are ~3× smaller. |
| 2026-10-02 | `Auto<T>` carries `HasAdvice`; `Resolve` falls back only when there is no advice. | Treat `default` as "no advice" | A value type's advised 0/false was indistinguishable from "no advice". |
| 2026-10-02 | `i18n check` also treats any C# string literal shaped `Area.Group.Name` with an existing area as a used key. | Marker functions such as `LocKey(…)` | Reason and warning keys travel as data; 53 render/export keys had no resources and the check did not notice. |
| 2026-10-02 | Sidecars store sequence and frame ids, original name, UTC offset, time source, `verifiedAt` and session keys; compact JSON with numeric flags and named enums that read as Unknown; a sidecar with a newer `schemaVersion` is read but never rewritten. | Ids only in the DB / string enums / rewrite | A rebuild returns the same ids; unknown bits survive; data safety. |
| 2026-10-02 | Frames stay in capture order: ingest inserts in place and renumbers later frames; thumbnails carry a source fingerprint and proxies an Exif capture time so stale ones rebuild themselves. | Append in arrival order / mapping file | Parallel uploads arrive out of order. |
| 2026-10-02 | Ingest batches one sidecar write per sequence for concurrent commits, protected by a write-ahead journal; "new sequence with title" uploads map to a session key of user + title. | One write per file / new sequence per call | Large sidecars are not rewritten per frame; a crash between move and sidecar write recovers; parallel uploads with one title share a sequence. |
| 2026-10-02 | Import sessions split per camera body and file format; the session key hashes body, format and first capture time; duplicates offer Skip or Import again, never overwrite. | Body only / random key / overwrite | RAW+JPEG would double every frame; an interrupted import continues its sequence; originals are never replaced. |
| 2026-10-02 | Card erase re-hashes both the card file and the archive copy and refuses files touched since the dry run; adoption reads light metadata only and Verify fills the hashes. | Trust import-time hashes / hash during adoption | User data rule 8; adoption stays fast. |
| 2026-10-02 | Index rows without a sidecar are kept and reported as orphans (only Rebuild or an explicit fix removes them); scan stamps are 100 ns ticks; a copied sequence folder gets new ids; index edits win over the sidecar when the index's settings version is ahead. | Auto-delete / timestamps / shared ids / sidecar always wins | A temporarily missing folder loses nothing; microsecond DB precision would make every scan see changes; duplicate ids corrupt the index. |
| 2026-10-02 | Writers coordinate through lease files (2 min, renewed every 40 s, stale leases renamed aside); thumbnail passes take their own `thumbs-<id>` lease. | OS file locks / the sequence lease | Locks are unreliable over SMB and across processes; long thumbnail passes must not block ingest. |
| 2026-10-02 | One `thumbs.pack` format: the archive's `ThumbPack` (frame index + source hash, append-only entries, index + footer, walk-back recovery). The decode workstream's second pack format and proxy builder were removed; its LRU `ThumbnailCache` stays for the UI. | Keep both | Both wrote `TTPK` files with incompatible layouts to the same path. |
| 2026-10-02 | Native RAW: the sensor saturation point only marks clipping (never rescales); white balance before demosaic, colour matrix after; highlight recovery lifts clipped channels to the unclipped mean then fades to grey; camera matrices match the exact model name; CR2 black level from masked columns; Sony as-shot WB falls back to daylight. | Per-frame white adjustment / prefix match / SR2 decryption | Per-frame rescaling would flicker a timelapse; D750 ≠ D7500. |
| 2026-10-02 | Frame-window spill stores 32-bit floats; DNG DefaultScale stretches the axis with the larger factor; ForcePreview uses an embedded JPEG preview only when it is at least the requested size. | Half floats / shrink / always preview | Renders stay bit-identical under memory pressure; full resolution; no blurry thumbnails. |
| 2026-10-02 | A job engine claims only kinds it has handlers for (intersected with `Kinds` when set) and starts no workers without any; crash recovery requeues the node's numbered workers (`node#0`, `node#1`, …). | Empty filter = every kind / exact node id | A host without a render handler must leave render jobs to render nodes; with several workers the old exact match never requeued crashed jobs. |
| 2026-10-02 | Desktop: the archive engine uses WIC first, then managed decoders; the last archive is reopened at start (relinking a moved one, finishing interrupted renames) and incrementally rescanned every 10 minutes; Welcome and Library create/adopt through the archive engine and queue a full scan; failures become a toast. | File-system watchers / no periodic scan | BRIEF §7: polling by mtime/size plus manual rescan. |
| 2026-10-02 | Desktop thumbnails: widths rounded up to 64 px, LRU of 2000 items, at most cores/2 (2–6) decodes, "no image" cached but failures not, a decode is cancelled when its card scrolls away; job list updates batched to ~10 Hz keeping the latest per job. | Fixed size per card / update per event | Fewer decodes, bounded memory, a free UI thread during fast renders. |
| 2026-10-02 | Server sign-in in the client: an unknown certificate fingerprint is confirmed before any password is sent, a changed certificate never receives the saved token, the token is stored only DPAPI-encrypted. | Trust on login | BRIEF §14.2. |
| 2026-10-02 | The client update check reads the latest non-draft, non-prerelease GitHub release of `TitanoReleasesRepo` and only opens its page; Clear cache deletes only folders carrying a `.titano-cache` marker, after confirmation; `--capture` runs on a temporary data folder with fake server, encoders and update check. | Download updates / clear any folder / real data | No external processes; never delete user data; CI never touches user data. |
| 2026-10-02 | The server registers the archive engine in `ArchiveModule` (ingest, asset locator, job handlers through `IJobHandlerProvider`) and opens its archive through `ArchiveService.AdoptAsync`; `ServerHost.Build` keeps the registration callback so tests can substitute fakes, and still refuses to start without ingest and locator. | Hard-wired registrations / DB row only | Tests stay isolated; the archive always has `.titano/archive.json`, so scans and ingest work from the first start. |
| 2026-10-02 | Admin cookies are `Secure`: cookie sign-in over plain HTTP only from loopback, `/admin` over HTTP from other hosts redirects to HTTPS; CSRF token derived from the session token's hash, cookie WebSocket upgrades must be same-origin. | Drop `Secure` / random double-submit cookie | BRIEF §14.2; a planted cookie pair cannot forge the token. |
| 2026-10-02 | Sign-in rate limit and lockout live in memory and apply to unknown names too; the generated first admin password goes to an owner-only file deleted once an admin sets a password; minimum password length 10; admin-created users must change their password; resets give a temporary password. | DB columns / log the password / email links | No user enumeration; secrets never logged; no mail infrastructure. |
| 2026-10-02 | API errors are localised through `Accept-Language` (fallback `TITANO_LANG`); ETags on sequences, manifests and originals (SHA-256) with `If-Match` doubling as the expected settings version. | English only / version in body only | Every user-visible string is a resource; standard HTTP caching and concurrency. |
| 2026-10-02 | Deleting a sequence moves its folder to `<archive>/.titano/trash/<id>` (with dry run); upload completion is synchronous and idempotent, survives client disconnect, and a failed ingest returns the upload to receiving (503). | Erase files / async commit job | User data rule 8 and undo; clients need the frame id at once and retries stay safe. |
| 2026-10-02 | Quota = used + pending uploads + new size, checked at start and at commit (render outputs not counted); the duplicate short-circuit matches a hash anywhere, preferring the target sequence; at most 8 concurrent chunk uploads per user (429), bodies capped at 1 MiB except chunks. | Committed bytes only / per-sequence only / request-rate limiter | Parallel uploads cannot slip past the quota; the brief's wording; simplest effective limit. |
| 2026-10-02 | Render jobs never run on the server engine: render nodes claim them by codec and resolution, report failures, and a job fails after losing its node 5 times. | Managed rendering on the server | No server render handler yet. |
| 2026-10-02 | Server settings page writes only edited keys to `server.json`; environment-fixed settings are locked; restart-only keys are flagged. Windows service: LocalSystem, automatic start, name `TitanoServer`. Admin panel: strict CSP (SVG charts, no inline styles); light and dark themes (2026-10-06, toggle in the header). | Rewrite the whole file / theme toggle | Secrets never written; DESIGN.md wins over the mockup toggle. |
| 2026-10-02 | Migrations are numbered without gaps (0001 initial, 0002 archive index, 0003 server uploads). | Keep 0005 | Parallel workstreams picked numbers to avoid collisions; renumbered at merge. |
| 2026-10-02 | `xaml-lint` checks keyed value resources against the property type (GridLength for column/row sizes, Thickness, CornerRadius, Double). | Rely on Windows smoke tests | A Double used as a column width compiles and only fails when the template loads on Windows; the lint now fails on Linux too. |
| 2026-10-02 | Languages with more plural forms add `key.few` / `key.many` beside the English `key.one` / `key.other`; `i18n check` accepts them, compares their placeholders with English `other` and lets any plural form omit the count. | One English-shaped key set for every language | "Rendered once" style forms cannot cover Russian 21 or Arabic 3–10 otherwise. |
| 2026-10-02 | Translations go through `i18n missing` (TSV out) and `i18n import` (TSV in) against `i18n/GLOSSARY.md` plus a per-language `glossary.tsv`; each language is translated and then reviewed by a second pass. | Edit resx by hand | Same path for machine translation and community corrections; keys, placeholders and budgets are validated in one place. |
| 2026-10-03 | `ProjectSettings.FromJson` lays the JSON over the serialised default project: objects merge, arrays and scalars replace, a null never replaces an object. | Deserialise directly | The source-generated reader turns missing members into null/0, so a partial or empty settings JSON lost whole sections. |
| 2026-10-03 | Light analysis is queued by the engine after an import and after a scan that indexed something (Background priority, skipping sequences already queued); deep analysis after an import is queued by the import post-action of the card profile. | Screens queue analyses | The advisor's recommendations exist without user action (§1.1) and nothing is queued twice. |
| 2026-10-03 | Analysis jobs log a failing sequence and continue; the checkpoint `next;i,j` makes a retry analyse only the failed ones; an offline archive stops the job at once. Sequence presets are written to the job log, advice fills Auto values only. | Fail the batch at the first error / apply presets | One bad sequence does not block a library-wide analysis; presets are a user choice. |
| 2026-10-03 | Render jobs whose every output is managed (AVI MJPEG, image sequences, GIF, APNG) run on the server engine. MP4 jobs wait for render nodes, matched by codec and per-encoder size, at least the node timeout and while an online node can encode them; then the server writes MJPEG/AVI at the same size and frame rate and says so in the job log (§14.7). A job the server started resumes only there. | Never render on the server / fall back immediately | A restarting node keeps its jobs and no job waits forever. Replaces the 2026-10-02 row "Render jobs never run on the server engine". |
| 2026-10-03 | Selective claims (`ISelectiveJobHandler.AcceptsAsync`) look at the first 100 queued jobs of selective kinds per claim; other kinds keep the atomic claim. | Scan the whole queue | Bounded cost per claim; documented limit. |
| 2026-10-03 | `POST /jobs` splits a batch into one job per preset; a render node fails a batch job instead of rendering only the main preset; a node registering again requeues jobs its previous run abandoned. Proxies have no hash: fetched whole on retry; originals are resumed and SHA-256 verified. | Nodes render batches | One output per job keeps progress, retries and uploads simple. |
| 2026-10-03 | A render on the server ignores the client's export folder and always writes to the sequence's `exports/`. | Honour the folder | The server never writes outside its archive. |
| 2026-10-03 | Sync state lives in a client-side `sync_links` table (one row per server sequence, linked to its local copy); server-only sequences appear on the Server screen and, since 2026-10-06, in the Library as remote cards. | Columns on `sequences` | One local copy per server; server-only rows need a home. The server-connected Library mode stays with the Library. |
| 2026-10-03 | Uploads create the server sequence by sending the first original under the session key `titano-sync:<localId>`; every original is re-hashed before sending and a mismatch fails the job. | `POST /sequences` | The server cannot store uploads into an empty sequence created that way; originals are sacred. |
| 2026-10-03 | Sync conflicts: any field changed differently on both sides is a conflict settled against the versions shown (Keep mine / Take server confirm the differing settings; Save both takes the server's and keeps this PC's settings as `.titano/project.this-pc-<time>.json`). A later change refuses the choice and compares again. | Tag union and newest-wins merge | §14.5 asks for last-writer-wins with an explicit prompt; a union brings removed tags back. |
| 2026-10-03 | Sync timing: full comparison every 2 min, server events batched for 1 s, failures back off from 5 s to 5 min. "Keep proxies offline" refreshes stale caches only for sequences this PC opened with proxies, after a free-space check. "Sync projects automatically" defaults to on. | Every server sequence / polling only | Bounded disk use; the brief says "synced sequences"; the mockup shows the option on. |
| 2026-10-03 | Renders keep their id on both sides and are offered for transfer only once the originals agree; render downloads are size-checked (the server keeps no render hash). Uploads on metered networks pause through the OS network cost API when the option is on. | Hash renders | No server field exists; uploads are hash-verified by the server. |
| 2026-10-03 | Not built: "Free local space" (deletes originals; needs an archive-engine offload state), the footer user count (admin-only data) and "changed by" in the conflict detail (no API field). | Build them in the sync layer | Data-destroying or privacy/API choices for the owner (§0.2.7). |
| 2026-10-03 | Update Download fetches the package for this copy (setup, or the portable zip for a portable copy), verifies it against the release's SHA256SUMS and shows it in Explorer; the user runs it. Files go to `%TEMP%\Titano\updates\<tag>`, `.part` resumed with Range, 60 s idle timeout, Cancel; without the package or SHA256SUMS, Download opens the release page. | Start the installer as §18 says | §8.6 allows only open-URL, explore-folder and SHFormatDrive; the stricter rule wins. |
| 2026-10-03 | Diagnostics bundles (desktop and `GET /api/v1/server/diagnostics`, ManageArchive, audited): environment, codecs and encoders, scrubbed settings or configuration, recent failed jobs (50/100), newest 14 logs (last 4 MB each); never photos. Secret-named JSON values are removed; in text a secret runs to `;` or end of line. | Remove whole lines / omit settings | Err towards removing too much while keeping bundles useful. |
| 2026-10-03 | Public releases repo content, GitHub Latest and GHCR `:latest` follow the newest stable release; the image is pushed after the Windows tests and `:latest` moves after the GitHub release exists; public content is updated last. Stable notes start at the previous stable tag. | Tag `:latest` in the docker job | No downgrade for compose/Unraid users and nothing public before a release exists. |
| 2026-10-03 | Perf gates (opt-in, weekly `perf.yml`): Library open through a new connection pool with warm OS cache; filters as the median of 5 runs; rebuild at one fifth of §1.1 (400 × 250 real photos, 120 s budget) on SQLite and PostgreSQL. No perf migration was needed. | Drop OS caches / full 500k files | Portable on CI runners while still catching plan and index regressions. |
| 2026-10-03 | `fixtures --allow-missing` prints a warning annotation per missing sample and exits 0; without it, 1. `Titano.Tools.Tests` covers tool behaviour CI relies on. | continue-on-error | CI shows the gap instead of a silent pass. |
| 2026-10-03 | Editor: the corrected-frame preview is built in the App layer (RenderPreparation corrections, then geometry, exposure and the knee), measured at 128 px; the preparation is split into a measuring pass and re-solves so slider steps never re-decode; analysis decodes are kept as Half within 1/16 of available memory (64–512 MB). | A Core single-frame entry point | Preview speed without touching the render engine. |
| 2026-10-03 | Editor autosave 400 ms after the last change with a three-way JSON merge (the editor wins on members both sides changed); a failed save stays pending and retries from 2 s doubling to 60 s; closing with an unsaved failure asks through a destructive modal. Undo takes adopted outside changes; a drag, click or key press is one step. | A Save button / dropping the change | Data safety; §12.1 allows modals for destructive actions. |
| 2026-10-03 | Editor 1:1 and wheel zoom render at the source's long edge, Fit at the view's size; labelled preview tools (icon + text) with full screen, play and the crop view icon-only; the shot-data pill moves above the tools when they do not fit at 1200 px. | Render only the visible region | Decoders decode whole frames; simplest correct option. |
| 2026-10-03 | Export tab: preset grid columns = width / 200 px; Output label column fixed at 96 px with ellipsis and tooltip; Optimise all skips Stack; render follow-ups are a toast with Show in folder plus the history line's show-file link. User presets ("Customise") are not built; the Export "Sync" box is (2026-10-06: ExportSettings.SyncToServer, off by default). | Fixed 4 columns / placeholder controls | The fixed grid clipped at 1200 px; user presets need a preset store and render-path resolution. |
| 2026-10-03 | Exposure measuring tool switches Luminance / Flicker (frame-to-frame log-luminance change before and after correction) / Waveform (luma per column band of the corrected preview); the Time tab shows a plan chart beside the remap curve; the Camera free crop is four margin sliders (≤ 45 % each, ≥ 10 % of the frame left). | One chart per tab | §12.3 measuring needs and Editor.html. |
| 2026-10-03 | Import omits the Convert row and the profile "New" button: card profiles are born on first insertion and shared through camera profiles (settings row followed by the cards of that camera; a card without settings joins automatically). | Conversion at import / card-less profiles | A converted file breaks the hash-verified erase/format gate and immutable originals; a profile needs a card identity (§13 "rules shared by all cards of that camera"). |
| 2026-10-03 | Import sessions merge in the session table and split per photo in Show plan (merges only into the earlier session of the same body and format). Folder and Server destinations run in the screen with a partial result on failure; a server 4xx (not 401/403) fails only that file. Automatic import always goes to this PC's archive. | New job kinds / abort on any error | No job handlers exist for those destinations; §13 lists errors per file; the archive is the gated destination for erase/format. |
| 2026-10-03 | Format gate: every photo on the card must be verified by the job's own import records; non-photo files are listed in the typed confirmation, not blocking; the card is re-listed right before SHFormatDrive, behind a typed confirmation of the card name; a card that leaves needs a new check. | Count only DCIM photos / block on any file | Sony and Canon cards always carry camera files; §8.6 and DESIGN §4. |
| 2026-10-03 | Archive manager: Overview (tree, tiles, charts, mass operations on the tree selection narrowed by a Camera/Status/Tag filter) and Maintenance (health with one fix per line, recent runs, duplicates, orphans); duplicates/orphans searches and retag run in-screen, cancellable and logged; rename apply is journaled and completed at the next open; Maintenance adds a database backup. No Merge/split yet (Delete… and Trash… exist since 2026-10-06, through the engine's trash). | Engine jobs for every action / Archive.html's single page | No result store for read-only reports; deleting or moving frames needs engine operations (the trash lives in the server). |
| 2026-10-06 | Radio buttons that bind TwoWay are grouped by their shared panel, never by GroupName (kept only for chips in item templates, which bind OneWay). | GroupName on every group | WPF shares a GroupName across every window not yet connected to the screen, so the installer capture (one window per stage, each with its own view model) cross-wired Just me / All users into an endless loop; the same applies to views built in tests and captures. |
| 2026-10-06 | Reading direction is set by TitanoWindow (constructor plus Loc.CultureChanged while shown, applied through the Dispatcher). UiLanguage keeps only a Window.Loaded class handler for plain windows such as FullScreenPreview. The Uploader's WindowDirection and Setup's own code are removed. | Keep three mechanisms (UiLanguage loop plus class handler, Uploader WindowDirection, SetupWindow code) | One place covers the client, Uploader and Setup windows created before or after a language switch. The class handler is still needed for the one non-TitanoWindow window. |
| 2026-10-06 | Toasts are announced with a UIA notification event on the host: errors use ImportantAll (assertive), other notices use All (polite). | LiveSetting on each toast container plus LiveRegionChanged | A toast is a new element, not a text that changes, and the host's peer is always in the UIA tree, whereas an item container's peer may not be. |
| 2026-10-06 | The job bar's live region announces ShellViewModel.JobAnnouncement (job name when it starts, the idle line when the queue empties). JobBar gets a StatusBar peer so the region has a peer. | Announce the job bar text | The bar text changes every second (counter, speed, time left), which is too noisy for a screen reader. This matches the integration rule 'announce states, not progress ticks'. |
| 2026-10-06 | The render job label arrow is chosen at creation by Loc.IsRightToLeft (Jobs.Target.Render / Jobs.Target.RenderRtl, both invariant). | A translatable '{0} → {1}' key that RTL translators change to '←'; or storing title and preset separately | This is the same pattern Import.Session.Time/TimeRtl already uses, it is right in RTL without waiting for translations, and it needs no schema or wire change. The label was already in the creation language through the preset name. |
| 2026-10-06 | Field.Error (an attached string with a read-only HasError) is the shared error state for inputs without a validating binding. PasswordBox triggers on it and on nothing else. | A Validation.HasError trigger on PasswordBox | PasswordBox.Password is not a dependency property, so Validation.HasError can never become true there. The Uploader and the login dialog needed a settable state. |
| 2026-10-06 | The TextBox template no longer applies Padding (TextBoxBase pushes it into PART_ContentHost, confirmed by reading the IL of TextBoxBase.AttachToVisualTree). The leading icon takes Padding as its margin, and fixed 22/24 px offsets apply only when an icon is present. | Keep the Grid margin and cancel the host's padding | The host's Padding is set by the control at every template apply and cannot be overridden from XAML. The placeholder and the text now start at the same x. |
| 2026-10-06 | The Arabic smoke test checks mirroring through FlowDirection values plus one TranslatePoint position check on the rail. | Only pixel or screen-coordinate checks | FlowDirection is what WPF mirrors by. The integration branch's capture fix shows the window content carries the mirror, so TranslatePoint to the window reflects it. |
| 2026-10-06 | The nav rail's RadioButtons keep GroupName 'Rail' (the two lists live in separate item templates) but bind IsChecked one way. | Group by panel as the integration decision says | Panel grouping cannot span two ItemsControls. A one-way binding keeps a shared GroupName from writing another window's selection back into the shell, which is the case the integration rule exists for. |
| 2026-10-06 | Common.CurveReadout is invariant ('{0} → {1}'). | Translatable so RTL languages could use '←' | The curve readout is drawn in a left-to-right island (numbers on an LTR axis), where '←' would point the wrong way. |
| 2026-10-06 | Heatmap month labels: initials only when all 12 abbreviated names start with a cased letter and contain no digit, otherwise culture-formatted month numbers 1-12 | A localized resource list Archive.Chart.MonthInitials, or hard-coded per-culture overrides | Correct for every shipped and future culture with no translation work. It also avoids non-Gregorian month names (fa uses Persian months) and needs no fallback for languages not yet translated. |
| 2026-10-06 | Keep IsEnabled=False on the content behind a dialog and give ListBoxes a template that does not repaint when disabled (the kit's Template.ListBox since the follow-up) | IsHitTestVisible=False plus keyboard containment instead of disabling | Screen readers and access keys still treat the content as disabled. Rows and buttons dim themselves, so the list does not dim twice. |
| 2026-10-06 | (Superseded by the kit follow-up: the charts draw labels in TextMuted and empty cells in Stroke; the aliases are gone.) Fix the chart-label contrast and invisible future months through token aliases scoped to the chart grid and the heatmap (Brush.TextFaint -> Color.TextMuted, Brush.Card -> Color.Stroke) | Edit BarChart/HeatmapStrip (owned by the shared group) or only report the defect | Smallest local equivalent that fixes a major contrast defect now, with no new colours. It follows theme switches through DynamicResource and becomes inert once the kit is fixed. |
| 2026-10-06 | Index health duplicates line: after a duplicates search it shows the groups found (warning with a Mark copies fix); before any search it shows the flagged-copy count ('No copies flagged' / 'n duplicate frames' with Show) | Only reword the line to flagged copies, or hide it until a search has run | The line can never be a green tick while the Duplicates card lists groups, and it keeps the flagged-copy information that already existed. |
| 2026-10-06 | All orphan kinds use the Warning glyph (▲ amber) | Add a neutral/info StatusKind in the shared kit | Every orphan line is an actionable issue with a fix button, and Warning is readable in both themes without a kit change. |
| 2026-10-06 | Archive failures become a toast with the action's title, one localized cause sentence from ArchiveFailures.Cause and a Retry action that re-runs the same command; relink Retry re-opens the folder picker | Open logs as in Shell.ReportError, or retry with the same folder | BRIEF 0.2 rule 6 asks for one sentence plus one action. Retry fits these I/O failures. Re-picking the folder covers both 'drive is back' and 'wrong folder'. |
| 2026-10-06 | Dialog failures appear as an error line (✕ Error StatusGlyph, raw text in its tooltip) with no separate Retry button; Apply stays the retry, and a failed apply re-runs the dry run | Add a Retry button to the Rename and Retag dialogs | DESIGN allows two dialog buttons at most. Re-planning shows what is left after a partial or stale apply. |
| 2026-10-06 | Cancel is the default (Enter) button in the Rebuild, Rename and Retag dialogs | No default button, or Apply as default | DESIGN: the safe action is left and default. Enter in the text fields is already handled by EditBehavior. |
| 2026-10-06 | Rebuild counts show '—' with the reason (offline sentence or failure cause) in the tooltip when they cannot be counted | Remove the two count rows when they cannot be counted | The dialog keeps the same shape, and the reason sits next to the value it explains. |
| 2026-10-06 | Rename the Overview/Maintenance segment to 'Health' (new key Archive.View.Health; it: 'Stato') and keep the toolbar's 'Maintenance ▾' | Rename the toolbar menu to 'Tools ▾', or change the English value of Archive.View.Maintenance | BRIEF 12.5 names the toolbar menu Maintenance. A new key makes the missing translations visible in i18n check instead of leaving stale ones. |
| 2026-10-06 | Paths inside sentences are wrapped with the existing Formatting.LeftToRight (LRE/PDF); path-only elements get FlowDirection=LeftToRight with start alignment | LRI/PDI isolates as the review suggested, or Import's BidiText.Ltr | Reuses the app-wide facility already used by Settings, Welcome and Server, and gives the same result for these strings. |
| 2026-10-06 | In RTL the tree swaps its arrow keys, and the year tooltip uses a second key (Tooltips.Archive.YearRowRtl) chosen at runtime | One direction-neutral tooltip using arrow glyphs | Matches WPF TreeView behaviour. Translators of RTL languages get a sentence that already names the right keys. |
| 2026-10-06 | Chart values reach screen readers through AutomationProperties.HelpText built from the bar and month tooltips | Wire ItemActivated/CellActivated to filter the set, or add an automation peer per bar | Not every chart has a matching set filter (format, month). HelpText needs no kit change and keeps the chart's own name. |
| 2026-10-06 | The heatmap scale moves into the card header as '0 ▭ max' (Accent bar with an opacity-mask gradient) and MaxCellSize rises to 32 | Right-align the kit's own scale under the grid | Matches Archive.html and lets the grid use the card's width. |
| 2026-10-06 | The set filter button's accessible name is 'Set filter · <current set>', built from existing keys | AutomationProperties.ItemStatus or HelpText set to the set text | Narrator reads the name first and always, and no new key is needed. |
| 2026-10-06 | A 409 whose settings were changed to different values on both sides opens an explicit prompt, and nothing is sent until the user chooses. Keep mine is destructive and overwrites the server's values. Take server is the safe default (also on Enter or Esc): it applies the server's values as one undoable step, and Ctrl+Z brings the editor's values back. Members changed on one side only still merge silently. The local editor keeps editor-wins for changes made by this PC's own analysis jobs. | Editor-wins merge plus a toast offering to take the server's values; or document editor-wins | BRIEF §14.5 asks for last-writer-wins with an explicit conflict prompt when both sides changed. Editor-wins would silently overwrite another client's change. A modal is allowed for confirmations (§12.1). The safe default loses nothing because the editor's values come back with Ctrl+Z. |
| 2026-10-06 | The Export Sync checkbox sits on its own row under Save to (12 px). | Beside the folder ComboBox as in Export.html | The 194 px field column minus the 10 px scrollbar cannot hold the folder plus 'Sincronizza' or longer translations without clipping. Rules against clipping and for +40 % text width win over the mockup's placement. |
| 2026-10-06 | Export Sync is off by default, stored per sequence in the project's export settings, and travels inside the render job. | On by default, as Export.html shows it checked | BRIEF §14.5 says renders are uploaded on request. Uploads can be large. |
| 2026-10-06 | A render that finishes while the server session is down still queues its send, for the saved session's server. The send waits for credentials and fails visibly on the Jobs screen if they never come back. | Drop it, or keep a separate pending-send store | No silent loss and no new storage; the sync job already waits for credentials. |
| 2026-10-06 | Server sequences whose cached frames are not the server's (different ids or order) open read-only, or trigger a proxy download and then open. Frame changes while the sequence is open make it read-only, with a toast that offers Get proxies. | Edit against the stale list, or block opening outright | Project settings name frames by position (exclusions, hero, keyframes, remap curve). |
| 2026-10-06 | An account without the Edit right opens server sequences read-only. It may still pick a preset to render, without changing the project. | Refuse to open, or let it edit and fail on save | Viewing and rendering are separate rights on the server. |
| 2026-10-06 | The server's job progress shows beside the title in the editor header (glyph, 6 px bar, Cancel), and a failed or cancelled job raises a toast with Retry. | Feed server jobs into the shell's job bar and Jobs screen | The job bar and the Jobs screen list this PC's engine jobs only. BRIEF §11.5 requires cancel to be always available. |
| 2026-10-06 | For a server sequence, Save to, the Encoder row, the encoder name and notices, and the Jobs history link are disabled or hidden, each with a tooltip saying why. Renders are one server job per preset. | Show this PC's encoder and folder | DECISIONS 2026-10-03: the server always writes to the sequence's exports/ and splits batches per preset; the server or its render node picks the encoder. |
| 2026-10-06 | Save-both copies are listed and restored by a Restore settings split button under the Export history line. A restore is one undoable step, and its toast Undo only acts while the restore is still the latest change. | The header menu or the Frames tab | This is the least intrusive place: it is next to render history, it shows only when copies exist, and none of the mockups has room for it elsewhere. |
| 2026-10-06 | Additive API: GET /api/v1/sequences/{id}/analysis/report (Read permission), and UpdateSequenceRequest.HeroFrameId. Settings sent alone move hero_frame_id when heroFrame changes. | Ship the deep report inside the manifest, or have the client resolve the hero frame only | The manifest stays small, and the Library thumbnail follows the hero whoever edits it (the editor, or sync of a local copy). |
| 2026-10-06 | The checkbox's inner gap between box and text stays at the theme's 8 px. | Change the shared CheckBox template to 6 px | The template is shared by the whole app and lives outside this workstream. |
| 2026-10-06 | Render quick action renders the project's export as stored now: the editor's preset, else the advisor's recommended export preset that analyses store as an Auto value, else the default. Sequence-preset bundles (Night sky and others) are not applied by it. | Apply SequencePresets.Generate(...)[0] (a whole bundle of timing, exposure and motion settings) when the project has no explicit export. | The Auto ExportPreset is what the Export tab marks as recommended. Applying a bundle silently would override settings the user never saw (BRIEF §10.4: the advisor never touches manual choices; presets are one click by the user). |
| 2026-10-06 | A remote card's Render and Analyse are posted to the server (POST /api/v1/jobs render or deep-analyse) with the sequence's own project. The tooltip names no preset. | Download the server manifest for each card to name the preset in the tooltip. | Rendering happens where the originals are (BRIEF §14.6–14.7), and a manifest download per tooltip is costly. |
| 2026-10-06 | Delete runs in an in-window dialog shared by the Library and the Archive manager: a dry run with progress, a typed confirmation, a move into the trash with progress, Cancel between whole sequences, and an Undo toast. It is not a Jobs-screen job. Restore runs per entry from Maintenance › Trash… or from the toast. | An ArchiveJobs delete job with checkpoints on the Jobs screen. | The typed confirmation must sit between the dry run and the move, and Undo needs the result at once. It matches the rename dialog, and each sequence moves atomically. |
| 2026-10-06 | The typed confirmation for Delete is the number of sequences that move (Latin digits). | Typing a word such as DELETE or the sequence title. | It is language neutral and shows the user read the count (DESIGN §4 typed confirmation). |
| 2026-10-06 | Trash layout: <archive>/.titano/trash/<id>[-stamp] plus a <name>.json record (index row and renders). Restore re-indexes from the sidecar with the same ids, into the old folder or 'folder (n)'. A folder without its sidecar is adopted under the same id with the record's title, tags, rating and notes; a missing hero frame is dropped. | A trash in the database only, or erasing the files. | BRIEF §0.2 rule 8: nothing is erased, and sidecars stay authoritative. |
| 2026-10-06 | Delete is refused per sequence for an offline archive, the archive root, folders holding other sequences, busy sequences, a foreign sidecar or a missing folder. Busy covers running or paused jobs on the sequence, plus archive-wide Scan, Rebuild, Import, Maintenance and Verify-all on its archive. Sequences with no folder and no frames lose only their rows. | Block only on jobs that name the sequence. | Archive-wide jobs name the archive, not the sequences, and an import's target folders are known only to its plan. |
| 2026-10-06 | Server DELETE maps refusals to codes: 503 archive_offline, 409 sequence_busy (busy, stale plan or lease), 409 archive_root / contains_sequences / sidecar_mismatch / folder_missing / folder_in_use, 404 when the sequence vanished. | A single 409 sequence_busy for every refusal. | Clients show the right sentence, and an offline archive is a retryable service state. |
| 2026-10-06 | Move works on the sequences of one archive at a time, as a new folder layout through MassRenamer with a dry run. | Cross-archive move (copy, verify, then trash the source). | The task names the engine's existing move and rename facilities, and there is no engine operation for a cross-archive move. |
| 2026-10-06 | Saved views are app-scope settings rows (library.view.<id>) listed in a menu next to the layout switch (show, save, rename, delete with Undo). They are not a chip row. | Chips under the toolbar. | Width at 1200 px: the filters already wrap. |
| 2026-10-06 | The timeline is year bands with photos per month above the virtualised card grid, which stays visible. A month (click, or Enter from the keyboard) narrows to its year and scrolls to its first card once. | Replace the grid with a separate timeline list. | It reuses the virtualised grid and keeps the cards in sight (BRIEF §12.2 'timeline (year/month bands with density)'). |
| 2026-10-06 | Origin filter: All origins / On this PC / Only on server. 'Only on server' means server sequences without a copy here; local copies that came from the server count as 'On this PC'. Remote cards count in the Year and Camera choices and in the timeline. | Filter by Sequence.Origin, which would mix local copies into 'Only on server'. | A remote card is what the user cannot open without proxies (BRIEF §4.4 mixed mode). |
| 2026-10-06 | Remote card identity: a Sequence with Origin=Server and SyncState=RemoteOnly built from the server listing. Thumbnails come from the proxy cache, else the server thumb of the hero frame (or first frame, read as one row and remembered). Remote cards do not scrub. | Download the full manifest per card. | It is cheap, and the proxy cache is reused once opened. |
| 2026-10-06 | Status filter adds Rendered, Not rendered and Synced (index columns rendered_count and sync_state). | Keep only the analysed/proxies/verified/warnings states. | Main.html shows 'Status: not rendered', and the brief's saved-view example needs it. |
| 2026-10-06 | Rate and Tags… change only their own field from the current sidecar or index values (EditSequenceInfoAsync). | Write back the whole info from the Library's copy of the row. | The copy can be stale after an editor save or a settings sync; writing it back would undo those and bump the settings version. |
| 2026-10-06 | Quick actions show on hover, on selection and while the keyboard is in the card or row, so Tab reaches them. The selected card's details panel also offers Render. | Hover only. | Keyboard access (DESIGN §4); the editor's frame rows do the same. |
| 2026-10-06 | The Delete confirmation names at most 6 moves and 3 refusals (each with a '+ n more' line), in the UI font and reading direction (ConfirmRequest.IsDetailMonospaced=false). Fingerprints keep the mono, left-to-right detail. | A scrolling detail list. | It stays within a 768 px work area, and names are not fingerprints. |
| 2026-10-06 | Archive dialog templates and their reviewed styles live in one shared dictionary (Archive/ArchiveDialogs.xaml) merged by ArchiveView and LibraryView. | Duplicate the templates in LibraryView. | Delete, Move and Tags… run from both screens, and one copy keeps the Archive review's fixes in both. |
| 2026-10-06 | Delete, Restore, Rate and saved-view failures read as one localized sentence through ArchiveFailures.Cause. The engine's text goes to the log or the tooltip. | Show ex.Message in the toast. | BRIEF §0.2 rule 6, as the Archive manager's review established. |
| 2026-10-06 | The web admin gets a dark theme: DESIGN dark tokens via light-dark(), following the OS setting, with a header toggle remembered per browser | Keep light-only as DESIGN.md §1 and DECISIONS 2026-10-02 say | BRIEF §14.8 says 'light/dark' and the Admin.html mockup has the Switch theme button; CLAUDE.md: the brief wins over the notes, and the mockup wins on looks |
| 2026-10-06 | Tables are ARIA tables whose rows are CSS subgrids; fitColumns() measures the table and hides secondary columns level by level until the rows fit | The mockup's fixed tracks (… 210px) or fixed container-query breakpoints | Fixed widths cannot hold +40% translations (German row actions are about 330 px) or the side-panel state; measuring works for every language and width |
| 2026-10-06 | Self reset is blocked twice: the UI shows Change password on the caller's own row and the server answers 409 'self' | Hide the button in the UI only | A reset revokes every token, the caller's included, so any client could lock the last admin out; the existing 'self' code and message already guard delete and demote |
| 2026-10-06 | The sign-in log uses one audit query with a comma-separated action filter (AuditRepository.ListByActionsAsync) | Two client-side queries merged by time | A single cursor keeps 'Load more' paging correct |
| 2026-10-06 | plural() uses Intl.PluralRules folded to Titano.Core's categories (two→few; zero→many in Latvian, else other) | Port the C# PluralRules table to JavaScript | Same results as the desktop for the shipped languages with far less duplicated code |
| 2026-10-06 | Settings and archive validation messages are built in the panel from the field label (Admin.Common.Invalid), with a specific message for missing PEM files | Per-setting localized messages from the server (Server area resx) | The server's details already name the field; this keeps the change inside the panel and gives one sentence plus one action |
| 2026-10-06 | The settings Save button moved into the sticky page header, like New user on the Users page | Offset the toast stack above page actions | Toasts can never cover it, and it stays reachable while editing a long form |
| 2026-10-06 | Old single-form count keys stay in the catalogs unused, and new .one/.other keys were added | Rename or rewrite the existing keys | The rules forbid renaming or deleting keys; other cultures keep working until the integrator removes them |
| 2026-10-06 | Empty-state buttons: Clear search; Show all (filtered jobs); Scan (empty jobs, empty charts and format table); a Users link (no render nodes); Refresh (activity, audit) | Leave the sentences without a button | BRIEF §0.2.6 asks for one sentence plus one button; each one is the most useful next step |
| 2026-10-06 | Progress bars mirror in RTL (they fill from the reading start); charts keep a left-to-right axis; paths, templates, logs, IPs and fingerprints stay left to right | Mirror everything, or nothing | Follows the brief's RTL rules: time-axis charts and paths do not mirror, progress follows the reading direction |
| 2026-10-06 | The side panel width is clamp(300px, 26vw, 340px) | A fixed 340 px (mockup) or 320 px (DESIGN) | It keeps the mockup's 340 px at 1440 and gives the table about 28 px more at 1200 |
| 2026-10-06 | Mirror category charts by placing their contents with FromStart inside an element that stays FlowDirection=LeftToRight. This applies to horizontal BarChart rows (labels, bars, values, grid ticks) and StackedBar segments. | Let BarChart and StackedBar inherit RightToLeft so WPF mirrors the whole element. | With the element mirrored, text drawn by DrawText would come out mirrored, and every number label would need a counter-transform. FromStart is already how legends are placed, and the Arabic test's 'every DrawingElement is LTR' rule still holds. |
| 2026-10-06 | Vertical BarChart, HeatmapStrip, SeriesChart, TimelineBands, Filmstrip and CurveEditor stay left to right in RTL. | Mirror every chart that has categories. | The brief rule is that time axes stay LTR. Vertical bars and heatmaps run along days, years or months; horizontal bars and stacked shares have no time axis. |
| 2026-10-06 | Keyboard activation for BarChart, StackedBar and HeatmapStrip exists only while a handler is attached to the chart. Arrows move the item (heatmap in rows and columns, stacked bar by visual side), Home and End jump, Enter and Space activate. The item gets a 2 px Accent outline, a readout and the automation ItemStatus, and the element's system focus rectangle is off. | Gate only the hand cursor and leave the charts mouse-only. | A chart that does something on click but cannot be used from the keyboard fails WCAG 2.1.1. A chart nobody activates stays out of the tab order, as before. |
| 2026-10-06 | Detect handlers by recording the delegates added and removed through the CLR event accessors (TrackActivation). | Read the routed-event handler store by reflection, or add a public IsInteractive property. | The handler store is internal. Accessors cover XAML attributes and += in code. An extra property would duplicate what attaching the handler already says. |
| 2026-10-06 | Move the shared hover-readout, click, cursor and keyboard handling for item charts into DrawingElement as virtual item members (ItemCount, ItemAt, ItemBounds, ItemText, Navigate, Activate). | Copy the cursor and keyboard code into each of the three charts. | The three charts had the same mouse code; one implementation keeps cursor and keyboard behaviour consistent. Visuals without items (filmstrip, curve editor, series chart) are unaffected because the base does nothing when ItemCount is 0. |
| 2026-10-06 | The ListBox template is a keyed ControlTemplate (Template.ListBox). ListView is BasedOn a new template-less ListBox.Base, and the card grid style takes the template through DynamicResource. | Put the Template setter straight into the implicit ListBox style, which ListView was BasedOn. | ListView would then inherit a template without the GridView header row. Visuals.xaml cannot StaticResource into Controls.xaml. |
| 2026-10-06 | Empty heatmap cells use Brush.Stroke. | A new no-data token. | Stroke differs from the Card and Surface fills in both themes, the Archive workaround already used it, and DESIGN forbids new colours. |
| 2026-10-06 | SeriesChart tick labels and TimelineBands captions also move to TextMuted. | Change only BarChart and HeatmapStrip, as the item lists. | They are the same 11 px data labels, with the same AA failure (2.7:1 in light). Editor.html shows chart text in the muted colour. |
| 2026-10-06 | ShellViewModel.Notify takes an optional isError, and the Uploader's private ShowToast does the same. | A separate NotifyFailure method. | Some outcomes decide the flag at run time (format Failed versus Formatted, eject Ejected versus InUse or Failed, server job Failed versus Cancelled). One parameter handles those without branching at the call sites. |
| 2026-10-06 | Count as failures: refusals that leave the user's action undone (cache folder not owned, card changed before format, 'Choose a sequence first', conflict changed). Keep as notices: 'Nothing found', a cancelled server job and the editor's 'frames changed, read-only' toast. | Mark only exceptions as errors. | An assertive announcement fits anything the user asked for that did not happen. Empty results and cancellations the user asked for are not failures. |
| 2026-10-06 | Editor.Optimise.ChangeRtl copies the existing TimeRtl/RenderRtl pattern exactly ('{0}: {1} ← {2}', no bidi marks). | Put RLM marks around the arrow so values made of Latin letters keep their order. | The task fixed the value and the pattern. The Latin-run caveat applies to all three RTL keys and is reported as one remaining issue. |
| 2026-10-06 | TextBox.Number goes back to the default Padding. Import TextBox.Small (4,0) and the Import session-title box (8,0 at 26 px) stay compact. | Reset every override to the default. | The Number override (8,0) existed only to undo the old double padding. The other two are deliberately compact: four digits fit in 42 px, and 8 px plus the 2 px text margin lines up with the 26 px row buttons. |
| 2026-10-06 | Icon-only accessible names longer than three words (rail toggle, archive year expander) get new two-word keys. The sentence stays as the tooltip. | Keep binding the name to the tooltip. | The item asks for names of at most 3 words from a resource; the tooltip carries the explanation. |
| 2026-10-06 | The culture-switching optimise-line test lives in EditorSmokeTests ([Serial]), not EditorTextTests. | Keep it next to the other EditorText tests. | Test classes run in parallel, and switching Loc culture would race with English assertions in other classes. |
| 2026-10-06 | Fix the tests, not the sync engine: wait for the comparison an event starts to finish, signalled by SyncService.Changed, and assert on that settled state | Poll with a deadline until the final state holds (settings arrived AND error cleared), or make the engine's two writes atomic | The engine is correct: Changed is its documented end-of-comparison contract, and the Server screen reloads on it. Waiting for Changed is deterministic and keeps every assertion. A regression fails immediately, not after a 30 s timeout. It also checks that the state is consistent when Changed fires. Atomic writes are impossible across the index and project.json. |
| 2026-10-06 | KeepingProxiesOffline waits for the agent's own background download job to reach Done | Poll the row status until ProxiesOnly | Done is the engine's last write after the handler stored the cache and the link. Polling the status would turn the assertion into the wait condition. |
| 2026-10-06 | FailedComparisonsAreRetried waits for the agent's Changed raised with a non-null Snapshot (TaskCompletionSource with RunContinuationsAsynchronously) | Reorder the agent's writes so LastError is cleared before Snapshot is stored | Changed is the agent's contract, and SyncHost reads both values on it. Continuations must run off the agent loop, otherwise the test would end up disposing the agent from inside its own loop. |
| 2026-10-06 | Log download: reuse FileResponses.Serve (fixed-length, range-capable FileSlice) with the length listed at request time | Copy the log to a temp file first, or stream to EOF without a Content-Length | It reuses an existing facility, keeps Range resume working, has no extra I/O, and the response stays self-consistent while the logger keeps appending. |
| 2026-10-06 | The regression test fills its server's log with about 2 MB up front, then logs one line about every 1 ms through the server's FileLoggerProvider only, on a LongRunning thread | A tight logging loop through ILoggerFactory (my first two versions) | The engine log sink is process-wide, so a console or file-lock flood stalled another test's job engine. The throttled version still reproduces the bug in 10 of 10 runs against the old endpoint. |
| 2026-10-06 | Heartbeat test: count the claims the server answered with a DelegatingHandler, then wait for a later beat with a 30 s deadline | Keep the sleeps and widen the 400 ms window | It removes the timing assumption both ways (a false failure on a slow runner, and a false pass on the claim's own touch). It also proves no claim moved the beat. |
| 2026-10-11 | Fields of a meta line are joined with `Loc.Separator`: " · " in left-to-right languages, " · " between right-to-left marks in right-to-left ones (`Loc.SeparatorOf(culture)` for texts built in another language) | Unicode isolates (FSI/PDI) around each field, or a left-to-right island for every meta line | WPF's bidi predates the isolates; without a strong right-to-left character before it, a number after a Latin field ("Canon EOS R5 · 2 h") joins the Latin run (rule W7) and splits its own field; islands would read the fields in left-to-right order. |
| 2026-10-12 | Table cells holding a value with the language's unit (sizes, speeds, times left) follow the reading direction at the end of the cell, like their header, and size columns fit their content; bare numbers (percentages, counts) stay left-to-right islands, right-aligned | Every number cell left to right | Once sizes use the language's units, a left-to-right cell put the unit after the number on screen, so Arabic and Hebrew readers met the unit first ("18,6 كيلوبايت"), and the longer words were cut off. |
| 2026-10-12 | Fields shown in a left-to-right island are joined with `Loc.IslandSeparator` (" · " between left-to-right marks in right-to-left languages); charts format text with European digits | The reading-direction separator everywhere; the culture's digit substitution in charts | In the preview's frame data a localized time ends in a right-to-left mark ("6:03:41 م"), so the next field's number read as part of it and swapped places with the dot; with the UI culture, chart text after Arabic words drew Arabic-Indic digits while every text block shows European ones. |
| 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 | (Partly superseded by the deployment guidance row below: a proxy is listed by its own fixed address, never a Docker subnet or gateway; Docker's port publishing relays IPv6 clients and the host's own connections from the gateway.) 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 own fixed address. |
| 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 | (Superseded by the sign-in entry cleanup row below: a value is removed only when it starts a program the install log lists.) 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, only when they start a program the install log lists. This happens on uninstall, and on an upgrade that drops the program's component; an upgrade that renames the program moves the entry instead (see the sign-in entry move row below). | Every Run value under the folder (first version); the folder-scoped variant of fix/shell-notify | 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. |