docs: ground tutor-auth wording in observed Puter UX + e2e Turnstile note#249
Merged
Conversation
…urnstile limit Drove the bundled src/bridge/puter.js in a real Chromium (observe-only; no sign-in completed) to see what a signed-out puter.ai.chat() actually does: - WITHOUT a user gesture (the background verify path): no popup, the call just hangs — confirming #245's skip is correct (there was never a background popup to suppress, it would hang). - WITH a gesture (the tutor): a puter.com window opens showing "Welcome to Puter!" + a Cloudflare "verify you're human" (Turnstile) check. NOT an email/password form at that step (likely auto temp-user after, per the bundle's attempt_temp_user_creation flag — but the post-Turnstile step was not observed, since completing a CAPTCHA is out of scope). So "sign in to a free Puter account" overstated the friction. Reword every surface to the observed reality: translation needs no account/email/password (confirmed); the optional tutor may open a Puter "verify you're human" window (kept as "may" — the post-check step is unobserved). Updated README (FAQ, data-flow, privacy bullet, how-it-works step), PRIVACY_POLICY.md, docs/privacy.html, STORE_LISTING.md (tutor blurb, flow step, privacy block). TESTING.md: record that the real tutor auth UX cannot be completed by automated E2E (Turnstile), which is why the suite stubs puter.js and verifies only the bridge contract; and refine the troubleshooting note to the observed flow. No code change; lint + format clean.
heznpc
enabled auto-merge (squash)
June 25, 2026 16:37
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Drove the bundled
src/bridge/puter.jsin a real Chromium (observe-only — no sign-in completed) to settle what a signed-outputer.ai.chat()actually shows — the thing code analysis couldn't resolve.Observed
whoami401). Confirms #245's skip is right: there was never a background popup to suppress; it would hang.puter.comwindow opens: "Welcome to Puter!" + a Cloudflare "verify you're human" (Turnstile) check — not an email/password form at that step.The post-Turnstile step (likely auto temp-user, per the bundle's
attempt_temp_user_creationflag) was not observed — completing a CAPTCHA is out of scope.Changes
PRIVACY_POLICY.md,docs/privacy.html,STORE_LISTING.md(tutor blurb / flow step / privacy block).puter.jsand verifies only the bridge contract; plus a refined troubleshooting note.No code change. lint · format clean. (Guide UI intentionally deferred — copy precision first, per owner direction.)