@go-labs-sg/rsvp 0.14.0 → 0.15.0

package/README.md

@@ -2,6 +2,20 @@
 
 JSON-first command-line access to Registration organizations, events, guests, check-in, payments, reporting, retention, and administrative operations.
 
+## First step: update before use
+
+Before starting a task, **update to the latest published release first**, including when an AI agent runs this CLI:
+
+```bash
+bun add --global @go-labs-sg/rsvp@latest
+rsvp version
+rsvp --help
+```
+
+Run this sequence once per task, not before every command. Re-read the updated help before choosing commands or flags. If updating fails, stop and report the failure rather than silently using an outdated CLI. If the user explicitly requested a pinned version or a development/staging build, preserve that version instead of replacing it with the public release.
+
+New installation? Follow the runtime and installation instructions below to install Bun first, then return to this step.
+
 ## Runtime and installation
 
 The CLI requires [Bun](https://bun.com/docs/installation) 1.4.0 or newer. npm distributes the package, while the installed command runs under Bun.
@@ -77,7 +91,7 @@ Argument-parsing errors use a safe command label and never echo option values,
 including roster JSON passed through `--payload`. Surrounding shell history and
 automation can still record arguments independently of the CLI's error output.
 
-Use `rsvp help` for the command catalogue. Every response is a JSON envelope on stdout; errors and diagnostics go to stderr. `rsvp manifest` emits the machine-readable command reference for tooling.
+Use `rsvp help` or `rsvp --help` for the command catalogue. `--help=true` and `--help=1` also show help; `--help=false` and `--help=0` preserve normal command execution. Other inline help values are rejected before command execution, even if a later `--help` flag is valid. Every response is a JSON envelope on stdout; errors and diagnostics go to stderr. `rsvp manifest` emits the machine-readable command reference for tooling.
 
 ## Public event page and images
 

package/dist/index.js

@@ -6692,6 +6692,7 @@ Object.assign(commands, {
   "waitlist offer respond": payloadCommand((api, input) => api.waitlist.respondToOffer.mutate(input), "Respond to a waitlist offer (--payload JSON).", ["state-change"])
 });
 var getCommandManifest = () => ({
+  beforeUse: "First step before each task: update to the latest published release with 'bun add --global @go-labs-sg/rsvp@latest', then run 'rsvp version' and 'rsvp --help' before using commands. Update once per task. If updating fails, stop and report it. Preserve an explicitly requested pinned or development/staging version.",
   commands: [
     {
       effects: [],
@@ -6730,6 +6731,7 @@ var getCommandManifest = () => ({
     }))
   ],
   globalOptions: [
+    "--help",
     "--api-url <url>",
     "--no-browser",
     "--organization-id <id>",
@@ -6792,6 +6794,7 @@ var booleanFlags = new Set([
   "--allow-external-write",
   "--allow-financial-write",
   "--allow-state-change",
+  "--help",
   "--no-browser"
 ]);
 var valueFlags = new Set([
@@ -6819,6 +6822,9 @@ var parseArgs = (argv) => {
       throw new CliUsageError(`Unknown option: ${name}.`);
     const inlineValue = equalSignIndex === -1 ? undefined : argument.slice(equalSignIndex + 1);
     if (inlineValue !== undefined) {
+      if (name === "--help" && !["true", "false", "1", "0"].includes(inlineValue)) {
+        throw new CliUsageError("--help accepts only true, false, 1, or 0.");
+      }
       flags.set(name, inlineValue);
       continue;
     }
@@ -6999,7 +7005,7 @@ var runRsvpCli = async (argv, dependencies) => {
   let command = "unknown";
   try {
     const parsed = parseArgs(argv);
-    const requestedCommand = parsed.positionals.join(" ") || "help";
+    const requestedCommand = isEnabledFlag(parsed.flags, "--help") ? "help" : parsed.positionals.join(" ") || "help";
     if (!knownCommandNames.has(requestedCommand)) {
       throw new CliUsageError("Unknown command. Run 'rsvp help' to list commands.");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-labs-sg/rsvp",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "RSVP CLI for authorized event operations.",
   "type": "module",
   "main": "./dist/index.js",