@proletariat/cli 0.3.90 → 0.3.92

package/dist/lib/providers/state-resolution.js

@@ -0,0 +1,302 @@
+/**
+ * State Resolution Engine
+ *
+ * Resolves semantic intents (e.g., 'review', 'active', 'done') to actual
+ * PM tool states at runtime. Never caches state IDs across calls.
+ *
+ * Resolution flow:
+ * 1. Always fetch fresh states from the PM provider
+ * 2. Check user config — `state-map.{intent}` overrides exact-match against fetched states
+ * 3. Match against built-in semantic intent aliases
+ * 4. No config + no alias match → LLM resolves (pass available states to LLM)
+ * 5. No match → skip (don't move, log warning)
+ *
+ * The same move() function works across Linear, Trello, ClickUp, Jira, etc. —
+ * each provider implements fetchStates() differently but returns the same shape.
+ * Resolution logic is provider-agnostic.
+ */
+import { SettingsStore } from '../database/settings-store.js';
+import { matchIntentByAliases, getDefaultIntent } from './state-intents.js';
+/**
+ * Config key prefix for state-map overrides.
+ * e.g., `state-map.review` → "Awaiting Client Feedback"
+ */
+const STATE_MAP_PREFIX = 'state-map.';
+// ---------------------------------------------------------------------------
+// LLM Resolution
+// ---------------------------------------------------------------------------
+/**
+ * Use the LLM to resolve which available state best matches a semantic intent.
+ *
+ * Sends the list of available states and the intent to the Anthropic API.
+ * Returns the matching state ID, or null if no match.
+ *
+ * Requires ANTHROPIC_API_KEY to be set.
+ */
+export async function llmResolveState(states, intent) {
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+        return null;
+    }
+    const stateList = states.map(s => `- "${s.name}" (id: ${s.id})`).join('\n');
+    const prompt = `You are a state resolution assistant. Given a list of available workflow states from a project management tool and a semantic intent, pick the state that best matches the intent.
+
+Available states:
+${stateList}
+
+Semantic intent: "${intent}"
+${getDefaultIntent(intent) ? `Intent description: ${getDefaultIntent(intent).description}` : ''}
+
+Respond with ONLY the exact state ID that best matches this intent. If no state matches, respond with "NONE".`;
+    try {
+        const response = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': apiKey,
+                'anthropic-version': '2023-06-01',
+            },
+            body: JSON.stringify({
+                model: 'claude-haiku-4-5-20251001',
+                max_tokens: 100,
+                messages: [
+                    {
+                        role: 'user',
+                        content: prompt,
+                    },
+                ],
+            }),
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const data = (await response.json());
+        const text = data.content?.[0]?.text?.trim();
+        if (!text || text === 'NONE') {
+            return null;
+        }
+        // The LLM should return a state ID — find the matching state
+        const match = states.find(s => s.id === text);
+        if (match)
+            return match;
+        // Fallback: LLM might have returned a state name instead of ID
+        const nameMatch = states.find(s => s.name.toLowerCase() === text.toLowerCase());
+        if (nameMatch)
+            return nameMatch;
+        return null;
+    }
+    catch {
+        // LLM call failed — non-fatal, fall through to skip
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Config Resolution
+// ---------------------------------------------------------------------------
+/**
+ * Check user config for a state-map override for the given intent.
+ * Config stores state NAMES, not IDs.
+ *
+ * @param db - Database instance for settings lookup
+ * @param intent - Semantic intent name (e.g., 'review')
+ * @returns The configured state name, or null if not set
+ */
+export function getStateMapConfig(db, intent) {
+    try {
+        const settings = new SettingsStore(db);
+        return settings.get(`${STATE_MAP_PREFIX}${intent}`);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Set a state-map config override for an intent.
+ *
+ * @param db - Database instance
+ * @param intent - Semantic intent name
+ * @param stateName - The state name to map to
+ */
+export function setStateMapConfig(db, intent, stateName) {
+    const settings = new SettingsStore(db);
+    settings.set(`${STATE_MAP_PREFIX}${intent}`, stateName);
+}
+/**
+ * Remove a state-map config override for an intent.
+ */
+export function deleteStateMapConfig(db, intent) {
+    const settings = new SettingsStore(db);
+    settings.delete(`${STATE_MAP_PREFIX}${intent}`);
+}
+/**
+ * List all state-map config overrides.
+ */
+export function listStateMapConfigs(db) {
+    try {
+        const settings = new SettingsStore(db);
+        const entries = settings.getByPrefix(STATE_MAP_PREFIX);
+        return entries.map(e => ({
+            intent: e.key.slice(STATE_MAP_PREFIX.length),
+            stateName: e.value,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// State Fetching — Provider Adapters
+// ---------------------------------------------------------------------------
+/**
+ * Create a PMProvider adapter from the existing TicketProvider + ProviderStorage.
+ *
+ * Fetches fresh states from the project's board via storage, and delegates
+ * moveTicket to the TicketProvider (which routes to Linear/Jira/PMO).
+ */
+export function createPMProviderAdapter(provider, storage, projectId) {
+    return {
+        async fetchStates(_ticketId) {
+            const board = await storage.getProjectBoard(projectId);
+            if (!board)
+                return [];
+            return board.columns.map((col, idx) => ({
+                id: col.name, // For PMO, the state ID is the column name
+                name: col.name,
+            }));
+        },
+        async moveTicket(ticketId, stateId) {
+            const result = await provider.moveTicket(ticketId, stateId);
+            return { success: result.success, error: result.error };
+        },
+    };
+}
+/**
+ * Move a ticket to a state matching a semantic intent.
+ *
+ * Resolution order:
+ * 1. Fetch fresh states from the provider (never cache)
+ * 2. Check user config for `state-map.{intent}` override → exact match
+ * 3. Match against built-in semantic intent aliases
+ * 4. LLM fallback — ask Claude which state matches the intent
+ * 5. No match → skip, return warning
+ *
+ * @param pmProvider - The PM provider to fetch states from and move tickets in
+ * @param ticketId - The ticket to move
+ * @param intent - The semantic intent (e.g., 'review', 'active', 'done', 'blocked')
+ * @param dbOrOptions - Database instance or options object
+ * @returns Resolution result with success/failure and metadata
+ */
+export async function move(pmProvider, ticketId, intent, dbOrOptions) {
+    // Normalize arguments: support both `move(p, id, intent, db)` and `move(p, id, intent, { db, currentState })`
+    let db;
+    let currentState;
+    if (dbOrOptions && typeof dbOrOptions === 'object' && 'prepare' in dbOrOptions) {
+        // It's a Database instance (has .prepare method)
+        db = dbOrOptions;
+    }
+    else if (dbOrOptions && typeof dbOrOptions === 'object') {
+        const opts = dbOrOptions;
+        db = opts.db;
+        currentState = opts.currentState;
+    }
+    // 1. Always fetch fresh states
+    let states;
+    try {
+        states = await pmProvider.fetchStates(ticketId);
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Failed to fetch states: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    if (states.length === 0) {
+        return {
+            success: false,
+            error: 'No states available from provider',
+        };
+    }
+    // Helper: check if ticket is already in the resolved state (case-insensitive)
+    const isAlreadyInState = (stateName) => {
+        if (!currentState)
+            return false;
+        return currentState.toLowerCase() === stateName.toLowerCase();
+    };
+    // 2. Check user config override
+    if (db) {
+        const configOverride = getStateMapConfig(db, intent);
+        if (configOverride) {
+            const match = states.find(s => s.name.toLowerCase() === configOverride.toLowerCase());
+            if (match) {
+                if (isAlreadyInState(match.name)) {
+                    return { success: false, resolvedVia: 'config', stateName: match.name, stateId: match.id };
+                }
+                const result = await pmProvider.moveTicket(ticketId, match.id);
+                return {
+                    success: result.success,
+                    resolvedVia: 'config',
+                    stateName: match.name,
+                    stateId: match.id,
+                    error: result.error,
+                };
+            }
+            // Config is set but no matching state — fall through to alias/LLM
+        }
+    }
+    // 3. Match against built-in semantic intent aliases
+    const intentDef = getDefaultIntent(intent);
+    if (intentDef) {
+        const aliasMatch = matchIntentByAliases(states, intentDef);
+        if (aliasMatch) {
+            if (isAlreadyInState(aliasMatch.name)) {
+                return { success: false, resolvedVia: 'alias', stateName: aliasMatch.name, stateId: aliasMatch.id };
+            }
+            const result = await pmProvider.moveTicket(ticketId, aliasMatch.id);
+            return {
+                success: result.success,
+                resolvedVia: 'alias',
+                stateName: aliasMatch.name,
+                stateId: aliasMatch.id,
+                error: result.error,
+            };
+        }
+    }
+    // 4. LLM fallback
+    const llmMatch = await llmResolveState(states, intent);
+    if (llmMatch) {
+        if (isAlreadyInState(llmMatch.name)) {
+            return { success: false, resolvedVia: 'llm', stateName: llmMatch.name, stateId: llmMatch.id };
+        }
+        const result = await pmProvider.moveTicket(ticketId, llmMatch.id);
+        return {
+            success: result.success,
+            resolvedVia: 'llm',
+            stateName: llmMatch.name,
+            stateId: llmMatch.id,
+            error: result.error,
+        };
+    }
+    // 5. No match — skip
+    const warning = `No state match for intent '${intent}', skipping move`;
+    console.warn(warning);
+    return {
+        success: false,
+        resolvedVia: 'skipped',
+        warning,
+    };
+}
+// ---------------------------------------------------------------------------
+// Convenience: moveWithProvider()
+// ---------------------------------------------------------------------------
+/**
+ * High-level convenience function that wraps move() with the existing
+ * TicketProvider + ProviderStorage infrastructure.
+ *
+ * Use this from commands and lifecycle hooks that already have a resolved
+ * TicketProvider and ProviderStorage.
+ */
+export async function moveWithProvider(provider, storage, projectId, ticketId, intent, db, currentState) {
+    const pmProvider = createPMProviderAdapter(provider, storage, projectId);
+    return move(pmProvider, ticketId, intent, { db, currentState });
+}
+//# sourceMappingURL=state-resolution.js.map

package/dist/lib/providers/state-resolution.js.map

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

package/dist/lib/work-lifecycle/post-execution.js

@@ -16,6 +16,7 @@
 import { getWorkColumnSetting, findColumnByName, getReviewGateSetting } from '../pmo/utils.js';
 import { resolveTicketProvider } from '../providers/resolver.js';
 import { tryValidateCommits } from '../execution/commit-validation.js';
+import { moveWithProvider } from '../providers/state-resolution.js';
 /**
  * Check if a completed execution should trigger an automatic state transition.
  *
@@ -82,40 +83,58 @@ export async function handlePostExecutionTransition(context, storage, db) {
             // If we can't validate, allow the transition to proceed.
         }
     }
-    // Determine target column based on review gate mode:
-    // - auto: move to Done (no human review needed)
-    // - post: move to Review (human reviews post-merge)
-    // - required: move to Review (human must approve)
-    const targetColumnType = reviewGate === 'auto' ? 'done' : 'review';
-    const targetColumnName = getWorkColumnSetting(db, targetColumnType);
-    // Get board columns to find the target column
-    const board = await storage.getProjectBoard(ticket.projectId);
-    if (!board) {
-        return { transitioned: false, reviewGate };
-    }
-    const columnNames = board.columns.map(col => col.name);
-    const targetColumn = findColumnByName(columnNames, targetColumnName);
-    if (!targetColumn) {
-        return { transitioned: false, reviewGate };
-    }
-    // Already in target state — skip
-    if (ticket.statusName === targetColumn) {
-        return { transitioned: false, reviewGate };
-    }
+    // Determine semantic intent based on review gate mode:
+    // - auto: intent is 'done' (no human review needed)
+    // - post/required: intent is 'review' (human reviews)
+    const intent = reviewGate === 'auto' ? 'done' : 'review';
     // Resolve the appropriate provider for this ticket
     // Cast to ProviderStorage — at runtime the actual object is SQLiteStorage
     // which implements the full interface. For post-execution, only moveTicket is used.
     const provider = resolveTicketProvider(context.ticketId, ticket.projectId, db, storage, ticket.metadata);
-    // Move ticket via the provider
+    // Use state resolution engine to resolve intent → actual state and move
     const previousState = ticket.statusName;
-    const moveResult = await provider.moveTicket(context.ticketId, targetColumn);
-    if (!moveResult.success) {
+    const resolution = await moveWithProvider(provider, storage, ticket.projectId, context.ticketId, intent, db, ticket.statusName);
+    if (!resolution.success) {
+        // If skipped (no match), fall back to legacy column matching
+        if (resolution.resolvedVia === 'skipped') {
+            const targetColumnType = reviewGate === 'auto' ? 'done' : 'review';
+            const targetColumnName = getWorkColumnSetting(db, targetColumnType);
+            const board = await storage.getProjectBoard(ticket.projectId);
+            if (!board) {
+                return { transitioned: false, reviewGate };
+            }
+            const columnNames = board.columns.map(col => col.name);
+            const targetColumn = findColumnByName(columnNames, targetColumnName);
+            if (!targetColumn || ticket.statusName === targetColumn) {
+                return { transitioned: false, reviewGate };
+            }
+            const moveResult = await provider.moveTicket(context.ticketId, targetColumn);
+            if (!moveResult.success) {
+                return {
+                    transitioned: false,
+                    fromState: previousState,
+                    toState: targetColumn,
+                    provider: moveResult.provider,
+                    providerError: moveResult.error,
+                    validation,
+                    reviewGate,
+                };
+            }
+            return {
+                transitioned: true,
+                fromState: previousState,
+                toState: targetColumn,
+                provider: moveResult.provider,
+                validation,
+                reviewGate,
+            };
+        }
         return {
             transitioned: false,
             fromState: previousState,
-            toState: targetColumn,
-            provider: moveResult.provider,
-            providerError: moveResult.error,
+            toState: resolution.stateName,
+            provider: provider.name,
+            providerError: resolution.error || resolution.warning,
             validation,
             reviewGate,
         };
@@ -123,8 +142,8 @@ export async function handlePostExecutionTransition(context, storage, db) {
     return {
         transitioned: true,
         fromState: previousState,
-        toState: targetColumn,
-        provider: moveResult.provider,
+        toState: resolution.stateName,
+        provider: provider.name,
         validation,
         reviewGate,
     };

package/dist/lib/work-lifecycle/post-execution.js.map

@@ -1 +1 @@
-{"version":3,"file":"post-execution.js","sourceRoot":"","sources":["../../../src/lib/work-lifecycle/post-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAE9F,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAEhE,OAAO,EAAE,kBAAkB,EAA+B,MAAM,mCAAmC,CAAA;AAmDnG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAA6B,EAC7B,OAA+C,EAC/C,EAAqB;IAErB,sDAAsD;IACtD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACxD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACjC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAA;IAChC,CAAC;IAED,gFAAgF;IAChF,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAA;IAChC,CAAC;IAED,yCAAyC;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAA;IAEjE,8DAA8D;IAC9D,qDAAqD;IACrD,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAA;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;QAC5C,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,yEAAyE;IACzE,kDAAkD;IAClD,IAAI,UAA8C,CAAA;IAClD,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,kBAAkB,CAC/B,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,aAAa,CACtB,CAAA;YACD,IAAI,MAAM,EAAE,CAAC;gBACX,UAAU,GAAG,MAAM,CAAA;gBACnB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;oBACnB,OAAO;wBACL,YAAY,EAAE,KAAK;wBACnB,SAAS,EAAE,MAAM,CAAC,UAAU;wBAC5B,UAAU;wBACV,mBAAmB,EAAE,IAAI;wBACzB,UAAU;qBACX,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;YAC5D,yDAAyD;QAC3D,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,gDAAgD;IAChD,oDAAoD;IACpD,kDAAkD;IAClD,MAAM,gBAAgB,GAAG,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAA;IAClE,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAA;IAEnE,8CAA8C;IAC9C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;IAC5C,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACtD,MAAM,YAAY,GAAG,gBAAgB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAA;IACpE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;IAC5C,CAAC;IAED,iCAAiC;IACjC,IAAI,MAAM,CAAC,UAAU,KAAK,YAAY,EAAE,CAAC;QACvC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;IAC5C,CAAC;IAED,mDAAmD;IACnD,0EAA0E;IAC1E,oFAAoF;IACpF,MAAM,QAAQ,GAAG,qBAAqB,CACpC,OAAO,CAAC,QAAQ,EAChB,MAAM,CAAC,SAAS,EAChB,EAAE,EACF,OAA0B,EAC1B,MAAM,CAAC,QAAQ,CAChB,CAAA;IAED,+BAA+B;IAC/B,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAA;IACvC,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;IAE5E,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO;YACL,YAAY,EAAE,KAAK;YACnB,SAAS,EAAE,aAAa;YACxB,OAAO,EAAE,YAAY;YACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,aAAa,EAAE,UAAU,CAAC,KAAK;YAC/B,UAAU;YACV,UAAU;SACX,CAAA;IACH,CAAC;IAED,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,UAAU;QACV,UAAU;KACX,CAAA;AACH,CAAC"}
+{"version":3,"file":"post-execution.js","sourceRoot":"","sources":["../../../src/lib/work-lifecycle/post-execution.ts"],"names":[],"mappings":"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"}