---
name: am-i-free
description: Calculate elapsed work time from the Long Day Factory shift record. Use when the user asks whether they can leave or how much time remains.
---

# am-i-free

## Workflow
1. Run `python3 scripts/am_i_free.py`.
2. Interpret its documented exit code. Ask before any option that writes an assumed lunch break.
3. Give the result, remaining time or release time, and a concise friendly message.

## Rules
- Treat malformed or missing state as a recovery question, not a calculation.
- Read `references/state.md` for schema and timezone behavior.
- Do not expose unrelated content from the local state file.

## Output
Report calculation status, remaining time or freedom, and any assumption made.