run402 1.54.1 → 1.54.2

package/lib/ai.mjs

@@ -13,10 +13,10 @@ Subcommands:
   usage     <project_id>
 
 Examples:
-  run402 ai translate proj-001 "Hello world" --to es
-  run402 ai translate proj-001 "Hello" --to ja --from en --context "formal business email"
-  run402 ai moderate proj-001 "content to check"
-  run402 ai usage proj-001
+  run402 ai translate prj_abc123 "Hello world" --to es
+  run402 ai translate prj_abc123 "Hello" --to ja --from en --context "formal business email"
+  run402 ai moderate prj_abc123 "content to check"
+  run402 ai usage prj_abc123
 
 Notes:
   - translate requires the AI Translation add-on on the project
@@ -44,8 +44,8 @@ Notes:
   - Counts against the project's translation word quota
 
 Examples:
-  run402 ai translate proj-001 "Hello world" --to es
-  run402 ai translate proj-001 "Hello" --to ja --from en \\
+  run402 ai translate prj_abc123 "Hello world" --to es
+  run402 ai translate prj_abc123 "Hello" --to ja --from en \\
     --context "formal business email"
 `,
 };

package/lib/apps.mjs

@@ -23,11 +23,11 @@ Examples:
   run402 apps browse
   run402 apps browse --tag auth
   run402 apps fork ver_abc123 my-todo --tier prototype
-  run402 apps publish proj123 --description "Todo app" --tags todo,auth --visibility public --fork-allowed
-  run402 apps versions proj123
+  run402 apps publish prj_abc123 --description "Todo app" --tags todo,auth --visibility public --fork-allowed
+  run402 apps versions prj_abc123
   run402 apps inspect ver_abc123
-  run402 apps update proj123 ver_abc123 --description "Updated" --tags todo
-  run402 apps delete proj123 ver_abc123
+  run402 apps update prj_abc123 ver_abc123 --description "Updated" --tags todo
+  run402 apps delete prj_abc123 ver_abc123
 `;
 
 const SUB_HELP = {
@@ -76,8 +76,8 @@ Options:
   --fork-allowed      Allow other users to fork this app
 
 Examples:
-  run402 apps publish proj123 --description "Todo app" --tags todo,auth
-  run402 apps publish proj123 --visibility public --fork-allowed
+  run402 apps publish prj_abc123 --description "Todo app" --tags todo,auth
+  run402 apps publish prj_abc123 --visibility public --fork-allowed
 `,
   update: `run402 apps update — Update a published version's metadata
 
@@ -96,9 +96,9 @@ Options:
   --no-fork           Disable forking for this version
 
 Examples:
-  run402 apps update proj123 ver_abc123 --description "Updated"
-  run402 apps update proj123 ver_abc123 --tags todo,auth --fork-allowed
-  run402 apps update proj123 ver_abc123 --no-fork
+  run402 apps update prj_abc123 ver_abc123 --description "Updated"
+  run402 apps update prj_abc123 ver_abc123 --tags todo,auth --fork-allowed
+  run402 apps update prj_abc123 ver_abc123 --no-fork
 `,
 };
 

package/lib/argparse.mjs

@@ -0,0 +1,147 @@
+import { fail } from "./sdk-errors.mjs";
+
+export function normalizeArgv(argv = []) {
+  const out = [];
+  for (const arg of argv ?? []) {
+    if (typeof arg === "string" && arg.startsWith("--") && arg.includes("=")) {
+      const eq = arg.indexOf("=");
+      out.push(arg.slice(0, eq), arg.slice(eq + 1));
+    } else {
+      out.push(arg);
+    }
+  }
+  return out;
+}
+
+export function hasHelp(args = []) {
+  return args.includes("--help") || args.includes("-h");
+}
+
+export function assertKnownFlags(args = [], knownFlags = [], flagsWithValues = []) {
+  const known = new Set(knownFlags);
+  const valueFlags = new Set(flagsWithValues);
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (valueFlags.has(arg)) {
+      i += 1;
+      continue;
+    }
+    if (typeof arg !== "string" || !arg.startsWith("-") || arg === "-") continue;
+    if (known.has(arg)) continue;
+    failUnknownFlag(arg, known);
+  }
+}
+
+export function failUnknownFlag(flag, knownFlags = []) {
+  const known = [...knownFlags].filter((f) => typeof f === "string" && f.startsWith("-"));
+  const closest = closestFlag(flag, known);
+  fail({
+    code: "UNKNOWN_FLAG",
+    message: closest ? `Unknown flag: ${flag}. Did you mean ${closest}?` : `Unknown flag: ${flag}.`,
+    details: { flag, closest: closest ? [closest] : [] },
+  });
+}
+
+export function flagValue(args, flag) {
+  const idx = args.indexOf(flag);
+  if (idx === -1) return null;
+  if (idx + 1 >= args.length) {
+    fail({
+      code: "BAD_FLAG",
+      message: `${flag} requires a value`,
+      details: { flag },
+    });
+  }
+  return args[idx + 1];
+}
+
+export function parseIntegerFlag(name, value, { min = 1, max = Number.POSITIVE_INFINITY, def } = {}) {
+  if (value === undefined || value === null) {
+    if (def !== undefined) return def;
+    fail({
+      code: "BAD_FLAG",
+      message: `${name} requires an integer value`,
+      details: { flag: name },
+    });
+  }
+  const raw = String(value);
+  if (!/^-?\d+$/.test(raw)) {
+    fail({
+      code: "BAD_FLAG",
+      message: `${name} must be an integer, got: ${raw}`,
+      details: { flag: name, value: raw },
+    });
+  }
+  const n = Number.parseInt(raw, 10);
+  if (n < min) {
+    fail({
+      code: "BAD_FLAG",
+      message: `${name} must be >= ${min}, got: ${n}`,
+      details: { flag: name, value: n, min },
+    });
+  }
+  if (n > max) {
+    fail({
+      code: "BAD_FLAG",
+      message: `${name} must be <= ${max}, got: ${n}`,
+      details: { flag: name, value: n, max },
+    });
+  }
+  return n;
+}
+
+export function failBadProjectId(value) {
+  fail({
+    code: "BAD_PROJECT_ID",
+    message: `Argument '${value}' is not a project id. Project IDs must start with 'prj_'.`,
+    hint: "Omit the project id to use the active project, or pass the full prj_... id.",
+    details: { value, expected_prefix: "prj_" },
+  });
+}
+
+export function positionalArgs(args = [], flagsWithValues = []) {
+  const valueFlags = new Set(flagsWithValues);
+  const out = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (valueFlags.has(arg)) {
+      i += 1;
+      continue;
+    }
+    if (typeof arg === "string" && arg.startsWith("-")) continue;
+    out.push(arg);
+  }
+  return out;
+}
+
+function closestFlag(flag, candidates) {
+  let best = null;
+  let bestDistance = Number.POSITIVE_INFINITY;
+  for (const candidate of candidates) {
+    const d = levenshtein(flag, candidate);
+    if (d < bestDistance) {
+      best = candidate;
+      bestDistance = d;
+    }
+  }
+  if (!best) return null;
+  return bestDistance <= 3 ? best : null;
+}
+
+function levenshtein(a, b) {
+  const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  const curr = Array.from({ length: b.length + 1 }, () => 0);
+  for (let i = 1; i <= a.length; i++) {
+    curr[0] = i;
+    for (let j = 1; j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(
+        curr[j - 1] + 1,
+        prev[j] + 1,
+        prev[j - 1] + cost,
+      );
+    }
+    for (let j = 0; j <= b.length; j++) prev[j] = curr[j];
+  }
+  return prev[b.length];
+}

package/lib/auth.mjs

@@ -93,7 +93,7 @@ Notes:
 
 Examples:
   run402 auth settings --allow-password-set true
-  run402 auth settings --allow-password-set false --project abc123
+  run402 auth settings --allow-password-set false --project prj_abc123
 `,
   providers: `run402 auth providers — List available auth providers
 
@@ -105,7 +105,7 @@ Options:
 
 Examples:
   run402 auth providers
-  run402 auth providers --project abc123
+  run402 auth providers --project prj_abc123
 `,
 };
 

package/lib/blob.mjs

@@ -37,6 +37,7 @@ import { pipeline } from "node:stream/promises";
 import { resolveProject, resolveProjectId, API } from "./config.mjs";
 import { getSdk } from "./sdk.mjs";
 import { reportSdkError, fail } from "./sdk-errors.mjs";
+import { assertKnownFlags, hasHelp, normalizeArgv, parseIntegerFlag } from "./argparse.mjs";
 
 const HELP = `run402 blob — Direct-to-S3 blob storage
 
@@ -62,13 +63,13 @@ Options:
   --ttl <seconds>     Signed-URL TTL (sign only; default 3600, max 604800)
 
 Examples:
-  run402 blob put ./artifact.tgz --project abc123
-  run402 blob put ./dist/**/*.png --project abc123 --key assets/
-  run402 blob put huge.bin --project abc123 --immutable
-  run402 blob get images/logo.png --output /tmp/logo.png --project abc123
-  run402 blob ls --project abc123 --prefix images/
-  run402 blob rm images/logo.png --project abc123
-  run402 blob sign images/logo.png --project abc123 --ttl 600
+  run402 blob put ./artifact.tgz --project prj_abc123
+  run402 blob put ./dist/**/*.png --project prj_abc123 --key assets/
+  run402 blob put huge.bin --project prj_abc123 --immutable
+  run402 blob get images/logo.png --output /tmp/logo.png --project prj_abc123
+  run402 blob ls --project prj_abc123 --prefix images/
+  run402 blob rm images/logo.png --project prj_abc123
+  run402 blob sign images/logo.png --project prj_abc123 --ttl 600
 `;
 
 const SUB_HELP = {
@@ -90,9 +91,9 @@ Options:
   --json              Emit NDJSON progress events on stdout (for agent consumption)
 
 Examples:
-  run402 blob put ./artifact.tgz --project abc123
-  run402 blob put ./dist/**/*.png --project abc123 --key assets/
-  run402 blob put huge.bin --project abc123 --immutable --concurrency 8
+  run402 blob put ./artifact.tgz --project prj_abc123
+  run402 blob put ./dist/**/*.png --project prj_abc123 --key assets/
+  run402 blob put huge.bin --project prj_abc123 --immutable --concurrency 8
 `,
   get: `run402 blob get — Download a blob by key
 
@@ -107,7 +108,7 @@ Options:
   --project <id>      Project ID (defaults to active project)
 
 Examples:
-  run402 blob get images/logo.png --output /tmp/logo.png --project abc123
+  run402 blob get images/logo.png --output /tmp/logo.png --project prj_abc123
 `,
   ls: `run402 blob ls — List blob keys in a project
 
@@ -120,8 +121,8 @@ Options:
   --limit <n>         Max results (default 100, max 1000)
 
 Examples:
-  run402 blob ls --project abc123
-  run402 blob ls --project abc123 --prefix images/ --limit 500
+  run402 blob ls --project prj_abc123
+  run402 blob ls --project prj_abc123 --prefix images/ --limit 500
 `,
   rm: `run402 blob rm — Delete a blob
 
@@ -135,7 +136,7 @@ Options:
   --project <id>      Project ID (defaults to active project)
 
 Examples:
-  run402 blob rm images/logo.png --project abc123
+  run402 blob rm images/logo.png --project prj_abc123
 `,
   sign: `run402 blob sign — Create a presigned download URL for a blob
 
@@ -150,7 +151,7 @@ Options:
   --ttl <seconds>     Signed-URL TTL (default 3600, max 604800)
 
 Examples:
-  run402 blob sign reports/2025-q4.pdf --project abc123 --ttl 600
+  run402 blob sign reports/2025-q4.pdf --project prj_abc123 --ttl 600
 `,
   diagnose: `run402 blob diagnose — Inspect the live CDN state for a public blob URL
 
@@ -186,7 +187,38 @@ function die(msg, exit_code = 1) {
   fail({ code: "BAD_USAGE", message: msg, exit_code });
 }
 
-function parseArgs(args) {
+function dieApiFailure(prefix, http, body) {
+  if (body && typeof body === "object" && !Array.isArray(body)) {
+    const envelope = { status: "error", http, ...body };
+    if (!envelope.message && envelope.error) envelope.message = envelope.error;
+    console.error(JSON.stringify(envelope));
+    process.exit(1);
+  }
+  fail({
+    message: `${prefix}: HTTP ${http}${typeof body === "string" && body ? `: ${body.slice(0, 500)}` : ""}`,
+    details: { http },
+  });
+}
+
+function parseArgs(rawArgs) {
+  const args = normalizeArgv(rawArgs);
+  const valueFlags = ["--project", "--key", "--concurrency", "--prefix", "--limit", "--output", "-o", "--ttl"];
+  assertKnownFlags(args, [
+    "--project",
+    "--key",
+    "--private",
+    "--immutable",
+    "--concurrency",
+    "--no-resume",
+    "--json",
+    "--prefix",
+    "--limit",
+    "--output",
+    "-o",
+    "--ttl",
+    "--help",
+    "-h",
+  ], valueFlags);
   const out = { positional: [], project: null, key: null, private: false, immutable: false,
                  concurrency: 4, resume: true, json: false, prefix: null, limit: null,
                  output: null, ttl: null };
@@ -196,13 +228,13 @@ function parseArgs(args) {
     else if (a === "--key") out.key = args[++i];
     else if (a === "--private") out.private = true;
     else if (a === "--immutable") out.immutable = true;
-    else if (a === "--concurrency") out.concurrency = parseInt(args[++i], 10);
+    else if (a === "--concurrency") out.concurrency = parseIntegerFlag("--concurrency", args[++i], { min: 1 });
     else if (a === "--no-resume") out.resume = false;
     else if (a === "--json") out.json = true;
     else if (a === "--prefix") out.prefix = args[++i];
-    else if (a === "--limit") out.limit = parseInt(args[++i], 10);
+    else if (a === "--limit") out.limit = parseIntegerFlag("--limit", args[++i], { min: 1, max: 1000 });
     else if (a === "--output" || a === "-o") out.output = args[++i];
-    else if (a === "--ttl") out.ttl = parseInt(args[++i], 10);
+    else if (a === "--ttl") out.ttl = parseIntegerFlag("--ttl", args[++i], { min: 1, max: 604800 });
     else if (!a.startsWith("--")) out.positional.push(a);
   }
   return out;
@@ -284,7 +316,7 @@ async function putOne(project, filePath, opts) {
       immutable: opts.immutable,
       sha256,
     });
-    if (init.status !== 201) die(`Init failed: HTTP ${init.status}: ${JSON.stringify(init.body)}`);
+    if (init.status !== 201) dieApiFailure("Init failed", init.status, init.body);
     initRes = init.body;
     saveState({
       upload_id: initRes.upload_id,
@@ -330,7 +362,7 @@ async function putOne(project, filePath, opts) {
     ? { parts: etags.map((e, i) => ({ part_number: i + 1, etag: e.etag })) }
     : {};
   const complete = await apiFetch(`${API}/storage/v1/uploads/${state.upload_id}/complete`, "POST", project, body);
-  if (complete.status !== 200) die(`Complete failed: HTTP ${complete.status}: ${JSON.stringify(complete.body)}`);
+  if (complete.status !== 200) dieApiFailure("Complete failed", complete.status, complete.body);
 
   removeState(state.upload_id);
   log(opts, { event: "done", ...complete.body });
@@ -565,7 +597,8 @@ export async function run(sub, args) {
     console.log(HELP);
     process.exit(0);
   }
-  if (Array.isArray(args) && (args.includes("--help") || args.includes("-h"))) {
+  args = normalizeArgv(args);
+  if (Array.isArray(args) && hasHelp(args)) {
     console.log(SUB_HELP[sub] || HELP);
     process.exit(0);
   }

package/lib/functions.mjs

@@ -2,6 +2,7 @@ import { readFileSync } from "fs";
 import { findProject, API } from "./config.mjs";
 import { getSdk } from "./sdk.mjs";
 import { reportSdkError, fail } from "./sdk-errors.mjs";
+import { assertKnownFlags, hasHelp, normalizeArgv, parseIntegerFlag } from "./argparse.mjs";
 
 const HELP = `run402 functions — Manage serverless functions
 
@@ -21,18 +22,18 @@ Subcommands:
   delete <id> <name>                   Delete a function
 
 Examples:
-  run402 functions deploy abc123 stripe-webhook --file handler.ts
-  run402 functions deploy abc123 send-reminders --file remind.ts --schedule '*/15 * * * *'
-  run402 functions deploy abc123 send-reminders --file remind.ts --schedule ''   # remove schedule
-  run402 functions invoke abc123 stripe-webhook --body '{"event":"test"}'
-  run402 functions logs abc123 stripe-webhook --tail 100
-  run402 functions logs abc123 stripe-webhook --since 2026-03-29T14:00:00Z
-  run402 functions logs abc123 stripe-webhook --follow
-  run402 functions update abc123 send-reminders --schedule '0 */4 * * *'
-  run402 functions update abc123 send-reminders --schedule-remove
-  run402 functions update abc123 my-func --timeout 15 --memory 256
-  run402 functions list abc123
-  run402 functions delete abc123 stripe-webhook
+  run402 functions deploy prj_abc123 stripe-webhook --file handler.ts
+  run402 functions deploy prj_abc123 send-reminders --file remind.ts --schedule '*/15 * * * *'
+  run402 functions deploy prj_abc123 send-reminders --file remind.ts --schedule ''   # remove schedule
+  run402 functions invoke prj_abc123 stripe-webhook --body '{"event":"test"}'
+  run402 functions logs prj_abc123 stripe-webhook --tail 100
+  run402 functions logs prj_abc123 stripe-webhook --since 2026-03-29T14:00:00Z
+  run402 functions logs prj_abc123 stripe-webhook --follow
+  run402 functions update prj_abc123 send-reminders --schedule '0 */4 * * *'
+  run402 functions update prj_abc123 send-reminders --schedule-remove
+  run402 functions update prj_abc123 my-func --timeout 15 --memory 256
+  run402 functions list prj_abc123
+  run402 functions delete prj_abc123 stripe-webhook
 
 Notes:
   - Code must export a default async function: export default async (req: Request) => Response
@@ -77,10 +78,10 @@ Notes:
     notes such as bundle-size advisories
 
 Examples:
-  run402 functions deploy abc123 stripe-webhook --file handler.ts
-  run402 functions deploy abc123 send-reminders --file remind.ts \\
+  run402 functions deploy prj_abc123 stripe-webhook --file handler.ts
+  run402 functions deploy prj_abc123 send-reminders --file remind.ts \\
     --schedule '*/15 * * * *'
-  run402 functions deploy abc123 send-reminders --file remind.ts --schedule ''
+  run402 functions deploy prj_abc123 send-reminders --file remind.ts --schedule ''
 `,
   invoke: `run402 functions invoke — Invoke a deployed function
 
@@ -96,8 +97,8 @@ Options:
   --body <json>       Request body (ignored for GET/HEAD)
 
 Examples:
-  run402 functions invoke abc123 stripe-webhook --body '{"event":"test"}'
-  run402 functions invoke abc123 ping --method GET
+  run402 functions invoke prj_abc123 stripe-webhook --body '{"event":"test"}'
+  run402 functions invoke prj_abc123 ping --method GET
 `,
   logs: `run402 functions logs — Fetch or tail function logs
 
@@ -114,9 +115,9 @@ Options:
   --follow            Poll every 3s and stream new entries (Ctrl-C to stop)
 
 Examples:
-  run402 functions logs abc123 stripe-webhook --tail 100
-  run402 functions logs abc123 stripe-webhook --since 2026-03-29T14:00:00Z
-  run402 functions logs abc123 stripe-webhook --follow
+  run402 functions logs prj_abc123 stripe-webhook --tail 100
+  run402 functions logs prj_abc123 stripe-webhook --since 2026-03-29T14:00:00Z
+  run402 functions logs prj_abc123 stripe-webhook --follow
 `,
   update: `run402 functions update — Update function config without re-deploying
 
@@ -137,18 +138,20 @@ Notes:
   Must provide at least one of the options above.
 
 Examples:
-  run402 functions update abc123 send-reminders --schedule '0 */4 * * *'
-  run402 functions update abc123 send-reminders --schedule-remove
-  run402 functions update abc123 my-func --timeout 15 --memory 256
+  run402 functions update prj_abc123 send-reminders --schedule '0 */4 * * *'
+  run402 functions update prj_abc123 send-reminders --schedule-remove
+  run402 functions update prj_abc123 my-func --timeout 15 --memory 256
 `,
 };
 
 async function deploy(projectId, name, args) {
+  assertRequiredProjectAndName(projectId, name, "run402 functions deploy <project_id> <name> --file <file>");
+  assertKnownFlags(args, ["--file", "--timeout", "--memory", "--deps", "--schedule", "--help", "-h"], ["--file", "--timeout", "--memory", "--deps", "--schedule"]);
   const opts = { file: null, timeout: undefined, memory: undefined, deps: undefined, schedule: undefined };
   for (let i = 0; i < args.length; i++) {
     if (args[i] === "--file" && args[i + 1]) opts.file = args[++i];
-    if (args[i] === "--timeout" && args[i + 1]) opts.timeout = parseInt(args[++i]);
-    if (args[i] === "--memory" && args[i + 1]) opts.memory = parseInt(args[++i]);
+    if (args[i] === "--timeout") opts.timeout = parseIntegerFlag("--timeout", args[++i], { min: 1 });
+    if (args[i] === "--memory") opts.memory = parseIntegerFlag("--memory", args[++i], { min: 1 });
     if (args[i] === "--deps" && args[i + 1]) opts.deps = args[++i].split(",");
     if (args[i] === "--schedule" && i + 1 < args.length) opts.schedule = args[++i];
   }
@@ -175,6 +178,8 @@ async function deploy(projectId, name, args) {
 }
 
 async function invoke(projectId, name, args) {
+  assertRequiredProjectAndName(projectId, name, "run402 functions invoke <project_id> <name> [--method <M>] [--body <json>]");
+  assertKnownFlags(args, ["--method", "--body", "--help", "-h"], ["--method", "--body"]);
   const opts = { method: "POST", body: undefined };
   for (let i = 0; i < args.length; i++) {
     if (args[i] === "--method" && args[i + 1]) opts.method = args[++i];
@@ -198,11 +203,13 @@ async function invoke(projectId, name, args) {
 }
 
 async function logs(projectId, name, args) {
+  assertRequiredProjectAndName(projectId, name, "run402 functions logs <project_id> <name> [--tail <n>]");
+  assertKnownFlags(args, ["--tail", "--since", "--follow", "--help", "-h"], ["--tail", "--since"]);
   let tail = 50;
   let since = undefined;
   let follow = false;
   for (let i = 0; i < args.length; i++) {
-    if (args[i] === "--tail" && args[i + 1]) tail = parseInt(args[++i]);
+    if (args[i] === "--tail") tail = parseIntegerFlag("--tail", args[++i], { min: 1 });
     if (args[i] === "--since" && args[i + 1]) since = args[++i];
     if (args[i] === "--follow") follow = true;
   }
@@ -269,6 +276,8 @@ async function logs(projectId, name, args) {
 }
 
 async function update(projectId, name, args) {
+  assertRequiredProjectAndName(projectId, name, "run402 functions update <project_id> <name> [options]");
+  assertKnownFlags(args, ["--schedule", "--schedule-remove", "--timeout", "--memory", "--help", "-h"], ["--schedule", "--timeout", "--memory"]);
   let schedule = undefined;
   let scheduleRemove = false;
   let timeout = undefined;
@@ -276,8 +285,8 @@ async function update(projectId, name, args) {
   for (let i = 0; i < args.length; i++) {
     if (args[i] === "--schedule" && i + 1 < args.length) schedule = args[++i];
     if (args[i] === "--schedule-remove") scheduleRemove = true;
-    if (args[i] === "--timeout" && args[i + 1]) timeout = parseInt(args[++i]);
-    if (args[i] === "--memory" && args[i + 1]) memory = parseInt(args[++i]);
+    if (args[i] === "--timeout") timeout = parseIntegerFlag("--timeout", args[++i], { min: 1 });
+    if (args[i] === "--memory") memory = parseIntegerFlag("--memory", args[++i], { min: 1 });
   }
 
   const updateOpts = {};
@@ -305,6 +314,7 @@ async function update(projectId, name, args) {
 }
 
 async function list(projectId) {
+  assertRequiredProject(projectId, "run402 functions list <project_id>");
   try {
     const data = await getSdk().functions.list(projectId);
     console.log(JSON.stringify(data, null, 2));
@@ -314,6 +324,7 @@ async function list(projectId) {
 }
 
 async function deleteFunction(projectId, name) {
+  assertRequiredProjectAndName(projectId, name, "run402 functions delete <project_id> <name>");
   try {
     await getSdk().functions.delete(projectId, name);
     console.log(JSON.stringify({ status: "ok", message: `Function '${name}' deleted.` }));
@@ -324,7 +335,8 @@ async function deleteFunction(projectId, name) {
 
 export async function run(sub, args) {
   if (!sub || sub === '--help' || sub === '-h') { console.log(HELP); process.exit(0); }
-  if (Array.isArray(args) && (args.includes("--help") || args.includes("-h"))) {
+  args = normalizeArgv(args);
+  if (Array.isArray(args) && hasHelp(args)) {
     console.log(SUB_HELP[sub] || HELP);
     process.exit(0);
   }
@@ -341,3 +353,24 @@ export async function run(sub, args) {
       process.exit(1);
   }
 }
+
+function assertRequiredProject(projectId, usage) {
+  if (!projectId || String(projectId).startsWith("-")) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing <project_id>.",
+      hint: usage,
+    });
+  }
+}
+
+function assertRequiredProjectAndName(projectId, name, usage) {
+  assertRequiredProject(projectId, usage);
+  if (!name || String(name).startsWith("-")) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing <name>.",
+      hint: usage,
+    });
+  }
+}