@proletariat/cli 0.3.24 → 0.3.25

package/dist/commands/epic/spec.js

@@ -1,8 +1,7 @@
 import { Args, Flags } from '@oclif/core';
-import inquirer from 'inquirer';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
-import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class EpicSpec extends PMOCommand {
     static description = 'Assign a spec to an epic (design document)';
     static examples = [
@@ -34,6 +33,10 @@ export default class EpicSpec extends PMOCommand {
             description: 'Remove spec from epic instead of adding',
             default: false,
         }),
+        'align-tickets': Flags.boolean({
+            description: 'Also update all tickets in the epic to use the same spec',
+            default: false,
+        }),
     };
     async execute() {
         const { args, flags } = await this.parse(EpicSpec);
@@ -66,19 +69,16 @@ export default class EpicSpec extends PMOCommand {
                 return {
                     name: `${e.id} ${e.title} (${e.status})${specLabel}`,
                     value: e.id,
+                    command: `prlt epic spec ${e.id} --json`,
                 };
             });
-            // In JSON mode, output epic selection prompt
-            if (jsonMode) {
-                outputPromptAsJson(buildPromptConfig('list', 'epicId', 'Select epic:', epicChoices), createMetadata('epic spec', flags));
-                return;
-            }
-            const { selected } = await inquirer.prompt([{
+            const jsonModeConfig = jsonMode ? { flags, commandName: 'epic spec' } : null;
+            const { selected } = await this.prompt([{
                     type: 'list',
                     name: 'selected',
                     message: 'Select epic:',
                     choices: epicChoices,
-                }]);
+                }], jsonModeConfig);
             epicId = selected;
         }
         // Validate epic exists
@@ -114,18 +114,15 @@ export default class EpicSpec extends PMOCommand {
             const specChoices = specs.map(s => ({
                 name: `${s.id} - ${s.title} (${s.status})`,
                 value: s.id,
+                command: `prlt epic spec ${epicId} ${s.id} --json`,
             }));
-            // In JSON mode, output spec selection prompt
-            if (jsonMode) {
-                outputPromptAsJson(buildPromptConfig('list', 'specId', `Select spec to link to ${epicId}:`, specChoices), createMetadata('epic spec', flags));
-                return;
-            }
-            const { selected } = await inquirer.prompt([{
+            const jsonModeConfig = jsonMode ? { flags, commandName: 'epic spec' } : null;
+            const { selected } = await this.prompt([{
                     type: 'list',
                     name: 'selected',
                     message: `Select spec to link to ${epicId}:`,
                     choices: specChoices,
-                }]);
+                }], jsonModeConfig);
             specId = selected;
         }
         // Validate spec exists
@@ -147,33 +144,35 @@ export default class EpicSpec extends PMOCommand {
         const epicTickets = await this.storage.getTicketsForEpic(projectId, epicId);
         const ticketsWithDifferentSpec = epicTickets.filter(t => t.specId && t.specId !== specId);
         if (ticketsWithDifferentSpec.length > 0) {
-            // In JSON mode, output spec mismatch handling prompt
-            if (jsonMode) {
+            // If --align-tickets flag provided, skip prompt and align all
+            let action;
+            if (flags['align-tickets']) {
+                action = 'align_all';
+            }
+            else {
+                if (!jsonMode) {
+                    this.log(styles.warning(`\n⚠️  ${ticketsWithDifferentSpec.length} ticket(s) in this epic have different specs:`));
+                    for (const t of ticketsWithDifferentSpec.slice(0, 5)) {
+                        this.log(styles.muted(`   - ${t.id}: spec "${t.specId}"`));
+                    }
+                    if (ticketsWithDifferentSpec.length > 5) {
+                        this.log(styles.muted(`   ... and ${ticketsWithDifferentSpec.length - 5} more`));
+                    }
+                }
                 const mismatchChoices = [
-                    { name: 'Update epic only (tickets keep their specs)', value: 'epic_only' },
-                    { name: `Update epic AND align all tickets to "${specId}"`, value: 'align_all' },
-                    { name: 'Cancel', value: 'cancel' },
+                    { name: 'Update epic only (tickets keep their specs)', value: 'epic_only', command: `prlt epic spec ${epicId} ${specId} --json` },
+                    { name: `Update epic AND align all tickets to "${specId}"`, value: 'align_all', command: `prlt epic spec ${epicId} ${specId} --align-tickets --json` },
+                    { name: 'Cancel', value: 'cancel', command: '' },
                 ];
-                outputPromptAsJson(buildPromptConfig('list', 'specMismatchAction', `${ticketsWithDifferentSpec.length} ticket(s) in this epic have different specs. How to handle spec mismatch?`, mismatchChoices), createMetadata('epic spec', flags));
-                return;
-            }
-            this.log(styles.warning(`\n⚠️  ${ticketsWithDifferentSpec.length} ticket(s) in this epic have different specs:`));
-            for (const t of ticketsWithDifferentSpec.slice(0, 5)) {
-                this.log(styles.muted(`   - ${t.id}: spec "${t.specId}"`));
+                const jsonModeConfig = jsonMode ? { flags, commandName: 'epic spec' } : null;
+                const result = await this.prompt([{
+                        type: 'list',
+                        name: 'action',
+                        message: `${ticketsWithDifferentSpec.length} ticket(s) in this epic have different specs. How to handle spec mismatch?`,
+                        choices: mismatchChoices,
+                    }], jsonModeConfig);
+                action = result.action;
             }
-            if (ticketsWithDifferentSpec.length > 5) {
-                this.log(styles.muted(`   ... and ${ticketsWithDifferentSpec.length - 5} more`));
-            }
-            const { action } = await inquirer.prompt([{
-                    type: 'list',
-                    name: 'action',
-                    message: 'How to handle spec mismatch?',
-                    choices: [
-                        { name: 'Update epic only (tickets keep their specs)', value: 'epic_only' },
-                        { name: `Update epic AND align all tickets to "${specId}"`, value: 'align_all' },
-                        { name: 'Cancel', value: 'cancel' },
-                    ],
-                }]);
             if (action === 'cancel') {
                 return;
             }

package/dist/commands/epic/ticket.d.ts

@@ -12,6 +12,8 @@ export default class EpicTicket extends PMOCommand {
         unlink: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         spec: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'unlink-spec': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        reconcile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'inherit-spec': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     execute(): Promise<void>;

package/dist/commands/epic/ticket.js

@@ -1,8 +1,7 @@
 import { Args, Flags } from '@oclif/core';
-import inquirer from 'inquirer';
 import { PMOCommand, pmoBaseFlags, autoExportToBoard } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
-import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class EpicTicket extends PMOCommand {
     static description = 'Assign tickets to an epic, or link epic to a spec (parent-child)';
     static examples = [
@@ -45,6 +44,14 @@ export default class EpicTicket extends PMOCommand {
             description: 'Remove spec link from epic',
             default: false,
         }),
+        reconcile: Flags.string({
+            description: 'How to handle spec mismatch: keep (keep ticket spec), epic (use epic spec), skip',
+            options: ['keep', 'epic', 'skip'],
+        }),
+        'inherit-spec': Flags.boolean({
+            description: 'Inherit spec from epic when ticket has no spec',
+            allowNo: true,
+        }),
     };
     async execute() {
         const { args, flags, argv } = await this.parse(EpicTicket);
@@ -100,18 +107,15 @@ export default class EpicTicket extends PMOCommand {
             const epicChoices = epics.map(e => ({
                 name: `${e.id} ${e.title} (${e.status}) [${ticketCounts.get(e.id) || 0} tickets]`,
                 value: e.id,
+                command: `prlt epic ticket ${e.id} --json`,
             }));
-            // In JSON mode, output epic selection prompt
-            if (jsonMode) {
-                outputPromptAsJson(buildPromptConfig('list', 'id', 'Select epic to link tickets to:', epicChoices), createMetadata('epic ticket', flags));
-                return;
-            }
-            const { selected } = await inquirer.prompt([{
+            const jsonModeConfig = jsonMode ? { flags, commandName: 'epic ticket' } : null;
+            const { selected } = await this.prompt([{
                     type: 'list',
                     name: 'selected',
                     message: 'Select epic to link tickets to:',
                     choices: epicChoices,
-                }]);
+                }], jsonModeConfig);
             epicId = selected;
         }
         // Validate epic exists
@@ -169,19 +173,16 @@ export default class EpicTicket extends PMOCommand {
                     name: `${t.id} - ${t.title} [${epicLabel}]`,
                     value: t.id,
                     checked: false,
+                    command: `prlt epic ticket ${epicId} ${t.id} --json`,
                 };
             });
-            // In JSON mode, output ticket selection prompt
-            if (jsonMode) {
-                outputPromptAsJson(buildPromptConfig('checkbox', 'tickets', `Select tickets to ${flags.unlink ? 'unlink from' : 'link to'} ${epicId}:`, choices), createMetadata('epic ticket', flags));
-                return;
-            }
-            const { selected } = await inquirer.prompt([{
+            const jsonModeConfig = jsonMode ? { flags, commandName: 'epic ticket' } : null;
+            const { selected } = await this.prompt([{
                     type: 'checkbox',
                     name: 'selected',
                     message: `Select tickets to ${flags.unlink ? 'unlink from' : 'link to'} ${epicId}:`,
                     choices,
-                }]);
+                }], jsonModeConfig);
             ticketIds = selected;
         }
         if (ticketIds.length === 0) {
@@ -227,19 +228,31 @@ export default class EpicTicket extends PMOCommand {
                 const ticketSpecId = ticket.specId;
                 const epicSpecId = epic.specId;
                 if (ticketSpecId && epicSpecId && ticketSpecId !== epicSpecId) {
-                    // Both have specs but they differ - warn user
-                    this.log(styles.warning(`  ⚠️  Spec mismatch: ticket has "${ticketSpecId}", epic has "${epicSpecId}"`));
-                    // eslint-disable-next-line no-await-in-loop
-                    const { action } = await inquirer.prompt([{
-                            type: 'list',
-                            name: 'action',
-                            message: `How to reconcile spec for ${ticketId}?`,
-                            choices: [
-                                { name: `Keep ticket spec (${ticketSpecId})`, value: 'keep_ticket' },
-                                { name: `Use epic spec (${epicSpecId})`, value: 'use_epic' },
-                                { name: 'Skip this ticket', value: 'skip' },
-                            ],
-                        }]);
+                    // Both have specs but they differ - determine action
+                    let action;
+                    // Check if --reconcile flag was provided
+                    if (flags.reconcile) {
+                        action = flags.reconcile === 'keep' ? 'keep_ticket' : flags.reconcile === 'epic' ? 'use_epic' : 'skip';
+                    }
+                    else {
+                        if (!jsonMode) {
+                            this.log(styles.warning(`  ⚠️  Spec mismatch: ticket has "${ticketSpecId}", epic has "${epicSpecId}"`));
+                        }
+                        const specReconcileChoices = [
+                            { name: `Keep ticket spec (${ticketSpecId})`, value: 'keep_ticket', command: `prlt epic ticket ${epicId} ${ticketId} --reconcile keep --json` },
+                            { name: `Use epic spec (${epicSpecId})`, value: 'use_epic', command: `prlt epic ticket ${epicId} ${ticketId} --reconcile epic --json` },
+                            { name: 'Skip this ticket', value: 'skip', command: `prlt epic ticket ${epicId} ${ticketId} --reconcile skip --json` },
+                        ];
+                        const jsonModeConfig = jsonMode ? { flags, commandName: 'epic ticket' } : null;
+                        // eslint-disable-next-line no-await-in-loop
+                        const result = await this.prompt([{
+                                type: 'list',
+                                name: 'action',
+                                message: `Spec mismatch for ${ticketId}: ticket has "${ticketSpecId}", epic has "${epicSpecId}". How to reconcile?`,
+                                choices: specReconcileChoices,
+                            }], jsonModeConfig);
+                        action = result.action;
+                    }
                     if (action === 'skip') {
                         this.log(styles.muted(`  Skipping ${ticketId}`));
                         continue;
@@ -255,14 +268,27 @@ export default class EpicTicket extends PMOCommand {
                     }
                 }
                 else if (!ticketSpecId && epicSpecId) {
-                    // Ticket has no spec but epic does - offer to inherit
-                    // eslint-disable-next-line no-await-in-loop
-                    const { inherit } = await inquirer.prompt([{
-                            type: 'confirm',
-                            name: 'inherit',
-                            message: `${ticketId} has no spec. Inherit epic's spec "${epicSpecId}"?`,
-                            default: true,
-                        }]);
+                    // Ticket has no spec but epic does - determine if should inherit
+                    let inherit;
+                    // Check if --inherit-spec flag was provided
+                    if (flags['inherit-spec'] !== undefined) {
+                        inherit = flags['inherit-spec'];
+                    }
+                    else {
+                        const inheritChoices = [
+                            { name: 'Yes', value: true, command: `prlt epic ticket ${epicId} ${ticketId} --inherit-spec --json` },
+                            { name: 'No', value: false, command: `prlt epic ticket ${epicId} ${ticketId} --no-inherit-spec --json` },
+                        ];
+                        const jsonModeConfig = jsonMode ? { flags, commandName: 'epic ticket' } : null;
+                        // eslint-disable-next-line no-await-in-loop
+                        const result = await this.prompt([{
+                                type: 'list',
+                                name: 'inherit',
+                                message: `${ticketId} has no spec. Inherit epic's spec "${epicSpecId}"?`,
+                                choices: inheritChoices,
+                            }], jsonModeConfig);
+                        inherit = result.inherit;
+                    }
                     if (inherit) {
                         db.prepare(`
               UPDATE pmo_tickets

package/dist/commands/feedback/index.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class Feedback extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        action: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/feedback/index.js

@@ -0,0 +1,60 @@
+import { Command, Flags } from '@oclif/core';
+import { isMachineOutput, } from '../../lib/prompt-json.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
+import { FlagResolver } from '../../lib/flags/index.js';
+export default class Feedback extends Command {
+    static description = 'Interactive menu for feedback and issue operations';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --action submit',
+    ];
+    static flags = {
+        ...machineOutputFlags,
+        action: Flags.string({
+            char: 'a',
+            description: 'Action to perform (submit, list, view)',
+            options: ['submit', 'list', 'view'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Feedback);
+        // Check if JSON output mode is active
+        const jsonMode = isMachineOutput(flags);
+        // Use FlagResolver for action selection
+        const resolver = new FlagResolver({
+            commandName: 'feedback',
+            baseCommand: 'prlt feedback',
+            jsonMode,
+            flags: { action: flags.action },
+        });
+        resolver.addPrompt({
+            flagName: 'action',
+            type: 'list',
+            message: 'Feedback & Issues - What would you like to do?',
+            choices: () => [
+                { name: 'Submit feedback', value: 'submit', command: 'prlt feedback submit --json' },
+                { name: 'View my submissions', value: 'list', command: 'prlt feedback list --json' },
+                { name: 'Browse issues', value: 'view', command: 'prlt feedback list --json' },
+                { name: 'Cancel', value: 'cancel' },
+            ],
+            when: (ctx) => !ctx.flags.action,
+            skipAutoCommand: true,
+        });
+        const resolved = await resolver.resolve();
+        if (!resolved.action || resolved.action === 'cancel') {
+            return;
+        }
+        // Run the selected subcommand
+        switch (resolved.action) {
+            case 'submit':
+                await this.config.runCommand('feedback:submit', []);
+                break;
+            case 'list':
+                await this.config.runCommand('feedback:list', []);
+                break;
+            case 'view':
+                await this.config.runCommand('feedback:list', []);
+                break;
+        }
+    }
+}

package/dist/commands/feedback/list.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class FeedbackList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        state: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/feedback/list.js

@@ -0,0 +1,126 @@
+import { Command, Flags } from '@oclif/core';
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+import { styles } from '../../lib/styles.js';
+import { isGHInstalled, isGHAuthenticated } from '../../lib/pr/index.js';
+import { isMachineOutput, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
+// Target repository for feedback issues
+const FEEDBACK_REPO = 'chrismcdermut/proletariat';
+// Category to GitHub label mapping
+const CATEGORY_LABELS = {
+    bug: 'bug',
+    feature: 'enhancement',
+    general: 'feedback',
+};
+export default class FeedbackList extends Command {
+    static description = 'List recent feedback issues from the repository';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --category bug',
+        '<%= config.bin %> <%= command.id %> --state closed --limit 10',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        ...machineOutputFlags,
+        category: Flags.string({
+            char: 'c',
+            description: 'Filter by category (bug, feature, general)',
+            options: ['bug', 'feature', 'general'],
+        }),
+        state: Flags.string({
+            char: 's',
+            description: 'Filter by state',
+            options: ['open', 'closed', 'all'],
+            default: 'open',
+        }),
+        limit: Flags.integer({
+            char: 'l',
+            description: 'Maximum number of issues to show',
+            default: 20,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(FeedbackList);
+        const jsonMode = isMachineOutput(flags);
+        // Helper to handle errors in JSON mode
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('feedback list', flags));
+            }
+            this.error(message);
+        };
+        // Check if gh CLI is installed
+        if (!isGHInstalled()) {
+            return handleError('GH_NOT_INSTALLED', 'GitHub CLI (gh) is not installed. Install it with: brew install gh');
+        }
+        // Check if gh is authenticated
+        if (!isGHAuthenticated()) {
+            return handleError('GH_NOT_AUTHENTICATED', 'GitHub CLI is not authenticated. Run: gh auth login');
+        }
+        // Build the gh issue list command
+        const args = [
+            'issue', 'list',
+            '--repo', FEEDBACK_REPO,
+            '--limit', String(flags.limit),
+            '--json', 'number,title,state,labels,createdAt,author',
+        ];
+        // Add state filter
+        if (flags.state && flags.state !== 'all') {
+            args.push('--state', flags.state);
+        }
+        // Add label filter for category
+        if (flags.category) {
+            const label = CATEGORY_LABELS[flags.category];
+            if (label) {
+                args.push('--label', label);
+            }
+        }
+        try {
+            const result = execSync(`gh ${args.join(' ')}`, {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+            const issues = JSON.parse(result || '[]');
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    issues: issues.map(issue => ({
+                        number: issue.number,
+                        title: issue.title,
+                        state: issue.state,
+                        labels: issue.labels.map(l => l.name),
+                        createdAt: issue.createdAt,
+                        author: issue.author.login,
+                        url: `https://github.com/${FEEDBACK_REPO}/issues/${issue.number}`,
+                    })),
+                    count: issues.length,
+                    repository: FEEDBACK_REPO,
+                    filters: {
+                        category: flags.category,
+                        state: flags.state,
+                        limit: flags.limit,
+                    },
+                }, createMetadata('feedback list', flags));
+            }
+            // Display issues in human-friendly format
+            if (issues.length === 0) {
+                this.log(styles.muted('\nNo issues found matching your criteria.\n'));
+                return;
+            }
+            this.log(`\n${styles.header('Feedback Issues')} ${styles.muted(`(${FEEDBACK_REPO})`)}\n`);
+            for (const issue of issues) {
+                const stateIcon = issue.state === 'open' ? chalk.green('●') : chalk.red('●');
+                const labels = issue.labels.map(l => chalk.cyan(`[${l.name}]`)).join(' ');
+                const date = new Date(issue.createdAt).toLocaleDateString();
+                this.log(`${stateIcon} ${chalk.bold(`#${issue.number}`)} ${issue.title}`);
+                this.log(`  ${labels} ${styles.muted(`by ${issue.author.login} on ${date}`)}`);
+                this.log('');
+            }
+            this.log(styles.muted(`Showing ${issues.length} issue(s). Use 'prlt feedback view <number>' to see details.\n`));
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error listing issues';
+            return handleError('ISSUE_LIST_FAILED', `Failed to list issues: ${errorMessage}`);
+        }
+    }
+}

package/dist/commands/feedback/submit.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+export default class FeedbackSubmit extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        title: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        body: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    /**
+     * Collect diagnostic information to include in the issue
+     */
+    private collectDiagnostics;
+}