feat(deploy): add solutions to the studio and app deploy-target checks

Populates `solution` for the remaining blockers: missing organization/project id,
external-host misuse, an unresolved studio/app target, and a non-deployable
federated app. The dry-run report lists each under its problem.

Author: gu-stav

packages/@sanity/cli/src/actions/deploy/deployApp.ts

@@ -55,6 +55,7 @@ async function runAppDeployment(options: DeployAppOptions, reporter: CheckReport
       reporter.report({
         exitCode: exitCodes.USAGE_ERROR,
         message: getErrorMessage(err),
+        solution: 'Declare at least one entry, view, or service in the app',
         status: 'fail',
       })
     }
@@ -70,12 +71,20 @@ async function runAppDeployment(options: DeployAppOptions, reporter: CheckReport
   reporter.report(
     organizationId
       ? {message: `Organization: ${organizationId}`, status: 'pass'}
-      : {message: NO_ORGANIZATION_ID, status: 'fail'},
+      : {
+          message: NO_ORGANIZATION_ID,
+          solution: 'Add `app.organizationId` to sanity.cli.ts',
+          status: 'fail',
+        },
   )
 
   let application: UserApplication | null = null
   if (flags.external) {
-    reporter.report({message: EXTERNAL_APP_NOT_SUPPORTED, status: 'fail'})
+    reporter.report({
+      message: EXTERNAL_APP_NOT_SUPPORTED,
+      solution: 'Remove the --external flag — apps deploy to Sanity hosting',
+      status: 'fail',
+    })
   } else {
     application = await resolveAppApplication(options)
   }

packages/@sanity/cli/src/actions/deploy/deployChecks.ts

@@ -291,12 +291,20 @@ export async function checkStudioTarget(
           return
         }
         case 'invalid': {
-          reporter.report({message: resolution.message, status: 'fail'})
+          reporter.report({
+            message: resolution.message,
+            solution: 'Check `studioHost` and `deployment.appId` in sanity.cli.ts',
+            status: 'fail',
+          })
           return
         }
         case 'needs-input': {
           // The same constraint an unattended deploy enforces, with the same message
-          reporter.report({message: cannotPromptForStudioHost(isExternal), status: 'fail'})
+          reporter.report({
+            message: cannotPromptForStudioHost(isExternal),
+            solution: 'Set `studioHost` in sanity.cli.ts, or pass a hostname with --url',
+            status: 'fail',
+          })
           return
         }
         case 'would-create': {

packages/@sanity/cli/src/actions/deploy/deployStudio.ts

@@ -53,9 +53,8 @@ async function runStudioDeployment(
     // --external skips.
     reporter.report({
       exitCode: exitCodes.USAGE_ERROR,
-      message:
-        'Deploying a federated application to an external host is not yet supported. ' +
-        'Remove the `--external` flag to deploy to Sanity hosting.',
+      message: 'Deploying a federated application to an external host is not yet supported',
+      solution: 'Remove the --external flag to deploy to Sanity hosting',
       status: 'fail',
     })
   }
@@ -68,7 +67,11 @@ async function runStudioDeployment(
   reporter.report(
     projectId
       ? {message: `Project: ${projectId}`, status: 'pass'}
-      : {message: NO_PROJECT_ID, status: 'fail'},
+      : {
+          message: NO_PROJECT_ID,
+          solution: 'Add `api.projectId` to sanity.cli.ts',
+          status: 'fail',
+        },
   )
 
   const application = await resolveStudioApplication(options)