lean-claudient-core 0.1.0

package/dist/automation/jobQueue.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Job Queue for Background Tasks
+ * In-memory queue for pending jobs with execution logging
+ * Phase 8C Task 7
+ */
+/**
+ * Queued job
+ */
+export interface QueuedJob {
+    id: string;
+    name: string;
+    priority: 'high' | 'normal' | 'low';
+    payload?: Record<string, any>;
+    fn: () => Promise<void> | void;
+    createdAt: number;
+    executedAt?: number;
+    status: 'pending' | 'executing' | 'completed' | 'failed';
+    error?: string;
+    retryCount: number;
+    maxRetries: number;
+}
+/**
+ * Job queue statistics
+ */
+export interface QueueStats {
+    total: number;
+    pending: number;
+    executing: number;
+    completed: number;
+    failed: number;
+    avgExecutionTime: number;
+}
+/**
+ * Job Queue: Manages pending job execution
+ */
+export declare class JobQueue {
+    private queue;
+    private executingJobs;
+    private completedJobs;
+    private failedJobs;
+    private auditLogger;
+    private executionTimes;
+    constructor();
+    /**
+     * Enqueue a new job
+     */
+    enqueue(name: string, fn: () => Promise<void> | void, options?: {
+        priority?: 'high' | 'normal' | 'low';
+        payload?: Record<string, any>;
+        maxRetries?: number;
+    }): string;
+    /**
+     * Dequeue and execute the next job
+     */
+    dequeue(): Promise<string | null>;
+    /**
+     * Get queue size by status
+     */
+    getQueueSize(): {
+        total: number;
+        pending: number;
+        executing: number;
+    };
+    /**
+     * Get queue statistics
+     */
+    getStats(): QueueStats;
+    /**
+     * Get job by ID
+     */
+    getJob(jobId: string): QueuedJob | undefined;
+    /**
+     * Clear all completed jobs
+     */
+    clearCompleted(): number;
+    /**
+     * Clear all failed jobs
+     */
+    clearFailed(): number;
+    /**
+     * Cancel a pending job
+     */
+    cancel(jobId: string): boolean;
+    /**
+     * Is job executing
+     */
+    isExecuting(jobId: string): boolean;
+    /**
+     * Get all completed jobs
+     */
+    getCompleted(): QueuedJob[];
+    /**
+     * Get all failed jobs
+     */
+    getFailed(): QueuedJob[];
+}
+export default JobQueue;
+//# sourceMappingURL=jobQueue.d.ts.map

package/dist/automation/jobQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobQueue.d.ts","sourceRoot":"","sources":["../../src/automation/jobQueue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAAgB;;IAMtC;;OAEG;IACH,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAC9B,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,MAAM;IA0BT;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAwFvC;;OAEG;IACH,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAQrE;;OAEG;IACH,QAAQ,IAAI,UAAU;IAgBtB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI5C;;OAEG;IACH,cAAc,IAAI,MAAM;IAMxB;;OAEG;IACH,WAAW,IAAI,MAAM;IAMrB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAgB9B;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACH,YAAY,IAAI,SAAS,EAAE;IAI3B;;OAEG;IACH,SAAS,IAAI,SAAS,EAAE;CAGzB;AAED,eAAe,QAAQ,CAAC"}

package/dist/automation/jobQueue.js

@@ -0,0 +1,207 @@
+/**
+ * Job Queue for Background Tasks
+ * In-memory queue for pending jobs with execution logging
+ * Phase 8C Task 7
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { AuditLogger } from '../core/auditLogger.js';
+/**
+ * Job Queue: Manages pending job execution
+ */
+export class JobQueue {
+    constructor() {
+        this.queue = new Map();
+        this.executingJobs = new Set();
+        this.completedJobs = new Map();
+        this.failedJobs = new Map();
+        this.executionTimes = [];
+        this.auditLogger = new AuditLogger();
+    }
+    /**
+     * Enqueue a new job
+     */
+    enqueue(name, fn, options) {
+        const jobId = uuidv4();
+        const job = {
+            id: jobId,
+            name,
+            priority: options?.priority || 'normal',
+            payload: options?.payload,
+            fn,
+            createdAt: Date.now(),
+            status: 'pending',
+            retryCount: 0,
+            maxRetries: options?.maxRetries || 3,
+        };
+        this.queue.set(jobId, job);
+        this.auditLogger.log({
+            event: 'job:enqueued',
+            jobId,
+            name,
+            priority: job.priority,
+        });
+        return jobId;
+    }
+    /**
+     * Dequeue and execute the next job
+     */
+    async dequeue() {
+        // Find next job by priority
+        let nextJobId = null;
+        let nextPriority = null;
+        for (const [id, job] of this.queue) {
+            if (job.status !== 'pending')
+                continue;
+            const priority = job.priority;
+            if (!nextPriority || priority === 'high' || (priority === 'normal' && nextPriority === 'low')) {
+                nextJobId = id;
+                nextPriority = priority;
+            }
+        }
+        if (!nextJobId)
+            return null;
+        const job = this.queue.get(nextJobId);
+        job.status = 'executing';
+        this.executingJobs.add(nextJobId);
+        const startTime = Date.now();
+        try {
+            this.auditLogger.log({
+                event: 'job:executing',
+                jobId: nextJobId,
+                name: job.name,
+            });
+            await Promise.resolve(job.fn());
+            const executionTime = Date.now() - startTime;
+            this.executionTimes.push(executionTime);
+            // Trim execution times to last 100
+            if (this.executionTimes.length > 100) {
+                this.executionTimes.shift();
+            }
+            job.status = 'completed';
+            job.executedAt = Date.now();
+            this.executingJobs.delete(nextJobId);
+            this.completedJobs.set(nextJobId, job);
+            this.auditLogger.log({
+                event: 'job:completed',
+                jobId: nextJobId,
+                name: job.name,
+                executionTime,
+            });
+            // Remove from queue
+            this.queue.delete(nextJobId);
+            return nextJobId;
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            job.retryCount++;
+            if (job.retryCount < job.maxRetries) {
+                job.status = 'pending';
+                this.auditLogger.log({
+                    event: 'job:retry',
+                    jobId: nextJobId,
+                    name: job.name,
+                    retryCount: job.retryCount,
+                    error: errorMsg,
+                });
+            }
+            else {
+                job.status = 'failed';
+                job.error = errorMsg;
+                this.executingJobs.delete(nextJobId);
+                this.failedJobs.set(nextJobId, job);
+                this.queue.delete(nextJobId);
+                this.auditLogger.log({
+                    event: 'job:failed',
+                    jobId: nextJobId,
+                    name: job.name,
+                    retryCount: job.retryCount,
+                    error: errorMsg,
+                });
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get queue size by status
+     */
+    getQueueSize() {
+        const pending = Array.from(this.queue.values()).filter((j) => j.status === 'pending').length;
+        const executing = this.executingJobs.size;
+        const total = this.queue.size;
+        return { total, pending, executing };
+    }
+    /**
+     * Get queue statistics
+     */
+    getStats() {
+        const avgExecutionTime = this.executionTimes.length > 0
+            ? this.executionTimes.reduce((a, b) => a + b, 0) / this.executionTimes.length
+            : 0;
+        return {
+            total: this.queue.size + this.completedJobs.size + this.failedJobs.size,
+            pending: Array.from(this.queue.values()).filter((j) => j.status === 'pending').length,
+            executing: this.executingJobs.size,
+            completed: this.completedJobs.size,
+            failed: this.failedJobs.size,
+            avgExecutionTime,
+        };
+    }
+    /**
+     * Get job by ID
+     */
+    getJob(jobId) {
+        return this.queue.get(jobId) || this.completedJobs.get(jobId) || this.failedJobs.get(jobId);
+    }
+    /**
+     * Clear all completed jobs
+     */
+    clearCompleted() {
+        const count = this.completedJobs.size;
+        this.completedJobs.clear();
+        return count;
+    }
+    /**
+     * Clear all failed jobs
+     */
+    clearFailed() {
+        const count = this.failedJobs.size;
+        this.failedJobs.clear();
+        return count;
+    }
+    /**
+     * Cancel a pending job
+     */
+    cancel(jobId) {
+        const job = this.queue.get(jobId);
+        if (!job || job.status !== 'pending') {
+            return false;
+        }
+        this.queue.delete(jobId);
+        this.auditLogger.log({
+            event: 'job:cancelled',
+            jobId,
+            name: job.name,
+        });
+        return true;
+    }
+    /**
+     * Is job executing
+     */
+    isExecuting(jobId) {
+        return this.executingJobs.has(jobId);
+    }
+    /**
+     * Get all completed jobs
+     */
+    getCompleted() {
+        return Array.from(this.completedJobs.values());
+    }
+    /**
+     * Get all failed jobs
+     */
+    getFailed() {
+        return Array.from(this.failedJobs.values());
+    }
+}
+export default JobQueue;
+//# sourceMappingURL=jobQueue.js.map

package/dist/automation/jobQueue.js.map

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

package/dist/automation/leadQualification.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Lead Qualification Workflow
+ * Automated stage transitions (cold → warm → hot → sales-ready)
+ * Composio integration for CRM export with human approval gate
+ */
+import { QualificationStage, EnrichedLead, RevenueProjection, QualificationResult, StageTransition, stageDefinitions } from './qualificationRules.js';
+/**
+ * Lead Qualifier: Main qualification engine
+ */
+export declare class LeadQualifier {
+    private auditLogger;
+    private composioClient?;
+    private transitions;
+    constructor(composioApiKey?: string);
+    /**
+     * Qualify a single lead
+     */
+    qualifyLead(enrichedLead: EnrichedLead, projection?: RevenueProjection): QualificationResult;
+    /**
+     * Batch qualify multiple leads
+     */
+    batchQualify(enrichedLeads: EnrichedLead[], projections?: Map<string, RevenueProjection>): QualificationResult[];
+    /**
+     * Transition a lead to a new stage with validation
+     */
+    transitionLead(leadId: string, fromStage: QualificationStage, toStage: QualificationStage, lead: EnrichedLead, reason?: string): Promise<{
+        success: boolean;
+        transition?: StageTransition;
+        error?: string;
+    }>;
+    /**
+     * Queue Composio actions for a lead (no execution, human approval required)
+     */
+    private queueComposioActions;
+    /**
+     * Get transition history for a lead
+     */
+    getTransitionHistory(leadId: string): StageTransition | undefined;
+    /**
+     * Get all transition records
+     */
+    getAllTransitions(): StageTransition[];
+    /**
+     * Get stage definition metadata
+     */
+    getStageDefinition(stage: QualificationStage): typeof stageDefinitions[QualificationStage];
+    /**
+     * Get summary of qualification stats
+     */
+    getQualificationStats(results: QualificationResult[]): {
+        total: number;
+        byStageCounts: Record<QualificationStage, number>;
+        averageConfidence: number;
+        withBlockers: number;
+    };
+}
+export declare function getLeadQualifier(composioApiKey?: string): LeadQualifier;
+export declare function resetLeadQualifier(): void;
+export default LeadQualifier;
+//# sourceMappingURL=leadQualification.d.ts.map

package/dist/automation/leadQualification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leadQualification.d.ts","sourceRoot":"","sources":["../../src/automation/leadQualification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EAQf,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,WAAW,CAA2C;gBAElD,cAAc,CAAC,EAAE,MAAM;IAWnC;;OAEG;IACH,WAAW,CACT,YAAY,EAAE,YAAY,EAC1B,UAAU,CAAC,EAAE,iBAAiB,GAC7B,mBAAmB;IA+BtB;;OAEG;IACH,YAAY,CACV,aAAa,EAAE,YAAY,EAAE,EAC7B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC3C,mBAAmB,EAAE;IAOxB;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,eAAe,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAgE9E;;OAEG;YACW,oBAAoB;IA0BlC;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIjE;;OAEG;IACH,iBAAiB,IAAI,eAAe,EAAE;IAItC;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,gBAAgB,CAAC,kBAAkB,CAAC;IAI1F;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG;QACrD,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QAClD,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB;CA0BF;AAOD,wBAAgB,gBAAgB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,aAAa,CAKvE;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,eAAe,aAAa,CAAC"}

package/dist/automation/leadQualification.js

@@ -0,0 +1,204 @@
+/**
+ * Lead Qualification Workflow
+ * Automated stage transitions (cold → warm → hot → sales-ready)
+ * Composio integration for CRM export with human approval gate
+ */
+import { AuditLogger } from '../core/auditLogger.js';
+import ComposioClient from './composioClient.js';
+import { evaluateStage, calculateConfidence, getNextAction, identifyBlockers, getComposioActionsForTransition, isValidTransition, getTransitionReason, stageDefinitions, } from './qualificationRules.js';
+/**
+ * Lead Qualifier: Main qualification engine
+ */
+export class LeadQualifier {
+    constructor(composioApiKey) {
+        this.transitions = new Map();
+        this.auditLogger = new AuditLogger();
+        if (composioApiKey) {
+            this.composioClient = new ComposioClient({
+                apiKey: composioApiKey,
+                baseUrl: 'https://api.composio.dev/api/v1',
+            });
+        }
+    }
+    /**
+     * Qualify a single lead
+     */
+    qualifyLead(enrichedLead, projection) {
+        const blockers = identifyBlockers(enrichedLead, projection);
+        const stage = evaluateStage(enrichedLead, projection, blockers);
+        const confidence = calculateConfidence(enrichedLead, stage);
+        const nextAction = getNextAction(stage);
+        const result = {
+            leadId: enrichedLead.id,
+            stage,
+            confidence,
+            nextAction,
+            signals: enrichedLead.signals?.map((s) => s.type) || [],
+            blockers: blockers.length > 0 ? blockers : undefined,
+        };
+        // Log qualification
+        this.auditLogger.log({
+            event: 'lead:qualified',
+            leadId: enrichedLead.id,
+            stage,
+            confidence,
+            signalCount: enrichedLead.signalCount,
+            quality: enrichedLead.quality,
+            competitorThreat: enrichedLead.competitorThreat,
+            blockers,
+            nextAction,
+        });
+        return result;
+    }
+    /**
+     * Batch qualify multiple leads
+     */
+    batchQualify(enrichedLeads, projections) {
+        return enrichedLeads.map((lead) => {
+            const projection = projections?.get(lead.id);
+            return this.qualifyLead(lead, projection);
+        });
+    }
+    /**
+     * Transition a lead to a new stage with validation
+     */
+    async transitionLead(leadId, fromStage, toStage, lead, reason) {
+        // Validate transition
+        if (!isValidTransition(fromStage, toStage)) {
+            const error = `Invalid transition from ${fromStage} to ${toStage}`;
+            this.auditLogger.log({
+                event: 'lead:transition-failed',
+                leadId,
+                fromStage,
+                toStage,
+                reason: error,
+            });
+            return { success: false, error };
+        }
+        // Create transition record
+        const transition = {
+            leadId,
+            fromStage,
+            toStage,
+            timestamp: new Date().toISOString(),
+            reason: reason || getTransitionReason(lead, fromStage, toStage),
+            composioActionsQueued: [],
+        };
+        try {
+            // Queue Composio actions if transitioning to hot or sales-ready
+            if (toStage === 'hot' || toStage === 'sales-ready') {
+                const actions = getComposioActionsForTransition(fromStage, toStage, lead);
+                transition.composioActionsQueued = actions;
+                if (this.composioClient && toStage === 'sales-ready') {
+                    // Queue CRM export (no autonomous execution - human gate)
+                    await this.queueComposioActions(leadId, actions, lead);
+                }
+            }
+            // Store transition
+            this.transitions.set(leadId, transition);
+            // Log transition
+            this.auditLogger.log({
+                event: 'lead:transitioned',
+                leadId,
+                fromStage,
+                toStage,
+                reason: transition.reason,
+                composioActionsQueued: transition.composioActionsQueued,
+                timestamp: transition.timestamp,
+            });
+            return { success: true, transition };
+        }
+        catch (error) {
+            const errorMsg = error.message;
+            this.auditLogger.log({
+                event: 'lead:transition-error',
+                leadId,
+                fromStage,
+                toStage,
+                error: errorMsg,
+            });
+            return { success: false, error: errorMsg };
+        }
+    }
+    /**
+     * Queue Composio actions for a lead (no execution, human approval required)
+     */
+    async queueComposioActions(leadId, actions, lead) {
+        if (!this.composioClient) {
+            throw new Error('Composio client not configured');
+        }
+        for (const action of actions) {
+            if (action.startsWith('composio:')) {
+                const actionType = action.replace('composio:', '');
+                this.auditLogger.log({
+                    event: 'composio:action-queued',
+                    leadId,
+                    actionType,
+                    leadName: lead.name,
+                    leadEmail: lead.email,
+                    status: 'pending-approval',
+                    timestamp: new Date().toISOString(),
+                });
+            }
+        }
+    }
+    /**
+     * Get transition history for a lead
+     */
+    getTransitionHistory(leadId) {
+        return this.transitions.get(leadId);
+    }
+    /**
+     * Get all transition records
+     */
+    getAllTransitions() {
+        return Array.from(this.transitions.values());
+    }
+    /**
+     * Get stage definition metadata
+     */
+    getStageDefinition(stage) {
+        return stageDefinitions[stage];
+    }
+    /**
+     * Get summary of qualification stats
+     */
+    getQualificationStats(results) {
+        const byStageCounts = {
+            cold: 0,
+            warm: 0,
+            hot: 0,
+            'sales-ready': 0,
+        };
+        let totalConfidence = 0;
+        let withBlockers = 0;
+        results.forEach((result) => {
+            byStageCounts[result.stage]++;
+            totalConfidence += result.confidence;
+            if (result.blockers && result.blockers.length > 0) {
+                withBlockers++;
+            }
+        });
+        return {
+            total: results.length,
+            byStageCounts,
+            averageConfidence: results.length > 0 ? totalConfidence / results.length : 0,
+            withBlockers,
+        };
+    }
+}
+/**
+ * Export singleton instance
+ */
+let qualifierInstance = null;
+export function getLeadQualifier(composioApiKey) {
+    if (!qualifierInstance) {
+        qualifierInstance = new LeadQualifier(composioApiKey);
+    }
+    return qualifierInstance;
+}
+export function resetLeadQualifier() {
+    qualifierInstance = null;
+}
+export default LeadQualifier;
+//# sourceMappingURL=leadQualification.js.map

package/dist/automation/leadQualification.js.map

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