Skip to content

feat: add contribution readiness assistant - #71

Merged
arnabnandy7 merged 1 commit into
mainfrom
feature/contributionReadiness
Sep 1, 2026
Merged

feat: add contribution readiness assistant#71
arnabnandy7 merged 1 commit into
mainfrom
feature/contributionReadiness

Conversation

@arnabnandy7

Copy link
Copy Markdown
Owner

Summary

Adds a contribution-readiness assistant that helps contributors evaluate issues before investing time.

Closes #54.

Changes

  • Retrieves cached GitHub community-profile metadata for a bounded set of repositories.
  • Evaluates repository documentation, activity, maintainer responsiveness, assignment state, discussion signals, and linked pull requests.
  • Classifies issues as:
    • Ready to start
    • Ask before starting
    • Possibly claimed
    • Poorly documented
    • Repository inactive
    • Readiness unknown
  • Displays a readiness badge and expandable checklist on issue cards.
  • Links directly to available contribution documentation.
  • Adds a URL-backed and saved-search-backed Ready to start filter.
  • Reuses readiness in personalized recommendations and weekly digests.
  • Returns an unknown state when community metadata is unavailable.
  • Updates the architecture, setup, contribution, and project documentation.
  • Removes the obsolete SQL migration files now represented by the architecture documentation.

Database changes

Adds the following field to saved_search:

readiness TEXT NOT NULL DEFAULT 'any'

The schema change has been applied to both preview and production databases. Existing saved searches default to unrestricted readiness.

GitHub API usage

  • Community-profile requests are limited to 12 repositories per search.
  • Responses are cached for six hours.
  • Optional enrichment failures do not prevent issue discovery.
  • Ready-only searches exclude issues with linked pull requests through GitHub’s search qualifier.

@arnabnandy7 arnabnandy7 added this to the 1.2.0 milestone Aug 31, 2026
@arnabnandy7 arnabnandy7 self-assigned this Aug 31, 2026
@arnabnandy7 arnabnandy7 added the enhancement New feature or request label Aug 31, 2026
@vercel

vercel Bot commented Aug 31, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
openissue-dev Ready Ready Preview Sep 1, 2026 3:20pm UTC

chatgpt-codex-connector[bot]

This comment was marked as outdated.

@arnabnandy7
arnabnandy7 force-pushed the feature/contributionReadiness branch 8 times, most recently from dd067ba to efadee3 Compare September 1, 2026 15:15
@sonarqubecloud

sonarqubecloud Bot commented Sep 1, 2026

Copy link
Copy Markdown

@arnabnandy7
arnabnandy7 merged commit 65c147f into main Sep 1, 2026
7 checks passed
@github-project-automation github-project-automation Bot moved this from To Do to Completed in Open issue portal development Sep 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

Development

Successfully merging this pull request may close these issues.

Contribution readiness assistant

1 participant