vendor-order

Files (11)

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

SKILL.md (first lines)

# Vendor Order

Takes vendor-order-review JSON output and a vendor name. Filters orders for that vendor and formats as copy-paste-ready plain text.

Read-only. Does not modify files or reach external services. No PII in output.

## When to Use

- After running vendor-order-review, to generate a specific vendor's order
- When preparing to email or call in an order
- Monday/Tuesday order placement workflow

## Procedure

Run the skill from the repo root:

```bash
# Generate order for a specific vendor
python -m skills.vendor_order --vendor "Southern Glazer's" --input-file /tmp/review.json --format json
```

Parse the JSON result:
- `status`: "ok" (no orders for vendor) or "warn" (order draft generated)
- `data.order_text`: plain text order ready to copy-paste
- `data.vendor`: matched vendor name
- `data.items_count`: number of items in the order

### Exit Codes

| Code | Meaning |
|------|---------|
| 0 | No orders for specified vendor |
| 1 | Order draft generated |
| 2 | Config error (bad arguments) |
| 3 | Data error (can't read input) |
| 10 | Unexpected error |

## Verification

- Exit code is 0 or 1
- stdout is valid JSON (with --format json)
- `data.order_text` is non-empty when status is "warn"

From cvander/Maya, MIT.

More from cvander/Maya