@proletariat/cli 0.3.20 → 0.3.21

package/dist/commands/agent/login.js

@@ -3,7 +3,7 @@ import * as path from 'node:path';
 import * as fs from 'node:fs';
 import { execSync } from 'node:child_process';
 import { colors } from '../../lib/colors.js';
-import { getWorkspaceInfo } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, formatAgentList } from '../../lib/agents/commands.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { isDockerRunning, getAgentContainerName, isContainerRunning, getContainerId, } from '../../lib/execution/runners.js';
 import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
@@ -76,7 +76,7 @@ export default class Login extends PMOCommand {
         // Validate agent exists
         const agent = workspaceInfo.agents.find(a => a.name === agentName);
         if (!agent) {
-            this.error(`Agent "${agentName}" not found. Available agents: ${workspaceInfo.agents.map(a => a.name).join(', ')}`);
+            this.error(`Agent "${agentName}" not found. Available: ${formatAgentList(workspaceInfo.agents)}`);
         }
         const agentDir = path.join(workspaceInfo.agentsPath, agentName);
         // Check if Docker config exists

package/dist/commands/agent/remove.d.ts

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

package/dist/commands/agent/remove.js

@@ -1,7 +1,7 @@
 import { Args, Flags } from '@oclif/core';
 import inquirer from 'inquirer';
 import { colors, format } from '../../lib/colors.js';
-import { getWorkspaceInfo, removeAgentsFromWorkspace } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, removeAgentsFromWorkspace, formatAgentList } from '../../lib/agents/commands.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
 export default class Remove extends PMOCommand {
@@ -22,6 +22,11 @@ export default class Remove extends PMOCommand {
             description: 'Output prompt configuration as JSON (for AI agents/scripts)',
             default: false,
         }),
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Skip confirmation prompt (for non-interactive use)',
+            default: false,
+        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
@@ -90,36 +95,39 @@ export default class Remove extends PMOCommand {
         // Validate agent exists
         const agent = workspaceInfo.agents.find((a) => a.name === agentName);
         if (!agent) {
-            return handleError('AGENT_NOT_FOUND', `Agent "${agentName}" not found. Available agents: ${workspaceInfo.agents.map((a) => a.name).join(', ')}`);
+            return handleError('AGENT_NOT_FOUND', `Agent "${agentName}" not found. Available: ${formatAgentList(workspaceInfo.agents)}`);
         }
         const agentsToRemove = [agentName];
-        // Build choices once, use for both JSON and interactive modes
-        const confirmChoices = [
-            { name: 'No, cancel', value: 'false' },
-            { name: 'Yes, remove agent', value: 'true' },
-        ];
-        const confirmMessage = `Are you sure you want to remove agent "${agentName}"? This will delete its worktree.`;
-        // Confirm removal
-        // In JSON mode, output confirmation prompt
-        if (jsonMode) {
-            outputPromptAsJson(buildPromptConfig('list', 'confirmed', confirmMessage, confirmChoices), createMetadata('agent remove', flags));
-            return;
-        }
-        const { confirm } = await inquirer.prompt([
-            {
-                type: 'list',
-                name: 'confirm',
-                message: confirmMessage,
-                choices: [
-                    { name: '❌ ' + confirmChoices[0].name, value: false },
-                    { name: '⚠️  ' + confirmChoices[1].name, value: true }
-                ],
-                default: 0 // Default to "No, cancel"
+        // Skip confirmation if --force flag is passed
+        if (!flags.force) {
+            // Build choices once, use for both JSON and interactive modes
+            const confirmChoices = [
+                { name: 'No, cancel', value: 'false' },
+                { name: 'Yes, remove agent', value: 'true' },
+            ];
+            const confirmMessage = `Are you sure you want to remove agent "${agentName}"? This will delete its worktree.`;
+            // Confirm removal
+            // In JSON mode, output confirmation prompt
+            if (jsonMode) {
+                outputPromptAsJson(buildPromptConfig('list', 'confirmed', confirmMessage, confirmChoices), createMetadata('agent remove', flags));
+                return;
+            }
+            const { confirm } = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'confirm',
+                    message: confirmMessage,
+                    choices: [
+                        { name: '❌ ' + confirmChoices[0].name, value: false },
+                        { name: '⚠️  ' + confirmChoices[1].name, value: true }
+                    ],
+                    default: 0 // Default to "No, cancel"
+                }
+            ]);
+            if (!confirm) {
+                this.log(colors.textMuted('Removal cancelled.'));
+                return;
             }
-        ]);
-        if (!confirm) {
-            this.log(colors.textMuted('Removal cancelled.'));
-            return;
         }
         // Remove agents
         this.log(colors.primary(`Removing agent "${agentName}"...`));

package/dist/commands/agent/shell.js

@@ -4,7 +4,7 @@ import * as fs from 'node:fs';
 import { execSync, spawn } from 'node:child_process';
 import Database from 'better-sqlite3';
 import { colors } from '../../lib/colors.js';
-import { getWorkspaceInfo, getAgentTmuxSessions } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, getAgentTmuxSessions, formatAgentList } from '../../lib/agents/commands.js';
 import { hasDevcontainerConfig } from '../../lib/execution/devcontainer.js';
 import { getTerminalApp } from '../../lib/execution/config.js';
 import { isDockerRunning, getAgentContainerName, isContainerRunning, getContainerId, } from '../../lib/execution/runners.js';
@@ -74,7 +74,7 @@ export default class Shell extends PMOCommand {
         // Validate agent exists
         const agent = workspaceInfo.agents.find(a => a.name === agentName);
         if (!agent) {
-            this.handleError('AGENT_NOT_FOUND', `Agent "${agentName}" not found. Available agents: ${workspaceInfo.agents.map(a => a.name).join(', ')}`, errorConfig);
+            this.handleError('AGENT_NOT_FOUND', `Agent "${agentName}" not found. Available: ${formatAgentList(workspaceInfo.agents)}`, errorConfig);
         }
         // Check for existing tmux sessions (skip in JSON mode - can't handle interactive tmux)
         const existingSessions = getAgentTmuxSessions(agentName);

package/dist/commands/agent/staff/remove.js

@@ -1,7 +1,7 @@
 import { Args, Flags } from '@oclif/core';
 import inquirer from 'inquirer';
 import { colors, format } from '../../../lib/colors.js';
-import { getWorkspaceInfo, removeAgentsFromWorkspace } from '../../../lib/agents/commands.js';
+import { getWorkspaceInfo, removeAgentsFromWorkspace, formatAgentList } from '../../../lib/agents/commands.js';
 import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
 import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
 export default class Remove extends PMOCommand {
@@ -90,7 +90,7 @@ export default class Remove extends PMOCommand {
         // Validate agent exists and is a staff agent
         const agent = staffAgents.find((a) => a.name === agentName);
         if (!agent) {
-            return handleError('AGENT_NOT_FOUND', `Staff agent "${agentName}" not found. Available staff agents: ${staffAgents.map((a) => a.name).join(', ')}`);
+            return handleError('AGENT_NOT_FOUND', `Staff agent "${agentName}" not found. Available: ${formatAgentList(staffAgents)}`);
         }
         const agentsToRemove = [agentName];
         // Skip confirmation if --force flag is passed

package/dist/commands/agent/status.js

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import { colors, format } from '../../lib/colors.js';
-import { getWorkspaceInfo, getAgentStatus } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, getAgentStatus, formatAgentList } from '../../lib/agents/commands.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class Status extends PMOCommand {
@@ -69,7 +69,7 @@ export default class Status extends PMOCommand {
         // Validate agent exists
         const agent = workspaceInfo.agents.find((a) => a.name === agentName);
         if (!agent) {
-            this.error(`Agent "${agentName}" not found. Available agents: ${workspaceInfo.agents.map((a) => a.name).join(', ')}`);
+            this.error(`Agent "${agentName}" not found. Available: ${formatAgentList(workspaceInfo.agents)}`);
         }
         const agentStatus = getAgentStatus(workspaceInfo, agentName);
         this.log(format.title(`🤖 Agent: ${agentName}`));

package/dist/commands/agent/themes/add-names.d.ts

@@ -4,6 +4,7 @@ export default class ThemesAddNames extends Command {
     static examples: string[];
     static args: {
         theme: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        names: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static strict: boolean;
     run(): Promise<void>;

package/dist/commands/agent/themes/add-names.js

@@ -11,9 +11,13 @@ export default class ThemesAddNames extends Command {
     ];
     static args = {
         theme: Args.string({
-            description: 'Theme ID to add names to',
+            description: 'Theme ID',
             required: true,
         }),
+        names: Args.string({
+            description: 'Names to add to the theme (space-separated)',
+            required: false,
+        }),
     };
     static strict = false; // Allow multiple name arguments
     async run() {

package/dist/commands/agent/visit.js

@@ -1,7 +1,7 @@
 import { Args, Flags } from '@oclif/core';
 import * as path from 'node:path';
 import { colors } from '../../lib/colors.js';
-import { getWorkspaceInfo } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, formatAgentList } from '../../lib/agents/commands.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class Visit extends PMOCommand {
@@ -75,7 +75,7 @@ export default class Visit extends PMOCommand {
         // Validate agent exists
         const agent = workspaceInfo.agents.find(a => a.name === agentName);
         if (!agent) {
-            return handleError('AGENT_NOT_FOUND', `Agent "${agentName}" not found. Available agents: ${workspaceInfo.agents.map(a => a.name).join(', ')}`);
+            return handleError('AGENT_NOT_FOUND', `Agent "${agentName}" not found. Available: ${formatAgentList(workspaceInfo.agents)}`);
         }
         // Calculate path to agent directory
         const agentDir = path.join(workspaceInfo.agentsPath, agentName);

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

@@ -97,6 +97,23 @@ export default class EpicLink extends PMOCommand {
             return;
         }
         // Interactive mode: show menu in a loop
+        // In JSON mode, output the interactive menu config instead of prompting
+        if (jsonMode) {
+            const menuChoices = [
+                { name: 'View dependencies', value: 'view' },
+                { name: 'Add blocking dependency (blocked by...)', value: 'blocks' },
+                { name: 'Add relates_to dependency', value: 'relates_to' },
+                { name: 'Add duplicates dependency', value: 'duplicates' },
+                { name: 'Remove dependency', value: 'remove' },
+                { name: 'Done', value: 'done' },
+            ];
+            outputPromptAsJson(buildPromptConfig('list', 'action', `Dependencies for ${epicId}:`, menuChoices), createMetadata('epic link', flags));
+            return;
+        }
+        // Check for TTY before showing interactive menu
+        if (!process.stdin.isTTY) {
+            this.error('Interactive mode requires a TTY. Use --json for scripted usage or provide flags like --blocks, --relates, or --duplicates.');
+        }
         let continueLoop = true;
         while (continueLoop) {
             // eslint-disable-next-line no-await-in-loop -- Interactive user loop

package/dist/commands/execution/config.js

@@ -348,6 +348,28 @@ export default class ExecutionConfig extends PMOCommand {
     }
     setConfigValue(db, key, value, jsonMode) {
         const normalizedKey = key.toLowerCase();
+        // Define valid values for each config key
+        const VALID_VALUES = {
+            defaultenvironment: ['host', 'devcontainer', 'docker', 'vm'],
+            outputmode: ['interactive', 'print'],
+            sandboxed: ['true', 'false'],
+            'terminal.app': ['Terminal', 'iTerm', 'Alacritty', 'Ghostty', 'Kitty', 'tmux', 'Warp', 'WezTerm'],
+            'terminal.openinbackground': ['true', 'false'],
+            shell: ['bash', 'zsh', 'fish'],
+            'tmux.controlmode': ['true', 'false'],
+        };
+        // Validate value against allowed options
+        const validValues = VALID_VALUES[normalizedKey];
+        if (validValues && !validValues.includes(value)) {
+            const errorMsg = `Invalid value "${value}" for ${key}. Valid options: ${validValues.join(', ')}`;
+            if (jsonMode) {
+                outputErrorAsJson('INVALID_VALUE', errorMsg, createMetadata('execution config', {}));
+            }
+            else {
+                this.error(errorMsg);
+            }
+            return;
+        }
         switch (normalizedKey) {
             case 'defaultenvironment':
                 saveExecutionSetting(db, 'defaultMode', value);

package/dist/commands/execution/kill.d.ts

@@ -5,5 +5,8 @@ import ExecutionStop from './stop.js';
  */
 export default class ExecutionKill extends ExecutionStop {
     static description: string;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
     static examples: string[];
 }

package/dist/commands/execution/kill.js

@@ -5,6 +5,7 @@ import ExecutionStop from './stop.js';
  */
 export default class ExecutionKill extends ExecutionStop {
     static description = 'Stop running execution(s) (alias for "execution stop")';
+    static args = ExecutionStop.args;
     static examples = [
         '<%= config.bin %> <%= command.id %> WORK-001',
         '<%= config.bin %> <%= command.id %> WORK-001 --force',

package/dist/commands/execution/list.js

@@ -28,6 +28,7 @@ export default class ExecutionList extends PMOCommand {
             char: 'l',
             description: 'Number of results',
             default: 20,
+            min: 1,
         }),
     };
     getPMOOptions() {
@@ -61,10 +62,10 @@ export default class ExecutionList extends PMOCommand {
             this.log('');
             this.log(styles.header('🚀 Agent Work'));
             this.log('═'.repeat(100));
-            this.log(styles.muted(padEnd('ID', 11) +
+            this.log(styles.muted(padEnd('ID', 14) +
                 padEnd('Ticket', 9) +
                 padEnd('Agent', 10) +
-                padEnd('Env', 12) +
+                padEnd('Env', 13) +
                 padEnd('Display', 11) +
                 padEnd('Perms', 8) +
                 padEnd('Status', 10) +
@@ -78,10 +79,10 @@ export default class ExecutionList extends PMOCommand {
                 const envStr = `${envIcon} ${exec.environment}`;
                 const permsStr = exec.sandboxed ? 'safe' : 'danger';
                 const permsColor = exec.sandboxed ? styles.success : styles.warning;
-                this.log(padEnd(exec.id, 11) +
+                this.log(padEnd(exec.id, 14) +
                     padEnd(exec.ticketId, 9) +
                     padEnd(exec.agentName, 10) +
-                    padEnd(envStr, 12) +
+                    padEnd(envStr, 13) +
                     padEnd(exec.displayMode, 11) +
                     permsColor(padEnd(permsStr, 8)) +
                     statusColor(padEnd(exec.status, 10)) +

package/dist/commands/execution/logs.js

@@ -32,6 +32,7 @@ export default class ExecutionLogs extends PMOCommand {
         tail: Flags.integer({
             char: 'n',
             description: 'Show last n lines',
+            min: 1,
         }),
         json: Flags.boolean({
             description: 'Output prompt configuration as JSON (for AI agents/scripts)',

package/dist/commands/phase/move.js

@@ -101,9 +101,17 @@ export default class PhaseMove extends PMOCommand {
             }
             newPosition = parseInt(resolved.position, 10);
         }
+        // Get phases in same category for validation
+        const allPhases = await this.storage.listPhases();
+        const categoryPhases = allPhases.filter(p => p.category === phase.category);
+        const maxPosition = categoryPhases.length - 1;
         if (newPosition < 0) {
             this.error('Position must be >= 0');
         }
+        if (newPosition > maxPosition) {
+            this.warn(`Position ${newPosition} exceeds max (${maxPosition}). Clamping to ${maxPosition}.`);
+            newPosition = maxPosition;
+        }
         const updated = await this.storage.reorderPhase(phaseId, newPosition);
         if (phase.position === updated.position) {
             this.log(styles.muted(`Phase "${updated.name}" is already at position ${updated.position}`));

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

@@ -48,7 +48,7 @@ export default class PhaseTemplateApply extends PMOCommand {
         if (!templateId) {
             const templates = await this.storage.listPhaseTemplates();
             if (templates.length === 0) {
-                return handleError('NO_TEMPLATES', `No phase templates found.\nCreate one with: prlt phase template create "Template Name"`);
+                return handleError('NO_TEMPLATES', `No phase templates found.\nCreate one with: prlt template phase create "Template Name"`);
             }
             const { selectedTemplate } = await inquirer.prompt([{
                     type: 'list',
@@ -64,7 +64,7 @@ export default class PhaseTemplateApply extends PMOCommand {
         // Verify template exists
         const template = await this.storage.getPhaseTemplate(templateId);
         if (!template) {
-            return handleError('TEMPLATE_NOT_FOUND', `Phase template not found: ${templateId}. Run 'prlt phase template list' to see available templates.`);
+            return handleError('TEMPLATE_NOT_FOUND', `Phase template not found: ${templateId}. Run 'prlt template phase list' to see available templates.`);
         }
         // Check if workspace has existing phases
         const existingPhases = await this.storage.listPhases();

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

@@ -32,8 +32,8 @@ export default class PhaseTemplateCreate extends PMOCommand {
         const jsonMode = shouldOutputJson(flags);
         // Build base command with positional arg if name provided
         const baseCmd = args.name
-            ? `prlt phase template create "${args.name}"`
-            : 'prlt phase template create';
+            ? `prlt template phase create "${args.name}"`
+            : 'prlt template phase create';
         // Use FlagResolver for unified JSON mode and interactive handling
         const resolver = new FlagResolver({
             commandName: 'phase template create',
@@ -54,11 +54,11 @@ export default class PhaseTemplateCreate extends PMOCommand {
                 message: 'Template name:',
                 validate: (value) => value.length > 0 || 'Name is required',
                 context: {
-                    hint: 'Provide name with: prlt phase template create "Template Name"',
-                    example: 'prlt phase template create "My Phases" --description "Custom phases"',
+                    hint: 'Provide name with: prlt template phase create "Template Name"',
+                    example: 'prlt template phase create "My Phases" --description "Custom phases"',
                 },
                 // For input prompts, the agent will re-run with the positional arg
-                getCommand: (value) => `prlt phase template create "${value}" --json`,
+                getCommand: (value) => `prlt template phase create "${value}" --json`,
             });
         }
         // Description prompt - optional (only in interactive mode without --json)
@@ -75,7 +75,7 @@ export default class PhaseTemplateCreate extends PMOCommand {
         const templateName = args.name || resolved.name;
         // Validate required fields
         if (!templateName) {
-            this.error('Name is required. Provide as positional argument: prlt phase template create "Template Name"');
+            this.error('Name is required. Provide as positional argument: prlt template phase create "Template Name"');
         }
         // Get description from flags or resolved
         const description = flags.description ?? resolved.description ?? undefined;

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

@@ -62,7 +62,7 @@ export default class PhaseTemplateList extends PMOCommand {
             }
         }
         this.log('');
-        this.log(styles.muted('Apply a template: prlt phase template apply <template-id>'));
+        this.log(styles.muted('Apply a template: prlt template phase apply <template-id>'));
         this.log('');
     }
     printTemplate(template) {

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/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/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/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',

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/update.js

@@ -7,10 +7,10 @@ import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/
 export default class TicketUpdate extends PMOCommand {
     static description = 'Update priority/category for ticket(s)';
     static examples = [
-        '<%= config.bin %> <%= command.id %> TKT-001 --priority HIGH',
+        '<%= config.bin %> <%= command.id %> TKT-001 --priority P1',
         '<%= config.bin %> <%= command.id %> TKT-001 --category bug',
         '<%= config.bin %> <%= command.id %> --bulk',
-        '<%= config.bin %> <%= command.id %> --bulk --priority HIGH',
+        '<%= config.bin %> <%= command.id %> --bulk --priority P1',
         '<%= config.bin %> <%= command.id %> --json  # Output choices as JSON',
     ];
     static args = {