fix(deploy): improve build-watch timeout and cancellation error reporting

[ealogar]

Replace the generic "context exceeds deadline" error in WatchDeployment with
actionable messages that include the package ID, suggest --timeout, and wrap the
underlying context error. Cancellations and deadline-exceeded are now reported
with distinct messages so users are not misled.

Clarify the --timeout flag help text to explain it is the overall command
deadline (including build time), and document the default in the timeout
constant comment.

Changes:

• Distinguish context.Canceled from context.DeadlineExceeded in
  WatchDeployment, returning a specific message for each case.
• Wrap ctx.Err() so callers can inspect the cause with errors.Is().
• Reword --timeout help: "Overall deadline for the command, including
  waiting for a build to finish (e.g. 20m)".
• Add unit tests covering both the deadline-exceeded and cancellation
  paths in WatchDeployment.

[vonage-ai-assistant]

AI Adoption Report

	Lines	%
AI-generated	14	100%
Human	0	0%
Untracked	117	—
Total	131

💰 Cost Breakdown

Agent	Model	AI Lines	Input Tokens	Output Tokens	Cost	Source
kiro	auto	12	140	42	$0.0010	📐 estimated
GitHub Copilot	github-copilot	2	23	7	$0.0000	🤖 Copilot (subscription)

Total Estimated Cost: $0.0010

Data Sources:

• 📐 2 commits with estimated tokens (~3.5 tokens/line)

Bedrock pricing: eu-central-1 region

Per-commit breakdown (5 commits)

Commit	Message	Added	AI	Human	AI %
1b1d294	fix(deploy): improve build-watch timeout error and keep defa	12	12	0	100%
da4e8ba	fix: add gitignore	3	—	—	untracked
c7d7fe9	test(deploy): cover WatchDeployment ctx.Done() timeout and c	99	—	—	untracked
be205d9	Potential fix for pull request finding	2	2	0	🤖 100% (Copilot)
7b7910e	fix(deploy): align build-watch deadline with server-side bui	15	—	—	untracked

Warning

The following commits have no Git AI authorship notes — AI adoption cannot be tracked for these changes.
Install git-ai locally (curl -sSL https://usegitai.com/install.sh | bash) to enable automatic tracking.
An automation that cannot run git-ai can declare its own attribution instead, by putting #ai-attribution-NNN in the commit message, where NNN is a whole number from 0 to 100.

• da4e8ba fix: add gitignore
• c7d7fe9 test(deploy): cover WatchDeployment ctx.Done() timeout and c
• 7b7910e fix(deploy): align build-watch deadline with server-side bui

---

_{Powered by Git AI Standard v3.0.0 — authorship data from refs/notes/ai (supports sessions-v2 format)}

[Copilot]

🟡 Changes recommended

The new ctx.Done() error path in WatchDeployment mislabels cancellations as timeouts and the new behavior isn’t covered by unit tests.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

This PR adjusts the CLI’s global timeout behavior and deployment build-watch error reporting so long-running (10–15m) builds don’t fail client-side before the server-side build deadline is reached.

Changes:

• Increased the root command default timeout from 10m to 16m to exceed the server-side build cap.
• Updated --timeout help text to clarify it is a whole-command deadline (including build watching).
• Replaced the generic build-watch timeout error with an actionable, wrapped error that includes ctx.Err().

File summaries

File	Description
vcr/root/root.go	Raises the global default timeout and clarifies the --timeout flag’s semantics.
pkg/api/deployment.go	Improves the error returned when the build watch exits due to ctx.Done().

Review details

• Files reviewed: 2/2 changed files
• Comments generated: 3
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[gorkarevilla]

LGTM