docs: record owner review 1 phase 4
CI / Build and test (pull_request) Successful in 8m36s
CI / Windows tests and installer (pull_request) Skipped
CI / YAML check (pull_request) Successful in 18s
CI / PostgreSQL 16 integration (pull_request) Successful in 10m13s
CI / PostgreSQL 17 integration (pull_request) Successful in 11m34s
CI / Docker image (pull_request) Successful in 3m57s

BRIEF, DECISIONS, CHANGELOG, STATUS, ARCHITECTURE and the request files now
describe the visual crop locked to the output, rotate, mirror, flip and
straighten, the colour looks and "proportions win" as built and reviewed.
The CHANGELOG carries the upgrade note (existing projects at a chosen aspect
change output size, settings format 2 opens read-only in older builds,
servers and nodes announce the settings format they read), and the 5c
entries move under rc.11. DESIGN and the Editor mockup put Reset framing on
its own line, as the panel has it.

Refs #19
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Alby96 committed 2026-11-05 00:27:07 +01:00
1 parent abf8bc93c4
commit af868c2175
10 files changed
+229 -51

No files matched your search

+20 -9
View File
@@ -29,16 +29,16 @@ Dependencies point one way: `Core` ← `Core.Windows`, `Data`, `Protocol` ← `S
| Folder / namespace | Content |
|---|---|
| `Imaging` (+ `Decoders`, `Geometry`, `Thumbnails`) | `ImageBuffer` (planar float, linear light), `IImageDecoderProvider` (`DevelopsRawAt8Bits`: true for WIC's Raw Image Extension, which a conversion's 16-bit targets never read RAWs through), `DecoderFactory` (decode tiers: native → embedded preview; `ImageDecoder.Probe` names a file's tier without decoding it; `DecodeRequest.PreferPreview` takes an adequate RAW preview by choice for analyses and previews, `DecodedImage.ByChoice`), `ManagedDecoderProvider` (`ReadsHeaders`: a conversion's probes read JPEG, PNG and TIFF headers and refuse what the decoders would), `FrameWindow` (read-ahead, memory budget, float32 spill), resampler, thumbnail cache |
| `Imaging` (+ `Decoders`, `Geometry`, `Thumbnails`) | `ImageBuffer` (planar float, linear light), `IImageDecoderProvider` (`DevelopsRawAt8Bits`: true for WIC's Raw Image Extension, which a conversion's 16-bit targets never read RAWs through), `DecoderFactory` (decode tiers: native → embedded preview; `ImageDecoder.Probe` names a file's tier without decoding it; `DecodeRequest.PreferPreview` takes an adequate RAW preview by choice for analyses and previews, `DecodedImage.ByChoice`), `ManagedDecoderProvider` (`ReadsHeaders`: a conversion's probes read JPEG, PNG and TIFF headers and refuse what the decoders would), `FrameWindow` (read-ahead, memory budget, float32 spill), resampler, thumbnail cache; `Geometry` (owner review 1, phase 4): `FrameOrientation` (a camera's quarter turns, mirror, flip and straighten as exact integer turn and mirror matrices and the straighten about the view's centre, the view size W'×H', `CoverZoomOf`), `CropFrame` (the aspect-locked box in the view frame: `Of`, `ToCrop` on the 12-decimal `Grid`, `Locked`, `Clamp`, `Move`, `ResizeFrom` a handle, `Refit`, `ToRows`/`FromRows` for Crop size/X/Y, `Largest`), `OrientationEdit` (one press of Rotate left/right, Mirror or Flip applied to a project: crop, offsets, keyframe and pending-keyframe centres, roll and straighten remapped, the aspect text transposed); `Color/LookFilter` (the eight built-in looks: `Names`, `IsKnown`, the vectorised `Apply` on linear light and its scalar reference) |
| `Metadata` (+ `Tiff`, `Jpeg`, `Bmff`, `Raf`, `Riff`, `Png`, `Xmp`, `MakerNotes`) | Signature sniffing, Exif/GPS/XMP/MakerNotes, ISO-BMFF (HEIF, CR3), `MetadataReader`, `MetadataBuilder` (all fallback chains), `ExifWriter` (proxies, exports and converted photos; exposure program, metering mode, flash and white balance when known) |
| `Codecs` (`Jpeg`, `Png`, `Tiff`, `Dng`, `Raw`, `Gif`, `Apng`, `Ico`, `Icc`) | Pure managed codecs; native RAW development (DNG, CR2, NEF, ARW, PEF, RAF); header reads that refuse what a decode would (`JpegDecoder.ReadDecodableInfo`, `PngDecoder.MaxPixels`, `TiffImageReader.ReadInfo`; the TIFF reader refuses CMYK, CIELab, palette and other samples it does not render); ICC profiles written into JPEG (APP2) and TIFF (tag 34675); `LinearDngWriter` (exports: clipped linear sRGB; `LinearDngOptions.SceneReferred` for a conversion: linear ProPhoto primaries, up to `MaxHeadroomStops` (4) of headroom in BaselineExposure, matrices that read back as written); `Icc` (`IccProfile`: ICC parser and writer, matrix/TRC and gray curves, sRGB told by the numbers (by the name only without colorant tags), `IsSrgbFor` (the values a DNG takes), `WithSrgbCurve` and `GrayAsRgb` (the profiles a conversion makes), colorants that convert nothing dropped, the in-house Adobe RGB (1998)-compatible and Display P3 profiles; `SourceColor`: the colour space a photo's headers record and whether its samples are linear) |
| `Analysis` (+ `Deep`) | Luminance statistics, deflicker, regions, holy grail, white balance, colour temperature, light analysis, streaming deep analysis with checkpoints |
| `Advice` | `Advisor`: recommendations with localisable reasons, apply/optimise, sequence presets |
| `Motion` | FFT, phase correlation, pyramids, optical flow, motion blur, stabiliser, virtual camera, interpolation, stacking |
| `Math` (namespace `Chronos.Core.Mathematics`) | Splines, LOWESS, statistics, solar position, 3×3 colour matrices |
| `Project` | `ProjectSettings` (Auto/manual values; members a newer Chronos wrote kept in `Extra` and written back; one of a newer settings format read with `FromJson(json, allowNewer: true)`, `IsNewerFormat`: read-only), export presets, `ProjectBundle` (the `.chronos` project file: sequence reference and settings; format 2 adds the `workspace` section of a workspace's working state: project, name, Main, home, base version, media; a file without it is still written as format 1), `ProjectContent` (the portable form of project versions: every frame position parked by photo with `TranslateFramePositions`, placed back on any copy's frames; canonical text, content hash = SHA-256 of its UTF-8 bytes; `Rebind`/`SameChoices` name each parked photo as the frames hold it now, so a photo hashed or converted since is no change of the choices), `FramePhotos` (the photos of one copy's frames; a photo named by an encoding a conversion replaced, or its undo, is found through `PhotoAlias` links) |
| `Render` | Render plan (timing modes), preparation pass, geometry, `RenderPipeline`, self-test suite |
| `Export` | Preset resolution, encoder selection with fallbacks, output naming |
| `Project` | `ProjectSettings` (Auto/manual values; members a newer Chronos wrote kept in `Extra` and written back; one of a newer settings format read with `FromJson(json, allowNewer: true)`, `IsNewerFormat`: read-only; `CurrentVersion` 2 is the highest format read, `RequiredFormat` 2 only while a turn, mirror, flip, straighten or look is set, `WrittenFormat` what `ToJson`, the one serialiser, stamps; `CameraSettings.Rotate/Mirror/Flip/Straighten`, `LookSettings`), export presets, `ProjectBundle` (the `.chronos` project file: sequence reference and settings; format 2 adds the `workspace` section of a workspace's working state: project, name, Main, home, base version, media; a file without it is still written as format 1), `ProjectContent` (the portable form of project versions: every frame position parked by photo with `TranslateFramePositions`, placed back on any copy's frames; canonical text, content hash = SHA-256 of its UTF-8 bytes; `Rebind`/`SameChoices` name each parked photo as the frames hold it now, so a photo hashed or converted since is no change of the choices), `FramePhotos` (the photos of one copy's frames; a photo named by an encoding a conversion replaced, or its undo, is found through `PhotoAlias` links) |
| `Render` | Render plan (timing modes), preparation pass, geometry (`RenderGeometry`: the one warp stabilisation⁻¹ · orientation⁻¹ · virtual camera, the crop in the view frame, and for the preview `ViewFor`, `ViewToFrame`, `EditableCrop`, `FootprintInView`), `RenderSize` (the output size: a fixed preset's box adapted to the chosen aspect, "source" keeping it; `Adapt`, `ViewSize`), `RenderRules.RequiredFormat` (the settings format a render needs: the written one, or 2 when the adapted size differs from the preset's; never stored), `FrameFinish` (look, then knee, once per output frame: the render, the server, nodes and the preview call it), `RenderPipeline`, self-test suite (`proc.orient`, `proc.straighten`, `proc.portrait`, `proc.look`) |
| `Export` | Preset resolution, encoder selection with fallbacks (`EncoderSelector.Takes`: limits read as long edge × short edge), output naming |
| `Video` (+ `Mp4`, `Avi`, `Bitstream`, `Yuv`, `Managed`) | `IVideoEncoderProvider`, MP4 muxer and inspector, AVI-MJPEG, NV12/P010, managed encoders (MJPEG-AVI, GIF, APNG, image sequences) |
| `Archiving` | Archive layout and paths (a sequence's projects: `.chronos/projects/<id>/project.json` and `versions/000001-<id>.json`, deleted ones in `projects/.trash`), sidecars (`sequence.json`, `project.json`), scanner, index snapshot, leases, thumbnail packs, verify, adopt, rename plans (`RenamePlanner`: folder, title and file templates, `RenameTemplates`, the plan's fingerprint, which pins every file rename by its digest and not the frames version; `FileRenames`: a sequence's new file names; `FileRenameJournal`: two-phase renames through temporary names, `.chronos/rename-files.json`, a recovery safe to run again from wherever it stopped, a new name taken meanwhile sending that photo and its companions back together to their old names or a free `_2`, those that took their new names already with them; `FrameCompanions`: the XMP files that follow a photo, one rule for the trash and Reorganize, matched whatever their case and each folder listed once by `FrameCompanions.Index`) |
| `Import` | Card scan, session detection, import plan (photos named through `FrameNaming` with the camera and lens of their session's first photo), hash-verified copy, card eraser (re-hash before delete) |
@@ -60,8 +60,8 @@ Dependencies point one way: `Core` ← `Core.Windows`, `Data`, `Protocol` ← `S
| `Scheduling` | `Scheduler` (one per host: seeds the host's system schedules, claims due runs by compare-and-set, catch-up, clock changes, create/edit/reset/delete/run now as API v1 DTOs), `ScheduleRecurrence` (the in-house `every:`/`daily:`/`weekly:`/`monthly:` form, wall-clock times across DST), `ScheduleActions` (action names, parameters, availability, the archive jobs a run queues), `IScheduleHost` and `SystemSchedule` (what the server and the desktop supply), `ScheduleOutcome`, `ScheduleMapping` (model ↔ DTO) |
| `Housekeeping` | `BackupJobHandler`, `CleanupJobHandler`, `ICleanupStep` with the shared steps (`CleanupSteps`: job history, audit log, trash report that never deletes); hosts add their own steps through `ArchiveServiceOptions.CleanupSteps` |
| `Archiving` | `ArchiveService` (create/adopt/open, archive settings written to `archive.json` then the index, `ArchiveSettings.CheckTemplates` and `TemplateRuleException` holding a template given anew to the template rules; `UnderLeaseAsync`: a write under a sequence's lease with its row read under it; `EditSettingsAsync`: settings an index edit writes, written to `project.json` under the lease first and put back when the index does not take them), `ArchiveIndexer` (scan, rebuild; a sequence found in another folder takes its exports' paths along; a full scan or a rebuild takes the projects' sidecars back too), `ArchiveIngest` (uploads and imports, named through `FrameNaming`; content a conversion replaced is a duplicate of the frame holding its conversion; a restore or a replacement not settled yet refuses the batch), `ImportService`, `ArchiveVerifier`, `ArchiveImages` (thumbnail and proxy passes, several photos at once through `OrderedWork`, which hands results back in frame order), `FrameTiers` (decode tier, `PreviewOnly`/`Undecodable` flags and preview size of frames, written to sidecar and index by the light analysis, deep analysis, renders and image passes), `GprCompanions` (the JPEG of each GoPro GPR, found in the index when an import kept it in another sequence), `ArchiveMaintenance` (also a conversion job's staging and journals, by the job's state; those of a job this index does not know go together, by age), `MassRenamer` (mass rename and Reorganize: the dry run reads each sidecar for a file template; each step checked under its leases before anything of it moves (where its sequences are, what is inside and at its new folder, a sidecar of a newer format, the title it was planned from when it changes it or names the folder or files after it), then the folder, with the sequences of the plan an earlier step left as they were inside it (taken along, their title and file names kept), every index row (the frame paths and render paths of the exports inside it, a file or an image-sequence folder, its own unless the export is still at the old place and another sequence's when it moved with it, follow it in one transaction; a sidecar that cannot be read or written then still has its row follow, and fails the step), then the files under the plan's journal in `journal/` (a sequence whose photos changed since, such as one still receiving them, or whose files are found changed or in use or have their new names taken keeps its file names, the renames being pinned by digest, and the step and the plan go on); the journal keeps the tally of the whole plan, and a plan its job held (paused, cancelled or failed) is left to that job, only its half-done file renames completed at an archive open, which completes any other plan an interruption left and tells each sequence changed; the file renames of a step: sidecar, a sequence whose sidecar cannot be read staying as it is with every folder around it, index (`FrameRepository.RenameFilesAsync`) and the sequence's journal), `SequenceFolders` (`Holds`: the folder the index has for a sequence is there and its sidecar names no other sequence; every writer into a sequence's folder asks it), `SequenceTrash` (delete into the archive's hidden trash with a dry run, restore; the folder moves back when the index step fails; lists sequence and photo entries; `SequenceTrash.Empty`: the emptying's dry run, fingerprint and erase, each entry checked against its fingerprint again under its lease, `TrashKept` with its `TrashKeptReason` for each entry kept; `SequenceTrash.Replaced`: where a replaced entry's conversions are, read from the archive's sidecars (in the index's or the entry's folder, in the trash, else by one `SidecarWalk` of the archive per dry run or emptying) through their replaced tombstones, a conversion deleted only on the archive's word (a tombstone, the trash, or an `ErasureRecord` in `trash/.erased/`, written when an emptying erases a deleted sequence a replaced entry still needs), `TrashEntry.ConversionDeleted` in the dry run and its fingerprint, the erase weighed under the entry's and the sequence's leases once the sequence is settled; `BusyAsync`: what running and paused jobs hold, but the job asking, from `JobRepository.ListHoldsAsync`), `FrameTrash` (photos of a sequence into `trash/photos` with a dry run, a journal that undoes an interrupted deletion whose entry stays unlisted until its sidecar is written, tombstones (a photo never hashed is hashed as it goes; one whose original is missing goes without a file or tombstone; a frame that stays and may be a twin is hashed, its hash kept), positions parked and placed back, proxies and thumbnails moved to follow their frames; `FrameTrash.Restore`: restore re-hashes each file and says why each kept photo stayed (`KeptReason`), under a journal of its own into the sequence that another writer settles only under the entry's lease, into a new sequence through the ingest when theirs is gone, each original staged inside its oLine truncated
| `Processing` | `ProcessingService`, `SequenceAnalyser`, `DeepReports` (a saved deep report while it still describes the frames), `SequenceRender`, `ProjectStore`, `ProjectBundles` (a `.chronos` file for a sequence, and the sequence a file names), `RenderNodeClient`, job handlers |
| `Projects` | `ProjectService` (`ArchiveService.Projects`: the projects of this PC's sequences as a home, under the sequence's lease and only in a folder that holds the sequence (`SequenceFolders.Holds`; otherwise `SequenceFolderMovedException`: reads answer from the index, writes are refused); reads wait 3 s for the lease, then answer from the index; a read-only archive is read without writing (an index-only Main written back once it takes writes): list, create, rename, delete (the folder into `projects/.trash` first, then the deleted record; never Main), history, head (NotFound once deleted), `StoredAsync` (a version file read back and checked), push with fast-forward / idempotent repeat / divergence / hash, portability, strict format and 64 MiB checks; each call first catches up: the sidecars into the index, Main made from the sequence's settings, settings another path wrote appended to Main as an `external` version or, with a push whose mirror was cut short, merged into one `merge` version where they win, a mirror never written over `project.json` settings it has not taken in (`MovedSharedAsync`), records behind the index healed (`HealAsync`, `UpdatedAfter`), projects the archive lost written back (`WriteBackAsync`); a push to Main mirrored into `project.json` and the settings with the settings version check), `ProjectIndexer` (the reconcile, also run by full scans and rebuilds: the projects' trash read before the live folders, so a deletion wins and the live folder's late version files move beside it; a record that cannot be read held back, never taken for a deletion; a lost record written again from the index only once its folder settled (`RecordSettle`, 2 minutes) and no trash folder holds it back (`TrashRecordGrace`, 1 day); a creation cut before its record left as it is; a version file a push left past its record adopted, a stray one moved to `versions/.stray`; `BehindAsync`, one rule for a record behind the index; `SettleMainAsync` and `SwapMainAsync`, one Main from the records, passed in one transaction), `ProjectSidecars` (record and immutable version files, the settings as a JSON string checked against their hash, `MaxVersionBytes` 64 MiB refused before writing), `ProjectMerge` (three-way merge member by member, pending frames merged photo by photo, conflicts, `Replay` of local commits on a moved head; `NewerSettingsException` rather than merge a newer format), `IProjectHome` and `ArchiveProjectHome` (the home a workspace pushes to and pulls from: `HoldsAsync` reads a version back, `FramesStampAsync` says when the frames changed, an offline archive or busy lease is `HomeUnavailableException`), `ServerProjectHome` (phase 5b: a server sequence's `/projects` over `ChronosClient`; a server out of reach, an expired sign-in, a 503 lease, offline archive or `projects_unreadable`, a 409 `folder_in_use` and a server without the projects are `HomeUnavailableException`, a 404 `sequence`/`project`/`version` and a refused name `ProjectException` (a deleted project's head is 404 `project`), a 422 `too_large` the `TooLarge` outcome, other refusals keep their `ChronosApiException`; `HoldsAsync` reads the version back (`?stored=true`), `FramesStampAsync` from `…/frames/stamp`, version pages read on past a page the server ended early, a 413 the `TooLarge` outcome; its sequences name an archive id made from the server's key), `HomePhotos` (a sequence's photos as positions name them, with the encodings its Replaced tombstones join; the server's frames endpoint and render nodes build the same), what each call changed (`ProjectChangeSet` to `ArchiveServiceOptions.ProjectsChanged`, once the lease is let go: projects made, renamed, deleted or with a new head, compared before and after under the lease, and whether Main's head was written into the sequence's settings), `CatchUpAsync` (the catch-up alone, saying why it cannot run), `ProjectWire` (projects, versions, push outcomes and a home's frames to and from API v1 DTOs, for the server and a client of it) |
| `Processing` | `ProcessingService`, `SequenceAnalyser`, `DeepReports` (a saved deep report while it still describes the frames), `SequenceRender`, `ProjectStore` (a newer format refused as `Errors.Render.NewerSettings`), `ProjectBundles` (a `.chronos` file for a sequence, and the sequence a file names), `ProcessingJobs` (`Routed`: a render job sized from its resolved preset box through `RenderSize` and given its `RequiredSettingsFormat`; `RequiredFormat` over a batch's presets, used by the desktop's gates), `RenderNodeClient` (registers the node's settings format), job handlers |
| `Projects` | `ProjectService` (`ArchiveService.Projects`: the projects of this PC's sequences as a home, under the sequence's lease and only in a folder that holds the sequence (`SequenceFolders.Holds`; otherwise `SequenceFolderMovedException`: reads answer from the index, writes are refused); reads wait 3 s for the lease, then answer from the index; a read-only archive is read without writing (an index-only Main written back once it takes writes): list, create, rename, delete (the folder into `projects/.trash` first, then the deleted record; never Main), history, head (NotFound once deleted), `StoredAsync` (a version file read back and checked), push with fast-forward / idempotent repeat / divergence / hash, portability, strict format and 64 MiB checks; each call first catches up: the sidecars into the index, Main made from the sequence's settings, settings another path wrote appended to Main as an `external` version or, with a push whose mirror was cut short, merged into one `merge` version where they win, a mirror never written over `project.json` settings it has not taken in (`MovedSharedAsync`), records behind the index healed (`HealAsync`, `UpdatedAfter`), projects the archive lost written back (`WriteBackAsync`); a push to Main mirrored into `project.json` and the settings with the settings version check), `ProjectIndexer` (the reconcile, also run by full scans and rebuilds: the projects' trash read before the live folders, so a deletion wins and the live folder's late version files move beside it; a record that cannot be read held back, never taken for a deletion; a lost record written again from the index only once its folder settled (`RecordSettle`, 2 minutes) and no trash folder holds it back (`TrashRecordGrace`, 1 day); a creation cut before its record left as it is; a version file a push left past its record adopted, a stray one moved to `versions/.stray`; `BehindAsync`, one rule for a record behind the index; `SettleMainAsync` and `SwapMainAsync`, one Main from the records, passed in one transaction), `ProjectSidecars` (record and immutable version files, the settings as a JSON string checked against their hash, `MaxVersionBytes` 64 MiB refused before writing), `ProjectMerge` (three-way merge member by member, pending frames merged photo by photo, conflicts, `Replay` of local commits on a moved head; `NewerSettingsException` rather than merge a newer format; `OneFraming`: a turn or mirror on one side and a framing edit on the other are one conflict at the orientation member), `IProjectHome` and `ArchiveProjectHome` (the home a workspace pushes to and pulls from: `HoldsAsync` reads a version back, `FramesStampAsync` says when the frames changed, an offline archive or busy lease is `HomeUnavailableException`), `ServerProjectHome` (phase 5b: a server sequence's `/projects` over `ChronosClient`; a server out of reach, an expired sign-in, a 503 lease, offline archive or `projects_unreadable`, a 409 `folder_in_use` and a server without the projects are `HomeUnavailableException`, a 404 `sequence`/`project`/`version` and a refused name `ProjectException` (a deleted project's head is 404 `project`), a 422 `too_large` the `TooLarge` outcome, other refusals keep their `ChronosApiException`; `HoldsAsync` reads the version back (`?stored=true`), `FramesStampAsync` from `…/frames/stamp`, version pages read on past a page the server ended early, a 413 the `TooLarge` outcome; its sequences name an archive id made from the server's key), `HomePhotos` (a sequence's photos as positions name them, with the encodings its Replaced tombstones join; the server's frames endpoint and render nodes build the same), what each call changed (`ProjectChangeSet` to `ArchiveServiceOptions.ProjectsChanged`, once the lease is let go: projects made, renamed, deleted or with a new head, compared before and after under the lease, and whether Main's head was written into the sequence's settings), `CatchUpAsync` (the catch-up alone, saying why it cannot run), `ProjectWire` (projects, versions, push outcomes and a home's frames to and from API v1 DTOs, for the server and a client of it) |
| `Workspaces` | `WorkspaceStore` (a folder outside the library: `workspace.json` written atomically, one folder per project, no index; a leftover folder holding only stale lease files removed on listing), `WorkspaceProject` (`project.chronos` working state, `media/` with `media.json`, `proxies/<frame id>.jpg` (and `<frame id>-<sha16>.jpg` while a copy replaces one) and `analysis.json`, `versions/` with `.replaced` (versions set aside, pruned by age and count) and `.replaced.since`, `sync.json` for a conflict, a restore or the journal of a replay or a Save both, `exports/`, the lease `.lock.lease`; `UnreadableVersions`), `WorkspaceMedia` (`NamedAsAt`: the media learn the home's hashes and aliases), `WorkspaceSync` (checkout, open under the lease, save, commit, push, pull with replay and merge, the base in `project.chronos` as every write's commit point, `SettleAsync` finishing or undoing a cut push, replay or Save both, conflicts settled by keep mine, take server or save both only as shown, restore, status with Gone, Damaged and `MediaOutdated`, the home's frames read again only when their stamp moved; `FollowNameAsync`: the home's name and Main written into the copy at every pull and at a server's `renamed`), `WorkspaceCopyJobHandler` (`WorkspaceJobs.Copy` and `CopyFactsAsync`, registered by the desktop only: the archive only read, from a folder that holds the sequence; a workspace inside a library refused; the archive's current proxies copied, the others made in the workspace, each hash-verified, resumable from a checkpoint of its frames version and folder, free space checked against its estimate plus 512 MiB; the encodings conversions joined kept in `media.json`; the working state's positions moved by frame where frames stay, by photo where they came or went; a cancelled first copy's media cleared under the project's lease only when no other copy of the project waits or runs, through `ICancelledJobHandler` too; a project whose home is a server, `WorkspaceJobs.CopyFromServer`, phase 5b: downloaded through the desktop's session (`ISyncConnector`), never through this PC's archive, the frames of one frames version with the aliases of the server's conversions, each proxy (else the thumbnail standing in, `WorkspaceFrame.FileKind`) hashed as it arrives and checked on the disk, four at a time, the editor's current file never overwritten, resumable from the same checkpoint, a `<file>.thumb` marker beside a thumbnail standing in until the commit, free space checked against the server's proxy sizes); phase 5c: `WorkspaceProject` gains `media/originals/<frame id>-<sha8><ext>` (`OriginalName`), the ledger `exports/renders.json` (`WorkspaceRenders`, `WorkspaceRenderEntry`; `ContainedExportFile` keeps every ledger path inside `exports/`), `media.json` format 2 while it holds originals or was cleaned (`WorkspaceMedia.Cleaned`) and the project file format 3 while its media are Originals; `WorkspaceOriginals` (Proxies only's plan and apply, and `ClearOriginals`: every file of `media/originals` hashed and deleted only when the home's frames hold its SHA-256, the rest moved to the trash), `WorkspaceTrash` and `WorkspaceTrashBuilder` (`<workspace>/.trash`: entries `<project id>-<ticks>` filled under `.incoming-<id>-<ticks>` and renamed when whole, listed with a fingerprint of every file's path, size and time, emptied only by a plan that still matches), `WorkspaceCleaner` (the clean-up of media of projects in step with their home: Clean after, Size limit, the reasons a project is kept in `WorkspaceKeep`, `UnsentRenders`), `WorkspaceMover` (survey, plan fingerprint, the journal `<from>/.move.json` with stages Moving and Switched, rename on one volume or copy and hash-verify across volumes, resume, abandon, clear after the switch), `WorkspaceJobRoots` (internal, in `WorkspaceJobs.cs`: the folder a copy, render or send works in, the one that holds its project now, refused while a move has not switched) and the job parameters `WorkspaceRenderParameters`, `WorkspaceSendParameters`, `WorkspaceMoveParameters` in `WorkspaceJson` |
| `Sync` | `SyncService` (sync table of one server: compare, link by content through the aliases, settle conflicts, enqueue transfers), `SyncRules` (status, settings merge and differences, the proxies this PC can send, aliases followed; no I/O), `SyncTombstones` (photos either side removed are not offered back; the replaced tombstones of both sides join the encodings of one photo, union-find, each compared as the smallest SHA-256 among them, a deletion covering them all; immutable once made), `SyncPositions` (the settings' frame positions translated by photo to the frames of the copy they go to), `SyncLinkStore` (`sync_links`, `sync_state`), `SyncTransfers` and `SyncJobHandler` (resumable, hash-verified uploads and downloads as jobs; downloads commit through the archive ingest, and a frame missing here whose photo the server holds in another encoding takes that file through `FrameTrash.ReplaceMissingAsync`; job log lines from the catalog), `SyncAgent` (background comparison, server events, backoff, offline proxies; a server's `projectChanged` passed on as `ProjectChanged`, and null after a lost event stream once the stream is open again and a comparison made after that reached the server: `ISyncRemote.EventsAsync(connected, ct)`), `ProxyCache` and `RemoteSequence` (server sequences opened with proxies), `ISyncRemote` (the server calls; `ChronosSyncRemote` over `ChronosClient`) |
@@ -72,7 +72,7 @@ Dependencies point one way: `Core` ← `Core.Windows`, `Data`, `Protocol` ← `S
| `Shell` | `MainWindow` (rail and its shortcuts, taskbar progress), `ShellViewModel` (rail, sections, first run), `OsNotifications` (toasts as Windows notifications while the window is minimised or in the background), dialogs, `ErrorText` (the sentence of an error toast), `ScreenCapture` (`--capture` scenes), `SectionTemplates.xaml` (view model → view) |
| `Sections` | One `XxxView.xaml` + `XxxViewModel` per screen: Welcome, Library, Sequence (the Edit section: the editor, `SequencePickerView` choosing in place a project of the workspace or a sequence of the library, the in-window dialogs of the workspace, and the opening of this PC's sequences as workspace projects: the project opened last, else "Open in workspace", the checkout and the copy job followed until it opens), Import, Archive, Jobs (two tabs, Queue and Scheduled: `SchedulesView` shows `Jobs/SchedulesViewModel`), Server, Settings (its last page is About) |
| `Library` | Filter, facets, pager, timeline, saved views, quick and mass actions (`MassActions`: Reorganize and Convert for the sequences of one archive), remote cards and thumbnails, thumbnail cache, list export |
| `Editor` | `EditorSession` (project, undo/redo, saving, merges through `Data/Projects/ProjectMerge`), `ISequenceSource` (`LocalSequenceSource`, `RemoteSequenceSource`, `WorkspaceSequenceSource`: a workspace project over its media, the working state saved in `project.chronos` under the project's lease and merged photo by photo in the portable form (`Merge`, a setting both sides changed asked through `ProjectConflictException`), `ReadOnlyChanged` for a project of a newer Chronos, an unstored edit kept aside in `versions/.replaced` (`SetAsideAsync`), renders at the home with the portable settings through `IProjectRenders`, naming a version only while none waits to be sent; a server home's analyses and renders are the server's jobs over `WorkspaceServerHome(connect, session)`, which connects again when the sign-in changes, a render naming the version the server holds when the project is in step with it), `ServerJobs` (a server sequence's analyses and renders followed through its events, shared by `RemoteSequenceSource` and a server home's `WorkspaceSequenceSource`), the steps of the Edit path (`EditPath`: their order, each step's state, the step of each finding, the memory of the step shown; tabs Analysis, Frames, Exposure, Motion, Camera, Time, Stack, Export), `PreviewRenderer`, `ExportPlanner`, `ExportSync`, `SavedCopies`, `SequenceJobs`, `ProjectFiles` (save and open `.chronos` project files: format 2 opens its workspace project, format 1 gives its settings to Main) |
| `Editor` | `EditorSession` (project, undo/redo, saving, merges through `Data/Projects/ProjectMerge`), `ISequenceSource` (`LocalSequenceSource`, `RemoteSequenceSource`, `WorkspaceSequenceSource`: a workspace project over its media, the working state saved in `project.chronos` under the project's lease and merged photo by photo in the portable form (`Merge`, a setting both sides changed asked through `ProjectConflictException`), `ReadOnlyChanged` for a project of a newer Chronos, an unstored edit kept aside in `versions/.replaced` (`SetAsideAsync`), renders at the home with the portable settings through `IProjectRenders`, naming a version only while none waits to be sent; a server home's analyses and renders are the server's jobs over `WorkspaceServerHome(connect, session)`, which connects again when the sign-in changes, a render naming the version the server holds when the project is in step with it), `ServerJobs` (a server sequence's analyses and renders followed through its events, shared by `RemoteSequenceSource` and a server home's `WorkspaceSequenceSource`), the steps of the Edit path (`EditPath`: their order, each step's state, the step of each finding, the memory of the step shown; tabs Analysis, Frames, Exposure, Motion, Camera, Time, Stack, Export), the step rows (`CameraTab`: Aspect, Rotation, Mirror, Flip, Straighten, Crop size/X/Y and Reset framing through `EditorSession.Orient` and `ResetFraming`, the crop kept locked by `EditorSession.KeepCropLocked`; `ExposureTab`'s Look group; `ExportTab`'s Output size; `SettingRows`: `SwitchRow`, `IconActionsRow`, `GroupRow`; `SliderActivity`, the Straighten slider showing the grid), `CropCommit` (a finished crop drag on the preview to `EditorViewModel.CommitCropCommand`, one undo step), `PreviewRenderer` (Source framing in the view frame through `RenderGeometry.ViewFor`, the mask from `EditableCrop` or `FootprintInView`, `FrameFinish` on the corrected picture only, motion vectors without it), `ExportPlanner`, `ExportSync`, `SavedCopies`, `SequenceJobs`, `ProjectFiles` (save and open `.chronos` project files: format 2 opens its workspace project, format 1 gives its settings to Main) |
| `Workspace` | Owner review 2, R8: `WorkspaceHost` (the desktop's `WorkspaceStore` and `WorkspaceSync` over Settings › Workspace's folder, this PC's archive or, through `SyncHost.ProjectHome`, the signed-in server as the home (a server it is not signed in to reads as offline; `HomeChanged` from the server's `projectChanged`, texts worded for it by `WorkspaceText.ForHome`); checkout and copy with its size and free space, status, Save version with the sync after it, sync, resolve, restore, history, open, new, rename, delete, the plan and removal of a local copy whose files but the media go to `<workspace>/.trash` (put back whole when a move fails), pruning past Kept versions after `HoldsAsync`, copies a newer Chronos wrote or that cannot be read listed as such and never changed, a folder inside a library refused, `PlanFolderAsync` and `UseFolderAsync`; phase 5c partials: `WorkspaceHost.Media` (Copy originals, Proxies only), `.Render` (local renders, Send again), `.Cleanup` (usage, the clean-up after each copy and by schedule, the trash's plan and Empty, the removal's unsent renders and originals) and `.Move` (move plan and job, `IsMoving` gate, `MoveEnded`, the unfinished move)), `WorkspaceFolderChange` (Settings › Workspace › Change…, Move… and Resume, and the refused folder's Choose folder), `ProjectMenuViewModel` (the title's ▾: state chip read again after edits, the menu, Update media; `IWorkspaceUi` is what it asks of the section, `ShowDialogWhenFree` holding a background conflict until the open dialog closes), `WorkspaceDialogs` (Open in workspace with unreadable projects listed disabled, project name, Save version, History, conflict, a format conflict offering only Save both, Remove local copy with its typed confirmations; `WorkspaceDialogs.xaml`), `WorkspaceProjectItem` (a picker row), `WorkspaceText` (states, versions, authors, failures) |
| `Import` | `CardPool` (inserted cards, remembered cards, folders), camera profiles, plans and choices, destinations (archive, folder, server through `ServerImportSink`), card actions (verified delete, format, eject) |
| `Archive` | `CurrentArchive`, `ArchiveTree`, figures for the charts, maintenance reports, Reorganize (`ReorganizeDialogViewModel`: folder, file and title templates each with its switch, the dry run, Apply queues the `move` job of that plan; `ReorganizePlans`: each template's check, the plan as rows and a summary; `ReorganizeOffer`: per archive, the templates Settings › Archive's toast offers, joined while that archive's toast is up), Convert (`ConvertDialogViewModel`: format, JPEG quality and a mode chosen at every run, the dry run made once per format and quality, Apply behind the mode's confirmation queues the `convert` job of that plan through `MassConverter.QueueAsync`; `ConvertPlans`: the plan as rows in the mode's words, a summary, the space line, the Replace confirmation that types the number of photos and the New sequence one that counts the photos not copied; `ConvertUndo`: the Undo the Jobs screen's toast offers when Replace conversions end, which restores the `Replaced` trash entries their jobs made, by the job's id), retag, delete and trash dialogs (`SequenceDeletion`, `DeletePlans`, `TrashEmptyPlans`: Empty… behind a dry run and a typed confirmation, every entry whose conversion was deleted named first), `ArchiveFailures` |
@@ -88,10 +88,10 @@ Dependencies point one way: `Core` ← `Core.Windows`, `Data`, `Protocol` ← `S
| `Ui/Themes`, `Ui/Theming` | DESIGN tokens (light, dark), typography, control styles, `ThemeManager` |
| `Ui/Controls` | `ChronosWindow` (chrome, language direction), `NavRail`, `JobBar`, `ToastHost` (`Toast.Closed` once a toast leaves the screen), `Field` (placeholder, icon, error), `Chip`, `AutoSlider`, `StatusGlyph`, `EmptyState`, `Icon`, `Bidi` (right-to-left rules), `Motion` (animations off for screenshots) |
| `Ui/Interop` | DWM calls of the window chrome; `TrayIcon` (`Shell_NotifyIconW`: the Uploader's tray, the client's Windows notifications) |
| `Ui/Visuals` | `DrawingElement` (hover readout, item keyboard and activation) and its charts (`BarChart`, `SeriesChart`, `StackedBar`, `HeatmapStrip`, `TimelineBands`), `Filmstrip`, `PreviewViewport`, `CurveEditor`, `SequenceCard`, `VirtualizingWrapPanel`, `SegmentedControl`, `SplitButton` |
| `Ui/Visuals` | `DrawingElement` (hover readout, item keyboard and activation) and its charts (`BarChart`, `SeriesChart`, `StackedBar`, `HeatmapStrip`, `TimelineBands`), `Filmstrip`, `PreviewViewport` (with `PreviewSurface` and `ViewportMath`: the crop box's handles, hit-test order, drag, keyboard nudges once selected, the straighten grid and the automation value; the math in Core `CropFrame`), `CurveEditor`, `SequenceCard`, `VirtualizingWrapPanel`, `SegmentedControl`, `SplitButton` |
| `Server/Api`, `Server/Events` | Endpoint groups (`XxxEndpoints.Map`; `ScheduleEndpoints`: `/api/v1/schedules`; `LibraryEndpoints`: the Library filters' facets, sequence thumbnail, photo delete, bulk delete/retag/jobs; `TrashEndpoints`: list, restore, empty (`conversionDeleted` in its dry run); `ProjectEndpoints`: `/api/v1/sequences/{sid}/projects` through the archive's `ProjectService` (list with Main first, create, rename, delete, head, versions a page at a time, one version, push with its outcome as `ProjectPushResultDto` under a 65 MiB body limit, the frames and photo aliases a workspace places positions on and their stamp; pages capped at 4 Mi settings characters, `summary` and `stored` reads, 409 `sequence_empty` for a sequence without photos, deletion by the owner, an admin or the maker's own account); `SequenceEndpoints`' settings `PATCH` through `ArchiveService.EditSettingsAsync`; `ArchiveEndpoints`: settings, statistics, scan jobs, Reorganize's dry run and `move` job, Convert's dry run and `convert` job, both through `PlanCache`: a dry run's plan, made apart from its request, a few at once across both kinds, kept a few minutes while what it reads from the index stays (typed keys `PlanKey<TPlan>`: `ReorganizePlanKey`, `ConvertPlanKey` from `GetConvertStampAsync`, the selection and the target with the quality that counts, not the mode), for the same dry run and its confirmation; a conversion's confirmation takes only a kept plan (`Kept`), its busy sequences and free space taken again), API errors, the WebSocket `EventHub` |
| `Server/Security` | Accounts, password hashing, tokens, session cookies, login guard, access rules, audit log |
| `Server/Storage`, `Server/Jobs` | Archive and processing modules (the archive module's `SequenceChanged` publishes `sequenceChanged` `reorganized`, `converted` and `created`; its `FreeSpace` is `VolumeSpace.WritableFree`, the tighter of the space path's volume and the folder's own), uploads (`UploadMaintenance`: recovery at start, and the sweep that is the `uploads` clean-up step; `UploadService.ReceiveAgainAsync`: a verified upload whose filing was refused for now goes back to receiving, 503), render store (files a render under the sequence's lease, where the index has the folder then, with the project and version a node's job rendered; `FolderMovedException`, 503 `folder_moved`, when the sequence is not in it); `ProjectCatchUp` (Main takes settings written outside the projects soon after a `PATCH`, an analysis or a conversion, for sequences with a Main: `projectChanged` without waiting for the next project call); the archive module's `ProjectsChanged`, published as `projectChanged` (and `sequenceChanged` `settings` when Main was mirrored); `JobEngineHost`, `SchedulerHost` (the `Scheduler` on the engine, started after it; archive.json read every 10 minutes whatever the scan schedule does; every schedule change and run published as a `scheduleChanged` event) and `ServerScheduleHost` (time zone, archive refreshed from archive.json, system schedules), render node service (a job of a project version claimed with that version's settings placed on the frames it lists), monitor and availability |
| `Server/Storage`, `Server/Jobs` | Archive and processing modules (the archive module's `SequenceChanged` publishes `sequenceChanged` `reorganized`, `converted` and `created`; its `FreeSpace` is `VolumeSpace.WritableFree`, the tighter of the space path's volume and the folder's own), uploads (`UploadMaintenance`: recovery at start, and the sweep that is the `uploads` clean-up step; `UploadService.ReceiveAgainAsync`: a verified upload whose filing was refused for now goes back to receiving, 503), render store (files a render under the sequence's lease, where the index has the folder then, with the project and version a node's job rendered; `FolderMovedException`, 503 `folder_moved`, when the sequence is not in it); `ProjectCatchUp` (Main takes settings written outside the projects soon after a `PATCH`, an analysis or a conversion, for sequences with a Main: `projectChanged` without waiting for the next project call); the archive module's `ProjectsChanged`, published as `projectChanged` (and `sequenceChanged` `settings` when Main was mirrored); `JobEngineHost`, `SchedulerHost` (the `Scheduler` on the engine, started after it; archive.json read every 10 minutes whatever the scan schedule does; every schedule change and run published as a `scheduleChanged` event) and `ServerScheduleHost` (time zone, archive refreshed from archive.json, system schedules), render node service (a job of a project version claimed with that version's settings placed on the frames it lists; `RoutedAsync` routes a job again from the sequence's settings of the moment, and a node that reads an older settings format, or cannot encode the adapted size, never claims it), monitor and availability (`RenderNodeAvailability` waits for a node only while one would take the routed job) |
| `Server/Hosting`, `Server/Admin/web` | `ServerHost`, `ServerLogging` (console and file levels the logging filters read at every line, the file sink's limits, the engine's level; applied again when Settings › Logs is saved), certificates, discovery beacon, embedded static files (`EmbeddedStaticFiles`: `no-cache` and a content ETag, so an upgrade never mixes old and new modules), Windows service (start and stop failures in the Application event log); the admin panel (ES modules, one per page; `schedules.js` is the Jobs page's Scheduled tab; the Library's views in `pages/library/`: `sequence.js` a sequence and its photo viewer, `projects.js` its Projects section (Main marked, head and last change, versions on demand, Rename and Delete of the others, live on `projectChanged`; nothing that edits settings), `trash.js` the archive's trash, `shared.js` cards, selection, grid keyboard and the retry of thumbnails a finished job may have built; `upload.js` the upload dialog the Library opens on demand, hashing in the module worker `hash-worker.js` with the in-house incremental SHA-256 of `sha256.js`, self-tested before its first use, and sending the capture time `capture-time.js` reads: the Exif DateTimeOriginal of a JPEG or TIFF-based file, else the file's time; `reorganize.js` the Reorganize dialog of the Library's selection and of the Archive page's save toast: template switches and fields, a live dry run of `POST /archive/reorganize` one request at a time, Apply that sends the shown plan's fingerprint back; `convert.js` the Convert dialog of the Library's selection (`planTarget` in `library.js`, shared with Reorganize: the ids, at most 1,000, or `all`): format, JPEG quality and a mode chosen at every run (Replace or New sequence, never preselected), a debounced dry run of `POST /archive/convert` one request at a time, asked in Replace's words until a mode is chosen and again while the server is still making it (a proxy's cut-off, `plan_dropped`), per sequence photos converted, left as they are or not copied and why, blocked, size before and after, the space line; Apply that confirms Replace by a typed word and New sequence with the photos not copied, asks the dry run again and sends the shown plan's fingerprint back, never twice after no answer; `pages/library/trash.js` gives replaced entries their own Restore and lists those whose conversion was deleted first; `audit.js` reads `archive_converted` as a sentence) |
### 2.5 Hosts
@@ -198,6 +198,16 @@ an original goes only when the home's frames, read now, hold its bytes (`Workspa
`.trash`; only the user's Empty… erases `.trash`. Logic lives in `Chronos.Data/Workspaces` (Linux-tested); the App's
`WorkspaceHost` wires settings, the open project, the move gate and the UI.
Framing and look (owner review 1, phase 4): every pixel decision lives in `Chronos.Core` and is tested on Linux. Decode
(Exif orientation) → exposure in the raw frame → one warp (`RenderGeometry.For`: stabilisation⁻¹ · `FrameOrientation`⁻¹
· virtual camera, the crop in the view frame) at the size `RenderSize.Of` gives → flow, interpolation, blur and
stacking → `FrameFinish` (look, then knee) → encoder. The render, the server's managed fallback, render nodes and the
editor's preview call these same functions; measuring passes never see the orientation or the look. The settings
format is the only gate: `ProjectSettings.RequiredFormat` for what is stored, `RenderRules.RequiredFormat` for what a
render needs, compared with `ServerInfo.SettingsFormat` (desktop gates: `EditorViewModel.RenderBlockedReason`, `ProjectMenuViewModel`, `ServerJobs`,
`RemoteSequenceSource`, `LibraryActions`, `WorkspaceSync.EnsureHomeReads`, `SyncService`) and with
`RegisterNodeRequest.SettingsFormat` (the server's claim and wait).
Sync (desktop ↔ server, BRIEF §14.5) reuses the same paths: `SyncService` compares the local index with the server's
listing (settings and tags carry version counters), uploads go through the chunked protocol into the server's
`ArchiveIngest`, downloaded originals are verified and committed through the local `ArchiveIngest`, and proxies land
@@ -216,6 +226,7 @@ run as server jobs whose progress comes from the events.
| A server storage backend | `IArchiveIngest`, `IFrameAssetLocator` through the `ServerHost.Build` registration callback |
| A schema change | `Data/Migrations/{sqlite,postgres}/NNNN_topic.sql` (never edit an applied one) |
| An advisor rule | `Core/Advice` with a localised reason key in `Advisor` |
| A project setting that changes pixels | a member of `ProjectSettings` declared after the existing ones and before `Extra`, omitted at its default (strings, not enums, for lists that grow); raise `RequiredFormat` only while it is used and `CurrentVersion` with it, so older builds open such projects read-only and other projects keep their text and hash (DECISIONS 2026-11-04) |
| A UI string | `i18n/en/<Area>.resx` + `i18n/it/<Area>.it.resx` (other languages via `i18n missing`/`import`) |
| An admin page | ES module in `Server/Admin/web/pages`, strings in the `Admin` area |
| A CLI command | `ICommand` in `Tools/Commands`, listed in `Tools/Program.cs` |
+95 -9
View File
@@ -972,7 +972,9 @@ Results → `analysis.json` + compact summary in DB; charts in the Edit section
- Deflicker window (4× flicker period), region deflicker when horizon confidence is high,
holy-grail transition length (half the typical distance between exposure steps), WB
smoothing, stabilization on/off (measured shake > 0.3 px) with crop cost, crop/aspect
suggestions from subject placement, output resolution cap from source/preview size and
suggestions from subject placement (on the view as shown: the aspect and the horizon's
place follow a turn, flip or straighten; amended 2026-11-04, owner review 1 R6), output
resolution cap from source/preview size and
codec level limits, quality profile.
- Auto-generated **sequence presets** ("Night sky — 4K 10-bit HEVC 24 fps, deflicker 41,
stabilise", "Holy grail sunset — 4K HEVC 30 fps, transitions 18", "Construction cam —
@@ -1010,6 +1012,20 @@ stabilization into one affine), non-linear time remap (Fritsch–Carlson monoton
temporal stacking (median, progressive max with decay), geometry stage, codec level limits,
disk spill, cancellation semantics.
Orientation and look (amended 2026-11-04, owner review 1 R5/R6). The project's quarter
turns, mirror (left↔right), flip (top↔bottom) and straighten (±15°, positive clockwise)
apply after Exif orientation, in that order, inside the one warp between stabilisation and
the virtual camera; pixels are never turned after decode, so the stabiliser, the sky mask
and the horizon stay in the raw frame. The crop and the keyframe centres are normalised in
the view frame: oriented, straightened and zoomed just enough that no corner shows (cover
zoom cos|θ| + max(W/H, H/W)·sin|θ|, about 1.43× at 15° on 16:9, folded into the decode
size; never stored). The look (None, Mono, Sepia, Warm, Cool, Vivid, Muted, Fade, with a
strength) is a built-in linear-light matrix, contrast power and lift, applied once per
output frame after stacking, interpolation and motion blur and before the highlight knee;
measuring, flow and stacking never see it. The render, the server, render nodes and the
editor preview call the same Core code (`RenderGeometry`, `RenderSize`, `FrameFinish`), so
they agree to the pixel. Library, filmstrip and admin thumbnails stay the raw photos.
### 11.3 Encoders and containers
| Output | Client (Windows) | Server (Linux/Windows) |
@@ -1027,12 +1043,20 @@ GOP, B-frames, profile/level via `ICodecAPI`. Capability discovery (`MFTEnumEx`
flag, friendly names, DXGI adapter) is shown in Settings › Rendering and used to hide
unavailable codecs.
### 11.4 Presets
### 11.4 Presets (amended 2026-11-04, owner review 1 R5)
Presets bind resolution, aspect, codec, profile, bit depth, fps, bitrate (≈0.10 bpp/frame
Presets bind a resolution class, codec, profile, bit depth, fps, bitrate (≈0.10 bpp/frame
H.264, 0.07 HEVC, 0.05 AV1; night-sky content is the most demanding), GOP and container.
Editing any value flips the name to "Custom"; matching values restore the preset name.
The chosen proportions win (amended 2026-11-04, owner review 1 R5): when the project's
aspect (manual, or the Auto's advised value) is not "source", a fixed-size preset is a box
and the aspect is fitted inside it, the box turned to portrait for a ratio below 1: 4K at
9:16 = 2160×3840, 1:1 = 2160×2160, 4:5 = 2160×2700, 21:9 = 3840×1646; 1080p at 9:16 =
1080×1920. "source" keeps the preset's own size. Sizes stay even for codecs that need it,
then the encoder's limits cap them, read as long edge × short edge. The preset's name does
not change; the Export step shows the size rendered as *Output size*.
Built-in presets: 8K UHD 10-bit HEVC archive · 4K UHD 10-bit HEVC archive · 4K UHD HEVC ·
4K UHD H.264 compatible · DCI 4K HEVC 24 fps · Cinema 21:9 4K HEVC 24 fps · 4K 60 fps ·
1440p H.264 · 1080p H.264 share · 1080p 60 · 1080×1920 vertical social · 1080×1350 4:5 ·
@@ -1141,7 +1165,7 @@ player smoke test on Windows CI.
sequence opens the same way, as a project whose home is the server, when the server keeps
projects and the account may edit; otherwise it opens with proxies (§14.5).
### 12.3 Edit (amended 2026-10-16, R7; formerly "Sequence editor"; amended 2026-10-26, R8)
### 12.3 Edit (amended 2026-10-16, R7; formerly "Sequence editor"; amended 2026-10-26, R8; amended 2026-11-04, owner review 1 R5/R6)
```
│ ← Harbour sunset ▾ · [Main ● In sync ▾] · 3,600 frames · Canon EOS R5 · 2 s · 2 h 00 m [Analyse] [Optimise all] [Render ▾] │
@@ -1176,9 +1200,11 @@ player smoke test on Windows CI.
analyses with the step that deals with it; light, flicker, exposure steps received,
shake and flagged frames; Analyse), **Frames** (virtualized table: index, time,
exposure, ISO, f, size, tier, flags; exclude/include; set hero; the findings about
single frames), **Exposure** (deflicker, regions, holy-grail transitions, WB) with
luminance/waveform charts, **Motion** (blur, flow quality, stabilization) with shake
path chart, **Camera** (crop, aspect, virtual camera keyframes with a spline editor),
single frames), **Exposure** (deflicker, regions, holy-grail transitions, WB, look:
filter and strength) with luminance/waveform charts, **Motion** (blur, flow quality,
stabilization) with shake path chart, **Camera** (aspect, rotation, mirror, flip,
straighten, the crop drawn on the preview and locked to the aspect, virtual camera
keyframes with a spline editor; amended 2026-11-04, owner review 1 R5/R6),
**Time** (fps, timing mode, remap curve, fit-to-duration, plan chart), **Stack**
(median/max, trail length; optional), **Export** (preset, values, output name, batch
list, render history, sponsor slot — Phase 9 only).
@@ -1195,12 +1221,53 @@ player smoke test on Windows CI.
current deep analysis or one waits, runs or is paused; else on Frames.
- Preview always on top with tools: zoom/pan (1:1 shows raw pixels), wipe compare
original/corrected, motion-vector overlay, region boundary, crop mask ("what I lose" vs
"how it will look"), full-screen native-resolution window with collapsible shot data.
"how it will look"; on the Camera step it is on by default and edits the crop, below),
full-screen native-resolution window with collapsible shot data.
- Every deducible control shows Auto/manual state (§10.4); every control has a tooltip
with the reason and the effect of moving it the wrong way.
- While a job runs on this sequence, settings that would change the rules mid-render are
disabled; viewing tools stay live.
Framing and look (amended 2026-11-04, owner review 1 R5/R6; §11.2, §11.4).
- The crop is edited on the preview. On the Camera step the preview shows the whole view
frame (turned and straightened, without stabilisation or camera moves), so the box is the
stored crop, always locked to the output's aspect. It has 8 handles while the project is
editable (not read-only, of a newer format or busy, and the preview already showing the
current orientation): a drag inside moves it, a corner resizes from the opposite corner,
an edge from the opposite edge, Alt about the centre; at least 10 % of the largest box,
always inside the frame; rule-of-thirds lines while dragging; Esc cancels; one drag is one
undo step. A press on the box or Enter selects it (an Accent ring): arrows move it 1 %,
Shift+arrows 10 %, + and − resize it 2 %, and Esc gives the arrows back to the frames.
Inside a box that spans the view both ways a press pans while zoomed; the middle button
always pans. Screen readers hear the crop's place and size. An aspect change refits the
box about its centre.
- Camera rows: Aspect; Rotation (Rotate left, Rotate right and the angle, each press a
quarter turn as the picture is seen, also under a mirror); Mirror and Flip (switches);
Straighten (−15…15° by 0.1°, a fine grid on the preview while dragged or focused); Crop
size (10–100 % of the largest box), Crop X and Crop Y (the box's place in the frame's
slack); the keyframes. A turn, mirror or flip keeps the content: the crop, the keyframe
centres and roll follow it and a non-square aspect transposes (16:9 ↔ 9:16); each press
is one undo step. *Reset framing* clears the crop, the offsets and the orientation,
undoing the presses so keyframes and aspect stay on their content; disabled when nothing
is set. The crop-margin and Offset X/Y rows are gone: a crop placed by offsets in an
earlier release renders as before and becomes a box at its first edit.
- Exposure ends with the Look group: Filter (None, Mono, Sepia, Warm, Cool, Vivid, Muted,
Fade) and Strength (1–100 %, n/a with None). The look shows on the corrected side of the
compare wipe and never triggers a new measure.
- Export: Width and Height edit the preset's box; *Output size* shows the size rendered
(§11.4), marked *capped* when the encoder shrinks it.
- Settings format: a project is written as settings format 2 only while it uses a turn,
mirror, flip, straighten or a look other than None; otherwise it stays format 1, text and
hash unchanged. An earlier Chronos opens a format-2 project read-only. A merge takes a
turn or mirror on one side and a framing change on the other (crop, keyframes, offsets,
aspect) as one conflict; straighten and the crop merge apart. A server that announces an
older settings format (`server/info`, §14.3) is not sent what it would get wrong: *Sync*
(push and pull), *Send and render*, the Library's *Render* of a remote card and a remote
editor's save are held, saying *This server's Chronos cannot read these settings; update
it*; a local render of a workspace project is not held. Proportions win (§11.4) changes
no stored format: a 9:16 project on a 4K preset stays format 1, but its server render
needs a server and a render node of this release (§14.7).
Workspace (amended 2026-10-26, R8; §4.4, §7). Edit opens a sequence of this PC's archive only
as a project of the workspace, and never writes into the library; a capture (sample data)
keeps editing the library. A server sequence opens as a project of the workspace too when its
@@ -1783,7 +1850,7 @@ Advanced, §12.8).
```
POST /api/v1/auth/login {username,password,clientName} → {token,user,mustChangePassword}
POST /api/v1/auth/logout · POST /auth/password · GET /auth/me
GET /api/v1/server/info name, version, apiVersion, capabilities, tlsFingerprint, formats, limits, extensions
GET /api/v1/server/info name, version, apiVersion, capabilities, tlsFingerprint, formats, limits, extensions, settingsFormat
GET /health
GET /api/v1/users · POST · GET/PATCH/DELETE /users/{id} · POST /users/{id}/reset-password (admin)
@@ -1977,6 +2044,16 @@ original a conversion replaced in the target sequence is tombstoned too; sent wi
it files nothing and its completion answers the frame that holds its conversion (amended
2026-10-26, R7).
Settings format (amended 2026-11-04, owner review 1 R5/R6; §12.3, §14.7): `server/info`
gives `settingsFormat`, the highest project settings format the server reads (2 in this
release; absent from an older server, which reads 1). The server checks no settings: a
project push of a higher format answers 422 `newer_format` as before, and a render job whose
settings it cannot read fails with *These settings need a newer Chronos*. A render job
is sized from its resolved preset box adapted to the sequence's settings (§11.4) and carries
the settings format it needs (`requiredSettingsFormat`: format 2 for a format-2 project or
when the adapted size differs from the preset's fixed size); clients and servers that do not
know the members ignore them.
Schedules (amended 2026-10-26, R10; ManageArchive, every change audited): `PUT` and
`PATCH` change the fields given; an invalid field is 400 `invalid_schedule` with the field
as details (`name`, `recurrence`, `parameters.percent`…); a system schedule is never
@@ -2338,6 +2415,14 @@ get that version's settings (or the job's own portable settings) placed on the s
frames; a node gets them placed on the frames its claim lists, read as one frames version.
The render records the project and the version. Jobs without them render as before.
Settings format (amended 2026-11-04, owner review 1 R5/R6; §14.3). A node registers the
highest settings format it reads (`settingsFormat`; a node of an earlier release reads as 1)
and is never given a job that needs more: the claim and the wait for a node both route the
job again from the sequence's settings of the moment (size adapted, format required), and a
job no online node can take goes to the server's managed fallback instead of waiting. A node
of this release reads its encoder limits as long edge × short edge, so a 2160×3840 job fits a
4096×2304 encoder; an older node is held to its limits as announced.
### 14.8 Admin web panel (`/admin`, vanilla HTML/CSS/JS, ES modules, no build step, same API)
```
@@ -3034,6 +3119,7 @@ questions asked and the answers; DECISIONS rows give the reasons.
| 2026-10-26 | Owner review 2, R8 (phase 5b: server home) | §4.4, §7, §12.2, §12.3, §12.7, §14.3, §14.5, §14.7, §14.8 | A Chronos Server keeps its sequences' projects as a PC's archive does: `/api/v1/sequences/{sid}/projects` (list with Main made at the first read, create, rename, delete with the owner's, maker's or an admin's right, head, versions in size-capped pages, stored check, push with its outcome, frames and their stamp), the `projects` capability and `projectChanged`; settings written outside the projects become Main's version soon after, and a settings `PATCH` writes `project.json` under the lease; a sequence without photos keeps no projects; renders and render nodes take a project version's settings and record it; the admin panel's sequence page lists the projects (versions, Rename, Delete). The desktop opens a server sequence as a workspace project through its sign-in: *Open in workspace* on the Server screen and in Edit, proxies downloaded into the workspace (hash-checked, resumable), push and pull, conflicts, history and live state against the server, texts naming the server, renders and analyses on the server of the version it holds; an account without Edit and an older server keep *Open with proxies*. |
| 2026-10-26 | Owner review 2, R8 (phase 5c: originals, local render, clean-up, Workspace settings) | §4.4, §5, §12.3, §12.7, §12.8, §14.3, §14.5, §14.6 | Originals in the workspace on request (*Open in workspace* › Originals, *Copy originals…*, *Proxies only…* behind a plan), copied from either home hash-checked and resumable, a frame whose original is missing keeping its proxy; media index format 2 and project file format 3 while originals are held; a project with originals renders on this PC (`workspace-render`, stored as 21) into `exports/` with the ledger `renders.json`, *Version on render* saving a version first, and sends its renders home (`workspace-send`, 22) with their project and version, idempotent by render id, refusals per render; render uploads take optional `projectId` and `projectVersionId`, checked against the sequence (422 `project_mismatch`); *Pause metered transfers* holds every transfer with a server, downloads and workspace copies and sends included; originals judged by their bytes against the home's frames, those it lacks kept in the workspace's trash; the clean-up of media in step with their home (*Clean after*, *Size limit*, the `workspace-cleanup` schedule) and the workspace's trash emptied only by *Empty…* (typed count, fingerprint); Remove local copy weighs unsent renders and originals; moving the workspace folder (`workspace-move`, 23) behind a plan, renamed on one drive or copied and verified across drives, journaled, resumable, the source kept until the switch, with *Resume*; Settings › Workspace complete (Folder with Move…, Size limit, Default media, Sync, Version on render, Kept versions, Clean after, Open project, Trash). |
| 2026-11-04 | Owner review 3 (ports) | §12.7, §14.8, §14.9, §15, §19.6 | The public HTTP/HTTPS ports are server settings as well as variables (a variable locks them), applied at once; in a container the listening ports are locked to the template's; the admin panel's Network and TLS shows the container's ports, the public ports and the client address with Copy; clients read an address without scheme or port as port 8443 and report an address that answers as something else, never offering its certificate for trust; the Unraid template and compose gain *Public HTTP port*. |
| 2026-11-04 | Owner review 1, R5/R6 (phase 4: visual crop, transforms, looks) | §10.3, §11.2, §11.4, §12.3, §14.3, §14.7 | The crop is edited on the preview with handles, always locked to the output aspect, in the view frame (turned, straightened); the chosen proportions win: a fixed-size preset is a box the aspect is fitted in (4K at 9:16 = 2160×3840), "source" keeps the preset, the preset name stays and *Output size* shows the result; the Camera step gains Rotation (quarter turns), Mirror, Flip, Straighten (±15°, automatic cover zoom), Crop size/X/Y and Reset framing, the crop-margin and offset rows go; a turn or mirror keeps the content (crop, keyframes, a transposed aspect); the Exposure step ends with a Look (eight built-in colour looks with a strength), applied after stacking and before the knee; one Core path for render, server, nodes and preview; settings format 2 written only when a transform or look is used, read-only in older builds; `server/info` and node registrations announce the settings format, and nothing an older server or node would get wrong is sent to it; the advisor works on the view as shown. |
## Appendix A — `CLAUDE.md` content (create verbatim in Phase 0, keep updated)
+68 -4
View File
@@ -5,6 +5,74 @@ commits follow Conventional Commits (release notes are generated from them by `C
## [Unreleased]
### Added
- **Visual crop** (owner review 1, R5, phase 4): on the Camera step the crop mask is on and edits the crop on the
preview: drag the box to move it, drag one of its eight handles to resize it (Alt about the centre), always locked to
the output's aspect and inside the frame; Esc cancels and each drag is one undo step. Enter (or a press on the box)
selects it: the arrows move it, + and − resize it, Esc gives the arrows back to the frames. The middle button pans.
*Crop size*, *Crop X* and *Crop Y* set the same box by number, and changing the aspect refits it about its centre.
- **Rotate, mirror, flip and straighten** (R6): the Camera step's *Rotation* (Rotate left, Rotate right), *Mirror*,
*Flip* and *Straighten* (−15…15°, with a fine grid on the preview while it moves) turn the whole render. A quarter
turn keeps what is framed: the crop and the keyframes turn with the picture and a 16:9 aspect becomes 9:16.
Straightening zooms in just enough that no corner shows (about 1.43× at 15° on 16:9). *Reset framing* puts the
crop and the orientation back, keyframes staying on their content.
- **Looks** (R6): the Exposure step ends with a *Look* group: *Filter* (None, Mono, Sepia, Warm, Cool, Vivid, Muted,
Fade) and *Strength*. A look is applied after stacking and blur and before the highlight knee, the same on this PC,
the server and render nodes; the compare wipe shows it on the corrected side. Thumbnails stay the photos as shot.
- The Export step shows *Output size*, the size the render will have (*capped* when the encoder shrinks it); Width and
Height edit the preset's box.
- Servers and render nodes announce the project settings format they read (`server/info` `settingsFormat`, a node's
registration), and render jobs carry the format they need: a server or node of an earlier release is never given a
project it would render wrong, and the job goes to one that reads it, or to the server's managed fallback.
- Known limitations: Chronos 0.1.0-rc.11 and earlier render a project with a chosen aspect and a fixed-size preset at
the preset's proportions on their own. After a server is upgraded, this Chronos can take up to a minute to learn its
settings format. On the development PC the *Microsoft AVC DX12 Encoder* refuses UHD in both orientations (as
before this release); Chronos uses the next encoder. The new Camera rows, the Straighten grid's slider and the local
render of a workspace project against an older server have no on-screen test (checked by view-model tests, a binding
test and the screenshots).
### Changed
- **The chosen proportions win** (R5): with an aspect other than *Source*, a fixed-size preset is a box the aspect is
fitted in: 4K at 9:16 renders 2160×3840, at 1:1 2160×2160, at 4:5 2160×2700, at 21:9 3840×1646; 1080p at 9:16
renders 1080×1920. *Source* keeps the preset's size, and the preset keeps its name. The warning that the preset's
aspect replaced the project's is gone.
- The Camera step's four crop-margin rows and *Offset X* / *Offset Y* are replaced by the crop on the preview and
*Crop size*, *Crop X*, *Crop Y*. A crop placed with offsets renders as before and becomes a plain box at its first
edit.
- Encoder limits are read as long edge × short edge, so a portrait frame up to the encoder's landscape limit encodes
instead of being shrunk (the software H.264 encoder takes 2160×3840).
- The advisor works on the picture as shown: after a quarter turn it advises the turned aspect, and the horizon's place
follows the turn, flip and straighten.
- **Upgrade:** no migration. *Proportions win* changes the output size of existing projects: one with a manual aspect
other than *Source* and a fixed-size preset (a 4K project at 9:16 now renders 2160×3840 rather than the preset's
3840×2160), and an analysed project left at *Auto*, whose advised 16:9 or 9:16 now wins over a
preset of another ratio (the 1080×1920 vertical preset on a landscape sequence renders 1920×1080); 16:9 presets on
landscape sequences do not change. Set Aspect to *Source* to keep a preset's own proportions. A project that uses a
turn, mirror, flip, straighten or look is saved as settings format 2, which Chronos 0.1.0-rc.11 and earlier open
read-only (a `.chronos` file of it too); every other project keeps format 1 and its text and hash. Servers and nodes
of this release announce the settings format they read; to one of an earlier release this Chronos sends no format-2
settings (*Sync*, *Send and render*, a remote editor's save) and no render whose size the preset's ratio would
change, saying *This server's Chronos cannot read these settings; update it*.
### Fixed
- Visual crop, transforms and looks, found by the phase's review before any release had them (one adversarial round, 30
findings, all confirmed and fixed, and a final check that fixed one more): a render whose aspect changed after it
was posted is sized from its preset again, and a job no longer waits for a node that will never take it; settings
an older server cannot read stay on this PC for the remote editor, the archive sync and every workspace push path,
including the Library's *Render* of a remote card; a local render of a workspace project is not held by an older
server; a turn on one PC and a crop or keyframe on another merge as one conflict instead of a mis-framed project; an
out-of-range crop turns with what it shows; a 21:9 aspect turns to 9:21 and back exactly; the Rotation row counts the
turns as seen under a mirror; *Reset framing* keeps keyframes and aspect on their content; a look at 0 % is cleared
and never reaches the motion vectors; inside a box with no room to move, a press pans while zoomed; the selected box
shows a ring and screen readers hear the crop change; the derived settings format no longer shows as a setting
difference in sync. Tooltips whose English changed fall back to English until translated again.
- A project saved on Windows and the same project on the Linux server no longer read as different: the desktop wrote
project text with Windows line ends, so an unchanged project showed *Modified* or *Behind*, saved empty versions,
made the server add *Merge* or *External* versions, and marked renders and sends as of other settings. Every build now
writes the same text, and versions saved before compare equal to it.
## [0.1.0-rc.11] — 2026-11-04
### Added
- **Originals in the workspace** (owner review 2, R8, phase 5c): *Open in workspace* offers *Originals* besides
*Proxies*, with their size and the drive's free space, also for a server's sequence (Settings › Workspace › *Default
@@ -53,10 +121,6 @@ commits follow Conventional Commits (release notes are generated from them by `C
Italian wording.
- A workspace copy cancelled just before it committed (its last query already answered, the project's lease then free)
could commit anyway and end *Done*, keeping the media it wrote; it now stops at the commit and its clean-up runs.
- A project saved on Windows and the same project on the Linux server no longer read as different: the desktop wrote
project text with Windows line ends, so an unchanged project showed *Modified* or *Behind*, saved empty versions,
made the server add *Merge* or *External* versions, and marked renders and sends as of other settings. Every build now
writes the same text, and versions saved before compare equal to it.
### Changed
- *Pause uploads on metered* (Server screen) is now *Pause metered transfers*: on a metered connection the sync's
+17 -5
View File
@@ -703,13 +703,13 @@ One line per decision: date · decision · alternative · reason.
| 2026-11-04 | Phase 5c strings: every new key in en and it with final text; 19 unused keys removed from en and it and `i18n prune` removed 144 orphans from the other cultures; `Errors.Workspace.DiskFull` kept (the copy's space check). The Italian move plan, trash and job kind wordings were revised. (Owner review 2, R8, phase 5c; review ui-8, ui-9.) | Keep unused keys for later | Unused keys cost every translation. |
| 2026-11-04 | Conditional settings format: `ProjectSettings.CurrentVersion = 2` is the highest format this build reads; `ToJson` writes the lowest format that renders the same (`RequiredFormat`: 2 only when a turn, mirror, flip, straighten or non-identity look is set, otherwise `BaseVersion` 1; a newer project read-only keeps its own number through `WrittenFormat`); `ProjectContent.FormatOf` falls back to 1. (Owner review 1, R5/R6, phase 4.) | Always write 2 | Every project that does not use the new features keeps byte-identical canonical text and hash, so no External versions appear and older builds treat it as before. |
| 2026-11-04 | Rule for future settings members: a member that changes pixels and that the previous format would ignore raises the written format only when it is used; it is declared after the existing members, before `Extra`, and omitted at its default; lists that grow are strings, not enums. (Owner review 1, phase 4.) | Bump the format per release | Keeps old text stable and lets an older build carry the member through `Extra` in the same place. |
| 2026-11-04 | Orientation members and order: `camera.rotate` 0/90/180/270 clockwise after Exif orientation, then `mirror` (left↔right) and `flip` (top↔bottom) in screen axes after the turn, then `straighten` ±15° positive clockwise; all inside the single warp between stabilisation and the virtual camera. Pixels are never rotated after decode. (Owner review 1, R5, phase 4.) | Rotate the decoded pixels | Stabiliser paths, the sky mask and the horizon stay in raw-frame space and one resample is kept. |
| 2026-11-04 | Straighten cover zoom is automatic and never stored: c = cos\|θ\| + max(W'/H', H'/W')·sin\|θ\| (`FrameOrientation.CoverZoomOf`). (Owner review 1, R5, phase 4.) | A user zoom or a clamped border | No smeared border can ever show and any crop in [0,1]² stays valid. |
| 2026-11-04 | Orientation members and order: `camera.rotate` 0/90/180/270 clockwise after Exif orientation, then `mirror` (left↔right) and `flip` (top↔bottom) in screen axes after the turn, then `straighten` ±15° positive clockwise; all inside the single warp between stabilisation and the virtual camera. Pixels are never rotated after decode. (Owner review 1, R6, phase 4.) | Rotate the decoded pixels | Stabiliser paths, the sky mask and the horizon stay in raw-frame space and one resample is kept. |
| 2026-11-04 | Straighten cover zoom is automatic and never stored: c = cos\|θ\| + max(W'/H', H'/W')·sin\|θ\|, taken on the pixel-centre extents (W'−1)×(H'−1) (`FrameOrientation.CoverZoomOf`); about 1.43× at 15° on 16:9. (Owner review 1, R6, phase 4.) | A user zoom or a clamped border; the edge extents W'×H' | No smeared border can ever show and any crop in [0,1]² stays valid; the pixel-centre extents, slightly larger, put every output pixel centre inside the frame's, so the cover is whole (alpha 1) at ±15°. |
| 2026-11-04 | Crop coordinates: `camera.crop` and the keyframe centres are normalised in the view frame T (oriented, straightened, cover-zoomed), which is today's meaning for the identity transform; the crop stays one atomic array in `ProjectMerge`, so a concurrent move and resize give one `camera.crop` conflict. (Owner review 1, R5, phase 4.) | Raw-frame coordinates; per-edge merge | The mask maps 1:1 to the stored crop and a merge never yields a rectangle of the wrong ratio. |
| 2026-11-04 | Locked crop: editor edits write the aspect-locked box itself with `offsetX`/`offsetY` 0, so `FitCrop` returns it unchanged; the first edit of a legacy free crop with offsets bakes them in (`FitCrop(crop, ratio, offsets)`); the renderer keeps `FitCrop` as the safety net; an aspect change refits the box (same centre, new ratio, inside the frame). (Owner review 1, R5, phase 4.) | Keep free crops plus offsets | What the user drags is what renders. |
| 2026-11-04 | A quarter turn keeps the content: rotate left/right remaps the crop and keyframe centres exactly and transposes a non-square aspect (manual or the Auto's advised value: 16:9 → 9:16); mirror and flip remap crop and centres and negate the keyframe roll; each press is one undo step (`OrientationEdit`). (Owner review 1, R5, phase 4.) | Reset the framing on a turn | The framed subject stays framed. |
| 2026-11-04 | Proportions win: when the resolved aspect is not "source", a fixed-size preset is a size box and the aspect is fitted inside it, the box turned to portrait for a ratio below 1 (4K at 9:16 = 2160×3840, 1:1 = 2160×2160, 4:5 = 2160×2700, 21:9 = 3840×1646; 1080p at 9:16 = 1080×1920); "source" keeps the preset's size; sizes stay even for non-managed codecs; `AspectFromPreset` is removed and the preset name does not flip to Custom (`RenderSize`). (Owner review 1, R6, phase 4.) | The preset ratio wins (crop in the preset frame) | The chosen proportions are what the user asked for; default projects do not change. |
| 2026-11-04 | Proportions win is not format-gated in storage: raising the format for it would drift the canonical text of stored projects and spawn External versions; it is gated only in routing and in the desktop's server gating, and the output change is a CHANGELOG upgrade note. (Owner review 1, R6, phase 4.) | Write format 2 for it | Stored projects keep their hash. |
| 2026-11-04 | A quarter turn keeps the content: rotate left/right remaps the crop and keyframe centres exactly and transposes a non-square aspect (manual or the Auto's advised value: 16:9 → 9:16); mirror and flip remap crop and centres and negate the keyframe roll; each press is one undo step (`OrientationEdit`). (Owner review 1, R6, phase 4.) | Reset the framing on a turn | The framed subject stays framed. |
| 2026-11-04 | Proportions win: when the resolved aspect is not "source", a fixed-size preset is a size box and the aspect is fitted inside it, the box turned to portrait for a ratio below 1 (4K at 9:16 = 2160×3840, 1:1 = 2160×2160, 4:5 = 2160×2700, 21:9 = 3840×1646; 1080p at 9:16 = 1080×1920); "source" keeps the preset's size; sizes stay even for non-managed codecs; `AspectFromPreset` is removed and the preset name does not flip to Custom (`RenderSize`). (Owner review 1, R5, phase 4; for an Auto aspect see the advised-aspect row below.) | The preset ratio wins (crop in the preset frame) | The chosen proportions are what the user asked for; a project at "source" does not change. |
| 2026-11-04 | Proportions win is not format-gated in storage: raising the format for it would drift the canonical text of stored projects and spawn External versions; it is gated only in routing and in the desktop's server gating, and the output change is a CHANGELOG upgrade note. (Owner review 1, R5, phase 4.) | Write format 2 for it | Stored projects keep their hash. |
| 2026-11-04 | Routing format: `RenderRules.RequiredFormat(settings, export, srcW, srcH)` = max(written format, 2 when the adapted size differs from the preset's fixed size), never written; nodes announce `RegisterNodeRequest.SettingsFormat` (older node = 1); jobs carry `RenderJobParameters.RequiredSettingsFormat`; a claim and the "awaits a node" check skip incompatible nodes. (Owner review 1, phase 4.) | Send every job to every node | An older node never renders a job it would get wrong. |
| 2026-11-04 | Server format announcement: `ServerInfo.SettingsFormat` is new (null from an older server = 1); the desktop disables Push and Send-and-render when the required format exceeds the server's, with a tooltip giving the reason (`Tooltips.Server.NeedsNewerServer`). (Owner review 1, phase 4.) | Let the server refuse | The user sees why before acting. |
| 2026-11-04 | Colour look: parametric and built in (no LUT files a server or Docker image would lack): a linear-light 3×3 matrix, a contrast power about 0.18 and a lift, blended by strength; applied once per output frame after stacking, interpolation and blur and before the knee (`FrameFinish`), never seen by measuring, flow or stacking; `look.filter` is a string and an unknown name renders as identity with `Export.Render.LookIgnored`. (Owner review 1, R6, phase 4.) | LUT files; look before stacking | Same pixels everywhere, the knee compresses any overshoot, analysis stays on real data. |
@@ -719,6 +719,18 @@ One line per decision: date · decision · alternative · reason.
| 2026-11-04 | Global only: the new settings are not per-frame and not frame-keyed, so there are no new parked positions; the keyframe `Rotation` roll is unchanged. (Owner review 1, phase 4.) | Keyframed straighten or look | Simple, and roll already covers per-frame tilt. |
| 2026-11-04 | Phase 4 compatibility: new server + old node: v1 rendered by the node, v2 and proportions-win jobs never sent to it; old server + new desktop: v1 works, v2 push and render disabled with a reason, proportions-win render disabled (push works); new server + old desktop: v1 works, v2 listed and opened read-only, never mirrored or merged, the old desktop's own render uses the preset ratio (known limitation); old desktop local: v2 read-only, a format-1 `.chronos` refuses it, proportions-win renders at the preset ratio (CHANGELOG note). (Owner review 1, phase 4.) | — | Records the matrix the format, routing and gating rows give. |
| 2026-11-04 | Phase 4 groundwork details: `ProjectSettings.WrittenFormat` (the format `ToJson` stamps, a newer project's own number); `EditPath.HasHandValues` counts a crop only when not whole (`CropFrame.IsWhole`), which matches today; FrameFinish clamps the look strength to 0..1 (missing = 1) and an unknown look still writes format 2 (it is a newer Chronos's); look names are ordinal and case-sensitive; `OrientationEdit` also remaps offsets and pending keyframes, negates straighten on mirror/flip, normalises rotate to 0..270 and rounds remapped coordinates to 12 decimals so four turns give the original text; the SelfTest geometry and colour checks sit before the robustness checks. (Owner review 1, phase 4.) | — | Simplest safe choices where the plan was silent. |
| 2026-11-04 | Proportions win for an Auto aspect too: its advised value is the aspect, and the analysis advises 16:9 or 9:16 for every analysed sequence, so an analysed project at Auto with a fixed box of another ratio changes size (a 3:2 custom box 96×64 renders 96×54; the 1080×1920 vertical preset on a landscape source renders 1920×1080); 16:9 presets on landscape sources are unchanged, and Aspect *Source* keeps the preset's own proportions. (Owner review 1, R5, phase 4.) | Only a manual aspect wins | One rule for the aspect the user sees in the Camera step; *Source* is the way back. |
| 2026-11-04 | Crop values: `CropFrame.ToCrop` writes the box on a 12-decimal grid (`CropFrame.Grid`), never −0, and a whole box as no crop; `CropFrame.Of` checks each of the four values for finiteness, as the render's `NormalisedCrop` does; `RenderGeometry.Orientation` is the orientation as rendered (cover zoom, normalised values) for the preview and the tests. (Owner review 1, R5, phase 4.) | Full precision; one finiteness check of the sum | Editor-written crops survive four turns or two mirrors byte for byte; the editor, `RenderSize` and the render read a damaged crop alike. |
| 2026-11-04 | The advisor works on the view as shown: `SequenceContext` carries Rotate, Flip and Straighten (`ForCamera`), the aspect is advised on the turned size, and the export resolution advice keeps the source's orientation (proportions win adapts the box anyway); `EditorSession.Optimise` advises again for the camera as it is when its turn, flip or straighten differs from the analysis context, while the findings, the Analysis step and the presets keep the unturned analysis. (Owner review 1, R6, phase 4.) | Advise on the raw frame | Optimise after a quarter turn would otherwise put the unturned 16:9 back over the transposed aspect. |
| 2026-11-04 | Look values (`LookFilter`, the plan gave none): a saturation k and tint gains normalised to luminance 1 (Rec.709), a contrast power about the pivot 0.18, a lift: mono k 0; sepia tint (1.30, 0.97, 0.62), k 0, power 1.05; warm tint (1.10, 1.00, 0.86), k 1.05; cool tint (0.90, 1.00, 1.14); vivid k 1.35, power 1.12; muted k 0.6, power 0.92; fade k 0.8, power 0.85, lift 0.025. The power applies only to values above 0 (zero, negative and NaN pass), the lift and the strength blend to every value; the last pixels of a row go through the vector kernel padded with zeros; a public scalar `Apply(filter, strength, r, g, b)` in double is the reference the tests use; a strength above 1 reads as 1, and NaN or non-positive strength, a one-channel image, none, null or an unknown name leave the image as it is; an alpha channel is never touched; the look table is internal. (Owner review 1, R6, phase 4.) | User-tuned parameters; a scalar tail loop | Eight fixed looks are enough for the request; a pixel's result never depends on where it lies, and nothing the knee or a negative value would break is raised to a power. |
| 2026-11-04 | Render routing and errors: unreadable or newer sequence settings give no routing (the job keeps its posted size and format 1) and the render then fails with `Errors.Render.NewerSettings`, which `ProjectStore.Parse` gives in the user's language (the original exception kept inside); a job's `RequiredSettingsFormat` is the higher of the posted and the computed one; `ProcessingJobs.RequiredFormat` takes the highest over a batch's presets, and the editor's `RenderBlockedReason` uses it. (Owner review 1, phase 4.) | Validate settings on the server | The server stays free of settings validation; the job that cannot render says why. |
| 2026-11-04 | Encoder limits are long edge × short edge (`EncoderSelector.Takes`) in `EncoderSelector` and the Media Foundation provider: on this PC the software H.264 MFT announces 4096×2304 and encodes 2160×3840; `Fit` caps a portrait frame against the turned limit. A node registered with settings format 2 or more has its limits read either way round; an older node is checked against its limits exactly as announced. (Owner review 1, R5, phase 4.) | Portrait limits of their own | Measured on the development PC; an older node may not encode portrait. |
| 2026-11-04 | Desktop gates against an older server: the push gate compares the project's `WrittenFormat` (and, after the review, its unpushed versions') with the home's `SettingsFormat` (`IProjectHome.SettingsFormat`, a default member giving `CurrentVersion`, so local and archive homes need no change; `ServerProjectHome` takes it as an optional argument); while the push is blocked the whole *Sync* command is disabled, pull included; *Send and render* is held with an error toast (*RenderHeld* with the `NeedsNewerServer` text). (Owner review 1, phase 4.) | Pull while push is blocked | A pull's merge could push. |
| 2026-11-04 | Crop on the preview: editable only on the Camera step with the mask on, an editable project not of a newer format, frames to show, and the preview showing the project's orientation (after a turn, mirror, flip or straighten the box waits for the rendered frame; a crop, aspect or preset change moves it at once); on the Camera step the box is `EditableCrop`, on the others the output footprint (`FootprintInView`); a commit writes `CropFrame.ToCrop(box)` with the offsets 0; a drag ends its own undo step (`EndEditRun`), nudges merge under `Camera.Crop` until the key goes up; the arrows nudge only once the box is selected (a press on it or Enter; Esc, a press outside or losing focus give the arrows back to the frames); the automation value is read-only, exposed only while the box is editable; every `PreviewViewport` needs a tooltip (`xaml-lint`), so the full-screen preview has `Tooltips.Editor.Preview.View`. (Owner review 1, R5, phase 4.) | Arrows always nudge | Left and right keep stepping frames as before; the box never shows over a picture not yet turned. |
| 2026-11-04 | Camera step rows: the crop refit (`KeepCropLocked`) runs in `EditorSession.Edit` and `Optimise` and refits only a box already held to the old ratio without offsets; a legacy free crop, or one placed by Offset X/Y, is left to the render's `FitCrop` and baked into a held box at its first Crop size/X/Y edit (offsets then 0); without a source size the lock ratio is worked out on a 1×1 view; Straighten is stored rounded to 0.1°, never −0, shown `−1.2°` or `0°`, and drives `Editor.IsStraightening` from XAML only (`SliderActivity`, OneWayToSource); *Reset framing* sits on its own line above *Optimise section* · *Reset*, disabled with `ResetFramingNone` when nothing is set. (Owner review 1, R5/R6, phase 4.) | Reset framing in the button row | Three buttons do not fit the 292 px panel; a framing set before this release renders as before until it is edited. |
| 2026-11-04 | Look and Export rows: the look is null when the filter is None, a strength of 100 % is stored as null, and the look's unknown members (`Extra`) are kept; *Output size* reads `W × H`, marked *capped* when the encoder shrank it (1 px allowed for rounding to even), its tooltip giving the encoder's maximum turned to the output's orientation, or the encoded size when a codec level capped it; Width and Height load the resolved preset box, empty for a side the preset leaves to the source, never the encoded size. (Owner review 1, R5/R6, phase 4.) | Width and Height show the encoded size | The fields edit the box the proportions are fitted in. |
| 2026-11-04 | Phase 4 visuals the plan left open, in DESIGN.md and the mockups: the editable box outline in Accent, Shown and Locked keeping the 1 px TextMuted outline on the Scrim; rule-of-thirds lines 1 px Text at 50 %, the straighten grid 1 px Text at 30 %; the switch 36 × 20 (off TextMuted, on Accent with an OnAccent knob); a panel group header is a Stroke divider and the name in Text.Body 600; plain number rows on the Accent track; *Output size* drawn in `Export.html` (a 9:16 project, 2160 × 3840), `Editor.html` holding the Exposure screen, a Camera screen and the crop states one below the other. (Owner review 1, R5/R6, phase 4.) | A new mockup file per step | One file per existing screen. |
| 2026-11-04 | Phase 4 strings, icons and captures: keys beyond the plan (`Server.Setting.Look`, `Tooltips.Editor.Camera.ResetFramingNone`, `Tooltips.Editor.NotApplicable.NoLook` and `NoSlack`, `Tooltips.Editor.Look.Group`, `Editor.Export.Capped` with `Tooltips.Editor.Export.OutputCapped`, `Editor.Preview.CropValue`); removed from en and it, then `i18n prune`: `Editor.Camera.CropLeft/Top/Right/Bottom`, `Editor.Camera.OffsetX`, `Tooltips.Editor.Camera.OffsetX/OffsetY`, `Tooltips.Editor.Camera.Crop`, `Export.Render.AspectFromPreset`; `Editor.Camera.OffsetY` kept (it names the advisor's horizon placement); the 60 new strings translated into the 36 other languages. The five orientation icons are desktop-only (no admin `icons.js` entry) and never mirror in right-to-left languages. Three new capture scenes on the Sunset sample at frame 45, after the per-theme editor loop: `edit-camera-crop` (a moved 9:16 box), `edit-camera-straighten` (turned right, straightened, the grid on) and `edit-exposure-look` (Sepia, the wipe on, the panel scrolled to the Look rows); 31 baselines accepted. (Owner review 1, phase 4.) | — | Records what the strings, icons and screenshots hold. |
| 2026-11-04 | Phase 4 review fixes, routing and gates: render routing sizes a job from its resolved preset box, never from the size posted with it (the posted size only without a preset size); the server's wait for a node re-routes the job as the claim does; the remote editor lets edits happen but refuses to save settings the server cannot read (`NeedsNewerServer` toast); archive sync keeps such settings here (`ServerFormatException`, the row stays LocalAhead with the reason; the server's format is cached for 1 minute, none announced = 1); a workspace push is refused whole, before its first version, when any unpushed version needs a newer home, and Sync's reason includes the unpushed versions; a local render of a workspace project (`RendersLocally`) is not gated by the server's format; the Library's Render on a remote card applies the editor's older-server gate and sizes the job on the project it read, without embedding it (the server renders the sequence's settings of the moment). (Owner review 1, phase 4.) | Let the server refuse | Nothing an older server would store and then fail to render is sent to it, and no job waits for a node that never takes it. |
| 2026-11-04 | Phase 4 review fixes, editing: a turn or mirror on one side and a framing edit on the other (crop, keyframes, offsets, aspect, keyframes of waiting photos) are one merge conflict at the orientation member, settled with that side's framing; the derived top-level `version` is no settings difference while both are at most this Chronos's; a quarter turn transposes the aspect text without reducing it (21:9 → 9:21); an out-of-range crop is turned as it renders (clamped first); off-grid crop and keyframe values land on the 12-decimal grid at their first press and the keyframe centre sliders write gridded values; the Rotation row shows the turn as seen (reversed while exactly one of Mirror and Flip is on); Reset framing undoes the orientation press by press so keyframes and aspect stay on their content; the look strength minimum is 1 % and 0 or less clears the look; motion vectors are computed without the look and the knee; the horizon advisor maps its rows through turn, flip, straighten and cover zoom (the mirror moves only columns); inside a box with no slack a press pans while zoomed and the middle button always pans; the selected box shows a 2 px Accent ring; translations of keys whose English meaning changed are deleted (English fallback) instead of new keys. (Owner review 1, phase 4.) | — | Simplest safe choices for the review's findings. |
| 2026-11-04 | Project text is written with LF on every OS (`NewLine = "\n"` in the `ProjectJson` source-gen options and in `ProjectSettings.IndentedJson`), so a project's canonical text and content hash are the same on Windows and on the Linux server. Versions already stored keep their text and hash (a Windows build's are CRLF): `ProjectContent.SameChoices` compares both texts with CRLF read as LF (lossless: a raw CR or LF in the JSON is whitespace between tokens), and the places that ask "is this text that version" (the workspace's tip and base, the head a render names, the render job's version, the send's matching version, the history's current marker) use `ProjectContent.MatchesHash`, true for the hash of the text's LF or CRLF form. Integrity checks (`Verifies` of a stored or pushed version, stored hash against stored hash) stay exact. The other indented JSON writers (`AdvisorJson`, `ArchiveJsonIndented`, `WorkspaceJson`, `WorkspaceMoveJson`, the `ProjectBundle` writer, settings files) feed no project hash and are left as they are. | LF only, comparisons exact | With LF alone, every version a Windows build stored would stop matching the text the new build writes: unchanged projects would read as modified at the upgrade. |
+21 -18
View File
@@ -14,9 +14,9 @@ by its `windows` job once a Windows runner is registered (`WINDOWS_RUNNER`), and
| 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, server image in the Gitea container registry, optional separate releases repository), 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). The installer test (silent install of the packed installers, run, upgrade in place, uninstall: files, Add/Remove Programs, shortcuts, file type, user data kept, exit codes) runs in CI's `windows` job on a Windows runner. Pending: the interactive install on a real PC, Unraid template validation on a real server. |
| 8.1 Owner review 1 | In progress (request, answers and plan: `docs/requests/2026-10-15-owner-review-1.md`). Phase 1 done: stalled thumbnail and proxy jobs no longer fail and stay Running (frame-counted progress, bounded time left, final state always written); the editor's cancelled decodes stay in their tasks (no debugger stops in `WicDecoderProvider.cs`); WIC decodes RAW only through the Raw Image Extension and never DNG; GoPro DNGs converted by Adobe software are DNGs, developed natively for videos, read through their embedded preview for analyses and previews, and reclassified in existing archives by the next light analysis. Phase 2 done: jobs run one at a time on the desktop and the server; Parallelism is how many photos the running job processes at once (thumbnail and proxy passes, tier probes, deep analysis, render decodes); pausing the running job starts the next; an optional priority queue by job kind (Settings › Rendering, admin panel › Settings › Jobs, `CHRONOS_PRIORITY_QUEUE`) pauses lower jobs and resumes them by themselves; `CHRONOS_PARALLELISM` replaces `CHRONOS_WORKERS`. Phase 3a done: the rail is 200 px and collapses to icons with ≡ or Ctrl+B (tooltips then name the sections, the choice saved at once); the admin panel's sidebar is 256 px and collapses the same way. Phase 3b done: the Sequence section is now Edit, one sequence at a time chosen in a picker inside the section (Change sequence, Ctrl+O; the sequence edited last selected first), and the editor's tabs are the steps of a guided, freely navigable path from a new Analysis step (every finding with the step that deals with it) to Export, each step showing where it stands, with Previous and Next. Next, after owner review 2 (the owner's order): phase 4, the visual crop locked to the output's proportions (R5) and mirroring, 90° rotations, straightening and colour filters (R6). |
| 8.1 Owner review 1 | In progress (request, answers and plan: `docs/requests/2026-10-15-owner-review-1.md`). Phase 1 done: stalled thumbnail and proxy jobs no longer fail and stay Running (frame-counted progress, bounded time left, final state always written); the editor's cancelled decodes stay in their tasks (no debugger stops in `WicDecoderProvider.cs`); WIC decodes RAW only through the Raw Image Extension and never DNG; GoPro DNGs converted by Adobe software are DNGs, developed natively for videos, read through their embedded preview for analyses and previews, and reclassified in existing archives by the next light analysis. Phase 2 done: jobs run one at a time on the desktop and the server; Parallelism is how many photos the running job processes at once (thumbnail and proxy passes, tier probes, deep analysis, render decodes); pausing the running job starts the next; an optional priority queue by job kind (Settings › Rendering, admin panel › Settings › Jobs, `CHRONOS_PRIORITY_QUEUE`) pauses lower jobs and resumes them by themselves; `CHRONOS_PARALLELISM` replaces `CHRONOS_WORKERS`. Phase 3a done: the rail is 200 px and collapses to icons with ≡ or Ctrl+B (tooltips then name the sections, the choice saved at once); the admin panel's sidebar is 256 px and collapses the same way. Phase 3b done: the Sequence section is now Edit, one sequence at a time chosen in a picker inside the section (Change sequence, Ctrl+O; the sequence edited last selected first), and the editor's tabs are the steps of a guided, freely navigable path from a new Analysis step (every finding with the step that deals with it) to Export, each step showing where it stands, with Previous and Next. Phase 4 done, to be released as `v0.1.0-rc.12` (issue #19; one adversarial review round, 30 findings, all confirmed and fixed, and a final check that fixed one more; strings in all 38 languages; 31 screenshot baselines accepted): the crop edited on the preview with eight handles, always locked to the output's aspect, in the view frame, by mouse, keyboard (Enter selects) and Crop size/X/Y (R5); the chosen proportions win: a fixed-size preset is a box the aspect is fitted in (`RenderSize`: 4K at 9:16 = 2160×3840), "source" keeps the preset, *Output size* on the Export step; Rotation (quarter turns), Mirror, Flip and Straighten (±15°, automatic cover zoom, the grid while it moves) in the Camera step inside the one warp (`FrameOrientation`), a turn or mirror keeping the content (`OrientationEdit`: crop, keyframes, transposed aspect), Reset framing; eight built-in colour looks with a strength at the end of the Exposure step, after stacking and before the knee (`LookFilter`, `FrameFinish`), the same in the render, on the server, render nodes and the preview; settings format 2 written only while a transform or look is used (`ProjectSettings.RequiredFormat`), read-only in older builds; `server/info` and node registrations announce the settings format, jobs carry the one they need (`RenderRules.RequiredFormat`), and nothing an older server or node would get wrong is sent to it (Sync, Send and render, the Library's Render, a remote editor's save); encoder limits read either way round; the advisor on the view as shown. Also fixed on the way (issue #20): project text is LF on every OS, stored CRLF versions compare equal. Known limitations: an older desktop renders a chosen aspect at the preset's ratio on its own; the server's settings format is cached for a minute; the new Camera rows and the Straighten slider binding have no on-screen test. Next: phase 5 (issue #21), phase 6 (issue #22), then `v1.0.0` (issue #23). |
| 8.2 Chronos on Gitea | Done (request: `docs/requests/2026-10-23-chronos-gitea.md`): Titano renamed Chronos everywhere, translations' grammar included; repository, update check, links, issue forms and registry moved to the self-hosted Gitea; Gitea Actions CI, release, nightly image and performance workflows for the Linux runner, with the Windows programs cross-compiled and checked (`pe-check`); new `Chronos.Tools` commands `zip`, `gitea-release`, `postgres-ci`, `pe-check`. Pre-releases `v0.1.0-rc.1` and `v0.1.0-rc.2` (the update check builds its links from `ChronosReleasesUrl`, since Gitea's use its LAN ROOT_URL) published; `REGISTRY_TOKEN` is set and the `v0.1.0-rc.2` server image is in the registry. |
| 8.3 Owner review 2 | In progress (request, answers and plan: `docs/requests/2026-10-26-owner-review-2.md`). Phase 1 done and released as `v0.1.0-rc.3` (one adversarial review round, 19 findings fixed; strings in all 38 languages): `:latest` follows the highest stable release, or the highest pre-release while none is stable (`Chronos.Tools release-channels`), `:nightly` stays the nightly build of `main` (R1); `CHRONOS_SPACE_PATH` and the Unraid template's *Array view* (`/mnt/user0/<share>` read-only at `/space`) make the admin panel show the array's free space, the cache apart as *Write volume*, the file system in the tooltip, and completing an upload checks the archive volume first (507, resumable) (R2); the Settings icon is a toothed gear and the admin panel docks Settings at the foot of its sidebar (R4); About is the last page of Settings on the desktop and the last group of Settings on the admin panel (R5); Import › Folder… › *Whole folder* imports a folder as one sequence per format, titled after the folder (R9). Phase 2 done and released as `v0.1.0-rc.4` (one adversarial review round, 35 findings fixed; strings in all 38 languages): scheduled jobs (R10) — schedules (migration 0007) with an in-house recurrence form, one scheduler per host claiming runs by compare-and-set with catch-up, and Jobs › Scheduled on the desktop and the admin panel (`/api/v1/schedules`, `scheduleChanged`); every timer that queued work is a visible system schedule (server: archive scan, upload clean-up every 6 h, index backup at 03:00, job history and audit log clean-ups; desktop: archive scan, daily index backup, housekeeping with cache trim), the archive still scanned at start; new Backup and Clean-up jobs, duplicates and orphans reports as jobs, one backup retention, the trash only reported; log settings (R11) — file and console levels, retention, file and total size limits, daily or hourly rotation, audit retention (the audit clean-up schedule's) and the diagnostics share in the admin panel's Settings › Logs (`CHRONOS_LOG_*`, `lockedBy`) and the desktop's Settings › Advanced; the server's files take Debug and Trace again, and logging never fails a job. Phase 3 done and released as `v0.1.0-rc.5` (one adversarial review round and two fix rounds, 40 findings fixed; strings in all 38 languages; Library, photo delete and restore and the web upload tried by hand): the admin panel manages and never edits (R6) — a Library page (facets filters, cards or list, keyboard selection, mass Analyse, Proxies, Thumbnails, Verify, Tags, Export CSV and Delete, 1,000 sequences a request), a sequence's page (inline title, tags, rating, notes, photo viewer, cover, downloads, photo delete) and the trash view (Restore, Empty… behind a dry run, the typed word and a fingerprint); photos deleted into `trash/photos` under crash-safe journals with tombstones in the sidecar and `frame_removals` (migration 0008), so sync and uploads never bring them back unless restored or uploaded again on purpose; trash kinds, restore reasons and the `EmptyTrash` job on the desktop's Trash… too (typed entry count); the panel's files revalidated (`no-cache`, ETag); upload from the panel (R3) — file picker or drop, no folders, a self-tested in-house SHA-256 in a module worker, Exif capture time, resumable chunks. Known limitations: a never-hashed photo whose file was already missing is deleted without a tombstone; an unhashed server frame of a photo deleted on a PC stays *missing here* until the server verifies it; `jobState` carries no kind, so panel pages refresh after any job. Phase 4a done and released as `v0.1.0-rc.6` (one adversarial review round and six fix rounds; strings in all 38 languages): Reorganize after import (R7) on the desktop (Archive manager, Library, the toast after Settings › Archive templates change; it replaces Rename… and Move…) and the admin panel (Library, the *Saved* toast of Archive) — folder, file and title templates applied to filed sequences behind a dry run that lists every change, the photos that keep their names and why (in place, never verified, missing) and the sequences that stay whole (unreadable sidecar), applied by the `move` job of exactly the confirmed plan (fingerprint, `POST /api/v1/archive/reorganize`, plans kept a few minutes on the server), which holds the rest when paused, cancelled or failed (also while the archive is offline), lets a sequence still receiving photos keep its file names and takes along a sequence left as it was inside a folder that moves; files renamed in two phases under `.chronos/rename-files.json`, completed after a crash by the next writer; the index, frames and exports follow a moved folder in one transaction, here and at another index's next scan, and writers never create a folder a Reorganize left nor write into one another sequence took; import, upload and Reorganize name photos by one rule (the sequence's camera and lens), and templates follow one set of rules everLine truncated
| 8.3 Owner review 2 | Done (request, answers and plan: `docs/requests/2026-10-26-owner-review-2.md`). Phase 1 done and released as `v0.1.0-rc.3` (one adversarial review round, 19 findings fixed; strings in all 38 languages): `:latest` follows the highest stable release, or the highest pre-release while none is stable (`Chronos.Tools release-channels`), `:nightly` stays the nightly build of `main` (R1); `CHRONOS_SPACE_PATH` and the Unraid template's *Array view* (`/mnt/user0/<share>` read-only at `/space`) make the admin panel show the array's free space, the cache apart as *Write volume*, the file system in the tooltip, and completing an upload checks the archive volume first (507, resumable) (R2); the Settings icon is a toothed gear and the admin panel docks Settings at the foot of its sidebar (R4); About is the last page of Settings on the desktop and the last group of Settings on the admin panel (R5); Import › Folder… › *Whole folder* imports a folder as one sequence per format, titled after the folder (R9). Phase 2 done and released as `v0.1.0-rc.4` (one adversarial review round, 35 findings fixed; strings in all 38 languages): scheduled jobs (R10) — schedules (migration 0007) with an in-house recurrence form, one scheduler per host claiming runs by compare-and-set with catch-up, and Jobs › Scheduled on the desktop and the admin panel (`/api/v1/schedules`, `scheduleChanged`); every timer that queued work is a visible system schedule (server: archive scan, upload clean-up every 6 h, index backup at 03:00, job history and audit log clean-ups; desktop: archive scan, daily index backup, housekeeping with cache trim), the archive still scanned at start; new Backup and Clean-up jobs, duplicates and orphans reports as jobs, one backup retention, the trash only reported; log settings (R11) — file and console levels, retention, file and total size limits, daily or hourly rotation, audit retention (the audit clean-up schedule's) and the diagnostics share in the admin panel's Settings › Logs (`CHRONOS_LOG_*`, `lockedBy`) and the desktop's Settings › Advanced; the server's files take Debug and Trace again, and logging never fails a job. Phase 3 done and released as `v0.1.0-rc.5` (one adversarial review round and two fix rounds, 40 findings fixed; strings in all 38 languages; Library, photo delete and restore and the web upload tried by hand): the admin panel manages and never edits (R6) — a Library page (facets filters, cards or list, keyboard selection, mass Analyse, Proxies, Thumbnails, Verify, Tags, Export CSV and Delete, 1,000 sequences a request), a sequence's page (inline title, tags, rating, notes, photo viewer, cover, downloads, photo delete) and the trash view (Restore, Empty… behind a dry run, the typed word and a fingerprint); photos deleted into `trash/photos` under crash-safe journals with tombstones in the sidecar and `frame_removals` (migration 0008), so sync and uploads never bring them back unless restored or uploaded again on purpose; trash kinds, restore reasons and the `EmptyTrash` job on the desktop's Trash… too (typed entry count); the panel's files revalidated (`no-cache`, ETag); upload from the panel (R3) — file picker or drop, no folders, a self-tested in-house SHA-256 in a module worker, Exif capture time, resumable chunks. Known limitations: a never-hashed photo whose file was already missing is deleted without a tombstone; an unhashed server frame of a photo deleted on a PC stays *missing here* until the server verifies it; `jobState` carries no kind, so panel pages refresh after any job. Phase 4a done and released as `v0.1.0-rc.6` (one adversarial review round and six fix rounds; strings in all 38 languages): Reorganize after import (R7) on the desktop (Archive manager, Library, the toast after Settings › Archive templates change; it replaces Rename… and Move…) and the admin panel (Library, the *Saved* toast of Archive) — folder, file and title templates applied to filed sequences behind a dry run that lists every change, the photos that keep their names and why (in place, never verified, missing) and the sequences that stay whole (unreadable sidecar), applied by the `move` job of exactly the confirmed plan (fingerprint, `POST /api/v1/archive/reorganize`, plans kept a few minutes on the server), which holds the rest when paused, cancelled or failed (also while the archive is offline), lets a sequence still receiving photos keep its file names and takes along a sequence left as it was inside a folder that moves; files renamed in two phases under `.chronos/rename-files.json`, completed after a crash by the next writer; the index, frames and exports follow a moved folder in one transaction, here and at another index's next scan, and writers never create a folder a Reorganize left nor write into one another sequence took; import, upload and Reorganize name photos by one rule (the sequence's camera and lens), and templates follow one set of rules everywhere Line truncated
| 9 Monetization | Not started: requires explicit approval (§22). |
## Verification (2026-10-12)
@@ -117,6 +117,12 @@ src/Chronos.App/bin/Release/net10.0-windows/Chronos.exe --capture out/screenshot
*Run now*: projects in sync and not opened for a week lose their media (the job log says which and why others were
kept), and open again by copying them. *Move…* to another drive shows its plan; the *Move workspace* job copies and
checks every file, then Settings shows the new folder. *Trash* › *Empty…* lists the entries and asks for their number.
- Crop, transforms and looks: Edit › Camera › Aspect 9:16, then drag the box on the preview and one of its handles: the
ratio stays locked; Enter, arrows and + / − nudge it, Esc gives the arrows back. *Rotate right*, *Mirror* and
Straighten 3°: the box keeps the content and the grid shows while the slider moves. Exposure › *Look* › Sepia at 60 %,
compared with the wipe. Export › 4K: *Output size* reads 2160 × 3840 while the preset keeps its name; render it and
check the file. Open the project in 0.1.0-rc.11: it is read-only. Against a server of 0.1.0-rc.11, *Sync* and
*Render* are disabled with their reason; with only a node of 0.1.0-rc.11 online, the job is not given to it.
- Project files: Export › *Save project file* writes a `.chronos` file; opening it (double-click or `Chronos.exe <file>`)
opens the sequence with those settings in the running Chronos, given to its Main project in the workspace.
- Notifications: minimise Chronos and insert a card or finish a job: a Windows notification appears; Ctrl+1…6 and
@@ -127,31 +133,28 @@ src/Chronos.App/bin/Release/net10.0-windows/Chronos.exe --capture out/screenshot
## Next steps
Owner reviews, in the owner's order (owner review 2 first, then the rest of owner review 1); each phase ends with a
release (owner review 2, R12):
The rest of owner review 1, in the owner's order; each phase ends with a release (owner review 2, R12):
1. Owner review 2, phase 5c: release
`v0.1.0-rc.11` (the PR green on Gitea Actions, squash-merge, tag, the Docker image and the Windows programs) and
update the memory notes. That ends owner review 2.
2. Owner review 1, phase 4: R5 visual crop locked to the output's proportions, R6 mirroring, 90° rotations,
straightening and colour filters (project settings in the workspace).
3. Owner review 1, phase 5: R3 export panel and Render menu, R8 export options, R9 videos library.
4. Owner review 1, phase 6: Docker, Unraid and deploy docs, BRIEF §24 amendments, full verification.
5. Each of phases 4–6 released as a release candidate (`v0.1.0-rc.12` onwards); then `v1.0.0`, the first stable
release (owner review 3, R4).
1. Owner review 1, phase 4 (issue #19): release `v0.1.0-rc.12` (the PR green on Gitea Actions, squash-merge, tag, the
Docker image and the Windows programs) and update the memory notes.
2. Owner review 1, phase 5 (issue #21): R3 export panel and Render menu, R8 export options, R9 videos library;
released as `v0.1.0-rc.13`.
3. Owner review 1, phase 6 (issue #22): Docker, Unraid and deploy docs, BRIEF §24 amendments, full verification;
released as a release candidate.
4. `v1.0.0` (issue #23), the first stable release (owner review 3, R4).
Phase 8 gate:
6. Visibility: make the `BalboSoft` organisation (and its packages) public, or publish to a public `RELEASES_REPO`, so
5. Visibility: make the `BalboSoft` organisation (and its packages) public, or publish to a public `RELEASES_REPO`, so
that people without an account can download releases, get update notices and pull the image.
7. Windows runner: register an act_runner in host mode on a Windows PC (.NET SDK, Git for Windows, PowerShell 7) and
6. Windows runner: register an act_runner in host mode on a Windows PC (.NET SDK, Git for Windows, PowerShell 7) and
set the repository variable `WINDOWS_RUNNER` to its label. The screenshot baselines in `tests/visual/baselines`
were captured on the development PC (2026-11-04): register the runner on that PC, or accept a new set captured on
the runner's PC (its README says how). From then on a visual change, or a screen without a baseline, fails the
`windows` job.
8. On Windows: install the latest pre-release's setup, upgrade over the previous version, uninstall (with and without
7. On Windows: install the latest pre-release's setup, upgrade over the previous version, uninstall (with and without
user data), silent mode.
9. Unraid: install the template as a user template (README › Server image, Compose and Unraid) with the official
8. Unraid: install the template as a user template (README › Server image, Compose and Unraid) with the official
PostgreSQL template, check that its icon (the SVG of `branding/`) shows, reach the WebUI, and that the Dashboard
shows the array's free space through *Array view*.
10. Native-speaker review of the machine translations where users report wording (`i18n export` per language).
9. Native-speaker review of the machine translations where users report wording (`i18n export` per language).
+1 -1
View File
@@ -61,7 +61,7 @@
| 2 | R2 jobs one at a time, Parallelism = photos at once, priority queue with automatic pause/resume (desktop + server) | done 2026-10-16: BRIEF §12.8, §14.6, §14.8, §14.9, §24; nine DECISIONS rows dated 2026-10-16 (engine, priority queue, parallel passes and decode budget, sequential IO jobs, server settings, `i18n prune`, Jobs toolbar, atomic writes that wait for a reader, leases taken after a reader lets go); five adversarial review rounds before the commit; levels per kind rather than an ordered list (DECISIONS) | `43b6871` |
| 3a | R1 rail 200 px and admin sidebar 256 px, both collapsing to icons with ≡ or Ctrl+B | done 2026-10-16: BRIEF §12.1, §14.8, §24; one DECISIONS row; DESIGN and every mockup with a rail or the admin sidebar; the two new admin tooltips in all 38 languages. Six adversarial review rounds (desktop and web, each finding verified; the last found only two wording slips, fixed): buttons and labels cut at 1200 px beside the wider rail in some languages (Jobs row actions, Forget, Clear, the preview's Play, a remote job's Cancel, Merge, a year in the Archive tree), Ctrl+B behind the first-run dialog and on non-Latin keyboards, and admin tables not re-fitted after a toggle, all fixed; some older cut texts found on the way got tooltips; tests now check those rows in all 38 languages. Phase 3 lands as two commits because R1 and R7 edit the same shell files and R1 was finished and verified first | `4ea44bb` |
| 3b | R7 Edit section ("Sequenza" → "Modifica"), sequence picker, guided path from analysis to export | done 2026-10-16: BRIEF §4.1, §10.2, §12.1, §12.3, §24; four DECISIONS rows (the rename, the path, the step rules, the picker); DESIGN §4 step bar and §7; `Editor.html` with the step bar and every mockup's rail label; `i18n/GLOSSARY.md` and the 36 language glossaries (Edit, Path, Step, Findings); the new strings in all 38 languages | `5aeb6aa` |
| 4 | R5 visual crop, proportions win; R6 transforms, straighten, colour filters | todo | |
| 4 | R5 visual crop, proportions win; R6 transforms, straighten, colour filters | done 2026-11-04, to be released as `v0.1.0-rc.12` (issue #19; one adversarial review round, 30 findings, all confirmed and fixed, and a final check that fixed one more; strings in all 38 languages; 31 screenshot baselines accepted; the line-end fix of issue #20 on the way): BRIEF §10.3, §11.2, §11.4, §12.3, §14.3, §14.7, §24; 32 DECISIONS rows dated 2026-11-04 (conditional settings format and the rule for future members; orientation members and order; the cover zoom; crop coordinates; the locked crop; a quarter turn keeps the content; proportions win, also for an advised aspect, not format-gated in storage; routing format and the server's announcement; the colour look and its values; no ninth step; raw thumbnails; Source framing; global only; the compatibility matrix; groundwork details; crop values; the advisor on the view; routing errors; encoder limits either way round; desktop gates; the crop on the preview; Camera, Look and Export rows; visuals; strings, icons and captures; the review's routing, gates and editing fixes); CHANGELOG [Unreleased] with the upgrade note and the known limitations, and the 5c entries under [0.1.0-rc.11]; ARCHITECTURE geometry, colour, render size and format, gates; DESIGN setting rows, crop overlay and icons; STATUS 8.1 | this PR |
| 5 | R3 export panel and Render menu; R8 export options; R9 videos library (desktop, server API, admin page, copy folder, trash) | todo | |
| 6 | Docker/Unraid/deploy docs, BRIEF §24 amendments, full verification | todo | |
+1 -1
View File
@@ -76,7 +76,7 @@
| 4b | R7 mass conversion | done 2026-11-02, released as `v0.1.0-rc.7` (one adversarial review round, 42 findings, and two fix rounds; strings in all 38 languages): BRIEF §5, §7, §8.1, §8.3, §8.7, §9, §12.2, §12.4, §12.5, §13, §14.3, §14.4, §14.5, §14.8, §14.9, §24; 26 DECISIONS rows dated 2026-10-26 (R7 conversion after import, import still byte for byte; Replace or New sequence at every run, never remembered; targets and the scene-referred archival DNG; the conversion's decoder order, managed first and no 16-bit file from an 8-bit RAW development; the TIFF reader's refusals; colour profiles carried, converted or refused; the converted files' Exif; a dry run that probes what it promises; exactly the confirmed photos, by digest and ids; the two-stage, resumable job; the purge of staging and journals; free space measured where the conversion writes; no conversion of the same sequences twice; New sequence holding the converted copies alone, saying what it lacks; the Replace swap; the replace journal decided by content; Undo by the job's own entries; replaced entries weighed against the archive on disk; every last copy named before the typed confirmation; sync aliases as equivalence classes; link by content, proxies and downloads following them; the ingest taking a replaced original as present; the plan cache shared with Reorganize; the convert API; the `convert` job kind; failure sentences by cause), four earlier rows marked superseded in part; CHANGELOG [0.1.0-rc.7] with the upgrade note and the known limitations; STATUS 8.3 | `efa87f68` |
| 5a | R8 workspace and projects with a local home (migration 0009) | done 2026-11-03, released as `v0.1.0-rc.8` on 2026-11-04 (one adversarial review round, 55 findings, and five fix rounds; strings in en and it, the 36 other languages still to translate): BRIEF §4.4, §5, §7, §12.2, §12.3, §12.6, §12.8, §14.5, §14.6, §24; 46 DECISIONS rows dated 2026-11-03 (R8 projects and versions in the index by migration 0009; the sidecars as the truth; the portable form with positions parked by photo and canonical text; placing by photo; unknown members kept; a newer settings format read only; project file format 2; the 64 MiB limits; Main mirroring the settings and `project.json`; the Main catch-up merge; a mirror never written over settings it has not taken in; deletion from the trash read first, late versions moved beside it; lost and behind records; one Main; push rules; `IProjectHome`; the workspace folder and its write order; versions set aside and pruned; conflicts and Save both naming; media learning names; the frames stamp; Gone and Damaged states; newer and damaged copies; Edit opening workspace projects; editor saves; sync; Kept versions; Remove local copy; Delete project; the workspace copy job and its cancel clean-up; renders with project and version; `.chronos` files; the picker; Settings › Workspace; texts; `IWorkspaceUi`; leases), five earlier rows marked superseded in part; CHANGELOG [0.1.0-rc.8] with the migration 0009 upgrade note and the known limitations; STATUS 8.3 | `9b24cf74` |
| 5b | R8 server home | done 2026-11-04, released as `v0.1.0-rc.10` on 2026-11-04 (one adversarial review round, 21 findings, 19 fixed, and a final check that settled the Server screen's row buttons and the capture's paths, 16 baselines recaptured; strings in all 38 languages): BRIEF §4.4, §7, §12.2, §12.3, §12.7, §14.3, §14.5, §14.7, §14.8, §24; 40 DECISIONS rows dated 2026-10-26 (R8 the server home on the archive's `ProjectService`, errors mapped to Offline, refusals and API errors; a deleted project's head 404; `too_large` and `projects_unreadable`; change sets told after the lease; pruning by read-back; the copy from a server; texts of the server; renders of what the server holds; Edit opening server sequences; 404 `not_found` with details; push results; the pushing account as author; numbered version pages; delete rights and Main's rename; `sequenceChanged` with Main's mirror; `ProjectCatchUp`; events to every subscriber; render jobs and nodes of a project version; the `projects` capability; the frames answer; the panel's Projects section; `HomePhotos` public; the sign-in as the only way to a server home; the server's archive id; the copy's download and metered rule; `ServerJobs`; the older server's disabled action; review fixes: the frames stamp, sequences without photos, the settings `PATCH` under the lease, push and page size limits, the maker's account, rescans and read-only catch-ups told, missed changes told once the stream is back, server renames followed, the stored check, the `.thumb` marker, viewers with proxies, the editor following the sign-in), three earlier rows marked superseded in part; CHANGELOG [0.1.0-rc.10] with the upgrade note and the known limitations; STATUS 8.3 | `81c303f4` |
| 5c | R8 originals, local render, clean-up, Workspace settings | done 2026-11-04, to be released as `v0.1.0-rc.11` (one adversarial review round, 35 findings, 32 confirmed and fixed, compat-2 in part, and a final check that fixed one more; strings in all 38 languages): BRIEF §4.4, §5, §12.3, §12.7, §12.8, §14.3, §14.5, §14.6, §24; 31 DECISIONS rows dated 2026-11-04 (R8 the three job kinds and no migration; originals in the workspace, their naming and the copy; media index format 2 and project file format 3; originals judged by their bytes; Proxies only and Copy originals; a cancelled originals copy; server copy facts; Open project; the page's defaults and layout; usage measures; the local render; the ledger and contained paths; the version a render records; Version on render; routing and toasts; the follow-up send of every unsent render and Send again; per-render refusals; the version pushed first or mapped by content hash; filing in an archive home; render provenance on a server; Pause metered transfers; clean-up eligibility and order; Clean after and Size limit; the `workspace-cleanup` schedule; the workspace's trash with `.incoming-` staging; Remove local copy with renders and originals; the move plan; the move journal and copy; a move's failure and cancel; jobs, the move gate and Resume; strings pruned), four earlier rows marked superseded in part; CHANGELOG [Unreleased] with the upgrade note and the known limitations, and the 5b entries under [0.1.0-rc.10]; ARCHITECTURE job kinds and workspace types; STATUS 8.3 | |
| 5c | R8 originals, local render, clean-up, Workspace settings | done 2026-11-04, released as `v0.1.0-rc.11` on 2026-11-04 (one adversarial review round, 35 findings, 32 confirmed and fixed, compat-2 in part, and a final check that fixed one more; strings in all 38 languages): BRIEF §4.4, §5, §12.3, §12.7, §12.8, §14.3, §14.5, §14.6, §24; 31 DECISIONS rows dated 2026-11-04 (R8 the three job kinds and no migration; originals in the workspace, their naming and the copy; media index format 2 and project file format 3; originals judged by their bytes; Proxies only and Copy originals; a cancelled originals copy; server copy facts; Open project; the page's defaults and layout; usage measures; the local render; the ledger and contained paths; the version a render records; Version on render; routing and toasts; the follow-up send of every unsent render and Send again; per-render refusals; the version pushed first or mapped by content hash; filing in an archive home; render provenance on a server; Pause metered transfers; clean-up eligibility and order; Clean after and Size limit; the `workspace-cleanup` schedule; the workspace's trash with `.incoming-` staging; Remove local copy with renders and originals; the move plan; the move journal and copy; a move's failure and cancel; jobs, the move gate and Resume; strings pruned), four earlier rows marked superseded in part; CHANGELOG [Unreleased] with the upgrade note and the known limitations, and the 5b entries under [0.1.0-rc.10]; ARCHITECTURE job kinds and workspace types; STATUS 8.3 | `db389a54` |
Each phase updates BRIEF (amended paragraphs), DECISIONS, CHANGELOG, STATUS and this file, and ends with a release
(R12).
+2 -2
View File
@@ -43,5 +43,5 @@ Two screenshots came with it: the Unraid template (repository `chronos-server:ni
| Phase | Content | State | Commit |
|---|---|---|---|
| 1 | R1 ports, R2 baselines | done 2026-11-04, released as `v0.1.0-rc.9` (one review round with two reviewers and a checker; strings in all 38 languages): BRIEF §12.7, §14.8, §14.9, §19.6; DECISIONS rows dated 2026-11-04 (public ports as settings, the settings DTO members, the container port lock, saved listening ports removed, the client address, one address rule, the Chronos identity checks, the HTTP port typed as HTTPS, the zone index, Host networking, baselines from the development PC, fixed capture values); CHANGELOG [Unreleased] with the Unraid upgrade note | `255e1490` |
| 2 | R4 owner review 2 phases 5b and 5c | 5b done 2026-11-04, released as `v0.1.0-rc.10` (`81c303f4`); 5c in progress: done 2026-11-04, to be released as `v0.1.0-rc.11` | `81c303f4` (5b) |
| 3 | R4 owner review 1 phases 4–6, then `v1.0.0` | todo | |
| 2 | R4 owner review 2 phases 5b and 5c | done 2026-11-04: 5b released as `v0.1.0-rc.10` (`81c303f4`), 5c as `v0.1.0-rc.11` (`db389a54`) | `81c303f4` (5b), `db389a54` (5c) |
| 3 | R4 owner review 1 phases 4–6, then `v1.0.0` | in progress: phase 4 done 2026-11-04, to be released as `v0.1.0-rc.12` (issue #19); phases 5 (#21) and 6 (#22) and `v1.0.0` (#23) todo | |
+1 -1
View File
@@ -150,7 +150,7 @@ from the SVG geometry (no raster assets checked in as sources). Badges only at
| Mockup | Brief | Notes |
|---|---|---|
| `Main.html` | §12.2 Library | grid/list, year·camera·status filters, selection panel |
| `Editor.html` | §12.3 Edit | three parts, one below the other. Exposure step: step bar, title ▾ (Change sequence), wipe compare (the corrected side carries the look), curves, advisor Auto pills, the Look group (Filter, Strength) at the end of the panel, Previous · n / m · Next. Camera step (`#camera`): the whole view frame with a 9:16 crop being edited (handles), the zoom-keyframe curve under the filmstrip, rows Aspect · Rotation (Rotate left/right and the value) · Mirror · Flip · Straighten · Crop size · Crop X · Crop Y, the keyframes line, then Optimise section · Reset framing · Reset (Reset framing disabled, with `ResetFramingNone`, when nothing is set). Crop overlay states: Shown, Editable, Dragging, Straightening, Locked |
| `Editor.html` | §12.3 Edit | three parts, one below the other. Exposure step: step bar, title ▾ (Change sequence), wipe compare (the corrected side carries the look), curves, advisor Auto pills, the Look group (Filter, Strength) at the end of the panel, Previous · n / m · Next. Camera step (`#camera`): the whole view frame with a 9:16 crop being edited (handles), the zoom-keyframe curve under the filmstrip, rows Aspect · Rotation (Rotate left/right and the value) · Mirror · Flip · Straighten · Crop size · Crop X · Crop Y, the keyframes line, then Reset framing on its own line (three buttons do not fit the 292 px panel) above Optimise section · Reset (Reset framing disabled, with `ResetFramingNone`, when nothing is set). Crop overlay states: Shown, Editable, Dragging, Straightening, Locked |
| `Export.html` | §12.3 / §11.4 | the Export step: step bar with Export current, preset cards with size/time estimate, Output panel, batch, Previous · 8 / 8 · Next sequence. Resolution edits the preset's box; the **Output size** row under it shows what is rendered: the chosen proportions fitted in the box (4K at 9:16 = 2160 × 3840; "source" keeps the preset), the preset name unchanged; when the encoder caps it, the value reads "1296 × 2304 (capped)" with `Tooltips.Editor.Export.OutputCapped`. The preview mask is the output's footprint in the view frame |
| `Import.html` | §12.4 / §13 | card profile, sessions, plan, verification, after-import actions |
| `Archive.html` | §12.5 | tree, mass operations, stats, verify/rebuild, maintenance |
+3 -1
View File
@@ -238,9 +238,11 @@ a{color:#4cc2ff}a:hover{color:#8ad8ff}
<button aria-label="Remove keyframe" disabled title="Select a keyframe on the curve first" style="width: 28px; height: 28px; padding: 0; border: 1px solid #3e404a; border-radius: 6px; background: #2f3038; color: #f2f3f5; font: inherit; opacity: 0.4">−</button>
</div>
<span style="flex-grow: 1"></span>
<div style="display: flex; justify-content: flex-end">
<button title="Clears the crop, rotation, mirror, flip and straighten; keyframes stay on their content" style="height: 32px; padding: 0 12px; border: 1px solid #3e404a; border-radius: 6px; background: transparent; color: #a9aeb9; font: inherit; cursor: pointer">Reset framing</button>
</div>
<div style="display: flex; gap: 8px">
<button title="Apply the advisor's heavier choices for this section and list what changed" style="flex-grow: 1; height: 32px; border: 1px solid #3e404a; border-radius: 6px; background: #2f3038; color: #f2f3f5; font: inherit; cursor: pointer">Optimise section</button>
<button title="Clears the crop, rotation, mirror, flip and straighten; keyframes stay" style="height: 32px; padding: 0 12px; border: 1px solid #3e404a; border-radius: 6px; background: transparent; color: #a9aeb9; font: inherit; cursor: pointer">Reset framing</button>
<button title="Return every control of this section to Auto" style="height: 32px; padding: 0 12px; border: 1px solid #3e404a; border-radius: 6px; background: transparent; color: #a9aeb9; font: inherit; cursor: pointer">Reset</button>
</div>
</aside>