@evref-bl/pharo-agent 0.7.0 → 0.9.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pharo-agent",
   "displayName": "Pharo Agent",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "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.7.0",
+  "version": "0.9.0",
   "private": false,
   "description": "Terminal-first Pharo integration for coding agents.",
   "license": "Apache-2.0",
@@ -31,9 +31,8 @@
     "test": "node --test"
   },
   "dependencies": {
-    "@evref-bl/pharo-mcp": "3.0.0",
-    "@evref-bl/plexus": "0.6.0",
-    "@evref-bl/plexus-gateway": "0.6.0",
+    "@evref-bl/pharo-mcp": "3.2.0",
+    "@evref-bl/plexus": "0.8.0",
     "@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.7.0",
+  "version": "0.9.0",
   "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 or refresh Pharo tooling in this proj
 From the project root, run the released CLI that matches this plugin:
 
 ```sh
-npx --yes @evref-bl/pharo-agent@0.7.0 init --host claude
+npx --yes @evref-bl/pharo-agent@0.9.0 init --host claude
 ```
 
 Name the host this chat runs in: `--host claude` in Claude Code,

package/src/gateway.js

@@ -1,5 +1,5 @@
 import { createRequire } from "node:module";
-import { PlexusGateway } from "@evref-bl/plexus-gateway";
+import { PlexusGateway } from "@evref-bl/plexus/gateway";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {

package/src/init.js

@@ -71,6 +71,42 @@ function guidance() {
   return `# Pharo work\n\nWhen the task uses Pharo, read \`pharo.AGENTS.md\` before acting.\n`;
 }
 
+// MCP ships the references and skills, so which one answers what is its to
+// state. Repeating the list here went stale the first time a template was
+// renamed, and sent readers to files that are no longer installed. Only the
+// paths differ, because init copies the two template directories under
+// `.pharo-agent`.
+function pharoRouting() {
+  const templates = mcpTemplateDirectory();
+  const guide = fs.readFileSync(path.join(templates, "pharo.AGENTS.md"), "utf8");
+  const guidance = guide.indexOf("## Read First");
+  if (guidance === -1) {
+    throw new Error("The MCP agent guide no longer opens its guidance with ## Read First");
+  }
+  const routing = guide
+    .slice(guidance)
+    .replaceAll("pharo-references/", ".pharo-agent/references/")
+    .replaceAll("pharo-skills/", ".pharo-agent/skills/")
+    .replaceAll("skills/", ".pharo-agent/skills/")
+    .replaceAll(".pharo-agent/.pharo-agent/", ".pharo-agent/")
+    .trimEnd();
+  assertRoutingResolves(routing, templates);
+  return routing;
+}
+
+// A path the routing names must be a file MCP actually provides, so a renamed
+// template stops init here rather than pointing a reader at nothing.
+function assertRoutingResolves(routing, templates) {
+  const directoryNames = { references: "pharo-references", skills: "pharo-skills" };
+  for (const [target, directory, relative] of routing.matchAll(
+    /\.pharo-agent\/(references|skills)\/([\w./-]+\.md)/g,
+  )) {
+    if (!fs.existsSync(path.join(templates, directoryNames[directory], relative))) {
+      throw new Error(`The MCP agent guide names ${target}, which no template provides`);
+    }
+  }
+}
+
 function pharoGuide() {
   return `# Pharo project guide
 
@@ -124,32 +160,7 @@ everything this project opened.
 
 Image, Tonel, Iceberg, disk Git, and host processes are separate states.
 
-## Read first
-
-- Before Pharo source changes, read the project guidance. If absent, read the
-  local [coding rules](.pharo-agent/references/pharo-coding-rules.md) and
-  [coding style](.pharo-agent/references/pharo-coding-style.md).
-- Before loading a project, read
-  [.pharo-agent/skills/pharo-project-load/SKILL.md](.pharo-agent/skills/pharo-project-load/SKILL.md).
-- Before cross-version work, read
-  [.pharo-agent/skills/pharo-version-compat/SKILL.md](.pharo-agent/skills/pharo-version-compat/SKILL.md).
-- Before exporting image changes or changing Git state, read
-  [.pharo-agent/skills/pharo-image-git-handoff/SKILL.md](.pharo-agent/skills/pharo-image-git-handoff/SKILL.md).
-- Before reproducing smalltalkCI or GitHub failures, read
-  [.pharo-agent/skills/pharo-ci-repro/SKILL.md](.pharo-agent/skills/pharo-ci-repro/SKILL.md).
-- Before recovering a stopped standalone image, read
-  [.pharo-agent/skills/pharo-mcp-recovery/SKILL.md](.pharo-agent/skills/pharo-mcp-recovery/SKILL.md).
-- Before debugger sessions or repairs, read the local
-  [debugging guide](.pharo-agent/references/debugging.md).
-
-## Workflow
-
-1. Inspect the tool schema before acting; do not rely on remembered names.
-2. Prefer the least-mutating dedicated tool; use \`image_evaluate\` only when
-   no dedicated tool fits.
-3. Verify identity before mutation, make the narrowest change, then run focused
-   tests.
-4. Use the image-to-Git handoff skill before export or commit.
+${pharoRouting()}
 `;
 }
 

package/src/live.js

@@ -3,10 +3,10 @@ import fs from "node:fs";
 import path from "node:path";
 import {
   ScopedPharoLauncher,
-  closeProject,
   homeDependencyRepositoryCachePath,
-  openProject,
   resolvePlexusHomePath,
+  startProjectImage,
+  stopProjectImage,
 } from "@evref-bl/plexus";
 import { callImageTool } from "./gateway.js";
 import { readProjectConfig, writeProjectConfig } from "./project.js";
@@ -23,7 +23,7 @@ import {
   writeOpenImages,
 } from "./runtime.js";
 
-export const pifsRelease = "v0.7.0";
+export const pifsRelease = "v0.9.0";
 
 // The class-side PIFSServer messages this plugin sends into the image. The
 // release automation checks that a published PIFS still implements them: a pin
@@ -153,7 +153,7 @@ export function describeLifecycleFailure(failure) {
     .join("\n  ");
 }
 
-// openProject and closeProject throw on failure, carrying the failures on the error.
+// startProjectImage and stopProjectImage throw on failure, carrying the failures on the error.
 export async function runLifecycle(action, fallback) {
   try {
     return await action();
@@ -210,7 +210,7 @@ export async function openAgentImage(projectRoot, imageId) {
     await launcher.createImage(resolved);
   }
   const opened = await runLifecycle(
-    () => openProject({ projectRoot, imageIds: [resolved] }),
+    () => startProjectImage({ projectRoot, imageId: resolved }),
     `PLexus could not open image ${resolved}.`,
   );
   let image;
@@ -224,7 +224,7 @@ export async function openAgentImage(projectRoot, imageId) {
     const withoutMcp = unsupportedRunningImage(opened.state, resolved);
     if (!withoutMcp) {
       // The image is running but unusable to us, so do not leave it behind.
-      await closeProject({ projectRoot, imageIds: [resolved] }).catch(() => {});
+      await stopProjectImage({ projectRoot, imageId: resolved }).catch(() => {});
       throw error;
     }
     const open = { statePath: opened.statePath, imageId: resolved, mcp: false };
@@ -245,7 +245,7 @@ export async function openAgentImage(projectRoot, imageId) {
   } catch (error) {
     // The projection is half-started at best and nothing records it yet, so
     // close the image rather than leave an image and a mount nothing owns.
-    await closeProject({ projectRoot, imageIds: [resolved] }).catch(() => {});
+    await stopProjectImage({ projectRoot, imageId: resolved }).catch(() => {});
     throw error;
   }
   writeOpenImages(projectRoot, { ...openImages, [resolved]: { ...open, projectionPort } });
@@ -302,7 +302,7 @@ async function closeOneImage(projectRoot, openImages, imageId) {
     }
   }
   const closed = await runLifecycle(
-    () => closeProject({ projectRoot, imageIds: [imageId] }),
+    () => stopProjectImage({ projectRoot, imageId }),
     `PLexus could not close image ${imageId}.`,
   );
   return { stoppedImages: closed.stoppedImages.map((image) => image.id), projectionError };