63 lines
3.2 KiB
Markdown
63 lines
3.2 KiB
Markdown
# Phase 5: Routing + Route Display - 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-24
|
||
**Phase:** 05-routing-route-display
|
||
**Mode:** default (interactive)
|
||
|
||
## Areas Discussed
|
||
|
||
### Routing infrastructure — THE PIVOT (the phase's defining decision)
|
||
| Question | Options presented | Selection |
|
||
|---|---|---|
|
||
| VPS for Valhalla? | Oracle Always Free / paid VPS / research decides | **User redirected**: check the static-hosting/fork-model pivot from phase 3–4 discussions (lunr/Fuse/sql.js WASM, GitHub/CF hosting) |
|
||
| Extract | full MY / KL-only | Full Malaysia extract (mooted by pivot) |
|
||
| Serving | compose+Caddy+secret / bare systemd / Cloudflare Tunnel | "check planning docs for the pivot to forking model" |
|
||
|
||
### The reconciliation round (user informed of SC3 collision)
|
||
Explained: routing ≠ search — per-query shortest-path over multi-million-edge graphs; no Valhalla/OSRM WASM builds exist; static hosts execute nothing; Workers cap at 128MB/CPU-s; third-party APIs leak origin+destination (core-value violation). User then chose:
|
||
| Question | Options presented | Selection |
|
||
|---|---|---|
|
||
| Reconcile SC3 | fixture-now+WASM-later / VPS after all / third-party+exception / something else | **Fixture routes now, WASM track later** — SC3 amended, no VPS, no proxy |
|
||
|
||
### guidance_sessions envelope
|
||
| Question | Options presented | Selection |
|
||
|---|---|---|
|
||
| Scope at phase close | types-only contract / contract+KV live | Types-only contract |
|
||
| Snapshot placement | inline one-TTL / separate key | Inline snapshot, one TTL |
|
||
|
||
### Route UX surface
|
||
| Question | Options presented | Selection |
|
||
|---|---|---|
|
||
| Alternatives presentation | bottom card+chips / stacked cards | Bottom card + chips |
|
||
| Route line | orange casing+fit bounds / single line | Orange casing + fit bounds |
|
||
| Phase terminal surface | display-only / placeholder start button | Display-only terminal |
|
||
|
||
### Corpus + budgets (fixture-shaped)
|
||
| Question | Options presented | Selection |
|
||
|---|---|---|
|
||
| Fixture geometry source | build-time precompute via public OSRM (no user data) / hand-drawn | Precomputed pairs, build-time |
|
||
| Gates | bundle-size + type gates / + fake latency gate | Bundle + type gates |
|
||
|
||
## Corrections Made
|
||
|
||
User corrected my VPS framing twice — pointing back at their static-hosting/fork-model
|
||
pivot (stated during phase 4 planning discussions). First round produced the VPS question
|
||
again; second round produced the SQLite/sql.js question; the routing-area answer finalized
|
||
as full deferral. The CONTEXT records their intent as the architectural direction
|
||
(WASM-router track), not a rejection of fork values — the VPS remains a documented
|
||
backend with provision scripts, just not this phase.
|
||
|
||
## Auto-Resolved
|
||
|
||
Extract choice (full MY) and serving shape (compose+Caddy) were answered but became moot
|
||
under the pivot — recorded as part of the documented backend #3 path in deferred ideas.
|
||
|
||
## External Research
|
||
|
||
Not needed this phase per roadmap ("standard patterns"); the WASM-router feasibility
|
||
assessment (no Valhalla/OSRM WASM builds; DIY scope) was knowledge-based, verified
|
||
against the phase-4 research's registry checks.
|