mcp-souschef 3.2.0__tar.gz → 3.5.2__tar.gz

mcp_souschef-3.2.0/README.md → mcp_souschef-3.5.2/PKG-INFO

@@ -1,3 +1,45 @@
+Metadata-Version: 2.4
+Name: mcp-souschef
+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.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) ; extra == "ai" or extra == "all"
+Requires-Dist: click (>=8.1.0)
+Requires-Dist: mcp (>=1.25.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: 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
+Description-Content-Type: text/markdown
+
 # Chef to Ansible migration - SousChef MCP
 
 An AI-powered MCP (Model Context Protocol) server that provides comprehensive Chef-to-Ansible migration capabilities for enterprise infrastructure transformation.
@@ -5,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)
@@ -14,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
 
@@ -37,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.
 
@@ -48,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
@@ -264,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
@@ -354,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
@@ -385,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:
@@ -408,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
@@ -430,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):**
 
@@ -471,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
 
@@ -664,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
 
@@ -1034,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
@@ -1085,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
@@ -1150,3 +1314,4 @@ Questions? Check [ARCHITECTURE.md](docs/ARCHITECTURE.md) for module responsibili
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
 ---
+

mcp_souschef-3.2.0/PKG-INFO → mcp_souschef-3.5.2/README.md

@@ -1,38 +1,3 @@
-Metadata-Version: 2.4
-Name: mcp-souschef
-Version: 3.2.0
-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
-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.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System :: Systems Administration
-Classifier: Topic :: Utilities
-Provides-Extra: ui
-Requires-Dist: anthropic (>=0.75.0)
-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: python-dotenv (>=1.2.1)
-Requires-Dist: pyyaml (>=6.0.0)
-Requires-Dist: streamlit (>=1.28.0)
-Project-URL: Documentation, https://kpeacocke.github.io/souschef/
-Project-URL: Homepage, https://github.com/kpeacocke/souschef
-Project-URL: Repository, https://github.com/kpeacocke/souschef
-Description-Content-Type: text/markdown
-
 # Chef to Ansible migration - SousChef MCP
 
 An AI-powered MCP (Model Context Protocol) server that provides comprehensive Chef-to-Ansible migration capabilities for enterprise infrastructure transformation.
@@ -40,7 +5,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 +14,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 +37,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 +48,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 +286,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 +424,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 +460,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 +528,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 +551,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 +593,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 +786,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 +1156,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 +1207,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
@@ -1185,4 +1272,3 @@ Questions? Check [ARCHITECTURE.md](docs/ARCHITECTURE.md) for module responsibili
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
 ---
-