claude-mpm 4.20.3__py3-none-any.whl → 4.25.10__py3-none-any.whl

claude_mpm/skills/bundled/main/skill-creator/scripts/init_skill.py

@@ -187,7 +187,7 @@ Note: This is a text placeholder. Actual assets can be any file type.
 
 def title_case_skill_name(skill_name):
     """Convert hyphenated skill name to Title Case for display."""
-    return ' '.join(word.capitalize() for word in skill_name.split('-'))
+    return " ".join(word.capitalize() for word in skill_name.split("-"))
 
 
 def init_skill(skill_name, path):
@@ -220,11 +220,10 @@ def init_skill(skill_name, path):
     # Create SKILL.md from template
     skill_title = title_case_skill_name(skill_name)
     skill_content = SKILL_TEMPLATE.format(
-        skill_name=skill_name,
-        skill_title=skill_title
+        skill_name=skill_name, skill_title=skill_title
     )
 
-    skill_md_path = skill_dir / 'SKILL.md'
+    skill_md_path = skill_dir / "SKILL.md"
     try:
         skill_md_path.write_text(skill_content)
         print("✅ Created SKILL.md")
@@ -235,24 +234,24 @@ def init_skill(skill_name, path):
     # Create resource directories with example files
     try:
         # Create scripts/ directory with example script
-        scripts_dir = skill_dir / 'scripts'
+        scripts_dir = skill_dir / "scripts"
         scripts_dir.mkdir(exist_ok=True)
-        example_script = scripts_dir / 'example.py'
+        example_script = scripts_dir / "example.py"
         example_script.write_text(EXAMPLE_SCRIPT.format(skill_name=skill_name))
         example_script.chmod(0o755)
         print("✅ Created scripts/example.py")
 
         # Create references/ directory with example reference doc
-        references_dir = skill_dir / 'references'
+        references_dir = skill_dir / "references"
         references_dir.mkdir(exist_ok=True)
-        example_reference = references_dir / 'api_reference.md'
+        example_reference = references_dir / "api_reference.md"
         example_reference.write_text(EXAMPLE_REFERENCE.format(skill_title=skill_title))
         print("✅ Created references/api_reference.md")
 
         # Create assets/ directory with example asset placeholder
-        assets_dir = skill_dir / 'assets'
+        assets_dir = skill_dir / "assets"
         assets_dir.mkdir(exist_ok=True)
-        example_asset = assets_dir / 'example_asset.txt'
+        example_asset = assets_dir / "example_asset.txt"
         example_asset.write_text(EXAMPLE_ASSET)
         print("✅ Created assets/example_asset.txt")
     except Exception as e:
@@ -263,14 +262,16 @@ def init_skill(skill_name, path):
     print(f"\n✅ Skill '{skill_name}' initialized successfully at {skill_dir}")
     print("\nNext steps:")
     print("1. Edit SKILL.md to complete the TODO items and update the description")
-    print("2. Customize or delete the example files in scripts/, references/, and assets/")
+    print(
+        "2. Customize or delete the example files in scripts/, references/, and assets/"
+    )
     print("3. Run the validator when ready to check the skill structure")
 
     return skill_dir
 
 
 def main():
-    if len(sys.argv) < 4 or sys.argv[2] != '--path':
+    if len(sys.argv) < 4 or sys.argv[2] != "--path":
         print("Usage: init_skill.py <skill-name> --path <path>")
         print("\nSkill name requirements:")
         print("  - Hyphen-case identifier (e.g., 'data-analyzer')")

claude_mpm/skills/bundled/main/skill-creator/scripts/package_skill.py

@@ -66,9 +66,9 @@ def package_skill(skill_path, output_dir=None):
 
     # Create the zip file
     try:
-        with zipfile.ZipFile(zip_filename, 'w', zipfile.ZIP_DEFLATED) as zipf:
+        with zipfile.ZipFile(zip_filename, "w", zipfile.ZIP_DEFLATED) as zipf:
             # Walk through the skill directory
-            for file_path in skill_path.rglob('*'):
+            for file_path in skill_path.rglob("*"):
                 if file_path.is_file():
                     # Calculate the relative path within the zip
                     arcname = file_path.relative_to(skill_path.parent)
@@ -85,7 +85,9 @@ def package_skill(skill_path, output_dir=None):
 
 def main():
     if len(sys.argv) < 2:
-        print("Usage: python utils/package_skill.py <path/to/skill-folder> [output-directory]")
+        print(
+            "Usage: python utils/package_skill.py <path/to/skill-folder> [output-directory]"
+        )
         print("\nExample:")
         print("  python utils/package_skill.py skills/public/my-skill")
         print("  python utils/package_skill.py skills/public/my-skill ./dist")

claude_mpm/skills/bundled/main/skill-creator/scripts/quick_validate.py

@@ -13,48 +13,55 @@ def validate_skill(skill_path):
     skill_path = Path(skill_path)
 
     # Check SKILL.md exists
-    skill_md = skill_path / 'SKILL.md'
+    skill_md = skill_path / "SKILL.md"
     if not skill_md.exists():
         return False, "SKILL.md not found"
 
     # Read and validate frontmatter
     content = skill_md.read_text()
-    if not content.startswith('---'):
+    if not content.startswith("---"):
         return False, "No YAML frontmatter found"
 
     # Extract frontmatter
-    match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
+    match = re.match(r"^---\n(.*?)\n---", content, re.DOTALL)
     if not match:
         return False, "Invalid frontmatter format"
 
     frontmatter = match.group(1)
 
     # Check required fields
-    if 'name:' not in frontmatter:
+    if "name:" not in frontmatter:
         return False, "Missing 'name' in frontmatter"
-    if 'description:' not in frontmatter:
+    if "description:" not in frontmatter:
         return False, "Missing 'description' in frontmatter"
 
     # Extract name for validation
-    name_match = re.search(r'name:\s*(.+)', frontmatter)
+    name_match = re.search(r"name:\s*(.+)", frontmatter)
     if name_match:
         name = name_match.group(1).strip()
         # Check naming convention (hyphen-case: lowercase with hyphens)
-        if not re.match(r'^[a-z0-9-]+$', name):
-            return False, f"Name '{name}' should be hyphen-case (lowercase letters, digits, and hyphens only)"
-        if name.startswith('-') or name.endswith('-') or '--' in name:
-            return False, f"Name '{name}' cannot start/end with hyphen or contain consecutive hyphens"
+        if not re.match(r"^[a-z0-9-]+$", name):
+            return (
+                False,
+                f"Name '{name}' should be hyphen-case (lowercase letters, digits, and hyphens only)",
+            )
+        if name.startswith("-") or name.endswith("-") or "--" in name:
+            return (
+                False,
+                f"Name '{name}' cannot start/end with hyphen or contain consecutive hyphens",
+            )
 
     # Extract and validate description
-    desc_match = re.search(r'description:\s*(.+)', frontmatter)
+    desc_match = re.search(r"description:\s*(.+)", frontmatter)
     if desc_match:
         description = desc_match.group(1).strip()
         # Check for angle brackets
-        if '<' in description or '>' in description:
+        if "<" in description or ">" in description:
             return False, "Description cannot contain angle brackets (< or >)"
 
     return True, "Skill is valid!"
 
+
 if __name__ == "__main__":
     if len(sys.argv) != 2:
         print("Usage: python quick_validate.py <skill_directory>")

claude_mpm/skills/bundled/performance-profiling.md

@@ -433,6 +433,12 @@ def sort_items(items):
 
 ### Load Testing
 
+> **Note:** Locust is an optional dependency. Install it separately if you need load testing capabilities:
+> ```bash
+> pip install "claude-mpm[agents-load-testing]"
+> ```
+> Or install locust directly: `pip install locust>=2.15.0`
+
 ```python
 # Using locust for load testing
 from locust import HttpUser, task, between

claude_mpm/skills/bundled/php/espocrm-development/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: espocrm-development
+description: Comprehensive guide for developing on EspoCRM - metadata-driven CRM with service layer architecture
+version: 1.0.0
+category: development
+author: Claude MPM Team
+license: MIT
+progressive_disclosure:
+  entry_point:
+    summary: "Metadata-driven CRM development using service layer, ORM EntityManager, and hook-based business logic"
+    when_to_use: "When developing custom modules, entities, hooks, or integrations for EspoCRM"
+    quick_start: "1. Understand metadata-driven architecture 2. Use EntityManager for data access 3. Implement business logic in Services 4. Register hooks for lifecycle events 5. Rebuild cache after changes"
+  references:
+    - architecture.md
+    - development-workflow.md
+    - hooks-and-services.md
+    - frontend-customization.md
+    - common-tasks.md
+    - testing-debugging.md
+context_limit: 800
+tags:
+  - espocrm
+  - php
+  - crm
+  - metadata-driven
+  - orm
+requires_tools: []
+---
+
+# EspoCRM Development
+
+## Overview
+
+EspoCRM is a metadata-driven CRM platform where configuration lives in JSON files, business logic belongs in Services, and data access happens through ORM EntityManager. This skill enforces architectural patterns to prevent common mistakes like passing Container dependencies, bypassing the service layer, or implementing business logic in hooks.
+
+## When to Use This Skill
+
+Activate when developing custom EspoCRM modules, entities, relationships, hooks, services, API endpoints, or integrations. **Use especially when:** working with ORM (EntityManager required), implementing business logic (belongs in Services), creating hooks (use interfaces), modifying metadata (requires cache rebuild), or building custom field types.
+
+## The Iron Law
+
+**BUSINESS LOGIC IN SERVICES, NOT HOOKS | DATA ACCESS VIA ENTITYMANAGER, NEVER DIRECT PDO | NEVER PASS CONTAINER AS DEPENDENCY**
+
+If you're accessing Container directly or writing business logic in hooks, you're violating architecture.
+
+## Core Architecture Principles
+
+1. **Metadata-Driven**: Entity definitions, layouts, field configs live in JSON
+2. **Service Layer**: All business logic implemented in Service classes
+3. **ORM EntityManager**: Central access point for all database operations
+4. **Dependency Injection**: Constructor injection, never pass Container
+5. **Hook System**: Lifecycle events for validation and side effects (not business logic)
+6. **Repository Pattern**: Entities accessed through repositories
+
+## Quick Start
+
+1. **Setup Development Environment** - Use ext-template, work in `src/` directory (EspoCRM 7.4+), understand metadata structure: `custom/Espo/Modules/{ModuleName}/Resources/metadata/`
+
+2. **Access Data with EntityManager**
+   ```php
+   use Espo\ORM\EntityManager;
+
+   public function __construct(private EntityManager $entityManager) {}
+
+   // Find entity
+   $account = $this->entityManager->getEntityById('Account', $id);
+
+   // Query with conditions
+   $collection = $this->entityManager
+       ->getRDBRepository('Contact')
+       ->where(['accountId' => $accountId])
+       ->find();
+   ```
+
+3. **Implement Business Logic in Services**
+   ```php
+   namespace Espo\Modules\MyModule\Services;
+
+   use Espo\Services\Record;
+
+   class MyEntity extends Record {
+       public function customAction(string $id, object $data): object {
+           // Business logic here
+           $entity = $this->entityManager->getEntityById($this->entityType, $id);
+           // ... process ...
+           $this->entityManager->saveEntity($entity);
+           return $entity;
+       }
+   }
+   ```
+
+4. **Register Hooks for Lifecycle Events**
+   ```php
+   namespace Espo\Modules\MyModule\Hooks\Account;
+
+   use Espo\ORM\Entity;
+   use Espo\Core\Hook\Hook\BeforeSave;
+
+   class MyHook implements BeforeSave {
+       public function beforeSave(Entity $entity, array $options): void {
+           // Validation or side effects only
+           if ($entity->isAttributeChanged('status')) {
+               // React to changes
+           }
+       }
+   }
+   ```
+
+5. **Rebuild Cache After Changes**
+   ```bash
+   bin/command rebuild
+   ```
+
+## Hook Types (Interfaces)
+
+EspoCRM provides 7 hook types - ALWAYS use interfaces: `BeforeSave` (validation before save), `AfterSave` (side effects after save), `BeforeRemove` (validation before delete), `AfterRemove` (cleanup after delete), `AfterRelate` (relationship creation), `AfterUnrelate` (relationship removal), `AfterMassRelate` (bulk relationship operations).
+
+## Navigation
+
+For detailed information:
+- **[Architecture](references/architecture.md)**: Metadata system, ORM, DI container, repository pattern, and core architectural patterns
+- **[Development Workflow](references/development-workflow.md)**: Module creation, custom entities, fields, APIs, and extension development process
+- **[Hooks and Services](references/hooks-and-services.md)**: Service layer implementation, hook types, dependency injection, and business logic patterns
+- **[Frontend Customization](references/frontend-customization.md)**: View system, client-side development, and UI customization
+- **[Common Tasks](references/common-tasks.md)**: Scheduled jobs, emails, PDFs, ACL, workflows, and integration patterns
+- **[Testing and Debugging](references/testing-debugging.md)**: Unit tests, debugging techniques, performance optimization, and common pitfalls
+
+## Key Patterns
+
+**Correct Pattern:**
+```php
+✅ Service with injected dependencies
+✅ EntityManager for data access
+✅ Hooks using interfaces
+✅ Type declarations on all methods
+✅ Exceptions for error handling
+```
+
+**Incorrect Patterns:**
+```php
+❌ Passing Container as dependency
+❌ Direct PDO database access
+❌ Business logic in hooks
+❌ Hook base classes instead of interfaces
+❌ Missing type declarations
+```
+
+## Common Mistakes to Avoid
+
+- **Never pass Container** - Inject specific dependencies instead
+- **Don't bypass EntityManager** - Use ORM, not raw queries
+- **Business logic doesn't belong in hooks** - Use Services
+- **Always rebuild cache** - After metadata changes (`bin/command rebuild`)
+- **Use interfaces for hooks** - Not base classes
+- **Type everything** - PHP 7.4+ requires type declarations
+- **Throw exceptions** - Don't return booleans for errors
+
+## Integration with Other Skills
+
+- **systematic-debugging**: Debug EspoCRM issues using logs and step debugging
+- **verification-before-completion**: Always test with cache rebuild before claiming complete
+- **test-driven-development**: Write unit tests for Services and hooks
+
+## The Bottom Line
+
+**EspoCRM is metadata-driven with a service layer architecture.**
+
+Understand the metadata system. Use EntityManager for data. Implement business logic in Services. Use hooks for lifecycle events only. Rebuild cache after changes.
+
+This is the EspoCRM way.