docs: fix the dev config gap and the removed ARGB settings

Two defects found while running Task 4, both confirmed against the
conky build rather than assumed.

Task 4's development config defined color1..color7 and default_color
but not default_shade_color, which palette() reads for the card fill,
so following the plan verbatim drew every card in the magenta sentinel.
The config now carries it, with a note saying why it is required.

own_window_argb_visual has been REMOVED in conky 1.24 (ARGB is always
on when available) and own_window_argb_value is deprecated; both warn
on this build. Replaced with own_window_colour '#AARRGGBB', which emits
no warnings. In the template that value follows the palette through a
new @BODY_SHADE_RAW@ placeholder, the shade colour without its leading
'#', so a scheme switch recolours the window backdrop too rather than
pinning it to one hardcoded hex.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

1 files changed, 20 insertions, 4 deletions

diff --git a/docs/superpowers/plans/2026-09-16-conky-lua-dashboard.md b/docs/superpowers/plans/2026-09-16-conky-lua-dashboard.md
index 2055224..6fea570 100644
--- a/docs/superpowers/plans/2026-09-16-conky-lua-dashboard.md
+++ b/docs/superpowers/plans/2026-09-16-conky-lua-dashboard.md
@@ -507,8 +507,11 @@ conky.config = {
   own_window = true,
   own_window_type = 'normal',
   own_window_class = 'conky-dash',
-  own_window_argb_visual = true,
-  own_window_argb_value = 200,
+  -- Translucency via own_window_colour '#AARRGGBB'. NOT own_window_argb_visual
+  -- (removed in conky 1.24: ARGB is always on when available) nor
+  -- own_window_argb_value (deprecated); both emit warnings on this build.
+  -- c8 = 200/255 alpha.
+  own_window_colour = '#c8181926',
   minimum_width = 1200,
   minimum_height = 700,
   double_buffer = true,
@@ -528,6 +531,9 @@ conky.config = {
   color6 = '#a6da95',  -- ok
   color7 = '#ed8796',  -- critical
   default_color = '#cad3f5',  -- body
+  -- Required: palette() reads this for the card fill. Omit it and every card
+  -- draws in hex()'s magenta sentinel.
+  default_shade_color = '#1e2030',  -- body shade
 }
 
 -- Empty: Cairo output covers conky.text entirely, verified by experiment.
@@ -805,8 +811,13 @@ conky.config = {
   -- Distinct from the plain 'Conky' class used by any desktop-layer instance,
   -- so the windowrules for one cannot match the other.
   own_window_class = 'conky-dash',
-  own_window_argb_visual = true,
-  own_window_argb_value = 200,
+  -- Translucency via own_window_colour '#AARRGGBB'. NOT own_window_argb_visual
+  -- (removed in conky 1.24: ARGB is always on when available) nor
+  -- own_window_argb_value (deprecated); both emit warnings on this build.
+  -- c8 = 200/255 alpha.
+  -- c8 = 200/255 alpha. The colour follows the palette: @BODY_SHADE@ with its
+  -- leading '#' stripped, so a scheme switch recolours the backdrop too.
+  own_window_colour = '#c8@BODY_SHADE_RAW@',
   minimum_width = 1200,
   minimum_height = 700,
   double_buffer = true,
@@ -874,6 +885,7 @@ cd ~/Programming/GIT/conky-theme-udt
 sed -e 's/@SCHEME@/macchiato/' -e 's/@HEADING@/#8aadf4/' -e 's/@LABEL@/#a5adcb/' \
     -e 's/@RULE@/#494d64/' -e 's/@VALUE@/#8bd5ca/' -e 's/@HIGHLIGHT@/#c6a0f6/' \
     -e 's/@OK@/#a6da95/' -e 's/@CRITICAL@/#ed8796/' -e 's/@BODY@/#cad3f5/' \
+    -e 's/@BODY_SHADE_RAW@/1e2030/' \
     -e 's/@BODY_OUTLINE@/#494d64/' -e 's/@BODY_SHADE@/#1e2030/' \
     conky.conf.in > /tmp/conky-render-test.conf
 lua -e "assert(loadfile('/tmp/conky-render-test.conf')); print('TEMPLATE OK')"
@@ -986,6 +998,7 @@ cd ~/Programming/GIT/conky-theme-udt
 sed -e 's/@SCHEME@/macchiato/' -e 's/@HEADING@/#8aadf4/' -e 's/@LABEL@/#a5adcb/' \
     -e 's/@RULE@/#494d64/' -e 's/@VALUE@/#8bd5ca/' -e 's/@HIGHLIGHT@/#c6a0f6/' \
     -e 's/@OK@/#a6da95/' -e 's/@CRITICAL@/#ed8796/' -e 's/@BODY@/#cad3f5/' \
+    -e 's/@BODY_SHADE_RAW@/1e2030/' \
     -e 's/@BODY_OUTLINE@/#494d64/' -e 's/@BODY_SHADE@/#1e2030/' \
     -e "s|~/.config/conky/dashboard.lua|./dashboard.lua|" \
     conky.conf.in > conky.conf
@@ -1361,6 +1374,9 @@ def gen_conky(res, scheme, palette, template):
     for role in ("heading", "label", "rule", "value", "highlight", "ok",
                  "body", "body_outline", "body_shade", "critical"):
         out = out.replace(f"@{role.upper()}@", hex6(res[role]))
+    # own_window_colour takes '#AARRGGBB', so the window background needs the
+    # shade colour without its leading '#' to sit after the alpha pair.
+    out = out.replace("@BODY_SHADE_RAW@", hex6(res["body_shade"]).lstrip("#"))
     return out
 ```