cl-preset 0.1.0__py3-none-any.whl

cl_preset/models.py

@@ -0,0 +1,60 @@
+"""
+Data models for cl-preset package.
+"""
+
+from enum import Enum
+from pathlib import Path
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class PresetScope(str, Enum):
+    """Scope levels for preset installation."""
+    GLOBAL = "global"
+    USER = "user"
+    PROJECT = "project"
+
+
+class PresetType(str, Enum):
+    """Types of presets."""
+    AGENT = "agent"
+    SKILL = "skill"
+    COMMAND = "command"
+    STRATEGY = "strategy"
+
+
+class PresetMetadata(BaseModel):
+    """Metadata for a preset package."""
+    name: str = Field(..., description="Unique identifier for the preset")
+    version: str = Field(..., description="Semantic version (e.g., 1.0.0)")
+    description: str = Field(..., description="Brief description of the preset")
+    author: str = Field(default="", description="Author name or handle")
+    license: str = Field(default="MIT", description="License identifier")
+    preset_type: PresetType = Field(default=PresetType.STRATEGY, description="Type of preset")
+    tags: list[str] = Field(default_factory=list, description="Tags for discovery")
+
+
+class PresetConfig(BaseModel):
+    """Configuration for a preset."""
+    metadata: PresetMetadata
+    source_path: Path = Field(..., description="Path to preset source files")
+    target_path: Path | None = Field(None, description="Installation target path")
+    scope: PresetScope = Field(default=PresetScope.USER, description="Installation scope")
+    dependencies: list[str] = Field(default_factory=list, description="Required dependencies")
+
+    def get_install_path(self, base_path: Path) -> Path:
+        """Get the installation path based on scope."""
+        if self.scope == PresetScope.GLOBAL:
+            return base_path / "share" / "cl-preset" / self.metadata.name
+        elif self.scope == PresetScope.USER:
+            return Path.home() / ".claude" / "presets" / self.metadata.name
+        else:  # PROJECT
+            return Path.cwd() / ".claude" / "presets" / self.metadata.name
+
+
+class Preset(BaseModel):
+    """A preset package containing Claude Code configuration."""
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    config: PresetConfig
+    files: dict[str, str] = Field(default_factory=dict, description="File contents mapping")

cl_preset/templates/git_strategy_template.yaml

@@ -0,0 +1,60 @@
+# Git Strategy Template
+# Copy this file to create a custom git strategy
+
+name: my-custom-strategy
+strategy_type: custom
+description: "A custom git workflow strategy"
+
+# Branch Configuration
+main_branch: main
+develop_branch: develop
+
+# Branch Naming Patterns
+branch_patterns:
+  feature: "feature/*"
+  bugfix: "bugfix/*"
+  release: "release/*"
+  hotfix: "hotfix/*"
+
+# Merge Rules
+merge_rules:
+  require_pr: true
+  require_approval: true
+  allow_squash: true
+  allow_merge_commit: false
+  allow_rebase: false
+
+# Branch Protection Rules
+protection_rules:
+  main:
+    enabled: true
+    require_status_checks: true
+    require_branch_up_to_date: true
+    required_check_names:
+      - ci
+      - tests
+      - lint
+    allow_force_pushes: false
+    allow_deletions: false
+
+  develop:
+    enabled: true
+    require_status_checks: true
+    require_branch_up_to_date: false
+    required_check_names:
+      - ci
+    allow_force_pushes: false
+    allow_deletions: false
+
+# Optional: Dual-repo configuration
+# dev_repository:
+#   remote: origin
+#   url: git@github.com:org/repo-dev.git
+#   branch_pattern: "feature/*"
+#   description: "Active development repository"
+#
+# release_repository:
+#   remote: release
+#   url: git@github.com:org/repo-release.git
+#   protected_branches: ["main"]
+#   description: "Production releases repository"

cl_preset-0.1.0.dist-info/METADATA

@@ -0,0 +1,394 @@
+Metadata-Version: 2.4
+Name: cl-preset
+Version: 0.1.0
+Summary: A package for managing Claude Code configuration presets and strategies
+Project-URL: Homepage, https://github.com/yarang/cl-preset
+Project-URL: Documentation, https://github.com/yarang/cl-preset#readme
+Project-URL: Repository, https://github.com/yarang/cl-preset
+Project-URL: Issues, https://github.com/yarang/cl-preset/issues
+Author-email: William Jung <yarang@gmail.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# cl-preset
+
+A Python package for managing Claude Code configuration presets and strategies.
+
+## Overview
+
+`cl-preset` allows you to package your Claude Code strategies and install them with different scopes (global, user, or project). This makes it easy to share and distribute custom configurations across projects and teams.
+
+## Features
+
+- **Package Management**: Create, install, and uninstall preset packages
+- **Multiple Scopes**: Install presets globally, per-user, or per-project
+- **CLI Interface**: Simple command-line interface for all operations
+- **Rich Output**: Beautiful terminal output with formatted tables
+- **Validation**: Built-in metadata validation for preset packages
+- **Git Strategy Management**: Built-in git workflow strategies with validation
+
+## Installation
+
+```bash
+pip install cl-preset
+```
+
+Or using uv:
+
+```bash
+uv pip install cl-preset
+```
+
+## Quick Start
+
+### Create a New Preset
+
+```bash
+# Initialize a new preset scaffold
+cl-preset init my-strategy
+
+# This creates a directory structure:
+# my-strategy/
+#   ├── agents/       # Agent definitions
+#   ├── skills/       # Skill definitions
+#   ├── commands/     # Command definitions
+#   └── examples/     # Usage examples
+```
+
+### Install a Preset
+
+```bash
+# Install from a local directory
+cl-preset install ./my-strategy --name my-strategy --description "My custom strategy"
+
+# Install with specific scope
+cl-preset install ./my-strategy --name my-strategy --description "My custom strategy" --scope global
+```
+
+### List Installed Presets
+
+```bash
+# List all installed presets
+cl-preset list
+
+# List presets by scope
+cl-preset list --scope user
+cl-preset list --scope project
+cl-preset list --scope global
+
+# Output as JSON
+cl-preset list --json
+```
+
+### Get Preset Information
+
+```bash
+cl-preset info my-strategy
+```
+
+### Uninstall a Preset
+
+```bash
+cl-preset uninstall my-strategy
+
+# Uninstall from specific scope
+cl-preset uninstall my-strategy --scope user
+```
+
+## Command Reference
+
+### `init`
+
+Initialize a new preset scaffold.
+
+```bash
+cl-preset init NAME [OPTIONS]
+```
+
+**Options:**
+- `--output, -o`: Output path for preset metadata (default: ./preset.json)
+
+### `install`
+
+Install a preset from a source directory.
+
+```bash
+cl-preset install SOURCE_PATH [OPTIONS]
+```
+
+**Options:**
+- `--name, -n`: Unique name for the preset (required)
+- `--version, -v`: Version (default: 1.0.0)
+- `--description, -d`: Description of the preset (required)
+- `--author, -a`: Author name
+- `--type, -t`: Type of preset (agent|skill|command|strategy)
+- `--scope, -s`: Installation scope (global|user|project)
+
+### `list`
+
+List installed presets.
+
+```bash
+cl-preset list [OPTIONS]
+```
+
+**Options:**
+- `--scope, -s`: Filter by scope
+- `--json`: Output as JSON
+
+### `info`
+
+Show detailed information about an installed preset.
+
+```bash
+cl-preset info NAME
+```
+
+### `uninstall`
+
+Uninstall a preset by name.
+
+```bash
+cl-preset uninstall NAME [OPTIONS]
+```
+
+**Options:**
+- `--scope, -s`: Filter by scope
+
+## Git Strategy Management
+
+`cl-preset` includes built-in git workflow strategies that you can apply to your projects. These strategies define branching patterns, merge rules, and branch protection configurations.
+
+### Available Strategies
+
+#### dual-repo
+Dev/Release repository separation workflow.
+- **Dev repository**: Active development, feature branches, experimental work
+- **Release repository**: Production-ready code, stable releases, published documentation
+- **Promotion workflow**: Create release branch, review, merge to release repository
+
+#### github-flow
+Simple branch-based workflow.
+- Feature branches from main
+- Pull requests for review
+- Direct merge to main after approval
+- No release/develop branches
+
+#### git-flow
+Feature/release/hotfix branching model.
+- **master**: Production-ready code
+- **develop**: Integration branch for features
+- **feature/**: Feature development branches
+- **release/**: Release preparation branches
+- **hotfix/**: Emergency fixes for production
+
+### Git Commands
+
+#### `git list`
+
+List available git strategies.
+
+```bash
+cl-preset git list
+cl-preset git list --no-builtin  # Only custom strategies
+```
+
+#### `git info`
+
+Show detailed information about a git strategy.
+
+```bash
+cl-preset git info dual-repo
+cl-preset git info github-flow
+```
+
+#### `git export`
+
+Export a git strategy to a YAML file.
+
+```bash
+cl-preset git export dual-repo
+cl-preset git export dual-repo -o ./my-strategy.yaml
+```
+
+#### `git apply`
+
+Apply a git strategy to the current project.
+
+```bash
+# Apply a strategy
+cl-preset git apply github-flow
+
+# Dry run to see what would be configured
+cl-preset git apply github-flow --dry-run
+```
+
+This creates a `.moai/config/sections/git-strategy.yaml` file with the strategy configuration.
+
+#### `git validate`
+
+Validate current git setup against a strategy.
+
+```bash
+cl-preset git validate github-flow
+```
+
+This checks:
+- Current branch matches strategy expectations
+- Required branches exist (main, develop, etc.)
+- Required remotes are configured
+- Repository state matches the strategy
+
+### Creating Custom Strategies
+
+You can create custom git strategies by exporting a built-in strategy and modifying it:
+
+```bash
+# Export a built-in strategy as a starting point
+cl-preset git export github-flow -o ./my-custom-strategy.yaml
+
+# Edit the YAML file to customize
+# Then use it as a reference for your project
+```
+
+Strategy configuration format:
+
+```yaml
+name: my-custom-strategy
+strategy_type: custom
+description: "A custom git workflow"
+
+main_branch: main
+develop_branch: develop
+
+branch_patterns:
+  feature: "feature/*"
+  bugfix: "bugfix/*"
+  release: "release/*"
+  hotfix: "hotfix/*"
+
+merge_rules:
+  require_pr: true
+  require_approval: true
+  allow_squash: true
+  allow_merge_commit: false
+  allow_rebase: false
+
+protection_rules:
+  main:
+    enabled: true
+    require_status_checks: true
+    required_check_names: ["ci", "tests"]
+    allow_force_pushes: false
+    allow_deletions: false
+```
+
+### Git Strategy Integration with MoAI
+
+When you apply a git strategy using `cl-preset git apply`, it:
+
+1. Creates `.moai/config/sections/git-strategy.yaml`
+2. Configures branch naming patterns
+3. Sets up merge rule recommendations
+4. Defines branch protection rules
+
+This integrates with MoAI's git workflow commands and ensures consistent branching patterns across your team.
+
+## Scopes
+
+Presets can be installed at three different scopes:
+
+| Scope | Path | Description |
+|-------|------|-------------|
+| `global` | `/usr/local/share/cl-preset/{name}` | Available to all users on the system |
+| `user` | `~/.claude/presets/{name}` | Available only to the current user (default) |
+| `project` | `.claude/presets/{name}` | Available only in the current project |
+
+## Preset Structure
+
+A valid preset directory contains:
+
+```
+my-preset/
+├── agents/           # Agent definition files
+├── skills/           # Skill definition files
+├── commands/         # Command definition files
+├── examples/         # Usage examples
+└── preset.json       # Preset metadata (generated during install)
+```
+
+## Metadata
+
+Each preset has metadata defined in `preset.json`:
+
+```json
+{
+  "name": "my-preset",
+  "version": "1.0.0",
+  "description": "My custom Claude Code strategy",
+  "author": "Your Name",
+  "license": "MIT",
+  "preset_type": "strategy",
+  "tags": ["web", "api", "fastapi"]
+}
+```
+
+## Development
+
+### Setup Development Environment
+
+```bash
+# Clone the repository
+git clone https://github.com/yarang/cl-preset
+cd cl-preset
+
+# Install with dev dependencies
+uv sync --dev
+```
+
+### Run Tests
+
+```bash
+uv run pytest
+```
+
+### Code Quality
+
+```bash
+# Format code
+uv run ruff format .
+
+# Lint code
+uv run ruff check .
+
+# Type check
+uv run mypy src/
+```
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## Author
+
+William Jung - [@yarang](https://github.com/yarang)
+
+## Links
+
+- [GitHub Repository](https://github.com/yarang/cl-preset)
+- [Issue Tracker](https://github.com/yarang/cl-preset/issues)

cl_preset-0.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+cl_preset/__init__.py,sha256=rGIQS-1vuBzwnPj7NtC2N8hRIoMHUmSEMbWfnhjHjKQ,462
+cl_preset/cli.py,sha256=XldMCDe1-HEeX1IQQZU0J-2ECABpWLbq5yWXd-eIswY,15762
+cl_preset/git_strategy.py,sha256=FuiNUMaTwAyNA5nS8EvLhAntldJOBgRMO5FrUUgJ1K4,17375
+cl_preset/manager.py,sha256=OojhbTxXZ0cPt44PPZE1NqSBAXsGssB6ZuYyfoKwPa4,6192
+cl_preset/models.py,sha256=UWx68lb0ac3VFCRpj3zOqc7qGwJpbX2EZcw_OYHBKWg,2241
+cl_preset/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cl_preset/templates/git_strategy_template.yaml,sha256=2oF97WOHq2crSRoaLzWodBvzANmQ-9FPzM-A0jui2iw,1328
+cl_preset-0.1.0.dist-info/METADATA,sha256=Oon9IbfPw1sIDSGnLyYMVFv4-3Zi6wiwdcFTMDtIn38,8939
+cl_preset-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+cl_preset-0.1.0.dist-info/entry_points.txt,sha256=JAW_u5lrqylE516FDGO5audUKuCsxGYypQ7d6cA_9uY,49
+cl_preset-0.1.0.dist-info/licenses/LICENSE,sha256=5b1_XulzMGBmVHcNKAHMo0Mqfqm5xJix4O5AErotK0o,1069
+cl_preset-0.1.0.dist-info/RECORD,,

cl_preset-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

cl_preset-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cl-preset = cl_preset.cli:main

cl_preset-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 William Jung
+
+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.