@janga/norna 0.7.18 → 0.7.23

package/scripts/sync-content-sections.mjs

@@ -1,44 +1,40 @@
-import { execFile } from 'node:child_process';
-import { mkdir, rename, stat } from 'node:fs/promises';
 import { createInterface } from 'node:readline/promises';
 import { stdin as input, stdout as output } from 'node:process';
 import path from 'node:path';
-import { promisify } from 'node:util';
+import { applyImageSyncPlan } from './lib/content-sync-apply.mjs';
 import {
-	extractInlineNoteDiagnostics,
-	extractMarkdownImageReferences,
-	extractNornaMarkdownBlockDiagnostics,
-	getNornaBlockImageReferences,
-} from './lib/norna-markdown-blocks.mjs';
+	createImageSyncPlan,
+	getExpectedImageLabel,
+	getImageCandidateLabel,
+} from './lib/content-sync-plan.mjs';
 import {
-	getBodySections,
-	getContentFiles,
 	getImageCandidatesByName,
 	getDeprecatedInlineStyleReferences,
 	readSiteFile,
 	readThemeFile,
+	parseContentFrontmatter,
 	toPosixPath,
 	validateContentFrontmatterStructure,
 	validateFrontmatterIndentation,
 	validateThemeYamlStructure,
 } from './lib/site-content.mjs';
-import { getHeadingIdentifierIssues } from './lib/heading-ids.mjs';
+import { getSiteStructure } from './lib/site-structure.mjs';
 import { readImageDimensions } from './lib/image-dimensions.mjs';
+import { parsePageMarkdownSource } from './lib/page-markdown.mjs';
+import {
+	createSiteLinkGraph,
+	getSitePublicFiles,
+} from './lib/site-link-graph.mjs';
 import {
 	siteThemeLabel,
 	siteThemePath,
-	siteProjectRoot,
 } from './lib/site-paths.mjs';
 
-const execFileAsync = promisify(execFile);
-
 const args = new Set(process.argv.slice(2));
 const shouldWrite = args.has('--write');
 const shouldCheck = args.has('--check') || !shouldWrite;
 const skipPrompt = args.has('--yes');
 const issues = [];
-const imageMoves = [];
-const referencedImagePaths = new Set();
 
 const addIssue = ({ severity, message, fix, sectionId, sectionLabel }) => {
 	issues.push({ severity, message, fix, sectionId, sectionLabel });
@@ -46,7 +42,7 @@ const addIssue = ({ severity, message, fix, sectionId, sectionLabel }) => {
 
 const hasErrors = () => issues.some((issue) => issue.severity === 'error');
 
-const formatSectionLabel = (contentFile, section) => `${contentFile.contentLabel} [${section.id ?? section.heading}]`;
+const formatSectionLabel = (contentFile, section) => `${contentFile.contentLabel} [${section.id ?? section.title}]`;
 
 const addContentIssue = (contentFile, issue) => addIssue({
 	...issue,
@@ -56,11 +52,18 @@ const addContentIssue = (contentFile, issue) => addIssue({
 
 const addSectionIssue = (contentFile, section, issue) => addIssue({
 	...issue,
-	sectionId: issue.sectionId ?? `${contentFile.contentLabel}:${section.id ?? section.heading}`,
+	sectionId: issue.sectionId ?? `${contentFile.contentLabel}:${section.id ?? section.title}`,
 	sectionLabel: issue.sectionLabel ?? formatSectionLabel(contentFile, section),
 });
 
-const promptForWrite = async () => {
+const getMovePlanLines = (moves) => [
+	'Planned image moves:',
+	...moves.map((move) => `- ${getImageCandidateLabel({ contentFile: move.sourceContentFile, imagePath: move.from })} -> ${getExpectedImageLabel(move.contentFile, move.imageName)}`),
+];
+
+const promptForWrite = async (moves) => {
+	console.log(getMovePlanLines(moves).join('\n'));
+
 	if (skipPrompt) return true;
 	if (!process.stdin.isTTY) return false;
 
@@ -171,185 +174,6 @@ const getAspectRatioLabel = ({ width, height }) => {
 	return `${width / divisor}:${height / divisor}`;
 };
 
-const getExpectedImagePath = (contentFile, imageName) =>
-	path.join(contentFile.imagesDir, imageName);
-
-const getExpectedImageLabel = (contentFile, imageName) =>
-	`${contentFile.imagesLabel}/${imageName}`;
-
-const getGlobalImageCandidates = (globalImageCandidatesByName, imageName, expectedPath) =>
-	(globalImageCandidatesByName.get(imageName) ?? []).filter(({ imagePath }) => imagePath !== expectedPath);
-
-const getReferenceLabel = (contentFile, section) => `${contentFile.contentLabel} [${section.id ?? 'page title'}]`;
-
-const getRootLabel = (contentFile) => contentFile.imagesLabel.replace(/\/images$/, '');
-
-const getCandidateLabel = ({ contentFile, imagePath }) =>
-	`${contentFile.imagesLabel}/${toPosixPath(path.relative(contentFile.imagesDir, imagePath))}`;
-
-const addExpectedReference = (expectedReferencesByPath, expectedPath, expectedReference) => {
-	if (!expectedReferencesByPath.has(expectedPath)) {
-		expectedReferencesByPath.set(expectedPath, []);
-	}
-
-	expectedReferencesByPath.get(expectedPath).push(expectedReference);
-};
-
-const addGlobalImageCandidate = (globalImageCandidatesByName, imageName, candidate) => {
-	if (!globalImageCandidatesByName.has(imageName)) {
-		globalImageCandidatesByName.set(imageName, []);
-	}
-
-	globalImageCandidatesByName.get(imageName).push(candidate);
-};
-
-const assertCleanGitForCrossRootSync = async (moves) => {
-	if (!moves.some((move) => move.crossRoot)) return;
-
-	let stdout = '';
-	try {
-		({ stdout } = await execFileAsync('git', ['status', '--short'], {
-			cwd: siteProjectRoot,
-			maxBuffer: 1024 * 1024,
-		}));
-	} catch (error) {
-		addIssue({
-			severity: 'error',
-			message: 'Cross-page content sync requires a clean git working tree, but git status could not be checked.',
-			fix: 'Run content:sync inside a Git worktree, or move cross-page image files manually.',
-		});
-		return;
-	}
-
-	if (!stdout.trim()) return;
-
-	addIssue({
-		severity: 'error',
-		message: 'Cross-page content sync requires a clean git working tree before moving files between page image roots.',
-		fix: `Commit or stash your current changes, then run content:sync again. Current changes:\n${stdout.trim()}`,
-	});
-};
-
-const addConflictingMoveIssues = () => {
-	const movesBySource = new Map();
-	const movesByDestination = new Map();
-
-	for (const move of imageMoves) {
-		const sourceKey = move.from;
-		const destinationKey = move.to;
-
-		if (!movesBySource.has(sourceKey)) {
-			movesBySource.set(sourceKey, []);
-		}
-		movesBySource.get(sourceKey).push(move);
-
-		if (!movesByDestination.has(destinationKey)) {
-			movesByDestination.set(destinationKey, []);
-		}
-		movesByDestination.get(destinationKey).push(move);
-	}
-
-	for (const moves of movesBySource.values()) {
-		const destinations = new Set(moves.map((move) => move.to));
-		if (destinations.size <= 1) continue;
-
-		const firstMove = moves[0];
-		addSectionIssue(firstMove.contentFile, firstMove.section, {
-			severity: 'error',
-			message: `Cannot relocate "${firstMove.imageName}" because the same source file is referenced from multiple destinations: ${moves.map((move) => getExpectedImageLabel(move.contentFile, move.imageName)).join(', ')}.`,
-			fix: 'Duplicate the image manually or rename one of the image files so each move has a single destination.',
-		});
-	}
-
-	for (const moves of movesByDestination.values()) {
-		const sources = new Set(moves.map((move) => move.from));
-		if (sources.size <= 1) continue;
-
-		const firstMove = moves[0];
-		addSectionIssue(firstMove.contentFile, firstMove.section, {
-			severity: 'error',
-			message: `Cannot relocate "${firstMove.imageName}" because multiple source files would move to ${getExpectedImageLabel(firstMove.contentFile, firstMove.imageName)}: ${moves.map((move) => getCandidateLabel(move.sourceContentFile ? { contentFile: move.sourceContentFile, imagePath: move.from } : move)).join(', ')}.`,
-			fix: 'Move the intended file manually or rename files so the destination is unambiguous.',
-		});
-	}
-};
-
-const validateImageReference = async (
-	contentFile,
-	section,
-	reference,
-	globalImageCandidatesByName,
-	expectedReferencesByPath,
-) => {
-	const imageName = reference.image;
-	const expectedPath = getExpectedImagePath(contentFile, imageName);
-	const expectedLabel = getExpectedImageLabel(contentFile, imageName);
-	const expectedExists = await stat(expectedPath).then((entry) => entry.isFile()).catch(() => false);
-
-	if (expectedExists) {
-		referencedImagePaths.add(expectedPath);
-		return expectedPath;
-	}
-
-	const candidates = getGlobalImageCandidates(globalImageCandidatesByName, imageName, expectedPath);
-	if (candidates.length === 0) {
-		addSectionIssue(contentFile, section, {
-			severity: 'error',
-			message: `Image "${imageName}" does not exist at ${expectedLabel} or anywhere under any page image root.`,
-			fix: `Add the source image directly to ${contentFile.imagesLabel}/ or remove the Norna-managed image reference.`,
-		});
-		return null;
-	}
-
-	if (candidates.length > 1) {
-		addSectionIssue(contentFile, section, {
-			severity: 'error',
-			message: `Cannot relocate "${imageName}". Multiple files with this filename were found: ${candidates.map(getCandidateLabel).join(', ')}.`,
-			fix: 'Move the intended file manually or rename files so the move is unambiguous.',
-		});
-		return null;
-	}
-
-	const sourceCandidate = candidates[0];
-	const sourcePath = sourceCandidate.imagePath;
-	const referencesAtCurrentLocation = (expectedReferencesByPath.get(sourcePath) ?? [])
-		.filter((expectedReference) => expectedReference.contentFile !== contentFile);
-
-	if (referencesAtCurrentLocation.length > 0) {
-		addSectionIssue(contentFile, section, {
-			severity: 'error',
-			message: `Cannot relocate "${imageName}" from ${getCandidateLabel(sourceCandidate)} because it is still referenced from ${referencesAtCurrentLocation.map((expectedReference) => getReferenceLabel(expectedReference.contentFile, expectedReference.section)).join(', ')}.`,
-			fix: 'Remove the extra reference, duplicate the image file manually, or rename one of the image files so the intended move is unambiguous.',
-		});
-		return null;
-	}
-
-	if (!imageMoves.some((move) => move.from === sourcePath && move.to === expectedPath)) {
-		imageMoves.push({
-			imageName,
-			from: sourcePath,
-			to: expectedPath,
-			contentFile,
-			sourceContentFile: sourceCandidate.contentFile,
-			section,
-			crossRoot: sourceCandidate.contentFile !== contentFile,
-		});
-	}
-	referencedImagePaths.add(sourcePath);
-
-	if (!shouldWrite) {
-		addSectionIssue(contentFile, section, {
-			severity: 'error',
-			message: `Image "${imageName}" is used here but is located in ${getCandidateLabel(sourceCandidate)}.`,
-			fix: sourceCandidate.contentFile === contentFile
-				? 'Run norna content:sync to move it directly into the current page image root.'
-				: `Run norna content:sync to move it from ${getRootLabel(sourceCandidate.contentFile)} to ${getRootLabel(contentFile)}. Cross-page sync requires a clean git working tree when files are moved.`,
-		});
-	}
-
-	return sourcePath;
-};
-
 const warnAboutCarouselAspectRatios = async (contentFile, section, block, sourcePathsByImage) => {
 	if (block.type !== 'image-carousel') return;
 
@@ -400,20 +224,48 @@ try {
 	}
 }
 
-const contentFiles = await getContentFiles();
+const siteStructure = await getSiteStructure();
+const contentFiles = siteStructure.contentFiles;
+for (const warning of siteStructure.warnings) {
+	addIssue({
+		severity: 'warning',
+		message: warning.message,
+		sectionId: warning.label,
+		sectionLabel: warning.label,
+	});
+}
 const allImageFiles = [];
+const managedImageReferences = [];
 const contentFileContexts = [];
-const globalImageCandidatesByName = new Map();
-const globalExpectedReferencesByPath = new Map();
 
 for (const contentFile of contentFiles) {
-	const { frontmatter, body } = await readSiteFile(contentFile.contentPath, contentFile.contentLabel);
+	const { frontmatter, frontmatterBody, body, source } = await readSiteFile(contentFile.contentPath, contentFile.contentLabel);
 	const bodyLineOffset = frontmatter.split(/\r?\n/).length - 1;
+	const issueCountBeforeFrontmatter = issues.length;
 	validateFrontmatterIndentation(frontmatter, addIssue);
 	validateContentFrontmatterStructure(frontmatter, addIssue);
+	let frontmatterData = {};
+	if (!issues.slice(issueCountBeforeFrontmatter).some(({ severity }) => severity === 'error')) {
+		try {
+			frontmatterData = parseContentFrontmatter(frontmatterBody, contentFile.contentLabel);
+		} catch (error) {
+			addContentIssue(contentFile, {
+				severity: 'error',
+				message: error instanceof Error ? error.message : String(error),
+				fix: 'Correct the page frontmatter using the content reference and project-local schema help.',
+			});
+		}
+	}
 
-	const { headings, pageHeadings, prelude, sections } = await getBodySections(body);
-	const headingIdentifierIssues = getHeadingIdentifierIssues(headings);
+	const page = await parsePageMarkdownSource(source, {
+		label: contentFile.contentLabel,
+	});
+	const {
+		headingIssues: headingIdentifierIssues,
+		pageHeadings,
+		prelude,
+		regions: sections,
+	} = page;
 	const invalidHeadingLines = new Set();
 	for (const issue of headingIdentifierIssues) {
 		invalidHeadingLines.add(issue.heading.line);
@@ -437,9 +289,7 @@ for (const contentFile of contentFiles) {
 
 	for (const [imageName, candidates] of imageCandidatesByName) {
 		for (const imagePath of candidates) {
-			const candidate = { contentFile, imagePath };
-			allImageFiles.push(candidate);
-			addGlobalImageCandidate(globalImageCandidatesByName, imageName, candidate);
+			allImageFiles.push({ contentFile, imageName, imagePath });
 		}
 	}
 
@@ -457,10 +307,10 @@ for (const contentFile of contentFiles) {
 		});
 	}
 
-	if (sections[0] && !sections[0].isPageTitle) {
+	if (sections[0] && sections[0].kind !== 'page-intro') {
 		addContentIssue(contentFile, {
 			severity: 'error',
-			message: `The first content heading is "${sections[0].heading}", but a Norna page must start with its H1 title.`,
+			message: `The first content heading is "${sections[0].title}", but a Norna page must start with its H1 title.`,
 			fix: 'Add the page title first, for example "# About".',
 		});
 	}
@@ -474,18 +324,18 @@ for (const contentFile of contentFiles) {
 	}
 
 	for (const section of sections) {
-		if (section.isPageTitle) {
+		if (section.kind === 'page-intro') {
 			if (
 				pageHeadings.length === 1
 				&& sections[0] === section
-				&& !invalidHeadingLines.has(section.line)
+				&& !invalidHeadingLines.has(section.bodyLine)
 			) {
 				validSections.add(section);
 			}
 			continue;
 		}
 
-		if (invalidHeadingLines.has(section.line) || !section.id) continue;
+		if (invalidHeadingLines.has(section.bodyLine) || !section.id) continue;
 
 		if (sectionsById.has(section.id)) {
 			addSectionIssue(contentFile, section, {
@@ -503,31 +353,25 @@ for (const contentFile of contentFiles) {
 	for (const section of sections) {
 		if (!validSections.has(section)) continue;
 
-		const blockResults = extractNornaMarkdownBlockDiagnostics(section.text, {
-			label: contentFile.contentLabel,
-			lineOffset: bodyLineOffset + section.line - 1,
-		});
+		const blockResults = { blocks: section.blocks, errors: section.blockErrors };
 		blockResultsBySection.set(section, blockResults);
 
-		const inlineNoteResults = extractInlineNoteDiagnostics(section.text, {
-			label: contentFile.contentLabel,
-			lineOffset: bodyLineOffset + section.line - 1,
-		});
-		for (const error of inlineNoteResults.errors) {
+		for (const error of section.noteErrors) {
 			addSectionIssue(contentFile, section, {
 				severity: 'error',
 				message: error.message,
 			});
 		}
 
-		for (const reference of getNornaBlockImageReferences(blockResults.blocks)) {
-			const expectedPath = getExpectedImagePath(contentFile, reference.image);
-			addExpectedReference(globalExpectedReferencesByPath, expectedPath, { contentFile, section, reference });
+		for (const reference of section.managedImages) {
+			managedImageReferences.push({ contentFile, section, reference });
 		}
 	}
 
 	contentFileContexts.push({
 		contentFile,
+		frontmatterData,
+		page,
 		sections,
 		validSections,
 		blockResultsBySection,
@@ -535,6 +379,44 @@ for (const contentFile of contentFiles) {
 	});
 }
 
+const siteLinkGraph = createSiteLinkGraph({
+	pageDocuments: contentFileContexts.map(({ contentFile, frontmatterData, page }) => ({
+		contentFile,
+		data: frontmatterData,
+		document: page,
+	})),
+	publicFiles: await getSitePublicFiles(),
+	siteStructure,
+});
+for (const issue of siteLinkGraph.diagnostics) {
+	addContentIssue(issue.reference?.sourceContentFile ?? issue.contentFile, issue);
+}
+
+const imageSyncPlan = createImageSyncPlan({
+	imageCandidates: allImageFiles,
+	references: managedImageReferences,
+	reportMisplaced: !shouldWrite,
+});
+const {
+	moves: imageMoves,
+	referencedImagePaths,
+	resolvedPathByReference,
+} = imageSyncPlan;
+const plannerIssuesByReference = new Map();
+const plannerConflictIssues = [];
+
+for (const plannerIssue of imageSyncPlan.issues) {
+	if (plannerIssue.phase === 'conflict') {
+		plannerConflictIssues.push(plannerIssue);
+		continue;
+	}
+
+	if (!plannerIssuesByReference.has(plannerIssue.reference)) {
+		plannerIssuesByReference.set(plannerIssue.reference, []);
+	}
+	plannerIssuesByReference.get(plannerIssue.reference).push(plannerIssue);
+}
+
 for (const context of contentFileContexts) {
 	const {
 		contentFile,
@@ -555,8 +437,7 @@ for (const context of contentFileContexts) {
 	for (const section of sections) {
 		if (!validSections.has(section)) continue;
 
-		const markdownImages = extractMarkdownImageReferences(section.text);
-		for (const reference of markdownImages) {
+		for (const reference of section.markdownImages) {
 			addSectionIssue(contentFile, section, {
 				severity: 'warning',
 				message: `Markdown image "${reference.target}" references a local image that is not managed by Norna.`,
@@ -583,14 +464,12 @@ for (const context of contentFileContexts) {
 		}
 
 		const sourcePathsByImage = new Map();
-		for (const reference of getNornaBlockImageReferences(blocks)) {
-			const sourcePath = await validateImageReference(
-				contentFile,
-				section,
-				reference,
-				globalImageCandidatesByName,
-				globalExpectedReferencesByPath,
-			);
+		for (const reference of section.managedImages) {
+			for (const plannerIssue of plannerIssuesByReference.get(reference) ?? []) {
+				addSectionIssue(plannerIssue.contentFile, plannerIssue.section, plannerIssue.issue);
+			}
+
+			const sourcePath = resolvedPathByReference.get(reference);
 			if (sourcePath) {
 				sourcePathsByImage.set(reference.image, sourcePath);
 			}
@@ -602,17 +481,15 @@ for (const context of contentFileContexts) {
 	}
 }
 
+for (const plannerIssue of plannerConflictIssues) {
+	addSectionIssue(plannerIssue.contentFile, plannerIssue.section, plannerIssue.issue);
+}
+
 const unreferencedImages = allImageFiles
 	.filter(({ imagePath }) => !referencedImagePaths.has(imagePath))
 	.map(({ contentFile, imagePath }) => `${contentFile.imagesLabel}/${toPosixPath(path.relative(contentFile.imagesDir, imagePath))}`)
 	.sort((left, right) => left.localeCompare(right, 'sv'));
 
-addConflictingMoveIssues();
-
-if (shouldWrite) {
-	await assertCleanGitForCrossRootSync(imageMoves);
-}
-
 if (hasErrors()) {
 	printReport(shouldWrite ? 'Content sync failed.' : 'Content check failed.', unreferencedImages);
 	process.exit(1);
@@ -631,14 +508,51 @@ if (imageMoves.length === 0) {
 	process.exit(0);
 }
 
-const canWrite = await promptForWrite();
+const canWrite = await promptForWrite(imageMoves);
 if (!canWrite) {
 	console.log('Aborted. No file was changed.');
 	process.exit(1);
 }
 
-for (const move of imageMoves) {
-	await mkdir(path.dirname(move.to), { recursive: true });
-	await rename(move.from, move.to);
+const applyResult = await applyImageSyncPlan(imageMoves);
+for (const move of applyResult.completedMoves) {
 	console.log(`Moved image "${move.imageName}" to ${move.contentFile.imagesLabel}/.`);
 }
+
+if (applyResult.failedMove) {
+	const move = applyResult.failedMove;
+	const error = applyResult.error;
+	const sourceLabel = getImageCandidateLabel({ contentFile: move.sourceContentFile, imagePath: move.from });
+	const destinationLabel = getExpectedImageLabel(move.contentFile, move.imageName);
+	const lines = [
+		'',
+		`Content sync stopped after ${applyResult.completedMoves.length} of ${imageMoves.length} image moves.`,
+	];
+
+	if (error?.code === 'EXDEV') {
+		lines.push(
+			`Cannot move "${move.imageName}" because the source and destination are on different filesystems.`,
+			`Move it manually from ${sourceLabel} to ${destinationLabel}.`,
+		);
+	} else {
+		lines.push(
+			`Could not move "${move.imageName}" from ${sourceLabel} to ${destinationLabel}.`,
+			`Filesystem error${error?.code ? ` (${error.code})` : ''}: ${error?.message ?? String(error)}`,
+		);
+	}
+
+	if (applyResult.completedMoves.length > 0) {
+		lines.push('', 'Completed moves:', ...getMovePlanLines(applyResult.completedMoves).slice(1));
+	}
+
+	lines.push(
+		'',
+		'Remaining moves:',
+		...getMovePlanLines(applyResult.remainingMoves).slice(1),
+		'',
+		'Fix the reported filesystem problem, then run content:sync again. Already completed moves will be kept.',
+	);
+
+	console.error(lines.join('\n'));
+	process.exit(1);
+}

package/scripts/sync-site-public.mjs

@@ -1,11 +1,14 @@
-import { cp, mkdir, readdir, rm } from 'node:fs/promises';
+import { cp, mkdir, readdir, rm, writeFile } from 'node:fs/promises';
 import path from 'node:path';
+import projectConfig from './lib/project-config.mjs';
+import { createSitemapXml, sitemapFilename } from './lib/sitemap.mjs';
 import {
 	astroPublicDir,
 	astroPublicLabel,
 	sitePublicDir,
 	sitePublicLabel,
 } from './lib/site-paths.mjs';
+import { getSiteStructure } from './lib/site-structure.mjs';
 
 const keepAstroPublicEntries = new Set(['images']);
 
@@ -21,6 +24,21 @@ const readDirectory = async (directory) => {
 	}
 };
 
+const sourceEntries = await readDirectory(sitePublicDir);
+const sitemapConflict = sourceEntries.find(({ name }) => name.toLowerCase() === sitemapFilename);
+if (sitemapConflict) {
+	throw new Error([
+		`${sitePublicLabel}/${sitemapConflict.name} conflicts with Norna's generated ${sitemapFilename}.`,
+		`Remove that source file. Norna generates ${sitemapFilename} from the public page tree and the URL in site/config.yaml.`,
+	].join('\n'));
+}
+
+const siteStructure = await getSiteStructure();
+const sitemapXml = createSitemapXml({
+	siteStructure,
+	siteUrl: projectConfig.site.url,
+});
+
 await mkdir(astroPublicDir, { recursive: true });
 
 for (const entry of await readDirectory(astroPublicDir)) {
@@ -31,7 +49,7 @@ for (const entry of await readDirectory(astroPublicDir)) {
 	await rm(path.join(astroPublicDir, entry.name), { force: true, recursive: true });
 }
 
-for (const entry of await readDirectory(sitePublicDir)) {
+for (const entry of sourceEntries) {
 	await cp(
 		path.join(sitePublicDir, entry.name),
 		path.join(astroPublicDir, entry.name),
@@ -39,4 +57,7 @@ for (const entry of await readDirectory(sitePublicDir)) {
 	);
 }
 
+await writeFile(path.join(astroPublicDir, sitemapFilename), sitemapXml);
+
 console.log(`Synced ${sitePublicLabel}/ to ${astroPublicLabel}/.`);
+console.log(`Generated ${astroPublicLabel}/${sitemapFilename} for ${siteStructure.contentFiles.length} public page${siteStructure.contentFiles.length === 1 ? '' : 's'}.`);