docs(decisions): processing, sync and release choices

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
This commit is contained in:
Claude committed 2026-10-03 10:39:36 +00:00
1 parent dd52dba479
commit 7fddd4b038
1 file changed
+18
+18
View File
@@ -125,3 +125,21 @@ One line per decision: date · decision · alternative · reason.
| 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, not in the Library. | 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. |