Implement create custom recommendations

app/api/create-flow/methods/route.ts

@@ -0,0 +1,56 @@
+import { NextResponse, type NextRequest } from "next/server";
+import { isDatabaseConfigured } from "../../../../lib/server/env";
+import { listMethodRecommendations } from "../../../../lib/server/methodRecommendations";
+import { dbUnavailable } from "../../../../lib/server/responses";
+import {
+  SECTION_IDS,
+  type SectionId,
+  parseRequestedFacetsFromSearchParams,
+} from "../../../../lib/server/validation/methodFacetsSchemas";
+
+const SECTION_SET = new Set<string>(SECTION_IDS);
+
+/**
+ * GET /api/create-flow/methods?section=<section>[&facet.*=...]
+ *
+ * Returns slugs + per-method match scores for one of the four card-deck
+ * sections; the wizard renders by looking up the slug in the section's
+ * messages file (`useMessages().create.customRule.<section>.methods`).
+ *
+ * See `docs/guides/template-recommendation-matrix.md` §9.2 / §10.
+ */
+export async function GET(request: NextRequest) {
+  if (!isDatabaseConfigured()) {
+    return dbUnavailable();
+  }
+
+  const sectionParam = request.nextUrl.searchParams.get("section");
+  if (!sectionParam || !SECTION_SET.has(sectionParam)) {
+    return NextResponse.json(
+      {
+        error: {
+          code: "validation_error",
+          message: `Unknown section. Expected one of: ${SECTION_IDS.join(", ")}`,
+        },
+      },
+      { status: 400 },
+    );
+  }
+  const section = sectionParam as SectionId;
+
+  const facets = parseRequestedFacetsFromSearchParams(
+    request.nextUrl.searchParams,
+  );
+  const result = await listMethodRecommendations({ section, facets });
+  if (!result) {
+    // DB query failed; return empty so the wizard falls back to its messages
+    // deck in authoring order (§10).
+    return NextResponse.json({ section, methods: [] });
+  }
+
+  const methods = result.rankedSlugs.map((slug) => ({
+    slug,
+    matches: result.matchesBySlug[slug] ?? { score: 0, matchedFacets: [] },
+  }));
+  return NextResponse.json({ section, methods });
+}

app/api/drafts/me/route.ts

@@ -68,3 +68,20 @@ export async function PUT(request: NextRequest) {
     draft: { payload: draft.payload, updatedAt: draft.updatedAt },
   });
 }
+
+export async function DELETE() {
+  if (!isDatabaseConfigured()) {
+    return dbUnavailable();
+  }
+
+  const user = await getSessionUser();
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  // Idempotent: missing draft is a no-op so callers can fire-and-forget after
+  // publish / exit without worrying about prior state.
+  await prisma.ruleDraft.deleteMany({ where: { userId: user.id } });
+
+  return NextResponse.json({ ok: true });
+}

app/api/templates/route.ts

@@ -1,17 +1,31 @@
-import { NextResponse } from "next/server";
+import { NextResponse, type NextRequest } from "next/server";
 import { isDatabaseConfigured } from "../../../lib/server/env";
-import { listRuleTemplatesFromDb } from "../../../lib/server/ruleTemplates";
+import { listRankedRuleTemplatesFromDb } from "../../../lib/server/ruleTemplates";
 import { dbUnavailable } from "../../../lib/server/responses";
+import { parseRequestedFacetsFromSearchParams } from "../../../lib/server/validation/methodFacetsSchemas";
 
 /**
- * Curated rule templates for recommendations (seed via Prisma Studio or a script).
+ * GET /api/templates
+ *
+ * No params → curated ordering (`featured` desc, `sortOrder` asc, `title`
+ * asc). With `facet.<group>=<value>` query params (repeatable per group),
+ * templates are re-ranked by composed-method match count; ties fall back to
+ * the curated order, score-0 templates remain at the end.
+ *
+ * See `docs/guides/template-recommendation-matrix.md` §9.1.
  */
-export async function GET() {
+export async function GET(request: NextRequest) {
   if (!isDatabaseConfigured()) {
     return dbUnavailable();
   }
 
-  const templates = await listRuleTemplatesFromDb();
+  const facets = parseRequestedFacetsFromSearchParams(
+    request.nextUrl.searchParams,
+  );
+  const { templates, scores } = await listRankedRuleTemplatesFromDb(facets);
+  const hasScores = Object.keys(scores).length > 0;
 
-  return NextResponse.json({ templates });
+  return NextResponse.json(
+    hasScores ? { templates, scores } : { templates },
+  );
 }