fix(deploy): auto-pick the only project when --project is missing

[facundofarias]

Summary

dhq deploy requires --project (or DEPLOYHQ_PROJECT / .deployhq.toml), and Mixpanel shows "No project specified" as a small but steady bucket — 19 hits / 30d, 4 of them on the current v0.18.2 release, split between humans and a claude-code agent. The fix mirrors what deploy already does for servers: when there's exactly one project on the account, just use it. When there are multiple, the error now enumerates them so agents can self-correct on retry.

• internal/commands/deploy.go — new resolveDeployProject helper: configured short-circuit, single-project auto-pick (with a Status line on stderr), zero-project hint pointing at project creation, multi-project error whose Hint lists Identifier (Name) pairs. The deploy command now resolves the project through this helper instead of RequireProject, but only when --project is missing — the configured path costs zero API calls. Long description updated so it's discoverable from --help.
• internal/commands/deploy_test.go — five unit tests: configured short-circuit (no API hits), lone-project pick, multi-project listing, zero-project hint, and an API-error path that asserts on the first line of err.Error() to keep the "No project specified" headline continuous in the existing Mixpanel bucket.

Why scope to deploy specifically

RequireProject is called from many list/show commands; firing ListProjects from every one of them on a stale config would balloon API traffic. The data showed pain only on deploy, where the user clearly wants one project, so the auto-pick lives there and other commands keep their existing fast-fail behaviour.

Test plan

• go test ./... — all packages green
• golangci-lint run ./... — 0 issues
• New tests cover configured / 1 / 0 / many / API-error branches
• Headline-preservation assertion guards the telemetry bucket continuity

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features

  • The deploy command now auto-determines your deploy project when none is specified and provides clear, actionable error messages for zero, multiple, or failed project lookups. Help text updated to document this behavior.

• Tests

  • Expanded test coverage for project auto-selection, telemetry output, and error messaging across single, multiple, zero, and API-failure scenarios.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: b6e40862-9142-4d20-a4e7-285a7f1a372c

📥 Commits

Reviewing files that changed from the base of the PR and between 37559b3 and 60dcc2d.

📒 Files selected for processing (2)

• internal/commands/deploy.go
• internal/commands/deploy_test.go

Disabled knowledge base sources:

• Linear integration is disabled

You can enable these sources in your CodeRabbit configuration.

---

Walkthrough

This PR adds automatic project selection to the dhq deploy command. When no project is explicitly specified via --project or configuration, the new resolveDeployProject function lists available projects and auto-selects if exactly one exists, or returns actionable errors for zero/multiple projects. The change includes updated help text and comprehensive tests validating all resolution paths.

Changes

Deploy Project Auto-Resolution

Layer / File(s)	Summary
Project auto-resolution logic and integration internal/commands/deploy.go	resolveDeployProject auto-determines the project by listing and selecting the only one, or returning errors with hints for zero/multiple projects or API failures. Help text documents the behavior. Command initialization deferred project resolution until after flag validation, replacing early cliCtx.RequireProject() with the new helper.
Tests and test helpers for project resolution internal/commands/deploy_test.go	Test imports added for output buffering. testEnvelope helper constructed test envelopes with buffered stderr. New test suite covers configured project short-circuit, single-project auto-pick with telemetry, multi/zero-project errors with headline/hints, and API error headline preservation.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title directly and concisely summarizes the main change: auto-picking the only project when --project is missing, which is the core feature added in this PR.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/deploy-auto-pick-project

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}