First Commit

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,76 @@
+name: 🐛 버그 신고
+description: 동작이 기대와 다르거나 오류가 발생하는 문제를 신고합니다.
+title: "[버그] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        신고해 주셔서 고맙습니다. 아래 항목을 채워 주시면 재현과 수정이 빨라집니다.
+        **보안 취약점은 이 템플릿이 아니라 [SECURITY.md](https://github.com/jiwoochris/artex-ko/security/policy)의 비공개 절차로 신고해 주십시오.**
+  - type: checkboxes
+    id: preflight
+    attributes:
+      label: 확인
+      options:
+        - label: 비슷한 이슈가 이미 열려 있는지 검색했습니다.
+          required: true
+        - label: 이 문제는 소유·허가 대상 또는 로컬 격리 환경에서 재현한 것입니다.
+          required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: 무슨 일이 일어났나요
+      description: 기대한 동작과 실제 동작을 함께 적어 주십시오.
+      placeholder: "예: 탐지 결과가 한국어로 나와야 하는데 중국어로 출력됩니다."
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: 재현 절차
+      description: 문제를 다시 만들어 낼 수 있는 단계를 순서대로 적어 주십시오.
+      placeholder: |
+        1. '...' 화면으로 이동
+        2. '...' 실행
+        3. '...' 에서 오류 발생
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: 로그·스크린샷
+      description: 관련 로그나 화면을 붙여 주십시오. 민감한 값(API 키·토큰·대상 주소)은 가려 주십시오.
+      render: shell
+    validations:
+      required: false
+  - type: dropdown
+    id: component
+    attributes:
+      label: 영역
+      description: 문제가 발생한 구성 요소를 고르십시오.
+      options:
+        - 에이전트 (agent)
+        - 웹 UI / 서버 (web / server)
+        - 설치·배포 (Docker·스크립트)
+        - LLM 공급자 연동
+        - 문서·번역
+        - 잘 모르겠음
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: 버전
+      description: 릴리스 태그 또는 커밋 해시를 적어 주십시오.
+      placeholder: "예: v2.2.0 또는 b45ba04"
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: 실행 환경
+      description: OS, Docker 사용 여부, LLM 모델 등을 적어 주십시오.
+      placeholder: "예: macOS 15 / Docker Compose / claude-opus-4-8"
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/bug_report_en.yml

@@ -0,0 +1,76 @@
+name: 🐛 Bug report
+description: Report behavior that differs from what you expected, or an error.
+title: "[bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for the report. Filling in the fields below helps us reproduce and fix it faster.
+        **Do not use this template for security vulnerabilities. Report them through the private process in [SECURITY.en.md](https://github.com/jiwoochris/artex-ko/blob/main/SECURITY.en.md).**
+  - type: checkboxes
+    id: preflight
+    attributes:
+      label: Checklist
+      options:
+        - label: I searched and no similar issue is already open.
+          required: true
+        - label: I reproduced this on a target I own or am authorized to test, or in a local isolated environment.
+          required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened
+      description: Describe both the expected behavior and the actual behavior.
+      placeholder: "e.g. Detection results should be in Korean, but they are printed in Chinese."
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      description: List, in order, the steps that recreate the problem.
+      placeholder: |
+        1. Go to the '...' screen
+        2. Run '...'
+        3. An error occurs at '...'
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs / screenshots
+      description: Paste relevant logs or screenshots. Please redact sensitive values (API keys, tokens, target addresses).
+      render: shell
+    validations:
+      required: false
+  - type: dropdown
+    id: component
+    attributes:
+      label: Area
+      description: Pick the component where the problem occurred.
+      options:
+        - Agent (agent)
+        - Web UI / server (web / server)
+        - Install / deploy (Docker / scripts)
+        - LLM provider integration
+        - Documentation / translation
+        - Not sure
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: Enter the release tag or commit hash.
+      placeholder: "e.g. v2.2.0 or b45ba04"
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: OS, whether you use Docker, the LLM model, and so on.
+      placeholder: "e.g. macOS 15 / Docker Compose / claude-opus-4-8"
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 🔒 보안 취약점 신고 · Report a security vulnerability
+    url: https://github.com/jiwoochris/artex-ko/security/policy
+    about: 보안 취약점은 공개 이슈로 올리지 마십시오. 보안 정책(SECURITY.md · English SECURITY.en.md)의 비공개 신고 절차를 따라 주십시오. / Do not file security vulnerabilities as public issues; follow the private process in the security policy.
+  - name: 📜 사용 범위와 법적 고지 · Authorized use and legal notice
+    url: https://github.com/jiwoochris/artex-ko#️-먼저-읽어-주세요--사용-범위와-국내법-고지
+    about: ARTEX 는 소유·허가 대상 또는 로컬 격리 환경에서만 사용할 수 있습니다. 사용 전에 범위와 국내법 고지를 읽어 주십시오. / ARTEX may be used only against targets you own or are authorized to test, or in a local isolated environment. See README.en.md.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,52 @@
+name: 💡 기능 제안
+description: 새로운 기능이나 개선 아이디어를 제안합니다.
+title: "[제안] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        아이디어를 제안해 주셔서 고맙습니다. 아래 항목을 채워 주시면 방향을 맞추기 좋습니다.
+  - type: checkboxes
+    id: preflight
+    attributes:
+      label: 확인
+      options:
+        - label: 비슷한 제안이 이미 열려 있는지 검색했습니다.
+          required: true
+        - label: 이 제안은 허가된 사용 범위와 국내법을 벗어난 사용을 조장하지 않습니다.
+          required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: 어떤 문제·필요에서 출발했나요
+      description: 해결하려는 상황을 먼저 적어 주십시오. 해결책보다 문제를 아는 것이 더 중요합니다.
+      placeholder: "예: 탐지 결과를 팀에 공유할 때 리포트를 PDF 로 내보내고 싶습니다."
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: 제안하는 방식
+      description: 어떻게 해결하면 좋을지 적어 주십시오.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 고려한 대안
+      description: 다른 방법을 생각해 봤다면 적어 주십시오.
+    validations:
+      required: false
+  - type: dropdown
+    id: area
+    attributes:
+      label: 관련 영역
+      options:
+        - 에이전트 (agent)
+        - 웹 UI / 서버 (web / server)
+        - LLM 공급자 연동
+        - 문서·번역
+        - 기타
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/feature_request_en.yml

@@ -0,0 +1,52 @@
+name: 💡 Feature request
+description: Suggest a new feature or an improvement.
+title: "[feature] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for the suggestion. Filling in the fields below helps us align on direction.
+  - type: checkboxes
+    id: preflight
+    attributes:
+      label: Checklist
+      options:
+        - label: I searched and no similar suggestion is already open.
+          required: true
+        - label: This suggestion does not encourage use outside the authorized scope or beyond applicable law.
+          required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem or need does this start from
+      description: Describe the situation you want to solve first. Understanding the problem matters more than the solution.
+      placeholder: "e.g. When I share detection results with my team, I want to export the report as a PDF."
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed approach
+      description: Describe how you think it could be solved.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: If you thought about other approaches, describe them.
+    validations:
+      required: false
+  - type: dropdown
+    id: area
+    attributes:
+      label: Related area
+      options:
+        - Agent (agent)
+        - Web UI / server (web / server)
+        - LLM provider integration
+        - Documentation / translation
+        - Other
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/translation_issue.yml

@@ -0,0 +1,56 @@
+name: 🌐 번역·현지화 오류
+description: 한국어 번역이 어색하거나 틀렸거나, 번역이 빠진 부분을 신고합니다.
+title: "[번역] "
+labels: ["i18n"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        한국어판의 품질을 높이는 데 도움을 주셔서 고맙습니다.
+        이 저장소의 현지화 방침은 **사용자에게 보이는 산출물만 한국어로 바꾸고, 에이전트의 내부 추론 프롬프트와 명령·페이로드·코드·로그 원문은 원문 그대로 둔다**는 것입니다.
+        자세한 원칙은 [CONTRIBUTING.md](https://github.com/jiwoochris/artex-ko/blob/main/CONTRIBUTING.md#현지화-방침)에 있습니다.
+  - type: dropdown
+    id: kind
+    attributes:
+      label: 어떤 종류의 문제인가요
+      options:
+        - 번역이 어색하거나 부자연스러움
+        - 번역이 틀렸음 (의미가 다름)
+        - 번역이 빠졌음 (여전히 중국어·영어로 보임)
+        - 번역하면 안 되는 것이 번역됨 (명령·코드·로그 등)
+        - 용어 통일 필요
+    validations:
+      required: true
+  - type: dropdown
+    id: where
+    attributes:
+      label: 어디에서 보이나요
+      options:
+        - 웹 UI
+        - 에이전트 산출물 (탐지 결과·요약·리포트·대화 응답)
+        - 문서 (README 등)
+        - 기타
+    validations:
+      required: true
+  - type: textarea
+    id: current
+    attributes:
+      label: 현재 문구
+      description: 지금 보이는 문구를 그대로 붙여 주십시오. 어느 화면·어느 상황인지도 적어 주시면 좋습니다.
+    validations:
+      required: true
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: 제안하는 문구
+      description: 어떻게 바꾸면 좋을지 제안해 주십시오. (선택)
+    validations:
+      required: false
+  - type: input
+    id: key
+    attributes:
+      label: 메시지 키 / 파일 위치
+      description: 아는 경우에만. 예를 들어 web/messages/ko.json 의 키나 파일 경로를 적어 주십시오.
+      placeholder: "예: web/messages/ko.json → dashboard.title"
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/translation_issue_en.yml

@@ -0,0 +1,56 @@
+name: 🌐 Translation / localization issue
+description: Report a Korean translation that reads awkwardly, is wrong, or is missing.
+title: "[translation] "
+labels: ["i18n"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for helping improve the quality of the Korean edition.
+        This repository's localization policy: **translate only user-facing output into Korean, and leave the agent's internal reasoning prompts and the original commands, payloads, code, and logs unchanged.**
+        The full principles are in [CONTRIBUTING.en.md](https://github.com/jiwoochris/artex-ko/blob/main/CONTRIBUTING.en.md#localization-policy).
+  - type: dropdown
+    id: kind
+    attributes:
+      label: What kind of problem is it
+      options:
+        - A translation reads awkwardly or unnaturally
+        - A translation is wrong (the meaning differs)
+        - A translation is missing (still shows Chinese / English)
+        - Something that should not be translated was translated (commands, code, logs, etc.)
+        - Terminology needs to be unified
+    validations:
+      required: true
+  - type: dropdown
+    id: where
+    attributes:
+      label: Where do you see it
+      options:
+        - Web UI
+        - Agent output (detection results, summaries, reports, chat responses)
+        - Documentation (README, etc.)
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: current
+    attributes:
+      label: Current text
+      description: Paste the text exactly as it appears now. Saying which screen or situation it is in helps too.
+    validations:
+      required: true
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: Suggested text
+      description: Suggest how it could be changed. (Optional)
+    validations:
+      required: false
+  - type: input
+    id: key
+    attributes:
+      label: Message key / file location
+      description: Only if you know it. For example, a key in web/messages/ko.json or a file path.
+      placeholder: "e.g. web/messages/ko.json → dashboard.title"
+    validations:
+      required: false