@proletariat/cli 0.2.0 → 0.3.0

package/dist/commands/ticket/link/index.d.ts

@@ -0,0 +1,19 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class TicketLink extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        blocks: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        relates: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        duplicates: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+    private addDependency;
+    private viewDependencies;
+}

package/dist/commands/ticket/link/index.js

@@ -0,0 +1,239 @@
+import { Args, Flags } from '@oclif/core';
+import { autoExportToBoard, PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
+import { styles } from '../../../lib/styles.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../../lib/prompt-json.js';
+export default class TicketLink extends PMOCommand {
+    static description = 'Manage ticket dependencies (links)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> TKT-001                    # List dependencies',
+        '<%= config.bin %> <%= command.id %> TKT-001 --blocks TKT-002   # TKT-001 is blocked by TKT-002',
+        '<%= config.bin %> <%= command.id %> TKT-001 --relates TKT-002  # TKT-001 relates to TKT-002',
+        '<%= config.bin %> <%= command.id %> TKT-001 --duplicates TKT-002',
+        '<%= config.bin %> <%= command.id %> TKT-001 --all              # Show all (blockers + blocking)',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Ticket ID',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+        blocks: Flags.string({
+            char: 'b',
+            description: 'Add blocking dependency: this ticket is blocked by TARGET',
+        }),
+        relates: Flags.string({
+            char: 'r',
+            description: 'Add relates_to dependency: this ticket relates to TARGET',
+        }),
+        duplicates: Flags.string({
+            char: 'd',
+            description: 'Add duplicates dependency: this ticket duplicates TARGET',
+        }),
+        all: Flags.boolean({
+            char: 'a',
+            description: 'Show all dependencies (blockers and tickets blocked by this)',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(TicketLink);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        const projectId = flags.project;
+        let ticketId = args.id;
+        if (!ticketId) {
+            const tickets = await this.storage.listTickets(projectId);
+            if (tickets.length === 0) {
+                if (jsonMode) {
+                    outputErrorAsJson('NO_TICKETS', 'No tickets found.', createMetadata('ticket link', flags));
+                    return;
+                }
+                this.log(styles.muted('\nNo tickets found.'));
+                return;
+            }
+            const selected = await this.selectFromList({
+                message: 'Select ticket to manage dependencies:',
+                items: tickets,
+                getName: (t) => `${t.id} - ${t.title}`,
+                getValue: (t) => t.id,
+                getCommand: (t) => `prlt ticket link ${t.id} --json`,
+                jsonMode: jsonMode ? { flags, commandName: 'ticket link' } : null,
+            });
+            if (!selected) {
+                return;
+            }
+            ticketId = selected;
+        }
+        const ticket = await this.storage.getTicket(ticketId);
+        if (!ticket) {
+            this.error(`Ticket not found: ${ticketId}`);
+        }
+        // If a dependency flag is provided, add the dependency directly
+        if (flags.blocks || flags.relates || flags.duplicates) {
+            const targetId = flags.blocks || flags.relates || flags.duplicates;
+            const dependencyType = flags.blocks ? 'blocks' :
+                flags.relates ? 'relates_to' : 'duplicates';
+            await this.addDependency(this.storage, this.pmoPath, ticketId, targetId, dependencyType, ticket.title);
+            return;
+        }
+        // Interactive mode: show menu in a loop
+        let continueLoop = true;
+        while (continueLoop) {
+            const allTickets = await this.storage.listTickets(projectId);
+            const otherTickets = allTickets.filter(t => t.id !== ticketId);
+            const menuChoices = [
+                { id: 'view', name: 'View dependencies' },
+                { id: 'blocks', name: 'Add blocking dependency (blocked by...)' },
+                { id: 'relates_to', name: 'Add relates_to dependency' },
+                { id: 'duplicates', name: 'Add duplicates dependency' },
+                { id: 'remove', name: 'Remove dependency' },
+                { id: 'done', name: 'Done' },
+            ];
+            const action = await this.selectFromList({
+                message: `Dependencies for ${ticket.id}:`,
+                items: menuChoices,
+                getName: (c) => c.name,
+                getValue: (c) => c.id,
+                getCommand: (c) => {
+                    switch (c.id) {
+                        case 'view': return `prlt ticket link ${ticketId} --all`;
+                        case 'blocks': return `prlt ticket link block ${ticketId} --json`;
+                        case 'relates_to': return `prlt ticket link relates ${ticketId} --json`;
+                        case 'duplicates': return `prlt ticket link duplicates ${ticketId} --json`;
+                        case 'remove': return `prlt ticket link remove ${ticketId} --json`;
+                        default: return '';
+                    }
+                },
+                jsonMode: jsonMode ? { flags, commandName: 'ticket link' } : null,
+            });
+            if (action === 'done' || !action) {
+                continueLoop = false;
+                continue;
+            }
+            if (action === 'view') {
+                await this.viewDependencies(this.storage, ticketId, ticket, flags.all);
+                continue;
+            }
+            if (action === 'remove') {
+                const dependencies = await this.storage.listTicketDependencies(ticketId);
+                if (dependencies.length === 0) {
+                    this.log(styles.muted('\nNo dependencies to remove.'));
+                    continue;
+                }
+                const depChoices = await Promise.all(dependencies.map(async (dep) => {
+                    const depTicket = await this.storage.getTicket(dep.dependsOnTicketId);
+                    return {
+                        id: dep.dependsOnTicketId,
+                        name: `${dep.dependsOnTicketId} - ${depTicket?.title || 'Unknown'} (${dep.dependencyType})`,
+                        type: dep.dependencyType
+                    };
+                }));
+                const selected = await this.selectFromList({
+                    message: 'Select dependency to remove:',
+                    items: depChoices,
+                    getName: (d) => d.name,
+                    getValue: (d) => d.id,
+                    getCommand: (d) => `prlt ticket link remove ${ticketId} ${d.id} --type ${d.type} --json`,
+                    jsonMode: jsonMode ? { flags, commandName: 'ticket link' } : null,
+                });
+                if (!selected) {
+                    continue;
+                }
+                const selectedDep = depChoices.find(d => d.id === selected);
+                if (selectedDep) {
+                    await this.storage.deleteTicketDependency(ticketId, selected, selectedDep.type);
+                    await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+                    this.log(styles.success(`\n✅ Removed dependency: ${ticketId} → ${selected}`));
+                }
+                continue;
+            }
+            // Add dependency
+            if (otherTickets.length === 0) {
+                this.log(styles.muted('\nNo other tickets to link to.'));
+                continue;
+            }
+            const targetId = await this.selectFromList({
+                message: `Select ticket that ${ticketId} ${action === 'blocks' ? 'is blocked by' : action === 'relates_to' ? 'relates to' : 'duplicates'}:`,
+                items: otherTickets,
+                getName: (t) => `${t.id} - ${t.title}`,
+                getValue: (t) => t.id,
+                getCommand: (t) => `prlt ticket link ${action === 'blocks' ? 'block' : action} ${ticketId} ${t.id} --json`,
+                jsonMode: jsonMode ? { flags, commandName: 'ticket link' } : null,
+            });
+            if (targetId) {
+                await this.addDependency(this.storage, this.pmoPath, ticketId, targetId, action, ticket.title);
+            }
+        }
+    }
+    async addDependency(storage, pmoPath, ticketId, targetId, dependencyType, ticketTitle) {
+        const targetTicket = await this.storage.getTicket(targetId);
+        if (!targetTicket) {
+            this.error(`Ticket not found: ${targetId}`);
+        }
+        try {
+            await this.storage.createTicketDependency(ticketId, targetId, dependencyType);
+            await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+            const typeLabel = dependencyType === 'blocks' ? 'is blocked by' :
+                dependencyType === 'relates_to' ? 'relates to' : 'duplicates';
+            this.log(styles.success(`\n✅ ${styles.emphasis(ticketId)} ${typeLabel} ${styles.emphasis(targetId)}`));
+            this.log(styles.muted(`   ${ticketTitle}`));
+            this.log(styles.muted(`   ${typeLabel} ${targetTicket.title}`));
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.message.includes('already exists')) {
+                    this.error('Dependency already exists');
+                }
+                if (error.message.includes('self-dependency')) {
+                    this.error('Cannot create self-dependency');
+                }
+            }
+            throw error;
+        }
+    }
+    async viewDependencies(storage, ticketId, ticket, showAll) {
+        const dependencies = await this.storage.listTicketDependencies(ticketId);
+        const blockers = await this.storage.getTicketBlockers(ticketId);
+        const isBlocked = await this.storage.isTicketBlocked(ticketId);
+        this.log(`\n${styles.emphasis(ticket.id)}: ${ticket.title}`);
+        if (isBlocked) {
+            this.log(styles.warning('  Status: BLOCKED'));
+        }
+        if (blockers.length > 0) {
+            this.log(styles.muted('\n  Blocked by:'));
+            for (const blocker of blockers) {
+                const status = blocker.status === 'done' ? styles.success('done') : styles.warning(blocker.status);
+                this.log(`    - ${blocker.id}: ${blocker.title} (${status})`);
+            }
+        }
+        const otherDeps = dependencies.filter(d => d.dependencyType !== 'blocks');
+        if (otherDeps.length > 0) {
+            this.log(styles.muted('\n  Related:'));
+            for (const dep of otherDeps) {
+                const relatedTicket = await this.storage.getTicket(dep.dependsOnTicketId);
+                if (relatedTicket) {
+                    this.log(`    - ${dep.dependencyType}: ${relatedTicket.id} - ${relatedTicket.title}`);
+                }
+            }
+        }
+        if (showAll) {
+            const blockedBy = await this.storage.getTicketsBlockedBy(ticketId);
+            if (blockedBy.length > 0) {
+                this.log(styles.muted('\n  Blocking:'));
+                for (const blocked of blockedBy) {
+                    this.log(`    - ${blocked.id}: ${blocked.title} (${blocked.status})`);
+                }
+            }
+        }
+        if (dependencies.length === 0 && blockers.length === 0) {
+            this.log(styles.muted('\n  No dependencies.'));
+        }
+        this.log('');
+    }
+}

package/dist/commands/ticket/link/relates.d.ts

@@ -0,0 +1,14 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class TicketLinkRelates 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>>;
+    };
+    static flags: {
+        json: 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/ticket/link/relates.js

@@ -0,0 +1,93 @@
+import { Args, Flags } from '@oclif/core';
+import { autoExportToBoard, PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
+import { styles } from '../../../lib/styles.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../../lib/prompt-json.js';
+export default class TicketLinkRelates extends PMOCommand {
+    static description = 'Add a relates_to dependency (informational link)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> TKT-001 TKT-002  # TKT-001 relates to TKT-002',
+        '<%= config.bin %> <%= command.id %> TKT-001         # Interactive selection',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Ticket ID',
+            required: true,
+        }),
+        target: Args.string({
+            description: 'Related ticket ID',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(TicketLinkRelates);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Helper to handle errors in JSON mode
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('ticket link relates', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        };
+        const ticket = await this.storage.getTicket(args.id);
+        if (!ticket) {
+            return handleError('TICKET_NOT_FOUND', `Ticket not found: ${args.id}`);
+        }
+        let targetId = args.target;
+        if (!targetId) {
+            const projectId = flags.project;
+            const allTickets = await this.storage.listTickets(projectId);
+            const otherTickets = allTickets.filter(t => t.id !== args.id);
+            if (otherTickets.length === 0) {
+                if (jsonMode) {
+                    outputErrorAsJson('NO_OTHER_TICKETS', 'No other tickets to relate to.', createMetadata('ticket link relates', flags));
+                    return;
+                }
+                this.log(styles.muted('\nNo other tickets to relate to.'));
+                return;
+            }
+            const selected = await this.selectFromList({
+                message: `Select ticket that ${args.id} relates to:`,
+                items: otherTickets,
+                getName: (t) => `${t.id} - ${t.title} (${t.statusName || t.status})`,
+                getValue: (t) => t.id,
+                getCommand: (t) => `prlt ticket link relates ${args.id} ${t.id} --json`,
+                jsonMode: jsonMode ? { flags, commandName: 'ticket link relates' } : null,
+            });
+            if (!selected) {
+                return;
+            }
+            targetId = selected;
+        }
+        const targetTicket = await this.storage.getTicket(targetId);
+        if (!targetTicket) {
+            this.error(`Ticket not found: ${targetId}`);
+        }
+        try {
+            await this.storage.createTicketDependency(args.id, targetId, 'relates_to');
+            await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+            this.log(styles.success(`\n✅ ${styles.emphasis(args.id)} relates to ${styles.emphasis(targetId)}`));
+            this.log(styles.muted(`   ${ticket.title}`));
+            this.log(styles.muted(`   relates to: ${targetTicket.title}`));
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.message.includes('already exists')) {
+                    this.error('Dependency already exists');
+                }
+                if (error.message.includes('self-dependency')) {
+                    this.error('Cannot create self-dependency');
+                }
+            }
+            throw error;
+        }
+    }
+}

package/dist/commands/ticket/link/remove.d.ts

@@ -0,0 +1,16 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class TicketLinkRemove 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>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        all: 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/ticket/link/remove.js

@@ -0,0 +1,128 @@
+import { Args, Flags } from '@oclif/core';
+import { autoExportToBoard, PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
+import { styles } from '../../../lib/styles.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../../lib/prompt-json.js';
+export default class TicketLinkRemove extends PMOCommand {
+    static description = 'Remove a dependency from a ticket';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> TKT-001 TKT-002',
+        '<%= config.bin %> <%= command.id %> TKT-001 TKT-002 --type blocks',
+        '<%= config.bin %> <%= command.id %> TKT-001 --all',
+        '<%= config.bin %> <%= command.id %> TKT-001         # Interactive selection',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Ticket ID',
+            required: true,
+        }),
+        target: Args.string({
+            description: 'Target ticket ID to unlink',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+        type: Flags.string({
+            char: 't',
+            description: 'Dependency type to remove',
+            options: ['blocks', 'relates_to', 'duplicates'],
+        }),
+        all: Flags.boolean({
+            char: 'a',
+            description: 'Remove all dependencies for this ticket',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(TicketLinkRemove);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Helper to handle errors in JSON mode
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('ticket link remove', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        };
+        const ticket = await this.storage.getTicket(args.id);
+        if (!ticket) {
+            return handleError('TICKET_NOT_FOUND', `Ticket not found: ${args.id}`);
+        }
+        const dependencies = await this.storage.listTicketDependencies(args.id);
+        if (dependencies.length === 0) {
+            if (jsonMode) {
+                outputErrorAsJson('NO_DEPENDENCIES', `Ticket ${args.id} has no dependencies.`, createMetadata('ticket link remove', flags));
+                return;
+            }
+            this.log(styles.muted(`\nTicket ${args.id} has no dependencies.`));
+            return;
+        }
+        // If --all flag, remove all dependencies
+        if (flags.all) {
+            const confirmChoices = [
+                { id: 'no', name: 'No, cancel' },
+                { id: 'yes', name: `Yes, remove all ${dependencies.length} dependencies` },
+            ];
+            const confirmed = await this.selectFromList({
+                message: `Remove all ${dependencies.length} dependencies from ${args.id}?`,
+                items: confirmChoices,
+                getName: (c) => c.name,
+                getValue: (c) => c.id,
+                getCommand: (c) => c.id === 'yes' ? `prlt ticket link remove ${args.id} --all --force --json` : '',
+                jsonMode: jsonMode ? { flags, commandName: 'ticket link remove' } : null,
+            });
+            if (confirmed !== 'yes') {
+                this.log(styles.muted('\nCancelled.'));
+                return;
+            }
+            for (const dep of dependencies) {
+                await this.storage.deleteTicketDependency(args.id, dep.dependsOnTicketId, dep.dependencyType);
+            }
+            await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+            this.log(styles.success(`\n✅ Removed ${dependencies.length} dependencies from ${args.id}`));
+            return;
+        }
+        let targetId = args.target;
+        // If no target provided, prompt for selection
+        if (!targetId) {
+            const depChoices = await Promise.all(dependencies.map(async (dep) => {
+                const depTicket = await this.storage.getTicket(dep.dependsOnTicketId);
+                return {
+                    id: dep.dependsOnTicketId,
+                    name: `${dep.dependsOnTicketId} - ${depTicket?.title || 'Unknown'} (${dep.dependencyType})`,
+                    type: dep.dependencyType,
+                };
+            }));
+            const selected = await this.selectFromList({
+                message: 'Select dependency to remove:',
+                items: depChoices,
+                getName: (d) => d.name,
+                getValue: (d) => d.id,
+                getCommand: (d) => `prlt ticket link remove ${args.id} ${d.id} --type ${d.type} --json`,
+                jsonMode: jsonMode ? { flags, commandName: 'ticket link remove' } : null,
+            });
+            if (!selected) {
+                return;
+            }
+            targetId = selected;
+        }
+        // Find the dependency
+        const dep = dependencies.find(d => d.dependsOnTicketId === targetId);
+        if (!dep) {
+            this.error(`No dependency found from ${args.id} to ${targetId}`);
+        }
+        const dependencyType = flags.type;
+        await this.storage.deleteTicketDependency(args.id, targetId, dependencyType);
+        await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+        const depTicket = await this.storage.getTicket(targetId);
+        this.log(styles.success(`\n✅ Removed dependency: ${args.id} → ${targetId}`));
+        if (depTicket) {
+            this.log(styles.muted(`   ${ticket.title} no longer linked to ${depTicket.title}`));
+        }
+    }
+}

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

@@ -0,0 +1,24 @@
+import { Command } from '@oclif/core';
+export default class TicketList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        column: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        priority: 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>;
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'group-by': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private outputCrossProjectTable;
+    private outputCrossProjectTableByPriority;
+    private outputCrossProjectCompact;
+    private outputCrossProjectCompactByPriority;
+    private outputTable;
+    private outputTableByPriority;
+    private outputCompact;
+    private outputCompactByPriority;
+}