@treeseed/sdk 0.10.23 → 0.10.25

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

@@ -3,6 +3,7 @@ import { spawnSync } from "node:child_process";
 import { mkdtempSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { basename, extname, join, resolve } from "node:path";
+import { elapsedMs, formatTimingMarkdown, formatTimingSummary } from "../../timing.js";
 import {
   createControlPlaneReporter
 } from "../../control-plane.js";
@@ -52,6 +53,39 @@ const PROCESSING_PLATFORM_BOOTSTRAP_SYSTEMS = ["api", "agents"];
 function stableHash(value) {
   return createHash("sha256").update(value).digest("hex");
 }
+function recordTiming(timings, name, startMs, status = "success", metadata) {
+  const entry = {
+    name,
+    durationMs: elapsedMs(startMs),
+    status,
+    ...metadata ? { metadata } : {}
+  };
+  timings.push(entry);
+  return entry;
+}
+async function timedPhase(timings, name, run, metadata) {
+  const startMs = performance.now();
+  try {
+    const result = await Promise.resolve(run());
+    recordTiming(timings, name, startMs, "success", metadata);
+    return result;
+  } catch (error) {
+    recordTiming(timings, name, startMs, "failed", {
+      ...metadata ?? {},
+      error: error instanceof Error ? error.message : String(error)
+    });
+    throw error;
+  }
+}
+function writeProviderTimingSummary(options, timings) {
+  const text = formatTimingSummary(timings);
+  options.write?.(text);
+  const summaryPath = String(options.env?.TREESEED_PROVIDER_TIMING_SUMMARY_PATH ?? process.env.TREESEED_PROVIDER_TIMING_SUMMARY_PATH ?? "").trim();
+  if (!summaryPath) {
+    return;
+  }
+  writeFileSync(summaryPath, formatTimingMarkdown(timings), { flag: "a" });
+}
 function inferEnvironmentFromBranch(tenantRoot) {
   const branch = currentManagedBranch(tenantRoot);
   if (branch === STAGING_BRANCH) {
@@ -1024,25 +1058,30 @@ async function publishContent(options, reporter, publishOptions = {}) {
   }
 }
 async function provisionProjectPlatform(options) {
+  const timings = [];
   const reporter = resolveReporter(options.tenantRoot, options.reporter);
   const target = createPersistentDeployTarget(options.scope === "local" ? "staging" : options.scope);
   const siteConfig = loadCliDeployConfig(options.tenantRoot);
   const bootstrapSystems = resolveProjectPlatformBootstrapSystems(options, siteConfig);
   const selectedSystems = new Set(bootstrapSystems);
   const env = { ...process.env, ...options.env ?? {} };
-  const summary = await reconcileTreeseedTarget({
+  const summary = await timedPhase(timings, "provision:reconcile", () => reconcileTreeseedTarget({
     tenantRoot: options.tenantRoot,
     target,
     env,
-    systems: bootstrapSystems
-  });
-  const verification = await collectTreeseedReconcileStatus({
+    systems: bootstrapSystems,
+    write: options.write
+  }));
+  timings.push(...summary.timings ?? []);
+  const verification = await timedPhase(timings, "provision:collect-reconcile-status", () => collectTreeseedReconcileStatus({
     tenantRoot: options.tenantRoot,
     target,
     env,
     systems: bootstrapSystems
+  }));
+  await timedPhase(timings, "provision:ensure-wrangler-config", () => {
+    ensureGeneratedWranglerConfig(options.tenantRoot, { target });
   });
-  ensureGeneratedWranglerConfig(options.tenantRoot, { target });
   const shouldValidateRailway = selectedSystems.has("api") || selectedSystems.has("agents");
   const railwayValidation = shouldValidateRailway ? options.scope === "local" ? validateRailwayServiceConfiguration(options.tenantRoot, options.scope) : validateRailwayDeployPrerequisites(options.tenantRoot, options.scope, { env }) : { services: [] };
   const railwaySchedules = [];
@@ -1173,6 +1212,7 @@ async function provisionProjectPlatform(options) {
       target: deployTargetLabel(target),
       summary,
       verification,
+      timings,
       reconcileActions: summary.results.map((result) => ({
         unitId: result.unit.unitId,
         action: result.action,
@@ -1190,6 +1230,7 @@ async function provisionProjectPlatform(options) {
     target: deployTargetLabel(target),
     summary,
     verification,
+    timings,
     railway: {
       services: railwayValidation.services.map((service) => service.key),
       schedules: railwaySchedules,
@@ -1198,6 +1239,8 @@ async function provisionProjectPlatform(options) {
   };
 }
 async function deployProjectPlatform(options) {
+  const timings = [];
+  const deployStartMs = performance.now();
   const reporter = resolveReporter(options.tenantRoot, options.reporter);
   const commitSha = currentCommit(options.tenantRoot);
   const branchName = currentRef(options.tenantRoot);
@@ -1216,7 +1259,8 @@ async function deployProjectPlatform(options) {
     metadata: { scope: options.scope }
   });
   if (!options.skipProvision) {
-    await provisionProjectPlatform({ ...options, reporter, bootstrapSystems });
+    const provision = await timedPhase(timings, "deploy:provision", () => provisionProjectPlatform({ ...options, reporter, bootstrapSystems }));
+    timings.push(...provision.timings ?? []);
   }
   const nodes = [];
   let cloudflareContext = null;
@@ -1276,6 +1320,7 @@ async function deployProjectPlatform(options) {
     const selectedServices = validation.services.filter(
       (service) => service.key === "api" ? selectedSystems.has("api") : selectedSystems.has("agents")
     );
+    const sequentialRailwayDeploys = String(env.TREESEED_RAILWAY_DEPLOY_SEQUENTIAL ?? "").trim() === "1";
     let previousRailwayDeployNodeId = null;
     for (const service of selectedServices) {
       const system = service.key === "api" ? "api" : "agents";
@@ -1285,7 +1330,8 @@ async function deployProjectPlatform(options) {
         id: nodeId,
         dependencies: resolveRailwayServiceDeployDependencies({
           includeDataDependency: selectedSystems.has("data"),
-          previousRailwayDeployNodeId
+          previousRailwayDeployNodeId,
+          sequentialRailwayDeploys
         }),
         run: async () => {
           const result = await deployRailwayService(options.tenantRoot, service, {
@@ -1303,7 +1349,9 @@ async function deployProjectPlatform(options) {
           return result;
         }
       });
-      previousRailwayDeployNodeId = nodeId;
+      if (sequentialRailwayDeploys) {
+        previousRailwayDeployNodeId = nodeId;
+      }
     }
   }
   const managesRailwaySchedules = options.scope === "staging" || options.scope === "prod";
@@ -1335,8 +1383,11 @@ async function deployProjectPlatform(options) {
       }
     });
   }
-  await runTreeseedBootstrapDag({ nodes, execution });
+  await runTreeseedBootstrapDag({ nodes, execution, write, timings });
   const serviceResults = selectedRailwayServiceKeys.map((serviceKey) => serviceResultsByKey.get(serviceKey)).filter(Boolean);
+  for (const result of serviceResults) {
+    timings.push(...result.timings ?? []);
+  }
   if (options.scope !== "local" && !options.dryRun && (selectedSystems.has("web") || serviceResults.length > 0)) {
     finalizeDeploymentState(options.tenantRoot, {
       target: createPersistentDeployTarget(options.scope),
@@ -1358,8 +1409,11 @@ async function deployProjectPlatform(options) {
       scheduleVerification: railwayScheduleVerification
     });
   }
-  const monitor = await monitorProjectPlatform({ ...options, reporter, bootstrapSystems });
-  const hostingRepair = await repairHostingAfterSuccessfulDeploy(options, bootstrapSystems);
+  const monitor = await timedPhase(timings, "deploy:monitor", () => monitorProjectPlatform({ ...options, reporter, bootstrapSystems }));
+  timings.push(...monitor.timings ?? []);
+  const hostingRepair = await timedPhase(timings, "deploy:hosting-repair", () => repairHostingAfterSuccessfulDeploy(options, bootstrapSystems));
+  recordTiming(timings, "deploy:total", deployStartMs);
+  writeProviderTimingSummary(options, timings);
   await reportDeployment(reporter, {
     environment: options.scope,
     deploymentKind: "code",
@@ -1371,7 +1425,8 @@ async function deployProjectPlatform(options) {
       scope: options.scope,
       railway: options.scope === "local" ? [] : configuredRailwayServices(options.tenantRoot, options.scope).map((service) => service.key).filter((serviceKey) => serviceKey === "api" ? selectedSystems.has("api") : selectedSystems.has("agents")),
       monitor,
-      hostingRepair
+      hostingRepair,
+      timings
     },
     finishedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
@@ -1380,16 +1435,18 @@ async function deployProjectPlatform(options) {
     scope: options.scope,
     monitor,
     hostingRepair,
-    serviceResults
+    serviceResults,
+    timings
   };
 }
 function resolveRailwayServiceDeployDependencies({
   includeDataDependency,
-  previousRailwayDeployNodeId
+  previousRailwayDeployNodeId,
+  sequentialRailwayDeploys = false
 }) {
   return [
     ...includeDataDependency ? ["data:d1-migrate"] : [],
-    ...previousRailwayDeployNodeId ? [previousRailwayDeployNodeId] : []
+    ...sequentialRailwayDeploys && previousRailwayDeployNodeId ? [previousRailwayDeployNodeId] : []
   ];
 }
 async function publishProjectContent(options) {
@@ -1397,6 +1454,7 @@ async function publishProjectContent(options) {
   return publishContent(options, reporter);
 }
 async function monitorProjectPlatform(options) {
+  const timings = [];
   const reporter = resolveReporter(options.tenantRoot, options.reporter);
   const env = { ...process.env, ...options.env ?? {} };
   const target = createPersistentDeployTarget(options.scope === "local" ? "staging" : options.scope);
@@ -1408,24 +1466,24 @@ async function monitorProjectPlatform(options) {
   const webProbeUrl = resolveImmediatePagesProbeUrl(siteConfig, state, target);
   const apiBaseUrl = resolveImmediateApiProbeUrl(siteConfig, state, target);
   const apiMonitorEndpoints = resolveApiMonitorEndpoints(siteConfig, apiBaseUrl);
-  const railwayResources = options.scope === "local" || !apiSelected && !agentsSelected ? { ok: true, skipped: true, reason: options.scope === "local" ? "local_scope" : "railway_not_selected" } : await verifyRailwayManagedResources(options.tenantRoot, options.scope, {
+  const railwayResourcesPromise = options.scope === "local" || !apiSelected && !agentsSelected ? { ok: true, skipped: true, reason: options.scope === "local" ? "local_scope" : "railway_not_selected" } : timedPhase(timings, "monitor:railway-resources", () => verifyRailwayManagedResources(options.tenantRoot, options.scope, {
     env,
     settleDeployments: true,
     onProgress: options.write
-  });
+  }));
   const skippedApiCheck = apiSelected ? { ok: false, skipped: true, reason: "api_url_unconfigured" } : { ok: true, skipped: true, reason: "api_not_selected" };
   const skippedAgentCheck = agentsSelected ? { ok: false, skipped: true, reason: "api_url_unconfigured" } : { ok: true, skipped: true, reason: "agents_not_selected" };
   const skippedD1Check = apiMonitorEndpoints.processingAgentApi ? { ok: true, skipped: true, reason: "processing_agent_api" } : skippedApiCheck;
   const checks = {
-    pages: await probeHttp(webProbeUrl, { attempts: 3, delayMs: 5e3 }),
-    apiHealth: apiSelected && apiMonitorEndpoints.apiHealth ? await probeHttp(apiMonitorEndpoints.apiHealth, { attempts: 8, delayMs: 1e4 }) : skippedApiCheck,
-    apiReady: apiSelected && apiMonitorEndpoints.apiReady ? await probeHttp(apiMonitorEndpoints.apiReady, { attempts: 8, delayMs: 1e4 }) : skippedApiCheck,
-    d1Health: apiSelected && apiMonitorEndpoints.d1Health ? await probeHttp(apiMonitorEndpoints.d1Health, { attempts: 8, delayMs: 1e4 }) : skippedD1Check,
-    agentHealth: agentsSelected && apiMonitorEndpoints.agentHealth ? await probeHttp(apiMonitorEndpoints.agentHealth, { attempts: 8, delayMs: 1e4 }) : skippedAgentCheck,
-    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,
+    pages: timedPhase(timings, "monitor:probe-pages", () => probeHttp(webProbeUrl, { attempts: 3, delayMs: 5e3 })),
+    apiHealth: apiSelected && apiMonitorEndpoints.apiHealth ? timedPhase(timings, "monitor:probe-api-health", () => probeHttp(apiMonitorEndpoints.apiHealth, { attempts: 8, delayMs: 1e4 })) : Promise.resolve(skippedApiCheck),
+    apiReady: apiSelected && apiMonitorEndpoints.apiReady ? timedPhase(timings, "monitor:probe-api-ready", () => probeHttp(apiMonitorEndpoints.apiReady, { attempts: 8, delayMs: 1e4 })) : Promise.resolve(skippedApiCheck),
+    d1Health: apiSelected && apiMonitorEndpoints.d1Health ? timedPhase(timings, "monitor:probe-d1-health", () => probeHttp(apiMonitorEndpoints.d1Health, { attempts: 8, delayMs: 1e4 })) : Promise.resolve(skippedD1Check),
+    agentHealth: agentsSelected && apiMonitorEndpoints.agentHealth ? timedPhase(timings, "monitor:probe-agent-health", () => probeHttp(apiMonitorEndpoints.agentHealth, { attempts: 8, delayMs: 1e4 })) : Promise.resolve(skippedAgentCheck),
+    r2: options.dryRun ? Promise.resolve({ ok: true, skipped: true, reason: "dry_run" }) : timedPhase(timings, "monitor:probe-r2", () => probeR2(options.tenantRoot, siteConfig, state, target)),
+    queue: options.dryRun ? Promise.resolve({ ok: true, skipped: true, reason: "dry_run" }) : timedPhase(timings, "monitor:probe-queue", () => probeQueue(siteConfig, state)),
+    scaleProbe: timedPhase(timings, "monitor:probe-scale", () => probeScaleConfiguration(siteConfig, state)),
+    railwayResources: Promise.resolve(railwayResourcesPromise),
     readiness: state.readiness,
     apiMonitor: {
       ok: true,
@@ -1435,8 +1493,15 @@ async function monitorProjectPlatform(options) {
   };
   const resolvedChecks = {
     ...checks,
+    pages: await checks.pages,
+    apiHealth: await checks.apiHealth,
+    apiReady: await checks.apiReady,
+    d1Health: await checks.d1Health,
+    agentHealth: await checks.agentHealth,
     r2: await checks.r2,
-    queue: await checks.queue
+    queue: await checks.queue,
+    scaleProbe: await checks.scaleProbe,
+    railwayResources: await checks.railwayResources
   };
   const ok = [
     resolvedChecks.pages,
@@ -1464,14 +1529,16 @@ ${failedChecks.join("\n")}`);
     metadata: {
       mode: "monitor",
       target: deployTargetLabel(target),
-      checks: resolvedChecks
+      checks: resolvedChecks,
+      timings
     },
     finishedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
   return {
     ok,
     target: deployTargetLabel(target),
-    checks: resolvedChecks
+    checks: resolvedChecks,
+    timings
   };
 }
 async function syncControlPlaneState(options) {

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

@@ -1,4 +1,5 @@
 import { type TreeseedBootstrapTaskPrefix, type TreeseedBootstrapWriter } from './bootstrap-runner.ts';
+import { type TreeseedTimingEntry } from '../../timing.ts';
 export declare function deriveRailwayWorkerRunnerServiceName(projectSlug: any, index?: number): string;
 export declare function deriveRailwayMarketOperationsRunnerServiceName(baseServiceName: any, index?: number): string;
 export declare function deriveRailwayWorkerRunnerVolumeName(serviceName: any, environmentName?: string): string;
@@ -31,18 +32,47 @@ export declare function runRailway(args: any, { cwd, capture, allowFailure, inpu
     retryAttempts?: number | undefined;
     retryDelayMs?: number | undefined;
 }): import("child_process").SpawnSyncReturns<string> | null;
-export declare function waitForRailwayManagedDeploymentsSettled(tenantRoot: any, scope: any, { services, env, timeoutMs, pollMs, onProgress, }?: {
+export declare function waitForRailwayManagedDeploymentsSettled(tenantRoot: any, scope: any, { services, env, timeoutMs, pollMs, fetchImpl, onProgress, }?: {
     services?: unknown[] | undefined;
     env?: NodeJS.ProcessEnv | undefined;
     timeoutMs?: number | undefined;
     pollMs?: number | undefined;
+    fetchImpl?: typeof fetch | undefined;
 }): Promise<{
+    ok: boolean;
+    checks: {
+        type: string;
+        service: any;
+        serviceName: any;
+        environment: string;
+        ok: boolean;
+        status: string;
+        settle: {
+            durationMs: number;
+            pollCount: number;
+            finalStatus: string;
+        };
+        message: string;
+    }[];
+    settle?: undefined;
+    message?: undefined;
+} | {
     ok: boolean;
     checks: any;
+    settle: {
+        durationMs: number;
+        pollCount: number;
+        status: string;
+    };
     message?: undefined;
 } | {
     ok: boolean;
     checks: any;
+    settle: {
+        durationMs: number;
+        pollCount: number;
+        status: string;
+    };
     message: string;
 }>;
 export declare function setRailwaySecretVariable({ cwd, service, environment, key, value, env, capture, allowFailure }: {
@@ -182,6 +212,7 @@ export declare function deployRailwayService(tenantRoot: any, service: any, { dr
     command: string;
     cwd: any;
     publicBaseUrl: any;
+    timings: TreeseedTimingEntry[];
     runtimeConfiguration?: undefined;
 } | {
     service: any;
@@ -189,6 +220,7 @@ export declare function deployRailwayService(tenantRoot: any, service: any, { dr
     command: string;
     cwd: any;
     publicBaseUrl: any;
+    timings: TreeseedTimingEntry[];
     runtimeConfiguration: {
         updated: boolean;
         healthcheckPath: string | null;