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

package/dist/projectConfig.js

@@ -0,0 +1,208 @@
+import fs from "node:fs";
+import { joinPathLike } from "./pathStyle.js";
+export const plexusProjectConfigFileName = "plexus.project.json";
+export class ProjectConfigError extends Error {
+    issues;
+    constructor(message, issues) {
+        super(message);
+        this.issues = issues;
+        this.name = "ProjectConfigError";
+    }
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function stringField(object, key, issues, pathPrefix) {
+    const value = object[key];
+    if (typeof value === "string" && value.trim().length > 0) {
+        return value;
+    }
+    issues.push(`${pathPrefix}.${key} must be a non-empty string`);
+    return "";
+}
+function booleanField(object, key, issues, pathPrefix) {
+    const value = object[key];
+    if (typeof value === "boolean") {
+        return value;
+    }
+    issues.push(`${pathPrefix}.${key} must be a boolean`);
+    return false;
+}
+function optionalPortField(object, key, issues, pathPrefix) {
+    const value = object[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === "number" &&
+        Number.isInteger(value) &&
+        value >= 1 &&
+        value <= 65_535) {
+        return value;
+    }
+    issues.push(`${pathPrefix}.${key} must be an integer between 1 and 65535`);
+    return undefined;
+}
+function parseKanban(value, issues) {
+    if (!isObject(value)) {
+        issues.push("kanban must be an object");
+        return { provider: "vibe-kanban", projectId: "" };
+    }
+    const provider = value.provider;
+    if (provider !== "vibe-kanban") {
+        issues.push("kanban.provider must be \"vibe-kanban\"");
+    }
+    return {
+        provider: "vibe-kanban",
+        projectId: stringField(value, "projectId", issues, "kanban"),
+    };
+}
+function parseImageMcp(value, issues, pathPrefix) {
+    if (!isObject(value)) {
+        issues.push(`${pathPrefix}.mcp must be an object`);
+        return { loadScript: "" };
+    }
+    return {
+        port: optionalPortField(value, "port", issues, `${pathPrefix}.mcp`),
+        loadScript: stringField(value, "loadScript", issues, `${pathPrefix}.mcp`),
+    };
+}
+function parseImageSshConfig(value, issues, pathPrefix) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!isObject(value)) {
+        issues.push(`${pathPrefix}.ssh must be an object`);
+        return undefined;
+    }
+    return {
+        publicKey: stringField(value, "publicKey", issues, `${pathPrefix}.ssh`),
+        privateKey: stringField(value, "privateKey", issues, `${pathPrefix}.ssh`),
+    };
+}
+function parseImagePlainCredentialsConfig(value, issues, pathPrefix) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!isObject(value)) {
+        issues.push(`${pathPrefix}.plainCredentials must be an object`);
+        return undefined;
+    }
+    return {
+        username: stringField(value, "username", issues, `${pathPrefix}.plainCredentials`),
+        password: stringField(value, "password", issues, `${pathPrefix}.plainCredentials`),
+    };
+}
+function parseImageGit(value, issues, pathPrefix) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!isObject(value)) {
+        issues.push(`${pathPrefix}.git must be an object`);
+        return undefined;
+    }
+    const transportValue = value.transport ?? "ssh";
+    const transport = transportValue === "ssh" ||
+        transportValue === "https" ||
+        transportValue === "http"
+        ? transportValue
+        : "ssh";
+    if (transport !== transportValue) {
+        issues.push(`${pathPrefix}.git.transport must be one of ssh, https, http`);
+    }
+    const ssh = parseImageSshConfig(value.ssh, issues, `${pathPrefix}.git`);
+    const plainCredentials = parseImagePlainCredentialsConfig(value.plainCredentials, issues, `${pathPrefix}.git`);
+    if (transport === "ssh" && plainCredentials) {
+        issues.push(`${pathPrefix}.git.plainCredentials can only be used with https or http`);
+    }
+    if (transport !== "ssh" && ssh) {
+        issues.push(`${pathPrefix}.git.ssh can only be used with ssh`);
+    }
+    return {
+        transport,
+        ...(ssh ? { ssh } : {}),
+        ...(plainCredentials ? { plainCredentials } : {}),
+    };
+}
+function parseImages(value, issues) {
+    if (!Array.isArray(value)) {
+        issues.push("images must be an array");
+        return [];
+    }
+    return value.map((image, index) => {
+        const pathPrefix = `images[${index}]`;
+        if (!isObject(image)) {
+            issues.push(`${pathPrefix} must be an object`);
+            return {
+                id: "",
+                imageName: "",
+                active: false,
+                mcp: { loadScript: "" },
+            };
+        }
+        return {
+            id: stringField(image, "id", issues, pathPrefix),
+            imageName: stringField(image, "imageName", issues, pathPrefix),
+            active: booleanField(image, "active", issues, pathPrefix),
+            mcp: parseImageMcp(image.mcp, issues, pathPrefix),
+            git: parseImageGit(image.git, issues, pathPrefix),
+        };
+    });
+}
+function collectDuplicates(values, label, issues) {
+    const seen = new Set();
+    for (const value of values) {
+        if (!value) {
+            continue;
+        }
+        if (seen.has(value)) {
+            issues.push(`${label} must be unique: ${value}`);
+        }
+        else {
+            seen.add(value);
+        }
+    }
+}
+function collectDuplicatePorts(images, issues) {
+    const seen = new Set();
+    for (const image of images) {
+        const port = image.mcp.port;
+        if (!port) {
+            continue;
+        }
+        if (seen.has(port)) {
+            issues.push(`image MCP ports must be unique: ${port}`);
+        }
+        else {
+            seen.add(port);
+        }
+    }
+}
+export function parseProjectConfig(value) {
+    const issues = [];
+    if (!isObject(value)) {
+        throw new ProjectConfigError("Invalid Plexus project config", [
+            "config must be an object",
+        ]);
+    }
+    const config = {
+        name: stringField(value, "name", issues, "config"),
+        kanban: parseKanban(value.kanban, issues),
+        images: parseImages(value.images, issues),
+    };
+    collectDuplicates(config.images.map((image) => image.id), "image ids", issues);
+    collectDuplicates(config.images.map((image) => image.imageName), "image names", issues);
+    collectDuplicatePorts(config.images, issues);
+    if (issues.length > 0) {
+        throw new ProjectConfigError("Invalid Plexus project config", issues);
+    }
+    return config;
+}
+export function projectConfigPath(projectRoot) {
+    return joinPathLike(projectRoot, plexusProjectConfigFileName);
+}
+export function loadProjectConfig(projectRoot) {
+    const filePath = projectConfigPath(projectRoot);
+    const raw = fs.readFileSync(filePath, "utf8");
+    return parseProjectConfig(JSON.parse(raw));
+}
+//# sourceMappingURL=projectConfig.js.map

package/dist/projectConfig.js.map

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

package/dist/projectLifecycle.d.ts

@@ -0,0 +1,115 @@
+import { rescueImage, type ImageRescueEntrySelection, type ImageRescueOperation, type ImageRescueRepositoryAction, type ImageRescueResult } from "./imageRescue.js";
+import { closeProject, type ProjectCloseResult } from "./projectClose.js";
+import { openProject, type ProjectOpenResult } from "./projectOpen.js";
+import { type ProjectState } from "./projectState.js";
+export interface ProjectLifecycleRouteReference {
+    projectId?: string;
+    workspaceId?: string;
+    targetId?: string;
+}
+export interface ProjectLifecycleRouteRegistration {
+    projectRoot: string;
+    statePath: string;
+    state: ProjectState;
+}
+export interface ProjectLifecycleRouteRegistry {
+    registerProjectRoute(input: ProjectLifecycleRouteRegistration): Promise<unknown> | unknown;
+    unregisterProjectRoute(input: ProjectLifecycleRouteReference): Promise<unknown> | unknown;
+    getRouteStatus?(input: ProjectLifecycleRouteReference & {
+        refreshHealth?: boolean;
+    }): Promise<unknown> | unknown;
+}
+export interface ProjectLifecycleImageToolCaller {
+    callImageTool(reference: ProjectLifecycleRouteReference, imageId: string, toolName: string, argumentsValue: Record<string, unknown>): Promise<unknown>;
+}
+export interface HttpGatewayRouteRegistryOptions {
+    url?: string;
+    host?: string;
+    port?: number;
+    path?: string;
+    timeoutMs?: number;
+    fetch?: typeof fetch;
+}
+export interface ProjectLifecycleOptions {
+    routeRegistry?: ProjectLifecycleRouteRegistry;
+    imageToolCaller?: ProjectLifecycleImageToolCaller;
+    projectOpen?: typeof openProject;
+    projectClose?: typeof closeProject;
+    imageRescue?: typeof rescueImage;
+}
+export interface ProjectOpenToolInput {
+    projectPath: string;
+    stateRoot?: string;
+    workspaceId?: string;
+    targetId?: string;
+}
+export interface ProjectCloseToolInput {
+    projectPath: string;
+    stateRoot?: string;
+    workspaceId?: string;
+}
+export interface ProjectStatusToolInput extends ProjectLifecycleRouteReference {
+    projectPath?: string;
+    stateRoot?: string;
+    refreshHealth?: boolean;
+}
+export interface RescueImageToolInput extends ProjectStatusToolInput {
+    operation: ImageRescueOperation;
+    sourceImageId: 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;
+}
+export interface ProjectLifecycleStatus {
+    projectRoot?: string;
+    statePath?: string;
+    state?: ProjectState;
+    route?: unknown;
+}
+export interface ProjectLifecycleToolResult<T = unknown> {
+    ok: boolean;
+    data?: T;
+    error?: string;
+}
+export declare class HttpGatewayRouteRegistry implements ProjectLifecycleRouteRegistry {
+    private readonly url;
+    private readonly timeoutMs;
+    private readonly fetchFn;
+    constructor(options?: HttpGatewayRouteRegistryOptions);
+    registerProjectRoute(input: ProjectLifecycleRouteRegistration): Promise<unknown>;
+    unregisterProjectRoute(input: ProjectLifecycleRouteReference): Promise<unknown>;
+    getRouteStatus(input: ProjectLifecycleRouteReference & {
+        refreshHealth?: boolean;
+    }): Promise<unknown>;
+    private callTool;
+}
+export declare class PlexusProjectLifecycle {
+    private readonly routeRegistry?;
+    private readonly imageToolCaller?;
+    private readonly projectOpen;
+    private readonly projectClose;
+    private readonly imageRescue;
+    constructor(options?: ProjectLifecycleOptions);
+    open(input: ProjectOpenToolInput): Promise<ProjectLifecycleToolResult<ProjectOpenResult>>;
+    close(input: ProjectCloseToolInput): Promise<ProjectLifecycleToolResult<ProjectCloseResult>>;
+    status(input: ProjectStatusToolInput): Promise<ProjectLifecycleToolResult<ProjectLifecycleStatus | ProjectLifecycleStatus[]>>;
+    rescueImage(input: RescueImageToolInput): Promise<ProjectLifecycleToolResult<ImageRescueResult>>;
+    handleTool(name: string, inputValue: unknown): Promise<ProjectLifecycleToolResult>;
+    private statusFromProjectPath;
+    private getRouteStatus;
+    private registerRoute;
+    private unregisterRoute;
+}
+export declare function createProjectLifecycleFromEnvironment(env?: NodeJS.ProcessEnv): PlexusProjectLifecycle;
+//# sourceMappingURL=projectLifecycle.d.ts.map

package/dist/projectLifecycle.d.ts.map

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