fix #909: Add OAuth step messages for improved user guidance during authentication

Author: watermint

docs/_posts/2025-06-16-release-142.md docs/_posts/2025-06-17-release-142.mddocs/_posts/2025-06-16-release-142.md renamed to docs/_posts/2025-06-17-release-142.md

@@ -21,6 +21,9 @@ type MsgApiAuth struct {
 	ProgressAuthSuccess app_msg.Message
 	OauthSeq1           app_msg.Message
 	OauthSeq2           app_msg.Message
+	OauthStep1Visit     app_msg.Message
+	OauthStep2Allow     app_msg.Message
+	OauthStep3Copy      app_msg.Message
 }
 
 var (
@@ -133,7 +136,13 @@ func (z *sessionCodeAuthImpl) oauthAskCode(session api_auth.OAuthSessionData, st
 	})
 	url := z.oauthUrl(session, cfg, state, challenge)
 
-	ui.Info(MApiAuth.OauthSeq1.With("Url", url))
+	ui.Info(MApiAuth.OauthStep1Visit)
+	ui.Break()
+	ui.Code(url)
+	ui.Break()
+	ui.Info(MApiAuth.OauthStep2Allow)
+	ui.Break()
+	ui.Info(MApiAuth.OauthStep3Copy)
 
 	code := z.oauthCode()
 	if code == "" {

essentials/api/api_auth_oauth/code.go

@@ -2477,7 +2477,10 @@
   "essentials.api.api_auth_key.msg_console.ask_key": "Please enter your API key(s).",
   "essentials.api.api_auth_key.msg_console.prompt_enter_key": "Please enter your API key(s).",
   "essentials.api.api_auth_oauth.msg_api_auth.failed_or_cancelled": "Authentication failed or cancelled: {{.Cause}}",
-  "essentials.api.api_auth_oauth.msg_api_auth.oauth_seq1": "1. Visit the URL for the auth dialogue:\\n\\n{{.Url}}\\n\\n2. Click 'Allow' (you might have to login first):\\n3. Copy the authorization code:",
+  "essentials.api.api_auth_oauth.msg_api_auth.oauth_seq1": "1. Visit the URL for the auth dialogue:\n\n{{.Url}}\n\n2. Click 'Allow' (you might have to login first):\n3. Copy the authorization code:",
+  "essentials.api.api_auth_oauth.msg_api_auth.oauth_step1_visit": "1. Visit the URL for the auth dialogue:",
+  "essentials.api.api_auth_oauth.msg_api_auth.oauth_step2_allow": "2. Click 'Allow' (you might have to login first)",
+  "essentials.api.api_auth_oauth.msg_api_auth.oauth_step3_copy": "3. Copy the authorization code:",
   "essentials.api.api_auth_oauth.msg_api_auth.oauth_seq2": "Enter the authorization code",
   "essentials.api.api_auth_oauth.msg_api_auth.progress_auth_success": "Successfully authorized.",
   "essentials.api.api_auth_oauth.opt_in_feature_redirect.agreement": "This feature is in an early stage of development. This is not well tested. Please proceed by typing 'yes' to agree & enable this feature.",
@@ -2528,7 +2531,7 @@
   "essentials.model.mo_image.exif.desc": "EXIF data",
   "essentials.model.mo_image.exif.make.desc": "The name of the manufacturer",
   "essentials.model.mo_image.exif.model.desc": "The model name or model number",
-  "essentials.network.nw_diag.msg_network.error_unreachable": "Network unreachable: {{.Url}}.\\nPlease ensure your network connection or proxy configuration.\\nPlease specify `-proxy` option if your machine is under proxy or firewall.\\n\\nError:\\n{{.Error}}",
+  "essentials.network.nw_diag.msg_network.error_unreachable": "Network unreachable: {{.Url}}.\nPlease ensure your network connection or proxy configuration.\nPlease specify `-proxy` option if your machine is under proxy or firewall.\n\nError:\n{{.Error}}",
   "essentials.network.nw_diag.msg_network.progress_testing": "Testing network connection...",
   "essentials.network.nw_diag.msg_network.progress_testing_done": "Done",
   "essentials.network.nw_diag.msg_network.progress_testing_remind": "Trying...",
@@ -3432,7 +3435,7 @@
   "recipe.dev.doc.review.batch.invalid_choice": "Invalid input: {{.Input}}. Please enter 'a' to approve, 's' to skip, or 'q' to quit.",
   "recipe.dev.doc.review.batch.no_unreviewed": "No unreviewed messages found.",
   "recipe.dev.doc.review.batch.prompt_approve": "[a] Approve",
-  "recipe.dev.doc.review.batch.prompt_review": "[{{.Index}}/{{.Total}}] Key: {{.Key}}\\nMessage: {{.Message}}",
+  "recipe.dev.doc.review.batch.prompt_review": "[{{.Index}}/{{.Total}}] Key: {{.Key}}\nMessage: {{.Message}}",
   "recipe.dev.doc.review.batch.prompt_skip": "Skipping: {{.Key}}",
   "recipe.dev.doc.review.batch.prompt_stop": "[q] Quit",
   "recipe.dev.doc.review.batch.session_complete": "Review session complete. Approved: {{.Approved}}, Skipped: {{.Skipped}}, Total reviewed: {{.Total}}",