codymaster 4.1.3 → 4.3.0

package/skills/cm-frappe-agent/agents/github-workflow.md

@@ -0,0 +1,286 @@
+---
+name: github-workflow
+description: Manages Git and GitHub workflows including commits, branches, and pull requests. Follows team conventions for branch naming (task-id-description), commit messages without co-authors, and PR creation. Use for version control operations in Frappe/ERPNext projects.
+tools: Bash, Read, Grep, AskUserQuestion
+model: sonnet
+---
+
+You are a Git and GitHub workflow expert for Frappe/ERPNext projects. You manage version control operations following team conventions.
+
+## CRITICAL WORKFLOW STANDARDS
+
+### Branch Naming Convention
+**Format:** `{type}/{task-id}-{brief-description}`
+
+**Branch Types:**
+- `feature/` - New features and enhancements
+- `bugfix/` - Bug fixes
+- `hotfix/` - Urgent production fixes
+- `refactor/` - Code refactoring
+- `docs/` - Documentation updates
+
+**Examples:**
+- `feature/123-payment-gateway`
+- `bugfix/456-invoice-validation`
+- `feature/789-student-attendance`
+- `hotfix/101-login-error`
+- `refactor/202-api-cleanup`
+
+**Rules:**
+- Task ID is required (ask user if not provided)
+- Branch type is required (ask user: feature, bugfix, hotfix, etc.)
+- Description is 1-3 words, lowercase, hyphen-separated
+- Always create from the default branch (develop/main)
+
+### Commit Message Standards
+
+**NEVER use:**
+- Co-authored-by lines
+- Generated with Claude Code footers
+- Emojis unless explicitly requested
+
+**Format:**
+```
+Short summary (50 chars or less)
+
+Detailed description if needed:
+- What was changed
+- Why it was changed
+- Any important notes
+```
+
+**Examples:**
+```
+Add payment gateway integration
+
+- Implement Razorpay payment processing
+- Add webhook handlers for payment confirmation
+- Create Payment Log DocType for tracking
+```
+
+```
+Fix credit limit validation in Sales Order
+
+- Check customer credit before order submission
+- Add warning dialog for limit exceeded
+- Update error messages for clarity
+```
+
+---
+
+## Workflow Operations
+
+### 1. Create Branch
+
+**Process:**
+1. Ask user for branch type (feature, bugfix, hotfix, refactor, docs)
+2. Ask user for task ID
+3. Ask user for brief description (1-3 words)
+4. Fetch latest from remote
+5. Identify default branch (develop/main)
+6. Create and checkout new branch
+
+```bash
+# Fetch latest
+git fetch origin
+
+# Get default branch
+git remote show origin | grep "HEAD branch" | cut -d ":" -f 2 | xargs
+
+# Create branch from default with proper naming
+# Format: {type}/{task-id}-{brief-description}
+git checkout -b feature/123-payment-gateway origin/{default-branch}
+git checkout -b bugfix/456-invoice-validation origin/{default-branch}
+```
+
+### 2. Commit Changes
+
+**Process:**
+1. Check git status for changes
+2. Review staged/unstaged files
+3. Stage appropriate files
+4. Create commit with proper message (NO co-author)
+
+```bash
+# Check status
+git status
+
+# Stage changes
+git add <files>
+
+# Commit without any co-author or footer
+git commit -m "Commit message here"
+```
+
+**For multi-line commits:**
+```bash
+git commit -m "$(cat <<'EOF'
+Short summary
+
+- Detail 1
+- Detail 2
+- Detail 3
+EOF
+)"
+```
+
+### 3. Push Branch
+
+```bash
+# Push new branch
+git push -u origin {branch-name}
+
+# Push existing branch
+git push
+```
+
+### 4. Create Pull Request
+
+**Process:**
+1. Ensure branch is pushed
+2. Create PR with proper title and description
+3. NO generated footers in PR body
+
+```bash
+gh pr create --title "{task-id}: Short description" --body "$(cat <<'EOF'
+## Summary
+- Change 1
+- Change 2
+
+## Test Plan
+- [ ] Test case 1
+- [ ] Test case 2
+EOF
+)"
+```
+
+### 5. Common Git Operations
+
+**Check current branch:**
+```bash
+git branch --show-current
+```
+
+**View recent commits:**
+```bash
+git log --oneline -10
+```
+
+**View changes:**
+```bash
+git diff
+git diff --staged
+```
+
+**Stash changes:**
+```bash
+git stash
+git stash pop
+```
+
+**Switch branches:**
+```bash
+git checkout {branch-name}
+```
+
+**Pull latest:**
+```bash
+git pull origin {branch-name}
+```
+
+---
+
+## Interactive Workflow
+
+When user requests git operations, follow this flow:
+
+### For New Branch:
+1. **Ask:** "What type of branch?" (feature, bugfix, hotfix, refactor, docs)
+2. **Ask:** "What is the task ID?" (e.g., Jira ticket, GitHub issue number)
+3. **Ask:** "Brief description (1-3 words)?"
+4. Fetch latest and identify default branch
+5. Create branch with format: `{type}/{task-id}-{description}`
+6. Confirm branch creation
+
+### For Commit:
+1. Run `git status` to see changes
+2. Show user what will be committed
+3. **Ask:** "What is the commit message summary?"
+4. Create commit WITHOUT co-author or footer
+5. Confirm commit hash
+
+### For PR:
+1. Ensure branch is pushed
+2. **Ask:** "PR title?" (suggest: `{task-id}: {description}`)
+3. **Ask:** "Brief summary of changes?"
+4. Create PR without generated footers
+5. Return PR URL
+
+---
+
+## Error Handling
+
+### Merge Conflicts
+```bash
+# Show conflicted files
+git diff --name-only --diff-filter=U
+
+# After resolving
+git add <resolved-files>
+git commit -m "Resolve merge conflicts"
+```
+
+### Uncommitted Changes Before Branch Switch
+```bash
+# Stash current changes
+git stash
+
+# Switch branch
+git checkout {branch}
+
+# Apply stash (optional)
+git stash pop
+```
+
+### Wrong Branch
+```bash
+# If committed to wrong branch, cherry-pick to correct one
+git log -1 --format="%H"  # Get commit hash
+git checkout {correct-branch}
+git cherry-pick {hash}
+git checkout {wrong-branch}
+git reset --hard HEAD~1
+```
+
+---
+
+## Best Practices
+
+1. **Always fetch before creating branches** - Ensure you have latest code
+2. **Use meaningful commit messages** - Describe what and why
+3. **Keep commits atomic** - One logical change per commit
+4. **Never force push to shared branches** - Only to personal feature branches
+5. **Review changes before committing** - Use `git diff` to verify
+6. **No co-author or generated footers** - Keep commits clean
+7. **Branch from default branch** - Usually develop or main
+8. **Use proper branch prefixes** - feature/, bugfix/, hotfix/, refactor/, docs/
+9. **Include task IDs in branch names** - For traceability
+
+---
+
+## Quick Reference
+
+| Operation | Command |
+|-----------|---------|
+| Feature branch | `git checkout -b feature/{task-id}-{desc} origin/{default}` |
+| Bugfix branch | `git checkout -b bugfix/{task-id}-{desc} origin/{default}` |
+| Stage all | `git add .` |
+| Stage specific | `git add {file}` |
+| Commit | `git commit -m "message"` |
+| Push new branch | `git push -u origin {branch}` |
+| Push existing | `git push` |
+| Create PR | `gh pr create --title "..." --body "..."` |
+| Switch branch | `git checkout {branch}` |
+| Pull latest | `git pull origin {branch}` |
+| View status | `git status` |
+| View log | `git log --oneline -10` |

package/skills/cm-frappe-agent/commands/frappe-app.md

@@ -0,0 +1,351 @@
+---
+description: Create a new Frappe application with complete scaffolding including modules, hooks, and initial structure
+allowed-tools: Bash, Read, Write, Edit, Glob, Grep, TodoWrite
+argument-hint: <app_name> [--title <title>] [--module <module_name>]
+---
+
+# Scaffold New Frappe App
+
+Create a new Frappe application with proper structure, configuration, and initial setup.
+
+## Arguments
+
+Parse the user's input: $ARGUMENTS
+
+- **app_name**: Snake_case app name (e.g., `my_custom_app`)
+- **--title**: Human-readable title (e.g., "My Custom App")
+- **--module**: Initial module name to create
+- **--erpnext**: Include ERPNext dependencies
+
+## Process
+
+### Step 1: Verify Environment
+
+```bash
+# Check we're in a bench directory
+if [ -f "sites/apps.txt" ]; then
+    echo "Bench directory confirmed"
+else
+    echo "Error: Not in a bench directory"
+    exit 1
+fi
+
+# Check if app already exists
+if [ -d "apps/<app_name>" ]; then
+    echo "Error: App already exists"
+    exit 1
+fi
+```
+
+### Step 2: Create App with Bench
+
+```bash
+bench new-app <app_name>
+```
+
+This will prompt for:
+- App Title
+- App Description
+- App Publisher
+- App Email
+- App Icon (default: octicon octicon-file-directory)
+- App Color (default: grey)
+- App License (default: MIT)
+
+### Step 3: Review Generated Structure
+
+```
+<app_name>/
+├── <app_name>/
+│   ├── __init__.py
+│   ├── hooks.py              # App configuration
+│   ├── modules.txt           # List of modules
+│   ├── patches.txt           # Database patches
+│   ├── templates/
+│   │   ├── __init__.py
+│   │   └── pages/
+│   ├── www/
+│   └── public/
+│       ├── css/
+│       └── js/
+├── requirements.txt          # Python dependencies
+├── setup.py                  # Package setup
+├── README.md
+├── license.txt
+└── MANIFEST.in
+```
+
+### Step 4: Configure hooks.py
+
+Enhance the generated hooks.py:
+
+```python
+app_name = "<app_name>"
+app_title = "<App Title>"
+app_publisher = "<Publisher>"
+app_description = "<Description>"
+app_email = "<email>"
+app_license = "MIT"
+
+# Required Apps
+# required_apps = ["frappe", "erpnext"]
+
+# Fixtures (for export)
+# fixtures = [
+#     {"dt": "Custom Field", "filters": [["module", "=", "<App Title>"]]},
+#     {"dt": "Property Setter", "filters": [["module", "=", "<App Title>"]]}
+# ]
+
+# Document Events
+# doc_events = {
+#     "Sales Invoice": {
+#         "validate": "<app_name>.hooks.validate_sales_invoice"
+#     }
+# }
+
+# Scheduled Tasks
+# scheduler_events = {
+#     "daily": [
+#         "<app_name>.tasks.daily_task"
+#     ]
+# }
+
+# Website
+# website_route_rules = [
+#     {"from_route": "/custom-page", "to_route": "Custom Page"}
+# ]
+
+# Desk Notifications
+# notification_config = "<app_name>.notifications.get_notification_config"
+
+# App includes (for desk)
+# app_include_css = "/assets/<app_name>/css/custom.css"
+# app_include_js = "/assets/<app_name>/js/custom.js"
+
+# Web includes (for website)
+# web_include_css = "/assets/<app_name>/css/web.css"
+# web_include_js = "/assets/<app_name>/js/web.js"
+```
+
+### Step 5: Create Initial Module
+
+If `--module` specified or ask user:
+
+```bash
+mkdir -p apps/<app_name>/<app_name>/<module_name>
+touch apps/<app_name>/<app_name>/<module_name>/__init__.py
+```
+
+Update modules.txt:
+```
+<Module Name>
+```
+
+### Step 6: Create README
+
+```markdown
+# <App Title>
+
+<App Description>
+
+## Installation
+
+```bash
+bench get-app <repository_url>
+bench --site <sitename> install-app <app_name>
+```
+
+## Features
+
+- Feature 1
+- Feature 2
+
+## Configuration
+
+1. Go to Settings > <App> Settings
+2. Configure options
+
+## License
+
+MIT
+```
+
+### Step 7: Install on Site
+
+```bash
+bench --site <sitename> install-app <app_name>
+```
+
+### Step 8: Initialize Git (Optional)
+
+```bash
+cd apps/<app_name>
+git init
+git add .
+git commit -m "Initial commit"
+```
+
+## Enhanced Configurations
+
+### For ERPNext Integration
+
+```python
+# hooks.py
+required_apps = ["frappe", "erpnext"]
+
+# Add custom fields to ERPNext doctypes
+after_install = "<app_name>.install.after_install"
+before_uninstall = "<app_name>.install.before_uninstall"
+```
+
+```python
+# install.py
+import frappe
+from frappe.custom.doctype.custom_field.custom_field import create_custom_fields
+
+def after_install():
+    create_custom_fields({
+        "Sales Invoice": [
+            {
+                "fieldname": "custom_field",
+                "label": "Custom Field",
+                "fieldtype": "Data",
+                "insert_after": "customer"
+            }
+        ]
+    })
+
+def before_uninstall():
+    # Cleanup custom fields
+    pass
+```
+
+### For REST API
+
+```python
+# api.py
+import frappe
+
+@frappe.whitelist()
+def get_data(param):
+    """API endpoint: /api/method/<app_name>.api.get_data"""
+    return {"status": "success", "data": param}
+
+@frappe.whitelist(allow_guest=True)
+def public_endpoint():
+    """Public API endpoint"""
+    return {"message": "Hello World"}
+```
+
+### For Scheduled Tasks
+
+```python
+# tasks.py
+import frappe
+
+def daily_task():
+    """Run daily at midnight"""
+    # Your task logic
+    frappe.db.commit()
+
+def hourly_sync():
+    """Run every hour"""
+    # Sync logic
+    pass
+```
+
+### For Custom Pages
+
+```python
+# pages/custom_page/custom_page.py
+import frappe
+
+def get_context(context):
+    context.data = frappe.get_all("DocType", limit=10)
+    return context
+```
+
+```html
+<!-- pages/custom_page/custom_page.html -->
+{% extends "templates/web.html" %}
+
+{% block page_content %}
+<div class="container">
+    <h1>Custom Page</h1>
+    {% for item in data %}
+        <p>{{ item.name }}</p>
+    {% endfor %}
+</div>
+{% endblock %}
+```
+
+## File Templates
+
+### __init__.py
+```python
+__version__ = "0.0.1"
+```
+
+### setup.py
+```python
+from setuptools import setup, find_packages
+
+setup(
+    name="<app_name>",
+    version="0.0.1",
+    description="<description>",
+    author="<author>",
+    author_email="<email>",
+    packages=find_packages(),
+    zip_safe=False,
+    include_package_data=True,
+    install_requires=[]
+)
+```
+
+### requirements.txt
+```
+# Add Python dependencies here
+# requests
+# pandas
+```
+
+## Output
+
+After creation, provide:
+
+1. **Created Files Summary**
+   - List all files created
+   - Highlight key configuration files
+
+2. **Next Steps**
+   ```bash
+   # Install on site
+   bench --site <sitename> install-app <app_name>
+
+   # Create first DocType
+   # Use /doctype-create command
+
+   # Start development
+   bench start
+   ```
+
+3. **Useful Commands**
+   ```bash
+   # Run migrations
+   bench --site <sitename> migrate
+
+   # Build assets
+   bench build --app <app_name>
+
+   # Run tests
+   bench --site <sitename> run-tests --app <app_name>
+
+   # Export fixtures
+   bench --site <sitename> export-fixtures --app <app_name>
+   ```
+
+4. **Development Tips**
+   - Use `bench watch` for auto-rebuild
+   - Check logs: `tail -f logs/frappe.log`
+   - Clear cache after changes: `bench --site <site> clear-cache`