@proletariat/cli 0.3.23 → 0.3.25

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;
+}

package/dist/commands/feedback/submit.js

@@ -0,0 +1,220 @@
+import { Command, Flags } from '@oclif/core';
+import { execSync } from 'node:child_process';
+import * as os from 'node:os';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { styles } from '../../lib/styles.js';
+import { isGHInstalled, isGHAuthenticated } from '../../lib/pr/index.js';
+import { isMachineOutput, outputSuccessAsJson, outputErrorAsJson, outputPromptAsJson, buildPromptConfig, 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 FeedbackSubmit extends Command {
+    static description = 'Submit feedback, bug reports, or feature requests to GitHub Issues';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --title "Bug in CLI" --body "Description here" --category bug',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        ...machineOutputFlags,
+        title: Flags.string({
+            char: 't',
+            description: 'Issue title (one-liner) [required for non-interactive]',
+        }),
+        body: Flags.string({
+            char: 'b',
+            description: 'Issue description [required for non-interactive]',
+        }),
+        category: Flags.string({
+            char: 'c',
+            description: 'Feedback category',
+            options: ['bug', 'feature', 'general'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(FeedbackSubmit);
+        const jsonMode = isMachineOutput(flags);
+        // Helper to handle errors in JSON mode
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('feedback submit', 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');
+        }
+        // Collect category
+        let category = flags.category;
+        if (!category) {
+            const categoryChoices = [
+                { name: 'Bug report', value: 'bug' },
+                { name: 'Feature request', value: 'feature' },
+                { name: 'General feedback', value: 'general' },
+            ];
+            const categoryMessage = 'What type of feedback would you like to submit?';
+            if (jsonMode) {
+                outputPromptAsJson(buildPromptConfig('list', 'category', categoryMessage, categoryChoices), createMetadata('feedback submit', flags));
+                return;
+            }
+            const { selectedCategory } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'selectedCategory',
+                    message: categoryMessage,
+                    choices: categoryChoices,
+                }]);
+            category = selectedCategory;
+        }
+        // Collect title
+        let title = flags.title;
+        if (!title) {
+            const titleMessage = 'Enter a brief title for your feedback:';
+            if (jsonMode) {
+                outputPromptAsJson(buildPromptConfig('input', 'title', titleMessage), createMetadata('feedback submit', { ...flags, category }));
+                return;
+            }
+            const { inputTitle } = await inquirer.prompt([{
+                    type: 'input',
+                    name: 'inputTitle',
+                    message: titleMessage,
+                    validate: (input) => {
+                        if (!input.trim()) {
+                            return 'Title is required';
+                        }
+                        if (input.length > 200) {
+                            return 'Title must be less than 200 characters';
+                        }
+                        return true;
+                    },
+                }]);
+            title = inputTitle;
+        }
+        // Collect body/description
+        let body = flags.body;
+        if (!body) {
+            const bodyMessage = 'Describe your feedback in detail:';
+            if (jsonMode) {
+                outputPromptAsJson(buildPromptConfig('editor', 'body', bodyMessage), createMetadata('feedback submit', { ...flags, category, title }));
+                return;
+            }
+            const { inputBody } = await inquirer.prompt([{
+                    type: 'editor',
+                    name: 'inputBody',
+                    message: bodyMessage,
+                    validate: (input) => {
+                        if (!input.trim()) {
+                            return 'Description is required';
+                        }
+                        return true;
+                    },
+                }]);
+            body = inputBody;
+        }
+        // Build diagnostics section
+        const diagnostics = this.collectDiagnostics();
+        // Build full issue body with diagnostics
+        const fullBody = `${body}\n\n---\n\n## Diagnostics\n\n${diagnostics}`;
+        // Get label for category
+        const label = CATEGORY_LABELS[category] || 'feedback';
+        // Create the GitHub issue
+        if (!jsonMode) {
+            this.log(styles.muted('\nCreating issue on GitHub...\n'));
+        }
+        // Escape title for shell
+        const escapedTitle = title.replace(/"/g, '\\"');
+        let usedLabel = label;
+        let result;
+        try {
+            // Try with label first
+            result = execSync(`gh issue create --repo "${FEEDBACK_REPO}" --title "${escapedTitle}" --body-file - --label "${label}"`, {
+                encoding: 'utf-8',
+                input: fullBody,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+        }
+        catch (labelError) {
+            // If label doesn't exist, try without label
+            const labelErrorMessage = labelError instanceof Error ? labelError.message : '';
+            if (labelErrorMessage.includes('not found') && labelErrorMessage.includes('label')) {
+                try {
+                    usedLabel = null;
+                    result = execSync(`gh issue create --repo "${FEEDBACK_REPO}" --title "${escapedTitle}" --body-file -`, {
+                        encoding: 'utf-8',
+                        input: fullBody,
+                        stdio: ['pipe', 'pipe', 'pipe'],
+                    }).trim();
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : 'Unknown error creating issue';
+                    return handleError('ISSUE_CREATE_FAILED', `Failed to create issue: ${errorMessage}`);
+                }
+            }
+            else {
+                const errorMessage = labelError instanceof Error ? labelError.message : 'Unknown error creating issue';
+                return handleError('ISSUE_CREATE_FAILED', `Failed to create issue: ${errorMessage}`);
+            }
+        }
+        // Parse issue URL from result
+        const issueUrl = result;
+        const issueMatch = issueUrl.match(/\/issues\/(\d+)/);
+        const issueNumber = issueMatch ? parseInt(issueMatch[1], 10) : undefined;
+        if (jsonMode) {
+            outputSuccessAsJson({
+                issueUrl,
+                issueNumber,
+                title: title,
+                category: category,
+                label: usedLabel,
+                repository: FEEDBACK_REPO,
+            }, createMetadata('feedback submit', flags));
+        }
+        this.log(chalk.green('  ✓ Issue created successfully!\n'));
+        this.log(`${styles.header('Issue URL:')} ${chalk.cyan(issueUrl)}`);
+        if (issueNumber) {
+            this.log(`${styles.header('Issue #:')}   ${issueNumber}`);
+        }
+        this.log(`${styles.header('Category:')} ${category}`);
+        if (usedLabel) {
+            this.log(`${styles.header('Label:')}    ${usedLabel}\n`);
+        }
+        else {
+            this.log(styles.muted(`(Label '${label}' not found in repository)\n`));
+        }
+        this.log(styles.muted('Thank you for your feedback!'));
+    }
+    /**
+     * Collect diagnostic information to include in the issue
+     */
+    collectDiagnostics() {
+        const lines = [];
+        // CLI version
+        lines.push(`- **CLI Version:** ${this.config.version}`);
+        // Node version
+        lines.push(`- **Node Version:** ${process.version}`);
+        // OS info
+        lines.push(`- **OS:** ${process.platform}`);
+        lines.push(`- **OS Version:** ${os.release()}`);
+        // Try to get workspace name if available
+        try {
+            const cwd = process.cwd();
+            const workspaceName = cwd.split('/').pop() || 'unknown';
+            lines.push(`- **Working Directory:** ${workspaceName}`);
+        }
+        catch {
+            // Ignore errors getting workspace name
+        }
+        return lines.join('\n');
+    }
+}

package/dist/commands/{template/phase/delete.d.ts → feedback/view.d.ts}

@@ -1,13 +1,15 @@
 import { Command } from '@oclif/core';
-export default class TemplatePhaseDelete extends Command {
+export default class FeedbackView extends Command {
     static description: string;
     static examples: string[];
-    static args: {
-        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
     static flags: {
-        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    static args: {
+        number: import("@oclif/core/interfaces").Arg<number, {
+            max?: number;
+            min?: number;
+        }>;
+    };
     run(): Promise<void>;
 }

package/dist/commands/feedback/view.js

@@ -0,0 +1,109 @@
+import { Command, Args } 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';
+export default class FeedbackView extends Command {
+    static description = 'View details of a specific feedback issue';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> 123',
+        '<%= config.bin %> <%= command.id %> 123 --json',
+    ];
+    static flags = {
+        ...machineOutputFlags,
+    };
+    static args = {
+        number: Args.integer({
+            description: 'Issue number to view',
+            required: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FeedbackView);
+        const jsonMode = isMachineOutput(flags);
+        const issueNumber = args.number;
+        // Helper to handle errors in JSON mode
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('feedback view', 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');
+        }
+        try {
+            // Get issue details
+            const result = execSync(`gh issue view ${issueNumber} --repo "${FEEDBACK_REPO}" --json number,title,body,state,labels,createdAt,updatedAt,author,comments`, {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+            const issue = JSON.parse(result);
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    number: issue.number,
+                    title: issue.title,
+                    body: issue.body,
+                    state: issue.state,
+                    labels: issue.labels.map(l => l.name),
+                    createdAt: issue.createdAt,
+                    updatedAt: issue.updatedAt,
+                    author: issue.author.login,
+                    comments: issue.comments.map(c => ({
+                        author: c.author.login,
+                        body: c.body,
+                        createdAt: c.createdAt,
+                    })),
+                    url: `https://github.com/${FEEDBACK_REPO}/issues/${issue.number}`,
+                    repository: FEEDBACK_REPO,
+                }, createMetadata('feedback view', flags));
+            }
+            // Display issue in human-friendly format
+            const stateIcon = issue.state === 'OPEN' ? chalk.green('OPEN') : chalk.red('CLOSED');
+            const labels = issue.labels.map(l => chalk.cyan(`[${l.name}]`)).join(' ');
+            const createdDate = new Date(issue.createdAt).toLocaleString();
+            const updatedDate = new Date(issue.updatedAt).toLocaleString();
+            this.log(`\n${styles.header('Issue #')}${chalk.bold(String(issue.number))} ${stateIcon}\n`);
+            this.log(`${styles.header('Title:')}   ${issue.title}`);
+            this.log(`${styles.header('Author:')}  ${issue.author.login}`);
+            this.log(`${styles.header('Labels:')}  ${labels || styles.muted('none')}`);
+            this.log(`${styles.header('Created:')} ${createdDate}`);
+            this.log(`${styles.header('Updated:')} ${updatedDate}`);
+            this.log(`${styles.header('URL:')}     ${chalk.cyan(`https://github.com/${FEEDBACK_REPO}/issues/${issue.number}`)}`);
+            if (issue.body) {
+                this.log(`\n${styles.header('Description:')}`);
+                this.log(styles.muted('─'.repeat(50)));
+                this.log(issue.body);
+                this.log(styles.muted('─'.repeat(50)));
+            }
+            if (issue.comments && issue.comments.length > 0) {
+                this.log(`\n${styles.header('Comments:')} (${issue.comments.length})`);
+                this.log(styles.muted('─'.repeat(50)));
+                for (const comment of issue.comments) {
+                    const commentDate = new Date(comment.createdAt).toLocaleString();
+                    this.log(`\n${chalk.bold(comment.author.login)} ${styles.muted(`on ${commentDate}`)}`);
+                    this.log(comment.body);
+                }
+                this.log(styles.muted('─'.repeat(50)));
+            }
+            this.log('');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error viewing issue';
+            // Check if it's a "not found" error
+            if (errorMessage.includes('not found') || errorMessage.includes('Could not resolve')) {
+                return handleError('ISSUE_NOT_FOUND', `Issue #${issueNumber} not found in ${FEEDBACK_REPO}`);
+            }
+            return handleError('ISSUE_VIEW_FAILED', `Failed to view issue: ${errorMessage}`);
+        }
+    }
+}

package/dist/commands/gh/index.js

@@ -32,6 +32,7 @@ export default class GH extends Command {
                 { name: 'Check status', value: 'status', command: 'prlt gh status --json' },
                 { name: 'Login to GitHub', value: 'login', command: 'prlt gh login --json' },
                 { name: 'Show GH_TOKEN setup', value: 'token', command: 'prlt gh token --json' },
+                { name: 'Create GitHub repository', value: 'repo-create', command: 'prlt repo create --json' },
             ],
             skipAutoCommand: true, // Use our custom commands above
         });
@@ -48,6 +49,9 @@ export default class GH extends Command {
             case 'token':
                 await this.config.runCommand('gh token');
                 break;
+            case 'repo-create':
+                await this.config.runCommand('repo create');
+                break;
         }
     }
 }

package/dist/commands/{epic/link/remove.d.ts → link/create.d.ts}

@@ -1,16 +1,15 @@
-import { PMOCommand } from '../../../lib/pmo/index.js';
-export default class EpicLinkRemove extends PMOCommand {
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class LinkCreate extends PMOCommand {
     static description: string;
     static examples: string[];
     static args: {
-        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        from: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        to: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     execute(): Promise<void>;
 }