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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-souschef
-Version: 3.5.2
+Version: 4.0.0
 Summary: AI-powered MCP server for Chef to Ansible conversion
 License: MIT
 License-File: LICENSE
@@ -23,13 +23,16 @@ Classifier: Topic :: System :: Systems Administration
 Classifier: Topic :: Utilities
 Provides-Extra: ai
 Provides-Extra: all
+Provides-Extra: storage
 Provides-Extra: ui
 Requires-Dist: anthropic (>=0.75.0) ; extra == "ai" or extra == "all"
+Requires-Dist: boto3 (>=1.26.0) ; extra == "storage" 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: psycopg[binary] (>=3.1.19) ; extra == "storage" or extra == "all"
 Requires-Dist: pydantic (>=2.0.0)
 Requires-Dist: python-dotenv (>=1.2.1)
 Requires-Dist: pyyaml (>=6.0.0)
@@ -56,17 +59,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 **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.
+SousChef is a complete enterprise-grade migration platform with **40 primary MCP tools** organised across **12 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, CI/CD pipeline generation, and GitHub Copilot agent control, SousChef provides everything needed for a successful infrastructure automation migration.
 
 ### About Tool Counts
 
-**Why 35 tools in the documentation but more in the server?**
+**Why 40 tools in the documentation but more in the server?**
 
-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.
+The MCP server provides **43 total tools**. This documentation focuses on the **40 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 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 38 registered tools.
+> **For developers:** See `souschef/server.py` for the complete list of all 43 registered tools.
 
 ## Model Agnostic - Works with Any AI Model
 
@@ -87,6 +90,7 @@ As a user, you'll primarily interact with the documented tools. Your AI assistan
 
 - **[Terraform Provider](terraform-provider/README.md)** - Manage migrations with infrastructure-as-code
 - **[User Guide](docs/user-guide/)** - Complete documentation
+- **[Data Persistence Guide](docs/user-guide/data-persistence.md)** - History, caching, and storage backends
 - **[API Reference](docs/api-reference/)** - Detailed tool documentation
 - **[Migration Guide](docs/migration-guide/)** - Step-by-step migration process
 
@@ -226,7 +230,27 @@ Automatically detects and converts:
 - **Cookstyle/Foodcritic** → Lint stages
 - Multiple test suites → Parallel execution strategies
 
-#### Example Usage
+### 11. GitHub Copilot Agent Control
+
+Manage GitHub Copilot agents working on repository issues with full pause/stop/resume capabilities:
+
+- **assign_github_copilot_to_issue** - Assign Copilot agent to implement an issue
+- **pause_github_copilot_agent** - Pause a running agent (can be resumed)
+- **stop_github_copilot_agent** - Stop and cancel an agent assignment
+- **resume_github_copilot_agent** - Resume a paused agent with optional new instructions
+- **check_github_copilot_agent_status** - Check current agent state and activity
+
+**Agent lifecycle management:**
+
+1. **Assign** - Start Copilot working on an issue
+2. **Monitor** - Check status and review progress
+3. **Pause** - Temporarily pause for review or changes
+4. **Resume** - Continue with optional new guidance
+5. **Stop** - Cancel if requirements change
+
+State is tracked via issue labels and comments, providing full visibility and control.
+
+#### Example Usage - CI/CD Pipelines
 
 ```bash
 # Generate Jenkins Declarative pipeline
@@ -241,12 +265,58 @@ souschef generate-gitlab-ci ./mycookbook
 # Generate GitHub Actions workflow
 souschef generate-github-workflow ./mycookbook
 
-# Customize with options
+# Customise with options
 souschef generate-gitlab-ci ./mycookbook --no-cache --no-artifacts
 souschef generate-github-workflow ./mycookbook --workflow-name "My CI" --no-cache
 ```
 
-#### Command Line Usage
+#### Example Usage - GitHub Agent Control
+
+```python
+# From an AI assistant with SousChef MCP
+
+# Assign Copilot to work on an issue
+assign_github_copilot_to_issue(
+    owner="myorg",
+    repo="my-ansible-repo",
+    issue_number=42,
+    base_ref="main",
+    custom_instructions="Focus on idempotency and error handling"
+)
+
+# Check agent status
+check_github_copilot_agent_status(
+    owner="myorg",
+    repo="my-ansible-repo",
+    issue_number=42
+)
+
+# Pause for review
+pause_github_copilot_agent(
+    owner="myorg",
+    repo="my-ansible-repo",
+    issue_number=42,
+    reason="Need to review approach before continuing"
+)
+
+# Resume with new guidance
+resume_github_copilot_agent(
+    owner="myorg",
+    repo="my-ansible-repo",
+    issue_number=42,
+    additional_instructions="Also add role dependencies"
+)
+
+# Stop if no longer needed
+stop_github_copilot_agent(
+    owner="myorg",
+    repo="my-ansible-repo",
+    issue_number=42,
+    reason="Requirements changed - manual implementation needed"
+)
+```
+
+#### Command Line Usage - CI/CD Pipelines
 
 **MCP Tool Usage:**
 
@@ -475,6 +545,7 @@ Interactive web-based interface for Chef-to-Ansible migration planning and visua
 - **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
+- **History and Persistence**: Stored analysis history, cached results, and downloadable artefacts (SQLite or PostgreSQL, plus S3-compatible storage)
 
 **Launch the UI:**
 
@@ -595,8 +666,59 @@ STREAMLIT_SERVER_HEADLESS=true
 - `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)
 
+**Persistent Storage Configuration (Docker Compose):**
+
+All persistent storage paths are configurable via environment variables. Add these to your `.env` file to customise where data is stored:
+
+```dotenv
+# Docker Compose Volume Configuration (optional)
+SOUSCHEF_DATA_DIR=./data/souschef       # SQLite database and analysis history
+SOUSCHEF_STORAGE_DIR=./data/storage     # Generated artefacts and conversions
+POSTGRES_DATA_DIR=./data/postgres       # PostgreSQL database files
+MINIO_DATA_DIR=./data/minio             # MinIO object storage data
+```
+
+The storage paths default to `./data/` subdirectories (relative to docker-compose.yml) but can be set to any absolute or relative path. This allows you to:
+- Store data on different volumes or network storage
+- Easily backup and restore data by copying directories
+- Share data between development and production environments
+
+See [Docker Deployment Guide](docs/docker-deployment.md#persistent-storage-configuration) for detailed configuration options.
+
 **Docker Compose (recommended for development):**
 
+```bash
+# Using PostgreSQL (default, production-ready)
+docker compose up
+
+# Or if you prefer SQLite (lightweight, local storage only):
+# 1. Set in .env: SOUSCHEF_DB_BACKEND=sqlite
+# 2. Run normally: docker compose up
+```
+
+**Database Options:**
+
+- **PostgreSQL** (default):
+  - Robust, production-ready database server
+  - Recommended for all deployments
+  - Better concurrency and performance
+  - Data stored in `./data/postgres/`
+
+- **SQLite**:
+  - Lightweight, embedded database
+  - Good for development and testing
+  - Set `SOUSCHEF_DB_BACKEND=sqlite` in .env
+  - Data stored in `./data/souschef/`
+
+**Example with SQLite:**
+```bash
+# In .env, set:
+SOUSCHEF_DB_BACKEND=sqlite
+# Then start normally:
+docker compose up
+```
+
+**Example with PostgreSQL (default):**
 ```yaml
 version: '3.8'
 services:
@@ -611,6 +733,12 @@ services:
       - STREAMLIT_SERVER_ADDRESS=0.0.0.0
       - STREAMLIT_SERVER_PORT=9999
       - STREAMLIT_SERVER_HEADLESS=true
+      - SOUSCHEF_DB_BACKEND=postgres
+      - SOUSCHEF_DB_HOST=postgres
+      - SOUSCHEF_DB_PORT=5432
+      - SOUSCHEF_DB_NAME=souschef
+      - SOUSCHEF_DB_USER=souschef
+      - SOUSCHEF_DB_PASSWORD=souschef
     restart: unless-stopped
 ```
 

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

@@ -13,7 +13,7 @@ souschef/converters/playbook.py,sha256=F_6tSFyrlT55vLdi632g7Yd5rkNRPlq4pnb5HSMrs
 souschef/converters/resource.py,sha256=NYMcp1-obg_ad_XPuYDuUH_0j65agRbAeWzXPfbSi5c,13570
 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/ai_schemas.py,sha256=Rp48Z1KLKFizZkUBORKUx2jfSJWuwf5SCoKIf6FNc9E,2964
 souschef/core/constants.py,sha256=AyIpc9cJjQEDc1yOcoKc_2-cJB4PekSpPKEK2S9jDl8,5122
 souschef/core/errors.py,sha256=zj_LHDRxUvHmcs-nZjOWu4B_MhY5WVq2okyZOxyycCI,8605
 souschef/core/http_client.py,sha256=f7laiNsIAX95-fVyAfnQXUdOL-Cv7ZWxi5xLnmTAkF4,12873
@@ -28,6 +28,8 @@ souschef/filesystem/__init__.py,sha256=2H7Pdeedz0MfmgpRlmii_vx61qr0jtxFndT0APPm6
 souschef/filesystem/operations.py,sha256=OMMozBfV_o70b47KioiZ2i6HViiUQPE5mVBeKcKFepo,1654
 souschef/generators/__init__.py,sha256=T_XShFRPEceciUCq3q0EzYkAloN7CtoCq63kWzpQPW4,254
 souschef/generators/repo.py,sha256=RUc8uCHPF5SXFWn43eSRph1hAZwQxLKLwYbnZN0CdcQ,18851
+souschef/github/__init__.py,sha256=X2uQrnidm5-cTYbcXnLd3RPamDEws03u4Tx3xxK5JfU,392
+souschef/github/agent_control.py,sha256=iwRVvPjO7IGtBfenP4npyw-QkLJs0JCPjrqR7W_NhKo,14012
 souschef/parsers/__init__.py,sha256=gF-vPslzs9iLxsaDzFnWDPpYFDAIwyAifjUwzYurPLg,1104
 souschef/parsers/attributes.py,sha256=ss0H7QAPAZEf2YPrln7yXVHWQIjV4vqlcmLR8ZZXiNo,18250
 souschef/parsers/habitat.py,sha256=n2mb5ydcIqday4TH_bmp6Nka0VxoMpKM5doaCh8ClY0,10494
@@ -37,16 +39,21 @@ 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=Mzf8hnoGd83C46fO99mCw_4dHS7KttXfOmlVn7MJQ9c,125886
+souschef/server.py,sha256=styEzpiXyI2hBwInp_hk4WjrNtkSDI4OHcLOQhyLzB4,131100
+souschef/storage/__init__.py,sha256=HExdGjXDmVv_m4OC0q3_VV5R1Dk94NtycP-RlM9qmo4,846
+souschef/storage/blob.py,sha256=bTobqw8zC4hTYKK_YNwKGQ2alFUduckGVG31Q_ZkHN4,10907
+souschef/storage/config.py,sha256=7L9_QGGt174OweJvl5yDn5A1N4DayEXhc4P3TSxHEwo,4571
+souschef/storage/database.py,sha256=z9oujKyKZJTNCQATSWi2LJj8vm_Yb60jShKN6IlwGac,38988
 souschef/ui/__init__.py,sha256=U3W6X4ww7CxQVuetcocObWn5iY6lUFiNX7WoDBJeD34,195
-souschef/ui/app.py,sha256=ru1KDYqnEDQvq46HHLNu1JGwzIScr7Lm11BeqnXpvQs,102343
+souschef/ui/app.py,sha256=zK2R4M5hxR_X0GCnG9k_GiOpZoRSIhF7O-pBCKxaTZI,102760
 souschef/ui/health_check.py,sha256=mEzec8L6XPRekOBAXngqQz5dnzal-a4p3D70mkPriiA,903
 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/chef_server_settings.py,sha256=7Q1k7rsIv4p91i0yx3g0svD2qWgXZwAYrVGUr3T2jeM,21882
+souschef/ui/pages/cookbook_analysis.py,sha256=XZvPGzkye3zW6hE7noNuYePACVmtFPaS5L-s23vhYL0,161175
+souschef/ui/pages/history.py,sha256=g935hpkdJlXqBZibiqkG82gF7XRn13xDFfj90ggADrg,31241
 souschef/ui/pages/validation_reports.py,sha256=R3xHTJb_y2b0tI8N0qPF1oS4f9ZVb539_82dj5nmmxA,7593
-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-4.0.0.dist-info/METADATA,sha256=35ng6in7gceAJqcrsBTV4HBHG2dT-4awdbbbsniDQYo,51653
+mcp_souschef-4.0.0.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+mcp_souschef-4.0.0.dist-info/entry_points.txt,sha256=NVSk61tLG4W0xEkWGOMXAVCIUyodyZCY_j3Z_0m6rkQ,80
+mcp_souschef-4.0.0.dist-info/licenses/LICENSE,sha256=t31dYSuvYYNw6trj-coWSsLK-Tg_Iyl8ObcolQcrUKM,1078
+mcp_souschef-4.0.0.dist-info/RECORD,,

souschef/core/ai_schemas.py

@@ -30,7 +30,12 @@ class AnsibleTask(BaseModel):
         None, description="List of tags for task categorization"
     )
     become: bool | None = Field(None, description="Whether to use privilege escalation")
-    register: str | None = Field(None, description="Variable name to store task result")
+    register_var: str | None = Field(
+        None,
+        validation_alias="register",
+        serialization_alias="register",
+        description="Variable name to store task result",
+    )
 
 
 class AnsibleHandler(BaseModel):

souschef/github/__init__.py

@@ -0,0 +1,17 @@
+"""GitHub integration utilities."""
+
+from souschef.github.agent_control import (
+    assign_copilot_agent_to_issue,
+    check_copilot_agent_status,
+    pause_copilot_agent,
+    resume_copilot_agent,
+    stop_copilot_agent,
+)
+
+__all__ = [
+    "assign_copilot_agent_to_issue",
+    "pause_copilot_agent",
+    "stop_copilot_agent",
+    "resume_copilot_agent",
+    "check_copilot_agent_status",
+]