Files
Chronos/docs/DECISIONS.md
T
Claude 0a513fb213 fix(i18n): texts kept by view models follow a language switch; right-to-left meta lines keep their fields
A language switch re-read computed properties only: the job bar of a running job,
the Jobs rows, the editor's chart legends and summaries, Auto chips, markers and
info line, the Archive figures and the Import session table kept the old language
until their next change. LocalizedViewModel gains OnLanguageChanged, where each of
them makes those texts again.

Meta lines joined their fields with a plain " · ": in Arabic or Hebrew a number
after a Latin field ("Canon EOS R5 · 2 h") joined the Latin run and split its own
field. Loc.Separator puts right-to-left marks around the dot in right-to-left
languages and is used for every such line. Desktop file sizes use the Common.Size
formats, as the Setup and the Uploader do.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
2026-10-11 23:47:03 +00:00

76 KiB
Raw Blame History

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 · ', 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: /.titano/trash/[-stamp] plus a .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.) 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-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.