Find bad emails and true duplicates in Bloomerang, not households

**Objective:** Audit the contact data on constituents matching `{scope}` and list the records that need fixing, worst first. `{scope}` may be a surname, a city, or the word all to sweep everything.

**Step 1: Establish the record set**

If `{scope}` is all or empty, call `bloomerang-get-constituent` with `max-records` set to `{max-records}` (default 200) and no other filter. If it names a city, filter by city instead. Otherwise filter by `full-name.contains`.

Keep each record id, full name, status, type, primary email, primary phone and primary address fields.

**Step 2: Find bad email addresses**

Call `bloomerang-get-email-address` with bad set to true. Every account-id it returns that is also in your record set has an email that has bounced or been rejected.

**Step 3: Find missing and duplicated contact points**

For each constituent in the set, call `bloomerang-get-email-address`, `bloomerang-get-phone` and `bloomerang-get-address` filtered by account-id, and check for:

* no record at all of that kind
* records exist but none is marked primary
* more than one marked primary
* an address with no postal code, or no state

**Step 4: Find likely duplicates**

Within the record set, group constituents that share a surname and a primary address postal code, or that share a primary email. Each group of two or more is a candidate duplicate. Also call `bloomerang-get-household` and check whether the members of a group already sit in the same household, since that explains a shared address and is not a duplicate.

**Step 5: Report**

A table ranked by severity, one issue per row, giving constituent name, account number and the issue:

* critical: no usable contact point at all, or a bad primary email
* high: likely duplicate, or two records marked primary
* medium: no primary marked, missing postal code or state
* low: missing secondary contact details

Finish with counts by severity, and the three fixes that would clear the most records.

**Rules and Guidelines:**

* Read only. Repair nothing. Do not call `bloomerang-update-email-address`, `bloomerang-update-address`, `bloomerang-update-phone`, `bloomerang-update-constituent`, or any other tool whose name starts with bloomerang-add- or bloomerang-update-. Merging or editing constituent records is a decision for a person.
* Do not call a shared address a duplicate when the constituents belong to the same household.
* Do not treat an inactive constituent as a data problem. Report the status and leave them out of the severity counts.

**Validation:**

* If the constituent call returns exactly `{max-records}` records, say the sweep was truncated and state what it covered.
* If `{scope}` matches nothing, say so and stop rather than falling back to a full sweep unasked.