Rendered from GitHub DAILY_BRIEF.md · fetched 2026-05-05T02:05:55.000Z

PoolOS Daily Brief — 2026-05-03

State of the project

The freemium framework is functionally complete on the iOS side and the v1.5 feature checklist has been done for days — the app is ready to ship but is being held by three backend deployment steps and one constant that needs a real date. Today's commits were focused squarely on closing that gap: App Store subscription copy is drafted, the entitlements Worker is getting wired up, and FreemiumLaunch.swift exists as the single ship-date control. Walk in knowing the blockers are all mechanical, not architectural — this release is a checklist problem, not an engineering problem.

What changed (last 24h)

8424b7f — docs(asc): added 55-char subscription Description plus long reference copy (App Store subscription display copy now fully drafted)
0358803 — docs(asc): documented where subscription display name/description live in App Store Connect (removes ambiguity at submission time)
c29c51e — docs(asc): expanded §6 of APP_STORE_CONNECT_FREEMIUM_CHECKLIST.md with App Store description and subscription copy
fb8a7ce — docs(asc): deferred promotional offer (#4 in checklist) until grant cohort nears expiry — reduces submission complexity
6934077 — chore(entitlements): wired D1 database_id into wrangler.toml, aligned migration filename with remote DB — unblocks npm run db:migrate:remote
4f33661 — fix(ios): registered FreemiumLaunch.swift in Xcode project (was missing from build target, would have caused compile failure)
2c9cda2 — feat(freemium): aligned pipeline items #71–#79, added entitlements Worker routes, wired PoolViewModel premium gates for Weather Guard and Lightning Proximity

In flight right now

#69 — V1.5 App Store Submission. All features confirmed complete; blocked on freemium items #71–#79 closing before archive + submit.
#71 — Freemium / Premium Subscription Model. Spec complete; blocked on ASC subscription product creation and poolos-entitlements backend deploy.
#72 — PremiumManager + StoreKit 2. iOS code committed (da69de0); no further code work needed — blocked on ASC product IDs existing so StoreKit can resolve them.
#73 — Premium Feature Gates + Paywall UI. Committed; Weather Guard and Lightning Proximity gated — no code work outstanding.
#74 — Existing User Auto-Grant (1 year). Implemented via Keychain firstLaunchDate; blocked on freemiumLaunchEpoch constant being set to actual ship date before archive.
#75 — poolos-entitlements Cloudflare Worker + D1. Code committed locally (98f8d0d); blocked on five manual steps: create MyPoolOS/poolos-entitlements GitHub repo, add remote, push, add CLOUDFLARE_API_TOKEN secret, run wrangler d1 create poolos-entitlements, paste database_id (done as of today's commit 6934077), npm run db:migrate:remote, set 4 wrangler secrets (ADMIN_TOKEN, APPLE_ID_SALT, FREEMIUM_LAUNCH_EPOCH, APPLE_SHARED_SECRET).
#77 — Redeem Code UI in Settings. Sheet implemented in PremiumUpgradeView; no outstanding code — waiting on backend /redeem endpoint being live.

Queued (next up)

V1.5 release blockers (Todo):

#76 — Promo / friends-family code generation. Unlocks ability to give out POOL-XXXX-XXXX codes to beta users and friends/family before public launch; POST /admin/codes behind Cloudflare Access + ADMIN_TOKEN.
#78 — Premium Management Dashboard. Unlocks visibility into subscriber/grant/redemption state post-launch; Cloudflare Pages + Access reading same D1.
#79 — App Store Connect — Subscription Products. Directly unblocks #72 (StoreKit can't resolve products until they exist in ASC); create com.mypoolos.premium.monthly ($8.99 Tier 9) + com.mypoolos.premium.annual ($89.99 Tier 90), Family Sharing ON, 14-day intro offer, ASN v2 webhook → https://entitlements.mypoolos.app/webhook/apple.
#83 — Bug: Alerts History Missing Details After Dismiss. User-reported regression; unlocks clean v1.5 submission without a known visible bug in the alerts path.

Planned / lower priority:

#82 — Bug: Waterfall Toggle First-Tap Delay. P4, de-prioritized; no action needed this sprint.
#61 — Bridge Lockup Protection (Weekly Reboot + Healthz + Watchdog). Blocked on marathon gate passing; build after bridge ship criteria are met.
#12 — Smart Scenes. V2.0; unlocks one-tap multi-command macros (Spa Mode etc.).
#20 — Apple Weather Integration. V2.0; WeatherKit forecast context for Weather Guard.
#44 — nodejs-poolController Driver (Phase 2). V2.0; unlocks Jandy/Hayward native protocol via Pi Bridge.
#9 — Jandy iLink / AquaLink Driver. V2.0; second-largest installed base; USR-DR164 prototype hardware arriving imminently.
#56 — Installer — SMJobBless Privileged Helper. V2.0; removes Terminal.app from macOS installer flow; build after BLE provisioning confirmed working end-to-end.
#10 — Hayward OmniLogic Driver. V2.0 (Idea tier); completes the "big three."
#53 — Schedule-Aware Pump Optimizer. V2.0 (Idea tier); requires fleet data and pressure sensor integration before implementation.
#17 — Apple Watch Companion. V2.0 (Idea).
#18 — iPad Layout. V2.0 (Idea).
#19 — iOS Home Screen Widget. V2.0 (Idea).
#5 — WLED Light Bridge (ESP32). V3.0 (Idea); ~$15 BOM, $50–80 retail hardware product.
#6 — DMX Bridge (Raspberry Pi). V3.0 (Idea); $100–150 premium lighting tier.
#7 — Retrofit LED Driver Board. V3.0 (Idea); custom PCB, requires UL/ETL certification.
#16 — Home Assistant / MQTT. V3.0 (Idea).

Marketing pulse

No new App Store updates, website pushes, or customer feedback signals landed in the last 24 hours — today was a heads-down execution day on the freemium plumbing. The App Store listing copy (Marketing/AppStore_listing_v1.5.md) and the Weather Watch landing page rewrite are both complete and waiting on the v1.5 submission trigger. The TFP/Reddit founder post (Marketing/TFP_launch_post_v1.md) is drafted and also holding for submission. The single highest-leverage marketing move this week is completing the poolos-entitlements backend deploy and creating the ASC subscription products — not because those are marketing tasks, but because they are the last mechanical gates standing between the current state and the v1.5 submission that unlocks every queued marketing action simultaneously.

What needs your decision

Approve and execute the poolos-entitlements GitHub repo creation and wrangler deploy sequence. Five steps documented in the wiki: create MyPoolOS/poolos-entitlements, git remote add + push, add CLOUDFLARE_API_TOKEN secret, npm run db:migrate:remote, set 4 wrangler secrets. database_id is now in wrangler.toml (commit 6934077). This is the single hardest blocker on v1.5 ship.
Create the two ASC subscription products (#79). Manual work in App Store Connect: com.mypoolos.premium.monthly ($8.99) and com.mypoolos.premium.annual ($89.99), Family Sharing ON, 14-day intro offer, ASN v2 webhook URL. Required before any StoreKit 2 sandbox testing can happen.
Set freemiumLaunchEpoch in FreemiumLaunch.swift to the actual intended ship date. Currently 1_748_736_000 (placeholder). Decide your target submission date, convert to Unix epoch, commit. This constant gates the existing-user auto-grant for all v1.4 users — it must be correct before archive.
Decide whether to ship #83 (Alerts History Missing Details) before v1.5 submission or accept it as a known issue. It's a user-reported regression in a visible surface. Fix it now and hold submission another day, or ship v1.5 and patch in v1.5.1.
Decide whether to build #76 (promo code generation tool) and #78 (premium management dashboard) before v1.5 submits or after. Both are Todo for v1.5 but neither blocks the App Store submission itself — only your ability to issue codes and see subscriber data at launch. Pick: ship first, add tooling in first week post-launch, or hold submission until both are done.
NAS Docker volume cleanup (docker compose down -v) is due today (2026-05-04 per decommission plan). Confirm you want to run this — it is destructive and the NAS containers are confirmed decommissioned, but flag it as a deliberate act before executing.