@reddoorla/maintenance 0.40.0 → 0.42.0

package/dist/cli/bin.js

@@ -118,6 +118,7 @@ __export(websites_exports, {
   isDashboardVisible: () => isDashboardVisible,
   listWebsites: () => listWebsites,
   mapRow: () => mapRow,
+  parseNotifyRouting: () => parseNotifyRouting,
   siteSlug: () => siteSlug,
   updateA11yCounts: () => updateA11yCounts,
   updateAuditFields: () => updateAuditFields,
@@ -135,6 +136,28 @@ function trimToNull(raw) {
   const trimmed = raw.trim();
   return trimmed.length > 0 ? trimmed : null;
 }
+function parseNotifyRouting(raw) {
+  if (typeof raw !== "string") return null;
+  const trimmed = raw.trim();
+  if (!trimmed) return null;
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
+  const o = parsed;
+  if (typeof o.field !== "string" || !o.field.trim()) return null;
+  if (!o.routes || typeof o.routes !== "object" || Array.isArray(o.routes)) return null;
+  const routing = {
+    field: o.field,
+    routes: o.routes
+  };
+  if (o.default !== void 0) routing.default = o.default;
+  if (Array.isArray(o.cc)) routing.cc = o.cc.filter((x) => typeof x === "string");
+  return routing;
+}
 function isDashboardVisible(site) {
   return site.status !== null && ACTIVE_STATUSES.has(site.status);
 }
@@ -177,6 +200,7 @@ function mapRow(rec) {
     copyFooter: trimToNull(f["Copy \u2014 Footer"]),
     launchedAt: f["Launched at"] ?? null,
     newsletterWebhook: trimToNull(f["Newsletter Webhook"]),
+    notifyRouting: parseNotifyRouting(f["Notify Routing"]),
     mailchimpApiKey: trimToNull(f["Mailchimp API Key"]),
     mailchimpAudienceId: trimToNull(f["Mailchimp Audience ID"]),
     renovateFailingCis: f["Renovate Failing CIs"] ?? null,
@@ -627,6 +651,7 @@ async function createDraft(base, input) {
   if (input.searchFoundPage1 !== void 0) fields["Search found page 1"] = input.searchFoundPage1;
   if (input.searchPosition !== void 0) fields["Search position"] = input.searchPosition;
   if (input.period !== void 0) fields["Period"] = input.period;
+  if (input.subjectOverride !== void 0) fields["Subject override"] = input.subjectOverride;
   const created = await base(REPORTS_TABLE).create([{ fields }]);
   const rec = created[0];
   if (!rec) throw new Error("Airtable create returned no records");
@@ -693,7 +718,7 @@ var init_reports = __esm({
   "src/reports/airtable/reports.ts"() {
     "use strict";
     REPORTS_TABLE = "Reports";
-    REPORT_TYPES = ["Maintenance", "Testing", "Launch"];
+    REPORT_TYPES = ["Maintenance", "Testing", "Launch", "Announcement"];
   }
 });
 
@@ -753,7 +778,15 @@ var init_copy = __esm({
         "Hosting, DNS, and SSL configured",
         "Continuous integration + automatic dependency updates",
         "Analytics and uptime monitoring"
-      ]
+      ],
+      announceHeading: "YOUR MONTHLY REPORT",
+      announceBody: "We've set up ongoing monitoring and maintenance for your site. Each month we quietly check that everything's healthy and up to date \u2014 and now you'll get a short report so you can see it at a glance.",
+      announceMonitorItems: ["Performance", "Accessibility", "Security", "Uptime"],
+      announcePreviewLabel: "A snapshot of your latest scores:",
+      announceImprovementResend: "Your contact forms now deliver straight to your inbox through reliable infrastructure, so no inquiry slips through the cracks.",
+      announceImprovementSvelte5: "We've modernized your site to the latest framework \u2014 it's faster, more secure, and built to last.",
+      announceCadence: "You'll receive this every month. There's nothing you need to do.",
+      announceOpenDoor: "And if you'd ever like to expand the scope, add features, or freshen anything up, just reply \u2014 we'd love to help."
     };
   }
 });
@@ -1090,10 +1123,115 @@ var init_template2 = __esm({
   }
 });
 
+// src/reports/announcement-email/template.ts
+function buildAnnouncementMjml(data) {
+  const copy = data.copy ?? DEFAULT_COPY;
+  const previewText = "Your monthly report from Reddoor";
+  const improvementItems = [];
+  if (data.improvements?.resendForms) improvementItems.push(copy.announceImprovementResend);
+  if (data.improvements?.svelte5) improvementItems.push(copy.announceImprovementSvelte5);
+  const improvementsSection = improvementItems.length > 0 ? `
+    <mj-section background-color="white">
+      <mj-column>
+        <mj-text color="${RED2}" font-size="20px" font-weight="700" padding-top="36px">RECENT IMPROVEMENTS</mj-text>
+        ${improvementItems.map(
+    (item) => `
+        <mj-text color="${GREY2}" font-family="helvetica, sans-serif" font-size="16px" font-weight="300" line-height="24px" padding-top="4px" padding-bottom="4px">\u2022 ${escapeXml(item)}</mj-text>`
+  ).join("")}
+      </mj-column>
+    </mj-section>` : "";
+  const monitorRows = copy.announceMonitorItems.map(
+    (item) => `
+        <mj-text color="${GREY2}" font-family="helvetica, sans-serif" font-size="16px" font-weight="300" line-height="24px" padding-top="4px" padding-bottom="4px">\u2022 ${escapeXml(item)}</mj-text>`
+  ).join("");
+  const scoreRows = SCORE_PREVIEW.map(
+    ({ label, key }) => `
+        <mj-text color="${RED2}" font-size="20px" font-weight="300" padding-top="25px">${label}</mj-text>
+        <mj-text color="${RED2}" font-size="44px" font-weight="400" padding-top="0px">${data.lighthouse[key]}</mj-text>`
+  ).join("");
+  const contactRows = copy.contact.map(
+    (line) => `
+      <mj-text font-family="helvetica, sans-serif" font-size="24px" font-weight="300" line-height="30px">${escapeXml(line)}</mj-text>`
+  ).join("");
+  const footerAddressRows = copy.footerAddress.map(
+    (line) => `
+      <mj-text color="${GREY2}" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" line-height="16px" padding-top="0" padding-bottom="0px">${escapeXml(line)}</mj-text>`
+  ).join("");
+  return `<mjml>
+  <mj-head>
+    <mj-attributes>
+      <mj-text font-family="helvetica, sans-serif" padding-left="5px" padding-right="5px" />
+      <mj-section padding-left="11%" padding-right="11%"/>
+      <mj-image padding="0px" />
+    </mj-attributes>
+    <mj-preview>${escapeXml(previewText)}</mj-preview>
+    ${headerStyleBlock(data)}
+  </mj-head>
+  <mj-body background-color="white">
+    <mj-section background-color="#F4F4F4" padding-top="0px" padding-bottom="0px" padding-left="0px" padding-right="0px">
+      <mj-column>${headerImageTag(data)}</mj-column>
+    </mj-section>
+    <mj-section background-color="white">
+      <mj-column>
+        <mj-text color="${RED2}" font-size="20px" font-weight="700" padding-top="75px">${escapeXml(copy.announceHeading)}</mj-text>
+        <mj-text color="${GREY2}" font-family="helvetica, sans-serif" font-size="16px" font-weight="300" line-height="24px" padding-top="20px">Prepared for ${escapeXml(data.siteName)}</mj-text>
+        <mj-text color="${GREY2}" font-family="helvetica, sans-serif" font-size="16px" font-weight="300" line-height="24px" padding-top="8px">${escapeXml(copy.announceBody)}</mj-text>
+      </mj-column>
+    </mj-section>
+    ${improvementsSection}
+    <mj-section background-color="white">
+      <mj-column>
+        <mj-text color="${RED2}" font-size="20px" font-weight="700" padding-top="36px">WHAT WE MONITOR</mj-text>
+        ${monitorRows}
+      </mj-column>
+    </mj-section>
+    <mj-section background-color="#F4F4F4">
+      <mj-column>
+        <mj-text color="${RED2}" font-size="20px" font-weight="700" padding-top="55px">${escapeXml(copy.announcePreviewLabel)}</mj-text>
+        ${scoreRows}
+      </mj-column>
+    </mj-section>
+    <mj-section background-color="white">
+      <mj-column>
+        <mj-text color="${GREY2}" font-family="helvetica, sans-serif" font-size="16px" font-weight="300" line-height="24px" padding-top="36px">${escapeXml(copy.announceCadence)}</mj-text>
+        <mj-text color="${GREY2}" font-family="helvetica, sans-serif" font-size="16px" font-weight="300" line-height="24px" padding-top="8px">${escapeXml(copy.announceOpenDoor)}</mj-text>
+      </mj-column>
+    </mj-section>
+    <mj-section background-color="white">
+      <mj-column padding-top="36px">
+        <mj-text color="${RED2}" font-family="helvetica, sans-serif" font-size="24px" font-weight="700" padding-top="36px" line-height="36px">Any questions, concerns or requests?</mj-text>
+        ${contactRows}
+        <mj-divider border-width="1px" border-style="solid" border-color="#CCCCCC" padding="0" />
+        <mj-text color="${GREY2}" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" padding-top="24px" line-height="20px" font-style="italic">Copyright ${(/* @__PURE__ */ new Date()).getUTCFullYear()} ${escapeXml(copy.footerOrg)}. All rights reserved.</mj-text>
+        <mj-text color="${GREY2}" font-family="helvetica, sans-serif" font-size="12px" font-weight="700" line-height="16px" padding-top="0" padding-bottom="0px">Our mailing address is:</mj-text>
+        <mj-text color="${GREY2}" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" line-height="16px" padding-top="0" padding-bottom="0px">${escapeXml(copy.footerOrg)}</mj-text>
+        ${footerAddressRows}
+      </mj-column>
+    </mj-section>
+  </mj-body>
+</mjml>`;
+}
+var RED2, GREY2, SCORE_PREVIEW;
+var init_template3 = __esm({
+  "src/reports/announcement-email/template.ts"() {
+    "use strict";
+    init_copy();
+    init_template();
+    RED2 = "#C00";
+    GREY2 = "#757575";
+    SCORE_PREVIEW = [
+      { label: "Performance", key: "performance" },
+      { label: "Readability", key: "accessibility" },
+      { label: "Best Practices", key: "bestPractices" },
+      { label: "Site Structure", key: "seo" }
+    ];
+  }
+});
+
 // src/reports/render.ts
 import mjml2html from "mjml";
 async function renderReportHtml(data) {
-  const mjml = data.reportType === "Launch" ? buildLaunchMjml(data) : buildMjml(data);
+  const mjml = data.reportType === "Launch" ? buildLaunchMjml(data) : data.reportType === "Announcement" ? buildAnnouncementMjml(data) : buildMjml(data);
   const out = await mjml2html(mjml, { validationLevel: "strict" });
   return { html: out.html, warnings: out.errors ?? [] };
 }
@@ -1102,6 +1240,7 @@ var init_render = __esm({
     "use strict";
     init_template();
     init_template2();
+    init_template3();
   }
 });
 
@@ -1395,16 +1534,16 @@ __export(digest_exports, {
   runDigest: () => runDigest
 });
 function readySection(items) {
-  const heading = `<h2 style="color:${RED2};font-family:helvetica,sans-serif;font-size:20px;font-weight:700;margin:32px 0 8px">Ready for your yes</h2>`;
+  const heading = `<h2 style="color:${RED3};font-family:helvetica,sans-serif;font-size:20px;font-weight:700;margin:32px 0 8px">Ready for your yes</h2>`;
   if (items.length === 0) {
-    return `${heading}<p style="color:${GREY2};font-family:helvetica,sans-serif;font-size:16px;margin:0">Nothing waiting on you.</p>`;
+    return `${heading}<p style="color:${GREY3};font-family:helvetica,sans-serif;font-size:16px;margin:0">Nothing waiting on you.</p>`;
   }
   const rows = items.map((it) => {
     const safeUrl = it.dashboardUrl.startsWith("https://") ? it.dashboardUrl : void 0;
     const link = safeUrl ? `<a href="${escapeHtml(safeUrl)}" style="${ANCHOR_STYLE}">review &amp; approve</a>` : `review &amp; approve`;
     return `
       <tr>
-        <td style="color:${GREY2};font-family:helvetica,sans-serif;font-size:16px;line-height:24px;padding-bottom:8px">
+        <td style="color:${GREY3};font-family:helvetica,sans-serif;font-size:16px;line-height:24px;padding-bottom:8px">
           <strong style="color:#222">${escapeHtml(it.siteName)}</strong> \u2014 ${escapeHtml(it.reportType)} (${escapeHtml(it.period)})
           \u2014 ${link}
         </td>
@@ -1414,15 +1553,15 @@ function readySection(items) {
 }
 function attentionBadge(status) {
   if (status === "new")
-    return `<strong style="color:${RED2};font-family:helvetica,sans-serif">NEW</strong> `;
+    return `<strong style="color:${RED3};font-family:helvetica,sans-serif">NEW</strong> `;
   if (status === "worse")
-    return `<strong style="color:${RED2};font-family:helvetica,sans-serif">WORSE</strong> `;
+    return `<strong style="color:${RED3};font-family:helvetica,sans-serif">WORSE</strong> `;
   return "";
 }
 function attentionSection(items) {
-  const heading = `<h2 style="color:${RED2};font-family:helvetica,sans-serif;font-size:20px;font-weight:700;margin:32px 0 8px">Needs attention</h2>`;
+  const heading = `<h2 style="color:${RED3};font-family:helvetica,sans-serif;font-size:20px;font-weight:700;margin:32px 0 8px">Needs attention</h2>`;
   if (items.length === 0) {
-    return `${heading}<p style="color:${GREY2};font-family:helvetica,sans-serif;font-size:16px;margin:0">All clear \u2014 nothing needs attention.</p>`;
+    return `${heading}<p style="color:${GREY3};font-family:helvetica,sans-serif;font-size:16px;margin:0">All clear \u2014 nothing needs attention.</p>`;
   }
   const bySite = /* @__PURE__ */ new Map();
   for (const it of items) {
@@ -1439,7 +1578,7 @@ function attentionSection(items) {
       const titleHtml = safeUrl ? `<a href="${escapeHtml(safeUrl)}" style="${ANCHOR_STYLE}">${escapeHtml(it.title)}</a>` : escapeHtml(it.title);
       return `
           <tr>
-            <td style="color:${GREY2};font-family:helvetica,sans-serif;font-size:16px;line-height:24px;padding-bottom:8px">${attentionBadge(it.status)}${titleHtml}</td>
+            <td style="color:${GREY3};font-family:helvetica,sans-serif;font-size:16px;line-height:24px;padding-bottom:8px">${attentionBadge(it.status)}${titleHtml}</td>
           </tr>`;
     }).join("");
     return `
@@ -1564,7 +1703,7 @@ function renderDigestHtml(sections) {
           <table width="600" style="border-collapse:collapse">
             <tr>
               <td>
-                <h1 style="color:${RED2};font-family:helvetica,sans-serif;font-size:24px;font-weight:700;margin:0 0 8px">Your fleet today</h1>
+                <h1 style="color:${RED3};font-family:helvetica,sans-serif;font-size:24px;font-weight:700;margin:0 0 8px">Your fleet today</h1>
                 ${readySection(sections.readyForYourYes)}
                 ${attentionSection(sections.needsAttention)}
               </td>
@@ -1576,7 +1715,7 @@ function renderDigestHtml(sections) {
   </body>
 </html>`;
 }
-var GREY2, RED2, ANCHOR_STYLE, SEVERITY_ORDER, FROM_ADDRESS, DIGEST_OPERATOR_FALLBACK;
+var GREY3, RED3, ANCHOR_STYLE, SEVERITY_ORDER, FROM_ADDRESS, DIGEST_OPERATOR_FALLBACK;
 var init_digest = __esm({
   "src/reports/digest.ts"() {
     "use strict";
@@ -1588,9 +1727,9 @@ var init_digest = __esm({
     init_digest_collectors();
     init_digest_state();
     init_html();
-    GREY2 = "#757575";
-    RED2 = "#C00";
-    ANCHOR_STYLE = `color:${RED2};font-family:helvetica,sans-serif`;
+    GREY3 = "#757575";
+    RED3 = "#C00";
+    ANCHOR_STYLE = `color:${RED3};font-family:helvetica,sans-serif`;
     SEVERITY_ORDER = { critical: 0, warning: 1 };
     FROM_ADDRESS = "Reddoor Reports <reports@reddoorla.com>";
     DIGEST_OPERATOR_FALLBACK = "info@reddoorla.com";
@@ -6187,6 +6326,127 @@ async function runLaunchCommand(site, opts) {
   return { output: formatResult9(result), code: result.complete ? 0 : 1 };
 }
 
+// src/recipes/announce.ts
+init_client();
+init_websites();
+init_reports();
+init_attachments();
+init_render();
+init_copy();
+async function announce(deps) {
+  const base = deps?.base ?? openBase(readAirtableConfig());
+  const now = deps?.now ?? /* @__PURE__ */ new Date();
+  const websites = await listWebsites(base);
+  let targets = websites.filter((w) => w.status === "maintenance");
+  if (deps?.site) {
+    const wanted = siteSlug(deps.site);
+    targets = targets.filter((w) => siteSlug(w.name) === wanted);
+  }
+  const period = now.toISOString().slice(0, 7);
+  const results = [];
+  for (const w of targets) {
+    try {
+      const scores = scoresFromRow(w);
+      if (scores === null) {
+        results.push({ site: w.name, status: "skipped-no-scores" });
+        continue;
+      }
+      let report;
+      let statusKind;
+      const existing = await findReportByPeriod(base, w.id, "Announcement", period);
+      if (existing) {
+        await updateReportScores(base, existing.id, scores, now);
+        report = existing;
+        statusKind = "reused";
+      } else {
+        report = await createDraft(base, draftInputFor2(w, scores, now, period));
+        statusKind = "drafted";
+      }
+      const slug = siteSlug(w.name);
+      const { html } = await renderReportHtml({
+        siteName: w.name,
+        siteUrl: w.url,
+        reportType: "Announcement",
+        completedOn: now,
+        lighthouse: scores,
+        lastTestedDate: null,
+        commentary: null,
+        copy: resolveCopy(w),
+        headerImageCid: `${slug}-header`,
+        // Default-on fleet-wide for v1: both recent-improvement callouts render for every
+        // site. Operator review (the draft never auto-sends) is the relevance backstop;
+        // per-site conditioning of these flags is a future lever, not a v1 requirement.
+        improvements: { resendForms: true, svelte5: true }
+      });
+      try {
+        await uploadAttachment(
+          report.id,
+          "Rendered HTML",
+          html,
+          `${slug}-${now.toISOString().slice(0, 10)}.html`,
+          "text/html"
+        );
+      } catch (uploadErr) {
+        console.warn(
+          `\u26A0 Announcement preview upload skipped for ${w.name}: ${uploadErr instanceof Error ? uploadErr.message : String(uploadErr)}`
+        );
+      }
+      await setDraftReady(base, report.id, true);
+      const recipientMissing = !(w.reportRecipientsTo && w.reportRecipientsTo.trim());
+      results.push({ site: w.name, status: statusKind, reportId: report.id, recipientMissing });
+    } catch (err) {
+      results.push({
+        site: w.name,
+        status: "error",
+        message: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+  return { results };
+}
+function scoresFromRow(w) {
+  if (w.pScore === null || w.rScore === null || w.bpScore === null || w.seoScore === null) {
+    return null;
+  }
+  return {
+    performance: w.pScore,
+    accessibility: w.rScore,
+    bestPractices: w.bpScore,
+    seo: w.seoScore
+  };
+}
+function draftInputFor2(w, scores, now, period) {
+  return {
+    reportId: `${w.name} \u2014 Announcement \u2014 ${now.toISOString().slice(0, 10)}`,
+    siteId: w.id,
+    reportType: "Announcement",
+    period,
+    periodStart: now,
+    periodEnd: now,
+    completedOn: now,
+    lighthouse: scores,
+    lastTestedDate: null,
+    subjectOverride: `Your new monthly report for ${w.name}`
+  };
+}
+
+// src/cli/commands/announce.ts
+function formatSiteResult(r) {
+  if (r.status === "skipped-no-scores") return `[${r.site}] skipped-no-scores`;
+  if (r.status === "error") return `[${r.site}] error: ${r.message}`;
+  const note = r.recipientMissing ? " \u26A0 recipient missing" : "";
+  return `[${r.site}] ${r.status}${note}`;
+}
+function formatAnnounceResult(result) {
+  if (result.results.length === 0) return "No maintenance sites to announce.";
+  return result.results.map(formatSiteResult).join("\n");
+}
+async function runAnnounceCommand(site, _opts) {
+  const result = await announce(site ? { site } : {});
+  const hadError = result.results.some((r) => r.status === "error");
+  return { output: formatAnnounceResult(result), code: hadError ? 1 : 0 };
+}
+
 // src/cli/commands/github-signals.ts
 init_client();
 init_websites();
@@ -6440,6 +6700,12 @@ cli.command(
 ).action(
   async (site, opts) => runOrExit(() => runLaunchCommand(site, opts), opts)
 );
+cli.command(
+  "announce [site]",
+  "Draft the monthly-report announcement email for maintenance sites (all, or one) for approval."
+).action(
+  async (site, opts) => runOrExit(() => runAnnounceCommand(site, opts), opts)
+);
 cli.command("report [site]", "Draft or send maintenance/testing reports.").option("--due", "Scan all Websites and draft overdue reports.").option(
   "--preview",
   "Single-site dry run; writes reports/<slug>/draft.html, never touches Airtable."