Method startDevServer

src/tools/launch-tool/index.ts:41–88

(appPath: string, runCommand: string, timeoutMs: number = 60_000)

    private static readonly inFlightStarts = new Map<string, Promise<void>>();

    async startDevServer(appPath: string, runCommand: string, timeoutMs: number = 60_000): Promise<string> {
        const serverKey = makeServerKey(appPath);
        const prev = LaunchTool.inFlightStarts.get(appPath);
        let resolveThis: () => void;
        const thisRun = new Promise<void>(r => {
            resolveThis = r;
        });
        LaunchTool.inFlightStarts.set(appPath, thisRun);
        await prev;

        try {
            const entry = LaunchTool.serverManagers.get(serverKey);
            if (entry) {
                const handle = await entry.manager.restart({ timeoutMs });
                const result: StartDevServerResult = {
                    success: true,
                    serverKey,
                    url: handle.url,
                    port: handle.port,
                    pid: handle.child.pid ?? undefined,
                    outputTail: handle.outputTail(),
                };
                return JSON.stringify(result, null, 2);
            }

            const manager = new DevServerManager({ appPath, runCommand: runCommand.trim() });
            const handle = await manager.start({ timeoutMs });
            LaunchTool.serverManagers.set(serverKey, { manager, appPath });
            const result: StartDevServerResult = {
                success: true,
                serverKey,
                url: handle.url,
                port: handle.port,
                pid: handle.child.pid ?? undefined,
                outputTail: handle.outputTail(),
            };
            return JSON.stringify(result, null, 2);
        } catch (error) {
            const result: StartDevServerResult = {
                success: false,
                error: error instanceof Error ? error.message : String(error),
            };
            return JSON.stringify(result, null, 2);
        } finally {
            resolveThis!();
            LaunchTool.inFlightStarts.delete(appPath);
        }
    }

    async stopDevServer(serverKey: string): Promise<string> {
        const entry = LaunchTool.serverManagers.get(serverKey);