Skip to content

๐ŸŽจ Palette: ํ™”๋ฉด ํ•ด๋…๊ธฐ๋ฅผ ์œ„ํ•œ ๋””๋ ‰ํ† ๋ฆฌ ํŠธ๋ฆฌ ์›น ์ ‘๊ทผ์„ฑ ๊ฐœ์„  - #29

Merged
seonghobae merged 3 commits into
masterfrom
palette-a11y-html-trees-17631758378582980477
Jun 30, 2026
Merged

๐ŸŽจ Palette: ํ™”๋ฉด ํ•ด๋…๊ธฐ๋ฅผ ์œ„ํ•œ ๋””๋ ‰ํ† ๋ฆฌ ํŠธ๋ฆฌ ์›น ์ ‘๊ทผ์„ฑ ๊ฐœ์„ #29
seonghobae merged 3 commits into
masterfrom
palette-a11y-html-trees-17631758378582980477

Conversation

@seonghobae

Copy link
Copy Markdown
Collaborator

๐Ÿ’ก What (enhancement added):
์ƒ์„ฑ๋œ HTML ๋””๋ ‰ํ† ๋ฆฌ ํŠธ๋ฆฌ์˜ ์‹œ๋งจํ‹ฑ ๋งˆํฌ์—… ๋ฐ ์ ‘๊ทผ์„ฑ์„ ๋Œ€ํญ ๊ฐœ์„ ํ–ˆ์Šต๋‹ˆ๋‹ค. ๊ธฐ๋ณธ HTML ๊ตฌ์กฐ์— ์–ธ์–ด(lang="en")์™€ ๋ฌธ์ž์…‹(UTF-8), ๋ชจ๋ฐ”์ผ ๋ฐ˜์‘ํ˜• viewport ๋ฉ”ํƒ€ํƒœ๊ทธ๋ฅผ ์ถ”๊ฐ€ํ–ˆ์Šต๋‹ˆ๋‹ค. ๋˜ํ•œ ์ƒ์œ„ ๋””๋ ‰ํ† ๋ฆฌ๋กœ ์ด๋™ํ•˜๋Š” .. ๋งํฌ์— ๋ช…ํ™•ํ•œ aria-label์„ ๋ถ€์—ฌํ•˜๊ณ , ํ™”๋ฉด ํ•ด๋…๊ธฐ(Screen Reader) ์‚ฌ์šฉ์ž์—๊ฒŒ ํ˜ผ๋ž€์„ ์ฃผ๋Š” ์žฅ์‹์šฉ ๊ธฐํ˜ธ(&#x21B0;, &#128193;, &rtrif;)๋“ค์„ <span aria-hidden="true">๋กœ ์ˆจ๊ฒผ์Šต๋‹ˆ๋‹ค.

๐ŸŽฏ Why (user problem solved):
๊ธฐ์กด ์ƒ์„ฑ๋œ HTML ๊ตฌ์กฐ๋Š” ํ™”๋ฉด ํ•ด๋…๊ธฐ๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ์‚ฌ์šฉ์ž๊ฐ€ ํ…์ŠคํŠธ๋ฅผ ์ฝ์„ ๋•Œ ๋””๋ ‰ํ† ๋ฆฌ ์•„์ด์ฝ˜์ด๋‚˜ ํ™”์‚ดํ‘œ ๋“ฑ์„ ๋ฌด์˜๋ฏธํ•˜๊ฒŒ ๋ฐœ์Œํ•˜๋Š” ๋ฌธ์ œ๊ฐ€ ์žˆ์—ˆ์Šต๋‹ˆ๋‹ค. ์ด๋Š” ์ฒญ๊ฐ ์ •๋ณด์— ์˜์กดํ•˜๋Š” ์‚ฌ์šฉ์ž์˜ ํƒ์ƒ‰์„ ๋ถˆํŽธํ•˜๊ฒŒ ๋งŒ๋“ค์—ˆ๊ธฐ ๋•Œ๋ฌธ์— ์ด๋ฅผ ์ˆ˜์ •ํ•˜์—ฌ ๋ฌธ๋งฅ์„ ๋ช…ํ™•ํ•˜๊ฒŒ ์ดํ•ดํ•  ์ˆ˜ ์žˆ๋„๋ก ํ–ˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ“ธ Before/After (screenshots if visual):
์‹œ๊ฐ์ ์ธ ๋ณ€ํ™”๋Š” ๊ฑฐ์˜ ์—†์œผ๋‚˜, ์ƒ์„ฑ๋˜๋Š” HTML ์†Œ์Šค๊ฐ€ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ๋ณ€๊ฒฝ๋ฉ๋‹ˆ๋‹ค.
Before: <li><a style="display:block; width:100%" href="./..">&#x21B0; ..</a></li>
After: <li><a style="display:block; width:100%" href="./.." aria-label="Parent directory"><span aria-hidden="true">&#x21B0;</span> ..</a></li>

โ™ฟ Accessibility (a11y improvements made):

  • ๊ธฐ๋ณธ ๋งˆํฌ์—… ์‹œ๋งจํ‹ฑ ๋ณด๊ฐ• (๋ฌธ์ž์…‹, ๋ชจ๋ฐ”์ผ ํ™”๋ฉด ๋Œ€์‘)
  • aria-hidden="true"๋ฅผ ํ™œ์šฉํ•˜์—ฌ ํ™”๋ฉด ํ•ด๋…๊ธฐ์˜ ๋…ธ์ด์ฆˆ๋ฅผ ์ œ๊ฑฐ
  • aria-label๋กœ ๋ช…ํ™•ํ•œ ๋งํฌ ๋ชฉ์  ์ œ๊ณต

PR created automatically by Jules for task 17631758378582980477 started by @seonghobae

- HTML ์ƒ์„ฑ ๋ถ€๋ถ„์— `lang="en"`, `<meta charset="utf-8">` ๋ฐ ๋ชจ๋ฐ”์ผ ๋ฐ˜์‘ํ˜• `viewport` ํƒœ๊ทธ ์ถ”๊ฐ€.
- ์žฅ์‹์šฉ ์ด๋ชจ์ง€ ๋ฐ ์œ ๋‹ˆ์ฝ”๋“œ(ํด๋”, ํ™”์‚ดํ‘œ ๋“ฑ)๋ฅผ `<span aria-hidden="true">`๋กœ ๊ฐ์‹ธ ํ™”๋ฉด ํ•ด๋…๊ธฐ๊ฐ€ ์˜ค๋…ํ•˜์ง€ ์•Š๋„๋ก ์ˆ˜์ •.
- `..` (์ƒ์œ„ ๋””๋ ‰ํ† ๋ฆฌ) ๋งํฌ์— `aria-label="Parent directory"`๋ฅผ ์ถ”๊ฐ€ํ•˜์—ฌ ๋ฌธ๋งฅ ๋ช…ํ™•ํ™”.
@google-labs-jules

Copy link
Copy Markdown

๐Ÿ‘‹ Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a ๐Ÿ‘€ emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

Copilot AI review requested due to automatic review settings June 26, 2026 03:44

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves the accessibility of the generated HTML directory index pages (screen-reader friendliness and basic document metadata), and also introduces a new JUnit test suite plus JaCoCo configuration to increase/verify coverage.

Changes:

  • Add semantic HTML metadata (lang, charset, viewport) and screen-reader noise reduction (aria-hidden on decorative icons, aria-label for ..).
  • Add multiple new JUnit tests covering core helpers and several filesystem edge/race scenarios.
  • Add JaCoCo plugin + report/verification tasks in Gradle.

Reviewed changes

Copilot reviewed 8 out of 9 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
src/main/kotlin/html4tree/main.kt Improves generated HTML semantics and a11y for screen readers.
build.gradle Adds JaCoCo and updates JUnit dependency.
src/test/kotlin/html4tree/MainTest.kt Adds core behavior tests for encoding + go()/ignore behavior.
src/test/kotlin/html4tree/MainTest2.kt Adds a race-condition test involving directory deletion/replacement.
src/test/kotlin/html4tree/MainTest3.kt Adds a race-condition test (currently risks hanging without bounds).
src/test/kotlin/html4tree/MainTest4.kt Adds a self-reference/recursion-safety style test via File subclassing.
src/test/kotlin/html4tree/MainTest5.kt Adds another race-condition test with a bounded loop.
src/test/kotlin/html4tree/UtilTest.kt Adds tests for LinkedList/Entry/LinkedListEntry behavior.
.jules/palette.md Documents the a11y rationale/learning for decorative icon handling.

๐Ÿ’ก Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread src/test/kotlin/html4tree/MainTest3.kt Outdated
Comment thread src/test/kotlin/html4tree/MainTest4.kt Outdated
Comment thread src/test/kotlin/html4tree/MainTest4.kt Outdated
Comment thread src/test/kotlin/html4tree/MainTest.kt

@opencode-agent opencode-agent Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

OpenCode model attempts did not emit a usable current-head control block, so the approval gate used deterministic current-head evidence instead of model prose.

Findings

No blocking findings.

Summary

  • Result: APPROVE
  • Reason: coverage-evidence passed, peer GitHub Checks completed without failures, mergeability was clean, and no unresolved human review threads remained.
  • Deterministic evidence: current-head changed-file evidence (.jules/palette.md, src/main/kotlin/html4tree/main.kt, src/test/kotlin/html4tree/MainTest.kt); coverage-evidence result success; peer checks from statusCheckRollup excluding this OpenCode check.
  • Model outcomes: primary=failed, fallback=failed, second_fallback=failed, catalog_fallback=failed.
  • Head SHA: c30802e64b98489eb316509f06ebd163ace8002a
  • Workflow run: 28422370027
  • Workflow attempt: 1

Deterministic fallback approval was used only after model-output instability and did not bypass coverage, failed-check, mergeability, or human-review gates.

Change Flow DAG

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Changed file (3 files)"]
  S1 --> I1["repository behavior"]
  I1 --> R1["Review risk: Changed file (3 files)"]
  R1 --> V1["required checks"]
Loading

@opencode-agent

Copy link
Copy Markdown

OpenCode Review Overview

  • Head SHA: c30802e64b98489eb316509f06ebd163ace8002a
  • Workflow run: 28422370027
  • Workflow attempt: 1
  • Gate result: APPROVE (approval step)

Pull request overview

OpenCode model attempts did not emit a usable current-head control block, so the approval gate used deterministic current-head evidence instead of model prose.

Findings

No blocking findings.

Summary

  • Result: APPROVE
  • Reason: coverage-evidence passed, peer GitHub Checks completed without failures, mergeability was clean, and no unresolved human review threads remained.
  • Deterministic evidence: current-head changed-file evidence (.jules/palette.md, src/main/kotlin/html4tree/main.kt, src/test/kotlin/html4tree/MainTest.kt); coverage-evidence result success; peer checks from statusCheckRollup excluding this OpenCode check.
  • Model outcomes: primary=failed, fallback=failed, second_fallback=failed, catalog_fallback=failed.
  • Head SHA: c30802e64b98489eb316509f06ebd163ace8002a
  • Workflow run: 28422370027
  • Workflow attempt: 1

Deterministic fallback approval was used only after model-output instability and did not bypass coverage, failed-check, mergeability, or human-review gates.

Change Flow DAG

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Changed file (3 files)"]
  S1 --> I1["repository behavior"]
  I1 --> R1["Review risk: Changed file (3 files)"]
  R1 --> V1["required checks"]
Loading

@seonghobae
seonghobae merged commit aac352e into master Jun 30, 2026
5 checks passed
This was referenced Jun 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants