cldpm 0.1.0__py3-none-any.whl

cldpm/utils/fs.py

@@ -0,0 +1,97 @@
+"""File system utility functions."""
+
+from pathlib import Path
+from typing import Optional
+
+
+def find_repo_root(start_path: Optional[Path] = None) -> Optional[Path]:
+    """Find the root of a CLDPM mono repo by looking for cldpm.json.
+
+    Args:
+        start_path: Starting directory to search from. Defaults to current directory.
+
+    Returns:
+        Path to the repo root, or None if not found.
+    """
+    if start_path is None:
+        start_path = Path.cwd()
+
+    current = start_path.resolve()
+
+    while current != current.parent:
+        if (current / "cldpm.json").exists():
+            return current
+        current = current.parent
+
+    # Check root directory
+    if (current / "cldpm.json").exists():
+        return current
+
+    return None
+
+
+def ensure_dir(path: Path) -> Path:
+    """Ensure a directory exists, creating it if necessary.
+
+    Args:
+        path: Path to the directory.
+
+    Returns:
+        The path to the directory.
+    """
+    path.mkdir(parents=True, exist_ok=True)
+    return path
+
+
+def is_symlink(path: Path) -> bool:
+    """Check if a path is a symlink.
+
+    Args:
+        path: Path to check.
+
+    Returns:
+        True if the path is a symlink, False otherwise.
+    """
+    return path.is_symlink()
+
+
+def remove_symlinks_in_dir(directory: Path) -> None:
+    """Remove all symlinks in a directory.
+
+    Args:
+        directory: Directory to clean.
+    """
+    if not directory.exists():
+        return
+
+    for item in directory.iterdir():
+        if item.is_symlink():
+            item.unlink()
+
+
+def copy_dir_contents(src: Path, dst: Path, follow_symlinks: bool = True) -> None:
+    """Copy directory contents, optionally resolving symlinks.
+
+    Args:
+        src: Source directory.
+        dst: Destination directory.
+        follow_symlinks: If True, copy symlink targets. If False, copy symlinks as-is.
+    """
+    import shutil
+
+    ensure_dir(dst)
+
+    for item in src.iterdir():
+        dest_path = dst / item.name
+
+        if item.is_symlink() and follow_symlinks:
+            # Resolve symlink and copy actual content
+            resolved = item.resolve()
+            if resolved.is_dir():
+                shutil.copytree(resolved, dest_path)
+            else:
+                shutil.copy2(resolved, dest_path)
+        elif item.is_dir():
+            shutil.copytree(item, dest_path, symlinks=not follow_symlinks)
+        else:
+            shutil.copy2(item, dest_path)

cldpm/utils/git.py

@@ -0,0 +1,169 @@
+"""Git utility functions for remote repository operations."""
+
+import os
+import shutil
+import subprocess
+import tempfile
+from pathlib import Path
+from typing import Optional
+from urllib.parse import urlparse
+
+
+def get_github_token() -> Optional[str]:
+    """Get GitHub token from environment variables.
+
+    Checks GITHUB_TOKEN and GH_TOKEN in that order.
+
+    Returns:
+        The token if found, None otherwise.
+    """
+    return os.environ.get("GITHUB_TOKEN") or os.environ.get("GH_TOKEN")
+
+
+def parse_repo_url(url: str) -> tuple[str, Optional[str], Optional[str]]:
+    """Parse a repository URL to extract repo URL, optional path, and branch.
+
+    Supports formats:
+    - https://github.com/owner/repo
+    - https://github.com/owner/repo/tree/branch
+    - https://github.com/owner/repo/tree/branch/path/to/project
+    - github.com/owner/repo
+    - owner/repo (assumes GitHub)
+
+    Args:
+        url: The repository URL or shorthand.
+
+    Returns:
+        Tuple of (repo_url, subpath, branch).
+    """
+    original_url = url
+    branch = None
+    subpath = None
+
+    # Handle shorthand owner/repo format
+    if not url.startswith(("http://", "https://", "git@")) and "/" in url:
+        if url.count("/") == 1:
+            # Simple owner/repo format
+            url = f"https://github.com/{url}"
+        elif not url.startswith("github.com"):
+            url = f"https://{url}"
+
+    # Add https:// if missing
+    if url.startswith("github.com"):
+        url = f"https://{url}"
+
+    # Parse the URL
+    parsed = urlparse(url)
+    path_parts = parsed.path.strip("/").split("/")
+
+    if len(path_parts) >= 2:
+        owner = path_parts[0]
+        repo = path_parts[1]
+
+        # Remove .git suffix if present
+        if repo.endswith(".git"):
+            repo = repo[:-4]
+
+        # Check for /tree/branch/path pattern
+        if len(path_parts) > 3 and path_parts[2] == "tree":
+            branch = path_parts[3]
+            if len(path_parts) > 4:
+                subpath = "/".join(path_parts[4:])
+
+        repo_url = f"https://{parsed.netloc}/{owner}/{repo}.git"
+        return repo_url, subpath, branch
+
+    raise ValueError(f"Invalid repository URL: {original_url}")
+
+
+def clone_repo(
+    repo_url: str,
+    target_dir: Path,
+    branch: Optional[str] = None,
+    token: Optional[str] = None,
+    sparse_paths: Optional[list[str]] = None,
+) -> Path:
+    """Clone a git repository.
+
+    Args:
+        repo_url: The repository URL.
+        target_dir: Directory to clone into.
+        branch: Optional branch to checkout.
+        token: Optional GitHub token for authentication.
+        sparse_paths: Optional list of paths for sparse checkout.
+
+    Returns:
+        Path to the cloned repository.
+
+    Raises:
+        subprocess.CalledProcessError: If git commands fail.
+    """
+    # Inject token into URL if provided
+    if token and "github.com" in repo_url:
+        repo_url = repo_url.replace(
+            "https://github.com", f"https://{token}@github.com"
+        )
+
+    cmd = ["git", "clone", "--depth", "1"]
+
+    if branch:
+        cmd.extend(["--branch", branch])
+
+    if sparse_paths:
+        cmd.extend(["--filter=blob:none", "--sparse"])
+
+    cmd.extend([repo_url, str(target_dir)])
+
+    # Run clone with token hidden from output
+    env = os.environ.copy()
+    env["GIT_TERMINAL_PROMPT"] = "0"
+
+    subprocess.run(
+        cmd,
+        check=True,
+        capture_output=True,
+        text=True,
+        env=env,
+    )
+
+    # Set up sparse checkout if needed
+    if sparse_paths:
+        subprocess.run(
+            ["git", "sparse-checkout", "set"] + sparse_paths,
+            cwd=target_dir,
+            check=True,
+            capture_output=True,
+            text=True,
+        )
+
+    return target_dir
+
+
+def clone_to_temp(
+    repo_url: str,
+    branch: Optional[str] = None,
+    token: Optional[str] = None,
+) -> Path:
+    """Clone a repository to a temporary directory.
+
+    Args:
+        repo_url: The repository URL.
+        branch: Optional branch to checkout.
+        token: Optional GitHub token for authentication.
+
+    Returns:
+        Path to the temporary directory containing the clone.
+    """
+    temp_dir = Path(tempfile.mkdtemp(prefix="cldpm-"))
+    clone_repo(repo_url, temp_dir, branch, token)
+    return temp_dir
+
+
+def cleanup_temp_dir(temp_dir: Path) -> None:
+    """Clean up a temporary directory.
+
+    Args:
+        temp_dir: Path to the temporary directory.
+    """
+    if temp_dir.exists() and str(temp_dir).startswith(tempfile.gettempdir()):
+        shutil.rmtree(temp_dir)

cldpm/utils/output.py

@@ -0,0 +1,133 @@
+"""CLI output formatting utilities using rich."""
+
+from pathlib import Path
+from typing import Any
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.tree import Tree
+
+console = Console()
+
+
+def print_error(message: str) -> None:
+    """Print an error message."""
+    console.print(f"[red]Error:[/red] {message}")
+
+
+def print_success(message: str) -> None:
+    """Print a success message."""
+    console.print(f"[green]✓[/green] {message}")
+
+
+def print_warning(message: str) -> None:
+    """Print a warning message."""
+    console.print(f"[yellow]Warning:[/yellow] {message}")
+
+
+def print_info(message: str) -> None:
+    """Print an info message."""
+    console.print(f"[blue]Info:[/blue] {message}")
+
+
+def print_tree(data: dict[str, Any], title: str = "Project") -> None:
+    """Print a tree representation of project data.
+
+    Args:
+        data: Project data dictionary.
+        title: Title for the tree.
+    """
+    tree = Tree(f"[bold]{title}[/bold]: {data.get('name', 'Unknown')}")
+
+    # Add path
+    if "path" in data:
+        tree.add(f"[dim]Path:[/dim] {data['path']}")
+
+    # Add config info
+    if "config" in data:
+        config = data["config"]
+        config_branch = tree.add("[bold]Config[/bold]")
+        if config.get("description"):
+            config_branch.add(f"Description: {config['description']}")
+
+    # Add shared components
+    if "shared" in data:
+        shared = data["shared"]
+        has_shared = any(shared.get(t) for t in ["skills", "agents", "hooks", "rules"])
+        if has_shared:
+            shared_branch = tree.add("[bold]Shared Components[/bold] [dim](from shared/)[/dim]")
+            _add_component_items(shared_branch, shared)
+
+    # Add local components
+    if "local" in data:
+        local = data["local"]
+        has_local = any(local.get(t) for t in ["skills", "agents", "hooks", "rules"])
+        if has_local:
+            local_branch = tree.add("[bold]Local Components[/bold] [dim](project-specific)[/dim]")
+            _add_component_items(local_branch, local)
+
+    # Backward compatibility: handle old "resolved" format
+    if "resolved" in data and "shared" not in data:
+        resolved = data["resolved"]
+        deps_branch = tree.add("[bold]Dependencies[/bold]")
+        _add_component_items(deps_branch, resolved)
+
+    console.print(tree)
+
+
+def _add_component_items(parent_branch: Tree, components: dict[str, list]) -> None:
+    """Add component items to a tree branch.
+
+    Args:
+        parent_branch: The parent tree branch to add items to.
+        components: Dictionary mapping component types to lists of component info.
+    """
+    for dep_type in ["skills", "agents", "hooks", "rules"]:
+        items = components.get(dep_type, [])
+        if items:
+            type_branch = parent_branch.add(f"[cyan]{dep_type}[/cyan]")
+            for item in items:
+                name = item['name']
+                comp_type = item.get('type', 'shared')
+                color = "green" if comp_type == "shared" else "yellow"
+                item_branch = type_branch.add(f"[{color}]{name}[/{color}]")
+                item_branch.add(f"[dim]Source:[/dim] {item['sourcePath']}")
+                if item.get("files"):
+                    files_str = ", ".join(item["files"])
+                    item_branch.add(f"[dim]Files:[/dim] {files_str}")
+
+
+def print_dir_tree(path: Path, prefix: str = "", max_depth: int = 3, current_depth: int = 0) -> None:
+    """Print a directory tree.
+
+    Args:
+        path: Root path to display.
+        prefix: Prefix for indentation.
+        max_depth: Maximum depth to traverse.
+        current_depth: Current depth level.
+    """
+    if current_depth >= max_depth:
+        return
+
+    if not path.exists():
+        return
+
+    items = sorted(path.iterdir(), key=lambda x: (not x.is_dir(), x.name))
+
+    for i, item in enumerate(items):
+        is_last = i == len(items) - 1
+        connector = "└── " if is_last else "├── "
+
+        # Format name with symlink indicator
+        name = item.name
+        if item.is_symlink():
+            target = item.resolve()
+            name = f"{name} -> {target}"
+            console.print(f"{prefix}{connector}[cyan]{name}[/cyan]")
+        elif item.is_dir():
+            console.print(f"{prefix}{connector}[bold blue]{name}/[/bold blue]")
+            # Recurse into directory
+            extension = "    " if is_last else "│   "
+            print_dir_tree(item, prefix + extension, max_depth, current_depth + 1)
+        else:
+            console.print(f"{prefix}{connector}{name}")

cldpm-0.1.0.dist-info/METADATA

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: cldpm
+Version: 0.1.0
+Summary: Claude Project Manager - SDK and CLI for mono repo management with Claude Code projects
+Author-email: Aman Agarwal <agarwal.aman041@gmail.com>
+Maintainer: Transilience.ai
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'

cldpm-0.1.0.dist-info/RECORD

@@ -0,0 +1,37 @@
+cldpm/__init__.py,sha256=Qs_cOf9f0je2K86JhYplR5GXO3pg28CXGgWp-3ANme8,343
+cldpm/__main__.py,sha256=KLtPDZNHEkoLu4WDS7YiJAu5-rUfAOX0DMaRJp85l9k,111
+cldpm/_banner.py,sha256=g0NPFBHAOPJRVOuk8aXOzGbNZV5Gg7jd3danaW_pE2U,4581
+cldpm/cli.py,sha256=8KTeFh1Pw_klOxyNYLaICfHo4PIargDSzeIvIv6Y_lM,2023
+cldpm/commands/__init__.py,sha256=v7fUbesCKq_3oGCjjs_8XnQJD3uQIMCgekSRPT3PDx8,318
+cldpm/commands/add.py,sha256=qXidhVSjF2Ekq6AWNda4QwMi54XiU4elzJ6Tl78qHHc,7004
+cldpm/commands/clone.py,sha256=6_FlzB1p0s9hkTmS1etIiUXWYMRlB2laONepJN8QtKo,6492
+cldpm/commands/create.py,sha256=hE30b5ys_ILI-BGTAsJralh2qt8AZyDyqYVB5U1rnhE,13348
+cldpm/commands/get.py,sha256=AnDDfJHFO_9yJnELXkKVmpNo78r6bCNPLM3Q_8HXsZ4,12188
+cldpm/commands/init.py,sha256=LG8l57yADPjTMNRrPoXiZqPO-678DEPdhIF7fwJDOqQ,10798
+cldpm/commands/link.py,sha256=cgw5IxUC9Y3267JMQlq1dERIPnajpUDFzR7t0vmTNXQ,9927
+cldpm/commands/remove.py,sha256=e9lBWLJtr4w045L8xi59lvgjIXt9_6mtG0Ux1t3vDxU,9788
+cldpm/commands/sync.py,sha256=y5_1SSg5IrpJvj9qnqGt_MiNTqdGKO4NTw7C2wNFF5E,3230
+cldpm/core/__init__.py,sha256=usYkD2Dyhgo4z5EZyaM4WjmaUxelQRbC7glscAZetww,662
+cldpm/core/config.py,sha256=lt050-9TTjvrZWWl7klAyYRJON7mIfjPdfEc1dJijn0,5209
+cldpm/core/linker.py,sha256=h46XI-KOVF7LPpHRMqEY5-9Ze5E3RUzL1ChttN3mr3E,8324
+cldpm/core/resolver.py,sha256=deBNvIz6FksHUEnA-ArIfzxTtqht0pVNfx_vYO-fLPY,8951
+cldpm/schemas/__init__.py,sha256=G4jArynDyLTbYsxAtG8Fayt4sRbQuaV_FTK1YoMtB8U,342
+cldpm/schemas/cldpm.py,sha256=yOmkEwO3SHZ5fABBTsy0cGwjoseLeyLt_VZoBSWvroY,925
+cldpm/schemas/component.py,sha256=lcph8DH89g70Upzd3zjIO56eFbKi0DKDyg2QWR4ylNU,709
+cldpm/schemas/project.py,sha256=fKZ1gqPszr9tL6s2zOTyFn6bAzoFZ5wK_FyCJNRdwWs,1394
+cldpm/templates/CLAUDE.md.j2,sha256=IgpGcmnDptdq5WMjDOWkLHcKstQwx2QT7btHDadmvOs,612
+cldpm/templates/ROOT_CLAUDE.md.j2,sha256=U7O7shBi5tRV3X7JyXPdgHQVarj0aM4fdR6-08P0_68,786
+cldpm/templates/agent.md.j2,sha256=S_dpcCk9xU4iLb5svygf-2cmT289gYpzesa4-GqhuFc,301
+cldpm/templates/gitignore.j2,sha256=hYWP9nFtIxF6sQuSxEKrLqsyt657LT1CV4XRuB4upIc,540
+cldpm/templates/hook.md.j2,sha256=rRcf9VtBxK7haI8oMckwvvk17nxpqvUh2Wk_MloavGE,364
+cldpm/templates/rule.md.j2,sha256=-xHNF_ZqnyitdGeElZYOl0KRIk8hwO_3I4nb6fXm5z0,346
+cldpm/templates/skill.md.j2,sha256=ToYa_4ce7O6SvXD8MCoJs7grMwrJiIbpPVCRkAFQ1ew,259
+cldpm/utils/__init__.py,sha256=xfTXT57qFYgHvaEnt_-sFqFv_E5leuLMvY5nX1Jog3o,568
+cldpm/utils/fs.py,sha256=BugmwOy6XE9V14nTZ2pCOrfENKnC6c1yP0lsigyamLw,2422
+cldpm/utils/git.py,sha256=Ht1Tf2jXVFEDkJ6SW8zWJHawBdvqE5XLmz8UYvQp17A,4524
+cldpm/utils/output.py,sha256=NycyKlZofXX9zI7qVt7OXGr8XInOZehrcUQp7qVIWi0,4556
+cldpm-0.1.0.dist-info/METADATA,sha256=wRTH0GJ8j6BUr-6crZt8hK63kiDPUed6lxx1qKy3z2o,505
+cldpm-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+cldpm-0.1.0.dist-info/entry_points.txt,sha256=ioYXXcFtreeoAKVT97JZ_OR75PAh9HNAXA8O9vS2N1M,46
+cldpm-0.1.0.dist-info/licenses/LICENSE,sha256=b0CSRDshyAcy5gblTvD30bCx64DEiD5vxQsHbp0-3Hk,1072
+cldpm-0.1.0.dist-info/RECORD,,

cldpm-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

cldpm-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cldpm = cldpm.__main__:main

cldpm-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Transilience.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.