Commit Graph

86 Commits

Author SHA1 Message Date
airkjw 3ca038ec65 feat(settings): soundEnabled provider gates SFX and haptics
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-13 17:59:08 +09:00
airkjw 93397988a2 feat(settings): persist soundEnabled flag (additive, default true)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-13 17:56:22 +09:00
airkjw ea42c76f84 docs: Phase 6 implementation plan (icon, sound toggle, juice, l10n, store assets)
9 tasks. Icon + feature graphic drawn via CustomPainter and rasterized to PNG
under flutter test (no SVG tooling), consumed by flutter_launcher_icons. Sound
& vibration toggle follows the repo-backed Notifier pattern. Juice: press
feedback + fade routes + themed settings. Tasks 1-6 subagent-friendly; 7-9
controller-run (KO overflow, screenshots, icon-on-device).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-13 15:11:45 +09:00
airkjw 84a6749b5e docs: Phase 6 design spec (icon + l10n finalize + juice + store assets)
App icon = clean 2x2 glossy block mark (vector, no AI image). l10n EN/KO
finalize + KO overflow pass. Light juice: sound/haptics toggle, themed
settings, button press feedback, screen transitions. Store feature graphic +
EN/KO screenshots. Procedural visuals mean no raster background assets needed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-13 15:06:39 +09:00
airkjw 6a0b543970 Merge Phase 5: monetization (AdMob + IAP)
AdMob ads (interstitial/rewarded/banner) with a pure-Dart frequency policy,
a compliant UMP->ATT->init consent flow, and a remove_ads non-consumable IAP
with Restore. Single repo-backed ownership source (adsRemovedProvider); all
ad/IAP/consent failures swallowed. Runs on Google test ids today; owner swaps
real ids by config. 169 tests green; opus final review passed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-13 14:43:46 +09:00
airkjw c5c6af0313 docs: Phase 5 UMP consent flow verified on simulator (evidence)
First-launch UMP consent form displays, ATT requested, MobileAds SDK
initialized, no crash. Settings gear present, home renders. Banner visual +
sandbox IAP are owner device-test items (consent form blocks automated taps).
2026-06-13 14:29:52 +09:00
airkjw 7bea9c1456 fix(iap): eagerly start IAP service at launch (final review I-1)
iapServiceProvider was lazy and only read by Settings, so the purchase stream
attached only after opening Settings — deferred/interrupted/restored
transactions wouldn't be delivered or completed until then. Read it in the
post-frame callback so the stream is live for the whole session.
2026-06-13 14:29:20 +09:00
airkjw 640b23804f fix(ads): banner retries load when SDK becomes ready
On a cold start the consent flow is still running when home first builds, so
createBanner returns null and the slot stayed empty until a rebuild. AdService
now exposes an isReady ValueNotifier; BannerAdSlot listens and retries its load
once MobileAds finishes initializing. Verified: analyze clean, 169 tests green.
2026-06-13 14:23:45 +09:00
airkjw 70f87ab8f2 feat(iap): settings screen with remove-ads purchase and restore
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-13 14:17:28 +09:00
airkjw 40c2204d7b feat(ads): home/map banner slot (hidden when removed or unloaded)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-13 14:13:29 +09:00
airkjw 1ec59ba80d fix(ads): reset ad round in startStage so nextStage advance counts (review fix)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-13 14:09:02 +09:00
airkjw 297449ccce feat(ads): stage-end interstitial gated by policy; restart resets round 2026-06-13 14:03:52 +09:00
airkjw 3943653a23 feat(ads): rewarded ad gates the continue/extra-moves rescue 2026-06-13 14:02:31 +09:00
airkjw 6c4304cfd8 style(test): drop unused import in ads_notifier_test 2026-06-13 14:00:03 +09:00
airkjw 662ee55e1d feat(ads): run consent flow (UMP->ATT->init) after the first frame
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-13 13:59:22 +09:00
airkjw 539afd1dad feat(ads): ref-constructed ad/consent/iap providers, single ownership source 2026-06-13 13:57:30 +09:00
airkjw 6d2ffebb92 feat(iap): remove_ads purchase/restore service + adsRemoved notifier 2026-06-13 13:55:44 +09:00
airkjw e43fda8551 feat(ads): ConsentService enforcing UMP -> ATT -> SDK init order 2026-06-13 13:53:10 +09:00
airkjw 4744aa167a feat(ads): AdService for interstitial/rewarded/banner with policy gating 2026-06-13 13:49:18 +09:00
airkjw eb258c7324 feat(ads): ad id config with test/real switch via dart-define 2026-06-13 13:46:44 +09:00
airkjw 947d5566a2 feat(iap): persist adsRemoved flag (additive, saveVersion 1)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-13 13:45:33 +09:00
airkjw f560b9d4c8 feat(ads): pure-Dart interstitial frequency policy with tests 2026-06-13 13:42:55 +09:00
airkjw 2422a94b9a build(ios): commit pod artifacts for google_mobile_ads (Podfile.lock, pbxproj)
pod install for google_mobile_ads added Google-Mobile-Ads-SDK 12.14.0 and a
[CP] Copy Pods Resources build phase. Tracking both keeps the build
reproducible (follow-up to 245a065).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-13 13:41:29 +09:00
airkjw 245a065ac7 build: add AdMob/IAP/ATT plugins and native ad config (test ids)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-13 13:40:23 +09:00
airkjw 0781e817d0 docs: Phase 5 monetization (AdMob + IAP) implementation plan
14 tasks: pure-Dart frequency policy (TDD), adsRemoved persistence, ad config
(test ids), AdService/ConsentService/IapService, ref-constructed providers
(single ownership source), rewarded-gated rescue, stage-end interstitial,
home/map banner, settings (remove ads + restore), simulator verification.
Runs on Google test ids today; owner real ids slot in by config later.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-13 12:50:59 +09:00
airkjw 3a83c0a2b1 docs: add Firebase-integrated build runtime screenshot (evidence)
Firebase Analytics SDK initialized on the iOS simulator; debug build renders
gameplay and (per system log) disables GA4 collection. Evidence for the
analytics wiring milestone.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-13 12:20:38 +09:00
airkjw 74fe1858d4 feat(analytics): disable GA4 collection in debug builds
setAnalyticsCollectionEnabled(kReleaseMode) after Firebase init so the native
SDK's automatic events (session_start, screen_view) stay out of production
analytics in debug too — not only our custom events. Verified on simulator:
release builds collect, debug builds do not.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-13 12:18:05 +09:00
airkjw 41b0180b44 feat(analytics): wire Firebase Analytics into app startup
flutterfire configure registered the iOS/Android apps under project
block-seasons and generated firebase_options.dart + native config. main()
now initializes Firebase and routes analytics through FirebaseAnalyticsBackend
in release builds (console logger in debug, so dev traffic never pollutes
GA4). Firebase init is guarded — failure falls back to the debug logger
rather than blocking startup.

firebase.json keeps the existing Hosting config and gains the FlutterFire
platform section. Client config files are committed (they ship in the binary;
Firebase security is enforced by rules, not config secrecy).

flutter analyze clean, all 161 tests green.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-13 12:10:03 +09:00
airkjw e3fb5959c5 build(ios): raise deployment target to iOS 15.0 for Firebase SDK
firebase_core 4.x bundles the Firebase iOS SDK which requires iOS 15.0+.
Sets the Podfile platform and the three Xcode build configs accordingly.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-13 12:01:43 +09:00
airkjw 5cd9d0ab10 feat(analytics): add FirebaseAnalyticsBackend (firebase wiring pt.1)
Adds firebase_core + firebase_analytics and a FirebaseAnalyticsBackend that
adapts the existing AnalyticsBackend interface to GA4. Kept in its own file
so the typed AnalyticsService and DebugAnalyticsBackend stay free of the
firebase dependency (unit tests never pull in platform channels).

Not yet wired into main() — that needs lib/firebase_options.dart from
flutterfire configure (owner step). All 161 tests still green.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-13 12:00:45 +09:00
airkjw 3e25e3b9ca chore: add Firebase Hosting config for season content delivery
firebase init hosting wired to project block-seasons, public dir = deploy.
Generated season payload (deploy/content/) and CLI cache (.firebase/) are
gitignored — content/ is the source of truth, regenerated by the deploy
script in docs/firebase-hosting-guide.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-13 09:18:53 +09:00
airkjw af7bb83fb9 Merge Phase 4: remote seasons + analytics
Manifest-driven season delivery (SHA256 + atomic cache, bundled
fallback), Season 2 'Summer Tide' remote-only content, analytics
abstraction with debug backend, rescue crash fix.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 22:49:42 +09:00
airkjw b5134ef86d fix: season list re-reads via provider dependency; ignore pid files
seasonsProvider now watches seasonRefreshProvider instead of relying on
a HomeScreen ref.listen, making the refresh ordering-independent. Removes
the redundant listener from HomeScreen. Appends *.pid to .gitignore.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 22:49:24 +09:00
airkjw 8555397c43 feat: phase 4 remote seasons verified end-to-end; owner hosting guide
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 22:43:53 +09:00
airkjw ba70db3e60 feat: season 2 'Summer Tide' content and manifest generator
Adds Summer Tide (season_002) — 30 stages with deep-teal gradient and
cyan accent — generated remote-only (no copyToAssets). Introduces
tool/make_manifest.dart to rebuild content/manifest.json from all
season packs with SHA-256 verification support.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 13:45:22 +09:00
airkjw 9763968db9 fix: hide spent rescue to prevent StateError crash; log per-attempt starts
Expose engine.rescueUsed getter and surface it through GameViewState so
the result overlay can omit the watch-ad FilledButton after a rescue has
been consumed, preventing a second tap from calling useContinue /
addExtraMoves and hitting their StateError guard. Give-up is promoted to
FilledButton when rescue is unavailable for clear affordance.

Also emit stageStart / endlessStart analytics in restart() so every
attempt (not just the first) is bracketed by a matching start event.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 13:41:59 +09:00
airkjw 074a21ea2b feat: analytics abstraction with debug backend and game event wiring
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 13:35:31 +09:00
airkjw 6d2d97bfcc fix: guard journey map against an empty season list
Prevents StateError when data builder is called with empty list
by displaying loading indicator instead of passing empty list to
activeSeason(), matching title screen behavior.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 13:31:22 +09:00
airkjw 4fa5564975 feat: session content sync trigger and newest-season selection
Add seasonRefreshProvider (once-per-session FutureProvider) and activeSeason()
helper; HomeScreen listens and invalidates seasonsProvider when new packs arrive;
season_map_screen and season_title_screen switch from list.first to activeSeason.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 13:28:39 +09:00
airkjw 73a56aeeb1 perf: async cache reads in content repository 2026-06-12 13:24:14 +09:00
airkjw e722fe2ce1 feat: content repository merges cached seasons with bundled fallback
Extends ContentRepository with optional cacheDir: cached packs in
<cacheDir>/seasons/*/pack.json merge with bundled ones (cached wins
for same id), corrupt/future-schema packs silently ignored, refresh()
fires ContentDownloader.sync() once per session. main() wires the real
cache+downloader instance; default constructor stays bundled-only for tests.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 13:15:35 +09:00
airkjw a820e97237 fix: harden downloader against path traversal, URL escape, oversized bodies
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 13:11:18 +09:00
airkjw bfa9c09b28 feat: content downloader with sha256 verify and atomic cache
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 13:05:56 +09:00
airkjw c7bdb9b9c9 feat: remote manifest model and content dependencies
Add http, crypto, path_provider deps; introduce RemoteManifest /
ManifestSeason immutable models with fromJson/toJson, schema-version
guard (FormatException on unsupported schema), and fallback for missing
current field. 3/3 TDD tests pass, flutter analyze clean.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 13:02:17 +09:00
airkjw 63ac8c6b9e docs: add Phase 4 remote seasons implementation plan
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 12:44:41 +09:00
airkjw 41b9a14c0c Merge Phase 3.5: commercial polish round
Glossy tiles + season theme system, juice kit, intro flow
(splash/season card/tutorial), serpentine journey map,
endless classic mode, redesigned home.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 07:39:27 +09:00
airkjw f9eaa3ae59 docs: polish round simulator screenshots (splash, season card, home)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 07:39:19 +09:00
airkjw c59454aa5f fix: center splash logo and wordmark (stack was sized to children)
Wrap AnimatedBuilder in SizedBox.expand so the Stack fills the full
Scaffold body; alignment: Alignment.center now centers within the whole
screen instead of within the wordmark-sized intrinsic box.

Adds a regression widget test (test/ui/splash_screen_test.dart) that
asserts the wordmark dx is within 1px of screen-center at 1500ms into
the animation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-12 07:37:54 +09:00
airkjw bf7720ebd3 fix: clear season flow when starting Classic so tutorial/theme can't leak
- Add SeasonFlowNotifier.clear() to null out the flow state
- Call clear() in HomeScreen's Classic button before startStage()
- Broaden tutorial-end guard to next.phase != GamePhase.playing (covers stuck)
- Add regression test: clear() resets flow to null

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-12 07:33:41 +09:00
airkjw 26adf98d73 fix: guard home buttons against double-tap double-push 2026-06-12 07:22:18 +09:00