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

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

@@ -1,3 +1,39 @@
+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.
@@ -352,12 +388,55 @@ souschef ui --port 8080
 docker build -t souschef-ui .
 
 # Run the container
-docker run -p 8501:8501 souschef-ui
+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'
@@ -365,7 +444,14 @@ services:
   souschef-ui:
     build: .
     ports:
-      - "8501:8501"
+      - "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
 ```
 
@@ -636,6 +722,11 @@ 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
 - 📅 Enhanced graph layout algorithms for large dependency networks (force-directed, hierarchical)
@@ -1361,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
 
@@ -1375,3 +1482,4 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 ---
 
 **SousChef** - *Ansible automation, one recipe at a time.*
+

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

@@ -1,38 +1,3 @@
-Metadata-Version: 2.4
-Name: mcp-souschef
-Version: 2.8.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.14,<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.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.
@@ -387,12 +352,55 @@ souschef ui --port 8080
 docker build -t souschef-ui .
 
 # Run the container
-docker run -p 8501:8501 souschef-ui
+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'
@@ -400,7 +408,14 @@ services:
   souschef-ui:
     build: .
     ports:
-      - "8501:8501"
+      - "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
 ```
 
@@ -671,6 +686,11 @@ 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
 - 📅 Enhanced graph layout algorithms for large dependency networks (force-directed, hierarchical)
@@ -1396,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
 
@@ -1410,4 +1446,3 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 ---
 
 **SousChef** - *Ansible automation, one recipe at a time.*
-

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

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "mcp-souschef"
-version = "2.8.0"
+version = "3.0.0"
 description = "AI-powered MCP server for Chef to Ansible conversion"
 readme = "README.md"
 homepage = "https://github.com/kpeacocke/souschef"
@@ -10,12 +10,12 @@ keywords = ["chef", "ansible", "migration", "infrastructure", "automation", "mcp
 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.14", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System :: Systems Administration", "Topic :: Utilities"]
+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"
@@ -50,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"
 
@@ -79,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"
@@ -116,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
@@ -130,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

mcp_souschef-3.0.0/souschef/__init__.py

@@ -0,0 +1,57 @@
+"""SousChef: AI-powered Chef to Ansible converter."""
+
+from pathlib import Path
+
+import tomllib
+
+
+# Read version from pyproject.toml
+def _get_version() -> str:
+    """Get version from pyproject.toml."""
+    pyproject_path = Path(__file__).parent.parent / "pyproject.toml"
+    try:
+        with pyproject_path.open("rb") as f:
+            data = tomllib.load(f)
+        version = data.get("tool", {}).get("poetry", {}).get("version")
+        return str(version) if version else "unknown"
+    except OSError:
+        return "unknown"
+
+
+__version__ = _get_version()
+
+from souschef.assessment import (  # noqa: E402
+    analyse_cookbook_dependencies,
+    assess_chef_migration_complexity,
+    generate_migration_plan,
+    generate_migration_report,
+    validate_conversion,
+)
+from souschef.deployment import (  # noqa: E402
+    analyse_chef_application_patterns,
+)
+
+# Import server functions only if MCP is available
+try:
+    from souschef.server import (
+        analyse_chef_search_patterns,
+    )
+
+    _server_available = True
+except ImportError:
+    _server_available = False
+
+    # Define a placeholder function for when MCP is not available
+    def analyse_chef_search_patterns(*args, **kwargs):
+        raise NotImplementedError("MCP server not available")
+
+
+__all__ = [
+    "analyse_cookbook_dependencies",
+    "assess_chef_migration_complexity",
+    "generate_migration_plan",
+    "generate_migration_report",
+    "validate_conversion",
+    "analyse_chef_application_patterns",
+    "analyse_chef_search_patterns",
+]