From 9c85c08c3f753fbced7afa019d1276adb783e10f Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Mon, 31 Aug 2026 19:28:58 +0200
Subject: [PATCH 01/38] Add tab for llms.txt to Crawling & AI section

---
 resources/js/pages/robots/Edit.vue | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/resources/js/pages/robots/Edit.vue b/resources/js/pages/robots/Edit.vue
index 84f79a28..2fd93a61 100644
--- a/resources/js/pages/robots/Edit.vue
+++ b/resources/js/pages/robots/Edit.vue
@@ -274,6 +274,7 @@ onUnmounted(() => {
 		<Tabs v-model="activeTab" :unmount-on-hide="false">
 			<TabList>
 				<TabTrigger name="robots.txt" text="robots.txt" />
+				<TabTrigger name="llms.txt" text="llms.txt" />
 			</TabList>
 
 			<TabContent name="robots.txt">
@@ -466,6 +467,10 @@ onUnmounted(() => {
 					/>
 				</div>
 			</TabContent>
+
+			<TabContent name="llms.txt">
+				<div class="pt-6" />
+			</TabContent>
 		</Tabs>
 	</div>
 </template>

From d3ae8463f4fea7450637267a011d577d5353a186 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Tue, 1 Sep 2026 18:23:31 +0200
Subject: [PATCH 02/38] Add initial feature implementation

---
 lang/en/messages.php                         |  47 ++
 resources/js/pages/llms/Tab.vue              | 356 +++++++++++++
 resources/js/pages/robots/Edit.vue           |  20 +-
 routes/cp.php                                |   5 +
 routes/web.php                               |   7 +
 src/Cascade.php                              |  11 +
 src/Events/LlmsTxtGenerated.php              |  24 +
 src/Http/Controllers/CP/LlmsController.php   | 179 +++++++
 src/Http/Controllers/CP/RobotsController.php |   1 +
 src/Http/Controllers/LlmsController.php      |  46 ++
 src/Llms/Llms.php                            | 216 ++++++++
 src/Llms/LlmsDocument.php                    |  18 +
 src/Llms/LlmsRenderCache.php                 |  49 ++
 src/Llms/LlmsRenderer.php                    | 202 ++++++++
 src/Llms/LlmsTxtGenerator.php                | 502 +++++++++++++++++++
 src/ServiceProvider.php                      |  15 +
 16 files changed, 1695 insertions(+), 3 deletions(-)
 create mode 100644 resources/js/pages/llms/Tab.vue
 create mode 100644 src/Events/LlmsTxtGenerated.php
 create mode 100644 src/Http/Controllers/CP/LlmsController.php
 create mode 100644 src/Http/Controllers/LlmsController.php
 create mode 100644 src/Llms/Llms.php
 create mode 100644 src/Llms/LlmsDocument.php
 create mode 100644 src/Llms/LlmsRenderCache.php
 create mode 100644 src/Llms/LlmsRenderer.php
 create mode 100644 src/Llms/LlmsTxtGenerator.php

diff --git a/lang/en/messages.php b/lang/en/messages.php
index 51174ce9..5a4f7d7f 100644
--- a/lang/en/messages.php
+++ b/lang/en/messages.php
@@ -7,6 +7,53 @@
     'robots_description' => 'Manage robots.txt, AI crawler access, content-use preferences, and sitemap discovery.',
     'edit_robots' => 'Edit robots.txt settings',
     'robots_txt_generated' => 'robots.txt generated',
+    'llms_txt_generated' => 'llms.txt generated',
+    'llms_txt' => [
+        'unable_to_load_settings' => 'Unable to load llms.txt settings',
+        'unable_to_save_settings' => 'Unable to save llms.txt settings',
+        'unable_to_save_settings_writable' => 'Unable to save llms.txt settings. Make sure the addon settings and managed file are writable.',
+        'unable_to_generate' => 'Unable to generate llms.txt',
+        'already_up_to_date' => 'llms.txt is already up to date',
+        'managed' => 'Managed',
+        'custom_source' => 'Custom source',
+        'view_live_file' => 'View live file',
+        'existing_file_unmanaged' => 'An existing llms.txt file is not managed by SEO Pro',
+        'existing_file_unmanaged_description' => 'SEO Pro will not overwrite or remove this file. It may take precedence over the cached llms.txt route.',
+        'disabled' => 'llms.txt is disabled',
+        'disabled_description' => 'Enable it to publish the cached route. The feature is opt-in and returns a 404 while disabled.',
+        'needs_generation' => 'The physical llms.txt file needs to be generated',
+        'needs_generation_description' => 'The current environment or saved settings differ from the managed physical file.',
+        'managed_by_seo_pro' => 'The physical llms.txt file is managed by SEO Pro',
+        'cached_route_active' => 'The cached llms.txt route is active',
+        'cached_route_active_description' => 'No physical file exists. Generate one if this deployment should serve or commit a static file.',
+        'enable' => 'Enable llms.txt',
+        'enable_description' => 'Publish a curated Markdown guide for language models and agents.',
+        'editing_mode' => 'Editing mode',
+        'editing_mode_instructions' => 'Managed mode builds a validated document. Custom source mode gives you complete Markdown control.',
+        'title' => 'Site or project name',
+        'title_instructions' => 'Required when enabled. Antlers is supported, for example {{ config:app:name }}.',
+        'summary' => 'Short summary',
+        'summary_instructions' => 'Optional. Rendered as the introductory blockquote.',
+        'details' => 'Additional context',
+        'details_instructions' => 'Optional Markdown placed before the file lists. Use sections below instead of headings here.',
+        'sections' => 'File-list sections',
+        'sections_description' => 'Add curated links to useful, preferably LLM-friendly resources.',
+        'add_section' => 'Add section',
+        'section_title' => 'Section title',
+        'link_title' => 'Link title',
+        'link_url' => 'Absolute URL',
+        'link_description' => 'Description (optional)',
+        'add_link' => 'Add link',
+        'custom_source_heading' => 'Custom llms.txt source',
+        'custom_source_description' => 'Antlers is parsed before validation. When enabled, the resolved document must begin with a non-empty H1.',
+        'generated_preview' => 'Resolved preview',
+        'preview_unavailable' => 'Preview unavailable',
+        'preview_title' => 'llms.txt preview',
+        'generate_confirmation' => 'Generate llms.txt?',
+        'generate_confirmation_description' => 'SEO Pro will create a missing file or update a file it already manages. An unmanaged file will never be overwritten.',
+        'custom_source_too_large' => 'The custom source must not be greater than 500 KiB.',
+        'custom_source_invalid_utf8' => 'The custom source must be valid UTF-8.',
+    ],
     'robots_txt' => [
         'unable_to_save_settings' => 'Unable to save robots.txt settings',
         'unable_to_save_settings_writable' => 'Unable to save robots.txt settings. Make sure the addon settings are writable.',
diff --git a/resources/js/pages/llms/Tab.vue b/resources/js/pages/llms/Tab.vue
new file mode 100644
index 00000000..3ad96ba5
--- /dev/null
+++ b/resources/js/pages/llms/Tab.vue
@@ -0,0 +1,356 @@
+<script setup>
+import { computed, getCurrentInstance, onMounted, onUnmounted, ref, watch } from 'vue';
+import { deepClone } from '@statamic/cms';
+import {
+	Alert,
+	Badge,
+	Button,
+	CodeEditor,
+	Description,
+	Field,
+	Heading,
+	Input,
+	Panel,
+	Select,
+	Subheading,
+	Switch,
+	Textarea,
+} from '@statamic/cms/ui';
+import SiteSelector from '../../components/SiteSelector.vue';
+
+const props = defineProps({
+	editUrl: { type: String, required: true },
+});
+
+const emit = defineEmits(['saving']);
+const instance = getCurrentInstance();
+const { $axios } = instance.appContext.config.globalProperties;
+
+const loaded = ref(false);
+const loading = ref(false);
+const saving = ref(false);
+const generating = ref(false);
+const confirmingGeneration = ref(false);
+const form = ref(null);
+const rendered = ref('');
+const action = ref('');
+const generateUrl = ref('');
+const previewUrl = ref('');
+const liveUrl = ref('');
+const file = ref({});
+const sites = ref([]);
+const site = ref('');
+const errors = ref({});
+const previewError = ref(false);
+const hydrating = ref(false);
+const dirtyStateName = 'seo-pro-llms';
+
+const modeOptions = [
+	{ value: 'managed', label: __('seo-pro::messages.llms_txt.managed') },
+	{ value: 'custom', label: __('seo-pro::messages.llms_txt.custom_source') },
+];
+
+const isBusy = computed(() => loading.value || saving.value || generating.value);
+const hasUnmanagedFile = computed(() => file.value.exists && !file.value.managed);
+
+function hydrate(data) {
+	hydrating.value = true;
+	form.value = deepClone(data.values);
+	rendered.value = data.preview;
+	action.value = data.action;
+	generateUrl.value = data.generateUrl;
+	previewUrl.value = data.previewUrl;
+	liveUrl.value = data.liveUrl;
+	file.value = data.file;
+	sites.value = data.sites;
+	site.value = data.site;
+	errors.value = {};
+	previewError.value = false;
+	loaded.value = true;
+	Statamic.$dirty.remove(dirtyStateName);
+	queueMicrotask(() => hydrating.value = false);
+}
+
+function load(selectedSite = null) {
+	if (loading.value) return;
+
+	loading.value = true;
+	$axios.get(props.editUrl, { params: selectedSite ? { site: selectedSite } : {} })
+		.then((response) => hydrate(response.data))
+		.catch(() => Statamic.$toast.error(__('seo-pro::messages.llms_txt.unable_to_load_settings')))
+		.finally(() => loading.value = false);
+}
+
+function payload() {
+	return { ...deepClone(form.value), site: site.value };
+}
+
+function clearDirtyStateIfUnchanged(submitted) {
+	const current = { ...deepClone(form.value), site: site.value };
+
+	if (JSON.stringify(current) === JSON.stringify(submitted)) {
+		Statamic.$dirty.remove(dirtyStateName);
+	}
+}
+
+function save() {
+	if (!loaded.value || isBusy.value) return;
+
+	saving.value = true;
+	emit('saving', true);
+	errors.value = {};
+	const submitted = payload();
+
+	$axios.patch(action.value, submitted)
+		.then((response) => {
+			rendered.value = response.data.preview;
+			file.value = response.data.file;
+			clearDirtyStateIfUnchanged(submitted);
+			Statamic.$toast.success(__('Addon settings saved'));
+		})
+		.catch((error) => {
+			errors.value = error.response?.data?.errors ?? {};
+			Statamic.$toast.error(__('seo-pro::messages.llms_txt.unable_to_save_settings'));
+		})
+		.finally(() => {
+			saving.value = false;
+			emit('saving', false);
+		});
+}
+
+function requestGeneration() {
+	if (!form.value?.enabled || isBusy.value || hasUnmanagedFile.value) return;
+
+	confirmingGeneration.value = true;
+}
+
+function generate() {
+	confirmingGeneration.value = false;
+	generating.value = true;
+	emit('saving', true);
+	errors.value = {};
+	const submitted = payload();
+
+	$axios.post(generateUrl.value, submitted)
+		.then((response) => {
+			rendered.value = response.data.preview;
+			file.value = response.data.file;
+			clearDirtyStateIfUnchanged(submitted);
+			Statamic.$toast.success(response.data.changed
+				? __('seo-pro::messages.llms_txt_generated')
+				: __('seo-pro::messages.llms_txt.already_up_to_date'));
+		})
+		.catch((error) => {
+			errors.value = error.response?.data?.errors ?? {};
+			Statamic.$toast.error(__('seo-pro::messages.llms_txt.unable_to_generate'));
+		})
+		.finally(() => {
+			generating.value = false;
+			emit('saving', false);
+		});
+}
+
+function switchSite(selectedSite) {
+	if (selectedSite === site.value || isBusy.value) return;
+
+	if (Statamic.$dirty.has(dirtyStateName) && !window.confirm(__('Are you sure? Unsaved changes will be lost.'))) {
+		return;
+	}
+
+	load(selectedSite);
+}
+
+function addSection() {
+	form.value.sections.push({ title: '', links: [] });
+}
+
+function removeSection(index) {
+	form.value.sections.splice(index, 1);
+}
+
+function addLink(section) {
+	section.links.push({ title: '', url: 'https://', description: '' });
+}
+
+function removeLink(section, index) {
+	section.links.splice(index, 1);
+}
+
+let previewTimer;
+watch(form, () => {
+	if (!loaded.value || hydrating.value) return;
+
+	Statamic.$dirty.add(dirtyStateName);
+	clearTimeout(previewTimer);
+	previewTimer = setTimeout(() => {
+		$axios.post(previewUrl.value, payload())
+			.then((response) => {
+				rendered.value = response.data.preview;
+				previewError.value = false;
+			})
+			.catch(() => previewError.value = true);
+	}, 250);
+}, { deep: true });
+
+onMounted(() => load());
+onUnmounted(() => clearTimeout(previewTimer));
+
+defineExpose({ save });
+</script>
+
+<template>
+	<div class="pt-6">
+		<div v-if="loading && !loaded" class="py-12 text-center text-gray-500">{{ __('Loading...') }}</div>
+
+		<template v-else-if="loaded">
+			<div class="flex flex-wrap items-center justify-between gap-3 pb-6">
+				<SiteSelector
+					v-if="sites.length > 1"
+					:sites="sites"
+					:model-value="site"
+					@update:modelValue="switchSite"
+				/>
+				<div v-else />
+
+				<div class="flex flex-wrap items-center gap-2 sm:gap-3">
+					<Button v-if="form.enabled || file.exists" :href="liveUrl" target="_blank" variant="ghost" icon="external-link" :text="__('seo-pro::messages.llms_txt.view_live_file')" />
+					<Button
+						variant="default"
+						:text="__('Generate')"
+						:disabled="isBusy || !form.enabled || hasUnmanagedFile"
+						:loading="generating"
+						@click="requestGeneration"
+					/>
+				</div>
+			</div>
+
+			<div class="space-y-6">
+				<Alert
+					v-if="hasUnmanagedFile"
+					variant="warning"
+					:heading="__('seo-pro::messages.llms_txt.existing_file_unmanaged')"
+					:text="__('seo-pro::messages.llms_txt.existing_file_unmanaged_description')"
+				/>
+				<Alert
+					v-else-if="!form.enabled"
+					variant="default"
+					:heading="__('seo-pro::messages.llms_txt.disabled')"
+					:text="__('seo-pro::messages.llms_txt.disabled_description')"
+				/>
+				<Alert
+					v-else-if="file.managed && file.outdated"
+					variant="warning"
+					:heading="__('seo-pro::messages.llms_txt.needs_generation')"
+					:text="__('seo-pro::messages.llms_txt.needs_generation_description')"
+				/>
+				<Alert
+					v-else-if="file.managed"
+					variant="success"
+					:heading="__('seo-pro::messages.llms_txt.managed_by_seo_pro')"
+				/>
+				<Alert
+					v-else
+					variant="success"
+					:heading="__('seo-pro::messages.llms_txt.cached_route_active')"
+					:text="__('seo-pro::messages.llms_txt.cached_route_active_description')"
+				/>
+
+				<Alert v-if="Object.keys(errors).length" variant="error" :heading="__('seo-pro::messages.llms_txt.unable_to_save_settings')">
+					<ul class="list-disc ps-5">
+						<li v-for="(messages, field) in errors" :key="field" v-text="messages[0]" />
+					</ul>
+				</Alert>
+
+				<Panel class="p-6 space-y-6">
+					<div class="flex items-start justify-between gap-6">
+						<div>
+							<Heading :text="__('seo-pro::messages.llms_txt.enable')" />
+							<Description :text="__('seo-pro::messages.llms_txt.enable_description')" />
+						</div>
+						<Switch v-model="form.enabled" />
+					</div>
+
+					<Field :label="__('seo-pro::messages.llms_txt.editing_mode')" :instructions="__('seo-pro::messages.llms_txt.editing_mode_instructions')">
+						<Select class="max-w-sm" :options="modeOptions" v-model="form.mode" />
+					</Field>
+				</Panel>
+
+				<template v-if="form.mode === 'managed'">
+					<Panel class="p-6 space-y-6">
+						<Field :label="__('seo-pro::messages.llms_txt.title')" :instructions="__('seo-pro::messages.llms_txt.title_instructions')" :required="form.enabled">
+							<Input v-model="form.title" class="font-mono" />
+						</Field>
+						<Field :label="__('seo-pro::messages.llms_txt.summary')" :instructions="__('seo-pro::messages.llms_txt.summary_instructions')">
+							<Textarea v-model="form.summary" rows="3" />
+						</Field>
+						<Field :label="__('seo-pro::messages.llms_txt.details')" :instructions="__('seo-pro::messages.llms_txt.details_instructions')">
+							<Textarea v-model="form.details" rows="5" class="font-mono" />
+						</Field>
+					</Panel>
+
+					<section>
+						<div class="flex items-center justify-between gap-4 mb-3">
+							<div>
+								<Subheading size="lg" :text="__('seo-pro::messages.llms_txt.sections')" />
+								<Description :text="__('seo-pro::messages.llms_txt.sections_description')" />
+							</div>
+							<Button size="sm" variant="ghost" icon="plus" :text="__('seo-pro::messages.llms_txt.add_section')" @click="addSection" />
+						</div>
+
+						<div class="space-y-4">
+							<Panel v-for="(section, sectionIndex) in form.sections" :key="sectionIndex" class="p-6 space-y-5">
+								<div class="flex gap-2">
+									<Field class="flex-1" :label="__('seo-pro::messages.llms_txt.section_title')">
+										<Input v-model="section.title" />
+									</Field>
+									<Button class="self-end" icon="trash" variant="ghost" :aria-label="__('Remove')" @click="removeSection(sectionIndex)" />
+								</div>
+
+								<div class="space-y-3">
+									<div v-for="(link, linkIndex) in section.links" :key="linkIndex" class="rounded-lg border p-4 space-y-3 dark:border-gray-700">
+										<div class="grid gap-3 md:grid-cols-2">
+											<Field :label="__('seo-pro::messages.llms_txt.link_title')"><Input v-model="link.title" /></Field>
+											<Field :label="__('seo-pro::messages.llms_txt.link_url')"><Input v-model="link.url" class="font-mono" /></Field>
+										</div>
+										<div class="flex gap-2">
+											<Field class="flex-1" :label="__('seo-pro::messages.llms_txt.link_description')"><Textarea v-model="link.description" rows="2" /></Field>
+											<Button class="self-end" icon="trash" variant="ghost" :aria-label="__('Remove')" @click="removeLink(section, linkIndex)" />
+										</div>
+									</div>
+									<Button size="sm" variant="ghost" icon="plus" :text="__('seo-pro::messages.llms_txt.add_link')" @click="addLink(section)" />
+								</div>
+							</Panel>
+						</div>
+					</section>
+				</template>
+
+				<Panel v-else class="p-6">
+					<Heading size="lg" :text="__('seo-pro::messages.llms_txt.custom_source_heading')" />
+					<Description class="mt-1 mb-5" :text="__('seo-pro::messages.llms_txt.custom_source_description')" />
+					<CodeEditor v-model="form.custom_source" mode="markdown" :allow-mode-selection="false" :show-mode-label="false" title="llms.txt" />
+				</Panel>
+
+				<Panel class="p-6">
+					<div class="flex items-center justify-between mb-4">
+						<div>
+							<Heading size="lg" :text="__('seo-pro::messages.llms_txt.generated_preview')" />
+							<Description :text="liveUrl" />
+						</div>
+						<Badge v-if="previewError" color="red" :text="__('seo-pro::messages.llms_txt.preview_unavailable')" />
+					</div>
+					<CodeEditor :model-value="rendered" mode="markdown" :allow-mode-selection="false" :show-mode-label="false" read-only :title="__('seo-pro::messages.llms_txt.preview_title')" />
+				</Panel>
+			</div>
+
+			<confirmation-modal
+				:open="confirmingGeneration"
+				:title="__('seo-pro::messages.llms_txt.generate_confirmation')"
+				:body-text="__('seo-pro::messages.llms_txt.generate_confirmation_description')"
+				:button-text="__('Generate')"
+				@update:open="confirmingGeneration = $event"
+				@confirm="generate"
+				@cancel="confirmingGeneration = false"
+			/>
+		</template>
+	</div>
+</template>
diff --git a/resources/js/pages/robots/Edit.vue b/resources/js/pages/robots/Edit.vue
index 2fd93a61..6d14663a 100644
--- a/resources/js/pages/robots/Edit.vue
+++ b/resources/js/pages/robots/Edit.vue
@@ -2,6 +2,7 @@
 import { computed, getCurrentInstance, onMounted, onUnmounted, ref, watch } from 'vue';
 import { deepClone } from '@statamic/cms';
 import { Head } from '@statamic/cms/inertia';
+import LlmsTab from '../llms/Tab.vue';
 import {
 	Alert,
 	Badge,
@@ -31,6 +32,7 @@ const props = defineProps({
 	liveUrl: { type: String, required: true },
 	sitemapUrlsAreEnvironmentDependent: { type: Boolean, required: true },
 	file: { type: Object, required: true },
+	llmsEditUrl: { type: String, required: true },
 });
 
 const instance = getCurrentInstance();
@@ -51,6 +53,18 @@ const errorHeading = ref(__('seo-pro::messages.robots_txt.unable_to_save_setting
 const previewError = ref(false);
 const dirtyStateName = 'seo-pro-robots';
 const activeTab = ref('robots.txt');
+const llmsTab = ref(null);
+const llmsSaving = ref(false);
+
+function saveActive() {
+	if (activeTab.value === 'llms.txt') {
+		llmsTab.value?.save();
+
+		return;
+	}
+
+	save();
+}
 
 const importDescription = computed(() => {
 	if (file.value.importable) {
@@ -253,7 +267,7 @@ let saveKeyBinding;
 onMounted(() => {
 	saveKeyBinding = Statamic.$keys.bindGlobal(['mod+s'], (event) => {
 		event.preventDefault();
-		save();
+		saveActive();
 	});
 });
 
@@ -268,7 +282,7 @@ onUnmounted(() => {
 
 	<div class="max-w-5xl mx-auto">
 		<Header :title="__('seo-pro::messages.robots')" icon="earth">
-			<Button variant="primary" :text="__('Save')" :disabled="saving || generating" :loading="saving" @click="save" />
+			<Button variant="primary" :text="__('Save')" :disabled="saving || generating || llmsSaving" :loading="saving || llmsSaving" @click="saveActive" />
 		</Header>
 
 		<Tabs v-model="activeTab" :unmount-on-hide="false">
@@ -469,7 +483,7 @@ onUnmounted(() => {
 			</TabContent>
 
 			<TabContent name="llms.txt">
-				<div class="pt-6" />
+				<LlmsTab ref="llmsTab" :edit-url="llmsEditUrl" @saving="llmsSaving = $event" />
 			</TabContent>
 		</Tabs>
 	</div>
diff --git a/routes/cp.php b/routes/cp.php
index f4850b2a..1bbffef6 100644
--- a/routes/cp.php
+++ b/routes/cp.php
@@ -22,6 +22,11 @@
     Route::post('robots/generate', [Controllers\CP\RobotsController::class, 'generate'])->name('robots.generate');
     Route::post('robots/preview', [Controllers\CP\RobotsController::class, 'preview'])->name('robots.preview');
 
+    Route::get('llms/edit', [Controllers\CP\LlmsController::class, 'edit'])->name('llms.edit');
+    Route::patch('llms', [Controllers\CP\LlmsController::class, 'update'])->name('llms.update');
+    Route::post('llms/generate', [Controllers\CP\LlmsController::class, 'generate'])->name('llms.generate');
+    Route::post('llms/preview', [Controllers\CP\LlmsController::class, 'preview'])->name('llms.preview');
+
     Route::get('section-defaults', [Controllers\CP\SectionDefaultsController::class, 'index'])->name('section-defaults.index');
     Route::get('section-defaults/collections/{seo_pro_collection}/edit', [Controllers\CP\CollectionDefaultsController::class, 'edit'])->name('section-defaults.collections.edit');
     Route::patch('section-defaults/collections/{seo_pro_collection}', [Controllers\CP\CollectionDefaultsController::class, 'update'])->name('section-defaults.collections.update');
diff --git a/routes/web.php b/routes/web.php
index 33ca134a..2b13ba3c 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -6,3 +6,10 @@
 Route::get(config('statamic.seo-pro.sitemap.url'), [Controllers\SitemapController::class, 'index']);
 Route::get(config('statamic.seo-pro.sitemap.pagination.url', 'sitemap_{page}.xml'), [Controllers\SitemapController::class, 'show'])->name('statamic.seo-pro.sitemap.page.show');
 Route::get(config('statamic.seo-pro.humans.url'), [Controllers\HumansController::class, 'show']);
+Route::get('llms.txt', [Controllers\LlmsController::class, 'show'])
+    ->middleware('statamic.web')
+    ->name('statamic.seo-pro.llms.show');
+
+Route::get('{sitePath}/llms.txt', [Controllers\LlmsController::class, 'show'])
+    ->where('sitePath', '.+')
+    ->middleware('statamic.web');
diff --git a/src/Cascade.php b/src/Cascade.php
index 18998c3e..3526d898 100644
--- a/src/Cascade.php
+++ b/src/Cascade.php
@@ -15,6 +15,7 @@
 use Statamic\Fields\Field;
 use Statamic\Fields\Value;
 use Statamic\Fieldtypes\Bard;
+use Statamic\SeoPro\Llms\Llms;
 use Statamic\Statamic;
 use Statamic\Support\Arr;
 use Statamic\Support\Str;
@@ -134,6 +135,7 @@ public function get()
             'next_url' => $this->nextUrl(),
             'home_url' => $this->homeUrl(),
             'humans_txt' => $this->humans(),
+            'llms_txt' => $this->llms(),
             'site' => $this->site(),
             'is_default_site' => $this->site()->isDefault(),
             'alternate_locales' => $alternateLocales = $this->alternateLocales(),
@@ -559,6 +561,15 @@ protected function humans()
         }
     }
 
+    protected function llms()
+    {
+        $site = $this->site();
+
+        if (Llms::get($site)->enabled()) {
+            return Llms::url($site);
+        }
+    }
+
     protected function robots()
     {
         $entryHasLegacyRobots = $this->data->has('robots')
diff --git a/src/Events/LlmsTxtGenerated.php b/src/Events/LlmsTxtGenerated.php
new file mode 100644
index 00000000..348dad7d
--- /dev/null
+++ b/src/Events/LlmsTxtGenerated.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace Statamic\SeoPro\Events;
+
+use Illuminate\Support\Carbon;
+use Statamic\Contracts\Git\ProvidesCommitMessage;
+use Statamic\Events\Event;
+use Statamic\SeoPro\Llms\LlmsDocument;
+use Statamic\Sites\Site;
+
+class LlmsTxtGenerated extends Event implements ProvidesCommitMessage
+{
+    public function __construct(
+        public LlmsDocument $document,
+        public Site $site,
+        public string $path,
+        public Carbon $generatedAt,
+    ) {}
+
+    public function commitMessage(): string
+    {
+        return __('seo-pro::messages.llms_txt_generated', [], config('statamic.git.locale'));
+    }
+}
diff --git a/src/Http/Controllers/CP/LlmsController.php b/src/Http/Controllers/CP/LlmsController.php
new file mode 100644
index 00000000..0ca78554
--- /dev/null
+++ b/src/Http/Controllers/CP/LlmsController.php
@@ -0,0 +1,179 @@
+<?php
+
+namespace Statamic\SeoPro\Http\Controllers\CP;
+
+use Illuminate\Http\Request;
+use Illuminate\Validation\Rule;
+use Illuminate\Validation\ValidationException;
+use Statamic\Facades\Site;
+use Statamic\Http\Controllers\CP\CpController;
+use Statamic\SeoPro\Llms\Llms;
+use Statamic\SeoPro\Llms\LlmsDocument;
+use Statamic\SeoPro\Llms\LlmsRenderer;
+use Statamic\SeoPro\Llms\LlmsTxtGenerator;
+use Statamic\StaticCaching\Cacher;
+use Throwable;
+
+class LlmsController extends CpController
+{
+    public function __construct(
+        private LlmsRenderer $renderer,
+        private LlmsTxtGenerator $generator,
+        private Cacher $staticCache,
+    ) {}
+
+    public function edit(Request $request)
+    {
+        $this->authorize('edit seo robots');
+        $site = $this->site($request);
+        $document = Llms::get($site);
+
+        return [
+            'values' => $document->all(),
+            'preview' => $this->previewContents($document, $site),
+            'action' => cp_route('seo-pro.llms.update'),
+            'generateUrl' => cp_route('seo-pro.llms.generate'),
+            'previewUrl' => cp_route('seo-pro.llms.preview'),
+            'liveUrl' => Llms::url($site),
+            'site' => $site->handle(),
+            'sites' => Site::all()->map(fn ($site) => [
+                'handle' => $site->handle(),
+                'name' => $site->name(),
+            ])->values()->all(),
+            'file' => $this->generator->status($site),
+        ];
+    }
+
+    public function update(Request $request)
+    {
+        $this->authorize('edit seo robots');
+        $site = $this->site($request);
+        $document = new LlmsDocument($this->validated($request, $site));
+
+        try {
+            $result = $this->generator->sync($document, $site);
+            $this->staticCache->invalidateUrls([Llms::url($site)]);
+        } catch (Throwable $exception) {
+            report($exception);
+
+            throw ValidationException::withMessages([
+                'settings' => __('seo-pro::messages.llms_txt.unable_to_save_settings_writable'),
+            ]);
+        }
+
+        return [
+            'saved' => true,
+            'preview' => $document->enabled() ? $this->renderer->render($document, $site) : '',
+            'file' => $this->generator->status($site),
+            'fileChanged' => $result['changed'],
+            'fileRemoved' => $result['removed'],
+        ];
+    }
+
+    public function generate(Request $request)
+    {
+        $this->authorize('edit seo robots');
+        $site = $this->site($request);
+        $document = new LlmsDocument($this->validated($request, $site));
+
+        try {
+            $generated = $this->generator->generate($document, $site);
+            $this->staticCache->invalidateUrls([Llms::url($site)]);
+        } catch (Throwable $exception) {
+            report($exception);
+
+            throw ValidationException::withMessages([
+                'file' => $exception->getMessage(),
+            ]);
+        }
+
+        return [
+            'generated' => true,
+            'changed' => $generated['changed'],
+            'preview' => $generated['contents'],
+            'file' => $this->generator->status($site),
+        ];
+    }
+
+    public function preview(Request $request)
+    {
+        $this->authorize('edit seo robots');
+        $site = $this->site($request);
+        $document = new LlmsDocument($this->validated($request, $site, false));
+
+        try {
+            return ['preview' => $this->renderer->render($document, $site)];
+        } catch (Throwable $exception) {
+            throw ValidationException::withMessages(['document' => $exception->getMessage()]);
+        }
+    }
+
+    private function validated(Request $request, $site, bool $validateRenderedDocument = true): array
+    {
+        $enabled = $request->boolean('enabled');
+        $managed = $request->input('mode') === 'managed';
+        $custom = $request->input('mode') === 'custom';
+
+        $values = $request->validate([
+            'enabled' => ['required', 'boolean'],
+            'mode' => ['required', Rule::in(['managed', 'custom'])],
+            'title' => [Rule::requiredIf($enabled && $managed), 'nullable', 'string', 'max:5000'],
+            'summary' => ['nullable', 'string', 'max:20000'],
+            'details' => ['nullable', 'string', 'max:100000'],
+            'sections' => ['present', 'array', 'max:50'],
+            'sections.*.title' => ['nullable', 'string', 'max:5000'],
+            'sections.*.links' => ['present', 'array', 'max:100'],
+            'sections.*.links.*.title' => ['nullable', 'string', 'max:5000'],
+            'sections.*.links.*.url' => ['nullable', 'string', 'max:5000'],
+            'sections.*.links.*.description' => ['nullable', 'string', 'max:20000'],
+            'custom_source' => [
+                Rule::requiredIf($enabled && $custom),
+                'nullable',
+                'string',
+                function (string $attribute, mixed $value, \Closure $fail) {
+                    if (strlen((string) $value) > LlmsTxtGenerator::MAX_BYTES) {
+                        $fail(__('seo-pro::messages.llms_txt.custom_source_too_large'));
+                    }
+
+                    if (! mb_check_encoding((string) $value, 'UTF-8')) {
+                        $fail(__('seo-pro::messages.llms_txt.custom_source_invalid_utf8'));
+                    }
+                },
+            ],
+        ]);
+
+        $values['title'] ??= '';
+        $values['summary'] ??= '';
+        $values['details'] ??= '';
+        $values['custom_source'] ??= '';
+
+        if ($validateRenderedDocument && $enabled) {
+            try {
+                $this->renderer->render(new LlmsDocument($values), $site);
+            } catch (Throwable $exception) {
+                throw ValidationException::withMessages(['document' => $exception->getMessage()]);
+            }
+        }
+
+        return $values;
+    }
+
+    private function site(Request $request)
+    {
+        $handle = $request->input('site', Site::selected()->handle());
+        $site = Site::get($handle);
+
+        abort_unless($site, 404);
+
+        return $site;
+    }
+
+    private function previewContents(LlmsDocument $document, $site): string
+    {
+        try {
+            return $this->renderer->render($document, $site);
+        } catch (Throwable) {
+            return '';
+        }
+    }
+}
diff --git a/src/Http/Controllers/CP/RobotsController.php b/src/Http/Controllers/CP/RobotsController.php
index 8372f9ed..b822af8c 100644
--- a/src/Http/Controllers/CP/RobotsController.php
+++ b/src/Http/Controllers/CP/RobotsController.php
@@ -36,6 +36,7 @@ public function edit(Request $request)
             'liveUrl' => Robots::authority(Site::selected()).'/robots.txt',
             'sitemapUrlsAreEnvironmentDependent' => Robots::sitemapUrlsAreEnvironmentDependent(),
             'file' => $this->generator->status(),
+            'llmsEditUrl' => cp_route('seo-pro.llms.edit'),
         ];
 
         if ($request->wantsJson()) {
diff --git a/src/Http/Controllers/LlmsController.php b/src/Http/Controllers/LlmsController.php
new file mode 100644
index 00000000..25eaf2c6
--- /dev/null
+++ b/src/Http/Controllers/LlmsController.php
@@ -0,0 +1,46 @@
+<?php
+
+namespace Statamic\SeoPro\Http\Controllers;
+
+use Illuminate\Http\Request;
+use Illuminate\Routing\Controller;
+use Statamic\Facades\Site;
+use Statamic\SeoPro\Llms\Llms;
+use Statamic\SeoPro\Llms\LlmsRenderCache;
+use Statamic\StaticCaching\Cacher;
+use Statamic\StaticCaching\Cachers\FileCacher;
+
+class LlmsController extends Controller
+{
+    public function __construct(private LlmsRenderCache $cache) {}
+
+    public function show(Request $request)
+    {
+        $site = Site::findByUrl($request->url());
+
+        abort_unless($site && Llms::url($site) === rtrim($request->url(), '/'), 404);
+
+        $document = Llms::get($site);
+
+        abort_unless($document->enabled(), 404);
+
+        $contents = $this->cache->get($document, $site);
+        $response = response($contents)
+            ->header('Content-Type', 'text/plain; charset=UTF-8')
+            ->header('ETag', '"'.hash('sha256', $contents).'"')
+            ->setPublic();
+
+        if ($request->headers->get('If-None-Match') === $response->headers->get('ETag')) {
+            $response->setNotModified();
+        }
+
+        // Statamic's full-measure cacher stores all routes as .html and its standard
+        // rewrite rules serve them as text/html. Our render cache still prevents the
+        // document from being rebuilt on each request while preserving the correct type.
+        if (app(Cacher::class) instanceof FileCacher) {
+            $response->headers->set('X-Statamic-Uncacheable', 'true');
+        }
+
+        return $response;
+    }
+}
diff --git a/src/Llms/Llms.php b/src/Llms/Llms.php
new file mode 100644
index 00000000..0d630b76
--- /dev/null
+++ b/src/Llms/Llms.php
@@ -0,0 +1,216 @@
+<?php
+
+namespace Statamic\SeoPro\Llms;
+
+use Illuminate\Support\Arr;
+use RuntimeException;
+use Statamic\Contracts\Addons\SettingsRepository;
+use Statamic\Facades\Addon;
+use Statamic\Facades\Blink;
+use Statamic\Facades\Site;
+use Statamic\Facades\URL;
+use Statamic\Sites\Site as SiteObject;
+
+class Llms
+{
+    public static function get(string|SiteObject|null $site = null): LlmsDocument
+    {
+        $site = self::site($site);
+
+        return Blink::once("seo-pro::llms.{$site->handle()}", function () use ($site) {
+            $data = Arr::get(
+                Addon::get('statamic/seo-pro')->settings()->raw(),
+                "llms.sites.{$site->handle()}.policy",
+                [],
+            );
+
+            return new LlmsDocument(is_array($data) ? $data : []);
+        });
+    }
+
+    public static function generated(string|SiteObject|null $site = null): ?array
+    {
+        $site = self::site($site);
+        $generated = Arr::get(
+            Addon::get('statamic/seo-pro')->settings()->raw(),
+            "llms.sites.{$site->handle()}.generated",
+        );
+
+        return is_array($generated) ? $generated : null;
+    }
+
+    public static function save(LlmsDocument $document, string|SiteObject|null $site = null): bool
+    {
+        $site = self::site($site);
+        $data = ['policy' => $document->all()];
+
+        if ($generated = self::generated($site)) {
+            $data['generated'] = $generated;
+        }
+
+        return self::saveSiteSettings($site, $data);
+    }
+
+    public static function saveGenerated(
+        LlmsDocument $document,
+        SiteObject $site,
+        string $contents,
+        string $path,
+        \DateTimeInterface $generatedAt,
+    ): bool {
+        return self::saveSiteSettings($site, [
+            'policy' => $document->all(),
+            'generated' => [
+                'timestamp' => $generatedAt->format(DATE_ATOM),
+                'checksum' => hash('sha256', $contents),
+                'path' => $path,
+            ],
+        ]);
+    }
+
+    public static function saveWithoutGenerated(LlmsDocument $document, SiteObject $site): bool
+    {
+        return self::saveSiteSettings($site, ['policy' => $document->all()]);
+    }
+
+    public static function withDefaults(array $data): array
+    {
+        $defaults = self::defaults();
+        $values = array_replace($defaults, Arr::only($data, array_keys($defaults)));
+
+        $values['enabled'] = filter_var($values['enabled'], FILTER_VALIDATE_BOOL);
+        $values['mode'] = in_array($values['mode'], ['managed', 'custom'], true)
+            ? $values['mode']
+            : $defaults['mode'];
+        $values['title'] = (string) ($values['title'] ?? '');
+        $values['summary'] = (string) ($values['summary'] ?? '');
+        $values['details'] = (string) ($values['details'] ?? '');
+        $values['custom_source'] = (string) ($values['custom_source'] ?? '');
+        $values['sections'] = collect(is_array($values['sections']) ? $values['sections'] : [])
+            ->filter(fn ($section) => is_array($section))
+            ->map(function (array $section) {
+                return [
+                    'title' => (string) ($section['title'] ?? ''),
+                    'links' => collect(is_array($section['links'] ?? null) ? $section['links'] : [])
+                        ->filter(fn ($link) => is_array($link))
+                        ->map(fn (array $link) => [
+                            'title' => (string) ($link['title'] ?? ''),
+                            'url' => (string) ($link['url'] ?? ''),
+                            'description' => (string) ($link['description'] ?? ''),
+                        ])
+                        ->values()
+                        ->all(),
+                ];
+            })
+            ->values()
+            ->all();
+
+        return $values;
+    }
+
+    public static function defaults(): array
+    {
+        return [
+            'enabled' => false,
+            'mode' => 'managed',
+            'title' => '{{ config:app:name }}',
+            'summary' => '',
+            'details' => '',
+            'sections' => [],
+            'custom_source' => '',
+        ];
+    }
+
+    public static function enabledSites()
+    {
+        return Site::all()->filter(fn (SiteObject $site) => self::get($site)->enabled());
+    }
+
+    public static function url(string|SiteObject|null $site = null): string
+    {
+        $site = self::site($site);
+
+        return URL::tidy($site->absoluteUrl().'/llms.txt', external: true, withTrailingSlash: false);
+    }
+
+    public static function relativePath(string|SiteObject|null $site = null): string
+    {
+        $path = parse_url(self::site($site)->absoluteUrl(), PHP_URL_PATH) ?: '/';
+
+        return trim($path, '/') === '' ? 'llms.txt' : trim($path, '/').'/llms.txt';
+    }
+
+    public static function settingsSnapshot(): array
+    {
+        $addon = Addon::get('statamic/seo-pro');
+        $settings = app(SettingsRepository::class)->find($addon->id());
+
+        return [
+            'exists' => $settings !== null,
+            'raw' => $settings?->raw() ?? [],
+        ];
+    }
+
+    public static function restoreSettings(array $snapshot): void
+    {
+        $addon = Addon::get('statamic/seo-pro');
+        $repository = app(SettingsRepository::class);
+
+        try {
+            if ($snapshot['exists']) {
+                $repository->save($repository->make($addon, $snapshot['raw']));
+            } elseif ($settings = $repository->find($addon->id())) {
+                $repository->delete($settings);
+            }
+        } finally {
+            self::forget();
+        }
+
+        if (self::settingsSnapshot() !== $snapshot) {
+            throw new RuntimeException('Unable to restore the previous SEO Pro settings.');
+        }
+    }
+
+    public static function forget(string|SiteObject|null $site = null): void
+    {
+        if ($site) {
+            $site = self::site($site);
+            Blink::forget("seo-pro::llms.{$site->handle()}");
+
+            return;
+        }
+
+        Site::all()->each(fn (SiteObject $site) => Blink::forget("seo-pro::llms.{$site->handle()}"));
+    }
+
+    public static function site(string|SiteObject|null $site = null): SiteObject
+    {
+        if ($site instanceof SiteObject) {
+            return $site;
+        }
+
+        if (is_string($site)) {
+            return Site::get($site) ?? throw new \InvalidArgumentException("Unknown Statamic site [{$site}].");
+        }
+
+        return Site::current() ?? Site::default();
+    }
+
+    private static function saveSiteSettings(SiteObject $site, array $siteData): bool
+    {
+        $settings = Addon::get('statamic/seo-pro')->settings();
+        $llms = Arr::get($settings->raw(), 'llms', []);
+        $llms = is_array($llms) ? $llms : [];
+        $sites = is_array($llms['sites'] ?? null) ? $llms['sites'] : [];
+        $sites[$site->handle()] = $siteData;
+        $llms['sites'] = $sites;
+
+        $saved = $settings->set('llms', $llms)->save();
+
+        if ($saved) {
+            self::forget($site);
+        }
+
+        return $saved;
+    }
+}
diff --git a/src/Llms/LlmsDocument.php b/src/Llms/LlmsDocument.php
new file mode 100644
index 00000000..d6b19ee5
--- /dev/null
+++ b/src/Llms/LlmsDocument.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace Statamic\SeoPro\Llms;
+
+class LlmsDocument
+{
+    public function __construct(private array $data) {}
+
+    public function all(): array
+    {
+        return Llms::withDefaults($this->data);
+    }
+
+    public function enabled(): bool
+    {
+        return $this->all()['enabled'];
+    }
+}
diff --git a/src/Llms/LlmsRenderCache.php b/src/Llms/LlmsRenderCache.php
new file mode 100644
index 00000000..6c9fb6b5
--- /dev/null
+++ b/src/Llms/LlmsRenderCache.php
@@ -0,0 +1,49 @@
+<?php
+
+namespace Statamic\SeoPro\Llms;
+
+use Illuminate\Contracts\Cache\Repository;
+use Statamic\Sites\Site as SiteObject;
+
+class LlmsRenderCache
+{
+    public function __construct(
+        private Repository $cache,
+        private LlmsRenderer $renderer,
+    ) {}
+
+    public function get(LlmsDocument $document, string|SiteObject|null $site = null): string
+    {
+        $site = Llms::site($site);
+        $fingerprint = hash('sha256', (string) json_encode([
+            'document' => $document->all(),
+            'context' => $this->renderer->contextFingerprint($site),
+        ], JSON_PARTIAL_OUTPUT_ON_ERROR | JSON_PRESERVE_ZERO_FRACTION));
+        $cached = $this->cache->get($this->key($site));
+
+        if (is_array($cached)
+            && ($cached['fingerprint'] ?? null) === $fingerprint
+            && is_string($cached['contents'] ?? null)) {
+            return $cached['contents'];
+        }
+
+        $contents = $this->renderer->render($document, $site);
+
+        $this->cache->forever($this->key($site), [
+            'fingerprint' => $fingerprint,
+            'contents' => $contents,
+        ]);
+
+        return $contents;
+    }
+
+    public function forget(string|SiteObject|null $site = null): void
+    {
+        $this->cache->forget($this->key(Llms::site($site)));
+    }
+
+    private function key(SiteObject $site): string
+    {
+        return "seo-pro::llms.rendered.{$site->handle()}";
+    }
+}
diff --git a/src/Llms/LlmsRenderer.php b/src/Llms/LlmsRenderer.php
new file mode 100644
index 00000000..433daab3
--- /dev/null
+++ b/src/Llms/LlmsRenderer.php
@@ -0,0 +1,202 @@
+<?php
+
+namespace Statamic\SeoPro\Llms;
+
+use InvalidArgumentException;
+use Statamic\Facades\Antlers;
+use Statamic\Sites\Site as SiteObject;
+use Statamic\View\Cascade;
+
+class LlmsRenderer
+{
+    public const VERSION = 1;
+
+    public const MAX_BYTES = 512000;
+
+    public function render(LlmsDocument|array $document, string|SiteObject|null $site = null): string
+    {
+        $values = $document instanceof LlmsDocument
+            ? $document->all()
+            : Llms::withDefaults($document);
+        $site = Llms::site($site);
+        $context = $this->context($site);
+
+        if ($values['mode'] === 'custom') {
+            $contents = $this->finalize($this->parse($values['custom_source'], $context));
+            $this->validateCustomSource($contents);
+
+            return $contents;
+        }
+
+        $title = trim($this->parse($values['title'], $context));
+        $this->validateSingleLine($title, 'The llms.txt title');
+
+        if ($title === '') {
+            throw new InvalidArgumentException('The llms.txt title is required.');
+        }
+
+        $lines = ['# '.$title];
+
+        if ($summary = trim($this->parse($values['summary'], $context))) {
+            $lines[] = '';
+            $lines = [...$lines, ...collect(explode("\n", $this->normalizeLines($summary)))
+                ->map(fn (string $line) => '> '.$line)
+                ->all()];
+        }
+
+        if ($details = trim($this->parse($values['details'], $context))) {
+            $this->validateDetails($details);
+            $lines[] = '';
+            $lines[] = $this->normalizeLines($details);
+        }
+
+        foreach ($values['sections'] as $section) {
+            $sectionTitle = trim($this->parse($section['title'], $context));
+            $links = collect($section['links'])
+                ->map(function (array $link) use ($context) {
+                    return [
+                        'title' => trim($this->parse($link['title'], $context)),
+                        'url' => trim($this->parse($link['url'], $context)),
+                        'description' => trim($this->parse($link['description'], $context)),
+                    ];
+                })
+                ->filter(fn (array $link) => $link['title'] !== '' || $link['url'] !== '')
+                ->values();
+
+            if ($sectionTitle === '' && $links->isEmpty()) {
+                continue;
+            }
+
+            $this->validateSingleLine($sectionTitle, 'An llms.txt section title');
+
+            if ($sectionTitle === '') {
+                throw new InvalidArgumentException('Every non-empty llms.txt section requires a title.');
+            }
+
+            $lines[] = '';
+            $lines[] = '## '.$sectionTitle;
+            $lines[] = '';
+
+            foreach ($links as $link) {
+                $this->validateLink($link);
+                $description = preg_replace('/\s+/u', ' ', $this->normalizeLines($link['description']));
+                $lines[] = '- ['.$this->escapeLinkTitle($link['title']).']('.$link['url'].')'
+                    .($description !== '' ? ': '.$description : '');
+            }
+        }
+
+        return $this->finalize(implode("\n", $lines));
+    }
+
+    public function contextFingerprint(string|SiteObject|null $site = null): string
+    {
+        $site = Llms::site($site);
+
+        return hash('sha256', (string) json_encode([
+            'renderer' => self::VERSION,
+            'context' => $this->context($site),
+        ], JSON_PARTIAL_OUTPUT_ON_ERROR | JSON_PRESERVE_ZERO_FRACTION));
+    }
+
+    private function parse(string $value, array $context): string
+    {
+        return (string) Antlers::parse($value, $context);
+    }
+
+    private function context(SiteObject $site): array
+    {
+        return [
+            'config' => Cascade::config(),
+            'site' => $this->siteVariables($site),
+        ];
+    }
+
+    private function siteVariables(SiteObject $site): array
+    {
+        return [
+            'handle' => $site->handle(),
+            'name' => $site->name(),
+            'locale' => $site->locale(),
+            'short_locale' => $site->shortLocale(),
+            'lang' => $site->lang(),
+            'url' => $site->url(),
+            'permalink' => $site->absoluteUrl(),
+            'direction' => (string) $site->direction(),
+            'attributes' => $site->attributes(),
+        ];
+    }
+
+    private function validateCustomSource(string $contents): void
+    {
+        $contents = preg_replace('/^\xEF\xBB\xBF/', '', $contents);
+        $firstLine = collect(explode("\n", $contents))->first(fn (string $line) => trim($line) !== '');
+
+        if (! is_string($firstLine) || ! preg_match('/^#\s+\S/u', $firstLine)) {
+            throw new InvalidArgumentException('Enabled custom llms.txt source must begin with a non-empty H1 heading.');
+        }
+    }
+
+    private function validateDetails(string $details): void
+    {
+        $lines = explode("\n", $this->normalizeLines($details));
+
+        foreach ($lines as $index => $line) {
+            if (preg_match('/^\s{0,3}#{1,6}\s+/u', $line)
+                || ($index > 0 && trim($lines[$index - 1]) !== '' && preg_match('/^\s*(?:=+|-+)\s*$/u', $line))) {
+                throw new InvalidArgumentException('Additional llms.txt context cannot contain Markdown headings. Use a file-list section instead.');
+            }
+        }
+    }
+
+    private function validateLink(array $link): void
+    {
+        $this->validateSingleLine($link['title'], 'An llms.txt link title');
+        $this->validateSingleLine($link['url'], 'An llms.txt link URL');
+
+        if ($link['title'] === '' || $link['url'] === '') {
+            throw new InvalidArgumentException('Every llms.txt link requires a title and URL.');
+        }
+
+        if (! filter_var($link['url'], FILTER_VALIDATE_URL)
+            || ! in_array(strtolower((string) parse_url($link['url'], PHP_URL_SCHEME)), ['http', 'https'], true)) {
+            throw new InvalidArgumentException("The llms.txt link URL [{$link['url']}] must be an absolute HTTP or HTTPS URL.");
+        }
+    }
+
+    private function validateSingleLine(string $value, string $label): void
+    {
+        if (str_contains($value, "\n") || str_contains($value, "\r")) {
+            throw new InvalidArgumentException("{$label} must be a single line.");
+        }
+    }
+
+    private function escapeLinkTitle(string $title): string
+    {
+        return str_replace(['\\', '[', ']'], ['\\\\', '\\[', '\\]'], $title);
+    }
+
+    private function normalizeLines(string $contents): string
+    {
+        return str_replace(["\r\n", "\r"], "\n", $contents);
+    }
+
+    private function normalize(string $contents): string
+    {
+        return rtrim($this->normalizeLines($contents))."\n";
+    }
+
+    private function finalize(string $contents): string
+    {
+        $contents = $this->normalize($contents);
+
+        if (! mb_check_encoding($contents, 'UTF-8')) {
+            throw new InvalidArgumentException('The resolved llms.txt document must be valid UTF-8.');
+        }
+
+        if (strlen($contents) > self::MAX_BYTES) {
+            throw new InvalidArgumentException('The resolved llms.txt document must not be greater than 500 KiB.');
+        }
+
+        return $contents;
+    }
+}
diff --git a/src/Llms/LlmsTxtGenerator.php b/src/Llms/LlmsTxtGenerator.php
new file mode 100644
index 00000000..1a1f87ee
--- /dev/null
+++ b/src/Llms/LlmsTxtGenerator.php
@@ -0,0 +1,502 @@
+<?php
+
+namespace Statamic\SeoPro\Llms;
+
+use Illuminate\Filesystem\Filesystem;
+use Illuminate\Filesystem\LockableFile;
+use Illuminate\Support\Carbon;
+use RuntimeException;
+use Statamic\SeoPro\Events\LlmsTxtGenerated;
+use Statamic\Sites\Site as SiteObject;
+use Throwable;
+
+class LlmsTxtGenerator
+{
+    public const MAX_BYTES = LlmsRenderer::MAX_BYTES;
+
+    public function __construct(
+        private Filesystem $files,
+        private LlmsRenderer $renderer,
+        private LlmsRenderCache $cache,
+    ) {}
+
+    public function generate(?LlmsDocument $document = null, string|SiteObject|null $site = null): array
+    {
+        $site = Llms::site($site);
+
+        return $this->locked(fn () => $this->generateWhileLocked($document ?? Llms::get($site), $site));
+    }
+
+    public function sync(LlmsDocument $document, string|SiteObject|null $site = null): array
+    {
+        $site = Llms::site($site);
+
+        return $this->locked(function () use ($document, $site) {
+            $status = $this->status($site);
+
+            if (! $document->enabled()) {
+                return $status['managed']
+                    ? $this->removeManagedWhileLocked($document, $site)
+                    : $this->saveOnly($document, $site, $status);
+            }
+
+            return $status['managed']
+                ? $this->generateWhileLocked($document, $site)
+                : $this->saveOnly($document, $site, $status);
+        });
+    }
+
+    public function status(string|SiteObject|null $site = null): array
+    {
+        $site = Llms::site($site);
+        $path = $this->path($site);
+
+        if (is_link($path)) {
+            return $this->statusResult($path, exists: true, issue: 'symlink');
+        }
+
+        if (! $this->files->exists($path)) {
+            return $this->statusResult($path);
+        }
+
+        if (! $this->files->isFile($path)) {
+            return $this->statusResult($path, exists: true, issue: 'unreadable');
+        }
+
+        try {
+            if ($this->files->size($path) > self::MAX_BYTES) {
+                return $this->statusResult($path, exists: true, issue: 'too_large');
+            }
+
+            $contents = $this->read($path);
+        } catch (Throwable) {
+            return $this->statusResult($path, exists: true, issue: 'unreadable');
+        }
+
+        if ($contents === false) {
+            return $this->statusResult($path, exists: true, issue: 'unreadable');
+        }
+
+        if (strlen($contents) > self::MAX_BYTES) {
+            return $this->statusResult($path, exists: true, issue: 'too_large');
+        }
+
+        if (! mb_check_encoding($contents, 'UTF-8')) {
+            return $this->statusResult($path, exists: true, issue: 'invalid_utf8');
+        }
+
+        $generated = Llms::generated($site) ?? [];
+        $checksum = hash('sha256', $contents);
+        $managed = is_string($generated['checksum'] ?? null)
+            && hash_equals($generated['checksum'], $checksum);
+        $outdated = false;
+
+        if ($managed && Llms::get($site)->enabled()) {
+            try {
+                $outdated = hash('sha256', $this->renderer->render(Llms::get($site), $site)) !== $checksum;
+            } catch (Throwable) {
+                $outdated = true;
+            }
+        }
+
+        return $this->statusResult(
+            path: $path,
+            exists: true,
+            managed: $managed,
+            contents: $contents,
+            timestamp: $managed ? ($generated['timestamp'] ?? null) : null,
+            issue: null,
+            outdated: $outdated,
+        );
+    }
+
+    public function path(string|SiteObject|null $site = null): string
+    {
+        return public_path(Llms::relativePath($site));
+    }
+
+    private function generateWhileLocked(LlmsDocument $document, SiteObject $site): array
+    {
+        if (! $document->enabled()) {
+            throw new RuntimeException("llms.txt is not enabled for site [{$site->handle()}].");
+        }
+
+        $path = $this->path($site);
+        $status = $this->status($site);
+
+        if ($status['exists'] && ! $status['managed']) {
+            throw new RuntimeException("The existing llms.txt file at [{$path}] is not managed by SEO Pro and will not be overwritten.");
+        }
+
+        $contents = $this->renderer->render($document, $site);
+        $checksum = hash('sha256', $contents);
+        $generated = Llms::generated($site) ?? [];
+        $existingGeneratedAt = $this->existingGeneratedAt($generated, $checksum);
+        $fileMatches = $this->fileMatches($path, $contents, $checksum);
+        $settingsMatch = Llms::get($site)->all() === $document->all();
+
+        if ($fileMatches && $settingsMatch && $existingGeneratedAt) {
+            return $this->result($path, $contents, $existingGeneratedAt, false, false, false);
+        }
+
+        if ($fileMatches) {
+            $generatedAt = $existingGeneratedAt ?? now();
+            $settingsSnapshot = Llms::settingsSnapshot();
+
+            try {
+                $this->saveGeneratedSettings($document, $site, $contents, $path, $generatedAt);
+            } catch (Throwable $exception) {
+                $this->rollback($exception, $settingsSnapshot);
+            }
+
+            $this->cache->forget($site);
+
+            return $this->result($path, $contents, $generatedAt, false, true, false);
+        }
+
+        $settingsSnapshot = Llms::settingsSnapshot();
+        $fileSnapshot = $this->snapshotFile(
+            $path,
+            expectedChecksum: $status['exists'] ? ($generated['checksum'] ?? null) : null,
+            expectMissing: ! $status['exists'],
+        );
+        $generatedAt = now();
+
+        try {
+            $this->writeFile($path, $contents);
+            $this->saveGeneratedSettings($document, $site, $contents, $path, $generatedAt);
+        } catch (Throwable $exception) {
+            $this->rollback($exception, $settingsSnapshot, $fileSnapshot);
+        }
+
+        $this->discardFileSnapshot($fileSnapshot);
+        $this->cache->forget($site);
+        LlmsTxtGenerated::dispatch($document, $site, $path, $generatedAt);
+
+        return $this->result($path, $contents, $generatedAt, true, true, false);
+    }
+
+    private function removeManagedWhileLocked(LlmsDocument $document, SiteObject $site): array
+    {
+        $path = $this->path($site);
+        $settingsSnapshot = Llms::settingsSnapshot();
+        $fileSnapshot = $this->snapshotFile(
+            $path,
+            expectedChecksum: Llms::generated($site)['checksum'] ?? null,
+        );
+
+        try {
+            if ($this->files->exists($path) && ! $this->files->delete($path)) {
+                throw new RuntimeException("Unable to remove the managed llms.txt file at [{$path}].");
+            }
+
+            if (! Llms::saveWithoutGenerated($document, $site)) {
+                throw new RuntimeException('Unable to save llms.txt settings.');
+            }
+        } catch (Throwable $exception) {
+            $this->rollback($exception, $settingsSnapshot, $fileSnapshot);
+        }
+
+        $this->discardFileSnapshot($fileSnapshot);
+        $this->cache->forget($site);
+
+        return $this->result($path, '', now(), true, true, true);
+    }
+
+    private function saveOnly(LlmsDocument $document, SiteObject $site, array $status): array
+    {
+        $contents = $document->enabled() ? $this->renderer->render($document, $site) : '';
+        $settingsChanged = Llms::get($site)->all() !== $document->all()
+            || Llms::generated($site) !== null;
+
+        if ($settingsChanged) {
+            $settingsSnapshot = Llms::settingsSnapshot();
+
+            try {
+                if (! Llms::saveWithoutGenerated($document, $site)) {
+                    throw new RuntimeException('Unable to save llms.txt settings.');
+                }
+            } catch (Throwable $exception) {
+                $this->rollback($exception, $settingsSnapshot);
+            }
+        }
+
+        $this->cache->forget($site);
+
+        return $this->result(
+            $status['path'],
+            $contents,
+            now(),
+            false,
+            $settingsChanged,
+            false,
+        );
+    }
+
+    private function locked(\Closure $callback): array
+    {
+        $lock = null;
+
+        try {
+            $lock = new LockableFile(storage_path('framework/cache/seo-pro/llms-txt.lock'), 'c+');
+            $lock->getExclusiveLock();
+        } catch (Throwable $exception) {
+            $lock?->close();
+
+            throw new RuntimeException('Unable to acquire the llms.txt generation lock. Another generation may already be in progress.', previous: $exception);
+        }
+
+        try {
+            return $callback();
+        } finally {
+            $lock->close();
+        }
+    }
+
+    private function writeFile(string $path, string $contents): void
+    {
+        try {
+            $this->files->ensureDirectoryExists(dirname($path));
+            $this->files->replace($path, $contents);
+        } catch (Throwable $exception) {
+            throw new RuntimeException("Unable to write llms.txt to [{$path}].", previous: $exception);
+        }
+    }
+
+    private function saveGeneratedSettings(
+        LlmsDocument $document,
+        SiteObject $site,
+        string $contents,
+        string $path,
+        Carbon $generatedAt,
+    ): void {
+        if (! Llms::saveGenerated($document, $site, $contents, $path, $generatedAt)) {
+            throw new RuntimeException('Unable to save llms.txt settings.');
+        }
+
+        $settings = Llms::settingsSnapshot()['raw']['llms']['sites'][$site->handle()] ?? [];
+
+        if (($settings['policy'] ?? null) !== $document->all()
+            || ($settings['generated']['timestamp'] ?? null) !== $generatedAt->toIso8601String()
+            || ($settings['generated']['checksum'] ?? null) !== hash('sha256', $contents)) {
+            throw new RuntimeException('The generated llms.txt settings could not be verified after saving.');
+        }
+    }
+
+    private function snapshotFile(
+        string $path,
+        ?string $expectedChecksum = null,
+        bool $expectMissing = false,
+    ): array {
+        if (is_link($path)) {
+            throw new RuntimeException("SEO Pro will not manage an llms.txt symbolic link at [{$path}].");
+        }
+
+        $target = realpath($path) ?: $path;
+        $exists = $this->files->exists($target);
+
+        if ($expectMissing && $exists) {
+            throw new RuntimeException("An unmanaged llms.txt file appeared at [{$path}] during generation and will not be overwritten.");
+        }
+
+        if (! $exists) {
+            if ($expectedChecksum !== null) {
+                throw new RuntimeException("The managed llms.txt file at [{$path}] changed during generation.");
+            }
+
+            return ['exists' => false, 'path' => $target, 'backup' => null, 'mode' => null];
+        }
+
+        if (! $this->files->isFile($target)) {
+            throw new RuntimeException("Unable to back up llms.txt at [{$target}].");
+        }
+
+        if ($expectedChecksum !== null) {
+            $currentChecksum = $this->files->hash($target, 'sha256');
+
+            if (! is_string($currentChecksum) || ! hash_equals($expectedChecksum, $currentChecksum)) {
+                throw new RuntimeException("The managed llms.txt file at [{$path}] changed during generation and will not be overwritten.");
+            }
+        }
+
+        $directory = dirname($target);
+        $backup = @tempnam($directory, '.seo-pro-llms-');
+        $backupDirectory = is_string($backup) ? realpath(dirname($backup)) : false;
+        $targetDirectory = realpath($directory);
+
+        if ($backup === false || $backupDirectory === false || $backupDirectory !== $targetDirectory) {
+            if (is_string($backup)) {
+                $this->files->delete($backup);
+            }
+
+            throw new RuntimeException("Unable to create an llms.txt backup beside [{$target}].");
+        }
+
+        try {
+            if (! $this->files->copy($target, $backup)) {
+                throw new RuntimeException("Unable to back up llms.txt at [{$target}].");
+            }
+
+            $permissions = @fileperms($target);
+
+            if ($permissions === false || ! $this->files->chmod($backup, $mode = $permissions & 0777)) {
+                throw new RuntimeException("Unable to preserve llms.txt permissions for [{$target}].");
+            }
+        } catch (Throwable $exception) {
+            $this->files->delete($backup);
+
+            throw $exception;
+        }
+
+        return ['exists' => true, 'path' => $target, 'backup' => $backup, 'mode' => $mode];
+    }
+
+    private function rollback(Throwable $original, array $settingsSnapshot, ?array $fileSnapshot = null): never
+    {
+        $rollbackErrors = [];
+
+        try {
+            Llms::restoreSettings($settingsSnapshot);
+        } catch (Throwable $exception) {
+            $rollbackErrors[] = 'settings: '.$exception->getMessage();
+        }
+
+        if ($fileSnapshot) {
+            try {
+                $this->restoreFileSnapshot($fileSnapshot);
+            } catch (Throwable $exception) {
+                $rollbackErrors[] = 'llms.txt: '.$exception->getMessage();
+            }
+        }
+
+        if ($rollbackErrors) {
+            throw new RuntimeException(
+                $original->getMessage().' Rollback also failed for '.implode('; ', $rollbackErrors),
+                previous: $original,
+            );
+        }
+
+        throw $original;
+    }
+
+    private function restoreFileSnapshot(array $snapshot): void
+    {
+        $path = $snapshot['path'];
+
+        if (! $snapshot['exists']) {
+            if ($this->files->exists($path) && ! $this->files->delete($path)) {
+                throw new RuntimeException("Unable to remove the newly generated file at [{$path}].");
+            }
+
+            return;
+        }
+
+        $backup = $snapshot['backup'];
+
+        if (! is_string($backup) || ! $this->files->isFile($backup)) {
+            throw new RuntimeException("The llms.txt rollback backup for [{$path}] is unavailable.");
+        }
+
+        if (! @rename($backup, $path)) {
+            if ($this->files->exists($path) && ! $this->files->delete($path)) {
+                throw new RuntimeException("Unable to replace llms.txt at [{$path}] during rollback.");
+            }
+
+            if (! @rename($backup, $path)) {
+                throw new RuntimeException("Unable to restore llms.txt at [{$path}]. The backup remains at [{$backup}].");
+            }
+        }
+
+        if (! $this->files->chmod($path, $snapshot['mode'])) {
+            throw new RuntimeException("Unable to restore llms.txt permissions at [{$path}].");
+        }
+    }
+
+    private function discardFileSnapshot(array $snapshot): void
+    {
+        if (is_string($snapshot['backup']) && $this->files->exists($snapshot['backup'])) {
+            if (! $this->files->delete($snapshot['backup'])) {
+                report(new RuntimeException("Unable to remove the llms.txt backup at [{$snapshot['backup']}]."));
+            }
+        }
+    }
+
+    private function fileMatches(string $path, string $contents, string $checksum): bool
+    {
+        try {
+            if (! $this->files->isFile($path) || $this->files->size($path) !== strlen($contents)) {
+                return false;
+            }
+
+            $existingChecksum = $this->files->hash($path, 'sha256');
+
+            return is_string($existingChecksum) && hash_equals($checksum, $existingChecksum);
+        } catch (Throwable) {
+            return false;
+        }
+    }
+
+    private function existingGeneratedAt(array $generated, string $checksum): ?Carbon
+    {
+        if (($generated['checksum'] ?? null) !== $checksum || ! is_string($generated['timestamp'] ?? null)) {
+            return null;
+        }
+
+        try {
+            return Carbon::parse($generated['timestamp']);
+        } catch (Throwable) {
+            return null;
+        }
+    }
+
+    private function result(
+        string $path,
+        string $contents,
+        Carbon $generatedAt,
+        bool $changed,
+        bool $settingsChanged,
+        bool $removed,
+    ): array {
+        return [
+            'path' => $path,
+            'timestamp' => $generatedAt->toIso8601String(),
+            'contents' => $contents,
+            'changed' => $changed,
+            'settings_changed' => $settingsChanged,
+            'removed' => $removed,
+        ];
+    }
+
+    private function read(string $path): string|false
+    {
+        if (! $stream = @fopen($path, 'rb')) {
+            return false;
+        }
+
+        try {
+            return stream_get_contents($stream, self::MAX_BYTES + 1);
+        } finally {
+            fclose($stream);
+        }
+    }
+
+    private function statusResult(
+        string $path,
+        bool $exists = false,
+        bool $managed = false,
+        ?string $contents = null,
+        ?string $timestamp = null,
+        ?string $issue = null,
+        bool $outdated = false,
+    ): array {
+        return [
+            'exists' => $exists,
+            'managed' => $managed,
+            'path' => $path,
+            'contents' => $contents,
+            'timestamp' => $timestamp,
+            'issue' => $issue,
+            'outdated' => $outdated,
+        ];
+    }
+}
diff --git a/src/ServiceProvider.php b/src/ServiceProvider.php
index 9aba486a..847748d8 100644
--- a/src/ServiceProvider.php
+++ b/src/ServiceProvider.php
@@ -7,6 +7,7 @@
 use Illuminate\Support\Facades\Event;
 use Illuminate\Support\Facades\Route;
 use Statamic\Console\Commands\Multisite;
+use Statamic\Console\Commands\StaticWarm;
 use Statamic\Exceptions\NotFoundHttpException;
 use Statamic\Facades\Addon;
 use Statamic\Facades\CP\Nav;
@@ -20,9 +21,11 @@
 use Statamic\Providers\AddonServiceProvider;
 use Statamic\SeoPro\Commands\GenerateReportCommand;
 use Statamic\SeoPro\Commands\PurgeErrorsCommand;
+use Statamic\SeoPro\Events\LlmsTxtGenerated;
 use Statamic\SeoPro\Events\RedirectSaved;
 use Statamic\SeoPro\GraphQL\AlternateLocaleType;
 use Statamic\SeoPro\GraphQL\SeoProType;
+use Statamic\SeoPro\Llms\Llms;
 use Statamic\SeoPro\Redirects\Error;
 use Statamic\SeoPro\Redirects\ErrorRepository;
 use Statamic\SeoPro\Redirects\HandleRedirects;
@@ -86,6 +89,7 @@ public function bootAddon()
             ->bootGit()
             ->bootAddonScheduledCommands()
             ->bootAddonGraphQL()
+            ->bootLlmsTxt()
             ->bootMultisiteCommandHook();
     }
 
@@ -286,14 +290,25 @@ protected function bootGit()
             config()->set('statamic.git.paths', array_values(array_unique([
                 ...config('statamic.git.paths', []),
                 public_path('robots.txt'),
+                ...Site::all()->map(fn ($site) => public_path(Llms::relativePath($site)))->all(),
             ])));
 
             Git::listen(RedirectSaved::class);
+            Git::listen(LlmsTxtGenerated::class);
         }
 
         return $this;
     }
 
+    protected function bootLlmsTxt()
+    {
+        StaticWarm::hook('additional', function ($urls, $next) {
+            return $next($urls->merge(Llms::enabledSites()->map(fn ($site) => Llms::url($site))));
+        });
+
+        return $this;
+    }
+
     protected function bootAddonScheduledCommands()
     {
         if (config('statamic.seo-pro.redirects.errors.enabled')) {

From 340068d4ec85e584b9ec6c1ddffaae39490b92de Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Tue, 1 Sep 2026 18:23:48 +0200
Subject: [PATCH 03/38] Add CLI command to generate llms.txt

---
 src/Commands/GenerateLlmsTxtCommand.php | 69 +++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 src/Commands/GenerateLlmsTxtCommand.php

diff --git a/src/Commands/GenerateLlmsTxtCommand.php b/src/Commands/GenerateLlmsTxtCommand.php
new file mode 100644
index 00000000..6227dbe6
--- /dev/null
+++ b/src/Commands/GenerateLlmsTxtCommand.php
@@ -0,0 +1,69 @@
+<?php
+
+namespace Statamic\SeoPro\Commands;
+
+use Illuminate\Console\Command;
+use Statamic\Console\RunsInPlease;
+use Statamic\Facades\Site;
+use Statamic\SeoPro\Llms\Llms;
+use Statamic\SeoPro\Llms\LlmsTxtGenerator;
+use Throwable;
+
+class GenerateLlmsTxtCommand extends Command
+{
+    use RunsInPlease;
+
+    protected $signature = 'statamic:seo-pro:generate:llms-txt
+        {--site=* : Generate only the specified Statamic site handle(s)}';
+
+    protected $description = 'Generate physical llms.txt files from the SEO Pro settings.';
+
+    public function handle(LlmsTxtGenerator $generator): int
+    {
+        $requested = collect($this->option('site'))->filter();
+
+        if ($unknown = $requested->diff(Site::all()->keys())->first()) {
+            $this->components->error("Unknown Statamic site [{$unknown}].");
+
+            return self::FAILURE;
+        }
+
+        $sites = ($requested->isEmpty()
+            ? Site::all()
+            : $requested->map(fn (string $handle) => Site::get($handle)))
+            ->filter(fn ($site) => Llms::get($site)->enabled())
+            ->values();
+
+        if ($sites->isEmpty()) {
+            $this->components->info('llms.txt is not enabled for any selected site.');
+
+            return self::SUCCESS;
+        }
+
+        if ($collision = $sites->groupBy(fn ($site) => $generator->path($site))->first(fn ($group) => $group->count() > 1)) {
+            $handles = $collision->map->handle()->implode(', ');
+            $this->components->error("The selected sites [{$handles}] resolve to the same physical llms.txt path. Generate one site per deployment with --site.");
+
+            return self::FAILURE;
+        }
+
+        foreach ($sites as $site) {
+            try {
+                $result = $generator->generate(null, $site);
+            } catch (Throwable $exception) {
+                report($exception);
+                $this->components->error($exception->getMessage());
+
+                return self::FAILURE;
+            }
+
+            $this->components->success($result['changed']
+                ? "Generated llms.txt for [{$site->handle()}]."
+                : "llms.txt for [{$site->handle()}] is already up to date.");
+            $this->line("Path: <comment>{$result['path']}</comment>");
+            $this->line("Generated: <comment>{$result['timestamp']}</comment>");
+        }
+
+        return self::SUCCESS;
+    }
+}

From 087cbb1fb354768608af5f90a694e7ee97401f23 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Tue, 1 Sep 2026 18:24:03 +0200
Subject: [PATCH 04/38] Add llms.txt to GraphQL

---
 src/GraphQL/SeoProType.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/GraphQL/SeoProType.php b/src/GraphQL/SeoProType.php
index 103d7292..77f5f3af 100644
--- a/src/GraphQL/SeoProType.php
+++ b/src/GraphQL/SeoProType.php
@@ -67,6 +67,9 @@ public function fields(): array
             'humans_txt' => [
                 'type' => GraphQL::string(),
             ],
+            'llms_txt' => [
+                'type' => GraphQL::string(),
+            ],
             'site' => [
                 'type' => GraphQL::type(SiteType::NAME),
             ],

From 06fc5e51712d0832dab994653d01e559b9145f45 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Tue, 1 Sep 2026 18:24:16 +0200
Subject: [PATCH 05/38] Add llms.txt to meta partial

---
 resources/views/meta.antlers.html | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/resources/views/meta.antlers.html b/resources/views/meta.antlers.html
index 411e88d5..bce0109a 100644
--- a/resources/views/meta.antlers.html
+++ b/resources/views/meta.antlers.html
@@ -109,6 +109,10 @@
     <link type="text/plain" rel="author" href="{{ humans_txt }}" />
 {{ /if }}
 
+{{ if llms_txt }}
+    <link rel="describedby" href="{{ llms_txt }}" />
+{{ /if }}
+
 {{ if google_verification }}
     <meta name="google-site-verification" content="{{ google_verification | striptags | entities | trim }}" />
 {{ /if }}
@@ -119,4 +123,4 @@
 
 {{ json_ld }}
     <script type="application/ld+json">{{ value }}</script>
-{{ /json_ld }}
\ No newline at end of file
+{{ /json_ld }}

From 9dbe3cbe3b03b94ae5c64a343025def521176e47 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Tue, 1 Sep 2026 18:24:24 +0200
Subject: [PATCH 06/38] Tests

---
 tests/GenerateLlmsTxtCommandTest.php |  60 +++++++
 tests/LlmsCpTest.php                 | 155 ++++++++++++++++++
 tests/LlmsStaticCachingTest.php      |  74 +++++++++
 tests/LlmsTest.php                   | 233 +++++++++++++++++++++++++++
 tests/Localized/LlmsTest.php         |  53 ++++++
 5 files changed, 575 insertions(+)
 create mode 100644 tests/GenerateLlmsTxtCommandTest.php
 create mode 100644 tests/LlmsCpTest.php
 create mode 100644 tests/LlmsStaticCachingTest.php
 create mode 100644 tests/LlmsTest.php
 create mode 100644 tests/Localized/LlmsTest.php

diff --git a/tests/GenerateLlmsTxtCommandTest.php b/tests/GenerateLlmsTxtCommandTest.php
new file mode 100644
index 00000000..9d08662b
--- /dev/null
+++ b/tests/GenerateLlmsTxtCommandTest.php
@@ -0,0 +1,60 @@
+<?php
+
+namespace Tests;
+
+use PHPUnit\Framework\Attributes\Test;
+use Statamic\Facades\Site;
+use Statamic\SeoPro\Llms\Llms;
+use Statamic\SeoPro\Llms\LlmsDocument;
+
+class GenerateLlmsTxtCommandTest extends TestCase
+{
+    protected function tearDown(): void
+    {
+        $this->files->delete(public_path('llms.txt'));
+
+        parent::tearDown();
+    }
+
+    #[Test]
+    public function it_does_nothing_when_the_feature_is_disabled()
+    {
+        $this->artisan('statamic:seo-pro:generate:llms-txt')
+            ->expectsOutputToContain('llms.txt is not enabled')
+            ->assertSuccessful();
+
+        $this->assertFileDoesNotExist(public_path('llms.txt'));
+    }
+
+    #[Test]
+    public function it_generates_an_enabled_site_for_git_workflows()
+    {
+        Llms::saveWithoutGenerated(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Cool Runnings',
+        ]), Site::default());
+
+        $this->artisan('statamic:seo-pro:generate:llms-txt', ['--site' => ['default']])
+            ->expectsOutputToContain('Generated llms.txt for [default].')
+            ->expectsOutputToContain(public_path('llms.txt'))
+            ->assertSuccessful();
+
+        $this->assertSame("# Cool Runnings\n", $this->files->get(public_path('llms.txt')));
+    }
+
+    #[Test]
+    public function it_fails_without_overwriting_an_unmanaged_file()
+    {
+        Llms::saveWithoutGenerated(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Cool Runnings',
+        ]), Site::default());
+        $this->files->put(public_path('llms.txt'), "# Manual\n");
+
+        $this->artisan('statamic:seo-pro:generate:llms-txt')
+            ->expectsOutputToContain('is not managed by SEO Pro')
+            ->assertFailed();
+
+        $this->assertSame("# Manual\n", $this->files->get(public_path('llms.txt')));
+    }
+}
diff --git a/tests/LlmsCpTest.php b/tests/LlmsCpTest.php
new file mode 100644
index 00000000..404a24fe
--- /dev/null
+++ b/tests/LlmsCpTest.php
@@ -0,0 +1,155 @@
+<?php
+
+namespace Tests;
+
+use PHPUnit\Framework\Attributes\Test;
+use Statamic\Facades\Addon;
+use Statamic\Facades\Role;
+use Statamic\Facades\User;
+
+class LlmsCpTest extends TestCase
+{
+    protected function tearDown(): void
+    {
+        $this->files->delete(public_path('llms.txt'));
+
+        parent::tearDown();
+    }
+
+    #[Test]
+    public function a_super_user_can_view_disabled_defaults()
+    {
+        $this->actingAs(User::make()->makeSuper()->save())
+            ->getJson(cp_route('seo-pro.llms.edit'))
+            ->assertOk()
+            ->assertJsonPath('values.enabled', false)
+            ->assertJsonPath('values.mode', 'managed')
+            ->assertJsonPath('values.title', '{{ config:app:name }}')
+            ->assertJsonPath('file.exists', false)
+            ->assertJsonPath('file.path', public_path('llms.txt'))
+            ->assertJsonPath('liveUrl', 'http://cool-runnings.com/llms.txt');
+    }
+
+    #[Test]
+    public function saving_enables_the_route_without_creating_a_file()
+    {
+        $this->actingAs(User::make()->makeSuper()->save())
+            ->patchJson(cp_route('seo-pro.llms.update'), $this->payload())
+            ->assertOk()
+            ->assertJsonPath('saved', true)
+            ->assertJsonPath('file.exists', false);
+
+        $this->assertFileDoesNotExist(public_path('llms.txt'));
+        $this->assertTrue((bool) Addon::get('statamic/seo-pro')->settings()->get('llms.sites.default.policy.enabled'));
+        $this->get('/llms.txt')->assertOk()->assertContent("# Cool Runnings\n");
+    }
+
+    #[Test]
+    public function generating_creates_a_managed_file()
+    {
+        $this->actingAs(User::make()->makeSuper()->save())
+            ->postJson(cp_route('seo-pro.llms.generate'), $this->payload())
+            ->assertOk()
+            ->assertJsonPath('generated', true)
+            ->assertJsonPath('changed', true)
+            ->assertJsonPath('file.exists', true)
+            ->assertJsonPath('file.managed', true);
+
+        $this->assertSame("# Cool Runnings\n", $this->files->get(public_path('llms.txt')));
+    }
+
+    #[Test]
+    public function saving_updates_only_a_file_that_seo_pro_manages()
+    {
+        $user = User::make()->makeSuper()->save();
+        $this->actingAs($user)->postJson(cp_route('seo-pro.llms.generate'), $this->payload())->assertOk();
+
+        $this->actingAs($user)
+            ->patchJson(cp_route('seo-pro.llms.update'), $this->payload(['title' => 'Updated']))
+            ->assertOk()
+            ->assertJsonPath('fileChanged', true)
+            ->assertJsonPath('file.managed', true);
+
+        $this->assertSame("# Updated\n", $this->files->get(public_path('llms.txt')));
+    }
+
+    #[Test]
+    public function an_unmanaged_file_is_reported_and_generation_is_refused()
+    {
+        $legacy = "# Existing manual file\n";
+        $this->files->put(public_path('llms.txt'), $legacy);
+        $user = User::make()->makeSuper()->save();
+
+        $this->actingAs($user)
+            ->getJson(cp_route('seo-pro.llms.edit'))
+            ->assertOk()
+            ->assertJsonPath('file.exists', true)
+            ->assertJsonPath('file.managed', false)
+            ->assertJsonPath('file.contents', $legacy);
+
+        $this->actingAs($user)
+            ->postJson(cp_route('seo-pro.llms.generate'), $this->payload())
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors('file');
+
+        $this->assertSame($legacy, $this->files->get(public_path('llms.txt')));
+    }
+
+    #[Test]
+    public function enabled_managed_mode_requires_a_renderable_h1_title()
+    {
+        $user = User::make()->makeSuper()->save();
+
+        $this->actingAs($user)
+            ->patchJson(cp_route('seo-pro.llms.update'), $this->payload(['title' => '']))
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors('title');
+
+        config(['statamic.system.view_config_allowlist' => ['app.name']]);
+        config(['app.name' => '']);
+        $this->actingAs($user)
+            ->patchJson(cp_route('seo-pro.llms.update'), $this->payload([
+                'title' => '{{ config:app:name }}',
+            ]))
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors('document');
+    }
+
+    #[Test]
+    public function enabled_custom_mode_requires_an_h1_after_antlers_is_parsed()
+    {
+        $this->actingAs(User::make()->makeSuper()->save())
+            ->patchJson(cp_route('seo-pro.llms.update'), $this->payload([
+                'mode' => 'custom',
+                'custom_source' => 'No heading',
+            ]))
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors('document');
+    }
+
+    #[Test]
+    public function users_without_permission_cannot_manage_llms_txt()
+    {
+        Role::make('editor')->permissions(['access cp'])->save();
+        $user = User::make()->assignRole('editor')->save();
+
+        $this->actingAs($user)->get(cp_route('seo-pro.llms.edit'))->assertRedirect('/cp');
+        $this->actingAs($user)->patch(cp_route('seo-pro.llms.update'), $this->payload())->assertRedirect('/cp');
+        $this->actingAs($user)->post(cp_route('seo-pro.llms.generate'), $this->payload())->assertRedirect('/cp');
+        $this->actingAs($user)->post(cp_route('seo-pro.llms.preview'), $this->payload())->assertRedirect('/cp');
+    }
+
+    private function payload(array $overrides = []): array
+    {
+        return array_replace_recursive([
+            'site' => 'default',
+            'enabled' => true,
+            'mode' => 'managed',
+            'title' => 'Cool Runnings',
+            'summary' => '',
+            'details' => '',
+            'sections' => [],
+            'custom_source' => '',
+        ], $overrides);
+    }
+}
diff --git a/tests/LlmsStaticCachingTest.php b/tests/LlmsStaticCachingTest.php
new file mode 100644
index 00000000..e87315f6
--- /dev/null
+++ b/tests/LlmsStaticCachingTest.php
@@ -0,0 +1,74 @@
+<?php
+
+namespace Tests;
+
+use PHPUnit\Framework\Attributes\Test;
+use Statamic\Facades\Site;
+use Statamic\SeoPro\Llms\Llms;
+use Statamic\SeoPro\Llms\LlmsDocument;
+use Statamic\StaticCaching\NoCache\Session;
+use Statamic\StaticCaching\StaticCacheManager;
+
+class LlmsStaticCachingTest extends TestCase
+{
+    protected function tearDown(): void
+    {
+        $this->files->deleteDirectory(public_path('static'));
+
+        parent::tearDown();
+    }
+
+    #[Test]
+    public function half_measure_caching_preserves_the_plain_text_response()
+    {
+        $this->useStaticCaching('half');
+        $this->enableLlmsTxt();
+
+        $this->get('/llms.txt')
+            ->assertOk()
+            ->assertContentType('text/plain; charset=UTF-8')
+            ->assertContent("# Cool Runnings\n");
+
+        $response = $this->get('/llms.txt')
+            ->assertOk()
+            ->assertContentType('text/plain; charset=UTF-8')
+            ->assertContent("# Cool Runnings\n");
+
+        $this->assertTrue($response->baseResponse->wasStaticallyCached());
+    }
+
+    #[Test]
+    public function full_measure_does_not_write_an_html_cache_file_for_the_text_route()
+    {
+        $this->useStaticCaching('full');
+        $this->enableLlmsTxt();
+
+        $this->get('/llms.txt')
+            ->assertOk()
+            ->assertContentType('text/plain; charset=UTF-8')
+            ->assertHeader('X-Statamic-Uncacheable', 'true')
+            ->assertContent("# Cool Runnings\n");
+
+        $this->get('/llms.txt')
+            ->assertOk()
+            ->assertContentType('text/plain; charset=UTF-8')
+            ->assertHeader('X-Statamic-Uncacheable', 'true');
+
+        $this->assertFileDoesNotExist(public_path('static/llms.txt.html'));
+    }
+
+    private function useStaticCaching(string $strategy): void
+    {
+        config()->set('statamic.static_caching.strategy', $strategy);
+        app()->forgetInstance(StaticCacheManager::class);
+        app()->forgetInstance(Session::class);
+    }
+
+    private function enableLlmsTxt(): void
+    {
+        Llms::saveWithoutGenerated(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Cool Runnings',
+        ]), Site::default());
+    }
+}
diff --git a/tests/LlmsTest.php b/tests/LlmsTest.php
new file mode 100644
index 00000000..ba6e170b
--- /dev/null
+++ b/tests/LlmsTest.php
@@ -0,0 +1,233 @@
+<?php
+
+namespace Tests;
+
+use Illuminate\Cache\ArrayStore;
+use Illuminate\Cache\Repository;
+use Illuminate\Support\Facades\Event;
+use PHPUnit\Framework\Attributes\Test;
+use Statamic\Events\AddonSettingsSaved;
+use Statamic\Facades\Addon;
+use Statamic\Facades\Site;
+use Statamic\SeoPro\Cascade;
+use Statamic\SeoPro\Llms\Llms;
+use Statamic\SeoPro\Llms\LlmsDocument;
+use Statamic\SeoPro\Llms\LlmsRenderCache;
+use Statamic\SeoPro\Llms\LlmsRenderer;
+use Statamic\SeoPro\Llms\LlmsTxtGenerator;
+
+class LlmsTest extends TestCase
+{
+    protected function tearDown(): void
+    {
+        $this->files->delete(public_path('llms.txt'));
+
+        parent::tearDown();
+    }
+
+    #[Test]
+    public function the_frontend_route_is_opt_in()
+    {
+        $this->get('/llms.txt')->assertNotFound();
+        $this->assertFalse(Llms::get()->enabled());
+    }
+
+    #[Test]
+    public function it_renders_managed_content_and_parses_antlers()
+    {
+        config(['app.name' => 'Cool Runnings']);
+        $this->saveEnabled([
+            'title' => '{{ config:app:name }}',
+            'summary' => 'The fastest team on ice.',
+            'details' => "A site about bobsledding.\nBuilt in Jamaica.",
+            'sections' => [[
+                'title' => 'Documentation',
+                'links' => [[
+                    'title' => 'About {{ config:app:name }}',
+                    'url' => 'https://example.com/about',
+                    'description' => 'Learn more about the team.',
+                ]],
+            ]],
+        ]);
+
+        $response = $this->get('/llms.txt')
+            ->assertOk()
+            ->assertContentType('text/plain; charset=UTF-8')
+            ->assertHeader('Cache-Control', 'public');
+
+        $this->assertSame(<<<'TXT'
+# Cool Runnings
+
+> The fastest team on ice.
+
+A site about bobsledding.
+Built in Jamaica.
+
+## Documentation
+
+- [About Cool Runnings](https://example.com/about): Learn more about the team.
+TXT."\n", $response->content());
+    }
+
+    #[Test]
+    public function it_renders_custom_source_after_parsing_antlers()
+    {
+        config(['app.name' => 'Cool Runnings']);
+        $this->saveEnabled([
+            'mode' => 'custom',
+            'custom_source' => "# {{ config:app:name }}\r\n\r\nCustom content.\r\n",
+        ]);
+
+        $this->get('/llms.txt')
+            ->assertOk()
+            ->assertContent("# Cool Runnings\n\nCustom content.\n");
+    }
+
+    #[Test]
+    public function it_returns_a_conditional_response_using_an_etag()
+    {
+        $this->saveEnabled(['title' => 'Cool Runnings']);
+        $etag = $this->get('/llms.txt')->assertOk()->headers->get('ETag');
+
+        $this->withHeader('If-None-Match', $etag)
+            ->get('/llms.txt')
+            ->assertStatus(304)
+            ->assertContent('');
+    }
+
+    #[Test]
+    public function rendered_content_is_cached_until_its_fingerprint_changes()
+    {
+        $renderer = new class extends LlmsRenderer
+        {
+            public int $renders = 0;
+
+            public function render(LlmsDocument|array $document, string|\Statamic\Sites\Site|null $site = null): string
+            {
+                $this->renders++;
+
+                return parent::render($document, $site);
+            }
+        };
+        $cache = new LlmsRenderCache(new Repository(new ArrayStore), $renderer);
+        $document = new LlmsDocument(['enabled' => true, 'title' => 'First']);
+
+        $this->assertSame("# First\n", $cache->get($document));
+        $this->assertSame("# First\n", $cache->get($document));
+        $this->assertSame(1, $renderer->renders);
+
+        $this->assertSame("# Second\n", $cache->get(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Second',
+        ])));
+        $this->assertSame(2, $renderer->renders);
+    }
+
+    #[Test]
+    public function saving_does_not_create_a_physical_file_until_generation_is_requested()
+    {
+        $document = new LlmsDocument(['enabled' => true, 'title' => 'Cool Runnings']);
+        $result = app(LlmsTxtGenerator::class)->sync($document);
+
+        $this->assertFalse($result['changed']);
+        $this->assertFileDoesNotExist(public_path('llms.txt'));
+        $this->get('/llms.txt')->assertOk()->assertContent("# Cool Runnings\n");
+    }
+
+    #[Test]
+    public function a_generated_file_is_kept_in_sync_and_removed_when_disabled()
+    {
+        $generator = app(LlmsTxtGenerator::class);
+        $first = new LlmsDocument(['enabled' => true, 'title' => 'First']);
+        $generator->generate($first);
+
+        $this->assertSame("# First\n", $this->files->get(public_path('llms.txt')));
+        $this->assertTrue($generator->status()['managed']);
+
+        $generator->sync(new LlmsDocument(['enabled' => true, 'title' => 'Second']));
+        $this->assertSame("# Second\n", $this->files->get(public_path('llms.txt')));
+
+        $result = $generator->sync(new LlmsDocument(['enabled' => false, 'title' => 'Second']));
+        $this->assertTrue($result['removed']);
+        $this->assertFileDoesNotExist(public_path('llms.txt'));
+        $this->assertNull(Llms::generated());
+    }
+
+    #[Test]
+    public function an_unmanaged_file_is_never_overwritten_or_removed()
+    {
+        $generator = app(LlmsTxtGenerator::class);
+        $legacy = "# Manually managed\n";
+        $this->files->put(public_path('llms.txt'), $legacy);
+        $document = new LlmsDocument(['enabled' => true, 'title' => 'SEO Pro']);
+
+        $generator->sync($document);
+        $this->assertSame($legacy, $this->files->get(public_path('llms.txt')));
+        $this->assertFalse($generator->status()['managed']);
+
+        try {
+            $generator->generate($document);
+            $this->fail('Generation should refuse an unmanaged file.');
+        } catch (\RuntimeException $exception) {
+            $this->assertStringContainsString('is not managed by SEO Pro', $exception->getMessage());
+        }
+
+        $generator->sync(new LlmsDocument(['enabled' => false, 'title' => 'SEO Pro']));
+        $this->assertSame($legacy, $this->files->get(public_path('llms.txt')));
+    }
+
+    #[Test]
+    public function manually_changing_a_generated_file_relinquishes_ownership()
+    {
+        $generator = app(LlmsTxtGenerator::class);
+        $generator->generate(new LlmsDocument(['enabled' => true, 'title' => 'First']));
+        $this->files->put(public_path('llms.txt'), "# Changed manually\n");
+
+        $generator->sync(new LlmsDocument(['enabled' => true, 'title' => 'Second']));
+
+        $this->assertSame("# Changed manually\n", $this->files->get(public_path('llms.txt')));
+        $this->assertNull(Addon::get('statamic/seo-pro')->settings()->get('llms.sites.default.generated'));
+        $this->assertFalse($generator->status()['managed']);
+    }
+
+    #[Test]
+    public function a_failed_settings_save_restores_the_managed_file_and_settings()
+    {
+        $generator = app(LlmsTxtGenerator::class);
+        $generator->generate(new LlmsDocument(['enabled' => true, 'title' => 'First']));
+        $previousContents = $this->files->get(public_path('llms.txt'));
+        $previousSettings = Llms::settingsSnapshot();
+
+        Event::listen(AddonSettingsSaved::class, function () {
+            throw new \RuntimeException('The settings listener failed.');
+        });
+
+        try {
+            $generator->sync(new LlmsDocument(['enabled' => true, 'title' => 'Second']));
+            $this->fail('Synchronization should have failed.');
+        } catch (\RuntimeException $exception) {
+            $this->assertSame('The settings listener failed.', $exception->getMessage());
+        }
+
+        $this->assertSame($previousContents, $this->files->get(public_path('llms.txt')));
+        $this->assertSame($previousSettings, Llms::settingsSnapshot());
+        $this->assertTrue($generator->status()['managed']);
+        $this->assertSame([], glob(public_path('.seo-pro-llms-*')));
+    }
+
+    #[Test]
+    public function enabled_llms_txt_is_exposed_to_the_meta_cascade()
+    {
+        $this->saveEnabled(['title' => 'Cool Runnings']);
+
+        $this->assertSame('http://cool-runnings.com/llms.txt', (new Cascade)->get()['llms_txt']);
+    }
+
+    private function saveEnabled(array $overrides = []): void
+    {
+        Llms::saveWithoutGenerated(new LlmsDocument(array_replace([
+            'enabled' => true,
+            'title' => 'Cool Runnings',
+        ], $overrides)), Site::default());
+    }
+}
diff --git a/tests/Localized/LlmsTest.php b/tests/Localized/LlmsTest.php
new file mode 100644
index 00000000..97f6b1f2
--- /dev/null
+++ b/tests/Localized/LlmsTest.php
@@ -0,0 +1,53 @@
+<?php
+
+namespace Tests\Localized;
+
+use PHPUnit\Framework\Attributes\Test;
+use Statamic\Facades\Site;
+use Statamic\SeoPro\Llms\Llms;
+use Statamic\SeoPro\Llms\LlmsDocument;
+use Statamic\SeoPro\Llms\LlmsTxtGenerator;
+
+class LlmsTest extends LocalizedTestCase
+{
+    protected function tearDown(): void
+    {
+        $this->files->delete(public_path('llms.txt'));
+        $this->files->deleteDirectory(public_path('fr'));
+
+        parent::tearDown();
+    }
+
+    #[Test]
+    public function routes_and_settings_are_scoped_per_site()
+    {
+        Llms::saveWithoutGenerated(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'English',
+        ]), Site::get('default'));
+        Llms::saveWithoutGenerated(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Français',
+        ]), Site::get('french'));
+
+        $this->get('http://cool-runnings.com/llms.txt')
+            ->assertOk()
+            ->assertContent("# English\n");
+        $this->get('http://cool-runnings.com/fr/llms.txt')
+            ->assertOk()
+            ->assertContent("# Français\n");
+        $this->get('http://cool-runnings.com/en-gb/llms.txt')->assertNotFound();
+    }
+
+    #[Test]
+    public function generated_files_follow_each_sites_base_path()
+    {
+        $generator = app(LlmsTxtGenerator::class);
+        $document = new LlmsDocument(['enabled' => true, 'title' => 'Français']);
+
+        $result = $generator->generate($document, 'french');
+
+        $this->assertSame(public_path('fr/llms.txt'), $result['path']);
+        $this->assertSame("# Français\n", $this->files->get(public_path('fr/llms.txt')));
+    }
+}

From 5a6d0a5c87143185b5c59df31a2189490ede4fcb Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Tue, 1 Sep 2026 18:31:21 +0200
Subject: [PATCH 07/38] Fix test on Windows

---
 tests/LlmsTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/LlmsTest.php b/tests/LlmsTest.php
index ba6e170b..ef516813 100644
--- a/tests/LlmsTest.php
+++ b/tests/LlmsTest.php
@@ -55,7 +55,7 @@ public function it_renders_managed_content_and_parses_antlers()
             ->assertContentType('text/plain; charset=UTF-8')
             ->assertHeader('Cache-Control', 'public');
 
-        $this->assertSame(<<<'TXT'
+        $this->assertEqualsIgnoringLineEndings(<<<'TXT'
 # Cool Runnings
 
 > The fastest team on ice.

From ecb991cf1ad77ab35ef8ec08ec29c4624edcca32 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Tue, 1 Sep 2026 19:14:04 +0200
Subject: [PATCH 08/38] Checks there's only one h1 and remove clanker stupidity

---
 src/Llms/LlmsRenderer.php | 35 +++++++++++++++++++++++++++++------
 tests/LlmsTest.php        | 39 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 68 insertions(+), 6 deletions(-)

diff --git a/src/Llms/LlmsRenderer.php b/src/Llms/LlmsRenderer.php
index 433daab3..2501bc23 100644
--- a/src/Llms/LlmsRenderer.php
+++ b/src/Llms/LlmsRenderer.php
@@ -3,14 +3,15 @@
 namespace Statamic\SeoPro\Llms;
 
 use InvalidArgumentException;
+use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
+use League\CommonMark\Parser\MarkdownParser;
 use Statamic\Facades\Antlers;
+use Statamic\Facades\Markdown;
 use Statamic\Sites\Site as SiteObject;
 use Statamic\View\Cascade;
 
 class LlmsRenderer
 {
-    public const VERSION = 1;
-
     public const MAX_BYTES = 512000;
 
     public function render(LlmsDocument|array $document, string|SiteObject|null $site = null): string
@@ -92,10 +93,10 @@ public function contextFingerprint(string|SiteObject|null $site = null): string
     {
         $site = Llms::site($site);
 
-        return hash('sha256', (string) json_encode([
-            'renderer' => self::VERSION,
-            'context' => $this->context($site),
-        ], JSON_PARTIAL_OUTPUT_ON_ERROR | JSON_PRESERVE_ZERO_FRACTION));
+        return hash('sha256', (string) json_encode(
+            $this->context($site),
+            JSON_PARTIAL_OUTPUT_ON_ERROR | JSON_PRESERVE_ZERO_FRACTION,
+        ));
     }
 
     private function parse(string $value, array $context): string
@@ -197,6 +198,28 @@ private function finalize(string $contents): string
             throw new InvalidArgumentException('The resolved llms.txt document must not be greater than 500 KiB.');
         }
 
+        $this->validateH1Count($contents);
+
         return $contents;
     }
+
+    private function validateH1Count(string $contents): void
+    {
+        $walker = (new MarkdownParser(Markdown::environment()))
+            ->parse($contents)
+            ->walker();
+        $h1Count = 0;
+
+        while ($event = $walker->next()) {
+            $node = $event->getNode();
+
+            if ($event->isEntering() && $node instanceof Heading && $node->getLevel() === 1) {
+                $h1Count++;
+            }
+        }
+
+        if ($h1Count !== 1) {
+            throw new InvalidArgumentException('The resolved llms.txt document must contain exactly one Markdown H1 heading.');
+        }
+    }
 }
diff --git a/tests/LlmsTest.php b/tests/LlmsTest.php
index ef516813..149a0e9b 100644
--- a/tests/LlmsTest.php
+++ b/tests/LlmsTest.php
@@ -5,6 +5,7 @@
 use Illuminate\Cache\ArrayStore;
 use Illuminate\Cache\Repository;
 use Illuminate\Support\Facades\Event;
+use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\Test;
 use Statamic\Events\AddonSettingsSaved;
 use Statamic\Facades\Addon;
@@ -83,6 +84,44 @@ public function it_renders_custom_source_after_parsing_antlers()
             ->assertContent("# Cool Runnings\n\nCustom content.\n");
     }
 
+    #[Test]
+    #[DataProvider('additionalH1Provider')]
+    public function it_rejects_documents_with_more_than_one_markdown_h1(string $source)
+    {
+        $this->expectException(\InvalidArgumentException::class);
+        $this->expectExceptionMessage('must contain exactly one Markdown H1 heading');
+
+        app(LlmsRenderer::class)->render(new LlmsDocument([
+            'enabled' => true,
+            'mode' => 'custom',
+            'custom_source' => $source,
+        ]));
+    }
+
+    public static function additionalH1Provider(): array
+    {
+        return [
+            'ATX heading' => ["# First\n\n# Second"],
+            'Setext heading' => ["# First\n\nSecond\n======"],
+            'heading in a blockquote' => ["# First\n\n> # Second"],
+        ];
+    }
+
+    #[Test]
+    public function h1_syntax_inside_a_fenced_code_block_is_not_counted_as_a_heading()
+    {
+        $source = "# First\n\n```md\n# Example code\n```";
+
+        $this->assertSame(
+            $source."\n",
+            app(LlmsRenderer::class)->render(new LlmsDocument([
+                'enabled' => true,
+                'mode' => 'custom',
+                'custom_source' => $source,
+            ])),
+        );
+    }
+
     #[Test]
     public function it_returns_a_conditional_response_using_an_etag()
     {

From c0ad4457dfeb7b362b6e67bc398c9a579730f512 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Tue, 1 Sep 2026 19:17:13 +0200
Subject: [PATCH 09/38] Hide settings/config when feature is disabled

---
 resources/js/pages/llms/Tab.vue | 125 +++++++++++++++++---------------
 1 file changed, 65 insertions(+), 60 deletions(-)

diff --git a/resources/js/pages/llms/Tab.vue b/resources/js/pages/llms/Tab.vue
index 3ad96ba5..01c93296 100644
--- a/resources/js/pages/llms/Tab.vue
+++ b/resources/js/pages/llms/Tab.vue
@@ -215,9 +215,10 @@ defineExpose({ save });
 				<div class="flex flex-wrap items-center gap-2 sm:gap-3">
 					<Button v-if="form.enabled || file.exists" :href="liveUrl" target="_blank" variant="ghost" icon="external-link" :text="__('seo-pro::messages.llms_txt.view_live_file')" />
 					<Button
+						v-if="form.enabled"
 						variant="default"
 						:text="__('Generate')"
-						:disabled="isBusy || !form.enabled || hasUnmanagedFile"
+						:disabled="isBusy || hasUnmanagedFile"
 						:loading="generating"
 						@click="requestGeneration"
 					/>
@@ -261,7 +262,7 @@ defineExpose({ save });
 					</ul>
 				</Alert>
 
-				<Panel class="p-6 space-y-6">
+				<Panel class="p-6">
 					<div class="flex items-start justify-between gap-6">
 						<div>
 							<Heading :text="__('seo-pro::messages.llms_txt.enable')" />
@@ -269,77 +270,81 @@ defineExpose({ save });
 						</div>
 						<Switch v-model="form.enabled" />
 					</div>
-
-					<Field :label="__('seo-pro::messages.llms_txt.editing_mode')" :instructions="__('seo-pro::messages.llms_txt.editing_mode_instructions')">
-						<Select class="max-w-sm" :options="modeOptions" v-model="form.mode" />
-					</Field>
 				</Panel>
 
-				<template v-if="form.mode === 'managed'">
-					<Panel class="p-6 space-y-6">
-						<Field :label="__('seo-pro::messages.llms_txt.title')" :instructions="__('seo-pro::messages.llms_txt.title_instructions')" :required="form.enabled">
-							<Input v-model="form.title" class="font-mono" />
-						</Field>
-						<Field :label="__('seo-pro::messages.llms_txt.summary')" :instructions="__('seo-pro::messages.llms_txt.summary_instructions')">
-							<Textarea v-model="form.summary" rows="3" />
-						</Field>
-						<Field :label="__('seo-pro::messages.llms_txt.details')" :instructions="__('seo-pro::messages.llms_txt.details_instructions')">
-							<Textarea v-model="form.details" rows="5" class="font-mono" />
+				<template v-if="form.enabled">
+					<Panel class="p-6">
+						<Field :label="__('seo-pro::messages.llms_txt.editing_mode')" :instructions="__('seo-pro::messages.llms_txt.editing_mode_instructions')">
+							<Select class="max-w-sm" :options="modeOptions" v-model="form.mode" />
 						</Field>
 					</Panel>
 
-					<section>
-						<div class="flex items-center justify-between gap-4 mb-3">
-							<div>
-								<Subheading size="lg" :text="__('seo-pro::messages.llms_txt.sections')" />
-								<Description :text="__('seo-pro::messages.llms_txt.sections_description')" />
+					<template v-if="form.mode === 'managed'">
+						<Panel class="p-6 space-y-6">
+							<Field :label="__('seo-pro::messages.llms_txt.title')" :instructions="__('seo-pro::messages.llms_txt.title_instructions')" required>
+								<Input v-model="form.title" class="font-mono" />
+							</Field>
+							<Field :label="__('seo-pro::messages.llms_txt.summary')" :instructions="__('seo-pro::messages.llms_txt.summary_instructions')">
+								<Textarea v-model="form.summary" rows="3" />
+							</Field>
+							<Field :label="__('seo-pro::messages.llms_txt.details')" :instructions="__('seo-pro::messages.llms_txt.details_instructions')">
+								<Textarea v-model="form.details" rows="5" class="font-mono" />
+							</Field>
+						</Panel>
+
+						<section>
+							<div class="flex items-center justify-between gap-4 mb-3">
+								<div>
+									<Subheading size="lg" :text="__('seo-pro::messages.llms_txt.sections')" />
+									<Description :text="__('seo-pro::messages.llms_txt.sections_description')" />
+								</div>
+								<Button size="sm" variant="ghost" icon="plus" :text="__('seo-pro::messages.llms_txt.add_section')" @click="addSection" />
 							</div>
-							<Button size="sm" variant="ghost" icon="plus" :text="__('seo-pro::messages.llms_txt.add_section')" @click="addSection" />
-						</div>
 
-						<div class="space-y-4">
-							<Panel v-for="(section, sectionIndex) in form.sections" :key="sectionIndex" class="p-6 space-y-5">
-								<div class="flex gap-2">
-									<Field class="flex-1" :label="__('seo-pro::messages.llms_txt.section_title')">
-										<Input v-model="section.title" />
-									</Field>
-									<Button class="self-end" icon="trash" variant="ghost" :aria-label="__('Remove')" @click="removeSection(sectionIndex)" />
-								</div>
+							<div class="space-y-4">
+								<Panel v-for="(section, sectionIndex) in form.sections" :key="sectionIndex" class="p-6 space-y-5">
+									<div class="flex gap-2">
+										<Field class="flex-1" :label="__('seo-pro::messages.llms_txt.section_title')">
+											<Input v-model="section.title" />
+										</Field>
+										<Button class="self-end" icon="trash" variant="ghost" :aria-label="__('Remove')" @click="removeSection(sectionIndex)" />
+									</div>
 
-								<div class="space-y-3">
-									<div v-for="(link, linkIndex) in section.links" :key="linkIndex" class="rounded-lg border p-4 space-y-3 dark:border-gray-700">
-										<div class="grid gap-3 md:grid-cols-2">
-											<Field :label="__('seo-pro::messages.llms_txt.link_title')"><Input v-model="link.title" /></Field>
-											<Field :label="__('seo-pro::messages.llms_txt.link_url')"><Input v-model="link.url" class="font-mono" /></Field>
-										</div>
-										<div class="flex gap-2">
-											<Field class="flex-1" :label="__('seo-pro::messages.llms_txt.link_description')"><Textarea v-model="link.description" rows="2" /></Field>
-											<Button class="self-end" icon="trash" variant="ghost" :aria-label="__('Remove')" @click="removeLink(section, linkIndex)" />
+									<div class="space-y-3">
+										<div v-for="(link, linkIndex) in section.links" :key="linkIndex" class="rounded-lg border p-4 space-y-3 dark:border-gray-700">
+											<div class="grid gap-3 md:grid-cols-2">
+												<Field :label="__('seo-pro::messages.llms_txt.link_title')"><Input v-model="link.title" /></Field>
+												<Field :label="__('seo-pro::messages.llms_txt.link_url')"><Input v-model="link.url" class="font-mono" /></Field>
+											</div>
+											<div class="flex gap-2">
+												<Field class="flex-1" :label="__('seo-pro::messages.llms_txt.link_description')"><Textarea v-model="link.description" rows="2" /></Field>
+												<Button class="self-end" icon="trash" variant="ghost" :aria-label="__('Remove')" @click="removeLink(section, linkIndex)" />
+											</div>
 										</div>
+										<Button size="sm" variant="ghost" icon="plus" :text="__('seo-pro::messages.llms_txt.add_link')" @click="addLink(section)" />
 									</div>
-									<Button size="sm" variant="ghost" icon="plus" :text="__('seo-pro::messages.llms_txt.add_link')" @click="addLink(section)" />
-								</div>
-							</Panel>
-						</div>
-					</section>
-				</template>
+								</Panel>
+							</div>
+						</section>
+					</template>
 
-				<Panel v-else class="p-6">
-					<Heading size="lg" :text="__('seo-pro::messages.llms_txt.custom_source_heading')" />
-					<Description class="mt-1 mb-5" :text="__('seo-pro::messages.llms_txt.custom_source_description')" />
-					<CodeEditor v-model="form.custom_source" mode="markdown" :allow-mode-selection="false" :show-mode-label="false" title="llms.txt" />
-				</Panel>
+					<Panel v-else class="p-6">
+						<Heading size="lg" :text="__('seo-pro::messages.llms_txt.custom_source_heading')" />
+						<Description class="mt-1 mb-5" :text="__('seo-pro::messages.llms_txt.custom_source_description')" />
+						<CodeEditor v-model="form.custom_source" mode="markdown" :allow-mode-selection="false" :show-mode-label="false" title="llms.txt" />
+					</Panel>
 
-				<Panel class="p-6">
-					<div class="flex items-center justify-between mb-4">
-						<div>
-							<Heading size="lg" :text="__('seo-pro::messages.llms_txt.generated_preview')" />
-							<Description :text="liveUrl" />
+					<Panel class="p-6">
+						<div class="flex items-center justify-between mb-4">
+							<div>
+								<Heading size="lg" :text="__('seo-pro::messages.llms_txt.generated_preview')" />
+								<Description :text="liveUrl" />
+							</div>
+							<Badge v-if="previewError" color="red" :text="__('seo-pro::messages.llms_txt.preview_unavailable')" />
 						</div>
-						<Badge v-if="previewError" color="red" :text="__('seo-pro::messages.llms_txt.preview_unavailable')" />
-					</div>
-					<CodeEditor :model-value="rendered" mode="markdown" :allow-mode-selection="false" :show-mode-label="false" read-only :title="__('seo-pro::messages.llms_txt.preview_title')" />
-				</Panel>
+						<CodeEditor :model-value="rendered" mode="markdown" :allow-mode-selection="false" :show-mode-label="false" read-only :title="__('seo-pro::messages.llms_txt.preview_title')" />
+					</Panel>
+				</template>
 			</div>
 
 			<confirmation-modal

From 4c3dc8071edeece61304acff2cc6df79a578ec33 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Tue, 1 Sep 2026 19:20:33 +0200
Subject: [PATCH 10/38] Hide preview on custom mode

---
 resources/js/pages/llms/Tab.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/resources/js/pages/llms/Tab.vue b/resources/js/pages/llms/Tab.vue
index 01c93296..9b478768 100644
--- a/resources/js/pages/llms/Tab.vue
+++ b/resources/js/pages/llms/Tab.vue
@@ -334,7 +334,7 @@ defineExpose({ save });
 						<CodeEditor v-model="form.custom_source" mode="markdown" :allow-mode-selection="false" :show-mode-label="false" title="llms.txt" />
 					</Panel>
 
-					<Panel class="p-6">
+					<Panel v-if="form.mode === 'managed'" class="p-6">
 						<div class="flex items-center justify-between mb-4">
 							<div>
 								<Heading size="lg" :text="__('seo-pro::messages.llms_txt.generated_preview')" />

From 81d35b7b404e5b97a93d5ebe7c76a78fdccdc34b Mon Sep 17 00:00:00 2001
From: Duncan McClean <duncan@duncanmcclean.com>
Date: Thu, 3 Sep 2026 11:07:11 +0100
Subject: [PATCH 11/38] Update Release Workflow (#653)

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
---
 .gitattributes                |   1 +
 .github/workflows/release.yml | 105 ++++++++++++++++++++++++++--------
 composer.json                 |  12 ----
 3 files changed, 83 insertions(+), 35 deletions(-)
 create mode 100644 .gitattributes

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 00000000..65183cfa
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1 @@
+/resources/dist/**/* linguist-generated=true
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index c57bd6a5..a88957af 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -1,51 +1,110 @@
 name: Create Release
 
 on: # zizmor: ignore[concurrency-limits]
-  push:
-    tags:
-      - 'v*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Release version, without the v prefix (e.g. 1.2.0)'
+        required: true
+        type: string
 
 permissions: {}
 
 jobs:
-  build: # zizmor: ignore[anonymous-definition]
+  release:
+    name: Create Release
     runs-on: ubuntu-latest
-    permissions:
-      contents: write # create GitHub release and upload assets
+    environment: Releases
+    permissions: {} # all writes go through the App token; GITHUB_TOKEN needs no scopes
     steps:
-      - name: Checkout code
+      - name: Resolve and validate version
+        env:
+          INPUT_VERSION: ${{ inputs.version }}
+          BRANCH: ${{ github.ref_name }}
+        run: |
+          version="${INPUT_VERSION#v}"
+
+          if [[ ! "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.]+)?$ ]]; then
+            echo "::error::Version must look like 1.2.0 (got: $INPUT_VERSION)"
+            exit 1
+          fi
+
+          if [[ "$BRANCH" =~ ^[0-9]+\.x$ ]] && [ "${version%%.*}" != "${BRANCH%%.*}" ]; then
+            echo "::error::Version $version does not belong on the $BRANCH branch"
+            exit 1
+          fi
+
+          echo "TAG=v$version" >> "$GITHUB_ENV"
+
+      - name: Get release bot token
+        id: app-token
+        uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3.2.0
+        with:
+          client-id: ${{ secrets.RELEASE_APP_CLIENT_ID }}
+          private-key: ${{ secrets.RELEASE_APP_PRIVATE_KEY }}
+          permission-contents: write
+
+      - name: Checkout
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
-          persist-credentials: false
+          token: ${{ steps.app-token.outputs.token }}
+          persist-credentials: true # zizmor: ignore[artipacked] App token is needed to push the tag
 
-      - name: Install Composer Dependencies
+      - name: Assert tag does not already exist
+        run: |
+          existing="$(git ls-remote --tags origin "$TAG")"
+          [ -z "$existing" ] || { echo "::error::Tag $TAG already exists on remote. Aborting."; exit 1; }
+
+      - name: Use Node.js 20.19.0
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: 20.19.0
+          package-manager-cache: false
+
+      - name: Install Composer dependencies
         run: composer install
 
-      - name: Install NPM Dependencies
+      - name: Install NPM dependencies
         run: npm ci
 
-      - name: Compile assets
+      - name: Build release assets
         run: npm run build
 
-      - name: Create zip
-        run: cd resources && tar -czvf dist.tar.gz dist
+      - name: Create the build commit
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+          APP_SLUG: ${{ steps.app-token.outputs.app-slug }}
+        run: |
+          USER_ID="$(gh api "/users/${APP_SLUG}[bot]" --jq .id)"
+          git config user.name "${APP_SLUG}[bot]"
+          git config user.email "${USER_ID}+${APP_SLUG}[bot]@users.noreply.github.com"
+          git add --force resources/dist
+          git commit -m "Build assets for $TAG"
+
+      - name: Tag and push the build commit
+        run: |
+          git tag "$TAG"
+          git push origin "$TAG"
 
       - name: Get Changelog
         id: changelog
-        uses: statamic/changelog-action@5d112d0d790cdeeb5adca3e584e37edc474ab51b # v1
+        uses: statamic/changelog-action@5d112d0d790cdeeb5adca3e584e37edc474ab51b # v1.0.2
         with:
-          version: ${{ github.ref }}
+          version: ${{ env.TAG }}
 
       - name: Create release
         env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          RELEASE_VERSION: ${{ steps.changelog.outputs.version }}
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
           RELEASE_NOTES: ${{ steps.changelog.outputs.text }}
+          IS_DEFAULT_BRANCH: ${{ github.ref_name == github.event.repository.default_branch }}
         run: |
-          PRERELEASE=""
-          if [[ "$RELEASE_VERSION" == *-beta* ]]; then PRERELEASE="--prerelease"; fi
-          gh release create "$RELEASE_VERSION" \
-            --title "$RELEASE_VERSION" \
+          latest="$IS_DEFAULT_BRANCH"
+          prerelease=false
+          case "$TAG" in
+            *-*) prerelease=true; latest=false ;;
+          esac
+          gh release create "$TAG" \
+            --title "$TAG" \
             --notes "$RELEASE_NOTES" \
-            $PRERELEASE \
-            ./resources/dist.tar.gz
+            --latest="$latest" \
+            --prerelease="$prerelease"
diff --git a/composer.json b/composer.json
index 296ad20a..8bda267c 100644
--- a/composer.json
+++ b/composer.json
@@ -11,12 +11,6 @@
         }
     },
     "extra": {
-        "download-dist": [
-            {
-                "url": "https://github.com/statamic/seo-pro/releases/download/{$version}/dist.tar.gz",
-                "path": "resources/dist"
-            }
-        ],
         "statamic": {
             "name": "SEO Pro",
             "description": "An all-in-one site reporting, metadata mastering, OG managing, Twitter card making, sitemap generating addon."
@@ -29,7 +23,6 @@
     },
     "require": {
         "statamic/cms": "^6.25",
-        "pixelfear/composer-dist-plugin": "^0.1.6",
         "spatie/simple-excel": "^3.9"
     },
     "require-dev": {
@@ -38,11 +31,6 @@
         "laravel/pint": "1.29.1",
         "spatie/laravel-ray": "^1.43.6"
     },
-    "config": {
-        "allow-plugins": {
-            "pixelfear/composer-dist-plugin": true
-        }
-    },
     "minimum-stability": "dev",
     "prefer-stable": true
 }

From a9a6aea26690dfe4c387a0d85f7b2c4e8c5e1066 Mon Sep 17 00:00:00 2001
From: Duncan McClean <duncan@duncanmcclean.com>
Date: Thu, 3 Sep 2026 11:33:40 +0100
Subject: [PATCH 12/38] Add configurable cap on tracked 404 errors (#654)

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
---
 DOCUMENTATION.md                              |  12 ++
 config/seo-pro.php                            |   1 +
 src/Commands/PurgeErrorsCommand.php           |  45 ++++++-
 .../Eloquent/PurgeErrorsCommandTest.php       |  50 ++++++++
 tests/Redirects/PurgeErrorsCommandTest.php    | 121 ++++++++++++++++++
 5 files changed, 228 insertions(+), 1 deletion(-)
 create mode 100644 tests/Redirects/Eloquent/PurgeErrorsCommandTest.php

diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md
index 5b86597d..ece304b9 100644
--- a/DOCUMENTATION.md
+++ b/DOCUMENTATION.md
@@ -317,6 +317,18 @@ You may customize the purge threshold in the config:
 ],
 ```
 
+On a public site, bots probing for unique URLs can create an unbounded number of errors between purges. To bound the total, set `max_errors` to a cap. When the purge runs and the number of errors exceeds the cap, the excess is purged: errors that have never been hit go first, then those with the fewest hits, then those hit least recently. Frequently-hit 404s, the best redirect candidates, survive longest. The default of `0` disables the cap.
+
+```php
+// config/statamic/seo-pro.php
+
+'redirects' => [
+    'errors' => [
+        'max_errors' => 1000,
+    ],
+],
+```
+
 You may also run the command manually:
 
 ```
diff --git a/config/seo-pro.php b/config/seo-pro.php
index fde9b7f2..6415c6ad 100644
--- a/config/seo-pro.php
+++ b/config/seo-pro.php
@@ -80,6 +80,7 @@
             'driver' => 'file',
             'directory' => storage_path('statamic/seopro/errors'),
             'purge_after_days' => 30,
+            'max_errors' => 0,
         ],
     ],
 
diff --git a/src/Commands/PurgeErrorsCommand.php b/src/Commands/PurgeErrorsCommand.php
index ab4a9e51..67e95459 100755
--- a/src/Commands/PurgeErrorsCommand.php
+++ b/src/Commands/PurgeErrorsCommand.php
@@ -24,7 +24,7 @@ class PurgeErrorsCommand extends Command
      *
      * @var string
      */
-    protected $description = 'Purges 404 errors older than the configured threshold.';
+    protected $description = 'Purges 404 errors older than the configured threshold, then purges any exceeding the configured cap.';
 
     /**
      * Execute the console command.
@@ -32,6 +32,13 @@ class PurgeErrorsCommand extends Command
      * @return mixed
      */
     public function handle()
+    {
+        $this
+            ->purgeErrorsOlderThan()
+            ->purgeErrorsExceeding();
+    }
+
+    private function purgeErrorsOlderThan(): self
     {
         $threshold = config('statamic.seo-pro.redirects.errors.purge_after_days', 30);
 
@@ -46,5 +53,41 @@ public function handle()
         );
 
         $this->components->success("Purged errors older than $threshold days.");
+
+        return $this;
+    }
+
+    private function purgeErrorsExceeding(): self
+    {
+        $maxErrors = config('statamic.seo-pro.redirects.errors.max_errors', 0);
+
+        if (! $maxErrors) {
+            return $this;
+        }
+
+        spin(
+            callback: function () use ($maxErrors): void {
+                $errors = Error::query()->get();
+                $excess = $errors->count() - $maxErrors;
+
+                if ($excess <= 0) {
+                    return;
+                }
+
+                $errors
+                    ->sortBy([
+                        fn ($a, $b) => (bool) $a->lastHitAt() <=> (bool) $b->lastHitAt(),
+                        fn ($a, $b) => $a->hits() <=> $b->hits(),
+                        fn ($a, $b) => $a->lastHitAt() <=> $b->lastHitAt(),
+                    ])
+                    ->take($excess)
+                    ->each->delete();
+            },
+            message: 'Purging excess errors...',
+        );
+
+        $this->components->success("Purged errors exceeding the cap of $maxErrors.");
+
+        return $this;
     }
 }
diff --git a/tests/Redirects/Eloquent/PurgeErrorsCommandTest.php b/tests/Redirects/Eloquent/PurgeErrorsCommandTest.php
new file mode 100644
index 00000000..8121954a
--- /dev/null
+++ b/tests/Redirects/Eloquent/PurgeErrorsCommandTest.php
@@ -0,0 +1,50 @@
+<?php
+
+namespace Tests\Redirects\Eloquent;
+
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Carbon;
+use PHPUnit\Framework\Attributes\Test;
+use Statamic\SeoPro\Redirects\Eloquent\ErrorModel;
+use Tests\TestCase;
+
+class PurgeErrorsCommandTest extends TestCase
+{
+    use RefreshDatabase;
+
+    protected function getEnvironmentSetUp($app)
+    {
+        parent::getEnvironmentSetUp($app);
+
+        $app['config']->set('statamic.seo-pro.redirects.errors.driver', 'database');
+    }
+
+    protected function defineDatabaseMigrations()
+    {
+        $this->loadMigrationsFrom(__DIR__.'/../../../src/Commands/stubs');
+    }
+
+    #[Test]
+    public function it_purges_the_least_valuable_errors_when_max_errors_is_exceeded()
+    {
+        Carbon::setTestNow('2026-04-21 12:00:00');
+
+        config(['statamic.seo-pro.redirects.errors.max_errors' => 2]);
+
+        ErrorModel::create(['site' => 'default', 'url' => '/never-hit', 'hits' => 6, 'last_hit_at' => null, 'data' => []]);
+        ErrorModel::create(['site' => 'default', 'url' => '/rarely-hit', 'hits' => 1, 'last_hit_at' => '2026-04-20 12:00:00', 'data' => []]);
+        ErrorModel::create(['site' => 'default', 'url' => '/stale-popular', 'hits' => 5, 'last_hit_at' => '2026-04-01 12:00:00', 'data' => []]);
+        ErrorModel::create(['site' => 'default', 'url' => '/fresh-popular', 'hits' => 5, 'last_hit_at' => '2026-04-20 12:00:00', 'data' => []]);
+        ErrorModel::create(['site' => 'default', 'url' => '/most-popular', 'hits' => 9, 'last_hit_at' => '2026-04-10 12:00:00', 'data' => []]);
+
+        $this
+            ->artisan('statamic:seo-pro:purge-errors')
+            ->assertSuccessful();
+
+        $this->assertDatabaseMissing('seo_pro_errors', ['url' => '/never-hit']);
+        $this->assertDatabaseMissing('seo_pro_errors', ['url' => '/rarely-hit']);
+        $this->assertDatabaseMissing('seo_pro_errors', ['url' => '/stale-popular']);
+        $this->assertDatabaseHas('seo_pro_errors', ['url' => '/fresh-popular']);
+        $this->assertDatabaseHas('seo_pro_errors', ['url' => '/most-popular']);
+    }
+}
diff --git a/tests/Redirects/PurgeErrorsCommandTest.php b/tests/Redirects/PurgeErrorsCommandTest.php
index 704e65d8..5655f0e4 100644
--- a/tests/Redirects/PurgeErrorsCommandTest.php
+++ b/tests/Redirects/PurgeErrorsCommandTest.php
@@ -3,6 +3,7 @@
 namespace Tests\Redirects;
 
 use Illuminate\Support\Carbon;
+use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\Test;
 use Statamic\SeoPro\Facades;
 use Statamic\Testing\Concerns\PreventsSavingStacheItemsToDisk;
@@ -94,4 +95,124 @@ public function it_does_not_purge_errors_within_threshold()
         $this->assertNotNull(Facades\Error::find('recent-one'));
         $this->assertNotNull(Facades\Error::find('recent-two'));
     }
+
+    #[Test]
+    public function it_purges_the_least_valuable_errors_when_max_errors_is_exceeded()
+    {
+        Carbon::setTestNow('2026-04-21 12:00:00');
+
+        config(['statamic.seo-pro.redirects.errors.max_errors' => 2]);
+
+        Facades\Error::make()
+            ->id('never-hit')
+            ->url('/never-hit')
+            ->hits(6)
+            ->save();
+
+        $this->createErrorsWithVariedHits();
+
+        $this
+            ->artisan('statamic:seo-pro:purge-errors')
+            ->assertSuccessful();
+
+        $this->assertNull(Facades\Error::find('never-hit'));
+        $this->assertNull(Facades\Error::find('rarely-hit'));
+        $this->assertNull(Facades\Error::find('stale-popular'));
+        $this->assertNotNull(Facades\Error::find('fresh-popular'));
+        $this->assertNotNull(Facades\Error::find('most-popular'));
+    }
+
+    #[Test]
+    public function it_applies_the_age_threshold_before_the_cap()
+    {
+        Carbon::setTestNow('2026-04-21 12:00:00');
+
+        config(['statamic.seo-pro.redirects.errors.max_errors' => 2]);
+
+        Facades\Error::make()
+            ->id('old-error')
+            ->url('/old-page')
+            ->hits(50)
+            ->lastHitAt('2026-03-01 12:00:00')
+            ->save();
+
+        Facades\Error::make()
+            ->id('recent-one')
+            ->url('/page-one')
+            ->hits(1)
+            ->lastHitAt('2026-04-15 12:00:00')
+            ->save();
+
+        Facades\Error::make()
+            ->id('recent-two')
+            ->url('/page-two')
+            ->hits(3)
+            ->lastHitAt('2026-04-20 12:00:00')
+            ->save();
+
+        $this
+            ->artisan('statamic:seo-pro:purge-errors')
+            ->assertSuccessful();
+
+        $this->assertNull(Facades\Error::find('old-error'));
+        $this->assertNotNull(Facades\Error::find('recent-one'));
+        $this->assertNotNull(Facades\Error::find('recent-two'));
+    }
+
+    #[Test]
+    #[DataProvider('unexceededMaxErrorsProvider')]
+    public function it_does_not_purge_errors_unless_max_errors_is_exceeded($maxErrors)
+    {
+        Carbon::setTestNow('2026-04-21 12:00:00');
+
+        config(['statamic.seo-pro.redirects.errors.max_errors' => $maxErrors]);
+
+        $this->createErrorsWithVariedHits();
+
+        $this
+            ->artisan('statamic:seo-pro:purge-errors')
+            ->assertSuccessful();
+
+        $this->assertCount(4, Facades\Error::all());
+    }
+
+    public static function unexceededMaxErrorsProvider(): array
+    {
+        return [
+            'within cap' => [4],
+            'disabled' => [0],
+            'absent' => [null],
+        ];
+    }
+
+    private function createErrorsWithVariedHits(): void
+    {
+        Facades\Error::make()
+            ->id('rarely-hit')
+            ->url('/rarely-hit')
+            ->hits(1)
+            ->lastHitAt('2026-04-20 12:00:00')
+            ->save();
+
+        Facades\Error::make()
+            ->id('stale-popular')
+            ->url('/stale-popular')
+            ->hits(5)
+            ->lastHitAt('2026-04-01 12:00:00')
+            ->save();
+
+        Facades\Error::make()
+            ->id('fresh-popular')
+            ->url('/fresh-popular')
+            ->hits(5)
+            ->lastHitAt('2026-04-20 12:00:00')
+            ->save();
+
+        Facades\Error::make()
+            ->id('most-popular')
+            ->url('/most-popular')
+            ->hits(9)
+            ->lastHitAt('2026-04-10 12:00:00')
+            ->save();
+    }
 }

From 3a3cf4d6b8bd2ad331f2fe6568174a3a5b40bfb3 Mon Sep 17 00:00:00 2001
From: Duncan McClean <duncan@duncanmcclean.com>
Date: Thu, 3 Sep 2026 11:40:15 +0100
Subject: [PATCH 13/38] Fix errors with no `last_hit_at` never being purged
 (#655)

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
---
 src/Commands/PurgeErrorsCommand.php           |  1 +
 .../Eloquent/PurgeErrorsCommandTest.php       | 19 +++++++++++++
 tests/Redirects/PurgeErrorsCommandTest.php    | 28 +++++++++++++++++++
 3 files changed, 48 insertions(+)

diff --git a/src/Commands/PurgeErrorsCommand.php b/src/Commands/PurgeErrorsCommand.php
index 67e95459..85c400f2 100755
--- a/src/Commands/PurgeErrorsCommand.php
+++ b/src/Commands/PurgeErrorsCommand.php
@@ -46,6 +46,7 @@ private function purgeErrorsOlderThan(): self
             callback: function () use ($threshold): void {
                 Error::query()
                     ->where('last_hit_at', '<', now()->subDays($threshold))
+                    ->orWhereNull('last_hit_at')
                     ->get()
                     ->each->delete();
             },
diff --git a/tests/Redirects/Eloquent/PurgeErrorsCommandTest.php b/tests/Redirects/Eloquent/PurgeErrorsCommandTest.php
index 8121954a..e820c99f 100644
--- a/tests/Redirects/Eloquent/PurgeErrorsCommandTest.php
+++ b/tests/Redirects/Eloquent/PurgeErrorsCommandTest.php
@@ -24,6 +24,25 @@ protected function defineDatabaseMigrations()
         $this->loadMigrationsFrom(__DIR__.'/../../../src/Commands/stubs');
     }
 
+    /**
+     * @see https://github.com/statamic/seo-pro/issues/647
+     */
+    #[Test]
+    public function it_purges_errors_without_a_last_hit_at()
+    {
+        Carbon::setTestNow('2026-04-21 12:00:00');
+
+        ErrorModel::create(['site' => 'default', 'url' => '/never-hit', 'hits' => 1, 'last_hit_at' => null, 'data' => []]);
+        ErrorModel::create(['site' => 'default', 'url' => '/recent', 'hits' => 1, 'last_hit_at' => '2026-04-20 12:00:00', 'data' => []]);
+
+        $this
+            ->artisan('statamic:seo-pro:purge-errors')
+            ->assertSuccessful();
+
+        $this->assertDatabaseMissing('seo_pro_errors', ['url' => '/never-hit']);
+        $this->assertDatabaseHas('seo_pro_errors', ['url' => '/recent']);
+    }
+
     #[Test]
     public function it_purges_the_least_valuable_errors_when_max_errors_is_exceeded()
     {
diff --git a/tests/Redirects/PurgeErrorsCommandTest.php b/tests/Redirects/PurgeErrorsCommandTest.php
index 5655f0e4..7526bf6c 100644
--- a/tests/Redirects/PurgeErrorsCommandTest.php
+++ b/tests/Redirects/PurgeErrorsCommandTest.php
@@ -96,6 +96,34 @@ public function it_does_not_purge_errors_within_threshold()
         $this->assertNotNull(Facades\Error::find('recent-two'));
     }
 
+    /**
+     * @see https://github.com/statamic/seo-pro/issues/647
+     */
+    #[Test]
+    public function it_purges_errors_without_a_last_hit_at()
+    {
+        Carbon::setTestNow('2026-04-21 12:00:00');
+
+        Facades\Error::make()
+            ->id('never-hit')
+            ->url('/never-hit-page')
+            ->save();
+
+        Facades\Error::make()
+            ->id('recent')
+            ->url('/recent-page')
+            ->hits(1)
+            ->lastHitAt('2026-04-20 12:00:00')
+            ->save();
+
+        $this
+            ->artisan('statamic:seo-pro:purge-errors')
+            ->assertSuccessful();
+
+        $this->assertNull(Facades\Error::find('never-hit'));
+        $this->assertNotNull(Facades\Error::find('recent'));
+    }
+
     #[Test]
     public function it_purges_the_least_valuable_errors_when_max_errors_is_exceeded()
     {

From d38bac3d7f400df790127580f9e0639b2318d55b Mon Sep 17 00:00:00 2001
From: Duncan McClean <duncan@duncanmcclean.com>
Date: Thu, 3 Sep 2026 12:20:21 +0100
Subject: [PATCH 14/38] Add delete action for tracked 404 errors (#656)

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
---
 lang/en/messages.php                          |   1 +
 resources/js/pages/errors/Index.vue           |   8 +-
 routes/cp.php                                 |   4 +-
 src/Actions/DeleteError.php                   |  14 +++
 .../CP/Errors/ErrorActionController.php       |  15 +++
 .../CP/{ => Errors}/ErrorController.php       |   4 +-
 src/Http/Resources/Redirects/Errors.php       |   4 +-
 src/Policies/ErrorPolicy.php                  |   6 ++
 src/ServiceProvider.php                       |   1 +
 tests/Redirects/DeleteErrorTest.php           | 101 ++++++++++++++++++
 10 files changed, 151 insertions(+), 7 deletions(-)
 create mode 100644 src/Actions/DeleteError.php
 create mode 100644 src/Http/Controllers/CP/Errors/ErrorActionController.php
 rename src/Http/Controllers/CP/{ => Errors}/ErrorController.php (95%)
 create mode 100644 tests/Redirects/DeleteErrorTest.php

diff --git a/lang/en/messages.php b/lang/en/messages.php
index 93d397b2..9e80da34 100644
--- a/lang/en/messages.php
+++ b/lang/en/messages.php
@@ -12,6 +12,7 @@
     'edit_redirects' => 'Edit Redirects',
     'create_redirects' => 'Create Redirects',
     'delete_redirects' => 'Delete Redirects',
+    'delete_errors' => 'Delete Errors',
     'redirect_source' => 'URL to redirect from. Use `*` as a wildcard, like `/blog/2026/*`.',
     'redirect_destination' => 'URL to redirect to. Use `$1`, `$2`, etc. for wildcard matches.',
     'redirect_response_code' => 'HTTP response code for this redirect.',
diff --git a/resources/js/pages/errors/Index.vue b/resources/js/pages/errors/Index.vue
index 4d59b07e..cc5f59db 100644
--- a/resources/js/pages/errors/Index.vue
+++ b/resources/js/pages/errors/Index.vue
@@ -1,6 +1,6 @@
 <script setup>
 import { Head, Link } from '@statamic/cms/inertia';
-import { Header, Button, Listing, DocsCallout } from '@statamic/cms/ui';
+import { Header, Button, Listing, DropdownItem, DocsCallout } from '@statamic/cms/ui';
 import { ref } from 'vue';
 
 defineProps({
@@ -28,6 +28,7 @@ function requestComplete({ items: newItems, parameters }) {
 	<Listing
 		ref="listing"
 		:url="cp_url(`seo-pro/errors`)"
+		:action-url="cp_url(`seo-pro/errors/actions`)"
 		:columns
 		:allow-presets="false"
 		:allow-customizing-columns="false"
@@ -41,11 +42,14 @@ function requestComplete({ items: newItems, parameters }) {
 		<template #cell-url="{ row: error }">
 			<a class="title-index-field" :href="error.url" target="_blank" rel="noopener noreferrer" v-text="error.url" />
 		</template>
-		<template #cell-actions="{ row: error }">
+		<template #cell-create_redirect="{ row: error }">
 			<div class="flex justify-end">
 				<Button size="xs" icon="moved" :href="error.create_redirect_url" :text="__('seo-pro::messages.create_redirect')" />
 			</div>
 		</template>
+		<template #prepended-row-actions="{ row: error }">
+			<DropdownItem :text="__('seo-pro::messages.create_redirect')" :href="error.create_redirect_url" icon="moved" />
+		</template>
 	</Listing>
 
 	<DocsCallout :topic="__('seo-pro::messages.errors')" url="https://statamic.com/addons/statamic/seo-pro/docs" />
diff --git a/routes/cp.php b/routes/cp.php
index c1de432c..98b756f5 100644
--- a/routes/cp.php
+++ b/routes/cp.php
@@ -23,7 +23,9 @@
     Route::get('section-defaults/taxonomies/{seo_pro_taxonomy}/edit', [Controllers\CP\TaxonomyDefaultsController::class, 'edit'])->name('section-defaults.taxonomies.edit');
     Route::patch('section-defaults/taxonomies/{seo_pro_taxonomy}', [Controllers\CP\TaxonomyDefaultsController::class, 'update'])->name('section-defaults.taxonomies.update');
 
-    Route::resource('errors', Controllers\CP\ErrorController::class)->only('index');
+    Route::post('errors/actions', [Controllers\CP\Errors\ErrorActionController::class, 'run'])->name('errors.actions.run');
+    Route::post('errors/actions/list', [Controllers\CP\Errors\ErrorActionController::class, 'bulkActions'])->name('errors.actions.bulk');
+    Route::resource('errors', Controllers\CP\Errors\ErrorController::class)->only('index');
 
     Route::get('redirects/export', Controllers\CP\Redirects\ExportRedirectsController::class)->name('redirects.export');
     Route::post('redirects/import', Controllers\CP\Redirects\ImportRedirectsController::class)->name('redirects.import');
diff --git a/src/Actions/DeleteError.php b/src/Actions/DeleteError.php
new file mode 100644
index 00000000..fe15363a
--- /dev/null
+++ b/src/Actions/DeleteError.php
@@ -0,0 +1,14 @@
+<?php
+
+namespace Statamic\SeoPro\Actions;
+
+use Statamic\Actions\Delete;
+use Statamic\SeoPro\Redirects\Error;
+
+class DeleteError extends Delete
+{
+    public function visibleTo($item): bool
+    {
+        return $item instanceof Error;
+    }
+}
diff --git a/src/Http/Controllers/CP/Errors/ErrorActionController.php b/src/Http/Controllers/CP/Errors/ErrorActionController.php
new file mode 100644
index 00000000..3f78b217
--- /dev/null
+++ b/src/Http/Controllers/CP/Errors/ErrorActionController.php
@@ -0,0 +1,15 @@
+<?php
+
+namespace Statamic\SeoPro\Http\Controllers\CP\Errors;
+
+use Illuminate\Support\Collection;
+use Statamic\Http\Controllers\CP\ActionController;
+use Statamic\SeoPro\Facades;
+
+class ErrorActionController extends ActionController
+{
+    protected function getSelectedItems($items, $context): Collection
+    {
+        return $items->map(fn ($id) => Facades\Error::find($id));
+    }
+}
diff --git a/src/Http/Controllers/CP/ErrorController.php b/src/Http/Controllers/CP/Errors/ErrorController.php
similarity index 95%
rename from src/Http/Controllers/CP/ErrorController.php
rename to src/Http/Controllers/CP/Errors/ErrorController.php
index 89468b8f..8a2b4c92 100644
--- a/src/Http/Controllers/CP/ErrorController.php
+++ b/src/Http/Controllers/CP/Errors/ErrorController.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace Statamic\SeoPro\Http\Controllers\CP;
+namespace Statamic\SeoPro\Http\Controllers\CP\Errors;
 
 use Inertia\Inertia;
 use Statamic\CP\Column;
@@ -53,7 +53,7 @@ public function index(FilteredRequest $request)
 
         $columns = $blueprint
             ->columns()
-            ->put('actions', Column::make('actions')
+            ->put('create_redirect', Column::make('create_redirect')
                 ->label('')
                 ->listable(true)
                 ->visible(true)
diff --git a/src/Http/Resources/Redirects/Errors.php b/src/Http/Resources/Redirects/Errors.php
index f9244870..9f781502 100644
--- a/src/Http/Resources/Redirects/Errors.php
+++ b/src/Http/Resources/Redirects/Errors.php
@@ -33,7 +33,7 @@ private function setColumns()
     {
         $columns = $this->blueprint->columns();
 
-        $actions = Column::make('actions')
+        $createRedirect = Column::make('create_redirect')
             ->label('')
             ->listable(true)
             ->visible(true)
@@ -41,7 +41,7 @@ private function setColumns()
             ->defaultOrder($columns->count() + 1)
             ->sortable(false);
 
-        $columns->put('actions', $actions);
+        $columns->put('create_redirect', $createRedirect);
 
         if ($key = $this->columnPreferenceKey) {
             $columns->setPreferred($key);
diff --git a/src/Policies/ErrorPolicy.php b/src/Policies/ErrorPolicy.php
index 64ba915c..632b3eb9 100644
--- a/src/Policies/ErrorPolicy.php
+++ b/src/Policies/ErrorPolicy.php
@@ -3,6 +3,7 @@
 namespace Statamic\SeoPro\Policies;
 
 use Statamic\Facades\User;
+use Statamic\SeoPro\Redirects\Error;
 
 class ErrorPolicy
 {
@@ -19,4 +20,9 @@ public function index($user): bool
     {
         return User::fromUser($user)->hasPermission('view seo redirects');
     }
+
+    public function delete($user, Error $error): bool
+    {
+        return User::fromUser($user)->hasPermission('delete seo errors');
+    }
 }
diff --git a/src/ServiceProvider.php b/src/ServiceProvider.php
index 7127f459..0223611f 100644
--- a/src/ServiceProvider.php
+++ b/src/ServiceProvider.php
@@ -133,6 +133,7 @@ protected function bootAddonPermissions()
                                 Permission::make('create seo redirects')->label(__('seo-pro::messages.create_redirects')),
                                 Permission::make('delete seo redirects')->label(__('seo-pro::messages.delete_redirects')),
                             ]),
+                        Permission::make('delete seo errors')->label(__('seo-pro::messages.delete_errors')),
                     ]);
             });
             Permission::register('view seo reports', function ($permission) {
diff --git a/tests/Redirects/DeleteErrorTest.php b/tests/Redirects/DeleteErrorTest.php
new file mode 100644
index 00000000..cde134f0
--- /dev/null
+++ b/tests/Redirects/DeleteErrorTest.php
@@ -0,0 +1,101 @@
+<?php
+
+namespace Tests\Redirects;
+
+use PHPUnit\Framework\Attributes\Test;
+use Statamic\Facades\Role;
+use Statamic\Facades\User;
+use Statamic\SeoPro\Facades;
+use Statamic\Testing\Concerns\PreventsSavingStacheItemsToDisk;
+use Tests\TestCase;
+
+class DeleteErrorTest extends TestCase
+{
+    use PreventsSavingStacheItemsToDisk;
+
+    #[Test]
+    public function can_delete_selected_errors()
+    {
+        $this->createError('abc', '/broken-link');
+        $this->createError('def', '/another-broken-link');
+        $this->createError('ghi', '/untouched-link');
+
+        $this
+            ->actingAs(User::make()->makeSuper()->save())
+            ->postJson(cp_route('seo-pro.errors.actions.run'), [
+                'action' => 'delete_error',
+                'selections' => ['abc', 'def'],
+                'values' => [],
+            ])
+            ->assertOk()
+            ->assertJson(['success' => true]);
+
+        $this->assertNull(Facades\Error::find('abc'));
+        $this->assertNull(Facades\Error::find('def'));
+        $this->assertNotNull(Facades\Error::find('ghi'));
+    }
+
+    #[Test]
+    public function delete_action_is_listed_for_selected_errors()
+    {
+        $this->createError('abc', '/broken-link');
+        $this->createError('def', '/another-broken-link');
+
+        $this
+            ->actingAs(User::make()->makeSuper()->save())
+            ->postJson(cp_route('seo-pro.errors.actions.bulk'), [
+                'selections' => ['abc', 'def'],
+            ])
+            ->assertOk()
+            ->assertJsonCount(1)
+            ->assertJsonPath('0.handle', 'delete_error');
+    }
+
+    #[Test]
+    public function cant_delete_selected_errors_without_permission()
+    {
+        $this->createError('abc', '/broken-link');
+        $this->createError('def', '/another-broken-link');
+
+        Role::make('test')->addPermission('access cp')->addPermission('view seo redirects')->save();
+
+        $this
+            ->actingAs(User::make()->assignRole('test')->save())
+            ->postJson(cp_route('seo-pro.errors.actions.run'), [
+                'action' => 'delete_error',
+                'selections' => ['abc', 'def'],
+                'values' => [],
+            ])
+            ->assertForbidden();
+
+        $this->assertNotNull(Facades\Error::find('abc'));
+        $this->assertNotNull(Facades\Error::find('def'));
+    }
+
+    #[Test]
+    public function delete_action_is_not_listed_without_permission()
+    {
+        $this->createError('abc', '/broken-link');
+        $this->createError('def', '/another-broken-link');
+
+        Role::make('test')->addPermission('access cp')->addPermission('view seo redirects')->save();
+
+        $this
+            ->actingAs(User::make()->assignRole('test')->save())
+            ->postJson(cp_route('seo-pro.errors.actions.bulk'), [
+                'selections' => ['abc', 'def'],
+            ])
+            ->assertOk()
+            ->assertJsonCount(0);
+    }
+
+    private function createError(string $id, string $url): void
+    {
+        Facades\Error::make()
+            ->id($id)
+            ->url($url)
+            ->hits(1)
+            ->lastHitAt('2026-04-21 12:00:00')
+            ->save();
+    }
+}

From 49364e15efd5a7bc9d2dbecdc34c55bb1fb78ea7 Mon Sep 17 00:00:00 2001
From: Duncan McClean <duncan@duncanmcclean.com>
Date: Thu, 3 Sep 2026 12:30:06 +0100
Subject: [PATCH 15/38] Add delete action for redirects (#657)

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
---
 resources/js/pages/redirects/Index.vue        | 15 +--
 routes/cp.php                                 |  4 +-
 src/Actions/DeleteRedirect.php                | 14 +++
 .../CP/Redirects/RedirectActionController.php | 15 +++
 .../CP/Redirects/RedirectController.php       |  7 --
 .../Resources/Redirects/ListedRedirect.php    |  2 -
 src/Redirects/Redirect.php                    |  5 -
 tests/Redirects/DeleteRedirectTest.php        | 91 ++++++++++++++-----
 8 files changed, 101 insertions(+), 52 deletions(-)
 create mode 100644 src/Actions/DeleteRedirect.php
 create mode 100644 src/Http/Controllers/CP/Redirects/RedirectActionController.php

diff --git a/resources/js/pages/redirects/Index.vue b/resources/js/pages/redirects/Index.vue
index 1c07605e..59cdfc23 100644
--- a/resources/js/pages/redirects/Index.vue
+++ b/resources/js/pages/redirects/Index.vue
@@ -45,6 +45,7 @@ function requestComplete({ items: newItems, parameters }) {
 	<Listing
 		ref="listing"
 		:url="cp_url(`seo-pro/redirects`)"
+		:action-url="cp_url(`seo-pro/redirects/actions`)"
 		:columns
 		:allow-presets="false"
 		sort-column="source"
@@ -63,26 +64,12 @@ function requestComplete({ items: newItems, parameters }) {
 				<StatusIndicator v-if="!isColumnVisible('status')" :status="redirect.status" />
 				<span v-text="redirect.source" />
 			</span>
-
-			<resource-deleter
-				v-if="redirect.deletable"
-				:ref="`deleter_${redirect.id}`"
-				:resource="redirect"
-				@deleted="listing.refresh()"
-			/>
 		</template>
 		<template #cell-status="{ row: redirect }">
 			<StatusIndicator :status="redirect.status" show-label :show-dot="false" />
 		</template>
 		<template #prepended-row-actions="{ row: redirect }">
 			<DropdownItem v-if="redirect.editable" :text="__('Edit')" :href="redirect.edit_url" icon="edit" />
-			<DropdownItem
-				v-if="redirect.deletable"
-				:text="__('Delete')"
-				icon="trash"
-				variant="destructive"
-				@click="$refs[`deleter_${redirect.id}`].confirm()"
-			/>
 		</template>
 	</Listing>
 
diff --git a/routes/cp.php b/routes/cp.php
index 98b756f5..26f67c04 100644
--- a/routes/cp.php
+++ b/routes/cp.php
@@ -29,7 +29,9 @@
 
     Route::get('redirects/export', Controllers\CP\Redirects\ExportRedirectsController::class)->name('redirects.export');
     Route::post('redirects/import', Controllers\CP\Redirects\ImportRedirectsController::class)->name('redirects.import');
-    Route::resource('redirects', Controllers\CP\Redirects\RedirectController::class)->except('show');
+    Route::post('redirects/actions', [Controllers\CP\Redirects\RedirectActionController::class, 'run'])->name('redirects.actions.run');
+    Route::post('redirects/actions/list', [Controllers\CP\Redirects\RedirectActionController::class, 'bulkActions'])->name('redirects.actions.bulk');
+    Route::resource('redirects', Controllers\CP\Redirects\RedirectController::class)->except('show', 'destroy');
 
     Route::post('preview', Controllers\CP\PreviewController::class)->name('preview');
 });
diff --git a/src/Actions/DeleteRedirect.php b/src/Actions/DeleteRedirect.php
new file mode 100644
index 00000000..4d5c789e
--- /dev/null
+++ b/src/Actions/DeleteRedirect.php
@@ -0,0 +1,14 @@
+<?php
+
+namespace Statamic\SeoPro\Actions;
+
+use Statamic\Actions\Delete;
+use Statamic\SeoPro\Redirects\Redirect;
+
+class DeleteRedirect extends Delete
+{
+    public function visibleTo($item): bool
+    {
+        return $item instanceof Redirect;
+    }
+}
diff --git a/src/Http/Controllers/CP/Redirects/RedirectActionController.php b/src/Http/Controllers/CP/Redirects/RedirectActionController.php
new file mode 100644
index 00000000..ac26db99
--- /dev/null
+++ b/src/Http/Controllers/CP/Redirects/RedirectActionController.php
@@ -0,0 +1,15 @@
+<?php
+
+namespace Statamic\SeoPro\Http\Controllers\CP\Redirects;
+
+use Illuminate\Support\Collection;
+use Statamic\Http\Controllers\CP\ActionController;
+use Statamic\SeoPro\Facades;
+
+class RedirectActionController extends ActionController
+{
+    protected function getSelectedItems($items, $context): Collection
+    {
+        return $items->map(fn ($id) => Facades\Redirect::find($id));
+    }
+}
diff --git a/src/Http/Controllers/CP/Redirects/RedirectController.php b/src/Http/Controllers/CP/Redirects/RedirectController.php
index b2b23ec7..6168ee2b 100644
--- a/src/Http/Controllers/CP/Redirects/RedirectController.php
+++ b/src/Http/Controllers/CP/Redirects/RedirectController.php
@@ -193,11 +193,4 @@ public function update(Request $request, Redirect $redirect)
 
         $redirect->save();
     }
-
-    public function destroy(Request $request, Redirect $redirect)
-    {
-        $this->authorize('delete', $redirect);
-
-        $redirect->delete();
-    }
 }
diff --git a/src/Http/Resources/Redirects/ListedRedirect.php b/src/Http/Resources/Redirects/ListedRedirect.php
index b0287cfc..55d46ff6 100644
--- a/src/Http/Resources/Redirects/ListedRedirect.php
+++ b/src/Http/Resources/Redirects/ListedRedirect.php
@@ -42,9 +42,7 @@ public function toArray($request)
             ])),
 
             'edit_url' => $redirect->editUrl(),
-            'delete_url' => $redirect->deleteUrl(),
             'editable' => User::current()->can('edit', $redirect),
-            'deletable' => User::current()->can('delete', $redirect),
         ];
     }
 
diff --git a/src/Redirects/Redirect.php b/src/Redirects/Redirect.php
index 42af151f..a2f34423 100644
--- a/src/Redirects/Redirect.php
+++ b/src/Redirects/Redirect.php
@@ -177,11 +177,6 @@ public function updateUrl(): string
         return cp_route('seo-pro.redirects.update', $this->id());
     }
 
-    public function deleteUrl(): string
-    {
-        return cp_route('seo-pro.redirects.destroy', $this->id());
-    }
-
     public function getQueryableValue(string $field)
     {
         if (in_array($method = Str::camel($field), $this->queryableMethods())) {
diff --git a/tests/Redirects/DeleteRedirectTest.php b/tests/Redirects/DeleteRedirectTest.php
index 72061e41..263148e4 100644
--- a/tests/Redirects/DeleteRedirectTest.php
+++ b/tests/Redirects/DeleteRedirectTest.php
@@ -14,44 +14,89 @@ class DeleteRedirectTest extends TestCase
     use PreventsSavingStacheItemsToDisk;
 
     #[Test]
-    public function can_delete_redirect()
+    public function can_delete_selected_redirects()
     {
-        Facades\Redirect::make()
-            ->id('abc')
-            ->source('https://cool-runnings.com/old-url')
-            ->destination('https://cool-runnings.com/new-url')
-            ->responseCode(302)
-            ->enabled(true)
-            ->save();
-
-        $this->assertNotNull(Facades\Redirect::find('abc'));
+        $this->createRedirect('abc', '/old-url');
+        $this->createRedirect('def', '/another-old-url');
+        $this->createRedirect('ghi', '/untouched-url');
 
         $this
             ->actingAs(User::make()->makeSuper()->save())
-            ->delete(cp_route('seo-pro.redirects.destroy', 'abc'))
-            ->assertOk();
+            ->postJson(cp_route('seo-pro.redirects.actions.run'), [
+                'action' => 'delete_redirect',
+                'selections' => ['abc', 'def'],
+                'values' => [],
+            ])
+            ->assertOk()
+            ->assertJson(['success' => true]);
 
         $this->assertNull(Facades\Redirect::find('abc'));
+        $this->assertNull(Facades\Redirect::find('def'));
+        $this->assertNotNull(Facades\Redirect::find('ghi'));
     }
 
     #[Test]
-    public function cant_delete_redirect_without_permission()
+    public function delete_action_is_listed_for_selected_redirects()
     {
-        Facades\Redirect::make()
-            ->id('abc')
-            ->source('https://cool-runnings.com/old-url')
-            ->destination('https://cool-runnings.com/new-url')
-            ->responseCode(302)
-            ->enabled(true)
-            ->save();
+        $this->createRedirect('abc', '/old-url');
+        $this->createRedirect('def', '/another-old-url');
+
+        $this
+            ->actingAs(User::make()->makeSuper()->save())
+            ->postJson(cp_route('seo-pro.redirects.actions.bulk'), [
+                'selections' => ['abc', 'def'],
+            ])
+            ->assertOk()
+            ->assertJsonCount(1)
+            ->assertJsonPath('0.handle', 'delete_redirect');
+    }
+
+    #[Test]
+    public function cant_delete_selected_redirects_without_permission()
+    {
+        $this->createRedirect('abc', '/old-url');
+        $this->createRedirect('def', '/another-old-url');
 
-        Role::make('test')->addPermission('access cp')->save();
+        Role::make('test')->addPermission('access cp')->addPermission('view seo redirects')->save();
 
         $this
             ->actingAs(User::make()->assignRole('test')->save())
-            ->delete(cp_route('seo-pro.redirects.destroy', 'abc'))
-            ->assertRedirect('/cp');
+            ->postJson(cp_route('seo-pro.redirects.actions.run'), [
+                'action' => 'delete_redirect',
+                'selections' => ['abc', 'def'],
+                'values' => [],
+            ])
+            ->assertForbidden();
 
         $this->assertNotNull(Facades\Redirect::find('abc'));
+        $this->assertNotNull(Facades\Redirect::find('def'));
+    }
+
+    #[Test]
+    public function delete_action_is_not_listed_without_permission()
+    {
+        $this->createRedirect('abc', '/old-url');
+        $this->createRedirect('def', '/another-old-url');
+
+        Role::make('test')->addPermission('access cp')->addPermission('view seo redirects')->save();
+
+        $this
+            ->actingAs(User::make()->assignRole('test')->save())
+            ->postJson(cp_route('seo-pro.redirects.actions.bulk'), [
+                'selections' => ['abc', 'def'],
+            ])
+            ->assertOk()
+            ->assertJsonCount(0);
+    }
+
+    private function createRedirect(string $id, string $source): void
+    {
+        Facades\Redirect::make()
+            ->id($id)
+            ->source($source)
+            ->destination('/new-url')
+            ->responseCode(302)
+            ->enabled(true)
+            ->save();
     }
 }

From 493f00ba68f21794f6df3337561f2d9461ed2f0e Mon Sep 17 00:00:00 2001
From: Duncan McClean <duncan@duncanmcclean.com>
Date: Thu, 3 Sep 2026 12:35:59 +0100
Subject: [PATCH 16/38] 7.14.0 (#658)

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
---
 CHANGELOG.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 17a26f60..0c7e45fe 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,17 @@
 # Release Notes
 
+## 7.14.0 (2026-09-03)
+
+### What's new
+- Add configurable cap on tracked 404 errors [#654](https://github.com/statamic/seo-pro/issues/654) by @duncanmcclean
+- Add delete action for tracked 404 errors [#656](https://github.com/statamic/seo-pro/issues/656) by @duncanmcclean
+- Add delete action for redirects [#657](https://github.com/statamic/seo-pro/issues/657) by @duncanmcclean
+
+### What's fixed
+- Fix errors with no `last_hit_at` never being purged [#655](https://github.com/statamic/seo-pro/issues/655) by @duncanmcclean
+
+
+
 ## 7.13.3 (2026-08-25)
 
 ### What's fixed

From 93da19f185bc5cc544f90d0843712de88a0ea95a Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Fri, 4 Sep 2026 16:07:12 +0200
Subject: [PATCH 17/38] Add the ability to include entire collections or
 specific entries in llms.txt

---
 lang/en/messages.php                       |  8 ++
 resources/js/pages/llms/Tab.vue            | 30 +++++++
 src/Http/Controllers/CP/LlmsController.php | 46 +++++++++++
 src/Llms/Llms.php                          | 14 ++++
 src/Llms/LlmsContent.php                   | 91 ++++++++++++++++++++++
 src/Llms/LlmsRenderer.php                  | 27 +++++--
 src/Subscriber.php                         | 71 ++++++++++++++++-
 7 files changed, 277 insertions(+), 10 deletions(-)
 create mode 100644 src/Llms/LlmsContent.php

diff --git a/lang/en/messages.php b/lang/en/messages.php
index 5a4f7d7f..774c4d63 100644
--- a/lang/en/messages.php
+++ b/lang/en/messages.php
@@ -36,6 +36,14 @@
         'summary_instructions' => 'Optional. Rendered as the introductory blockquote.',
         'details' => 'Additional context',
         'details_instructions' => 'Optional Markdown placed before the file lists. Use sections below instead of headings here.',
+        'statamic_content' => 'Statamic content',
+        'statamic_content_description' => 'Include published Statamic entries as links, grouped by collection.',
+        'collections' => 'Collections',
+        'collections_instructions' => 'Include every published, routable entry from the selected collections for this site.',
+        'select_collections' => 'Select collections...',
+        'entries' => 'Individual entries',
+        'entries_instructions' => 'Include specific published entries. Entries already included through a collection are added only once.',
+        'select_entries' => 'Select entries...',
         'sections' => 'File-list sections',
         'sections_description' => 'Add curated links to useful, preferably LLM-friendly resources.',
         'add_section' => 'Add section',
diff --git a/resources/js/pages/llms/Tab.vue b/resources/js/pages/llms/Tab.vue
index 9b478768..366448b5 100644
--- a/resources/js/pages/llms/Tab.vue
+++ b/resources/js/pages/llms/Tab.vue
@@ -6,6 +6,7 @@ import {
 	Badge,
 	Button,
 	CodeEditor,
+	Combobox,
 	Description,
 	Field,
 	Heading,
@@ -40,6 +41,8 @@ const liveUrl = ref('');
 const file = ref({});
 const sites = ref([]);
 const site = ref('');
+const collectionOptions = ref([]);
+const entryOptions = ref([]);
 const errors = ref({});
 const previewError = ref(false);
 const hydrating = ref(false);
@@ -64,6 +67,8 @@ function hydrate(data) {
 	file.value = data.file;
 	sites.value = data.sites;
 	site.value = data.site;
+	collectionOptions.value = data.collectionOptions;
+	entryOptions.value = data.entryOptions;
 	errors.value = {};
 	previewError.value = false;
 	loaded.value = true;
@@ -292,6 +297,31 @@ defineExpose({ save });
 							</Field>
 						</Panel>
 
+						<Panel class="p-6 space-y-6">
+							<div>
+								<Heading size="lg" :text="__('seo-pro::messages.llms_txt.statamic_content')" />
+								<Description class="mt-1" :text="__('seo-pro::messages.llms_txt.statamic_content_description')" />
+							</div>
+							<Field :label="__('seo-pro::messages.llms_txt.collections')" :instructions="__('seo-pro::messages.llms_txt.collections_instructions')">
+								<Combobox
+									v-model="form.collections"
+									multiple
+									searchable
+									:options="collectionOptions"
+									:placeholder="__('seo-pro::messages.llms_txt.select_collections')"
+								/>
+							</Field>
+							<Field :label="__('seo-pro::messages.llms_txt.entries')" :instructions="__('seo-pro::messages.llms_txt.entries_instructions')">
+								<Combobox
+									v-model="form.entries"
+									multiple
+									searchable
+									:options="entryOptions"
+									:placeholder="__('seo-pro::messages.llms_txt.select_entries')"
+								/>
+							</Field>
+						</Panel>
+
 						<section>
 							<div class="flex items-center justify-between gap-4 mb-3">
 								<div>
diff --git a/src/Http/Controllers/CP/LlmsController.php b/src/Http/Controllers/CP/LlmsController.php
index 0ca78554..c8ce176a 100644
--- a/src/Http/Controllers/CP/LlmsController.php
+++ b/src/Http/Controllers/CP/LlmsController.php
@@ -5,6 +5,8 @@
 use Illuminate\Http\Request;
 use Illuminate\Validation\Rule;
 use Illuminate\Validation\ValidationException;
+use Statamic\Facades\Collection;
+use Statamic\Facades\Entry;
 use Statamic\Facades\Site;
 use Statamic\Http\Controllers\CP\CpController;
 use Statamic\SeoPro\Llms\Llms;
@@ -40,6 +42,8 @@ public function edit(Request $request)
                 'handle' => $site->handle(),
                 'name' => $site->name(),
             ])->values()->all(),
+            'collectionOptions' => $this->collectionOptions($site),
+            'entryOptions' => $this->entryOptions($site),
             'file' => $this->generator->status($site),
         ];
     }
@@ -120,6 +124,10 @@ private function validated(Request $request, $site, bool $validateRenderedDocume
             'title' => [Rule::requiredIf($enabled && $managed), 'nullable', 'string', 'max:5000'],
             'summary' => ['nullable', 'string', 'max:20000'],
             'details' => ['nullable', 'string', 'max:100000'],
+            'collections' => ['sometimes', 'array', 'max:100'],
+            'collections.*' => ['string', 'max:255', 'distinct'],
+            'entries' => ['sometimes', 'array', 'max:1000'],
+            'entries.*' => ['string', 'max:255', 'distinct'],
             'sections' => ['present', 'array', 'max:50'],
             'sections.*.title' => ['nullable', 'string', 'max:5000'],
             'sections.*.links' => ['present', 'array', 'max:100'],
@@ -145,6 +153,8 @@ function (string $attribute, mixed $value, \Closure $fail) {
         $values['title'] ??= '';
         $values['summary'] ??= '';
         $values['details'] ??= '';
+        $values['collections'] ??= [];
+        $values['entries'] ??= [];
         $values['custom_source'] ??= '';
 
         if ($validateRenderedDocument && $enabled) {
@@ -176,4 +186,40 @@ private function previewContents(LlmsDocument $document, $site): string
             return '';
         }
     }
+
+    private function collectionOptions($site): array
+    {
+        return Collection::all()
+            ->filter(fn ($collection) => $collection->sites()->contains($site->handle()))
+            ->map(fn ($collection) => [
+                'label' => $collection->title(),
+                'value' => $collection->handle(),
+            ])
+            ->sortBy('label', SORT_NATURAL | SORT_FLAG_CASE)
+            ->values()
+            ->all();
+    }
+
+    private function entryOptions($site): array
+    {
+        return Entry::query()
+            ->where('site', $site->handle())
+            ->whereNotNull('uri')
+            ->whereStatus('published')
+            ->get()
+            ->map(function ($entry) {
+                $title = $entry->value('title');
+                $title = is_scalar($title) || $title instanceof \Stringable
+                    ? trim((string) preg_replace('/\s+/u', ' ', (string) $title))
+                    : '';
+
+                return [
+                    'label' => sprintf('%s — %s', $title ?: ($entry->slug() ?? $entry->id()), $entry->collection()->title()),
+                    'value' => $entry->id(),
+                ];
+            })
+            ->sortBy('label', SORT_NATURAL | SORT_FLAG_CASE)
+            ->values()
+            ->all();
+    }
 }
diff --git a/src/Llms/Llms.php b/src/Llms/Llms.php
index 0d630b76..50d99955 100644
--- a/src/Llms/Llms.php
+++ b/src/Llms/Llms.php
@@ -86,6 +86,8 @@ public static function withDefaults(array $data): array
         $values['summary'] = (string) ($values['summary'] ?? '');
         $values['details'] = (string) ($values['details'] ?? '');
         $values['custom_source'] = (string) ($values['custom_source'] ?? '');
+        $values['collections'] = self::normalizeSelections($values['collections']);
+        $values['entries'] = self::normalizeSelections($values['entries']);
         $values['sections'] = collect(is_array($values['sections']) ? $values['sections'] : [])
             ->filter(fn ($section) => is_array($section))
             ->map(function (array $section) {
@@ -116,6 +118,8 @@ public static function defaults(): array
             'title' => '{{ config:app:name }}',
             'summary' => '',
             'details' => '',
+            'collections' => [],
+            'entries' => [],
             'sections' => [],
             'custom_source' => '',
         ];
@@ -213,4 +217,14 @@ private static function saveSiteSettings(SiteObject $site, array $siteData): boo
 
         return $saved;
     }
+
+    private static function normalizeSelections(mixed $selections): array
+    {
+        return collect(is_array($selections) ? $selections : [])
+            ->filter(fn ($selection) => is_string($selection) && trim($selection) !== '')
+            ->map(fn (string $selection) => trim($selection))
+            ->unique()
+            ->values()
+            ->all();
+    }
 }
diff --git a/src/Llms/LlmsContent.php b/src/Llms/LlmsContent.php
new file mode 100644
index 00000000..80a507d8
--- /dev/null
+++ b/src/Llms/LlmsContent.php
@@ -0,0 +1,91 @@
+<?php
+
+namespace Statamic\SeoPro\Llms;
+
+use Statamic\Contracts\Entries\Entry;
+use Statamic\Facades\Collection;
+use Statamic\Facades\Entry as EntryFacade;
+use Statamic\Sites\Site as SiteObject;
+
+class LlmsContent
+{
+    public function sections(LlmsDocument|array $document, string|SiteObject|null $site = null): array
+    {
+        $values = $document instanceof LlmsDocument
+            ? $document->all()
+            : Llms::withDefaults($document);
+        $site = Llms::site($site);
+        $sections = [];
+        $included = [];
+
+        foreach ($values['collections'] as $handle) {
+            $collection = Collection::find($handle);
+
+            if (! $collection || ! $collection->sites()->contains($site->handle())) {
+                continue;
+            }
+
+            $entries = $collection->queryEntries()
+                ->where('site', $site->handle())
+                ->whereNotNull('uri')
+                ->whereStatus('published')
+                ->orderBy('uri')
+                ->get();
+
+            foreach ($entries as $entry) {
+                $this->addEntry($sections, $included, $entry);
+            }
+        }
+
+        foreach ($values['entries'] as $id) {
+            $entry = EntryFacade::find($id)?->in($site->handle());
+
+            if (! $entry || $entry->status() !== 'published' || $entry->uri() === null) {
+                continue;
+            }
+
+            $this->addEntry($sections, $included, $entry);
+        }
+
+        return collect($sections)
+            ->filter(fn (array $section) => $section['links'] !== [])
+            ->values()
+            ->all();
+    }
+
+    private function addEntry(array &$sections, array &$included, Entry $entry): void
+    {
+        if (isset($included[$entry->id()])) {
+            return;
+        }
+
+        $url = $entry->absoluteUrl();
+
+        if (! is_string($url) || $url === '') {
+            return;
+        }
+
+        $collection = $entry->collection();
+        $handle = $collection->handle();
+        $title = $entry->value('title');
+        $title = is_scalar($title) || $title instanceof \Stringable
+            ? trim((string) preg_replace('/\s+/u', ' ', (string) $title))
+            : '';
+
+        if ($title === '') {
+            $title = (string) ($entry->slug() ?? $entry->id());
+        }
+
+        $sections[$handle] ??= [
+            'title' => trim((string) preg_replace('/\s+/u', ' ', $collection->title())),
+            'links' => [],
+            'parse_antlers' => false,
+        ];
+        $sections[$handle]['links'][] = [
+            'title' => $title,
+            'url' => $url,
+            'description' => '',
+        ];
+        $included[$entry->id()] = true;
+    }
+}
diff --git a/src/Llms/LlmsRenderer.php b/src/Llms/LlmsRenderer.php
index 2501bc23..76c10d48 100644
--- a/src/Llms/LlmsRenderer.php
+++ b/src/Llms/LlmsRenderer.php
@@ -14,6 +14,8 @@ class LlmsRenderer
 {
     public const MAX_BYTES = 512000;
 
+    public function __construct(private ?LlmsContent $content = null) {}
+
     public function render(LlmsDocument|array $document, string|SiteObject|null $site = null): string
     {
         $values = $document instanceof LlmsDocument
@@ -51,14 +53,22 @@ public function render(LlmsDocument|array $document, string|SiteObject|null $sit
             $lines[] = $this->normalizeLines($details);
         }
 
-        foreach ($values['sections'] as $section) {
-            $sectionTitle = trim($this->parse($section['title'], $context));
+        $sections = [
+            ...$this->content()->sections($values, $site),
+            ...$values['sections'],
+        ];
+
+        foreach ($sections as $section) {
+            $parseAntlers = $section['parse_antlers'] ?? true;
+            $sectionTitle = trim($parseAntlers
+                ? $this->parse($section['title'], $context)
+                : $section['title']);
             $links = collect($section['links'])
-                ->map(function (array $link) use ($context) {
+                ->map(function (array $link) use ($context, $parseAntlers) {
                     return [
-                        'title' => trim($this->parse($link['title'], $context)),
-                        'url' => trim($this->parse($link['url'], $context)),
-                        'description' => trim($this->parse($link['description'], $context)),
+                        'title' => trim($parseAntlers ? $this->parse($link['title'], $context) : $link['title']),
+                        'url' => trim($parseAntlers ? $this->parse($link['url'], $context) : $link['url']),
+                        'description' => trim($parseAntlers ? $this->parse($link['description'], $context) : $link['description']),
                     ];
                 })
                 ->filter(fn (array $link) => $link['title'] !== '' || $link['url'] !== '')
@@ -104,6 +114,11 @@ private function parse(string $value, array $context): string
         return (string) Antlers::parse($value, $context);
     }
 
+    private function content(): LlmsContent
+    {
+        return $this->content ??= app(LlmsContent::class);
+    }
+
     private function context(SiteObject $site): array
     {
         return [
diff --git a/src/Subscriber.php b/src/Subscriber.php
index 7d2cfd40..7aa4d891 100644
--- a/src/Subscriber.php
+++ b/src/Subscriber.php
@@ -5,9 +5,15 @@
 use Illuminate\Events\Dispatcher;
 use Statamic\Events;
 use Statamic\Facades\Collection;
+use Statamic\Facades\Site;
 use Statamic\Facades\Taxonomy;
+use Statamic\SeoPro\Llms\Llms;
+use Statamic\SeoPro\Llms\LlmsRenderCache;
+use Statamic\SeoPro\Llms\LlmsTxtGenerator;
 use Statamic\SeoPro\Sitemap\Sitemap;
+use Statamic\StaticCaching\Cacher;
 use Statamic\Support\Str;
+use Throwable;
 
 class Subscriber
 {
@@ -19,10 +25,12 @@ class Subscriber
     protected $events = [
         Events\EntryBlueprintFound::class => 'ensureSeoFields',
         Events\TermBlueprintFound::class => 'ensureSeoFields',
-        Events\CollectionSaved::class => 'clearSitemapCache',
-        Events\CollectionDeleted::class => 'clearSitemapCache',
-        Events\EntrySaved::class => 'clearSitemapCache',
-        Events\EntryDeleted::class => 'clearSitemapCache',
+        Events\CollectionSaved::class => 'clearSitemapAndLlmsCache',
+        Events\CollectionDeleted::class => 'clearSitemapAndLlmsCache',
+        Events\EntrySaved::class => 'clearSitemapAndLlmsCache',
+        Events\EntryDeleted::class => 'clearSitemapAndLlmsCache',
+        Events\StacheCleared::class => 'clearLlmsContentCaches',
+        Events\StacheWarmed::class => 'refreshLlmsContent',
         Events\TaxonomySaved::class => 'clearSitemapCache',
         Events\TaxonomyDeleted::class => 'clearSitemapCache',
         Events\TermSaved::class => 'clearSitemapCache',
@@ -61,6 +69,61 @@ public function clearSitemapCache()
         Sitemap::invalidateCache();
     }
 
+    /**
+     * Clear generated content caches and refresh physical files managed by SEO Pro.
+     */
+    public function clearSitemapAndLlmsCache()
+    {
+        $this->clearSitemapCache();
+        $this->refreshLlmsContent();
+    }
+
+    public function refreshLlmsContent()
+    {
+        $this->updateLlmsContent(regenerateManagedFiles: true);
+    }
+
+    public function clearLlmsContentCaches()
+    {
+        $this->updateLlmsContent(regenerateManagedFiles: false);
+    }
+
+    private function updateLlmsContent(bool $regenerateManagedFiles): void
+    {
+        Site::all()->each(function ($site) use ($regenerateManagedFiles) {
+            $document = Llms::get($site);
+
+            if (! $document->enabled() || ! $this->hasSelectedContent($document->all())) {
+                return;
+            }
+
+            app(LlmsRenderCache::class)->forget($site);
+            app(Cacher::class)->invalidateUrls([Llms::url($site)]);
+
+            if (! $regenerateManagedFiles) {
+                return;
+            }
+
+            $generator = app(LlmsTxtGenerator::class);
+
+            if (! $generator->status($site)['managed']) {
+                return;
+            }
+
+            try {
+                $generator->generate($document, $site);
+            } catch (Throwable $exception) {
+                report($exception);
+            }
+        });
+    }
+
+    private function hasSelectedContent(array $values): bool
+    {
+        return $values['mode'] === 'managed'
+            && ($values['collections'] !== [] || $values['entries'] !== []);
+    }
+
     /**
      * Check if SEO is enabled for section.
      *

From d1796421c1d6adf5bc1758c30f790ee45e55a95d Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Fri, 4 Sep 2026 16:07:29 +0200
Subject: [PATCH 18/38] Tests

---
 tests/LlmsCpTest.php         | 31 ++++++++++++++
 tests/LlmsTest.php           | 79 ++++++++++++++++++++++++++++++++++++
 tests/Localized/LlmsTest.php | 25 ++++++++++++
 3 files changed, 135 insertions(+)

diff --git a/tests/LlmsCpTest.php b/tests/LlmsCpTest.php
index 404a24fe..e3bec343 100644
--- a/tests/LlmsCpTest.php
+++ b/tests/LlmsCpTest.php
@@ -25,6 +25,13 @@ public function a_super_user_can_view_disabled_defaults()
             ->assertJsonPath('values.enabled', false)
             ->assertJsonPath('values.mode', 'managed')
             ->assertJsonPath('values.title', '{{ config:app:name }}')
+            ->assertJsonPath('values.collections', [])
+            ->assertJsonPath('values.entries', [])
+            ->assertJsonFragment(['label' => 'Articles', 'value' => 'articles'])
+            ->assertJsonFragment([
+                'label' => 'About — Pages',
+                'value' => '62136fa2-9e5c-4c38-a894-a2753f02f5ff',
+            ])
             ->assertJsonPath('file.exists', false)
             ->assertJsonPath('file.path', public_path('llms.txt'))
             ->assertJsonPath('liveUrl', 'http://cool-runnings.com/llms.txt');
@@ -58,6 +65,28 @@ public function generating_creates_a_managed_file()
         $this->assertSame("# Cool Runnings\n", $this->files->get(public_path('llms.txt')));
     }
 
+    #[Test]
+    public function selected_collections_and_entries_are_saved_and_previewed()
+    {
+        $this->actingAs(User::make()->makeSuper()->save())
+            ->patchJson(cp_route('seo-pro.llms.update'), $this->payload([
+                'collections' => ['articles'],
+                'entries' => ['62136fa2-9e5c-4c38-a894-a2753f02f5ff'],
+            ]))
+            ->assertOk()
+            ->assertJsonPath('saved', true)
+            ->assertSee('## Articles', false)
+            ->assertSee('## Pages', false);
+
+        $settings = Addon::get('statamic/seo-pro')->settings();
+
+        $this->assertSame(['articles'], $settings->get('llms.sites.default.policy.collections'));
+        $this->assertSame(
+            ['62136fa2-9e5c-4c38-a894-a2753f02f5ff'],
+            $settings->get('llms.sites.default.policy.entries'),
+        );
+    }
+
     #[Test]
     public function saving_updates_only_a_file_that_seo_pro_manages()
     {
@@ -148,6 +177,8 @@ private function payload(array $overrides = []): array
             'title' => 'Cool Runnings',
             'summary' => '',
             'details' => '',
+            'collections' => [],
+            'entries' => [],
             'sections' => [],
             'custom_source' => '',
         ], $overrides);
diff --git a/tests/LlmsTest.php b/tests/LlmsTest.php
index 149a0e9b..78fa1f9b 100644
--- a/tests/LlmsTest.php
+++ b/tests/LlmsTest.php
@@ -9,6 +9,7 @@
 use PHPUnit\Framework\Attributes\Test;
 use Statamic\Events\AddonSettingsSaved;
 use Statamic\Facades\Addon;
+use Statamic\Facades\Entry;
 use Statamic\Facades\Site;
 use Statamic\SeoPro\Cascade;
 use Statamic\SeoPro\Llms\Llms;
@@ -84,6 +85,84 @@ public function it_renders_custom_source_after_parsing_antlers()
             ->assertContent("# Cool Runnings\n\nCustom content.\n");
     }
 
+    #[Test]
+    public function it_includes_selected_collections_and_entries_grouped_by_collection()
+    {
+        $this->saveEnabled([
+            'collections' => ['articles'],
+            'entries' => ['62136fa2-9e5c-4c38-a894-a2753f02f5ff'],
+        ]);
+
+        $contents = $this->get('/llms.txt')->assertOk()->content();
+
+        $this->assertStringContainsString("## Articles\n", $contents);
+        $this->assertStringContainsString(
+            '- [The Magic Happens at 7 1/2 Pumps](http://cool-runnings.com/magic)',
+            $contents,
+        );
+        $this->assertStringContainsString("## Pages\n", $contents);
+        $this->assertStringContainsString(
+            '- [About](http://cool-runnings.com/about)',
+            $contents,
+        );
+    }
+
+    #[Test]
+    public function an_entry_selected_individually_and_through_its_collection_is_only_included_once()
+    {
+        $this->saveEnabled([
+            'collections' => ['pages'],
+            'entries' => ['62136fa2-9e5c-4c38-a894-a2753f02f5ff'],
+        ]);
+
+        $contents = $this->get('/llms.txt')->assertOk()->content();
+
+        $this->assertSame(1, substr_count($contents, '](http://cool-runnings.com/about)'));
+    }
+
+    #[Test]
+    public function selected_draft_entries_are_not_included()
+    {
+        Entry::make()
+            ->id('draft-page')
+            ->collection('pages')
+            ->slug('draft-page')
+            ->published(false)
+            ->data(['title' => 'Draft Page'])
+            ->save();
+        $this->saveEnabled([
+            'collections' => ['pages'],
+            'entries' => ['draft-page'],
+        ]);
+
+        $contents = $this->get('/llms.txt')->assertOk()->content();
+
+        $this->assertStringNotContainsString('Draft Page', $contents);
+        $this->assertStringNotContainsString('/draft-page', $contents);
+    }
+
+    #[Test]
+    public function selected_content_changes_invalidate_the_route_cache_and_refresh_a_managed_file()
+    {
+        $this->saveEnabled([
+            'entries' => ['62136fa2-9e5c-4c38-a894-a2753f02f5ff'],
+        ]);
+        $generator = app(LlmsTxtGenerator::class);
+        $generator->generate();
+
+        $this->get('/llms.txt')->assertOk()->assertSee('- [About](', false);
+
+        Entry::find('62136fa2-9e5c-4c38-a894-a2753f02f5ff')
+            ->set('title', 'About the Team')
+            ->save();
+
+        $this->get('/llms.txt')->assertOk()->assertSee('- [About the Team](', false);
+        $this->assertStringContainsString(
+            '- [About the Team](http://cool-runnings.com/about)',
+            $this->files->get(public_path('llms.txt')),
+        );
+    }
+
     #[Test]
     #[DataProvider('additionalH1Provider')]
     public function it_rejects_documents_with_more_than_one_markdown_h1(string $source)
diff --git a/tests/Localized/LlmsTest.php b/tests/Localized/LlmsTest.php
index 97f6b1f2..a5f52136 100644
--- a/tests/Localized/LlmsTest.php
+++ b/tests/Localized/LlmsTest.php
@@ -50,4 +50,29 @@ public function generated_files_follow_each_sites_base_path()
         $this->assertSame(public_path('fr/llms.txt'), $result['path']);
         $this->assertSame("# Français\n", $this->files->get(public_path('fr/llms.txt')));
     }
+
+    #[Test]
+    public function selected_content_is_resolved_for_the_configured_site()
+    {
+        Llms::saveWithoutGenerated(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Français',
+            'collections' => ['articles'],
+            'entries' => ['62136fa2-9e5c-4c38-a894-a2753f02f5ff'],
+        ]), Site::get('french'));
+
+        $contents = $this->get('http://cool-runnings.com/fr/llms.txt')
+            ->assertOk()
+            ->content();
+
+        $this->assertStringContainsString(
+            '- [Les Nectar of the Gods](http://cool-runnings.com/fr/nectar)',
+            $contents,
+        );
+        $this->assertStringContainsString(
+            '- [About](http://cool-runnings.com/fr/about)',
+            $contents,
+        );
+        $this->assertStringNotContainsString('The Magic Happens', $contents);
+    }
 }

From f6accfbc541a1eec06e3ea82b5496e3cd17c0b7c Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Fri, 4 Sep 2026 16:14:24 +0200
Subject: [PATCH 19/38] Properly check for authorization

---
 src/Http/Controllers/CP/LlmsController.php | 38 ++++++++-
 tests/Localized/LlmsCpTest.php             | 89 ++++++++++++++++++++++
 2 files changed, 123 insertions(+), 4 deletions(-)
 create mode 100644 tests/Localized/LlmsCpTest.php

diff --git a/src/Http/Controllers/CP/LlmsController.php b/src/Http/Controllers/CP/LlmsController.php
index c8ce176a..acca32a8 100644
--- a/src/Http/Controllers/CP/LlmsController.php
+++ b/src/Http/Controllers/CP/LlmsController.php
@@ -8,6 +8,7 @@
 use Statamic\Facades\Collection;
 use Statamic\Facades\Entry;
 use Statamic\Facades\Site;
+use Statamic\Facades\User;
 use Statamic\Http\Controllers\CP\CpController;
 use Statamic\SeoPro\Llms\Llms;
 use Statamic\SeoPro\Llms\LlmsDocument;
@@ -38,7 +39,7 @@ public function edit(Request $request)
             'previewUrl' => cp_route('seo-pro.llms.preview'),
             'liveUrl' => Llms::url($site),
             'site' => $site->handle(),
-            'sites' => Site::all()->map(fn ($site) => [
+            'sites' => Site::authorized()->map(fn ($site) => [
                 'handle' => $site->handle(),
                 'name' => $site->name(),
             ])->values()->all(),
@@ -125,9 +126,35 @@ private function validated(Request $request, $site, bool $validateRenderedDocume
             'summary' => ['nullable', 'string', 'max:20000'],
             'details' => ['nullable', 'string', 'max:100000'],
             'collections' => ['sometimes', 'array', 'max:100'],
-            'collections.*' => ['string', 'max:255', 'distinct'],
+            'collections.*' => [
+                'bail',
+                'string',
+                'max:255',
+                'distinct',
+                function (string $attribute, mixed $value, \Closure $fail) use ($site) {
+                    $collection = Collection::find((string) $value);
+
+                    if (! $collection
+                        || ! $collection->sites()->contains($site->handle())
+                        || User::current()->cannot('view', $collection)) {
+                        $fail(__('The selected :attribute is invalid.', ['attribute' => $attribute]));
+                    }
+                },
+            ],
             'entries' => ['sometimes', 'array', 'max:1000'],
-            'entries.*' => ['string', 'max:255', 'distinct'],
+            'entries.*' => [
+                'bail',
+                'string',
+                'max:255',
+                'distinct',
+                function (string $attribute, mixed $value, \Closure $fail) use ($site) {
+                    $entry = Entry::find((string) $value)?->in($site->handle());
+
+                    if (! $entry || User::current()->cannot('view', $entry)) {
+                        $fail(__('The selected :attribute is invalid.', ['attribute' => $attribute]));
+                    }
+                },
+            ],
             'sections' => ['present', 'array', 'max:50'],
             'sections.*.title' => ['nullable', 'string', 'max:5000'],
             'sections.*.links' => ['present', 'array', 'max:100'],
@@ -174,6 +201,7 @@ private function site(Request $request)
         $site = Site::get($handle);
 
         abort_unless($site, 404);
+        $this->authorize('view', $site);
 
         return $site;
     }
@@ -190,7 +218,8 @@ private function previewContents(LlmsDocument $document, $site): string
     private function collectionOptions($site): array
     {
         return Collection::all()
-            ->filter(fn ($collection) => $collection->sites()->contains($site->handle()))
+            ->filter(fn ($collection) => $collection->sites()->contains($site->handle())
+                && User::current()->can('view', $collection))
             ->map(fn ($collection) => [
                 'label' => $collection->title(),
                 'value' => $collection->handle(),
@@ -207,6 +236,7 @@ private function entryOptions($site): array
             ->whereNotNull('uri')
             ->whereStatus('published')
             ->get()
+            ->filter(fn ($entry) => User::current()->can('view', $entry))
             ->map(function ($entry) {
                 $title = $entry->value('title');
                 $title = is_scalar($title) || $title instanceof \Stringable
diff --git a/tests/Localized/LlmsCpTest.php b/tests/Localized/LlmsCpTest.php
new file mode 100644
index 00000000..90d806a3
--- /dev/null
+++ b/tests/Localized/LlmsCpTest.php
@@ -0,0 +1,89 @@
+<?php
+
+namespace Tests\Localized;
+
+use PHPUnit\Framework\Attributes\Test;
+use Statamic\Facades\Role;
+use Statamic\Facades\User;
+
+class LlmsCpTest extends LocalizedTestCase
+{
+    #[Test]
+    public function users_can_only_manage_llms_txt_for_authorized_sites()
+    {
+        $user = $this->makeRestrictedUser();
+
+        $this->actingAs($user)
+            ->getJson(cp_route('seo-pro.llms.edit').'?site=default')
+            ->assertOk()
+            ->assertJsonCount(1, 'sites')
+            ->assertJsonPath('sites.0.handle', 'default');
+
+        $this->actingAs($user)
+            ->getJson(cp_route('seo-pro.llms.edit').'?site=french')
+            ->assertForbidden();
+
+        $this->actingAs($user)
+            ->patchJson(cp_route('seo-pro.llms.update'), $this->payload(['site' => 'french']))
+            ->assertForbidden();
+    }
+
+    #[Test]
+    public function content_options_are_limited_to_entries_the_user_can_view()
+    {
+        $response = $this->actingAs($this->makeRestrictedUser())
+            ->getJson(cp_route('seo-pro.llms.edit').'?site=default')
+            ->assertOk();
+
+        $response->assertJsonFragment(['label' => 'Pages', 'value' => 'pages']);
+        $response->assertJsonMissing(['label' => 'Articles', 'value' => 'articles']);
+        $response->assertJsonFragment([
+            'label' => 'About — Pages',
+            'value' => '62136fa2-9e5c-4c38-a894-a2753f02f5ff',
+        ]);
+        $response->assertJsonMissing([
+            'label' => 'The Magic Happens at 7 1/2 Pumps — Articles',
+            'value' => 'af43e0fb-a338-4433-b60a-3bed773be341',
+        ]);
+    }
+
+    #[Test]
+    public function inaccessible_content_cannot_be_selected_using_a_crafted_request()
+    {
+        $this->actingAs($this->makeRestrictedUser())
+            ->patchJson(cp_route('seo-pro.llms.update'), $this->payload([
+                'collections' => ['articles'],
+                'entries' => ['af43e0fb-a338-4433-b60a-3bed773be341'],
+            ]))
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors(['collections.0', 'entries.0']);
+    }
+
+    private function makeRestrictedUser()
+    {
+        Role::make('llms-editor')->permissions([
+            'access cp',
+            'edit seo robots',
+            'access default site',
+            'view pages entries',
+        ])->save();
+
+        return User::make()->assignRole('llms-editor')->save();
+    }
+
+    private function payload(array $overrides = []): array
+    {
+        return array_replace([
+            'site' => 'default',
+            'enabled' => true,
+            'mode' => 'managed',
+            'title' => 'Cool Runnings',
+            'summary' => '',
+            'details' => '',
+            'collections' => [],
+            'entries' => [],
+            'sections' => [],
+            'custom_source' => '',
+        ], $overrides);
+    }
+}

From b9d11a6d6601a14ba72c9423c7772f2c6ab34949 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Fri, 4 Sep 2026 16:28:24 +0200
Subject: [PATCH 20/38] Site-aware llms.txt routes

---
 routes/web.php                          |  8 +--
 src/Http/Controllers/LlmsController.php |  2 +-
 src/Llms/LlmsRoutes.php                 | 50 +++++++++++++++++++
 tests/Localized/LlmsTest.php            | 66 +++++++++++++++++++++++++
 4 files changed, 119 insertions(+), 7 deletions(-)
 create mode 100644 src/Llms/LlmsRoutes.php

diff --git a/routes/web.php b/routes/web.php
index 2b13ba3c..b49663ff 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -1,15 +1,11 @@
 <?php
 
 use Statamic\SeoPro\Http\Controllers;
+use Statamic\SeoPro\Llms\LlmsRoutes;
 
 Route::get('sitemap.xsl', Controllers\SitemapXslController::class);
 Route::get(config('statamic.seo-pro.sitemap.url'), [Controllers\SitemapController::class, 'index']);
 Route::get(config('statamic.seo-pro.sitemap.pagination.url', 'sitemap_{page}.xml'), [Controllers\SitemapController::class, 'show'])->name('statamic.seo-pro.sitemap.page.show');
 Route::get(config('statamic.seo-pro.humans.url'), [Controllers\HumansController::class, 'show']);
-Route::get('llms.txt', [Controllers\LlmsController::class, 'show'])
-    ->middleware('statamic.web')
-    ->name('statamic.seo-pro.llms.show');
 
-Route::get('{sitePath}/llms.txt', [Controllers\LlmsController::class, 'show'])
-    ->where('sitePath', '.+')
-    ->middleware('statamic.web');
+LlmsRoutes::register();
diff --git a/src/Http/Controllers/LlmsController.php b/src/Http/Controllers/LlmsController.php
index 25eaf2c6..7184b0b1 100644
--- a/src/Http/Controllers/LlmsController.php
+++ b/src/Http/Controllers/LlmsController.php
@@ -16,7 +16,7 @@ public function __construct(private LlmsRenderCache $cache) {}
 
     public function show(Request $request)
     {
-        $site = Site::findByUrl($request->url());
+        $site = Site::get($request->route('seoProSite'));
 
         abort_unless($site && Llms::url($site) === rtrim($request->url(), '/'), 404);
 
diff --git a/src/Llms/LlmsRoutes.php b/src/Llms/LlmsRoutes.php
new file mode 100644
index 00000000..43422595
--- /dev/null
+++ b/src/Llms/LlmsRoutes.php
@@ -0,0 +1,50 @@
+<?php
+
+namespace Statamic\SeoPro\Llms;
+
+use Illuminate\Support\Facades\Route;
+use Statamic\Facades\Site;
+use Statamic\SeoPro\Http\Controllers\LlmsController;
+
+class LlmsRoutes
+{
+    public static function register(?iterable $sites = null): void
+    {
+        $sites = collect($sites ?? Site::all());
+        $defaultSite = $sites->first();
+        $registered = [];
+        $routeName = 'statamic.seo-pro.llms.show';
+
+        if (! $defaultSite) {
+            return;
+        }
+
+        $sites
+            ->sortByDesc(fn ($site) => $site->handle() === $defaultSite->handle())
+            ->each(function ($site) use ($defaultSite, &$registered, $routeName) {
+                $host = parse_url($site->absoluteUrl(), PHP_URL_HOST);
+                $path = Llms::relativePath($site);
+                $key = strtolower(($host ?: '').'/'.$path);
+
+                if (isset($registered[$key])) {
+                    return;
+                }
+
+                $registered[$key] = true;
+
+                $route = $host
+                    ? Route::domain($host)->get($path, [LlmsController::class, 'show'])
+                    : Route::get($path, [LlmsController::class, 'show']);
+
+                $route
+                    ->middleware('statamic.web')
+                    ->defaults('seoProSite', $site->handle());
+
+                $route->name(
+                    $site->handle() === $defaultSite->handle()
+                        ? $routeName
+                        : $routeName.'.'.$site->handle()
+                );
+            });
+    }
+}
diff --git a/tests/Localized/LlmsTest.php b/tests/Localized/LlmsTest.php
index a5f52136..26bb3879 100644
--- a/tests/Localized/LlmsTest.php
+++ b/tests/Localized/LlmsTest.php
@@ -2,14 +2,27 @@
 
 namespace Tests\Localized;
 
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Route;
 use PHPUnit\Framework\Attributes\Test;
 use Statamic\Facades\Site;
+use Statamic\Facades\URL;
+use Statamic\Facades\YAML;
+use Statamic\SeoPro\Http\Controllers\LlmsController;
 use Statamic\SeoPro\Llms\Llms;
 use Statamic\SeoPro\Llms\LlmsDocument;
+use Statamic\SeoPro\Llms\LlmsRoutes;
 use Statamic\SeoPro\Llms\LlmsTxtGenerator;
 
 class LlmsTest extends LocalizedTestCase
 {
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        LlmsRoutes::register(Site::all());
+    }
+
     protected function tearDown(): void
     {
         $this->files->delete(public_path('llms.txt'));
@@ -39,6 +52,59 @@ public function routes_and_settings_are_scoped_per_site()
         $this->get('http://cool-runnings.com/en-gb/llms.txt')->assertNotFound();
     }
 
+    #[Test]
+    public function routes_support_deeply_nested_site_paths()
+    {
+        $sites = YAML::file("{$this->siteFixturePath}/resources/sites.yaml")->parse();
+        $sites['german'] = [
+            'name' => 'German',
+            'locale' => 'de_DE',
+            'url' => 'http://cool-runnings.com/regions/europe/de/',
+        ];
+
+        Site::setSites($sites);
+        URL::clearUrlCache();
+        LlmsRoutes::register(Site::all());
+
+        Llms::saveWithoutGenerated(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Deutsch',
+        ]), Site::get('german'));
+
+        $this->get('http://cool-runnings.com/regions/europe/de/llms.txt')
+            ->assertOk()
+            ->assertContent("# Deutsch\n");
+    }
+
+    #[Test]
+    public function routes_are_scoped_to_their_site_domains()
+    {
+        Llms::saveWithoutGenerated(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'English',
+        ]), Site::get('default'));
+        Llms::saveWithoutGenerated(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Italiano',
+        ]), Site::get('italian'));
+
+        $this->get('http://cool-runnings.com/llms.txt')
+            ->assertOk()
+            ->assertContent("# English\n");
+        $this->get('http://corse-fantastiche.it/llms.txt')
+            ->assertOk()
+            ->assertContent("# Italiano\n");
+    }
+
+    #[Test]
+    public function unrelated_llms_txt_paths_are_not_claimed_by_seo_pro()
+    {
+        $request = Request::create('http://cool-runnings.com/not-a-site/llms.txt');
+        $route = Route::getRoutes()->match($request);
+
+        $this->assertNotSame(LlmsController::class.'@show', $route->getActionName());
+    }
+
     #[Test]
     public function generated_files_follow_each_sites_base_path()
     {

From 3915613ae31e041915b4e60b36a9250bb07d217e Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Fri, 4 Sep 2026 16:38:33 +0200
Subject: [PATCH 21/38] Handle changes of site URLs/paths

---
 src/Llms/LlmsTxtGenerator.php | 171 +++++++++++++++++++++++++++++-----
 tests/LlmsTest.php            |  87 +++++++++++++++++
 2 files changed, 237 insertions(+), 21 deletions(-)

diff --git a/src/Llms/LlmsTxtGenerator.php b/src/Llms/LlmsTxtGenerator.php
index 1a1f87ee..83b69bf3 100644
--- a/src/Llms/LlmsTxtGenerator.php
+++ b/src/Llms/LlmsTxtGenerator.php
@@ -33,14 +33,15 @@ public function sync(LlmsDocument $document, string|SiteObject|null $site = null
 
         return $this->locked(function () use ($document, $site) {
             $status = $this->status($site);
+            $relocated = $this->relocatedManagedFile($site, $status['path']);
 
             if (! $document->enabled()) {
-                return $status['managed']
-                    ? $this->removeManagedWhileLocked($document, $site)
+                return $status['managed'] || $relocated
+                    ? $this->removeManagedWhileLocked($document, $site, $status, $relocated)
                     : $this->saveOnly($document, $site, $status);
             }
 
-            return $status['managed']
+            return $status['managed'] || $relocated
                 ? $this->generateWhileLocked($document, $site)
                 : $this->saveOnly($document, $site, $status);
         });
@@ -131,27 +132,43 @@ private function generateWhileLocked(LlmsDocument $document, SiteObject $site):
         $contents = $this->renderer->render($document, $site);
         $checksum = hash('sha256', $contents);
         $generated = Llms::generated($site) ?? [];
+        $relocated = $this->relocatedManagedFile($site, $path);
         $existingGeneratedAt = $this->existingGeneratedAt($generated, $checksum);
         $fileMatches = $this->fileMatches($path, $contents, $checksum);
         $settingsMatch = Llms::get($site)->all() === $document->all();
 
-        if ($fileMatches && $settingsMatch && $existingGeneratedAt) {
+        if ($fileMatches && $settingsMatch && $existingGeneratedAt && ! $relocated) {
             return $this->result($path, $contents, $existingGeneratedAt, false, false, false);
         }
 
         if ($fileMatches) {
             $generatedAt = $existingGeneratedAt ?? now();
             $settingsSnapshot = Llms::settingsSnapshot();
+            $relocatedSnapshot = $relocated
+                ? $this->snapshotFile($relocated['path'], expectedChecksum: $relocated['checksum'])
+                : null;
 
             try {
                 $this->saveGeneratedSettings($document, $site, $contents, $path, $generatedAt);
+
+                if ($relocated) {
+                    $this->deleteManagedFile($relocated['path'], $relocated['checksum']);
+                }
             } catch (Throwable $exception) {
-                $this->rollback($exception, $settingsSnapshot);
+                $this->rollback($exception, $settingsSnapshot, ...array_filter([$relocatedSnapshot]));
+            }
+
+            if ($relocatedSnapshot) {
+                $this->discardFileSnapshot($relocatedSnapshot);
             }
 
             $this->cache->forget($site);
 
-            return $this->result($path, $contents, $generatedAt, false, true, false);
+            if ($relocated) {
+                LlmsTxtGenerated::dispatch($document, $site, $path, $generatedAt);
+            }
+
+            return $this->result($path, $contents, $generatedAt, (bool) $relocated, true, false);
         }
 
         $settingsSnapshot = Llms::settingsSnapshot();
@@ -160,44 +177,73 @@ private function generateWhileLocked(LlmsDocument $document, SiteObject $site):
             expectedChecksum: $status['exists'] ? ($generated['checksum'] ?? null) : null,
             expectMissing: ! $status['exists'],
         );
+        $relocatedSnapshot = $relocated
+            ? $this->snapshotFile($relocated['path'], expectedChecksum: $relocated['checksum'])
+            : null;
         $generatedAt = now();
 
         try {
             $this->writeFile($path, $contents);
             $this->saveGeneratedSettings($document, $site, $contents, $path, $generatedAt);
+
+            if ($relocated) {
+                $this->deleteManagedFile($relocated['path'], $relocated['checksum']);
+            }
         } catch (Throwable $exception) {
-            $this->rollback($exception, $settingsSnapshot, $fileSnapshot);
+            $this->rollback(
+                $exception,
+                $settingsSnapshot,
+                ...array_filter([$fileSnapshot, $relocatedSnapshot]),
+            );
         }
 
         $this->discardFileSnapshot($fileSnapshot);
+
+        if ($relocatedSnapshot) {
+            $this->discardFileSnapshot($relocatedSnapshot);
+        }
+
         $this->cache->forget($site);
         LlmsTxtGenerated::dispatch($document, $site, $path, $generatedAt);
 
         return $this->result($path, $contents, $generatedAt, true, true, false);
     }
 
-    private function removeManagedWhileLocked(LlmsDocument $document, SiteObject $site): array
-    {
-        $path = $this->path($site);
+    private function removeManagedWhileLocked(
+        LlmsDocument $document,
+        SiteObject $site,
+        array $status,
+        ?array $relocated,
+    ): array {
+        $path = $status['path'];
         $settingsSnapshot = Llms::settingsSnapshot();
-        $fileSnapshot = $this->snapshotFile(
-            $path,
-            expectedChecksum: Llms::generated($site)['checksum'] ?? null,
-        );
+        $checksum = Llms::generated($site)['checksum'] ?? null;
+        $managedFiles = $relocated
+            ? [$relocated]
+            : [['path' => $path, 'checksum' => $checksum]];
+        $fileSnapshots = collect($managedFiles)
+            ->map(fn (array $file) => $this->snapshotFile(
+                $file['path'],
+                expectedChecksum: $file['checksum'],
+            ))
+            ->all();
 
         try {
-            if ($this->files->exists($path) && ! $this->files->delete($path)) {
-                throw new RuntimeException("Unable to remove the managed llms.txt file at [{$path}].");
+            foreach ($managedFiles as $file) {
+                $this->deleteManagedFile($file['path'], $file['checksum']);
             }
 
             if (! Llms::saveWithoutGenerated($document, $site)) {
                 throw new RuntimeException('Unable to save llms.txt settings.');
             }
         } catch (Throwable $exception) {
-            $this->rollback($exception, $settingsSnapshot, $fileSnapshot);
+            $this->rollback($exception, $settingsSnapshot, ...$fileSnapshots);
+        }
+
+        foreach ($fileSnapshots as $fileSnapshot) {
+            $this->discardFileSnapshot($fileSnapshot);
         }
 
-        $this->discardFileSnapshot($fileSnapshot);
         $this->cache->forget($site);
 
         return $this->result($path, '', now(), true, true, true);
@@ -278,7 +324,8 @@ private function saveGeneratedSettings(
 
         if (($settings['policy'] ?? null) !== $document->all()
             || ($settings['generated']['timestamp'] ?? null) !== $generatedAt->toIso8601String()
-            || ($settings['generated']['checksum'] ?? null) !== hash('sha256', $contents)) {
+            || ($settings['generated']['checksum'] ?? null) !== hash('sha256', $contents)
+            || ($settings['generated']['path'] ?? null) !== $path) {
             throw new RuntimeException('The generated llms.txt settings could not be verified after saving.');
         }
     }
@@ -351,7 +398,89 @@ private function snapshotFile(
         return ['exists' => true, 'path' => $target, 'backup' => $backup, 'mode' => $mode];
     }
 
-    private function rollback(Throwable $original, array $settingsSnapshot, ?array $fileSnapshot = null): never
+    private function relocatedManagedFile(SiteObject $site, string $currentPath): ?array
+    {
+        $generated = Llms::generated($site) ?? [];
+        $path = $generated['path'] ?? null;
+        $checksum = $generated['checksum'] ?? null;
+
+        if (! is_string($path)
+            || ! is_string($checksum)
+            || $this->pathsMatch($path, $currentPath)
+            || ! $this->isWithinPublicDirectory($path)) {
+            return null;
+        }
+
+        if (is_link($path)) {
+            throw new RuntimeException("SEO Pro will not manage an llms.txt symbolic link at [{$path}].");
+        }
+
+        if (! $this->files->exists($path)) {
+            return null;
+        }
+
+        $resolvedPath = realpath($path);
+
+        if (! is_string($resolvedPath)
+            || ! $this->isWithinPublicDirectory($resolvedPath)
+            || ! $this->files->isFile($path)
+            || ! $this->fileHasChecksum($path, $checksum)) {
+            throw new RuntimeException("The previously managed llms.txt file at [{$path}] has changed and will not be removed.");
+        }
+
+        return compact('path', 'checksum');
+    }
+
+    private function deleteManagedFile(string $path, string $checksum): void
+    {
+        if (! $this->files->exists($path)) {
+            return;
+        }
+
+        if (is_link($path) || ! $this->files->isFile($path) || ! $this->fileHasChecksum($path, $checksum)) {
+            throw new RuntimeException("The managed llms.txt file at [{$path}] changed and will not be removed.");
+        }
+
+        if (! $this->files->delete($path)) {
+            throw new RuntimeException("Unable to remove the managed llms.txt file at [{$path}].");
+        }
+    }
+
+    private function pathsMatch(string $first, string $second): bool
+    {
+        $first = rtrim(str_replace('\\', '/', $first), '/');
+        $second = rtrim(str_replace('\\', '/', $second), '/');
+
+        return DIRECTORY_SEPARATOR === '\\'
+            ? strtolower($first) === strtolower($second)
+            : $first === $second;
+    }
+
+    private function fileHasChecksum(string $path, string $checksum): bool
+    {
+        try {
+            $currentChecksum = $this->files->hash($path, 'sha256');
+
+            return is_string($currentChecksum) && hash_equals($checksum, $currentChecksum);
+        } catch (Throwable) {
+            return false;
+        }
+    }
+
+    private function isWithinPublicDirectory(string $path): bool
+    {
+        $publicPath = rtrim(str_replace('\\', '/', public_path()), '/');
+        $path = str_replace('\\', '/', $path);
+
+        if (DIRECTORY_SEPARATOR === '\\') {
+            $publicPath = strtolower($publicPath);
+            $path = strtolower($path);
+        }
+
+        return str_starts_with($path, $publicPath.'/');
+    }
+
+    private function rollback(Throwable $original, array $settingsSnapshot, array ...$fileSnapshots): never
     {
         $rollbackErrors = [];
 
@@ -361,7 +490,7 @@ private function rollback(Throwable $original, array $settingsSnapshot, ?array $
             $rollbackErrors[] = 'settings: '.$exception->getMessage();
         }
 
-        if ($fileSnapshot) {
+        foreach ($fileSnapshots as $fileSnapshot) {
             try {
                 $this->restoreFileSnapshot($fileSnapshot);
             } catch (Throwable $exception) {
diff --git a/tests/LlmsTest.php b/tests/LlmsTest.php
index 78fa1f9b..f0ae7d90 100644
--- a/tests/LlmsTest.php
+++ b/tests/LlmsTest.php
@@ -11,6 +11,7 @@
 use Statamic\Facades\Addon;
 use Statamic\Facades\Entry;
 use Statamic\Facades\Site;
+use Statamic\Facades\URL;
 use Statamic\SeoPro\Cascade;
 use Statamic\SeoPro\Llms\Llms;
 use Statamic\SeoPro\Llms\LlmsDocument;
@@ -23,6 +24,7 @@ class LlmsTest extends TestCase
     protected function tearDown(): void
     {
         $this->files->delete(public_path('llms.txt'));
+        $this->files->deleteDirectory(public_path('moved'));
 
         parent::tearDown();
     }
@@ -271,6 +273,91 @@ public function a_generated_file_is_kept_in_sync_and_removed_when_disabled()
         $this->assertNull(Llms::generated());
     }
 
+    #[Test]
+    public function a_managed_file_is_relocated_when_the_site_url_changes()
+    {
+        $generator = app(LlmsTxtGenerator::class);
+        $generator->generate(new LlmsDocument(['enabled' => true, 'title' => 'First']));
+
+        Site::default()->set('url', '/moved/');
+        URL::clearUrlCache();
+
+        $result = $generator->sync(new LlmsDocument(['enabled' => true, 'title' => 'Second']));
+
+        $this->assertTrue($result['changed']);
+        $this->assertFileDoesNotExist(public_path('llms.txt'));
+        $this->assertSame("# Second\n", $this->files->get(public_path('moved/llms.txt')));
+        $this->assertSame(public_path('moved/llms.txt'), Llms::generated()['path']);
+    }
+
+    #[Test]
+    public function disabling_after_a_site_url_change_removes_the_previous_managed_file()
+    {
+        $generator = app(LlmsTxtGenerator::class);
+        $generator->generate(new LlmsDocument(['enabled' => true, 'title' => 'First']));
+
+        Site::default()->set('url', '/moved/');
+        URL::clearUrlCache();
+
+        $result = $generator->sync(new LlmsDocument(['enabled' => false, 'title' => 'First']));
+
+        $this->assertTrue($result['removed']);
+        $this->assertFileDoesNotExist(public_path('llms.txt'));
+        $this->assertFileDoesNotExist(public_path('moved/llms.txt'));
+        $this->assertNull(Llms::generated());
+    }
+
+    #[Test]
+    public function a_modified_file_at_the_previous_site_path_is_not_removed()
+    {
+        $generator = app(LlmsTxtGenerator::class);
+        $generator->generate(new LlmsDocument(['enabled' => true, 'title' => 'First']));
+        $generated = Llms::generated();
+        $this->files->put(public_path('llms.txt'), "# Changed manually\n");
+
+        Site::default()->set('url', '/moved/');
+        URL::clearUrlCache();
+
+        try {
+            $generator->sync(new LlmsDocument(['enabled' => true, 'title' => 'Second']));
+            $this->fail('Synchronization should refuse to remove the modified previous file.');
+        } catch (\RuntimeException $exception) {
+            $this->assertStringContainsString('has changed and will not be removed', $exception->getMessage());
+        }
+
+        $this->assertSame("# Changed manually\n", $this->files->get(public_path('llms.txt')));
+        $this->assertFileDoesNotExist(public_path('moved/llms.txt'));
+        $this->assertSame($generated, Llms::generated());
+    }
+
+    #[Test]
+    public function a_failed_relocation_restores_the_previous_file_and_settings()
+    {
+        $generator = app(LlmsTxtGenerator::class);
+        $generator->generate(new LlmsDocument(['enabled' => true, 'title' => 'First']));
+        $previousSettings = Llms::settingsSnapshot();
+
+        Site::default()->set('url', '/moved/');
+        URL::clearUrlCache();
+
+        Event::listen(AddonSettingsSaved::class, function () {
+            throw new \RuntimeException('The settings listener failed.');
+        });
+
+        try {
+            $generator->sync(new LlmsDocument(['enabled' => true, 'title' => 'Second']));
+            $this->fail('Relocation should have failed.');
+        } catch (\RuntimeException $exception) {
+            $this->assertSame('The settings listener failed.', $exception->getMessage());
+        }
+
+        $this->assertSame("# First\n", $this->files->get(public_path('llms.txt')));
+        $this->assertFileDoesNotExist(public_path('moved/llms.txt'));
+        $this->assertSame($previousSettings, Llms::settingsSnapshot());
+        $this->assertSame([], glob(public_path('moved/.seo-pro-llms-*')));
+        $this->assertSame([], glob(public_path('.seo-pro-llms-*')));
+    }
+
     #[Test]
     public function an_unmanaged_file_is_never_overwritten_or_removed()
     {

From de8eba1ad2c33cc6b5e1dcf43ee29144385291d9 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Fri, 4 Sep 2026 16:41:22 +0200
Subject: [PATCH 22/38] Tweak preview logic and don't render previews in custom
 source mode

---
 resources/js/pages/llms/Tab.vue | 44 +++++++++++++++++++++++++++++----
 1 file changed, 39 insertions(+), 5 deletions(-)

diff --git a/resources/js/pages/llms/Tab.vue b/resources/js/pages/llms/Tab.vue
index 366448b5..9cb6c002 100644
--- a/resources/js/pages/llms/Tab.vue
+++ b/resources/js/pages/llms/Tab.vue
@@ -55,8 +55,20 @@ const modeOptions = [
 
 const isBusy = computed(() => loading.value || saving.value || generating.value);
 const hasUnmanagedFile = computed(() => file.value.exists && !file.value.managed);
+let previewTimer = null;
+let previewController = null;
+let previewRequest = 0;
+
+function cancelPreview() {
+	clearTimeout(previewTimer);
+	previewTimer = null;
+	previewController?.abort();
+	previewController = null;
+	previewRequest++;
+}
 
 function hydrate(data) {
+	cancelPreview();
 	hydrating.value = true;
 	form.value = deepClone(data.values);
 	rendered.value = data.preview;
@@ -79,6 +91,7 @@ function hydrate(data) {
 function load(selectedSite = null) {
 	if (loading.value) return;
 
+	cancelPreview();
 	loading.value = true;
 	$axios.get(props.editUrl, { params: selectedSite ? { site: selectedSite } : {} })
 		.then((response) => hydrate(response.data))
@@ -101,6 +114,7 @@ function clearDirtyStateIfUnchanged(submitted) {
 function save() {
 	if (!loaded.value || isBusy.value) return;
 
+	cancelPreview();
 	saving.value = true;
 	emit('saving', true);
 	errors.value = {};
@@ -130,6 +144,7 @@ function requestGeneration() {
 }
 
 function generate() {
+	cancelPreview();
 	confirmingGeneration.value = false;
 	generating.value = true;
 	emit('saving', true);
@@ -181,24 +196,43 @@ function removeLink(section, index) {
 	section.links.splice(index, 1);
 }
 
-let previewTimer;
 watch(form, () => {
 	if (!loaded.value || hydrating.value) return;
 
 	Statamic.$dirty.add(dirtyStateName);
-	clearTimeout(previewTimer);
+	cancelPreview();
+
+	if (!form.value?.enabled || form.value.mode !== 'managed') {
+		previewError.value = false;
+		return;
+	}
+
+	const request = previewRequest;
 	previewTimer = setTimeout(() => {
-		$axios.post(previewUrl.value, payload())
+		previewTimer = null;
+		const controller = new AbortController();
+		previewController = controller;
+
+		$axios.post(previewUrl.value, payload(), { signal: controller.signal })
 			.then((response) => {
+				if (controller.signal.aborted || request !== previewRequest) return;
+
 				rendered.value = response.data.preview;
 				previewError.value = false;
 			})
-			.catch(() => previewError.value = true);
+			.catch(() => {
+				if (controller.signal.aborted || request !== previewRequest) return;
+
+				previewError.value = true;
+			})
+			.finally(() => {
+				if (previewController === controller) previewController = null;
+			});
 	}, 250);
 }, { deep: true });
 
 onMounted(() => load());
-onUnmounted(() => clearTimeout(previewTimer));
+onUnmounted(() => cancelPreview());
 
 defineExpose({ save });
 </script>

From 11f67dfd04be2b65b05f51054085a7b910c61513 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Fri, 4 Sep 2026 16:43:24 +0200
Subject: [PATCH 23/38] Sanitize and escape llms_txt in meta partial

---
 resources/views/meta.antlers.html |  2 +-
 tests/MetaTagTest.php             | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/resources/views/meta.antlers.html b/resources/views/meta.antlers.html
index bce0109a..a3f3a02f 100644
--- a/resources/views/meta.antlers.html
+++ b/resources/views/meta.antlers.html
@@ -110,7 +110,7 @@
 {{ /if }}
 
 {{ if llms_txt }}
-    <link rel="describedby" href="{{ llms_txt }}" />
+    <link rel="describedby" href="{{ llms_txt | striptags | entities | trim }}" />
 {{ /if }}
 
 {{ if google_verification }}
diff --git a/tests/MetaTagTest.php b/tests/MetaTagTest.php
index 80cd1606..50f50066 100644
--- a/tests/MetaTagTest.php
+++ b/tests/MetaTagTest.php
@@ -942,6 +942,24 @@ public function it_applies_meta_data_hook_to_rendered_output()
         $response->assertSee('<title>Hooked Title</title>', false);
     }
 
+    #[Test]
+    public function it_escapes_the_llms_txt_meta_url()
+    {
+        $this->withoutExceptionHandling();
+        $this->prepareViews('antlers');
+
+        SeoProTags::hook('meta-data', function ($metaData, $next) {
+            $metaData['llms_txt'] = 'https://example.com/llms.txt?one=1&two="quoted"';
+
+            return $next($metaData);
+        });
+
+        $this->get('/about')->assertSee(
+            '<link rel="describedby" href="https://example.com/llms.txt?one=1&amp;two=&quot;quoted&quot;" />',
+            false,
+        );
+    }
+
     #[Test]
     public function it_applies_multiple_meta_data_hooks_in_sequence()
     {

From 0c8b18c7562fd659db17ed89d1adf4955e926786 Mon Sep 17 00:00:00 2001
From: Erin Dalzell <erin@silentz.co>
Date: Mon, 7 Sep 2026 02:13:57 -0700
Subject: [PATCH 24/38] Fall back when social image Glide fails (#660)

Co-authored-by: Duncan McClean <duncan@duncanmcclean.com>
Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
---
 resources/views/meta.antlers.html          | 26 +++++++++++++----
 tests/Fixtures/site/assets/img/corrupt.jpg |  1 +
 tests/Fixtures/site/assets/img/icon.svg    |  1 +
 tests/MetaTagTest.php                      | 33 ++++++++++++++++++++++
 4 files changed, 55 insertions(+), 6 deletions(-)
 create mode 100644 tests/Fixtures/site/assets/img/corrupt.jpg
 create mode 100644 tests/Fixtures/site/assets/img/icon.svg

diff --git a/resources/views/meta.antlers.html b/resources/views/meta.antlers.html
index 411e88d5..0120f8d6 100644
--- a/resources/views/meta.antlers.html
+++ b/resources/views/meta.antlers.html
@@ -52,10 +52,18 @@
     {{ image }}
 
         {{ if is_og_glide_enabled }}
-            {{ glide:generate :src="image" preset="seo_pro_og" absolute="true" }}
-                <meta property="og:image" content="{{ url }}" />
-                <meta property="og:image:width" content="{{ width }}" />
-                <meta property="og:image:height" content="{{ height }}" />
+            {{ glide:generate :src="image" preset="seo_pro_og" absolute="true" as="og_generated" }}
+                {{ if og_generated }}
+                    {{ og_generated }}
+                        <meta property="og:image" content="{{ url }}" />
+                        <meta property="og:image:width" content="{{ width }}" />
+                        <meta property="og:image:height" content="{{ height }}" />
+                    {{ /og_generated }}
+                {{ else }}
+                    <meta property="og:image" content="{{ permalink }}" />
+                    <meta property="og:image:width" content="{{ width }}" />
+                    <meta property="og:image:height" content="{{ height }}" />
+                {{ /if }}
             {{ /glide:generate }}
         {{ else }}
             <meta property="og:image" content="{{ permalink }}" />
@@ -65,8 +73,14 @@
         <meta property="og:image:alt" content="{{ alt | striptags | entities | trim }}" />
 
         {{ if is_twitter_glide_enabled }}
-            {{ glide:generate :src="image" preset="seo_pro_twitter" absolute="true" }}
-                <meta name="twitter:image" content="{{ url }}" />
+            {{ glide:generate :src="image" preset="seo_pro_twitter" absolute="true" as="twitter_generated" }}
+                {{ if twitter_generated }}
+                    {{ twitter_generated }}
+                        <meta name="twitter:image" content="{{ url }}" />
+                    {{ /twitter_generated }}
+                {{ else }}
+                    <meta name="twitter:image" content="{{ permalink }}" />
+                {{ /if }}
             {{ /glide:generate }}
         {{ else }}
             <meta name="twitter:image" content="{{ permalink }}" />
diff --git a/tests/Fixtures/site/assets/img/corrupt.jpg b/tests/Fixtures/site/assets/img/corrupt.jpg
new file mode 100644
index 00000000..9db012d5
--- /dev/null
+++ b/tests/Fixtures/site/assets/img/corrupt.jpg
@@ -0,0 +1 @@
+not-a-jpeg
\ No newline at end of file
diff --git a/tests/Fixtures/site/assets/img/icon.svg b/tests/Fixtures/site/assets/img/icon.svg
new file mode 100644
index 00000000..b9c97132
--- /dev/null
+++ b/tests/Fixtures/site/assets/img/icon.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="10" height="10"></svg>
diff --git a/tests/MetaTagTest.php b/tests/MetaTagTest.php
index 80cd1606..0d33c127 100644
--- a/tests/MetaTagTest.php
+++ b/tests/MetaTagTest.php
@@ -406,6 +406,39 @@ public function it_generates_social_image_with_twitter_glide_preset_only($viewTy
         $response->assertSee('<meta name="twitter:image" content="http://cool-runnings.com/img/asset/YXNzZXRzL2ltZy9zdGV0c29uLmpwZw/stetson.jpg?p=seo_pro_twitter&s=095c80594c864bedc5c4c2cb2c83ee1c" />', false);
     }
 
+    #[Test]
+    #[DataProvider('ungeneratableSocialImageProvider')]
+    public function it_falls_back_to_raw_asset_url_when_glide_cannot_generate_social_image($viewType, $image)
+    {
+        Config::set('statamic.seo-pro.assets.container', 'assets');
+
+        $this
+            ->prepareViews($viewType)
+            ->setSeoOnEntry(Entry::findByUri('/about'), [
+                'image' => $image,
+            ]);
+
+        $response = $this->get('/about');
+        $response->assertSee("<h1>{$viewType}</h1>", false);
+        $response->assertSee('<meta property="og:image" content="http://cool-runnings.com/assets/'.$image.'" />', false);
+        $response->assertSee('<meta name="twitter:image" content="http://cool-runnings.com/assets/'.$image.'" />', false);
+        $response->assertDontSee('/img/asset/', false);
+    }
+
+    public static function ungeneratableSocialImageProvider()
+    {
+        $images = [
+            'format unsupported by driver' => 'img/icon.svg',
+            'file fails to decode' => 'img/corrupt.jpg',
+        ];
+
+        foreach (static::viewScenarioProvider() as [$viewType]) {
+            foreach ($images as $reason => $image) {
+                yield "{$viewType}, {$reason}" => [$viewType, $image];
+            }
+        }
+    }
+
     #[Test]
     #[DataProvider('viewScenarioProvider')]
     public function it_generates_home_url_for_entry_meta($viewType)

From aaa2c0bc552e4e502a9780f25c440e3d68c2eae2 Mon Sep 17 00:00:00 2001
From: Duncan McClean <duncan@duncanmcclean.com>
Date: Mon, 7 Sep 2026 10:19:01 +0100
Subject: [PATCH 25/38] 7.14.1 (#662)

---
 CHANGELOG.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0c7e45fe..97289072 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Release Notes
 
+## 7.14.1 (2026-09-07)
+
+### What's fixed
+- Fall back to the raw asset URL when Glide can't generate a social image [#660](https://github.com/statamic/seo-pro/issues/660) by @edalzell
+
+
+
 ## 7.14.0 (2026-09-03)
 
 ### What's new

From 4f2569b89958a958e3a79b485bec0f9b1021daf8 Mon Sep 17 00:00:00 2001
From: Duncan McClean <duncan@duncanmcclean.com>
Date: Thu, 17 Sep 2026 09:50:38 +0100
Subject: [PATCH 26/38] Fix dark mode colours in the report Page Details modal
 (#666)

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
---
 resources/js/components/reporting/PageDetailsModal.vue | 8 ++++----
 resources/js/pages/reports/Show.vue                    | 6 +++---
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/resources/js/components/reporting/PageDetailsModal.vue b/resources/js/components/reporting/PageDetailsModal.vue
index f8e0f908..46a3601a 100644
--- a/resources/js/components/reporting/PageDetailsModal.vue
+++ b/resources/js/components/reporting/PageDetailsModal.vue
@@ -25,12 +25,12 @@ const close = () => {
 		    <div
 		        v-for="item in page.results"
 		        class="flex leading-normal p-2 rounded-lg gap-x-3"
-		        :class="{ 'bg-red-50 dark:!bg-dark-400': item.status !== 'pass' }"
+		        :class="{ 'bg-red-50 dark:bg-red-300/6': item.status !== 'pass' }"
 		    >
 			    <StatusIcon :status="item.status" class="mt-1" />
-			    <div class="flex-1 prose text-gray-700">
-				    <Heading size="sm" class="text-gray-900 dark:!text-dark-100" :text="item.description" />
-				    <Description :class="{ 'text-red-500': item.status !== 'pass' }" v-if="item.comment" :text="item.comment" />
+			    <div class="flex-1">
+				    <Heading :text="item.description" />
+				    <Description v-if="item.comment" :class="{ '!text-red-500 dark:!text-red-400': item.status !== 'pass' }" :text="item.comment" />
 			    </div>
 		    </div>
 	    </div>
diff --git a/resources/js/pages/reports/Show.vue b/resources/js/pages/reports/Show.vue
index c6f59056..e8072b18 100644
--- a/resources/js/pages/reports/Show.vue
+++ b/resources/js/pages/reports/Show.vue
@@ -108,7 +108,7 @@ watch(activeRule, (rule) => {
 					</div>
 				</div>
 
-				<div class="bg-gray-300 dark:bg-dark-650 h-4 w-full rounded-2xl mr-2">
+				<div class="bg-gray-300 dark:bg-gray-700 h-4 w-full rounded-2xl mr-2">
 					<div class="h-4 rounded-2xl" :style="`width: ${report.score}%`" :class="{ 'bg-red-500': report.score < 70, 'bg-orange': report.score < 90, 'bg-green-600': report.score >= 90 }" />
 				</div>
 
@@ -118,7 +118,7 @@ watch(activeRule, (rule) => {
 							v-for="item in report.results"
 							:key="item.handle"
 							:class="{
-								'cursor-pointer hover:bg-gray-50 dark:hover:bg-dark-600': item.is_filterable,
+								'cursor-pointer hover:bg-gray-50 dark:hover:bg-gray-800': item.is_filterable,
 							}"
 							@click="selectRule(item)"
 						>
@@ -138,7 +138,7 @@ watch(activeRule, (rule) => {
 							>
 								<div class="flex flex-col sm:flex-row sm:items-baseline sm:justify-between gap-1">
 									<span>{{ item.description }}</span>
-									<span v-if="item.comment" class="text-gray-700 dark:text-dark-175 sm:text-right text-pretty">
+									<span v-if="item.comment" class="sm:text-right text-pretty">
 										<Description :text="item.comment" />
 									</span>
 								</div>

From 4c6ffa4ebb9a248ce188c171ff0a8bc312736840 Mon Sep 17 00:00:00 2001
From: Duncan McClean <duncan@duncanmcclean.com>
Date: Thu, 17 Sep 2026 09:55:28 +0100
Subject: [PATCH 27/38] 7.14.2 (#667)

---
 CHANGELOG.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 97289072..bb457ada 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Release Notes
 
+## 7.14.2 (2026-09-17)
+
+### What's fixed
+- Fix dark mode colours in the report Page Details modal [#666](https://github.com/statamic/seo-pro/issues/666) by @duncanmcclean
+
+
+
 ## 7.14.1 (2026-09-07)
 
 ### What's fixed

From 83f2375a5d8b54fec097c1382b91dde6f42880a9 Mon Sep 17 00:00:00 2001
From: Daniel Kaufmann <hello@danielkaufmann.ch>
Date: Thu, 24 Sep 2026 10:35:47 +0200
Subject: [PATCH 28/38] Fix duplicate and contradictory messages in ideal
 length rules (#668)

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
---
 lang/da/fieldsets/content.php                 |  4 +-
 lang/de/fieldsets/content.php                 |  4 +-
 lang/de/messages.php                          | 20 +++---
 lang/de_CH/fieldsets/content.php              |  4 +-
 lang/de_CH/messages.php                       | 20 +++---
 lang/en/fieldsets/content.php                 |  4 +-
 lang/en/messages.php                          | 20 +++---
 lang/es/fieldsets/content.php                 |  4 +-
 lang/fr/fieldsets/content.php                 |  4 +-
 lang/it/fieldsets/content.php                 |  4 +-
 lang/nl/fieldsets/content.php                 |  4 +-
 lang/nl/messages.php                          | 20 +++---
 lang/pt/fieldsets/content.php                 |  4 +-
 src/Fields.php                                | 14 ++--
 .../Rules/IdealMetaDescriptionLength.php      | 34 ++++-----
 src/Reporting/Rules/IdealTitleLength.php      | 34 ++++-----
 tests/ReportTest.php                          | 71 +++++++++++++++++++
 tests/SeoProFieldtypeTest.php                 | 17 +++++
 18 files changed, 180 insertions(+), 106 deletions(-)

diff --git a/lang/da/fieldsets/content.php b/lang/da/fieldsets/content.php
index 7d4df4b6..37ef4054 100644
--- a/lang/da/fieldsets/content.php
+++ b/lang/da/fieldsets/content.php
@@ -6,10 +6,10 @@
     'enabled_instruct' => 'Hvis du deaktiverer dette element, vil det blive udelukket fra rapporter og sitemap, og forhindre at noget bliver vist gennem skabelon-tagget.',
 
     'title' => 'Meta Titel',
-    'title_instruct' => 'Hver URL på din hjemmeside bør have en unik Meta Titel, ideelt set mindre end 60 tegn lang.',
+    'title_instruct' => 'Hver URL på din hjemmeside bør have en unik Meta Titel, ideelt set :min–:max tegn lang.',
 
     'description' => 'Meta Beskrivelse',
-    'description_instruct' => 'Hver URL på din hjemmeside bør have en unik Meta Beskrivelse, ideelt set mindre end 160 tegn lang.',
+    'description_instruct' => 'Hver URL på din hjemmeside bør have en unik Meta Beskrivelse, ideelt set :min–:max tegn lang.',
 
     'site_name' => 'Webstedsnavn',
     'site_name_instruct' => 'Deaktiver webstedsnavnet for denne side, hvis det ønskes.',
diff --git a/lang/de/fieldsets/content.php b/lang/de/fieldsets/content.php
index 1d274727..17069c44 100644
--- a/lang/de/fieldsets/content.php
+++ b/lang/de/fieldsets/content.php
@@ -6,10 +6,10 @@
     'enabled_instruct' => 'Wenn du diesen Eintrag deaktivierst, wird er aus Berichten und der Sitemap ausgeschlossen – und es wird nichts über das Template-Tag ausgegeben.',
 
     'title' => 'Meta-Titel',
-    'title_instruct' => 'Jede URL auf deiner Website sollte einen eindeutigen Meta-Titel haben – idealerweise mit weniger als 60 Zeichen.',
+    'title_instruct' => 'Jede URL auf deiner Website sollte einen eindeutigen Meta-Titel haben – idealerweise mit :min–:max Zeichen.',
 
     'description' => 'Meta-Beschreibung',
-    'description_instruct' => 'Jede URL auf deiner Website sollte eine eindeutige Meta-Beschreibung haben – idealerweise mit weniger als 160 Zeichen.',
+    'description_instruct' => 'Jede URL auf deiner Website sollte eine eindeutige Meta-Beschreibung haben – idealerweise mit :min–:max Zeichen.',
 
     'site_name' => 'Website-Name',
     'site_name_instruct' => 'Deaktiviere optional den Website-Namen auf dieser Seite.',
diff --git a/lang/de/messages.php b/lang/de/messages.php
index f4f8d784..b05d6342 100644
--- a/lang/de/messages.php
+++ b/lang/de/messages.php
@@ -127,24 +127,24 @@
         'three_segment_urls_site_warning' => ':count Seite mit mehr als 3 Segmenten in der URL.|:count Seiten mit mehr als 3 Segmenten in ihren URLs.',
         'title_length_actionable_pill' => 'Titel',
         'title_length_site' => 'Titel-Tags sollten eine Länge im empfohlenen Bereich haben.',
-        'title_length_page' => 'Dein Titel-Tag ist zu lang.',
+        'title_length_page' => 'Titel-Tag liegt im empfohlenen Bereich.',
         'title_length_site_warning' => ':count Seite mit Titel-Tag außerhalb des empfohlenen Bereichs.|:count Seiten mit Titel-Tags außerhalb des empfohlenen Bereichs.',
         'title_length_site_failing' => ':count Seite mit zu langem oder fehlendem Titel-Tag.|:count Seiten mit zu langen oder fehlenden Titel-Tags.',
-        'title_length_page_warning' => 'Titel-Tag ist :length Zeichen lang (außerhalb des empfohlenen Bereichs).',
+        'title_length_page_warning' => 'Titel-Tag ist :length Zeichen lang. Die empfohlene Länge ist :min–:max.',
         'title_length_page_failing_missing' => 'Titel-Tag fehlt.',
-        'title_length_page_failing_too_short' => 'Titel-Tag ist :length Zeichen lang. Die empfohlene Länge ist ≥ :min.',
-        'title_length_page_failing_too_long' => 'Titel-Tag ist :length Zeichen lang. Die empfohlene Länge ist < :max.',
-        'title_length_page_passing' => 'Titel-Tag ist :length Zeichen lang (empfohlene Länge).',
+        'title_length_page_failing_too_short' => 'Titel-Tag ist zu kurz.',
+        'title_length_page_failing_too_long' => 'Titel-Tag ist zu lang.',
+        'title_length_page_passing' => 'Titel-Tag ist :length Zeichen lang.',
         'meta_description_length_actionable_pill' => 'Beschreibung',
         'meta_description_length_site' => 'Meta-Beschreibungen sollten eine Länge im empfohlenen Bereich haben.',
-        'meta_description_length_page' => 'Deine Meta-Beschreibung ist zu lang.',
+        'meta_description_length_page' => 'Meta-Beschreibung liegt im empfohlenen Bereich.',
         'meta_description_length_site_warning' => ':count Seite mit Meta-Beschreibung außerhalb des empfohlenen Bereichs.|:count Seiten mit Meta-Beschreibungen außerhalb des empfohlenen Bereichs.',
         'meta_description_length_site_failing' => ':count Seite mit zu langer oder fehlender Meta-Beschreibung.|:count Seiten mit zu langen oder fehlenden Meta-Beschreibungen.',
-        'meta_description_length_page_warning' => 'Meta-Beschreibung ist :length Zeichen lang (außerhalb des empfohlenen Bereichs).',
+        'meta_description_length_page_warning' => 'Meta-Beschreibung ist :length Zeichen lang. Die empfohlene Länge ist :min–:max.',
         'meta_description_length_page_failing_missing' => 'Meta-Beschreibung fehlt.',
-        'meta_description_length_page_failing_too_short' => 'Meta-Beschreibung ist :length Zeichen lang. Die empfohlene Länge ist ≥ :min.',
-        'meta_description_length_page_failing_too_long' => 'Meta-Beschreibung ist :length Zeichen lang. Die empfohlene Länge ist < :max.',
-        'meta_description_length_page_passing' => 'Meta-Beschreibung ist :length Zeichen lang (empfohlene Länge).',
+        'meta_description_length_page_failing_too_short' => 'Meta-Beschreibung ist zu kurz.',
+        'meta_description_length_page_failing_too_long' => 'Meta-Beschreibung ist zu lang.',
+        'meta_description_length_page_passing' => 'Meta-Beschreibung ist :length Zeichen lang.',
     ],
 
 ];
diff --git a/lang/de_CH/fieldsets/content.php b/lang/de_CH/fieldsets/content.php
index 1d274727..17069c44 100644
--- a/lang/de_CH/fieldsets/content.php
+++ b/lang/de_CH/fieldsets/content.php
@@ -6,10 +6,10 @@
     'enabled_instruct' => 'Wenn du diesen Eintrag deaktivierst, wird er aus Berichten und der Sitemap ausgeschlossen – und es wird nichts über das Template-Tag ausgegeben.',
 
     'title' => 'Meta-Titel',
-    'title_instruct' => 'Jede URL auf deiner Website sollte einen eindeutigen Meta-Titel haben – idealerweise mit weniger als 60 Zeichen.',
+    'title_instruct' => 'Jede URL auf deiner Website sollte einen eindeutigen Meta-Titel haben – idealerweise mit :min–:max Zeichen.',
 
     'description' => 'Meta-Beschreibung',
-    'description_instruct' => 'Jede URL auf deiner Website sollte eine eindeutige Meta-Beschreibung haben – idealerweise mit weniger als 160 Zeichen.',
+    'description_instruct' => 'Jede URL auf deiner Website sollte eine eindeutige Meta-Beschreibung haben – idealerweise mit :min–:max Zeichen.',
 
     'site_name' => 'Website-Name',
     'site_name_instruct' => 'Deaktiviere optional den Website-Namen auf dieser Seite.',
diff --git a/lang/de_CH/messages.php b/lang/de_CH/messages.php
index 26e8b86a..6d4c8307 100644
--- a/lang/de_CH/messages.php
+++ b/lang/de_CH/messages.php
@@ -127,24 +127,24 @@
         'three_segment_urls_site_warning' => ':count Seite mit mehr als 3 Segmenten in der URL.|:count Seiten mit mehr als 3 Segmenten in ihren URLs.',
         'title_length_actionable_pill' => 'Titel',
         'title_length_site' => 'Titel-Tags sollten eine Länge im empfohlenen Bereich haben.',
-        'title_length_page' => 'Dein Titel-Tag ist zu lang.',
+        'title_length_page' => 'Titel-Tag liegt im empfohlenen Bereich.',
         'title_length_site_warning' => ':count Seite mit Titel-Tag ausserhalb des empfohlenen Bereichs.|:count Seiten mit Titel-Tags ausserhalb des empfohlenen Bereichs.',
         'title_length_site_failing' => ':count Seite mit zu langem oder fehlendem Titel-Tag.|:count Seiten mit zu langen oder fehlenden Titel-Tags.',
-        'title_length_page_warning' => 'Titel-Tag ist :length Zeichen lang (ausserhalb des empfohlenen Bereichs).',
+        'title_length_page_warning' => 'Titel-Tag ist :length Zeichen lang. Die empfohlene Länge ist :min–:max.',
         'title_length_page_failing_missing' => 'Titel-Tag fehlt.',
-        'title_length_page_failing_too_short' => 'Titel-Tag ist :length Zeichen lang. Die empfohlene Länge ist ≥ :min.',
-        'title_length_page_failing_too_long' => 'Titel-Tag ist :length Zeichen lang. Die empfohlene Länge ist < :max.',
-        'title_length_page_passing' => 'Titel-Tag ist :length Zeichen lang (empfohlene Länge).',
+        'title_length_page_failing_too_short' => 'Titel-Tag ist zu kurz.',
+        'title_length_page_failing_too_long' => 'Titel-Tag ist zu lang.',
+        'title_length_page_passing' => 'Titel-Tag ist :length Zeichen lang.',
         'meta_description_length_actionable_pill' => 'Beschreibung',
         'meta_description_length_site' => 'Meta-Beschreibungen sollten eine Länge im empfohlenen Bereich haben.',
-        'meta_description_length_page' => 'Deine Meta-Beschreibung ist zu lang.',
+        'meta_description_length_page' => 'Meta-Beschreibung liegt im empfohlenen Bereich.',
         'meta_description_length_site_warning' => ':count Seite mit Meta-Beschreibung ausserhalb des empfohlenen Bereichs.|:count Seiten mit Meta-Beschreibungen ausserhalb des empfohlenen Bereichs.',
         'meta_description_length_site_failing' => ':count Seite mit zu langer oder fehlender Meta-Beschreibung.|:count Seiten mit zu langen oder fehlenden Meta-Beschreibungen.',
-        'meta_description_length_page_warning' => 'Meta-Beschreibung ist :length Zeichen lang (ausserhalb des empfohlenen Bereichs).',
+        'meta_description_length_page_warning' => 'Meta-Beschreibung ist :length Zeichen lang. Die empfohlene Länge ist :min–:max.',
         'meta_description_length_page_failing_missing' => 'Meta-Beschreibung fehlt.',
-        'meta_description_length_page_failing_too_short' => 'Meta-Beschreibung ist :length Zeichen lang. Die empfohlene Länge ist ≥ :min.',
-        'meta_description_length_page_failing_too_long' => 'Meta-Beschreibung ist :length Zeichen lang. Die empfohlene Länge ist < :max.',
-        'meta_description_length_page_passing' => 'Meta-Beschreibung ist :length Zeichen lang (empfohlene Länge).',
+        'meta_description_length_page_failing_too_short' => 'Meta-Beschreibung ist zu kurz.',
+        'meta_description_length_page_failing_too_long' => 'Meta-Beschreibung ist zu lang.',
+        'meta_description_length_page_passing' => 'Meta-Beschreibung ist :length Zeichen lang.',
     ],
 
 ];
diff --git a/lang/en/fieldsets/content.php b/lang/en/fieldsets/content.php
index 3396b7c9..91e8eee6 100644
--- a/lang/en/fieldsets/content.php
+++ b/lang/en/fieldsets/content.php
@@ -6,10 +6,10 @@
     'enabled_instruct' => 'Disabling this item will exclude it from reports and the sitemap, and prevent anything from being rendered through the template tag.',
 
     'title' => 'Meta Title',
-    'title_instruct' => 'Every URL in your site should have a unique Meta Title, ideally less than 60 characters long.',
+    'title_instruct' => 'Every URL in your site should have a unique Meta Title, ideally :min–:max characters long.',
 
     'description' => 'Meta Description',
-    'description_instruct' => 'Every URL in your site should have a unique Meta Description, ideally less than 160 characters long.',
+    'description_instruct' => 'Every URL in your site should have a unique Meta Description, ideally :min–:max characters long.',
 
     'site_name' => 'Site Name',
     'site_name_instruct' => 'Optionally disable the site name for this page.',
diff --git a/lang/en/messages.php b/lang/en/messages.php
index 9e80da34..256f707a 100644
--- a/lang/en/messages.php
+++ b/lang/en/messages.php
@@ -129,24 +129,24 @@
         'three_segment_urls_site_warning' => ':count page with more than 3 segments in URL.|:count pages with more than 3 segments in their URLs.',
         'title_length_actionable_pill' => 'Title',
         'title_length_site' => 'Title tags should be within the ideal length range.',
-        'title_length_page' => 'Your title tag is too long.',
+        'title_length_page' => 'Title tag is within the ideal length range.',
         'title_length_site_warning' => ':count page with title tag outside ideal length range.|:count pages with title tags outside ideal length range.',
         'title_length_site_failing' => ':count page with title tag that is too long or missing.|:count pages with title tags that are too long or missing.',
-        'title_length_page_warning' => 'Title tag is :length characters (outside ideal range).',
+        'title_length_page_warning' => 'Title tag is :length characters. Ideal length is :min–:max.',
         'title_length_page_failing_missing' => 'Title tag is missing.',
-        'title_length_page_failing_too_short' => 'Title tag is :length characters. Ideal length is ≥ :min.',
-        'title_length_page_failing_too_long' => 'Title tag is :length characters. Ideal length is < :max.',
-        'title_length_page_passing' => 'Title tag is :length characters (ideal length).',
+        'title_length_page_failing_too_short' => 'Title tag is too short.',
+        'title_length_page_failing_too_long' => 'Title tag is too long.',
+        'title_length_page_passing' => 'Title tag is :length characters.',
         'meta_description_length_actionable_pill' => 'Description',
         'meta_description_length_site' => 'Meta descriptions should be within the ideal length range.',
-        'meta_description_length_page' => 'Your meta description is too long.',
+        'meta_description_length_page' => 'Meta description is within the ideal length range.',
         'meta_description_length_site_warning' => ':count page with meta description outside ideal length range.|:count pages with meta descriptions outside ideal length range.',
         'meta_description_length_site_failing' => ':count page with meta description that is too long or missing.|:count pages with meta descriptions that are too long or missing.',
-        'meta_description_length_page_warning' => 'Meta description is :length characters (outside ideal range).',
+        'meta_description_length_page_warning' => 'Meta description is :length characters. Ideal length is :min–:max.',
         'meta_description_length_page_failing_missing' => 'Meta description is missing.',
-        'meta_description_length_page_failing_too_short' => 'Meta description is :length characters. Ideal length is ≥ :min.',
-        'meta_description_length_page_failing_too_long' => 'Meta description is :length characters. Ideal length is < :max.',
-        'meta_description_length_page_passing' => 'Meta description is :length characters (ideal length).',
+        'meta_description_length_page_failing_too_short' => 'Meta description is too short.',
+        'meta_description_length_page_failing_too_long' => 'Meta description is too long.',
+        'meta_description_length_page_passing' => 'Meta description is :length characters.',
     ],
 
 ];
diff --git a/lang/es/fieldsets/content.php b/lang/es/fieldsets/content.php
index f6ebace5..fff27db2 100644
--- a/lang/es/fieldsets/content.php
+++ b/lang/es/fieldsets/content.php
@@ -6,10 +6,10 @@
     'enabled_instruct' => 'Desabilitando este elemento lo excluirá de los reportes y del sitemap, además la etiqueta no renderizará ningún contenido.',
 
     'title' => 'Meta Título',
-    'title_instruct' => 'Cada URL en tu sitio debería llevar un Meta Título único, idealmente de menos de 60 caracteres.',
+    'title_instruct' => 'Cada URL en tu sitio debería llevar un Meta Título único, idealmente de :min a :max caracteres.',
 
     'description' => 'Meta Descripción',
-    'description_instruct' => 'Cada URL en tu sitio debería llevar un Meta Descripción único, idealmente de menos de 160 caracteres.',
+    'description_instruct' => 'Cada URL en tu sitio debería llevar un Meta Descripción único, idealmente de :min a :max caracteres.',
 
     'canonical_url' => 'URL Canónica',
     'canonical_url_instruct' => 'Cada URL en tu sitio debe tener una URL canónica única.',
diff --git a/lang/fr/fieldsets/content.php b/lang/fr/fieldsets/content.php
index abeef5f4..36205b86 100755
--- a/lang/fr/fieldsets/content.php
+++ b/lang/fr/fieldsets/content.php
@@ -6,10 +6,10 @@
     'enabled_instruct' => 'Si vous désactivez cet élément, il sera exclu des rapports et empêchera tout rendu par le biais de la balise de modèle.',
 
     'title' => 'Titre Meta',
-    'title_instruct' => 'Chaque URL de votre site doit avoir un titre unique, idéalement moins de 60 caractères.',
+    'title_instruct' => 'Chaque URL de votre site doit avoir un titre unique, idéalement entre :min et :max caractères.',
 
     'description' => 'Description Meta',
-    'description_instruct' => 'Chaque URL de votre site doit avoir une description méta unique, idéalement inférieure à 160 caractères.',
+    'description_instruct' => 'Chaque URL de votre site doit avoir une description méta unique, idéalement entre :min et :max caractères.',
 
     'canonical_url' => 'URL Canonique',
     'canonical_url_instruct' => 'Chaque URL de votre site doit avoir une URL canonique unique.',
diff --git a/lang/it/fieldsets/content.php b/lang/it/fieldsets/content.php
index 436d0db8..6367fb46 100644
--- a/lang/it/fieldsets/content.php
+++ b/lang/it/fieldsets/content.php
@@ -6,10 +6,10 @@
     'enabled_instruct' => 'Disattivare questo elemento lo escluderà dai report e dalla sitemap, e impedirà qualsiasi output tramite il tag template.',
 
     'title' => 'Meta Title',
-    'title_instruct' => 'Ogni URL del sito dovrebbe avere un Meta Title univoco, idealmente inferiore a 60 caratteri.',
+    'title_instruct' => 'Ogni URL del sito dovrebbe avere un Meta Title univoco, idealmente tra :min e :max caratteri.',
 
     'description' => 'Meta Description',
-    'description_instruct' => 'Ogni URL del sito dovrebbe avere una Meta Description univoca, idealmente inferiore a 160 caratteri.',
+    'description_instruct' => 'Ogni URL del sito dovrebbe avere una Meta Description univoca, idealmente tra :min e :max caratteri.',
 
     'site_name' => 'Nome del sito',
     'site_name_instruct' => 'Opzionalmente disattiva il nome del sito per questa pagina.',
diff --git a/lang/nl/fieldsets/content.php b/lang/nl/fieldsets/content.php
index f0479394..dc7739fb 100644
--- a/lang/nl/fieldsets/content.php
+++ b/lang/nl/fieldsets/content.php
@@ -4,9 +4,9 @@
     'enabled' => 'Ingeschakeld',
     'enabled_instruct' => 'Het uitschakelen van dit item zorgt ervoor dat het niet meer voorkomt in rapporten en in de sitemap en voorkomt dat er iets wordt weergegeven via de template tag.',
     'title' => 'Metatitel',
-    'title_instruct' => 'Elke URL op je site moet een unieke metatitel hebben, bij voorkeur is deze minder dan 60 tekens lang.',
+    'title_instruct' => 'Elke URL op je site moet een unieke metatitel hebben, bij voorkeur is deze :min–:max tekens lang.',
     'description' => 'Meta-omschrijving',
-    'description_instruct' => 'Elke URL op je site moet een unieke meta-omschrijving hebben, bij voorkeur is deze minder dan 160 tekens lang.',
+    'description_instruct' => 'Elke URL op je site moet een unieke meta-omschrijving hebben, bij voorkeur is deze :min–:max tekens lang.',
     'site_name' => 'Sitenaam',
     'site_name_instruct' => 'Optioneel de sitenaam uitschakelen voor deze pagina.',
     'site_name_position' => 'Positie van de sitenaam',
diff --git a/lang/nl/messages.php b/lang/nl/messages.php
index ae98db88..3f0af2d8 100644
--- a/lang/nl/messages.php
+++ b/lang/nl/messages.php
@@ -127,24 +127,24 @@
         'three_segment_urls_actionable_pill' => 'URL',
         'title_length_actionable_pill' => 'Titel',
         'title_length_site' => 'Titel-tags moeten binnen het ideale lengtebereik vallen.',
-        'title_length_page' => 'Je titel-tag is te lang.',
+        'title_length_page' => 'Titel-tag valt binnen het ideale lengtebereik.',
         'title_length_site_warning' => ":count pagina met titel-tag buiten het ideale lengtebereik.|:count pagina's met titel-tags buiten het ideale lengtebereik.",
         'title_length_site_failing' => ":count pagina met een titel-tag die te lang is of ontbreekt.|:count pagina's met titel-tags die te lang zijn of ontbreken.",
-        'title_length_page_warning' => 'Titel-tag is :length tekens (buiten ideaal bereik).',
+        'title_length_page_warning' => 'Titel-tag is :length tekens. Ideale lengte is :min–:max.',
         'title_length_page_failing_missing' => 'Titel-tag ontbreekt.',
-        'title_length_page_failing_too_short' => 'Titel-tag is :length tekens. Ideale lengte is ≥ :min.',
-        'title_length_page_failing_too_long' => 'Titel-tag is :length tekens. Ideale lengte is < :max.',
-        'title_length_page_passing' => 'Titel-tag is :length tekens (ideale lengte).',
+        'title_length_page_failing_too_short' => 'Titel-tag is te kort.',
+        'title_length_page_failing_too_long' => 'Titel-tag is te lang.',
+        'title_length_page_passing' => 'Titel-tag is :length tekens.',
         'meta_description_length_actionable_pill' => 'Beschrijving',
         'meta_description_length_site' => 'Metabeschrijvingen moeten binnen het ideale lengtebereik vallen.',
-        'meta_description_length_page' => 'Je metabeschrijving is te lang.',
+        'meta_description_length_page' => 'Metabeschrijving valt binnen het ideale lengtebereik.',
         'meta_description_length_site_warning' => ":count pagina met metabeschrijving buiten het ideale lengtebereik.|:count pagina's met metabeschrijvingen buiten het ideale lengtebereik.",
         'meta_description_length_site_failing' => ":count pagina met een metabeschrijving die te lang is of ontbreekt.|:count pagina's met metabeschrijvingen die te lang zijn of ontbreken.",
-        'meta_description_length_page_warning' => 'Metabeschrijving is :length tekens (buiten ideaal bereik).',
+        'meta_description_length_page_warning' => 'Metabeschrijving is :length tekens. Ideale lengte is :min–:max.',
         'meta_description_length_page_failing_missing' => 'Metabeschrijving ontbreekt.',
-        'meta_description_length_page_failing_too_short' => 'Metabeschrijving is :length tekens. Ideale lengte is ≥ :min.',
-        'meta_description_length_page_failing_too_long' => 'Metabeschrijving is :length tekens. Ideale lengte is < :max.',
-        'meta_description_length_page_passing' => 'Metabeschrijving is :length tekens (ideale lengte).',
+        'meta_description_length_page_failing_too_short' => 'Metabeschrijving is te kort.',
+        'meta_description_length_page_failing_too_long' => 'Metabeschrijving is te lang.',
+        'meta_description_length_page_passing' => 'Metabeschrijving is :length tekens.',
     ],
 
 ];
diff --git a/lang/pt/fieldsets/content.php b/lang/pt/fieldsets/content.php
index 264d7697..7e11c9f6 100644
--- a/lang/pt/fieldsets/content.php
+++ b/lang/pt/fieldsets/content.php
@@ -6,10 +6,10 @@
     'enabled_instruct' => 'Desativando este item irá excluí-lo dos relatórios e do sitemap e impedir que qualquer coisa seja renderizada por meio da tag de modelo.',
 
     'title' => 'Meta Título',
-    'title_instruct' => 'Cada URL em seu site deve ter um Meta Título exclusivo, idealmente com menos de 60 caracteres.',
+    'title_instruct' => 'Cada URL em seu site deve ter um Meta Título exclusivo, idealmente com :min a :max caracteres.',
 
     'description' => 'Meta Descrição',
-    'description_instruct' => 'Cada URL em seu site deve ter uma Meta Descrição exclusiva, idealmente com menos de 160 caracteres.',
+    'description_instruct' => 'Cada URL em seu site deve ter uma Meta Descrição exclusiva, idealmente com :min a :max caracteres.',
 
     'canonical_url' => 'URL Canônica',
     'canonical_url_instruct' => 'Cada URL em seu site deve ter uma URL canônica única.',
diff --git a/src/Fields.php b/src/Fields.php
index c1cc8a18..ef03461e 100644
--- a/src/Fields.php
+++ b/src/Fields.php
@@ -64,13 +64,16 @@ public function getConfig()
                         'handle' => 'title',
                         'field' => [
                             'display' => __("seo-pro::fieldsets/{$langFile}.title"),
-                            'instructions' => __("seo-pro::fieldsets/{$langFile}.title_instruct"),
+                            'instructions' => __("seo-pro::fieldsets/{$langFile}.title_instruct", [
+                                'min' => config('statamic.seo-pro.reports.title_length.warn_min', 30),
+                                'max' => config('statamic.seo-pro.reports.title_length.pass_max', 60),
+                            ]),
                             'type' => 'seo_pro_source',
                             'disableable' => true,
                             'localizable' => true,
                             'field' => [
                                 'type' => 'text',
-                                'character_limit' => 60,
+                                'character_limit' => config('statamic.seo-pro.reports.title_length.pass_max', 60),
                             ],
                             'always_save' => true,
                             'unless' => ['enabled' => 'equals false'],
@@ -80,12 +83,15 @@ public function getConfig()
                         'handle' => 'description',
                         'field' => [
                             'display' => __("seo-pro::fieldsets/{$langFile}.description"),
-                            'instructions' => __("seo-pro::fieldsets/{$langFile}.description_instruct"),
+                            'instructions' => __("seo-pro::fieldsets/{$langFile}.description_instruct", [
+                                'min' => config('statamic.seo-pro.reports.meta_description_length.warn_min', 120),
+                                'max' => config('statamic.seo-pro.reports.meta_description_length.pass_max', 160),
+                            ]),
                             'type' => 'seo_pro_source',
                             'localizable' => true,
                             'field' => [
                                 'type' => 'textarea',
-                                'character_limit' => 160,
+                                'character_limit' => config('statamic.seo-pro.reports.meta_description_length.pass_max', 160),
                             ],
                             'always_save' => true,
                             'unless' => ['enabled' => 'equals false'],
diff --git a/src/Reporting/Rules/IdealMetaDescriptionLength.php b/src/Reporting/Rules/IdealMetaDescriptionLength.php
index 2af7e41b..ff41ca54 100644
--- a/src/Reporting/Rules/IdealMetaDescriptionLength.php
+++ b/src/Reporting/Rules/IdealMetaDescriptionLength.php
@@ -27,21 +27,12 @@ public function pageDescription()
             return __('seo-pro::messages.rules.meta_description_length_page_failing_missing');
         }
 
-        $warnMin = config('statamic.seo-pro.reports.meta_description_length.warn_min', 120);
-        $warnMax = config('statamic.seo-pro.reports.meta_description_length.warn_max', 240);
-
-        if ($this->length < $warnMin) {
-            return __('seo-pro::messages.rules.meta_description_length_page_failing_too_short', [
-                'length' => $this->length,
-                'min' => $warnMin,
-            ]);
+        if ($this->length < config('statamic.seo-pro.reports.meta_description_length.warn_min', 120)) {
+            return __('seo-pro::messages.rules.meta_description_length_page_failing_too_short');
         }
 
-        if ($this->length > $warnMax) {
-            return __('seo-pro::messages.rules.meta_description_length_page_failing_too_long', [
-                'length' => $this->length,
-                'max' => $warnMax,
-            ]);
+        if ($this->length > config('statamic.seo-pro.reports.meta_description_length.pass_max', 160)) {
+            return __('seo-pro::messages.rules.meta_description_length_page_failing_too_long');
         }
 
         return __('seo-pro::messages.rules.meta_description_length_page');
@@ -111,16 +102,11 @@ public function loadSite($data)
 
     public function pageFailingComment()
     {
-        $warnMax = config('statamic.seo-pro.reports.meta_description_length.warn_max', 240);
-
         if ($this->length === 0) {
-            return __('seo-pro::messages.rules.meta_description_length_page_failing_missing');
+            return '';
         }
 
-        return __('seo-pro::messages.rules.meta_description_length_page_failing_too_long', [
-            'length' => $this->length,
-            'max' => $warnMax,
-        ]);
+        return $this->pageWarningComment();
     }
 
     public function pagePassingComment()
@@ -130,7 +116,11 @@ public function pagePassingComment()
 
     public function pageWarningComment()
     {
-        return __('seo-pro::messages.rules.meta_description_length_page_warning', ['length' => $this->length]);
+        return __('seo-pro::messages.rules.meta_description_length_page_warning', [
+            'length' => $this->length,
+            'min' => config('statamic.seo-pro.reports.meta_description_length.warn_min', 120),
+            'max' => config('statamic.seo-pro.reports.meta_description_length.pass_max', 160),
+        ]);
     }
 
     public function siteWarningComment()
@@ -144,7 +134,7 @@ public function siteWarningComment()
 
     public function processPage()
     {
-        $this->length = strlen($this->page->get('description', ''));
+        $this->length = mb_strlen($this->page->get('description') ?? '');
     }
 
     public function pageStatus()
diff --git a/src/Reporting/Rules/IdealTitleLength.php b/src/Reporting/Rules/IdealTitleLength.php
index 6795c843..4b726f0d 100644
--- a/src/Reporting/Rules/IdealTitleLength.php
+++ b/src/Reporting/Rules/IdealTitleLength.php
@@ -27,21 +27,12 @@ public function pageDescription()
             return __('seo-pro::messages.rules.title_length_page_failing_missing');
         }
 
-        $warnMin = config('statamic.seo-pro.reports.title_length.warn_min', 30);
-        $warnMax = config('statamic.seo-pro.reports.title_length.warn_max', 70);
-
-        if ($this->length < $warnMin) {
-            return __('seo-pro::messages.rules.title_length_page_failing_too_short', [
-                'length' => $this->length,
-                'min' => $warnMin,
-            ]);
+        if ($this->length < config('statamic.seo-pro.reports.title_length.warn_min', 30)) {
+            return __('seo-pro::messages.rules.title_length_page_failing_too_short');
         }
 
-        if ($this->length > $warnMax) {
-            return __('seo-pro::messages.rules.title_length_page_failing_too_long', [
-                'length' => $this->length,
-                'max' => $warnMax,
-            ]);
+        if ($this->length > config('statamic.seo-pro.reports.title_length.pass_max', 60)) {
+            return __('seo-pro::messages.rules.title_length_page_failing_too_long');
         }
 
         return __('seo-pro::messages.rules.title_length_page');
@@ -111,16 +102,11 @@ public function loadSite($data)
 
     public function pageFailingComment()
     {
-        $warnMax = config('statamic.seo-pro.reports.title_length.warn_max', 70);
-
         if ($this->length === 0) {
-            return __('seo-pro::messages.rules.title_length_page_failing_missing');
+            return '';
         }
 
-        return __('seo-pro::messages.rules.title_length_page_failing_too_long', [
-            'length' => $this->length,
-            'max' => $warnMax,
-        ]);
+        return $this->pageWarningComment();
     }
 
     public function pagePassingComment()
@@ -130,7 +116,11 @@ public function pagePassingComment()
 
     public function pageWarningComment()
     {
-        return __('seo-pro::messages.rules.title_length_page_warning', ['length' => $this->length]);
+        return __('seo-pro::messages.rules.title_length_page_warning', [
+            'length' => $this->length,
+            'min' => config('statamic.seo-pro.reports.title_length.warn_min', 30),
+            'max' => config('statamic.seo-pro.reports.title_length.pass_max', 60),
+        ]);
     }
 
     public function siteWarningComment()
@@ -144,7 +134,7 @@ public function siteWarningComment()
 
     public function processPage()
     {
-        $this->length = strlen($this->page->get('title', ''));
+        $this->length = mb_strlen($this->page->get('title') ?? '');
     }
 
     public function pageStatus()
diff --git a/tests/ReportTest.php b/tests/ReportTest.php
index 231659f6..dc445b34 100644
--- a/tests/ReportTest.php
+++ b/tests/ReportTest.php
@@ -467,6 +467,57 @@ public function it_properly_reports_on_description_length()
         ], $this->getReportResult('IdealMetaDescriptionLength'));
     }
 
+    #[Test]
+    public function it_shows_page_descriptions_and_comments_for_title_length()
+    {
+        $this->generateEntries(5);
+
+        $titles = [null, str_repeat('a', 5), str_repeat('a', 45), str_repeat('a', 65), str_repeat('a', 80)];
+
+        Entry::all()->values()->each(fn ($entry, $i) => $entry->set('seo', ['title' => $titles[$i]])->save());
+
+        $this->assertPageResults('IdealTitleLength', [
+            ['status' => 'fail', 'description' => 'Title tag is missing.', 'comment' => ''],
+            ['status' => 'warning', 'description' => 'Title tag is too short.', 'comment' => 'Title tag is 5 characters. Ideal length is 30–60.'],
+            ['status' => 'pass', 'description' => 'Title tag is within the ideal length range.', 'comment' => 'Title tag is 45 characters.'],
+            ['status' => 'warning', 'description' => 'Title tag is too long.', 'comment' => 'Title tag is 65 characters. Ideal length is 30–60.'],
+            ['status' => 'fail', 'description' => 'Title tag is too long.', 'comment' => 'Title tag is 80 characters. Ideal length is 30–60.'],
+        ]);
+    }
+
+    #[Test]
+    public function it_shows_page_descriptions_and_comments_for_description_length()
+    {
+        $this->generateEntries(5);
+
+        $descriptions = [null, str_repeat('a', 50), str_repeat('a', 140), str_repeat('a', 200), str_repeat('a', 260)];
+
+        Entry::all()->values()->each(fn ($entry, $i) => $entry->set('seo', ['description' => $descriptions[$i]])->save());
+
+        $this->assertPageResults('IdealMetaDescriptionLength', [
+            ['status' => 'fail', 'description' => 'Meta description is missing.', 'comment' => ''],
+            ['status' => 'warning', 'description' => 'Meta description is too short.', 'comment' => 'Meta description is 50 characters. Ideal length is 120–160.'],
+            ['status' => 'pass', 'description' => 'Meta description is within the ideal length range.', 'comment' => 'Meta description is 140 characters.'],
+            ['status' => 'warning', 'description' => 'Meta description is too long.', 'comment' => 'Meta description is 200 characters. Ideal length is 120–160.'],
+            ['status' => 'fail', 'description' => 'Meta description is too long.', 'comment' => 'Meta description is 260 characters. Ideal length is 120–160.'],
+        ]);
+    }
+
+    #[Test]
+    public function it_counts_multibyte_characters_when_measuring_length()
+    {
+        $this->generateEntries(1);
+
+        // 35 characters, but 70 bytes.
+        Entry::all()->each(fn ($entry) => $entry->set('seo', [
+            'title' => str_repeat('ü', 35),
+            'description' => str_repeat('ü', 140),
+        ])->save());
+
+        $this->assertEquals('pass', $this->getPageResults('IdealTitleLength')->first()['status']);
+        $this->assertEquals('pass', $this->getPageResults('IdealMetaDescriptionLength')->first()['status']);
+    }
+
     #[Test]
     public function it_filters_pages_down_to_those_failing_a_rule()
     {
@@ -571,6 +622,26 @@ private function generateTerms($count)
         return $this;
     }
 
+    private function assertPageResults($rule, $expected)
+    {
+        $this->assertEqualsCanonicalizing(
+            collect($expected)->map(fn ($result) => json_encode($result))->all(),
+            $this->getPageResults($rule)->map(fn ($result) => json_encode($result))->all(),
+        );
+    }
+
+    private function getPageResults($rule)
+    {
+        if (! Report::find(1)) {
+            Report::create()->save()->generate();
+        }
+
+        return Report::find(1)->pages()
+            ->map(fn ($page) => collect($page->getRuleResults())->firstWhere('handle', $rule))
+            ->map(fn ($result) => ['status' => $result['status'], 'description' => $result['description'], 'comment' => $result['comment']])
+            ->values();
+    }
+
     private function getReportResult($key)
     {
         Carbon::setTestNow($now = now());
diff --git a/tests/SeoProFieldtypeTest.php b/tests/SeoProFieldtypeTest.php
index 50e94186..d83ccc8b 100644
--- a/tests/SeoProFieldtypeTest.php
+++ b/tests/SeoProFieldtypeTest.php
@@ -8,6 +8,7 @@
 use Statamic\Facades\Entry;
 use Statamic\Fields\Field;
 use Statamic\Fields\Value;
+use Statamic\SeoPro\Fields;
 use Statamic\SeoPro\Fieldtypes\SeoProFieldtype;
 
 class SeoProFieldtypeTest extends TestCase
@@ -83,4 +84,20 @@ public function it_augments_for_api_routes()
         $this->assertEquals('Bar', (string) $augment['description']);
         $this->assertEquals('Cool Runnings', (string) $augment['site_name']); // Site default
     }
+
+    #[Test]
+    public function it_uses_the_ideal_length_range_from_the_config_in_the_title_and_description_fields()
+    {
+        config()->set('statamic.seo-pro.reports.title_length.warn_min', 20);
+        config()->set('statamic.seo-pro.reports.title_length.pass_max', 50);
+        config()->set('statamic.seo-pro.reports.meta_description_length.warn_min', 100);
+        config()->set('statamic.seo-pro.reports.meta_description_length.pass_max', 150);
+
+        $fields = collect(Fields::new([])->getConfig())->flatMap(fn ($section) => $section['fields'])->keyBy('handle');
+
+        $this->assertEquals('Every URL in your site should have a unique Meta Title, ideally 20–50 characters long.', $fields['title']['field']['instructions']);
+        $this->assertEquals('Every URL in your site should have a unique Meta Description, ideally 100–150 characters long.', $fields['description']['field']['instructions']);
+        $this->assertEquals(50, $fields['title']['field']['field']['character_limit']);
+        $this->assertEquals(150, $fields['description']['field']['field']['character_limit']);
+    }
 }

From 4bb66a3fe2d8fb59399dfdba257386b2c3018d7f Mon Sep 17 00:00:00 2001
From: Duncan McClean <duncan@duncanmcclean.com>
Date: Thu, 24 Sep 2026 09:41:41 +0100
Subject: [PATCH 29/38] Skip redirects that resolve to the URL being visited
 (#673)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
---
 composer.json                           |  2 +-
 src/Redirects/HandleRedirects.php       | 19 ++++++--
 tests/Redirects/HandleRedirectsTest.php | 63 +++++++++++++++++++++++++
 3 files changed, 79 insertions(+), 5 deletions(-)

diff --git a/composer.json b/composer.json
index 8bda267c..a05b0405 100644
--- a/composer.json
+++ b/composer.json
@@ -22,7 +22,7 @@
         }
     },
     "require": {
-        "statamic/cms": "^6.25",
+        "statamic/cms": "^6.34",
         "spatie/simple-excel": "^3.9"
     },
     "require-dev": {
diff --git a/src/Redirects/HandleRedirects.php b/src/Redirects/HandleRedirects.php
index be722236..0f20b913 100644
--- a/src/Redirects/HandleRedirects.php
+++ b/src/Redirects/HandleRedirects.php
@@ -27,14 +27,17 @@ public function __invoke(Request $request)
             return;
         }
 
+        $destination = $this->resolveDestination($redirect, $path, $request);
+
+        if ($this->redirectsToItself($destination, $request)) {
+            return;
+        }
+
         if (config('statamic.seo-pro.redirects.track_hits', true)) {
             RecordRedirectHit::dispatch($redirect->id());
         }
 
-        return redirect(
-            $this->resolveDestination($redirect, $path, $request),
-            $redirect->responseCode(),
-        );
+        return redirect($destination, $redirect->responseCode());
     }
 
     private function stripSitePrefix(string $requestPath, SiteInstance $site): string
@@ -111,4 +114,12 @@ private function resolveDestination(Redirect $redirect, string $path, Request $r
 
         return $destination;
     }
+
+    private function redirectsToItself(string $destination, Request $request): bool
+    {
+        return Str::of(url($destination))
+            ->before('?')
+            ->rtrim('/')
+            ->exactly($request->url());
+    }
 }
diff --git a/tests/Redirects/HandleRedirectsTest.php b/tests/Redirects/HandleRedirectsTest.php
index 2b7c68f7..2463bef2 100644
--- a/tests/Redirects/HandleRedirectsTest.php
+++ b/tests/Redirects/HandleRedirectsTest.php
@@ -4,6 +4,7 @@
 
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Queue;
+use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\Test;
 use Statamic\Facades\Collection;
 use Statamic\Facades\Entry;
@@ -87,6 +88,52 @@ public function it_redirects_when_rule_has_trailing_slash_but_url_does_not()
             ->assertStatus(301);
     }
 
+    /**
+     * @see https://github.com/statamic/seo-pro/issues/672
+     */
+    #[Test]
+    #[DataProvider('selfReferencingRedirectProvider')]
+    public function it_does_not_redirect_to_the_url_being_visited(string $source, string $destination, string $url)
+    {
+        Facades\Redirect::make()
+            ->id('abc')
+            ->source($source)
+            ->destination($destination)
+            ->responseCode(301)
+            ->enabled(true)
+            ->save();
+
+        $this->get($url)->assertNotFound();
+    }
+
+    public static function selfReferencingRedirectProvider(): array
+    {
+        return [
+            'same url' => ['/foo', '/foo', '/foo'],
+            'url differing by case' => ['/Foo', '/foo', '/foo'],
+            'url differing by trailing slash' => ['/foo', '/foo/', '/foo'],
+            'absolute url' => ['/Foo', 'http://cool-runnings.com/foo', '/foo'],
+            'wildcard' => ['/blog/*', '/blog/$1', '/blog/hello-world'],
+        ];
+    }
+
+    #[Test]
+    public function it_redirects_urls_differing_from_the_destination_by_case()
+    {
+        Facades\Redirect::make()
+            ->id('abc')
+            ->source('/Foo')
+            ->destination('/foo')
+            ->responseCode(301)
+            ->enabled(true)
+            ->save();
+
+        $this
+            ->get('/Foo')
+            ->assertRedirect('/foo')
+            ->assertStatus(301);
+    }
+
     #[Test]
     public function it_does_not_redirect_to_inactive_redirect()
     {
@@ -190,6 +237,22 @@ public function it_redirects_to_absolute_urls()
             ->assertRedirect('https://example.com/new-url');
     }
 
+    #[Test]
+    public function it_redirects_to_the_same_path_on_another_domain()
+    {
+        Facades\Redirect::make()
+            ->id('abc')
+            ->source('/foo')
+            ->destination('https://example.com/foo')
+            ->responseCode(301)
+            ->enabled(true)
+            ->save();
+
+        $this
+            ->get('/foo')
+            ->assertRedirect('https://example.com/foo');
+    }
+
     #[Test]
     public function it_dispatches_a_job_to_record_the_hit()
     {

From 8d5fe72007e165d82fbafc1a3c515d0a96c6fd93 Mon Sep 17 00:00:00 2001
From: Duncan McClean <duncan@duncanmcclean.com>
Date: Thu, 24 Sep 2026 09:49:52 +0100
Subject: [PATCH 30/38] 7.14.3 (#674)

---
 CHANGELOG.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index bb457ada..cae76bd2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Release Notes
 
+## 7.14.3 (2026-09-24)
+
+### What's fixed
+- Fix duplicate and contradictory messages in ideal length rules [#668](https://github.com/statamic/seo-pro/issues/668) by @helloDanuk
+- Skip redirects that resolve to the URL being visited [#673](https://github.com/statamic/seo-pro/issues/673) by @duncanmcclean
+
+
+
 ## 7.14.2 (2026-09-17)
 
 ### What's fixed

From 9f9d58e450ab3ee382a15b1d22d98364a0635ac1 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Thu, 24 Sep 2026 13:37:11 +0200
Subject: [PATCH 31/38] Fix tests

---
 tests/Localized/LlmsTest.php | 13 +----------
 tests/TestCase.php           | 43 +++++++++++++++++++++++++++++++++++-
 2 files changed, 43 insertions(+), 13 deletions(-)

diff --git a/tests/Localized/LlmsTest.php b/tests/Localized/LlmsTest.php
index 26bb3879..1cbcefc5 100644
--- a/tests/Localized/LlmsTest.php
+++ b/tests/Localized/LlmsTest.php
@@ -6,23 +6,14 @@
 use Illuminate\Support\Facades\Route;
 use PHPUnit\Framework\Attributes\Test;
 use Statamic\Facades\Site;
-use Statamic\Facades\URL;
 use Statamic\Facades\YAML;
 use Statamic\SeoPro\Http\Controllers\LlmsController;
 use Statamic\SeoPro\Llms\Llms;
 use Statamic\SeoPro\Llms\LlmsDocument;
-use Statamic\SeoPro\Llms\LlmsRoutes;
 use Statamic\SeoPro\Llms\LlmsTxtGenerator;
 
 class LlmsTest extends LocalizedTestCase
 {
-    protected function setUp(): void
-    {
-        parent::setUp();
-
-        LlmsRoutes::register(Site::all());
-    }
-
     protected function tearDown(): void
     {
         $this->files->delete(public_path('llms.txt'));
@@ -62,9 +53,7 @@ public function routes_support_deeply_nested_site_paths()
             'url' => 'http://cool-runnings.com/regions/europe/de/',
         ];
 
-        Site::setSites($sites);
-        URL::clearUrlCache();
-        LlmsRoutes::register(Site::all());
+        $this->bootWithSites($sites);
 
         Llms::saveWithoutGenerated(new LlmsDocument([
             'enabled' => true,
diff --git a/tests/TestCase.php b/tests/TestCase.php
index d8f11b38..f3524750 100644
--- a/tests/TestCase.php
+++ b/tests/TestCase.php
@@ -13,6 +13,7 @@
 use Statamic\SeoPro\ServiceProvider;
 use Statamic\SeoPro\SiteDefaults\SiteDefaults;
 use Statamic\Testing\AddonTestCase;
+use Symfony\Component\Yaml\Yaml as SymfonyYaml;
 
 abstract class TestCase extends AddonTestCase
 {
@@ -20,6 +21,11 @@ abstract class TestCase extends AddonTestCase
     protected $files;
     protected string $addonServiceProvider = ServiceProvider::class;
 
+    /**
+     * Sites the app boots with. Defaults to the fixture's sites.
+     */
+    protected ?array $sites = null;
+
     protected function setUp(): void
     {
         parent::setUp();
@@ -29,7 +35,7 @@ protected function setUp(): void
         $this->copyDirectoryFromFixture('content');
         $this->copyDirectoryFromFixture('assets');
 
-        Site::setSites(YAML::file("{$this->siteFixturePath}/resources/sites.yaml")->parse());
+        Site::setSites($this->sites());
 
         URL::clearUrlCache();
 
@@ -40,6 +46,30 @@ protected function setUp(): void
         $this->addTestResponseMacros();
     }
 
+    protected function sites(): array
+    {
+        return $this->sites ?? YAML::file("{$this->siteFixturePath}/resources/sites.yaml")->parse();
+    }
+
+    /**
+     * Boot the app again with the given sites, so anything registered while
+     * booting, such as routes, is rebuilt against them.
+     */
+    protected function bootWithSites(array $sites): void
+    {
+        $this->sites = $sites;
+
+        $this->refreshApplication();
+
+        $this->files = app(Filesystem::class);
+
+        Site::setSites($this->sites());
+
+        URL::clearUrlCache();
+
+        $this->addGqlMacros();
+    }
+
     protected function copyDirectoryFromFixture($directory)
     {
         if (base_path($directory)) {
@@ -87,6 +117,17 @@ protected function getEnvironmentSetUp($app)
             $files->copy("{$this->siteFixturePath}/config/{$config}.php", config_path("{$config}.php"));
             $app['config']->set(str_replace('/', '.', $config), require ("{$this->siteFixturePath}/config/{$config}.php"));
         }
+
+        // Statamic reads the sites from here while booting. They need to be in place
+        // before anything that depends on them is registered, like the site aware
+        // llms.txt routes, which have to be registered before Statamic's catch-all.
+        $files->ensureDirectoryExists($app->resourcePath());
+        $files->put(
+            $app->resourcePath('sites.yaml'),
+            $this->sites === null
+                ? $files->get("{$this->siteFixturePath}/resources/sites.yaml")
+                : SymfonyYaml::dump($this->sites, 5, 2),
+        );
     }
 
     protected function setSeoInSiteDefaults($seo)

From 5929842af2c1f63a746cb5f8fcdc1dee9694a6c4 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Thu, 24 Sep 2026 13:37:20 +0200
Subject: [PATCH 32/38] Tweak validation and fix console errors

---
 resources/js/pages/llms/Tab.vue            | 22 ++++++++++------
 src/Http/Controllers/CP/LlmsController.php |  5 ++--
 tests/LlmsCpTest.php                       | 30 ++++++++++++++++++++++
 3 files changed, 47 insertions(+), 10 deletions(-)

diff --git a/resources/js/pages/llms/Tab.vue b/resources/js/pages/llms/Tab.vue
index 9cb6c002..b86da6f9 100644
--- a/resources/js/pages/llms/Tab.vue
+++ b/resources/js/pages/llms/Tab.vue
@@ -44,7 +44,7 @@ const site = ref('');
 const collectionOptions = ref([]);
 const entryOptions = ref([]);
 const errors = ref({});
-const previewError = ref(false);
+const previewError = ref(null);
 const hydrating = ref(false);
 const dirtyStateName = 'seo-pro-llms';
 
@@ -82,7 +82,7 @@ function hydrate(data) {
 	collectionOptions.value = data.collectionOptions;
 	entryOptions.value = data.entryOptions;
 	errors.value = {};
-	previewError.value = false;
+	previewError.value = null;
 	loaded.value = true;
 	Statamic.$dirty.remove(dirtyStateName);
 	queueMicrotask(() => hydrating.value = false);
@@ -189,7 +189,7 @@ function removeSection(index) {
 }
 
 function addLink(section) {
-	section.links.push({ title: '', url: 'https://', description: '' });
+	section.links.push({ title: '', url: '', description: '' });
 }
 
 function removeLink(section, index) {
@@ -203,7 +203,7 @@ watch(form, () => {
 	cancelPreview();
 
 	if (!form.value?.enabled || form.value.mode !== 'managed') {
-		previewError.value = false;
+		previewError.value = null;
 		return;
 	}
 
@@ -217,13 +217,18 @@ watch(form, () => {
 			.then((response) => {
 				if (controller.signal.aborted || request !== previewRequest) return;
 
+				if (response.data.error) {
+					previewError.value = response.data.error;
+					return;
+				}
+
 				rendered.value = response.data.preview;
-				previewError.value = false;
+				previewError.value = null;
 			})
-			.catch(() => {
+			.catch((error) => {
 				if (controller.signal.aborted || request !== previewRequest) return;
 
-				previewError.value = true;
+				previewError.value = error.response?.data?.message ?? __('seo-pro::messages.llms_txt.preview_unavailable');
 			})
 			.finally(() => {
 				if (previewController === controller) previewController = null;
@@ -378,7 +383,7 @@ defineExpose({ save });
 										<div v-for="(link, linkIndex) in section.links" :key="linkIndex" class="rounded-lg border p-4 space-y-3 dark:border-gray-700">
 											<div class="grid gap-3 md:grid-cols-2">
 												<Field :label="__('seo-pro::messages.llms_txt.link_title')"><Input v-model="link.title" /></Field>
-												<Field :label="__('seo-pro::messages.llms_txt.link_url')"><Input v-model="link.url" class="font-mono" /></Field>
+												<Field :label="__('seo-pro::messages.llms_txt.link_url')"><Input v-model="link.url" class="font-mono" placeholder="https://" /></Field>
 											</div>
 											<div class="flex gap-2">
 												<Field class="flex-1" :label="__('seo-pro::messages.llms_txt.link_description')"><Textarea v-model="link.description" rows="2" /></Field>
@@ -406,6 +411,7 @@ defineExpose({ save });
 							</div>
 							<Badge v-if="previewError" color="red" :text="__('seo-pro::messages.llms_txt.preview_unavailable')" />
 						</div>
+						<Alert v-if="previewError" class="mb-4" variant="warning" :text="previewError" />
 						<CodeEditor :model-value="rendered" mode="markdown" :allow-mode-selection="false" :show-mode-label="false" read-only :title="__('seo-pro::messages.llms_txt.preview_title')" />
 					</Panel>
 				</template>
diff --git a/src/Http/Controllers/CP/LlmsController.php b/src/Http/Controllers/CP/LlmsController.php
index acca32a8..d69b6a78 100644
--- a/src/Http/Controllers/CP/LlmsController.php
+++ b/src/Http/Controllers/CP/LlmsController.php
@@ -107,9 +107,10 @@ public function preview(Request $request)
         $document = new LlmsDocument($this->validated($request, $site, false));
 
         try {
-            return ['preview' => $this->renderer->render($document, $site)];
+            return ['preview' => $this->renderer->render($document, $site), 'error' => null];
         } catch (Throwable $exception) {
-            throw ValidationException::withMessages(['document' => $exception->getMessage()]);
+            // Incomplete drafts are expected while editing, so report why instead of failing the request.
+            return ['preview' => null, 'error' => $exception->getMessage()];
         }
     }
 
diff --git a/tests/LlmsCpTest.php b/tests/LlmsCpTest.php
index e3bec343..0db2747a 100644
--- a/tests/LlmsCpTest.php
+++ b/tests/LlmsCpTest.php
@@ -156,6 +156,36 @@ public function enabled_custom_mode_requires_an_h1_after_antlers_is_parsed()
             ->assertJsonValidationErrors('document');
     }
 
+    #[Test]
+    public function previewing_an_incomplete_draft_reports_why_it_cannot_be_rendered()
+    {
+        $payload = $this->payload([
+            'sections' => [
+                ['title' => '', 'links' => [['title' => 'Docs', 'url' => 'https://example.com/docs', 'description' => '']]],
+            ],
+        ]);
+
+        $this->actingAs(User::make()->makeSuper()->save())
+            ->postJson(cp_route('seo-pro.llms.preview'), $payload)
+            ->assertOk()
+            ->assertJsonPath('preview', null)
+            ->assertJsonPath('error', 'Every non-empty llms.txt section requires a title.');
+
+        $this->patchJson(cp_route('seo-pro.llms.update'), $payload)
+            ->assertUnprocessable()
+            ->assertJsonValidationErrors('document');
+    }
+
+    #[Test]
+    public function previewing_a_valid_draft_returns_the_rendered_document()
+    {
+        $this->actingAs(User::make()->makeSuper()->save())
+            ->postJson(cp_route('seo-pro.llms.preview'), $this->payload())
+            ->assertOk()
+            ->assertJsonPath('preview', "# Cool Runnings\n")
+            ->assertJsonPath('error', null);
+    }
+
     #[Test]
     public function users_without_permission_cannot_manage_llms_txt()
     {

From 25d043119ea1e19f6cbf5d7a69f0c630675ef7ad Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Thu, 24 Sep 2026 13:42:25 +0200
Subject: [PATCH 33/38] Document llms.txt support

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 DOCUMENTATION.md | 61 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md
index 4a4ccf8c..256b62d8 100644
--- a/DOCUMENTATION.md
+++ b/DOCUMENTATION.md
@@ -235,6 +235,67 @@ php please seo-pro:generate:robots-txt
 
 Robots settings and generation metadata use Statamic's addon settings repository. By default, they are stored with the other SEO Pro settings in `resources/addons/seo-pro.yaml`.
 
+## llms.txt
+
+SEO Pro can publish an [`llms.txt`](https://llmstxt.org) document for each Statamic site. The feature is opt-in and returns a 404 until it is enabled in `Tools > SEO Pro > Crawling & AI > llms.txt`.
+
+Managed mode builds the document from a required H1 title, an optional summary, optional additional Markdown context, selected Statamic content, and optional sections of curated links. Selected collections include all their published, routable entries for the current site. Entries can also be selected individually. SEO Pro groups these links by collection and removes duplicates when an entry is selected both ways. Custom mode accepts the complete Markdown source. Antlers is parsed in both modes, so values such as `{{ config:app:name }}` can be used. When enabled, the resolved output must begin with a non-empty H1 and contain exactly one Markdown H1 in total.
+
+### Routes and Caching
+
+The dynamic route is available at `/llms.txt`, or beneath the site's base path for directory-based multi-site installations, such as `/fr/llms.txt`. Rendered output is cached using a fingerprint of the settings, site, and Antlers configuration context, so the document is not rebuilt on every request. SEO Pro invalidates that cache when the settings or selected Statamic content change.
+
+Statamic Half Measure static caching stores and restores the complete plain-text response, including its content type. Full Measure normally writes every response as an `.html` file, which common rewrite rules serve as HTML. SEO Pro therefore keeps this route out of Full Measure's HTML cache and uses its own rendered-content cache. Generate a physical file when the web server should serve it directly.
+
+The enabled document is also exposed as `llms_txt` in SEO Pro's cascade and GraphQL type, and the meta tag includes a `rel="describedby"` link. SEO Pro adds enabled URLs to Statamic's regular static-warm command. It does not register URLs with `statamic/ssg`; add the appropriate route to your SSG configuration when required by your deployment.
+
+### Physical Files and Deployments
+
+Select **Generate** to create a physical file, normally `public/llms.txt`. For a directory-based site, the path follows the site's base path, such as `public/fr/llms.txt`. Once created, SEO Pro keeps that file synchronized when its settings are saved and removes it when the feature is disabled.
+
+Ownership is verified using the checksum stored in SEO Pro's generation metadata. SEO Pro will never overwrite or remove an existing file that it does not manage. Manually changing a generated file relinquishes ownership, and the Control Panel displays a warning instead of modifying it.
+
+Git-based and deployment workflows can maintain the same site-scoped settings directly in `resources/addons/seo-pro.yaml` when a project does not use the Control Panel:
+
+```yaml
+llms:
+  sites:
+    default:
+      policy:
+        enabled: true
+        mode: managed
+        title: '{{ config:app:name }}'
+        summary: A concise description of the site.
+        details: Optional additional Markdown context.
+        collections:
+          - pages
+        entries:
+          - 62136fa2-9e5c-4c38-a894-a2753f02f5ff
+        sections:
+          - title: Documentation
+            links:
+              - title: Getting started
+                url: https://example.com/docs/getting-started.md
+                description: The main setup guide.
+        custom_source: ''
+```
+
+SEO Pro adds the `generated` ownership metadata after creating the physical file; it should not be authored manually.
+
+Generate all enabled sites from the command line:
+
+```shell
+php please seo-pro:generate:llms-txt
+```
+
+Use one or more `--site` options to select site handles:
+
+```shell
+php please seo-pro:generate:llms-txt --site=default --site=french
+```
+
+If multiple domains resolve to the same physical public path, generate one site per deployment using `--site`. Generated files are added to Statamic's Git-tracked paths, and a successful physical change dispatches `Statamic\SeoPro\Events\LlmsTxtGenerated`.
+
 ## Redirects
 
 SEO Pro includes a redirect manager that lets you define URL redirects, automatically create redirects when slugs change, and track 404 errors.

From f18a3364d06e0265e95c4c54047c392c525e00d3 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Thu, 24 Sep 2026 14:36:49 +0200
Subject: [PATCH 34/38] Support immutable dates when generating llms.txt

---
 src/Events/LlmsTxtGenerated.php |  4 ++--
 src/Llms/LlmsTxtGenerator.php   | 11 ++++++-----
 tests/LlmsTest.php              | 22 ++++++++++++++++++++++
 3 files changed, 30 insertions(+), 7 deletions(-)

diff --git a/src/Events/LlmsTxtGenerated.php b/src/Events/LlmsTxtGenerated.php
index 348dad7d..fcd496aa 100644
--- a/src/Events/LlmsTxtGenerated.php
+++ b/src/Events/LlmsTxtGenerated.php
@@ -2,7 +2,7 @@
 
 namespace Statamic\SeoPro\Events;
 
-use Illuminate\Support\Carbon;
+use Carbon\CarbonInterface;
 use Statamic\Contracts\Git\ProvidesCommitMessage;
 use Statamic\Events\Event;
 use Statamic\SeoPro\Llms\LlmsDocument;
@@ -14,7 +14,7 @@ public function __construct(
         public LlmsDocument $document,
         public Site $site,
         public string $path,
-        public Carbon $generatedAt,
+        public CarbonInterface $generatedAt,
     ) {}
 
     public function commitMessage(): string
diff --git a/src/Llms/LlmsTxtGenerator.php b/src/Llms/LlmsTxtGenerator.php
index 83b69bf3..1197785f 100644
--- a/src/Llms/LlmsTxtGenerator.php
+++ b/src/Llms/LlmsTxtGenerator.php
@@ -2,9 +2,10 @@
 
 namespace Statamic\SeoPro\Llms;
 
+use Carbon\CarbonInterface;
 use Illuminate\Filesystem\Filesystem;
 use Illuminate\Filesystem\LockableFile;
-use Illuminate\Support\Carbon;
+use Illuminate\Support\Facades\Date;
 use RuntimeException;
 use Statamic\SeoPro\Events\LlmsTxtGenerated;
 use Statamic\Sites\Site as SiteObject;
@@ -314,7 +315,7 @@ private function saveGeneratedSettings(
         SiteObject $site,
         string $contents,
         string $path,
-        Carbon $generatedAt,
+        CarbonInterface $generatedAt,
     ): void {
         if (! Llms::saveGenerated($document, $site, $contents, $path, $generatedAt)) {
             throw new RuntimeException('Unable to save llms.txt settings.');
@@ -565,14 +566,14 @@ private function fileMatches(string $path, string $contents, string $checksum):
         }
     }
 
-    private function existingGeneratedAt(array $generated, string $checksum): ?Carbon
+    private function existingGeneratedAt(array $generated, string $checksum): ?CarbonInterface
     {
         if (($generated['checksum'] ?? null) !== $checksum || ! is_string($generated['timestamp'] ?? null)) {
             return null;
         }
 
         try {
-            return Carbon::parse($generated['timestamp']);
+            return Date::parse($generated['timestamp']);
         } catch (Throwable) {
             return null;
         }
@@ -581,7 +582,7 @@ private function existingGeneratedAt(array $generated, string $checksum): ?Carbo
     private function result(
         string $path,
         string $contents,
-        Carbon $generatedAt,
+        CarbonInterface $generatedAt,
         bool $changed,
         bool $settingsChanged,
         bool $removed,
diff --git a/tests/LlmsTest.php b/tests/LlmsTest.php
index f0ae7d90..e77488e4 100644
--- a/tests/LlmsTest.php
+++ b/tests/LlmsTest.php
@@ -2,8 +2,10 @@
 
 namespace Tests;
 
+use Carbon\CarbonImmutable;
 use Illuminate\Cache\ArrayStore;
 use Illuminate\Cache\Repository;
+use Illuminate\Support\Facades\Date;
 use Illuminate\Support\Facades\Event;
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\Test;
@@ -25,6 +27,7 @@ protected function tearDown(): void
     {
         $this->files->delete(public_path('llms.txt'));
         $this->files->deleteDirectory(public_path('moved'));
+        Date::useDefault();
 
         parent::tearDown();
     }
@@ -273,6 +276,25 @@ public function a_generated_file_is_kept_in_sync_and_removed_when_disabled()
         $this->assertNull(Llms::generated());
     }
 
+    #[Test]
+    public function it_supports_apps_that_use_immutable_dates()
+    {
+        Date::use(CarbonImmutable::class);
+        $generator = app(LlmsTxtGenerator::class);
+        $document = new LlmsDocument(['enabled' => true, 'title' => 'Cool Runnings']);
+
+        $generator->sync($document);
+        $generator->generate($document);
+        $result = $generator->generate($document);
+
+        $this->assertFalse($result['changed']);
+        $this->assertSame(Llms::generated()['timestamp'], $result['timestamp']);
+
+        $result = $generator->sync(new LlmsDocument(['enabled' => false, 'title' => 'Cool Runnings']));
+
+        $this->assertTrue($result['removed']);
+    }
+
     #[Test]
     public function a_managed_file_is_relocated_when_the_site_url_changes()
     {

From 9e7e0d228e38ae3f44d02eff84dd5c0bd9d79fb8 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Thu, 24 Sep 2026 14:56:01 +0200
Subject: [PATCH 35/38] Encode non-ASCII link URLs and skip invalid entry links

---
 src/Llms/LlmsContent.php  |  1 +
 src/Llms/LlmsRenderer.php | 37 ++++++++++++++-
 tests/LlmsTest.php        | 95 ++++++++++++++++++++++++++++++++++++++-
 3 files changed, 130 insertions(+), 3 deletions(-)

diff --git a/src/Llms/LlmsContent.php b/src/Llms/LlmsContent.php
index 80a507d8..e94f61f9 100644
--- a/src/Llms/LlmsContent.php
+++ b/src/Llms/LlmsContent.php
@@ -80,6 +80,7 @@ private function addEntry(array &$sections, array &$included, Entry $entry): voi
             'title' => trim((string) preg_replace('/\s+/u', ' ', $collection->title())),
             'links' => [],
             'parse_antlers' => false,
+            'generated' => true,
         ];
         $sections[$handle]['links'][] = [
             'title' => $title,
diff --git a/src/Llms/LlmsRenderer.php b/src/Llms/LlmsRenderer.php
index 76c10d48..695036e3 100644
--- a/src/Llms/LlmsRenderer.php
+++ b/src/Llms/LlmsRenderer.php
@@ -2,6 +2,7 @@
 
 namespace Statamic\SeoPro\Llms;
 
+use Illuminate\Support\Str;
 use InvalidArgumentException;
 use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
 use League\CommonMark\Parser\MarkdownParser;
@@ -60,6 +61,7 @@ public function render(LlmsDocument|array $document, string|SiteObject|null $sit
 
         foreach ($sections as $section) {
             $parseAntlers = $section['parse_antlers'] ?? true;
+            $generated = $section['generated'] ?? false;
             $sectionTitle = trim($parseAntlers
                 ? $this->parse($section['title'], $context)
                 : $section['title']);
@@ -67,14 +69,15 @@ public function render(LlmsDocument|array $document, string|SiteObject|null $sit
                 ->map(function (array $link) use ($context, $parseAntlers) {
                     return [
                         'title' => trim($parseAntlers ? $this->parse($link['title'], $context) : $link['title']),
-                        'url' => trim($parseAntlers ? $this->parse($link['url'], $context) : $link['url']),
+                        'url' => $this->encodeUrl(trim($parseAntlers ? $this->parse($link['url'], $context) : $link['url'])),
                         'description' => trim($parseAntlers ? $this->parse($link['description'], $context) : $link['description']),
                     ];
                 })
                 ->filter(fn (array $link) => $link['title'] !== '' || $link['url'] !== '')
+                ->filter(fn (array $link) => ! $generated || $this->isValidGeneratedLink($link))
                 ->values();
 
-            if ($sectionTitle === '' && $links->isEmpty()) {
+            if ($links->isEmpty() && ($sectionTitle === '' || $generated)) {
                 continue;
             }
 
@@ -179,6 +182,19 @@ private function validateLink(array $link): void
         }
     }
 
+    private function isValidGeneratedLink(array $link): bool
+    {
+        try {
+            $this->validateLink($link);
+        } catch (InvalidArgumentException $exception) {
+            report($exception);
+
+            return false;
+        }
+
+        return true;
+    }
+
     private function validateSingleLine(string $value, string $label): void
     {
         if (str_contains($value, "\n") || str_contains($value, "\r")) {
@@ -191,6 +207,23 @@ private function escapeLinkTitle(string $title): string
         return str_replace(['\\', '[', ']'], ['\\\\', '\\[', '\\]'], $title);
     }
 
+    private function encodeUrl(string $url): string
+    {
+        $host = parse_url($url, PHP_URL_HOST);
+
+        if (is_string($host) && preg_match('/[^\x00-\x7F]/', $host)) {
+            $asciiHost = idn_to_ascii($host, IDNA_DEFAULT, INTL_IDNA_VARIANT_UTS46);
+
+            if ($asciiHost !== false) {
+                $url = Str::replaceFirst($host, $asciiHost, $url);
+            }
+        }
+
+        // Percent-encode non-ASCII characters and those that would end the Markdown link.
+        // Line breaks are kept so validation can still reject multi-line URLs.
+        return preg_replace_callback('/[^\x00-\x7F]|[ <>()]/u', fn (array $match) => rawurlencode($match[0]), $url) ?? $url;
+    }
+
     private function normalizeLines(string $contents): string
     {
         return str_replace(["\r\n", "\r"], "\n", $contents);
diff --git a/tests/LlmsTest.php b/tests/LlmsTest.php
index e77488e4..d402fe92 100644
--- a/tests/LlmsTest.php
+++ b/tests/LlmsTest.php
@@ -7,6 +7,8 @@
 use Illuminate\Cache\Repository;
 use Illuminate\Support\Facades\Date;
 use Illuminate\Support\Facades\Event;
+use Illuminate\Support\Facades\Exceptions;
+use InvalidArgumentException;
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\Test;
 use Statamic\Events\AddonSettingsSaved;
@@ -16,6 +18,7 @@
 use Statamic\Facades\URL;
 use Statamic\SeoPro\Cascade;
 use Statamic\SeoPro\Llms\Llms;
+use Statamic\SeoPro\Llms\LlmsContent;
 use Statamic\SeoPro\Llms\LlmsDocument;
 use Statamic\SeoPro\Llms\LlmsRenderCache;
 use Statamic\SeoPro\Llms\LlmsRenderer;
@@ -125,6 +128,96 @@ public function an_entry_selected_individually_and_through_its_collection_is_onl
         $this->assertSame(1, substr_count($contents, '](http://cool-runnings.com/about)'));
     }
 
+    #[Test]
+    public function entry_urls_on_an_international_domain_are_encoded()
+    {
+        Site::default()->set('url', 'http://bücher.de/');
+        URL::clearUrlCache();
+
+        $contents = app(LlmsRenderer::class)->render(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Cool Runnings',
+            'entries' => ['62136fa2-9e5c-4c38-a894-a2753f02f5ff'],
+        ]));
+
+        $this->assertStringContainsString('- [About](http://xn--bcher-kva.de/about)', $contents);
+    }
+
+    #[Test]
+    public function manual_link_urls_are_encoded_for_markdown()
+    {
+        $this->saveEnabled([
+            'sections' => [[
+                'title' => 'Links',
+                'links' => [
+                    ['title' => 'Books', 'url' => 'https://bücher.de/über', 'description' => ''],
+                    ['title' => 'Spaces', 'url' => 'https://example.com/a b/(c)', 'description' => ''],
+                    ['title' => 'Encoded', 'url' => 'https://example.com/%C3%BCber-uns', 'description' => ''],
+                ],
+            ]],
+        ]);
+
+        $contents = $this->get('/llms.txt')->assertOk()->content();
+
+        $this->assertStringContainsString('- [Books](https://xn--bcher-kva.de/%C3%BCber)', $contents);
+        $this->assertStringContainsString('- [Spaces](https://example.com/a%20b/%28c%29)', $contents);
+        $this->assertStringContainsString('- [Encoded](https://example.com/%C3%BCber-uns)', $contents);
+    }
+
+    #[Test]
+    public function invalid_manual_link_urls_are_rejected()
+    {
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('must be an absolute HTTP or HTTPS URL');
+
+        app(LlmsRenderer::class)->render(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Cool Runnings',
+            'sections' => [[
+                'title' => 'Links',
+                'links' => [['title' => 'Script', 'url' => 'javascript:alert(1)', 'description' => '']],
+            ]],
+        ]));
+    }
+
+    #[Test]
+    public function invalid_entry_links_are_skipped_and_reported()
+    {
+        Exceptions::fake();
+        $content = new class extends LlmsContent
+        {
+            public function sections(LlmsDocument|array $document, string|\Statamic\Sites\Site|null $site = null): array
+            {
+                return [
+                    [
+                        'title' => 'Pages',
+                        'links' => [
+                            ['title' => 'Relative', 'url' => '/relative', 'description' => ''],
+                            ['title' => 'About', 'url' => 'http://cool-runnings.com/about', 'description' => ''],
+                        ],
+                        'parse_antlers' => false,
+                        'generated' => true,
+                    ],
+                    [
+                        'title' => 'Articles',
+                        'links' => [['title' => 'Relative', 'url' => '/also-relative', 'description' => '']],
+                        'parse_antlers' => false,
+                        'generated' => true,
+                    ],
+                ];
+            }
+        };
+
+        $contents = (new LlmsRenderer($content))->render(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Cool Runnings',
+        ]));
+
+        $this->assertSame("# Cool Runnings\n\n## Pages\n\n- [About](http://cool-runnings.com/about)\n", $contents);
+        Exceptions::assertReportedCount(2);
+        Exceptions::assertReported(fn (InvalidArgumentException $exception) => str_contains($exception->getMessage(), '[/relative]'));
+    }
+
     #[Test]
     public function selected_draft_entries_are_not_included()
     {
@@ -172,7 +265,7 @@ public function selected_content_changes_invalidate_the_route_cache_and_refresh_
     #[DataProvider('additionalH1Provider')]
     public function it_rejects_documents_with_more_than_one_markdown_h1(string $source)
     {
-        $this->expectException(\InvalidArgumentException::class);
+        $this->expectException(InvalidArgumentException::class);
         $this->expectExceptionMessage('must contain exactly one Markdown H1 heading');
 
         app(LlmsRenderer::class)->render(new LlmsDocument([

From 3f666062545171292ebea4f5321a711fd0b50b87 Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Thu, 24 Sep 2026 15:13:26 +0200
Subject: [PATCH 36/38] Warn about llms.txt size limit and serve the last good
 version

---
 lang/en/messages.php                       |  3 +
 resources/js/pages/llms/Tab.vue            | 19 ++++-
 src/Http/Controllers/CP/LlmsController.php | 21 +++---
 src/Http/Controllers/LlmsController.php    | 10 ++-
 src/Llms/LlmsRenderCache.php               | 47 ++++++++++--
 src/Llms/LlmsRenderer.php                  |  5 +-
 tests/LlmsCpTest.php                       | 31 +++++++-
 tests/LlmsTest.php                         | 87 ++++++++++++++++++++++
 8 files changed, 202 insertions(+), 21 deletions(-)

diff --git a/lang/en/messages.php b/lang/en/messages.php
index 1f6a23d3..236b40aa 100644
--- a/lang/en/messages.php
+++ b/lang/en/messages.php
@@ -57,6 +57,9 @@
         'generated_preview' => 'Resolved preview',
         'preview_unavailable' => 'Preview unavailable',
         'preview_title' => 'llms.txt preview',
+        'size' => ':size KiB of :limit KiB',
+        'size_limit_approaching' => 'llms.txt is approaching its 500 KiB limit',
+        'size_limit_approaching_description' => 'If selected collections grow past the limit, llms.txt can no longer be saved or regenerated, and the live route keeps serving the last successful version. Select fewer collections or entries to leave room.',
         'generate_confirmation' => 'Generate llms.txt?',
         'generate_confirmation_description' => 'SEO Pro will create a missing file or update a file it already manages. An unmanaged file will never be overwritten.',
         'custom_source_too_large' => 'The custom source must not be greater than 500 KiB.',
diff --git a/resources/js/pages/llms/Tab.vue b/resources/js/pages/llms/Tab.vue
index b86da6f9..089dfa1c 100644
--- a/resources/js/pages/llms/Tab.vue
+++ b/resources/js/pages/llms/Tab.vue
@@ -45,6 +45,7 @@ const collectionOptions = ref([]);
 const entryOptions = ref([]);
 const errors = ref({});
 const previewError = ref(null);
+const maxBytes = ref(0);
 const hydrating = ref(false);
 const dirtyStateName = 'seo-pro-llms';
 
@@ -55,6 +56,9 @@ const modeOptions = [
 
 const isBusy = computed(() => loading.value || saving.value || generating.value);
 const hasUnmanagedFile = computed(() => file.value.exists && !file.value.managed);
+const renderedBytes = computed(() => new TextEncoder().encode(rendered.value ?? '').length);
+const approachingSizeLimit = computed(() => form.value?.enabled && maxBytes.value > 0 && renderedBytes.value >= maxBytes.value * 0.8);
+const formatKiB = (bytes) => Math.ceil(bytes / 1024).toLocaleString();
 let previewTimer = null;
 let previewController = null;
 let previewRequest = 0;
@@ -82,7 +86,8 @@ function hydrate(data) {
 	collectionOptions.value = data.collectionOptions;
 	entryOptions.value = data.entryOptions;
 	errors.value = {};
-	previewError.value = null;
+	previewError.value = data.previewError ?? null;
+	maxBytes.value = data.maxBytes;
 	loaded.value = true;
 	Statamic.$dirty.remove(dirtyStateName);
 	queueMicrotask(() => hydrating.value = false);
@@ -410,8 +415,20 @@ defineExpose({ save });
 								<Description :text="liveUrl" />
 							</div>
 							<Badge v-if="previewError" color="red" :text="__('seo-pro::messages.llms_txt.preview_unavailable')" />
+							<Badge
+								v-else-if="rendered"
+								:color="approachingSizeLimit ? 'amber' : 'default'"
+								:text="__('seo-pro::messages.llms_txt.size', { size: formatKiB(renderedBytes), limit: formatKiB(maxBytes) })"
+							/>
 						</div>
 						<Alert v-if="previewError" class="mb-4" variant="warning" :text="previewError" />
+						<Alert
+							v-else-if="approachingSizeLimit"
+							class="mb-4"
+							variant="warning"
+							:heading="__('seo-pro::messages.llms_txt.size_limit_approaching')"
+							:text="__('seo-pro::messages.llms_txt.size_limit_approaching_description')"
+						/>
 						<CodeEditor :model-value="rendered" mode="markdown" :allow-mode-selection="false" :show-mode-label="false" read-only :title="__('seo-pro::messages.llms_txt.preview_title')" />
 					</Panel>
 				</template>
diff --git a/src/Http/Controllers/CP/LlmsController.php b/src/Http/Controllers/CP/LlmsController.php
index d69b6a78..07809214 100644
--- a/src/Http/Controllers/CP/LlmsController.php
+++ b/src/Http/Controllers/CP/LlmsController.php
@@ -30,10 +30,13 @@ public function edit(Request $request)
         $this->authorize('edit seo robots');
         $site = $this->site($request);
         $document = Llms::get($site);
+        $preview = $this->renderPreview($document, $site);
 
         return [
             'values' => $document->all(),
-            'preview' => $this->previewContents($document, $site),
+            'preview' => $preview['preview'] ?? '',
+            'previewError' => $document->enabled() ? $preview['error'] : null,
+            'maxBytes' => LlmsRenderer::MAX_BYTES,
             'action' => cp_route('seo-pro.llms.update'),
             'generateUrl' => cp_route('seo-pro.llms.generate'),
             'previewUrl' => cp_route('seo-pro.llms.preview'),
@@ -106,12 +109,7 @@ public function preview(Request $request)
         $site = $this->site($request);
         $document = new LlmsDocument($this->validated($request, $site, false));
 
-        try {
-            return ['preview' => $this->renderer->render($document, $site), 'error' => null];
-        } catch (Throwable $exception) {
-            // Incomplete drafts are expected while editing, so report why instead of failing the request.
-            return ['preview' => null, 'error' => $exception->getMessage()];
-        }
+        return $this->renderPreview($document, $site);
     }
 
     private function validated(Request $request, $site, bool $validateRenderedDocument = true): array
@@ -207,12 +205,13 @@ private function site(Request $request)
         return $site;
     }
 
-    private function previewContents(LlmsDocument $document, $site): string
+    private function renderPreview(LlmsDocument $document, $site): array
     {
         try {
-            return $this->renderer->render($document, $site);
-        } catch (Throwable) {
-            return '';
+            return ['preview' => $this->renderer->render($document, $site), 'error' => null];
+        } catch (Throwable $exception) {
+            // Incomplete drafts are expected while editing, so report why instead of failing the request.
+            return ['preview' => null, 'error' => $exception->getMessage()];
         }
     }
 
diff --git a/src/Http/Controllers/LlmsController.php b/src/Http/Controllers/LlmsController.php
index 7184b0b1..349284e5 100644
--- a/src/Http/Controllers/LlmsController.php
+++ b/src/Http/Controllers/LlmsController.php
@@ -9,6 +9,7 @@
 use Statamic\SeoPro\Llms\LlmsRenderCache;
 use Statamic\StaticCaching\Cacher;
 use Statamic\StaticCaching\Cachers\FileCacher;
+use Throwable;
 
 class LlmsController extends Controller
 {
@@ -24,7 +25,14 @@ public function show(Request $request)
 
         abort_unless($document->enabled(), 404);
 
-        $contents = $this->cache->get($document, $site);
+        try {
+            $contents = $this->cache->get($document, $site);
+        } catch (Throwable $exception) {
+            report($exception);
+
+            abort(503);
+        }
+
         $response = response($contents)
             ->header('Content-Type', 'text/plain; charset=UTF-8')
             ->header('ETag', '"'.hash('sha256', $contents).'"')
diff --git a/src/Llms/LlmsRenderCache.php b/src/Llms/LlmsRenderCache.php
index 6c9fb6b5..6250a711 100644
--- a/src/Llms/LlmsRenderCache.php
+++ b/src/Llms/LlmsRenderCache.php
@@ -4,6 +4,7 @@
 
 use Illuminate\Contracts\Cache\Repository;
 use Statamic\Sites\Site as SiteObject;
+use Throwable;
 
 class LlmsRenderCache
 {
@@ -21,13 +22,33 @@ public function get(LlmsDocument $document, string|SiteObject|null $site = null)
         ], JSON_PARTIAL_OUTPUT_ON_ERROR | JSON_PRESERVE_ZERO_FRACTION));
         $cached = $this->cache->get($this->key($site));
 
-        if (is_array($cached)
-            && ($cached['fingerprint'] ?? null) === $fingerprint
-            && is_string($cached['contents'] ?? null)) {
-            return $cached['contents'];
+        $lastContents = is_array($cached) && is_string($cached['contents'] ?? null) ? $cached['contents'] : null;
+
+        if ($lastContents !== null && ($cached['fingerprint'] ?? null) === $fingerprint) {
+            return $lastContents;
+        }
+
+        if ($lastContents !== null && ($cached['failed'] ?? null) === $fingerprint) {
+            return $lastContents;
         }
 
-        $contents = $this->renderer->render($document, $site);
+        try {
+            $contents = $this->renderer->render($document, $site);
+        } catch (Throwable $exception) {
+            if ($lastContents === null) {
+                throw $exception;
+            }
+
+            // Keep serving the last successful render, and don't retry until something changes.
+            report($exception);
+            $this->cache->forever($this->key($site), [
+                'fingerprint' => null,
+                'failed' => $fingerprint,
+                'contents' => $lastContents,
+            ]);
+
+            return $lastContents;
+        }
 
         $this->cache->forever($this->key($site), [
             'fingerprint' => $fingerprint,
@@ -39,7 +60,21 @@ public function get(LlmsDocument $document, string|SiteObject|null $site = null)
 
     public function forget(string|SiteObject|null $site = null): void
     {
-        $this->cache->forget($this->key(Llms::site($site)));
+        $key = $this->key(Llms::site($site));
+        $cached = $this->cache->get($key);
+
+        if (! is_array($cached) || ! is_string($cached['contents'] ?? null)) {
+            $this->cache->forget($key);
+
+            return;
+        }
+
+        // Keep the contents as a fallback in case the next render fails.
+        $this->cache->forever($key, [
+            'fingerprint' => null,
+            'failed' => null,
+            'contents' => $cached['contents'],
+        ]);
     }
 
     private function key(SiteObject $site): string
diff --git a/src/Llms/LlmsRenderer.php b/src/Llms/LlmsRenderer.php
index 695036e3..88a757c3 100644
--- a/src/Llms/LlmsRenderer.php
+++ b/src/Llms/LlmsRenderer.php
@@ -243,7 +243,10 @@ private function finalize(string $contents): string
         }
 
         if (strlen($contents) > self::MAX_BYTES) {
-            throw new InvalidArgumentException('The resolved llms.txt document must not be greater than 500 KiB.');
+            throw new InvalidArgumentException(sprintf(
+                'The resolved llms.txt document is %s KiB, which is over the 500 KiB limit. Select fewer collections or entries, or shorten the content.',
+                ceil(strlen($contents) / 1024),
+            ));
         }
 
         $this->validateH1Count($contents);
diff --git a/tests/LlmsCpTest.php b/tests/LlmsCpTest.php
index 0db2747a..530cee44 100644
--- a/tests/LlmsCpTest.php
+++ b/tests/LlmsCpTest.php
@@ -4,8 +4,13 @@
 
 use PHPUnit\Framework\Attributes\Test;
 use Statamic\Facades\Addon;
+use Statamic\Facades\Entry;
 use Statamic\Facades\Role;
+use Statamic\Facades\Site;
 use Statamic\Facades\User;
+use Statamic\SeoPro\Llms\Llms;
+use Statamic\SeoPro\Llms\LlmsDocument;
+use Statamic\SeoPro\Llms\LlmsRenderer;
 
 class LlmsCpTest extends TestCase
 {
@@ -34,7 +39,31 @@ public function a_super_user_can_view_disabled_defaults()
             ])
             ->assertJsonPath('file.exists', false)
             ->assertJsonPath('file.path', public_path('llms.txt'))
-            ->assertJsonPath('liveUrl', 'http://cool-runnings.com/llms.txt');
+            ->assertJsonPath('liveUrl', 'http://cool-runnings.com/llms.txt')
+            ->assertJsonPath('previewError', null)
+            ->assertJsonPath('maxBytes', LlmsRenderer::MAX_BYTES);
+    }
+
+    #[Test]
+    public function loading_reports_why_the_saved_document_can_no_longer_be_rendered()
+    {
+        Llms::saveWithoutGenerated(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Cool Runnings',
+            'collections' => ['articles'],
+        ]), Site::default());
+        Entry::make()
+            ->collection('articles')
+            ->slug('oversized')
+            ->data(['title' => str_repeat('a', 600 * 1024)])
+            ->save();
+
+        $response = $this->actingAs(User::make()->makeSuper()->save())
+            ->getJson(cp_route('seo-pro.llms.edit'))
+            ->assertOk()
+            ->assertJsonPath('preview', '');
+
+        $this->assertStringContainsString('over the 500 KiB limit', $response->json('previewError'));
     }
 
     #[Test]
diff --git a/tests/LlmsTest.php b/tests/LlmsTest.php
index d402fe92..f7a9134d 100644
--- a/tests/LlmsTest.php
+++ b/tests/LlmsTest.php
@@ -339,6 +339,84 @@ public function render(LlmsDocument|array $document, string|\Statamic\Sites\Site
         $this->assertSame(2, $renderer->renders);
     }
 
+    #[Test]
+    public function documents_over_the_size_limit_are_rejected_with_their_size()
+    {
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('The resolved llms.txt document is 601 KiB, which is over the 500 KiB limit.');
+
+        app(LlmsRenderer::class)->render(new LlmsDocument([
+            'enabled' => true,
+            'title' => 'Cool Runnings',
+            'details' => str_repeat('a', 600 * 1024),
+        ]));
+    }
+
+    #[Test]
+    public function the_route_serves_the_last_successful_version_when_rendering_fails()
+    {
+        Exceptions::fake();
+        $this->saveEnabled(['collections' => ['articles']]);
+        $contents = $this->get('/llms.txt')->assertOk()->content();
+
+        $this->saveOversizedArticle();
+
+        $this->get('/llms.txt')->assertOk()->assertContent($contents);
+        Exceptions::assertReported(fn (InvalidArgumentException $exception) => str_contains($exception->getMessage(), 'over the 500 KiB limit'));
+    }
+
+    #[Test]
+    public function the_route_returns_a_503_when_nothing_has_rendered_successfully()
+    {
+        Exceptions::fake();
+        $this->saveEnabled(['collections' => ['articles']]);
+        $this->saveOversizedArticle();
+
+        $this->get('/llms.txt')->assertServiceUnavailable();
+        Exceptions::assertReported(fn (InvalidArgumentException $exception) => str_contains($exception->getMessage(), 'over the 500 KiB limit'));
+    }
+
+    #[Test]
+    public function a_failed_render_is_not_retried_until_the_content_changes()
+    {
+        Exceptions::fake();
+        $renderer = new class extends LlmsRenderer
+        {
+            public int $renders = 0;
+
+            public bool $fail = false;
+
+            public function render(LlmsDocument|array $document, string|\Statamic\Sites\Site|null $site = null): string
+            {
+                $this->renders++;
+
+                if ($this->fail) {
+                    throw new InvalidArgumentException('Rendering failed.');
+                }
+
+                return parent::render($document, $site);
+            }
+        };
+        $cache = new LlmsRenderCache(new Repository(new ArrayStore), $renderer);
+        $document = new LlmsDocument(['enabled' => true, 'title' => 'First']);
+
+        $this->assertSame("# First\n", $cache->get($document));
+
+        $renderer->fail = true;
+        $cache->forget();
+
+        $this->assertSame("# First\n", $cache->get($document));
+        $this->assertSame("# First\n", $cache->get($document));
+        $this->assertSame(2, $renderer->renders);
+        Exceptions::assertReportedCount(1);
+
+        $renderer->fail = false;
+        $cache->forget();
+
+        $this->assertSame("# Second\n", $cache->get(new LlmsDocument(['enabled' => true, 'title' => 'Second'])));
+        $this->assertSame(3, $renderer->renders);
+    }
+
     #[Test]
     public function saving_does_not_create_a_physical_file_until_generation_is_requested()
     {
@@ -543,6 +621,15 @@ public function enabled_llms_txt_is_exposed_to_the_meta_cascade()
         $this->assertSame('http://cool-runnings.com/llms.txt', (new Cascade)->get()['llms_txt']);
     }
 
+    private function saveOversizedArticle(): void
+    {
+        Entry::make()
+            ->collection('articles')
+            ->slug('oversized')
+            ->data(['title' => str_repeat('a', 600 * 1024)])
+            ->save();
+    }
+
     private function saveEnabled(array $overrides = []): void
     {
         Llms::saveWithoutGenerated(new LlmsDocument(array_replace([

From 8e2496135906d4ceb18f8e5eae6bd25c791996bc Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Thu, 24 Sep 2026 15:18:51 +0200
Subject: [PATCH 37/38] Wait for an llms.txt generation in progress instead of
 failing

---
 src/Llms/LlmsTxtGenerator.php | 16 +++++++++++--
 tests/LlmsTest.php            | 42 +++++++++++++++++++++++++++++++++++
 2 files changed, 56 insertions(+), 2 deletions(-)

diff --git a/src/Llms/LlmsTxtGenerator.php b/src/Llms/LlmsTxtGenerator.php
index 1197785f..79d27ec6 100644
--- a/src/Llms/LlmsTxtGenerator.php
+++ b/src/Llms/LlmsTxtGenerator.php
@@ -3,6 +3,7 @@
 namespace Statamic\SeoPro\Llms;
 
 use Carbon\CarbonInterface;
+use Illuminate\Contracts\Filesystem\LockTimeoutException;
 use Illuminate\Filesystem\Filesystem;
 use Illuminate\Filesystem\LockableFile;
 use Illuminate\Support\Facades\Date;
@@ -15,6 +16,10 @@ class LlmsTxtGenerator
 {
     public const MAX_BYTES = LlmsRenderer::MAX_BYTES;
 
+    private const LOCK_ATTEMPTS = 100;
+
+    private const LOCK_RETRY_MILLISECONDS = 100;
+
     public function __construct(
         private Filesystem $files,
         private LlmsRenderer $renderer,
@@ -286,11 +291,18 @@ private function locked(\Closure $callback): array
 
         try {
             $lock = new LockableFile(storage_path('framework/cache/seo-pro/llms-txt.lock'), 'c+');
-            $lock->getExclusiveLock();
+
+            // Wait for a generation in progress, e.g. from a simultaneous entry save, so this update isn't lost.
+            retry(
+                self::LOCK_ATTEMPTS,
+                fn () => $lock->getExclusiveLock(),
+                self::LOCK_RETRY_MILLISECONDS,
+                fn (Throwable $exception) => $exception instanceof LockTimeoutException,
+            );
         } catch (Throwable $exception) {
             $lock?->close();
 
-            throw new RuntimeException('Unable to acquire the llms.txt generation lock. Another generation may already be in progress.', previous: $exception);
+            throw new RuntimeException('Unable to acquire the llms.txt generation lock. Another generation is still in progress.', previous: $exception);
         }
 
         try {
diff --git a/tests/LlmsTest.php b/tests/LlmsTest.php
index f7a9134d..41459756 100644
--- a/tests/LlmsTest.php
+++ b/tests/LlmsTest.php
@@ -5,9 +5,11 @@
 use Carbon\CarbonImmutable;
 use Illuminate\Cache\ArrayStore;
 use Illuminate\Cache\Repository;
+use Illuminate\Filesystem\LockableFile;
 use Illuminate\Support\Facades\Date;
 use Illuminate\Support\Facades\Event;
 use Illuminate\Support\Facades\Exceptions;
+use Illuminate\Support\Sleep;
 use InvalidArgumentException;
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\Test;
@@ -466,6 +468,38 @@ public function it_supports_apps_that_use_immutable_dates()
         $this->assertTrue($result['removed']);
     }
 
+    #[Test]
+    public function generation_waits_for_a_generation_in_progress()
+    {
+        $lock = $this->holdGenerationLock();
+        Sleep::fake();
+        Sleep::whenFakingSleep(fn () => $lock->close());
+
+        app(LlmsTxtGenerator::class)->generate(new LlmsDocument(['enabled' => true, 'title' => 'Cool Runnings']));
+
+        Sleep::assertSleptTimes(1);
+        $this->assertSame("# Cool Runnings\n", $this->files->get(public_path('llms.txt')));
+    }
+
+    #[Test]
+    public function generation_gives_up_when_a_generation_in_progress_does_not_finish()
+    {
+        $lock = $this->holdGenerationLock();
+        Sleep::fake();
+
+        try {
+            app(LlmsTxtGenerator::class)->generate(new LlmsDocument(['enabled' => true, 'title' => 'Cool Runnings']));
+            $this->fail('Generation should have timed out waiting for the lock.');
+        } catch (\RuntimeException $exception) {
+            $this->assertStringContainsString('generation lock', $exception->getMessage());
+        } finally {
+            $lock->close();
+        }
+
+        Sleep::assertSleptTimes(99);
+        $this->assertFileDoesNotExist(public_path('llms.txt'));
+    }
+
     #[Test]
     public function a_managed_file_is_relocated_when_the_site_url_changes()
     {
@@ -621,6 +655,14 @@ public function enabled_llms_txt_is_exposed_to_the_meta_cascade()
         $this->assertSame('http://cool-runnings.com/llms.txt', (new Cascade)->get()['llms_txt']);
     }
 
+    private function holdGenerationLock(): LockableFile
+    {
+        $lock = new LockableFile(storage_path('framework/cache/seo-pro/llms-txt.lock'), 'c+');
+        $lock->getExclusiveLock();
+
+        return $lock;
+    }
+
     private function saveOversizedArticle(): void
     {
         Entry::make()

From 9199ab93f5db7dc3bb0ac333522d21874d34f9cf Mon Sep 17 00:00:00 2001
From: Joshua Blum <hallo@joshuablum.de>
Date: Thu, 24 Sep 2026 15:23:26 +0200
Subject: [PATCH 38/38] Release changed file at previous site path

---
 src/Llms/LlmsTxtGenerator.php | 10 +++----
 tests/LlmsTest.php            | 53 ++++++++++++++++++++++++++++++-----
 2 files changed, 50 insertions(+), 13 deletions(-)

diff --git a/src/Llms/LlmsTxtGenerator.php b/src/Llms/LlmsTxtGenerator.php
index 79d27ec6..df352b1d 100644
--- a/src/Llms/LlmsTxtGenerator.php
+++ b/src/Llms/LlmsTxtGenerator.php
@@ -424,21 +424,19 @@ private function relocatedManagedFile(SiteObject $site, string $currentPath): ?a
             return null;
         }
 
-        if (is_link($path)) {
-            throw new RuntimeException("SEO Pro will not manage an llms.txt symbolic link at [{$path}].");
-        }
-
-        if (! $this->files->exists($path)) {
+        if (is_link($path) || ! $this->files->exists($path)) {
             return null;
         }
 
         $resolvedPath = realpath($path);
 
+        // Like a changed file at the current path, a previous file that was changed or replaced
+        // is no longer managed. It's left in place, and the stale record is cleared on save.
         if (! is_string($resolvedPath)
             || ! $this->isWithinPublicDirectory($resolvedPath)
             || ! $this->files->isFile($path)
             || ! $this->fileHasChecksum($path, $checksum)) {
-            throw new RuntimeException("The previously managed llms.txt file at [{$path}] has changed and will not be removed.");
+            return null;
         }
 
         return compact('path', 'checksum');
diff --git a/tests/LlmsTest.php b/tests/LlmsTest.php
index 41459756..086acb28 100644
--- a/tests/LlmsTest.php
+++ b/tests/LlmsTest.php
@@ -535,26 +535,65 @@ public function disabling_after_a_site_url_change_removes_the_previous_managed_f
     }
 
     #[Test]
-    public function a_modified_file_at_the_previous_site_path_is_not_removed()
+    public function a_modified_file_at_the_previous_site_path_is_released_instead_of_removed()
     {
         $generator = app(LlmsTxtGenerator::class);
         $generator->generate(new LlmsDocument(['enabled' => true, 'title' => 'First']));
-        $generated = Llms::generated();
         $this->files->put(public_path('llms.txt'), "# Changed manually\n");
 
         Site::default()->set('url', '/moved/');
         URL::clearUrlCache();
 
+        $generator->sync(new LlmsDocument(['enabled' => true, 'title' => 'Second']));
+
+        $this->assertSame("# Changed manually\n", $this->files->get(public_path('llms.txt')));
+        $this->assertFileDoesNotExist(public_path('moved/llms.txt'));
+        $this->assertNull(Llms::generated());
+        $this->assertSame('Second', Llms::get()->all()['title']);
+
+        $generator->generate(new LlmsDocument(['enabled' => true, 'title' => 'Third']));
+
+        $this->assertSame("# Third\n", $this->files->get(public_path('moved/llms.txt')));
+        $this->assertSame("# Changed manually\n", $this->files->get(public_path('llms.txt')));
+    }
+
+    #[Test]
+    public function a_symbolic_link_at_the_previous_site_path_is_released_instead_of_removed()
+    {
+        $generator = app(LlmsTxtGenerator::class);
+        $generator->generate(new LlmsDocument(['enabled' => true, 'title' => 'First']));
+        $this->files->put(public_path('moved-target.txt'), "# Linked\n");
+        $this->files->delete(public_path('llms.txt'));
+        symlink(public_path('moved-target.txt'), public_path('llms.txt'));
+
+        Site::default()->set('url', '/moved/');
+        URL::clearUrlCache();
+
         try {
             $generator->sync(new LlmsDocument(['enabled' => true, 'title' => 'Second']));
-            $this->fail('Synchronization should refuse to remove the modified previous file.');
-        } catch (\RuntimeException $exception) {
-            $this->assertStringContainsString('has changed and will not be removed', $exception->getMessage());
+
+            $this->assertTrue(is_link(public_path('llms.txt')));
+            $this->assertNull(Llms::generated());
+        } finally {
+            $this->files->delete([public_path('llms.txt'), public_path('moved-target.txt')]);
         }
+    }
+
+    #[Test]
+    public function llms_txt_can_be_disabled_after_the_previous_file_was_modified()
+    {
+        $generator = app(LlmsTxtGenerator::class);
+        $generator->generate(new LlmsDocument(['enabled' => true, 'title' => 'First']));
+        $this->files->put(public_path('llms.txt'), "# Changed manually\n");
+
+        Site::default()->set('url', '/moved/');
+        URL::clearUrlCache();
+
+        $generator->sync(new LlmsDocument(['enabled' => false, 'title' => 'First']));
 
         $this->assertSame("# Changed manually\n", $this->files->get(public_path('llms.txt')));
-        $this->assertFileDoesNotExist(public_path('moved/llms.txt'));
-        $this->assertSame($generated, Llms::generated());
+        $this->assertNull(Llms::generated());
+        $this->assertFalse(Llms::get()->enabled());
     }
 
     #[Test]