🎨 Palette: 양방향 텍스트(BiDi) 지원 추가

.jules/palette.md

@@ -69,3 +69,7 @@
 ## 2024-08-16 - 명확한 페이지 컨텍스트를 위한 문서 제목(Title) 개선
 **Learning:** 파일 서버 탐색 시 `<title>` 요소에 단순히 디렉토리 이름만 제공하면, 사용자가 여러 탭을 열어두었거나 화면 판독기를 통해 창을 전환할 때 해당 페이지가 '디렉토리 목록'임을 즉시 인지하기 어려워 접근성 및 사용성이 저하됩니다.
 **Action:** 항상 `<title>` 요소에 페이지의 목적을 명확히 알 수 있는 접미사(예: " - 디렉토리 목록")를 추가하여, 브라우저 탭 이름만으로도 컨텍스트를 제공할 수 있도록 하십시오.
+
+## 2024-08-17 - 텍스트 정렬을 위한 양방향 텍스트(BiDi) 지원 추가
+**Learning:** 파일 서버 탐색 시 디렉토리 또는 파일 이름이 우측에서 좌측으로(Right-To-Left) 읽히는 문자(예: 아랍어, 히브리어 등)로 시작하거나 섞여 있을 때, 기본 좌측에서 우측으로(Left-To-Right) 흐름 안에서는 레이아웃과 텍스트가 깨져 보이고 가독성이 저하될 수 있습니다.
+**Action:** 항상 파일 이름, 디렉토리 이름, 설명 등 동적 텍스트가 포함된 엘리먼트(`<h1>`, `<span>`)에 `dir="auto"` 속성을 추가하여, 브라우저가 해당 콘텐츠의 언어 특성에 맞춰 텍스트 방향을 자동으로 적절하게 렌더링하도록 보장하십시오.

.jules/sentinel.md

@@ -99,3 +99,7 @@
 **Root cause:** The protected implementation added canonical names to the exclusion set but did not compare each observed directory entry through a locale-stable normalized key.
 **Prevention:** Build one `Locale.ROOT` lowercase set from the canonical sensitive names, compare every observed name against it, and add the original spelling to the exclusion set so downstream exact membership remains correct.
 **Evidence:** `testProcessIgnoreFileTreatsSensitiveNamesCaseInsensitively` failed on test-only commit `472b916cd40f70693c4e1eb48956042a25353feb` (CI run `31469596932`) and passed with the source fix at `bb113d858ccfc42ddaecf6729749b238e5ade2d0` (CI run `31469921661`).
+
+## 2026-08-16 - 공백 우회를 방지하기 위한 파일 이름 유효성 검사
+**학습:** 보안 목적으로 파일 이름이나 확장자를 민감한 파일 목록(예: `defaultSensitiveFiles`)과 비교하여 제외할 때, 화이트스페이스(공백 등)가 포함된 이름(예: ` .git` 또는 `config.json `)은 단순 문자열 비교를 우회할 수 있습니다.
+**조치:** 블랙리스트나 필터링 규칙과 비교하기 전에 파일 이름에 대해 `.trim()`을 호출하여, 우발적이거나 악의적인 화이트스페이스 패딩으로 인한 우회를 방지하고 정확한 보안 정책을 적용하십시오.

src/main/kotlin/html4tree/main.kt

@@ -315,7 +315,7 @@ fun process_ignore_file(curr_dir: File, dirFilesNames: Array<String>? = null): S
        // ⚡ Bolt Performance Optimization: 디렉토리 목록을 Set에 추가하기 위해 필터링만 할 때는 정렬이 불필요하므로 .sorted()를 제거하여 O(N log N) 오버헤드를 방지합니다.
        val list = dirFilesNames ?: curr_dir.list()
        list?.forEach {
-           val current = it
+           val current = it.trim()
            val pathCurrent = try {
                java.nio.file.Paths.get(current)
            } catch (_: java.nio.file.InvalidPathException) {
@@ -340,16 +340,17 @@ fun process_ignore_file(curr_dir: File, dirFilesNames: Array<String>? = null): S
 
     // 보안 향상: dot-like prefixes and case variants of known sensitive names are excluded.
     (dirFilesNames ?: curr_dir.list())?.forEach {
-        val normalizedName = it.toLowerCase(java.util.Locale.ROOT)
+        val fileName = it.trim()
+        val normalizedName = fileName.toLowerCase(java.util.Locale.ROOT)
         if (
-            it.isHiddenFile() ||
+            fileName.isHiddenFile() ||
             normalizedName in Constants.defaultSensitiveFileNamesLowercase ||
             normalizedName.endsWith("~") ||
             Constants.defaultSensitiveExtensions.any { extension ->
                 normalizedName.endsWith(extension)
             }
         ) {
-            files_to_exclude.add(it)
+            files_to_exclude.add(fileName)
         }
     }
 
@@ -415,10 +416,10 @@ fun process_dir(curr_dir: File, excludeSet: Set<String>? = null, dirFiles: Array
      </head>
      <body>
        <main>
-         <h1>${directoryName.escapeHtml()}</h1>
+         <h1 dir="auto">${directoryName.escapeHtml()}</h1>
          <nav aria-label="디렉토리 목록">
          <ul role="list">
-            <li><a class="dir-link" href="./.." aria-label="상위 디렉토리로 이동" title="상위 디렉토리로 이동"><span class="icon" aria-hidden="true">&#x21B0;</span> <span>..</span></a></li>
+            <li><a class="dir-link" href="./.." aria-label="상위 디렉토리로 이동" title="상위 디렉토리로 이동"><span class="icon" aria-hidden="true">&#x21B0;</span> <span dir="auto">..</span></a></li>
 """ 
 
     val index_middle = fun():String{ 
@@ -448,14 +449,14 @@ fun process_dir(curr_dir: File, excludeSet: Set<String>? = null, dirFiles: Array
                   val encodedHref = if (isLinkedDirectory) { "./${fileName.urlEncodePath()}/" } else { "./${fileName.urlEncodePath()}" }
                   val ariaLabel = "${fileName} ${if (isLinkedDirectory) { "디렉토리" } else { "파일" }}".escapeHtml()
                   val icon = if (isLinkedDirectory) { "&#128193;" } else { "&#128196;" }
-                  l.append("""          <li><a class="dir-link" href="${encodedHref}" aria-label="${ariaLabel}" title="${ariaLabel}"><span class="icon" aria-hidden="true">${icon}</span> <span>${fileName.escapeHtml()}</span></a></li>""")
+                  l.append("""          <li><a class="dir-link" href="${encodedHref}" aria-label="${ariaLabel}" title="${ariaLabel}"><span class="icon" aria-hidden="true">${icon}</span> <span dir="auto">${fileName.escapeHtml()}</span></a></li>""")
                   l.append('\n')
                }
            }
         }
 
         if(l.isEmpty()){
-            l.append("""          <li><div class="empty-dir" role="status"><span class="icon" aria-hidden="true">&#128194;</span> <span>이 디렉토리는 비어 있습니다.</span></div></li>""")
+            l.append("""          <li><div class="empty-dir" role="status"><span class="icon" aria-hidden="true">&#128194;</span> <span dir="auto">이 디렉토리는 비어 있습니다.</span></div></li>""")
             l.append('\n')
         }
 

src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt

@@ -44,7 +44,7 @@ class GeneratedIndexReadabilityTest {
         )
 
         val generatedHtml = generatedHtml()
-        val parentIndex = generatedHtml.indexOf("<span>..</span>")
+        val parentIndex = generatedHtml.indexOf("<span dir=\"auto\">..</span>")
         val firstIndex = generatedHtml.indexOf("alpha.txt")
         val middleIndex = generatedHtml.indexOf("middle.txt")
         val lastIndex = generatedHtml.indexOf("zulu.txt")
@@ -62,7 +62,7 @@ class GeneratedIndexReadabilityTest {
 
         val generatedHtml = generatedHtml()
         val expectedEmptyRow =
-            """<li><div class="empty-dir" role="status"><span class="icon" aria-hidden="true">&#128194;</span> <span>이 디렉토리는 비어 있습니다.</span></div></li>"""
+            """<li><div class="empty-dir" role="status"><span class="icon" aria-hidden="true">&#128194;</span> <span dir="auto">이 디렉토리는 비어 있습니다.</span></div></li>"""
 
         assertTrue(generatedHtml.contains(expectedEmptyRow))
         assertTrue(generatedHtml.indexOf(expectedEmptyRow) == generatedHtml.lastIndexOf(expectedEmptyRow))

src/test/kotlin/html4tree/MainTest.kt

@@ -127,6 +127,26 @@ class MainTest {
         }
     }
 
+    @Test
+    fun testProcessIgnoreFileExcludesSensitiveNamesWithWhitespace() {
+        val sensitiveNamesWithWhitespace = arrayOf(
+            " .git",
+            "config.json ",
+            "\tsecrets.yml",
+            ".npmrc\r"
+        )
+        val safeNames = arrayOf(" public.txt ", "image.png")
+
+        val excluded = process_ignore_file(tempDir, sensitiveNamesWithWhitespace + safeNames)
+
+        sensitiveNamesWithWhitespace.forEach { name ->
+            assertTrue(excluded.contains(name.trim()), "'$name' must be excluded after trimming")
+        }
+        safeNames.forEach { name ->
+            assertFalse(excluded.contains(name.trim()), "'$name' must remain visible")
+        }
+    }
+
     @Test
     fun testGoIgnoresHiddenFilesAndDirectories() {
         val hiddenFile = File(tempDir, ".hidden_file.txt")
@@ -943,7 +963,7 @@ class MainTest {
         assertTrue(indexHtml.exists())
         val content = indexHtml.readText()
         assertTrue(content.contains("<title>Root - 디렉토리 목록</title>"))
-        assertTrue(content.contains("<h1>Root</h1>"))
+        assertTrue(content.contains("<h1 dir=\"auto\">Root</h1>"))
     }
 
 }