# OpenPocketCine GitHub Labels
#
# This file documents the canonical labels used for issues, pull requests,
# and (where relevant) discussions in this repository.
#
# These labels help with triage, prioritization, contributor onboarding,
# and finding work in specific areas of the codebase.
#
# ------------------------------------------------------------------
# How to apply these labels
# ------------------------------------------------------------------
#
# Option A: GitHub CLI (recommended)
#
#   gh label create "bug" --color "d73a4a" --description "Something isn't working"
#   ... (see full list of commands below)
#
# Option B: GitHub web UI
#   Go to Issues → Labels → New label (or edit the defaults)
#
# After initial creation, labels are managed manually or via PRs that
# update this file + the corresponding gh commands.

# ------------------------------------------------------------------
# Type labels (primary classification)
# ------------------------------------------------------------------
- name: bug
  color: d73a4a
  description: Something isn't working as expected

- name: enhancement
  color: a2eeef
  description: New feature, improvement, or request

- name: documentation
  color: 0075ca
  description: Improvements or additions to documentation

- name: question
  color: d876e3
  description: Further information is requested

- name: chore
  color: fef2c0
  description: Maintenance, cleanup, or non-user-facing work

# ------------------------------------------------------------------
# Priority
# ------------------------------------------------------------------
- name: P0
  color: b60205
  description: Critical / blocking — must be addressed immediately

- name: P1
  color: d93f0b
  description: High priority — important for current cycle

- name: P2
  color: 0e8a16
  description: Normal / medium priority

# ------------------------------------------------------------------
# Community & contribution
# ------------------------------------------------------------------
- name: good first issue
  color: 7057ff
  description: Good for newcomers / first-time contributors

- name: help wanted
  color: 008672
  description: Extra attention is needed — community help appreciated

# ------------------------------------------------------------------
# Triage & status
# ------------------------------------------------------------------
- name: needs-triage
  color: ededed
  description: New issue that has not yet been triaged

- name: needs-info
  color: e4e669
  description: More information is needed from the reporter

- name: duplicate
  color: cfd3d7
  description: This issue or pull request already exists

- name: wontfix
  color: ffffff
  description: This will not be worked on

- name: invalid
  color: e4e669
  description: This doesn't seem right

- name: blocked
  color: e4e669
  description: Blocked by another issue, dependency, or decision

- name: ready
  color: 0e8a16
  description: Triaged and ready to pick up

- name: roadmap
  color: 5319e7
  description: Proposed product direction tracked in GitHub Discussions

# ------------------------------------------------------------------
# Area / component labels
# ------------------------------------------------------------------
- name: area:core
  color: 1d76db
  description: Shared Swift core (Sources/OpenPocketViewCore)

- name: area:protocol
  color: 1d76db
  description: DUML protocol, BLE, Wi-Fi, datalink

- name: area:ios
  color: 1d76db
  description: iOS SwiftUI shell (ios/OpenPocketCine)

- name: area:live-view
  color: 1d76db
  description: Live view streaming, rendering, and related pipeline

- name: area:monitoring
  color: 1d76db
  description: Monitoring assists (false color, scopes, zebra, guides, etc.)

- name: area:control
  color: 1d76db
  description: Camera control (record, mode, and related commands)

- name: area:ui
  color: 1d76db
  description: General UI/UX, layout, design system

- name: area:android
  color: 1d76db
  description: Android / Jetpack Compose work

- name: area:media
  color: 1d76db
  description: Media browsing, playback, LUT import, clip handling

- name: area:docs
  color: 1d76db
  description: Documentation, README, specs, contributing guides

# ------------------------------------------------------------------
# Other useful labels
# ------------------------------------------------------------------
- name: security
  color: ee0701
  description: Security-related issue or pull request

- name: dependencies
  color: 0366d6
  description: Dependency updates or related changes

# ------------------------------------------------------------------
# Full gh label create commands (copy-paste ready)
# ------------------------------------------------------------------
# gh label create "bug" --color "d73a4a" --description "Something isn't working as expected"
# gh label create "enhancement" --color "a2eeef" --description "New feature or improvement"
# gh label create "documentation" --color "0075ca" --description "Improvements or additions to documentation"
# gh label create "question" --color "d876e3" --description "Further information is requested"
# gh label create "chore" --color "fef2c0" --description "Maintenance, cleanup, or non-user-facing work"
#
# gh label create "P0" --color "b60205" --description "Critical / blocking — must be addressed immediately"
# gh label create "P1" --color "d93f0b" --description "High priority — important for current cycle"
# gh label create "P2" --color "0e8a16" --description "Normal / medium priority"
#
# gh label create "good first issue" --color "7057ff" --description "Good for newcomers / first-time contributors"
# gh label create "help wanted" --color "008672" --description "Extra attention is needed — community help appreciated"
#
# gh label create "needs-triage" --color "ededed" --description "New issue that has not yet been triaged"
# gh label create "needs-info" --color "e4e669" --description "More information is needed from the reporter"
# gh label create "duplicate" --color "cfd3d7" --description "This issue or pull request already exists"
# gh label create "wontfix" --color "ffffff" --description "This will not be worked on"
# gh label create "invalid" --color "e4e669" --description "This doesn't seem right"
# gh label create "blocked" --color "e4e669" --description "Blocked by another issue, dependency, or decision"
# gh label create "ready" --color "0e8a16" --description "Triaged and ready to pick up"
# gh label create "roadmap" --color "5319e7" --description "Proposed product direction tracked in GitHub Discussions"
#
# gh label create "area:core" --color "1d76db" --description "Shared Swift core (Sources/OpenPocketViewCore)"
# gh label create "area:protocol" --color "1d76db" --description "DUML protocol, BLE, Wi-Fi, datalink"
# gh label create "area:ios" --color "1d76db" --description "iOS SwiftUI shell (ios/OpenPocketCine)"
# gh label create "area:live-view" --color "1d76db" --description "Live view streaming, rendering, and related pipeline"
# gh label create "area:monitoring" --color "1d76db" --description "Monitoring assists (false color, scopes, zebra, guides, etc.)"
# gh label create "area:control" --color "1d76db" --description "Camera control (record, mode, and related commands)"
# gh label create "area:ui" --color "1d76db" --description "General UI/UX, layout, design system"
# gh label create "area:android" --color "1d76db" --description "Android / Jetpack Compose work"
# gh label create "area:media" --color "1d76db" --description "Media browsing, playback, LUT import, clip handling"
# gh label create "area:docs" --color "1d76db" --description "Documentation, README, specs, contributing guides"
#
# gh label create "security" --color "ee0701" --description "Security-related issue or pull request"
# gh label create "dependencies" --color "0366d6" --description "Dependency updates or related changes"