feat: Add new process and move contributors

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,48 +1,59 @@
-<!-- Please fill in all areas in this PR form. Incomplete PRs will be marked invalid and may be closed. -->
+## Type of Contribution
 
-## Description
+<!-- Please check ONE box that best describes your contribution -->
 
-<!--
-Please do not leave this blank. Add your description **below** this line and **outside** of the comment tags.
-For example: This PR adds <your-github-username> as a contributor.
--->
+- [ ] 🎉 **Adding myself as a new contributor** (following the intro course)
+- [ ] 🐛 **Bug fix**
+- [ ] ✨ **New feature** 
+- [ ] 📝 **Documentation update**
+- [ ] 🔧 **Other maintenance/improvement**
 
-## What type of PR is this? (check all applicable)
+---
 
-- [ ] 🤝 Add a contributor
-- [ ] 📝 Documentation Update
+## For New Contributors (Adding Yourself to Guestbook)
 
-## Related Issues
+<!-- Only fill this section if you checked "Adding myself as a new contributor" above -->
 
-<!--
-Add your related issue **below** this line and **outside** of the comment tags.
+### Checklist for Adding Yourself
+- [ ] I created a file named `contributors/[my-github-username].json`
+- [ ] I filled in all required fields: `name`, `github`, `contributions`, `profile`
+- [ ] I only added ONE file (my contributor JSON file)
+- [ ] My JSON file is valid (no syntax errors)
+- [ ] I'm taking the Intro to Open Source course
 
-Please use this format to link your issue: Closes #XXX.
-Change "XXX" to your issue number that you can find next to your issue's title.
-
-More information about link issue: https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue
--->
+### About Me
+- **Name:**
+- **Location (optional):**
+- **What I'm learning:**
+- **Fun fact:**
 
-## Contributors Checklist
+---
 
-### I've read through the [Getting Started](https://intro.opensauced.pizza/#/intro-to-oss/how-to-contribute-to-open-source?id=getting-started) section
+## For Other Contributions
 
-- [ ] ✅ Yes
-- [ ] ❌ Not yet
+<!-- Fill this section for bug fixes, features, documentation, etc. -->
 
-### Have you run `npm run contributors:generate` to generate your profile and the badge on the README?
+### Description
+<!-- Describe what this PR changes and why -->
 
-- [ ] ✅ Yes
-- [ ] ❌ No
+### Changes Made
+<!-- List the specific changes -->
+- 
+- 
+- 
 
-## Added to documentation?
+### Screenshots (if applicable)
+<!-- Add screenshots for UI changes -->
 
-- [ ] 📜 README.md
-- [ ] 🙅 no documentation needed
+### Testing
+- [ ] I have tested these changes locally
+- [ ] I have reviewed my own code
+- [ ] I have added/updated documentation if needed
 
-## Screenshot (Required for PR Review)
+---
 
-<!-- Please provide a screenshot of your profile being generated on the README. This ensures that you ran the `npm run contributors:generate` command, as mentioned in the previous question, which makes it easier for the maintainers to review PRs. All PRs without screenshots will be automatically rejected-->
+## Additional Notes
+<!-- Any additional context, concerns, or information -->
 
 ## [optional] What GIF best describes this PR or how it makes you feel?
 

.github/workflows/update-contributors.yml

@@ -0,0 +1,146 @@
+name: Update Contributors
+
+on:
+  push:
+    branches: [main]
+    paths: ['contributors/*.json']
+
+  # Allow manual triggering for maintenance
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: read
+
+jobs:
+  update-contributors:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Install dependencies
+        run: npm install -g all-contributors-cli
+
+      - name: Backup current contributors
+        run: cp .all-contributorsrc .all-contributorsrc.backup || echo "No existing config found"
+
+      - name: Reset all-contributors config
+        run: |
+          node -e "const fs=require('fs'); fs.writeFileSync('.all-contributorsrc', JSON.stringify({projectName:'guestbook',projectOwner:'OpenSource-Community',repoType:'github',repoHost:'https://github.com',files:['README.md'],imageSize:100,commit:false,commitConvention:'angular',contributors:[]},null,2));"
+
+      - name: Write contributor update script
+        run: |
+          cat > /tmp/add-contributor.js << 'EOF'
+          const fs = require('fs');
+          const filePath = process.argv[2];
+          const rcFile = '.all-contributorsrc';
+          const d = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+          const rc = JSON.parse(fs.readFileSync(rcFile, 'utf8'));
+          const username = d.github || '';
+          const existing = rc.contributors.find(c => c.login === username);
+          if (!existing && username) {
+            rc.contributors.push({
+              login: username,
+              name: d.name || '',
+              avatar_url: 'https://avatars.githubusercontent.com/' + username,
+              profile: d.profile || ('https://github.com/' + username),
+              contributions: d.contributions || []
+            });
+            fs.writeFileSync(rcFile, JSON.stringify(rc, null, 2));
+            console.log('Added: ' + username);
+          } else if (existing) {
+            console.log('Already exists: ' + username);
+          } else {
+            console.error('Error: missing github field in ' + filePath);
+            process.exit(1);
+          }
+          EOF
+
+      - name: Process contributor files
+        run: |
+          echo "Processing contributor files..."
+
+          if [ ! -d "contributors" ] || [ -z "$(ls -A contributors/*.json 2>/dev/null)" ]; then
+            echo "No contributor files found"
+            exit 0
+          fi
+
+          total_files=$(ls -1 contributors/*.json 2>/dev/null | grep -v -E '(example-contributor\.json|\.gitkeep|README\.md)' | wc -l)
+          echo "Found $total_files contributor files to process"
+
+          processed=0
+          for file in contributors/*.json; do
+            if [ -f "$file" ]; then
+              filename=$(basename "$file")
+
+              if [[ "$filename" == "example-contributor.json" ]] || [[ "$filename" == ".gitkeep" ]] || [[ "$filename" == "README.md" ]]; then
+                echo "Skipping template file: $filename"
+                continue
+              fi
+
+              echo "Processing $file"
+
+              if ! node -e "JSON.parse(require('fs').readFileSync(process.argv[1],'utf8'))" "$file" 2>/dev/null; then
+                echo "Error: Invalid JSON in $file"
+                continue
+              fi
+
+              name=$(node -e "const d=JSON.parse(require('fs').readFileSync(process.argv[1],'utf8')); process.stdout.write(d.name||'')" "$file")
+              github_username=$(node -e "const d=JSON.parse(require('fs').readFileSync(process.argv[1],'utf8')); process.stdout.write(d.github||'')" "$file")
+              contributions=$(node -e "const d=JSON.parse(require('fs').readFileSync(process.argv[1],'utf8')); process.stdout.write((d.contributions||[]).join(','))" "$file")
+
+              if [ -z "$name" ] || [ -z "$github_username" ] || [ -z "$contributions" ]; then
+                echo "Error: Missing required fields in $file"
+                continue
+              fi
+
+              echo "Adding contributor: $name (@$github_username)"
+              node /tmp/add-contributor.js "$file"
+
+              processed=$((processed + 1))
+            fi
+          done
+
+          echo "Processed $processed contributor files"
+
+      - name: Generate contributors section
+        run: npx all-contributors generate
+
+      - name: Check for changes
+        id: changes
+        run: |
+          if [ -n "$(git status --porcelain)" ]; then
+            echo "changes=true" >> $GITHUB_OUTPUT
+          else
+            echo "changes=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Commit and push changes
+        if: steps.changes.outputs.changes == 'true'
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "Contributors Bot"
+          git add .
+          git commit -m "chore: update contributors list
+
+          Auto-generated from contributors/*.json files
+
+          [skip ci]"
+          git push
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Success notification
+        if: steps.changes.outputs.changes == 'true'
+        run: |
+          echo "Contributors list updated successfully!"
+          echo "Changes committed and pushed to main branch."

.github/workflows/validate-contributor.yml

@@ -0,0 +1,74 @@
+name: Validate Contributor
+
+on:
+  pull_request:
+    paths:
+      - 'contributors/*.json'
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout PR
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Get changed files
+        id: changed-files
+        uses: tj-actions/changed-files@v39
+        with:
+          files: |
+            contributors/*.json
+
+      - name: Validate contributor files
+        if: steps.changed-files.outputs.any_changed == 'true'
+        run: |
+          echo "🔍 Validating contributor files..."
+
+          # Install dependencies
+          npm install
+
+          # Run validation
+          node scripts/validate-contributor.js
+
+          # Check specific changed files
+          for file in ${{ steps.changed-files.outputs.all_changed_files }}; do
+            echo "Checking $file"
+
+            if [[ "$file" == contributors/*.json ]]; then
+              filename=$(basename "$file")
+              username="${filename%.json}"
+
+              # Run preview for the specific file
+              echo "Preview for $username:"
+              node scripts/preview-contribution.js "$username"
+            fi
+          done
+
+      - name: Comment on PR
+        if: failure()
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '❌ Your contributor file has validation errors. Please check the [action logs](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}) for details.\n\nCommon issues:\n- Username in filename must match the `github` field in JSON\n- All required fields must be present: `name`, `github`, `contributions`\n- Use valid contribution types\n\nNeed help? Check the [contributor guide](docs/guides/contributor-guide.md).'
+            })
+
+      - name: Success comment
+        if: success() && steps.changed-files.outputs.any_changed == 'true'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '✅ Your contributor file is valid! Once this PR is merged, you\'ll automatically appear in the contributors section.\n\nThank you for your contribution! 🎉'
+            })

.github/workflows/validate-contributors.yml

@@ -0,0 +1,52 @@
+name: Validate Contributors
+
+on:
+  pull_request:
+    paths:
+      - 'contributors/*.json'
+  push:
+    branches: [main]
+    paths:
+      - 'contributors/*.json'
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+
+      - name: Validate contributor files
+        run: |
+          python3 scripts/validate-contributor.py
+
+      - name: Check for duplicate contributors
+        run: |
+          # Check for duplicate GitHub usernames
+          duplicates=$(find contributors/ -name "*.json" -exec basename {} .json \; | sort | uniq -d)
+          if [ -n "$duplicates" ]; then
+            echo "❌ Duplicate contributor files found:"
+            echo "$duplicates"
+            exit 1
+          else
+            echo "✅ No duplicate contributors found"
+          fi
+
+      - name: Validate JSON syntax
+        run: |
+          echo "🔍 Validating JSON syntax..."
+          for file in contributors/*.json; do
+            if [ -f "$file" ]; then
+              echo "Checking $file..."
+              python3 -c "import json; json.load(open('$file'))" || {
+                echo "❌ Invalid JSON in $file"
+                exit 1
+              }
+            fi
+          done
+          echo "✅ All JSON files have valid syntax"