feedbackbasket-cli 0.3.1 → 0.3.4

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/commands/bugs.js

@@ -4,7 +4,9 @@ import { AuthManager } from '../auth/manager.js';
 import { loadConfig } from '../config/config.js';
 import { errAuth } from '../output/errors.js';
 import { brand, divider } from '../output/theme.js';
-function resolveProjectId(optProject) {
+function resolveProjectId(optProject, all) {
+    if (all)
+        return undefined;
     if (optProject)
         return optProject;
     const config = loadConfig();
@@ -17,6 +19,7 @@ export function createBugsCommand(getWriter) {
         .command('list')
         .description('List bug reports with severity classification')
         .option('--project <id>', 'Filter by project ID')
+        .option('--all', 'Show bugs across all projects (ignore default project)')
         .option('--severity <level>', 'Filter by severity (high, medium, low)')
         .option('--status <status>', 'Filter by status')
         .option('--search <query>', 'Search bug content')
@@ -27,7 +30,7 @@ export function createBugsCommand(getWriter) {
         const writer = getWriter();
         const client = requireClient();
         const result = await client.getBugReports({
-            projectId: resolveProjectId(opts.project),
+            projectId: resolveProjectId(opts.project, opts.all),
             status: opts.status,
             severity: opts.severity,
             search: opts.search,
@@ -57,12 +60,13 @@ export function createBugsCommand(getWriter) {
     });
     bugs
         .command('stats')
+        .option('--all', 'Show stats across all projects')
         .description('Show bug statistics summary')
         .option('--project <id>', 'Filter by project ID')
         .action(async (opts) => {
         const writer = getWriter();
         const client = requireClient();
-        const stats = await client.getBugStats({ projectId: opts.project });
+        const stats = await client.getBugStats({ projectId: resolveProjectId(opts.project, opts.all) });
         if (!writer.isMachineOutput()) {
             renderBugStats(stats);
         }
@@ -110,7 +114,8 @@ function renderBugList(bugs) {
         const sev = severityColor[bug.severity](`[${bug.severity.toUpperCase()}]`);
         const status = brand.muted(`[${bug.status}]`);
         const content = bug.content.length > 75 ? bug.content.slice(0, 72) + '...' : bug.content;
-        console.log(`${sev} ${status} ${brand.muted(bug.id)}`);
+        const proj = bug.project ? brand.primary(bug.project.name) : '';
+        console.log(`${sev} ${status} ${proj} ${brand.muted(bug.id)}`);
         console.log(`  ${content}`);
         if (bug.aiSummary) {
             console.log(`  ${brand.hint(bug.aiSummary)}`);

package/dist/src/commands/feedback.js

@@ -4,7 +4,9 @@ import { AuthManager } from '../auth/manager.js';
 import { loadConfig } from '../config/config.js';
 import { errAuth } from '../output/errors.js';
 import { brand } from '../output/theme.js';
-function resolveProjectId(optProject) {
+function resolveProjectId(optProject, all) {
+    if (all)
+        return undefined;
     if (optProject)
         return optProject;
     const config = loadConfig();
@@ -29,6 +31,7 @@ export function createFeedbackCommand(getWriter) {
         .command('list')
         .description('List feedback with optional filters')
         .option('--project <id>', 'Filter by project ID')
+        .option('--all', 'Show feedback across all projects (ignore default project)')
         .option('--category <category>', 'Filter by category (BUG, FEATURE_REQUEST, IMPROVEMENT, QUESTION)')
         .option('--status <status>', 'Filter by status (OPEN, UNDER_REVIEW, PLANNED, IN_PROGRESS, COMPLETE, CLOSED)')
         .option('--sentiment <sentiment>', 'Filter by sentiment (POSITIVE, NEGATIVE, NEUTRAL)')
@@ -40,7 +43,7 @@ export function createFeedbackCommand(getWriter) {
         const writer = getWriter();
         const client = requireClient();
         const result = await client.getFeedback({
-            projectId: resolveProjectId(opts.project),
+            projectId: resolveProjectId(opts.project, opts.all),
             category: opts.category,
             status: opts.status,
             sentiment: opts.sentiment,
@@ -146,7 +149,8 @@ function renderFeedbackList(items) {
         const priority = priorityLabel(item.aiPriorityScore);
         const content = item.content.length > 80 ? item.content.slice(0, 77) + '...' : item.content;
         const status = brand.muted(`[${item.status}]`);
-        console.log(`${cat} ${priority} ${status} ${brand.muted(item.id)}`);
+        const proj = item.project ? brand.primary(item.project.name) : '';
+        console.log(`${cat} ${priority} ${status} ${proj} ${brand.muted(item.id)}`);
         console.log(`  ${content}`);
         if (item.aiSummary) {
             console.log(`  ${brand.hint(item.aiSummary)}`);

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.4";
+export declare const USER_AGENT = "FeedbackBasket-CLI/0.3.4";

package/dist/src/version.js

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

package/package.json

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