@osva-ai/cli 1.1.0 → 1.1.2

package/dist/setup/run-setup.js

@@ -0,0 +1,227 @@
+import { statfsSync } from "node:fs";
+import path from "node:path";
+import net from "node:net";
+import os from "node:os";
+import { checkNodeRuntime } from "../doctor/run-doctor.js";
+import { redactSecrets } from "../doctor/redact.js";
+import { CLI_VERSION } from "../version.js";
+import { defaultProbeSpawn, } from "./probe-spawn.js";
+import { readInstallEnvFile } from "./env-file.js";
+export const DEFAULT_SETUP_SUBPROCESS_TIMEOUT_MS = 5_000;
+const SUPPORTED_PLATFORMS = new Set([
+    "win32",
+    "darwin",
+    "linux",
+]);
+export async function runSetupPipeline(options, deps = {}) {
+    const spawn = deps.spawn ?? defaultProbeSpawn;
+    const timeoutMs = deps.subprocessTimeoutMs ?? DEFAULT_SETUP_SUBPROCESS_TIMEOUT_MS;
+    const platform = deps.platform ?? process.platform;
+    const arch = deps.arch ?? process.arch;
+    const checks = [];
+    checks.push(checkHostPlatform(platform));
+    checks.push(checkHostArchitecture(arch));
+    checks.push(checkNodeRuntime());
+    checks.push(passCheck("cli_version", `OSVA CLI ${CLI_VERSION} (installation preflight and provisioning).`));
+    const dockerCli = checkDockerCli(spawn, timeoutMs);
+    checks.push(dockerCli);
+    if (dockerCli.status !== "PASS") {
+        checks.push(skipCheck("docker_engine", "Skipped because the Docker CLI is unavailable."));
+        checks.push(skipCheck("docker_compose", "Skipped because the Docker CLI is unavailable."));
+    }
+    else {
+        checks.push(checkDockerEngine(spawn, timeoutMs));
+        checks.push(checkDockerCompose(spawn, timeoutMs));
+    }
+    const probeLoopbackPort = deps.probeLoopbackPort ?? probeLoopbackPortAvailability;
+    const portReconciliation = {
+        authorizeExisting: options.authorizeExisting,
+        installDir: options.installDir,
+    };
+    checks.push(await checkPublishPort("publish_web_port", options.webPort, probeLoopbackPort, { ...portReconciliation, envKey: "OSVA_PUBLISH_WEB_PORT" }));
+    checks.push(await checkPublishPort("publish_mcp_port", options.mcpPort, probeLoopbackPort, { ...portReconciliation, envKey: "OSVA_PUBLISH_MCP_PORT" }));
+    checks.push(await checkPublishPort("publish_console_port", options.consolePort, probeLoopbackPort, { ...portReconciliation, envKey: "OSVA_PUBLISH_CONSOLE_PORT" }));
+    checks.push(checkHostMemory());
+    checks.push(checkHostDiskSpace(deps.cwdForDisk ?? options.installDir ?? process.cwd()));
+    return finalizeReport(checks);
+}
+function checkHostPlatform(platform) {
+    if (SUPPORTED_PLATFORMS.has(platform)) {
+        return passCheck("host_platform", `Host OS ${platform} is supported for OSVA Compose installation.`);
+    }
+    return warnCheck("host_platform", `Host OS '${platform}' is not a tested installation platform.`, "OSVA self-hosted Compose is validated on Windows, macOS, and Linux.");
+}
+function checkHostArchitecture(arch) {
+    return passCheck("host_architecture", `Host CPU architecture is ${arch}.`);
+}
+function checkDockerCli(spawn, timeoutMs) {
+    const result = spawn("docker", ["--version"], timeoutMs);
+    const timedOut = mapDockerProbeTimeout(result, "docker_cli");
+    if (timedOut !== undefined) {
+        return timedOut;
+    }
+    if (isExecutableMissing(result)) {
+        return failCheck("docker_cli", "Docker CLI was not found on PATH.", "Install Docker Desktop or Docker Engine and ensure `docker` is on PATH.");
+    }
+    if (result.status !== 0) {
+        return failCheck("docker_cli", redactSecrets(trimProbeMessage(result, "Docker CLI `--version` failed.")), "Reinstall Docker or fix your Docker installation.");
+    }
+    const versionLine = redactSecrets(firstLine(result.stdout) || firstLine(result.stderr));
+    return passCheck("docker_cli", versionLine.length > 0
+        ? `Docker CLI available (${versionLine}).`
+        : "Docker CLI available.");
+}
+function checkDockerEngine(spawn, timeoutMs) {
+    const result = spawn("docker", ["info", "--format", "{{.ServerVersion}}"], timeoutMs);
+    const timedOut = mapDockerProbeTimeout(result, "docker_engine");
+    if (timedOut !== undefined) {
+        return timedOut;
+    }
+    if (isExecutableMissing(result)) {
+        return failCheck("docker_engine", "Docker CLI was not found on PATH.", "Install Docker Desktop or Docker Engine and ensure `docker` is on PATH.");
+    }
+    const serverVersion = result.stdout.trim();
+    if (result.status !== 0 || serverVersion.length === 0) {
+        return failCheck("docker_engine", redactSecrets(trimProbeMessage(result, "Docker Engine is not reachable (daemon not running or permission denied).")), "Start Docker Desktop or the Docker daemon and confirm `docker info` succeeds.");
+    }
+    return passCheck("docker_engine", `Docker Engine is reachable (server ${serverVersion}).`);
+}
+function checkDockerCompose(spawn, timeoutMs) {
+    const result = spawn("docker", ["compose", "version"], timeoutMs);
+    const timedOut = mapDockerProbeTimeout(result, "docker_compose");
+    if (timedOut !== undefined) {
+        return timedOut;
+    }
+    if (isExecutableMissing(result)) {
+        return failCheck("docker_compose", "Docker CLI was not found on PATH.", "Install Docker Desktop or Docker Engine with Compose v2.");
+    }
+    if (result.status !== 0) {
+        return failCheck("docker_compose", redactSecrets(trimProbeMessage(result, "Docker Compose v2 plugin is unavailable (`docker compose`).")), "Install Docker Compose v2 (bundled with current Docker Desktop / Engine packages).");
+    }
+    const versionLine = redactSecrets(firstLine(result.stdout) || firstLine(result.stderr));
+    return passCheck("docker_compose", versionLine.length > 0
+        ? `Docker Compose v2 available (${versionLine}).`
+        : "Docker Compose v2 available.");
+}
+async function checkPublishPort(id, port, probe, reconciliation) {
+    const probeResult = await probe(port);
+    if (probeResult.kind === "available") {
+        return passCheck(id, `Loopback (127.0.0.1) port ${String(port)} appears available; other interfaces were not checked.`);
+    }
+    if (probeResult.kind === "in_use") {
+        if (reconciliation?.authorizeExisting === true &&
+            (await installEnvPublishPortMatches(reconciliation.installDir, reconciliation.envKey, port))) {
+            return passCheck(id, `Loopback (127.0.0.1) port ${String(port)} is in use by this installation (expected during --yes reconciliation).`);
+        }
+        return failCheck(id, `Loopback (127.0.0.1) port ${String(port)} is already in use.`, `Stop the process using port ${String(port)} or choose another port via --web-port / --mcp-port or OSVA_PUBLISH_* env vars.`);
+    }
+    if (probeResult.kind === "permission_denied") {
+        return failCheck(id, `Loopback (127.0.0.1) port ${String(port)} could not be probed (permission denied).`, "Run the CLI with sufficient privileges to bind loopback ports, or choose a different port above 1024.");
+    }
+    const codeSuffix = probeResult.code === undefined ? "" : ` (${probeResult.code})`;
+    return failCheck(id, `Loopback (127.0.0.1) port ${String(port)} could not be probed${codeSuffix}.`, `Choose another port via --web-port / --mcp-port or OSVA_PUBLISH_* env vars, then retry.`);
+}
+async function installEnvPublishPortMatches(installDir, envKey, port) {
+    const envPath = path.join(installDir, ".env");
+    const env = await readInstallEnvFile(envPath);
+    return env?.get(envKey) === String(port);
+}
+function probeLoopbackPortAvailability(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        let settled = false;
+        const finish = (result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            server.close(() => {
+                resolve(result);
+            });
+        };
+        server.once("error", (error) => {
+            if (error.code === "EADDRINUSE") {
+                finish({ kind: "in_use" });
+                return;
+            }
+            if (error.code === "EACCES") {
+                finish({ kind: "permission_denied" });
+                return;
+            }
+            finish({ kind: "probe_error", code: error.code });
+        });
+        server.listen({ port, host: "127.0.0.1", exclusive: true }, () => {
+            finish({ kind: "available" });
+        });
+    });
+}
+function checkHostMemory() {
+    const totalBytes = os.totalmem();
+    const freeBytes = os.freemem();
+    return passCheck("host_memory", `About ${formatBytes(freeBytes)} free of ${formatBytes(totalBytes)} total system memory (informational; no minimum enforced).`);
+}
+function checkHostDiskSpace(cwd) {
+    try {
+        const stats = statfsSync(cwd);
+        const freeBytes = stats.bfree * stats.bsize;
+        return passCheck("host_disk_space", `About ${formatBytes(freeBytes)} free on the filesystem containing ${cwd} (informational; no minimum enforced).`);
+    }
+    catch {
+        return warnCheck("host_disk_space", "Could not read free disk space for the current working directory.", "Ensure the installation directory resides on a writable volume with adequate space.");
+    }
+}
+function mapDockerProbeTimeout(result, id) {
+    if (result.error?.code === "ETIMEDOUT") {
+        return failCheck(id, "Docker command timed out during preflight.", "Ensure Docker responds promptly and retry `osva setup`.");
+    }
+    return undefined;
+}
+function isExecutableMissing(result) {
+    return result.error?.code === "ENOENT";
+}
+function trimProbeMessage(result, fallback) {
+    const detail = firstLine(result.stderr) || firstLine(result.stdout);
+    if (detail.length === 0) {
+        return fallback;
+    }
+    return `${fallback} ${detail}`;
+}
+function firstLine(text) {
+    return (text
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .find((line) => line.length > 0) ?? "");
+}
+function formatBytes(bytes) {
+    if (!Number.isFinite(bytes) || bytes < 0) {
+        return "unknown";
+    }
+    const gib = bytes / 1024 ** 3;
+    if (gib >= 1) {
+        return `${gib.toFixed(1)} GiB`;
+    }
+    const mib = bytes / 1024 ** 2;
+    return `${mib.toFixed(0)} MiB`;
+}
+function passCheck(id, message) {
+    return { id, status: "PASS", message };
+}
+function warnCheck(id, message, remediation) {
+    return { id, status: "WARN", message, remediation };
+}
+function failCheck(id, message, remediation) {
+    return { id, status: "FAIL", message, remediation };
+}
+function skipCheck(id, message) {
+    return { id, status: "SKIP", message };
+}
+function finalizeReport(checks) {
+    const hasFail = checks.some((check) => check.status === "FAIL");
+    const hasWarn = checks.some((check) => check.status === "WARN");
+    const result = hasFail ? "fail" : hasWarn ? "warn" : "pass";
+    return { result, checks };
+}
+export function setupExitCode(report) {
+    return report.result === "fail" ? 1 : 0;
+}
+//# sourceMappingURL=run-setup.js.map

package/dist/setup/run-setup.js.map

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

package/dist/setup/secrets.d.ts

@@ -0,0 +1,2 @@
+export declare function generateSecretHex(byteLength: number): string;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/setup/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/setup/secrets.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK5D"}

package/dist/setup/secrets.js

@@ -0,0 +1,8 @@
+import { randomBytes } from "node:crypto";
+export function generateSecretHex(byteLength) {
+    if (!Number.isInteger(byteLength) || byteLength < 16) {
+        throw new Error("Secret byte length must be at least 16.");
+    }
+    return randomBytes(byteLength).toString("hex");
+}
+//# sourceMappingURL=secrets.js.map

package/dist/setup/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../src/setup/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC"}

package/dist/setup/setup-report.d.ts

@@ -0,0 +1,19 @@
+import type { DoctorCheck, DoctorReport } from "../doctor/types.js";
+export interface SetupReport extends DoctorReport {
+    readonly installDir?: string;
+    readonly platformReady?: boolean;
+    readonly installationComplete?: boolean;
+    readonly consoleReady?: boolean;
+    readonly administratorBootstrapped?: boolean;
+    readonly phase: "preflight" | "provision";
+    /** Excluded from JSON diagnostics; human output only. */
+    readonly setupTokenForOperator?: string;
+}
+export declare function mergeSetupReport(input: {
+    readonly preflight: DoctorReport;
+    readonly provisionChecks?: readonly DoctorCheck[];
+    readonly installDir: string;
+    readonly phase: "preflight" | "provision";
+    readonly setupTokenForOperator?: string;
+}): SetupReport;
+//# sourceMappingURL=setup-report.d.ts.map

package/dist/setup/setup-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-report.d.ts","sourceRoot":"","sources":["../../src/setup/setup-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CACzC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC;IAC1C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CACzC,GAAG,WAAW,CAgCd"}

package/dist/setup/setup-report.js

@@ -0,0 +1,35 @@
+export function mergeSetupReport(input) {
+    const checks = input.provisionChecks
+        ? [...input.preflight.checks, ...input.provisionChecks]
+        : input.preflight.checks;
+    const result = finalizeResult(checks);
+    const platformReady = checks.some((check) => check.id === "platform_services_ready" && check.status === "PASS");
+    const installationComplete = checks.some((check) => check.id === "installation_complete" && check.status === "PASS");
+    const consoleReady = checks.some((check) => check.id === "console_ready" && check.status === "PASS");
+    const administratorBootstrapped = checks.some((check) => check.id === "administrator_bootstrapped" && check.status === "PASS");
+    return {
+        result,
+        checks,
+        installDir: input.installDir,
+        platformReady,
+        installationComplete,
+        consoleReady,
+        administratorBootstrapped,
+        phase: input.phase,
+        ...(input.setupTokenForOperator === undefined
+            ? {}
+            : { setupTokenForOperator: input.setupTokenForOperator }),
+    };
+}
+function finalizeResult(checks) {
+    const hasFail = checks.some((check) => check.status === "FAIL");
+    const hasWarn = checks.some((check) => check.status === "WARN");
+    if (hasFail) {
+        return "fail";
+    }
+    if (hasWarn) {
+        return "warn";
+    }
+    return "pass";
+}
+//# sourceMappingURL=setup-report.js.map

package/dist/setup/setup-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-report.js","sourceRoot":"","sources":["../../src/setup/setup-report.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,gBAAgB,CAAC,KAMhC;IACC,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe;QAClC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,eAAe,CAAC;QACvD,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;IAC3B,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAC/B,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,EAAE,KAAK,yBAAyB,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CACpE,CAAC;IACF,MAAM,oBAAoB,GAAG,MAAM,CAAC,IAAI,CACtC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,uBAAuB,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAC3E,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAC9B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,eAAe,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CACnE,CAAC;IACF,MAAM,yBAAyB,GAAG,MAAM,CAAC,IAAI,CAC3C,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,EAAE,KAAK,4BAA4B,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CACvE,CAAC;IACF,OAAO;QACL,MAAM;QACN,MAAM;QACN,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,aAAa;QACb,oBAAoB;QACpB,YAAY;QACZ,yBAAyB;QACzB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,CAAC,KAAK,CAAC,qBAAqB,KAAK,SAAS;YAC3C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,MAA8B;IAE9B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAChE,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}