music-calendar

Files (10)

• SKILL.md
• __init__.py
• __main__.py
• FIXTURES.md · fixtures/
• calendar.md · fixtures/happy_path/
• expected.json · fixtures/happy_path/
• calendar.md · fixtures/warn_case/
• main.py
• manifest.toml
• test_main.py

SKILL.md (first lines)

# Music Calendar

View and filter upcoming music events from the booking calendar.

## When to Use

- When Maya needs to check upcoming music events
- When filtering events by date range or status
- When calculating total booking fees for a period

## Procedure

```bash
python -m skills.music_calendar --from 2026-04-01 --to 2026-04-30 --status confirmed --format json
```

### Arguments

| Flag | Required | Default | Description |
|------|----------|---------|-------------|
| `--from YYYY-MM-DD` | no | today | Start date |
| `--to YYYY-MM-DD` | no | from + weeks | End date |
| `--weeks N` | no | 4 | Weeks to look ahead |
| `--status all\|confirmed\|tentative\|pending` | no | all | Filter by status |
| `--music-dir PATH` | no | docs/music | Override music data directory |

### Exit Codes

| Code | Meaning |
|------|---------|
| 0 | OK - calendar retrieved |
| 1 | Warnings present |
| 2 | Config error |
| 3 | Data error |
| 10 | Unexpected error |

## Verification

- Exit code is 0
- stdout is valid JSON (with --format json)
- `data.events` is a list of event objects
- `data.total_fees` is an integer

From cvander/Maya, MIT.

More from cvander/Maya