@proletariat/cli 0.3.16 → 0.3.18

package/dist/commands/spec/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 { slugify } from '../../lib/pmo/utils.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 SpecCreate extends PMOCommand {
     static description = 'Create a new spec';
     static examples = [
@@ -41,61 +41,80 @@ export default class SpecCreate extends PMOCommand {
             description: 'Interactive mode',
             default: false,
         }),
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
     };
     async execute() {
         const { args, flags } = await this.parse(SpecCreate);
         // Check if JSON output mode is active
         const jsonMode = shouldOutputJson(flags);
-        // Get spec data
-        let specData;
-        if (flags.interactive || (!args.title && !flags.title)) {
-            // Build choices once - single source of truth
-            const typeChoices = [
-                { name: 'Product (user-facing feature)', value: 'product' },
-                { name: 'Platform (internal tooling)', value: 'platform' },
-                { name: 'Infra (technical infrastructure)', value: 'infra' },
-                { name: 'Integration (external service)', value: 'integration' },
-                { name: 'None', value: '' },
-            ];
-            const statusChoices = [
-                { name: 'Draft (planning)', value: 'draft' },
-                { name: 'Active (in progress)', value: 'active' },
-                { name: 'Implemented (complete)', value: 'implemented' },
-            ];
-            // Define fields once - single source of truth for both JSON and interactive modes
-            const fields = [
-                { type: 'input', name: 'title', message: 'Spec title:', default: flags.title },
-                { type: 'list', name: 'type', message: 'Spec type:', choices: typeChoices, default: flags.type },
-                { type: 'list', name: 'status', message: 'Status:', choices: statusChoices, default: flags.status || 'draft' },
-                { type: 'input', name: 'problem', message: 'Problem statement (optional):', default: flags.problem },
-            ];
-            // In JSON mode, output form prompts
-            if (jsonMode) {
-                outputPromptAsJson(buildFormPromptConfig(fields), createMetadata('spec create', flags));
-            }
-            specData = await this.promptSpecData(fields);
-        }
-        else {
-            specData = {
-                title: args.title || flags.title || 'Untitled Spec',
-                status: flags.status || 'draft',
+        // Build choices for prompts
+        const typeChoices = [
+            { name: 'Product (user-facing feature)', value: 'product' },
+            { name: 'Platform (internal tooling)', value: 'platform' },
+            { name: 'Infra (technical infrastructure)', value: 'infra' },
+            { name: 'Integration (external service)', value: 'integration' },
+            { name: 'None', value: '' },
+        ];
+        const statusChoices = [
+            { name: 'Draft (planning)', value: 'draft' },
+            { name: 'Active (in progress)', value: 'active' },
+            { name: 'Implemented (complete)', value: 'implemented' },
+        ];
+        // Use FlagResolver for all fields
+        const resolver = new FlagResolver({
+            commandName: 'spec create',
+            baseCommand: 'prlt spec create',
+            jsonMode,
+            flags: {
+                title: args.title || flags.title,
                 type: flags.type,
+                status: flags.status || 'draft',
                 problem: flags.problem,
-            };
+            },
+        });
+        // Only prompt if interactive mode or no title provided
+        const needsPrompts = flags.interactive || (!args.title && !flags.title);
+        if (needsPrompts) {
+            resolver.addPrompt({
+                flagName: 'title',
+                type: 'input',
+                message: 'Spec title:',
+                validate: (value) => value.length > 0 || 'Title is required',
+                when: (ctx) => !ctx.flags.title,
+            });
+            resolver.addPrompt({
+                flagName: 'type',
+                type: 'list',
+                message: 'Spec type:',
+                choices: () => typeChoices,
+                when: (ctx) => !ctx.flags.type && ctx.flags.title !== undefined,
+            });
+            resolver.addPrompt({
+                flagName: 'status',
+                type: 'list',
+                message: 'Status:',
+                choices: () => statusChoices,
+                default: 'draft',
+                when: (ctx) => ctx.flags.title !== undefined,
+            });
+            resolver.addPrompt({
+                flagName: 'problem',
+                type: 'input',
+                message: 'Problem statement (optional):',
+                when: (ctx) => ctx.flags.title !== undefined,
+            });
         }
+        const resolved = await resolver.resolve();
+        // Convert empty type to undefined
+        const specType = resolved.type === '' ? undefined : resolved.type;
         // Generate ID from title
-        const specId = slugify(specData.title);
+        const specId = slugify(resolved.title);
         // Create spec in database
         const spec = await this.storage.createSpec({
             id: specId,
-            title: specData.title,
-            status: specData.status,
-            type: specData.type,
-            problem: specData.problem,
+            title: resolved.title,
+            status: resolved.status || 'draft',
+            type: specType,
+            problem: resolved.problem || undefined,
         });
         this.log(styles.success(`\n✅ Created spec "${styles.emphasis(spec.title)}"`));
         this.log(styles.muted(`  ID: ${spec.id}`));
@@ -107,24 +126,4 @@ export default class SpecCreate extends PMOCommand {
         this.log(styles.muted(`  2. prlt spec edit ${spec.id}  (to add details)`));
         this.log(styles.muted(`  3. prlt spec plan ${spec.id}  (to generate tickets)`));
     }
-    async promptSpecData(fields) {
-        // Build inquirer prompts from fields, adding validators
-        const answers = await inquirer.prompt(fields.map(field => ({
-            ...field,
-            // Convert empty string value to undefined for 'type' field
-            choices: field.name === 'type' && field.choices
-                ? field.choices.map(c => ({ ...c, value: c.value || undefined }))
-                : field.choices,
-            // Add validator for required title field
-            validate: field.name === 'title'
-                ? ((input) => input.length > 0 || 'Title is required')
-                : undefined,
-        })));
-        return {
-            title: answers.title,
-            status: answers.status,
-            type: answers.type,
-            problem: answers.problem || undefined,
-        };
-    }
 }

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

@@ -3,6 +3,7 @@ export default class Spec extends PMOCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        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/spec/index.js

@@ -1,6 +1,6 @@
-import { Flags } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { shouldOutputJson } from '../../lib/prompt-json.js';
+import { FlagResolver } from '../../lib/flags/index.js';
 export default class Spec extends PMOCommand {
     static description = 'Interactive menu for spec operations';
     static examples = [
@@ -8,10 +8,6 @@ export default class Spec extends PMOCommand {
     ];
     static flags = {
         ...pmoBaseFlags,
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
@@ -20,26 +16,44 @@ export default class Spec extends PMOCommand {
         const { flags } = await this.parse(Spec);
         // 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
+        // Define choices for the menu
         const menuChoices = [
-            { id: 'create', name: 'Create new spec', command: 'prlt spec create --json' },
-            { id: 'list', name: 'List all specs', command: 'prlt spec list --format json' },
-            { id: 'view', name: 'View spec', command: 'prlt spec view --json' },
-            { id: 'generate', name: 'Generate tickets from spec', command: 'prlt spec plan --json' },
-            { id: 'ticket', name: 'Assign ticket to spec', command: 'prlt spec ticket --json' },
-            { id: 'link', name: 'Manage dependencies', command: 'prlt spec link --json' },
-            { id: 'cancel', name: 'Cancel', command: '' },
+            { name: 'Create new spec', value: 'create' },
+            { name: 'List all specs', value: 'list' },
+            { name: 'View spec', value: 'view' },
+            { name: 'Generate tickets from spec', value: 'generate' },
+            { name: 'Assign ticket to spec', value: 'ticket' },
+            { name: 'Manage dependencies', value: 'link' },
+            { name: 'Cancel', value: 'cancel' },
         ];
-        const message = 'Spec Operations - What would you like to do?';
-        const action = await this.selectFromList({
-            message: '📄 ' + message,
-            items: menuChoices,
-            getName: (c) => c.name,
-            getValue: (c) => c.id,
-            getCommand: (c) => c.command,
-            jsonMode: jsonMode ? { flags, commandName: 'spec' } : null,
+        // Use FlagResolver for action selection
+        const resolver = new FlagResolver({
+            commandName: 'spec',
+            baseCommand: 'prlt spec',
+            jsonMode,
+            flags: {},
         });
+        resolver.addPrompt({
+            flagName: 'action',
+            type: 'list',
+            message: '📄 Spec Operations - What would you like to do?',
+            choices: () => menuChoices,
+            // Custom command builder for menu items
+            getCommand: (value) => {
+                const commands = {
+                    create: 'prlt spec create --json',
+                    list: 'prlt spec list --json',
+                    view: 'prlt spec view --json',
+                    generate: 'prlt spec plan --json',
+                    ticket: 'prlt spec ticket --json',
+                    link: 'prlt spec link --json',
+                    cancel: '',
+                };
+                return commands[value] || '';
+            },
+        });
+        const resolved = await resolver.resolve();
+        const action = resolved.action;
         if (action === 'cancel' || !action) {
             return;
         }

package/dist/commands/spec/link/depends.d.ts

@@ -7,6 +7,7 @@ export default class SpecLinkDepends extends PMOCommand {
         target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
+        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/spec/link/depends.js

@@ -1,4 +1,4 @@
-import { Args, Flags } from '@oclif/core';
+import { Args } from '@oclif/core';
 import inquirer from 'inquirer';
 import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
 import { styles } from '../../../lib/styles.js';
@@ -12,10 +12,6 @@ export default class SpecLinkDepends extends PMOCommand {
     };
     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(SpecLinkDepends);
@@ -46,7 +42,11 @@ export default class SpecLinkDepends extends PMOCommand {
             }
             // In JSON mode, output spec selection prompt
             if (jsonMode) {
-                const specChoices = otherSpecs.map(s => ({ name: `${s.id} - ${s.title}`, value: s.id }));
+                const specChoices = otherSpecs.map(s => ({
+                    name: `${s.id} - ${s.title}`,
+                    value: s.id,
+                    command: `prlt spec link depends ${args.id} ${s.id} --json`,
+                }));
                 outputPromptAsJson(buildPromptConfig('list', 'target', `Select spec that ${args.id} depends on:`, specChoices), createMetadata('spec link depends', flags));
                 return;
             }

package/dist/commands/spec/link/duplicates.d.ts

@@ -7,6 +7,7 @@ export default class SpecLinkDuplicates extends PMOCommand {
         original: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
+        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/spec/link/duplicates.js

@@ -1,4 +1,4 @@
-import { Args, Flags } from '@oclif/core';
+import { Args } from '@oclif/core';
 import inquirer from 'inquirer';
 import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
 import { styles } from '../../../lib/styles.js';
@@ -12,10 +12,6 @@ export default class SpecLinkDuplicates extends PMOCommand {
     };
     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(SpecLinkDuplicates);
@@ -46,7 +42,11 @@ export default class SpecLinkDuplicates extends PMOCommand {
             }
             // In JSON mode, output spec selection prompt
             if (jsonMode) {
-                const specChoices = otherSpecs.map(s => ({ name: `${s.id} - ${s.title}`, value: s.id }));
+                const specChoices = otherSpecs.map(s => ({
+                    name: `${s.id} - ${s.title}`,
+                    value: s.id,
+                    command: `prlt spec link duplicates ${args.id} ${s.id} --json`,
+                }));
                 outputPromptAsJson(buildPromptConfig('list', 'original', `Select the original spec (${args.id} is a duplicate of):`, specChoices), createMetadata('spec link duplicates', flags));
                 return;
             }

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

@@ -6,11 +6,12 @@ export default class SpecLink extends PMOCommand {
         id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         depends: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         relates: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         duplicates: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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>;
     };
     execute(): Promise<void>;

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

@@ -17,10 +17,6 @@ export default class SpecLink extends PMOCommand {
     };
     static flags = {
         ...pmoBaseFlags,
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
         depends: Flags.string({ char: 'd', description: 'Add depends_on dependency' }),
         relates: Flags.string({ char: 'r', description: 'Add relates_to dependency' }),
         duplicates: Flags.string({ description: 'Add duplicates dependency' }),

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

@@ -7,6 +7,7 @@ export default class SpecLinkRelates extends PMOCommand {
         target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
+        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/spec/link/relates.js

@@ -1,4 +1,4 @@
-import { Args, Flags } from '@oclif/core';
+import { Args } from '@oclif/core';
 import inquirer from 'inquirer';
 import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
 import { styles } from '../../../lib/styles.js';
@@ -12,10 +12,6 @@ export default class SpecLinkRelates extends PMOCommand {
     };
     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(SpecLinkRelates);
@@ -46,7 +42,11 @@ export default class SpecLinkRelates extends PMOCommand {
             }
             // In JSON mode, output spec selection prompt
             if (jsonMode) {
-                const specChoices = otherSpecs.map(s => ({ name: `${s.id} - ${s.title}`, value: s.id }));
+                const specChoices = otherSpecs.map(s => ({
+                    name: `${s.id} - ${s.title}`,
+                    value: s.id,
+                    command: `prlt spec link relates ${args.id} ${s.id} --json`,
+                }));
                 outputPromptAsJson(buildPromptConfig('list', 'target', `Select spec that ${args.id} relates to:`, specChoices), createMetadata('spec link relates', flags));
                 return;
             }

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

@@ -7,9 +7,10 @@ export default class SpecLinkRemove extends PMOCommand {
         target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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>;
     };
     execute(): Promise<void>;

package/dist/commands/spec/link/remove.js

@@ -15,10 +15,6 @@ export default class SpecLinkRemove extends PMOCommand {
     };
     static flags = {
         ...pmoBaseFlags,
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
         type: Flags.string({ char: 't', description: 'Dependency type', options: ['depends_on', 'relates_to', 'duplicates'] }),
         all: Flags.boolean({ char: 'a', description: 'Remove all dependencies', default: false }),
     };
@@ -82,9 +78,13 @@ export default class SpecLinkRemove extends PMOCommand {
                 const depSpec = await this.storage.getSpec(dep.dependsOnSpecId);
                 return { name: `${dep.dependsOnSpecId} - ${depSpec?.title || 'Unknown'} (${dep.dependencyType})`, value: dep.dependsOnSpecId };
             }));
-            // In JSON mode, output dependency selection prompt
+            // In JSON mode, output dependency selection prompt with command fields
             if (jsonMode) {
-                outputPromptAsJson(buildPromptConfig('list', 'target', 'Select dependency to remove:', choices), createMetadata('spec link remove', flags));
+                const choicesWithCommands = choices.map(c => ({
+                    ...c,
+                    command: `prlt spec link remove ${args.id} ${c.value} --json`,
+                }));
+                outputPromptAsJson(buildPromptConfig('list', 'target', 'Select dependency to remove:', choicesWithCommands), createMetadata('spec link remove', flags));
                 return;
             }
             const { selected } = await inquirer.prompt([{ type: 'list', name: 'selected', message: 'Select dependency to remove:', choices }]);

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

@@ -6,6 +6,8 @@ export default class SpecList extends PMOCommand {
         status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        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>;
     };
     execute(): Promise<void>;

package/dist/commands/spec/list.js

@@ -1,6 +1,7 @@
 import { Flags } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
+import { shouldOutputJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class SpecList extends PMOCommand {
     static description = 'List all specs';
     static examples = [
@@ -26,12 +27,36 @@ export default class SpecList extends PMOCommand {
     };
     async execute() {
         const { flags } = await this.parse(SpecList);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
         // List specs with filters
         const specs = await this.storage.listSpecs({
             status: flags.status,
             type: flags.type,
             search: flags.search,
         });
+        // In JSON mode, output specs as structured data
+        if (jsonMode) {
+            outputSuccessAsJson({
+                specs: specs.map(s => ({
+                    id: s.id,
+                    title: s.title,
+                    status: s.status,
+                    type: s.type,
+                    tags: s.tags,
+                    problem: s.problem,
+                    createdAt: s.createdAt?.toISOString(),
+                    updatedAt: s.updatedAt?.toISOString(),
+                })),
+                count: specs.length,
+                filters: {
+                    status: flags.status,
+                    type: flags.type,
+                    search: flags.search,
+                },
+            }, createMetadata('spec list', flags));
+            return;
+        }
         if (specs.length === 0) {
             this.log(styles.warning('\nNo specs found'));
             this.log(styles.muted('  Create your first spec: prlt spec create'));

package/dist/commands/spec/plan.d.ts

@@ -6,9 +6,10 @@ export default class SpecPlan extends PMOCommand {
         spec: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         spec: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'dry-run': 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>;
     };
     execute(): Promise<void>;

package/dist/commands/spec/plan.js

@@ -1,8 +1,8 @@
 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 { 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 SpecPlan extends PMOCommand {
     static description = 'Generate tickets from spec by comparing ideal state vs codebase (uses LLM)';
     static examples = [
@@ -17,10 +17,6 @@ export default class SpecPlan extends PMOCommand {
     };
     static flags = {
         ...pmoBaseFlags,
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
         spec: Flags.string({
             char: 's',
             description: 'Spec ID',
@@ -42,7 +38,7 @@ export default class SpecPlan extends PMOCommand {
             }
             this.error(message);
         };
-        // Get spec ID
+        // Get spec ID from args or flags
         let specId = args.spec || flags.spec;
         if (!specId) {
             // List specs and prompt for selection
@@ -50,27 +46,24 @@ export default class SpecPlan extends PMOCommand {
             if (specs.length === 0) {
                 return handleError('NO_SPECS', 'No specs found. Create a spec first with "prlt spec create".');
             }
-            // In JSON mode, output spec selection prompt
-            if (jsonMode) {
-                const specChoices = specs.map(s => ({
+            // Use FlagResolver for spec selection
+            const resolver = new FlagResolver({
+                commandName: 'spec plan',
+                baseCommand: 'prlt spec plan',
+                jsonMode,
+                flags: { spec: flags.spec },
+            });
+            resolver.addPrompt({
+                flagName: 'spec',
+                type: 'list',
+                message: 'Select spec to plan:',
+                choices: () => specs.map(s => ({
                     name: `${s.title} [${s.status}]${s.type ? ` (${s.type})` : ''}`,
                     value: s.id,
-                }));
-                outputPromptAsJson(buildPromptConfig('list', 'spec', 'Select spec to plan:', specChoices), createMetadata('spec plan', flags));
-                return;
-            }
-            const { selectedSpec } = await inquirer.prompt([
-                {
-                    type: 'list',
-                    name: 'selectedSpec',
-                    message: 'Select spec to plan:',
-                    choices: specs.map(s => ({
-                        name: `${s.title} [${s.status}]${s.type ? ` (${s.type})` : ''}`,
-                        value: s.id,
-                    })),
-                },
-            ]);
-            specId = selectedSpec;
+                })),
+            });
+            const resolved = await resolver.resolve();
+            specId = resolved.spec;
         }
         // Get the spec
         const spec = await this.storage.getSpec(specId);

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

@@ -7,9 +7,10 @@ export default class SpecTicket extends PMOCommand {
         specId: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         ticket: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         spec: 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>;
     };
     execute(): Promise<void>;