@proletariat/cli 0.3.44 → 0.3.46

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/config/index.js

@@ -6,7 +6,7 @@ import { PromptCommand } from '../../lib/prompt-command.js';
 import { machineOutputFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
 import { getWorkspaceInfo } from '../../lib/agents/commands.js';
-import { loadExecutionConfig, saveTerminalApp, saveTerminalOpenInBackground, saveTmuxControlMode, saveShell, } from '../../lib/execution/config.js';
+import { loadExecutionConfig, saveTerminalApp, saveTerminalOpenInBackground, saveTmuxControlMode, saveShell, saveCreatePrDefault, saveFirewallAllowlistDomains, } from '../../lib/execution/config.js';
 import { shouldOutputJson, isNonTTY, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class Config extends PromptCommand {
     static description = 'View and update workspace configuration';
@@ -15,6 +15,7 @@ export default class Config extends PromptCommand {
         '<%= config.bin %> <%= command.id %> --json             # Output current config as JSON',
         '<%= config.bin %> <%= command.id %> --set terminal.app iTerm',
         '<%= config.bin %> <%= command.id %> --set terminal.openInBackground true',
+        '<%= config.bin %> <%= command.id %> --set firewall.allowlistDomains "api.staging.example.com"',
         '<%= config.bin %> <%= command.id %> --setting terminal.app --json  # Show terminal app choices',
     ];
     static flags = {
@@ -93,6 +94,10 @@ export default class Config extends PromptCommand {
                         defaultEnvironment: config.defaultEnvironment,
                         outputMode: config.outputMode,
                         sandboxed: config.sandboxed,
+                        createPrDefault: config.createPrDefault ?? null,
+                        firewall: {
+                            allowlistDomains: config.firewall.allowlistDomains,
+                        },
                     }, createMetadata('config', flags));
                 }
                 else {
@@ -115,6 +120,8 @@ export default class Config extends PromptCommand {
                     this.log(`  defaultEnvironment: ${config.defaultEnvironment}`);
                     this.log(`  outputMode:       ${config.outputMode}`);
                     this.log(`  sandboxed:        ${config.sandboxed}`);
+                    this.log(`  createPrDefault:  ${config.createPrDefault ?? 'not set (will prompt)'}`);
+                    this.log(`  firewall.allowlistDomains: ${config.firewall.allowlistDomains.join(', ') || '(none)'}`);
                     this.log('');
                 }
                 db.close();
@@ -132,6 +139,7 @@ export default class Config extends PromptCommand {
                 { name: `Open Tabs in Background: ${config.terminal.openInBackground}`, value: 'terminal.openInBackground', command: 'prlt config --setting terminal.openInBackground --json' },
                 { name: `Shell: ${config.shell}`, value: 'shell', command: 'prlt config --setting shell --json' },
                 { name: `Tmux Control Mode (iTerm -CC): ${config.tmux.controlMode}`, value: 'tmux.controlMode', command: 'prlt config --setting tmux.controlMode --json' },
+                { name: `Firewall allowlist domains: ${config.firewall.allowlistDomains.length || 0}`, value: 'firewall.allowlistDomains', command: 'prlt config --setting firewall.allowlistDomains --json' },
             ];
             const { setting } = await this.prompt([
                 {
@@ -145,6 +153,8 @@ export default class Config extends PromptCommand {
                         settingChoices[2],
                         new inquirer.Separator('── Tmux ──'),
                         settingChoices[3],
+                        new inquirer.Separator('── Execution ──'),
+                        settingChoices[4],
                         new inquirer.Separator(),
                         { name: 'Exit', value: '__exit__' },
                     ],
@@ -247,6 +257,23 @@ export default class Config extends PromptCommand {
                 this.log(styles.success(`Tmux control mode set to: ${controlMode}`));
                 break;
             }
+            case 'firewall.allowlistDomains': {
+                const { domainsInput } = await this.prompt([
+                    {
+                        type: 'input',
+                        name: 'domainsInput',
+                        message: 'Extra firewall allowlist domains (comma-separated, leave empty to clear):',
+                        default: config.firewall.allowlistDomains.join(', '),
+                    },
+                ], jsonModeConfig);
+                const domains = domainsInput
+                    .split(',')
+                    .map(domain => domain.trim())
+                    .filter(Boolean);
+                saveFirewallAllowlistDomains(db, domains);
+                this.log(styles.success(`Firewall allowlist domains set (${domains.length})`));
+                break;
+            }
             default: {
                 const jsonMode = shouldOutputJson(jsonModeConfig?.flags ?? {});
                 if (jsonMode) {
@@ -271,6 +298,17 @@ export default class Config extends PromptCommand {
             case 'tmux.controlmode':
                 saveTmuxControlMode(db, value.toLowerCase() === 'true');
                 break;
+            case 'execution.create_pr_default':
+                saveCreatePrDefault(db, value.toLowerCase() === 'true');
+                break;
+            case 'firewall.allowlistdomains': {
+                const domains = value
+                    .split(',')
+                    .map(domain => domain.trim())
+                    .filter(Boolean);
+                saveFirewallAllowlistDomains(db, domains);
+                break;
+            }
             default:
                 if (jsonMode) {
                     outputErrorAsJson('UNKNOWN_KEY', `Unknown config key: ${key}`, createMetadata('config', {}));

package/dist/commands/linear/auth.d.ts

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

package/dist/commands/linear/auth.js

@@ -0,0 +1,211 @@
+import { Flags } from '@oclif/core';
+import inquirer from 'inquirer';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { colors } from '../../lib/colors.js';
+import { shouldOutputJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { LinearClient, loadLinearConfig, saveLinearApiKey, saveLinearDefaultTeam, saveLinearOrganization, clearLinearConfig, getLinearApiKey, } from '../../lib/linear/index.js';
+export default class LinearAuth extends PMOCommand {
+    static description = 'Authenticate with Linear and configure workspace connection';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --check',
+        '<%= config.bin %> <%= command.id %> --force',
+        'LINEAR_API_KEY=lin_api_... <%= config.bin %> <%= command.id %>',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+        check: Flags.boolean({
+            description: 'Only check if Linear credentials exist (do not prompt)',
+            default: false,
+        }),
+        force: Flags.boolean({
+            description: 'Force re-authentication even if credentials exist',
+            default: false,
+        }),
+        disconnect: Flags.boolean({
+            description: 'Remove stored Linear credentials',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { flags } = await this.parse(LinearAuth);
+        const jsonMode = shouldOutputJson(flags);
+        const db = this.storage.getDatabase();
+        // Handle --disconnect
+        if (flags.disconnect) {
+            clearLinearConfig(db);
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    disconnected: true,
+                    message: 'Linear credentials removed.',
+                }, createMetadata('linear auth', flags));
+                return;
+            }
+            this.log(colors.success('Linear credentials removed.'));
+            return;
+        }
+        // Handle --check
+        if (flags.check) {
+            const config = loadLinearConfig(db);
+            if (config) {
+                // Try to verify the connection
+                try {
+                    const client = new LinearClient(config.apiKey);
+                    const info = await client.verify();
+                    if (jsonMode) {
+                        outputSuccessAsJson({
+                            authenticated: true,
+                            organization: info.organizationName,
+                            user: info.userName,
+                            email: info.email,
+                            defaultTeam: config.defaultTeamKey ?? null,
+                        }, createMetadata('linear auth', flags));
+                        return;
+                    }
+                    this.log(colors.success('Linear connection is active'));
+                    this.log(colors.textMuted(`  Organization: ${info.organizationName}`));
+                    this.log(colors.textMuted(`  User: ${info.userName} (${info.email})`));
+                    if (config.defaultTeamKey) {
+                        this.log(colors.textMuted(`  Default team: ${config.defaultTeamKey}`));
+                    }
+                }
+                catch (error) {
+                    if (jsonMode) {
+                        outputErrorAsJson('LINEAR_AUTH_INVALID', 'Stored Linear API key is invalid or expired.', createMetadata('linear auth', flags));
+                        this.exit(1);
+                    }
+                    this.log(colors.error('Stored Linear API key is invalid or expired.'));
+                    this.log(colors.textMuted('Run "prlt linear auth --force" to re-authenticate.'));
+                    this.exit(1);
+                }
+            }
+            else {
+                if (jsonMode) {
+                    outputErrorAsJson('LINEAR_NOT_CONFIGURED', 'Linear is not configured. Run "prlt linear auth" to authenticate.', createMetadata('linear auth', flags));
+                    this.exit(1);
+                }
+                this.log(colors.warning('Linear is not configured.'));
+                this.log(colors.textMuted('Run "prlt linear auth" to authenticate.'));
+                this.exit(1);
+            }
+            return;
+        }
+        // Check for existing config
+        const existingConfig = loadLinearConfig(db);
+        if (existingConfig && !flags.force) {
+            try {
+                const client = new LinearClient(existingConfig.apiKey);
+                const info = await client.verify();
+                if (jsonMode) {
+                    outputSuccessAsJson({
+                        authenticated: true,
+                        organization: info.organizationName,
+                        user: info.userName,
+                        message: 'Already authenticated. Use --force to re-authenticate.',
+                    }, createMetadata('linear auth', flags));
+                    return;
+                }
+                this.log(colors.success('Already connected to Linear'));
+                this.log(colors.textMuted(`  Organization: ${info.organizationName}`));
+                this.log(colors.textMuted(`  User: ${info.userName}`));
+                this.log('');
+                this.log(colors.textMuted('Use --force to re-authenticate.'));
+                return;
+            }
+            catch {
+                // Stored key is bad, proceed with re-auth
+            }
+        }
+        // Try environment variable first
+        const envKey = getLinearApiKey(db);
+        let apiKey = envKey;
+        if (!apiKey) {
+            // Prompt for API key
+            if (jsonMode) {
+                outputErrorAsJson('API_KEY_REQUIRED', 'Linear API key required. Set LINEAR_API_KEY or PRLT_LINEAR_API_KEY environment variable, or run interactively.', createMetadata('linear auth', flags));
+                this.exit(1);
+            }
+            this.log('');
+            this.log(colors.primary('Linear Authentication'));
+            this.log('');
+            this.log('Create a personal API key at:');
+            this.log(colors.textSecondary('  https://linear.app/settings/api'));
+            this.log('');
+            const { inputKey } = await inquirer.prompt([{
+                    type: 'password',
+                    name: 'inputKey',
+                    message: 'Enter your Linear API key:',
+                    mask: '*',
+                    validate: (input) => {
+                        if (!input.trim())
+                            return 'API key is required';
+                        if (!input.startsWith('lin_api_'))
+                            return 'Linear API keys start with "lin_api_"';
+                        return true;
+                    },
+                }]);
+            apiKey = inputKey;
+        }
+        // Verify the API key
+        this.log('');
+        this.log(colors.textMuted('Verifying API key...'));
+        let client;
+        try {
+            client = new LinearClient(apiKey);
+            const info = await client.verify();
+            // Save API key and org name
+            saveLinearApiKey(db, apiKey);
+            saveLinearOrganization(db, info.organizationName);
+            if (jsonMode) {
+                // Don't prompt for team in JSON mode, just save the key
+                outputSuccessAsJson({
+                    authenticated: true,
+                    organization: info.organizationName,
+                    user: info.userName,
+                    email: info.email,
+                }, createMetadata('linear auth', flags));
+                return;
+            }
+            this.log(colors.success(`Connected to ${info.organizationName}`));
+            this.log(colors.textMuted(`  Signed in as ${info.userName} (${info.email})`));
+        }
+        catch (error) {
+            if (jsonMode) {
+                outputErrorAsJson('LINEAR_AUTH_FAILED', `Authentication failed: ${error instanceof Error ? error.message : String(error)}`, createMetadata('linear auth', flags));
+                this.exit(1);
+            }
+            this.error(`Authentication failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Prompt for default team selection
+        this.log('');
+        const teams = await client.listTeams();
+        if (teams.length === 0) {
+            this.log(colors.warning('No teams found in your Linear workspace.'));
+            return;
+        }
+        if (teams.length === 1) {
+            // Auto-select the only team
+            saveLinearDefaultTeam(db, teams[0].id, teams[0].key);
+            this.log(colors.textMuted(`  Default team set to: ${teams[0].name} (${teams[0].key})`));
+        }
+        else {
+            const teamChoices = teams.map((t) => ({
+                name: `${t.name} (${t.key})`,
+                value: t.id,
+            }));
+            const { selectedTeamId } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'selectedTeamId',
+                    message: 'Select your default team:',
+                    choices: teamChoices,
+                }]);
+            const selectedTeam = teams.find((t) => t.id === selectedTeamId);
+            saveLinearDefaultTeam(db, selectedTeam.id, selectedTeam.key);
+            this.log(colors.textMuted(`  Default team set to: ${selectedTeam.name} (${selectedTeam.key})`));
+        }
+        this.log('');
+        this.log(colors.success('Linear integration configured!'));
+        this.log(colors.textMuted('  Run "prlt linear import" to pull issues into PMO'));
+        this.log(colors.textMuted('  Run "prlt work spawn --from-linear" to pull and spawn agents'));
+    }
+}

package/dist/commands/linear/import.d.ts

@@ -0,0 +1,21 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class LinearImport extends PMOCommand {
+    static description: string;
+    static strict: boolean;
+    static examples: string[];
+    static flags: {
+        team: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        state: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'state-type': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        label: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        assignee: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        cycle: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+}