docs(tiles): a reload's fill ranks without pending approvals, by design

A page reload puts a stored open grid back inside handleInit and fills a
cell freed since (its session deleted while the grid was closed) from the
ranking. Pending approvals, the source of the needs-input group, reach the
page only through seedApprovals, an async GET that lands after the restore,
so for that one fill a session waiting on a permission dialog or an unseen
finished turn ranks with the quiet ones (working sessions still rank first).

Holding the fill back until the seed lands would open fewer tiles, which
can be another shape, and then reshape the grid and move the user's tiles a
moment after the reload, so a late seed never re-forms a restored grid. The
plan, architecture-invariants#tile-grid and the wiki now say so, and a test
pins it: the seed arrives after the restore, the ranking then puts the
needs-input session first, and the restored cells and the stored layout
stay as they came back.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Codeman maintainer
2026-10-10 06:31:26 +02:00
parent 7b95856cc5
commit fb5c1bfca5
4 changed files with 67 additions and 6 deletions
+5 -3
View File
@@ -137,9 +137,11 @@ removing a tile, changing the count, focusing or zooming a tile), and never sent
server. However you leave it (the Tiles button, another tab, Home, a link, closing its last
tile or session), the Tiles button and a page reload bring it back as it was. A session
that was closed in the meantime frees its place for another one, picked the way a new grid
picks them; the place stays empty only when no other session is left. If the window has
become too small for all the tiles, the tile you were in fills the grid until the window is
wide enough again, and the rest of the layout is kept.
picks them; the place stays empty only when no other session is left. Right after a page
reload the page does not know yet which sessions are waiting for your answer, so that pick
goes by which sessions are working and which you used last. If the window has become too
small for all the tiles, the tile you were in fills the grid until the window is wide enough
again, and the rest of the layout is kept.
Split shows the same logo, name and model above both of its panes.