@treeseed/sdk 0.12.32 → 0.12.34

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

@@ -111,11 +111,12 @@ export declare function verifyRailwayManagedResources(tenantRoot: any, scope: an
     checks: any[];
 }>;
 export declare function shouldRunRailwayPredeployBuild(env?: NodeJS.ProcessEnv): boolean;
-export declare function deployRailwayService(tenantRoot: any, service: any, { planOnly, write, prefix, env, }?: {
+export declare function deployRailwayService(tenantRoot: any, service: any, { planOnly, write, prefix, env, fetchImpl, }?: {
     planOnly?: boolean;
     write?: TreeseedBootstrapWriter;
     prefix?: TreeseedBootstrapTaskPrefix;
     env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
+    fetchImpl?: typeof fetch;
 }): Promise<{
     service: any;
     status: string;

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

@@ -452,7 +452,7 @@ async function waitForRailwayManagedDeploymentsSettled(tenantRoot, scope, {
 } = {}) {
   const startMs = performance.now();
   const deadline = Date.now() + timeoutMs;
-  const projectId = services.find((service) => typeof service.projectId === "string" && service.projectId.trim())?.projectId ?? null;
+  const projectId = await resolveRailwayDeploymentProjectId(services, { env, fetchImpl });
   if (!projectId) {
     return {
       ok: false,
@@ -571,6 +571,23 @@ async function waitForRailwayManagedDeploymentsSettled(tenantRoot, scope, {
     await sleep(pollMs);
   }
 }
+async function resolveRailwayDeploymentProjectId(services, { env = process.env, fetchImpl = fetch } = {}) {
+  const configuredProjectId = services.find((service) => typeof service.projectId === "string" && service.projectId.trim())?.projectId?.trim();
+  if (configuredProjectId) {
+    return configuredProjectId;
+  }
+  const projectName = services.find((service) => typeof service.projectName === "string" && service.projectName.trim())?.projectName?.trim();
+  if (!projectName) {
+    return null;
+  }
+  try {
+    const workspace = await resolveRailwayWorkspaceContext({ env, fetchImpl });
+    const projects = await listRailwayProjects({ env, workspaceId: workspace.id, fetchImpl });
+    return projects.find((project) => project.name === projectName)?.id ?? null;
+  } catch {
+    return null;
+  }
+}
 async function fetchRailwayProjectDeploymentStatus({ projectId, env = process.env, fetchImpl = fetch }) {
   const payload = await railwayGraphqlRequest({
     query: `
@@ -1362,7 +1379,7 @@ function shouldRunRailwayPredeployBuild(env = process.env) {
   }
   return configuredEnvValue(env, "CI") !== "true";
 }
-async function syncRailwayApiDeviceLoginVariables(service, env, write, prefix) {
+async function syncRailwayApiDeviceLoginVariables(service, env, write, prefix, fetchImpl = fetch) {
   if (service.key !== "api") {
     return null;
   }
@@ -1387,22 +1404,24 @@ async function syncRailwayApiDeviceLoginVariables(service, env, write, prefix) {
     environmentId,
     serviceId,
     variables,
-    env
+    env,
+    fetchImpl
   });
   write ? write(`[${prefix.scope}][${prefix.system}][${prefix.task}][vars] Synced device login approval URL variables for ${service.serviceName ?? serviceId}.`, "stdout") : null;
   return { variables: Object.keys(variables) };
 }
-async function resolveRailwayDeployProjectContext(service, { env = process.env } = {}) {
+async function resolveRailwayDeployProjectContext(service, { env = process.env, fetchImpl = fetch } = {}) {
   if (service.projectId) {
     return service;
   }
-  const workspace = await resolveRailwayWorkspaceContext({ env });
+  const workspace = await resolveRailwayWorkspaceContext({ env, fetchImpl });
   const { project } = await ensureRailwayProject({
     projectId: service.projectId,
     projectName: service.projectName,
     defaultEnvironmentName: service.railwayEnvironment,
     env,
-    workspace: workspace.id
+    workspace: workspace.id,
+    fetchImpl
   });
   return {
     ...service,
@@ -1410,7 +1429,7 @@ async function resolveRailwayDeployProjectContext(service, { env = process.env }
     projectName: project.name ?? service.projectName
   };
 }
-async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, service, { env = process.env, writePhase = null } = {}) {
+async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, service, { env = process.env, writePhase = null, fetchImpl = fetch } = {}) {
   const writeSyncPhase = (stage, message) => {
     if (typeof writePhase === "function") {
       writePhase(`sync-runtime-config:${stage}`, message);
@@ -1423,7 +1442,7 @@ async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, ser
     return null;
   }
   writeSyncPhase("workspace", "Resolving Railway workspace.");
-  const workspace = await resolveRailwayWorkspaceContext({ env });
+  const workspace = await resolveRailwayWorkspaceContext({ env, fetchImpl });
   let project = null;
   if (service.projectId) {
     writeSyncPhase("project", `Resolving Railway project ${service.projectName ?? service.projectId}.`);
@@ -1432,11 +1451,12 @@ async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, ser
       projectName: service.projectName,
       defaultEnvironmentName: service.railwayEnvironment,
       env,
-      workspace: workspace.id
+      workspace: workspace.id,
+      fetchImpl
     }).then((result) => result.project);
   } else {
     writeSyncPhase("project", `Looking up Railway project ${service.projectName}.`);
-    const projects = await listRailwayProjects({ env, workspaceId: workspace.id });
+    const projects = await listRailwayProjects({ env, workspaceId: workspace.id, fetchImpl });
     project = projects.find((entry) => entry.name === service.projectName) ?? null;
     if (!project) {
       writeSyncPhase("project", `Creating Railway project ${service.projectName}.`);
@@ -1444,7 +1464,8 @@ async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, ser
         projectName: service.projectName,
         defaultEnvironmentName: service.railwayEnvironment,
         env,
-        workspace: workspace.id
+        workspace: workspace.id,
+        fetchImpl
       }).then((result) => result.project);
     }
   }
@@ -1455,7 +1476,8 @@ async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, ser
     environment = await ensureRailwayEnvironment({
       projectId: project.id,
       environmentName,
-      env
+      env,
+      fetchImpl
     }).then((result) => result.environment);
   }
   let railwayService = project.services.find((entry) => entry.id === service.serviceId || entry.name === service.serviceName) ?? null;
@@ -1469,9 +1491,10 @@ async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, ser
       imageRef: service.imageRef,
       sourceRepo: service.sourceRepo,
       sourceBranch: service.sourceBranch,
-      env
+      env,
+      fetchImpl
     }).then((result) => result.service);
-  } else if (service.imageRef) {
+  } else if (service.imageRef || service.sourceRepo) {
     railwayService = await ensureRailwayService({
       projectId: project.id,
       serviceId: service.serviceId,
@@ -1480,7 +1503,8 @@ async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, ser
       imageRef: service.imageRef,
       sourceRepo: service.sourceRepo,
       sourceBranch: service.sourceBranch,
-      env
+      env,
+      fetchImpl
     }).then((result) => result.service);
   }
   if (wantsInstanceConfig) {
@@ -1499,7 +1523,8 @@ async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, ser
     restartPolicy: service.restartPolicy,
     runtimeMode: service.runtimeMode,
     deploymentRegion: wantsRunnerVolume ? configuredEnvValue(env, "TREESEED_RAILWAY_STATEFUL_REGION") || "us-west2" : null,
-    env
+    env,
+    fetchImpl
   }) : null;
   writeSyncPhase("variables", "Upserting Railway runtime variables.");
   await upsertRailwayVariables({
@@ -1544,7 +1569,8 @@ async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, ser
         ...configuredEnvValue(env, "TREESEED_CODEX_AUTH_JSON_B64") ? { TREESEED_CODEX_AUTH_JSON_B64: configuredEnvValue(env, "TREESEED_CODEX_AUTH_JSON_B64") } : {}
       } : {}
     },
-    env
+    env,
+    fetchImpl
   });
   const volumeMountPath = service.volumeMountPath ?? service.runnerPool?.volumeMountPath ?? WORKER_RUNNER_VOLUME_MOUNT_PATH;
   if (wantsRunnerVolume) {
@@ -1556,7 +1582,8 @@ async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, ser
     serviceId: railwayService.id,
     name: service.key === "operationsRunner" ? deriveRailwayOperationsRunnerVolumeName(railwayService.name, environment.name) : service.key === "capacityProviderRunner" ? deriveRailwayCapacityProviderRunnerVolumeName(railwayService.name, environment.name) : deriveRailwayWorkerRunnerVolumeName(railwayService.name, environment.name),
     mountPath: volumeMountPath,
-    env
+    env,
+    fetchImpl
   }) : null;
   if (wantsRunnerVolume) {
     if (service.key === "workerRunner") {
@@ -1572,7 +1599,8 @@ async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, ser
           TREESEED_WORKER_IDLE_EXIT_MS: configuredEnvValue(env, "TREESEED_WORKER_IDLE_EXIT_MS") || "60000",
           ...volumeConfiguration?.volume.id ? { TREESEED_RUNNER_VOLUME_ID: volumeConfiguration.volume.id } : {}
         },
-        env
+        env,
+        fetchImpl
       });
     }
   }
@@ -1599,7 +1627,8 @@ async function deployRailwayService(tenantRoot, service, {
   planOnly = false,
   write,
   prefix,
-  env = process.env
+  env = process.env,
+  fetchImpl = fetch
 } = {}) {
   const timings = [];
   if (planOnly) {
@@ -1618,7 +1647,7 @@ async function deployRailwayService(tenantRoot, service, {
       }
     };
   }
-  const deployService = await timedRailwayPhase(timings, "railway:resolve-context", () => resolveRailwayDeployProjectContext(service, { env }), {
+  const deployService = await timedRailwayPhase(timings, "railway:resolve-context", () => resolveRailwayDeployProjectContext(service, { env, fetchImpl }), {
     service: service.key
   });
   const commandEnv = buildRailwayCommandEnv({ ...process.env, ...env });
@@ -1635,7 +1664,7 @@ async function deployRailwayService(tenantRoot, service, {
   writePhase("resolve-context", `Resolved Railway service ${deployService.serviceName ?? deployService.serviceId ?? deployService.key}.`);
   writePhase("sync-runtime-config", "Syncing Railway runtime configuration.");
   const runtimeConfiguration = await timedRailwayPhase(timings, "railway:sync-runtime-config", () => withRailwayPhaseTimeout(
-    () => syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, deployService, { env: commandEnv, writePhase }),
+    () => syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, deployService, { env: commandEnv, writePhase, fetchImpl }),
     railwayPhaseTimeoutMs(commandEnv, "sync_runtime_config"),
     `Railway runtime configuration sync timed out for ${deployService.serviceName ?? deployService.key}.`
   ), { service: deployService.key });
@@ -1650,7 +1679,7 @@ async function deployRailwayService(tenantRoot, service, {
   };
   writePhase("device-login-vars", "Syncing Railway device-login variables.");
   await timedRailwayPhase(timings, "railway:device-login-vars", () => withRailwayPhaseTimeout(
-    () => syncRailwayApiDeviceLoginVariables(cliDeployService, commandEnv, write, taskPrefix),
+    () => syncRailwayApiDeviceLoginVariables(cliDeployService, commandEnv, write, taskPrefix, fetchImpl),
     railwayPhaseTimeoutMs(commandEnv, "device_login_vars"),
     `Railway device-login variable sync timed out for ${cliDeployService.serviceName ?? cliDeployService.key}.`
   ), {
@@ -1673,7 +1702,8 @@ async function deployRailwayService(tenantRoot, service, {
       () => deployRailwayServiceInstance({
         serviceId: cliDeployService.serviceId,
         environmentId: cliDeployService.environmentId,
-        env: commandEnv
+        env: commandEnv,
+        fetchImpl
       }),
       railwayPhaseTimeoutMs(commandEnv, "deploy"),
       `Railway API deploy phase timed out for ${cliDeployService.serviceName ?? cliDeployService.key}.`

package/dist/operations/services/workspace-dependency-mode.d.ts

@@ -19,6 +19,7 @@ export type WorkspaceDependencyModeReport = {
     }>;
     created: string[];
     removed: string[];
+    preserved: string[];
     issues: string[];
 };
 export type DeploymentLockfileWorkspaceIssue = {
@@ -33,6 +34,7 @@ export declare function ensureLocalWorkspaceLinks(root?: any, options?: {
 }): {
     created: string[];
     removed: never[];
+    preserved: never[];
     mode: DependencyResolutionMode;
     enabled: boolean;
     root: string;
@@ -47,9 +49,11 @@ export declare function ensureLocalWorkspaceLinks(root?: any, options?: {
 export declare function unlinkLocalWorkspaceLinks(root?: any, options?: {
     mode?: WorkspaceLinksMode;
     env?: NodeJS.ProcessEnv;
+    preserveOperatorLinks?: boolean;
 }): {
     enabled: boolean;
     removed: string[];
+    preserved: string[];
     mode: DependencyResolutionMode;
     root: string;
     links: Array<WorkspaceLink & {

package/dist/operations/services/workspace-dependency-mode.js

@@ -110,6 +110,27 @@ function internalDependencyNames(packageJson, packageNames) {
   }
   return [...names].sort();
 }
+function operatorWorkspacePackageNames(packages) {
+  const packageByName = new Map(packages.map((pkg) => [String(pkg.name), pkg]));
+  const packageNames = new Set(packageByName.keys());
+  const roots = packages.filter((pkg) => {
+    const name = String(pkg.name ?? "");
+    if (name === "@treeseed/cli") return true;
+    return packageBinEntries(pkg.packageJson).some(([binName]) => binName === "trsd" || binName === "treeseed");
+  }).map((pkg) => String(pkg.name));
+  const closure = /* @__PURE__ */ new Set();
+  const visit = (packageName) => {
+    if (closure.has(packageName)) return;
+    const pkg = packageByName.get(packageName);
+    if (!pkg) return;
+    closure.add(packageName);
+    for (const dependencyName of internalDependencyNames(pkg.packageJson, packageNames)) {
+      visit(dependencyName);
+    }
+  };
+  for (const rootName of roots) visit(rootName);
+  return closure;
+}
 function dependencyNames(packageJson, filter) {
   const names = /* @__PURE__ */ new Set();
   if (!packageJson) return names;
@@ -306,7 +327,7 @@ function ensureLocalWorkspaceLinks(root = workspaceRoot(), options = {}) {
   const enabled = workspaceLinksEnabled(options.mode, options.env);
   const links = discoverWorkspaceLinks(root);
   const report = inspectWorkspaceDependencyMode(root, { mode: options.mode, env: options.env });
-  if (!enabled) return { ...report, enabled: false, created: [], removed: [] };
+  if (!enabled) return { ...report, enabled: false, created: [], removed: [], preserved: [] };
   ensureGitInfoExcludes(root, links);
   const managedLinks = readMetadata(root);
   const created = [];
@@ -325,7 +346,8 @@ function ensureLocalWorkspaceLinks(root = workspaceRoot(), options = {}) {
   return {
     ...inspectWorkspaceDependencyMode(root, { mode: options.mode, env: options.env }),
     created,
-    removed: []
+    removed: [],
+    preserved: []
   };
 }
 function unlinkLocalWorkspaceLinks(root = workspaceRoot(), options = {}) {
@@ -333,20 +355,30 @@ function unlinkLocalWorkspaceLinks(root = workspaceRoot(), options = {}) {
   const links = discoverWorkspaceLinks(root);
   const managedLinks = readMetadata(root);
   const removed = [];
-  if (!enabled) return { ...inspectWorkspaceDependencyMode(root, { mode: options.mode, env: options.env }), enabled: false, removed };
+  const preserved = [];
+  const packages = workspacePackages(root).filter((pkg) => typeof pkg.name === "string" && pkg.name.startsWith("@treeseed/"));
+  const packageNameByDir = new Map(packages.map((pkg) => [pathKey(pkg.dir), String(pkg.name)]));
+  const operatorPackageNames = options.preserveOperatorLinks ? operatorWorkspacePackageNames(packages) : /* @__PURE__ */ new Set();
+  if (!enabled) return { ...inspectWorkspaceDependencyMode(root, { mode: options.mode, env: options.env }), enabled: false, removed, preserved };
   for (const link of links) {
     const stat = safeLstat(link.linkPath);
     if (!stat) continue;
     const currentTarget = stat.isSymbolicLink() ? safeReadlink(link.linkPath) : null;
     const managed = managedLinks.has(pathKey(link.linkPath)) || currentTarget === pathKey(link.targetPath);
     if (!stat.isSymbolicLink() || !managed) continue;
+    const ownerPackageName = packageNameByDir.get(pathKey(link.ownerPath)) ?? null;
+    if (operatorPackageNames.has(link.packageName) || ownerPackageName && operatorPackageNames.has(ownerPackageName)) {
+      preserved.push(link.linkPath);
+      continue;
+    }
     unlinkSync(link.linkPath);
     removed.push(link.linkPath);
   }
   return {
     ...inspectWorkspaceDependencyMode(root, { mode: options.mode, env: options.env }),
     removed,
-    created: []
+    created: [],
+    preserved
   };
 }
 function collectDeploymentLockfileWorkspaceIssues(root = workspaceRoot()) {
@@ -425,6 +457,7 @@ function inspectWorkspaceDependencyMode(root = workspaceRoot(), options = {}) {
     links: inspected,
     created: [],
     removed: [],
+    preserved: [],
     issues: [
       ...inspected.filter((link) => link.exists && (!link.linked || !link.targetMatches)).map((link) => `${link.linkPath} is not linked to ${link.targetPath}.`),
       ...lockIssues

package/dist/workflow/operations.js

@@ -318,10 +318,13 @@ function unlinkWorkflowWorkspaceLinks(root, helpers, mode = "auto") {
   if (!shouldManageWorkspaceLinks(mode, helpers.context.env)) {
     return inspectWorkspaceDependencyMode(root, { mode: "off", env: helpers.context.env });
   }
-  const report = unlinkLocalWorkspaceLinks(root, { mode, env: helpers.context.env });
+  const report = unlinkLocalWorkspaceLinks(root, { mode, env: helpers.context.env, preserveOperatorLinks: true });
   if (report.removed.length > 0) {
     helpers.write(`[workspace][unlink] Removed ${report.removed.length} local workspace package links for deployment install.`);
   }
+  if (report.preserved.length > 0) {
+    helpers.write(`[workspace][unlink] Preserved ${report.preserved.length} operator workspace links so local trsd tooling remains available.`);
+  }
   return report;
 }
 function normalizeCiMode(mode, operation) {
@@ -5652,6 +5655,7 @@ ${blockers.join("\n")}`, {
           { id: "production-api-guarantees", description: "Run production API release guarantees before root deploy", repoName: rootRepo.name, repoPath: rootRepo.path, branch: PRODUCTION_BRANCH, resumable: true },
           { id: "release-root", description: `Release market ${plannedRelease.rootVersion}`, repoName: rootRepo.name, repoPath: rootRepo.path, branch: STAGING_BRANCH, resumable: true },
           { id: "publish-wait", description: "Wait for production release workflows", repoName: rootRepo.name, repoPath: rootRepo.path, branch: PRODUCTION_BRANCH, resumable: true },
+          { id: "production-web-live-verification", description: "Run production web live verification after root deploy", repoName: rootRepo.name, repoPath: rootRepo.path, branch: PRODUCTION_BRANCH, resumable: true },
           { id: "release-back-merge", description: "Back-merge production release history into staging", repoName: rootRepo.name, repoPath: rootRepo.path, branch: STAGING_BRANCH, resumable: true },
           { id: "workspace-link", description: "Restore local workspace links after release", repoName: rootRepo.name, repoPath: rootRepo.path, branch: STAGING_BRANCH, resumable: true }
         ],

package/package.json

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