dspv · dspv · Sep 2, 2026 · Sep 2, 2026
diff --git a/docs/feat-breakdown-light.png b/docs/feat-breakdown-light.png
diff --git a/docs/feat-breakdown.png b/docs/feat-breakdown.png
diff --git a/docs/feat-cap-light.png b/docs/feat-cap-light.png
diff --git a/docs/feat-cap.png b/docs/feat-cap.png
diff --git a/docs/feat-limits-light.png b/docs/feat-limits-light.png
diff --git a/docs/feat-limits.png b/docs/feat-limits.png
diff --git a/docs/feat-projects-light.png b/docs/feat-projects-light.png
diff --git a/docs/feat-projects.png b/docs/feat-projects.png
diff --git a/docs/shot-cost-light.png b/docs/shot-cost-light.png
diff --git a/docs/shot-cost.png b/docs/shot-cost.png
diff --git a/docs/shot-history-light.png b/docs/shot-history-light.png
diff --git a/docs/shot-history.png b/docs/shot-history.png
diff --git a/docs/shot-now-light.png b/docs/shot-now-light.png
diff --git a/docs/shot-now.png b/docs/shot-now.png
diff --git a/docs/shot-tasks-light.png b/docs/shot-tasks-light.png
diff --git a/docs/shot-tasks.png b/docs/shot-tasks.png
diff --git a/scripts/feature-shots.py b/scripts/feature-shots.py
@@ -89,9 +89,28 @@ def main():
         for theme in ("dark", "light"):
             for name, route, needle, _why in SHOTS:
                 rpc(ws, "Page.navigate", {"url": f"{BASE}/#/{route}"})
-                time.sleep(3.5)
+                # Wait for the panel rather than for the clock. A fixed pause
+                # was enough on a small database and silently was not on a real
+                # one: every shot failed with "no element matching", which
+                # reads like a renamed panel and is really a screen that had
+                # not finished fetching. Also put the first-run banners away,
+                # or they push the panel down and the clip lands on the strip
+                # above it.
+                evaluate(ws, """
+                  try {
+                    localStorage.setItem('caprock.update.dismissed', 'offer');
+                    const t = Date.now();
+                    localStorage.setItem('caprock-prompts', JSON.stringify({
+                      'premium-banner': t, 'premium-hint': t, 'share-month': t,
+                    }));
+                  } catch (e) {}
+                """)
                 evaluate(ws, f"localStorage.setItem('caprock-theme','{theme}');location.reload()")
-                time.sleep(3.5)
+                for _ in range(60):
+                    time.sleep(0.4)
+                    if evaluate(ws, f"document.body.innerText.includes({json.dumps(needle)})"):
+                        break
+                time.sleep(2.0)   # let the bars and numbers paint
 
                 # Find the panel whose heading matches, and take its box. The
                 # walk goes up to the panel container so the border and title
@@ -115,15 +134,18 @@ def main():
                     print(f"  !! {name}: no element matching {needle!r} on /{route}")
                     continue
 
-                pad = 12
+                # Asymmetric padding: 12px is right on three sides, but at the
+                # top it reached into the panel above and clipped a button in
+                # half, which reads as a broken screenshot rather than a crop.
+                pad, pad_top = 12, 2
                 shot = rpc(ws, "Page.captureScreenshot", {
                     "format": "png",
                     "captureBeyondViewport": True,
                     "clip": {
                         "x": max(0, box["x"] - pad),
-                        "y": max(0, box["y"] - pad),
+                        "y": max(0, box["y"] - pad_top),
                         "width": min(WIDTH, box["w"] + pad * 2),
-                        "height": box["h"] + pad * 2,
+                        "height": box["h"] + pad + pad_top,
                         "scale": 2,
                     },
                 })

diff --git a/scripts/refresh-shots.sh b/scripts/refresh-shots.sh
@@ -52,6 +52,27 @@ echo "→ snapshotting the database (read-only; the live one is untouched)"
 mkdir -p "$WORK/data"
 sqlite3 "$DATA_DIR/caprock.db" ".backup '$WORK/data/caprock.db'"
 
+# Carry over the plan, and nothing else from the config.
+#
+# The plan lives in config.json rather than the database, so a throwaway data
+# directory has none — and the header then shows "set plan" lit as an unfinished
+# action, which is the first thing a reader of the README sees: an instruction
+# to configure something they have not been told about yet. Three fields, copied
+# by name. Never the whole file: it also holds the report bot token.
+if [ -f "$DATA_DIR/config.json" ]; then
+  python3 - "$DATA_DIR/config.json" "$WORK/data/config.json" <<'PLAN'
+import json, sys
+src, dst = sys.argv[1], sys.argv[2]
+try:
+    d = json.load(open(src))
+except Exception:
+    sys.exit(0)
+keep = {k: d[k] for k in ("plan_kind", "plan_label", "plan_usd_per_month") if k in d}
+if keep:
+    json.dump(keep, open(dst, "w"), indent=2)
+PLAN
+fi
+
 # The published binary, not a working tree build: the header carries the
 # version, and a README showing "dev build" tells the reader they are looking
 # at something unreleased. CAPROCK_SHOT_BIN overrides it for testing an

diff --git a/scripts/shots.py b/scripts/shots.py
@@ -252,13 +252,39 @@ def main():
         ws = create_connection(ws_url, timeout=30)
         rpc(ws, "Page.enable"); rpc(ws, "Runtime.enable")
 
+        # Put the first-run prompts away before the first render, not after it.
+        #
+        # Both banners are answered from localStorage at mount, so writing the
+        # keys once the screen is up changes nothing that is already on it —
+        # and the navigations that follow are hash changes, which do not reload
+        # the document and so never re-read the flag. The result was two
+        # dismissable strips across the top of every capture, taking a sixth of
+        # the frame before a single figure appeared. Set the keys against the
+        # origin, then load the document once so they are read.
+        rpc(ws, "Page.navigate", {"url": f"{BASE}/#/now"})
+        time.sleep(1.5)
+        evaluate(ws, """
+          try {
+            localStorage.setItem('caprock.update.dismissed', 'offer');
+            const t = Date.now();
+            localStorage.setItem('caprock-prompts', JSON.stringify({
+              'premium-banner': t, 'premium-hint': t, 'share-month': t,
+            }));
+          } catch (e) {}
+        """)
+
         for theme in ("dark", "light"):
             for route, name in SHOTS:
+                # Navigating to the same document with a different hash does
+                # not reload it, and the dismissal flags above are only read as
+                # the document boots. Go by way of about:blank so each capture
+                # is a real load *of its own route* — Page.reload would reload
+                # the document at its default route and lose the hash, which
+                # silently made every shot the Now screen.
+                rpc(ws, "Page.navigate", {"url": "about:blank"})
+                time.sleep(0.3)
                 rpc(ws, "Page.navigate", {"url": f"{BASE}/#/{route}"})
                 time.sleep(1.5)
-                # Dismiss the update banner: a first-run prompt, not a feature,
-                # and it pushes the dashboard down in every capture.
-                evaluate(ws, "try{localStorage.setItem('caprock.update.dismissed','offer')}catch(e){}")
                 # Toggle to the theme we want by clicking the control, which is
                 # what a person does. Writing to storage only takes effect on
                 # the next document load, and a hash navigation is not one.