feat: Replace prompts library with @clack/prompts

[razor-x]

Summary

Migrated the CLI's interactive prompting system from the prompts library to @clack/prompts, providing a more modern and composable API for user interactions.

Key Changes

• Replaced prompt library: Removed dependency on prompts and added @clack/prompts as the new prompting solution
• Refactored prompt API: Replaced the generic prompt() function with specialized, type-safe functions:
  • promptText() - for text input
  • promptNumber() - for numeric input with validation
  • promptConfirm() - for yes/no confirmations
  • promptSelect() - for single-choice selection
  • promptAutocomplete() - for searchable selection
  • promptAutocompleteMultiselect() - for multi-select with search
• Added error handling: Introduced PromptCancelledError to handle user cancellations (Ctrl+C/Escape)
• Standardized choice format: Created PromptChoice<Value> interface with label, value, and optional hint fields, replacing the previous title/description format
• Updated all call sites: Modified all interactive modules to use the new prompt functions:
  • interact-for-blueprint-object.ts
  • interact-for-custom-metadata.ts
  • interact-for-use-remote-api-defs.ts
  • interact-for-array.ts
  • interact-for-server-selection.ts
  • interact-for-timestamp.ts
  • interact-for-command-selection.ts
  • interact-for-workspace-id.ts
  • interact-for-resource.ts
  • interact-for-action-attempt-poll.ts
  • interact-for-login.ts
  • cli.ts
• Improved timestamp handling: Replaced the date prompt type with promptText() and added custom validation for ISO timestamp format
• Updated tests: Modified test mocks to reflect the new prompt function signatures

Notable Implementation Details

• All prompts output to stderr to prevent interference with stdout when piped
• The ensureInteractive() helper validates that a TTY is available before prompting
• The unwrap() helper converts @clack/prompts cancel symbols to PromptCancelledError exceptions
• Validation functions now return undefined for valid input (instead of true) to match @clack/prompts conventions
• Removed unnecessary null checks in several places since the new API throws on cancellation rather than returning undefined

https://claude.ai/code/session_01N2Ch14ybwrTTFwM7sHFWr6