x

.agents/orchestrator/plan.md

@@ -1,20 +1,30 @@
-# Execution Plan: Update Category Image Feature
+# Execution Plan: Premium Mega Menu
 
-## Step 1: Codebase Exploration and detail verification
-- Target: Run an Explorer to verify category routes in `apps/backend` and existing MCP tools in `apps/mcp-server`.
-- Verification: Explorer reports on exact files, routes, schemas, and confirms where categories are defined, where the database models are, and how other MCP tools interface with the backend.
+## Step 1: E2E Testing Track (M1)
+- Target: Spawn an E2E testing sub-orchestrator to write requirement-driven E2E tests for the 3-image layout Mega Menu.
+- Verification: Tests cover:
+  - Root Image on the left.
+  - Column Image inside grid next to/above column title.
+  - Hovering links displaying the correct link image on the right.
+  - Lazy loading of hover images.
+  - Responsive layout (mobile drawer hides complex image layouts gracefully).
 
-## Step 2: M1 - Backend Implementation
-- Target: Implement the PATCH endpoint `PATCH /api/categories/:id/image` in `apps/backend/src/routes/categories.ts` to update the `imageUrl` of a category.
-- Verification: Worker runs typecheck and build in `apps/backend`.
+## Step 2: Database & Backend Updates (M2)
+- Target: Spawn database and backend lead agents to:
+  - Add optional `rootImage` to `Menu`, and `columnImage`, `hoverImage` to `MenuItem` in `apps/backend/prisma/schema.prisma`.
+  - Create and run migration.
+  - Update `packages/types/index.ts` to include the three image fields.
+  - Update Elysia route body validation schemas and database saving logic in `apps/backend/src/routes/menus.ts`.
+  - Update `apps/mcp-server/menu-tools.ts` and `menu-toolkit.ts` if needed.
+- Verification: Monorepo compiles successfully (`npm run typecheck` and builds pass).
 
-## Step 3: M2 - MCP Tool Implementation
-- Target: Add `update_category_image` tool definition in `apps/mcp-server/index.ts` to accept `id` (number) and `imageUrl` (string). Implement the handler to call the backend endpoint `PATCH /categories/:id/image`.
-- Verification: Worker runs typecheck and build in `apps/mcp-server`.
+## Step 3: Storefront & Admin UI (M3)
+- Target: Spawn frontend lead and Next.js SEO architect agents to:
+  - Update the admin builder `apps/admin/src/pages/MenuManagerPage.tsx` to support configuring `rootImage`, `columnImage`, and `hoverImage` inside the tree node editor.
+  - Update `apps/spa/src/store/menuStore.ts` and `apps/spa/src/components/DesktopMegaMenu.tsx` / `MobileDrawer.tsx` to use the new fields.
+  - Update `apps/website/src/components/navigation/menuTypes.ts` and `apps/website/src/components/navigation/DesktopMegaMenu.tsx` / `MobileDrawer.tsx` to implement the 3-image layout using `next/image` with lazy loading and fade-in animations.
+- Verification: No typecheck errors and UI renders correctly based on configured values.
 
-## Step 4: M3 - E2E Verification & Auditing
-- Target: 
-  - Run typecheck and build across the monorepo to ensure compilation.
-  - Verify `update_category_image` tool registers on the MCP server.
-  - Run a script or test to confirm that calling the tool successfully updates a category's `imageUrl` in the database.
-  - Execute Forensic Auditor to verify code integrity and no cheating.
+## Step 4: E2E & Adversarial Hardening (M4)
+- Target: Run E2E tests, add white-box/adversarial tests (Phase 2), and run the Forensic Auditor to audit code integrity.
+- Verification: All tests pass, Forensic Auditor gives a CLEAN verdict.