@evref-bl/pharo-agent 0.5.4 → 0.5.5

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pharo-agent",
   "displayName": "Pharo Agent",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Terminal-first Pharo image setup for coding agents.",
   "author": {
     "name": "Evref-BL",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evref-bl/pharo-agent",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "private": false,
   "description": "Terminal-first Pharo integration for coding agents.",
   "license": "Apache-2.0",
@@ -31,9 +31,9 @@
     "test": "node --test"
   },
   "dependencies": {
-    "@evref-bl/pharo-mcp": "2.1.0",
-    "@evref-bl/plexus": "0.5.4",
-    "@evref-bl/plexus-gateway": "0.5.4",
+    "@evref-bl/pharo-mcp": "2.1.1",
+    "@evref-bl/plexus": "0.5.5",
+    "@evref-bl/plexus-gateway": "0.5.5",
     "@modelcontextprotocol/sdk": "1.32.1"
   }
 }

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "pharo-agent",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Terminal-first Pharo image setup for coding agents.",
   "author": {
     "name": "Evref-BL",

package/skills/pharo-setup/SKILL.md

@@ -8,7 +8,7 @@ Run this only when the user asks to enable Pharo tooling in this project.
 From the project root, run the released CLI that matches this plugin:
 
 ```sh
-npx --yes @evref-bl/pharo-agent@0.5.4 init --host claude
+npx --yes @evref-bl/pharo-agent@0.5.5 init --host claude
 ```
 
 Name the host this chat runs in: `--host claude` in Claude Code,

package/src/live.js

@@ -12,6 +12,7 @@ import { callImageTool } from "./gateway.js";
 import { readProjectConfig, writeProjectConfig } from "./project.js";
 import {
   defaultImageId,
+  openedImageIsAlive,
   readConfig,
   readOpenImages,
   resolveImageId,
@@ -22,7 +23,7 @@ import {
   writeOpenImages,
 } from "./runtime.js";
 
-export const pifsRelease = "v0.6.1";
+export const pifsRelease = "v0.6.2";
 
 // The class-side PIFSServer messages this plugin sends into the image. The
 // release automation checks that a published PIFS still implements them: a pin
@@ -186,9 +187,18 @@ export function fetchPifsRelease(cloneDirectory, release = pifsRelease) {
 
 export async function openAgentImage(projectRoot, imageId) {
   const resolved = resolveImageId(projectRoot, imageId);
-  const openImages = readOpenImages(projectRoot);
+  let openImages = readOpenImages(projectRoot);
+  let restarted = false;
   if (openImages[resolved]) {
-    return { alreadyOpen: true, ...openImages[resolved] };
+    if (openedImageIsAlive(openImages[resolved])) {
+      return { alreadyOpen: true, ...openImages[resolved] };
+    }
+    // The image this record names has exited. Forget it and open again,
+    // rather than hand back an endpoint nothing answers and say it is open.
+    const { [resolved]: exited, ...remaining } = openImages;
+    openImages = remaining;
+    writeOpenImages(projectRoot, openImages);
+    restarted = true;
   }
   fetchPifsRelease(pifsCloneDirectory(projectRoot));
   const launcher = new ScopedPharoLauncher({ projectRoot });
@@ -243,6 +253,7 @@ export async function openAgentImage(projectRoot, imageId) {
   return {
     imageId: image.id,
     created,
+    ...(restarted ? { restarted } : {}),
     mountPath,
     projectionPort,
     ...(unappliedPin ? { warning: unappliedPin } : {}),

package/src/runtime.js

@@ -99,6 +99,32 @@ export function readOpenImage(projectRoot, imageId) {
   return open;
 }
 
+// A record in the project's runtime state says this project opened the image,
+// not that the image is still there. PLexus reclaims a dead image's port and
+// relaunches on the next open, so the only thing standing between a crashed
+// image and a working one is believing the record.
+export function imageProcessIsAlive(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    // The process is someone else's, which is still a process.
+    return error.code === "EPERM";
+  }
+}
+
+export function openedImageIsAlive(open) {
+  let state;
+  try {
+    state = readJson(open.statePath);
+  } catch {
+    return false;
+  }
+  const image = (state.images ?? []).find((candidate) => candidate.id === open.imageId);
+  return image?.status === "running" && imageProcessIsAlive(image.pid);
+}
+
 export function resolveMountPath(projectRoot, config, imageId) {
   const root = config.mountRoot ?? ".pharo-agent/mounts";
   return path.resolve(projectRoot, root, imageId);