mcp-souschef 2.2.0__py3-none-any.whl → 2.5.3__py3-none-any.whl

{mcp_souschef-2.2.0.dist-info → mcp_souschef-2.5.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-souschef
-Version: 2.2.0
+Version: 2.5.3
 Summary: AI-powered MCP server for Chef to Ansible conversion
 License: MIT
 License-File: LICENSE
@@ -9,10 +9,15 @@ Requires-Python: >=3.14,<4.0
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.14
+Provides-Extra: ui
 Requires-Dist: anthropic (>=0.75.0)
 Requires-Dist: click (>=8.1.0)
 Requires-Dist: mcp (>=1.25.0)
+Requires-Dist: pandas (>=2.0.0) ; extra == "ui"
+Requires-Dist: plotly (>=5.0.0)
 Requires-Dist: python-dotenv (>=1.2.1)
+Requires-Dist: pyyaml (>=6.0.0)
+Requires-Dist: streamlit (>=1.28.0)
 Requires-Dist: zod (>=0.8.0)
 Description-Content-Type: text/markdown
 
@@ -23,7 +28,7 @@ An AI-powered MCP (Model Context Protocol) server that provides comprehensive Ch
 [![PyPI version](https://img.shields.io/pypi/v/mcp-souschef.svg)](https://pypi.org/project/mcp-souschef/)
 [![Python Version](https://img.shields.io/badge/python-3.14%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Test Coverage](https://img.shields.io/badge/coverage-92%25-brightgreen.svg)](htmlcov/index.html)
+[![Test Coverage](https://img.shields.io/badge/coverage-91%25-brightgreen.svg)](htmlcov/index.html)
 [![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
 [![Type Checked: mypy](https://img.shields.io/badge/type%20checked-mypy-blue.svg)](http://mypy-lang.org/)
 [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=kpeacocke_souschef&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=kpeacocke_souschef)
@@ -32,7 +37,17 @@ An AI-powered MCP (Model Context Protocol) server that provides comprehensive Ch
 
 ## Overview - Chef to Ansible features
 
-SousChef is a complete enterprise-grade migration platform with 38 MCP tools organized across 9 major capability areas to facilitate Chef-to-Ansible AWX/AAP migrations. From cookbook analysis to deployment pattern conversion, including Chef Habitat to containerized deployments, SousChef provides everything needed for a successful infrastructure automation migration.
+SousChef is a complete enterprise-grade migration platform with **27 primary MCP tools** organised across **9 major capability areas** to facilitate Chef-to-Ansible AWX/AAP migrations. From cookbook analysis to deployment pattern conversion, including Chef Habitat to containerised deployments and CI/CD pipeline generation, SousChef provides everything needed for a successful infrastructure automation migration.
+
+### About Tool Counts
+
+**Why 27 tools in the documentation but more in the server?**
+
+The MCP server provides **37 total tools** (35 public + 2 internal). This documentation focuses on the **27 primary user-facing tools** that cover the main migration capabilities. The remaining 10 tools are low-level filesystem operations and helper utilities used internally by the main tools.
+
+As a user, you'll primarily interact with the 27 documented tools. Your AI assistant may use the additional tools automatically when needed, but you don't need to know about them for successful migrations.
+
+> 💡 **For developers:** See `souschef/server.py` for the complete list of all 37 registered tools.
 
 ## Model Agnostic - Works with Any AI Model
 
@@ -45,10 +60,17 @@ SousChef is a complete enterprise-grade migration platform with 38 MCP tools org
 - **Local Models** (Ollama, llama.cpp, etc.)
 - **Custom Enterprise Models**
 
-**How it works:** You choose your AI model provider in your MCP client. SousChef provides the Chef/Ansible expertise through 38 specialized tools. The model calls these tools to help with your migration.
+**How it works:** You choose your AI model provider in your MCP client. SousChef provides the Chef/Ansible expertise through 27 specialized tools. The model calls these tools to help with your migration.
 
 > See [config/CONFIGURATION.md](config/CONFIGURATION.md) for configuration examples with different model providers.
 
+## Quick Links
+
+- **[Terraform Provider](terraform-provider/README.md)** - Manage migrations with infrastructure-as-code
+- **[User Guide](docs/user-guide/)** - Complete documentation
+- **[API Reference](docs/api-reference/)** - Detailed tool documentation
+- **[Migration Guide](docs/migration-guide/)** - Step-by-step migration process
+
 ## Installation
 
 ```bash
@@ -139,7 +161,67 @@ Modern deployment strategies and migration planning:
 - **generate_blue_green_deployment_playbook** - Create blue/green deployment playbooks
 - **generate_canary_deployment_strategy** - Generate canary deployment configurations
 
-### 10. Conversion Validation Framework
+### 10. CI/CD Pipeline Generation
+Generate Jenkins, GitLab CI, and GitHub Actions workflows from Chef cookbook CI patterns:
+
+- **generate_jenkinsfile_from_chef** - Generate Jenkinsfile (Declarative or Scripted) from Chef cookbook CI/CD patterns
+- **generate_gitlab_ci_from_chef** - Generate .gitlab-ci.yml from Chef cookbook testing tools
+- **generate_github_workflow_from_chef** - Generate GitHub Actions workflow from Chef cookbook CI/CD patterns
+
+Automatically detects and converts:
+- **Test Kitchen** configurations (.kitchen.yml) → Integration test stages
+- **ChefSpec** tests (spec/) → Unit test stages
+- **Cookstyle/Foodcritic** → Lint stages
+- Multiple test suites → Parallel execution strategies
+
+#### Example Usage
+
+```bash
+# Generate Jenkins Declarative pipeline
+souschef generate-jenkinsfile ./mycookbook
+
+# Generate Jenkins Scripted pipeline
+souschef generate-jenkinsfile ./mycookbook --pipeline-type scripted
+
+# Generate GitLab CI configuration
+souschef generate-gitlab-ci ./mycookbook
+
+# Generate GitHub Actions workflow
+souschef generate-github-workflow ./mycookbook
+
+# Customize with options
+souschef generate-gitlab-ci ./mycookbook --no-cache --no-artifacts
+souschef generate-github-workflow ./mycookbook --workflow-name "My CI" --no-cache
+```
+
+**MCP Tool Usage:**
+```python
+# From an AI assistant with SousChef MCP
+
+# Generate Jenkins pipeline
+generate_jenkinsfile_from_chef(
+    cookbook_path="/path/to/cookbook",
+    pipeline_type="declarative",  # or "scripted"
+    enable_parallel="yes"  # or "no"
+)
+
+# Generate GitLab CI
+generate_gitlab_ci_from_chef(
+    cookbook_path="/path/to/cookbook",
+    enable_cache="yes",  # or "no"
+    enable_artifacts="yes"  # or "no"
+)
+
+# Generate GitHub Actions workflow
+generate_github_workflow_from_chef(
+    cookbook_path="/path/to/cookbook",
+    workflow_name="Chef Cookbook CI",
+    enable_cache="yes",  # or "no"
+    enable_artifacts="yes"  # or "no"
+)
+```
+
+### 11. Conversion Validation Framework
 Comprehensive validation of Chef-to-Ansible conversions:
 
 - **validate_conversion** - Validate conversions across multiple dimensions
@@ -266,14 +348,61 @@ profile_cookbook_performance /path/to/large_cookbook
 profile_parsing_operation recipe /path/to/recipe.rb --detailed
 ```
 
-**Features:**
--  Execution time and peak memory tracking for all parsing operations
--  Detailed cProfile statistics with top function calls
--  Automatic performance recommendations based on thresholds
--  Before/after comparison for optimization validation
--  Integration with CLI and MCP for AI-assisted profiling
+### 10. Visual Migration Planning Interface
+Interactive web-based interface for Chef-to-Ansible migration planning and visualization:
+
+- **Cookbook Analysis Dashboard**: Interactive directory scanning with metadata parsing and complexity assessment
+- **Migration Planning Wizard**: Step-by-step migration planning with effort estimation and risk analysis
+- **Dependency Mapping**: Visual dependency graphs showing cookbook relationships and migration ordering
+- **Validation Reports**: Conversion validation results with syntax checking and best practice compliance
+- **Progress Tracking**: Real-time migration progress with completion metrics and bottleneck identification
+
+**Launch the UI:**
+```bash
+# Using Poetry (development)
+poetry run souschef ui
 
-## Enterprise Features
+# Using pip (installed)
+souschef ui
+
+# Custom port
+souschef ui --port 8080
+```
+
+**Features:**
+- Clean, professional design matching documentation standards
+- Real-time cookbook analysis with progress indicators
+- **Interactive dependency visualization** with Plotly graphs and NetworkX analysis
+- **Static graph visualization** with matplotlib for reports and documentation
+- **Real-time progress tracking** for all analysis operations
+- Migration planning wizards with effort estimation
+- Validation reporting dashboard with conversion quality metrics
+- Cross-platform compatibility (Linux, macOS, Windows)
+
+### Advanced UI Features
+
+#### Interactive Dependency Visualization
+The UI includes sophisticated dependency graph visualization powered by NetworkX and Plotly:
+
+- **Graph Analysis**: Automatic detection of cookbook dependencies, circular references, and migration ordering
+- **Interactive Exploration**: Zoom, pan, and hover over nodes to explore complex dependency relationships
+- **Color Coding**: Visual distinction between cookbooks, dependencies, community cookbooks, and circular dependencies
+- **Static Export**: Matplotlib-based static graphs for reports and documentation
+- **Large Graph Support**: Optimized layouts for complex cookbook ecosystems
+
+#### Real-Time Progress Tracking
+All analysis operations include comprehensive progress feedback:
+
+- **Progress Bars**: Visual progress indicators for long-running operations
+- **Status Updates**: Real-time status messages during analysis phases
+- **Operation Tracking**: Separate progress tracking for dependency analysis, validation, and migration planning
+- **Error Handling**: Graceful error display with recovery suggestions
+
+#### Enhanced User Experience
+- **Responsive Design**: Clean, professional interface that works across different screen sizes
+- **Export Options**: Download analysis results, graphs, and migration plans
+- **Session Persistence**: Maintain analysis state across page refreshes
+- **Quick Actions**: One-click access to common migration tasks
 
 ### Migration Assessment & Reporting
 - **Complexity Analysis**: Automated assessment of migration effort and risk factors
@@ -299,7 +428,7 @@ profile_parsing_operation recipe /path/to/recipe.rb --detailed
 ### Prerequisites
 - Python 3.14+
 - [Poetry](https://python-poetry.org/) for dependency management
-- MCP-compatible client (Claude Desktop, VS Code with MCP extension, etc.)
+- MCP-compatible client (Claude Desktop, VS Code 1.102+ with GitHub Copilot, etc.)
 
 ### Quick Start
 
@@ -312,9 +441,21 @@ profile_parsing_operation recipe /path/to/recipe.rb --detailed
 
    Use the pre-configured files in the `config/` directory for quick setup with Claude Desktop, VS Code Copilot, or other MCP clients.
 
+   **Claude Desktop** (macOS):
    ```bash
-   # Example: Claude Desktop (macOS)
    cp config/claude-desktop.json ~/Library/Application\ Support/Claude/claude_desktop_config.json
+   # Restart Claude Desktop
+   ```
+
+   **VS Code + GitHub Copilot** (requires VS Code 1.102+):
+   ```bash
+   # macOS/Linux
+   cp config/vscode-copilot.json ~/.config/Code/User/mcp.json
+
+   # Windows
+   copy config\vscode-copilot.json %APPDATA%\Code\User\mcp.json
+
+   # Reload VS Code window, then trust the server when prompted
    ```
 
    ** See [config/CONFIGURATION.md](config/CONFIGURATION.md) for:**
@@ -358,6 +499,7 @@ souschef-cli inspec-convert controls.rb --format testinfra
 - `inspec-parse` - Parse InSpec profiles and controls
 - `inspec-convert` - Convert InSpec to Testinfra/Ansible tests
 - `inspec-generate` - Generate InSpec validation from recipes
+- `ui` - Launch the Visual Migration Planning Interface
 - `ls` / `cat` - File system operations
 
 ### Development Setup
@@ -485,16 +627,27 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 -  Enhanced error handling with custom exceptions and actionable recovery suggestions
 -  Technical debt reduction - ALL PHASES COMPLETE: 16 functions refactored (15 C-grade eliminated, 70+ helpers extracted, average 77% complexity reduction, zero C-grade functions remaining)
 -  Performance profiling and optimization for large cookbooks (profiling module, CLI commands, MCP tools)
-
-### In Progress 🚧
--  Documentation website with MkDocs + Material theme
--  Documentation content (Getting Started, Tool Reference, Migration Guide)
+-  Code duplication elimination (InSpec functions refactored: 55 duplicate lines removed, improved architecture)
+-  Documentation website with MkDocs + Material theme (charcoal + teal colour scheme, 16 pages)
+-  Comprehensive documentation content (Getting Started, Tool Reference, Migration Guide, API docs, Examples)
+-  Integration with additional test frameworks (ServerSpec, Goss) - InSpec conversion now supports 4 output formats
+-  Jenkins/GitLab CI pipeline generation from Chef cookbook CI patterns (Test Kitchen, ChefSpec, Cookstyle)
+-  Visual migration planning interface with Streamlit-based web UI for interactive cookbook analysis and migration planning
+-  **Interactive dependency mapping and visualization** with Plotly graphs and NetworkX analysis
+-  **Real-time progress tracking** for all analysis operations with Streamlit progress bars
+-  **Static graph visualization** with matplotlib for reports and documentation
 
 ### Planned 📅
-- 📅 Integration with additional test frameworks (ServerSpec, Goss)
-- 📅 Visual migration planning and dependency mapping interface
+- 📅 Enhanced graph layout algorithms for large dependency networks (force-directed, hierarchical)
+- 📅 Export functionality for graphs (PNG, SVG, PDF formats)
+- 📅 UI configuration options and themes
+- 📅 Performance caching for expensive analysis operations
+- 📅 Mobile-responsive design improvements
+- 📅 Accessibility enhancements (ARIA labels, keyboard navigation)
+- 📅 Integration testing for UI components
+- 📅 Advanced filtering and search in dependency graphs
+- 📅 Migration templates and presets
 - 📅 Terraform provider for infrastructure state management
-- 📅 Jenkins/GitLab CI pipeline generation
 
 ## 🙋‍♀️ Support & Community
 

mcp_souschef-2.5.3.dist-info/RECORD

@@ -0,0 +1,38 @@
+souschef/__init__.py,sha256=Lkrvi2wu-OMRkdlwzxencm8QzBKc1FpK4y6SWhKqrqI,432
+souschef/assessment.py,sha256=UH9vX9GZYKXrRkavk_Gue1chT2u4Hb8fSd0jtMzwHgk,53933
+souschef/ci/__init__.py,sha256=GHaqDk4auB2kI7_fQtF2FRg5nP-iX6wJchj_uTlXcYg,411
+souschef/ci/github_actions.py,sha256=62bkuD3YCKRCK1wgyo-3l-hASyYsinZB3FOTRqWc7Ag,11215
+souschef/ci/gitlab_ci.py,sha256=jNyeeucg6TXS0l1BJHrPm_cNXe1XJEjWlaOLnQI3eZo,8373
+souschef/ci/jenkins_pipeline.py,sha256=TlwyfirlUx01TnuinFHBSZVFmnxmSEdqln_71f6lWhs,9264
+souschef/cli.py,sha256=DjVPJzzhIbbkf9l4vj68qA4aSBTetlwyiLSZeP3Ctsk,33772
+souschef/converters/__init__.py,sha256=WHBBPH60_rPX1LVieimqIYlVzeV8ttG4Q7N1dMUMBb0,681
+souschef/converters/habitat.py,sha256=4eVGAcX0576zLXW9yqYvuaRxOK2g6BOIJo_ws-PonHU,22516
+souschef/converters/playbook.py,sha256=i8HKxoJPLzw47rsq3pXreYSqte5_lBozgbTdyzMnIwA,57336
+souschef/converters/resource.py,sha256=9cuAeTxVwl7aejFxozW8nQXMvapnT1LKu77duuknZnc,9692
+souschef/core/__init__.py,sha256=80a0G6wQGfh-Z7U1gsFaeC97bM4sp_3YGil-lN02Pl0,1894
+souschef/core/constants.py,sha256=wJBKtDUpGUD02RZUT7RPclITJqkeJKe9ny6_G-qSCOw,4694
+souschef/core/errors.py,sha256=zj_LHDRxUvHmcs-nZjOWu4B_MhY5WVq2okyZOxyycCI,8605
+souschef/core/path_utils.py,sha256=zfhNDQtSgiO8nK_3-uOZuM28rn3AVuRZ81o-D9Mrt1E,1731
+souschef/core/ruby_utils.py,sha256=vUeFZBdjbFFFJlwo4fIboR23rXmbcYL2Tztt4RYhps0,1043
+souschef/core/validation.py,sha256=f37CFiJwPVaC0tN1nKlLFHIAdcZwT2CPNPnj2SHavss,17896
+souschef/deployment.py,sha256=5Ug-GS1bWXHOgPb3pzfdGJb3IZGDMl_LyGxY9vf-pDc,60332
+souschef/filesystem/__init__.py,sha256=2H7Pdeedz0MfmgpRlmii_vx61qr0jtxFndT0APPm6Qs,142
+souschef/filesystem/operations.py,sha256=OMMozBfV_o70b47KioiZ2i6HViiUQPE5mVBeKcKFepo,1654
+souschef/parsers/__init__.py,sha256=gF-vPslzs9iLxsaDzFnWDPpYFDAIwyAifjUwzYurPLg,1104
+souschef/parsers/attributes.py,sha256=JrxBYUOdE1Uu7c7mlqdjmyvZhXvuQ2VFzC19JpVUZ5U,7919
+souschef/parsers/habitat.py,sha256=CtVgLfmpo7SLp-ADyR-DXRYaRUur3bwJjlnpLyocMhc,10483
+souschef/parsers/inspec.py,sha256=zhlIDZmE6A9qws5gnrLxhGGBfHOebNTLWpZZI-XXTkU,34209
+souschef/parsers/metadata.py,sha256=laSxlsebsgTzRDM_B8eIXddeApbR4ATm-W4GAGucZpc,6324
+souschef/parsers/recipe.py,sha256=6PuslWMc0R8HlMaS8FaMKc0FtfuPfH4jVEP29QiCezQ,5941
+souschef/parsers/resource.py,sha256=EHxmojbQ7Hx5GsL5-x9mFBYk3FhGTpx-qw1uUVKQkRo,5348
+souschef/parsers/template.py,sha256=iOHMoQH7KkPzigTyyoxav8rb2ENYmfxgcvKGqvoYkgU,10532
+souschef/profiling.py,sha256=a6Pn57CZR3UPR1YIY8gfbuTPRuPkFrfIFBmctOcaZgY,17315
+souschef/server.py,sha256=J7RidGw-EuqWx7-Qm3e5IeLWaVVgq7KxAZicgJRMqAI,87252
+souschef/ui/__init__.py,sha256=U3W6X4ww7CxQVuetcocObWn5iY6lUFiNX7WoDBJeD34,195
+souschef/ui/app.py,sha256=qOBKFuoZJOzncMWKc4U4u6QdYdgU9i2LV89aLanlWjU,60325
+souschef/ui/pages/cookbook_analysis.py,sha256=VTL2dlH6AaXiSUycrzcqfCmN5xx9bJpsXK5MkrJFOGs,14014
+mcp_souschef-2.5.3.dist-info/METADATA,sha256=wqHtXXN6x9I0QO3r-cq4VeHMcU4pMCpmX1wrui85kHg,50244
+mcp_souschef-2.5.3.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+mcp_souschef-2.5.3.dist-info/entry_points.txt,sha256=NVSk61tLG4W0xEkWGOMXAVCIUyodyZCY_j3Z_0m6rkQ,80
+mcp_souschef-2.5.3.dist-info/licenses/LICENSE,sha256=t31dYSuvYYNw6trj-coWSsLK-Tg_Iyl8ObcolQcrUKM,1078
+mcp_souschef-2.5.3.dist-info/RECORD,,

mcp_souschef-2.5.3.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+souschef=souschef.cli:main
+souschef-mcp=souschef.server:main
+

souschef/assessment.py

@@ -7,6 +7,7 @@ generating migration plans, analyzing dependencies, and validating conversions.
 
 import json
 import re
+from pathlib import Path
 from typing import Any
 
 from souschef.core import METADATA_FILENAME, _normalize_path, _safe_join
@@ -36,13 +37,76 @@ def assess_chef_migration_complexity(
 
     """
     try:
-        # Validate inputs
+        # Validate and parse inputs
         error_msg = _validate_assessment_inputs(
             cookbook_paths, migration_scope, target_platform
         )
         if error_msg:
             return error_msg
 
+        # Process cookbook analysis
+        return _process_cookbook_assessment(
+            cookbook_paths, migration_scope, target_platform
+        )
+
+    except Exception as e:
+        return format_error_with_context(
+            e, "assessing Chef migration complexity", cookbook_paths
+        )
+
+
+def _process_cookbook_assessment(
+    cookbook_paths: str, migration_scope: str, target_platform: str
+) -> str:
+    """Process the cookbook assessment workflow."""
+    # Parse cookbook paths (may be empty if none exist)
+    valid_paths = _parse_cookbook_paths(cookbook_paths)
+
+    # Analyze all cookbooks (handles empty list gracefully)
+    cookbook_assessments, overall_metrics = _analyze_cookbook_metrics(valid_paths)
+
+    # Generate recommendations and reports
+    recommendations = _generate_migration_recommendations_from_assessment(
+        cookbook_assessments, overall_metrics, target_platform
+    )
+    roadmap = _create_migration_roadmap(cookbook_assessments)
+
+    # Format final assessment report
+    return _format_assessment_report(
+        migration_scope,
+        target_platform,
+        overall_metrics,
+        cookbook_assessments,
+        recommendations,
+        roadmap,
+    )
+
+
+def parse_chef_migration_assessment(
+    cookbook_paths: str,
+    migration_scope: str = "full",
+    target_platform: str = "ansible_awx",
+) -> dict[str, Any]:
+    """
+    Parse Chef cookbook migration assessment and return as dictionary.
+
+    Args:
+        cookbook_paths: Comma-separated paths to Chef cookbooks or cookbook directory
+        migration_scope: Scope of migration (full, recipes_only, infrastructure_only)
+        target_platform: Target platform (ansible_awx, ansible_core, ansible_tower)
+
+    Returns:
+        Dictionary containing assessment data with complexity, recommendations, etc.
+
+    """
+    try:
+        # Validate inputs
+        error_msg = _validate_assessment_inputs(
+            cookbook_paths, migration_scope, target_platform
+        )
+        if error_msg:
+            return {"error": error_msg}
+
         # Parse cookbook paths (may be empty if none exist)
         valid_paths = _parse_cookbook_paths(cookbook_paths)
 
@@ -55,19 +119,35 @@ def assess_chef_migration_complexity(
         )
         roadmap = _create_migration_roadmap(cookbook_assessments)
 
-        # Format final assessment report
-        return _format_assessment_report(
-            migration_scope,
-            target_platform,
-            overall_metrics,
-            cookbook_assessments,
-            recommendations,
-            roadmap,
-        )
+        return {
+            "migration_scope": migration_scope,
+            "target_platform": target_platform,
+            "overall_metrics": overall_metrics,
+            "cookbook_assessments": cookbook_assessments,
+            "recommendations": recommendations,
+            "roadmap": roadmap,
+            "complexity": _get_overall_complexity_level(overall_metrics),
+            "estimated_hours": overall_metrics.get("estimated_effort_days", 0)
+            * 8,  # Convert days to hours
+        }
+
     except Exception as e:
-        return format_error_with_context(
-            e, "assessing Chef migration complexity", cookbook_paths
-        )
+        return {
+            "error": format_error_with_context(
+                e, "assessing Chef migration complexity", cookbook_paths
+            )
+        }
+
+
+def _get_overall_complexity_level(metrics: dict[str, int]) -> str:
+    """Get overall complexity level based on metrics."""
+    avg_complexity = metrics.get("avg_complexity", 0)
+    if avg_complexity < 30:
+        return "Low"
+    elif avg_complexity < 70:
+        return "Medium"
+    else:
+        return "High"
 
 
 def _validate_migration_plan_inputs(
@@ -654,9 +734,10 @@ def _determine_migration_priority(complexity_score: int) -> str:
     return "medium"
 
 
-def _assess_single_cookbook(cookbook_path) -> dict:
+def _assess_single_cookbook(cookbook_path: Path) -> dict:
     """Assess complexity of a single cookbook."""
-    cookbook = _normalize_path(cookbook_path)
+    # cookbook_path is already normalized to a Path object
+    cookbook = cookbook_path
 
     # Collect metrics
     artifact_counts = _count_cookbook_artifacts(cookbook)
@@ -665,7 +746,9 @@ def _assess_single_cookbook(cookbook_path) -> dict:
 
     # Calculate complexity and effort
     complexity_score = _calculate_complexity_score(metrics)
-    base_effort = metrics["recipe_count"] * 0.5  # 0.5 days per recipe
+    # More realistic effort: 0.5-2 hours per recipe with AI assistance
+    # Base: 1 hour per recipe = 0.125 days (8-hour day)
+    base_effort = metrics["recipe_count"] * 0.125  # 0.125 days per recipe
     complexity_multiplier = 1 + (complexity_score / 100)
     estimated_effort = round(base_effort * complexity_multiplier, 1)
 
@@ -689,7 +772,7 @@ def _format_overall_metrics(metrics: dict) -> str:
 • Total Resources: {metrics["total_resources"]}
 • Average Complexity: {metrics.get("avg_complexity", 0):.1f}/100
 • Estimated Total Effort: {metrics["estimated_effort_days"]:.1f} person-days
-• Estimated Duration: {int(metrics["estimated_effort_days"] / 5)}-{int(metrics["estimated_effort_days"] / 3)} weeks"""
+• Estimated Duration: {max(1, int(metrics["estimated_effort_days"] / 2))}-{max(2, int(metrics["estimated_effort_days"]))} weeks (with 2-4 parallel engineers)"""
 
 
 def _format_cookbook_assessments(assessments: list) -> str:

souschef/ci/__init__.py

@@ -0,0 +1,11 @@
+"""CI/CD pipeline generation from Chef patterns."""
+
+from souschef.ci.github_actions import generate_github_workflow_from_chef_ci
+from souschef.ci.gitlab_ci import generate_gitlab_ci_from_chef_ci
+from souschef.ci.jenkins_pipeline import generate_jenkinsfile_from_chef_ci
+
+__all__ = [
+    "generate_jenkinsfile_from_chef_ci",
+    "generate_gitlab_ci_from_chef_ci",
+    "generate_github_workflow_from_chef_ci",
+]