mcp-souschef 2.5.3__tar.gz → 3.0.0__tar.gz

mcp_souschef-2.5.3/README.md → mcp_souschef-3.0.0/PKG-INFO

@@ -1,8 +1,44 @@
+Metadata-Version: 2.4
+Name: mcp-souschef
+Version: 3.0.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)
+Requires-Dist: zod (>=0.8.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.
 
-[![PyPI version](https://img.shields.io/pypi/v/mcp-souschef.svg)](https://pypi.org/project/mcp-souschef/)
+[![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)
@@ -14,17 +50,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 **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.
+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.
 
 ### About Tool Counts
 
-**Why 27 tools in the documentation but more in the server?**
+**Why 32 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.
+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.
 
 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.
+> **For developers:** See `souschef/server.py` for the complete list of all 37 registered tools.
 
 ## Model Agnostic - Works with Any AI Model
 
@@ -72,7 +108,7 @@ Complete cookbook introspection and analysis tools:
 - **list_directory** - Navigate and explore cookbook directory structures
 - **read_file** - Read cookbook files with error handling
 - **read_cookbook_metadata** - Parse metadata.rb files for dependencies and cookbook information
-- **parse_recipe** - Analyze Chef recipes and extract resources, actions, and properties
+- **parse_recipe** - Analyse Chef recipes and extract resources, actions, and properties
 - **parse_attributes** - Parse attribute files with **advanced precedence resolution** (6 levels: default, force_default, normal, override, force_override, automatic)
 - **list_cookbook_structure** - Display complete cookbook directory hierarchy
 
@@ -93,7 +129,7 @@ Convert Chef search patterns to dynamic Ansible inventory:
 
 - **convert_chef_search_to_inventory** - Transform Chef search queries to Ansible inventory groups
 - **generate_dynamic_inventory_script** - Create dynamic inventory scripts from Chef server queries
-- **analyze_chef_search_patterns** - Discover and analyze search usage in cookbooks
+- **analyse_chef_search_patterns** - Discover and analyse search usage in cookbooks
 
 ### 4. InSpec Integration & Validation
 Complete InSpec-to-Ansible testing pipeline:
@@ -107,14 +143,14 @@ Chef data bags to Ansible vars/vault conversion:
 
 - **convert_chef_databag_to_vars** - Transform data bags to Ansible variable files
 - **generate_ansible_vault_from_databags** - Convert encrypted data bags to Ansible Vault
-- **analyze_chef_databag_usage** - Analyze data bag usage patterns in cookbooks
+- **analyse_chef_databag_usage** - Analyse data bag usage patterns in cookbooks
 
 ### 6. Environment & Configuration Management
 Chef environments to Ansible inventory groups:
 
 - **convert_chef_environment_to_inventory_group** - Transform Chef environments to inventory
 - **generate_inventory_from_chef_environments** - Generate complete inventory from environments
-- **analyze_chef_environment_usage** - Analyze environment usage in cookbooks
+- **analyse_chef_environment_usage** - Analyse environment usage in cookbooks
 
 ### 7. AWX/Ansible Automation Platform Integration
 Enterprise AWX/AAP configuration generation:
@@ -240,10 +276,10 @@ Output formats:
 - **json**: Structured JSON for programmatic processing
 - **summary**: Quick overview with counts only
 
-- **analyze_chef_application_patterns** - Identify application deployment patterns
+- **analyse_chef_application_patterns** - Identify application deployment patterns
 - **assess_chef_migration_complexity** - Comprehensive migration complexity assessment
 - **generate_migration_plan** - Create detailed migration execution plans
-- **analyze_cookbook_dependencies** - Analyze dependencies and migration order
+- **analyse_cookbook_dependencies** - Analyse dependencies and migration order
 - **generate_migration_report** - Generate executive and technical migration reports
 
 ## Migration Workflow
@@ -253,8 +289,8 @@ Output formats:
 # Assess migration complexity
 assess_chef_migration_complexity /path/to/cookbooks
 
-# Analyze cookbook dependencies
-analyze_cookbook_dependencies /path/to/cookbook
+# Analyse cookbook dependencies
+analyse_cookbook_dependencies /path/to/cookbook
 
 # Generate migration plan
 generate_migration_plan '{\"cookbooks\": [\"/path/to/cookbook1\", \"/path/to/cookbook2\"]}'
@@ -346,6 +382,79 @@ souschef ui
 souschef ui --port 8080
 ```
 
+**Run in Docker:**
+```bash
+# Build the image
+docker build -t souschef-ui .
+
+# Run the container
+docker run -p 9999:9999 souschef-ui
+
+# Or use docker-compose
+docker-compose up
+```
+
+**Docker Environment Configuration:**
+
+SousChef supports AI configuration via environment variables in Docker containers. Create a `.env` file in your project root:
+
+```bash
+# Copy the example environment file
+cp .env.example .env
+
+# Edit with your AI provider settings
+nano .env
+```
+
+**Example .env file:**
+```dotenv
+# AI Configuration
+SOUSCHEF_AI_PROVIDER=Anthropic (Claude)
+SOUSCHEF_AI_MODEL=claude-3-5-sonnet-20241022
+SOUSCHEF_AI_API_KEY=your-api-key-here
+SOUSCHEF_AI_BASE_URL=
+SOUSCHEF_AI_PROJECT_ID=
+SOUSCHEF_AI_TEMPERATURE=0.7
+SOUSCHEF_AI_MAX_TOKENS=4000
+
+# Streamlit Configuration (optional)
+STREAMLIT_SERVER_PORT=9999
+STREAMLIT_SERVER_HEADLESS=true
+```
+
+**Supported AI Providers:**
+- `Anthropic (Claude)` - Anthropic Claude models
+- `OpenAI (GPT)` - OpenAI GPT models
+- `IBM Watsonx` - IBM Watsonx AI models
+- `Red Hat Lightspeed` - Red Hat Lightspeed models
+
+**Environment Variables:**
+- `SOUSCHEF_AI_PROVIDER` - AI provider name (required)
+- `SOUSCHEF_AI_MODEL` - Model name (required)
+- `SOUSCHEF_AI_API_KEY` - API key for authentication (required)
+- `SOUSCHEF_AI_BASE_URL` - Custom API base URL (optional)
+- `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)
+
+**Docker Compose (recommended for development):**
+```yaml
+version: '3.8'
+services:
+  souschef-ui:
+    build: .
+    ports:
+      - "9999:9999"
+    env_file:
+      - .env
+    environment:
+      - PYTHONPATH=/app
+      - STREAMLIT_SERVER_ADDRESS=0.0.0.0
+      - STREAMLIT_SERVER_PORT=9999
+      - STREAMLIT_SERVER_HEADLESS=true
+    restart: unless-stopped
+```
+
 **Features:**
 - Clean, professional design matching documentation standards
 - Real-time cookbook analysis with progress indicators
@@ -569,7 +678,7 @@ Each MCP tool includes comprehensive documentation:
 - **[Testing Strategy Guide](docs/testing-strategy.md)** - Validation and testing approaches
 - **[Best Practices](docs/best-practices.md)** - Recommended patterns and approaches
 
-## 🤝 Contributing
+## Contributing
 
 We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for:
 - Development setup and workflow
@@ -577,13 +686,13 @@ We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for:
 - Pull request process
 - Issue reporting guidelines
 
-## 📄 License
+## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
 ## Roadmap
 
-### Completed ✅
+### Completed
 -  Complete Chef cookbook parsing (recipes, attributes, metadata, templates)
 -  InSpec profile parsing and conversion to Testinfra/Ansible tests
 -  Chef resource to Ansible task conversion with module mapping
@@ -613,8 +722,13 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 -  **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
+-  **Automated ERB to Jinja2 template conversion** - Converts Chef ERB templates to Ansible Jinja2 templates during cookbook conversion
+   -  Converts ERB syntax to Jinja2: `<%= var %>` → `{{ var }}`, `<% if %>` → `{% if %}`
+   -  Extracts template variables for validation and documentation
+   -  Includes converted templates in downloadable playbook archives
+   -  UI displays converted templates with variable lists and preview
 
-### Planned 📅
+### Planned
 - 📅 Enhanced graph layout algorithms for large dependency networks (force-directed, hierarchical)
 - 📅 Export functionality for graphs (PNG, SVG, PDF formats)
 - 📅 UI configuration options and themes
@@ -626,7 +740,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - 📅 Migration templates and presets
 - 📅 Terraform provider for infrastructure state management
 
-## 🙋‍♀️ Support & Community
+## Support & Community
 
 - **Issues**: [GitHub Issues](https://github.com/kpeacocke/souschef/issues)
 - **Discussions**: [GitHub Discussions](https://github.com/kpeacocke/souschef/discussions)
@@ -634,7 +748,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-**SousChef** - *Transforming infrastructure automation, one recipe at a time.* ✨
+**SousChef** - *Transforming infrastructure automation, one recipe at a time.*
   desc 'Ensure package nginx is properly configured'
   impact 1.0
 
@@ -1338,12 +1452,28 @@ The project includes several VS Code tasks:
 
 ## Contributing
 
-Contributions are welcome! Please ensure:
-1. All tests pass
-2. Code coverage maintained at 90%+
-3. Code passes ruff linting
-4. All functions have type hints and docstrings
-5. Follow the development standards in `.github/copilot-instructions.md`
+Thank you for your interest in contributing to SousChef!
+
+**Before you start**, please read the [**Architecture Guide**](docs/ARCHITECTURE.md) to understand where different code belongs and why. This is essential for understanding how to structure your contributions.
+
+For complete contributing guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md), which includes:
+- Development setup instructions
+- Code standards and quality tools
+- Testing requirements and patterns
+- Commit conventions and PR process
+- Release procedures
+
+**Quick Checklist for Contributions:**
+1. Read [**docs/ARCHITECTURE.md**](docs/ARCHITECTURE.md) to understand module structure
+2. Ensure all tests pass: `poetry run pytest`
+3. Code passes linting: `poetry run ruff check .`
+4. Code is formatted: `poetry run ruff format .`
+5. Type hints are complete: `poetry run mypy souschef`
+6. Coverage maintained at 90%+
+7. All functions have docstrings
+8. Follow [conventional commits](CONTRIBUTING.md#commit-message-format)
+
+Questions? Check [ARCHITECTURE.md](docs/ARCHITECTURE.md) for module responsibilities or [CONTRIBUTING.md](CONTRIBUTING.md) for the full developer guide.
 
 ## License
 
@@ -1351,4 +1481,5 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-**SousChef** - *Ansible automation, one recipe at a time.* ✨
+**SousChef** - *Ansible automation, one recipe at a time.*
+

mcp_souschef-2.5.3/PKG-INFO → mcp_souschef-3.0.0/README.md

@@ -1,31 +1,8 @@
-Metadata-Version: 2.4
-Name: mcp-souschef
-Version: 2.5.3
-Summary: AI-powered MCP server for Chef to Ansible conversion
-License: MIT
-License-File: LICENSE
-Author: SousChef Contributors
-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
-
 # 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.
 
-[![PyPI version](https://img.shields.io/pypi/v/mcp-souschef.svg)](https://pypi.org/project/mcp-souschef/)
+[![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)
@@ -37,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 **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.
+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.
 
 ### About Tool Counts
 
-**Why 27 tools in the documentation but more in the server?**
+**Why 32 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.
+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.
 
 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.
+> **For developers:** See `souschef/server.py` for the complete list of all 37 registered tools.
 
 ## Model Agnostic - Works with Any AI Model
 
@@ -95,7 +72,7 @@ Complete cookbook introspection and analysis tools:
 - **list_directory** - Navigate and explore cookbook directory structures
 - **read_file** - Read cookbook files with error handling
 - **read_cookbook_metadata** - Parse metadata.rb files for dependencies and cookbook information
-- **parse_recipe** - Analyze Chef recipes and extract resources, actions, and properties
+- **parse_recipe** - Analyse Chef recipes and extract resources, actions, and properties
 - **parse_attributes** - Parse attribute files with **advanced precedence resolution** (6 levels: default, force_default, normal, override, force_override, automatic)
 - **list_cookbook_structure** - Display complete cookbook directory hierarchy
 
@@ -116,7 +93,7 @@ Convert Chef search patterns to dynamic Ansible inventory:
 
 - **convert_chef_search_to_inventory** - Transform Chef search queries to Ansible inventory groups
 - **generate_dynamic_inventory_script** - Create dynamic inventory scripts from Chef server queries
-- **analyze_chef_search_patterns** - Discover and analyze search usage in cookbooks
+- **analyse_chef_search_patterns** - Discover and analyse search usage in cookbooks
 
 ### 4. InSpec Integration & Validation
 Complete InSpec-to-Ansible testing pipeline:
@@ -130,14 +107,14 @@ Chef data bags to Ansible vars/vault conversion:
 
 - **convert_chef_databag_to_vars** - Transform data bags to Ansible variable files
 - **generate_ansible_vault_from_databags** - Convert encrypted data bags to Ansible Vault
-- **analyze_chef_databag_usage** - Analyze data bag usage patterns in cookbooks
+- **analyse_chef_databag_usage** - Analyse data bag usage patterns in cookbooks
 
 ### 6. Environment & Configuration Management
 Chef environments to Ansible inventory groups:
 
 - **convert_chef_environment_to_inventory_group** - Transform Chef environments to inventory
 - **generate_inventory_from_chef_environments** - Generate complete inventory from environments
-- **analyze_chef_environment_usage** - Analyze environment usage in cookbooks
+- **analyse_chef_environment_usage** - Analyse environment usage in cookbooks
 
 ### 7. AWX/Ansible Automation Platform Integration
 Enterprise AWX/AAP configuration generation:
@@ -263,10 +240,10 @@ Output formats:
 - **json**: Structured JSON for programmatic processing
 - **summary**: Quick overview with counts only
 
-- **analyze_chef_application_patterns** - Identify application deployment patterns
+- **analyse_chef_application_patterns** - Identify application deployment patterns
 - **assess_chef_migration_complexity** - Comprehensive migration complexity assessment
 - **generate_migration_plan** - Create detailed migration execution plans
-- **analyze_cookbook_dependencies** - Analyze dependencies and migration order
+- **analyse_cookbook_dependencies** - Analyse dependencies and migration order
 - **generate_migration_report** - Generate executive and technical migration reports
 
 ## Migration Workflow
@@ -276,8 +253,8 @@ Output formats:
 # Assess migration complexity
 assess_chef_migration_complexity /path/to/cookbooks
 
-# Analyze cookbook dependencies
-analyze_cookbook_dependencies /path/to/cookbook
+# Analyse cookbook dependencies
+analyse_cookbook_dependencies /path/to/cookbook
 
 # Generate migration plan
 generate_migration_plan '{\"cookbooks\": [\"/path/to/cookbook1\", \"/path/to/cookbook2\"]}'
@@ -369,6 +346,79 @@ souschef ui
 souschef ui --port 8080
 ```
 
+**Run in Docker:**
+```bash
+# Build the image
+docker build -t souschef-ui .
+
+# Run the container
+docker run -p 9999:9999 souschef-ui
+
+# Or use docker-compose
+docker-compose up
+```
+
+**Docker Environment Configuration:**
+
+SousChef supports AI configuration via environment variables in Docker containers. Create a `.env` file in your project root:
+
+```bash
+# Copy the example environment file
+cp .env.example .env
+
+# Edit with your AI provider settings
+nano .env
+```
+
+**Example .env file:**
+```dotenv
+# AI Configuration
+SOUSCHEF_AI_PROVIDER=Anthropic (Claude)
+SOUSCHEF_AI_MODEL=claude-3-5-sonnet-20241022
+SOUSCHEF_AI_API_KEY=your-api-key-here
+SOUSCHEF_AI_BASE_URL=
+SOUSCHEF_AI_PROJECT_ID=
+SOUSCHEF_AI_TEMPERATURE=0.7
+SOUSCHEF_AI_MAX_TOKENS=4000
+
+# Streamlit Configuration (optional)
+STREAMLIT_SERVER_PORT=9999
+STREAMLIT_SERVER_HEADLESS=true
+```
+
+**Supported AI Providers:**
+- `Anthropic (Claude)` - Anthropic Claude models
+- `OpenAI (GPT)` - OpenAI GPT models
+- `IBM Watsonx` - IBM Watsonx AI models
+- `Red Hat Lightspeed` - Red Hat Lightspeed models
+
+**Environment Variables:**
+- `SOUSCHEF_AI_PROVIDER` - AI provider name (required)
+- `SOUSCHEF_AI_MODEL` - Model name (required)
+- `SOUSCHEF_AI_API_KEY` - API key for authentication (required)
+- `SOUSCHEF_AI_BASE_URL` - Custom API base URL (optional)
+- `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)
+
+**Docker Compose (recommended for development):**
+```yaml
+version: '3.8'
+services:
+  souschef-ui:
+    build: .
+    ports:
+      - "9999:9999"
+    env_file:
+      - .env
+    environment:
+      - PYTHONPATH=/app
+      - STREAMLIT_SERVER_ADDRESS=0.0.0.0
+      - STREAMLIT_SERVER_PORT=9999
+      - STREAMLIT_SERVER_HEADLESS=true
+    restart: unless-stopped
+```
+
 **Features:**
 - Clean, professional design matching documentation standards
 - Real-time cookbook analysis with progress indicators
@@ -592,7 +642,7 @@ Each MCP tool includes comprehensive documentation:
 - **[Testing Strategy Guide](docs/testing-strategy.md)** - Validation and testing approaches
 - **[Best Practices](docs/best-practices.md)** - Recommended patterns and approaches
 
-## 🤝 Contributing
+## Contributing
 
 We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for:
 - Development setup and workflow
@@ -600,13 +650,13 @@ We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for:
 - Pull request process
 - Issue reporting guidelines
 
-## 📄 License
+## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
 ## Roadmap
 
-### Completed ✅
+### Completed
 -  Complete Chef cookbook parsing (recipes, attributes, metadata, templates)
 -  InSpec profile parsing and conversion to Testinfra/Ansible tests
 -  Chef resource to Ansible task conversion with module mapping
@@ -636,8 +686,13 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 -  **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
+-  **Automated ERB to Jinja2 template conversion** - Converts Chef ERB templates to Ansible Jinja2 templates during cookbook conversion
+   -  Converts ERB syntax to Jinja2: `<%= var %>` → `{{ var }}`, `<% if %>` → `{% if %}`
+   -  Extracts template variables for validation and documentation
+   -  Includes converted templates in downloadable playbook archives
+   -  UI displays converted templates with variable lists and preview
 
-### Planned 📅
+### Planned
 - 📅 Enhanced graph layout algorithms for large dependency networks (force-directed, hierarchical)
 - 📅 Export functionality for graphs (PNG, SVG, PDF formats)
 - 📅 UI configuration options and themes
@@ -649,7 +704,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - 📅 Migration templates and presets
 - 📅 Terraform provider for infrastructure state management
 
-## 🙋‍♀️ Support & Community
+## Support & Community
 
 - **Issues**: [GitHub Issues](https://github.com/kpeacocke/souschef/issues)
 - **Discussions**: [GitHub Discussions](https://github.com/kpeacocke/souschef/discussions)
@@ -657,7 +712,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-**SousChef** - *Transforming infrastructure automation, one recipe at a time.* ✨
+**SousChef** - *Transforming infrastructure automation, one recipe at a time.*
   desc 'Ensure package nginx is properly configured'
   impact 1.0
 
@@ -1361,12 +1416,28 @@ The project includes several VS Code tasks:
 
 ## Contributing
 
-Contributions are welcome! Please ensure:
-1. All tests pass
-2. Code coverage maintained at 90%+
-3. Code passes ruff linting
-4. All functions have type hints and docstrings
-5. Follow the development standards in `.github/copilot-instructions.md`
+Thank you for your interest in contributing to SousChef!
+
+**Before you start**, please read the [**Architecture Guide**](docs/ARCHITECTURE.md) to understand where different code belongs and why. This is essential for understanding how to structure your contributions.
+
+For complete contributing guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md), which includes:
+- Development setup instructions
+- Code standards and quality tools
+- Testing requirements and patterns
+- Commit conventions and PR process
+- Release procedures
+
+**Quick Checklist for Contributions:**
+1. Read [**docs/ARCHITECTURE.md**](docs/ARCHITECTURE.md) to understand module structure
+2. Ensure all tests pass: `poetry run pytest`
+3. Code passes linting: `poetry run ruff check .`
+4. Code is formatted: `poetry run ruff format .`
+5. Type hints are complete: `poetry run mypy souschef`
+6. Coverage maintained at 90%+
+7. All functions have docstrings
+8. Follow [conventional commits](CONTRIBUTING.md#commit-message-format)
+
+Questions? Check [ARCHITECTURE.md](docs/ARCHITECTURE.md) for module responsibilities or [CONTRIBUTING.md](CONTRIBUTING.md) for the full developer guide.
 
 ## License
 
@@ -1374,5 +1445,4 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-**SousChef** - *Ansible automation, one recipe at a time.* ✨
-
+**SousChef** - *Ansible automation, one recipe at a time.*

{mcp_souschef-2.5.3 → mcp_souschef-3.0.0}/pyproject.toml

@@ -1,15 +1,23 @@
 [tool.poetry]
 name = "mcp-souschef"
-version = "2.5.3"
+version = "3.0.0"
 description = "AI-powered MCP server for Chef to Ansible conversion"
 readme = "README.md"
+homepage = "https://github.com/kpeacocke/souschef"
+repository = "https://github.com/kpeacocke/souschef"
+documentation = "https://kpeacocke.github.io/souschef/"
+keywords = ["chef", "ansible", "migration", "infrastructure", "automation", "mcp", "ai", "conversion"]
 authors = ["SousChef Contributors"]
 license = "MIT"
 packages = [{include = "souschef"}]
+classifiers = ["Development Status :: 4 - Beta", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.13", "Programming Language :: Python :: 3.14", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System :: Systems Administration", "Topic :: Utilities"]
+
+[tool.poetry.urls]
 
 [tool.poetry.dependencies]
-python = ">=3.14,<4.0"
+python = ">=3.13,<4.0"
 anthropic = ">=0.75.0"
+openai = ">=1.0.0"
 click = ">=8.1.0"
 mcp = ">=1.25.0"
 python-dotenv = ">=1.2.1"
@@ -42,7 +50,7 @@ mkdocstrings = {extras = ["python"], version = ">=0.26,<1.1"}
 mkdocs-git-revision-date-localized-plugin = "^1.2.0"
 streamlit = "^1.28.0"
 networkx = "^3.2.0"
-plotly = "^5.17.0"
+plotly = ">=5.17,<7.0"
 matplotlib = "^3.8.0"
 types-networkx = "^3.6.1.20251220"
 
@@ -71,6 +79,8 @@ ignore = ["D100", "D104", "D105", "D107", "D203", "D212"]
 "souschef/parsers/validation.py" = ["E501"]  # Long lines in validation messages
 "souschef/converters/resource.py" = ["C901"]  # Allow complex function for resource conversion logic
 "souschef/deployment.py" = ["ISC003"]  # Allow explicit string concatenation
+"souschef/ui/app.py" = ["E402"]  # Allow imports after path manipulation
+"souschef/ui/pages/cookbook_analysis.py" = ["C901"]  # Allow complex functions in UI code
 
 [tool.pytest.ini_options]
 minversion = "6.0"
@@ -82,7 +92,7 @@ testpaths = [
 [tool.coverage.run]
 source = ["souschef"]
 relative_files = true
-omit = ["tests/*", "examples/*"]
+omit = ["tests/*", "examples/*", "souschef/ui/*"]
 
 [tool.coverage.report]
 exclude_lines = [
@@ -108,7 +118,7 @@ source = [
 backup = false
 
 [tool.mypy]
-python_version = "3.14"
+python_version = "3.13"
 warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = false
@@ -122,3 +132,10 @@ no_implicit_optional = true
 module = "tests.*"
 disallow_untyped_defs = false
 check_untyped_defs = false
+
+[[tool.mypy.overrides]]
+module = [
+    "plotly.*",
+    "streamlit.*",
+]
+ignore_missing_imports = true