feat(eng): add contributor reporting and management scripts

- Add eng/README.md documenting maintainer utilities
- Add eng/contributor-report.mjs for generating contributor reports
- Add eng/add-missing-contributors.mjs for automating contributor additions
- Add eng/utils/graceful-shutdown.mjs for script lifecycle management
- Update eng/update-readme.mjs with minor fixes
- Update package.json with new contributor scripts

Generated-by: GitHub Copilot <[email protected]>
Signed-off-by: Ashley Childress <[email protected]>

Author: anchildress1

.all-contributorsrc

@@ -8,32 +8,52 @@ on:
 jobs:
   contributors:
     runs-on: ubuntu-latest
+    timeout-minutes: 12
     permissions:
       contents: write
       pull-requests: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
-          fetch-depth: 0
+          fetch-depth: 0  # Required: add-missing-contributors.js needs full git history
+
+      - name: Extract Node version from package.json
+        id: node-version
+        run: |
+          NODE_VERSION=$(jq -r '.engines.node // "22.x"' package.json)
+          echo "version=${NODE_VERSION}" >> "$GITHUB_OUTPUT"
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: "20"
+          node-version: ${{ steps.node-version.outputs.version }}
 
       - name: Install dependencies
-        run: npm install
+        run: npm ci
 
-      - name: Update contributors
-        run: npm run contributors:check
+      - name: Check and report contributors
+        run: |
+          CHECK_OUTPUT=$(npm run contributors:check 2>&1)
+          echo "$CHECK_OUTPUT"
+          
+          if echo "$CHECK_OUTPUT" | grep -q "Missing contributors"; then
+            echo "Missing contributors detected, generating report..."
+            mkdir -p reports
+            npm run contributors:report
+            
+            if [ -f reports/contributor-report.md ]; then
+              cat reports/contributor-report.md >> $GITHUB_STEP_SUMMARY
+            fi
+          else
+            echo "No missing contributors found"
+          fi
         env:
           PRIVATE_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        continue-on-error: true
 
       - name: Regenerate README
-        run: |
-          npm install
-          npm start
+        run: npm start
 
       - name: Check for changes
         id: verify-changed-files

.github/workflows/contributors.yml

@@ -1,6 +1,7 @@
 node_modules
 *.orig
 Copilot-Processing.md
+reports/
 
 # macOS system files
 .DS_Store

.gitignore

@@ -191,7 +191,8 @@ For full example of usage checkout edge-ai tasks collection:
    - A brief description of what your instruction/prompt does
    - Any relevant context or usage notes
 
-**Note**: Once your contribution is merged, you'll automatically be added to our [Contributors](./README.md#contributors-) section! We use [all-contributors](https://github.com/all-contributors/all-contributors) to recognize all types of contributions to the project.
+> [!NOTE] 
+> We use [all-contributors](https://github.com/all-contributors/all-contributors) to recognize all types of contributions to the project. Jump to [Contributors Recognition](#contributor-recognition) to learn more!
 
 ## What We Accept
 
@@ -225,21 +226,33 @@ To maintain a safe, responsible, and constructive community, we will **not accep
 - **Write clearly**: Use simple, direct language
 - **Promote best practices**: Encourage secure, maintainable, and ethical development practices
 
-## Contributors Recognition
+## Contributor Recognition
 
-This project uses [all-contributors](https://github.com/all-contributors/all-contributors) to recognize contributors. When you make a contribution, you'll automatically be recognized in our contributors list!
+We use [all-contributors](https://github.com/all-contributors/all-contributors) to recognize **all types of contributions** to this project.
 
-We welcome contributions of all types, including:
+To add yourself, leave a comment on a relevant issue or pull request using your GitHub username and the appropriate contribution type(s):
 
-- 📝 Documentation improvements
-- 💻 Code contributions
-- 🐛 Bug reports and fixes
-- 🎨 Design improvements
-- 💡 Ideas and suggestions
-- 🤔 Answering questions
-- 📢 Promoting the project
+```markdown
+@all-contributors add @username for contributionType1, contributionType2
+```
+
+The contributors list is updated automatically every Sunday at **3:00 AM UTC**. When the next run completes, your name will appear in the [README Contributors](./README.md#contributors-) section.
+
+### Contribution Types
+
+We welcome many kinds of contributions, including the custom categories below:
+
+| Category | Description | Emoji |
+| --- | --- | :---: |
+| **Instructions** | Custom instruction sets that guide GitHub Copilot behavior | 🧭 |
+| **Prompts** | Reusable or one-off prompts for GitHub Copilot | ⌨️ |
+| **Agents (Chat Modes)** | Defined Copilot roles or personalities | 🎭 |
+| **Collections** | Curated bundles of related prompts, agents, or instructions | 🎁 |
+
+In addition, all standard contribution types supported by [All Contributors](https://allcontributors.org/emoji-key/) are recognized.
+
+> Every contribution matters. Thanks for helping improve this resource for the GitHub Copilot community.
 
-Your contributions help make this resource better for the entire GitHub Copilot community!
 
 ## Code of Conduct