feat(housekeeping): cut over administration to ase

src/features/housekeeping/migration/discover-legacy-pages.ts

@@ -1,4 +1,4 @@
-import { readdirSync } from "node:fs";
+import { existsSync, readdirSync } from "node:fs";
 import { join, relative } from "node:path";
 import type { LegacyPage, LegacySurface } from "./types";
 
@@ -23,6 +23,7 @@ function discoverSurface(
 ): LegacyPage[] {
 	const surfaceDirectory = join(rootDir, "src", "app", surface);
 	const pages: LegacyPage[] = [];
+	if (!existsSync(surfaceDirectory)) return pages;
 
 	function walk(directory: string): void {
 		for (const entry of readdirSync(directory, { withFileTypes: true })) {
@@ -51,6 +52,22 @@ function discoverSurface(
 	return pages;
 }
 
+export function recordedLegacyPages(
+	entries: readonly LegacyPage[],
+): LegacyPage[] {
+	return entries
+		.map(({ surface, legacyPath, sourceFile }) => ({
+			surface,
+			legacyPath,
+			sourceFile,
+		}))
+		.sort((a, b) =>
+			`${a.surface}:${a.legacyPath}:${a.sourceFile}`.localeCompare(
+				`${b.surface}:${b.legacyPath}:${b.sourceFile}`,
+			),
+		);
+}
+
 export function discoverLegacyPages(rootDir = process.cwd()): LegacyPage[] {
 	return (["admin", "mod"] as const)
 		.flatMap((surface) => discoverSurface(rootDir, surface))