salesprompter-cli 0.1.69 → 0.1.70

package/README.md

@@ -109,7 +109,7 @@ salesprompter affiliate:grow \
   --send-from 09:00 \
   --send-to 16:00
 
-# Review the persisted sequence and enrichment summary, then activate explicitly
+# Verify live campaign state, lead safety, and contact activity, then activate explicitly
 salesprompter affiliate:list
 salesprompter affiliate:status "$AFFILIATE_RUN_ID"
 salesprompter affiliate:analytics "$AFFILIATE_RUN_ID"

package/dist/cli.js

@@ -247,6 +247,57 @@ const AffiliateOutreachResponseSchema = z.object({
     status: z.literal("ok"),
     outreach: AffiliateOutreachRunSchema
 });
+const AffiliateOutreachHealthSchema = z.object({
+    checkedAt: DatabaseTimestampSchema,
+    liveChecked: z.boolean(),
+    done: z.boolean(),
+    verdict: z.enum([
+        "preparing",
+        "failed",
+        "unavailable",
+        "not_running",
+        "ready_to_activate",
+        "running",
+        "unsafe_running"
+    ]),
+    running: z.boolean(),
+    activationReady: z.boolean(),
+    safeToSend: z.boolean(),
+    dataPreparationComplete: z.boolean(),
+    campaign: z
+        .object({
+        id: z.string().min(1),
+        name: z.string().min(1).nullable(),
+        status: z.number().int().nullable(),
+        statusLabel: z.string().min(1),
+        dailyLimit: z.number().nonnegative().nullable(),
+        sendingAccountCount: z.number().int().nonnegative()
+    })
+        .nullable(),
+    leads: z
+        .object({
+        total: z.number().int().nonnegative(),
+        active: z.number().int().nonnegative(),
+        inactive: z.number().int().nonnegative(),
+        verified: z.number().int().nonnegative(),
+        pendingVerification: z.number().int().nonnegative(),
+        invalid: z.number().int().nonnegative(),
+        unsafe: z.number().int().nonnegative(),
+        contacted: z.number().int().nonnegative(),
+        replied: z.number().int().nonnegative(),
+        statusCounts: z.record(z.string(), z.number().int().nonnegative()),
+        verificationStatusCounts: z.record(z.string(), z.number().int().nonnegative())
+    })
+        .nullable(),
+    blockers: z.array(z.object({
+        code: z.string().min(1),
+        message: z.string().min(1),
+        count: z.number().int().nonnegative().optional()
+    }))
+});
+const AffiliateOutreachLiveStatusResponseSchema = AffiliateOutreachResponseSchema.extend({
+    health: AffiliateOutreachHealthSchema
+});
 const AffiliateOutreachSummarySchema = AffiliateOutreachRunBaseSchema;
 const AffiliateAudienceSummarySchema = z.object({
     public_token: z.string().min(1),
@@ -6765,6 +6816,35 @@ async function getAffiliateOutreachViaApp(session, audienceRunId) {
     }), AffiliateOutreachResponseSchema);
     return value.outreach;
 }
+async function getAffiliateOutreachLiveStatusViaApp(session, audienceRunId) {
+    const { value } = await fetchCliJson(session, (currentSession) => {
+        const url = new URL(`/api/cli/affiliate-outreach/${encodeURIComponent(audienceRunId)}`, currentSession.apiBaseUrl);
+        url.searchParams.set("live", "1");
+        return fetch(url, {
+            headers: {
+                Authorization: `Bearer ${currentSession.accessToken}`
+            }
+        });
+    }, AffiliateOutreachLiveStatusResponseSchema);
+    return value;
+}
+function describeAffiliateOutreachHealth(health) {
+    const leads = health.leads;
+    if (health.done && leads) {
+        return `Done: the campaign is running with ${leads.verified}/${leads.total} verified leads.`;
+    }
+    if (health.verdict === "unsafe_running" && leads) {
+        return `Attention: the campaign is running with ${leads.unsafe} unsafe leads.`;
+    }
+    if (health.verdict === "ready_to_activate" && leads) {
+        return `Ready to activate: ${leads.verified}/${leads.total} leads are verified.`;
+    }
+    if (health.liveChecked && leads) {
+        const campaignState = health.campaign?.statusLabel ?? "unknown";
+        return `Not done: the campaign is ${campaignState}; ${leads.verified}/${leads.total} leads are verified; ${leads.contacted} contacted.`;
+    }
+    return health.blockers[0]?.message ?? "Live campaign status could not be verified.";
+}
 async function getAffiliateOutreachAnalyticsViaApp(session, audienceRunId) {
     const { value } = await fetchCliJson(session, (currentSession) => fetch(`${currentSession.apiBaseUrl}/api/cli/affiliate-outreach/${encodeURIComponent(audienceRunId)}/analytics`, {
         headers: {
@@ -15108,11 +15188,18 @@ program
 });
 program
     .command("affiliate:status <run-id>")
-    .description("Show enrichment, sequence, Instantly, and activation status for an affiliate run.")
+    .description("Verify whether an affiliate campaign is prepared, safe, and actually running.")
     .action(async (runId) => {
     const session = await requireAuthSession();
-    const outreach = await getAffiliateOutreachViaApp(session, z.string().uuid().parse(runId));
-    printOutput({ status: "ok", outreach });
+    const result = await getAffiliateOutreachLiveStatusViaApp(session, z.string().uuid().parse(runId));
+    printOutput({
+        status: "ok",
+        done: result.health.done,
+        verdict: result.health.verdict,
+        message: describeAffiliateOutreachHealth(result.health),
+        health: result.health,
+        outreach: result.outreach
+    });
 });
 program
     .command("affiliate:analytics <run-id>")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "salesprompter-cli",
-  "version": "0.1.69",
+  "version": "0.1.70",
   "description": "Sales workflow CLI for guided lead generation, enrichment, scoring, and sync.",
   "author": "Daniel Sinewe <hello@danielsinewe.com>",
   "type": "module",