run402 2.39.2 → 2.39.4

package/README.md

@@ -2,7 +2,7 @@
 
 Command-line interface for [Run402](https://run402.com) — provision Postgres databases, deploy static sites, run Node 22 serverless functions, host content-addressed CDN assets, send email, sign on-chain. Paid autonomously with x402 USDC on Base. **Prototype tier is free on testnet.**
 
-For the full CLI reference (every flag, every subcommand) see **<https://run402.com/llms-cli.txt>**.
+For the full CLI reference (every flag, every subcommand) see **<https://docs.run402.com/llms-cli.txt>**.
 
 ## Install
 
@@ -243,7 +243,7 @@ run402 functions --help
 
 The canonical, comprehensive CLI reference — every flag, every subcommand, edge cases, troubleshooting — lives at:
 
-**<https://run402.com/llms-cli.txt>**
+**<https://docs.run402.com/llms-cli.txt>**
 
 Same content also at [`cli/llms-cli.txt`](./llms-cli.txt) in the repo. Treat that file as authoritative; this README is a quick-orientation landing page.
 

package/lib/ci.mjs

@@ -240,7 +240,9 @@ jobs:
 ${environmentLine}    steps:
       - uses: actions/checkout@v4
       - name: Deploy to run402
-        run: npx --yes run402@${RUN402_VERSION} deploy apply --manifest ${shellQuote(manifest)} --project ${shellQuote(projectId)}
+        # Redirect stdin from /dev/null: a CI runner's stdin is a FIFO/file that
+        # older run402 CLIs counted as a second manifest source alongside --manifest.
+        run: npx --yes run402@${RUN402_VERSION} deploy apply --manifest ${shellQuote(manifest)} --project ${shellQuote(projectId)} < /dev/null
 `;
 }
 

package/lib/deploy-v2.mjs

@@ -93,7 +93,7 @@ Options:
   --allow-warnings        Continue past plan warnings that require confirmation
 
 Output:
-  stdout: { "status": "ok", "release_id": "rel_...", "operation_id": "op_...", "urls": {...}, "warnings": [...] }
+  stdout: { "release_id": "rel_...", "operation_id": "op_...", "urls": {...}, "warnings": [...] }
   stderr: one JSON event per line (suppressed with --quiet or --final-only)
 
 Secrets:
@@ -141,7 +141,7 @@ the pointer-swap activation). The gateway re-runs only the failed phase
 forward — SQL is never replayed.
 
 Output:
-  stdout: { "status": "ok", "release_id": "...", "operation_id": "...", "urls": {...} }
+  stdout: { "release_id": "...", "operation_id": "...", "urls": {...} }
   stderr: one JSON event per line (suppressed with --quiet)
 `;
 
@@ -155,7 +155,7 @@ Options:
   --limit <n>             Maximum number of operations to return
 
 Output:
-  stdout: { "status": "ok", "operations": [...], "cursor": "..." | null }
+  stdout: { "operations": [...], "cursor": "..." | null }
 `;
 
 const EVENTS_HELP = `run402 deploy events — Fetch the recorded event stream for a deploy operation
@@ -167,7 +167,7 @@ Options:
   --project <id>          Project ID that owns the operation (default: active project)
 
 Output:
-  stdout: { "status": "ok", "events": [...] }
+  stdout: { "events": [...] }
 `;
 
 const RELEASE_HELP = `run402 deploy release — Inspect deploy release inventory and diffs
@@ -183,8 +183,8 @@ Subcommands:
   diff      Diff two release targets
 
 Output:
-  get/active: { "status": "ok", "release": {...} }  # includes route inventory and inventory warnings when returned
-  diff:       { "status": "ok", "diff": {...} }     # includes route added/removed/changed diff buckets
+  get/active: { "release": {...} }  # includes route inventory and inventory warnings when returned
+  diff:       { "diff": {...} }     # includes route added/removed/changed diff buckets
 `;
 
 const RELEASE_GET_HELP = `run402 deploy release get — Fetch a release inventory by id
@@ -197,7 +197,7 @@ Options:
   --site-limit <n>        Maximum site path entries to include (gateway default: 5000)
 
 Output:
-  stdout: { "status": "ok", "release": {...} }  # preserves full routes inventory and warnings
+  stdout: { "release": {...} }  # preserves full routes inventory and warnings
 `;
 
 const RELEASE_ACTIVE_HELP = `run402 deploy release active — Fetch the active release inventory
@@ -210,7 +210,7 @@ Options:
   --site-limit <n>        Maximum site path entries to include (gateway default: 5000)
 
 Output:
-  stdout: { "status": "ok", "release": {...} }  # preserves full routes inventory and warnings
+  stdout: { "release": {...} }  # preserves full routes inventory and warnings
 `;
 
 const RELEASE_DIFF_HELP = `run402 deploy release diff — Diff two release targets
@@ -225,7 +225,7 @@ Options:
   --limit <n>             Maximum entries per site diff bucket (gateway default: 1000)
 
 Output:
-  stdout: { "status": "ok", "diff": {...} }  # preserves routes.added/removed/changed
+  stdout: { "diff": {...} }  # preserves routes.added/removed/changed
 `;
 
 const DIAGNOSE_HELP = `run402 deploy diagnose — Diagnose a Run402 public URL
@@ -244,7 +244,7 @@ Options:
   --method <method>       HTTP method to diagnose (default: GET)
 
 Output:
-  stdout: { "status": "ok", "would_serve": true|false, "diagnostic_status": 200|404|..., "match": "...", "summary": "...", "request": {...}, "warnings": [...], "resolution": {...}, "next_steps": [...] }
+  stdout: { "would_serve": true|false, "diagnostic_status": 200|404|..., "match": "...", "summary": "...", "request": {...}, "warnings": [...], "resolution": {...}, "next_steps": [...] }
 `;
 
 const RESOLVE_HELP = `run402 deploy resolve — Low-level deploy URL diagnostics
@@ -326,7 +326,6 @@ Options:
 
 Output:
   stdout: {
-    "status": "ok",
     "release_id": "rel_old_abc123",
     "operation_id": "op_...",
     "previous_release_id": "rel_new_xxx",
@@ -559,11 +558,35 @@ function parseApplyArgs(args) {
   return opts;
 }
 
-function applySourceField(opts) {
-  if (opts.manifest !== null) return "manifest";
-  if (opts.spec !== null) return "spec";
-  if (opts.dir !== null && !hasStdinSource()) return "dir";
-  return "stdin";
+// Resolve the single manifest source from parsed opts + whether stdin actually
+// has data (a pipe/file on fd 0). Explicit --manifest/--spec/--dir take
+// precedence over incidental stdin: a CI runner (e.g. GitHub Actions) hands the
+// step a FIFO/file stdin, which must NOT be mistaken for a piped manifest when a
+// source flag is given. Exported for unit testing. Returns { source } | { error }.
+export function resolveApplySource(opts, stdinPresent) {
+  const explicit = [];
+  if (opts.manifest !== null) explicit.push("--manifest");
+  if (opts.spec !== null) explicit.push("--spec");
+  if (explicit.length > 1) {
+    return {
+      error: {
+        code: "BAD_USAGE",
+        message: "Only one deploy manifest source may be provided: --manifest or --spec.",
+        details: { sources: explicit },
+      },
+    };
+  }
+  if (opts.manifest !== null) return { source: "manifest" };
+  if (opts.spec !== null) return { source: "spec" };
+  if (opts.dir !== null) return { source: "dir" };
+  if (stdinPresent) return { source: "stdin" };
+  return {
+    error: {
+      code: "BAD_USAGE",
+      message: "No deploy manifest provided. Use --manifest <path>, --spec '<json>', --dir <build>, or pipe a manifest on stdin.",
+      details: {},
+    },
+  };
 }
 
 async function mergeAstroReleaseSlice(spec, dirArg) {
@@ -621,29 +644,16 @@ async function mergeAstroReleaseSlice(spec, dirArg) {
   spec.functions = { replace: { ...existingFns, ...sliceFns } };
 }
 
-function validateApplySources(opts) {
-  const sources = [];
-  if (opts.manifest !== null) sources.push("--manifest");
-  if (opts.spec !== null) sources.push("--spec");
-  if (hasStdinSource()) sources.push("stdin");
-  if (sources.length > 1) {
-    fail({
-      code: "BAD_USAGE",
-      message: "Only one deploy manifest source may be provided: --spec, --manifest, or stdin.",
-      details: { sources },
-    });
-  }
-}
-
 async function applyCmd(args) {
   const opts = parseApplyArgs(args);
-  validateApplySources(opts);
+  const { source, error: sourceError } = resolveApplySource(opts, hasStdinSource());
+  if (sourceError) fail(sourceError);
 
   let raw;
   let manifestPath = null;
-  if (opts.spec !== null) {
+  if (source === "spec") {
     raw = opts.spec;
-  } else if (opts.manifest !== null) {
+  } else if (source === "manifest") {
     try {
       manifestPath = isAbsolute(opts.manifest) ? opts.manifest : resolve(process.cwd(), opts.manifest);
       raw = readFileSync(manifestPath, "utf-8");
@@ -654,11 +664,12 @@ async function applyCmd(args) {
         details: { flag: "--manifest", path: opts.manifest },
       });
     }
-  } else if (opts.dir !== null && !hasStdinSource()) {
-    // --dir without any other source: start from an empty spec and let the
+  } else if (source === "dir") {
+    // --dir without --manifest/--spec: start from an empty spec and let the
     // Astro release-slice fill in site/functions/routes below.
     raw = "{}";
   } else {
+    // source === "stdin": a manifest piped on stdin.
     raw = await readStdin();
   }
 
@@ -669,11 +680,11 @@ async function applyCmd(args) {
     fail({
       code: "BAD_USAGE",
       message: `Manifest is not valid JSON: ${err.message}`,
-      details: { source: applySourceField(opts), parse_error: err.message },
+      details: { source, parse_error: err.message },
     });
   }
   rejectLegacySecretManifest(spec, {
-    source: applySourceField(opts),
+    source,
     ...(manifestPath ? { path: manifestPath } : {}),
   });
 
@@ -720,7 +731,7 @@ async function applyCmd(args) {
       message: `Manifest contains no deployable sections. Expected at least one of: ${meaningful.join(", ")}`,
       hint: "Did you mean to write a 'site.replace' or 'database.migrations' block? See https://run402.com/schemas/manifest.v1.json",
       details: {
-        field: applySourceField(opts),
+        field: source,
         ...(manifestPath ? { path: manifestPath } : {}),
         meaningful_keys: meaningful,
       },

package/lib/image.mjs

@@ -20,7 +20,7 @@ Examples:
   run402 image generate "portrait of a cat CEO" --aspect portrait --output cat.png
 
 Output (without --output):
-  { "status": "ok", "aspect": "square", "content_type": "image/png", "image": "<base64>" }
+  { "aspect": "square", "content_type": "image/png", "image": "<base64>" }
 
 Notes:
   - Requires a funded allowance (run402 allowance create && run402 allowance fund)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "run402",
-  "version": "2.39.2",
+  "version": "2.39.4",
   "description": "CLI for Run402 — provision Postgres databases, deploy static sites, generate images, and manage wallets via x402 and MPP micropayments.",
   "type": "module",
   "bin": {