@proletariat/cli 0.3.55 → 0.3.57

package/dist/commands/work/shortcut.d.ts

@@ -0,0 +1,23 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class WorkShortcut extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        issue: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        executor: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        display: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        action: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        message: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'run-on-host': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'skip-permissions': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'create-pr': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        yes: 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>;
+    };
+    private findLinkedTicket;
+    private createOrUpdateLinkedTicket;
+    execute(): Promise<void>;
+}

package/dist/commands/work/shortcut.js

@@ -0,0 +1,212 @@
+import { Flags } from '@oclif/core';
+import { PMOCommand, pmoBaseFlags, autoExportToBoard, } from '../../lib/pmo/index.js';
+import { shouldOutputJson, } from '../../lib/prompt-json.js';
+import { ExternalIssueAdapterError, } from '../../lib/external-issues/types.js';
+import { listShortcutStories, getShortcutStoryByKey, buildShortcutStoryChoiceCommand, buildShortcutTicketDescription, buildShortcutMetadata, buildShortcutSpawnContextMessage, } from '../../lib/external-issues/shortcut.js';
+import { getShortcutApiToken, loadShortcutConfig } from '../../lib/shortcut/index.js';
+function buildWorkStartArgs(options) {
+    const args = [options.ticketId, '--project', options.projectId, '--ephemeral'];
+    if (options.executor)
+        args.push('--executor', options.executor);
+    if (options.display)
+        args.push('--display', options.display);
+    if (options.runOnHost)
+        args.push('--run-on-host');
+    if (options.skipPermissions)
+        args.push('--skip-permissions');
+    if (options.createPr)
+        args.push('--create-pr');
+    if (options.action)
+        args.push('--action', options.action);
+    if (options.message)
+        args.push('--message', options.message);
+    if (options.json)
+        args.push('--json');
+    if (options.machine)
+        args.push('--machine');
+    if (options.yes)
+        args.push('--yes');
+    return args;
+}
+export default class WorkShortcut extends PMOCommand {
+    static description = 'List/select Shortcut stories and spawn work using the existing work-start flow';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --issue sc-123',
+        '<%= config.bin %> <%= command.id %> --issue sc-123 --yes --skip-permissions --display terminal',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+        issue: Flags.string({
+            description: 'Shortcut story key (for example: sc-123 or 123)',
+        }),
+        limit: Flags.integer({
+            char: 'l',
+            description: 'Maximum number of Shortcut stories to fetch',
+            default: 20,
+            min: 1,
+            max: 100,
+        }),
+        executor: Flags.string({
+            char: 'e',
+            description: 'Override executor',
+            options: ['claude-code', 'codex', 'custom'],
+        }),
+        display: Flags.string({
+            char: 'd',
+            description: 'Display mode',
+            options: ['terminal', 'background', 'foreground'],
+        }),
+        action: Flags.string({
+            char: 'A',
+            description: 'Action to run in work start (default: implement)',
+            default: 'implement',
+        }),
+        message: Flags.string({
+            description: 'Additional instructions appended to spawn context',
+        }),
+        'run-on-host': Flags.boolean({
+            description: 'Run on host even if devcontainer exists',
+            default: false,
+        }),
+        'skip-permissions': Flags.boolean({
+            description: 'Skip permission prompts (danger mode)',
+            default: false,
+        }),
+        'create-pr': Flags.boolean({
+            description: 'Create PR when work is ready',
+            default: false,
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Skip confirmation prompts in downstream work start',
+            default: false,
+        }),
+    };
+    async findLinkedTicket(projectId, envelope) {
+        const tickets = await this.storage.listTickets(projectId);
+        return tickets.find((ticket) => {
+            const source = ticket.metadata?.external_source;
+            const key = ticket.metadata?.external_key;
+            const id = ticket.metadata?.external_id;
+            return source === 'shortcut'
+                && (key === envelope.source.externalKey || id === envelope.source.externalId);
+        });
+    }
+    async createOrUpdateLinkedTicket(projectId, envelope) {
+        const existing = await this.findLinkedTicket(projectId, envelope);
+        const description = buildShortcutTicketDescription(envelope);
+        const metadata = buildShortcutMetadata(envelope);
+        if (existing) {
+            const updated = await this.storage.updateTicket(existing.id, {
+                title: envelope.title,
+                description,
+                priority: envelope.priority ?? undefined,
+                category: envelope.category ?? undefined,
+                labels: envelope.labels,
+                metadata: {
+                    ...existing.metadata,
+                    ...metadata,
+                },
+            });
+            return updated;
+        }
+        return this.storage.createTicket(projectId, {
+            title: envelope.title,
+            description,
+            priority: envelope.priority ?? undefined,
+            category: envelope.category ?? undefined,
+            labels: envelope.labels,
+            metadata,
+        });
+    }
+    async execute() {
+        const { flags } = await this.parse(WorkShortcut);
+        const jsonMode = shouldOutputJson(flags);
+        const db = this.storage.getDatabase();
+        const shortcutConfig = loadShortcutConfig(db);
+        const projectId = await this.requireProject({
+            jsonMode: {
+                flags,
+                commandName: 'work shortcut',
+                baseCommand: 'prlt work shortcut',
+            },
+        });
+        const apiToken = getShortcutApiToken(db) || undefined;
+        let issues;
+        try {
+            issues = await listShortcutStories({
+                apiToken,
+                workspaceSlug: shortcutConfig?.workspaceSlug,
+            }, { limit: flags.limit });
+        }
+        catch (error) {
+            if (error instanceof ExternalIssueAdapterError) {
+                return this.handleError(error.code, error.message, { jsonMode, commandName: 'work shortcut', flags });
+            }
+            const msg = error instanceof Error ? error.message : 'Failed to fetch Shortcut stories.';
+            return this.handleError('SHORTCUT_REQUEST_FAILED', msg, { jsonMode, commandName: 'work shortcut', flags });
+        }
+        if (issues.length === 0) {
+            return this.handleError('NO_SHORTCUT_STORIES', 'No active Shortcut stories found.', { jsonMode, commandName: 'work shortcut', flags });
+        }
+        let selectedIssue = issues.find(issue => issue.source.externalKey === flags.issue);
+        if (!selectedIssue && flags.issue) {
+            try {
+                selectedIssue = await getShortcutStoryByKey({
+                    apiToken,
+                    workspaceSlug: shortcutConfig?.workspaceSlug,
+                }, flags.issue) ?? undefined;
+            }
+            catch (error) {
+                if (error instanceof ExternalIssueAdapterError) {
+                    return this.handleError(error.code, error.message, { jsonMode, commandName: 'work shortcut', flags });
+                }
+                const msg = error instanceof Error ? error.message : 'Failed to fetch Shortcut story.';
+                return this.handleError('SHORTCUT_REQUEST_FAILED', msg, { jsonMode, commandName: 'work shortcut', flags });
+            }
+            if (!selectedIssue) {
+                return this.handleError('SHORTCUT_STORY_NOT_FOUND', `Shortcut story "${flags.issue}" was not found.`, { jsonMode, commandName: 'work shortcut', flags });
+            }
+        }
+        if (!selectedIssue) {
+            const selectedKey = await this.selectFromList({
+                message: 'Select Shortcut story to spawn:',
+                items: issues,
+                getName: (issue) => {
+                    const priority = issue.priority || 'None';
+                    return `[${priority}] ${issue.source.externalKey} - ${issue.title}`;
+                },
+                getValue: issue => issue.source.externalKey,
+                getCommand: issue => buildShortcutStoryChoiceCommand(issue.source.externalKey, projectId),
+                jsonMode: jsonMode ? { flags, commandName: 'work shortcut' } : null,
+            });
+            if (!selectedKey) {
+                return;
+            }
+            selectedIssue = issues.find(issue => issue.source.externalKey === selectedKey);
+            if (!selectedIssue) {
+                return this.handleError('SHORTCUT_STORY_NOT_FOUND', `Shortcut story "${selectedKey}" was not found.`, { jsonMode, commandName: 'work shortcut', flags });
+            }
+        }
+        const ticket = await this.createOrUpdateLinkedTicket(projectId, selectedIssue);
+        await autoExportToBoard(this.pmoPath, this.storage);
+        const contextMessage = buildShortcutSpawnContextMessage(selectedIssue, flags.message);
+        const args = buildWorkStartArgs({
+            ticketId: ticket.id,
+            projectId,
+            executor: flags.executor,
+            display: flags.display,
+            runOnHost: flags['run-on-host'],
+            skipPermissions: flags['skip-permissions'],
+            createPr: flags['create-pr'],
+            action: flags.action,
+            message: contextMessage,
+            json: flags.json,
+            machine: flags.machine,
+            yes: flags.yes,
+        });
+        await this.config.runCommand('work:start', args);
+    }
+}
+//# sourceMappingURL=shortcut.js.map

package/dist/commands/work/shortcut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcut.js","sourceRoot":"","sources":["../../../src/commands/work/shortcut.ts"],"names":[],"mappings":"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"}

package/dist/commands/work/spawn.d.ts

@@ -40,12 +40,15 @@ export default class WorkSpawn extends PMOCommand {
         'jira-project': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'jira-jql': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'jira-limit': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'shortcut-limit': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         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>;
     };
     private findLinkedJiraTicket;
     private findOrCreateJiraTicket;
+    private findLinkedShortcutTicket;
+    private findOrCreateShortcutTicket;
     execute(): Promise<void>;
     /**
      * Select tickets using diet-balanced category weighting.

package/dist/commands/work/spawn.js

@@ -12,7 +12,9 @@ import { loadDietConfig, formatDietConfig, } from '../../lib/pmo/diet.js';
 import { LinearClient, LinearMapper, isLinearConfigured, loadLinearConfig, } from '../../lib/linear/index.js';
 import { parseWorkSourceRef, formatWorkSourceRef, loadActiveWorkSource, saveActiveWorkSource, getRegisteredWorkSources, } from '../../lib/work-source/index.js';
 import { isJiraConfigured, loadJiraConfig, } from '../../lib/jira/index.js';
+import { isShortcutConfigured, loadShortcutConfig, } from '../../lib/shortcut/index.js';
 import { listJiraIssues, getJiraIssueByKey, buildJiraTicketDescription, buildJiraMetadata, } from '../../lib/external-issues/jira.js';
+import { listShortcutStories, getShortcutStoryByKey, buildShortcutTicketDescription, buildShortcutMetadata, } from '../../lib/external-issues/shortcut.js';
 import { ExternalIssueAdapterError, } from '../../lib/external-issues/types.js';
 export default class WorkSpawn extends PMOCommand {
     static description = 'Spawn work for multiple tickets by column (batch mode)';
@@ -42,6 +44,9 @@ export default class WorkSpawn extends PMOCommand {
         '<%= config.bin %> <%= command.id %> --from jira:PROJ PROJ-123 PROJ-456  # Pull specific Jira issues',
         '<%= config.bin %> <%= command.id %> --from jira --jira-project PROJ   # Jira with explicit project key',
         '<%= config.bin %> work source set jira:PROJ                           # Persist Jira as default source',
+        '<%= config.bin %> <%= command.id %> --from shortcut                     # Pull Shortcut stories → PMO → spawn',
+        '<%= config.bin %> <%= command.id %> --from shortcut sc-123 sc-456       # Pull specific Shortcut stories',
+        '<%= config.bin %> work source set shortcut                              # Persist Shortcut as default source',
     ];
     static flags = {
         ...pmoBaseFlags,
@@ -189,6 +194,11 @@ export default class WorkSpawn extends PMOCommand {
             description: 'Maximum number of Jira issues to pull',
             default: 20,
         }),
+        // Shortcut integration flags
+        'shortcut-limit': Flags.integer({
+            description: 'Maximum number of Shortcut stories to pull',
+            default: 20,
+        }),
     };
     async findLinkedJiraTicket(projectId, envelope) {
         const tickets = await this.storage.listTickets(projectId);
@@ -226,6 +236,42 @@ export default class WorkSpawn extends PMOCommand {
             metadata,
         });
     }
+    async findLinkedShortcutTicket(projectId, envelope) {
+        const tickets = await this.storage.listTickets(projectId);
+        return tickets.find((ticket) => {
+            const source = ticket.metadata?.external_source;
+            const key = ticket.metadata?.external_key;
+            const id = ticket.metadata?.external_id;
+            return source === 'shortcut'
+                && (key === envelope.source.externalKey || id === envelope.source.externalId);
+        });
+    }
+    async findOrCreateShortcutTicket(projectId, envelope) {
+        const existing = await this.findLinkedShortcutTicket(projectId, envelope);
+        const description = buildShortcutTicketDescription(envelope);
+        const metadata = buildShortcutMetadata(envelope);
+        if (existing) {
+            return this.storage.updateTicket(existing.id, {
+                title: envelope.title,
+                description,
+                priority: envelope.priority ?? undefined,
+                category: envelope.category ?? undefined,
+                labels: envelope.labels,
+                metadata: {
+                    ...existing.metadata,
+                    ...metadata,
+                },
+            });
+        }
+        return this.storage.createTicket(projectId, {
+            title: envelope.title,
+            description,
+            priority: envelope.priority ?? undefined,
+            category: envelope.category ?? undefined,
+            labels: envelope.labels,
+            metadata,
+        });
+    }
     async execute() {
         const { flags, argv } = await this.parse(WorkSpawn);
         // Check if JSON output mode is active
@@ -603,8 +649,135 @@ export default class WorkSpawn extends PMOCommand {
             // Sync board
             await autoExportToBoard(this.pmoPath, this.storage);
         }
+        else if (resolvedSource?.provider === 'shortcut') {
+            // =========================================================================
+            // Shortcut source: Pull Shortcut stories → mirror into PMO → spawn from PMO
+            // =========================================================================
+            const db = this.storage.getDatabase();
+            if (!isShortcutConfigured(db)) {
+                return handleError('SHORTCUT_NOT_CONFIGURED', 'Shortcut is not configured. Set PRLT_SHORTCUT_API_TOKEN or SHORTCUT_API_TOKEN environment variables, or use "prlt shortcut connect".');
+            }
+            const shortcutConfig = loadShortcutConfig(db);
+            // Determine project first (needed for ticket creation)
+            const shortcutProjectId = await this.requireProject({
+                jsonMode: jsonMode ? {
+                    flags,
+                    commandName: 'work spawn',
+                    baseCommand: `prlt work spawn --from ${formatWorkSourceRef(resolvedSource)}`,
+                } : undefined,
+            });
+            // Get project workflow statuses for mapping
+            const workflow = await this.storage.getProjectWorkflow(shortcutProjectId);
+            if (!workflow) {
+                return handleError('NO_WORKFLOW', 'Project has no workflow configured.');
+            }
+            // Check if args are Shortcut identifiers (e.g., sc-123 or plain numbers)
+            const shortcutIdentifiers = ticketIdArgs.filter((id) => /^(sc-)?\d+$/i.test(id));
+            const pmoTicketIds = [];
+            const shortcutAdapterConfig = {
+                apiToken: shortcutConfig.apiToken,
+                workspaceSlug: shortcutConfig.workspaceSlug,
+            };
+            if (shortcutIdentifiers.length > 0) {
+                // Fetch and import specific Shortcut stories
+                if (!jsonMode) {
+                    this.log(styles.muted(`Pulling ${shortcutIdentifiers.length} story(ies) from Shortcut...`));
+                }
+                for (const identifier of shortcutIdentifiers) {
+                    try {
+                        // eslint-disable-next-line no-await-in-loop
+                        const envelope = await getShortcutStoryByKey(shortcutAdapterConfig, identifier);
+                        if (!envelope) {
+                            if (!jsonMode)
+                                this.warn(`Shortcut story not found: ${identifier}`);
+                            continue;
+                        }
+                        // eslint-disable-next-line no-await-in-loop
+                        const ticket = await this.findOrCreateShortcutTicket(shortcutProjectId, envelope);
+                        pmoTicketIds.push(ticket.id);
+                        if (!jsonMode) {
+                            this.log(styles.muted(`  Imported: ${identifier} → ${ticket.id}`));
+                        }
+                    }
+                    catch (error) {
+                        if (error instanceof ExternalIssueAdapterError) {
+                            return handleError(`SHORTCUT_${error.code}`, error.message);
+                        }
+                        throw error;
+                    }
+                }
+            }
+            else {
+                // Fetch stories using filters
+                if (!jsonMode) {
+                    this.log(styles.muted('Pulling stories from Shortcut...'));
+                }
+                let issues;
+                try {
+                    issues = await listShortcutStories(shortcutAdapterConfig, {
+                        limit: flags['shortcut-limit'],
+                    });
+                }
+                catch (error) {
+                    if (error instanceof ExternalIssueAdapterError) {
+                        return handleError(`SHORTCUT_${error.code}`, error.message);
+                    }
+                    const msg = error instanceof Error ? error.message : 'Failed to fetch Shortcut stories.';
+                    return handleError('SHORTCUT_REQUEST_FAILED', msg);
+                }
+                if (issues.length === 0) {
+                    if (jsonMode) {
+                        outputSuccessAsJson({
+                            imported: 0,
+                            spawned: 0,
+                            message: 'No matching Shortcut stories found.',
+                        }, createMetadata('work spawn', flags));
+                        return;
+                    }
+                    this.log(styles.muted('No matching Shortcut stories found.'));
+                    return;
+                }
+                if (!jsonMode) {
+                    this.log(styles.muted(`Found ${issues.length} story(ies). Importing into PMO...`));
+                }
+                let imported = 0;
+                let skipped = 0;
+                for (const envelope of issues) {
+                    // eslint-disable-next-line no-await-in-loop
+                    const existing = await this.findLinkedShortcutTicket(shortcutProjectId, envelope);
+                    if (existing) {
+                        pmoTicketIds.push(existing.id);
+                        skipped++;
+                    }
+                    else {
+                        // eslint-disable-next-line no-await-in-loop
+                        const ticket = await this.findOrCreateShortcutTicket(shortcutProjectId, envelope);
+                        pmoTicketIds.push(ticket.id);
+                        imported++;
+                    }
+                }
+                if (!jsonMode) {
+                    if (imported > 0)
+                        this.log(styles.success(`  Imported: ${imported}`));
+                    if (skipped > 0)
+                        this.log(styles.muted(`  Already imported: ${skipped}`));
+                }
+            }
+            if (pmoTicketIds.length === 0) {
+                return handleError('NO_SHORTCUT_STORIES', 'No Shortcut stories were imported. Nothing to spawn.');
+            }
+            if (!jsonMode) {
+                this.log('');
+                this.log(styles.header(`Spawning agents for ${pmoTicketIds.length} imported ticket(s)...`));
+                this.log('');
+            }
+            // Replace ticket args with the imported PMO ticket IDs
+            ticketIdArgs = pmoTicketIds;
+            // Sync board
+            await autoExportToBoard(this.pmoPath, this.storage);
+        }
         else if (resolvedSource && resolvedSource.provider !== 'pmo') {
-            return handleError('SOURCE_NOT_SUPPORTED', `Source "${resolvedSource.provider}" is configured but not supported by work spawn yet. Use --from pmo, --from linear[:team], or --from jira[:project].`);
+            return handleError('SOURCE_NOT_SUPPORTED', `Source "${resolvedSource.provider}" is configured but not supported by work spawn yet. Use --from pmo, --from linear[:team], --from jira[:project], or --from shortcut.`);
         }
         // Try to infer project from ticket IDs if provided
         let projectId;
@@ -646,7 +819,7 @@ export default class WorkSpawn extends PMOCommand {
             workspaceInfo = getWorkspaceInfo();
         }
         catch {
-            return handleError('NOT_IN_WORKSPACE', 'Not in a workspace. Run "prlt init" first.');
+            return handleError('NOT_IN_WORKSPACE', 'Not in a workspace. Run "prlt new" first.');
         }
         // Open database
         const dbPath = path.join(workspaceInfo.path, '.proletariat', 'workspace.db');