@proletariat/cli 0.3.52 → 0.3.54

package/dist/commands/work/start.js

@@ -5,6 +5,7 @@ import * as path from 'node:path';
 import { execSync } from 'node:child_process';
 import Database from 'better-sqlite3';
 import { PMOCommand, pmoBaseFlags, autoExportToBoard } from '../../lib/pmo/index.js';
+import { trackAgentSpawned } from '../../lib/telemetry/analytics.js';
 import { shouldOutputJson, outputErrorAsJson, createMetadata, outputConfirmationNeededAsJson, outputExecutionResultAsJson, } from '../../lib/prompt-json.js';
 import { FlagResolver } from '../../lib/flags/index.js';
 import { getWorkColumnSetting, findColumnByName } from '../../lib/pmo/utils.js';
@@ -21,6 +22,7 @@ import { buildLinearMetadata, buildLinearSpawnContextMessage, buildLinearTicketD
 import { buildJiraMetadata, buildJiraSpawnContextMessage, buildJiraTicketDescription, getJiraIssueByKey, } from '../../lib/external-issues/jira.js';
 import { resolveMirrorToPmo } from '../../lib/external-issues/work-start.js';
 import { ExternalIssueAdapterError } from '../../lib/external-issues/types.js';
+import { loadActiveWorkSource, saveActiveWorkSource, } from '../../lib/work-source/index.js';
 /**
  * Try to execute a git command, return true if successful
  */
@@ -127,6 +129,9 @@ export default class WorkStart extends PMOCommand {
         '<%= config.bin %> <%= command.id %> TKT-001 --prompt "Add unit tests for the API"  # Custom prompt',
         '<%= config.bin %> <%= command.id %> --from-issue --source linear --key ENG-123',
         '<%= config.bin %> <%= command.id %> --from-issue --source jira --key PROJ-123 --mirror-to-pmo',
+        '<%= config.bin %> <%= command.id %> --from linear:ENG-123              # Unified: provider:key shorthand',
+        '<%= config.bin %> <%= command.id %> --from jira:PROJ-123               # Unified: Jira shorthand',
+        '<%= config.bin %> <%= command.id %> --from-issue                       # Uses workspace active source',
     ];
     static args = {
         ticketId: Args.string({
@@ -144,7 +149,7 @@ export default class WorkStart extends PMOCommand {
         executor: Flags.string({
             char: 'e',
             description: 'Override executor',
-            options: ['claude-code', 'codex', 'aider', 'custom'],
+            options: ['claude-code', 'codex', 'custom'],
         }),
         action: Flags.string({
             char: 'A',
@@ -157,6 +162,9 @@ export default class WorkStart extends PMOCommand {
         message: Flags.string({
             description: 'Additional instructions appended to any action prompt',
         }),
+        from: Flags.string({
+            description: 'External issue ref in provider:key format (e.g., linear:ENG-123, jira:PROJ-456). Shorthand for --from-issue --source X --key Y.',
+        }),
         'from-issue': Flags.boolean({
             description: 'Start from external issue source instead of internal ticket id',
             default: false,
@@ -294,6 +302,15 @@ export default class WorkStart extends PMOCommand {
     async resolveIssueSourceAndKey(input, jsonMode) {
         let source = input.source;
         let key = input.key;
+        let sourceResolutionMethod = 'flag';
+        // If no explicit source flag, try workspace active source
+        if (!isIssueSource(source) && input.db) {
+            const activeSource = loadActiveWorkSource(input.db);
+            if (activeSource && isIssueSource(activeSource.provider)) {
+                source = activeSource.provider;
+                sourceResolutionMethod = 'active-source';
+            }
+        }
         const sourceResolver = new FlagResolver({
             commandName: 'work start',
             baseCommand: 'prlt work start --from-issue',
@@ -307,18 +324,25 @@ export default class WorkStart extends PMOCommand {
             default: isIssueSource(source) ? source : undefined,
             when: () => !isIssueSource(source),
             choices: () => [
-                { name: 'Linear', value: 'linear', command: 'prlt work start --from-issue --source linear --json' },
-                { name: 'Jira', value: 'jira', command: 'prlt work start --from-issue --source jira --json' },
+                { name: 'Linear', value: 'linear', command: 'prlt work start --from linear:ISSUE-KEY --json' },
+                { name: 'Jira', value: 'jira', command: 'prlt work start --from jira:ISSUE-KEY --json' },
             ],
         });
         const sourceResult = await sourceResolver.resolve();
-        source = source ?? sourceResult.source;
+        if (!isIssueSource(source)) {
+            source = sourceResult.source;
+            sourceResolutionMethod = 'interactive';
+            // Persist selected source as default
+            if (input.db && isIssueSource(source)) {
+                saveActiveWorkSource(input.db, { provider: source });
+            }
+        }
         if (!isIssueSource(source)) {
             throw new Error('Invalid source');
         }
         const keyResolver = new FlagResolver({
             commandName: 'work start',
-            baseCommand: `prlt work start --from-issue --source ${source}`,
+            baseCommand: `prlt work start --from ${source}:`,
             jsonMode,
             flags: {},
         });
@@ -335,7 +359,11 @@ export default class WorkStart extends PMOCommand {
         if (!resolvedKey) {
             throw new Error('Issue key is required');
         }
-        return { source, key: resolvedKey };
+        return {
+            source,
+            key: resolvedKey,
+            sourceResolution: { method: sourceResolutionMethod, provider: source },
+        };
     }
     async execute() {
         const { args, flags } = await this.parse(WorkStart);
@@ -392,22 +420,49 @@ export default class WorkStart extends PMOCommand {
             let externalIssueContextMessage;
             let fromIssueMirror;
             let fromIssueMirrorSource;
-            if (flags['from-issue']) {
+            let sourceResolutionMeta;
+            // Handle --from shorthand: parse provider:key into source + key
+            let fromFlag = flags.from;
+            let fromIssueActive = flags['from-issue'];
+            if (fromFlag) {
+                if (flags['from-issue'] || flags.source || flags.key) {
+                    db.close();
+                    return handleError('CONFLICTING_FLAGS', '--from cannot be used with --from-issue, --source, or --key. Use either --from provider:key or --from-issue --source X --key Y.');
+                }
+                fromIssueActive = true;
+                // Parse provider:key from --from value
+                const colonIndex = fromFlag.indexOf(':');
+                if (colonIndex !== -1) {
+                    flags.source = fromFlag.slice(0, colonIndex).toLowerCase();
+                    flags.key = fromFlag.slice(colonIndex + 1).trim();
+                }
+                else {
+                    // Provider only, no key - will prompt for key
+                    flags.source = fromFlag.toLowerCase();
+                }
+            }
+            if (fromIssueActive) {
                 if (ticketId) {
                     db.close();
-                    return handleError('INVALID_FLAGS', 'Cannot provide a ticket ID positional argument when using --from-issue.');
+                    return handleError('INVALID_FLAGS', 'Cannot provide a ticket ID positional argument when using --from-issue or --from.');
                 }
+                const fromBaseCmd = fromFlag ? `prlt work start --from ${fromFlag}` : 'prlt work start --from-issue';
                 projectId = projectId || await this.requireProject({
                     jsonMode: {
                         flags,
                         commandName: 'work start',
-                        baseCommand: 'prlt work start --from-issue',
+                        baseCommand: fromBaseCmd,
                     },
                 });
                 const sourceAndKey = await this.resolveIssueSourceAndKey({
                     source: flags.source,
                     key: flags.key,
+                    db,
                 }, jsonMode);
+                sourceResolutionMeta = sourceAndKey.sourceResolution;
+                if (!jsonMode && sourceResolutionMeta.method !== 'flag') {
+                    this.log(styles.muted(`Source resolved via ${sourceResolutionMeta.method}: ${sourceResolutionMeta.provider}`));
+                }
                 const envMirrorDefault = parseBooleanSetting(process.env.PRLT_MIRROR_TO_PMO_DEFAULT);
                 const configMirrorDefault = getMirrorToPmoDefault(db);
                 const mirrorResolution = resolveMirrorToPmo({
@@ -509,9 +564,12 @@ export default class WorkStart extends PMOCommand {
                             url: externalMetadata.url ?? null,
                         };
                     }
-                    if (flags['from-issue']) {
+                    if (fromIssueActive) {
                         metadata.mirrorToPmo = fromIssueMirror ?? null;
                         metadata.mirrorToPmoSource = fromIssueMirrorSource ?? null;
+                        if (sourceResolutionMeta) {
+                            metadata.sourceResolution = sourceResolutionMeta;
+                        }
                     }
                     // Build the confirm command with --yes
                     let confirmCmd = `prlt work start ${ticketId}`;
@@ -569,12 +627,14 @@ export default class WorkStart extends PMOCommand {
             if (isBlocked && !flags.force) {
                 const blockers = await this.storage.getTicketBlockers(ticketId);
                 const incompleteBlockers = blockers.filter(b => b.status !== 'done' && b.status !== 'canceled');
-                this.log('');
-                this.log(styles.warning(`⚠️  ${ticketId} is blocked by:`));
-                for (const blocker of incompleteBlockers) {
-                    this.log(styles.muted(`   - ${blocker.id}: ${blocker.title} (${blocker.status})`));
+                if (!jsonMode) {
+                    this.log('');
+                    this.log(styles.warning(`⚠️  ${ticketId} is blocked by:`));
+                    for (const blocker of incompleteBlockers) {
+                        this.log(styles.muted(`   - ${blocker.id}: ${blocker.title} (${blocker.status})`));
+                    }
+                    this.log('');
                 }
-                this.log('');
                 // Use FlagResolver for blocked ticket confirmation
                 const blockedResolver = new FlagResolver({
                     commandName: 'work start',
@@ -602,8 +662,10 @@ export default class WorkStart extends PMOCommand {
             // Check for existing tmux session for this ticket
             const existingSession = getTicketTmuxSession(ticketId);
             if (existingSession && !flags.force) {
-                this.log('');
-                this.log(styles.warning(`Ticket ${ticketId} has an active tmux session (${existingSession.agent})`));
+                if (!jsonMode) {
+                    this.log('');
+                    this.log(styles.warning(`Ticket ${ticketId} has an active tmux session (${existingSession.agent})`));
+                }
                 // Use FlagResolver for session action
                 const sessionResolver = new FlagResolver({
                     commandName: 'work start',
@@ -631,7 +693,7 @@ export default class WorkStart extends PMOCommand {
                 }
                 if (sessionAction === 'attach') {
                     // Attach to existing session
-                    execSync(`tmux attach -t "${existingSession.sessionName}"`, { stdio: 'inherit' });
+                    execSync(`tmux attach -d -t "${existingSession.sessionName}"`, { stdio: 'inherit' });
                     db.close();
                     return;
                 }
@@ -696,12 +758,15 @@ export default class WorkStart extends PMOCommand {
                 // No agent specified - default to creating ephemeral agent (new behavior)
                 // Or prompt for agent selection if staff agents exist
                 // Get staff agents that exist on disk (warns about missing directories)
-                const activeStaffAgents = getActiveStaffAgents(workspaceInfo, (msg) => this.log(msg));
+                const activeStaffAgents = getActiveStaffAgents(workspaceInfo, (msg) => {
+                    if (!jsonMode)
+                        this.log(msg);
+                });
                 if (activeStaffAgents.length > 0) {
                     // Clean up stale executions before checking availability (TKT-604)
                     // This fixes agents appearing as "busy" when their sessions have terminated
                     const cleanedUp = executionStorage.cleanupStaleExecutions();
-                    if (cleanedUp > 0) {
+                    if (cleanedUp > 0 && !jsonMode) {
                         this.log(styles.muted(`   Cleaned up ${cleanedUp} stale execution(s)`));
                     }
                     // Get list of busy agents (already running something)
@@ -744,16 +809,19 @@ export default class WorkStart extends PMOCommand {
                     const selectedAgent = agentResult.selectedAgent;
                     if (selectedAgent === '__ephemeral__') {
                         // Create ephemeral agent
-                        this.log(styles.muted('Creating ephemeral agent...'));
+                        if (!jsonMode)
+                            this.log(styles.muted('Creating ephemeral agent...'));
                         const ephemeralResult = await createEphemeralAgent(workspaceInfo, {
                             skipDevcontainer: flags['run-on-host'],
-                            log: (msg) => this.log(msg),
+                            log: (msg) => { if (!jsonMode)
+                                this.log(msg); },
                             mountMode: flags.clone ? 'clone' : 'worktree',
                         });
                         agentName = ephemeralResult.name;
                         agentWorktreePath = ephemeralResult.worktreePath;
                         isEphemeralAgent = true;
-                        this.log(styles.success(`Created ephemeral agent: ${agentName}`));
+                        if (!jsonMode)
+                            this.log(styles.success(`Created ephemeral agent: ${agentName}`));
                     }
                     else {
                         agentName = selectedAgent;
@@ -761,16 +829,19 @@ export default class WorkStart extends PMOCommand {
                 }
                 else {
                     // No pre-registered agents - create ephemeral agent by default
-                    this.log(styles.muted('Creating ephemeral agent...'));
+                    if (!jsonMode)
+                        this.log(styles.muted('Creating ephemeral agent...'));
                     const ephemeralResult = await createEphemeralAgent(workspaceInfo, {
                         skipDevcontainer: flags['run-on-host'],
-                        log: (msg) => this.log(msg),
+                        log: (msg) => { if (!jsonMode)
+                            this.log(msg); },
                         mountMode: flags.clone ? 'clone' : 'worktree',
                     });
                     agentName = ephemeralResult.name;
                     agentWorktreePath = ephemeralResult.worktreePath;
                     isEphemeralAgent = true;
-                    this.log(styles.success(`Created ephemeral agent: ${agentName}`));
+                    if (!jsonMode)
+                        this.log(styles.success(`Created ephemeral agent: ${agentName}`));
                 }
             }
             // At this point agentName is guaranteed to be set
@@ -784,7 +855,7 @@ export default class WorkStart extends PMOCommand {
             }
             // Check for running execution on this ticket (warning only, allows parallel work)
             const runningExecution = executionStorage.getRunningExecution(ticketId);
-            if (runningExecution) {
+            if (runningExecution && !jsonMode) {
                 this.log(styles.warning(`⚠️  Ticket "${ticketId}" already has work in progress: ${runningExecution.id}`));
                 this.log(styles.muted(`   Starting parallel execution. Note: status updates may conflict.`));
             }
@@ -829,16 +900,18 @@ export default class WorkStart extends PMOCommand {
                 const { getAgentGitStatus, pushAgentWork } = await import('../../lib/agents/commands.js');
                 const gitStatus = getAgentGitStatus(workspaceInfo, assignedAgent);
                 if (gitStatus.hasUnsavedWork) {
-                    this.log(styles.warning(`\n⚠️  Agent "${assignedAgent}" has unsaved work:`));
-                    for (const wt of gitStatus.worktrees) {
-                        if (wt.hasUncommittedChanges) {
-                            this.log(styles.muted(`  ${wt.repoName}: ${wt.uncommittedFiles.length} uncommitted file(s)`));
-                        }
-                        if (wt.hasUnpushedCommits) {
-                            this.log(styles.muted(`  ${wt.repoName}: ${wt.unpushedCount} unpushed commit(s) on ${wt.branch}`));
+                    if (!jsonMode) {
+                        this.log(styles.warning(`\n⚠️  Agent "${assignedAgent}" has unsaved work:`));
+                        for (const wt of gitStatus.worktrees) {
+                            if (wt.hasUncommittedChanges) {
+                                this.log(styles.muted(`  ${wt.repoName}: ${wt.uncommittedFiles.length} uncommitted file(s)`));
+                            }
+                            if (wt.hasUnpushedCommits) {
+                                this.log(styles.muted(`  ${wt.repoName}: ${wt.unpushedCount} unpushed commit(s) on ${wt.branch}`));
+                            }
                         }
+                        this.log('');
                     }
-                    this.log('');
                     // Use FlagResolver for unsaved work action
                     const unsavedResolver = new FlagResolver({
                         commandName: 'work start',
@@ -1261,96 +1334,139 @@ export default class WorkStart extends PMOCommand {
             // Auth method resolution for devcontainer environment
             // Only needed for Claude Code executor - other executors handle auth differently
             if (environment === 'devcontainer' && !useApiKey && isClaudeExecutor(executor)) {
-                // Check for saved auth method preference
-                const savedAuthMethod = getAuthMethod(db);
-                const hasApiKey = !!process.env.ANTHROPIC_API_KEY;
-                if (savedAuthMethod === 'apikey') {
-                    // Saved preference: API key — validate it's still set
-                    if (!hasApiKey) {
-                        this.log('');
-                        this.log(styles.warning('⚠️  Saved auth method is "apikey" but ANTHROPIC_API_KEY is not set in your environment.'));
-                        this.log(styles.muted('   Set the env var or run "' + this.config.bin + ' agent auth" to switch to OAuth.'));
-                        db.close();
-                        return;
+                // First, verify Docker daemon is actually running before checking credentials.
+                // dockerCredentialsExist() runs a Docker command that fails silently when the daemon
+                // is down, which would trigger a misleading OAuth credentials warning.
+                if (!isDockerRunning()) {
+                    this.log('');
+                    this.log(styles.warning('Docker daemon is not running. Start Docker Desktop or use --run-on-host.'));
+                    this.log('');
+                    if (jsonMode && flags.yes) {
+                        // In JSON mode with --yes, auto-switch to host
+                        environment = 'host';
+                        this.log(styles.muted('Switched to host environment (Docker not running).'));
                     }
-                    useApiKey = true;
-                }
-                else if (savedAuthMethod === 'oauth') {
-                    // Saved preference: OAuth — validate credentials exist
-                    const hasCredentials = dockerCredentialsExist();
-                    if (!hasCredentials) {
-                        this.log('');
-                        this.log(styles.warning('⚠️  Saved auth method is "oauth" but no OAuth credentials found.'));
-                        this.log(styles.muted('   Run "' + this.config.bin + ' agent auth" to authenticate.'));
-                        db.close();
-                        return;
+                    else {
+                        const dockerChoices = [
+                            { name: '💻 Switch to host environment', value: 'host' },
+                            { name: '✗  Cancel', value: 'cancel' },
+                        ];
+                        const dockerMessage = 'Docker is not running. What would you like to do?';
+                        const dockerResolver = new FlagResolver({
+                            commandName: 'work start',
+                            baseCommand: `prlt work start ${ticketId}`,
+                            jsonMode,
+                            flags: {},
+                        });
+                        dockerResolver.addPrompt({
+                            flagName: 'dockerAction',
+                            type: 'list',
+                            message: dockerMessage,
+                            choices: () => dockerChoices,
+                        });
+                        const dockerResult = await dockerResolver.resolve();
+                        const dockerAction = dockerResult.dockerAction;
+                        if (dockerAction === 'cancel') {
+                            db.close();
+                            this.log(styles.muted('Cancelled.'));
+                            return;
+                        }
+                        environment = 'host';
+                        this.log(styles.muted('Switched to host environment.'));
                     }
-                    // OAuth credentials valid — continue (useApiKey stays false)
                 }
-                else {
-                    // No saved preference — show auth method menu
-                    const hasCredentials = dockerCredentialsExist();
-                    if (hasCredentials) {
-                        // OAuth credentials exist, use them silently (no menu needed)
-                        // useApiKey stays false
+                // Only check credentials if Docker is running and still using devcontainer
+                if (environment === 'devcontainer') {
+                    // Check for saved auth method preference
+                    const savedAuthMethod = getAuthMethod(db);
+                    const hasApiKey = !!process.env.ANTHROPIC_API_KEY;
+                    if (savedAuthMethod === 'apikey') {
+                        // Saved preference: API key — validate it's still set
+                        if (!hasApiKey) {
+                            this.log('');
+                            this.log(styles.warning('⚠️  Saved auth method is "apikey" but ANTHROPIC_API_KEY is not set in your environment.'));
+                            this.log(styles.muted('   Set the env var or run "' + this.config.bin + ' agent auth" to switch to OAuth.'));
+                            db.close();
+                            return;
+                        }
+                        useApiKey = true;
+                    }
+                    else if (savedAuthMethod === 'oauth') {
+                        // Saved preference: OAuth — validate credentials exist
+                        const hasCredentials = dockerCredentialsExist();
+                        if (!hasCredentials) {
+                            this.log('');
+                            this.log(styles.warning('⚠️  Saved auth method is "oauth" but no OAuth credentials found.'));
+                            this.log(styles.muted('   Run "' + this.config.bin + ' agent auth" to authenticate.'));
+                            db.close();
+                            return;
+                        }
+                        // OAuth credentials valid — continue (useApiKey stays false)
                     }
                     else {
-                        // No saved preference and no OAuth credentials — prompt user
-                        // In JSON mode with --yes, continue anyway (agent can run /login)
-                        if (jsonMode && flags.yes) {
-                            // Continue without prompting - agent will need to handle auth
+                        // No saved preference — show auth method menu
+                        const hasCredentials = dockerCredentialsExist();
+                        if (hasCredentials) {
+                            // OAuth credentials exist, use them silently (no menu needed)
+                            // useApiKey stays false
                         }
                         else {
-                            this.log('');
-                            this.log(styles.warning('⚠️  No Claude Code OAuth credentials found for Docker containers'));
-                            this.log(styles.muted('   Agents need credentials to authenticate with Claude.'));
-                            this.log('');
-                            // Build auth method choices
-                            const authChoices = [
-                                { name: `🔐 OAuth (recommended — uses Max subscription)`, value: 'oauth' },
-                            ];
-                            if (hasApiKey) {
-                                authChoices.push({ name: '🔑 API key (uses API credits, not Max subscription)', value: 'apikey' });
+                            // No saved preference and no OAuth credentials — prompt user
+                            // In JSON mode with --yes, continue anyway (agent can run /login)
+                            if (jsonMode && flags.yes) {
+                                // Continue without prompting - agent will need to handle auth
                             }
-                            authChoices.push({ name: '💻 Switch to host environment instead', value: 'host' }, { name: '✗  Cancel', value: 'cancel' });
-                            // Use FlagResolver for auth method selection
-                            const authResolver = new FlagResolver({
-                                commandName: 'work start',
-                                baseCommand: `prlt work start ${ticketId}`,
-                                jsonMode,
-                                flags: {},
-                            });
-                            authResolver.addPrompt({
-                                flagName: 'authAction',
-                                type: 'list',
-                                message: 'How should the agent authenticate with Claude?',
-                                choices: () => authChoices,
-                            });
-                            const authResult = await authResolver.resolve();
-                            const authAction = authResult.authAction;
-                            if (authAction === 'cancel') {
-                                db.close();
-                                this.log(styles.muted('Cancelled.'));
-                                return;
-                            }
-                            if (authAction === 'host') {
-                                environment = 'host';
-                                this.log(styles.muted('Switched to host environment.'));
-                            }
-                            else if (authAction === 'apikey') {
-                                useApiKey = true;
-                                this.log(styles.warning('Using ANTHROPIC_API_KEY — this will consume API credits.'));
-                                this.log(styles.muted(`Run "${this.config.bin} agent auth" to set up OAuth and use your Max subscription instead.`));
-                                this.log('');
-                            }
-                            else if (authAction === 'oauth') {
+                            else {
                                 this.log('');
-                                this.log(styles.primary(`Opening ${this.config.bin} agent auth in new tab...`));
+                                this.log(styles.warning('⚠️  No Claude Code OAuth credentials found for Docker containers'));
+                                this.log(styles.muted('   Agents need credentials to authenticate with Claude.'));
                                 this.log('');
-                                // Open auth in a new terminal tab
-                                const authCmd = `${process.argv[1]} agent auth`;
-                                try {
-                                    execSync(`osascript -e '
+                                // Build auth method choices
+                                const authChoices = [
+                                    { name: `🔐 OAuth (recommended — uses Max subscription)`, value: 'oauth' },
+                                ];
+                                if (hasApiKey) {
+                                    authChoices.push({ name: '🔑 API key (uses API credits, not Max subscription)', value: 'apikey' });
+                                }
+                                authChoices.push({ name: '💻 Switch to host environment instead', value: 'host' }, { name: '✗  Cancel', value: 'cancel' });
+                                // Use FlagResolver for auth method selection
+                                const authResolver = new FlagResolver({
+                                    commandName: 'work start',
+                                    baseCommand: `prlt work start ${ticketId}`,
+                                    jsonMode,
+                                    flags: {},
+                                });
+                                authResolver.addPrompt({
+                                    flagName: 'authAction',
+                                    type: 'list',
+                                    message: 'How should the agent authenticate with Claude?',
+                                    choices: () => authChoices,
+                                });
+                                const authResult = await authResolver.resolve();
+                                const authAction = authResult.authAction;
+                                if (authAction === 'cancel') {
+                                    db.close();
+                                    this.log(styles.muted('Cancelled.'));
+                                    return;
+                                }
+                                if (authAction === 'host') {
+                                    environment = 'host';
+                                    this.log(styles.muted('Switched to host environment.'));
+                                }
+                                else if (authAction === 'apikey') {
+                                    useApiKey = true;
+                                    this.log(styles.warning('Using ANTHROPIC_API_KEY — this will consume API credits.'));
+                                    this.log(styles.muted(`Run "${this.config.bin} agent auth" to set up OAuth and use your Max subscription instead.`));
+                                    this.log('');
+                                }
+                                else if (authAction === 'oauth') {
+                                    this.log('');
+                                    this.log(styles.primary(`Opening ${this.config.bin} agent auth in new tab...`));
+                                    this.log('');
+                                    // Open auth in a new terminal tab
+                                    const authCmd = `${process.argv[1]} agent auth`;
+                                    try {
+                                        execSync(`osascript -e '
                     tell application "iTerm"
                       tell current window
                         create tab with default profile
@@ -1360,69 +1476,70 @@ export default class WorkStart extends PMOCommand {
                       end tell
                     end tell
                   '`);
-                                }
-                                catch {
-                                    // Fallback: try Terminal.app
-                                    try {
-                                        execSync(`osascript -e 'tell application "Terminal" to do script "${authCmd}"'`);
                                     }
                                     catch {
-                                        this.log(styles.warning('Could not open new terminal tab.'));
-                                        this.log(styles.muted(`Please run manually: ${authCmd}`));
+                                        // Fallback: try Terminal.app
+                                        try {
+                                            execSync(`osascript -e 'tell application "Terminal" to do script "${authCmd}"'`);
+                                        }
+                                        catch {
+                                            this.log(styles.warning('Could not open new terminal tab.'));
+                                            this.log(styles.muted(`Please run manually: ${authCmd}`));
+                                        }
                                     }
-                                }
-                                this.log(styles.muted('Complete the /login flow in the new tab, then press Enter here...'));
-                                this.log('');
-                                // Wait for user to complete auth
-                                await this.prompt([{
-                                        type: 'input',
-                                        name: 'done',
-                                        message: 'Press Enter when authentication is complete:',
-                                    }]);
-                                // Check if credentials now exist
-                                if (!dockerCredentialsExist()) {
+                                    this.log(styles.muted('Complete the /login flow in the new tab, then press Enter here...'));
                                     this.log('');
-                                    this.log(styles.warning('Authentication did not complete. No credentials found.'));
-                                    db.close();
-                                    return;
-                                }
-                                const info = getDockerCredentialInfo();
-                                this.log('');
-                                this.log(styles.success('✓ Credentials configured'));
-                                if (info) {
-                                    this.log(styles.muted(`   Subscription: ${info.subscriptionType || 'unknown'}`));
-                                    this.log(styles.muted(`   Expires: ${info.expiresAt.toLocaleDateString()}`));
-                                }
-                                this.log('');
-                            }
-                            // Prompt "Save as default?" after a successful auth method choice
-                            // (only if they chose oauth or apikey, not host/cancel)
-                            if (authAction === 'oauth' || authAction === 'apikey') {
-                                const saveChoices = [
-                                    { name: 'Yes — skip this menu next time', value: true },
-                                    { name: 'No — ask me each time', value: false },
-                                ];
-                                const saveMessage = 'Save as default auth method?';
-                                const saveResolver = new FlagResolver({
-                                    commandName: 'work start',
-                                    baseCommand: `prlt work start ${ticketId}`,
-                                    jsonMode,
-                                    flags: {},
-                                });
-                                saveResolver.addPrompt({
-                                    flagName: 'saveDefault',
-                                    type: 'list',
-                                    message: saveMessage,
-                                    default: true,
-                                    choices: () => saveChoices,
-                                });
-                                const saveResult = await saveResolver.resolve();
-                                if (saveResult.saveDefault) {
-                                    const methodToSave = authAction === 'apikey' ? 'apikey' : 'oauth';
-                                    saveAuthMethod(db, methodToSave);
-                                    this.log(styles.muted(`Auth method saved: ${methodToSave}. Will skip this menu next time.`));
+                                    // Wait for user to complete auth
+                                    await this.prompt([{
+                                            type: 'input',
+                                            name: 'done',
+                                            message: 'Press Enter when authentication is complete:',
+                                        }]);
+                                    // Check if credentials now exist
+                                    if (!dockerCredentialsExist()) {
+                                        this.log('');
+                                        this.log(styles.warning('Authentication did not complete. No credentials found.'));
+                                        db.close();
+                                        return;
+                                    }
+                                    const info = getDockerCredentialInfo();
+                                    this.log('');
+                                    this.log(styles.success('✓ Credentials configured'));
+                                    if (info) {
+                                        this.log(styles.muted(`   Subscription: ${info.subscriptionType || 'unknown'}`));
+                                        this.log(styles.muted(`   Expires: ${info.expiresAt.toLocaleDateString()}`));
+                                    }
                                     this.log('');
                                 }
+                                // Prompt "Save as default?" after a successful auth method choice
+                                // (only if they chose oauth or apikey, not host/cancel)
+                                if (authAction === 'oauth' || authAction === 'apikey') {
+                                    const saveChoices = [
+                                        { name: 'Yes — skip this menu next time', value: true },
+                                        { name: 'No — ask me each time', value: false },
+                                    ];
+                                    const saveMessage = 'Save as default auth method?';
+                                    const saveResolver = new FlagResolver({
+                                        commandName: 'work start',
+                                        baseCommand: `prlt work start ${ticketId}`,
+                                        jsonMode,
+                                        flags: {},
+                                    });
+                                    saveResolver.addPrompt({
+                                        flagName: 'saveDefault',
+                                        type: 'list',
+                                        message: saveMessage,
+                                        default: true,
+                                        choices: () => saveChoices,
+                                    });
+                                    const saveResult = await saveResolver.resolve();
+                                    if (saveResult.saveDefault) {
+                                        const methodToSave = authAction === 'apikey' ? 'apikey' : 'oauth';
+                                        saveAuthMethod(db, methodToSave);
+                                        this.log(styles.muted(`Auth method saved: ${methodToSave}. Will skip this menu next time.`));
+                                        this.log('');
+                                    }
+                                }
                             }
                         }
                     }
@@ -1819,6 +1936,13 @@ export default class WorkStart extends PMOCommand {
                 sessionManager: environment === 'devcontainer' ? sessionManager : undefined,
             });
             if (result.success) {
+                // Track agent spawn analytics
+                trackAgentSpawned({
+                    executor,
+                    environment,
+                    action: context.actionId || 'implement',
+                    ephemeral: isEphemeralAgent,
+                });
                 // Update execution record with process info
                 executionStorage.updateStatus(execution.id, 'running');
                 executionStorage.updateProcessInfo(execution.id, {
@@ -2015,52 +2139,79 @@ export default class WorkStart extends PMOCommand {
         let batchUseApiKey = false;
         // Credential check only applies to Claude Code executor
         if (anyUseDevcontainer && isClaudeExecutor(batchExecutor)) {
-            const hasCredentials = dockerCredentialsExist();
-            if (!hasCredentials) {
-                const hasApiKey = !!process.env.ANTHROPIC_API_KEY;
+            // First, verify Docker daemon is actually running before checking credentials.
+            // dockerCredentialsExist() runs a Docker command that fails silently when the daemon
+            // is down, which would trigger a misleading OAuth credentials warning.
+            if (!isDockerRunning()) {
                 this.log('');
-                this.log(styles.warning('⚠️  No Claude Code OAuth credentials found for Docker containers'));
-                this.log(styles.muted('   Agents need credentials to authenticate with Claude.'));
+                this.log(styles.warning('Docker daemon is not running. Start Docker Desktop or use --run-on-host.'));
                 this.log('');
-                // Build choices based on available options
-                const batchAuthChoices = [
-                    { name: `🔐 Run ${this.config.bin} agent auth now (recommended — uses Max subscription)`, value: 'auth', command: `${this.config.bin} agent auth` },
-                ];
-                if (hasApiKey) {
-                    batchAuthChoices.push({ name: '🔑 Use ANTHROPIC_API_KEY (⚠️  uses API credits, not Max subscription)', value: 'apikey', command: '' });
-                }
-                batchAuthChoices.push({ name: '💻 Run all agents on host instead (--run-on-host)', value: 'host', command: 'prlt work start --all --run-on-host --json' }, { name: '✗  Cancel', value: 'cancel', command: '' });
-                const { authAction } = await this.prompt([
+                const { dockerAction } = await this.prompt([
                     {
                         type: 'list',
-                        name: 'authAction',
-                        message: 'What would you like to do?',
-                        choices: batchAuthChoices,
+                        name: 'dockerAction',
+                        message: 'Docker is not running. What would you like to do?',
+                        choices: [
+                            { name: '💻 Run all agents on host instead (--run-on-host)', value: 'host', command: 'prlt work start --all --run-on-host --json' },
+                            { name: '✗  Cancel', value: 'cancel', command: '' },
+                        ],
                     },
                 ], batchJsonModeConfig);
-                if (authAction === 'cancel') {
+                if (dockerAction === 'cancel') {
                     db.close();
                     this.log(styles.muted('Cancelled.'));
                     return;
                 }
-                if (authAction === 'host') {
-                    flags['run-on-host'] = true;
-                    this.log(styles.muted('All agents will run on host.'));
-                }
-                else if (authAction === 'apikey') {
-                    batchUseApiKey = true;
-                    this.log(styles.warning('Using ANTHROPIC_API_KEY — this will consume API credits.'));
-                    this.log(styles.muted(`Run "${this.config.bin} agent auth" to set up OAuth and use your Max subscription instead.`));
-                    this.log('');
-                }
-                else if (authAction === 'auth') {
+                flags['run-on-host'] = true;
+                this.log(styles.muted('All agents will run on host.'));
+            }
+            if (!flags['run-on-host']) {
+                const hasCredentials = dockerCredentialsExist();
+                if (!hasCredentials) {
+                    const hasApiKey = !!process.env.ANTHROPIC_API_KEY;
                     this.log('');
-                    this.log(styles.primary(`Opening ${this.config.bin} agent auth in new tab...`));
+                    this.log(styles.warning('⚠️  No Claude Code OAuth credentials found for Docker containers'));
+                    this.log(styles.muted('   Agents need credentials to authenticate with Claude.'));
                     this.log('');
-                    // Open auth in a new terminal tab
-                    const authCmd = `${process.argv[1]} agent auth`;
-                    try {
-                        execSync(`osascript -e '
+                    // Build choices based on available options
+                    const batchAuthChoices = [
+                        { name: `🔐 Run ${this.config.bin} agent auth now (recommended — uses Max subscription)`, value: 'auth', command: `${this.config.bin} agent auth` },
+                    ];
+                    if (hasApiKey) {
+                        batchAuthChoices.push({ name: '🔑 Use ANTHROPIC_API_KEY (⚠️  uses API credits, not Max subscription)', value: 'apikey', command: '' });
+                    }
+                    batchAuthChoices.push({ name: '💻 Run all agents on host instead (--run-on-host)', value: 'host', command: 'prlt work start --all --run-on-host --json' }, { name: '✗  Cancel', value: 'cancel', command: '' });
+                    const { authAction } = await this.prompt([
+                        {
+                            type: 'list',
+                            name: 'authAction',
+                            message: 'What would you like to do?',
+                            choices: batchAuthChoices,
+                        },
+                    ], batchJsonModeConfig);
+                    if (authAction === 'cancel') {
+                        db.close();
+                        this.log(styles.muted('Cancelled.'));
+                        return;
+                    }
+                    if (authAction === 'host') {
+                        flags['run-on-host'] = true;
+                        this.log(styles.muted('All agents will run on host.'));
+                    }
+                    else if (authAction === 'apikey') {
+                        batchUseApiKey = true;
+                        this.log(styles.warning('Using ANTHROPIC_API_KEY — this will consume API credits.'));
+                        this.log(styles.muted(`Run "${this.config.bin} agent auth" to set up OAuth and use your Max subscription instead.`));
+                        this.log('');
+                    }
+                    else if (authAction === 'auth') {
+                        this.log('');
+                        this.log(styles.primary(`Opening ${this.config.bin} agent auth in new tab...`));
+                        this.log('');
+                        // Open auth in a new terminal tab
+                        const authCmd = `${process.argv[1]} agent auth`;
+                        try {
+                            execSync(`osascript -e '
               tell application "iTerm"
                 tell current window
                   create tab with default profile
@@ -2070,40 +2221,41 @@ export default class WorkStart extends PMOCommand {
                 end tell
               end tell
             '`);
-                    }
-                    catch {
-                        // Fallback: try Terminal.app
-                        try {
-                            execSync(`osascript -e 'tell application "Terminal" to do script "${authCmd}"'`);
                         }
                         catch {
-                            this.log(styles.warning('Could not open new terminal tab.'));
-                            this.log(styles.muted(`Please run manually: ${authCmd}`));
+                            // Fallback: try Terminal.app
+                            try {
+                                execSync(`osascript -e 'tell application "Terminal" to do script "${authCmd}"'`);
+                            }
+                            catch {
+                                this.log(styles.warning('Could not open new terminal tab.'));
+                                this.log(styles.muted(`Please run manually: ${authCmd}`));
+                            }
+                        }
+                        this.log(styles.muted('Complete the /login flow in the new tab, then press Enter here...'));
+                        this.log('');
+                        // Wait for user to complete auth
+                        await this.prompt([{
+                                type: 'input',
+                                name: 'done',
+                                message: 'Press Enter when authentication is complete:',
+                            }], batchJsonModeConfig);
+                        // Check if credentials now exist
+                        if (!dockerCredentialsExist()) {
+                            this.log('');
+                            this.log(styles.warning('Authentication did not complete. No credentials found.'));
+                            db.close();
+                            return;
+                        }
+                        const info = getDockerCredentialInfo();
+                        this.log('');
+                        this.log(styles.success('✓ Credentials configured'));
+                        if (info) {
+                            this.log(styles.muted(`   Subscription: ${info.subscriptionType || 'unknown'}`));
+                            this.log(styles.muted(`   Expires: ${info.expiresAt.toLocaleDateString()}`));
                         }
-                    }
-                    this.log(styles.muted('Complete the /login flow in the new tab, then press Enter here...'));
-                    this.log('');
-                    // Wait for user to complete auth
-                    await this.prompt([{
-                            type: 'input',
-                            name: 'done',
-                            message: 'Press Enter when authentication is complete:',
-                        }], batchJsonModeConfig);
-                    // Check if credentials now exist
-                    if (!dockerCredentialsExist()) {
                         this.log('');
-                        this.log(styles.warning('Authentication did not complete. No credentials found.'));
-                        db.close();
-                        return;
-                    }
-                    const info = getDockerCredentialInfo();
-                    this.log('');
-                    this.log(styles.success('✓ Credentials configured'));
-                    if (info) {
-                        this.log(styles.muted(`   Subscription: ${info.subscriptionType || 'unknown'}`));
-                        this.log(styles.muted(`   Expires: ${info.expiresAt.toLocaleDateString()}`));
                     }
-                    this.log('');
                 }
             }
         }
@@ -2315,3 +2467,4 @@ export default class WorkStart extends PMOCommand {
         }
     }
 }
+//# sourceMappingURL=start.js.map