fix(client-handover): kill PDF text superposition (URL dupe + list page-break)

Two distinct render bugs producing overlapping text on multi-page PDFs:

1. Bare-URL duplication. The print stylesheet injects `(href)` after every
   external link via `a[href^="http"]::after`. When pandoc/marked
   auto-links a bare URL or renders `[X](X)`, the visible text already
   equals the href, so the pseudo-element produces "URL (URL)" and the
   trailing duplicate wraps onto the next line, colliding with the
   following block (e.g. "https://pagespeed.web.dev/ (https://...)" then
   "• Ouvrir, taper l'URL...").
   Fix: post-process the body HTML in handover-to-pdf.sh; tag every
   `<a href="X">X</a>` (text == href, ignoring trailing slash + case)
   with `class="bare-url"`, and exclude `a.bare-url::after` from the
   URL-injection rule. Named links still get `(URL)` for print legibility.
   Belt-and-braces: add `white-space: nowrap` and `break-inside: avoid`
   on the remaining `::after` so future long URLs cannot wrap across
   page boundaries either.

2. List item splitting across page boundary. `li` had only
   `orphans/widows: 3` and no `break-inside`, so a long item could put
   its bullet on page N and its text on page N+1, overlapping unrelated
   content. Heading-to-first-block adjacency was also unprotected, so
   "heading at bottom of page A / intro paragraph or first bullet at top
   of page B" could produce visual overlap during reflow.
   Fix: add `li { page-break-inside: avoid; break-inside: avoid; }` and
   `h{1..4} + p|ul|ol { break-before: avoid; }` so list items stay
   intact and intros stay glued to their heading.

Verified end-to-end: rendered sample md with bare URL + named link +
heading-followed-by-list straddling a page break; pdftotext shows each
URL once, no orphaned bullets, no `::after` warning from weasyprint.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

skills/client-handover/scripts/handover-to-pdf.sh

@@ -146,6 +146,54 @@ print(markdown.markdown(
 
 BODY_HTML="$(md_to_html_body "$SRC_MD")"
 
+# Tag anchors whose visible text equals their href (auto-linked bare URLs)
+# so the print stylesheet skips the "(href)" pseudo-element duplication.
+# Without this, "[https://x.com/](https://x.com/)" or a bare URL renders as
+# "https://x.com/ (https://x.com/)" and the trailing duplicate wraps onto
+# the next line, overlapping the following block.
+tag_bare_url_links() {
+  # Pass HTML via env var so the heredoc can be the python script.
+  HQ_RAW_HTML="$1" python3 <<'PY'
+import os, sys, re, html as html_lib
+
+src = os.environ.get("HQ_RAW_HTML", "")
+
+def normalize(u: str) -> str:
+    return html_lib.unescape(u).strip().rstrip('/').lower()
+
+# Match <a ...href="X"...>TEXT</a> with no nested tags inside the anchor.
+ANCHOR_RE = re.compile(
+    r'<a\b([^>]*?)\bhref="([^"]+)"([^>]*)>([^<]*)</a>',
+    flags=re.IGNORECASE,
+)
+
+def repl(m: re.Match) -> str:
+    pre_attrs, href, post_attrs, text = m.groups()
+    if normalize(href) != normalize(text):
+        return m.group(0)
+    attrs = (pre_attrs or "") + (post_attrs or "")
+    class_re = re.compile(r'\bclass="([^"]*)"', flags=re.IGNORECASE)
+    cm = class_re.search(attrs)
+    if cm:
+        existing = cm.group(1)
+        if "bare-url" in existing.split():
+            new_attrs = attrs
+        else:
+            new_attrs = class_re.sub(
+                f'class="{existing} bare-url"', attrs, count=1
+            )
+    else:
+        new_attrs = attrs.rstrip() + ' class="bare-url"'
+    return f'<a{new_attrs} href="{href}">{text}</a>'
+
+sys.stdout.write(ANCHOR_RE.sub(repl, src))
+PY
+}
+
+if command -v python3 >/dev/null 2>&1; then
+  BODY_HTML="$(tag_bare_url_links "$BODY_HTML")"
+fi
+
 # ---------------------------- WRAP HTML ----------------------------
 
 CSS_CONTENT="$(cat "$BRANDING_DIR/zenquality.css")"