@treeseed/cli 0.6.38 → 0.6.40

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

@@ -18,6 +18,9 @@ function wrapperScope(value) {
   }
   return "staging";
 }
+function railwayEnvironmentName(scope) {
+  return scope === "prod" ? "production" : scope;
+}
 const handleToolWrapper = (invocation, context) => {
   try {
     const toolName = wrappedToolName(invocation.commandName);
@@ -50,6 +53,37 @@ const handleToolWrapper = (invocation, context) => {
       };
     }
     const targetArgs = invocation.positionals;
+    if (toolName === "railway" && scope !== "local") {
+      const environmentResult = context.spawn(resolved.command, [
+        ...resolved.argsPrefix,
+        "environment",
+        railwayEnvironmentName(scope),
+        "--json"
+      ], {
+        cwd: context.cwd,
+        env: managedEnv,
+        stdio: "pipe"
+      });
+      if ((environmentResult.status ?? 1) !== 0) {
+        return {
+          exitCode: environmentResult.status ?? 1,
+          stderr: [`Failed to select Railway environment ${railwayEnvironmentName(scope)} before running ${targetArgs.join(" ") || "railway"}.`],
+          report: {
+            command: toolName,
+            ok: false,
+            scope,
+            executable: resolved.command,
+            binaryPath: resolved.binaryPath,
+            argsPrefix: resolved.argsPrefix,
+            args: targetArgs,
+            environmentSelection: {
+              environment: railwayEnvironmentName(scope),
+              status: environmentResult.status ?? 1
+            }
+          }
+        };
+      }
+    }
     const result = context.spawn(resolved.command, [...resolved.argsPrefix, ...targetArgs], {
       cwd: context.cwd,
       env: managedEnv,

package/dist/cli/operations-registry.js

@@ -336,6 +336,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
       { name: "worktreeMode", flags: "--worktree <mode>", description: "Control managed workflow worktrees.", kind: "enum", values: ["auto", "on", "off"] },
       { name: "ciMode", flags: "--ci <mode>", description: "Control hosted GitHub Actions waits.", kind: "enum", values: ["auto", "hosted", "off"] },
       { name: "verifyMode", flags: "--verify <mode>", description: "Control save verification depth.", kind: "enum", values: ["fast", "local", "hosted", "both", "skip"] },
+      { name: "verifyDeployedResources", flags: "--verify-deployed-resources", description: "Also wait for hosted deployment checks that verify provider resources.", kind: "boolean" },
       { name: "workspaceLinks", flags: "--workspace-links <mode>", description: "Control local workspace package links.", kind: "enum", values: ["auto", "off"] },
       { name: "plan", flags: "--plan", description: "Compute the recursive save plan without mutating any repo.", kind: "boolean" },
       { name: "dryRun", flags: "--dry-run", description: "Alias for --plan.", kind: "boolean" },
@@ -351,6 +352,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
       whenToUse: [
         "Use this after a meaningful unit of work on a task branch.",
         "Use `--preview` when the branch preview should be refreshed as part of the save operation.",
+        "Use `--verify-deployed-resources` on staging or production branches when the checkpoint should wait for deployed provider resources to be verified.",
         "Use `--hotfix` only when you are intentionally saving from `main` for an explicit production hotfix flow."
       ],
       beforeYouRun: [
@@ -426,6 +428,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
       { name: "plan", flags: "--plan", description: "Compute the recursive staging plan without mutating any repo.", kind: "boolean" },
       { name: "worktreeMode", flags: "--worktree <mode>", description: "Control managed workflow worktrees.", kind: "enum", values: ["auto", "on", "off"] },
       { name: "ciMode", flags: "--ci <mode>", description: "Control hosted GitHub Actions waits.", kind: "enum", values: ["auto", "hosted", "off"] },
+      { name: "verifyDeployedResources", flags: "--verify-deployed-resources", description: "Force staging deployment checks to verify provider resources before stage returns.", kind: "boolean" },
       { name: "workspaceLinks", flags: "--workspace-links <mode>", description: "Control local workspace package links.", kind: "enum", values: ["auto", "off"] },
       { name: "dryRun", flags: "--dry-run", description: "Alias for --plan.", kind: "boolean" },
       { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
@@ -1287,17 +1290,17 @@ const CLI_ONLY_OPERATION_SPECS = [
     aliases: [],
     group: "Passthrough",
     summary: "Run the managed Railway CLI with Treeseed environment credentials.",
-    description: "Decrypt Treeseed machine configuration for the selected environment and pass it to the managed Railway CLI.",
+    description: "Decrypt Treeseed machine configuration for the selected environment, select the matching Railway environment, and pass it to the managed Railway CLI.",
     provider: "default",
     related: ["tools", "install", "config"],
     usage: "treeseed railway [--environment staging] -- <railway-args>",
     arguments: [{ name: "args", description: "Arguments forwarded to Railway CLI.", required: false }],
     options: TOOL_WRAPPER_OPTIONS,
-    examples: ["treeseed railway --environment staging -- whoami", "treeseed railway --environment staging -- status"],
+    examples: ["treeseed railway --environment staging -- whoami", "treeseed railway --environment staging -- status", "treeseed railway --environment prod -- status"],
     help: {
-      longSummary: ["The Railway wrapper resolves the Treeseed-managed Railway executable, decrypts scoped machine configuration, and passes the resulting Railway token only to the child process environment."],
+      longSummary: ["The Railway wrapper resolves the Treeseed-managed Railway executable, decrypts scoped machine configuration, selects the requested Railway environment, and passes the resulting Railway token only to the child process environment."],
       whenToUse: ["Use this to debug Railway projects and service builds with the same decrypted `RAILWAY_API_TOKEN` Treeseed deploys use."],
-      beforeYouRun: ["Run from a Treeseed project. Use `--environment staging` when inspecting staging deployments."],
+      beforeYouRun: ["Run from a Treeseed project. Use `--environment staging` when inspecting staging deployments and `--environment prod` when inspecting Railway production."],
       automationNotes: ["Use `--` before target CLI flags when a flag could be parsed by Treeseed itself. The wrapper does not print decrypted secrets."]
     },
     helpVisible: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/cli",
-  "version": "0.6.38",
+  "version": "0.6.40",
   "description": "Operator-facing Treeseed CLI package.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -45,7 +45,7 @@
     "release:publish": "node ./scripts/run-ts.mjs ./scripts/publish-package.ts"
   },
   "dependencies": {
-    "@treeseed/sdk": "0.6.42",
+    "@treeseed/sdk": "0.6.44",
     "ink": "^7.0.0",
     "react": "^19.2.5"
   },