Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Incomplete PR feedback API surface in github-code skill

Aperta Adatta ai principianti
  • Qualcosa non va?
#359 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
72/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Tranquilla
Stack tecnologico
github, graphql, markdown, shell
Ambito
api, developer-experience, documentation

Direzione di ricerca

Inizia con api-surface.md dello skill github-code e confronta i suoi endpoint documentati per il feedback delle PR con le chiamate REST e GraphQL elencate nell'issue. Aggiungi la sezione Complete PR Feedback Retrieval, le indicazioni sulla paginazione, i limiti di gh pr view, la nota sulle modifiche suggerite e la copertura delle reazioni e delle ricerche dirette. Il lavoro è completo quando tutte le fonti di feedback elencate e i dettagli sullo stato dei thread sono documentati correttamente.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

The github-code skill's api-surface.md only documents 2 of ~8 endpoints needed for complete PR feedback retrieval. This causes the agent to miss inline review comments, review thread state, and conversation comments when inspecting PRs.

Gaps

  • No reviewThreads GraphQL query — REST cannot expose isResolved, isOutdated, or resolvedBy. This is GraphQL-only and completely missing from the surface.
  • No warning that gh pr view --json reviews omits inline review comments — --json comments returns conversation comments only, --json reviews returns review summaries only. Inline code review comments require /pulls/{number}/comments or GraphQL reviewThreads/reviews.comments.
  • Missing /issues/{number}/comments — conversation comments live at the issues endpoint, not /pulls/{number}/comments (which is inline review comments only). REST equivalent is undocumented.
  • Missing review-scoped comments endpoint — GET /pulls/{number}/reviews/{review_id}/comments for walking from a review to its inline comments.
  • Missing direct lookup endpoints — single review comment, single review, single issue comment by ID.
  • Missing pagination guidance — no --paginate documentation; PRs with heavy review activity silently truncate.
  • Missing suggested changes note — suggested changes are embedded in review comment body as markdown suggestion fences, not a separate endpoint.
  • Missing reactions endpoints — /pulls/comments/{comment_id}/reactions and /issues/comments/{comment_id}/reactions.

Recommended Fix

Add a "Complete PR Feedback Retrieval" section with:

REST minimum (3 paginated calls):

gh api --paginate repos/{owner}/{repo}/issues/{number}/comments    # conversation comments
gh api --paginate repos/{owner}/{repo}/pulls/{number}/reviews      # review summaries
gh api --paginate repos/{owner}/{repo}/pulls/{number}/comments     # inline review comments

GraphQL for thread state (1 call):

pullRequest(number: N) {
  comments(first: 100) { ... }
  reviews(first: 100) { ... }
  reviewThreads(first: 100) {
    nodes { isResolved isOutdated path line comments(first: 100) { ... } }
  }
}

Add explicit warning about gh pr view --json field limitations.

Full analysis: https://sentry.slack.com/docs/T024ZCV9U/F0B44A567QE

Action taken on behalf of David Cramer.

Lingua principale
TypeScript
Stelle
362
Fork
38
Merge medio
6h 39m
PR unite (30g)
175

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di getsentry/junior

Tutte le issue di getsentry/junior

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.