- Titano.Ui: DESIGN.md tokens (dark/light), generated 16-px icon set, styles for all standard controls, custom chrome window with snap layouts, rail, job bar, Auto/manual slider, chips, toasts. - Titano desktop shell with sections, Settings (language, theme), About and a --capture screenshot mode. - Titano Server skeleton: env/server.json configuration, self-signed TLS with fingerprint, /health, /server/info, i18n endpoint and the embedded admin panel; in-process server tests. - Docker image (multi-arch, PUID/PGID, health check), compose file, Unraid template; CI, release and nightly workflows; changelog tool. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
4.6 KiB
4.6 KiB
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. |