@treeseed/sdk 0.6.43 → 0.6.44

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

@@ -137,6 +137,126 @@ export declare function deployProjectPlatform(options: ProjectPlatformActionOpti
                 skipped: boolean;
                 reason: string;
             };
+            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;
+                })[];
+            } | {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+            };
             pages: {
                 ok: boolean;
                 status: number;
@@ -315,6 +435,126 @@ export declare function monitorProjectPlatform(options: ProjectPlatformActionOpt
             skipped: boolean;
             reason: string;
         };
+        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;
+            })[];
+        } | {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+        };
         pages: {
             ok: boolean;
             status: number;
@@ -498,6 +738,126 @@ export declare function runProjectPlatformAction(action: ProjectPlatformAction,
             skipped: boolean;
             reason: string;
         };
+        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;
+            })[];
+        } | {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+        };
         pages: {
             ok: boolean;
             status: number;
@@ -637,6 +997,126 @@ export declare function runProjectPlatformAction(action: ProjectPlatformAction,
                 skipped: boolean;
                 reason: string;
             };
+            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;
+                })[];
+            } | {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+            };
             pages: {
                 ok: boolean;
                 status: number;

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

@@ -35,6 +35,7 @@ import {
   ensureRailwayScheduledJobs,
   validateRailwayDeployPrerequisites,
   validateRailwayServiceConfiguration,
+  verifyRailwayManagedResources,
   verifyRailwayScheduledJobs
 } from "./railway-deploy.js";
 import { loadCliDeployConfig, packageScriptPath } from "./runtime-tools.js";
@@ -1209,6 +1210,7 @@ async function publishProjectContent(options) {
 }
 async function monitorProjectPlatform(options) {
   const reporter = resolveReporter(options.tenantRoot, options.reporter);
+  const env = { ...process.env, ...options.env ?? {} };
   const target = createPersistentDeployTarget(options.scope === "local" ? "staging" : options.scope);
   const siteConfig = loadCliDeployConfig(options.tenantRoot);
   const selectedSystems = new Set(resolveProjectPlatformBootstrapSystems(options, siteConfig));
@@ -1228,12 +1230,14 @@ 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 }),
     readiness: state.readiness
   };
   const resolvedChecks = {
     ...checks,
     r2: await checks.r2,
-    queue: await checks.queue
+    queue: await checks.queue,
+    railwayResources: await checks.railwayResources
   };
   const ok = [
     resolvedChecks.pages,
@@ -1243,7 +1247,8 @@ async function monitorProjectPlatform(options) {
     resolvedChecks.agentHealth,
     resolvedChecks.r2,
     resolvedChecks.queue,
-    resolvedChecks.scaleProbe
+    resolvedChecks.scaleProbe,
+    resolvedChecks.railwayResources
   ].every((check) => check?.ok === true || check?.skipped === true);
   if (!ok) {
     const failedChecks = Object.entries(resolvedChecks).filter(([, check]) => check && typeof check === "object" && check.ok !== true && check.skipped !== true).map(([name, check]) => `${name}: ${JSON.stringify(check)}`);

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

@@ -281,6 +281,125 @@ export declare function verifyRailwayScheduledJobs(tenantRoot: any, scope: any,
     unsupported?: undefined;
     message?: undefined;
 }>;
+export declare function verifyRailwayManagedResources(tenantRoot: any, scope: any, { fetchImpl, apiToken, apiUrl, env }?: {
+    fetchImpl?: typeof fetch | undefined;
+    env?: NodeJS.ProcessEnv | 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;
+    })[];
+}>;
 export declare function planRailwayServiceDeploy(service: any, { env }?: {
     env?: NodeJS.ProcessEnv | undefined;
 }): {

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

@@ -15,6 +15,7 @@ import {
   listRailwayEnvironments,
   listRailwayProjects,
   listRailwayServices,
+  listRailwayVolumes,
   normalizeRailwayEnvironmentName,
   resolveRailwayApiToken,
   resolveRailwayApiUrl,
@@ -841,6 +842,112 @@ async function verifyRailwayScheduledJobs(tenantRoot, scope, { fetchImpl = fetch
     checks
   };
 }
+async function verifyRailwayManagedResources(tenantRoot, scope, { fetchImpl = fetch, apiToken, apiUrl, env = process.env } = {}) {
+  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 = [];
+  for (const service of services) {
+    const target = await resolveRailwayScheduleTarget({
+      projectId: service.projectId,
+      projectName: service.projectName,
+      serviceId: service.serviceId,
+      serviceName: service.serviceName,
+      environment: normalizeRailwayEnvironmentName(service.railwayEnvironment),
+      environmentId: envValue("TREESEED_RAILWAY_ENVIRONMENT_ID") || null
+    }, {
+      env: effectiveEnv,
+      fetchImpl,
+      ensure: false
+    });
+    if (!target.project || !target.environment || !target.service) {
+      checks.push({
+        type: "service",
+        service: service.key,
+        serviceName: service.serviceName,
+        projectName: service.projectName,
+        environment: service.railwayEnvironment,
+        ok: false,
+        status: "missing",
+        message: `Railway service ${service.serviceName} is missing in ${service.railwayEnvironment}.`
+      });
+      continue;
+    }
+    const instance = await getRailwayServiceInstance({
+      serviceId: target.service.id,
+      environmentId: target.environment.id,
+      env: effectiveEnv,
+      fetchImpl
+    });
+    checks.push({
+      type: "service-instance",
+      service: service.key,
+      serviceName: target.service.name,
+      serviceId: target.service.id,
+      projectId: target.project.id,
+      environment: target.environment.name,
+      environmentId: target.environment.id,
+      instanceId: instance.id,
+      ok: Boolean(instance.id),
+      status: instance.id ? "checked" : "missing",
+      observed: instance.id ? {
+        rootDirectory: instance.rootDirectory,
+        startCommand: instance.startCommand,
+        cronSchedule: instance.cronSchedule,
+        sleepApplication: instance.sleepApplication,
+        runtimeMode: instance.runtimeMode
+      } : null,
+      message: instance.id ? void 0 : `Railway service instance for ${target.service.name} is missing in ${target.environment.name}.`
+    });
+    if (service.key === "workerRunner") {
+      const expectedVolumeName = deriveRailwayWorkerRunnerVolumeName(target.service.name, target.environment.name);
+      const volumes = await listRailwayVolumes({
+        projectId: target.project.id,
+        env: effectiveEnv,
+        fetchImpl
+      });
+      const volume = volumes.find(
+        (candidate) => candidate.name === expectedVolumeName && candidate.instances.some((entry) => entry.serviceId === target.service.id && entry.environmentId === target.environment.id && entry.mountPath === WORKER_RUNNER_VOLUME_MOUNT_PATH)
+      ) ?? null;
+      checks.push({
+        type: "worker-runner-volume",
+        service: service.key,
+        serviceName: target.service.name,
+        serviceId: target.service.id,
+        projectId: target.project.id,
+        environment: target.environment.name,
+        environmentId: target.environment.id,
+        volumeName: expectedVolumeName,
+        mountPath: WORKER_RUNNER_VOLUME_MOUNT_PATH,
+        ok: Boolean(volume),
+        status: volume ? "checked" : "missing",
+        observed: volume ? {
+          id: volume.id,
+          name: volume.name,
+          instances: volume.instances
+        } : null,
+        message: volume ? void 0 : `Railway worker-runner volume ${expectedVolumeName} is missing or is not mounted at ${WORKER_RUNNER_VOLUME_MOUNT_PATH}.`
+      });
+    }
+  }
+  const schedules = await verifyRailwayScheduledJobs(tenantRoot, scope, {
+    fetchImpl,
+    apiToken: effectiveApiToken,
+    apiUrl: effectiveApiUrl,
+    env: effectiveEnv
+  });
+  for (const check of schedules.checks ?? []) {
+    checks.push({
+      type: "schedule",
+      ...check
+    });
+  }
+  return {
+    ok: checks.every((entry) => entry.ok === true || entry.skipped === true),
+    checks
+  };
+}
 function shouldAttachRailwayDeployLogs(env = process.env) {
   return configuredEnvValue(env, "TREESEED_RAILWAY_DEPLOY_ATTACH_LOGS") === "1";
 }
@@ -1168,5 +1275,6 @@ export {
   setRailwaySecretVariable,
   validateRailwayDeployPrerequisites,
   validateRailwayServiceConfiguration,
+  verifyRailwayManagedResources,
   verifyRailwayScheduledJobs
 };

package/dist/workflow/operations.js

@@ -319,7 +319,7 @@ function normalizeSaveVerifyMode(mode) {
   }
 }
 function shouldUseHostedSaveCi(input) {
-  return normalizeCiMode(input.ciMode, "save") === "hosted" || input.verifyMode === "hosted" || input.verifyMode === "both";
+  return normalizeCiMode(input.ciMode, "save") === "hosted" || input.verifyMode === "hosted" || input.verifyMode === "both" || input.verifyDeployedResources === true;
 }
 function worktreePayload(root, requestedMode) {
   const metadata = managedWorkflowWorktreeMetadata(root);
@@ -2875,7 +2875,8 @@ async function workflowSave(helpers, input) {
           ciMode: effectiveInput.ciMode ?? "auto",
           worktreeMode: effectiveInput.worktreeMode ?? "auto",
           commitMessageMode: effectiveInput.commitMessageMode ?? "auto",
-          workspaceLinks: effectiveInput.workspaceLinks ?? "auto"
+          workspaceLinks: effectiveInput.workspaceLinks ?? "auto",
+          verifyDeployedResources: effectiveInput.verifyDeployedResources === true
         },
         [
           {
@@ -2971,6 +2972,13 @@ async function workflowSave(helpers, input) {
             branch,
             headSha: savedRootRepo.commitSha
           }] : [],
+          ...effectiveInput.verifyDeployedResources === true && scope !== "local" && savedRootRepo.pushed && savedRootRepo.commitSha && branch ? [{
+            name: savedRootRepo.name,
+            repoPath: savedRootRepo.path,
+            workflow: "deploy.yml",
+            branch,
+            headSha: savedRootRepo.commitSha
+          }] : [],
           ...savedPackageReports.filter((repo) => repo.pushed && repo.commitSha && repo.branch).map((repo) => ({
             name: repo.name,
             repoPath: repo.path,
@@ -3289,6 +3297,7 @@ async function workflowStage(helpers, input) {
       const effectiveInput = autoResumeRun ? autoResumeRun.input : input;
       const message = ensureMessage("stage", effectiveInput.message, "a resolution message");
       const ciMode = normalizeCiMode(effectiveInput.ciMode, "stage");
+      const waitForStaging = effectiveInput.verifyDeployedResources === true || effectiveInput.waitForStaging !== false;
       if (executionMode === "plan") {
         const blockers = [];
         if (initialSession.branchRole !== "feature") {
@@ -3371,11 +3380,12 @@ async function workflowStage(helpers, input) {
         session,
         {
           message,
-          waitForStaging: effectiveInput.waitForStaging !== false,
+          waitForStaging,
           deletePreview: effectiveInput.deletePreview !== false,
           deleteBranch: effectiveInput.deleteBranch !== false,
           ciMode,
-          worktreeMode: effectiveInput.worktreeMode ?? "auto"
+          worktreeMode: effectiveInput.worktreeMode ?? "auto",
+          verifyDeployedResources: effectiveInput.verifyDeployedResources === true
         },
         [
           { id: "workspace-unlink", description: "Remove local workspace links", repoName: rootRepo.name, repoPath: rootRepo.path, branch: featureBranch, resumable: true },
@@ -3491,7 +3501,7 @@ async function workflowStage(helpers, input) {
             exitCode: 12
           });
         }
-        const stageWorkflowGateResult = effectiveInput.waitForStaging === false ? (skipJournalStep(root, workflowRun.runId, "wait-staging", { status: "skipped", reason: "disabled" }), { status: "skipped", reason: "disabled" }) : await executeJournalStep(root, workflowRun.runId, "wait-staging", () => waitForWorkflowGates("stage", [
+        const stageWorkflowGateResult = !waitForStaging ? (skipJournalStep(root, workflowRun.runId, "wait-staging", { status: "skipped", reason: "disabled" }), { status: "skipped", reason: "disabled" }) : await executeJournalStep(root, workflowRun.runId, "wait-staging", () => waitForWorkflowGates("stage", [
           {
             name: rootRepo.name,
             repoPath: rootRepo.path,

package/dist/workflow.d.ts

@@ -111,6 +111,7 @@ export type TreeseedSaveInput = {
     worktreeMode?: TreeseedWorkflowWorktreeMode;
     commitMessageMode?: 'auto' | 'cloudflare' | 'generated' | 'fallback';
     workspaceLinks?: 'auto' | 'off';
+    verifyDeployedResources?: boolean;
     plan?: boolean;
     dryRun?: boolean;
 };
@@ -153,6 +154,7 @@ export type TreeseedStageInput = {
     ciMode?: TreeseedWorkflowCiMode;
     worktreeMode?: TreeseedWorkflowWorktreeMode;
     workspaceLinks?: 'auto' | 'off';
+    verifyDeployedResources?: boolean;
     plan?: boolean;
     dryRun?: boolean;
 };

package/package.json

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