x

2026-06-28 07:58:15 -04:00
1 parent e405af357c
commit e1cf9e62e7
@@ -0,0 +1,71 @@
+# BRIEFING — 2026-06-28T06:50:59-04:00
+
+## Mission
+Implement a Split-Screen Editorial Carousel by extending the existing `EDITORIAL_CAROUSEL` schema and updating the backend, admin, spa, and website apps.
+
+## 🔒 My Identity
+- Archetype: teamwork_preview_orchestrator
+- Roles: orchestrator, user_liaison, human_reporter, successor
+- Working directory: /home/ti/git/homaroma/.agents/orchestrator
+- Original parent: parent (caller agent id: 639740a0-4559-4f35-9fff-1884096a1d9c)
+- Original parent conversation ID: c02d550e-454f-4c49-9b30-4ae4587b6e54
+
+## 🔒 My Workflow
+- **Pattern**: Project Pattern
+- **Scope document**: /home/ti/git/homaroma/.agents/orchestrator/PROJECT.md
+1. **Decompose**: Decompose the task into three logical milestones: Types & Backend Schema (M1), Admin/CMS UI builder updates (M2), and Frontend renderers (M3), followed by a validation milestone (M4).
+2. **Dispatch & Execute**:
+   - **Delegate (sub-orchestrator)**: Spawn sub-orchestrators for milestones or delegate specific explorer/worker tasks.
+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 when cumulative sub-agent spawn count reaches 16.
+- **Work items**:
+  1. M1: Types & Schema Update [pending]
+  2. M2: Admin Page Builder UI Update [pending]
+  3. M3: Frontend Renderers Update [pending]
+  4. M4: End-to-End Verification [pending]
+- **Current phase**: 1 (Analysis and Planning)
+- **Current focus**: Read codebase to understand components and layout.
+
+## 🔒 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: c02d550e-454f-4c49-9b30-4ae4587b6e54
+- Updated: not yet
+
+## Key Decisions Made
+- Decompose the implementation into M1 (Types), M2 (Admin CMS UI), M3 (Frontend SPA/Website), and M4 (Verification).
+
+## Team Roster
+| Agent | Type | Work Item | Status | Conv ID |
+|-------|------|-----------|--------|---------|
+| explorer_m1_1 | teamwork_preview_explorer | Explore codebase for Editorial Carousel | completed | 8a4f135d-9dd8-430d-91f7-f4ca82f60eb4 |
+| worker_m1_1 | teamwork_preview_worker | Implement split screen editorial carousel | completed | b7acef52-fdd3-4914-a3c1-c0a77a08462d |
+| reviewer_m1_1 | teamwork_preview_reviewer | Review split screen editorial carousel implementation | completed | 2278c473-7f28-41d5-82ef-0bd60da8cf45 |
+| auditor_m1_1 | teamwork_preview_auditor | Forensic audit of code integrity | completed | 3ee71fa4-21a9-43dc-8682-856ed2561b24 |
+
+## Succession Status
+- Succession required: no
+- Spawn count: 4 / 16
+- Pending subagents: none
+- Predecessor: none
+- Successor: not yet spawned
+
+## Active Timers
+- Heartbeat cron: stopped
+- 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/orchestrator/BRIEFING.md — Persistent memory index
+- /home/ti/git/homaroma/.agents/orchestrator/ORIGINAL_REQUEST.md — Verbatim user request
@@ -0,0 +1,10 @@
+# Original Request
+
+## 2026-06-28T06:50:59-04:00
+
+You are the Project Orchestrator (teamwork_preview_orchestrator).
+Your workspace directory is `/home/ti/git/homaroma/.agents/orchestrator`.
+Your mission is to implement a Split-Screen Editorial Carousel by extending the existing `EDITORIAL_CAROUSEL` schema and updating the backend, admin, spa, and website apps.
+Refer to the original user request recorded in `/home/ti/git/homaroma/.agents/ORIGINAL_REQUEST.md` for full details.
+Please initialize your workspace, read the instructions in `/home/ti/git/homaroma/.agents/skills/orchestrator/SKILL.md`, build your plan (`plan.md`), track progress (`progress.md`), and delegate tasks to the appropriate specialist agents.
+Report back once you have completed all requirements and verified the implementation.
@@ -0,0 +1,33 @@
+# Project: Split-Screen Editorial Carousel
+
+## Architecture
+This project extends the existing `EDITORIAL_CAROUSEL` page section schema and UI components in the HomAroma monorepo.
+- **Database/Types Schema**: `packages/types/index.ts` defines the types used across the frontend applications (apps/admin, apps/spa, apps/website) and backend services.
+- **Backend Validation**: `apps/backend/src/routes/pages.ts` validates incoming payloads using schemas imported from `@homaroma/types`.
+- **CMS/MCP Server**: `apps/mcp-server/section-toolkit.ts` exposes MCP tools for managing/updating content, using schemas aligned with `@homaroma/types`.
+- **Admin UI**: `apps/admin/src/components/page-builder/EditorialCarouselForm.tsx` renders a form for content managers to configure the carousel layout and content.
+- **SPA Frontend**: `apps/spa/src/components/DynamicEditorialCarousel.tsx` renders the carousel on the SPA client.
+- **Website Frontend**: `apps/website/src/components/dynamic/DynamicPageRenderer.tsx` contains the website's `EditorialCarouselSection` renderer.
+
+## Milestones
+| # | Name | Scope | Dependencies | Status |
+|---|------|-------|-------------|--------|
+| M1 | Schema & Types | Update `EditorialCarouselSectionPayloadSchema` in `packages/types/index.ts` to include layout and imagePosition. Update `apps/mcp-server/section-toolkit.ts` to expose those fields in the `update_editorial_carousel` tool. | None | DONE |
+| M2 | Admin CMS UI | Update `EditorialCarouselForm.tsx` to support configuring `layout` and `imagePosition` for the carousel section. | M1 | DONE |
+| M3 | Frontend UI | Update the carousel components in `apps/spa` and `apps/website` to support `split_screen` and `standard` layouts, respecting desktop split proportions and mobile stacked views, using theme tokens. | M1 | DONE |
+| M4 | E2E & Type Verification | Run monorepo typechecking, build validation, and test section CRUD operations using MCP tools. | M2, M3 | DONE |
+
+## Interface Contracts
+### `packages/types` -> Consumers
+- `EditorialCarouselSectionPayloadSchema` includes:
+  - `layout: z.enum(['standard', 'split_screen']).optional()`
+  - `imagePosition: z.enum(['left', 'right']).optional()`
+- When `layout` is omitted or `'standard'`, components should fall back to existing slide behavior.
+- When `layout` is `'split_screen'`, the components render the new split-screen layout.
+
+## Code Layout
+- Schema: `packages/types/index.ts`
+- MCP Server config: `apps/mcp-server/section-toolkit.ts`
+- Admin UI builder: `apps/admin/src/components/page-builder/EditorialCarouselForm.tsx`
+- SPA component: `apps/spa/src/components/DynamicEditorialCarousel.tsx`
+- Website renderer: `apps/website/src/components/dynamic/DynamicPageRenderer.tsx`
@@ -0,0 +1 @@
+# Orchestrator Workspace
@@ -0,0 +1,39 @@
+# Handoff Report — Split-Screen Editorial Carousel Implementation (Orchestrator Hard Handoff)
+
+## Milestone State
+- **M1: Schema & Types**: DONE
+- **M2: Admin CMS UI**: DONE
+- **M3: Frontend UI**: DONE
+- **M4: E2E & Type Verification**: DONE
+
+## Active Subagents
+All subagents have completed their tasks and delivered their handoffs:
+1. `explorer_m1_1` (Conv ID: `8a4f135d-9dd8-430d-91f7-f4ca82f60eb4`) — Completed codebase exploration.
+2. `worker_m1_1` (Conv ID: `b7acef52-fdd3-4914-a3c1-c0a77a08462d`) — Completed implementation across monorepo modules.
+3. `reviewer_m1_1` (Conv ID: `2278c473-7f28-41d5-82ef-0bd60da8cf45`) — Completed validation and quality review.
+4. `auditor_m1_1` (Conv ID: `3ee71fa4-21a9-43dc-8682-856ed2561b24`) — Completed forensic integrity audit with a CLEAN verdict.
+
+## Pending Decisions
+None. All requirements are fully implemented, reviewed, and audited.
+
+## Remaining Work
+None. The implementation is 100% complete and verified.
+
+## Key Artifacts
+- Plan: `/home/ti/git/homaroma/.agents/orchestrator/plan.md`
+- Project Plan/Milestones: `/home/ti/git/homaroma/.agents/orchestrator/PROJECT.md`
+- Progress Tracker: `/home/ti/git/homaroma/.agents/orchestrator/progress.md`
+- Persistent memory: `/home/ti/git/homaroma/.agents/orchestrator/BRIEFING.md`
+- Original User Request: `/home/ti/git/homaroma/.agents/orchestrator/ORIGINAL_REQUEST.md`
+
+## Summary of Changes
+1. **Schema & Zod Types**: Extended `EditorialCarouselSectionPayloadSchema` in `packages/types/index.ts` to include optional `layout` and `imagePosition` enum fields.
+2. **MCP Tooling**: Added `layout` and `imagePosition` to the metadata properties of the `update_editorial_carousel` MCP tool in `apps/mcp-server/section-toolkit.ts` to support programmatic updates.
+3. **Admin UI Form**: Updated `EditorialCarouselForm.tsx` in `apps/admin` with layout and image position selectors. The image position field automatically disables when standard layout is active.
+4. **SPA Frontend**: Configured `DynamicEditorialCarousel.tsx` to handle `split_screen` layouts. It sets the Swiper slides-per-view to 1, uses CSS Grid dynamic column sizes (`35%/65%` or `65%/35%`), orders the columns responsively (image top/text bottom on mobile), and relies on theme-compliant dynamic pop-* classes.
+5. **Next.js Website**: Configured website `DynamicPageRenderer.tsx` (`EditorialCarouselSection`) to render the `split_screen` layout with full-width slides, client-width scrolling adjustments, CSS grid splits, responsive stacking orders, and Tailwind v4 theme utility classes (`bg-surface-card`, `border-line-primary/20`).
+
+## Verification
+- Monorepo compilation and typecheck succeeded for all applications (`apps/admin`, `apps/spa`, `apps/website`, `apps/mcp-server`).
+- Reviewer verified desktop split layout ratios, mobile stacked orders, backward compatibility, Zod type alignment, and design system color conformance.
+- Forensic Auditor verified clean execution, genuine non-mocked dynamic logic, and complete absence of hardcoding or bypass flags.
@@ -0,0 +1,24 @@
+# Execution Plan: Split-Screen Editorial Carousel
+
+## Step 1: Codebase Exploration and Detail Verification
+- Target: Run an Explorer to verify types, schema validation, and find styles or markup patterns.
+- Verification: Explorer report on existing `EDITORIAL_CAROUSEL` patterns, build verification, and theme compliance requirements.
+
+## Step 2: Milestone 1 - Schema, Types & MCP Tooling (Backend)
+- Target: Update `packages/types/index.ts` and `apps/mcp-server/section-toolkit.ts` using `teamwork_preview_worker`.
+- Skill needed: `database-architect` (for types) / `backend-mcp-lead` (for MCP).
+- Verification: Run typecheck and verify that MCP toolkit compilation succeeds.
+
+## Step 3: Milestone 2 - Admin Page Builder Form (Admin CMS UI)
+- Target: Update `apps/admin/src/components/page-builder/EditorialCarouselForm.tsx` using `teamwork_preview_worker`.
+- Skill needed: `frontend-lead` / `cms-architect`.
+- Verification: Run typecheck and build in `apps/admin`.
+
+## Step 4: Milestone 3 - Frontend Renderers (SPA & Website)
+- Target: Update `apps/spa/src/components/DynamicEditorialCarousel.tsx` and `apps/website/src/components/dynamic/DynamicPageRenderer.tsx` using `teamwork_preview_worker`.
+- Skill needed: `frontend-lead` (for SPA) and `nextjs-seo-architect` (for website/Next.js dynamic rendering). Check theme compliance using `theme-compliance-auditor`.
+- Verification: Run typechecks and builds in `apps/spa` and `apps/website`.
+
+## Step 5: Milestone 4 - Review and End-to-End Verification
+- Target: Review all changes using `teamwork_preview_reviewer` and run a `teamwork_preview_auditor` to check for integrity.
+- Verification: Monorepo `npm run typecheck` passes, and the carousel renders and behaves correctly on mobile and desktop.
@@ -0,0 +1,10 @@
+## Current Status
+Last visited: 2026-06-28T06:50:59-04:00
+- [x] Initialized workspace and briefing
+- [x] Creating plan.md and PROJECT.md
+- [x] Spawning Explorer to analyze codebase for Editorial Carousel
+- [x] M1-M3: Types, Admin Page Builder, and Frontend updates (completed)
+- [x] M4: End-to-End Verification (Review & Forensic Audit passed)
+
+## Iteration Status
+Current iteration: 1 / 32