desktop reads everything by itself: one background read scheduler (4 per store, starts spaced per account, App Store Connect X-Rate-Limit slows it below 20 % and pauses at 100 left, backoff with jitter on 429 / RESOURCE_EXHAUSTED, visible app first, one read per key), per-method TTLs over the saved reads, Settings auto-read (on) and interval (15 min, paused while hidden), Refresh all, a refresh icon and 'read 3 min ago' / 'couldn't refresh' per card, writes invalidate, status line with progress and quota; quota reaches the window through ToolResult.quota (cli/lib/quota.ts); Health top issues open with versions, sample stack (health --issue / --signature, read health_issue), Open in Play Console, Copy for AI and likely-cause hints (cli/lib/crash-hints.ts); tests/scheduler.test.ts, tests/quota-crash-hints.test.ts, boot check auto-read case

apps/desktop/src/App.tsx

@@ -4,7 +4,7 @@ import { useCallback, useEffect, useMemo, useState } from 'react';
 import { FIXTURES, onDeepLink, onDeepLinkFolder } from './api';
 import { devSwitch } from './dev/switches';
 import { type Key, t } from './i18n';
-import { ago } from './lib/format';
+import { ago, num } from './lib/format';
 import { groupByStudio, type UnifiedApp } from './lib/identity';
 import { NavCtx, parseStart, type Route, sameRoute, TAB_ICON, TAB_KEY, tabsFor, WORKSPACE, type WorkspaceScreen } from './nav';
 import { usePrefs } from './prefs-ctx';
@@ -133,6 +133,9 @@ export function App({ onTheme }: { onTheme: () => void }) {
     : route.screen === 'app' ? [{ label: t('nav.portfolio'), to: { screen: 'portfolio' } }, { label: app?.name ?? '', to: app ? { screen: 'app', appId: app.key, tab: 'releases' } : undefined }, { label: t(TAB_KEY[route.tab]) }]
     : [{ label: t('nav.workspace') }, { label: t(WS_KEY[route.screen]) }];
   const lastRead = d.live?.at ?? null;
+  // the app on screen is read first by the background reader
+  const { setFocus } = d;
+  useEffect(() => { setFocus(app?.key ?? null); }, [app?.key, setFocus]);
   const nav = useMemo(() => ({ route, go, openPalette: () => setPalette(true), openWelcome: () => setWelcome(true) }), [route, go]);
   const current = (r: Route) => (sameRoute(r, route) || (r.screen === 'app' && route.screen === 'app' && r.appId === route.appId) || (r.screen !== 'app' && r.screen !== 'portfolio' && r.screen === route.screen) ? 'page' : undefined);
   const groups = d.studios.length ? groupByStudio(visible.map(a => ({ app: a })), d.studios) : [{ studio: null as string | null, rows: visible.map(a => ({ app: a })) }];
@@ -202,6 +205,7 @@ export function App({ onTheme }: { onTheme: () => void }) {
             <div className="row"><i className={`dot ${d.sidecar?.running ? 'ok' : d.sidecarError ? 'bad' : ''}`} />
               <span>{d.sidecar?.running ? t('foot.cli', { version: d.sidecar.version }) : d.sidecarError ? t('foot.cliDown') : t('foot.cliStarting')}</span></div>
             <div className="row"><Icon name="clock" className="sr-icon" /><span>{lastRead ? t('foot.lastRead', { when: ago(lastRead) }) : t('foot.neverRead')}</span></div>
+            <ReaderLine />
           </div>
         </nav>
         <div className="main">
@@ -217,8 +221,8 @@ export function App({ onTheme }: { onTheme: () => void }) {
             <span className="spacer" />
             {FIXTURES && <span className="dev-pill" title={t('dev.fixturesHint')}>{t('dev.fixtures')}</span>}
             <span className="stamp"><Icon name="clock" />{lastRead ? t('top.storesRead', { when: ago(lastRead) }) : t('top.storesNotRead')}</span>
-            <button className="btn btn-sm" onClick={() => d.refreshPortfolio(true)} disabled={!!d.portfolioBusy || !visible.length} title={t('action.readStoresHint')}>
-              <Icon name="refresh" className={d.portfolioBusy === 'live' ? 'spin' : undefined} />{d.portfolioBusy === 'live' ? t('action.reading') : t('action.readStores')}
+            <button className="btn btn-sm" onClick={() => { d.readAll(true).catch(() => {}); }} disabled={!visible.length} title={t('action.refreshAllHint')} data-testid="refresh-all">
+              <Icon name="refresh" className={d.reader.running ? 'spin' : undefined} />{t('action.refreshAll')}
             </button>
             <ExportMenu />
           </header>
@@ -242,3 +246,18 @@ export function App({ onTheme }: { onTheme: () => void }) {
     </NavCtx.Provider>
   );
 }
+
+/** The background reader in one line: "Reading 12 of 48 · App Store limit 3 412/3 600 left this hour". */
+function ReaderLine() {
+  const d = useData();
+  const r = d.reader;
+  const q = Object.values(r.quota).sort((a, b) => a.remaining - b.remaining)[0];
+  const parts: string[] = [];
+  if (r.total > 0 && (r.running || r.queued)) parts.push(t('reader.progress', { done: r.done, total: r.total }));
+  else if (!d.reader.autoRead) parts.push(t('reader.off'));
+  else if (d.ready && d.apps.length) parts.push(t('reader.upToDate'));
+  if (Object.keys(r.paused).length) parts.push(t('reader.backoff'));
+  if (q) parts.push(t('reader.appleQuota', { left: num(q.remaining), limit: num(q.limit) }));
+  if (!parts.length) return null;
+  return <div className="row reader-line" data-testid="reader-line" aria-live="polite"><Icon name="refresh" className={`sr-icon${r.running ? ' spin' : ''}`} /><span title={parts.join(' · ')}>{parts.join(' · ')}</span></div>;
+}