@treeseed/sdk 0.12.26 → 0.12.27

package/dist/operations/services/github-automation.d.ts

@@ -114,8 +114,8 @@ export declare function ensureStandardizedGitHubWorkflows(tenantRoot: any): {
 export declare function listGitHubSecretNames(repository: any, tenantRoot: any): Promise<Set<string>>;
 export declare function listGitHubVariableNames(repository: any, tenantRoot: any): Promise<Set<string>>;
 export declare function formatMissingSecretsReport(repository: any, missingSecrets: any, reason?: string): string;
-export declare function ensureGitHubSecrets(tenantRoot: any, { dryRun }?: {
-    dryRun?: boolean | undefined;
+export declare function ensureGitHubSecrets(tenantRoot: any, { planOnly }?: {
+    planOnly?: boolean | undefined;
 }): Promise<{
     existing: never[];
     created: never[];
@@ -123,8 +123,8 @@ export declare function ensureGitHubSecrets(tenantRoot: any, { dryRun }?: {
     existing: string[];
     created: string[];
 }>;
-export declare function ensureGitHubEnvironment(tenantRoot: any, { dryRun, scope, purpose, valuesOverlay, managedHostMode }?: {
-    dryRun?: boolean | undefined;
+export declare function ensureGitHubEnvironment(tenantRoot: any, { planOnly, scope, purpose, valuesOverlay, managedHostMode }?: {
+    planOnly?: boolean | undefined;
     scope?: string | undefined;
     purpose?: string | undefined;
     valuesOverlay?: {} | undefined;
@@ -152,8 +152,8 @@ export declare function ensureGitHubEnvironment(tenantRoot: any, { dryRun, scope
     };
     skipped?: undefined;
 }>;
-export declare function ensureGitHubDeployAutomation(tenantRoot: any, { dryRun, valuesOverlay }?: {
-    dryRun?: boolean | undefined;
+export declare function ensureGitHubDeployAutomation(tenantRoot: any, { planOnly, valuesOverlay }?: {
+    planOnly?: boolean | undefined;
     valuesOverlay?: {} | undefined;
 }): Promise<{
     mode: string;

package/dist/operations/services/github-automation.js

@@ -380,18 +380,18 @@ function formatMissingSecretsReport(repository, missingSecrets, reason = "missin
   }
   return lines.join("\n");
 }
-async function ensureGitHubSecrets(tenantRoot, { dryRun = false } = {}) {
-  return (await ensureGitHubEnvironment(tenantRoot, { dryRun })).secrets;
+async function ensureGitHubSecrets(tenantRoot, { planOnly = false } = {}) {
+  return (await ensureGitHubEnvironment(tenantRoot, { planOnly })).secrets;
 }
 function nonEmptyValues(values = {}) {
   return Object.fromEntries(
     Object.entries(values).filter(([, value]) => typeof value === "string" && value.length > 0)
   );
 }
-async function ensureGitHubEnvironment(tenantRoot, { dryRun = false, scope = "prod", purpose = "save", valuesOverlay = {}, managedHostMode = "auto" } = {}) {
+async function ensureGitHubEnvironment(tenantRoot, { planOnly = false, scope = "prod", purpose = "save", valuesOverlay = {}, managedHostMode = "auto" } = {}) {
   const repository = maybeResolveGitHubRepositorySlug(tenantRoot);
   if (!repository) {
-    if (dryRun) {
+    if (planOnly) {
       return {
         repository: null,
         secrets: { existing: [], created: [] },
@@ -424,7 +424,7 @@ async function ensureGitHubEnvironment(tenantRoot, { dryRun = false, scope = "pr
   }
   const createdSecrets = [];
   for (const name of missingRemote) {
-    if (dryRun) {
+    if (planOnly) {
       createdSecrets.push(name);
       continue;
     }
@@ -433,7 +433,7 @@ async function ensureGitHubEnvironment(tenantRoot, { dryRun = false, scope = "pr
   }
   const createdVariables = [];
   for (const name of missingRemoteVariables) {
-    if (dryRun) {
+    if (planOnly) {
       createdVariables.push(name);
       continue;
     }
@@ -452,9 +452,9 @@ async function ensureGitHubEnvironment(tenantRoot, { dryRun = false, scope = "pr
     }
   };
 }
-async function ensureGitHubDeployAutomation(tenantRoot, { dryRun = false, valuesOverlay = {} } = {}) {
+async function ensureGitHubDeployAutomation(tenantRoot, { planOnly = false, valuesOverlay = {} } = {}) {
   const workflows = ensureStandardizedGitHubWorkflows(tenantRoot);
-  const environment = await ensureGitHubEnvironment(tenantRoot, { dryRun, valuesOverlay });
+  const environment = await ensureGitHubEnvironment(tenantRoot, { planOnly, valuesOverlay });
   return {
     mode: getGitHubAutomationMode(),
     workflow: workflows[0],

package/dist/operations/services/hub-launch.d.ts

@@ -164,7 +164,7 @@ export declare function validateRepositoryHost(host: RepositoryHost): {
 };
 export declare function createKnowledgeHubRepositories(input: {
     plan: KnowledgeHubRepositoryPlan;
-    dryRun?: boolean;
+    planOnly?: boolean;
     description?: string | null;
     homepageUrl?: string | null;
 }): Promise<{

package/dist/operations/services/hub-launch.js

@@ -157,7 +157,7 @@ async function createKnowledgeHubRepositories(input) {
   const githubEnv = githubToken ? { ...process.env, GH_TOKEN: githubToken, GITHUB_TOKEN: githubToken } : process.env;
   const created = [];
   for (const repository of input.plan.repositories) {
-    if (!repository.create || input.dryRun !== false) {
+    if (!repository.create || input.planOnly !== false) {
       created.push({ ...repository, status: repository.create ? "planned" : "connected" });
       continue;
     }

package/dist/operations/services/package-adapters.d.ts

@@ -32,7 +32,7 @@ export type TreeseedPackageAdapter = {
         architectures?: string[];
     }>;
     releaseChecks: Array<{
-        kind: 'npm-pack-dry-run' | 'github-workflow' | 'docker-manifest';
+        kind: 'npm-pack-plan' | 'github-workflow' | 'docker-manifest';
         name: string;
         detail: string;
     }>;
@@ -140,7 +140,7 @@ export declare function packageAdapterPlanSummary(root?: any): {
         architectures?: string[];
     }[];
     releaseChecks: {
-        kind: "npm-pack-dry-run" | "github-workflow" | "docker-manifest";
+        kind: "npm-pack-plan" | "github-workflow" | "docker-manifest";
         name: string;
         detail: string;
     }[];

package/dist/operations/services/package-adapters.js

@@ -142,7 +142,7 @@ function nodeTypeScriptAdapter(pkg) {
     })) : [{ provider: "npm", name: String(pkg.name) }],
     releaseChecks: [
       { kind: "github-workflow", name: "publish workflow", detail: dockerImageReleaseWorkflow ? `.github/workflows/${dockerImageReleaseWorkflow}` : ".github/workflows/publish.yml" },
-      ...dockerArtifacts.length > 0 ? dockerArtifacts.map((artifact) => ({ kind: "docker-manifest", name: `${artifact.name} Docker image manifest`, detail: `${artifact.name}:<version>` })) : [{ kind: "npm-pack-dry-run", name: "npm pack", detail: "npm pack --dry-run" }]
+      ...dockerArtifacts.length > 0 ? dockerArtifacts.map((artifact) => ({ kind: "docker-manifest", name: `${artifact.name} Docker image manifest`, detail: `${artifact.name}:<version>` })) : [{ kind: "npm-pack-plan", name: "npm pack", detail: "npm pack --plan" }]
     ],
     metadata: {
       ...repository ? { repository } : {},

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

@@ -109,7 +109,7 @@ export interface ExecuteProjectHostBindingOperationInput {
     commitMessage?: string | null;
     approvalRequired?: boolean;
     approvalId?: string | null;
-    dryRun?: boolean;
+    planOnly?: boolean;
 }
 export interface ExecuteProjectHostBindingOperationContext {
     workspaceRoot: string;

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

@@ -324,7 +324,7 @@ async function executeProjectHostBindingOperation(input, context) {
         valuesOverlay: context.valuesOverlay,
         valuesByScope: context.valuesByScope,
         processEnv: context.processEnv,
-        dryRun: input.dryRun,
+        planOnly: input.planOnly,
         onProgress: context.onProgress
       });
     } catch (error) {

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

@@ -10,7 +10,7 @@ export interface ProjectPlatformActionOptions {
     scope: ProjectPlatformScope;
     projectId?: string | null;
     previewId?: string | null;
-    dryRun?: boolean;
+    planOnly?: boolean;
     reporter?: ControlPlaneReporter;
     skipProvision?: boolean;
     bootstrapSystems?: TreeseedRunnableBootstrapSystem[];
@@ -24,7 +24,7 @@ export type TenantCloudflareDeployContext = {
     tenantRoot: string;
     scope: ProjectPlatformScope;
     target: any;
-    dryRun?: boolean;
+    planOnly?: boolean;
     wranglerPath: string;
     databaseName: string;
     pagesProjectName: string | null;
@@ -32,23 +32,23 @@ export type TenantCloudflareDeployContext = {
     env: NodeJS.ProcessEnv | Record<string, string | undefined>;
     write?: TreeseedBootstrapWriter;
 };
-export declare function prepareTenantCloudflareDeploy({ tenantRoot, scope, target: explicitTarget, dryRun, write, env, }: {
+export declare function prepareTenantCloudflareDeploy({ tenantRoot, scope, target: explicitTarget, planOnly, write, env, }: {
     tenantRoot: string;
     scope: ProjectPlatformScope;
     target?: any;
-    dryRun?: boolean;
+    planOnly?: boolean;
     write?: TreeseedBootstrapWriter;
     env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
 }): TenantCloudflareDeployContext;
 export declare function runTenantDataMigration(context: TenantCloudflareDeployContext): Promise<{
     databaseName: string;
-    dryRun: boolean;
+    planOnly: boolean;
 }>;
-export declare function runTenantWebBuild(context: Pick<TenantCloudflareDeployContext, 'tenantRoot' | 'scope' | 'dryRun' | 'env' | 'write'>): Promise<{
-    dryRun: boolean;
+export declare function runTenantWebBuild(context: Pick<TenantCloudflareDeployContext, 'tenantRoot' | 'scope' | 'planOnly' | 'env' | 'write'>): Promise<{
+    planOnly: boolean;
 }>;
 export declare function runTenantWebPublish(context: TenantCloudflareDeployContext): Promise<{
-    dryRun: boolean;
+    planOnly: boolean;
 }>;
 export declare function provisionProjectPlatform(options: ProjectPlatformActionOptions): Promise<{
     ok: boolean;

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

@@ -240,7 +240,7 @@ function prepareTenantCloudflareDeploy({
   tenantRoot,
   scope,
   target: explicitTarget,
-  dryRun,
+  planOnly,
   write,
   env: env2 = process.env
 }) {
@@ -251,7 +251,7 @@ function prepareTenantCloudflareDeploy({
   }
   const { wranglerPath, deployConfig, state } = ensureGeneratedWranglerConfig(tenantRoot, { target });
   if (scope !== "local") {
-    syncCloudflareSecrets(tenantRoot, { target, dryRun });
+    syncCloudflareSecrets(tenantRoot, { target, planOnly });
   }
   const deployState = loadDeployState(tenantRoot, deployConfig, { target });
   const pagesProjectName = target.kind === "persistent" ? deployState.pages?.projectName ?? null : null;
@@ -260,7 +260,7 @@ function prepareTenantCloudflareDeploy({
     tenantRoot,
     scope,
     target,
-    dryRun,
+    planOnly,
     wranglerPath,
     databaseName: state.d1Databases.SITE_DATA_DB.databaseName,
     pagesProjectName,
@@ -275,14 +275,14 @@ function prepareTenantCloudflareDeploy({
   };
 }
 async function runTenantDataMigration(context) {
-  if (context.dryRun) {
+  if (context.planOnly) {
     writeTreeseedBootstrapLine(context.write, {
       scope: context.scope,
       system: "data",
       task: "d1-migrate",
       stage: "deploy"
-    }, `Dry run: would apply remote migrations for ${context.databaseName}.`);
-    return { databaseName: context.databaseName, dryRun: true };
+    }, `Plan: would apply remote migrations for ${context.databaseName}.`);
+    return { databaseName: context.databaseName, planOnly: true };
   }
   await runPrefixedWranglerWithRetry(context.tenantRoot, [
     "d1",
@@ -302,7 +302,7 @@ async function runTenantDataMigration(context) {
       stage: "deploy"
     }
   });
-  return { databaseName: context.databaseName, dryRun: false };
+  return { databaseName: context.databaseName, planOnly: false };
 }
 async function runTenantWebBuild(context) {
   const prefix = {
@@ -311,9 +311,9 @@ async function runTenantWebBuild(context) {
     task: "build",
     stage: "deploy"
   };
-  if (context.dryRun) {
-    writeTreeseedBootstrapLine(context.write, prefix, "Dry run: skipped tenant build.");
-    return { dryRun: true };
+  if (context.planOnly) {
+    writeTreeseedBootstrapLine(context.write, prefix, "Plan: skipped tenant build.");
+    return { planOnly: true };
   }
   const result = await runPrefixedCommand(process.execPath, [packageScriptPath("tenant-build")], {
     cwd: context.tenantRoot,
@@ -324,7 +324,7 @@ async function runTenantWebBuild(context) {
   if (result.status !== 0) {
     throw new Error("tenant-build failed.");
   }
-  return { dryRun: false };
+  return { planOnly: false };
 }
 async function runTenantWebPublish(context) {
   const prefix = {
@@ -333,13 +333,13 @@ async function runTenantWebPublish(context) {
     task: "publish",
     stage: "deploy"
   };
-  if (context.dryRun) {
+  if (context.planOnly) {
     if (context.pagesProjectName) {
-      writeTreeseedBootstrapLine(context.write, prefix, `Dry run: would deploy ${deployTargetLabel(context.target)} to Pages project ${context.pagesProjectName} from ${resolve(context.tenantRoot, "dist")}.`);
+      writeTreeseedBootstrapLine(context.write, prefix, `Plan: would deploy ${deployTargetLabel(context.target)} to Pages project ${context.pagesProjectName} from ${resolve(context.tenantRoot, "dist")}.`);
     } else {
-      writeTreeseedBootstrapLine(context.write, prefix, `Dry run: would deploy ${deployTargetLabel(context.target)} with generated Wrangler config at ${resolve(context.wranglerPath)}.`);
+      writeTreeseedBootstrapLine(context.write, prefix, `Plan: would deploy ${deployTargetLabel(context.target)} with generated Wrangler config at ${resolve(context.wranglerPath)}.`);
     }
-    return { dryRun: true };
+    return { planOnly: true };
   }
   if (context.pagesProjectName) {
     const args = [
@@ -364,7 +364,7 @@ async function runTenantWebPublish(context) {
       prefix
     });
   }
-  return { dryRun: false };
+  return { planOnly: false };
 }
 function inferContentType(filePath) {
   const extension = extname(filePath).toLowerCase();
@@ -462,11 +462,11 @@ async function repairHostingAfterSuccessfulDeploy(options, systems) {
       reason: "local_environment"
     };
   }
-  if (options.dryRun) {
+  if (options.planOnly) {
     return {
       ok: true,
       skipped: true,
-      reason: "dry_run"
+      reason: "plan"
     };
   }
   if (process.env.TREESEED_POST_DEPLOY_HOSTING_REPAIR === "off") {
@@ -908,7 +908,7 @@ async function publishContent(options, reporter, publishOptions = {}) {
   }
   const tempRoot = mkdtempSync(join(projectPlatformTempRoot(options.tenantRoot, "content-publish"), "treeseed-content-publish-"));
   try {
-    if (!options.dryRun) {
+    if (!options.planOnly) {
       const uploadOptions = {
         write: options.write,
         prefix: {
@@ -969,7 +969,7 @@ async function publishContent(options, reporter, publishOptions = {}) {
       }
     }
     const state = loadDeployState(options.tenantRoot, siteConfig, { target });
-    if (!options.dryRun) {
+    if (!options.planOnly) {
       state.content.lastPublishedManifestRevision = "overlay" in built ? built.overlay.previewId : built.manifest.revision;
       state.content.lastPublishedManifestSha256 = stableHash(
         JSON.stringify("overlay" in built ? built.overlay : built.manifest)
@@ -1035,7 +1035,7 @@ async function provisionProjectPlatform(options) {
     env: env2,
     systems: bootstrapSystems,
     write: options.write,
-    dryRun: options.dryRun
+    planOnly: options.planOnly
   }));
   writeWorkflowStatus("provision:reconcile:done");
   timings.push(...summary.timings ?? []);
@@ -1204,7 +1204,7 @@ async function provisionProjectPlatform(options) {
   };
 }
 async function deployProjectPlatform(options) {
-  writeWorkflowStatus(`deploy:start scope=${options.scope} dryRun=${options.dryRun ? "true" : "false"}`);
+  writeWorkflowStatus(`deploy:start scope=${options.scope} planOnly=${options.planOnly ? "true" : "false"}`);
   const timings = [];
   const deployStartMs = performance.now();
   writeWorkflowStatus("deploy:resolve-reporter");
@@ -1244,7 +1244,7 @@ async function deployProjectPlatform(options) {
       run: () => runTenantWebBuild({
         tenantRoot: options.tenantRoot,
         scope: "local",
-        dryRun: options.dryRun,
+        planOnly: options.planOnly,
         env: env2,
         write
       })
@@ -1253,7 +1253,7 @@ async function deployProjectPlatform(options) {
     cloudflareContext = prepareTenantCloudflareDeploy({
       tenantRoot: options.tenantRoot,
       scope: options.scope,
-      dryRun: options.dryRun,
+      planOnly: options.planOnly,
       write,
       env: env2
     });
@@ -1309,7 +1309,7 @@ async function deployProjectPlatform(options) {
         }),
         run: async () => {
           const result = await deployRailwayService(options.tenantRoot, service, {
-            dryRun: options.dryRun,
+            planOnly: options.planOnly,
             write,
             env: env2,
             prefix: {
@@ -1330,7 +1330,7 @@ async function deployProjectPlatform(options) {
   }
   const managesRailwaySchedules = options.scope === "staging" || options.scope === "prod";
   let railwaySchedules = [];
-  let railwayScheduleVerification = { ok: true, checks: [], skipped: true, reason: !selectedSystems.has("agents") ? "agents_not_selected" : !managesRailwaySchedules ? "scope_not_scheduled" : "dry_run" };
+  let railwayScheduleVerification = { ok: true, checks: [], skipped: true, reason: !selectedSystems.has("agents") ? "agents_not_selected" : !managesRailwaySchedules ? "scope_not_scheduled" : "plan" };
   if (managesRailwaySchedules && selectedSystems.has("agents")) {
     const agentDeployNodeIds = nodes.filter((node) => node.id.startsWith("agents:") && node.id.endsWith("-railway-deploy")).map((node) => node.id);
     nodes.push({
@@ -1343,8 +1343,8 @@ async function deployProjectPlatform(options) {
           task: "schedules",
           stage: "deploy"
         }, "Reconciling Railway schedules...");
-        railwaySchedules = await ensureRailwayScheduledJobs(options.tenantRoot, options.scope, { dryRun: options.dryRun, env: env2 });
-        railwayScheduleVerification = !options.dryRun ? await verifyRailwayScheduledJobs(options.tenantRoot, options.scope) : { ok: true, checks: railwaySchedules, skipped: true, reason: "dry_run" };
+        railwaySchedules = await ensureRailwayScheduledJobs(options.tenantRoot, options.scope, { planOnly: options.planOnly, env: env2 });
+        railwayScheduleVerification = !options.planOnly ? await verifyRailwayScheduledJobs(options.tenantRoot, options.scope) : { ok: true, checks: railwaySchedules, skipped: true, reason: "plan" };
         return {
           service: "railway-schedules",
           status: railwayScheduleVerification.ok ? "verified" : "failed",
@@ -1362,7 +1362,7 @@ async function deployProjectPlatform(options) {
   for (const result of serviceResults) {
     timings.push(...result.timings ?? []);
   }
-  if (options.scope !== "local" && !options.dryRun && (selectedSystems.has("web") || serviceResults.length > 0)) {
+  if (options.scope !== "local" && !options.planOnly && (selectedSystems.has("web") || serviceResults.length > 0)) {
     finalizeDeploymentState(options.tenantRoot, {
       target: createPersistentDeployTarget(options.scope),
       serviceResults,
@@ -1371,7 +1371,7 @@ async function deployProjectPlatform(options) {
   }
   if (!managesRailwaySchedules || !selectedSystems.has("agents")) {
     railwaySchedules = [];
-    railwayScheduleVerification = { ok: true, checks: railwaySchedules, skipped: true, reason: !selectedSystems.has("agents") ? "agents_not_selected" : !managesRailwaySchedules ? "scope_not_scheduled" : "dry_run" };
+    railwayScheduleVerification = { ok: true, checks: railwaySchedules, skipped: true, reason: !selectedSystems.has("agents") ? "agents_not_selected" : !managesRailwaySchedules ? "scope_not_scheduled" : "plan" };
   }
   if (selectedSystems.has("agents")) {
     serviceResults.push({
@@ -1456,7 +1456,7 @@ async function monitorProjectPlatform(options) {
     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)),
+    r2: options.planOnly ? Promise.resolve({ ok: true, skipped: true, reason: "plan" }) : timedPhase(timings, "monitor:probe-r2", () => probeR2(options.tenantRoot, siteConfig, state, target)),
     scaleProbe: timedPhase(timings, "monitor:probe-scale", () => probeScaleConfiguration(siteConfig, state)),
     railwayResources: Promise.resolve(railwayResourcesPromise),
     readiness: state.readiness,

package/dist/operations/services/project-web-monitor.d.ts

@@ -11,5 +11,5 @@ export declare function buildProjectWebMonitorResult(input: {
     githubClient?: GitHubApiClient | null;
     fetchImpl?: typeof fetch | null;
     mockExternal?: boolean;
-    dryRun?: boolean;
+    planOnly?: boolean;
 }): Promise<ProjectWebMonitorResult>;

package/dist/operations/services/project-web-monitor.js

@@ -175,7 +175,7 @@ async function workflowFileCheck(input) {
       summary: "GitHub repository is not configured."
     });
   }
-  if (input.mockExternal || input.dryRun) {
+  if (input.mockExternal || input.planOnly) {
     return check({
       key: "workflow_file",
       label: "Workflow file",
@@ -226,7 +226,7 @@ async function httpCheck(input) {
       summary: "No public URL is available for HTTP probing."
     });
   }
-  if (input.mockExternal || input.dryRun || !input.fetchImpl) {
+  if (input.mockExternal || input.planOnly || !input.fetchImpl) {
     return check({
       key: "http_response",
       label: "HTTP response",
@@ -296,7 +296,7 @@ async function buildProjectWebMonitorResult(input) {
       workflowFile,
       githubClient: input.githubClient,
       mockExternal: input.mockExternal,
-      dryRun: input.dryRun,
+      planOnly: input.planOnly,
       treeDxPublish
     }),
     check({
@@ -318,7 +318,7 @@ async function buildProjectWebMonitorResult(input) {
       url: targetUrl,
       fetchImpl: input.fetchImpl,
       mockExternal: input.mockExternal,
-      dryRun: input.dryRun
+      planOnly: input.planOnly
     }),
     contentRuntimeCheck({ resolution: contentRuntime, hasRuntimeMetadata }),
     check({

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

@@ -81,8 +81,8 @@ export declare function validateRailwayDeployPrerequisites(tenantRoot: any, scop
     hostingKind: import("../../platform/contracts.js").TreeseedHostingKind;
     managedTopology: string[];
 };
-export declare function ensureRailwayScheduledJobs(tenantRoot: any, scope: any, { dryRun, fetchImpl, apiToken, apiUrl, env }?: {
-    dryRun?: boolean | undefined;
+export declare function ensureRailwayScheduledJobs(tenantRoot: any, scope: any, { planOnly, fetchImpl, apiToken, apiUrl, env }?: {
+    planOnly?: boolean | undefined;
     fetchImpl?: typeof fetch | undefined;
     env?: NodeJS.ProcessEnv | undefined;
 }): Promise<any[]>;
@@ -111,8 +111,8 @@ 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, { dryRun, write, prefix, env, }?: {
-    dryRun?: boolean;
+export declare function deployRailwayService(tenantRoot: any, service: any, { planOnly, write, prefix, env, }?: {
+    planOnly?: boolean;
     write?: TreeseedBootstrapWriter;
     prefix?: TreeseedBootstrapTaskPrefix;
     env?: NodeJS.ProcessEnv | Record<string, string | undefined>;

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

@@ -854,8 +854,8 @@ function resolveRailwayServiceSourcePolicy({ tenantRoot, scope, serviceKey, serv
   const configuredSource = service.railway?.source && typeof service.railway.source === "object" && !Array.isArray(service.railway.source) ? service.railway.source : {};
   const configuredRepo = typeof service.railway?.sourceRepo === "string" ? service.railway.sourceRepo : typeof configuredSource.repository === "string" ? configuredSource.repository : typeof configuredSource.repo === "string" ? configuredSource.repo : null;
   const packageRepository = configuredRepo ?? readTreeseedPackageRepository(serviceRoot) ?? readTreeseedPackageRepository(tenantRoot);
-  const sourceEligible = ["api", "operationsRunner", "capacityProviderManager", "capacityProviderRunner"].includes(serviceKey);
-  const sourceMode = scope === "prod" ? "image" : configuredMode === "git" || configuredMode === "image" ? configuredMode : imageRef ? "image" : scope === "staging" && sourceEligible && packageRepository ? "git" : "git";
+  const apiPackageSourceEligible = ["api", "operationsRunner"].includes(serviceKey);
+  const sourceMode = scope === "prod" ? "image" : scope === "staging" && apiPackageSourceEligible ? "git" : configuredMode === "git" || configuredMode === "image" ? configuredMode : imageRef ? "image" : "git";
   if (sourceMode !== "git") {
     return {
       sourceMode: "image",
@@ -1028,7 +1028,7 @@ function validateRailwayDeployPrerequisites(tenantRoot, scope, { env = process.e
   }
   return validation;
 }
-async function ensureRailwayScheduledJobs(tenantRoot, scope, { dryRun = false, fetchImpl = fetch, apiToken, apiUrl, env = process.env } = {}) {
+async function ensureRailwayScheduledJobs(tenantRoot, scope, { planOnly = false, fetchImpl = fetch, apiToken, apiUrl, env = process.env } = {}) {
   const { schedules } = validateRailwayServiceConfiguration(tenantRoot, scope);
   if (schedules.length === 0) {
     return [];
@@ -1044,7 +1044,7 @@ async function ensureRailwayScheduledJobs(tenantRoot, scope, { dryRun = false, f
       const target = await resolveRailwayScheduleTarget(schedule, {
         env,
         fetchImpl,
-        ensure: !dryRun
+        ensure: !planOnly
       });
       if (!target.project || !target.environment || !target.service) {
         results.push({
@@ -1074,7 +1074,7 @@ async function ensureRailwayScheduledJobs(tenantRoot, scope, { dryRun = false, f
       const drifted = Boolean(
         current.id && (current.cronSchedule !== desired.schedule || (current.startCommand ?? null) !== (desired.command ?? null))
       );
-      if (dryRun) {
+      if (planOnly) {
         results.push({
           ...schedule,
           projectId: target.project.id,
@@ -1596,13 +1596,13 @@ async function syncRailwayServiceRuntimeConfigurationAfterDeploy(tenantRoot, ser
   };
 }
 async function deployRailwayService(tenantRoot, service, {
-  dryRun = false,
+  planOnly = false,
   write,
   prefix,
   env = process.env
 } = {}) {
   const timings = [];
-  if (dryRun) {
+  if (planOnly) {
     return {
       service: service.key,
       status: "planned",

package/dist/operations/services/repository-save-orchestrator.js

@@ -922,7 +922,7 @@ async function runProjectVerificationInstallWithRetry(node, options) {
   const packageJson = node.packageJson ?? (existsSync(resolve(node.path, "package.json")) ? readJson(resolve(node.path, "package.json")) : null);
   const rootWorkspaceInstall = node.path === options.root && Array.isArray(packageJson?.workspaces);
   if (rootWorkspaceInstall) {
-    emitProgress(options, node, "install", "Skipped root npm ci project verification install; lockfile dry-run and restored workspace links provide save-time dependency proof.");
+    emitProgress(options, node, "install", "Skipped root npm ci project verification install; lockfile plan and restored workspace links provide save-time dependency proof.");
     return;
   }
   const args = rootWorkspaceInstall ? ["ci"] : ["ci", "--workspaces=false"];
@@ -945,7 +945,7 @@ ${lastError ?? ""}`);
 function lockfileValidationCommand(node, options) {
   const packageJson = node.packageJson ?? (existsSync(resolve(node.path, "package.json")) ? readJson(resolve(node.path, "package.json")) : null);
   const rootWorkspaceInstall = node.path === options.root && Array.isArray(packageJson?.workspaces);
-  const args = rootWorkspaceInstall ? ["ci", "--ignore-scripts", "--dry-run"] : ["ci", "--ignore-scripts", "--dry-run", "--workspaces=false"];
+  const args = rootWorkspaceInstall ? ["ci", "--ignore-scripts", "--plan"] : ["ci", "--ignore-scripts", "--plan", "--workspaces=false"];
   return { command: "npm", args };
 }
 async function validateRepositoryLockfile(node, options) {
@@ -1509,7 +1509,7 @@ function repoPlanCommands(node, options, plannedVersion, plannedDependencySpec,
     commands.push(rootWorkspaceInstall ? "npm install --package-lock-only --ignore-scripts # refresh root workspace lockfile without installing git dependencies" : "npm install --workspaces=false # refresh project lockfile after internal dependency updates");
   }
   if (hasNpmLockfile(node.path) && (node.kind === "project" || plannedVersion || dependencyUpdates.length > 0 || node.submoduleDependencies.length > 0)) {
-    commands.push(rootWorkspaceInstall ? "npm ci --ignore-scripts --dry-run # validate root manifest, workspaces, and lockfile before commit" : "npm ci --ignore-scripts --dry-run --workspaces=false # validate deployment lockfile before commit");
+    commands.push(rootWorkspaceInstall ? "npm ci --ignore-scripts --plan # validate root manifest, workspaces, and lockfile before commit" : "npm ci --ignore-scripts --plan --workspaces=false # validate deployment lockfile before commit");
   }
   commands.push("git add -A");
   commands.push("generate commit message # Cloudflare AI when configured, fallback otherwise");

package/dist/operations/services/template-secret-sync.d.ts

@@ -84,7 +84,7 @@ export interface ResolveProjectLaunchSecretValueOverlayOptions {
 export interface SyncProjectLaunchHostBindingSecretsOptions extends ResolveProjectLaunchSecretValueOverlayOptions {
     projectRoot: string;
     repository?: string | null;
-    dryRun?: boolean;
+    planOnly?: boolean;
     providers?: ProjectLaunchSecretSyncProvider[];
     onProgress?: (event: ProjectLaunchSecretSyncProgressEvent) => void | Promise<void>;
     adapters?: ProjectLaunchSecretSyncAdapters;

package/dist/operations/services/template-secret-sync.js

@@ -229,7 +229,7 @@ async function syncProjectLaunchHostBindingSecrets(options) {
           await adapters.github({
             tenantRoot: options.projectRoot,
             scope,
-            dryRun: options.dryRun,
+            planOnly: options.planOnly,
             repository: options.repository ?? null,
             valuesOverlay,
             entryIds,
@@ -239,7 +239,7 @@ async function syncProjectLaunchHostBindingSecrets(options) {
           adapters.cloudflare({
             tenantRoot: options.projectRoot,
             scope,
-            dryRun: options.dryRun,
+            planOnly: options.planOnly,
             valuesOverlay,
             entryIds
           });
@@ -247,7 +247,7 @@ async function syncProjectLaunchHostBindingSecrets(options) {
           adapters.railway({
             tenantRoot: options.projectRoot,
             scope,
-            dryRun: options.dryRun,
+            planOnly: options.planOnly,
             valuesOverlay,
             entryIds
           });