@treeseed/sdk 0.6.44 → 0.6.46

package/dist/operations/services/project-platform.d.ts

@@ -139,119 +139,7 @@ export declare function deployProjectPlatform(options: ProjectPlatformActionOpti
             };
             railwayResources: {
                 ok: boolean;
-                checks: ({
-                    type: string;
-                    service: string;
-                    serviceName: string;
-                    projectName: string;
-                    environment: string;
-                    ok: boolean;
-                    status: string;
-                    message: string;
-                    serviceId?: undefined;
-                    projectId?: undefined;
-                    environmentId?: undefined;
-                    instanceId?: undefined;
-                    observed?: undefined;
-                    volumeName?: undefined;
-                    mountPath?: undefined;
-                } | {
-                    type: string;
-                    service: string;
-                    serviceName: string;
-                    serviceId: string;
-                    projectId: string;
-                    environment: string;
-                    environmentId: string;
-                    instanceId: string | null;
-                    ok: boolean;
-                    status: string;
-                    observed: {
-                        rootDirectory: string | null;
-                        startCommand: string | null;
-                        cronSchedule: string | null;
-                        sleepApplication: boolean | null;
-                        runtimeMode: string | null;
-                        id?: undefined;
-                        name?: undefined;
-                        instances?: undefined;
-                    } | null;
-                    message: string | undefined;
-                    projectName?: undefined;
-                    volumeName?: undefined;
-                    mountPath?: undefined;
-                } | {
-                    type: string;
-                    service: string;
-                    serviceName: string;
-                    serviceId: string;
-                    projectId: string;
-                    environment: string;
-                    environmentId: string;
-                    volumeName: string;
-                    mountPath: string;
-                    ok: boolean;
-                    status: string;
-                    observed: {
-                        id: string;
-                        name: string;
-                        instances: import("./railway-api.ts").RailwayVolumeInstanceSummary[];
-                        rootDirectory?: undefined;
-                        startCommand?: undefined;
-                        cronSchedule?: undefined;
-                        sleepApplication?: undefined;
-                        runtimeMode?: undefined;
-                    } | null;
-                    message: string | undefined;
-                    projectName?: undefined;
-                    instanceId?: undefined;
-                } | {
-                    id: null;
-                    ok: boolean;
-                    status: string;
-                    message: string;
-                    service: string;
-                    projectId: string | null;
-                    projectName: string;
-                    serviceId: string | null;
-                    serviceName: string;
-                    environment: string;
-                    environmentId: string | null;
-                    expression: string;
-                    command: string | null;
-                    enabled: boolean;
-                    logicalName: string;
-                    type: string;
-                    instanceId?: undefined;
-                    observed?: undefined;
-                    volumeName?: undefined;
-                    mountPath?: undefined;
-                } | {
-                    id: string | null;
-                    projectId: string;
-                    serviceId: string;
-                    environmentId: string;
-                    ok: boolean;
-                    status: string;
-                    observed: {
-                        expression: string | null;
-                        command: string | null;
-                        enabled: boolean;
-                    } | null;
-                    message: string | undefined;
-                    service: string;
-                    projectName: string;
-                    serviceName: string;
-                    environment: string;
-                    expression: string;
-                    command: string | null;
-                    enabled: boolean;
-                    logicalName: string;
-                    type: string;
-                    instanceId?: undefined;
-                    volumeName?: undefined;
-                    mountPath?: undefined;
-                })[];
+                checks: any[];
             } | {
                 ok: boolean;
                 skipped: boolean;
@@ -437,119 +325,7 @@ export declare function monitorProjectPlatform(options: ProjectPlatformActionOpt
         };
         railwayResources: {
             ok: boolean;
-            checks: ({
-                type: string;
-                service: string;
-                serviceName: string;
-                projectName: string;
-                environment: string;
-                ok: boolean;
-                status: string;
-                message: string;
-                serviceId?: undefined;
-                projectId?: undefined;
-                environmentId?: undefined;
-                instanceId?: undefined;
-                observed?: undefined;
-                volumeName?: undefined;
-                mountPath?: undefined;
-            } | {
-                type: string;
-                service: string;
-                serviceName: string;
-                serviceId: string;
-                projectId: string;
-                environment: string;
-                environmentId: string;
-                instanceId: string | null;
-                ok: boolean;
-                status: string;
-                observed: {
-                    rootDirectory: string | null;
-                    startCommand: string | null;
-                    cronSchedule: string | null;
-                    sleepApplication: boolean | null;
-                    runtimeMode: string | null;
-                    id?: undefined;
-                    name?: undefined;
-                    instances?: undefined;
-                } | null;
-                message: string | undefined;
-                projectName?: undefined;
-                volumeName?: undefined;
-                mountPath?: undefined;
-            } | {
-                type: string;
-                service: string;
-                serviceName: string;
-                serviceId: string;
-                projectId: string;
-                environment: string;
-                environmentId: string;
-                volumeName: string;
-                mountPath: string;
-                ok: boolean;
-                status: string;
-                observed: {
-                    id: string;
-                    name: string;
-                    instances: import("./railway-api.ts").RailwayVolumeInstanceSummary[];
-                    rootDirectory?: undefined;
-                    startCommand?: undefined;
-                    cronSchedule?: undefined;
-                    sleepApplication?: undefined;
-                    runtimeMode?: undefined;
-                } | null;
-                message: string | undefined;
-                projectName?: undefined;
-                instanceId?: undefined;
-            } | {
-                id: null;
-                ok: boolean;
-                status: string;
-                message: string;
-                service: string;
-                projectId: string | null;
-                projectName: string;
-                serviceId: string | null;
-                serviceName: string;
-                environment: string;
-                environmentId: string | null;
-                expression: string;
-                command: string | null;
-                enabled: boolean;
-                logicalName: string;
-                type: string;
-                instanceId?: undefined;
-                observed?: undefined;
-                volumeName?: undefined;
-                mountPath?: undefined;
-            } | {
-                id: string | null;
-                projectId: string;
-                serviceId: string;
-                environmentId: string;
-                ok: boolean;
-                status: string;
-                observed: {
-                    expression: string | null;
-                    command: string | null;
-                    enabled: boolean;
-                } | null;
-                message: string | undefined;
-                service: string;
-                projectName: string;
-                serviceName: string;
-                environment: string;
-                expression: string;
-                command: string | null;
-                enabled: boolean;
-                logicalName: string;
-                type: string;
-                instanceId?: undefined;
-                volumeName?: undefined;
-                mountPath?: undefined;
-            })[];
+            checks: any[];
         } | {
             ok: boolean;
             skipped: boolean;
@@ -740,119 +516,7 @@ export declare function runProjectPlatformAction(action: ProjectPlatformAction,
         };
         railwayResources: {
             ok: boolean;
-            checks: ({
-                type: string;
-                service: string;
-                serviceName: string;
-                projectName: string;
-                environment: string;
-                ok: boolean;
-                status: string;
-                message: string;
-                serviceId?: undefined;
-                projectId?: undefined;
-                environmentId?: undefined;
-                instanceId?: undefined;
-                observed?: undefined;
-                volumeName?: undefined;
-                mountPath?: undefined;
-            } | {
-                type: string;
-                service: string;
-                serviceName: string;
-                serviceId: string;
-                projectId: string;
-                environment: string;
-                environmentId: string;
-                instanceId: string | null;
-                ok: boolean;
-                status: string;
-                observed: {
-                    rootDirectory: string | null;
-                    startCommand: string | null;
-                    cronSchedule: string | null;
-                    sleepApplication: boolean | null;
-                    runtimeMode: string | null;
-                    id?: undefined;
-                    name?: undefined;
-                    instances?: undefined;
-                } | null;
-                message: string | undefined;
-                projectName?: undefined;
-                volumeName?: undefined;
-                mountPath?: undefined;
-            } | {
-                type: string;
-                service: string;
-                serviceName: string;
-                serviceId: string;
-                projectId: string;
-                environment: string;
-                environmentId: string;
-                volumeName: string;
-                mountPath: string;
-                ok: boolean;
-                status: string;
-                observed: {
-                    id: string;
-                    name: string;
-                    instances: import("./railway-api.ts").RailwayVolumeInstanceSummary[];
-                    rootDirectory?: undefined;
-                    startCommand?: undefined;
-                    cronSchedule?: undefined;
-                    sleepApplication?: undefined;
-                    runtimeMode?: undefined;
-                } | null;
-                message: string | undefined;
-                projectName?: undefined;
-                instanceId?: undefined;
-            } | {
-                id: null;
-                ok: boolean;
-                status: string;
-                message: string;
-                service: string;
-                projectId: string | null;
-                projectName: string;
-                serviceId: string | null;
-                serviceName: string;
-                environment: string;
-                environmentId: string | null;
-                expression: string;
-                command: string | null;
-                enabled: boolean;
-                logicalName: string;
-                type: string;
-                instanceId?: undefined;
-                observed?: undefined;
-                volumeName?: undefined;
-                mountPath?: undefined;
-            } | {
-                id: string | null;
-                projectId: string;
-                serviceId: string;
-                environmentId: string;
-                ok: boolean;
-                status: string;
-                observed: {
-                    expression: string | null;
-                    command: string | null;
-                    enabled: boolean;
-                } | null;
-                message: string | undefined;
-                service: string;
-                projectName: string;
-                serviceName: string;
-                environment: string;
-                expression: string;
-                command: string | null;
-                enabled: boolean;
-                logicalName: string;
-                type: string;
-                instanceId?: undefined;
-                volumeName?: undefined;
-                mountPath?: undefined;
-            })[];
+            checks: any[];
         } | {
             ok: boolean;
             skipped: boolean;
@@ -999,119 +663,7 @@ export declare function runProjectPlatformAction(action: ProjectPlatformAction,
             };
             railwayResources: {
                 ok: boolean;
-                checks: ({
-                    type: string;
-                    service: string;
-                    serviceName: string;
-                    projectName: string;
-                    environment: string;
-                    ok: boolean;
-                    status: string;
-                    message: string;
-                    serviceId?: undefined;
-                    projectId?: undefined;
-                    environmentId?: undefined;
-                    instanceId?: undefined;
-                    observed?: undefined;
-                    volumeName?: undefined;
-                    mountPath?: undefined;
-                } | {
-                    type: string;
-                    service: string;
-                    serviceName: string;
-                    serviceId: string;
-                    projectId: string;
-                    environment: string;
-                    environmentId: string;
-                    instanceId: string | null;
-                    ok: boolean;
-                    status: string;
-                    observed: {
-                        rootDirectory: string | null;
-                        startCommand: string | null;
-                        cronSchedule: string | null;
-                        sleepApplication: boolean | null;
-                        runtimeMode: string | null;
-                        id?: undefined;
-                        name?: undefined;
-                        instances?: undefined;
-                    } | null;
-                    message: string | undefined;
-                    projectName?: undefined;
-                    volumeName?: undefined;
-                    mountPath?: undefined;
-                } | {
-                    type: string;
-                    service: string;
-                    serviceName: string;
-                    serviceId: string;
-                    projectId: string;
-                    environment: string;
-                    environmentId: string;
-                    volumeName: string;
-                    mountPath: string;
-                    ok: boolean;
-                    status: string;
-                    observed: {
-                        id: string;
-                        name: string;
-                        instances: import("./railway-api.ts").RailwayVolumeInstanceSummary[];
-                        rootDirectory?: undefined;
-                        startCommand?: undefined;
-                        cronSchedule?: undefined;
-                        sleepApplication?: undefined;
-                        runtimeMode?: undefined;
-                    } | null;
-                    message: string | undefined;
-                    projectName?: undefined;
-                    instanceId?: undefined;
-                } | {
-                    id: null;
-                    ok: boolean;
-                    status: string;
-                    message: string;
-                    service: string;
-                    projectId: string | null;
-                    projectName: string;
-                    serviceId: string | null;
-                    serviceName: string;
-                    environment: string;
-                    environmentId: string | null;
-                    expression: string;
-                    command: string | null;
-                    enabled: boolean;
-                    logicalName: string;
-                    type: string;
-                    instanceId?: undefined;
-                    observed?: undefined;
-                    volumeName?: undefined;
-                    mountPath?: undefined;
-                } | {
-                    id: string | null;
-                    projectId: string;
-                    serviceId: string;
-                    environmentId: string;
-                    ok: boolean;
-                    status: string;
-                    observed: {
-                        expression: string | null;
-                        command: string | null;
-                        enabled: boolean;
-                    } | null;
-                    message: string | undefined;
-                    service: string;
-                    projectName: string;
-                    serviceName: string;
-                    environment: string;
-                    expression: string;
-                    command: string | null;
-                    enabled: boolean;
-                    logicalName: string;
-                    type: string;
-                    instanceId?: undefined;
-                    volumeName?: undefined;
-                    mountPath?: undefined;
-                })[];
+                checks: any[];
             } | {
                 ok: boolean;
                 skipped: boolean;

package/dist/operations/services/project-platform.js

@@ -1230,7 +1230,7 @@ async function monitorProjectPlatform(options) {
     r2: options.dryRun ? { ok: true, skipped: true, reason: "dry_run" } : probeR2(options.tenantRoot, siteConfig, state, target),
     queue: options.dryRun ? Promise.resolve({ ok: true, skipped: true, reason: "dry_run" }) : probeQueue(siteConfig, state),
     scaleProbe: probeScaleConfiguration(siteConfig, state),
-    railwayResources: options.scope === "local" || !apiSelected && !agentsSelected ? Promise.resolve({ ok: true, skipped: true, reason: options.scope === "local" ? "local_scope" : "railway_not_selected" }) : verifyRailwayManagedResources(options.tenantRoot, options.scope, { env }),
+    railwayResources: options.scope === "local" || !apiSelected && !agentsSelected ? Promise.resolve({ ok: true, skipped: true, reason: options.scope === "local" ? "local_scope" : "railway_not_selected" }) : verifyRailwayManagedResources(options.tenantRoot, options.scope, { env, settleDeployments: true }),
     readiness: state.readiness
   };
   const resolvedChecks = {

package/dist/operations/services/railway-deploy.d.ts

@@ -2,6 +2,7 @@ import { type TreeseedBootstrapTaskPrefix, type TreeseedBootstrapWriter } from '
 export declare function deriveRailwayWorkerRunnerServiceName(projectSlug: any, index?: number): string;
 export declare function deriveRailwayWorkerRunnerVolumeName(serviceName: any, environmentName?: string): string;
 export declare function railwayServiceRuntimeStartCommand(service: any): any;
+export declare function collectRailwayDeploymentStatusChecks(statusPayload: any, scope: any, services: any): any;
 export declare function isUsableRailwayToken(value: any): boolean;
 export declare function resolveRailwayAuthToken(env?: NodeJS.ProcessEnv): string;
 export declare function buildRailwayCommandEnv(env?: NodeJS.ProcessEnv): {
@@ -12,6 +13,43 @@ export declare function runRailway(args: any, { cwd, capture, allowFailure, inpu
     capture?: boolean | undefined;
     allowFailure?: boolean | undefined;
 }): import("child_process").SpawnSyncReturns<string>;
+export declare function waitForRailwayManagedDeploymentsSettled(tenantRoot: any, scope: any, { services, env, timeoutMs, pollMs, }?: {
+    services?: ({
+        key: string;
+        scope: string;
+        projectId: string | null;
+        projectName: string;
+        serviceId: string | null;
+        serviceName: string;
+        rootDir: string;
+        publicBaseUrl: string | null;
+        railwayEnvironment: string;
+        buildCommand: string | null;
+        startCommand: string | null;
+        healthcheckPath: any;
+        healthcheckTimeoutSeconds: any;
+        healthcheckIntervalSeconds: any;
+        restartPolicy: any;
+        runtimeMode: any;
+        schedule: string[];
+        hostingKind: string;
+        runnerPool: {
+            bootstrapIndex: number;
+            volumeMountPath: string;
+        } | null;
+    } | null)[] | undefined;
+    env?: NodeJS.ProcessEnv | undefined;
+    timeoutMs?: number | undefined;
+    pollMs?: number | undefined;
+}): Promise<{
+    ok: boolean;
+    checks: any;
+    message?: undefined;
+} | {
+    ok: boolean;
+    checks: any;
+    message: string;
+}>;
 export declare function setRailwaySecretVariable({ cwd, service, environment, key, value, env, capture, allowFailure }: {
     cwd: any;
     service: any;
@@ -281,124 +319,15 @@ export declare function verifyRailwayScheduledJobs(tenantRoot: any, scope: any,
     unsupported?: undefined;
     message?: undefined;
 }>;
-export declare function verifyRailwayManagedResources(tenantRoot: any, scope: any, { fetchImpl, apiToken, apiUrl, env }?: {
+export declare function verifyRailwayManagedResources(tenantRoot: any, scope: any, { fetchImpl, apiToken, apiUrl, env, settleDeployments, settleTimeoutMs, settlePollMs, }?: {
     fetchImpl?: typeof fetch | undefined;
     env?: NodeJS.ProcessEnv | undefined;
+    settleDeployments?: boolean | undefined;
+    settleTimeoutMs?: number | undefined;
+    settlePollMs?: number | undefined;
 }): Promise<{
     ok: boolean;
-    checks: ({
-        type: string;
-        service: string;
-        serviceName: string;
-        projectName: string;
-        environment: string;
-        ok: boolean;
-        status: string;
-        message: string;
-        serviceId?: undefined;
-        projectId?: undefined;
-        environmentId?: undefined;
-        instanceId?: undefined;
-        observed?: undefined;
-        volumeName?: undefined;
-        mountPath?: undefined;
-    } | {
-        type: string;
-        service: string;
-        serviceName: string;
-        serviceId: string;
-        projectId: string;
-        environment: string;
-        environmentId: string;
-        instanceId: string | null;
-        ok: boolean;
-        status: string;
-        observed: {
-            rootDirectory: string | null;
-            startCommand: string | null;
-            cronSchedule: string | null;
-            sleepApplication: boolean | null;
-            runtimeMode: string | null;
-            id?: undefined;
-            name?: undefined;
-            instances?: undefined;
-        } | null;
-        message: string | undefined;
-        projectName?: undefined;
-        volumeName?: undefined;
-        mountPath?: undefined;
-    } | {
-        type: string;
-        service: string;
-        serviceName: string;
-        serviceId: string;
-        projectId: string;
-        environment: string;
-        environmentId: string;
-        volumeName: string;
-        mountPath: string;
-        ok: boolean;
-        status: string;
-        observed: {
-            id: string;
-            name: string;
-            instances: import("./railway-api.ts").RailwayVolumeInstanceSummary[];
-            rootDirectory?: undefined;
-            startCommand?: undefined;
-            cronSchedule?: undefined;
-            sleepApplication?: undefined;
-            runtimeMode?: undefined;
-        } | null;
-        message: string | undefined;
-        projectName?: undefined;
-        instanceId?: undefined;
-    } | {
-        id: null;
-        ok: boolean;
-        status: string;
-        message: string;
-        service: string;
-        projectId: string | null;
-        projectName: string;
-        serviceId: string | null;
-        serviceName: string;
-        environment: string;
-        environmentId: string | null;
-        expression: string;
-        command: string | null;
-        enabled: boolean;
-        logicalName: string;
-        type: string;
-        instanceId?: undefined;
-        observed?: undefined;
-        volumeName?: undefined;
-        mountPath?: undefined;
-    } | {
-        id: string | null;
-        projectId: string;
-        serviceId: string;
-        environmentId: string;
-        ok: boolean;
-        status: string;
-        observed: {
-            expression: string | null;
-            command: string | null;
-            enabled: boolean;
-        } | null;
-        message: string | undefined;
-        service: string;
-        projectName: string;
-        serviceName: string;
-        environment: string;
-        expression: string;
-        command: string | null;
-        enabled: boolean;
-        logicalName: string;
-        type: string;
-        instanceId?: undefined;
-        volumeName?: undefined;
-        mountPath?: undefined;
-    })[];
+    checks: any[];
 }>;
 export declare function planRailwayServiceDeploy(service: any, { env }?: {
     env?: NodeJS.ProcessEnv | undefined;

package/dist/operations/services/railway-deploy.js

@@ -95,6 +95,74 @@ function parseRailwayJsonOutput(output) {
   }
   return null;
 }
+function railwayEdgeNodes(value) {
+  return Array.isArray(value?.edges) ? value.edges.map((entry) => entry?.node).filter(Boolean) : [];
+}
+function railwayStatusEnvironmentNodes(payload) {
+  if (!payload || typeof payload !== "object") {
+    return [];
+  }
+  if (Array.isArray(payload.environments)) {
+    return payload.environments;
+  }
+  return railwayEdgeNodes(payload.environments);
+}
+function railwayStatusDeploymentSettled(status) {
+  const normalized = String(status ?? "").trim().toUpperCase();
+  return normalized === "SUCCESS" || normalized === "SLEEPING";
+}
+function collectRailwayDeploymentStatusChecks(statusPayload, scope, services) {
+  const expectedEnvironment = resolveRailwayEnvironmentForScope(scope);
+  const environments = railwayStatusEnvironmentNodes(statusPayload);
+  const environment = environments.find(
+    (candidate) => normalizeRailwayEnvironmentName(candidate?.name) === expectedEnvironment
+  ) ?? null;
+  if (!environment) {
+    return services.map((service) => ({
+      type: "deployment-status",
+      service: service.key,
+      serviceName: service.serviceName,
+      environment: expectedEnvironment,
+      ok: false,
+      status: "missing_environment",
+      message: `Railway status did not include the ${expectedEnvironment} environment.`
+    }));
+  }
+  const instances = railwayEdgeNodes(environment.serviceInstances);
+  return services.map((service) => {
+    const instance = instances.find((candidate) => candidate?.serviceName === service.serviceName) ?? null;
+    if (!instance) {
+      return {
+        type: "deployment-status",
+        service: service.key,
+        serviceName: service.serviceName,
+        environment: expectedEnvironment,
+        ok: false,
+        status: "missing_service_instance",
+        message: `Railway status did not include service ${service.serviceName} in ${expectedEnvironment}.`
+      };
+    }
+    const deployment = instance.latestDeployment ?? null;
+    const status = String(deployment?.status ?? "").trim().toUpperCase();
+    const instanceStatuses = Array.isArray(deployment?.instances) ? deployment.instances.map((entry) => String(entry?.status ?? "").trim()).filter(Boolean) : [];
+    const ok = railwayStatusDeploymentSettled(status);
+    return {
+      type: "deployment-status",
+      service: service.key,
+      serviceName: service.serviceName,
+      environment: normalizeRailwayEnvironmentName(environment.name),
+      ok,
+      status: status || "missing_deployment",
+      observed: {
+        status: status || null,
+        deploymentStopped: deployment?.deploymentStopped ?? null,
+        instanceStatuses,
+        volumeMounts: Array.isArray(deployment?.meta?.volumeMounts) ? deployment.meta.volumeMounts : []
+      },
+      message: ok ? void 0 : `Railway deployment for ${service.serviceName} is not settled yet; observed ${status || "missing deployment status"}.`
+    };
+  });
+}
 function normalizeRailwayCliVolume(value, { serviceId, environmentId, fallbackName, fallbackMountPath }) {
   if (!value || typeof value !== "object") {
     return null;
@@ -321,6 +389,60 @@ function runRailway(args, { cwd, capture = false, allowFailure = false, input, e
   }
   return result;
 }
+async function waitForRailwayManagedDeploymentsSettled(tenantRoot, scope, {
+  services = configuredRailwayServices(tenantRoot, scope),
+  env = process.env,
+  timeoutMs = 18e4,
+  pollMs = 15e3
+} = {}) {
+  const deadline = Date.now() + timeoutMs;
+  const environment = resolveRailwayEnvironmentForScope(scope);
+  const projectId = services.find((service) => typeof service.projectId === "string" && service.projectId.trim())?.projectId ?? null;
+  if (projectId) {
+    runRailway(["link", "--project", projectId, "--environment", environment, "--json"], {
+      cwd: tenantRoot,
+      capture: true,
+      allowFailure: true,
+      env
+    });
+  }
+  let checks = [];
+  let lastError = null;
+  for (; ; ) {
+    try {
+      const result = runRailway(["status", "--json"], {
+        cwd: tenantRoot,
+        capture: true,
+        env
+      });
+      const payload = parseRailwayJsonOutput(result.stdout);
+      checks = collectRailwayDeploymentStatusChecks(payload, scope, services);
+      lastError = null;
+      if (checks.every((entry) => entry.ok === true)) {
+        return { ok: true, checks };
+      }
+    } catch (error) {
+      lastError = error;
+      checks = services.map((service) => ({
+        type: "deployment-status",
+        service: service.key,
+        serviceName: service.serviceName,
+        environment,
+        ok: false,
+        status: "status_error",
+        message: error instanceof Error ? error.message : String(error)
+      }));
+    }
+    if (Date.now() >= deadline) {
+      return {
+        ok: false,
+        checks,
+        message: lastError instanceof Error ? lastError.message : "Railway deployments did not settle before the monitor timeout."
+      };
+    }
+    await sleep(pollMs);
+  }
+}
 function setRailwaySecretVariable({ cwd, service, environment, key, value, env = process.env, capture = false, allowFailure = false }) {
   const effectiveEnv = buildRailwayCommandEnv({
     ...process.env,
@@ -842,12 +964,21 @@ async function verifyRailwayScheduledJobs(tenantRoot, scope, { fetchImpl = fetch
     checks
   };
 }
-async function verifyRailwayManagedResources(tenantRoot, scope, { fetchImpl = fetch, apiToken, apiUrl, env = process.env } = {}) {
+async function verifyRailwayManagedResources(tenantRoot, scope, {
+  fetchImpl = fetch,
+  apiToken,
+  apiUrl,
+  env = process.env,
+  settleDeployments = false,
+  settleTimeoutMs = 18e4,
+  settlePollMs = 15e3
+} = {}) {
   const effectiveApiToken = apiToken || resolveRailwayAuthToken(env);
   const effectiveApiUrl = apiUrl || resolveRailwayApiUrl(env);
   const effectiveEnv = { ...env, RAILWAY_API_TOKEN: effectiveApiToken, TREESEED_RAILWAY_API_URL: effectiveApiUrl };
   const services = configuredRailwayServices(tenantRoot, scope);
   const checks = [];
+  const deploymentStatusServices = [];
   for (const service of services) {
     const target = await resolveRailwayScheduleTarget({
       projectId: service.projectId,
@@ -874,6 +1005,10 @@ async function verifyRailwayManagedResources(tenantRoot, scope, { fetchImpl = fe
       });
       continue;
     }
+    deploymentStatusServices.push({
+      ...service,
+      projectId: target.project.id
+    });
     const instance = await getRailwayServiceInstance({
       serviceId: target.service.id,
       environmentId: target.environment.id,
@@ -943,6 +1078,17 @@ async function verifyRailwayManagedResources(tenantRoot, scope, { fetchImpl = fe
       ...check
     });
   }
+  if (settleDeployments) {
+    const settled = await waitForRailwayManagedDeploymentsSettled(tenantRoot, scope, {
+      services: deploymentStatusServices.length > 0 ? deploymentStatusServices : services,
+      env: effectiveEnv,
+      timeoutMs: settleTimeoutMs,
+      pollMs: settlePollMs
+    });
+    for (const check of settled.checks ?? []) {
+      checks.push(check);
+    }
+  }
   return {
     ok: checks.every((entry) => entry.ok === true || entry.skipped === true),
     checks
@@ -1255,6 +1401,7 @@ async function deployRailwayService(tenantRoot, service, {
 }
 export {
   buildRailwayCommandEnv,
+  collectRailwayDeploymentStatusChecks,
   configuredRailwayScheduledJobs,
   configuredRailwayServices,
   deployRailwayService,
@@ -1276,5 +1423,6 @@ export {
   validateRailwayDeployPrerequisites,
   validateRailwayServiceConfiguration,
   verifyRailwayManagedResources,
-  verifyRailwayScheduledJobs
+  verifyRailwayScheduledJobs,
+  waitForRailwayManagedDeploymentsSettled
 };

package/dist/workflow/operations.js

@@ -2986,7 +2986,11 @@ async function workflowSave(helpers, input) {
             branch: String(repo.branch),
             headSha: String(repo.commitSha)
           }))
-        ], "hosted", { root, runId: workflowRun.runId }).then((workflowGates) => ({ workflowGates }))) : { workflowGates: [] };
+        ], "hosted", {
+          root,
+          runId: workflowRun.runId,
+          onProgress: (line, stream) => helpers.write(line, stream)
+        }).then((workflowGates) => ({ workflowGates }))) : { workflowGates: [] };
         const releaseCandidate = branch === STAGING_BRANCH ? await executeJournalStep(root, workflowRun.runId, "release-candidate", () => {
           const releaseSession = resolveTreeseedWorkflowSession(root);
           const stagingReleasePlan = buildReleasePlanSnapshot({
@@ -3516,7 +3520,11 @@ async function workflowStage(helpers, input) {
             branch: STAGING_BRANCH,
             headSha: String(report.commitSha)
           }))
-        ], ciMode, { root, runId: workflowRun.runId }).then((workflowGates) => ({
+        ], ciMode, {
+          root,
+          runId: workflowRun.runId,
+          onProgress: (line, stream) => helpers.write(line, stream)
+        }).then((workflowGates) => ({
           status: "completed",
           workflowGates
         })));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.6.44",
+  "version": "0.6.46",
   "description": "Shared Treeseed SDK for content-backed and D1-backed object models.",
   "license": "AGPL-3.0-only",
   "repository": {