Failure analysis · `github`

Every failed probe is bucketed by root cause: a coral bug, an upstream API error, an auth boundary, or a protocol-level fault. This makes it possible to act on the right subset — only 3 of the 285 github failures here are actually coral bugs.

coral bug

upstream api error

1468

auth required

protocol error

unknown

Top failure buckets

Category	Count	Affected (sample)	What to do
GitHub · 404 upstream.not_found	930		404 from GitHub. The owner/repo/resource doesn't exist or is private. Try a different public repo (anomalyco/opencode is a known public repo that works for many tables).
GitHub · rate-limited upstream.rate_limit	454		Wait for retry window (60–1300s) and re-probe. Consider switching to a token with higher rate-limit budget.
auth · needs App JWT auth.app_jwt_required	60		Connector expects GitHub App JWT, not a personal token. Document; skip on personal tokens.
GitHub · 422 upstream.unprocessable	48		422 from GitHub. Filter values don't match GitHub's validation (e.g. SHAs must be 40 chars, missing qualifiers in search).
GitHub · 410 sunset upstream.gone	30		410 from GitHub. Resource sunset (e.g. GitHub Classroom). Document as historical.
unknown · other unknown.other	29		—
unknown · no message unknown.no_error_msg	26	`blocked_byblockingdeployment_protection_ruleserrors`+22 more	Probe returned 0 rows but isError=true. Re-run with verbose logging.
protocol · decode failed protocol.decode_failed	6		Coral/protocol error. Retry once; if persistent, file a Coral bug.
coral · column missing coral_bug.column_missing	6		Open a Coral bug: catalog guide mentions a column that doesn't exist in the response schema.
GitHub · 400 upstream.bad_request	6		400 from GitHub. Endpoint or parameter deprecated.

Top failure buckets

Per-table diagnosis