@proletariat/cli 0.3.32 → 0.3.34

package/dist/commands/workspace/prune.js

@@ -6,6 +6,7 @@ import { styles } from '../../lib/styles.js';
 import { getRegisteredHeadquarters, unregisterHeadquarters, } from '../../lib/machine-config.js';
 import { getWorkspaceAgents, removeAgentsFromDatabase, getDatabasePath, } from '../../lib/database/index.js';
 import { outputConfirmationNeededAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
 export default class WorkspacePrune extends PromptCommand {
     static description = 'Remove stale workspace entries and agents with deleted worktrees';
     static examples = [
@@ -14,6 +15,7 @@ export default class WorkspacePrune extends PromptCommand {
         '<%= config.bin %> <%= command.id %> --force',
     ];
     static flags = {
+        ...machineOutputFlags,
         'dry-run': Flags.boolean({
             char: 'd',
             description: 'Show what would be removed without removing',
@@ -24,23 +26,19 @@ export default class WorkspacePrune extends PromptCommand {
             description: 'Skip confirmation prompt and prune immediately',
             default: false,
         }),
-        json: Flags.boolean({
-            description: 'Output as JSON',
-            default: false,
-        }),
     };
     async run() {
         const { flags } = await this.parse(WorkspacePrune);
         // In non-TTY mode without --json (CI, scripts, piped), default to dry-run unless --force is set.
         // In --json mode, we use confirmation_needed output instead of auto-dry-run so agents can review and confirm.
         const isNonTTY = !process.stdout.isTTY;
-        const effectiveDryRun = flags['dry-run'] || (!flags.json && isNonTTY && !flags.force);
+        const effectiveDryRun = flags['dry-run'] || (!(flags.json || flags.machine) && isNonTTY && !flags.force);
         // Find stale entries
         const staleWorkspaces = this.findStaleWorkspaces();
         const staleAgents = this.findStaleAgents();
         const totalStale = staleWorkspaces.length + staleAgents.length;
         // JSON output
-        if (flags.json) {
+        if (flags.json || flags.machine) {
             const output = {
                 dryRun: effectiveDryRun,
                 staleWorkspaces: staleWorkspaces.map(w => ({

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

@@ -7,6 +7,7 @@ export default class WorkspaceRemove extends PromptCommand {
     };
     static flags: {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
     private resolveWorkspacePath;

package/dist/commands/workspace/remove.js

@@ -1,6 +1,7 @@
-import { Args, Flags } from '@oclif/core';
+import { Args } from '@oclif/core';
 import chalk from 'chalk';
 import { PromptCommand } from '../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
 import { findWorkspacesByName, findWorkspaceByPath, unregisterWorkspace, normalizePath, getActiveWorkspace, } from '../../lib/machine-config.js';
 import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class WorkspaceRemove extends PromptCommand {
@@ -16,12 +17,7 @@ export default class WorkspaceRemove extends PromptCommand {
         }),
     };
     static flags = {
-        json: Flags.boolean({
-            char: 'm',
-            aliases: ['machine'],
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
+        ...machineOutputFlags,
     };
     async run() {
         const { args, flags } = await this.parse(WorkspaceRemove);

package/dist/commands/workspace/use.d.ts

@@ -7,6 +7,7 @@ export default class WorkspaceUse extends PromptCommand {
     };
     static flags: {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/workspace/use.js

@@ -1,7 +1,8 @@
-import { Args, Flags } from '@oclif/core';
+import { Args } from '@oclif/core';
 import chalk from 'chalk';
 import * as fs from 'node:fs';
 import { PromptCommand } from '../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
 import { isValidHQ } from '../../lib/workspace.js';
 import { findWorkspacesByName, findWorkspaceByPath, setActiveWorkspace, normalizePath, getRegisteredWorkspaces, } from '../../lib/machine-config.js';
 export default class WorkspaceUse extends PromptCommand {
@@ -17,12 +18,7 @@ export default class WorkspaceUse extends PromptCommand {
         }),
     };
     static flags = {
-        json: Flags.boolean({
-            char: 'm',
-            aliases: ['machine'],
-            description: 'Output prompt configuration as JSON (for AI agents/scripts)',
-            default: false,
-        }),
+        ...machineOutputFlags,
     };
     async run() {
         const { args, flags } = await this.parse(WorkspaceUse);

package/dist/lib/database/drizzle-schema.d.ts

@@ -33,7 +33,7 @@ export declare const workspace: import("drizzle-orm/sqlite-core").SQLiteTableWit
             tableName: "workspace";
             dataType: "string";
             columnType: "SQLiteText";
-            data: "hq" | "workspace";
+            data: "workspace" | "hq";
             driverParam: string;
             notNull: true;
             hasDefault: false;

package/dist/lib/execution/runners.js

@@ -214,6 +214,10 @@ function buildPrompt(context) {
     }
     // Note: Branch setup (fetch + checkout/create) is now handled programmatically
     // in work/start.ts before the agent spawns, so no prompt instructions needed
+    // Additional instructions from --message flag (appended to any action)
+    if (context.customMessage) {
+        prompt += `\n## Additional Instructions\n\n${context.customMessage}\n`;
+    }
     // END HOOK - Action-specific completion instructions
     prompt += `\n---\n\n## When Complete\n\n`;
     // For revisions, use the revision-specific end prompt

package/dist/lib/execution/types.d.ts

@@ -86,6 +86,7 @@ export interface ExecutionContext {
     actionPrompt?: string;
     actionEndPrompt?: string;
     modifiesCode?: boolean;
+    customMessage?: string;
     prFeedback?: string;
     isRevision?: boolean;
 }

package/dist/lib/pmo/base-command.d.ts

@@ -8,14 +8,16 @@ import { type JsonFlags } from '../prompt-json.js';
  */
 export declare const jsonModeFlags: {
     json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
 };
 /**
  * Base flags for machine-readable output mode
  * Include these in your command's flags by spreading: ...machineOutputFlags
- * --json is the primary flag, -m/--machine are aliases
+ * --json and --machine/-m both trigger JSON output mode
  */
 export declare const machineOutputFlags: {
     json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
 };
 /**
  * Base flags shared by all PMO commands
@@ -23,6 +25,7 @@ export declare const machineOutputFlags: {
  */
 export declare const pmoBaseFlags: {
     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>;
 };
 /**

package/dist/lib/pmo/base-command.js

@@ -11,8 +11,11 @@ import { shouldOutputJson, outputPromptAsJson, outputErrorAsJson, createMetadata
  */
 export const jsonModeFlags = {
     json: Flags.boolean({
+        description: 'Output as JSON for AI agents/scripts',
+        default: false,
+    }),
+    machine: Flags.boolean({
         char: 'm',
-        aliases: ['machine'],
         description: 'Output as JSON for AI agents/scripts',
         default: false,
     }),
@@ -20,12 +23,15 @@ export const jsonModeFlags = {
 /**
  * Base flags for machine-readable output mode
  * Include these in your command's flags by spreading: ...machineOutputFlags
- * --json is the primary flag, -m/--machine are aliases
+ * --json and --machine/-m both trigger JSON output mode
  */
 export const machineOutputFlags = {
     json: Flags.boolean({
+        description: 'Output as JSON for AI agents/scripts',
+        default: false,
+    }),
+    machine: Flags.boolean({
         char: 'm',
-        aliases: ['machine'],
         description: 'Output as JSON for AI agents/scripts',
         default: false,
     }),

package/dist/lib/pmo/storage/base.js

@@ -467,6 +467,22 @@ Analyze this ticket and improve its definition:
 
 Do NOT implement the ticket - only improve its definition so it's ready to be worked on.
 
+## Flagging Ambiguities
+
+If you identify ambiguities or questions that need human clarification, add them to the description using this **exact format**:
+
+\`\`\`
+**Q1:** Should the API use REST or GraphQL?
+**Q2:** What is the expected timeout for sessions?
+**Q3:** Should this feature be behind a feature flag?
+\`\`\`
+
+When questions are added:
+- Add the \`needs-clarification\` label: \`--add-label "needs-clarification"\`
+- Questions can later be resolved with \`prlt ticket resolve\` or \`prlt work resolve\`
+
+If NO ambiguities are found, add the \`ready\` label instead.
+
 **AI Agent Tip:** When running \`prlt\` commands without all required arguments, use \`--json\` to receive interactive prompts as structured JSON.
 
 ## Ticket Schema Reference
@@ -528,6 +544,54 @@ After updating, output a brief summary of your grooming changes.`,
             modifiesCode: false,
             position: 0,
         },
+        {
+            id: 'resolve',
+            name: 'Resolve',
+            description: 'Help human resolve ambiguity questions flagged during grooming',
+            prompt: `${PRLT_USAGE_RULE}
+
+---
+
+# Action: Resolve Ambiguities
+
+This ticket has been groomed and has open questions (Q1, Q2, etc.) that need human answers.
+
+Your job is to help the human answer each question by:
+1. Reading the ticket description to find all **Q1:**, **Q2:**, etc. questions
+2. For each question, explore the codebase to find relevant context
+3. Present each question to the human with your findings and a suggested answer
+4. Collect the human's answer (they may accept your suggestion or provide their own)
+5. Write the resolved answers back into the ticket description
+
+## Process
+
+For each question:
+1. **Search the codebase** for relevant context (files, patterns, existing implementations)
+2. **Present your findings**: "Q1: Should this use REST or GraphQL? I found you're already using GraphQL in \`src/api/schema.ts\`..."
+3. **Suggest an answer** based on the codebase context
+4. **Ask the human** to confirm or provide their own answer
+5. After collecting all answers, update the ticket:
+   \`\`\`bash
+   prlt ticket edit {{TICKET_ID}} --description "updated description with answers"
+   prlt ticket edit {{TICKET_ID}} --remove-label "needs-clarification" --add-label "ready"
+   \`\`\`
+
+## Important
+- This is an INTERACTIVE session - always ask the human before writing answers
+- If the ticket has acceptance criteria or subtasks that need updating based on answers, update those too
+- After resolving, move the ticket to the Ready column if all questions are answered`,
+            endPrompt: `After resolving all questions:
+1. Update the ticket description with answers below each question
+2. Remove the \`needs-clarification\` label and add \`ready\` label
+3. Update acceptance criteria and subtasks if answers affect them
+
+\`\`\`bash
+prlt ticket edit {{TICKET_ID}} --description "..." --remove-label "needs-clarification" --add-label "ready"
+\`\`\``,
+            suggestedForCategories: [],
+            modifiesCode: false,
+            position: 1,
+        },
         {
             id: 'implement',
             name: 'Implement',
@@ -579,7 +643,7 @@ When complete, the ticket should be ready for code review.`,
             suggestedForCategories: ['unstarted', 'started'],
             defaultMoveToCategory: 'started',
             modifiesCode: true,
-            position: 1,
+            position: 2,
         },
         {
             id: 'continue',
@@ -624,7 +688,7 @@ git add -A && prlt commit "your change" && git push
             suggestedForCategories: ['started'],
             defaultMoveToCategory: 'started',
             modifiesCode: true,
-            position: 2,
+            position: 3,
         },
         {
             id: 'test',
@@ -666,7 +730,7 @@ git add -A && prlt commit "add tests for X" && git push
 **IMPORTANT:** Use the global \`prlt\` command.`,
             suggestedForCategories: ['started', 'completed'],
             modifiesCode: true,
-            position: 3,
+            position: 4,
         },
         {
             id: 'review',
@@ -689,7 +753,7 @@ Output a review summary with your findings and any concerns.`,
 No commits are needed for code review.`,
             suggestedForCategories: ['started', 'completed'],
             modifiesCode: false,
-            position: 4,
+            position: 5,
         },
         {
             id: 'revise',
@@ -715,7 +779,7 @@ The PR will be updated automatically.`,
             suggestedForCategories: ['completed'],
             defaultMoveToCategory: 'started',
             modifiesCode: true,
-            position: 5,
+            position: 6,
         },
     ];
     // Use INSERT OR REPLACE to always update builtin actions with latest prompts

package/dist/lib/prompt-json.d.ts

@@ -198,14 +198,17 @@ export type JsonOutput = PromptJsonOutput | SuccessJsonOutput | ErrorJsonOutput
  */
 export interface JsonFlags {
     json?: boolean;
+    machine?: boolean;
 }
 /**
  * Flags interface for machine-readable output mode detection
- * --json is the primary flag, -m/--machine are aliases that set json=true
+ * --json and --machine/-m both trigger JSON output mode
  */
 export interface MachineOutputFlags {
-    /** Primary JSON output flag. -m and --machine are aliases to this flag */
+    /** JSON output flag */
     json?: boolean;
+    /** Machine output flag (-m shorthand) */
+    machine?: boolean;
 }
 /**
  * Check if the current environment is non-TTY (piped output)

package/dist/lib/prompt-json.js

@@ -48,8 +48,8 @@ export function isNonTTY() {
  * @returns true if JSON mode should be used
  */
 export function shouldOutputJson(flags) {
-    // --json flag (includes -m and --machine aliases)
-    if (flags.json === true) {
+    // --json flag or --machine/-m flag
+    if (flags.json === true || flags.machine === true) {
         return true;
     }
     // Automatic detection for non-TTY environments
@@ -70,8 +70,8 @@ export const isAgentMode = shouldOutputJson;
  * @returns true if machine-readable output mode should be used
  */
 export function isMachineOutput(flags) {
-    // --json flag (includes -m and --machine aliases)
-    if (flags.json === true) {
+    // --json flag or --machine/-m flag
+    if (flags.json === true || flags.machine === true) {
         return true;
     }
     // Automatic detection for non-TTY environments