Repository navigation
ralph-triage.js hardcodes api.github.com, causing 401 on GitHub Enterprise #1142
Description
Summary
Squad Heartbeat (Ralph) / heartbeat fails on GitHub Enterprise because the triage script sends API requests to api.github.com instead of the GHE API host.
Failure observed
Workflow logs show:
GitHub API 401: {
"message": "Bad credentials",
"documentation_url": "https://docs.github.com/rest",
"status": "401"
}
This happens even though GITHUB_TOKEN is present and checkout works.
Root cause
In .squad/templates/ralph-triage.js, API requests are hardcoded to:
hostname: 'api.github.com'
On GHE, the token is only valid for the enterprise API (https:///api/v3), so calls to github.com return 401.
Expected behavior
Ralph triage should use:
- GITHUB_API_URL when provided
- otherwise GITHUB_SERVER_URL + /api/v3
- fallback to https://api.github.com for github.com environments
Proposed fix
Update ralph-triage.js request construction to derive host/path from environment instead of hardcoding api.github.com.
Repro steps
- Run Squad Heartbeat (Ralph) in a GHE repo.
- Ensure .squad/templates/ralph-triage.js is present.
- Observe failure in Ralph - Smart triage with 401 Bad credentials.
Acceptance criteria
- Heartbeat succeeds on GHE with standard GITHUB_TOKEN.
- No regression on github.com-hosted repos.
- Triage results are generated and downstream steps run as expected.
Reacted by tmartens-Heijmans
Activity
omercangumus commentedon Jul 2, 2026
Thanks for the detailed repro and proposed fix — I'll take this one.
Plan:
githubRequestJson()in.squad-templates/ralph-triage.jscurrently hardcodeshostname: 'api.github.com'in thehttps.request()options. I'll add a smallresolveGithubApiBase()helper that picks the API base in the order you outlined —GITHUB_API_URLfirst, thenGITHUB_SERVER_URL+/api/v3, then falling back tohttps://api.github.com— and build the request from aURLobject instead of a hardcoded hostname/path pair. I'll add a unit test covering all three resolution branches, then runnode scripts/sync-templates.mjs --syncso the fix propagates to the three mirrored copies (templates/,packages/squad-cli/templates/,packages/squad-sdk/templates/) thattest/template-sync.test.tschecks for byte-for-byte parity.fix(templates): resolve GitHub API host from env in ralph-triage.js
fix(templates): resolve GitHub API host from env in ralph-triage.js (#…
chore(release): prepare v0.12.0
chore(release): prepare v0.12.0 (#1691)
chore: promote dev -> main (v0.12.0) (#1698)