@treeseed/sdk 0.6.50 → 0.6.51

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

@@ -1230,7 +1230,11 @@ 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, settleDeployments: true }),
+    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,
+      onProgress: options.write
+    }),
     readiness: state.readiness
   };
   const resolvedChecks = {

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

@@ -13,7 +13,7 @@ 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, }?: {
+export declare function waitForRailwayManagedDeploymentsSettled(tenantRoot: any, scope: any, { services, env, timeoutMs, pollMs, onProgress, }?: {
     services?: ({
         key: string;
         scope: string;
@@ -319,7 +319,7 @@ export declare function verifyRailwayScheduledJobs(tenantRoot: any, scope: any,
     unsupported?: undefined;
     message?: undefined;
 }>;
-export declare function verifyRailwayManagedResources(tenantRoot: any, scope: any, { fetchImpl, apiToken, apiUrl, env, settleDeployments, settleTimeoutMs, settlePollMs, }?: {
+export declare function verifyRailwayManagedResources(tenantRoot: any, scope: any, { fetchImpl, apiToken, apiUrl, env, settleDeployments, settleTimeoutMs, settlePollMs, onProgress, }?: {
     fetchImpl?: typeof fetch | undefined;
     env?: NodeJS.ProcessEnv | undefined;
     settleDeployments?: boolean | undefined;

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

@@ -112,6 +112,21 @@ function railwayStatusDeploymentSettled(status) {
   const normalized = String(status ?? "").trim().toUpperCase();
   return normalized === "SUCCESS" || normalized === "SLEEPING";
 }
+function formatRailwayDeploymentStatusSummary(scope, checks) {
+  const aliases = {
+    api: "api",
+    workdayManager: "manager",
+    workerRunner: "runner"
+  };
+  const parts = checks.map((check) => {
+    const name = aliases[check.service] ?? String(check.serviceName ?? check.service ?? "service");
+    const status = String(check.status ?? "unknown").toUpperCase();
+    const instanceStatuses = Array.isArray(check.observed?.instanceStatuses) && check.observed.instanceStatuses.length > 0 ? `/${check.observed.instanceStatuses.join("+")}` : "";
+    const stopped = check.observed?.deploymentStopped === true ? "/stopped" : "";
+    return `${name}=${status}${instanceStatuses}${stopped}`;
+  });
+  return `[railway][monitor][${scope}] ${parts.join(" ")}`;
+}
 function collectRailwayDeploymentStatusChecks(statusPayload, scope, services) {
   const expectedEnvironment = resolveRailwayEnvironmentForScope(scope);
   const environments = railwayStatusEnvironmentNodes(statusPayload);
@@ -394,7 +409,8 @@ async function waitForRailwayManagedDeploymentsSettled(tenantRoot, scope, {
   services = configuredRailwayServices(tenantRoot, scope),
   env = process.env,
   timeoutMs = 6e5,
-  pollMs = 15e3
+  pollMs = 15e3,
+  onProgress
 } = {}) {
   const deadline = Date.now() + timeoutMs;
   const projectId = services.find((service) => typeof service.projectId === "string" && service.projectId.trim())?.projectId ?? null;
@@ -414,6 +430,7 @@ async function waitForRailwayManagedDeploymentsSettled(tenantRoot, scope, {
   }
   let checks = [];
   let lastError = null;
+  let lastSummary = "";
   for (; ; ) {
     lastError = null;
     try {
@@ -434,6 +451,11 @@ async function waitForRailwayManagedDeploymentsSettled(tenantRoot, scope, {
         message: error instanceof Error ? error.message : String(error)
       }));
     }
+    const summary = formatRailwayDeploymentStatusSummary(scope, checks);
+    if (summary !== lastSummary || !checks.every((entry) => entry.ok === true)) {
+      onProgress?.(summary, "stdout");
+      lastSummary = summary;
+    }
     if (checks.every((entry) => entry.ok === true)) {
       return { ok: true, checks };
     }
@@ -1017,7 +1039,8 @@ async function verifyRailwayManagedResources(tenantRoot, scope, {
   env = process.env,
   settleDeployments = false,
   settleTimeoutMs = 6e5,
-  settlePollMs = 15e3
+  settlePollMs = 15e3,
+  onProgress
 } = {}) {
   const effectiveApiToken = apiToken || resolveRailwayAuthToken(env);
   const effectiveApiUrl = apiUrl || resolveRailwayApiUrl(env);
@@ -1129,7 +1152,8 @@ async function verifyRailwayManagedResources(tenantRoot, scope, {
       services: deploymentStatusServices.length > 0 ? deploymentStatusServices : services,
       env: effectiveEnv,
       timeoutMs: settleTimeoutMs,
-      pollMs: settlePollMs
+      pollMs: settlePollMs,
+      onProgress
     });
     for (const check of settled.checks ?? []) {
       checks.push(check);

package/dist/workflow/operations.js

@@ -2923,8 +2923,10 @@ async function workflowSave(helpers, input) {
       if (autoResumeRun) {
         helpers.write(`[workflow][resume] Resuming interrupted save ${autoResumeRun.runId} on ${branch}.`);
       }
+      helpers.write(`[save][workflow] Preparing save on ${branch} (${mode}, ${scope}).`);
       try {
         const saveResult = await executeJournalStep(root, workflowRun.runId, "save-repositories", () => (async () => {
+          helpers.write("[save][workflow] Saving repositories and validating lockfiles.");
           unlinkWorkflowWorkspaceLinks(root, helpers, effectiveInput.workspaceLinks ?? "auto");
           try {
             return await runRepositorySaveOrchestrator({
@@ -2948,6 +2950,7 @@ async function workflowSave(helpers, input) {
         })());
         const savedPackageReports = saveResult?.repos ?? packageReports;
         const savedRootRepo = saveResult?.rootRepo ?? rootRepo;
+        helpers.write("[save][workflow] Repository save phase complete; checking command readiness.");
         const head = savedRootRepo.commitSha ?? run("git", ["rev-parse", "HEAD"], { cwd: gitRoot, capture: true }).trim();
         const commitCreated = savedRootRepo.committed === true;
         const branchSync = {
@@ -2964,34 +2967,38 @@ async function workflowSave(helpers, input) {
             lockfileValidation: repo.lockfileValidation
           }))
         };
-        const saveWorkflowGates = shouldUseHostedSaveCi(effectiveInput) ? await executeJournalStep(root, workflowRun.runId, "hosted-ci", () => waitForWorkflowGates("save", [
-          ...savedRootRepo.pushed && savedRootRepo.commitSha && branch ? [{
-            name: savedRootRepo.name,
-            repoPath: savedRootRepo.path,
-            workflow: "verify.yml",
-            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,
-            workflow: "verify.yml",
-            branch: String(repo.branch),
-            headSha: String(repo.commitSha)
-          }))
-        ], "hosted", {
-          root,
-          runId: workflowRun.runId,
-          onProgress: (line, stream) => helpers.write(line, stream)
-        }).then((workflowGates) => ({ workflowGates }))) : { workflowGates: [] };
+        const saveWorkflowGates = shouldUseHostedSaveCi(effectiveInput) ? await executeJournalStep(root, workflowRun.runId, "hosted-ci", () => {
+          helpers.write("[save][workflow] Waiting for hosted save workflow gates.");
+          return waitForWorkflowGates("save", [
+            ...savedRootRepo.pushed && savedRootRepo.commitSha && branch ? [{
+              name: savedRootRepo.name,
+              repoPath: savedRootRepo.path,
+              workflow: "verify.yml",
+              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,
+              workflow: "verify.yml",
+              branch: String(repo.branch),
+              headSha: String(repo.commitSha)
+            }))
+          ], "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", () => {
+          helpers.write("[save][workflow] Running staging release-candidate readiness checks.");
           const releaseSession = resolveTreeseedWorkflowSession(root);
           const stagingReleasePlan = buildReleasePlanSnapshot({
             root,

package/package.json

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