| name | close-out |
| description | Nightly cash reconciliation, tip split, and waste logging. |
| version | 0.1.0 |
| author | Maya |
| license | MIT |
| platforms | ["macos"] |
| metadata | {"hermes":{"tags":["close-out","cash","tips","waste","nightly"],"requires_toolsets":["terminal"],"config":[]}} |
| required_environment_variables | [] |
Close-Out
Nightly cash reconciliation, tip split, and waste logging. Calculates variance between actual and expected revenue, splits tips 80/20 staff/house, and logs waste items. Writes a reconciliation report to data/close-out/.
When to Use
- At end of each shift or night to reconcile the register
- When Maya needs to log waste from the bar
- When tip splits need to be calculated and recorded
Procedure
python -m skills.close_out --format json \
--cash-count 850.00 \
--card-total 1200.00 \
--expected 2045.00 \
--tip-total 320.00 \
--waste-items "lime:5,beer:2"
Optional: --date YYYY-MM-DD (defaults to today), --data-dir PATH (defaults to data/close-out).
Exit Codes
| Code | Meaning |
|---|
| 0 | OK, variance within threshold |
| 1 | Warnings: cash over/short beyond $5 threshold |
| 2 | Config error |
| 3 | Data error |
| 10 | Unexpected error |
Verification
- Exit code is 0 or 1
- stdout is valid JSON (with --format json)
data field contains variance, tip split, and waste items- Reconciliation file written to data/close-out/YYYY-MM-DD.md
