feat: define housekeeping foundation contracts

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

@@ -0,0 +1,22 @@
+import type { HousekeepingDomainId } from "../../migration/types";
+import type { HousekeepingCapabilityContext } from "./capability";
+import type { HousekeepingResult } from "./result";
+
+export interface HousekeepingSearchInput {
+	term: string;
+	limit: number;
+}
+
+export interface HousekeepingSearchResult {
+	id: string;
+	domain: HousekeepingDomainId;
+	title: string;
+	href: string;
+}
+
+export interface HousekeepingSearchProvider {
+	search(
+		context: HousekeepingCapabilityContext,
+		input: HousekeepingSearchInput,
+	): Promise<HousekeepingResult<readonly HousekeepingSearchResult[]>>;
+}