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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+import { closeProject, ProjectCloseError } from "./projectClose.js";
+import { PlexusProjectLifecycle } from "./projectLifecycle.js";
+import { openProject, ProjectOpenError } from "./projectOpen.js";
+import { startScopedPharoLauncherServer } from "./scopedPharoLauncherServer.js";
+import { startProjectLifecycleServer } from "./server.js";
+function usage() {
+    return [
+        "Usage:",
+        "  plexus project open <path> [--workspace-id <id>] [--target-id <id>] [--state-root <path>]",
+        "  plexus project close <path> [--workspace-id <id>] [--state-root <path>]",
+        "  plexus project status <path> [--workspace-id <id>] [--state-root <path>]",
+        "  plexus mcp project",
+        "  plexus mcp pharo-launcher [--project-path <path>] [--workspace-id <id>] [--target-id <id>] [--state-root <path>]",
+        "",
+        "Environment:",
+        "  PLEXUS_STATE_ROOT       Optional runtime state root.",
+        "  PLEXUS_WORKSPACE_ID     Optional runtime workspace id.",
+        "  VIBE_KANBAN_WORKSPACE_ID Optional runtime workspace id.",
+        "  PLEXUS_TARGET_ID        Optional runtime target id.",
+    ].join("\n");
+}
+function parseCommand(argv) {
+    const [scope, command] = argv;
+    const projectCommandHasPath = scope === "project";
+    const projectPath = projectCommandHasPath ? argv[2] : undefined;
+    const rest = projectCommandHasPath ? argv.slice(3) : argv.slice(2);
+    const parsed = { scope, command, projectPath };
+    for (let index = 0; index < rest.length; index += 1) {
+        const arg = rest[index];
+        const value = rest[index + 1];
+        if (!value) {
+            throw new Error(`${arg} requires a value`);
+        }
+        switch (arg) {
+            case "--project-path":
+            case "--state-root":
+                if (arg === "--project-path") {
+                    parsed.projectPath = value;
+                }
+                else {
+                    parsed.stateRoot = value;
+                }
+                break;
+            case "--workspace-id":
+                parsed.workspaceId = value;
+                break;
+            case "--target-id":
+                parsed.targetId = value;
+                break;
+            default:
+                throw new Error(`Unknown option: ${arg}`);
+        }
+        index += 1;
+    }
+    return parsed;
+}
+async function main(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(usage());
+        return 0;
+    }
+    const parsed = parseCommand(argv);
+    const workspaceId = parsed.workspaceId ??
+        process.env.PLEXUS_WORKSPACE_ID ??
+        process.env.VIBE_KANBAN_WORKSPACE_ID;
+    const stateRoot = parsed.stateRoot ?? process.env.PLEXUS_STATE_ROOT;
+    if (parsed.scope === "mcp" && parsed.command === "pharo-launcher") {
+        const projectPath = parsed.projectPath ?? process.env.PLEXUS_PROJECT_ROOT;
+        if (!projectPath) {
+            console.error("plexus mcp pharo-launcher requires --project-path or PLEXUS_PROJECT_ROOT");
+            return 2;
+        }
+        await startScopedPharoLauncherServer({
+            projectRoot: projectPath,
+            stateRoot,
+            workspaceId,
+            targetId: parsed.targetId ?? process.env.PLEXUS_TARGET_ID,
+        });
+        return 0;
+    }
+    if (parsed.scope === "mcp" && parsed.command === "project") {
+        await startProjectLifecycleServer();
+        return 0;
+    }
+    if (parsed.scope !== "project" ||
+        (parsed.command !== "open" &&
+            parsed.command !== "close" &&
+            parsed.command !== "status") ||
+        !parsed.projectPath) {
+        console.error(usage());
+        return 2;
+    }
+    try {
+        if (parsed.command === "open") {
+            const result = await openProject({
+                projectRoot: parsed.projectPath,
+                stateRoot,
+                workspaceId,
+                targetId: parsed.targetId ?? process.env.PLEXUS_TARGET_ID,
+            });
+            console.log(JSON.stringify({
+                ok: result.ok,
+                statePath: result.statePath,
+                images: result.state.images,
+            }, null, 2));
+            return 0;
+        }
+        if (parsed.command === "status") {
+            const lifecycle = new PlexusProjectLifecycle();
+            const status = await lifecycle.status({
+                projectPath: parsed.projectPath,
+                stateRoot,
+                workspaceId,
+            });
+            console.log(JSON.stringify(status, null, 2));
+            return status.ok ? 0 : 1;
+        }
+        const result = await closeProject({
+            projectRoot: parsed.projectPath,
+            stateRoot,
+            workspaceId,
+        });
+        console.log(JSON.stringify({
+            ok: result.ok,
+            statePath: result.statePath,
+            images: result.state?.images ?? [],
+            stoppedImages: result.stoppedImages,
+        }, null, 2));
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof ProjectOpenError) {
+            console.error(JSON.stringify({
+                ok: false,
+                statePath: error.result.statePath,
+                failures: error.result.failures,
+                images: error.result.state.images,
+            }, null, 2));
+            return 1;
+        }
+        if (error instanceof ProjectCloseError) {
+            console.error(JSON.stringify({
+                ok: false,
+                statePath: error.result.statePath,
+                failures: error.result.failures,
+                images: error.result.state?.images ?? [],
+                stoppedImages: error.result.stoppedImages,
+            }, null, 2));
+            return 1;
+        }
+        console.error(error instanceof Error ? error.message : String(error));
+        return 1;
+    }
+}
+main(process.argv.slice(2))
+    .then((exitCode) => {
+    process.exitCode = exitCode;
+})
+    .catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+export interface PharoLauncherMcpConfig {
+    source: "env" | "package" | "command";
+    command: string;
+    args: string[];
+    entry?: string;
+    packageDir?: string;
+    repoDir?: string;
+}
+export interface LoadPharoLauncherMcpConfigOptions {
+    resolveInstalledEntry?: () => string | undefined;
+}
+export declare const pharoLauncherMcpPackageName: "@evref-bl/pharo-launcher-mcp";
+export declare const pharoLauncherMcpCommandName: "pharo-launcher-mcp";
+export declare function loadPharoLauncherMcpConfig(env?: NodeJS.ProcessEnv, options?: LoadPharoLauncherMcpConfigOptions): PharoLauncherMcpConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iCAAiC;IAChD,qBAAqB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAClD;AAID,eAAO,MAAM,2BAA2B,EACtC,8BAAuC,CAAC;AAC1C,eAAO,MAAM,2BAA2B,EAAG,oBAA6B,CAAC;AAqCzE,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,GAAE,iCAAsC,GAC9C,sBAAsB,CAmCxB"}

package/dist/config.js

@@ -0,0 +1,62 @@
+import { createRequire } from "node:module";
+import { dirnamePathLike, joinPathLike } from "./pathStyle.js";
+const require = createRequire(import.meta.url);
+export const pharoLauncherMcpPackageName = "@evref-bl/pharo-launcher-mcp";
+export const pharoLauncherMcpCommandName = "pharo-launcher-mcp";
+function packageDirFromEntry(entry) {
+    return dirnamePathLike(dirnamePathLike(entry));
+}
+function resolveInstalledPharoLauncherMcpEntry() {
+    try {
+        return require.resolve(pharoLauncherMcpPackageName);
+    }
+    catch {
+        return undefined;
+    }
+}
+function hasExplicitPharoLauncherMcpEnv(env) {
+    return Boolean(env.PHARO_LAUNCHER_MCP_COMMAND ??
+        env.PHARO_LAUNCHER_MCP_ARGS ??
+        env.PHARO_LAUNCHER_MCP_ENTRY ??
+        env.PHARO_LAUNCHER_MCP_REPO_DIR);
+}
+function parsePharoLauncherMcpArgs(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return value.split(" ").filter(Boolean);
+}
+function defaultPharoLauncherMcpEntryForRepo(repoDir) {
+    return joinPathLike(repoDir, "dist", "index.js");
+}
+export function loadPharoLauncherMcpConfig(env = process.env, options = {}) {
+    if (!hasExplicitPharoLauncherMcpEnv(env)) {
+        const installedEntry = (options.resolveInstalledEntry ?? resolveInstalledPharoLauncherMcpEntry)();
+        if (installedEntry) {
+            return {
+                source: "package",
+                command: process.execPath,
+                args: [installedEntry],
+                entry: installedEntry,
+                packageDir: packageDirFromEntry(installedEntry),
+            };
+        }
+        return {
+            source: "command",
+            command: pharoLauncherMcpCommandName,
+            args: [],
+        };
+    }
+    const explicitArgs = parsePharoLauncherMcpArgs(env.PHARO_LAUNCHER_MCP_ARGS);
+    const repoDir = env.PHARO_LAUNCHER_MCP_REPO_DIR;
+    const entry = env.PHARO_LAUNCHER_MCP_ENTRY ??
+        (repoDir ? defaultPharoLauncherMcpEntryForRepo(repoDir) : undefined);
+    return {
+        source: "env",
+        ...(repoDir ? { repoDir } : {}),
+        ...(entry ? { entry } : {}),
+        command: env.PHARO_LAUNCHER_MCP_COMMAND ?? process.execPath,
+        args: explicitArgs ?? (entry ? [entry] : []),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAe/D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,2BAA2B,GACtC,8BAAuC,CAAC;AAC1C,MAAM,CAAC,MAAM,2BAA2B,GAAG,oBAA6B,CAAC;AAEzE,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,eAAe,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,qCAAqC;IAC5C,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,8BAA8B,CAAC,GAAsB;IAC5D,OAAO,OAAO,CACZ,GAAG,CAAC,0BAA0B;QAC5B,GAAG,CAAC,uBAAuB;QAC3B,GAAG,CAAC,wBAAwB;QAC5B,GAAG,CAAC,2BAA2B,CAClC,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,KAAyB;IAEzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,mCAAmC,CAAC,OAAe;IAC1D,OAAO,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAyB,OAAO,CAAC,GAAG,EACpC,UAA6C,EAAE;IAE/C,IAAI,CAAC,8BAA8B,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,cAAc,GAAG,CACrB,OAAO,CAAC,qBAAqB,IAAI,qCAAqC,CACvE,EAAE,CAAC;QACJ,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,OAAO,CAAC,QAAQ;gBACzB,IAAI,EAAE,CAAC,cAAc,CAAC;gBACtB,KAAK,EAAE,cAAc;gBACrB,UAAU,EAAE,mBAAmB,CAAC,cAAc,CAAC;aAChD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,2BAA2B;YACpC,IAAI,EAAE,EAAE;SACT,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,yBAAyB,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,GAAG,CAAC,2BAA2B,CAAC;IAChD,MAAM,KAAK,GACT,GAAG,CAAC,wBAAwB;QAC5B,CAAC,OAAO,CAAC,CAAC,CAAC,mCAAmC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEvE,OAAO;QACL,MAAM,EAAE,KAAK;QACb,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,GAAG,CAAC,0BAA0B,IAAI,OAAO,CAAC,QAAQ;QAC3D,IAAI,EAAE,YAAY,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;AACJ,CAAC"}

package/dist/imageRescue.d.ts

@@ -0,0 +1,136 @@
+import { type PharoLauncherMcpToolClient } from "./pharoLauncherMcpClient.js";
+import { type PharoMcpHealthClient } from "./pharoMcpHealth.js";
+import { type ProjectImageState, type ProjectPortRange, type ProjectState } from "./projectState.js";
+export type ImageRescueOperation = "snapshotSource" | "plan" | "prepareTarget" | "applyPlan";
+export type ImageRescueFailureClass = "apply-time-breaker" | "runtime-breaker" | "unclassified";
+export interface ImageRescueEntrySelection {
+    indexes?: number[];
+    entryReferences?: string[];
+    startIndex?: number;
+    endIndex?: number;
+    latestCount?: number;
+}
+export interface ImageRescueRepositoryAction {
+    label?: string;
+    toolName?: "load_repository" | "edit_repository";
+    arguments: Record<string, unknown>;
+}
+export interface ImageRescuePollOptions {
+    intervalMs?: number;
+    processTimeoutMs?: number;
+    healthTimeoutMs?: number;
+}
+export interface ImageRescueOptions {
+    operation: ImageRescueOperation;
+    projectRoot: string;
+    sourceImageId: string;
+    stateRoot?: string;
+    workspaceId?: string;
+    targetImageId?: string;
+    targetImageName?: string;
+    targetTemplateName?: string;
+    targetTemplateCategory?: string;
+    targetMcpPort?: number;
+    sourceHistoryDirectoryPath?: string;
+    historyFilePath?: string;
+    selection?: ImageRescueEntrySelection;
+    exclude?: ImageRescueEntrySelection;
+    codeChangesOnly?: boolean;
+    includeEntryCounts?: boolean;
+    loadRepositories?: boolean;
+    repositoryActions?: ImageRescueRepositoryAction[];
+    confirm?: boolean;
+    pharoLauncherMcpClient?: PharoLauncherMcpToolClient;
+    imageMcpClient?: ImageRescueMcpClient;
+    healthClient?: PharoMcpHealthClient;
+    portRange?: ProjectPortRange;
+    now?: () => Date;
+    poll?: ImageRescuePollOptions;
+    sleep?: (durationMs: number) => Promise<void>;
+}
+export interface ImageRescueMcpClient {
+    callTool(image: ProjectImageState, toolName: string, argumentsValue: Record<string, unknown>): Promise<unknown>;
+}
+export interface LauncherPathStatus {
+    path: string;
+    exists: boolean;
+}
+export interface LauncherConfigReport {
+    launcherDir?: LauncherPathStatus;
+    profile?: {
+        imagesDir?: LauncherPathStatus;
+    };
+}
+export interface LauncherImageInfo {
+    name?: string;
+    pharoVersion?: string;
+    imagePath?: string;
+    originTemplate?: {
+        name?: string;
+        url?: string;
+    };
+    vmId?: string;
+}
+export interface ResolvedImagePaths {
+    imagePath?: string;
+    imageDirectoryPath?: string;
+    changesPath?: string;
+    localDirectoryPath?: string;
+    ombuDirectoryPath?: string;
+}
+export interface ImageRescueRepositorySnapshot {
+    capturedAt: string;
+    status: "captured" | "unavailable";
+    repositories: Record<string, unknown>[];
+    error?: string;
+}
+export interface ImageRescueSourceSnapshot {
+    capturedAt: string;
+    launcherImage?: LauncherImageInfo;
+    paths: ResolvedImagePaths;
+    repositories?: ImageRescueRepositorySnapshot;
+}
+export interface ImageRescueHistoryFile {
+    path: string;
+    mtimeMs?: number;
+    size?: number;
+}
+export interface ImageRescueRepositoryResult {
+    label: string;
+    toolName: string;
+    arguments: Record<string, unknown>;
+    status: "planned" | "applied" | "skipped" | "failed";
+    result?: unknown;
+    error?: string;
+}
+export interface ImageRescueChangeResult {
+    historyFilePath: string;
+    arguments: Record<string, unknown>;
+    status: "planned" | "applied" | "failed";
+    result?: unknown;
+    error?: string;
+    failureClass?: ImageRescueFailureClass;
+}
+export interface ImageRescueResult {
+    ok: boolean;
+    operation: ImageRescueOperation;
+    projectRoot: string;
+    statePath: string;
+    state?: ProjectState;
+    sourceImage: ProjectImageState;
+    targetImage?: ProjectImageState;
+    sourceSnapshot: ImageRescueSourceSnapshot;
+    historyDirectoryPath?: string;
+    historyFiles?: ImageRescueHistoryFile[];
+    historyListing?: unknown;
+    selectedHistoryFilePath?: string;
+    repositoryResults?: ImageRescueRepositoryResult[];
+    changeResult?: ImageRescueChangeResult;
+    warnings: string[];
+}
+export declare class ImageRescueError extends Error {
+    readonly result?: ImageRescueResult | undefined;
+    constructor(message: string, result?: ImageRescueResult | undefined);
+}
+export declare function rescueImage(options: ImageRescueOptions): Promise<ImageRescueResult>;
+//# sourceMappingURL=imageRescue.d.ts.map

package/dist/imageRescue.d.ts.map

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