cldpm 0.1.0__tar.gz

cldpm-0.1.0/.gitignore

@@ -0,0 +1,35 @@
+# Virtual environment
+.venv/
+venv/
+ENV/
+
+# Python bytecode
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+.eggs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Type checking / linting
+.mypy_cache/
+.ruff_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store

cldpm-0.1.0/CLI.md

@@ -0,0 +1,301 @@
+# CLDPM CLI Reference
+
+Complete reference for CLDPM command-line interface.
+
+## Installation
+
+```bash
+pip install cldpm
+```
+
+## Commands Overview
+
+```mermaid
+graph LR
+    CLDPM[cldpm] --> INIT[init]
+    CLDPM --> CREATE[create]
+    CLDPM --> ADD[add]
+    CLDPM --> REMOVE[remove]
+    CLDPM --> LINK[link]
+    CLDPM --> UNLINK[unlink]
+    CLDPM --> GET[get]
+    CLDPM --> CLONE[clone]
+    CLDPM --> SYNC[sync]
+
+    CREATE --> PROJECT[project]
+    CREATE --> SKILL[skill]
+    CREATE --> AGENT[agent]
+    CREATE --> HOOK[hook]
+    CREATE --> RULE[rule]
+```
+
+## Commands
+
+### `cldpm init`
+
+Initialize a new CLDPM mono repo.
+
+```bash
+cldpm init [DIRECTORY] [OPTIONS]
+```
+
+**Arguments:**
+- `DIRECTORY` - Directory name (default: current directory)
+
+**Options:**
+- `-n, --name TEXT` - Repository name
+
+**Example:**
+```bash
+cldpm init my-monorepo
+cldpm init . --name "My Project Hub"
+```
+
+---
+
+### `cldpm create`
+
+Create new projects or shared components.
+
+#### `cldpm create project`
+
+```bash
+cldpm create project NAME [OPTIONS]
+```
+
+**Options:**
+- `-d, --description TEXT` - Project description
+- `-s, --skills TEXT` - Comma-separated skills to add
+
+**Example:**
+```bash
+cldpm create project web-app -d "Web application"
+cldpm create project api --skills logging,auth
+```
+
+#### `cldpm create skill`
+
+```bash
+cldpm create skill NAME [OPTIONS]
+```
+
+**Options:**
+- `-d, --description TEXT` - Skill description
+- `-s, --skills TEXT` - Dependent skills
+- `-a, --agents TEXT` - Dependent agents
+- `-h, --hooks TEXT` - Dependent hooks
+- `-r, --rules TEXT` - Dependent rules
+
+**Example:**
+```bash
+cldpm create skill code-review -d "Code review assistant"
+cldpm create skill advanced-review --skills code-review,security
+```
+
+#### `cldpm create agent`
+
+```bash
+cldpm create agent NAME [OPTIONS]
+```
+
+**Options:** Same as `cldpm create skill`
+
+#### `cldpm create hook`
+
+```bash
+cldpm create hook NAME [OPTIONS]
+```
+
+**Options:** Same as `cldpm create skill`
+
+#### `cldpm create rule`
+
+```bash
+cldpm create rule NAME [OPTIONS]
+```
+
+**Options:** Same as `cldpm create skill`
+
+---
+
+### `cldpm add`
+
+Add a shared component to a project.
+
+```bash
+cldpm add COMPONENT --to PROJECT [OPTIONS]
+```
+
+**Arguments:**
+- `COMPONENT` - Component in format `type:name` (e.g., `skill:logging`)
+
+**Options:**
+- `-t, --to TEXT` - Target project name (required)
+- `--no-deps` - Don't install component dependencies
+
+**Example:**
+```bash
+cldpm add skill:logging --to web-app
+cldpm add agent:debugger --to api-server --no-deps
+```
+
+---
+
+### `cldpm remove`
+
+Remove a shared component from a project.
+
+```bash
+cldpm remove COMPONENT --from PROJECT [OPTIONS]
+```
+
+**Arguments:**
+- `COMPONENT` - Component in format `type:name`
+
+**Options:**
+- `-f, --from TEXT` - Source project name (required)
+- `--keep-deps` - Keep orphaned dependencies
+- `--force` - Remove without confirmation
+
+**Example:**
+```bash
+cldpm remove skill:logging --from web-app
+cldpm remove agent:debugger --from api --force
+```
+
+---
+
+### `cldpm link`
+
+Link dependencies to an existing shared component.
+
+```bash
+cldpm link DEPENDENCIES --to TARGET
+```
+
+**Arguments:**
+- `DEPENDENCIES` - Comma-separated list (e.g., `skill:a,agent:b`)
+
+**Options:**
+- `-t, --to TEXT` - Target component (required)
+
+**Example:**
+```bash
+cldpm link skill:base-utils --to skill:code-review
+cldpm link skill:logging,hook:validator --to agent:debugger
+```
+
+---
+
+### `cldpm unlink`
+
+Remove dependencies from an existing shared component.
+
+```bash
+cldpm unlink DEPENDENCIES --from TARGET
+```
+
+**Arguments:**
+- `DEPENDENCIES` - Comma-separated list
+
+**Options:**
+- `-f, --from TEXT` - Source component (required)
+
+**Example:**
+```bash
+cldpm unlink skill:base-utils --from skill:code-review
+```
+
+---
+
+### `cldpm get`
+
+Get project info with all resolved components.
+
+```bash
+cldpm get PROJECT [OPTIONS]
+```
+
+**Arguments:**
+- `PROJECT` - Project name or path
+
+**Options:**
+- `-f, --format [tree|json]` - Output format (default: tree)
+- `-r, --remote TEXT` - Remote GitHub repo (owner/repo)
+- `-d, --download` - Download remote project
+- `-o, --output PATH` - Output directory for download
+
+**Example:**
+```bash
+cldpm get web-app
+cldpm get web-app --format json
+cldpm get my-project -r owner/repo --download
+```
+
+---
+
+### `cldpm clone`
+
+Clone a project to a standalone directory with all dependencies.
+
+```bash
+cldpm clone PROJECT DIRECTORY [OPTIONS]
+```
+
+**Arguments:**
+- `PROJECT` - Project name or path
+- `DIRECTORY` - Target directory
+
+**Options:**
+- `--include-shared` - Include full shared/ directory
+
+**Example:**
+```bash
+cldpm clone web-app ./standalone
+cldpm clone api-server /tmp/export --include-shared
+```
+
+---
+
+### `cldpm sync`
+
+Regenerate symlinks for shared components.
+
+```bash
+cldpm sync [PROJECT] [OPTIONS]
+```
+
+**Arguments:**
+- `PROJECT` - Project name (optional)
+
+**Options:**
+- `-a, --all` - Sync all projects
+
+**Example:**
+```bash
+cldpm sync web-app
+cldpm sync --all
+```
+
+---
+
+## Global Options
+
+```bash
+cldpm --help     # Show help
+cldpm --version  # Show version
+```
+
+## Exit Codes
+
+| Code | Description |
+|------|-------------|
+| 0 | Success |
+| 1 | Error |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `GITHUB_TOKEN` | GitHub token for private repos |
+| `GH_TOKEN` | Alternative GitHub token |

cldpm-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,65 @@
+# Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+* The use of sexualized language or imagery, and sexual attention or advances
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+* Other conduct which could reasonably be considered inappropriate
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+**conduct@transilience.ai**.
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+[homepage]: https://www.contributor-covenant.org
+
+---
+
+<p align="center">
+  Maintained by <a href="https://transilience.ai">Transilience.ai</a>
+</p>

cldpm-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,223 @@
+# Contributing to CLDPM
+
+Thank you for your interest in contributing to CLDPM! This document provides guidelines and instructions for contributing.
+
+## Getting Started
+
+### Prerequisites
+
+- Python 3.10+
+- Git
+
+### Development Setup
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/transilienceai/cldpm.git
+   cd cldpm/python
+   ```
+
+2. Create a virtual environment:
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+   ```
+
+3. Install dependencies:
+   ```bash
+   pip install -e ".[dev]"
+   ```
+
+4. Run tests:
+   ```bash
+   pytest
+   ```
+
+## Development Workflow
+
+### Code Structure
+
+```
+cldpm/
+├── __init__.py          # Package init, version
+├── __main__.py          # Entry point
+├── cli.py               # CLI commands setup
+├── commands/            # CLI command implementations
+│   ├── init.py
+│   ├── create.py
+│   ├── add.py
+│   ├── remove.py
+│   ├── link.py
+│   ├── get.py
+│   ├── clone.py
+│   └── sync.py
+├── core/                # Core SDK modules
+│   ├── config.py        # Config loading/saving
+│   ├── resolver.py      # Dependency resolution
+│   └── linker.py        # Symlink management
+├── schemas/             # Pydantic models
+│   ├── cldpm.py
+│   ├── project.py
+│   └── component.py
+├── templates/           # Jinja2 templates
+└── utils/               # Utilities
+    ├── fs.py
+    └── output.py
+```
+
+### Making Changes
+
+1. Create a feature branch:
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+2. Make your changes following the coding standards
+
+3. Add tests for new functionality
+
+4. Run tests and linting:
+   ```bash
+   pytest
+   ```
+
+5. Commit your changes:
+   ```bash
+   git commit -m "Add feature: description"
+   ```
+
+6. Push and create a pull request
+
+### Coding Standards
+
+#### Python Style
+
+- Follow PEP 8
+- Use type hints for function signatures
+- Maximum line length: 100 characters
+- Use descriptive variable names
+
+```python
+# Good
+def resolve_component(
+    comp_type: str,
+    comp_name: str,
+    shared_dir: Path,
+) -> Optional[dict]:
+    """Resolve a shared component by type and name."""
+    ...
+
+# Bad
+def resolve(t, n, d):
+    ...
+```
+
+#### Documentation
+
+- All public functions must have docstrings
+- Use Google-style docstrings
+- Include type information in docstrings
+
+```python
+def sync_project_links(
+    project_path: Path,
+    repo_root: Path,
+) -> dict:
+    """Synchronize symlinks for a project.
+
+    Args:
+        project_path: Path to the project directory.
+        repo_root: Path to the repository root.
+
+    Returns:
+        Dictionary with 'created' and 'missing' lists.
+    """
+```
+
+#### Testing
+
+- Write tests for all new functionality
+- Use pytest fixtures for common setups
+- Test both success and error cases
+- Aim for high coverage
+
+```python
+class TestMyFeature:
+    """Tests for my feature."""
+
+    def test_success_case(self, setup_repo):
+        """Test that feature works correctly."""
+        result = my_feature(setup_repo)
+        assert result is not None
+
+    def test_error_case(self, setup_repo):
+        """Test that feature handles errors."""
+        with pytest.raises(ValueError):
+            my_feature(invalid_input)
+```
+
+## Pull Request Guidelines
+
+### Before Submitting
+
+- [ ] Tests pass locally (`pytest`)
+- [ ] Code follows style guidelines
+- [ ] Documentation updated if needed
+- [ ] Commit messages are clear and descriptive
+
+### PR Title Format
+
+Use conventional commit format:
+
+- `feat: Add new feature`
+- `fix: Fix bug in X`
+- `docs: Update documentation`
+- `refactor: Refactor X module`
+- `test: Add tests for Y`
+
+### PR Description
+
+Include:
+
+1. **Summary**: What does this PR do?
+2. **Motivation**: Why is this change needed?
+3. **Testing**: How was it tested?
+4. **Breaking Changes**: Any breaking changes?
+
+## Reporting Issues
+
+### Bug Reports
+
+Include:
+
+- CLDPM version (`cldpm --version`)
+- Python version (`python --version`)
+- Operating system
+- Steps to reproduce
+- Expected behavior
+- Actual behavior
+- Error messages/logs
+
+### Feature Requests
+
+Include:
+
+- Use case description
+- Proposed solution
+- Alternatives considered
+
+## Community
+
+- Be respectful and inclusive
+- Follow our [Code of Conduct](CODE_OF_CONDUCT.md)
+- Help others in discussions
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.
+
+---
+
+<p align="center">
+  Thank you for contributing to CLDPM!
+</p>

cldpm-0.1.0/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.

cldpm-0.1.0/PKG-INFO

@@ -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'