docs(platform): regenerate usage review captures for the round two fixes

Recaptured all 34 states at 1280, 1000, 390 and 320 px (136 captures)
from the components in this branch and recomposed the comparison pairs.
New pair 34 shows the paywall for a trial whose first charge failed;
pairs 04, 22, 23, 25 and 33 describe the new behavior.

The fixture gives the payment failed trial an open invoice. The source
manifest now leaves out third-party files under node_modules, so it lists
the same 175 repository sources wherever dependencies are installed and
verify.mjs passes on any checkout. These captures use Playwright's
Chromium 141, so screens whose components did not change differ from the
previous set only in text antialiasing.

Co-authored-by: Claude Opus 5.5 (Claude Code) <[email protected]>
Claude-Session: https://claude.ai/code/session_01StgD1TkCx1ku4bjHh7t4VZ

docs/engineering/usage-experience/README.txt

@@ -5,7 +5,7 @@ Every After panel is a browser screenshot of the actual components in this PR.
 There are no independently designed mockups in this directory. The component
 code is the source of truth: regenerate the images whenever that code changes.
 
-comparisons/ contains all 33 compact before/after pairs. implementation/ contains
+comparisons/ contains all 34 compact before/after pairs. implementation/ contains
 the actual after screenshots, including the six original review filenames.
 The complete capture manifest records source hashes, screenshot hashes, visible
 copy, controls, viewport dimensions, fixture data, and verified browser cleanup.

docs/engineering/usage-experience/comparisons/comparison-manifest.json

@@ -14,7 +14,7 @@
         665
       ],
       "beforeSha256": "5b280e7c87d9ee5283f1c13e7f0a4e85292396ed995fea1e3d714834559c275c",
-      "afterSha256": "ea6160c2b4fc3a2f08463e2f4ce59875d895edbd7c741f79ce9181d91ce43bbc"
+      "afterSha256": "fb400343c0dd3ea0e1289aa2b5cf1beb68ff880a08067263525dfc53c2ebcdf7"
     },
     {
       "id": "02-trial-chat",
@@ -28,7 +28,7 @@
         426
       ],
       "beforeSha256": "2c92970044e77257761bed7fbbf39411e9dd3bc5190d6bd503164665be973d6f",
-      "afterSha256": "4a32aa3c7fcc18ef3b89aa7e666ecf6c49bd630e0fce60d8edb0954f26223d6d"
+      "afterSha256": "416ee4dfe80f1a8113ba588234ba0b1e94d5aa401aea46a09b36234a33445df3"
     },
     {
       "id": "03-trial-billing",
@@ -42,21 +42,21 @@
         648
       ],
       "beforeSha256": "6a5b4b9e660438be219a16d14525f5caed5f0c156e33bc4a75904c68f1dd705c",
-      "afterSha256": "4051a82a0e99dfb216ca9d3841b6a89206fc544318502ac78625c73ac5b99d2b"
+      "afterSha256": "8f475a273cbd5c9d38da9030faa6cb02cd4b1475ff150817f8afa812164533db"
     },
     {
       "id": "04-trial-active",
       "title": "Trial \u00b7 allowance remaining",
-      "improvement": "One percentage for the whole trial, with an end date instead of a reset timer.",
+      "improvement": "One trial meter with its end date. The Pro card keeps the price and start date, and only suggests starting early once usage runs low.",
       "note": null,
       "before": "04-trial-active.png",
       "after": "04-trial-active-1280.png",
       "dimensions": [
         1000,
-        648
+        635
       ],
       "beforeSha256": "87bc6a72e432d40185e28c28a39b4a48d09131c27a2f9431d0a0f312983dd414",
-      "afterSha256": "18563de26cacfc396ce90c0a967b2a04098d2068f9a5d0afec9502b9ac7b89bc"
+      "afterSha256": "2f80942c5a9fce63ad1e2363e7480ae4b3d4c0d4ef6256ca48a453f09b99da6a"
     },
     {
       "id": "05-pro-popup",
@@ -67,10 +67,10 @@
       "after": "05-pro-popup-1280.png",
       "dimensions": [
         1000,
-        713
+        631
       ],
       "beforeSha256": "5b280e7c87d9ee5283f1c13e7f0a4e85292396ed995fea1e3d714834559c275c",
-      "afterSha256": "969a59a54d57d87c8b8559370ed37a7cf4468abd3b5679b5373d0e24713c517e"
+      "afterSha256": "60de54ff0c61ceab1034496edc5ee2586276be241e285c41d120b00cf7c63648"
     },
     {
       "id": "06-pro-chat",
@@ -84,7 +84,7 @@
         426
       ],
       "beforeSha256": "0df0bbd028dfe74b6179cd695077ee88abfd079a00482ca4d618fb23f0e7fd00",
-      "afterSha256": "a55029444de16df66b25de3a408984ad3ac5399aa5ed66a522c78d9410a13463"
+      "afterSha256": "0a57d95c83fc8aee73f4d1f90258f610cb7ad8e987fbbee7a4a271351b3dd154"
     },
     {
       "id": "07-pro-billing",
@@ -98,7 +98,7 @@
         596
       ],
       "beforeSha256": "5beb2242c8fbb474624a3bb24a5eaa8d0512d29fb47db5da9db971407ac3b500",
-      "afterSha256": "db12ea8b4262c6ff4afaca78f939c2b737c5b33f69ae78e5973c3cba4adad8da"
+      "afterSha256": "fcef65467cec4680701a1285fd3bfead08a88c863a3a40bcd98b99bfce30052a"
     },
     {
       "id": "08-pro-weekly",
@@ -109,10 +109,10 @@
       "after": "08-pro-weekly-1280.png",
       "dimensions": [
         1000,
-        713
+        631
       ],
       "beforeSha256": "29f2ec0a523b21e93e19e5fe3b5210fa6c1d61614671023850c06b1b1dca9152",
-      "afterSha256": "1420706e354dc39ee5f20ecde32cf896ee2bc88ed250b73126df2e2b6b9ec12d"
+      "afterSha256": "cad87582a7889e00103035dc29b33ae54f51983ced3db3500ae1939de53737cc"
     },
     {
       "id": "09-max-popup",
@@ -123,10 +123,10 @@
       "after": "09-max-popup-1280.png",
       "dimensions": [
         1000,
-        510
+        439
       ],
       "beforeSha256": "969a571edfc77046209d85955d44353e8ed16810ead2c679ef6dea90a4eadc5a",
-      "afterSha256": "48a342885f93c81fe7123b0f94476712c2847e2f89675b9db2ba296b50eb0b1f"
+      "afterSha256": "887c833cb70979bca26a0441de4d02dbe99541e41f04036a9a9097dc3cfa1421"
     },
     {
       "id": "10-max-chat",
@@ -140,7 +140,7 @@
         426
       ],
       "beforeSha256": "2147c1b42edc130bc117d48ba73550e4406f7b355e4ec70436522b04d7db504f",
-      "afterSha256": "7bcd7ed39b3248c702c470c1533ff3e963cea3cb502c2043c0d6678b320a01b2"
+      "afterSha256": "7028f8197f9b538606d87f70857084e50dd51d7e0b0eb75008361319f82879d9"
     },
     {
       "id": "11-max-billing",
@@ -154,7 +154,7 @@
         596
       ],
       "beforeSha256": "f294599582d4f57305085e0207af9f3fe3e2333518c001fbd0f5daba0707ccdd",
-      "afterSha256": "ee99139757e15c3a20a34fd53649f86cbc0f273d3c0eabd8bb0f187944616835"
+      "afterSha256": "c635cca338e874bbf17170d6a753d8814218d1bddae941b841caa528554063cb"
     },
     {
       "id": "12-team-popup",
@@ -165,10 +165,10 @@
       "after": "12-team-popup-1280.png",
       "dimensions": [
         1000,
-        510
+        439
       ],
       "beforeSha256": "efde33219e8a1dfe60d7954ae99807d74ab360ae7ca6d901b5e84e16c043dc8a",
-      "afterSha256": "8df01910ff98bb174050ae28ce8c6871f0f955a3f5dfa47d03e1adde714e9f99"
+      "afterSha256": "e23c7f36dac9815172a28644ed89420c2e180a63554af308a41c0ffd16adf297"
     },
     {
       "id": "13-team-billing",
@@ -182,7 +182,7 @@
         596
       ],
       "beforeSha256": "9d397967d9ed3ace2b61554d7d0df5c9fd94cbcde3e397aa486d74e1cdd37ca0",
-      "afterSha256": "e2cd8c659406dd34f25728570643f3a0cf1265756486cdd9a847a240dc5502e1"
+      "afterSha256": "850f48cb96e2b4ceeb2551bb10f4826be11fe4ca0cd32eaafad54b166c8cab55"
     },
     {
       "id": "14-enterprise-popup",
@@ -193,10 +193,10 @@
       "after": "14-enterprise-popup-1280.png",
       "dimensions": [
         1000,
-        510
+        439
       ],
       "beforeSha256": "969a571edfc77046209d85955d44353e8ed16810ead2c679ef6dea90a4eadc5a",
-      "afterSha256": "efc40b9cb5621a45e4095b8c5cfdda3e3941ab8020c60b0b5f27d5cef669bb30"
+      "afterSha256": "971840d60ff4c3b49ff5ff1bf63f1f873bb6b9f764ee0ae9ec37ffe24eb13130"
     },
     {
       "id": "15-enterprise-billing",
@@ -210,7 +210,7 @@
         602
       ],
       "beforeSha256": "5fbc6b0bc4f30ab4723923a9703fe6e398b5458846e4af38d1d7ef89a009b5f2",
-      "afterSha256": "2676ac04bc3adb6d2dcdeb955b3c0738d1b525354a384dfa29865bc83be14f9d"
+      "afterSha256": "0c889f9b53694de5dccbbd26bf566cd6558f31aafbc858dc739778850e294fee"
     },
     {
       "id": "16-basic-chat",
@@ -224,7 +224,7 @@
         358
       ],
       "beforeSha256": "bdd1279339732d57531b7436276f8bd364d909a51d653969dc139991c1e6df06",
-      "afterSha256": "1ddbf8f12ddb6a1f862aec1614373c26b2b6bef17390201ef2f59dbb5c8095ea"
+      "afterSha256": "1435316043f0b6e33d2ca3c85b5486ebdeb5c091847d794b8b80c867f1626f2d"
     },
     {
       "id": "17-basic-billing",
@@ -238,7 +238,7 @@
         592
       ],
       "beforeSha256": "12472630b7222b7049bc813b41e56511c8e4a94bff5aa75e0680ae26a300ccf8",
-      "afterSha256": "9a50c6a6eceb7d89d26d0a11086dfb077314d22b67a05bcf5d0633c7417d1658"
+      "afterSha256": "b1aa875867d2bd2a8b446a533e89e6df4f567a2f081dc3bdad7c3d0516692673"
     },
     {
       "id": "18-choose-plan",
@@ -252,7 +252,7 @@
         760
       ],
       "beforeSha256": "6b65d10495606bbd4f80dc80d3d6dcbb1382d5ed1b06086ce62d4e5424e01708",
-      "afterSha256": "b1100af369e0155e1849d9676f53b4b6ca7b10cbd2e88fe483dd003f051d2a9b"
+      "afterSha256": "c92f5938493f5ac14e1614202a673f1ae09ed6a8321c0daca7e98278a13c9f8b"
     },
     {
       "id": "19-no-plan-billing",
@@ -266,7 +266,7 @@
         728
       ],
       "beforeSha256": "6b65d10495606bbd4f80dc80d3d6dcbb1382d5ed1b06086ce62d4e5424e01708",
-      "afterSha256": "9b6e5b4f07b76b1e379010e4037c1be2746fefa298c38b1a1e66536bc81f18d5"
+      "afterSha256": "42bf6fae10e09046bd5f9af486c5b1584ee65a670ae95a334810841976f83df6"
     },
     {
       "id": "20-trial-ended",
@@ -280,7 +280,7 @@
         338
       ],
       "beforeSha256": "78db56f76874f6833ee6c52eccdf2976cc9b700fcd00f7bb2f3078d79618af5d",
-      "afterSha256": "1349af8ec025972bfb515f5c1bbc40781b7965c1aff4e7faeeea30dc0d69e2ee"
+      "afterSha256": "50b7366d5ab9f382f138d5fe763c92a7c2e8c4defdf644196bb1e04a515ee496"
     },
     {
       "id": "21-trial-canceled",
@@ -294,35 +294,35 @@
         338
       ],
       "beforeSha256": "6434f9151bdee8ad7e20f859a0605491047a153b9f5244596a22ff990ac93372",
-      "afterSha256": "1096eb8e7fdd104404834485cf72f6f4a9b8fa6a8e2292bb18ac83568d0f9069"
+      "afterSha256": "628b5c7a495f7135e5998d56dc34cf715b80dc48aab86f6c46381ee3f357289d"
     },
     {
       "id": "22-payment-failed",
       "title": "Payment failure \u00b7 recovery",
-      "improvement": "A dedicated action to recover the existing subscription.",
-      "note": "Before: existing payment-method management card; production has no equivalent recovery popup.",
+      "improvement": "State the amount owed and pay the open trial invoice on Stripe in one step, instead of a plan checkout that is refused while the invoice is open.",
+      "note": "Before: existing payment-method management card; production has no equivalent recovery popup. After: the button opens the open trial invoice on Stripe\u2019s hosted page.",
       "before": "22-payment-failed.png",
       "after": "22-payment-failed-1280.png",
       "dimensions": [
         1000,
-        338
+        344
       ],
       "beforeSha256": "8aa37c901955301e2f4c2fb86bf3bea782beee2304ea65285acd710c7c194b1c",
-      "afterSha256": "e3d814bf99c088bd73911e021de91a55658b797a7c9b72fb17723060551ec6d8"
+      "afterSha256": "cca6e57237bfba0aef36194f8135879fe7daa5d71840a2a6ab9b54a57175ffae"
     },
     {
       "id": "23-payment-billing",
       "title": "Payment failure \u00b7 settings",
-      "improvement": "Bring payment recovery into the plan and usage summary.",
+      "improvement": "One message with the amount and one button that pays the open invoice. No refused Start Pro checkout and no duplicate payment cards.",
       "note": "Before: generic Pro billing; no dedicated payment-failure state. After: recovery only when billing confirms suspended access.",
       "before": "23-payment-billing.png",
       "after": "23-payment-billing-1280.png",
       "dimensions": [
         1000,
-        626
+        560
       ],
       "beforeSha256": "b81ba25f4d295eca8ce9156cf2d9cc6d52cf185459687749d2b8948c7e936872",
-      "afterSha256": "622820a03d9f2c545fc719f77c96da4c37a13aa5a939f40944834d1e32c210d4"
+      "afterSha256": "feb5ff34f9d31f1ca62bc3f54900013c9b6079e8586a42cbb73b9ee830b142f9"
     },
     {
       "id": "24-usage-unavailable",
@@ -336,21 +336,21 @@
         326
       ],
       "beforeSha256": null,
-      "afterSha256": "ba39d2205940cb080cdedb3c6a57ea27ac9155f98fcf9cc119f22cff53cd0bdc"
+      "afterSha256": "f1df2e88ade62d8dc7856fc735b920444f793581a341c0f78977c87bc98fe74e"
     },
     {
       "id": "25-unavailable-billing",
       "title": "Usage unavailable \u00b7 settings",
-      "improvement": "Keep a visible usage error and retry action instead of silently removing the section.",
+      "improvement": "One usage error with a retry in the Usage slot, while the plan card beside it stays as usual.",
       "note": null,
       "before": "25-unavailable-billing.png",
       "after": "25-unavailable-billing-1280.png",
       "dimensions": [
         1000,
-        549
+        574
       ],
       "beforeSha256": "dacae8acfc0e7632e9b989c28d71d6e8ee99047c0100997b47064bcde85acdf0",
-      "afterSha256": "e86ea73c2e261ba14dd2c37fc7cff6b569a5597e3884fb1d4a8996f7cbc77528"
+      "afterSha256": "f4bae0106e3962b816c49134350b31f4622aa470d68d6ec2740e1de610e64a57"
     },
     {
       "id": "26-linked-provider",
@@ -364,7 +364,7 @@
         338
       ],
       "beforeSha256": "07f5d39dbd1f7f3cf4f6397e5cd7487d13a29af5a81a193a43aa664ed9b36e21",
-      "afterSha256": "3fb58c71c9167b115d45fd382881cb5bb91ba52ff9054c71ac4de450cd706d0c"
+      "afterSha256": "100b75f1331d193b3ad9cc7678bc81903dbd0a16cdb3435cce3b5920cc7c1301"
     },
     {
       "id": "27-pro-review",
@@ -378,7 +378,7 @@
         760
       ],
       "beforeSha256": null,
-      "afterSha256": "2ff5ce900f4904f2b562d7ddbf0987e7a30db5c21b43ab21ac3c5691ed6ed2cc"
+      "afterSha256": "196cd2b3ecaa842b602464b823d7d464b0fa4c8b25f75cf9f6a36a9e044f6a54"
     },
     {
       "id": "28-max-review",
@@ -392,7 +392,7 @@
         760
       ],
       "beforeSha256": "23c82133524a7e015712f15d8bdd3d388fac05d18be1cca412ea5743d5bb7d32",
-      "afterSha256": "94dec0b39249658766489b9529eed398bee173c4d19c9d1e19bed0ae3522fb4d"
+      "afterSha256": "d45ca16bc0abdcd17e12b30109db087e7e4ba6b96f9e4451a9667fbb9a54813d"
     },
     {
       "id": "29-payment-pending",
@@ -406,7 +406,7 @@
         447
       ],
       "beforeSha256": null,
-      "afterSha256": "71ef024ba75b15c1de65b038d863bdda7a23d8089ded7048cb5170d14b477ca5"
+      "afterSha256": "1938946db2cd002db163c9699c2ec01fd1350331fbce8e0dacaa634daeec264b"
     },
     {
       "id": "30-activation-success",
@@ -420,7 +420,7 @@
         344
       ],
       "beforeSha256": "a2024d072f55884882a306dcfb3fa19d41a74cac036015e552081bb947f5176e",
-      "afterSha256": "48e7bd613f39e33a8898b84e67abc3fd7c93e0db592de910e190e31981f49f8c"
+      "afterSha256": "89fb0a46572a9207d5f9073da96891c7c57eeca6b51827134517a2f31f93950b"
     },
     {
       "id": "31-fresh-billing",
@@ -434,7 +434,7 @@
         596
       ],
       "beforeSha256": "b81ba25f4d295eca8ce9156cf2d9cc6d52cf185459687749d2b8948c7e936872",
-      "afterSha256": "3ea7d0e7459b52ba01d566e6454d8d2adf51bb24a1ddb4c6355d77f038721efd"
+      "afterSha256": "0b9e08518e51f4b4ac9a1e852ef2903e336ddad55a6a5ea5e5854869990a4250"
     },
     {
       "id": "32-cancel-pending-billing",
@@ -448,12 +448,12 @@
         720
       ],
       "beforeSha256": null,
-      "afterSha256": "608bd48cfd7ea4e0d65abcd2c45b63f31080d826937ab22810b31194b466a945"
+      "afterSha256": "a442ae9ab635f0a166ba4a55ab06741652d18a1b269ad76d02e94d5b951448ee"
     },
     {
       "id": "33-cancel-pending-notice",
       "title": "Trial cancellation pending \u00b7 chat notice",
-      "improvement": "Choose a plan explicitly after cancellation; never promise that Pro will start automatically.",
+      "improvement": "Choose a plan explicitly after cancellation with Subscribe now, the label of the plan cards it opens; never promise that Pro will start automatically.",
       "note": null,
       "before": null,
       "after": "33-cancel-pending-notice-1280.png",
@@ -462,7 +462,21 @@
         326
       ],
       "beforeSha256": null,
-      "afterSha256": "3b43e1dbb898eade6b600d94aa154fa12382c33664858016144b475821ca9320"
+      "afterSha256": "711a415e2d87b1a1e8acd8529126d62630812282f7bf4bad54b4ef8f9434a703"
+    },
+    {
+      "id": "34-payment-paywall",
+      "title": "Payment failure \u00b7 paywall",
+      "improvement": "Past-due trials see the same message and pay button in the paywall instead of plan choices whose checkout is refused.",
+      "note": null,
+      "before": null,
+      "after": "34-payment-paywall-1280.png",
+      "dimensions": [
+        1000,
+        462
+      ],
+      "beforeSha256": null,
+      "afterSha256": "5bfc366ca87a0805b096f88d3b797c4862e6939defb9268ff9c39d703b49e92f"
     }
   ]
 }