@proletariat/cli 0.3.25 → 0.3.27

package/dist/commands/docker/sync.js

@@ -6,6 +6,7 @@ import { styles } from '../../lib/styles.js';
 import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { ContainerStorage } from '../../lib/execution/storage.js';
 import { isDockerRunning } from '../../lib/execution/runners.js';
+import { visualPadEnd } from '../../lib/string-utils.js';
 export default class DockerSync extends Command {
     static description = 'Sync container status from Docker into the database';
     static examples = [
@@ -54,9 +55,9 @@ export default class DockerSync extends Command {
             if (containers.length > 0) {
                 this.log(styles.subheader('Tracked Containers:'));
                 this.log(styles.muted('  ' +
-                    'ID'.padEnd(18) +
-                    'Agent'.padEnd(15) +
-                    'Status'.padEnd(12) +
+                    visualPadEnd('ID', 18) +
+                    visualPadEnd('Agent', 15) +
+                    visualPadEnd('Status', 12) +
                     'Docker ID'));
                 this.log(styles.muted('  ' + '-'.repeat(65)));
                 for (const container of containers) {
@@ -64,9 +65,9 @@ export default class DockerSync extends Command {
                         container.status === 'exited' ? styles.muted :
                             container.status === 'removed' ? styles.error : styles.warning;
                     this.log('  ' +
-                        container.id.padEnd(18) +
-                        container.agentName.padEnd(15) +
-                        statusColor(container.status.padEnd(12)) +
+                        visualPadEnd(container.id, 18) +
+                        visualPadEnd(container.agentName, 15) +
+                        statusColor(visualPadEnd(container.status, 12)) +
                         styles.muted(container.dockerId.substring(0, 12)));
                 }
                 this.log('');

package/dist/commands/epic/delete.js

@@ -1,5 +1,4 @@
 import { Args, Flags } from '@oclif/core';
-import inquirer from 'inquirer';
 import { autoExportToBoard, PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
 import { deleteEpicFile } from '../../lib/pmo/epic-files.js';
@@ -67,12 +66,12 @@ export default class EpicDelete extends PMOCommand {
                 outputPromptAsJson(buildPromptConfig('list', 'id', 'Select epic to delete:', choices), createMetadata('epic delete', flags));
                 return;
             }
-            const { selected } = await inquirer.prompt([{
+            const { selected } = await this.prompt([{
                     type: 'list',
                     name: 'selected',
                     message: 'Select epic to delete:',
                     choices,
-                }]);
+                }], null);
             epicId = selected;
         }
         // Get the epic to show details
@@ -97,7 +96,7 @@ export default class EpicDelete extends PMOCommand {
             this.log(`  Title: ${epic.title}`);
             this.log(`  Status: ${epic.status}`);
             this.log(`  Tickets: ${tickets.length} (will be unlinked, not deleted)`);
-            const { confirmed } = await inquirer.prompt([{
+            const { confirmed } = await this.prompt([{
                     type: 'list',
                     name: 'confirmed',
                     message: `Delete epic '${epic.title}'?`,
@@ -106,7 +105,7 @@ export default class EpicDelete extends PMOCommand {
                         { name: 'Yes, delete permanently', value: true },
                     ],
                     default: 0,
-                }]);
+                }], null);
             if (!confirmed) {
                 this.log(styles.muted('Deletion cancelled.'));
                 return;

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/feedback/submit.d.ts

@@ -1,5 +1,5 @@
-import { Command } from '@oclif/core';
-export default class FeedbackSubmit extends Command {
+import { PromptCommand } from '../../lib/prompt-command.js';
+export default class FeedbackSubmit extends PromptCommand {
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/feedback/submit.js

@@ -1,8 +1,8 @@
-import { Command, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
 import { execSync } from 'node:child_process';
 import * as os from 'node:os';
-import inquirer from 'inquirer';
 import chalk from 'chalk';
+import { PromptCommand } from '../../lib/prompt-command.js';
 import { styles } from '../../lib/styles.js';
 import { isGHInstalled, isGHAuthenticated } from '../../lib/pr/index.js';
 import { isMachineOutput, outputSuccessAsJson, outputErrorAsJson, outputPromptAsJson, buildPromptConfig, createMetadata, } from '../../lib/prompt-json.js';
@@ -15,7 +15,7 @@ const CATEGORY_LABELS = {
     feature: 'enhancement',
     general: 'feedback',
 };
-export default class FeedbackSubmit extends Command {
+export default class FeedbackSubmit extends PromptCommand {
     static description = 'Submit feedback, bug reports, or feature requests to GitHub Issues';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
@@ -69,12 +69,12 @@ export default class FeedbackSubmit extends Command {
                 outputPromptAsJson(buildPromptConfig('list', 'category', categoryMessage, categoryChoices), createMetadata('feedback submit', flags));
                 return;
             }
-            const { selectedCategory } = await inquirer.prompt([{
+            const { selectedCategory } = await this.prompt([{
                     type: 'list',
                     name: 'selectedCategory',
                     message: categoryMessage,
                     choices: categoryChoices,
-                }]);
+                }], null);
             category = selectedCategory;
         }
         // Collect title
@@ -85,7 +85,7 @@ export default class FeedbackSubmit extends Command {
                 outputPromptAsJson(buildPromptConfig('input', 'title', titleMessage), createMetadata('feedback submit', { ...flags, category }));
                 return;
             }
-            const { inputTitle } = await inquirer.prompt([{
+            const { inputTitle } = await this.prompt([{
                     type: 'input',
                     name: 'inputTitle',
                     message: titleMessage,
@@ -98,7 +98,7 @@ export default class FeedbackSubmit extends Command {
                         }
                         return true;
                     },
-                }]);
+                }], null);
             title = inputTitle;
         }
         // Collect body/description
@@ -109,7 +109,7 @@ export default class FeedbackSubmit extends Command {
                 outputPromptAsJson(buildPromptConfig('editor', 'body', bodyMessage), createMetadata('feedback submit', { ...flags, category, title }));
                 return;
             }
-            const { inputBody } = await inquirer.prompt([{
+            const { inputBody } = await this.prompt([{
                     type: 'editor',
                     name: 'inputBody',
                     message: bodyMessage,
@@ -119,7 +119,7 @@ export default class FeedbackSubmit extends Command {
                         }
                         return true;
                     },
-                }]);
+                }], null);
             body = inputBody;
         }
         // Build diagnostics section

package/dist/commands/link/index.js

@@ -42,7 +42,7 @@ export default class Link extends PMOCommand {
                 outputPromptAsJson(buildPromptConfig('list', 'action', message, menuChoices), createMetadata('link', flags));
                 return;
             }
-            const { selected } = await inquirer.prompt([{
+            const { selected } = await this.prompt([{
                     type: 'list',
                     name: 'selected',
                     message,
@@ -51,7 +51,7 @@ export default class Link extends PMOCommand {
                         new inquirer.Separator(),
                         { name: menuChoices[3].name, value: menuChoices[3].value }
                     ]
-                }]);
+                }], null);
             if (selected === 'cancel') {
                 this.log(styles.muted('\nCancelled.'));
                 return;

package/dist/commands/pmo/init.d.ts

@@ -1,5 +1,5 @@
-import { Command } from '@oclif/core';
-export default class PMOInit extends Command {
+import { PromptCommand } from '../../lib/prompt-command.js';
+export default class PMOInit extends PromptCommand {
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/pmo/init.js

@@ -1,9 +1,9 @@
-import { Command, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { execSync } from 'node:child_process';
 import chalk from 'chalk';
-import inquirer from 'inquirer';
+import { PromptCommand } from '../../lib/prompt-command.js';
 import Database from 'better-sqlite3';
 import { SQLiteStorage, getColumnsForTemplate, createPMO, promptForPMOLocation, promptForBoardTemplate, promptForBoardName, promptForCustomColumns, determinePMOPath, getPickerTemplates, } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
@@ -11,7 +11,7 @@ import { isGHInstalled, isGHAuthenticated, getGHUsername, isGHTokenInEnv } from
 import { shouldOutputJson, outputPromptAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
 // Build template options dynamically from shared definitions (picker templates + custom)
 const PICKER_TEMPLATE_IDS = [...getPickerTemplates().map(t => t.id), 'custom'];
-export default class PMOInit extends Command {
+export default class PMOInit extends PromptCommand {
     static description = 'Initialize PMO (Project Management Org) in current directory or HQ';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
@@ -102,6 +102,9 @@ export default class PMOInit extends Command {
         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 Command {
         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 Command {
         }
         // 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;
@@ -268,13 +287,13 @@ export default class PMOInit extends Command {
             this.log(chalk.gray(`   Location: ${pmoPath}`));
             this.log(chalk.gray(`   Projects: ${projectCount}`));
             this.log(chalk.gray(`   Tickets: ${ticketCount}\n`));
-            const result = await inquirer.prompt([{
+            const result = await this.prompt([{
                     type: 'list',
                     name: 'action',
                     message: 'What would you like to do?',
                     choices: actionChoices,
                     default: 'cancel',
-                }]);
+                }], null);
             action = result.action;
         }
         if (action === 'cancel') {
@@ -303,11 +322,11 @@ export default class PMOInit extends Command {
             this.log(chalk.red('   • All tickets and boards'));
             this.log(chalk.red('   • All specs and documentation'));
             this.log(chalk.red('   • Database tables (pmo_*)\n'));
-            const result = await inquirer.prompt([{
+            const result = await this.prompt([{
                     type: 'input',
                     name: 'confirmation',
                     message: 'Type "delete pmo" to confirm:',
-                }]);
+                }], null);
             confirmation = result.confirmation;
         }
         if (confirmation !== 'delete pmo') {

package/dist/commands/project/spec.js

@@ -140,7 +140,7 @@ export default class ProjectSpec extends PMOCommand {
                 }
             }
             // eslint-disable-next-line no-await-in-loop -- Interactive user prompt
-            const { action } = await inquirer.prompt([{
+            const { action } = await this.prompt([{
                     type: 'list',
                     name: 'action',
                     message: `Manage specs for ${projectId}:`,
@@ -150,7 +150,7 @@ export default class ProjectSpec extends PMOCommand {
                         new inquirer.Separator(),
                         { name: 'Done', value: 'done' },
                     ],
-                }]);
+                }], null);
             if (action === 'done') {
                 continueLoop = false;
                 continue;
@@ -165,7 +165,7 @@ export default class ProjectSpec extends PMOCommand {
                     continue;
                 }
                 // eslint-disable-next-line no-await-in-loop -- User selection prompt
-                const { selected } = await inquirer.prompt([{
+                const { selected } = await this.prompt([{
                         type: 'checkbox',
                         name: 'selected',
                         message: 'Select specs to add:',
@@ -173,7 +173,7 @@ export default class ProjectSpec extends PMOCommand {
                             name: `${s.id} - ${s.title} (${s.status})`,
                             value: s.id,
                         })),
-                    }]);
+                    }], null);
                 if (selected.length === 0) {
                     this.log(styles.muted('  No specs selected.'));
                     continue;
@@ -191,7 +191,7 @@ export default class ProjectSpec extends PMOCommand {
                     continue;
                 }
                 // eslint-disable-next-line no-await-in-loop -- User selection prompt
-                const { selected } = await inquirer.prompt([{
+                const { selected } = await this.prompt([{
                         type: 'checkbox',
                         name: 'selected',
                         message: 'Select specs to remove:',
@@ -199,7 +199,7 @@ export default class ProjectSpec extends PMOCommand {
                             name: `${s.id} - ${s.title} (${s.status})`,
                             value: s.id,
                         })),
-                    }]);
+                    }], null);
                 if (selected.length === 0) {
                     this.log(styles.muted('  No specs selected.'));
                     continue;

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.d.ts

@@ -0,0 +1,29 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class SessionHealth extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        fix: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        watch: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        interval: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        threshold: import("@oclif/core/interfaces").OptionFlag<number, 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>;
+    };
+    protected getPMOOptions(): {
+        promptIfMultiple: boolean;
+    };
+    execute(): Promise<void>;
+    /**
+     * Single health check pass. Returns the list of agent health infos.
+     */
+    private runHealthCheck;
+    /**
+     * Display the health status table.
+     */
+    private displayHealthTable;
+    /**
+     * Watchdog mode: continuously monitor and auto-recover hung agents.
+     */
+    private watchMode;
+}