# ============================================================================
# BlackRoad OS - Welcome New Contributors
# Copyright (c) 2025 BlackRoad OS, Inc. / Alexa Louise Amundson
# All Rights Reserved.
# ============================================================================
#
# Welcomes first-time contributors with helpful information.
# ============================================================================

name: Welcome

on:
  issues:
    types: [opened]
  pull_request_target:
    types: [opened]

permissions:
  issues: write
  pull-requests: write

jobs:
  welcome:
    name: Welcome New Contributors
    runs-on: ubuntu-latest
    steps:
      - uses: actions/first-interaction@v1
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}
          issue-message: |
            Welcome to BlackRoad OS! 👋

            Thank you for opening your first issue. We appreciate your contribution to making BlackRoad better.

            **Quick links:**
            - 📖 [Documentation](./docs/)
            - 🏗️ [Architecture Overview](./docs/ARCHITECTURE_LEARNING_RANK.md)
            - 💬 [Discussions](../../discussions)

            **While you wait:**
            - Make sure you've read the issue template completely
            - Add any relevant labels if you can
            - Feel free to ask questions if anything is unclear

            A maintainer will review your issue soon. Thank you for your patience!

            — *The BlackRoad OS Team* ✨

          pr-message: |
            Welcome to BlackRoad OS! 🎉

            Thank you for opening your first pull request. We're excited to review your contribution!

            **Before we review:**
            - [ ] Ensure CI checks pass
            - [ ] Add tests if applicable
            - [ ] Update documentation if needed
            - [ ] Ensure copyright headers are present

            **Review process:**
            1. A maintainer will review your PR
            2. They may request changes or ask questions
            3. Once approved, it will be merged

            **Need help?**
            - Check our [contribution guidelines](./CONTRIBUTING.md)
            - Ask questions in the PR comments
            - Join our discussions

            Thank you for contributing to BlackRoad OS!

            — *The BlackRoad OS Team* 🚀