@proletariat/cli 0.3.44 → 0.3.46

package/dist/commands/orchestrator/attach.js

@@ -9,23 +9,58 @@ import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadat
 import { styles } from '../../lib/styles.js';
 import { getHostTmuxSessionNames } from '../../lib/execution/session-utils.js';
 import { ORCHESTRATOR_SESSION_NAME } from './start.js';
+/**
+ * Detect the terminal emulator from environment variables.
+ * Returns a terminal app name suitable for AppleScript tab creation,
+ * or null if detection fails or we're in a remote/headless environment.
+ */
+export function detectTerminalApp() {
+    // Remote sessions should never attempt AppleScript/GUI operations
+    if (process.env.SSH_TTY || process.env.SSH_CONNECTION) {
+        return null;
+    }
+    // Headless / no display — skip GUI attempts
+    if (process.platform !== 'darwin' && !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY) {
+        return null;
+    }
+    const termProgram = process.env.TERM_PROGRAM;
+    if (!termProgram)
+        return null;
+    switch (termProgram) {
+        case 'iTerm.app':
+            return 'iTerm';
+        case 'ghostty':
+            return 'Ghostty';
+        case 'Apple_Terminal':
+            return 'Terminal';
+        case 'WezTerm':
+            return 'WezTerm';
+        default:
+            return null;
+    }
+}
 export default class OrchestratorAttach extends PromptCommand {
     static description = 'Attach to the running orchestrator tmux session';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %> --current-terminal',
+        '<%= config.bin %> <%= command.id %> --new-tab',
+        '<%= config.bin %> <%= command.id %> --new-tab --terminal Ghostty',
     ];
     static flags = {
         ...machineOutputFlags,
-        'current-terminal': Flags.boolean({
-            char: 'c',
-            description: 'Attach in current terminal instead of new tab',
+        'new-tab': Flags.boolean({
+            description: 'Open in a new terminal tab instead of attaching in the current terminal',
             default: false,
         }),
         terminal: Flags.string({
             char: 't',
-            description: 'Terminal app to use (iTerm, Terminal, Ghostty)',
-            default: 'iTerm',
+            description: 'Terminal app to use for new tab (iTerm, Terminal, Ghostty). Auto-detected if not specified.',
+        }),
+        'current-terminal': Flags.boolean({
+            char: 'c',
+            description: '[deprecated] Attach in current terminal (this is now the default behavior)',
+            hidden: true,
+            default: false,
         }),
     };
     async run() {
@@ -51,18 +86,37 @@ export default class OrchestratorAttach extends PromptCommand {
             }, createMetadata('orchestrator attach', flags));
             return;
         }
+        if (flags['current-terminal']) {
+            this.log(styles.warning('--current-terminal is deprecated. Direct tmux attach is now the default behavior.'));
+        }
+        if (flags.terminal && !flags['new-tab']) {
+            this.log(styles.warning('--terminal has no effect without --new-tab. Ignoring.'));
+        }
         this.log('');
         this.log(styles.info(`Attaching to orchestrator session: ${ORCHESTRATOR_SESSION_NAME}`));
-        if (flags['current-terminal']) {
-            try {
-                execSync(`tmux attach -t "${ORCHESTRATOR_SESSION_NAME}"`, { stdio: 'inherit' });
-            }
-            catch {
-                this.error(`Failed to attach to orchestrator session "${ORCHESTRATOR_SESSION_NAME}"`);
+        if (flags['new-tab']) {
+            // Determine terminal app: explicit flag > auto-detect > error
+            const terminalApp = flags.terminal ?? detectTerminalApp();
+            if (!terminalApp) {
+                this.log(styles.warning('Could not detect terminal emulator for new tab.'));
+                this.log(styles.muted('Falling back to direct tmux attach in current terminal.'));
+                this.log(styles.muted('Tip: Use --terminal <app> to specify your terminal (iTerm, Terminal, Ghostty).'));
+                this.log('');
+                this.attachInCurrentTerminal();
+                return;
             }
+            await this.openInNewTab(terminalApp);
         }
         else {
-            await this.openInNewTab(flags.terminal);
+            this.attachInCurrentTerminal();
+        }
+    }
+    attachInCurrentTerminal() {
+        try {
+            execSync(`tmux attach -t "${ORCHESTRATOR_SESSION_NAME}"`, { stdio: 'inherit' });
+        }
+        catch {
+            this.error(`Failed to attach to orchestrator session "${ORCHESTRATOR_SESSION_NAME}"`);
         }
     }
     async openInNewTab(terminalApp) {

package/dist/commands/orchestrator/index.js

@@ -1,5 +1,7 @@
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { shouldOutputJson } from '../../lib/prompt-json.js';
+import { getHostTmuxSessionNames } from '../../lib/execution/session-utils.js';
+import { ORCHESTRATOR_SESSION_NAME } from './start.js';
 export default class Orchestrator extends PMOCommand {
     static description = 'Manage the orchestrator agent (start, attach, status, stop)';
     static examples = [
@@ -18,17 +20,30 @@ export default class Orchestrator extends PMOCommand {
     async execute() {
         const { flags } = await this.parse(Orchestrator);
         const jsonModeConfig = shouldOutputJson(flags) ? { flags, commandName: 'orchestrator' } : null;
+        // Check if orchestrator is currently running to offer contextual options
+        const hostSessions = getHostTmuxSessionNames();
+        const isRunning = hostSessions.includes(ORCHESTRATOR_SESSION_NAME);
+        // When running, show "Attach to running session" first since that's the likely intent
+        const choices = isRunning
+            ? [
+                { name: 'Attach to running session', value: 'attach', command: 'prlt orchestrator attach --json' },
+                { name: 'Start orchestrator', value: 'start', command: 'prlt orchestrator start --json' },
+                { name: 'Check orchestrator status', value: 'status', command: 'prlt orchestrator status --json' },
+                { name: 'Stop orchestrator', value: 'stop', command: 'prlt orchestrator stop --json' },
+                { name: 'Cancel', value: 'cancel' },
+            ]
+            : [
+                { name: 'Start orchestrator', value: 'start', command: 'prlt orchestrator start --json' },
+                { name: 'Attach to orchestrator', value: 'attach', command: 'prlt orchestrator attach --json' },
+                { name: 'Check orchestrator status', value: 'status', command: 'prlt orchestrator status --json' },
+                { name: 'Stop orchestrator', value: 'stop', command: 'prlt orchestrator stop --json' },
+                { name: 'Cancel', value: 'cancel' },
+            ];
         const { action } = await this.prompt([{
                 type: 'list',
                 name: 'action',
                 message: 'Orchestrator - What would you like to do?',
-                choices: [
-                    { name: 'Start orchestrator', value: 'start', command: 'prlt orchestrator start --json' },
-                    { name: 'Attach to orchestrator', value: 'attach', command: 'prlt orchestrator attach --json' },
-                    { name: 'Check orchestrator status', value: 'status', command: 'prlt orchestrator status --json' },
-                    { name: 'Stop orchestrator', value: 'stop', command: 'prlt orchestrator stop --json' },
-                    { name: 'Cancel', value: 'cancel' },
-                ],
+                choices,
             }], jsonModeConfig);
         if (action === 'cancel') {
             return;

package/dist/commands/staff/list.js

@@ -1,8 +1,7 @@
 import { Command } from '@oclif/core';
 import chalk from 'chalk';
-import * as path from 'node:path';
 import * as fs from 'node:fs';
-import { getWorkspaceInfo, getAllAgentsStatus } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, getAllAgentsStatus, resolveAgentDir } from '../../lib/agents/commands.js';
 import { shouldOutputJson } from '../../lib/prompt-json.js';
 import { machineOutputFlags } from '../../lib/pmo/index.js';
 export default class List extends Command {
@@ -73,7 +72,7 @@ export default class List extends Command {
                     }
                 }
                 else {
-                    const agentDir = path.join(workspaceInfo.agentsPath, agentStatus.name);
+                    const agentDir = resolveAgentDir(workspaceInfo, agentStatus.name);
                     const dirExists = fs.existsSync(agentDir);
                     if (dirExists) {
                         this.log(chalk.red(`   Invalid or broken worktrees`));

package/dist/commands/ticket/link/duplicates.d.ts

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

package/dist/commands/ticket/link/duplicates.js

@@ -0,0 +1,95 @@
+import { Args } from '@oclif/core';
+import { autoExportToBoard, PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
+import { styles } from '../../../lib/styles.js';
+import { shouldOutputJson, outputPromptAsJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
+export default class TicketLinkDuplicates extends PMOCommand {
+    static description = 'Mark a ticket as a duplicate of another';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> TKT-001 TKT-002',
+        '<%= config.bin %> <%= command.id %> TKT-001',
+        '<%= config.bin %> <%= command.id %> TKT-001 --json',
+    ];
+    static args = {
+        ticket: Args.string({
+            description: 'Ticket that is a duplicate',
+            required: true,
+        }),
+        original: Args.string({
+            description: 'Original ticket (that this duplicates)',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+    };
+    async execute() {
+        const { args, flags } = await this.parse(TicketLinkDuplicates);
+        const jsonMode = shouldOutputJson(flags);
+        const projectId = await this.requireProject();
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('ticket link duplicates', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        };
+        // Verify the source ticket exists
+        const ticket = await this.storage.getTicket(args.ticket);
+        if (!ticket) {
+            return handleError('TICKET_NOT_FOUND', `Ticket not found: ${args.ticket}`);
+        }
+        // If original ticket not provided, prompt for selection
+        if (!args.original) {
+            const tickets = await this.storage.listTickets(projectId);
+            const otherTickets = tickets.filter(t => t.id !== args.ticket);
+            if (otherTickets.length === 0) {
+                return handleError('NO_TICKETS', 'No other tickets to select as original.');
+            }
+            const projectFlag = flags.project ? ` -P ${flags.project}` : '';
+            const choices = otherTickets.map(t => ({
+                name: `${t.id} - ${t.title}`,
+                value: t.id,
+                command: `prlt ticket link duplicates ${args.ticket} ${t.id}${projectFlag} --json`,
+            }));
+            const message = `Select the original ticket that ${args.ticket} duplicates:`;
+            if (jsonMode) {
+                outputPromptAsJson(buildPromptConfig('list', 'original', message, choices), createMetadata('ticket link duplicates', flags));
+                return;
+            }
+            const { selected } = await this.prompt([{
+                    type: 'list',
+                    name: 'selected',
+                    message,
+                    choices,
+                }], null);
+            args.original = selected;
+        }
+        // Verify original ticket exists
+        const originalTicket = await this.storage.getTicket(args.original);
+        if (!originalTicket) {
+            return handleError('ORIGINAL_NOT_FOUND', `Original ticket not found: ${args.original}`);
+        }
+        // Create the duplicates dependency
+        try {
+            await this.storage.createTicketDependency(args.ticket, args.original, 'duplicates');
+            await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    ticketId: args.ticket,
+                    originalTicketId: args.original,
+                    type: 'duplicates',
+                }, createMetadata('ticket link duplicates', flags));
+                return;
+            }
+            this.log(styles.success(`\n${args.ticket} marked as duplicate of ${args.original}`));
+            this.log(styles.muted(`  ${ticket.title}`));
+            this.log(styles.muted(`  duplicates: ${originalTicket.title}`));
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('already exists')) {
+                return handleError('ALREADY_EXISTS', 'Duplicates dependency already exists.');
+            }
+            throw error;
+        }
+    }
+}

package/dist/commands/ticket/link/index.js

@@ -55,6 +55,8 @@ export default class TicketLink extends PMOCommand {
         const projectFlag = flags.project ? ` -P ${flags.project}` : '';
         const menuChoices = [
             { name: 'Add blocker', value: 'block', command: `prlt ticket link block ${args.ticket}${projectFlag} --json` },
+            { name: 'Add related ticket', value: 'relates', command: `prlt ticket link relates ${args.ticket}${projectFlag} --json` },
+            { name: 'Mark as duplicate', value: 'duplicates', command: `prlt ticket link duplicates ${args.ticket}${projectFlag} --json` },
             { name: 'View links', value: 'view', command: `prlt link list ${args.ticket}${projectFlag} --json` },
             { name: 'Remove link', value: 'remove', command: `prlt link remove ${args.ticket}${projectFlag} --json` },
             { name: 'Cancel', value: 'cancel', command: '' },
@@ -81,6 +83,18 @@ export default class TicketLink extends PMOCommand {
                 await cmd.run();
                 break;
             }
+            case 'relates': {
+                const { default: RelatesCommand } = await import('./relates.js');
+                const cmd = new RelatesCommand([args.ticket, ...(flags.project ? ['-P', flags.project] : [])], this.config);
+                await cmd.run();
+                break;
+            }
+            case 'duplicates': {
+                const { default: DuplicatesCommand } = await import('./duplicates.js');
+                const cmd = new DuplicatesCommand([args.ticket, ...(flags.project ? ['-P', flags.project] : [])], this.config);
+                await cmd.run();
+                break;
+            }
             case 'view': {
                 const { default: LinkListCommand } = await import('../../link/list.js');
                 const cmd = new LinkListCommand([args.ticket, ...(flags.project ? ['-P', flags.project] : [])], this.config);

package/dist/commands/ticket/link/relates.d.ts

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

package/dist/commands/ticket/link/relates.js

@@ -0,0 +1,95 @@
+import { Args } from '@oclif/core';
+import { autoExportToBoard, PMOCommand, pmoBaseFlags } from '../../../lib/pmo/index.js';
+import { styles } from '../../../lib/styles.js';
+import { shouldOutputJson, outputPromptAsJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
+export default class TicketLinkRelates extends PMOCommand {
+    static description = 'Add a relates-to dependency between two tickets';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> TKT-001 TKT-002',
+        '<%= config.bin %> <%= command.id %> TKT-001',
+        '<%= config.bin %> <%= command.id %> TKT-001 --json',
+    ];
+    static args = {
+        ticket: Args.string({
+            description: 'First ticket',
+            required: true,
+        }),
+        related: Args.string({
+            description: 'Second ticket (related)',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+    };
+    async execute() {
+        const { args, flags } = await this.parse(TicketLinkRelates);
+        const jsonMode = shouldOutputJson(flags);
+        const projectId = await this.requireProject();
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('ticket link relates', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        };
+        // Verify the source ticket exists
+        const ticket = await this.storage.getTicket(args.ticket);
+        if (!ticket) {
+            return handleError('TICKET_NOT_FOUND', `Ticket not found: ${args.ticket}`);
+        }
+        // If related ticket not provided, prompt for selection
+        if (!args.related) {
+            const tickets = await this.storage.listTickets(projectId);
+            const otherTickets = tickets.filter(t => t.id !== args.ticket);
+            if (otherTickets.length === 0) {
+                return handleError('NO_TICKETS', 'No other tickets to select as related.');
+            }
+            const projectFlag = flags.project ? ` -P ${flags.project}` : '';
+            const choices = otherTickets.map(t => ({
+                name: `${t.id} - ${t.title}`,
+                value: t.id,
+                command: `prlt ticket link relates ${args.ticket} ${t.id}${projectFlag} --json`,
+            }));
+            const message = `Select ticket to relate to ${args.ticket}:`;
+            if (jsonMode) {
+                outputPromptAsJson(buildPromptConfig('list', 'related', message, choices), createMetadata('ticket link relates', flags));
+                return;
+            }
+            const { selected } = await this.prompt([{
+                    type: 'list',
+                    name: 'selected',
+                    message,
+                    choices,
+                }], null);
+            args.related = selected;
+        }
+        // Verify related ticket exists
+        const relatedTicket = await this.storage.getTicket(args.related);
+        if (!relatedTicket) {
+            return handleError('RELATED_NOT_FOUND', `Related ticket not found: ${args.related}`);
+        }
+        // Create the relates_to dependency
+        try {
+            await this.storage.createTicketDependency(args.ticket, args.related, 'relates_to');
+            await autoExportToBoard(this.pmoPath, this.storage, (msg) => this.log(styles.muted(msg)));
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    ticketId: args.ticket,
+                    relatedTicketId: args.related,
+                    type: 'relates_to',
+                }, createMetadata('ticket link relates', flags));
+                return;
+            }
+            this.log(styles.success(`\n${args.ticket} now relates to ${args.related}`));
+            this.log(styles.muted(`  ${ticket.title}`));
+            this.log(styles.muted(`  relates to: ${relatedTicket.title}`));
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('already exists')) {
+                return handleError('ALREADY_EXISTS', 'Relates-to dependency already exists.');
+            }
+            throw error;
+        }
+    }
+}

package/dist/commands/work/revise.js

@@ -6,9 +6,9 @@ import Database from 'better-sqlite3';
 import { PMOCommand, pmoBaseFlags, autoExportToBoard } from '../../lib/pmo/index.js';
 import { getWorkColumnSetting, findColumnByName } from '../../lib/pmo/utils.js';
 import { styles } from '../../lib/styles.js';
-import { getWorkspaceInfo } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, resolveAgentDir } from '../../lib/agents/commands.js';
 import { DEFAULT_EXECUTION_CONFIG, } from '../../lib/execution/types.js';
-import { runExecution, isDockerRunning, isDevcontainerCliInstalled } from '../../lib/execution/runners.js';
+import { runExecution, isDockerRunning, isDevcontainerCliInstalled, getExecutorDisplayName } from '../../lib/execution/runners.js';
 import { ExecutionStorage } from '../../lib/execution/storage.js';
 import { loadExecutionConfig, getTerminalApp, getShell, hasTerminalPreference, hasShellPreference } from '../../lib/execution/config.js';
 import { hasDevcontainerConfig } from '../../lib/execution/devcontainer.js';
@@ -179,8 +179,8 @@ export default class WorkRevise extends PMOCommand {
                 this.error(`Ticket "${ticketId}" already has work in progress: ${runningExecution.id}\n` +
                     `Stop it first with "prlt work stop ${runningExecution.id}"`);
             }
-            // Find worktree path
-            const agentDir = path.join(workspaceInfo.agentsPath, agentName);
+            // Find worktree path (handles staff and temp agents)
+            const agentDir = resolveAgentDir(workspaceInfo, agentName);
             if (!fs.existsSync(agentDir)) {
                 db.close();
                 this.error(`Agent directory not found at ${agentDir}.`);
@@ -242,12 +242,14 @@ export default class WorkRevise extends PMOCommand {
                 // Host environment: terminal/background are display modes
                 displayMode = flags.mode;
             }
+            const executor = flags.executor || DEFAULT_EXECUTION_CONFIG.defaultExecutor;
+            const executorName = getExecutorDisplayName(executor);
             // Permission mode
             const { permissionMode } = await this.prompt([
                 {
                     type: 'list',
                     name: 'permissionMode',
-                    message: 'Permission mode for Claude Code:',
+                    message: `Permission mode for ${executorName}:`,
                     choices: [
                         { name: 'danger - Skip permission checks (faster for revisions)', value: 'danger', command: `prlt work revise ${ticketId} --json` },
                         { name: 'safe   - Requires approval for dangerous operations', value: 'safe', command: `prlt work revise ${ticketId} --json` },
@@ -256,7 +258,6 @@ export default class WorkRevise extends PMOCommand {
                 },
             ], reviseJsonModeConfig);
             sandboxed = permissionMode === 'safe';
-            const executor = flags.executor || DEFAULT_EXECUTION_CONFIG.defaultExecutor;
             // Show execution info
             this.log('');
             this.log(styles.header(`Revising: ${ticket.id}: ${ticket.title}`));

package/dist/commands/work/spawn.d.ts

@@ -31,6 +31,11 @@ export default class WorkSpawn extends PMOCommand {
         priority: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         epic: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'from-linear': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'linear-team': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'linear-state': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'linear-label': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'linear-limit': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         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>;