Improve CI/CD pipeline and release management

[lroolle]

Epic: CI/CD and Release Infrastructure

Goal: Establish robust CI/CD pipeline, versioning, and release automation for professional project maintenance.

🏗️ GitHub Actions & CI

Code Quality Pipeline

• Shellcheck: Lint all bash scripts (claude.sh, claude-yolo, docker-entrypoint.sh, install.sh)
• Hadolint: Dockerfile linting and best practices
• Conventional Commits: Validate commit message format
• EditorConfig: Enforce consistent code formatting

Build & Test Pipeline

• Multi-arch builds: amd64, arm64 support
• Integration tests: Basic functionality testing
• Docker build caching: Speed up CI builds
• Security scanning: Container vulnerability scanning

📦 Release Management

Versioning & Tagging

• Script versioning: Add version to claude.sh (--version flag)
• Git tags: Semantic versioning (v0.1.1, v0.2.0)
• Automated releases: Create releases from tags
• Release notes: Auto-generate from conventional commits

Container Registry

• GHCR migration: Move from Docker Hub to ghcr.io/lroolle/claude-code-yolo
• Multi-platform manifests: Single tag for all architectures
• Image signing: Cosign for supply chain security
• Retention policies: Clean up old development images

🛠️ Developer Experience

Installation Improvements

• install.sh v2: Version selection, update detection
• One-liner install: curl -sSL install.sh | bash
• Global installation: System-wide claude-yolo command
• Auto-updates: Check for new versions

User Experience

• Startup prompts: Improve entrypoint.sh and claude.sh messaging
• Better help: Rich help with examples and troubleshooting
• Progress indicators: Show download/build progress
• Error diagnostics: Better error messages with solutions

🔧 Code Quality

Refactoring Targets

• claude.sh: Split 570+ line script into modules
• Dockerfile cleanup: Remove duplicate installations, optimize layers
• Test coverage: Unit tests for argument parsing

Documentation

• API docs: Document all environment variables and flags
• Contributing guide: Development setup and guidelines
• Architecture docs: System design and data flow

🎯 Implementation Priority

Phase 1 (v0.1.1):

• Shellcheck + Hadolint CI
• Script versioning
• GHCR migration
• install.sh improvements

Phase 2 (v0.2.0):

• Multi-arch builds
• Automated releases
• Integration tests
• Enhanced user experience

Phase 3 (v0.3.0):

• Code refactoring
• Security scanning
• Advanced features

📋 Success Criteria

• ✅ All scripts pass linting without warnings
• ✅ Multi-platform Docker images auto-build on every release
• ✅ Zero-downtime updates via install.sh
• ✅ Professional release workflow with automated notes
• ✅ Clear versioning and backward compatibility

🚀 Related Issues

Addresses high-priority items from TODO.md:

• GitHub Actions CI/CD pipeline
• Script versioning
• Multi-platform images
• Release workflow automation

Epic Size: Large (~3-4 weeks)
Impact: High - Foundation for sustainable project growth

[lroolle]

Largely resolved: CI/CD pipeline implemented with shellcheck linting, multi-arch builds, GitHub Container Registry, automated releases, and proper caching. Major items from the epic completed across releases v0.2.0-v0.2.4.