action posthog_review_hog_reviews_list {
  label: "List recent reviews"
  description: "Recent ReviewHog reviews on this project: actively running reviews first (with the in-flight turn's stage), then the most recent completed ones — at most `limit` rows (default 5), plus `has_more` for whether a larger `limit` would reveal more. By default only the requesting user's reviews; `scope=everyone` lists every review on the project."
  provider: posthog
  method: GET
  path: "/api/projects/{project_id}/review_hog/reviews/"
  encoding: json
  input: {
    type: "object"
    properties: {
      limit: {
        type: "integer"
      }
      scope: {
        type: "string"
        enum: ["mine", "everyone"]
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["has_more", "results"]
    properties: {
      has_more: {
        type: "boolean"
        description: "Whether reviews exist beyond this page — drives the list's \"Show more\" button."
      }
      results: {
        type: "array"
        description: "The scoped reviews: in-progress runs first, then completed newest first."
        items: {
          type: "object"
          required: ["additions", "blind_spot_issue_count", "candidate_count", "changed_files", "chunk_count", "consider_count", "deletions", "dismissed_count", "files_reviewed", "github_url", "head_branch", "id", "in_progress", "last_run_at", "must_fix_count", "perspective_count", "perspective_issue_count", "pr_author", "pr_number", "pr_title", "progress", "published", "repository", "run_count", "should_fix_count"]
          properties: {
            additions: {
              type: ["integer", "null"]
              description: "Lines added by the PR; null if unknown."
            }
            blind_spot_issue_count: {
              type: ["integer", "null"]
              description: "Raw issues the blind-spot sweep added in the latest turn, before dedupe; null if unknown."
            }
            candidate_count: {
              type: "integer"
              description: "All findings the latest turn raised after dedupe, before validation."
            }
            changed_files: {
              type: ["integer", "null"]
              description: "Files the PR changes; null if unknown."
            }
            chunk_count: {
              type: ["integer", "null"]
              description: "Reviewable chunks the latest turn split the PR into; null if unknown."
            }
            consider_count: {
              type: "integer"
              description: "The latest turn's valid findings at consider effective priority."
            }
            deletions: {
              type: ["integer", "null"]
              description: "Lines deleted by the PR; null if unknown."
            }
            dismissed_count: {
              type: "integer"
              description: "The latest turn's findings the validator dismissed as not worth publishing."
            }
            files_reviewed: {
              type: ["integer", "null"]
              description: "Meaningful files the latest turn actually read, after skipping generated/lock/snapshot files; null if unknown."
            }
            github_url: {
              type: "string"
              description: "Where to see the review on GitHub: the pull request when its URL is known, otherwise the head branch."
            }
            head_branch: {
              type: "string"
              description: "The pull request's head branch."
            }
            id: {
              type: "string"
              format: "uuid"
              description: "The review report's id, for fetching the review's detail."
            }
            in_progress: {
              type: "boolean"
              description: "Whether a review turn is running on this report right now (activity within the last 30 minutes)."
            }
            last_run_at: {
              type: ["string", "null"]
              format: "date-time"
              description: "When the latest review turn completed; null while the first is in flight."
            }
            must_fix_count: {
              type: "integer"
              description: "The latest turn's valid findings at must_fix effective priority."
            }
            perspective_count: {
              type: ["integer", "null"]
              description: "Review perspectives that read each chunk in the latest turn; null if unknown."
            }
            perspective_issue_count: {
              type: ["integer", "null"]
              description: "Raw issues the perspectives raised in the latest turn, before dedupe; null if unknown."
            }
            pr_author: {
              type: ["string", "null"]
              description: "The pull request author's GitHub login; null if unknown."
            }
            pr_number: {
              type: ["integer", "null"]
              description: "The reviewed pull request's number; null for a branch target with no PR yet."
            }
            pr_title: {
              type: ["string", "null"]
              description: "The pull request's title, from the latest reviewed snapshot; null if unknown."
            }
            progress: {
              description: "The in-flight turn's stage and counters; null unless `in_progress`."
              type: "object"
            }
            published: {
              type: "boolean"
              description: "Whether a review has been published back to GitHub."
            }
            repository: {
              type: "string"
              description: "The reviewed repository, as `owner/repo`."
            }
            run_count: {
              type: "integer"
              description: "How many review turns have completed on this report."
            }
            should_fix_count: {
              type: "integer"
              description: "The latest turn's valid findings at should_fix effective priority."
            }
          }
        }
      }
    }
  }
}