@wrangled/cli 0.3.0 → 0.3.2

package/dist/dlc-map-example.js

@@ -47,11 +47,11 @@ export const dlcExampleMap = {
             delivery: "event",
             price: 3497,
             currency: "USD",
-            price_note: "GA $3,497 (some $3,597); VIP upgrade +$597; guest $497; guest VIP $397. The OWL and OCA matches also catch any product whose name merely contains those letters, so check the product names in the evidence.",
+            price_note: "GA $3,497 (some $3,597); VIP upgrade +$597; guest $497; guest VIP $397.",
             stack_position: 5,
             matches: [
-                { platform: "ghl", match_type: "name_contains", value: "OWL" },
-                { platform: "ghl", match_type: "name_contains", value: "OCA" },
+                { platform: "ghl", match_type: "name_starts_with", value: "OWL" },
+                { platform: "ghl", match_type: "name_starts_with", value: "OCA" },
             ],
         },
         {
@@ -63,7 +63,7 @@ export const dlcExampleMap = {
             currency: "USD",
             price_note: "financed: full pay, or a deposit then financing payments",
             stack_position: 6,
-            matches: [{ platform: "ghl", match_type: "name_contains", value: "Protege" }],
+            matches: [{ platform: "ghl", match_type: "name_starts_with", value: "Protege" }],
         },
     ],
     funnels: [

package/dist/main.js

@@ -126,6 +126,7 @@ const commands = {
             if (options.format === "json")
                 return printJson({ funnel });
             printReport(`Funnel by ${funnel.grain}`, funnel, ["period", "currency"], FUNNEL_NUMBERS);
+            printLeftOut(funnel.left_out, "sales, revenue_net and roas");
         },
     },
     money: {
@@ -145,6 +146,7 @@ const commands = {
             }
             if (money.refund_days.length > 0)
                 console.log(`\nBiggest refund days:\n${renderTable(["date", "currency", "refunds"], money.refund_days)}`);
+            printLeftOut(money.left_out, "roas (net still counts it)");
         },
     },
     campaigns: {
@@ -158,6 +160,7 @@ const commands = {
                 return printJson({ campaignResults });
             const title = campaignResults.channel === null ? "Campaigns, best first" : `${campaignResults.channel} campaigns, best first`;
             printReport(title, campaignResults, ["channel", "campaign_id", "campaign_name", "currency"], CAMPAIGN_NUMBERS);
+            printLeftOut(campaignResults.left_out, "the totals (the rows keep it)");
         },
     },
     "tools list": {
@@ -1067,7 +1070,7 @@ const commands = {
             const { fact } = await api(await resolveConnection(options.apiUrl), `${FACTS_PATH}/${encodeURIComponent(args[0])}`);
             if (options.format === "json")
                 return printJson({ fact });
-            printFields({ ...factRow(fact), summary: fact.summary, value: fact.value, evidence: fact.evidence, author: fact.author, "confirmed by": fact.confirmedBy, replaces: fact.replaces });
+            printFields({ ...factRow(fact), summary: fact.summary, value: fact.value, evidence: fact.evidence, author: fact.author, "confirmed by": fact.confirmedBy, "decided by": fact.decidedBy, replaces: fact.replaces });
         },
     },
     "facts propose": {
@@ -1447,6 +1450,13 @@ function reportQuery(options, extra) {
     return query.size ? `?${query}` : "";
 }
 /** 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) {
+    if (!leftOut?.length)
+        return;
+    const rows = leftOut.flatMap((l) => l.amounts.map((a) => ({ fact: l.fact_id, currency: a.currency, revenue: a.revenue, sales: a.sales, rule: l.summary })));
+    console.log(`\nLeft out of ${figures} by confirmed leave-out rules:\n${renderTable(["fact", "currency", "revenue", "sales", "rule"], rows)}`);
+}
 function printReport(title, report, labels, numbers) {
     if (report.rows.length === 0)
         return console.log(`No numbers from ${report.from} to ${report.to}.`);

package/dist/playbooks.js

@@ -621,8 +621,8 @@ Start from the shape that fits, then rename and add steps to match what you read
 
 Write \`map.json\` as \`{"offers": [...], "funnels": [...]}\`, in this order.
 
-1. **Offers**, front end first, numbered by \`stack_position\` from 1. Each has an \`offer_key\` (lowercase, digits and underscores), \`name\`, \`tier\` (\`front_end\` or \`back_end\`), \`delivery\` (course, event, coaching, service, product, membership, webinar, lead_magnet or other), \`price\`, \`currency\`, an optional \`price_note\` (plain words on the price: other prices, payment plans, doubts), and \`matches\`: how a sale is recognised. A match is \`{"platform": ..., "match_type": ..., "value": "..."}\`: platform \`stripe\`, \`ghl\` or \`shopify\`, and match_type \`product_id\`, \`price_id\`, \`amount\` (whole units, with a \`currency\`) or \`name_contains\` (any part of the product's name, ignoring case). Stripe charges carry no product, so match them by \`amount\`. Prefer a GoHighLevel or Shopify \`name_contains\` on the product's name when one price is shared by two offers, as a $497 bump and a $497 guest ticket can be. An offer nobody pays for, such as a free webinar, may have no \`matches\`.
-   - **Price.** A free webinar's \`price\` is 0 when its page or GoHighLevel says it is free. When GoHighLevel and Stripe both show a sale, \`price\` is the GoHighLevel price that names the product, \`price_note\` gives the Stripe amount, and the offer matches both: the GoHighLevel \`name_contains\` and the Stripe \`amount\`. Any other price you cannot find in the evidence is \`null\`, with a \`price_note\` saying why.
+1. **Offers**, front end first, numbered by \`stack_position\` from 1. Each has an \`offer_key\` (lowercase, digits and underscores), \`name\`, \`tier\` (\`front_end\` or \`back_end\`), \`delivery\` (course, event, coaching, service, product, membership, webinar, lead_magnet or other), \`price\`, \`currency\`, an optional \`price_note\` (plain words on the price: other prices, payment plans, doubts), and \`matches\`: how a sale is recognised. A match is \`{"platform": ..., "match_type": ..., "value": "..."}\`: platform \`stripe\`, \`ghl\` or \`shopify\`, and match_type \`product_id\`, \`price_id\`, \`amount\` (whole units, with a \`currency\`), \`name_contains\` (any part of the product's name, ignoring case) or \`name_starts_with\` (the start of the product's name, ignoring case). Use \`name_starts_with\` for a family of products whose names begin with one code, such as event tickets named "OCA Dallas" and "OCA Austin"; \`name_contains\` "OCA" would also catch "Local Coaching". Stripe charges carry no product, so match them by \`amount\`. Prefer a GoHighLevel or Shopify name match on the product's name when one price is shared by two offers, as a $497 bump and a $497 guest ticket can be. An offer nobody pays for, such as a free webinar, may have no \`matches\`.
+   - **Price.** A free webinar's \`price\` is 0 when its page or GoHighLevel says it is free. When GoHighLevel and Stripe both show a sale, \`price\` is the GoHighLevel price that names the product, \`price_note\` gives the Stripe amount, and the offer matches both: a GoHighLevel name match and the Stripe \`amount\`. Any other price you cannot find in the evidence is \`null\`, with a \`price_note\` saying why.
 2. **Funnels and steps.** A funnel has a \`funnel_key\`, \`name\`, \`kind\` (\`front_end\` or \`back_end\`), \`entry_offer_key\`, \`window_days\` (how many days after one step a sale still counts for the next; 365 when left out) and \`steps\`. A step has a \`step_key\`, \`position\` (1, 2, 3 in the order people walk them), \`step_type\`, \`name\`, and optionally the \`offer_key\` it sells, a \`wait_note\` (plain words on the wait before it, such as "the months after the course"), \`assets\` and \`rules\`.
    - Step types: \`ad\`, \`landing_page\`, \`vsl\`, \`optin\`, \`application\`, \`booking\`, \`confirmation\`, \`sales_call\`, \`checkout\`, \`order_bump\`, \`upsell\`, \`downsell\`, \`thank_you\`, \`webinar_registration\`, \`webinar\`, \`event\`, \`email_nurture\`, \`sms_nurture\`, \`onboarding\`, \`other\`.
 3. **Assets** on each step: \`{"asset_type": ..., "ref": ...}\` with refs from the evidence: \`meta_campaign\` (campaign id), \`url\` (page address), \`content_item\` (content item id), \`ghl_funnel_step\` (step id), \`ghl_calendar\`, \`ghl_pipeline_stage\`, \`ghl_tag\`, \`webinar\` (webinar id). Give the step after Traffic its page, the funnel's first page, as a \`url\`, a \`content_item\` from \`pages\` or a \`ghl_funnel_step\`: the Traffic step finds its ads from it. Only that step's pages count, so a checkout page that two funnels share is never mistaken for a first page.

package/package.json

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