@proletariat/cli 0.3.22 → 0.3.24

package/dist/commands/project/create.js

@@ -5,7 +5,7 @@ import inquirer from 'inquirer';
 import { createBoardContent, createSpecFolders, PMOCommand, pmoBaseFlags, BUILTIN_TEMPLATES } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
 import { slugify } from '../../lib/pmo/utils.js';
-import { shouldOutputJson, outputPromptAsJson, outputSuccessAsJson, createMetadata, buildFormPromptConfig, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputPromptAsJson, outputSuccessAsJson, outputDryRunSuccessAsJson, outputDryRunErrorsAsJson, createMetadata, buildFormPromptConfig, } from '../../lib/prompt-json.js';
 // Build template options dynamically from shared definitions
 const TEMPLATE_IDS = BUILTIN_TEMPLATES.map(t => t.id);
 export default class ProjectCreate extends PMOCommand {
@@ -14,6 +14,7 @@ export default class ProjectCreate extends PMOCommand {
         '<%= config.bin %> <%= command.id %> "My New Project"',
         '<%= config.bin %> <%= command.id %> --name "Mobile App" --description "iOS and Android app"',
         '<%= config.bin %> <%= command.id %> -i  # Interactive mode',
+        '<%= config.bin %> <%= command.id %> --name "Test" --dry-run --json  # Validate without creating',
     ];
     static args = {
         name: Args.string({
@@ -25,7 +26,7 @@ export default class ProjectCreate extends PMOCommand {
         ...pmoBaseFlags,
         name: Flags.string({
             char: 'n',
-            description: 'Project name',
+            description: 'Project name [required for non-interactive]',
         }),
         id: Flags.string({
             description: 'Custom project ID (auto-generated from name if not provided)',
@@ -45,6 +46,10 @@ export default class ProjectCreate extends PMOCommand {
             description: 'Interactive mode',
             default: false,
         }),
+        'dry-run': Flags.boolean({
+            description: 'Validate inputs without creating project (use with --json for structured output)',
+            default: false,
+        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
@@ -86,8 +91,39 @@ export default class ProjectCreate extends PMOCommand {
         // Check if project already exists
         const existing = await this.storage.getProject(projectId);
         if (existing) {
+            if (flags['dry-run']) {
+                if (jsonMode) {
+                    outputDryRunErrorsAsJson([{ field: 'id', error: `Project "${projectId}" already exists` }], createMetadata('project create', flags));
+                }
+            }
             this.error(`Project "${projectId}" already exists.`);
         }
+        // Get the statuses from the workflow (for dry-run preview)
+        const statuses = await this.storage.listStatuses(projectData.template);
+        // Handle dry-run: show what would be created without actually creating
+        if (flags['dry-run']) {
+            const wouldCreate = {
+                id: projectId,
+                name: projectData.name,
+                template: projectData.template,
+                statuses: statuses.map(s => s.name),
+                ...(projectData.description && { description: projectData.description }),
+            };
+            if (jsonMode) {
+                outputDryRunSuccessAsJson('project', wouldCreate, createMetadata('project create', flags));
+            }
+            // Human-readable dry-run output
+            this.log(styles.warning('\n[DRY RUN] Would create project:'));
+            this.log(styles.muted(`   ID: ${projectId}`));
+            this.log(styles.muted(`   Name: ${projectData.name}`));
+            this.log(styles.muted(`   Template: ${projectData.template}`));
+            this.log(styles.muted(`   Statuses: ${statuses.map(s => s.name).join(' → ')}`));
+            if (projectData.description) {
+                this.log(styles.muted(`   Description: ${projectData.description}`));
+            }
+            this.log(styles.muted('\n(No project was created)'));
+            return;
+        }
         // Create project in database
         const project = await this.storage.createProject({
             id: projectId,
@@ -104,8 +140,6 @@ export default class ProjectCreate extends PMOCommand {
         fs.writeFileSync(boardPath, boardContent);
         // Create spec folders in project directory
         const specsPath = createSpecFolders(this.pmoPath, projectId);
-        // Get the statuses from the workflow (template name = workflow ID for built-in templates)
-        const statuses = await this.storage.listStatuses(projectData.template);
         // In JSON mode, output success with project details
         if (jsonMode) {
             outputSuccessAsJson({

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

@@ -11,6 +11,7 @@ export default class SpecCreate extends PMOCommand {
         type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         problem: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         interactive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': 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/create.js

@@ -2,7 +2,7 @@ import { Flags, Args } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
 import { slugify } from '../../lib/pmo/utils.js';
-import { shouldOutputJson } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputDryRunSuccessAsJson, outputDryRunErrorsAsJson, createMetadata, } from '../../lib/prompt-json.js';
 import { FlagResolver } from '../../lib/flags/index.js';
 export default class SpecCreate extends PMOCommand {
     static description = 'Create a new spec';
@@ -10,6 +10,7 @@ export default class SpecCreate extends PMOCommand {
         '<%= config.bin %> <%= command.id %> "User Authentication"',
         '<%= config.bin %> <%= command.id %> --title "API Design" --type product',
         '<%= config.bin %> <%= command.id %> -i  # Interactive mode',
+        '<%= config.bin %> <%= command.id %> --title "Test" --dry-run --json  # Validate without creating',
     ];
     static args = {
         title: Args.string({
@@ -21,7 +22,7 @@ export default class SpecCreate extends PMOCommand {
         ...pmoBaseFlags,
         title: Flags.string({
             char: 't',
-            description: 'Spec title',
+            description: 'Spec title [required for non-interactive]',
         }),
         status: Flags.string({
             char: 's',
@@ -41,6 +42,10 @@ export default class SpecCreate extends PMOCommand {
             description: 'Interactive mode',
             default: false,
         }),
+        'dry-run': Flags.boolean({
+            description: 'Validate inputs without creating spec (use with --json for structured output)',
+            default: false,
+        }),
     };
     async execute() {
         const { args, flags } = await this.parse(SpecCreate);
@@ -108,6 +113,42 @@ export default class SpecCreate extends PMOCommand {
         const specType = resolved.type === '' ? undefined : resolved.type;
         // Generate ID from title
         const specId = slugify(resolved.title);
+        // Check if spec already exists
+        const existing = await this.storage.getSpec(specId);
+        if (existing) {
+            if (flags['dry-run']) {
+                if (jsonMode) {
+                    outputDryRunErrorsAsJson([{ field: 'id', error: `Spec "${specId}" already exists` }], createMetadata('spec create', flags));
+                }
+            }
+            this.error(`Spec "${specId}" already exists.`);
+        }
+        // Handle dry-run: show what would be created without actually creating
+        if (flags['dry-run']) {
+            const wouldCreate = {
+                id: specId,
+                title: resolved.title,
+                status: resolved.status || 'draft',
+                ...(specType && { type: specType }),
+                ...(resolved.problem && { problem: resolved.problem }),
+            };
+            if (jsonMode) {
+                outputDryRunSuccessAsJson('spec', wouldCreate, createMetadata('spec create', flags));
+            }
+            // Human-readable dry-run output
+            this.log(styles.warning('\n[DRY RUN] Would create spec:'));
+            this.log(styles.muted(`   ID: ${specId}`));
+            this.log(styles.muted(`   Title: ${resolved.title}`));
+            this.log(styles.muted(`   Status: ${resolved.status || 'draft'}`));
+            if (specType) {
+                this.log(styles.muted(`   Type: ${specType}`));
+            }
+            if (resolved.problem) {
+                this.log(styles.muted(`   Problem: ${resolved.problem}`));
+            }
+            this.log(styles.muted('\n(No spec was created)'));
+            return;
+        }
         // Create spec in database
         const spec = await this.storage.createSpec({
             id: specId,

package/dist/commands/spec/index.js

@@ -48,7 +48,7 @@ export default class Spec extends PMOCommand {
                     delete: 'prlt spec delete --json',
                     generate: 'prlt spec plan --json',
                     ticket: 'prlt spec ticket --json',
-                    link: 'prlt spec link --json',
+                    link: 'prlt link list --json',
                     cancel: '',
                 };
                 return commands[value] || '';
@@ -80,7 +80,7 @@ export default class Spec extends PMOCommand {
                 await this.config.runCommand('spec:ticket', []);
                 break;
             case 'link':
-                await this.config.runCommand('spec:link', []);
+                await this.config.runCommand('link', []);
                 break;
         }
     }

package/dist/commands/{agent/staff → staff}/add.js

@@ -1,10 +1,10 @@
 import { Command, Args, Flags } from '@oclif/core';
 import chalk from 'chalk';
 import inquirer from 'inquirer';
-import { getWorkspaceInfo, validateAgentNames, addAgentsToWorkspace } from '../../../lib/agents/commands.js';
-import { ensureBuiltinThemes, BUILTIN_THEMES, isValidAgentName, normalizeAgentName } from '../../../lib/themes.js';
-import { getTheme, getThemes, getAvailableThemeNames, getActiveTheme } from '../../../lib/database/index.js';
-import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
+import { getWorkspaceInfo, validateAgentNames, addAgentsToWorkspace } from '../../lib/agents/commands.js';
+import { ensureBuiltinThemes, BUILTIN_THEMES, isValidAgentName, normalizeAgentName } from '../../lib/themes.js';
+import { getTheme, getThemes, getAvailableThemeNames, getActiveTheme } from '../../lib/database/index.js';
+import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
 export default class Add extends Command {
     static description = 'Add new agents to the workspace';
     static examples = [
@@ -58,7 +58,7 @@ export default class Add extends Command {
                 if (!theme) {
                     const available = BUILTIN_THEMES.map(t => t.name).join(', ');
                     if (jsonMode) {
-                        outputErrorAsJson('THEME_NOT_FOUND', `Theme "${flags.theme}" not found. Available: ${available}`, createMetadata('agent add', flags));
+                        outputErrorAsJson('THEME_NOT_FOUND', `Theme "${flags.theme}" not found. Available: ${available}`, createMetadata('staff add', flags));
                         return;
                     }
                     this.error(`Theme "${flags.theme}" not found. Available: ${available}`);
@@ -68,7 +68,7 @@ export default class Add extends Command {
                 const availableNames = getAvailableThemeNames(workspaceInfo.path, themeId);
                 if (availableNames.length === 0) {
                     if (jsonMode) {
-                        outputErrorAsJson('NO_AVAILABLE_NAMES', `No available names in theme "${theme.display_name}". All names are in use.`, createMetadata('agent add', flags));
+                        outputErrorAsJson('NO_AVAILABLE_NAMES', `No available names in theme "${theme.display_name}". All names are in use.`, createMetadata('staff add', flags));
                         return;
                     }
                     this.error(`No available names in theme "${theme.display_name}". All names are in use.`);
@@ -78,7 +78,7 @@ export default class Add extends Command {
                 const selectMessage = `Select agent names from ${theme.display_name}:`;
                 // In JSON mode, output theme names selection prompt
                 if (jsonMode) {
-                    outputPromptAsJson(buildPromptConfig('checkbox', 'names', selectMessage, nameChoices), createMetadata('agent add', flags));
+                    outputPromptAsJson(buildPromptConfig('checkbox', 'names', selectMessage, nameChoices), createMetadata('staff add', flags));
                     return;
                 }
                 // Interactive selection from theme
@@ -103,7 +103,7 @@ export default class Add extends Command {
                     const availableNames = getAvailableThemeNames(workspaceInfo.path, activeTheme.id);
                     if (availableNames.length === 0) {
                         if (jsonMode) {
-                            outputErrorAsJson('NO_AVAILABLE_NAMES', `No available names in ${activeTheme.display_name}. All names are in use.`, createMetadata('agent add', flags));
+                            outputErrorAsJson('NO_AVAILABLE_NAMES', `No available names in ${activeTheme.display_name}. All names are in use.`, createMetadata('staff add', flags));
                             return;
                         }
                         this.log(chalk.yellow(`No available names in ${activeTheme.display_name}. All names are in use.`));
@@ -118,7 +118,7 @@ export default class Add extends Command {
                     const selectMessage = `Select agents from ${activeTheme.display_name}:`;
                     // In JSON mode, output agent names selection prompt
                     if (jsonMode) {
-                        outputPromptAsJson(buildPromptConfig('checkbox', 'names', selectMessage, nameChoices), createMetadata('agent add', flags));
+                        outputPromptAsJson(buildPromptConfig('checkbox', 'names', selectMessage, nameChoices), createMetadata('staff add', flags));
                         return;
                     }
                     // Add separator before custom option for interactive mode
@@ -175,7 +175,7 @@ export default class Add extends Command {
                     const selectMessage = 'No theme set. Select a theme or enter custom names:';
                     // In JSON mode, output theme selection prompt
                     if (jsonMode) {
-                        outputPromptAsJson(buildPromptConfig('list', 'theme', selectMessage, themeChoices), createMetadata('agent add', flags));
+                        outputPromptAsJson(buildPromptConfig('list', 'theme', selectMessage, themeChoices), createMetadata('staff add', flags));
                         return;
                     }
                     // Add separator and styling for interactive mode

package/dist/commands/{agent/staff → staff}/index.d.ts

@@ -1,4 +1,4 @@
-import { PMOCommand } from '../../../lib/pmo/index.js';
+import { PMOCommand } from '../../lib/pmo/index.js';
 export default class Staff extends PMOCommand {
     static description: string;
     static examples: string[];

package/dist/commands/{agent/staff → staff}/index.js

@@ -1,8 +1,8 @@
 import { Flags } from '@oclif/core';
 import inquirer from 'inquirer';
-import { colors } from '../../../lib/colors.js';
-import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
-import { shouldOutputJson, outputPromptAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
+import { colors } from '../../lib/colors.js';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson, outputPromptAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
 export default class Staff extends PMOCommand {
     static description = 'Manage staff (persistent) agents';
     static examples = [
@@ -33,15 +33,15 @@ export default class Staff extends PMOCommand {
         // Define choices once, use for both JSON and interactive modes
         // Include command field for AI agent navigation
         const menuChoices = [
-            { name: 'List staff agents', value: 'list', command: 'prlt agent staff list --machine' },
-            { name: 'Add staff agent', value: 'add', command: 'prlt agent staff add --machine' },
-            { name: 'Remove staff agent', value: 'remove', command: 'prlt agent staff remove --machine' },
+            { name: 'List staff agents', value: 'list', command: 'prlt staff list --machine' },
+            { name: 'Add staff agent', value: 'add', command: 'prlt staff add --machine' },
+            { name: 'Remove staff agent', value: 'remove', command: 'prlt staff remove --machine' },
             { name: 'Cancel', value: 'cancel', command: '' },
         ];
         const message = 'What would you like to do?';
         // In JSON mode, output menu prompt
         if (jsonMode) {
-            outputPromptAsJson(buildPromptConfig('list', 'action', message, menuChoices), createMetadata('agent staff', flags));
+            outputPromptAsJson(buildPromptConfig('list', 'action', message, menuChoices), createMetadata('staff', flags));
             return;
         }
         this.log(colors.primary('Staff Agents'));

package/dist/commands/{agent/staff → staff}/list.js

@@ -2,7 +2,7 @@ import { Command } from '@oclif/core';
 import chalk from 'chalk';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
-import { getWorkspaceInfo, getAllAgentsStatus } from '../../../lib/agents/commands.js';
+import { getWorkspaceInfo, getAllAgentsStatus } from '../../lib/agents/commands.js';
 export default class List extends Command {
     static description = 'List all staff (persistent) agents and their status';
     static examples = [
@@ -16,7 +16,7 @@ export default class List extends Command {
             // Filter to staff agents only
             const staffAgents = workspaceInfo.agents.filter(a => a.type === 'persistent');
             if (staffAgents.length === 0) {
-                this.log(chalk.yellow('No staff agents found. Add staff agents with "prlt agent staff add"'));
+                this.log(chalk.yellow('No staff agents found. Add staff agents with "prlt staff add"'));
                 return;
             }
             // Get status for all agents and filter to staff
@@ -68,7 +68,7 @@ export default class List extends Command {
                     else {
                         this.log(chalk.red(`   Agent directory not found`));
                     }
-                    this.log(chalk.white('   Run "prlt agent staff add" to recreate'));
+                    this.log(chalk.white('   Run "prlt staff add" to recreate'));
                 }
                 this.log(''); // Empty line between agents
             }

package/dist/commands/{agent/staff → staff}/remove.d.ts

@@ -1,4 +1,4 @@
-import { PMOCommand } from '../../../lib/pmo/index.js';
+import { PMOCommand } from '../../lib/pmo/index.js';
 export default class Remove extends PMOCommand {
     static description: string;
     static examples: string[];

package/dist/commands/{agent/staff → staff}/remove.js

@@ -1,9 +1,9 @@
 import { Args, Flags } from '@oclif/core';
 import inquirer from 'inquirer';
-import { colors, format } from '../../../lib/colors.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';
+import { colors, format } from '../../lib/colors.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 {
     static description = 'Remove a specific agent from the workspace';
     static examples = [
@@ -40,7 +40,7 @@ export default class Remove extends PMOCommand {
         // Helper to handle errors in JSON mode
         const handleError = (code, message) => {
             if (jsonMode) {
-                outputErrorAsJson(code, message, createMetadata('agent remove', flags));
+                outputErrorAsJson(code, message, createMetadata('staff remove', flags));
                 this.exit(1);
             }
             this.error(message);
@@ -51,7 +51,7 @@ export default class Remove extends PMOCommand {
         const staffAgents = workspaceInfo.agents.filter(a => a.type === 'persistent');
         if (staffAgents.length === 0) {
             if (jsonMode) {
-                outputErrorAsJson('NO_AGENTS', 'No staff agents to remove.', createMetadata('agent staff remove', flags));
+                outputErrorAsJson('NO_AGENTS', 'No staff agents to remove.', createMetadata('staff remove', flags));
                 return;
             }
             this.log(colors.warning('No staff agents to remove.'));
@@ -68,7 +68,7 @@ export default class Remove extends PMOCommand {
             const selectMessage = 'Select agent to remove:';
             // In JSON mode, output agent selection prompt
             if (jsonMode) {
-                outputPromptAsJson(buildPromptConfig('list', 'name', selectMessage, agentChoices), createMetadata('agent remove', flags));
+                outputPromptAsJson(buildPromptConfig('list', 'name', selectMessage, agentChoices), createMetadata('staff remove', flags));
                 return;
             }
             const { selected } = await inquirer.prompt([
@@ -106,7 +106,7 @@ export default class Remove extends PMOCommand {
             // Confirm removal
             // In JSON mode, output confirmation prompt
             if (jsonMode) {
-                outputPromptAsJson(buildPromptConfig('list', 'confirmed', confirmMessage, confirmChoices), createMetadata('agent remove', flags));
+                outputPromptAsJson(buildPromptConfig('list', 'confirmed', confirmMessage, confirmChoices), createMetadata('staff remove', flags));
                 return;
             }
             const { confirm } = await inquirer.prompt([

package/dist/commands/{ticket/template → template}/apply.d.ts

@@ -1,25 +1,27 @@
-import { PMOCommand } from '../../../lib/pmo/index.js';
-export default class TicketTemplateApply extends PMOCommand {
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class TemplateApply extends PMOCommand {
     static description: string;
     static examples: string[];
     static args: {
         template: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
+        type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         title: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         column: 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>;
         assignee: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         owner: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        labels: 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>;
+        epic: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-subtasks': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         interactive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'no-subtasks': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        epic: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     execute(): Promise<void>;
+    private applyTicketTemplate;
+    private applyPhaseTemplate;
 }