🎨 Palette: 터미널 출력 및 에러 메시지 UX/DX 개선

[seonghobae]

💡 What: CLI 터미널 출력에서 에러와 도움말 메시지의 접두어를 명확하게 표준화하고(❌ Error:, 💡 Hint:), 리포트 수량 출력 시 하드코딩된 복수형 대신 단수/복수를 문맥에 맞게 동적으로 표시하도록 개선했습니다.

🎯 Why:

• 일관되지 않은 에러 메시지와 힌트 구문은 사용자가 문제를 빠르게 파악하고 조치하는 데 방해가 됩니다. 명확한 접두어를 추가하여 가독성과 사용자 경험(DX)을 높였습니다.
• 1 components와 같은 어색한 문법적 오류를 방지하여 개발자 도구로서의 품질과 신뢰도를 향상시키기 위함입니다.

📸 Before/After:

• Before: ❌ Cannot start dashboard on 127.0.0.1:8787 (Address already in use).
• After: ❌ Error: Cannot start dashboard on 127.0.0.1:8787 (Address already in use).
• Before: 💡 Pass a free port with --port.
• After: 💡 Hint: Pass a free port with --port.
• Before: 📦 SBOM (1 components) written: ...
• After: 📦 SBOM (1 component) written: ...

♿ Accessibility: 스크린 리더 사용자를 비롯한 모든 사용자가 '에러'와 '힌트'를 명시적인 텍스트(Error:, Hint:)를 통해 이모지와 관계없이 동일하게 인식할 수 있도록 정보 접근성을 개선했습니다.

---

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

[google-labs-jules]

👋 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]

Pull request overview

This PR improves the AppGuardrail CLI’s terminal UX/accessibility by standardizing error/hint message prefixes (❌ Error:, 💡 Hint:) and fixing awkward pluralization in SBOM output.

Changes:

• Standardize CLI error and hint prefixes across scan/report/serve/dashboard/hook outputs.
• Add singular/plural handling for SBOM component counts (e.g., 1 component vs 2 components).
• Update unit tests to reflect the new output strings and minor formatting cleanups.

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated 1 comment.

File	Description
uv.lock	Adds a uv lock file for the project (editable local package).
tests/test_appguardrail.py	Updates assertions for the new Error: / Hint: prefixed output; minor formatting cleanup.
scanner/cli/appguardrail.py	Implements standardized CLI prefixes and SBOM pluralization logic; includes some formatting-only changes.
.jules/palette.md	Documents the learned convention for standardized CLI prefixes and dynamic pluralization.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 4 changed files in this pull request and generated 2 comments.

Comments suppressed due to low confidence (2)

scanner/cli/appguardrail.py:64

• Avoid using a backslash line continuation for imports; it’s inconsistent with the surrounding parenthesized-import style and is easy to break during edits. A single-line import fits here and is clearer.

from appguardrail_core.findings import \
    is_deploy_blocking as core_is_deploy_blocking

scanner/cli/appguardrail.py:3046

• Same redundancy as above: _console_print() already calls _format_msg() on strings, so the explicit _format_msg() wrapper is unnecessary and may lead to double-formatting in the future.

        _console_print(
            _format_msg(
                f"\n💡 Hint: Run 'appguardrail review' to get an AI prompt for fixing {these_word}."
            )
        )

[Copilot]

Pull request overview

Copilot reviewed 3 out of 4 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (2)

scanner/cli/appguardrail.py:64

• Avoid using a backslash line-continuation in an import; it’s fragile (whitespace-sensitive) and inconsistent with the surrounding parenthesized imports. Use a normal single-line import (or parentheses) instead.

from appguardrail_core.findings import \
    is_deploy_blocking as core_is_deploy_blocking

scanner/cli/appguardrail.py:3074

• This header currently prints "Hint: Tips:", which is redundant and makes the output less clear. Prefer a single label (e.g., "Tips:") to keep the section header concise and consistent.

    _console_print("💡 Hint: Tips:")