refactor(housekeeping): adopt ase route namespace

src/app/ase-next/[domain]/layout.tsx

@@ -35,8 +35,11 @@ export default async function AdminNextDomainLayout({
 	if (!satisfiesCapability(context, activeDomain.capability)) notFound();
 
 	const translate = await getTranslations("pages.housekeeping");
-	const navigation = buildHousekeepingNavigation(registry, context, (key) =>
+	const navigation = buildHousekeepingNavigation(
-		translate(namespaceKey(key) as never),
+		registry,
+		context,
+		"preview",
+		(key) => translate(namespaceKey(key) as never),
 	);
 
 	return (

src/app/ase-next/page.tsx

@@ -1,6 +1,7 @@
 import { notFound, redirect } from "next/navigation";
 import { satisfiesCapability } from "@/features/housekeeping/foundation/capability-context";
 import { createHousekeepingRegistry } from "@/features/housekeeping/foundation/registry";
+import { toHousekeepingHref } from "@/features/housekeeping/foundation/routing/href";
 import { getHousekeepingCapabilityContext } from "@/features/housekeeping/foundation/server-capability-context";
 import { HOUSEKEEPING_MANIFESTS } from "@/features/housekeeping/manifests";
 
@@ -13,5 +14,5 @@ export default async function AdminNextPage() {
 
 	if (!firstVisibleDomain) notFound();
 
-	redirect(firstVisibleDomain.previewHref);
+	redirect(toHousekeepingHref(firstVisibleDomain.canonicalHref, "preview"));
 }

src/features/housekeeping/domains/content/manifest.ts

@@ -9,7 +9,7 @@ export const contentManifest = {
 	labelKey: "pages.housekeeping.domains.content.title",
 	descriptionKey: "pages.housekeeping.domains.content.description",
 	iconId: "file-text",
-	previewHref: "/admin-next/content",
+	canonicalHref: "/ase/content",
 	capability: anyCapability(
 		PERMS.NEWS_VIEW,
 		PERMS.PAGES_VIEW,

src/features/housekeeping/domains/economy/manifest.ts

@@ -9,7 +9,7 @@ export const economyManifest = {
 	labelKey: "pages.housekeeping.domains.economy.title",
 	descriptionKey: "pages.housekeeping.domains.economy.description",
 	iconId: "gem",
-	previewHref: "/admin-next/economy",
+	canonicalHref: "/ase/economy",
 	capability: anyCapability(
 		PERMS.CATALOG_VIEW,
 		PERMS.SHOP_VIEW,

src/features/housekeeping/domains/hotel/manifest.ts

@@ -9,7 +9,7 @@ export const hotelManifest = {
 	labelKey: "pages.housekeeping.domains.hotel.title",
 	descriptionKey: "pages.housekeeping.domains.hotel.description",
 	iconId: "hotel",
-	previewHref: "/admin-next/hotel",
+	canonicalHref: "/ase/hotel",
 	capability: anyCapability(
 		PERMS.ROOMS_VIEW,
 		PERMS.RADIO_VIEW,

src/features/housekeeping/domains/operations/manifest.ts

@@ -9,7 +9,7 @@ export const operationsManifest = {
 	labelKey: "pages.housekeeping.domains.operations.title",
 	descriptionKey: "pages.housekeeping.domains.operations.description",
 	iconId: "inbox",
-	previewHref: "/admin-next/operations",
+	canonicalHref: "/ase",
 	capability: anyCapability(PERMS.ADMIN_DASHBOARD),
 	routes: [],
 	searchProviders: [],

src/features/housekeeping/domains/people/manifest.ts

@@ -9,7 +9,7 @@ export const peopleManifest = {
 	labelKey: "pages.housekeeping.domains.people.title",
 	descriptionKey: "pages.housekeeping.domains.people.description",
 	iconId: "users",
-	previewHref: "/admin-next/people",
+	canonicalHref: "/ase/people",
 	capability: anyCapability(
 		PERMS.USERS_VIEW,
 		PERMS.MODERATION_VIEW,

src/features/housekeeping/domains/system/manifest.ts

@@ -9,7 +9,7 @@ export const systemManifest = {
 	labelKey: "pages.housekeeping.domains.system.title",
 	descriptionKey: "pages.housekeeping.domains.system.description",
 	iconId: "settings",
-	previewHref: "/admin-next/system",
+	canonicalHref: "/ase/system",
 	capability: anyCapability(
 		PERMS.SETTINGS_VIEW,
 		PERMS.LOGS_VIEW,

src/features/housekeeping/foundation/contracts/contracts.test.ts

@@ -28,7 +28,7 @@ const workItem = {
 	occurredAt: "2026-08-24T12:00:00.000Z",
 	titleKey: "pages.housekeeping.items.ticket",
 	context: { ticketId: "42" },
-	href: "/admin-next/people/tickets/42",
+	href: "/ase-next/people/tickets/42",
 	freshness: "fresh",
 } satisfies HousekeepingWorkItem;
 
@@ -36,7 +36,7 @@ const searchResult = {
 	id: "user-42",
 	domain: "people",
 	title: "operator",
-	href: "/admin-next/people/users/42",
+	href: "/ase-next/people/users/42",
 } satisfies HousekeepingSearchResult;
 
 const searchProvider: HousekeepingSearchProvider = {
@@ -87,7 +87,7 @@ const manifest: HousekeepingDomainManifest = {
 	labelKey: "pages.housekeeping.domains.people.title",
 	descriptionKey: "pages.housekeeping.domains.people.description",
 	iconId: "users",
-	previewHref: "/admin-next/people",
+	canonicalHref: "/ase-next/people",
 	capability,
 	routes: [],
 	searchProviders: [searchProvider],

src/features/housekeeping/foundation/contracts/domain.ts

@@ -4,10 +4,12 @@ import type { HousekeepingInboxSource } from "./inbox";
 import type { HousekeepingSearchProvider } from "./search";
 import type { HousekeepingWidgetDefinition } from "./widget";
 
+export type HousekeepingSurface = "preview" | "canonical";
+export type CanonicalHousekeepingHref = `/ase${string}`;
 export interface HousekeepingRouteDefinition {
 	id: string;
 	labelKey: string;
-	href: string;
+	href: CanonicalHousekeepingHref;
 	capability: CapabilityRequirement;
 	matchPrefixes?: readonly string[];
 }
@@ -17,7 +19,7 @@ export interface HousekeepingDomainManifest {
 	labelKey: string;
 	descriptionKey: string;
 	iconId: "inbox" | "users" | "file-text" | "gem" | "hotel" | "settings";
-	previewHref: `/admin-next/${HousekeepingDomainId}`;
+	canonicalHref: CanonicalHousekeepingHref;
 	capability: CapabilityRequirement;
 	routes: readonly HousekeepingRouteDefinition[];
 	searchProviders: readonly HousekeepingSearchProvider[];

src/features/housekeeping/foundation/contracts/index.ts

@@ -7,8 +7,10 @@ export {
 } from "./capability";
 export type { HousekeepingCommand } from "./command";
 export type {
+	CanonicalHousekeepingHref,
 	HousekeepingDomainManifest,
 	HousekeepingRouteDefinition,
+	HousekeepingSurface,
 } from "./domain";
 export type {
 	HousekeepingInboxSource,

src/features/housekeeping/foundation/foundation-source-contract.test.ts

@@ -555,7 +555,7 @@ describe("housekeeping foundation completion contracts", () => {
 		for (const path of [
 			"src/app/admin/layout.tsx",
 			"src/app/mod/layout.tsx",
-			"src/app/admin-next/layout.tsx",
+			"src/app/ase-next/layout.tsx",
 		]) {
 			expect(existsSync(path), path).toBe(true);
 		}

src/features/housekeeping/foundation/navigation.ts

@@ -3,8 +3,10 @@ import { satisfiesCapability } from "./capability-context";
 import type {
 	HousekeepingCapabilityContext,
 	HousekeepingDomainManifest,
+	HousekeepingSurface,
 } from "./contracts";
 import type { HousekeepingRegistry } from "./registry";
+import { toHousekeepingHref } from "./routing/href";
 
 export interface HousekeepingNavigationDomain {
 	id: HousekeepingDomainId;
@@ -18,13 +20,14 @@ export interface HousekeepingNavigationDomain {
 export function buildHousekeepingNavigation(
 	registry: HousekeepingRegistry,
 	context: HousekeepingCapabilityContext,
+	surface: HousekeepingSurface,
 	translate: (key: string) => string,
 ): readonly HousekeepingNavigationDomain[] {
 	return registry.domains
 		.filter((domain) => satisfiesCapability(context, domain.capability))
 		.map((domain) => ({
 			id: domain.id,
-			href: domain.previewHref,
+			href: toHousekeepingHref(domain.canonicalHref, surface),
 			iconId: domain.iconId,
 			label: translate(domain.labelKey),
 			description: translate(domain.descriptionKey),
@@ -32,7 +35,7 @@ export function buildHousekeepingNavigation(
 				.filter((route) => satisfiesCapability(context, route.capability))
 				.map((route) => ({
 					id: route.id,
-					href: route.href,
+					href: toHousekeepingHref(route.href, surface),
 					label: translate(route.labelKey),
 				})),
 		}));

src/features/housekeeping/foundation/page/housekeeping-page-state.test.tsx

@@ -75,12 +75,12 @@ describe("HousekeepingPageState", () => {
 				state="error"
 				title="Could not load"
 				description="Try again later"
-				retryAction={<a href="/admin-next/operations">Retry preview</a>}
+				retryAction={<a href="/ase-next/operations">Retry preview</a>}
 			/>,
 		);
 
 		expect(html).toContain('role="alert"');
-		expect(html).toContain('href="/admin-next/operations"');
+		expect(html).toContain('href="/ase-next/operations"');
 		expect(html).toContain(">Retry preview<");
 	});
 });
@@ -92,7 +92,7 @@ describe("HousekeepingPageShell", () => {
 				title="People"
 				description="Review operator-facing people data"
 				context={<span>Preview context</span>}
-				primaryAction={<a href="/admin-next/people/new">Create preview</a>}
+				primaryAction={<a href="/ase-next/people/new">Create preview</a>}
 			>
 				<p>Page body</p>
 			</HousekeepingPageShell>,
@@ -102,7 +102,7 @@ describe("HousekeepingPageShell", () => {
 		expect(html).toContain(">People<");
 		expect(html).toContain(">Review operator-facing people data<");
 		expect(html).toContain(">Preview context<");
-		expect(html).toContain('href="/admin-next/people/new"');
+		expect(html).toContain('href="/ase-next/people/new"');
 		expect(html).toContain(">Create preview<");
 		expect(html).toContain(">Page body</p>");
 	});

src/features/housekeeping/foundation/registry.ts

@@ -34,8 +34,11 @@ export function createHousekeepingRegistry(
 		}
 		domainIds.add(manifest.id);
 
-		if (manifest.previewHref !== `/admin-next/${manifest.id}`) {
+		if (
-			throw new Error(`invalid preview href: ${manifest.previewHref}`);
+			manifest.canonicalHref !==
+			(manifest.id === "operations" ? "/ase" : `/ase/${manifest.id}`)
+		) {
+			throw new Error(`invalid canonical href: ${manifest.canonicalHref}`);
 		}
 		validateNonEmpty(manifest.labelKey, "label key");
 		validateNonEmpty(manifest.descriptionKey, "description key");
@@ -72,6 +75,9 @@ export function createHousekeepingRegistry(
 			routeIds.add(route.id);
 
 			validateNonEmpty(route.href, "route href");
+			if (route.href !== "/ase" && !route.href.startsWith("/ase/")) {
+				throw new Error(`invalid canonical route href: ${route.href}`);
+			}
 			if (routeHrefs.has(route.href)) {
 				throw new Error(`duplicate route href: ${route.href}`);
 			}

src/features/housekeeping/foundation/routing/href.test.ts

@@ -0,0 +1,21 @@
+import { describe, expect, it } from "vitest";
+import type { CanonicalHousekeepingHref } from "../contracts";
+import { toHousekeepingHref } from "./href";
+
+describe("toHousekeepingHref", () => {
+	it("keeps the canonical operations root unchanged", () => {
+		expect(toHousekeepingHref("/ase", "canonical")).toBe("/ase");
+	});
+
+	it("maps a canonical domain route to the preview namespace", () => {
+		expect(toHousekeepingHref("/ase/people/users", "preview")).toBe(
+			"/ase-next/people/users",
+		);
+	});
+
+	it("rejects paths outside the canonical ase namespace", () => {
+		expect(() =>
+			toHousekeepingHref("/admin" as CanonicalHousekeepingHref, "canonical"),
+		).toThrow("invalid canonical housekeeping href");
+	});
+});

src/features/housekeeping/foundation/routing/href.ts

@@ -0,0 +1,15 @@
+import type {
+	CanonicalHousekeepingHref,
+	HousekeepingSurface,
+} from "../contracts";
+
+export function toHousekeepingHref(
+	href: CanonicalHousekeepingHref,
+	surface: HousekeepingSurface,
+): CanonicalHousekeepingHref | `/ase-next${string}` {
+	if (href !== "/ase" && !href.startsWith("/ase/")) {
+		throw new Error(`invalid canonical housekeeping href: ${href}`);
+	}
+
+	return surface === "canonical" ? href : href.replace(/^\/ase/, "/ase-next");
+}

src/features/housekeeping/foundation/shell/housekeeping-shell.test.tsx

@@ -17,17 +17,17 @@ const labels = {
 const domains: readonly HousekeepingNavigationDomain[] = [
 	{
 		id: "operations",
-		href: "/admin-next/operations",
+		href: "/ase-next/operations",
 		iconId: "inbox",
 		label: "Operations",
 		description: "Manage operations",
 		items: [
-			{ id: "queue", href: "/admin-next/operations/queue", label: "Queue" },
+			{ id: "queue", href: "/ase-next/operations/queue", label: "Queue" },
 		],
 	},
 	{
 		id: "people",
-		href: "/admin-next/people",
+		href: "/ase-next/people",
 		iconId: "users",
 		label: "People",
 		description: "Manage people",
@@ -35,7 +35,7 @@ const domains: readonly HousekeepingNavigationDomain[] = [
 	},
 	{
 		id: "content",
-		href: "/admin-next/content",
+		href: "/ase-next/content",
 		iconId: "file-text",
 		label: "Content",
 		description: "Manage content",
@@ -43,7 +43,7 @@ const domains: readonly HousekeepingNavigationDomain[] = [
 	},
 	{
 		id: "economy",
-		href: "/admin-next/economy",
+		href: "/ase-next/economy",
 		iconId: "gem",
 		label: "Economy",
 		description: "Manage economy",
@@ -51,7 +51,7 @@ const domains: readonly HousekeepingNavigationDomain[] = [
 	},
 	{
 		id: "hotel",
-		href: "/admin-next/hotel",
+		href: "/ase-next/hotel",
 		iconId: "hotel",
 		label: "Hotel",
 		description: "Manage hotel",
@@ -59,7 +59,7 @@ const domains: readonly HousekeepingNavigationDomain[] = [
 	},
 	{
 		id: "system",
-		href: "/admin-next/system",
+		href: "/ase-next/system",
 		iconId: "settings",
 		label: "System",
 		description: "Manage system",
@@ -178,7 +178,7 @@ describe("HousekeepingShell", () => {
 		expect(html).toContain('<nav aria-label="Operations navigation"');
 		expect(html).toContain('<main id="housekeeping-content"');
 		expect(html).toContain(">Deck body</p>");
-		expect(html).toContain('href="/admin-next/operations/queue"');
+		expect(html).toContain('href="/ase-next/operations/queue"');
 		expect(html).toContain(">Queue<");
 		expect(html).toContain(">Nora<");
 		expect(html).toContain(">6<");
@@ -196,7 +196,7 @@ describe("HousekeepingShell", () => {
 		const activeAnchors = allAnchors.filter((anchor) =>
 			anchor.includes('aria-current="page"'),
 		);
-		const peopleAnchor = anchorForHref(html, "/admin-next/people");
+		const peopleAnchor = anchorForHref(html, "/ase-next/people");
 		for (const iconClass of [
 			"lucide-inbox",
 			"lucide-users",
@@ -222,7 +222,7 @@ describe("HousekeepingShell", () => {
 		);
 		expect(() => renderShell("system", domainsWithoutSystem)).not.toThrow();
 		const html = renderShell("system", domainsWithoutSystem);
-		expect(html).not.toContain('href="/admin-next/operations/queue"');
+		expect(html).not.toContain('href="/ase-next/operations/queue"');
 		expect(html).not.toContain(">Queue<");
 	});
 

src/features/housekeeping/migration/operations.ts

@@ -7,7 +7,7 @@ export const operationsMigrationEntries: readonly MigrationEntry[] = [
 		legacyPath: "/admin",
 		sourceFile: "src/app/admin/page.tsx",
 		targetDomain: "operations",
-		targetPath: "/admin/work",
+		targetPath: "/ase",
 		decision: "REBUILD",
 		capabilities: { read: [PERMS.ADMIN_DASHBOARD], mutate: [] },
 		dependencies: {

src/features/housekeeping/migration/validate-matrix.test.ts

@@ -11,7 +11,7 @@ const page = (legacyPath: string): LegacyPage => ({
 const entry = (legacyPath: string): MigrationEntry => ({
 	...page(legacyPath),
 	targetDomain: "system",
-	targetPath: "/admin/system/example",
+	targetPath: "/ase/system/example",
 	decision: "REHOST",
 	capabilities: { read: ["admin.dashboard"], mutate: [] },
 	dependencies: { queries: [], mutations: [] },
@@ -112,7 +112,7 @@ describe("validateMigrationEntries", () => {
 			"MERGE requires requiredTests: /admin",
 			"mutation dependencies require auditRequirement: /admin",
 			"mutation dependencies require mutate capabilities: /admin",
-			"non-REMOVE targetPath must start with /admin/: /admin",
+			"non-REMOVE targetPath must use /ase: /admin",
 			"prohibited placeholder: /admin",
 			"VERIFIED requires parityEvidence: /admin",
 		]);
@@ -134,3 +134,19 @@ describe("validateMigrationEntries", () => {
 		).toEqual(["REHOST requires targetPath: /admin"]);
 	});
 });
+
+it("requires non-removal targets to use the ase namespace", () => {
+	expect(
+		validateMigrationEntries(
+			[page("/admin")],
+			[{ ...entry("/admin"), targetPath: "/ase/system/example" }],
+		),
+	).toEqual([]);
+
+	expect(
+		validateMigrationEntries(
+			[page("/admin")],
+			[{ ...entry("/admin"), targetPath: "/admin/system/example" }],
+		),
+	).toContain("non-REMOVE targetPath must use /ase: /admin");
+});

src/features/housekeeping/migration/validate-matrix.ts

@@ -84,11 +84,9 @@ export function validateMigrationEntries(
 		if (
 			entry.targetPath !== null &&
 			entry.decision !== "REMOVE" &&
-			!entry.targetPath.startsWith("/admin/")
+			!(entry.targetPath === "/ase" || entry.targetPath.startsWith("/ase/"))
 		) {
-			issues.add(
+			issues.add(`non-REMOVE targetPath must use /ase: ${legacyPath}`);
-				`non-REMOVE targetPath must start with /admin/: ${legacyPath}`,
-			);
 		}
 
 		if (

src/lib/admin-theme-source-audit.test.ts

@@ -5,7 +5,7 @@ import { describe, expect, it } from "vitest";
 const ROOTS = [
 	"src/app/admin",
 	"src/components/admin",
-	"src/app/admin-next",
+	"src/app/ase-next",
 	"src/features/housekeeping",
 ];
 const GRAPHICAL_ALLOWLIST = [