weco 0.3.9__py3-none-any.whl → 0.3.11__py3-none-any.whl

weco/cli.py

@@ -185,10 +185,30 @@ def configure_credits_parser(credits_parser: argparse.ArgumentParser) -> None:
     )
 
 
+def _add_setup_source_args(parser: argparse.ArgumentParser) -> None:
+    """Add common source arguments to a setup subparser."""
+    source_group = parser.add_mutually_exclusive_group()
+    source_group.add_argument(
+        "--local", type=str, metavar="PATH", help="Use a local weco-skill directory (creates symlink for development)"
+    )
+    source_group.add_argument("--repo", type=str, metavar="URL", help="Use a different git repo URL (for forks or testing)")
+    parser.add_argument(
+        "--ref",
+        type=str,
+        metavar="REF",
+        help="Checkout a specific branch, tag, or commit hash (used with git clone, not --local)",
+    )
+
+
 def configure_setup_parser(setup_parser: argparse.ArgumentParser) -> None:
     """Configure the setup command parser and its subcommands."""
     setup_subparsers = setup_parser.add_subparsers(dest="tool", help="AI tool to set up")
-    setup_subparsers.add_parser("claude-code", help="Set up Weco skill for Claude Code")
+
+    claude_parser = setup_subparsers.add_parser("claude-code", help="Set up Weco skill for Claude Code")
+    _add_setup_source_args(claude_parser)
+
+    cursor_parser = setup_subparsers.add_parser("cursor", help="Set up Weco rules for Cursor")
+    _add_setup_source_args(cursor_parser)
 
 
 def configure_resume_parser(resume_parser: argparse.ArgumentParser) -> None:

weco/git.py

@@ -0,0 +1,121 @@
+# weco/git.py
+"""
+Git utilities for command execution and validation.
+"""
+
+import pathlib
+import shutil
+import subprocess
+
+
+class GitError(Exception):
+    """Raised when a git command fails."""
+
+    def __init__(self, message: str, stderr: str = ""):
+        super().__init__(message)
+        self.stderr = stderr
+
+
+class GitNotFoundError(Exception):
+    """Raised when git is not available on the system."""
+
+    pass
+
+
+def is_available() -> bool:
+    """Check if git is available on the system."""
+    return shutil.which("git") is not None
+
+
+def is_repo(path: pathlib.Path) -> bool:
+    """Check if a directory is a git repository."""
+    return (path / ".git").is_dir()
+
+
+def validate_ref(ref: str) -> None:
+    """
+    Validate a git ref to prevent option injection.
+
+    Raises:
+        ValueError: If ref could be interpreted as a git option.
+    """
+    if ref.startswith("-"):
+        raise ValueError(f"Invalid git ref: {ref!r} (cannot start with '-')")
+
+
+def validate_repo_url(url: str) -> None:
+    """
+    Validate a git repository URL.
+
+    Raises:
+        ValueError: If URL doesn't match expected patterns.
+    """
+    valid_prefixes = ("git@", "https://", "http://", "ssh://", "file://", "/", "./", "../")
+    if not any(url.startswith(prefix) for prefix in valid_prefixes):
+        raise ValueError(f"Invalid repository URL: {url!r}")
+
+
+def run(*args: str, cwd: pathlib.Path | None = None, error_msg: str = "Git command failed") -> subprocess.CompletedProcess:
+    """
+    Run a git command and return the result.
+
+    Args:
+        *args: Git subcommand and arguments (e.g., "clone", url, path).
+               Do NOT include "git" — it's prepended automatically.
+        cwd: Working directory for the command.
+        error_msg: Message to include in exception on failure.
+
+    Raises:
+        GitError: If the command fails or returns non-zero.
+    """
+    cmd = ["git", *args]
+    try:
+        result = subprocess.run(cmd, cwd=cwd, capture_output=True, text=True)
+    except Exception as e:
+        raise GitError(f"{error_msg}: {e}") from e
+
+    if result.returncode != 0:
+        raise GitError(error_msg, result.stderr)
+    return result
+
+
+def clone(repo_url: str, dest: pathlib.Path, ref: str | None = None) -> None:
+    """
+    Clone a git repository.
+
+    Args:
+        repo_url: The repository URL to clone.
+        dest: Destination directory.
+        ref: Optional branch, tag, or commit to checkout after cloning.
+
+    Raises:
+        GitError: If clone or checkout fails.
+    """
+    run("clone", repo_url, str(dest), error_msg="Failed to clone repository")
+    if ref:
+        run("checkout", ref, cwd=dest, error_msg=f"Failed to checkout '{ref}'")
+
+
+def pull(repo_path: pathlib.Path) -> None:
+    """
+    Pull latest changes in a git repository.
+
+    Raises:
+        GitError: If pull fails.
+    """
+    run("pull", cwd=repo_path, error_msg="Failed to pull repository")
+
+
+def fetch_and_checkout(repo_path: pathlib.Path, ref: str) -> None:
+    """
+    Fetch all remotes and checkout a specific ref.
+
+    Args:
+        repo_path: Path to the git repository.
+        ref: Branch, tag, or commit to checkout.
+
+    Raises:
+        GitError: If fetch or checkout fails.
+    """
+    run("fetch", "--all", cwd=repo_path, error_msg="Failed to fetch from repository")
+    run("checkout", ref, cwd=repo_path, error_msg=f"Failed to checkout '{ref}'")

weco/setup.py

@@ -4,189 +4,292 @@ Setup commands for integrating Weco with various AI tools.
 """
 
 import pathlib
-import shutil
-import subprocess
+import sys
+
 from rich.console import Console
 from rich.prompt import Confirm
 
+from . import git
+from .utils import copy_directory, copy_file, read_from_path, remove_directory, write_to_path
+
+
+# =============================================================================
+# Exceptions
+# =============================================================================
+
+
+class SetupError(Exception):
+    """Base exception for setup failures."""
+
+    pass
+
+
+class InvalidLocalRepoError(SetupError):
+    """Raised when a local path is not a valid skill repository."""
+
+    pass
+
+
+# =============================================================================
+# Path constants
+# =============================================================================
+
 # Claude Code paths
 CLAUDE_DIR = pathlib.Path.home() / ".claude"
 CLAUDE_SKILLS_DIR = CLAUDE_DIR / "skills"
-CLAUDE_MD_PATH = CLAUDE_DIR / "CLAUDE.md"
 WECO_SKILL_DIR = CLAUDE_SKILLS_DIR / "weco"
 WECO_SKILL_REPO = "git@github.com:WecoAI/weco-skill.git"
+WECO_CLAUDE_SNIPPET_PATH = WECO_SKILL_DIR / "snippets" / "claude.md"
+WECO_CLAUDE_MD_PATH = WECO_SKILL_DIR / "CLAUDE.md"
+
+# Cursor paths
+CURSOR_DIR = pathlib.Path.home() / ".cursor"
+CURSOR_RULES_DIR = CURSOR_DIR / "rules"
+CURSOR_WECO_RULES_PATH = CURSOR_RULES_DIR / "weco.mdc"
+CURSOR_SKILLS_DIR = CURSOR_DIR / "skills"
+CURSOR_WECO_SKILL_DIR = CURSOR_SKILLS_DIR / "weco"
+CURSOR_RULES_SNIPPET_PATH = CURSOR_WECO_SKILL_DIR / "snippets" / "cursor.md"
+
+# Files/directories to skip when copying local repos
+_COPY_IGNORE_PATTERNS = {".git", "__pycache__", ".DS_Store"}
 
-CLAUDE_MD_SECTION = """
-# Weco Code Optimization
 
-  When users ask to optimize code against a measurable metric (speed, accuracy, loss, latency, F1, etc.), use Weco. Read
-  `~/.claude/skills/weco/CLAUDE.md` for the full workflow.
+# =============================================================================
+# Domain helpers
+# =============================================================================
 
-  **Trigger phrases**: "make faster", "speed up", "optimize", "improve performance", "improve accuracy", "reduce loss",
-  "optimize kernel", "improve prompt"
 
-  **Do NOT** manually optimize - Weco's AI search achieves better results.
+def generate_cursor_mdc_content(snippet_content: str) -> str:
+    """Generate Cursor MDC file content with YAML frontmatter."""
+    return f"""---
+description: Weco code optimization skill. Weco automates optimization by iteratively refining code against any metric you define — invoke for speed, accuracy, latency, cost, or anything else you can measure.
+alwaysApply: true
+---
+{snippet_content}
 """
 
 
-def is_git_available() -> bool:
-    """Check if git is available on the system."""
-    return shutil.which("git") is not None
+def validate_local_skill_repo(local_path: pathlib.Path) -> None:
+    """
+    Validate that a local path is a valid weco-skill repository.
+
+    Raises:
+        InvalidLocalRepoError: If validation fails.
+    """
+    if not local_path.exists():
+        raise InvalidLocalRepoError(f"Local path does not exist: {local_path}")
+    if not local_path.is_dir():
+        raise InvalidLocalRepoError(f"Local path is not a directory: {local_path}")
+    if not (local_path / "SKILL.md").exists():
+        raise InvalidLocalRepoError(
+            f"Local path does not appear to be a weco-skill repository (expected SKILL.md at {local_path / 'SKILL.md'})"
+        )
 
 
-def is_git_repo(path: pathlib.Path) -> bool:
-    """Check if a directory is a git repository."""
-    return (path / ".git").is_dir()
+# =============================================================================
+# Installation functions
+# =============================================================================
 
 
-def clone_skill_repo(console: Console) -> bool:
+def install_skill_from_git(skill_dir: pathlib.Path, console: Console, repo_url: str | None, ref: str | None) -> None:
     """
-    Clone or update the weco-skill repository.
+    Clone or update skill from git.
 
-    Returns:
-        True if successful, False otherwise.
+    Raises:
+        git.GitNotFoundError: If git is not available.
+        git.GitError: If git operations fail.
     """
-    if not is_git_available():
-        console.print("[bold red]Error:[/] git is not installed or not in PATH.")
-        console.print("Please install git and try again.")
-        return False
-
-    # Ensure the skills directory exists
-    CLAUDE_SKILLS_DIR.mkdir(parents=True, exist_ok=True)
-
-    if WECO_SKILL_DIR.exists():
-        if is_git_repo(WECO_SKILL_DIR):
-            # Directory exists and is a git repo - pull latest
-            console.print(f"[cyan]Updating existing skill at {WECO_SKILL_DIR}...[/]")
-            try:
-                result = subprocess.run(["git", "pull"], cwd=WECO_SKILL_DIR, capture_output=True, text=True)
-                if result.returncode != 0:
-                    console.print("[bold red]Error:[/] Failed to update skill repository.")
-                    console.print(f"[dim]{result.stderr}[/]")
-                    return False
+    if not git.is_available():
+        raise git.GitNotFoundError("git is not installed or not in PATH")
+
+    skill_dir.parent.mkdir(parents=True, exist_ok=True)
+
+    if skill_dir.exists():
+        if git.is_repo(skill_dir):
+            console.print(f"[cyan]Updating existing skill at {skill_dir}...[/]")
+            if ref:
+                git.fetch_and_checkout(skill_dir, ref)
+                console.print(f"[green]Checked out {ref}.[/]")
+            else:
+                git.pull(skill_dir)
                 console.print("[green]Skill updated successfully.[/]")
-                return True
-            except Exception as e:
-                console.print(f"[bold red]Error:[/] Failed to update skill repository: {e}")
-                return False
-        else:
-            # Directory exists but is not a git repo
-            console.print(f"[bold red]Error:[/] Directory {WECO_SKILL_DIR} exists but is not a git repository.")
-            console.print("Please remove it manually and try again.")
-            return False
+            return
+
+        # Not a git repo — clear and re-clone
+        console.print(f"[cyan]Removing existing directory at {skill_dir}...[/]")
+        remove_directory(skill_dir)
+
+    console.print(f"[cyan]Cloning Weco skill to {skill_dir}...[/]")
+    git.clone(repo_url or WECO_SKILL_REPO, skill_dir, ref=ref)
+    if ref:
+        console.print(f"[green]Cloned and checked out {ref}.[/]")
     else:
-        # Clone the repository
-        console.print(f"[cyan]Cloning Weco skill to {WECO_SKILL_DIR}...[/]")
-        try:
-            result = subprocess.run(["git", "clone", WECO_SKILL_REPO, str(WECO_SKILL_DIR)], capture_output=True, text=True)
-            if result.returncode != 0:
-                console.print("[bold red]Error:[/] Failed to clone skill repository.")
-                console.print(f"[dim]{result.stderr}[/]")
-                return False
-            console.print("[green]Skill cloned successfully.[/]")
-            return True
-        except Exception as e:
-            console.print(f"[bold red]Error:[/] Failed to clone skill repository: {e}")
-            return False
-
-
-def update_claude_md(console: Console) -> bool:
+        console.print("[green]Skill cloned successfully.[/]")
+
+
+def install_skill_from_local(skill_dir: pathlib.Path, console: Console, local_path: pathlib.Path) -> None:
     """
-    Update the user's CLAUDE.md file with the Weco skill reference.
+    Copy skill from local path.
 
-    Returns:
-        True if updated or user declined, False on error.
+    Raises:
+        InvalidLocalRepoError: If local path is invalid.
+        OSError: If copy fails.
     """
-    # Check if the section already exists
-    if CLAUDE_MD_PATH.exists():
-        try:
-            content = CLAUDE_MD_PATH.read_text()
-            if "~/.claude/skills/weco/CLAUDE.md" in content:
-                console.print("[dim]CLAUDE.md already contains the Weco skill reference.[/]")
-                return True
-        except Exception as e:
-            console.print(f"[bold yellow]Warning:[/] Could not read CLAUDE.md: {e}")
-
-    # Prompt user for permission
-    if CLAUDE_MD_PATH.exists():
-        console.print("\n[bold yellow]CLAUDE.md Update[/]")
-        console.print("To enable automatic skill discovery, we can add a reference to your CLAUDE.md file.")
-        should_update = Confirm.ask(
-            "Would you like to update your CLAUDE.md to enable automatic skill discovery?", default=True
-        )
+    validate_local_skill_repo(local_path)
+
+    skill_dir.parent.mkdir(parents=True, exist_ok=True)
+
+    if skill_dir.exists():
+        console.print(f"[cyan]Removing existing directory at {skill_dir}...[/]")
+        remove_directory(skill_dir)
+
+    copy_directory(local_path, skill_dir, ignore_patterns=_COPY_IGNORE_PATTERNS)
+    console.print(f"[green]Copied local repo from: {local_path}[/]")
+
+
+def install_skill(
+    skill_dir: pathlib.Path, console: Console, local_path: pathlib.Path | None, repo_url: str | None, ref: str | None
+) -> None:
+    """Install skill by copying from local path or cloning from git."""
+    if local_path:
+        if ref:
+            console.print("[bold yellow]Warning:[/] --ref is ignored when using --local")
+        install_skill_from_local(skill_dir, console, local_path)
     else:
-        console.print("\n[bold yellow]CLAUDE.md Creation[/]")
-        console.print("To enable automatic skill discovery, we can create a CLAUDE.md file.")
-        should_update = Confirm.ask("Would you like to create CLAUDE.md to enable automatic skill discovery?", default=True)
-
-    if not should_update:
-        console.print("\n[yellow]Skipping CLAUDE.md update.[/]")
-        console.print(
-            "[dim]The Weco skill has been installed but may not be discovered automatically.\n"
-            f"You can manually reference it at {WECO_SKILL_DIR}/CLAUDE.md[/]"
-        )
-        return True
+        install_skill_from_git(skill_dir, console, repo_url, ref)
 
-    # Update or create the file
-    try:
-        CLAUDE_DIR.mkdir(parents=True, exist_ok=True)
-
-        if CLAUDE_MD_PATH.exists():
-            # Append to existing file
-            with open(CLAUDE_MD_PATH, "a") as f:
-                f.write(CLAUDE_MD_SECTION)
-            console.print("[green]CLAUDE.md updated successfully.[/]")
-        else:
-            # Create new file
-            with open(CLAUDE_MD_PATH, "w") as f:
-                f.write(CLAUDE_MD_SECTION.lstrip())
-            console.print("[green]CLAUDE.md created successfully.[/]")
-        return True
-    except Exception as e:
-        console.print(f"[bold red]Error:[/] Failed to update CLAUDE.md: {e}")
-        return False
-
-
-def setup_claude_code(console: Console) -> bool:
-    """
-    Set up Weco skill for Claude Code.
 
-    Returns:
-        True if setup was successful, False otherwise.
-    """
+# =============================================================================
+# Setup commands
+# =============================================================================
+
+
+def setup_claude_code(
+    console: Console, local_path: pathlib.Path | None = None, repo_url: str | None = None, ref: str | None = None
+) -> None:
+    """Set up Weco skill for Claude Code."""
     console.print("[bold blue]Setting up Weco for Claude Code...[/]\n")
 
-    # Step 1: Clone or update the skill repository
-    if not clone_skill_repo(console):
-        return False
+    # Claude Code setup is intentionally "skill-centric":
+    # - Install the skill into Claude's skills directory.
+    # - `CLAUDE.md` lives *inside* that installed skill folder, so configuration is just
+    #   copying a file within the skill directory.
+    # - There is no separate global config file to reconcile or prompt before overwriting.
+    install_skill(WECO_SKILL_DIR, console, local_path, repo_url, ref)
 
-    # Step 2: Update CLAUDE.md
-    if not update_claude_md(console):
-        return False
+    # Copy snippets/claude.md to CLAUDE.md (skip for local - user manages their own)
+    if not local_path:
+        copy_file(WECO_CLAUDE_SNIPPET_PATH, WECO_CLAUDE_MD_PATH)
+        console.print("[green]CLAUDE.md installed to skill directory.[/]")
 
     console.print("\n[bold green]Setup complete![/]")
+    if local_path:
+        console.print(f"[dim]Skill copied from: {local_path}[/]")
     console.print(f"[dim]Skill installed at: {WECO_SKILL_DIR}[/]")
-    return True
+
+
+def setup_cursor(
+    console: Console, local_path: pathlib.Path | None = None, repo_url: str | None = None, ref: str | None = None
+) -> None:
+    """Set up Weco rules for Cursor."""
+    console.print("[bold blue]Setting up Weco for Cursor...[/]\n")
+
+    # Cursor setup is intentionally "editor-config-centric":
+    # - Install/copy the skill into Cursor's skills directory (so we can read snippets).
+    # - The behavior change is controlled by `~/.cursor/rules/weco.mdc`, which is *global*
+    #   editor state (not part of the installed skill folder).
+    # - Because users may have customized that file, we:
+    #   1) compute desired content from the snippet
+    #   2) check if it is already up to date
+    #   3) prompt before creating/updating it
+    install_skill(CURSOR_WECO_SKILL_DIR, console, local_path, repo_url, ref)
+
+    snippet_content = read_from_path(CURSOR_RULES_SNIPPET_PATH)
+    mdc_content = generate_cursor_mdc_content(snippet_content.strip())
+
+    # Check if already up to date
+    existing_content = None
+    if CURSOR_WECO_RULES_PATH.exists():
+        try:
+            existing_content = read_from_path(CURSOR_WECO_RULES_PATH)
+        except Exception:
+            pass
+
+    if existing_content is not None and existing_content.strip() == mdc_content.strip():
+        console.print("[dim]weco.mdc already contains the latest Weco rules.[/]")
+        console.print("\n[bold green]Setup complete![/]")
+        console.print(f"[dim]Rules file at: {CURSOR_WECO_RULES_PATH}[/]")
+        return
+
+    # Prompt user for creation/update
+    if existing_content is not None:
+        console.print("\n[bold yellow]weco.mdc Update[/]")
+        console.print("The Weco rules file can be updated to the latest version.")
+        if not Confirm.ask("Would you like to update weco.mdc?", default=True):
+            console.print("\n[yellow]Skipping weco.mdc update.[/]")
+            console.print(f"[dim]Skill installed but rules not configured. Create manually at {CURSOR_WECO_RULES_PATH}[/]")
+            return
+    else:
+        console.print("\n[bold yellow]weco.mdc Creation[/]")
+        console.print("To enable Weco optimization rules, we can create a weco.mdc file.")
+        if not Confirm.ask("Would you like to create weco.mdc?", default=True):
+            console.print("\n[yellow]Skipping weco.mdc creation.[/]")
+            console.print(f"[dim]Skill installed but rules not configured. Create manually at {CURSOR_WECO_RULES_PATH}[/]")
+            return
+
+    write_to_path(CURSOR_WECO_RULES_PATH, mdc_content, mkdir=True)
+    console.print("[green]weco.mdc created successfully.[/]")
+
+    console.print("\n[bold green]Setup complete![/]")
+    if local_path:
+        console.print(f"[dim]Skill copied from: {local_path}[/]")
+    console.print(f"[dim]Skill installed at: {CURSOR_WECO_SKILL_DIR}[/]")
+    console.print(f"[dim]Rules file at: {CURSOR_WECO_RULES_PATH}[/]")
+
+
+# =============================================================================
+# CLI entry point
+# =============================================================================
+
+SETUP_HANDLERS = {"claude-code": setup_claude_code, "cursor": setup_cursor}
 
 
 def handle_setup_command(args, console: Console) -> None:
     """Handle the setup command with its subcommands."""
-    if args.tool == "claude-code":
-        success = setup_claude_code(console)
-        if not success:
-            import sys
+    available_tools = ", ".join(SETUP_HANDLERS)
 
-            sys.exit(1)
-    elif args.tool is None:
+    if args.tool is None:
         console.print("[bold red]Error:[/] Please specify a tool to set up.")
-        console.print("Available tools: claude-code")
-        console.print("\nUsage: weco setup claude-code")
-        import sys
-
+        console.print(f"Available tools: {available_tools}")
+        console.print("\nUsage: weco setup <tool>")
         sys.exit(1)
-    else:
+
+    handler = SETUP_HANDLERS.get(args.tool)
+    if handler is None:
         console.print(f"[bold red]Error:[/] Unknown tool: {args.tool}")
-        console.print("Available tools: claude-code")
-        import sys
+        console.print(f"Available tools: {available_tools}")
+        sys.exit(1)
+
+    # Validate and extract args
+    repo_url = getattr(args, "repo", None)
+    ref = getattr(args, "ref", None)
+    local_path = None
+    if hasattr(args, "local") and args.local:
+        local_path = pathlib.Path(args.local).expanduser().resolve()
+
+    try:
+        if repo_url:
+            git.validate_repo_url(repo_url)
+        if ref:
+            git.validate_ref(ref)
+
+        handler(console, local_path=local_path, repo_url=repo_url, ref=ref)
 
+    except git.GitError as e:
+        console.print(f"[bold red]Error:[/] {e}")
+        if e.stderr:
+            console.print(f"[dim]{e.stderr}[/]")
+        sys.exit(1)
+    except (SetupError, git.GitNotFoundError, FileNotFoundError, OSError, ValueError) as e:
+        console.print(f"[bold red]Error:[/] {e}")
         sys.exit(1)

weco/utils.py

@@ -1,5 +1,6 @@
 from typing import Any, Dict, List, Tuple, Union
 import json
+import shutil
 import time
 import subprocess
 import psutil
@@ -63,8 +64,19 @@ def read_from_path(fp: pathlib.Path, is_json: bool = False) -> Union[str, Dict[s
         return f.read()
 
 
-def write_to_path(fp: pathlib.Path, content: Union[str, Dict[str, Any]], is_json: bool = False) -> None:
-    """Write content to a file path, optionally as JSON."""
+def write_to_path(fp: pathlib.Path, content: Union[str, Dict[str, Any]], is_json: bool = False, mkdir: bool = False) -> None:
+    """
+    Write content to a file path, optionally as JSON.
+
+    Args:
+        fp: File path to write to.
+        content: Content to write (string or dict for JSON).
+        is_json: If True, write as JSON.
+        mkdir: If True, create parent directories if they don't exist.
+    """
+    if mkdir:
+        fp.parent.mkdir(parents=True, exist_ok=True)
+
     with fp.open("w", encoding="utf-8") as f:
         if is_json:
             json.dump(content, f, indent=4)
@@ -74,6 +86,60 @@ def write_to_path(fp: pathlib.Path, content: Union[str, Dict[str, Any]], is_json
             raise TypeError("Error writing to file. Please verify the file path and try again.")
 
 
+def copy_file(src: pathlib.Path, dest: pathlib.Path, mkdir: bool = False) -> None:
+    """
+    Copy a single file.
+
+    Args:
+        src: Source file path.
+        dest: Destination file path.
+        mkdir: If True, create parent directories if they don't exist.
+
+    Raises:
+        FileNotFoundError: If source doesn't exist.
+        OSError: If copy fails.
+    """
+    if not src.exists():
+        raise FileNotFoundError(f"Source file not found: {src}")
+    if mkdir:
+        dest.parent.mkdir(parents=True, exist_ok=True)
+    shutil.copy(src, dest)
+
+
+def copy_directory(src: pathlib.Path, dest: pathlib.Path, ignore_patterns: set[str] | None = None) -> None:
+    """
+    Copy a directory tree.
+
+    Args:
+        src: Source directory path.
+        dest: Destination directory path.
+        ignore_patterns: Optional set of file/directory names to skip.
+
+    Raises:
+        FileNotFoundError: If source doesn't exist.
+        OSError: If copy fails.
+    """
+    if not src.exists():
+        raise FileNotFoundError(f"Source directory not found: {src}")
+
+    def ignore_func(_: str, files: list[str]) -> list[str]:
+        if not ignore_patterns:
+            return []
+        return [f for f in files if f in ignore_patterns]
+
+    shutil.copytree(src, dest, ignore=ignore_func)
+
+
+def remove_directory(path: pathlib.Path) -> None:
+    """
+    Remove a directory and all its contents.
+
+    Does nothing if the directory doesn't exist.
+    """
+    if path.exists():
+        shutil.rmtree(path)
+
+
 # Visualization helper functions
 def smooth_update(
     live: Live, layout: Layout, sections_to_update: List[Tuple[str, Panel]], transition_delay: float = 0.05

{weco-0.3.9.dist-info → weco-0.3.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: weco
-Version: 0.3.9
+Version: 0.3.11
 Summary: Documentation for `weco`, a CLI for using Weco AI's code optimizer.
 Author-email: Weco AI Team <contact@weco.ai>
 License: 
@@ -347,14 +347,17 @@ For more advanced examples, including [Triton](/examples/triton/README.md), [CUD
 | Command | Description |
 |---------|-------------|
 | `weco setup claude-code` | Set up Weco skill for Claude Code |
+| `weco setup cursor` | Set up Weco rules for Cursor |
 
-The `setup` command installs Weco skills for AI coding assistants. Currently supports Claude Code:
+The `setup` command installs Weco skills for AI coding assistants:
 
 ```bash
-weco setup claude-code
+weco setup claude-code  # For Claude Code
+weco setup cursor       # For Cursor
 ```
 
-This clones the Weco skill to `~/.claude/skills/weco/` and optionally updates your `~/.claude/CLAUDE.md` to enable automatic skill discovery.
+- **Claude Code**: Clones the Weco skill to `~/.claude/skills/weco/` and updates `~/.claude/CLAUDE.md`
+- **Cursor**: Clones the Weco skill to `~/.cursor/skills/weco/` and creates `~/.cursor/rules/weco.mdc`
 
 ### Model Selection
 

weco-0.3.11.dist-info/RECORD

@@ -0,0 +1,20 @@
+weco/__init__.py,sha256=ClO0uT6GKOA0iSptvP0xbtdycf0VpoPTq37jHtvlhtw,303
+weco/api.py,sha256=hy0D01x-AJ26DURtKEywQAS7nQgo38A-wAJfPKHGGqM,17395
+weco/auth.py,sha256=O31Hoj-Loi8DWJJG2LfeWgUMuNqAUeGDpd2ZGjA9Ah0,9997
+weco/browser.py,sha256=nsqQtLqbNOe9Zhu9Zogc8rMmBMyuDxuHzKZQL_w10Ps,923
+weco/cli.py,sha256=6JDMZ6jNyqaTlzbabzaCxK_UpImh818wabNI5kBsh6M,14775
+weco/constants.py,sha256=rxL6yrpIzK8zvPTmPqOYl7LUMZ01vUJ9zUqfZD2n-0U,519
+weco/credits.py,sha256=C08x-TRcLg3ccfKqMGNRY7zBn7t3r7LZ119bxgfztaI,7629
+weco/git.py,sha256=j7JI9nzB7jqEACBsQflU5h4l2bOlg5oWVyEmZ0-ORkI,3377
+weco/optimizer.py,sha256=l9TrAsie5yPbhq71kStW5jfdz9jfIXuN6Azdn6hUMZo,25224
+weco/panels.py,sha256=POHt0MdRKDykwUJYXcry92O41lpB9gxna55wFI9abWU,16272
+weco/setup.py,sha256=wh_yFrTML_Qt5QDhhaDyIJQccxId8p_1DjmWYxDq9hc,11393
+weco/ui.py,sha256=Y7ASIQydwuYFdSYrvme5aGvkplFMi-cjhsnCj5Ebgoc,15092
+weco/utils.py,sha256=5MpUFoydk_AFkzZRQQH5ddPA6G_3YI7ocNQBaFXHy6o,11283
+weco/validation.py,sha256=n5aDuF3BFgwVb4eZ9PuU48nogrseXYNI8S3ePqWZCoc,3736
+weco-0.3.11.dist-info/licenses/LICENSE,sha256=9LUfoGHjLPtak2zps2kL2tm65HAZIICx_FbLaRuS4KU,11337
+weco-0.3.11.dist-info/METADATA,sha256=_zThzvB4LDG0REEW_hCMGzsVgXRnNAG-xRZ3o3RBipU,30804
+weco-0.3.11.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+weco-0.3.11.dist-info/entry_points.txt,sha256=ixJ2uClALbCpBvnIR6BXMNck8SHAab8eVkM9pIUowcs,39
+weco-0.3.11.dist-info/top_level.txt,sha256=F0N7v6e2zBSlsorFv-arAq2yDxQbzX3KVO8GxYhPUeE,5
+weco-0.3.11.dist-info/RECORD,,

weco-0.3.9.dist-info/RECORD

@@ -1,19 +0,0 @@
-weco/__init__.py,sha256=ClO0uT6GKOA0iSptvP0xbtdycf0VpoPTq37jHtvlhtw,303
-weco/api.py,sha256=hy0D01x-AJ26DURtKEywQAS7nQgo38A-wAJfPKHGGqM,17395
-weco/auth.py,sha256=O31Hoj-Loi8DWJJG2LfeWgUMuNqAUeGDpd2ZGjA9Ah0,9997
-weco/browser.py,sha256=nsqQtLqbNOe9Zhu9Zogc8rMmBMyuDxuHzKZQL_w10Ps,923
-weco/cli.py,sha256=zPWQa2UU19ClzTtIvsXuYmo7E9xm50wUzY2fU8iwcro,13921
-weco/constants.py,sha256=rxL6yrpIzK8zvPTmPqOYl7LUMZ01vUJ9zUqfZD2n-0U,519
-weco/credits.py,sha256=C08x-TRcLg3ccfKqMGNRY7zBn7t3r7LZ119bxgfztaI,7629
-weco/optimizer.py,sha256=l9TrAsie5yPbhq71kStW5jfdz9jfIXuN6Azdn6hUMZo,25224
-weco/panels.py,sha256=POHt0MdRKDykwUJYXcry92O41lpB9gxna55wFI9abWU,16272
-weco/setup.py,sha256=UWlJNfNvxmET3ZrhaJxQFrtZCMSyjp4HC8d6h1ndaC4,7078
-weco/ui.py,sha256=Y7ASIQydwuYFdSYrvme5aGvkplFMi-cjhsnCj5Ebgoc,15092
-weco/utils.py,sha256=v_rvgw-ktRoXrpPA2copngI8QDCB8UXmbiN-wAiYvEE,9450
-weco/validation.py,sha256=n5aDuF3BFgwVb4eZ9PuU48nogrseXYNI8S3ePqWZCoc,3736
-weco-0.3.9.dist-info/licenses/LICENSE,sha256=9LUfoGHjLPtak2zps2kL2tm65HAZIICx_FbLaRuS4KU,11337
-weco-0.3.9.dist-info/METADATA,sha256=dry9z1fIVdbnCdRy8i-0Xu3SClyAZNPBCdl-hDyL6MM,30660
-weco-0.3.9.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-weco-0.3.9.dist-info/entry_points.txt,sha256=ixJ2uClALbCpBvnIR6BXMNck8SHAab8eVkM9pIUowcs,39
-weco-0.3.9.dist-info/top_level.txt,sha256=F0N7v6e2zBSlsorFv-arAq2yDxQbzX3KVO8GxYhPUeE,5
-weco-0.3.9.dist-info/RECORD,,