codedthemes-cli 0.1.0__tar.gz → 0.1.2__tar.gz

codedthemes_cli-0.1.2/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: codedthemes-cli
+Version: 0.1.2
+Summary: CLI tool for Code Theme and Integration
+Author: codedthemes
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: pyjwt
+
+# CodedThemes CLI
+
+CodedThemes CLI is a powerful command-line tool designed to integrate your local development environment with the CodedThemes MCP Server. It allows you to automate UI/UX modifications, refactor themes, and apply stylistic changes across your entire repository using AI-driven insights.
+
+## Features
+
+- **Automated Theming**: Apply complex theme changes (e.g., branding updates) with simple natural language queries.
+- **Local-to-Cloud Sync**: Securely sync your repository state to the CodedThemes engine for deep analysis.
+- **Seamless Integration**: Automatically patches local files with surgical precision.
+- **Sync Management**: Tracks local changes to ensure your manual edits are never overwritten.
+
+## Installation
+
+Install the CLI directly from PyPI:
+
+```bash
+pip install codedthemes-cli
+```
+
+## Usage
+
+### 1. Authentication
+
+Authenticate with your CodedThemes account to enable secure communication with the MCP server.
+
+```bash
+codedthemes login
+```
+*Enter your registered email and license key when prompted.*
+
+### 2. Initialization (Optional)
+
+Initialize your repository to establish a baseline for synchronization. This is recommended for first-time use in a project.
+
+```bash
+codedthemes init
+```
+
+### 3. Applying Changes
+
+Describe the changes you want to make in natural language. The CLI will analyze your repository, plan the changes, and ask for your approval before patching.
+
+```bash
+codedthemes apply "Update the theme branding from Mantis to Berry"
+```
+
+## Integration Report
+
+After every successful `apply`, a granular report is generated showing exactly which files were modified, created, or deleted.
+
+## Support
+
+For issues or feature requests, please contact the CodedThemes support team.

codedthemes_cli-0.1.2/README.md

@@ -0,0 +1,53 @@
+# CodedThemes CLI
+
+CodedThemes CLI is a powerful command-line tool designed to integrate your local development environment with the CodedThemes MCP Server. It allows you to automate UI/UX modifications, refactor themes, and apply stylistic changes across your entire repository using AI-driven insights.
+
+## Features
+
+- **Automated Theming**: Apply complex theme changes (e.g., branding updates) with simple natural language queries.
+- **Local-to-Cloud Sync**: Securely sync your repository state to the CodedThemes engine for deep analysis.
+- **Seamless Integration**: Automatically patches local files with surgical precision.
+- **Sync Management**: Tracks local changes to ensure your manual edits are never overwritten.
+
+## Installation
+
+Install the CLI directly from PyPI:
+
+```bash
+pip install codedthemes-cli
+```
+
+## Usage
+
+### 1. Authentication
+
+Authenticate with your CodedThemes account to enable secure communication with the MCP server.
+
+```bash
+codedthemes login
+```
+*Enter your registered email and license key when prompted.*
+
+### 2. Initialization (Optional)
+
+Initialize your repository to establish a baseline for synchronization. This is recommended for first-time use in a project.
+
+```bash
+codedthemes init
+```
+
+### 3. Applying Changes
+
+Describe the changes you want to make in natural language. The CLI will analyze your repository, plan the changes, and ask for your approval before patching.
+
+```bash
+codedthemes apply "Update the theme branding from Mantis to Berry"
+```
+
+## Integration Report
+
+After every successful `apply`, a granular report is generated showing exactly which files were modified, created, or deleted.
+
+## Support
+
+For issues or feature requests, please contact the CodedThemes support team.

{codedthemes_cli-0.1.0 → codedthemes_cli-0.1.2}/codedthemes/cli.py

@@ -1,20 +1,23 @@
 import argparse
 import sys
 import os
-import jwt
-import requests
 import json
 import shutil
 from getpass import getpass
 
+import jwt
+import requests
+
 from .config import save_config, load_config
 from .mcp_client import MCPClient
 from .repo_utils import detect_repo_root, zip_repo
-from .patch_utils import apply_patch
 from .sync_manager import SyncManager
 
 
 def handle_login(server_url: str = None):
+    """
+    Handles user authentication with the MCP server.
+    """
     email = input("Email: ").strip()
     license_key = input("License key: ").strip()
     
@@ -28,33 +31,28 @@ def handle_login(server_url: str = None):
             "license_key": license_key
         })
         
-
         if isinstance(result, dict):
-            # The server might have returned {"status": "error", "message": ...}
             if result.get("status") == "error":
                 print(f"✖ Login failed: {result.get('message', 'Unknown error')}")
                 sys.exit(1)
-            # The app.py bridge wraps string returns in {"message": "..."}
             elif "message" in result and "Login failed" in result["message"]:
                 print(f"✖ {result['message']}")
                 sys.exit(1)
 
-        # 1. Try to get token directly from API response (if server returns JSON)
+        # Get token from result or local fallback
         token = result.get("access_token") if isinstance(result, dict) else None
         
-        # 2. Fallback: Try to read from local file (because server now returns plain text string)
         if not token:
             token_file = os.path.expanduser("~/.mcp_token")
             if os.path.exists(token_file):
                 with open(token_file, 'r') as f:
                     token = f.read().strip()
                     
-        # 3. Final Verification: Throw error if we STILL don't have a token
         if not token:
             print("✖ Login failed: No access token returned. Please check your credentials.")
             sys.exit(1)
 
-        # Write the .mcp_token file natively for the user so it acts just like local MCP
+        # Store token for both local MCP and CLI config
         token_file = os.path.expanduser("~/.mcp_token")
         try:
             with open(token_file, 'w') as f:
@@ -78,6 +76,9 @@ def handle_login(server_url: str = None):
 
 
 def handle_init():
+    """
+    Initializes the local repository and syncs it with the cloud.
+    """
     try:
         repo_root = detect_repo_root()
         print(f"🔍 Found repository at {repo_root}")
@@ -87,7 +88,6 @@ def handle_init():
             print("✖ Not logged in. Please run 'codedthemes login' first.")
             sys.exit(1)
 
-        # 0. Get user email from token for registry profiling
         user_email = "unknown_user"
         try:
             decoded = jwt.decode(client.token, options={"verify_signature": False})
@@ -104,14 +104,12 @@ def handle_init():
             print("✖ Upload failed: No workspace ID returned.")
             sys.exit(1)
 
-        # 1. Save workspace mapping in config.json
         config = load_config()
         last_workspaces = config.get("workspaces", {})
         last_workspaces[repo_abs_path] = workspace_id
         config["workspaces"] = last_workspaces
         save_config(config)
 
-        # 2. Initialize sync state (HASHES) in workspace.json
         sync_manager = SyncManager()
         sync_manager.update_sync_state(repo_abs_path, workspace_id, user_email)
 
@@ -125,16 +123,15 @@ def handle_init():
 
 
 def handle_apply(query: str):
+    """
+    Plans and executes changes based on a natural language query.
+    """
     try:
         repo_root = detect_repo_root()
+        repo_abs_path = str(repo_root)
         print(f"🔍 Found repository at {repo_root}")
         
-        # Note: zipping logic is there but we are calling tools sequentially as per requirements
-        # zip_path = zip_repo(repo_root)
-
         client = MCPClient()
-        
-        # 0. Get user email from token for registry profiling
         user_email = "unknown_user"
         if client.token:
             try:
@@ -144,17 +141,14 @@ def handle_apply(query: str):
                 pass
 
         sync_manager = SyncManager()
-
         config = load_config()
         last_workspaces = config.get("workspaces", {})
-        repo_abs_path = str(repo_root)
         workspace_id = last_workspaces.get(repo_abs_path)
         
-        # 1. Zip and Upload Repository (Only if not already initialized or expired)
+        # Verify or re-initialize workspace
         if workspace_id:
             logger_debug = False # toggle for debug
             try:
-                # Quick check if workspace is still on server
                 check = client.call("check_workspace", {"workspace_id": workspace_id})
                 if isinstance(check, dict) and check.get("status") == "ok":
                     print(f"✔ Using active workspace: {workspace_id}")
@@ -167,16 +161,12 @@ def handle_apply(query: str):
             print("📦 Zipping and uploading repository (this may take a moment)...")
             upload_result = client.upload_workspace(repo_abs_path, user_email)
             workspace_id = upload_result.get("workspace_id")
-            
-            # Save workspace_id for future reuse
             last_workspaces[repo_abs_path] = workspace_id
             config["workspaces"] = last_workspaces
             save_config(config)
-
-            # Init sync state locally
             sync_manager.update_sync_state(repo_abs_path, workspace_id, user_email)
 
-        # Step 1: repo analyzer
+        # 1. Repository Analysis
         print("🚀 Analyzing repository...")
         analysis = client.call("repo_analyzer", {
             "repo_path": repo_abs_path,
@@ -188,13 +178,12 @@ def handle_apply(query: str):
             return
         
         if isinstance(analysis, str):
-            # The tool might return a string message shown in CLI
             if "Analysis Skipped" in analysis:
                 print("✔ Repository is up-to-date. Skipping upload.")
             else:
                 print(f"✔ {analysis}")
 
-        # Step 2: plan changes
+        # 2. Planning
         print("🔍 Detecting local changes...")
         local_changes = sync_manager.get_changed_files(repo_abs_path, user_email)
         if local_changes:
@@ -204,7 +193,7 @@ def handle_apply(query: str):
         plan = client.call("plan_changes", {
             "query": query,
             "workspace_id": workspace_id,
-            "repo_path": str(repo_root),
+            "repo_path": repo_abs_path,
             "changes_from_cli": local_changes
         })
 
@@ -213,54 +202,50 @@ def handle_apply(query: str):
             return
 
         target_files = plan.get("files_to_modify", [])
-        plan_instructions = plan.get("plan_instructions", [])
+        instructions = plan.get("plan_instructions", [])
         files_to_create = plan.get("files_to_create", [])
         files_to_delete = plan.get("files_to_delete", [])
 
-        if not target_files and not files_to_create and not files_to_delete and not plan_instructions:
+        if not any([target_files, files_to_create, files_to_delete, instructions]):
             print("Information: No changes planned.")
             return
 
         print("\n📝 Execution Plan:")
-        if plan_instructions:
+        if instructions:
             print("Instructions:")
-            for idx, inst in enumerate(plan_instructions, 1):
+            for idx, inst in enumerate(instructions, 1):
                 print(f"  {idx}. {inst}")
         
         if files_to_create:
             print("\nFiles to create:")
-            for f in files_to_create:
-                print(f"  + {f}")
-                
+            for f in files_to_create: print(f"  + {f}")
+        
+        if target_files:
             print("\nFiles to modify:")
-            for f in target_files:
-                print(f"  ~ {f}")
+            for f in target_files: print(f"  ~ {f}")
                 
         if files_to_delete:
             print("\nFiles to delete:")
-            for f in files_to_delete:
-                print(f"  - {f}")
+            for f in files_to_delete: print(f"  - {f}")
 
         while True:
             choice = input("\nDo you want to proceed with this plan? (y/n): ").strip().lower()
-            if choice in ['y', 'yes']:
-                break
-            elif choice in ['n', 'no']:
-                print("✖ Pipeline terminated by user. Please provide a new query.")
+            if choice in ['y', 'yes']: break
+            if choice in ['n', 'no']:
+                print("✖ Pipeline terminated by user.")
                 return
-            else:
-                print("Please enter 'y' for yes or 'n' for no.")
+            print("Please enter 'y' or 'n'.")
 
-        # Step 3: execute plan
+        # 3. Execution
         print("⚙ Executing plan...")
         result = client.call("execute_plan", {
             "query": query,
-            "plan_instructions": plan_instructions,
+            "plan_instructions": instructions,
             "files_to_modify": target_files,
             "files_to_create": files_to_create,
             "files_to_delete": files_to_delete,
             "workspace_id": workspace_id,
-            "repo_path": str(repo_root)
+            "repo_path": repo_abs_path
         })
 
         if not result or (isinstance(result, dict) and (result.get("status") == "error" or "detail" in result)):
@@ -268,8 +253,7 @@ def handle_apply(query: str):
              print(f"✖ Execution failed: {error_msg}")
              return
 
-        # --- LOCAL PATCHING LOGIC (WINDOWS) ---
-        # Ensure we are looking at a dictionary
+        # 4. Local Patching
         res_data = result
         if isinstance(result, str):
             try: res_data = json.loads(result)
@@ -278,67 +262,42 @@ def handle_apply(query: str):
         updates = res_data.get("updates_for_local", [])
         deletes = res_data.get("deleted_files", [])
         
-        if not updates:
-            print("  (!) No file updates received in the response payload.")
-        
         if updates or deletes:
-            # 1. Update/Create files
             for item in updates:
                 rel_path, code = item.get("path"), item.get("code")
                 if not rel_path or code is None: continue
-                
-                # Normalize path for Windows
-                clean_rel_path = rel_path.replace('/', os.sep)
-                abs_path = os.path.abspath(os.path.join(str(repo_root), clean_rel_path))
+                abs_path = os.path.abspath(os.path.join(repo_abs_path, rel_path.replace('/', os.sep)))
                 
                 try:
                     os.makedirs(os.path.dirname(abs_path), exist_ok=True)
                     with open(abs_path, 'w', encoding='utf-8') as f:
                         f.write(code)
-                    print(f"✔ Updated local file: {rel_path}")
-                except Exception as write_err:
-                    print(f"✖ Error writing {rel_path}: {write_err}")
+                    print(f"✔ Updated: {rel_path}")
+                except Exception as e:
+                    print(f"✖ Error writing {rel_path}: {e}")
                     
-            # 2. Delete files
             for rel_path in (deletes or []):
-                clean_rel_path = rel_path.replace('/', os.sep)
-                abs_path = os.path.normpath(os.path.join(str(repo_root), clean_rel_path))
-                if os.path.exists(abs_path) and abs_path.startswith(os.path.abspath(str(repo_root))):
+                abs_path = os.path.normpath(os.path.join(repo_abs_path, rel_path.replace('/', os.sep)))
+                if os.path.exists(abs_path) and abs_path.startswith(os.path.abspath(repo_abs_path)):
                     try:
                         if os.path.isfile(abs_path): os.remove(abs_path)
                         elif os.path.isdir(abs_path): shutil.rmtree(abs_path)
-                        print(f"✔ Deleted local file/folder: {rel_path}")
+                        print(f"✔ Deleted: {rel_path}")
                     except: pass
             
-            # Finally, update the sync state so these aren't treated as local user changes next time
             sync_manager.update_sync_state(repo_abs_path, workspace_id, user_email)
             print("✔ Local sync state updated.")
 
-            # Display granular report details if available
             _details_raw = res_data.get("details", [])
             details_list = _details_raw.get("report", []) if isinstance(_details_raw, dict) else (_details_raw if isinstance(_details_raw, list) else [])
             if details_list:
                 print("\n📊 Integration Report:")
                 for item in details_list:
                     status_icon = "✔" if item.get("success") else "✖"
-                    f_name = item.get("file_path")
-                    msg = item.get("message", "")
-                    print(f"  [{status_icon}] {f_name}: {msg}")
+                    print(f"  [{status_icon}] {item.get('file_path')}: {item.get('message', '')}")
         else:
-            # Fallback for display
-            msg = res_data.get("message", "Changes applied successfully (no local updates needed).")
-            print(f"✔ {msg}")
+            print(f"✔ {res_data.get('message', 'Changes applied successfully.')}")
             
-            # If there was a report but no updates (already up to date), display why
-            _details_raw = res_data.get("details", [])
-            details_list = _details_raw.get("report", []) if isinstance(_details_raw, dict) else (_details_raw if isinstance(_details_raw, list) else [])
-            if details_list:
-                print("\n📊 Integration Report (Files already up-to-date):")
-                for item in details_list:
-                    status_icon = "✔" if item.get("success") else "✖"
-                    f_name = item.get("file_path")
-                    msg = item.get("message", "")
-                    print(f"  [{status_icon}] {f_name}: {msg}")
     except Exception as e:
         print(f"✖ Error: {e}")
         sys.exit(1)
@@ -346,15 +305,15 @@ def handle_apply(query: str):
 
 def main():
     parser = argparse.ArgumentParser(prog="codedthemes", description="CodedThemes CLI client")
-    subparsers = parser.add_subparsers(dest="command")
+    subparsers = parser.add_subparsers(dest="command", required=True)
 
     login_parser = subparsers.add_parser("login", help="Login to MCP server")
     login_parser.add_argument("--server", help="MCP server URL")
 
     apply_parser = subparsers.add_parser("apply", help="Apply changes based on a query")
-    apply_parser.add_argument("query", help="The description of changes you want to make")
+    apply_parser.add_argument("query", help="Description of changes to make")
 
-    init_parser = subparsers.add_parser("init", help="Initialize and upload repository to the cloud")
+    subparsers.add_parser("init", help="Initialize repository and sync to cloud")
 
     args = parser.parse_args()
 
@@ -364,8 +323,6 @@ def main():
         handle_init()
     elif args.command == "apply":
         handle_apply(args.query)
-    else:
-        parser.print_help()
 
 
 if __name__ == "__main__":

{codedthemes_cli-0.1.0 → codedthemes_cli-0.1.2}/codedthemes/config.py

@@ -7,16 +7,25 @@ CONFIG_FILE = CONFIG_DIR / "config.json"
 
 
 def ensure_config_dir():
+    """
+    Ensures the configuration directory exists.
+    """
     CONFIG_DIR.mkdir(exist_ok=True)
 
 
 def save_config(data: dict):
+    """
+    Saves the provided configuration data to the config file.
+    """
     ensure_config_dir()
     with open(CONFIG_FILE, "w") as f:
         json.dump(data, f, indent=2)
 
 
 def load_config():
+    """
+    Loads the configuration data from the config file.
+    """
     if not CONFIG_FILE.exists():
         return {}
     with open(CONFIG_FILE, "r") as f:

{codedthemes_cli-0.1.0 → codedthemes_cli-0.1.2}/codedthemes/mcp_client.py

@@ -1,8 +1,12 @@
 import os
 import requests
 from .config import load_config
+from .repo_utils import zip_repo
 
 class MCPClient:
+    """
+    Client for interacting with the CodedThemes MCP Server.
+    """
     def __init__(self):
         config = load_config()
         self.server_url = (
@@ -13,8 +17,9 @@ class MCPClient:
         self.token = config.get("access_token")
 
     def upload_workspace(self, repo_path: str, user_id: str):
-        from .repo_utils import zip_repo
-        
+        """
+        Zips and uploads the repository to create a new workspace.
+        """
         zip_path = zip_repo(repo_path)
         repo_name = os.path.basename(repo_path)
         
@@ -35,6 +40,16 @@ class MCPClient:
                     timeout=300
                 )
                 
+                if response.status_code == 413:
+                    zip_size_mb = os.path.getsize(zip_path) / (1024 * 1024)
+                    raise Exception(
+                        f"Upload failed: File is too large (413). Zip size: {zip_size_mb:.1f} MB.\n"
+                        "  Please reduce your repository size:\n"
+                        "  • Add large files/folders to .gitignore\n"
+                        "  • Remove binary assets (images, videos, fonts)\n"
+                        "  • Delete unused dependencies"
+                    )
+                
                 if response.status_code != 200:
                     raise Exception(f"Upload failed: {response.status_code} - {response.text}")
                 
@@ -44,6 +59,9 @@ class MCPClient:
                 os.remove(zip_path)
 
     def call(self, tool_name: str, payload: dict):
+        """
+        Calls a remote MCP tool.
+        """
         headers = {}
         if self.token:
             headers["Authorization"] = f"Bearer {self.token}"

codedthemes_cli-0.1.2/codedthemes/repo_utils.py

@@ -0,0 +1,190 @@
+import os
+import zipfile
+import tempfile
+import logging
+from pathlib import Path
+from fnmatch import fnmatch
+
+logger = logging.getLogger("codedthemes")
+
+# ── Shared exclusion constants (used by both zip_repo and SyncManager) ────────
+
+EXCLUDE_DIRS = {
+    # Version control
+    ".git", ".svn", ".hg",
+    # Dependencies
+    "node_modules", "bower_components", "vendor", "venv", ".venv", "env",
+    # Build outputs
+    "build", "dist", "out", "target", ".output", "_build",
+    # Framework caches
+    ".next", ".nuxt", ".svelte-kit", ".angular", ".turbo",
+    ".parcel-cache", ".cache", ".temp", ".tmp",
+    # IDE / editor
+    ".idea", ".vscode", ".vs",
+    # Python
+    "__pycache__", ".tox", ".mypy_cache", ".pytest_cache", ".ruff_cache",
+    # Testing
+    "coverage", ".nyc_output", "htmlcov",
+    # Misc
+    ".terraform", ".serverless",
+}
+
+EXCLUDE_EXTENSIONS = {
+    # Images
+    ".jpg", ".jpeg", ".png", ".gif", ".bmp", ".tiff", ".webp", ".ico", ".svg",
+    # Fonts
+    ".woff", ".woff2", ".ttf", ".eot", ".otf",
+    # Video / audio
+    ".mp4", ".webm", ".avi", ".mov", ".mp3", ".wav", ".ogg",
+    # Archives
+    ".zip", ".tar", ".gz", ".rar", ".7z",
+    # Documents
+    ".pdf", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx",
+    # Source maps
+    ".map",
+    # Compiled / binary
+    ".exe", ".dll", ".so", ".dylib", ".o", ".pyc", ".pyo", ".class",
+}
+
+EXCLUDE_FILES = {
+    "package-lock.json", "yarn.lock", "pnpm-lock.yaml",
+    "composer.lock", "Gemfile.lock", "poetry.lock",
+    ".DS_Store", "Thumbs.db", "desktop.ini",
+}
+
+MAX_SINGLE_FILE_BYTES = 2 * 1024 * 1024  # 2 MB
+
+
+# ── .gitignore parsing ────────────────────────────────────────────────────────
+
+def _load_gitignore_patterns(repo_root):
+    """
+    Reads .gitignore at the repo root and returns a list of patterns.
+    Supports basic glob patterns; does NOT implement full git-ignore spec
+    (negation, nested .gitignore, etc.) but covers the common cases.
+    """
+    gitignore_path = os.path.join(repo_root, ".gitignore")
+    patterns = []
+    if not os.path.isfile(gitignore_path):
+        return patterns
+    try:
+        with open(gitignore_path, "r", encoding="utf-8", errors="ignore") as f:
+            for line in f:
+                line = line.strip()
+                if not line or line.startswith("#"):
+                    continue
+                # Ignore negation patterns (!) for simplicity
+                if line.startswith("!"):
+                    continue
+                patterns.append(line.rstrip("/"))
+    except Exception:
+        pass
+    return patterns
+
+
+def _is_gitignored(rel_path, patterns):
+    """
+    Checks if a relative path matches any .gitignore pattern.
+    """
+    parts = rel_path.replace("\\", "/").split("/")
+    for pattern in patterns:
+        # Directory-level match: check each path component
+        for part in parts:
+            if fnmatch(part, pattern):
+                return True
+        # Full-path match
+        if fnmatch(rel_path.replace("\\", "/"), pattern):
+            return True
+        if fnmatch(rel_path.replace("\\", "/"), f"**/{pattern}"):
+            return True
+    return False
+
+
+# ── Core functions ────────────────────────────────────────────────────────────
+
+def detect_repo_root(start_path=None):
+    """
+    Traverses up from start_path to find a repository root containing 
+    package.json, pyproject.toml, ai.json, or .git.
+    """
+    if not start_path:
+        start_path = os.getcwd()
+
+    current = Path(start_path).resolve()
+
+    while current != current.parent:
+        if any((current / f).exists() for f in ["package.json", "pyproject.toml", "ai.json", ".git"]):
+            return current
+        current = current.parent
+
+    raise Exception("No repository root found.")
+
+
+def zip_repo(repo_root):
+    """
+    Creates a temporary ZIP archive of the repository with aggressive filtering:
+      - Excludes common dependency / build / cache directories
+      - Excludes binary, media, font, and archive files by extension
+      - Excludes lock files
+      - Skips files larger than 2 MB
+      - Respects .gitignore patterns at the repo root
+    """
+    temp_zip = tempfile.NamedTemporaryFile(delete=False, suffix=".zip")
+    temp_zip.close()
+
+    gitignore_patterns = _load_gitignore_patterns(str(repo_root))
+    file_count = 0
+    skipped_count = 0
+
+    with zipfile.ZipFile(temp_zip.name, "w", zipfile.ZIP_DEFLATED) as z:
+        for root, dirs, files in os.walk(repo_root):
+            # Prune excluded directories (in-place)
+            dirs[:] = [
+                d for d in dirs
+                if d not in EXCLUDE_DIRS
+                and not d.startswith(".")  # skip all hidden dirs (e.g. .env, .husky)
+                or d in {".github"}  # but keep .github
+            ]
+
+            for file in files:
+                full_path = os.path.join(root, file)
+                rel_path = os.path.relpath(full_path, repo_root).replace(os.sep, "/")
+
+                # Skip by exact filename
+                if file in EXCLUDE_FILES:
+                    skipped_count += 1
+                    continue
+
+                # Skip by extension
+                _, ext = os.path.splitext(file)
+                if ext.lower() in EXCLUDE_EXTENSIONS:
+                    skipped_count += 1
+                    continue
+
+                # Skip large files
+                try:
+                    if os.path.getsize(full_path) > MAX_SINGLE_FILE_BYTES:
+                        logger.debug(f"Skipping large file: {rel_path}")
+                        skipped_count += 1
+                        continue
+                except OSError:
+                    continue
+
+                # Skip .gitignore-matched paths
+                if gitignore_patterns and _is_gitignored(rel_path, gitignore_patterns):
+                    skipped_count += 1
+                    continue
+
+                z.write(full_path, rel_path)
+                file_count += 1
+
+    zip_size_mb = os.path.getsize(temp_zip.name) / (1024 * 1024)
+    logger.info(f"Zip created: {file_count} files, {zip_size_mb:.1f} MB (skipped {skipped_count})")
+
+    if zip_size_mb > 50:
+        logger.warning(
+            f"Zip file is {zip_size_mb:.1f} MB — upload may be slow or fail. "
+            "Consider adding large assets to .gitignore."
+        )
+
+    return temp_zip.name

{codedthemes_cli-0.1.0 → codedthemes_cli-0.1.2}/codedthemes/sync_manager.py

@@ -2,11 +2,11 @@ import os
 import json
 import hashlib
 from datetime import datetime
+from .repo_utils import EXCLUDE_DIRS
 
 class SyncManager:
     """
-    Manages local file hashes to identify what files the user changed manually.
-    Ensures `.codedthemes/workspace.json` is accurately tracked across CLI runs.
+    Manages local file hashes to track manual changes and maintain synchronization state.
     """
     def __init__(self):
         self.config_dir = os.path.expanduser("~/.codedthemes")
@@ -15,6 +15,9 @@ class SyncManager:
         self.workspaces = self.load()
         
     def load(self):
+        """
+        Loads the workspace synchronization state from the cloud config.
+        """
         if os.path.exists(self.config_file):
             try:
                 with open(self.config_file, 'r') as f: return json.load(f)
@@ -22,13 +25,19 @@ class SyncManager:
         return {}
         
     def save(self):
+        """
+        Saves the workspace synchronization state locally.
+        """
         with open(self.config_file, 'w') as f:
             json.dump(self.workspaces, f, indent=2)
 
     def compute_hashes(self, repo_path):
+        """
+        Computes MD5 hashes for all relevant files in the repository.
+        """
         hashes = {}
         for root, dirs, files in os.walk(repo_path):
-            dirs[:] = [d for d in dirs if d not in {'.git', 'node_modules', '__pycache__', 'venv', '.next', 'build', 'dist', 'out', '.cache', 'target', '.idea', '.vscode'}]
+            dirs[:] = [d for d in dirs if d not in EXCLUDE_DIRS]
             for file in files:
                 abs_path = os.path.join(root, file)
                 try:
@@ -41,6 +50,9 @@ class SyncManager:
         return hashes
 
     def update_sync_state(self, repo_path, workspace_id, user_id):
+        """
+        Updates the synchronization state with the latest file hashes.
+        """
         repo_key = f"{user_id}:{os.path.abspath(repo_path)}"
         self.workspaces[repo_key] = {
             "workspace_id": workspace_id,
@@ -51,6 +63,9 @@ class SyncManager:
         self.save()
 
     def get_changed_files(self, repo_path, user_id):
+        """
+        Identifies files that have been modified or deleted locally since the last sync.
+        """
         repo_key = f"{user_id}:{os.path.abspath(repo_path)}"
         if repo_key not in self.workspaces: return []
         

codedthemes_cli-0.1.2/codedthemes_cli.egg-info/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: codedthemes-cli
+Version: 0.1.2
+Summary: CLI tool for Code Theme and Integration
+Author: codedthemes
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: pyjwt
+
+# CodedThemes CLI
+
+CodedThemes CLI is a powerful command-line tool designed to integrate your local development environment with the CodedThemes MCP Server. It allows you to automate UI/UX modifications, refactor themes, and apply stylistic changes across your entire repository using AI-driven insights.
+
+## Features
+
+- **Automated Theming**: Apply complex theme changes (e.g., branding updates) with simple natural language queries.
+- **Local-to-Cloud Sync**: Securely sync your repository state to the CodedThemes engine for deep analysis.
+- **Seamless Integration**: Automatically patches local files with surgical precision.
+- **Sync Management**: Tracks local changes to ensure your manual edits are never overwritten.
+
+## Installation
+
+Install the CLI directly from PyPI:
+
+```bash
+pip install codedthemes-cli
+```
+
+## Usage
+
+### 1. Authentication
+
+Authenticate with your CodedThemes account to enable secure communication with the MCP server.
+
+```bash
+codedthemes login
+```
+*Enter your registered email and license key when prompted.*
+
+### 2. Initialization (Optional)
+
+Initialize your repository to establish a baseline for synchronization. This is recommended for first-time use in a project.
+
+```bash
+codedthemes init
+```
+
+### 3. Applying Changes
+
+Describe the changes you want to make in natural language. The CLI will analyze your repository, plan the changes, and ask for your approval before patching.
+
+```bash
+codedthemes apply "Update the theme branding from Mantis to Berry"
+```
+
+## Integration Report
+
+After every successful `apply`, a granular report is generated showing exactly which files were modified, created, or deleted.
+
+## Support
+
+For issues or feature requests, please contact the CodedThemes support team.

{codedthemes_cli-0.1.0 → codedthemes_cli-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codedthemes-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "CLI tool for Code Theme and Integration"
 readme = "README.md"
 requires-python = ">=3.10"

codedthemes_cli-0.1.0/PKG-INFO

@@ -1,49 +0,0 @@
-Metadata-Version: 2.4
-Name: codedthemes-cli
-Version: 0.1.0
-Summary: CLI tool for Code Theme and Integration
-Author: codedthemes
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: requests
-Requires-Dist: pyjwt
-
-# CodedThemes CLI
-
-The `codedthemes` CLI is a powerful command-line interface that allows you to interact with the CodeThemeMCP server. It enables you to analyze and modify your repositories using AI, with a focus on theme and style management.
-
-## Installation
-
-Install the CLI globally using pip:
-
-```bash
-pip install code-theme-mcp-cli
-```
-
-## Getting Started
-
-### 1. Login
-
-Before applying any changes, you must authenticate your session with the MCP Server.
-
-```bash
-codedthemes login
-```
-*You will be prompted to enter your Email and License key.*
-
-### 2. Apply Changes
-
-Navigate to your target project repository and run the `apply` command with your desired changes in quotes:
-
-```bash
-codedthemes apply "Update the theme branding from Mantis to Berry"
-```
-
-The CLI will automatically:
-1. Package and securely send your repository to the remote server for analysis.
-2. Plan the necessary code modifications using AI.
-3. Automatically apply the patches back to your local files.
-
-## Support
-
-For issues or feature requests, please contact the CodedThemes support team.

codedthemes_cli-0.1.0/README.md

@@ -1,39 +0,0 @@
-# CodedThemes CLI
-
-The `codedthemes` CLI is a powerful command-line interface that allows you to interact with the CodeThemeMCP server. It enables you to analyze and modify your repositories using AI, with a focus on theme and style management.
-
-## Installation
-
-Install the CLI globally using pip:
-
-```bash
-pip install code-theme-mcp-cli
-```
-
-## Getting Started
-
-### 1. Login
-
-Before applying any changes, you must authenticate your session with the MCP Server.
-
-```bash
-codedthemes login
-```
-*You will be prompted to enter your Email and License key.*
-
-### 2. Apply Changes
-
-Navigate to your target project repository and run the `apply` command with your desired changes in quotes:
-
-```bash
-codedthemes apply "Update the theme branding from Mantis to Berry"
-```
-
-The CLI will automatically:
-1. Package and securely send your repository to the remote server for analysis.
-2. Plan the necessary code modifications using AI.
-3. Automatically apply the patches back to your local files.
-
-## Support
-
-For issues or feature requests, please contact the CodedThemes support team.

codedthemes_cli-0.1.0/codedthemes/repo_utils.py

@@ -1,40 +0,0 @@
-import os
-import zipfile
-from pathlib import Path
-import tempfile
-
-
-def detect_repo_root(start_path=None):
-    if not start_path:
-        start_path = os.getcwd()
-
-    current = Path(start_path).resolve()
-
-    while current != current.parent:
-        if (current / "package.json").exists() or (current / "pyproject.toml").exists() or (current / "ai.json").exists() or (current / ".git").exists():
-            return current
-        current = current.parent
-
-    raise Exception("No repository root found.")
-
-
-def zip_repo(repo_root):
-    temp_zip = tempfile.NamedTemporaryFile(delete=False, suffix=".zip")
-    temp_zip.close() # Close so zipfile can open it
-
-    with zipfile.ZipFile(temp_zip.name, "w", zipfile.ZIP_DEFLATED) as z:
-        for root, dirs, files in os.walk(repo_root):
-            # Exclude heavy/build directories
-            exclude_dirs = {
-                "node_modules", ".git", "venv", ".next", "build", "dist", 
-                "out", ".cache", "target", ".idea", ".vscode", "__pycache__"
-            }
-            dirs[:] = [d for d in dirs if d not in exclude_dirs]
-
-            for file in files:
-                full_path = os.path.join(root, file)
-                # FORCE FORWARD SLASHES for zip entry names to ensure Linux compatibility
-                rel_path = os.path.relpath(full_path, repo_root).replace(os.sep, '/')
-                z.write(full_path, rel_path)
-
-    return temp_zip.name

codedthemes_cli-0.1.0/codedthemes_cli.egg-info/PKG-INFO

@@ -1,49 +0,0 @@
-Metadata-Version: 2.4
-Name: codedthemes-cli
-Version: 0.1.0
-Summary: CLI tool for Code Theme and Integration
-Author: codedthemes
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: requests
-Requires-Dist: pyjwt
-
-# CodedThemes CLI
-
-The `codedthemes` CLI is a powerful command-line interface that allows you to interact with the CodeThemeMCP server. It enables you to analyze and modify your repositories using AI, with a focus on theme and style management.
-
-## Installation
-
-Install the CLI globally using pip:
-
-```bash
-pip install code-theme-mcp-cli
-```
-
-## Getting Started
-
-### 1. Login
-
-Before applying any changes, you must authenticate your session with the MCP Server.
-
-```bash
-codedthemes login
-```
-*You will be prompted to enter your Email and License key.*
-
-### 2. Apply Changes
-
-Navigate to your target project repository and run the `apply` command with your desired changes in quotes:
-
-```bash
-codedthemes apply "Update the theme branding from Mantis to Berry"
-```
-
-The CLI will automatically:
-1. Package and securely send your repository to the remote server for analysis.
-2. Plan the necessary code modifications using AI.
-3. Automatically apply the patches back to your local files.
-
-## Support
-
-For issues or feature requests, please contact the CodedThemes support team.