feat: Add multi-storage support and GitHub Actions CI/CD

[frontmesh]

Multi-Storage Support & GitHub Actions CI/CD

Overview

This PR implements comprehensive multi-storage support for cf-kv CLI along with fully automated CI/CD pipeline using GitHub Actions.

Features

1. Multi-Storage Management ✨

• Add, list, switch, and manage multiple named storage configurations
• Support for different Cloudflare accounts and KV namespaces
• Easy environment management (prod/staging/dev)
• Automatic legacy config migration for backwards compatibility

2. CLI Enhancements 🎯

• 7 new storage management commands
• Support for text, JSON, and YAML output formats
• Clear active storage indicator
• Intuitive user interface

3. GitHub Actions CI/CD 🚀

• Multi-platform testing (Ubuntu, macOS, Windows)
• Multi-target builds (Linux, macOS Intel/ARM, Windows)
• Automatic tag creation on version bumps
• Automated release creation with binary artifacts
• PR validation with format & lint checks

4. Comprehensive Documentation 📚

• Complete user guide for storage management
• Technical implementation details
• CI/CD pipeline documentation
• Release workflow guide
• Documentation index for easy navigation

Changes

Code

• crates/cfkv/src/config.rs - New Storage management logic (~350 lines)
• crates/cfkv/src/cli.rs - New StorageCommands enum (~75 lines)
• crates/cfkv/src/main.rs - Storage command handlers (~200 lines)

Documentation (Moved to docs/ folder)

• docs/README.md - Documentation index and navigation
• docs/STORAGE_MANAGEMENT.md - Complete user guide (445 lines)
• docs/IMPLEMENTATION_SUMMARY.md - Technical architecture (257 lines)
• docs/GITHUB_ACTIONS.md - CI/CD pipeline details (238 lines)
• docs/RELEASE_WORKFLOW.md - Release process guide (270 lines)
• README.md - Updated with multi-storage section

Automation

• .github/workflows/test-and-release.yml - Testing and release automation
• .github/workflows/pr-checks.yml - PR validation workflow
• PROJECT_SUMMARY.md - Complete project overview

Testing

✅ All 51 tests passing

• 15 config tests ✅
• 17 blog tests ✅
• 19 cloudflare-kv tests ✅

✅ Build: Success
✅ Format: Pass
✅ Linting: Pass

Usage Examples

Add multiple storages

cfkv storage add prod -a account1 -n namespace1 -t token1
cfkv storage add dev -a account2 -n namespace2 -t token2

List and switch

cfkv storage list
cfkv storage switch dev
cfkv storage current

Use the active storage

cfkv list
cfkv get mykey
cfkv put mykey --value "test"

Release Process

Now fully automated! To create a release:

1. Update version in Cargo.toml
2. Commit and push to main
3. GitHub Actions automatically:
   • Creates git tag
   • Builds binaries for all platforms
   • Creates GitHub Release with artifacts

Backwards Compatibility

✅ Fully backwards compatible

• Legacy single-storage configs automatically migrated
• No manual intervention needed
• All existing scripts continue to work
• Seamless upgrade path

Documentation

All documentation is in the docs/ folder with a clear navigation index:

• Getting Started: README.md → docs/STORAGE_MANAGEMENT.md
• Making Releases: docs/RELEASE_WORKFLOW.md
• CI/CD Details: docs/GITHUB_ACTIONS.md
• Technical Details: docs/IMPLEMENTATION_SUMMARY.md

Branch Info

Branch: feature/multi-storage-support
Commits: 8 focused commits with clear messages
Total Changes: ~2,549 lines (625 code + 1,924 documentation)

Checklist

• All tests passing
• No compiler warnings
• No clippy warnings
• Code formatted with cargo fmt
• Documentation complete
• Backwards compatible
• GitHub Actions workflows configured
• Release automation tested

Related Issues

Closes #0 (Replace with actual issue number if applicable)

Screenshots / Examples

$ cfkv storage list
Available storages:

* prod  (account: abc123, namespace: ns456)
  dev   (account: def456, namespace: ns789)
  staging (account: ghi789, namespace: ns012)

$ cfkv storage switch dev
Switched to storage 'dev'

$ cfkv --format json storage list
[
  {
    "name": "prod",
    "account_id": "abc123...",
    "namespace_id": "ns456...",
    "active": false
  },
  {
    "name": "dev",
    "account_id": "def456...",
    "namespace_id": "ns789...",
    "active": true
  }
]

Notes

This PR is ready for production use. All features are fully tested and documented. The CI/CD automation is configured and tested using GitHub Actions.