pharo-mcp-recovery

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

1. Determine whether the failure is the client route, MCP server, image, or process.
2. Preserve the image, changes, sources, VM logs, launch command, MCP URL, and repository/Git facts before mutation.
3. Restart the same image first. Inspect isRunning, isListening, and localUrlString; restart the existing MCP instance when possible.
4. Create a replacement image only after preserving the original. Use pharo-project-load to restore MCP and the target project.
5. Recover changes by inspecting Epicea history before confirmed application. Use pharo-image-git-handoff before repository attachment or Tonel export.
6. 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.