Replayable Automation Needs a Small Evidence Log

Описание и применение

Автоматизация становится воспроизводимой и безопасной благодаря уникальному идентификатору выполнения, структурированному журналу событий и разделению планирования и исполнения.

Задача

Scheduled cron jobs often report only a boolean success, leaving no trace of inputs, decisions, or side effects, making debugging and safe retries difficult.

Результат

Automations become self‑documenting, safe to retry, and easier to debug because every step is logged and tied to a stable run ID.

Рабочий процесс

• Create a unique run ID before any work starts
• Record context (available resources) in context.json
• Generate a deterministic plan and store in plan.json
• Produce input artifacts (e.g., input.md) once
• Execute external actions, logging each state transition to events.jsonl
• After completion, write final result to result.json
• Use run ID or idempotency key to guard against duplicate side effects
• On retry, inspect events.jsonl to decide whether to continue, reconcile, or halt for review

Доказательства

The smallest useful receipt has a stable run ID and a few facts: ...

Источник

Retries are not automatically safe. Ask what the job did before it failed: ...

Источник