@proletariat/cli 0.3.31 → 0.3.32

package/dist/commands/diet.d.ts

@@ -0,0 +1,20 @@
+import { PMOCommand } from '../lib/pmo/base-command.js';
+export default class Diet extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        set: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        reset: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected execute(): Promise<void>;
+    /**
+     * Build a diet report comparing actual Ready distribution to targets.
+     */
+    private buildDietReport;
+    /**
+     * Display the diet report with visual indicators.
+     */
+    private displayDietReport;
+}

package/dist/commands/diet.js

@@ -0,0 +1,181 @@
+import { Flags } from '@oclif/core';
+import { PMOCommand, pmoBaseFlags } from '../lib/pmo/base-command.js';
+import { styles, divider } from '../lib/styles.js';
+import { loadDietConfig, saveDietConfig, parseDietString, formatDietConfig, } from '../lib/pmo/diet.js';
+export default class Diet extends PMOCommand {
+    static description = 'Show or configure diet ratios for balanced ticket distribution';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --set "ship=4,grow=2.5,support=1.5,bizops=1,strategy=1"',
+        '<%= config.bin %> <%= command.id %> --reset',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+        set: Flags.string({
+            char: 's',
+            description: 'Set diet weights (e.g., "ship=4,grow=2,support=1") - normalized to percentages automatically',
+        }),
+        reset: Flags.boolean({
+            char: 'r',
+            description: 'Reset diet to default ratios',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { flags } = await this.parse(Diet);
+        const projectId = await this.requireProject();
+        const db = this.storage.getDatabase();
+        // Handle --set
+        if (flags.set) {
+            try {
+                const newConfig = parseDietString(flags.set);
+                saveDietConfig(db, newConfig);
+                this.log(styles.success(`Diet updated: ${formatDietConfig(newConfig)}`));
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.error(message);
+            }
+            return;
+        }
+        // Handle --reset
+        if (flags.reset) {
+            const { DEFAULT_DIET_CONFIG } = await import('../lib/pmo/diet.js');
+            saveDietConfig(db, DEFAULT_DIET_CONFIG);
+            this.log(styles.success(`Diet reset to defaults: ${formatDietConfig(DEFAULT_DIET_CONFIG)}`));
+            return;
+        }
+        // Show diet report
+        const dietConfig = loadDietConfig(db);
+        const report = await this.buildDietReport(projectId, dietConfig);
+        this.displayDietReport(report, dietConfig);
+    }
+    /**
+     * Build a diet report comparing actual Ready distribution to targets.
+     */
+    async buildDietReport(projectId, dietConfig) {
+        // Get all ready/unstarted tickets using statusCategory filter
+        const readyTickets = await this.storage.listTickets(projectId, { statusCategory: 'unstarted' });
+        const totalReady = readyTickets.length;
+        // Count by category
+        const categoryCounts = new Map();
+        let uncategorized = 0;
+        for (const ticket of readyTickets) {
+            const cat = (ticket.category || '').toLowerCase();
+            if (cat) {
+                categoryCounts.set(cat, (categoryCounts.get(cat) || 0) + 1);
+            }
+            else {
+                uncategorized++;
+            }
+        }
+        // Build category reports
+        const categories = dietConfig.ratios.map(ratio => {
+            const count = categoryCounts.get(ratio.category) || 0;
+            const actual = totalReady > 0 ? count / totalReady : 0;
+            const targetCount = Math.round(totalReady * ratio.target);
+            const delta = actual - ratio.target;
+            const tolerance = 0.05; // 5% tolerance
+            let status = 'ok';
+            if (delta > tolerance)
+                status = 'over';
+            else if (delta < -tolerance)
+                status = 'under';
+            return {
+                category: ratio.category,
+                target: ratio.target,
+                actual,
+                count,
+                targetCount,
+                delta,
+                status,
+            };
+        });
+        // Check for categories not in the diet config
+        for (const [cat, count] of categoryCounts) {
+            if (!dietConfig.ratios.some(r => r.category === cat)) {
+                const actual = totalReady > 0 ? count / totalReady : 0;
+                categories.push({
+                    category: cat,
+                    target: 0,
+                    actual,
+                    count,
+                    targetCount: 0,
+                    delta: actual,
+                    status: actual > 0.05 ? 'over' : 'ok',
+                });
+            }
+        }
+        return { categories, totalReady, uncategorized };
+    }
+    /**
+     * Display the diet report with visual indicators.
+     */
+    displayDietReport(report, dietConfig) {
+        this.log(styles.title('\nDiet Report'));
+        this.log(divider(65));
+        this.log(`  Current diet: ${formatDietConfig(dietConfig)}`);
+        this.log(`  Total in Ready: ${report.totalReady}`);
+        if (report.uncategorized > 0) {
+            this.log(styles.warning(`  Uncategorized: ${report.uncategorized}`));
+        }
+        this.log(divider(65));
+        if (report.totalReady === 0) {
+            this.log(styles.muted('\n  No tickets in Ready. Run "prlt pull" to populate.\n'));
+            return;
+        }
+        // Header
+        this.log('');
+        this.log(`  ${'Category'.padEnd(14)} ${'Target'.padEnd(8)} ${'Actual'.padEnd(8)} ${'Count'.padEnd(7)} ${'Status'.padEnd(8)} ${'Bar'}`);
+        this.log(`  ${divider(62).trim()}`);
+        // Category rows
+        for (const cat of report.categories) {
+            const targetPct = `${Math.round(cat.target * 100)}%`;
+            const actualPct = `${Math.round(cat.actual * 100)}%`;
+            const countStr = `${cat.count}/${cat.targetCount}`;
+            let statusIndicator;
+            switch (cat.status) {
+                case 'over':
+                    statusIndicator = styles.warning('OVER');
+                    break;
+                case 'under':
+                    statusIndicator = styles.error('UNDER');
+                    break;
+                default:
+                    statusIndicator = styles.success('OK');
+            }
+            // Visual bar (max 20 chars)
+            const barWidth = 20;
+            const actualBar = Math.round(cat.actual * barWidth);
+            const targetBar = Math.round(cat.target * barWidth);
+            let bar = '';
+            for (let i = 0; i < barWidth; i++) {
+                if (i < actualBar && i < targetBar) {
+                    bar += styles.success('█');
+                }
+                else if (i < actualBar) {
+                    bar += styles.warning('█');
+                }
+                else if (i < targetBar) {
+                    bar += styles.muted('░');
+                }
+                else {
+                    bar += ' ';
+                }
+            }
+            this.log(`  ${cat.category.padEnd(14)} ${targetPct.padEnd(8)} ${actualPct.padEnd(8)} ${countStr.padEnd(7)} ${statusIndicator.padEnd(8 + 10)} ${bar}`);
+        }
+        // Warnings
+        const warnings = report.categories.filter(c => c.status !== 'ok');
+        if (warnings.length > 0) {
+            this.log('');
+            this.log(styles.warning('  Warnings:'));
+            for (const w of warnings) {
+                const direction = w.status === 'over' ? 'over' : 'under';
+                const delta = Math.abs(Math.round(w.delta * 100));
+                this.log(styles.warning(`    ${w.category}: ${delta}% ${direction}-represented`));
+            }
+        }
+        this.log('');
+    }
+}

package/dist/commands/mcp-server.js

@@ -19,7 +19,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { execSync } from 'node:child_process';
 import * as path from 'node:path';
 import { getPMOContext } from '../lib/pmo/pmo-context.js';
-import { registerTicketTools, registerProjectTools, registerBoardTools, registerSpecTools, registerEpicTools, registerWorkTools, registerWorkflowTools, registerStatusTools, registerPhaseTools, registerActionTools, registerRoadmapTools, registerCategoryTools, registerTemplateTools, registerViewTools, registerAgentTools, registerDockerTools, registerRepoTools, registerBranchTools, registerGitHubTools, registerInitTools, registerUtilityTools, } from '../lib/mcp/index.js';
+import { registerTicketTools, registerProjectTools, registerBoardTools, registerSpecTools, registerEpicTools, registerWorkTools, registerWorkflowTools, registerStatusTools, registerPhaseTools, registerActionTools, registerRoadmapTools, registerCategoryTools, registerTemplateTools, registerViewTools, registerDietTools, registerAgentTools, registerDockerTools, registerRepoTools, registerBranchTools, registerGitHubTools, registerInitTools, registerUtilityTools, } from '../lib/mcp/index.js';
 export default class McpServerCommand extends Command {
     static description = 'Start MCP server for AI agent integration (exposes all prlt commands as tools)';
     static hidden = true;
@@ -84,6 +84,7 @@ export default class McpServerCommand extends Command {
         registerCategoryTools(server, ctx);
         registerTemplateTools(server, ctx);
         registerViewTools(server, ctx);
+        registerDietTools(server, ctx);
         registerAgentTools(server, ctx);
         registerDockerTools(server, ctx);
         registerRepoTools(server, ctx);

package/dist/commands/priority/add.d.ts

@@ -0,0 +1,15 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class PriorityAdd extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        value: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        position: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        after: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: 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/priority/add.js

@@ -0,0 +1,70 @@
+import { Args, Flags } from '@oclif/core';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { styles } from '../../lib/styles.js';
+import { getWorkspacePriorities, setWorkspacePriorities } from '../../lib/pmo/utils.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+export default class PriorityAdd extends PMOCommand {
+    static description = 'Add a priority value to the workspace scale';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> Critical',
+        '<%= config.bin %> <%= command.id %> "Must Have" --position 0',
+        '<%= config.bin %> <%= command.id %> P4 --after P3',
+    ];
+    static args = {
+        value: Args.string({
+            description: 'Priority value to add',
+            required: true,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        position: Flags.integer({
+            description: 'Position in the priority scale (0 = highest)',
+        }),
+        after: Flags.string({
+            description: 'Insert after this priority value',
+            exclusive: ['position'],
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(PriorityAdd);
+        const jsonMode = shouldOutputJson(flags);
+        const db = this.storage.getDatabase();
+        const priorities = getWorkspacePriorities(db);
+        // Check for duplicates
+        if (priorities.includes(args.value)) {
+            if (jsonMode) {
+                outputErrorAsJson('DUPLICATE_PRIORITY', `Priority "${args.value}" already exists`, createMetadata('priority add', flags));
+                this.exit(1);
+            }
+            this.error(`Priority "${args.value}" already exists in the scale: ${priorities.join(', ')}`);
+        }
+        // Determine insertion position
+        let insertAt = priorities.length; // Default: append to end (lowest priority)
+        if (flags.position !== undefined) {
+            insertAt = Math.max(0, Math.min(flags.position, priorities.length));
+        }
+        else if (flags.after) {
+            const afterIndex = priorities.indexOf(flags.after);
+            if (afterIndex < 0) {
+                if (jsonMode) {
+                    outputErrorAsJson('PRIORITY_NOT_FOUND', `Priority "${flags.after}" not found`, createMetadata('priority add', flags));
+                    this.exit(1);
+                }
+                this.error(`Priority "${flags.after}" not found in the scale: ${priorities.join(', ')}`);
+            }
+            insertAt = afterIndex + 1;
+        }
+        // Insert at position
+        const newPriorities = [...priorities];
+        newPriorities.splice(insertAt, 0, args.value);
+        setWorkspacePriorities(db, newPriorities);
+        if (jsonMode) {
+            this.log(JSON.stringify({ success: true, priorities: newPriorities }, null, 2));
+            return;
+        }
+        this.log(styles.success(`\n✅ Added priority "${args.value}" at position ${insertAt}`));
+        this.log(styles.muted(`   Scale: ${newPriorities.join(', ')}`));
+        this.log('');
+    }
+}

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

@@ -0,0 +1,10 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class PriorityList extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: 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/priority/list.js

@@ -0,0 +1,34 @@
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { styles } from '../../lib/styles.js';
+import { getWorkspacePriorities } from '../../lib/pmo/utils.js';
+import { isMachineOutput } from '../../lib/prompt-json.js';
+export default class PriorityList extends PMOCommand {
+    static description = 'List the workspace priority scale';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+    };
+    async execute() {
+        const { flags } = await this.parse(PriorityList);
+        const db = this.storage.getDatabase();
+        const priorities = getWorkspacePriorities(db);
+        if (isMachineOutput(flags)) {
+            this.log(JSON.stringify({ priorities }, null, 2));
+            return;
+        }
+        this.log(`\n${styles.emphasis('Priority Scale')} (highest to lowest)`);
+        this.log('─'.repeat(40));
+        for (let i = 0; i < priorities.length; i++) {
+            const marker = i === 0 ? '🔴' : i === 1 ? '🟠' : i === 2 ? '🟡' : '🟢';
+            this.log(`  ${marker} ${priorities[i]}`);
+        }
+        this.log('');
+        this.log(styles.muted('Manage: prlt priority set <values...>'));
+        this.log(styles.muted('        prlt priority add <value>'));
+        this.log(styles.muted('        prlt priority remove <value>'));
+        this.log('');
+    }
+}

package/dist/commands/priority/remove.d.ts

@@ -0,0 +1,13 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class PriorityRemove extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        value: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: 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/priority/remove.js

@@ -0,0 +1,54 @@
+import { Args } from '@oclif/core';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { styles } from '../../lib/styles.js';
+import { getWorkspacePriorities, setWorkspacePriorities } from '../../lib/pmo/utils.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+export default class PriorityRemove extends PMOCommand {
+    static description = 'Remove a priority value from the workspace scale';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> P3',
+        '<%= config.bin %> <%= command.id %> Low',
+    ];
+    static args = {
+        value: Args.string({
+            description: 'Priority value to remove',
+            required: true,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+    };
+    async execute() {
+        const { args, flags } = await this.parse(PriorityRemove);
+        const jsonMode = shouldOutputJson(flags);
+        const db = this.storage.getDatabase();
+        const priorities = getWorkspacePriorities(db);
+        // Check that the priority exists
+        if (!priorities.includes(args.value)) {
+            if (jsonMode) {
+                outputErrorAsJson('PRIORITY_NOT_FOUND', `Priority "${args.value}" not found`, createMetadata('priority remove', flags));
+                this.exit(1);
+            }
+            this.error(`Priority "${args.value}" not found in the scale: ${priorities.join(', ')}`);
+        }
+        // Must keep at least one priority
+        if (priorities.length <= 1) {
+            if (jsonMode) {
+                outputErrorAsJson('MIN_PRIORITIES', 'Cannot remove the last priority. Use "prlt priority set" to replace the scale.', createMetadata('priority remove', flags));
+                this.exit(1);
+            }
+            this.error('Cannot remove the last priority. Use "prlt priority set" to replace the scale.');
+        }
+        const newPriorities = priorities.filter(p => p !== args.value);
+        setWorkspacePriorities(db, newPriorities);
+        if (jsonMode) {
+            this.log(JSON.stringify({ success: true, priorities: newPriorities, removed: args.value }, null, 2));
+            return;
+        }
+        this.log(styles.success(`\n✅ Removed priority "${args.value}"`));
+        this.log(styles.muted(`   Scale: ${newPriorities.join(', ')}`));
+        this.log(styles.muted('\n   Note: Existing tickets with this priority are not affected.'));
+        this.log(styles.muted('   You may want to update them manually.'));
+        this.log('');
+    }
+}

package/dist/commands/priority/set.d.ts

@@ -0,0 +1,14 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class PrioritySet extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static strict: boolean;
+    static args: {
+        priorities: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: 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/priority/set.js

@@ -0,0 +1,60 @@
+import { Args } from '@oclif/core';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { styles } from '../../lib/styles.js';
+import { getWorkspacePriorities, setWorkspacePriorities } from '../../lib/pmo/utils.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+export default class PrioritySet extends PMOCommand {
+    static description = 'Set the workspace priority scale (replaces all existing priorities)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> P0 P1 P2 P3',
+        '<%= config.bin %> <%= command.id %> Critical High Medium Low',
+        '<%= config.bin %> <%= command.id %> Now Next Later',
+        '<%= config.bin %> <%= command.id %> "Must Have" "Should Have" "Nice to Have"',
+    ];
+    static strict = false;
+    static args = {
+        priorities: Args.string({
+            description: 'Priority values from highest to lowest (space-separated)',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+    };
+    async execute() {
+        const { flags, argv } = await this.parse(PrioritySet);
+        const jsonMode = shouldOutputJson(flags);
+        const db = this.storage.getDatabase();
+        // argv contains all the non-flag arguments
+        const newPriorities = argv.filter(a => a.trim());
+        if (newPriorities.length === 0) {
+            if (jsonMode) {
+                outputErrorAsJson('NO_PRIORITIES', 'At least one priority value is required', createMetadata('priority set', flags));
+                this.exit(1);
+            }
+            this.error('At least one priority value is required.\n\nUsage: prlt priority set <value1> <value2> ...\nExample: prlt priority set P0 P1 P2 P3');
+        }
+        // Check for duplicates
+        const seen = new Set();
+        for (const p of newPriorities) {
+            if (seen.has(p)) {
+                if (jsonMode) {
+                    outputErrorAsJson('DUPLICATE_PRIORITY', `Duplicate priority value: "${p}"`, createMetadata('priority set', flags));
+                    this.exit(1);
+                }
+                this.error(`Duplicate priority value: "${p}". Each priority must be unique.`);
+            }
+            seen.add(p);
+        }
+        const oldPriorities = getWorkspacePriorities(db);
+        setWorkspacePriorities(db, newPriorities);
+        if (jsonMode) {
+            this.log(JSON.stringify({ success: true, priorities: newPriorities }, null, 2));
+            return;
+        }
+        this.log(styles.success(`\n✅ Priority scale updated`));
+        this.log(styles.muted(`   Before: ${oldPriorities.join(', ')}`));
+        this.log(styles.muted(`   After:  ${newPriorities.join(', ')}`));
+        this.log('');
+    }
+}

package/dist/commands/pull.d.ts

@@ -0,0 +1,23 @@
+import { PMOCommand } from '../lib/pmo/base-command.js';
+export default class Pull extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        count: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected execute(): Promise<void>;
+    /**
+     * Core pull algorithm with diet enforcement.
+     *
+     * Pass 1: Walk backlog top-down, pull if category not over ceiling
+     * Pass 2: Force-pull from underrepresented categories
+     */
+    private runPullAlgorithm;
+    /**
+     * Display pull results.
+     */
+    private displayPullResults;
+}