@proletariat/cli 0.3.19 → 0.3.21

package/dist/commands/status/create.js

@@ -88,40 +88,44 @@ export default class StatusCreate extends PMOCommand {
             default: flags.category || 'backlog',
             when: (ctx) => !ctx.flags.category || flags.interactive,
         });
-        // Add color prompt
-        resolver.addPrompt({
-            flagName: 'color',
-            type: 'input',
-            message: 'Color (hex, optional):',
-            default: flags.color,
-            validate: (value) => {
-                const v = value;
-                if (!v)
-                    return true;
-                return /^#[0-9A-Fa-f]{6}$/.test(v) || 'Invalid hex color (e.g., #FF0000)';
-            },
-            when: (ctx) => ctx.flags.color === undefined || flags.interactive,
-        });
-        // Add description prompt
-        resolver.addPrompt({
-            flagName: 'description',
-            type: 'input',
-            message: 'Description (optional):',
-            default: flags.description,
-            when: (ctx) => ctx.flags.description === undefined || flags.interactive,
-        });
-        // Add default prompt
-        resolver.addPrompt({
-            flagName: 'default',
-            type: 'list',
-            message: 'Set as default status for new tickets?',
-            choices: () => [
-                { name: 'No', value: false, command: 'prlt status create --json' },
-                { name: 'Yes', value: true, command: 'prlt status create --default --json' },
-            ],
-            default: flags.default || false,
-            when: (ctx) => ctx.flags.default === undefined || flags.interactive,
-        });
+        // Optional prompts - only shown in interactive mode
+        // In JSON/machine mode, optional fields should be passed as flags or omitted
+        if (flags.interactive) {
+            // Add color prompt
+            resolver.addPrompt({
+                flagName: 'color',
+                type: 'input',
+                message: 'Color (hex, optional):',
+                default: flags.color,
+                validate: (value) => {
+                    const v = value;
+                    if (!v)
+                        return true;
+                    return /^#[0-9A-Fa-f]{6}$/.test(v) || 'Invalid hex color (e.g., #FF0000)';
+                },
+                when: (ctx) => ctx.flags.color === undefined,
+            });
+            // Add description prompt
+            resolver.addPrompt({
+                flagName: 'description',
+                type: 'input',
+                message: 'Description (optional):',
+                default: flags.description,
+                when: (ctx) => ctx.flags.description === undefined,
+            });
+            // Add default prompt
+            resolver.addPrompt({
+                flagName: 'default',
+                type: 'list',
+                message: 'Set as default status for new tickets?',
+                choices: () => [
+                    { name: 'No', value: false, command: 'prlt status create --json' },
+                    { name: 'Yes', value: true, command: 'prlt status create --default --json' },
+                ],
+                default: flags.default || false,
+                when: (ctx) => ctx.flags.default === undefined,
+            });
+        }
         // Resolve all flags
         const resolved = await resolver.resolve();
         const status = await this.storage.createStatus(projectId, {

package/dist/commands/status/list.js

@@ -35,7 +35,11 @@ export default class StatusList extends PMOCommand {
         if (!project?.workflowId) {
             this.error(`Project "${projectId}" has no workflow assigned.`);
         }
-        const statuses = await this.storage.listStatuses(project.workflowId);
+        const allStatuses = await this.storage.listStatuses(project.workflowId);
+        // Apply category filter if specified
+        const statuses = flags.category
+            ? allStatuses.filter(s => s.category === flags.category)
+            : allStatuses;
         if (jsonMode) {
             this.log(JSON.stringify(statuses, null, 2));
             return;
@@ -59,8 +63,6 @@ export default class StatusList extends PMOCommand {
             canceled: '🚫',
         };
         for (const category of STATE_CATEGORY_ORDER) {
-            if (flags.category && flags.category !== category)
-                continue;
             const categoryStatuses = grouped.get(category);
             if (!categoryStatuses || categoryStatuses.length === 0)
                 continue;

package/dist/commands/template/phase/create.d.ts

@@ -7,6 +7,7 @@ export default class TemplatePhaseCreate extends Command {
     };
     static flags: {
         description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;

package/dist/commands/template/phase/create.js

@@ -4,6 +4,7 @@ export default class TemplatePhaseCreate extends Command {
     static examples = [
         '<%= config.bin %> <%= command.id %> "My Phases"',
         '<%= config.bin %> <%= command.id %> "Sprint Phases" --description "Agile sprint phases"',
+        '<%= config.bin %> <%= command.id %> "My Phases" --description "Custom phases" --json',
     ];
     static args = {
         name: Args.string({
@@ -16,9 +17,15 @@ export default class TemplatePhaseCreate extends Command {
             char: 'd',
             description: 'Template description',
         }),
+        machine: Flags.boolean({
+            char: 'm',
+            description: 'Output as JSON for AI agents/scripts (machine-readable mode)',
+            default: false,
+        }),
         json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            description: 'Output as JSON (deprecated, use --machine)',
             default: false,
+            hidden: true,
         }),
     };
     async run() {
@@ -28,6 +35,8 @@ export default class TemplatePhaseCreate extends Command {
             cmdArgs.push(args.name);
         if (flags.description)
             cmdArgs.push('--description', flags.description);
+        if (flags.machine)
+            cmdArgs.push('--machine');
         if (flags.json)
             cmdArgs.push('--json');
         await this.config.runCommand('phase:template:create', cmdArgs);

package/dist/commands/template/phase/index.js

@@ -30,10 +30,10 @@ export default class TemplatePhase extends Command {
             message: 'What would you like to do?',
             choices: () => [
                 { name: 'List phase templates', value: 'list', command: 'prlt template phase list --json' },
-                { name: 'Apply a phase template to project', value: 'apply', command: 'prlt phase template apply --json' },
-                { name: 'Create a new phase template', value: 'create', command: 'prlt phase template create --json' },
-                { name: 'Update a phase template', value: 'update', command: 'prlt phase template update --json' },
-                { name: 'Delete a phase template', value: 'delete', command: 'prlt phase template delete --json' },
+                { name: 'Apply a phase template to project', value: 'apply', command: 'prlt template phase apply --json' },
+                { name: 'Create a new phase template', value: 'create', command: 'prlt template phase create --json' },
+                { name: 'Update a phase template', value: 'update', command: 'prlt template phase update --json' },
+                { name: 'Delete a phase template', value: 'delete', command: 'prlt template phase delete --json' },
             ],
         });
         // In JSON mode, this outputs the prompt and exits

package/dist/commands/template/ticket/create.d.ts

@@ -0,0 +1,20 @@
+import { Command } from '@oclif/core';
+export default class TemplateTicketCreate extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'title-pattern': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'description-template': 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>;
+        subtask: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        ac: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        label: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/template/ticket/create.js

@@ -0,0 +1,87 @@
+import { Args, Command, Flags } from '@oclif/core';
+export default class TemplateTicketCreate extends Command {
+    static description = 'Create a new ticket template from scratch';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> "Bug Report"',
+        '<%= config.bin %> <%= command.id %> "Feature Request" -d "Template for new features"',
+        '<%= config.bin %> <%= command.id %> "Task" --title-pattern "[TASK] " --priority P2',
+        '<%= config.bin %> <%= command.id %> "Onboarding" --subtask "Setup environment" --subtask "Read docs" --ac "Complete all subtasks"',
+    ];
+    static args = {
+        name: Args.string({
+            description: 'Template name',
+            required: false,
+        }),
+    };
+    static flags = {
+        description: Flags.string({
+            char: 'd',
+            description: 'Template description',
+        }),
+        'title-pattern': Flags.string({
+            description: 'Default title prefix/pattern (e.g., "[BUG] ")',
+        }),
+        'description-template': Flags.string({
+            description: 'Default description template (markdown)',
+        }),
+        priority: Flags.string({
+            char: 'p',
+            description: 'Default priority (P0, P1, P2, P3)',
+        }),
+        category: Flags.string({
+            char: 'c',
+            description: 'Default category (bug, feature, etc.)',
+        }),
+        subtask: Flags.string({
+            description: 'Add a suggested subtask (can be used multiple times)',
+            multiple: true,
+        }),
+        ac: Flags.string({
+            description: 'Add an acceptance criterion pattern (can be used multiple times)',
+            multiple: true,
+        }),
+        label: Flags.string({
+            char: 'l',
+            description: 'Add a default label (can be used multiple times)',
+            multiple: true,
+        }),
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TemplateTicketCreate);
+        const cmdArgs = [];
+        if (args.name)
+            cmdArgs.push(args.name);
+        if (flags.description)
+            cmdArgs.push('--description', flags.description);
+        if (flags['title-pattern'])
+            cmdArgs.push('--title-pattern', flags['title-pattern']);
+        if (flags['description-template'])
+            cmdArgs.push('--description-template', flags['description-template']);
+        if (flags.priority)
+            cmdArgs.push('--priority', flags.priority);
+        if (flags.category)
+            cmdArgs.push('--category', flags.category);
+        if (flags.subtask) {
+            for (const subtask of flags.subtask) {
+                cmdArgs.push('--subtask', subtask);
+            }
+        }
+        if (flags.ac) {
+            for (const ac of flags.ac) {
+                cmdArgs.push('--ac', ac);
+            }
+        }
+        if (flags.label) {
+            for (const label of flags.label) {
+                cmdArgs.push('--label', label);
+            }
+        }
+        if (flags.json)
+            cmdArgs.push('--json');
+        await this.config.runCommand('ticket:template:create', cmdArgs);
+    }
+}

package/dist/commands/template/ticket/delete.d.ts

@@ -3,7 +3,7 @@ export default class TemplateTicketDelete extends Command {
     static description: string;
     static examples: string[];
     static args: {
-        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/commands/template/ticket/delete.js

@@ -8,7 +8,7 @@ export default class TemplateTicketDelete extends Command {
     static args = {
         id: Args.string({
             description: 'Template ID to delete',
-            required: true,
+            required: false,
         }),
     };
     static flags = {
@@ -24,7 +24,9 @@ export default class TemplateTicketDelete extends Command {
     };
     async run() {
         const { args, flags } = await this.parse(TemplateTicketDelete);
-        const cmdArgs = [args.id];
+        const cmdArgs = [];
+        if (args.id)
+            cmdArgs.push(args.id);
         if (flags.force)
             cmdArgs.push('--force');
         if (flags.json)

package/dist/commands/template/ticket/save.d.ts

@@ -7,8 +7,10 @@ export default class TemplateTicketSave extends Command {
         name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
+        'template-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/template/ticket/save.js

@@ -1,9 +1,11 @@
 import { Args, Command, Flags } from '@oclif/core';
+import { machineOutputFlags } from '../../../lib/pmo/base-command.js';
 export default class TemplateTicketSave extends Command {
     static description = 'Create a template from an existing ticket';
     static examples = [
         '<%= config.bin %> <%= command.id %> TKT-001 "Bug Report Template"',
         '<%= config.bin %> <%= command.id %> TKT-042 "Feature Request" --description "Standard feature request template"',
+        '<%= config.bin %> <%= command.id %> TKT-001 --template-name "My Template" --json',
     ];
     static args = {
         ticket: Args.string({
@@ -16,6 +18,11 @@ export default class TemplateTicketSave extends Command {
         }),
     };
     static flags = {
+        ...machineOutputFlags,
+        'template-name': Flags.string({
+            char: 'n',
+            description: 'Template name (alternative to positional arg, required in non-TTY/JSON mode)',
+        }),
         description: Flags.string({
             char: 'd',
             description: 'Template description',
@@ -32,10 +39,14 @@ export default class TemplateTicketSave extends Command {
             cmdArgs.push(args.ticket);
         if (args.name)
             cmdArgs.push(args.name);
+        if (flags['template-name'])
+            cmdArgs.push('--template-name', flags['template-name']);
         if (flags.description)
             cmdArgs.push('--description', flags.description);
         if (flags.json)
             cmdArgs.push('--json');
+        if (flags.machine)
+            cmdArgs.push('--machine');
         await this.config.runCommand('ticket:template:save', cmdArgs);
     }
 }

package/dist/commands/ticket/create.js

@@ -11,7 +11,7 @@ export default class TicketCreate extends PMOCommand {
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --title "Fix login bug" --column Backlog',
-        '<%= config.bin %> <%= command.id %> -t "Add feature" -c "In Progress" -p HIGH',
+        '<%= config.bin %> <%= command.id %> -t "Add feature" -c "In Progress" -p P1',
         '<%= config.bin %> <%= command.id %> --project mobile-app -t "New feature"',
         '<%= config.bin %> <%= command.id %> --epic EPIC-001 -t "Implement auth flow"',
         '<%= config.bin %> <%= command.id %> --json  # Output column choices as JSON',
@@ -110,6 +110,13 @@ export default class TicketCreate extends PMOCommand {
         // Use FlagResolver to handle both JSON mode and interactive prompts
         // This unifies the two code paths into one pattern
         if (!flags.interactive) {
+            // In JSON mode, default column to first backlog status if not provided
+            // This prevents prompting for column in non-interactive mode
+            if (jsonMode && !flags.column) {
+                // Prefer "Backlog" column, fall back to first column
+                const backlogColumn = columns.find(c => c.toLowerCase() === 'backlog') || columns[0];
+                flags.column = backlogColumn;
+            }
             const resolver = new FlagResolver({
                 commandName: 'ticket create',
                 baseCommand: 'prlt ticket create',

package/dist/commands/ticket/edit.js

@@ -9,7 +9,7 @@ export default class TicketEdit extends PMOCommand {
     static examples = [
         '<%= config.bin %> <%= command.id %> TICK-001',
         '<%= config.bin %> <%= command.id %> TICK-001 --title "New title"',
-        '<%= config.bin %> <%= command.id %> TICK-001 --priority HIGH --category bug',
+        '<%= config.bin %> <%= command.id %> TICK-001 --priority P1 --category bug',
         '<%= config.bin %> <%= command.id %> TICK-001 --add-subtask "Implement feature" --add-subtask "Write tests"',
         '<%= config.bin %> <%= command.id %> TICK-001 --owner "john" --assignee "agent-1"',
         '<%= config.bin %> <%= command.id %>  # Interactive mode',

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

@@ -10,6 +10,8 @@ export default class TicketList extends Command {
         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>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        offset: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/ticket/list.js

@@ -10,13 +10,15 @@ export default class TicketList extends Command {
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --column Backlog',
-        '<%= config.bin %> <%= command.id %> --priority URGENT',
+        '<%= config.bin %> <%= command.id %> --priority P0',
         '<%= config.bin %> <%= command.id %> --category bug',
         '<%= config.bin %> <%= command.id %> --search "login"',
         '<%= config.bin %> <%= command.id %> --project mobile-app',
         '<%= config.bin %> <%= command.id %> --all',
         '<%= config.bin %> <%= command.id %> --all --group-by priority',
         '<%= config.bin %> <%= command.id %> -g priority',
+        '<%= config.bin %> <%= command.id %> --limit 10',
+        '<%= config.bin %> <%= command.id %> --limit 10 --offset 20',
     ];
     static flags = {
         ...pmoBaseFlags,
@@ -53,6 +55,15 @@ export default class TicketList extends Command {
             options: ['status', 'priority'],
             default: 'status',
         }),
+        limit: Flags.integer({
+            char: 'l',
+            description: 'Maximum number of tickets to display',
+            min: 1,
+        }),
+        offset: Flags.integer({
+            description: 'Skip first N tickets (for pagination)',
+            min: 0,
+        }),
     };
     async run() {
         const { flags } = await this.parse(TicketList);
@@ -85,7 +96,33 @@ export default class TicketList extends Command {
             }
             // Determine projectId for the query
             const projectId = flags.all ? undefined : (filter.projectId || undefined);
-            const tickets = await pmoContext.storage.listTickets(projectId, filter);
+            // Validate project if specified (not in --all mode)
+            if (flags.project && !flags.all) {
+                const project = await pmoContext.storage.getProject(flags.project);
+                if (!project) {
+                    const allProjects = await pmoContext.storage.listProjectSummaries();
+                    const validProjectIds = allProjects.map(p => p.id);
+                    this.error(`Project "${flags.project}" not found. Valid projects: ${validProjectIds.join(', ')}`);
+                }
+            }
+            // Validate column if specified (requires knowing the project)
+            if (flags.column && !flags.all) {
+                // Get the project board to validate the column
+                const targetProjectId = projectId || (await pmoContext.storage.listProjectSummaries())[0]?.id;
+                if (targetProjectId) {
+                    const board = await pmoContext.storage.getBoard(targetProjectId);
+                    const validColumns = board.columns.map(c => c.name);
+                    if (!validColumns.includes(flags.column)) {
+                        this.error(`Column "${flags.column}" not found. Valid columns: ${validColumns.join(', ')}`);
+                    }
+                }
+            }
+            let tickets = await pmoContext.storage.listTickets(projectId, filter);
+            // Apply pagination
+            if (flags.offset)
+                tickets = tickets.slice(flags.offset);
+            if (flags.limit)
+                tickets = tickets.slice(0, flags.limit);
             if (tickets.length === 0) {
                 this.log(styles.warning('No tickets found.'));
                 return;

package/dist/commands/ticket/template/create.d.ts

@@ -8,14 +8,22 @@ export default class TicketTemplateCreate extends PMOCommand {
     static flags: {
         description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'title-pattern': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'description-template': 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>;
-        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        subtask: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        ac: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        label: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: 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>;
+    /**
+     * Check if any non-default flags were provided (indicating non-interactive intent)
+     */
+    private hasNonDefaultFlags;
 }