@proletariat/cli 0.3.19 → 0.3.21

package/dist/commands/agent/login.js

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

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

@@ -7,6 +7,7 @@ export default class Remove extends PMOCommand {
     };
     static flags: {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/commands/agent/remove.js

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

package/dist/commands/agent/shell.js

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

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

@@ -1,7 +1,7 @@
 import { Args, Flags } from '@oclif/core';
 import inquirer from 'inquirer';
 import { colors, format } from '../../../lib/colors.js';
-import { getWorkspaceInfo, removeAgentsFromWorkspace } from '../../../lib/agents/commands.js';
+import { getWorkspaceInfo, removeAgentsFromWorkspace, formatAgentList } from '../../../lib/agents/commands.js';
 import { PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
 import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
 export default class Remove extends PMOCommand {
@@ -22,6 +22,11 @@ export default class Remove extends PMOCommand {
             description: 'Output prompt configuration as JSON (for AI agents/scripts)',
             default: false,
         }),
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Skip confirmation prompt (for non-interactive use)',
+            default: false,
+        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
@@ -85,36 +90,39 @@ export default class Remove extends PMOCommand {
         // Validate agent exists and is a staff agent
         const agent = staffAgents.find((a) => a.name === agentName);
         if (!agent) {
-            return handleError('AGENT_NOT_FOUND', `Staff agent "${agentName}" not found. Available staff agents: ${staffAgents.map((a) => a.name).join(', ')}`);
+            return handleError('AGENT_NOT_FOUND', `Staff agent "${agentName}" not found. Available: ${formatAgentList(staffAgents)}`);
         }
         const agentsToRemove = [agentName];
-        // 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/status.js

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

package/dist/commands/agent/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/agent/themes/add-names.d.ts

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

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

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

package/dist/commands/agent/visit.js

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

package/dist/commands/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/epic/link/index.js

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

package/dist/commands/execution/config.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;
+}