Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

fix(mobile): refine task views and navigation defaults (#7778)

dev-rb1a06ce481a91
diff --git a/apps/web/src/components/app/mobile/MobileDockRow.test.tsx b/apps/web/src/components/app/mobile/MobileDockRow.test.tsx
index b4b7595a1d..f0f3cca9a5 100644
--- a/apps/web/src/components/app/mobile/MobileDockRow.test.tsx
+++ b/apps/web/src/components/app/mobile/MobileDockRow.test.tsx
@@ -10,9 +10,13 @@ import type { ParentProps } from 'solid-js';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { MobileDockRow } from './MobileDockRow';
-const { navigate, toggleSettings } = vi.hoisted(() => ({
+const { navigate, toggleSettings, reviewsFlag } = vi.hoisted(() => ({
navigate: vi.fn(),
toggleSettings: vi.fn(),
+ reviewsFlag: { enabled: false },
+}));
+vi.mock('@app/lib/analytics/posthog', () => ({
+ useFeatureFlag: () => () => reviewsFlag,
}));
vi.mock('@app/features/command/mobile/MobileSearchInput', () => ({
MobileAskAiButton: () => null,
@@ -52,6 +56,7 @@ vi.mock('./mobile-dock-views', () => ({
let drawerStyles: HTMLStyleElement;
beforeEach(() => {
// Supply browser motion defaults missing in jsdom for Corvu's presence tracking.
+ reviewsFlag.enabled = false;
drawerStyles = document.createElement('style');
drawerStyles.textContent =
'[data-corvu-drawer-content], [data-corvu-drawer-overlay] { transition-duration: 0s; animation-name: none; }';
@@ -93,6 +98,18 @@ describe('dock overflow drawer', () => {
await waitFor(() => expect(screen.queryByRole('dialog')).toBeNull());
});
+ it('opens Reviews from More when enabled without adding a dock button', async () => {
+ reviewsFlag.enabled = true;
+ render(() => <MobileDockRow />);
+ expect(screen.queryByRole('button', { name: 'Reviews' })).toBeNull();
+
+ fireEvent.click(screen.getByRole('button', { name: 'More views' }));
+ const drawer = within(screen.getByRole('dialog', { name: 'More views' }));
+ fireEvent.click(drawer.getByRole('button', { name: 'Reviews' }));
+ expect(navigate).toHaveBeenCalledExactlyOnceWith('reviews');
+ await waitFor(() => expect(screen.queryByRole('dialog')).toBeNull());
+ });
+
it('closes after opening Settings and supports dismissing without selection', async () => {
render(() => <MobileDockRow />);
const trigger = screen.getByRole('button', { name: 'More views' });
diff --git a/apps/web/src/components/app/mobile/MobileDockRow.tsx b/apps/web/src/components/app/mobile/MobileDockRow.tsx
index e4b2f40084..3267efded4 100644
--- a/apps/web/src/components/app/mobile/MobileDockRow.tsx
+++ b/apps/web/src/components/app/mobile/MobileDockRow.tsx
@@ -3,11 +3,14 @@ import {
MobileSearchInput,
} from '@app/features/command/mobile/MobileSearchInput';
import { SearchState } from '@app/features/command/mobile/mobileSearchState';
+import { useFeatureFlag } from '@app/lib/analytics/posthog';
+import { enableTasksReviews } from '@core/constant/featureFlags';
import { useSettingsState } from '@core/constant/SettingsState';
import { triggerFocusInput } from '@core/directive/focusInput';
import { hapticImpact } from '@core/mobile/haptics';
import CaretUpIcon from '@phosphor/caret-up.svg';
import IconGear from '@phosphor/gear.svg';
+import GitPullRequestIcon from '@phosphor/git-pull-request.svg';
import SearchIcon from '@phosphor/magnifying-glass.svg';
import { createElementSize } from '@solid-primitives/resize-observer';
import { cn } from '@ui';
@@ -30,6 +33,7 @@ function MoreViewsDrawer(props: {
onNavigate: (id: MobileDockNavId) => void;
}) {
const { settingsOpen, toggleSettings } = useSettingsState();
+ const reviewsFlag = useFeatureFlag(enableTasksReviews);
return (
<MobileDrawer
@@ -61,7 +65,7 @@ function MoreViewsDrawer(props: {
<IconGear class="size-4 shrink-0" />
<span>Settings</span>
</MobileDrawer.Close>
- <Show when={props.views.length > 0}>
+ <Show when={props.views.length > 0 || reviewsFlag().enabled}>
<div class="-mx-1 h-px shrink-0 bg-edge" />
</Show>
<For each={props.views.toReversed()}>
@@ -81,6 +85,21 @@ function MoreViewsDrawer(props: {
</MobileDrawer.Close>
)}
</For>
+ <Show when={reviewsFlag().enabled}>
+ <MobileDrawer.Close
+ as={MobileDrawer.Item}
+ aria-label="Reviews"
+ class={props.isActive('reviews') ? 'text-accent' : undefined}
+ aria-current={props.isActive('reviews') ? 'page' : undefined}
+ onClick={() => {
+ hapticImpact('light');
+ props.onNavigate('reviews');
+ }}
+ >
+ <GitPullRequestIcon class="size-4 shrink-0" />
+ <span>Reviews</span>
+ </MobileDrawer.Close>
+ </Show>
<div class="-mx-1 h-px shrink-0 bg-edge" />
<MobileDrawer.Close
aria-label="Views"
diff --git a/apps/web/src/components/app/mobile/mobile-nav-views.ts b/apps/web/src/components/app/mobile/mobile-nav-views.ts
index 3ff346df77..ca5ddf2c8a 100644
--- a/apps/web/src/components/app/mobile/mobile-nav-views.ts
+++ b/apps/web/src/components/app/mobile/mobile-nav-views.ts
@@ -1,8 +1,8 @@
/**
- * Views reachable from the mobile navigation pill row, in display order.
+ * Views reachable from mobile navigation, in display order.
* `search` is the "All" pill, first in the scope pill row;
* `settings` navigates through the settings state (not `openWithSplit`), and
- * `calendar` is additionally gated by the calendar UI flag.
+ * `calendar` and the drawer-only `reviews` shortcut are feature-gated.
*/
export const MOBILE_NAV_VIEW_IDS = [
'search',
@@ -13,6 +13,7 @@ export const MOBILE_NAV_VIEW_IDS = [
'documents',
'agents',
'tasks',
+ 'reviews',
'calls',
'companies',
'settings',
diff --git a/apps/web/src/components/app/mobile/use-mobile-nav.ts b/apps/web/src/components/app/mobile/use-mobile-nav.ts
index eef8bdb2e9..26709508f7 100644
--- a/apps/web/src/components/app/mobile/use-mobile-nav.ts
+++ b/apps/web/src/components/app/mobile/use-mobile-nav.ts
@@ -1,5 +1,10 @@
import type { ListView } from '@app/constants/list-views';
import { CALENDAR_VIEW_ID } from '@app/features/calendar-view/types';
+import {
+ reviewsTabSearch,
+ reviewsTabSearchCodec,
+} from '@app/features/reviews-view/reviews-tab-search';
+import { paneRoute } from '@app/routes/app-route';
import { globalSplitManager } from '@app/signal/splitLayout';
import { useSettingsState } from '@core/constant/SettingsState';
import { isNativeMobilePlatform } from '@core/mobile/isNativeMobilePlatform';
@@ -12,9 +17,35 @@ import { isMobileNavViewId, type MobileNavViewId } from './mobile-nav-views';
* only reachable through the Views menu or the dynamic nav button (folders,
* companies, …).
*/
-export type MobileDockNavId = ListView | 'calendar' | 'settings';
+export type MobileDockNavId = ListView | 'calendar' | 'reviews' | 'settings';
function mobileNavContent(id: Exclude<MobileDockNavId, 'settings'>) {
+ if (id === 'documents') {
+ return {
+ type: 'component' as const,
+ id,
+ entryMetadata: {
+ route: paneRoute(
+ { id: 'drive', params: {} },
+ { id: 'drive-tab', params: { tab: 'recent' } }
+ ),
+ },
+ };
+ }
+
+ if (id === 'reviews') {
+ return {
+ type: 'component' as const,
+ id,
+ entryMetadata: {
+ search: {
+ [reviewsTabSearch.namespace]: reviewsTabSearchCodec.serialize({
+ tab: 'all',
+ }),
+ },
+ },
+ };
+ }
return {
type: 'component' as const,
id: id === 'calendar' ? CALENDAR_VIEW_ID : id,
@@ -56,6 +87,10 @@ export function useMobileNavNavigate(): (id: MobileDockNavId) => void {
}
const fgContent = globalSplitManager()?.activeSplit()?.content();
const isOnNavView = fgContent?.type === 'component';
- openWithSplit(content, { mergeHistory: isOnNavView });
+ openWithSplit(content, {
+ mergeHistory: isOnNavView,
+ // Route through the router so an existing pane receives the default tab.
+ search: id === 'documents' || id === 'reviews' ? {} : undefined,
+ });
};
}
diff --git a/apps/web/src/components/app/split-layout/tests/stacked-panes.test.ts b/apps/web/src/components/app/split-layout/tests/stacked-panes.test.ts
index f00c225a53..347322fceb 100644
--- a/apps/web/src/components/app/split-layout/tests/stacked-panes.test.ts
+++ b/apps/web/src/components/app/split-layout/tests/stacked-panes.test.ts
@@ -9,8 +9,10 @@ import { paneRoute } from '@app/routes/app-route';
import {
appRoute,
driveSplitRoute,
+ driveTabRoute,
homeSplitRoute,
notFoundRoute,
+ reviewsSplitRoute,
settingsRoute,
} from '@app/routes/routes';
import type { BlockOrchestrator } from '@core/orchestrator';
@@ -56,7 +58,13 @@ const routes: SplitRoutes = {
definitions: [
{
...appRoute,
- children: [homeSplitRoute, settingsRoute, driveSplitRoute, notFoundRoute],
+ children: [
+ homeSplitRoute,
+ settingsRoute,
+ { ...driveSplitRoute, children: [driveTabRoute] },
+ reviewsSplitRoute,
+ notFoundRoute,
+ ],
},
],
defaultRoute: () => paneRoute({ id: 'view-home', params: {} }),
@@ -183,6 +191,58 @@ describe('stacked panes', () => {
expect(active()).toBe('home');
});
+ it('applies the Recent destination when reusing an existing Files pane', () => {
+ const { manager, shown } = setup('/drive');
+ const recent: SplitContent = {
+ ...documents,
+ entryMetadata: {
+ route: paneRoute(
+ { id: 'drive', params: {} },
+ { id: 'drive-tab', params: { tab: 'recent' } }
+ ),
+ },
+ };
+ const expectRecent = () => {
+ expect(manager.activeSplit()?.content().entryMetadata).toMatchObject({
+ route: {
+ matches: [
+ { id: 'app' },
+ { id: 'drive' },
+ { id: 'drive-tab', params: { tab: 'recent' } },
+ ],
+ },
+ });
+ expect(shown()).toEqual(['documents']);
+ };
+
+ manager.replaceAllSplits(recent);
+ expectRecent();
+ manager.replaceAllSplits(documents);
+ manager.openWithSplit(recent, { mergeHistory: true, search: {} });
+ expectRecent();
+ });
+
+ it('applies the All scope when reusing an existing Reviews pane', () => {
+ const { manager, shown } = setup('/reviews');
+ const all: SplitContent = {
+ type: 'component',
+ id: 'reviews',
+ entryMetadata: { search: { reviews: { tab: ['all'] } } },
+ };
+ const expectAll = () => {
+ expect(manager.activeSplit()?.content().entryMetadata).toMatchObject({
+ search: { reviews: { tab: ['all'] } },
+ });
+ expect(shown()).toEqual(['reviews']);
+ };
+
+ manager.replaceAllSplits(all);
+ expectAll();
+ manager.replaceAllSplits({ type: 'component', id: 'reviews' });
+ manager.openWithSplit(all, { mergeHistory: true, search: {} });
+ expectAll();
+ });
+
it('moves the pane holding a claim to the front when a router open lands on it', () => {
const { router, manager, shown, active } = setup('/home');
manager.openWithSplit(settings);
diff --git a/apps/web/src/features/tasks-view/components/TasksControls.tsx b/apps/web/src/features/tasks-view/components/TasksControls.tsx
index 475993c592..7090a47533 100644
--- a/apps/web/src/features/tasks-view/components/TasksControls.tsx
+++ b/apps/web/src/features/tasks-view/components/TasksControls.tsx
@@ -6,13 +6,23 @@ import {
ViewLayoutDropdown,
} from '@app/components/view-shell';
import { useSplitPanelOrThrow } from '@components/app/split-layout/layoutUtils';
+import { isTouchDevice } from '@core/mobile/isTouchDevice';
import { createSignal, Show } from 'solid-js';
import { TASK_GROUP_OPTIONS, TASK_SORT_OPTIONS } from '../constants';
import { TASK_BOARD_GROUP_OPTIONS } from '../core/task-board';
import { useTaskFilters } from '../filters/use-task-filters';
import { useTasksView } from '../tasks-view-context';
+import { TasksFilterDrawer } from './TasksFilterDrawer';
export function TasksControls() {
+ return (
+ <Show when={!isTouchDevice()} fallback={<TasksFilterDrawer />}>
+ <DesktopTasksControls />
+ </Show>
+ );
+}
+
+function DesktopTasksControls() {
const panel = useSplitPanelOrThrow();
const { state, setPrimarySort, setState, projectsEnabled } = useTasksView();
const filters = useTaskFilters();
diff --git a/apps/web/src/features/tasks-view/components/TasksHeader.tsx b/apps/web/src/features/tasks-view/components/TasksHeader.tsx
index 3db75379d4..987fd38ccf 100644
--- a/apps/web/src/features/tasks-view/components/TasksHeader.tsx
+++ b/apps/web/src/features/tasks-view/components/TasksHeader.tsx
@@ -114,7 +114,6 @@ export function TasksHeader(props: TasksHeaderProps) {
}
>
<TasksMobileTabs />
- <TasksControls />
</Show>
</div>
);
diff --git a/apps/web/src/features/tasks-view/components/TasksMobileTabs.tsx b/apps/web/src/features/tasks-view/components/TasksMobileTabs.tsx
index d1a3dac677..13d5164c96 100644
--- a/apps/web/src/features/tasks-view/components/TasksMobileTabs.tsx
+++ b/apps/web/src/features/tasks-view/components/TasksMobileTabs.tsx
@@ -1,8 +1,4 @@
-import { useFeatureFlag } from '@app/lib/analytics/posthog';
-import { useNavigate } from '@app/lib/split-router';
-import { reviewsSplitRoute } from '@app/routes/routes';
import { type PillTabItem, PillTabs } from '@components/app/mobile/PillTabs';
-import { enableTasksReviews } from '@core/constant/featureFlags';
import { type JSX, Show } from 'solid-js';
import { TASK_TABS, type TaskTabItem } from '../constants';
import { useTasksView } from '../tasks-view-context';
@@ -16,16 +12,10 @@ const toPill = (tab: TaskTabItem): PillTabItem<TasksTab> => ({
export function TasksMobileTabs(props: { leading?: JSX.Element }) {
const { state, setTab, projectsEnabled } = useTasksView();
- const navigate = useNavigate();
- const flag = useFeatureFlag(enableTasksReviews);
- const items = (): PillTabItem<TasksTab | 'reviews'>[] => [
- ...(flag().enabled
- ? [{ value: 'reviews' as const, label: 'Reviews' }]
- : []),
- ...TASK_TABS.filter(
- (tab) => tab.id !== 'projects' || projectsEnabled()
- ).map(toPill),
- ];
+ const items = (): PillTabItem<TasksTab>[] =>
+ TASK_TABS.filter((tab) => tab.id !== 'projects' || projectsEnabled()).map(
+ toPill
+ );
return (
<div class="h-10 min-w-0 flex-1">
@@ -42,11 +32,7 @@ export function TasksMobileTabs(props: { leading?: JSX.Element }) {
}
items={items()}
value={state.tab}
- onChange={(tab) => {
- if (tab === 'reviews')
- navigate({ route: reviewsSplitRoute, params: {} });
- else setTab(tab);
- }}
+ onChange={setTab}
/>
</div>
);
diff --git a/apps/web/src/features/tasks-view/primitives/create-tasks-view-search.test.ts b/apps/web/src/features/tasks-view/primitives/create-tasks-view-search.test.ts
index 2c3dabdedf..f7da866da0 100644
--- a/apps/web/src/features/tasks-view/primitives/create-tasks-view-search.test.ts
+++ b/apps/web/src/features/tasks-view/primitives/create-tasks-view-search.test.ts
@@ -1,4 +1,4 @@
-import { createRoot } from 'solid-js';
+import { type Accessor, createRoot, createSignal } from 'solid-js';
import { createStore } from 'solid-js/store';
import { afterEach, expect, it, vi } from 'vitest';
import type { TasksTabSearchParams } from '../tasks-tab-search';
@@ -17,6 +17,7 @@ function setup(
search?: Partial<TasksTabSearchParams>;
scopedTab?: TasksTab;
enabled?: boolean;
+ boardEnabled?: Accessor<boolean>;
} = {}
) {
return createRoot((dispose) => {
@@ -50,6 +51,7 @@ function setup(
setSearch: writeSearch,
tab: () => options.scopedTab ?? search.tab,
enabled: options.enabled ?? true,
+ boardEnabled: options.boardEnabled,
});
return { state, search, setSearch, writeSearch, ...controls };
@@ -139,3 +141,65 @@ it('leaves embedded entry state and the parent URL untouched without a URL capab
expect(view.writeSearch).not.toHaveBeenCalled();
expect(view.search.sort).toBe('created_at');
});
+
+it('replaces mobile board URLs with list while preserving task controls and entry state', () => {
+ const view = setup({
+ boardEnabled: () => false,
+ search: {
+ layout: 'board',
+ groupBy: 'date',
+ sort: 'created_at',
+ sortReversed: 'true',
+ },
+ });
+
+ expect(view.writeSearch).toHaveBeenCalledExactlyOnceWith(
+ { layout: 'list' },
+ { history: 'replace' }
+ );
+ expect(view.state.layout).toBe('list');
+ expect(view.search).toMatchObject({
+ layout: 'list',
+ groupBy: 'date',
+ sort: 'created_at',
+ sortReversed: 'true',
+ });
+ expect(view.state.groupBy).toBe('date');
+ expect(view.state.search).toBe('keep this search');
+ expect(view.state.facets).toEqual({ priority: ['high'] });
+ expect(view.state.collapsedGroupIds).toEqual(['collapsed']);
+
+ view.setSearch('layout', 'board');
+ expect(view.state.layout).toBe('list');
+ expect(view.search.layout).toBe('list');
+ view.setState('layout', 'board');
+ expect(view.state.layout).toBe('list');
+ expect(view.search.layout).toBe('list');
+});
+
+it('falls back from restored board entries and from desktop boards when mobile activates', () => {
+ const restored = setup({
+ state: { layout: 'board' },
+ boardEnabled: () => false,
+ scopedTab: 'team-tasks',
+ });
+ expect(restored.state.layout).toBe('list');
+ expect(restored.state.tab).toBe('team-tasks');
+ expect(restored.writeSearch).toHaveBeenCalledExactlyOnceWith(
+ { layout: 'list' },
+ { history: 'replace' }
+ );
+
+ const [boardEnabled, setBoardEnabled] = createSignal(true);
+ const desktop = setup({ search: { layout: 'board' }, boardEnabled });
+ expect(desktop.state.layout).toBe('board');
+ expect(desktop.writeSearch).not.toHaveBeenCalled();
+
+ setBoardEnabled(false);
+ expect(desktop.state.layout).toBe('list');
+ expect(desktop.search.layout).toBe('list');
+ setBoardEnabled(true);
+ expect(desktop.state.layout).toBe('list');
+ desktop.setState('layout', 'board');
+ expect(desktop.state.layout).toBe('board');
+});
diff --git a/apps/web/src/features/tasks-view/primitives/create-tasks-view-search.ts b/apps/web/src/features/tasks-view/primitives/create-tasks-view-search.ts
index 1bf781c931..1ee3d8afee 100644
--- a/apps/web/src/features/tasks-view/primitives/create-tasks-view-search.ts
+++ b/apps/web/src/features/tasks-view/primitives/create-tasks-view-search.ts
@@ -11,9 +11,13 @@ export function createTasksViewSearch(options: {
state: Store<TasksViewState>;
setState: SetStoreFunction<TasksViewState>;
search: TasksTabSearchParams;
- setSearch: (patch: Partial<TasksTabSearchParams>) => void;
+ setSearch: (
+ patch: Partial<TasksTabSearchParams>,
+ options?: { history: 'replace' }
+ ) => void;
tab: Accessor<TasksTab>;
enabled: boolean;
+ boardEnabled?: Accessor<boolean>;
}) {
const { state, search } = options;
// Missing URL controls restore the entry snapshot, not the latest selection.
@@ -31,9 +35,11 @@ export function createTasksViewSearch(options: {
search.sort,
search.sortReversed,
search.groupBy,
+ options.boardEnabled?.() ?? true,
] as const,
- ([tab, layout, sort, sortReversed, groupBy]) => {
+ ([tab, layout, sort, sortReversed, groupBy, boardEnabled]) => {
if (!options.enabled) return;
+ const requestedLayout = layout ?? entryLayout;
options.setState(
produce((draft) => {
@@ -45,7 +51,7 @@ export function createTasksViewSearch(options: {
draft.collapsedGroupIds = [];
}
- draft.layout = layout ?? entryLayout;
+ draft.layout = boardEnabled ? requestedLayout : 'list';
draft.groupBy =
groupBy ??
(tab === entryTab ? entryGroupBy : TASK_DEFAULT_GROUP_BY[tab]);
@@ -54,6 +60,10 @@ export function createTasksViewSearch(options: {
: entrySort.map((item) => ({ ...item }));
})
);
+
+ if (!boardEnabled && requestedLayout === 'board') {
+ options.setSearch({ layout: 'list' }, { history: 'replace' });
+ }
}
)
);
@@ -64,6 +74,9 @@ export function createTasksViewSearch(options: {
if (!options.enabled) return;
if (args[0] === 'layout') {
+ if (options.boardEnabled?.() === false) {
+ options.setState('layout', 'list');
+ }
options.setSearch({ layout: state.layout });
}
diff --git a/apps/web/src/features/tasks-view/tasks-view-context.tsx b/apps/web/src/features/tasks-view/tasks-view-context.tsx
index 6da25ff130..022bd59f6a 100644
--- a/apps/web/src/features/tasks-view/tasks-view-context.tsx
+++ b/apps/web/src/features/tasks-view/tasks-view-context.tsx
@@ -190,8 +190,11 @@ export const [TasksViewProvider, useTasksView] = createAssertedContextProvider<
get search() {
return searchText();
},
+ get layout() {
+ return isTouchDevice() ? 'list' : persistedState.layout;
+ },
get groupBy() {
- if (persistedState.layout !== 'board') {
+ if (state.layout !== 'board') {
return persistedState.groupBy;
}
@@ -219,6 +222,7 @@ export const [TasksViewProvider, useTasksView] = createAssertedContextProvider<
setSearch: setTabSearch,
tab: routeTab,
enabled: syncSearch,
+ boardEnabled: () => !isTouchDevice(),
});
const currentSearch = () =>
tasksTabSearchCodec.serialize({
diff --git a/docs/AGENT_GUIDE/surfaces.md b/docs/AGENT_GUIDE/surfaces.md
index f85e7585f1..292b7b99b0 100644
--- a/docs/AGENT_GUIDE/surfaces.md
+++ b/docs/AGENT_GUIDE/surfaces.md
@@ -1076,8 +1076,9 @@ no corresponding database timestamp.
On touch devices (phones and tablets), the Drive header is a scrollable pill
strip — **Recent**, **My Files**, **Shared with me**, and **Folders** — with a
-leading filter-drawer button, like Tasks. Touch opens on **Recent** (the first
-pill). The drawer holds Sort (hidden on Recent, where the viewer's own
+leading filter-drawer button, like Tasks. Opening Files from the mobile dock
+starts on **Recent**; explicit tab and folder links keep their destination. The
+first pill is Recent. The drawer holds Sort (hidden on Recent, where the viewer's own
edit order applies) and, on tab locations only, the same filter groups as the
desktop **Filter** menu; active selections show a count badge on the trigger
and a `Clear all` action in the drawer. The in-view `Search Drive` field, the
@@ -1634,6 +1635,10 @@ byline.
## Pull requests — `/app/reviews/pr/<foreignEntityId>`
+Opening **Reviews** from the mobile dock's **More** drawer starts on **Pull
+requests** (the **All** scope). Explicit review-tab links keep their selected
+scope; desktop's default scope remains **Involves me**.
+
Macro-linked GitHub pull requests open inside the Reviews shell, with a Reviews
breadcrumb, PR title/status, linked GitHub metadata, discussion timeline, and Details/Checks
side panel below the top bar. An open PR also shows a **Merge** button in the
diff --git a/docs/AGENT_GUIDE/tasks.md b/docs/AGENT_GUIDE/tasks.md
index db44658cf1..62b453f0f6 100644
--- a/docs/AGENT_GUIDE/tasks.md
+++ b/docs/AGENT_GUIDE/tasks.md
@@ -48,6 +48,12 @@ clears it, and switching tabs clears it like any other filter. On mobile, the ta
are pills and the leading sliders button opens one drawer containing Sort, Group, and
Filters (including Tags). The mobile bottom dock has the Ask AI input, a separate **+ Task**
button, and Search.
+Mobile does not show the separate layout, sort, group, and filter toolbar.
+Use the compact sliders drawer for task-list controls; project task lists use the
+same drawer. Mobile supports List only. Opening a Board link or restoring a Board
+entry automatically selects List and replaces that host's layout URL parameter,
+without adding a history entry or clearing search, sorting, grouping, or filters.
+The desktop Board layout remains available.
**Keyboard:** **H** and **←** collapse the focused item or its parent group.
On a focused group header, **H** collapses only that group; pressing it again
@@ -175,8 +181,9 @@ those older results must not hide a failure for the new, uncached query.
## Reviews view
-With `enable-tasks-reviews` enabled (on by default in development), a
-`Reviews` shortcut appears above `My Tasks` in the Tasks sidebar and mobile tabs.
+With `enable-tasks-reviews` enabled (on by default in development),
+`Reviews` is available in desktop navigation and the mobile bottom dock's
+`More views` drawer, not the mobile Tasks tabs.
It opens a separate `/app/reviews` shell whose sidebar lists `Pull requests`,
`Authored by me`, `Assigned to me`, `Involves me`, and `Review requests`;
`Involves me` is selected by default. The selected tab is stored in the URL and