# WhetForge Product Roadmap: Timeline and Sprints

This document outlines the development timeline and sprint schedules for the WhetForge Lite-Client ecosystem, including the **Meatbag Reference App**, the **Visual Builder**, the **Lite-Client Shells**, and the **Marketplace**.

---

## 1. High-Level Timeline (3-Month Horizon)

```
Month 1: Client Shells & Builder Porting
[======== Phase 1: Shell Optimization & Mobile Builder Responsive Design ========]

Month 2: Ktor Core & Local Sync Architecture
         [======== Phase 2: Ktor Local Server & SQLite Sync Logic ========]

Month 3: Marketplace Server & Payments
                  [======== Phase 3: Stripe Billing, IAP, & Public Launch ========]
```

---

## 2. Phase Breakdown

### Phase 1: Client Shells & Builder (Month 1)
* **Goal**: Polish the Wear OS, watchOS, Android, and iOS stateless client shells and make the visual builder responsive.
* **Key Milestones**:
  * Seamless notification companion UI optimized for round watch faces.
  * Extracted visual builder logic into `:commonMain` with responsive layout (Tabbed Developer Mode + Wizard Easy Mode).

### Phase 2: Local Server & Sync (Month 2)
* **Goal**: Establish the local routing server as the reliable coordinator.
* **Key Milestones**:
  * SQLite schema updates for caching downloaded marketplace layout profiles locally.
  * Local Ktor synchronization endpoint (`GET /api/profiles/sync`) configured.
  * High-priority push notification bridges (FCM/APNs) setup.

### Phase 3: Marketplace & Launch (Month 3)
* **Goal**: Deploy the public registry, handle monetization, and publish the shells.
* **Key Milestones**:
  * Ktor-based Marketplace web app deployed (PostgreSQL + Exposed ORM).
  * Stripe Checkout integration for web purchases.
  * Google Play Billing & Apple StoreKit integrated into the mobile shells for native IAP checkouts.
  * Launch "Meatbag" as the viral first application.

---

## 3. Detailed Sprint Schedule (2-Week Iterations)

### Sprint 1: Native Wearable & Mobile Polish (Current)
* **Focus**: Android S23 Ultra and Wear OS Watch7 interaction optimization.
* **Deliverables**:
  * Implement persistent background connection checks.
  * Optimize smartwatch Always-On Display (AOD) ambient layout stripping.
  * Refactor haptic pattern configurations.

### Sprint 2: Builder Porting & Responsive Design
* **Focus**: Moving the builder to `:commonMain` and making it fit mobile screens.
* **Deliverables**:
  * Relocate `UIBuilderScreen` Composable from `:client/desktopMain` to `:client/commonMain`.
  * Implement `MobileUIBuilderLayout` (Split Watch Preview + Bottom Sheet).
  * Build the toggle switch in the builder header to flip between "Developer Mode" (Tabs) and "Easy Mode" (Wizard).

### Sprint 3: Local Sync API & DB Caching
* **Focus**: Local profile storage.
* **Deliverables**:
  * Set up database tables in local Ktor backend for caching profiles (`profiles` table in SQLite).
  * Build the local JSON parsing pipeline to dynamically load and display cached layouts in the shell when triggered.
  * Connect CLI `meatbag.py ask` to support requesting layout IDs instead of plain text prompts.

### Sprint 4: Marketplace Backend & Auth
* **Focus**: Setting up the global marketplace Ktor server.
* **Deliverables**:
  * Initialize the `:marketplace` Ktor module.
  * Set up PostgreSQL database models using Exposed ORM (Users, Profiles, Purchases).
  * Implement JWT authentication endpoints.

### Sprint 5: Billing & Stripe Integration
* **Focus**: Monetizing the web marketplace.
* **Deliverables**:
  * Configure Stripe Java SDK on the marketplace server.
  * Implement Stripe Checkout session creation endpoints.
  * Build the webhook listener to verify purchases and write them to the PostgreSQL database.

### Sprint 6: In-App Purchases & Beta Release
* **Focus**: Enabling mobile checkouts and launching.
* **Deliverables**:
  * Integrate Google Play Billing in the Android shell.
  * Integrate Apple StoreKit in the iOS shell.
  * Publish the free Lite-Client Shells to the Play Store and App Store.
  * Launch the "Meatbag" AI agent marketing campaign.