@vibecodr/cli 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.2.2
+
+- show command-specific help for nested `vibecodr pulse <command> --help|-h|-help` requests
+
+## 0.2.1
+
+- preserve encrypted offline sessions when refresh fails because the authorization server is temporarily unavailable
+- continue clearing stored auth on OAuth `invalid_grant` so revoked or expired refresh tokens fail closed
+
 ## 0.2.0
 
 - rename the npm package to `@vibecodr/cli` while keeping `vibecodr` as the primary executable and `vibecodr-mcp` as a compatibility alias

package/dist/auth/token-manager.js

@@ -23,6 +23,12 @@ function computeExpiresAt(expiresIn) {
         return undefined;
     return new Date(Date.now() + expiresIn * 1000).toISOString();
 }
+function oauthErrorCode(error) {
+    if (!error || typeof error !== "object")
+        return undefined;
+    const code = error.errorCode;
+    return typeof code === "string" ? code : undefined;
+}
 function normalizeServerUrlForSessionMatch(value) {
     if (!value)
         return undefined;
@@ -285,10 +291,17 @@ export class TokenManager {
             resource,
             ...(discovery.authorizationServerMetadata ? { metadata: discovery.authorizationServerMetadata } : {})
         }).catch(async (error) => {
-            await this.secretStore.delete(profileName).catch(() => undefined);
-            throw new CliError("auth.refresh_failed", "Failed to refresh the stored session.", EXIT_CODES.authFailed, {
+            const invalidGrant = oauthErrorCode(error) === "invalid_grant";
+            if (invalidGrant) {
+                await this.secretStore.delete(profileName).catch(() => undefined);
+            }
+            throw new CliError("auth.refresh_failed", invalidGrant
+                ? "The stored refresh token is invalid or expired."
+                : "Failed to refresh the stored session.", EXIT_CODES.authFailed, {
                 cause: error,
-                nextStep: "Run vibecodr login to re-authenticate."
+                nextStep: invalidGrant
+                    ? "Run vibecodr login to re-authenticate."
+                    : "Retry after the authorization server recovers. The stored offline session was preserved."
             });
         });
         const updated = {

package/dist/commands/pulse.js

@@ -13,7 +13,22 @@ const PULSE_ACTIONS = {
     archive: { toolName: "archive_pulse", requiresConfirm: true },
     restore: { toolName: "restore_pulse", requiresConfirm: true }
 };
-function pulseHelpText() {
+const PULSE_COMMAND_HELP = {
+    list: "Usage: vibecodr pulse list [--limit <n>] [--offset <n>]",
+    get: "Usage: vibecodr pulse get <pulse-id>",
+    status: "Usage: vibecodr pulse status <pulse-id>",
+    run: "Usage: vibecodr pulse run <pulse-id> [--input-json <json> | --input-file <path>] --confirm",
+    archive: "Usage: vibecodr pulse archive <pulse-id> --confirm",
+    restore: "Usage: vibecodr pulse restore <pulse-id> --confirm",
+    create: "Usage: vibecodr pulse create --name <name> (--code <source> | --code-file <path>) [--descriptor-json <json> | --descriptor-file <path>] [--slug <slug>] [--visibility public|unlisted|private] --confirm",
+    deploy: "Usage: vibecodr pulse deploy --name <name> (--code <source> | --code-file <path>) [--descriptor-json <json> | --descriptor-file <path>] [--slug <slug>] [--visibility public|unlisted|private] --confirm"
+};
+function pulseHelpText(subcommand) {
+    if (subcommand) {
+        const commandHelp = PULSE_COMMAND_HELP[subcommand];
+        if (commandHelp)
+            return commandHelp;
+    }
     return [
         "Usage: vibecodr pulse <command> [options]",
         "",
@@ -86,10 +101,14 @@ async function invokePulseTool(context, toolName, input) {
 export async function runPulseCommand(args, context) {
     const subcommand = args[0];
     const commandArgs = args.slice(1);
-    if (!subcommand || isHelpToken(subcommand) || commandArgs.some((arg) => isHelpToken(arg))) {
+    if (!subcommand || isHelpToken(subcommand)) {
         context.output.info(pulseHelpText());
         return;
     }
+    if (commandArgs.some((arg) => isHelpToken(arg))) {
+        context.output.info(pulseHelpText(subcommand));
+        return;
+    }
     if (subcommand === "create" || subcommand === "deploy") {
         await runPulsePublishCommand(commandArgs, context);
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecodr/cli",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Vibecodr CLI for login, live MCP tool discovery, and live tool invocation.",
   "license": "Apache-2.0",
   "type": "module",