@haposoft/cafekit 0.16.0-rc.8 → 0.16.0

package/src/claude/skills/devops/scripts/cloudflare_deploy.py

@@ -1,269 +0,0 @@
-#!/usr/bin/env python3
-"""
-Cloudflare Worker Deployment Utility
-
-Automates Cloudflare Worker deployments with wrangler.toml configuration handling,
-multi-environment support, and comprehensive error handling.
-
-Usage:
-    python cloudflare-deploy.py --env production --dry-run
-    python cloudflare-deploy.py --project ./my-worker --env staging
-"""
-
-import argparse
-import json
-import subprocess
-import sys
-from pathlib import Path
-from typing import Dict, List, Optional, Tuple
-
-
-class CloudflareDeployError(Exception):
-    """Custom exception for Cloudflare deployment errors."""
-    pass
-
-
-class CloudflareDeploy:
-    """Handle Cloudflare Worker deployments with wrangler CLI."""
-
-    def __init__(self, project_dir: Path, env: Optional[str] = None,
-                 dry_run: bool = False, verbose: bool = False):
-        """
-        Initialize CloudflareDeploy.
-
-        Args:
-            project_dir: Path to Worker project directory
-            env: Environment name (production, staging, dev)
-            dry_run: Preview deployment without actually deploying
-            verbose: Enable verbose output
-        """
-        self.project_dir = Path(project_dir).resolve()
-        self.env = env
-        self.dry_run = dry_run
-        self.verbose = verbose
-        self.wrangler_toml = self.project_dir / "wrangler.toml"
-
-    def validate_project(self) -> bool:
-        """
-        Validate project directory and wrangler.toml existence.
-
-        Returns:
-            True if valid, False otherwise
-
-        Raises:
-            CloudflareDeployError: If validation fails
-        """
-        if not self.project_dir.exists():
-            raise CloudflareDeployError(
-                f"Project directory does not exist: {self.project_dir}"
-            )
-
-        if not self.wrangler_toml.exists():
-            raise CloudflareDeployError(
-                f"wrangler.toml not found in: {self.project_dir}"
-            )
-
-        return True
-
-    def check_wrangler_installed(self) -> bool:
-        """
-        Check if wrangler CLI is installed.
-
-        Returns:
-            True if installed, False otherwise
-        """
-        try:
-            result = subprocess.run(
-                ["wrangler", "--version"],
-                capture_output=True,
-                text=True,
-                check=True
-            )
-            if self.verbose:
-                print(f"Wrangler version: {result.stdout.strip()}")
-            return True
-        except (subprocess.CalledProcessError, FileNotFoundError):
-            return False
-
-    def run_command(self, cmd: List[str], check: bool = True) -> Tuple[int, str, str]:
-        """
-        Run shell command and capture output.
-
-        Args:
-            cmd: Command and arguments as list
-            check: Raise exception on non-zero exit code
-
-        Returns:
-            Tuple of (exit_code, stdout, stderr)
-
-        Raises:
-            CloudflareDeployError: If command fails and check=True
-        """
-        if self.verbose:
-            print(f"Running: {' '.join(cmd)}")
-
-        try:
-            result = subprocess.run(
-                cmd,
-                capture_output=True,
-                text=True,
-                cwd=self.project_dir,
-                check=check
-            )
-            return result.returncode, result.stdout, result.stderr
-        except subprocess.CalledProcessError as e:
-            if check:
-                raise CloudflareDeployError(
-                    f"Command failed: {' '.join(cmd)}\n{e.stderr}"
-                )
-            return e.returncode, e.stdout, e.stderr
-
-    def get_worker_name(self) -> str:
-        """
-        Extract worker name from wrangler.toml.
-
-        Returns:
-            Worker name
-
-        Raises:
-            CloudflareDeployError: If name cannot be extracted
-        """
-        try:
-            with open(self.wrangler_toml, 'r') as f:
-                for line in f:
-                    if line.strip().startswith('name'):
-                        # Parse: name = "worker-name"
-                        return line.split('=')[1].strip().strip('"\'')
-        except Exception as e:
-            raise CloudflareDeployError(f"Failed to read worker name: {e}")
-
-        raise CloudflareDeployError("Worker name not found in wrangler.toml")
-
-    def build_deploy_command(self) -> List[str]:
-        """
-        Build wrangler deploy command with appropriate flags.
-
-        Returns:
-            Command as list of strings
-        """
-        cmd = ["wrangler", "deploy"]
-
-        if self.env:
-            cmd.extend(["--env", self.env])
-
-        if self.dry_run:
-            cmd.append("--dry-run")
-
-        return cmd
-
-    def deploy(self) -> bool:
-        """
-        Execute deployment.
-
-        Returns:
-            True if successful
-
-        Raises:
-            CloudflareDeployError: If deployment fails
-        """
-        # Validate
-        self.validate_project()
-
-        if not self.check_wrangler_installed():
-            raise CloudflareDeployError(
-                "wrangler CLI not installed. Install: npm install -g wrangler"
-            )
-
-        worker_name = self.get_worker_name()
-        env_suffix = f" ({self.env})" if self.env else ""
-        mode = "DRY RUN" if self.dry_run else "DEPLOY"
-
-        print(f"\n{mode}: {worker_name}{env_suffix}")
-        print(f"Project: {self.project_dir}\n")
-
-        # Build and run command
-        cmd = self.build_deploy_command()
-        exit_code, stdout, stderr = self.run_command(cmd)
-
-        # Output results
-        if stdout:
-            print(stdout)
-        if stderr:
-            print(stderr, file=sys.stderr)
-
-        if exit_code == 0:
-            status = "would be deployed" if self.dry_run else "deployed successfully"
-            print(f"\n✓ Worker {status}")
-            return True
-        else:
-            raise CloudflareDeployError("Deployment failed")
-
-
-def main():
-    """CLI entry point."""
-    parser = argparse.ArgumentParser(
-        description="Deploy Cloudflare Worker with wrangler",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Examples:
-  python cloudflare-deploy.py
-  python cloudflare-deploy.py --env production
-  python cloudflare-deploy.py --project ./my-worker --env staging
-  python cloudflare-deploy.py --dry-run
-  python cloudflare-deploy.py --env prod --verbose
-        """
-    )
-
-    parser.add_argument(
-        "--project",
-        type=str,
-        default=".",
-        help="Path to Worker project directory (default: current directory)"
-    )
-
-    parser.add_argument(
-        "--env",
-        type=str,
-        choices=["production", "staging", "dev"],
-        help="Environment to deploy to (production, staging, dev)"
-    )
-
-    parser.add_argument(
-        "--dry-run",
-        action="store_true",
-        help="Preview deployment without actually deploying"
-    )
-
-    parser.add_argument(
-        "--verbose",
-        "-v",
-        action="store_true",
-        help="Enable verbose output"
-    )
-
-    args = parser.parse_args()
-
-    try:
-        deployer = CloudflareDeploy(
-            project_dir=args.project,
-            env=args.env,
-            dry_run=args.dry_run,
-            verbose=args.verbose
-        )
-
-        success = deployer.deploy()
-        sys.exit(0 if success else 1)
-
-    except CloudflareDeployError as e:
-        print(f"Error: {e}", file=sys.stderr)
-        sys.exit(1)
-    except KeyboardInterrupt:
-        print("\nDeployment cancelled by user", file=sys.stderr)
-        sys.exit(130)
-    except Exception as e:
-        print(f"Unexpected error: {e}", file=sys.stderr)
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

package/src/claude/skills/devops/scripts/docker_optimize.py

@@ -1,332 +0,0 @@
-#!/usr/bin/env python3
-"""
-Dockerfile Optimization Analyzer
-
-Analyzes Dockerfiles for optimization opportunities including multi-stage builds,
-security issues, size reduction, and best practices.
-
-Usage:
-    python docker-optimize.py Dockerfile
-    python docker-optimize.py --json Dockerfile
-    python docker-optimize.py --verbose Dockerfile
-"""
-
-import argparse
-import json
-import re
-import sys
-from pathlib import Path
-from typing import Dict, List, Optional, Tuple
-
-# Windows UTF-8 compatibility (works for both local and global installs)
-CLAUDE_ROOT = Path(__file__).parent.parent.parent.parent
-sys.path.insert(0, str(CLAUDE_ROOT / 'scripts'))
-try:
-    from win_compat import ensure_utf8_stdout
-    ensure_utf8_stdout()
-except ImportError:
-    if sys.platform == 'win32':
-        import io
-        if hasattr(sys.stdout, 'buffer'):
-            sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
-
-
-class DockerfileAnalyzer:
-    """Analyze Dockerfile for optimization opportunities."""
-
-    def __init__(self, dockerfile_path: Path, verbose: bool = False):
-        """
-        Initialize analyzer.
-
-        Args:
-            dockerfile_path: Path to Dockerfile
-            verbose: Enable verbose output
-        """
-        self.dockerfile_path = Path(dockerfile_path)
-        self.verbose = verbose
-        self.lines = []
-        self.issues = []
-        self.suggestions = []
-
-    def load_dockerfile(self) -> bool:
-        """
-        Load and parse Dockerfile.
-
-        Returns:
-            True if loaded successfully
-
-        Raises:
-            FileNotFoundError: If Dockerfile doesn't exist
-        """
-        if not self.dockerfile_path.exists():
-            raise FileNotFoundError(f"Dockerfile not found: {self.dockerfile_path}")
-
-        with open(self.dockerfile_path, 'r') as f:
-            self.lines = f.readlines()
-
-        return True
-
-    def analyze_base_image(self) -> None:
-        """Check base image for optimization opportunities."""
-        for i, line in enumerate(self.lines, 1):
-            line = line.strip()
-            if line.startswith('FROM'):
-                # Check for 'latest' tag
-                if ':latest' in line or (': ' not in line and 'AS' not in line and '@' not in line):
-                    self.issues.append({
-                        'line': i,
-                        'severity': 'warning',
-                        'category': 'base_image',
-                        'message': 'Base image uses :latest or no tag',
-                        'suggestion': 'Use specific version tags for reproducibility'
-                    })
-
-                # Check for non-alpine/slim variants
-                if 'node' in line.lower() and 'alpine' not in line.lower():
-                    self.suggestions.append({
-                        'line': i,
-                        'category': 'size',
-                        'message': 'Consider using Alpine variant',
-                        'suggestion': 'node:20-alpine is ~10x smaller than node:20'
-                    })
-
-    def analyze_multi_stage(self) -> None:
-        """Check if multi-stage build is used."""
-        from_count = sum(1 for line in self.lines if line.strip().startswith('FROM'))
-
-        if from_count == 1:
-            # Check if build tools are installed
-            has_build_tools = any(
-                any(tool in line.lower() for tool in ['gcc', 'make', 'build-essential', 'npm install', 'pip install'])
-                for line in self.lines
-            )
-
-            if has_build_tools:
-                self.issues.append({
-                    'line': 0,
-                    'severity': 'warning',
-                    'category': 'optimization',
-                    'message': 'Single-stage build with build tools',
-                    'suggestion': 'Use multi-stage build to exclude build dependencies from final image'
-                })
-
-    def analyze_layer_caching(self) -> None:
-        """Check for optimal layer caching order."""
-        copy_lines = []
-        run_lines = []
-
-        for i, line in enumerate(self.lines, 1):
-            stripped = line.strip()
-            if stripped.startswith('COPY'):
-                copy_lines.append((i, stripped))
-            elif stripped.startswith('RUN'):
-                run_lines.append((i, stripped))
-
-        # Check if dependency files copied before source
-        has_package_copy = any('package.json' in line or 'requirements.txt' in line or 'go.mod' in line
-                               for _, line in copy_lines)
-        has_source_copy = any('COPY . .' in line or 'COPY ./' in line
-                              for _, line in copy_lines)
-
-        if has_source_copy and not has_package_copy:
-            self.issues.append({
-                'line': 0,
-                'severity': 'warning',
-                'category': 'caching',
-                'message': 'Source copied before dependencies',
-                'suggestion': 'Copy dependency files first (package.json, requirements.txt) then run install, then copy source'
-            })
-
-    def analyze_security(self) -> None:
-        """Check for security issues."""
-        has_user = any(line.strip().startswith('USER') and 'root' not in line.lower()
-                      for line in self.lines)
-
-        if not has_user:
-            self.issues.append({
-                'line': 0,
-                'severity': 'error',
-                'category': 'security',
-                'message': 'Container runs as root',
-                'suggestion': 'Create and use non-root user with USER instruction'
-            })
-
-        # Check for secrets in build
-        for i, line in enumerate(self.lines, 1):
-            if any(secret in line.upper() for secret in ['PASSWORD', 'SECRET', 'TOKEN', 'API_KEY']):
-                if 'ENV' in line or 'ARG' in line:
-                    self.issues.append({
-                        'line': i,
-                        'severity': 'error',
-                        'category': 'security',
-                        'message': 'Potential secret in Dockerfile',
-                        'suggestion': 'Use build-time arguments or runtime environment variables'
-                    })
-
-    def analyze_apt_cache(self) -> None:
-        """Check for apt cache cleanup."""
-        for i, line in enumerate(self.lines, 1):
-            if 'apt-get install' in line.lower() or 'apt install' in line.lower():
-                # Check if same RUN command cleans cache
-                if 'rm -rf /var/lib/apt/lists/*' not in line:
-                    self.suggestions.append({
-                        'line': i,
-                        'category': 'size',
-                        'message': 'apt cache not cleaned in same layer',
-                        'suggestion': 'Add && rm -rf /var/lib/apt/lists/* to reduce image size'
-                    })
-
-    def analyze_combine_run(self) -> None:
-        """Check for multiple consecutive RUN commands."""
-        consecutive_runs = 0
-        first_run_line = 0
-
-        for i, line in enumerate(self.lines, 1):
-            if line.strip().startswith('RUN'):
-                if consecutive_runs == 0:
-                    first_run_line = i
-                consecutive_runs += 1
-            else:
-                if consecutive_runs > 1:
-                    self.suggestions.append({
-                        'line': first_run_line,
-                        'category': 'layers',
-                        'message': f'{consecutive_runs} consecutive RUN commands',
-                        'suggestion': 'Combine related RUN commands with && to reduce layers'
-                    })
-                consecutive_runs = 0
-
-    def analyze_workdir(self) -> None:
-        """Check for WORKDIR usage."""
-        has_workdir = any(line.strip().startswith('WORKDIR') for line in self.lines)
-
-        if not has_workdir:
-            self.suggestions.append({
-                'line': 0,
-                'category': 'best_practice',
-                'message': 'No WORKDIR specified',
-                'suggestion': 'Use WORKDIR to set working directory instead of cd commands'
-            })
-
-    def analyze(self) -> Dict:
-        """
-        Run all analyses.
-
-        Returns:
-            Analysis results dictionary
-        """
-        self.load_dockerfile()
-
-        self.analyze_base_image()
-        self.analyze_multi_stage()
-        self.analyze_layer_caching()
-        self.analyze_security()
-        self.analyze_apt_cache()
-        self.analyze_combine_run()
-        self.analyze_workdir()
-
-        return {
-            'dockerfile': str(self.dockerfile_path),
-            'total_lines': len(self.lines),
-            'issues': self.issues,
-            'suggestions': self.suggestions,
-            'summary': {
-                'errors': len([i for i in self.issues if i.get('severity') == 'error']),
-                'warnings': len([i for i in self.issues if i.get('severity') == 'warning']),
-                'suggestions': len(self.suggestions)
-            }
-        }
-
-    def print_results(self, results: Dict) -> None:
-        """
-        Print analysis results in human-readable format.
-
-        Args:
-            results: Analysis results from analyze()
-        """
-        print(f"\nDockerfile Analysis: {results['dockerfile']}")
-        print(f"Total lines: {results['total_lines']}")
-        print(f"\nSummary:")
-        print(f"  Errors: {results['summary']['errors']}")
-        print(f"  Warnings: {results['summary']['warnings']}")
-        print(f"  Suggestions: {results['summary']['suggestions']}")
-
-        if results['issues']:
-            print(f"\n{'='*60}")
-            print("ISSUES:")
-            print('='*60)
-            for issue in results['issues']:
-                severity = issue.get('severity', 'info').upper()
-                line_info = f"Line {issue['line']}" if issue['line'] > 0 else "General"
-                print(f"\n[{severity}] {line_info} - {issue['category']}")
-                print(f"  {issue['message']}")
-                print(f"  → {issue['suggestion']}")
-
-        if results['suggestions']:
-            print(f"\n{'='*60}")
-            print("SUGGESTIONS:")
-            print('='*60)
-            for sugg in results['suggestions']:
-                line_info = f"Line {sugg['line']}" if sugg['line'] > 0 else "General"
-                print(f"\n{line_info} - {sugg['category']}")
-                print(f"  {sugg['message']}")
-                print(f"  → {sugg['suggestion']}")
-
-        print()
-
-
-def main():
-    """CLI entry point."""
-    parser = argparse.ArgumentParser(
-        description="Analyze Dockerfile for optimization opportunities",
-        formatter_class=argparse.RawDescriptionHelpFormatter
-    )
-
-    parser.add_argument(
-        "dockerfile",
-        type=str,
-        help="Path to Dockerfile"
-    )
-
-    parser.add_argument(
-        "--json",
-        action="store_true",
-        help="Output results as JSON"
-    )
-
-    parser.add_argument(
-        "--verbose",
-        "-v",
-        action="store_true",
-        help="Enable verbose output"
-    )
-
-    args = parser.parse_args()
-
-    try:
-        analyzer = DockerfileAnalyzer(
-            dockerfile_path=args.dockerfile,
-            verbose=args.verbose
-        )
-
-        results = analyzer.analyze()
-
-        if args.json:
-            print(json.dumps(results, indent=2))
-        else:
-            analyzer.print_results(results)
-
-        # Exit with error code if issues found
-        if results['summary']['errors'] > 0:
-            sys.exit(1)
-
-    except FileNotFoundError as e:
-        print(f"Error: {e}", file=sys.stderr)
-        sys.exit(1)
-    except Exception as e:
-        print(f"Unexpected error: {e}", file=sys.stderr)
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

package/src/claude/skills/devops/scripts/requirements.txt

@@ -1,20 +0,0 @@
-# DevOps Skill Dependencies
-# Python 3.10+ required
-
-# No Python package dependencies - uses only standard library
-
-# Testing dependencies (dev)
-pytest>=8.0.0
-pytest-cov>=4.1.0
-pytest-mock>=3.12.0
-
-# Note: This skill requires various CLI tools depending on platform:
-#
-# Cloudflare:
-#   - wrangler CLI: npm install -g wrangler
-#
-# Docker:
-#   - docker CLI: https://docs.docker.com/get-docker/
-#
-# Google Cloud:
-#   - gcloud CLI: https://cloud.google.com/sdk/docs/install

package/src/claude/skills/devops/scripts/tests/requirements.txt

@@ -1,3 +0,0 @@
-pytest>=7.0.0
-pytest-cov>=4.0.0
-pytest-mock>=3.10.0