@proletariat/cli 0.3.17 → 0.3.18

package/dist/commands/agent/auth.js

@@ -2,6 +2,7 @@ import { Command, Flags } from '@oclif/core';
 import { execSync, spawnSync } from 'node:child_process';
 import { colors } from '../../lib/colors.js';
 import { isDockerRunning } from '../../lib/execution/runners.js';
+import { shouldOutputJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 const CLAUDE_CREDENTIALS_VOLUME = 'claude-credentials';
 export default class Auth extends Command {
     static description = 'Set up Claude Code authentication for Docker containers (one-time setup)';
@@ -19,6 +20,16 @@ export default class Auth extends Command {
             description: 'Force re-authentication even if credentials exist',
             default: false,
         }),
+        machine: Flags.boolean({
+            char: 'm',
+            description: 'Output as JSON for AI agents/scripts (machine-readable mode)',
+            default: false,
+        }),
+        json: Flags.boolean({
+            description: 'Output as JSON (deprecated, use --machine)',
+            default: false,
+            hidden: true,
+        }),
     };
     /**
      * Check if the claude-credentials volume exists
@@ -116,21 +127,36 @@ export default class Auth extends Command {
     }
     async run() {
         const { flags } = await this.parse(Auth);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
         // Check Docker is running
         if (!isDockerRunning()) {
+            if (jsonMode) {
+                outputErrorAsJson('DOCKER_NOT_RUNNING', 'Docker is not running. Please start Docker Desktop and try again.', createMetadata('agent auth', flags));
+            }
             this.error('Docker is not running. Please start Docker Desktop and try again.');
         }
         // Ensure volume exists
         if (!this.volumeExists()) {
-            this.log(colors.textSecondary(`Creating Docker volume: ${CLAUDE_CREDENTIALS_VOLUME}`));
+            if (!jsonMode) {
+                this.log(colors.textSecondary(`Creating Docker volume: ${CLAUDE_CREDENTIALS_VOLUME}`));
+            }
             this.createVolume();
         }
         // Check for existing credentials
         const hasCredentials = this.credentialsExist();
+        const info = hasCredentials ? this.getCredentialInfo() : null;
         if (flags.check) {
             // Just report status
             if (hasCredentials) {
-                const info = this.getCredentialInfo();
+                if (jsonMode) {
+                    outputSuccessAsJson({
+                        authenticated: true,
+                        subscriptionType: info?.subscriptionType || 'unknown',
+                        expiresAt: info?.expiresAt.toISOString(),
+                    }, createMetadata('agent auth', flags));
+                    return;
+                }
                 this.log(colors.success('✓ Claude Code credentials are configured'));
                 if (info) {
                     this.log(colors.textSecondary(`  Subscription: ${info.subscriptionType || 'unknown'}`));
@@ -138,6 +164,9 @@ export default class Auth extends Command {
                 }
             }
             else {
+                if (jsonMode) {
+                    outputErrorAsJson('NO_CREDENTIALS', 'No Claude Code credentials found. Run "prlt agent auth" to authenticate.', createMetadata('agent auth', flags));
+                }
                 this.log(colors.warning('✗ No Claude Code credentials found'));
                 this.log(colors.textSecondary('  Run "prlt agent auth" to authenticate'));
                 this.exit(1);
@@ -145,7 +174,15 @@ export default class Auth extends Command {
             return;
         }
         if (hasCredentials && !flags.force) {
-            const info = this.getCredentialInfo();
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    authenticated: true,
+                    subscriptionType: info?.subscriptionType || 'unknown',
+                    expiresAt: info?.expiresAt.toISOString(),
+                    message: 'Credentials already configured. Use --force to re-authenticate.',
+                }, createMetadata('agent auth', flags));
+                return;
+            }
             this.log(colors.success('✓ Claude Code credentials already configured'));
             if (info) {
                 this.log(colors.textSecondary(`  Subscription: ${info.subscriptionType || 'unknown'}`));
@@ -155,6 +192,10 @@ export default class Auth extends Command {
             this.log(colors.text('Use --force to re-authenticate.'));
             return;
         }
+        // JSON mode cannot handle interactive login flow
+        if (jsonMode) {
+            outputErrorAsJson('INTERACTIVE_REQUIRED', 'Authentication requires interactive login. Run without --json flag to authenticate.', createMetadata('agent auth', flags));
+        }
         // Run the login flow
         const success = this.runLoginFlow();
         if (success && this.credentialsExist()) {

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

@@ -4,6 +4,8 @@ export default class Discover extends Command {
     static examples: string[];
     static flags: {
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/agent/discover.js

@@ -2,6 +2,7 @@ import { Command, Flags } from '@oclif/core';
 import chalk from 'chalk';
 import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { discoverAgentsOnDisk } from '../../lib/database/index.js';
+import { shouldOutputJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class Discover extends Command {
     static description = 'Discover agents on disk that are not registered in the database';
     static examples = [
@@ -13,16 +14,44 @@ export default class Discover extends Command {
             description: 'Show what would be discovered without making changes',
             default: false,
         }),
+        machine: Flags.boolean({
+            char: 'm',
+            description: 'Output as JSON for AI agents/scripts (machine-readable mode)',
+            default: false,
+        }),
+        json: Flags.boolean({
+            description: 'Output as JSON (deprecated, use --machine)',
+            default: false,
+            hidden: true,
+        }),
     };
     async run() {
         const { flags } = await this.parse(Discover);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
         try {
             const workspaceInfo = getWorkspaceInfo();
-            this.log(chalk.bold('\n🔍 Agent Discovery\n'));
-            if (flags['dry-run']) {
-                this.log(chalk.yellow('Dry run mode - no changes will be made\n'));
+            if (!jsonMode) {
+                this.log(chalk.bold('\n🔍 Agent Discovery\n'));
+                if (flags['dry-run']) {
+                    this.log(chalk.yellow('Dry run mode - no changes will be made\n'));
+                }
             }
             const result = discoverAgentsOnDisk(workspaceInfo.path);
+            // JSON mode - output structured result
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    discovered: result.discovered.map(agent => ({
+                        name: agent.name,
+                        type: agent.type === 'persistent' ? 'staff' : 'temp',
+                        path: agent.path,
+                    })),
+                    cleaned: result.cleaned,
+                    inSync: result.discovered.length === 0 && result.cleaned.length === 0,
+                    dryRun: flags['dry-run'],
+                }, createMetadata('agent discover', flags));
+                return;
+            }
             // Report discovered agents
             if (result.discovered.length > 0) {
                 this.log(chalk.green.bold(`✅ Discovered ${result.discovered.length} new agent(s):\n`));
@@ -61,6 +90,9 @@ export default class Discover extends Command {
             }
         }
         catch (error) {
+            if (jsonMode) {
+                outputErrorAsJson('DISCOVER_FAILED', error instanceof Error ? error.message : String(error), createMetadata('agent discover', flags));
+            }
             this.error(error instanceof Error ? error.message : String(error));
         }
     }

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

@@ -4,6 +4,7 @@ export default class Agent 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/agent/index.js

@@ -1,8 +1,7 @@
 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, } from '../../lib/prompt-json.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 export default class Agent extends PMOCommand {
     static description = 'Manage agents in the workspace';
     static examples = [
@@ -31,62 +30,37 @@ export default class Agent extends PMOCommand {
         const { flags } = await this.parse(Agent);
         // Check if JSON output mode is active
         const jsonMode = shouldOutputJson(flags);
-        // Define choices for JSON mode (flat list with commands)
-        const menuChoices = [
-            { id: 'list', name: 'List all agents', command: 'prlt agent list --format json' },
-            { id: 'status', name: 'Show status', command: 'prlt agent status --json' },
-            { id: 'visit', name: 'Visit directory', command: 'prlt agent visit --json' },
-            { id: 'staff', name: 'Manage staff agents', command: 'prlt agent staff --json' },
-            { id: 'temp', name: 'Manage temp agents', command: 'prlt agent temp --json' },
-            { id: 'themes', name: 'Manage themes', command: 'prlt agent themes --json' },
-            { id: 'shell', name: 'Open shell', command: 'prlt agent shell --json' },
-            { id: 'restart', name: 'Restart', command: 'prlt agent restart --json' },
-            { id: 'rebuild', name: 'Rebuild', command: 'prlt agent rebuild --json' },
-            { id: 'discover', name: 'Discover agents on disk', command: 'prlt agent discover' },
-            { id: 'cancel', name: 'Cancel', command: '' },
-        ];
-        const message = 'What would you like to do?';
         this.log(colors.primary('🤖 Agent Management'));
         this.log('');
         this.log(colors.textMuted('Note: Agent pre-registration is no longer required!'));
         this.log(colors.textMuted('Use "prlt work spawn" to create ephemeral agents automatically.'));
         this.log('');
-        // In JSON mode, output flat list with commands
-        if (jsonMode) {
-            outputPromptAsJson({
+        // Agent mode config for prompts
+        const agentConfig = jsonMode ? { flags, commandName: 'agent' } : null;
+        // Use agentPrompt for unified JSON/interactive handling
+        const { action } = await this.prompt([{
                 type: 'list',
                 name: 'action',
-                message,
-                choices: menuChoices.map(c => ({ name: c.name, value: c.id, command: c.command })),
-            }, createMetadata('agent', flags));
-            return;
-        }
-        // Interactive mode with separators for logical groupings
-        const { action } = await inquirer.prompt([{
-                type: 'list',
-                name: 'action',
-                message,
+                message: 'What would you like to do?',
                 choices: [
                     // View/Info group
-                    { name: '📋 List all agents', value: 'list' },
-                    { name: '📊 Show status', value: 'status' },
-                    { name: '📂 Visit directory', value: 'visit' },
-                    new inquirer.Separator(),
+                    { name: '📋 List all agents', value: 'list', command: 'prlt agent list --machine' },
+                    { name: '📊 Show status', value: 'status', command: 'prlt agent status --machine' },
+                    { name: '📂 Visit directory', value: 'visit', command: 'prlt agent visit --machine' },
+                    { name: '🗑️  Remove agent', value: 'remove', command: 'prlt agent remove --machine' },
                     // Management group
-                    { name: '👔 Manage staff agents', value: 'staff' },
-                    { name: '⏱️  Manage temp agents', value: 'temp' },
-                    { name: '🎨 Manage themes', value: 'themes' },
-                    new inquirer.Separator(),
+                    { name: '👔 Manage staff agents', value: 'staff', command: 'prlt agent staff --machine' },
+                    { name: '⏱️  Manage temp agents', value: 'temp', command: 'prlt agent temp --machine' },
+                    { name: '🎨 Manage themes', value: 'themes', command: 'prlt agent themes --machine' },
                     // Operations group
-                    { name: '🐚 Open shell', value: 'shell' },
-                    { name: '🔄 Restart', value: 'restart' },
-                    { name: '🔨 Rebuild', value: 'rebuild' },
-                    { name: '🔍 Discover agents on disk', value: 'discover' },
-                    new inquirer.Separator(),
+                    { name: '🐚 Open shell', value: 'shell', command: 'prlt agent shell --machine' },
+                    { name: '🔄 Restart', value: 'restart', command: 'prlt agent restart --machine' },
+                    { name: '🔨 Rebuild', value: 'rebuild', command: 'prlt agent rebuild --machine' },
+                    { name: '🔍 Discover agents on disk', value: 'discover', command: 'prlt agent discover --machine' },
                     // Cancel
-                    { name: '❌ Cancel', value: 'cancel' },
+                    { name: '❌ Cancel', value: 'cancel', command: '' },
                 ],
-            }]);
+            }], agentConfig);
         if (action === 'cancel') {
             this.log(colors.textMuted('Operation cancelled.'));
             return;
@@ -113,6 +87,12 @@ export default class Agent extends PMOCommand {
                     await cmd.run();
                     break;
                 }
+                case 'remove': {
+                    const { default: RemoveCommand } = await import('./remove.js');
+                    const cmd = new RemoveCommand([], this.config);
+                    await cmd.run();
+                    break;
+                }
                 case 'staff': {
                     const { default: StaffCommand } = await import('./staff/index.js');
                     const cmd = new StaffCommand([], this.config);

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

@@ -1,10 +1,15 @@
-import { Command } from '@oclif/core';
-export default class List extends Command {
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class List extends PMOCommand {
     static description: string;
     static examples: string[];
     static flags: {
         type: 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>;
     };
-    run(): Promise<void>;
+    protected getPMOOptions(): {
+        promptIfMultiple: boolean;
+    };
+    execute(): Promise<void>;
 }

package/dist/commands/agent/list.js

@@ -1,11 +1,11 @@
-import { Command, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
 import chalk from 'chalk';
-import inquirer from 'inquirer';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
 import { getWorkspaceInfo, getAllAgentsStatus, getAgentTmuxSessions } from '../../lib/agents/commands.js';
-import { shouldOutputJson, outputPromptAsJson, createMetadata, } from '../../lib/prompt-json.js';
-export default class List extends Command {
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
+export default class List extends PMOCommand {
     static description = 'List all agents and their current status';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
@@ -13,20 +13,22 @@ export default class List extends Command {
         '<%= config.bin %> <%= command.id %> --type temp',
     ];
     static flags = {
+        ...pmoBaseFlags,
         type: Flags.string({
             char: 't',
             description: 'Filter by agent type',
             options: ['staff', 'temp', 'all'],
         }),
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
     };
-    async run() {
+    getPMOOptions() {
+        return { promptIfMultiple: false };
+    }
+    async execute() {
         try {
             const { flags } = await this.parse(List);
             const jsonMode = shouldOutputJson(flags);
+            // Agent mode config for prompts
+            const agentConfig = jsonMode ? { flags, commandName: 'agent list' } : null;
             // Get workspace information
             const workspaceInfo = getWorkspaceInfo();
             // Filter to active agents only
@@ -34,31 +36,16 @@ export default class List extends Command {
             // Determine type filter - prompt if not provided
             let typeFilter = flags.type;
             if (!typeFilter) {
-                // In JSON mode, output type selection prompt
-                if (jsonMode) {
-                    outputPromptAsJson({
-                        type: 'list',
-                        name: 'type',
-                        message: 'Which agents do you want to list?',
-                        choices: [
-                            { name: 'All agents', value: 'all', command: 'prlt agent list --type all --json' },
-                            { name: 'Staff agents only', value: 'staff', command: 'prlt agent list --type staff --json' },
-                            { name: 'Temp agents only', value: 'temp', command: 'prlt agent list --type temp --json' },
-                        ],
-                    }, createMetadata('agent list', flags));
-                    return;
-                }
-                // Interactive mode - prompt for type
-                const { selectedType } = await inquirer.prompt([{
+                const { selectedType } = await this.prompt([{
                         type: 'list',
                         name: 'selectedType',
                         message: 'Which agents do you want to list?',
                         choices: [
-                            { name: '📋 All agents', value: 'all' },
-                            { name: '👔 Staff agents only', value: 'staff' },
-                            { name: '⏱️  Temp agents only', value: 'temp' },
+                            { name: '📋 All agents', value: 'all', command: 'prlt agent list --type all --machine' },
+                            { name: '👔 Staff agents only', value: 'staff', command: 'prlt agent list --type staff --machine' },
+                            { name: '⏱️  Temp agents only', value: 'temp', command: 'prlt agent list --type temp --machine' },
                         ],
-                    }]);
+                    }], agentConfig);
                 typeFilter = selectedType;
             }
             // Filter agents based on type selection

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

@@ -7,6 +7,7 @@ export default class Login extends PMOCommand {
     };
     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/agent/login.js

@@ -2,12 +2,11 @@ import { Args, Flags } from '@oclif/core';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
 import { execSync } from 'node:child_process';
-import inquirer from 'inquirer';
 import { colors } from '../../lib/colors.js';
 import { getWorkspaceInfo } 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, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class Login extends PMOCommand {
     static description = 'Authenticate Claude Code inside an agent container (one-time setup)';
     static examples = [
@@ -34,17 +33,11 @@ export default class Login extends PMOCommand {
         const { args, flags } = await this.parse(Login);
         // Check if JSON output mode is active
         const jsonMode = shouldOutputJson(flags);
-        // Helper to handle errors in JSON mode
-        const handleError = (code, message) => {
-            if (jsonMode) {
-                outputErrorAsJson(code, message, createMetadata('agent login', flags));
-                this.exit(1);
-            }
-            this.error(message);
-        };
+        // Error handling config
+        const errorConfig = { jsonMode, commandName: 'agent login', flags };
         // Check Docker is running
         if (!isDockerRunning()) {
-            return handleError('DOCKER_NOT_RUNNING', 'Docker is not running. Please start Docker Desktop and try again.');
+            this.handleError('DOCKER_NOT_RUNNING', 'Docker is not running. Please start Docker Desktop and try again.', errorConfig);
         }
         // Get workspace information
         const workspaceInfo = getWorkspaceInfo();
@@ -57,38 +50,27 @@ export default class Login extends PMOCommand {
             return;
         }
         let agentName = args.name;
+        // Agent mode config for prompts
+        const agentConfig = jsonMode ? { flags, commandName: 'agent login' } : null;
         // Interactive mode if no agent specified
         if (!agentName) {
-            // In JSON mode, output agent selection prompt
-            if (jsonMode) {
-                const agentChoices = workspaceInfo.agents.map((agent) => ({ name: agent.name, value: agent.name }));
-                outputPromptAsJson(buildPromptConfig('list', 'name', 'Select agent to authenticate:', agentChoices), createMetadata('agent login', flags));
-                return;
-            }
             // Group agents by type
             const staffAgents = workspaceInfo.agents.filter(a => a.type === 'persistent');
             const tempAgents = workspaceInfo.agents.filter(a => a.type === 'ephemeral');
+            // Build choices with command field for JSON mode
             const choices = [];
-            if (staffAgents.length > 0) {
-                choices.push(new inquirer.Separator('── Staff Agents ──'));
-                for (const agent of staffAgents) {
-                    choices.push({ name: `👔 ${agent.name}`, value: agent.name });
-                }
+            for (const agent of staffAgents) {
+                choices.push({ name: `👔 ${agent.name}`, value: agent.name, command: `prlt agent login ${agent.name} --machine` });
             }
-            if (tempAgents.length > 0) {
-                choices.push(new inquirer.Separator('── Temp Agents ──'));
-                for (const agent of tempAgents) {
-                    choices.push({ name: `⏱️  ${agent.name}`, value: agent.name });
-                }
+            for (const agent of tempAgents) {
+                choices.push({ name: `⏱️  ${agent.name}`, value: agent.name, command: `prlt agent login ${agent.name} --machine` });
             }
-            const { selected } = await inquirer.prompt([
-                {
+            const { selected } = await this.prompt([{
                     type: 'list',
                     name: 'selected',
                     message: 'Select agent to authenticate:',
-                    choices
-                }
-            ]);
+                    choices,
+                }], agentConfig);
             agentName = selected;
         }
         // Validate agent exists

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

@@ -8,6 +8,7 @@ export default class AgentRebuild extends PMOCommand {
     static flags: {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'no-cache': 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/agent/rebuild.js

@@ -15,7 +15,7 @@ export default class AgentRebuild extends PMOCommand {
         '<%= config.bin %> <%= command.id %> altman',
         '<%= config.bin %> <%= command.id %> altman --no-cache',
         '<%= config.bin %> <%= command.id %>  # Interactive selection',
-        '<%= config.bin %> <%= command.id %> --json  # JSON mode for AI agents',
+        '<%= config.bin %> <%= command.id %> --machine  # JSON mode for AI agents',
     ];
     static args = {
         name: Args.string({
@@ -66,7 +66,7 @@ export default class AgentRebuild extends PMOCommand {
                 items: agents,
                 getName: (a) => a.name,
                 getValue: (a) => a.name,
-                getCommand: (a) => `prlt agent rebuild ${a.name} --json`,
+                getCommand: (a) => `prlt agent rebuild ${a.name} --machine`,
                 jsonMode: jsonMode ? { flags, commandName: 'agent rebuild' } : null,
             });
             if (!selected) {

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

@@ -0,0 +1,17 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class Remove extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    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(): {
+        promptIfMultiple: boolean;
+    };
+    execute(): Promise<void>;
+}