aboutsummaryrefslogtreecommitdiffstats
path: root/AGENTS.md
diff options
context:
space:
mode:
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md13
1 files changed, 11 insertions, 2 deletions
diff --git a/AGENTS.md b/AGENTS.md
index 55bdf2d..afb685a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -239,8 +239,17 @@ which would move every cache on the system, so `udt-accent` writes the real
file to `~/.cache/udt/` and `install.sh` symlinks the old path at it. That
directory now holds the link and nothing else.
-**Extraction is deliberately isolated from pywal's cache.** It calls
-`pywal.backends.colorz.get()` directly, which returns a list and writes nothing.
+**The accent is what stands out, not what dominates.** `signature_color()`
+reads the pixels itself (PIL, on a 256px thumbnail) and scores each by chroma
+times its distance from the image's mean colour; the top 2% vote by hue. It
+replaced pywal's colorz backend, whose cluster means averaged a small vivid
+element into its surroundings, whose random seeds made one wallpaper snap
+differently between runs, and which `sys.exit()`s on some images, which
+`except Exception` did not catch, so the old accent stayed. A pick below
+chroma 25 is a tint, and takes the fallback.
+
+**Extraction is deliberately isolated from pywal's cache.** It reads pixels
+and writes nothing.
Running `wal -i` instead would rewrite all of `~/.cache/wal`, including the
terminal's ANSI colours, and that is the exact failure this design exists to
avoid. If you change `signature_color()`, verify it still writes nothing.