chore(ci): label FTC-closed PRs as needs-issue

[Vidit-Ostwal]

Related issue

N/A — follow-up to the first-time contributor issue gate.

Summary

• Created the needs-issue label on crewAIInc/crewAI.
• The FTC workflow now applies that label before closing first-time contributor PRs that do not mention an open issue.
• Raised the workflow issues permission to write so labeling works on closed PRs.

Verification

• Tests added or updated for the changed behavior
• Relevant tests and quality checks pass locally (uv run pytest lib/crewai/tests/ci/test_ftc_require_issue.py)

Additional context

Filter auto-closed FTC PRs with is:pr is:closed label:needs-issue.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 13e52b9d-b63d-49ef-abf4-efbca3dddd52

📥 Commits

Reviewing files that changed from the base of the PR and between 92eb5f9 and 2543d58.

📒 Files selected for processing (4)

• .github/CONTRIBUTING.md
• .github/pull_request_template.md
• .github/workflows/ftc-require-issue.yml
• lib/crewai/tests/ci/test_ftc_require_issue.py

Included review availability: Your plan provides up to 10 included reviews per hour; 9 remain after this review.

---

📝 Walkthrough

Walkthrough

The first-time contributor workflow now adds the needs-issue label before closing pull requests without a valid open issue. Contributor documentation and regression tests describe and verify the new behavior.

Changes

First-time contributor issue enforcement

Layer / File(s)	Summary
Label invalid issue pull requests .github/workflows/ftc-require-issue.yml	The workflow requests issues: write permission and adds the needs-issue label before closing pull requests without a valid open issue.
Document and test label behavior .github/CONTRIBUTING.md, .github/pull_request_template.md, lib/crewai/tests/ci/test_ftc_require_issue.py	Contributor guidance includes the automatic label behavior. Tests verify that valid references do not add the label and foreign-repository references do add it.

Merge Risk: ⚪ Minimal · up to 2543d

The workflow now labels and closes first-time contributor PRs without a valid open issue reference, with matching documentation and regression coverage. No current merge-blocking risk remains.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 2 functions across 1 files. (3 skipped: 3 …	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description check	✅ Passed	The description includes all required sections and clearly explains the workflow, permission, labeling, and test changes. The Related issue section uses N/A instead of an issue reference, but the expl…
Title check	✅ Passed	The title clearly and concisely describes the primary change: labeling first-time-contributor PRs closed by CI as needs-issue.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Full details: Description check

Explanation

The description includes all required sections and clearly explains the workflow, permission, labeling, and test changes. The Related issue section uses N/A instead of an issue reference, but the explanation is relevant and the remaining required information is complete.

Full details: Docstring Coverage

Explanation

Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 2 functions across 1 files. (3 skipped: 3 unsupported.)

• Fix all pre-merge checks with AI

✨ Finishing Touches 💡 2

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/ftc-needs-issue-label

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}