@proletariat/cli 0.2.0 → 0.3.1

package/dist/commands/ticket/project.js

@@ -0,0 +1,254 @@
+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, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+export default class TicketProject extends PMOCommand {
+    static description = 'Move ticket(s) to a different project';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> TKT-001 new-project',
+        '<%= config.bin %> <%= command.id %> TKT-001',
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --bulk --target other-project',
+    ];
+    static args = {
+        ticketId: Args.string({
+            description: 'Ticket ID',
+            required: false,
+        }),
+        targetProject: Args.string({
+            description: 'Target project ID',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+        'keep-epic': Flags.boolean({
+            description: 'Keep ticket assigned to its epic (if epic is in source project, will unlink)',
+            default: false,
+        }),
+        bulk: Flags.boolean({
+            char: 'b',
+            description: 'Enable bulk mode to move multiple tickets',
+            default: false,
+        }),
+        target: Flags.string({
+            char: 't',
+            description: 'Target project ID (for bulk mode)',
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(TicketProject);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Bulk mode
+        if (flags.bulk) {
+            await this.executeBulk(flags);
+            return;
+        }
+        // Get source project ID
+        const sourceProjectId = await this.requireProject();
+        // Get ticket ID
+        let ticketId = args.ticketId;
+        if (!ticketId) {
+            const tickets = await this.storage.listTickets(sourceProjectId);
+            if (tickets.length === 0) {
+                if (jsonMode) {
+                    outputErrorAsJson('NO_TICKETS', 'No tickets found in this project.', createMetadata('ticket project', flags));
+                    return;
+                }
+                this.log(styles.muted('\nNo tickets found in this project.'));
+                return;
+            }
+            const selected = await this.selectFromList({
+                message: 'Select ticket to move:',
+                items: tickets,
+                getName: (t) => `${t.id} - ${t.title} (${t.statusName})`,
+                getValue: (t) => t.id,
+                getCommand: (t) => `prlt ticket project ${t.id} --json`,
+                jsonMode: jsonMode ? { flags, commandName: 'ticket project' } : null,
+            });
+            if (!selected) {
+                return;
+            }
+            ticketId = selected;
+        }
+        // Get ticket details
+        const ticket = await this.storage.getTicket(ticketId);
+        if (!ticket) {
+            this.error(`Ticket not found: ${ticketId}`);
+        }
+        // Get all projects
+        const projects = await this.storage.listProjects();
+        const otherProjects = projects.filter(p => p.id !== sourceProjectId);
+        if (otherProjects.length === 0) {
+            this.log(styles.muted('\nNo other projects to move to.'));
+            const actionChoices = [
+                { id: 'create', name: 'Create a new project' },
+                { id: 'cancel', name: 'Cancel' },
+            ];
+            const action = await this.selectFromList({
+                message: 'What would you like to do?',
+                items: actionChoices,
+                getName: (a) => a.name,
+                getValue: (a) => a.id,
+                getCommand: (a) => a.id === 'create' ? 'prlt project create --json' : '',
+                jsonMode: jsonMode ? { flags, commandName: 'ticket project' } : null,
+            });
+            if (action === 'create') {
+                await this.config.runCommand('project:create', []);
+            }
+            return;
+        }
+        // Get target project
+        let targetProjectId = args.targetProject;
+        if (!targetProjectId) {
+            const selected = await this.selectFromList({
+                message: 'Select target project:',
+                items: otherProjects,
+                getName: (p) => `${p.id} - ${p.name} (${p.status})`,
+                getValue: (p) => p.id,
+                getCommand: (p) => `prlt ticket project ${ticketId} ${p.id} --json`,
+                jsonMode: jsonMode ? { flags, commandName: 'ticket project' } : null,
+            });
+            if (!selected) {
+                return;
+            }
+            targetProjectId = selected;
+        }
+        // Validate target project
+        const targetProject = projects.find(p => p.id === targetProjectId);
+        if (!targetProject) {
+            this.error(`Project not found: ${targetProjectId}`);
+        }
+        if (targetProjectId === sourceProjectId) {
+            this.log(styles.muted('\nTicket is already in this project.'));
+            return;
+        }
+        // Check if ticket has an epic
+        const epicWarning = ticket.epicId && !flags['keep-epic'];
+        if (epicWarning) {
+            const epic = await this.storage.getEpic(ticket.epicId);
+            if (epic && epic.projectId !== targetProjectId) {
+                this.log(styles.warning(`\nTicket is assigned to epic "${ticket.epicId}" in source project.`));
+                const actionChoices = [
+                    { id: 'unlink', name: 'Unlink from epic (move ticket only)' },
+                    { id: 'cancel', name: 'Cancel' },
+                ];
+                const action = await this.selectFromList({
+                    message: 'How to handle epic assignment?',
+                    items: actionChoices,
+                    getName: (a) => a.name,
+                    getValue: (a) => a.id,
+                    getCommand: (a) => a.id === 'unlink' ? `prlt ticket project ${ticketId} ${targetProjectId} --json` : '',
+                    jsonMode: jsonMode ? { flags, commandName: 'ticket project' } : null,
+                });
+                if (action === 'cancel' || !action) {
+                    return;
+                }
+                // Unlink from epic before moving
+                await this.storage.updateTicket(ticketId, { epicId: undefined });
+                this.log(styles.muted(`  Unlinked from epic "${ticket.epicId}"`));
+            }
+        }
+        // Move ticket to new project using the storage method
+        const movedTicket = await this.storage.moveTicketToProject(ticketId, targetProjectId);
+        await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+        this.log(styles.success(`\n✅ Moved ticket ${styles.emphasis(ticketId)} to project ${styles.emphasis(targetProjectId)}`));
+        this.log(styles.muted(`   From: ${sourceProjectId}`));
+        this.log(styles.muted(`   To: ${targetProjectId} (column: ${movedTicket.statusName || 'first column'})`));
+        this.log(styles.muted(`\nView ticket: prlt ticket view ${ticketId}`));
+    }
+    async executeBulk(flags) {
+        this.log(styles.emphasis('📁 Bulk Move Tickets to Project\n'));
+        // Get source project ID
+        const sourceProjectId = await this.requireProject();
+        // Get all tickets in current project
+        const tickets = await this.storage.listTickets(sourceProjectId);
+        if (tickets.length === 0) {
+            this.log(styles.muted('\nNo tickets found in this project.'));
+            return;
+        }
+        // Select tickets
+        const { selectedTickets } = await inquirer.prompt([{
+                type: 'checkbox',
+                name: 'selectedTickets',
+                message: 'Select tickets to move:',
+                choices: tickets.map(t => {
+                    const epicLabel = t.epicId ? ` [epic: ${t.epicId}]` : '';
+                    return {
+                        name: `${t.id} - ${t.title} (${t.statusName})${epicLabel}`,
+                        value: t.id,
+                    };
+                }),
+            }]);
+        if (selectedTickets.length === 0) {
+            this.log(styles.muted('No tickets selected.'));
+            return;
+        }
+        // Get target project
+        const projects = await this.storage.listProjects();
+        const otherProjects = projects.filter(p => p.id !== sourceProjectId);
+        if (otherProjects.length === 0) {
+            this.log(styles.muted('\nNo other projects to move to. Create one with: prlt project create'));
+            return;
+        }
+        let targetProjectId = flags.target;
+        if (!targetProjectId) {
+            const { selected } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'selected',
+                    message: 'Select target project:',
+                    choices: otherProjects.map(p => ({
+                        name: `${p.id} - ${p.name}`,
+                        value: p.id,
+                    })),
+                }]);
+            targetProjectId = selected;
+        }
+        // Validate target project
+        const targetProject = projects.find(p => p.id === targetProjectId);
+        if (!targetProject) {
+            this.error(`Project not found: ${targetProjectId}`);
+        }
+        // Check for epic conflicts
+        const ticketsWithEpics = selectedTickets.filter((id) => {
+            const t = tickets.find(t => t.id === id);
+            return t?.epicId;
+        });
+        if (ticketsWithEpics.length > 0) {
+            this.log(styles.warning(`\n${ticketsWithEpics.length} ticket(s) are assigned to epics.`));
+            const { action } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'action',
+                    message: 'How to handle epic assignments?',
+                    choices: [
+                        { name: 'Unlink from epics and move', value: 'unlink' },
+                        { name: 'Cancel', value: 'cancel' },
+                    ],
+                }]);
+            if (action === 'cancel') {
+                return;
+            }
+        }
+        // Move each ticket using the storage method
+        let lastMovedTicket;
+        for (const ticketId of selectedTickets) {
+            const ticket = tickets.find(t => t.id === ticketId);
+            // Unlink from epic if needed
+            if (ticket?.epicId) {
+                await this.storage.updateTicket(ticketId, { epicId: undefined });
+            }
+            // Move ticket to new project
+            lastMovedTicket = await this.storage.moveTicketToProject(ticketId, targetProjectId);
+            this.log(styles.success(`  Moved ${ticketId} to ${targetProjectId}`));
+        }
+        await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+        this.log(styles.success(`\n✅ Moved ${selectedTickets.length} ticket(s) to project "${targetProject.name}"`));
+        this.log(styles.muted(`   Target column: ${lastMovedTicket?.statusName || 'first column'}`));
+    }
+}

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

@@ -0,0 +1,19 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class TicketReassign extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        ticketId: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        assignee: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        to: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        bulk: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+    private executeBulk;
+}

package/dist/commands/ticket/reassign.js

@@ -0,0 +1,279 @@
+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, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+export default class TicketReassign extends PMOCommand {
+    static description = 'Reassign ticket(s) to a different agent';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> TKT-001 alice',
+        '<%= config.bin %> <%= command.id %> --bulk --to alice',
+        '<%= config.bin %> <%= command.id %> --bulk --from bob --to alice',
+        '<%= config.bin %> <%= command.id %> --json  # Output choices as JSON',
+    ];
+    static args = {
+        ticketId: Args.string({
+            description: 'Ticket ID - prompts with dropdown if not provided',
+            required: false,
+        }),
+        assignee: Args.string({
+            description: 'Target agent name',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+        to: Flags.string({
+            description: 'Target agent name (for bulk mode)',
+        }),
+        from: Flags.string({
+            description: 'Filter tickets by current assignee (bulk mode)',
+        }),
+        bulk: Flags.boolean({
+            char: 'b',
+            description: 'Enable bulk mode to reassign multiple tickets',
+            default: false,
+        }),
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Skip confirmation prompt',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(TicketReassign);
+        const projectId = flags.project;
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Get all tickets
+        const allTickets = await this.storage.listTickets(projectId);
+        if (allTickets.length === 0) {
+            if (jsonMode) {
+                outputErrorAsJson('NO_TICKETS', 'No tickets found.', createMetadata('ticket reassign', flags));
+                return;
+            }
+            this.log(styles.warning('No tickets found.'));
+            return;
+        }
+        // Get unique assignees from tickets
+        const assignees = new Set();
+        for (const ticket of allTickets) {
+            if (ticket.assignee) {
+                assignees.add(ticket.assignee);
+            }
+        }
+        // Also get agents from workspace if available
+        const db = this.storage.db;
+        try {
+            const agents = db.prepare(`SELECT name FROM agents`).all();
+            for (const agent of agents) {
+                assignees.add(agent.name);
+            }
+        }
+        catch {
+            // agents table might not exist, ignore
+        }
+        // Bulk mode
+        if (flags.bulk) {
+            await this.executeBulk(allTickets, Array.from(assignees), flags);
+            return;
+        }
+        // Single ticket mode
+        let ticketId = args.ticketId;
+        if (!ticketId) {
+            const selected = await this.selectFromList({
+                message: 'Select ticket to reassign:',
+                items: allTickets,
+                getName: (t) => `${t.id} - ${t.title} (${t.statusName})`,
+                getValue: (t) => t.id,
+                getCommand: (t) => `prlt ticket reassign ${t.id} --json`,
+                jsonMode: jsonMode ? { flags, commandName: 'ticket reassign' } : null,
+            });
+            if (!selected) {
+                return;
+            }
+            ticketId = selected;
+        }
+        // Get ticket
+        const ticket = await this.storage.getTicket(ticketId);
+        if (!ticket) {
+            this.error(`Ticket "${ticketId}" not found.`);
+        }
+        // Get target assignee
+        let targetAssignee = args.assignee || flags.to;
+        if (!targetAssignee) {
+            const { assignee } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'assignee',
+                    message: `Reassign ${ticketId} to:`,
+                    choices: [
+                        { name: 'None (unassign)', value: '__none__' },
+                        ...Array.from(assignees).sort().map(a => ({
+                            name: a === ticket.assignee ? `${a} (current)` : a,
+                            value: a,
+                        })),
+                        { name: '── Enter custom name ──', value: '__custom__' },
+                    ],
+                }]);
+            if (assignee === '__custom__') {
+                const { customAssignee } = await inquirer.prompt([{
+                        type: 'input',
+                        name: 'customAssignee',
+                        message: 'Enter agent/assignee name:',
+                        validate: (input) => input.length > 0 || 'Name is required',
+                    }]);
+                targetAssignee = customAssignee;
+            }
+            else if (assignee === '__none__') {
+                targetAssignee = undefined;
+            }
+            else {
+                targetAssignee = assignee;
+            }
+        }
+        // Handle special values
+        if (targetAssignee === 'none' || targetAssignee === 'unassigned') {
+            targetAssignee = undefined;
+        }
+        // Check if same
+        if (targetAssignee === ticket.assignee) {
+            this.log(styles.muted(`Ticket "${ticketId}" is already assigned to "${targetAssignee || 'none'}".`));
+            return;
+        }
+        // Update ticket
+        await this.storage.updateTicket(ticketId, { assignee: targetAssignee || undefined });
+        // Auto-export
+        await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+        const action = targetAssignee ? `reassigned to ${targetAssignee}` : 'unassigned';
+        this.log(styles.success(`\n✅ Ticket ${styles.emphasis(ticketId)} ${action}`));
+        this.log(styles.muted(`   Title: ${ticket.title}`));
+        if (ticket.assignee) {
+            this.log(styles.muted(`   Previous: ${ticket.assignee}`));
+        }
+    }
+    async executeBulk(allTickets, assigneesList, flags) {
+        this.log(styles.emphasis('👤 Reassign Tickets\n'));
+        // Filter tickets if --from specified
+        let filteredTickets = allTickets;
+        if (flags.from) {
+            if (flags.from === 'none' || flags.from === 'unassigned') {
+                filteredTickets = allTickets.filter(t => !t.assignee);
+            }
+            else {
+                filteredTickets = allTickets.filter(t => t.assignee === flags.from);
+            }
+        }
+        if (filteredTickets.length === 0) {
+            this.log(styles.warning('No tickets found matching filter.'));
+            return;
+        }
+        // Select tickets to reassign
+        const { selectedTickets } = await inquirer.prompt([{
+                type: 'checkbox',
+                name: 'selectedTickets',
+                message: 'Select tickets to reassign:',
+                choices: filteredTickets.map(t => ({
+                    name: `${t.id} - ${t.title}  [Assignee: ${t.assignee || '(none)'}]`,
+                    value: t.id,
+                })),
+            }]);
+        if (selectedTickets.length === 0) {
+            this.log(styles.muted('No tickets selected.'));
+            return;
+        }
+        // Select target assignee
+        let targetAssignee = flags.to;
+        if (targetAssignee === undefined) {
+            const { assignee } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'assignee',
+                    message: 'Reassign to which agent?',
+                    choices: [
+                        { name: 'None (unassign)', value: '__none__' },
+                        ...assigneesList.sort().map(a => ({
+                            name: a,
+                            value: a,
+                        })),
+                        { name: '── Enter custom name ──', value: '__custom__' },
+                    ],
+                }]);
+            if (assignee === '__custom__') {
+                const { customAssignee } = await inquirer.prompt([{
+                        type: 'input',
+                        name: 'customAssignee',
+                        message: 'Enter agent/assignee name:',
+                        validate: (input) => input.length > 0 || 'Name is required',
+                    }]);
+                targetAssignee = customAssignee;
+            }
+            else if (assignee === '__none__') {
+                targetAssignee = undefined;
+            }
+            else {
+                targetAssignee = assignee;
+            }
+        }
+        // Handle special values
+        if (targetAssignee === 'none' || targetAssignee === 'unassigned') {
+            targetAssignee = undefined;
+        }
+        // Confirmation
+        if (!flags.force) {
+            const assigneeLabel = targetAssignee || 'None (unassigning)';
+            this.log(styles.primary('\nWill reassign to:'));
+            this.log(styles.primary(`  → ${assigneeLabel}\n`));
+            this.log(styles.primary('Tickets:'));
+            for (const ticketId of selectedTickets) {
+                const ticket = filteredTickets.find(t => t.id === ticketId);
+                this.log(styles.primary(`  • ${ticketId}: ${ticket?.title}`));
+            }
+            this.log('');
+            const { confirm } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'confirm',
+                    message: 'Continue?',
+                    choices: [
+                        { name: 'No, cancel', value: false },
+                        { name: 'Yes, reassign tickets', value: true }
+                    ],
+                    default: 0
+                }]);
+            if (!confirm) {
+                this.log(styles.muted('Operation cancelled.'));
+                return;
+            }
+        }
+        this.log('');
+        // Reassign each ticket
+        let successCount = 0;
+        let failCount = 0;
+        for (const ticketId of selectedTickets) {
+            try {
+                await this.storage.updateTicket(ticketId, { assignee: targetAssignee || undefined });
+                const action = targetAssignee ? `Reassigned to ${targetAssignee}` : 'Unassigned';
+                this.log(styles.success(`${ticketId}: ${action}`));
+                successCount++;
+            }
+            catch (error) {
+                this.log(styles.error(`Failed to reassign ${ticketId}: ${error instanceof Error ? error.message : String(error)}`));
+                failCount++;
+            }
+        }
+        // Auto-export to kanban.md
+        await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+        // Summary
+        this.log('');
+        if (successCount > 0) {
+            const action = targetAssignee ? 'Reassigned' : 'Unassigned';
+            this.log(styles.success(`${action} ${successCount} ticket(s)`));
+        }
+        if (failCount > 0) {
+            this.log(styles.error(`Failed to reassign ${failCount} ticket(s)`));
+        }
+    }
+}

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

@@ -0,0 +1,18 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class TicketSpec extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        ticketId: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        specId: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        unlink: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        bulk: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        spec: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+    private executeBulk;
+}