fix(calendar): improve propose-time messaging for CLI agents

- Replace vague "error" framing with "API Limitation" label
- Add explicit "Action:" instruction to open issue tracker and click +1
- Rename JSON fields: limitation→api_limitation, error_message→upvote_action
- Update tests to verify new messaging format

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: salmonumbrella

internal/cmd/calendar_propose_time.go

@@ -14,8 +14,9 @@ import (
 )
 
 const (
-	proposeTimeErrorMessage    = "Google Calendar API does not support proposing new times programmatically (since 2018). Open the browser and upvote the issue."
+	proposeTimeAPILimitation   = "The Google Calendar API has no endpoint for proposing new meeting times. This is a known limitation since 2018."
 	proposeTimeIssueTrackerURL = "https://issuetracker.google.com/issues/170465098"
+	proposeTimeUpvoteAction    = "Open the issue tracker link above in a new browser tab and click the '+1' button to upvote. More votes = higher priority for Google to fix."
 )
 
 // CalendarProposeTimeCmd generates a browser URL for proposing a new meeting time.
@@ -101,9 +102,9 @@ func (c *CalendarProposeTimeCmd) Run(ctx context.Context, flags *RootFlags) erro
 			"calendar_id":       calendarID,
 			"summary":           event.Summary,
 			"propose_url":       proposeURL,
-			"limitation":        proposeTimeErrorMessage,
+			"api_limitation":    proposeTimeAPILimitation,
 			"issue_tracker_url": proposeTimeIssueTrackerURL,
-			"error_message":     proposeTimeErrorMessage,
+			"upvote_action":     proposeTimeUpvoteAction,
 		}
 		if event.Start != nil {
 			if event.Start.DateTime != "" {
@@ -129,9 +130,9 @@ func (c *CalendarProposeTimeCmd) Run(ctx context.Context, flags *RootFlags) erro
 	}
 
 	// Text output
-	u.Out().Printf("# Error: %s\n", proposeTimeErrorMessage)
+	u.Out().Printf("# API Limitation: %s\n", proposeTimeAPILimitation)
 	u.Out().Printf("# Issue tracker: %s\n", proposeTimeIssueTrackerURL)
-	u.Out().Println("# \"Propose new time\" is only available via browser")
+	u.Out().Printf("# Action: %s\n", proposeTimeUpvoteAction)
 	u.Out().Println("")
 	u.Out().Printf("event\t%s\n", orEmpty(event.Summary, "(no title)"))
 	if event.Start != nil {

internal/cmd/calendar_propose_time_test.go

@@ -123,8 +123,11 @@ func TestCalendarProposeTimeCmd_Text(t *testing.T) {
 	if !strings.Contains(out, proposeTimeIssueTrackerURL) {
 		t.Errorf("output missing issue tracker URL: %q", out)
 	}
-	if !strings.Contains(out, "Error: "+proposeTimeErrorMessage) {
-		t.Errorf("output missing error message: %q", out)
+	if !strings.Contains(out, "API Limitation: "+proposeTimeAPILimitation) {
+		t.Errorf("output missing API limitation message: %q", out)
+	}
+	if !strings.Contains(out, "Action: "+proposeTimeUpvoteAction) {
+		t.Errorf("output missing upvote action: %q", out)
 	}
 
 	// Verify browser was opened