@proletariat/cli 0.3.43 → 0.3.45

package/dist/commands/agent/list.js

@@ -1,8 +1,7 @@
 import { Flags } from '@oclif/core';
 import chalk from 'chalk';
-import * as path from 'node:path';
 import * as fs from 'node:fs';
-import { getWorkspaceInfo, getAllAgentsStatus, getAgentTmuxSessions } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, getAllAgentsStatus, getAgentTmuxSessions, resolveAgentDir } from '../../lib/agents/commands.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { shouldOutputJson } from '../../lib/prompt-json.js';
 export default class List extends PMOCommand {
@@ -139,7 +138,7 @@ export default class List extends PMOCommand {
                         }
                     }
                     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/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, formatAgentList } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, formatAgentList, resolveAgentDir } 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';
@@ -74,7 +74,7 @@ export default class Login extends PMOCommand {
         if (!agent) {
             this.error(`Agent "${agentName}" not found. Available: ${formatAgentList(workspaceInfo.agents)}`);
         }
-        const agentDir = path.join(workspaceInfo.agentsPath, agentName);
+        const agentDir = resolveAgentDir(workspaceInfo, agentName);
         // Check if Docker config exists
         const dockerfilePath = path.join(agentDir, '.devcontainer', 'Dockerfile');
         if (!fs.existsSync(dockerfilePath)) {

package/dist/commands/agent/rebuild.js

@@ -4,7 +4,7 @@ import { promisify } from 'node:util';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
 import { colors } from '../../lib/colors.js';
-import { getWorkspaceInfo } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, resolveAgentDir } from '../../lib/agents/commands.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { isDockerRunning } from '../../lib/execution/runners.js';
 import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
@@ -76,8 +76,7 @@ export default class AgentRebuild extends PMOCommand {
             this.error('Not in a proletariat workspace. Run `prlt init` first.');
         }
         this.log(colors.primary(`🔨 Rebuilding agent: ${agentName}\n`));
-        const agentsPath = path.join(workspaceInfo.path, 'agents', 'staff');
-        const agentDir = path.join(agentsPath, agentName);
+        const agentDir = resolveAgentDir(workspaceInfo, agentName);
         try {
             this.log(colors.textSecondary('  Building devcontainer...'));
             const buildCommand = [

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, formatAgentList } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, getAgentTmuxSessions, formatAgentList, resolveAgentDir } 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';
@@ -110,7 +110,7 @@ export default class Shell extends PMOCommand {
             // If 'continue', proceed with opening a new shell
             this.log(colors.warning('\nProceeding with new shell - be careful of conflicts!\n'));
         }
-        const agentDir = path.join(workspaceInfo.agentsPath, agentName);
+        const agentDir = resolveAgentDir(workspaceInfo, agentName);
         // Check if agent has devcontainer
         const hasDevcontainer = hasDevcontainerConfig(agentDir);
         // In JSON mode with agent name provided, output combined config prompt

package/dist/commands/agent/status.js

@@ -1,6 +1,6 @@
 import { Args } from '@oclif/core';
 import { colors, format } from '../../lib/colors.js';
-import { getWorkspaceInfo, getAgentStatus, getAllAgentsStatus, formatAgentList } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, getAgentStatus, getAllAgentsStatus, formatAgentList, resolveAgentDir } from '../../lib/agents/commands.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class Status extends PMOCommand {
@@ -83,7 +83,7 @@ export default class Status extends PMOCommand {
                     name: agentName,
                     type: agent.type,
                     exists: agentStatus.exists,
-                    path: `${workspaceInfo.agentsPath}/${agentName}`,
+                    path: resolveAgentDir(workspaceInfo, agentName),
                     branch: agentStatus.branch,
                     repositories: agentStatus.repositories.map(r => ({
                         name: r.name,
@@ -107,7 +107,7 @@ export default class Status extends PMOCommand {
             return;
         }
         // Location
-        this.log(`📍 Location: ${colors.path(`${workspaceInfo.agentsPath}/${agentName}`)}`);
+        this.log(`📍 Location: ${colors.path(resolveAgentDir(workspaceInfo, agentName))}`);
         // Branch info
         if (agentStatus.branch) {
             this.log(`🌿 Branch: ${colors.warning(agentStatus.branch)}`);

package/dist/commands/agent/visit.js

@@ -1,7 +1,7 @@
 import { Args } from '@oclif/core';
 import * as path from 'node:path';
 import { colors } from '../../lib/colors.js';
-import { getWorkspaceInfo, formatAgentList } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, formatAgentList, resolveAgentDir } 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 {
@@ -74,7 +74,7 @@ export default class Visit extends PMOCommand {
             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);
+        const agentDir = resolveAgentDir(workspaceInfo, agentName);
         const relativePath = path.relative(process.cwd(), agentDir);
         // Display navigation command
         this.log(colors.primary(`🤖 Visiting agent: ${agentName}`));

package/dist/commands/orchestrator/attach.d.ts

@@ -0,0 +1,13 @@
+import { PromptCommand } from '../../lib/prompt-command.js';
+export default class OrchestratorAttach extends PromptCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'current-terminal': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        terminal: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private openInNewTab;
+}

package/dist/commands/orchestrator/attach.js

@@ -0,0 +1,140 @@
+import { Flags } from '@oclif/core';
+import { execSync } from 'node:child_process';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import { PromptCommand } from '../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { styles } from '../../lib/styles.js';
+import { getHostTmuxSessionNames } from '../../lib/execution/session-utils.js';
+import { ORCHESTRATOR_SESSION_NAME } from './start.js';
+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',
+    ];
+    static flags = {
+        ...machineOutputFlags,
+        'current-terminal': Flags.boolean({
+            char: 'c',
+            description: 'Attach in current terminal instead of new tab',
+            default: false,
+        }),
+        terminal: Flags.string({
+            char: 't',
+            description: 'Terminal app to use (iTerm, Terminal, Ghostty)',
+            default: 'iTerm',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(OrchestratorAttach);
+        const jsonMode = shouldOutputJson(flags);
+        // Check if orchestrator session exists
+        const hostSessions = getHostTmuxSessionNames();
+        if (!hostSessions.includes(ORCHESTRATOR_SESSION_NAME)) {
+            if (jsonMode) {
+                outputErrorAsJson('NOT_RUNNING', 'Orchestrator is not running. Start it with: prlt orchestrator start', createMetadata('orchestrator attach', flags));
+                return;
+            }
+            this.log('');
+            this.log(styles.warning('Orchestrator is not running.'));
+            this.log(styles.muted('Start it with: prlt orchestrator start'));
+            this.log('');
+            return;
+        }
+        if (jsonMode) {
+            outputSuccessAsJson({
+                sessionId: ORCHESTRATOR_SESSION_NAME,
+                status: 'attaching',
+            }, createMetadata('orchestrator attach', flags));
+            return;
+        }
+        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}"`);
+            }
+        }
+        else {
+            await this.openInNewTab(flags.terminal);
+        }
+    }
+    async openInNewTab(terminalApp) {
+        const title = 'Orchestrator';
+        const attachCmd = `tmux attach -t "${ORCHESTRATOR_SESSION_NAME}"`;
+        const baseDir = path.join(os.homedir(), '.proletariat', 'scripts');
+        fs.mkdirSync(baseDir, { recursive: true });
+        const scriptPath = path.join(baseDir, `attach-orch-${Date.now()}.sh`);
+        const script = `#!/bin/bash
+# Set terminal tab title
+echo -ne "\\033]0;${title}\\007"
+echo -ne "\\033]1;${title}\\007"
+
+echo "Attaching to: ${ORCHESTRATOR_SESSION_NAME}"
+${attachCmd}
+
+# Clean up
+rm -f "${scriptPath}"
+exec $SHELL
+`;
+        fs.writeFileSync(scriptPath, script, { mode: 0o755 });
+        try {
+            switch (terminalApp) {
+                case 'iTerm':
+                    execSync(`osascript -e '
+            tell application "iTerm"
+              activate
+              tell current window
+                set newTab to (create tab with default profile)
+                tell current session of newTab
+                  set name to "${title}"
+                  write text "${scriptPath}"
+                end tell
+              end tell
+            end tell
+          '`);
+                    break;
+                case 'Ghostty':
+                    execSync(`osascript -e '
+            tell application "Ghostty"
+              activate
+            end tell
+            tell application "System Events"
+              tell process "Ghostty"
+                keystroke "t" using command down
+                delay 0.3
+                keystroke "${scriptPath}"
+                keystroke return
+              end tell
+            end tell
+          '`);
+                    break;
+                case 'Terminal':
+                default:
+                    execSync(`osascript -e '
+            tell application "Terminal"
+              activate
+              tell application "System Events"
+                tell process "Terminal"
+                  keystroke "t" using command down
+                end tell
+              end tell
+              delay 0.3
+              do script "${scriptPath}" in front window
+            end tell
+          '`);
+                    break;
+            }
+            this.log(styles.success('Opened new tab and attaching to orchestrator'));
+        }
+        catch (error) {
+            this.error(`Failed to open terminal tab: ${error instanceof Error ? error.message : error}`);
+        }
+    }
+}

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

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

package/dist/commands/orchestrator/index.js

@@ -0,0 +1,51 @@
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
+export default class Orchestrator extends PMOCommand {
+    static description = 'Manage the orchestrator agent (start, attach, status, stop)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> start',
+        '<%= config.bin %> <%= command.id %> attach',
+        '<%= config.bin %> <%= command.id %> status',
+        '<%= config.bin %> <%= command.id %> stop',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+    };
+    getPMOOptions() {
+        return { promptIfMultiple: false };
+    }
+    async execute() {
+        const { flags } = await this.parse(Orchestrator);
+        const jsonModeConfig = shouldOutputJson(flags) ? { flags, commandName: 'orchestrator' } : null;
+        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' },
+                ],
+            }], jsonModeConfig);
+        if (action === 'cancel') {
+            return;
+        }
+        switch (action) {
+            case 'start':
+                await this.config.runCommand('orchestrator:start', []);
+                break;
+            case 'attach':
+                await this.config.runCommand('orchestrator:attach', []);
+                break;
+            case 'status':
+                await this.config.runCommand('orchestrator:status', []);
+                break;
+            case 'stop':
+                await this.config.runCommand('orchestrator:stop', []);
+                break;
+        }
+    }
+}

package/dist/commands/orchestrator/start.d.ts

@@ -0,0 +1,17 @@
+import { PromptCommand } from '../../lib/prompt-command.js';
+export declare const ORCHESTRATOR_SESSION_NAME = "prlt-orchestrator-main";
+export default class OrchestratorStart extends PromptCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        prompt: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        action: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        executor: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'skip-permissions': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        sandboxed: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        background: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/orchestrator/start.js

@@ -0,0 +1,287 @@
+import { Flags } from '@oclif/core';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import Database from 'better-sqlite3';
+import { PromptCommand } from '../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
+import { findHQRoot } from '../../lib/workspace.js';
+import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, buildPromptConfig, outputPromptAsJson, } from '../../lib/prompt-json.js';
+import { styles } from '../../lib/styles.js';
+import { DEFAULT_EXECUTION_CONFIG, } from '../../lib/execution/types.js';
+import { runExecution } from '../../lib/execution/runners.js';
+import { getHostTmuxSessionNames } from '../../lib/execution/session-utils.js';
+import { ExecutionStorage } from '../../lib/execution/storage.js';
+import { loadExecutionConfig, getTerminalApp, promptTerminalPreference, getShell, promptShellPreference, hasTerminalPreference, hasShellPreference, } from '../../lib/execution/config.js';
+export const ORCHESTRATOR_SESSION_NAME = 'prlt-orchestrator-main';
+export default class OrchestratorStart extends PromptCommand {
+    static description = 'Start the orchestrator agent in a tmux session';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --executor codex',
+        '<%= config.bin %> <%= command.id %> --skip-permissions',
+        '<%= config.bin %> <%= command.id %> --prompt "coordinate all agents on TKT-100"',
+        '<%= config.bin %> <%= command.id %> --background',
+    ];
+    static flags = {
+        ...machineOutputFlags,
+        prompt: Flags.string({
+            char: 'p',
+            description: 'Initial prompt for the orchestrator',
+        }),
+        action: Flags.string({
+            char: 'A',
+            description: 'Load an action by name from the actions table (uses its prompt)',
+        }),
+        executor: Flags.string({
+            char: 'e',
+            description: 'Executor type',
+            options: ['claude-code', 'codex', 'aider', 'custom'],
+        }),
+        'skip-permissions': Flags.boolean({
+            description: 'Run with --dangerously-skip-permissions',
+            default: false,
+            exclusive: ['sandboxed'],
+        }),
+        sandboxed: Flags.boolean({
+            description: 'Run in sandboxed mode (requires approval for dangerous operations)',
+            default: false,
+            exclusive: ['skip-permissions'],
+        }),
+        background: Flags.boolean({
+            char: 'b',
+            description: 'Start detached (don\'t open terminal tab)',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(OrchestratorStart);
+        const jsonMode = shouldOutputJson(flags);
+        // Check if orchestrator is already running
+        const hostSessions = getHostTmuxSessionNames();
+        if (hostSessions.includes(ORCHESTRATOR_SESSION_NAME)) {
+            if (jsonMode) {
+                outputErrorAsJson('ALREADY_RUNNING', `Orchestrator is already running (session: ${ORCHESTRATOR_SESSION_NAME}). Use "prlt orchestrator attach" to reattach.`, createMetadata('orchestrator start', flags));
+                return;
+            }
+            this.log('');
+            this.log(styles.warning(`Orchestrator is already running (session: ${ORCHESTRATOR_SESSION_NAME})`));
+            this.log('');
+            const { choice } = await this.prompt([{
+                    type: 'list',
+                    name: 'choice',
+                    message: 'What would you like to do?',
+                    choices: [
+                        { name: 'Attach to running orchestrator', value: 'attach', command: 'prlt orchestrator attach --json' },
+                        { name: 'Cancel', value: 'cancel' },
+                    ],
+                }], jsonMode ? { flags, commandName: 'orchestrator start' } : null);
+            if (choice === 'attach') {
+                await this.config.runCommand('orchestrator:attach', []);
+            }
+            return;
+        }
+        // Resolve HQ path
+        const hqPath = findHQRoot(process.cwd());
+        if (!hqPath) {
+            if (jsonMode) {
+                outputErrorAsJson('NO_HQ', 'Not in an HQ workspace. Run "prlt init" first.', createMetadata('orchestrator start', flags));
+                return;
+            }
+            this.error('Not in an HQ workspace. Run "prlt init" first.');
+        }
+        // Executor selection
+        let selectedExecutor;
+        if (flags.executor) {
+            selectedExecutor = flags.executor;
+        }
+        else {
+            const executorChoices = [
+                { name: 'Claude Code', value: 'claude-code', command: 'prlt orchestrator start --executor claude-code --json' },
+                { name: 'Codex', value: 'codex', command: 'prlt orchestrator start --executor codex --json' },
+                { name: 'Aider', value: 'aider', command: 'prlt orchestrator start --executor aider --json' },
+                { name: 'Custom', value: 'custom', command: 'prlt orchestrator start --executor custom --json' },
+            ];
+            const executorMessage = 'Select executor:';
+            if (jsonMode) {
+                outputPromptAsJson(buildPromptConfig('list', 'executor', executorMessage, executorChoices), createMetadata('orchestrator start', flags));
+                return;
+            }
+            const { executor } = await this.prompt([{
+                    type: 'list',
+                    name: 'executor',
+                    message: executorMessage,
+                    choices: executorChoices,
+                }]);
+            selectedExecutor = executor;
+        }
+        // Permission mode selection
+        let sandboxed;
+        if (flags['skip-permissions']) {
+            sandboxed = false;
+        }
+        else if (flags.sandboxed) {
+            sandboxed = true;
+        }
+        else {
+            const permissionChoices = [
+                { name: 'Sandboxed (requires approval for dangerous operations)', value: 'sandboxed', command: 'prlt orchestrator start --sandboxed --json' },
+                { name: 'Accept all (--dangerously-skip-permissions)', value: 'skip', command: 'prlt orchestrator start --skip-permissions --json' },
+            ];
+            const permissionMessage = 'Select permission mode:';
+            if (jsonMode) {
+                outputPromptAsJson(buildPromptConfig('list', 'permissionMode', permissionMessage, permissionChoices), createMetadata('orchestrator start', flags));
+                return;
+            }
+            const { permissionMode } = await this.prompt([{
+                    type: 'list',
+                    name: 'permissionMode',
+                    message: permissionMessage,
+                    choices: permissionChoices,
+                }]);
+            sandboxed = permissionMode === 'sandboxed';
+        }
+        // Resolve action prompt
+        let actionPrompt = flags.prompt;
+        let actionName = 'orchestrate';
+        if (flags.action && !actionPrompt) {
+            // Load action from DB
+            const dbPath = path.join(hqPath, '.proletariat', 'workspace.db');
+            if (fs.existsSync(dbPath)) {
+                let db = null;
+                try {
+                    db = new Database(dbPath);
+                    const row = db.prepare('SELECT prompt, name FROM actions WHERE id = ? OR name = ?').get(flags.action, flags.action);
+                    if (row) {
+                        actionPrompt = row.prompt;
+                        actionName = row.name;
+                    }
+                    else {
+                        if (jsonMode) {
+                            outputErrorAsJson('ACTION_NOT_FOUND', `Action "${flags.action}" not found.`, createMetadata('orchestrator start', flags));
+                            return;
+                        }
+                        this.error(`Action "${flags.action}" not found.`);
+                    }
+                }
+                finally {
+                    db?.close();
+                }
+            }
+        }
+        // Build execution context
+        // Use ticketId='prlt', actionName='orchestrator', agentName='main'
+        // so buildSessionName produces 'prlt-orchestrator-main'
+        const context = {
+            ticketId: 'prlt',
+            ticketTitle: 'Orchestrator',
+            agentName: 'main',
+            agentDir: hqPath,
+            worktreePath: hqPath,
+            branch: 'main',
+            actionName: 'orchestrator',
+            actionPrompt,
+            modifiesCode: false,
+            hqPath,
+        };
+        // Build execution config
+        const executionConfig = { ...DEFAULT_EXECUTION_CONFIG };
+        executionConfig.outputMode = 'interactive';
+        executionConfig.sandboxed = sandboxed;
+        // Load saved preferences from workspace DB
+        const dbPath = path.join(hqPath, '.proletariat', 'workspace.db');
+        let db = null;
+        try {
+            if (fs.existsSync(dbPath)) {
+                db = new Database(dbPath);
+                const savedConfig = loadExecutionConfig(db);
+                executionConfig.terminal = savedConfig.terminal;
+                executionConfig.shell = savedConfig.shell;
+                executionConfig.tmux = savedConfig.tmux;
+            }
+        }
+        catch {
+            // Ignore config loading errors, use defaults
+        }
+        // If no terminal preference saved, prompt for it (first run only)
+        if (!jsonMode && db) {
+            if (!hasTerminalPreference(db)) {
+                executionConfig.terminal.app = await promptTerminalPreference(db);
+            }
+            else {
+                executionConfig.terminal.app = await getTerminalApp(db);
+            }
+            if (!hasShellPreference(db)) {
+                executionConfig.shell = await promptShellPreference(db);
+            }
+            else {
+                executionConfig.shell = await getShell(db);
+            }
+        }
+        // Show what we're doing
+        if (!jsonMode) {
+            this.log('');
+            this.log(styles.muted(`   Starting orchestrator...`));
+            this.log(styles.muted(`   Executor: ${selectedExecutor}`));
+            this.log(styles.muted(`   Permission mode: ${sandboxed ? 'sandboxed' : 'skip-permissions'}`));
+            this.log(styles.muted(`   Directory: ${hqPath}`));
+            if (actionPrompt) {
+                this.log(styles.muted(`   Prompt: "${actionPrompt.substring(0, 60)}${actionPrompt.length > 60 ? '...' : ''}"`));
+            }
+            this.log('');
+        }
+        // Launch orchestrator
+        const displayMode = flags.background ? 'background' : 'terminal';
+        const result = await runExecution('host', context, selectedExecutor, executionConfig, {
+            displayMode,
+        });
+        if (result.success) {
+            // Create execution record so `prlt session poke orchestrator "message"` works
+            if (db) {
+                try {
+                    const executionStorage = new ExecutionStorage(db);
+                    executionStorage.createExecution({
+                        ticketId: 'ORCH',
+                        agentName: 'orchestrator',
+                        executor: selectedExecutor,
+                        environment: 'host',
+                        displayMode,
+                        sandboxed,
+                        sessionId: result.sessionId || ORCHESTRATOR_SESSION_NAME,
+                    });
+                }
+                catch {
+                    // Non-fatal: poke won't work but orchestrator is running
+                }
+            }
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    sessionId: result.sessionId || ORCHESTRATOR_SESSION_NAME,
+                    executor: selectedExecutor,
+                    sandboxed,
+                    displayMode,
+                    directory: hqPath,
+                }, createMetadata('orchestrator start', flags));
+            }
+            if (flags.background) {
+                this.log(styles.success(`Orchestrator started in background`));
+                this.log(styles.muted(`   Session: ${result.sessionId || ORCHESTRATOR_SESSION_NAME}`));
+                this.log(styles.muted(`   Attach with: prlt orchestrator attach`));
+            }
+            else {
+                this.log(styles.success(`Orchestrator started`));
+                if (result.sessionId) {
+                    this.log(styles.muted(`   Session: ${result.sessionId}`));
+                }
+            }
+        }
+        else {
+            if (jsonMode) {
+                outputErrorAsJson('EXECUTION_FAILED', `Failed to start orchestrator: ${result.error}`, createMetadata('orchestrator start', flags));
+            }
+            this.error(`Failed to start orchestrator: ${result.error}`);
+        }
+        if (db) {
+            db.close();
+        }
+    }
+}

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

@@ -0,0 +1,12 @@
+import { PromptCommand } from '../../lib/prompt-command.js';
+export default class OrchestratorStatus extends PromptCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        peek: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lines: 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>;
+    };
+    run(): Promise<void>;
+}