@treeseed/cli 0.10.22 → 0.11.0

package/dist/cli/handlers/reconcile.js

@@ -0,0 +1,157 @@
+import {
+  runTreeseedLiveReconcileTests
+} from "@treeseed/sdk/reconcile";
+import { collectTreeseedConfigSeedValues } from "@treeseed/sdk/workflow-support";
+import { guidedResult } from "./utils.js";
+import { workflowErrorResult } from "./workflow.js";
+function environmentFor(value) {
+  return value === "prod" || value === "production" ? "prod" : value === "staging" ? "staging" : "local";
+}
+function modeFor(value) {
+  const raw = typeof value === "string" && value.trim() ? value.trim() : "smoke";
+  if (raw === "smoke" || raw === "acceptance" || raw === "cleanup") return raw;
+  throw new Error(`Unknown live reconciliation test mode "${raw}". Use smoke, acceptance, or cleanup.`);
+}
+function providersFor(value) {
+  const raw = typeof value === "string" && value.trim() ? value.trim() : "all";
+  if (raw === "all") return ["railway", "cloudflare", "github", "local"];
+  const providers = raw.split(",").map((entry) => entry.trim()).filter(Boolean);
+  const allowed = /* @__PURE__ */ new Set(["railway", "cloudflare", "github", "local"]);
+  for (const provider of providers) {
+    if (!allowed.has(provider)) {
+      throw new Error(`Unknown live reconciliation test provider "${provider}". Use railway, cloudflare, github, local, or all.`);
+    }
+  }
+  return [...new Set(providers)];
+}
+function yesRequested(value) {
+  return value === true || value === "true" || value === "yes" || value === "1";
+}
+function formatDuration(ms) {
+  const value = typeof ms === "number" && Number.isFinite(ms) ? ms : 0;
+  if (value < 1e3) return `${Math.max(0, Math.round(value))}ms`;
+  if (value < 6e4) return `${(value / 1e3).toFixed(value < 1e4 ? 1 : 0)}s`;
+  const minutes = Math.floor(value / 6e4);
+  const seconds = Math.round(value % 6e4 / 1e3);
+  return `${minutes}m ${seconds}s`;
+}
+function pad(value, width) {
+  return value.length >= width ? value : `${value}${" ".repeat(width - value.length)}`;
+}
+function truncate(value, width) {
+  if (value.length <= width) return value;
+  if (width <= 1) return value.slice(0, width);
+  return `${value.slice(0, width - 1)}\u2026`;
+}
+function renderScenarioRows(result) {
+  const rows = result.providers.flatMap((entry) => entry.scenarioResults.map((scenario) => ({
+    provider: entry.provider,
+    service: scenario.capability,
+    status: scenario.ok ? "ok" : "blocked",
+    lifecycle: scenario.ok && scenario.phase === "create" ? "create+verify" : scenario.phase,
+    action: scenario.action,
+    duration: formatDuration(scenario.durationMs),
+    reason: scenario.reason
+  })));
+  const width = typeof process.stdout?.columns === "number" ? process.stdout.columns : 120;
+  if (width < 96) {
+    return rows.map((row) => `- ${row.provider}:${row.service} ${row.status}; lifecycle=${row.lifecycle}; action=${row.action}; duration=${row.duration}; ${row.reason}`);
+  }
+  const providerWidth = Math.max("provider".length, ...rows.map((row) => row.provider.length));
+  const serviceWidth = Math.max("service type".length, ...rows.map((row) => row.service.length));
+  const statusWidth = Math.max("status".length, ...rows.map((row) => row.status.length));
+  const lifecycleWidth = Math.max("lifecycle".length, ...rows.map((row) => row.lifecycle.length));
+  const actionWidth = Math.max("action".length, ...rows.map((row) => row.action.length));
+  const durationWidth = Math.max("time".length, ...rows.map((row) => row.duration.length));
+  const fixedWidth = providerWidth + serviceWidth + statusWidth + lifecycleWidth + actionWidth + durationWidth + 18;
+  const reasonWidth = Math.max(24, width - fixedWidth);
+  const header = [
+    pad("provider", providerWidth),
+    pad("service type", serviceWidth),
+    pad("status", statusWidth),
+    pad("lifecycle", lifecycleWidth),
+    pad("action", actionWidth),
+    pad("time", durationWidth),
+    "reason"
+  ].join("  ");
+  const divider = [
+    "-".repeat(providerWidth),
+    "-".repeat(serviceWidth),
+    "-".repeat(statusWidth),
+    "-".repeat(lifecycleWidth),
+    "-".repeat(actionWidth),
+    "-".repeat(durationWidth),
+    "-".repeat(Math.min(reasonWidth, 40))
+  ].join("  ");
+  return [
+    header,
+    divider,
+    ...rows.map((row) => [
+      pad(row.provider, providerWidth),
+      pad(row.service, serviceWidth),
+      pad(row.status, statusWidth),
+      pad(row.lifecycle, lifecycleWidth),
+      pad(row.action, actionWidth),
+      pad(row.duration, durationWidth),
+      truncate(row.reason, reasonWidth)
+    ].join("  "))
+  ];
+}
+const handleReconcile = async (invocation, context) => {
+  try {
+    const subcommand = typeof invocation.positionals[0] === "string" && invocation.positionals[0].trim() ? invocation.positionals[0].trim() : "status";
+    if (subcommand !== "test-live") {
+      throw new Error(`Unknown reconcile subcommand "${subcommand}". Use test-live.`);
+    }
+    const environment = environmentFor(invocation.args.environment);
+    const providers = providersFor(invocation.args.provider);
+    const mode = modeFor(invocation.args.mode);
+    if ((mode === "acceptance" || mode === "cleanup") && !yesRequested(invocation.args.yes)) {
+      throw new Error(`Live reconciliation ${mode} mode creates or deletes real provider resources. Re-run with --yes to confirm.`);
+    }
+    const resolvedEnv = {
+      ...context.env,
+      ...collectTreeseedConfigSeedValues(context.cwd, environment, context.env)
+    };
+    const shouldStreamProgress = mode !== "smoke";
+    const result = await runTreeseedLiveReconcileTests({
+      cwd: context.cwd,
+      environment,
+      providers,
+      mode,
+      env: resolvedEnv,
+      onProgress: shouldStreamProgress ? (event) => {
+        const elapsed = typeof event.elapsedMs === "number" ? ` (${formatDuration(event.elapsedMs)})` : "";
+        context.write(`[reconcile] ${event.message}${elapsed}`, "stderr");
+      } : void 0
+    });
+    const blocked = result.providers.flatMap((entry) => entry.report.blockedDrift.map((drift) => `${entry.provider}: ${drift.reason}`));
+    return guidedResult({
+      command: "reconcile test-live",
+      summary: result.ok ? `Live reconciliation ${mode} tests passed for ${providers.join(", ")}.` : `Live reconciliation ${mode} tests found blocking drift for ${providers.join(", ")}.`,
+      facts: [
+        { label: "Mode", value: mode },
+        { label: "Environment", value: environment },
+        { label: "Run ID", value: result.runId },
+        { label: "Resource prefix", value: result.resourcePrefix },
+        { label: "Providers", value: providers.join(", ") },
+        { label: "OK", value: result.ok ? "yes" : "no" }
+      ],
+      sections: [{
+        title: "Providers",
+        lines: result.providers.map((entry) => `${entry.provider}: ${entry.ok ? "ok" : `${entry.report.blockedDrift.length} blocked`} (${entry.coverage.passed}/${entry.coverage.total})`)
+      }, {
+        title: "Service Type Results",
+        lines: renderScenarioRows(result)
+      }],
+      report: result,
+      exitCode: result.ok ? 0 : 1,
+      stderr: blocked
+    });
+  } catch (error) {
+    return workflowErrorResult(error);
+  }
+};
+export {
+  handleReconcile
+};

package/dist/cli/handlers/release.js

@@ -1,5 +1,5 @@
 import { guidedResult } from "./utils.js";
-import { createWorkflowSdk, renderWorkflowNextSteps, workflowErrorResult } from "./workflow.js";
+import { createWorkflowSdk, hostingGraphSections, renderWorkflowNextSteps, resolveWorkflowHostingGraph, workflowErrorResult } from "./workflow.js";
 function formatReleasePlanSections(payload) {
   const sections = [];
   const selection = payload.packageSelection ?? {};
@@ -75,6 +75,7 @@ const handleRelease = async (invocation, context) => {
       worktreeMode: typeof invocation.args.worktreeMode === "string" ? invocation.args.worktreeMode : void 0,
       ciMode: typeof invocation.args.ciMode === "string" ? invocation.args.ciMode : void 0,
       workspaceLinks: typeof invocation.args.workspaceLinks === "string" ? invocation.args.workspaceLinks : void 0,
+      verifyDeployedResources: invocation.args.verifyDeployedResources === true,
       fresh: invocation.args.fresh === true,
       plan: invocation.args.plan === true || invocation.args.dryRun === true,
       dryRun: invocation.args.dryRun === true
@@ -84,6 +85,7 @@ const handleRelease = async (invocation, context) => {
     const completedPublishes = publishWait.filter((entry) => entry.status === "completed").length;
     const plannedPublishes = payload.plannedPublishWaits?.length ?? 0;
     const releasedCommit = typeof payload.releasedCommit === "string" && payload.releasedCommit.length > 0 ? payload.releasedCommit.slice(0, 12) : result.executionMode === "plan" ? "planned" : "not available";
+    const hostingGraph = resolveWorkflowHostingGraph(context, "prod", payload.applicationSelection);
     return guidedResult({
       command: invocation.commandName || "release",
       summary: result.executionMode === "plan" ? "Treeseed release plan ready." : "Treeseed release completed successfully.",
@@ -102,14 +104,21 @@ const handleRelease = async (invocation, context) => {
         { label: result.executionMode === "plan" ? "Packages planned" : "Released packages", value: String((payload.touchedPackages ?? payload.packageSelection.selected).length) },
         { label: "Publish waits", value: result.executionMode === "plan" ? String(plannedPublishes) : String(completedPublishes) },
         { label: "CI mode", value: payload.ciMode ?? "auto" },
+        { label: "Selected apps", value: payload.applicationSelection?.selected?.join(", ") || "all" },
         { label: "Fresh release", value: payload.fresh === true ? "yes" : "no" },
         { label: "Workflow gates", value: String(payload.workflowGates?.length ?? 0) },
         { label: "Worktree path", value: payload.worktreePath ?? "(in-place)" },
         { label: "Final branch", value: payload.finalBranch ?? (result.executionMode === "plan" ? payload.stagingBranch : "(unknown)") }
       ],
-      sections: result.executionMode === "plan" ? formatReleasePlanSections(payload) : [],
+      sections: result.executionMode === "plan" ? [
+        ...hostingGraphSections(hostingGraph),
+        ...formatReleasePlanSections(payload)
+      ] : [],
       nextSteps: renderWorkflowNextSteps(result),
-      report: result
+      report: {
+        ...result,
+        hostingGraph
+      }
     });
   } catch (error) {
     return workflowErrorResult(error);

package/dist/cli/handlers/save.js

@@ -1,5 +1,5 @@
 import { guidedResult } from "./utils.js";
-import { createWorkflowSdk, renderWorkflowNextSteps, workflowErrorResult } from "./workflow.js";
+import { createWorkflowSdk, hostingGraphSections, renderWorkflowNextSteps, resolveWorkflowHostingGraph, workflowErrorResult } from "./workflow.js";
 function formatRepoPlanSummary(repo) {
   const branch = repo.currentBranch && repo.targetBranch && repo.currentBranch !== repo.targetBranch ? `${repo.currentBranch} -> ${repo.targetBranch}` : repo.targetBranch ?? repo.currentBranch ?? "unknown";
   const version = repo.plannedVersion ? `, version ${repo.currentVersion ?? "?"} -> ${repo.plannedVersion}` : repo.currentVersion ? `, version ${repo.currentVersion}` : "";
@@ -52,8 +52,10 @@ const handleSave = async (invocation, context) => {
       hotfix: invocation.args.hotfix === true,
       preview: invocation.args.preview === true,
       worktreeMode: typeof invocation.args.worktreeMode === "string" ? invocation.args.worktreeMode : void 0,
+      lane: typeof invocation.args.lane === "string" ? invocation.args.lane : void 0,
       ciMode: typeof invocation.args.ciMode === "string" ? invocation.args.ciMode : void 0,
       verifyMode: typeof invocation.args.verifyMode === "string" ? invocation.args.verifyMode : void 0,
+      releaseCandidate: typeof invocation.args.releaseCandidate === "string" ? invocation.args.releaseCandidate : void 0,
       workspaceLinks: typeof invocation.args.workspaceLinks === "string" ? invocation.args.workspaceLinks : void 0,
       plan: invocation.args.plan === true || invocation.args.dryRun === true,
       dryRun: invocation.args.dryRun === true
@@ -62,6 +64,7 @@ const handleSave = async (invocation, context) => {
     const commitSha = typeof payload.commitSha === "string" && payload.commitSha.length > 0 ? payload.commitSha.slice(0, 12) : "not applicable";
     const savedRepos = (payload.repos ?? []).filter((repo) => repo.committed || repo.pushed).map((repo) => `${repo.name}@${String(repo.commitSha ?? "").slice(0, 12)}`).join(", ");
     const plannedRepos = result.executionMode === "plan" ? (payload.repositoryPlan?.repos ?? payload.repos ?? []).map((repo) => repo.name).join(", ") : "";
+    const hostingGraph = resolveWorkflowHostingGraph(context, payload.scope === "prod" ? "prod" : payload.scope === "staging" ? "staging" : "local", payload.applicationSelection);
     return guidedResult({
       command: invocation.commandName || "save",
       summary: result.executionMode === "plan" ? "Treeseed save plan ready." : payload.noChanges ? "Treeseed save found no new changes and confirmed branch sync." : "Treeseed save completed successfully.",
@@ -82,16 +85,23 @@ const handleSave = async (invocation, context) => {
         },
         { label: "Market pushed", value: payload.rootRepo?.pushed ? "yes" : "no" },
         { label: "Preview action", value: payload.previewAction?.status ?? "skipped" },
+        { label: "Lane", value: payload.lane ?? "fast" },
         { label: "CI mode", value: payload.ciMode ?? "auto" },
+        { label: "Release candidate", value: payload.releaseCandidateMode ?? "n/a" },
+        { label: "Selected apps", value: payload.applicationSelection?.selected?.join(", ") || "all" },
         { label: "Workflow gates", value: String(payload.workflowGates?.length ?? 0) },
         { label: "Worktree path", value: payload.worktreePath ?? "(in-place)" }
       ],
       sections: result.executionMode === "plan" ? [
+        ...hostingGraphSections(hostingGraph),
         ...payload.plannedSteps?.length ? [{ title: "Dependency mode transitions", lines: payload.plannedSteps.filter((step) => /workspace-(?:link|unlink)/u.test(String(step.id ?? ""))).map((step) => `- ${step.description ?? step.id}`) }] : [],
         ...formatSavePlanSections(payload.repositoryPlan)
       ] : [],
       nextSteps: renderWorkflowNextSteps(result),
-      report: result
+      report: {
+        ...result,
+        hostingGraph
+      }
     });
   } catch (error) {
     return workflowErrorResult(error);

package/dist/cli/handlers/seed.js

@@ -3,7 +3,7 @@ import { dirname, resolve } from "node:path";
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { formatSeedDiagnostics, formatSeedPlan, loadAndPlanSeed } from "@treeseed/sdk/seeds";
 import { persistCapacityProviderConnectionToTreeseedConfig } from "@treeseed/sdk/capacity-provider";
-import { MarketApiError } from "@treeseed/sdk/market-client";
+import { MarketClientError } from "@treeseed/sdk/market-client";
 import { createMarketClientForInvocation, marketAuthRoot, marketSelector } from "./market-utils.js";
 import { MarketClient, resolveMarketProfile, resolveMarketSession, setMarketSession } from "@treeseed/sdk/market-client";
 async function loadLocalSeedModule(projectRoot) {
@@ -145,7 +145,7 @@ function storeLocalCapacityProviderConnection(input) {
   });
 }
 function remoteSeedError(error, command) {
-  if (error instanceof MarketApiError) {
+  if (error instanceof MarketClientError) {
     const payload = error.payload && typeof error.payload === "object" ? error.payload : { error: error.message };
     const blocked = error.status === 409 || payload.result?.blocked === true;
     const auth = error.status === 401 || error.status === 403;

package/dist/cli/handlers/stage.js

@@ -1,5 +1,5 @@
 import { guidedResult } from "./utils.js";
-import { createWorkflowSdk, renderWorkflowNextSteps, workflowErrorResult } from "./workflow.js";
+import { createWorkflowSdk, hostingGraphSections, renderWorkflowNextSteps, resolveWorkflowHostingGraph, workflowErrorResult } from "./workflow.js";
 const handleStage = async (invocation, context) => {
   try {
     const result = await createWorkflowSdk(context).stage({
@@ -12,6 +12,7 @@ const handleStage = async (invocation, context) => {
     });
     const payload = result.payload;
     const mergedPackages = payload.repos.filter((repo) => repo.merged).length;
+    const hostingGraph = resolveWorkflowHostingGraph(context, "staging", payload.applicationSelection);
     return guidedResult({
       command: invocation.commandName || "stage",
       summary: result.executionMode === "plan" ? "Treeseed stage plan ready." : "Treeseed stage completed successfully.",
@@ -24,14 +25,19 @@ const handleStage = async (invocation, context) => {
         { label: "Deprecated tag", value: payload.rootRepo.tagName ?? payload.deprecatedTag?.tagName ?? "(planned)" },
         { label: "Package merges", value: String(mergedPackages) },
         { label: "Staging wait", value: payload.stagingWait?.status ?? (result.executionMode === "plan" ? "planned" : "unknown") },
+        { label: "Selected apps", value: payload.applicationSelection?.selected?.join(", ") || "all" },
         { label: "Workflow gates", value: String(payload.workflowGates?.length ?? 0) },
         { label: "Preview cleanup", value: payload.previewCleanup?.performed ? "performed" : result.executionMode === "plan" ? "planned" : "not needed" },
         { label: "Worktree cleanup", value: payload.worktreeCleanup?.removed ? "removed" : "not needed" },
         { label: "Worktree path", value: payload.worktreePath ?? "(in-place)" },
         { label: "Final branch", value: payload.finalBranch ?? payload.mergeTarget }
       ],
+      sections: result.executionMode === "plan" ? hostingGraphSections(hostingGraph) : [],
       nextSteps: renderWorkflowNextSteps(result),
-      report: result
+      report: {
+        ...result,
+        hostingGraph
+      }
     });
   } catch (error) {
     return workflowErrorResult(error);

package/dist/cli/handlers/status.js

@@ -1,3 +1,4 @@
+import { compileTreeseedHostingGraph, serializeHostingUnit } from "@treeseed/sdk/hosting";
 import { guidedResult } from "./utils.js";
 import { createWorkflowSdk, renderWorkflowNextSteps, workflowErrorResult } from "./workflow.js";
 import { renderTreeseedStatusInk } from "./status-ui.js";
@@ -45,6 +46,7 @@ function environmentLines(state, scope) {
   ];
 }
 function statusFacts(state, live) {
+  const packageKinds = Array.isArray(state.packageSync?.packages) ? [...new Set(state.packageSync.packages.map((pkg) => pkg.kind).filter(Boolean))].join(", ") : "";
   return [
     { label: "Mode", value: live ? "saved state + live provider checks" : "saved state" },
     { label: "Workspace root", value: state.workspaceRoot ? "yes" : "no" },
@@ -54,6 +56,7 @@ function statusFacts(state, live) {
     { label: "Mapped environment", value: state.environment },
     { label: "Dirty worktree", value: state.dirtyWorktree ? "yes" : "no" },
     { label: "Package mode", value: state.packageSync.mode },
+    { label: "Package adapters", value: packageKinds || "(none)" },
     { label: "Dependency mode", value: state.packageSync.dependencyMode ?? "(unknown)" },
     { label: "Full package checkout", value: state.packageSync.completeCheckout ? "yes" : "no" },
     { label: "Package branch aligned", value: state.packageSync.aligned ? "yes" : "no" },
@@ -84,11 +87,29 @@ const handleStatus = async (invocation, context) => {
     const history = invocation.args.history === "all" ? "all" : "recent";
     const result = await createWorkflowSdk(context).status({ live, history });
     const state = result.payload;
+    let hostingGraph = null;
+    try {
+      const graph = compileTreeseedHostingGraph({
+        tenantRoot: context.cwd,
+        environment: state.environment === "prod" || state.environment === "production" ? "prod" : state.environment === "staging" ? "staging" : "local"
+      });
+      hostingGraph = {
+        environment: graph.environment,
+        placements: graph.placements,
+        units: graph.units.map((unit) => serializeHostingUnit(unit))
+      };
+      state.hostingGraph = hostingGraph;
+    } catch (error) {
+      state.hostingGraph = {
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
     const nextSteps = renderWorkflowNextSteps(result);
     const report = {
       ...result,
       state,
-      live
+      live,
+      hostingGraph
     };
     if (await renderTreeseedStatusInk(state, context)) {
       return {
@@ -106,6 +127,14 @@ const handleStatus = async (invocation, context) => {
           title: scope.label,
           lines: environmentLines(state, scope.id)
         })),
+        {
+          title: "Hosting graph",
+          lines: hostingGraph?.placements ? hostingGraph.placements.map((placement) => `${placement.label}: ${placement.serviceIds.join(", ")} on ${placement.hostIds.join(", ")}`) : [state.hostingGraph?.error ?? "No hosting graph available."]
+        },
+        {
+          title: "Package adapters",
+          lines: Array.isArray(state.packageSync?.packages) && state.packageSync.packages.length > 0 ? state.packageSync.packages.map((pkg) => `${pkg.id}: ${pkg.kind}${pkg.version ? ` @ ${pkg.version}` : ""}${pkg.publishTarget ? ` -> ${pkg.publishTarget}` : ""}`) : ["No package adapters discovered."]
+        },
         {
           title: "Managed services",
           lines: Object.entries(state.managedServices ?? {}).map(([name, service]) => `${name}: ${service.enabled ? service.initialized ? "deployed" : "not deployed" : "disabled"}${service.lastDeployedUrl ? ` (${service.lastDeployedUrl})` : ""}`)

package/dist/cli/handlers/tool-wrapper.js

@@ -1,8 +1,10 @@
 import {
   createTreeseedManagedToolEnv,
+  listRailwayProjects,
   resolveTreeseedLaunchEnvironment,
   resolveTreeseedToolCommand
 } from "@treeseed/sdk/workflow-support";
+import { loadTreeseedDeployConfigFromPath } from "@treeseed/sdk/platform/deploy-config";
 import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
@@ -96,11 +98,73 @@ function railwayProjectIdFromDeployState(cwd, scope) {
     return null;
   }
 }
+function railwayProjectNameFromManifest(cwd) {
+  const candidates = [
+    join(cwd, "treeseed.site.yaml"),
+    join(cwd, "packages", "api", "treeseed.site.yaml"),
+    join(cwd, "..", "..", "treeseed.site.yaml")
+  ];
+  for (const candidate of candidates) {
+    if (!existsSync(candidate)) continue;
+    try {
+      const config = loadTreeseedDeployConfigFromPath(candidate);
+      const services = config.services ?? {};
+      const apiName = services.api?.railway?.projectName;
+      const runnerName = services.operationsRunner?.railway?.projectName;
+      if (typeof apiName === "string" && apiName.trim()) return apiName.trim();
+      if (typeof runnerName === "string" && runnerName.trim()) return runnerName.trim();
+      if (config.hosting?.kind === "treeseed_control_plane" && config.slug) return config.slug;
+    } catch {
+    }
+  }
+  return null;
+}
+async function resolveLiveRailwayProjectId({
+  cwd,
+  env,
+  fallbackProjectId
+}) {
+  const projectName = typeof env.TREESEED_RAILWAY_PROJECT_NAME === "string" && env.TREESEED_RAILWAY_PROJECT_NAME.trim() ? env.TREESEED_RAILWAY_PROJECT_NAME.trim() : railwayProjectNameFromManifest(cwd);
+  if (!projectName) {
+    return fallbackProjectId;
+  }
+  try {
+    const projects = await listRailwayProjects({ env });
+    const live = projects.find((project) => project.deletedAt === null && project.name === projectName);
+    return live?.id ?? projectName;
+  } catch {
+    return projectName;
+  }
+}
 function railwayCommandUsesProjectFiles(args) {
   const command = args[0] ?? "";
   return ["up", "dev", "develop", "run", "local", "shell"].includes(command);
 }
-const handleToolWrapper = (invocation, context) => {
+function railwayCommandNeedsProjectContext(args) {
+  const command = args[0] ?? "";
+  if (!command) return false;
+  if (args.includes("--help") || args.includes("-h")) return false;
+  return ![
+    "account",
+    "completion",
+    "environment",
+    "environments",
+    "help",
+    "init",
+    "link",
+    "login",
+    "logout",
+    "open",
+    "project",
+    "projects",
+    "team",
+    "teams",
+    "whoami",
+    "workspace",
+    "workspaces"
+  ].includes(command);
+}
+const handleToolWrapper = async (invocation, context) => {
   let isolatedRailwayCwd = null;
   try {
     const toolName = wrappedToolName(invocation.commandName);
@@ -133,9 +197,13 @@ const handleToolWrapper = (invocation, context) => {
       };
     }
     const targetArgs = invocation.positionals;
-    if (toolName === "railway" && scope !== "local" && targetArgs[0] !== "link") {
+    if (toolName === "railway" && scope !== "local" && railwayCommandNeedsProjectContext(targetArgs)) {
       const environmentName = railwayEnvironmentName(scope);
-      const projectId = managedEnv.TREESEED_RAILWAY_PROJECT_ID || railwayProjectIdFromDeployState(context.cwd, scope);
+      const projectId = await resolveLiveRailwayProjectId({
+        cwd: context.cwd,
+        env: managedEnv,
+        fallbackProjectId: managedEnv.TREESEED_RAILWAY_PROJECT_ID || railwayProjectIdFromDeployState(context.cwd, scope)
+      });
       const railwayCwd = railwayCommandUsesProjectFiles(targetArgs) ? context.cwd : isolatedRailwayCwd = mkdtempSync(join(tmpdir(), `treeseed-railway-${scope}-`));
       const railwayEnv = isolatedRailwayCwd ? {
         ...managedEnv,

package/dist/cli/handlers/treedx.d.ts

@@ -0,0 +1,2 @@
+import type { TreeseedCommandHandler } from '../types.js';
+export declare const handleTreeDx: TreeseedCommandHandler;