@proletariat/cli 0.3.18 → 0.3.20

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chris McDermut
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/commands/agent/staff/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/staff/remove.js

@@ -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 };
@@ -88,33 +93,36 @@ export default class Remove extends PMOCommand {
             return handleError('AGENT_NOT_FOUND', `Staff agent "${agentName}" not found. Available staff agents: ${staffAgents.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"
+        // 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/temp/cleanup.js

@@ -132,9 +132,16 @@ export default class Cleanup extends PMOCommand {
                 this.log(colors.textMuted('No agents to clean up.'));
                 return;
             }
-            // Separate temp and staff agents
+            // Get temp (ephemeral) agents only - this is temp cleanup, not staff cleanup
             const tempAgents = allAgents.filter(a => a.type === 'ephemeral');
-            const staffAgents = allAgents.filter(a => a.type !== 'ephemeral');
+            if (tempAgents.length === 0) {
+                if (jsonMode) {
+                    outputErrorAsJson('NO_TEMP_AGENTS', 'No temp agents to clean up.', createMetadata('agent cleanup', flags));
+                    return;
+                }
+                this.log(colors.textMuted('No temp agents to clean up.'));
+                return;
+            }
             // Build choices with separators
             const choices = [];
             // Add "All temp agents" option if there are temp agents
@@ -163,21 +170,7 @@ export default class Cleanup extends PMOCommand {
                     });
                 }
             }
-            // Add staff agents
-            if (staffAgents.length > 0) {
-                choices.push(new inquirer.Separator(`── Staff Agents (${staffAgents.length}) ──`));
-                for (const agent of staffAgents) {
-                    const sessions = getAgentTmuxSessions(agent.name);
-                    const hasRunningWork = sessions.length > 0;
-                    const statusLabel = hasRunningWork ? ' (running)' : '';
-                    choices.push({
-                        name: `${agent.name}${statusLabel}`,
-                        value: agent.name,
-                        disabled: hasRunningWork ? 'has running work' : false,
-                    });
-                }
-            }
-            const selectMessage = 'Select agents to clean up:';
+            const selectMessage = 'Select temp agents to clean up:';
             // In JSON mode, output agent selection prompt
             if (jsonMode) {
                 outputPromptAsJson(buildPromptConfig('checkbox', 'agents', selectMessage, choices), createMetadata('agent cleanup', flags));

package/dist/commands/board/view.d.ts

@@ -0,0 +1,15 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class BoardView extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        compact: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+    private renderBoard;
+    private outputTicketCompact;
+    private outputTicketFull;
+}

package/dist/commands/board/view.js

@@ -0,0 +1,136 @@
+import { Flags } from '@oclif/core';
+import { PMOCommand, pmoBaseFlags, } from '../../lib/pmo/index.js';
+import { styles, formatPriority, formatCategory, getColumnStyle, getColumnEmoji, divider, } from '../../lib/styles.js';
+import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
+export default class BoardView extends PMOCommand {
+    static description = 'View the kanban board';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --compact',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+        compact: Flags.boolean({
+            char: 'c',
+            description: 'Show compact ticket view (ID and title only)',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { flags } = await this.parse(BoardView);
+        // Board operations require project context
+        const projectId = await this.requireProject();
+        // 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('board view', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        };
+        const board = await this.storage.getBoard(projectId);
+        if (!board) {
+            return handleError('BOARD_NOT_FOUND', `Board not found for project "${projectId}".`);
+        }
+        // In JSON mode, output board as structured data
+        if (jsonMode) {
+            outputSuccessAsJson({
+                id: board.id,
+                name: board.name,
+                columns: board.columns.map(col => ({
+                    id: col.id,
+                    name: col.name,
+                    position: col.position,
+                    ticketCount: col.tickets.length,
+                    tickets: col.tickets.map(t => ({
+                        id: t.id,
+                        title: t.title,
+                        description: t.description,
+                        priority: t.priority,
+                        category: t.category,
+                        owner: t.owner,
+                        assignee: t.assignee,
+                        specId: t.specId,
+                        epicId: t.epicId,
+                        labels: t.labels,
+                        subtasksDone: t.subtasks.filter((s) => s.done).length,
+                        subtasksTotal: t.subtasks.length,
+                        position: t.position,
+                    })),
+                })),
+                totalTickets: board.columns.reduce((sum, col) => sum + col.tickets.length, 0),
+            }, createMetadata('board view', flags));
+            return;
+        }
+        // Interactive mode - render board to terminal
+        this.renderBoard(board, flags.compact);
+    }
+    renderBoard(board, compact) {
+        // Header
+        this.log(styles.title(`\n${board.name}`));
+        this.log(styles.muted(`Storage: SQLite`));
+        this.log(styles.muted('═'.repeat(60)));
+        // Display ALL columns (always show empty ones too)
+        for (const column of board.columns) {
+            const headerColor = getColumnStyle(column.name);
+            const emoji = getColumnEmoji(column.name);
+            this.log(headerColor(`\n${emoji} ${column.name} (${column.tickets.length})`));
+            this.log(divider(50));
+            if (column.tickets.length === 0) {
+                this.log(styles.muted('  (empty)'));
+                continue;
+            }
+            // Sort tickets by position
+            const sortedTickets = [...column.tickets].sort((a, b) => (a.position || 0) - (b.position || 0));
+            for (const ticket of sortedTickets) {
+                if (compact) {
+                    this.outputTicketCompact(ticket);
+                }
+                else {
+                    this.outputTicketFull(ticket);
+                }
+            }
+        }
+        // Summary
+        const totalTickets = board.columns.reduce((sum, col) => sum + col.tickets.length, 0);
+        this.log(styles.muted('\n' + '═'.repeat(60)));
+        this.log(styles.emphasis(`Total: ${totalTickets} ticket${totalTickets === 1 ? '' : 's'}`));
+        // Per-column summary (only non-empty)
+        const summary = board.columns
+            .filter(col => col.tickets.length > 0)
+            .map(col => `${col.name}: ${col.tickets.length}`)
+            .join(' | ');
+        if (summary) {
+            this.log(styles.primary(summary));
+        }
+        this.log(styles.muted('\nCommands:'));
+        this.log(styles.primary('  prlt ticket create     ') + styles.muted('Create a new ticket'));
+        this.log(styles.primary('  prlt ticket list       ') + styles.muted('List all tickets'));
+        this.log(styles.primary('  prlt ticket move <id>  ') + styles.muted('Move a ticket'));
+    }
+    outputTicketCompact(ticket) {
+        const priority = formatPriority(ticket.priority);
+        this.log(`  ${styles.code(ticket.id)}: ${ticket.title} ${priority}`);
+    }
+    outputTicketFull(ticket) {
+        const priority = formatPriority(ticket.priority);
+        const category = formatCategory(ticket.category);
+        this.log(`  ${styles.code(ticket.id)} ${ticket.title} ${priority} ${category}`);
+        if (ticket.description) {
+            const shortDesc = ticket.description.split('\n')[0].substring(0, 55);
+            this.log(styles.muted(`     ${shortDesc}${ticket.description.length > 55 ? '...' : ''}`));
+        }
+        if (ticket.subtasks.length > 0) {
+            const done = ticket.subtasks.filter(s => s.done).length;
+            const total = ticket.subtasks.length;
+            const progress = Math.round((done / total) * 100);
+            this.log(styles.muted(`     Subtasks: ${done}/${total} (${progress}%)`));
+        }
+        if (ticket.specId) {
+            this.log(styles.muted(`     Spec: ${ticket.specId}`));
+        }
+    }
+}

package/dist/commands/config/index.js

@@ -6,7 +6,7 @@ import { Command } from '@oclif/core';
 import { styles } from '../../lib/styles.js';
 import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { loadExecutionConfig, saveTerminalApp, saveTerminalOpenInBackground, saveTmuxControlMode, saveShell, } from '../../lib/execution/config.js';
-import { shouldOutputJson, isAgentMode, outputPromptAsJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, normalizeChoices, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, isAgentMode, isNonTTY, outputPromptAsJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, normalizeChoices, } from '../../lib/prompt-json.js';
 export default class Config extends Command {
     static description = 'View and update workspace configuration';
     static examples = [
@@ -103,8 +103,11 @@ export default class Config extends Command {
                 return;
             }
             // Handle --list or --json flag without --setting (just show config)
-            if ((flags.list || flags.json) && !flags.setting) {
-                if (jsonMode) {
+            // Also handle non-TTY mode without explicit flags - output config as readable list
+            const isExplicitJsonMode = flags.json === true;
+            const shouldShowConfigList = flags.list || (isExplicitJsonMode && !flags.setting) || (isNonTTY() && !flags.setting && !flags.set?.length);
+            if (shouldShowConfigList) {
+                if (isExplicitJsonMode) {
                     outputSuccessAsJson({
                         terminal: {
                             app: config.terminal.app,

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

@@ -0,0 +1,34 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class ExecutionConfig extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        set: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        list: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        setting: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected getPMOOptions(): {
+        promptIfMultiple: boolean;
+    };
+    /**
+     * Prompt wrapper - drop-in replacement for inquirer.prompt
+     */
+    private promptUser;
+    execute(): Promise<void>;
+    /**
+     * Handle a specific setting's sub-prompt
+     */
+    private handleSettingPrompt;
+    private setConfigValue;
+    /**
+     * Save output mode to workspace settings
+     */
+    private setOutputMode;
+    /**
+     * Save sandboxed preference to workspace settings
+     */
+    private setSandboxed;
+}