NOT_FOUND: not a calkit calendar | No .calkit/ above cwd | cd into the calendar, or calkit init |
| command not found | Not on PATH | Kernel: Settings › Utilities › calkit Install. Then open a new shell. |
doctor / validate errors | Broken YAML or missing scope | Read error.message; schema --json |
| Recurrence missing on agenda | You listed definitions, not occurrences | agenda or list --expand |
| All-day rejected | Date-time bounds without --all-day | Date-only --start/--end and --all-day |
| Scope remove refused | Events still in that folder | mv or scope rm --reassign |
| Reminders silent | Cron not loaded / adapter missing | reminders status; reminders test; Bridge/telekit if using Telegram |
| Serve not on phone | Localhost only | Expected. Host the .ics elsewhere for a phone. |
| Dirty tree / mixed edits | Uncommitted mutations | snapshot or ask the human; --require-clean to refuse |
