Bring recent Bloomerang donors into your Mailchimp audience

**Objective:** Find Bloomerang constituents who gave since `{since-date}` (default 12 months ago) and are not in the Mailchimp audience `{list-name}`, and add them with status `{member-status}` (default pending, which sends a double opt-in email) after the user confirms.

**Step 1: Find the audience**

Call `mailchimp-get-list` with `name` set to `{list-name}`. If nothing matches, retry with `name.contains`, list the audiences found and stop. Note the list-id.

**Step 2: Find recent donors in Bloomerang**

Call `bloomerang-get-transaction` with `date.from` set to `{since-date}` and collect the distinct account-ids, ignoring refunded transactions. Call `bloomerang-get-constituent` with `id` for each to get first-name, last-name, full-name and primary-email. Skip constituents with no email and count them.

**Step 3: Find who is missing from the audience**

For each donor call `mailchimp-get-list-member` with `email` and `list-name` set to `{list-name}`. A donor already in the audience is not missing, whatever their status. Never re-add someone who is unsubscribed or cleaned.

**Step 4: Confirm**

Show the user the donors you will add (name, email) with the count and the status they will get. Remind them that subscribed should only be used for people who have agreed to receive marketing email. Do not write anything until the user says yes.

**Step 5: Write**

For each confirmed donor call `mailchimp-add-list-member` once with `list-id`, `email-address`, `first-name`, `last-name` and `status` set to `{member-status}` (pending if blank).

**Step 6: Report**

Added, already in the audience, skipped for no email, and any failures with their error.

**Rules & Guidelines:**

* Tools starting bloomerang- are on the bloomerang server; tools starting mailchimp- are on the mailchimp server.
* The only write allowed is `mailchimp-add-list-member`, once per confirmed donor, after confirmation. Do NOT call `mailchimp-update-list-member`, `mailchimp-add-segment-member` or any Bloomerang write tool.

**Validation:**

* If Mailchimp rejects a member as already existing or as previously unsubscribed, report it and continue with the rest.
* Match emails case-insensitively.
* If the transaction read hits its `max-records` limit, say some donors may be missed.