feat(auth): merge workspace picker into use (#94)

## Summary
- remove the separate auth workspace select command
- make auth workspace use accept an optional workspace id/name
- use no-arg auth workspace use for the interactive picker, with the
existing single-workspace shortcut and non-interactive multi-workspace
usage error
- update product docs, command metadata, and auth tests

## Tests
- pnpm --filter @prisma/cli test -- auth.test.ts
- pnpm --recursive exec tsc --noEmit
- pnpm lint

Author: AmanVarshney01

docs/product/command-spec.md

@@ -456,16 +456,20 @@ prisma-cli auth workspace list
 prisma-cli auth workspace list --json
 ```
 
-## `prisma-cli auth workspace use <id-or-name>`
+## `prisma-cli auth workspace use [id-or-name]`
 
 Purpose:
 
-- switch the local CLI workspace
+- switch or interactively select the local CLI workspace
 
 Behavior:
 
-- requires a stored OAuth session for the target workspace
-- accepts the cached workspace id, credential workspace id, or cached workspace name case-insensitively
+- with `[id-or-name]`, requires a stored OAuth session for the target workspace
+- with `[id-or-name]`, accepts the cached workspace id, credential workspace id, or cached workspace name case-insensitively
+- without `[id-or-name]`, lists locally authenticated OAuth workspaces in an interactive picker when prompting is available
+- without `[id-or-name]`, shows the workspace name and workspace id for each interactive choice
+- without `[id-or-name]`, selects the only local OAuth workspace without prompting when exactly one is available
+- without `[id-or-name]`, fails in non-interactive mode when more than one local OAuth workspace is available
 - changes local CLI context only; it does not mutate a remote resource
 - fails with `WORKSPACE_SWITCH_UNAVAILABLE` when `PRISMA_SERVICE_TOKEN` is set
 - fails with `WORKSPACE_NOT_AUTHENTICATED` when no cached OAuth session matches
@@ -474,31 +478,11 @@ Behavior:
 Examples:
 
 ```bash
+prisma-cli auth workspace use
 prisma-cli auth workspace use wksp_123
 prisma-cli auth workspace use "Acme Inc"
 ```
 
-## `prisma-cli auth workspace select`
-
-Purpose:
-
-- interactively switch the local CLI workspace
-
-Behavior:
-
-- lists locally authenticated OAuth workspaces in an interactive picker
-- shows the workspace name and workspace id for each choice
-- changes local CLI context only; it does not mutate a remote resource
-- fails with `WORKSPACE_SWITCH_UNAVAILABLE` when `PRISMA_SERVICE_TOKEN` is set
-- when exactly one local OAuth workspace is available, selects it without prompting
-- fails in non-interactive mode when more than one local OAuth workspace is available
-
-Examples:
-
-```bash
-prisma-cli auth workspace select
-```
-
 ## `prisma-cli auth workspace logout <id-or-name>`
 
 Purpose:

packages/cli/src/commands/auth/index.ts

@@ -8,7 +8,6 @@ import {
   runAuthWhoAmI,
   runAuthWorkspaceList,
   runAuthWorkspaceLogout,
-  runAuthWorkspaceSelect,
   runAuthWorkspaceUse,
 } from "../../controllers/auth";
 import {
@@ -160,7 +159,6 @@ function createAuthWorkspaceCommand(runtime: CliRuntime): Command {
 
   workspace.addCommand(createAuthWorkspaceListCommand(runtime));
   workspace.addCommand(createAuthWorkspaceUseCommand(runtime));
-  workspace.addCommand(createAuthWorkspaceSelectCommand(runtime));
   workspace.addCommand(createAuthWorkspaceLogoutCommand(runtime));
 
   return workspace;
@@ -191,31 +189,6 @@ function createAuthWorkspaceListCommand(runtime: CliRuntime): Command {
   return command;
 }
 
-function createAuthWorkspaceSelectCommand(runtime: CliRuntime): Command {
-  const command = attachCommandDescriptor(
-    configureRuntimeCommand(new Command("select"), runtime),
-    "auth.workspace.select",
-  );
-
-  addGlobalFlags(command);
-
-  command.action(async (options) => {
-    await runCommand<AuthWorkspaceUseResult>(
-      runtime,
-      "auth.workspace.select",
-      options as Record<string, unknown>,
-      (context) => runAuthWorkspaceSelect(context),
-      {
-        renderHuman: (context, descriptor, result) =>
-          renderAuthWorkspaceUse(context, descriptor, result),
-        renderJson: (result) => serializeAuthWorkspaceUse(result),
-      },
-    );
-  });
-
-  return command;
-}
-
 function createAuthWorkspaceLogoutCommand(runtime: CliRuntime): Command {
   const command = attachCommandDescriptor(
     configureRuntimeCommand(new Command("logout"), runtime),
@@ -252,7 +225,7 @@ function createAuthWorkspaceUseCommand(runtime: CliRuntime): Command {
     "auth.workspace.use",
   );
 
-  command.argument("<id-or-name>", "Workspace id or exact name");
+  command.argument("[id-or-name]", "Workspace id or exact name");
   addGlobalFlags(command);
 
   command.action(async (workspaceRef, options) => {

packages/cli/src/controllers/auth.ts

@@ -123,20 +123,15 @@ export async function runAuthWorkspaceUse(
   context: CommandContext,
   workspaceRef: string | undefined,
 ): Promise<CommandSuccess<AuthWorkspaceUseResult>> {
-  if (!workspaceRef?.trim()) {
-    throw usageError(
-      "Workspace required",
-      "auth workspace use needs a workspace id or cached workspace name.",
-      "Pass a workspace from prisma-cli auth workspace list.",
-      ["prisma-cli auth workspace list"],
-      "auth",
-    );
-  }
+  const trimmedWorkspaceRef = workspaceRef?.trim();
+  const selectedWorkspaceRef = trimmedWorkspaceRef
+    ? trimmedWorkspaceRef
+    : await selectWorkspaceSession(context);
 
   const result = isRealMode(context)
-    ? await useRealAuthWorkspace(context, workspaceRef)
+    ? await useRealAuthWorkspace(context, selectedWorkspaceRef)
     : await createAuthUseCases(createCliUseCaseGateways(context)).useWorkspace(
-        workspaceRef,
+        selectedWorkspaceRef,
       );
 
   return {
@@ -147,17 +142,6 @@ export async function runAuthWorkspaceUse(
   };
 }
 
-export async function runAuthWorkspaceSelect(
-  context: CommandContext,
-): Promise<CommandSuccess<AuthWorkspaceUseResult>> {
-  const workspaceRef = await selectWorkspaceSession(context);
-  const success = await runAuthWorkspaceUse(context, workspaceRef);
-  return {
-    ...success,
-    command: "auth.workspace.select",
-  };
-}
-
 export async function runAuthWorkspaceLogout(
   context: CommandContext,
   workspaceRef: string | undefined,
@@ -396,7 +380,7 @@ async function selectWorkspaceSession(
   if (!canPrompt(context)) {
     throw usageError(
       "Interactive workspace selection unavailable",
-      "auth workspace select needs an interactive terminal when more than one workspace is available.",
+      "auth workspace use needs an interactive terminal when no workspace is provided and more than one workspace is available.",
       "Run prisma-cli auth workspace use <id-or-name> with a workspace from prisma-cli auth workspace list.",
       ["prisma-cli auth workspace list"],
       "auth",

packages/cli/src/shell/command-meta.ts

@@ -56,7 +56,7 @@ const DESCRIPTORS: CommandDescriptor[] = [
     description: "Manage local authenticated workspaces",
     examples: [
       "prisma-cli auth workspace list",
-      "prisma-cli auth workspace select",
+      "prisma-cli auth workspace use",
       "prisma-cli auth workspace use wksp_123",
       "prisma-cli auth workspace logout wksp_123",
     ],
@@ -75,16 +75,11 @@ const DESCRIPTORS: CommandDescriptor[] = [
     path: ["prisma", "auth", "workspace", "use"],
     description: "Switch the local CLI workspace",
     examples: [
+      "prisma-cli auth workspace use",
       "prisma-cli auth workspace use wksp_123",
       'prisma-cli auth workspace use "Acme Inc"',
     ],
   },
-  {
-    id: "auth.workspace.select",
-    path: ["prisma", "auth", "workspace", "select"],
-    description: "Interactively select the local CLI workspace",
-    examples: ["prisma-cli auth workspace select"],
-  },
   {
     id: "auth.workspace.logout",
     path: ["prisma", "auth", "workspace", "logout"],