@fidelios/server 0.0.1

package/dist/services/plugin-lifecycle.js

@@ -0,0 +1,476 @@
+/**
+ * PluginLifecycleManager — state-machine controller for plugin status
+ * transitions and worker process coordination.
+ *
+ * Each plugin moves through a well-defined state machine:
+ *
+ * ```
+ *   installed ──→ ready ──→ disabled
+ *       │            │         │
+ *       │            ├──→ error│
+ *       │            ↓         │
+ *       │     upgrade_pending  │
+ *       │            │         │
+ *       ↓            ↓         ↓
+ *              uninstalled
+ * ```
+ *
+ * The lifecycle manager:
+ *
+ * 1. **Validates transitions** — Only transitions defined in
+ *    `VALID_TRANSITIONS` are allowed; invalid transitions throw.
+ *
+ * 2. **Coordinates workers** — When a plugin moves to `ready`, its
+ *    worker process is started. When it moves out of `ready`, the
+ *    worker is stopped gracefully.
+ *
+ * 3. **Emits events** — `plugin.loaded`, `plugin.enabled`,
+ *    `plugin.disabled`, `plugin.unloaded`, `plugin.status_changed`
+ *    events are emitted so that other services (job coordinator,
+ *    tool dispatcher, event bus) can react accordingly.
+ *
+ * 4. **Persists state** — Status changes are written to the database
+ *    through the plugin registry service.
+ *
+ * @see PLUGIN_SPEC.md §12 — Process Model
+ * @see PLUGIN_SPEC.md §12.5 — Graceful Shutdown Policy
+ */
+import { EventEmitter } from "node:events";
+import { pluginRegistryService } from "./plugin-registry.js";
+import { pluginLoader } from "./plugin-loader.js";
+import { badRequest, notFound } from "../errors.js";
+import { logger } from "../middleware/logger.js";
+// ---------------------------------------------------------------------------
+// Lifecycle state machine
+// ---------------------------------------------------------------------------
+/**
+ * Valid state transitions for the plugin lifecycle.
+ *
+ *   installed → ready       (initial load succeeds)
+ *   installed → error       (initial load fails)
+ *   installed → uninstalled (abort installation)
+ *
+ *   ready → disabled        (operator disables plugin)
+ *   ready → error           (runtime failure)
+ *   ready → upgrade_pending (upgrade with new capabilities)
+ *   ready → uninstalled     (uninstall)
+ *
+ *   disabled → ready        (operator re-enables plugin)
+ *   disabled → uninstalled  (uninstall while disabled)
+ *
+ *   error → ready           (retry / recovery)
+ *   error → uninstalled     (give up and uninstall)
+ *
+ *   upgrade_pending → ready       (operator approves new capabilities)
+ *   upgrade_pending → error       (upgrade worker fails)
+ *   upgrade_pending → uninstalled (reject upgrade and uninstall)
+ *
+ *   uninstalled → installed (reinstall)
+ */
+const VALID_TRANSITIONS = {
+    installed: ["ready", "error", "uninstalled"],
+    ready: ["ready", "disabled", "error", "upgrade_pending", "uninstalled"],
+    disabled: ["ready", "uninstalled"],
+    error: ["ready", "uninstalled"],
+    upgrade_pending: ["ready", "error", "uninstalled"],
+    uninstalled: ["installed"], // reinstall
+};
+/**
+ * Check whether a transition from `from` → `to` is valid.
+ */
+function isValidTransition(from, to) {
+    return VALID_TRANSITIONS[from]?.includes(to) ?? false;
+}
+/**
+ * Create a PluginLifecycleManager.
+ *
+ * This service orchestrates plugin state transitions on top of the
+ * `pluginRegistryService` (which handles raw DB persistence).  It enforces
+ * the lifecycle state machine, emits events for downstream consumers
+ * (routing tables, UI, observability), and manages worker processes via
+ * the `PluginWorkerManager` when one is provided.
+ *
+ * Usage:
+ * ```ts
+ * const lifecycle = pluginLifecycleManager(db, {
+ *   workerManager: createPluginWorkerManager(),
+ * });
+ * lifecycle.on("plugin.enabled", ({ pluginId }) => { ... });
+ * await lifecycle.load(pluginId);
+ * ```
+ *
+ * @see PLUGIN_SPEC.md §21.3 — `plugins.status` column
+ * @see PLUGIN_SPEC.md §12 — Process Model
+ */
+export function pluginLifecycleManager(db, options) {
+    // Support the legacy signature: pluginLifecycleManager(db, loader)
+    // as well as the new options object form.
+    let loaderArg;
+    let workerManager;
+    if (options && typeof options === "object" && "discoverAll" in options) {
+        // Legacy: second arg is a PluginLoader directly
+        loaderArg = options;
+    }
+    else if (options && typeof options === "object") {
+        const opts = options;
+        loaderArg = opts.loader;
+        workerManager = opts.workerManager;
+    }
+    const registry = pluginRegistryService(db);
+    const pluginLoaderInstance = loaderArg ?? pluginLoader(db);
+    const emitter = new EventEmitter();
+    emitter.setMaxListeners(100); // plugins may have many listeners; 100 is a safe upper bound
+    const log = logger.child({ service: "plugin-lifecycle" });
+    // -----------------------------------------------------------------------
+    // Internal helpers
+    // -----------------------------------------------------------------------
+    async function requirePlugin(pluginId) {
+        const plugin = await registry.getById(pluginId);
+        if (!plugin)
+            throw notFound(`Plugin not found: ${pluginId}`);
+        return plugin;
+    }
+    function assertTransition(plugin, to) {
+        if (!isValidTransition(plugin.status, to)) {
+            throw badRequest(`Invalid lifecycle transition: ${plugin.status} → ${to} for plugin ${plugin.pluginKey}`);
+        }
+    }
+    async function transition(pluginId, to, lastError = null, existingPlugin) {
+        const plugin = existingPlugin ?? await requirePlugin(pluginId);
+        assertTransition(plugin, to);
+        const previousStatus = plugin.status;
+        const updated = await registry.updateStatus(pluginId, {
+            status: to,
+            lastError,
+        });
+        if (!updated)
+            throw notFound(`Plugin not found after status update: ${pluginId}`);
+        const result = updated;
+        log.info({ pluginId, pluginKey: result.pluginKey, from: previousStatus, to }, `plugin lifecycle: ${previousStatus} → ${to}`);
+        // Emit the generic status_changed event
+        emitter.emit("plugin.status_changed", {
+            pluginId,
+            pluginKey: result.pluginKey,
+            previousStatus,
+            newStatus: to,
+        });
+        return result;
+    }
+    function emitDomain(event, payload) {
+        emitter.emit(event, payload);
+    }
+    // -----------------------------------------------------------------------
+    // Worker management helpers
+    // -----------------------------------------------------------------------
+    /**
+     * Stop the worker for a plugin if one is running.
+     * This is a best-effort operation — if no worker manager is configured
+     * or no worker is running, it silently succeeds.
+     */
+    async function stopWorkerIfRunning(pluginId, pluginKey) {
+        if (!workerManager)
+            return;
+        if (!workerManager.isRunning(pluginId) && !workerManager.getWorker(pluginId))
+            return;
+        try {
+            await workerManager.stopWorker(pluginId);
+            log.info({ pluginId, pluginKey }, "plugin lifecycle: worker stopped");
+            emitDomain("plugin.worker_stopped", { pluginId, pluginKey });
+        }
+        catch (err) {
+            log.warn({ pluginId, pluginKey, err: err instanceof Error ? err.message : String(err) }, "plugin lifecycle: failed to stop worker (best-effort)");
+        }
+    }
+    async function activateReadyPlugin(pluginId) {
+        const supportsRuntimeActivation = typeof pluginLoaderInstance.hasRuntimeServices === "function"
+            && typeof pluginLoaderInstance.loadSingle === "function";
+        if (!supportsRuntimeActivation || !pluginLoaderInstance.hasRuntimeServices()) {
+            return;
+        }
+        const loadResult = await pluginLoaderInstance.loadSingle(pluginId);
+        if (!loadResult.success) {
+            throw new Error(loadResult.error
+                ?? `Failed to activate plugin ${loadResult.plugin.pluginKey}`);
+        }
+    }
+    async function deactivatePluginRuntime(pluginId, pluginKey) {
+        const supportsRuntimeDeactivation = typeof pluginLoaderInstance.hasRuntimeServices === "function"
+            && typeof pluginLoaderInstance.unloadSingle === "function";
+        if (supportsRuntimeDeactivation && pluginLoaderInstance.hasRuntimeServices()) {
+            await pluginLoaderInstance.unloadSingle(pluginId, pluginKey);
+            return;
+        }
+        await stopWorkerIfRunning(pluginId, pluginKey);
+    }
+    // -----------------------------------------------------------------------
+    // Public API
+    // -----------------------------------------------------------------------
+    return {
+        // -- load -------------------------------------------------------------
+        /**
+         * load — Transitions a plugin to 'ready' status and starts its worker.
+         *
+         * This method is called after a plugin has been successfully installed and
+         * validated. It marks the plugin as ready in the database and immediately
+         * triggers the plugin loader to start the worker process.
+         *
+         * @param pluginId - The UUID of the plugin to load.
+         * @returns The updated plugin record.
+         */
+        async load(pluginId) {
+            const result = await transition(pluginId, "ready");
+            await activateReadyPlugin(pluginId);
+            emitDomain("plugin.loaded", {
+                pluginId,
+                pluginKey: result.pluginKey,
+            });
+            emitDomain("plugin.enabled", {
+                pluginId,
+                pluginKey: result.pluginKey,
+            });
+            return result;
+        },
+        // -- enable -----------------------------------------------------------
+        /**
+         * enable — Re-enables a plugin that was previously in an error or upgrade state.
+         *
+         * Similar to load(), this method transitions the plugin to 'ready' and starts
+         * its worker, but it specifically targets plugins that are currently disabled.
+         *
+         * @param pluginId - The UUID of the plugin to enable.
+         * @returns The updated plugin record.
+         */
+        async enable(pluginId) {
+            const plugin = await requirePlugin(pluginId);
+            // Only allow enabling from disabled, error, or upgrade_pending states
+            if (plugin.status !== "disabled" && plugin.status !== "error" && plugin.status !== "upgrade_pending") {
+                throw badRequest(`Cannot enable plugin in status '${plugin.status}'. ` +
+                    `Plugin must be in 'disabled', 'error', or 'upgrade_pending' status to be enabled.`);
+            }
+            const result = await transition(pluginId, "ready", null, plugin);
+            await activateReadyPlugin(pluginId);
+            emitDomain("plugin.enabled", {
+                pluginId,
+                pluginKey: result.pluginKey,
+            });
+            return result;
+        },
+        // -- disable ----------------------------------------------------------
+        async disable(pluginId, reason) {
+            const plugin = await requirePlugin(pluginId);
+            // Only allow disabling from ready state
+            if (plugin.status !== "ready") {
+                throw badRequest(`Cannot disable plugin in status '${plugin.status}'. ` +
+                    `Plugin must be in 'ready' status to be disabled.`);
+            }
+            await deactivatePluginRuntime(pluginId, plugin.pluginKey);
+            const result = await transition(pluginId, "disabled", reason ?? null, plugin);
+            emitDomain("plugin.disabled", {
+                pluginId,
+                pluginKey: result.pluginKey,
+                reason,
+            });
+            return result;
+        },
+        // -- unload -----------------------------------------------------------
+        async unload(pluginId, removeData = false) {
+            const plugin = await requirePlugin(pluginId);
+            // If already uninstalled and removeData, hard-delete
+            if (plugin.status === "uninstalled") {
+                if (removeData) {
+                    await pluginLoaderInstance.cleanupInstallArtifacts(plugin);
+                    const deleted = await registry.uninstall(pluginId, true);
+                    log.info({ pluginId, pluginKey: plugin.pluginKey }, "plugin lifecycle: hard-deleted already-uninstalled plugin");
+                    emitDomain("plugin.unloaded", {
+                        pluginId,
+                        pluginKey: plugin.pluginKey,
+                        removeData: true,
+                    });
+                    return deleted;
+                }
+                throw badRequest(`Plugin ${plugin.pluginKey} is already uninstalled. ` +
+                    `Use removeData=true to permanently delete it.`);
+            }
+            await deactivatePluginRuntime(pluginId, plugin.pluginKey);
+            await pluginLoaderInstance.cleanupInstallArtifacts(plugin);
+            // Perform the uninstall via registry (handles soft/hard delete)
+            const result = await registry.uninstall(pluginId, removeData);
+            log.info({ pluginId, pluginKey: plugin.pluginKey, removeData }, `plugin lifecycle: ${plugin.status} → uninstalled${removeData ? " (hard delete)" : ""}`);
+            emitter.emit("plugin.status_changed", {
+                pluginId,
+                pluginKey: plugin.pluginKey,
+                previousStatus: plugin.status,
+                newStatus: "uninstalled",
+            });
+            emitDomain("plugin.unloaded", {
+                pluginId,
+                pluginKey: plugin.pluginKey,
+                removeData,
+            });
+            return result;
+        },
+        // -- markError --------------------------------------------------------
+        async markError(pluginId, error) {
+            // Stop the worker — the plugin is in an error state and should not
+            // continue running. The worker manager's auto-restart is disabled
+            // because we are intentionally taking the plugin offline.
+            const plugin = await requirePlugin(pluginId);
+            await deactivatePluginRuntime(pluginId, plugin.pluginKey);
+            const result = await transition(pluginId, "error", error, plugin);
+            emitDomain("plugin.error", {
+                pluginId,
+                pluginKey: result.pluginKey,
+                error,
+            });
+            return result;
+        },
+        // -- markUpgradePending -----------------------------------------------
+        async markUpgradePending(pluginId) {
+            const plugin = await requirePlugin(pluginId);
+            await deactivatePluginRuntime(pluginId, plugin.pluginKey);
+            const result = await transition(pluginId, "upgrade_pending", null, plugin);
+            emitDomain("plugin.upgrade_pending", {
+                pluginId,
+                pluginKey: result.pluginKey,
+            });
+            return result;
+        },
+        // -- upgrade ----------------------------------------------------------
+        /**
+         * Upgrade a plugin to a newer version by performing a package update and
+         * managing the lifecycle state transition.
+         *
+         * Following PLUGIN_SPEC.md §25.3, the upgrade process:
+         * 1. Stops the current worker process (if running).
+         * 2. Fetches and validates the new plugin package via the `PluginLoader`.
+         * 3. Compares the capabilities declared in the new manifest against the old one.
+         * 4. If new capabilities are added, transitions the plugin to `upgrade_pending`
+         *    to await operator approval (worker stays stopped).
+         * 5. If no new capabilities are added, transitions the plugin back to `ready`
+         *    with the updated version and manifest metadata.
+         *
+         * @param pluginId - The UUID of the plugin to upgrade.
+         * @param version - Optional target version specifier.
+         * @returns The updated `PluginRecord`.
+         * @throws {BadRequest} If the plugin is not in a ready or upgrade_pending state.
+         */
+        async upgrade(pluginId, version) {
+            const plugin = await requirePlugin(pluginId);
+            // Can only upgrade plugins that are ready or already in upgrade_pending
+            if (plugin.status !== "ready" && plugin.status !== "upgrade_pending") {
+                throw badRequest(`Cannot upgrade plugin in status '${plugin.status}'. ` +
+                    `Plugin must be in 'ready' or 'upgrade_pending' status to be upgraded.`);
+            }
+            log.info({ pluginId, pluginKey: plugin.pluginKey, targetVersion: version }, "plugin lifecycle: upgrade requested");
+            await deactivatePluginRuntime(pluginId, plugin.pluginKey);
+            // 1. Download and validate new package via loader
+            const { oldManifest, newManifest, discovered } = await pluginLoaderInstance.upgradePlugin(pluginId, { version });
+            log.info({
+                pluginId,
+                pluginKey: plugin.pluginKey,
+                oldVersion: oldManifest.version,
+                newVersion: newManifest.version,
+            }, "plugin lifecycle: package upgraded on disk");
+            // 2. Compare capabilities
+            const addedCaps = newManifest.capabilities.filter((cap) => !oldManifest.capabilities.includes(cap));
+            // 3. Transition state
+            if (addedCaps.length > 0) {
+                // New capabilities require operator approval — worker stays stopped
+                log.info({ pluginId, pluginKey: plugin.pluginKey, addedCaps }, "plugin lifecycle: new capabilities detected, transitioning to upgrade_pending");
+                // Skip the inner stopWorkerIfRunning since we already stopped above
+                const result = await transition(pluginId, "upgrade_pending", null, plugin);
+                emitDomain("plugin.upgrade_pending", {
+                    pluginId,
+                    pluginKey: result.pluginKey,
+                });
+                return result;
+            }
+            else {
+                const result = await transition(pluginId, "ready", null, {
+                    ...plugin,
+                    version: discovered.version,
+                    manifestJson: newManifest,
+                });
+                await activateReadyPlugin(pluginId);
+                emitDomain("plugin.loaded", {
+                    pluginId,
+                    pluginKey: result.pluginKey,
+                });
+                emitDomain("plugin.enabled", {
+                    pluginId,
+                    pluginKey: result.pluginKey,
+                });
+                return result;
+            }
+        },
+        // -- startWorker ------------------------------------------------------
+        async startWorker(pluginId, options) {
+            if (!workerManager) {
+                throw badRequest("Cannot start worker: no PluginWorkerManager is configured. " +
+                    "Provide a workerManager option when constructing the lifecycle manager.");
+            }
+            const plugin = await requirePlugin(pluginId);
+            if (plugin.status !== "ready") {
+                throw badRequest(`Cannot start worker for plugin in status '${plugin.status}'. ` +
+                    `Plugin must be in 'ready' status.`);
+            }
+            log.info({ pluginId, pluginKey: plugin.pluginKey }, "plugin lifecycle: starting worker");
+            await workerManager.startWorker(pluginId, options);
+            emitDomain("plugin.worker_started", {
+                pluginId,
+                pluginKey: plugin.pluginKey,
+            });
+            log.info({ pluginId, pluginKey: plugin.pluginKey }, "plugin lifecycle: worker started");
+        },
+        // -- stopWorker -------------------------------------------------------
+        async stopWorker(pluginId) {
+            if (!workerManager)
+                return; // No worker manager — nothing to stop
+            const plugin = await requirePlugin(pluginId);
+            await stopWorkerIfRunning(pluginId, plugin.pluginKey);
+        },
+        // -- restartWorker ----------------------------------------------------
+        async restartWorker(pluginId) {
+            if (!workerManager) {
+                throw badRequest("Cannot restart worker: no PluginWorkerManager is configured.");
+            }
+            const plugin = await requirePlugin(pluginId);
+            if (plugin.status !== "ready") {
+                throw badRequest(`Cannot restart worker for plugin in status '${plugin.status}'. ` +
+                    `Plugin must be in 'ready' status.`);
+            }
+            const handle = workerManager.getWorker(pluginId);
+            if (!handle) {
+                throw badRequest(`Cannot restart worker for plugin "${plugin.pluginKey}": no worker is running.`);
+            }
+            log.info({ pluginId, pluginKey: plugin.pluginKey }, "plugin lifecycle: restarting worker");
+            await handle.restart();
+            emitDomain("plugin.worker_stopped", { pluginId, pluginKey: plugin.pluginKey });
+            emitDomain("plugin.worker_started", { pluginId, pluginKey: plugin.pluginKey });
+            log.info({ pluginId, pluginKey: plugin.pluginKey }, "plugin lifecycle: worker restarted");
+        },
+        // -- getStatus --------------------------------------------------------
+        async getStatus(pluginId) {
+            const plugin = await registry.getById(pluginId);
+            return plugin?.status ?? null;
+        },
+        // -- canTransition ----------------------------------------------------
+        async canTransition(pluginId, to) {
+            const plugin = await registry.getById(pluginId);
+            if (!plugin)
+                return false;
+            return isValidTransition(plugin.status, to);
+        },
+        // -- Event subscriptions ----------------------------------------------
+        on(event, listener) {
+            emitter.on(event, listener);
+        },
+        off(event, listener) {
+            emitter.off(event, listener);
+        },
+        once(event, listener) {
+            emitter.once(event, listener);
+        },
+    };
+}
+//# sourceMappingURL=plugin-lifecycle.js.map

package/dist/services/plugin-lifecycle.js.map

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