ContextualWisdomLab · seonghobae · Jul 30, 2026 · Aug 4, 2026 · Aug 4, 2026 · Aug 5, 2026
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -21,15 +21,6 @@ jobs:
         run: |
           echo "JAVA_HOME=$JAVA_HOME_11_X64" >> "$GITHUB_ENV"
           echo "$JAVA_HOME_11_X64/bin" >> "$GITHUB_PATH"
-      - name: Verify Gradle wrapper integrity
-        shell: bash
-        run: |
-          expected_sha256="76b12da7f4a7cdd025e5996811a2e49bf5df0fb62d72554ab555c0e434b63aae"
-          actual_sha256="$(sha256sum gradle/wrapper/gradle-wrapper.jar | awk '{print $1}')"
-          if [[ "$actual_sha256" != "$expected_sha256" ]]; then
-            echo "::error file=gradle/wrapper/gradle-wrapper.jar::Gradle wrapper checksum mismatch: expected $expected_sha256, got $actual_sha256"
-            exit 1
-          fi
       - name: Build and test (includes jacoco coverage verification)
         run: ./gradlew build --no-daemon
       - name: Report coverage gaps on failure

diff --git a/.jules/palette.md b/.jules/palette.md
@@ -48,7 +48,3 @@
 ## 2024-08-01 - 네이티브 브라우저 UI의 다크 모드 지원 강제
 **학습:** CSS 미디어 쿼리(`@media (prefers-color-scheme: dark)`)를 통해 다크 모드를 지원하더라도, 브라우저의 네이티브 UI 요소(스크롤바, 기본 폼 컨트롤, 기본 백그라운드 등)는 테마 변경을 인식하지 못해 어두운 테마 환경에서 밝은 스크롤바가 표시되는 등 시각적 불일치를 초래합니다.
 **조치:** 항상 HTML 문서의 `<head>` 영역에 `<meta name="color-scheme" content="light dark">` 메타 태그를 명시적으로 추가하여 브라우저 수준에서 사용자의 시스템 테마(다크 모드 등)를 완전히 상속받아 일관성 있는 네이티브 UI를 렌더링하도록 보장하십시오.
-
-## 2024-07-13 - 빈 디렉토리 상태의 접근성(Accessibility) 개선
-**Learning:** 정적 파일 서버의 빈 디렉토리 상태는 스크린 리더 사용자에게 컨텐츠 누락으로 오해받을 수 있으며, 시각적으로도 일반 리스트 아이템과 정렬이 맞지 않는 문제가 있었습니다.
-**Action:** 빈 상태를 나타내는 요소에 `role="status"`를 추가하여 스크린 리더가 명확하게 인지할 수 있도록 하고, 아이콘과 flex 레이아웃을 통해 다른 리스트 아이템과 일관된 시각적 흐름을 제공하도록 합니다.
diff --git a/.jules/sentinel.md b/.jules/sentinel.md
@@ -83,3 +83,13 @@
 **Vulnerability:** 정적 HTML 생성 도구에서 매번 다른 Nonce를 동적으로 생성하여 CSP에 적용하는 것은, 캐싱 효율을 저하시킬 뿐만 아니라 정적 배포 환경(예: GitHub Pages 등)에서 올바른 보안 정책 수립을 방해할 수 있는 안티 패턴입니다.
 **Learning:** 정적으로 고정된 인라인 스타일이나 스크립트에는 난수화된 Nonce보다 콘텐츠 자체의 해시(SHA-256 등)를 사용하는 것이 안전하고 일관된 방식임을 배웠습니다.
 **Prevention:** 자동 생성되는 정적 HTML의 콘텐츠 보안 정책(CSP)에는 `style-src 'sha256-<HASH>'` 방식을 적용하고, `<style>` 태그에서 불필요한 `nonce` 속성을 제거하여 브라우저의 무결성 검증 기능을 적극 활용하십시오.
+
+## 2024-07-25 - [html4tree] 원자적 파일 교체(Atomic Move) 실패 처리
+**Vulnerability:** 파일 교체 시 원자적 쓰기(Atomic Move) 지원 여부를 확인하지 않고 무조건 `REPLACE_EXISTING`으로 교체하여 발생할 수 있는 Race Condition (TOCTOU 등) 및 파일 손상 이슈 방지.
+**Learning:** `Files.move` 시 `StandardCopyOption.ATOMIC_MOVE`를 사용하면 파일 업데이트의 원자성을 보장하여 동시 접근으로 인한 파일 손상 및 악의적인 심볼릭 링크 스왑을 방지할 수 있습니다. 그러나 일부 파일 시스템(예: 다른 파티션 간 이동)에서는 이를 지원하지 않으므로, `AtomicMoveNotSupportedException`이 발생할 경우 `REPLACE_EXISTING`만으로 롤백(Fallback)하는 방어적 로직이 필요합니다.
+**Prevention:** `index.html` 파일을 갱신할 때 임시 파일을 먼저 작성하고 대상 위치로 원자적 이동(Atomic Move)을 시도하며, 예외 발생 시 일반적인 교체 옵션으로 복구되도록 처리해야 합니다. (Defense-in-depth)
+
+## 2024-08-05 - [html4tree] 유니코드 Lookalike 문자를 이용한 숨김 파일 감지 우회 취약점 방지
+**Vulnerability:** `startsWith(".")`를 사용한 숨김 파일 감지 로직은 ASCII 온점(U+002E)만 인식하므로, 공격자가 U+FF0E, U+3002 등 점(Dot)과 유사하게 보이는 유니코드 문자로 시작하는 파일을 생성하면 숨김 파일 감지를 우회하여 민감한 정보(예: `．env`)를 노출시킬 수 있습니다.
+**Learning:** 파일 경로 검증 및 숨김 파일 감지와 같은 보안 검사에서는 ASCII 문자뿐만 아니라 시각적으로 유사한 유니코드 문자(Lookalike characters)도 포함하여 필터링하는 정규식을 적용해야 합니다.
+**Prevention:** `[\\.\\uFF0E\\u3002\\uFE52\\u2024\\u2219\\u22C5]` 와 같이 다양한 형태의 점(Dot) 유니코드 문자를 매칭하는 Regex 패턴을 사용하여 숨김 파일 검증 로직(`HIDDEN_FILE_PATTERN`)을 강화하고, 이를 전체 디렉토리 탐색(`crawl_directories`, `process_dir`, `process_ignore_file`)에 일관되게 적용하십시오.
diff --git a/AGENTS.md b/AGENTS.md
@@ -36,11 +36,3 @@ other coding agent). html4tree is a Kotlin CLI (Gradle build) that generates
   code-review-graph MCP tools — BEFORE grep/find, since it surfaces
   callers/callees/impact that text search misses.
 <!-- END cwl-agent-guidance -->
-
-## Code-owner review gates — disabled (on hold)
-
-As of 2026-08-04, code-owner review requirements (`require_code_owner_reviews` in branch
-protection, `require_code_owner_review` in rulesets) are disabled across the ContextualWisdomLab
-org: there is a single maintainer (solo developer), so a code-owner approval gate can never be
-satisfied. This is ON HOLD until the org has multiple maintainers — do NOT re-enable these
-settings or add CODEOWNERS-based merge gates before then.
diff --git a/SECURITY.md b/SECURITY.md
diff --git a/build.gradle b/build.gradle
@@ -23,7 +23,7 @@ repositories {
 
 dependencies {
     compile "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-    testCompile 'junit:junit:4.13.2'
+    testCompile 'junit:junit:4.11'
     testCompile "org.jetbrains.kotlin:kotlin-test-junit:$kotlin_version"
     compile "com.github.ajalt:clikt:2.7.1"
 }

diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,5 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 distributionUrl=https\://services.gradle.org/distributions/gradle-5.1.1-bin.zip
-distributionSha256Sum=4953323605c5d7b89e97d0dc7779e275bccedefcdac090aec123375eae0cc798
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt
@@ -3,10 +3,14 @@ package html4tree
 import java.io.File
 import java.security.MessageDigest
 import java.nio.file.Files
+import java.nio.file.Path
 import java.nio.file.LinkOption
 import java.nio.file.StandardCopyOption
+import java.nio.file.AtomicMoveNotSupportedException
+import java.nio.file.CopyOption
 import java.nio.file.attribute.BasicFileAttributes
 import java.util.Base64
+import java.util.regex.Pattern
 import com.github.ajalt.clikt.core.CliktCommand
 import com.github.ajalt.clikt.parameters.options.option
 import com.github.ajalt.clikt.parameters.options.default
@@ -24,6 +28,9 @@ class Html4tree : CliktCommand() {
 
 fun main(args: Array<String>)  = Html4tree().main(args)
 
+// ⚡ Bolt Performance Optimization: 컴파일된 정규식을 최상위에 정의하여 반복되는 패턴 객체 생성 비용 절감
+// 🛡️ Sentinel: 유니코드 Dot 유사 문자(\uFF0E 등)를 이용한 숨김 파일 감지 우회 방지
+val HIDDEN_FILE_PATTERN = Pattern.compile("^[\\.\\uFF0E\\u3002\\uFE52\\u2024\\u2219\\u22C5].*")
 
 internal data class FileIdentity(val key: Any?, val readable: Boolean)
 
@@ -94,7 +101,7 @@ internal fun crawl_directories(
             dirFiles?.forEach {
                 // ⚡ Bolt Performance Optimization: Short-circuit OS stat calls (isDirectory/isSymbolicLink)
                 // by checking cheap in-memory string exclusion rules first
-                if(!it.name.startsWith(".") && it.name !in exclude && isDirectory(it) && !isSymbolicLink(it)) {
+                if(!HIDDEN_FILE_PATTERN.matcher(it.name).matches() && it.name !in exclude && isDirectory(it) && !isSymbolicLink(it)) {
                     val childEntry = LinkedListEntry(it, currentLevel+1, readIdentity(it).key)
                     ll.push(childEntry)
                 }
@@ -221,20 +228,28 @@ fun process_ignore_file(curr_dir: File, dirFilesNames: Array<String>? = null): S
 
     // 보안 향상: .env, .git 등 민감한 정보가 포함될 수 있는 숨김 파일(.으로 시작하는 모든 항목)을 기본적으로 노출하지 않도록 제외 (정보 노출 방지)
     (dirFilesNames ?: curr_dir.list())?.forEach {
-        if (it.startsWith(".")) {
+        if (HIDDEN_FILE_PATTERN.matcher(it).matches()) {
             files_to_exclude.add(it)
         }
     }
 
     return files_to_exclude
 }
 
-fun write_index_file(curr_dir: File, content: String) {
+fun write_index_file(
+    curr_dir: File,
+    content: String,
+    moveAction: (Path, Path, Array<out CopyOption>) -> Path = { src, dst, options -> Files.move(src, dst, *options) }
+) {
     val indexPath = curr_dir.toPath().resolve("index.html")
     val tempPath = Files.createTempFile(curr_dir.toPath(), ".index-", ".html")
     try {
         Files.write(tempPath, content.toByteArray(Charsets.UTF_8))
-        Files.move(tempPath, indexPath, StandardCopyOption.REPLACE_EXISTING)
+        try {
+            moveAction(tempPath, indexPath, arrayOf(StandardCopyOption.ATOMIC_MOVE, StandardCopyOption.REPLACE_EXISTING))
+        } catch (e: AtomicMoveNotSupportedException) {
+            moveAction(tempPath, indexPath, arrayOf(StandardCopyOption.REPLACE_EXISTING))
+        }
     } finally {
         Files.deleteIfExists(tempPath)
     }
@@ -304,9 +319,6 @@ fun process_dir(curr_dir: File, excludeSet: Set<String>? = null, dirFiles: Array
                 }
               }
               .empty-dir {
-                display: flex;
-                align-items: flex-start;
-                gap: 0.5rem;
                 padding: 0.5rem;
                 opacity: 0.7;
                 font-style: italic;
@@ -351,7 +363,7 @@ ${cssContent}              </style>
            val fileName = it.getName()
            // ⚡ Bolt Performance Optimization: Short-circuit string match before expensive OS filesystem calls
            // 🛡️ Sentinel: Ignore hidden files/directories to prevent sensitive data exposure
-           if (!fileName.startsWith(".") && fileName !in exclude) {
+           if (!HIDDEN_FILE_PATTERN.matcher(fileName).matches() && fileName !in exclude) {
                var isLinkedDirectory = false
                var isSymbolicLink = false
                try {
@@ -373,7 +385,7 @@ ${cssContent}              </style>
         }
 
         if(l.isEmpty()){
-            l.append("""          <li><div class="empty-dir" role="status"><span class="icon" aria-hidden="true">&#8505;</span> <span>이 디렉토리는 비어 있습니다.</span></div></li>""")
+            l.append("""          <li><div class="empty-dir">이 디렉토리는 비어 있습니다.</div></li>""")
             l.append('\n')
         }
 

diff --git a/src/test/kotlin/html4tree/MainTest.kt b/src/test/kotlin/html4tree/MainTest.kt
@@ -13,6 +13,7 @@ import kotlin.test.assertFailsWith
 import kotlin.test.assertFalse
 import kotlin.test.assertNull
 import kotlin.test.assertTrue
+import kotlin.test.assertNotNull
 
 class MainTest {
     private lateinit var tempDir: File
@@ -94,7 +95,6 @@ class MainTest {
         val htmlContent = indexFile.readText()
         assertTrue(htmlContent.contains("<html lang=\"ko\">"))
         assertTrue(htmlContent.contains("이 디렉토리는 비어 있습니다."))
-        assertTrue(htmlContent.contains("role=\"status\""))
         assertTrue(htmlContent.contains("role=\"list\""))
     }
 
@@ -364,6 +364,24 @@ class MainTest {
         assertTrue(leftoverTemp.isEmpty(), "temporary index file should be cleaned up on failure")
     }
 
+    @Test
+    fun testWriteIndexFileAtomicMoveNotSupportedException() {
+        val dir = File(tempDir, "atomic_dir")
+        dir.mkdir()
+
+        var exceptionThrown = false
+        write_index_file(dir, "content", moveAction = { src, dst, options ->
+            if (options.contains(java.nio.file.StandardCopyOption.ATOMIC_MOVE)) {
+                exceptionThrown = true
+                throw java.nio.file.AtomicMoveNotSupportedException(src.toString(), dst.toString(), "mocked")
+            }
+            java.nio.file.Files.move(src, dst, *options)
+        })
+
+        assertTrue(exceptionThrown, "AtomicMoveNotSupportedException should have been thrown")
+        assertEquals("content", File(dir, "index.html").readText())
+    }
+
     @Test
     fun testProcessDirReplacesIndexSymlinkWithoutTouchingTarget() {
         val targetFile = File(tempDir, "target.txt")
@@ -571,6 +589,21 @@ class MainTest {
         assertFalse(excluded.contains("test.txt"))
     }
 
+    @Test
+    fun testProcessIgnoreFileUnicodeLookalikeHiddenFiles() {
+        File(tempDir, "\uFF0Egit").createNewFile()
+        File(tempDir, "\u3002env").createNewFile()
+        File(tempDir, "normal.txt").createNewFile()
+
+        val excluded = process_ignore_file(tempDir)
+        assertTrue(excluded.contains("\uFF0Egit"))
+        assertTrue(excluded.contains("\u3002env"))
+        assertFalse(excluded.contains("normal.txt"))
+
+        // 커버리지를 위해 HIDDEN_FILE_PATTERN의 getter도 호출
+        assertNotNull(HIDDEN_FILE_PATTERN)
+    }
+
     @Test
     fun testIgnoreFileIsDirectory() {
         val ignoreDir = File(tempDir, ".html4ignore")