labeler.yml

name: Issue Labeler

on:
  issues:
    types: [opened, edited]

jobs:
  label:
    runs-on: ubuntu-latest

    permissions:
      issues: write

    steps:
      - uses: actions/github-script@v8
        with:
          script: |
            // Single source of truth for keyword -> label matching.
            // Only labels here are ones a title can reliably signal.
            // Excluded on purpose (see PR description for why):
            //   dependencies, dockerfile, python:uv -> Dependabot-owned, PR-only scope
            //   duplicate, invalid, wontfix, help wanted -> maintainer triage judgment, not title-derivable
            //   size: small/medium/large -> handled by pr-size-labeler.yml
            //   Stale -> handled by a time-based stale workflow
            // To add a new label: add one entry below, nothing else to touch.
            const LABEL_KEYWORDS = {
              "bug": ["bug", "error", "crash", "broken", "fails", "failing", "not working"],
              "enhancement": ["feature", "enhancement", "improve", "improvement", "request"],
              "good first issue": ["good first issue", "beginner", "easy", "starter"],
              "documentation": ["docs", "documentation", "readme", "typo", "wiki"],
              "question": ["question", "how to", "help", "unclear", "clarification"],
              "cleanup": ["cleanup", "clean up", "refactor", "restructure", "rewrite", "tech debt", "remove unused", "dead code"],
              "reliability": ["reliability", "flaky", "intermittent", "race condition", "retry", "resiliency"],
            };

            const title = context.payload.issue.title.toLowerCase();
            const labels = Object.entries(LABEL_KEYWORDS)
              .filter(([, keywords]) => keywords.some((keyword) => title.includes(keyword)))
              .map(([label]) => label);

            if (labels.length > 0) {
              await github.rest.issues.addLabels({
                owner: context.repo.owner,
                repo: context.repo.repo,
                issue_number: context.issue.number,
                labels,
              });
            }