Skip to content

Hybrid linking: plain words for the new results and the Link confirmation - #228

Merged
nambok merged 2 commits into
mainfrom
fix/hybrid-link-outcomes
Oct 26, 2026
Merged

nambok merged 2 commits into
mainfrom
fix/hybrid-link-outcomes

Conversation

@nambok

@nambok nambok commented Oct 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

Since CoderHelm/coderhelm-platform#309, linking CoderHelm's GitHub App to a hybrid install ends on a hosted confirmation page that names the install, and it can be refused for three new reasons. This PR gives the dashboard and the docs install guide plain words for those results, mentions the Link step wherever people are sent to GitHub, and points the docs site at the platform commit with the hybrid threat model.

Changes

  • dashboard/src/lib/hybrid.ts and docs/lib/install/core.ts: one sentence and the next step for no_write_access (the GitHub account can push to nothing in that installation), declined (they chose Cancel on the confirmation page) and install_off (CoderHelm doesn't see the install as verified and active).
  • dashboard/src/components/hybrid-section.tsx and docs/components/install/wizard.tsx: the Install on GitHub step says CoderHelm will show which install it is about to link, to check the address and press Link (the dashboard also says tokens reach only repositories the person can push to).
  • docs/platform.lock.json: 22548c6 to 4fb3dc7 (platform #309), so docs.coderhelm.com publishes the hybrid threat model in Security model and the corrected Hybrid page.
  • e2e: the dashboard's outcome table covers the three results; new tests at 1440 and 390 in dashboard/e2e/hybrid.spec.ts and docs/e2e/install.spec.ts check each title and next step, the Link wording, and that nothing scrolls sideways.

Verification

  • Dashboard: npm run lint, npm run typecheck, npm run build, playwright test e2e/hybrid.spec.ts (29 passed).
  • Docs: test:unit, build, typecheck, check:links, check:output with the new lock, and the full Playwright suite on a fresh server (82 passed). The built Security model page has the hybrid threat model section.

…tion

The hosted side now asks people to confirm a GitHub link on a page that
names the install, and refuses a link for three new reasons. The dashboard
and the docs install guide say each one in a sentence with what to do next:
no_write_access (the person can push to nothing in that installation),
declined (they chose Cancel) and install_off (the install isn't verified and
active). Both places that send people to GitHub say CoderHelm will show the
install's address and ask them to press Link. e2e at 1440 and 390.

docs/platform.lock.json moves to the platform commit with the hybrid threat
model, so the docs site publishes it.
The hybrid GitHub test read page.url() after the click, when the browser
could already be on its way to github.com (origin null): it failed in CI
on timing alone.
@nambok
nambok force-pushed the fix/hybrid-link-outcomes branch from e528f28 to c30f829 Compare October 26, 2026 20:09
@nambok
nambok merged commit fd466bc into main Oct 26, 2026
5 checks passed
@nambok
nambok deleted the fix/hybrid-link-outcomes branch October 26, 2026 22:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant