@evalops/maestro 0.10.8 → 0.10.10

package/dist/main.js

@@ -86,13 +86,14 @@
  *
  * @module main
  */
+import { createRequire } from "node:module";
 import chalk from "chalk";
-import { ActionApprovalService, } from "./agent/action-approval.js";
 import { createBackgroundTextAgent } from "./agent/background-agent.js";
 import { isAssistantMessage, } from "./agent/index.js";
 import { applySessionEndHooks } from "./agent/session-lifecycle-hooks.js";
 import { ToolRetryService } from "./agent/tool-retry.js";
 import { applySessionStartHooks, runUserPromptWithRecovery, } from "./agent/user-prompt-runtime.js";
+import { PlatformBackedActionApprovalService } from "./approvals/platform-action-approval.js";
 import { createAuthSetup, validateCodexFlags } from "./bootstrap/auth-setup.js";
 import { disposeCheckpointService, initCheckpointService, } from "./checkpoints/index.js";
 import { TuiClientToolService } from "./cli-tui/client-tools/local-client-tool-service.js";
@@ -114,7 +115,6 @@ import { createAutomaticMemoryExtractionCoordinator, getMemoryExtractionSystemPr
 import { ensureModelsLoaded } from "./models/builtin.js";
 import { reloadModelConfig } from "./models/registry.js";
 import { initOpenTelemetry } from "./opentelemetry.js";
-import { getPackageVersion } from "./package-metadata.js";
 import { resolveMaestroSystemPrompt } from "./prompts/system-prompt.js";
 import { AgentRuntimeController } from "./runtime/agent-runtime.js";
 import { registerBackgroundTaskShutdownHooks } from "./runtime/background-task-hooks.js";
@@ -124,8 +124,15 @@ import { clientToolService } from "./server/client-tools-service.js";
 import { ServerRequestToolRetryService } from "./server/tool-retry-service.js";
 import { SessionManager } from "./session/manager.js";
 import { askUserClientTool } from "./tools/ask-user-client.js";
+import { createStartupProfilerFromEnv } from "./utils/checkpoint-profiler.js";
 import { isInsideGitRepository } from "./utils/git.js";
-const VERSION = getPackageVersion();
+/**
+ * Load version from package.json at runtime.
+ * Uses Node's createRequire for compatibility with ESM imports
+ * (avoids experimental import assertions syntax).
+ */
+const packageJson = createRequire(import.meta.url)("../package.json");
+const VERSION = packageJson.version ?? "unknown";
 let enterpriseCleanupRegistered = false;
 let checkpointCleanupRegistered = false;
 let sandboxCleanupRegistered = false;
@@ -327,8 +334,11 @@ export async function main(args) {
     // ─────────────────────────────────────────────────────────────────────────────
     // Load environment variables from .env files (project and user level)
     loadEnv();
+    const startupProfiler = createStartupProfilerFromEnv();
+    startupProfiler.checkpoint("process:start");
     // Parse arguments early to check for version/help flags before heavy initialization
     const parsed = parseArgs(args);
+    startupProfiler.checkpoint("cli:parsed");
     // Handle --version early exit (before any async operations)
     if (parsed.version) {
         console.log(`Maestro v${VERSION}`);
@@ -343,6 +353,15 @@ export async function main(args) {
         console.error(chalk.red(parsed.error));
         process.exit(1);
     }
+    // Handle `maestro hosted-runner` before importing web-server so hosted
+    // defaults are visible to its module-level runtime profile.
+    if (parsed.command === "hosted-runner") {
+        const { handleHostedRunnerCommand } = await import("./cli/commands/hosted-runner.js");
+        await handleHostedRunnerCommand(parsed.commandArgs ?? [], {
+            defaultPort: parsed.port,
+        });
+        return;
+    }
     // Handle `maestro web` early exit (start the bundled web server + UI).
     if (parsed.command === "web") {
         if (parsed.messages.length > 0) {
@@ -350,19 +369,15 @@ export async function main(args) {
             process.exit(1);
         }
         const { startWebServer } = await import("./web-server.js");
+        const { migrate } = await import("./db/migrate.js");
         const port = parsed.port ?? (Number.parseInt(process.env.PORT || "8080", 10) || 8080);
-        await startWebServer(port);
+        await migrate();
+        await startWebServer(port, { skipStartupMigration: true });
         return;
     }
-    const runtimeConfig = loadRuntimeConfig(parsed, process.cwd());
-    const reasoningSummary = runtimeConfig.config.model_supports_reasoning_summaries === false
-        ? undefined
-        : runtimeConfig.config.model_reasoning_summary === "none"
-            ? null
-            : runtimeConfig.config.model_reasoning_summary;
     // If we're about to enter interactive TUI mode (no prompt messages and not RPC/exec),
     // or headless mode (stdout is JSON-only), redirect all logging/console output to a file.
-    // This must run before model loading to catch any early warnings.
+    // This must run before config/model loading to catch any early warnings.
     const isLikelyInteractiveTui = !parsed.messages.length &&
         (parsed.mode === "text" || parsed.mode === undefined) &&
         parsed.command === undefined;
@@ -370,15 +385,35 @@ export async function main(args) {
     if (isLikelyInteractiveTui || isHeadlessMode) {
         const { redirectLoggerToFile, redirectConsoleToLogger, redirectStderrToLogger, pipeProcessEventsToLogger, } = await import("./utils/logger.js");
         redirectLoggerToFile();
-        redirectConsoleToLogger();
-        redirectStderrToLogger();
+        redirectConsoleToLogger({ preserveErrorStderr: isHeadlessMode });
+        if (!isHeadlessMode) {
+            redirectStderrToLogger();
+        }
         pipeProcessEventsToLogger();
     }
-    const startupProfilingEnabled = process.env.MAESTRO_STARTUP_PROFILE === "1";
-    const logStartupPhase = (label, startedAt) => {
-        if (!startupProfilingEnabled)
-            return;
-        console.error(`[startup] ${label}: ${Math.round(performance.now() - startedAt)}ms`);
+    const runtimeConfig = loadRuntimeConfig(parsed, process.cwd());
+    startupProfiler.checkpoint("config:loaded");
+    const reasoningSummary = runtimeConfig.config.model_supports_reasoning_summaries === false
+        ? undefined
+        : runtimeConfig.config.model_reasoning_summary === "none"
+            ? null
+            : runtimeConfig.config.model_reasoning_summary;
+    const exitWithStartupError = (error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        const stack = error instanceof Error ? error.stack : undefined;
+        if (isHeadlessMode) {
+            process.stdout.write(`${JSON.stringify({
+                type: "error",
+                message: `Headless startup failed: ${message}`,
+                fatal: true,
+                error_type: "fatal",
+            })}\n`);
+            process.stderr.write(`${stack ?? message}\n`);
+        }
+        else {
+            console.error(chalk.red(message));
+        }
+        process.exit(1);
     };
     // ─────────────────────────────────────────────────────────────────────────────
     // PHASE 1: Environment and Telemetry Initialization
@@ -386,17 +421,14 @@ export async function main(args) {
     // Initialize OpenTelemetry tracing for observability
     // This is non-blocking (void) to avoid startup latency
     void initOpenTelemetry("composer-cli");
-    const bootstrapParallelStart = performance.now();
     const modelLoadPromise = (async () => {
-        const startedAt = performance.now();
         await ensureModelsLoaded();
-        logStartupPhase("models.loaded", startedAt);
+        startupProfiler.checkpoint("models:loaded");
     })();
     const enterpriseContextPromise = (async () => {
-        const startedAt = performance.now();
         const { enterpriseContext } = await import("./enterprise/context.js");
         await enterpriseContext.initialize();
-        logStartupPhase("enterprise.initialized", startedAt);
+        startupProfiler.checkpoint("enterprise:initialized");
         return enterpriseContext;
     })();
     // Pre-load model registry and enterprise context in parallel. These are
@@ -405,7 +437,7 @@ export async function main(args) {
         enterpriseContextPromise,
         modelLoadPromise,
     ]);
-    logStartupPhase("bootstrap.parallel", bootstrapParallelStart);
+    startupProfiler.checkpoint("bootstrap:parallel");
     // ─────────────────────────────────────────────────────────────────────────────
     // PHASE 2: Enterprise Context Initialization
     // ─────────────────────────────────────────────────────────────────────────────
@@ -453,24 +485,22 @@ export async function main(args) {
         validateCodexFlags(args, parsed.command);
     }
     catch (error) {
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
+        exitWithStartupError(error);
     }
     const { requireCredential } = createAuthSetup({
         authMode,
         explicitApiKey: parsed.apiKey,
     });
+    startupProfiler.checkpoint("auth:configured");
     if (parsed.command === "exec") {
         if (parsed.execFullAuto && parsed.execReadOnly) {
-            console.error(chalk.red("Cannot combine --full-auto with --read-only in maestro exec."));
-            process.exit(1);
+            exitWithStartupError("Cannot combine --full-auto with --read-only in maestro exec.");
         }
     }
     // Validate sandbox mode (applies to both exec and interactive modes)
     const validSandboxModes = ["docker", "local", "none"];
     if (parsed.sandbox && !validSandboxModes.includes(parsed.sandbox)) {
-        console.error(chalk.red(`Unknown sandbox mode "${parsed.sandbox}". Supported: ${validSandboxModes.join(", ")}`));
-        process.exit(1);
+        exitWithStartupError(`Unknown sandbox mode "${parsed.sandbox}". Supported: ${validSandboxModes.join(", ")}`);
     }
     // ─────────────────────────────────────────────────────────────────────────────
     // PHASE 5: Safety, LSP, and Checkpointing
@@ -502,6 +532,7 @@ export async function main(args) {
         process.once("SIGTERM", disposeCheckpoint);
         checkpointCleanupRegistered = true;
     }
+    startupProfiler.checkpoint("runtime:prepared");
     // ─────────────────────────────────────────────────────────────────────────────
     // Early Exit: Help Command
     // ─────────────────────────────────────────────────────────────────────────────
@@ -540,6 +571,16 @@ export async function main(args) {
         await handleOpenAICommand(parsed.subcommand, parsed.messages);
         return;
     }
+    if (parsed.command === "evalops") {
+        const { handleEvalOpsCommand } = await import("./cli/commands/evalops.js");
+        await handleEvalOpsCommand(parsed.subcommand);
+        return;
+    }
+    if (parsed.command === "codex") {
+        const { handleCodexCommand } = await import("./cli/commands/codex.js");
+        await handleCodexCommand(parsed.subcommand, parsed.messages);
+        return;
+    }
     if (parsed.command === "hooks") {
         const { handleHooksCommand } = await import("./cli/commands/hooks.js");
         await handleHooksCommand(parsed.subcommand);
@@ -560,6 +601,11 @@ export async function main(args) {
         await handleMemoryCommand(parsed.subcommand, parsed.messages);
         return;
     }
+    if (parsed.command === "remote") {
+        const { handleRemoteCommand } = await import("./cli/commands/remote.js");
+        await handleRemoteCommand(parsed.subcommand, parsed.commandArgs ?? []);
+        return;
+    }
     if (parsed.command === "anthropic") {
         const { handleAnthropicCommand } = await import("./cli/commands/anthropic.js");
         await handleAnthropicCommand(parsed.subcommand, parsed.messages);
@@ -599,6 +645,34 @@ export async function main(args) {
                 process.exit(1);
         }
     }
+    if (parsed.command === "stats") {
+        const { handleStatsCommand } = await import("./cli/commands/stats.js");
+        switch (parsed.subcommand) {
+            case undefined:
+            case "today":
+            case "yesterday":
+            case "week":
+            case "7d":
+            case "month":
+            case "30d":
+            case "all":
+                await handleStatsCommand(parsed.subcommand, {
+                    sessionId: parsed.session,
+                    format: parsed.exportFormat,
+                });
+                return;
+            default:
+                console.error(chalk.red(`Unknown stats subcommand: ${parsed.subcommand}`));
+                console.log(chalk.dim("\nAvailable commands:"));
+                console.log(chalk.dim("  maestro stats              - Show last 7 days"));
+                console.log(chalk.dim("  maestro stats --session <id> - Show one session"));
+                console.log(chalk.dim("  maestro stats today        - Show today"));
+                console.log(chalk.dim("  maestro stats month        - Show last 30 days"));
+                console.log(chalk.dim("  maestro stats all          - Show all time"));
+                console.log(chalk.dim("  maestro stats --format json|csv - Export usage data"));
+                process.exit(1);
+        }
+    }
     // Handle models commands
     if (parsed.command === "models") {
         const { handleModelsList, handleModelsProviders } = await import("./cli/commands/models.js");
@@ -660,6 +734,7 @@ export async function main(args) {
     // - Model/thinking level tracking across restarts
     const sessionManager = new SessionManager(parsed.continue && !parsed.resume, // continueSession: auto-load most recent
     parsed.session);
+    startupProfiler.checkpoint("session:created");
     let execResumeApplied = false;
     if (parsed.command === "exec") {
         let targetPath = null;
@@ -712,8 +787,7 @@ export async function main(args) {
         model = resolved.model;
     }
     catch (error) {
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
+        exitWithStartupError(error);
     }
     // ─────────────────────────────────────────────────────────────────────────────
     // PHASE 9: System Prompt and Tool Configuration
@@ -729,6 +803,9 @@ export async function main(args) {
         toolNames: systemPromptToolNames,
         appendPrompt: parsed.appendSystemPrompt,
     });
+    startupProfiler.checkpoint("prompt:assembled", {
+        system_bytes: systemPrompt.length,
+    });
     const systemPromptSourcePaths = resolveExplicitSystemPromptSourcePaths(parsed.systemPrompt, parsed.appendSystemPrompt);
     // Determine approval mode for tool execution:
     // - "prompt": Ask user before each tool execution (default for interactive)
@@ -751,7 +828,9 @@ export async function main(args) {
     // Create approval service that controls tool execution authorization
     const approvalService = isHeadlessMode
         ? new ServerRequestActionApprovalService(approvalModeOverride, () => sessionManager.getSessionId() ?? undefined)
-        : new ActionApprovalService(approvalModeOverride);
+        : new PlatformBackedActionApprovalService(approvalModeOverride, {
+            sessionIdProvider: () => sessionManager.getSessionId() ?? undefined,
+        });
     const headlessClientToolService = isHeadlessMode
         ? clientToolService.forSession(() => sessionManager.getSessionId() ?? undefined)
         : undefined;
@@ -775,10 +854,10 @@ export async function main(args) {
         });
     }
     catch (error) {
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
+        exitWithStartupError(error);
     }
     const { allTools, sandbox, sandboxMode } = toolsResult;
+    startupProfiler.checkpoint("tools:prepared", { tools: allTools.length });
     const useInteractiveClientTools = Boolean(interactiveClientToolService);
     const replaceAskUserTool = (tools) => tools.map((tool) => tool.name === "ask_user" ? askUserClientTool : tool);
     const configuredAllTools = useInteractiveClientTools
@@ -828,6 +907,7 @@ export async function main(args) {
         cwd: process.cwd(),
     });
     setTaskBudgetTotal(agent, parsed.taskBudget);
+    startupProfiler.checkpoint("agent:ready");
     // ─────────────────────────────────────────────────────────────────────────────
     // PHASE 11.5: TypeScript Hooks Initialization
     // ─────────────────────────────────────────────────────────────────────────────
@@ -841,14 +921,13 @@ export async function main(args) {
     // ─────────────────────────────────────────────────────────────────────────────
     // PHASE 12: MCP (Model Context Protocol) Integration
     // ─────────────────────────────────────────────────────────────────────────────
-    const mcpInitStartedAt = performance.now();
     const { initializeMcpServers } = await import("./bootstrap/mcp-setup.js");
     initializeMcpServers({
         agent,
         baseTools: configuredAllTools,
         cwd: process.cwd(),
     });
-    logStartupPhase("mcp.bootstrap_queued", mcpInitStartedAt);
+    startupProfiler.checkpoint("mcp:bootstrap_queued");
     // Determine mode early to know if we should print messages
     const isInteractive = parsed.messages.length === 0;
     const mode = parsed.mode || "text";
@@ -939,6 +1018,7 @@ export async function main(args) {
     // 5. Single-shot: Process CLI messages and exit
     try {
         if (agentsInitPrompt) {
+            startupProfiler.terminal("exec:ready", { mode: "agents" });
             const cwd = process.cwd();
             const targetPath = agentsInitPath ?? "AGENTS.md";
             const displayPath = targetPath.startsWith(cwd) && targetPath !== cwd
@@ -951,15 +1031,18 @@ export async function main(args) {
         }
         else if (mode === "headless" || parsed.headless) {
             // Headless mode - for native TUI communication
+            startupProfiler.terminal("headless:ready");
             await runHeadlessMode(agent, sessionManager, approvalService, toolRetryService);
         }
         else if (mode === "rpc") {
             // RPC mode - headless operation
+            startupProfiler.terminal("rpc:ready");
             const { runRpcMode } = await import("./cli/rpc-mode.js");
             await runRpcMode(agent, sessionManager);
         }
         else if (isInteractive) {
             // No messages and not RPC - use TUI
+            startupProfiler.terminal("ui:ready");
             await runInteractiveMode(agent, sessionManager, VERSION, approvalService, toolRetryService, parsed.apiKey, {
                 clientToolService: interactiveClientToolService,
                 modelScope: scopedModels,
@@ -968,6 +1051,7 @@ export async function main(args) {
             });
         }
         else if (parsed.command === "exec") {
+            startupProfiler.terminal("exec:ready");
             await runExecCommand({
                 agent,
                 sessionManager,
@@ -980,6 +1064,7 @@ export async function main(args) {
         }
         else {
             // CLI mode with messages
+            startupProfiler.terminal("cli:ready");
             await runSingleShotMode(agent, sessionManager, parsed.messages, mode);
         }
     }