meatbag/business/timeline_and_sprints.md

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.