x

.agents/explorer_m1/BRIEFING.md

@@ -0,0 +1,45 @@
+# BRIEFING — 2026-06-28T21:20:27-04:00
+
+## Mission
+Explore the codebase at /home/ti/git/homaroma to locate backend server code, storefront code, Prisma models, existing tests, and MCP tools configuration.
+
+## 🔒 My Identity
+- Archetype: explorer
+- Roles: Read-only investigator
+- Working directory: /home/ti/git/homaroma/.agents/explorer_m1
+- Original parent: f5557127-1c9c-40d2-90e6-d996a7381786
+- Milestone: M1 Codebase Exploration
+
+## 🔒 Key Constraints
+- Read-only investigation — do NOT implement
+- CODE_ONLY network mode: No external network access or requests
+- Do not modify source code (except writing reports in explorer_m1 folder)
+
+## Current Parent
+- Conversation ID: f5557127-1c9c-40d2-90e6-d996a7381786
+- Updated: 2026-06-28T21:20:27-04:00
+
+## Investigation State
+- **Explored paths**:
+  - `package.json` (root)
+  - `ecosystem.config.js` (root)
+  - `PROJECT_DETAILS.md` (root)
+  - `apps/backend/package.json` & `apps/backend/src/index.ts`
+  - `apps/website/package.json` & `apps/website/next.config.ts`
+  - `apps/backend/prisma/schema.prisma`
+  - `apps/mcp-server/package.json` & `apps/mcp-server/index.ts` & `apps/mcp-server/menu-toolkit.ts` & `apps/mcp-server/section-toolkit.ts`
+  - `apps/mcp-server/test_mcp_category_image.ts`
+- **Key findings**:
+  - Elysia backend runs on port 3051 by default using Bun.
+  - Next.js website storefront runs on port 3001 in dev (port 3002 in PM2 production).
+  - Prisma models for Menu/Mega Menu consist of `Menu`, `MenuItem`, and `MenuItemTranslation`.
+  - No formal test runner config exists; manual tests are scratch TS files run via Bun, including an integration test for MCP tools.
+  - MCP server runs on stdio, targets backend, handles auto-authentication, and registers a massive list of tools.
+- **Unexplored areas**:
+  - Detailed endpoints in route handlers of the Elysia backend.
+  - UI pages inside Next.js website.
+- **Key Decisions Made**:
+  - Proceeded with read-only files scanning to address all 5 exploration questions.
+
+## Artifact Index
+- /home/ti/git/homaroma/.agents/explorer_m1/handoff.md — Detailed report of codebase exploration findings