PR Flight Director · v1.1.1 · read-only

Why is this pull request blocked?

Maniflight reads every place GitHub hides a merge blocker, separates what it observed from what it could not see, and tells each person what to do next. It never writes to GitHub.

npm install -g maniflight Build a command

Departures · acme/payments-apiObserved 16:00 UTC · base main

Select a departure to open its flight log. Samples are fictional pull requests classified by Maniflight 1.1.1.

Flight log · sample

acme/payments-api#231

Document the refund webhook payload

A first-time contributor's fork: CI is parked until a maintainer approves it, and a review is still required.

Status: BLOCKED
Next actors: reviewer, maintainer, automation
Head: e19a7c3f40b2
Steps: 3

$ maniflight pr acme/payments-api#231

Maniflight PR Flight Director
acme/payments-api#231
Document the refund webhook payload

STATUS       BLOCKED
NEXT ACTORS  reviewer, maintainer, automation
HEAD         e19a7c3f40b2

BLOCKED      1 approving review is required [merge blocker]
SOURCE       https://github.com/acme/payments-api/pull/231
ACTION       CI requires manual action
DETAIL       GitHub reports manual action required for this fork workflow, and the run has no jobs. A maintainer with write access is the likely next actor.
SOURCE       https://github.com/acme/payments-api/actions/runs/9177
WAITING      build is required but has not reported a result [merge blocker]
SOURCE       https://github.com/acme/payments-api/pull/231

Next steps
REVIEWER     Review and approve the pull request if it meets the project requirements.
             https://github.com/acme/payments-api/pull/231
MAINTAINER   Approve the pending fork workflow run so CI can start.
             https://github.com/acme/payments-api/actions/runs/9177
AUTOMATION   Wait for pending automation to report a result, then inspect again.
             https://github.com/acme/payments-api/pull/231

{
  "kind": "pull-request-flight",
  "schemaVersion": "1.0",
  "tool": {
    "name": "Maniflight",
    "version": "1.1.1"
  },
  "observedAt": "2026-09-30T16:00:00.000Z",
  "pullRequest": {
    "repository": "acme/payments-api",
    "number": 231,
    "url": "https://github.com/acme/payments-api/pull/231",
    "title": "Document the refund webhook payload",
    "state": "open",
    "merged": false,
    "draft": false,
    "author": "new-contributor",
    "base": {
      "ref": "main",
      "sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "repository": "acme/payments-api"
    },
    "head": {
      "ref": "docs-refunds",
      "sha": "e19a7c3f40b2d6e8a5c1f9b7d3e0a2c4b6d8f1e3",
      "repository": "new-contributor/payments-api"
    },
    "mergeable": true,
    "mergeState": "blocked",
    "reviewDecision": "review_required"
  },
  "outcome": {
    "status": "blocked",
    "nextActors": [
      "reviewer",
      "maintainer",
      "automation"
    ],
    "summary": "One or more observed conditions currently block the pull request."
  },
  "counts": {
    "blocked": 1,
    "actionRequired": 1,
    "waiting": 1,
    "unknown": 0
  },
  "signals": [
    {
      "id": "review/decision",
      "status": "blocked",
      "actor": "reviewer",
      "confidence": "observed",
      "blocking": true,
      "summary": "1 approving review is required",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/231"
        }
      ]
    },
    {
      "id": "workflow/9177",
      "status": "action_required",
      "actor": "maintainer",
      "confidence": "inferred",
      "blocking": false,
      "summary": "CI requires manual action",
      "detail": "GitHub reports manual action required for this fork workflow, and the run has no jobs. A maintainer with write access is the likely next actor.",
      "evidence": [
        {
          "label": "Workflow run",
          "url": "https://github.com/acme/payments-api/actions/runs/9177"
        }
      ]
    },
    {
      "id": "required-status/build/any",
      "status": "waiting",
      "actor": "automation",
      "confidence": "inferred",
      "blocking": true,
      "summary": "build is required but has not reported a result",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/231"
        }
      ]
    },
    {
      "id": "pr/draft",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is ready for review",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/231"
        }
      ]
    },
    {
      "id": "pr/mergeability",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is mergeable",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/231"
        }
      ]
    },
    {
      "id": "pr/state",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is open",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/231"
        }
      ]
    },
    {
      "id": "review/threads",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "No unresolved review threads were observed",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/231"
        }
      ]
    }
  ],
  "nextActions": [
    {
      "actor": "reviewer",
      "summary": "Review and approve the pull request if it meets the project requirements.",
      "url": "https://github.com/acme/payments-api/pull/231"
    },
    {
      "actor": "maintainer",
      "summary": "Approve the pending fork workflow run so CI can start.",
      "url": "https://github.com/acme/payments-api/actions/runs/9177"
    },
    {
      "actor": "automation",
      "summary": "Wait for pending automation to report a result, then inspect again.",
      "url": "https://github.com/acme/payments-api/pull/231"
    }
  ],
  "collection": {
    "sources": [
      {
        "id": "branch_rules",
        "status": "available"
      },
      {
        "id": "check_runs",
        "status": "available"
      },
      {
        "id": "commit_statuses",
        "status": "available"
      },
      {
        "id": "graphql",
        "status": "available"
      },
      {
        "id": "pull_request",
        "status": "available"
      },
      {
        "id": "reviews",
        "status": "available"
      },
      {
        "id": "workflow_runs",
        "status": "available"
      }
    ],
    "warnings": []
  }
}

Flight log · sample

acme/payments-api#218

Retry idempotent webhook deliveries

Approved, but the required build failed and a review conversation is still open.

Status: BLOCKED
Next actors: contributor
Head: 7c41e09b2d5f
Steps: 2

$ maniflight pr acme/payments-api#218

Maniflight PR Flight Director
acme/payments-api#218
Retry idempotent webhook deliveries

STATUS       BLOCKED
NEXT ACTORS  contributor
HEAD         7c41e09b2d5f

BLOCKED      build failure [merge blocker]
DETAIL       This check matches an active required status context.
SOURCE       https://github.com/acme/payments-api/actions/runs/9101
BLOCKED      1 review thread is unresolved [merge blocker]
SOURCE       https://github.com/acme/payments-api/pull/218

Next steps
UNASSIGNED   Inspect the failing result, fix the cause, and push a new commit.
             https://github.com/acme/payments-api/actions/runs/9101
CONTRIBUTOR  Resolve the required review conversations.
             https://github.com/acme/payments-api/pull/218

{
  "kind": "pull-request-flight",
  "schemaVersion": "1.0",
  "tool": {
    "name": "Maniflight",
    "version": "1.1.1"
  },
  "observedAt": "2026-09-30T16:00:00.000Z",
  "pullRequest": {
    "repository": "acme/payments-api",
    "number": 218,
    "url": "https://github.com/acme/payments-api/pull/218",
    "title": "Retry idempotent webhook deliveries",
    "state": "open",
    "merged": false,
    "draft": false,
    "author": "dana-k",
    "base": {
      "ref": "main",
      "sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "repository": "acme/payments-api"
    },
    "head": {
      "ref": "webhook-retries",
      "sha": "7c41e09b2d5f8a3e6c1b9d04f2a7e8c3b5d1f6a2",
      "repository": "acme/payments-api"
    },
    "mergeable": true,
    "mergeState": "blocked",
    "reviewDecision": "approved"
  },
  "outcome": {
    "status": "blocked",
    "nextActors": [
      "contributor"
    ],
    "summary": "One or more observed conditions currently block the pull request."
  },
  "counts": {
    "blocked": 2,
    "actionRequired": 0,
    "waiting": 0,
    "unknown": 0
  },
  "signals": [
    {
      "id": "check/9101",
      "status": "blocked",
      "actor": "unknown",
      "confidence": "unknown",
      "blocking": true,
      "summary": "build failure",
      "detail": "This check matches an active required status context.",
      "evidence": [
        {
          "label": "Check run",
          "url": "https://github.com/acme/payments-api/actions/runs/9101"
        }
      ]
    },
    {
      "id": "review/threads",
      "status": "blocked",
      "actor": "contributor",
      "confidence": "observed",
      "blocking": true,
      "summary": "1 review thread is unresolved",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/218"
        }
      ]
    },
    {
      "id": "pr/draft",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is ready for review",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/218"
        }
      ]
    },
    {
      "id": "pr/mergeability",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is mergeable",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/218"
        }
      ]
    },
    {
      "id": "pr/state",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is open",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/218"
        }
      ]
    },
    {
      "id": "review/decision",
      "status": "pass",
      "actor": "reviewer",
      "confidence": "observed",
      "blocking": false,
      "summary": "GitHub reports the review requirement is approved",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/218"
        }
      ]
    }
  ],
  "nextActions": [
    {
      "actor": "unknown",
      "summary": "Inspect the failing result, fix the cause, and push a new commit.",
      "url": "https://github.com/acme/payments-api/actions/runs/9101"
    },
    {
      "actor": "contributor",
      "summary": "Resolve the required review conversations.",
      "url": "https://github.com/acme/payments-api/pull/218"
    }
  ],
  "collection": {
    "sources": [
      {
        "id": "branch_rules",
        "status": "available"
      },
      {
        "id": "check_runs",
        "status": "available"
      },
      {
        "id": "commit_statuses",
        "status": "available"
      },
      {
        "id": "graphql",
        "status": "available"
      },
      {
        "id": "pull_request",
        "status": "available"
      },
      {
        "id": "reviews",
        "status": "available"
      },
      {
        "id": "workflow_runs",
        "status": "available"
      }
    ],
    "warnings": []
  }
}

Flight log · sample

acme/payments-api#204

Add per-merchant rate limits

Approved, with nothing blocking the merge, but CI has never run on this fork. A maintainer has to approve the workflow.

Status: ACTION
Next actors: maintainer
Head: 4b8e2a6c1d9f
Steps: 1

$ maniflight pr acme/payments-api#204

Maniflight PR Flight Director
acme/payments-api#204
Add per-merchant rate limits

STATUS       ACTION REQUIRED
NEXT ACTORS  maintainer
HEAD         4b8e2a6c1d9f

ACTION       CI requires manual action
DETAIL       GitHub reports manual action required for this fork workflow, and the run has no jobs. A maintainer with write access is the likely next actor.
SOURCE       https://github.com/acme/payments-api/actions/runs/9140

Next steps
MAINTAINER   Approve the pending fork workflow run so CI can start.
             https://github.com/acme/payments-api/actions/runs/9140

{
  "kind": "pull-request-flight",
  "schemaVersion": "1.0",
  "tool": {
    "name": "Maniflight",
    "version": "1.1.1"
  },
  "observedAt": "2026-09-30T16:00:00.000Z",
  "pullRequest": {
    "repository": "acme/payments-api",
    "number": 204,
    "url": "https://github.com/acme/payments-api/pull/204",
    "title": "Add per-merchant rate limits",
    "state": "open",
    "merged": false,
    "draft": false,
    "author": "sam-ortiz",
    "base": {
      "ref": "main",
      "sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "repository": "acme/payments-api"
    },
    "head": {
      "ref": "rate-limits",
      "sha": "4b8e2a6c1d9f3e7a5c0b8d2f6e4a1c9b7d3f5e08",
      "repository": "sam-ortiz/payments-api"
    },
    "mergeable": true,
    "mergeState": "clean",
    "reviewDecision": "approved"
  },
  "outcome": {
    "status": "action_required",
    "nextActors": [
      "maintainer"
    ],
    "summary": "A person needs to act before automated progress can continue."
  },
  "counts": {
    "blocked": 0,
    "actionRequired": 1,
    "waiting": 0,
    "unknown": 0
  },
  "signals": [
    {
      "id": "workflow/9140",
      "status": "action_required",
      "actor": "maintainer",
      "confidence": "inferred",
      "blocking": false,
      "summary": "CI requires manual action",
      "detail": "GitHub reports manual action required for this fork workflow, and the run has no jobs. A maintainer with write access is the likely next actor.",
      "evidence": [
        {
          "label": "Workflow run",
          "url": "https://github.com/acme/payments-api/actions/runs/9140"
        }
      ]
    },
    {
      "id": "pr/draft",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is ready for review",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/204"
        }
      ]
    },
    {
      "id": "pr/mergeability",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is mergeable",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/204"
        }
      ]
    },
    {
      "id": "pr/state",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is open",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/204"
        }
      ]
    },
    {
      "id": "review/decision",
      "status": "pass",
      "actor": "reviewer",
      "confidence": "observed",
      "blocking": false,
      "summary": "GitHub reports the review requirement is approved",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/204"
        }
      ]
    },
    {
      "id": "review/threads",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "No unresolved review threads were observed",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/204"
        }
      ]
    }
  ],
  "nextActions": [
    {
      "actor": "maintainer",
      "summary": "Approve the pending fork workflow run so CI can start.",
      "url": "https://github.com/acme/payments-api/actions/runs/9140"
    }
  ],
  "collection": {
    "sources": [
      {
        "id": "branch_rules",
        "status": "available"
      },
      {
        "id": "check_runs",
        "status": "available"
      },
      {
        "id": "commit_statuses",
        "status": "available"
      },
      {
        "id": "graphql",
        "status": "available"
      },
      {
        "id": "pull_request",
        "status": "available"
      },
      {
        "id": "reviews",
        "status": "available"
      },
      {
        "id": "workflow_runs",
        "status": "available"
      }
    ],
    "warnings": []
  }
}

Flight log · sample

acme/payments-api#212

Stream ledger exports in pages

Approved and conversation-free. The required build is still running, so the next move belongs to CI.

Status: WAITING
Next actors: automation
Head: 7c41e09b2d5f
Steps: 1

$ maniflight pr acme/payments-api#212

Maniflight PR Flight Director
acme/payments-api#212
Stream ledger exports in pages

STATUS       WAITING
NEXT ACTORS  automation
HEAD         7c41e09b2d5f

WAITING      build is in progress [merge blocker]
DETAIL       This check matches an active required status context.
SOURCE       https://github.com/acme/payments-api/actions/runs/9188

Next steps
AUTOMATION   Wait for pending automation to report a result, then inspect again.
             https://github.com/acme/payments-api/actions/runs/9188

{
  "kind": "pull-request-flight",
  "schemaVersion": "1.0",
  "tool": {
    "name": "Maniflight",
    "version": "1.1.1"
  },
  "observedAt": "2026-09-30T16:00:00.000Z",
  "pullRequest": {
    "repository": "acme/payments-api",
    "number": 212,
    "url": "https://github.com/acme/payments-api/pull/212",
    "title": "Stream ledger exports in pages",
    "state": "open",
    "merged": false,
    "draft": false,
    "author": "dana-k",
    "base": {
      "ref": "main",
      "sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "repository": "acme/payments-api"
    },
    "head": {
      "ref": "ledger-export",
      "sha": "7c41e09b2d5f8a3e6c1b9d04f2a7e8c3b5d1f6a2",
      "repository": "acme/payments-api"
    },
    "mergeable": true,
    "mergeState": "blocked",
    "reviewDecision": "approved"
  },
  "outcome": {
    "status": "waiting",
    "nextActors": [
      "automation"
    ],
    "summary": "Automation or another pending condition is still running."
  },
  "counts": {
    "blocked": 0,
    "actionRequired": 0,
    "waiting": 1,
    "unknown": 0
  },
  "signals": [
    {
      "id": "check/9188",
      "status": "waiting",
      "actor": "automation",
      "confidence": "observed",
      "blocking": true,
      "summary": "build is in progress",
      "detail": "This check matches an active required status context.",
      "evidence": [
        {
          "label": "Check run",
          "url": "https://github.com/acme/payments-api/actions/runs/9188"
        }
      ]
    },
    {
      "id": "pr/draft",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is ready for review",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/212"
        }
      ]
    },
    {
      "id": "pr/mergeability",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is mergeable",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/212"
        }
      ]
    },
    {
      "id": "pr/state",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is open",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/212"
        }
      ]
    },
    {
      "id": "review/decision",
      "status": "pass",
      "actor": "reviewer",
      "confidence": "observed",
      "blocking": false,
      "summary": "GitHub reports the review requirement is approved",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/212"
        }
      ]
    },
    {
      "id": "review/threads",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "No unresolved review threads were observed",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/212"
        }
      ]
    }
  ],
  "nextActions": [
    {
      "actor": "automation",
      "summary": "Wait for pending automation to report a result, then inspect again.",
      "url": "https://github.com/acme/payments-api/actions/runs/9188"
    }
  ],
  "collection": {
    "sources": [
      {
        "id": "branch_rules",
        "status": "available"
      },
      {
        "id": "check_runs",
        "status": "available"
      },
      {
        "id": "commit_statuses",
        "status": "available"
      },
      {
        "id": "graphql",
        "status": "available"
      },
      {
        "id": "pull_request",
        "status": "available"
      },
      {
        "id": "reviews",
        "status": "available"
      },
      {
        "id": "workflow_runs",
        "status": "available"
      }
    ],
    "warnings": []
  }
}

Flight log · sample

acme/payments-api#197

Tighten refund amount validation

Run without a token: GitHub hides review data and still reports the PR as blocked. Maniflight says what it cannot see instead of guessing.

Status: UNKNOWN
Next actors: unknown
Head: 7c41e09b2d5f
Steps: 0

$ maniflight pr acme/payments-api#197

Maniflight PR Flight Director
acme/payments-api#197
Tighten refund amount validation

STATUS       UNKNOWN
NEXT ACTORS  unknown
HEAD         7c41e09b2d5f

Evidence gaps
UNKNOWN      graphql evidence is unavailable
DETAIL       GitHub GraphQL requires authentication.
UNKNOWN      GitHub reports the pull request is blocked for an unexplained reason [merge blocker]
SOURCE       https://github.com/acme/payments-api/pull/197
UNKNOWN      Review requirements could not be determined conclusively
SOURCE       https://github.com/acme/payments-api/pull/197

{
  "kind": "pull-request-flight",
  "schemaVersion": "1.0",
  "tool": {
    "name": "Maniflight",
    "version": "1.1.1"
  },
  "observedAt": "2026-09-30T16:00:00.000Z",
  "pullRequest": {
    "repository": "acme/payments-api",
    "number": 197,
    "url": "https://github.com/acme/payments-api/pull/197",
    "title": "Tighten refund amount validation",
    "state": "open",
    "merged": false,
    "draft": false,
    "author": "dana-k",
    "base": {
      "ref": "main",
      "sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "repository": "acme/payments-api"
    },
    "head": {
      "ref": "anon-inspect",
      "sha": "7c41e09b2d5f8a3e6c1b9d04f2a7e8c3b5d1f6a2",
      "repository": "acme/payments-api"
    },
    "mergeable": true,
    "mergeState": "blocked",
    "reviewDecision": null
  },
  "outcome": {
    "status": "unknown",
    "nextActors": [
      "unknown"
    ],
    "summary": "The available evidence is not complete enough to declare this pull request ready."
  },
  "counts": {
    "blocked": 0,
    "actionRequired": 0,
    "waiting": 0,
    "unknown": 3
  },
  "signals": [
    {
      "id": "collection/graphql",
      "status": "unknown",
      "actor": "unknown",
      "confidence": "unknown",
      "blocking": false,
      "summary": "graphql evidence is unavailable",
      "detail": "GitHub GraphQL requires authentication.",
      "evidence": []
    },
    {
      "id": "pr/unexplained-blocker",
      "status": "unknown",
      "actor": "unknown",
      "confidence": "unknown",
      "blocking": true,
      "summary": "GitHub reports the pull request is blocked for an unexplained reason",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/197"
        }
      ]
    },
    {
      "id": "review/decision",
      "status": "unknown",
      "actor": "unknown",
      "confidence": "unknown",
      "blocking": false,
      "summary": "Review requirements could not be determined conclusively",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/197"
        }
      ]
    },
    {
      "id": "check/9122",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "build success",
      "evidence": [
        {
          "label": "Check run",
          "url": "https://github.com/acme/payments-api/actions/runs/9122"
        }
      ]
    },
    {
      "id": "pr/draft",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is ready for review",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/197"
        }
      ]
    },
    {
      "id": "pr/mergeability",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is mergeable",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/197"
        }
      ]
    },
    {
      "id": "pr/state",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is open",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/197"
        }
      ]
    }
  ],
  "nextActions": [],
  "collection": {
    "sources": [
      {
        "id": "branch_rules",
        "status": "available"
      },
      {
        "id": "check_runs",
        "status": "available"
      },
      {
        "id": "commit_statuses",
        "status": "available"
      },
      {
        "id": "graphql",
        "status": "unavailable",
        "detail": "GitHub GraphQL requires authentication."
      },
      {
        "id": "pull_request",
        "status": "available"
      },
      {
        "id": "reviews",
        "status": "available"
      },
      {
        "id": "workflow_runs",
        "status": "available"
      }
    ],
    "warnings": []
  }
}

Flight log · sample

acme/payments-api#189

Export payouts as CSV

Everything required has reported success. Nothing left to chase.

Status: READY
Next actors: none
Head: 7c41e09b2d5f
Steps: 0

$ maniflight pr acme/payments-api#189

Maniflight PR Flight Director
acme/payments-api#189
Export payouts as CSV

STATUS       READY
NEXT ACTORS  none
HEAD         7c41e09b2d5f

PASS         No observed blocker remains in the collected evidence.
SOURCE       https://github.com/acme/payments-api/pull/189

{
  "kind": "pull-request-flight",
  "schemaVersion": "1.0",
  "tool": {
    "name": "Maniflight",
    "version": "1.1.1"
  },
  "observedAt": "2026-09-30T16:00:00.000Z",
  "pullRequest": {
    "repository": "acme/payments-api",
    "number": 189,
    "url": "https://github.com/acme/payments-api/pull/189",
    "title": "Export payouts as CSV",
    "state": "open",
    "merged": false,
    "draft": false,
    "author": "dana-k",
    "base": {
      "ref": "main",
      "sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "repository": "acme/payments-api"
    },
    "head": {
      "ref": "payout-csv",
      "sha": "7c41e09b2d5f8a3e6c1b9d04f2a7e8c3b5d1f6a2",
      "repository": "acme/payments-api"
    },
    "mergeable": true,
    "mergeState": "clean",
    "reviewDecision": "approved"
  },
  "outcome": {
    "status": "ready",
    "nextActors": [],
    "summary": "No observed blocker remains in the collected evidence."
  },
  "counts": {
    "blocked": 0,
    "actionRequired": 0,
    "waiting": 0,
    "unknown": 0
  },
  "signals": [
    {
      "id": "check/9099",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "build success",
      "evidence": [
        {
          "label": "Check run",
          "url": "https://github.com/acme/payments-api/actions/runs/9099"
        }
      ]
    },
    {
      "id": "pr/draft",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is ready for review",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/189"
        }
      ]
    },
    {
      "id": "pr/mergeability",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is mergeable",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/189"
        }
      ]
    },
    {
      "id": "pr/state",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "Pull request is open",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/189"
        }
      ]
    },
    {
      "id": "review/decision",
      "status": "pass",
      "actor": "reviewer",
      "confidence": "observed",
      "blocking": false,
      "summary": "GitHub reports the review requirement is approved",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/189"
        }
      ]
    },
    {
      "id": "review/threads",
      "status": "pass",
      "actor": "automation",
      "confidence": "observed",
      "blocking": false,
      "summary": "No unresolved review threads were observed",
      "evidence": [
        {
          "label": "Pull request",
          "url": "https://github.com/acme/payments-api/pull/189"
        }
      ]
    }
  ],
  "nextActions": [],
  "collection": {
    "sources": [
      {
        "id": "branch_rules",
        "status": "available"
      },
      {
        "id": "check_runs",
        "status": "available"
      },
      {
        "id": "commit_statuses",
        "status": "available"
      },
      {
        "id": "graphql",
        "status": "available"
      },
      {
        "id": "pull_request",
        "status": "available"
      },
      {
        "id": "reviews",
        "status": "available"
      },
      {
        "id": "workflow_runs",
        "status": "available"
      }
    ],
    "warnings": []
  }
}

Pre-flight check

Paste a pull request, get the command

Paste a GitHub pull request link or an owner/repository#number reference. It is checked with the same rules the CLI uses, right here in your browser.

Pull request

JSON output Use my GitHub CLI token No color

Try:

# Paste a pull request on the left

Nothing is sent anywhere. The command runs on your machine with your own token, and Maniflight only reads from GitHub.

How it works

Seven sources, one flight plan

No single GitHub response explains a stuck pull request. Maniflight collects each source with read-only requests, records its coverage, and classifies every condition with deterministic rules.

Evidence identifies a current merge blocker.
A person must act before progress can continue.
Automation or another pending condition is not complete.
The available evidence cannot support a stronger conclusion.
The observed condition completed successfully.
Relevant, but not known to block the merge.

Install

Ready for boarding

Node.js 22.12+ or 24 on Windows, macOS, or Linux. Published to npm and attached to every GitHub release with checksums.

npm install --global maniflight
maniflight --version

npx maniflight pr owner/repository#123

npm install --global https://github.com/agrovr/maniflight/releases/download/v1.1.1/maniflight-1.1.1.tgz

git clone https://github.com/agrovr/maniflight.git
cd maniflight
npm ci
npm run build
node dist/cli.js --help

Also on board

Repository scan & Action

Grade a repository's architecture, automation, security hygiene, and community health without running its code. Gate CI on score, severity, or regressions.

name: Repository diagnostics

on:
  pull_request:

permissions:
  contents: read

jobs:
  maniflight:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
      - uses: agrovr/maniflight@v1
        with:
          github-token: ${{ github.token }}
          fail-on-high: true

See the self-scan

Trust

Read-only by design

Read-onlyGET requests and GraphQL queries only. No comments, approvals, reruns, labels, merges, or dispatches.
No executionNo checkout, code execution, or log and artifact downloads from the inspected repository.
Evidence-linkedEvery report records the observation time and exact head SHA, and conclusions link to their source.
Honest gapsMissing evidence is reported as unknown, never as a guessed pass.
Token-safeTokens are read from the environment only and are never written to a report.

FAQ

Before you take off

Does it need a GitHub token?

No, public pull requests work without one. GitHub's GraphQL API requires authentication, though, so without a token the review decision and review threads are reported under Evidence gaps. Set GH_TOKEN or GITHUB_TOKEN with read access for the complete picture.

Can it change anything on GitHub?

No. Maniflight sends GET requests and GraphQL queries only. It never comments, approves, reruns, labels, merges, or dispatches workflows, and it never checks out or runs code from the repository.

Why does it say UNKNOWN instead of a verdict?

Because the evidence it could see does not support one. Missing or inaccessible sources are reported as unknown on purpose, so a hidden blocker is never presented as a pass.

What exit code does a blocked pull request return?

Zero. A blocked PR is a successful diagnosis. The command exits with 1 only for invalid input or when the pull request itself cannot be fetched.

Does it support GitHub Enterprise Server?

Not in 1.x. Maniflight targets GitHub.com's REST and GraphQL APIs.

How do I know the npm package came from this repository?

Releases after 1.1.0 are published by the repository's own release workflow with npm trusted publishing, so each one carries a provenance attestation that links it to the exact commit and workflow run. Run npm audit signatures after installing to verify it. Every version is also attached to its GitHub release with a SHA256SUMS file.