Site Health Report

1---
2name: launch-site-health-report
3description: >
4  Build scheduled jobs that check a small business website every morning and alert when
5  something breaks, plus a short plain-English weekly email for the owner: is the site up,
6  does the form still deliver, how fast is it, are links broken, when do the certificate and
7  domain expire, and how many leads came in. Use this skill for site monitoring, weekly reports,
8  uptime checks, form tests, Core Web Vitals tracking, broken-link checks, or "tell me if my
9  site breaks". Built with Trigger.dev scheduled tasks.
10---
11
12# Site Health Report: Know the Site Works Without Checking It
13
14**RULE: A breakage alerts the same morning the daily check finds it. Everything else waits
15for one short weekly email that the owner can read in under a minute.**
16
17Most small business sites break quietly: a form stops delivering after a plugin or provider
18change, a certificate expires, a page starts to 404. The owner finds out from a customer, or
19never. This job finds out first.
20
21## What to check
22
23| Check | How | Alert at once when |
24|---|---|---|
25| Site is up | `GET` the home page and main landing page | Status is not 200, or the response takes over 10 s |
26| Form delivers | Call the test entry point, then confirm the lead was stored and `ownerAlertedAt` is set | Not stored, or no alert after 5 minutes. A 503 from the test route (`LEAD_TEST_SECRET` or `LEAD_TEST_INBOX` unset), a 401 or 403 (the job's secret does not match the site's), or a site that is not `business.url`, is a configuration error: alert the agency, and do not tell the owner the form is broken. |
27| Certificate | Read the TLS certificate and its expiry | Not valid for the hostname, or under 14 days left |
28| Domain | Expiry date from RDAP (auto-renew status is only in the registrar's account) | Under 30 days left |
29| Broken links | Fetch every URL in `sitemap.xml` and internal links on key pages | A page in the sitemap returns 4xx or 5xx |
30| `noindex` | Check robots meta and `robots.txt` on key pages | A production page says `noindex` |
31| Speed | Chrome UX Report (field data) or PageSpeed Insights | LCP, INP or CLS moves from "good" to "poor" |
32| Leads | Count leads this week vs last week, by source | (report only) |
33
34## Scheduled task
35
36```ts
37// trigger/site-health.ts
38import { schedules } from "@trigger.dev/sdk"
39
40import { runChecks } from "@/lib/site-health/checks"
41import { sendAlert, sendWeeklyReport } from "@/lib/site-health/report"
42
43export const siteHealthDaily = schedules.task({
44  id: "site-health-daily",
45  cron: { pattern: "0 7 * * *", timezone: "America/New_York", environments: ["PRODUCTION"] },
46  maxDuration: 300,
47  run: async () => {
48    const results = await runChecks({ quick: true })        // uptime, form, TLS, noindex
49    const broken = results.filter((r) => r.status === "fail")
50    if (broken.length > 0) await sendAlert(broken)
51    return { failed: broken.length }
52  },
53})
54
55export const siteHealthWeekly = schedules.task({
56  id: "site-health-weekly",
57  cron: { pattern: "0 8 * * 1", timezone: "America/New_York", environments: ["PRODUCTION"] },
58  maxDuration: 900,
59  run: async () => {
60    const results = await runChecks({ quick: false })       // everything, including links and speed