ContextualWisdomLab · seonghobae · Jul 31, 2026 · Jul 31, 2026 · Aug 4, 2026 · Aug 4, 2026
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,8 @@
 **Vulnerability:** 정적 HTML 생성 도구에서 매번 다른 Nonce를 동적으로 생성하여 CSP에 적용하는 것은, 캐싱 효율을 저하시킬 뿐만 아니라 정적 배포 환경(예: GitHub Pages 등)에서 올바른 보안 정책 수립을 방해할 수 있는 안티 패턴입니다.
 **Learning:** 정적으로 고정된 인라인 스타일이나 스크립트에는 난수화된 Nonce보다 콘텐츠 자체의 해시(SHA-256 등)를 사용하는 것이 안전하고 일관된 방식임을 배웠습니다.
 **Prevention:** 자동 생성되는 정적 HTML의 콘텐츠 보안 정책(CSP)에는 `style-src 'sha256-<HASH>'` 방식을 적용하고, `<style>` 태그에서 불필요한 `nonce` 속성을 제거하여 브라우저의 무결성 검증 기능을 적극 활용하십시오.
+
+## 2024-07-28 - [html4tree] index.html 파일 생성 시 원자적 쓰기(Atomic Move) 지원
+**Vulnerability:** 파일 교체 시 원자적 연산을 사용하지 않으면 파일이 교체되는 짧은 순간(TOCTOU)에 악의적인 프로세스나 스크립트가 부분적으로 쓰인 파일을 읽거나 심볼릭 링크로 교체하여 공격(예: 임의 파일 덮어쓰기)을 수행할 수 있습니다.
+**Learning:** `Files.move` 시 `StandardCopyOption.REPLACE_EXISTING`만을 사용하면 파일 시스템에 따라 원자성을 보장하지 않을 수 있습니다.
+**Prevention:** 파일 쓰기 시 먼저 임시 파일에 내용을 완전히 기록한 후, `StandardCopyOption.ATOMIC_MOVE`를 사용하여 원자적으로 최종 위치(예: `index.html`)로 이동시키십시오. 파일 시스템이 이를 지원하지 않는 환경을 위해 `AtomicMoveNotSupportedException` 예외를 처리하여 `REPLACE_EXISTING`으로 대체(Fallback)하도록 설계해야 합니다.
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/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/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt
@@ -2,6 +2,7 @@ package html4tree
 
 import java.io.File
 import java.security.MessageDigest
+import java.nio.file.AtomicMoveNotSupportedException
 import java.nio.file.Files
 import java.nio.file.LinkOption
 import java.nio.file.StandardCopyOption
@@ -229,12 +230,16 @@ fun process_ignore_file(curr_dir: File, dirFilesNames: Array<String>? = null): S
     return files_to_exclude
 }
 
-fun write_index_file(curr_dir: File, content: String) {
+fun write_index_file(curr_dir: File, content: String, moveFile: (java.nio.file.Path, java.nio.file.Path, Array<java.nio.file.CopyOption>) -> java.nio.file.Path = { src, dest, options -> Files.move(src, dest, *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 {
+            moveFile(tempPath, indexPath, arrayOf(StandardCopyOption.ATOMIC_MOVE, StandardCopyOption.REPLACE_EXISTING))
+        } catch (e: AtomicMoveNotSupportedException) {
+            moveFile(tempPath, indexPath, arrayOf(StandardCopyOption.REPLACE_EXISTING))
+        }
     } finally {
         Files.deleteIfExists(tempPath)
     }
@@ -304,9 +309,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;
@@ -373,7 +375,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
@@ -7,7 +7,9 @@ import org.junit.Test
 import java.io.ByteArrayOutputStream
 import java.io.File
 import java.io.PrintStream
+import java.nio.file.AtomicMoveNotSupportedException
 import java.nio.file.Files
+import java.nio.file.StandardCopyOption
 import kotlin.test.assertEquals
 import kotlin.test.assertFailsWith
 import kotlin.test.assertFalse
@@ -94,7 +96,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\""))
     }
 
@@ -429,6 +430,22 @@ class MainTest {
         assertFalse(File(subsubdir, "index.html").exists())
     }
 
+    @Test
+    fun testWriteIndexFileAtomicMoveNotSupported() {
+        val content = "test content"
+        var fallbackCalled = false
+        write_index_file(tempDir, content) { src, dest, options ->
+            if (options.contains(StandardCopyOption.ATOMIC_MOVE)) {
+                throw AtomicMoveNotSupportedException(src.toString(), dest.toString(), "Mocked exception")
+            } else {
+                fallbackCalled = true
+                Files.move(src, dest, *options)
+            }
-        write_index_file(tempDir, content) { src, dest, options ->
-            if (options.contains(StandardCopyOption.ATOMIC_MOVE)) {
-                throw AtomicMoveNotSupportedException(src.toString(), dest.toString(), "Mocked exception")
-            } else {
-                fallbackCalled = true
-                Files.move(src, dest, *options)
-            }
+        write_index_file(tempDir, content) { src, dest, options ->
+            if (options.contains(StandardCopyOption.ATOMIC_MOVE)) {
+                throw AtomicMoveNotSupportedException(src.toString(), dest.toString(), "Mocked exception")
+            } else {
+                fallbackCalled = true
+                assertEquals(1, options.size)
+                assertEquals(StandardCopyOption.REPLACE_EXISTING, options[0])
+                Files.move(src, dest, *options)
+            }
-        write_index_file(tempDir, content) { src, dest, options ->
-            if (options.contains(StandardCopyOption.ATOMIC_MOVE)) {
-                throw AtomicMoveNotSupportedException(src.toString(), dest.toString(), "Mocked exception")
-            } else {
-                fallbackCalled = true
-                Files.move(src, dest, *options)
-            }
+        write_index_file(tempDir, content) { src, dest, options ->
+            if (options.contains(StandardCopyOption.ATOMIC_MOVE)) {
+                throw AtomicMoveNotSupportedException(src.toString(), dest.toString(), "Mocked exception")
+            } else {
+                fallbackCalled = true
+                assertEquals(1, options.size)
+                assertEquals(StandardCopyOption.REPLACE_EXISTING, options[0])
+                Files.move(src, dest, *options)
+            }
+        }
+        assertTrue(fallbackCalled, "Fallback to REPLACE_EXISTING should have been called")
+        assertEquals(content, File(tempDir, "index.html").readText())
+    }
+
     @Test
     fun testGoIndexesNormalChildButSkipsSensitiveTraversal() {
         val subdir = File(tempDir, "subdir")