@wrangled/cli 0.3.37 → 0.3.40

package/dist/api.js

@@ -21,6 +21,8 @@ export class UnreadableCredentialsError extends CliError {
  * in src/lib/knowledge/tags.ts. format's flag is --ad-format, because --format picks the output.
  */
 export const entryTagFlags = { angle: "angle", hook_kind: "hook-kind", format: "ad-format", awareness: "awareness" };
+/** The days before a sale in which a click or reply helps it, as the app counts them (MESSAGE_CREDIT_DAYS). */
+export const MESSAGE_CREDIT_DAYS = 7;
 /** Copies of the server's IMPORT_LIMITS and import name rule; src/lib/cli-consistency.test.ts keeps them in step. */
 export const IMPORT_LIMITS = { bytes: 50 * 1024 * 1024, rows: 1_000_000, columns: 500 };
 export const IMPORT_NAME_PATTERN = /^[a-z][a-z0-9_]{0,40}$/;

package/dist/guide.js

@@ -1,4 +1,4 @@
-import { IMPORT_LIMITS } from "./api.js";
+import { IMPORT_LIMITS, MESSAGE_CREDIT_DAYS } from "./api.js";
 import { brand, envPrefix } from "./brand.js";
 import { BACK_TAG_SKILL_NAME, CRO_SKILL_NAME, GRAMMAR_SKILL_NAME, LEARN_NAMES_SKILL_NAME, LESSONS_SKILL_NAME, MAP_OFFERS_SKILL_NAME, PLAYBOOK_CHOICES, STORY_SKILL_NAME, WEEKLY_LOOP_SKILL_NAME } from "./playbooks.js";
 import { PULL_STATE_FILE } from "./pull.js";
@@ -40,7 +40,7 @@ ${brand.name} does not build pages; it hands whoever builds one what is already
 
 ## Which Facebook ads and pages won: winners and flops
 
-\`${cli} winners\` says which Facebook ads won and which flopped, for one Monday-to-Sunday week and for the 30 days ending that Sunday, judged on real sales: each sale goes to the Facebook ad that first brought the buyer in, and payments typed into GoHighLevel by hand never count toward an ad. An ad with no sales that has spent less than twice the account's cost per sale is too new to judge on sales, so it is judged on cost per sign-up and listed apart. Each ad says in a sentence why it is on its list. Each currency also says how many of its Facebook sales could be tied to a specific ad (\`adSales\` of \`facebookSales\` in the JSON): a sale whose link names no single ad counts toward Facebook but toward no ad. It judges the landing pages the ads sent people to the same way, and each ad on each page as an ad-and-page pair: a page or pair counts only once the page reader has read the page and it got at least 100 visits in the dates, and pairs are listed only for an ad that sent people to two or more pages, or a page that got people from two or more ads, each naming what the same ad cost on its other pages. \`--week <YYYY-MM-DD>\` picks any day of the week (default: the latest complete week), \`--top <n>\` how many ads, pages or pairs each list shows (default 5, at most 20), and \`--format json\` gives the report as data.
+\`${cli} winners\` says which Facebook ads won and which flopped, for the dates asked for and for the 30 days ending on their last day, judged on real sales: each sale goes to the Facebook ad that first brought the buyer in, and payments typed into GoHighLevel by hand never count toward an ad. An ad with no sales that has spent less than twice the account's cost per sale is too new to judge on sales, so it is judged on cost per sign-up and listed apart. Each ad says in a sentence why it is on its list. Each currency also says how many of its Facebook sales could be tied to a specific ad (\`adSales\` of \`facebookSales\` in the JSON): a sale whose link names no single ad counts toward Facebook but toward no ad. It judges the landing pages the ads sent people to the same way, and each ad on each page as an ad-and-page pair: a page or pair counts only once the page reader has read the page and it got at least 100 visits in the dates, and pairs are listed only for an ad that sent people to two or more pages, or a page that got people from two or more ads, each naming what the same ad cost on its other pages. \`--week <YYYY-MM-DD>\` picks any day of a Monday-to-Sunday week (default: the latest complete week), \`--days <n>\` the last n complete days ending yesterday, and \`--from <YYYY-MM-DD> --to <YYYY-MM-DD>\` any dates; use one of them, at most 90 days. Check as often as suits the client, daily or every few days: a short window holds few sales, so more ads are judged on sign-ups, and the report says so. \`--top <n>\` how many ads, pages or pairs each list shows (default 5, at most 20), and \`--format json\` gives the report as data.
 
 ## What winners and flops taught: lessons
 
@@ -50,11 +50,11 @@ Write one as JSON, \`{"text": "...", "dimension": "hook", "evidence": [{"ad": "<
 
 ## 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.
+\`${cli} winners send-to-exodus\` sends the 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 freshest customer words of the dates. Winners whose page, words or format are unknown are left out and listed with why. \`--week <YYYY-MM-DD>\`, \`--days <n>\` or \`--from\` and \`--to\` pick the dates, as for \`${cli} winners\` (default: the latest complete week). \`--dry-run\` asks Exodus what it would create or update and writes nothing. Sending the same dates 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.
 
 ## The weekly loop: a sample for an orchestrator agent
 
-The \`weekly-loop\` playbook (\`${cli} skill install weekly-loop\` installs it as the \`${WEEKLY_LOOP_SKILL_NAME}\` skill; \`${cli} docs weekly-loop\` prints it) is a sample week for a local agent that runs a client's Facebook ads with its owner. It names the command and the MCP tool for each step: the winners and flops report, lessons, fresh customer words, the brief, the offers and funnels map, making ads (Exodus, paid tools or the agent's own skills), and the results of what was published, read back by Adzara's labels. Judge winners by ${brand.name}'s real-sales report (\`${cli} winners\`); Adzara's results are Meta's count. Approvals and decisions happen in the agent's own session with the owner; ${brand.name} records none. Ads are published and changed through Adzara, never through ${brand.name}.
+The \`weekly-loop\` playbook (\`${cli} skill install weekly-loop\` installs it as the \`${WEEKLY_LOOP_SKILL_NAME}\` skill; \`${cli} docs weekly-loop\` prints it) is a sample to borrow from, not a schedule, for a local agent that runs a client's Facebook ads with its owner: its steps can run daily, several times a week or weekly, and the winners report covers whatever dates are asked for. It names the command and the MCP tool for each step: the winners and flops report, lessons, fresh customer words, the brief, the offers and funnels map, making ads (Exodus, paid tools or the agent's own skills), and the results of what was published, read back by Adzara's labels. Judge winners by ${brand.name}'s real-sales report (\`${cli} winners\`); Adzara's results are Meta's count. Approvals and decisions happen in the agent's own session with the owner; ${brand.name} records none. Ads are published and changed through Adzara, never through ${brand.name}.
 
 ## Trying one change: funnel tests
 
@@ -113,7 +113,7 @@ For "how is the funnel doing?", "which campaigns are working?" and "where does t
 
 ## Webhook addresses
 
-A webhook address lets a tool such as a form or webinar platform push events into the warehouse's \`raw_events\` table. \`${cli} intake list\` shows each address with whether it is on, how many days it keeps events, the events of the last 24 hours, the last event's time, and the rows it holds. \`${cli} intake create <label>\` makes one and prints its link, address and token. The link is the one URL to paste into the sending tool: the address with the token on the end, or for Mailgun the bare address. Add \`--kind ghl_workflow\` for a GoHighLevel workflow's Webhook step: its events also land, typed, in \`ghl_events\`. Add \`--kind aloware\` for Aloware's call and text webhooks: they also land, typed, in \`aloware_calls\` and \`aloware_texts\`. Add \`--kind webinarfuel\` or \`--kind stealth_seminar\` for a webinar tool: its sign-ups, attendance, replays and offer clicks land in \`webinar_events\`. Add \`--kind mailgun --signing-key-stdin\`, with Mailgun's HTTP webhook signing key piped on stdin, for a Mailgun account's webhooks: each event's signature is checked and alone proves the sender, so Mailgun posts to the address itself with no token, and its events also land, typed, in \`mailgun_events\`. When the account's key changes, pipe the new one to \`${cli} intake signing-key <id> --signing-key-stdin\`; deleting the workspace's last Mailgun address deletes the key. Add \`--kind thrivecart_events\` for a ThriveCart account's webhook: affiliate commissions earned, taken back and paid out also land, typed, in \`thrivecart_affiliate_commissions\`, where they stay after their events pass the retention, and \`daily_spend\` counts them. The link and token are shown only then and after \`${cli} intake rotate <id>\`. Paste the link into the sending tool, or, when the tool can set a header, give it the address and \`Authorization: Bearer <token>\` instead, which keeps the token out of request logs. Never paste either anywhere else. Events are kept for 90 days unless \`--retention-days\` or \`${cli} intake retention <id> <days>\` says otherwise (1 to 3650). \`${cli} intake delete <id> --yes\` deletes the address and every event it saved. A website visit tag shows in \`${cli} intake list\` as an address of kind \`visit_tag\`, and each page view it records lands in \`site_visits\` (host, path, referrer host, UTM tags, click ids, country, device type, a bot flag and a random visitor id). \`${cli} intake create\` cannot make one: a tag has no token and needs its list of allowed sites, so an operator makes it with the server's \`npm run visit-tag:create\` script.
+A webhook address lets a tool such as a form or webinar platform push events into the warehouse's \`raw_events\` table. \`${cli} intake list\` shows each address with whether it is on, how many days it keeps events, the events of the last 24 hours, the last event's time, and the rows it holds. \`${cli} intake create <label>\` makes one and prints its link, address and token. The link is the one URL to paste into the sending tool: the address with the token on the end, or for Mailgun the bare address. Add \`--kind ghl_workflow\` for a GoHighLevel workflow's Webhook step: its events also land, typed, in \`ghl_events\`. Add \`--kind aloware\` for Aloware's call and text webhooks: they also land, typed, in \`aloware_calls\` and \`aloware_texts\`. Add \`--kind webinarfuel\` or \`--kind stealth_seminar\` for a webinar tool: its sign-ups, attendance, replays and offer clicks land in \`webinar_events\`. Add \`--kind mailgun --signing-key-stdin\`, with Mailgun's HTTP webhook signing key piped on stdin, for a Mailgun account's webhooks: each event's signature is checked and alone proves the sender, so Mailgun posts to the address itself with no token, and its events also land, typed, in \`mailgun_events\`. When the account's key changes, pipe the new one to \`${cli} intake signing-key <id> --signing-key-stdin\`; deleting the workspace's last Mailgun address deletes the key. Add \`--kind thrivecart_events\` for a ThriveCart account's webhook: affiliate commissions earned, taken back and paid out also land, typed, in \`thrivecart_affiliate_commissions\`, where they stay after their events pass the retention, and \`daily_spend\` counts them. Add \`--kind roezan\` once the workspace's Roezan source is connected: the server uses the source's key to ask Roezan to send each new broadcast to the link (\`subscription\` in the answer says whether that worked; if not, add the link in Roezan's Webhooks tab), each broadcast an event names lands in \`roezan_broadcast_events\`, and the Roezan source reads it on its next hourly sync. The link and token are shown only then and after \`${cli} intake rotate <id>\`. Paste the link into the sending tool, or, when the tool can set a header, give it the address and \`Authorization: Bearer <token>\` instead, which keeps the token out of request logs. Never paste either anywhere else. Events are kept for 90 days unless \`--retention-days\` or \`${cli} intake retention <id> <days>\` says otherwise (1 to 3650). \`${cli} intake delete <id> --yes\` deletes the address and every event it saved. A website visit tag shows in \`${cli} intake list\` as an address of kind \`visit_tag\`, and each page view it records lands in \`site_visits\` (host, path, referrer host, UTM tags, click ids, country, device type, a bot flag and a random visitor id). \`${cli} intake create\` cannot make one: a tag has no token and needs its list of allowed sites, so an operator makes it with the server's \`npm run visit-tag:create\` script.
 
 ## Limits
 
@@ -298,8 +298,9 @@ ${cli} guide                        what this workspace's data holds, how fresh
 ${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} pages brief --step <key> [--funnel <key>] | --page <ref>   the offer, step, current page, best and worst pages of its kind, its ads and how to hand a page back: start here before writing a landing page
 ${cli} pages results [--from <date>] [--to <date>] [--page <ref>]   each landing page's, and each ad and page pair's, real first-touch sales, cost per sale and sales per page view
-${cli} winners [--week <date>] [--top <n>]   which Facebook ads and landing pages 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} messages results [--from <date>] [--to <date>] [--channel email|text] [--sequence <id>]   real sales after each follow-up email, text and sequence: every message the buyer clicked or replied to in the ${MESSAGE_CREDIT_DAYS} days before buying (helped), and the latest one (last nudge)
+${cli} winners [--week <date> | --days <n> | --from <date> --to <date>] [--top <n>]   which Facebook ads and landing pages won and flopped in a week or any dates and over 30 days, judged on first-touch sales
+${cli} winners send-to-exodus [--week <date> | --days <n> | --from <date> --to <date>] [--dry-run]   send the 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
@@ -309,7 +310,7 @@ ${cli} sources list                 list data sources and their health
 ${cli} sources show <id>            show one source's health, tables and last sync runs
 ${cli} sources settings <id> [<key>=<value> ...]   show a key source's settings, or check them with its saved key and save them
 ${cli} intake list                  list webhook addresses and their health
-${cli} intake create <label> [--kind generic|ghl_workflow|aloware|webinarfuel|stealth_seminar|mailgun|thrivecart_events] [--retention-days <n>] [--signing-key-stdin]   make a webhook address; prints its link and token once
+${cli} intake create <label> [--kind generic|ghl_workflow|aloware|webinarfuel|stealth_seminar|mailgun|thrivecart_events|roezan] [--retention-days <n>] [--signing-key-stdin]   make a webhook address; prints its link and token once
 ${cli} intake rotate <id>           replace an address's token; prints the new link and token once
 ${cli} intake signing-key <id> --signing-key-stdin   replace the workspace's signing key for that address's kind (mailgun)
 ${cli} intake disable <id> | enable <id>   turn an address off or back on

package/dist/main.js

@@ -669,13 +669,24 @@ const commands = {
             printPageResults(results);
         },
     },
+    "messages results": {
+        usage: "messages results [--from <YYYY-MM-DD>] [--to <YYYY-MM-DD>] [--channel email|text] [--sequence <workflow id>]   (which follow-up emails, texts and sequences bring real sales)",
+        async run(args, options) {
+            if (args.length > 0)
+                throw new CliError("Usage: messages results [--from <date>] [--to <date>] [--channel email|text] [--sequence <workflow id>]", exitCodes.usage);
+            const results = await api(await resolveConnection(options.apiUrl), `/api/v1/messages/results${reportQuery(options, { channel: options.channel, sequence: options.sequence })}`);
+            if (options.format === "json")
+                return printJson(results);
+            printMessageResults(results);
+        },
+    },
     winners: {
-        usage: "winners [--week <YYYY-MM-DD>] [--top <n>]   (which Facebook ads and landing pages won and flopped, judged on real first-touch sales)",
+        usage: "winners [--week <YYYY-MM-DD> | --days <n> | --from <YYYY-MM-DD> --to <YYYY-MM-DD>] [--top <n>]   (which Facebook ads and landing pages won and flopped, judged on real first-touch sales)",
         async run(args, options) {
             if (args.length > 0)
-                throw new CliError("Usage: winners [--week <date>] [--top <n>]", exitCodes.usage);
+                throw new CliError("Usage: winners [--week <date> | --days <n> | --from <date> --to <date>] [--top <n>]", exitCodes.usage);
             const query = new URLSearchParams();
-            for (const [name, value] of Object.entries({ week: options.week, top: options.top }))
+            for (const [name, value] of Object.entries({ ...winnersPeriod(options), top: options.top }))
                 if (value !== undefined)
                     query.set(name, value);
             const report = await api(await resolveConnection(options.apiUrl), `/api/v1/winners${query.size ? `?${query}` : ""}`);
@@ -685,14 +696,12 @@ const commands = {
         },
     },
     "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",
+        usage: "winners send-to-exodus [--week <YYYY-MM-DD> | --days <n> | --from <YYYY-MM-DD> --to <YYYY-MM-DD>] [--dry-run]   send the 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,
-            });
+                throw new CliError("Usage: winners send-to-exodus [--week <date> | --days <n> | --from <date> --to <date>] [--dry-run]", exitCodes.usage);
+            const period = Object.entries(winnersPeriod(options)).filter(([, value]) => value !== undefined);
+            const sent = await api(await resolveConnection(options.apiUrl), "/api/v1/winners/exodus", { ...Object.fromEntries(period), dryRun: options.dryRun });
             if (options.format === "json")
                 printJson(sent);
             else
@@ -2059,7 +2068,7 @@ function winnersPageLines(page, currency) {
     return `- ${ad}${name}: ${counted(Math.round(n.visits), "visit")}, spent ${money(n.spend, currency)}, ${count ? `${count}, ` : ""}${cost}${bought}\n  ${page.pickedBecause}\n`;
 }
 function winnersWindowText(title, window) {
-    const head = `\n## ${title}, ${window.from} to ${window.to}\n`;
+    const head = `\n## ${title}\n`;
     if (window.sections.length === 0)
         return `${head}\nNo Facebook ad spent in these dates.\n`;
     return (head +
@@ -2095,8 +2104,19 @@ function winnersWindowText(title, window) {
         })
             .join(""));
 }
+/** The window flags as the API takes them; the server refuses two windows at once or half a range. */
+function winnersPeriod(options) {
+    return { week: options.week, days: options.days, from: options.from, to: options.to };
+}
+/** "This week, 2026-09-28 to 2026-10-04", "Last 3 days, 2026-10-04 to 2026-10-06" or "2026-10-01 to 2026-10-03". */
+function winnersDatesTitle(window) {
+    const dates = `${window.from} to ${window.to}`;
+    if (window.kind === "week")
+        return `This week, ${dates}`;
+    return window.kind === "days" ? `Last ${counted(window.days, "day")}, ${dates}` : dates;
+}
 function winnersSendText(sent) {
-    const lines = [`Week ${sent.week.from} to ${sent.week.to}${sent.dryRun ? ", dry run: nothing was written to Exodus" : ""}.`];
+    const lines = [`${sent.window.kind === "week" ? "Week " : ""}${sent.window.from} to ${sent.window.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) {
@@ -2123,12 +2143,12 @@ function winnersSendText(sent) {
         lines.push("Left out:", ...sent.skipped.map((s) => `  ${s.adId}: ${s.reason}`));
     return `${lines.join("\n")}\n`;
 }
-/** The winners report as plain Markdown: what a sale means, then this week and the last 30 days, each currency apart. */
+/** The winners report as plain Markdown: what a sale means, then the dates asked for and the last 30 days, each currency apart. */
 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` +
-        winnersWindowText("This week", report.week) +
-        winnersWindowText("Last 30 days", report.last30Days));
+        winnersWindowText(winnersDatesTitle(report.window), report.week) +
+        winnersWindowText(`Last 30 days, ${report.last30Days.from} to ${report.last30Days.to}`, report.last30Days));
 }
 function reportQuery(options, extra) {
     const query = new URLSearchParams();
@@ -2161,6 +2181,51 @@ function printPageResults(results) {
     console.log(renderTable(["page", "ad", "ad name", "currency", ...PAGE_NUMBERS], results.adPages.map((r) => ({ ...pageNumbers(r), ad: r.adId ?? "(no Meta ad)", "ad name": r.adName === null ? "" : excerpt(r.adName, 30) }))));
     console.log('\n"by ad link" counts sales whose buyer\'s landing page was not recorded, credited to the page the ad links to now.');
 }
+const MESSAGE_NUMBERS = ["currency", "helped", "helped revenue", "last nudge", "last nudge revenue", "first from Facebook"];
+/** One row per currency the sales are in, or one row with no sales. */
+function salesRows(label, sales) {
+    if (sales.length === 0)
+        return [{ ...label, helped: 0, "last nudge": 0 }];
+    return sales.map((s) => ({
+        ...label,
+        currency: s.currency,
+        helped: s.salesHelped,
+        "helped revenue": s.revenueHelped,
+        "last nudge": s.salesLastNudge,
+        "last nudge revenue": s.revenueLastNudge,
+        "first from Facebook": s.buyersFirstTouchMeta,
+    }));
+}
+const messageLabel = (m) => excerpt(m.name ?? m.subject ?? (m.realSales === "available" ? m.messageKey : (m.itemId ?? "")), 40);
+function printMessageResults(results) {
+    const real = results.messages.flatMap((m) => (m.realSales === "available" ? [m] : []));
+    const claimed = results.messages.flatMap((m) => (m.realSales === "not_available" ? [m] : []));
+    if (results.messages.length === 0 && results.sequences.length === 0)
+        return console.log(`No follow-up results from ${results.from} to ${results.to}.`);
+    console.log(`Follow-up emails and texts, most helped sales first, ${results.from} to ${results.to}:`);
+    console.log(renderTable(["message", "channel", "platform", "sent", "clicked", "replied", ...MESSAGE_NUMBERS, "per 1,000 sent"], real.flatMap((m) => salesRows({ message: messageLabel(m), channel: m.channel, platform: m.platform, sent: m.peopleSent ?? (m.toolNumbersInRange === "unknown" ? "unknown" : m.toolSends), clicked: m.peopleClicked, replied: m.peopleReplied, "per 1,000 sent": m.salesPer1000Sent }, m.sales))));
+    if (results.sequences.length > 0) {
+        console.log("\nSequences:");
+        console.log(renderTable(["sequence", "name", "messages", ...MESSAGE_NUMBERS], results.sequences.flatMap((q) => salesRows({ sequence: q.sequenceKey, name: q.name ?? "", messages: q.messages }, q.sales))));
+    }
+    if (claimed.length > 0) {
+        console.log("\nFrom tools that never say who clicked, so no real sales; revenue is the tool's own claim:");
+        console.log(renderTable(["message", "channel", "platform", "sends", "clicks", "tool-claimed revenue"], claimed.map((m) => m.toolNumbersInRange === "unknown"
+            ? { message: messageLabel(m), channel: m.channel, platform: m.platform, sends: "unknown", clicks: "unknown", "tool-claimed revenue": "unknown" }
+            : {
+                message: messageLabel(m),
+                channel: m.channel,
+                platform: m.platform,
+                sends: m.toolSends,
+                clicks: m.toolClicks,
+                "tool-claimed revenue": (m.toolClaimedRevenue ?? []).map((r) => `${r.revenue} ${r.currency ?? ""}`.trim()).join(", "),
+            })));
+    }
+    if (results.messages.some((m) => m.toolNumbersInRange === "unknown")) {
+        console.log("\nunknown: the tool keeps only running totals, and none was read before these dates for a message sent earlier, so how much fell in them cannot be told.");
+    }
+    console.log(`\n"helped" counts every message the buyer clicked or replied to in the ${results.creditDays} days before buying, so one sale counts for several messages; "last nudge" gives each sale only to the latest one, so those add up.`);
+}
 /** The rows, then the totals, which are one row per currency. */
 /** What confirmed leave-out rules took out of `figures`, one line per rule and currency. */
 function printLeftOut(leftOut, figures) {
@@ -2376,14 +2441,18 @@ Options:
   --force               content unpublish: take the page down even while delivering Meta ads link to it
   --plan <json>         meta adset publish: the ad set to make, {"kind": "copy", ...} or {"kind": "create", ...}
   --yes                 confirm intake delete or import remove, which delete saved data for good
-  --from <YYYY-MM-DD>   first day funnel, campaigns, money, brief and pages results cover (default: 29 days before --to)
-  --to <YYYY-MM-DD>     last day funnel, campaigns, money, brief and pages results cover (default: today in the workspace reporting time zone)
+  --from <YYYY-MM-DD>   first day funnel, campaigns, money, brief, pages results and messages results cover (default: 29 days before --to)
+  --to <YYYY-MM-DD>     last day funnel, campaigns, money, brief, pages results and messages results cover (default: today in the workspace reporting time zone)
   --grain <grain>       how funnel and money group days: day (default), week (starting Monday) or month
   --channel <channel>   only this channel's campaigns (and, with brief, its ads): meta, google, affiliate, a utm_source, unknown or recorded_in_crm;
-                        for content track-link, where the link goes: facebook, email, sms or web (default)
+                        for content track-link, where the link goes: facebook, email, sms or web (default);
+                        with messages results, email or text
+  --sequence <id>       with messages results, only the messages in this GoHighLevel workflow, and only that sequence
   --campaign <id>       the campaign content track-link puts in utm_campaign; with brief, the one campaign it covers
   --top <n>             how many best ads, worst ads, pages and campaigns brief shows, or ads in each winners list (default: 5, at most 20)
   --week <YYYY-MM-DD>   any day of the week winners covers, Monday to Sunday (default: the latest complete week)
+  --days <n>            winners: the last n complete days, ending yesterday, instead of a week (at most 90); or give winners
+                        --from and --to for any dates
   --body, --html <text | @file>   the words, or the full HTML, content create, capture and edit save
   --file <path>         an image, video or audio file, up to 50 MB, content create, capture and edit save; repeat for several
   --transcript <text | @file>   what is said in the first video or audio file content capture saves, so none is paid for
@@ -2489,6 +2558,7 @@ function parseOptions(argv) {
             campaign: { type: "string" },
             top: { type: "string" },
             week: { type: "string" },
+            days: { type: "string" },
             name: { type: "string" },
             subject: { type: "string" },
             preview: { type: "string" },
@@ -2532,6 +2602,7 @@ function parseOptions(argv) {
             funnel: { type: "string" },
             step: { type: "string" },
             page: { type: "string" },
+            sequence: { type: "string" },
             workspace: { type: "string" },
             "max-seconds": { type: "string" },
             angle: { type: "string" },
@@ -2597,6 +2668,7 @@ function parseOptions(argv) {
             campaign: values.campaign,
             top: values.top,
             week: values.week,
+            days: values.days,
             name: values.name,
             subject: values.subject,
             preview: values.preview,
@@ -2640,6 +2712,7 @@ function parseOptions(argv) {
             funnel: values.funnel,
             step: values.step,
             page: values.page,
+            sequence: values.sequence,
             workspace: values.workspace,
             maxSeconds,
             entryTags: Object.fromEntries(Object.entries(entryTagFlags).flatMap(([field, flag]) => (values[flag] === undefined ? [] : [[field, values[flag]]]))),
@@ -3387,15 +3460,17 @@ function parseRetentionDays(text) {
         throw new CliError("Retention must be a whole number of days, at least 1.", exitCodes.usage);
     return days;
 }
-function printIntakeToken({ endpoint, address, token, link }, format) {
+function printIntakeToken({ endpoint, address, token, link, subscription }, format) {
     if (format === "json")
-        printJson({ endpoint, address, token, link });
+        printJson({ endpoint, address, token, link, ...(subscription ? { subscription } : {}) });
     else {
         if (link)
             console.log(`Link:    ${link}`);
         console.log(`Address: ${address}`);
         console.log(`Header:  Authorization: Bearer ${token}`);
         console.log(`Token:   ${token}`);
+        if (subscription)
+            console.log(`Setup:   ${subscription.message}`);
     }
     console.error(`The token for ${endpoint.label} is shown only now. Rotate it if it is lost.`);
 }

package/dist/playbooks.js

@@ -1558,15 +1558,15 @@ const testResultsSql = "SELECT test_id, currency, sum(spend) AS spend, sum(sales
 const lineageSql = "SELECT facebook_ad_id, hypothesis_id, test_id, creative_id, asset_version FROM adzara_ad_lineage ORDER BY synced_at DESC LIMIT 100";
 /** The commands the weekly loop shows, in order; its text is made from them, so a test runs exactly these. */
 export const weeklyLoopCommands = {
-    winners: { purpose: "the week's Facebook winners and flops, and the 30 days ending that Sunday, judged on real first-touch sales", argv: ["winners", "--week", "<week-monday>", "--format", "json"], mcp: "get_winners_report" },
+    winners: { purpose: "the Facebook winners and flops of the dates asked for, here a week, and of the 30 days ending on their last day, judged on real first-touch sales", argv: ["winners", "--week", "<week-monday>", "--format", "json"], mcp: "get_winners_report" },
     lessons: { purpose: "what earlier weeks taught, the most often seen first", argv: ["lessons", "--format", "json"], mcp: "get_lessons" },
     writeLessons: { purpose: "install the lessons playbook, then follow it to add, reinforce or retire this week's lessons", argv: ["skill", "install", "lessons"], mcp: "record_lesson" },
     voice: { purpose: "fresh customer words: the most usable single lines said since that Monday", argv: ["voice", "--since", "<week-monday>", "--sort", "useful", "--json"], mcp: "get_customer_voice" },
     brief: { purpose: "the campaign brief: offer, voice, lessons, best and worst ads, pages and audience, as Markdown", argv: ["brief"], mcp: "get_campaign_brief" },
     funnelMap: { purpose: "the offers and funnels map: what is sold, at what price, and the steps a buyer takes", argv: ["funnels", "show"], mcp: "get_funnel_map" },
     cro: { purpose: "install the cro playbook, then follow it to turn the funnel's costliest leaks into test ideas for the owner and read the running tests", argv: ["skill", "install", "cro"], mcp: "draft_funnel_test" },
-    exodusPreview: { purpose: "ask Exodus what it would make from the week's winners, writing nothing", argv: ["winners", "send-to-exodus", "--week", "<week-monday>", "--dry-run"], mcp: "send_winners_to_exodus" },
-    exodusSend: { purpose: "send the week's winners to Exodus so it makes new ads from them; sending again is safe", argv: ["winners", "send-to-exodus", "--week", "<week-monday>"], mcp: "send_winners_to_exodus" },
+    exodusPreview: { purpose: "ask Exodus what it would make from the winners of the same dates, writing nothing", argv: ["winners", "send-to-exodus", "--week", "<week-monday>", "--dry-run"], mcp: "send_winners_to_exodus" },
+    exodusSend: { purpose: "send those winners to Exodus so it makes new ads from them; sending again is safe", argv: ["winners", "send-to-exodus", "--week", "<week-monday>"], mcp: "send_winners_to_exodus" },
     paidTools: { purpose: "the paid making tools this workspace can run; each run costs money", argv: ["tools", "list"], mcp: "list_tools" },
     testResults: { purpose: "spend, first-touch sales and cost per sale for each Adzara test over the last 30 days", argv: ["warehouse", "query", testResultsSql], mcp: "query_warehouse" },
     lineage: { purpose: "which Meta ad carries which Adzara labels: idea, test, creative and version", argv: ["warehouse", "query", lineageSql], mcp: "query_warehouse" },
@@ -1586,7 +1586,7 @@ ${commandLine(c)}
 Without a shell: MCP \`${c.mcp}\`.`;
 export const weeklyLoopPlaybook = `# Weekly loop playbook (sample)
 
-A sample for a local orchestrator agent that runs a client's Facebook ads week with its owner. Once a week it reads what sold, learns from it, gathers fresh material, gets new ads made, has them published through Adzara, and later reads their results back. ${brand.name} supplies the data and keeps no part of the loop's decisions.
+A sample to borrow from, not a schedule, for a local orchestrator agent that runs a client's Facebook ads with its owner. It reads what sold, learns from it, gathers fresh material, gets new ads made, has them published through Adzara, and later reads their results back. It is written as a week, but its steps can run daily, several times a week or weekly, each on its own rhythm: the winners report covers whatever dates you ask for. ${brand.name} supplies the data and keeps no part of the loop's decisions.
 
 Every \`${cli}\` command acts on the one workspace the saved API key belongs to. Each step also names the MCP tool that does the same, for an agent connected over MCP without a shell.
 
@@ -1601,7 +1601,7 @@ Every \`${cli}\` command acts on the one workspace the saved API key belongs to.
 
 ${step(W.winners)}
 
-${W.winners.purpose[0].toUpperCase()}${W.winners.purpose.slice(1)}. Each ad has its \`numbers\`, \`pickedBecause\`, \`tags\` and Adzara \`test\`; each section's \`tests\` adds up each Adzara test. Leave out \`--week\` for the latest complete week.
+${W.winners.purpose[0].toUpperCase()}${W.winners.purpose.slice(1)}. Each ad has its \`numbers\`, \`pickedBecause\`, \`tags\` and Adzara \`test\`; each section's \`tests\` adds up each Adzara test. Leave out \`--week\` for the latest complete week. To check more often, swap \`--week\` for \`--days <n>\`, the last n complete days ending yesterday, or \`--from <YYYY-MM-DD> --to <YYYY-MM-DD>\` for any dates (the MCP tool takes \`week\`, \`days\` or \`from\` and \`to\`). A short window holds few sales, so fewer ads can be judged on sales and more are judged on sign-ups; the report says so in \`notes\`.
 
 ## 2. Lessons
 
@@ -1641,7 +1641,7 @@ Follow the installed skill. It drafts at most 3 funnel tests, each with one chan
 
 Exodus is one way to make ads among several. Pick what fits the week.
 
-**Exodus.** Preview what it would make from the week's winners, then send. The MCP tool takes \`week\` and \`dryRun\`. A real send needs the workspace's Exodus brand and a Scrape Creators key on the Exodus account.
+**Exodus.** Preview what it would make from the winners, then send. It takes the same dates as the winners report: \`--week\`, \`--days\` or \`--from\` and \`--to\`; over MCP, \`week\`, \`days\` or \`from\` and \`to\`, and \`dryRun\`. A real send needs the workspace's Exodus brand and a Scrape Creators key on the Exodus account.
 
 ${step(W.exodusPreview)}
 

package/package.json

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