@proletariat/cli 0.3.16 → 0.3.18

package/dist/commands/project/archive.js

@@ -1,8 +1,7 @@
 import { Args, Flags } from '@oclif/core';
-import inquirer from 'inquirer';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
-import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class ProjectArchive extends PMOCommand {
     static description = 'Archive a project (hide from default views)';
     static examples = [
@@ -22,10 +21,6 @@ export default class ProjectArchive extends PMOCommand {
             description: 'Skip confirmation',
             default: false,
         }),
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
@@ -48,34 +43,34 @@ export default class ProjectArchive extends PMOCommand {
         }
         if (project.isArchived) {
             if (jsonMode) {
-                outputErrorAsJson('ALREADY_ARCHIVED', `Project "${project.name}" is already archived.`, createMetadata('project archive', flags));
+                outputSuccessAsJson({ projectId: project.id, projectName: project.name, alreadyArchived: true }, createMetadata('project archive', flags));
                 return;
             }
             this.log(styles.muted(`Project "${project.name}" is already archived.`));
             return;
         }
+        // Agent mode config for prompts
+        const agentConfig = jsonMode ? { flags, commandName: 'project archive' } : null;
         if (!flags.force) {
-            // In JSON mode, output confirmation prompt
-            if (jsonMode) {
-                const confirmChoices = [
-                    { name: 'No', value: 'false' },
-                    { name: 'Yes', value: 'true' },
-                ];
-                outputPromptAsJson(buildPromptConfig('list', 'confirmed', `Archive project "${project.name}"? It will be hidden from default views.`, confirmChoices), createMetadata('project archive', flags));
-                return;
-            }
-            const { confirm } = await inquirer.prompt([{
-                    type: 'confirm',
+            const { confirm } = await this.prompt([{
+                    type: 'list',
                     name: 'confirm',
                     message: `Archive project "${project.name}"? It will be hidden from default views.`,
-                    default: false,
-                }]);
+                    choices: [
+                        { name: 'No', value: false, command: '' },
+                        { name: 'Yes', value: true, command: `prlt project archive ${args.id} --force --json` },
+                    ],
+                }], agentConfig);
             if (!confirm) {
                 this.log(styles.muted('Cancelled.'));
                 return;
             }
         }
         await this.storage.archiveProject(args.id);
+        if (jsonMode) {
+            outputSuccessAsJson({ projectId: project.id, projectName: project.name, archived: true }, createMetadata('project archive', flags));
+            return;
+        }
         this.log(styles.success(`\nArchived project "${project.name}"`));
         this.log(styles.muted('View archived projects: prlt project list --archived'));
         this.log(styles.muted('Unarchive: prlt project unarchive ' + args.id));

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

@@ -11,6 +11,7 @@ export default class ProjectCreate extends PMOCommand {
         description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         template: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         interactive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: 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>;
     };

package/dist/commands/project/create.js

@@ -5,7 +5,7 @@ import inquirer from 'inquirer';
 import { createBoardContent, createSpecFolders, PMOCommand, pmoBaseFlags, BUILTIN_TEMPLATES } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
 import { slugify } from '../../lib/pmo/utils.js';
-import { shouldOutputJson, outputPromptAsJson, createMetadata, buildFormPromptConfig, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputPromptAsJson, outputSuccessAsJson, createMetadata, buildFormPromptConfig, } from '../../lib/prompt-json.js';
 // Build template options dynamically from shared definitions
 const TEMPLATE_IDS = BUILTIN_TEMPLATES.map(t => t.id);
 export default class ProjectCreate extends PMOCommand {
@@ -45,10 +45,6 @@ export default class ProjectCreate extends PMOCommand {
             description: 'Interactive mode',
             default: false,
         }),
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
@@ -110,6 +106,18 @@ export default class ProjectCreate extends PMOCommand {
         const specsPath = createSpecFolders(this.pmoPath, projectId);
         // Get the statuses from the workflow (template name = workflow ID for built-in templates)
         const statuses = await this.storage.listStatuses(projectData.template);
+        // In JSON mode, output success with project details
+        if (jsonMode) {
+            outputSuccessAsJson({
+                id: project.id,
+                name: project.name,
+                template: projectData.template,
+                statuses: statuses.map(s => s.name),
+                boardPath: path.relative(process.cwd(), boardPath),
+                specsPath: path.relative(process.cwd(), specsPath),
+            }, createMetadata('project create', flags));
+            return;
+        }
         this.log(styles.success(`\nCreated project "${styles.emphasis(project.name)}"`));
         this.log(styles.muted(`  ID: ${project.id}`));
         this.log(styles.muted(`  Template: ${projectData.template}`));

package/dist/commands/project/delete.d.ts

@@ -7,6 +7,7 @@ export default class ProjectDelete extends PMOCommand {
     };
     static flags: {
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: 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>;
     };

package/dist/commands/project/delete.js

@@ -1,10 +1,9 @@
 import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import inquirer from 'inquirer';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
-import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class ProjectDelete extends PMOCommand {
     static description = 'Delete a project from the PMO';
     static examples = [
@@ -24,10 +23,6 @@ export default class ProjectDelete extends PMOCommand {
             description: 'Skip confirmation prompt',
             default: false,
         }),
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
@@ -44,6 +39,8 @@ export default class ProjectDelete extends PMOCommand {
             }
             this.error(message);
         };
+        // Agent mode config for prompts
+        const agentConfig = jsonMode ? { flags, commandName: 'project delete' } : null;
         // Get project ID - prompt if not provided
         let projectId = args.id;
         if (!projectId) {
@@ -55,21 +52,16 @@ export default class ProjectDelete extends PMOCommand {
             if (deletableProjects.length === 0) {
                 return handleError('NO_DELETABLE_PROJECTS', 'No deletable projects found. Cannot delete the default project.');
             }
-            // In JSON mode, output project selection prompt
-            if (jsonMode) {
-                const projectChoices = deletableProjects.map(p => ({ name: `${p.id} - ${p.name}`, value: p.id }));
-                outputPromptAsJson(buildPromptConfig('list', 'id', 'Select project to delete:', projectChoices), createMetadata('project delete', flags));
-                return;
-            }
-            const { selectedProjectId } = await inquirer.prompt([{
+            const { selectedProjectId } = await this.prompt([{
                     type: 'list',
                     name: 'selectedProjectId',
                     message: 'Select project to delete:',
                     choices: deletableProjects.map(p => ({
                         name: `${p.id} - ${p.name}`,
                         value: p.id,
+                        command: `prlt project delete ${p.id} --json`,
                     })),
-                }]);
+                }], agentConfig);
             projectId = selectedProjectId;
         }
         if (projectId === 'default') {
@@ -88,25 +80,15 @@ export default class ProjectDelete extends PMOCommand {
             const message = ticketCount > 0
                 ? `Delete project "${project.name}" and its ${ticketCount} ticket(s)?`
                 : `Delete project "${project.name}"?`;
-            // In JSON mode, output confirmation prompt
-            if (jsonMode) {
-                const confirmChoices = [
-                    { name: 'No, cancel', value: 'false' },
-                    { name: 'Yes, delete', value: 'true' },
-                ];
-                outputPromptAsJson(buildPromptConfig('list', 'confirmed', message, confirmChoices), createMetadata('project delete', flags));
-                return;
-            }
-            const { confirm } = await inquirer.prompt([{
+            const { confirm } = await this.prompt([{
                     type: 'list',
                     name: 'confirm',
                     message,
                     choices: [
-                        { name: 'No, cancel', value: false },
-                        { name: 'Yes, delete', value: true },
+                        { name: 'No, cancel', value: false, command: '' },
+                        { name: 'Yes, delete', value: true, command: `prlt project delete ${projectId} --force --json` },
                     ],
-                    default: 0,
-                }]);
+                }], agentConfig);
             if (!confirm) {
                 this.log(styles.muted('Cancelled.'));
                 return;
@@ -120,6 +102,10 @@ export default class ProjectDelete extends PMOCommand {
         if (fs.existsSync(projectPath)) {
             fs.rmSync(projectPath, { recursive: true, force: true });
         }
+        if (jsonMode) {
+            outputSuccessAsJson({ projectId: project.id, projectName: project.name, deleted: true, ticketsRemoved: ticketCount }, createMetadata('project delete', flags));
+            return;
+        }
         this.log(styles.success(`Deleted project "${project.name}"`));
         if (ticketCount > 0) {
             this.log(styles.muted(`  (${ticketCount} ticket(s) removed)`));

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

@@ -3,6 +3,7 @@ export default class Project extends PMOCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        machine: 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>;
     };

package/dist/commands/project/index.js

@@ -1,4 +1,3 @@
-import { Flags } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { shouldOutputJson } from '../../lib/prompt-json.js';
 export default class Project extends PMOCommand {
@@ -8,10 +7,6 @@ export default class Project extends PMOCommand {
     ];
     static flags = {
         ...pmoBaseFlags,
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };

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

@@ -5,6 +5,8 @@ export default class ProjectList extends PMOCommand {
     static flags: {
         archived: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: 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 getPMOOptions(): {

package/dist/commands/project/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, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class ProjectList extends PMOCommand {
     static description = 'List all projects in the PMO';
     static examples = [
@@ -25,6 +26,8 @@ export default class ProjectList extends PMOCommand {
     }
     async execute() {
         const { flags } = await this.parse(ProjectList);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
         // Determine filter based on flags
         let isArchived;
         if (flags.archived) {
@@ -38,6 +41,24 @@ export default class ProjectList extends PMOCommand {
         // Get phases for display
         const phases = await this.storage.listPhases();
         const phaseMap = new Map(phases.map(p => [p.id, p]));
+        // Get ticket counts using listProjectSummaries
+        const summaries = await this.storage.listProjectSummaries();
+        const ticketCountMap = new Map(summaries.map(s => [s.id, s.ticketCount]));
+        // JSON mode: output structured data
+        if (jsonMode) {
+            const projectData = projects.map(p => ({
+                id: p.id,
+                name: p.name,
+                description: p.description,
+                isArchived: p.isArchived,
+                isDefault: p.id === 'default',
+                ticketCount: ticketCountMap.get(p.id) ?? 0,
+                phase: p.phaseId ? phaseMap.get(p.phaseId)?.name : undefined,
+                phaseId: p.phaseId,
+            }));
+            outputSuccessAsJson({ projects: projectData }, createMetadata('project list', flags));
+            return;
+        }
         if (projects.length === 0) {
             if (flags.archived) {
                 this.log(styles.muted('No archived projects found.'));
@@ -57,9 +78,6 @@ export default class ProjectList extends PMOCommand {
         }
         const title = flags.archived ? 'Archived Projects' : flags.all ? 'All Projects' : 'Projects';
         this.log(styles.title(`\n${title}\n`));
-        // Get ticket counts using listProjectSummaries
-        const summaries = await this.storage.listProjectSummaries();
-        const ticketCountMap = new Map(summaries.map(s => [s.id, s.ticketCount]));
         for (const project of projects) {
             const isDefault = project.id === 'default';
             const markers = [];

package/dist/commands/project/spec.d.ts

@@ -8,6 +8,7 @@ export default class ProjectSpec extends PMOCommand {
     static flags: {
         add: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         remove: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        machine: 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>;
     };

package/dist/commands/project/spec.js

@@ -2,7 +2,7 @@ import { Args, Flags } from '@oclif/core';
 import inquirer from 'inquirer';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
-import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class ProjectSpec extends PMOCommand {
     static description = 'Manage specs associated with a project (many-to-many)';
     static examples = [
@@ -27,10 +27,6 @@ export default class ProjectSpec extends PMOCommand {
             char: 'r',
             description: 'Remove a spec from this project',
         }),
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
@@ -47,6 +43,8 @@ export default class ProjectSpec extends PMOCommand {
             }
             this.error(message);
         };
+        // Agent mode config for prompts
+        const agentConfig = jsonMode ? { flags, commandName: 'project spec' } : null;
         // Get all projects
         const projects = await this.storage.listProjects();
         if (projects.length === 0) {
@@ -60,21 +58,16 @@ export default class ProjectSpec extends PMOCommand {
         let projectId = args.projectId;
         // If no project ID provided, prompt for selection
         if (!projectId) {
-            // In JSON mode, output project selection prompt
-            if (jsonMode) {
-                const projectChoices = projects.map(p => ({ name: `${p.id} - ${p.name} (${p.status})`, value: p.id }));
-                outputPromptAsJson(buildPromptConfig('list', 'projectId', 'Select project:', projectChoices), createMetadata('project spec', flags));
-                return;
-            }
-            const { selected } = await inquirer.prompt([{
+            const { selected } = await this.prompt([{
                     type: 'list',
                     name: 'selected',
                     message: 'Select project:',
                     choices: projects.map(p => ({
                         name: `${p.id} - ${p.name} (${p.status})`,
                         value: p.id,
+                        command: `prlt project spec ${p.id} --json`,
                     })),
-                }]);
+                }], agentConfig);
             projectId = selected;
         }
         // Validate project exists
@@ -116,16 +109,17 @@ export default class ProjectSpec extends PMOCommand {
         // In JSON mode, output the menu prompt (no loop - AI will call back)
         if (jsonMode) {
             const currentSpecs = await this.storage.getSpecsForProject(projectId);
-            const menuChoices = [
-                { name: 'Add spec to project', value: 'add' },
-                { name: 'Remove spec from project', value: 'remove' },
-                { name: 'Done', value: 'done' },
-            ];
-            outputPromptAsJson({
-                ...buildPromptConfig('list', 'action', `Manage specs for ${projectId}:`, menuChoices),
-                context: {
-                    projectId,
-                    currentSpecs: currentSpecs.map(s => ({ id: s.id, title: s.title, status: s.status })),
+            const allSpecs = await this.storage.listSpecs();
+            const currentSpecIds = new Set(currentSpecs.map(s => s.id));
+            const availableSpecs = allSpecs.filter(s => !currentSpecIds.has(s.id));
+            outputSuccessAsJson({
+                projectId,
+                projectName: project.name,
+                currentSpecs: currentSpecs.map(s => ({ id: s.id, title: s.title, status: s.status })),
+                availableSpecs: availableSpecs.map(s => ({ id: s.id, title: s.title, status: s.status })),
+                commands: {
+                    addSpec: `prlt project spec ${projectId} --add <SPEC_ID> --json`,
+                    removeSpec: `prlt project spec ${projectId} --remove <SPEC_ID> --json`,
                 },
             }, createMetadata('project spec', flags));
             return;

package/dist/commands/project/unarchive.d.ts

@@ -6,6 +6,8 @@ export default class ProjectUnarchive extends PMOCommand {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
+        machine: 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 getPMOOptions(): {

package/dist/commands/project/unarchive.js

@@ -1,6 +1,7 @@
 import { Args } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles } from '../../lib/styles.js';
+import { shouldOutputJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class ProjectUnarchive extends PMOCommand {
     static description = 'Unarchive a project (restore to default views)';
     static examples = [
@@ -19,16 +20,34 @@ export default class ProjectUnarchive extends PMOCommand {
         return { promptIfMultiple: false };
     }
     async execute() {
-        const { args } = await this.parse(ProjectUnarchive);
+        const { args, flags } = await this.parse(ProjectUnarchive);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Helper to handle errors in JSON mode
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('project unarchive', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        };
         const project = await this.storage.getProject(args.id);
         if (!project) {
-            this.error(`Project "${args.id}" not found.`);
+            return handleError('PROJECT_NOT_FOUND', `Project "${args.id}" not found.`);
         }
         if (!project.isArchived) {
+            if (jsonMode) {
+                outputSuccessAsJson({ projectId: project.id, projectName: project.name, alreadyUnarchived: true }, createMetadata('project unarchive', flags));
+                return;
+            }
             this.log(styles.muted(`Project "${project.name}" is not archived.`));
             return;
         }
         await this.storage.unarchiveProject(args.id);
+        if (jsonMode) {
+            outputSuccessAsJson({ projectId: project.id, projectName: project.name, unarchived: true }, createMetadata('project unarchive', flags));
+            return;
+        }
         this.log(styles.success(`\nUnarchived project "${project.name}"`));
         this.log(styles.muted('View project: prlt project view ' + args.id));
     }

package/dist/commands/project/view.d.ts

@@ -6,6 +6,7 @@ export default class ProjectView extends PMOCommand {
         id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
+        machine: 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>;
     };

package/dist/commands/project/view.js

@@ -1,8 +1,7 @@
-import { Args, Flags } from '@oclif/core';
-import inquirer from 'inquirer';
+import { Args } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { styles, getColumnStyle, getColumnEmoji, formatPriority, formatCategory } from '../../lib/styles.js';
-import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata, buildPromptConfig, } from '../../lib/prompt-json.js';
+import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class ProjectView extends PMOCommand {
     static description = 'View a project\'s board';
     static examples = [
@@ -17,10 +16,6 @@ export default class ProjectView extends PMOCommand {
     };
     static flags = {
         ...pmoBaseFlags,
-        json: Flags.boolean({
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
@@ -44,27 +39,44 @@ export default class ProjectView extends PMOCommand {
             if (projects.length === 0) {
                 return handleError('NO_PROJECTS', 'No projects found. Create a project first with "prlt project create".');
             }
-            // In JSON mode, output project selection prompt
-            if (jsonMode) {
-                const projectChoices = projects.map(p => ({ name: `${p.id} - ${p.name}`, value: p.id }));
-                outputPromptAsJson(buildPromptConfig('list', 'id', 'Select project to view:', projectChoices), createMetadata('project view', flags));
-                return;
+            // Use selectFromList helper (handles JSON mode automatically)
+            const selected = await this.selectFromList({
+                message: 'Select project to view:',
+                items: projects,
+                getName: (p) => `${p.id} - ${p.name}`,
+                getValue: (p) => p.id,
+                getCommand: (p) => `prlt project view ${p.id} --json`,
+                jsonMode: jsonMode ? { flags, commandName: 'project view' } : null,
+            });
+            if (!selected) {
+                return; // Cancelled or JSON mode (already exited)
             }
-            const { selectedProjectId } = await inquirer.prompt([{
-                    type: 'list',
-                    name: 'selectedProjectId',
-                    message: 'Select project to view:',
-                    choices: projects.map(p => ({
-                        name: `${p.id} - ${p.name}`,
-                        value: p.id,
-                    })),
-                }]);
-            projectId = selectedProjectId;
+            projectId = selected;
         }
         const project = await this.storage.getProjectBoard(projectId);
         if (!project) {
             return handleError('PROJECT_NOT_FOUND', `Project "${projectId}" not found.`);
         }
+        // In JSON mode, output project board as structured data
+        if (jsonMode) {
+            outputSuccessAsJson({
+                id: project.id,
+                name: project.name,
+                columns: project.columns.map(col => ({
+                    name: col.name,
+                    ticketCount: col.tickets.length,
+                    tickets: col.tickets.map(t => ({
+                        id: t.id,
+                        title: t.title,
+                        priority: t.priority,
+                        category: t.category,
+                        subtasksDone: t.subtasks.filter((s) => s.done).length,
+                        subtasksTotal: t.subtasks.length,
+                    })),
+                })),
+            }, createMetadata('project view', flags));
+            return;
+        }
         this.log(styles.title(`\n${project.name}`));
         this.log(styles.muted(`Project: ${project.id}\n`));
         for (const column of project.columns) {

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

@@ -8,6 +8,8 @@ export default class Add extends PMOCommand {
     static flags: {
         action: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         bulk: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     protected getPMOOptions(): {

package/dist/commands/repo/add.js

@@ -3,6 +3,7 @@ import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { colors, format } from '../../lib/colors.js';
 import { findHQRoot, promptAddSingleRepo, promptForRepositories, addRepository } from '../../lib/repos/index.js';
 import { getWorkspaceRepositories } from '../../lib/database/index.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class Add extends PMOCommand {
     static description = 'Add a repository to the HQ';
     static examples = [
@@ -30,19 +31,47 @@ export default class Add extends PMOCommand {
             description: 'Add multiple repositories interactively',
             default: false,
         }),
+        json: Flags.boolean({
+            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
+            default: false,
+        }),
     };
     getPMOOptions() {
         return { promptIfMultiple: false };
     }
     async execute() {
         const { args, flags } = await this.parse(Add);
+        // Check if JSON output mode is active
+        const jsonMode = shouldOutputJson(flags);
+        // Helper to handle errors in JSON mode
+        const handleError = (code, message) => {
+            if (jsonMode) {
+                outputErrorAsJson(code, message, createMetadata('repo add', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        };
         // Find HQ root
         const hqPath = findHQRoot();
         if (!hqPath) {
-            this.error('Not in an HQ directory. Run "prlt init" first.');
+            return handleError('NOT_IN_HQ', 'Not in an HQ directory. Run "prlt init" first.');
         }
         // Bulk mode: add multiple repositories interactively
         if (flags.bulk) {
+            // In JSON mode, output guidance
+            if (jsonMode) {
+                const agentConfig = { flags, commandName: 'repo add --bulk' };
+                await this.prompt([{
+                        type: 'list',
+                        name: 'method',
+                        message: 'Bulk mode requires interactive selection. Use one of these instead:',
+                        choices: [
+                            { name: 'Add single repository by path', value: 'path', command: 'prlt repo add <path> --json' },
+                            { name: 'Add by Git URL', value: 'url', command: 'prlt repo add <git-url> --json' },
+                        ],
+                    }], agentConfig);
+                return;
+            }
             await this.executeBulk(hqPath);
             return;
         }
@@ -60,6 +89,20 @@ export default class Add extends PMOCommand {
             }
         }
         else {
+            // In JSON mode, output prompt for method selection
+            if (jsonMode) {
+                const agentConfig = { flags, commandName: 'repo add' };
+                await this.prompt([{
+                        type: 'list',
+                        name: 'method',
+                        message: 'How would you like to add a repository?',
+                        choices: [
+                            { name: 'Enter path or Git URL', value: 'manual', command: 'prlt repo add <path> --json' },
+                            { name: 'Search for repositories (bulk)', value: 'search', command: 'prlt repo add --bulk --json' },
+                        ],
+                    }], agentConfig);
+                return;
+            }
             // Interactive mode
             const result = await promptAddSingleRepo();
             if (!result) {

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

@@ -3,6 +3,7 @@ export default class Repo extends PMOCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        machine: 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>;
     };