# Map AI Advisor layout acceptance

Date: 2026-10-16. Target: local Herd `petav3.test`, the existing authenticated portal and live research backend. Delivery: PR #210, `dev-chen` to `master`. No merge or production deployment.

## Change

- Compact the Advisor page heading, remove its repeated subtitle and chat branding, and keep chat actions in one row with accessible names and 44px minimum targets. Below 360px, New chat uses its labelled icon.
- Keep the Analyze Property tabs in one horizontally scrollable row in Advisor; reveal the active tab without scrolling the document. Other modes retain the normal shared navigation layout.
- Reduce welcome and composer space. Send/Stop sits beside a two-row input; existing keyboard, IME, retry, cancellation and availability behavior is retained.
- Show country names in the Advisor selector. Catalogue project counts appear on Property Explorer only, rather than suggesting knowledge coverage. Non-Malaysian selection retains its existing Explorer destination.

## Responsive results

Measured from the rendered DOM in the in-app browser. Heights are rounded CSS pixels; the existing account sidebar was expanded on desktop.

| Viewport | Toolbar before / after | Conversation before / after | Composer before / after | Final page width |
| --- | --- | --- | --- | --- |
| 1280 x 720 | 132 / 53 | 40 / 302 | 232 / 166 | 1280 |
| 390 x 844 | 94 / 53 | 48 / 330 | 232 / 165 | 390 |
| 320 x 720 | not captured / 53 | not captured / 192 | not captured / 165 | 320 |

The composer ends inside its panel and viewport at all three sizes. Desktop keeps conversation and map side by side. Narrow layouts retain Chat/Map switching and show the active AI Advisor tab. Long answers scroll within the conversation. An initial 320px pass found a partially clipped Shortlist button; the final refinement hides only the New chat text below 360px, preserving its icon, title and accessible name. The final 320px check confirmed all five toolbar buttons inside the panel, with at least 44px width and height.

## Functional checks

- Opened and closed History, Shortlist and Edit brief on desktop; History loaded the saved conversation on mobile. Shortlist was also opened at 320px.
- Submitted `I stay at Sunway Velocity and work in TRX. Is there an MRT connection?` through the actual UI/backend, with no response mocks. The answer and sourced rail evidence rendered; the input reset and returned to its send state. This is a UI smoke check, not a new broad model-quality evaluation or per-turn model-identity claim.
- Clicked Cochrane's View on map; the map displayed the Home: Cochrane marker. Switched between mobile Map and Chat without losing the answer.
- Selected Hong Kong from the Advisor country selector. Navigation reached Hong Kong Explorer, showed project cards and country counts, and retained the existing map-viewport result filtering. Returned through Malaysia Explorer to Advisor.
- Explorer showed Malaysia (0) and Hong Kong (2,437). These are existing local catalogue visibility counts; no data import, mapping, RAG coverage or production data fix is implied.

## Automated checks and review

The focused Advisor, ConversationPanel and AnalyzeTabs suite passed 33 tests. After the final one-line 320px button refinement, all 17 Advisor tests passed again. The behavior regression covers country selection, non-MY routing and count visibility in Advisor, Explorer and Heat Map. Layout is verified in the browser rather than duplicated in CSS assertion tests.

Client and SSR builds pass. The final build used a clean export from the healthy Git object database because the original worktree metadata blocked Tailwind source discovery; the four UI/test files matched the saved acceptance hashes. Generated resources were copied into local Herd, with the client manifest replaced last. The old Git object database was left untouched. Existing image-reference and bundle-size warnings remain. Independent general and JavaScript reviews approved the change. No PHP or database code changed in this layout update, and the earlier PR-wide backend results were not rerun or relabelled as new evidence.

## Evidence

Local screenshots and DOM measurements are saved under the task artifact directory `map-advisor-ui-20261016/`: `desktop-before.png`, `desktop-after.png`, `desktop-conversation.png`, `mobile-before.png`, `mobile-after.png`, `mobile-empty.png`, `mobile-map.png`, `minimum-after.png`, `explorer-counts.png`, plus corresponding measurement JSON files. No new video is claimed for this update.

This update changes presentation and market navigation only. Credit policy, prompts, retrieval, project data, map coordinates and deployment configuration are unchanged. Browser simulation does not replace physical-device keyboard testing.
