-
Notifications
You must be signed in to change notification settings - Fork 0
Open
Description
Problem
The current onboarding flow requires multiple manual steps that aren't documented in sequence:
auths init— create identity, configure git signing- Manually create/update
.auths/allowed_signersin the repo - Manually fetch registry from
~/.authsinto the project repo - Manually push
refs/auths/registryto the remote - Manually add
.github/workflows/verify-commits.yml - Manually fix SSH config if
UseKeychainbreaks
A first-time user hitting any of these steps without guidance will get stuck.
Expected behavior
auths init (when run in a git repo) should handle the full happy path:
- Create identity + configure signing (already works)
- Write
.auths/allowed_signerswith the new key (auths init: auto-populate .auths/allowed_signers in the repo #77) - Copy registry into the repo and push to remote (auths init: registry should be pushed to remote automatically #80)
- Fix SSH config issues (SSH config: add IgnoreUnknown UseKeychain during onboarding #74)
- Optionally scaffold the CI workflow (or print the command to do so)
Each step should have clear output showing what was done. If any step fails, auths doctor (#79) should catch it.
Non-goals
- Don't force GitHub Pages setup (that's for the widget, not core signing)
- Don't require network access for the identity creation itself
Context
End-to-end dogfooding session: took ~2 hours to get from auths init to a working verification badge, mostly due to undocumented manual steps between the init and the verification actually working.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels