Update README with correct executable names and examples

[leogdion]

Description

Update the README.md file to use correct executable names and provide comprehensive usage examples for MistKit.

Background

CodeRabbit identified that the README contains incorrect executable names and lacks proper authentication examples during PR #105 review.

Tasks

• Verify and correct all executable names referenced in README
• Add comprehensive installation guide
• Include authentication workflow examples
• Add usage examples for key functionality
• Document platform support and requirements
• Add troubleshooting section

Required Sections

1. Installation

   • Swift Package Manager integration
   • Platform requirements

2. Authentication Examples

   • Server-to-server authentication
   • API token usage
   • Token management strategies

3. Usage Examples

   • Basic CloudKit operations
   • Configuration setup
   • Error handling patterns

4. Platform Support

   • Supported Swift versions
   • Platform compatibility matrix
   • Known limitations

Acceptance Criteria

• All executable names are accurate
• Installation instructions work for new users
• Authentication examples are complete and functional
• README serves as effective project introduction

Related

• PR Adding Server to Server Authentication #105 CodeRabbit feedback
• Documentation quality initiative

Labels

documentation, readme, examples

[leogdion]

Addressed in README