@proletariat/cli 0.3.34 → 0.3.36

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

@@ -0,0 +1,144 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { PromptCommand } from '../../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../../lib/pmo/index.js';
+import { getWorkspaceInfo } from '../../../lib/agents/commands.js';
+import { ensureBuiltinThemes } from '../../../lib/themes.js';
+import { getThemes, getAvailableThemeNames } from '../../../lib/database/index.js';
+import { shouldOutputJson, outputPromptAsJson, createMetadata, buildPromptConfig, } from '../../../lib/prompt-json.js';
+export default class AgentThemes extends PromptCommand {
+    static description = 'Manage agent naming themes';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> list',
+        '<%= config.bin %> <%= command.id %> create greek-gods',
+        '<%= config.bin %> <%= command.id %> add-names greek-gods zeus athena',
+    ];
+    static flags = {
+        ...machineOutputFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(AgentThemes);
+        const jsonMode = shouldOutputJson(flags);
+        const menuChoices = [
+            { id: 'list', name: 'List themes', command: 'prlt agent themes list --format json' },
+            { id: 'create', name: 'Create a new theme', command: 'prlt agent themes create --machine' },
+            { id: 'add-names', name: 'Add names to a theme', command: 'prlt agent themes add-names --machine' },
+            { id: 'cancel', name: 'Cancel', command: '' },
+        ];
+        const message = 'What would you like to do?';
+        if (jsonMode) {
+            outputPromptAsJson(buildPromptConfig('list', 'action', message, menuChoices.map(c => ({
+                name: c.name,
+                value: c.id,
+                command: c.command,
+            }))), createMetadata('agent themes', flags));
+            return;
+        }
+        this.log(chalk.bold('\nAgent Themes'));
+        this.log(chalk.dim('Optional themed name pools for your agents.\n'));
+        const { action } = await this.prompt([{
+                type: 'list',
+                name: 'action',
+                message,
+                choices: [
+                    ...menuChoices.slice(0, 3).map(c => ({ name: c.name, value: c.id })),
+                    new inquirer.Separator(),
+                    { name: menuChoices[3].name, value: menuChoices[3].id }
+                ]
+            }], null);
+        if (action === 'cancel') {
+            this.log(chalk.dim('Cancelled.'));
+            return;
+        }
+        try {
+            switch (action) {
+                case 'list': {
+                    const { default: ListCommand } = await import('./list.js');
+                    const cmd = new ListCommand([], this.config);
+                    await cmd.run();
+                    break;
+                }
+                case 'create': {
+                    const { themeName } = await this.prompt([{
+                            type: 'input',
+                            name: 'themeName',
+                            message: 'Theme name:',
+                            validate: (input) => {
+                                if (!input.trim())
+                                    return 'Theme name is required';
+                                return true;
+                            }
+                        }], null);
+                    const normalized = themeName.trim().toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '');
+                    if (themeName.trim() !== normalized) {
+                        this.log(chalk.blue(`Normalized: ${themeName.trim()} → ${normalized}`));
+                    }
+                    const { default: CreateCommand } = await import('./create.js');
+                    const cmd = new CreateCommand([normalized], this.config);
+                    await cmd.run();
+                    const { addNamesNow } = await this.prompt([{
+                            type: 'list',
+                            name: 'addNamesNow',
+                            message: 'Add names to this theme now?',
+                            choices: [
+                                { name: 'Yes', value: true },
+                                { name: 'No', value: false },
+                            ],
+                        }], null);
+                    if (addNamesNow) {
+                        const { names } = await this.prompt([{
+                                type: 'input',
+                                name: 'names',
+                                message: 'Enter names (space-separated):',
+                                validate: (input) => input.trim() ? true : 'At least one name is required'
+                            }], null);
+                        const addArgs = [normalized, ...names.trim().split(/\s+/)];
+                        const { default: AddNamesCommand } = await import('./add-names.js');
+                        const addCmd = new AddNamesCommand(addArgs, this.config);
+                        await addCmd.run();
+                    }
+                    break;
+                }
+                case 'add-names': {
+                    const workspaceInfo = getWorkspaceInfo();
+                    ensureBuiltinThemes(workspaceInfo.path);
+                    const themes = getThemes(workspaceInfo.path);
+                    if (themes.length === 0) {
+                        this.log(chalk.yellow('No themes found. Create one first.'));
+                        return;
+                    }
+                    const themeChoices = themes.map(t => {
+                        const availableNames = getAvailableThemeNames(workspaceInfo.path, t.id);
+                        const builtinTag = t.builtin ? chalk.dim(' [built-in]') : '';
+                        return {
+                            name: `${t.display_name}${builtinTag} ${chalk.dim(`(${availableNames.length} names available)`)}`,
+                            value: t.id
+                        };
+                    });
+                    const { selectedTheme } = await this.prompt([{
+                            type: 'list',
+                            name: 'selectedTheme',
+                            message: 'Select theme to add names to:',
+                            choices: themeChoices
+                        }], null);
+                    const { names } = await this.prompt([{
+                            type: 'input',
+                            name: 'names',
+                            message: 'Names to add (space-separated):',
+                            validate: (input) => input.trim() ? true : 'At least one name is required'
+                        }], null);
+                    const addArgs = [selectedTheme, ...names.trim().split(/\s+/)];
+                    const { default: AddNamesCommand } = await import('./add-names.js');
+                    const cmd = new AddNamesCommand(addArgs, this.config);
+                    await cmd.run();
+                    break;
+                }
+                default:
+                    this.error(`Unknown action: ${action}`);
+            }
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error));
+        }
+    }
+}

package/dist/commands/agent/themes/list.d.ts

@@ -0,0 +1 @@
+export { default } from '../../theme/list.js';

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

@@ -0,0 +1 @@
+export { default } from '../../theme/list.js';

package/dist/commands/agent/themes/set.d.ts

@@ -0,0 +1 @@
+export { default } from '../../theme/set.js';

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

@@ -0,0 +1 @@
+export { default } from '../../theme/set.js';

package/dist/commands/agents/themes/add-names.d.ts

@@ -0,0 +1 @@
+export { default } from '../../theme/add-names.js';

package/dist/commands/agents/themes/add-names.js

@@ -0,0 +1 @@
+export { default } from '../../theme/add-names.js';

package/dist/commands/agents/themes/create.d.ts

@@ -0,0 +1 @@
+export { default } from '../../theme/create.js';

package/dist/commands/agents/themes/create.js

@@ -0,0 +1 @@
+export { default } from '../../theme/create.js';

package/dist/commands/agents/themes/list.d.ts

@@ -0,0 +1 @@
+export { default } from '../../theme/list.js';

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

@@ -0,0 +1 @@
+export { default } from '../../theme/list.js';

package/dist/commands/board/watch.js

@@ -3,6 +3,7 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 import chalk from 'chalk';
 import { PMOCommand, pmoBaseFlags, runWatcherForeground } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 import { styles } from '../../lib/styles.js';
 export default class BoardWatch extends PMOCommand {
     static description = 'Watch board.md for changes and auto-sync to SQLite';
@@ -23,6 +24,11 @@ export default class BoardWatch extends PMOCommand {
     }
     async execute() {
         const { flags } = await this.parse(BoardWatch);
+        if (shouldOutputJson(flags)) {
+            this.log(JSON.stringify({ type: 'error', error: { code: 'REQUIRES_TTY', message: 'board watch is a long-running interactive command. Use "prlt board" for non-interactive board data.' } }));
+            this.exit(1);
+            return;
+        }
         // Load PMO config
         const configPath = path.join(this.pmoPath, 'config.json');
         if (!fs.existsSync(configPath)) {

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

@@ -14,6 +14,7 @@ export default class BranchList extends PMOCommand {
         promptIfMultiple: boolean;
     };
     execute(): Promise<void>;
+    private listBranchesAcrossRepos;
     private outputTable;
     private outputCompact;
 }

package/dist/commands/branch/list.js

@@ -2,6 +2,7 @@ import { Flags } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
 import { BRANCH_TYPES, listBranches, isGitRepo, } from '../../lib/branch/index.js';
+import { getWorkspaceRepoInfo } from '../../lib/repos/index.js';
 import { isNonTTY } from '../../lib/prompt-json.js';
 import { visualPadEnd } from '../../lib/string-utils.js';
 export default class BranchList extends PMOCommand {
@@ -40,12 +41,15 @@ export default class BranchList extends PMOCommand {
         if (flags.format === 'table' && isNonTTY()) {
             flags.format = 'json';
         }
-        // Check if in git repo
-        if (!isGitRepo()) {
-            this.error('Not in a git repository.');
+        let branches;
+        if (isGitRepo()) {
+            // In a git repo - list branches for current repo
+            branches = listBranches(undefined, flags.all);
+        }
+        else {
+            // Not in a git repo - list branches across all registered HQ repos
+            branches = this.listBranchesAcrossRepos(flags.all);
         }
-        // Get branches
-        let branches = listBranches(undefined, flags.all);
         // Filter by type
         if (flags.type) {
             branches = branches.filter((b) => b.type === flags.type);
@@ -59,31 +63,55 @@ export default class BranchList extends PMOCommand {
             }
             return;
         }
+        // Check if we have multi-repo results
+        const hasRepoInfo = branches.some((b) => b.repo);
         // Output based on format
         switch (flags.format) {
             case 'json':
                 this.log(JSON.stringify(branches, null, 2));
                 break;
             case 'compact':
-                this.outputCompact(branches);
+                this.outputCompact(branches, hasRepoInfo);
                 break;
             case 'table':
             default:
-                this.outputTable(branches);
+                this.outputTable(branches, hasRepoInfo);
                 break;
         }
     }
-    outputTable(branches) {
+    listBranchesAcrossRepos(includeRemote) {
+        let repoInfo;
+        try {
+            repoInfo = getWorkspaceRepoInfo();
+        }
+        catch {
+            this.error('Not in a git repository and no HQ workspace found.');
+        }
+        const allBranches = [];
+        for (const repo of repoInfo.repositories) {
+            if (repo.status === 'missing')
+                continue;
+            const repoBranches = listBranches(repo.fullPath, includeRemote);
+            for (const branch of repoBranches) {
+                branch.repo = repo.name;
+                allBranches.push(branch);
+            }
+        }
+        return allBranches;
+    }
+    outputTable(branches, hasRepoInfo = false) {
         this.log('');
         this.log(styles.header(`🌿 Branches (${branches.length})`));
         this.log('');
         // Header
-        this.log(styles.muted(visualPadEnd('Name', 35) +
+        const repoHeader = hasRepoInfo ? visualPadEnd('Repo', 18) : '';
+        this.log(styles.muted(repoHeader +
+            visualPadEnd('Name', 35) +
             visualPadEnd('Type', 8) +
             visualPadEnd('Owner', 12) +
             visualPadEnd('Description', 25) +
             'Status'));
-        this.log('─'.repeat(90));
+        this.log('─'.repeat(hasRepoInfo ? 108 : 90));
         // Rows
         for (const branch of branches) {
             const marker = branch.current ? '* ' : '  ';
@@ -91,6 +119,7 @@ export default class BranchList extends PMOCommand {
             const typeDisplay = branch.type || '-';
             const ownerDisplay = branch.owner || '-';
             const descDisplay = branch.description || '-';
+            const repoCol = hasRepoInfo ? visualPadEnd((branch.repo || '-').substring(0, 16), 18) : '';
             let status = 'local';
             if (branch.tracking) {
                 status = `tracking ${branch.tracking}`;
@@ -99,6 +128,7 @@ export default class BranchList extends PMOCommand {
                 status = 'current';
             }
             this.log(marker +
+                repoCol +
                 nameStyle(visualPadEnd(branch.name.substring(0, 33), 33)) +
                 visualPadEnd(typeDisplay, 8) +
                 visualPadEnd(ownerDisplay.substring(0, 10), 12) +
@@ -109,14 +139,15 @@ export default class BranchList extends PMOCommand {
         this.log(styles.muted('Legend: * = current branch'));
         this.log('');
     }
-    outputCompact(branches) {
+    outputCompact(branches, hasRepoInfo = false) {
         this.log('');
         for (const branch of branches) {
             const marker = branch.current ? '* ' : '  ';
             const icon = branch.type ? '🌿' : '  ';
             const typeInfo = branch.type ? ` (${branch.type})` : '';
+            const repoPrefix = hasRepoInfo && branch.repo ? `[${branch.repo}] ` : '';
             const nameStyle = branch.current ? styles.success : (s) => s;
-            this.log(`${icon} ${marker}${nameStyle(branch.name)}${styles.muted(typeInfo)}`);
+            this.log(`${icon} ${marker}${repoPrefix}${nameStyle(branch.name)}${styles.muted(typeInfo)}`);
         }
         this.log('');
     }

package/dist/commands/branch/where.js

@@ -2,6 +2,7 @@ import { Args } from '@oclif/core';
 import { execSync } from 'node:child_process';
 import * as path from 'node:path';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 import { styles } from '../../lib/styles.js';
 import { isGitRepo, isTicketId } from '../../lib/branch/index.js';
 import { openWorkspaceDatabase } from '../../lib/database/index.js';
@@ -40,7 +41,7 @@ export default class BranchWhere extends PMOCommand {
         // Combine results, preferring git worktree info
         const allMatches = this.mergeResults(matches, dbMatches);
         if (allMatches.length === 0) {
-            if (flags.json || flags.machine) {
+            if (shouldOutputJson(flags)) {
                 this.log(JSON.stringify({ found: false, search, matches: [] }, null, 2));
             }
             else {
@@ -48,7 +49,7 @@ export default class BranchWhere extends PMOCommand {
             }
             return;
         }
-        if (flags.json || flags.machine) {
+        if (shouldOutputJson(flags)) {
             this.log(JSON.stringify({
                 found: true,
                 search,

package/dist/commands/category/list.d.ts

@@ -3,7 +3,7 @@ export default class CategoryList extends PMOCommand {
     static description: string;
     static examples: string[];
     static flags: {
-        type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         builtin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         custom: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
@@ -14,5 +14,6 @@ export default class CategoryList extends PMOCommand {
         promptIfMultiple: boolean;
     };
     execute(): Promise<void>;
+    private printCategoryGroup;
     private printCategory;
 }

package/dist/commands/category/list.js

@@ -1,9 +1,11 @@
 import { Flags } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 import { styles } from '../../lib/styles.js';
 export default class CategoryList extends PMOCommand {
     static description = 'List categories for ticket or status types';
     static examples = [
+        '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --type ticket',
         '<%= config.bin %> <%= command.id %> --type status',
         '<%= config.bin %> <%= command.id %> --type ticket --builtin',
@@ -13,9 +15,8 @@ export default class CategoryList extends PMOCommand {
         ...pmoBaseFlags,
         type: Flags.string({
             char: 't',
-            description: 'Category type to list',
+            description: 'Category type to list (omit to list all)',
             options: ['ticket', 'status'],
-            required: true,
         }),
         builtin: Flags.boolean({
             description: 'Show only built-in categories',
@@ -36,25 +37,52 @@ export default class CategoryList extends PMOCommand {
     async execute() {
         const { flags } = await this.parse(CategoryList);
         const categoryType = flags.type;
-        let filter = { type: categoryType };
+        const filter = {};
+        if (categoryType)
+            filter.type = categoryType;
         if (flags.builtin)
             filter.isBuiltin = true;
         if (flags.custom)
             filter.isBuiltin = false;
         const categories = await this.storage.listCategories(filter);
-        if (flags.json || flags.machine) {
+        if (shouldOutputJson(flags)) {
             this.log(JSON.stringify(categories, null, 2));
             return;
         }
         if (categories.length === 0) {
-            this.log(styles.muted(`\nNo ${categoryType} categories found.`));
-            this.log(styles.muted(`Create one: prlt category create --type ${categoryType}`));
+            const typeStr = categoryType ? `${categoryType} ` : '';
+            this.log(styles.muted(`\nNo ${typeStr}categories found.`));
+            this.log(styles.muted(`Create one: prlt category create --type ticket`));
             return;
         }
-        const typeLabel = categoryType === 'ticket' ? 'Ticket' : 'Status';
-        this.log(`\n📁 ${styles.emphasis(`${typeLabel} Categories`)}`);
-        this.log('═'.repeat(60));
-        // Group by builtin vs custom
+        if (categoryType) {
+            // Single type: show as before
+            const typeLabel = categoryType === 'ticket' ? 'Ticket' : 'Status';
+            this.log(`\n📁 ${styles.emphasis(`${typeLabel} Categories`)}`);
+            this.log('═'.repeat(60));
+            this.printCategoryGroup(categories, flags);
+            this.log('');
+            this.log(styles.muted(`Create new: prlt category create --type ${categoryType} <name>`));
+            this.log('');
+        }
+        else {
+            // All types: group by type
+            const ticketCategories = categories.filter(c => c.type === 'ticket');
+            const statusCategories = categories.filter(c => c.type === 'status');
+            if (ticketCategories.length > 0) {
+                this.log(`\n📁 ${styles.emphasis('Ticket Categories')}`);
+                this.log('═'.repeat(60));
+                this.printCategoryGroup(ticketCategories, flags);
+            }
+            if (statusCategories.length > 0) {
+                this.log(`\n📁 ${styles.emphasis('Status Categories')}`);
+                this.log('═'.repeat(60));
+                this.printCategoryGroup(statusCategories, flags);
+            }
+            this.log('');
+        }
+    }
+    printCategoryGroup(categories, flags) {
         const builtinCategories = categories.filter(c => c.isBuiltin);
         const customCategories = categories.filter(c => !c.isBuiltin);
         if (builtinCategories.length > 0 && !flags.custom) {
@@ -71,9 +99,6 @@ export default class CategoryList extends PMOCommand {
                 this.printCategory(category);
             }
         }
-        this.log('');
-        this.log(styles.muted(`Create new: prlt category create --type ${categoryType} <name>`));
-        this.log('');
     }
     printCategory(category) {
         const builtinBadge = category.isBuiltin ? '' : ' [custom]';

package/dist/commands/{claude.d.ts → claude/index.d.ts}

@@ -1,4 +1,4 @@
-import { PromptCommand } from '../lib/prompt-command.js';
+import { PromptCommand } from '../../lib/prompt-command.js';
 export default class Claude extends PromptCommand {
     static description: string;
     static examples: string[];

package/dist/commands/{claude.js → claude/index.js}

@@ -3,18 +3,18 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
 import { execSync } from 'node:child_process';
-import { PromptCommand } from '../lib/prompt-command.js';
-import { machineOutputFlags } from '../lib/pmo/index.js';
+import { PromptCommand } from '../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
 import Database from 'better-sqlite3';
-import { findHQRoot } from '../lib/workspace.js';
-import { getWorkspaceInfo, createEphemeralAgent, } from '../lib/agents/commands.js';
-import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../lib/prompt-json.js';
-import { styles } from '../lib/styles.js';
-import { DEFAULT_EXECUTION_CONFIG, } from '../lib/execution/types.js';
-import { runExecution, isDockerRunning, isGitHubTokenAvailable, isDevcontainerCliInstalled } from '../lib/execution/runners.js';
-import { ExecutionStorage } from '../lib/execution/storage.js';
-import { loadExecutionConfig, getTerminalApp, promptTerminalPreference, getShell, promptShellPreference, hasTerminalPreference, hasShellPreference, } from '../lib/execution/config.js';
-import { hasDevcontainerConfig } from '../lib/execution/devcontainer.js';
+import { findHQRoot } from '../../lib/workspace.js';
+import { getWorkspaceInfo, createEphemeralAgent, } from '../../lib/agents/commands.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { styles } from '../../lib/styles.js';
+import { DEFAULT_EXECUTION_CONFIG, } from '../../lib/execution/types.js';
+import { runExecution, isDockerRunning, isGitHubTokenAvailable, isDevcontainerCliInstalled } from '../../lib/execution/runners.js';
+import { ExecutionStorage } from '../../lib/execution/storage.js';
+import { loadExecutionConfig, getTerminalApp, promptTerminalPreference, getShell, promptShellPreference, hasTerminalPreference, hasShellPreference, } from '../../lib/execution/config.js';
+import { hasDevcontainerConfig } from '../../lib/execution/devcontainer.js';
 // Catch-all devcontainer image for directories without .devcontainer
 const CATCHALL_DEVCONTAINER_IMAGE = 'ghcr.io/chrismcdermut/proletariat-claude:latest';
 /**
@@ -450,7 +450,7 @@ export default class Claude extends PromptCommand {
         const executionStorage = new ExecutionStorage(db);
         try {
             // Import PMO storage for ticket/project operations
-            const { getPMOContext } = await import('../lib/pmo/index.js');
+            const { getPMOContext } = await import('../../lib/pmo/index.js');
             let pmoPath;
             let storage;
             try {

package/dist/commands/claude/open.d.ts

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