feedbackbasket-cli 0.3.1 → 0.3.2

package/dist/src/cli.js

@@ -11,6 +11,7 @@ import { createDoctorCommand } from './commands/doctor.js';
 import { createSetupCommand } from './commands/setup.js';
 import { createWidgetCommand } from './commands/widget.js';
 import { createTeamCommand } from './commands/team.js';
+import { renderRootHelp } from './help.js';
 let writer;
 function resolveFormat(opts) {
     if (opts.agent || opts.quiet)
@@ -28,11 +29,13 @@ export function run() {
     const program = new Command('feedbackbasket')
         .version(VERSION, '-v, --version')
         .description('Command-line interface for FeedbackBasket')
-        .option('--json', 'Output as JSON envelope')
-        .option('--quiet', 'Output raw data only (no envelope)')
+        .option('-j, --json', 'Output as JSON envelope')
+        .option('-q, --quiet', 'Output raw data only (no envelope)')
         .option('--agent', 'Agent mode (alias for --quiet)')
-        .option('--md', 'Output as Markdown')
+        .option('-m, --md', 'Output as Markdown')
         .option('--base-url <url>', 'API base URL override')
+        .addHelpText('beforeAll', '')
+        .helpOption('--help', 'Show help for command')
         .hook('preAction', (thisCommand) => {
         const opts = thisCommand.opts();
         const format = resolveFormat(opts);
@@ -41,10 +44,20 @@ export function run() {
             setBaseUrlOverride(opts.baseUrl);
         }
     });
+    // Custom help for root command
+    program.configureHelp({
+        formatHelp: (cmd, helper) => {
+            if (cmd.name() === 'feedbackbasket') {
+                return renderRootHelp();
+            }
+            // Subcommands use default Commander help
+            return helper.formatHelp(cmd, helper);
+        },
+    });
     // Register commands
     program.addCommand(createAuthCommand(getWriter));
-    program.addCommand(createLoginCommand(getWriter)); // alias: feedbackbasket login
-    program.addCommand(createLogoutCommand(getWriter)); // alias: feedbackbasket logout
+    program.addCommand(createLoginCommand(getWriter));
+    program.addCommand(createLogoutCommand(getWriter));
     program.addCommand(createProjectsCommand(getWriter));
     program.addCommand(createFeedbackCommand(getWriter));
     program.addCommand(createBugsCommand(getWriter));

package/dist/src/help.d.ts

@@ -0,0 +1 @@
+export declare function renderRootHelp(): string;

package/dist/src/help.js

@@ -0,0 +1,72 @@
+import chalk from 'chalk';
+import { brand, logo } from './output/theme.js';
+import { VERSION } from './version.js';
+const INDENT = '    ';
+function section(title) {
+    return chalk.bold(title.toUpperCase());
+}
+function cmd(name, desc, nameWidth = 16) {
+    return `${INDENT}${brand.command(name.padEnd(nameWidth))}  ${desc}`;
+}
+function flag(name, desc, nameWidth = 18) {
+    return `${INDENT}${name.padEnd(nameWidth)}  ${desc}`;
+}
+export function renderRootHelp() {
+    const lines = [];
+    lines.push('');
+    lines.push(`  ${logo()} CLI ${brand.muted(`v${VERSION}`)}`);
+    lines.push('');
+    lines.push(`  ${brand.muted('The command-line interface for FeedbackBasket.')}`);
+    lines.push(`  ${brand.muted('Manage projects, feedback, widgets, and team from your terminal.')}`);
+    lines.push('');
+    // Core Commands
+    lines.push(section('  CORE COMMANDS'));
+    lines.push(cmd('projects', 'Manage projects (create, show, update, delete)'));
+    lines.push(cmd('feedback', 'View and manage feedback'));
+    lines.push(cmd('bugs', 'View bug reports with severity'));
+    lines.push(cmd('widget', 'Manage feedback widget & get embed code'));
+    lines.push(cmd('team', 'Manage organization members'));
+    lines.push('');
+    // Shortcuts
+    lines.push(section('  SHORTCUTS'));
+    lines.push(cmd('login', 'Authenticate with FeedbackBasket'));
+    lines.push(cmd('logout', 'Clear stored credentials'));
+    lines.push('');
+    // Search & Export
+    lines.push(section('  SEARCH & EXPORT'));
+    lines.push(cmd('feedback search', 'Search feedback across projects'));
+    lines.push(cmd('feedback export', 'Export feedback to CSV, Markdown, or JSON'));
+    lines.push(cmd('bugs stats', 'Bug statistics summary'));
+    lines.push('');
+    // Auth & Config
+    lines.push(section('  AUTH & CONFIG'));
+    lines.push(cmd('auth', 'Manage authentication (login, logout, status, token)'));
+    lines.push(cmd('doctor', 'Run diagnostics to check CLI health'));
+    lines.push(cmd('setup', 'Set up agent integrations (Claude Code)'));
+    lines.push('');
+    // Flags
+    lines.push(section('  FLAGS'));
+    lines.push(flag('-j, --json', 'Output as JSON envelope'));
+    lines.push(flag('-q, --quiet', 'Quiet output (data only, no envelope)'));
+    lines.push(flag('--agent', 'Agent mode (alias for --quiet)'));
+    lines.push(flag('-m, --md', 'Output as Markdown'));
+    lines.push(flag('--base-url <url>', 'API base URL override'));
+    lines.push(flag('--help', 'Show help for command'));
+    lines.push(flag('--version', 'Show version'));
+    lines.push('');
+    // Examples
+    lines.push(section('  EXAMPLES'));
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket projects list`);
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket feedback list --category BUG --status OPEN`);
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket bugs list --severity high`);
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket widget script myapp`);
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket projects create "My App" --url https://myapp.com`);
+    lines.push('');
+    // Learn More
+    lines.push(section('  LEARN MORE'));
+    lines.push(`${INDENT}${brand.command('feedbackbasket <command> --help')}  Help for any command`);
+    lines.push(`${INDENT}${brand.command('feedbackbasket doctor')}             Check CLI health`);
+    lines.push(`${INDENT}${brand.muted('Docs:')} https://feedbackbasket.com/docs/cli`);
+    lines.push('');
+    return lines.join('\n');
+}

package/dist/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.3.1";
-export declare const USER_AGENT = "FeedbackBasket-CLI/0.3.1";
+export declare const VERSION = "0.3.2";
+export declare const USER_AGENT = "FeedbackBasket-CLI/0.3.2";

package/dist/src/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '0.3.1';
+export const VERSION = '0.3.2';
 export const USER_AGENT = `FeedbackBasket-CLI/${VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feedbackbasket-cli",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Command-line interface for FeedbackBasket — manage feedback from your terminal",
   "type": "module",
   "main": "dist/src/cli.js",