@proletariat/cli 0.3.17 → 0.3.19

package/dist/commands/phase/create.js

@@ -1,9 +1,9 @@
 import { Flags, Args } from '@oclif/core';
-import inquirer from 'inquirer';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
 import { STATE_CATEGORY_ORDER } from '../../lib/pmo/types.js';
-import { shouldOutputJson, outputPromptAsJson, createMetadata, buildFormPromptConfig, } from '../../lib/prompt-json.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
+import { FlagResolver } from '../../lib/flags/index.js';
 export default class PhaseCreate extends PMOCommand {
     static description = 'Create a new project lifecycle phase';
     static examples = [
@@ -40,84 +40,126 @@ export default class PhaseCreate extends PMOCommand {
             description: 'Interactive mode',
             default: false,
         }),
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
     }
     async execute() {
         const { args, flags } = await this.parse(PhaseCreate);
-        {
-            let phaseData;
-            // Auto-enter interactive mode if any required value is missing
-            if (flags.interactive || !args.name || !flags.category) {
-                // Check if JSON output mode is active
-                const jsonMode = shouldOutputJson(flags);
-                // In JSON mode, output form prompt
-                // Define labels once - single source of truth
-                const categoryLabels = {
-                    triage: 'Triage - Inbox, needs review',
-                    backlog: 'Backlog - Not yet scheduled for work',
-                    unstarted: 'Unstarted - Scheduled but work hasn\'t begun',
-                    started: 'Started - Work is actively in progress',
-                    completed: 'Completed - Work finished successfully',
-                    canceled: 'Canceled - Work won\'t be done',
-                };
-                const categoryChoices = STATE_CATEGORY_ORDER.map(cat => ({ name: categoryLabels[cat], value: cat }));
-                // Define fields once - single source of truth for both JSON and interactive modes
-                const fields = [
-                    { type: 'input', name: 'name', message: 'Phase name:', default: args.name },
-                    { type: 'list', name: 'category', message: 'Category:', choices: categoryChoices, default: flags.category },
-                    { type: 'input', name: 'color', message: 'Color (hex, optional):', default: flags.color },
-                    { type: 'input', name: 'description', message: 'Description (optional):', default: flags.description },
-                    { type: 'confirm', name: 'isDefault', message: 'Set as default for new projects?', default: flags.default || false },
-                ];
-                if (jsonMode) {
-                    outputPromptAsJson(buildFormPromptConfig(fields), createMetadata('phase create', flags));
-                }
-                phaseData = await this.promptPhaseData(fields);
-            }
-            else {
-                phaseData = {
-                    name: args.name,
-                    category: flags.category,
-                    color: flags.color,
-                    description: flags.description,
-                    isDefault: flags.default,
-                };
-            }
-            const phase = await this.storage.createPhase(phaseData);
-            this.log(styles.success(`\nCreated phase "${styles.emphasis(phase.name)}"`));
-            this.log(styles.muted(`  ID: ${phase.id}`));
-            this.log(styles.muted(`  Category: ${phase.category}`));
-            if (phase.color) {
-                this.log(styles.muted(`  Color: ${phase.color}`));
-            }
-            if (phase.description) {
-                this.log(styles.muted(`  Description: ${phase.description}`));
-            }
-            if (phase.isDefault) {
-                this.log(styles.muted(`  Default: Yes`));
-            }
-        }
-    }
-    async promptPhaseData(fields) {
-        // Build inquirer prompts from fields, adding validators
-        const answers = await inquirer.prompt(fields.map(field => ({
-            ...field,
-            validate: field.name === 'name'
-                ? ((input) => input.length > 0 || 'Name is required')
-                : undefined,
-        })));
-        return {
-            name: answers.name,
-            category: answers.category,
-            color: answers.color || undefined,
-            description: answers.description || undefined,
-            isDefault: answers.isDefault,
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Define category labels - single source of truth
+        const categoryLabels = {
+            triage: 'Triage - Inbox, needs review',
+            backlog: 'Backlog - Not yet scheduled for work',
+            unstarted: 'Unstarted - Scheduled but work hasn\'t begun',
+            started: 'Started - Work is actively in progress',
+            completed: 'Completed - Work finished successfully',
+            canceled: 'Canceled - Work won\'t be done',
         };
+        // Build base command with positional arg if name provided
+        const baseCmd = args.name
+            ? `prlt phase create "${args.name}"`
+            : 'prlt phase create';
+        // Use FlagResolver for unified JSON mode and interactive handling
+        const resolver = new FlagResolver({
+            commandName: 'phase create',
+            baseCommand: baseCmd,
+            jsonMode,
+            flags: {
+                category: flags.category,
+                color: flags.color,
+                description: flags.description,
+                default: flags.default,
+                machine: flags.machine,
+                json: flags.json,
+            },
+        });
+        // Store name in context for later use
+        let phaseName = args.name;
+        // Name prompt - required (only if not provided as positional arg)
+        if (!args.name) {
+            resolver.addPrompt({
+                flagName: 'name',
+                type: 'input',
+                message: 'Phase name:',
+                validate: (value) => value.length > 0 || 'Name is required',
+                context: {
+                    hint: 'Provide name with: prlt phase create "Phase Name" --category <category>',
+                    example: 'prlt phase create "In Review" --category started',
+                },
+                // For input prompts, the agent will re-run with the positional arg
+                getCommand: (value) => `prlt phase create "${value}" --json`,
+            });
+        }
+        // Category prompt - required
+        resolver.addPrompt({
+            flagName: 'category',
+            type: 'list',
+            message: 'Category:',
+            choices: () => STATE_CATEGORY_ORDER.map(cat => ({
+                name: categoryLabels[cat],
+                value: cat,
+            })),
+            when: () => !!args.name && !flags.category,
+        });
+        // Color prompt - optional (only in interactive mode)
+        if (flags.interactive) {
+            resolver.addPrompt({
+                flagName: 'color',
+                type: 'input',
+                message: 'Color (hex, optional):',
+                when: (ctx) => ctx.flags.category !== undefined && ctx.flags.color === undefined,
+            });
+            // Description prompt - optional (only in interactive mode)
+            resolver.addPrompt({
+                flagName: 'description',
+                type: 'input',
+                message: 'Description (optional):',
+                when: (ctx) => ctx.flags.category !== undefined && ctx.flags.description === undefined,
+            });
+            // Default prompt - optional (only in interactive mode)
+            resolver.addPrompt({
+                flagName: 'default',
+                type: 'list',
+                message: 'Set as default for new projects?',
+                choices: () => [
+                    { name: 'No', value: false },
+                    { name: 'Yes', value: true },
+                ],
+                when: (ctx) => ctx.flags.category !== undefined && ctx.flags.default === undefined,
+            });
+        }
+        // Resolve missing flags
+        const resolved = await resolver.resolve();
+        // Get name from args or resolved (for interactive mode)
+        phaseName = phaseName || resolved.name;
+        // Validate required fields
+        if (!phaseName) {
+            this.error('Name is required. Use positional arg or --interactive mode.');
+        }
+        if (!resolved.category) {
+            this.error('Category is required. Use --category flag or --interactive mode.');
+        }
+        // Create the phase
+        const phase = await this.storage.createPhase({
+            name: phaseName,
+            category: resolved.category,
+            color: resolved.color || undefined,
+            description: resolved.description || undefined,
+            isDefault: resolved.default || false,
+        });
+        this.log(styles.success(`\nCreated phase "${styles.emphasis(phase.name)}"`));
+        this.log(styles.muted(`  ID: ${phase.id}`));
+        this.log(styles.muted(`  Category: ${phase.category}`));
+        if (phase.color) {
+            this.log(styles.muted(`  Color: ${phase.color}`));
+        }
+        if (phase.description) {
+            this.log(styles.muted(`  Description: ${phase.description}`));
+        }
+        if (phase.isDefault) {
+            this.log(styles.muted(`  Default: Yes`));
+        }
     }
 }

package/dist/commands/phase/delete.d.ts

@@ -7,6 +7,7 @@ export default class PhaseDelete extends PMOCommand {
     };
     static flags: {
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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/phase/delete.js

@@ -1,8 +1,8 @@
 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 { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { FlagResolver } from '../../lib/flags/index.js';
 export default class PhaseDelete extends PMOCommand {
     static description = 'Delete a project lifecycle phase';
     static examples = [
@@ -22,10 +22,6 @@ export default class PhaseDelete extends PMOCommand {
             description: 'Skip confirmation',
             default: false,
         }),
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
@@ -47,22 +43,27 @@ export default class PhaseDelete extends PMOCommand {
             return handleError('PHASE_NOT_FOUND', `Phase "${args.id}" not found.`);
         }
         if (!flags.force) {
-            // In JSON mode, output confirmation prompt
-            if (jsonMode) {
-                const confirmChoices = [
-                    { name: 'No', value: 'false' },
-                    { name: 'Yes', value: 'true' },
-                ];
-                outputPromptAsJson(buildPromptConfig('list', 'confirmed', `Delete phase "${phase.name}"?`, confirmChoices), createMetadata('phase delete', flags));
-                return;
-            }
-            const { confirm } = await inquirer.prompt([{
-                    type: 'confirm',
-                    name: 'confirm',
-                    message: `Delete phase "${phase.name}"?`,
-                    default: false,
-                }]);
-            if (!confirm) {
+            // Use FlagResolver for confirmation
+            const resolver = new FlagResolver({
+                commandName: 'phase delete',
+                baseCommand: `prlt phase delete ${args.id}`,
+                jsonMode,
+                flags: { machine: flags.machine, json: flags.json },
+            });
+            resolver.addPrompt({
+                flagName: 'confirmed',
+                type: 'list',
+                message: `Delete phase "${phase.name}"?`,
+                choices: () => [
+                    { name: 'No', value: false },
+                    { name: 'Yes', value: true },
+                ],
+                getCommand: (value) => value
+                    ? `prlt phase delete ${args.id} --force --json`
+                    : '',
+            });
+            const resolved = await resolver.resolve();
+            if (!resolved.confirmed) {
                 this.log(styles.muted('Cancelled.'));
                 return;
             }

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

@@ -4,6 +4,7 @@ export default class PhaseList extends PMOCommand {
     static examples: string[];
     static flags: {
         category: 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>;
         project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/commands/phase/list.js

@@ -2,11 +2,13 @@ import { Flags } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
 import { STATE_CATEGORY_ORDER } from '../../lib/pmo/types.js';
+import { isMachineOutput } from '../../lib/prompt-json.js';
 export default class PhaseList extends PMOCommand {
     static description = 'List all project lifecycle phases';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --category started',
+        '<%= config.bin %> <%= command.id %> --machine',
         '<%= config.bin %> <%= command.id %> --json',
     ];
     static flags = {
@@ -16,15 +18,11 @@ export default class PhaseList extends PMOCommand {
             description: 'Filter by category',
             options: ['backlog', 'unstarted', 'started', 'completed', 'canceled'],
         }),
-        json: Flags.boolean({
-            description: 'Output as JSON',
-            default: false,
-        }),
     };
     async execute() {
         const { flags } = await this.parse(PhaseList);
         const phases = await this.storage.listPhases(flags.category ? { category: flags.category } : undefined);
-        if (flags.json) {
+        if (isMachineOutput(flags)) {
             this.log(JSON.stringify(phases, null, 2));
             return;
         }

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

@@ -7,6 +7,7 @@ export default class PhaseMove extends PMOCommand {
     };
     static flags: {
         position: 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/phase/move.js

@@ -1,8 +1,8 @@
 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 { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { FlagResolver } from '../../lib/flags/index.js';
 export default class PhaseMove extends PMOCommand {
     static description = 'Change the position of a phase within its category';
     static examples = [
@@ -23,10 +23,6 @@ export default class PhaseMove extends PMOCommand {
             description: 'New position (0-indexed)',
             required: false,
         }),
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
@@ -50,25 +46,28 @@ export default class PhaseMove extends PMOCommand {
             if (phases.length === 0) {
                 return handleError('NO_PHASES', 'No phases found. Create a phase first with "prlt phase create".');
             }
-            // In JSON mode, output phase selection prompt
-            if (jsonMode) {
-                const phaseChoices = phases.map(p => ({
+            const idResolver = new FlagResolver({
+                commandName: 'phase move',
+                baseCommand: 'prlt phase move',
+                jsonMode,
+                flags: { machine: flags.machine, json: flags.json },
+            });
+            idResolver.addPrompt({
+                flagName: 'phaseId',
+                type: 'list',
+                message: 'Select phase to move:',
+                choices: () => phases.map(p => ({
                     name: `${p.name} (${p.category}, position ${p.position})`,
                     value: p.id,
-                }));
-                outputPromptAsJson(buildPromptConfig('list', 'phaseId', 'Select phase to move:', phaseChoices), createMetadata('phase move', flags));
-                return;
+                })),
+                // Use positional arg format for phase ID
+                getCommand: (value) => `prlt phase move ${value} --json`,
+            });
+            const resolved = await idResolver.resolve();
+            if (!resolved.phaseId) {
+                return; // Cancelled
             }
-            const { selectedId } = await inquirer.prompt([{
-                    type: 'list',
-                    name: 'selectedId',
-                    message: 'Select phase to move:',
-                    choices: phases.map(p => ({
-                        name: `${p.name} (${p.category}, position ${p.position})`,
-                        value: p.id,
-                    })),
-                }]);
-            phaseId = selectedId;
+            phaseId = resolved.phaseId;
         }
         const phase = await this.storage.getPhase(phaseId);
         if (!phase) {
@@ -80,26 +79,27 @@ export default class PhaseMove extends PMOCommand {
             // Get phases in the same category to show valid positions
             const phases = await this.storage.listPhases();
             const categoryPhases = phases.filter(p => p.category === phase.category);
-            // In JSON mode, output position selection prompt
-            if (jsonMode) {
-                const positionChoices = categoryPhases.map((_, idx) => ({
+            const posResolver = new FlagResolver({
+                commandName: 'phase move',
+                baseCommand: `prlt phase move ${phaseId}`,
+                jsonMode,
+                flags: { machine: flags.machine, json: flags.json },
+            });
+            posResolver.addPrompt({
+                flagName: 'position',
+                type: 'list',
+                message: `New position within ${phase.category} (currently ${phase.position}):`,
+                choices: () => categoryPhases.map((_, idx) => ({
                     name: `Position ${idx}${idx === phase.position ? ' (current)' : ''}`,
                     value: String(idx),
-                }));
-                outputPromptAsJson(buildPromptConfig('list', 'position', `New position within ${phase.category} (currently ${phase.position}):`, positionChoices), createMetadata('phase move', flags));
-                return;
+                })),
+                default: String(phase.position),
+            });
+            const resolved = await posResolver.resolve();
+            if (!resolved.position) {
+                return; // Cancelled
             }
-            const { position } = await inquirer.prompt([{
-                    type: 'list',
-                    name: 'position',
-                    message: `New position within ${phase.category} (currently ${phase.position}):`,
-                    choices: categoryPhases.map((_, idx) => ({
-                        name: `Position ${idx}${idx === phase.position ? ' (current)' : ''}`,
-                        value: idx,
-                    })),
-                    default: phase.position,
-                }]);
-            newPosition = position;
+            newPosition = parseInt(resolved.position, 10);
         }
         if (newPosition < 0) {
             this.error('Position must be >= 0');

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

@@ -8,6 +8,7 @@ export default class PhaseTemplateApply extends PMOCommand {
     static flags: {
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         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(): {

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

@@ -7,6 +7,8 @@ export default class PhaseTemplateCreate extends PMOCommand {
     };
     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>;
         project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     protected getPMOOptions(): {

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

@@ -8,6 +8,7 @@ export default class PhaseTemplateDelete extends PMOCommand {
     static flags: {
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         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(): {

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

@@ -5,6 +5,7 @@ export default class PhaseTemplateMenu extends PMOCommand {
     static examples: string[];
     static flags: {
         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(): {

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

@@ -6,6 +6,7 @@ export default class PhaseTemplateList extends PMOCommand {
         builtin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         custom: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         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(): {

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

@@ -8,6 +8,8 @@ export default class PhaseTemplateUpdate extends PMOCommand {
     static flags: {
         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>;
+        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>;
     };
     protected getPMOOptions(): {

package/dist/commands/phase/update.d.ts

@@ -12,6 +12,7 @@ export default class PhaseUpdate extends PMOCommand {
         description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         default: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         interactive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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>;
     };
@@ -19,5 +20,4 @@ export default class PhaseUpdate extends PMOCommand {
         promptIfMultiple: boolean;
     };
     execute(): Promise<void>;
-    private promptUpdates;
 }