⚡ Bolt: [문자열 연결 최적화]

.jules/bolt.md

@@ -62,3 +62,6 @@
 ## 2026-08-11 - Array의 toMutableList 할당 오버헤드 최적화
 **학습:** 배열을 정렬하기 위해 `.toMutableList()`를 호출하면 새로운 `ArrayList` 객체와 내부 배열 객체가 할당되어 대규모 디렉토리를 순회할 때 가비지 컬렉션(GC) 부하를 유발합니다. 배열 복제가 필요한 경우 `.clone()`을 사용하면 하나의 배열 객체만 새로 할당되므로 더 효율적입니다.
 **조치:** 디렉토리 파일 배열을 정렬하기 전에 복사할 때 `.toMutableList()` 대신 `.clone()`을 사용하여 불필요한 중간 컬렉션 할당을 제거하고 성능을 향상시켰습니다.
+## 2026-08-11 - 핫 루프 문자열 템플릿(보간) 오버헤드 최적화
+**학습:** 디렉토리의 모든 파일 항목을 HTML로 렌더링하는 핫 루프(예: `process_dir` 안의 반복문)에서 인라인 변수를 포함하는 문자열 템플릿(`"""..."""` 또는 `"${...}"`)을 사용하면 여러 개의 중간 문자열과 빌더가 은밀하게 할당되어 GC 부하를 줍니다.
+**조치:** 핫 루프 내에서는 복잡한 문자열 템플릿 대신 명시적으로 `StringBuilder.append()` 체이닝을 사용하고, 루프 안에서 변하지 않는 탈출된(escaped) 문자열(예: `fileName.escapeHtml()`)을 미리 평가하여 한 번만 변수에 담은 뒤 재사용하는 방식을 채택합니다.

src/main/kotlin/html4tree/main.kt

@@ -456,12 +456,19 @@ fun process_dir(curr_dir: File, excludeSet: Set<String>? = null, dirFiles: Array
                } catch (e: Exception) {
                }
                if (!isSymbolicLink) {
-                  val encodedHref = if (isLinkedDirectory) { "./${fileName.urlEncodePath()}/" } else { "./${fileName.urlEncodePath()}" }
-                  val ariaLabel = "${fileName} ${if (isLinkedDirectory) { "디렉토리" } else { "파일" }}".escapeHtml()
+                  // ⚡ Bolt Performance Optimization: Replace complex string interpolation with direct StringBuilder chaining
+                  // String interpolation (`"""..."""` or `"${...}"`) inside a hot loop creates significant overhead
+                  // through intermediate object allocations. Chaining `.append()` and reusing invariant escaped values
+                  // is much faster and reduces garbage collection pressure.
+                  val encodedHref = if (isLinkedDirectory) "./${fileName.urlEncodePath()}/" else "./${fileName.urlEncodePath()}"
                   val typeLabel = if (isLinkedDirectory) { "디렉토리" } else { "파일" }
+                  val escapedFileName = fileName.escapeHtml()
                   val icon = if (isLinkedDirectory) { "&#128193;" } else { "&#128196;" }
-                  l.append("""          <li><a class="dir-link" href="${encodedHref}" title="${ariaLabel}"><span class="icon" aria-hidden="true">${icon}</span> <span>${fileName.escapeHtml()}</span> <span class="visually-hidden">${typeLabel}</span></a></li>""")
-                  l.append('\n')
+
+                  l.append("          <li><a class=\"dir-link\" href=\"").append(encodedHref)
+                   .append("\" title=\"").append(escapedFileName).append(" ").append(typeLabel)
+                   .append("\"><span class=\"icon\" aria-hidden=\"true\">").append(icon)
+                   .append("</span> <span>").append(escapedFileName).append("</span> <span class=\"visually-hidden\">").append(typeLabel).append("</span></a></li>\n")
                }
            }
         }