arah2/.planning/STATE.md

gsd_state_version, milestone, milestone_name, status, stopped_at, last_updated, last_activity, progress

gsd_state_version	milestone	milestone_name	status	stopped_at	last_updated	last_activity	progress
1.0	v1.x	routing-engine-upgrades-and-extras	ready_to_plan	F1 remediation applied (debug alt-potential-4x-slowdown RC-1): clean-columns-only ALT containment in routing/src/astar.ts — per-node sentinel skip removed; suite re-spec'd RED-first (A11) + new A13 mixed-column case; new committed oracle sweep measure-astar-oracle-sweep.mjs 0/200 suboptimal; CPU back in the pre-ALT band (p95 136.6 ms this host vs 1037.6 pre-fix — honest c3 FAIL vs 8 ms stands); D-03 gate green. Commits c071e20 / 2a5a0b5 / 97d6e35. NEXT: maintainer R2 upload + the SC-1 escalation decision (unchanged)	2026-10-25T14:15:06.953Z	2026-10-26	total_phases completed_phases total_plans completed_plans percent 4 2 5 5 50

Project State

Project Reference

See: .planning/PROJECT.md (updated 2026-10-22)

Core value: A user finds a local destination via Telegram and gets there with reliable turn-by-turn guidance — tracked by nothing beyond what they explicitly opted in to. Current focus: Phase 08 — ALT landmark preprocessing (routing backend v2)

Current Position

Phase: 08.1 Plan: Not started Status: Ready to plan Last activity: 2026-10-26 - Completed quick task 261026-d95: isolated ALT direction-split research (NO-GO; no production integration)

Progress: [██████████] 100%

Performance Metrics

Velocity:

• Total plans completed: 39
• Average duration: —
• Total execution time: —

By Phase:

Phase	Plans	Total	Avg/Plan
—	—	—	—
01	4	-	-
02	3	-	-
3	4	-	-
4	4	-	-
5	5	-	-
6	8	-	-
7	6	-	-
8	5	-	-

Accumulated Context

Decisions

Logged in PROJECT.md Key Decisions table. Affecting current work:

• Routing = Valhalla (toll-free stays v2); self-hosted Photon for lookup; OpenFreeMap tiles + MapLibre GL JS v6
• grammY on one Cloudflare Worker (static assets + webhook + /api/*) — Workers, not Pages
• KV-only storage, TTL-only (chat_sessions minutes / guidance_sessions ~2h); guidance_sessions envelope designed in Phase 5 (upstream pre-work for GUID-05/06)

Pending Todos

None yet.

Blockers/Concerns

• PHASE 8 ESCALATION (open, 2026-10-25): the CPU verdict measured FAIL post-ALT (25-route p95 152.788 ms / extended 185.692 ms vs the 8 ms budget; the L=32 probe worse) — the c3 class remains. The theoretical wall: no two-sided-Lipschitz landmark extension exists on a graph with sentinel fringes; sound+fast needs direction-split potentials with a re-proven meet rule (search-skeleton work). Options: direction-split potentials (new phase) / CH (Phase-6 deferral) / Workers Paid reversal ($0 law) / keep c3 (current shipped posture). Records: docs/BUDGETS.md §c3, docs/KNOWN-LIMITATIONS.md, 08-05-SUMMARY.md. F1 addendum (2026-10-25, post-plan): the debug session also exposed RC-1 — a LIVE correctness bug in the ALT potential (per-node sentinel skip broke cross-edge consistency; 1/194 fresh pairs suboptimal vs Dijkstra) — fixed the same day (clean-columns-only containment; commits c071e20/2a5a0b5/97d6e35; new committed oracle-sweep gate 0/200). On the current 0/24-clean binary ALT is inert (exact haversine), so the CPU band is pre-ALT again (p95 136.6 ms this host) and this escalation is UNCHANGED — a future clean-column binary re-arms ALT with no code change; F2 (transposed tables) is the then-relevant performance follow-up.
• PHASE 4 device-gate legs UNVERIFIED RESOLVED 2026-10-24: legs 1–4+6 PASS on real hardware; leg 5 user-accepted (BotFather Main Mini App configured; unknown-id surface covered by automated gates). Known-open cosmetic: /cari absent from the client command menu (Telegram non-default setMyCommands defect; command works when typed; register script re-arms all scopes for retry).
• Design-source conflict (root DESIGN.md typography vs telemetry_rams/DESIGN.md + mockups) — Phase 1 resolves; mockup markup is layout reference only, design doc tokens are binding (scrub rounded/blur utilities)
• VPS provisioning starts in Phase 4 (Photon bake-off) SUPERSEDED by Phase 4 D-03: search is an in-Worker curated gazetteer ($0); VPS provisioning (Valhalla + Photon) defers to Phase 5; Photon is a documented SearchSource backend #3 (free-first mandate: one VPS, Oracle Cloud Always Free candidate)
• Research-flagged phases needing /gsd-research-phase: 3 (geolocation client matrix), 4 (Photon KL bake-off + gazetteer), 6 (backgrounded turn-card framing + snapshots)
• Project skill .agents/skills/design-taste-frontend/ applies to UI phases (existing-design-system special case; Rams tokens binding)

Quick Tasks Completed

#	Description	Date	Commit	Directory
261024-001	Replace logo references with master assets	2026-10-24	TBD	261024-001-logo-asset-replacement
261026-d95	Isolated ALT direction-split research: proved and measured, NO-GO for integration	2026-10-26	9a671bd	261026-d95-alt-direction-split-isolated-research-si

Deferred Items

Category	Item	Status	Deferred At
v1.x features	Voice guidance, live trip share, toll toggle, speed limits	Deferred to v1.x milestone (after user validation)	Roadmap init 2026-10-22
v2	Incident reports, gamification, traffic-weighted ETA	Out of scope for v1	Requirements defined 2026-10-22

Session Continuity

Last session: 2026-10-25T14:15:06.939Z Stopped at: "F1 remediation applied (debug alt-potential-4x-slowdown RC-1): clean-columns-only ALT containment; oracle sweep 0/200; CPU in the pre-ALT band (c3 stands); D-03 green — gates re-run 2026-10-25" Resume file: None