CLAUDE.md for the assistant folder, plus the capability roadmap.
The rules worth reading before editing either file:
- `truncated` is not optional to handle; an intent that reads scan.rows and
ignores it reintroduces the silent under-reporting this replaced.
- Order status comes from utils/orderStatusGroups.js, not api.js's
Deliveries taxonomy, and the two must not be merged.
- State questions ("how many are assigned") must not default to today;
flow questions ("how many orders today") still do.
- orderQuery must not widen to claim single-dimension questions.
- Never put a React element in message state — localStorage round-trips it.
ROADMAP.md carries the analysis and the L0-L8 capability ladder, including
what is deliberately still out of scope: write actions pending a confirm
gate, and any LLM step pending a decision on where its key would live.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>