mcp-souschef 3.2.0__py3-none-any.whl → 3.5.2__py3-none-any.whl

{mcp_souschef-3.2.0.dist-info → mcp_souschef-3.5.2.dist-info}/METADATA

@@ -1,33 +1,40 @@
 Metadata-Version: 2.4
 Name: mcp-souschef
-Version: 3.2.0
+Version: 3.5.2
 Summary: AI-powered MCP server for Chef to Ansible conversion
 License: MIT
 License-File: LICENSE
 Keywords: chef,ansible,migration,infrastructure,automation,mcp,ai,conversion
 Author: SousChef Contributors
-Requires-Python: >=3.13,<4.0
+Requires-Python: >=3.10,<4.0
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Systems Administration
 Classifier: Topic :: Utilities
+Provides-Extra: ai
+Provides-Extra: all
 Provides-Extra: ui
-Requires-Dist: anthropic (>=0.75.0)
+Requires-Dist: anthropic (>=0.75.0) ; extra == "ai" or extra == "all"
 Requires-Dist: click (>=8.1.0)
 Requires-Dist: mcp (>=1.25.0)
-Requires-Dist: openai (>=1.0.0)
-Requires-Dist: pandas (>=2.0.0) ; extra == "ui"
-Requires-Dist: plotly (>=5.0.0)
+Requires-Dist: openai (>=1.0.0) ; extra == "ai" or extra == "all"
+Requires-Dist: pandas (>=2.0.0) ; extra == "ui" or extra == "all"
+Requires-Dist: plotly (>=5.17.0,<7.0) ; extra == "ui" or extra == "all"
+Requires-Dist: pydantic (>=2.0.0)
 Requires-Dist: python-dotenv (>=1.2.1)
 Requires-Dist: pyyaml (>=6.0.0)
-Requires-Dist: streamlit (>=1.28.0)
+Requires-Dist: requests (>=2.31.0)
+Requires-Dist: streamlit (>=1.28.0) ; extra == "ui" or extra == "all"
 Project-URL: Documentation, https://kpeacocke.github.io/souschef/
 Project-URL: Homepage, https://github.com/kpeacocke/souschef
 Project-URL: Repository, https://github.com/kpeacocke/souschef
@@ -40,7 +47,7 @@ An AI-powered MCP (Model Context Protocol) server that provides comprehensive Ch
 [![GitHub release](https://img.shields.io/github/v/release/kpeacocke/souschef)](https://github.com/kpeacocke/souschef/releases)
 [![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-91%25-brightgreen.svg)](htmlcov/index.html)
+[![Test Coverage](https://img.shields.io/badge/coverage-83%25-green.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)
@@ -49,17 +56,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 **32 primary MCP tools** organised across **10 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.
+SousChef is a complete enterprise-grade migration platform with **35 primary MCP tools** organised across **11 major capability areas** to facilitate Chef-to-Ansible AWX/AAP migrations. From cookbook analysis to deployment pattern conversion, including Chef Habitat to containerised deployments, Chef Server integration, and CI/CD pipeline generation, SousChef provides everything needed for a successful infrastructure automation migration.
 
 ### About Tool Counts
 
-**Why 32 tools in the documentation but more in the server?**
+**Why 35 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 **32 primary user-facing tools** that cover the main migration capabilities. The remaining 3 tools are low-level filesystem operations and helper utilities used internally by the main tools.
+The MCP server provides **38 total tools**. This documentation focuses on the **35 primary user-facing tools** that cover the main migration capabilities. The remaining 3 tools are low-level filesystem operations 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.
+As a user, you'll primarily interact with the 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.
+> **For developers:** See `souschef/server.py` for the complete list of all 38 registered tools.
 
 ## Model Agnostic - Works with Any AI Model
 
@@ -72,7 +79,7 @@ As a user, you'll primarily interact with the 27 documented tools. Your AI assis
 - **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 27 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 35 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.
 
@@ -83,6 +90,28 @@ As a user, you'll primarily interact with the 27 documented tools. Your AI assis
 - **[API Reference](docs/api-reference/)** - Detailed tool documentation
 - **[Migration Guide](docs/migration-guide/)** - Step-by-step migration process
 
+## What's New in v3.4.0-beta
+
+**Chef Server Integration & AI-Enhanced Template Conversion** - New tools for dynamic inventory and intelligent template conversion:
+
+- **Chef Server Connectivity**: Validate Chef Server connections and query nodes with `validate_chef_server_connection` and `get_chef_nodes`
+- **AI-Enhanced Templates**: Convert ERB to Jinja2 with AI validation using `convert_template_with_ai` for complex Ruby logic
+- **CLI Commands**: New commands `validate-chef-server`, `query-chef-nodes`, and `convert-template-ai` for command-line access
+- **Streamlit UI**: Chef Server Settings page for managing server configuration and validation
+
+## What's New in v3.3.0
+
+**AI-Assisted Effort Estimation** - SousChef now displays realistic migration effort comparisons directly in the Streamlit UI:
+
+- **Manual Migration Estimates**: Full effort without AI assistance
+- **SousChef-Assisted Estimates**: 50% time reduction through automated boilerplate conversion
+- **Time Savings Display**: Instant visual comparison showing hours saved and efficiency gains
+- **Interactive Metrics**: Summary and per-cookbook effort comparisons with clear deltas
+
+Example: A cookbook estimated at 40 hours of manual work shows SousChef-assisted time as 20 hours, saving 20 hours (50%) and reducing team needs from 2 developers to 1.
+
+See the [Assessment Guide](docs/migration-guide/assessment.md#effort-estimation-model) for details on the effort estimation model.
+
 ## Installation
 
 ```bash
@@ -299,6 +328,54 @@ Output formats:
 - **analyse_cookbook_dependencies** - Analyse dependencies and migration order
 - **generate_migration_report** - Generate executive and technical migration reports
 
+### 12. Chef Server Integration & Dynamic Inventory
+
+Dynamic inventory generation and Chef Server connectivity for hybrid environments:
+
+- **validate_chef_server_connection** - Test Chef Server REST API connectivity and authentication
+- **get_chef_nodes** - Query Chef Server for nodes matching search criteria, extracting roles, environment, platform, and IP information
+- **convert_template_with_ai** - Convert ERB templates to Jinja2 with AI-based validation for complex Ruby logic
+
+#### Chef Server Features
+
+- **Connection Validation**: Test Chef Server connectivity before migrations
+- **Dynamic Node Queries**: Search Chef Server by role, environment, or custom attributes
+- **Node Metadata Extraction**: Retrieve IP addresses, FQDNs, platforms, and roles for inventory
+- **AI-Enhanced Conversion**: Intelligent ERB→Jinja2 conversion with validation for complex Ruby constructs
+- **Fallback Handling**: Graceful degradation when Chef Server is unavailable
+
+#### Usage Examples
+
+```bash
+# Validate Chef Server connection
+souschef validate-chef-server --server-url https://chef.example.com --node-name admin
+
+# Query Chef Server for nodes
+souschef query-chef-nodes --search-query "role:web_server" --json
+
+# Convert template with AI assistance
+souschef convert-template-ai /path/to/template.erb --ai --output /path/to/output.j2
+```
+
+#### MCP Tool Usage
+
+```python
+# Validate Chef Server from AI assistant
+validate_chef_server_connection(
+    server_url="https://chef.example.com",
+    node_name="admin"
+)
+
+# Query nodes for dynamic inventory
+get_chef_nodes(search_query="role:web_server AND environment:production")
+
+# Convert template with AI validation
+convert_template_with_ai(
+    erb_path="/path/to/template.erb",
+    use_ai_enhancement=True
+)
+```
+
 ## Migration Workflow
 
 ### Phase 1: Discovery & Assessment
@@ -389,7 +466,12 @@ profile_parsing_operation recipe /path/to/recipe.rb --detailed
 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
+- **AI-Assisted Effort Estimation** (v3.3.0+):
+  - **Manual Migration Estimate**: Full effort without AI assistance
+  - **SousChef-Assisted Estimate**: 50% time reduction through automated boilerplate conversion
+  - **Time Savings Display**: Clear comparison showing hours saved and efficiency percentage
+  - **Visual Metrics**: Side-by-side metric cards for instant visual comparison
+- **Migration Planning Wizard**: Step-by-step migration planning with dual effort scenarios 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
@@ -420,6 +502,51 @@ docker run -p 9999:9999 souschef-ui
 docker-compose up
 ```
 
+**Run Published Image from GitHub Container Registry:**
+
+SousChef images are automatically published to GitHub Container Registry (GHCR) on each release:
+
+```bash
+# Pull the latest released image
+docker pull ghcr.io/mcp-souschef:latest
+
+# Or pull a specific version
+docker pull ghcr.io/mcp-souschef:3.2.0
+
+# Run the image with your .env file
+docker run -p 9999:9999 \
+  --env-file .env \
+  ghcr.io/mcp-souschef:latest
+
+# Or with docker-compose
+cat > docker-compose.override.yml << 'EOF'
+version: '3.8'
+services:
+  souschef-ui:
+    image: ghcr.io/mcp-souschef:latest
+    build: ~
+EOF
+docker-compose up
+```
+
+**Container Images:**
+
+- **Registry**: GitHub Container Registry (GHCR)
+- **Image Name**: `mcp-souschef`
+- **Full URL**: `ghcr.io/mcp-souschef`
+- **Available Tags**:
+  - `latest` - Most recent release
+  - `3.2.0` - Specific version (semver)
+  - `3.2` - Latest patch of a minor version
+  - `3` - Latest patch of a major version
+
+**Why use GHCR?**
+
+- Integrated with GitHub releases and CI/CD
+- Faster pulls for users in GitHub ecosystem
+- Security scanning and SBOM included
+- Multi-platform support (amd64, arm64)
+
 **Docker Environment Configuration:**
 
 SousChef supports AI configuration via environment variables in Docker containers. Create a `.env` file in your project root:
@@ -443,6 +570,7 @@ SOUSCHEF_AI_BASE_URL=
 SOUSCHEF_AI_PROJECT_ID=
 SOUSCHEF_AI_TEMPERATURE=0.7
 SOUSCHEF_AI_MAX_TOKENS=4000
+SOUSCHEF_ALLOWED_HOSTNAMES=api.example.com,*.example.org
 
 # Streamlit Configuration (optional)
 STREAMLIT_SERVER_PORT=9999
@@ -465,6 +593,7 @@ STREAMLIT_SERVER_HEADLESS=true
 - `SOUSCHEF_AI_PROJECT_ID` - Project ID for Watsonx (optional)
 - `SOUSCHEF_AI_TEMPERATURE` - Model temperature 0.0-2.0 (optional, default: 0.7)
 - `SOUSCHEF_AI_MAX_TOKENS` - Maximum tokens to generate (optional, default: 4000)
+- `SOUSCHEF_ALLOWED_HOSTNAMES` - Comma-separated list of allowed hostnames for outbound API requests (optional)
 
 **Docker Compose (recommended for development):**
 
@@ -506,7 +635,7 @@ The UI includes sophisticated dependency graph visualization powered by NetworkX
 - **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
+- **Large Graph Support**: Optimised layouts for complex cookbook ecosystems
 
 #### Real-Time Progress Tracking
 
@@ -699,7 +828,7 @@ Following enterprise-grade testing standards with comprehensive test coverage:
 - **Specialized Tests**: Enhanced guards (test_enhanced_guards.py), error handling (test_error_paths.py, test_error_recovery.py), real-world fixtures (test_real_world_fixtures.py)
 - **Performance Tests**: Benchmarking and optimization validation (test_performance.py)
 - **Snapshot Tests**: Regression testing for output stability (test_snapshots.py)
-- **92% Coverage**: Comprehensive test coverage exceeding the 90% target for production readiness
+- **83% Coverage**: Comprehensive test coverage approaching the 90% target for production readiness
 
 ### Quality Assurance
 
@@ -1069,18 +1198,18 @@ poetry run pytest
 poetry run pytest --cov=souschef --cov-report=term-missing --cov-report=html
 
 # Run specific test suites
-poetry run pytest tests/test_server.py              # Core unit tests
-poetry run pytest tests/test_cli.py                 # CLI tests
-poetry run pytest tests/test_mcp.py                 # MCP protocol tests
-poetry run pytest tests/test_integration.py         # Integration tests
-poetry run pytest tests/test_integration_accuracy.py # Accuracy validation
-poetry run pytest tests/test_enhanced_guards.py     # Guard conversion tests
-poetry run pytest tests/test_error_paths.py         # Error handling
-poetry run pytest tests/test_error_recovery.py      # Error recovery
-poetry run pytest tests/test_real_world_fixtures.py # Real-world cookbooks
-poetry run pytest tests/test_property_based.py      # Hypothesis fuzz tests
-poetry run pytest tests/test_performance.py         # Performance benchmarks
-poetry run pytest tests/test_snapshots.py           # Snapshot regression tests
+poetry run pytest tests/unit/test_server.py              # Core unit tests
+poetry run pytest tests/unit/test_cli.py                 # CLI tests
+poetry run pytest tests/e2e/test_mcp.py                  # MCP protocol tests
+poetry run pytest tests/integration/test_integration.py         # Integration tests
+poetry run pytest tests/integration/test_integration_accuracy.py # Accuracy validation
+poetry run pytest tests/unit/test_enhanced_guards.py     # Guard conversion tests
+poetry run pytest tests/unit/test_error_paths.py         # Error handling
+poetry run pytest tests/unit/test_error_recovery.py      # Error recovery
+poetry run pytest tests/integration/test_real_world_fixtures.py # Real-world cookbooks
+poetry run pytest tests/unit/test_property_based.py      # Hypothesis fuzz tests
+poetry run pytest tests/integration/test_performance.py         # Performance benchmarks
+poetry run pytest tests/unit/test_snapshots.py           # Snapshot regression tests
 
 # Run with benchmarks
 poetry run pytest --benchmark-only
@@ -1120,7 +1249,7 @@ The project includes comprehensive test coverage across multiple dimensions:
    - **Snapshots** (`test_snapshots.py`): Regression testing for output stability
 
 5. **Test Fixtures**
-   - Sample Chef cookbooks in `tests/fixtures/`
+  - Sample Chef cookbooks in `tests/integration/fixtures/`
    - Multiple cookbook types: apache2, docker, mysql, nodejs, legacy Chef 12, Habitat plans
    - Real-world metadata, recipes, attributes, and resources
    - Used across integration and accuracy testing

{mcp_souschef-3.2.0.dist-info → mcp_souschef-3.5.2.dist-info}/RECORD

@@ -1,23 +1,27 @@
 souschef/__init__.py,sha256=EqHUtFUSPV2fOQO3lhmyhMPfX7cUso88I6rEjvG8PRA,1434
-souschef/assessment.py,sha256=zsgdnMvaHDN-3FSJ3W8q7a1lsDFS0qqklUg4G0n5IOs,98094
+souschef/assessment.py,sha256=g_fxMjek_n5LgLlkZz_yWIADS9A3Z3qhFGGOz7lqm6M,100982
 souschef/ci/__init__.py,sha256=GHaqDk4auB2kI7_fQtF2FRg5nP-iX6wJchj_uTlXcYg,411
 souschef/ci/common.py,sha256=vHX1wtDNaTPiPfwW9If3aBm1hRmnTto2r3MkZGwYPTM,4757
 souschef/ci/github_actions.py,sha256=EVnnOPTLCeUmTfR-acpLp-c_dxapMfrrDWaK4SSBkdM,7818
 souschef/ci/gitlab_ci.py,sha256=4FcK8edci3ixuiUtYb6EFaAfsqjz0OBmW-lyPLH3YzY,6708
 souschef/ci/jenkins_pipeline.py,sha256=XEuZrVKVmOlQOKucgGcd3vhAFh5qT05ILNnjKjkqTPU,7362
-souschef/cli.py,sha256=8kxVkvg9eFOWIII29p9sQm9u2Z6kfhmdJThBlpxTdrA,38159
+souschef/cli.py,sha256=O26NaN3HR6qfWDfWETkwQNqaIeWZh2VWNKATVoZBn1w,47702
 souschef/converters/__init__.py,sha256=kkPm758XiFDdUYvdVPAVjssFvf15LasJcob1EY1EMIs,681
 souschef/converters/cookbook_specific.py,sha256=ZvE9-bZtyXuf2E3HW4E9_GWzAqtm7e4YHj9qm1Xu_XI,3767
 souschef/converters/habitat.py,sha256=4eVGAcX0576zLXW9yqYvuaRxOK2g6BOIJo_ws-PonHU,22516
-souschef/converters/playbook.py,sha256=dyeAzcCyWcBUc6o9IcBTB4N4XVIX4cImNFsNe2TXTSU,94395
+souschef/converters/playbook.py,sha256=F_6tSFyrlT55vLdi632g7Yd5rkNRPlq4pnb5HSMrs78,102773
 souschef/converters/resource.py,sha256=NYMcp1-obg_ad_XPuYDuUH_0j65agRbAeWzXPfbSi5c,13570
-souschef/converters/template.py,sha256=swX7LpWrKZgFtg6MaR7rltShBkPDbQAb65d1NF_nILo,5447
+souschef/converters/template.py,sha256=sXMLm2egA2dSOY-SLoKjXOYH1dHK_ozj67YC89sg8dc,9268
 souschef/core/__init__.py,sha256=PXiZSEfXw77te3SvMRKy0_g0CwQqworbgFLca89u7wA,1969
+souschef/core/ai_schemas.py,sha256=TJCLsZ_3l8ub2zcVuSE0h6usMqxnrce8o3n2fxAKjvM,2860
 souschef/core/constants.py,sha256=AyIpc9cJjQEDc1yOcoKc_2-cJB4PekSpPKEK2S9jDl8,5122
 souschef/core/errors.py,sha256=zj_LHDRxUvHmcs-nZjOWu4B_MhY5WVq2okyZOxyycCI,8605
-souschef/core/metrics.py,sha256=k56opuVmRorrBwErbxLgXu_GkfGZXA_rEfhcsHs1JHI,9850
+souschef/core/http_client.py,sha256=f7laiNsIAX95-fVyAfnQXUdOL-Cv7ZWxi5xLnmTAkF4,12873
+souschef/core/logging.py,sha256=3X6u6JUI5reIa7p1I4T22O69ME2ALrOxC8xacA6MKO0,9974
+souschef/core/metrics.py,sha256=NuZNKi2o6UcrsJ52s8QQAoDeUiEi0HClZHNfPXsVRo4,12797
 souschef/core/path_utils.py,sha256=eU5lNujUX45MbMahstm4C0gJxKN14QIKaxmgD6O5l9U,8993
 souschef/core/ruby_utils.py,sha256=vUeFZBdjbFFFJlwo4fIboR23rXmbcYL2Tztt4RYhps0,1043
+souschef/core/url_validation.py,sha256=AeUKNVN_AWBxkp5b5QskRgQ-4IB--A-D60ltRbN_chI,6169
 souschef/core/validation.py,sha256=DXfkm1p5prSAJ-Oruk5JekNiDFI49Dql1bGEzKymYXs,19158
 souschef/deployment.py,sha256=UKxq9G06b7de_5ioA7RdxdjwQaW2mJKf6WlNl0Sq5wk,62193
 souschef/filesystem/__init__.py,sha256=2H7Pdeedz0MfmgpRlmii_vx61qr0jtxFndT0APPm6Qs,142
@@ -33,15 +37,16 @@ souschef/parsers/recipe.py,sha256=PNGQKVv0wwqj_q8WYT2NjsSavLA9WXdo2C9bp6pY9qc,71
 souschef/parsers/resource.py,sha256=WcKsUjP3yZx2-2nsTUTLPxIxtfwEihHVNkv3OC6bBHs,5359
 souschef/parsers/template.py,sha256=v51BMUHmr9FYwE7zDNFA01dsClWHLrc_YD3rCM-2lqc,10543
 souschef/profiling.py,sha256=a6Pn57CZR3UPR1YIY8gfbuTPRuPkFrfIFBmctOcaZgY,17315
-souschef/server.py,sha256=jtNiPX9uWP5KoRCZj0nasBlxPooAy5AHKcW-HO0YWU4,122047
+souschef/server.py,sha256=Mzf8hnoGd83C46fO99mCw_4dHS7KttXfOmlVn7MJQ9c,125886
 souschef/ui/__init__.py,sha256=U3W6X4ww7CxQVuetcocObWn5iY6lUFiNX7WoDBJeD34,195
-souschef/ui/app.py,sha256=0lFphbMTL21H_CpT9rO2tITj48b4_zK8YZqW2_sm8TU,101744
+souschef/ui/app.py,sha256=ru1KDYqnEDQvq46HHLNu1JGwzIScr7Lm11BeqnXpvQs,102343
 souschef/ui/health_check.py,sha256=mEzec8L6XPRekOBAXngqQz5dnzal-a4p3D70mkPriiA,903
-souschef/ui/pages/ai_settings.py,sha256=tIwgWBqxCEqFykmrLRPiVQjl-m-I1Mbq0RoB1YA5faM,17774
-souschef/ui/pages/cookbook_analysis.py,sha256=qcCYtnk01XGD14wbQe5EzT3Fx_ETkIjMhz8r3ZOXwm8,146148
+souschef/ui/pages/ai_settings.py,sha256=AevsSuiRcfYuQqtYcu1ijp8x3G3PYAUBXzxLmSSVp2c,22105
+souschef/ui/pages/chef_server_settings.py,sha256=_ch7qvZ02luwNRFqWN6ATMbVUuenYlrbCpRGEFjr-40,8585
+souschef/ui/pages/cookbook_analysis.py,sha256=ilAQTzFQyJsH6Mk65jjQbk5LKIsBkj9XibF4q648tpg,148623
 souschef/ui/pages/validation_reports.py,sha256=R3xHTJb_y2b0tI8N0qPF1oS4f9ZVb539_82dj5nmmxA,7593
-mcp_souschef-3.2.0.dist-info/METADATA,sha256=8yGaW_bXIxvKHzwS7x_gBMXqH850qif_HuTyq2nnDVY,41878
-mcp_souschef-3.2.0.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
-mcp_souschef-3.2.0.dist-info/entry_points.txt,sha256=NVSk61tLG4W0xEkWGOMXAVCIUyodyZCY_j3Z_0m6rkQ,80
-mcp_souschef-3.2.0.dist-info/licenses/LICENSE,sha256=t31dYSuvYYNw6trj-coWSsLK-Tg_Iyl8ObcolQcrUKM,1078
-mcp_souschef-3.2.0.dist-info/RECORD,,
+mcp_souschef-3.5.2.dist-info/METADATA,sha256=ih95vf1qxSdw0VKL_wkka3Sx3aj8SoxB1SgGbhVPBAM,47268
+mcp_souschef-3.5.2.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+mcp_souschef-3.5.2.dist-info/entry_points.txt,sha256=NVSk61tLG4W0xEkWGOMXAVCIUyodyZCY_j3Z_0m6rkQ,80
+mcp_souschef-3.5.2.dist-info/licenses/LICENSE,sha256=t31dYSuvYYNw6trj-coWSsLK-Tg_Iyl8ObcolQcrUKM,1078
+mcp_souschef-3.5.2.dist-info/RECORD,,

{mcp_souschef-3.2.0.dist-info → mcp_souschef-3.5.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.3.0
+Generator: poetry-core 2.3.1
 Root-Is-Purelib: true
 Tag: py3-none-any

souschef/assessment.py

@@ -25,6 +25,7 @@ from souschef.core.metrics import (
     estimate_effort_for_complexity,
 )
 from souschef.core.path_utils import _validated_candidate, safe_glob
+from souschef.core.url_validation import validate_user_provided_url
 from souschef.core.validation import (
     ValidationEngine,
     ValidationLevel,
@@ -34,9 +35,9 @@ from souschef.core.validation import (
 
 # Optional AI provider imports
 try:
-    import requests  # type: ignore[import-untyped]
+    import requests
 except ImportError:
-    requests = None
+    requests = None  # type: ignore[assignment]
 
 try:
     from ibm_watsonx_ai import APIClient  # type: ignore[import-not-found]
@@ -1200,17 +1201,28 @@ def _assess_single_cookbook(cookbook_path: Path) -> dict:
 
 
 def _format_overall_metrics(metrics: dict) -> str:
-    """Format overall migration metrics."""
+    """Format overall migration metrics with manual and SousChef-assisted estimates."""
+    effort_metrics = EffortMetrics(metrics["estimated_effort_days"])
+
     return f"""• Total Cookbooks: {metrics["total_cookbooks"]}
 • Total Recipes: {metrics["total_recipes"]}
 • 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: {EffortMetrics(metrics["estimated_effort_days"]).estimated_weeks_range}"""
+
+## Manual Migration Effort (Without SousChef):
+• Estimated Effort: {metrics["estimated_effort_days"]:.1f} person-days ({effort_metrics.estimated_hours:.0f} hours)
+• Estimated Duration: {effort_metrics.estimated_weeks_range}
+• Team Required: {max(2, int(metrics["estimated_effort_days"] / 15))} developers
+
+## AI-Assisted Migration (With SousChef):
+• Estimated Effort: {effort_metrics.estimated_days_with_souschef:.1f} person-days ({effort_metrics.estimated_hours_with_souschef:.0f} hours)
+• Estimated Duration: {effort_metrics.estimated_weeks_range_with_souschef}
+• Team Required: {max(1, int(effort_metrics.estimated_days_with_souschef / 15))} developers
+• **Time Saved: {effort_metrics.time_saved:.1f} days ({effort_metrics.efficiency_gain_percent}% faster)**"""
 
 
 def _format_cookbook_assessments(assessments: list) -> str:
-    """Format individual cookbook assessments."""
+    """Format individual cookbook assessments with manual and AI-assisted estimates."""
     if not assessments:
         return "No cookbooks assessed."
 
@@ -1226,13 +1238,14 @@ def _format_cookbook_assessments(assessments: list) -> str:
     formatted = []
     for assessment in assessments:
         priority_icon = _get_priority_icon(assessment["migration_priority"])
+        effort_metrics = EffortMetrics(assessment["estimated_effort_days"])
+
         formatted.append(f"""### {assessment["cookbook_name"]} {priority_icon}
 • Complexity Score: {assessment["complexity_score"]:.1f}/100
-• Estimated Effort: {assessment["estimated_effort_days"]} days
-• Recipes: {assessment["metrics"]["recipe_count"]}
-• Resources: {assessment["metrics"]["resource_count"]}
-• Custom Resources: {assessment["metrics"]["custom_resources"]}
-• Challenges: {len(assessment["challenges"])}""")
+• Recipes: {assessment["metrics"]["recipe_count"]} | Resources: {assessment["metrics"]["resource_count"]} | Custom Resources: {assessment["metrics"]["custom_resources"]}
+• Manual Effort: {assessment["estimated_effort_days"]:.1f} days ({effort_metrics.estimated_weeks_range})
+• With SousChef: {effort_metrics.estimated_days_with_souschef:.1f} days ({effort_metrics.estimated_weeks_range_with_souschef}) - Save {effort_metrics.time_saved:.1f} days
+• Migration Challenges: {len(assessment["challenges"])}""")
 
     return "\n\n".join(formatted)
 
@@ -1445,26 +1458,56 @@ def _assess_migration_risks(assessments: list, target_platform: str) -> str:
 
 
 def _estimate_resource_requirements(metrics: dict, target_platform: str) -> str:
-    """Estimate resource requirements for migration."""
+    """Estimate resource requirements for migration with and without SousChef."""
     total_effort = metrics["estimated_effort_days"]
+    effort_metrics = EffortMetrics(total_effort)
 
-    # Team size recommendations
+    # Manual migration requirements
     if total_effort < 20:
-        team_size = "1 developer + 1 reviewer"
-        timeline = "4-6 weeks"
+        manual_team = "1 developer + 1 reviewer"
+        manual_timeline = "4-6 weeks"
     elif total_effort < 50:
-        team_size = "2 developers + 1 senior reviewer"
-        timeline = "6-10 weeks"
+        manual_team = "2 developers + 1 senior reviewer"
+        manual_timeline = "6-10 weeks"
+    else:
+        manual_team = "3-4 developers + 1 tech lead + 1 architect"
+        manual_timeline = "10-16 weeks"
+
+    # SousChef-assisted requirements
+    souschef_effort = effort_metrics.estimated_days_with_souschef
+    if souschef_effort < 20:
+        souschef_team = "1 developer (with SousChef AI assistance)"
+        souschef_timeline = "2-3 weeks"
+    elif souschef_effort < 50:
+        souschef_team = "1-2 developers + 1 reviewer (with SousChef)"
+        souschef_timeline = "3-5 weeks"
     else:
-        team_size = "3-4 developers + 1 tech lead + 1 architect"
-        timeline = "10-16 weeks"
+        souschef_team = "2-3 developers + 1 tech lead (with SousChef)"
+        souschef_timeline = "5-8 weeks"
 
-    return f"""• **Team Size:** {team_size}
-• **Estimated Timeline:** {timeline}
-• **Total Effort:** {total_effort:.1f} person-days
+    return f"""## Manual Migration (Without AI Assistance):
+• **Team Size:** {manual_team}
+• **Estimated Timeline:** {manual_timeline}
+• **Total Effort:** {total_effort:.1f} person-days ({effort_metrics.estimated_hours:.0f} hours)
+• **Infrastructure:** {target_platform.replace("_", "/").upper()} environment
+• **Testing:** Dedicated test environment required
+• **Training:** 3-5 days Ansible/AWX training for team
+
+## AI-Assisted Migration (With SousChef):
+• **Team Size:** {souschef_team}
+• **Estimated Timeline:** {souschef_timeline}
+• **Total Effort:** {souschef_effort:.1f} person-days ({effort_metrics.estimated_hours_with_souschef:.0f} hours)
+• **Time Savings:** {effort_metrics.time_saved:.1f} days ({effort_metrics.efficiency_gain_percent}% reduction)
 • **Infrastructure:** {target_platform.replace("_", "/").upper()} environment
-• **Testing:** Dedicated test environment recommended
-• **Training:** 2-3 days Ansible/AWX training for team"""
+• **Testing:** Automated validation + human review
+• **Training:** 1-2 days SousChef usage + Ansible basics
+
+**SousChef Benefits:**
+• Automated boilerplate conversion (60-70% of work)
+• Built-in best practices validation
+• Faster iteration cycles
+• Consistent output quality
+• Reduced human error"""
 
 
 def _analyse_cookbook_dependencies_detailed(cookbook_path: Path | str) -> dict:
@@ -2554,8 +2597,21 @@ def _call_ai_api(
         elif ai_provider == "openai":
             return _call_openai_api(prompt, api_key, model, temperature, max_tokens)
         elif ai_provider == "watson":
+            validated_url = None
+            if base_url:
+                try:
+                    validated_url = validate_user_provided_url(base_url)
+                except ValueError:
+                    return None
+
             return _call_watson_api(
-                prompt, api_key, model, temperature, max_tokens, project_id, base_url
+                prompt,
+                api_key,
+                model,
+                temperature,
+                max_tokens,
+                project_id,
+                validated_url,
             )
         else:
             return None