@proletariat/cli 0.3.26 → 0.3.28

package/dist/commands/epic/list.js

@@ -1,6 +1,7 @@
 import { Flags } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 // Progress bar helper
 function progressBar(percent, width = 20) {
     const filled = Math.round((percent / 100) * width);
@@ -23,15 +24,18 @@ export default class EpicList extends PMOCommand {
     };
     async execute() {
         const { flags } = await this.parse(EpicList);
+        const jsonMode = shouldOutputJson(flags);
         const projectId = await this.requireProject();
         const epics = await this.storage.listEpics(projectId, flags.status ? { status: flags.status } : undefined);
         if (epics.length === 0) {
+            if (jsonMode) {
+                this.log(JSON.stringify([], null, 2));
+                return;
+            }
             this.log(styles.muted('\nNo epics found.'));
             this.log(styles.muted('Create one with: prlt epic create'));
             return;
         }
-        // Group epics by status
-        const grouped = this.groupByStatus(epics);
         // Get ticket counts for each epic in parallel
         const ticketCounts = await Promise.all(epics.map(async (epic) => {
             const tickets = await this.storage.getTicketsForEpic(projectId, epic.id);
@@ -39,6 +43,17 @@ export default class EpicList extends PMOCommand {
             return { epicId: epic.id, done, total: tickets.length };
         }));
         const epicProgress = new Map(ticketCounts.map(({ epicId, done, total }) => [epicId, { done, total }]));
+        if (jsonMode) {
+            const epicsWithProgress = epics.map(epic => {
+                const progress = epicProgress.get(epic.id) || { done: 0, total: 0 };
+                const percent = progress.total > 0 ? Math.round((progress.done / progress.total) * 100) : 0;
+                return { ...epic, progress: { ...progress, percent } };
+            });
+            this.log(JSON.stringify(epicsWithProgress, null, 2));
+            return;
+        }
+        // Group epics by status
+        const grouped = this.groupByStatus(epics);
         const projectName = await this.getProjectName(projectId);
         this.log(`\n🎯 ${styles.emphasis('Epics')} - ${projectName}`);
         this.log('═'.repeat(55));

package/dist/commands/execution/list.js

@@ -5,6 +5,8 @@ import { styles } from '../../lib/styles.js';
 import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { ExecutionStorage } from '../../lib/execution/storage.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
+import { visualPadEnd } from '../../lib/string-utils.js';
 export default class ExecutionList extends PMOCommand {
     static description = 'List running and recent executions';
     static examples = [
@@ -36,6 +38,7 @@ export default class ExecutionList extends PMOCommand {
     }
     async execute() {
         const { flags } = await this.parse(ExecutionList);
+        const jsonMode = shouldOutputJson(flags);
         // Get workspace info
         let workspaceInfo;
         try {
@@ -55,20 +58,28 @@ export default class ExecutionList extends PMOCommand {
                 limit: flags.limit,
             });
             if (executions.length === 0) {
+                if (jsonMode) {
+                    this.log(JSON.stringify([], null, 2));
+                    return;
+                }
                 this.log(styles.muted('\nNo executions found.\n'));
                 return;
             }
+            if (jsonMode) {
+                this.log(JSON.stringify(executions, null, 2));
+                return;
+            }
             // Display header
             this.log('');
             this.log(styles.header('🚀 Agent Work'));
             this.log('═'.repeat(100));
-            this.log(styles.muted(padEnd('ID', 14) +
-                padEnd('Ticket', 9) +
-                padEnd('Agent', 10) +
-                padEnd('Env', 13) +
-                padEnd('Display', 11) +
-                padEnd('Perms', 8) +
-                padEnd('Status', 10) +
+            this.log(styles.muted(visualPadEnd('ID', 14) +
+                visualPadEnd('Ticket', 9) +
+                visualPadEnd('Agent', 10) +
+                visualPadEnd('Env', 13) +
+                visualPadEnd('Display', 11) +
+                visualPadEnd('Perms', 8) +
+                visualPadEnd('Status', 10) +
                 'Started'));
             this.log('─'.repeat(100));
             // Display executions
@@ -79,13 +90,13 @@ export default class ExecutionList extends PMOCommand {
                 const envStr = `${envIcon} ${exec.environment}`;
                 const permsStr = exec.sandboxed ? 'safe' : 'danger';
                 const permsColor = exec.sandboxed ? styles.success : styles.warning;
-                this.log(padEnd(exec.id, 14) +
-                    padEnd(exec.ticketId, 9) +
-                    padEnd(exec.agentName, 10) +
-                    padEnd(envStr, 13) +
-                    padEnd(exec.displayMode, 11) +
-                    permsColor(padEnd(permsStr, 8)) +
-                    statusColor(padEnd(exec.status, 10)) +
+                this.log(visualPadEnd(exec.id, 14) +
+                    visualPadEnd(exec.ticketId, 9) +
+                    visualPadEnd(exec.agentName, 10) +
+                    visualPadEnd(envStr, 13) +
+                    visualPadEnd(exec.displayMode, 11) +
+                    permsColor(visualPadEnd(permsStr, 8)) +
+                    statusColor(visualPadEnd(exec.status, 10)) +
                     styles.muted(timeAgo));
             }
             this.log('═'.repeat(100));
@@ -110,9 +121,6 @@ export default class ExecutionList extends PMOCommand {
 // =============================================================================
 // Helper Functions
 // =============================================================================
-function padEnd(str, length) {
-    return str.padEnd(length);
-}
 function getStatusColor(status) {
     switch (status) {
         case 'running':

package/dist/commands/pmo/init.js

@@ -102,6 +102,9 @@ export default class PMOInit extends PromptCommand {
         if (flags.location) {
             location = flags.location;
         }
+        else if (jsonMode) {
+            location = 'separate';
+        }
         else {
             location = await promptForPMOLocation(hqRoot);
         }
@@ -111,6 +114,9 @@ export default class PMOInit extends PromptCommand {
         if (flags.template) {
             template = flags.template;
         }
+        else if (jsonMode) {
+            template = 'kanban';
+        }
         else {
             let storage;
             if (hqRoot) {
@@ -131,14 +137,27 @@ export default class PMOInit extends PromptCommand {
         }
         // Get columns for template
         let columns = getColumnsForTemplate(template);
-        if (template === 'custom') {
+        if (template === 'custom' && !jsonMode) {
             columns = await promptForCustomColumns();
         }
+        else if (template === 'custom' && jsonMode) {
+            // Custom column prompts not supported in JSON mode — use default columns
+            this.log(JSON.stringify({ warning: 'Custom columns not supported in JSON mode, using default columns. Use a named template (e.g. --template kanban) for predictable results.' }));
+        }
         // Get board name using shared prompt (or from flag)
         // Default to {hqname}-kanban pattern
         const hqName = hqRoot ? path.basename(hqRoot).replace(/-hq$/, '') : undefined;
-        const defaultBoardName = hqName ? `${hqName}-kanban` : undefined;
-        const boardName = flags.name || await promptForBoardName(defaultBoardName);
+        const defaultBoardName = hqName ? `${hqName}-kanban` : 'Project Board';
+        let boardName;
+        if (flags.name) {
+            boardName = flags.name;
+        }
+        else if (jsonMode) {
+            boardName = defaultBoardName;
+        }
+        else {
+            boardName = await promptForBoardName(defaultBoardName);
+        }
         // For standalone PMO (no HQ), we need to create mini-HQ structure first
         const isStandalone = !hqRoot;
         let effectiveHqPath;

package/dist/commands/repo/list.js

@@ -2,6 +2,8 @@ import { Flags } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { colors, format } from '../../lib/colors.js';
 import { findHQRoot, getWorkspaceRepoInfo } from '../../lib/repos/index.js';
+import { isNonTTY } from '../../lib/prompt-json.js';
+import { visualPadEnd } from '../../lib/string-utils.js';
 export default class List extends PMOCommand {
     static description = 'List all repositories in the HQ';
     static examples = [
@@ -23,6 +25,10 @@ export default class List extends PMOCommand {
     }
     async execute() {
         const { flags } = await this.parse(List);
+        // Default format to 'json' in non-TTY environments (piped output, CI, agents)
+        if (flags.format === 'table' && isNonTTY()) {
+            flags.format = 'json';
+        }
         // Find HQ root
         const hqPath = findHQRoot();
         if (!hqPath) {
@@ -53,10 +59,10 @@ export default class List extends PMOCommand {
         this.log(format.title(`📦 Repositories (${repositories.length})`));
         this.log('');
         // Header
-        this.log(colors.textMuted('Name'.padEnd(20) +
-            'Status'.padEnd(10) +
-            'Branch'.padEnd(15) +
-            'Commits'.padEnd(12) +
+        this.log(colors.textMuted(visualPadEnd('Name', 20) +
+            visualPadEnd('Status', 10) +
+            visualPadEnd('Branch', 15) +
+            visualPadEnd('Commits', 12) +
             'Added'));
         this.log(colors.textMuted('─'.repeat(70)));
         for (const repo of repositories) {
@@ -74,10 +80,10 @@ export default class List extends PMOCommand {
                 commits = `${repo.commitsBehind} behind`;
             }
             const added = repo.addedAt ? new Date(repo.addedAt).toLocaleDateString() : '-';
-            this.log(colors.text(repo.name.padEnd(20)) +
-                statusColor(repo.status.padEnd(10)) +
-                colors.warning((repo.branch || '-').padEnd(15)) +
-                colors.text(commits.padEnd(12)) +
+            this.log(colors.text(visualPadEnd(repo.name, 20)) +
+                statusColor(visualPadEnd(repo.status, 10)) +
+                colors.warning(visualPadEnd(repo.branch || '-', 15)) +
+                colors.text(visualPadEnd(commits, 12)) +
                 colors.textMuted(added));
         }
         // Summary

package/dist/commands/repo/view.js

@@ -4,6 +4,7 @@ import { colors, format } from '../../lib/colors.js';
 import { findHQRoot, getWorkspaceRepoInfo, } from '../../lib/repos/index.js';
 import { openWorkspaceDatabase } from '../../lib/database/index.js';
 import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { visualPadEnd } from '../../lib/string-utils.js';
 export default class View extends PMOCommand {
     static description = 'View detailed information about a repository';
     static examples = [
@@ -113,7 +114,7 @@ export default class View extends PMOCommand {
             for (const wt of worktrees) {
                 const wtStatus = wt.is_clean ? 'clean' : 'dirty';
                 const wtColor = wt.is_clean ? colors.repoClean : colors.repoDirty;
-                let line = `  • ${colors.agentName(wt.agent_name.padEnd(10))} - ${wtColor(wtStatus)}`;
+                let line = `  • ${colors.agentName(visualPadEnd(wt.agent_name, 10))} - ${wtColor(wtStatus)}`;
                 if (wt.commits_ahead > 0) {
                     line += colors.commitsAhead(` (${wt.commits_ahead} ahead)`);
                 }

package/dist/commands/roadmap/list.js

@@ -1,5 +1,6 @@
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 export default class RoadmapList extends PMOCommand {
     static description = 'List all roadmaps';
     static examples = [
@@ -12,17 +13,31 @@ export default class RoadmapList extends PMOCommand {
         return { promptIfMultiple: false };
     }
     async execute() {
+        const { flags } = await this.parse(RoadmapList);
+        const jsonMode = shouldOutputJson(flags);
         const roadmaps = await this.storage.listRoadmaps();
         if (roadmaps.length === 0) {
+            if (jsonMode) {
+                this.log(JSON.stringify([], null, 2));
+                return;
+            }
             this.log(styles.muted('No roadmaps found. Create one with: prlt roadmap create'));
             return;
         }
-        this.log(styles.title('\nRoadmaps\n'));
         // Fetch all project counts in parallel
         const projectCounts = await Promise.all(roadmaps.map(async (roadmap) => {
             const projects = await this.storage.listRoadmapProjects(roadmap.id);
             return projects.length;
         }));
+        if (jsonMode) {
+            const roadmapsWithCounts = roadmaps.map((roadmap, i) => ({
+                ...roadmap,
+                projectCount: projectCounts[i],
+            }));
+            this.log(JSON.stringify(roadmapsWithCounts, null, 2));
+            return;
+        }
+        this.log(styles.title('\nRoadmaps\n'));
         for (let i = 0; i < roadmaps.length; i++) {
             const roadmap = roadmaps[i];
             const markers = [];

package/dist/commands/session/health.js

@@ -7,6 +7,7 @@ import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { ExecutionStorage } from '../../lib/execution/index.js';
 import { parseSessionName, getHostTmuxSessionNames, getContainerTmuxSessionMap, flattenContainerSessions, findSessionForExecution, } from '../../lib/execution/session-utils.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { visualPadEnd } from '../../lib/string-utils.js';
 import { shouldOutputJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 // =============================================================================
 // Detection Logic
@@ -361,11 +362,11 @@ export default class SessionHealth extends PMOCommand {
         this.log(styles.header('Agent Health Status'));
         this.log('═'.repeat(95));
         this.log(styles.muted('  ' +
-            'Ticket'.padEnd(12) +
-            'Agent'.padEnd(20) +
-            'State'.padEnd(12) +
-            'Type'.padEnd(15) +
-            'Elapsed'.padEnd(10) +
+            visualPadEnd('Ticket', 12) +
+            visualPadEnd('Agent', 20) +
+            visualPadEnd('State', 12) +
+            visualPadEnd('Type', 15) +
+            visualPadEnd('Elapsed', 10) +
             'Session'));
         this.log('  ' + '─'.repeat(93));
         for (const agent of agents) {
@@ -384,11 +385,11 @@ export default class SessionHealth extends PMOCommand {
                 ? agent.sessionId.substring(0, 21) + '...'
                 : agent.sessionId;
             this.log('  ' +
-                agent.ticketId.padEnd(12) +
-                agent.agentName.padEnd(20) +
-                stateColor(`${stateIcon} ${agent.state}`).padEnd(22) +
-                typeIcon.padEnd(15) +
-                agent.elapsed.padEnd(10) +
+                visualPadEnd(agent.ticketId, 12) +
+                visualPadEnd(agent.agentName, 20) +
+                stateColor(visualPadEnd(`${stateIcon} ${agent.state}`, 12)) +
+                visualPadEnd(typeIcon, 15) +
+                visualPadEnd(agent.elapsed, 10) +
                 styles.muted(displaySession));
         }
         this.log('');

package/dist/commands/session/list.js

@@ -6,6 +6,8 @@ import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { ExecutionStorage } from '../../lib/execution/index.js';
 import { parseSessionName, getHostTmuxSessionNames, getContainerTmuxSessionMap, flattenContainerSessions, findSessionForExecution, } from '../../lib/execution/session-utils.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
+import { visualPadEnd } from '../../lib/string-utils.js';
 export default class SessionList extends PMOCommand {
     static description = 'List active tmux sessions (host and container)';
     static examples = [
@@ -25,6 +27,7 @@ export default class SessionList extends PMOCommand {
     }
     async execute() {
         const { flags } = await this.parse(SessionList);
+        const jsonMode = shouldOutputJson(flags);
         // Get workspace info for execution records
         let executionStorage = null;
         let db = null;
@@ -153,15 +156,19 @@ export default class SessionList extends PMOCommand {
                     });
                 }
             }
+            if (jsonMode) {
+                this.log(JSON.stringify(sessions, null, 2));
+                return;
+            }
             if (sessions.length > 0) {
                 this.log('');
                 this.log(styles.header('🖥️  Active Sessions'));
                 this.log('═'.repeat(90));
                 this.log(styles.muted('  ' +
-                    'Session'.padEnd(34) +
-                    'Ticket'.padEnd(12) +
-                    'Agent'.padEnd(18) +
-                    'Type'.padEnd(15) +
+                    visualPadEnd('Session', 34) +
+                    visualPadEnd('Ticket', 12) +
+                    visualPadEnd('Agent', 18) +
+                    visualPadEnd('Type', 15) +
                     'Status'));
                 this.log('  ' + '─'.repeat(88));
                 for (const session of sessions) {
@@ -177,10 +184,10 @@ export default class SessionList extends PMOCommand {
                         ? session.sessionId.substring(0, 29) + '...'
                         : session.sessionId;
                     this.log('  ' +
-                        displaySession.padEnd(34) +
-                        session.ticketId.padEnd(12) +
-                        session.agentName.padEnd(18) +
-                        typeIcon.padEnd(15) +
+                        visualPadEnd(displaySession, 34) +
+                        visualPadEnd(session.ticketId, 12) +
+                        visualPadEnd(session.agentName, 18) +
+                        visualPadEnd(typeIcon, 15) +
                         statusColor(statusText));
                 }
                 this.log('');

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

@@ -2,6 +2,8 @@ import { Command } from '@oclif/core';
 export default class List extends Command {
     static description: string;
     static examples: string[];
-    static flags: {};
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
     run(): Promise<void>;
 }

package/dist/commands/staff/list.js

@@ -3,25 +3,39 @@ import chalk from 'chalk';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
 import { getWorkspaceInfo, getAllAgentsStatus } from '../../lib/agents/commands.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
 export default class List extends Command {
     static description = 'List all staff (persistent) agents and their status';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
     ];
-    static flags = {};
+    static flags = {
+        ...machineOutputFlags,
+    };
     async run() {
+        const { flags } = await this.parse(List);
+        const jsonMode = shouldOutputJson(flags);
         try {
             // Get workspace information
             const workspaceInfo = getWorkspaceInfo();
             // Filter to staff agents only
             const staffAgents = workspaceInfo.agents.filter(a => a.type === 'persistent');
             if (staffAgents.length === 0) {
+                if (jsonMode) {
+                    this.log(JSON.stringify([], null, 2));
+                    return;
+                }
                 this.log(chalk.yellow('No staff agents found. Add staff agents with "prlt staff add"'));
                 return;
             }
             // Get status for all agents and filter to staff
             const agentsStatus = getAllAgentsStatus(workspaceInfo);
             const staffStatus = agentsStatus.filter(a => staffAgents.some(s => s.name === a.name));
+            if (jsonMode) {
+                this.log(JSON.stringify(staffStatus, null, 2));
+                return;
+            }
             this.log(chalk.bold.cyan('\n Staff Agents:\n'));
             for (const agentStatus of staffStatus) {
                 // Agent info line

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

@@ -2,5 +2,8 @@ import { Command } from '@oclif/core';
 export default class ThemeList extends Command {
     static description: string;
     static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
     run(): Promise<void>;
 }

package/dist/commands/theme/list.js

@@ -3,21 +3,46 @@ import chalk from 'chalk';
 import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { ensureBuiltinThemes } from '../../lib/themes.js';
 import { getThemes, getThemeNames, getAvailableThemeNames } from '../../lib/database/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
 export default class ThemeList extends Command {
     static description = 'List available agent themes';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
     ];
+    static flags = {
+        ...machineOutputFlags,
+    };
     async run() {
+        const { flags } = await this.parse(ThemeList);
+        const jsonMode = shouldOutputJson(flags);
         try {
             const workspaceInfo = getWorkspaceInfo();
             // Ensure built-in themes are seeded
             ensureBuiltinThemes(workspaceInfo.path);
             const themes = getThemes(workspaceInfo.path);
             if (themes.length === 0) {
+                if (jsonMode) {
+                    this.log(JSON.stringify([], null, 2));
+                    return;
+                }
                 this.log(chalk.yellow('No themes found.'));
                 return;
             }
+            if (jsonMode) {
+                const themesWithNames = themes.map(theme => {
+                    const allNames = getThemeNames(workspaceInfo.path, theme.id);
+                    const availableNames = getAvailableThemeNames(workspaceInfo.path, theme.id);
+                    return {
+                        ...theme,
+                        availableNames: availableNames.length,
+                        inUse: allNames.length - availableNames.length,
+                        totalNames: allNames.length,
+                    };
+                });
+                this.log(JSON.stringify(themesWithNames, null, 2));
+                return;
+            }
             this.log(chalk.bold('\nAgent Themes\n'));
             for (const theme of themes) {
                 const allNames = getThemeNames(workspaceInfo.path, theme.id);

package/dist/commands/ticket/complete.js

@@ -59,7 +59,10 @@ export default class TicketComplete extends PMOCommand {
             return;
         }
         // Get board for columns (use the first incomplete ticket's project)
-        const board = await this.storage.getBoard(incompleteTickets[0].projectId);
+        const board = await this.storage.getProjectBoard(incompleteTickets[0].projectId);
+        if (!board) {
+            return handleError('PROJECT_NOT_FOUND', `Project "${incompleteTickets[0].projectId}" not found. The ticket may belong to an orphaned project.`);
+        }
         // Find the "Done" column (case-insensitive)
         const doneColumn = board.columns.find(col => col.name.toLowerCase().includes('done'));
         if (!doneColumn) {

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

@@ -9,6 +9,7 @@ export default class TicketCreate extends PMOCommand {
         priority: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'description-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         interactive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         epic: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/ticket/create.js

@@ -1,4 +1,5 @@
 import { Flags } from '@oclif/core';
+import * as fs from 'node:fs';
 import inquirer from 'inquirer';
 import { autoExportToBoard, PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 // Note: inquirer import kept for inquirer.Separator usage in interactive mode
@@ -16,6 +17,8 @@ export default class TicketCreate extends PMOCommand {
         '<%= config.bin %> <%= command.id %> -t "Add feature" -c "In Progress" -p P1',
         '<%= config.bin %> <%= command.id %> --project mobile-app -t "New feature"',
         '<%= config.bin %> <%= command.id %> --epic EPIC-001 -t "Implement auth flow"',
+        '<%= config.bin %> <%= command.id %> --title "My ticket" --description-file ./ticket-desc.md',
+        '<%= config.bin %> <%= command.id %> --title "My ticket" --description-file -  # Read from stdin',
         '<%= config.bin %> <%= command.id %> --json  # Output column choices as JSON',
         '<%= config.bin %> <%= command.id %> --title "Test" -P PROJ-001 --dry-run --json  # Validate without creating',
     ];
@@ -47,6 +50,11 @@ export default class TicketCreate extends PMOCommand {
             char: 'd',
             description: 'Ticket description',
         }),
+        'description-file': Flags.string({
+            char: 'D',
+            description: 'Path to a markdown file for the ticket description (use - for stdin)',
+            exclusive: ['description'],
+        }),
         id: Flags.string({
             description: 'Custom ticket ID (auto-generated if not provided)',
         }),
@@ -65,6 +73,7 @@ export default class TicketCreate extends PMOCommand {
         }),
         labels: Flags.string({
             char: 'l',
+            aliases: ['label'],
             description: 'Labels (comma-separated)',
         }),
         'dry-run': Flags.boolean({
@@ -95,6 +104,27 @@ export default class TicketCreate extends PMOCommand {
             }
             this.error(message);
         };
+        // Read description from file if --description-file is provided
+        if (flags['description-file']) {
+            const filePath = flags['description-file'];
+            try {
+                if (filePath === '-') {
+                    // Guard: prevent hanging when no input is piped
+                    if (process.stdin.isTTY) {
+                        return handleError('DESCRIPTION_FILE_ERROR', 'Cannot read from stdin: no input piped. Use --description-file <path> with a file path instead, or pipe content via: echo "desc" | prlt ticket create --description-file -');
+                    }
+                    // Read from stdin
+                    flags.description = fs.readFileSync(0, 'utf-8');
+                }
+                else {
+                    flags.description = fs.readFileSync(filePath, 'utf-8');
+                }
+            }
+            catch (error) {
+                const errMsg = error instanceof Error ? error.message : String(error);
+                return handleError('DESCRIPTION_FILE_ERROR', `Failed to read description file "${filePath}": ${errMsg}`);
+            }
+        }
         // Validate epic if provided
         if (flags.epic) {
             const epic = await this.storage.getEpic(flags.epic);

package/dist/commands/ticket/delete.js

@@ -81,13 +81,13 @@ export default class TicketDelete extends PMOCommand {
         if (!ticket) {
             this.error(`Ticket "${ticketId}" not found.`);
         }
-        // Get board for project name
-        const board = await this.storage.getBoard(ticket.projectId);
+        // Get board for project name (may be null if project was deleted/orphaned)
+        const board = ticket.projectId ? await this.storage.getProjectBoard(ticket.projectId) : null;
         // Confirmation prompt (unless --force)
         if (!flags.force) {
             this.log(`\nDelete ticket ${styles.emphasis(ticketId)}?`);
             this.log(`  Title: ${ticket.title}`);
-            this.log(`  Project: ${board.name}`);
+            this.log(`  Project: ${board?.name || ticket.projectId || 'Unknown'}`);
             this.log(`  Status: ${ticket.statusName}`);
             const jsonModeConfig = jsonMode ? { flags, commandName: 'ticket delete' } : null;
             const { confirmed } = await this.prompt([{

package/dist/commands/ticket/edit.js

@@ -153,8 +153,8 @@ export default class TicketEdit extends PMOCommand {
                 return; // outputPromptAsJson exits, but TypeScript doesn't know
             }
             // Interactive mode - prompt for all editable fields
-            const board = await this.storage.getBoard(ticket.projectId);
-            const columns = board.columns.map(col => col.name);
+            const board = ticket.projectId ? await this.storage.getProjectBoard(ticket.projectId) : null;
+            const columns = board ? board.columns.map(col => col.name) : [];
             updates = await this.promptForEdits(ticket, columns);
         }
         else {