@treeseed/sdk 0.4.12 → 0.5.0

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

@@ -20,6 +20,7 @@ import {
   ensureGeneratedWranglerConfig,
   finalizeDeploymentState,
   loadDeployState,
+  purgePublishedContentCaches,
   provisionCloudflareResources,
   syncCloudflareSecrets,
   verifyProvisionedCloudflareResources,
@@ -175,14 +176,66 @@ function uploadObject(tenantRoot, wranglerPath, wranglerEnv, bucketName, pointer
     pointer.contentType ?? inferContentType(filePath)
   ], wranglerEnv);
 }
+function deleteObject(tenantRoot, wranglerPath, wranglerEnv, bucketName, objectKey) {
+  runWrangler(tenantRoot, [
+    "r2",
+    "object",
+    "delete",
+    `${bucketName}/${objectKey}`,
+    "--config",
+    wranglerPath,
+    "--remote"
+  ], wranglerEnv, { allowFailure: true });
+}
 function objectFileName(pointer) {
   const ext = extname(pointer.objectKey) || ".json";
   return `${pointer.sha256}${ext}`;
 }
-async function fetchJson(url, init = {}) {
-  const response = await fetch(url, init);
-  const body = await response.json().catch(() => null);
-  return { response, body };
+function canonicalSitePathForEntry(entry) {
+  return entry.model === "pages" ? `/${entry.slug || entry.id || ""}`.replace(/\/+$/u, "") || "/" : `/${entry.model}/${entry.slug || entry.id || ""}`.replace(/\/+$/u, "");
+}
+function contentIndexPathForModel(model) {
+  return model === "pages" ? null : `/${model}`;
+}
+function sourceLikeFreshnessPaths() {
+  return ["/", "/feed.xml", "/sitemap-index.xml"];
+}
+function entrySignature(entry) {
+  const { publishedAt, ...rest } = entry;
+  return stableHash(JSON.stringify(rest));
+}
+function artifactSignature(artifact) {
+  const { publishedAt, ...rest } = artifact;
+  return stableHash(JSON.stringify(rest));
+}
+function canonicalEntryPath(entry) {
+  return `${entry.model}/${entry.slug || entry.id || ""}`.replace(/^\/+|\/+$/gu, "");
+}
+function changedEntries(previousManifest, nextEntries) {
+  const previous = new Map((previousManifest?.entries ?? []).map((entry) => [canonicalEntryPath(entry), entrySignature(entry)]));
+  return nextEntries.filter((entry) => previous.get(canonicalEntryPath(entry)) !== entrySignature(entry));
+}
+function changedArtifacts(previousManifest, nextArtifacts) {
+  const previous = new Map((previousManifest?.artifacts ?? []).map((artifact) => [`${artifact.kind}:${artifact.itemId}`, artifactSignature(artifact)]));
+  return nextArtifacts.filter((artifact) => previous.get(`${artifact.kind}:${artifact.itemId}`) !== artifactSignature(artifact));
+}
+function absoluteUrl(baseUrl, path) {
+  if (!baseUrl) {
+    return null;
+  }
+  try {
+    return new URL(path.startsWith("/") ? path : `/${path}`, baseUrl).toString();
+  } catch {
+    return null;
+  }
+}
+function stableEntryAliasKey(teamId, entry) {
+  const ext = extname(entry.content.objectKey) || ".md";
+  return `teams/${teamId}/published/entries/${entry.model}/${entry.slug || entry.id}${ext}`;
+}
+function stableArtifactAliasKey(teamId, artifact) {
+  const fileName = typeof artifact.metadata?.fileName === "string" && artifact.metadata.fileName ? artifact.metadata.fileName : `${artifact.itemId}${extname(artifact.content.objectKey) || ".bin"}`;
+  return `teams/${teamId}/published/artifacts/${artifact.kind}/${artifact.itemId}/${fileName}`;
 }
 async function probeHttp(url) {
   try {
@@ -203,49 +256,8 @@ async function probeHttp(url) {
     };
   }
 }
-async function probeRunnerHealth(siteConfig, environment) {
-  const baseUrl = String(process.env.TREESEED_MARKET_API_BASE_URL ?? siteConfig.hosting?.marketBaseUrl ?? "").trim();
-  const projectId = String(process.env.TREESEED_PROJECT_ID ?? siteConfig.hosting?.projectId ?? "").trim();
-  const runnerToken = String(process.env.TREESEED_PROJECT_RUNNER_TOKEN ?? "").trim();
-  if (!baseUrl || !projectId || !runnerToken || environment === "local") {
-    return { ok: true, skipped: true, reason: "runner_health_unconfigured" };
-  }
-  try {
-    let lastResult = null;
-    for (let attempt = 0; attempt < 10; attempt += 1) {
-      const { response, body } = await fetchJson(
-        `${baseUrl.replace(/\/+$/u, "")}/v1/projects/${encodeURIComponent(projectId)}/runner/health?environment=${encodeURIComponent(environment)}`,
-        {
-          headers: {
-            accept: "application/json",
-            authorization: `Bearer ${runnerToken}`
-          }
-        }
-      );
-      const pools = Array.isArray(body?.payload?.pools) ? body.payload.pools : [];
-      const heartbeatPresent = pools.some((entry) => entry?.latestRegistration);
-      lastResult = {
-        ok: response.ok && body?.ok === true && heartbeatPresent,
-        status: response.status,
-        payload: body?.payload ?? null,
-        heartbeatPresent,
-        attempt: attempt + 1
-      };
-      if (lastResult.ok) {
-        return lastResult;
-      }
-      await new Promise((resolve2) => setTimeout(resolve2, 3e3));
-    }
-    return lastResult ?? { ok: false, reason: "runner_health_unavailable" };
-  } catch (error) {
-    return {
-      ok: false,
-      error: error instanceof Error ? error.message : String(error)
-    };
-  }
-}
 function queueClientConfig(siteConfig, state) {
-  const accountId = siteConfig.cloudflare.accountId;
+  const accountId = String(process.env.CLOUDFLARE_ACCOUNT_ID ?? siteConfig.cloudflare.accountId ?? "").trim();
   const queueId = state.queues?.agentWork?.queueId;
   const token = process.env.TREESEED_QUEUE_PUSH_TOKEN?.trim() || process.env.TREESEED_QUEUE_PULL_TOKEN?.trim() || process.env.CLOUDFLARE_API_TOKEN?.trim() || "";
   if (!accountId || !queueId || !token) {
@@ -310,11 +322,12 @@ function deleteR2Object(tenantRoot, bucketName, objectKey, wranglerPath, wrangle
 }
 function probeR2(tenantRoot, siteConfig, state, target) {
   const bucketName = state.content?.bucketName;
+  const cloudflareAccountId = String(process.env.CLOUDFLARE_ACCOUNT_ID ?? siteConfig.cloudflare.accountId ?? "").trim();
   if (!bucketName) {
     return { ok: false, skipped: true, reason: "r2_unconfigured" };
   }
   const { wranglerPath } = ensureGeneratedWranglerConfig(tenantRoot, { target });
-  const wranglerEnv = { CLOUDFLARE_ACCOUNT_ID: siteConfig.cloudflare.accountId };
+  const wranglerEnv = { CLOUDFLARE_ACCOUNT_ID: cloudflareAccountId };
   const tempRoot = mkdtempSync(join(tmpdir(), "treeseed-r2-health-"));
   const objectKey = r2HealthKey(state);
   try {
@@ -358,7 +371,7 @@ function probeScaleConfiguration(siteConfig, state) {
 async function publishContent(options, reporter) {
   const siteConfig = loadCliDeployConfig(options.tenantRoot);
   const tenantConfig = loadTreeseedManifest(resolve(options.tenantRoot, "src", "manifest.yaml"));
-  const teamId = siteConfig.hosting?.teamId ?? siteConfig.slug;
+  const teamId = String(process.env.TREESEED_HOSTING_TEAM_ID ?? siteConfig.hosting?.teamId ?? siteConfig.slug).trim() || siteConfig.slug;
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
   const commitSha = currentCommit(options.tenantRoot);
   const branchName = currentRef(options.tenantRoot);
@@ -366,10 +379,10 @@ async function publishContent(options, reporter) {
   const locator = resolveTeamScopedContentLocator(siteConfig, teamId);
   const target = createPersistentDeployTarget(options.scope === "local" ? "staging" : options.scope);
   const { wranglerPath } = ensureGeneratedWranglerConfig(options.tenantRoot, { target });
-  const wranglerEnv = { CLOUDFLARE_ACCOUNT_ID: siteConfig.cloudflare.accountId };
-  const bucketName = siteConfig.cloudflare.r2?.bucketName;
+  const wranglerEnv = { CLOUDFLARE_ACCOUNT_ID: String(process.env.CLOUDFLARE_ACCOUNT_ID ?? siteConfig.cloudflare.accountId ?? "").trim() };
+  const bucketName = String(process.env.TREESEED_CONTENT_BUCKET_NAME ?? siteConfig.cloudflare.r2?.bucketName ?? "").trim();
   if (!bucketName) {
-    throw new Error("Treeseed content publish requires cloudflare.r2.bucketName in treeseed.site.yaml.");
+    throw new Error("Treeseed content publish requires TREESEED_CONTENT_BUCKET_NAME to be configured.");
   }
   const previousManifest = readR2JsonObject(
     options.tenantRoot,
@@ -389,6 +402,85 @@ async function publishContent(options, reporter) {
     previewId
   });
   const built = options.scope === "staging" ? await pipeline.buildEditorialOverlay({ previousManifest, previewId }) : await pipeline.buildProductionRevision({ previousManifest });
+  const changedEntrySet = "manifest" in built ? changedEntries(previousManifest, built.manifest.entries) : [];
+  const changedArtifactSet = "manifest" in built ? changedArtifacts(previousManifest, built.manifest.artifacts ?? []) : [];
+  const tombstones = "manifest" in built ? built.manifest.tombstones ?? [] : [];
+  const objectByKey = new Map(built.objects.map((object) => [object.pointer.objectKey, object]));
+  const publicObjectBaseUrl = process.env.TREESEED_CONTENT_PUBLIC_BASE_URL ?? siteConfig.cloudflare.r2?.publicBaseUrl ?? null;
+  const stableObjectUploads = [];
+  const deletedObjectKeys = [];
+  const contentPurgeUrls = /* @__PURE__ */ new Set();
+  if ("manifest" in built && publicObjectBaseUrl) {
+    for (const entry of built.manifest.entries) {
+      entry.content.publicUrl = absoluteUrl(publicObjectBaseUrl, stableEntryAliasKey(teamId, entry)) ?? void 0;
+    }
+    for (const artifact of built.manifest.artifacts ?? []) {
+      artifact.content.publicUrl = artifact.content.publicUrl ?? absoluteUrl(publicObjectBaseUrl, stableArtifactAliasKey(teamId, artifact)) ?? void 0;
+    }
+    for (const entry of changedEntrySet) {
+      const current = entry;
+      const sourceObject = objectByKey.get(current.content.objectKey);
+      const publicUrl = current.content.publicUrl ?? absoluteUrl(publicObjectBaseUrl, stableEntryAliasKey(teamId, current));
+      if (sourceObject) {
+        stableObjectUploads.push({
+          pointer: {
+            objectKey: stableEntryAliasKey(teamId, current),
+            sha256: sourceObject.pointer.sha256,
+            size: sourceObject.pointer.size,
+            contentType: sourceObject.pointer.contentType,
+            publicUrl: publicUrl ?? void 0
+          },
+          body: toBuffer(sourceObject.body)
+        });
+      }
+      if (publicUrl) {
+        contentPurgeUrls.add(publicUrl);
+      }
+      contentPurgeUrls.add(absoluteUrl(siteConfig.siteUrl, canonicalSitePathForEntry(current)) ?? "");
+      const indexPath = contentIndexPathForModel(current.model);
+      if (indexPath) {
+        contentPurgeUrls.add(absoluteUrl(siteConfig.siteUrl, indexPath) ?? "");
+      }
+    }
+    for (const artifact of changedArtifactSet) {
+      const current = artifact;
+      const sourceObject = objectByKey.get(current.content.objectKey);
+      const publicUrl = current.content.publicUrl ?? absoluteUrl(publicObjectBaseUrl, stableArtifactAliasKey(teamId, current));
+      if (sourceObject && publicUrl) {
+        stableObjectUploads.push({
+          pointer: {
+            objectKey: stableArtifactAliasKey(teamId, current),
+            sha256: sourceObject.pointer.sha256,
+            size: sourceObject.pointer.size,
+            contentType: sourceObject.pointer.contentType,
+            publicUrl
+          },
+          body: toBuffer(sourceObject.body)
+        });
+      }
+      if (publicUrl) {
+        contentPurgeUrls.add(publicUrl);
+      }
+    }
+    for (const tombstone of tombstones) {
+      const [model, ...slugParts] = String(tombstone.path ?? "").split("/");
+      if (!model || slugParts.length === 0) {
+        continue;
+      }
+      const slug = slugParts.join("/");
+      const aliasKey = stableEntryAliasKey(teamId, { model, slug, content: { objectKey: `${slug}.md` } });
+      deletedObjectKeys.push(aliasKey);
+      contentPurgeUrls.add(absoluteUrl(publicObjectBaseUrl, aliasKey) ?? "");
+      contentPurgeUrls.add(absoluteUrl(siteConfig.siteUrl, canonicalSitePathForEntry({ model, slug })) ?? "");
+      const indexPath = contentIndexPathForModel(model);
+      if (indexPath) {
+        contentPurgeUrls.add(absoluteUrl(siteConfig.siteUrl, indexPath) ?? "");
+      }
+    }
+    for (const freshnessPath of sourceLikeFreshnessPaths()) {
+      contentPurgeUrls.add(absoluteUrl(siteConfig.siteUrl, freshnessPath) ?? "");
+    }
+  }
   const tempRoot = mkdtempSync(join(tmpdir(), "treeseed-content-publish-"));
   try {
     if (!options.dryRun) {
@@ -396,6 +488,13 @@ async function publishContent(options, reporter) {
         const filePath = writeTempFile(tempRoot, objectFileName(object.pointer), toBuffer(object.body));
         uploadObject(options.tenantRoot, wranglerPath, wranglerEnv, bucketName, object.pointer, filePath);
       }
+      for (const alias of stableObjectUploads) {
+        const filePath = writeTempFile(tempRoot, objectFileName(alias.pointer), alias.body);
+        uploadObject(options.tenantRoot, wranglerPath, wranglerEnv, bucketName, alias.pointer, filePath);
+      }
+      for (const objectKey of deletedObjectKeys) {
+        deleteObject(options.tenantRoot, wranglerPath, wranglerEnv, bucketName, objectKey);
+      }
       if ("overlay" in built) {
         const overlayFile = writeTempFile(tempRoot, "overlay.json", Buffer.from(JSON.stringify(built.overlay, null, 2)));
         uploadObject(
@@ -426,6 +525,12 @@ async function publishContent(options, reporter) {
           size: statSync(manifestFile).size,
           contentType: "application/json"
         }, manifestFile);
+        if (contentPurgeUrls.size > 0) {
+          try {
+            purgePublishedContentCaches(options.tenantRoot, [...contentPurgeUrls].filter(Boolean), { target });
+          } catch {
+          }
+        }
       }
     }
     const state = loadDeployState(options.tenantRoot, siteConfig, { target });
@@ -455,7 +560,8 @@ async function publishContent(options, reporter) {
         previewUrl,
         entries: ("overlay" in built ? built.overlay.entries : built.manifest.entries).length,
         artifacts: ("overlay" in built ? built.overlay.artifacts : built.manifest.artifacts)?.length ?? 0,
-        catalog: built.catalog.length
+        catalog: built.catalog.length,
+        cachePurgeCount: contentPurgeUrls.size
       },
       finishedAt: (/* @__PURE__ */ new Date()).toISOString()
     });
@@ -489,7 +595,7 @@ async function provisionProjectPlatform(options) {
     environment: options.scope,
     deploymentProfile: siteConfig.hosting?.kind ?? "self_hosted_project",
     baseUrl: state.lastDeployedUrl,
-    cloudflareAccountId: siteConfig.cloudflare.accountId,
+    cloudflareAccountId: String(process.env.CLOUDFLARE_ACCOUNT_ID ?? siteConfig.cloudflare.accountId ?? "").trim() || null,
     pagesProjectName: state.pages?.projectName ?? null,
     workerName: state.workerName,
     r2BucketName: state.content?.bucketName ?? null,
@@ -666,7 +772,7 @@ async function monitorProjectPlatform(options) {
   const target = createPersistentDeployTarget(options.scope === "local" ? "staging" : options.scope);
   const siteConfig = loadCliDeployConfig(options.tenantRoot);
   const state = loadDeployState(options.tenantRoot, siteConfig, { target });
-  const apiBaseUrl = siteConfig.services?.api?.environments?.[options.scope]?.baseUrl ?? siteConfig.services?.api?.publicBaseUrl ?? state.services?.api?.lastDeployedUrl ?? null;
+  const apiBaseUrl = siteConfig.services?.api?.environments?.[options.scope]?.baseUrl ?? siteConfig.services?.api?.publicBaseUrl ?? process.env.TREESEED_API_BASE_URL ?? state.services?.api?.lastDeployedUrl ?? null;
   const checks = {
     pages: await probeHttp(state.pages?.url ?? siteConfig.siteUrl),
     apiHealth: apiBaseUrl ? await probeHttp(`${String(apiBaseUrl).replace(/\/+$/u, "")}/healthz`) : { ok: false, skipped: true, reason: "api_url_unconfigured" },
@@ -675,15 +781,13 @@ async function monitorProjectPlatform(options) {
     agentHealth: apiBaseUrl ? await probeHttp(`${String(apiBaseUrl).replace(/\/+$/u, "")}/agent/healthz`) : { ok: false, skipped: true, reason: "api_url_unconfigured" },
     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),
-    runner: probeRunnerHealth(siteConfig, options.scope),
     scaleProbe: probeScaleConfiguration(siteConfig, state),
     readiness: state.readiness
   };
   const resolvedChecks = {
     ...checks,
     r2: await checks.r2,
-    queue: await checks.queue,
-    runner: await checks.runner
+    queue: await checks.queue
   };
   const ok = [
     resolvedChecks.pages,
@@ -693,7 +797,6 @@ async function monitorProjectPlatform(options) {
     resolvedChecks.agentHealth,
     resolvedChecks.r2,
     resolvedChecks.queue,
-    resolvedChecks.runner,
     resolvedChecks.scaleProbe
   ].every((check) => check?.ok === true || check?.skipped === true);
   if (!ok) {
@@ -728,7 +831,7 @@ async function syncControlPlaneState(options) {
     environment: options.scope,
     deploymentProfile: siteConfig.hosting?.kind ?? "self_hosted_project",
     baseUrl: state.lastDeployedUrl,
-    cloudflareAccountId: siteConfig.cloudflare.accountId,
+    cloudflareAccountId: String(process.env.CLOUDFLARE_ACCOUNT_ID ?? siteConfig.cloudflare.accountId ?? "").trim() || null,
     pagesProjectName: state.pages?.projectName ?? null,
     workerName: state.workerName,
     r2BucketName: state.content?.bucketName ?? null,

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

@@ -119,6 +119,7 @@ export declare function verifyRailwayScheduledJobs(tenantRoot: any, scope: any,
     checks: {
         id: any;
         ok: boolean;
+        status: string;
         service: string;
         projectId: string | null;
         projectName: string | null;

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

@@ -6,8 +6,8 @@ const DEFAULT_RAILWAY_API_URL = "https://backboard.railway.com/graphql/v2";
 function normalizeScope(scope) {
   return scope === "prod" ? "prod" : scope === "staging" ? "staging" : "local";
 }
-const RAILWAY_SERVICE_KEYS = ["api", "agents", "manager", "worker", "runner", "workdayStart", "workdayReport"];
-const HOSTED_PROJECT_SERVICE_KEYS = ["api", "manager", "worker", "agents"];
+const RAILWAY_SERVICE_KEYS = ["api", "manager", "worker", "workdayStart", "workdayReport"];
+const HOSTED_PROJECT_SERVICE_KEYS = ["api", "manager", "worker"];
 function normalizeScheduleExpressions(value) {
   if (typeof value === "string" && value.trim()) {
     return [value.trim()];
@@ -179,14 +179,18 @@ function runRailway(args, { cwd, capture = false, allowFailure = false } = {}) {
 function configuredRailwayServices(tenantRoot, scope) {
   const deployConfig = loadCliDeployConfig(tenantRoot);
   const normalizedScope = normalizeScope(scope);
-  const hostingKind = deployConfig.hosting?.kind ?? "self_hosted_project";
+  const managedRuntime = deployConfig.runtime?.mode === "treeseed_managed";
+  const hostingKind = deployConfig.hosting?.kind ?? (managedRuntime ? "hosted_project" : "self_hosted_project");
+  if (!managedRuntime) {
+    return [];
+  }
   const serviceKeys = hostingKind === "hosted_project" ? HOSTED_PROJECT_SERVICE_KEYS : RAILWAY_SERVICE_KEYS;
   return serviceKeys.map((serviceKey) => {
     const service = deployConfig.services?.[serviceKey];
     if (!service || service.enabled === false || (service.provider ?? "railway") !== "railway") {
       return null;
     }
-    const defaultRootDir = ["api", "manager", "worker", "runner", "workdayStart", "workdayReport"].includes(serviceKey) ? "." : "packages/core";
+    const defaultRootDir = ["api", "manager", "worker", "workdayStart", "workdayReport"].includes(serviceKey) ? "." : "packages/core";
     const serviceRoot = resolve(tenantRoot, service.railway?.rootDir ?? service.rootDir ?? defaultRootDir);
     const railwayEnvironment = service.environments?.[normalizedScope]?.railwayEnvironment ?? normalizedScope;
     const publicBaseUrl = service.environments?.[normalizedScope]?.baseUrl ?? service.publicBaseUrl ?? null;
@@ -226,10 +230,10 @@ function configuredRailwayScheduledJobs(tenantRoot, scope) {
 }
 function resolveRailwayDeploymentProfile(tenantRoot) {
   const deployConfig = loadCliDeployConfig(tenantRoot);
-  const hostingKind = deployConfig.hosting?.kind ?? "self_hosted_project";
+  const hostingKind = deployConfig.hosting?.kind ?? (deployConfig.runtime?.mode === "treeseed_managed" ? "hosted_project" : "self_hosted_project");
   return {
     hostingKind,
-    managedTopology: hostingKind === "hosted_project" ? [...HOSTED_PROJECT_SERVICE_KEYS] : [...RAILWAY_SERVICE_KEYS]
+    managedTopology: deployConfig.runtime?.mode === "treeseed_managed" ? hostingKind === "hosted_project" ? [...HOSTED_PROJECT_SERVICE_KEYS] : [...RAILWAY_SERVICE_KEYS] : []
   };
 }
 function validateRailwayServiceConfiguration(tenantRoot, scope) {
@@ -257,12 +261,6 @@ function validateRailwayServiceConfiguration(tenantRoot, scope) {
     if (service.schedule?.length && !service.startCommand) {
       issues.push(`${service.key}: scheduled Railway services require railway.startCommand in treeseed.site.yaml.`);
     }
-    if (service.schedule?.length && !service.serviceId) {
-      issues.push(`${service.key}: scheduled Railway services require railway.serviceId for Railway API reconciliation.`);
-    }
-    if (service.schedule?.length && !envValue("TREESEED_RAILWAY_ENVIRONMENT_ID")) {
-      issues.push(`${service.key}: scheduled Railway services require TREESEED_RAILWAY_ENVIRONMENT_ID to be configured.`);
-    }
   }
   if (issues.length > 0) {
     throw new Error(`Railway service configuration is incomplete:
@@ -288,6 +286,16 @@ async function ensureRailwayScheduledJobs(tenantRoot, scope, { dryRun = false, f
   const queries = defaultRailwayScheduleQueries();
   const results = [];
   for (const schedule of schedules) {
+    if (!schedule.serviceId || !schedule.environmentId) {
+      results.push({
+        ...schedule,
+        id: null,
+        status: "skipped_missing_identifiers",
+        enabled: schedule.enabled !== false,
+        command: schedule.command
+      });
+      continue;
+    }
     const variables = {
       projectId: schedule.projectId,
       serviceId: schedule.serviceId,
@@ -391,6 +399,15 @@ async function verifyRailwayScheduledJobs(tenantRoot, scope, { fetchImpl = fetch
   const queries = defaultRailwayScheduleQueries();
   const checks = [];
   for (const schedule of configured) {
+    if (!schedule.serviceId || !schedule.environmentId) {
+      checks.push({
+        ...schedule,
+        id: null,
+        ok: false,
+        status: "skipped_missing_identifiers"
+      });
+      continue;
+    }
     const listed = await railwayGraphqlRequest({
       query: queries.listQuery,
       variables: {
@@ -410,7 +427,8 @@ async function verifyRailwayScheduledJobs(tenantRoot, scope, { fetchImpl = fetch
       id: existing?.id ?? null,
       ok: Boolean(
         existing && existing.expression === schedule.expression && (existing.command ?? null) === (schedule.command ?? null) && existing.enabled !== false
-      )
+      ),
+      status: existing ? "checked" : "missing"
     });
   }
   return {

package/dist/operations/services/runtime-tools.d.ts

@@ -37,13 +37,24 @@ export declare function loadCliDeployConfig(tenantRoot: any): {
     contactEmail: string;
     hosting: {
         kind: string;
-        registration: string;
-        marketBaseUrl: string | undefined;
-        teamId: string | undefined;
-        projectId: string | undefined;
-    } | undefined;
+        registration: any;
+        marketBaseUrl: any;
+        teamId: any;
+        projectId: any;
+    };
+    hub: {
+        mode: string;
+    };
+    runtime: {
+        mode: string;
+        registration: any;
+        marketBaseUrl: any;
+        teamId: any;
+        projectId: any;
+    };
     cloudflare: {
         accountId: string;
+        zoneId: string | undefined;
         workerName: string | undefined;
         queueName: string | undefined;
         dlqName: string | undefined;
@@ -88,9 +99,45 @@ export declare function loadCliDeployConfig(tenantRoot: any): {
             runtime: string;
             publish: string;
             docs: string;
+            serving: any;
         };
         site: string;
     };
+    surfaces: {
+        [k: string]: {
+            enabled: boolean | undefined;
+            provider: string | undefined;
+            rootDir: string | undefined;
+            publicBaseUrl: string | undefined;
+            localBaseUrl: string | undefined;
+            cache: {
+                sourcePages: {
+                    browserTtlSeconds: number | undefined;
+                    edgeTtlSeconds: number | undefined;
+                    staleWhileRevalidateSeconds: number | undefined;
+                    staleIfErrorSeconds: number | undefined;
+                } | {
+                    paths: any[];
+                } | undefined;
+                contentPages: {
+                    browserTtlSeconds: number | undefined;
+                    edgeTtlSeconds: number | undefined;
+                    staleWhileRevalidateSeconds: number | undefined;
+                    staleIfErrorSeconds: number | undefined;
+                } | {
+                    paths: any[];
+                } | undefined;
+                r2PublishedObjects: {
+                    browserTtlSeconds: number | undefined;
+                    edgeTtlSeconds: number | undefined;
+                    staleWhileRevalidateSeconds: number | undefined;
+                    staleIfErrorSeconds: number | undefined;
+                } | {
+                    paths: any[];
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
     services: {
         [k: string]: {
             enabled: boolean | undefined;