Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
9.5 KiB
Status
Phase plan: docs/BRIEF.md §22. Windows behaviour is verified on CI (windows-latest); everything else also on Linux.
| Phase | State |
|---|---|
| 0 Bootstrap | Done: solution, rules, Titano.Testing, zero-package guard, i18n, WPF shell, server skeleton, Docker, icons, CI. |
| 1 Metadata and imaging | Done: metadata parsers, managed codecs, native RAW development (DNG, CR2, NEF, ARW, PEF, RAF), WIC provider and codec inventory, decode tiers, thumbnails and proxies, diagnose. Real-camera fixtures wait for verified raw.pixls.us URLs (CI warns per missing sample). |
| 2 Data layer and archive | Done: SQLite binding, PostgreSQL wire client, migrations, repositories, job engine, archive layout, sidecars, scan, rebuild, verify, duplicates, orphans, adopt, mass rename. Gate measured: a 100,000-frame archive (400 sequences of 250 photos) rebuilds from sidecars into an index identical in every column in 1.8 s on SQLite and 4.7 s on PostgreSQL (budget 120 s). |
| 3 Library and Archive manager | Done: Library (virtualised grid and list, timeline with year bands, filters, saved views, quick actions, mass bar, Delete… into the archive's trash with a dry run, typed confirmation and Undo, cards for server-only sequences), Archive manager (tree, health, statistics charts, maintenance with Trash… and restore, verify, duplicates, orphans, adopt, mass rename and move with dry runs), Jobs, Settings, Welcome, Server and About. Gate measured on 500,000 photos: Library open 259 ms on SQLite and 181 ms on PostgreSQL on a new connection pool (warm OS cache; budget 1 s); every filter, search, sort and next page ≤ 6.4 ms (budget 200 ms). |
| 4 Card import | Done: device detection, card pool and camera profiles, plan with sessions (merge and split), hash-verified copy, post-actions (verified delete, format behind a typed confirmation, eject), auto-import, Archive, Folder and Server destinations. Gate: import from a simulated card folder end to end in tests; delete and format refuse any photo the import did not verify; screenshots on ci-screenshots. |
| 5 Analysis advisor | Done: light and deep analysis, reports and section charts, recommendations with localised reasons, sequence presets, Auto/manual controls and Optimise in the editor. Gate: golden recommendations for synthetic sequences; every reason key exists in en and it (i18n check); deep analysis streams with checkpoints and resumes after a restart. |
| 6 Engine, encoding, editor | Done: render pipeline, MP4/AVI/GIF/APNG/image sequences, Media Foundation H.264/HEVC/AV1 with managed fallbacks; the sequence editor (Frames, Exposure, Camera, Motion and Export tabs, preview tools, section charts, curve editor, undo/redo, batch export) for local and server sequences. Gate: self-test suite green; the in-house inspector validates the containers the tests write; the encoder in use is logged. Playback: MediaPlayer opens the Media Foundation output and a source reader decodes its first frame (Windows tests). The pixel diff of every --capture screen against tests/visual/baselines (screenshots diff, BRIEF §20.2) is wired into CI but not armed: no baseline is committed yet, so the step compares nothing and only warns until the first baselines are accepted from ci-screenshots (Next steps). |
| 7 Server, sync, uploader | Done: server (API, auth, uploads, jobs, render nodes, events, admin panel with light and dark themes, Windows service), Uploader, client sync (sync table, conflicts with Save both, proxies kept offline, metered pause), server sequences edited with proxies and rendered where the originals are, this PC as a render node. Gate covered in-process: a sequence uploaded from one PC downloads identically on another, interrupted uploads and downloads resume, server events update a PC, renders run on a node and on the server's managed fallback, jobs resume after a restart, sign-ins and administrative actions are audited. The run with two real PCs and the Uploader against the Docker server is part of the release test. |
| 8 Release readiness | Release pipeline end to end (installers, portable and server zips, SHA256SUMS, release notes, optional signing, multi-arch GHCR image, public releases repository content), update check with verified download, scrubbed diagnostics bundles (desktop and server), performance gates, 38 cultures (en, it and 36 machine translations with glossaries and independent reviews), RTL pass (ar, he: mirrored windows, left-to-right islands for media, charts, numbers and paths; any right-to-left culture added later follows), accessibility pass (names, live regions, keyboard paths for charts and the curve editor). CI installs the packed installers silently on a clean windows-latest runner, runs the installed programs, upgrades in place and uninstalls (files, Add/Remove Programs, shortcuts, file type, user data kept, exit codes). Pending: a tagged pre-release published from CI, the interactive install on a real PC, Unraid template validation on a real server. |
| 9 Monetization | Not started: requires explicit approval (§22). |
Verification (2026-10-12)
A full audit against the brief, CLAUDE.md, the UI kit, the tests and the Docker and client setups confirmed 71
defects with independent verifiers. A second pass over the fixes confirmed 37 more (proxies and decode tiers, project
positions crossing copies through sync, server scans and maintenance, desktop settings and polling, a portable copy
inside OneDrive, setup and deployment guidance), a third pass 16 more (editors open while photos arrive, partial
writers of the index row, image passes after another writer's import, smaller error-text and documentation gaps), a
fourth pass 7 more (lock order of index writes, analyses and scans racing another writer), a fifth pass 4 more (tag
lock order on PostgreSQL, the orphans fix's follow-up analyses, deep reports saved over newer ones, frames versions
shared by two indexes), and a last check 2 more (an unreadable photo counted as a change, a deep report made stale by
proxies). All are fixed, each with tests (rows dated 2026-10-12 in DECISIONS and CHANGELOG), except that the
screenshot diff (BRIEF §20.2 visual regression) gates nothing until its first baselines are committed (Next steps).
The Docker image was built and run with PostgreSQL 17, a fresh archive folder and remapped ports; the client
installers are installed, run, upgraded and removed on windows-latest by the installer CI job.
How to try it
dotnet build Titano.slnx -c Release
dotnet run --project src/Titano.Server # https://localhost:8443/admin (set TITANO_DATA_PATH/TITANO_ARCHIVE_PATH)
src/Titano.App/bin/Release/net10.0-windows/Titano.exe # Windows
src/Titano.Uploader/bin/Release/net10.0-windows/Titano.Uploader.exe # Windows
docker compose -f deploy/docker/docker-compose.yml up -d # server + PostgreSQL 17
TITANO_PERF=1 dotnet run --project tests/Titano.Data.Tests -c Release -- --filter category:perf --verbose # performance gates
src/Titano.App/bin/Release/net10.0-windows/Titano.exe --capture out/screenshots # every screen with sample data, plus Arabic (RTL)
- Diagnostics: Settings › Advanced › Diagnostics › Export bundle (desktop) or admin panel › Logs › Diagnostics (server,
GET /api/v1/server/diagnostics). Open the zip: logs, reports, settings and failed jobs, no passwords or tokens. - Update download: About › Check for updates, then Download when a newer release exists; the verified setup (the portable zip in a portable copy) appears in Explorer. Cancel stops it; the next Download resumes.
- Import: Import › Folder… (any folder of photos stands in for a card) › Import; the sequence opens from the Library. Delete a sequence with Delete… (dry run first) and bring it back from Archive › Trash….
- Sync: sign in on Server (trust the certificate once); the sync table lists every sequence of both sides. Open a server-only sequence from the Library to edit it with proxies; Render runs on the server or a render node.
- Language: Settings › General › Language switches at once; Arabic and Hebrew mirror every window.
- Settings: Import, Analysis and Formats pages; Archive rows edit the open archive's
archive.json; Advanced › Restore picks a daily backup, compares it with the index and restores it at the next start. - Project files: Export › Save project file writes a
.titanofile; opening it (double-click orTitano.exe <file>) opens the sequence with those settings in the running Titano. - Notifications: minimise Titano and insert a card or finish a job: a Windows notification appears; Ctrl+1…6 and Ctrl+, switch sections.
Next steps (Phase 8 gate)
- Arm the screenshot diff: from the
ci-screenshotscommit of the first greenwindows-latestrun at the current HEAD, rundotnet run --project src/Titano.Tools -- screenshots accept <dir>and commit the PNGs totests/visual/baselines(its README says how). From then on a visual change, or a screen without a baseline, fails CI. - Create the public repository (
<owner>/titano-releases), add theRELEASES_TOKENsecret, push av0.x.y-rc.1tag and check the release, the public repository content and the GHCR image (set it public once). - On Windows: install, upgrade over the previous version, uninstall (with and without user data), silent mode.
- Unraid: add the template repository, install with the official PostgreSQL template, reach the WebUI.
- Native-speaker review of the machine translations where users report wording (
i18n exportper language).