See where a Bloomerang campaign's money really came from

**Objective:** Report how the campaign named `{campaign-name}` is performing against its goal, and where its money came from, over the period starting `{start-date}` (default: the campaign's own start date).

**Step 1: Establish the campaign**

Call `bloomerang-get-campaign` with `name` set to `{campaign-name}`. If that returns nothing, retry with `name.contains`. If more than one matches, list them with their start date, end date and goal, then stop and ask which one.

Record the goal, raised, start date, end date and whether it is active.

**Step 2: Pull the revenue detail**

Call `bloomerang-get-designation` with `campaign-name` set to the exact campaign name and `created-date.from` set to `{start-date}`. Designation records are the only place campaign attribution exists, so this is the source of truth for the breakdown.

From the designations, group by:

* fund name
* appeal name, treating designations with no appeal as "unattributed"
* type, so pledges are separated from outright gifts

Sum amount per group, and note pledge balance separately from amount. A pledge balance above zero is money promised, not money in.

**Step 3: Check for erosion**

Look at non-deductible amount across the designations and report it separately, since it is not charitable revenue. If any designation shows an acknowledgement status that is not complete, count them.

**Step 4: Report**

* a headline: raised against goal, as an amount and a percentage, plus days remaining if the campaign is still active
* a table by fund: fund name, amount, share of total
* a table by appeal: appeal name, amount, gift count, average gift
* pledges outstanding: total pledge balance and how many pledges carry it
* a count of designations awaiting acknowledgement
* two or three sentences on what the numbers say, naming the strongest appeal and the weakest

**Rules and Guidelines:**

* Read only. Do not call `bloomerang-update-campaign`, `bloomerang-add-campaign`, or any other bloomerang-add- or bloomerang-update- tool.
* Do not reconcile the designation total against the campaign's raised figure by adjusting either one. If they disagree, report both and say they disagree; the gap is usually gifts outside the date window.
* Do not attribute revenue to individual donors here. Designation records carry no account-id, and `bloomerang-get-transaction` cannot be filtered by transaction id, so donor level attribution is not reliable from this data.

**Validation:**

* If the campaign has no goal set, report raised only and say the goal is unset rather than dividing by zero.
* If the designation call returns nothing for the window, widen `created-date.from` once to the campaign start date before concluding the campaign has raised nothing.