From 7f3291f2486ce04063df55302d39e53a48eee928 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Sat, 29 Aug 2026 05:24:31 +0000
Subject: [PATCH 1/4] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20Replace=20link=20?=
 =?UTF-8?q?with=20semantic=20button=20for=20clear=20action?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: sheepdestroyer <1377479+sheepdestroyer@users.noreply.github.com>
---
 .Jules/palette.md             | 3 +++
 .gitignore                    | 1 +
 router/static/visualizer.html | 2 +-
 3 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/.Jules/palette.md b/.Jules/palette.md
index d6fa89b3..d38378b9 100644
--- a/.Jules/palette.md
+++ b/.Jules/palette.md
@@ -21,3 +21,6 @@
 ## 2026-08-16 - Focus Parity for CSS Transform Animations
 **Learning:** When interactive elements (like `.btn` links) have CSS `transform` animations on `:hover` (e.g., `transform: translateX(4px)`), missing the corresponding `transform` on the `:focus-visible` state means keyboard users do not get the same visual feedback as mouse users, creating an inconsistent and less polished experience.
 **Action:** Ensure CSS `transform` and other layout-affecting animations applied on `:hover` are also applied on `:focus-visible` for the parent element to maintain focus parity.
+## 2026-08-16 - Semantic Buttons for Interactive Actions
+**Learning:** Using `<a href="#">` for interactive actions (like clearing annotations or saving) creates unintended scrolling behavior (jumping to the top of the page) and incorrect semantics for screen readers, as the element is performing an action on the page rather than navigating.
+**Action:** Replace `<a href="#">` tags used for JavaScript actions with `<button type="button">` and apply inline CSS reset styles (`background: transparent; border: none; padding: 0; font: inherit; cursor: pointer; text-decoration: underline;`) to maintain the visual appearance of a link while providing correct semantics and preventing page jumps.
diff --git a/.gitignore b/.gitignore
index d205e9fd..84b4def1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -42,3 +42,4 @@ pr_description.txt
 
 .cache/
 test_output*.log
+node_modules/
diff --git a/router/static/visualizer.html b/router/static/visualizer.html
index 942e17fb..5b50efe1 100644
--- a/router/static/visualizer.html
+++ b/router/static/visualizer.html
@@ -325,7 +325,7 @@ <h3>✎ Human Review</h3>
         <input type="text" id="note-input" placeholder="Optional review note..." value="${ann ? escapeHtml(ann.note || '') : ''}">
         <button onclick="saveNote(${idx})">Save Note</button>
       </div>
-      ${ann ? `<div style="margin-top:8px;font-size:0.75em;color:#64b5f6">✓ Reviewed as <b>${escapeHtml(ann.tier)}</b> · <a href="#" onclick="clearAnnotation(${idx})" style="color:#f44336">clear</a></div>` : ''}
+      ${ann ? `<div style="margin-top:8px;font-size:0.75em;color:#64b5f6">✓ Reviewed as <b>${escapeHtml(ann.tier)}</b> · <button type="button" onclick="clearAnnotation(${idx})" style="color:#f44336; background:transparent; border:none; padding:0; font:inherit; cursor:pointer; text-decoration:underline;" aria-label="Clear annotation">clear</button></div>` : ''}
     </div>
   `;
 }

From a48fe889f36eca23577667420dd5f98a26ec17db Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Sat, 29 Aug 2026 05:33:29 +0000
Subject: [PATCH 2/4] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20Replace=20link=20?=
 =?UTF-8?q?with=20semantic=20button=20for=20clear=20action?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: sheepdestroyer <1377479+sheepdestroyer@users.noreply.github.com>

From f9d8e724af43ec08a6117bf31278cc79e4097262 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Sat, 29 Aug 2026 05:35:26 +0000
Subject: [PATCH 3/4] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20Replace=20link=20?=
 =?UTF-8?q?with=20semantic=20button=20for=20clear=20action?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: sheepdestroyer <1377479+sheepdestroyer@users.noreply.github.com>

From d1045d5001da66855030ac0c4c4efe158181361c Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Sat, 29 Aug 2026 05:37:56 +0000
Subject: [PATCH 4/4] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20Replace=20link=20?=
 =?UTF-8?q?with=20semantic=20button=20for=20clear=20action?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: sheepdestroyer <1377479+sheepdestroyer@users.noreply.github.com>