@proletariat/cli 0.2.0 → 0.3.0

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

@@ -0,0 +1,14 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class Staff extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-interactive': 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>;
+}

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

@@ -0,0 +1,90 @@
+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';
+export default class Staff extends PMOCommand {
+    static description = 'Manage staff (persistent) agents';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> list',
+        '<%= config.bin %> <%= command.id %> add',
+        '<%= config.bin %> <%= command.id %> remove camry',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+        'no-interactive': Flags.boolean({
+            description: 'Alias for --json flag',
+            default: false,
+        }),
+    };
+    getPMOOptions() {
+        return { promptIfMultiple: false };
+    }
+    async execute() {
+        const { flags } = await this.parse(Staff);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Define choices once, use for both JSON and interactive modes
+        const menuChoices = [
+            { name: 'List staff agents', value: 'list' },
+            { name: 'Add staff agent', value: 'add' },
+            { name: 'Remove staff agent', value: 'remove' },
+            { name: 'Cancel', value: 'cancel' },
+        ];
+        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));
+            return;
+        }
+        this.log(colors.primary('Staff Agents'));
+        this.log(colors.textMuted('Persistent agents with dedicated worktrees.\n'));
+        const { action } = await inquirer.prompt([{
+                type: 'list',
+                name: 'action',
+                message,
+                choices: [
+                    { name: '📋 ' + menuChoices[0].name, value: menuChoices[0].value },
+                    { name: '➕ ' + menuChoices[1].name, value: menuChoices[1].value },
+                    { name: '🗑️  ' + menuChoices[2].name, value: menuChoices[2].value },
+                    new inquirer.Separator(),
+                    { name: '❌ ' + menuChoices[3].name, value: menuChoices[3].value },
+                ]
+            }]);
+        if (action === 'cancel') {
+            this.log(colors.textMuted('Operation cancelled.'));
+            return;
+        }
+        try {
+            switch (action) {
+                case 'list': {
+                    const { default: ListCommand } = await import('./list.js');
+                    const cmd = new ListCommand([], this.config);
+                    await cmd.run();
+                    break;
+                }
+                case 'add': {
+                    const { default: AddCommand } = await import('./add.js');
+                    const cmd = new AddCommand([], this.config);
+                    await cmd.run();
+                    break;
+                }
+                case 'remove': {
+                    const { default: RemoveCommand } = await import('./remove.js');
+                    const cmd = new RemoveCommand([], this.config);
+                    await cmd.run();
+                    break;
+                }
+                default:
+                    this.error(`Unknown action: ${action}`);
+            }
+        }
+        catch (error) {
+            this.error(`Failed to execute staff ${action}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}

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

@@ -0,0 +1,7 @@
+import { Command } from '@oclif/core';
+export default class List extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {};
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,90 @@
+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';
+export default class List extends Command {
+    static description = 'List all staff (persistent) agents and their status';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+    ];
+    static flags = {};
+    async run() {
+        try {
+            // Get workspace information
+            const workspaceInfo = getWorkspaceInfo();
+            // 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"'));
+                return;
+            }
+            // Get status for all agents and filter to staff
+            const agentsStatus = getAllAgentsStatus(workspaceInfo);
+            const staffStatus = agentsStatus.filter(a => staffAgents.some(s => s.name === a.name));
+            this.log(chalk.bold.cyan('\n Staff Agents:\n'));
+            for (const agentStatus of staffStatus) {
+                // Agent info line
+                const statusIcon = agentStatus.exists ? '🟢' : '🔴';
+                const status = agentStatus.exists ? chalk.green('Active') : chalk.red('Missing');
+                this.log(`${statusIcon} ${chalk.bold(agentStatus.name)} - ${status}`);
+                if (agentStatus.exists) {
+                    // Show branch info
+                    if (agentStatus.branch) {
+                        this.log(chalk.cyan(`   Branch: ${agentStatus.branch}`));
+                    }
+                    // Show repository status
+                    if (agentStatus.repositories.length > 0) {
+                        const dirtyRepos = agentStatus.repositories.filter(r => r.status === 'dirty').length;
+                        const reposWithCommits = agentStatus.repositories.filter(r => r.commitsAhead > 0);
+                        let repoStatusText = `${agentStatus.repositories.length} repo(s)`;
+                        if (dirtyRepos > 0) {
+                            repoStatusText += `, ${dirtyRepos} dirty`;
+                        }
+                        if (reposWithCommits.length > 0) {
+                            const commitDetails = reposWithCommits.map(r => `${r.name}(+${r.commitsAhead})`).join(', ');
+                            repoStatusText += `, commits ahead: ${commitDetails}`;
+                        }
+                        this.log(chalk.white(`   Repositories: ${repoStatusText}`));
+                    }
+                    // Show ticket info
+                    if (agentStatus.assignedTickets.length > 0) {
+                        this.log(chalk.blue(`   Current tickets: ${agentStatus.assignedTickets.join(', ')}`));
+                    }
+                    else {
+                        this.log(chalk.white('   No active tickets'));
+                    }
+                    if (agentStatus.completedTickets.length > 0) {
+                        this.log(chalk.white(`   Completed: ${agentStatus.completedTickets.length} ticket(s)`));
+                    }
+                }
+                else {
+                    const agentDir = path.join(workspaceInfo.agentsPath, agentStatus.name);
+                    const dirExists = fs.existsSync(agentDir);
+                    if (dirExists) {
+                        this.log(chalk.red(`   Invalid or broken worktrees`));
+                        this.log(chalk.yellow('   Agent directory exists but worktrees are missing or corrupted'));
+                    }
+                    else {
+                        this.log(chalk.red(`   Agent directory not found`));
+                    }
+                    this.log(chalk.white('   Run "prlt agent staff add" to recreate'));
+                }
+                this.log(''); // Empty line between agents
+            }
+            // Summary
+            const activeCount = staffStatus.filter(a => a.exists).length;
+            const totalAssignedTickets = staffStatus.reduce((sum, a) => sum + a.assignedTickets.length, 0);
+            this.log(chalk.bold(`Summary:`));
+            this.log(`   Total staff agents: ${staffAgents.length}`);
+            this.log(`   Active: ${activeCount}`);
+            this.log(`   Inactive: ${staffAgents.length - activeCount}`);
+            if (workspaceInfo.hasPMO) {
+                this.log(`   Tickets assigned: ${totalAssignedTickets}`);
+            }
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error));
+        }
+    }
+}

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

@@ -0,0 +1,16 @@
+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>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected getPMOOptions(): {
+        promptIfMultiple: boolean;
+    };
+    execute(): Promise<void>;
+}

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

@@ -0,0 +1,137 @@
+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 { 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 = [
+        '<%= config.bin %> <%= command.id %> camry',
+        '<%= config.bin %> <%= command.id %>',
+    ];
+    static args = {
+        name: Args.string({
+            description: 'Agent name to remove',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+    };
+    getPMOOptions() {
+        return { promptIfMultiple: false };
+    }
+    async execute() {
+        const { args, flags } = await this.parse(Remove);
+        // 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 remove', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        };
+        // Get workspace information
+        const workspaceInfo = getWorkspaceInfo();
+        if (workspaceInfo.agents.length === 0) {
+            if (jsonMode) {
+                outputErrorAsJson('NO_AGENTS', 'No agents to remove.', createMetadata('agent remove', flags));
+                return;
+            }
+            this.log(colors.warning('No agents to remove.'));
+            return;
+        }
+        let agentName = args.name;
+        // Interactive mode if no agent specified
+        if (!agentName) {
+            // Build choices once, use for both JSON and interactive modes
+            const agentChoices = [
+                ...workspaceInfo.agents.map((agent) => ({ name: agent.name, value: agent.name })),
+                { name: 'Cancel', value: 'cancel' },
+            ];
+            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));
+                return;
+            }
+            const { selected } = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'selected',
+                    message: selectMessage,
+                    choices: [
+                        ...agentChoices.slice(0, -1),
+                        new inquirer.Separator(),
+                        { name: '❌ ' + agentChoices[agentChoices.length - 1].name, value: agentChoices[agentChoices.length - 1].value }
+                    ]
+                }
+            ]);
+            if (selected === 'cancel') {
+                this.log(colors.textMuted('Operation cancelled.'));
+                return;
+            }
+            agentName = selected;
+        }
+        // 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(', ')}`);
+        }
+        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"
+            }
+        ]);
+        if (!confirm) {
+            this.log(colors.textMuted('Removal cancelled.'));
+            return;
+        }
+        // Remove agents
+        this.log(colors.primary(`Removing agent "${agentName}"...`));
+        const { removed, failed } = await removeAgentsFromWorkspace(workspaceInfo, agentsToRemove);
+        // Show results for each agent
+        for (const agentName of agentsToRemove) {
+            if (removed.includes(agentName)) {
+                this.log(format.success(`Agent ${agentName} removed`));
+            }
+            else if (failed.includes(agentName)) {
+                this.log(format.error(`Failed to remove agent ${agentName}`));
+            }
+        }
+        // Summary
+        if (removed.length > 0) {
+            this.log(format.success(`\nSuccessfully removed ${removed.length} agent(s): ${removed.join(', ')}`));
+        }
+        if (failed.length > 0) {
+            this.log(format.error(`\nFailed to remove ${failed.length} agent(s): ${failed.join(', ')}`));
+        }
+    }
+}

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

@@ -0,0 +1,17 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class Status 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>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected getPMOOptions(): {
+        promptIfMultiple: boolean;
+    };
+    execute(): Promise<void>;
+    private showDetailedStatus;
+}

package/dist/commands/agent/status.js

@@ -0,0 +1,139 @@
+import { Args, Flags } from '@oclif/core';
+import inquirer from 'inquirer';
+import { colors, format } from '../../lib/colors.js';
+import { getWorkspaceInfo, getAgentStatus } 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 Status extends PMOCommand {
+    static description = 'Show detailed status for a specific agent';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> agent-1',
+        '<%= config.bin %> <%= command.id %>',
+    ];
+    static args = {
+        name: Args.string({
+            description: 'Agent name for detailed status',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
+    };
+    getPMOOptions() {
+        return { promptIfMultiple: false };
+    }
+    async execute() {
+        const { args, flags } = await this.parse(Status);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Get workspace information
+        const workspaceInfo = getWorkspaceInfo();
+        if (workspaceInfo.agents.length === 0) {
+            if (jsonMode) {
+                outputErrorAsJson('NO_AGENTS', 'No agents found. Add agents with "prlt agent add"', createMetadata('agent status', flags));
+                return;
+            }
+            this.log(colors.warning('No agents found. Add agents with "prlt agent add"'));
+            return;
+        }
+        let agentName = args.name;
+        // 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 view status:', agentChoices), createMetadata('agent status', flags));
+                return;
+            }
+            const { selected } = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'selected',
+                    message: 'Select agent to view status:',
+                    choices: workspaceInfo.agents.map((agent) => ({
+                        name: agent.name,
+                        value: agent.name
+                    }))
+                }
+            ]);
+            agentName = selected;
+        }
+        await this.showDetailedStatus(workspaceInfo, agentName);
+    }
+    async showDetailedStatus(workspaceInfo, agentName) {
+        // 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(', ')}`);
+        }
+        const agentStatus = getAgentStatus(workspaceInfo, agentName);
+        this.log(format.title(`🤖 Agent: ${agentName}`));
+        // Basic status
+        const statusIcon = agentStatus.exists ? '🟢' : '🔴';
+        const status = agentStatus.exists ? colors.active('Active') : colors.inactive('Missing');
+        this.log(`${statusIcon} Status: ${status}`);
+        if (!agentStatus.exists) {
+            this.log(colors.error('   Agent directory not found'));
+            this.log(colors.textSecondary('   Run "prlt agent add" to recreate'));
+            return;
+        }
+        // Location
+        this.log(`📍 Location: ${colors.path(`${workspaceInfo.agentsPath}/${agentName}`)}`);
+        // Branch info
+        if (agentStatus.branch) {
+            this.log(`🌿 Branch: ${colors.warning(agentStatus.branch)}`);
+        }
+        // Repository status
+        this.log(format.subtitle('\n📁 Repositories:'));
+        if (agentStatus.repositories.length === 0) {
+            this.log(colors.textMuted('   No repositories configured'));
+        }
+        else {
+            for (const repo of agentStatus.repositories) {
+                let statusText = '';
+                let statusColor = colors.textMuted;
+                switch (repo.status) {
+                    case 'clean':
+                        statusText = 'clean';
+                        statusColor = colors.repoClean;
+                        break;
+                    case 'dirty':
+                        statusText = 'dirty';
+                        statusColor = colors.repoDirty;
+                        break;
+                    case 'missing':
+                        statusText = 'missing';
+                        statusColor = colors.repoMissing;
+                        break;
+                    default:
+                        statusText = repo.status;
+                        statusColor = colors.textMuted;
+                }
+                let repoLine = `   • ${colors.text(repo.name)} (${statusColor(statusText)})`;
+                if (repo.commitsAhead > 0) {
+                    repoLine += colors.commitsAhead(` ${repo.commitsAhead} commits ahead`);
+                }
+                this.log(repoLine);
+            }
+        }
+        // Ticket assignments
+        if (workspaceInfo.hasPMO) {
+            this.log(format.subtitle('\n🎫 Tickets:'));
+            if (agentStatus.assignedTickets.length === 0 && agentStatus.completedTickets.length === 0) {
+                this.log(colors.textSecondary('   No tickets assigned'));
+            }
+            else {
+                if (agentStatus.assignedTickets.length > 0) {
+                    this.log(`   Active: ${colors.primary(agentStatus.assignedTickets.join(', '))}`);
+                }
+                if (agentStatus.completedTickets.length > 0) {
+                    this.log(`   Completed: ${colors.textMuted(agentStatus.completedTickets.length + ' ticket(s)')}`);
+                }
+            }
+        }
+    }
+}

package/dist/commands/agent/temp/cleanup.d.ts

@@ -0,0 +1,23 @@
+import { PMOCommand } from '../../../lib/pmo/index.js';
+export default class Cleanup extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        temp: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        push: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-interactive': 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>;
+}