feedbackbasket-cli 0.6.1 → 0.8.0

package/README.md

@@ -22,6 +22,7 @@ feedbackbasket login --manual
 # Start exploring
 feedbackbasket projects list
 feedbackbasket feedback list
+feedbackbasket feedback create "Login button is broken" --project myapp --type bug
 feedbackbasket bugs list --severity high
 ```
 
@@ -35,6 +36,7 @@ Any AI agent with shell access (Claude Code, Codex, Cursor, OpenCode) can use th
 # Agents should use --agent flag for raw JSON output
 feedbackbasket projects list --agent
 feedbackbasket feedback list --category BUG --agent
+feedbackbasket feedback create "Login button is broken" --content "Clicking Log in does nothing in Safari." --project myapp --type bug --agent
 feedbackbasket feedback update <id> --status PLANNED --agent
 feedbackbasket widget script myproject --agent
 ```
@@ -87,6 +89,8 @@ feedbackbasket feedback show <id>                          # View detail, includ
 feedbackbasket feedback search "crash on mobile"           # Search shortcut
 
 # Write
+feedbackbasket feedback create "Title" --content "Body" --project myapp
+feedbackbasket feedback create "Login bug" --content "Clicking Log in does nothing" --project myapp --type bug --page-url https://example.com/login
 feedbackbasket feedback update <id> --status PLANNED       # Update status
 feedbackbasket feedback update <id> --category BUG         # Update category
 feedbackbasket feedback reply <id> "Thanks for reporting!" # Email the submitter
@@ -123,6 +127,7 @@ feedbackbasket widget settings myapp --position bottom-left --display modal
 feedbackbasket widget settings myapp --email-required --intro "How can we improve?"
 feedbackbasket widget settings myapp --button-radius 10 --button-size regular
 feedbackbasket widget settings myapp --show-email --allow-attachments --guided
+feedbackbasket widget settings myapp --email-read-only --hide-email-when-prefilled
 
 # Configure guided feedback types and follow-up questions
 feedbackbasket widget flow myapp
@@ -134,6 +139,8 @@ feedbackbasket widget flow myapp --config ./feedback-flow.json
 feedbackbasket widget script myapp
 ```
 
+Use `--email-read-only` and `--hide-email-when-prefilled` with runtime `userEmail` values from your app. These settings do not store visitor emails in FeedbackBasket widget settings.
+
 `widget flow --config` accepts either a `feedbackFlow` object or a JSON object with a `feedbackFlow` key. V1 supports guided mode with `text`, `textarea`, and `single_choice` follow-up questions.
 
 ```json

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectsResponse, FeedbackResponse, BugReportsResponse, FeedbackParams, BugReportParams, UserProfile, Project, Feedback, WidgetSettings } from './types.js';
+import type { ProjectsResponse, FeedbackResponse, BugReportsResponse, FeedbackParams, FeedbackCreateInput, FeedbackCreateResponse, BugReportParams, UserProfile, Project, Feedback, WidgetSettings } from './types.js';
 export declare class FeedbackBasketClient {
     private http;
     constructor(token: string, baseUrl: string);
@@ -34,6 +34,7 @@ export declare class FeedbackBasketClient {
         category?: string;
         limit?: number;
     }): Promise<FeedbackResponse>;
+    createFeedback(data: FeedbackCreateInput): Promise<FeedbackCreateResponse>;
     getWidgetSettings(projectId: string): Promise<{
         projectId: string;
         projectName: string;

package/dist/src/client.js

@@ -50,6 +50,9 @@ export class FeedbackBasketClient {
     async searchFeedback(query, opts = {}) {
         return this.getFeedback({ search: query, ...opts });
     }
+    async createFeedback(data) {
+        return this.request('POST', '/feedback', data);
+    }
     // Widget
     async getWidgetSettings(projectId) {
         return this.request('GET', `/projects/${encodeURIComponent(projectId)}/widget`);

package/dist/src/commands/feedback-create.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+import type { OutputWriter } from '../output/writer.js';
+export declare function createFeedbackCreateCommand(getWriter: () => OutputWriter): Command;

package/dist/src/commands/feedback-create.js

@@ -0,0 +1,120 @@
+import { Command } from 'commander';
+import { FeedbackBasketClient } from '../client.js';
+import { AuthManager } from '../auth/manager.js';
+import { loadConfig } from '../config/config.js';
+import { errAuth, errUsage } from '../output/errors.js';
+import { brand } from '../output/theme.js';
+import { resolveProject } from '../resolve.js';
+const validTypes = new Set(['bug', 'feature', 'general']);
+const validCategories = new Set(['BUG', 'FEATURE_REQUEST', 'IMPROVEMENT', 'QUESTION']);
+const validStatuses = new Set(['OPEN', 'UNDER_REVIEW', 'PLANNED', 'IN_PROGRESS', 'COMPLETE', 'CLOSED']);
+export function createFeedbackCreateCommand(getWriter) {
+    return new Command('create')
+        .argument('<title>', 'Short title or summary for the feedback')
+        .description('Create a new feedback item')
+        .requiredOption('--project <id-or-name>', 'Project ID or name')
+        .option('--content <body>', 'Longer feedback body')
+        .option('--type <type>', 'Feedback type (bug, feature, general)')
+        .option('--category <category>', 'Category (BUG, FEATURE_REQUEST, IMPROVEMENT, QUESTION)')
+        .option('--status <status>', 'Initial status (OPEN, UNDER_REVIEW, PLANNED, IN_PROGRESS, COMPLETE, CLOSED)')
+        .option('--email <email>', 'Submitter email')
+        .option('--page-url <url>', 'Page URL where the feedback applies')
+        .option('--metadata <key=value>', 'Metadata key/value pair (repeatable)', collectMetadata, [])
+        .action(async (title, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        if (opts.type && !validTypes.has(opts.type)) {
+            throw errUsage('Invalid type. Must be one of: bug, feature, general', 'Example: feedbackbasket feedback create "Login is broken" --project myapp --type bug');
+        }
+        if (opts.category && !validCategories.has(opts.category)) {
+            throw errUsage('Invalid category. Must be one of: BUG, FEATURE_REQUEST, IMPROVEMENT, QUESTION');
+        }
+        if (opts.status && !validStatuses.has(opts.status)) {
+            throw errUsage('Invalid status. Must be one of: OPEN, UNDER_REVIEW, PLANNED, IN_PROGRESS, COMPLETE, CLOSED');
+        }
+        const project = await resolveProject(client, opts.project);
+        const content = composeContent(title, opts.content);
+        const metadata = parseMetadata(opts.metadata ?? []);
+        const result = await client.createFeedback({
+            projectId: project.id,
+            content,
+            type: opts.type,
+            category: opts.category,
+            status: opts.status,
+            email: opts.email,
+            pageUrl: opts.pageUrl,
+            metadata,
+        });
+        if (!writer.isMachineOutput()) {
+            console.log(`  ${brand.success('[OK]')} Feedback created: ${brand.bold(result.id)}`);
+            console.log(`    ${brand.muted('Project:')} ${project.name}`);
+            console.log(`    ${brand.muted('URL:')} ${result.url}`);
+            console.log();
+        }
+        writer.ok(result, {
+            summary: `Created feedback ${result.id}`,
+            breadcrumbs: [
+                { action: 'View feedback', cmd: `feedbackbasket feedback show ${result.id}` },
+                { action: 'Update status', cmd: `feedbackbasket feedback update ${result.id} --status UNDER_REVIEW` },
+                { action: 'List project feedback', cmd: `feedbackbasket feedback list --project ${project.id}` },
+            ],
+        });
+    });
+}
+function requireClient() {
+    const manager = new AuthManager();
+    const token = manager.resolveToken();
+    if (!token)
+        throw errAuth();
+    const config = loadConfig();
+    return new FeedbackBasketClient(token, config.baseUrl);
+}
+function composeContent(title, body) {
+    const cleanTitle = title.trim();
+    const cleanBody = body?.trim();
+    const content = cleanBody ? `${cleanTitle}\n\n${cleanBody}` : cleanTitle;
+    if (!content) {
+        throw errUsage('Feedback title is required');
+    }
+    if (content.length > 2000) {
+        throw errUsage('Feedback content must be 2000 characters or less');
+    }
+    return content;
+}
+function collectMetadata(value, previous) {
+    return previous.concat(value);
+}
+function parseMetadata(entries) {
+    if (entries.length === 0)
+        return undefined;
+    const metadata = {};
+    for (const entry of entries) {
+        const separator = entry.indexOf('=');
+        if (separator <= 0) {
+            throw errUsage(`Invalid metadata "${entry}"`, 'Use --metadata key=value, for example --metadata source=codex');
+        }
+        const key = entry.slice(0, separator).trim();
+        const rawValue = entry.slice(separator + 1).trim();
+        if (!key) {
+            throw errUsage('Metadata keys cannot be empty');
+        }
+        metadata[key] = parseMetadataValue(rawValue);
+    }
+    return metadata;
+}
+function parseMetadataValue(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (value === 'null')
+        return null;
+    if (value !== '' && Number.isFinite(Number(value)))
+        return Number(value);
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}

package/dist/src/commands/feedback.js

@@ -17,6 +17,7 @@ async function resolveProjectId(client, optProject, all) {
 }
 import { createFeedbackUpdateCommand } from './feedback-update.js';
 import { createFeedbackNoteCommand } from './feedback-note.js';
+import { createFeedbackCreateCommand } from './feedback-create.js';
 import { createFeedbackDeleteCommand } from './feedback-delete.js';
 import { createFeedbackBulkUpdateCommand } from './feedback-bulk-update.js';
 import { createFeedbackExportCommand } from './feedback-export.js';
@@ -25,6 +26,7 @@ export function createFeedbackCommand(getWriter) {
     const feedback = new Command('feedback')
         .description('View and manage feedback');
     // Write subcommands
+    feedback.addCommand(createFeedbackCreateCommand(getWriter));
     feedback.addCommand(createFeedbackUpdateCommand(getWriter));
     feedback.addCommand(createFeedbackNoteCommand(getWriter));
     feedback.addCommand(createFeedbackReplyCommand(getWriter));
@@ -213,6 +215,11 @@ function renderFeedbackDetail(item) {
             console.log(`    ${attachment.url}`);
         }
     }
+    if (item.metadata && Object.keys(item.metadata).length > 0) {
+        console.log();
+        console.log(brand.bold('Metadata:'));
+        console.log(indentBlock(JSON.stringify(item.metadata, null, 2), '  '));
+    }
     if (item.aiSummary) {
         console.log();
         console.log(brand.bold('AI Summary:'));
@@ -240,6 +247,12 @@ function formatFeedbackType(item) {
         return undefined;
     return item.feedbackType.emoji ? `${item.feedbackType.emoji} ${label}` : label;
 }
+function indentBlock(value, indent) {
+    return value
+        .split('\n')
+        .map((line) => `${indent}${line}`)
+        .join('\n');
+}
 function formatBytes(bytes) {
     if (!Number.isFinite(bytes) || bytes < 0)
         return '';

package/dist/src/commands/widget.js

@@ -65,6 +65,10 @@ export function createWidgetCommand(getWriter) {
         .option('--no-email-required', 'Make email optional')
         .option('--show-email', 'Show the email field')
         .option('--no-show-email', 'Hide the email field')
+        .option('--email-read-only', 'Lock the email field when userEmail is prefilled')
+        .option('--no-email-read-only', 'Allow editing prefilled email')
+        .option('--hide-email-when-prefilled', 'Hide the email field when userEmail is prefilled')
+        .option('--no-hide-email-when-prefilled', 'Show the email field even when userEmail is prefilled')
         .option('--allow-attachments', 'Allow image attachments')
         .option('--no-allow-attachments', 'Disable image attachments')
         .option('--icon-only', 'Show only the icon, no label')
@@ -84,6 +88,7 @@ export function createWidgetCommand(getWriter) {
             opts.success || opts.trigger || opts.display ||
             opts.buttonRadius || opts.buttonSize || opts.icon ||
             opts.emailRequired !== undefined || opts.showEmail !== undefined ||
+            opts.emailReadOnly !== undefined || opts.hideEmailWhenPrefilled !== undefined ||
             opts.allowAttachments !== undefined || opts.iconOnly !== undefined ||
             opts.showIcon !== undefined || opts.showBranding !== undefined ||
             opts.zIndex || opts.guided || opts.disableGuided;
@@ -117,6 +122,10 @@ export function createWidgetCommand(getWriter) {
                 settings.emailRequired = opts.emailRequired;
             if (opts.showEmail !== undefined)
                 settings.showEmailField = opts.showEmail;
+            if (opts.emailReadOnly !== undefined)
+                settings.emailReadOnly = opts.emailReadOnly;
+            if (opts.hideEmailWhenPrefilled !== undefined)
+                settings.hideEmailFieldWhenPrefilled = opts.hideEmailWhenPrefilled;
             if (opts.allowAttachments !== undefined)
                 settings.allowAttachments = opts.allowAttachments;
             if (opts.iconOnly !== undefined)
@@ -349,6 +358,8 @@ function renderWidgetSettings(projectName, settings) {
         ['Display Mode', String(settings.displayMode ?? '')],
         ['Show Email', String(settings.showEmailField ?? true)],
         ['Email Required', String(settings.emailRequired ?? false)],
+        ['Email Read Only', String(settings.emailReadOnly ?? false)],
+        ['Hide Prefilled Email', String(settings.hideEmailFieldWhenPrefilled ?? false)],
         ['Attachments', String(settings.allowAttachments ?? true)],
         ['Guided Flow', String(settings.feedbackFlow?.enabled ?? false)],
         ['Intro Message', String(settings.introMessage ?? '')],

package/dist/src/help.js

@@ -57,6 +57,7 @@ export function renderRootHelp() {
     // Examples
     lines.push(section('  EXAMPLES'));
     lines.push(`${INDENT}${brand.muted('$')} feedbackbasket projects list`);
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket feedback create "Login bug" --project myapp --type bug`);
     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`);

package/dist/src/types.d.ts

@@ -37,6 +37,8 @@ export interface WidgetSettings {
     position?: string;
     showEmailField?: boolean;
     emailRequired?: boolean;
+    emailReadOnly?: boolean;
+    hideEmailFieldWhenPrefilled?: boolean;
     allowAttachments?: boolean;
     displayMode?: 'modal' | 'popup';
     zIndex?: number;
@@ -76,6 +78,7 @@ export interface Feedback {
         type: FeedbackFlowQuestionType;
         value: string;
     }> | null;
+    metadata?: Record<string, unknown> | null;
     pageUrl?: string | null;
     browser?: string | null;
     os?: string | null;
@@ -123,6 +126,21 @@ export interface FeedbackResponse {
     feedback: Feedback[];
     pagination: Pagination;
 }
+export interface FeedbackCreateInput {
+    projectId: string;
+    content: string;
+    type?: 'bug' | 'feature' | 'general';
+    category?: FeedbackCategory;
+    status?: FeedbackStatus;
+    email?: string;
+    pageUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface FeedbackCreateResponse {
+    id: string;
+    url: string;
+    feedback: Feedback;
+}
 export interface BugReportsResponse {
     bugReports: BugReport[];
     stats: {

package/dist/src/version.d.ts

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

package/dist/src/version.js

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

package/package.json

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

package/skills/feedbackbasket/SKILL.md

@@ -62,6 +62,8 @@ feedbackbasket feedback show <id>
 feedbackbasket feedback search "crash on mobile" --project <id> --limit 10
 
 # Write
+feedbackbasket feedback create "Login button is broken" --content "Clicking Log in does nothing in Safari." --project <id> --type bug
+feedbackbasket feedback create "Feature idea" --content "Let users export saved views." --project <id> --type feature --metadata source=agent
 feedbackbasket feedback update <id> --status PLANNED --category BUG --sentiment NEGATIVE
 feedbackbasket feedback note <id> "Investigating — appears related to auth flow"
 feedbackbasket feedback delete <id> --yes
@@ -97,6 +99,7 @@ feedbackbasket widget settings <project> --color "#22c55e" --label "Send Feedbac
 feedbackbasket widget settings <project> --position bottom-left --display modal
 feedbackbasket widget settings <project> --email-required --intro "How can we improve?"
 feedbackbasket widget settings <project> --show-email --allow-attachments --guided
+feedbackbasket widget settings <project> --email-read-only --hide-email-when-prefilled
 
 # Guided feedback types and follow-up questions
 feedbackbasket widget flow <project>
@@ -105,6 +108,8 @@ feedbackbasket widget flow <project> --reset-default --enable
 feedbackbasket widget flow <project> --config ./feedback-flow.json
 ```
 
+`email-read-only` and `hide-email-when-prefilled` control behavior only when the host app passes a runtime `userEmail` value. Do not store visitor emails in widget settings.
+
 `widget flow --config` accepts either a `feedbackFlow` object or a JSON object with a `feedbackFlow` key. Use it when an agent needs to customize visitor choices such as Bug report, Feature request, and General feedback. Supported v1 question types are `text`, `textarea`, and `single_choice`.
 
 ### Team
@@ -140,11 +145,23 @@ feedbackbasket feedback update <id> --status UNDER_REVIEW --agent
 feedbackbasket feedback note <id> "Reviewing — appears related to auth flow" --agent
 ```
 
+### Capture new feedback without leaving the terminal
+```bash
+feedbackbasket feedback create "Login button is broken" \
+  --content "Clicking Log in does nothing in Safari." \
+  --project myapp \
+  --type bug \
+  --page-url https://example.com/login \
+  --metadata source=agent \
+  --agent
+```
+Agent mode returns the created feedback ID, dashboard URL, and feedback object. Created feedback is analyzed by AI and follows the project's notification settings.
+
 ### Investigate high-priority bugs
 ```bash
 feedbackbasket bugs list --severity high --agent
 feedbackbasket feedback show <id> --agent
-# Response includes browser, OS, page URL, submitted feedback type, follow-up answers, attachment URLs, AI analysis, priority score
+# Response includes browser, OS, page URL, submitted feedback type, follow-up answers, attachment URLs, metadata, AI analysis, priority score
 ```
 
 ### Close the loop — reply to the submitter