@osva-ai/cli 1.1.1 → 1.1.2

package/dist/platform/doctor.js

@@ -0,0 +1,154 @@
+import { loadComposeDistribution } from "../setup/distribution.js";
+import { defaultProbeSpawn } from "../setup/probe-spawn.js";
+import { doctorExitCode } from "../doctor/run-doctor.js";
+import { redactSecrets } from "../doctor/redact.js";
+import { isIncompleteUpgrade, readUpgradeState } from "./upgrade/state.js";
+import { collectPlatformStatus } from "./status.js";
+import { resolveInstallDir } from "../setup/install-path.js";
+import { resolveInstallationForLifecycle } from "./resolve-installation.js";
+import { PlatformCommandError } from "./types.js";
+export const PLATFORM_DOCTOR_SUBPROCESS_TIMEOUT_MS = 5_000;
+export async function runPlatformDoctor(flags, processEnv = process.env, deps = {}) {
+    const spawn = deps.spawn ?? defaultProbeSpawn;
+    const timeoutMs = PLATFORM_DOCTOR_SUBPROCESS_TIMEOUT_MS;
+    const checks = [];
+    checks.push(checkDockerCli(spawn, timeoutMs));
+    const engine = checkDockerEngine(spawn, timeoutMs);
+    checks.push(engine);
+    if (engine.status === "PASS") {
+        checks.push(checkDockerCompose(spawn, timeoutMs));
+    }
+    else {
+        checks.push(skipCheck("docker_compose", "Skipped because Docker Engine is unavailable."));
+    }
+    let installation;
+    const upgradeState = await readUpgradeState(resolveInstallDir(flags, processEnv, deps.platform));
+    if (isIncompleteUpgrade(upgradeState)) {
+        checks.push(warnCheck("upgrade_state", `Incomplete platform upgrade recorded (phase ${upgradeState.phase}).`, "See docs/operations/UPGRADE.md and `osva platform status` before retrying."));
+    }
+    try {
+        installation = await resolveInstallationForLifecycle(flags, processEnv, deps.platform);
+        checks.push(passCheck("installation_state", `Located OSVA installation at ${installation.installDir} (project ${installation.marker.composeProjectName}).`));
+    }
+    catch (error) {
+        if (error instanceof PlatformCommandError) {
+            checks.push(failCheck("installation_state", error.message, "Run `osva setup` or pass --install-dir to an existing installation."));
+            return finalizeReport(checks);
+        }
+        throw error;
+    }
+    try {
+        const distribution = await loadComposeDistribution();
+        if (installation.marker.platformVersion !==
+            distribution.manifest.platformVersion) {
+            checks.push(warnCheck("installation_version", `Installation platform version ${installation.marker.platformVersion} differs from CLI bundle ${distribution.manifest.platformVersion}.`, "Plan an explicit upgrade with `osva platform upgrade --to <version> --dry-run`."));
+        }
+        else {
+            checks.push(passCheck("installation_version", `Installation platform version ${installation.marker.platformVersion} matches the CLI bundle.`));
+        }
+    }
+    catch (error) {
+        checks.push(warnCheck("installation_version", error instanceof Error
+            ? error.message
+            : "Could not load CLI distribution metadata.", "Reinstall or rebuild the OSVA CLI package."));
+    }
+    if (installation.envValues.OSVA_IMAGE !== installation.marker.imageRef) {
+        checks.push(failCheck("installation_image", "Installed image metadata mismatch between marker and .env.", "Repair installation metadata or rerun setup reconciliation."));
+    }
+    else {
+        checks.push(passCheck("installation_image", `Installed image ${installation.marker.imageRef}.`));
+    }
+    const status = await collectPlatformStatus(installation, {
+        fetch: deps.fetch,
+        spawn: deps.spawn,
+    });
+    for (const service of status.services) {
+        const id = `service_${service.name.replace(/[^a-z0-9]+/gi, "_")}`;
+        if (service.state === "healthy") {
+            checks.push(passCheck(id, `${service.name}: healthy (${service.statusText}).`));
+            continue;
+        }
+        if (service.state === "running" || service.state === "starting") {
+            checks.push(warnCheck(id, `${service.name}: ${service.state} (${service.statusText}).`, service.name === "web"
+                ? "Wait for health checks or inspect logs with `osva platform logs --service web`."
+                : "Inspect service logs if the platform remains degraded."));
+            continue;
+        }
+        if (service.state === "stopped") {
+            checks.push(warnCheck(id, `${service.name}: stopped.`, "Run `osva platform start` to start the installation."));
+            continue;
+        }
+        checks.push(warnCheck(id, `${service.name}: ${service.state} (${service.statusText}).`, "Inspect Docker state with `osva platform status`."));
+    }
+    if (status.apiHealthOk) {
+        checks.push(passCheck("api_health", "GET /health succeeded."));
+    }
+    else {
+        checks.push(failCheck("api_health", `Control plane /health failed at ${installation.webUrl}.`, "Run `osva platform start` or inspect web logs."));
+    }
+    if (status.apiReadyOk) {
+        checks.push(passCheck("api_ready", "GET /ready succeeded (PostgreSQL and Valkey reachable from web)."));
+    }
+    else {
+        checks.push(failCheck("api_ready", `Control plane /ready failed at ${installation.webUrl}.`, "Ensure postgres and valkey are healthy (`osva platform logs --service postgres`)."));
+    }
+    if (status.consoleReady) {
+        checks.push(passCheck("console_ready", `Console responded at ${installation.consoleUrl}.`));
+    }
+    else {
+        checks.push(failCheck("console_ready", `Console is not reachable at ${installation.consoleUrl}.`, "Inspect `osva platform logs --service console`."));
+    }
+    for (const problem of status.problems) {
+        checks.push(warnCheck("platform_status", problem, "See `osva platform status` for details."));
+    }
+    return finalizeReport(checks);
+}
+export function platformDoctorExitCode(report) {
+    return doctorExitCode(report);
+}
+function checkDockerCli(spawn, timeoutMs) {
+    const result = spawn("docker", ["--version"], timeoutMs);
+    if (result.error?.code === "ENOENT") {
+        return failCheck("docker_cli", "Docker CLI was not found on PATH.", "Install Docker Desktop or Docker Engine.");
+    }
+    if (result.status !== 0) {
+        return failCheck("docker_cli", redactSecrets("Docker CLI is unavailable."), "Install Docker and ensure `docker` is on PATH.");
+    }
+    return passCheck("docker_cli", "Docker CLI is available.");
+}
+function checkDockerEngine(spawn, timeoutMs) {
+    const result = spawn("docker", ["info", "--format", "{{.ServerVersion}}"], timeoutMs);
+    if (result.error?.code === "ENOENT") {
+        return failCheck("docker_engine", "Docker CLI was not found on PATH.", "Install Docker Desktop or Docker Engine.");
+    }
+    if (result.status !== 0 || result.stdout.trim().length === 0) {
+        return failCheck("docker_engine", "Docker Engine is not reachable.", "Start Docker Desktop or the Docker daemon.");
+    }
+    return passCheck("docker_engine", `Docker Engine is reachable (server ${result.stdout.trim()}).`);
+}
+function checkDockerCompose(spawn, timeoutMs) {
+    const result = spawn("docker", ["compose", "version"], timeoutMs);
+    if (result.status !== 0) {
+        return failCheck("docker_compose", "Docker Compose v2 plugin is unavailable.", "Install Docker Compose v2 (`docker compose`).");
+    }
+    return passCheck("docker_compose", "Docker Compose v2 is available.");
+}
+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 };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/platform/doctor.js.map

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

package/dist/platform/format.d.ts

@@ -0,0 +1,10 @@
+import type { DoctorReport } from "../doctor/types.js";
+import type { LifecycleActionResult } from "./lifecycle.js";
+import type { PlatformStatusReport } from "./types.js";
+export declare function formatPlatformStatusHuman(report: PlatformStatusReport): string;
+export declare function formatPlatformStatusJson(report: PlatformStatusReport): string;
+export declare function formatLifecycleHuman(result: LifecycleActionResult): string;
+export declare function formatLifecycleJson(result: LifecycleActionResult): string;
+export declare function formatPlatformDoctorHuman(report: DoctorReport): string;
+export declare function formatPlatformDoctorJson(report: DoctorReport): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/platform/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/platform/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,oBAAoB,GAC3B,MAAM,CAqCR;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAqB7E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAE1E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAEzE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAWtE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAErE"}

package/dist/platform/format.js

@@ -0,0 +1,73 @@
+export function formatPlatformStatusHuman(report) {
+    const lines = [];
+    const { installation } = report;
+    lines.push(`Installation: ${installation.installDir}`);
+    lines.push(`Image: ${installation.marker.imageRef}`);
+    lines.push(`Platform version: ${installation.marker.platformVersion}`);
+    lines.push(`Compose project: ${installation.marker.composeProjectName}`);
+    lines.push(`Control plane: ${installation.webUrl}`);
+    lines.push(`Console: ${installation.consoleUrl}`);
+    lines.push(`Platform ready: ${report.platformReady ? "yes" : "no"} (API /ready: ${report.apiReadyOk ? "ok" : "not ok"})`);
+    lines.push(`Console ready: ${report.consoleReady ? "yes" : "no"}`);
+    lines.push("");
+    lines.push("Services:");
+    if (report.services.length === 0) {
+        lines.push("  (no containers reported — installation may be stopped)");
+    }
+    else {
+        for (const service of report.services) {
+            lines.push(`  ${service.name.padEnd(22)} ${service.state.padEnd(10)} ${service.statusText}`);
+        }
+    }
+    if (report.upgradeState !== undefined) {
+        lines.push(`Upgrade state: ${report.upgradeState.phase} (${report.upgradeState.fromPlatformVersion} → ${report.upgradeState.toPlatformVersion})`);
+    }
+    if (report.problems.length > 0) {
+        lines.push("");
+        lines.push("Problems:");
+        for (const problem of report.problems) {
+            lines.push(`  - ${problem}`);
+        }
+    }
+    return `${lines.join("\n")}\n`;
+}
+export function formatPlatformStatusJson(report) {
+    return `${JSON.stringify({
+        installDir: report.installation.installDir,
+        imageRef: report.installation.marker.imageRef,
+        platformVersion: report.installation.marker.platformVersion,
+        composeProjectName: report.installation.marker.composeProjectName,
+        webUrl: report.installation.webUrl,
+        mcpUrl: report.installation.mcpUrl,
+        consoleUrl: report.installation.consoleUrl,
+        platformReady: report.platformReady,
+        consoleReady: report.consoleReady,
+        apiHealthOk: report.apiHealthOk,
+        apiReadyOk: report.apiReadyOk,
+        services: report.services,
+        problems: report.problems,
+        upgradeState: report.upgradeState,
+    }, null, 2)}\n`;
+}
+export function formatLifecycleHuman(result) {
+    return `${result.message}\n`;
+}
+export function formatLifecycleJson(result) {
+    return `${JSON.stringify(result, null, 2)}\n`;
+}
+export function formatPlatformDoctorHuman(report) {
+    const lines = ["OSVA platform doctor", ""];
+    for (const check of report.checks) {
+        lines.push(`[${check.status}] ${check.id}: ${check.message}`);
+        if (check.remediation !== undefined) {
+            lines.push(`  → ${check.remediation}`);
+        }
+    }
+    lines.push("");
+    lines.push(`Result: ${report.result}`);
+    return `${lines.join("\n")}\n`;
+}
+export function formatPlatformDoctorJson(report) {
+    return `${JSON.stringify(report, null, 2)}\n`;
+}
+//# sourceMappingURL=format.js.map

package/dist/platform/format.js.map

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

package/dist/platform/index.d.ts

@@ -0,0 +1,9 @@
+import type { ProbeSpawnFn } from "../setup/probe-spawn.js";
+export type PlatformCommandDependencies = {
+    readonly spawn?: ProbeSpawnFn;
+    readonly fetch?: typeof fetch;
+    readonly processEnv?: NodeJS.ProcessEnv;
+    readonly platform?: NodeJS.Platform;
+};
+export declare function runPlatformCommand(subcommand: readonly string[], flags: Readonly<Record<string, string | boolean>>, deps?: PlatformCommandDependencies): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/platform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAO5D,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CACrC,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EACjD,IAAI,GAAE,2BAAgC,GACrC,OAAO,CAAC,MAAM,CAAC,CA8HjB"}

package/dist/platform/index.js

@@ -0,0 +1,143 @@
+import { writeStdout } from "../stdout.js";
+import { ComposeExecError } from "../setup/compose-exec.js";
+import { printError } from "../output.js";
+import { formatLifecycleHuman, formatLifecycleJson, formatPlatformDoctorHuman, formatPlatformDoctorJson, formatPlatformStatusHuman, formatPlatformStatusJson, } from "./format.js";
+import { runPlatformDoctor, platformDoctorExitCode } from "./doctor.js";
+import { runPlatformRestart, runPlatformStart, runPlatformStop, } from "./lifecycle.js";
+import { parsePlatformLogsOptions, runPlatformLogs } from "./logs.js";
+import { resolveInstallationForLifecycle } from "./resolve-installation.js";
+import { collectPlatformStatus } from "./status.js";
+import { PlatformCommandError } from "./types.js";
+import { parsePlatformUpgradeOptions } from "./upgrade/options.js";
+import { PlatformUpgradeDryRunReport, runPlatformUpgrade, } from "./upgrade/run-upgrade.js";
+export async function runPlatformCommand(subcommand, flags, deps = {}) {
+    const processEnv = deps.processEnv ?? process.env;
+    const json = flags.json === true;
+    if (subcommand.length === 0 || subcommand[0] === "help") {
+        printPlatformHelp();
+        return subcommand.length === 0 ? 1 : 0;
+    }
+    const action = subcommand[0];
+    try {
+        if (action === "status") {
+            const installation = await resolveInstallationForLifecycle(flags, processEnv, deps.platform);
+            const report = await collectPlatformStatus(installation, {
+                fetch: deps.fetch,
+                spawn: deps.spawn,
+            });
+            await writeStdout(json
+                ? formatPlatformStatusJson(report)
+                : formatPlatformStatusHuman(report));
+            return report.platformReady && report.problems.length === 0 ? 0 : 1;
+        }
+        if (action === "start") {
+            const installation = await resolveInstallationForLifecycle(flags, processEnv, deps.platform);
+            const result = await runPlatformStart(installation, {
+                spawn: deps.spawn,
+                fetch: deps.fetch,
+            });
+            await writeStdout(json ? formatLifecycleJson(result) : formatLifecycleHuman(result));
+            return 0;
+        }
+        if (action === "stop") {
+            const installation = await resolveInstallationForLifecycle(flags, processEnv, deps.platform);
+            const result = await runPlatformStop(installation, { spawn: deps.spawn });
+            await writeStdout(json ? formatLifecycleJson(result) : formatLifecycleHuman(result));
+            return 0;
+        }
+        if (action === "restart") {
+            const installation = await resolveInstallationForLifecycle(flags, processEnv, deps.platform);
+            const result = await runPlatformRestart(installation, {
+                spawn: deps.spawn,
+                fetch: deps.fetch,
+            });
+            await writeStdout(json ? formatLifecycleJson(result) : formatLifecycleHuman(result));
+            return 0;
+        }
+        if (action === "logs") {
+            const installation = await resolveInstallationForLifecycle(flags, processEnv, deps.platform);
+            const logOptions = parsePlatformLogsOptions(flags);
+            return await runPlatformLogs(installation, logOptions);
+        }
+        if (action === "upgrade") {
+            const installation = await resolveInstallationForLifecycle(flags, processEnv, deps.platform);
+            const upgradeOptions = parsePlatformUpgradeOptions(flags);
+            try {
+                const result = await runPlatformUpgrade(installation, upgradeOptions, {
+                    spawn: deps.spawn,
+                    fetch: deps.fetch,
+                    processEnv,
+                });
+                await writeStdout(json ? `${JSON.stringify(result, null, 2)}\n` : `${result.message}\n`);
+                return 0;
+            }
+            catch (error) {
+                if (error instanceof PlatformUpgradeDryRunReport) {
+                    await writeStdout(error.formatted);
+                    return error.report.blockingIssues.length > 0 ? 1 : 0;
+                }
+                throw error;
+            }
+        }
+        if (action === "doctor") {
+            const report = await runPlatformDoctor(flags, processEnv, deps);
+            await writeStdout(json
+                ? formatPlatformDoctorJson(report)
+                : formatPlatformDoctorHuman(report));
+            return platformDoctorExitCode(report);
+        }
+        printError(`Unknown platform command: ${subcommand.join(" ")}`);
+        printPlatformHelp();
+        return 1;
+    }
+    catch (error) {
+        return mapPlatformError(error, json);
+    }
+}
+function mapPlatformError(error, json) {
+    if (error instanceof PlatformCommandError) {
+        if (json) {
+            void writeStdout(`${JSON.stringify({ error: { code: error.code, message: error.message } }, null, 2)}\n`);
+        }
+        else {
+            printError(error.message);
+        }
+        return error.code === "usage" ? 1 : 1;
+    }
+    if (error instanceof ComposeExecError) {
+        const message = error.message;
+        if (json) {
+            void writeStdout(`${JSON.stringify({ error: { code: error.code, message } }, null, 2)}\n`);
+        }
+        else {
+            printError(message);
+        }
+        return 1;
+    }
+    if (error instanceof Error) {
+        printError(error.message);
+        return 1;
+    }
+    printError("Platform command failed.");
+    return 1;
+}
+function printPlatformHelp() {
+    process.stdout.write(`OSVA platform lifecycle
+
+Usage:
+  osva platform <command> [--install-dir PATH] [--json]
+
+Commands:
+  status    Show installation, service, and readiness overview
+  start     Start an existing installation (no image pull or migration)
+  stop      Gracefully stop services (preserves volumes and secrets)
+  restart   Restart services in place (no image pull or migration)
+  logs      Show recent service logs [--service NAME] [--tail N] [--follow]
+  doctor    Diagnose Docker, installation, services, API, and Console health
+  upgrade   Explicit platform upgrade (--to VERSION [--dry-run] [--backup-confirmed] [--yes])
+
+Install OSVA with \`osva setup\`. Lifecycle commands never create a new installation.
+\`platform upgrade\` requires --dry-run review, then --backup-confirmed and --yes to execute.
+`);
+}
+//# sourceMappingURL=index.js.map

package/dist/platform/index.js.map

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

package/dist/platform/lifecycle.d.ts

@@ -0,0 +1,20 @@
+import type { ProbeSpawnFn } from "../setup/probe-spawn.js";
+import { type ResolvedInstallation } from "./types.js";
+export declare const COMPOSE_LIFECYCLE_TIMEOUT_MS = 900000;
+export interface LifecycleActionResult {
+    readonly action: "start" | "stop" | "restart";
+    readonly servicesAffected: readonly string[];
+    readonly message: string;
+}
+export declare function runPlatformStart(installation: ResolvedInstallation, deps?: {
+    readonly spawn?: ProbeSpawnFn;
+    readonly fetch?: typeof fetch;
+}): Promise<LifecycleActionResult>;
+export declare function runPlatformStop(installation: ResolvedInstallation, deps?: {
+    readonly spawn?: ProbeSpawnFn;
+}): Promise<LifecycleActionResult>;
+export declare function runPlatformRestart(installation: ResolvedInstallation, deps?: {
+    readonly spawn?: ProbeSpawnFn;
+    readonly fetch?: typeof fetch;
+}): Promise<LifecycleActionResult>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/platform/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/platform/lifecycle.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAY5D,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE7E,eAAO,MAAM,4BAA4B,SAAU,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,oBAAoB,EAClC,IAAI,GAAE;IACJ,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GACL,OAAO,CAAC,qBAAqB,CAAC,CAuChC;AAED,wBAAsB,eAAe,CACnC,YAAY,EAAE,oBAAoB,EAClC,IAAI,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAO,GAC3C,OAAO,CAAC,qBAAqB,CAAC,CA4BhC;AAED,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,oBAAoB,EAClC,IAAI,GAAE;IACJ,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GACL,OAAO,CAAC,qBAAqB,CAAC,CA+ChC"}

package/dist/platform/lifecycle.js

@@ -0,0 +1,136 @@
+import { assertComposeSuccess, buildComposeSpawnEnv, composeCommandIncludesDestructiveVolumeRemoval, runComposeCommand, } from "../setup/compose-exec.js";
+import { redactSecrets } from "../doctor/redact.js";
+import { inspectComposeServices, migrateJobCompleted, } from "./compose-inspect.js";
+import { probeInstallationReadiness } from "./readiness.js";
+import { PLATFORM_APPLICATION_SERVICES, PLATFORM_DATA_SERVICES, PLATFORM_LIFECYCLE_SERVICES, } from "./services.js";
+import { assertPlatformLifecycleAllowed } from "./upgrade-guard.js";
+import { PlatformCommandError } from "./types.js";
+export const COMPOSE_LIFECYCLE_TIMEOUT_MS = 900_000;
+export async function runPlatformStart(installation, deps = {}) {
+    await assertPlatformLifecycleAllowed(installation.installDir, "start platform services");
+    const spawn = deps.spawn;
+    const servicesBefore = inspectComposeServices(installation.execCtx, spawn);
+    const migrateCompleted = migrateJobCompleted(servicesBefore);
+    if (migrateCompleted === false) {
+        throw new PlatformCommandError("platform_not_ready", "Database migration has not completed successfully. Run `osva setup --yes` to migrate before starting the platform (lifecycle start does not run migrations).");
+    }
+    startDataServices(installation, spawn);
+    startApplicationServices(installation, spawn);
+    const readiness = await probeInstallationReadiness(installation, deps.fetch ?? fetch);
+    if (!readiness.apiReadyOk) {
+        const detail = readiness.apiReadyDetail === undefined
+            ? ""
+            : ` (${readiness.apiReadyDetail})`;
+        throw new PlatformCommandError("platform_not_ready", `Platform services started but the control plane is not ready${detail}. This can indicate schema drift or unhealthy dependencies. Inspect logs with \`osva platform logs --service web\`; migrations are not run automatically during start.`);
+    }
+    return {
+        action: "start",
+        servicesAffected: [...PLATFORM_LIFECYCLE_SERVICES],
+        message: "OSVA platform services are running and the control plane reported ready.",
+    };
+}
+export async function runPlatformStop(installation, deps = {}) {
+    await assertPlatformLifecycleAllowed(installation.installDir, "stop platform services");
+    const args = ["stop", ...PLATFORM_LIFECYCLE_SERVICES];
+    assertLifecycleArgs(args);
+    const result = runComposeCommand(installation.execCtx, args, {
+        spawn: deps.spawn,
+        timeoutMs: COMPOSE_LIFECYCLE_TIMEOUT_MS,
+        processEnv: buildComposeSpawnEnv(installation.execCtx),
+    });
+    if (result.status !== 0 && result.status !== null) {
+        throw new PlatformCommandError("compose_failed", redactSecrets(firstLine(result.stderr) ||
+            firstLine(result.stdout) ||
+            "docker compose stop failed."));
+    }
+    return {
+        action: "stop",
+        servicesAffected: [...PLATFORM_LIFECYCLE_SERVICES],
+        message: "Stopped OSVA platform services (volumes and installation files preserved).",
+    };
+}
+export async function runPlatformRestart(installation, deps = {}) {
+    await assertPlatformLifecycleAllowed(installation.installDir, "restart platform services");
+    const args = ["restart", ...PLATFORM_LIFECYCLE_SERVICES];
+    assertLifecycleArgs(args);
+    const result = runComposeCommand(installation.execCtx, args, {
+        spawn: deps.spawn,
+        timeoutMs: COMPOSE_LIFECYCLE_TIMEOUT_MS,
+        processEnv: buildComposeSpawnEnv(installation.execCtx),
+    });
+    if (result.status !== 0) {
+        throw new PlatformCommandError("compose_failed", redactSecrets(firstLine(result.stderr) ||
+            firstLine(result.stdout) ||
+            "docker compose restart failed."));
+    }
+    let apiHealthOk = false;
+    for (let attempt = 0; attempt < 30; attempt += 1) {
+        const readiness = await probeInstallationReadiness(installation, deps.fetch ?? fetch);
+        if (readiness.apiHealthOk) {
+            apiHealthOk = true;
+            break;
+        }
+        await delay(2_000);
+    }
+    if (!apiHealthOk) {
+        throw new PlatformCommandError("platform_not_ready", "Services restarted but the control plane health endpoint is not OK yet. Retry `osva platform status` or inspect logs.");
+    }
+    return {
+        action: "restart",
+        servicesAffected: [...PLATFORM_LIFECYCLE_SERVICES],
+        message: `Restarted: ${PLATFORM_LIFECYCLE_SERVICES.join(", ")}.`,
+    };
+}
+function startDataServices(installation, spawn) {
+    const args = [
+        "up",
+        "-d",
+        "--no-build",
+        "--pull",
+        "never",
+        "--wait",
+        ...PLATFORM_DATA_SERVICES,
+    ];
+    assertLifecycleArgs(args);
+    const result = runComposeCommand(installation.execCtx, args, {
+        spawn,
+        timeoutMs: COMPOSE_LIFECYCLE_TIMEOUT_MS,
+        processEnv: buildComposeSpawnEnv(installation.execCtx),
+    });
+    assertComposeSuccess(result, "Starting PostgreSQL and Valkey");
+}
+function startApplicationServices(installation, spawn) {
+    const args = [
+        "up",
+        "-d",
+        "--no-build",
+        "--pull",
+        "never",
+        "--wait",
+        ...PLATFORM_APPLICATION_SERVICES,
+    ];
+    assertLifecycleArgs(args);
+    const result = runComposeCommand(installation.execCtx, args, {
+        spawn,
+        timeoutMs: COMPOSE_LIFECYCLE_TIMEOUT_MS,
+        processEnv: buildComposeSpawnEnv(installation.execCtx),
+    });
+    assertComposeSuccess(result, "Starting OSVA application services");
+}
+function assertLifecycleArgs(args) {
+    if (composeCommandIncludesDestructiveVolumeRemoval(args)) {
+        throw new Error("Refusing destructive docker compose down -v.");
+    }
+}
+function delay(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+function firstLine(text) {
+    return (text
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .find((line) => line.length > 0) ?? "");
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/platform/lifecycle.js.map

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

package/dist/platform/logs.d.ts

@@ -0,0 +1,12 @@
+import { type ResolvedInstallation } from "./types.js";
+export declare const DEFAULT_LOG_TAIL = 100;
+export declare const MAX_LOG_TAIL = 10000;
+export declare const COMPOSE_LOGS_TIMEOUT_MS = 120000;
+export interface PlatformLogsOptions {
+    readonly service: string | undefined;
+    readonly tail: number;
+    readonly follow: boolean;
+}
+export declare function parsePlatformLogsOptions(flags: Readonly<Record<string, string | boolean>>): PlatformLogsOptions;
+export declare function runPlatformLogs(installation: ResolvedInstallation, options: PlatformLogsOptions): Promise<number>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/platform/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/platform/logs.ts"],"names":[],"mappings":"AAWA,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE7E,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,YAAY,QAAS,CAAC;AACnC,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAChD,mBAAmB,CAsCrB;AAED,wBAAsB,eAAe,CACnC,YAAY,EAAE,oBAAoB,EAClC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAqEjB"}