@reddoorla/maintenance 0.41.0 → 0.43.0

package/dist/cli/bin.js

@@ -575,6 +575,39 @@ var init_write_audits_to_airtable = __esm({
   }
 });
 
+// src/reports/checklist.ts
+function checklistFor(type) {
+  return type === "Maintenance" ? MAINTENANCE_CHECKLIST : type === "Testing" ? TESTING_CHECKLIST : [];
+}
+function isChecklistComplete(report) {
+  return checklistFor(report.reportType).every((i) => report.checklist[i.field] === true);
+}
+var MAINTENANCE_CHECKLIST, TESTING_CHECKLIST, ALL_CHECKLIST_FIELDS;
+var init_checklist = __esm({
+  "src/reports/checklist.ts"() {
+    "use strict";
+    MAINTENANCE_CHECKLIST = [
+      { key: "logs", label: "Reviewed Logs", field: "Maint: Reviewed Logs" },
+      { key: "cms", label: "CMS Checked", field: "Maint: CMS Checked" },
+      { key: "dns", label: "DNS Checked", field: "Maint: DNS Checked" },
+      { key: "google", label: "Google Indexed", field: "Maint: Google Indexed" },
+      { key: "cert", label: "Reviewed Certificate", field: "Maint: Reviewed Certificate" },
+      { key: "security", label: "Security Updates", field: "Maint: Security Updates" }
+    ];
+    TESTING_CHECKLIST = [
+      { key: "desktop", label: "Desktop Browsers", field: "Test: Desktop Browsers" },
+      { key: "mobile", label: "Mobile Browsers", field: "Test: Mobile Browsers" },
+      { key: "packages", label: "Package Updates", field: "Test: Package Updates" },
+      { key: "bottle", label: "Bottlenecks", field: "Test: Bottlenecks" },
+      { key: "forms", label: "Form Functionality", field: "Test: Form Functionality" },
+      { key: "animation", label: "Animation Functionality", field: "Test: Animation Functionality" }
+    ];
+    ALL_CHECKLIST_FIELDS = [...MAINTENANCE_CHECKLIST, ...TESTING_CHECKLIST].map(
+      (i) => i.field
+    );
+  }
+});
+
 // src/reports/airtable/reports.ts
 function toReportType(raw) {
   if (raw && REPORT_TYPES.includes(raw)) return raw;
@@ -613,7 +646,8 @@ function mapRow2(rec) {
     approvedBy: f["Approved By"] ?? null,
     deliveryStatus: f["Delivery status"] ?? "pending",
     renderedHtmlAttachment: html,
-    resendMessageId: f["Resend message ID"] ?? null
+    resendMessageId: f["Resend message ID"] ?? null,
+    checklist: Object.fromEntries(ALL_CHECKLIST_FIELDS.map((name) => [name, Boolean(f[name])]))
   };
 }
 function lighthouseFromFields(f) {
@@ -651,6 +685,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");
@@ -716,8 +751,9 @@ var REPORTS_TABLE, REPORT_TYPES;
 var init_reports = __esm({
   "src/reports/airtable/reports.ts"() {
     "use strict";
+    init_checklist();
     REPORTS_TABLE = "Reports";
-    REPORT_TYPES = ["Maintenance", "Testing", "Launch"];
+    REPORT_TYPES = ["Maintenance", "Testing", "Launch", "Announcement"];
   }
 });
 
@@ -777,7 +813,18 @@ var init_copy = __esm({
         "Hosting, DNS, and SSL configured",
         "Continuous integration + automatic dependency updates",
         "Analytics and uptime monitoring"
-      ]
+      ],
+      announceHeading: "YOUR ONGOING SITE CARE",
+      announceBody: "We've completed a full test of your site and set it up for ongoing care to keep it fast, secure, and healthy. Here's what you can expect from us going forward:",
+      announceCadenceHeading: "WHAT TO EXPECT",
+      announceTestingLabel: "Full site testing",
+      announceMaintenanceLabel: "Routine maintenance",
+      announceMonitorItems: ["Performance", "Accessibility", "Security", "Uptime"],
+      announcePreviewLabel: "From your latest full site test:",
+      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: "After each one we'll send you a short report like this \u2014 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."
     };
   }
 });
@@ -1114,10 +1161,137 @@ 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 cad = data.cadence;
+  const cadenceLines = [];
+  if (cad && cad.testing !== "None")
+    cadenceLines.push(`${copy.announceTestingLabel} \u2014 ${FREQ_PHRASE[cad.testing]}`);
+  if (cad && cad.maintenance !== "None")
+    cadenceLines.push(`${copy.announceMaintenanceLabel} \u2014 ${FREQ_PHRASE[cad.maintenance]}`);
+  const cadenceSection = cadenceLines.length > 0 ? `
+    <mj-section background-color="white">
+      <mj-column>
+        <mj-text color="${RED2}" font-size="20px" font-weight="700" padding-top="36px">${escapeXml(copy.announceCadenceHeading)}</mj-text>
+        ${cadenceLines.map(
+    (line) => `
+        <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(line)}</mj-text>`
+  ).join("")}
+        <mj-text color="${GREY2}" font-family="helvetica, sans-serif" font-size="16px" font-weight="300" line-height="24px" padding-top="12px">${escapeXml(copy.announceCadence)}</mj-text>
+      </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>
+    ${cadenceSection}
+    ${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.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 FREQ_PHRASE, RED2, GREY2, SCORE_PREVIEW;
+var init_template3 = __esm({
+  "src/reports/announcement-email/template.ts"() {
+    "use strict";
+    init_copy();
+    init_template();
+    FREQ_PHRASE = {
+      Monthly: "every month",
+      Quarterly: "every quarter",
+      Yearly: "every year"
+    };
+    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 ?? [] };
 }
@@ -1126,6 +1300,7 @@ var init_render = __esm({
     "use strict";
     init_template();
     init_template2();
+    init_template3();
   }
 });
 
@@ -1419,16 +1594,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>
@@ -1438,15 +1613,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) {
@@ -1463,7 +1638,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 `
@@ -1588,7 +1763,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>
@@ -1600,7 +1775,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";
@@ -1612,9 +1787,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";
@@ -1712,6 +1887,13 @@ async function sendApprovedReports(options = {}) {
   return { output: lines.join("\n"), code: anyFailed ? 1 : 0 };
 }
 async function sendOne(client, base, site, report) {
+  if (!isChecklistComplete(report)) {
+    const items = checklistFor(report.reportType);
+    const done = items.filter((i) => report.checklist[i.field] === true).length;
+    throw new Error(
+      `Report ${report.reportId} checklist incomplete \u2014 ${done}/${items.length} items checked`
+    );
+  }
   if (!site.headerImage) {
     throw new Error(`Site '${site.name}' has no Header image set on the Websites row`);
   }
@@ -1855,6 +2037,7 @@ var init_orchestrate = __esm({
     init_header_image();
     init_resend();
     init_idempotency();
+    init_checklist();
     FROM_ADDRESS2 = "Reddoor Reports <reports@reddoorla.com>";
     REPLY_TO = "info@reddoorla.com";
     MONTHS2 = [
@@ -6211,6 +6394,131 @@ 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`,
+        // The client's go-forward pace, read straight off the Websites row — the email
+        // states each cadence ("Full site testing — every quarter", etc.); a "None" pace
+        // is omitted so we never claim a cadence the site isn't on.
+        cadence: { maintenance: w.maintenanceFreq, testing: w.testingFreq },
+        // 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 testing & maintenance schedule 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();
@@ -6464,6 +6772,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."