From 94ab51f546603876ac5da12891192f06ae40d9dd Mon Sep 17 00:00:00 2001 From: seonghobae <8172694+seonghobae@users.noreply.github.com> Date: Tue, 14 Jul 2026 21:02:15 +0000 Subject: [PATCH 1/4] =?UTF-8?q?=E2=9A=A1=20Bolt:=20=EC=9E=AC=EA=B7=80=20?= =?UTF-8?q?=ED=95=A8=EC=88=98=20=EB=82=B4=20=EC=A0=95=EC=A0=81=20=EC=97=90?= =?UTF-8?q?=EC=85=8B=20=EB=B0=8F=20=ED=95=B4=EC=8B=9C=20=EC=BA=90=EC=8B=B1?= =?UTF-8?q?=20=EC=B5=9C=EC=A0=81=ED=99=94?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - `process_dir` 루프 외부로 `cssContent`, `css`, `styleHash`를 추출하여 불필요한 문자열 생성 및 비싼 SHA-256 암호화 연산 반복 방지 - `process_ignore_file`에서 디렉토리 목록을 호출할 때 발생하는 O(N) I/O 낭비 방지를 위해 `dirListing` 변수로 캐싱 - 관련 테스트 코드 수정으로 100% 테스트 커버리지 유지 --- .jules/bolt.md | 3 + src/main/kotlin/html4tree/main.kt | 157 ++++++++++++++------------ src/test/kotlin/html4tree/MainTest.kt | 7 ++ 3 files changed, 94 insertions(+), 73 deletions(-) diff --git a/.jules/bolt.md b/.jules/bolt.md index 19b4c61..bbc1561 100644 --- a/.jules/bolt.md +++ b/.jules/bolt.md @@ -43,3 +43,6 @@ ## 2025-01-24 - 단일 readAttributes 호출로 파일 속성 조회 최적화 **학습:** `isDirectory`, `!it.isDirectory()`, `isSymbolicLink` 3개의 개별적인 파일 시스템 I/O 호출을 수행하면 성능 저하가 큽니다. 이를 단일 `Files.readAttributes` 호출로 변경하여 메타데이터를 한 번에 조회함으로써 I/O 오버헤드를 대폭 줄일 수 있음을 확인했습니다. **조치:** 디렉토리 순회 시 파일의 여러 속성을 확인할 때는 개별적인 stat 호출보다 `Files.readAttributes`를 사용하여 필요한 모든 속성을 한 번에 가져오는 방식을 우선적으로 고려해야 합니다. +## 2025-01-24 - 재귀 함수 내 정적 에셋 및 해시 캐싱 (Static asset and hash caching) +**학습:** `process_dir`와 같이 디렉토리 트리를 순회하며 재귀적으로 호출되는 함수 내부에서 정적 문자열(CSS)을 정의하거나 SHA-256과 같은 값 비싼 암호화 해시 연산을 수행하면, 처리하는 디렉토리 수(N)만큼 불필요한 연산과 메모리 할당이 반복됩니다. +**조치:** 어플리케이션 실행 동안 변하지 않는 정적 에셋과 해시값은 최상위(Top-level) 프로퍼티나 전역 변수로 추출하여 어플리케이션당 단 한 번만 계산되도록 최적화합니다. diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt index b455862..aedf2b5 100644 --- a/src/main/kotlin/html4tree/main.kt +++ b/src/main/kotlin/html4tree/main.kt @@ -13,6 +13,84 @@ import com.github.ajalt.clikt.parameters.options.default import com.github.ajalt.clikt.parameters.arguments.argument import com.github.ajalt.clikt.parameters.types.int + +// ⚡ Bolt Performance Optimization: Extract static CSS and precompute SHA-256 hash +// Moves expensive cryptographic hash generation and string allocations out of the recursive +// directory processing loop to be computed exactly once per application run. +val cssContent = """ + body { + font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; + line-height: 1.5; + padding: 1rem; + color: #1f2328; + } + main { + max-width: 800px; + margin: 0 auto; + } + ul { + list-style-type: none; + padding-left: 0; + } + a.dir-link { + display: flex; + align-items: flex-start; + gap: 0.5rem; + width: 100%; + overflow-wrap: anywhere; + box-sizing: border-box; + } + .icon { + flex-shrink: 0; + width: 1.25rem; + text-align: center; + } + a { + padding: 0.5rem; + text-decoration: none; + color: #0969da; + border-radius: 4px; + transition: background-color 0.2s ease, outline-color 0.2s ease; + } + a:hover, a:focus-visible { + background-color: #f6f8fa; + text-decoration: underline; + outline: 2px solid #0969da; + outline-offset: -2px; + } + @media (prefers-reduced-motion: reduce) { + a { + transition: none; + } + } + @media (prefers-color-scheme: dark) { + body { + background-color: #0d1117; + color: #c9d1d9; + } + a { + color: #58a6ff; + } + a:hover, a:focus-visible { + background-color: #161b22; + outline-color: #58a6ff; + } + } + .empty-dir { + padding: 0.5rem; + opacity: 0.7; + font-style: italic; + } + """ + +val styleHash = "sha256-" + Base64.getEncoder().encodeToString(MessageDigest.getInstance("SHA-256").digest(cssContent.toByteArray(Charsets.UTF_8))) + +val css = """ + + """ + + class Html4tree : CliktCommand() { val maxLevel:Int by option(help="Number of levels deep for which to generate an index.html file", hidden = false).int().default(-1) val topDir: String by argument(help="Top directory to crawl") @@ -178,6 +256,9 @@ fun process_ignore_file(curr_dir: File, dirFilesNames: Array? = null): S val files_to_exclude = mutableSetOf() + // ⚡ Bolt Performance Optimization: 캐싱을 통해 O(N) 중복 디렉토리 목록(filesystem call) 호출 방지 + val dirListing = dirFilesNames ?: curr_dir.list() + // 보안 향상: .html4ignore 파일이 일반 파일인지 확인하고, 심볼릭 링크인 경우 무시하여 DoS 및 경로 조작을 방지합니다. // 보안 향상: 파일 크기(1MB 제한) 및 줄 수(1000줄), 정규식 길이(100자)를 제한하여 ReDoS 및 메모리 고갈(OOM) 방지 // 보안 향상: 권한이 없는 파일 접근 시 발생하는 예외(DoS)를 방지하기 위해 canRead() 추가 확인 @@ -199,8 +280,7 @@ fun process_ignore_file(curr_dir: File, dirFilesNames: Array? = null): S } // ⚡ Bolt Performance Optimization: 디렉토리 목록을 Set에 추가하기 위해 필터링만 할 때는 정렬이 불필요하므로 .sorted()를 제거하여 O(N log N) 오버헤드를 방지합니다. - val list = dirFilesNames ?: curr_dir.list() - list?.forEach { + dirListing?.forEach { val current = it val pathCurrent = java.nio.file.Paths.get(current) for (matcher in ignored_matchers) { @@ -220,7 +300,7 @@ fun process_ignore_file(curr_dir: File, dirFilesNames: Array? = null): S files_to_exclude.addAll(defaultSensitiveFiles) // 보안 향상: .env, .git 등 민감한 정보가 포함될 수 있는 숨김 파일(.으로 시작하는 모든 항목)을 기본적으로 노출하지 않도록 제외 (정보 노출 방지) - (dirFilesNames ?: curr_dir.list())?.forEach { + dirListing?.forEach { if (it.startsWith(".")) { files_to_exclude.add(it) } @@ -244,78 +324,9 @@ fun process_dir(curr_dir: File, excludeSet: Set? = null, dirFiles: Array val exclude: Set = excludeSet ?: process_ignore_file(curr_dir) - val cssContent = """ - body { - font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; - line-height: 1.5; - padding: 1rem; - color: #1f2328; - } - main { - max-width: 800px; - margin: 0 auto; - } - ul { - list-style-type: none; - padding-left: 0; - } - a.dir-link { - display: flex; - align-items: flex-start; - gap: 0.5rem; - width: 100%; - overflow-wrap: anywhere; - box-sizing: border-box; - } - .icon { - flex-shrink: 0; - width: 1.25rem; - text-align: center; - } - a { - padding: 0.5rem; - text-decoration: none; - color: #0969da; - border-radius: 4px; - transition: background-color 0.2s ease, outline-color 0.2s ease; - } - a:hover, a:focus-visible { - background-color: #f6f8fa; - text-decoration: underline; - outline: 2px solid #0969da; - outline-offset: -2px; - } - @media (prefers-reduced-motion: reduce) { - a { - transition: none; - } - } - @media (prefers-color-scheme: dark) { - body { - background-color: #0d1117; - color: #c9d1d9; - } - a { - color: #58a6ff; - } - a:hover, a:focus-visible { - background-color: #161b22; - outline-color: #58a6ff; - } - } - .empty-dir { - padding: 0.5rem; - opacity: 0.7; - font-style: italic; - } - """ - val styleHash = "sha256-" + Base64.getEncoder().encodeToString(MessageDigest.getInstance("SHA-256").digest(cssContent.toByteArray(Charsets.UTF_8))) - val css = """ - - """ + val index_top = """ diff --git a/src/test/kotlin/html4tree/MainTest.kt b/src/test/kotlin/html4tree/MainTest.kt index 1349471..14ddc6d 100644 --- a/src/test/kotlin/html4tree/MainTest.kt +++ b/src/test/kotlin/html4tree/MainTest.kt @@ -705,4 +705,11 @@ class MainTest { assertFalse(processed, "fileKey mismatch should skip directory processing") assertFalse(listed, "fileKey mismatch should skip child listing") } + + @Test + fun testCssContent() { + kotlin.test.assertNotNull(cssContent) + kotlin.test.assertNotNull(styleHash) + kotlin.test.assertNotNull(css) + } } From de49b24ec83779cddf03d09643db00fdbb4122bb Mon Sep 17 00:00:00 2001 From: seonghobae <8172694+seonghobae@users.noreply.github.com> Date: Tue, 14 Jul 2026 21:36:58 +0000 Subject: [PATCH 2/4] =?UTF-8?q?=E2=9A=A1=20Bolt:=20=EC=9E=AC=EA=B7=80=20?= =?UTF-8?q?=ED=95=A8=EC=88=98=20=EB=82=B4=20=EC=A0=95=EC=A0=81=20=EC=97=90?= =?UTF-8?q?=EC=85=8B=20=EB=B0=8F=20=ED=95=B4=EC=8B=9C=20=EC=BA=90=EC=8B=B1?= =?UTF-8?q?=20=EC=B5=9C=EC=A0=81=ED=99=94?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - `process_dir` 루프 외부로 `cssContent`, `css`, `styleHash`를 추출하여 불필요한 문자열 생성 및 비싼 SHA-256 암호화 연산 반복 방지 - `process_ignore_file`에서 디렉토리 목록을 호출할 때 발생하는 O(N) I/O 낭비 방지를 위해 `dirListing` 변수로 캐싱 - 관련 테스트 코드 수정으로 100% 테스트 커버리지 유지 From 4d4c9b3db1fc29ad104565763fb5b6d25f0f03f8 Mon Sep 17 00:00:00 2001 From: seonghobae <8172694+seonghobae@users.noreply.github.com> Date: Tue, 14 Jul 2026 22:10:42 +0000 Subject: [PATCH 3/4] =?UTF-8?q?=E2=9A=A1=20Bolt:=20=EC=9E=AC=EA=B7=80=20?= =?UTF-8?q?=ED=95=A8=EC=88=98=20=EB=82=B4=20=EC=A0=95=EC=A0=81=20=EC=97=90?= =?UTF-8?q?=EC=85=8B=20=EB=B0=8F=20=ED=95=B4=EC=8B=9C=20=EC=BA=90=EC=8B=B1?= =?UTF-8?q?=20=EC=B5=9C=EC=A0=81=ED=99=94?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - `process_dir` 루프 외부로 `cssContent`, `css`, `styleHash`를 추출하여 불필요한 문자열 생성 및 비싼 SHA-256 암호화 연산 반복 방지 - `process_ignore_file`에서 디렉토리 목록을 호출할 때 발생하는 O(N) I/O 낭비 방지를 위해 `dirListing` 변수로 캐싱 - 관련 테스트 코드 수정으로 100% 테스트 커버리지 유지 From 2545783cd3e764e3edcd4654235258bc024cf7be Mon Sep 17 00:00:00 2001 From: seonghobae <8172694+seonghobae@users.noreply.github.com> Date: Tue, 14 Jul 2026 22:44:46 +0000 Subject: [PATCH 4/4] =?UTF-8?q?=E2=9A=A1=20Bolt:=20=EC=9E=AC=EA=B7=80=20?= =?UTF-8?q?=ED=95=A8=EC=88=98=20=EB=82=B4=20=EC=A0=95=EC=A0=81=20=EC=97=90?= =?UTF-8?q?=EC=85=8B=20=EB=B0=8F=20=ED=95=B4=EC=8B=9C=20=EC=BA=90=EC=8B=B1?= =?UTF-8?q?=20=EC=B5=9C=EC=A0=81=ED=99=94?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - `process_dir` 루프 외부로 `cssContent`, `css`, `styleHash`를 추출하여 불필요한 문자열 생성 및 비싼 SHA-256 암호화 연산 반복 방지 - `process_ignore_file`에서 디렉토리 목록을 호출할 때 발생하는 O(N) I/O 낭비 방지를 위해 `dirListing` 변수로 캐싱 - 관련 테스트 코드 수정으로 100% 테스트 커버리지 유지