seed-issues.yml

name: Seed Good First Issues

on:
  workflow_dispatch:

permissions:
  issues: write

jobs:
  seed:
    runs-on: ubuntu-latest

    steps:
      - name: Create starter issues
        uses: actions/github-script@v7
        with:
          script: |
            const bountyBody = (description) => [
              description,
              "",
              "## Acceptance Criteria",
              "",
              "- Keep the pull request focused.",
              "- Include a short summary of the change.",
              "- Link this issue in the pull request description.",
              "",
              "/bounty $50"
            ].join("\n");

            const issues = [
              {
                title: "Add JSDoc to userService",
                body: bountyBody("Add concise JSDoc comments to the user service functions so future contributors can understand the intended behavior.")
              },
              {
                title: "Fix typo in README",
                body: bountyBody("Review the README for minor spelling, grammar, or formatting issues and submit a small cleanup PR.")
              },
              {
                title: "Add type annotations to shared Button props",
                body: bountyBody("Review the shared UI package and improve type annotations for the Button stub without changing its public shape.")
              },
              {
                title: "Document environment variables",
                body: bountyBody("Add a short section describing expected local environment variables for the web and API apps.")
              },
              {
                title: "Improve Prisma schema comments",
                body: bountyBody("Add brief comments to the Prisma schema models explaining their role in the TaskFlow domain.")
              },
              {
                title: "Add input validation to user routes",
                body: bountyBody("Add lightweight validation for the user route stubs so invalid request shapes return a clear error response.")
              },
              {
                title: "Add API error handling helper",
                body: bountyBody("Introduce a small API error response helper for the Express app and use it from one route.")
              },
              {
                title: "Normalize health check response shape",
                body: bountyBody("Update the health check response to use a consistent envelope with status and data fields.")
              },
              {
                title: "Add request body size limit",
                body: bountyBody("Configure a conservative JSON body size limit in the Express app and document the expected value.")
              },
              {
                title: "Improve API route TODO coverage",
                body: bountyBody("Add clear TODO comments to the user route stubs describing expected future route behavior and error cases.")
              },
              {
                title: "Write unit tests for leaderboard updates",
                body: bountyBody("Add unit tests for the leaderboard update script covering new and existing contributors.")
              },
              {
                title: "Write unit tests for user routes",
                body: bountyBody("Add basic tests for the Express user route stubs covering list and create behavior.")
              },
              {
                title: "Write unit tests for UI Button stub",
                body: bountyBody("Add a small test for the shared Button stub covering label and disabled values.")
              },
              {
                title: "Improve PI calculation accuracy",
                body: bountyBody("Add a lightweight math or algorithm challenge that calculates PI and documents the chosen approach.")
              },
              {
                title: "Implement infinite sequence iterator",
                body: bountyBody("Implement a small infinite sequence utility with safe iteration examples and documentation.")
              }
            ];

            for (const issue of issues) {
              await github.rest.issues.create({
                owner: context.repo.owner,
                repo: context.repo.repo,
                title: issue.title,
                body: issue.body,
                labels: ["good first issue", "bounty", "AI agent friendly"]
              });
            }