ambek .planning

2026-10-23 22:37:55 +08:00
parent e512104d5e
commit 275879a18b
54 changed files with 9921 additions and 0 deletions
@@ -0,0 +1,56 @@
+# Phase 3: Mini App Shell + Geolocation - Discussion Log
+
+> **Audit trail only.** Do not use as input to planning, research, or execution agents.
+> Decisions captured in CONTEXT.md — this log preserves the analysis.
+
+**Date:** 2026-10-22
+**Phase:** 03-mini-app-shell-geolocation
+**Mode:** default (interactive)
+
+## Areas Discussed
+
+### Mini App stack + repo layout
+| Question | Options presented | Selection |
+|---|---|---|
+| Frontend stack | TS + Vite no framework / component framework / ES modules | TS + Vite, no framework |
+| App source location | web/ workspace / inside bot/ / web/ + shared/ | web/ workspace |
+| Token holding | Memory-only / sessionStorage / you decide | Memory-only |
+
+### Location acquisition strategy
+| Question | Options presented | Selection |
+|---|---|---|
+| Primary path | Telegram → WebView → chat KB / WebView-only / research decides | Full chain, Telegram first |
+| Cadence | Gated streaming / watch always / you decide | Gated streaming |
+| Denied UX | Deliberate denied state / minimal banner / you decide | Deliberate denied state |
+| Coord persistence | Memory-only / cache last position / you decide | Memory-only, zero persistence |
+
+### Shell UX + screens
+| Question | Options presented | Selection |
+|---|---|---|
+| Screen surface | Map-first single screen / map + placeholder drawer / you decide | Map-first single screen |
+| Boot choreography | Staged boot states / map-first + chip / you decide | Staged boot states |
+
+### Dev/test harness
+| Question | Options presented | Selection |
+|---|---|---|
+| Dev harness | Mock-Telegram / real-only tunnel / mock + Playwright matrix | Mock-Telegram harness |
+| Dev topology | wrangler dev local / remote staging | wrangler dev local |
+
+### Worker static-asset wiring
+| Question | Options presented | Selection |
+|---|---|---|
+| Static serving | Workers [assets] binding / KV/R2 / you decide | Workers [assets] binding |
+| Asset inlining | All-inlined build / basemap kept remote / you decide | All-inlined build |
+| Deploy ergonomics | Single command / split deploys / you decide | Single deploy command |
+
+## Corrections Made
+
+No corrections — user accepted recommended options throughout; chose the leaner mock option over the playwright-matrix option (matrix deferred to exit gate).
+
+## Auto-Resolved
+
+Not applicable.
+
+## External Research
+
+Not applicable (research runs inside planning per roadmap recommendation).