Report a problem
Call this skill when the user complains about Iva ("you did not remind me again", "you do not answer"), when a schedule, a tool or a delivery failed on its own, or after three failed attempts in a row.
- Collect the evidence: run
iva diagnosein bash. It writesdata/diagnose/<date>.mdand prints the path. Read the package before saying anything: versions, host, the wholeiva doctoroutput, the last 200 journal lines, the day's reminder facts and failed turns, the custom-layer file names. Look at its third line — it says what was cut and by what list. - Tell the owner what happened in two lines: what broke and what the package shows about it. Do not paste the package into the chat.
- Offer the two ways out and wait for an explicit "yes" — publishing is the owner's move:
- Issue: the ready link
https://github.com/smixs/iva-agent/issues/new?title=<two-line summary, URL-encoded>&body=<package cut to 6000 characters, URL-encoded>. - Support chat: the address is the
SUPPORT_CHAT_URLsetting in.env. Give the owner the text to paste: the two lines of substance, the package path, and one line about the redaction, taken from the package's own header (N values from .env, pattern rules always on). NoSUPPORT_CHAT_URL— say the address is not configured and the owner should ask the admin.
- Issue: the ready link
- Send nothing yourself: no issue, no message, no webhook. Cutting secrets is the code's work, not yours, and the file stays on the machine until the owner attaches it.
- When the package says
.env not found(oriva diagnosewarned about it in the terminal), only the pattern rules ran — bot tokens, labelled telegram ids and e-mail addresses — and the values of the keys could not be cut at all. Never promise "no secrets" in that case: say plainly that the package was collected without the.envlist, suggest fixing.env(oriva config) and runningiva diagnoseagain before publishing, and let the owner decide.