From af074bf14ddc4116270c68145f19c3d2641a39ce Mon Sep 17 00:00:00 2001
From: seonghobae <8172694+seonghobae@users.noreply.github.com>
Date: Thu, 23 Jul 2026 14:08:50 +0000
Subject: [PATCH 1/7] chore: optimize above-the-fold image decoding for LCP

- Remove `decoding="async"` from critical SVG images in `index.html`
- Update `test_styles.py` to expect async decoding only on lazy-loaded images
- Update `.jules/bolt.md` and `CHANGELOG.md`
---
 .jules/bolt.md       | 4 ++++
 CHANGELOG.md         | 1 +
 index.html           | 6 ++++--
 tests/test_styles.py | 5 +++--
 4 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/.jules/bolt.md b/.jules/bolt.md
index c10fb9b..a3f41a2 100644
--- a/.jules/bolt.md
+++ b/.jules/bolt.md
@@ -12,3 +12,7 @@
 ## 2026-07-10 - Remove unnecessary DOMPurify for performance
 **Learning:** 애플리케이션이 `textContent`와 같은 안전한 DOM API만 사용하고 `innerHTML` 등의 위험한 싱크를 사용하지 않는다면 DOMPurify와 같은 라이브러리를 통해 Trusted Types 정책을 생성할 필요가 없음.
 **Action:** 불필요한 번들 다운로드 및 스크립트 실행을 방지하기 위해 사용하지 않는 라이브러리를 식별하고 제거할 것.
+
+## 2026-07-23 - Above-the-fold 이미지 디코딩 최적화
+**Learning:** LCP에 해당하는 Above-the-fold 이미지에 `decoding="async"`를 설정하면 디코딩 작업이 지연되어 오히려 LCP 렌더링 시간이 늘어날 수 있다.
+**Action:** 향후 lazy load 되는 이미지가 아닌 첫 화면의 중요한 SVG/LCP 이미지에는 `decoding="async"`를 적용하지 않도록 한다.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 56ad628..e590ee0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,7 @@
 # CHANGELOG
 
 ## [Unreleased]
+- **성능 개선**: 첫 화면 렌더링 성능(LCP) 향상을 위해 주요 SVG 이미지에서 `decoding="async"` 속성 제거
 - **보안 개선**: 컴포넌트 갤러리의 인라인 스크립트와 스타일을 외부 파일로 분리하고, 엄격한 Content-Security-Policy를 적용해 XSS 방어를 강화했습니다.
 - **성능 회귀 복원**: 오프스크린 `.section` 렌더링을 `content-visibility: auto`로 지연하고, 일반 섹션은 600px·콘텐츠가 큰 DIKW/projects 섹션은 1000px의 `contain-intrinsic-size` placeholder를 유지해 초기 렌더링 비용과 스크롤바 이동을 함께 줄였습니다.
 - **보안 개선**: Trusted Types 기반 CSP 강화: 잠재적인 DOM 기반 XSS 공격을 방지하기 위해 `require-trusted-types-for 'script'` 지시어 추가
diff --git a/index.html b/index.html
index c40fea3..0dacf4a 100644
--- a/index.html
+++ b/index.html
@@ -29,7 +29,8 @@
     <a href="#top" class="skip-link" data-i18n="nav.skipToContent">본문으로 건너뛰기</a>
     <header class="site-header">
       <a class="brand" href="#top" aria-label="Contextual Wisdom Lab home">
-        <img src="assets/context-wisdom-lab-avatar.svg" alt="" width="44" height="44" decoding="async">
+        <!-- ⚡ Bolt: Removed decoding="async" for SVG/LCP optimization -->
+        <img src="assets/context-wisdom-lab-avatar.svg" alt="" width="44" height="44">
         <span>Contextual Wisdom Lab</span>
       </a>
       <nav class="site-nav" aria-label="Primary navigation">
@@ -64,7 +65,8 @@ <h1 data-i18n="hero.title">맥락지혜 연구실</h1>
         </div>
 
         <div class="hero-visual">
-          <img class="context-art" src="assets/context-thread-map.svg" alt="" aria-hidden="true" width="760" height="560" fetchpriority="high" decoding="async">
+          <!-- ⚡ Bolt: Removed decoding="async" for SVG/LCP optimization -->
+          <img class="context-art" src="assets/context-thread-map.svg" alt="" aria-hidden="true" width="760" height="560" fetchpriority="high">
           <div class="ladder" role="list" aria-label="Data to wisdom ladder">
             <div class="ladder-row" role="listitem">
               <span>Data</span>
diff --git a/tests/test_styles.py b/tests/test_styles.py
index 40e8fab..31180a7 100644
--- a/tests/test_styles.py
+++ b/tests/test_styles.py
@@ -44,9 +44,10 @@ def test_tall_sections_reserve_larger_intrinsic_block_size():
 
 
 def test_images_decode_without_blocking_rendering():
-    """All site images opt into asynchronous decoding."""
+    """Lazy-loaded site images opt into asynchronous decoding."""
     parser = _ImageParser()
     parser.feed(INDEX.read_text(encoding="utf-8"))
 
     assert parser.images
-    assert all(image.get("decoding") == "async" for image in parser.images)
+    lazy_images = [img for img in parser.images if img.get("loading") == "lazy"]
+    assert all(image.get("decoding") == "async" for image in lazy_images)

From 1b53c2e1297072a1af2f9c0b85dda7c706da87fe Mon Sep 17 00:00:00 2001
From: Seongho Bae <me@seonghobae.me>
Date: Wed, 5 Aug 2026 23:26:29 +0900
Subject: [PATCH 2/7] test: prove eager, lazy, and LCP image hint contracts

---
 tests/test_styles.py | 73 +++++++++++++++++++++++++++++++++++++-------
 1 file changed, 62 insertions(+), 11 deletions(-)

diff --git a/tests/test_styles.py b/tests/test_styles.py
index 31180a7..c5b1bb2 100644
--- a/tests/test_styles.py
+++ b/tests/test_styles.py
@@ -1,4 +1,4 @@
-"""Regression tests for performance-sensitive site CSS."""
+"""Regression tests for performance-sensitive site CSS and image hints."""
 
 import re
 from html.parser import HTMLParser
@@ -10,23 +10,40 @@
 
 
 class _ImageParser(HTMLParser):
-    def __init__(self):
+    """Collect image attributes from the static homepage."""
+
+    def __init__(self) -> None:
+        """Initialize an empty image collection."""
         super().__init__()
         self.images: list[dict[str, str | None]] = []
 
-    def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
+    def handle_starttag(
+        self,
+        tag: str,
+        attrs: list[tuple[str, str | None]],
+    ) -> None:
+        """Record each ``img`` element while parsing the homepage."""
         if tag == "img":
             self.images.append(dict(attrs))
 
 
 def _rule(selector: str) -> str:
+    """Return the declaration body for one exact CSS selector."""
     css = STYLES.read_text(encoding="utf-8")
     match = re.search(rf"{re.escape(selector)}\s*\{{(?P<body>[^}}]+)\}}", css)
     assert match is not None, f"missing CSS rule: {selector}"
     return match.group("body")
 
 
-def test_sections_defer_offscreen_rendering_with_stable_placeholder():
+def _homepage_images() -> list[dict[str, str | None]]:
+    """Parse and return every homepage image with its literal attributes."""
+    parser = _ImageParser()
+    parser.feed(INDEX.read_text(encoding="utf-8"))
+    assert parser.images, "homepage must contain at least one image"
+    return parser.images
+
+
+def test_sections_defer_offscreen_rendering_with_stable_placeholder() -> None:
     """Ordinary sections retain their measured-size fallback while skipped."""
     rule = _rule(".section")
 
@@ -35,7 +52,7 @@ def test_sections_defer_offscreen_rendering_with_stable_placeholder():
     assert "contain-intrinsic-size: auto 600px;" in rule
 
 
-def test_tall_sections_reserve_larger_intrinsic_block_size():
+def test_tall_sections_reserve_larger_intrinsic_block_size() -> None:
     """Content-heavy sections reserve enough space to avoid scrollbar jumps."""
     rule = _rule(".section.dikw, .section.projects")
 
@@ -43,11 +60,45 @@ def test_tall_sections_reserve_larger_intrinsic_block_size():
     assert "contain-intrinsic-size: auto 1000px;" in rule
 
 
-def test_images_decode_without_blocking_rendering():
-    """Lazy-loaded site images opt into asynchronous decoding."""
-    parser = _ImageParser()
-    parser.feed(INDEX.read_text(encoding="utf-8"))
+def test_eager_images_leave_decoding_to_the_user_agent() -> None:
+    """Eager images use the standards-defined default ``auto`` decoding hint."""
+    eager_images = [
+        image for image in _homepage_images() if image.get("loading") != "lazy"
+    ]
+
+    assert eager_images, "the first viewport must contain eager images"
+    assert all(image.get("decoding") is None for image in eager_images)
 
-    assert parser.images
-    lazy_images = [img for img in parser.images if img.get("loading") == "lazy"]
+
+def test_lazy_images_decode_asynchronously() -> None:
+    """Deferred images remain explicitly asynchronous and cannot pass vacuously."""
+    lazy_images = [
+        image for image in _homepage_images() if image.get("loading") == "lazy"
+    ]
+
+    assert lazy_images, "the long homepage must retain deferred images"
     assert all(image.get("decoding") == "async" for image in lazy_images)
+
+
+def test_lcp_candidate_is_eager_and_high_priority() -> None:
+    """The declared LCP candidate is eagerly fetched without forced async paint."""
+    lcp_candidates = [
+        image
+        for image in _homepage_images()
+        if image.get("fetchpriority") == "high"
+    ]
+
+    assert len(lcp_candidates) == 1
+    lcp_candidate = lcp_candidates[0]
+    assert lcp_candidate.get("loading") != "lazy"
+    assert lcp_candidate.get("decoding") is None
+
+
+def test_project_cards_are_fully_clickable_via_pseudo_element() -> None:
+    """Project cards expose the complete card as the link target."""
+    article_rule = _rule(".project-grid article")
+    assert "position: relative;" in article_rule
+
+    after_rule = _rule(".project-grid h3 a::after")
+    assert "position: absolute;" in after_rule
+    assert "inset: 0;" in after_rule

From c09c135b204c8c794de2dbd1360374aa201ee64f Mon Sep 17 00:00:00 2001
From: Seongho Bae <me@seonghobae.me>
Date: Wed, 5 Aug 2026 23:27:09 +0900
Subject: [PATCH 3/7] docs: ground image hints in current web standards

---
 .jules/bolt.md | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/.jules/bolt.md b/.jules/bolt.md
index a3f41a2..fad46de 100644
--- a/.jules/bolt.md
+++ b/.jules/bolt.md
@@ -13,6 +13,10 @@
 **Learning:** 애플리케이션이 `textContent`와 같은 안전한 DOM API만 사용하고 `innerHTML` 등의 위험한 싱크를 사용하지 않는다면 DOMPurify와 같은 라이브러리를 통해 Trusted Types 정책을 생성할 필요가 없음.
 **Action:** 불필요한 번들 다운로드 및 스크립트 실행을 방지하기 위해 사용하지 않는 라이브러리를 식별하고 제거할 것.
 
-## 2026-07-23 - Above-the-fold 이미지 디코딩 최적화
-**Learning:** LCP에 해당하는 Above-the-fold 이미지에 `decoding="async"`를 설정하면 디코딩 작업이 지연되어 오히려 LCP 렌더링 시간이 늘어날 수 있다.
-**Action:** 향후 lazy load 되는 이미지가 아닌 첫 화면의 중요한 SVG/LCP 이미지에는 `decoding="async"`를 적용하지 않도록 한다.
+## 2026-07-23 - 중요 이미지의 fetch·decode 힌트 분리
+**Learning:** HTML Living Standard에서 `decoding`은 이미지 표시 방식에 관한 선호 힌트이며, 속성을 생략하면 `auto`가 기본값입니다. `fetchpriority="high"`는 별도로 이미지 fetch 우선순위를 높입니다. 따라서 SVG에는 디코딩이 없다고 가정하거나 `decoding` 제거만으로 LCP가 반드시 개선된다고 단정해서는 안 됩니다.
+**Action:** 첫 화면의 eager 이미지와 유일한 LCP 후보는 강제 `async` 대신 사용자 에이전트의 `auto` 판단에 맡기고, 명시적으로 지연 로드하는 이미지에만 `decoding="async"`를 유지합니다. 회귀 테스트는 eager·lazy·LCP 집합이 실제로 존재하는지 먼저 확인해 vacuous pass를 막고, LCP 변화는 배포 후 실측으로 검증합니다.
+
+### References (APA 7th)
+- WHATWG. (2026, July 20). *HTML standard: The img element*. https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element
+- Osmani, A., Sohoni, L., Meenan, P., & Pollard, B. (2023, November 14). *Optimize resource loading with the Fetch Priority API*. web.dev. https://web.dev/articles/fetch-priority

From 4f8f8b34a186f9332a8f05924cf422fd37e6cf17 Mon Sep 17 00:00:00 2001
From: Seongho Bae <me@seonghobae.me>
Date: Wed, 5 Aug 2026 23:27:28 +0900
Subject: [PATCH 4/7] docs: avoid unmeasured LCP performance claims

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e590ee0..855e472 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,7 +1,7 @@
 # CHANGELOG
 
 ## [Unreleased]
-- **성능 개선**: 첫 화면 렌더링 성능(LCP) 향상을 위해 주요 SVG 이미지에서 `decoding="async"` 속성 제거
+- **렌더링 힌트 정합성**: 첫 화면의 eager 이미지와 LCP 후보에서 강제 `decoding="async"`를 제거해 HTML 표준의 기본 `auto` 판단에 맡기고, 지연 로드 이미지에는 비동기 디코딩 힌트를 유지했습니다. LCP 개선 효과는 환경별 실측 대상으로 취급합니다.
 - **보안 개선**: 컴포넌트 갤러리의 인라인 스크립트와 스타일을 외부 파일로 분리하고, 엄격한 Content-Security-Policy를 적용해 XSS 방어를 강화했습니다.
 - **성능 회귀 복원**: 오프스크린 `.section` 렌더링을 `content-visibility: auto`로 지연하고, 일반 섹션은 600px·콘텐츠가 큰 DIKW/projects 섹션은 1000px의 `contain-intrinsic-size` placeholder를 유지해 초기 렌더링 비용과 스크롤바 이동을 함께 줄였습니다.
 - **보안 개선**: Trusted Types 기반 CSP 강화: 잠재적인 DOM 기반 XSS 공격을 방지하기 위해 `require-trusted-types-for 'script'` 지시어 추가

From 4d1b46f41ee37293f4fe4a0b160f2298a5129966 Mon Sep 17 00:00:00 2001
From: Seongho Bae <me@seonghobae.me>
Date: Wed, 5 Aug 2026 23:33:44 +0900
Subject: [PATCH 5/7] chore: reconcile changelog with current main

---
 CHANGELOG.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 855e472..2b1d07a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,7 @@
 
 ## [Unreleased]
 - **렌더링 힌트 정합성**: 첫 화면의 eager 이미지와 LCP 후보에서 강제 `decoding="async"`를 제거해 HTML 표준의 기본 `auto` 판단에 맡기고, 지연 로드 이미지에는 비동기 디코딩 힌트를 유지했습니다. LCP 개선 효과는 환경별 실측 대상으로 취급합니다.
+- **UX/접근성 개선**: 프로젝트 카드의 클릭 영역을 카드 전체로 확장하여 사용자 편의성을 높였습니다. <a> 태그를 확장하는 대신 가상 요소(pseudo-element) 겹침 방식을 사용하여 스크린 리더 접근성을 유지했습니다.
 - **보안 개선**: 컴포넌트 갤러리의 인라인 스크립트와 스타일을 외부 파일로 분리하고, 엄격한 Content-Security-Policy를 적용해 XSS 방어를 강화했습니다.
 - **성능 회귀 복원**: 오프스크린 `.section` 렌더링을 `content-visibility: auto`로 지연하고, 일반 섹션은 600px·콘텐츠가 큰 DIKW/projects 섹션은 1000px의 `contain-intrinsic-size` placeholder를 유지해 초기 렌더링 비용과 스크롤바 이동을 함께 줄였습니다.
 - **보안 개선**: Trusted Types 기반 CSP 강화: 잠재적인 DOM 기반 XSS 공격을 방지하기 위해 `require-trusted-types-for 'script'` 지시어 추가
@@ -13,3 +14,4 @@
 - **보안 개선**: `i18n.js`의 `setLanguage()` 함수에 허용된 언어인지 확인하는 입력값 검증(Input Validation) 로직을 추가하여 Prototype Pollution 및 유효하지 않은 상태 주입을 방지했습니다.
 - **성능 개선**: `i18n.js`에서 초기 로드 시 기본 언어가 한국어(ko)인 경우 불필요한 DOM 순회 및 텍스트 업데이트를 생략하도록 개선했습니다.
 - **테스트 추가**: 다국어 처리 로직의 무결성을 검증하기 위해 `test_i18n.html` 테스트 파일을 추가했습니다.
+- **보안 개선**: 메인 페이지(`index.html`)의 Content-Security-Policy를 `default-src 'none'` 기반의 엄격한 화이트리스트 방식으로 강화하여 잠재적인 공격 표면을 최소화했습니다.

From f2b2fd04699c5d1837ae48b538803dc8a6eec811 Mon Sep 17 00:00:00 2001
From: Seongho Bae <me@seonghobae.me>
Date: Wed, 5 Aug 2026 23:35:03 +0900
Subject: [PATCH 6/7] ci: reconcile canonical PR with current main once

---
 .github/workflows/reconcile-current-main.yml | 89 ++++++++++++++++++++
 1 file changed, 89 insertions(+)
 create mode 100644 .github/workflows/reconcile-current-main.yml

diff --git a/.github/workflows/reconcile-current-main.yml b/.github/workflows/reconcile-current-main.yml
new file mode 100644
index 0000000..15eae0e
--- /dev/null
+++ b/.github/workflows/reconcile-current-main.yml
@@ -0,0 +1,89 @@
+name: reconcile-current-main
+
+on:
+  push:
+    branches:
+      - feature/bolt-lcp-optimization-2587083072321749037
+
+permissions:
+  contents: write
+
+concurrency:
+  group: reconcile-current-main-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  reconcile:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    steps:
+      - name: Merge current main and verify exact result
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          HEAD_BRANCH: ${{ github.ref_name }}
+          REPOSITORY: ${{ github.repository }}
+        run: |
+          set -euo pipefail
+
+          git init .
+          git remote add origin "https://x-access-token:${GH_TOKEN}@github.com/${REPOSITORY}.git"
+          git fetch --no-tags origin "${HEAD_BRANCH}" main
+          git checkout -B "${HEAD_BRANCH}" "origin/${HEAD_BRANCH}"
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+          if ! git merge --no-commit --no-ff origin/main; then
+            mapfile -t conflicted_files < <(git diff --name-only --diff-filter=U)
+            printf 'Conflicted files:\n'
+            printf '  %s\n' "${conflicted_files[@]}"
+
+            for conflicted_file in "${conflicted_files[@]}"; do
+              case "$conflicted_file" in
+                CHANGELOG.md|index.html|tests/test_styles.py)
+                  ;;
+                *)
+                  echo "::error::Unexpected merge conflict: ${conflicted_file}"
+                  exit 1
+                  ;;
+              esac
+            done
+
+            if printf '%s\n' "${conflicted_files[@]}" | grep -Fxq CHANGELOG.md; then
+              git checkout --ours CHANGELOG.md
+            fi
+            if printf '%s\n' "${conflicted_files[@]}" | grep -Fxq tests/test_styles.py; then
+              git checkout --ours tests/test_styles.py
+            fi
+            if printf '%s\n' "${conflicted_files[@]}" | grep -Fxq index.html; then
+              git checkout --theirs index.html
+            fi
+          fi
+
+          python3 - <<'PY'
+          from pathlib import Path
+
+          index_path = Path("index.html")
+          html = index_path.read_text(encoding="utf-8")
+          replacements = {
+              '<img src="assets/context-wisdom-lab-avatar.svg" alt="" width="44" height="44" decoding="async">':
+                  '<img src="assets/context-wisdom-lab-avatar.svg" alt="" width="44" height="44">',
+              '<img class="context-art" src="assets/context-thread-map.svg" alt="" aria-hidden="true" width="760" height="560" fetchpriority="high" decoding="async">':
+                  '<img class="context-art" src="assets/context-thread-map.svg" alt="" aria-hidden="true" width="760" height="560" fetchpriority="high">',
+          }
+          for old, new in replacements.items():
+              count = html.count(old)
+              if count != 1:
+                  raise SystemExit(
+                      f"expected exactly one current-main image tag, found {count}: {old}"
+                  )
+              html = html.replace(old, new)
+          index_path.write_text(html, encoding="utf-8")
+          PY
+
+          rm .github/workflows/reconcile-current-main.yml
+          git add -A
+          git diff --cached --check
+          python3 -m pytest tests/
+
+          git commit -m "chore: reconcile image hints with current main"
+          git push origin "HEAD:${HEAD_BRANCH}"

From fa518c47dd9f6d35742aac385f6d322bdfca90b0 Mon Sep 17 00:00:00 2001
From: Seongho Bae <me@seonghobae.me>
Date: Wed, 5 Aug 2026 23:35:59 +0900
Subject: [PATCH 7/7] ci: remove unused one-shot reconciliation workflow

---
 .github/workflows/reconcile-current-main.yml | 89 --------------------
 1 file changed, 89 deletions(-)
 delete mode 100644 .github/workflows/reconcile-current-main.yml

diff --git a/.github/workflows/reconcile-current-main.yml b/.github/workflows/reconcile-current-main.yml
deleted file mode 100644
index 15eae0e..0000000
--- a/.github/workflows/reconcile-current-main.yml
+++ /dev/null
@@ -1,89 +0,0 @@
-name: reconcile-current-main
-
-on:
-  push:
-    branches:
-      - feature/bolt-lcp-optimization-2587083072321749037
-
-permissions:
-  contents: write
-
-concurrency:
-  group: reconcile-current-main-${{ github.ref }}
-  cancel-in-progress: false
-
-jobs:
-  reconcile:
-    runs-on: ubuntu-24.04
-    timeout-minutes: 10
-    steps:
-      - name: Merge current main and verify exact result
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          HEAD_BRANCH: ${{ github.ref_name }}
-          REPOSITORY: ${{ github.repository }}
-        run: |
-          set -euo pipefail
-
-          git init .
-          git remote add origin "https://x-access-token:${GH_TOKEN}@github.com/${REPOSITORY}.git"
-          git fetch --no-tags origin "${HEAD_BRANCH}" main
-          git checkout -B "${HEAD_BRANCH}" "origin/${HEAD_BRANCH}"
-          git config user.name "github-actions[bot]"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-
-          if ! git merge --no-commit --no-ff origin/main; then
-            mapfile -t conflicted_files < <(git diff --name-only --diff-filter=U)
-            printf 'Conflicted files:\n'
-            printf '  %s\n' "${conflicted_files[@]}"
-
-            for conflicted_file in "${conflicted_files[@]}"; do
-              case "$conflicted_file" in
-                CHANGELOG.md|index.html|tests/test_styles.py)
-                  ;;
-                *)
-                  echo "::error::Unexpected merge conflict: ${conflicted_file}"
-                  exit 1
-                  ;;
-              esac
-            done
-
-            if printf '%s\n' "${conflicted_files[@]}" | grep -Fxq CHANGELOG.md; then
-              git checkout --ours CHANGELOG.md
-            fi
-            if printf '%s\n' "${conflicted_files[@]}" | grep -Fxq tests/test_styles.py; then
-              git checkout --ours tests/test_styles.py
-            fi
-            if printf '%s\n' "${conflicted_files[@]}" | grep -Fxq index.html; then
-              git checkout --theirs index.html
-            fi
-          fi
-
-          python3 - <<'PY'
-          from pathlib import Path
-
-          index_path = Path("index.html")
-          html = index_path.read_text(encoding="utf-8")
-          replacements = {
-              '<img src="assets/context-wisdom-lab-avatar.svg" alt="" width="44" height="44" decoding="async">':
-                  '<img src="assets/context-wisdom-lab-avatar.svg" alt="" width="44" height="44">',
-              '<img class="context-art" src="assets/context-thread-map.svg" alt="" aria-hidden="true" width="760" height="560" fetchpriority="high" decoding="async">':
-                  '<img class="context-art" src="assets/context-thread-map.svg" alt="" aria-hidden="true" width="760" height="560" fetchpriority="high">',
-          }
-          for old, new in replacements.items():
-              count = html.count(old)
-              if count != 1:
-                  raise SystemExit(
-                      f"expected exactly one current-main image tag, found {count}: {old}"
-                  )
-              html = html.replace(old, new)
-          index_path.write_text(html, encoding="utf-8")
-          PY
-
-          rm .github/workflows/reconcile-current-main.yml
-          git add -A
-          git diff --cached --check
-          python3 -m pytest tests/
-
-          git commit -m "chore: reconcile image hints with current main"
-          git push origin "HEAD:${HEAD_BRANCH}"