Skip to content

fix(relay): keep provider outages distinct from access denials [H8,H16] - #12

Draft
McHersheys wants to merge 3 commits into
pullboard-dev:mainfrom
McHersheys:fix/relay-provider-unavailable
Draft

McHersheys wants to merge 3 commits into
pullboard-dev:mainfrom
McHersheys:fix/relay-provider-unavailable

Conversation

@McHersheys

@McHersheys McHersheys commented Oct 25, 2026 •

Copy link
Copy Markdown

What changed?

Keep transient GitHub-provider failures distinct from access denials: recognize primary/secondary rate-limit responses and return HTTP 503 without invalidating a still-valid read cache. Permission denials remain denials; no authorization or relay-ACK bypass.

The revision removes the repeated endpoint/status matrix and reuses the existing test files and fixtures. The complete diff is 93 additions, 1 deletion; runtime changes remain seven lines. Related: #11.

Which approved spec rows does this serve?

H8 and H16. The opt-in outbox regression also cites draft H21, not H17 (pairing). This does not implement exclusive offline authority.

How was it proven?

Node v24.21.0, real loopback HTTP, Git and SQLite, isolated temporary state:

  • Three new regressions fail against the unchanged original runtime and pass with the fix.
  • npm test -- --test-concurrency=2 test/relay-github.test.js test/relay.test.js test/relay-outbox.test.js: 64 passed; zero failed, skipped or cancelled.
  • node bin/pullboard.js spec check: passes with complete Git history, both at the upstream base and this candidate.
  • Wall-clock source check and whitespace checks pass. Existing test-name/input-declaration counts remain 15/18; no added omissions.

The three regressions cover distinct classifier/fallback, HTTP/cache, and outbox/replay boundaries; they are a practical nonredundant selection, not a claim of mathematical minimum. Existing denial, conflict and multiple-machine controls remain intact.

Draft / not accepted: the complete gate and browser suite have not passed in this environment; browser prerequisites are absent. An initial archive-only spec check falsely reported duplicate IDs because its Git history was missing; supplying full history corrected that setup error without changing source. No upstream duplicate-ID bug is claimed. No merge, release or deployment is requested by this draft update.

McHersheys and others added 3 commits October 25, 2026 10:15
… [skip ci]

Draft contribution: focused regressions and offline contract note. Product tests and gate are unrun; no runtime adoption or permission/ACK bypass.
Signed-off-by: McHerpes <mchermes@edu.dreamcatcher.ai>
@coreyolson coreyolson added the bug Pullboard doesn't work as documented; open while we look into it label Oct 26, 2026
@coreyolson coreyolson added the pending Waiting on the next release; we'll come back to it once it ships label Nov 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Pullboard doesn't work as documented; open while we look into it pending Waiting on the next release; we'll come back to it once it ships

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants