| name | pharo-mcp-recovery |
| description | Recover an unreachable or crashed standalone Pharo MCP image while preserving logs, image files, changes, repository state, and Epicea history. Use for local MCP restart, replacement-image creation, and image-side change recovery. |
Pharo MCP Recovery
Use project-managed lifecycle tools when they exist. This workflow is for a
standalone image without a safer environment-specific recovery surface.
Workflow
- Determine whether the failure is the client route, MCP server, image, or
process.
- Preserve the image, changes, sources, VM logs, launch command, MCP URL, and
repository/Git facts before mutation.
- Restart the same image first. Inspect
isRunning, isListening, and
localUrlString; restart the existing MCP instance when possible.
- Create a replacement image only after preserving the original. Use
pharo-project-load to restore MCP and the target project.
- Recover changes by inspecting Epicea history before confirmed application.
Use
pharo-image-git-handoff before repository attachment or Tonel export.
- Verify the recovered behavior with focused inspection or tests.
Stop And Ask
Ask before deleting images, resetting repositories, discarding changes,
checking out a branch that changes loaded packages, or applying ambiguous
history entries.
Report
Report the failure boundary, evidence preserved, image used, restart/recovery
actions, recovered behavior, checks run, and unrecovered state.
