@proletariat/cli 0.2.0 → 0.3.1

package/dist/commands/epic/list.js

@@ -0,0 +1,87 @@
+import { Flags } from '@oclif/core';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { styles } from '../../lib/styles.js';
+// Progress bar helper
+function progressBar(percent, width = 20) {
+    const filled = Math.round((percent / 100) * width);
+    const empty = width - filled;
+    return '█'.repeat(filled) + '░'.repeat(empty);
+}
+export default class EpicList extends PMOCommand {
+    static description = 'List all epics';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --status active',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+        status: Flags.string({
+            char: 's',
+            description: 'Filter by status',
+            options: ['active', 'draft', 'complete', 'dropped', 'future'],
+        }),
+    };
+    async execute() {
+        const { flags } = await this.parse(EpicList);
+        const projectId = await this.requireProject();
+        const epics = await this.storage.listEpics(projectId, flags.status ? { status: flags.status } : undefined);
+        if (epics.length === 0) {
+            this.log(styles.muted('\nNo epics found.'));
+            this.log(styles.muted('Create one with: prlt epic create'));
+            return;
+        }
+        // Group epics by status
+        const grouped = this.groupByStatus(epics);
+        // Get ticket counts for each epic
+        const epicProgress = new Map();
+        for (const epic of epics) {
+            const tickets = await this.storage.getTicketsForEpic(projectId, epic.id);
+            const done = tickets.filter((t) => t.status === 'done').length;
+            epicProgress.set(epic.id, { done, total: tickets.length });
+        }
+        const projectName = await this.getProjectName(projectId);
+        this.log(`\n🎯 ${styles.emphasis('Epics')} - ${projectName}`);
+        this.log('═'.repeat(55));
+        const statusOrder = ['active', 'draft', 'complete', 'dropped', 'future'];
+        const statusEmoji = {
+            active: '🟢',
+            draft: '🟡',
+            complete: '✅',
+            dropped: '❌',
+            future: '🔮',
+        };
+        for (const status of statusOrder) {
+            const statusEpics = grouped.get(status);
+            if (!statusEpics || statusEpics.length === 0)
+                continue;
+            this.log(`\n${statusEmoji[status]} ${status.toUpperCase()} (${statusEpics.length})`);
+            for (const epic of statusEpics) {
+                const progress = epicProgress.get(epic.id) || { done: 0, total: 0 };
+                const percent = progress.total > 0 ? Math.round((progress.done / progress.total) * 100) : 0;
+                const bar = progressBar(percent);
+                const readyToArchive = percent === 100 && status === 'active' ? ' ← ready to archive!' : '';
+                // Show rank (position + 1) for active epics
+                const rank = status === 'active' ? `#${epic.position + 1} ` : '   ';
+                this.log(`  ${rank}${epic.id.padEnd(10)} ${epic.title.substring(0, 27).padEnd(27)} ${bar} ${String(percent).padStart(3)}% (${progress.done}/${progress.total})${readyToArchive}`);
+            }
+        }
+        this.log('\n' + '═'.repeat(55));
+        const counts = statusOrder
+            .map(s => `${grouped.get(s)?.length || 0} ${s}`)
+            .filter(s => !s.startsWith('0'))
+            .join(', ');
+        this.log(`Total: ${epics.length} epics (${counts})`);
+        this.log(styles.muted('\nCommands:'));
+        this.log(styles.muted('  prlt epic progress <id>    View detailed progress'));
+        this.log(styles.muted('  prlt epic archive <id>     Archive completed epic'));
+    }
+    groupByStatus(epics) {
+        const grouped = new Map();
+        for (const epic of epics) {
+            const list = grouped.get(epic.status) || [];
+            list.push(epic);
+            grouped.set(epic.status, list);
+        }
+        return grouped;
+    }
+}

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

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

package/dist/commands/epic/move.js

@@ -0,0 +1,184 @@
+import { Args, Flags } from '@oclif/core';
+import inquirer from 'inquirer';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { styles } from '../../lib/styles.js';
+import { moveEpicFile, getRelativeEpicPath } from '../../lib/pmo/epic-files.js';
+import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
+const STATUS_CHOICES = [
+    { name: 'active (currently working on)', value: 'active' },
+    { name: 'draft (planning phase)', value: 'draft' },
+    { name: 'complete (all work done)', value: 'complete' },
+    { name: 'dropped (cancelled/won\'t do)', value: 'dropped' },
+    { name: 'future (backlog for later)', value: 'future' },
+];
+export default class EpicMove extends PMOCommand {
+    static description = 'Move epic between status folders';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> EPIC-002 complete',
+        '<%= config.bin %> <%= command.id %> --force',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Epic ID',
+            required: false,
+        }),
+        status: Args.string({
+            description: 'Target status',
+            required: false,
+            options: ['active', 'draft', 'complete', 'dropped', 'future'],
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Skip validation checks',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(EpicMove);
+        const projectId = await this.requireProject();
+        // 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('epic move', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        };
+        let epicId = args.id;
+        let targetStatus = args.status;
+        // If no ID provided, prompt for selection
+        if (!epicId) {
+            const epics = await this.storage.listEpics(projectId);
+            if (epics.length === 0) {
+                if (jsonMode) {
+                    outputErrorAsJson('NO_EPICS', 'No epics found.', createMetadata('epic move', flags));
+                    return;
+                }
+                this.log(styles.muted('\nNo epics found.'));
+                return;
+            }
+            // Get ticket counts
+            const choices = await Promise.all(epics.map(async (e) => {
+                const tickets = await this.storage.getTicketsForEpic(projectId, e.id);
+                const done = tickets.filter((t) => t.status === 'done').length;
+                return {
+                    name: `${e.id} ${e.title} (${e.status}) [${done}/${tickets.length} complete]`,
+                    value: e.id,
+                };
+            }));
+            // In JSON mode, output epic selection prompt
+            if (jsonMode) {
+                outputPromptAsJson(buildPromptConfig('list', 'id', 'Select epic to move:', choices), createMetadata('epic move', flags));
+                return;
+            }
+            const { selected } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'selected',
+                    message: 'Select epic to move:',
+                    choices,
+                }]);
+            epicId = selected;
+        }
+        const epic = await this.storage.getEpic(epicId);
+        if (!epic) {
+            return handleError('EPIC_NOT_FOUND', `Epic not found: ${epicId}`);
+        }
+        // If no status provided, prompt for selection
+        if (!targetStatus) {
+            const statusChoices = STATUS_CHOICES.filter(c => c.value !== epic.status);
+            // In JSON mode, output status selection prompt
+            if (jsonMode) {
+                outputPromptAsJson(buildPromptConfig('list', 'status', 'Move to which status?', statusChoices), createMetadata('epic move', flags));
+                return;
+            }
+            const { selected } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'selected',
+                    message: 'Move to which status?',
+                    choices: statusChoices,
+                }]);
+            targetStatus = selected;
+        }
+        if (targetStatus === epic.status) {
+            this.log(styles.muted(`Epic ${epicId} is already in ${targetStatus} status.`));
+            return;
+        }
+        // Validation checks
+        const tickets = await this.storage.getTicketsForEpic(projectId, epicId);
+        const doneTickets = tickets.filter((t) => t.status === 'done').length;
+        const allComplete = doneTickets === tickets.length;
+        // Moving to complete - check ticket completion
+        if (targetStatus === 'complete' && !allComplete && !flags.force) {
+            // In JSON mode, output confirmation prompt
+            if (jsonMode) {
+                const confirmChoices = [
+                    { name: 'No', value: 'false' },
+                    { name: 'Yes', value: 'true' },
+                ];
+                outputPromptAsJson(buildPromptConfig('list', 'confirm', `Not all tickets are complete (${doneTickets}/${tickets.length} done). Continue moving to complete anyway?`, confirmChoices), createMetadata('epic move', flags));
+                return;
+            }
+            this.log(styles.warning(`\n⚠️  Not all tickets are complete (${doneTickets}/${tickets.length} done)`));
+            const { confirm } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'confirm',
+                    message: 'Continue moving to complete anyway?',
+                    choices: [
+                        { name: 'No', value: false },
+                        { name: 'Yes', value: true },
+                    ],
+                    default: false,
+                }]);
+            if (!confirm) {
+                this.log(styles.muted('Cancelled.'));
+                return;
+            }
+        }
+        // Moving to dropped - confirm cancellation
+        if (targetStatus === 'dropped' && !flags.force) {
+            // In JSON mode, output confirmation prompt
+            if (jsonMode) {
+                const confirmChoices = [
+                    { name: 'No', value: 'false' },
+                    { name: 'Yes', value: 'true' },
+                ];
+                outputPromptAsJson(buildPromptConfig('list', 'confirmDrop', 'This will mark the epic as dropped/cancelled. Continue?', confirmChoices), createMetadata('epic move', flags));
+                return;
+            }
+            this.log(styles.warning('\n⚠️  This will mark the epic as dropped/cancelled'));
+            const { confirm } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'confirm',
+                    message: 'Continue?',
+                    choices: [
+                        { name: 'No', value: false },
+                        { name: 'Yes', value: true },
+                    ],
+                    default: false,
+                }]);
+            if (!confirm) {
+                this.log(styles.muted('Cancelled.'));
+                return;
+            }
+        }
+        this.log(`\nMoving: ${epicId} "${epic.title}"`);
+        this.log(`From: ${epic.status} → ${targetStatus}`);
+        // Move the epic file to new status directory
+        const moveResult = moveEpicFile(this.pmoPath, epicId, epic.status, targetStatus, projectId);
+        await this.storage.updateEpic(epicId, { status: targetStatus });
+        this.log(styles.success(`\n✅ Moved epic ${styles.emphasis(epicId)} "${epic.title}" to ${targetStatus}`));
+        if (moveResult) {
+            const relativePath = getRelativeEpicPath(this.pmoPath, epicId, targetStatus, projectId);
+            this.log(styles.muted(`   File: ${relativePath}`));
+        }
+    }
+}

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

@@ -0,0 +1,16 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class EpicProgress 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>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+    private showSingleProgress;
+    private showAllProgress;
+}

package/dist/commands/epic/progress.js

@@ -0,0 +1,166 @@
+import { Args, Flags } from '@oclif/core';
+import inquirer from 'inquirer';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { styles } from '../../lib/styles.js';
+import { getRelativeEpicPath } from '../../lib/pmo/epic-files.js';
+import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
+// Progress bar helper
+function progressBar(percent, width = 20) {
+    const filled = Math.round((percent / 100) * width);
+    const empty = width - filled;
+    return '█'.repeat(filled) + '░'.repeat(empty);
+}
+export default class EpicProgress extends PMOCommand {
+    static description = 'Show epic completion progress';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> EPIC-001',
+        '<%= config.bin %> <%= command.id %> --all',
+    ];
+    static args = {
+        id: Args.string({
+            description: 'Epic ID',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+        all: Flags.boolean({
+            char: 'a',
+            description: 'Show progress for all epics',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(EpicProgress);
+        const projectId = await this.requireProject();
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        if (flags.all) {
+            await this.showAllProgress(projectId);
+        }
+        else {
+            let epicId = args.id;
+            // If no ID provided, prompt for selection
+            if (!epicId) {
+                const epics = await this.storage.listEpics(projectId);
+                if (epics.length === 0) {
+                    if (jsonMode) {
+                        outputErrorAsJson('NO_EPICS', 'No epics found.', createMetadata('epic progress', flags));
+                        return;
+                    }
+                    this.log(styles.muted('\nNo epics found.'));
+                    return;
+                }
+                // In JSON mode, output epic selection prompt
+                if (jsonMode) {
+                    const epicChoices = epics.map(e => ({ name: `${e.id} ${e.title} (${e.status})`, value: e.id }));
+                    outputPromptAsJson(buildPromptConfig('list', 'id', 'Select epic to view progress:', epicChoices), createMetadata('epic progress', flags));
+                    return;
+                }
+                const { selected } = await inquirer.prompt([{
+                        type: 'list',
+                        name: 'selected',
+                        message: 'Select epic to view progress:',
+                        choices: epics.map(e => ({
+                            name: `${e.id} ${e.title} (${e.status})`,
+                            value: e.id,
+                        })),
+                    }]);
+                epicId = selected;
+            }
+            await this.showSingleProgress(projectId, epicId);
+        }
+    }
+    async showSingleProgress(projectId, epicId) {
+        const epic = await this.storage.getEpic(epicId);
+        if (!epic) {
+            this.error(`Epic not found: ${epicId}`);
+        }
+        const tickets = await this.storage.getTicketsForEpic(projectId, epicId);
+        const doneTickets = tickets.filter((t) => t.status === 'done').length;
+        const percent = tickets.length > 0 ? Math.round((doneTickets / tickets.length) * 100) : 0;
+        const relativePath = getRelativeEpicPath(this.pmoPath, epic.id, epic.status, projectId);
+        this.log(`\n🎯 Epic Progress: ${styles.emphasis(epic.id)} - ${epic.title}`);
+        this.log('═'.repeat(55));
+        this.log(`\nStatus: ${epic.status}`);
+        this.log(`File: ${relativePath}`);
+        this.log(`Tickets: ${doneTickets}/${tickets.length} complete (${percent}%)`);
+        this.log(`\n${progressBar(percent)} ${percent}%`);
+        // Group tickets by status/column
+        const byStatus = new Map();
+        for (const ticket of tickets) {
+            const key = ticket.statusName || 'Unknown';
+            const list = byStatus.get(key) || [];
+            list.push(ticket);
+            byStatus.set(key, list);
+        }
+        if (byStatus.size > 0) {
+            this.log('\nBreakdown by column:');
+            const statusEmoji = {
+                done: '✅',
+                'in_progress': '🚧',
+                blocked: '🔴',
+                ready: '📋',
+                backlog: '📥',
+            };
+            for (const [status, statusTickets] of byStatus) {
+                const emoji = statusEmoji[status.toLowerCase()] || '📋';
+                this.log(`  ${emoji} ${status}: ${statusTickets.length} ticket${statusTickets.length === 1 ? '' : 's'}`);
+            }
+        }
+        // Show remaining work
+        const remaining = tickets.filter((t) => t.status !== 'done');
+        if (remaining.length > 0) {
+            this.log('\nRemaining work:');
+            for (const ticket of remaining) {
+                const statusLabel = ticket.statusName || ticket.status;
+                this.log(`  ${ticket.id}: ${ticket.title} [${statusLabel}]`);
+            }
+        }
+    }
+    async showAllProgress(projectId) {
+        const epics = await this.storage.listEpics(projectId);
+        if (epics.length === 0) {
+            this.log(styles.muted('\nNo epics found.'));
+            return;
+        }
+        this.log('\n📊 Epic Progress - All Epics');
+        this.log('═'.repeat(55));
+        // Group by status
+        const grouped = new Map();
+        for (const epic of epics) {
+            const list = grouped.get(epic.status) || [];
+            list.push(epic);
+            grouped.set(epic.status, list);
+        }
+        const statusOrder = ['active', 'draft', 'complete', 'dropped', 'future'];
+        const statusEmoji = {
+            active: '🟢',
+            draft: '🟡',
+            complete: '✅',
+            dropped: '❌',
+            future: '🔮',
+        };
+        for (const status of statusOrder) {
+            const statusEpics = grouped.get(status);
+            if (!statusEpics || statusEpics.length === 0)
+                continue;
+            this.log(`\n${statusEmoji[status]} ${status.toUpperCase()} (${statusEpics.length})`);
+            for (const epic of statusEpics) {
+                const tickets = await this.storage.getTicketsForEpic(projectId, epic.id);
+                const doneTickets = tickets.filter((t) => t.status === 'done').length;
+                const percent = tickets.length > 0 ? Math.round((doneTickets / tickets.length) * 100) : 0;
+                const bar = progressBar(percent);
+                const readyToArchive = percent === 100 && status === 'active' ? ' ← ready to archive' : '';
+                this.log(`  ${epic.id.padEnd(10)} ${epic.title.substring(0, 30).padEnd(30)} ${bar} ${String(percent).padStart(3)}% (${doneTickets}/${tickets.length})${readyToArchive}`);
+            }
+        }
+        this.log(styles.muted('\nCommands:'));
+        this.log(styles.muted('  prlt epic progress <id>    View detailed progress'));
+        this.log(styles.muted('  prlt epic archive <id>     Archive completed epic'));
+    }
+}

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

@@ -0,0 +1,15 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class EpicProject extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        epicId: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        targetProject: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'with-tickets': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+}