x

.agents/sub_orch_e2e/BRIEFING.md

@@ -0,0 +1,69 @@
+# BRIEFING — 2026-06-28T21:20:08-04:00
+
+## Mission
+Establish the E2E testing track for the Premium Mega Menu, verifying image payloads, server rendering, mobile drawer behavior, and MCP tools.
+
+## 🔒 My Identity
+- Archetype: orchestrator
+- Roles: orchestrator, user_liaison, human_reporter, successor
+- Working directory: /home/ti/git/homaroma/.agents/sub_orch_e2e
+- Original parent: parent
+- Original parent conversation ID: f5557127-1c9c-40d2-90e6-d996a7381786
+
+## 🔒 My Workflow
+- **Pattern**: Project / E2E Testing Track
+- **Scope document**: /home/ti/git/homaroma/.agents/sub_orch_e2e/SCOPE.md
+1. **Decompose**: Decompose the E2E testing track into milestones: Test Infra Design, Test Suite Implementation, Verification, Publication.
+2. **Dispatch & Execute**:
+   - **Direct (iteration loop)**: Spawn Explorer, Worker, Reviewer, Challenger, and Auditor.
+3. **On failure** (in this order):
+   - Retry: nudge stuck agent or re-send task
+   - Replace: spawn fresh agent with partial progress
+   - Skip: proceed without (only if non-critical)
+   - Redistribute: split stuck agent's remaining work
+   - Redesign: re-partition decomposition
+   - Escalate: report to parent (sub-orchestrators only, last resort)
+4. **Succession**: Self-succeed at 16 spawns, write handoff.md, spawn successor.
+- **Work items**:
+  1. Define test strategy and feature inventory (TEST_INFRA.md) [pending]
+  2. Implement E2E test suite [pending]
+  3. Verify test execution against spawned backend and storefront [pending]
+  4. Verify MCP tools payload read/write [pending]
+  5. Publish TEST_READY.md and report to parent [pending]
+- **Current phase**: 1
+- **Current focus**: Define test strategy and feature inventory
+
+## 🔒 Key Constraints
+- NEVER write, modify, or create source code files directly.
+- NEVER run build/test commands yourself — require workers to do so.
+- You MAY use file-editing tools ONLY for metadata/state files (.md) in your .agents/ folder.
+- Never reuse a subagent after it has delivered its handoff — always spawn fresh.
+
+## Current Parent
+- Conversation ID: f5557127-1c9c-40d2-90e6-d996a7381786
+- Updated: not yet
+
+## Key Decisions Made
+- Initializing E2E testing track for Premium Mega Menu.
+
+## Team Roster
+| Agent | Type | Work Item | Status | Conv ID |
+|-------|------|-----------|--------|---------|
+| explorer_m1 | teamwork_preview_explorer | Explore codebase & MCP tools | in-progress | 14f59dcd-b8c9-48ff-ac68-1fb5c0200619 |
+
+## Succession Status
+- Succession required: no
+- Spawn count: 1 / 16
+- Pending subagents: 14f59dcd-b8c9-48ff-ac68-1fb5c0200619
+- Predecessor: none
+- Successor: not yet spawned
+
+## Active Timers
+- Heartbeat cron: 2c6cf18b-5304-4783-86d8-2f4836279a4e/task-9
+- Safety timer: none
+- On succession: kill all timers before spawning successor
+- On context truncation: run manage_task(Action="list") — re-create if missing
+
+## Artifact Index
+- /home/ti/git/homaroma/.agents/sub_orch_e2e/ORIGINAL_REQUEST.md — Verbatim user request
+- /home/ti/git/homaroma/.agents/sub_orch_e2e/BRIEFING.md — Persistent briefing index

.agents/sub_orch_e2e/ORIGINAL_REQUEST.md

@@ -0,0 +1,19 @@
+# Original User Request
+
+## 2026-06-28T21:20:08-04:00
+
+You are the E2E Testing Track Orchestrator.
+Your working directory is /home/ti/git/homaroma/.agents/sub_orch_e2e.
+Your mission is to establish the E2E testing track for the Premium Mega Menu.
+Please:
+1. Create and maintain SCOPE.md in your working directory.
+2. Create TEST_INFRA.md at the project root outlining the testing strategy, feature inventory, and coverage.
+3. Design and implement a comprehensive opaque-box E2E test suite (e.g. under /home/ti/git/homaroma/tests/mega-menu.test.ts or similar) using the Bun test runner. The tests should:
+   - Seed the database with a main menu payload containing 'rootImage', 'columnImage', and 'hoverImage'.
+   - Spawn the Elysia backend and the Next.js storefront server.
+   - Fetch the storefront homepage using axios/fetch, parse the HTML using cheerio, and verify the presence and properties of the images (verifying next/image rendering, lazy loading properties for hover images, and correct CSS/layout classes).
+   - Verify the mobile drawer hides complex image layouts.
+   - Verify the MCP tools correctly read and write menu payloads containing the new image fields.
+4. Once the test suite is fully designed and implemented, publish TEST_READY.md at the project root.
+5. Provide continuous progress updates in progress.md inside your working directory.
+Your parent is f5557127-1c9c-40d2-90e6-d996a7381786. Report back via send_message when TEST_READY.md is published.

.agents/sub_orch_e2e/README.md

@@ -0,0 +1 @@
+# E2E Testing Track Orchestrator Metadata

.agents/sub_orch_e2e/SCOPE.md

@@ -0,0 +1,21 @@
+# Scope: Premium Mega Menu E2E Testing Track
+
+## Architecture
+- **Elysia Backend**: API endpoints served via Elysia. Integrates with Prisma DB.
+- **Next.js Storefront**: Consumes Elysia API to render homepage and mega menu.
+- **Cheerio HTML Parser**: Parses rendered HTML from the storefront to verify elements and CSS classes.
+- **MCP Tools**: Reads and writes menu payloads (specifically the main menu payload containing `rootImage`, `columnImage`, and `hoverImage`).
+
+## Milestones
+| # | Name | Scope | Dependencies | Status |
+|---|---|---|---|---|
+| 1 | Test Strategy & Feature Inventory | Create `TEST_INFRA.md` outlining the test strategy, feature inventory (Tiers 1-4), and coverage. | None | IN_PROGRESS (Conv: 14f59dcd-b8c9-48ff-ac68-1fb5c0200619) |
+| 2 | Test Infra & DB Seed | Design & implement seed script for DB menu payload and server spawning utility. | M1 | PLANNED |
+| 3 | Homepage E2E & Cheerio Verification | Verify storefront HTML parsing, image properties, classes, lazy loading for hover images. | M2 | PLANNED |
+| 4 | Mobile Drawer & MCP E2E Verification | Verify mobile drawer hides complex images; verify MCP tools read/write menu payloads. | M3 | PLANNED |
+| 5 | Publication & Handoff | Run full test suite, verify clean exit, and publish `TEST_READY.md`. | M4 | PLANNED |
+
+## Interface Contracts
+### E2E Test Suite ↔ Test Runner
+- Command: `bun test tests/mega-menu.test.ts`
+- Output: Pass/Fail exit code, detailed test reports.

.agents/sub_orch_e2e/progress.md

@@ -0,0 +1,11 @@
+## Current Status
+Last visited: 2026-06-28T21:20:08-04:00
+- [ ] Establish E2E testing track
+- [/] Create SCOPE.md and explore codebase (Explorer spawned)
+- [ ] Create TEST_INFRA.md
+- [ ] Implement E2E test suite
+- [ ] Verify test suite against spawned servers and MCP tools
+- [ ] Publish TEST_READY.md
+
+## Iteration Status
+Current iteration: 1 / 32