0xray 3.1.1 → 3.3.0

package/dist/nucleus/orchestrator.js

@@ -1,479 +0,0 @@
-/**
- * xray Nucleus — Orchestrator
- *
- * Core boot orchestration logic extracted from boot-orchestrator.server.ts.
- * Owns the component dependency graph, initialization sequence, and status tracking.
- * The MCP server is a thin surface over this class.
- */
-import { execSync } from "child_process";
-import fs from "fs";
-import path from "path";
-import { frameworkLogger } from "../core/framework-logger.js";
-import { resolveLogDir, resolveStateDir } from "../core/config-paths.js";
-import { registerDefaultPlugins } from "./default-plugins.js";
-export class NucleusOrchestrator {
-    initialized = false;
-    startTime = Date.now();
-    components = new Map();
-    dependencies = new Map();
-    health = new Map();
-    // Boot sequence in dependency order
-    bootSequence = [
-        "configuration",
-        "logging",
-        "plugin-registration",
-        "state-management",
-        "security",
-        "codex-loader",
-        "context-loader",
-        "processor-pipeline",
-        "agent-registry",
-        "orchestrator",
-        "mcp-servers",
-        "framework-hooks",
-    ];
-    constructor() {
-        this.initializeDependencies();
-    }
-    isInitialized() {
-        return this.initialized;
-    }
-    getComponentResult(component) {
-        return this.components.get(component);
-    }
-    getComponentHealth(component) {
-        return this.health.get(component);
-    }
-    getComponentDependencies(component) {
-        return this.dependencies.get(component) || [];
-    }
-    initializeDependencies() {
-        this.dependencies.set("configuration", []);
-        this.dependencies.set("logging", ["configuration"]);
-        this.dependencies.set("state-management", ["configuration", "logging"]);
-        this.dependencies.set("security", ["configuration"]);
-        this.dependencies.set("codex-loader", ["configuration", "logging"]);
-        this.dependencies.set("context-loader", ["configuration", "codex-loader"]);
-        this.dependencies.set("processor-pipeline", ["state-management", "security", "codex-loader"]);
-        this.dependencies.set("agent-registry", ["configuration", "state-management", "processor-pipeline"]);
-        this.dependencies.set("orchestrator", ["agent-registry", "processor-pipeline"]);
-        this.dependencies.set("mcp-servers", ["orchestrator", "agent-registry"]);
-        this.dependencies.set("framework-hooks", ["mcp-servers", "orchestrator"]);
-    }
-    async executeBootSequence(options) {
-        const skipHealthChecks = options?.skipHealthChecks || false;
-        const parallelInit = options?.parallelInit !== false;
-        frameworkLogger.log("nucleus-orchestrator", "execute-boot-sequence", "info", {
-            skipHealthChecks,
-            parallelInit,
-        });
-        const results = {
-            success: true,
-            initializedComponents: [],
-            failedComponents: [],
-            duration: 0,
-            errors: [],
-            warnings: [],
-        };
-        const startTime = Date.now();
-        try {
-            const validationResults = await this.validatePrerequisites();
-            if (!validationResults.valid) {
-                results.success = false;
-                results.errors.push(...validationResults.errors);
-                results.duration = Date.now() - startTime;
-                return results;
-            }
-            if (parallelInit) {
-                await this.executeParallelBoot(skipHealthChecks, results);
-            }
-            else {
-                await this.executeSequentialBoot(skipHealthChecks, results);
-            }
-            results.duration = Date.now() - startTime;
-            this.initialized = results.success;
-            return results;
-        }
-        catch (error) {
-            results.success = false;
-            results.duration = Date.now() - startTime;
-            results.errors.push(`Boot sequence failed: ${error instanceof Error ? error.message : String(error)}`);
-            return results;
-        }
-    }
-    getOverallBootStatus() {
-        const totalComponents = this.bootSequence.length;
-        const initializedComponents = Array.from(this.components.keys());
-        const healthyComponents = Array.from(this.health.values()).filter((h) => h).length;
-        return {
-            initialized: this.initialized,
-            uptime: Date.now() - this.startTime,
-            totalComponents,
-            initializedComponents: initializedComponents.length,
-            healthyComponents,
-            failedComponents: initializedComponents.length - healthyComponents,
-        };
-    }
-    async getComponentStatus(component) {
-        const initialized = this.components.has(component);
-        const healthy = this.health.get(component) || false;
-        const info = this.components.get(component);
-        return {
-            initialized,
-            healthy,
-            info,
-            dependencies: this.dependencies.get(component) || [],
-        };
-    }
-    async initializeSingleComponent(component, force) {
-        if (this.components.has(component) && !force) {
-            return {
-                success: true,
-                duration: 0,
-                message: `Component already initialized: ${component}`,
-            };
-        }
-        const deps = this.dependencies.get(component) || [];
-        for (const dep of deps) {
-            if (!this.components.has(dep)) {
-                return {
-                    success: false,
-                    duration: 0,
-                    error: `Dependency not met: ${component} requires ${dep}`,
-                };
-            }
-        }
-        const result = await this.initializeComponent(component);
-        this.components.set(component, result);
-        this.health.set(component, result.success);
-        return result;
-    }
-    async validateAllDependencies(fix, verbose) {
-        const results = {
-            total: this.bootSequence.length,
-            valid: 0,
-            missing: 0,
-            circular: 0,
-            issues: [],
-            fixes: [],
-        };
-        for (const component of this.bootSequence) {
-            const deps = this.dependencies.get(component) || [];
-            const missingDeps = deps.filter((dep) => !this.checkComponentExists(dep));
-            if (missingDeps.length > 0) {
-                results.missing++;
-                results.issues.push(`${component} missing dependencies: ${missingDeps.join(", ")}`);
-            }
-            else {
-                results.valid++;
-            }
-        }
-        const circularDeps = this.detectCircularDependencies();
-        if (circularDeps.length > 0) {
-            results.circular = circularDeps.length;
-            results.issues.push(`Circular dependencies detected: ${circularDeps.join(", ")}`);
-        }
-        if (fix && results.issues.length > 0) {
-            results.fixes = await this.applyDependencyFixes(results.issues);
-        }
-        return results;
-    }
-    async shutdown(force, saveState) {
-        const results = {
-            success: true,
-            shutDown: 0,
-            stateSaved: saveState !== false,
-            errors: [],
-            duration: 0,
-        };
-        const startTime = Date.now();
-        try {
-            const reverseSequence = [...this.bootSequence].reverse();
-            for (const component of reverseSequence) {
-                try {
-                    await this.shutdownComponent(component, force || false);
-                    results.shutDown++;
-                }
-                catch (error) {
-                    results.errors.push(`${component}: ${error instanceof Error ? error.message : String(error)}`);
-                    if (!force) {
-                        results.success = false;
-                    }
-                }
-            }
-            if (saveState !== false) {
-                await this.saveShutdownState();
-            }
-        }
-        catch (error) {
-            results.success = false;
-            results.errors.push(`Shutdown error: ${error instanceof Error ? error.message : String(error)}`);
-        }
-        results.duration = Date.now() - startTime;
-        return results;
-    }
-    async validatePrerequisites() {
-        const errors = [];
-        try {
-            const nodeVersionOutput = execSync("node --version", { encoding: "utf8" })?.toString().trim() || "";
-            const nodeVersion = nodeVersionOutput || "v1.2.0";
-            const versionParts = nodeVersion.split(".");
-            const majorVersion = versionParts.length > 0 && versionParts[0]
-                ? parseInt(versionParts[0].substring(1))
-                : 0;
-            if (majorVersion < 18) {
-                errors.push(`Node.js version ${nodeVersion} is too old. Requires 18+`);
-            }
-        }
-        catch {
-            errors.push("Cannot determine Node.js version");
-        }
-        const requiredDirs = ["src", "src/agents", "src/mcps"];
-        for (const dir of requiredDirs) {
-            if (!fs.existsSync(dir)) {
-                errors.push(`Required directory missing: ${dir}`);
-            }
-        }
-        if (!fs.existsSync("package.json")) {
-            errors.push("package.json not found");
-        }
-        return { valid: errors.length === 0, errors };
-    }
-    async executeParallelBoot(skipHealthChecks, results) {
-        const componentPromises = this.bootSequence.map((component) => this.initializeComponent(component, skipHealthChecks));
-        const componentResults = await Promise.allSettled(componentPromises);
-        for (let i = 0; i < componentResults.length; i++) {
-            const component = this.bootSequence[i];
-            if (!component)
-                continue;
-            const result = componentResults[i];
-            if (!result)
-                continue;
-            if (result.status === "fulfilled") {
-                const fulfilledResult = result;
-                if (fulfilledResult.value.success) {
-                    results.initializedComponents.push(component);
-                    this.components.set(component, fulfilledResult.value);
-                    this.health.set(component, true);
-                }
-                else {
-                    results.failedComponents.push(component);
-                    results.errors.push(`${component}: ${fulfilledResult.value.error || "Unknown error"}`);
-                }
-            }
-            else {
-                results.failedComponents.push(component);
-                results.errors.push(`${component}: ${result.reason}`);
-            }
-        }
-        results.success = results.failedComponents.length === 0;
-    }
-    async executeSequentialBoot(skipHealthChecks, results) {
-        for (const component of this.bootSequence) {
-            try {
-                const result = await this.initializeComponent(component, skipHealthChecks);
-                if (result.success) {
-                    results.initializedComponents.push(component);
-                    this.components.set(component, result);
-                    this.health.set(component, true);
-                }
-                else {
-                    results.failedComponents.push(component);
-                    results.errors.push(`${component}: ${result.error}`);
-                    break;
-                }
-            }
-            catch (error) {
-                results.failedComponents.push(component);
-                results.errors.push(`${component}: ${error instanceof Error ? error.message : String(error)}`);
-                break;
-            }
-        }
-        results.success = results.failedComponents.length === 0;
-    }
-    async initializeComponent(component, _skipHealthChecks = false) {
-        const startTime = Date.now();
-        try {
-            switch (component) {
-                case "configuration":
-                    return this.initConfiguration();
-                case "logging":
-                    return this.initLogging();
-                case "plugin-registration":
-                    return await this.initPluginRegistration();
-                case "state-management":
-                    return this.initStateManagement();
-                case "security":
-                    return this.initSecurity();
-                case "codex-loader":
-                    return this.initCodexLoader();
-                case "context-loader":
-                    return this.initContextLoader();
-                case "processor-pipeline":
-                    return this.initProcessorPipeline();
-                case "agent-registry":
-                    return this.initAgentRegistry();
-                case "orchestrator":
-                    return this.initOrchestrator();
-                case "mcp-servers":
-                    return this.initMCPServers();
-                case "framework-hooks":
-                    return this.initFrameworkHooks();
-                default:
-                    throw new Error(`Unknown component: ${component}`);
-            }
-        }
-        catch (error) {
-            return {
-                success: false,
-                duration: Date.now() - startTime,
-                error: error instanceof Error ? error.message : String(error),
-            };
-        }
-    }
-    initConfiguration() {
-        return { success: true, duration: 10, message: "Configuration initialized" };
-    }
-    initLogging() {
-        const logDir = resolveLogDir();
-        if (!fs.existsSync(logDir)) {
-            fs.mkdirSync(logDir, { recursive: true });
-        }
-        return { success: true, duration: 5, message: "Logging system initialized" };
-    }
-    async initPluginRegistration() {
-        const start = Date.now();
-        const r = await registerDefaultPlugins();
-        if (r.registered === 0) {
-            return {
-                success: false,
-                duration: Date.now() - start,
-                error: "No plugins registered",
-            };
-        }
-        return {
-            success: true,
-            duration: Date.now() - start,
-            message: `Plugin registration: ${r.registered} registered, ${r.failed.length} failed`,
-        };
-    }
-    initStateManagement() {
-        const stateDir = resolveStateDir();
-        if (!fs.existsSync(stateDir)) {
-            fs.mkdirSync(stateDir, { recursive: true });
-        }
-        return { success: true, duration: 8, message: "State management initialized" };
-    }
-    initSecurity() {
-        return { success: true, duration: 3, message: "Security framework initialized" };
-    }
-    initCodexLoader() {
-        return { success: true, duration: 12, message: "Codex loader initialized" };
-    }
-    initContextLoader() {
-        return { success: true, duration: 8, message: "Context loader initialized" };
-    }
-    initProcessorPipeline() {
-        return { success: true, duration: 15, message: "Processor pipeline initialized" };
-    }
-    initAgentRegistry() {
-        const agentCount = this.countAgentFiles();
-        if (agentCount < 5) {
-            throw new Error(`Insufficient agents found: ${agentCount}`);
-        }
-        return { success: true, duration: 10, message: `Agent registry initialized with ${agentCount} agents` };
-    }
-    initOrchestrator() {
-        return { success: true, duration: 20, message: "Orchestrator initialized" };
-    }
-    initMCPServers() {
-        const mcpCount = this.countMCPFiles();
-        if (mcpCount < 3) {
-            throw new Error(`Insufficient MCP servers found: ${mcpCount}`);
-        }
-        return { success: true, duration: 15, message: `MCP servers initialized (${mcpCount} servers)` };
-    }
-    initFrameworkHooks() {
-        return { success: true, duration: 5, message: "Framework hooks initialized" };
-    }
-    countAgentFiles() {
-        try {
-            const files = fs.readdirSync("src/agents");
-            return files.filter((f) => f.endsWith(".ts") && f !== "types.ts" && f !== "index.ts").length;
-        }
-        catch {
-            return 0;
-        }
-    }
-    countMCPFiles() {
-        try {
-            const files = fs.readdirSync("src/mcps");
-            return files.filter((f) => f.endsWith(".server.ts")).length;
-        }
-        catch {
-            return 0;
-        }
-    }
-    checkComponentExists(component) {
-        switch (component) {
-            case "configuration":
-                return fs.existsSync("opencode.json");
-            case "logging":
-                return fs.existsSync("src/framework-logger.ts");
-            case "state-management":
-                return fs.existsSync("src/state/state-manager.ts");
-            case "security":
-                return true;
-            case "codex-loader":
-                return true;
-            case "context-loader":
-                return true;
-            case "processor-pipeline":
-                return fs.existsSync("src/processors/processor-manager.ts");
-            case "agent-registry":
-                return fs.existsSync("src/agents");
-            case "orchestrator":
-                return fs.existsSync("src/delegation/agent-delegator.ts");
-            case "mcp-servers":
-                return fs.existsSync("src/mcps");
-            case "framework-hooks":
-                return fs.existsSync("src/core/xray-activation.ts");
-            default:
-                return false;
-        }
-    }
-    detectCircularDependencies() {
-        const circular = [];
-        for (const [component, deps] of this.dependencies) {
-            for (const dep of deps) {
-                const depDeps = this.dependencies.get(dep) || [];
-                if (depDeps.includes(component)) {
-                    circular.push(`${component} ↔ ${dep}`);
-                }
-            }
-        }
-        return [...new Set(circular)];
-    }
-    async applyDependencyFixes(issues) {
-        const fixes = [];
-        for (const issue of issues) {
-            if (issue.includes("missing dependencies")) {
-                fixes.push("Dependency validation completed - manual fixes may be required");
-            }
-        }
-        return fixes;
-    }
-    async shutdownComponent(component, force) {
-        frameworkLogger.log("nucleus-orchestrator", "shutdown-component", "info", { component, force });
-        await new Promise((resolve) => setTimeout(resolve, 10));
-    }
-    async saveShutdownState() {
-        const shutdownState = {
-            timestamp: Date.now(),
-            components: Array.from(this.components.keys()),
-            health: Object.fromEntries(this.health),
-        };
-        const stateFile = path.join(".opencode", "state", "shutdown-state.json");
-        fs.writeFileSync(stateFile, JSON.stringify(shutdownState, null, 2));
-    }
-}