diff --git a/docs/requirements/007-resources-view.md b/docs/requirements/007-resources-view.md index f7d7576..b95d92e 100644 --- a/docs/requirements/007-resources-view.md +++ b/docs/requirements/007-resources-view.md @@ -54,9 +54,16 @@ flowchart TD ### View store -- [ ] A GET and PUT of `/api/view` round-trip; a malformed body, an unknown - key or more than 64 KiB answers 400 and stores nothing. -- [ ] A PUT needs no passkey and leaves the signed settings file +- [ ] A GET and a PATCH of `/api/view` round-trip; a PATCH sets only the + paths it names, each against the value the page last saw there (409 + when another browser changed it meanwhile); a malformed body, an + unknown key, a body over 129 KiB (both values of a path at the cap + plus 1 KiB) or a document that would grow past 64 KiB answers 400 and + stores nothing, while a list at the cap can still shrink. Lists change + only by a function re-run on the stored value, scalars by replacement. + A page restored from the back-forward cache fetches the view again; a + change sent while leaving the page is dropped when it meets a 409. +- [ ] A PATCH needs no passkey and leaves the signed settings file byte-identical. - [ ] The store is written atomically with mode 0600 and survives a hub restart. diff --git a/docs/requirements/008-home-dashboard.md b/docs/requirements/008-home-dashboard.md index 3a5d776..549d48f 100644 --- a/docs/requirements/008-home-dashboard.md +++ b/docs/requirements/008-home-dashboard.md @@ -87,7 +87,8 @@ flowchart TD - [ ] Unit: registry lookup, layout validation, reorder math. - [ ] Integration: `/api/view` accepts the pins schema and refuses an - oversize or malformed one. + oversize or malformed one; a PATCH whose `expect` no longer matches + the stored pins gets 409, so two tabs never overwrite each other. - [ ] E2E: Chromium and Firefox at 1920, 1366 and 390: star and unstar, resize, reorder by drag and keyboard, the gone tile, the start tab; screenshots for the checkpoint.