@evref-bl/plexus-core 0.1.0-alpha.0

package/dist/projectOpen.js

@@ -0,0 +1,218 @@
+import path from "node:path";
+import { loadProjectConfig } from "./projectConfig.js";
+import { createStdioPharoLauncherMcpClient, } from "./pharoLauncherMcpClient.js";
+import { HttpPharoMcpHealthClient, } from "./pharoMcpHealth.js";
+import { collectReservedProjectPorts, createProjectState, defaultWorkspaceId, loadProjectState, projectStatePathForConfig, sanitizeRuntimeId, saveProjectState, } from "./projectState.js";
+import { writeProjectImageStartupScript } from "./projectStartupScript.js";
+export class ProjectOpenError extends Error {
+    result;
+    constructor(message, result) {
+        super(message);
+        this.result = result;
+        this.name = "ProjectOpenError";
+    }
+}
+function defaultSleep(durationMs) {
+    return new Promise((resolve) => setTimeout(resolve, durationMs));
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function closeClientQuietly(client) {
+    void client.close?.().catch(() => undefined);
+}
+function processMatchesImage(process, imageName) {
+    return (process.imageName === imageName ||
+        path.basename(process.imagePath ?? "", ".image") === imageName ||
+        process.commandLine.includes(`${imageName}.image`) ||
+        process.commandLine.includes(imageName));
+}
+function launcherResultData(result) {
+    return result.ok ? result.data : undefined;
+}
+function assertLauncherOk(result, toolName) {
+    if (result && result.ok === false) {
+        throw new Error(`${toolName} returned ok: false`);
+    }
+}
+async function pollUntil(timeoutMs, intervalMs, sleep, attempt) {
+    const startedAt = Date.now();
+    while (Date.now() - startedAt <= timeoutMs) {
+        const result = await attempt();
+        if (result !== undefined) {
+            return result;
+        }
+        await sleep(intervalMs);
+    }
+    return undefined;
+}
+async function pollProcessForImage(client, imageName, timeoutMs, intervalMs, sleep) {
+    return pollUntil(timeoutMs, intervalMs, sleep, async () => {
+        const result = await client.callTool("pharo_launcher_process_list", {});
+        assertLauncherOk(result, "pharo_launcher_process_list");
+        const processes = launcherResultData(result) ?? [];
+        return processes.find((process) => processMatchesImage(process, imageName));
+    });
+}
+async function pollHealth(healthClient, port, timeoutMs, intervalMs, sleep) {
+    const result = await pollUntil(timeoutMs, intervalMs, sleep, async () => (await healthClient.check(port)) ? true : undefined);
+    return result === true;
+}
+async function launchImageAndPollProcess(launchClient, processClient, imageName, startupScriptPath, timeoutMs, intervalMs, sleep) {
+    const launchOutcome = launchClient
+        .callTool("pharo_launcher_image_launch", {
+        imageName,
+        detached: true,
+        script: startupScriptPath,
+    })
+        .then((result) => ({ kind: "launch", result }), (error) => ({ kind: "launchError", error }));
+    const immediateLaunch = await Promise.race([
+        launchOutcome,
+        new Promise((resolve) => setTimeout(() => resolve(undefined), 0)),
+    ]);
+    if (immediateLaunch?.kind === "launchError") {
+        throw immediateLaunch.error;
+    }
+    if (immediateLaunch?.kind === "launch") {
+        assertLauncherOk(immediateLaunch.result, "pharo_launcher_image_launch");
+        const process = await pollProcessForImage(processClient, imageName, timeoutMs, intervalMs, sleep);
+        if (process) {
+            return process;
+        }
+        throw new Error(`Timed out waiting for PharoLauncher process for image ${imageName}`);
+    }
+    const processOutcome = pollProcessForImage(processClient, imageName, timeoutMs, intervalMs, sleep).then((process) => ({ kind: "process", process }));
+    const first = await Promise.race([launchOutcome, processOutcome]);
+    if (first.kind === "launchError") {
+        throw first.error;
+    }
+    if (first.kind === "launch") {
+        assertLauncherOk(first.result, "pharo_launcher_image_launch");
+        const { process } = await processOutcome;
+        if (process) {
+            return process;
+        }
+    }
+    else if (first.process) {
+        return first.process;
+    }
+    throw new Error(`Timed out waiting for PharoLauncher process for image ${imageName}`);
+}
+function activeStateImages(state) {
+    return state.images.filter((image) => image.status === "starting");
+}
+function applyScopedImageSelection(state, imageIds) {
+    if (!imageIds) {
+        return;
+    }
+    const selectedIds = new Set(imageIds);
+    for (const image of state.images) {
+        if (!selectedIds.has(image.id)) {
+            image.status = "stopped";
+        }
+    }
+}
+export async function openProject(options) {
+    const projectRoot = path.resolve(options.projectRoot);
+    const config = loadProjectConfig(projectRoot);
+    const workspaceId = options.workspaceId
+        ? sanitizeRuntimeId(options.workspaceId)
+        : defaultWorkspaceId(projectRoot);
+    const statePath = projectStatePathForConfig({
+        projectRoot,
+        config,
+        workspaceId,
+        stateRoot: options.stateRoot,
+    });
+    const previousState = loadProjectState(statePath);
+    const now = options.now ?? (() => new Date());
+    const reservedPorts = collectReservedProjectPorts({
+        projectRoot,
+        projectId: config.kanban.projectId,
+        stateRoot: options.stateRoot,
+        excludeWorkspaceId: workspaceId,
+    });
+    const state = createProjectState(config, {
+        updatedAt: now().toISOString(),
+        previousState,
+        workspaceId,
+        targetId: options.targetId,
+        reservedPorts,
+        ...(options.portRange ? { portRange: options.portRange } : {}),
+    });
+    applyScopedImageSelection(state, options.imageIds);
+    const client = options.pharoLauncherMcpClient ??
+        (await createStdioPharoLauncherMcpClient());
+    const ownsClient = !options.pharoLauncherMcpClient;
+    const healthClient = options.healthClient ?? new HttpPharoMcpHealthClient();
+    const poll = {
+        intervalMs: options.poll?.intervalMs ?? 500,
+        processTimeoutMs: options.poll?.processTimeoutMs ?? 30_000,
+        healthTimeoutMs: options.poll?.healthTimeoutMs ?? 5 * 60_000,
+    };
+    const sleep = options.sleep ?? defaultSleep;
+    const failures = [];
+    try {
+        for (const imageState of activeStateImages(state)) {
+            const imageConfig = config.images.find((image) => image.id === imageState.id);
+            if (!imageConfig) {
+                continue;
+            }
+            try {
+                const startupScript = writeProjectImageStartupScript({
+                    projectRoot,
+                    config,
+                    imageId: imageState.id,
+                    imageState,
+                    workspaceId,
+                    stateRoot: options.stateRoot,
+                });
+                const launchClient = options.pharoLauncherMcpClient
+                    ? client
+                    : await createStdioPharoLauncherMcpClient();
+                const ownsLaunchClient = !options.pharoLauncherMcpClient;
+                try {
+                    const process = await launchImageAndPollProcess(launchClient, client, imageState.imageName, startupScript.filePath, poll.processTimeoutMs, poll.intervalMs, sleep);
+                    imageState.pid = process.pid;
+                    const healthy = await pollHealth(healthClient, imageState.assignedPort, poll.healthTimeoutMs, poll.intervalMs, sleep);
+                    if (!healthy) {
+                        throw new Error(`Timed out waiting for Pharo MCP health on port ${imageState.assignedPort}`);
+                    }
+                }
+                finally {
+                    if (ownsLaunchClient) {
+                        closeClientQuietly(launchClient);
+                    }
+                }
+                imageState.status = "running";
+            }
+            catch (error) {
+                imageState.status = "failed";
+                failures.push({
+                    imageId: imageState.id,
+                    imageName: imageState.imageName,
+                    message: errorMessage(error),
+                });
+            }
+        }
+        state.updatedAt = now().toISOString();
+        saveProjectState(statePath, state);
+        const result = {
+            ok: failures.length === 0,
+            projectRoot,
+            statePath,
+            state,
+            failures,
+        };
+        if (!result.ok) {
+            throw new ProjectOpenError("One or more project images failed to open", result);
+        }
+        return result;
+    }
+    finally {
+        if (ownsClient) {
+            await client.close?.();
+        }
+    }
+}
+//# sourceMappingURL=projectOpen.js.map

package/dist/projectOpen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectOpen.js","sourceRoot":"","sources":["../src/projectOpen.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EACL,iCAAiC,GAElC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,wBAAwB,GAEzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,GAIjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAgD3E,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGvB;IAFlB,YACE,OAAe,EACC,MAAyB;QAEzC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAAmB;QAGzC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,SAAS,YAAY,CAAC,UAAkB;IACtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAkC;IAC5D,KAAK,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,mBAAmB,CAC1B,OAAwB,EACxB,SAAiB;IAEjB,OAAO,CACL,OAAO,CAAC,SAAS,KAAK,SAAS;QAC/B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,EAAE,QAAQ,CAAC,KAAK,SAAS;QAC9D,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,SAAS,QAAQ,CAAC;QAClD,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAI,MAAgC;IAC7D,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAyC,EACzC,QAAgB;IAEhB,IAAI,MAAM,IAAI,MAAM,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,qBAAqB,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAWD,KAAK,UAAU,SAAS,CACtB,SAAiB,EACjB,UAAkB,EAClB,KAA4C,EAC5C,OAAqC;IAErC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;QAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,MAAkC,EAClC,SAAiB,EACjB,SAAiB,EACjB,UAAkB,EAClB,KAA4C;IAE5C,OAAO,SAAS,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAClC,6BAA6B,EAC7B,EAAE,CACH,CAAC;QACF,gBAAgB,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAEnD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,YAAkC,EAClC,IAAY,EACZ,SAAiB,EACjB,UAAkB,EAClB,KAA4C;IAE5C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,CACtE,CAAC,MAAM,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CACpD,CAAC;IAEF,OAAO,MAAM,KAAK,IAAI,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,YAAwC,EACxC,aAAyC,EACzC,SAAiB,EACjB,iBAAyB,EACzB,SAAiB,EACjB,UAAkB,EAClB,KAA4C;IAE5C,MAAM,aAAa,GAAG,YAAY;SAC/B,QAAQ,CAAwB,6BAA6B,EAAE;QAC9D,SAAS;QACT,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,iBAAiB;KAC1B,CAAC;SACD,IAAI,CACH,CAAC,MAAM,EAAiB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EACvD,CAAC,KAAK,EAAiB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAC3D,CAAC;IACJ,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;QACzC,aAAa;QACb,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE,CACjC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CACxC;KACF,CAAC,CAAC;IAEH,IAAI,eAAe,EAAE,IAAI,KAAK,aAAa,EAAE,CAAC;QAC5C,MAAM,eAAe,CAAC,KAAK,CAAC;IAC9B,CAAC;IAED,IAAI,eAAe,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvC,gBAAgB,CACd,eAAe,CAAC,MAAM,EACtB,6BAA6B,CAC9B,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,mBAAmB,CACvC,aAAa,EACb,SAAS,EACT,SAAS,EACT,UAAU,EACV,KAAK,CACN,CAAC;QACF,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,IAAI,KAAK,CACb,yDAAyD,SAAS,EAAE,CACrE,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,mBAAmB,CACxC,aAAa,EACb,SAAS,EACT,SAAS,EACT,UAAU,EACV,KAAK,CACN,CAAC,IAAI,CAAiB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;IAElE,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACjC,MAAM,KAAK,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;QAE9D,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,CAAC;QACzC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,yDAAyD,SAAS,EAAE,CACrE,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAmB;IAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,yBAAyB,CAChC,KAAmB,EACnB,QAA8B;IAE9B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAA2B;IAE3B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW;QACrC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC;QACxC,CAAC,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,yBAAyB,CAAC;QAC1C,WAAW;QACX,MAAM;QACN,WAAW;QACX,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,2BAA2B,CAAC;QAChD,WAAW;QACX,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS;QAClC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,kBAAkB,EAAE,WAAW;KAChC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,EAAE;QACvC,SAAS,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;QAC9B,aAAa;QACb,WAAW;QACX,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,aAAa;QACb,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAC,CAAC;IACH,yBAAyB,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,MAAM,GACV,OAAO,CAAC,sBAAsB;QAC9B,CAAC,MAAM,iCAAiC,EAAE,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,sBAAsB,CAAC;IACnD,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY,IAAI,IAAI,wBAAwB,EAAE,CAAC;IACzD,MAAM,IAAI,GAAG;QACX,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,IAAI,GAAG;QAC3C,gBAAgB,EAAE,OAAO,CAAC,IAAI,EAAE,gBAAgB,IAAI,MAAM;QAC1D,eAAe,EAAE,OAAO,CAAC,IAAI,EAAE,eAAe,IAAI,CAAC,GAAG,MAAM;KAC7D,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC5C,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAE1C,IAAI,CAAC;QACH,KAAK,MAAM,UAAU,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,EAAE,CAAC,CAAC;YAC9E,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,8BAA8B,CAAC;oBACnD,WAAW;oBACX,MAAM;oBACN,OAAO,EAAE,UAAU,CAAC,EAAE;oBACtB,UAAU;oBACV,WAAW;oBACX,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B,CAAC,CAAC;gBAEH,MAAM,YAAY,GAAG,OAAO,CAAC,sBAAsB;oBACjD,CAAC,CAAC,MAAM;oBACR,CAAC,CAAC,MAAM,iCAAiC,EAAE,CAAC;gBAC9C,MAAM,gBAAgB,GAAG,CAAC,OAAO,CAAC,sBAAsB,CAAC;gBACzD,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAC7C,YAAY,EACZ,MAAM,EACN,UAAU,CAAC,SAAS,EACpB,aAAa,CAAC,QAAQ,EACtB,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,UAAU,EACf,KAAK,CACN,CAAC;oBACF,UAAU,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;oBAE7B,MAAM,OAAO,GAAG,MAAM,UAAU,CAC9B,YAAY,EACZ,UAAU,CAAC,YAAY,EACvB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,UAAU,EACf,KAAK,CACN,CAAC;oBACF,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,MAAM,IAAI,KAAK,CACb,kDAAkD,UAAU,CAAC,YAAY,EAAE,CAC5E,CAAC;oBACJ,CAAC;gBACH,CAAC;wBAAS,CAAC;oBACT,IAAI,gBAAgB,EAAE,CAAC;wBACrB,kBAAkB,CAAC,YAAY,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC;gBAED,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC;YAChC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,UAAU,CAAC,MAAM,GAAG,QAAQ,CAAC;gBAC7B,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,UAAU,CAAC,EAAE;oBACtB,SAAS,EAAE,UAAU,CAAC,SAAS;oBAC/B,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,KAAK,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;QACtC,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAEnC,MAAM,MAAM,GAAsB;YAChC,EAAE,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;YACzB,WAAW;YACX,SAAS;YACT,KAAK;YACL,QAAQ;SACT,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,gBAAgB,CAAC,2CAA2C,EAAE,MAAM,CAAC,CAAC;QAClF,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/projectStartupScript.d.ts

@@ -0,0 +1,56 @@
+import type { ProjectConfig, ProjectImageConfig } from "./projectConfig.js";
+import { type ProjectImageState, type ProjectStatePathOptions } from "./projectState.js";
+export declare const projectScriptsDirectoryName = "scripts";
+export declare const defaultPharoMcpMetacelloRepository: {
+    readonly githubUser: "Evref-BL";
+    readonly project: "MCP";
+    readonly commitish: "main";
+    readonly path: "";
+    readonly baseline: "MCP";
+};
+export interface PharoMcpMetacelloRepository {
+    githubUser: string;
+    project: string;
+    commitish: string;
+    path: string;
+    baseline: string;
+}
+export interface ProjectScriptsDirectoryPathOptions extends ProjectStatePathOptions {
+}
+export interface ProjectImageStartupScriptPathOptions extends ProjectStatePathOptions {
+    imageId: string;
+}
+export interface GenerateImageStartupScriptOptions {
+    projectRoot: string;
+    imageConfig: ProjectImageConfig;
+    imageState: ProjectImageState;
+    repository?: PharoMcpMetacelloRepository;
+}
+export interface WriteImageStartupScriptOptions extends GenerateImageStartupScriptOptions {
+    projectId: string;
+    workspaceId?: string;
+    stateRoot?: string;
+}
+export interface WriteProjectImageStartupScriptOptions {
+    projectRoot: string;
+    config: ProjectConfig;
+    imageId: string;
+    imageState: ProjectImageState;
+    workspaceId?: string;
+    stateRoot?: string;
+    repository?: PharoMcpMetacelloRepository;
+}
+export interface WrittenImageStartupScript {
+    filePath: string;
+    source: string;
+}
+export declare class ProjectStartupScriptError extends Error {
+    constructor(message: string);
+}
+export declare function projectScriptsDirectoryPath(options: ProjectScriptsDirectoryPathOptions): string;
+export declare function imageStartupScriptFileName(imageId: string): string;
+export declare function imageStartupScriptPath(options: ProjectImageStartupScriptPathOptions): string;
+export declare function generateImageStartupScript(options: GenerateImageStartupScriptOptions): string;
+export declare function writeImageStartupScript(options: WriteImageStartupScriptOptions): WrittenImageStartupScript;
+export declare function writeProjectImageStartupScript(options: WriteProjectImageStartupScriptOptions): WrittenImageStartupScript;
+//# sourceMappingURL=projectStartupScript.d.ts.map

package/dist/projectStartupScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectStartupScript.d.ts","sourceRoot":"","sources":["../src/projectStartupScript.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAO5E,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,2BAA2B,YAAY,CAAC;AAErD,eAAO,MAAM,kCAAkC;;;;;;CAMrC,CAAC;AAEX,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kCACf,SAAQ,uBAAuB;CAAG;AAEpC,MAAM,WAAW,oCACf,SAAQ,uBAAuB;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iCAAiC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,kBAAkB,CAAC;IAChC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,UAAU,CAAC,EAAE,2BAA2B,CAAC;CAC1C;AAED,MAAM,WAAW,8BACf,SAAQ,iCAAiC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qCAAqC;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,2BAA2B,CAAC;CAC1C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kCAAkC,GAC1C,MAAM,CAKR;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQlE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,oCAAoC,GAC5C,MAAM,CAKR;AA4FD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,MAAM,CA2CR;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,yBAAyB,CAc3B;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qCAAqC,GAC7C,yBAAyB,CAY3B"}

package/dist/projectStartupScript.js

@@ -0,0 +1,150 @@
+import fs from "node:fs";
+import { dirnamePathLike, isAbsolutePathLike, joinPathLike, resolvePathLike, } from "./pathStyle.js";
+import { projectStateDirectoryPath, } from "./projectState.js";
+export const projectScriptsDirectoryName = "scripts";
+export const defaultPharoMcpMetacelloRepository = {
+    githubUser: "Evref-BL",
+    project: "MCP",
+    commitish: "main",
+    path: "",
+    baseline: "MCP",
+};
+export class ProjectStartupScriptError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ProjectStartupScriptError";
+    }
+}
+export function projectScriptsDirectoryPath(options) {
+    return joinPathLike(projectStateDirectoryPath(options), projectScriptsDirectoryName);
+}
+export function imageStartupScriptFileName(imageId) {
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(imageId)) {
+        throw new ProjectStartupScriptError(`Image id must be file-safe to generate a startup script: ${imageId}`);
+    }
+    return `start-${imageId}.st`;
+}
+export function imageStartupScriptPath(options) {
+    return joinPathLike(projectScriptsDirectoryPath(options), imageStartupScriptFileName(options.imageId));
+}
+function smalltalkString(value) {
+    return `'${value.replaceAll("'", "''")}'`;
+}
+function smalltalkPath(value) {
+    return smalltalkString(value.replace(/\\/g, "/"));
+}
+function generateGitConfigurationScript(imageConfig) {
+    if (!imageConfig.git) {
+        return "";
+    }
+    const git = imageConfig.git;
+    const requiresCredentialsProvider = Boolean(git.ssh || git.plainCredentials);
+    const lines = [
+        `"Configure image-local Git transport and credentials."`,
+        `Smalltalk globals at: #PLexusGitTransport put: ${smalltalkString(git.transport)}.`,
+        `(Smalltalk globals includesKey: #IceCredentialsProvider)`,
+        `  ifTrue: [`,
+        `  | credentialsProvider |`,
+        `  credentialsProvider := Smalltalk globals at: #IceCredentialsProvider.`,
+    ];
+    if (git.transport === "ssh") {
+        if (git.ssh) {
+            lines.push(`  credentialsProvider useCustomSsh: true.`, `  credentialsProvider sshCredentials`, `    username: 'git';`, `    publicKey: ${smalltalkPath(git.ssh.publicKey)};`, `    privateKey: ${smalltalkPath(git.ssh.privateKey)}.`);
+        }
+        else {
+            lines.push(`  "Use the image or platform SSH agent/defaults unless explicit keys are configured."`, `  credentialsProvider useCustomSsh: false.`);
+        }
+    }
+    else {
+        lines.push(`  credentialsProvider useCustomSsh: false.`);
+        if (git.plainCredentials) {
+            lines.push(`  (Smalltalk globals includesKey: #IcePlaintextCredentials)`, `    ifTrue: [`, `      credentialsProvider plaintextCredentials: ((Smalltalk globals at: #IcePlaintextCredentials) new`, `        username: ${smalltalkString(git.plainCredentials.username)};`, `        password: ${smalltalkString(git.plainCredentials.password)};`, `        yourself) ]`, `    ifFalse: [ Error signal: 'IcePlaintextCredentials class is not available.' ].`);
+        }
+    }
+    lines.push(`]`);
+    if (requiresCredentialsProvider) {
+        lines.push(`  ifFalse: [ Error signal: 'IceCredentialsProvider class is not available.' ].`);
+    }
+    else {
+        lines.push(`  ifFalse: [ nil ].`);
+    }
+    return lines.join("\n");
+}
+function resolveLoadScriptPath(projectRoot, imageConfig) {
+    return isAbsolutePathLike(imageConfig.mcp.loadScript)
+        ? resolvePathLike(imageConfig.mcp.loadScript)
+        : resolvePathLike(projectRoot, imageConfig.mcp.loadScript);
+}
+function findProjectImageConfig(config, imageId) {
+    const imageConfig = config.images.find((image) => image.id === imageId);
+    if (!imageConfig) {
+        throw new ProjectStartupScriptError(`Project config does not define image id: ${imageId}`);
+    }
+    return imageConfig;
+}
+export function generateImageStartupScript(options) {
+    const repository = options.repository ?? defaultPharoMcpMetacelloRepository;
+    const loadScriptPath = resolveLoadScriptPath(options.projectRoot, options.imageConfig);
+    const gitConfiguration = generateGitConfigurationScript(options.imageConfig);
+    return `"Generated by PLexus. Do not edit."
+
+| loadScript mcp |
+
+${gitConfiguration}
+
+"Load the Pharo MCP project if the image does not already provide it."
+(Smalltalk globals includesKey: #MCP) ifFalse: [
+  loadScript := ${smalltalkPath(loadScriptPath)} asFileReference.
+  loadScript exists
+    ifTrue: [ loadScript fileIn ]
+    ifFalse: [
+      Metacello new
+        githubUser: ${smalltalkString(repository.githubUser)} project: ${smalltalkString(repository.project)} commitish: ${smalltalkString(repository.commitish)} path: ${smalltalkString(repository.path)};
+        baseline: ${smalltalkString(repository.baseline)};
+        load ] ].
+
+(Smalltalk globals includesKey: #MCP)
+  ifFalse: [ Error signal: 'MCP class is not available after loading.' ].
+
+"Stop the previous server registered by PLexus before starting a new one."
+(Smalltalk globals at: #PLexusMCPServer ifAbsent: [ nil ])
+  ifNotNil: [ :existingServer |
+    [ existingServer stop ] on: Error do: [ :error | nil ] ].
+
+"Configure and start the MCP server."
+mcp := (Smalltalk globals at: #MCP) new.
+mcp port: ${options.imageState.assignedPort}.
+mcp start.
+
+Smalltalk globals at: #PLexusMCPServer put: mcp.
+
+"Keep the headless eval process alive while the MCP server accepts requests."
+Semaphore new wait.
+`;
+}
+export function writeImageStartupScript(options) {
+    const filePath = imageStartupScriptPath({
+        projectRoot: options.projectRoot,
+        projectId: options.projectId,
+        workspaceId: options.workspaceId,
+        imageId: options.imageConfig.id,
+        stateRoot: options.stateRoot,
+    });
+    const source = generateImageStartupScript(options);
+    fs.mkdirSync(dirnamePathLike(filePath), { recursive: true });
+    fs.writeFileSync(filePath, source, "utf8");
+    return { filePath, source };
+}
+export function writeProjectImageStartupScript(options) {
+    const imageConfig = findProjectImageConfig(options.config, options.imageId);
+    return writeImageStartupScript({
+        projectRoot: options.projectRoot,
+        projectId: options.config.kanban.projectId,
+        imageConfig,
+        imageState: options.imageState,
+        workspaceId: options.workspaceId,
+        stateRoot: options.stateRoot,
+        repository: options.repository,
+    });
+}
+//# sourceMappingURL=projectStartupScript.js.map

package/dist/projectStartupScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectStartupScript.js","sourceRoot":"","sources":["../src/projectStartupScript.ts"],"names":[],"mappings":"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"}

package/dist/projectState.d.ts

@@ -0,0 +1,128 @@
+import type { ProjectConfig } from "./projectConfig.js";
+export declare const plexusStateDirectoryName = ".plexus";
+export declare const plexusProjectsStateDirectoryName = "projects";
+export declare const plexusWorkspacesStateDirectoryName = "workspaces";
+export declare const projectStateFileName = "state.json";
+export declare const defaultWorkspaceIdValue = "default";
+export declare const defaultProjectPortRange: {
+    readonly start: 7100;
+    readonly end: 7199;
+};
+export type ProjectImageStatus = "starting" | "running" | "stopped" | "failed";
+export type PharoMcpContractStatus = "unknown" | "matching" | "mismatched";
+export interface PharoMcpContractReference {
+    id?: string;
+    hash?: string;
+}
+export interface ProjectImagePharoMcpContractState extends PharoMcpContractReference {
+    status?: PharoMcpContractStatus;
+    expectedId?: string;
+    expectedHash?: string;
+}
+export interface ProjectImageState {
+    id: string;
+    imageName: string;
+    assignedPort: number;
+    pid?: number;
+    status: ProjectImageStatus;
+    pharoMcpContract?: ProjectImagePharoMcpContractState;
+    imagePath?: string;
+    imageDirectoryPath?: string;
+    changesPath?: string;
+    localDirectoryPath?: string;
+    ombuDirectoryPath?: string;
+    vmId?: string;
+    pharoVersion?: string;
+    originTemplate?: {
+        name?: string;
+        url?: string;
+    };
+    rescueSnapshot?: {
+        capturedAt: string;
+        launcherImage?: {
+            name?: string;
+            pharoVersion?: string;
+            imagePath?: string;
+            originTemplate?: {
+                name?: string;
+                url?: string;
+            };
+            vmId?: string;
+        };
+        paths: {
+            imagePath?: string;
+            imageDirectoryPath?: string;
+            changesPath?: string;
+            localDirectoryPath?: string;
+            ombuDirectoryPath?: string;
+        };
+        repositories?: {
+            capturedAt: string;
+            status: "captured" | "unavailable";
+            repositories: Record<string, unknown>[];
+            error?: string;
+        };
+    };
+}
+export interface ProjectState {
+    projectId: string;
+    projectName: string;
+    workspaceId: string;
+    targetId: string;
+    pharoMcpContract?: PharoMcpContractReference;
+    images: ProjectImageState[];
+    updatedAt: string;
+}
+export interface ProjectPortRange {
+    start: number;
+    end: number;
+}
+export interface CreateProjectStateOptions {
+    updatedAt?: string;
+    previousState?: ProjectState;
+    portRange?: ProjectPortRange;
+    reservedPorts?: Iterable<number>;
+    workspaceId?: string;
+    targetId?: string;
+}
+export interface ProjectStatePathOptions {
+    projectRoot: string;
+    projectId: string;
+    workspaceId?: string;
+    stateRoot?: string;
+}
+export interface ProjectStatePathForConfigOptions {
+    projectRoot: string;
+    config: ProjectConfig;
+    workspaceId?: string;
+    stateRoot?: string;
+}
+export declare class PortAllocationError extends Error {
+    constructor(message: string);
+}
+export declare class ProjectStateError extends Error {
+    constructor(message: string);
+}
+export declare function defaultPlexusStateRoot(projectRoot: string): string;
+export declare function sanitizeRuntimeId(value: string): string;
+export declare function defaultWorkspaceId(projectRoot: string): string;
+export declare function defaultTargetId(projectId: string, workspaceId: string): string;
+export declare function projectWorkspacesStateDirectoryPath(options: Omit<ProjectStatePathOptions, "workspaceId">): string;
+export declare function projectStateDirectoryPath(options: ProjectStatePathOptions): string;
+export declare function projectStatePath(options: ProjectStatePathOptions): string;
+export declare function projectStatePathForConfig(options: ProjectStatePathForConfigOptions): string;
+export declare function loadProjectState(filePath: string): ProjectState | undefined;
+export declare function saveProjectState(filePath: string, state: ProjectState): void;
+export declare function collectReservedProjectPorts(options: Omit<ProjectStatePathOptions, "workspaceId"> & {
+    excludeWorkspaceId?: string;
+}): number[];
+export interface ProjectImageNameTemplateContext {
+    projectId: string;
+    projectName: string;
+    workspaceId: string;
+    targetId: string;
+    imageId: string;
+}
+export declare function renderProjectImageName(template: string, context: ProjectImageNameTemplateContext): string;
+export declare function createProjectState(config: ProjectConfig, optionsOrUpdatedAt?: string | CreateProjectStateOptions): ProjectState;
+//# sourceMappingURL=projectState.d.ts.map

package/dist/projectState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectState.d.ts","sourceRoot":"","sources":["../src/projectState.ts"],"names":[],"mappings":"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"}