agents-lab

Local-first lab for reusable AI-agent primitives and the curated pi-stack.

View on GitHub

Reload lifecycle diagnostic

reload_lifecycle_diagnostic_packet is a read-only packet for slow or unclear Pi reloads. It does not run /reload, restart Pi, run tests, change settings, or approve continuation.

Use it when reload still appears to be moving but the operator cannot tell whether it is slow, blocked, or only waiting on a known phase.

Phases

The packet uses five bounded phases:

Evidence To Capture

Decisions

Recovery

Do not start with a destructive restart. Capture the packet and handoff evidence first.

If the session is still responsive, prefer /safe-mode on, /safe-boot recover, or /doctor before restarting. If it is not responsive, start a fresh control-plane session only after checkpoint evidence is saved.