seo 0.17.0 → 0.17.1

package/dist/mcp.js

@@ -1,5 +1,5 @@
 import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
-import { i as __toESM, n as version, r as __commonJSMin, t as load } from "./esm-CkObTzDg.js";
+import { i as __toESM, n as version, r as __commonJSMin, t as load } from "./esm-G8B5TPzB.js";
 import { createHash, randomUUID, sign } from "node:crypto";
 import { ZodOptional, z } from "zod";
 import { arch, homedir, platform, tmpdir, totalmem } from "node:os";
@@ -12190,6 +12190,20 @@ const RULE_DEFINITIONS = [
 			suggestedCommands: ["seo audit-page --url <url> --json"]
 		}
 	},
+	{
+		id: "empty_title",
+		title: "Title empty",
+		category: "metadata",
+		defaultSeverity: "high",
+		whyItMatters: "The page has a <title> element with no text. Search engines treat it like a missing title and write their own headline for the result.",
+		howToFix: "Fill the title element with a descriptive title that names the page topic. An empty title usually means a template field or CMS value is blank.",
+		impactIfIgnored: "The page can look vague in search results, earn lower CTR, and send weaker relevance signals.",
+		howToVerify: "Re-run the crawl and confirm the title element has text.",
+		agentHints: {
+			evidenceFields: ["page.title"],
+			suggestedCommands: ["seo crawl <url> --max-pages 1 --json"]
+		}
+	},
 	{
 		id: "title_too_wide",
 		title: "Title may truncate on some devices",
@@ -12678,6 +12692,16 @@ const RULE_DEFINITIONS = [
 		impactIfIgnored: "Search snippets may be generic or less persuasive, especially on pages that already rank.",
 		howToVerify: "Re-run the crawl and confirm the page has a meta description."
 	},
+	{
+		id: "empty_meta_description",
+		title: "Meta description empty",
+		category: "metadata",
+		defaultSeverity: "medium",
+		whyItMatters: "The page has a meta description tag with no content, so search engines choose their own snippet. An empty tag usually means a template field or CMS value is blank.",
+		howToFix: "Fill the content attribute with a concise, unique description, or fix the template value that leaves it blank.",
+		impactIfIgnored: "Search snippets may be generic or less persuasive, especially on pages that already rank.",
+		howToVerify: "Re-run the crawl and confirm the meta description has content."
+	},
 	{
 		id: "meta_description_duplicate",
 		title: "Duplicate meta description",
@@ -13779,6 +13803,27 @@ var GoogleApiError = class extends SeoError {
 		this.status = status;
 	}
 };
+const URL_INSPECTION_TIMEOUT_MS = 6e4;
+async function withinGoogleTimeout(what, timeoutMs, signal, run) {
+	const controller = new AbortController();
+	const fromCaller = () => controller.abort(signal?.reason);
+	if (signal?.aborted) fromCaller();
+	else signal?.addEventListener("abort", fromCaller, { once: true });
+	let timer;
+	const timedOut = new Promise((_, reject) => {
+		timer = setTimeout(() => {
+			const error = new SeoError("PROVIDER_UNAVAILABLE", `${what} did not answer within ${timeoutMs / 1e3} seconds, so the request was stopped. Try again later.`);
+			reject(error);
+			controller.abort(error);
+		}, timeoutMs);
+	});
+	try {
+		return await Promise.race([run(controller.signal), timedOut]);
+	} finally {
+		clearTimeout(timer);
+		signal?.removeEventListener("abort", fromCaller);
+	}
+}
 function bearerFetch(token) {
 	return async (url, init) => fetch(url, {
 		...init,
@@ -13807,12 +13852,15 @@ async function failure(response, label, subject, options) {
 	return new GoogleApiError("PROVIDER_UNAVAILABLE", `${label} answered ${status}. ${detail}`.trim(), status);
 }
 async function googleJson(gfetch, url, input) {
-	const response = await gfetch(url, {
-		method: input.body === void 0 ? "GET" : "POST",
-		body: input.body === void 0 ? void 0 : JSON.stringify(input.body)
+	return withinGoogleTimeout(input.subject ? `${input.label} for ${input.subject}` : input.label, input.timeoutMs ?? 3e4, void 0, async (signal) => {
+		const response = await gfetch(url, {
+			method: input.body === void 0 ? "GET" : "POST",
+			body: input.body === void 0 ? void 0 : JSON.stringify(input.body),
+			signal
+		});
+		if (!response.ok) throw await failure(response, input.label, input.subject, input);
+		return readJson(response, input.label, { maxBytes: input.maxBytes });
 	});
-	if (!response.ok) throw await failure(response, input.label, input.subject, input);
-	return readJson(response, input.label, { maxBytes: input.maxBytes });
 }
 const GSC = "https://www.googleapis.com/webmasters/v3";
 const PAGE_ROWS$1 = 25e3;
@@ -13864,6 +13912,7 @@ async function inspectSearchConsoleUrl(gfetch, site, url, options) {
 		...options,
 		label: "URL Inspection",
 		subject: url,
+		timeoutMs: URL_INSPECTION_TIMEOUT_MS,
 		body: {
 			siteUrl: site,
 			inspectionUrl: url,
@@ -18567,6 +18616,10 @@ function safeText$1(value) {
 	const trimmed = value?.replace(/\s+/g, " ").trim();
 	return trimmed ? trimmed : void 0;
 }
+function tagText(element, read) {
+	if (!element.length) return void 0;
+	return read(element)?.replace(/\s+/g, " ").trim() ?? "";
+}
 function headerValue$3(headers, name) {
 	const target = name.toLowerCase();
 	return Object.entries(headers).find(([key]) => key.toLowerCase() === target)?.[1];
@@ -18835,14 +18888,14 @@ async function extractPage(fetchResult, extractor = "defuddle", dependencies = {
 		html: sanitizedContentHtml($, fetchResult.html, fetchResult.finalUrl, streamedSegments.resolved > 0)
 	}, extractor, dependencies);
 	const { text, excerpt } = content;
-	const title = safeText$1($("title").first().text());
+	const title = tagText($("title").first(), (element) => element.text());
 	const crawlerMetaRefresh = extractor === "crawler" ? metaRefresh($, fetchResult.finalUrl) : void 0;
 	if (crawlerMetaRefresh && new URL(crawlerMetaRefresh.targetUrl).origin === url.origin) crawlerInternalLinks.add(crawlerMetaRefresh.targetUrl);
 	return {
 		url: fetchResult.url,
 		finalUrl: fetchResult.finalUrl,
 		title,
-		metaDescription: safeText$1($("meta[name=\"description\"]").attr("content")),
+		metaDescription: tagText($("meta[name=\"description\"]").first(), (element) => element.attr("content")),
 		metaRobots,
 		xRobotsTag: safeText$1(headerValue$3(fetchResult.headers, "x-robots-tag")),
 		canonical: canonicalEvidence.selectedRaw,
@@ -19200,31 +19253,172 @@ function recordHostFetch(input) {
 	}
 	return snapshotForHost(input.host);
 }
-// packages/core/dist/fetch/page-fetcher/redirects.js
-async function fetchWithRedirectChain(url, signal, fetch = publicHttpFetch) {
-	const redirectChain = [];
-	let currentUrl = url;
-	for (let redirectCount = 0; redirectCount <= 10; redirectCount += 1) {
-		const response = await fetch(currentUrl, {
+const REDIRECT_STATUSES = /* @__PURE__ */ new Set([
+	301,
+	302,
+	303,
+	307,
+	308
+]);
+function errorText$1(error) {
+	if (!(error instanceof Error)) return String(error);
+	const cause = error.cause;
+	const detail = typeof cause?.code === "string" ? cause.code : typeof cause?.message === "string" ? cause.message : "";
+	return detail && !error.message.includes(detail) ? `${error.message} (${detail})` : error.message;
+}
+function httpUrl(value, base) {
+	try {
+		const url = new URL(value, base);
+		if (url.protocol !== "http:" && url.protocol !== "https:") return null;
+		url.hash = "";
+		return url.toString();
+	} catch {
+		return null;
+	}
+}
+async function traceRedirects(url, options = {}) {
+	const request = options.fetch ?? ((to, init) => fetch(to, init));
+	const { trace, response } = await followRedirects(url, {
+		maxHops: options.maxHops,
+		timeoutMs: options.timeoutMs,
+		onResponse: options.onResponse,
+		request: (to, signal) => request(to, {
 			redirect: "manual",
+			headers: {
+				"user-agent": SEO_CRAWLER_USER_AGENT,
+				accept: "text/html,application/xhtml+xml,*/*;q=0.8"
+			},
 			signal
-		});
-		const location = response.headers.get("location");
-		if (response.status < 300 || response.status >= 400 || !location) return {
-			response,
-			redirectChain
-		};
-		const nextUrl = new URL(location, currentUrl).toString();
-		redirectChain.push({
-			url: currentUrl,
-			status: response.status,
-			location: nextUrl
-		});
-		await response.body?.cancel().catch(() => void 0);
-		currentUrl = nextUrl;
+		})
+	});
+	await response?.body?.cancel().catch(() => void 0);
+	return trace;
+}
+async function followRedirects(url, options) {
+	const maxHops = Math.min(Math.max(Math.trunc(options.maxHops ?? 10), 0), 10);
+	const timeoutMs = options.timeoutMs ?? 1e4;
+	const steps = [];
+	const end = (final_url, final_status, outcome, error, extra = {}) => ({
+		trace: {
+			url,
+			steps,
+			hops: steps.filter((step) => step.location !== null).length,
+			final_url,
+			final_status,
+			outcome,
+			...error ? { error } : {}
+		},
+		response: extra.response ?? null,
+		..."error" in extra ? { error: extra.error } : {}
+	});
+	const start = httpUrl(url);
+	if (!start) return end(url, null, "error", "Not an http or https URL.");
+	let current = start;
+	const seen = /* @__PURE__ */ new Set();
+	while (true) {
+		seen.add(current);
+		const startedAt = Date.now();
+		const hop = new AbortController();
+		let timedOut = false;
+		const timer = setTimeout(() => {
+			timedOut = true;
+			hop.abort();
+		}, timeoutMs);
+		const signal = options.signal ? AbortSignal.any([options.signal, hop.signal]) : hop.signal;
+		try {
+			let response;
+			try {
+				response = await options.request(current, signal);
+			} catch (error) {
+				if (options.signal?.aborted) throw error;
+				return timedOut || error instanceof Error && (error.name === "TimeoutError" || error.name === "AbortError") ? end(current, null, "timeout", `No response within ${timeoutMs} ms.`, { error }) : end(current, null, "error", errorText$1(error), { error });
+			}
+			const ms = Date.now() - startedAt;
+			const header = response.headers.get("location");
+			const redirects = REDIRECT_STATUSES.has(response.status) && header !== null;
+			const location = redirects ? httpUrl(header, current) : null;
+			if (options.onResponse) await options.onResponse(response, current);
+			steps.push({
+				url: current,
+				status: response.status,
+				location,
+				ms
+			});
+			if (!redirects) return end(current, response.status, "done", "", { response });
+			await response.body?.cancel().catch(() => void 0);
+			if (!location) return end(current, response.status, "error", `The Location header is not an http or https URL: ${header.slice(0, 200)}`);
+			if (seen.has(location)) return end(current, response.status, "loop");
+			if (steps.length > maxHops) return end(current, response.status, "too_many");
+			current = location;
+		} finally {
+			clearTimeout(timer);
+		}
+	}
+}
+// packages/core/dist/fetch/page-fetcher/redirects.js
+var RedirectChainError = class extends Error {
+	kind;
+	url;
+	redirectChain;
+	constructor(kind, url, redirectChain, message, options) {
+		super(message, options);
+		this.kind = kind;
+		this.url = url;
+		this.redirectChain = redirectChain;
+		this.name = "RedirectChainError";
 	}
-	throw new Error(`Too many redirects for ${url}`);
+};
+async function fetchWithRedirectChain(url, signal, fetch = publicHttpFetch, options = {}) {
+	const followed = await followRedirects(url, {
+		signal,
+		timeoutMs: options.timeoutMs ?? 1e4,
+		request: (to, hopSignal) => fetch(to, {
+			redirect: "manual",
+			signal: hopSignal
+		})
+	});
+	const redirectChain = followed.trace.steps.flatMap(({ url: from, status, location }) => location === null ? [] : [{
+		url: from,
+		status,
+		location
+	}]);
+	const { trace, response } = followed;
+	if (trace.outcome === "done" && response) return {
+		response,
+		redirectChain
+	};
+	const kind = trace.outcome === "loop" || trace.outcome === "too_many" || trace.outcome === "timeout" ? trace.outcome : "network";
+	throw new RedirectChainError(kind, url, redirectChain, kind === "loop" ? `Redirect loop for ${url}: ${trace.final_url} redirects back to a URL already requested.` : kind === "too_many" ? `Too many redirects for ${url}: still redirecting after 10 redirects.` : trace.error ?? "The request failed.", "error" in followed ? { cause: followed.error } : void 0);
+}
+function redirectsWillRepeat(error) {
+	return error instanceof RedirectChainError && (error.kind === "loop" || error.kind === "too_many");
+}
+// packages/core/dist/fetch/page-fetcher/robots-evidence.js
+function pageRobotsEvidence(robots) {
+	return {
+		url: robots.url,
+		allowed: robots.allowed,
+		availability: robots.availability,
+		status: robots.status,
+		error: robots.error,
+		matchedLine: robots.matchedLine
+	};
+}
+function diagnosticRobotsEvidence(robots) {
+	return {
+		url: robots.url,
+		cache: robots.cache,
+		allowed: robots.allowed,
+		availability: robots.availability,
+		status: robots.status,
+		error: robots.error
+	};
+}
+function robotsTxtIsHtml(contentType, text) {
+	const body = text.replace(/^\uFEFF/, "").trimStart();
+	return body.startsWith("<") || /\btext\/html\b/i.test(contentType) && !/^\s*(?:user-agent|allow|disallow|sitemap)\s*:/im.test(body);
 }
+const ROBOTS_TXT_HTML_ERROR = "robots.txt returned a web page, not a robots.txt file, so its rules are unknown.";
 // packages/core/dist/fetch/page-fetcher/robots.js
 const MAX_ROBOTS_RESPONSE_BYTES = 1048576;
 var RobotsAccessError = class extends Error {
@@ -19244,7 +19438,16 @@ function cacheableStatus(status) {
 	return status >= 200 && status < 300 || status >= 400 && status < 500 && status !== 429;
 }
 function resultFromResponse(input) {
-	if (input.status >= 200 && input.status < 300) {
+	const ok = input.status >= 200 && input.status < 300;
+	if (ok && robotsTxtIsHtml(input.contentType, input.text)) return {
+		allowed: true,
+		availability: "unreadable",
+		status: input.status,
+		error: ROBOTS_TXT_HTML_ERROR,
+		cache: input.cache,
+		url: input.robotsUrl
+	};
+	if (ok) {
 		const parsed = parseRobots$1(input.robotsUrl, input.text);
 		const lineNumber = parsed.getMatchingLineNumber?.(input.targetUrl, SEO_CRAWLER_USER_AGENT);
 		const matchedLine = lineNumber ? input.text.split(/\r?\n/)[lineNumber - 1]?.trim() : void 0;
@@ -19278,6 +19481,7 @@ function resultFromSource(source, targetUrl) {
 		robotsUrl: source.robotsUrl,
 		targetUrl,
 		status: source.status,
+		contentType: source.contentType ?? "",
 		text: source.text,
 		cache: source.cache
 	});
@@ -19312,7 +19516,8 @@ async function fetchRobotsSource(origin, refresh, options) {
 			signal: controller.signal
 		});
 		const text = await readBoundedResponseText(response, MAX_ROBOTS_RESPONSE_BYTES, "robots.txt response");
-		if (options.writeCache !== false && cacheableStatus(response.status)) writeToCache((database) => {
+		const contentType = response.headers.get("content-type") ?? "";
+		if (options.writeCache !== false && cacheableStatus(response.status) && !(response.status >= 200 && response.status < 300 && robotsTxtIsHtml(contentType, text))) writeToCache((database) => {
 			database.prepare(`INSERT OR REPLACE INTO http_cache
             (url_hash, url, status, headers_json, body_blob, etag, fetched_at, expires_at)
             VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(key, robotsUrl, response.status, "{}", Buffer.from(text), null, Date.now(), Date.now() + 864e5);
@@ -19321,6 +19526,7 @@ async function fetchRobotsSource(origin, refresh, options) {
 		return {
 			robotsUrl,
 			status: response.status,
+			contentType,
 			text,
 			cache: refresh ? "bypass" : "miss"
 		};
@@ -19376,27 +19582,6 @@ function createRobotsSession(input = {}) {
 		}
 	};
 }
-// packages/core/dist/fetch/page-fetcher/robots-evidence.js
-function pageRobotsEvidence(robots) {
-	return {
-		url: robots.url,
-		allowed: robots.allowed,
-		availability: robots.availability,
-		status: robots.status,
-		error: robots.error,
-		matchedLine: robots.matchedLine
-	};
-}
-function diagnosticRobotsEvidence(robots) {
-	return {
-		url: robots.url,
-		cache: robots.cache,
-		allowed: robots.allowed,
-		availability: robots.availability,
-		status: robots.status,
-		error: robots.error
-	};
-}
 // packages/core/dist/fetch/page-fetcher/plain.js
 const MAX_PAGE_RESPONSE_BYTES = 5242880;
 function encodePageFetchCacheEvidence(result) {
@@ -19478,8 +19663,9 @@ async function fetchPlain(url, refresh = false, timeoutMs = 2e4, rate, signal, r
 		if (signal?.aborted) controller.abort();
 		else signal?.addEventListener("abort", abort, { once: true });
 		try {
-			return await fetchWithRedirectChain(url, controller.signal);
+			return await fetchWithRedirectChain(url, controller.signal, void 0, { timeoutMs });
 		} catch (error) {
+			if (redirectsWillRepeat(error)) throw new AbortError(error);
 			if (error instanceof Error && /4\d\d/.test(error.message)) throw new AbortError(error);
 			throw error;
 		} finally {
@@ -20056,8 +20242,9 @@ async function statusProbe(url, opts) {
 		if (opts.signal?.aborted) controller.abort();
 		else opts.signal?.addEventListener("abort", abort, { once: true });
 		try {
-			return await fetchWithRedirectChain(url, controller.signal);
+			return await fetchWithRedirectChain(url, controller.signal, void 0, { timeoutMs: opts.timeoutMs });
 		} catch (error) {
+			if (redirectsWillRepeat(error)) throw new AbortError(error);
 			if (opts.signal?.aborted) throw new AbortError(error instanceof Error ? error : new Error(String(error)));
 			throw error;
 		} finally {
@@ -20435,38 +20622,40 @@ async function inspectUrl(input) {
 		property: input.siteUrl,
 		limit: input.quotaLimit
 	});
-	let response;
-	try {
-		response = await authedFetch(client, "https://searchconsole.googleapis.com/v1/urlInspection/index:inspect", {
-			method: "POST",
-			body: JSON.stringify({
-				siteUrl: input.siteUrl,
-				inspectionUrl,
-				...input.languageCode ? { languageCode: input.languageCode } : {}
-			}),
-			signal: input.signal
-		});
-	} catch (error) {
+	return withinGoogleTimeout(`URL Inspection for ${inspectionUrl}`, URL_INSPECTION_TIMEOUT_MS, input.signal, async (signal) => {
+		let response;
+		try {
+			response = await authedFetch(client, "https://searchconsole.googleapis.com/v1/urlInspection/index:inspect", {
+				method: "POST",
+				body: JSON.stringify({
+					siteUrl: input.siteUrl,
+					inspectionUrl,
+					...input.languageCode ? { languageCode: input.languageCode } : {}
+				}),
+				signal
+			});
+		} catch (error) {
+			finalize(reservation, "consumed");
+			if (error instanceof SeoError) throw error;
+			throw new SeoError("PROVIDER_UNAVAILABLE", `URL Inspection request failed: ${error instanceof Error ? error.message : String(error)}`);
+		}
+		if (response.status === 429) {
+			const now = /* @__PURE__ */ new Date();
+			const blockedUntil = retryAfter$1(response, now);
+			finalize(reservation, "exhausted", blockedUntil, now);
+			throw new UrlInspectionQuotaError({
+				property: input.siteUrl,
+				resetAt: (blockedUntil ?? (reservation ? new Date(reservation.resetAt) : urlInspectionQuotaResetAt(now))).toISOString(),
+				used: reservation ? reservation.used + reservation.count : 0,
+				limit: reservation?.limit ?? 2e3,
+				reason: "provider",
+				requestSent: true
+			});
+		}
 		finalize(reservation, "consumed");
-		if (error instanceof SeoError) throw error;
-		throw new SeoError("PROVIDER_UNAVAILABLE", `URL Inspection request failed: ${error instanceof Error ? error.message : String(error)}`);
-	}
-	if (response.status === 429) {
-		const now = /* @__PURE__ */ new Date();
-		const blockedUntil = retryAfter$1(response, now);
-		finalize(reservation, "exhausted", blockedUntil, now);
-		throw new UrlInspectionQuotaError({
-			property: input.siteUrl,
-			resetAt: (blockedUntil ?? (reservation ? new Date(reservation.resetAt) : urlInspectionQuotaResetAt(now))).toISOString(),
-			used: reservation ? reservation.used + reservation.count : 0,
-			limit: reservation?.limit ?? 2e3,
-			reason: "provider",
-			requestSent: true
-		});
-	}
-	finalize(reservation, "consumed");
-	if (!response.ok) throw inspectionResponseError(response, input);
-	return await readJson(response, "URL Inspection");
+		if (!response.ok) throw inspectionResponseError(response, input);
+		return await readJson(response, "URL Inspection");
+	});
 }
 // packages/core/dist/gsc/client/search-analytics.js
 function searchDateRange(days) {
@@ -20826,7 +21015,7 @@ function buildRecommendations(report) {
 	const page = report.page;
 	if (!page.title) recommendations.push({
 		principle: "C.2",
-		evidenceRef: "The HTML document has no title element.",
+		evidenceRef: page.title === "" ? "The HTML document has an empty title element." : "The HTML document has no title element.",
 		action: "Add a concise, descriptive title that identifies this page.",
 		effort: "S",
 		confidence: "high"
@@ -20855,7 +21044,15 @@ async function auditPage(input, dependencies = defaultDependencies$12) {
 	const page = await extractPage(fetched, input.extractor);
 	const h1s = page.headings.filter((heading) => heading.level === 1);
 	const issues = [];
-	if (!page.title) issues.push({
+	if (page.title === "") issues.push({
+		code: "empty_title",
+		title: "Title empty",
+		detail: "The <title> element has no text.",
+		principle: "C.2",
+		evidenceRef: "HTML document has an empty <title> element.",
+		severity: "high"
+	});
+	else if (!page.title) issues.push({
 		code: "missing_title",
 		title: "Title missing",
 		detail: "No <title> element was found.",
@@ -23061,7 +23258,8 @@ function auditCrawlPages(pages, opts = {}) {
 		const title = page.title?.trim();
 		const titleWidth = title ? estimateSerpTitleWidth(title) : void 0;
 		const duplicateTitle = duplicateTitles.get(normalizedMetadata(title) ?? "");
-		if (!title) issues.push(issue$1("missing_title", page));
+		if (title === void 0) issues.push(issue$1("missing_title", page));
+		else if (!title) issues.push(issue$1("empty_title", page));
 		else if (titleWidth?.status === "over-reference") issues.push(issue$1("title_too_wide", page, `${titleWidth.estimatedPixels}px`, {
 			title,
 			...titleWidth
@@ -23073,7 +23271,8 @@ function auditCrawlPages(pages, opts = {}) {
 		}));
 		const metaDescription = page.metaDescription?.trim();
 		const duplicateDescription = duplicateDescriptions.get(normalizedMetadata(metaDescription) ?? "");
-		if (!metaDescription) issues.push(issue$1("missing_meta_description", page));
+		if (metaDescription === void 0) issues.push(issue$1("missing_meta_description", page));
+		else if (!metaDescription) issues.push(issue$1("empty_meta_description", page));
 		if (metaDescription && duplicateDescription?.urls.has(page.url)) issues.push(issue$1("meta_description_duplicate", page, duplicateDescription.value, {
 			metaDescription,
 			duplicateCount: duplicateDescription.count,
@@ -23999,13 +24198,15 @@ const crawlAiAvailabilitySchema = z.enum([
 	"absent",
 	"access-blocked",
 	"rate-limited",
-	"unreachable"
+	"unreachable",
+	"unreadable"
 ]);
 const crawlFetchErrorKindSchema = z.enum([
 	"dns",
 	"tls",
 	"timeout",
 	"redirect-limit",
+	"redirect-loop",
 	"too-large",
 	"aborted",
 	"unknown"
@@ -24178,7 +24379,8 @@ const crawlRobotsEvidenceSchema = z.object({
 		"absent",
 		"access-blocked",
 		"rate-limited",
-		"unreachable"
+		"unreachable",
+		"unreadable"
 	]),
 	status: z.number().int().optional(),
 	error: z.string().optional(),
@@ -24372,7 +24574,8 @@ const crawlPageSnapshotSchema = z.object({
 				"absent",
 				"access-blocked",
 				"rate-limited",
-				"unreachable"
+				"unreachable",
+				"unreadable"
 			]),
 			status: z.number().int().optional(),
 			error: z.string().optional()
@@ -24717,6 +24920,7 @@ const crawlRequestObservationSchema = z.union([
 			"tls",
 			"timeout",
 			"redirect-limit",
+			"redirect-loop",
 			"aborted",
 			"unknown"
 		]),
@@ -25071,7 +25275,7 @@ function agentReadyIssues(input) {
 	const issues = [];
 	const blocked = (ai.robotsTxt?.botAccess ?? []).filter((bot) => bot.purpose === "search" && bot.allowed === false);
 	if (blocked.length && ai.robotsTxt) issues.push(issue("ai_search_bot_blocked", ai.robotsTxt.url, `robots.txt blocks ${blocked.map((bot) => bot.userAgent).join(", ")} from the start URL.`, { blocked: blocked.map((bot) => bot.userAgent) }));
-	if (ai.robotsTxt?.servesHtml) issues.push(issue("robots_txt_html", ai.robotsTxt.url, `/robots.txt returned an HTML page (HTTP ${ai.robotsTxt.status}, ${ai.robotsTxt.contentType}), so it has no rules or sitemap lines.`, {
+	if (ai.robotsTxt?.servesHtml) issues.push(issue("robots_txt_html", ai.robotsTxt.url, `/robots.txt returned an HTML page (HTTP ${ai.robotsTxt.status}, ${ai.robotsTxt.contentType}), not a robots.txt file, so its rules for crawlers are unknown. Google treats it as a file with no valid rules, so the crawl went ahead as Google would.`, {
 		status: ai.robotsTxt.status,
 		contentType: ai.robotsTxt.contentType
 	}));
@@ -25597,6 +25801,12 @@ function fetchFailureKind(error, signal) {
 	const code = String(record?.code ?? record?.cause?.code ?? "").toUpperCase();
 	const message = error instanceof Error ? error.message : String(error);
 	if (signal?.aborted) return "aborted";
+	if (error instanceof RedirectChainError) {
+		if (error.kind === "loop") return "redirect-loop";
+		if (error.kind === "too_many") return "redirect-limit";
+		if (error.kind === "timeout") return "timeout";
+		return error.cause === void 0 ? "unknown" : fetchFailureKind(error.cause, signal);
+	}
 	if (/TOO MANY REDIRECTS/i.test(message)) return "redirect-limit";
 	if ([
 		"ENOTFOUND",
@@ -25989,7 +26199,7 @@ function availabilityOf(status) {
 	if (status >= 400 && status < 500) return "absent";
 	return "unreachable";
 }
-function errorText$1(error) {
+function errorText(error) {
 	if (!(error instanceof Error)) return String(error);
 	const cause = error.cause instanceof Error ? error.cause.message : "";
 	return cause && !error.message.includes(cause) ? `${error.message}: ${cause}` : error.message;
@@ -25997,7 +26207,7 @@ function errorText$1(error) {
 function requestError$1(error, timeoutMs, signal) {
 	const errorKind = fetchErrorKind(error, signal);
 	return {
-		error: errorKind === "timeout" ? `No response within ${Math.min(timeoutMs, REQUEST_TIMEOUT_CAP_MS) / 1e3} seconds.` : errorText$1(error),
+		error: errorKind === "timeout" ? `No response within ${Math.min(timeoutMs, REQUEST_TIMEOUT_CAP_MS) / 1e3} seconds.` : errorText(error),
 		errorKind
 	};
 }
@@ -26135,10 +26345,10 @@ function sitemapUrlsFromRobots(text) {
 async function checkRobotsAiAccess(input) {
 	const robotsUrl = new URL("/robots.txt", input.url).toString();
 	const result = await get$1(input, robotsUrl);
-	const servesHtml = result.availability === "available" && isHtml(result.contentType);
-	const availability = servesHtml ? "absent" : result.availability;
+	const servesHtml = result.availability === "available" && robotsTxtIsHtml(result.contentType, result.text);
+	const availability = servesHtml ? "unreadable" : result.availability;
 	const exists = availability === "available";
-	const unknown = result.availability === "rate-limited" || result.availability === "unreachable";
+	const unknown = availability === "rate-limited" || availability === "unreachable" || availability === "unreadable";
 	const declared = exists ? declaredUserAgents(result.text) : /* @__PURE__ */ new Set();
 	const parsed = parseRobots(robotsUrl, exists ? result.text : "");
 	const ruleHosts = /* @__PURE__ */ new Set([new URL(robotsUrl).host, new URL(result.url).host]);
@@ -26155,7 +26365,7 @@ async function checkRobotsAiAccess(input) {
 			...result.status === void 0 ? {} : { status: result.status },
 			...result.contentType ? { contentType: result.contentType } : {},
 			...servesHtml ? { servesHtml } : {},
-			...unknown ? { error: result.error ?? `robots.txt returned HTTP ${result.status}.` } : {},
+			...unknown ? { error: servesHtml ? ROBOTS_TXT_HTML_ERROR : result.error ?? `robots.txt returned HTTP ${result.status}.` } : {},
 			...result.errorKind ? { errorKind: result.errorKind } : {},
 			sitemapUrls: exists ? sitemapUrlsFromRobots(result.text) : [],
 			...unknown ? {} : { contentSignals: exists ? contentSignalsFromRobots(result.text) : [] },
@@ -26167,7 +26377,7 @@ async function checkRobotsAiAccess(input) {
 				coveredByWildcard: declared.has("*")
 			}))
 		},
-		allows: (url) => unknown ? null : isAllowed(url, SEO_CRAWLER_USER_AGENT)
+		allows: (url) => servesHtml ? true : unknown ? null : isAllowed(url, SEO_CRAWLER_USER_AGENT)
 	};
 }
 async function checkAgentResources(input) {
@@ -36592,82 +36802,6 @@ async function indexCoverageSignals(input, dependencies = defaultDependencies$1)
 		}
 	};
 }
-const REDIRECT_STATUSES = /* @__PURE__ */ new Set([
-	301,
-	302,
-	303,
-	307,
-	308
-]);
-function errorText(error) {
-	if (!(error instanceof Error)) return String(error);
-	const cause = error.cause;
-	const detail = typeof cause?.code === "string" ? cause.code : typeof cause?.message === "string" ? cause.message : "";
-	return detail && !error.message.includes(detail) ? `${error.message} (${detail})` : error.message;
-}
-function httpUrl(value, base) {
-	try {
-		const url = new URL(value, base);
-		if (url.protocol !== "http:" && url.protocol !== "https:") return null;
-		url.hash = "";
-		return url.toString();
-	} catch {
-		return null;
-	}
-}
-async function traceRedirects(url, options = {}) {
-	const maxHops = Math.min(Math.max(Math.trunc(options.maxHops ?? 10), 0), 10);
-	const timeoutMs = options.timeoutMs ?? 1e4;
-	const request = options.fetch ?? ((to, init) => fetch(to, init));
-	const steps = [];
-	const end = (final_url, final_status, outcome, error) => ({
-		url,
-		steps,
-		hops: steps.filter((step) => step.location !== null).length,
-		final_url,
-		final_status,
-		outcome,
-		...error ? { error } : {}
-	});
-	const start = httpUrl(url);
-	if (!start) return end(url, null, "error", "Not an http or https URL.");
-	let current = start;
-	const seen = /* @__PURE__ */ new Set();
-	while (true) {
-		seen.add(current);
-		const startedAt = Date.now();
-		let response;
-		try {
-			response = await request(current, {
-				redirect: "manual",
-				headers: {
-					"user-agent": SEO_CRAWLER_USER_AGENT,
-					accept: "text/html,application/xhtml+xml,*/*;q=0.8"
-				},
-				signal: AbortSignal.timeout(timeoutMs)
-			});
-		} catch (error) {
-			return error instanceof Error && (error.name === "TimeoutError" || error.name === "AbortError") ? end(current, null, "timeout", `No response within ${timeoutMs} ms.`) : end(current, null, "error", errorText(error));
-		}
-		const ms = Date.now() - startedAt;
-		const header = response.headers.get("location");
-		const redirects = REDIRECT_STATUSES.has(response.status) && header !== null;
-		const location = redirects ? httpUrl(header, current) : null;
-		if (options.onResponse) await options.onResponse(response, current);
-		await response.body?.cancel().catch(() => void 0);
-		steps.push({
-			url: current,
-			status: response.status,
-			location,
-			ms
-		});
-		if (!redirects) return end(current, response.status, "done");
-		if (!location) return end(current, response.status, "error", `The Location header is not an http or https URL: ${header.slice(0, 200)}`);
-		if (seen.has(location)) return end(current, response.status, "loop");
-		if (steps.length > maxHops) return end(current, response.status, "too_many");
-		current = location;
-	}
-}
 // packages/core/dist/analyze/monitoring/redirect-trace.js
 function redirectIssue(input) {
 	const issues = [];
@@ -39800,7 +39934,19 @@ function makeBlock(kind, built, extra = {}) {
 		text.pop();
 		map.pop();
 	}
-	if (!text.length) return null;
+	if (!text.length) {
+		if (extra.at === void 0 || kind !== "title" && kind !== "description") return null;
+		map.push(extra.at);
+		return {
+			kind,
+			text: "",
+			norm: "",
+			map,
+			field: extra.field,
+			section: 0,
+			links: []
+		};
+	}
 	const joined = text.join("");
 	const links = [];
 	for (const link of extra.links ?? []) {
@@ -40092,7 +40238,8 @@ var Extractor = class {
 			}
 			const block = makeBlock(kind, decodeValue(source, at, at + value.length, Boolean(quoted)), {
 				field: key,
-				level: kind === "heading" ? 1 : void 0
+				level: kind === "heading" ? 1 : void 0,
+				at
 			});
 			if (block) this.props.push({
 				at,
@@ -40415,7 +40562,10 @@ function extractHtml(source, astro) {
 				const content = tag.attrs.get("content");
 				const value = name ? source.slice(name.start, name.end) : "";
 				if (content && /^description$/i.test(value)) {
-					const block = makeBlock("description", decodeValue(source, content.start, content.end, false), { field: "description" });
+					const block = makeBlock("description", decodeValue(source, content.start, content.end, false), {
+						field: "description",
+						at: content.start
+					});
 					if (block) x.props.push({
 						at: content.start,
 						block
@@ -40425,7 +40575,10 @@ function extractHtml(source, astro) {
 			if (lower === "title" && !tag.closing) {
 				const close = source.toLowerCase().indexOf("</title", tag.end);
 				const stop = close < 0 ? n : close;
-				const block = makeBlock("title", decodeValue(source, tag.end, stop, false), { field: "title" });
+				const block = makeBlock("title", decodeValue(source, tag.end, stop, false), {
+					field: "title",
+					at: tag.end
+				});
 				if (block) x.props.push({
 					at: tag.end,
 					block
@@ -40539,7 +40692,10 @@ function extractMetaLines(source, metaKind) {
 		const built = decodeValue(source, from, end, false);
 		const value = source.slice(from, end).trim();
 		const kind = label ? label[1]?.toLowerCase() : metaKind ? metaKind : value.length <= 70 ? "title" : "description";
-		const block = makeBlock(kind, built, { field: kind });
+		const block = makeBlock(kind, built, {
+			field: kind,
+			...label ? { at: from } : {}
+		});
 		if (block) blocks.push(block);
 	}
 	return finish(x, blocks);
@@ -40693,6 +40849,16 @@ function insideQuotes(text, start, end) {
 		if (open <= start && i >= end - 1) return true;
 		open = -1;
 	}
+	const opener = text.lastIndexOf("'", start);
+	if (opener >= 0 && start - opener <= 80 && (opener === 0 || /[\s([]/.test(text[opener - 1] ?? "")) && /[A-Za-z]/.test(text[opener + 1] ?? "")) {
+		const closer = /'(?![A-Za-z])/g;
+		closer.lastIndex = Math.max(end - 1, opener + 1);
+		const found = closer.exec(text);
+		if (found && found.index - end <= 80) {
+			const between = text.slice(opener + 1, found.index);
+			if (!/'\s/.test(between.slice(0, Math.max(0, start - opener - 1)))) return true;
+		}
+	}
 	return false;
 }
 var Context = class {
@@ -40806,7 +40972,12 @@ const PLAIN = {
 	seamless: "smooth, simple (or say what does not break)",
 	robust: "reliable, strong (or say what it survives)",
 	holistic: "whole, complete",
-	utilize: "use"
+	utilize: "use",
+	breathtaking: "say what you see",
+	stunning: "say what you see",
+	enchanting: "say what you see",
+	"must-visit": "say why to go",
+	unforgettable: "say what stays with you"
 };
 function plainFor(word) {
 	const lower = word.toLowerCase();
@@ -40874,12 +41045,13 @@ const PHRASE_RULES = [
 		id: "throat-clearing",
 		family: "ai",
 		level: "error",
-		description: "Openers that announce a point instead of making it: \"Here's the thing\", \"The truth is\", \"Let that sink in\".",
+		description: "Openers that announce a point instead of making it: \"Here's the thing\", \"The truth is\", \"The real question is\", \"Let that sink in\".",
 		patterns: [
 			/\bhere's the (?:thing|deal|kicker|catch|twist|truth|secret|reality)\b/gi,
 			/(?<!\b(?:what|how|whatever|whether|where|why|who|if)\s)\b(?:the (?:uncomfortable |honest |hard |brutal |simple |real )?truth is|the reality is(?: that)?|the thing is|the honest answer(?: is)?)\b/gi,
 			/\b(?:let me be (?:clear|honest|blunt)|let's be (?:clear|honest|real)|real talk|make no mistake|let that sink in|read that again)\b/gi,
-			/\bfull stop\.\s*$/gim
+			/\bfull stop\.\s*$/gim,
+			/\bthe (?:real|bigger|more interesting|only|big) question (?:now )?is\b|\bthe question now is\b/gi
 		],
 		message: "This announces a point instead of making it.",
 		fix: cut
@@ -40897,7 +41069,7 @@ const PHRASE_RULES = [
 			/\b(?:a problem nobody talks about|the insight everyone's missing|most people don't reali[sz]e)\b/gi
 		],
 		message: "It claims a hidden insight instead of showing the finding.",
-		fix: "Lead with the finding itself and the number behind it."
+		fix: "Cut the setup and state the finding itself."
 	},
 	{
 		id: "significance-inflation",
@@ -40916,10 +41088,16 @@ const PHRASE_RULES = [
 			/\ban? (?:meaningful|significant|major|big|bold|giant|monumental|crucial|pivotal|huge) step (?:towards?|forward)\b/gi,
 			/\bwatershed moment\b/gi,
 			/\bhas emerged as (?:a|the|one of) (?:leading|key|major|critical|essential|pivotal|prominent|dominant)\b/gi,
-			/\bextends? far beyond\b/gi
+			/\bextends? far beyond\b/gi,
+			/\b(?:is|are|was) (?:just|only|merely) the (?:beginning|start)\b/gi,
+			/\bmakes? (?:a|the) (?:real|big|huge|meaningful|lasting|tangible|world of) difference\b/gi,
+			/\b(?:a|another) (?:major|key|significant|important|huge|big|proud) milestone\b/gi,
+			/\bbuilding a better (?:future|world|tomorrow)\b/gi,
+			/\bthe implications are (?:profound|significant|enormous|huge|far-reaching)\b/gi,
+			/\b(?:is|was) an (?:event|experience|attraction) in itself\b/gi
 		],
 		message: "It inflates importance without saying what changed.",
-		fix: "Name the concrete effect: what changed, for whom, and by how much."
+		fix: "Cut it, or name the concrete effect the text already states. Do not add a number that is not there."
 	},
 	{
 		id: "participle-tail",
@@ -40927,8 +41105,8 @@ const PHRASE_RULES = [
 		level: "error",
 		description: "A sentence that ends on \", highlighting/underscoring/showcasing ...\" commentary.",
 		kinds: PROSE,
-		patterns: [/,\s+(?:highlighting|underscoring|emphasi[sz]ing|showcasing|symboli[sz]ing|solidifying|cementing|signall?ing|reinforcing|fostering|cultivating|paving the way|setting the stage|demonstrating|illustrating|reflecting|ensuring|marking|contributing to)\b[^.!?]{0,120}[.!?]?/gi],
-		levelFor: (match) => /^,\s+(?:reflecting|ensuring|marking|contributing|demonstrating|illustrating)/i.test(match.text) ? "warning" : void 0,
+		patterns: [/,\s+(?:highlighting|underscoring|emphasi[sz]ing|showcasing|symboli[sz]ing|solidifying|cementing|signall?ing|reinforcing|fostering|cultivating|paving the way|setting the stage|demonstrating|illustrating|reflecting|ensuring|marking|contributing to)\b[^.!?]{0,120}[.!?]?/gi, /,\s+(?:giving (?:users|teams|customers|small teams|every \w+|people) (?:a|an|the|more)\b|freeing (?:you|them|up)\b|making it (?:easy|easier|simple|simpler|effortless|possible) (?:for|to)\b|creating an? (?:[\w-]+ )?(?:experience|panorama|atmosphere|sense)\b|delivering (?:real-time|accurate|predictions|reliable|a seamless|an intuitive)\b)[^.!?]{0,120}[.!?]?/gi],
+		levelFor: (match) => /^,\s+(?:reflecting|ensuring|marking|contributing|demonstrating|illustrating|giving|freeing|making|creating|delivering)/i.test(match.text) ? "warning" : void 0,
 		message: "The \", highlighting ...\" tail comments on the sentence instead of adding a fact.",
 		fix: "End the sentence at the comma. If the tail holds a real fact, give it its own sentence with a subject and verb."
 	},
@@ -40936,7 +41114,7 @@ const PHRASE_RULES = [
 		id: "ai-vocabulary",
 		family: "ai",
 		level: "error",
-		description: "Words far more common in AI text than in human writing: delve, tapestry, testament, showcase, meticulous, realm.",
+		description: "Words far more common in AI text than in human writing: delve, tapestry, testament, showcase, meticulous, realm. One alone is a warning; two or more in a piece are errors.",
 		patterns: [
 			/\bdelv(?:e|es|ed|ing)\b/gi,
 			/\b(?:rich )?tapestry\b/gi,
@@ -40959,7 +41137,9 @@ const PHRASE_RULES = [
 			/\bbustling\b/gi,
 			/\bsynerg(?:y|ies)\b/gi,
 			/\brevolutioni[sz](?:e|es|ed|ing)\b/gi,
-			/\bnavigat(?:e|ing) the complexit(?:y|ies)\b/gi
+			/\bnavigat(?:e|ing) the complexit(?:y|ies)\b/gi,
+			/\bbreathtaking(?:ly)?\b|\bmust-visit\b|\bunforgettable\b/gi,
+			/\bstunning(?:ly)?\b|\benchanting\b/gi
 		],
 		message: (match) => `"${match.text}" is far more common in AI text than in human writing.`,
 		fix: (match) => `Use ${plainFor(match.text.replace(/^(?:rich|a) /i, ""))}.`
@@ -41001,7 +41181,7 @@ const PHRASE_RULES = [
 			/\bbattle-tested\b|\bbulletproof\b|\bunparalleled\b|\bunmatched\b/gi
 		],
 		message: (match) => `"${match.text}" claims quality without showing it.`,
-		fix: (match) => `Replace it with the proof: ${plainFor(match.text)}.`
+		fix: (match) => `Cut it, or use what the text already shows (${plainFor(match.text)}). Do not add a claim the text does not make.`
 	},
 	{
 		id: "cliche",
@@ -41035,11 +41215,13 @@ const PHRASE_RULES = [
 			/\bpaves? the way\b/gi,
 			/\bnorth star\b|\btable stakes\b|\bneedle in a haystack\b/gi,
 			/\bnot a rounding error\b/gi,
+			/\bpunch(?:es|ing)? (?:well )?above (?:its|their|his|her) weight\b/gi,
+			/\b(?:thrilled|delighted) to (?:announce|share|introduce|unveil)\b/gi,
 			/\bthe (?:whole|entire) point\b/gi,
 			/,? which is (?:the (?:whole |real |entire )?point|exactly the point|kind of the point)\b/gi
 		],
 		message: (match) => `"${match.text}" is a stock phrase that would fit any page.`,
-		fix: "Say the specific thing in literal words, with the number or name that makes it true here."
+		fix: "Say the specific thing in literal words, using a fact the text already gives, or cut it."
 	},
 	{
 		id: "filler",
@@ -41084,14 +41266,19 @@ const PHRASE_RULES = [
 		id: "generic-closer",
 		family: "ai",
 		level: "error",
-		description: "Tidy endings: \"In conclusion\", \"the future looks bright\", \"only time will tell\".",
+		description: "Tidy endings: \"In conclusion\", \"the future looks bright\", \"Here's to the next chapter\", \"Let's build something extraordinary\".",
 		patterns: [
 			/\bthe future (?:of \w+ )?(?:looks bright|is here|is now|starts now|is bright)\b/gi,
 			/\bonly time will tell\b|\bone thing is (?:certain|clear)\b/gi,
 			/\bexciting times (?:lie )?ahead\b|\bas we move forward\b/gi,
 			/(?:^|[.!?]\s)(?:In conclusion|In summary|To sum (?:it )?up|To summari[sz]e|All in all|In closing)\b/gi,
 			/\bthe possibilities are endless\b|\bthe rest is history\b/gi,
-			/\bbecause (?:you|your team) deserves? (?:better|more|the best)\b/gi
+			/\bbecause (?:you|your team) deserves? (?:better|more|the best)\b/gi,
+			/(?:^|[.!?]\s)Here's to (?:the|what|a|an|our|your|many|more|another|new)\b[^.!?]{0,60}[.!?]/g,
+			/\blet's (?:build|make|create|shape) something (?:extraordinary|remarkable|amazing|great|special|incredible|beautiful|meaningful)\b/gi,
+			/\bwe'd love (?:to hear )?your (?:feedback|thoughts)\b/gi,
+			/\bthe way it (?:should|was meant to) (?:be|work)\b/gi,
+			/(?:^|[.!?]\s)See you (?:there|soon|at the \w+|on the \w+)[.!]/g
 		],
 		message: "A stock closing line that adds nothing the page has not said.",
 		fix: "End on the next step, or on the last concrete fact."
@@ -41106,6 +41293,7 @@ const PHRASE_RULES = [
 			/\bthat's when (?:everything|it all) changed\b/gi,
 			/\b(?:then )?something (?:interesting|unexpected) happened\b/gi,
 			/\b(?:this|here) is where (?:things|it) gets? (?:interesting|tricky|fun)\b|\bhere's where it gets (?:interesting|tricky)\b/gi,
+			/\b(?:this|that) is where (?:[\w-]+ ){1,3}(?:shines?|excels?|stands? out)\b/gi,
 			/\bflipped the script\b|\brewrote the playbook\b|\bchanged the game\b|\bplot twist\b/gi
 		],
 		message: "A staged turn that tells the reader to feel surprised.",
@@ -41141,8 +41329,9 @@ const PHRASE_RULES = [
 			/\b(?:studies|research|surveys) (?:show|shows|suggest|suggests|indicate|indicates|proves?)\b/gi,
 			/\bit is (?:widely|generally|commonly) (?:believed|accepted|known|agreed)\b/gi
 		],
+		skip: (match) => /^[A-Z]\w* [A-Z]/.test(match.text),
 		message: "A claim credited to nobody in particular.",
-		fix: "Name the source and link it, or cut the claim."
+		fix: "Name the source if the text has one. Otherwise cut the claim or say it as your own view."
 	},
 	{
 		id: "hedge-stack",
@@ -41159,7 +41348,11 @@ const PHRASE_RULES = [
 		level: "error",
 		kinds: PROSE,
 		description: "A label and colon used as a drumroll: \"The best part: it learns.\"",
-		patterns: [/(?:^|[.!?]\s+)(?:The|One|My|Here's the|And the|But the)\s+(?:\w+\s+){0,3}(?:part|thing|secret|trick|catch|kicker|truth|twist|takeaway|lesson|upshot|irony|punchline):\s+\S/g],
+		patterns: [
+			/(?:^|[.!?]\s+)(?:The|One|My|Here's the|And the|But the)\s+(?:\w+\s+){0,3}(?:part|thing|secret|trick|catch|kicker|truth|twist|takeaway|lesson|upshot|irony|punchline):\s+\S/g,
+			/\bthe (?:idea|answer|fix|plan|rule|math|process|premise|concept) is simple:/gi,
+			/\bthe (?:results?|answer|choice|difference) (?:was|were|became) (?:clear|obvious|striking)\b/gi
+		],
 		message: "A colon reveal builds suspense the content does not need.",
 		fix: "Say it straight: drop the label and keep what follows the colon."
 	},
@@ -41167,12 +41360,13 @@ const PHRASE_RULES = [
 		id: "copula-avoidance",
 		family: "ai",
 		level: "error",
-		description: "\"Serves as\", \"stands as\", \"boasts\" where \"is\" or \"has\" would do.",
+		description: "\"Serves as\", \"stands as\", \"boasts\", \"represents a significant\" where \"is\" or \"has\" would do.",
 		patterns: [
 			/\bstands? as (?:a|an|the)\b/gi,
 			/\bboasts? (?:a|an|the|over|more|\d)/gi,
 			/\bholds? the distinction of\b/gi,
-			/\bserves? as (?:a|an|the)\b/gi
+			/\bserves? as (?:a|an|the)\b/gi,
+			/\brepresents? (?:a|an) (?:significant|major|big|huge|real|smart|key|mature|important|meaningful|proven)\b|\brepresents? (?:our|their|its|a) (?:commitment|dedication)\b/gi
 		],
 		levelFor: (match) => /^serves?/i.test(match.text) ? "warning" : void 0,
 		message: (match) => `"${match.text.trim()}" dodges a plain "is" or "has".`,
@@ -41191,7 +41385,7 @@ const PHRASE_RULES = [
 			/\ball-in-one\b/gi,
 			/\bin (?:just )?a few (?:clicks|minutes|seconds)\b/gi,
 			/\bjoin (?:thousands|millions|hundreds) of (?:happy|satisfied|other)?\b/gi,
-			/\bin seconds,? not (?:hours|days|weeks)\b/gi,
+			/\bin (?:seconds|minutes|hours|days),? not (?:minutes|hours|days|weeks|months)\b/gi,
 			/\bmore than just an?\b/gi,
 			/\bthat's where \w+ comes? in\b/gi,
 			/\btrusted by (?:industry leaders|thousands|teams worldwide|the best)\b/gi,
@@ -41199,7 +41393,7 @@ const PHRASE_RULES = [
 		],
 		levelFor: (match) => /the power of/i.test(match.text) ? "warning" : void 0,
 		message: (match) => `"${match.text}" is a stock landing-page line that fits any product.`,
-		fix: "Say what the product does for this reader, with a number or an example."
+		fix: "Cut the phrase, or replace it with a fact the text already gives, such as a number or a feature named elsewhere on the page. Do not add a new claim."
 	},
 	{
 		id: "stranded-negation",
@@ -41214,12 +41408,63 @@ const PHRASE_RULES = [
 		],
 		message: "A two-word denial used for rhythm. It makes the reader wait.",
 		fix: "Join it to the sentence before, such as \"Nothing technical was holding these pages back.\""
+	},
+	{
+		id: "strawman",
+		family: "ai",
+		level: "error",
+		kinds: PROSE,
+		description: "An answer to an objection nobody raised: \"It isn't perfect.\", \"doesn't have to be stressful\", \"None of this means\", \"This isn't about\".",
+		patterns: [
+			/(?:^|[.!?:]\s+)(?:It|This|That|Nothing|No \w+)(?:'s| is|'s not| isn't| is not| wasn't| was not) (?:not )?perfect\.(?=\s|$)/g,
+			/\b(?:doesn't|does not|don't|do not|needn't|need not) (?:have to |need to )?be (?:so )?(?:stressful|hard|complicated|difficult|painful|expensive|overwhelming|a chore|scary|intimidating|daunting|confusing|a headache)\b/gi,
+			/(?:^|[.!?]\s)None of this means\b/g,
+			/(?:^|[.!?]\s)(?:This|That|It)(?: isn't| is not|'s not) (?:just |really |only )?about\b/g,
+			/\b(?:isn't|is not|ain't) rocket science\b/gi
+		],
+		message: "It answers a doubt the reader did not raise.",
+		fix: "Cut it, or state the limit or the point plainly as a fact."
+	},
+	{
+		id: "cta-question",
+		family: "ai",
+		level: "error",
+		kinds: [
+			"heading",
+			"paragraph",
+			"prop",
+			"label"
+		],
+		description: "A sales question used as a heading or closing line: \"Ready to Simplify Your Practice Finances?\", \"Tired of spreadsheets?\".",
+		patterns: [/(?:^|[.!?]\s+)(?:Ready (?:to|for)|Tired of|Struggling (?:to|with)|Sick of|Fed up with)\b[^.!?]{1,80}\?/g],
+		message: "A sales question that asks the reader something only to answer it with a pitch.",
+		fix: "Say the offer or the next step as a plain statement, such as \"Start a free trial\" or the price."
 	}
 ];
+const RIDER = /,\s+(?:allowing|making|leaving|turning|giving|creating|delivering|letting|enabling|helping|offering|providing|bringing|adding|keeping|drifting|tumbling|converting|resulting|saving|freeing|ensuring|reflecting)\s[^.!?;]{0,120}/gi;
+function riderDensity(ctx) {
+	const rule = PHRASE_RULES.find((entry) => entry.id === "participle-tail");
+	if (ctx.level(rule) === "off") return;
+	const found = [];
+	for (const block of ctx.blocks(PROSE)) {
+		RIDER.lastIndex = 0;
+		for (const match of block.norm.matchAll(RIDER)) {
+			const start = match.index ?? 0;
+			found.push({
+				block,
+				start,
+				end: start + match[0].length
+			});
+		}
+	}
+	if (found.length < 2 || found.length * 250 < ctx.proseWords) return;
+	for (const item of found) ctx.hit(rule, item.block, item.start, item.end, `${found.length} ", -ing" riders in ${ctx.proseWords.toLocaleString("en-US")} words. Tacking a result onto each fact is a common AI habit.`, "End the sentence at the comma. If the rider holds a fact the text needs, give it its own sentence with a subject and verb.", "warning");
+}
 function quoted(text, start, end) {
 	return (text[start - 1] === "\"" || text[start - 1] === "'") && /^[.,;:!?]?["']/.test(text.slice(end, end + 2));
 }
 function runPhraseRules(ctx) {
+	const before = ctx.hits.length;
 	for (const rule of PHRASE_RULES) {
 		if (ctx.level(rule) === "off") continue;
 		for (const block of ctx.blocks(rule.kinds ?? ALL)) {
@@ -41246,6 +41491,9 @@ function runPhraseRules(ctx) {
 			}
 		}
 	}
+	riderDensity(ctx);
+	const vocabulary = ctx.hits.slice(before).filter((hit) => hit.rule === "ai-vocabulary");
+	if (vocabulary.length === 1) for (const hit of vocabulary) hit.level = "warning";
 }
 // packages/core/dist/serp/browser.js
 const SERP_PIXEL_BUDGETS = {
@@ -41400,7 +41648,7 @@ const SEO_RULES = {
 		id: "dash",
 		family: "copy",
 		level: "error",
-		description: "Em dashes, en dashes and spaced hyphens used as dashes in copy."
+		description: "Em dashes, en dashes and spaced hyphens used as dashes in copy. A separator in a title, such as \"Pricing - Example\", is left alone."
 	},
 	titleLength: {
 		id: "title-length",
@@ -41439,7 +41687,7 @@ const SEO_RULES = {
 		id: "emoji",
 		family: "copy",
 		level: "warning",
-		description: "Emoji at the start of headings or list items."
+		description: "Emoji at the start of headings or list items, and decorative emoji such as 🎉 or 🚀 anywhere."
 	},
 	exclamation: {
 		id: "exclamation",
@@ -41477,6 +41725,7 @@ function dash(ctx) {
 	for (const block of ctx.blocks(ALL)) {
 		re.lastIndex = 0;
 		for (const found of block.norm.matchAll(re)) {
+			if ((block.kind === "title" || block.kind === "label") && /^\s+\S*\s+$/.test(found[0])) continue;
 			const start = (found.index ?? 0) + (found[1] ? 1 : 0);
 			const end = (found.index ?? 0) + found[0].length;
 			const range = Boolean(found[1]);
@@ -41495,11 +41744,15 @@ function lengths(ctx) {
 		const length = block.text.length;
 		if (length >= low && length <= high) continue;
 		const what = title ? "title" : "description";
+		if (!length) {
+			ctx.hit(rule, block, 0, 0, `The ${what} is empty.`, title ? "Write a title that names the page, in 30 to 60 characters." : "Write one or two sentences that say what the page contains and who it is for, in 70 to 160 characters.", "error");
+			continue;
+		}
 		const pixels = Math.ceil(serpTextWidth(block.text, what));
 		ctx.hit(rule, block, 0, block.text.length, `The ${what} is ${length} characters, about ${pixels} pixels wide. Aim for ${low} to ${high} characters; Google shows about ${SERP_PIXEL_BUDGETS[what].desktop} pixels of a ${what} on desktop.`, length < low ? title ? "Add the words people search for, or one true reason to click, such as \"free\" or \"for any site\"." : "Say what the page contains and who it is for in one or two sentences." : title ? "Cut words after the main topic. Search results cut long titles off at about 60 characters." : "Cut it to one specific sentence. Search results cut descriptions off at about 160 characters.");
 	}
 }
-const HEADING_CLICHE = /^(?:a )?(?:deep dive|under the hood|demystifying\b|why (?:it|this|that) matters|a closer look|the ultimate guide|everything you need to know|mastering\b|unlocking\b|the power of\b|the future of\b|what you'll learn|key takeaways|final thoughts|wrapping up|conclusion|in conclusion|tl;?dr|overview|introduction|the road ahead|looking ahead|challenges and (?:legacy|opportunities|future)|future outlook|the bottom line|let's dive in|get started today)/i;
+const HEADING_CLICHE = /^(?:a )?(?:deep dive|under the hood|demystifying\b|why (?:it|this|that) matters|a closer look|the ultimate guide|everything you need to know|mastering\b|unlocking\b|the power of\b|the future of\b|what you'll learn|key takeaways|final thoughts|wrapping up|conclusion|in conclusion|tl;?dr|overview|introduction|the road ahead|looking ahead|challenges and (?:legacy|opportunities|future)|future outlook|the bottom line|let's dive in|get started today|(?:the )?(?:challenge|solution|results?)$|at a glance$|first impressions$|a note of thanks$)/i;
 function headings(ctx) {
 	const list = ctx.blocks(["heading"]);
 	const h1s = list.filter((block) => block.level === 1);
@@ -41513,7 +41766,17 @@ function headings(ctx) {
 	}
 }
 const EMOJI = /^\p{Extended_Pictographic}/u;
+const DECORATION = /[\u{1F389}\u{1F680}\u{2728}\u{1F525}\u{1F4A1}\u{1F64C}\u{1F44F}\u{1F4AA}\u{1F3AF}\u{1F449}]/gu;
 function emoji(ctx) {
+	for (const block of ctx.blocks(ALL)) {
+		if (block.kind === "heading" || block.kind === "list") {
+			if (EMOJI.test(block.text)) continue;
+		}
+		for (const found of block.text.matchAll(DECORATION)) {
+			const at = found.index ?? 0;
+			ctx.hit(SEO_RULES.emoji, block, at, at + found[0].length, `A decorative ${found[0]} emoji.`, "Remove it. The words should carry the point.");
+		}
+	}
 	for (const block of ctx.blocks(["heading", "list"])) if (EMOJI.test(block.text)) ctx.hit(SEO_RULES.emoji, block, 0, Math.min(block.text.length, 40), `An emoji opens this ${block.kind === "heading" ? "heading" : "list item"}.`, "Remove it. The words should carry the point.");
 }
 function exclamation(ctx) {
@@ -41591,7 +41854,7 @@ function reviews(ctx) {
 			PROOF.lastIndex = 0;
 			for (const found of block.norm.matchAll(PROOF)) ctx.review("proof", block, found.index ?? 0, (found.index ?? 0) + found[0].length, `Is there a source for "${found[0]}" on the page? Link it or say where the number comes from.`);
 		}
-		if (block.kind === "paragraph" && block.endsSection && sentences.length === 1 && words$2(block.text).length <= 10) ctx.review("mic-drop", block, 0, block.text.length, "Does this closing line add a fact? If it only restates the paragraph above, cut it.");
+		if (block.kind === "paragraph" && block.endsSection && sentences.length === 1 && words$2(block.text).length <= 10 && words$2(block.text).filter((word) => /[a-z]/i.test(word)).length >= 3 && /[.!?]["')]?$/.test(block.text)) ctx.review("mic-drop", block, 0, block.text.length, "Does this closing line add a fact? If it only restates the paragraph above, cut it.");
 	}
 	if (ctx.preset === "landing" || ctx.preset === "meta") for (const block of ctx.blocks([
 		"title",
@@ -41599,6 +41862,7 @@ function reviews(ctx) {
 		"heading"
 	])) {
 		if (block.kind === "heading" && block.level !== 1) continue;
+		if (!block.text) continue;
 		const later = words$2(block.text).slice(1);
 		if (/\d/.test(block.text) || later.some((word) => /^[A-Z]/.test(word))) continue;
 		ctx.review("swap-test", block, 0, block.text.length, "Would this line work unchanged on a competitor's page? If so, add the product, number or result only you can claim.");
@@ -41652,7 +41916,7 @@ const STRUCTURE_RULES = {
 		id: "pithy-fragment",
 		family: "ai",
 		level: "error",
-		description: "A verbless two-beat fragment: \"Same essay, two titles.\" \"Simple, but powerful.\""
+		description: "Verbless slogan fragments: \"Same essay, two titles.\", \"Every month. No exceptions.\", \"$299 per month. That's it.\""
 	},
 	stockCloser: {
 		id: "stock-closer",
@@ -41676,7 +41940,7 @@ const STRUCTURE_RULES = {
 		id: "anaphora",
 		family: "ai",
 		level: "error",
-		description: "Three or more very short sentences in a row that start with \"No\", \"It's\", \"They\", \"We\" or \"You\": \"No cookies. No tracking. No banners.\""
+		description: "Short sentences in a row that start with the same word: two or more \"No ...\" sentences, or three or more starting \"It's\", \"They\", \"We\" or \"You\"."
 	},
 	vocabularyCluster: {
 		id: "ai-vocabulary-cluster",
@@ -41689,7 +41953,7 @@ const STRUCTURE_RULES = {
 		family: "ai",
 		level: "warning",
 		presets: { docs: "off" },
-		description: "Lists of three, more often than about one per 100 words, or three abstract nouns in a row."
+		description: "Formula triads: three parallel clauses (\"It is cheap, it is reversible, and it works\"), three items that open with the same word, three adjectives after \"is\", or three abstract nouns. Plain lists of three are left alone."
 	},
 	inventedLabel: {
 		id: "invented-label",
@@ -41703,6 +41967,16 @@ const STRUCTURE_RULES = {
 		level: "warning",
 		description: "Repeated \"What makes this work is ...\" or \"The problem is that ...\" setups."
 	},
+	boldEmphasis: {
+		id: "bold-emphasis",
+		family: "ai",
+		level: "warning",
+		presets: {
+			docs: "off",
+			meta: "off"
+		},
+		description: "Bold used for emphasis more than about once per 100 words of prose."
+	},
 	boldLabels: {
 		id: "bold-label-bullets",
 		family: "ai",
@@ -41761,6 +42035,11 @@ function negativeParallelism(ctx) {
 				const from = restate ? end - restate[0].length : end;
 				const second = block.text.slice(from, after.end).trim();
 				const fix = second ? `Drop the "isn't" half and state the claim: "${second.charAt(0).toUpperCase()}${second.slice(1)}"` : "Drop the \"isn't\" half and state the claim once.";
+				const concession = (/,\s*but\s+(?:[\w']+\s*){1,3}$/i.test(found[0]) || /^(?:while|although|though|even though)\b/i.test(subject)) && kind !== "reveal";
+				if (level === "warning" && firstWords > 12 || concession) {
+					ctx.review("contrast", block, sentence.start, Math.max(after.end, end), "Does this \"isn't X ... it's Y\" correct something a reader would really think? If not, state the claim once.");
+					continue;
+				}
 				ctx.hit(rule, block, sentence.start, Math.max(after.end, end), "An \"isn't X, it's Y\" reframe argues with a claim nobody made.", fix, ctx.level(rule) === "off" ? void 0 : level);
 			}
 		}
@@ -41793,13 +42072,20 @@ function gerund(word) {
 	const lower = word.toLowerCase();
 	return lower.length > 4 && lower.endsWith("ing") && !NOT_GERUND.has(lower);
 }
+const NOT_JUST = /,\s+not (?:just|merely|simply) [^,.;:!?]{1,50}[.!?]?$|\bnot (?:just|merely|simply) [^,.;:!?]{1,50},? but\b/i;
 function contrastReframe(ctx) {
 	const rule = STRUCTURE_RULES.contrastReframe;
 	if (ctx.level(rule) === "off") return;
 	for (const block of ctx.blocks([...SENTENCE_KINDS, "heading"])) for (const sentence of ctx.sentences(block)) {
 		const text = sentence.text;
+		const just = NOT_JUST.exec(text);
+		if (just && (just[0].startsWith(",") || words$2(text).length <= 16) && !insideQuotes(block.norm, sentence.start + just.index, sentence.start + just.index + just[0].length)) {
+			ctx.hit(rule, block, sentence.start, sentence.end, "A \"not just X\" contrast inflates the claim instead of stating it.", "Say what it is or does in one plain clause, and drop the \"not just\" half.");
+			continue;
+		}
 		for (const found of text.matchAll(/,\s+not\s+|\s+rather than\s+/gi)) {
 			const at = found.index ?? 0;
+			if (insideQuotes(block.norm, sentence.start + at, sentence.start + at + found[0].length)) continue;
 			const rather = /rather/i.test(found[0]);
 			const left = text.slice(0, at);
 			const rightAll = text.slice(at + found[0].length);
@@ -41844,8 +42130,13 @@ function heresAnnouncement(ctx) {
 		if (!/^(?:And |So |But )?Here(?:'s| is| are) (?:the|what|why|how|who|where|when|a|an|my|our|some|two|three|four|five)\b/i.test(text) || /^(?:And |So |But )?Here's the (?:thing|deal|kicker|catch|twist|truth|secret|reality)\b/i.test(text)) continue;
 		const count = words$2(text).length;
 		const colon = text.endsWith(":");
+		const sentences = ctx.sentences(block);
+		if (sentence === sentences[sentences.length - 1]) {
+			const after = ctx.doc.source.slice((block.map[block.map.length - 1] ?? 0) + 1).replace(/^[^\n]*\n/, "").trimStart();
+			if (/^(?:!\[|<(?:img|figure|picture|video|iframe|blockquote|table)\b|>|\|)/i.test(after)) continue;
+		}
 		let level = null;
-		if (colon && count <= 4) level = "error";
+		if (colon && count <= 5) level = "error";
 		else if (!colon && !text.endsWith("?")) {
 			if (count <= 9) level = "error";
 			else if (count <= 16) level = "warning";
@@ -41863,9 +42154,29 @@ const TWO_BEAT = [
 const GREETING = /^(?:hi|hello|hey|thanks|thank you|cheers|dear|yes|no|ok|okay|sure|well|oh|example|note|tip|warning|update|step \d)\b/i;
 const LEADING_CLAUSE = /^(?:without|with|for|in|on|at|after|before|if|when|once|since|until|unless|by|from|to|then|also|first|next|finally|instead|otherwise|please)\b/i;
 const MONTH = /\b(?:january|february|march|april|may|june|july|august|september|october|november|december|monday|tuesday|wednesday|thursday|friday|saturday|sunday)\b/i;
+const KICKER = /^(?:That's it|That's all|No exceptions|No catch|No strings attached|No surprises|No asterisks|Period|Full stop|Simple as that|It's that simple|That simple|Nothing more|Nothing else)[.!]$/i;
+function slogan(text) {
+	const list = words$2(text);
+	return /[.!]$/.test(text) && !/^Not\b/.test(text) && list.length >= 1 && list.length <= 4 && !GREETING.test(text) && !MONTH.test(text) && !list.every((word) => /^[A-Z0-9]/.test(word)) && verbless(text);
+}
+function fragmentRuns(ctx, rule) {
+	for (const block of ctx.blocks(RHYTHM_KINDS)) {
+		const sentences = ctx.sentences(block);
+		for (let i = 1; i < sentences.length; i++) {
+			const before = sentences[i - 1];
+			const sentence = sentences[i];
+			const kicker = KICKER.test(sentence.text) && words$2(before.text).length <= 8;
+			const pair = slogan(before.text) && slogan(sentence.text);
+			if (!kicker && !pair) continue;
+			ctx.hit(rule, block, before.start, sentence.end, kicker ? `"${sentence.text}" is a kicker added for rhythm after a short line.` : "Two verbless fragments in a row read as a slogan, not a sentence.", "Join them into one plain sentence with a verb, such as \"Books close within 48 hours of month end, every month,\" or cut the kicker.");
+			i++;
+		}
+	}
+}
 function pithyFragment(ctx) {
 	const rule = STRUCTURE_RULES.pithyFragment;
 	if (ctx.level(rule) === "off") return;
+	fragmentRuns(ctx, rule);
 	for (const block of ctx.blocks(RHYTHM_KINDS)) for (const sentence of ctx.sentences(block)) {
 		const text = sentence.text;
 		if (!/[.!]$/.test(text)) continue;
@@ -41904,7 +42215,7 @@ const FIGURATIVE_NOUNS = "fights?|battles?|hills?|wars?|bets?|gambles?|races?|ri
 function figurativeWorth(ctx) {
 	const rule = STRUCTURE_RULES.figurativeWorth;
 	const strong = new RegExp(`\\b(?:${FIGURATIVE_NOUNS}) worth \\w+ing\\b`, "gi");
-	const reader = /\bworth (?:noting|mentioning|knowing|highlighting|calling out|pointing out|flagging|a (?:closer |second )?look|your time|the (?:wait|hype|effort|read))\b/gi;
+	const reader = /\bworth (?:noting|mentioning|knowing|highlighting|calling out|pointing out|flagging|a (?:closer |second )?look)\b/gi;
 	const any = /\b(\w+) worth (\w+ing)\b/gi;
 	for (const block of ctx.blocks([
 		...RHYTHM_KINDS,
@@ -41956,7 +42267,9 @@ function anaphora(ctx) {
 			const first = words$2(sentences[i].text)[0]?.toLowerCase();
 			let j = i + 1;
 			while (j < sentences.length && first && words$2(sentences[j].text)[0]?.toLowerCase() === first) j++;
-			if (j - i >= 3 && first && ![
+			const run = sentences.slice(i, j);
+			if (first === "no" && j - i >= 2 && run.every((sentence) => /^No (?!one\b|matter\b|doubt\b|longer\b|way\b|wonder\b)[a-z$\d]/.test(sentence.text) && words$2(sentence.text).length <= 12)) ctx.hit(rule, block, sentences[i].start, sentences[j - 1].end, `${j - i} sentences in a row start with "No", a drumbeat of things the product is not.`, "Say what it is in one sentence, and keep only the one \"no\" a reader needs, such as \"One flat monthly fee with no tiers.\"");
+			else if (j - i >= 3 && first && ![
 				"the",
 				"a",
 				"an",
@@ -41967,7 +42280,7 @@ function anaphora(ctx) {
 				"it",
 				"this"
 			].includes(first)) {
-				if (sentences.slice(i, j).every((sentence) => words$2(sentence.text).length <= 7) && /^(?:it's|no|they|we|you)$/.test(first)) ctx.hit(rule, block, sentences[i].start, sentences[j - 1].end, `${j - i} short sentences in a row start with "${first}".`, "Merge them into one sentence or a short list.");
+				if (run.every((sentence) => words$2(sentence.text).length <= 7) && /^(?:it's|they|we|you)$/.test(first)) ctx.hit(rule, block, sentences[i].start, sentences[j - 1].end, `${j - i} short sentences in a row start with "${first}".`, "Merge them into one sentence or a short list.");
 				else ctx.review("anaphora", block, sentences[i].start, sentences[j - 1].end, `${j - i} sentences in a row start with "${first}". Does the repeat help the reader follow a real list, or is it there for rhythm?`);
 			}
 			i = j;
@@ -42008,30 +42321,66 @@ function vocabularyCluster(ctx) {
 		}
 	}
 }
-const TRIAD = /\b[\w'-]+(?: [\w'-]+){0,2}, [\w'-]+(?: [\w'-]+){0,2},? and [\w'-]+\b/g;
+const SERIES = /\b[\w'$-]+(?: [\w'$-]+){0,5}(?:, [\w'$-]+(?: [\w'$-]+){0,5}){1,3},? (?:and|or) [\w'$-]+(?: [\w'$-]+){0,5}/g;
 const ABSTRACT_TRIAD = /\b[a-z]+(?:tion|sion|ity|ness|ment|ence|ance|ism), (?:and )?[a-z]+(?:tion|sion|ity|ness|ment|ence|ance|ism),? and [a-z]+(?:tion|sion|ity|ness|ment|ence|ance|ism)\b/gi;
+const ECHO = new Set("to our your their my his her its every each more less no it they we you".split(" "));
+const COPULA = /\b(?:is|are|was|were|'s|feels?|felt|looks?|stays?|remains?|seems?)\s+$/i;
+function formulaTriad(items, before) {
+	const firsts = items.map((item) => words$2(item)[0]?.toLowerCase() ?? "");
+	const echo = firsts[0] ?? "";
+	if (ECHO.has(echo) && firsts.every((first) => first === echo)) return `Each item opens with "${echo}".`;
+	if (items.every((item) => /^(?:the|their|our|your|its|it|they|we|you|he|she)\b/i.test(item) && words$2(item).length >= 3 && words$2(item).length <= 7 && !verbless(item))) return "Three parallel clauses in a row.";
+	if (items.every((item) => /^[a-z]/.test(item) && words$2(item).length <= 2 && !PREPOSITIONS.has(words$2(item)[0] ?? "")) && COPULA.test(before)) return "A string of adjectives after \"is\".";
+	if (items.every((item) => /^\w+ed\b/i.test(item) && words$2(item).length <= 3)) return "A string of past participles.";
+	return null;
+}
 function triads(ctx) {
 	const rule = STRUCTURE_RULES.triad;
 	if (ctx.level(rule) === "off") return;
-	const found = [];
 	for (const block of ctx.blocks([
 		"paragraph",
 		"quote",
-		"prop"
+		"prop",
+		"list"
 	])) {
-		TRIAD.lastIndex = 0;
-		for (const match of block.norm.matchAll(TRIAD)) found.push({
-			block,
-			start: match.index ?? 0,
-			end: (match.index ?? 0) + match[0].length
-		});
+		const taken = [];
 		ABSTRACT_TRIAD.lastIndex = 0;
-		for (const match of block.norm.matchAll(ABSTRACT_TRIAD)) ctx.hit(rule, block, match.index ?? 0, (match.index ?? 0) + match[0].length, "Three abstract nouns in a row sound weighty but say little.", "Keep the one that matters and give an example of it.");
-	}
-	const limit = Math.max(3, Math.ceil(ctx.proseWords / 100));
-	if (found.length > limit) {
-		const third = found[limit];
-		ctx.hit(rule, third.block, third.start, third.end, `${found.length} lists of three in ${ctx.proseWords.toLocaleString("en-US")} words of prose. More than about one per 100 words sounds formulaic.`, "Turn some of them into two items, four items or a sentence that ranks them.");
+		for (const match of block.norm.matchAll(ABSTRACT_TRIAD)) {
+			const start = match.index ?? 0;
+			taken.push([start, start + match[0].length]);
+			ctx.hit(rule, block, start, start + match[0].length, "Three abstract nouns in a row sound weighty but say little.", "Keep the one that matters and give an example of it.");
+		}
+		for (const sentence of ctx.sentences(block)) {
+			SERIES.lastIndex = 0;
+			for (const match of sentence.text.matchAll(SERIES)) {
+				let from = match.index ?? 0;
+				const raw = match[0].split(/,\s*(?:(?:and|or)\s+)?|\s+(?:and|or)\s+(?=[^,]*$)/);
+				if (raw.length < 3) continue;
+				const items = [...raw];
+				const head = raw[0] ?? "";
+				const lead = /^.*\b(?:is|are|was|were|'s|feels?|looks?|stays?|remains?|seems?|of|for|to|with|by|from|on|in|like|including|as)\s+/i.exec(head);
+				if (lead && words$2(head.slice(lead[0].length)).length) {
+					items[0] = head.slice(lead[0].length);
+					from += lead[0].length;
+				}
+				const end = sentence.start + (match.index ?? 0) + match[0].length;
+				const before = block.norm.slice(sentence.start, sentence.start + from);
+				const echo = words$2(raw[1] ?? "")[0]?.toLowerCase() ?? "";
+				const inFirst = new RegExp(`\\b${echo}\\b(?!.*\\b${echo}\\b)`, "i").exec(head);
+				if (ECHO.has(echo) && inFirst && inFirst.index > 0) {
+					items[0] = head.slice(inFirst.index);
+					from = (match.index ?? 0) + inFirst.index;
+				}
+				const plain = formulaTriad(raw, "");
+				const why = plain ?? formulaTriad(items, before);
+				if (!why) continue;
+				if (plain) from = match.index ?? 0;
+				const start = sentence.start + from;
+				if (taken.some(([a, b]) => start < b && end > a)) continue;
+				taken.push([start, end]);
+				ctx.hit(rule, block, start, end, `A list of ${items.length} that reads as a formula. ${why}`, "Keep the items the reader needs. If all of them are needed, write them plainly or as two sentences; if one was added for rhythm, cut it.");
+			}
+		}
 	}
 }
 function countedPatterns(ctx) {
@@ -42082,6 +42431,42 @@ function boldLabels(ctx) {
 	}
 	report();
 }
+function boldEmphasis(ctx) {
+	const rule = STRUCTURE_RULES.boldEmphasis;
+	if (ctx.level(rule) === "off") return;
+	const markdown = ctx.doc.format === "md" || ctx.doc.format === "mdx";
+	const re = markdown ? /(\*\*|__)(?=\S)[^*_\n]+?\1/g : /<(strong|b)\b[^>]*>[^<]{1,200}<\/\1>/gi;
+	const prose = ctx.blocks([
+		"paragraph",
+		"list",
+		"quote",
+		"prop"
+	]);
+	const spans = [];
+	for (const found of ctx.doc.source.matchAll(re)) {
+		const open = markdown ? 2 : found[0].indexOf(">") + 1;
+		const from = (found.index ?? 0) + open;
+		const to = (found.index ?? 0) + found[0].length - (markdown ? 2 : found[0].length - found[0].lastIndexOf("<"));
+		for (const block of prose) {
+			const first = block.map[0] ?? 0;
+			const last = block.map[block.map.length - 1] ?? 0;
+			if (from < first || from > last) continue;
+			const start = block.map.indexOf(from);
+			if (start <= 0 && block.kind === "list") break;
+			if (start < 0) break;
+			let end = start;
+			while (end < block.map.length && (block.map[end] ?? 0) < to) end++;
+			spans.push({
+				block,
+				start,
+				end
+			});
+			break;
+		}
+	}
+	if (spans.length < 3 || spans.length * 100 <= ctx.proseWords) return;
+	for (const span of spans) ctx.hit(rule, span.block, span.start, span.end, `${spans.length} bold phrases in ${ctx.proseWords.toLocaleString("en-US")} words of prose. Bold this often stops meaning "important".`, "Remove the bold here. Keep bold, if any, for the one thing a skimming reader must not miss.");
+}
 function runStructureRules(ctx) {
 	negativeParallelism(ctx);
 	contrastReframe(ctx);
@@ -42095,6 +42480,7 @@ function runStructureRules(ctx) {
 	triads(ctx);
 	countedPatterns(ctx);
 	boldLabels(ctx);
+	boldEmphasis(ctx);
 }
 // packages/core/dist/lint/types.js
 const LINT_PRESETS = [
@@ -42129,6 +42515,37 @@ const LINT_RULES = [
 	})),
 	...Object.values(SEO_RULES)
 ];
+const LINT_REVIEW_LENSES = {
+	contrast: "A \", not X\" tail that may or may not be a needed correction.",
+	metaphor: "A figure of speech that may not fit, such as a thing that \"waits\" or \"wants\".",
+	evidence: "A superlative with no number or source nearby.",
+	"mic-drop": "A short closing line that may only restate the paragraph.",
+	"swap-test": "A headline or description that could sit on a competitor’s page unchanged.",
+	proof: "A customer count or percentage that needs a source.",
+	staccato: "Three or more very short sentences in a row that may be a drumbeat.",
+	anaphora: "Several sentences in a row that open with the same word, for rhythm."
+};
+function lintRulesText(only) {
+	const keep = (category) => !only?.length || only.includes(category);
+	const lines = [];
+	for (const category of LINT_CATEGORIES) {
+		if (!keep(category)) continue;
+		lines.push(`${CATEGORY_NAMES[category]} (${category})`);
+		for (const rule of LINT_RULES) {
+			if (rule.family !== category) continue;
+			const presets = Object.entries(rule.presets ?? {}).map(([preset, level]) => `${preset} ${level}`).join(", ");
+			lines.push(`  ${rule.id}  ${rule.level}${presets ? ` (${presets})` : ""}`, `      ${rule.description}`);
+		}
+		const lenses = Object.entries(LINT_REVIEW_LENSES).filter(([lens]) => lensCategory(lens) === category);
+		if (lenses.length) {
+			lines.push("  Review lenses (judgement calls, never errors):");
+			for (const [lens, description] of lenses) lines.push(`  ${lens}`, `      ${description}`);
+		}
+		lines.push("");
+	}
+	lines.push("Skip a rule with --ignore <id>, or one line with a <!-- seo-lint-ignore <id> --> comment above it.");
+	return lines.join("\n");
+}
 const AI_RULES = new Set(LINT_RULES.filter((rule) => rule.family === "ai").map((rule) => rule.id));
 const RULE_CATEGORY = new Map(LINT_RULES.map((rule) => [rule.id, rule.family]));
 const LENS_CATEGORY = {
@@ -44231,16 +44648,18 @@ async function analyticsBeside(access, site, range, before, pages) {
 }
 // packages/core/dist/commands/audit.js
 const AUDIT_SECTION = "weekly-audit";
-const AUDIT_SECTION_TEXT = "What the weekly crawl of the site found (broken and redirected internal links, missing or duplicate titles, descriptions and H1s, noindex, canonicals to another page, sitemap URLs that do not return 200, thin pages, tags that JavaScript changes), with what is new, back or resolved since the crawl before. Only for sites added to the weekly site audit beta.";
+const AUDIT_SECTION_TEXT = "What the weekly crawl of the site found (broken and redirected internal links, missing, empty or duplicate titles and descriptions, missing H1s, noindex for Google, canonicals to another page, sitemap URLs that do not return 200, thin pages, tags that JavaScript changes), with what is new, back or resolved since the crawl before. Only for sites added to the weekly site audit beta.";
 const AUDIT_RULES = {
 	link_to_error: "Internal links to a page that returns an error",
 	link_to_redirect: "Internal links to a redirect",
 	link_failed: "Internal links to a page that could not be fetched",
 	title_missing: "Pages with no title",
+	title_empty: "Pages with an empty title",
 	title_duplicate: "Titles used by more than one page",
 	description_missing: "Pages with no meta description",
+	description_empty: "Pages with an empty meta description",
 	h1_missing: "Pages with no H1",
-	noindex: "Pages that ask not to be indexed",
+	noindex: "Pages that ask Google not to index them",
 	canonical_elsewhere: "Pages whose canonical is another URL",
 	sitemap_url_not_ok: "Sitemap URLs that do not return 200",
 	sitemap_page_unlinked: "Sitemap pages no crawled page links to (heuristic: the crawl may not reach every page)",
@@ -46131,6 +46550,19 @@ async function pageSource(url, readPage) {
 	};
 }
 async function runLint(input, readFiles, readPage) {
+	if (input.rules) {
+		const only = input.only?.length ? input.only : void 0;
+		return {
+			text: lintRulesText(only),
+			data: { rules: LINT_RULES.filter((rule) => !only || only.includes(rule.family)).map(({ id, family, level, presets, description }) => ({
+				id,
+				category: family,
+				level,
+				...presets ? { presets } : {},
+				description
+			})) }
+		};
+	}
 	const hasText = typeof input.text === "string" && input.text.length > 0;
 	const hasPaths = Boolean(input.paths?.length);
 	const hasUrl = typeof input.url === "string" && input.url.length > 0;
@@ -47627,13 +48059,14 @@ async function runPage(input, deps) {
 	deps.progress?.(`Checking ${input.url}: the live page, Google index status, sitemaps and Search Console queries.`);
 	const [live, inspection, sitemap, [now, then], markdown] = await Promise.all([
 		leg("live page", deps.liveCheck(input.url), (value) => `Live page: ${value.first.status ?? value.first.error ?? "no answer"}${value.hops.length ? ` and ${value.hops.length} redirects` : ""}`),
-		leg("Google index status", inspectWithin(deps, input), (value) => value.index ? `Google index status: ${value.index.coverage ?? value.index.verdict ?? "no reason returned"}` : `Google index status: not available (${value.error?.code})`),
+		leg("Google index status", inspectWithin(deps, input), (value) => value.index ? `Google index status: ${value.index.coverage ?? value.index.verdict ?? "no reason returned"}${value.savedAt ? ` (saved from ${value.savedAt})` : ""}` : `Google index status: not available (${value.error?.code})`),
 		leg("sitemaps", sitemapUrls(input.site), (value) => `Sitemaps: ${value.urls.length} URLs from ${value.files} ${value.files === 1 ? "file" : "files"}${value.partial ? " (partial)" : ""}`),
 		leg("Search Console queries", Promise.all([query(range), query(before)]), ([current]) => `Search Console: ${current.rows.length} queries`),
 		full && deps.pageMarkdown ? leg("main content", deps.pageMarkdown(input.url).catch((error) => ({ error: error instanceof Error ? error.message : String(error) })), () => "Main content read") : null
 	]);
 	const indexed = inspection.index;
 	const indexError = inspection.error;
+	const savedAt = inspection.savedAt;
 	const facts = live.first;
 	const reason = indexed ? indexingRow({
 		url: input.url,
@@ -47680,7 +48113,7 @@ async function runPage(input, deps) {
 				title: `${input.url} in ${input.site}, ${range.startDate} to ${range.endDate} against ${before.startDate} to ${before.endDate}.`,
 				notes: [
 					`Live page (fetched now):\n${pageFactsTable([facts], null)}${live.hops.length ? `\nRedirects: ${live.hops.map((hop) => `${hop.status} to ${hop.to}`).join(", ")}${live.last ? `, which returns ${live.last.status ?? live.last.error}` : ", then loop or pass 5 hops"}.` : ""}`,
-					indexed ? `Google index status:\n${table$1([indexed], Object.keys(indexed), null)}` : indexErrorText(indexError, input, deps),
+					indexed ? `Google index status${savedAt ? ` (from the inspection saved at ${savedAt}, within the last 7 days, so no quota was used; in the CLI, add --refresh to ask Google again)` : ""}:\n${table$1([indexed], Object.keys(indexed), null)}` : indexErrorText(indexError, input, deps),
 					...reason ? [`Google's reason: ${reason.reason}. Label: ${reason.label}. ${reason.why} (Labels are rules over this evidence, not Google's; ${deps.call("index")} explains them.)`] : [],
 					...indexed && /^URL is unknown to Google$/i.test(indexed.coverage ?? "") ? [unknownNext(input, sitemap.urls.includes(input.url), deps)] : [],
 					`Query totals: clicks ${sum(now.rows, "clicks")} (was ${sum(then.rows, "clicks")}), impressions ${sum(now.rows, "impressions")} (was ${sum(then.rows, "impressions")}). Search Console hides rare queries, so these can be lower than the page total.`,
@@ -47710,6 +48143,7 @@ async function runPage(input, deps) {
 			page: facts,
 			index: indexed,
 			indexError,
+			indexInspectedAt: savedAt,
 			reason,
 			totalQueries: rows.length,
 			queries: rows.slice(offset, offset + 50),
@@ -47719,6 +48153,14 @@ async function runPage(input, deps) {
 }
 const INSPECT_TIMEOUT_MS = 6e4;
 async function inspectWithin(deps, input) {
+	try {
+		const saved = deps.savedInspections?.read(input.site, [input.url]).get(input.url);
+		if (saved) return {
+			index: saved.status,
+			error: null,
+			savedAt: saved.inspectedAt
+		};
+	} catch {}
 	let timer;
 	const stop = new AbortController();
 	const timeout = new Promise((resolve) => {
@@ -47731,17 +48173,25 @@ async function inspectWithin(deps, input) {
 		}, INSPECT_TIMEOUT_MS);
 	});
 	try {
-		return await Promise.race([deps.inspect(input.site, input.url, stop.signal).then((index) => ({
-			index,
-			error: null
-		})), timeout.then((error) => ({
+		return await Promise.race([deps.inspect(input.site, input.url, stop.signal).then((index) => {
+			try {
+				deps.savedInspections?.save(input.site, input.url, index);
+			} catch {}
+			return {
+				index,
+				error: null,
+				savedAt: null
+			};
+		}), timeout.then((error) => ({
 			index: null,
-			error
+			error,
+			savedAt: null
 		}))]);
 	} catch (error) {
 		const known = commandErrorFrom(error);
 		return {
 			index: null,
+			savedAt: null,
 			error: {
 				code: known instanceof CommandError ? known.code : "GOOGLE_ERROR",
 				message: known instanceof Error ? known.message : String(known)
@@ -48243,7 +48693,8 @@ const lintInput = {
 	meta_kind: z.enum(LINT_META_KINDS).optional().describe("Optional, with the meta preset: title or description, what a line with no \"title:\" or \"description:\" label is. Default: a line up to 70 characters is a title, a longer one a description."),
 	ignore_rules: z.array(z.string().min(1).max(60)).max(50).optional().describe("Optional rule ids or review lenses to skip."),
 	only: z.array(z.enum(LINT_CATEGORIES)).max(LINT_CATEGORIES.length).optional().describe("Optional categories to check: ai (patterns common in AI-written text), copy (weak copy and house style, such as dashes) or seo (titles, descriptions, headings). Default: all."),
-	ignore_phrases: z.array(z.string().min(1).max(200)).max(50).optional().describe("Optional phrases to allow, such as a product name a rule keeps matching.")
+	ignore_phrases: z.array(z.string().min(1).max(200)).max(50).optional().describe("Optional phrases to allow, such as a product name a rule keeps matching."),
+	rules: z.boolean().optional().describe("Optional. true lists every rule with its id, category, level and description instead of checking text; only limits the list, such as only [\"ai\"].")
 };
 const SHARED_TOOLS = [
 	tool({
@@ -48520,7 +48971,8 @@ const SHARED_TOOLS = [
 				ignoreRules: input.ignore_rules,
 				ignorePhrases: input.ignore_phrases,
 				only: input.only,
-				metaKind: input.meta_kind
+				metaKind: input.meta_kind,
+				rules: input.rules
 			}, surface.readFiles, pageMarkdown && ((url) => pageMarkdown(url, 2e5)));
 		}
 	})