@proletariat/cli 0.3.9 → 0.3.11

package/dist/commands/agent/login.js

@@ -6,7 +6,7 @@ import inquirer from 'inquirer';
 import { colors } from '../../lib/colors.js';
 import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
-import { isDockerRunning } from '../../lib/execution/runners.js';
+import { isDockerRunning, getAgentContainerName, isContainerRunning, getContainerId, } from '../../lib/execution/runners.js';
 import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
 export default class Login extends PMOCommand {
     static description = 'Authenticate Claude Code inside an agent container (one-time setup)';
@@ -65,15 +65,28 @@ export default class Login extends PMOCommand {
                 outputPromptAsJson(buildPromptConfig('list', 'name', 'Select agent to authenticate:', agentChoices), createMetadata('agent login', flags));
                 return;
             }
+            // Group agents by type
+            const staffAgents = workspaceInfo.agents.filter(a => a.type === 'persistent');
+            const tempAgents = workspaceInfo.agents.filter(a => a.type === 'ephemeral');
+            const choices = [];
+            if (staffAgents.length > 0) {
+                choices.push(new inquirer.Separator('── Staff Agents ──'));
+                for (const agent of staffAgents) {
+                    choices.push({ name: `👔 ${agent.name}`, value: agent.name });
+                }
+            }
+            if (tempAgents.length > 0) {
+                choices.push(new inquirer.Separator('── Temp Agents ──'));
+                for (const agent of tempAgents) {
+                    choices.push({ name: `⏱️  ${agent.name}`, value: agent.name });
+                }
+            }
             const { selected } = await inquirer.prompt([
                 {
                     type: 'list',
                     name: 'selected',
                     message: 'Select agent to authenticate:',
-                    choices: workspaceInfo.agents.map(agent => ({
-                        name: agent.name,
-                        value: agent.name
-                    }))
+                    choices
                 }
             ]);
             agentName = selected;
@@ -84,38 +97,29 @@ export default class Login extends PMOCommand {
             this.error(`Agent "${agentName}" not found. Available agents: ${workspaceInfo.agents.map(a => a.name).join(', ')}`);
         }
         const agentDir = path.join(workspaceInfo.agentsPath, agentName);
-        // Check if devcontainer exists
-        const devcontainerPath = path.join(agentDir, '.devcontainer');
-        try {
-            execSync(`test -d "${devcontainerPath}"`, { stdio: 'ignore' });
-        }
-        catch {
-            this.error(`Agent "${agentName}" does not have a devcontainer configuration. Run "prlt agent add ${agentName}" to initialize.`);
+        // Check if Docker config exists
+        const dockerfilePath = path.join(agentDir, '.devcontainer', 'Dockerfile');
+        if (!fs.existsSync(dockerfilePath)) {
+            this.error(`Agent "${agentName}" does not have a Docker configuration. Run "prlt agent add ${agentName}" to initialize.`);
         }
-        // Get container ID
+        // Get container using the standard naming convention
         this.log(colors.primary(`🔐 Authenticating agent: ${agentName}`));
         this.log('');
-        let containerId;
-        try {
-            containerId = execSync(`docker ps --filter "label=devcontainer.local_folder=${agentDir}" --format "{{.ID}}"`, { encoding: 'utf-8' }).trim();
-        }
-        catch {
-            this.error('Failed to find running container. Make sure the agent container is running.');
+        const containerName = getAgentContainerName(agentName);
+        let containerId = null;
+        // Check if container is running
+        if (isContainerRunning(containerName)) {
+            containerId = getContainerId(containerName);
         }
         if (!containerId) {
-            this.log(colors.warning('Container is not running. Starting it now...'));
+            this.log(colors.warning('Container is not running.'));
             this.log('');
-            try {
-                execSync(`devcontainer up --workspace-folder "${agentDir}"`, {
-                    stdio: 'inherit',
-                    cwd: agentDir
-                });
-                // Get container ID again
-                containerId = execSync(`docker ps --filter "label=devcontainer.local_folder=${agentDir}" --format "{{.ID}}"`, { encoding: 'utf-8' }).trim();
-            }
-            catch {
-                this.error('Failed to start container.');
-            }
+            this.log('Start the container first by running a work command:');
+            this.log('  prlt work start <ticket-id>');
+            this.log('');
+            this.log('Or start an interactive session:');
+            this.log('  prlt agent shell ' + agentName);
+            this.error('Container must be running to authenticate.');
         }
         // Create a helper script to launch interactive session
         this.log(colors.success(`✓ Container running: ${containerId}`));

package/dist/commands/agent/restart.js

@@ -80,8 +80,10 @@ export default class AgentRestart extends PMOCommand {
         }
         for (const containerName of containerNames) {
             this.log(colors.textSecondary(`  Stopping container: ${containerName}...`));
+            // eslint-disable-next-line no-await-in-loop -- Sequential container operations with user feedback
             await execAsync(`docker stop ${containerName}`);
             this.log(colors.textSecondary(`  Removing container: ${containerName}...`));
+            // eslint-disable-next-line no-await-in-loop
             await execAsync(`docker rm ${containerName}`);
         }
         this.log('');

package/dist/commands/agent/shell.js

@@ -5,10 +5,10 @@ import { execSync, spawn } from 'node:child_process';
 import inquirer from 'inquirer';
 import Database from 'better-sqlite3';
 import { colors } from '../../lib/colors.js';
-import { getWorkspaceInfo } from '../../lib/agents/commands.js';
+import { getWorkspaceInfo, getAgentTmuxSessions } from '../../lib/agents/commands.js';
 import { hasDevcontainerConfig } from '../../lib/execution/devcontainer.js';
 import { getTerminalApp } from '../../lib/execution/config.js';
-import { isDockerRunning } from '../../lib/execution/runners.js';
+import { isDockerRunning, getAgentContainerName, isContainerRunning, getContainerId, } from '../../lib/execution/runners.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
 export default class Shell extends PMOCommand {
@@ -58,19 +58,34 @@ export default class Shell extends PMOCommand {
         let agentName = args.name;
         // Interactive mode if no agent specified
         if (!agentName) {
-            // Build choices once, use for both JSON and interactive modes
-            const agentChoices = workspaceInfo.agents.map((agent) => ({ name: agent.name, value: agent.name }));
             const selectMessage = 'Select agent to open shell in:';
             // In JSON mode, output agent selection prompt and exit
             if (jsonMode) {
+                const agentChoices = workspaceInfo.agents.map((agent) => ({ name: agent.name, value: agent.name }));
                 outputPromptAsJson(buildPromptConfig('list', 'name', selectMessage, agentChoices), createMetadata('agent shell', flags));
             }
+            // Group agents by type for interactive mode
+            const staffAgents = workspaceInfo.agents.filter(a => a.type === 'persistent');
+            const tempAgents = workspaceInfo.agents.filter(a => a.type === 'ephemeral');
+            const choices = [];
+            if (staffAgents.length > 0) {
+                choices.push(new inquirer.Separator('── Staff Agents ──'));
+                for (const agent of staffAgents) {
+                    choices.push({ name: `👔 ${agent.name}`, value: agent.name });
+                }
+            }
+            if (tempAgents.length > 0) {
+                choices.push(new inquirer.Separator('── Temp Agents ──'));
+                for (const agent of tempAgents) {
+                    choices.push({ name: `⏱️  ${agent.name}`, value: agent.name });
+                }
+            }
             const { selected } = await inquirer.prompt([
                 {
                     type: 'list',
                     name: 'selected',
                     message: selectMessage,
-                    choices: agentChoices
+                    choices
                 }
             ]);
             agentName = selected;
@@ -80,6 +95,44 @@ export default class Shell extends PMOCommand {
         if (!agent) {
             return handleError('AGENT_NOT_FOUND', `Agent "${agentName}" not found. Available agents: ${workspaceInfo.agents.map(a => a.name).join(', ')}`);
         }
+        // Check for existing tmux sessions
+        const existingSessions = getAgentTmuxSessions(agentName);
+        if (existingSessions.length > 0 && !jsonMode) {
+            this.log(colors.warning(`\n⚠️  Agent "${agentName}" has ${existingSessions.length} active tmux session(s):`));
+            for (const session of existingSessions) {
+                this.log(colors.textMuted(`   • ${session}`));
+            }
+            this.log('');
+            const { sessionAction } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'sessionAction',
+                    message: 'What would you like to do?',
+                    choices: [
+                        { name: '🔗 Attach to existing session', value: 'attach' },
+                        { name: '⚠️  Open new shell anyway (may cause conflicts)', value: 'continue' },
+                        { name: '❌ Cancel', value: 'cancel' },
+                    ],
+                }]);
+            if (sessionAction === 'cancel') {
+                this.log(colors.textMuted('Operation cancelled.'));
+                return;
+            }
+            if (sessionAction === 'attach') {
+                // Attach to the first session
+                const sessionName = existingSessions[0];
+                this.log(colors.primary(`\nAttaching to session: ${sessionName}`));
+                try {
+                    execSync(`tmux attach-session -t "${sessionName}"`, { stdio: 'inherit' });
+                }
+                catch {
+                    // User detached or session ended
+                    this.log(colors.textMuted('\nDetached from session.'));
+                }
+                return;
+            }
+            // 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);
         // Check if agent has devcontainer
         const hasDevcontainer = hasDevcontainerConfig(agentDir);
@@ -156,22 +209,28 @@ export default class Shell extends PMOCommand {
         if (!isDockerRunning()) {
             this.error('Docker is not running. Please start Docker Desktop and try again.');
         }
-        // Start or ensure container is running
-        try {
-            execSync(`devcontainer up --workspace-folder "${agentDir}"`, {
-                stdio: 'pipe',
-            });
-        }
-        catch (error) {
-            this.error(`Failed to start devcontainer: ${error instanceof Error ? error.message : error}`);
-        }
-        // Get container ID
+        // Get container using the standard naming convention
+        const containerName = getAgentContainerName(agentName);
         let containerId = null;
-        try {
-            containerId = execSync(`docker ps -q --filter "label=devcontainer.local_folder=${agentDir}"`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        // Check if container is running
+        if (isContainerRunning(containerName)) {
+            containerId = getContainerId(containerName);
         }
-        catch {
-            // Ignore
+        else {
+            // Try to start a stopped container
+            try {
+                execSync(`docker start ${containerName}`, { stdio: 'pipe' });
+                containerId = getContainerId(containerName);
+            }
+            catch {
+                // Container doesn't exist - user needs to run a work command first
+                this.log(colors.warning('Container is not running.'));
+                this.log('');
+                this.log('Start the container first by running a work command:');
+                this.log('  prlt work start <ticket-id>');
+                this.log('');
+                this.error('Container must exist. Run a work command first to create it.');
+            }
         }
         if (!containerId) {
             this.error('Failed to find running container.');

package/dist/commands/agent/staff/add.js

@@ -3,7 +3,7 @@ import chalk from 'chalk';
 import inquirer from 'inquirer';
 import { getWorkspaceInfo, validateAgentNames, addAgentsToWorkspace } from '../../../lib/agents/commands.js';
 import { ensureBuiltinThemes, BUILTIN_THEMES, isValidAgentName, normalizeAgentName } from '../../../lib/themes.js';
-import { getTheme, getThemes, getAvailableThemeNames, markThemeNameUsed, getActiveTheme } from '../../../lib/database/index.js';
+import { getTheme, getThemes, getAvailableThemeNames, getActiveTheme } from '../../../lib/database/index.js';
 import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
 export default class Add extends Command {
     static description = 'Add new agents to the workspace';
@@ -84,10 +84,6 @@ export default class Add extends Command {
                         validate: (input) => input.length > 0 || 'Please select at least one name'
                     }]);
                 agentNames = selected;
-                // Mark selected names as used
-                for (const name of agentNames) {
-                    markThemeNameUsed(workspaceInfo.path, themeId, name);
-                }
             }
             // Interactive mode: show names from workspace's active theme
             else if (agentNames.length === 0) {
@@ -153,10 +149,6 @@ export default class Add extends Command {
                     }
                     if (themedSelections.length > 0) {
                         agentNames.push(...themedSelections);
-                        // Mark themed names as used
-                        for (const name of themedSelections) {
-                            markThemeNameUsed(workspaceInfo.path, activeTheme.id, name);
-                        }
                     }
                 }
                 else {
@@ -233,9 +225,6 @@ export default class Add extends Command {
                                 validate: (input) => input.length > 0 || 'Please select at least one name'
                             }]);
                         agentNames = selected;
-                        for (const name of agentNames) {
-                            markThemeNameUsed(workspaceInfo.path, selectedTheme, name);
-                        }
                     }
                 }
                 if (agentNames.length === 0) {

package/dist/commands/agent/staff/remove.js

@@ -40,12 +40,14 @@ export default class Remove extends PMOCommand {
         };
         // Get workspace information
         const workspaceInfo = getWorkspaceInfo();
-        if (workspaceInfo.agents.length === 0) {
+        // Filter to staff (persistent) agents only
+        const staffAgents = workspaceInfo.agents.filter(a => a.type === 'persistent');
+        if (staffAgents.length === 0) {
             if (jsonMode) {
-                outputErrorAsJson('NO_AGENTS', 'No agents to remove.', createMetadata('agent remove', flags));
+                outputErrorAsJson('NO_AGENTS', 'No staff agents to remove.', createMetadata('agent staff remove', flags));
                 return;
             }
-            this.log(colors.warning('No agents to remove.'));
+            this.log(colors.warning('No staff agents to remove.'));
             return;
         }
         let agentName = args.name;
@@ -53,7 +55,7 @@ export default class Remove extends PMOCommand {
         if (!agentName) {
             // Build choices once, use for both JSON and interactive modes
             const agentChoices = [
-                ...workspaceInfo.agents.map((agent) => ({ name: agent.name, value: agent.name })),
+                ...staffAgents.map((agent) => ({ name: agent.name, value: agent.name })),
                 { name: 'Cancel', value: 'cancel' },
             ];
             const selectMessage = 'Select agent to remove:';
@@ -80,10 +82,10 @@ export default class Remove extends PMOCommand {
             }
             agentName = selected;
         }
-        // Validate agent exists
-        const agent = workspaceInfo.agents.find((a) => a.name === agentName);
+        // Validate agent exists and is a staff agent
+        const agent = staffAgents.find((a) => a.name === agentName);
         if (!agent) {
-            return handleError('AGENT_NOT_FOUND', `Agent "${agentName}" not found. Available agents: ${workspaceInfo.agents.map((a) => a.name).join(', ')}`);
+            return handleError('AGENT_NOT_FOUND', `Staff agent "${agentName}" not found. Available staff agents: ${staffAgents.map((a) => a.name).join(', ')}`);
         }
         const agentsToRemove = [agentName];
         // Build choices once, use for both JSON and interactive modes

package/dist/commands/agent/status.js

@@ -49,15 +49,28 @@ export default class Status extends PMOCommand {
                 outputPromptAsJson(buildPromptConfig('list', 'name', 'Select agent to view status:', agentChoices), createMetadata('agent status', flags));
                 return;
             }
+            // Group agents by type
+            const staffAgents = workspaceInfo.agents.filter(a => a.type === 'persistent');
+            const tempAgents = workspaceInfo.agents.filter(a => a.type === 'ephemeral');
+            const choices = [];
+            if (staffAgents.length > 0) {
+                choices.push(new inquirer.Separator('── Staff Agents ──'));
+                for (const agent of staffAgents) {
+                    choices.push({ name: `👔 ${agent.name}`, value: agent.name });
+                }
+            }
+            if (tempAgents.length > 0) {
+                choices.push(new inquirer.Separator('── Temp Agents ──'));
+                for (const agent of tempAgents) {
+                    choices.push({ name: `⏱️  ${agent.name}`, value: agent.name });
+                }
+            }
             const { selected } = await inquirer.prompt([
                 {
                     type: 'list',
                     name: 'selected',
                     message: 'Select agent to view status:',
-                    choices: workspaceInfo.agents.map((agent) => ({
-                        name: agent.name,
-                        value: agent.name
-                    }))
+                    choices
                 }
             ]);
             agentName = selected;

package/dist/commands/agent/temp/cleanup.js

@@ -225,9 +225,10 @@ export default class Cleanup extends PMOCommand {
         if (!skipConfirm && !dryRun) {
             // In JSON mode, output confirmation prompt with context
             if (jsonMode) {
-                const promptConfig = buildPromptConfig('list', 'confirmed', confirmMessage, confirmChoices);
-                // Add context about what will be cleaned
-                promptConfig.context = { agentsToCleanup };
+                const promptConfig = {
+                    ...buildPromptConfig('list', 'confirmed', confirmMessage, confirmChoices),
+                    context: { agentsToCleanup },
+                };
                 outputPromptAsJson(promptConfig, createMetadata('agent cleanup', flags));
                 return;
             }
@@ -272,6 +273,7 @@ export default class Cleanup extends PMOCommand {
             if (!jsonMode) {
                 this.log(colors.primary(`\nCleaning up: ${agentName}`));
             }
+            // eslint-disable-next-line no-await-in-loop -- Sequential cleanup with user interaction
             const result = await cleanupAgent(workspaceInfo, agentName, {
                 log: jsonMode ? undefined : (msg) => this.log(colors.textMuted(`  ${msg}`)),
                 dryRun,
@@ -313,6 +315,7 @@ export default class Cleanup extends PMOCommand {
                 choices.push({ name: '🗑️  Force cleanup (discard all changes)', value: 'force' });
                 choices.push({ name: '⏭️  Skip this agent', value: 'skip' });
                 // In interactive mode, prompt for action
+                // eslint-disable-next-line no-await-in-loop -- User interaction per agent
                 const { action } = await inquirer.prompt([
                     {
                         type: 'list',
@@ -327,6 +330,7 @@ export default class Cleanup extends PMOCommand {
                     continue;
                 }
                 // Re-run cleanup with the selected option
+                // eslint-disable-next-line no-await-in-loop
                 const retryResult = await cleanupAgent(workspaceInfo, agentName, {
                     log: (msg) => this.log(colors.textMuted(`  ${msg}`)),
                     dryRun,

package/dist/commands/agent/themes/index.js

@@ -3,7 +3,7 @@ import inquirer from 'inquirer';
 import chalk from 'chalk';
 import { getWorkspaceInfo } from '../../../lib/agents/commands.js';
 import { ensureBuiltinThemes } from '../../../lib/themes.js';
-import { getThemes, getThemeNames } from '../../../lib/database/index.js';
+import { getThemes, getAvailableThemeNames } from '../../../lib/database/index.js';
 import { shouldOutputJson, outputPromptAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
 export default class Themes extends Command {
     static description = 'Manage agent naming themes';
@@ -119,15 +119,14 @@ export default class Themes extends Command {
                     }
                     // Build choices with theme info
                     const themeChoices = themes.map(t => {
-                        const names = getThemeNames(workspaceInfo.path, t.id);
-                        const available = names.filter(n => !n.used).length;
+                        const availableNames = getAvailableThemeNames(workspaceInfo.path, t.id);
                         const builtinTag = t.builtin ? chalk.dim(' [built-in]') : '';
                         return {
-                            name: `${t.display_name}${builtinTag} ${chalk.dim(`(${available} names available)`)}`,
+                            name: `${t.display_name}${builtinTag} ${chalk.dim(`(${availableNames.length} names available)`)}`,
                             value: t.id
                         };
                     });
-                    // Add option to create new theme
+                    // Add option to create new theme (using type assertion for mixed array)
                     themeChoices.push(new inquirer.Separator());
                     themeChoices.push({ name: chalk.green('+ Create new theme'), value: '__create_new__' });
                     const { selectedTheme } = await inquirer.prompt([{

package/dist/commands/agent/themes/list.js

@@ -2,7 +2,7 @@ import { Command } from '@oclif/core';
 import chalk from 'chalk';
 import { getWorkspaceInfo } from '../../../lib/agents/commands.js';
 import { ensureBuiltinThemes } from '../../../lib/themes.js';
-import { getThemes, getThemeNames } from '../../../lib/database/index.js';
+import { getThemes, getThemeNames, getAvailableThemeNames } from '../../../lib/database/index.js';
 export default class ThemesList extends Command {
     static description = 'List available agent themes';
     static examples = [
@@ -20,16 +20,16 @@ export default class ThemesList extends Command {
             }
             this.log(chalk.bold('\nAgent Themes\n'));
             for (const theme of themes) {
-                const names = getThemeNames(workspaceInfo.path, theme.id);
-                const available = names.filter(n => !n.used).length;
-                const used = names.filter(n => n.used).length;
+                const allNames = getThemeNames(workspaceInfo.path, theme.id);
+                const availableNames = getAvailableThemeNames(workspaceInfo.path, theme.id);
+                const inUse = allNames.length - availableNames.length;
                 const builtinTag = theme.builtin ? chalk.gray(' [built-in]') : '';
                 this.log(`  ${chalk.cyan(theme.display_name)}${builtinTag}`);
                 this.log(chalk.gray(`    ID: ${theme.id}`));
                 if (theme.description) {
                     this.log(chalk.gray(`    ${theme.description}`));
                 }
-                this.log(chalk.gray(`    Names: ${chalk.green(available + ' available')}, ${chalk.yellow(used + ' in use')}`));
+                this.log(chalk.gray(`    Names: ${chalk.green(availableNames.length + ' available')}, ${chalk.yellow(inUse + ' in use')}`));
                 this.log('');
             }
             this.log(chalk.blue('Use: prlt agent add --theme <theme-id>'));

package/dist/commands/agent/visit.js

@@ -58,15 +58,28 @@ export default class Visit extends PMOCommand {
                 outputPromptAsJson(buildPromptConfig('list', 'name', 'Select agent to visit:', agentChoices), createMetadata('agent visit', flags));
                 return;
             }
+            // Group agents by type
+            const staffAgents = workspaceInfo.agents.filter(a => a.type === 'persistent');
+            const tempAgents = workspaceInfo.agents.filter(a => a.type === 'ephemeral');
+            const choices = [];
+            if (staffAgents.length > 0) {
+                choices.push(new inquirer.Separator('── Staff Agents ──'));
+                for (const agent of staffAgents) {
+                    choices.push({ name: `👔 ${agent.name}`, value: agent.name });
+                }
+            }
+            if (tempAgents.length > 0) {
+                choices.push(new inquirer.Separator('── Temp Agents ──'));
+                for (const agent of tempAgents) {
+                    choices.push({ name: `⏱️  ${agent.name}`, value: agent.name });
+                }
+            }
             const { selected } = await inquirer.prompt([
                 {
                     type: 'list',
                     name: 'selected',
                     message: 'Select agent to visit:',
-                    choices: workspaceInfo.agents.map(agent => ({
-                        name: agent.name,
-                        value: agent.name
-                    }))
+                    choices
                 }
             ]);
             agentName = selected;

package/dist/commands/branch/create.d.ts

@@ -1,5 +1,9 @@
 import { PMOCommand } from '../../lib/pmo/index.js';
 export default class BranchCreate extends PMOCommand {
+    private _selectedTicket?;
+    private _autoCommit?;
+    private _fromOrigin?;
+    private _customStartPoint?;
     static description: string;
     static examples: string[];
     static args: {

package/dist/commands/branch/create.js

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
-import * as fs from 'fs';
-import * as path from 'path';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
 import inquirer from 'inquirer';
 import Database from 'better-sqlite3';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
@@ -11,6 +11,11 @@ import { getCoderName, getGitUserName, getGitHubUsername } from '../../lib/execu
 import { getBranchType } from '../../lib/execution/types.js';
 import { detectAgentName } from '../../lib/agents/index.js';
 export default class BranchCreate extends PMOCommand {
+    // Internal state for passing data between methods
+    _selectedTicket;
+    _autoCommit;
+    _fromOrigin;
+    _customStartPoint;
     static description = 'Create a new branch with conventional naming';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
@@ -155,6 +160,7 @@ export default class BranchCreate extends PMOCommand {
             if (!wizardResult)
                 return;
             branchName = wizardResult.branchName;
+            // Store ticket info, autoCommit, fromOrigin, and customStartPoint flags for later
             this._selectedTicket = wizardResult.ticket;
             this._autoCommit = wizardResult.autoCommit;
             this._fromOrigin = wizardResult.fromOrigin;
@@ -286,13 +292,14 @@ export default class BranchCreate extends PMOCommand {
     /**
      * Create branch from ticket ID with defaults (non-interactive).
      */
-    async createFromTicketId(ticketId, ownerOverride, projectId) {
+    async createFromTicketId(ticketId, ownerOverride, _projectId) {
         try {
             // Search for ticket across all projects
             const projects = await this.storage.listProjects();
             let foundTicket = null;
-            for (const project of projects) {
-                const tickets = await this.storage.listTickets(projectId);
+            for (const proj of projects) {
+                // eslint-disable-next-line no-await-in-loop -- Search with early exit
+                const tickets = await this.storage.listTickets(proj.id);
                 const match = tickets.find(t => t.id === ticketId);
                 if (match) {
                     foundTicket = match;
@@ -323,12 +330,13 @@ export default class BranchCreate extends PMOCommand {
         // Get default owner name from config or GitHub
         const defaultOwnerName = this.getDefaultOwnerName();
         // Load tickets from PMO (across all projects)
-        let tickets = [];
+        const tickets = [];
         try {
             // Get all projects and their tickets
             const projects = await this.storage.listProjects();
             const projectId = flags.project;
             for (const project of projects) {
+                // eslint-disable-next-line no-await-in-loop -- Collecting tickets from projects
                 const projectTickets = await this.storage.listTickets(projectId);
                 // Filter to actionable tickets (todo, in-progress, backlog)
                 const actionable = projectTickets.filter(t => !t.status || ['todo', 'in-progress', 'backlog', 'in_progress'].includes(t.status.toLowerCase()));
@@ -484,7 +492,7 @@ export default class BranchCreate extends PMOCommand {
                 default: 0,
             },
         ]);
-        let fromOrigin = branchFrom === 'origin-main';
+        const fromOrigin = branchFrom === 'origin-main';
         let customStartPoint;
         if (branchFrom === 'other') {
             customStartPoint = await this.promptForBranch();
@@ -586,7 +594,7 @@ export default class BranchCreate extends PMOCommand {
                 default: 0,
             },
         ]);
-        let fromOrigin = branchFrom === 'origin-main';
+        const fromOrigin = branchFrom === 'origin-main';
         let customStartPoint;
         if (branchFrom === 'other') {
             customStartPoint = await this.promptForBranch();

package/dist/commands/branch/index.js

@@ -1,6 +1,6 @@
 import { Flags } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
-import { shouldOutputJson, } from '../../lib/prompt-json.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 export default class Branch extends PMOCommand {
     static description = 'Interactive menu for branch operations';
     static examples = ['<%= config.bin %> <%= command.id %>'];

package/dist/commands/branch/where.js

@@ -186,6 +186,7 @@ export default class BranchWhere extends PMOCommand {
         while (current !== root) {
             try {
                 const dbPath = path.join(current, '.proletariat', 'workspace.db');
+                // eslint-disable-next-line unicorn/prefer-module
                 const fs = require('node:fs');
                 if (fs.existsSync(dbPath)) {
                     return current;

package/dist/commands/claude.d.ts

@@ -0,0 +1,38 @@
+import { Command } from '@oclif/core';
+export default class Claude extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        slug: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'permission-mode': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'display-mode': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        prompt: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        directory: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        title: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    /**
+     * Run in "yolo mode" - outside any HQ
+     * No ticket creation, no tracking, just launch Claude
+     */
+    private runOutsideHQ;
+    /**
+     * Run in "tracked mode" - inside an HQ
+     * Creates adhoc ticket, ephemeral agent, full tracking
+     */
+    private runInsideHQ;
+    /**
+     * Set up catch-all devcontainer for directories without one
+     * Uses a temp directory to avoid polluting user's cwd
+     * Returns { configDir, workDir } where configDir contains .devcontainer
+     */
+    private setupCatchallDevcontainer;
+    /**
+     * Check if catch-all container image is available
+     * Returns true if image exists locally or can be pulled
+     */
+    private checkCatchallImage;
+}