@proletariat/cli 0.2.0 → 0.3.0

package/dist/commands/ticket/epic.js

@@ -0,0 +1,333 @@
+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 TicketEpic extends PMOCommand {
+    static description = 'Assign ticket(s) to an epic (parent-child relationship)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> TKT-001 EPIC-001',
+        '<%= config.bin %> <%= command.id %> TKT-001 --unlink',
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --bulk --to-epic EPIC-001',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Ticket ID',
+            required: false,
+        }),
+        'epic-id': Args.string({
+            description: 'Epic ID to link to',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+        unlink: Flags.boolean({
+            char: 'u',
+            description: 'Remove epic link instead of adding',
+            default: false,
+        }),
+        bulk: Flags.boolean({
+            char: 'b',
+            description: 'Enable bulk mode to link multiple tickets to an epic',
+            default: false,
+        }),
+        'to-epic': Flags.string({
+            description: 'Target epic ID (for bulk mode)',
+        }),
+        'from-epic': Flags.string({
+            description: 'Filter tickets by current epic (bulk mode)',
+        }),
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Skip confirmation prompt (bulk mode)',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(TicketEpic);
+        const filterProjectId = flags.project;
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Bulk mode
+        if (flags.bulk) {
+            await this.executeBulk(flags);
+            return;
+        }
+        // Get all tickets
+        const allTickets = await this.storage.listTickets(filterProjectId);
+        if (allTickets.length === 0) {
+            if (jsonMode) {
+                outputErrorAsJson('NO_TICKETS', 'No tickets found.', createMetadata('ticket epic', flags));
+                return;
+            }
+            this.log(styles.muted('\nNo tickets found.'));
+            return;
+        }
+        // Get project for epics - use first ticket's project or prompt
+        const projectId = await this.requireProject();
+        // Get all epics
+        const epics = await this.storage.listEpics(projectId);
+        // Get epic_id for each ticket via direct DB query
+        const db = this.storage.db;
+        const getTicketEpicId = (ticketId) => {
+            const row = db.prepare(`SELECT epic_id FROM pmo_tickets WHERE id = ?`).get(ticketId);
+            return row?.epic_id || null;
+        };
+        let ticketId = args.id;
+        let epicId = args['epic-id'];
+        // If unlinking, we don't need an epic ID
+        if (flags.unlink) {
+            epicId = undefined;
+        }
+        // If no ticket ID provided, prompt for selection
+        if (!ticketId) {
+            const ticketChoices = allTickets.map((t) => {
+                const currentEpicId = getTicketEpicId(t.id);
+                const epicLabel = currentEpicId
+                    ? epics.find(e => e.id === currentEpicId)?.title || currentEpicId
+                    : 'No epic';
+                return {
+                    id: t.id,
+                    name: `${t.id} - ${t.title} (${t.statusName || t.status}) [${epicLabel}]`,
+                };
+            });
+            const selected = await this.selectFromList({
+                message: 'Select ticket to link:',
+                items: ticketChoices,
+                getName: (t) => t.name,
+                getValue: (t) => t.id,
+                getCommand: (t) => `prlt ticket epic ${t.id} --json`,
+                jsonMode: jsonMode ? { flags, commandName: 'ticket epic' } : null,
+            });
+            if (!selected) {
+                return;
+            }
+            ticketId = selected;
+        }
+        // Validate ticket exists
+        const ticket = allTickets.find((t) => t.id === ticketId);
+        if (!ticket) {
+            this.error(`Ticket not found: ${ticketId}`);
+        }
+        const currentEpicId = getTicketEpicId(ticketId);
+        // If unlinking, just remove the link
+        if (flags.unlink) {
+            if (!currentEpicId) {
+                this.log(styles.muted(`\nTicket ${ticketId} is not linked to any epic.`));
+                return;
+            }
+            const currentEpic = epics.find(e => e.id === currentEpicId);
+            // Update the ticket
+            db.prepare(`
+        UPDATE pmo_tickets
+        SET epic_id = NULL, updated_at = ?
+        WHERE id = ?
+      `).run(Date.now(), ticketId);
+            await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+            this.log(styles.success(`\n✅ Unlinked ${styles.emphasis(ticketId)} from ${currentEpic?.title || currentEpicId}`));
+            this.log(styles.muted(`   Title: ${ticket.title}`));
+            return;
+        }
+        // If no epic ID provided, prompt for selection
+        if (!epicId) {
+            const epicChoices = epics.map(e => ({
+                id: e.id,
+                name: `${e.id} ${e.title} (${e.status})${e.id === currentEpicId ? ' ← current' : ''}`,
+            }));
+            if (epicChoices.length === 0) {
+                this.log(styles.muted('\nNo epics found. Create one with: prlt epic create'));
+                return;
+            }
+            // Add "None" option if ticket has an epic
+            if (currentEpicId) {
+                epicChoices.push({ id: '__none__', name: 'None (remove epic link)' });
+            }
+            const selected = await this.selectFromList({
+                message: 'Link to which epic?',
+                items: epicChoices,
+                getName: (e) => e.name,
+                getValue: (e) => e.id,
+                getCommand: (e) => e.id === '__none__' ? `prlt ticket epic ${ticketId} --unlink --json` : `prlt ticket epic ${ticketId} ${e.id} --json`,
+                jsonMode: jsonMode ? { flags, commandName: 'ticket epic' } : null,
+            });
+            if (!selected) {
+                return;
+            }
+            if (selected === '__none__') {
+                // Unlink
+                db.prepare(`
+          UPDATE pmo_tickets
+          SET epic_id = NULL, updated_at = ?
+          WHERE id = ?
+        `).run(Date.now(), ticketId);
+                const currentEpic = epics.find(e => e.id === currentEpicId);
+                await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+                this.log(styles.success(`\n✅ Unlinked ${styles.emphasis(ticketId)} from ${currentEpic?.title || currentEpicId}`));
+                this.log(styles.muted(`   Title: ${ticket.title}`));
+                return;
+            }
+            epicId = selected;
+        }
+        // Validate epic exists
+        const epic = epics.find(e => e.id === epicId);
+        if (!epic) {
+            this.error(`Epic not found: ${epicId}`);
+        }
+        // Check if already linked to this epic
+        if (currentEpicId === epicId) {
+            this.log(styles.muted(`\nTicket ${ticketId} is already linked to ${epic.title}.`));
+            return;
+        }
+        // Update the ticket
+        db.prepare(`
+      UPDATE pmo_tickets
+      SET epic_id = ?, updated_at = ?
+      WHERE id = ?
+    `).run(epicId, Date.now(), ticketId);
+        await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+        this.log(styles.success(`\n✅ Linked ${styles.emphasis(ticketId)} to ${styles.emphasis(epicId)}`));
+        this.log(styles.muted(`   Title: ${ticket.title}`));
+        this.log(styles.muted(`   Epic: ${epic.title}`));
+    }
+    async executeBulk(flags) {
+        this.log(styles.emphasis('🔗 Link Tickets to Epic\n'));
+        // Get project first
+        const projectId = await this.requireProject();
+        // Get all tickets
+        const allTickets = await this.storage.listTickets(projectId);
+        if (allTickets.length === 0) {
+            this.log(styles.warning('No tickets found.'));
+            return;
+        }
+        // Get epics from database
+        const db = this.storage.db;
+        const epics = db.prepare(`
+      SELECT id, title, status FROM pmo_epics
+      WHERE project_id = ?
+      ORDER BY status, title
+    `).all(projectId);
+        // Filter tickets if --from-epic specified
+        let filteredTickets = allTickets;
+        if (flags['from-epic']) {
+            // Get tickets with matching epic_id via metadata or direct query
+            const epicTickets = db.prepare(`
+        SELECT id FROM pmo_tickets
+        WHERE project_id = ? AND epic_id = ?
+      `).all(projectId, flags['from-epic']);
+            const epicTicketIds = new Set(epicTickets.map(t => t.id));
+            filteredTickets = allTickets.filter(t => epicTicketIds.has(t.id));
+        }
+        if (filteredTickets.length === 0) {
+            this.log(styles.warning('No tickets found matching filter.'));
+            return;
+        }
+        // Get current epic for each ticket
+        const ticketEpics = new Map();
+        for (const ticket of filteredTickets) {
+            const row = db.prepare(`
+        SELECT epic_id FROM pmo_tickets WHERE id = ?
+      `).get(ticket.id);
+            ticketEpics.set(ticket.id, row?.epic_id || null);
+        }
+        // Select tickets to link
+        const { selectedTickets } = await inquirer.prompt([{
+                type: 'checkbox',
+                name: 'selectedTickets',
+                message: 'Select tickets to link:',
+                choices: filteredTickets.map(t => {
+                    const epicId = ticketEpics.get(t.id);
+                    const epicTitle = epicId ? epics.find(e => e.id === epicId)?.title || epicId : '(none)';
+                    return {
+                        name: `${t.id} - ${t.title}  [Epic: ${epicTitle}]`,
+                        value: t.id,
+                    };
+                }),
+            }]);
+        if (selectedTickets.length === 0) {
+            this.log(styles.muted('No tickets selected.'));
+            return;
+        }
+        // Select target epic
+        let targetEpic = flags['to-epic'];
+        if (targetEpic === undefined) {
+            const { epic } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'epic',
+                    message: 'Link to which epic?',
+                    choices: [
+                        { name: 'None (remove epic link)', value: null },
+                        ...epics.map(e => ({
+                            name: `${e.title} (${e.status})`,
+                            value: e.id,
+                        })),
+                    ],
+                }]);
+            targetEpic = epic;
+        }
+        // Confirmation
+        if (!flags.force) {
+            const epicLabel = targetEpic
+                ? epics.find(e => e.id === targetEpic)?.title || targetEpic
+                : 'None (removing link)';
+            this.log(styles.primary('\nWill link to epic:'));
+            this.log(styles.primary(`  → ${epicLabel}\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, link tickets', value: true }
+                    ],
+                    default: 0
+                }]);
+            if (!confirm) {
+                this.log(styles.muted('Operation cancelled.'));
+                return;
+            }
+        }
+        this.log('');
+        // Link each ticket
+        let successCount = 0;
+        let failCount = 0;
+        for (const ticketId of selectedTickets) {
+            try {
+                db.prepare(`
+          UPDATE pmo_tickets
+          SET epic_id = ?, updated_at = ?
+          WHERE id = ?
+        `).run(targetEpic, Date.now(), ticketId);
+                const action = targetEpic ? `Linked to ${targetEpic}` : 'Removed epic link';
+                this.log(styles.success(`${ticketId}: ${action}`));
+                successCount++;
+            }
+            catch (error) {
+                this.log(styles.error(`Failed to link ${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 = targetEpic ? 'Linked' : 'Unlinked';
+            this.log(styles.success(`${action} ${successCount} ticket(s)`));
+        }
+        if (failCount > 0) {
+            this.log(styles.error(`Failed to link ${failCount} ticket(s)`));
+        }
+    }
+}

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

@@ -0,0 +1,13 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class Ticket extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected getPMOOptions(): {
+        promptIfMultiple: boolean;
+    };
+    execute(): Promise<void>;
+}

package/dist/commands/ticket/index.js

@@ -0,0 +1,103 @@
+import { Flags } from '@oclif/core';
+import inquirer from 'inquirer';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson, outputPromptAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
+export default class Ticket extends PMOCommand {
+    static description = 'Interactive menu for ticket operations';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+    };
+    getPMOOptions() {
+        return { promptIfMultiple: false };
+    }
+    async execute() {
+        const { flags } = await this.parse(Ticket);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Define choices once, use for both JSON and interactive modes
+        // Each choice includes the full command for AI agents to execute
+        const menuChoices = [
+            { name: 'Create new ticket', value: 'create', command: 'prlt ticket create --json' },
+            { name: 'Create from template', value: 'template', command: 'prlt ticket template apply --json' },
+            { name: 'List all tickets', value: 'list', command: 'prlt ticket list --format json' },
+            { name: 'View ticket details', value: 'view', command: 'prlt ticket view --json' },
+            { name: 'Edit ticket', value: 'edit', command: 'prlt ticket edit --json' },
+            { name: 'Move ticket (column)', value: 'move', command: 'prlt ticket move --json' },
+            { name: 'Move to different project', value: 'project', command: 'prlt ticket project --json' },
+            { name: 'Assign to epic', value: 'epic', command: 'prlt ticket epic --json' },
+            { name: 'Assign to spec', value: 'spec', command: 'prlt ticket spec --json' },
+            { name: 'Manage dependencies', value: 'link', command: 'prlt ticket link --json' },
+            { name: 'Manage templates', value: 'templates', command: 'prlt ticket template --json' },
+            { name: 'Delete ticket', value: 'delete', command: 'prlt ticket delete --json' },
+            { name: 'Cancel', value: 'cancel' },
+        ];
+        const message = 'Ticket Operations - What would you like to do?';
+        // In JSON mode, output action selection prompt
+        if (jsonMode) {
+            outputPromptAsJson(buildPromptConfig('list', 'action', message, menuChoices), createMetadata('ticket', flags));
+            return;
+        }
+        // Show interactive menu
+        const { action } = await inquirer.prompt([{
+                type: 'list',
+                name: 'action',
+                message: '🎫 ' + message,
+                choices: [
+                    ...menuChoices.slice(0, 10),
+                    new inquirer.Separator('──────────────'),
+                    menuChoices[10],
+                    menuChoices[11],
+                    menuChoices[12],
+                ],
+            }]);
+        if (action === 'cancel') {
+            return;
+        }
+        // Run the selected subcommand
+        switch (action) {
+            case 'create':
+                await this.config.runCommand('ticket:create', []);
+                break;
+            case 'template':
+                await this.config.runCommand('ticket:template:apply', []);
+                break;
+            case 'list':
+                await this.config.runCommand('ticket:list', []);
+                break;
+            case 'view':
+                await this.config.runCommand('ticket:view', []);
+                break;
+            case 'edit':
+                await this.config.runCommand('ticket:edit', []);
+                break;
+            case 'move':
+                await this.config.runCommand('ticket:move', []);
+                break;
+            case 'project':
+                await this.config.runCommand('ticket:project', []);
+                break;
+            case 'epic':
+                await this.config.runCommand('ticket:epic', []);
+                break;
+            case 'spec':
+                await this.config.runCommand('ticket:spec', []);
+                break;
+            case 'link':
+                await this.config.runCommand('ticket:link', []);
+                break;
+            case 'templates':
+                await this.config.runCommand('ticket:template', []);
+                break;
+            case 'delete':
+                await this.config.runCommand('ticket:delete', []);
+                break;
+        }
+    }
+}

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

@@ -0,0 +1,14 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class TicketLinkBlock extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        blocker: 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/block.js

@@ -0,0 +1,94 @@
+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 TicketLinkBlock extends PMOCommand {
+    static description = 'Add a blocking dependency (ticket is blocked by another)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> TKT-001 TKT-002  # TKT-001 is blocked by TKT-002',
+        '<%= config.bin %> <%= command.id %> TKT-001         # Interactive selection',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Ticket ID that will be blocked',
+            required: true,
+        }),
+        blocker: Args.string({
+            description: 'Ticket ID that blocks this ticket',
+            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(TicketLinkBlock);
+        // 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 block', 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 blockerId = args.blocker;
+        // If no blocker provided, prompt for selection
+        if (!blockerId) {
+            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 create dependency with.', createMetadata('ticket link block', flags));
+                    return;
+                }
+                this.log(styles.muted('\nNo other tickets to create dependency with.'));
+                return;
+            }
+            const selected = await this.selectFromList({
+                message: `Select ticket that blocks ${args.id}:`,
+                items: otherTickets,
+                getName: (t) => `${t.id} - ${t.title} (${t.statusName || t.status})`,
+                getValue: (t) => t.id,
+                getCommand: (t) => `prlt ticket link block ${args.id} ${t.id} --json`,
+                jsonMode: jsonMode ? { flags, commandName: 'ticket link block' } : null,
+            });
+            if (!selected) {
+                return;
+            }
+            blockerId = selected;
+        }
+        const blockerTicket = await this.storage.getTicket(blockerId);
+        if (!blockerTicket) {
+            this.error(`Ticket not found: ${blockerId}`);
+        }
+        try {
+            await this.storage.createTicketDependency(args.id, blockerId, 'blocks');
+            await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+            this.log(styles.success(`\n✅ ${styles.emphasis(args.id)} is blocked by ${styles.emphasis(blockerId)}`));
+            this.log(styles.muted(`   ${ticket.title}`));
+            this.log(styles.muted(`   blocked by: ${blockerTicket.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/duplicates.d.ts

@@ -0,0 +1,14 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class TicketLinkDuplicates extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        original: 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/duplicates.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 TicketLinkDuplicates extends PMOCommand {
+    static description = 'Mark a ticket as duplicate of another';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> TKT-001 TKT-002  # TKT-001 duplicates TKT-002',
+        '<%= config.bin %> <%= command.id %> TKT-001         # Interactive selection',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Duplicate ticket ID',
+            required: true,
+        }),
+        original: Args.string({
+            description: 'Original 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(TicketLinkDuplicates);
+        // 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 duplicates', 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 originalId = args.original;
+        if (!originalId) {
+            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.', createMetadata('ticket link duplicates', flags));
+                    return;
+                }
+                this.log(styles.muted('\nNo other tickets.'));
+                return;
+            }
+            const selected = await this.selectFromList({
+                message: `Select the original ticket (${args.id} is a duplicate of):`,
+                items: otherTickets,
+                getName: (t) => `${t.id} - ${t.title} (${t.statusName || t.status})`,
+                getValue: (t) => t.id,
+                getCommand: (t) => `prlt ticket link duplicates ${args.id} ${t.id} --json`,
+                jsonMode: jsonMode ? { flags, commandName: 'ticket link duplicates' } : null,
+            });
+            if (!selected) {
+                return;
+            }
+            originalId = selected;
+        }
+        const originalTicket = await this.storage.getTicket(originalId);
+        if (!originalTicket) {
+            this.error(`Ticket not found: ${originalId}`);
+        }
+        try {
+            await this.storage.createTicketDependency(args.id, originalId, 'duplicates');
+            await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+            this.log(styles.success(`\n✅ ${styles.emphasis(args.id)} duplicates ${styles.emphasis(originalId)}`));
+            this.log(styles.muted(`   ${ticket.title}`));
+            this.log(styles.muted(`   duplicates: ${originalTicket.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;
+        }
+    }
+}