crewly 1.13.0 → 1.14.0

package/dist/cli/backend/src/services/onboarding/content-approval.service.js

@@ -0,0 +1,256 @@
+/**
+ * Content Approval Service for Marketing Team templates.
+ *
+ * Manages the approval workflow where marketing agents submit content
+ * for human review. Content can be approved/rejected via:
+ *   - Slack text replies ("approve" / "reject")
+ *   - REST API endpoints
+ *
+ * This service is designed for the marketing team use case and is
+ * separate from the F27 ToolApprovalQueue (which handles tool execution).
+ *
+ * @module content-approval-service
+ */
+import { randomUUID } from 'crypto';
+import { CONTENT_APPROVAL_TTL_MS, MAX_PENDING_APPROVALS, } from './content-approval.types.js';
+// =============================================================================
+// Service
+// =============================================================================
+/**
+ * Service managing content approval requests for marketing teams.
+ *
+ * Follows singleton pattern. Stores approvals in memory with optional
+ * Slack message tracking for interactive approval via text replies.
+ */
+export class ContentApprovalService {
+    static instance = null;
+    approvals = new Map();
+    /**
+     * Get or create the singleton instance.
+     *
+     * @returns Singleton instance
+     */
+    static getInstance() {
+        if (!ContentApprovalService.instance) {
+            ContentApprovalService.instance = new ContentApprovalService();
+        }
+        return ContentApprovalService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        ContentApprovalService.instance = null;
+    }
+    // ---------------------------------------------------------------------------
+    // Submission
+    // ---------------------------------------------------------------------------
+    /**
+     * Submit content for approval.
+     *
+     * @param options - Content submission details
+     * @returns Created approval request
+     * @throws Error if team has too many pending approvals
+     */
+    submit(options) {
+        // Enforce max pending limit
+        this.expireOldApprovals();
+        const teamPending = this.getPendingByTeam(options.teamId);
+        if (teamPending.length >= MAX_PENDING_APPROVALS) {
+            throw new Error(`Team ${options.teamId} has ${teamPending.length} pending approvals (max: ${MAX_PENDING_APPROVALS}). Resolve some before submitting more.`);
+        }
+        const request = {
+            id: randomUUID(),
+            teamId: options.teamId,
+            submittedBy: options.submittedBy,
+            platform: options.platform,
+            contentType: options.contentType,
+            content: options.content,
+            hashtags: options.hashtags,
+            visualDirection: options.visualDirection,
+            scheduledTime: options.scheduledTime,
+            status: 'pending',
+            submittedAt: new Date().toISOString(),
+        };
+        this.approvals.set(request.id, request);
+        return request;
+    }
+    // ---------------------------------------------------------------------------
+    // Resolution
+    // ---------------------------------------------------------------------------
+    /**
+     * Approve a content request.
+     *
+     * @param approvalId - ID of the approval request
+     * @param resolvedBy - Who approved (user ID or identifier)
+     * @param feedback - Optional feedback or notes
+     * @returns Updated approval request or null if not found
+     */
+    approve(approvalId, resolvedBy, feedback) {
+        return this.resolve({ approvalId, status: 'approved', resolvedBy, feedback });
+    }
+    /**
+     * Reject a content request.
+     *
+     * @param approvalId - ID of the approval request
+     * @param resolvedBy - Who rejected
+     * @param feedback - Reason for rejection or edit instructions
+     * @returns Updated approval request or null if not found
+     */
+    reject(approvalId, resolvedBy, feedback) {
+        return this.resolve({ approvalId, status: 'rejected', resolvedBy, feedback });
+    }
+    /**
+     * Resolve an approval request (approve or reject).
+     *
+     * @param resolution - Resolution details
+     * @returns Updated request or null
+     */
+    resolve(resolution) {
+        const request = this.approvals.get(resolution.approvalId);
+        if (!request)
+            return null;
+        if (request.status !== 'pending')
+            return request; // Already resolved
+        request.status = resolution.status;
+        request.resolvedAt = new Date().toISOString();
+        request.resolvedBy = resolution.resolvedBy;
+        request.feedback = resolution.feedback;
+        this.approvals.set(request.id, request);
+        return request;
+    }
+    // ---------------------------------------------------------------------------
+    // Queries
+    // ---------------------------------------------------------------------------
+    /**
+     * Get a specific approval request.
+     *
+     * @param approvalId - Approval ID
+     * @returns The request or null
+     */
+    get(approvalId) {
+        return this.approvals.get(approvalId) ?? null;
+    }
+    /**
+     * Get all pending approvals for a team.
+     *
+     * @param teamId - Team ID
+     * @returns Array of pending approval requests
+     */
+    getPendingByTeam(teamId) {
+        this.expireOldApprovals();
+        return Array.from(this.approvals.values()).filter(r => r.teamId === teamId && r.status === 'pending');
+    }
+    /**
+     * Get all approvals for a team (all statuses).
+     *
+     * @param teamId - Team ID
+     * @returns Array of all approval requests
+     */
+    getAllByTeam(teamId) {
+        return Array.from(this.approvals.values()).filter(r => r.teamId === teamId);
+    }
+    /**
+     * Get approval by Slack message timestamp (for Slack reply-based approval).
+     *
+     * @param channelId - Slack channel ID
+     * @param messageTs - Slack message timestamp
+     * @returns Matching approval request or null
+     */
+    getBySlackMessage(channelId, messageTs) {
+        for (const request of this.approvals.values()) {
+            if (request.slackChannelId === channelId && request.slackMessageTs === messageTs) {
+                return request;
+            }
+        }
+        return null;
+    }
+    /**
+     * Link a Slack message to an approval request (for tracking replies).
+     *
+     * @param approvalId - Approval ID
+     * @param channelId - Slack channel where the approval message was posted
+     * @param messageTs - Slack message timestamp
+     * @returns Updated request or null
+     */
+    linkSlackMessage(approvalId, channelId, messageTs) {
+        const request = this.approvals.get(approvalId);
+        if (!request)
+            return null;
+        request.slackChannelId = channelId;
+        request.slackMessageTs = messageTs;
+        this.approvals.set(request.id, request);
+        return request;
+    }
+    /**
+     * Get counts by status for a team.
+     *
+     * @param teamId - Team ID
+     * @returns Object with status counts
+     */
+    getStats(teamId) {
+        const all = this.getAllByTeam(teamId);
+        const stats = {
+            pending: 0,
+            approved: 0,
+            rejected: 0,
+            expired: 0,
+        };
+        for (const r of all) {
+            stats[r.status] = (stats[r.status] || 0) + 1;
+        }
+        return stats;
+    }
+    // ---------------------------------------------------------------------------
+    // Formatting
+    // ---------------------------------------------------------------------------
+    /**
+     * Format an approval request as a Slack message (plain text for MVP).
+     *
+     * @param request - The approval request to format
+     * @returns Formatted message string ready for Slack
+     */
+    formatForSlack(request) {
+        const lines = [
+            `*Content Approval Request* (ID: \`${request.id.slice(0, 8)}\`)`,
+            '',
+            `*Platform:* ${request.platform}`,
+            `*Type:* ${request.contentType}`,
+            `*Submitted by:* ${request.submittedBy}`,
+            '',
+            '---',
+            request.content,
+            '---',
+        ];
+        if (request.hashtags?.length) {
+            lines.push(`*Hashtags:* ${request.hashtags.join(' ')}`);
+        }
+        if (request.visualDirection) {
+            lines.push(`*Visual Direction:* ${request.visualDirection}`);
+        }
+        if (request.scheduledTime) {
+            lines.push(`*Scheduled:* ${request.scheduledTime}`);
+        }
+        lines.push('');
+        lines.push('Reply with *approve* or *reject [reason]* to this message.');
+        return lines.join('\n');
+    }
+    // ---------------------------------------------------------------------------
+    // Private Helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Expire old pending approvals past the TTL.
+     */
+    expireOldApprovals() {
+        const now = Date.now();
+        for (const [id, request] of this.approvals.entries()) {
+            if (request.status === 'pending' &&
+                now - new Date(request.submittedAt).getTime() > CONTENT_APPROVAL_TTL_MS) {
+                request.status = 'expired';
+                request.resolvedAt = new Date().toISOString();
+                this.approvals.set(id, request);
+            }
+        }
+    }
+}
+//# sourceMappingURL=content-approval.service.js.map

package/dist/cli/backend/src/services/onboarding/content-approval.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-approval.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/onboarding/content-approval.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAIL,uBAAuB,EACvB,qBAAqB,GAEtB,MAAM,6BAA6B,CAAC;AAErC,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IACzB,MAAM,CAAC,QAAQ,GAAkC,IAAI,CAAC;IACtD,SAAS,GAAwC,IAAI,GAAG,EAAE,CAAC;IAEnE;;;;OAIG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,CAAC;YACrC,sBAAsB,CAAC,QAAQ,GAAG,IAAI,sBAAsB,EAAE,CAAC;QACjE,CAAC;QACD,OAAO,sBAAsB,CAAC,QAAQ,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QAClB,sBAAsB,CAAC,QAAQ,GAAG,IAAI,CAAC;IACzC,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E;;;;;;OAMG;IACH,MAAM,CAAC,OAAiC;QACtC,4BAA4B;QAC5B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,WAAW,CAAC,MAAM,IAAI,qBAAqB,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,QAAQ,OAAO,CAAC,MAAM,QAAQ,WAAW,CAAC,MAAM,4BAA4B,qBAAqB,yCAAyC,CAC3I,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAA2B;YACtC,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,MAAM,EAAE,SAAS;YACjB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E;;;;;;;OAOG;IACH,OAAO,CACL,UAAkB,EAClB,UAAkB,EAClB,QAAiB;QAEjB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CACJ,UAAkB,EAClB,UAAkB,EAClB,QAAiB;QAEjB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,UAA8B;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,CAAC,mBAAmB;QAErE,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QACnC,OAAO,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QAC3C,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QAEvC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,8EAA8E;IAC9E,UAAU;IACV,8EAA8E;IAE9E;;;;;OAKG;IACH,GAAG,CAAC,UAAkB;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,MAAc;QAC7B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC/C,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CACnD,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,MAAc;QACzB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC/C,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CACzB,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB,CAAC,SAAiB,EAAE,SAAiB;QACpD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;gBACjF,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CACd,UAAkB,EAClB,SAAiB,EACjB,SAAiB;QAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;QACnC,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,MAAc;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,KAAK,GAA0C;YACnD,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;SACX,CAAC;QAEF,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E;;;;;OAKG;IACH,cAAc,CAAC,OAA+B;QAC5C,MAAM,KAAK,GAAG;YACZ,qCAAqC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK;YAChE,EAAE;YACF,eAAe,OAAO,CAAC,QAAQ,EAAE;YACjC,WAAW,OAAO,CAAC,WAAW,EAAE;YAChC,mBAAmB,OAAO,CAAC,WAAW,EAAE;YACxC,EAAE;YACF,KAAK;YACL,OAAO,CAAC,OAAO;YACf,KAAK;SACN,CAAC;QAEF,IAAI,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,uBAAuB,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAEzE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAE9E;;OAEG;IACK,kBAAkB;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YACrD,IACE,OAAO,CAAC,MAAM,KAAK,SAAS;gBAC5B,GAAG,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,GAAG,uBAAuB,EACvE,CAAC;gBACD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;gBAC3B,OAAO,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBAC9C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC"}

package/dist/cli/backend/src/services/onboarding/content-approval.types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Type definitions for the Content Approval workflow.
+ *
+ * Used by marketing team agents to submit content for human review
+ * via Slack. The approval flow is: draft → submitted → approved/rejected.
+ *
+ * @module content-approval-types
+ */
+/** Approval status for a content item. */
+export type ContentApprovalStatus = 'pending' | 'approved' | 'rejected' | 'expired';
+/** A content item submitted for approval. */
+export interface ContentApprovalRequest {
+    /** Unique approval request ID */
+    id: string;
+    /** Team ID this approval belongs to */
+    teamId: string;
+    /** Agent session that submitted the content */
+    submittedBy: string;
+    /** Platform the content is for */
+    platform: string;
+    /** Content type (post, article, newsletter, etc.) */
+    contentType: string;
+    /** The actual content text */
+    content: string;
+    /** Suggested hashtags */
+    hashtags?: string[];
+    /** Suggested visual direction */
+    visualDirection?: string;
+    /** Suggested posting time */
+    scheduledTime?: string;
+    /** Current approval status */
+    status: ContentApprovalStatus;
+    /** Submission timestamp */
+    submittedAt: string;
+    /** Resolution timestamp */
+    resolvedAt?: string;
+    /** Who resolved (user ID or 'auto') */
+    resolvedBy?: string;
+    /** Rejection reason or edit notes */
+    feedback?: string;
+    /** Slack message timestamp for the approval message */
+    slackMessageTs?: string;
+    /** Slack channel ID where approval was posted */
+    slackChannelId?: string;
+}
+/** Options for submitting content for approval. */
+export interface SubmitForApprovalOptions {
+    /** Team ID */
+    teamId: string;
+    /** Agent session name */
+    submittedBy: string;
+    /** Target platform */
+    platform: string;
+    /** Content type */
+    contentType: string;
+    /** Content text */
+    content: string;
+    /** Optional hashtags */
+    hashtags?: string[];
+    /** Optional visual direction */
+    visualDirection?: string;
+    /** Optional scheduled time */
+    scheduledTime?: string;
+}
+/** Result of resolving an approval request. */
+export interface ApprovalResolution {
+    /** Approval ID that was resolved */
+    approvalId: string;
+    /** New status */
+    status: 'approved' | 'rejected';
+    /** Who resolved */
+    resolvedBy: string;
+    /** Optional feedback/notes */
+    feedback?: string;
+}
+/** How long an approval request stays active before expiring (ms). */
+export declare const CONTENT_APPROVAL_TTL_MS: number;
+/** Maximum pending approvals per team. */
+export declare const MAX_PENDING_APPROVALS = 50;
+//# sourceMappingURL=content-approval.types.d.ts.map

package/dist/cli/backend/src/services/onboarding/content-approval.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-approval.types.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/onboarding/content-approval.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,0CAA0C;AAC1C,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,UAAU,GACV,UAAU,GACV,SAAS,CAAC;AAEd,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,mDAAmD;AACnD,MAAM,WAAW,wBAAwB;IACvC,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gCAAgC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAChC,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,QAAsB,CAAC;AAE3D,0CAA0C;AAC1C,eAAO,MAAM,qBAAqB,KAAK,CAAC"}

package/dist/cli/backend/src/services/onboarding/content-approval.types.js

@@ -0,0 +1,16 @@
+/**
+ * Type definitions for the Content Approval workflow.
+ *
+ * Used by marketing team agents to submit content for human review
+ * via Slack. The approval flow is: draft → submitted → approved/rejected.
+ *
+ * @module content-approval-types
+ */
+// =============================================================================
+// Constants
+// =============================================================================
+/** How long an approval request stays active before expiring (ms). */
+export const CONTENT_APPROVAL_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+/** Maximum pending approvals per team. */
+export const MAX_PENDING_APPROVALS = 50;
+//# sourceMappingURL=content-approval.types.js.map

package/dist/cli/backend/src/services/onboarding/content-approval.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-approval.types.js","sourceRoot":"","sources":["../../../../../../backend/src/services/onboarding/content-approval.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiFH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,sEAAsE;AACtE,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW;AAEvE,0CAA0C;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC"}

package/dist/cli/backend/src/services/orc/orc-delivery-enforcer.service.d.ts

@@ -0,0 +1,150 @@
+/**
+ * OrcDeliveryEnforcerService
+ *
+ * **Why this exists** (2026-05-23 incident, the "affiliate research" case):
+ *
+ * Steve asked the team to research affiliate programs at 12:59 PM. ORC
+ * acknowledged at 1:00 PM with "Atlas + Sage/Kai 派出去了, ETA 30-40min".
+ * Sage finished Phase 1 at 1:15, Kai finished Phase 2 at 1:28 — but
+ * Steve never saw the result. ORC's terminal logs claimed the pipeline
+ * was "closed" and the result "already routed to Steve at Slack thread
+ * ...", but there were zero `/api/slack/send` calls all day. ORC's
+ * internal mental model believed delivery happened; the actual skill
+ * call didn't.
+ *
+ * Root cause: ORC's prompt has a HARD pre-yield gate ("any `[CHAT:slack-…]`
+ * MUST have a `reply-slack` before yielding"). But for a long-running
+ * delegation, the user-visible deliverable comes from the *agent* via
+ * `[DONE]`-style status reports — long AFTER ORC's initial ack. ORC
+ * reads the agent's `[DONE]` as internal team chatter, narrates "pipeline
+ * closed", and yields without delivering to Steve. The prompt rule
+ * doesn't catch this case because the prompt looks for `[CHAT:slack-…]`
+ * (user-originating) not `[DONE]` (agent-originating).
+ *
+ * **What this service does:**
+ *
+ *   1. When a worker agent posts `[DONE]` / `[COMPLETED]` to a
+ *      slack-prefixed conversation (chat.controller's "Agent status
+ *      routed to orchestrator" path), call {@link markPendingDelivery}.
+ *      The service records a pending delivery with `dueBy = now + 3 min`.
+ *
+ *   2. When ORC successfully posts via `/api/slack/send` to the same
+ *      thread, call {@link markDelivered}. Pending delivery cleared.
+ *
+ *   3. A timer scans every 30 s. For any pending delivery whose `dueBy`
+ *      has passed AND ORC hasn't replied, enqueue a `[DELIVER_REQUIRED]`
+ *      system message to ORC via MessageQueueService. ORC's prompt
+ *      treats `[DELIVER_REQUIRED]` exactly like `[CHAT:slack-…]` for
+ *      the pre-yield gate.
+ *
+ *   4. Exponential backoff between reminders for the same thread, to
+ *      avoid spamming ORC if it's genuinely stuck or rate-limited.
+ *      First reminder at 3 min, then 10 min, then 30 min, then stop.
+ *
+ * Fire-and-forget on all writes — a fault in the enforcer MUST NOT
+ * block chat or slack flow.
+ *
+ * @module services/orc/orc-delivery-enforcer.service
+ */
+/**
+ * Identifier for a slack thread — channelId + threadTs (or empty if
+ * not a slack conversation, in which case we skip tracking entirely).
+ */
+export interface SlackThreadKey {
+    channelId: string;
+    threadTs: string;
+}
+export interface PendingDelivery {
+    key: SlackThreadKey;
+    /** The full conversation id, e.g. `slack-D0AC…-1779…`. Stored for the reminder text. */
+    conversationId: string;
+    /** Session name of the agent that posted [DONE]. */
+    agentSender: string;
+    /** First ~200 chars of the agent's [DONE] message — surfaces in the reminder. */
+    deliverableSummary: string;
+    /** When the agent posted (ms). */
+    doneAt: number;
+    /** Number of reminders fired so far (drives REMINDER_CADENCE_MS index). */
+    remindersFired: number;
+    /** Next eligible reminder time (ms). */
+    nextDueAt: number;
+}
+/**
+ * Function the enforcer uses to send a `[DELIVER_REQUIRED]` message to
+ * ORC. Injected at construction time so tests can stub it and so the
+ * service has no hard dep on MessageQueueService.
+ */
+export type DeliveryReminderSink = (params: {
+    conversationId: string;
+    text: string;
+}) => void;
+export interface OrcDeliveryEnforcerOptions {
+    /** Wired from index.ts to enqueue the reminder via MessageQueueService. */
+    reminderSink: DeliveryReminderSink;
+    /** Scan interval. Default 30 s. */
+    tickIntervalMs?: number;
+}
+/**
+ * Singleton scope — there's one ORC, one queue of pending deliveries.
+ */
+export declare class OrcDeliveryEnforcerService {
+    private static instance;
+    private readonly logger;
+    private readonly reminderSink;
+    private readonly tickIntervalMs;
+    private timer;
+    /** key = `${channelId}::${threadTs}` */
+    private readonly pending;
+    constructor(opts: OrcDeliveryEnforcerOptions);
+    static getInstance(): OrcDeliveryEnforcerService | null;
+    static setInstance(next: OrcDeliveryEnforcerService | null): void;
+    /** Start the periodic scan. Idempotent. */
+    start(): void;
+    stop(): void;
+    /**
+     * Call this from `chat.controller` when an agent posts a `[DONE]`-style
+     * status to a slack-prefixed conversation. Safe to call multiple times
+     * for the same thread — the most recent agent message wins (we
+     * surface only the latest deliverable summary in the reminder).
+     */
+    markPendingDelivery(input: {
+        conversationId: string;
+        agentSender: string;
+        text: string;
+    }): void;
+    /**
+     * Call this from `slack.controller` after a successful `/api/slack/send`.
+     * Cleared regardless of which agent originated the underlying deliverable.
+     */
+    markDelivered(input: {
+        channelId: string;
+        threadTs?: string | null;
+    }): void;
+    /** Test affordance — peek at the in-memory ledger. */
+    _peekPending(): PendingDelivery[];
+    /**
+     * Public for tests + the manual-trigger endpoint. Otherwise driven by
+     * the internal timer.
+     */
+    tick(now?: number): {
+        firedFor: string[];
+    };
+    private formatReminder;
+}
+export declare function isAgentDeliveryMarker(text: string): boolean;
+/**
+ * Parse a chat-v2 conversation id of the form `slack-<channelId>-<ts>`
+ * into { channelId, threadTs }. Returns null for non-slack ids. Mirrors
+ * the regex in `request-sla.subscriber` so the enforcer agrees with the
+ * SLA layer on what "the same thread" means.
+ */
+export declare function parseSlackConversationId(conversationId: string): SlackThreadKey | null;
+/**
+ * Is this sender the orchestrator itself (by session name or the display
+ * names the prompt/skills use for it)?
+ *
+ * @param sender - `senderName` as posted to `/chat/agent-response`
+ * @returns True for the orchestrator
+ */
+export declare function isOrchestratorSender(sender: string): boolean;
+//# sourceMappingURL=orc-delivery-enforcer.service.d.ts.map

package/dist/cli/backend/src/services/orc/orc-delivery-enforcer.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orc-delivery-enforcer.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/orc/orc-delivery-enforcer.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAiBH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,cAAc,CAAC;IACpB,wFAAwF;IACxF,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,KAAK,IAAI,CAAC;AAEX,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,YAAY,EAAE,oBAAoB,CAAC;IACnC,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,KAAK,CAA+B;IAC5C,wCAAwC;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;gBAElD,IAAI,EAAE,0BAA0B;IAM5C,MAAM,CAAC,WAAW,IAAI,0BAA0B,GAAG,IAAI;IAIvD,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI,GAAG,IAAI;IAKjE,2CAA2C;IAC3C,KAAK,IAAI,IAAI;IAUb,IAAI,IAAI,IAAI;IAQZ;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,IAAI;IAqCR;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI;IAY3E,sDAAsD;IACtD,YAAY,IAAI,eAAe,EAAE;IAIjC;;;OAGG;IACH,IAAI,CAAC,GAAG,GAAE,MAAmB,GAAG;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IA8CtD,OAAO,CAAC,cAAc;CAevB;AAMD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAI3D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,GACrB,cAAc,GAAG,IAAI,CA6BvB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAG5D"}