# 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//[.].resx`, embedded into `Titano.Core` (satellite assemblies), base name `Titano.Core.i18n.`. Keys marked `invariant` 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 `/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. |