.cursorrules

# Mendix MDL Project: mxcli-playground

You are working on a Mendix project with MDL (Mendix Definition Language) support via mxcli.

## Important: mxcli Location

The mxcli tool is in the PROJECT ROOT, not in system PATH. Always use:
- ./mxcli (correct)
- NOT mxcli (will fail)

## Quick Reference

### Project Connection
```bash
./mxcli -p App.mpr -c "SHOW MODULES"
```

### Validate MDL Scripts
```bash
./mxcli check script.mdl                    # Syntax only
./mxcli check script.mdl -p App.mpr --references  # With refs
```

### Execute MDL Scripts
```bash
./mxcli exec script.mdl -p App.mpr
```

### Code Search (requires REFRESH CATALOG FULL)
```bash
./mxcli search -p App.mpr "pattern"
./mxcli callers -p App.mpr Module.Microflow
./mxcli refs -p App.mpr Module.Entity
```

## MDL Syntax Quick Guide

### Microflows
- Variable: `DECLARE $var Type = value;`
- Entity: `DECLARE $entity Module.Entity;` (no AS, no = empty)
- Loop: `LOOP $item IN $list BEGIN ... END LOOP;`
- Change: `CHANGE $obj (Attr = value);`
- If: `IF condition THEN ... END IF;` (not END)
- Log: `LOG WARNING NODE 'Name' 'Message';`

### Pages
- Properties: (Title: 'value', Layout: 'value')
- Widget nesting: curly braces `{ }`
- Widget properties: (Label: 'Name', Attribute: AttrName)

## Documentation

See AGENTS.md for complete documentation and .ai-context/skills/ for patterns.

## Before Writing MDL

1. Read relevant skill file: .ai-context/skills/write-microflows.md or create-page.md
2. Validate: ./mxcli check script.mdl -p App.mpr --references
3. Execute: ./mxcli exec script.mdl -p App.mpr