@proletariat/cli 0.3.96 → 0.3.98

package/dist/lib/providers/asana-provider.js

@@ -0,0 +1,426 @@
+/**
+ * Asana Ticket Provider
+ *
+ * Writes ticket operations directly to Asana via REST API,
+ * then updates local PMO to keep it in sync.
+ *
+ * Asana is the source of truth, PMO is best-effort mirror.
+ * Board sections map to kanban columns / prlt intents.
+ */
+import { AsanaClient } from '../asana/client.js';
+import { AsanaMapper } from '../asana/mapper.js';
+import { getAsanaAccessToken, loadAsanaConfig } from '../asana/config.js';
+export class AsanaTicketProvider {
+    db;
+    storage;
+    projectId;
+    name = 'asana';
+    constructor(db, storage, projectId) {
+        this.db = db;
+        this.storage = storage;
+        this.projectId = projectId;
+    }
+    getAccessTokenOrFail() {
+        const token = getAsanaAccessToken(this.db);
+        if (!token)
+            throw new Error('Asana access token not configured');
+        return token;
+    }
+    async moveTicket(ticketId, newState) {
+        let token;
+        try {
+            token = this.getAccessTokenOrFail();
+        }
+        catch {
+            return { success: false, provider: 'asana', error: 'Asana access token not configured' };
+        }
+        // Look up Asana task GID from mapper
+        const mapper = new AsanaMapper(this.db);
+        const mapping = mapper.getByTicketId(ticketId);
+        if (!mapping) {
+            return { success: false, provider: 'asana', error: `No Asana mapping for ticket ${ticketId}` };
+        }
+        const client = new AsanaClient(token);
+        // Get the task to find its project membership
+        const task = await client.getTask(mapping.asanaTaskGid);
+        if (!task) {
+            return { success: false, provider: 'asana', error: `Asana task ${mapping.asanaTaskGid} not found` };
+        }
+        // Get the project GID from the mapping or task memberships
+        const projectGid = mapping.asanaProjectGid || task.memberships?.[0]?.project?.gid;
+        if (!projectGid) {
+            return { success: false, provider: 'asana', error: 'Cannot determine Asana project for section lookup' };
+        }
+        // Get project sections and find the matching one for the target state
+        let sections;
+        try {
+            sections = await client.listSections(projectGid);
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'asana',
+                error: `Failed to list Asana sections: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+        const targetSection = findMatchingSection(sections, newState);
+        if (!targetSection) {
+            return {
+                success: false,
+                provider: 'asana',
+                error: `No matching Asana section for state "${newState}". Available sections: ${sections.map(s => s.name).join(', ')}`,
+            };
+        }
+        // Move the task to the target section
+        try {
+            await client.addTaskToSection(targetSection.gid, mapping.asanaTaskGid);
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'asana',
+                error: `Failed to move Asana task to section: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+        // If the target state looks like a "done" state, mark the task as completed
+        if (isCompletedState(newState)) {
+            try {
+                await client.updateTask(mapping.asanaTaskGid, { name: task.name, completed: true });
+            }
+            catch {
+                // Non-fatal: section move is the primary action
+            }
+        }
+        // Update local PMO mirror (best-effort)
+        try {
+            await this.storage.moveTicket(this.projectId, ticketId, newState);
+        }
+        catch {
+            // Non-fatal: Asana is the source of truth
+        }
+        // Update sync timestamp (best-effort)
+        try {
+            mapper.updateSyncTimestamp(ticketId);
+        }
+        catch {
+            // Non-fatal
+        }
+        return { success: true, provider: 'asana' };
+    }
+    async deleteTicket(ticketId) {
+        let token;
+        try {
+            token = this.getAccessTokenOrFail();
+        }
+        catch {
+            return { success: false, provider: 'asana', error: 'Asana access token not configured' };
+        }
+        // Look up Asana task GID from mapper
+        const mapper = new AsanaMapper(this.db);
+        const mapping = mapper.getByTicketId(ticketId);
+        if (mapping) {
+            const client = new AsanaClient(token);
+            try {
+                await client.deleteTask(mapping.asanaTaskGid);
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    provider: 'asana',
+                    error: `Failed to delete Asana task: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        }
+        // Delete the local PMO mirror
+        try {
+            await this.storage.deleteTicket(ticketId);
+        }
+        catch {
+            // Non-fatal if Asana delete succeeded
+        }
+        return { success: true, provider: 'asana' };
+    }
+    async listTickets(_projectId, filter) {
+        let token;
+        try {
+            token = this.getAccessTokenOrFail();
+        }
+        catch {
+            return { success: false, provider: 'asana', tickets: [], error: 'Asana access token not configured' };
+        }
+        const asanaConfig = loadAsanaConfig(this.db);
+        const projectGid = asanaConfig?.projectGid || process.env.PRLT_ASANA_PROJECT_GID;
+        if (!projectGid) {
+            return { success: false, provider: 'asana', tickets: [], error: 'Asana project GID is required. Run "prlt asana connect" or set PRLT_ASANA_PROJECT_GID.' };
+        }
+        try {
+            const client = new AsanaClient(token);
+            const tasks = await client.listTasks(projectGid);
+            let tickets = tasks.map(task => asanaTaskToTicket(task));
+            // Apply client-side filters
+            if (filter?.priority) {
+                tickets = tickets.filter(t => t.priority === filter.priority);
+            }
+            if (filter?.column) {
+                tickets = tickets.filter(t => t.statusName === filter.column);
+            }
+            if (filter?.category) {
+                tickets = tickets.filter(t => t.category === filter.category);
+            }
+            if (filter?.search) {
+                const term = filter.search.toLowerCase();
+                tickets = tickets.filter(t => t.title.toLowerCase().includes(term) ||
+                    (t.description || '').toLowerCase().includes(term));
+            }
+            if (filter?.label) {
+                const label = filter.label.toLowerCase();
+                tickets = tickets.filter(t => t.labels.some(l => l.toLowerCase() === label));
+            }
+            return { success: true, provider: 'asana', tickets };
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'asana',
+                tickets: [],
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async createTicket(projectId, input) {
+        let token;
+        try {
+            token = this.getAccessTokenOrFail();
+        }
+        catch {
+            return { success: false, provider: 'asana', error: 'Asana access token not configured' };
+        }
+        const asanaConfig = loadAsanaConfig(this.db);
+        const asanaProjectGid = asanaConfig?.projectGid || process.env.PRLT_ASANA_PROJECT_GID;
+        if (!asanaProjectGid) {
+            return { success: false, provider: 'asana', error: 'Asana project GID is required. Run "prlt asana connect" or set PRLT_ASANA_PROJECT_GID.' };
+        }
+        try {
+            const client = new AsanaClient(token);
+            // Create the task in Asana
+            const task = await client.createTask({
+                name: input.title,
+                notes: input.description || undefined,
+                projects: [asanaProjectGid],
+            });
+            // Create local PMO mirror ticket
+            const mirrorDescription = [
+                input.description || '',
+                '',
+                '---',
+                `_Created in Asana: [${task.name}](https://app.asana.com/0/0/${task.gid})_`,
+            ].join('\n').trim();
+            const pmoTicket = await this.storage.createTicket(projectId, {
+                ...input,
+                title: task.name,
+                description: mirrorDescription,
+                metadata: {
+                    ...input.metadata,
+                    'external_source': 'asana',
+                    'external_id': task.gid,
+                    'external_key': task.gid,
+                    'external_url': task.permalink_url || `https://app.asana.com/0/0/${task.gid}`,
+                },
+            });
+            // Create mapping record for sync operations
+            const mapper = new AsanaMapper(this.db);
+            mapper.createOrUpdateMapping(pmoTicket.id, task.gid, asanaProjectGid);
+            return { success: true, provider: 'asana', ticket: pmoTicket };
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'asana',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async getTicket(ticketId) {
+        // Use local PMO mirror to avoid unnecessary API calls
+        try {
+            const ticket = await this.storage.getTicket(ticketId);
+            return { success: true, provider: 'asana', ticket };
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'asana',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async updateTicket(ticketId, input) {
+        let token;
+        try {
+            token = this.getAccessTokenOrFail();
+        }
+        catch {
+            return { success: false, provider: 'asana', error: 'Asana access token not configured' };
+        }
+        // Look up Asana task GID from mapper
+        const mapper = new AsanaMapper(this.db);
+        const mapping = mapper.getByTicketId(ticketId);
+        if (mapping) {
+            // Build Asana update payload from input fields
+            const asanaInput = {};
+            if (input.title !== undefined)
+                asanaInput.name = input.title;
+            if (input.description !== undefined)
+                asanaInput.notes = input.description ?? undefined;
+            // Only call Asana API if there are Asana-relevant fields
+            if (Object.keys(asanaInput).length > 0) {
+                const client = new AsanaClient(token);
+                try {
+                    await client.updateTask(mapping.asanaTaskGid, asanaInput);
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        provider: 'asana',
+                        error: `Failed to update Asana task: ${error instanceof Error ? error.message : String(error)}`,
+                    };
+                }
+            }
+            // Update sync timestamp (best-effort)
+            try {
+                mapper.updateSyncTimestamp(ticketId);
+            }
+            catch {
+                // Non-fatal
+            }
+        }
+        // Also update local PMO mirror
+        try {
+            const ticket = await this.storage.updateTicket(ticketId, input);
+            return { success: true, provider: 'asana', ticket };
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'asana',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async assignTicket(ticketId, assignee) {
+        let token;
+        try {
+            token = this.getAccessTokenOrFail();
+        }
+        catch {
+            return { success: false, provider: 'asana', error: 'Asana access token not configured' };
+        }
+        // Look up Asana task GID from mapper
+        const mapper = new AsanaMapper(this.db);
+        const mapping = mapper.getByTicketId(ticketId);
+        if (mapping) {
+            // Asana assignment requires user GID. Best-effort — search by name if possible.
+            // For now, skip the Asana-side assignment (same pattern as Trello).
+            // The local PMO mirror is always updated.
+        }
+        // Update local PMO mirror
+        try {
+            await this.storage.updateTicket(ticketId, { assignee });
+            return { success: true, provider: 'asana' };
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'asana',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+}
+/**
+ * Convert an Asana task to a normalized PMO Ticket.
+ */
+function asanaTaskToTicket(task) {
+    const sectionName = task.memberships?.[0]?.section?.name;
+    const statusName = task.completed ? 'Completed' : (sectionName || 'Open');
+    const statusCategory = task.completed ? 'completed' : deriveStatusCategory(sectionName);
+    const projectName = task.memberships?.[0]?.project?.name;
+    const projectGid = task.memberships?.[0]?.project?.gid;
+    return {
+        id: task.gid,
+        title: task.name,
+        description: task.notes || undefined,
+        projectId: projectGid || '',
+        projectName: projectName || 'Asana',
+        statusId: sectionName || (task.completed ? 'completed' : 'open'),
+        statusName,
+        statusCategory: statusCategory,
+        owner: task.assignee?.name || undefined,
+        assignee: task.assignee?.name || undefined,
+        subtasks: [],
+        labels: (task.tags ?? []).map(t => t.name),
+        metadata: {
+            external_source: 'asana',
+            external_key: task.gid,
+            external_id: task.gid,
+            external_url: task.permalink_url || `https://app.asana.com/0/0/${task.gid}`,
+        },
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    };
+}
+/**
+ * Derive a PMO status category from an Asana section name.
+ * Uses heuristic matching against common section naming patterns.
+ */
+function deriveStatusCategory(sectionName) {
+    if (!sectionName)
+        return 'unstarted';
+    const lower = sectionName.toLowerCase();
+    // Completed states
+    if (lower.includes('done') || lower.includes('complete') || lower.includes('shipped') || lower.includes('closed')) {
+        return 'completed';
+    }
+    // Canceled states
+    if (lower.includes('cancel') || lower.includes('won\'t do') || lower.includes('wont do')) {
+        return 'canceled';
+    }
+    // Started states
+    if (lower.includes('progress') || lower.includes('doing') || lower.includes('active') || lower.includes('review') || lower.includes('testing')) {
+        return 'started';
+    }
+    // Backlog / unstarted
+    if (lower.includes('backlog') || lower.includes('todo') || lower.includes('to do') || lower.includes('icebox') || lower.includes('later')) {
+        return 'unstarted';
+    }
+    // Default to started for unknown section names
+    return 'started';
+}
+/**
+ * Find the best matching Asana section for a target state name.
+ * Uses case-insensitive exact match first, then substring match.
+ */
+function findMatchingSection(sections, targetState) {
+    const lower = targetState.toLowerCase();
+    // 1. Exact match (case-insensitive)
+    const exact = sections.find(s => s.name.toLowerCase() === lower);
+    if (exact)
+        return exact;
+    // 2. Section name contains the target state
+    const contains = sections.find(s => s.name.toLowerCase().includes(lower));
+    if (contains)
+        return contains;
+    // 3. Target state contains the section name
+    const reverseContains = sections.find(s => lower.includes(s.name.toLowerCase()));
+    if (reverseContains)
+        return reverseContains;
+    return null;
+}
+/**
+ * Check if a state name represents a completed/done state.
+ */
+function isCompletedState(stateName) {
+    const lower = stateName.toLowerCase();
+    return lower.includes('done') || lower.includes('complete') || lower.includes('shipped') || lower.includes('closed');
+}
+//# sourceMappingURL=asana-provider.js.map

package/dist/lib/providers/asana-provider.js.map

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

package/dist/lib/providers/auto-mapper.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Auto-Mapper for Transition Intents
+ *
+ * Auto-guesses intent-to-state mappings when connecting a board.
+ * Uses provider state types first, then name heuristics.
+ *
+ * Each provider can have different state type vocabularies:
+ * - Linear: triage, backlog, unstarted, started, completed, canceled
+ * - Jira: new, indeterminate, done, category-based
+ * - Trello: no types (name heuristics only)
+ */
+import type { TransitionIntent } from './state-intents.js';
+export interface BoardState {
+    id: string;
+    name: string;
+    type?: string;
+    position?: number;
+}
+export interface IntentMapping {
+    intent: TransitionIntent;
+    stateName: string;
+    stateId: string;
+    confidence: 'type' | 'name' | 'none';
+}
+/**
+ * Auto-guess transition intent mappings from a list of board states.
+ *
+ * Strategy:
+ * 1. For each intent, check if any state has a matching type (provider-specific)
+ * 2. If no type match, fall back to name heuristics from DEFAULT_INTENTS aliases
+ * 3. States can only be mapped to one intent (first match wins by intent priority)
+ *
+ * @param states - Available board states from the provider
+ * @param providerType - Provider type for type-based mapping ('linear', 'jira', etc.)
+ * @returns Array of intent mappings, one per matched intent
+ */
+export declare function autoMapIntents(states: BoardState[], providerType?: 'linear' | 'jira' | 'trello' | 'asana' | 'shortcut' | 'clickup' | 'github' | 'pmo'): IntentMapping[];
+/**
+ * Format intent mappings for display to the user.
+ *
+ * @param mappings - The auto-guessed mappings
+ * @param allStates - All available board states
+ * @returns Array of display lines
+ */
+export declare function formatMappingTable(mappings: IntentMapping[], allStates: BoardState[]): string[];

package/dist/lib/providers/auto-mapper.js

@@ -0,0 +1,138 @@
+/**
+ * Auto-Mapper for Transition Intents
+ *
+ * Auto-guesses intent-to-state mappings when connecting a board.
+ * Uses provider state types first, then name heuristics.
+ *
+ * Each provider can have different state type vocabularies:
+ * - Linear: triage, backlog, unstarted, started, completed, canceled
+ * - Jira: new, indeterminate, done, category-based
+ * - Trello: no types (name heuristics only)
+ */
+import { matchIntentByAliases, getDefaultIntent } from './state-intents.js';
+/**
+ * Map from Linear state types to transition intents.
+ * Linear has no native "review" type, so that's always resolved by name heuristics.
+ */
+const LINEAR_TYPE_TO_INTENT = {
+    started: 'started',
+    completed: 'completed',
+    canceled: 'dropped',
+    cancelled: 'dropped',
+    backlog: 'paused',
+    unstarted: 'ready',
+};
+/**
+ * Map from Jira status category keys to transition intents.
+ * Jira has 3 categories: new, indeterminate, done.
+ * "needs_review" has no Jira category — resolved by name heuristics.
+ */
+const JIRA_CATEGORY_TO_INTENT = {
+    new: 'ready',
+    indeterminate: 'started',
+    done: 'completed',
+};
+/**
+ * Auto-guess transition intent mappings from a list of board states.
+ *
+ * Strategy:
+ * 1. For each intent, check if any state has a matching type (provider-specific)
+ * 2. If no type match, fall back to name heuristics from DEFAULT_INTENTS aliases
+ * 3. States can only be mapped to one intent (first match wins by intent priority)
+ *
+ * @param states - Available board states from the provider
+ * @param providerType - Provider type for type-based mapping ('linear', 'jira', etc.)
+ * @returns Array of intent mappings, one per matched intent
+ */
+export function autoMapIntents(states, providerType = 'pmo') {
+    const mappings = [];
+    const usedStateIds = new Set();
+    // Priority order for intent resolution
+    const intentOrder = [
+        'started',
+        'needs_review',
+        'completed',
+        'paused',
+        'ready',
+        'dropped',
+    ];
+    for (const intent of intentOrder) {
+        // 1. Try type-based mapping (provider-specific)
+        if (providerType === 'linear') {
+            const typeMatch = states.find(s => s.type && LINEAR_TYPE_TO_INTENT[s.type] === intent && !usedStateIds.has(s.id));
+            if (typeMatch) {
+                mappings.push({
+                    intent,
+                    stateName: typeMatch.name,
+                    stateId: typeMatch.id,
+                    confidence: 'type',
+                });
+                usedStateIds.add(typeMatch.id);
+                continue;
+            }
+        }
+        if (providerType === 'jira') {
+            const typeMatch = states.find(s => s.type && JIRA_CATEGORY_TO_INTENT[s.type] === intent && !usedStateIds.has(s.id));
+            if (typeMatch) {
+                mappings.push({
+                    intent,
+                    stateName: typeMatch.name,
+                    stateId: typeMatch.id,
+                    confidence: 'type',
+                });
+                usedStateIds.add(typeMatch.id);
+                continue;
+            }
+        }
+        // 2. Fall back to name heuristics from DEFAULT_INTENTS
+        const intentDef = getDefaultIntent(intent);
+        if (intentDef) {
+            const availableStates = states.filter(s => !usedStateIds.has(s.id));
+            const nameMatch = matchIntentByAliases(availableStates.map(s => ({ id: s.id, name: s.name })), intentDef);
+            if (nameMatch) {
+                mappings.push({
+                    intent,
+                    stateName: nameMatch.name,
+                    stateId: nameMatch.id,
+                    confidence: 'name',
+                });
+                usedStateIds.add(nameMatch.id);
+                continue;
+            }
+        }
+    }
+    return mappings;
+}
+/**
+ * Format intent mappings for display to the user.
+ *
+ * @param mappings - The auto-guessed mappings
+ * @param allStates - All available board states
+ * @returns Array of display lines
+ */
+export function formatMappingTable(mappings, allStates) {
+    const lines = [];
+    const maxStateLen = Math.max(...allStates.map(s => s.name.length), 10);
+    const maxIntentLen = Math.max(...mappings.map(m => m.intent.length), 10);
+    // Header
+    lines.push(`${'Board State'.padEnd(maxStateLen + 2)}${'Intent'.padEnd(maxIntentLen + 2)}Work Command`);
+    lines.push(`${'─'.repeat(maxStateLen + 2)}${'─'.repeat(maxIntentLen + 2)}${'─'.repeat(20)}`);
+    const intentToCommand = {
+        started: 'work start',
+        needs_review: 'work ready',
+        completed: 'work ship',
+        paused: 'work stop',
+        ready: 'work groom',
+        dropped: 'work drop',
+    };
+    // Map states to their intents
+    const stateToMapping = new Map(mappings.map(m => [m.stateId, m]));
+    for (const state of allStates) {
+        const mapping = stateToMapping.get(state.id);
+        const intentStr = mapping ? mapping.intent : '(unmapped)';
+        const commandStr = mapping ? intentToCommand[mapping.intent] || '' : '';
+        lines.push(`${state.name.padEnd(maxStateLen + 2)}${intentStr.padEnd(maxIntentLen + 2)}${commandStr}`);
+    }
+    return lines;
+}
+//# sourceMappingURL=auto-mapper.js.map

package/dist/lib/providers/auto-mapper.js.map

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