eighty-six

Files (11)

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

SKILL.md (first lines)

# Eighty-Six

Manage the 86 list of currently unavailable items. Add items when they run out, remove them when restocked, and list what is currently unavailable.

Idempotent. Writes only to data/86/current.md. No PII in output.

## When to Use

- When a bartender reports an item is out (86 it)
- When a delivery arrives and restocks an item (un-86 it)
- Before service to check what is currently unavailable
- When a guest asks about availability

## Procedure

Run the skill from the repo root:

```bash
# List currently 86'd items (default behavior)
python -m skills.eighty_six --format json

# Explicitly list
python -m skills.eighty_six --list --format json

# Add an item to the 86 list
python -m skills.eighty_six --add "Pliny the Elder" --reason "Keg kicked" --reported-by "Alex" --format json

# Remove an item (back in stock)
python -m skills.eighty_six --remove "Pliny the Elder" --format json
```

Parse the JSON result:
- `status`: "ok" (all clear or action completed) or "warn" (items on 86 list)
- `findings`: array with CURRENTLY_86D, ITEM_86D, or ITEM_BACK codes
- `data.items`: list of currently 86'd items (on --list)
- `data.count`: number of 86'd items (on --list)

### Exit Codes

| Code | Meaning |
|------|---------|
| 0 | OK - action completed or no items 86'd |
| 1 | Warn - items currently on the 86 list |
| 2 | Config error (bad arguments) |
| 3 | Data error (can't read/write data file) |
| 10 | Unexpected error |

## Verification

After running, confirm:
- Exit code is 0 or 1 (not 2, 3, or 10)
- stdout is valid JSON (when using --format json)
- For --add: item appears in subsequent --list
- For --remove: item no longer appears in --list

From cvander/Maya, MIT.

More from cvander/Maya