Extend hue-sort runbook to all 34 color collections (cov_<hue> now written for all 14 hues, 127,880 metafields)

af6f41a944001d7e0e6a0251821997ccbbcbb0de · 2026-06-15 15:06:30 -0700 · Steve Abrams
Files touched

M docs/boost-hue-sort-runbook.md
Diff

commit af6f41a944001d7e0e6a0251821997ccbbcbb0de
Author: Steve Abrams <steve@designerwallcoverings.com>
Date:   Mon Jun 15 15:06:30 2026 -0700

    Extend hue-sort runbook to all 34 color collections (cov_<hue> now written for all 14 hues, 127,880 metafields)
---
 docs/boost-hue-sort-runbook.md | 80 ++++++++++++++++++++++++++++++++----------
 1 file changed, 61 insertions(+), 19 deletions(-)

diff --git a/docs/boost-hue-sort-runbook.md b/docs/boost-hue-sort-runbook.md
index 56c9493..84fe59e 100644
--- a/docs/boost-hue-sort-runbook.md
+++ b/docs/boost-hue-sort-runbook.md
@@ -62,20 +62,53 @@ payload. Requires Boost dashboard login (Boost AI Search & Filter, bc-solutions.
 4. Boost → **Merchandising / Collections** → select the collection →
    set **Default sort = `Solid → Sparse`**.
 
-### Collection → metafield mapping (the 10 giants)
-
-| Collection handle | Metafield | products tagged |
-|---|---|---|
-| `beige-wallcoverings` | `custom.cov_beige` | 23,599 |
-| `white-wallcovering-collection` | `custom.cov_white` | (white total 21,796) |
-| `white-wallcoverings` | `custom.cov_white` | ″ |
-| `grey-wallcovering` | `custom.cov_gray` | (gray total 14,647) |
-| `gray-wallcoverings` | `custom.cov_gray` | ″ |
-| `brown-wallpaper-collection` | `custom.cov_brown` | 8,151 |
-| `green-wallpaper-collection` | `custom.cov_green` | 10,809 |
-| `yellow-wallpaper-collection` | `custom.cov_yellow` | 10,899 |
-| `blue-wallpaper-collection` | `custom.cov_blue` | (blue total 9,946) |
-| `blue-wallpaper` | `custom.cov_blue` | ″ |
+### Collection → metafield mapping (ALL 34 color collections)
+
+`custom.cov_<hue>` is now written for every color collection's members (127,880
+metafields total across 14 hues), so **every** collection below can use Boost
+server-side sort — not just the giants. Set each one's default sort to its hue's
+metafield, High → Low.
+
+| Collection handle | Metafield |
+|---|---|
+| `beige-wallcoverings` | `custom.cov_beige` |
+| `white-wallcovering-collection` | `custom.cov_white` |
+| `white-wallcoverings` | `custom.cov_white` |
+| `white-wallpaper-collection` | `custom.cov_white` |
+| `grey-wallcovering` | `custom.cov_gray` |
+| `gray-wallcoverings` | `custom.cov_gray` |
+| `silver-wallcoverings` | `custom.cov_gray` |
+| `brown-wallpaper-collection` | `custom.cov_brown` |
+| `brown-wallcoverings` | `custom.cov_brown` |
+| `green-wallpaper-collection` | `custom.cov_green` |
+| `green-wallcoverings` | `custom.cov_green` |
+| `green-wall-textures` | `custom.cov_green` |
+| `yellow-wallpaper-collection` | `custom.cov_yellow` |
+| `yellow-wallcovering-collection` | `custom.cov_yellow` |
+| `yellow-wallcoverings` | `custom.cov_yellow` |
+| `blue-wallpaper-collection` | `custom.cov_blue` |
+| `blue-wallpaper` | `custom.cov_blue` |
+| `blue-wallcoverings` | `custom.cov_blue` |
+| `navy-wallcoverings` | `custom.cov_blue` |
+| `metallic-wallpaper-collections` | `custom.cov_gold` |
+| `metallic-wallpaper-collection` | `custom.cov_gold` |
+| `gold-wallcoverings` | `custom.cov_gold` |
+| `black-wallcoverings` | `custom.cov_black` |
+| `teal-wallcoverings` | `custom.cov_teal` |
+| `pink-wallcovering-2` | `custom.cov_pink` |
+| `pink-wallcovering-collection` | `custom.cov_pink` |
+| `pink-wallcoverings` | `custom.cov_pink` |
+| `red-wallpaper-collection` | `custom.cov_red` |
+| `red-wallcoverings` | `custom.cov_red` |
+| `red-wallcovering-collection` | `custom.cov_red` |
+| `orange-wallcovering-collection` | `custom.cov_orange` |
+| `orange-wallcoverings` | `custom.cov_orange` |
+| `purple-wallcovering-collection` | `custom.cov_purple` |
+| `purple-wallcoverings` | `custom.cov_purple` |
+
+Per-hue metafield counts: beige 23,599 · white 21,796 · gray 14,647 · yellow 10,899 ·
+green 10,889 · blue 9,946 · gold 8,572 · brown 8,151 · black 4,813 · pink 4,094 ·
+teal 3,646 · red 3,613 · orange 1,967 · purple 1,248.
 
 Products without the metafield (image had ~0% of that hue) sort to the tail — correct.
 
@@ -101,12 +134,21 @@ curl -s -X POST https://designer-laboratory-sandbox.myshopify.com/admin/api/2024
 
 ---
 
-## Optional future: retire the client-side interim entirely
+## Retire the client-side interim (prerequisite now DONE)
 
-If you want ONE consistent mechanism, write all 14 scalar `cov_<hue>` metafields
-for every color collection (not just the 7 giant hues) and point every color
-collection's Boost default sort at its hue — then `hc-*.js` + `newwall-huesort.js`
-can be dropped from `theme.liquid`. Generators (reusable, idempotent, $0):
+All 14 scalar `cov_<hue>` metafields are written for every color collection
+(127,880 total) — so the data prerequisite is satisfied. To switch fully to one
+consistent server-side mechanism:
+
+1. In Boost, set every collection in the table above to its `custom.cov_<hue>`
+   default sort (High → Low).
+2. Once all are set and verified, drop the client block from `layout/theme.liquid`
+   (the `color_handles` assign + the `hc-<handle>.js` + `newwall-huesort.js` script
+   tags) and re-push — Boost then owns the sort everywhere, page 1 through the tail.
+
+Do step 2 ONLY after step 1 is confirmed live, or collections briefly lose the sort.
+
+Generators (reusable, idempotent, $0):
 
 - `/tmp/cov_scalar_fanout.py` — writes `custom.cov_<hue>` from `/tmp/hue_computed.jsonl`
   via Admin GraphQL cursor enumeration (NOT storefront products.json — that HTTP-400s
← 26d7765 Add Boost hue-sort runbook (Half A client-side + Half B serv · back to Dw Yolo Loop · Stage banned-word Wallpaper->Wallcovering rewrite PLAN + AI- 6e2c6a1 →