feat: add loading animations with global API proxy integration

[scottlovegrove]

Summary

Add NPM-style loading spinners to all CLI commands using a global API proxy approach that automatically wraps all Twist API calls with appropriate loading animations.

Key Features

• 🔄 Global API Proxy: Automatically adds spinners to all TwistApi method calls without requiring code changes to existing commands
• 🎨 Context-aware messages: Different spinners for read operations (blue), create operations (green), and update/delete operations (yellow)
• 🔧 Zero maintenance: New API methods automatically get spinners without any additional development work
• ⚙️ Smart configuration: Auto-disables in CI environments, non-TTY terminals, and JSON output modes
• 📱 Professional UX: Provides immediate visual feedback during network operations, similar to NPM's loading experience

Implementation Details

Core Components

• yocto-spinner package (2KB, zero dependencies) - Modern, lightweight spinner library
• src/lib/spinner.ts - Core spinner utilities with withSpinner function and LoadingSpinner class
• src/lib/api.ts - Enhanced with Proxy wrapper that intercepts all API calls
• Global configuration - --no-spinner option and TW_SPINNER=false environment variable support

API Method Mapping

The proxy automatically maps API methods to appropriate loading messages:

Method	Message	Color
users.getSessionUser()	"Checking authentication..."	Blue
workspaces.getWorkspaces()	"Loading workspaces..."	Blue
threads.getThread()	"Loading thread..."	Blue
comments.createComment()	"Creating comment..."	Green
comments.updateComment()	"Updating comment..."	Yellow
inbox.archiveThread()	"Archiving thread..."	Yellow
+ 15 other methods	Context-appropriate messages	Semantic colors

Configuration Options

Users can disable spinners using:

• CLI flag: tw auth status --no-spinner
• Environment variable: TW_SPINNER=false tw auth status
• Auto-detection: Automatically disabled in CI, non-TTY, and JSON output modes

Testing

• ✅ All existing tests pass (100% backward compatibility)
• ✅ 14 new spinner-specific test cases covering success/error scenarios
• ✅ Configuration options tested (flags, env vars, CI detection)
• ✅ Manual testing across multiple commands (tw auth status, tw inbox, etc.)

Benefits

1. Complete Coverage: Every API call across all commands now has loading feedback
2. Zero Technical Debt: No need to remember to add spinners to new commands
3. Consistent UX: Uniform professional experience across the entire CLI
4. Backward Compatible: All existing functionality works exactly as before
5. Future-Proof: New API methods automatically inherit spinner behavior

Demo

# Shows "Checking authentication..." spinner
tw auth status

# Shows "Loading inbox..." spinner  
tw inbox --limit 10

# Shows "Creating comment..." spinner
tw thread reply <thread-id> "Great point!"

# Disable globally
tw inbox --no-spinner

This implementation transforms the CLI into a modern, professional tool with immediate user feedback during network operations while requiring zero changes to existing command implementations.

🤖 Generated with Claude Code

[github-actions]

🎉 This PR is included in version 1.0.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[gnapse]

✅