feedbackbasket-cli 3.1.0 → 3.2.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## [3.2.0] - 2026-09-04
+
+### Added
+
+- Added structured close reasons and optional internal close notes to feedback create, update, bulk update, list, and show commands.
+
+### Changed
+
+- Closing feedback now requires `--close-reason`. The `OTHER` reason also requires `--close-note`.
+- The CLI and both MCP transports now use agent surface version `3.2.0`.
+
 ## [3.1.0] - 2026-08-22
 
 ### Added

package/README.md

@@ -30,7 +30,7 @@ The browser selects the organization, Read or Full access, and Selected projects
 
 The first time you log in, a setup wizard walks you through selecting a default project and installing the Claude Code skill.
 
-The CLI uses agent surface version `3.1.0`. CLI login accepts only private CLI credentials. It does not accept MCP keys or OAuth tokens. Use `--yes` for high-impact commands in agent or machine mode. Interactive use can show a confirmation prompt. Never put an access token, refresh token, CLI token, or MCP key in source, prompts, logs, generated configuration, or final output.
+The CLI uses agent surface version `3.2.0`. CLI login accepts only private CLI credentials. It does not accept MCP keys or OAuth tokens. Use `--yes` for high-impact commands in agent or machine mode. Interactive use can show a confirmation prompt. Never put an access token, refresh token, CLI token, or MCP key in source, prompts, logs, generated configuration, or final output.
 
 ## Agent Usage
 
@@ -57,7 +57,7 @@ feedbackbasket setup claude
 <!-- BEGIN GENERATED AGENT CAPABILITIES -->
 ## Agent capability contract
 
-Agent surface version: `3.1.0`. The CLI and both MCP transports implement the same 31 product operations.
+Agent surface version: `3.2.0`. The CLI and both MCP transports implement the same 31 product operations.
 
 | Product operation | CLI command | MCP tool | Required access | Confirm |
 | --- | --- | --- | --- | --- |
@@ -135,6 +135,7 @@ feedbackbasket feedback list --category BUG               # Filter by category
 feedbackbasket feedback list --status OPEN                # Filter by status
 feedbackbasket feedback list --sentiment NEGATIVE          # Filter by sentiment
 feedbackbasket feedback list --search "login issue"        # Text search
+feedbackbasket feedback list --status CLOSED --close-reason NOT_PLANNED
 feedbackbasket feedback show <id>                          # View detail, including attachment links
 feedbackbasket feedback search "crash on mobile"           # Search shortcut
 
@@ -142,6 +143,7 @@ feedbackbasket feedback search "crash on mobile"           # Search shortcut
 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> --status CLOSED --close-reason NOT_PLANNED
 feedbackbasket feedback update <id> --category BUG         # Update category
 feedbackbasket feedback reply <id> "Thanks!" --delivery email --reply-to support@example.com
 feedbackbasket feedback reply <id> "Thanks!" --delivery widget
@@ -150,7 +152,7 @@ feedbackbasket feedback reply <id> "Thanks!" --delivery both --reply-to support@
 feedbackbasket feedback replies <id>                       # Show the complete conversation
 feedbackbasket feedback note <id> "Investigating this..."  # Add internal note
 feedbackbasket feedback delete <id>                        # Delete feedback
-feedbackbasket feedback bulk-update --status CLOSED --ids id1,id2,id3
+feedbackbasket feedback bulk-update --status CLOSED --close-reason NOT_ACTIONABLE --ids id1,id2,id3
 
 # Export
 feedbackbasket feedback export myapp --format csv          # Export to CSV

package/dist/src/client.d.ts

@@ -71,6 +71,8 @@ export declare class FeedbackBasketClient {
         status?: string;
         category?: string;
         sentiment?: string;
+        closeReason?: string;
+        closeNote?: string;
     }): Promise<Feedback>;
     createNote(feedbackId: string, content: string): Promise<{
         id: string;
@@ -96,9 +98,13 @@ export declare class FeedbackBasketClient {
         deleted: boolean;
         id: string;
     }>;
-    bulkUpdateStatus(ids: string[], status: string): Promise<{
+    bulkUpdateStatus(ids: string[], status: string, closure?: {
+        closeReason?: string;
+        closeNote?: string;
+    }): Promise<{
         updated: number;
         status: string;
+        closeReason?: string | null;
     }>;
     updateNote(feedbackId: string, noteId: string, content: string): Promise<{
         id: string;

package/dist/src/client.js

@@ -99,8 +99,12 @@ export class FeedbackBasketClient {
     async deleteFeedback(id) {
         return this.request('DELETE', `/feedback/${encodeURIComponent(id)}`);
     }
-    async bulkUpdateStatus(ids, status) {
-        return this.request('POST', '/feedback/bulk-update', { ids, status });
+    async bulkUpdateStatus(ids, status, closure = {}) {
+        return this.request('POST', '/feedback/bulk-update', {
+            ids,
+            status,
+            ...closure,
+        });
     }
     async updateNote(feedbackId, noteId, content) {
         return this.request('PATCH', `/feedback/${encodeURIComponent(feedbackId)}/notes/${encodeURIComponent(noteId)}`, { content });
@@ -117,7 +121,9 @@ export class FeedbackBasketClient {
         return this.request('GET', '/team');
     }
     async updateMemberRole(memberId, role) {
-        return this.request('PATCH', `/team/${encodeURIComponent(memberId)}`, { role });
+        return this.request('PATCH', `/team/${encodeURIComponent(memberId)}`, {
+            role,
+        });
     }
     async removeMember(memberId) {
         return this.request('DELETE', `/team/${encodeURIComponent(memberId)}`);
@@ -130,24 +136,27 @@ export class FeedbackBasketClient {
                 method,
                 signal: controller.signal,
                 headers: {
-                    'Authorization': `Bearer ${this.token}`,
+                    Authorization: `Bearer ${this.token}`,
                     'Content-Type': 'application/json',
                     'User-Agent': USER_AGENT,
                 },
                 body: data === undefined ? undefined : JSON.stringify(data),
             });
             const contentType = response.headers.get('content-type') ?? '';
-            const payload = contentType.includes('application/json')
-                ? await response.json().catch(() => null)
-                : await response.text();
+            const payload = contentType.includes('application/json') ? await response.json().catch(() => null) : await response.text();
             if (!response.ok) {
                 const message = getErrorMessage(payload, response.statusText);
                 switch (response.status) {
-                    case 401: throw errAuth(message);
-                    case 403: throw errForbidden(message);
-                    case 404: throw errAPI(404, message);
-                    case 429: throw errRateLimit();
-                    default: throw errAPI(response.status, message);
+                    case 401:
+                        throw errAuth(message);
+                    case 403:
+                        throw errForbidden(message);
+                    case 404:
+                        throw errAPI(404, message);
+                    case 429:
+                        throw errRateLimit();
+                    default:
+                        throw errAPI(response.status, message);
                 }
             }
             return payload;

package/dist/src/commands/feedback-bulk-update.js

@@ -5,30 +5,46 @@ import { loadConfig } from '../config/config.js';
 import { errAuth, errUsage } from '../output/errors.js';
 import { brand } from '../output/theme.js';
 import { requireHighImpactConfirmation } from '../confirmation.js';
+const validCloseReasons = new Set(['DUPLICATE', 'NOT_PLANNED', 'COULD_NOT_REPRODUCE', 'NOT_ACTIONABLE', 'NO_LONGER_RELEVANT', 'SPAM', 'OTHER']);
 export function createFeedbackBulkUpdateCommand(getWriter) {
     return new Command('bulk-update')
         .description('Update status for multiple feedback items at once')
         .requiredOption('--status <status>', 'New status (OPEN, UNDER_REVIEW, PLANNED, IN_PROGRESS, COMPLETE, CLOSED)')
+        .option('--close-reason <reason>', 'Reason for closing (DUPLICATE, NOT_PLANNED, COULD_NOT_REPRODUCE, NOT_ACTIONABLE, NO_LONGER_RELEVANT, SPAM, OTHER)')
+        .option('--close-note <note>', 'Internal closure note; required when the reason is OTHER')
         .requiredOption('--ids <ids>', 'Comma-separated feedback IDs')
         .option('--yes', 'Confirm the bulk update')
         .action(async (opts) => {
         const writer = getWriter();
         const client = requireClient();
-        const ids = opts.ids.split(',').map((id) => id.trim()).filter(Boolean);
+        const ids = opts.ids
+            .split(',')
+            .map((id) => id.trim())
+            .filter(Boolean);
         if (ids.length === 0) {
             throw errUsage('At least one ID is required', 'Example: --ids id1,id2,id3');
         }
+        if (opts.status === 'CLOSED' && !opts.closeReason) {
+            throw errUsage('--close-reason is required when status is CLOSED');
+        }
+        if (opts.closeReason && !validCloseReasons.has(opts.closeReason)) {
+            throw errUsage('Invalid close reason. Must be one of: DUPLICATE, NOT_PLANNED, COULD_NOT_REPRODUCE, NOT_ACTIONABLE, NO_LONGER_RELEVANT, SPAM, OTHER');
+        }
+        if (opts.closeReason === 'OTHER' && !opts.closeNote?.trim()) {
+            throw errUsage('--close-note is required when --close-reason is OTHER');
+        }
         await requireHighImpactConfirmation(writer, Boolean(opts.yes), `Update ${ids.length} feedback item${ids.length === 1 ? '' : 's'}?`, '--yes is required for a bulk update in machine mode.');
-        const result = await client.bulkUpdateStatus(ids, opts.status);
+        const result = await client.bulkUpdateStatus(ids, opts.status, {
+            closeReason: opts.closeReason,
+            closeNote: opts.closeNote,
+        });
         if (!writer.isMachineOutput()) {
             console.log(`  ${brand.success('✓')} Updated ${result.updated} feedback items to ${brand.bold(result.status)}`);
             console.log();
         }
         writer.ok(result, {
             summary: `Updated ${result.updated} items to ${result.status}`,
-            breadcrumbs: [
-                { action: 'List feedback', cmd: 'feedbackbasket feedback list' },
-            ],
+            breadcrumbs: [{ action: 'List feedback', cmd: 'feedbackbasket feedback list' }],
         });
     });
 }

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

@@ -8,6 +8,7 @@ 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']);
+const validCloseReasons = new Set(['DUPLICATE', 'NOT_PLANNED', 'COULD_NOT_REPRODUCE', 'NOT_ACTIONABLE', 'NO_LONGER_RELEVANT', 'SPAM', 'OTHER']);
 export function createFeedbackCreateCommand(getWriter) {
     return new Command('create')
         .argument('<title>', 'Short title or summary for the feedback')
@@ -17,6 +18,8 @@ export function createFeedbackCreateCommand(getWriter) {
         .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('--close-reason <reason>', 'Reason when the initial status is CLOSED')
+        .option('--close-note <note>', 'Internal closure note; required when the reason is OTHER')
         .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, [])
@@ -32,6 +35,15 @@ export function createFeedbackCreateCommand(getWriter) {
         if (opts.status && !validStatuses.has(opts.status)) {
             throw errUsage('Invalid status. Must be one of: OPEN, UNDER_REVIEW, PLANNED, IN_PROGRESS, COMPLETE, CLOSED');
         }
+        if (opts.status === 'CLOSED' && !opts.closeReason) {
+            throw errUsage('--close-reason is required when status is CLOSED');
+        }
+        if (opts.closeReason && !validCloseReasons.has(opts.closeReason)) {
+            throw errUsage('Invalid close reason. Must be one of: DUPLICATE, NOT_PLANNED, COULD_NOT_REPRODUCE, NOT_ACTIONABLE, NO_LONGER_RELEVANT, SPAM, OTHER');
+        }
+        if (opts.closeReason === 'OTHER' && !opts.closeNote?.trim()) {
+            throw errUsage('--close-note is required when --close-reason is OTHER');
+        }
         const project = await resolveProject(client, opts.project);
         const content = composeContent(title, opts.content);
         const metadata = parseMetadata(opts.metadata ?? []);
@@ -41,6 +53,8 @@ export function createFeedbackCreateCommand(getWriter) {
             type: opts.type,
             category: opts.category,
             status: opts.status,
+            closeReason: opts.closeReason,
+            closeNote: opts.closeNote,
             email: opts.email,
             pageUrl: opts.pageUrl,
             metadata,
@@ -54,9 +68,18 @@ export function createFeedbackCreateCommand(getWriter) {
         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}` },
+                {
+                    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}`,
+                },
             ],
         });
     });

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

@@ -4,11 +4,14 @@ 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';
+const validCloseReasons = new Set(['DUPLICATE', 'NOT_PLANNED', 'COULD_NOT_REPRODUCE', 'NOT_ACTIONABLE', 'NO_LONGER_RELEVANT', 'SPAM', 'OTHER']);
 export function createFeedbackUpdateCommand(getWriter) {
     return new Command('update')
         .argument('<id>', 'Feedback ID to update')
         .description('Update a feedback item')
         .option('--status <status>', 'Set status (OPEN, UNDER_REVIEW, PLANNED, IN_PROGRESS, COMPLETE, CLOSED)')
+        .option('--close-reason <reason>', 'Reason for closing (DUPLICATE, NOT_PLANNED, COULD_NOT_REPRODUCE, NOT_ACTIONABLE, NO_LONGER_RELEVANT, SPAM, OTHER)')
+        .option('--close-note <note>', 'Internal closure note; required when the reason is OTHER')
         .option('--category <category>', 'Set category (BUG, FEATURE_REQUEST, IMPROVEMENT, QUESTION)')
         .option('--sentiment <sentiment>', 'Set sentiment (POSITIVE, NEGATIVE, NEUTRAL)')
         .action(async (id, opts) => {
@@ -16,6 +19,15 @@ export function createFeedbackUpdateCommand(getWriter) {
         if (!opts.status && !opts.category && !opts.sentiment) {
             throw errUsage('At least one of --status, --category, or --sentiment is required', 'Example: feedbackbasket feedback update <id> --status PLANNED');
         }
+        if (opts.status === 'CLOSED' && !opts.closeReason) {
+            throw errUsage('--close-reason is required when status is CLOSED');
+        }
+        if (opts.closeReason && !validCloseReasons.has(opts.closeReason)) {
+            throw errUsage('Invalid close reason. Must be one of: DUPLICATE, NOT_PLANNED, COULD_NOT_REPRODUCE, NOT_ACTIONABLE, NO_LONGER_RELEVANT, SPAM, OTHER');
+        }
+        if (opts.closeReason === 'OTHER' && !opts.closeNote?.trim()) {
+            throw errUsage('--close-note is required when --close-reason is OTHER');
+        }
         const client = requireClient();
         const data = {};
         if (opts.status)
@@ -24,6 +36,10 @@ export function createFeedbackUpdateCommand(getWriter) {
             data['category'] = opts.category;
         if (opts.sentiment)
             data['sentiment'] = opts.sentiment;
+        if (opts.closeReason)
+            data['closeReason'] = opts.closeReason;
+        if (opts.closeNote)
+            data['closeNote'] = opts.closeNote;
         const updated = await client.updateFeedback(id, data);
         if (!writer.isMachineOutput()) {
             console.log(brand.success(`Updated feedback ${id}`));
@@ -33,12 +49,20 @@ export function createFeedbackUpdateCommand(getWriter) {
                 console.log(`  Category:  ${opts.category}`);
             if (opts.sentiment)
                 console.log(`  Sentiment: ${opts.sentiment}`);
+            if (opts.closeReason)
+                console.log(`  Reason:    ${opts.closeReason}`);
         }
         writer.ok(updated, {
             summary: `Updated feedback ${id}`,
             breadcrumbs: [
-                { action: 'View updated item', cmd: `feedbackbasket feedback show ${id}` },
-                { action: 'Add a note', cmd: `feedbackbasket feedback note ${id} "<note>"` },
+                {
+                    action: 'View updated item',
+                    cmd: `feedbackbasket feedback show ${id}`,
+                },
+                {
+                    action: 'Add a note',
+                    cmd: `feedbackbasket feedback note ${id} "<note>"`,
+                },
                 { action: 'Back to list', cmd: 'feedbackbasket feedback list' },
             ],
         });

package/dist/src/commands/feedback.js

@@ -23,8 +23,7 @@ import { createFeedbackBulkUpdateCommand } from './feedback-bulk-update.js';
 import { createFeedbackExportCommand } from './feedback-export.js';
 import { createFeedbackReplyCommand, createFeedbackRepliesCommand } from './feedback-reply.js';
 export function createFeedbackCommand(getWriter) {
-    const feedback = new Command('feedback')
-        .description('View and manage feedback');
+    const feedback = new Command('feedback').description('View and manage feedback');
     // Write subcommands
     feedback.addCommand(createFeedbackCreateCommand(getWriter));
     feedback.addCommand(createFeedbackUpdateCommand(getWriter));
@@ -42,6 +41,7 @@ export function createFeedbackCommand(getWriter) {
         .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('--close-reason <reason>', 'Filter by close reason')
         .option('--sentiment <sentiment>', 'Filter by sentiment (POSITIVE, NEGATIVE, NEUTRAL)')
         .option('--search <query>', 'Search feedback content')
         .option('--limit <n>', 'Max results (1-100)', '20')
@@ -54,6 +54,7 @@ export function createFeedbackCommand(getWriter) {
             projectId: await resolveProjectId(client, opts.project, opts.all),
             category: opts.category,
             status: opts.status,
+            closeReason: opts.closeReason,
             sentiment: opts.sentiment,
             search: opts.search,
             limit: parseInt(opts.limit, 10),
@@ -65,13 +66,22 @@ export function createFeedbackCommand(getWriter) {
         }
         const breadcrumbs = [];
         if (opts.project) {
-            breadcrumbs.push({ action: 'View bugs for this project', cmd: `feedbackbasket bugs list --project ${opts.project}` });
+            breadcrumbs.push({
+                action: 'View bugs for this project',
+                cmd: `feedbackbasket bugs list --project ${opts.project}`,
+            });
         }
         if (result.pagination.hasMore) {
             const nextOffset = parseInt(opts.offset, 10) + parseInt(opts.limit, 10);
-            breadcrumbs.push({ action: 'Next page', cmd: `feedbackbasket feedback list --offset ${nextOffset} --limit ${opts.limit}${opts.project ? ` --project ${opts.project}` : ''}` });
+            breadcrumbs.push({
+                action: 'Next page',
+                cmd: `feedbackbasket feedback list --offset ${nextOffset} --limit ${opts.limit}${opts.project ? ` --project ${opts.project}` : ''}`,
+            });
         }
-        breadcrumbs.push({ action: 'Search', cmd: 'feedbackbasket feedback search "<query>"' });
+        breadcrumbs.push({
+            action: 'Search',
+            cmd: 'feedbackbasket feedback search "<query>"',
+        });
         writer.ok(result.feedback, {
             summary: `Showing ${result.feedback.length} of ${result.pagination.totalCount} feedback items`,
             notice: result.pagination.hasMore ? `Use --offset ${parseInt(opts.offset, 10) + parseInt(opts.limit, 10)} to see more` : undefined,
@@ -92,8 +102,14 @@ export function createFeedbackCommand(getWriter) {
         writer.ok(item, {
             summary: `Feedback ${item.id}`,
             breadcrumbs: [
-                { action: 'Update status', cmd: `feedbackbasket feedback update ${item.id} --status <STATUS>` },
-                { action: 'Add note', cmd: `feedbackbasket feedback note ${item.id} "<note>"` },
+                {
+                    action: 'Update status',
+                    cmd: `feedbackbasket feedback update ${item.id} --status <STATUS>`,
+                },
+                {
+                    action: 'Add note',
+                    cmd: `feedbackbasket feedback note ${item.id} "<note>"`,
+                },
                 { action: 'Back to list', cmd: 'feedbackbasket feedback list' },
             ],
         });
@@ -120,7 +136,10 @@ export function createFeedbackCommand(getWriter) {
             summary: `${result.pagination.totalCount} result${result.pagination.totalCount === 1 ? '' : 's'} for "${query}"`,
             breadcrumbs: [
                 { action: 'List all feedback', cmd: 'feedbackbasket feedback list' },
-                { action: 'Search bugs', cmd: `feedbackbasket bugs list --search "${query}"` },
+                {
+                    action: 'Search bugs',
+                    cmd: `feedbackbasket bugs list --search "${query}"`,
+                },
             ],
         });
     });
@@ -156,7 +175,7 @@ function renderFeedbackList(items) {
         const cat = categoryEmoji[item.category ?? ''] ?? brand.muted('[?]');
         const priority = priorityLabel(item.aiPriorityScore);
         const content = item.content.length > 80 ? item.content.slice(0, 77) + '...' : item.content;
-        const status = brand.muted(`[${item.status}]`);
+        const status = brand.muted(`[${item.status}${item.closeReason ? ` · ${item.closeReason}` : ''}]`);
         const proj = item.project ? brand.primary(item.project.name) : '';
         console.log(`${cat} ${priority} ${status} ${proj} ${brand.muted(item.id)}`);
         console.log(`  ${content}`);
@@ -175,6 +194,8 @@ function renderFeedbackDetail(item) {
     console.log();
     const fields = [
         ['Status', item.status],
+        ['Close Reason', item.closeReason],
+        ['Close Note', item.closeNote],
         ['Category', item.category],
         ['Feedback Type', formatFeedbackType(item)],
         ['Sentiment', item.sentiment],

package/dist/src/types.d.ts

@@ -1,4 +1,5 @@
 export type FeedbackStatus = 'OPEN' | 'UNDER_REVIEW' | 'PLANNED' | 'IN_PROGRESS' | 'COMPLETE' | 'CLOSED';
+export type FeedbackCloseReason = 'DUPLICATE' | 'NOT_PLANNED' | 'COULD_NOT_REPRODUCE' | 'NOT_ACTIONABLE' | 'NO_LONGER_RELEVANT' | 'SPAM' | 'OTHER';
 export type FeedbackCategory = 'BUG' | 'FEATURE_REQUEST' | 'IMPROVEMENT' | 'QUESTION';
 export type Sentiment = 'POSITIVE' | 'NEGATIVE' | 'NEUTRAL';
 export type Severity = 'high' | 'medium' | 'low';
@@ -93,6 +94,9 @@ export interface Feedback {
     content: string;
     email?: string | null;
     status: FeedbackStatus;
+    closeReason?: FeedbackCloseReason | null;
+    closeNote?: string | null;
+    closedAt?: string | null;
     category?: FeedbackCategory | null;
     sentiment?: Sentiment | null;
     aiSummary?: string | null;
@@ -186,6 +190,8 @@ export interface FeedbackCreateInput {
     type?: 'bug' | 'feature' | 'general';
     category?: FeedbackCategory;
     status?: FeedbackStatus;
+    closeReason?: FeedbackCloseReason;
+    closeNote?: string;
     email?: string;
     pageUrl?: string;
     metadata?: Record<string, unknown>;
@@ -232,6 +238,7 @@ export interface FeedbackParams {
     projectId?: string;
     category?: FeedbackCategory;
     status?: FeedbackStatus;
+    closeReason?: FeedbackCloseReason;
     sentiment?: Sentiment;
     search?: string;
     limit?: number;

package/dist/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION: "3.1.0";
+export declare const VERSION: "3.2.0";
 export declare const USER_AGENT: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feedbackbasket-cli",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Command-line interface for FeedbackBasket — manage feedback and waitlists from your terminal",
   "type": "module",
   "main": "dist/src/cli.js",
@@ -34,7 +34,7 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^13.1.0",
-    "feedbackbasket-agent-contract": "3.1.0",
+    "feedbackbasket-agent-contract": "3.2.0",
     "open": "^10.1.0"
   },
   "devDependencies": {

package/skills/feedbackbasket/SKILL.md

@@ -7,7 +7,7 @@ description: Manage FeedbackBasket projects, feedback, bugs, website widgets, mo
 
 Full command-line interface for managing feedback, waitlist signups, bug reports, projects, widgets, and teams in FeedbackBasket. Works with any AI agent that can run shell commands.
 
-The unified agent surface version is `3.1.0`. It has 31 product operations. The CLI, stdio MCP package, and live Streamable HTTP MCP server implement the same contract.
+The unified agent surface version is `3.2.0`. It has 31 product operations. The CLI, stdio MCP package, and live Streamable HTTP MCP server implement the same contract.
 
 ## Authentication
 
@@ -39,7 +39,7 @@ Use the CLI when the agent has shell access and an existing CLI login. Use MCP w
 
 For remote MCP, add `https://feedbackbasket.com/.well-known/mcp` to the host. Save it, select **Authenticate**, sign in, select an organization, select Read or Full access, select Selected projects or All projects, and select **Allow**. Browser OAuth is the recommended remote setup. Do not ask the user to paste an OAuth token.
 
-For local STDIO MCP, CI, servers, or unattended automation, use `feedbackbasket-mcp-server@3.1.0` with an `fb_key_` credential from the host credential store or an environment variable. Browser OAuth is only for Streamable HTTP. STDIO still uses an environment credential. The CLI keeps `feedbackbasket login` and its private `fb_cli_` token flow in this release.
+For local STDIO MCP, CI, servers, or unattended automation, use `feedbackbasket-mcp-server@3.2.0` with an `fb_key_` credential from the host credential store or an environment variable. Browser OAuth is only for Streamable HTTP. STDIO still uses an environment credential. The CLI keeps `feedbackbasket login` and its private `fb_cli_` token flow in this release.
 
 Access tokens, refresh tokens, CLI tokens, and MCP keys are private and are not interchangeable. Never put a credential in source, command arguments, logs, prompts, snapshots, generated files, or final responses. Use browser OAuth, the host credential store, or an environment variable as applicable.
 
@@ -135,6 +135,7 @@ Treat a supplied project key as production unless the user explicitly confirms a
 # Read
 feedbackbasket feedback list --project <id> --category BUG --status OPEN --sentiment NEGATIVE
 feedbackbasket feedback list --search "login" --limit 50 --offset 0 --notes
+feedbackbasket feedback list --status CLOSED --close-reason NOT_PLANNED
 feedbackbasket feedback show <id>
 feedbackbasket feedback search "crash on mobile" --project <id> --limit 10
 
@@ -146,7 +147,9 @@ feedbackbasket feedback note <id> "Investigating — appears related to auth flo
 feedbackbasket feedback note update <id> <note-id> --content "Updated internal note"
 feedbackbasket feedback note delete <id> <note-id> --yes
 feedbackbasket feedback delete <id> --yes
-feedbackbasket feedback bulk-update --status CLOSED --ids id1,id2,id3 --yes
+feedbackbasket feedback update <id> --status CLOSED --close-reason NOT_PLANNED
+feedbackbasket feedback update <id> --status CLOSED --close-reason OTHER --close-note "Reason for closing"
+feedbackbasket feedback bulk-update --status CLOSED --close-reason NOT_ACTIONABLE --ids id1,id2,id3 --yes
 
 # Reply to submitter by email, widget/in-app thread, or both
 feedbackbasket feedback reply <id> "Thanks for reporting — we pushed a fix!" --delivery email --reply-to support@example.com --yes
@@ -391,12 +394,13 @@ feedbackbasket feedback search "crash" --category BUG --agent
 
 ## Filtering Options
 
-| Type         | Values                                                                 |
-| ------------ | ---------------------------------------------------------------------- |
-| Categories   | `BUG`, `FEATURE_REQUEST`, `IMPROVEMENT`, `QUESTION`                    |
-| Statuses     | `OPEN`, `UNDER_REVIEW`, `PLANNED`, `IN_PROGRESS`, `COMPLETE`, `CLOSED` |
-| Sentiments   | `POSITIVE`, `NEGATIVE`, `NEUTRAL`                                      |
-| Bug Severity | `high`, `medium`, `low`                                                |
+| Type          | Values                                                                                                     |
+| ------------- | ---------------------------------------------------------------------------------------------------------- |
+| Categories    | `BUG`, `FEATURE_REQUEST`, `IMPROVEMENT`, `QUESTION`                                                        |
+| Statuses      | `OPEN`, `UNDER_REVIEW`, `PLANNED`, `IN_PROGRESS`, `COMPLETE`, `CLOSED`                                     |
+| Close reasons | `DUPLICATE`, `NOT_PLANNED`, `COULD_NOT_REPRODUCE`, `NOT_ACTIONABLE`, `NO_LONGER_RELEVANT`, `SPAM`, `OTHER` |
+| Sentiments    | `POSITIVE`, `NEGATIVE`, `NEUTRAL`                                                                          |
+| Bug Severity  | `high`, `medium`, `low`                                                                                    |
 
 ## JSON Envelope
 
@@ -432,5 +436,6 @@ Errors include hints:
 - Project names resolve case-insensitively with fuzzy matching
 - Write operations use full scope (granted by default during login)
 - Feedback IDs are stable CUIDs — safe to reference across commands
+- Closing feedback requires `--close-reason`. The `OTHER` reason also requires `--close-note`.
 - All timestamps are ISO 8601
 - `--yes` confirms all high-impact CLI operations in agent or machine mode.