@osva-ai/cli 1.1.0 → 1.1.2

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":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,8CAA8C,EAC9C,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAA6B,MAAM,YAAY,CAAC;AAE7E,MAAM,CAAC,MAAM,4BAA4B,GAAG,OAAO,CAAC;AAQpD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAAkC,EAClC,OAGI,EAAE;IAEN,MAAM,8BAA8B,CAClC,YAAY,CAAC,UAAU,EACvB,yBAAyB,CAC1B,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,cAAc,GAAG,sBAAsB,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3E,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAC7D,IAAI,gBAAgB,KAAK,KAAK,EAAE,CAAC;QAC/B,MAAM,IAAI,oBAAoB,CAC5B,oBAAoB,EACpB,8JAA8J,CAC/J,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACvC,wBAAwB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAE9C,MAAM,SAAS,GAAG,MAAM,0BAA0B,CAChD,YAAY,EACZ,IAAI,CAAC,KAAK,IAAI,KAAK,CACpB,CAAC;IACF,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAC1B,MAAM,MAAM,GACV,SAAS,CAAC,cAAc,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,KAAK,SAAS,CAAC,cAAc,GAAG,CAAC;QACvC,MAAM,IAAI,oBAAoB,CAC5B,oBAAoB,EACpB,+DAA+D,MAAM,wKAAwK,CAC9O,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,OAAO;QACf,gBAAgB,EAAE,CAAC,GAAG,2BAA2B,CAAC;QAClD,OAAO,EACL,0EAA0E;KAC7E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAAkC,EAClC,OAA0C,EAAE;IAE5C,MAAM,8BAA8B,CAClC,YAAY,CAAC,UAAU,EACvB,wBAAwB,CACzB,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,2BAA2B,CAAC,CAAC;IACtD,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE;QAC3D,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS,EAAE,4BAA4B;QACvC,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,OAAO,CAAC;KACvD,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,oBAAoB,CAC5B,gBAAgB,EAChB,aAAa,CACX,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;YACtB,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;YACxB,6BAA6B,CAChC,CACF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,MAAM;QACd,gBAAgB,EAAE,CAAC,GAAG,2BAA2B,CAAC;QAClD,OAAO,EACL,4EAA4E;KAC/E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAAkC,EAClC,OAGI,EAAE;IAEN,MAAM,8BAA8B,CAClC,YAAY,CAAC,UAAU,EACvB,2BAA2B,CAC5B,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,GAAG,2BAA2B,CAAC,CAAC;IACzD,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE;QAC3D,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS,EAAE,4BAA4B;QACvC,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,OAAO,CAAC;KACvD,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,oBAAoB,CAC5B,gBAAgB,EAChB,aAAa,CACX,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;YACtB,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;YACxB,gCAAgC,CACnC,CACF,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,MAAM,0BAA0B,CAChD,YAAY,EACZ,IAAI,CAAC,KAAK,IAAI,KAAK,CACpB,CAAC;QACF,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;YAC1B,WAAW,GAAG,IAAI,CAAC;YACnB,MAAM;QACR,CAAC;QACD,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,oBAAoB,CAC5B,oBAAoB,EACpB,uHAAuH,CACxH,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,gBAAgB,EAAE,CAAC,GAAG,2BAA2B,CAAC;QAClD,OAAO,EAAE,cAAc,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;KACjE,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,YAAkC,EAClC,KAA+B;IAE/B,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,IAAI;QACJ,YAAY;QACZ,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,GAAG,sBAAsB;KAC1B,CAAC;IACF,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE;QAC3D,KAAK;QACL,SAAS,EAAE,4BAA4B;QACvC,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,OAAO,CAAC;KACvD,CAAC,CAAC;IACH,oBAAoB,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,wBAAwB,CAC/B,YAAkC,EAClC,KAA+B;IAE/B,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,IAAI;QACJ,YAAY;QACZ,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,GAAG,6BAA6B;KACjC,CAAC;IACF,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE;QAC3D,KAAK;QACL,SAAS,EAAE,4BAA4B;QACvC,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,OAAO,CAAC;KACvD,CAAC,CAAC;IACH,oBAAoB,CAAC,MAAM,EAAE,oCAAoC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAuB;IAClD,IAAI,8CAA8C,CAAC,IAAI,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,CACL,IAAI;SACD,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CACzC,CAAC;AACJ,CAAC"}

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"}

package/dist/platform/logs.js

@@ -0,0 +1,81 @@
+import { buildComposeSpawnEnv, composeBaseArgs, runComposeCommand, } from "../setup/compose-exec.js";
+import { redactSecrets } from "../doctor/redact.js";
+import { defaultProbeSpawn, spawnStreamingCommand, } from "../setup/probe-spawn.js";
+import { KNOWN_COMPOSE_SERVICES } from "./services.js";
+import { PlatformCommandError } from "./types.js";
+export const DEFAULT_LOG_TAIL = 100;
+export const MAX_LOG_TAIL = 10_000;
+export const COMPOSE_LOGS_TIMEOUT_MS = 120_000;
+export function parsePlatformLogsOptions(flags) {
+    const follow = flags.follow === true;
+    const serviceFlag = flags.service;
+    let service;
+    if (typeof serviceFlag === "string" && serviceFlag.trim().length > 0) {
+        service = serviceFlag.trim();
+    }
+    else if (serviceFlag === true) {
+        throw new PlatformCommandError("usage", "--service requires a Compose service name (for example web, postgres, console).");
+    }
+    const tailFlag = flags.tail;
+    if (tailFlag === true) {
+        throw new PlatformCommandError("usage", "--tail requires a positive integer (default 100).");
+    }
+    let tail = DEFAULT_LOG_TAIL;
+    if (typeof tailFlag === "string" && tailFlag.trim().length > 0) {
+        if (!/^\d+$/.test(tailFlag.trim())) {
+            throw new PlatformCommandError("usage", `Invalid --tail value '${tailFlag}'; use an integer between 1 and ${String(MAX_LOG_TAIL)}.`);
+        }
+        tail = Number(tailFlag.trim());
+        if (tail < 1 || tail > MAX_LOG_TAIL) {
+            throw new PlatformCommandError("usage", `--tail must be between 1 and ${String(MAX_LOG_TAIL)}.`);
+        }
+    }
+    return { service, tail, follow };
+}
+export async function runPlatformLogs(installation, options) {
+    if (options.service !== undefined) {
+        const known = KNOWN_COMPOSE_SERVICES.includes(options.service);
+        if (!known) {
+            throw new PlatformCommandError("usage", `Unknown service '${options.service}'. Expected one of: ${KNOWN_COMPOSE_SERVICES.join(", ")}.`);
+        }
+    }
+    const args = [
+        "logs",
+        `--tail=${String(options.tail)}`,
+        ...(options.follow ? ["--follow"] : []),
+        ...(options.service === undefined ? [] : [options.service]),
+    ];
+    const spawnEnv = buildComposeSpawnEnv(installation.execCtx);
+    const dockerArgs = [...composeBaseArgs(installation.execCtx), ...args];
+    if (options.follow) {
+        const { exitCode } = await spawnStreamingCommand("docker", dockerArgs, spawnEnv);
+        return exitCode === 0 ? 0 : 1;
+    }
+    const result = runComposeCommand(installation.execCtx, args, {
+        timeoutMs: COMPOSE_LOGS_TIMEOUT_MS,
+        processEnv: spawnEnv,
+        spawn: (executable, spawnArgs, timeoutMs, processEnv) => {
+            const output = defaultProbeSpawn(executable, spawnArgs, timeoutMs, processEnv);
+            if (output.stdout.length > 0) {
+                process.stdout.write(redactSecrets(output.stdout));
+                if (!output.stdout.endsWith("\n")) {
+                    process.stdout.write("\n");
+                }
+            }
+            if (output.stderr.length > 0) {
+                process.stderr.write(redactSecrets(output.stderr));
+                if (!output.stderr.endsWith("\n")) {
+                    process.stderr.write("\n");
+                }
+            }
+            return output;
+        },
+    });
+    if (result.status !== 0) {
+        throw new PlatformCommandError("compose_failed", redactSecrets(result.stderr.trim() ||
+            result.stdout.trim() ||
+            "Failed to read service logs."));
+    }
+    return 0;
+}
+//# sourceMappingURL=logs.js.map

package/dist/platform/logs.js.map

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

package/dist/platform/readiness.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedInstallation } from "./types.js";
+export interface ReadinessSnapshot {
+    readonly apiHealthOk: boolean;
+    readonly apiReadyOk: boolean;
+    readonly consoleReady: boolean;
+    readonly apiReadyDetail: string | undefined;
+}
+export declare function probeInstallationReadiness(installation: ResolvedInstallation, fetchImpl?: typeof fetch, probeTimeoutMs?: number): Promise<ReadinessSnapshot>;
+//# sourceMappingURL=readiness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../src/platform/readiness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,oBAAoB,EAClC,SAAS,GAAE,OAAO,KAAa,EAC/B,cAAc,GAAE,MAAiC,GAChD,OAAO,CAAC,iBAAiB,CAAC,CAiC5B"}

package/dist/platform/readiness.js

@@ -0,0 +1,58 @@
+import { createFetchProbeTransport } from "../doctor/http-probe.js";
+import { DEFAULT_PROBE_TIMEOUT_MS } from "../doctor/run-doctor.js";
+export async function probeInstallationReadiness(installation, fetchImpl = fetch, probeTimeoutMs = DEFAULT_PROBE_TIMEOUT_MS) {
+    const transport = createFetchProbeTransport(fetchImpl, probeTimeoutMs);
+    const health = await transport.getJson(`${installation.webUrl}/health`);
+    const apiHealthOk = health.kind === "ok" &&
+        health.status === 200 &&
+        isHealthOkBody(health.body);
+    let apiReadyOk = false;
+    let apiReadyDetail;
+    const ready = await transport.getJson(`${installation.webUrl}/ready`);
+    if (ready.kind === "ok" && ready.status === 200) {
+        apiReadyOk = true;
+    }
+    else if (ready.kind === "ok" && ready.status === 503) {
+        apiReadyDetail = readyFailureDetail(ready.body);
+        apiReadyOk = false;
+    }
+    else if (ready.kind === "ok") {
+        apiReadyDetail = `HTTP ${String(ready.status)}`;
+    }
+    else {
+        apiReadyDetail = ready.kind === "timeout" ? "timed out" : "transport error";
+    }
+    let consoleReady = false;
+    try {
+        const response = await fetchImpl(`${installation.consoleUrl}/`, {
+            signal: AbortSignal.timeout(probeTimeoutMs),
+        });
+        consoleReady = response.ok;
+    }
+    catch {
+        consoleReady = false;
+    }
+    return { apiHealthOk, apiReadyOk, consoleReady, apiReadyDetail };
+}
+function isHealthOkBody(body) {
+    return (typeof body === "object" &&
+        body !== null &&
+        "status" in body &&
+        body.status === "ok");
+}
+function readyFailureDetail(body) {
+    if (typeof body !== "object" || body === null) {
+        return undefined;
+    }
+    const failed = body.failedDependency;
+    if (typeof failed === "string" && failed.length > 0) {
+        return failed;
+    }
+    const failedMany = body
+        .failedDependencies;
+    if (Array.isArray(failedMany) && failedMany.length > 0) {
+        return failedMany.map(String).join(", ");
+    }
+    return undefined;
+}
+//# sourceMappingURL=readiness.js.map

package/dist/platform/readiness.js.map

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

package/dist/platform/resolve-installation.d.ts

@@ -0,0 +1,5 @@
+import { type InstallEnvValues } from "../setup/env-file.js";
+import { type ResolvedInstallation } from "./types.js";
+export declare function resolveInstallationForLifecycle(flags: Readonly<Record<string, string | boolean>>, processEnv?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): Promise<ResolvedInstallation>;
+export declare function installEnvValuesFromMap(envMap: Map<string, string>): InstallEnvValues;
+//# sourceMappingURL=resolve-installation.d.ts.map

package/dist/platform/resolve-installation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-installation.d.ts","sourceRoot":"","sources":["../../src/platform/resolve-installation.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE7E,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EACjD,UAAU,GAAE,MAAM,CAAC,UAAwB,EAC3C,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAAC,oBAAoB,CAAC,CA6E/B;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,gBAAgB,CAkBlB"}

package/dist/platform/resolve-installation.js

@@ -0,0 +1,115 @@
+import { access } from "node:fs/promises";
+import path from "node:path";
+import { detectShellEnvConflicts, readInstallEnvFile, INSTALL_ENV_KEYS, } from "../setup/env-file.js";
+import { deriveComposeProjectName } from "../setup/compose-project.js";
+import { assessInstallDirectory, INSTALLATION_MARKER_RELATIVE, } from "../setup/installation-state.js";
+import { resolveInstallDir } from "../setup/install-path.js";
+import { isIncompleteUpgrade, readUpgradeState } from "./upgrade/state.js";
+import { PlatformCommandError } from "./types.js";
+export async function resolveInstallationForLifecycle(flags, processEnv = process.env, platform = process.platform) {
+    const installDir = resolveInstallDir(flags, processEnv, platform);
+    const assessment = await assessInstallDirectory(installDir);
+    if (assessment.kind === "missing") {
+        throw new PlatformCommandError("installation_missing", `No OSVA installation at ${installDir}. Run \`osva setup\` to install first.`);
+    }
+    if (assessment.kind === "empty") {
+        throw new PlatformCommandError("installation_missing", `Installation directory ${installDir} is empty. Run \`osva setup\` to install OSVA.`);
+    }
+    if (assessment.kind === "foreign") {
+        throw new PlatformCommandError("installation_invalid", `Directory ${installDir} is not an OSVA installation (unrelated files: ${assessment.foreignEntries.join(", ")}).`);
+    }
+    if (assessment.marker === undefined) {
+        throw new PlatformCommandError("installation_invalid", `Missing or invalid installation marker at ${path.join(installDir, INSTALLATION_MARKER_RELATIVE)}.`);
+    }
+    const composePath = path.join(installDir, "compose.yml");
+    const envPath = path.join(installDir, ".env");
+    await assertReadableFile(composePath, "compose.yml");
+    await assertReadableFile(envPath, ".env");
+    const marker = assessment.marker;
+    validateMarkerPaths(installDir, marker);
+    const envMap = await readInstallEnvFile(envPath);
+    if (envMap === undefined) {
+        throw new PlatformCommandError("installation_invalid", `Could not read installation environment at ${envPath}.`);
+    }
+    const envValues = installEnvValuesFromMap(envMap);
+    await validateMarkerMetadata(marker, installDir, envValues);
+    const conflicts = detectShellEnvConflicts(envValues, processEnv);
+    if (conflicts.length > 0) {
+        const keys = conflicts.map((conflict) => conflict.key).join(", ");
+        throw new PlatformCommandError("env_conflict", `Host environment variables override installation secrets and differ from .env: ${keys}. Unset them or align values before continuing.`);
+    }
+    const execCtx = {
+        installDir,
+        envFilePath: envPath,
+        projectName: envValues.COMPOSE_PROJECT_NAME,
+    };
+    const webPort = Number(envValues.OSVA_PUBLISH_WEB_PORT);
+    const mcpPort = Number(envValues.OSVA_PUBLISH_MCP_PORT);
+    const consolePort = Number(envValues.OSVA_PUBLISH_CONSOLE_PORT);
+    return {
+        installDir,
+        marker,
+        envValues,
+        envPath,
+        composePath,
+        execCtx,
+        webUrl: `http://127.0.0.1:${String(webPort)}`,
+        mcpUrl: `http://127.0.0.1:${String(mcpPort)}`,
+        consoleUrl: `http://127.0.0.1:${String(consolePort)}`,
+    };
+}
+export function installEnvValuesFromMap(envMap) {
+    const values = {};
+    const missing = [];
+    for (const key of INSTALL_ENV_KEYS) {
+        const raw = envMap.get(key)?.trim();
+        if (raw === undefined || raw.length === 0) {
+            missing.push(key);
+            continue;
+        }
+        values[key] = raw;
+    }
+    if (missing.length > 0) {
+        throw new PlatformCommandError("installation_invalid", `Installation .env is missing required keys: ${missing.join(", ")}.`);
+    }
+    return values;
+}
+function validateMarkerPaths(installDir, marker) {
+    const normalizedInstallDir = normalizePath(installDir);
+    const normalizedMarkerDir = normalizePath(marker.installDir);
+    if (normalizedInstallDir !== normalizedMarkerDir &&
+        !pathsEquivalent(normalizedInstallDir, normalizedMarkerDir)) {
+        throw new PlatformCommandError("installation_invalid", `Installation marker installDir (${marker.installDir}) does not match the requested directory (${installDir}). Use --install-dir ${marker.installDir} or repair ${INSTALLATION_MARKER_RELATIVE}.`);
+    }
+}
+async function validateMarkerMetadata(marker, installDir, envValues) {
+    const expectedProject = deriveComposeProjectName(installDir);
+    if (envValues.COMPOSE_PROJECT_NAME !== marker.composeProjectName) {
+        throw new PlatformCommandError("installation_invalid", `Compose project name in .env (${envValues.COMPOSE_PROJECT_NAME}) does not match installation marker (${marker.composeProjectName}).`);
+    }
+    if (expectedProject !== marker.composeProjectName) {
+        throw new PlatformCommandError("installation_invalid", `Installation marker project name (${marker.composeProjectName}) does not match this install directory (expected ${expectedProject}). Repair ${INSTALLATION_MARKER_RELATIVE} or use the correct --install-dir.`);
+    }
+    if (envValues.OSVA_IMAGE !== marker.imageRef) {
+        const upgradeState = await readUpgradeState(installDir);
+        if (upgradeState !== undefined && isIncompleteUpgrade(upgradeState)) {
+            return;
+        }
+        throw new PlatformCommandError("installation_invalid", `Installed image in .env (${envValues.OSVA_IMAGE}) does not match installation marker (${marker.imageRef}). Repair metadata or run \`osva platform upgrade --dry-run\`.`);
+    }
+}
+function normalizePath(value) {
+    return path.resolve(value).replace(/\\/g, "/").toLowerCase();
+}
+function pathsEquivalent(left, right) {
+    return (left === right || left.endsWith(`/${right}`) || right.endsWith(`/${left}`));
+}
+async function assertReadableFile(filePath, label) {
+    try {
+        await access(filePath);
+    }
+    catch {
+        throw new PlatformCommandError("installation_invalid", `Installation is missing ${label} at ${filePath}.`);
+    }
+}
+//# sourceMappingURL=resolve-installation.js.map

package/dist/platform/resolve-installation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-installation.js","sourceRoot":"","sources":["../../src/platform/resolve-installation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAGlB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAE7B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAA6B,MAAM,YAAY,CAAC;AAE7E,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,KAAiD,EACjD,aAAgC,OAAO,CAAC,GAAG,EAC3C,WAA4B,OAAO,CAAC,QAAQ;IAE5C,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE5D,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,2BAA2B,UAAU,wCAAwC,CAC9E,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAChC,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,0BAA0B,UAAU,gDAAgD,CACrF,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,aAAa,UAAU,kDAAkD,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAClH,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,6CAA6C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,4BAA4B,CAAC,GAAG,CACpG,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,kBAAkB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACrD,MAAM,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IACjC,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAExC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,8CAA8C,OAAO,GAAG,CACzD,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAE5D,MAAM,SAAS,GAAG,uBAAuB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACjE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClE,MAAM,IAAI,oBAAoB,CAC5B,cAAc,EACd,kFAAkF,IAAI,iDAAiD,CACxI,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAuB;QAClC,UAAU;QACV,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,SAAS,CAAC,oBAAoB;KAC5C,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;IAEhE,OAAO;QACL,UAAU;QACV,MAAM;QACN,SAAS;QACT,OAAO;QACP,WAAW;QACX,OAAO;QACP,MAAM,EAAE,oBAAoB,MAAM,CAAC,OAAO,CAAC,EAAE;QAC7C,MAAM,EAAE,oBAAoB,MAAM,CAAC,OAAO,CAAC,EAAE;QAC7C,UAAU,EAAE,oBAAoB,MAAM,CAAC,WAAW,CAAC,EAAE;KACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,MAA2B;IAE3B,MAAM,MAAM,GAAG,EAAsB,CAAC;IACtC,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;QACpC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,+CAA+C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAC1B,UAAkB,EAClB,MAA0B;IAE1B,MAAM,oBAAoB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACvD,MAAM,mBAAmB,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7D,IACE,oBAAoB,KAAK,mBAAmB;QAC5C,CAAC,eAAe,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,EAC3D,CAAC;QACD,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,mCAAmC,MAAM,CAAC,UAAU,6CAA6C,UAAU,wBAAwB,MAAM,CAAC,UAAU,cAAc,4BAA4B,GAAG,CAClM,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,MAA0B,EAC1B,UAAkB,EAClB,SAA2B;IAE3B,MAAM,eAAe,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC;IAC7D,IAAI,SAAS,CAAC,oBAAoB,KAAK,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACjE,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,iCAAiC,SAAS,CAAC,oBAAoB,yCAAyC,MAAM,CAAC,kBAAkB,IAAI,CACtI,CAAC;IACJ,CAAC;IACD,IAAI,eAAe,KAAK,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAClD,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,qCAAqC,MAAM,CAAC,kBAAkB,qDAAqD,eAAe,aAAa,4BAA4B,oCAAoC,CAChN,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,UAAU,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7C,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,YAAY,KAAK,SAAS,IAAI,mBAAmB,CAAC,YAAY,CAAC,EAAE,CAAC;YACpE,OAAO;QACT,CAAC;QACD,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,4BAA4B,SAAS,CAAC,UAAU,yCAAyC,MAAM,CAAC,QAAQ,gEAAgE,CACzK,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AAC/D,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,KAAa;IAClD,OAAO,CACL,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,QAAgB,EAChB,KAAa;IAEb,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,2BAA2B,KAAK,OAAO,QAAQ,GAAG,CACnD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/platform/services.d.ts

@@ -0,0 +1,7 @@
+/** Long-running OSVA application services (excludes one-shot migrate/bootstrap jobs). */
+export declare const PLATFORM_APPLICATION_SERVICES: readonly ["web", "worker", "scheduler", "workflow-orchestrator", "knowledge-worker", "mcp-server", "console"];
+export declare const PLATFORM_DATA_SERVICES: readonly ["postgres", "valkey"];
+export declare const PLATFORM_LIFECYCLE_SERVICES: readonly ["postgres", "valkey", "web", "worker", "scheduler", "workflow-orchestrator", "knowledge-worker", "mcp-server", "console"];
+export type PlatformServiceName = (typeof PLATFORM_DATA_SERVICES)[number] | (typeof PLATFORM_APPLICATION_SERVICES)[number] | "migrate";
+export declare const KNOWN_COMPOSE_SERVICES: readonly PlatformServiceName[];
+//# sourceMappingURL=services.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/platform/services.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,eAAO,MAAM,6BAA6B,+GAQhC,CAAC;AAEX,eAAO,MAAM,sBAAsB,iCAAkC,CAAC;AAEtE,eAAO,MAAM,2BAA2B,qIAG9B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC3B,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,GACvC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,GAC9C,SAAS,CAAC;AAEd,eAAO,MAAM,sBAAsB,EAAE,SAAS,mBAAmB,EAIhE,CAAC"}

package/dist/platform/services.js

@@ -0,0 +1,21 @@
+/** Long-running OSVA application services (excludes one-shot migrate/bootstrap jobs). */
+export const PLATFORM_APPLICATION_SERVICES = [
+    "web",
+    "worker",
+    "scheduler",
+    "workflow-orchestrator",
+    "knowledge-worker",
+    "mcp-server",
+    "console",
+];
+export const PLATFORM_DATA_SERVICES = ["postgres", "valkey"];
+export const PLATFORM_LIFECYCLE_SERVICES = [
+    ...PLATFORM_DATA_SERVICES,
+    ...PLATFORM_APPLICATION_SERVICES,
+];
+export const KNOWN_COMPOSE_SERVICES = [
+    ...PLATFORM_DATA_SERVICES,
+    "migrate",
+    ...PLATFORM_APPLICATION_SERVICES,
+];
+//# sourceMappingURL=services.js.map

package/dist/platform/services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.js","sourceRoot":"","sources":["../../src/platform/services.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,KAAK;IACL,QAAQ;IACR,WAAW;IACX,uBAAuB;IACvB,kBAAkB;IAClB,YAAY;IACZ,SAAS;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAU,CAAC;AAEtE,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,GAAG,sBAAsB;IACzB,GAAG,6BAA6B;CACxB,CAAC;AAOX,MAAM,CAAC,MAAM,sBAAsB,GAAmC;IACpE,GAAG,sBAAsB;IACzB,SAAS;IACT,GAAG,6BAA6B;CACjC,CAAC"}

package/dist/platform/status.d.ts

@@ -0,0 +1,7 @@
+import type { ProbeSpawnFn } from "../setup/probe-spawn.js";
+import type { PlatformStatusReport, ResolvedInstallation } from "./types.js";
+export declare function collectPlatformStatus(installation: ResolvedInstallation, deps?: {
+    readonly fetch?: typeof fetch;
+    readonly spawn?: ProbeSpawnFn;
+}): Promise<PlatformStatusReport>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/platform/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAQ5D,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAEpB,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,oBAAoB,EAClC,IAAI,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAO,GAC1E,OAAO,CAAC,oBAAoB,CAAC,CAmE/B"}

package/dist/platform/status.js

@@ -0,0 +1,60 @@
+import { inspectComposeServices, migrateJobCompleted, } from "./compose-inspect.js";
+import { probeInstallationReadiness } from "./readiness.js";
+import { KNOWN_COMPOSE_SERVICES } from "./services.js";
+import { isIncompleteUpgrade, readUpgradeState } from "./upgrade/state.js";
+export async function collectPlatformStatus(installation, deps = {}) {
+    const upgradeState = await readUpgradeState(installation.installDir);
+    const services = inspectComposeServices(installation.execCtx, deps.spawn);
+    const readiness = await probeInstallationReadiness(installation, deps.fetch ?? fetch);
+    const problems = [];
+    if (isIncompleteUpgrade(upgradeState)) {
+        problems.push(`Platform upgrade state: ${upgradeState.phase}${upgradeState.lastError === undefined ? "" : ` (${upgradeState.lastError})`}.`);
+    }
+    for (const expected of KNOWN_COMPOSE_SERVICES) {
+        if (!services.some((service) => service.name === expected)) {
+            problems.push(`Missing Compose service record for '${expected}'.`);
+        }
+    }
+    const migrateCompleted = migrateJobCompleted(services);
+    if (migrateCompleted === false) {
+        problems.push("Database migration job has not completed successfully; platform applications may fail to start.");
+    }
+    for (const service of services) {
+        if (service.state === "unhealthy" ||
+            (service.state === "running" &&
+                service.name !== "migrate" &&
+                service.statusText.toLowerCase().includes("health") &&
+                !service.statusText.toLowerCase().includes("healthy"))) {
+            problems.push(`Service '${service.name}' is unhealthy (${service.statusText}).`);
+        }
+    }
+    if (!readiness.apiHealthOk) {
+        problems.push("Control plane /health is not OK.");
+    }
+    if (!readiness.apiReadyOk) {
+        const detail = readiness.apiReadyDetail === undefined
+            ? ""
+            : `: ${readiness.apiReadyDetail}`;
+        problems.push(`Control plane /ready is not OK${detail}.`);
+    }
+    if (!readiness.consoleReady) {
+        problems.push(`Console is not reachable at ${installation.consoleUrl}.`);
+    }
+    const platformReady = readiness.apiReadyOk && !hasUnhealthyCore(services);
+    return {
+        installation,
+        services,
+        platformReady,
+        consoleReady: readiness.consoleReady,
+        apiHealthOk: readiness.apiHealthOk,
+        apiReadyOk: readiness.apiReadyOk,
+        problems,
+        upgradeState,
+    };
+}
+function hasUnhealthyCore(services) {
+    const core = new Set(["postgres", "valkey", "web", "worker"]);
+    return services.some((service) => core.has(service.name) &&
+        (service.state === "unhealthy" || service.state === "stopped"));
+}
+//# sourceMappingURL=status.js.map

package/dist/platform/status.js.map

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

package/dist/platform/types.d.ts

@@ -0,0 +1,37 @@
+import type { InstallationMarker } from "../setup/installation-state.js";
+import type { UpgradeState } from "./upgrade/state.js";
+import type { InstallEnvValues } from "../setup/env-file.js";
+import type { ComposeExecContext } from "../setup/compose-exec.js";
+export type ServiceRuntimeState = "stopped" | "starting" | "running" | "healthy" | "unhealthy" | "unknown";
+export interface ComposeServiceSnapshot {
+    readonly name: string;
+    readonly state: ServiceRuntimeState;
+    readonly statusText: string;
+    readonly health: string | undefined;
+}
+export interface ResolvedInstallation {
+    readonly installDir: string;
+    readonly marker: InstallationMarker;
+    readonly envValues: InstallEnvValues;
+    readonly envPath: string;
+    readonly composePath: string;
+    readonly execCtx: ComposeExecContext;
+    readonly webUrl: string;
+    readonly mcpUrl: string;
+    readonly consoleUrl: string;
+}
+export interface PlatformStatusReport {
+    readonly installation: ResolvedInstallation;
+    readonly services: readonly ComposeServiceSnapshot[];
+    readonly platformReady: boolean;
+    readonly consoleReady: boolean;
+    readonly apiHealthOk: boolean;
+    readonly apiReadyOk: boolean;
+    readonly problems: readonly string[];
+    readonly upgradeState: UpgradeState | undefined;
+}
+export declare class PlatformCommandError extends Error {
+    readonly code: "usage" | "installation_missing" | "installation_invalid" | "env_conflict" | "docker_unavailable" | "compose_failed" | "platform_not_ready";
+    constructor(code: PlatformCommandError["code"], message: string);
+}
+//# sourceMappingURL=types.d.ts.map