@aglyn/tenant-data-admin 1.0.0-beta.262 → 1.0.0-beta.263

package/src/lib/server/weekly-summary.d.ts

@@ -16,20 +16,30 @@
  */
 import type { AglynOrgMember } from '@aglyn/aglyn/foundation/definitions/organization.types';
 import { type ReleaseFlagKey } from '@aglyn/aglyn/app-utils/release-flags';
+import { type WeeklySummaryColors, type WeeklySummaryEmail } from '@aglyn/aglyn/app-utils/weekly-summary';
 import { type ResolvedPluginFigureReader } from '@aglyn/aglyn/plugin-manager/plugin-figures';
 import { type FigureReaderContext } from './figure-readers';
 /**
  * THE WEEKLY SUMMARY'S SENDS (AGL-3867): `POST /api/admin/weekly-summary`,
  * Mondays at 13:00 UTC (08:00 Central) from `scheduled-crons.yml`.
  *
- * ## Who is told
+ * ## What is sent, and to whom
  *
- * A workspace's owners and admins: the people who reach every site and every
- * figure, so one set of figures per workspace is true for each of them. The
- * **Weekly summary** switch on their own account
- * (`users/{uid}.digestPrefs.weeklySummary`, on until turned off) governs it.
- * A locked or disabled account, a suppressed address and a suspended member
- * are not mailed.
+ * One email for each of a workspace's sites that had something to report,
+ * and a workspace overview that adds them up: totals across the sites, a line
+ * for each, and the workspace's own figures, such as its deals.
+ *
+ *  - The workspace's owners and admins get the overview and every site's
+ *    email. In a workspace where only one site had anything to report, the
+ *    overview would repeat it, so that site's email carries the workspace's
+ *    own figures instead and no overview is sent.
+ *  - A member who is an admin of a site, without being one of the
+ *    workspace's, gets that site's email: they run it.
+ *
+ * The **Weekly summary** switch on each person's account
+ * (`users/{uid}.digestPrefs.weeklySummary`, on until turned off) governs all
+ * of it. A locked or disabled account, a suppressed address and a suspended
+ * member are not mailed.
  *
  * ## What it reads
  *
@@ -38,32 +48,38 @@ import { type FigureReaderContext } from './figure-readers';
  * `weeklySummary`, and the workspace through every workspace reader that
  * does. Each reader is offered only where its plan feature is included and
  * its plugin runs (`eligibleFigureReaders`), read over the seven whole days
- * before the run, and worded by its owner. A reader that fails is left out;
- * the rest are still read.
+ * before the run, and summarized by its owner. A reader that fails is left
+ * out; the rest are still read. Every figure is read once per workspace, and
+ * every recipient is sent the same figures.
  *
  * ## Once a week, and resumable
  *
- * `orgs/{orgId}/weeklySummaries/{week}` records each person sent, stamped
- * after each send, so a run that dies mid-workspace re-sends only to those it
- * never reached and a second run in the same week sends nothing. Workspaces
- * are swept in id order behind a cursor, the `done: false` loop the workflow
- * already runs for the CRM digest.
+ * `orgs/{orgId}/weeklySummaries/{week}.sent.{uid}.{email}` records each
+ * email sent — `overview`, or a site's id — stamped after each send, so a run
+ * that dies mid-workspace sends only what never went, and a second run in the
+ * same week sends nothing. Workspaces are swept in id order behind a cursor,
+ * the `done: false` loop the workflow already runs for the CRM digest.
  *
  * The email is a `bulk` send under the platform send-rate governor: a refusal
- * stops the run and answers `done: true`, and the unsent are picked up by a
- * manual re-run in the same week. Metered as PLATFORM mail, not the
- * workspace's: it is the platform reporting to the people who run it.
+ * stops the run and answers `done: true`, and a manual re-run in the same week
+ * picks up the rest. Metered as PLATFORM mail, not the workspace's: it is the
+ * platform reporting to the people who run it.
  */
 type Firestore = FirebaseFirestore.Firestore;
 /** The beat `/api/health/crons` reads, once this job joins its inventory. */
 export declare const WEEKLY_SUMMARY_JOB_ID = "weekly-summary";
 /** `orgs/{orgId}/weeklySummaries/{week}` — server-written, matched by no rule. */
 export declare const WEEKLY_SUMMARY_MARKERS = "weeklySummaries";
+/** The marker key of the overview; a site's email is keyed by the site's id. */
+export declare const WEEKLY_SUMMARY_OVERVIEW = "overview";
+/** The system emails: the overview, and one site's. */
+export declare const WEEKLY_SUMMARY_TEMPLATE = "weekly-summary";
+export declare const WEEKLY_SUMMARY_SITE_TEMPLATE = "weekly-summary-site";
 /** Workspaces per invocation; a chunk that times out never advances its cursor. */
 export declare const WEEKLY_SUMMARY_ORG_CHUNK = 20;
 /** Sites a workspace's sweep ranks, by document id. */
 export declare const WEEKLY_SUMMARY_HOST_READ_LIMIT = 50;
-/** Sites one summary reports on: the busiest by last week's page views. */
+/** Sites a week's summary reports on: the busiest by last week's page views. */
 export declare const WEEKLY_SUMMARY_MAX_SITES = 5;
 /** Members per workspace whose address is chased through the auth pools when their member document has none. */
 export declare const WEEKLY_SUMMARY_MAX_UID_LOOKUPS = 5;
@@ -75,13 +91,10 @@ export interface WeeklySummarySendResult {
     rateLimited: boolean;
     reason?: string;
 }
-export interface WeeklySummaryEmail {
+export interface WeeklySummaryMessage {
     to: string;
-    subject: string;
-    /** The body token: the figures without the closing line the footer carries. */
-    body: string;
-    /** The plain fallback, closing line included. */
-    text: string;
+    template: typeof WEEKLY_SUMMARY_TEMPLATE | typeof WEEKLY_SUMMARY_SITE_TEMPLATE;
+    email: WeeklySummaryEmail;
     org: Record<string, unknown>;
     merge: Record<string, string>;
 }
@@ -99,11 +112,13 @@ export interface WeeklySummaryDeps {
     reachable: (uids: string[]) => Promise<string[]>;
     /** The readers that declare a `weeklySummary` and pass the gates here. */
     readers: (context: Omit<FigureReaderContext, 'accept'>) => Promise<ResolvedPluginFigureReader[]>;
+    /** The org's email colors, from its theme. */
+    colors: (org: Record<string, unknown>) => WeeklySummaryColors;
     /** The member's deliverable address, or `null` when there is none or it is suppressed. */
     address: (member: AglynOrgMember, lookups: {
         left: number;
     }) => Promise<string | null>;
-    send: (email: WeeklySummaryEmail) => Promise<WeeklySummarySendResult>;
+    send: (message: WeeklySummaryMessage) => Promise<WeeklySummarySendResult>;
     budgetMs?: number;
 }
 export interface WeeklySummaryOrgReport {
@@ -131,6 +146,7 @@ export declare function runWeeklySummarySweep(deps: WeeklySummaryDeps, options?:
     limit?: number;
 }): Promise<WeeklySummaryReport>;
 /** The sweep's reach into the real platform: Firestore, the flags, the roster, the mail. */
+/** The sweep's reach into the real platform: Firestore, the flags, the roster, the mail. */
 export declare function weeklySummaryDeps(options: {
     runAt: Date;
     dryRun: boolean;

package/src/lib/server/weekly-summary.js

@@ -14,16 +14,17 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ import { _ as _extends } from "@swc/helpers/_/_extends";
-import { brandSupportLine } from "@aglyn/aglyn/app-utils/brand-support-line";
 import { buildRoute, Route } from "@aglyn/aglyn/app-utils/console-routes";
 import { writeCronBeat } from "@aglyn/aglyn/app-utils/health-report";
 import { DIGEST_PREFS_FIELD, digestEnabled, INSIGHT_DIGESTS_FIELD, insightDigestSubscribed } from "@aglyn/aglyn/app-utils/notifications";
+import { liveCustomDomain, TENANT_APEX } from "@aglyn/aglyn/app-utils/host-naming";
+import { hostRoleFor } from "@aglyn/aglyn/app-utils/organizations";
 import { checkEntitlement, resolveBrandingProfile, resolveEffectivePlan } from "@aglyn/aglyn/app-utils/plan-entitlements";
 import { platformConsoleOrigin } from "@aglyn/aglyn/app-utils/platform-brand";
 import { isReleaseFlagOnForOrg, parseOrgReleaseFlagOverrides } from "@aglyn/aglyn/app-utils/release-flags";
-import { composeWeeklySummaryEmailText, composeWeeklySummarySubject, WEEKLY_SUMMARY_DAYS, WEEKLY_SUMMARY_DIGEST_KEY, weeklySummaryPeriod } from "@aglyn/aglyn/app-utils/weekly-summary";
+import { composeWeeklySummaryOverviewEmail, composeWeeklySummarySiteEmail, WEEKLY_SUMMARY_DAYS, WEEKLY_SUMMARY_DIGEST_KEY, weeklySummaryHasNews, weeklySummaryPeriod } from "@aglyn/aglyn/app-utils/weekly-summary";
 import { normalizePluginFigureTable, pluginFigureSummarySection } from "@aglyn/aglyn/plugin-manager/plugin-figures";
-import { rateLimitedRetryAtMs, sendEmail } from "@aglyn/shared-util-email";
+import { emailAccent, PLATFORM_EMAIL_PALETTE, rateLimitedRetryAtMs, resolveEmailColor, sendEmail } from "@aglyn/shared-util-email";
 import { withoutMailWithheldAccounts } from "./account-mail.js";
 import { findUserByUidAcrossPools } from "./auth-pools.js";
 import { isCronAuthorized, isCronDryRun } from "./cron-auth.js";
@@ -33,14 +34,27 @@ import { eligibleFigureReaders } from "./figure-readers.js";
 import firebaseAdmin from "./firebase-admin.js";
 import { listOrgMembers } from "./organizations.js";
 import { getServerReleaseFlagValues } from "./release-flags.js";
-import { loadSystemEmail, renderLoadedSystemEmail, systemEmailBrand, systemEmailContent } from "./render-system-email.js";
+import { loadSystemEmail, renderLoadedSystemEmail, systemEmailBrand, systemEmailContent, systemEmailTheme } from "./render-system-email.js";
 /** The beat `/api/health/crons` reads, once this job joins its inventory. */ export const WEEKLY_SUMMARY_JOB_ID = 'weekly-summary';
 /** `orgs/{orgId}/weeklySummaries/{week}` — server-written, matched by no rule. */ export const WEEKLY_SUMMARY_MARKERS = 'weeklySummaries';
+/** The marker key of the overview; a site's email is keyed by the site's id. */ export const WEEKLY_SUMMARY_OVERVIEW = 'overview';
+/** The system emails: the overview, and one site's. */ export const WEEKLY_SUMMARY_TEMPLATE = 'weekly-summary';
+export const WEEKLY_SUMMARY_SITE_TEMPLATE = 'weekly-summary-site';
 /** Workspaces per invocation; a chunk that times out never advances its cursor. */ export const WEEKLY_SUMMARY_ORG_CHUNK = 20;
 /** Sites a workspace's sweep ranks, by document id. */ export const WEEKLY_SUMMARY_HOST_READ_LIMIT = 50;
-/** Sites one summary reports on: the busiest by last week's page views. */ export const WEEKLY_SUMMARY_MAX_SITES = 5;
+/** Sites a week's summary reports on: the busiest by last week's page views. */ export const WEEKLY_SUMMARY_MAX_SITES = 5;
 /** Members per workspace whose address is chased through the auth pools when their member document has none. */ export const WEEKLY_SUMMARY_MAX_UID_LOOKUPS = 5;
 /** How long one call works before it stops and leaves the rest to the next. */ export const WEEKLY_SUMMARY_RUN_BUDGET_MS = 45000;
+/** The theme tokens each color of the layout is drawn from. */ const COLOR_TOKENS = {
+    text: 'text.primary',
+    muted: 'text.secondary',
+    border: 'divider',
+    surface: 'grey.50',
+    accent: 'primary.main',
+    link: 'primary.main',
+    up: 'success.dark',
+    down: 'error.dark'
+};
 const str = (value)=>typeof value === 'string' ? value.trim() : '';
 function siteName(data, id) {
     return str(data['displayName']) || str(data['name']) || str(data['subdomain']) || id;
@@ -65,23 +79,23 @@ function weekDays(from) {
     }, (_, index)=>new Date(start + index * 86400000).toISOString().slice(0, 10));
 }
 /**
- * Each reader's entry, in its declared order: read over the week, then worded
- * by its owner. A reader that fails, answers no table or cannot be read over
- * seven days is left out.
- */ async function readEntries(readers, base) {
+ * Each reader's part, in its declared order: read over the week, then
+ * summarized by its owner. A reader that fails, answers no table, has nothing
+ * to say or cannot be read over seven days is left out.
+ */ async function readParts(readers, base) {
     const ordered = readers.filter(({ reader })=>reader.weeklySummary).sort((a, b)=>{
         var _ref, _ref1;
         var _a_reader_weeklySummary, _b_reader_weeklySummary;
         return ((_ref = (_a_reader_weeklySummary = a.reader.weeklySummary) == null ? void 0 : _a_reader_weeklySummary.order) != null ? _ref : 0) - ((_ref1 = (_b_reader_weeklySummary = b.reader.weeklySummary) == null ? void 0 : _b_reader_weeklySummary.order) != null ? _ref1 : 0) || a.reader.id.localeCompare(b.reader.id);
     });
-    const entries = [];
+    const parts = [];
     for (const { reader } of ordered){
         const summary = reader.weeklySummary;
         if (!summary) continue;
         const days = reader.windows.length ? reader.windows.includes(WEEKLY_SUMMARY_DAYS) ? WEEKLY_SUMMARY_DAYS : null : 0;
         if (days === null) continue;
         try {
-            var _ref;
+            var _part_stats, _part_rows;
             const read = await reader.read(_extends({}, base, {
                 days,
                 uid: null,
@@ -90,10 +104,8 @@ function weekDays(from) {
             if (read.ok === false) continue;
             const table = normalizePluginFigureTable(read.table);
             if (!table) continue;
-            entries.push({
-                lines: summary.lines(table),
-                headline: (_ref = summary.headline == null ? void 0 : summary.headline.call(summary, table)) != null ? _ref : null
-            });
+            const part = summary.summarize(table);
+            if (part && (((_part_stats = part.stats) == null ? void 0 : _part_stats.length) || ((_part_rows = part.rows) == null ? void 0 : _part_rows.length))) parts.push(part);
         } catch (error) {
             console.error('[weekly-summary] reader failed', {
                 reader: reader.id,
@@ -102,10 +114,45 @@ function weekDays(from) {
             });
         }
     }
-    return entries;
+    return parts;
+}
+/** The emails one person is owed this week, by marker key, in the order they are sent. */ function emailsFor(member, manager, sites, workspace) {
+    const active = sites.filter(({ site })=>weeklySummaryHasNews(site));
+    if (!manager) {
+        return active.filter(({ hostId })=>hostRoleFor(member, hostId) === 'admin').map(({ hostId })=>({
+                key: hostId,
+                hostId,
+                withWorkspace: false
+            }));
+    }
+    // One active site: its email carries the workspace's figures, and an
+    // overview would only say it again.
+    if (active.length === 1) {
+        return [
+            {
+                key: active[0].hostId,
+                hostId: active[0].hostId,
+                withWorkspace: true
+            }
+        ];
+    }
+    return [
+        ...active.length || workspace.length ? [
+            {
+                key: WEEKLY_SUMMARY_OVERVIEW,
+                hostId: null,
+                withWorkspace: false
+            }
+        ] : [],
+        ...active.map(({ hostId })=>({
+                key: hostId,
+                hostId,
+                withWorkspace: false
+            }))
+    ];
 }
 async function summarizeOrg(deps, orgDoc, period, overBudget) {
-    var _orgDoc_data, _get;
+    var _orgDoc_data, _get, _sites_find;
     const { firestore } = deps;
     const orgId = orgDoc.id;
     const org = (_orgDoc_data = orgDoc.data()) != null ? _orgDoc_data : {};
@@ -116,19 +163,25 @@ async function summarizeOrg(deps, orgDoc, period, overBudget) {
     };
     const markerRef = orgDoc.ref.collection(WEEKLY_SUMMARY_MARKERS).doc(period.week);
     const sentAlready = (_get = (await markerRef.get()).get('sent')) != null ? _get : {};
-    // Owners and admins, not suspended, whose accounts may be mailed, who kept the switch on.
-    const managers = (await deps.orgMembers(orgId)).filter((member)=>(member.role === 'owner' || member.role === 'admin') && member.orgSuspended !== true);
-    const reachable = new Set(await deps.reachable(managers.map((member)=>member.$id)));
-    const candidates = managers.filter((member)=>reachable.has(member.$id) && !sentAlready[member.$id]).sort((a, b)=>a.$id.localeCompare(b.$id));
-    if (!candidates.length) return _extends({}, report, {
-        skipped: managers.length ? 'nobody-left' : 'no-managers'
+    // Who could be told: owners and admins, and each site's own admins. Not
+    // suspended, an account that may be mailed, the switch kept on.
+    const members = (await deps.orgMembers(orgId)).filter((member)=>member.orgSuspended !== true);
+    const isManager = (member)=>member.role === 'owner' || member.role === 'admin';
+    const candidates = members.filter((member)=>{
+        var _member_hostAccess;
+        return isManager(member) || Object.values((_member_hostAccess = member.hostAccess) != null ? _member_hostAccess : {}).includes('admin');
     });
-    const userDocs = await firestore.getAll(...candidates.map((member)=>firestore.collection('users').doc(member.$id)));
+    const reachable = new Set(await deps.reachable(candidates.map((member)=>member.$id)));
+    const reached = candidates.filter((member)=>reachable.has(member.$id)).sort((a, b)=>a.$id.localeCompare(b.$id));
+    if (!reached.length) return _extends({}, report, {
+        skipped: candidates.length ? 'nobody-reachable' : 'no-managers'
+    });
+    const userDocs = await firestore.getAll(...reached.map((member)=>firestore.collection('users').doc(member.$id)));
     const users = new Map(userDocs.map((doc)=>[
             doc.id,
             doc
         ]));
-    const recipients = candidates.filter((member)=>{
+    const recipients = reached.filter((member)=>{
         var _users_get;
         return digestEnabled((_users_get = users.get(member.$id)) == null ? void 0 : _users_get.get(DIGEST_PREFS_FIELD), WEEKLY_SUMMARY_DIGEST_KEY);
     });
@@ -149,7 +202,7 @@ async function summarizeOrg(deps, orgDoc, period, overBudget) {
     const orgSlug = str(org['slug']);
     const sites = [];
     for (const host of chosen){
-        var _host_data;
+        var _host_data, _liveCustomDomain;
         const data = (_host_data = host.data()) != null ? _host_data : {};
         const readers = (await deps.readers({
             orgId,
@@ -157,19 +210,28 @@ async function summarizeOrg(deps, orgDoc, period, overBudget) {
             org,
             host: data
         })).filter(({ reader })=>pluginFigureSummarySection(reader) === 'site');
-        const entries = await readEntries(readers, {
+        const parts = await readParts(readers, {
             orgId,
             hostId: host.id,
             now: period.now
         });
         const subdomain = str(data['subdomain']);
+        const domain = (_liveCustomDomain = liveCustomDomain(data)) != null ? _liveCustomDomain : subdomain ? `${subdomain}.${TENANT_APEX}` : '';
         sites.push({
-            name: siteName(data, host.id),
-            url: deps.origin && orgSlug && subdomain ? `${deps.origin}${buildRoute(Route.HOST_DASHBOARD, {
-                orgSlug,
-                host: subdomain
-            })}` : null,
-            entries
+            hostId: host.id,
+            subdomain,
+            site: {
+                name: siteName(data, host.id),
+                address: domain ? {
+                    label: domain,
+                    url: `https://${domain}`
+                } : null,
+                url: deps.origin && orgSlug && subdomain ? `${deps.origin}${buildRoute(Route.HOST_DASHBOARD, {
+                    orgSlug,
+                    host: subdomain
+                })}` : null,
+                parts
+            }
         });
     }
     const orgReaders = await deps.readers({
@@ -178,98 +240,108 @@ async function summarizeOrg(deps, orgDoc, period, overBudget) {
         org,
         host: null
     });
-    const workspace = await readEntries(orgReaders.filter(({ reader })=>pluginFigureSummarySection(reader) === 'workspace'), {
+    const workspace = await readParts(orgReaders.filter(({ reader })=>pluginFigureSummarySection(reader) === 'workspace'), {
         orgId,
         hostId: null,
         now: period.now
     });
+    report.sites = sites.filter(({ site })=>weeklySummaryHasNews(site)).length;
+    if (!report.sites && !workspace.length) return _extends({}, report, {
+        skipped: 'nothing-to-report'
+    });
     const branding = resolveBrandingProfile(org);
     const workspaceName = str(org['name']) || orgSlug || 'your workspace';
     const settingsUrl = `${deps.origin}${buildRoute(Route.MANAGE_NOTIFICATION_SETTINGS)}`;
+    const colors = deps.colors(org);
     // AI weekly insights, pointed to only where the plan includes them and they are released.
     const offersInsights = checkEntitlement(org, 'aiGenerative') && deps.flagOn('release_ai_generative', orgId, org);
-    const busiest = chosen[0];
-    const analyticsUrl = offersInsights && deps.origin && orgSlug && busiest && str(busiest.get('subdomain')) ? `${deps.origin}${buildRoute(Route.HOST_ANALYTICS, {
-        orgSlug,
-        host: str(busiest.get('subdomain'))
-    })}` : null;
-    const supportLine = brandSupportLine(branding);
-    const subject = composeWeeklySummarySubject(workspaceName, sites);
-    const input = {
+    const analyticsUrl = (subdomain)=>offersInsights && deps.origin && orgSlug && subdomain ? `${deps.origin}${buildRoute(Route.HOST_ANALYTICS, {
+            orgSlug,
+            host: subdomain
+        })}` : null;
+    const common = {
         workspaceName,
         productName: branding.productName,
         periodLabel: period.label,
-        sites,
-        workspace,
+        colors,
         settingsUrl
     };
-    report.sites = sites.length;
     const lookups = {
         left: WEEKLY_SUMMARY_MAX_UID_LOOKUPS
     };
-    if (!composeWeeklySummaryEmailText(_extends({}, input, {
-        aiInsightsUrl: null
-    }))) {
-        return _extends({}, report, {
-            skipped: 'nothing-to-report'
-        });
-    }
+    const busiest = (_sites_find = sites.find(({ site })=>weeklySummaryHasNews(site))) != null ? _sites_find : sites[0];
     for (const member of recipients){
-        var _composeWeeklySummaryEmailText, _composeWeeklySummaryEmailText1;
         var _users_get;
-        if (overBudget()) return _extends({}, report, {
-            deferred: 'time'
+        const owed = emailsFor(member, isManager(member), sites, workspace).filter(({ key })=>{
+            var _sentAlready_member_$id;
+            return !((_sentAlready_member_$id = sentAlready[member.$id]) == null ? void 0 : _sentAlready_member_$id[key]);
         });
+        if (!owed.length) continue;
         const subscribed = insightDigestSubscribed((_users_get = users.get(member.$id)) == null ? void 0 : _users_get.get(INSIGHT_DIGESTS_FIELD), orgId);
-        const aiInsightsUrl = analyticsUrl && !subscribed ? analyticsUrl : null;
-        const body = (_composeWeeklySummaryEmailText = composeWeeklySummaryEmailText(_extends({}, input, {
-            aiInsightsUrl,
-            omitClosing: true
-        }))) != null ? _composeWeeklySummaryEmailText : '';
-        if (deps.dryRun) {
-            report.sent += 1;
-            continue;
-        }
-        const to = await deps.address(member, lookups);
-        if (!to) continue;
-        const text = [
-            (_composeWeeklySummaryEmailText1 = composeWeeklySummaryEmailText(_extends({}, input, {
-                aiInsightsUrl
-            }))) != null ? _composeWeeklySummaryEmailText1 : body,
-            supportLine
-        ].filter(Boolean).join('\n\n');
-        const result = await deps.send({
-            to,
-            subject,
-            body,
-            text,
-            org,
-            merge: {
-                'summary.subject': subject,
-                'org.name': workspaceName,
-                'summary.period': period.label,
-                'summary.body': body,
-                settingsUrl
-            }
-        });
-        if (result.sent) {
-            report.sent += 1;
-            await markerRef.set({
-                week: period.week,
-                sent: {
-                    [member.$id]: true
-                },
-                updatedAt: firebaseAdmin.firestore.FieldValue.serverTimestamp()
-            }, {
-                merge: true
+        const to = deps.dryRun ? '' : await deps.address(member, lookups);
+        if (!deps.dryRun && !to) continue;
+        for (const { key, hostId, withWorkspace } of owed){
+            var _ref, _ref1;
+            if (overBudget()) return _extends({}, report, {
+                deferred: 'time'
             });
-        } else if (result.rateLimited) {
-            return _extends({}, report, {
-                deferred: 'rate'
+            const entry = hostId ? sites.find((site)=>site.hostId === hostId) : null;
+            const aiInsightsUrl = subscribed ? null : analyticsUrl((_ref = (_ref1 = entry == null ? void 0 : entry.subdomain) != null ? _ref1 : busiest == null ? void 0 : busiest.subdomain) != null ? _ref : '');
+            const email = entry ? composeWeeklySummarySiteEmail(_extends({}, common, {
+                aiInsightsUrl,
+                site: entry.site
+            }, withWorkspace ? {
+                workspace
+            } : {})) : composeWeeklySummaryOverviewEmail(_extends({}, common, {
+                aiInsightsUrl,
+                sites: sites.map(({ site })=>site),
+                workspace,
+                url: deps.origin && orgSlug ? `${deps.origin}${buildRoute(Route.ORG_HOME, {
+                    orgSlug
+                })}` : ''
+            }));
+            if (!email) continue;
+            if (deps.dryRun) {
+                report.sent += 1;
+                continue;
+            }
+            const result = await deps.send({
+                to: to,
+                template: entry ? WEEKLY_SUMMARY_SITE_TEMPLATE : WEEKLY_SUMMARY_TEMPLATE,
+                email,
+                org,
+                merge: {
+                    'summary.subject': email.subject,
+                    'summary.title': email.title,
+                    'summary.period': email.period,
+                    'summary.html': email.html,
+                    'summary.buttonLabel': email.buttonLabel,
+                    'summary.url': email.url,
+                    'org.name': workspaceName,
+                    settingsUrl
+                }
             });
-        } else {
-            var _report_failed;
-            report.failed = ((_report_failed = report.failed) != null ? _report_failed : 0) + 1;
+            if (result.sent) {
+                report.sent += 1;
+                await markerRef.set({
+                    week: period.week,
+                    sent: {
+                        [member.$id]: {
+                            [key]: true
+                        }
+                    },
+                    updatedAt: firebaseAdmin.firestore.FieldValue.serverTimestamp()
+                }, {
+                    merge: true
+                });
+            } else if (result.rateLimited) {
+                return _extends({}, report, {
+                    deferred: 'rate'
+                });
+            } else {
+                var _report_failed;
+                report.failed = ((_report_failed = report.failed) != null ? _report_failed : 0) + 1;
+            }
         }
     }
     return report;
@@ -340,11 +412,11 @@ async function summarizeOrg(deps, orgDoc, period, overBudget) {
     }
     return report;
 }
-/** The sweep's reach into the real platform: Firestore, the flags, the roster, the mail. */ export async function weeklySummaryDeps(options) {
+/** The sweep's reach into the real platform: Firestore, the flags, the roster, the mail. */ /** The sweep's reach into the real platform: Firestore, the flags, the roster, the mail. */ export async function weeklySummaryDeps(options) {
     const firestore = firebaseAdmin.app().firestore();
     const flags = await getServerReleaseFlagValues();
-    // The designed email is read once per call and rendered per recipient.
-    let loaded;
+    // Each designed email is read once per call and rendered per recipient.
+    const loaded = new Map();
     return {
         firestore,
         runAt: options.runAt,
@@ -356,6 +428,20 @@ async function summarizeOrg(deps, orgDoc, period, overBudget) {
         readers: (context)=>eligibleFigureReaders(_extends({}, context, {
                 accept: (reader)=>Boolean(reader.weeklySummary)
             })),
+        colors: (org)=>{
+            const { palette } = systemEmailTheme(systemEmailBrand(org).options);
+            const colors = {};
+            for (const key of Object.keys(COLOR_TOKENS)){
+                var _ref, _resolveEmailColor;
+                // A brand palette that cannot resolve a token falls back to the
+                // platform's, which resolves every one of them.
+                colors[key] = (_ref = (_resolveEmailColor = resolveEmailColor(COLOR_TOKENS[key], palette)) != null ? _resolveEmailColor : resolveEmailColor(COLOR_TOKENS[key], PLATFORM_EMAIL_PALETTE)) != null ? _ref : 'inherit';
+            }
+            // Links take the color the renderer gives every other link in the
+            // email, not the raw primary, which is too light to read as text.
+            colors.link = emailAccent(palette).link;
+            return colors;
+        },
         address: async (member, lookups)=>{
             let address = str(member.email).toLowerCase();
             if (!address.includes('@') && lookups.left > 0) {
@@ -370,22 +456,25 @@ async function summarizeOrg(deps, orgDoc, period, overBudget) {
             ], firestore);
             return kept != null ? kept : null;
         },
-        send: async (email)=>{
+        send: async ({ to, template, email, org, merge })=>{
             var _result_reason;
-            loaded != null ? loaded : loaded = loadSystemEmail('weekly-summary').catch(()=>null);
-            const template = await loaded;
-            const brand = systemEmailBrand(email.org);
-            const rendered = template ? renderLoadedSystemEmail(template, _extends({}, brand.merge, email.merge), brand.options) : null;
+            if (!loaded.has(template)) loaded.set(template, loadSystemEmail(template).catch(()=>null));
+            const design = await loaded.get(template);
+            const brand = systemEmailBrand(org);
+            const rendered = design ? renderLoadedSystemEmail(design, _extends({}, brand.merge, merge), brand.options) : null;
+            const content = systemEmailContent(rendered, {
+                subject: email.subject,
+                text: email.text
+            });
             const result = await sendEmail(_extends({
                 to: [
-                    email.to
+                    to
                 ]
-            }, systemEmailContent(rendered, {
-                subject: email.subject,
-                text: email.text
-            }), {
-                fromName: resolveBrandingProfile(email.org).fromName,
-                context: 'weekly-summary',
+            }, content, {
+                // The figures' plain text, rather than the drawn block with its tags stripped.
+                text: email.text,
+                fromName: resolveBrandingProfile(org).fromName,
+                context: template,
                 priority: 'bulk'
             }));
             if (result.sent) {