@proletariat/cli 0.3.25 → 0.3.26

package/dist/commands/commit.js

@@ -1,9 +1,9 @@
-import { Command, Args, Flags } from '@oclif/core';
+import { Args, Flags } from '@oclif/core';
 import { execSync } from 'node:child_process';
-import inquirer from 'inquirer';
+import { PromptCommand } from '../lib/prompt-command.js';
 import { validateBranchName } from '../lib/branch/index.js';
 import { styles } from '../lib/styles.js';
-import { shouldOutputJson, isAgentMode, outputPromptAsJson, outputErrorAsJson, createMetadata, normalizeChoices, } from '../lib/prompt-json.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../lib/prompt-json.js';
 /**
  * Commit message format presets.
  */
@@ -140,7 +140,7 @@ function branchTypeToCommitType(branchType) {
     };
     return mapping[branchType] || branchType;
 }
-export default class Commit extends Command {
+export default class Commit extends PromptCommand {
     static description = 'Create a commit with ticket ID from branch name';
     static examples = [
         '<%= config.bin %> <%= command.id %>                               # interactive mode',
@@ -197,28 +197,6 @@ export default class Commit extends Command {
             default: false,
         }),
     };
-    /**
-     * Prompt wrapper - handles both JSON mode and interactive mode.
-     * In JSON mode: outputs prompt as JSON and exits.
-     * In interactive mode: calls inquirer.prompt normally.
-     */
-    async prompt(questions, jsonModeConfig) {
-        if (jsonModeConfig && isAgentMode(jsonModeConfig.flags)) {
-            const firstQuestion = questions[0];
-            if (firstQuestion) {
-                const choices = firstQuestion.choices ? normalizeChoices(firstQuestion.choices) : undefined;
-                outputPromptAsJson({
-                    type: firstQuestion.type,
-                    name: firstQuestion.name,
-                    message: firstQuestion.message,
-                    choices,
-                    default: firstQuestion.default,
-                }, createMetadata(jsonModeConfig.commandName, jsonModeConfig.flags));
-            }
-            return {};
-        }
-        return inquirer.prompt(questions);
-    }
     async run() {
         const { args, flags } = await this.parse(Commit);
         // Check if JSON output mode is active

package/dist/commands/config/index.d.ts

@@ -1,5 +1,5 @@
-import { Command } from '@oclif/core';
-export default class Config extends Command {
+import { PromptCommand } from '../../lib/prompt-command.js';
+export default class Config extends PromptCommand {
     static description: string;
     static examples: string[];
     static flags: {
@@ -8,14 +8,6 @@ export default class Config extends Command {
         list: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         setting: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
-    /**
-     * Prompt wrapper - drop-in replacement for inquirer.prompt
-     *
-     * Works in BOTH modes:
-     * - Interactive mode: calls inquirer.prompt normally (human sees menu)
-     * - JSON/Agent mode: outputs prompt as structured JSON and exits
-     */
-    private promptUser;
     run(): Promise<void>;
     /**
      * Handle a specific setting's sub-prompt

package/dist/commands/config/index.js

@@ -2,12 +2,12 @@ import { Flags } from '@oclif/core';
 import * as path from 'node:path';
 import Database from 'better-sqlite3';
 import inquirer from 'inquirer';
-import { Command } from '@oclif/core';
+import { PromptCommand } from '../../lib/prompt-command.js';
 import { styles } from '../../lib/styles.js';
 import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { loadExecutionConfig, saveTerminalApp, saveTerminalOpenInBackground, saveTmuxControlMode, saveShell, } from '../../lib/execution/config.js';
-import { shouldOutputJson, isAgentMode, isNonTTY, outputPromptAsJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, normalizeChoices, } from '../../lib/prompt-json.js';
-export default class Config extends Command {
+import { shouldOutputJson, isNonTTY, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+export default class Config extends PromptCommand {
     static description = 'View and update workspace configuration';
     static examples = [
         '<%= config.bin %> <%= command.id %>                    # Interactive menu',
@@ -37,32 +37,6 @@ export default class Config extends Command {
             description: 'Navigate to a specific setting prompt (for agent navigation)',
         }),
     };
-    /**
-     * Prompt wrapper - drop-in replacement for inquirer.prompt
-     *
-     * Works in BOTH modes:
-     * - Interactive mode: calls inquirer.prompt normally (human sees menu)
-     * - JSON/Agent mode: outputs prompt as structured JSON and exits
-     */
-    async promptUser(questions, jsonModeConfig) {
-        if (jsonModeConfig && isAgentMode(jsonModeConfig.flags)) {
-            const firstQuestion = questions[0];
-            if (firstQuestion) {
-                const choices = firstQuestion.choices
-                    ? normalizeChoices(firstQuestion.choices)
-                    : undefined;
-                outputPromptAsJson({
-                    type: firstQuestion.type,
-                    name: firstQuestion.name,
-                    message: firstQuestion.message,
-                    choices,
-                    default: firstQuestion.default,
-                }, createMetadata(jsonModeConfig.commandName, jsonModeConfig.flags));
-            }
-            return {};
-        }
-        return inquirer.prompt(questions);
-    }
     async run() {
         const { flags } = await this.parse(Config);
         const jsonMode = shouldOutputJson(flags);
@@ -163,7 +137,7 @@ export default class Config extends Command {
                 { name: `Shell: ${config.shell}`, value: 'shell', command: 'prlt config --setting shell --json' },
                 { name: `Tmux Control Mode (iTerm -CC): ${config.tmux.controlMode}`, value: 'tmux.controlMode', command: 'prlt config --setting tmux.controlMode --json' },
             ];
-            const { setting } = await this.promptUser([
+            const { setting } = await this.prompt([
                 {
                     type: 'list',
                     name: 'setting',
@@ -209,7 +183,7 @@ export default class Config extends Command {
                     { name: 'Warp', value: 'Warp', command: 'prlt config --set "terminal.app Warp" --json' },
                     { name: 'tmux', value: 'tmux', command: 'prlt config --set "terminal.app tmux" --json' },
                 ];
-                const { newApp } = await this.promptUser([
+                const { newApp } = await this.prompt([
                     {
                         type: 'list',
                         name: 'newApp',
@@ -227,7 +201,7 @@ export default class Config extends Command {
                     { name: 'Yes - Open tabs in background (don\'t steal focus)', value: 'true', command: 'prlt config --set "terminal.openInBackground true" --json' },
                     { name: 'No - Bring terminal to foreground when opening tabs', value: 'false', command: 'prlt config --set "terminal.openInBackground false" --json' },
                 ];
-                const { openInBg } = await this.promptUser([
+                const { openInBg } = await this.prompt([
                     {
                         type: 'list',
                         name: 'openInBg',
@@ -246,7 +220,7 @@ export default class Config extends Command {
                     { name: 'bash', value: 'bash', command: 'prlt config --set "shell bash" --json' },
                     { name: 'fish', value: 'fish', command: 'prlt config --set "shell fish" --json' },
                 ];
-                const { newShell } = await this.promptUser([
+                const { newShell } = await this.prompt([
                     {
                         type: 'list',
                         name: 'newShell',
@@ -264,7 +238,7 @@ export default class Config extends Command {
                     { name: 'Yes - Use tmux -CC for native iTerm integration', value: 'true', command: 'prlt config --set "tmux.controlMode true" --json' },
                     { name: 'No - Standard tmux interface', value: 'false', command: 'prlt config --set "tmux.controlMode false" --json' },
                 ];
-                const { controlMode } = await this.promptUser([
+                const { controlMode } = await this.prompt([
                     {
                         type: 'list',
                         name: 'controlMode',

package/dist/commands/docker/index.d.ts

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

package/dist/commands/docker/index.js

@@ -1,5 +1,5 @@
-import { Command } from '@oclif/core';
 import inquirer from 'inquirer';
+import { PromptCommand } from '../../lib/prompt-command.js';
 import { execSync } from 'node:child_process';
 import * as path from 'node:path';
 import Database from 'better-sqlite3';
@@ -9,7 +9,7 @@ import { ExecutionStorage, ContainerStorage } from '../../lib/execution/storage.
 import { isDockerRunning } from '../../lib/execution/runners.js';
 import { FlagResolver, shouldOutputJson } from '../../lib/flags/index.js';
 import { machineOutputFlags } from '../../lib/pmo/base-command.js';
-export default class Docker extends Command {
+export default class Docker extends PromptCommand {
     static description = 'Manage Docker containers used by agents';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
@@ -198,17 +198,17 @@ export default class Docker extends Command {
                 db.close();
             if (choices.length <= 2) {
                 // Only manual option, just ask for input
-                const { target } = await inquirer.prompt([
+                const { target } = await this.prompt([
                     {
                         type: 'input',
                         name: 'target',
                         message: 'No containers found. Enter container ID:',
                         validate: (input) => input.trim().length > 0 || 'Target is required',
                     },
-                ]);
+                ], null);
                 return target.trim();
             }
-            const { target } = await inquirer.prompt([
+            const { target } = await this.prompt([
                 {
                     type: 'list',
                     name: 'target',
@@ -216,19 +216,19 @@ export default class Docker extends Command {
                     choices,
                     pageSize: 15,
                 },
-            ]);
+            ], null);
             if (target === '__cancel__') {
                 return null;
             }
             if (target === '__manual__') {
-                const { manualTarget } = await inquirer.prompt([
+                const { manualTarget } = await this.prompt([
                     {
                         type: 'input',
                         name: 'manualTarget',
                         message: 'Enter execution ID (WORK-XXX), agent name, or container ID:',
                         validate: (input) => input.trim().length > 0 || 'Target is required',
                     },
-                ]);
+                ], null);
                 return manualTarget.trim();
             }
             return target;

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/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 %>',
@@ -268,13 +268,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 +303,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/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;
+}