@wrangled/cli 0.3.28 → 0.3.29

package/dist/guide.js

@@ -30,6 +30,10 @@ Lessons are short plain sentences about why the winners won and the flops floppe
 
 Write one as JSON, \`{"text": "...", "dimension": "hook", "evidence": [{"ad": "<Meta ad id or SKU>", "numbers": "cost per sale $180 vs $410"}], "week": "2026-09-28"}\`, and run \`${cli} lessons add --file lesson.json\`. \`dimension\` (hook, angle, format, offer, persona or other) and \`week\` (any day of the winners report's week; default the latest complete week) are optional. A lesson with the same words that still holds, or the one named in \`"reinforces": "<id>"\`, is reinforced instead of copied: it counts once more for a week it had not counted, so running the same week again changes no count. \`${cli} lessons retire <id> --note "<why>"\` retires one the numbers no longer back; it is kept with why. The \`lessons\` playbook (\`${cli} skill install lessons\` installs it as the \`${LESSONS_SKILL_NAME}\` skill) writes the week's lessons from the winners report.
 
+## Sending winners to Exodus
+
+\`${cli} winners send-to-exodus\` sends the week's winners to Exodus so it makes new ads from them: one package per Facebook page, each winner with its reason, its numbers, and a note of the lessons it proves, persona lessons and the week's freshest customer words. Winners whose page, words or format are unknown are left out and listed with why. \`--week <YYYY-MM-DD>\` picks the week (default: the latest complete week). \`--dry-run\` asks Exodus what it would create or update and writes nothing. Sending the same week again is safe: an unchanged package is not sent twice, and Exodus updates each ad in place. A real send needs the workspace's Exodus brand and a Scrape Creators key on the Exodus account.
+
 ## Content: search before SQL
 
 To find content, such as "the 10 emails with the best click rate", "our 5 best videos by return on ad spend" or "every landing page that mentions the guarantee", use \`${cli} content search\` before writing SQL on the \`content_\` tables.
@@ -257,6 +261,7 @@ ${cli} knowledge tag <entry-id> --hook-kind <v> --confidence <c>   tag a library
 ${cli} guide                        what this workspace's data holds, how fresh it is, and what is missing: read it first
 ${cli} brief [--from <date>] [--to <date>] [--channel <channel>] [--campaign <id>] [--top <n>]   the offer, voice, best and worst ads, pages, results and audience: start here before writing ads
 ${cli} winners [--week <date>] [--top <n>]   which Facebook ads won and flopped this week and over 30 days, judged on first-touch sales
+${cli} winners send-to-exodus [--week <date>] [--dry-run]   send the week's winners, with their reasons, lessons and customer words, to Exodus; safe to send again
 ${cli} warehouse schema [--summary] [--table <name> ...] [--search <words>]   list tables and columns; --summary for one row per table
 ${cli} warehouse query "<sql>"      run one read-only query (or --file <path>, or stdin); --out <file.csv | file.ndjson | file.json> saves the rows; add --all for every row
 ${cli} funnel [--from <date>] [--to <date>] [--grain day|week|month]   spend, leads, calls and sales per period, with totals

package/dist/main.js

@@ -657,6 +657,24 @@ const commands = {
             process.stdout.write(winnersText(report));
         },
     },
+    "winners send-to-exodus": {
+        usage: "winners send-to-exodus [--week <YYYY-MM-DD>] [--dry-run]   send the week's winning ads, with their reasons, lessons and customer words, to Exodus; safe to send again",
+        async run(args, options) {
+            if (args.length > 0)
+                throw new CliError("Usage: winners send-to-exodus [--week <date>] [--dry-run]", exitCodes.usage);
+            const sent = await api(await resolveConnection(options.apiUrl), "/api/v1/winners/exodus", {
+                ...(options.week === undefined ? {} : { week: options.week }),
+                dryRun: options.dryRun,
+            });
+            if (options.format === "json")
+                printJson(sent);
+            else
+                process.stdout.write(winnersSendText(sent));
+            const failed = sent.pages.filter((p) => p.run.status !== "succeeded").length;
+            if (failed > 0)
+                throw new CliError(`${failed} of ${sent.pages.length} ${sent.pages.length === 1 ? "page was" : "pages were"} not sent; see above.`, exitCodes.error);
+        },
+    },
     examples: {
         usage: "examples   (plain questions with SQL that answers them, for the tables this workspace has)",
         async run(args, options) {
@@ -1913,6 +1931,34 @@ function winnersWindowText(title, window) {
             .join(""));
 }
 /** The winners report as plain Markdown: what a sale means, then this week and the last 30 days, each currency apart. */
+function winnersSendText(sent) {
+    const lines = [`Week ${sent.week.from} to ${sent.week.to}${sent.dryRun ? ", dry run: nothing was written to Exodus" : ""}.`];
+    if (sent.pages.length === 0)
+        lines.push("No winners to send.");
+    for (const page of sent.pages) {
+        lines.push(`${page.pageName} (page ${page.pageId}, ${page.adAccountId}): ${page.winners} ${page.winners === 1 ? "winner" : "winners"}`);
+        const answer = page.exodus;
+        if (answer === null)
+            lines.push(`  Not sent: ${page.run.error ?? `the run is ${page.run.status}`}`);
+        else if ("dryRun" in answer) {
+            for (const action of ["create", "update"]) {
+                const ads = answer.perWinner.filter((w) => w.action === action).map((w) => w.accountAdId);
+                if (ads.length > 0)
+                    lines.push(`  Would ${action}: ${ads.join(", ")}`);
+            }
+            if (answer.scrapecreatorsKey === "missing")
+                lines.push("  Exodus has no Scrape Creators key, so a real send would fail. Add it in Exodus under Settings, Keys.");
+        }
+        else {
+            lines.push(`  ${page.alreadySent ? "Already sent; not sent again" : "Sent"}: import ${answer.importId}, ${answer.accepted} accepted, ${answer.rejected.length} rejected`);
+        }
+        for (const r of answer?.rejected ?? [])
+            lines.push(`  Rejected ${r.accountAdId}: ${r.reason}`);
+    }
+    if (sent.skipped.length > 0)
+        lines.push("Left out:", ...sent.skipped.map((s) => `  ${s.adId}: ${s.reason}`));
+    return `${lines.join("\n")}\n`;
+}
 function winnersText(report) {
     return (`# Winners and flops for ${report.workspace}\n\n` +
         `A sale means ${report.saleMeans}. Each sale goes to the Facebook ad that first brought the buyer in; payments typed into GoHighLevel by hand never count toward an ad.\n` +
@@ -2247,6 +2293,7 @@ function parseOptions(argv) {
             awareness: { type: "string" },
             confidence: { type: "string" },
             remove: { type: "boolean", default: false },
+            "dry-run": { type: "boolean", default: false },
             help: { type: "boolean", short: "h", default: false },
         },
     });
@@ -2347,6 +2394,7 @@ function parseOptions(argv) {
             entryTags: Object.fromEntries(Object.entries(entryTagFlags).flatMap(([field, flag]) => (values[flag] === undefined ? [] : [[field, values[flag]]]))),
             confidence: values.confidence,
             remove: values.remove,
+            dryRun: values["dry-run"],
         },
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrangled/cli",
-  "version": "0.3.28",
+  "version": "0.3.29",
   "description": "Command-line access to your marketing data warehouse, for people and coding agents",
   "type": "module",
   "bin": {