fix: add --yes/-y to KNOWN_FLAGS so spawn delete --name <name> --yes works (#3024)

PR #3015 added --yes and -y flags to the delete command but didn't add
them to KNOWN_FLAGS in flags.ts. This caused `spawn delete --name foo --yes`
to fail with "Unknown flag: --yes" because checkUnknownFlags runs before
dispatchDeleteCommand strips these flags.

Also adds delete-specific flags to --help documentation.

Agent: code-health

Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: 3 people

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/spawn",
-  "version": "0.26.12",
+  "version": "0.26.13",
   "type": "module",
   "bin": {
     "spawn": "cli.js"

packages/cli/src/__tests__/unknown-flags.test.ts

@@ -89,6 +89,8 @@ describe("Unknown Flag Detection", () => {
         "--reauth",
         "--prune",
         "--json",
+        "--yes",
+        "-y",
       ];
       for (const flag of knownFlagsToTest) {
         expect(
@@ -228,6 +230,8 @@ describe("KNOWN_FLAGS completeness", () => {
       "--fast",
       "--user",
       "-u",
+      "--yes",
+      "-y",
     ];
     // Every flag in the expected list must exist in KNOWN_FLAGS.
     for (const flag of expected) {

packages/cli/src/commands/help.ts

@@ -31,6 +31,7 @@ function getHelpUsageSection(): string {
   spawn delete                       Delete a previously spawned server (aliases: rm, destroy, kill)
   spawn delete -a <agent>            Filter servers by agent
   spawn delete -c <cloud>            Filter servers by cloud
+  spawn delete --name <name> --yes   Headless delete by name (no prompts)
   spawn status                       Show live state of cloud servers (aliases: ps)
   spawn status -a <agent>            Filter status by agent (or --agent)
   spawn status -c <cloud>            Filter status by cloud (or --cloud)

packages/cli/src/flags.ts

@@ -38,6 +38,8 @@ export const KNOWN_FLAGS = new Set([
   "--fast",
   "--user",
   "-u",
+  "--yes",
+  "-y",
 ]);
 
 /** Return the first unknown flag in args, or null if all are known/positional */

packages/cli/src/index.ts

@@ -149,6 +149,10 @@ function checkUnknownFlags(args: string[]): void {
     console.error(`    ${pc.cyan("-c, --cloud")}         Filter history by cloud`);
     console.error(`    ${pc.cyan("--clear")}             Clear all spawn history`);
     console.error();
+    console.error(`  For ${pc.cyan("spawn delete")}:`);
+    console.error(`    ${pc.cyan("--name <name>")}       Filter by server name or ID`);
+    console.error(`    ${pc.cyan("--yes, -y")}           Skip confirmation (required for non-interactive)`);
+    console.error();
     console.error(`  Run ${pc.cyan("spawn help")} for full usage information.`);
     process.exit(1);
   }